@nxgt/mail 0.1.0

package/dist/conformance/cases/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/conformance/cases/send.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,uDAAuD;AACvD,eAAO,MAAM,SAAS,EAAE,SAAS,UAAU,EAiK1C,CAAC"}

package/dist/conformance/describe.d.ts

@@ -0,0 +1,37 @@
+import type { MailerCase, MailerHarness, MailerRunner } from './types';
+/** Why a case did not run. A skip is always reported with its reason, never silent. */
+export declare const MAILER_SKIP_REASONS: {
+    readonly faults: "faults not provided: the failure contract is not proven for this transport";
+};
+/**
+ * Runs one case against a freshly opened transport, and closes it, pass or
+ * fail. Answers the reason when the case cannot run on this harness.
+ */
+export declare function runMailerCase(mailerCase: MailerCase, harness: MailerHarness): Promise<{
+    readonly skipped: string;
+} | {
+    readonly passed: true;
+}>;
+/**
+ * Describes every case against one transport, under bun:test, vitest or jest.
+ *
+ * ```ts
+ * import { describe, it } from 'bun:test';
+ * import { describeMailer } from '@nxgt/mail/conformance';
+ *
+ * describeMailer({ name: 'my transport', harness, runner: { describe, it } });
+ * ```
+ *
+ * `runner` defaults to the global `describe` and `it`, when the framework
+ * defines them.
+ */
+export declare function describeMailer(options: {
+    readonly name: string;
+    readonly harness: MailerHarness;
+    readonly runner?: MailerRunner;
+    /** Case ids to skip, each with the reason — reported, never silent. */
+    readonly skip?: Readonly<Record<string, string>>;
+    /** Declared up front, so a missing `faults` is reported before the first case runs. */
+    readonly faults?: boolean;
+}): void;
+//# sourceMappingURL=describe.d.ts.map

package/dist/conformance/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/conformance/describe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE,uFAAuF;AACvF,eAAO,MAAM,mBAAmB;;CAGtB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,aAAa,CAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC,CAyBnE;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,IAAI,CA+BP"}

