@endora-commerce/mod-invoice-ledger 0.100.0

package/dist/backend/services/invoice-ledger-routing.service.d.ts

@@ -0,0 +1,11 @@
+import { type InvoiceLedgerNativeKsefAction, type InvoiceLedgerNumberingMode, type InvoiceLedgerRegistryPort, type InvoiceLedgerRoutingPort } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+export declare class InvoiceLedgerRoutingService implements InvoiceLedgerRoutingPort {
+    private readonly settings;
+    private readonly registry;
+    constructor(settings: SettingsReadPort, registry: Pick<InvoiceLedgerRegistryPort, 'getActiveModuleId'>);
+    numberingModeFor(salesChannelId: string | null): Promise<InvoiceLedgerNumberingMode>;
+    nativeKsefActionFor(salesChannelId: string | null): Promise<InvoiceLedgerNativeKsefAction>;
+    activeVendorModuleId(): Promise<string | null>;
+}
+//# sourceMappingURL=invoice-ledger-routing.service.d.ts.map

package/dist/backend/services/invoice-ledger-routing.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ledger-routing.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-ledger-routing.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,qBAAa,2BAA4B,YAAW,wBAAwB;IAExE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,IAAI,CAAC,yBAAyB,EAAE,mBAAmB,CAAC;IAG3E,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQpF,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAS1F,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrD"}

package/dist/backend/services/invoice-ledger-routing.service.js

@@ -0,0 +1,20 @@
+import { INVOICE_LEDGER_SETTING_CODES, invoiceLedgerKsefRoutingSchema, invoiceLedgerNumberingModeSchema, } from '@endora-commerce/contracts';
+export class InvoiceLedgerRoutingService {
+    settings;
+    registry;
+    constructor(settings, registry) {
+        this.settings = settings;
+        this.registry = registry;
+    }
+    async numberingModeFor(salesChannelId) {
+        return this.settings.get(INVOICE_LEDGER_SETTING_CODES.NUMBERING_MODE, salesChannelId, invoiceLedgerNumberingModeSchema);
+    }
+    async nativeKsefActionFor(salesChannelId) {
+        const routing = await this.settings.get(INVOICE_LEDGER_SETTING_CODES.KSEF_ROUTING, salesChannelId, invoiceLedgerKsefRoutingSchema);
+        return routing === 'vendor' ? 'skip' : 'submit';
+    }
+    async activeVendorModuleId() {
+        return this.registry.getActiveModuleId();
+    }
+}
+//# sourceMappingURL=invoice-ledger-routing.service.js.map

package/dist/backend/services/invoice-ledger-routing.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ledger-routing.service.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-ledger-routing.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,gCAAgC,GAKjC,MAAM,4BAA4B,CAAC;AAGpC,MAAM,OAAO,2BAA2B;IAEnB;IACA;IAFnB,YACmB,QAA0B,EAC1B,QAA8D;QAD9D,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,aAAQ,GAAR,QAAQ,CAAsD;IAC9E,CAAC;IAEJ,KAAK,CAAC,gBAAgB,CAAC,cAA6B;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CACtB,4BAA4B,CAAC,cAAc,EAC3C,cAAc,EACd,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,cAA6B;QACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CACrC,4BAA4B,CAAC,YAAY,EACzC,cAAc,EACd,8BAA8B,CAC/B,CAAC;QACF,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/backend/services/invoice-ledger-vendor-freeze-registry.d.ts

@@ -0,0 +1,9 @@
+import type { InvoiceLedgerVendorFreeze, InvoiceLedgerVendorFreezeRegistryPort } from '@endora-commerce/contracts';
+type FreezeResolver = (salesChannelId: string | null) => Promise<InvoiceLedgerVendorFreeze>;
+export declare class InvoiceLedgerVendorFreezeRegistry implements InvoiceLedgerVendorFreezeRegistryPort {
+    private readonly resolvers;
+    register(adapterId: string, resolve: FreezeResolver, _module: string): void;
+    resolve(adapterId: string, salesChannelId: string | null): Promise<InvoiceLedgerVendorFreeze | null>;
+}
+export {};
+//# sourceMappingURL=invoice-ledger-vendor-freeze-registry.d.ts.map

