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

package/dist/backend/services/numbering-configuration.d.ts

@@ -0,0 +1,76 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { NumberingSeries, SettingsAdminPort } from '@endora-commerce/contracts';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { type InvoiceKind } from './invoice-number-generator.js';
+/** What this service writes to. `warn` is the report; nothing here blocks boot. */
+export interface NumberingConfigurationLogger {
+    info(obj: object, msg: string): void;
+    warn(obj: object, msg: string): void;
+}
+/**
+ * The numbering configuration a deployment boots with — feature 078, D-95.3
+ * and D-95.4.
+ *
+ * Two jobs, in this order and for a stated reason:
+ *
+ *  1. **Grandfather the system-default channel.** The shipped defaults now
+ *     carry `{channel}`, so a fresh deployment numbers `FV 1/DEFAULT/2026`
+ *     unless something says otherwise. An accountant expects `FV 1/2026`, and
+ *     an existing deployment's series must not change shape mid-year, so the
+ *     system-default channel is pinned to the pre-D-95 pattern as an explicit
+ *     per-channel value — **only** while the setting is otherwise untouched.
+ *     The platform picks a default for you and never rewrites your choice.
+ *  2. **Report what is left.** Every `(kind, channel)` pair goes through the
+ *     collision predicate and each colliding pair is logged as a `warn`. It
+ *     runs *after* step 1 so it never names a pair the same boot has just
+ *     repaired — a report full of noise is a report nobody reads within a week.
+ *     It does not block boot: what survives step 1 is a pattern the operator
+ *     configured themselves, and refusing to start would take down the
+ *     storefront, the catalogue and the checkout to protect an invoice the
+ *     issuance refusal already protects.
+ */
+export declare class NumberingConfigurationService {
+    private readonly emFactory;
+    /**
+     * The audited settings write (Constitution XIII), read per call rather than
+     * captured: `settings` is non-deactivatable, so the gate has no "no" to
+     * give, but the accessor keeps this service from freezing a registration.
+     */
+    private readonly settingsAdmin;
+    private readonly log;
+    constructor(emFactory: () => EntityManager, 
+    /**
+     * The audited settings write (Constitution XIII), read per call rather than
+     * captured: `settings` is non-deactivatable, so the gate has no "no" to
+     * give, but the accessor keeps this service from freezing a registration.
+     */
+    settingsAdmin: () => SettingsAdminPort, log: NumberingConfigurationLogger);
+    /** Both jobs, in order. Called once per boot. */
+    reconcile(): Promise<void>;
+    /**
+     * D-95.3 move 3 — pin the system-default channel to the pre-D-95 pattern,
+     * once, and only while nobody has configured the setting.
+     *
+     * "Untouched" is `globalValue === null` **and** no `SettingValue` row for the
+     * system-default channel. An operator who wrote a pattern — even one that now
+     * collides — keeps it; that case belongs to the report and to the two
+     * refusals, never to a silent rewrite.
+     */
+    private pinSystemDefaultChannel;
+    /** Every `(kind, channel)` series the platform currently resolves. */
+    seriesFor(kind: InvoiceKind): Promise<NumberingSeries[]>;
+    /**
+     * D-95.4 — name every surviving collision, loudly, and do not block boot.
+     *
+     * The count line is emitted even when the count is zero, so its absence means
+     * the report did not run rather than that it found nothing.
+     */
+    reportCollisions(): Promise<number>;
+}
+/**
+ * A channel's display name. `SalesChannel.name` is a per-language map, so a
+ * caller that needs one string picks English, then whatever is there, then the
+ * code — which is never empty.
+ */
+export declare function channelName(channel: SalesChannel): string;
+//# sourceMappingURL=numbering-configuration.d.ts.map

package/dist/backend/services/numbering-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-configuration.d.ts","sourceRoot":"","sources":["../../../src/backend/services/numbering-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAEV,eAAe,EACf,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKhE,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAWvC,mFAAmF;AACnF,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,6BAA6B;IAEtC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAPH,SAAS,EAAE,MAAM,aAAa;IAC/C;;;;OAIG;IACc,aAAa,EAAE,MAAM,iBAAiB,EACtC,GAAG,EAAE,4BAA4B;IAGpD,iDAAiD;IAC3C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKhC;;;;;;;;OAQG;YACW,uBAAuB;IAkErC,sEAAsE;IAChE,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqB9D;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAe1C;AAaD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAGzD"}

