Skip to content

Rallly is an open-source scheduling and collaboration tool designed to make organizing events and meetings easier.

3.2 KB
Raw Blame
import { SESv2Client, SendEmailCommand } from "@aws-sdk/client-sesv2";
import { defaultProvider } from "@aws-sdk/credential-provider-node";
import type { Transporter } from "nodemailer";
import { createTransport } from "nodemailer";

type EmailProvider = "ses" | "smtp";

export type SupportedEmailProviders = EmailProvider;

let cachedTransport: Transporter | undefined;

export function createTransportForProvider(provider: EmailProvider) {
  switch (provider) {
    case "ses": {
      const sesClient = new SESv2Client({
        region: process.env["AWS" + "_REGION"] as string,
        credentialDefaultProvider: defaultProvider,
      });

      return createTransport({
        SES: { sesClient, SendEmailCommand },
      });
    }
    case "smtp": {
      // Nodemailer refuses partial credentials at send time ("Missing
      // credentials for PLAIN"), so a half-built auth object must never be
      // passed. Env validation in apps/web rejects the one-without-the-other
      // state at startup.
      const hasAuth = Boolean(process.env.SMTP_USER && process.env.SMTP_PWD);

      const port = process.env.SMTP_PORT
        ? Number.parseInt(process.env.SMTP_PORT, 10)
        : undefined;

      const secure = process.env.SMTP_SECURE === "true";

      // Log deprecation warning for legacy variable
      if (process.env.SMTP_TLS_ENABLED === "true") {
        console.warn(
          "⚠️  SMTP_TLS_ENABLED is deprecated and no longer affects certificate validation. Use SMTP_REJECT_UNAUTHORIZED instead.",
        );
      }

      if (process.env.SMTP_DEBUG === "true") {
        console.warn(
          "⚠️  SMTP_DEBUG is no longer supported and can be removed. Send failures are logged with the SMTP server's response.",
        );
      }

      const rejectUnauthorized =
        process.env.SMTP_REJECT_UNAUTHORIZED !== "false";

      // Warn about security change if no explicit setting
      if (
        process.env.SMTP_REJECT_UNAUTHORIZED === undefined &&
        process.env.SMTP_TLS_ENABLED === undefined
      ) {
        console.warn(
          "⚠️  Certificate validation is now enabled by default for SMTP connections. Set SMTP_REJECT_UNAUTHORIZED=true to silence this warning, or SMTP_REJECT_UNAUTHORIZED=false if using self-signed certificates.",
        );
      }

      return createTransport({
        host: process.env.SMTP_HOST,
        port,
        secure,
        auth: hasAuth
          ? {
              user: process.env.SMTP_USER,
              pass: process.env.SMTP_PWD,
            }
          : undefined,
        tls: {
          rejectUnauthorized,
          servername: process.env.SMTP_TLS_SERVERNAME,
        },
      });
    }
  }
}

/**
 * Returns a process-wide memoized nodemailer transport, derived from
 * `EMAIL_PROVIDER` + the provider's env vars. Reused across every send in the
 * same (warm) process — unlike the previous per-`EmailClient`-instance cache,
 * which never outlived a single send.
 */
export function getTransport(): Transporter {
  if (!cachedTransport) {
    const provider =
      (process.env.EMAIL_PROVIDER as EmailProvider | undefined) ?? "smtp";
    cachedTransport = createTransportForProvider(provider);
  }
  return cachedTransport;
}