@12-apps/notifications 4.8.0 → 4.9.0

package/ADOPTING.md

@@ -22,6 +22,8 @@ sweep — endpoints and screens included.
 | **Hono** | `@12-apps/notifications/hono` | `const notifications = notificationsRouter({ ...serverConfig, resolveActor }); app.route('/api/account', notifications.router)`. A one-call mount; `hono` is an OPTIONAL peer, so importing the root, `/server` or `/react` never resolves it. |
 | **React** | `@12-apps/notifications/react` | Call `createWebNotifications({ apiBase })`. `BellWithPanel` is the whole feature as one element; `BellButton` + `Panel` are the pair for a host with its own chrome; `page` is the preferences screen you route to. pt-BR product copy and the origin host's test ids ship inside. |
 | **Web Push** | `@12-apps/notifications/web-push` | `sender: vapidPushSender({ subject, publicKey, privateKey })` on the `WEB_PUSH` declaration. Its own subpath because it is the only piece that needs `web-push` — an OPTIONAL peer a host that never enables the channel never installs. |
+| **Mail layout** | `@12-apps/notifications/email` | `renderEmail(document)` → `{ subject, html, text }`. Framework-free and dependency-free. Turn it on for the EMAIL transport by declaring `layout`; the copy packs are `@12-apps/notifications/email/locales`. |
+| **Previews** | `@12-apps/notifications/email/previews` | The preview catalogue and its two route descriptors. `@12-apps/notifications/email/previews/hono` is the one-call mount; `.../previews/react` is the operator screen. A SECOND wiring manifest — see "The mail layout and its preview console". |
 | **Prisma** | `prisma/notifications.prisma` + `prisma/migrations/*` | Run `pnpm --filter @12-apps/notifications prisma:sync -- <host schema dir>`: the partial is **COPIED** into the host's multi-file schema folder — never symlinked (a symlinked migration is silently skipped by Prisma; a symlinked partial dangles under `turbo prune`). Migrations are discovered structurally from the installed package's `prisma/migrations` by the host's plugin-migration sync. |
 
 ## Host wiring rules (the ones that bite)
@@ -339,6 +341,113 @@ There are **no foreign keys into host tables**: `user_id` and `client_id` are
 by-value scalars. Add your own in a host migration — `ON DELETE CASCADE` on
 both is the recommendation, so a deleted account takes its inbox with it.
 
+## The mail layout and its preview console
+
+Both are optional and independent of everything above: the layout is a pure
+function, and the console declares no `db`, so adopting either touches no schema.
+
+### 1. Turning the layout on for the EMAIL transport
+
+Add `layout` to the driver declaration. Without it you keep the previous
+rendering byte for byte — this is opt-in because `brand` and `chrome` are
+REQUIRED with no default, so making them mandatory would break every host
+already declaring EMAIL, at runtime, on the first send.
+
+```ts
+import { PT_BR_EMAIL_CHROME } from '@12-apps/notifications/email/locales';
+
+{ channel: 'EMAIL', driver: 'resend', apiKey, from, linkLabel: 'Ver detalhes',
+  layout: { brand: 'Loja Exemplo', chrome: PT_BR_EMAIL_CHROME, locale: 'pt-BR' } }
+```
+
+`theme` may be omitted; the layout ships a neutral grey-on-white palette. That
+one asymmetry is deliberate and argued in `src/email/theme.ts`: a wrong-language
+default is invisible until a customer complains, where a missing theme is
+visible in the first preview.
+
+For a host whose recipients do not share a language, resolve `chrome` per
+message rather than at the mount — a mail's language is the RECIPIENT's, not the
+request's.
+
+### 2. YOU gate the console. The routes only ask
+
+`emailPreviewRoutes` declares `kind: 'authenticated'` on both descriptors — the
+wiring contract's word for "behind the host's session resolution and its RBAC".
+It names no permission id, because the ids are yours. **So the descriptor asks
+for a gate; it cannot supply one.**
+
+The surface publishes your whole transactional-mail inventory and the exact
+wording and link shape of your verification and password-reset mails — the
+reference somebody writing a convincing phishing mail for your product would
+want. Mount it behind whichever gate you already use for platform staff:
+
+```ts
+import { emailPreviewsRouter } from '@12-apps/notifications/email/previews/hono';
+
+app.use('/api/platform/email-previews/*', requirePlatformOperator);
+app.route('/api/platform/email-previews', emailPreviewsRouter(previews).router);
+```
+
+`allow` on the config is there for a host that would rather state the refusal
+once in the config than mount middleware around the router. Either is fine;
+neither is optional.
+
+### 3. Declare the SOURCES — and expect to be asked repeatedly
+
+A package cannot know that you send a "your quota is exhausted" notice, let
+alone what data it renders from. So you declare sources, and each is asked
+**per request**:
+
+```ts
+const previews = {
+  sources: [authMailSource(), notificationMailSource()],
+  locales: ['pt-BR', 'en-US'],
+  defaultLocale: 'pt-BR',
+};
+```
+
+Per request rather than once at the mount, because domain modules typically
+register their messages as an import side effect. A catalogue built once lists
+whatever happened to be imported first — which looks exactly like a product that
+sends fewer mails than it does.
+
+Ids must be unique across every source; a duplicate THROWS, because the
+alternative is one message unreachable and the other ambiguous, silently.
+
+### 4. `coverage` is optional, and worth writing
+
+A catalogue that quietly omits a message looks exactly like a product that does
+not send it. Report what you cannot show — a message with no sample data, or
+sample data for a message that no longer exists — and the screen renders it as a
+warning strip. Pair it with a unit test asserting `missing` is empty, and a mail
+added without a sample becomes a red test naming the type rather than a gap
+nobody sees.
+
+### 5. Adopt it as the SECOND manifest
+
+`@12-apps/notifications-email-previews` is a separate manifest from the same
+package, so a host mounts the inbox and declines the console (or vice versa) in
+writing rather than silently getting both behind one gate:
+
+```ts
+host.adoptServer({
+  manifest: notificationEmailPreviewsManifest,
+  server: notificationEmailPreviewsServerManifest,
+  bindings: { http: { mountPath: '/api/platform/email-previews', config: previews } },
+});
+```
+
+The web half binds `{ apiBase, copy }`, with `copy` a pack passed by name —
+`EN_US_EMAIL_PREVIEW_COPY` or `PT_BR_EMAIL_PREVIEW_COPY` from
+`@12-apps/notifications/email/previews/react`.
+
+### 6. Nothing can be sent from the console
+
+It holds no driver, no transport and no address, and `render` is pure by the
+contract `EmailPreviewMessage` states. The one mistake a preview surface must be
+incapable of — putting a sample in somebody's inbox — is not reachable from that
+code at all, rather than merely not done.
+
 ## What does NOT come with it
 
 - **The events.** Generators are host code (see rule 6).