package/dist/backend/services/numbering-configuration.js

@@ -0,0 +1,176 @@
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { Setting } from '@endora-commerce/platform/kernel';
+import { SettingValue } from '@endora-commerce/platform/kernel';
+import { INVOICES_SETTING_CODES } from '../../manifest.js';
+import { findNumberPatternCollisions } from './invoice-number-collisions.js';
+import { PRE_CHANNEL_DEFAULT_PATTERNS, effectivePattern, } from './invoice-number-generator.js';
+/** The three numbering settings, in the order an operator meets them. */
+const PATTERN_SETTING_CODE = {
+    invoice: INVOICES_SETTING_CODES.NUMBERING_INVOICE_PATTERN,
+    proforma: INVOICES_SETTING_CODES.NUMBERING_PROFORMA_PATTERN,
+    correction: INVOICES_SETTING_CODES.NUMBERING_CORRECTION_PATTERN,
+};
+const KINDS = ['invoice', 'proforma', 'correction'];
+/**
+ * The numbering configuration a deployment boots with — feature 078, D-95.3
+ * and D-95.4.
+ *
+ * Two jobs, in this order and for a stated reason:
+ *
+ *  1. **Grandfather the system-default channel.** The shipped defaults now
+ *     carry `{channel}`, so a fresh deployment numbers `FV 1/DEFAULT/2026`
+ *     unless something says otherwise. An accountant expects `FV 1/2026`, and
+ *     an existing deployment's series must not change shape mid-year, so the
+ *     system-default channel is pinned to the pre-D-95 pattern as an explicit
+ *     per-channel value — **only** while the setting is otherwise untouched.
+ *     The platform picks a default for you and never rewrites your choice.
+ *  2. **Report what is left.** Every `(kind, channel)` pair goes through the
+ *     collision predicate and each colliding pair is logged as a `warn`. It
+ *     runs *after* step 1 so it never names a pair the same boot has just
+ *     repaired — a report full of noise is a report nobody reads within a week.
+ *     It does not block boot: what survives step 1 is a pattern the operator
+ *     configured themselves, and refusing to start would take down the
+ *     storefront, the catalogue and the checkout to protect an invoice the
+ *     issuance refusal already protects.
+ */
+export class NumberingConfigurationService {
+    emFactory;
+    settingsAdmin;
+    log;
+    constructor(emFactory, 
+    /**
+     * The audited settings write (Constitution XIII), read per call rather than
+     * captured: `settings` is non-deactivatable, so the gate has no "no" to
+     * give, but the accessor keeps this service from freezing a registration.
+     */
+    settingsAdmin, log) {
+        this.emFactory = emFactory;
+        this.settingsAdmin = settingsAdmin;
+        this.log = log;
+    }
+    /** Both jobs, in order. Called once per boot. */
+    async reconcile() {
+        await this.pinSystemDefaultChannel();
+        await this.reportCollisions();
+    }
+    /**
+     * D-95.3 move 3 — pin the system-default channel to the pre-D-95 pattern,
+     * once, and only while nobody has configured the setting.
+     *
+     * "Untouched" is `globalValue === null` **and** no `SettingValue` row for the
+     * system-default channel. An operator who wrote a pattern — even one that now
+     * collides — keeps it; that case belongs to the report and to the two
+     * refusals, never to a silent rewrite.
+     */
+    async pinSystemDefaultChannel() {
+        const em = this.emFactory();
+        const systemDefault = await em.findOne(SalesChannel, { systemDefault: true });
+        if (!systemDefault) {
+            // A system-default channel always exists (the boot reconciler owns that
+            // invariant). Reporting rather than inventing one: a fabricated channel
+            // here would pin a series to a row that is not the platform's default.
+            this.log.warn({ module: 'invoices' }, 'invoices: no system-default sales channel, so the pre-D-95 numbering pattern was not pinned');
+            return;
+        }
+        for (const kind of KINDS) {
+            const code = PATTERN_SETTING_CODE[kind];
+            const setting = await em.findOne(Setting, { code });
+            if (!setting)
+                continue;
+            if (setting.globalValue !== null && setting.globalValue !== undefined)
+                continue;
+            const existing = await em.findOne(SettingValue, {
+                setting,
+                salesChannel: systemDefault.id,
+            });
+            if (existing)
+                continue;
+            try {
+                await this.settingsAdmin().setValueForSubset(code, [systemDefault.code], PRE_CHANNEL_DEFAULT_PATTERNS[kind], null, { actorAdminUserId: null });
+            }
+            catch (err) {
+                // A switched-off `settings` is not a tolerable outcome here — the write
+                // is the whole point of the hook — so the gate's answer goes straight
+                // back out, before any other test. `ModuleDisabledError` is an
+                // `HttpError`, so an `instanceof` or status test would let it through
+                // by accident rather than by decision.
+                rethrowIfModuleDisabled(err);
+                // The narrow tolerance, and it is D-95.4 written as code: another
+                // channel already carries the historical pattern as an explicit value,
+                // so pinning it here would duplicate it and the module's own write
+                // validator refuses. That is a configuration the operator made, and
+                // refusing to boot over it would take down the storefront, the
+                // catalogue and the checkout to protect an invoice the issuance refusal
+                // already protects. The report below names the pair; nothing is
+                // silently absorbed.
+                this.log.warn({
+                    module: 'invoices',
+                    settingCode: code,
+                    salesChannelCode: systemDefault.code,
+                    reason: err instanceof Error ? err.message : String(err),
+                }, 'invoices: could not pin the system-default channel to its historical numbering pattern');
+                continue;
+            }
+            this.log.info({ module: 'invoices', settingCode: code, salesChannelCode: systemDefault.code }, 'invoices: pinned the system-default channel to its historical numbering pattern');
+        }
+    }
+    /** Every `(kind, channel)` series the platform currently resolves. */
+    async seriesFor(kind) {
+        const em = this.emFactory();
+        const channels = await em.find(SalesChannel, {});
+        const setting = await em.findOne(Setting, { code: PATTERN_SETTING_CODE[kind] });
+        const values = setting
+            ? await em.find(SettingValue, { setting }, { populate: ['salesChannel'] })
+            : [];
+        const byChannelId = new Map(values.map((value) => [value.salesChannel.id, value.value]));
+        const globalValue = setting?.globalValue;
+        return channels.map((channel) => {
+            const stored = byChannelId.has(channel.id) ? byChannelId.get(channel.id) : globalValue;
+            return {
+                salesChannelId: channel.id,
+                salesChannelCode: channel.code,
+                salesChannelName: channelName(channel),
+                pattern: effectivePattern(kind, typeof stored === 'string' ? stored : null),
+            };
+        });
+    }
+    /**
+     * D-95.4 — name every surviving collision, loudly, and do not block boot.
+     *
+     * The count line is emitted even when the count is zero, so its absence means
+     * the report did not run rather than that it found nothing.
+     */
+    async reportCollisions() {
+        let total = 0;
+        for (const kind of KINDS) {
+            const collisions = findNumberPatternCollisions(await this.seriesFor(kind));
+            total += collisions.length;
+            for (const collision of collisions) {
+                this.log.warn(describeCollision(kind, collision), 'invoices: two sales channels can produce the same document number');
+            }
+        }
+        this.log.info({ module: 'invoices', collidingPairs: total }, 'invoices: numbering pattern collision report');
+        return total;
+    }
+}
+/** The `warn` payload — both channel codes, both patterns and the proof. */
+function describeCollision(kind, collision) {
+    return {
+        module: 'invoices',
+        kind,
+        salesChannelCodes: [collision.a.salesChannelCode, collision.b.salesChannelCode],
+        patterns: [collision.a.pattern, collision.b.pattern],
+        example: collision.example,
+    };
+}
+/**
+ * A channel's display name. `SalesChannel.name` is a per-language map, so a
+ * caller that needs one string picks English, then whatever is there, then the
+ * code — which is never empty.
+ */
+export function channelName(channel) {
+    const names = channel.name ?? {};
+    return names['en'] ?? Object.values(names)[0] ?? channel.code;
+}
+//# sourceMappingURL=numbering-configuration.js.map

