@ultimat3/mail 1.0.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/mail",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Transactional email as data: one template renders HTML and text, sent through a job.",
   "license": "MIT",
   "type": "module",
@@ -30,10 +30,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "1.0.0",
-    "@ultimat3/i18n": "1.0.0",
-    "@ultimat3/jobs": "1.0.0",
-    "@ultimat3/schema": "1.0.0",
-    "@ultimat3/time": "1.0.0"
+    "@ultimat3/core": "1.2.0",
+    "@ultimat3/i18n": "1.2.0",
+    "@ultimat3/jobs": "1.2.0",
+    "@ultimat3/schema": "1.2.0",
+    "@ultimat3/time": "1.2.0"
   }
 }

package/src/blocks.d.ts

@@ -1,47 +0,0 @@
-import type { TranslateVars, Translator } from '@ultimat3/i18n';
-export type CalloutTone = 'info' | 'danger';
-export type MailBlock = {
-    readonly kind: 'heading';
-    readonly key: string;
-    readonly vars?: TranslateVars | undefined;
-} | {
-    readonly kind: 'paragraph';
-    readonly key: string;
-    readonly vars?: TranslateVars | undefined;
-} | {
-    readonly kind: 'button';
-    readonly key: string;
-    readonly href: string;
-    readonly vars?: TranslateVars | undefined;
-} | {
-    readonly kind: 'callout';
-    readonly key: string;
-    readonly tone: CalloutTone;
-    readonly vars?: TranslateVars | undefined;
-}
-/** A label key plus an already-localised value (a date, an IP, a method name). */
- | {
-    readonly kind: 'detail';
-    readonly key: string;
-    readonly value: string;
-} | {
-    readonly kind: 'divider';
-};
-/** Block constructors, so a template never hand-writes an object literal or a colour. */
-export declare const blocks: Readonly<{
-    heading: (key: string, vars?: TranslateVars) => MailBlock;
-    paragraph: (key: string, vars?: TranslateVars) => MailBlock;
-    button: (key: string, href: string, vars?: TranslateVars) => MailBlock;
-    callout: (key: string, tone: CalloutTone, vars?: TranslateVars) => MailBlock;
-    detail: (key: string, value: string) => MailBlock;
-    divider: () => MailBlock;
-}>;
-export interface TemplateArgs<I> {
-    readonly data: I;
-    readonly t: Translator;
-    readonly locale: string;
-    /** IANA zone. Every date in a mail is formatted with it — never with the server's zone. */
-    readonly tz: string;
-}
-export type MailTemplate<I> = (args: TemplateArgs<I>) => readonly MailBlock[];
-//# sourceMappingURL=blocks.d.ts.map

package/src/blocks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["blocks.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,GAC/F;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3C;AACH,kFAAkF;GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC,yFAAyF;AACzF,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,aAAa,KAAG,SAAS;qBACtC,MAAM,SAAS,aAAa,KAAG,SAAS;kBAC3C,MAAM,QAAQ,MAAM,SAAS,aAAa,KAAG,SAAS;mBAMrD,MAAM,QAAQ,WAAW,SAAS,aAAa,KAAG,SAAS;kBAM5D,MAAM,SAAS,MAAM,KAAG,SAAS;mBAClC,SAAS;EACtB,CAAC;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS,SAAS,EAAE,CAAC"}

package/src/blocks.js

@@ -1,23 +0,0 @@
-// Single responsibility: the vocabulary a template writes in. A mail body is a list of blocks
-// carrying i18n KEYS, never markup and never a colour — that is what makes one template able
-// to produce an HTML part and a text part, and what keeps translation out of the renderer.
-/** Block constructors, so a template never hand-writes an object literal or a colour. */
-export const blocks = Object.freeze({
-    heading: (key, vars) => ({ kind: 'heading', key, vars }),
-    paragraph: (key, vars) => ({ kind: 'paragraph', key, vars }),
-    button: (key, href, vars) => ({
-        kind: 'button',
-        key,
-        href,
-        vars,
-    }),
-    callout: (key, tone, vars) => ({
-        kind: 'callout',
-        key,
-        tone,
-        vars,
-    }),
-    detail: (key, value) => ({ kind: 'detail', key, value }),
-    divider: () => ({ kind: 'divider' }),
-});
-//# sourceMappingURL=blocks.js.map