package/dist/conformance/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@nxgt/mail/conformance` — **what makes the transport contract checkable.**
+ *
+ * A transport author runs this against their transport, and it fails one that
+ * breaks the contract of the port — above all *a failure throws*: an outage
+ * that resolves, or a transport that retries in secret, or its own copy of
+ * `MailFailure` that `instanceof` rejects.
+ *
+ * Three layers, and the lowest depends on no test runner:
+ *
+ * - the cases, as data — `sendCases`, `failureCases`, `allMailerCases`;
+ * - `runMailerCase`, which runs one against a harness;
+ * - `describeMailer`, which describes them all under bun:test, vitest or jest.
+ */
+export { allMailerCases, failureCases, sendCases } from './cases/index';
+export { describeMailer, MAILER_SKIP_REASONS, runMailerCase, } from './describe';
+export { referenceMailerHarness } from './reference';
+export { sampleMessage } from './sample';
+export type { DeliveredMail, MailerCase, MailerCaseContext, MailerFaults, MailerHarness, MailerRunner, OpenedMailer, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/conformance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACN,cAAc,EACd,mBAAmB,EACnB,aAAa,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EACX,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,GACZ,MAAM,SAAS,CAAC"}

package/dist/conformance/index.js

@@ -0,0 +1,297 @@
+import {
+  recipientsOf2,
+  createMemoryMailer2
+} from "../chunks/index-0f7kdb8k.js";
+import {
+  MailError2,
+  MailFailure2,
+  MailRefused2
+} from "../chunks/index-we4n5yfz.js";
+
+// src/conformance/assert.ts
+function check(condition, what) {
+  if (!condition)
+    throw new Error(`conformance: ${what}`);
+}
+var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+async function rejection(promise, what) {
+  return promise.then(() => {
+    throw new Error(`conformance: ${what} resolved; it must reject`);
+  }, (error) => error);
+}
+async function nothingDelivered(context, what) {
+  check((await context.delivered()).length === 0, `${what}, yet something was delivered`);
+}
+
+// src/conformance/sample.ts
+var sampleMessage = {
+  to: "ada@example.test",
+  from: "noreply@example.test",
+  subject: "Réinitialisez votre mot de passe — ça expire à 23 h",
+  html: '<p>Bonjour Ada \uD83D\uDC4B, <a href="https://example.test/r?t=abc&amp;x=1">réinitialiser</a></p>',
+  text: `Bonjour Ada \uD83D\uDC4B,
+
+réinitialiser : https://example.test/r?t=abc&x=1
+`
+};
+
+// src/conformance/cases/failure.ts
+var failureCases = [
+  {
+    id: "failure.outage",
+    title: "an outage throws MailFailure with the cause, and nothing is retried",
+    needs: "faults",
+    async run(context) {
+      const faults = context.faults;
+      check(faults !== null, "faults are required");
+      await faults.failNext("outage");
+      const error = await rejection(context.mailer.send(sampleMessage), "a send during an outage");
+      check(error instanceof MailFailure2, "an outage must throw MailFailure from @nxgt/mail");
+      check(error instanceof MailError2, "MailFailure must extend MailError");
+      check(error.code === "MAIL_FAILED", "an outage must carry the code MAIL_FAILED");
+      check(error.cause !== undefined, "an outage must carry the transport's error as cause");
+      check(await faults.attempts() === 1, "the transport retried a failed hand-over");
+      await nothingDelivered(context, "the hand-over failed");
+    }
+  },
+  {
+    id: "failure.refusal",
+    title: "a message the provider refuses throws MailRefused with the cause",
+    needs: "faults",
+    async run(context) {
+      const faults = context.faults;
+      check(faults !== null, "faults are required");
+      await faults.failNext("refusal");
+      const error = await rejection(context.mailer.send(sampleMessage), "a refused send");
+      check(error instanceof MailRefused2, "a refusal must throw MailRefused from @nxgt/mail");
+      check(error.code === "MAIL_REFUSED", "a refusal must carry the code MAIL_REFUSED");
+      check(error.cause !== undefined, "a refusal must carry the transport's error as cause");
+      check(await faults.attempts() === 1, "the transport retried a refused message");
+    }
+  },
+  {
+    id: "failure.recovers",
+    title: "after a failure, the next send goes through",
+    needs: "faults",
+    async run(context) {
+      const faults = context.faults;
+      check(faults !== null, "faults are required");
+      await faults.failNext("outage");
+      await rejection(context.mailer.send(sampleMessage), "a send during an outage");
+      await context.mailer.send(sampleMessage);
+      check((await context.delivered()).length === 1, "the send after a failure was not delivered");
+    }
+  }
+];
+
+// src/conformance/cases/send.ts
+var sendCases = [
+  {
+    id: "send.answersSentMail",
+    title: "a send answers SentMail, with a string id or null",
+    async run({ mailer }) {
+      const sent = await mailer.send(sampleMessage);
+      check(typeof sent === "object" && sent !== null && "messageId" in sent, "send did not answer an object with messageId");
+      check(sent.messageId === null || typeof sent.messageId === "string" && sent.messageId !== "", "messageId must be a non-empty string or null");
+    }
+  },
+  {
+    id: "send.deliversBytes",
+    title: "a message is delivered byte for byte: accents, an emoji, a text part",
+    async run(context) {
+      await context.mailer.send(sampleMessage);
+      const delivered = await context.delivered();
+      check(delivered.length === 1, `expected 1 delivered message, got ${delivered.length}`);
+      const [mail] = delivered;
+      check(mail?.subject === sampleMessage.subject, "the subject was not delivered as sent");
+      check(mail?.html === sampleMessage.html, "the html part was not delivered as sent");
+      check(mail?.text === sampleMessage.text, "the text part was not delivered as sent");
+    }
+  },
+  {
+    id: "send.recipients",
+    title: "every recipient is delivered to, written as a string or with a name",
+    async run(context) {
+      await context.mailer.send({
+        ...sampleMessage,
+        to: [
+          "ada@example.test",
+          { name: "Grace Hopper", address: "grace@example.test" }
+        ]
+      });
+      const [mail] = await context.delivered();
+      check(same(mail?.to, ["ada@example.test", "grace@example.test"]), "the recipients delivered are not the recipients sent");
+    }
+  },
+  {
+    id: "send.hostileName",
+    title: "a name holding an address and a comma reaches only its own address",
+    async run(context) {
+      await context.mailer.send({
+        ...sampleMessage,
+        to: {
+          name: 'Ada <mallory@example.test>, "Eve" <eve@example.test>;',
+          address: "ada@example.test"
+        }
+      });
+      const [mail] = await context.delivered();
+      check(same(mail?.to, ["ada@example.test"]), "a name let a second recipient through");
+    }
+  },
+  {
+    id: "send.refusesNoRecipient",
+    title: "a message with no recipient is refused with MailRefused, and nothing is sent",
+    async run(context) {
+      const error = await rejection(context.mailer.send({ ...sampleMessage, to: [] }), "a send with no recipient");
+      check(error instanceof MailRefused2, "a send with no recipient must throw MailRefused");
+      await nothingDelivered(context, "the message was refused");
+    }
+  },
+  {
+    id: "send.refusesLineBreakInSubject",
+    title: "a line break in the subject is refused with MailRefused: it is a header injection",
+    async run(context) {
+      const error = await rejection(context.mailer.send({
+        ...sampleMessage,
+        subject: `Hello\r
+Bcc: eve@example.test`
+      }), "a send with a line break in the subject");
+      check(error instanceof MailRefused2, "a line break in the subject must throw MailRefused");
+      await nothingDelivered(context, "the message was refused");
+    }
+  },
+  {
+    id: "send.refusesAddressHeader",
+    title: "a Bcc among the custom headers is refused with MailRefused: it would add an unchecked recipient",
+    async run(context) {
+      const error = await rejection(context.mailer.send({
+        ...sampleMessage,
+        headers: { Bcc: "eve@example.test" }
+      }), "a send with a Bcc header");
+      check(error instanceof MailRefused2, "a Bcc header must throw MailRefused");
+      check(!error.message.includes("eve@example.test"), "the refusal message holds the refused value");
+      await nothingDelivered(context, "the message was refused");
+    }
+  },
+  {
+    id: "send.refusesWithoutTheValue",
+    title: "a refusal names where the problem is, never the value",
+    async run({ mailer }) {
+      const error = await rejection(mailer.send({ ...sampleMessage, to: "not-an-address-7f3a" }), "a send to something that is not an address");
+      check(error instanceof MailRefused2, "a malformed address must throw MailRefused");
+      check(!error.message.includes("not-an-address-7f3a"), "the refusal message holds the refused value");
+    }
+  }
+];
+
+// src/conformance/cases/index.ts
+var allMailerCases = [
+  ...sendCases,
+  ...failureCases
+];
+// src/conformance/describe.ts
+var MAILER_SKIP_REASONS = {
+  faults: "faults not provided: the failure contract is not proven for this transport"
+};
+async function runMailerCase(mailerCase, harness) {
+  const opened = await harness.open();
+  let outcome;
+  try {
+    if (mailerCase.needs === "faults" && opened.faults === undefined) {
+      outcome = { skipped: MAILER_SKIP_REASONS.faults };
+    } else {
+      await mailerCase.run({
+        mailer: opened.mailer,
+        delivered: () => opened.delivered(),
+        faults: opened.faults ?? null
+      });
+      outcome = { passed: true };
+    }
+  } catch (error) {
+    await opened.close?.().then(() => {
+      return;
+    }, () => {
+      return;
+    });
+    throw error;
+  }
+  await opened.close?.();
+  return outcome;
+}
+function globalRunner() {
+  const { describe, it } = globalThis;
+  if (typeof describe !== "function" || typeof it !== "function") {
+    throw new TypeError("describeMailer: no test runner found — pass runner: { describe, it } from your test framework");
+  }
+  return { describe, it };
+}
+function describeMailer(options) {
+  const runner = options.runner ?? globalRunner();
+  const skip = options.skip ?? {};
+  for (const id of Object.keys(skip)) {
+    if (!allMailerCases.some((c) => c.id === id)) {
+      throw new TypeError(`describeMailer: skip names no case: ${id}`);
+    }
+  }
+  runner.describe(`${options.name} — @nxgt/mail conformance`, () => {
+    for (const mailerCase of allMailerCases) {
+      const title = `${mailerCase.id}: ${mailerCase.title}`;
+      const reason = skip[mailerCase.id] ?? (mailerCase.needs === "faults" && options.faults === false ? MAILER_SKIP_REASONS.faults : undefined);
+      if (reason !== undefined) {
+        runner.it.skip(`${title} (skipped: ${reason})`, async () => {});
+        continue;
+      }
+      runner.it(title, async () => {
+        const result = await runMailerCase(mailerCase, options.harness);
+        if ("skipped" in result) {
+          throw new Error(`conformance: ${mailerCase.id}: ${result.skipped} — pass faults: false to describeMailer to skip it on purpose`);
+        }
+      });
+    }
+  });
+}
+// src/conformance/reference.ts
+function referenceMailerHarness() {
+  return {
+    async open() {
+      const mailer = createMemoryMailer2();
+      return {
+        mailer,
+        async delivered() {
+          return mailer.sent.map((mail) => ({
+            to: recipientsOf2(mail),
+            subject: mail.subject,
+            html: mail.html,
+            text: mail.text
+          }));
+        },
+        faults: {
+          async failNext(kind) {
+            const cause = new Error(`simulated ${kind}`);
+            mailer.failNext(kind === "outage" ? new MailFailure2("send: the transport could not be reached", {
+              cause
+            }) : new MailRefused2("send: the transport refused the message", {
+              cause
+            }));
+          },
+          async attempts() {
+            return mailer.attempts;
+          }
+        }
+      };
+    }
+  };
+}
+export {
+  MAILER_SKIP_REASONS,
+  allMailerCases,
+  describeMailer,
+  failureCases,
+  referenceMailerHarness,
+  runMailerCase,
+  sampleMessage,
+  sendCases
+};
+
+//# debugId=761673AB21F5667764756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/conformance/index.js.map

@@ -0,0 +1,16 @@
+{
+  "version": 3,
+  "sources": ["../src/conformance/assert.ts", "../src/conformance/sample.ts", "../src/conformance/cases/failure.ts", "../src/conformance/cases/send.ts", "../src/conformance/cases/index.ts", "../src/conformance/describe.ts", "../src/conformance/reference.ts"],
+  "sourcesContent": [
+    "import type { MailerCaseContext } from './types';\n\n/** Throws when `condition` is false. The suite depends on no assertion library. */\nexport function check(condition: boolean, what: string): asserts condition {\n\tif (!condition) throw new Error(`conformance: ${what}`);\n}\n\nexport const same = (a: unknown, b: unknown) =>\n\tJSON.stringify(a) === JSON.stringify(b);\n\n/**\n * Settles an expected rejection where it is created, and answers the error —\n * or throws when the promise resolved.\n */\nexport async function rejection(\n\tpromise: Promise<unknown>,\n\twhat: string,\n): Promise<unknown> {\n\treturn promise.then(\n\t\t() => {\n\t\t\tthrow new Error(`conformance: ${what} resolved; it must reject`);\n\t\t},\n\t\t(error: unknown) => error,\n\t);\n}\n\n/** Throws when the receiving end got anything. */\nexport async function nothingDelivered(\n\tcontext: MailerCaseContext,\n\twhat: string,\n) {\n\tcheck(\n\t\t(await context.delivered()).length === 0,\n\t\t`${what}, yet something was delivered`,\n\t);\n}\n",
+    "import type { MailMessage } from '../types';\n\n/** A message with the characters a transport most often mangles. */\nexport const sampleMessage: MailMessage = {\n\tto: 'ada@example.test',\n\tfrom: 'noreply@example.test',\n\tsubject: 'Réinitialisez votre mot de passe — ça expire à 23 h',\n\thtml: '<p>Bonjour Ada 👋, <a href=\"https://example.test/r?t=abc&amp;x=1\">réinitialiser</a></p>',\n\ttext: 'Bonjour Ada 👋,\\n\\nréinitialiser : https://example.test/r?t=abc&x=1\\n',\n};\n",
+    "import { MailError, MailFailure, MailRefused } from '../../errors';\nimport { check, nothingDelivered, rejection } from '../assert';\nimport { sampleMessage } from '../sample';\nimport type { MailerCase } from '../types';\n\n/** What a send must do when the transport fails. Needs {@link MailerFaults}. */\nexport const failureCases: readonly MailerCase[] = [\n\t{\n\t\tid: 'failure.outage',\n\t\ttitle:\n\t\t\t'an outage throws MailFailure with the cause, and nothing is retried',\n\t\tneeds: 'faults',\n\t\tasync run(context) {\n\t\t\tconst faults = context.faults;\n\t\t\tcheck(faults !== null, 'faults are required');\n\t\t\tawait faults.failNext('outage');\n\t\t\tconst error = await rejection(\n\t\t\t\tcontext.mailer.send(sampleMessage),\n\t\t\t\t'a send during an outage',\n\t\t\t);\n\t\t\t// The class is the one imported from @nxgt/mail: a transport that\n\t\t\t// defines its own copy fails here.\n\t\t\tcheck(\n\t\t\t\terror instanceof MailFailure,\n\t\t\t\t'an outage must throw MailFailure from @nxgt/mail',\n\t\t\t);\n\t\t\tcheck(error instanceof MailError, 'MailFailure must extend MailError');\n\t\t\tcheck(\n\t\t\t\terror.code === 'MAIL_FAILED',\n\t\t\t\t'an outage must carry the code MAIL_FAILED',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror.cause !== undefined,\n\t\t\t\t\"an outage must carry the transport's error as cause\",\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\t(await faults.attempts()) === 1,\n\t\t\t\t'the transport retried a failed hand-over',\n\t\t\t);\n\t\t\tawait nothingDelivered(context, 'the hand-over failed');\n\t\t},\n\t},\n\t{\n\t\tid: 'failure.refusal',\n\t\ttitle: 'a message the provider refuses throws MailRefused with the cause',\n\t\tneeds: 'faults',\n\t\tasync run(context) {\n\t\t\tconst faults = context.faults;\n\t\t\tcheck(faults !== null, 'faults are required');\n\t\t\tawait faults.failNext('refusal');\n\t\t\tconst error = await rejection(\n\t\t\t\tcontext.mailer.send(sampleMessage),\n\t\t\t\t'a refused send',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror instanceof MailRefused,\n\t\t\t\t'a refusal must throw MailRefused from @nxgt/mail',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror.code === 'MAIL_REFUSED',\n\t\t\t\t'a refusal must carry the code MAIL_REFUSED',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror.cause !== undefined,\n\t\t\t\t\"a refusal must carry the transport's error as cause\",\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\t(await faults.attempts()) === 1,\n\t\t\t\t'the transport retried a refused message',\n\t\t\t);\n\t\t},\n\t},\n\t{\n\t\tid: 'failure.recovers',\n\t\ttitle: 'after a failure, the next send goes through',\n\t\tneeds: 'faults',\n\t\tasync run(context) {\n\t\t\tconst faults = context.faults;\n\t\t\tcheck(faults !== null, 'faults are required');\n\t\t\tawait faults.failNext('outage');\n\t\t\tawait rejection(\n\t\t\t\tcontext.mailer.send(sampleMessage),\n\t\t\t\t'a send during an outage',\n\t\t\t);\n\t\t\tawait context.mailer.send(sampleMessage);\n\t\t\tcheck(\n\t\t\t\t(await context.delivered()).length === 1,\n\t\t\t\t'the send after a failure was not delivered',\n\t\t\t);\n\t\t},\n\t},\n];\n",
+    "import { MailRefused } from '../../errors';\nimport { check, nothingDelivered, rejection, same } from '../assert';\nimport { sampleMessage } from '../sample';\nimport type { MailerCase } from '../types';\n\n/** What every send must do, with no fault injected. */\nexport const sendCases: readonly MailerCase[] = [\n\t{\n\t\tid: 'send.answersSentMail',\n\t\ttitle: 'a send answers SentMail, with a string id or null',\n\t\tasync run({ mailer }) {\n\t\t\tconst sent = await mailer.send(sampleMessage);\n\t\t\tcheck(\n\t\t\t\ttypeof sent === 'object' && sent !== null && 'messageId' in sent,\n\t\t\t\t'send did not answer an object with messageId',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\tsent.messageId === null ||\n\t\t\t\t\t(typeof sent.messageId === 'string' && sent.messageId !== ''),\n\t\t\t\t'messageId must be a non-empty string or null',\n\t\t\t);\n\t\t},\n\t},\n\t{\n\t\tid: 'send.deliversBytes',\n\t\ttitle:\n\t\t\t'a message is delivered byte for byte: accents, an emoji, a text part',\n\t\tasync run(context) {\n\t\t\tawait context.mailer.send(sampleMessage);\n\t\t\tconst delivered = await context.delivered();\n\t\t\tcheck(\n\t\t\t\tdelivered.length === 1,\n\t\t\t\t`expected 1 delivered message, got ${delivered.length}`,\n\t\t\t);\n\t\t\tconst [mail] = delivered;\n\t\t\tcheck(\n\t\t\t\tmail?.subject === sampleMessage.subject,\n\t\t\t\t'the subject was not delivered as sent',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\tmail?.html === sampleMessage.html,\n\t\t\t\t'the html part was not delivered as sent',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\tmail?.text === sampleMessage.text,\n\t\t\t\t'the text part was not delivered as sent',\n\t\t\t);\n\t\t},\n\t},\n\t{\n\t\tid: 'send.recipients',\n\t\ttitle:\n\t\t\t'every recipient is delivered to, written as a string or with a name',\n\t\tasync run(context) {\n\t\t\tawait context.mailer.send({\n\t\t\t\t...sampleMessage,\n\t\t\t\tto: [\n\t\t\t\t\t'ada@example.test',\n\t\t\t\t\t{ name: 'Grace Hopper', address: 'grace@example.test' },\n\t\t\t\t],\n\t\t\t});\n\t\t\tconst [mail] = await context.delivered();\n\t\t\tcheck(\n\t\t\t\tsame(mail?.to, ['ada@example.test', 'grace@example.test']),\n\t\t\t\t'the recipients delivered are not the recipients sent',\n\t\t\t);\n\t\t},\n\t},\n\t{\n\t\tid: 'send.hostileName',\n\t\ttitle: 'a name holding an address and a comma reaches only its own address',\n\t\tasync run(context) {\n\t\t\t// A name is free text, and quoting it is the transport's job. One that\n\t\t\t// pastes it into a header unquoted hands mallory a copy.\n\t\t\tawait context.mailer.send({\n\t\t\t\t...sampleMessage,\n\t\t\t\tto: {\n\t\t\t\t\tname: 'Ada <mallory@example.test>, \"Eve\" <eve@example.test>;',\n\t\t\t\t\taddress: 'ada@example.test',\n\t\t\t\t},\n\t\t\t});\n\t\t\tconst [mail] = await context.delivered();\n\t\t\tcheck(\n\t\t\t\tsame(mail?.to, ['ada@example.test']),\n\t\t\t\t'a name let a second recipient through',\n\t\t\t);\n\t\t},\n\t},\n\t{\n\t\tid: 'send.refusesNoRecipient',\n\t\ttitle:\n\t\t\t'a message with no recipient is refused with MailRefused, and nothing is sent',\n\t\tasync run(context) {\n\t\t\tconst error = await rejection(\n\t\t\t\tcontext.mailer.send({ ...sampleMessage, to: [] }),\n\t\t\t\t'a send with no recipient',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror instanceof MailRefused,\n\t\t\t\t'a send with no recipient must throw MailRefused',\n\t\t\t);\n\t\t\tawait nothingDelivered(context, 'the message was refused');\n\t\t},\n\t},\n\t{\n\t\tid: 'send.refusesLineBreakInSubject',\n\t\ttitle:\n\t\t\t'a line break in the subject is refused with MailRefused: it is a header injection',\n\t\tasync run(context) {\n\t\t\tconst error = await rejection(\n\t\t\t\tcontext.mailer.send({\n\t\t\t\t\t...sampleMessage,\n\t\t\t\t\tsubject: 'Hello\\r\\nBcc: eve@example.test',\n\t\t\t\t}),\n\t\t\t\t'a send with a line break in the subject',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror instanceof MailRefused,\n\t\t\t\t'a line break in the subject must throw MailRefused',\n\t\t\t);\n\t\t\tawait nothingDelivered(context, 'the message was refused');\n\t\t},\n\t},\n\t{\n\t\tid: 'send.refusesAddressHeader',\n\t\ttitle:\n\t\t\t'a Bcc among the custom headers is refused with MailRefused: it would add an unchecked recipient',\n\t\tasync run(context) {\n\t\t\t// A custom header named Bcc, To or Cc reaches the envelope of an SMTP\n\t\t\t// transport, and writes a line no address check ever saw.\n\t\t\tconst error = await rejection(\n\t\t\t\tcontext.mailer.send({\n\t\t\t\t\t...sampleMessage,\n\t\t\t\t\t// biome-ignore lint/style/useNamingConvention: a header's name, as a mail client writes it.\n\t\t\t\t\theaders: { Bcc: 'eve@example.test' },\n\t\t\t\t}),\n\t\t\t\t'a send with a Bcc header',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror instanceof MailRefused,\n\t\t\t\t'a Bcc header must throw MailRefused',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\t!error.message.includes('eve@example.test'),\n\t\t\t\t'the refusal message holds the refused value',\n\t\t\t);\n\t\t\tawait nothingDelivered(context, 'the message was refused');\n\t\t},\n\t},\n\t{\n\t\tid: 'send.refusesWithoutTheValue',\n\t\ttitle: 'a refusal names where the problem is, never the value',\n\t\tasync run({ mailer }) {\n\t\t\tconst error = await rejection(\n\t\t\t\tmailer.send({ ...sampleMessage, to: 'not-an-address-7f3a' }),\n\t\t\t\t'a send to something that is not an address',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\terror instanceof MailRefused,\n\t\t\t\t'a malformed address must throw MailRefused',\n\t\t\t);\n\t\t\tcheck(\n\t\t\t\t!error.message.includes('not-an-address-7f3a'),\n\t\t\t\t'the refusal message holds the refused value',\n\t\t\t);\n\t\t},\n\t},\n];\n",
+    "import type { MailerCase } from '../types';\nimport { failureCases } from './failure';\nimport { sendCases } from './send';\n\nexport { failureCases } from './failure';\nexport { sendCases } from './send';\n\n/** Every case, in the order they are described. */\nexport const allMailerCases: readonly MailerCase[] = [\n\t...sendCases,\n\t...failureCases,\n];\n",
+    "import { allMailerCases } from './cases/index';\nimport type { MailerCase, MailerHarness, MailerRunner } from './types';\n\n/** Why a case did not run. A skip is always reported with its reason, never silent. */\nexport const MAILER_SKIP_REASONS = {\n\tfaults:\n\t\t'faults not provided: the failure contract is not proven for this transport',\n} as const;\n\n/**\n * Runs one case against a freshly opened transport, and closes it, pass or\n * fail. Answers the reason when the case cannot run on this harness.\n */\nexport async function runMailerCase(\n\tmailerCase: MailerCase,\n\tharness: MailerHarness,\n): Promise<{ readonly skipped: string } | { readonly passed: true }> {\n\tconst opened = await harness.open();\n\tlet outcome: { readonly skipped: string } | { readonly passed: true };\n\ttry {\n\t\tif (mailerCase.needs === 'faults' && opened.faults === undefined) {\n\t\t\toutcome = { skipped: MAILER_SKIP_REASONS.faults };\n\t\t} else {\n\t\t\tawait mailerCase.run({\n\t\t\t\tmailer: opened.mailer,\n\t\t\t\tdelivered: () => opened.delivered(),\n\t\t\t\tfaults: opened.faults ?? null,\n\t\t\t});\n\t\t\toutcome = { passed: true };\n\t\t}\n\t} catch (error) {\n\t\t// The case's failure is what the author needs to read: a close that\n\t\t// fails too must not replace it.\n\t\tawait opened.close?.().then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t);\n\t\tthrow error;\n\t}\n\tawait opened.close?.();\n\treturn outcome;\n}\n\nfunction globalRunner(): MailerRunner {\n\tconst { describe, it } = globalThis as unknown as Partial<MailerRunner>;\n\tif (typeof describe !== 'function' || typeof it !== 'function') {\n\t\tthrow new TypeError(\n\t\t\t'describeMailer: no test runner found — pass runner: { describe, it } from your test framework',\n\t\t);\n\t}\n\treturn { describe, it };\n}\n\n/**\n * Describes every case against one transport, under bun:test, vitest or jest.\n *\n * ```ts\n * import { describe, it } from 'bun:test';\n * import { describeMailer } from '@nxgt/mail/conformance';\n *\n * describeMailer({ name: 'my transport', harness, runner: { describe, it } });\n * ```\n *\n * `runner` defaults to the global `describe` and `it`, when the framework\n * defines them.\n */\nexport function describeMailer(options: {\n\treadonly name: string;\n\treadonly harness: MailerHarness;\n\treadonly runner?: MailerRunner;\n\t/** Case ids to skip, each with the reason — reported, never silent. */\n\treadonly skip?: Readonly<Record<string, string>>;\n\t/** Declared up front, so a missing `faults` is reported before the first case runs. */\n\treadonly faults?: boolean;\n}): void {\n\tconst runner = options.runner ?? globalRunner();\n\tconst skip = options.skip ?? {};\n\tfor (const id of Object.keys(skip)) {\n\t\tif (!allMailerCases.some((c) => c.id === id)) {\n\t\t\tthrow new TypeError(`describeMailer: skip names no case: ${id}`);\n\t\t}\n\t}\n\n\trunner.describe(`${options.name} — @nxgt/mail conformance`, () => {\n\t\tfor (const mailerCase of allMailerCases) {\n\t\t\tconst title = `${mailerCase.id}: ${mailerCase.title}`;\n\t\t\tconst reason =\n\t\t\t\tskip[mailerCase.id] ??\n\t\t\t\t(mailerCase.needs === 'faults' && options.faults === false\n\t\t\t\t\t? MAILER_SKIP_REASONS.faults\n\t\t\t\t\t: undefined);\n\t\t\tif (reason !== undefined) {\n\t\t\t\trunner.it.skip(`${title} (skipped: ${reason})`, async () => {});\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\trunner.it(title, async () => {\n\t\t\t\tconst result = await runMailerCase(mailerCase, options.harness);\n\t\t\t\tif ('skipped' in result) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`conformance: ${mailerCase.id}: ${result.skipped} — pass faults: false to describeMailer to skip it on purpose`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t});\n}\n",
+    "import { MailFailure, MailRefused } from '../errors';\nimport { createMemoryMailer } from '../memory';\nimport { recipientsOf } from '../message';\nimport type { MailerHarness } from './types';\n\n/**\n * The harness of the memory mailer, the transport the suite is proven\n * against. Also a working example of a harness.\n */\nexport function referenceMailerHarness(): MailerHarness {\n\treturn {\n\t\tasync open() {\n\t\t\tconst mailer = createMemoryMailer();\n\t\t\treturn {\n\t\t\t\tmailer,\n\t\t\t\tasync delivered() {\n\t\t\t\t\treturn mailer.sent.map((mail) => ({\n\t\t\t\t\t\tto: recipientsOf(mail),\n\t\t\t\t\t\tsubject: mail.subject,\n\t\t\t\t\t\thtml: mail.html,\n\t\t\t\t\t\ttext: mail.text,\n\t\t\t\t\t}));\n\t\t\t\t},\n\t\t\t\tfaults: {\n\t\t\t\t\tasync failNext(kind) {\n\t\t\t\t\t\tconst cause = new Error(`simulated ${kind}`);\n\t\t\t\t\t\tmailer.failNext(\n\t\t\t\t\t\t\tkind === 'outage'\n\t\t\t\t\t\t\t\t? new MailFailure('send: the transport could not be reached', {\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t\t: new MailRefused('send: the transport refused the message', {\n\t\t\t\t\t\t\t\t\t\tcause,\n\t\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t);\n\t\t\t\t\t},\n\t\t\t\t\tasync attempts() {\n\t\t\t\t\t\treturn mailer.attempts;\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "761673AB21F5667764756E2164756E21",
+  "names": []
+}

package/dist/conformance/reference.d.ts

@@ -0,0 +1,7 @@
+import type { MailerHarness } from './types';
+/**
+ * The harness of the memory mailer, the transport the suite is proven
+ * against. Also a working example of a harness.
+ */
+export declare function referenceMailerHarness(): MailerHarness;
+//# sourceMappingURL=reference.d.ts.map

package/dist/conformance/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/conformance/reference.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,aAAa,CAkCtD"}

package/dist/conformance/sample.d.ts

@@ -0,0 +1,4 @@
+import type { MailMessage } from '../types';
+/** A message with the characters a transport most often mangles. */
+export declare const sampleMessage: MailMessage;
+//# sourceMappingURL=sample.d.ts.map

package/dist/conformance/sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/conformance/sample.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,oEAAoE;AACpE,eAAO,MAAM,aAAa,EAAE,WAM3B,CAAC"}

package/dist/conformance/types.d.ts

@@ -0,0 +1,74 @@
+import type { Mailer } from '../types';
+/**
+ * What the receiving end got, as the harness reads it back: from the test
+ * SMTP server, from the recorded HTTP request, from the memory outbox.
+ */
+export interface DeliveredMail {
+    /** The bare addresses of every recipient, in order. */
+    readonly to: readonly string[];
+    readonly subject: string;
+    readonly html: string;
+    readonly text: string;
+}
+/**
+ * How the suite makes a transport fail **the way its provider fails**: a
+ * refused connection or a 5xx for an outage, a 4xx "malformed message" for a
+ * refusal. Not a decorator that throws in front of the transport — that would
+ * prove the decorator, and not the transport's translation.
+ *
+ * Optional, and **its absence is reported, never passed over**: without it,
+ * the failure cases are skipped with a reason in their name.
+ */
+export interface MailerFaults {
+    /** Makes the next hand-over fail as an outage, or as a refusal of the message. */
+    failNext(kind: 'outage' | 'refusal'): Promise<void>;
+    /**
+     * How many hand-overs the receiving end saw, failed ones included. This is
+     * what proves a transport does not retry in secret.
+     */
+    attempts(): Promise<number>;
+}
+/** One transport, opened for one case. */
+export interface OpenedMailer {
+    readonly mailer: Mailer;
+    /** Every message the receiving end accepted, oldest first. */
+    delivered(): Promise<readonly DeliveredMail[]>;
+    readonly faults?: MailerFaults;
+    /** Called after the case, pass or fail. */
+    close?(): Promise<void>;
+}
+/**
+ * Opens a **fresh** transport and receiving end — once per case, so no case
+ * sees another's messages.
+ */
+export interface MailerHarness {
+    open(): Promise<OpenedMailer>;
+}
+/** What a case runs against. */
+export interface MailerCaseContext {
+    readonly mailer: Mailer;
+    delivered(): Promise<readonly DeliveredMail[]>;
+    readonly faults: MailerFaults | null;
+}
+/**
+ * One conformance case, as **data**: `run` throws on failure and resolves on
+ * success, so it runs under any test runner, or none.
+ */
+export interface MailerCase {
+    /** Unique, stable: `send.deliversBytes`, `failure.outage`. */
+    readonly id: string;
+    /** What the case proves, as a sentence. */
+    readonly title: string;
+    /** `'faults'` when the case can only run with {@link MailerFaults}. */
+    readonly needs?: 'faults';
+    run(context: MailerCaseContext): Promise<void>;
+}
+/** The two functions of a test runner the suite needs: bun:test, vitest and jest all have them. */
+export interface MailerRunner {
+    describe(name: string, body: () => void): void;
+    it: {
+        (name: string, body: () => Promise<void>): void;
+        skip(name: string, body: () => Promise<void>): void;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/conformance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/conformance/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,SAAS,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,2CAA2C;IAC3C,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9B;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/C,EAAE,EAAE;QACH,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACpD,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * What a transport refuses, as a string a caller can switch on.
+ *
+ * Every code is a **refusal at call time**. A refusal that can only come from
+ * how the application was wired — a bad option passed to a factory — is a
+ * bare `TypeError` instead: no handler should ever answer one.
+ *
+ * The codes are `SCREAMING_SNAKE` because they are data values, not API
+ * identifiers. Every key in this package is `camelCase`.
+ */
+export type MailErrorCode = 
+/**
+ * The transport could not hand the message over: a refused connection, a
+ * timeout, a 5xx from the provider, an expired credential. The transport's
+ * own error is the `cause`.
+ *
+ * **Nothing is known to have been sent** — after a timeout or a dropped
+ * connection, the provider may have taken it all the same. Retry later,
+ * or tell the user it failed. Never report it as sent.
+ */
+'MAIL_FAILED'
+/**
+ * The message itself was refused, before or by the transport: no
+ * recipient, something that is not an address, a line break in the
+ * subject or a header, a provider answering that the message is
+ * malformed, or — from `@nxgt/mail/renderer` — a URL variable that is not
+ * an `http:`, `https:` or `mailto:` URL. Sending it again unchanged fails
+ * again.
+ */
+ | 'MAIL_REFUSED';
+/** Options every error of this package accepts. */
+export interface MailErrorOptions {
+    /** The error that caused this one, typically the transport's. */
+    readonly cause?: unknown;
+}
+/**
+ * The base class of every error this package throws at call time. It is
+ * abstract: a transport throws {@link MailFailure} or {@link MailRefused}.
+ *
+ * **There is exactly one definition of this class.** A transport defines no
+ * error class of its own and throws these, imported from its `@nxgt/mail`
+ * peer, so `error instanceof MailFailure` holds whatever transport threw it.
+ *
+ * A message reports **a shape, never a value**: never a recipient address,
+ * never a subject, never a link — the link in a verification e-mail is a
+ * credential.
+ */
+export declare abstract class MailError extends Error {
+    name: string;
+    /**
+     * Abstract, so a transport cannot throw a bare `MailError` that passes a
+     * `code` check and fails `instanceof MailFailure`: it throws one of the two
+     * subclasses.
+     */
+    abstract readonly code: MailErrorCode;
+    constructor(message: string, options?: MailErrorOptions);
+}
+/** The transport could not hand the message over. Code `MAIL_FAILED`. */
+export declare class MailFailure extends MailError {
+    name: string;
+    readonly code: "MAIL_FAILED";
+}
+/** The message was refused as malformed. Code `MAIL_REFUSED`. */
+export declare class MailRefused extends MailError {
+    name: string;
+    readonly code: "MAIL_REFUSED";
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa;AACxB;;;;;;;;GAQG;AACD,aAAa;AACf;;;;;;;GAOG;GACD,cAAc,CAAC;AAElB,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,SAAU,SAAQ,KAAK;IACnC,IAAI,SAAe;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;gBAE1B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;CAGvD;AAED,yEAAyE;AACzE,qBAAa,WAAY,SAAQ,SAAS;IAChC,IAAI,SAAiB;IAC9B,SAAkB,IAAI,EAAG,aAAa,CAAU;CAChD;AAED,iEAAiE;AACjE,qBAAa,WAAY,SAAQ,SAAS;IAChC,IAAI,SAAiB;IAC9B,SAAkB,IAAI,EAAG,cAAc,CAAU;CACjD"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `@nxgt/mail` — the run-time side of transactional e-mail: the `Mailer` port
+ * a transport implements, the shapes it sends, the errors it throws, a memory
+ * transport for tests, and locale selection. No dependency, and no Node
+ * built-in: it runs anywhere. The renderer that fills a build of
+ * `@nxgt/mail-i18n` is `@nxgt/mail/renderer`, which reads files.
+ *
+ * ## The one rule this package is built around
+ *
+ * **A failure throws.** A transport that could not hand a message over rejects
+ * with `MailFailure`; it never answers `false` and never logs and resolves. A
+ * caller that maps a failed send to "sent" has told a user to check an inbox
+ * that will stay empty. `@nxgt/mail/conformance` fails a transport that breaks
+ * it.
+ */
+export { MailError, type MailErrorCode, type MailErrorOptions, MailFailure, MailRefused, } from './errors';
+export { parseAcceptLanguage, pickLocale, type WantedLocales } from './locale';
+export { createMemoryMailer, type MemoryMail, type MemoryMailer, } from './memory';
+export { addressOf, checkMessage, recipientsOf } from './message';
+export type { Address, Mailer, MailMessage, Rendered, SentMail } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACN,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,WAAW,EACX,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EACN,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAClE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}