package/dist/backend/services/numbering-configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-configuration.js","sourceRoot":"","sources":["../../../src/backend/services/numbering-configuration.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AAEvC,yEAAyE;AACzE,MAAM,oBAAoB,GAAgC;IACxD,OAAO,EAAE,sBAAsB,CAAC,yBAAyB;IACzD,QAAQ,EAAE,sBAAsB,CAAC,0BAA0B;IAC3D,UAAU,EAAE,sBAAsB,CAAC,4BAA4B;CAChE,CAAC;AAEF,MAAM,KAAK,GAA2B,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAQ5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,6BAA6B;IAErB;IAMA;IACA;IARnB,YACmB,SAA8B;IAC/C;;;;OAIG;IACc,aAAsC,EACtC,GAAiC;QAPjC,cAAS,GAAT,SAAS,CAAqB;QAM9B,kBAAa,GAAb,aAAa,CAAyB;QACtC,QAAG,GAAH,GAAG,CAA8B;IACjD,CAAC;IAEJ,iDAAiD;IACjD,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACrC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,uBAAuB;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,wEAAwE;YACxE,wEAAwE;YACxE,uEAAuE;YACvE,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,MAAM,EAAE,UAAU,EAAE,EACtB,6FAA6F,CAC9F,CAAC;YACF,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;gBAAE,SAAS;YAChF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE;gBAC9C,OAAO;gBACP,YAAY,EAAE,aAAa,CAAC,EAAE;aAC/B,CAAC,CAAC;YACH,IAAI,QAAQ;gBAAE,SAAS;YAEvB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,iBAAiB,CAC1C,IAAI,EACJ,CAAC,aAAa,CAAC,IAAI,CAAC,EACpB,4BAA4B,CAAC,IAAI,CAAC,EAClC,IAAI,EACJ,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC3B,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wEAAwE;gBACxE,sEAAsE;gBACtE,+DAA+D;gBAC/D,sEAAsE;gBACtE,uCAAuC;gBACvC,uBAAuB,CAAC,GAAG,CAAC,CAAC;gBAC7B,kEAAkE;gBAClE,uEAAuE;gBACvE,mEAAmE;gBACnE,oEAAoE;gBACpE,+DAA+D;gBAC/D,wEAAwE;gBACxE,gEAAgE;gBAChE,qBAAqB;gBACrB,IAAI,CAAC,GAAG,CAAC,IAAI,CACX;oBACE,MAAM,EAAE,UAAU;oBAClB,WAAW,EAAE,IAAI;oBACjB,gBAAgB,EAAE,aAAa,CAAC,IAAI;oBACpC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACzD,EACD,wFAAwF,CACzF,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,CAAC,IAAI,EAAE,EAC/E,iFAAiF,CAClF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,SAAS,CAAC,IAAiB;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,OAAO;YACpB,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;QAEzC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;YACvF,OAAO;gBACL,cAAc,EAAE,OAAO,CAAC,EAAE;gBAC1B,gBAAgB,EAAE,OAAO,CAAC,IAAI;gBAC9B,gBAAgB,EAAE,WAAW,CAAC,OAAO,CAAC;gBACtC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;aAC5E,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC;YAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,mEAAmE,CAAC,CAAC;YACzH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,EAC7C,8CAA8C,CAC/C,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,4EAA4E;AAC5E,SAAS,iBAAiB,CAAC,IAAiB,EAAE,SAAiC;IAC7E,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,IAAI;QACJ,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC/E,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QACpD,OAAO,EAAE,SAAS,CAAC,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;AAChE,CAAC"}

