@ultimat3/mail 1.0.0 → 1.2.0

package/src/job.d.ts

@@ -1,17 +0,0 @@
-import { type JobHandle } from '@ultimat3/jobs';
-import { type StandardSchemaV1 } from '@ultimat3/schema';
-import { type MailMessage } from './driver';
-/** The queue payload is the already-rendered envelope: rendering happens once, at send time. */
-export declare const mailMessageSchema: StandardSchemaV1<unknown, MailMessage>;
-/**
- * `(mailId, recipients, hash(rendered payload))`, or the caller's key when supplied.
- * Content-derived on purpose: a retry of the same request produces the same key, while an
- * intentional resend with different content produces a different one.
- */
-export declare function mailIdempotencyKey(message: MailMessage): string;
-/**
- * Five attempts with exponential backoff: transient 4xx/greylisting clears in minutes, and a
- * hard bounce still lands in the dead-letter queue where `x jobs dead --json` can show it.
- */
-export declare const sendMailJob: JobHandle<MailMessage>;
-//# sourceMappingURL=job.d.ts.map

package/src/job.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["job.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAO,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,KAAK,gBAAgB,EAAK,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,KAAK,WAAW,EAA+B,MAAM,UAAU,CAAC;AAEzE,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAanE,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAiB/D;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,WAAW,CAM7C,CAAC"}

package/src/job.js

@@ -1,79 +0,0 @@
-// Single responsibility: delivering a rendered message is background work, never request work.
-// A slow SMTP host must not hold a request open, and at-least-once delivery must not mean two
-// welcome emails — so the send is a `job` with a content-derived idempotency key.
-import { job } from '@ultimat3/jobs';
-import { t } from '@ultimat3/schema';
-import { mailDriver } from './driver';
-/** The queue payload is the already-rendered envelope: rendering happens once, at send time. */
-export const mailMessageSchema = t.object({
-    mailId: t.string,
-    to: t.array(t.email),
-    subject: t.string,
-    html: t.string,
-    text: t.string,
-    locale: t.locale,
-    tz: t.timezone,
-    replyTo: t.email.optional(),
-    cc: t.array(t.email).optional(),
-    bcc: t.array(t.email).optional(),
-    unsubscribeUrl: t.url.optional(),
-    idempotencyKey: t.string.optional(),
-});
-/**
- * `(mailId, recipients, hash(rendered payload))`, or the caller's key when supplied.
- * Content-derived on purpose: a retry of the same request produces the same key, while an
- * intentional resend with different content produces a different one.
- */
-export function mailIdempotencyKey(message) {
-    const explicit = message.idempotencyKey;
-    if (explicit !== undefined && explicit !== '')
-        return `mail:${explicit}`;
-    const recipients = [...message.to].map((address) => address.toLowerCase()).sort();
-    const digest = fnv1a32(stableStringify({
-        subject: message.subject,
-        html: message.html,
-        text: message.text,
-        cc: message.cc ?? [],
-        bcc: message.bcc ?? [],
-        locale: message.locale,
-        tz: message.tz,
-        unsubscribeUrl: message.unsubscribeUrl ?? '',
-    }));
-    return `mail:${message.mailId}:${recipients.join(',')}:${digest}`;
-}
-/**
- * Five attempts with exponential backoff: transient 4xx/greylisting clears in minutes, and a
- * hard bounce still lands in the dead-letter queue where `x jobs dead --json` can show it.
- */
-export const sendMailJob = job({
-    name: 'mail.send',
-    input: mailMessageSchema,
-    idempotencyKey: mailIdempotencyKey,
-    retry: { attempts: 5, backoff: 'exponential' },
-    run: ({ input }) => mailDriver().send(input),
-});
-/** Key order is normalised so two structurally equal payloads hash identically. */
-function stableStringify(value) {
-    if (Array.isArray(value))
-        return `[${value.map(stableStringify).join(',')}]`;
-    if (value !== null && typeof value === 'object') {
-        const entries = Object.entries(value)
-            .filter(([, entry]) => entry !== undefined)
-            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
-            .map(([key, entry]) => `${JSON.stringify(key)}:${stableStringify(entry)}`);
-        return `{${entries.join(',')}}`;
-    }
-    if (value === undefined)
-        return 'null';
-    return JSON.stringify(value);
-}
-/** FNV-1a, 32-bit. Not a security hash — a short, dependency-free, stable content id. */
-function fnv1a32(input) {
-    let hash = 0x811c9dc5;
-    for (let index = 0; index < input.length; index += 1) {
-        hash ^= input.charCodeAt(index);
-        hash = Math.imul(hash, 0x01000193) >>> 0;
-    }
-    return hash.toString(16).padStart(8, '0');
-}
-//# sourceMappingURL=job.js.map

