/* * This file is part of a proprietary work. * * Copyright (c) 2025-2026 Fossorial, Inc. * All rights reserved. * * This file is licensed under the Fossorial Commercial License. * You may not use this file except in compliance with the License. * Unauthorized use, copying, modification, or distribution is strictly prohibited. * * This file is not licensed under the AGPLv3. */ import { sendEmail } from "@server/emails"; import AlertNotification from "@server/emails/templates/AlertNotification"; import config from "@server/lib/config"; import logger from "@server/logger"; import { AlertContext } from "./types"; /** * Sends an alert notification email to every address in `recipients`. * * Each recipient receives an individual email (no BCC list) so that delivery * failures for one address do not affect the others. Failures per recipient * are logged and swallowed – the caller only sees an error if something goes * wrong before the send loop. */ export async function sendAlertEmail( recipients: string[], context: AlertContext ): Promise { if (recipients.length === 0) { return; } const from = config.getNoReplyEmail(); const subject = buildSubject(context); for (const to of recipients) { try { await sendEmail( AlertNotification({ eventType: context.eventType, orgId: context.orgId, data: context.data }), { from, to, subject } ); logger.debug( `Alert email sent to "${to}" for event "${context.eventType}"` ); } catch (err) { logger.error( `sendAlertEmail: failed to send alert email to "${to}" for event "${context.eventType}"`, err ); } } } // --------------------------------------------------------------------------- // Helpers // --------------------------------------------------------------------------- function buildSubject(context: AlertContext): string { switch (context.eventType) { case "site_online": return "[Alert] Site Back Online"; case "site_offline": return "[Alert] Site Offline"; case "health_check_healthy": return "[Alert] Health Check Recovered"; case "health_check_not_healthy": return "[Alert] Health Check Failing"; default: { // Exhaustiveness fallback – should never be reached with a // well-typed caller, but keeps runtime behaviour predictable. const _exhaustive: never = context.eventType; void _exhaustive; return "[Alert] Event Notification"; } } }