Nodemailer

npm install nodemailer

mail.ts

import nodemailer from "nodemailer";

export const transport = nodemailer.createTransport({
  host: "smtp.spacepost.dev",
  port: 25976,
  secure: false, // STARTTLS: the connection is upgraded to TLS before login
  requireTLS: true,
  auth: { user: "spacepost", pass: process.env.SPACEPOST_API_KEY },
});

await transport.sendMail({
  from: '"Acme" <hello@acme.com>',
  to: ["user@example.com"],
  cc: "manager@example.com",
  subject: "Your invoice",
  text: "Invoice attached.",
  html: '<p>Invoice attached.</p><img src="cid:logo" />',
  attachments: [
    { filename: "invoice.pdf", path: "./invoice.pdf" },
    { filename: "logo.png", path: "./logo.png", cid: "logo" },
  ],
  headers: {
    "X-SpacePost-Tags": "category=invoice, order_id=1042",
    "X-SpacePost-Scheduled-At": "in 1 hour",
  },
});

Usa un pool di connessioni per volumi elevati:

nodemailer.createTransport({
  host: "smtp.spacepost.dev",
  port: 25976,
  secure: false,
  requireTLS: true,
  pool: true,
  maxConnections: 5,
  auth: { user: "spacepost", pass: process.env.SPACEPOST_API_KEY },
});

secure: false con requireTLS: true significa STARTTLS: Nodemailer si connette in chiaro e passa a TLS prima di inviare la tua chiave API, e si rifiuta di continuare se il passaggio non riesce. Il TLS implicito (secure: true, porta 465) non è ancora disponibile.

Per il nuovo codice preferisci l’SDK Node.js: restituisce l’id dell’email ed errori più ricchi.