package/src/job.js.map

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

package/src/layout.d.ts

@@ -1,41 +0,0 @@
-export type ColorScheme = 'light' | 'dark';
-export type MailToken = 'pageBg' | 'surfaceBg' | 'textPrimary' | 'textMuted' | 'borderSubtle' | 'accentBg' | 'accentText' | 'linkText' | 'calloutInfoBg' | 'calloutInfoText' | 'calloutDangerBg' | 'calloutDangerText';
-export declare const MAIL_TOKENS: Readonly<Record<MailToken, Readonly<Record<ColorScheme, string>>>>;
-/** Resolve a token to a hex value. The only function in the package that returns a colour. */
-export declare function token(name: MailToken, scheme?: ColorScheme): string;
-export declare const MAIL_FONT_STACK = "-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif";
-export declare const MAIL_WIDTH_PX = 600;
-/** A node's dark-mode role: which CSS property takes which token when the client is dark. */
-export type DarkRule = readonly [role: string, declarations: readonly [string, MailToken][]];
-/**
- * Dark overrides key off short `data-x` role codes rather than class names: base styling
- * stays fully inlined for the clients that strip <style>, and the codes are deliberately
- * not token names, so nothing leaks the design vocabulary into delivered HTML.
- */
-export declare const DARK_RULES: readonly DarkRule[];
-/** The one `prefers-color-scheme` block. Clients that ignore it keep the inlined light theme. */
-export declare function darkModeCss(): string;
-export interface UnsubscribeSlot {
-    /** Already translated — the layout never touches a catalog. */
-    readonly label: string;
-    readonly url: string;
-}
-export interface LayoutInput {
-    readonly subject: string;
-    /** Hidden preview text. Clients show it next to the subject in the inbox list. */
-    readonly preheader: string;
-    /** Rendered block HTML. */
-    readonly content: string;
-    readonly footer: readonly string[];
-    readonly unsubscribe?: UnsubscribeSlot | undefined;
-    readonly locale: string;
-    readonly direction: 'ltr' | 'rtl';
-}
-export type MailLayout = (input: LayoutInput) => string;
-export declare const BASE_LAYOUT = "base";
-/** The framework's only layout. Apps register their own with `registerLayout`. */
-export declare const baseLayout: MailLayout;
-export declare function registerLayout(name: string, layout: MailLayout): void;
-export declare function layoutFor(name: string): MailLayout | undefined;
-export declare function registeredLayouts(): readonly string[];
-//# sourceMappingURL=layout.d.ts.map

package/src/layout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["layout.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,WAAW,GACX,aAAa,GACb,WAAW,GACX,cAAc,GACd,UAAU,GACV,YAAY,GACZ,UAAU,GACV,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,CAAC;AAExB,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAcvF,CAAC;AAEL,8FAA8F;AAC9F,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,WAAqB,GAAG,MAAM,CAE5E;AAED,eAAO,MAAM,eAAe,gFACmD,CAAC;AAEhF,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;AAE7F;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAmCzC,CAAC;AAEF,iGAAiG;AACjG,wBAAgB,WAAW,IAAI,MAAM,CAQpC;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAC;AAExD,eAAO,MAAM,WAAW,SAAS,CAAC;AA6ClC,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,UAwBjB,CAAC;AAeT,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAErE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE9D;AAED,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD"}

package/src/layout.js