package/src/blocks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"blocks.js","sourceRoot":"","sources":["blocks.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6FAA6F;AAC7F,2FAA2F;AAyB3F,yFAAyF;AACzF,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,GAAW,EAAE,IAAoB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAC3F,SAAS,EAAE,CAAC,GAAW,EAAE,IAAoB,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAC/F,MAAM,EAAE,CAAC,GAAW,EAAE,IAAY,EAAE,IAAoB,EAAa,EAAE,CAAC,CAAC;QACvE,IAAI,EAAE,QAAQ;QACd,GAAG;QACH,IAAI;QACJ,IAAI;KACL,CAAC;IACF,OAAO,EAAE,CAAC,GAAW,EAAE,IAAiB,EAAE,IAAoB,EAAa,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,SAAS;QACf,GAAG;QACH,IAAI;QACJ,IAAI;KACL,CAAC;IACF,MAAM,EAAE,CAAC,GAAW,EAAE,KAAa,EAAa,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACnF,OAAO,EAAE,GAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;CAChD,CAAC,CAAC"}

package/src/catalog.d.ts

@@ -1,6 +0,0 @@
-import { type Catalog, type Locale, type NestedCatalog } from '@ultimat3/i18n';
-export declare const MAIL_CATALOG_SOURCE: NestedCatalog;
-export declare const MAIL_CATALOG: Catalog;
-/** Called at boot next to `registerFrameworkCatalog()`. Idempotent. */
-export declare function registerMailCatalog(locale?: Locale): void;
-//# sourceMappingURL=catalog.d.ts.map

package/src/catalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["catalog.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,MAAM,EAEX,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,mBAAmB,EAAE,aAkEjC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAA0C,CAAC;AAEtE,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,MAAuB,GAAG,IAAI,CAEzE"}

package/src/catalog.js

@@ -1,78 +0,0 @@
-// Single responsibility: the English source strings for the keys this package's templates
-// emit. Templates carry keys only; the words live here (and in an app's own catalogs, which
-// are registered after this one and therefore win). Translating a framework mail means
-// shipping `mail.*` in an app catalog — never editing a template.
-import { DEFAULT_LOCALE, loadCatalog, registerCatalog, } from '@ultimat3/i18n';
-export const MAIL_CATALOG_SOURCE = {
-    mail: {
-        footer: {
-            legal: 'You received this message because of activity on your account.',
-            help: 'Questions? Reply to this email and a human will answer.',
-            unsubscribe: 'Unsubscribe',
-        },
-        welcome: {
-            subject: 'Welcome to {appName}',
-            preheader: 'Your {appName} account is ready.',
-            heading: 'Welcome, {name}',
-            body: 'Your {appName} account is ready. Pick up where you left off any time.',
-            cta: 'Open {appName}',
-        },
-        'verify-email': {
-            subject: 'Verify your email address',
-            preheader: 'One click and this address is confirmed.',
-            heading: 'Verify your email, {name}',
-            body: 'Confirm this address so we can secure your account and reach you when it matters.',
-            cta: 'Verify email address',
-            expiry_one: 'This link expires in {count} minute.',
-            expiry_other: 'This link expires in {count} minutes.',
-            ignore: 'If you did not create this account, ignore this message.',
-        },
-        'reset-password': {
-            subject: 'Reset your password',
-            preheader: 'A link to choose a new password.',
-            heading: 'Reset your password, {name}',
-            body: 'Choose a new password. Existing sessions stay signed in until you sign them out.',
-            cta: 'Choose a new password',
-            expiry_one: 'This link expires in {count} minute.',
-            expiry_other: 'This link expires in {count} minutes.',
-            ignore: 'If you did not ask for this, no action is needed — your password is unchanged.',
-        },
-        invite: {
-            subject: '{inviterName} invited you to {orgName}',
-            preheader: 'Your invitation to {orgName}.',
-            heading: 'Join {orgName}',
-            body: '{inviterName} invited you to collaborate in {orgName}.',
-            cta: 'Accept invitation',
-            expiry_one: 'This invitation expires in {count} hour.',
-            expiry_other: 'This invitation expires in {count} hours.',
-        },
-        'mfa-enrolled': {
-            subject: 'Two-factor authentication is on',
-            preheader: 'A new second factor now protects your account.',
-            heading: 'Two-factor is on, {name}',
-            body: 'Every sign-in now needs a second factor as well as your password.',
-            'method-label': 'Method',
-            'method-totp': 'Authenticator app',
-            'method-webauthn': 'Passkey or security key',
-            'method-sms': 'Text message',
-            'at-label': 'Enabled',
-            help: 'If this was not you, remove the factor and change your password immediately.',
-        },
-        'security-alert': {
-            subject: 'Security alert on your account',
-            preheader: 'Confirm recent activity on your account.',
-            heading: 'Security alert, {name}',
-            alert: 'We noticed activity on your account that we want you to confirm.',
-            'event-label': 'Event',
-            'ip-label': 'IP address',
-            'at-label': 'When',
-            help: 'If this was not you, change your password and sign out every other session.',
-        },
-    },
-};
-export const MAIL_CATALOG = loadCatalog(MAIL_CATALOG_SOURCE);
-/** Called at boot next to `registerFrameworkCatalog()`. Idempotent. */
-export function registerMailCatalog(locale = DEFAULT_LOCALE) {
-    registerCatalog(locale, MAIL_CATALOG);
-}
-//# sourceMappingURL=catalog.js.map

