Nodemailer email sending tested with jsonTransport: working versions (tested 2026-10-15)

{
  "name": "nodemailer-templates-test-transport",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node --import tsx --test test/*.test.ts"
  },
  "dependencies": {
    "nodemailer": "10.1.1"
  },
  "devDependencies": {
    "tsx": "4.23.15",
    "@types/node": "24.19.2",
    "@types/nodemailer": "8.0.2"
  }
}

import nodemailer, { type Transporter } from "nodemailer";

// prod: nodemailer.createTransport({ host, port: 587, secure: false, auth: { user, pass } })
export const testTransport = () => nodemailer.createTransport({ jsonTransport: true });

export async function sendInvoice(t: Transporter, to: string, invoiceNo: string, pdf: Buffer) {
  const info = await t.sendMail({
    from: '"Billing" <[email protected]>',
    to,
    subject: `Invoice ${invoiceNo}`,
    text: `Your invoice ${invoiceNo} is attached.`,
    html: `<p>Your invoice <b>${invoiceNo}</b> is attached.</p>`,
    attachments: [{ filename: `${invoiceNo}.pdf`, content: pdf, contentType: "application/pdf" }],
    headers: { "X-Invoice": invoiceNo },
  });
  return info;
}

import { test } from "node:test";
import assert from "node:assert/strict";
import { sendInvoice, testTransport } from "../src/mailer.ts";

test("builds a multipart message with attachment", async () => {
  const info: any = await sendInvoice(testTransport(), "[email protected]", "INV-7", Buffer.from("%PDF-1.4"));
  const msg = JSON.parse(info.message);
  assert.equal(msg.subject, "Invoice INV-7");
  assert.deepEqual(msg.to.map((a: any) => a.address), ["[email protected]"]);
  assert.match(msg.html, /<b>INV-7<\/b>/);
  assert.ok(msg.text);
  assert.equal(msg.attachments[0].filename, "INV-7.pdf");
  assert.equal(Buffer.from(msg.attachments[0].content, "base64").toString(), "%PDF-1.4");
  const headers = Object.fromEntries(Object.entries(msg.headers ?? {}).map(([k, v]) => [k.toLowerCase(), v]));
  assert.equal(headers["x-invoice"], "INV-7");
});

test("envelope has the right sender and recipients", async () => {
  const info: any = await sendInvoice(testTransport(), "[email protected]", "INV-8", Buffer.alloc(1));
  assert.deepEqual(info.envelope, { from: "[email protected]", to: ["[email protected]"] });
});