@endora-commerce/mod-invoices 0.0.0-stage → 0.100.0

package/dist/backend/services/invoice-email-dispatch.d.ts

@@ -0,0 +1,89 @@
+import type { InvoiceEmailNotSentReason, OrderReadPort, OrderRecord, TransactionalEmailSender } from '@endora-commerce/contracts';
+import type { InvoiceService } from './invoice-service.js';
+import type { InvoicePdfRenderer } from './invoice-pdf-renderer.js';
+import type { SettingsReader } from './seller-settings.js';
+/**
+ * Why the invoice e-mail did — or did not — go out (issue #103).
+ *
+ * `dispatch` used to answer a bare `boolean`, and the two send-on-issue call
+ * sites discarded even that. Six unrelated situations therefore looked
+ * identical from outside and four of them were silent: no sender wired, no
+ * recipient, the operator switched the e-mail off, no template for the code, no
+ * transport, and an error the FR-029 `catch` absorbed. An invoice was issued and
+ * nothing anywhere said that no message had been sent.
+ *
+ * The seven reasons live in `@endora-commerce/contracts` since issue #149, because the admin
+ * issue route answers with one and an API shape belongs there.
+ */
+export type { InvoiceEmailNotSentReason };
+export type InvoiceEmailDispatchResult = {
+    sent: true;
+} | {
+    sent: false;
+    reason: InvoiceEmailNotSentReason;
+};
+/**
+ * Where a failed dispatch is reported. Injectable so a test can read it;
+ * defaults to `console.warn`, which is what the rest of this layer uses.
+ */
+export type InvoiceEmailLog = (message: string, context: Record<string, unknown>) => void;
+export interface InvoiceEmailDispatchDeps {
+    /**
+     * `orders`' published read model (feature 075, Phase C), which replaced this
+     * dispatcher's `emFactory` outright: the only thing it ever asked an
+     * `EntityManager` for was `em.findOne(Order, …)`, a query against another
+     * module's table.
+     */
+    orderReadPort: OrderReadPort;
+    invoiceService: InvoiceService;
+    pdfRenderer: InvoicePdfRenderer;
+    settingsService: SettingsReader;
+    getSender: () => TransactionalEmailSender | undefined;
+    resolveRecipientEmail: (order: OrderRecord) => Promise<string | null>;
+    resolveLanguage: (salesChannelId: string | null) => Promise<string>;
+    log?: InvoiceEmailLog;
+}
+/**
+ * Dispatches the `invoice_issued` transactional email (feature 047, US5).
+ * Builds template variables, optionally attaches the rendered PDF (attachment
+ * mode) or supplies a storefront download link (link mode), and sends through
+ * the transactional_emails sender. Idempotent on `messageId`.
+ *
+ * **Best-effort, and now audible.** A failure still never throws to the caller
+ * — issuance must not be undone (FR-029) — but the tolerance is narrow: a
+ * `ModuleDisabledError` is a presence answer and is re-thrown, everything else
+ * is named in the result and written to the log. Issue #78 tracks the callers
+ * that discard the result; the log is what covers them until it lands.
+ *
+ * An invoice whose order carries **no sales channel** is an ordinary case, not a
+ * failure: every setting below is then read platform-wide (`null`, D-41), and
+ * the send names the same `null`.
+ */
+export declare class InvoiceEmailDispatcher {
+    private readonly deps;
+    private readonly log;
+    constructor(deps: InvoiceEmailDispatchDeps);
+    dispatch(invoiceId: string, opts?: {
+        mode?: 'attachment' | 'link';
+        messageId?: string;
+    }): Promise<InvoiceEmailDispatchResult>;
+    private notSent;
+    /**
+     * The two conditions that degrade to the module's compiled-in default, and no
+     * others: the setting is not registered yet, or it is scoped to a subset of
+     * channels this read is not inside. A malformed channel id is a code defect
+     * and propagates — the bare `catch` this replaces is precisely what turned the
+     * `''` sentinel into a silent "not configured" (D-43, issue #103).
+     */
+    private readSetting;
+    private resolveMode;
+    private resolveBaseUrl;
+    /**
+     * Whether send-on-issue is enabled for the channel — or, with no channel, for
+     * the platform. It used to answer `false` for the no-channel case without
+     * reading anything, which is how an invoice issued outside a channel reached
+     * the operator with no e-mail and no explanation.
+     */
+    sendOnIssueEnabled(channelId: string | null): Promise<boolean>;
+}
+//# sourceMappingURL=invoice-email-dispatch.d.ts.map

