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

package/dist/backend/services/invoice-pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-pdf.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,sBAAsB,CAAC,MAItC;IACC,OAAO,YAAY,CAAC,CAAC,WAAW,MAAM,CAAC,aAAa,EAAE,EAAE,UAAU,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AACxG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA2E;IAE3E,MAAM,KAAK,GACT,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC3B,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7E,OAAO,YAAY,CAAC,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,wEAAwE;AACxE,SAAS,YAAY,CAAC,KAAe;IACnC,yEAAyE;IACzE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,GACX,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/E,KAAK,CAAC;IAER,0EAA0E;IAC1E,MAAM,OAAO,GAAa;QACxB,sDAAsD;QACtD,8DAA8D;QAC9D,mIAAmI;QACnI,uBAAuB,OAAO,CAAC,MAAM,gBAAgB,OAAO,uBAAuB;QACnF,2EAA2E;KAC5E,CAAC;IAEF,IAAI,IAAI,GAAG,YAAY,CAAC;IACxB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9C,IAAI,IAAI,GAAG,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,IAAI,WAAW,OAAO,CAAC,MAAM,GAAG,CAAC,yBAAyB,CAAC;IAC/D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,IAAI,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,aAAa,CAAC;IAC3D,CAAC;IACD,IAAI,IAAI,qBAAqB,OAAO,CAAC,MAAM,GAAG,CAAC,+BAA+B,UAAU,WAAW,CAAC;IAEpG,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/backend/services/invoice-placement-apply-port.d.ts

@@ -0,0 +1,29 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { InvoicePlacementApplyPort, ProformaInvoiceOpened } from '../../ports/index.js';
+/**
+ * `invoicePlacementApplyPort` — the proforma an order is placed with, written
+ * on the caller's `EntityManager` (feature 080, T048; D-169).
+ *
+ * `orders` held this module's `Invoice` class for it until T048 and did the
+ * `tx.create` itself. D-168 leaves a packaged `invoices` no entity class for
+ * `orders` to name, so the reach had to go before this module moves; the
+ * transaction it runs in did not change, and `invoices_order_fk` is untouched.
+ * The port's own doc block states the constraint.
+ *
+ * **The number is derived here, and the expression is the one that moved.**
+ * `orders` computed `<YYYY-MM-DD>/<first 8 of the order id>` and passed the
+ * string in; both of its inputs are already parameters of this call, so keeping
+ * the derivation on the consumer's side would have published a parameter only
+ * the consumer knows how to fill. It is deliberately the *same* expression:
+ * this is a proforma, which the numbering sequence this module owns does not
+ * govern — `status` stays `pending` until an issuance path takes it further,
+ * and `InvoiceNumberingService` is what assigns a real number then.
+ */
+export declare class InvoicePlacementApplyService implements InvoicePlacementApplyPort {
+    createProformaForOrder(em: EntityManager, input: {
+        orderId: string;
+        currency: string;
+        total: string;
+    }): Promise<ProformaInvoiceOpened>;
+}
+//# sourceMappingURL=invoice-placement-apply-port.d.ts.map

package/dist/backend/services/invoice-placement-apply-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-placement-apply-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-placement-apply-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,4BAA6B,YAAW,yBAAyB;IACtE,sBAAsB,CAC1B,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,qBAAqB,CAAC;CAiBlC"}

package/dist/backend/services/invoice-placement-apply-port.js

@@ -0,0 +1,40 @@
+import { Invoice } from '../entities/invoice.entity.js';
+/**
+ * `invoicePlacementApplyPort` — the proforma an order is placed with, written
+ * on the caller's `EntityManager` (feature 080, T048; D-169).
+ *
+ * `orders` held this module's `Invoice` class for it until T048 and did the
+ * `tx.create` itself. D-168 leaves a packaged `invoices` no entity class for
+ * `orders` to name, so the reach had to go before this module moves; the
+ * transaction it runs in did not change, and `invoices_order_fk` is untouched.
+ * The port's own doc block states the constraint.
+ *
+ * **The number is derived here, and the expression is the one that moved.**
+ * `orders` computed `<YYYY-MM-DD>/<first 8 of the order id>` and passed the
+ * string in; both of its inputs are already parameters of this call, so keeping
+ * the derivation on the consumer's side would have published a parameter only
+ * the consumer knows how to fill. It is deliberately the *same* expression:
+ * this is a proforma, which the numbering sequence this module owns does not
+ * govern — `status` stays `pending` until an issuance path takes it further,
+ * and `InvoiceNumberingService` is what assigns a real number then.
+ */
+export class InvoicePlacementApplyService {
+    async createProformaForOrder(em, input) {
+        // command-coverage-ignore: the proforma an audited order placement opens,
+        // inside that placement's own transaction. `orders` records the placement
+        // as one operation through its own Command; a second audit entry for the
+        // document it opened would record the same decision twice.
+        const invoice = em.create(Invoice, {
+            orderId: input.orderId,
+            kind: 'proforma',
+            number: `${new Date().toISOString().slice(0, 10)}/${input.orderId.slice(0, 8)}`,
+            currency: input.currency,
+            total: input.total,
+            status: 'pending',
+        });
+        await em.persistAndFlush(invoice);
+        // A published record, never the managed entity (D-77's first narrowing).
+        return { id: invoice.id, orderId: invoice.orderId, number: invoice.number };
+    }
+}
+//# sourceMappingURL=invoice-placement-apply-port.js.map

