app-manager-edge-worker 1.0.8 → 1.0.9

package/src/handlers/mailHandler.js

@@ -1,74 +1,74 @@
-import nodemailer from "nodemailer";
-
-/**
- * Handles incoming SEND_EMAIL job from the cluster server.
- *
- * Security & Reliability Guarantees:
- * 1. Zero credential retention: Credentials are received in-memory and destroyed after sending.
- * 2. Fail-fast timeouts: Prevents socket hanging with strict 10s connection & socket timeouts.
- * 3. Structured result payload: Returns delivery metadata (messageId, accepted, response).
- *
- * @param {Object} payload
- * @param {Object} payload.mailOptions - { to, subject, html, text, fromName, fromEmail }
- * @param {Object} payload.smtpConfig - { host, port, secure, auth: { user, pass } }
- * @returns {Promise<Object>}
- */
-export async function handleSendEmail(payload = {}) {
-    const { mailOptions, smtpConfig } = payload;
-
-    if (!mailOptions || !mailOptions.to || !mailOptions.subject) {
-        throw new Error("Invalid mailOptions: 'to' and 'subject' are required.");
-    }
-    if (!smtpConfig || !smtpConfig.auth?.user || !smtpConfig.auth?.pass) {
-        throw new Error("Invalid smtpConfig: credentials missing.");
-    }
-
-    const host = smtpConfig.host || "smtp.titan.email";
-    const port = Number(smtpConfig.port) || 465;
-    const secure = smtpConfig.secure !== undefined ? Boolean(smtpConfig.secure) : port === 465;
-
-    // Ephemeral Nodemailer transporter created strictly for this in-memory dispatch
-    const transporter = nodemailer.createTransport({
-        host,
-        port,
-        secure,
-        auth: {
-            user: smtpConfig.auth.user,
-            pass: smtpConfig.auth.pass,
-        },
-        connectionTimeout: 10000,
-        greetingTimeout: 10000,
-        socketTimeout: 15000,
-        tls: {
-            rejectUnauthorized: false, // Prevents certificate mismatches on custom domain mail
-        },
-    });
-
-    try {
-        const fromName = mailOptions.fromName || "Apps Manager";
-        const fromAddress = mailOptions.fromEmail || smtpConfig.auth.user;
-
-        const info = await transporter.sendMail({
-            from: `"${fromName}" <${fromAddress}>`,
-            to: mailOptions.to,
-            subject: mailOptions.subject,
-            text: mailOptions.text,
-            html: mailOptions.html,
-        });
-
-        return {
-            success: true,
-            messageId: info.messageId,
-            accepted: info.accepted,
-            rejected: info.rejected,
-            response: info.response,
-        };
-    } finally {
-        // Explicitly close transporter socket to prevent lingering connections
-        try {
-            transporter.close();
-        } catch (_) {
-            // Best effort cleanup
-        }
-    }
-}
+import nodemailer from "nodemailer";
+
+/**
+ * Handles incoming SEND_EMAIL job from the cluster server.
+ *
+ * Security & Reliability Guarantees:
+ * 1. Zero credential retention: Credentials are received in-memory and destroyed after sending.
+ * 2. Fail-fast timeouts: Prevents socket hanging with strict 10s connection & socket timeouts.
+ * 3. Structured result payload: Returns delivery metadata (messageId, accepted, response).
+ *
+ * @param {Object} payload
+ * @param {Object} payload.mailOptions - { to, subject, html, text, fromName, fromEmail }
+ * @param {Object} payload.smtpConfig - { host, port, secure, auth: { user, pass } }
+ * @returns {Promise<Object>}
+ */
+export async function handleSendEmail(payload = {}) {
+    const { mailOptions, smtpConfig } = payload;
+
+    if (!mailOptions || !mailOptions.to || !mailOptions.subject) {
+        throw new Error("Invalid mailOptions: 'to' and 'subject' are required.");
+    }
+    if (!smtpConfig || !smtpConfig.auth?.user || !smtpConfig.auth?.pass) {
+        throw new Error("Invalid smtpConfig: credentials missing.");
+    }
+
+    const host = smtpConfig.host || "smtp.titan.email";
+    const port = Number(smtpConfig.port) || 465;
+    const secure = smtpConfig.secure !== undefined ? Boolean(smtpConfig.secure) : port === 465;
+
+    // Ephemeral Nodemailer transporter created strictly for this in-memory dispatch
+    const transporter = nodemailer.createTransport({
+        host,
+        port,
+        secure,
+        auth: {
+            user: smtpConfig.auth.user,
+            pass: smtpConfig.auth.pass,
+        },
+        connectionTimeout: 10000,
+        greetingTimeout: 10000,
+        socketTimeout: 15000,
+        tls: {
+            rejectUnauthorized: false, // Prevents certificate mismatches on custom domain mail
+        },
+    });
+
+    try {
+        const fromName = mailOptions.fromName || "Apps Manager";
+        const fromAddress = mailOptions.fromEmail || smtpConfig.auth.user;
+
+        const info = await transporter.sendMail({
+            from: `"${fromName}" <${fromAddress}>`,
+            to: mailOptions.to,
+            subject: mailOptions.subject,
+            text: mailOptions.text,
+            html: mailOptions.html,
+        });
+
+        return {
+            success: true,
+            messageId: info.messageId,
+            accepted: info.accepted,
+            rejected: info.rejected,
+            response: info.response,
+        };
+    } finally {
+        // Explicitly close transporter socket to prevent lingering connections
+        try {
+            transporter.close();
+        } catch (_) {
+            // Best effort cleanup
+        }
+    }
+}