package/dist/backend/services/numbering-write-validator.d.ts

@@ -0,0 +1,22 @@
+import { type SettingWriteValidator } from '@endora-commerce/contracts';
+/**
+ * `invoices`' answer to "is this numbering configuration legal" — feature 078,
+ * D-95.2.
+ *
+ * `settings` hands over what every channel's value would be after the write;
+ * this decides whether two of them can render one string. It refuses a
+ * **possible** collision, not an actual one, and that asymmetry with the
+ * issuance refusal is the point: at a settings write the operator is
+ * configuring and nothing is at stake, so a conservative refusal costs them one
+ * edit; at issuance a customer's document is at stake, so only a duplicate the
+ * database has actually rejected is refused.
+ *
+ * The predicate is over the **post-write state**, not over the delta, so
+ * re-saving a value that already collides is refused too. That is what an
+ * operator needs: the question is whether the configuration they are about to
+ * confirm is one the platform can number, not whether they changed anything.
+ *
+ * Pure: no I/O. Everything it needs is in the projection.
+ */
+export declare function createNumberingPatternValidator(): SettingWriteValidator;
+//# sourceMappingURL=numbering-write-validator.d.ts.map

package/dist/backend/services/numbering-write-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-write-validator.d.ts","sourceRoot":"","sources":["../../../src/backend/services/numbering-write-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AAepC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,IAAI,qBAAqB,CAQvE"}

