@happyvertical/smrt-commerce 0.56.0 → 0.56.1

package/dist/collections/DocumentTaxCollection.d.ts

@@ -0,0 +1,75 @@
+/** Owning collection for derived document tax totals. */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { type DocumentMoneyWriteCapability } from '../document-money-internal.js';
+import { type CommerceDocumentType, DocumentTax, type DocumentTaxOptions } from '../models/DocumentTax.js';
+import { type TaxCodeKind } from '../money.js';
+export type DocumentTaxWriteInput = Required<Pick<DocumentTaxOptions, 'tenantId' | 'documentType' | 'documentId' | 'currency' | 'taxCodeId' | 'taxCodeCode' | 'kind' | 'taxComponentId' | 'taxComponentName' | 'percent' | 'liabilityAccountId' | 'taxableMinor' | 'taxMinor' | 'recoverableMinor'>>;
+/** Normalized immutable document-tax snapshots for tax-summary materialization. */
+export interface DocumentTaxReportFact {
+    tenantId: string;
+    documentType: CommerceDocumentType;
+    documentId: string;
+    /** A document number/reference supplied to drilldown consumers. */
+    documentNumber: string;
+    /** Tenant-scoped party identity for a host to resolve as its party display. */
+    partyId: string | null;
+    /** Positive credit snapshots are negated once by the pure report aggregation. */
+    documentKind: CommerceDocumentType;
+    issueDate: string;
+    status: string;
+    direction: 'sales' | 'purchase';
+    currency: string;
+    taxCodeId: string | null;
+    /** Null is an unassigned/unknown snapshot and must remain visible as a warning. */
+    taxCodeKind: TaxCodeKind | null;
+    taxableMinor: number;
+    taxMinor: number;
+    recoverableMinor: number;
+    taxComponentId: string | null;
+    componentName: string | null;
+    liabilityAccountId: string | null;
+    /** Purchase Contracts are the expense commitment identity; other documents are unlinked. */
+    commitmentId: string | null;
+    /** Document-tax snapshots are contract-level, so they retain no line allocation. */
+    commitmentLineId: string | null;
+}
+/** @deprecated Use DocumentTaxReportFact. Kept for report-adapter compatibility. */
+export type InvoiceTaxReportFact = DocumentTaxReportFact;
+export interface DocumentTaxReportFactsOptions {
+    tenantId: string;
+    from: Date;
+    to: Date;
+    currency?: string;
+}
+/** @deprecated Use DocumentTaxReportFactsOptions. */
+export type InvoiceTaxReportFactsOptions = DocumentTaxReportFactsOptions;
+export declare class DocumentTaxCollection extends SmrtCollection<DocumentTax> {
+    static readonly _itemClass: typeof DocumentTax;
+    /**
+     * Read immutable commerce document-tax snapshots for one tenant.
+     *
+     * Invoice/credit rows join their shared storage by identity and tenant.
+     * Purchase Contract rows first use the Contract owner's bounded hydrated
+     * candidate API so custom PurchaseContract descendants retain their STI
+     * classification. The query then joins only those candidate ids by identity
+     * and tenant. Stored snapshots remain authoritative; this never recalculates
+     * money or resolves present-day tax configuration.
+     */
+    listReportFacts(options: DocumentTaxReportFactsOptions): Promise<DocumentTaxReportFact[]>;
+    private listInvoiceReportFacts;
+    private listPurchaseContractReportFacts;
+    findByDocument(tenantId: string, documentType: CommerceDocumentType, documentId: string): Promise<DocumentTax[]>;
+    /**
+     * Replace one draft document's derived rows on the caller's transaction.
+     * Unchanged rows are not saved, preserving their exact persisted bytes.
+     *
+     * @internal Aggregate persistence only.
+     */
+    replaceDerivedForDocument(capability: DocumentMoneyWriteCapability, input: {
+        tenantId: string;
+        documentType: CommerceDocumentType;
+        documentId: string;
+        rows: readonly DocumentTaxWriteInput[];
+    }): Promise<DocumentTax[]>;
+}
+//# sourceMappingURL=DocumentTaxCollection.d.ts.map