package/src/catalog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["catalog.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,4FAA4F;AAC5F,uFAAuF;AACvF,kEAAkE;AAElE,OAAO,EAEL,cAAc,EAEd,WAAW,EAEX,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAkB;IAChD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,KAAK,EAAE,gEAAgE;YACvE,IAAI,EAAE,yDAAyD;YAC/D,WAAW,EAAE,aAAa;SAC3B;QACD,OAAO,EAAE;YACP,OAAO,EAAE,sBAAsB;YAC/B,SAAS,EAAE,kCAAkC;YAC7C,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE,uEAAuE;YAC7E,GAAG,EAAE,gBAAgB;SACtB;QACD,cAAc,EAAE;YACd,OAAO,EAAE,2BAA2B;YACpC,SAAS,EAAE,0CAA0C;YACrD,OAAO,EAAE,2BAA2B;YACpC,IAAI,EAAE,mFAAmF;YACzF,GAAG,EAAE,sBAAsB;YAC3B,UAAU,EAAE,sCAAsC;YAClD,YAAY,EAAE,uCAAuC;YACrD,MAAM,EAAE,0DAA0D;SACnE;QACD,gBAAgB,EAAE;YAChB,OAAO,EAAE,qBAAqB;YAC9B,SAAS,EAAE,kCAAkC;YAC7C,OAAO,EAAE,6BAA6B;YACtC,IAAI,EAAE,kFAAkF;YACxF,GAAG,EAAE,uBAAuB;YAC5B,UAAU,EAAE,sCAAsC;YAClD,YAAY,EAAE,uCAAuC;YACrD,MAAM,EAAE,gFAAgF;SACzF;QACD,MAAM,EAAE;YACN,OAAO,EAAE,wCAAwC;YACjD,SAAS,EAAE,+BAA+B;YAC1C,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,wDAAwD;YAC9D,GAAG,EAAE,mBAAmB;YACxB,UAAU,EAAE,0CAA0C;YACtD,YAAY,EAAE,2CAA2C;SAC1D;QACD,cAAc,EAAE;YACd,OAAO,EAAE,iCAAiC;YAC1C,SAAS,EAAE,gDAAgD;YAC3D,OAAO,EAAE,0BAA0B;YACnC,IAAI,EAAE,mEAAmE;YACzE,cAAc,EAAE,QAAQ;YACxB,aAAa,EAAE,mBAAmB;YAClC,iBAAiB,EAAE,yBAAyB;YAC5C,YAAY,EAAE,cAAc;YAC5B,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,8EAA8E;SACrF;QACD,gBAAgB,EAAE;YAChB,OAAO,EAAE,gCAAgC;YACzC,SAAS,EAAE,0CAA0C;YACrD,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,kEAAkE;YACzE,aAAa,EAAE,OAAO;YACtB,UAAU,EAAE,YAAY;YACxB,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,6EAA6E;SACpF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAY,WAAW,CAAC,mBAAmB,CAAC,CAAC;AAEtE,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,MAAM,GAAW,cAAc;IACjE,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACxC,CAAC"}

package/src/driver.d.ts

