@nxgt/janus-mail 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steve Tsala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,262 @@
+# @nxgt/janus-mail
+
+The e-mails of [`@nxgt/janus`](https://www.npmjs.com/package/@nxgt/janus)'s
+flows, ready to send: **e-mail verification, password reset, sign-in code,
+password changed and e-mail changed**, in English and French, with your brand
+in them. `@nxgt/janus` sends no e-mail — its flows answer what to send — and
+this package turns that answer into an e-mail and hands it to any
+[`@nxgt/mail`](https://www.npmjs.com/package/@nxgt/mail) transport.
+
+```ts
+import { createMemoryMailer } from '@nxgt/mail';
+import { janusMail } from '@nxgt/janus-mail';
+
+const mail = janusMail({
+	mailer: createMemoryMailer(), // in production, a transport: @nxgt/mail-smtp, @nxgt/mail-resend…
+	from: 'noreply@acme.example',
+	brand: 'Acme',
+	links: {
+		verifyEmail: (token) => `https://acme.example/verify?token=${token}`,
+		resetPassword: (token) => `https://acme.example/reset?token=${token}`,
+		secureAccount: () => 'https://acme.example/account/security',
+	},
+});
+
+await mail.verifyEmail(await auth.verifyEmail.send(user), { name: user.name, locale: user.locale });
+```
+
+The e-mails are built with [Maizzle](https://maizzle.com) when **this
+package** is built — from
+[`@nxgt/mail-presets`](https://www.npmjs.com/package/@nxgt/mail-presets),
+CSS inlined for mail clients — and shipped as HTML and text. At send time
+they are only filled in: your brand, the recipient's name, your links, every
+value escaped. No template engine and no Maizzle run in your server.
+
+> **0.x.** A minor version may still change the surface; the changelog says how.
+
+## Install
+
+```sh
+bun add @nxgt/janus-mail @nxgt/mail @nxgt/janus
+bun add -d typescript
+```
+
+Three peers, all required: `@nxgt/mail` (0.1 or later, below 1 — the
+transports of 0.4 included), which defines the `Mailer` port and the errors;
+`@nxgt/janus` (0.8), whose flows' answers the methods take — types only,
+nothing of it is loaded; and `typescript` (6). **No Maizzle, no Vue, no
+Tailwind**: they run at this package's build, not in yours.
+
+It reads its prebuilt e-mails with `node:fs`: **Node, Bun or Deno**, not an edge
+runtime. Like `@nxgt/janus`, it expects `"moduleResolution": "bundler"`.
+
+## API
+
+| Export | What it is |
+| --- | --- |
+| `janusMail(options)` | The e-mails, over your mailer: `verifyEmail`, `resetPassword`, `signInCode`, `passwordChanged`, `emailChanged`, and `templates` and `locales`. Options: `mailer`, `from`, `replyTo?`, `brand`, `links` (`verifyEmail`, `resetPassword`, `secureAccount`), `locales?`, `fallbackLocale?`, `templates?`. A wrong option is a bare `TypeError`, thrown here |
+| `janusTemplates()` | The five default templates alone, each `(variables & { locale }) => Rendered` |
+| `JanusMail<L>`, `JanusMailOptions<L>` | What `janusMail()` answers and takes, for the locales `L` |
+| `JanusMailTemplate<V, L>`, `JanusMailTemplates<L>`, `JanusMailTemplateName` | One template, the five of them, and their names |
+| `JanusMailVariables` | What each template is given: `brand`, and `name`, `link`, `code` or `newEmail` as its e-mail needs |
+| `JanusMailLocale` | `'en' \| 'fr'`: the locales the defaults are built in |
+| `JanusMailLinks`, `Recipient` | The `links` option; who an e-mail is for — `{ name, locale? }` |
+
+Each method answers the mailer's `SentMail` and **rejects with the mailer's
+`MailFailure` or `MailRefused`, untouched**: this package defines no error
+class.
+
+| Method | Sends | To |
+| --- | --- | --- |
+| `verifyEmail(issued, to)` | `issued` from `auth.verifyEmail.send(user)`; a link from `links.verifyEmail(issued.token)` | `issued.email` |
+| `resetPassword(issued, to)` | `issued` from `auth.resetPassword.request(email)`, checked for `null`; a link from `links.resetPassword(issued.token)` | `issued.email` |
+| `signInCode(issued, to?)` | `issued.code` from `auth.signInCode.request(email)` — **never the challenge** | `issued.email` |
+| `passwordChanged(to)` | A notice, with `links.secureAccount()` | `to.email` |
+| `emailChanged(to)` | A notice naming `to.newEmail`, with `links.secureAccount()` | `to.formerEmail` |
+
+## Usage
+
+The examples use `mail` from above, and an `auth` whose user schema has a
+`name` and a `locale` beside its `email` — fields of yours, not `janus`'s: pass
+whatever your users carry.
+
+### Verifying an e-mail
+
+```ts
+const issued = await auth.verifyEmail.send(user); // { token, email, expiresAt }
+await mail.verifyEmail(issued, { name: user.name, locale: user.locale });
+```
+
+### Resetting a password
+
+```ts
+const issued = await auth.resetPassword.request(email);
+if (issued !== null) {
+	await mail.resetPassword(issued, { name: issued.user.name, locale: issued.user.locale });
+}
+return new Response(null, { status: 202 }); // the same answer whether or not someone holds the address
+```
+
+### Signing in with a code
+
+```ts
+import { parseAcceptLanguage } from '@nxgt/mail';
+
+const issued = await auth.signInCode.request(email);
+if (issued !== null) {
+	const wanted = [issued.user.locale, ...parseAcceptLanguage(request.headers.get('accept-language'))];
+	await mail.signInCode(issued, { locale: wanted });
+	// issued.challenge stays with the visitor — a cookie or the form — never in the e-mail
+}
+```
+
+### Telling a user their password changed
+
+```ts
+const changed = await auth.changePassword(user, { current, next });
+await mail.passwordChanged({ name: changed.name, locale: changed.locale, email: changed.email });
+```
+
+### Telling a user their e-mail changed
+
+```ts
+const before = user.email;
+const updated = await auth.update(user, { email: next });
+await mail.emailChanged({ name: updated.name, locale: updated.locale, formerEmail: before, newEmail: updated.email });
+```
+
+### Replacing a template
+
+Any template can be your own function — React Email, a string, another
+build — and the defaults stay for the rest:
+
+```ts
+const mail = janusMail({
+	mailer, from: 'noreply@acme.example', brand: 'Acme', links,
+	templates: {
+		signInCode: ({ code, locale }) => ({
+			subject: locale === 'fr' ? `Votre code : ${code}` : `Your code: ${code}`,
+			html: `<p>${code}</p>`,
+			text: code,
+		}),
+	},
+});
+```
+
+A locale beyond `en` and `fr` takes **every** template: see
+[Templates](docs/guide/templates.md) and [Locales](docs/guide/locales.md).
+
+## Traps
+
+**Send to `issued.email`, which the methods do.** Never to what the visitor
+typed: the flow answers the address the user's record holds, as they
+registered it. `emailChanged` goes to `formerEmail` — the address a hijacker
+just took the account from.
+
+**Never fire and forget.** `void mail.signInCode(issued)` turns an outage
+into an unhandled rejection and a user waiting for an e-mail that never
+comes. `await` it, or hand it to a queue that retries — which is also how to
+send after answering, as the sign-in code guide advises.
+
+**`node:fs` means no edge runtime.** The default e-mails are read from the
+package's `mails/` folder, on the first one sent. On an edge runtime, pass
+every template yourself — or wait for the inlined build on the
+[roadmap](docs/roadmap.md).
+
+**Keep `@nxgt/janus-mail` out of your server bundle.** The default e-mails
+are found beside the code, at `new URL('../mails/', import.meta.url)`.
+Bundling the package into your own server file moves `import.meta.url` to
+your bundle, where there is no `mails/`, and the first e-mail sent throws
+`createMailRenderer: …/mails/mail-manifest.json cannot be read`. Mark it
+external — `external: ['@nxgt/janus-mail']` in esbuild or `Bun.build`,
+`ssr.external` in Vite — and deploy `node_modules/@nxgt/janus-mail/` whole,
+`mails/` included. See
+[troubleshooting](docs/troubleshooting.md#createmailrenderer-mailsmail-manifestjson-cannot-be-read--run-maizzle-build-and-deploy-its-output-folder).
+
+**A link answers a string, at once.** Each `links` function is called at
+send time and must return an `http(s)` or `mailto:` URL as a string: an
+`async` function or a `URL` object is a compile error, and in JavaScript a
+`TypeError` naming the call.
+`links`, `from` and `replyTo` are copied when `janusMail()` is called, so
+changing them afterwards changes nothing.
+
+**Templates are own properties.** A class's methods live on its prototype
+and are refused with a `TypeError`; its fields (`signInCode = (variables) =>
+…`) pass.
+
+**A locale beyond `en` and `fr` needs every template.** The defaults are
+built in those two only, so `locales: ['en', 'fr', 'de']` without all five
+templates is a compile error, and a `TypeError` in JavaScript.
+
+**The brand is text only.** `brand: 'Acme'` is written in the header, the
+body and the footer, escaped: no logo, no link, no markup. For those, replace
+the templates.
+
+**The default e-mails do not state the expiry.** `@nxgt/mail-presets`' bodies
+say nothing of how long a link or a code lasts. If yours must, replace the
+template: `issued.expiresAt` is yours to format.
+
+**A failed send is `MAIL_FAILED`; answer it as an outage.** In an HTTP
+handler, a `MailFailure` is a `503` — nothing is known to have been sent —
+and a `MailRefused` (a `javascript:` link, an address that is not one) is a
+bug to fix, never retried:
+
+```ts
+import { MailError } from '@nxgt/mail';
+
+try {
+	await mail.verifyEmail(await auth.verifyEmail.send(user), { name: user.name });
+} catch (error) {
+	if (error instanceof MailError && error.code === 'MAIL_FAILED') {
+		return Response.json({ code: error.code }, { status: 503 });
+	}
+	throw error;
+}
+```
+
+The symptoms and fixes are in [troubleshooting](docs/troubleshooting.md).
+
+## Documentation
+
+- [Guides](docs/README.md) — sending, templates, locales and how the e-mails are built
+- [Troubleshooting](docs/troubleshooting.md) — every message this package throws, and `MailRefused`
+- [Roadmap](docs/roadmap.md) — what is next, and what is not planned
+
+## Type safety, counted
+
+**Twenty plausible mistakes, twenty refused at compile time.**
+[`test/types/refusals.ts`](test/types/refusals.ts) holds one
+`@ts-expect-error` per mistake, beside the calls that must keep compiling —
+among them adding a language with every template:
+
+1. A sign-in code given to `verifyEmail`: it has no token.
+2. A one-time token given to `signInCode`: it has no code.
+3. `resetPassword.request`'s answer, not checked for `null` first.
+4. `verifyEmail` without the recipient.
+5. A recipient without a name.
+6. `passwordChanged` without the address to tell.
+7. `emailChanged` without the former address.
+8. A locale that is not a locale (a number).
+9. `links` without `secureAccount`.
+10. A link given as a URL rather than a function of the token.
+11. `brand` given as an object (`{ name: 'Acme' }`) rather than its name.
+12. A template that answers a string rather than `{ subject, html, text }`.
+13. A template that reads a variable its e-mail does not have.
+14. A template for an e-mail the package does not send.
+15. A `fallbackLocale` outside `locales`.
+16. A locale beyond `en` and `fr` with only some templates.
+17. A default template reused for a locale it is not built in.
+18. A template read from `mail.templates` that does not exist.
+19. A link computed asynchronously.
+20. A link answered as a `URL` object rather than its `href`.
+
+In JavaScript, 19 and 20 are a `TypeError` at send time instead, naming the
+call.
+
+[`test/types/variables.ts`](test/types/variables.ts) also holds
+`JanusMailVariables` equal to the variables of the build: an e-mail that
+gains or loses one fails the typecheck.
+
+## Licence
+
+MIT

package/dist/generated/locales.d.ts

@@ -0,0 +1,5 @@
+/** The locales the default e-mails are built in, the fallback locale first. */
+export declare const LOCALES: readonly ["en", "fr"];
+/** A locale the default e-mails are built in. */
+export type JanusMailLocale = (typeof LOCALES)[number];
+//# sourceMappingURL=locales.d.ts.map

package/dist/generated/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../src/generated/locales.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,eAAO,MAAM,OAAO,uBAAwB,CAAC;AAE7C,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/generated/mail.d.ts

@@ -0,0 +1,29 @@
+/** The e-mails of the build, each with the variables it takes when it is sent. */
+export interface MailEmails {
+    "email-changed": {
+        readonly brand: string | number;
+        readonly link: string;
+        readonly name: string | number;
+        readonly newEmail: string | number;
+    };
+    "password-changed": {
+        readonly brand: string | number;
+        readonly link: string;
+        readonly name: string | number;
+    };
+    "reset-password": {
+        readonly brand: string | number;
+        readonly link: string;
+        readonly name: string | number;
+    };
+    "sign-in-code": {
+        readonly brand: string | number;
+        readonly code: string | number;
+    };
+    "verify-email": {
+        readonly brand: string | number;
+        readonly link: string;
+        readonly name: string | number;
+    };
+}
+//# sourceMappingURL=mail.d.ts.map

package/dist/generated/mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/generated/mail.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,MAAM,WAAW,UAAU;IAC1B,eAAe,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChJ,kBAAkB,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC/G,gBAAgB,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7G,cAAc,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACpF,cAAc,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC3G"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@nxgt/janus-mail` — the e-mails of `@nxgt/janus`'s flows.
+ *
+ * `@nxgt/janus` sends no e-mail: its flows answer what to send — a one-time
+ * token, a sign-in code, the address — and this package turns that answer
+ * into an e-mail and hands it to an `@nxgt/mail` transport. Five e-mails, in
+ * English and French, prebuilt with Maizzle when this package is built, and
+ * filled at send time with your brand, the recipient's name and your links.
+ * Any of them can be replaced by a function of your own.
+ *
+ * ## The rule this package is built around
+ *
+ * **A send that fails throws.** Every method rejects with the mailer's
+ * `MailFailure` or `MailRefused`, untouched — never wrapped, never mapped to
+ * `false` — so a user is never told to check an inbox that will stay empty.
+ */
+export { janusMail } from './janus-mail';
+export { janusTemplates } from './templates';
+export type { JanusMail, JanusMailLinks, JanusMailLocale, JanusMailOptions, JanusMailTemplate, JanusMailTemplateName, JanusMailTemplates, JanusMailVariables, Recipient, } 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;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACX,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,GACT,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,234 @@
+// src/janus-mail.ts
+import { pickLocale } from "@nxgt/mail";
+
+// src/generated/locales.ts
+var LOCALES = ["en", "fr"];
+
+// src/mails.ts
+import { fileURLToPath } from "node:url";
+import { createMailRenderer } from "@nxgt/mail/renderer";
+var MAILS_DIR = fileURLToPath(new URL("../mails/", import.meta.url));
+var renderer;
+function defaultRenderer() {
+  renderer ??= createMailRenderer({ dir: MAILS_DIR });
+  return renderer;
+}
+
+// src/templates.ts
+function janusTemplates() {
+  return Object.freeze({
+    verifyEmail: ({ brand, name, link, locale }) => defaultRenderer().render("verify-email", { brand, name, link }, { locale }),
+    resetPassword: ({ brand, name, link, locale }) => defaultRenderer().render("reset-password", { brand, name, link }, { locale }),
+    signInCode: ({ brand, code, locale }) => defaultRenderer().render("sign-in-code", { brand, code }, { locale }),
+    passwordChanged: ({ brand, name, link, locale }) => defaultRenderer().render("password-changed", { brand, name, link }, { locale }),
+    emailChanged: ({ brand, name, link, newEmail, locale }) => defaultRenderer().render("email-changed", { brand, name, link, newEmail }, { locale })
+  });
+}
+
+// src/options.ts
+var TEMPLATE_NAMES = [
+  "verifyEmail",
+  "resetPassword",
+  "signInCode",
+  "passwordChanged",
+  "emailChanged"
+];
+var LINK_NAMES = ["verifyEmail", "resetPassword", "secureAccount"];
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isAddress(value) {
+  if (typeof value === "string")
+    return value.trim() !== "";
+  return isObject(value) && typeof value.name === "string" && typeof value.address === "string" && value.address.trim() !== "";
+}
+function refuse(message) {
+  throw new TypeError(`janusMail: ${message}`);
+}
+function checkSending(options) {
+  const { mailer, from, replyTo, brand, links } = options;
+  if (!isObject(mailer) || typeof mailer.send !== "function") {
+    refuse("mailer must be a Mailer — an object with a send function");
+  }
+  if (!isAddress(from)) {
+    refuse("from must be an address, as 'noreply@example.com' or { name, address }");
+  }
+  if (replyTo !== undefined && !isAddress(replyTo)) {
+    refuse("replyTo must be an address, as 'support@example.com' or { name, address }");
+  }
+  if (typeof brand !== "string" || brand.trim() === "") {
+    refuse("brand must be the name the e-mails show, as 'Acme'");
+  }
+  if (!isObject(links)) {
+    refuse("links must be an object, as { verifyEmail, resetPassword, secureAccount }");
+  }
+  for (const name of LINK_NAMES) {
+    if (typeof links[name] !== "function") {
+      refuse(`links.${name} must be a function`);
+    }
+  }
+}
+function resolveLocales(options) {
+  const wanted = options.locales ?? LOCALES;
+  if (!Array.isArray(wanted) || wanted.length === 0 || !wanted.every((locale) => typeof locale === "string" && locale !== "")) {
+    refuse("locales must list at least one locale, as ['en', 'fr']");
+  }
+  const locales = Object.freeze([...wanted]);
+  if (new Set(locales).size !== locales.length) {
+    refuse("locales holds the same locale twice");
+  }
+  const fallbackLocale = options.fallbackLocale ?? (locales.includes("en") ? "en" : locales[0]);
+  if (typeof fallbackLocale !== "string" || !locales.includes(fallbackLocale)) {
+    refuse("fallbackLocale must be one of locales");
+  }
+  return { locales, fallbackLocale };
+}
+function resolveTemplates(options, locales) {
+  const given = options.templates ?? {};
+  if (!isObject(given)) {
+    refuse("templates must be an object of functions, as { verifyEmail: (variables) => rendered }");
+  }
+  for (const [name, template] of Object.entries(given)) {
+    if (!TEMPLATE_NAMES.includes(name)) {
+      refuse(`templates has no template ${name} — name one of ${TEMPLATE_NAMES.join(", ")}`);
+    }
+    if (typeof template !== "function") {
+      refuse(`templates.${name} must be a function`);
+    }
+  }
+  const passed = Object.keys(given);
+  for (const name of TEMPLATE_NAMES) {
+    if (name in given && !passed.includes(name)) {
+      refuse(`templates.${name} is not an own enumerable property — pass a plain object, as { ${name}: (variables) => rendered }`);
+    }
+  }
+  const built = locales.every((locale) => LOCALES.includes(locale));
+  const missing = TEMPLATE_NAMES.filter((name) => !passed.includes(name));
+  if (!built && missing.length > 0) {
+    refuse(`the default templates are built in ${LOCALES.join(" and ")} only — with another ` + `locale in locales, pass every template in templates; ${missing.join(", ")} missing`);
+  }
+  const defaults = janusTemplates();
+  return Object.freeze({ ...defaults, ...given });
+}
+function frozenAddress(address) {
+  return typeof address === "string" ? address : Object.freeze({ name: address.name, address: address.address });
+}
+function frozenLinks(links) {
+  return Object.freeze({
+    verifyEmail: links.verifyEmail.bind(links),
+    resetPassword: links.resetPassword.bind(links),
+    secureAccount: links.secureAccount.bind(links)
+  });
+}
+function resolveOptions(options) {
+  if (!isObject(options)) {
+    refuse("options must be an object, as { mailer, from, brand, links }");
+  }
+  checkSending(options);
+  const { locales, fallbackLocale } = resolveLocales(options);
+  return Object.freeze({
+    mailer: options.mailer,
+    from: frozenAddress(options.from),
+    replyTo: options.replyTo === undefined ? undefined : frozenAddress(options.replyTo),
+    brand: options.brand,
+    links: frozenLinks(options.links),
+    locales,
+    fallbackLocale,
+    templates: resolveTemplates(options, locales)
+  });
+}
+
+// src/janus-mail.ts
+function field(method, value, key) {
+  const read = typeof value === "object" && value !== null ? value[key] : undefined;
+  if (typeof read !== "string") {
+    throw new TypeError(`janusMail.${method}: ${key} must be a string`);
+  }
+  return read;
+}
+function link(method, value, call) {
+  if (typeof value !== "string") {
+    throw new TypeError(`janusMail.${method}: links.${call} must answer a string`);
+  }
+  return value;
+}
+function localeFor(options, to) {
+  const wanted = typeof to === "object" && to !== null ? to.locale : undefined;
+  return pickLocale(wanted, options.locales, options.fallbackLocale);
+}
+async function send(options, name, address, variables) {
+  const template = options.templates[name];
+  const { subject, html, text } = await template(variables);
+  const replyTo = options.replyTo === undefined ? {} : { replyTo: options.replyTo };
+  return options.mailer.send({
+    to: address,
+    from: options.from,
+    ...replyTo,
+    subject,
+    html,
+    text
+  });
+}
+function methods(options) {
+  const { brand, links } = options;
+  return {
+    async verifyEmail(issued, to) {
+      const token = field("verifyEmail", issued, "token");
+      return send(options, "verifyEmail", field("verifyEmail", issued, "email"), {
+        brand,
+        name: field("verifyEmail", to, "name"),
+        link: link("verifyEmail", links.verifyEmail(token), "verifyEmail(token)"),
+        locale: localeFor(options, to)
+      });
+    },
+    async resetPassword(issued, to) {
+      const token = field("resetPassword", issued, "token");
+      return send(options, "resetPassword", field("resetPassword", issued, "email"), {
+        brand,
+        name: field("resetPassword", to, "name"),
+        link: link("resetPassword", links.resetPassword(token), "resetPassword(token)"),
+        locale: localeFor(options, to)
+      });
+    },
+    async signInCode(issued, to) {
+      return send(options, "signInCode", field("signInCode", issued, "email"), {
+        brand,
+        code: field("signInCode", issued, "code"),
+        locale: localeFor(options, to)
+      });
+    },
+    async passwordChanged(to) {
+      return send(options, "passwordChanged", field("passwordChanged", to, "email"), {
+        brand,
+        name: field("passwordChanged", to, "name"),
+        link: link("passwordChanged", links.secureAccount(), "secureAccount()"),
+        locale: localeFor(options, to)
+      });
+    },
+    async emailChanged(to) {
+      return send(options, "emailChanged", field("emailChanged", to, "formerEmail"), {
+        brand,
+        name: field("emailChanged", to, "name"),
+        link: link("emailChanged", links.secureAccount(), "secureAccount()"),
+        newEmail: field("emailChanged", to, "newEmail"),
+        locale: localeFor(options, to)
+      });
+    }
+  };
+}
+function janusMail(options) {
+  const resolved = resolveOptions(options);
+  const mail = Object.freeze({
+    ...methods(resolved),
+    templates: resolved.templates,
+    locales: resolved.locales
+  });
+  return mail;
+}
+export {
+  janusMail,
+  janusTemplates
+};
+
+//# debugId=B2A314C222070DD464756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,14 @@
+{
+  "version": 3,
+  "sources": ["../src/janus-mail.ts", "../src/generated/locales.ts", "../src/mails.ts", "../src/templates.ts", "../src/options.ts"],
+  "sourcesContent": [
+    "/**\n * `janusMail()`: the e-mails of Janus's flows, rendered by the templates and\n * handed to the mailer. It sends what a flow answered, to the address the\n * flow answered, and nothing else: no retry, no queue, no error of its own —\n * the mailer's `MailFailure` and `MailRefused` reach the caller untouched.\n */\nimport type { Address, Rendered, SentMail, WantedLocales } from '@nxgt/mail';\nimport { pickLocale } from '@nxgt/mail';\nimport { type ResolvedOptions, resolveOptions } from './options';\nimport type {\n\tJanusMail,\n\tJanusMailLocale,\n\tJanusMailOptions,\n\tJanusMailTemplateName,\n\tJanusMailVariables,\n} from './types';\n\n/** A string field of an argument, or a `TypeError` naming the method and the field. */\nfunction field(method: string, value: unknown, key: string): string {\n\tconst read =\n\t\ttypeof value === 'object' && value !== null\n\t\t\t? (value as Record<string, unknown>)[key]\n\t\t\t: undefined;\n\tif (typeof read !== 'string') {\n\t\tthrow new TypeError(`janusMail.${method}: ${key} must be a string`);\n\t}\n\treturn read;\n}\n\n/**\n * What a `links` function answered, or a `TypeError` naming the method and\n * the call. Its scheme is the renderer's to check: `http(s)` and `mailto:`\n * pass, anything else is its `MailRefused`.\n */\nfunction link(method: string, value: unknown, call: string): string {\n\tif (typeof value !== 'string') {\n\t\tthrow new TypeError(\n\t\t\t`janusMail.${method}: links.${call} must answer a string`,\n\t\t);\n\t}\n\treturn value;\n}\n\n/** The locale the recipient gets: the first they want that is sent in, else the fallback. */\nfunction localeFor(options: ResolvedOptions, to: unknown): string {\n\tconst wanted =\n\t\ttypeof to === 'object' && to !== null\n\t\t\t? (to as { locale?: WantedLocales }).locale\n\t\t\t: undefined;\n\treturn pickLocale(wanted, options.locales, options.fallbackLocale);\n}\n\n/**\n * Renders one e-mail and hands it to the mailer. Only `subject`, `html` and\n * `text` are read from what the template answered: a template cannot add a\n * recipient or a header.\n */\nasync function send<K extends JanusMailTemplateName>(\n\toptions: ResolvedOptions,\n\tname: K,\n\taddress: string,\n\tvariables: JanusMailVariables[K] & { readonly locale: string },\n): Promise<SentMail> {\n\tconst template = options.templates[name] as (\n\t\tvariables: JanusMailVariables[K] & { readonly locale: string },\n\t) => Rendered | PromiseLike<Rendered>;\n\tconst { subject, html, text }: Rendered = await template(variables);\n\tconst replyTo: { replyTo?: Address } =\n\t\toptions.replyTo === undefined ? {} : { replyTo: options.replyTo };\n\treturn options.mailer.send({\n\t\tto: address,\n\t\tfrom: options.from,\n\t\t...replyTo,\n\t\tsubject,\n\t\thtml,\n\t\ttext,\n\t});\n}\n\n/** The five methods, over the resolved options. */\nfunction methods(\n\toptions: ResolvedOptions,\n): Omit<JanusMail<string>, 'templates' | 'locales'> {\n\tconst { brand, links } = options;\n\treturn {\n\t\tasync verifyEmail(issued, to) {\n\t\t\tconst token = field('verifyEmail', issued, 'token');\n\t\t\treturn send(\n\t\t\t\toptions,\n\t\t\t\t'verifyEmail',\n\t\t\t\tfield('verifyEmail', issued, 'email'),\n\t\t\t\t{\n\t\t\t\t\tbrand,\n\t\t\t\t\tname: field('verifyEmail', to, 'name'),\n\t\t\t\t\tlink: link(\n\t\t\t\t\t\t'verifyEmail',\n\t\t\t\t\t\tlinks.verifyEmail(token),\n\t\t\t\t\t\t'verifyEmail(token)',\n\t\t\t\t\t),\n\t\t\t\t\tlocale: localeFor(options, to),\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t\tasync resetPassword(issued, to) {\n\t\t\tconst token = field('resetPassword', issued, 'token');\n\t\t\treturn send(\n\t\t\t\toptions,\n\t\t\t\t'resetPassword',\n\t\t\t\tfield('resetPassword', issued, 'email'),\n\t\t\t\t{\n\t\t\t\t\tbrand,\n\t\t\t\t\tname: field('resetPassword', to, 'name'),\n\t\t\t\t\tlink: link(\n\t\t\t\t\t\t'resetPassword',\n\t\t\t\t\t\tlinks.resetPassword(token),\n\t\t\t\t\t\t'resetPassword(token)',\n\t\t\t\t\t),\n\t\t\t\t\tlocale: localeFor(options, to),\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t\tasync signInCode(issued, to) {\n\t\t\t// `code` and `email` only: the challenge is the visitor's secret.\n\t\t\treturn send(options, 'signInCode', field('signInCode', issued, 'email'), {\n\t\t\t\tbrand,\n\t\t\t\tcode: field('signInCode', issued, 'code'),\n\t\t\t\tlocale: localeFor(options, to),\n\t\t\t});\n\t\t},\n\t\tasync passwordChanged(to) {\n\t\t\treturn send(\n\t\t\t\toptions,\n\t\t\t\t'passwordChanged',\n\t\t\t\tfield('passwordChanged', to, 'email'),\n\t\t\t\t{\n\t\t\t\t\tbrand,\n\t\t\t\t\tname: field('passwordChanged', to, 'name'),\n\t\t\t\t\tlink: link(\n\t\t\t\t\t\t'passwordChanged',\n\t\t\t\t\t\tlinks.secureAccount(),\n\t\t\t\t\t\t'secureAccount()',\n\t\t\t\t\t),\n\t\t\t\t\tlocale: localeFor(options, to),\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t\tasync emailChanged(to) {\n\t\t\t// To the former address: the one a hijacker just took the account from.\n\t\t\treturn send(\n\t\t\t\toptions,\n\t\t\t\t'emailChanged',\n\t\t\t\tfield('emailChanged', to, 'formerEmail'),\n\t\t\t\t{\n\t\t\t\t\tbrand,\n\t\t\t\t\tname: field('emailChanged', to, 'name'),\n\t\t\t\t\tlink: link('emailChanged', links.secureAccount(), 'secureAccount()'),\n\t\t\t\t\tnewEmail: field('emailChanged', to, 'newEmail'),\n\t\t\t\t\tlocale: localeFor(options, to),\n\t\t\t\t},\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * The e-mails of Janus's flows, over your mailer:\n *\n * ```ts\n * const mail = janusMail({\n * \tmailer,\n * \tfrom: 'noreply@acme.example',\n * \tbrand: 'Acme',\n * \tlinks: {\n * \t\tverifyEmail: (token) => `https://acme.example/verify?token=${token}`,\n * \t\tresetPassword: (token) => `https://acme.example/reset?token=${token}`,\n * \t\tsecureAccount: () => 'https://acme.example/account/security',\n * \t},\n * });\n *\n * await mail.verifyEmail(await auth.verifyEmail.send(user), { name: user.name, locale: user.locale });\n * ```\n *\n * Reads nothing when called: the default e-mails are read on the first one\n * sent. A wrong option is a bare `TypeError`, thrown here.\n */\nexport function janusMail<const L extends string = JanusMailLocale>(\n\toptions: JanusMailOptions<L>,\n): JanusMail<L> {\n\tconst resolved = resolveOptions(options);\n\tconst mail: JanusMail<string> = Object.freeze({\n\t\t...methods(resolved),\n\t\ttemplates: resolved.templates,\n\t\tlocales: resolved.locales,\n\t});\n\t// The one cast at the boundary: the mirror above works on `string` locales.\n\treturn mail as unknown as JanusMail<L>;\n}\n",
+    "// Generated by scripts/build-mail.ts from mails/mail-manifest.json, after\n// each build of the default e-mails. Never edited; committed.\n\n/** The locales the default e-mails are built in, the fallback locale first. */\nexport const LOCALES = ['en', 'fr'] as const;\n\n/** A locale the default e-mails are built in. */\nexport type JanusMailLocale = (typeof LOCALES)[number];\n",
+    "/**\n * Where the default e-mails are, and the one renderer that reads them.\n *\n * The package ships the built e-mails in `mails/`, beside `dist/` — not in\n * it, because the root `build.ts` removes from `dist/` every file it did not\n * write itself.\n */\nimport { fileURLToPath } from 'node:url';\nimport { createMailRenderer, type MailRenderer } from '@nxgt/mail/renderer';\nimport type { MailEmails } from './generated/mail';\n\n/**\n * The folder of the built e-mails, resolved from this module rather than from\n * the working directory, which is the consumer's.\n *\n * **This file must stay directly under `src/`.** `../mails/` is right from\n * `src/mails.ts` in the specs, and from `dist/index.js` in the tarball,\n * because the build bundles this module into the single entry\n * `dist/index.js`, one level under the package as `src/` is. Moved into a\n * subfolder, or bundled into `dist/chunks/` by a second entry point, it would\n * resolve a folder that does not exist — which the artifact spec, rendering\n * from `../dist`, would catch.\n */\nexport const MAILS_DIR = fileURLToPath(new URL('../mails/', import.meta.url));\n\nlet renderer: MailRenderer<MailEmails> | undefined;\n\n/**\n * The renderer of the default e-mails, created on first use and shared by\n * every `janusMail()` and `janusTemplates()` after it.\n *\n * Lazy, so importing the package reads nothing: an application that\n * overrides every template never opens `mails/`. The first default template\n * rendered reads the whole build once — a missing `mails/` throws there, with\n * `createMailRenderer`'s own message.\n */\nexport function defaultRenderer(): MailRenderer<MailEmails> {\n\trenderer ??= createMailRenderer<MailEmails>({ dir: MAILS_DIR });\n\treturn renderer;\n}\n",
+    "/**\n * The default templates: the prebuilt e-mails, filled by `@nxgt/mail`'s\n * renderer. Each picks from its variables exactly what its e-mail takes — the\n * renderer refuses a variable too many — so the `locale` beside them goes to\n * the renderer's options, and nowhere else.\n */\nimport type { Rendered } from '@nxgt/mail';\nimport { defaultRenderer } from './mails';\nimport type { JanusMailTemplates } from './types';\n\n/**\n * The five default templates, in the locales they are built in. The\n * renderer behind them is created on the first render, not here.\n *\n * ```ts\n * const defaults = janusTemplates();\n * const { subject } = await defaults.verifyEmail({ brand: 'Acme', name: 'Ada', link, locale: 'fr' });\n * ```\n *\n * A URL that is not `http:`, `https:` or `mailto:` throws `MailRefused`; a\n * missing `mails/` folder throws when the first one renders.\n */\nexport function janusTemplates(): JanusMailTemplates {\n\treturn Object.freeze({\n\t\tverifyEmail: ({ brand, name, link, locale }): Rendered =>\n\t\t\tdefaultRenderer().render(\n\t\t\t\t'verify-email',\n\t\t\t\t{ brand, name, link },\n\t\t\t\t{ locale },\n\t\t\t),\n\t\tresetPassword: ({ brand, name, link, locale }): Rendered =>\n\t\t\tdefaultRenderer().render(\n\t\t\t\t'reset-password',\n\t\t\t\t{ brand, name, link },\n\t\t\t\t{ locale },\n\t\t\t),\n\t\tsignInCode: ({ brand, code, locale }): Rendered =>\n\t\t\tdefaultRenderer().render('sign-in-code', { brand, code }, { locale }),\n\t\tpasswordChanged: ({ brand, name, link, locale }): Rendered =>\n\t\t\tdefaultRenderer().render(\n\t\t\t\t'password-changed',\n\t\t\t\t{ brand, name, link },\n\t\t\t\t{ locale },\n\t\t\t),\n\t\temailChanged: ({ brand, name, link, newEmail, locale }): Rendered =>\n\t\t\tdefaultRenderer().render(\n\t\t\t\t'email-changed',\n\t\t\t\t{ brand, name, link, newEmail },\n\t\t\t\t{ locale },\n\t\t\t),\n\t});\n}\n",
+    "/**\n * `janusMail()`'s options, checked once when it is called. A mistake is a\n * wiring mistake, so a bare `TypeError` naming the option — never its value —\n * thrown before anything is sent.\n */\nimport type { Address, Mailer } from '@nxgt/mail';\nimport { LOCALES } from './generated/locales';\nimport { janusTemplates } from './templates';\nimport type {\n\tJanusMailLinks,\n\tJanusMailTemplateName,\n\tJanusMailTemplates,\n} from './types';\n\n/** The templates in the order the documentation lists them. */\nexport const TEMPLATE_NAMES: readonly JanusMailTemplateName[] = [\n\t'verifyEmail',\n\t'resetPassword',\n\t'signInCode',\n\t'passwordChanged',\n\t'emailChanged',\n];\n\nconst LINK_NAMES = ['verifyEmail', 'resetPassword', 'secureAccount'] as const;\n\n/** The options once checked, with `string` for the locales: the degenericised mirror. */\nexport interface ResolvedOptions {\n\treadonly mailer: Mailer;\n\treadonly from: Address;\n\treadonly replyTo: Address | undefined;\n\treadonly brand: string;\n\treadonly links: JanusMailLinks;\n\treadonly locales: readonly string[];\n\treadonly fallbackLocale: string;\n\treadonly templates: JanusMailTemplates<string>;\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isAddress(value: unknown): value is Address {\n\tif (typeof value === 'string') return value.trim() !== '';\n\treturn (\n\t\tisObject(value) &&\n\t\ttypeof value.name === 'string' &&\n\t\ttypeof value.address === 'string' &&\n\t\tvalue.address.trim() !== ''\n\t);\n}\n\nfunction refuse(message: string): never {\n\tthrow new TypeError(`janusMail: ${message}`);\n}\n\n/** `mailer`, `from`, `replyTo`, `brand` and `links`. */\nfunction checkSending(options: Record<string, unknown>): void {\n\tconst { mailer, from, replyTo, brand, links } = options;\n\tif (!isObject(mailer) || typeof mailer.send !== 'function') {\n\t\trefuse('mailer must be a Mailer — an object with a send function');\n\t}\n\tif (!isAddress(from)) {\n\t\trefuse(\n\t\t\t\"from must be an address, as 'noreply@example.com' or { name, address }\",\n\t\t);\n\t}\n\tif (replyTo !== undefined && !isAddress(replyTo)) {\n\t\trefuse(\n\t\t\t\"replyTo must be an address, as 'support@example.com' or { name, address }\",\n\t\t);\n\t}\n\tif (typeof brand !== 'string' || brand.trim() === '') {\n\t\trefuse(\"brand must be the name the e-mails show, as 'Acme'\");\n\t}\n\tif (!isObject(links)) {\n\t\trefuse(\n\t\t\t'links must be an object, as { verifyEmail, resetPassword, secureAccount }',\n\t\t);\n\t}\n\tfor (const name of LINK_NAMES) {\n\t\tif (typeof links[name] !== 'function') {\n\t\t\trefuse(`links.${name} must be a function`);\n\t\t}\n\t}\n}\n\n/** `locales` and `fallbackLocale`, with their defaults. */\nfunction resolveLocales(options: Record<string, unknown>): {\n\tlocales: readonly string[];\n\tfallbackLocale: string;\n} {\n\tconst wanted = options.locales ?? LOCALES;\n\tif (\n\t\t!Array.isArray(wanted) ||\n\t\twanted.length === 0 ||\n\t\t!wanted.every((locale) => typeof locale === 'string' && locale !== '')\n\t) {\n\t\trefuse(\"locales must list at least one locale, as ['en', 'fr']\");\n\t}\n\tconst locales: readonly string[] = Object.freeze([...wanted]);\n\tif (new Set(locales).size !== locales.length) {\n\t\trefuse('locales holds the same locale twice');\n\t}\n\tconst fallbackLocale =\n\t\toptions.fallbackLocale ??\n\t\t(locales.includes('en') ? 'en' : (locales[0] as string));\n\tif (typeof fallbackLocale !== 'string' || !locales.includes(fallbackLocale)) {\n\t\trefuse('fallbackLocale must be one of locales');\n\t}\n\treturn { locales, fallbackLocale };\n}\n\n/** `templates` over the defaults — the defaults only while every locale is built. */\nfunction resolveTemplates(\n\toptions: Record<string, unknown>,\n\tlocales: readonly string[],\n): JanusMailTemplates<string> {\n\tconst given = options.templates ?? {};\n\tif (!isObject(given)) {\n\t\trefuse(\n\t\t\t'templates must be an object of functions, as { verifyEmail: (variables) => rendered }',\n\t\t);\n\t}\n\tfor (const [name, template] of Object.entries(given)) {\n\t\tif (!(TEMPLATE_NAMES as readonly string[]).includes(name)) {\n\t\t\trefuse(\n\t\t\t\t`templates has no template ${name} — name one of ${TEMPLATE_NAMES.join(', ')}`,\n\t\t\t);\n\t\t}\n\t\tif (typeof template !== 'function') {\n\t\t\trefuse(`templates.${name} must be a function`);\n\t\t}\n\t}\n\t// Own enumerable keys, the ones the spread below copies. A template on a\n\t// prototype — a class instance's method — or an own property that is not\n\t// enumerable would be dropped without a word, the default sent in its\n\t// place: `in` sees it and `passed` does not, so it is refused instead.\n\tconst passed = Object.keys(given);\n\tfor (const name of TEMPLATE_NAMES) {\n\t\tif (name in given && !passed.includes(name)) {\n\t\t\trefuse(\n\t\t\t\t`templates.${name} is not an own enumerable property — pass a plain object, as { ${name}: (variables) => rendered }`,\n\t\t\t);\n\t\t}\n\t}\n\tconst built = locales.every((locale) =>\n\t\t(LOCALES as readonly string[]).includes(locale),\n\t);\n\tconst missing = TEMPLATE_NAMES.filter((name) => !passed.includes(name));\n\tif (!built && missing.length > 0) {\n\t\trefuse(\n\t\t\t`the default templates are built in ${LOCALES.join(' and ')} only — with another ` +\n\t\t\t\t`locale in locales, pass every template in templates; ${missing.join(', ')} missing`,\n\t\t);\n\t}\n\t// The one cast: a default template takes a built locale only, and the check\n\t// above proves every locale is one whenever a default is kept.\n\tconst defaults = janusTemplates() as unknown as JanusMailTemplates<string>;\n\treturn Object.freeze({ ...defaults, ...given }) as JanusMailTemplates<string>;\n}\n\n/** A frozen copy of a checked address: a later change to the caller's object is not seen. */\nfunction frozenAddress(address: Address): Address {\n\treturn typeof address === 'string'\n\t\t? address\n\t\t: Object.freeze({ name: address.name, address: address.address });\n}\n\n/**\n * A frozen copy of the checked links, each bound to the caller's object — a\n * class instance's methods keep their `this` — so replacing a link after\n * `janusMail()` cannot undo the check.\n */\nfunction frozenLinks(links: JanusMailLinks): JanusMailLinks {\n\treturn Object.freeze({\n\t\tverifyEmail: links.verifyEmail.bind(links),\n\t\tresetPassword: links.resetPassword.bind(links),\n\t\tsecureAccount: links.secureAccount.bind(links),\n\t});\n}\n\n/**\n * Checks `janusMail()`'s options and answers them resolved, or throws a\n * `TypeError`. What was checked is copied and frozen, so the guarantee made\n * here holds at every send.\n */\nexport function resolveOptions(options: unknown): ResolvedOptions {\n\tif (!isObject(options)) {\n\t\trefuse('options must be an object, as { mailer, from, brand, links }');\n\t}\n\tcheckSending(options);\n\tconst { locales, fallbackLocale } = resolveLocales(options);\n\treturn Object.freeze({\n\t\tmailer: options.mailer as Mailer,\n\t\tfrom: frozenAddress(options.from as Address),\n\t\treplyTo:\n\t\t\toptions.replyTo === undefined\n\t\t\t\t? undefined\n\t\t\t\t: frozenAddress(options.replyTo as Address),\n\t\tbrand: options.brand as string,\n\t\tlinks: frozenLinks(options.links as unknown as JanusMailLinks),\n\t\tlocales,\n\t\tfallbackLocale,\n\t\ttemplates: resolveTemplates(options, locales),\n\t});\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "B2A314C222070DD464756E2164756E21",
+  "names": []
+}