package/dist/backend/services/invoice-ledger-vendor-freeze-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ledger-vendor-freeze-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-ledger-vendor-freeze-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,qCAAqC,EACtC,MAAM,4BAA4B,CAAC;AAEpC,KAAK,cAAc,GAAG,CACpB,cAAc,EAAE,MAAM,GAAG,IAAI,KAC1B,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAExC,qBAAa,iCAAkC,YAAW,qCAAqC;IAC7F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAE/D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrE,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;CAK7C"}

package/dist/backend/services/invoice-ledger-vendor-freeze-registry.js

@@ -0,0 +1,13 @@
+export class InvoiceLedgerVendorFreezeRegistry {
+    resolvers = new Map();
+    register(adapterId, resolve, _module) {
+        this.resolvers.set(adapterId, resolve);
+    }
+    async resolve(adapterId, salesChannelId) {
+        const resolve = this.resolvers.get(adapterId);
+        if (!resolve)
+            return null;
+        return resolve(salesChannelId);
+    }
+}
+//# sourceMappingURL=invoice-ledger-vendor-freeze-registry.js.map

package/dist/backend/services/invoice-ledger-vendor-freeze-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ledger-vendor-freeze-registry.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-ledger-vendor-freeze-registry.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,iCAAiC;IAC3B,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/D,QAAQ,CAAC,SAAiB,EAAE,OAAuB,EAAE,OAAe;QAClE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,cAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/backend/services/invoice-ledger-webhook.service.d.ts

@@ -0,0 +1,30 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type InvoiceKsefAssignmentPort, type InvoiceLedgerDeliveryPort, type InvoiceLedgerWebhookEventInput, type InvoiceLedgerWebhookPort, type InvoiceNumberingHostPort, type InvoicePaidHostPort } from '@endora-commerce/contracts';
+export interface InvoiceLedgerWebhookServiceDeps {
+    emFactory: () => EntityManager;
+    deliveries: InvoiceLedgerDeliveryPort;
+    numbering: InvoiceNumberingHostPort;
+    paid: InvoicePaidHostPort;
+    ksefAssignment: InvoiceKsefAssignmentPort;
+}
+/**
+ * Receipt claim + apply for authenticated ledger-vendor webhooks.
+ * HMAC stays on the adapter route. Apply uses frozen delivery columns.
+ */
+export declare class InvoiceLedgerWebhookService implements InvoiceLedgerWebhookPort {
+    private readonly deps;
+    constructor(deps: InvoiceLedgerWebhookServiceDeps);
+    handleAuthenticatedEvent(input: InvoiceLedgerWebhookEventInput): Promise<{
+        outcome: 'applied' | 'duplicate' | 'acknowledged';
+    }>;
+    private run;
+    private claim;
+    private settle;
+    private apply;
+    private applyCreationSuccess;
+    private applyCreationError;
+    private findCreationDelivery;
+    private lookupUniqueMap;
+    private stampRemotePaid;
+}
+//# sourceMappingURL=invoice-ledger-webhook.service.d.ts.map

package/dist/backend/services/invoice-ledger-webhook.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ledger-webhook.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-ledger-webhook.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AAepC,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,wBAAwB,CAAC;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,cAAc,EAAE,yBAAyB,CAAC;CAC3C;AAOD;;;GAGG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,+BAA+B;IAE5D,wBAAwB,CAC5B,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,CAAA;KAAE,CAAC;YAInD,GAAG;YAUH,KAAK;YAoBL,MAAM;YAcN,KAAK;YA6CL,oBAAoB;YAoBpB,kBAAkB;YAYlB,oBAAoB;YAuBpB,eAAe;YAgBf,eAAe;CAS9B"}

package/dist/backend/services/invoice-ledger-webhook.service.js