@@ -1,160 +0,0 @@
-// Single responsibility: the base email layout and the semantic colour tokens every block
-// resolves through. Colours are declared once here (light + dark) and inlined by the
-// renderer, because email clients drop <style> and templates must never carry a raw hex.
-// Table-based and 600px wide: Outlook still renders with Word's HTML engine.
-import { escapeHtml, safeUrl, styleAttr } from './html';
-export const MAIL_TOKENS = Object.freeze({
-    pageBg: { light: '#f4f5f7', dark: '#0b0d10' },
-    surfaceBg: { light: '#ffffff', dark: '#14181d' },
-    textPrimary: { light: '#16191d', dark: '#e7eaee' },
-    textMuted: { light: '#5c6470', dark: '#9aa4b1' },
-    borderSubtle: { light: '#e2e6ea', dark: '#262c33' },
-    accentBg: { light: '#2f6df6', dark: '#4f86ff' },
-    accentText: { light: '#ffffff', dark: '#0b0d10' },
-    linkText: { light: '#2f6df6', dark: '#7aa7ff' },
-    calloutInfoBg: { light: '#eef3ff', dark: '#141c2c' },
-    calloutInfoText: { light: '#1f3f8f', dark: '#b9cdfb' },
-    calloutDangerBg: { light: '#fdeceb', dark: '#2a1416' },
-    calloutDangerText: { light: '#8c2118', dark: '#f5b3ad' },
-});
-/** Resolve a token to a hex value. The only function in the package that returns a colour. */
-export function token(name, scheme = 'light') {
-    return MAIL_TOKENS[name][scheme];
-}
-export const MAIL_FONT_STACK = '-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif';
-export const MAIL_WIDTH_PX = 600;
-/**
- * Dark overrides key off short `data-x` role codes rather than class names: base styling
- * stays fully inlined for the clients that strip <style>, and the codes are deliberately
- * not token names, so nothing leaks the design vocabulary into delivered HTML.
- */
-export const DARK_RULES = [
-    ['page', [['background-color', 'pageBg']]],
-    [
-        'card',
-        [
-            ['background-color', 'surfaceBg'],
-            ['border-color', 'borderSubtle'],
-        ],
-    ],
-    ['h', [['color', 'textPrimary']]],
-    ['p', [['color', 'textPrimary']]],
-    ['mut', [['color', 'textMuted']]],
-    [
-        'btn',
-        [
-            ['background-color', 'accentBg'],
-            ['color', 'accentText'],
-        ],
-    ],
-    ['hr', [['border-top-color', 'borderSubtle']]],
-    ['a', [['color', 'linkText']]],
-    [
-        'ci',
-        [
-            ['background-color', 'calloutInfoBg'],
-            ['color', 'calloutInfoText'],
-        ],
-    ],
-    [
-        'cd',
-        [
-            ['background-color', 'calloutDangerBg'],
-            ['color', 'calloutDangerText'],
-        ],
-    ],
-];
-/** The one `prefers-color-scheme` block. Clients that ignore it keep the inlined light theme. */
-export function darkModeCss() {
-    const rules = DARK_RULES.map(([role, declarations]) => {
-        const body = declarations
-            .map(([property, name]) => `${property}:${token(name, 'dark')}!important`)
-            .join(';');
-        return `[data-x="${role}"]{${body}}`;
-    });
-    return `@media (prefers-color-scheme:dark){${rules.join('')}}`;
-}
-export const BASE_LAYOUT = 'base';
-const BODY_STYLE = styleAttr([
-    'margin:0',
-    'padding:0',
-    'width:100%',
-    `background-color:${token('pageBg')}`,
-    `font-family:${MAIL_FONT_STACK}`,
-    `color:${token('textPrimary')}`,
-    '-webkit-font-smoothing:antialiased',
-]);
-const PREHEADER_STYLE = styleAttr([
-    'display:none',
-    'font-size:1px',
-    'line-height:1px',
-    'max-height:0',
-    'max-width:0',
-    'opacity:0',
-    'overflow:hidden',
-    'mso-hide:all',
-]);
-const PAGE_STYLE = styleAttr([`background-color:${token('pageBg')}`, 'width:100%']);
-const GUTTER_STYLE = styleAttr(['padding:24px 12px']);
-const SHELL_STYLE = styleAttr([`width:${MAIL_WIDTH_PX}px`, 'max-width:100%']);
-const CARD_STYLE = styleAttr([
-    `background-color:${token('surfaceBg')}`,
-    `border:1px solid ${token('borderSubtle')}`,
-    'border-radius:12px',
-    'padding:32px',
-]);
-const FOOTER_STYLE = styleAttr([
-    `color:${token('textMuted')}`,
-    'font-size:12px',
-    'line-height:18px',
-    'padding:16px 8px 32px 8px',
-]);
-const UNSUBSCRIBE_STYLE = styleAttr([`color:${token('textMuted')}`, 'text-decoration:underline']);
-const TABLE_ATTRS = 'role="presentation" cellpadding="0" cellspacing="0" border="0"';
-/** The framework's only layout. Apps register their own with `registerLayout`. */
-export const baseLayout = (input) => `<!doctype html>
-<html lang="${escapeHtml(input.locale)}" dir="${input.direction}">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<meta http-equiv="x-ua-compatible" content="ie=edge">
-<meta name="color-scheme" content="light dark">
-<meta name="supported-color-schemes" content="light dark">
-<meta name="format-detection" content="telephone=no,date=no,address=no,email=no">
-<meta name="x-apple-disable-message-reformatting">
-<title>${escapeHtml(input.subject)}</title>
-<style>${darkModeCss()}</style>
-</head>
-<body ${BODY_STYLE} data-x="page">
-<div ${PREHEADER_STYLE}>${escapeHtml(input.preheader)}</div>
-<table ${TABLE_ATTRS} width="100%" data-x="page" ${PAGE_STYLE}>
-<tr><td align="center" ${GUTTER_STYLE}>
-<table ${TABLE_ATTRS} width="${MAIL_WIDTH_PX}" ${SHELL_STYLE}>
-<tr><td data-x="card" ${CARD_STYLE}>${input.content}</td></tr>
-<tr><td data-x="mut" ${FOOTER_STYLE}>${footerHtml(input)}</td></tr>
-</table>
-</td></tr>
-</table>
-</body>
-</html>`;
-function footerHtml(input) {
-    const lines = input.footer.map((line) => `<div>${escapeHtml(line)}</div>`);
-    const slot = input.unsubscribe;
-    if (slot !== undefined) {
-        const href = escapeHtml(safeUrl(slot.url));
-        const label = escapeHtml(slot.label);
-        lines.push(`<div><a data-x="a" href="${href}" ${UNSUBSCRIBE_STYLE}>${label}</a></div>`);
-    }
-    return lines.join('');
-}
-const layouts = new Map([[BASE_LAYOUT, baseLayout]]);
-export function registerLayout(name, layout) {
-    layouts.set(name, layout);
-}
-export function layoutFor(name) {
-    return layouts.get(name);
-}
-export function registeredLayouts() {
-    return [...layouts.keys()].sort();
-}
-//# sourceMappingURL=layout.js.map