@@ -346,3 +455,7 @@ both is the recommendation, so a deleted account takes its inbox with it.
 - **A plan model.** `channelPolicy` answers; it does not decide.
 - **An authorization engine.** `audience` answers; it does not decide.
 - **A service worker.** The file is the host's (rule 12).
+- **The mail INVENTORY.** The preview console renders what you declare as
+  sources; it cannot discover what your product sends.
+- **A brand, a palette or a sentence.** The layout requires the first, defaults
+  only the second, and ships the third as packs you pass by name.

package/README.md

@@ -121,6 +121,71 @@ a form B's keys decrypt) and the preferences screen derives "this browser is
 receiving alerts" from the SERVER's answer, not from the browser's own
 subscription object.
 
+## One mail layout, and a console that previews it
+
+`EMAIL` used to render a mail as three bare `<p>` tags. That is a **layout**
+problem rather than a wording one — a paragraph with no document around it
+inherits whatever the client decides: 13px Arial in Gmail, Times New Roman in
+Outlook, no centring anywhere — so the layout ships here, beside the transport
+that needed it.
+
+```ts
+import { renderEmail } from '@12-apps/notifications/email';
+import { PT_BR_EMAIL_CHROME } from '@12-apps/notifications/email/locales';
+```
+
+`renderEmail(document)` takes STRUCTURE — a heading, paragraphs, an optional
+facts table, at most one call to action — and never markup. Three things follow,
+and each was a real defect in the renderers it replaces:
+
+1. **Escaping cannot be forgotten.** It happens in one place.
+2. **The plain-text twin cannot drift.** Both halves render from the same
+   object. A `text/html` part with no `text/plain` twin is scored by every major
+   spam filter.
+3. **A preview is honest**, because the console renders exactly this.
+
+The client constraints are encoded once so no caller has to know them: tables
+rather than divs (Outlook lays HTML out with Word), inline styles only (Gmail
+strips `<style>`), no web fonts or `color-mix()` or CSS variables, a hidden
+preheader, a `bgcolor` attribute **and** a background style on the CTA.
+
+**The EMAIL transport opts in.** Declare `layout` on the driver declaration and
+`formatEmail` renders the shared document; omit it and you keep the previous
+rendering byte for byte. Opt-in rather than automatic because `brand` and
+`chrome` are required with no default — a package that defaulted them would sign
+another company's mail, in a language nobody chose — so making them mandatory
+would break every host already declaring EMAIL, at runtime, on the first send.
+
+```ts
+{ channel: 'EMAIL', driver: 'resend', apiKey, from, linkLabel: 'Ver detalhes',
+  layout: { brand: 'Loja Exemplo', chrome: PT_BR_EMAIL_CHROME, locale: 'pt-BR' } }
+```
+
+### The preview console
+
+There is normally no way to *see* a transactional mail without triggering the
+event that sends it — signing up with a throwaway address for the verification
+mail, settling an order for the receipt. So nobody looks, and a product
+rendering three ways does not find out. A layout nobody can see is one release
+from being three again, which is why the console ships in the same package.
+
+It is the package's **second wiring manifest**
+(`@12-apps/notifications-email-previews`), because the first has already spent
+`http` on the account inbox and `surface` on the bell. That split is deliberate:
+the inbox ships to every signed-in user, and this console publishes the whole
+mail inventory and the exact wording and link shape of the verification and
+reset mails. **You gate the mount** — the routes declare `kind: 'authenticated'`
+and name no permission id, because the ids are the host's.
+
+WHICH messages exist is yours too, declared as `sources` that are asked **per
+request** (a source backed by a registry that fills at import time would
+otherwise answer with whatever was imported first). A source reports its own
+`coverage` — what it cannot show — and the screen renders that as a warning
+strip rather than pretending to be complete. Nothing can be sent from it: it
+holds no driver, no transport and no address.
+
+See **[ADOPTING.md](./ADOPTING.md)** for the mount, the gate and the sources.
+
 ## The models
 
 `prisma/notifications.prisma` — `Notification`, `NotificationDelivery`,

package/dist/catalog-BOVZ2b-b.d.ts