package/dist/backend/services/numbering-write-validator.js

@@ -0,0 +1,82 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { INVOICES_SETTING_CODES } from '../../manifest.js';
+import { findNumberPatternCollisions, patternSequenceDefect, } from './invoice-number-collisions.js';
+import { effectivePattern } from './invoice-number-generator.js';
+const KIND_BY_SETTING_CODE = {
+    [INVOICES_SETTING_CODES.NUMBERING_INVOICE_PATTERN]: 'invoice',
+    [INVOICES_SETTING_CODES.NUMBERING_PROFORMA_PATTERN]: 'proforma',
+    [INVOICES_SETTING_CODES.NUMBERING_CORRECTION_PATTERN]: 'correction',
+};
+/**
+ * `invoices`' answer to "is this numbering configuration legal" — feature 078,
+ * D-95.2.
+ *
+ * `settings` hands over what every channel's value would be after the write;
+ * this decides whether two of them can render one string. It refuses a
+ * **possible** collision, not an actual one, and that asymmetry with the
+ * issuance refusal is the point: at a settings write the operator is
+ * configuring and nothing is at stake, so a conservative refusal costs them one
+ * edit; at issuance a customer's document is at stake, so only a duplicate the
+ * database has actually rejected is refused.
+ *
+ * The predicate is over the **post-write state**, not over the delta, so
+ * re-saving a value that already collides is refused too. That is what an
+ * operator needs: the question is whether the configuration they are about to
+ * confirm is one the platform can number, not whether they changed anything.
+ *
+ * Pure: no I/O. Everything it needs is in the projection.
+ */
+export function createNumberingPatternValidator() {
+    return {
+        contributorModuleId: 'invoices',
+        codes: Object.keys(KIND_BY_SETTING_CODE),
+        validate: async (input) => {
+            refuseIllegalNumbering(input);
+        },
+    };
+}
+function refuseIllegalNumbering(input) {
+    const kind = KIND_BY_SETTING_CODE[input.code];
+    if (kind === undefined)
+        return;
+    const series = input.projection.map((channel) => ({
+        salesChannelId: channel.salesChannelId,
+        salesChannelCode: channel.salesChannelCode,
+        salesChannelName: channel.salesChannelName,
+        pattern: effectivePattern(kind, typeof channel.value === 'string' ? channel.value : null),
+    }));
+    // 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. Checked on the series this write sets: a
+    // platform-wide write reaches every channel without its own row, so it is
+    // checked against all of them.
+    const targeted = new Set(input.targetedChannelIds);
+    const written = targeted.size > 0
+        ? series.filter((one) => targeted.has(one.salesChannelId))
+        : series;
+    if (written.some((one) => patternSequenceDefect(one.pattern) !== null)) {
+        throw new HttpError(400, ERROR_CODES.INVOICE_NUMBER_PATTERN_COLLIDES, 'This numbering pattern has no sequence token, so every document in this sales ' +
+            'channel would be given the same number.', { code: 'no_sequence_token', kind });
+    }
+    const [collision] = findNumberPatternCollisions(series);
+    if (collision === undefined)
+        return;
+    // Name the channel the operator is *not* editing — that is the one they have
+    // to reason about. A platform-wide write targets nobody, so either side is as
+    // informative as the other.
+    const other = targeted.has(collision.a.salesChannelId) ? collision.b : collision.a;
+    throw new HttpError(400, ERROR_CODES.INVOICE_NUMBER_PATTERN_COLLIDES, `This numbering pattern can produce the same document number as sales channel ` +
+        `"${other.salesChannelName}".`, {
+        code: 'other_channel',
+        kind,
+        channel: other.salesChannelName,
+        channelCode: other.salesChannelCode,
+        // Never interpolated into a sentence: a pattern contains `{seq}`, and the
+        // envelope discards a translation with an unfilled placeholder whole. It
+        // travels here for the admin UI to render outside the message.
+        otherPattern: other.pattern,
+        example: collision.example,
+    });
+}
+//# sourceMappingURL=numbering-write-validator.js.map