package/src/layout.js.map

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

package/src/mail.d.ts

@@ -1,67 +0,0 @@
-import { type StandardSchemaV1 } from '@ultimat3/schema';
-import type { MailTemplate } from './blocks';
-import { type MailMessage, type SendResult } from './driver';
-import { type RenderableMail } from './render';
-export interface MailDefinition<I> extends RenderableMail<I> {
-    readonly id: string;
-    /** An i18n key, never a literal subject line. */
-    readonly subject: string;
-    readonly template: MailTemplate<I>;
-    readonly input: StandardSchemaV1<unknown, I>;
-    readonly layout: string;
-}
-export interface MailInit<I> {
-    readonly id: string;
-    readonly subject: string;
-    readonly template: MailTemplate<I>;
-    readonly input: StandardSchemaV1<unknown, I>;
-    /** Defaults to the framework's `base` layout. */
-    readonly layout?: string | undefined;
-}
-export interface SendOptions {
-    readonly to: string | readonly string[];
-    /** BCP-47. Required — there is no ambient fallback for a message the user reads later. */
-    readonly locale: string;
-    /** IANA zone for every date in the body. Defaults to the request context, then UTC. */
-    readonly tz?: string | undefined;
-    readonly replyTo?: string | undefined;
-    readonly cc?: readonly string[] | undefined;
-    readonly bcc?: readonly string[] | undefined;
-    readonly unsubscribeUrl?: string | undefined;
-    readonly idempotencyKey?: string | undefined;
-    /** Deliver inline instead of through the queue. Tests and CLI one-shots only. */
-    readonly sync?: boolean | undefined;
-}
-/**
- * The registry erases the payload type so heterogeneous mails share one map. `template`
- * stays assignable because `never` flows into any `TemplateArgs<I>`; `input` widens to
- * `unknown` on the output side, which is exactly what `parse` re-establishes at send time.
- */
-export interface AnyMailDefinition {
-    readonly id: string;
-    readonly subject: string;
-    readonly layout: string;
-    readonly input: StandardSchemaV1<unknown, unknown>;
-    readonly template: MailTemplate<never>;
-}
-export declare function defineMail<I>(init: MailInit<I>): MailDefinition<I>;
-export declare function mailFor(id: string): AnyMailDefinition | undefined;
-export declare function registeredMails(): readonly AnyMailDefinition[];
-export declare function registeredMailIds(): readonly string[];
-/** Test/CLI seam: drop every registered mail. */
-export declare function resetMails(): void;
-/**
- * Validate, render, and build the envelope — everything `send` does before it decides
- * between the queue and the transport. Exported so `x mail preview` and tests can render
- * without delivering anything.
- */
-export declare function renderMessage<I>(mail: MailDefinition<I>, data: I, options: SendOptions): MailMessage;
-/**
- * Enqueues by default so a slow SMTP host never blocks a request. Falls back to an inline
- * send when no job driver is configured (a script, a test, `x` one-shots) — the alternative
- * would be silently dropping mail in exactly the setups where it is easiest to miss.
- */
-export declare function send<I>(mail: MailDefinition<I>, data: I, options: SendOptions): Promise<SendResult>;
-/** Send by id — what the CLI, MCP tools and generated code use. `data` is parsed, not trusted. */
-export declare function sendById(id: string, data: unknown, options: SendOptions): Promise<SendResult>;
-//# sourceMappingURL=mail.d.ts.map