@@ -1,79 +0,0 @@
-/** The rendered envelope. Everything a transport needs; nothing it does not. */
-export interface MailMessage {
-    readonly mailId: string;
-    readonly to: readonly string[];
-    readonly subject: string;
-    readonly html: string;
-    readonly text: string;
-    readonly locale: string;
-    readonly tz: string;
-    readonly replyTo?: string | undefined;
-    readonly cc?: readonly string[] | undefined;
-    readonly bcc?: readonly string[] | undefined;
-    readonly unsubscribeUrl?: string | undefined;
-    readonly idempotencyKey?: string | undefined;
-}
-export interface SendResult {
-    /** Provider message id, or a local id for the memory/log drivers. */
-    readonly id: string;
-    readonly driver: string;
-    readonly accepted: readonly string[];
-    /** True when the message was handed to the queue instead of a transport. */
-    readonly queued: boolean;
-    readonly idempotencyKey: string;
-}
-export interface MailDriver {
-    readonly name: string;
-    send(message: MailMessage): Promise<SendResult>;
-}
-/**
- * RFC 8058 one-click unsubscribe. Gmail and Yahoo require it for bulk senders and
- * reward it for transactional ones, so it is computed here rather than per driver.
- */
-export declare function messageHeaders(message: MailMessage): Readonly<Record<string, string>>;
-export interface SentMail {
-    readonly at: Date;
-    readonly message: MailMessage;
-    readonly result: SendResult;
-}
-/**
- * Dev + test driver. Retains every message it accepts and exposes them, which is what the
- * `/_x` mail panel reads to show the last mails rendered by the running app — a real inbox
- * is not part of the local loop.
- */
-export interface MemoryMailDriver extends MailDriver {
-    readonly name: 'memory';
-    readonly sent: readonly SentMail[];
-    /** Newest first, so the panel and assertions do not index backwards. */
-    outbox(): readonly SentMail[];
-    lastTo(address: string): SentMail | undefined;
-    clear(): void;
-}
-export declare function createMemoryDriver(): MemoryMailDriver;
-/**
- * Structured log line per message through core's `logger` — the default for a worker that
- * has no credentials yet. Bodies are never logged; a mail body is user data.
- */
-export declare function createLogDriver(logger?: import("@ultimat3/core").Logger): MailDriver;
-export interface SmtpDriverOptions {
-    /** `smtps://user:pass@host:465`. Read from `SMTP_URL`, never hardcoded. */
-    readonly url: string;
-    readonly from: string;
-    readonly poolSize?: number | undefined;
-}
-/** Interface-complete; the wire protocol is not in this build. */
-export declare function createSmtpDriver(options: SmtpDriverOptions): MailDriver;
-export interface ResendDriverOptions {
-    /** Read from `RESEND_API_KEY`. */
-    readonly apiKey: string;
-    readonly from: string;
-}
-/** Interface-complete; the HTTP call is not in this build. */
-export declare function createResendDriver(options: ResendDriverOptions): MailDriver;
-/** Set once at boot from `app.config.ts`. One driver per process, like the job driver. */
-export declare function setMailDriver(driver: MailDriver): void;
-export declare function tryMailDriver(): MailDriver | undefined;
-/** Throws `X_MAIL_DRIVER_UNAVAILABLE` rather than silently dropping mail on the floor. */
-export declare function mailDriver(): MailDriver;
-export declare function resetMailDriver(): void;
-//# sourceMappingURL=driver.d.ts.map

package/src/driver.d.ts.map

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

package/src/driver.js