@@ -0,0 +1,132 @@
+import { R as RenderedEmail } from './template-Dlt5S54z.js';
+
+/**
+ * The preview catalogue: every message a host can send, as a navigable set.
+ *
+ * ## The problem it exists for
+ *
+ * There is normally no way to SEE a transactional mail without triggering the
+ * event that sends it — signing up with a throwaway address to look at the
+ * verification mail, settling an order to look at the receipt, exhausting a
+ * quota to look at that alert. So nobody looks, and a host that renders mail in
+ * three different ways does not find out.
+ *
+ * A layout nobody can see is one release from being three layouts again, which
+ * is why this ships in the same package as the layout rather than beside it.
+ *
+ * ## What is the package's and what is the host's
+ *
+ * The MECHANISM is here: group by owner, render one message for one reader,
+ * report what cannot be shown. WHICH messages exist is the host's, and it
+ * cannot be otherwise — a package cannot know that a host sends a
+ * "your quota is exhausted" notice, let alone what data that notice is
+ * rendered from.
+ *
+ * So a host declares SOURCES. Each names an owner and answers with its
+ * messages, and the catalogue is the union. That inverts the obvious design,
+ * where the package would hold a registry a host writes into: a source is
+ * asked, per request, so a source backed by a registry that fills at import
+ * time answers with whatever is registered NOW rather than with whatever had
+ * been registered when the mount was built.
+ *
+ * ## Why coverage is a first-class output
+ *
+ * A catalogue that quietly omits a message looks exactly like a product that
+ * does not send it. So a source may report what it knows it cannot show —
+ * a message with no sample data, or sample data for a message that no longer
+ * exists — and the surface returns that beside the list rather than swallowing
+ * it. A gap that is visible is a gap somebody closes.
+ */
+/** One previewable message. */
+interface EmailPreviewMessage {
+    /**
+     * Stable id, and the path segment the console navigates by.
+     *
+     * The host chooses the spelling; the surface only requires it to be unique
+     * across every source. Ids that survive a rename are what make a link to one
+     * mail worth sending to a colleague.
+     */
+    readonly id: string;
+    /** The wire identity — an event type, a template key. Shown beside the subject. */
+    readonly key: string;
+    /** Which mail path this belongs to, for grouping inside one owner. */
+    readonly family: string;
+    /** Render it for one reader. MUST be pure — nothing may be sent. */
+    render(locale: string): RenderedEmail;
+}
+/** What a source knows it cannot show. Both directions are worth reporting. */
+interface EmailPreviewCoverage {
+    /** Messages that exist but have no sample data, so no preview. */
+    readonly missing: readonly string[];
+    /** Sample data for a message nothing produces any more. */
+    readonly orphan: readonly string[];
+}
+/** One group of messages, owned by whichever code words them. */
+interface EmailPreviewSource {
+    /**
+     * Who owns these messages — a package name, or the host's own module.
+     *
+     * This is the console's grouping, and it is the answer to "which parts of
+     * this system send mail", which is a question most hosts cannot otherwise
+     * answer at all.
+     */
+    readonly owner: string;
+    /** Called PER REQUEST — see the docblock above for why that matters. */
+    list(): readonly EmailPreviewMessage[];
+    /** Optional: what this source cannot show. Absent means "nothing missing". */
+    coverage?(): EmailPreviewCoverage;
+}
+/** One catalogue row: everything the sidebar needs, and no rendered bytes. */
+interface EmailPreviewRow {
+    readonly id: string;
+    readonly key: string;
+    readonly family: string;
+    readonly owner: string;
+    /** The subject in the requested language, so the list reads as an inbox. */
+    readonly subject: string;
+}
+/** One rendered message: what the vendor would be handed, verbatim. */
+interface EmailPreviewDetail extends EmailPreviewRow {
+    readonly locale: string;
+    readonly html: string;
+    readonly text: string;
+}
+interface EmailPreviewIndex {
+    readonly locale: string;
+    readonly locales: readonly string[];
+    readonly items: readonly EmailPreviewRow[];
+    readonly coverage: EmailPreviewCoverage;
+}
+interface EmailPreviewsConfig {
+    /** The host's sources, in the order the console should list their owners. */
+    readonly sources: readonly EmailPreviewSource[];
+    /**
+     * The languages a preview may be asked for.
+     *
+     * REQUIRED, and not derived from the shipped packs: a host's own messages may
+     * be written in languages this package has never heard of, and a preview that
+     * silently refused one of them would look exactly like a product with no
+     * translation.
+     */
+    readonly locales: readonly string[];
+    /** The language a preview opens in when the caller names none. */
+    readonly defaultLocale: string;
+}
+/** An id that appears in more than one source — the one thing that must not happen. */
+declare class DuplicateEmailPreviewIdError extends Error {
+    constructor(id: string);
+}
+/** The catalogue, assembled from every source. */
+interface ApiEmailPreviews {
+    /** Every message, with each subject rendered in `locale`. */
+    index(locale?: string): EmailPreviewIndex;
+    /** One rendered message, or `null` when no source owns that id. */
+    render(id: string, locale?: string): EmailPreviewDetail | null;
+    /** The union of every source's gaps. */
+    coverage(): EmailPreviewCoverage;
+    /** Is this a language the host said it writes in? */
+    supportsLocale(locale: string): boolean;
+}
+declare function createEmailPreviews(config: EmailPreviewsConfig): ApiEmailPreviews;
+
+export { type ApiEmailPreviews as A, DuplicateEmailPreviewIdError as D, type EmailPreviewsConfig as E, type EmailPreviewCoverage as a, type EmailPreviewDetail as b, type EmailPreviewIndex as c, type EmailPreviewMessage as d, type EmailPreviewRow as e, type EmailPreviewSource as f, createEmailPreviews as g };

package/dist/chunk-EKUSNUBT.js