package/dist/backend/services/invoice-email-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-email-dispatch.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-email-dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,aAAa,EACb,WAAW,EACX,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;;;;;;;;;;GAYG;AACH,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,EAAE,cAAc,CAAC;IAChC,SAAS,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IACtD,qBAAqB,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtE,eAAe,EAAE,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;gBAET,IAAI,EAAE,wBAAwB;IAIrD,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9D,OAAO,CAAC,0BAA0B,CAAC;IAoEtC,OAAO,CAAC,OAAO;IAaf;;;;;;OAMG;YACW,WAAW;YAeX,WAAW;YASX,cAAc;IAS5B;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;CAQrE"}

package/dist/backend/services/invoice-email-dispatch.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { SettingNotRegistered, SettingOutOfScopeForChannel, } from '@endora-commerce/platform/kernel';
+import { INVOICES_SETTING_CODES } from '../../manifest.js';
+/**
+ * Dispatches the `invoice_issued` transactional email (feature 047, US5).
+ * Builds template variables, optionally attaches the rendered PDF (attachment
+ * mode) or supplies a storefront download link (link mode), and sends through
+ * the transactional_emails sender. Idempotent on `messageId`.
+ *
+ * **Best-effort, and now audible.** A failure still never throws to the caller
+ * — issuance must not be undone (FR-029) — but the tolerance is narrow: a
+ * `ModuleDisabledError` is a presence answer and is re-thrown, everything else
+ * is named in the result and written to the log. Issue #78 tracks the callers
+ * that discard the result; the log is what covers them until it lands.
+ *
+ * An invoice whose order carries **no sales channel** is an ordinary case, not a
+ * failure: every setting below is then read platform-wide (`null`, D-41), and
+ * the send names the same `null`.
+ */
+export class InvoiceEmailDispatcher {
+    deps;
+    log;
+    constructor(deps) {
+        this.deps = deps;
+        this.log = deps.log ?? ((message, context) => console.warn(message, context));
+    }
+    async dispatch(invoiceId, opts = {}) {
+        try {
+            const sender = this.deps.getSender();
+            if (!sender)
+                return this.notSent(invoiceId, 'no_sender');
+            const detail = await this.deps.invoiceService.buildDetail(invoiceId);
+            if (!detail.orderId)
+                return this.notSent(invoiceId, 'invoice_not_found');
+            const order = await this.deps.orderReadPort.findById(detail.orderId);
+            if (!order)
+                return this.notSent(invoiceId, 'invoice_not_found');
+            const to = await this.deps.resolveRecipientEmail(order);
+            if (!to)
+                return this.notSent(invoiceId, 'no_recipient');
+            const channelId = detail.salesChannelId;
+            const language = await this.deps.resolveLanguage(channelId);
+            const mode = opts.mode ?? (await this.resolveMode(channelId));
+            const baseUrl = await this.resolveBaseUrl(channelId);
+            const downloadUrl = baseUrl
+                ? `${baseUrl.replace(/\/$/, '')}/orders/${detail.orderId}/invoices/${detail.id}/pdf`
+                : '';
+            const variables = {
+                invoice: {
+                    number: detail.number,
+                    total: detail.grossTotal.toFixed(2),
+                    currency: detail.currency,
+                    downloadUrl,
+                },
+                order: { businessId: order.businessId },
+            };
+            const attachments = mode === 'attachment'
+                ? [
+                    {
+                        filename: `invoice-${detail.number.replace(/\W+/g, '_')}.pdf`,
+                        content: await this.deps.pdfRenderer.render(detail),
+                        contentType: 'application/pdf',
+                    },
+                ]
+                : undefined;
+            const outcome = await sender.send({
+                code: 'invoice_issued',
+                salesChannelId: channelId,
+                language,
+                to,
+                messageId: opts.messageId ?? `invoice_issued:${detail.id}`,
+                variables,
+                ...(attachments ? { attachments } : {}),
+                // D-59 — the delivery record has to be findable by the document, not
+                // only by the recipient: "was invoice FV 1/2026 delivered" is the
+                // support question this whole record exists to answer.
+                document: { type: 'invoice', id: detail.id },
+                meta: { kind: 'invoice_issued', invoiceId: detail.id, orderId: detail.orderId },
+            });
+            if (outcome.status !== 'sent')
+                return this.notSent(invoiceId, outcome.status);
+            return { sent: true };
+        }
+        catch (error) {
+            // A switched-off module is a presence answer about the whole operation,
+            // not an e-mail that failed to render; absorbing it would report "sent
+            // nothing" where the truthful answer is "this capability is off".
+            rethrowIfModuleDisabled(error);
+            // Everything else is contained: issuance is committed and must not be
+            // undone because the message did not go out (FR-029). It is named, though.
+            return this.notSent(invoiceId, 'failed', error);
+        }
+    }
+    notSent(invoiceId, reason, error) {
+        this.log('[invoices] the invoice e-mail was not sent', {
+            invoiceId,
+            reason,
+            ...(error === undefined ? {} : { error: error instanceof Error ? error.message : error }),
+        });
+        return { sent: false, reason };
+    }
+    /**
+     * The two conditions that degrade to the module's compiled-in default, and no
+     * others: the setting is not registered yet, or it is scoped to a subset of
+     * channels this read is not inside. A malformed channel id is a code defect
+     * and propagates — the bare `catch` this replaces is precisely what turned the
+     * `''` sentinel into a silent "not configured" (D-43, issue #103).
+     */
+    async readSetting(code, salesChannelId, schema, fallback) {
+        try {
+            return await this.deps.settingsService.get(code, salesChannelId, schema);
+        }
+        catch (error) {
+            if (error instanceof SettingNotRegistered)
+                return fallback;
+            if (error instanceof SettingOutOfScopeForChannel)
+                return fallback;
+            throw error;
+        }
+    }
+    async resolveMode(channelId) {
+        return this.readSetting(INVOICES_SETTING_CODES.EMAIL_DELIVERY_MODE, channelId, z.enum(['attachment', 'link']), 'attachment');
+    }
+    async resolveBaseUrl(channelId) {
+        return this.readSetting(INVOICES_SETTING_CODES.STOREFRONT_BASE_URL, channelId, z.string(), '');
+    }
+    /**
+     * Whether send-on-issue is enabled for the channel — or, with no channel, for
+     * the platform. It used to answer `false` for the no-channel case without
+     * reading anything, which is how an invoice issued outside a channel reached
+     * the operator with no e-mail and no explanation.
+     */
+    async sendOnIssueEnabled(channelId) {
+        return this.readSetting(INVOICES_SETTING_CODES.EMAIL_SEND_ON_ISSUE, channelId, z.boolean(), false);
+    }
+}
+//# sourceMappingURL=invoice-email-dispatch.js.map