@@ -1,115 +0,0 @@
-// Single responsibility: the transport seam. One `MailDriver` interface, four implementations,
-// and a module-level ambient driver so `send()` never knows which one is installed. Swapping
-// SMTP for Resend is an `app.config.ts` line and zero template changes.
-import { nanoid, logger as rootLogger } from '@ultimat3/core';
-import { driverUnavailable, transportNotImplemented } from './errors';
-/**
- * RFC 8058 one-click unsubscribe. Gmail and Yahoo require it for bulk senders and
- * reward it for transactional ones, so it is computed here rather than per driver.
- */
-export function messageHeaders(message) {
-    const headers = { 'Auto-Submitted': 'auto-generated' };
-    if (message.replyTo !== undefined)
-        headers['Reply-To'] = message.replyTo;
-    if (message.unsubscribeUrl !== undefined) {
-        headers['List-Unsubscribe'] = `<${message.unsubscribeUrl}>`;
-        headers['List-Unsubscribe-Post'] = 'List-Unsubscribe=One-Click';
-    }
-    return headers;
-}
-function accepted(message) {
-    return [...message.to, ...(message.cc ?? []), ...(message.bcc ?? [])];
-}
-function resultFor(driver, message, id) {
-    return {
-        id,
-        driver,
-        accepted: accepted(message),
-        queued: false,
-        idempotencyKey: message.idempotencyKey ?? id,
-    };
-}
-export function createMemoryDriver() {
-    const sent = [];
-    return {
-        name: 'memory',
-        sent,
-        send(message) {
-            const result = resultFor('memory', message, `mem_${nanoid(12)}`);
-            sent.push({ at: new Date(), message, result });
-            return Promise.resolve(result);
-        },
-        outbox: () => [...sent].reverse(),
-        lastTo: (address) => [...sent].reverse().find((entry) => entry.message.to.includes(address)),
-        clear: () => {
-            sent.length = 0;
-        },
-    };
-}
-/**
- * Structured log line per message through core's `logger` — the default for a worker that
- * has no credentials yet. Bodies are never logged; a mail body is user data.
- */
-export function createLogDriver(logger = rootLogger) {
-    return {
-        name: 'log',
-        send(message) {
-            const result = resultFor('log', message, `log_${nanoid(12)}`);
-            logger.info('mail.send', {
-                mailId: message.mailId,
-                to: message.to.length,
-                subject: message.subject,
-                locale: message.locale,
-                idempotencyKey: result.idempotencyKey,
-            });
-            return Promise.resolve(result);
-        },
-    };
-}
-/** Interface-complete; the wire protocol is not in this build. */
-export function createSmtpDriver(options) {
-    return {
-        name: 'smtp',
-        send(_message) {
-            throw transportNotImplemented('smtp', `set SMTP_URL (currently "${redactUrl(options.url)}") and run: x mail doctor --json`);
-        },
-    };
-}
-/** Interface-complete; the HTTP call is not in this build. */
-export function createResendDriver(options) {
-    return {
-        name: 'resend',
-        send(_message) {
-            const state = options.apiKey === '' ? 'empty' : 'set';
-            throw transportNotImplemented('resend', `set RESEND_API_KEY (currently ${state}), then run: x mail doctor --json`);
-        },
-    };
-}
-function redactUrl(url) {
-    try {
-        const parsed = new URL(url);
-        parsed.password = '';
-        return parsed.href;
-    }
-    catch {
-        return 'not a URL';
-    }
-}
-let ambient;
-/** Set once at boot from `app.config.ts`. One driver per process, like the job driver. */
-export function setMailDriver(driver) {
-    ambient = driver;
-}
-export function tryMailDriver() {
-    return ambient;
-}
-/** Throws `X_MAIL_DRIVER_UNAVAILABLE` rather than silently dropping mail on the floor. */
-export function mailDriver() {
-    if (ambient === undefined)
-        throw driverUnavailable('setMailDriver() was never called');
-    return ambient;
-}
-export function resetMailDriver() {
-    ambient = undefined;
-}
-//# sourceMappingURL=driver.js.map

package/src/driver.js.map

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

package/src/errors.d.ts

@@ -1,23 +0,0 @@
-import { UltimateError } from '@ultimat3/core';
-export declare const MAIL_ERROR_CODES: readonly ['X_MAIL_LOCALE_MISSING', 'X_MAIL_TEMPLATE_UNKNOWN', 'X_MAIL_DUPLICATE', 'X_MAIL_TEXT_MISSING', 'X_MAIL_DRIVER_UNAVAILABLE', 'X_NOT_IMPLEMENTED'];
-export type MailErrorCode = (typeof MAIL_ERROR_CODES)[number];
-export declare const MAIL_ERROR_TITLES: Readonly<Record<MailErrorCode, string>>;
-export interface MailErrorInit {
-    readonly code: MailErrorCode;
-    readonly cause: string;
-    readonly fix: string;
-    readonly meta?: Readonly<Record<string, unknown>> | undefined;
-}
-export declare class MailError extends UltimateError {
-    readonly name = "MailError";
-    constructor(init: MailErrorInit);
-}
-export declare const localeMissing: (mailId: string) => MailError;
-export declare const templateUnknown: (mailId: string, known: readonly string[]) => MailError;
-export declare const layoutUnknown: (mailId: string, layout: string, known: readonly string[]) => MailError;
-export declare const mailDuplicate: (mailId: string) => MailError;
-export declare const textMissing: (mailId: string) => MailError;
-export declare const driverUnavailable: (what: string) => MailError;
-/** The blessed shape for a transport that exists as an interface but has no wire yet. */
-export declare const transportNotImplemented: (driver: string, fix: string) => MailError;
-//# sourceMappingURL=errors.d.ts.map