@@ -0,0 +1,222 @@
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/email/text.ts
+function renderEmailText(document) {
+  const blocks = [
+    document.heading,
+    "",
+    ...textParagraphs(document),
+    ...textFacts(document),
+    ...textAction(document),
+    ...textNotes(document),
+    "--",
+    document.chrome.tagline(document.brand),
+    document.chrome.automated
+  ];
+  return `${blocks.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd()}
+`;
+}
+__name(renderEmailText, "renderEmailText");
+function textParagraphs(document) {
+  return (document.paragraphs ?? []).flatMap((text) => [text, ""]);
+}
+__name(textParagraphs, "textParagraphs");
+function textFacts(document) {
+  const rows = document.facts ?? [];
+  return rows.length === 0 ? [] : [...rows.map((f) => `${f.label}: ${f.value}`), ""];
+}
+__name(textFacts, "textFacts");
+function textAction(document) {
+  return document.action ? [`${document.action.label}: ${document.action.href}`, ""] : [];
+}
+__name(textAction, "textAction");
+function textNotes(document) {
+  const notes = document.notes ?? [];
+  return notes.length === 0 ? [] : [...notes, ""];
+}
+__name(textNotes, "textNotes");
+
+// src/email/theme.ts
+var NEUTRAL_EMAIL_THEME = {
+  page: "#F5F6F8",
+  surface: "#FFFFFF",
+  panel: "#F5F6F8",
+  border: "#E1E4E9",
+  ink: "#1A1D23",
+  muted: "#5C6470",
+  accent: "#1F5EDB",
+  onAccent: "#FFFFFF",
+  rule: "#1F5EDB"
+};
+var EMAIL_FONT_STACK = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji'";
+var EMAIL_CONTENT_WIDTH = 600;
+
+// src/email/template.ts
+function escapeHtml(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
+}
+__name(escapeHtml, "escapeHtml");
+var SAFE_LINK_SCHEMES = /* @__PURE__ */ new Set(["http:", "https:", "mailto:"]);
+function safeHref(href) {
+  const trimmed = href.trim();
+  if (trimmed.startsWith("/")) return escapeHtml(trimmed);
+  try {
+    const url = new URL(trimmed);
+    return SAFE_LINK_SCHEMES.has(url.protocol) ? escapeHtml(url.toString()) : "#";
+  } catch {
+    return "#";
+  }
+}
+__name(safeHref, "safeHref");
+function preheaderOf(document) {
+  return document.preheader ?? document.paragraphs?.[0] ?? document.heading;
+}
+__name(preheaderOf, "preheaderOf");
+function paragraph(text, theme) {
+  return `<p style="margin:0 0 16px;font-size:16px;line-height:1.6;color:${theme.ink}">${escapeHtml(text)}</p>`;
+}
+__name(paragraph, "paragraph");
+function facts(rows, theme) {
+  if (rows.length === 0) return "";
+  const cells = rows.map((row, index) => {
+    const divider = index === 0 ? "" : `border-top:1px solid ${theme.border};`;
+    const value = row.emphasis ? `font-size:20px;font-weight:700;color:${theme.ink}` : `font-size:15px;color:${theme.ink}`;
+    return [
+      `<tr>`,
+      `<td style="${divider}padding:12px 0 12px 16px;font-size:13px;line-height:1.4;color:${theme.muted};text-transform:uppercase;letter-spacing:.4px;white-space:nowrap">${escapeHtml(row.label)}</td>`,
+      `<td align="right" style="${divider}padding:12px 16px 12px 0;line-height:1.4;${value}">${escapeHtml(row.value)}</td>`,
+      `</tr>`
+    ].join("");
+  }).join("");
+  return [
+    `<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate;background:${theme.page};border:1px solid ${theme.border};border-radius:10px;margin:0 0 24px">`,
+    cells,
+    `</table>`
+  ].join("");
+}
+__name(facts, "facts");
+function action(cta, theme) {
+  return [
+    `<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:8px 0 24px">`,
+    `<tr>`,
+    `<td align="center" bgcolor="${theme.accent}" style="border-radius:8px;background:${theme.accent}">`,
+    `<a href="${safeHref(cta.href)}" style="display:inline-block;padding:14px 32px;font-family:${EMAIL_FONT_STACK};font-size:16px;font-weight:600;line-height:1;color:${theme.onAccent};text-decoration:none;border-radius:8px">${escapeHtml(cta.label)}</a>`,
+    `</td>`,
+    `</tr>`,
+    `</table>`
+  ].join("");
+}
+__name(action, "action");
+function fallback(cta, chrome, theme) {
+  return [
+    `<p style="margin:0 0 8px;font-size:13px;line-height:1.5;color:${theme.muted}">${escapeHtml(chrome.fallbackHint)}</p>`,
+    `<p style="margin:0 0 24px;font-size:13px;line-height:1.5;word-break:break-all"><a href="${safeHref(cta.href)}" style="color:${theme.accent};text-decoration:underline">${escapeHtml(cta.href)}</a></p>`
+  ].join("");
+}
+__name(fallback, "fallback");
+function header(document, theme) {
+  return [
+    `<tr>`,
+    `<td style="padding:32px 40px 0">`,
+    `<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">`,
+    `<tr><td style="font-size:20px;font-weight:700;letter-spacing:-.2px;color:${theme.ink}">${escapeHtml(document.brand)}</td></tr>`,
+    `<tr><td style="padding-top:12px"><div style="height:3px;width:44px;background:${theme.rule};border-radius:2px;font-size:0;line-height:0">&nbsp;</div></td></tr>`,
+    `</table>`,
+    `</td>`,
+    `</tr>`
+  ].join("");
+}
+__name(header, "header");
+function footer(document, theme) {
+  const { chrome, brand } = document;
+  return [
+    `<tr>`,
+    `<td style="padding:0 40px 40px">`,
+    `<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">`,
+    `<tr><td style="border-top:1px solid ${theme.border};padding-top:20px">`,
+    `<p style="margin:0 0 6px;font-size:13px;line-height:1.5;color:${theme.muted}">${escapeHtml(chrome.tagline(brand))}</p>`,
+    `<p style="margin:0;font-size:12px;line-height:1.5;color:${theme.muted}">${escapeHtml(chrome.automated)}</p>`,
+    `</td></tr>`,
+    `</table>`,
+    `</td>`,
+    `</tr>`
+  ].join("");
+}
+__name(footer, "footer");
+function styleBlock() {
+  return [
+    `<style>`,
+    `@media only screen and (max-width:620px){`,
+    `.fp-card{width:100%!important;border-radius:0!important;border-left:0!important;border-right:0!important}`,
+    `.fp-pad{padding-left:24px!important;padding-right:24px!important}`,
+    `.fp-h1{font-size:22px!important}`,
+    `}`,
+    `</style>`
+  ].join("");
+}
+__name(styleBlock, "styleBlock");
+function renderEmailHtml(document) {
+  const theme = document.theme ?? NEUTRAL_EMAIL_THEME;
+  const body = [
+    `<h1 class="fp-h1" style="margin:0 0 16px;font-size:26px;line-height:1.25;font-weight:700;letter-spacing:-.3px;color:${theme.ink}">${escapeHtml(document.heading)}</h1>`,
+    ...(document.paragraphs ?? []).map((text) => paragraph(text, theme)),
+    facts(document.facts ?? [], theme),
+    ...document.action ? [action(document.action, theme)] : [],
+    ...document.action ? [fallback(document.action, document.chrome, theme)] : [],
+    ...(document.notes ?? []).map(
+      (note) => `<p style="margin:0 0 8px;font-size:13px;line-height:1.5;color:${theme.muted}">${escapeHtml(note)}</p>`
+    )
+  ].join("\n      ");
+  return `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="${escapeHtml(document.locale)}">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<meta name="x-apple-disable-message-reformatting" />
+<meta name="color-scheme" content="light" />
+<meta name="supported-color-schemes" content="light" />
+<title>${escapeHtml(document.subject)}</title>
+${styleBlock()}
+</head>
+<body style="margin:0;padding:0;background:${theme.page};font-family:${EMAIL_FONT_STACK};-webkit-font-smoothing:antialiased">
+<div style="display:none;max-height:0;overflow:hidden;opacity:0;mso-hide:all">${escapeHtml(preheaderOf(document))}</div>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:${theme.page}">
+<tr>
+<td align="center" style="padding:32px 12px">
+<table role="presentation" class="fp-card" width="${EMAIL_CONTENT_WIDTH}" cellpadding="0" cellspacing="0" border="0" style="width:${EMAIL_CONTENT_WIDTH}px;max-width:100%;background:${theme.surface};border:1px solid ${theme.border};border-radius:14px">
+${header(document, theme)}
+<tr>
+<td class="fp-pad" style="padding:24px 40px 8px">
+      ${body}
+</td>
+</tr>
+${footer(document, theme)}
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>`;
+}
+__name(renderEmailHtml, "renderEmailHtml");
+function renderEmail(document) {
+  return {
+    subject: document.subject,
+    html: renderEmailHtml(document),
+    text: renderEmailText(document)
+  };
+}
+__name(renderEmail, "renderEmail");
+
+export {
+  renderEmailText,
+  NEUTRAL_EMAIL_THEME,
+  EMAIL_FONT_STACK,
+  EMAIL_CONTENT_WIDTH,
+  safeHref,
+  renderEmailHtml,
+  renderEmail
+};
+//# sourceMappingURL=chunk-EKUSNUBT.js.map