package/dist/collections/DocumentTaxCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentTaxCollection.d.ts","sourceRoot":"","sources":["../../src/collections/DocumentTaxCollection.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,KAAK,oBAAoB,EACzB,WAAW,EACX,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGrE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,IAAI,CACF,kBAAkB,EAChB,UAAU,GACV,cAAc,GACd,YAAY,GACZ,UAAU,GACV,WAAW,GACX,aAAa,GACb,MAAM,GACN,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,GACT,oBAAoB,GACpB,cAAc,GACd,UAAU,GACV,kBAAkB,CACrB,CACF,CAAC;AAEF,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iFAAiF;IACjF,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mFAAmF;IACnF,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,4FAA4F;IAC5F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,oFAAoF;AACpF,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEzD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,MAAM,4BAA4B,GAAG,6BAA6B,CAAC;AAoHzE,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;;;;;;;;OASG;IACG,eAAe,CACnB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAerB,sBAAsB;YA6DtB,+BAA+B;IA0FvC,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,oBAAoB,EAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,EAAE,CAAC;IAOzB;;;;;OAKG;IACG,yBAAyB,CAC7B,UAAU,EAAE,4BAA4B,EACxC,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,oBAAoB,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;KACxC,GACA,OAAO,CAAC,WAAW,EAAE,CAAC;CA8D1B"}

package/dist/collections/InvoiceCollection.d.ts

@@ -2,7 +2,7 @@
  * InvoiceCollection - Collection manager for Invoice objects
  * @packageDocumentation
  */
-import { SmrtCollection } from '@happyvertical/smrt-core';
+import { SmrtCollection, type SmrtListOptions, type SmrtObject, type SmrtSelectedRow, type SmrtSelectField, type SmrtStiReadScope, type SmrtWhereClause } from '@happyvertical/smrt-core';
 import { Invoice } from '../models/Invoice.js';
 import { InvoiceStatus } from '../types/index.js';
 /**
@@ -21,6 +21,31 @@ export interface InvoiceNumberOptions {
 }
 export declare class InvoiceCollection extends SmrtCollection<Invoice> {
     static readonly _itemClass: typeof Invoice;
+    private withMoneyRead;
+    get(filter: string | SmrtWhereClause<Invoice>, options?: Parameters<SmrtCollection<Invoice>['get']>[1]): Promise<Invoice | null>;
+    list<const Select extends readonly SmrtSelectField<Invoice>[]>(options: Omit<SmrtListOptions<Invoice>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope: SmrtStiReadScope;
+    }): Promise<Record<string, unknown>[]>;
+    list<const Select extends readonly SmrtSelectField<Invoice>[]>(options: Omit<SmrtListOptions<Invoice>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope?: undefined;
+    }): Promise<SmrtSelectedRow<Invoice, Select>[]>;
+    list(options: Omit<SmrtListOptions<Invoice>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope: SmrtStiReadScope;
+    }): Promise<SmrtObject[]>;
+    list(options?: undefined): Promise<Invoice[]>;
+    list(options: Omit<SmrtListOptions<Invoice>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope?: undefined;
+    }): Promise<Invoice[]>;
+    list(options: (Omit<SmrtListOptions<Invoice>, 'select'> & {
+        select?: undefined;
+    }) | undefined): Promise<SmrtObject[]>;
+    list(options: SmrtListOptions<Invoice> | undefined): Promise<SmrtObject[] | Record<string, unknown>[]>;
     /**
      * Find invoices by customer
      *

package/dist/collections/InvoiceCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InvoiceCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,eAAe,mGAKlB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,iBAAiB,GAAG,YAAY,CAAC;CAC3C;AAED,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;OAKG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO5D;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAO7D;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIvC;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAgBvC;;;;;;OAMG;IACG,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAUzE;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQnE;;;;;OAKG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAc3C;;;;;OAKG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAQlE;;;;;OAKG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcjD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,qBAAqB,CACzB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAkBlB;;;;;OAKG;IACG,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzE;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAG5D"}
+{"version":3,"file":"InvoiceCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceCollection.ts"],"names":[],"mappings":"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"}

package/dist/collections/InvoiceLineItemCollection.d.ts

@@ -2,11 +2,36 @@
  * InvoiceLineItemCollection - Collection manager for InvoiceLineItem objects
  * @packageDocumentation
  */
