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",
  },
});

Mutualisez les connexions pour un volume élevé :

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 avec requireTLS: true signifie STARTTLS : Nodemailer se connecte en clair et passe en TLS avant d’envoyer votre clé API, et refuse de continuer si le passage échoue. Le TLS implicite (secure: true, port 465) n’est pas encore proposé.

Préférez le SDK Node.js pour du nouveau code : il renvoie l’id de l’e-mail et des erreurs plus riches.