package/dist/chunk-EKUSNUBT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/email/text.ts","../src/email/theme.ts","../src/email/template.ts"],"sourcesContent":["import type { EmailDocument } from './template';\n\n/**\n * The plain-text half.\n *\n * Not a courtesy. Every major spam filter scores a `text/html` part with no\n * `text/plain` twin, and a watch, a terminal client and a screen reader in\n * plain-text mode show this and nothing else.\n *\n * It renders from the SAME `EmailDocument` the HTML half does, which is the\n * property that matters: a line added to one is in the other, so the two cannot\n * drift. Its own module only because the HTML renderer is already a file's\n * worth of client workarounds — the seam is the output format, not the content.\n */\n\n/**\n * Render the document as the plain-text half.\n *\n * Not a courtesy. Every major spam filter scores a `text/html` part with no\n * `text/plain` twin, and a watch, a terminal client and a screen reader in\n * plain-text mode show this and nothing else. It is rendered from the SAME\n * object, so it cannot say less than the HTML does.\n */\nexport function renderEmailText(document: EmailDocument): string {\n  const blocks = [\n    document.heading,\n    \"\",\n    ...textParagraphs(document),\n    ...textFacts(document),\n    ...textAction(document),\n    ...textNotes(document),\n    \"--\",\n    document.chrome.tagline(document.brand),\n    document.chrome.automated,\n  ];\n  return `${blocks.join(\"\\n\").replace(/\\n{3,}/g, \"\\n\\n\").trimEnd()}\\n`;\n}\n\n/** One blank line after each paragraph, as prose reads. */\nfunction textParagraphs(document: EmailDocument): string[] {\n  return (document.paragraphs ?? []).flatMap((text) => [text, \"\"]);\n}\n\n/** `Label: value` per row, as a receipt is quoted back over the phone. */\nfunction textFacts(document: EmailDocument): string[] {\n  const rows = document.facts ?? [];\n  return rows.length === 0 ? [] : [...rows.map((f) => `${f.label}: ${f.value}`), \"\"];\n}\n\n/** The CTA as label + URL: a plain-text reader has no button to press. */\nfunction textAction(document: EmailDocument): string[] {\n  return document.action ? [`${document.action.label}: ${document.action.href}`, \"\"] : [];\n}\n\nfunction textNotes(document: EmailDocument): string[] {\n  const notes = document.notes ?? [];\n  return notes.length === 0 ? [] : [...notes, \"\"];\n}\n\n","/**\n * The layout's design tokens — the nine colours a mail is drawn from.\n *\n * ## Why a theme is a VALUE here and copy is required config\n *\n * The copy-portability doctrine is that a package ships no user-facing\n * sentences: a default in the origin host's language reads as finished to the\n * next host right up until somebody's customer gets mail in a language they do\n * not speak. Colour is not that. {@link NEUTRAL_EMAIL_THEME} is not anybody's\n * brand — it is grey on white, which reads as *unstyled but tidy* rather than\n * as *somebody else's product*. A host that passes nothing gets a mail that\n * looks plain, not a mail that looks like a different company.\n *\n * So this one has a default and the copy does not, and the difference is\n * exactly whether getting it wrong is invisible. A missing theme is visible in\n * the first preview; a wrong-language default is invisible until a customer\n * complains.\n *\n * ## What a host should know before overriding it\n *\n * Two rungs of most brand palettes cannot carry light text, and a mail has no\n * theme to fall back on when a client ignores a colour. {@link accent} is the\n * one that MUST clear 4.5:1 against white — it is the CTA fill and every link.\n * A warm mid-tone that looks fine on a screen at 2.6:1 is unreadable in an\n * inbox, and nothing in the pipeline will say so.\n */\nexport interface EmailTheme {\n  /** The page behind the card. Never pure white: a white card needs a ground. */\n  readonly page: string;\n  /** The card itself. */\n  readonly surface: string;\n  /** A quieter panel inside the card — the facts table. */\n  readonly panel: string;\n  /** Every hairline. */\n  readonly border: string;\n  /** Body text. */\n  readonly ink: string;\n  /** Secondary text: the footer, the fallback link, a fact's label. */\n  readonly muted: string;\n  /** The action colour — the CTA fill and every link. Must clear 4.5:1 on white. */\n  readonly accent: string;\n  /** Ink ON {@link accent}. */\n  readonly onAccent: string;\n  /** The rule under the wordmark. Decorative — nothing is written on it. */\n  readonly rule: string;\n}\n\n/**\n * A brand-free default: greys, one blue, nothing anybody would mistake for a\n * product. Every value clears its contrast requirement against its own ground.\n */\nexport const NEUTRAL_EMAIL_THEME: EmailTheme = {\n  page: '#F5F6F8',\n  surface: '#FFFFFF',\n  panel: '#F5F6F8',\n  border: '#E1E4E9',\n  ink: '#1A1D23',\n  muted: '#5C6470',\n  accent: '#1F5EDB',\n  onAccent: '#FFFFFF',\n  rule: '#1F5EDB',\n};\n\n/**\n * The font stack, as one string.\n *\n * System fonts only, and no web font: a `@font-face` is stripped by Gmail and\n * by Outlook, so a mail that depends on one renders in whatever the client\n * substitutes — never the fallback the designer chose. The stack ends in the\n * emoji faces so a status glyph in a subject line does not drop to a tofu box\n * on Windows.\n */\nexport const EMAIL_FONT_STACK =\n  \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji'\";\n\n/** The card's width. 600px is the width every client lays out without scroll. */\nexport const EMAIL_CONTENT_WIDTH = 600;\n","import { renderEmailText } from './text';\nimport {\n  EMAIL_CONTENT_WIDTH,\n  EMAIL_FONT_STACK,\n  NEUTRAL_EMAIL_THEME,\n  type EmailTheme,\n} from './theme';\n\n/**\n * THE transactional-mail layout: one document model, one HTML renderer, one\n * plain-text twin.\n *\n * ## The problem it exists for\n *\n * A host that sends mail from more than one place ends up rendering it in more\n * than one way — the notification pipeline emits a bold paragraph and a bare\n * anchor, the sign-in flow emits a `div` with a max-width, the receipt builds\n * its own list — and each grows its own `escapeHtml` and its own text twin. The\n * three look like three different products, because a paragraph with no\n * document around it inherits whatever the client decides: 13px Arial in Gmail,\n * Times New Roman in Outlook, no centring anywhere.\n *\n * That is a LAYOUT problem rather than a wording one, which is what makes it a\n * package's to solve. The words stay the host's; the document does not.\n *\n * ## Why the document is a MODEL and not a string\n *\n * Every caller hands over structure — a heading, some paragraphs, an optional\n * facts table, at most one call to action — and never markup. Three things fall\n * out of that, and each is a real defect in the hand-rolled renderers this\n * replaces:\n *\n * 1. **Escaping cannot be forgotten.** Every field is escaped here, once. Of\n *    the three renderers this was extracted from, two escaped the body and\n *    interpolated the LINK raw.\n * 2. **The plain-text twin cannot drift.** Both halves render from the same\n *    object, so a line added to one is in the other. A `text/html` part with no\n *    `text/plain` twin is scored by every major spam filter, and it is what a\n *    watch, a terminal client and a screen reader in plain-text mode show.\n * 3. **A preview is honest.** `./server`'s catalogue renders exactly this, from\n *    exactly these inputs, so a preview cannot be right about a mail nobody\n *    gets.\n *\n * ## The client constraints this encodes\n *\n * Stated once here, so no caller has to know them:\n *\n * - **Tables, not divs.** Outlook 2016+ on Windows lays HTML out with Word,\n *   which supports no `flex`, no `grid` and no reliable `max-width` on a block.\n *   A centred 600px table is the one construction every client agrees on.\n * - **Inline styles.** Gmail strips `<style>` from the document it renders in\n *   several contexts, and always in the Gmail app for a non-Gmail account. The\n *   `<style>` block below therefore carries only the mobile media query —\n *   progressive enhancement, never anything the layout depends on.\n * - **No web fonts, no `color-mix()`, no CSS variables.** See `./theme`.\n * - **A preheader.** The inbox list shows the first text in the body after the\n *   subject; without one it shows the footer's legal line.\n * - **`role=\"presentation\"`** on every layout table, so a screen reader reads\n *   the message rather than announcing a five-column grid.\n */\n\n/** The words the LAYOUT itself needs — never the message's own sentences. */\nexport interface EmailChromeCopy {\n  /** \"If the button does not work, paste this address into your browser:\" */\n  readonly fallbackHint: string;\n  /** \"This is an automated message — please do not reply.\" */\n  readonly automated: string;\n  /** The footer's one line about the product, given the brand name. */\n  readonly tagline: (brand: string) => string;\n}\n\n/** The one call to action a message may carry. More than one dilutes both. */\nexport interface EmailAction {\n  readonly label: string;\n  readonly href: string;\n}\n\n/** One row of the facts panel — a receipt's total, an order's reference. */\nexport interface EmailFact {\n  readonly label: string;\n  readonly value: string;\n  /** Renders bolder and larger — the one number the reader came for. */\n  readonly emphasis?: boolean;\n}\n\n/** Everything a message says, with no opinion about how it looks. */\nexport interface EmailDocument {\n  /** The subject line. Also the document `<title>`. */\n  readonly subject: string;\n  /**\n   * The inbox-list preview, ~90 chars. Falls back to the first paragraph,\n   * which is right far more often than it is wrong.\n   */\n  readonly preheader?: string;\n  /** The `<h1>`. Usually a restatement of the subject in the reader's terms. */\n  readonly heading: string;\n  /** The body, one entry per paragraph. Plain sentences — never markup. */\n  readonly paragraphs?: readonly string[];\n  /** An optional label/value panel under the body. */\n  readonly facts?: readonly EmailFact[];\n  /** At most one CTA. */\n  readonly action?: EmailAction;\n  /** Small print under the CTA — a deadline, a \"you can ignore this\". */\n  readonly notes?: readonly string[];\n  /**\n   * The layout's own words, in the recipient's language.\n   *\n   * REQUIRED, with no default in any language — the copy-portability doctrine.\n   * `@12-apps/notifications/email/locales` ships a pack per language and a host\n   * passes one BY\n   * NAME, which is a decision rather than a silence.\n   */\n  readonly chrome: EmailChromeCopy;\n  /**\n   * The product name in the header and the footer. REQUIRED: a package that\n   * defaulted this would sign another company's mail.\n   */\n  readonly brand: string;\n  /** The recipient's language, for the document's `lang` attribute. */\n  readonly locale: string;\n  /** Defaults to {@link NEUTRAL_EMAIL_THEME} — see `./theme` for why this one may. */\n  readonly theme?: EmailTheme;\n}\n\n/**\n * Escape everything that reaches the HTML body.\n *\n * A store name, a buyer's display name and a product title are all user input\n * that reaches a mail, and the ONE thing a shared layout must guarantee is that\n * none of them can close a tag. Single quotes are escaped too: attribute values\n * below are double-quoted, but a caller reading this should not have to check.\n */\nfunction escapeHtml(value: string): string {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&#39;\");\n}\n\n/**\n * The schemes a link in a mail may use.\n *\n * `javascript:` is inert in every mail client, so this is not the XSS guard it\n * would be on a page — it is the guard for the PREVIEW, which renders the same\n * HTML in a browser, and for the day some part of this markup is reused on a\n * screen. A rejected href drops to `#`, which fails visibly rather than\n * silently linking somewhere unexpected.\n */\nconst SAFE_LINK_SCHEMES = new Set([\"http:\", \"https:\", \"mailto:\"]);\n\n/** A URL as an attribute value, or `#` when it is not one this layout will emit. */\nexport function safeHref(href: string): string {\n  const trimmed = href.trim();\n  // A relative link is fine and common — every caller that has an origin\n  // resolves it before it gets here, and one that does not is better off with\n  // a path than with nothing.\n  if (trimmed.startsWith(\"/\")) return escapeHtml(trimmed);\n  try {\n    const url = new URL(trimmed);\n    return SAFE_LINK_SCHEMES.has(url.protocol) ? escapeHtml(url.toString()) : \"#\";\n  } catch {\n    return \"#\";\n  }\n}\n\n/** The message's own first sentence, when the caller named no preheader. */\nfunction preheaderOf(document: EmailDocument): string {\n  return document.preheader ?? document.paragraphs?.[0] ?? document.heading;\n}\n\n/** A `<td>` of body copy. One paragraph, at the layout's own rhythm. */\nfunction paragraph(text: string, theme: EmailTheme): string {\n  return `<p style=\"margin:0 0 16px;font-size:16px;line-height:1.6;color:${theme.ink}\">${escapeHtml(text)}</p>`;\n}\n\n/**\n * The facts panel — a receipt's four lines, an order's reference.\n *\n * Two cells per row rather than a definition list: `<dl>` is styled\n * inconsistently across clients and collapses to a single column in Outlook,\n * which is the one place these are read side by side.\n */\nfunction facts(rows: readonly EmailFact[], theme: EmailTheme): string {\n  if (rows.length === 0) return \"\";\n  const cells = rows\n    .map((row, index) => {\n      const divider =\n        index === 0 ? \"\" : `border-top:1px solid ${theme.border};`;\n      const value = row.emphasis\n        ? `font-size:20px;font-weight:700;color:${theme.ink}`\n        : `font-size:15px;color:${theme.ink}`;\n      return [\n        `<tr>`,\n        `<td style=\"${divider}padding:12px 0 12px 16px;font-size:13px;line-height:1.4;color:${theme.muted};text-transform:uppercase;letter-spacing:.4px;white-space:nowrap\">${escapeHtml(row.label)}</td>`,\n        `<td align=\"right\" style=\"${divider}padding:12px 16px 12px 0;line-height:1.4;${value}\">${escapeHtml(row.value)}</td>`,\n        `</tr>`,\n      ].join(\"\");\n    })\n    .join(\"\");\n  return [\n    `<table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\" style=\"border-collapse:separate;background:${theme.page};border:1px solid ${theme.border};border-radius:10px;margin:0 0 24px\">`,\n    cells,\n    `</table>`,\n  ].join(\"\");\n}\n\n/**\n * The CTA.\n *\n * A single-cell table with `bgcolor` AND a background style: Outlook reads the\n * attribute and ignores the property, every other client does the reverse, and\n * a button that loses its fill is invisible ink on white. `border-radius` is\n * simply dropped by Word — a square button is the accepted degradation, and the\n * alternative (a VML rounded rectangle) is forty lines of conditional comment\n * that then has to be kept in step with the colour.\n */\nfunction action(cta: EmailAction, theme: EmailTheme): string {\n  return [\n    `<table role=\"presentation\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\" style=\"margin:8px 0 24px\">`,\n    `<tr>`,\n    `<td align=\"center\" bgcolor=\"${theme.accent}\" style=\"border-radius:8px;background:${theme.accent}\">`,\n    `<a href=\"${safeHref(cta.href)}\" style=\"display:inline-block;padding:14px 32px;font-family:${EMAIL_FONT_STACK};font-size:16px;font-weight:600;line-height:1;color:${theme.onAccent};text-decoration:none;border-radius:8px\">${escapeHtml(cta.label)}</a>`,\n    `</td>`,\n    `</tr>`,\n    `</table>`,\n  ].join(\"\");\n}\n\n/**\n * The \"paste this address\" fallback, printed whenever there is a CTA.\n *\n * Not optional, and the reason is measured elsewhere in this repo: corporate\n * mail gateways rewrite link targets, and a reader whose gateway mangles the\n * button has no other way to reach a verification or reset link. `word-break`\n * because a signed URL is longer than the card.\n */\nfunction fallback(cta: EmailAction, chrome: EmailChromeCopy, theme: EmailTheme): string {\n  return [\n    `<p style=\"margin:0 0 8px;font-size:13px;line-height:1.5;color:${theme.muted}\">${escapeHtml(chrome.fallbackHint)}</p>`,\n    `<p style=\"margin:0 0 24px;font-size:13px;line-height:1.5;word-break:break-all\"><a href=\"${safeHref(cta.href)}\" style=\"color:${theme.accent};text-decoration:underline\">${escapeHtml(cta.href)}</a></p>`,\n  ].join(\"\");\n}\n\n/** The brand header: wordmark over the ramp's rule. */\nfunction header(document: EmailDocument, theme: EmailTheme): string {\n  return [\n    `<tr>`,\n    `<td style=\"padding:32px 40px 0\">`,\n    `<table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\">`,\n    `<tr><td style=\"font-size:20px;font-weight:700;letter-spacing:-.2px;color:${theme.ink}\">${escapeHtml(document.brand)}</td></tr>`,\n    `<tr><td style=\"padding-top:12px\"><div style=\"height:3px;width:44px;background:${theme.rule};border-radius:2px;font-size:0;line-height:0\">&nbsp;</div></td></tr>`,\n    `</table>`,\n    `</td>`,\n    `</tr>`,\n  ].join(\"\");\n}\n\n/** The footer: the tagline, the \"do not reply\" line, and nothing else. */\nfunction footer(document: EmailDocument, theme: EmailTheme): string {\n  const { chrome, brand } = document;\n  return [\n    `<tr>`,\n    `<td style=\"padding:0 40px 40px\">`,\n    `<table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\">`,\n    `<tr><td style=\"border-top:1px solid ${theme.border};padding-top:20px\">`,\n    `<p style=\"margin:0 0 6px;font-size:13px;line-height:1.5;color:${theme.muted}\">${escapeHtml(chrome.tagline(brand))}</p>`,\n    `<p style=\"margin:0;font-size:12px;line-height:1.5;color:${theme.muted}\">${escapeHtml(chrome.automated)}</p>`,\n    `</td></tr>`,\n    `</table>`,\n    `</td>`,\n    `</tr>`,\n  ].join(\"\");\n}\n\n/**\n * The mobile media query — the one thing in a `<style>` block.\n *\n * Everything it does is also correct without it: the card is already\n * `width:100%` up to 600px, so a client that strips this renders a slightly\n * roomier mail rather than a broken one. That is the test for whether a rule\n * belongs here at all.\n */\nfunction styleBlock(): string {\n  return [\n    `<style>`,\n    `@media only screen and (max-width:620px){`,\n    `.fp-card{width:100%!important;border-radius:0!important;border-left:0!important;border-right:0!important}`,\n    `.fp-pad{padding-left:24px!important;padding-right:24px!important}`,\n    `.fp-h1{font-size:22px!important}`,\n    `}`,\n    `</style>`,\n  ].join(\"\");\n}\n\n/**\n * Render the document as the HTML half of the message.\n *\n * A complete document rather than a fragment: a `<!DOCTYPE>` is what puts\n * Outlook into standards mode, and `x-apple-disable-message-reformatting` is\n * what stops iOS Mail re-flowing the card to the screen width and shrinking the\n * type with it.\n */\nexport function renderEmailHtml(document: EmailDocument): string {\n  const theme = document.theme ?? NEUTRAL_EMAIL_THEME;\n  const body = [\n    `<h1 class=\"fp-h1\" style=\"margin:0 0 16px;font-size:26px;line-height:1.25;font-weight:700;letter-spacing:-.3px;color:${theme.ink}\">${escapeHtml(document.heading)}</h1>`,\n    ...(document.paragraphs ?? []).map((text) => paragraph(text, theme)),\n    facts(document.facts ?? [], theme),\n    ...(document.action ? [action(document.action, theme)] : []),\n    ...(document.action ? [fallback(document.action, document.chrome, theme)] : []),\n    ...(document.notes ?? []).map(\n      (note) =>\n        `<p style=\"margin:0 0 8px;font-size:13px;line-height:1.5;color:${theme.muted}\">${escapeHtml(note)}</p>`,\n    ),\n  ].join(\"\\n      \");\n\n  return `<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n<html xmlns=\"http://www.w3.org/1999/xhtml\" lang=\"${escapeHtml(document.locale)}\">\n<head>\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<meta name=\"x-apple-disable-message-reformatting\" />\n<meta name=\"color-scheme\" content=\"light\" />\n<meta name=\"supported-color-schemes\" content=\"light\" />\n<title>${escapeHtml(document.subject)}</title>\n${styleBlock()}\n</head>\n<body style=\"margin:0;padding:0;background:${theme.page};font-family:${EMAIL_FONT_STACK};-webkit-font-smoothing:antialiased\">\n<div style=\"display:none;max-height:0;overflow:hidden;opacity:0;mso-hide:all\">${escapeHtml(preheaderOf(document))}</div>\n<table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\" style=\"background:${theme.page}\">\n<tr>\n<td align=\"center\" style=\"padding:32px 12px\">\n<table role=\"presentation\" class=\"fp-card\" width=\"${EMAIL_CONTENT_WIDTH}\" cellpadding=\"0\" cellspacing=\"0\" border=\"0\" style=\"width:${EMAIL_CONTENT_WIDTH}px;max-width:100%;background:${theme.surface};border:1px solid ${theme.border};border-radius:14px\">\n${header(document, theme)}\n<tr>\n<td class=\"fp-pad\" style=\"padding:24px 40px 8px\">\n      ${body}\n</td>\n</tr>\n${footer(document, theme)}\n</table>\n</td>\n</tr>\n</table>\n</body>\n</html>`;\n}\n\n/** Both halves plus the subject — what every driver in this repo is handed. */\nexport interface RenderedEmail {\n  readonly subject: string;\n  readonly html: string;\n  readonly text: string;\n}\n\n/** Render one document into the message shape `EmailDriver.send` takes. */\nexport function renderEmail(document: EmailDocument): RenderedEmail {\n  return {\n    subject: document.subject,\n    html: renderEmailHtml(document),\n    text: renderEmailText(document),\n  };\n}\n"],"mappings":"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","names":[]}