-import { SmrtCollection } from '@happyvertical/smrt-core';
+import { SmrtCollection, type SmrtListOptions, type SmrtObject, type SmrtSelectedRow, type SmrtSelectField, type SmrtStiReadScope, type SmrtWhereClause } from '@happyvertical/smrt-core';
 import { InvoiceLineItem } from '../models/InvoiceLineItem.js';
 import type { AccountingLineItemInput } from '../types/index.js';
 export declare class InvoiceLineItemCollection extends SmrtCollection<InvoiceLineItem> {
     static readonly _itemClass: typeof InvoiceLineItem;
+    private withMoneyRead;
+    get(filter: string | SmrtWhereClause<InvoiceLineItem>, options?: Parameters<SmrtCollection<InvoiceLineItem>['get']>[1]): Promise<InvoiceLineItem | null>;
+    list<const Select extends readonly SmrtSelectField<InvoiceLineItem>[]>(options: Omit<SmrtListOptions<InvoiceLineItem>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope: SmrtStiReadScope;
+    }): Promise<Record<string, unknown>[]>;
+    list<const Select extends readonly SmrtSelectField<InvoiceLineItem>[]>(options: Omit<SmrtListOptions<InvoiceLineItem>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope?: undefined;
+    }): Promise<SmrtSelectedRow<InvoiceLineItem, Select>[]>;
+    list(options: Omit<SmrtListOptions<InvoiceLineItem>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope: SmrtStiReadScope;
+    }): Promise<SmrtObject[]>;
+    list(options?: undefined): Promise<InvoiceLineItem[]>;
+    list(options: Omit<SmrtListOptions<InvoiceLineItem>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope?: undefined;
+    }): Promise<InvoiceLineItem[]>;
+    list(options: (Omit<SmrtListOptions<InvoiceLineItem>, 'select'> & {
+        select?: undefined;
+    }) | undefined): Promise<SmrtObject[]>;
+    list(options: SmrtListOptions<InvoiceLineItem> | undefined): Promise<SmrtObject[] | Record<string, unknown>[]>;
     /**
      * Find line items by invoice
      *

package/dist/collections/InvoiceLineItemCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InvoiceLineItemCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceLineItemCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;IAE7C;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOlE;;;;;;OAMG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOtE;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ1D;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYvE;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IASrC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAOpE"}
+{"version":3,"file":"InvoiceLineItemCollection.d.ts","sourceRoot":"","sources":["../../src/collections/InvoiceLineItemCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,eAAe,CAAC;IAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,yBAAmB;YAE/B,aAAa;IAkBZ,GAAG,CAChB,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,eAAe,CAAC,EACjD,OAAO,GAAE,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAM,GAClE,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAInB,IAAI,CACjB,KAAK,CAAC,MAAM,SAAS,SAAS,eAAe,CAAC,eAAe,CAAC,EAAE,EAEhE,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QACvE,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAChB,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtB,IAAI,CACjB,KAAK,CAAC,MAAM,SAAS,SAAS,eAAe,CAAC,eAAe,CAAC,EAAE,EAEhE,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QACvE,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAChB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;IACvC,IAAI,CACjB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QACvE,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,QAAQ,EAAE,gBAAgB,CAAC;KAC5B,GACA,OAAO,CAAC,UAAU,EAAE,CAAC;IACT,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IACrD,IAAI,CACjB,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG;QACvE,MAAM,CAAC,EAAE,SAAS,CAAC;QACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC;IACd,IAAI,CACjB,OAAO,EACH,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,GAAG;QAClD,MAAM,CAAC,EAAE,SAAS,CAAC;KACpB,CAAC,GACF,SAAS,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC;IACT,IAAI,CACjB,OAAO,EAAE,eAAe,CAAC,eAAe,CAAC,GAAG,SAAS,GACpD,OAAO,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAOpD;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOlE;;;;;;OAMG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;OAKG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAOtE;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK/D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ1D;;;;;OAKG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYvE;;;;;;OAMG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IASrC;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIhE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9C;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAOpE"}

package/dist/collections/MoneyMigrationDocumentCollection.d.ts

@@ -0,0 +1,12 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { MoneyMigrationDocument } from '../models/MoneyMigrationDocument.js';
+export declare class MoneyMigrationDocumentCollection extends SmrtCollection<MoneyMigrationDocument> {
+    static readonly _itemClass: typeof MoneyMigrationDocument;
+    findDocument(input: {
+        tenantId: string;
+        migrationId: string;
+        documentType: 'invoice' | 'contract';
+        documentId: string;
+    }): Promise<MoneyMigrationDocument | null>;
+}
+//# sourceMappingURL=MoneyMigrationDocumentCollection.d.ts.map

package/dist/collections/MoneyMigrationDocumentCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoneyMigrationDocumentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/MoneyMigrationDocumentCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,qBAAa,gCAAiC,SAAQ,cAAc,CAAC,sBAAsB,CAAC;IAC1F,MAAM,CAAC,QAAQ,CAAC,UAAU,gCAA0B;IAE9C,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,SAAS,GAAG,UAAU,CAAC;QACrC,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;CAU3C"}

package/dist/collections/PaymentAllocationCollection.d.ts

@@ -20,6 +20,8 @@ export declare class PaymentAllocationCollection extends SmrtCollection<PaymentA
         }[];
         allocatedBy?: string;
     }): Promise<PaymentAllocation[]>;
+    /** Remove one allocation atomically and rederive its invoice/credit status. */
+    removeAllocation(id: string): Promise<void>;
     /**
      * Find allocations by payment
      *

package/dist/collections/PaymentAllocationCollection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PaymentAllocationCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PaymentAllocationCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACjE,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsFhC;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpE;;;;;OAKG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtE;;;;;;;OAOG;IACG,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;;OAMG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOxE;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAc/B;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIlE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhD;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAOtE"}
+{"version":3,"file":"PaymentAllocationCollection.d.ts","sourceRoot":"","sources":["../../src/collections/PaymentAllocationCollection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,qBAAa,2BAA4B,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAChF,MAAM,CAAC,QAAQ,CAAC,UAAU,2BAAqB;IAE/C;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACjE,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsFhC,+EAA+E;IACzE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BjD;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOpE;;;;;OAKG;IACG,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpE;;;;;OAKG;IACG,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtE;;;;;;;OAOG;IACG,yBAAyB,CAC7B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAclB;;;;;;OAMG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;;;OAKG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOxE;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAc/B;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIlE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIhD;;;;;;;;OAQG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAOtE"}

package/dist/collections/TaxCodeCollection.d.ts

@@ -0,0 +1,7 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { TaxCode } from '../models/TaxCode.js';
+export declare class TaxCodeCollection extends SmrtCollection<TaxCode> {
+    static readonly _itemClass: typeof TaxCode;
+    findByCode(code: string): Promise<TaxCode | null>;
+}
+//# sourceMappingURL=TaxCodeCollection.d.ts.map

package/dist/collections/TaxCodeCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxCodeCollection.d.ts","sourceRoot":"","sources":["../../src/collections/TaxCodeCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAE/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAGxD"}

package/dist/collections/TaxComponentCollection.d.ts

@@ -0,0 +1,6 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { TaxComponent } from '../models/TaxComponent.js';
+export declare class TaxComponentCollection extends SmrtCollection<TaxComponent> {
+    static readonly _itemClass: typeof TaxComponent;
+}
+//# sourceMappingURL=TaxComponentCollection.d.ts.map

package/dist/collections/TaxComponentCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxComponentCollection.d.ts","sourceRoot":"","sources":["../../src/collections/TaxComponentCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;CAC3C"}

package/dist/collections/TaxSettingsCollection.d.ts

@@ -0,0 +1,16 @@
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { TaxSettings } from '../models/TaxSettings.js';
+export declare class TaxSettingsCollection extends SmrtCollection<TaxSettings> {
+    static readonly _itemClass: typeof TaxSettings;
+    getOrCreateForTenant(tenantId: string): Promise<TaxSettings>;
+    getForTenant(tenantId: string): Promise<TaxSettings | null>;
+    /** @internal Lock and re-read the one tenant marker on this transaction. */
+    lockForTenant(tenantId: string, create?: boolean): Promise<TaxSettings | null>;
+    /** Claim exclusive runtime maintenance before any per-document rewrite. */
+    beginMoneyMigration(tenantId: string, requestedMigrationId?: string): Promise<string>;
+    activateMoneyV2(tenantId: string, migrationId: string): Promise<void>;
+    restoreLegacyMoneyModel(tenantId: string, migrationId: string): Promise<void>;
+    /** Claim a previously completed migration for checksum-guarded rollback. */
+    beginMoneyRollback(tenantId: string, migrationId: string): Promise<void>;
+}
+//# sourceMappingURL=TaxSettingsCollection.d.ts.map