package/dist/backend/services/invoice-email-dispatch.js.map

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

package/dist/backend/services/invoice-line-builder.d.ts

@@ -0,0 +1,29 @@
+import type { InvoiceLine, VatSummaryRow } from '@endora-commerce/contracts';
+export interface RawOrderLine {
+    name: string;
+    unit: string;
+    quantity: number;
+    /** Net unit price. */
+    unitNetPrice: number;
+    /** Fractional VAT rate, e.g. 0.23. */
+    taxRate: number;
+    /** Net line value (quantity × unitNetPrice), as stored on the order. */
+    netValue: number;
+    orderItemId?: string | null;
+}
+export interface BuiltInvoiceTotals {
+    lines: Array<InvoiceLine & {
+        orderItemId?: string | null;
+    }>;
+    vatSummary: VatSummaryRow[];
+    netTotal: number;
+    taxTotal: number;
+    grossTotal: number;
+}
+/**
+ * Builds immutable invoice line snapshots + the per-rate VAT summary + totals
+ * from raw order lines. Pure + deterministic so it can be unit-tested in
+ * isolation (SC-003: net + VAT = gross per rate; Σ gross = grand total).
+ */
+export declare function buildInvoiceLines(raw: RawOrderLine[]): BuiltInvoiceTotals;
+//# sourceMappingURL=invoice-line-builder.d.ts.map