@@ -0,0 +1,170 @@
+import { randomUUID } from 'node:crypto';
+import { INVOICE_LEDGER_ASYNC_CREATE_FAILED_MESSAGE, INVOICE_LEDGER_VENDOR_KSEF_SEND_FAILED_MESSAGE, } from '@endora-commerce/contracts';
+import { mappedDeliveryError } from './mapped-delivery-error.js';
+import { enterSystemScope } from '@endora-commerce/platform/kernel';
+import { InvoiceLedgerDocumentMap } from '../entities/invoice-ledger-document-map.entity.js';
+import { InvoiceLedgerDelivery } from '../entities/invoice-ledger-delivery.entity.js';
+import { InvoiceLedgerWebhookReceipt } from '../entities/invoice-ledger-webhook-receipt.entity.js';
+const APPLIED_TYPES = new Set([
+    'async_invoice_creation_success',
+    'async_invoice_creation_error',
+    'invoice_paid',
+    'send_to_ksef_success',
+    'send_to_ksef_error',
+]);
+/**
+ * Receipt claim + apply for authenticated ledger-vendor webhooks.
+ * HMAC stays on the adapter route. Apply uses frozen delivery columns.
+ */
+export class InvoiceLedgerWebhookService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async handleAuthenticatedEvent(input) {
+        return enterSystemScope('invoice ledger webhook', () => this.run(input));
+    }
+    async run(input) {
+        const claimed = await this.claim(input);
+        if (!claimed)
+            return { outcome: 'duplicate' };
+        const outcome = await this.apply(input);
+        await this.settle(input, 'processed');
+        return { outcome };
+    }
+    async claim(input) {
+        const em = this.deps.emFactory();
+        // command-coverage-ignore: claim INSERT … ON CONFLICT for this module's
+        // webhook ledger — see InpostWebhookLedger.claim.
+        const rows = await em.execute(`insert into "invoice_ledger_webhook_receipts"
+         ("id", "adapter_id", "event_id", "event_type", "state", "attempts", "received_at")
+       values (?, ?, ?, ?, 'received', 1, now())
+       on conflict ("adapter_id", "event_id") do update
+          set "attempts" = "invoice_ledger_webhook_receipts"."attempts" + 1,
+              "received_at" = now(),
+              "state" = 'received',
+              "error" = null
+        where "invoice_ledger_webhook_receipts"."state" in ('failed', 'received')
+       returning "id"`, [randomUUID(), input.adapterId, input.eventId.slice(0, 128), input.eventType.slice(0, 64)]);
+        return rows.length > 0;
+    }
+    async settle(input, state) {
+        // command-coverage-ignore: closes this module's own webhook ledger row —
+        // see `claim` above.
+        const em = this.deps.emFactory();
+        await em.nativeUpdate(InvoiceLedgerWebhookReceipt, { adapterId: input.adapterId, eventId: input.eventId.slice(0, 128) }, { state, appliedAt: new Date(), error: null });
+    }
+    async apply(input) {
+        if (!APPLIED_TYPES.has(input.eventType))
+            return 'acknowledged';
+        if (input.eventType === 'async_invoice_creation_success') {
+            return this.applyCreationSuccess(input);
+        }
+        if (input.eventType === 'async_invoice_creation_error') {
+            return this.applyCreationError(input);
+        }
+        const lookup = await this.lookupUniqueMap(input.adapterId, input.remoteDocumentId);
+        if (lookup.kind !== 'unique')
+            return 'acknowledged';
+        const delivery = await this.deps.deliveries.findByInvoice(input.adapterId, lookup.invoiceId);
+        if (input.eventType === 'invoice_paid') {
+            await this.deps.paid.recordPaidFromLedger(lookup.invoiceId);
+            if (delivery) {
+                await this.stampRemotePaid(delivery.id);
+            }
+            return 'applied';
+        }
+        if (input.eventType === 'send_to_ksef_success') {
+            if (delivery?.ksefRouting !== 'vendor' || !input.ksefReferenceNumber) {
+                return 'acknowledged';
+            }
+            await this.deps.ksefAssignment.recordKsefAssignment(lookup.invoiceId, {
+                ksefReferenceNumber: input.ksefReferenceNumber,
+                ksefProcessedAt: new Date(),
+            });
+            return 'applied';
+        }
+        if (input.eventType === 'send_to_ksef_error') {
+            if (delivery) {
+                await this.deps.deliveries.markFailed(delivery.id, mappedDeliveryError(input.errorMessage) ?? INVOICE_LEDGER_VENDOR_KSEF_SEND_FAILED_MESSAGE);
+            }
+            return 'applied';
+        }
+        return 'acknowledged';
+    }
+    async applyCreationSuccess(input) {
+        const delivery = await this.findCreationDelivery(input);
+        if (!delivery)
+            return 'acknowledged';
+        if (delivery.numberingMode === 'vendor' && input.vendorNumber) {
+            await this.deps.numbering.applyVendorAssignedNumber(delivery.invoiceId, input.vendorNumber);
+        }
+        if (delivery.ksefRouting === 'vendor' && input.ksefReferenceNumber) {
+            await this.deps.ksefAssignment.recordKsefAssignment(delivery.invoiceId, {
+                ksefReferenceNumber: input.ksefReferenceNumber,
+                ksefProcessedAt: new Date(),
+            });
+        }
+        if (input.remoteDocumentId) {
+            await this.deps.deliveries.markSucceeded(delivery.id, input.remoteDocumentId);
+        }
+        return 'applied';
+    }
+    async applyCreationError(input) {
+        const delivery = await this.findCreationDelivery(input);
+        if (!delivery)
+            return 'acknowledged';
+        await this.deps.deliveries.markFailed(delivery.id, mappedDeliveryError(input.errorMessage) ?? INVOICE_LEDGER_ASYNC_CREATE_FAILED_MESSAGE);
+        return 'applied';
+    }
+    async findCreationDelivery(input) {
+        if (input.asyncTaskId) {
+            const row = await this.deps.emFactory().findOne(InvoiceLedgerDelivery, {
+                adapterId: input.adapterId,
+                asyncTaskId: input.asyncTaskId,
+            });
+            if (row)
+                return this.deps.deliveries.getById(row.id);
+        }
+        if (input.remoteDocumentId) {
+            const rows = await this.deps.emFactory().find(InvoiceLedgerDelivery, {
+                adapterId: input.adapterId,
+                remoteDocumentId: input.remoteDocumentId,
+            });
+            if (rows.length !== 1)
+                return null;
+            const id = rows[0]?.id;
+            if (!id)
+                return null;
+            return this.deps.deliveries.getById(id);
+        }
+        return null;
+    }
+    async lookupUniqueMap(adapterId, remoteDocumentId) {
+        if (!remoteDocumentId)
+            return { kind: 'none' };
+        const maps = await this.deps.emFactory().find(InvoiceLedgerDocumentMap, {
+            adapterId,
+            remoteDocumentId,
+        });
+        if (maps.length === 0)
+            return { kind: 'none' };
+        if (maps.length > 1)
+            return { kind: 'ambiguous' };
+        const invoiceId = maps[0]?.invoiceId;
+        if (!invoiceId)
+            return { kind: 'none' };
+        return { kind: 'unique', invoiceId };
+    }
+    async stampRemotePaid(deliveryId) {
+        // command-coverage-ignore: webhook queue stamp that the remote invoice is
+        // paid — mirrors `InvoiceLedgerDeliveryService.markRemotePaid`.
+        const em = this.deps.emFactory();
+        const row = await em.findOne(InvoiceLedgerDelivery, { id: deliveryId });
+        if (!row)
+            return;
+        row.remotePaidAt = new Date();
+        await em.flush();
+    }
+}
+//# sourceMappingURL=invoice-ledger-webhook.service.js.map