package/dist/collections/TaxSettingsCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxSettingsCollection.d.ts","sourceRoot":"","sources":["../../src/collections/TaxSettingsCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEnC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAW5D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAMjE,4EAA4E;IACtE,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,UAAO,GACZ,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiB9B,2EAA2E;IACrE,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,MAAM,CAAC;IAwBZ,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAgBhB,4EAA4E;IACtE,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/collections/TaxSummaryReportCollection.d.ts

@@ -0,0 +1,151 @@
+import type { SmrtCollection, SmrtListOptions, SmrtObject, SmrtSelectedRow, SmrtSelectField, SmrtStiReadScope } from '@happyvertical/smrt-core';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { SmrtReportCollection } from '@happyvertical/smrt-reports';
+import { TaxSummaryReport } from '../models/TaxSummaryReport.js';
+import { aggregateTaxSummary, type TaxSummaryComponentMapping, type TaxSummaryExpenseFact, type TaxSummaryLedgerMovement } from '../tax-summary.js';
+import { type InvoiceTaxReportFact } from './DocumentTaxCollection.js';
+export interface TaxSummaryExpenseSource {
+    listReviewedTaxFacts(options: {
+        tenantId: string;
+        from: string;
+        to: string;
+        /** Refresh supplies its transaction-bound executor. */
+        db: DatabaseInterface;
+    }): Promise<readonly TaxSummaryExpenseFact[]>;
+}
+export interface TaxSummaryLedgerSource {
+    listPostedMovements(options: {
+        tenantId: string;
+        accountIds: string[];
+        from: Date;
+        to: Date;
+        currency: string;
+        /** Refresh supplies its transaction-bound executor. */
+        db: DatabaseInterface;
+    }): Promise<readonly TaxSummaryLedgerMovement[]>;
+}
+export interface RefreshTaxSummaryReportOptions {
+    tenantId: string;
+    from: Date;
+    to: Date;
+    /** Dependency inversion: expenses already depend on commerce. */
+    expenseSource: TaxSummaryExpenseSource;
+    /** Inject the ledger owner rather than reaching into its private state. */
+    ledgerSource: TaxSummaryLedgerSource;
+    expenseComponentMappings: readonly TaxSummaryComponentMapping[];
+}
+export interface TaxSummaryReportRefreshResult {
+    rowCount: number;
+    complete: boolean;
+}
+export interface TaxSummaryInvoiceDrilldownOptions {
+    /** Bound by the authenticated principal or browser host, never supplied by a row. */
+    tenantId: string;
+    reportId: string;
+}
+/** A numeric report cell, selected explicitly rather than inferred from a row. */
+export type TaxSummaryReportMeasure = 'taxable' | 'tax' | 'recoverable' | 'net' | 'ledgerMovement' | 'difference' | 'documentCount' | 'warning';
+/** Detail shape supplied by the ledger owner for a reconciliation drilldown. */
+export interface TaxSummaryLedgerDrilldownFact extends TaxSummaryLedgerMovement {
+    journalId: string;
+    journalDate: Date;
+    journalNumber: string;
+    sourceModule: string;
+    sourceRef: string | null;
+    debit: number;
+    credit: number;
+}
+/** Dependency-inverted because commerce cannot import the ledgers package. */
+export interface TaxSummaryLedgerDrilldownSource {
+    listPostedMovements(options: {
+        tenantId: string;
+        accountIds: string[];
+        from: Date;
+        to: Date;
+        currency: string;
+        db: DatabaseInterface;
+    }): Promise<readonly TaxSummaryLedgerDrilldownFact[]>;
+}
+export interface TaxSummaryContributorDrilldownOptions extends TaxSummaryInvoiceDrilldownOptions {
+    measure: TaxSummaryReportMeasure;
+    /** Required only when the materialized row says that it contains expenses. */
+    expenseSource?: TaxSummaryExpenseSource;
+    /** Required for ledger and reconciliation cells. */
+    ledgerSource?: TaxSummaryLedgerDrilldownSource;
+    expenseComponentMappings?: readonly TaxSummaryComponentMapping[];
+}
+export type TaxSummaryDrilldownPending = 'expense-source' | 'ledger-source' | 'purchase-source' | 'source-provenance-missing' | 'source-state-diverged' | 'materialized-incomplete';
+export type TaxSummaryDrilldownContributor = {
+    source: 'invoice';
+    valueMinor: number;
+    fact: InvoiceTaxReportFact;
+} | {
+    source: 'contract';
+    valueMinor: number;
+    fact: InvoiceTaxReportFact;
+} | {
+    source: 'expense';
+    valueMinor: number;
+    expense: TaxSummaryExpenseFact;
+    expenseCode: string | null;
+} | {
+    source: 'ledger';
+    valueMinor: number;
+    movement: TaxSummaryLedgerDrilldownFact;
+};
+export interface TaxSummaryContributorDrilldown {
+    row: TaxSummaryReport;
+    measure: TaxSummaryReportMeasure;
+    contributors: TaxSummaryDrilldownContributor[];
+    /** False means this detail cannot establish the materialized cell exactly. */
+    complete: boolean;
+    pending: TaxSummaryDrilldownPending[];
+}
+export declare class TaxSummaryReportCollection extends SmrtReportCollection<TaxSummaryReport> {
+    static readonly _itemClass: typeof TaxSummaryReport;
+    private assertReadableMoneyModel;
+    get(filter: Parameters<SmrtCollection<TaxSummaryReport>['get']>[0], options?: Parameters<SmrtCollection<TaxSummaryReport>['get']>[1]): Promise<TaxSummaryReport | null>;
+    count(options?: Parameters<SmrtCollection<TaxSummaryReport>['count']>[0]): Promise<number>;
+    list<const Select extends readonly SmrtSelectField<TaxSummaryReport>[]>(options: Omit<SmrtListOptions<TaxSummaryReport>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope: SmrtStiReadScope;
+    }): Promise<Record<string, unknown>[]>;
+    list<const Select extends readonly SmrtSelectField<TaxSummaryReport>[]>(options: Omit<SmrtListOptions<TaxSummaryReport>, 'select' | 'stiScope'> & {
+        select: Select;
+        include?: never;
+        stiScope?: undefined;
+    }): Promise<SmrtSelectedRow<TaxSummaryReport, Select>[]>;
+    list(options: Omit<SmrtListOptions<TaxSummaryReport>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope: SmrtStiReadScope;
+    }): Promise<SmrtObject[]>;
+    list(options?: undefined): Promise<TaxSummaryReport[]>;
+    list(options: Omit<SmrtListOptions<TaxSummaryReport>, 'select' | 'stiScope'> & {
+        select?: undefined;
+        stiScope?: undefined;
+    }): Promise<TaxSummaryReport[]>;
+    list(options: (Omit<SmrtListOptions<TaxSummaryReport>, 'select'> & {
+        select?: undefined;
+    }) | undefined): Promise<SmrtObject[]>;
+    list(options: SmrtListOptions<TaxSummaryReport> | undefined): Promise<SmrtObject[] | Record<string, unknown>[]>;
+    /**
+     * Rebuild the Invoice path from immutable snapshots. Legacy or migrating
+     * tenants are refused because their rows are not a complete v2 tax source.
+     */
+    refreshTaxSummary(options: RefreshTaxSummaryReportOptions): Promise<TaxSummaryReportRefreshResult>;
+    /**
+     * Execute the Invoice-path drilldown under a principal-bound tenant. The
+     * materialized row cannot expand its own tenant or date range.
+     */
+    drilldownInvoiceFacts(options: TaxSummaryInvoiceDrilldownOptions): Promise<InvoiceTaxReportFact[]>;
+    /**
+     * Re-read the owning sources for one explicitly selected materialized cell.
+     * Missing owners and source drift are reported as incomplete instead of being
+     * displayed as a zero or as unrelated Invoice facts.
+     */
+    drilldownContributors(options: TaxSummaryContributorDrilldownOptions): Promise<TaxSummaryContributorDrilldown>;
+}
+/** @internal Maps aggregate nullability onto persisted report rows. */
+export declare function materializeTaxSummaryRows(options: Pick<RefreshTaxSummaryReportOptions, 'tenantId' | 'from' | 'to'>, result: ReturnType<typeof aggregateTaxSummary>): Promise<Array<Record<string, unknown>>>;
+//# sourceMappingURL=TaxSummaryReportCollection.d.ts.map

