import nodemailer from 'nodemailer'; import { log } from './logger.js'; import { t } from './emaili18n.js'; let transporter; // Escape HTML special characters to prevent injection in email bodies function escapeHtml(str) { if (!str) return ''; return String(str) .replace(/&/g, '&') .replace(//g, '>') .replace(/"/g, '"') .replace(/'/g, '''); } export function initMailer() { const host = process.env.SMTP_HOST; const port = parseInt(process.env.SMTP_PORT || '587', 10); const user = process.env.SMTP_USER; const pass = process.env.SMTP_PASS; if (!host || !user || !pass) { log.mailer.warn('SMTP not configured - email verification disabled'); return false; } transporter = nodemailer.createTransport({ host, port, secure: port === 465, auth: { user, pass }, connectionTimeout: 10_000, // 10 s to establish TCP connection greetingTimeout: 10_000, // 10 s to receive SMTP greeting socketTimeout: 15_000, // 15 s of inactivity before abort }); log.mailer.info('SMTP mailer configured'); return true; } export function isMailerConfigured() { return !!transporter; } /** * Send the verification email with a clickable link. * @param {string} to - recipient email * @param {string} name - user's display name * @param {string} verifyUrl - full verification URL * @param {string} appName - branding app name (default "Redlight") */ // S3: sanitize name for use in email From header (strip quotes, newlines, control chars) function sanitizeHeaderValue(str) { return String(str).replace(/["\\\r\n\x00-\x1f]/g, '').trim().slice(0, 100); } export async function sendVerificationEmail(to, name, verifyUrl, appName = 'Redlight', lang = 'en') { if (!transporter) { throw new Error('SMTP not configured'); } const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeName = escapeHtml(name); const safeAppName = escapeHtml(appName); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.verify.subject', { appName: headerAppName }), html: `

${t(lang, 'email.greeting', { name: safeName })}

${t(lang, 'email.verify.intro')}

${t(lang, 'email.verify.button')}

${t(lang, 'email.linkHint')}
${escapeHtml(verifyUrl)}

${t(lang, 'email.verify.validity')}


${t(lang, 'email.verify.footer')}

`, text: `${t(lang, 'email.greeting', { name })}\n\n${t(lang, 'email.verify.intro')}\n${verifyUrl}\n\n${t(lang, 'email.verify.validity')}\n\n- ${appName}`, }); } /** * Send a federation meeting invitation email. * @param {string} to - recipient email * @param {string} name - recipient display name * @param {string} fromUser - sender federated address (user@domain) * @param {string} roomName - name of the invited room * @param {string} message - optional personal message * @param {string} inboxUrl - URL to the federation inbox * @param {string} appName - branding app name (default "Redlight") */ export async function sendFederationInviteEmail(to, name, fromUser, roomName, message, inboxUrl, appName = 'Redlight', lang = 'en') { if (!transporter) return; // silently skip if SMTP not configured const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeName = escapeHtml(name); const safeFromUser = escapeHtml(fromUser); const safeRoomName = escapeHtml(roomName); const safeMessage = message ? escapeHtml(message) : null; const safeAppName = escapeHtml(appName); const introHtml = t(lang, 'email.federationInvite.intro') .replace('{fromUser}', `${safeFromUser}`); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.federationInvite.subject', { appName: headerAppName, fromUser: sanitizeHeaderValue(fromUser) }), html: `

${t(lang, 'email.greeting', { name: safeName })}

${introHtml}

${t(lang, 'email.federationInvite.roomLabel')}

${safeRoomName}

${safeMessage ? `

"${safeMessage}"

` : ''}

${t(lang, 'email.viewInvitation')}


${t(lang, 'email.invitationFooter')}

`, text: `${t(lang, 'email.greeting', { name })}\n\n${t(lang, 'email.federationInvite.intro', { fromUser })}\n${t(lang, 'email.federationInvite.roomLabel')} ${roomName}${message ? `\n"${message}"` : ''}\n\n${t(lang, 'email.viewInvitation')}: ${inboxUrl}\n\n- ${appName}`, }); } /** * Send a guest meeting invitation email with a direct join link. * @param {string} to - recipient email * @param {string} fromUser - sender display name * @param {string} roomName - name of the room * @param {string} message - optional personal message * @param {string} joinUrl - direct guest join URL * @param {string} appName - branding app name * @param {string} lang - language code */ export async function sendGuestInviteEmail(to, fromUser, roomName, message, joinUrl, appName = 'Redlight', lang = 'en') { if (!transporter) { throw new Error('SMTP not configured'); } const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeFromUser = escapeHtml(fromUser); const safeRoomName = escapeHtml(roomName); const safeMessage = message ? escapeHtml(message) : null; const introHtml = t(lang, 'email.guestInvite.intro') .replace('{fromUser}', `${safeFromUser}`); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.guestInvite.subject', { appName: headerAppName, fromUser: sanitizeHeaderValue(fromUser) }), html: `

