Migrate from Nodemailer

Email SDK includes a typed SMTP transport backed by Nodemailer. It handles address fields, text/HTML bodies, headers, TLS upgrade, SMTP auth, RFC-safe subjects, transfer encoding, and MIME attachments.

Replace the transporter

after.ts

import { createEmailClient } from "@opencoredev/email-sdk";
import { smtp } from "@opencoredev/email-sdk/smtp";

const email = createEmailClient({
  adapters: [
    smtp({
      host: process.env.SMTP_HOST!,
      port: Number(process.env.SMTP_PORT ?? 587),
      auth: {
        user: process.env.SMTP_USER!,
        pass: process.env.SMTP_PASS!,
      },
    }),
  ],
});

On a non-secure port, SMTP auth upgrades with STARTTLS by default. allowInsecureAuth exists only for trusted local test servers.

Replace `sendMail`

after.ts

const result = await email.send(
  {
    from: "Acme <hello@acme.com>",
    to: "user@example.com",
    subject: "Welcome",
    text: "Your account is ready.",
    html: "<p>Your account is ready.</p>",
    headers: [{ name: "X-App", value: "acme" }],
  },
  { idempotencyKey: "welcome:user_123" },
);

The transport creates multipart/alternative for text plus HTML and derives Message-ID from the idempotency key.

Account for unsupported features

The SMTP adapter still has no tag, metadata, or scheduling concept. Keep a custom adapter if your SMTP workflow depends on advanced transport plugins.

Verify

SMTP_HOST=smtp.example.com npx --package @opencoredev/email-sdk email-sdk doctor --adapter smtp
npx --package @opencoredev/email-sdk email-sdk send \
  --adapter smtp \
  --host smtp.example.com \
  --from hello@example.com \
  --to user@example.com \
  --subject "Migration smoke test" \
  --text "Dry run only." \
  --dry-run

SMTP adapter

See TLS, auth, custom names, and transport limits.