package/dist/backend/services/invoice-placement-apply-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-placement-apply-port.js","sourceRoot":"","sources":["../../../src/backend/services/invoice-placement-apply-port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAMxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,4BAA4B;IACvC,KAAK,CAAC,sBAAsB,CAC1B,EAAiB,EACjB,KAA2D;QAE3D,0EAA0E;QAC1E,0EAA0E;QAC1E,yEAAyE;QACzE,2DAA2D;QAC3D,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YAC/E,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAClC,yEAAyE;QACzE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/E,CAAC;CACF"}

package/dist/backend/services/invoice-read-port.d.ts

@@ -0,0 +1,44 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { InvoicePdfPort, InvoiceReadPort, InvoiceRecord } from '@endora-commerce/contracts';
+import { Invoice } from '../entities/invoice.entity.js';
+/**
+ * The row-level read model and the PDF surface `invoices` publishes
+ * (feature 075, Phase P).
+ *
+ * Four inbound sites read the `Invoice` entity: `orders` listing an order's
+ * invoices on the order screen and again at cancellation, and `ksef` resolving
+ * the invoice behind a submission — one of those two from inside its entity
+ * file, where the reference is a `@TransitivelyScoped` tenancy classification
+ * rather than a query, and needs its own remedy (R-05) that no port can give.
+ *
+ * The seller and buyer snapshots do not survive the mapping. They are the
+ * document's frozen copy of two other modules' rows; no cross-module caller
+ * reads them, and publishing them would invite one to.
+ */
+export declare class InvoiceReadService implements InvoiceReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    findById(id: string): Promise<InvoiceRecord | null>;
+    findByIds(ids: readonly string[]): Promise<InvoiceRecord[]>;
+    findByNumber(number: string): Promise<InvoiceRecord | null>;
+    listForOrder(orderId: string): Promise<InvoiceRecord[]>;
+    listForOrders(orderIds: readonly string[]): Promise<InvoiceRecord[]>;
+}
+/**
+ * The PDF surface, as a **port** even though both builders behind it are pure.
+ *
+ * FR-013's test — "does switching the owner off change the answer?" — asks
+ * whether the bytes would differ, and they would not. The question that
+ * settles this one is Constitution XVII's: should the platform produce an
+ * invoice document for a business that has switched invoicing off? An order
+ * screen offering an invoice PDF is a surface this module owns, and a surface
+ * a switched-off module owns must disappear.
+ *
+ * `hashPassword` is the contrast that makes the line a line: it is
+ * platform-generic, reachable from five modules and the dev seed, and nobody
+ * would call hashing "an `auth` surface". A VAT document is an `invoices`
+ * surface.
+ */
+export declare function createInvoicePdfPort(): InvoicePdfPort;
+export declare function toInvoiceRecord(invoice: Invoice): InvoiceRecord;
+//# sourceMappingURL=invoice-read-port.d.ts.map

package/dist/backend/services/invoice-read-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-read-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-read-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKnD,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAM3D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASvD,aAAa,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAS3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAKrD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA0B/D"}

package/dist/backend/services/invoice-read-port.js