package/src/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["errors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoC,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEjF,eAAO,MAAM,gBAAgB,YAC3B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,CACX,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAOrE,CAAC;AAQF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAC/D;AAED,qBAAa,SAAU,SAAQ,aAAa;IAC1C,SAAkB,IAAI,eAAe;IAErC,YAAY,IAAI,EAAE,aAAa,EAQ9B;CACF;AAED,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,SAM3C,CAAC;AAEL,eAAO,MAAM,eAAe,WAAY,MAAM,SAAS,SAAS,MAAM,EAAE,KAAG,SAMvE,CAAC;AAEL,eAAO,MAAM,aAAa,WAChB,MAAM,UACN,MAAM,SACP,SAAS,MAAM,EAAE,KACvB,SAMC,CAAC;AAEL,eAAO,MAAM,aAAa,WAAY,MAAM,KAAG,SAM3C,CAAC;AAEL,eAAO,MAAM,WAAW,WAAY,MAAM,KAAG,SAMzC,CAAC;AAEL,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,SAM7C,CAAC;AAEL,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,WAAY,MAAM,OAAO,MAAM,KAAG,SAMlE,CAAC"}

package/src/errors.js

@@ -1,82 +0,0 @@
-// Single responsibility: the mail package's stable error codes and their `fix:` lines.
-// Mail fails in production, not in tests — a wrong locale, an empty text part or an
-// unconfigured driver must name the exact call site edit that repairs it.
-import { hasErrorCode, registerErrorCodes, UltimateError } from '@ultimat3/core';
-export const MAIL_ERROR_CODES = [
-    'X_MAIL_LOCALE_MISSING',
-    'X_MAIL_TEMPLATE_UNKNOWN',
-    'X_MAIL_DUPLICATE',
-    'X_MAIL_TEXT_MISSING',
-    'X_MAIL_DRIVER_UNAVAILABLE',
-    'X_NOT_IMPLEMENTED',
-];
-export const MAIL_ERROR_TITLES = {
-    X_MAIL_LOCALE_MISSING: 'send() was called without a locale',
-    X_MAIL_TEMPLATE_UNKNOWN: 'no mail is registered under that id',
-    X_MAIL_DUPLICATE: 'two mails claim the same id',
-    X_MAIL_TEXT_MISSING: 'the rendered mail has no plain-text part',
-    X_MAIL_DRIVER_UNAVAILABLE: 'no mail driver is configured',
-    X_NOT_IMPLEMENTED: 'this driver has no transport yet',
-};
-// Titles must be registered for `format()` to render the contract's first line, but
-// `X_NOT_IMPLEMENTED` belongs to core — registering a code twice throws X_ERROR_CODE_DUPLICATE.
-for (const [code, title] of Object.entries(MAIL_ERROR_TITLES)) {
-    if (!hasErrorCode(code))
-        registerErrorCodes({ [code]: { title } });
-}
-export class MailError extends UltimateError {
-    name = 'MailError';
-    constructor(init) {
-        super({
-            code: init.code,
-            cause: init.cause,
-            fix: init.fix,
-            docs: `https://ultimate.dev/errors/${init.code}`,
-            meta: init.meta,
-        });
-    }
-}
-export const localeMissing = (mailId) => new MailError({
-    code: 'X_MAIL_LOCALE_MISSING',
-    cause: `send(${mailId}, data, options) got no locale — the recipient's language is unknown`,
-    fix: `pass it: send(${mailId}, data, { to, locale: ctx.locale })`,
-    meta: { mailId },
-});
-export const templateUnknown = (mailId, known) => new MailError({
-    code: 'X_MAIL_TEMPLATE_UNKNOWN',
-    cause: `no mail with id "${mailId}" is registered (have: ${known.join(', ') || 'none'})`,
-    fix: `x mail list --json   # then export defineMail({ id: '${mailId}', ... }) and import it`,
-    meta: { mailId, known },
-});
-export const layoutUnknown = (mailId, layout, known) => new MailError({
-    code: 'X_MAIL_TEMPLATE_UNKNOWN',
-    cause: `mail "${mailId}" wants layout "${layout}" (registered: ${known.join(', ')})`,
-    fix: `registerLayout('${layout}', myLayout) at boot, or set layout: 'base' on that mail`,
-    meta: { mailId, layout, known },
-});
-export const mailDuplicate = (mailId) => new MailError({
-    code: 'X_MAIL_DUPLICATE',
-    cause: `mail id "${mailId}" is already registered by another defineMail() call`,
-    fix: `x mail list --json   # then rename one of the two defineMail({ id }) declarations`,
-    meta: { mailId },
-});
-export const textMissing = (mailId) => new MailError({
-    code: 'X_MAIL_TEXT_MISSING',
-    cause: `mail "${mailId}" rendered an empty text part (HTML-only mail scores as spam)`,
-    fix: `add a text block to the "${mailId}" template: blocks.paragraph('mail.${mailId}.body')`,
-    meta: { mailId },
-});
-export const driverUnavailable = (what) => new MailError({
-    code: 'X_MAIL_DRIVER_UNAVAILABLE',
-    cause: `${what} — nothing can deliver the message`,
-    fix: 'setMailDriver(createMemoryDriver()) in dev, createSmtpDriver({ url: env.SMTP_URL }) live',
-    meta: { what },
-});
-/** The blessed shape for a transport that exists as an interface but has no wire yet. */
-export const transportNotImplemented = (driver, fix) => new MailError({
-    code: 'X_NOT_IMPLEMENTED',
-    cause: `the ${driver} mail driver has no transport in this build`,
-    fix,
-    meta: { driver },
-});
-//# sourceMappingURL=errors.js.map

