@endora-commerce/mod-email 0.100.0

package/dist/backend/services/recording-mailer.js

@@ -0,0 +1,77 @@
+/**
+ * The mailer every sending module resolves: a driver plus its delivery record
+ * (D-59, issue #114).
+ *
+ * A decorator rather than a line in each of the seventeen call sites, for the
+ * reason `providePort`'s gate is a wrapper rather than a call: a record the
+ * transport seam writes cannot be forgotten by the module somebody adds next
+ * month, and a hand-placed one demonstrably was — that is how "did the customer
+ * get the invoice" ended up answerable only from a log.
+ *
+ * **Ordering, which is the part with a wrong answer.** The transport is called
+ * first and the record written after it, in both directions:
+ *
+ *   - a send that succeeded is recorded, and if that write fails the recorder
+ *     answers `null` (it never throws) so the caller still sees `sent` — the
+ *     message did leave, and reporting otherwise would be a lie that could
+ *     trigger a resend;
+ *   - a send that raised is recorded as `failed` and the error is **re-thrown
+ *     unchanged**, so every caller's own tolerance keeps deciding what a failed
+ *     message means for the operation it followed.
+ *
+ * The other order — record first, then send — is the outbox D-58 refused: it
+ * buys atomicity between a business write and an enqueue that nothing here
+ * promises, and it costs a row that claims a message was attempted before
+ * anything was.
+ */
+export class RecordingMailer {
+    transport;
+    recorder;
+    constructor(transport, recorder) {
+        this.transport = transport;
+        this.recorder = recorder;
+    }
+    async send(input) {
+        let outcome;
+        try {
+            outcome = await this.transport.send(input);
+        }
+        catch (error) {
+            await this.recorder.record({
+                ...contextOf(input),
+                status: 'failed',
+                reason: 'transport_error',
+                detail: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+        await this.recorder.record({
+            ...contextOf(input),
+            ...(outcome.status === 'sent'
+                ? { status: 'sent' }
+                : { status: 'suppressed', reason: outcome.reason }),
+        });
+        return outcome;
+    }
+}
+/**
+ * What the row keeps about the message itself.
+ *
+ * `kind` falls back to `meta.kind` because that convention predates this record
+ * — ten in-code builders already write it — so the fallback covers them without
+ * ten edits, and `unspecified` is reserved for a sender that names itself
+ * nowhere at all.
+ */
+function contextOf(input) {
+    const metaKind = input.meta?.['kind'];
+    return {
+        messageId: input.messageId,
+        recipient: input.to,
+        kind: input.kind ?? (typeof metaKind === 'string' ? metaKind : 'unspecified'),
+        subject: input.subject,
+        ...(input.salesChannelId !== undefined ? { salesChannelId: input.salesChannelId } : {}),
+        ...(input.document ? { documentType: input.document.type, documentId: input.document.id } : {}),
+        ...(input.meta ? { context: input.meta } : {}),
+    };
+}
+//# sourceMappingURL=recording-mailer.js.map

package/dist/backend/services/recording-mailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-mailer.js","sourceRoot":"","sources":["../../../src/backend/services/recording-mailer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,SAAiB,EACjB,QAA+B;QAD/B,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAuB;IAC/C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,KAAsB;QAC/B,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACzB,GAAG,SAAS,CAAC,KAAK,CAAC;gBACnB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,iBAAiB;gBACzB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACzB,GAAG,SAAS,CAAC,KAAK,CAAC;YACnB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM;gBAC3B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAe,EAAE;gBAC7B,CAAC,CAAC,EAAE,MAAM,EAAE,YAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SAC/D,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAsB;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;QAC7E,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/backend/services/smtp-mailer.d.ts

@@ -0,0 +1,16 @@
+import type { Mailer, MailerSendInput, MailerSendOutcome } from './mailer.js';
+/**
+ * Production SMTP mailer using `nodemailer`. Configure via `SMTP_URL`
+ * (e.g. `smtps://user:pass@smtp.example.com:465` or SendGrid SMTP relay).
+ */
+export declare class SmtpMailer implements Mailer {
+    private readonly transport;
+    constructor(smtpUrl: string);
+    /**
+     * Answers `sent` or raises. There is no suppression an SMTP relay performs on
+     * our behalf: `nodemailer` either hands the message over or throws, and the
+     * throw is what the delivery record turns into a `failed` row (D-59).
+     */
+    send(input: MailerSendInput): Promise<MailerSendOutcome>;
+}
+//# sourceMappingURL=smtp-mailer.d.ts.map

package/dist/backend/services/smtp-mailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-mailer.d.ts","sourceRoot":"","sources":["../../../src/backend/services/smtp-mailer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9E;;;GAGG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAEf,OAAO,EAAE,MAAM;IAI3B;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuB/D"}

package/dist/backend/services/smtp-mailer.js

@@ -0,0 +1,40 @@
+import nodemailer from 'nodemailer';
+/**
+ * Production SMTP mailer using `nodemailer`. Configure via `SMTP_URL`
+ * (e.g. `smtps://user:pass@smtp.example.com:465` or SendGrid SMTP relay).
+ */
+export class SmtpMailer {
+    transport;
+    constructor(smtpUrl) {
+        this.transport = nodemailer.createTransport(smtpUrl);
+    }
+    /**
+     * Answers `sent` or raises. There is no suppression an SMTP relay performs on
+     * our behalf: `nodemailer` either hands the message over or throws, and the
+     * throw is what the delivery record turns into a `failed` row (D-59).
+     */
+    async send(input) {
+        await this.transport.sendMail({
+            from: process.env['SMTP_FROM'] ?? process.env['MAIL_FROM'] ?? 'noreply@localhost',
+            to: input.to,
+            subject: input.subject,
+            text: input.text,
+            // Send a multipart alternative when an HTML body is provided (feature 047).
+            ...(input.html ? { html: input.html } : {}),
+            ...(input.attachments && input.attachments.length
+                ? {
+                    attachments: input.attachments.map((a) => ({
+                        filename: a.filename,
+                        // nodemailer wants a Buffer/string; a Buffer is already one, a
+                        // plain Uint8Array is wrapped without copying its backing memory.
+                        content: Buffer.isBuffer(a.content) ? a.content : Buffer.from(a.content),
+                        ...(a.contentType ? { contentType: a.contentType } : {}),
+                    })),
+                }
+                : {}),
+            messageId: input.messageId,
+        });
+        return { status: 'sent' };
+    }
+}
+//# sourceMappingURL=smtp-mailer.js.map

package/dist/backend/services/smtp-mailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-mailer.js","sourceRoot":"","sources":["../../../src/backend/services/smtp-mailer.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC;;;GAGG;AACH,MAAM,OAAO,UAAU;IACJ,SAAS,CAAC;IAE3B,YAAY,OAAe;QACzB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,KAAsB;QAC/B,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAC5B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,mBAAmB;YACjF,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,4EAA4E;YAC5E,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM;gBAC/C,CAAC,CAAC;oBACE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACzC,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,+DAA+D;wBAC/D,kEAAkE;wBAClE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;wBACxE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACzD,CAAC,CAAC;iBACJ;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/manifest.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Email module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("email" | "invoice" | "cms" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("email" | "invoice" | "cms" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqLnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,190 @@
+import { defineModuleManifest } from '@endora-commerce/contracts';
+/**
+ * Email module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export const manifest = defineModuleManifest({
+    id: 'email',
+    name: 'Email',
+    description: 'Mailer abstraction with Console / SMTP drivers for transactional email.',
+    version: '1.0.0',
+    /**
+     * What this module needs from the environment (`specs/117-instance-bring-up/`
+     * FR-002). Only what it **owns**: its reads of platform-owned names are
+     * satisfied by `packages/platform/src/env/index.ts`.
+     *
+     * Why each of these is not a Setting is its entry in
+     * `backend/scripts/ledgers/module-environment-inputs/email.ts`.
+     */
+    env: [
+        {
+            name: 'MAIL_DRIVER',
+            describes: {
+                en: 'How outgoing mail leaves this instance; `console` writes messages to the log instead of delivering them.',
+                pl: 'W jaki sposób poczta wychodząca opuszcza tę instancję; wartość `console` zapisuje wiadomości do logu zamiast je wysyłać.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'There is no way to stop a development instance from attempting real delivery to real addresses.',
+                    pl: 'Nie ma jak powstrzymać instancji deweloperskiej przed próbą wysyłki na prawdziwe adresy.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_URL',
+            describes: {
+                en: 'The whole SMTP connection as one URL, credentials included.',
+                pl: 'Całe połączenie SMTP jako jeden adres URL, wraz z poświadczeniami.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'The connection has to be assembled from the separate host, port, user and password variables instead.',
+                    pl: 'Połączenie trzeba wtedy złożyć z osobnych zmiennych: hosta, portu, użytkownika i hasła.',
+                },
+            },
+            secret: true,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_HOST',
+            describes: {
+                en: 'The host name of the SMTP relay that delivers this shop’s mail.',
+                pl: 'Nazwa hosta serwera SMTP, który dostarcza pocztę tego sklepu.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'No connection can be assembled from the separate fields, so nothing is delivered unless `SMTP_URL` carries the whole connection.',
+                    pl: 'Z osobnych pól nie da się złożyć połączenia, więc nic nie zostanie dostarczone, o ile `SMTP_URL` nie zawiera całego połączenia.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_PORT',
+            describes: {
+                en: 'The port the SMTP relay listens on.',
+                pl: 'Port, na którym nasłuchuje serwer SMTP.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'No connection can be assembled from the separate fields, so nothing is delivered unless `SMTP_URL` carries the whole connection.',
+                    pl: 'Z osobnych pól nie da się złożyć połączenia, więc nic nie zostanie dostarczone, o ile `SMTP_URL` nie zawiera całego połączenia.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_USER',
+            describes: {
+                en: 'The account this instance authenticates to the SMTP relay as.',
+                pl: 'Konto, na którym ta instancja uwierzytelnia się w serwerze SMTP.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'The relay is addressed with no credentials, which a public relay refuses.',
+                    pl: 'Serwer jest odpytywany bez poświadczeń, czego publiczny serwer odmawia.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_PASSWORD',
+            describes: {
+                en: 'The password for the SMTP account.',
+                pl: 'Hasło do konta SMTP.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'The relay is addressed with no credentials, which a public relay refuses.',
+                    pl: 'Serwer jest odpytywany bez poświadczeń, czego publiczny serwer odmawia.',
+                },
+            },
+            secret: true,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'SMTP_FROM',
+            describes: {
+                en: 'The address outgoing mail is sent from.',
+                pl: 'Adres, z którego wychodzi poczta.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'Mail leaves under the platform’s placeholder address, which a relay commonly rejects as unroutable.',
+                    pl: 'Poczta wychodzi spod zastępczego adresu platformy, który serwer pocztowy zwykle odrzuca jako nieroutowalny.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+        {
+            name: 'MAIL_FROM',
+            describes: {
+                en: 'The address outgoing mail is sent from, read where `SMTP_FROM` is unset.',
+                pl: 'Adres, z którego wychodzi poczta, odczytywany, gdy `SMTP_FROM` nie jest ustawiony.',
+            },
+            requirement: {
+                kind: 'optional',
+                without: {
+                    en: 'Mail leaves under the platform’s placeholder address, which a relay commonly rejects as unroutable.',
+                    pl: 'Poczta wychodzi spod zastępczego adresu platformy, który serwer pocztowy zwykle odrzuca jako nieroutowalny.',
+                },
+            },
+            secret: false,
+            generable: false,
+            owner: { kind: 'module', moduleId: 'email' },
+            consumers: ['backend'],
+            addressOf: null,
+        },
+    ],
+    dependencies: [],
+    // Feature 074 (Constitution XVII), test C3 — platform primitive. This module
+    // had no activation declaration at all, which resolved as "always activated"
+    // and read as an omission. It is the outbound transport every message leaves
+    // through: a business configures a driver — Console, SMTP — it does not
+    // switch the transport off, and the per-message choice belongs to
+    // `transactional_emails`, which offers it per email.
+    activation: {
+        nonDeactivatable: true,
+        reason: 'The outbound transport every message leaves through. A business configures a driver; ' +
+            'it does not switch the transport off.',
+    },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/migrations/20260817T070014_email_delivery_record.d.ts

@@ -0,0 +1,14 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * D-59 — `email_deliveries`, the first table this module owns.
+ *
+ * One row per delivery decision, deliberately the `webhook_deliveries` shape
+ * (see the entity): no `pending` status, no row before something was attempted,
+ * no foreign key — a delivery record has to survive the deletion of whatever it
+ * was about, which is exactly when somebody asks about it.
+ */
+export declare class Migration20260817T070014EmailDeliveryRecord extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260817T070014_email_delivery_record.d.ts.map

package/dist/migrations/20260817T070014_email_delivery_record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260817T070014_email_delivery_record.d.ts","sourceRoot":"","sources":["../../src/migrations/20260817T070014_email_delivery_record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,qBAAa,2CAA4C,SAAQ,SAAS;IACzD,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/migrations/20260817T070014_email_delivery_record.js

@@ -0,0 +1,44 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * D-59 — `email_deliveries`, the first table this module owns.
+ *
+ * One row per delivery decision, deliberately the `webhook_deliveries` shape
+ * (see the entity): no `pending` status, no row before something was attempted,
+ * no foreign key — a delivery record has to survive the deletion of whatever it
+ * was about, which is exactly when somebody asks about it.
+ */
+export class Migration20260817T070014EmailDeliveryRecord extends Migration {
+    async up() {
+        this.addSql(`
+      create table "email_deliveries" (
+        "id" uuid not null,
+        "message_id" varchar(191) not null,
+        "recipient" varchar(320) not null,
+        "kind" varchar(64) not null,
+        "status" varchar(16) not null,
+        "reason" varchar(64) null,
+        "detail" varchar(4000) null,
+        "subject" varchar(998) null,
+        "sales_channel_id" uuid null,
+        "document_type" varchar(32) null,
+        "document_id" varchar(64) null,
+        "context" jsonb null,
+        "attempted_at" timestamptz not null,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        constraint "email_deliveries_pkey" primary key ("id")
+      );
+    `);
+        this.addSql('create index "email_deliveries_message_id_index" on "email_deliveries" ("message_id");');
+        this.addSql('create index "email_deliveries_recipient_index" on "email_deliveries" ("recipient");');
+        this.addSql('create index "email_deliveries_kind_index" on "email_deliveries" ("kind");');
+        this.addSql('create index "email_deliveries_status_index" on "email_deliveries" ("status");');
+        this.addSql('create index "email_deliveries_document_type_index" on "email_deliveries" ("document_type");');
+        this.addSql('create index "email_deliveries_document_id_index" on "email_deliveries" ("document_id");');
+        this.addSql('create index "email_deliveries_attempted_at_index" on "email_deliveries" ("attempted_at");');
+    }
+    async down() {
+        this.addSql('drop table if exists "email_deliveries" cascade;');
+    }
+}
+//# sourceMappingURL=20260817T070014_email_delivery_record.js.map

package/dist/migrations/20260817T070014_email_delivery_record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260817T070014_email_delivery_record.js","sourceRoot":"","sources":["../../src/migrations/20260817T070014_email_delivery_record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,OAAO,2CAA4C,SAAQ,SAAS;IAC/D,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;KAmBX,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,wFAAwF,CAAC,CAAC;QACtG,IAAI,CAAC,MAAM,CAAC,sFAAsF,CAAC,CAAC;QACpG,IAAI,CAAC,MAAM,CAAC,4EAA4E,CAAC,CAAC;QAC1F,IAAI,CAAC,MAAM,CAAC,gFAAgF,CAAC,CAAC;QAC9F,IAAI,CAAC,MAAM,CACT,8FAA8F,CAC/F,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,0FAA0F,CAAC,CAAC;QACxG,IAAI,CAAC,MAAM,CAAC,4FAA4F,CAAC,CAAC;IAC5G,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260817T070014EmailDeliveryRecord } from './20260817T070014_email_delivery_record.js';
+export declare const migrations: (typeof Migration20260817T070014EmailDeliveryRecord)[];
+export { Migration20260817T070014EmailDeliveryRecord, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AAEzG,eAAO,MAAM,UAAU,wDAEtB,CAAC;AAEF,OAAO,EACL,2CAA2C,GAC5C,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,29 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260817T070014EmailDeliveryRecord } from './20260817T070014_email_delivery_record.js';
+export const migrations = [
+    Migration20260817T070014EmailDeliveryRecord,
+];
+export { Migration20260817T070014EmailDeliveryRecord, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC;AAEzG,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2CAA2C;CAC5C,CAAC;AAEF,OAAO,EACL,2CAA2C,GAC5C,CAAC"}