package/dist/collections/TaxSummaryReportCollection.d.ts.map

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

package/dist/collections/index.d.ts

@@ -5,10 +5,12 @@
 export { ContractCollection } from './ContractCollection.js';
 export { ContractLineItemCollection } from './ContractLineItemCollection.js';
 export { CustomerCollection } from './CustomerCollection.js';
+export { DocumentTaxCollection, type DocumentTaxReportFact, type DocumentTaxReportFactsOptions, type InvoiceTaxReportFact, type InvoiceTaxReportFactsOptions, } from './DocumentTaxCollection.js';
 export { FulfillmentCollection } from './FulfillmentCollection.js';
 export { FulfillmentLineItemCollection } from './FulfillmentLineItemCollection.js';
 export { InvoiceCollection, type InvoiceNumberOptions, UNPAID_STATUSES, } from './InvoiceCollection.js';
 export { InvoiceLineItemCollection } from './InvoiceLineItemCollection.js';
+export { MoneyMigrationDocumentCollection } from './MoneyMigrationDocumentCollection.js';
 export { PaymentAllocationCollection } from './PaymentAllocationCollection.js';
 export { PaymentCollection } from './PaymentCollection.js';
 export { PaymentInstrumentCollection } from './PaymentInstrumentCollection.js';
@@ -16,5 +18,9 @@ export { PaymentIntentCollection, type PaymentIntentIdempotencyArgs, type Paymen
 export { type CreatePayoutFromPaymentArgs, PayoutCollection, } from './PayoutCollection.js';
 export { PurchaseContractCollection } from './PurchaseContractCollection.js';
 export { SalesContractCollection } from './SalesContractCollection.js';
+export { TaxCodeCollection } from './TaxCodeCollection.js';
+export { TaxComponentCollection } from './TaxComponentCollection.js';
+export { TaxSettingsCollection } from './TaxSettingsCollection.js';
+export { type RefreshTaxSummaryReportOptions, type TaxSummaryContributorDrilldown, type TaxSummaryContributorDrilldownOptions, type TaxSummaryDrilldownContributor, type TaxSummaryDrilldownPending, type TaxSummaryExpenseSource, type TaxSummaryInvoiceDrilldownOptions, type TaxSummaryLedgerDrilldownFact, type TaxSummaryLedgerDrilldownSource, type TaxSummaryLedgerSource, TaxSummaryReportCollection, type TaxSummaryReportMeasure, type TaxSummaryReportRefreshResult, } from './TaxSummaryReportCollection.js';
 export { VendorCollection } from './VendorCollection.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,2BAA2B,EAChC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collections/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EACL,iBAAiB,EACjB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,KAAK,2BAA2B,EAChC,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,GACnC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/commerce-money-tools.d.ts

@@ -0,0 +1,9 @@
+/** Principal-bound commerce money tools for draft invoices (#3937). */
+import type { PrincipalTool } from '@happyvertical/smrt-agents';
+export declare const COMMERCE_TAX_CODES_LIST_TOOL_SLUG = "commerce.taxCodes.list";
+export declare const COMMERCE_INVOICE_PREVIEW_TOOL_SLUG = "commerce.invoice.preview";
+export declare const COMMERCE_INVOICE_LINE_ADD_TOOL_SLUG = "commerce.invoice.line.add";
+export declare const COMMERCE_INVOICE_LINE_UPDATE_TOOL_SLUG = "commerce.invoice.line.update";
+/** Build draft-only commerce tools for the existing `extraTools` seam. */
+export declare function createCommerceMoneyTools(): PrincipalTool[];
+//# sourceMappingURL=commerce-money-tools.d.ts.map

package/dist/commerce-money-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-money-tools.d.ts","sourceRoot":"","sources":["../src/commerce-money-tools.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,4BAA4B,CAAC;AAqBpC,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAC1E,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAC7E,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAC/E,eAAO,MAAM,sCAAsC,iCACnB,CAAC;AA4djC,0EAA0E;AAC1E,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CA2J1D"}

package/dist/contract-money.d.ts

@@ -0,0 +1,27 @@
+/** Transactional Contract money aggregate persistence. */
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type DocumentTaxWriteInput } from './collections/DocumentTaxCollection.js';
+import { type Contract, classifyContractPurchase, isContractSnapshotReportEligible } from './models/Contract.js';
+import type { ContractLineItem } from './models/ContractLineItem.js';
+type DeleteOptions = {
+    expectedUpdatedAt?: Date | string;
+};
+export { classifyContractPurchase, isContractSnapshotReportEligible };
+/** Save a Contract through legacy compatibility or the v2 aggregate. */
+export declare function saveContract(input: Contract): Promise<Contract>;
+/** Save a line and atomically recompute its Contract aggregate. */
+export declare function saveContractLineItem(input: ContractLineItem): Promise<ContractLineItem>;
+export declare function deleteContractLineItem(input: ContractLineItem, options: DeleteOptions): Promise<void>;
+/** Recompute a Contract through its normal runtime gate. */
+export declare function recalculateContractTotals(contract: Contract): Promise<void>;
+/** Migration-only materializer; caller already owns the tenant migration transaction. */
+export declare function materializeContractMoneySnapshot(input: {
+    db: DatabaseInterface;
+    contractId: string;
+    tenantId: string;
+    migrationId: string;
+}): Promise<{
+    contractId: string;
+    taxRows: DocumentTaxWriteInput[];
+}>;
+//# sourceMappingURL=contract-money.d.ts.map