package/dist/backend/services/invoice-line-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-line-builder.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-line-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAO7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC5D,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAsCzE"}

package/dist/backend/services/invoice-line-builder.js

@@ -0,0 +1,46 @@
+/** Round to 2 decimals (half-up) for monetary values. */
+function round2(n) {
+    return Math.round((n + Number.EPSILON) * 100) / 100;
+}
+/**
+ * Builds immutable invoice line snapshots + the per-rate VAT summary + totals
+ * from raw order lines. Pure + deterministic so it can be unit-tested in
+ * isolation (SC-003: net + VAT = gross per rate; Σ gross = grand total).
+ */
+export function buildInvoiceLines(raw) {
+    const lines = raw.map((r, i) => {
+        const netValue = round2(r.netValue);
+        const grossValue = round2(netValue * (1 + r.taxRate));
+        return {
+            ordinal: i + 1,
+            name: r.name,
+            unit: r.unit,
+            quantity: r.quantity,
+            unitNetPrice: r.unitNetPrice,
+            taxRate: r.taxRate,
+            netValue,
+            grossValue,
+            orderItemId: r.orderItemId ?? null,
+        };
+    });
+    // Group by VAT rate for the summary table.
+    const byRate = new Map();
+    for (const l of lines) {
+        const cur = byRate.get(l.taxRate) ?? { net: 0, gross: 0 };
+        cur.net += l.netValue;
+        cur.gross += l.grossValue;
+        byRate.set(l.taxRate, cur);
+    }
+    const vatSummary = [...byRate.entries()]
+        .sort((a, b) => a[0] - b[0])
+        .map(([taxRate, v]) => {
+        const netTotal = round2(v.net);
+        const grossTotal = round2(v.gross);
+        return { taxRate, netTotal, vatAmount: round2(grossTotal - netTotal), grossTotal };
+    });
+    const netTotal = round2(vatSummary.reduce((s, r) => s + r.netTotal, 0));
+    const taxTotal = round2(vatSummary.reduce((s, r) => s + r.vatAmount, 0));
+    const grossTotal = round2(vatSummary.reduce((s, r) => s + r.grossTotal, 0));
+    return { lines, vatSummary, netTotal, taxTotal, grossTotal };
+}
+//# sourceMappingURL=invoice-line-builder.js.map

package/dist/backend/services/invoice-line-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-line-builder.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-line-builder.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACtD,CAAC;AAuBD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,OAAO;YACL,OAAO,EAAE,CAAC,GAAG,CAAC;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ;YACR,UAAU;YACV,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0C,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC;QACtB,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,UAAU,GAAoB,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACrF,CAAC,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAE5E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC/D,CAAC"}

package/dist/backend/services/invoice-number-collisions.d.ts

@@ -0,0 +1,17 @@
+import type { NumberPatternCollision, NumberPatternSequenceDefect, NumberingSeries } from '@endora-commerce/contracts';
+/**
+ * `null` when the pattern can produce a distinct number per document.
+ *
+ * A pattern with no sequence token renders one string for a whole year, so it
+ * collides with **itself** on the second document — a self-collision the
+ * pairwise sweep would never look for, and a one-condition check.
+ */
+export declare function patternSequenceDefect(pattern: string): NumberPatternSequenceDefect | null;
+/**
+ * Every pair in `series` that can render one and the same string.
+ *
+ * Each series is rendered once (`n × |grid|`) and the pairwise sweep intersects
+ * the prepared sets, so the cost is never `n² × |grid|` renders.
+ */
+export declare function findNumberPatternCollisions(series: readonly NumberingSeries[]): NumberPatternCollision[];
+//# sourceMappingURL=invoice-number-collisions.d.ts.map

package/dist/backend/services/invoice-number-collisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number-collisions.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-number-collisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EAChB,MAAM,4BAA4B,CAAC;AA4CpC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAEzF;AAkHD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,sBAAsB,EAAE,CA0B1B"}

package/dist/backend/services/invoice-number-collisions.js