package/src/mail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["mail.ts"],"names":[],"mappings":"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"}

package/src/mail.js

@@ -1,119 +0,0 @@
-// Single responsibility: the `defineMail` primitive, the mail registry, and `send`.
-// `locale` is required by the TYPE, not by a runtime check alone: an email in the wrong
-// language is a real, unnoticed production bug, and the ambient request locale is the one
-// piece of context that a background send cannot recover after the fact.
-import { assert, DEFAULT_TIME_ZONE, tryUseContext } from '@ultimat3/core';
-import { jobDriver } from '@ultimat3/jobs';
-import { parse } from '@ultimat3/schema';
-import { mailDriver } from './driver';
-import { localeMissing, mailDuplicate, templateUnknown } from './errors';
-import { mailIdempotencyKey, sendMailJob } from './job';
-import { BASE_LAYOUT } from './layout';
-import { renderMail } from './render';
-const registry = new Map();
-export function defineMail(init) {
-    if (registry.has(init.id))
-        throw mailDuplicate(init.id);
-    const definition = {
-        id: init.id,
-        subject: init.subject,
-        template: init.template,
-        input: init.input,
-        layout: init.layout ?? BASE_LAYOUT,
-    };
-    registry.set(init.id, definition);
-    return definition;
-}
-export function mailFor(id) {
-    return registry.get(id);
-}
-export function registeredMails() {
-    return [...registry.values()].sort((a, b) => a.id.localeCompare(b.id));
-}
-export function registeredMailIds() {
-    return [...registry.keys()].sort();
-}
-/** Test/CLI seam: drop every registered mail. */
-export function resetMails() {
-    registry.clear();
-}
-/**
- * Validate, render, and build the envelope — everything `send` does before it decides
- * between the queue and the transport. Exported so `x mail preview` and tests can render
- * without delivering anything.
- */
-export function renderMessage(mail, data, options) {
-    assertLocale(mail.id, options.locale);
-    if (registry.get(mail.id) === undefined)
-        throw templateUnknown(mail.id, registeredMailIds());
-    const to = typeof options.to === 'string' ? [options.to] : [...options.to];
-    assert(to.length > 0, `send(${mail.id}, ...) was called with an empty recipient list`, 'pass { to: user.email } — one address, or a non-empty array of addresses');
-    const input = parse(mail.input, data, `${mail.id}.input`);
-    const tz = options.tz ?? tryUseContext()?.tz ?? DEFAULT_TIME_ZONE;
-    const rendered = renderMail(mail, input, {
-        locale: options.locale,
-        tz,
-        unsubscribeUrl: options.unsubscribeUrl,
-    });
-    return {
-        mailId: mail.id,
-        to,
-        subject: rendered.subject,
-        html: rendered.html,
-        text: rendered.text,
-        locale: options.locale,
-        tz,
-        replyTo: options.replyTo,
-        cc: options.cc,
-        bcc: options.bcc,
-        unsubscribeUrl: options.unsubscribeUrl,
-        idempotencyKey: options.idempotencyKey,
-    };
-}
-/**
- * Enqueues by default so a slow SMTP host never blocks a request. Falls back to an inline
- * send when no job driver is configured (a script, a test, `x` one-shots) — the alternative
- * would be silently dropping mail in exactly the setups where it is easiest to miss.
- */
-export async function send(mail, data, options) {
-    const message = renderMessage(mail, data, options);
-    const key = mailIdempotencyKey(message);
-    const queue = jobDriver();
-    if (options.sync === true || queue === undefined) {
-        // The key is reported even inline, so a caller can dedupe its own retries either way.
-        return { ...(await mailDriver().send(message)), idempotencyKey: key };
-    }
-    const enqueued = await queue.enqueue({
-        name: sendMailJob.name,
-        queue: sendMailJob.queue,
-        input: message,
-        idempotencyKey: key,
-        maxAttempts: sendMailJob.retry.attempts,
-        onConflict: 'dedupe',
-    });
-    return {
-        id: enqueued.id,
-        driver: 'queue',
-        accepted: [...message.to, ...(message.cc ?? []), ...(message.bcc ?? [])],
-        queued: true,
-        idempotencyKey: key,
-    };
-}
-/** Send by id — what the CLI, MCP tools and generated code use. `data` is parsed, not trusted. */
-export async function sendById(id, data, options) {
-    const mail = registry.get(id);
-    if (mail === undefined)
-        throw templateUnknown(id, registeredMailIds());
-    // The one cast in the package: the registry erased `I`, and `send` re-parses `data`
-    // through the mail's own schema before it reaches the template.
-    return await send(mail, data, options);
-}
-/**
- * The runtime backstop for JS callers and generated code — TypeScript already forbids
- * omitting `locale`, so reaching this throw means the type was cast away somewhere.
- */
-function assertLocale(mailId, locale) {
-    if (typeof locale !== 'string' || locale.trim() === '')
-        throw localeMissing(mailId);
-}
-//# sourceMappingURL=mail.js.map