package/src/errors.js.map

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

package/src/html.d.ts

@@ -1,10 +0,0 @@
-/** Escape text content AND attribute values — the same set covers both in mail. */
-export declare function escapeHtml(value: string): string;
-/**
- * `javascript:` and `data:` hrefs are stripped rather than escaped: some clients still
- * follow them, and a link the recipient cannot trust is worse than a dead one.
- */
-export declare function safeUrl(value: string): string;
-/** `style="a:b;c:d"` from declarations, so no call site hand-builds a style attribute. */
-export declare function styleAttr(declarations: readonly string[]): string;
-//# sourceMappingURL=html.d.ts.map

package/src/html.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["html.ts"],"names":[],"mappings":"AAYA,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAID;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED,0FAA0F;AAC1F,wBAAgB,SAAS,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEjE"}

package/src/html.js

@@ -1,34 +0,0 @@
-// Single responsibility: turning untrusted values into inert HTML. Mail bodies interpolate
-// user-supplied names, org names and URLs; an unescaped one is a phishing vector that also
-// renders in the recipient's client forever, so escaping lives in exactly one place.
-const ESCAPES = {
-    '&': '&',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#39;',
-};
-/** Escape text content AND attribute values — the same set covers both in mail. */
-export function escapeHtml(value) {
-    return value.replace(/[&<>"']/g, (char) => ESCAPES[char] ?? char);
-}
-const SAFE_PROTOCOLS = ['http:', 'https:', 'mailto:'];
-/**
- * `javascript:` and `data:` hrefs are stripped rather than escaped: some clients still
- * follow them, and a link the recipient cannot trust is worse than a dead one.
- */
-export function safeUrl(value) {
-    let parsed;
-    try {
-        parsed = new URL(value);
-    }
-    catch {
-        return '#';
-    }
-    return SAFE_PROTOCOLS.includes(parsed.protocol) ? parsed.href : '#';
-}
-/** `style="a:b;c:d"` from declarations, so no call site hand-builds a style attribute. */
-export function styleAttr(declarations) {
-    return `style="${escapeHtml(declarations.join(';'))}"`;
-}
-//# sourceMappingURL=html.js.map

package/src/html.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"html.js","sourceRoot":"","sources":["html.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2FAA2F;AAC3F,qFAAqF;AAErF,MAAM,OAAO,GAAqC;IAChD,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,cAAc,GAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;AACtE,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,SAAS,CAAC,YAA+B;IACvD,OAAO,UAAU,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;AACzD,CAAC"}

package/src/index.d.ts

@@ -1,17 +0,0 @@
-export type { CalloutTone, MailBlock, MailTemplate, TemplateArgs } from './blocks';
-export { blocks } from './blocks';
-export { MAIL_CATALOG, MAIL_CATALOG_SOURCE, registerMailCatalog } from './catalog';
-export type { MailDriver, MailMessage, MemoryMailDriver, ResendDriverOptions, SendResult, SentMail, SmtpDriverOptions, } from './driver';
-export { createLogDriver, createMemoryDriver, createResendDriver, createSmtpDriver, mailDriver, messageHeaders, resetMailDriver, setMailDriver, tryMailDriver, } from './driver';
-export type { MailErrorCode, MailErrorInit } from './errors';
-export { driverUnavailable, layoutUnknown, localeMissing, MAIL_ERROR_CODES, MAIL_ERROR_TITLES, MailError, mailDuplicate, templateUnknown, textMissing, transportNotImplemented, } from './errors';
-export { escapeHtml, safeUrl } from './html';
-export { mailIdempotencyKey, mailMessageSchema, sendMailJob } from './job';
-export type { ColorScheme, DarkRule, LayoutInput, MailLayout, MailToken, UnsubscribeSlot, } from './layout';
-export { BASE_LAYOUT, baseLayout, DARK_RULES, darkModeCss, layoutFor, MAIL_FONT_STACK, MAIL_TOKENS, MAIL_WIDTH_PX, registeredLayouts, registerLayout, token, } from './layout';
-export type { AnyMailDefinition, MailDefinition, MailInit, SendOptions } from './mail';
-export { defineMail, mailFor, registeredMailIds, registeredMails, renderMessage, resetMails, send, sendById, } from './mail';
-export type { RenderableMail, RenderedMail, RenderOptions } from './render';
-export { FOOTER_KEYS, renderMail, textOf, UNSUBSCRIBE_KEY } from './render';
-export { FRAMEWORK_MAILS, type InviteInput, inviteInput, inviteMail, MFA_METHODS, type MfaEnrolledInput, mfaEnrolledInput, mfaEnrolledMail, type ResetPasswordInput, resetPasswordInput, resetPasswordMail, type SecurityAlertInput, securityAlertInput, securityAlertMail, type VerifyEmailInput, verifyEmailInput, verifyEmailMail, type WelcomeInput, welcomeInput, welcomeMail, } from './templates';
-//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACnF,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC3E,YAAY,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,KAAK,GACN,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACvF,OAAO,EACL,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,UAAU,EACV,IAAI,EACJ,QAAQ,GACT,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,WAAW,EACX,UAAU,EACV,WAAW,EACX,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,eAAe,EACf,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/src/index.js

@@ -1,13 +0,0 @@
-// Single responsibility: the public API of @ultimat3/mail. Explicit named exports only —
-// other packages call `defineMail`, `send` and the driver seam, and nothing else.
-export { blocks } from './blocks';
-export { MAIL_CATALOG, MAIL_CATALOG_SOURCE, registerMailCatalog } from './catalog';
-export { createLogDriver, createMemoryDriver, createResendDriver, createSmtpDriver, mailDriver, messageHeaders, resetMailDriver, setMailDriver, tryMailDriver, } from './driver';
-export { driverUnavailable, layoutUnknown, localeMissing, MAIL_ERROR_CODES, MAIL_ERROR_TITLES, MailError, mailDuplicate, templateUnknown, textMissing, transportNotImplemented, } from './errors';
-export { escapeHtml, safeUrl } from './html';
-export { mailIdempotencyKey, mailMessageSchema, sendMailJob } from './job';
-export { BASE_LAYOUT, baseLayout, DARK_RULES, darkModeCss, layoutFor, MAIL_FONT_STACK, MAIL_TOKENS, MAIL_WIDTH_PX, registeredLayouts, registerLayout, token, } from './layout';
-export { defineMail, mailFor, registeredMailIds, registeredMails, renderMessage, resetMails, send, sendById, } from './mail';
-export { FOOTER_KEYS, renderMail, textOf, UNSUBSCRIBE_KEY } from './render';
-export { FRAMEWORK_MAILS, inviteInput, inviteMail, MFA_METHODS, mfaEnrolledInput, mfaEnrolledMail, resetPasswordInput, resetPasswordMail, securityAlertInput, securityAlertMail, verifyEmailInput, verifyEmailMail, welcomeInput, welcomeMail, } from './templates';
-//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,kFAAkF;AAGlF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAUnF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACX,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAS3E,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,KAAK,GACN,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,UAAU,EACV,IAAI,EACJ,QAAQ,GACT,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EACL,eAAe,EAEf,WAAW,EACX,UAAU,EACV,WAAW,EAEX,gBAAgB,EAChB,eAAe,EAEf,kBAAkB,EAClB,iBAAiB,EAEjB,kBAAkB,EAClB,iBAAiB,EAEjB,gBAAgB,EAChB,eAAe,EAEf,YAAY,EACZ,WAAW,GACZ,MAAM,aAAa,CAAC"}