package/dist/contract-money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-money.d.ts","sourceRoot":"","sources":["../src/contract-money.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAK7E,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,wCAAwC,CAAC;AAQhD,OAAO,EACL,KAAK,QAAQ,EACb,wBAAwB,EACxB,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAerE,KAAK,aAAa,GAAG;IAAE,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AA8E3D,OAAO,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,CAAC;AAsQtE,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgFrE;AAED,mEAAmE;AACnE,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAwD3B;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,4DAA4D;AAC5D,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,yFAAyF;AACzF,wBAAsB,gCAAgC,CAAC,KAAK,EAAE;IAC5D,EAAE,EAAE,iBAAiB,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAAE,CAAC,CA2BpE"}

package/dist/cost-billing.d.ts

@@ -1,4 +1,3 @@
-/** Exact, transport-neutral cost pricing. All money is signed integer minor units. */
 export type CostBillingMode = 'reimbursement-plus-fee' | 'fee-only' | 'nonbillable' | 'fixed-contract';
 /** Caller-defined precedence, most specific first. No industry hierarchy is assumed. */
 export interface CostMarkupOverride {

package/dist/cost-billing.d.ts.map

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

package/dist/cost-billing.js

@@ -1,3 +1,4 @@
+import { n as roundSignedRational, t as allocateSignedRationals } from "./chunks/money-rational-CcW7gzG5.js";
 //#region src/cost-billing.ts
 var SCALE = 1000000n;
 var DENOMINATOR = 100n * SCALE;
@@ -18,8 +19,7 @@ function safe(value) {
 	return Number(value);
 }
 function rounded(numerator) {
-	const result = ((numerator < 0n ? -numerator : numerator) + DENOMINATOR / 2n) / DENOMINATOR;
-	return numerator < 0n ? -result : result;
+	return roundSignedRational(numerator, DENOMINATOR);
 }
 function identifier(value) {
 	if (typeof value !== "string" || value.trim().length === 0) throw new TypeError("Identifiers must be nonempty strings");
@@ -190,24 +190,19 @@ function calculateOrderedCostBillingTax(input) {
 				line,
 				basisMinor: safe(basis),
 				numerator,
-				remainder: numerator % DENOMINATOR,
 				tax: input.roundingScope === "line" ? rounded(numerator) : numerator / DENOMINATOR
 			};
 		});
 		let tax = allocations.reduce((sum, allocation) => sum + allocation.tax, 0n);
 		if (input.roundingScope === "invoice") {
-			const target = rounded(allocations.reduce((sum, a) => sum + a.numerator, 0n));
-			const residual = target - tax;
-			if (residual !== 0n) {
-				const direction = residual > 0n ? 1n : -1n;
-				const ranked = [...allocations].sort((a, b) => {
-					const difference = (b.remainder - a.remainder) * direction;
-					return difference < 0n ? -1 : difference > 0n ? 1 : compareTaxLineIds(a, b);
-				});
-				const count = residual * direction;
-				for (let index = 0; BigInt(index) < count; index++) ranked[index].tax += direction;
-			}
-			tax = target;
+			const distributed = allocateSignedRationals(allocations.map((allocation) => ({
+				id: allocation.id,
+				numerator: allocation.numerator,
+				denominator: DENOMINATOR
+			})));
+			const byId = new Map(distributed.allocations.map((allocation) => [allocation.id, allocation.value]));
+			for (const allocation of allocations) allocation.tax = byId.get(allocation.id);
+			tax = distributed.target;
 		}
 		total += tax;
 		return {