package/dist/backend/services/numbering-write-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-write-validator.js","sourceRoot":"","sources":["../../../src/backend/services/numbering-write-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAIZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,+BAA+B,CAAC;AAEnF,MAAM,oBAAoB,GAAgC;IACxD,CAAC,sBAAsB,CAAC,yBAAyB,CAAC,EAAE,SAAS;IAC7D,CAAC,sBAAsB,CAAC,0BAA0B,CAAC,EAAE,UAAU;IAC/D,CAAC,sBAAsB,CAAC,4BAA4B,CAAC,EAAE,YAAY;CACpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,mBAAmB,EAAE,UAAU;QAC/B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC;QACxC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAkC;IAChE,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAE/B,MAAM,MAAM,GAAsB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnE,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;KAC1F,CAAC,CAAC,CAAC;IAEJ,8EAA8E;IAC9E,8EAA8E;IAC9E,uEAAuE;IACvE,0EAA0E;IAC1E,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC;QAC/B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC1D,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,+BAA+B,EAC3C,gFAAgF;YAC9E,yCAAyC,EAC3C,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,CACpC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IAEpC,6EAA6E;IAC7E,8EAA8E;IAC9E,4BAA4B;IAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnF,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,+BAA+B,EAC3C,+EAA+E;QAC7E,IAAI,KAAK,CAAC,gBAAgB,IAAI,EAChC;QACE,IAAI,EAAE,eAAe;QACrB,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,gBAAgB;QAC/B,WAAW,EAAE,KAAK,CAAC,gBAAgB;QACnC,0EAA0E;QAC1E,yEAAyE;QACzE,+DAA+D;QAC/D,YAAY,EAAE,KAAK,CAAC,OAAO;QAC3B,OAAO,EAAE,SAAS,CAAC,OAAO;KAC3B,CACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/seller-settings.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { type SellerCompanyData } from '@endora-commerce/contracts';
+/**
+ * The slice of `SettingsService` this module reads through.
+ *
+ * `salesChannelId` is `string | null`, matching the service (D-41): `null` is a
+ * platform-wide read, and it is the only honest thing to pass for an invoice
+ * whose order carries no channel. The narrower `string` this used to declare is
+ * what pushed `invoices` into the `''` sentinel (issue #103).
+ */
+export interface SettingsReader {
+    get<T>(code: string, salesChannelId: string | null, schema: z.ZodType<T>): Promise<T>;
+}
+/**
+ * Resolves the seller (own company) data + VAT/NIP from settings for a sales
+ * channel and merges them. Throws an actionable 422 when the minimum required
+ * fields are missing so issuance never produces an invalid document (FR-006).
+ */
+export declare class SellerSettingsResolver {
+    private readonly settings;
+    constructor(settings: SettingsReader);
+    resolve(salesChannelId: string): Promise<SellerCompanyData>;
+}
+//# sourceMappingURL=seller-settings.d.ts.map

package/dist/backend/services/seller-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-settings.d.ts","sourceRoot":"","sources":["../../../src/backend/services/seller-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG7F;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE/C,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA6BlE"}