@@ -0,0 +1,95 @@
+import { Invoice } from '../entities/invoice.entity.js';
+import { buildBulkInvoicesPdf, buildMinimalInvoicePdf } from './invoice-pdf.js';
+/**
+ * The row-level read model and the PDF surface `invoices` publishes
+ * (feature 075, Phase P).
+ *
+ * Four inbound sites read the `Invoice` entity: `orders` listing an order's
+ * invoices on the order screen and again at cancellation, and `ksef` resolving
+ * the invoice behind a submission — one of those two from inside its entity
+ * file, where the reference is a `@TransitivelyScoped` tenancy classification
+ * rather than a query, and needs its own remedy (R-05) that no port can give.
+ *
+ * The seller and buyer snapshots do not survive the mapping. They are the
+ * document's frozen copy of two other modules' rows; no cross-module caller
+ * reads them, and publishing them would invite one to.
+ */
+export class InvoiceReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async findById(id) {
+        const invoice = await this.emFactory().findOne(Invoice, { id });
+        return invoice ? toInvoiceRecord(invoice) : null;
+    }
+    async findByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const invoices = await this.emFactory().find(Invoice, { id: { $in: [...ids] } });
+        return invoices.map(toInvoiceRecord);
+    }
+    async findByNumber(number) {
+        const invoice = await this.emFactory().findOne(Invoice, { number });
+        return invoice ? toInvoiceRecord(invoice) : null;
+    }
+    async listForOrder(orderId) {
+        const invoices = await this.emFactory().find(Invoice, { orderId }, { orderBy: { issuedAt: 'desc', id: 'desc' } });
+        return invoices.map(toInvoiceRecord);
+    }
+    async listForOrders(orderIds) {
+        if (orderIds.length === 0)
+            return [];
+        const invoices = await this.emFactory().find(Invoice, { orderId: { $in: [...orderIds] } }, { orderBy: { issuedAt: 'desc', id: 'desc' } });
+        return invoices.map(toInvoiceRecord);
+    }
+}
+/**
+ * The PDF surface, as a **port** even though both builders behind it are pure.
+ *
+ * FR-013's test — "does switching the owner off change the answer?" — asks
+ * whether the bytes would differ, and they would not. The question that
+ * settles this one is Constitution XVII's: should the platform produce an
+ * invoice document for a business that has switched invoicing off? An order
+ * screen offering an invoice PDF is a surface this module owns, and a surface
+ * a switched-off module owns must disappear.
+ *
+ * `hashPassword` is the contrast that makes the line a line: it is
+ * platform-generic, reachable from five modules and the dev seed, and nobody
+ * would call hashing "an `auth` surface". A VAT document is an `invoices`
+ * surface.
+ */
+export function createInvoicePdfPort() {
+    return {
+        renderMinimal: (params) => buildMinimalInvoicePdf(params),
+        renderBulk: (invoices) => buildBulkInvoicesPdf([...invoices]),
+    };
+}
+export function toInvoiceRecord(invoice) {
+    return {
+        id: invoice.id,
+        orderId: invoice.orderId ?? null,
+        salesChannelId: invoice.salesChannelId ?? null,
+        kind: invoice.kind,
+        number: invoice.number,
+        issuedAt: invoice.issuedAt,
+        saleDate: invoice.saleDate ?? null,
+        paymentDueDate: invoice.paymentDueDate ?? null,
+        paymentMethod: invoice.paymentMethod ?? null,
+        currency: invoice.currency,
+        netTotal: invoice.netTotal ?? null,
+        taxTotal: invoice.taxTotal ?? null,
+        total: invoice.total,
+        paidTotal: invoice.paidTotal,
+        originalInvoiceId: invoice.originalInvoiceId ?? null,
+        templateId: invoice.templateId ?? null,
+        ksefReferenceNumber: invoice.ksefReferenceNumber ?? null,
+        ksefProcessedAt: invoice.ksefProcessedAt ?? null,
+        issuedBy: invoice.issuedBy ?? null,
+        pdfAssetId: invoice.pdfAssetId ?? null,
+        status: invoice.status,
+        createdAt: invoice.createdAt,
+        updatedAt: invoice.updatedAt,
+    };
+}
+//# sourceMappingURL=invoice-read-port.js.map

package/dist/backend/services/invoice-read-port.js.map

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

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

