@c9up/rover 0.1.8 → 0.1.9

package/dist/MessageBuilder.js

@@ -1,5 +1,88 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { fileURLToPath } from "node:url";
 import { formatAddress } from "./format.js";
+import { RoverError } from "./RoverError.js";
 import { renderFile as renderTemplateFile } from "./templating/SimpleTemplate.js";
+/** Whether `list` holds `address`, or anything at all when it is omitted. */
+function contains(list, address) {
+    if (address === undefined)
+        return list.length > 0;
+    // Addresses are stored formatted (`"Name" <a@b.c>`), so an assertion on the
+    // bare address has to match inside the display form too.
+    return list.some((entry) => entry === address || entry.includes(`<${address}>`));
+}
+/**
+ * The parts a transport with no calendar field must send: the declared
+ * attachments, plus the invitation rendered as a `text/calendar` part.
+ *
+ * Only nodemailer has a native `icalEvent`; the provider HTTP APIs carry an
+ * invitation the way every mail client reads it anyway — as an attachment with
+ * the right media type and `method` parameter.
+ */
+export function attachmentsFor(message) {
+    const ical = message.icalEvent;
+    if (ical === undefined)
+        return message.attachments;
+    if (ical.content === undefined) {
+        // `icalEventFromUrl` leaves only an href, which nodemailer fetches for
+        // SMTP. An HTTP provider takes the bytes, and silently dropping the
+        // invitation would be worse than saying so.
+        throw new RoverError("ICAL_HREF_UNSUPPORTED", "icalEventFromUrl() is only supported by the SMTP transport, which fetches the URL itself.", {
+            hint: "Fetch the ICS yourself and pass it to icalEvent(contents), or use icalEventFromFile().",
+        });
+    }
+    const method = ical.method ?? "PUBLISH";
+    return [
+        ...message.attachments,
+        {
+            filename: ical.filename ?? "invite.ics",
+            content: ical.content,
+            contentType: `text/calendar; charset=utf-8; method=${method}`,
+            encoding: ical.encoding,
+        },
+    ];
+}
+/** Read a file declared by `attach()` / `embed()` / `icalEventFromFile()`. */
+async function readAttachment(path, label) {
+    try {
+        return await readFile(path);
+    }
+    catch (err) {
+        throw new RoverError("ATTACHMENT_UNREADABLE", `Could not read ${label} from "${path}": ${err instanceof Error ? err.message : String(err)}`, {
+            hint: "Give an absolute path, or attach the bytes with attachData() / embedData().",
+        });
+    }
+}
+/** Every URL inside a `List-*` value, whatever nesting form it was written in. */
+function listUrls(value) {
+    if (typeof value === "string")
+        return [value];
+    if (Array.isArray(value))
+        return value.flatMap((entry) => listUrls(entry));
+    return [value.url];
+}
+/** `unsubscribe` → `Unsubscribe`, `unsubscribe-post` → `Unsubscribe-Post`. */
+function titleCaseKey(key) {
+    return key
+        .split("-")
+        .map((part) => (part ? part[0].toUpperCase() + part.slice(1) : part))
+        .join("-");
+}
+/** Render one `List-*` value the way RFC 2369 writes it: `<url> (comment)`. */
+function renderListHeader(value) {
+    if (typeof value === "string")
+        return `<${value}>`;
+    if (Array.isArray(value)) {
+        return value.map((entry) => renderListHeader(entry)).join(", ");
+    }
+    return value.comment ? `<${value.url}> (${value.comment})` : `<${value.url}>`;
+}
+function expect(passed, expectation, actual) {
+    if (passed)
+        return;
+    throw new RoverError("ASSERTION_FAILED", `Expected the message ${expectation}, got ${JSON.stringify(actual)}`);
+}
 export class MessageBuilder {
     #msg = {
         from: "",
@@ -11,6 +94,158 @@ export class MessageBuilder {
         headers: {},
     };
     #pendingView = null;
+    #pendingTextView = null;
+    /**
+     * Render a template as the PLAIN-TEXT body (AdonisJS `textView`).
+     *
+     * The counterpart of `htmlView`. A message with only an HTML part scores
+     * worse with spam filters and is unreadable in a text-only client, which is
+     * why upstream offers both.
+     */
+    textView(path, data = {}) {
+        this.#pendingTextView = { path, data };
+        return this;
+    }
+    /**
+     * Override the SMTP envelope — who the message is really from and to, as
+     * far as the mail servers are concerned (AdonisJS `envelope`).
+     *
+     * Distinct from the `From`/`To` HEADERS: a bounce goes to the envelope
+     * sender, which is how VERP and mailing lists route failures away from the
+     * visible author.
+     */
+    envelope(envelope) {
+        this.#msg.envelope = envelope;
+        return this;
+    }
+    /**
+     * The message as built so far — what the `has*` / `assert*` helpers read.
+     *
+     * Exposed because a test asserts against a mail it never sent, and the
+     * alternative is rebuilding the message just to look at it.
+     */
+    toObject() {
+        return this.#msg;
+    }
+    toJSON() {
+        return this.toObject();
+    }
+    // ── Inspection ────────────────────────────────────────────────────────
+    // `has*` answers, `assert*` throws. Both exist because a test reads better
+    // as an assertion and a conditional reads better as a question.
+    hasTo(address) {
+        return contains(this.#msg.to, address);
+    }
+    hasCc(address) {
+        return contains(this.#msg.cc, address);
+    }
+    hasBcc(address) {
+        return contains(this.#msg.bcc, address);
+    }
+    hasFrom(address) {
+        return contains(this.#msg.from ? [this.#msg.from] : [], address);
+    }
+    hasReplyTo(address) {
+        return contains(this.#msg.replyTo ? [this.#msg.replyTo] : [], address);
+    }
+    hasSubject(subject) {
+        if (subject === undefined)
+            return this.#msg.subject !== "";
+        return this.#msg.subject === subject;
+    }
+    /**
+     * Whether the message carries an attachment — any at all, one with this
+     * filename or source path, or one a predicate accepts (AdonisJS
+     * `hasAttachment`, whose overloads are the same three).
+     */
+    hasAttachment(match) {
+        if (match === undefined)
+            return this.#msg.attachments.length > 0;
+        if (typeof match === "function")
+            return this.#msg.attachments.some(match);
+        const needle = match instanceof URL ? fileURLToPath(match) : match;
+        return this.#msg.attachments.some((a) => a.filename === needle || a.path === needle);
+    }
+    /**
+     * Whether `address` is a recipient in ANY field (AdonisJS `hasRecipient`).
+     * Without one, whether the message has a recipient at all.
+     */
+    hasRecipient(address) {
+        return this.hasTo(address) || this.hasCc(address) || this.hasBcc(address);
+    }
+    /**
+     * Whether the given text appears in the HTML body or the plain-text one
+     * (AdonisJS `hasContent`). The field-specific assertions are
+     * {@link assertHtmlIncludes} and {@link assertTextIncludes}.
+     */
+    hasContent(needle) {
+        return ((this.#msg.html?.includes(needle) ?? false) ||
+            (this.#msg.text?.includes(needle) ?? false));
+    }
+    /** Whether a `List-<key>` header was defined. */
+    hasListHeader(key, url) {
+        const value = this.#msg.list?.[key];
+        if (value === undefined)
+            return false;
+        if (url === undefined)
+            return true;
+        return listUrls(value).includes(url);
+    }
+    hasHeader(name, value) {
+        const found = this.#msg.headers[name];
+        if (found === undefined)
+            return false;
+        if (value === undefined)
+            return true;
+        return Array.isArray(found) ? found.includes(value) : found === value;
+    }
+    assertTo(address) {
+        expect(this.hasTo(address), `to include "${address}"`, this.#msg.to);
+    }
+    assertFrom(address) {
+        expect(this.hasFrom(address), `from to be "${address}"`, this.#msg.from);
+    }
+    assertCc(address) {
+        expect(this.hasCc(address), `cc to include "${address}"`, this.#msg.cc);
+    }
+    assertBcc(address) {
+        expect(this.hasBcc(address), `bcc to include "${address}"`, this.#msg.bcc);
+    }
+    assertReplyTo(address) {
+        expect(this.hasReplyTo(address), `replyTo to be "${address}"`, this.#msg.replyTo);
+    }
+    assertSubject(subject) {
+        expect(this.hasSubject(subject), `subject to be "${subject}"`, this.#msg.subject);
+    }
+    assertAttachment(match) {
+        expect(this.hasAttachment(match), typeof match === "function"
+            ? "an attachment matching the predicate"
+            : `an attachment named "${String(match)}"`, this.#msg.attachments.map((a) => a.path ?? a.filename));
+    }
+    /** `address` is a recipient in some field (AdonisJS `assertRecipient`). */
+    assertRecipient(address) {
+        expect(this.hasRecipient(address), `to reach "${address}"`, {
+            to: this.#msg.to,
+            cc: this.#msg.cc,
+            bcc: this.#msg.bcc,
+        });
+    }
+    /** The text appears in the HTML or the plain-text body (AdonisJS `assertContent`). */
+    assertContent(needle) {
+        expect(this.hasContent(needle), `to contain "${needle}"`, {
+            html: this.#msg.html,
+            text: this.#msg.text,
+        });
+    }
+    assertHeader(name, value) {
+        expect(this.hasHeader(name, value), value === undefined ? `a "${name}" header` : `${name}: ${value}`, this.#msg.headers[name]);
+    }
+    assertHtmlIncludes(substring) {
+        expect((this.#msg.html ?? "").includes(substring), `html to include "${substring}"`, this.#msg.html);
+    }
+    assertTextIncludes(substring) {
+        expect((this.#msg.text ?? "").includes(substring), `text to include "${substring}"`, this.#msg.text);
+    }
     from(address, name) {
         this.#msg.from = formatAddress(address, name);
         return this;
@@ -63,24 +298,160 @@ export class MessageBuilder {
         this.#msg.references = messageIds.slice();
         return this;
     }
-    attach(filename, content, contentType) {
-        this.#msg.attachments.push({ filename, content, contentType });
+    /**
+     * Attach a FILE by path or `file://` URL (AdonisJS `attach`). The bytes are
+     * read at {@link build} time, so the fluent chain stays synchronous.
+     *
+     * The filename defaults to the file's own basename. For bytes you already
+     * hold, use {@link attachData}.
+     */
+    attach(file, options) {
+        const path = file instanceof URL ? fileURLToPath(file) : file;
+        this.#msg.attachments.push({
+            filename: options?.filename ?? basename(path),
+            // Filled in by `build()`; an unread attachment must never ship as an
+            // empty part, so `build()` failing to read is an error, not a warning.
+            content: "",
+            path,
+            contentType: options?.contentType,
+            contentDisposition: options?.contentDisposition,
+            encoding: options?.encoding,
+            headers: options?.headers,
+        });
         return this;
     }
     /**
-     * Embed inline content referenced by a Content-ID. Use `cid:<cid>` inside the
-     * HTML body to reference it. Content-based (rover is agnostic / no-fs): the
-     * path-based `embed(file, cid)` form from `@adonisjs/mail` is a deliberate
-     * divergence — pass the bytes directly instead.
+     * Attach bytes you already hold (AdonisJS `attachData`). `filename` is
+     * required — there is no path to take it from.
      */
-    embedData(content, cid, contentType) {
-        this.#msg.attachments.push({ filename: cid, content, contentType, cid });
+    attachData(content, options) {
+        this.#msg.attachments.push({
+            filename: options.filename,
+            content,
+            contentType: options.contentType,
+            contentDisposition: options.contentDisposition,
+            encoding: options.encoding,
+            headers: options.headers,
+        });
+        return this;
+    }
+    /**
+     * Embed a FILE inline, referenced by `cid:<cid>` in the HTML body (AdonisJS
+     * `embed`). Read at {@link build} time, like {@link attach}.
+     */
+    embed(file, cid, options) {
+        const path = file instanceof URL ? fileURLToPath(file) : file;
+        this.#msg.attachments.push({
+            filename: options?.filename ?? basename(path),
+            content: "",
+            path,
+            cid,
+            contentType: options?.contentType,
+            contentDisposition: options?.contentDisposition ?? "inline",
+            encoding: options?.encoding,
+            headers: options?.headers,
+        });
+        return this;
+    }
+    /**
+     * Embed bytes you already hold, referenced by `cid:<cid>` in the HTML body
+     * (AdonisJS `embedData`).
+     */
+    embedData(content, cid, options) {
+        this.#msg.attachments.push({
+            filename: options?.filename ?? cid,
+            content,
+            cid,
+            contentType: options?.contentType,
+            contentDisposition: options?.contentDisposition ?? "inline",
+            encoding: options?.encoding,
+            headers: options?.headers,
+        });
         return this;
     }
     header(key, value) {
         this.#msg.headers[key] = value;
         return this;
     }
+    /**
+     * Body transfer encoding (AdonisJS `encoding`) — `7bit`, `base64`,
+     * `quoted-printable`… SMTP only: the provider HTTP APIs encode the payload
+     * themselves and expose no equivalent.
+     */
+    encoding(encoding) {
+        this.#msg.encoding = encoding;
+        return this;
+    }
+    // ── RFC 2369 List-* headers ───────────────────────────────────────────
+    /**
+     * Define a `List-<key>` header (AdonisJS `addListHeader`). `key` carries no
+     * `List-` prefix — `addListHeader('archive', url)` emits `List-Archive`.
+     * Calling it again for the same key replaces the value.
+     */
+    addListHeader(key, value) {
+        this.#msg.list ??= {};
+        this.#msg.list[key] = value;
+        return this;
+    }
+    /**
+     * `List-Unsubscribe` (AdonisJS `listUnsubscribe`).
+     *
+     * `{ oneClick: true }` also emits the RFC 8058 `List-Unsubscribe-Post`
+     * header. Gmail and Yahoo require BOTH for bulk senders, and only a `https:`
+     * URL is a valid one-click target — a `mailto:` cannot answer a POST, so
+     * pairing them is refused rather than silently shipped.
+     */
+    listUnsubscribe(value, options) {
+        if (options?.oneClick === true) {
+            for (const url of listUrls(value)) {
+                if (!url.toLowerCase().startsWith("http")) {
+                    throw new RoverError("INVALID_LIST_HEADER", `listUnsubscribe({ oneClick: true }) needs an https URL that can answer a POST, got "${url}".`, {
+                        hint: "Keep the mailto: form without oneClick, or add an https endpoint alongside it.",
+                    });
+                }
+            }
+            // A RAW header, not a `List-*` entry: nodemailer wraps every list value
+            // in angle brackets, and `<List-Unsubscribe=One-Click>` is not what
+            // RFC 8058 specifies — receivers would ignore it.
+            this.#msg.headers["List-Unsubscribe-Post"] = "List-Unsubscribe=One-Click";
+        }
+        return this.addListHeader("unsubscribe", value);
+    }
+    /** `List-Subscribe` (AdonisJS `listSubscribe`). */
+    listSubscribe(value) {
+        return this.addListHeader("subscribe", value);
+    }
+    /** `List-Help` (AdonisJS `listHelp`). */
+    listHelp(value) {
+        return this.addListHeader("help", value);
+    }
+    // ── Calendar invitations ──────────────────────────────────────────────
+    /**
+     * Attach a calendar invitation from an ICS string (AdonisJS `icalEvent`).
+     *
+     * Named deviation: upstream also accepts a `(calendar: ICalCalendar) => void`
+     * builder, which is `ical-generator`'s API. rover carries no such
+     * dependency, so it takes the ICS text — produced by whichever generator you
+     * prefer. {@link icalEventFromFile} and {@link icalEventFromUrl} are the
+     * other two upstream forms, unchanged.
+     */
+    icalEvent(contents, options) {
+        this.#msg.icalEvent = { ...options, content: contents };
+        return this;
+    }
+    /** Calendar invitation read from a file at {@link build} time (AdonisJS `icalEventFromFile`). */
+    icalEventFromFile(file, options) {
+        this.#msg.icalEvent = {
+            ...options,
+            path: file instanceof URL ? fileURLToPath(file) : file,
+        };
+        return this;
+    }
+    /** Calendar invitation the transport fetches from a URL (AdonisJS `icalEventFromUrl`). */
+    icalEventFromUrl(url, options) {
+        this.#msg.icalEvent = { ...options, href: url };
+        return this;
+    }
     /**
      * Queue an HTML template render. The render happens lazily at `build()` time
      * so the fluent chain stays synchronous; `build()` is async and awaits the
@@ -101,6 +472,29 @@ export class MessageBuilder {
             this.#msg.html = await renderTemplateFile(this.#pendingView.path, this.#pendingView.data, undefined, viewsRoot);
             this.#pendingView = null;
         }
+        if (this.#pendingTextView !== null) {
+            this.#msg.text = await renderTemplateFile(this.#pendingTextView.path, this.#pendingTextView.data, undefined, viewsRoot);
+            this.#pendingTextView = null;
+        }
+        // Path-based attachments and invitations are read here, not when they were
+        // declared, so the fluent chain stays synchronous. A read failure raises:
+        // an attachment the recipient expects must never ship as an empty part.
+        for (const attachment of this.#msg.attachments) {
+            if (attachment.path === undefined)
+                continue;
+            attachment.content = await readAttachment(attachment.path, attachment.filename);
+        }
+        const ical = this.#msg.icalEvent;
+        if (ical?.path !== undefined && ical.content === undefined) {
+            ical.content = (await readAttachment(ical.path, "the calendar event")).toString("utf8");
+        }
+        // `List-*` headers are rendered here, once, rather than in each transport:
+        // every transport already forwards `headers`, and only nodemailer has a
+        // structured `list` field. `#msg.list` stays as the structured record the
+        // `hasListHeader` inspection reads.
+        for (const [key, value] of Object.entries(this.#msg.list ?? {})) {
+            this.#msg.headers[`List-${titleCaseKey(key)}`] = renderListHeader(value);
+        }
         return this.#msg;
     }
 }

package/dist/MessageBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessageBuilder.js","sourceRoot":"","sources":["../src/MessageBuilder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MessageBuilder.js","sourceRoot":"","sources":["../src/MessageBuilder.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,4 +1,42 @@
 import type { MailConfig } from "./Mail.js";
+import type { RetryConfig } from "./retry.js";
 export declare function defineConfig(config: MailConfig): MailConfig;
+/** One mailer's settings — the transport name plus whatever it reads. */
+export interface TransportDescriptor {
+    transport: string;
+    retry?: RetryConfig;
+    [key: string]: unknown;
+}
+type Options = Record<string, unknown> & {
+    retry?: RetryConfig;
+};
+/**
+ * Mailer descriptors for `defineConfig`, matching the AdonisJS call site:
+ *
+ *   defineConfig({
+ *     default: 'smtp',
+ *     from: 'noreply@acme.com',
+ *     mailers: { smtp: transports.smtp({ host: env.get('SMTP_HOST') }) },
+ *   })
+ *
+ * Named deviation: upstream returns a config PROVIDER that lazily imports the
+ * transport. Rover returns the plain descriptor its config can persist, and the
+ * transport registers itself on import.
+ *
+ * Postmark has no helper here on purpose: rover has no Postmark transport, so a
+ * migrated config naming it fails to COMPILE — which says so plainly — instead
+ * of throwing at boot.
+ */
+export declare const transports: {
+    smtp: (config?: Options) => TransportDescriptor;
+    ses: (config?: Options) => TransportDescriptor;
+    mailgun: (config?: Options) => TransportDescriptor;
+    sparkpost: (config?: Options) => TransportDescriptor;
+    resend: (config?: Options) => TransportDescriptor;
+    brevo: (config?: Options) => TransportDescriptor;
+    sendgrid: (config?: Options) => TransportDescriptor;
+    /** Writes to the logger instead of sending — the local-development mailer. */
+    log: (config?: Options) => TransportDescriptor;
+};
 export type { MailConfig };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AASjE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU;oBAvBN,OAAO,KAAQ,mBAAmB;mBAAlC,OAAO,KAAQ,mBAAmB;uBAAlC,OAAO,KAAQ,mBAAmB;yBAAlC,OAAO,KAAQ,mBAAmB;sBAAlC,OAAO,KAAQ,mBAAmB;qBAAlC,OAAO,KAAQ,mBAAmB;wBAAlC,OAAO,KAAQ,mBAAmB;IA+BlD,8EAA8E;mBA/B9D,OAAO,KAAQ,mBAAmB;CAiClD,CAAC;AAEF,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/config.js

@@ -1,4 +1,38 @@
 export function defineConfig(config) {
     return config;
 }
+function describe(transport) {
+    return (config = {}) => ({
+        ...config,
+        transport,
+    });
+}
+/**
+ * Mailer descriptors for `defineConfig`, matching the AdonisJS call site:
+ *
+ *   defineConfig({
+ *     default: 'smtp',
+ *     from: 'noreply@acme.com',
+ *     mailers: { smtp: transports.smtp({ host: env.get('SMTP_HOST') }) },
+ *   })
+ *
+ * Named deviation: upstream returns a config PROVIDER that lazily imports the
+ * transport. Rover returns the plain descriptor its config can persist, and the
+ * transport registers itself on import.
+ *
+ * Postmark has no helper here on purpose: rover has no Postmark transport, so a
+ * migrated config naming it fails to COMPILE — which says so plainly — instead
+ * of throwing at boot.
+ */
+export const transports = {
+    smtp: describe("smtp"),
+    ses: describe("ses"),
+    mailgun: describe("mailgun"),
+    sparkpost: describe("sparkpost"),
+    resend: describe("resend"),
+    brevo: describe("brevo"),
+    sendgrid: describe("sendgrid"),
+    /** Writes to the logger instead of sending — the local-development mailer. */
+    log: describe("log"),
+};
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,OAAO,MAAM,CAAC;AACf,CAAC;AAWD,SAAS,QAAQ,CAAC,SAAiB;IAClC,OAAO,CAAC,SAAkB,EAAE,EAAuB,EAAE,CAAC,CAAC;QACtD,GAAG,MAAM;QACT,SAAS;KACT,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;IACtB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC5B,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC;IAChC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;IAC9B,8EAA8E;IAC9E,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC;CACpB,CAAC"}

package/dist/format.d.ts

@@ -7,6 +7,16 @@
  * Format a recipient address with an optional display name into the
  * `"Name" <address>` form (RFC 5322 quoted display name). A bare address —
  * or an empty/whitespace-only name — is returned unchanged.
+ *
+ * The display name is a QUOTED string, so a `"` inside it would close the quote
+ * early: a name of `x" <evil@example.com>, "y` would otherwise forge a second
+ * recipient. Backslash and quote are escaped, which is what a quoted-string
+ * allows.
+ *
+ * A line break cannot be escaped in a header — it ENDS the header — so a value
+ * carrying CR, LF or NUL is rejected rather than mangled. Accepting it is how a
+ * contact form turns into an open relay: one `\r\nBcc:` and the message goes
+ * wherever the attacker asked.
  */
 export declare function formatAddress(address: string, name?: string): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAQpE"}

package/dist/format.js

@@ -3,12 +3,39 @@
  * so both `BaseMail` and `MessageBuilder` can import it without re-introducing
  * the BaseMail ↔ MessageBuilder value cycle.
  */
+import { RoverError } from "./RoverError.js";
+/** CR, LF and NUL — the characters that end a header line or a C string. */
+const HEADER_BREAKERS = /[\r\n\0]/;
 /**
  * Format a recipient address with an optional display name into the
  * `"Name" <address>` form (RFC 5322 quoted display name). A bare address —
  * or an empty/whitespace-only name — is returned unchanged.
+ *
+ * The display name is a QUOTED string, so a `"` inside it would close the quote
+ * early: a name of `x" <evil@example.com>, "y` would otherwise forge a second
+ * recipient. Backslash and quote are escaped, which is what a quoted-string
+ * allows.
+ *
+ * A line break cannot be escaped in a header — it ENDS the header — so a value
+ * carrying CR, LF or NUL is rejected rather than mangled. Accepting it is how a
+ * contact form turns into an open relay: one `\r\nBcc:` and the message goes
+ * wherever the attacker asked.
  */
 export function formatAddress(address, name) {
-    return name !== undefined && name !== "" ? `"${name}" <${address}>` : address;
+    assertHeaderSafe(address, "address");
+    if (name === undefined || name === "")
+        return address;
+    assertHeaderSafe(name, "name");
+    // Escape the escape character first, or a trailing backslash would swallow
+    // the closing quote.
+    const quoted = name.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    return `"${quoted}" <${address}>`;
+}
+function assertHeaderSafe(value, what) {
+    if (!HEADER_BREAKERS.test(value))
+        return;
+    throw new RoverError("MAIL_HEADER_INJECTION", `The ${what} contains a line break or NUL, which cannot appear in a mail header.`, {
+        hint: "Strip CR/LF/NUL from user-supplied names and addresses before building the message.",
+    });
 }
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAa;IAC3D,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAa;IAC3D,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IACtD,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,qBAAqB;IACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChE,OAAO,IAAI,MAAM,MAAM,OAAO,GAAG,CAAC;AACnC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,IAAY;IACpD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO;IACzC,MAAM,IAAI,UAAU,CACnB,uBAAuB,EACvB,OAAO,IAAI,sEAAsE,EACjF;QACC,IAAI,EAAE,qFAAqF;KAC3F,CACD,CAAC;AACH,CAAC"}