Meeting Invitation

${introHtml}

${t(lang, 'email.guestInvite.roomLabel')}

${safeRoomName}

${safeMessage ? `

"${safeMessage}"

` : ''}

${t(lang, 'email.guestInvite.joinButton')}

${t(lang, 'email.linkHint')}
${escapeHtml(joinUrl)}


${t(lang, 'email.guestInvite.footer')}

`, text: `${t(lang, 'email.guestInvite.intro', { fromUser })}\n${t(lang, 'email.guestInvite.roomLabel')} ${roomName}${message ? `\n"${message}"` : ''}\n\n${t(lang, 'email.guestInvite.joinButton')}: ${joinUrl}\n\n- ${appName}`, }); } /** * Send a calendar event invitation email (federated). */ export async function sendCalendarInviteEmail(to, name, fromUser, title, startTime, endTime, description, inboxUrl, appName = 'Redlight', lang = 'en') { if (!transporter) return; const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeName = escapeHtml(name); const safeFromUser = escapeHtml(fromUser); const safeTitle = escapeHtml(title); const safeDesc = description ? escapeHtml(description) : null; const formatDate = (iso) => { try { return new Date(iso).toLocaleString(lang === 'de' ? 'de-DE' : 'en-GB', { dateStyle: 'full', timeStyle: 'short' }); } catch { return iso; } }; const introHtml = t(lang, 'email.calendarInvite.intro') .replace('{fromUser}', `${safeFromUser}`); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.calendarInvite.subject', { appName: headerAppName, fromUser: sanitizeHeaderValue(fromUser) }), html: `

${t(lang, 'email.greeting', { name: safeName })}

${introHtml}

${safeTitle}

🕐 ${escapeHtml(formatDate(startTime))} - ${escapeHtml(formatDate(endTime))}

${safeDesc ? `

"${safeDesc}"

` : ''}

${t(lang, 'email.viewInvitation')}


${t(lang, 'email.invitationFooter')}

`, text: `${t(lang, 'email.greeting', { name })}\n\n${t(lang, 'email.calendarInvite.intro', { fromUser })}\n${safeTitle}\n${formatDate(startTime)} \u2013 ${formatDate(endTime)}${description ? `\n\n"${description}"` : ''}\n\n${t(lang, 'email.viewInvitation')}: ${inboxUrl}\n\n\u2013 ${appName}`, }); } /** * Notify a user that a federated calendar event they received was deleted by the organiser. */ export async function sendCalendarEventDeletedEmail(to, name, fromUser, title, appName = 'Redlight', lang = 'en') { if (!transporter) return; const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeName = escapeHtml(name); const safeFromUser = escapeHtml(fromUser); const safeTitle = escapeHtml(title); const introHtml = t(lang, 'email.calendarDeleted.intro') .replace('{fromUser}', `${safeFromUser}`); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.calendarDeleted.subject', { appName: headerAppName, title: sanitizeHeaderValue(title) }), html: `

${t(lang, 'email.greeting', { name: safeName })}

${introHtml}

${safeTitle}

${t(lang, 'email.calendarDeleted.note')}


${t(lang, 'email.calendarDeleted.footer', { appName: escapeHtml(appName) })}

`, text: `${t(lang, 'email.greeting', { name })}\n\n${t(lang, 'email.calendarDeleted.intro', { fromUser })}\n"${title}"\n\n${t(lang, 'email.calendarDeleted.note')}\n\n\u2013 ${appName}`, }); } /** * Send a user registration invite email. * @param {string} to - recipient email * @param {string} inviteUrl - full invite registration URL * @param {string} appName - branding app name (default "Redlight") */ export async function sendInviteEmail(to, inviteUrl, appName = 'Redlight', lang = 'en') { if (!transporter) { throw new Error('SMTP not configured'); } const from = process.env.SMTP_FROM || process.env.SMTP_USER; const headerAppName = sanitizeHeaderValue(appName); const safeAppName = escapeHtml(appName); const introHtml = t(lang, 'email.invite.intro') .replace('{appName}', `${safeAppName}`); await transporter.sendMail({ from: `"${headerAppName}" <${from}>`, to, subject: t(lang, 'email.invite.subject', { appName: headerAppName }), html: `

${t(lang, 'email.invite.title')}

${introHtml}

${t(lang, 'email.invite.prompt')}

${t(lang, 'email.invite.button')}

${t(lang, 'email.linkHint')}
${escapeHtml(inviteUrl)}

${t(lang, 'email.invite.validity')}


${t(lang, 'email.invite.footer')}

`, text: `${t(lang, 'email.invite.title')}\n\n${t(lang, 'email.invite.intro', { appName })}\n\n${t(lang, 'email.invite.prompt')}\n${inviteUrl}\n\n${t(lang, 'email.invite.validity')}\n\n- ${appName}`, }); }