package/dist/backend/services/invoice-ledger-webhook.service.js.map

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

package/dist/backend/services/mapped-delivery-error.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A **vendor-independent shape floor** over `last_error` — D-256
+ * (`specs/080-f4-real-scope/rulings.md`).
+ *
+ * The promise is *"no dump reaches the stored field"*, **not** *"only these
+ * sentences do"*. The vendor that authors an operator sentence owns both the
+ * vocabulary and the mapping that produces it; this module holds no vendor
+ * vocabulary and recognises no vendor sentence. What it refuses is a shape no
+ * operator sentence has: markup, a control character, a serialised body, or a
+ * length no sentence reaches. Anything else is stored as the vendor wrote it —
+ * including prose this module has never seen. Each vendor asserts, in its own
+ * package and beside its own vocabulary, that every sentence it can hand the
+ * ledger clears this floor.
+ *
+ * Refusal is whole: an input that fails a clause becomes
+ * `INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR`, never a prefix of itself. Half a
+ * sentence is prose nobody wrote and can cut a leaked token in two.
+ *
+ * **Scope.** This is the `last_error` column and nothing else. The neighbouring
+ * `attempts[].error` JSONB is stored as it arrives and returned as stored by
+ * `POST /api/v1/admin/invoice-ledger/deliveries/:id/retry` — outside this
+ * floor, recorded in `specs/deferred-defects.md`.
+ */
+export declare function mappedDeliveryError(raw: string | null | undefined): string | null;
+//# sourceMappingURL=mapped-delivery-error.d.ts.map