package/dist/backend/services/seller-settings.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { HttpError } from '@endora-commerce/platform/http';
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { sellerCompanyDataSchema } from '@endora-commerce/contracts';
+import { INVOICES_SETTING_CODES } from '../../manifest.js';
+/**
+ * Resolves the seller (own company) data + VAT/NIP from settings for a sales
+ * channel and merges them. Throws an actionable 422 when the minimum required
+ * fields are missing so issuance never produces an invalid document (FR-006).
+ */
+export class SellerSettingsResolver {
+    settings;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    async resolve(salesChannelId) {
+        let taxId = '';
+        let raw = {};
+        try {
+            taxId = await this.settings.get(INVOICES_SETTING_CODES.SELLER_TAX_ID, salesChannelId, z.string());
+        }
+        catch {
+            taxId = '';
+        }
+        try {
+            raw = await this.settings.get(INVOICES_SETTING_CODES.SELLER_COMPANY_DATA, salesChannelId, z.record(z.string(), z.unknown()));
+        }
+        catch {
+            raw = {};
+        }
+        const parsed = sellerCompanyDataSchema.safeParse({ ...raw, taxId: taxId || raw.taxId });
+        if (!parsed.success || !parsed.data.legalName || !parsed.data.taxId) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Seller VAT/NIP and company data must be configured before issuing invoices.', { setting: 'invoices.seller.company_data' });
+        }
+        return parsed.data;
+    }
+}
+//# sourceMappingURL=seller-settings.js.map

package/dist/backend/services/seller-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seller-settings.js","sourceRoot":"","sources":["../../../src/backend/services/seller-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAA0B,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAc3D;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD,KAAK,CAAC,OAAO,CAAC,cAAsB;QAClC,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,GAAG,GAAY,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,aAAa,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,EAAE,CAAC;QACb,CAAC;QACD,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC3B,sBAAsB,CAAC,mBAAmB,EAC1C,cAAc,EACd,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAClC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,EAAE,GAAI,GAAc,EAAE,KAAK,EAAE,KAAK,IAAK,GAA0B,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5H,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpE,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,iBAAiB,EAC7B,6EAA6E,EAC7E,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAC5C,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/backend/services/vendor-number-hold.d.ts

@@ -0,0 +1,10 @@
+export interface LedgerNumberingLookup {
+    numberingModeFor(salesChannelId: string | null): Promise<'endora' | 'vendor'>;
+    activeVendorModuleId(): Promise<string | null>;
+}
+/**
+ * Mode B wait: vendor numbering and an active ledger vendor keep the invoice
+ * pending so PDF/email wait for applyVendorAssignedNumber.
+ */
+export declare function shouldHoldForVendorNumber(routing: LedgerNumberingLookup | undefined, salesChannelId: string | null): Promise<boolean>;
+//# sourceMappingURL=vendor-number-hold.d.ts.map

package/dist/backend/services/vendor-number-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-number-hold.d.ts","sourceRoot":"","sources":["../../../src/backend/services/vendor-number-hold.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC9E,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/backend/services/vendor-number-hold.js

@@ -0,0 +1,14 @@
+/**
+ * Mode B wait: vendor numbering and an active ledger vendor keep the invoice
+ * pending so PDF/email wait for applyVendorAssignedNumber.
+ */
+export async function shouldHoldForVendorNumber(routing, salesChannelId) {
+    if (!routing)
+        return false;
+    const [mode, vendor] = await Promise.all([
+        routing.numberingModeFor(salesChannelId),
+        routing.activeVendorModuleId(),
+    ]);
+    return mode === 'vendor' && vendor !== null;
+}
+//# sourceMappingURL=vendor-number-hold.js.map

package/dist/backend/services/vendor-number-hold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-number-hold.js","sourceRoot":"","sources":["../../../src/backend/services/vendor-number-hold.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAA0C,EAC1C,cAA6B;IAE7B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvC,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC;QACxC,OAAO,CAAC,oBAAoB,EAAE;KAC/B,CAAC,CAAC;IACH,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC;AAC9C,CAAC"}