⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
import {
getSmtpErrorDetails,
isSmtpConfigured,
sendTestEmail,
} from "@kaneo/email";
import { HTTPException } from "hono/http-exception";
import { ApiError } from "../../errors/api-error";
import type { AdminAuditRequest } from "../audit/admin-audit-request";
import { recordAdminAction } from "../audit/record-admin-action";
import { safeErrorCode } from "../system/safe-error-code";
import { createAttemptLimiter } from "../system/attempt-limiter";
const testEmailLimiter = createAttemptLimiter({
max: 5,
windowMs: 10 * 60 * 1000,
});
function notConfigured() {
return new ApiError(409, {
message:
"Email is not configured on this instance. Set SMTP_HOST and SMTP_FROM, then restart Kaneo.",
code: "SMTP_NOT_CONFIGURED",
});
}
type SendTestEmailInput = {
userId: string;
email: string;
};
/**
* Send an SMTP test to the calling administrator's own address. There is no
* recipient parameter, so this can't be used to relay mail to anyone else.
*/
async function sendAdminTestEmail(
{ userId, email }: SendTestEmailInput,
audit: AdminAuditRequest,
) {
if (!isSmtpConfigured()) throw notConfigured();
const decision = testEmailLimiter.take(userId);
if (!decision.allowed) {
throw new HTTPException(429, {
res: Response.json(
{
message: `Too many test emails. Try again in ${decision.retryAfterSeconds} seconds.`,
code: "RATE_LIMITED",
},
{
status: 429,
headers: { "Retry-After": String(decision.retryAfterSeconds) },
},
),
});
}
let result: Awaited<ReturnType<typeof sendTestEmail>>;
try {
result = await sendTestEmail(email, (name) => `${name} test email`, {
requestedAt: new Date(),
});
} catch (error) {
const details = getSmtpErrorDetails(error);
console.error("Error sending admin test email", details);
const reason =
"responseCode" in details
? `${details.code} ${details.responseCode}`
: details.code;
throw new ApiError(502, {
message: `The mail server did not accept the test email (${reason}). Check the SMTP settings and the API logs.`,
code: "SMTP_SEND_FAILED",
});
}
if (!result.success) throw notConfigured();
try {
await recordAdminAction({
...audit,
action: "email.test_sent",
targetType: "user",
targetId: userId,
targetLabel: email,
});
} catch (error) {
// SMTP already accepted the message; an audit failure cannot undo it.
console.error("Admin audit entry could not be recorded:", {
action: "email.test_sent",
code: safeErrorCode(error),
});
}
return { sent: true as const, to: email };
}
export default sendAdminTestEmail;