@@ -0,0 +1,154 @@
+import { channelDiscriminator, formatInvoiceNumber } from './invoice-number-generator.js';
+/** How far past the current year the sweep looks. */
+const YEAR_HORIZON = 10;
+/** How far a literal 4-digit year in a pattern may reach and still be probed. */
+const LITERAL_YEAR_HORIZON = 100;
+/** `{seq}` or `{seq:N}` — the tokens that make a pattern able to number a series. */
+const SEQUENCE_TOKEN_RE = /\{seq(?::\d+)?\}/;
+/** Every `{seq:N}` width named by a pattern. */
+const PADDING_TOKEN_RE = /\{seq:(\d+)\}/g;
+/** Literal digit runs, i.e. digits that are not part of a token. */
+const TOKEN_RE = /\{(?:seq(?::\d+)?|channel|YYYY|YY|MM)\}/g;
+/**
+ * `null` when the pattern can produce a distinct number per document.
+ *
+ * A pattern with no sequence token renders one string for a whole year, so it
+ * collides with **itself** on the second document — a self-collision the
+ * pairwise sweep would never look for, and a one-condition check.
+ */
+export function patternSequenceDefect(pattern) {
+    return SEQUENCE_TOKEN_RE.test(pattern) ? null : 'no_sequence_token';
+}
+/** The digit runs a pattern contains as literal text, tokens removed first. */
+function literalDigitRuns(pattern) {
+    return pattern.replace(TOKEN_RE, ' ').match(/\d+/g) ?? [];
+}
+/**
+ * The sequence numbers probed, derived from the compared patterns and channels.
+ *
+ * `1…20` is where every first-year collision lives. The padding points are
+ * where `{seq}` and `{seq:N}` converge. The digit-width sweep is what finds the
+ * boundary loss in `FV {channel}{seq}` — `A1` + `2` and `A` + `12` are both
+ * `A12` — so it reaches one digit further than the longest compared code.
+ */
+function sequencePoints(series) {
+    const points = new Set();
+    for (let seq = 1; seq <= 20; seq += 1)
+        points.add(seq);
+    for (const one of series) {
+        for (const match of one.pattern.matchAll(PADDING_TOKEN_RE)) {
+            const width = Number(match[1]);
+            if (!Number.isFinite(width) || width < 1 || width > 9)
+                continue;
+            points.add(10 ** (width - 1) - 1);
+            points.add(10 ** (width - 1));
+            points.add(10 ** width - 1);
+            points.add(10 ** width);
+        }
+    }
+    const longestCode = series.reduce((longest, one) => Math.max(longest, one.salesChannelCode.length), 0);
+    const widths = 1 + Math.max(6, longestCode);
+    for (let k = 1; k <= widths; k += 1) {
+        points.add(10 ** (k - 1));
+        points.add(10 ** k - 1);
+    }
+    return [...points].filter((seq) => seq >= 1).sort((a, b) => a - b);
+}
+/**
+ * The years probed.
+ *
+ * Never a year before the current one: `issuedAt` is `new Date()` at issuance,
+ * so a past year is unreachable and probing one would refuse a configuration
+ * that cannot collide. The literal-derived years are the plausible operator
+ * mistake — `FV {seq}/2026` typed instead of `FV {seq}/{YYYY}`.
+ */
+function yearPoints(series, currentYear) {
+    const points = new Set();
+    for (let year = currentYear; year <= currentYear + YEAR_HORIZON; year += 1)
+        points.add(year);
+    for (const one of series) {
+        for (const run of literalDigitRuns(one.pattern)) {
+            if (run.length === 4) {
+                const year = Number(run);
+                if (year >= currentYear && year <= currentYear + LITERAL_YEAR_HORIZON)
+                    points.add(year);
+            }
+            else if (run.length === 2) {
+                const twoDigit = Number(run);
+                // The first year at or after the current one whose `YY` equals the run.
+                const candidate = Math.floor(currentYear / 100) * 100 + twoDigit;
+                points.add(candidate >= currentYear ? candidate : candidate + 100);
+            }
+        }
+    }
+    return [...points].sort((a, b) => a - b);
+}
+/**
+ * The grid, restricted to the dimensions this pattern actually uses.
+ *
+ * A pattern without `{MM}` renders the same string for all twelve months, so
+ * probing twelve of them is twelve times the work for one `Set` member. The
+ * restriction changes no result — it only skips renders whose output is already
+ * in the set — and it is what keeps a 50-series sweep inside its budget.
+ */
+function probePoints(pattern, seqs, years) {
+    const usesMonth = pattern.includes('{MM}');
+    const usesYear = pattern.includes('{YYYY}') || pattern.includes('{YY}');
+    const usesSeq = SEQUENCE_TOKEN_RE.test(pattern);
+    const seqPoints = usesSeq ? seqs : [1];
+    const yearPointsUsed = usesYear ? years : [years[0] ?? new Date().getFullYear()];
+    const monthPoints = usesMonth ? [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12] : [1];
+    const points = [];
+    for (const seq of seqPoints) {
+        for (const year of yearPointsUsed) {
+            for (const month of monthPoints) {
+                // Local time: `formatInvoiceNumber` reads `getFullYear`/`getMonth`.
+                points.push({ seq, date: new Date(year, month - 1, 15, 12) });
+            }
+        }
+    }
+    return points;
+}
+/** Every string a series can render over the grid. */
+function renderSet(one, seqs, years) {
+    const channel = channelDiscriminator(one.salesChannelCode);
+    const rendered = new Set();
+    for (const point of probePoints(one.pattern, seqs, years)) {
+        rendered.add(formatInvoiceNumber(one.pattern, { seq: point.seq, date: point.date, channel }));
+    }
+    return rendered;
+}
+/**
+ * Every pair in `series` that can render one and the same string.
+ *
+ * Each series is rendered once (`n × |grid|`) and the pairwise sweep intersects
+ * the prepared sets, so the cost is never `n² × |grid|` renders.
+ */
+export function findNumberPatternCollisions(series) {
+    if (series.length < 2)
+        return [];
+    const currentYear = new Date().getFullYear();
+    const seqs = sequencePoints(series);
+    const years = yearPoints(series, currentYear);
+    const sets = series.map((one) => renderSet(one, seqs, years));
+    const collisions = [];
+    for (let i = 0; i < series.length; i += 1) {
+        for (let j = i + 1; j < series.length; j += 1) {
+            const left = sets[i];
+            const right = sets[j];
+            const [smaller, larger] = left.size <= right.size ? [left, right] : [right, left];
+            let example = null;
+            for (const candidate of smaller) {
+                if (larger.has(candidate)) {
+                    example = candidate;
+                    break;
+                }
+            }
+            if (example !== null) {
+                collisions.push({ a: series[i], b: series[j], example });
+            }
+        }
+    }
+    return collisions;
+}
+//# sourceMappingURL=invoice-number-collisions.js.map