package/dist/backend/services/mapped-delivery-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-delivery-error.d.ts","sourceRoot":"","sources":["../../../src/backend/services/mapped-delivery-error.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAajF"}

package/dist/backend/services/mapped-delivery-error.js

@@ -0,0 +1,54 @@
+import { INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR } from '@endora-commerce/contracts';
+/**
+ * The longest sentence a ledger vendor is expected to author is well under
+ * this; the bound is a backstop against a body that happens to carry no
+ * markup, not a budget anyone should design against. A vendor that composes a
+ * sentence bounds its own composition — see `formatWfirmaValidationError`.
+ */
+const MAX_OPERATOR_SENTENCE_LENGTH = 500;
+// C0, DEL and C1. A newline, a carriage return and a tab are the interesting
+// members: they are what a header dump and a stack trace are made of.
+const CONTROL_CHARACTER = /[\u0000-\u001f\u007f-\u009f]/;
+/**
+ * A **vendor-independent shape floor** over `last_error` — D-256
+ * (`specs/080-f4-real-scope/rulings.md`).
+ *
+ * The promise is *"no dump reaches the stored field"*, **not** *"only these
+ * sentences do"*. The vendor that authors an operator sentence owns both the
+ * vocabulary and the mapping that produces it; this module holds no vendor
+ * vocabulary and recognises no vendor sentence. What it refuses is a shape no
+ * operator sentence has: markup, a control character, a serialised body, or a
+ * length no sentence reaches. Anything else is stored as the vendor wrote it —
+ * including prose this module has never seen. Each vendor asserts, in its own
+ * package and beside its own vocabulary, that every sentence it can hand the
+ * ledger clears this floor.
+ *
+ * Refusal is whole: an input that fails a clause becomes
+ * `INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR`, never a prefix of itself. Half a
+ * sentence is prose nobody wrote and can cut a leaked token in two.
+ *
+ * **Scope.** This is the `last_error` column and nothing else. The neighbouring
+ * `attempts[].error` JSONB is stored as it arrives and returned as stored by
+ * `POST /api/v1/admin/invoice-ledger/deliveries/:id/retry` — outside this
+ * floor, recorded in `specs/deferred-defects.md`.
+ */
+export function mappedDeliveryError(raw) {
+    if (raw == null || raw === '')
+        return raw ?? null;
+    const trimmed = raw.trim();
+    // Whitespace-only is not an operator sentence, and storing `''` on a failed
+    // row would read as "no error". Today's answer, kept.
+    if (trimmed === '')
+        return INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR;
+    if (trimmed.includes('<') || trimmed.includes('>'))
+        return INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR;
+    if (CONTROL_CHARACTER.test(trimmed))
+        return INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR;
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR;
+    }
+    if (trimmed.length > MAX_OPERATOR_SENTENCE_LENGTH)
+        return INVOICE_LEDGER_UNREADABLE_VENDOR_ERROR;
+    return trimmed;
+}
+//# sourceMappingURL=mapped-delivery-error.js.map

package/dist/backend/services/mapped-delivery-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-delivery-error.js","sourceRoot":"","sources":["../../../src/backend/services/mapped-delivery-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,4BAA4B,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEzC,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA8B;IAChE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,IAAI,IAAI,CAAC;IAClD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,sDAAsD;IACtD,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,sCAAsC,CAAC;IAClE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,sCAAsC,CAAC;IAClG,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,sCAAsC,CAAC;IACnF,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,sCAAsC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,4BAA4B;QAAE,OAAO,sCAAsC,CAAC;IACjG,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,183 @@
+export declare const invoiceLedgerSettingsManifest: {
+    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;
+    }[];
+};
+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: ("invoice" | "email" | "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: ("invoice" | "email" | "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":"AASA,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;CAyBxC,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FnB,CAAC"}