@@ -0,0 +1,94 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type InvoiceDetail, type InvoiceKind, type OrderReadPort } from '@endora-commerce/contracts';
+import type { InvoiceNumberGenerator } from './invoice-number-generator.js';
+import type { SellerSettingsResolver } from './seller-settings.js';
+import { type LedgerNumberingLookup } from './vendor-number-hold.js';
+export interface IssueInvoiceOptions {
+    saleDate?: string;
+    paymentDueDate?: string;
+    issuedBy?: string;
+}
+/** Minimal audit-log seam (FR-035). */
+export interface InvoiceAuditRecorder {
+    record(input: {
+        actorAdminUserId?: string | null;
+        action: string;
+        objectType: string;
+        objectId: string;
+        stateAfter?: Record<string, unknown> | null;
+    }): Promise<unknown>;
+}
+/**
+ * Domain-event seam (feature 059, contracts/invoices-integration.md §1).
+ * Emissions are inert without a subscriber — the KSeF module (or any other
+ * consumer) subscribes; removing it changes nothing here.
+ */
+export interface InvoiceDomainEventEmitter {
+    emit(eventName: string, payload: {
+        eventId: string;
+        occurredAt: string;
+    } & Record<string, unknown>): void;
+}
+/**
+ * Core invoice issuance + read service (feature 047, US1). Issues invoices /
+ * proformas (and is reused by the corrective-invoice provider for credit
+ * notes). Numbers are drawn inside the issuing transaction; lines and the
+ * seller/buyer snapshot are frozen at issuance. Immutable once `ready`.
+ *
+ * The order and its lines are read over {@link OrderReadPort} (feature 075,
+ * Phase C). They were `em.findOne(Order, …)` and `em.find(OrderItem, …)` here,
+ * which is a query against another module's tables that no gate can see:
+ * deactivation drops no tables, so an invoice went on being drawn from an
+ * `orders` an operator had switched off. Over the port the same read answers
+ * 503 `MODULE_DISABLED`, which is the binding dependency this manifest already
+ * declares — issuing a legal document about an order the platform will not read
+ * is worse than refusing to issue one.
+ */
+export declare class InvoiceService {
+    private readonly emFactory;
+    /** `orders`' read model. Not optional: an invoice is about an order. */
+    private readonly orders;
+    private readonly numbers;
+    private readonly sellerSettings;
+    private readonly audit?;
+    private readonly events?;
+    private readonly emailOnReady?;
+    private readonly ledgerRouting?;
+    constructor(emFactory: () => EntityManager, 
+    /** `orders`' read model. Not optional: an invoice is about an order. */
+    orders: OrderReadPort, numbers: InvoiceNumberGenerator, sellerSettings: SellerSettingsResolver, audit?: InvoiceAuditRecorder | undefined, events?: InvoiceDomainEventEmitter | undefined, emailOnReady?: ((invoiceId: string) => Promise<void>) | undefined, ledgerRouting?: LedgerNumberingLookup | undefined);
+    /** Issue an invoice/proforma for an order. Idempotent per (order, kind). */
+    issue(orderId: string, kind: Exclude<InvoiceKind, 'correction' | 'wz'>, opts?: IssueInvoiceOptions): Promise<InvoiceDetail>;
+    /**
+     * Run the issuing transaction, translating a duplicated invoice number into
+     * `409 INVOICE_NUMBER_ALREADY_ISSUED` (feature 078, D-95.2).
+     *
+     * `rethrowIfModuleDisabled` is the **first** line of the catch, before any
+     * other test. `ModuleDisabledError` is an `HttpError`, so a status-code or
+     * class test would let it through by accident rather than by decision, and
+     * everything inside the callback can reach a port.
+     */
+    private issueInTransaction;
+    /**
+     * Record the KSeF identity assigned to an invoice (feature 059,
+     * contracts/invoices-integration.md §2). The invoices module is the SOLE
+     * writer of these columns. Idempotent for the same number; a different
+     * non-null number is refused — an accepted KSeF number is immutable.
+     */
+    recordKsefAssignment(invoiceId: string, assignment: {
+        ksefReferenceNumber: string;
+        ksefProcessedAt: Date;
+    }): Promise<void>;
+    /**
+     * Mode B: overwrite the Endora-drawn number with the vendor's, then ready.
+     * No-op when the invoice already carries that number and is ready.
+     */
+    applyVendorAssignedNumber(invoiceId: string, number: string): Promise<void>;
+    /**
+     * Infakt `invoice_paid` → stamp paidTotal to the invoice gross. Never Payments.
+     */
+    recordPaidFromLedger(invoiceId: string): Promise<void>;
+    /** Load an invoice as a render-ready detail (lines + derived VAT summary). */
+    buildDetail(invoiceId: string): Promise<InvoiceDetail>;
+}
+//# sourceMappingURL=invoice-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/invoice-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAEnB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAMjC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE;QACZ,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC7C,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3G;AAID;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBARd,SAAS,EAAE,MAAM,aAAa;IAC/C,wEAAwE;IACvD,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,sBAAsB,EAC/B,cAAc,EAAE,sBAAsB,EACtC,KAAK,CAAC,EAAE,oBAAoB,YAAA,EAC5B,MAAM,CAAC,EAAE,yBAAyB,YAAA,EAClC,YAAY,CAAC,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,aAAA,EACnD,aAAa,CAAC,EAAE,qBAAqB,YAAA;IAGxD,4EAA4E;IACtE,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC,EAC/C,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAqJzB;;;;;;;;OAQG;YACW,kBAAkB;IAoBhC;;;;;OAKG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE;QAAE,mBAAmB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,IAAI,CAAA;KAAE,GACjE,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;OAGG;IACG,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BjF;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D,8EAA8E;IACxE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA8F7D"}