package/src/mail.js.map

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

package/src/render.d.ts

@@ -1,26 +0,0 @@
-import { type Translator } from '@ultimat3/i18n';
-import type { MailBlock, MailTemplate } from './blocks';
-/** What the renderer needs from a mail. `MailDefinition` adds the input schema on top. */
-export interface RenderableMail<I> {
-    readonly id: string;
-    readonly subject: string;
-    readonly template: MailTemplate<I>;
-    readonly layout: string;
-}
-export interface RenderOptions {
-    readonly locale: string;
-    readonly tz: string;
-    readonly unsubscribeUrl?: string | undefined;
-}
-export interface RenderedMail {
-    readonly subject: string;
-    readonly preheader: string;
-    readonly html: string;
-    readonly text: string;
-}
-export declare const FOOTER_KEYS: readonly ['mail.footer.legal', 'mail.footer.help'];
-export declare const UNSUBSCRIBE_KEY = "mail.footer.unsubscribe";
-export declare function renderMail<I>(mail: RenderableMail<I>, data: I, options: RenderOptions): RenderedMail;
-/** The text part, block by block. Never derived from the HTML. */
-export declare function textOf(list: readonly MailBlock[], t: Translator): string;
-//# sourceMappingURL=render.d.ts.map

package/src/render.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,UAAU,EAAiB,MAAM,gBAAgB,CAAC;AACjG,OAAO,KAAK,EAAe,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAKrE,0FAA0F;AAC1F,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,WAAW,YAAI,mBAAmB,EAAE,kBAAkB,CAAU,CAAC;AAC9E,eAAO,MAAM,eAAe,4BAA4B,CAAC;AAEzD,wBAAgB,UAAU,CAAC,CAAC,EAC1B,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,GACrB,YAAY,CAmCd;AAED,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAoBxE"}