package/dist/backend/services/invoice-number-collisions.js.map

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

package/dist/backend/services/invoice-number-generator.d.ts

@@ -0,0 +1,96 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { z } from 'zod';
+export type InvoiceKind = 'proforma' | 'invoice' | 'correction';
+/**
+ * Resolves the format pattern for a (kind, salesChannel) — settings-backed in
+ * production, but injectable so the formatter and counter can be unit-tested in
+ * isolation.
+ */
+export interface NumberPatternResolver {
+    resolvePattern(kind: InvoiceKind, salesChannelId: string): Promise<string>;
+}
+/**
+ * The shipped defaults, which **must** stay identical to the manifest
+ * `defaultValue`s (`manifest.ts`): the manifest default is what production
+ * resolves, and this map is only reached when the settings read throws.
+ *
+ * The `/` on both sides of `{channel}` is load-bearing, not cosmetic. A
+ * discriminator concatenated straight onto the sequence loses the boundary
+ * between the two variable-length fields, so `FV {channel}{seq}/{YYYY}` renders
+ * `FV A12/2026` for both (`a1`, seq 2) and (`a`, seq 12) — see D-95.1
+ * property 3.
+ */
+declare const DEFAULT_PATTERNS: Record<InvoiceKind, string>;
+/** The pre-D-95 defaults, kept for the system-default channel (D-95.3 move 3). */
+export declare const PRE_CHANNEL_DEFAULT_PATTERNS: Record<InvoiceKind, string>;
+/**
+ * The pattern a stored setting value really means: a blank value is not an
+ * empty pattern, it is "unset", and it resolves to the default. Two channels
+ * can therefore collide while their stored values differ, which is why the
+ * collision predicate compares what would be *resolved* and never the raw row.
+ */
+export declare function effectivePattern(kind: InvoiceKind, stored: string | null | undefined): string;
+/** The render context. `channel` is required — see {@link formatInvoiceNumber}. */
+export interface InvoiceNumberContext {
+    readonly seq: number;
+    readonly date: Date;
+    /** The discriminator `{channel}` renders: the channel `code`, uppercased. */
+    readonly channel: string;
+}
+/**
+ * Render an invoice-number pattern. Supported tokens:
+ *   {seq}      — sequence number
+ *   {seq:N}    — zero-padded to width N
+ *   {channel}  — the sales channel discriminator (feature 078, D-95)
+ *   {YYYY}     — 4-digit year
+ *   {YY}       — 2-digit year
+ *   {MM}       — 2-digit month
+ * Everything else is literal (so prefix/suffix are just literal text).
+ *
+ * `channel` is a **required** member of the context, not an optional one
+ * defaulting to `''`: an absent discriminator makes every channel render
+ * identically, which is the defect this token exists to remove. A caller that
+ * cannot name a channel must fail rather than render.
+ *
+ * Pure — the collision predicate and the boot report both call it directly.
+ */
+export declare function formatInvoiceNumber(pattern: string, ctx: InvoiceNumberContext): string;
+/**
+ * The discriminator a channel code renders as: uppercase, and otherwise
+ * verbatim. The code charset is `/^[a-z][a-z0-9_-]*$/`, so uppercasing is
+ * injective — no two channels can produce the same discriminator. Stripping or
+ * folding any character would break that and is forbidden.
+ */
+export declare function channelDiscriminator(code: string): string;
+/**
+ * Draws gap-free, per-(channel, kind, year) sequence numbers under a pessimistic
+ * row lock and assembles the human-readable number from the configured pattern.
+ */
+export declare class InvoiceNumberGenerator {
+    private readonly patterns?;
+    constructor(patterns?: NumberPatternResolver | undefined);
+    /** Must run inside an open transaction (`em.transactional(...)`). */
+    next(tx: EntityManager, kind: InvoiceKind, salesChannelId: string, issuedAt: Date): Promise<string>;
+    /**
+     * The `{channel}` discriminator for a channel id, read from the kernel's
+     * `sales_channels` row.
+     *
+     * An absent row **fails** rather than rendering an empty discriminator. A
+     * fallback here would put every channel back on one string and restore the
+     * defect this feature removes; a `salesChannelId` with no row behind it is a
+     * data defect in whatever produced it (`Order.salesChannelId` is non-nullable
+     * and a system-default channel always exists), and it is reported, not
+     * absorbed.
+     */
+    private resolveDiscriminator;
+    private resolvePattern;
+}
+/**
+ * Settings-backed pattern resolver: reads `invoices.numbering.<kind>.pattern`
+ * per sales channel, falling back to the built-in default.
+ */
+export declare function createSettingsPatternResolver(settingsService: {
+    get<T>(code: string, salesChannelId: string, schema: z.ZodType<T>): Promise<T>;
+}): NumberPatternResolver;
+export { DEFAULT_PATTERNS };
+//# sourceMappingURL=invoice-number-generator.d.ts.map

package/dist/backend/services/invoice-number-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-number-generator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-number-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAED;;;;;;;;;;GAUG;AACH,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIjD,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAIpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE7F;AAED,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAetF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAT,QAAQ,CAAC,EAAE,qBAAqB,YAAA;IAE7D,qEAAqE;IAC/D,IAAI,CACR,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,WAAW,EACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,IAAI,GACb,OAAO,CAAC,MAAM,CAAC;IAwBlB;;;;;;;;;;OAUG;YACW,oBAAoB;YAapB,cAAc;CAQ7B;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,eAAe,EAAE;IAC7D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF,GAAG,qBAAqB,CAcxB;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}