@happyvertical/smrt-commerce 0.56.0 → 0.56.2

package/dist/migrations/commerceLineAmounts.d.ts

@@ -0,0 +1,84 @@
+/** Commerce line-amount preflight, migration and rollback. */
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+export type CommerceLineAmountReasonCode = 'DRAFT_RECOMPUTED' | 'ISSUED_BACKFILLED' | 'UNRECONCILED' | 'TAX_RATE_OVER_ONE' | 'HAND_ENTERED_AMOUNT' | 'NEGATIVE_HALF_UNIT_GROSS' | 'MISSING_HEADER_TOTALS' | 'STALE_EDITOR_BLOB' | 'ORPHAN_LINE' | 'CROSS_TENANT_LINE' | 'MISSING_LINE_TENANT' | 'CONTRACT_DIRECTION_UNKNOWN' | 'ACCOUNTING_SYNC_UNSETTLED';
+export interface CommerceMoneyTotals {
+    subtotalMinor: number;
+    taxMinor: number;
+    totalMinor: number;
+}
+export interface CommerceLineAmountDocumentReport {
+    tenantId: string;
+    documentType: 'invoice' | 'contract';
+    documentId: string;
+    status: string;
+    arJournalIdSet: boolean;
+    old: CommerceMoneyTotals;
+    next: CommerceMoneyTotals;
+    delta: CommerceMoneyTotals;
+    reasons: CommerceLineAmountReasonCode[];
+}
+export interface CommerceLineAmountTenantSummary {
+    tenantId: string;
+    documentCount: number;
+    changingDraftCount: number;
+    issuedUnpostedFallbackTaxCount: number;
+    reasonCounts: Partial<Record<CommerceLineAmountReasonCode, number>>;
+}
+export interface CommerceLineAmountsReport {
+    version: 1;
+    documents: CommerceLineAmountDocumentReport[];
+    tenants: CommerceLineAmountTenantSummary[];
+}
+/** Explicit report destinations. Omit `out` to receive only structured data. */
+export interface CommerceLineAmountsReportOutput {
+    jsonPath: string;
+    csvPath: string;
+}
+export interface PreflightCommerceLineAmountsOptions {
+    /**
+     * Optional artifact paths. Omitting this never writes files; the preflight
+     * still returns the complete structured CommerceLineAmountsReport.
+     */
+    out?: CommerceLineAmountsReportOutput;
+    /** Optional tenant restriction. Omit only from a system migration context. */
+    tenantId?: string;
+}
+export interface MigrateCommerceLineAmountsOptions {
+    tenantId: string;
+    acceptDraftChanges?: boolean;
+    /**
+     * Stable owner identity chosen before the attempt starts. Supplying it on
+     * the first call makes failures after the tenant claim safely resumable;
+     * a retry must present the same identity.
+     */
+    migrationId?: string;
+}
+export interface CommerceLineAmountsMigrationResult {
+    tenantId: string;
+    migrationId: string;
+    migrated: number;
+    resumed: number;
+    activated: boolean;
+    report: CommerceLineAmountsReport;
+}
+export interface RollbackCommerceLineAmountsOptions {
+    tenantId: string;
+    migrationId: string;
+}
+export interface CommerceLineAmountsRollbackResult {
+    tenantId: string;
+    migrationId: string;
+    restored: number;
+    alreadyRestored: number;
+}
+/** Stable JSON bytes for review artifacts and retry comparisons. */
+export declare function serializeCommerceLineAmountsReportJson(report: CommerceLineAmountsReport): string;
+/** Stable one-row-per-document CSV bytes. Tenant summaries remain in JSON. */
+export declare function serializeCommerceLineAmountsReportCsv(report: CommerceLineAmountsReport): string;
+/** Read-only migration inventory. It never creates TaxSettings or claims a barrier. */
+export declare function preflightCommerceLineAmounts(db: DatabaseInterface, options?: PreflightCommerceLineAmountsOptions): Promise<CommerceLineAmountsReport>;
+/** Claim one tenant, migrate each document durably, verify, then activate v2. */
+export declare function migrateCommerceLineAmounts(db: DatabaseInterface, options: MigrateCommerceLineAmountsOptions): Promise<CommerceLineAmountsMigrationResult>;
+/** Restore exact pre-images only while every current document still matches its post-image. */
+export declare function rollbackCommerceLineAmounts(db: DatabaseInterface, options: RollbackCommerceLineAmountsOptions): Promise<CommerceLineAmountsRollbackResult>;
+//# sourceMappingURL=commerceLineAmounts.d.ts.map

package/dist/migrations/commerceLineAmounts.d.ts.map

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

package/dist/migrations/partyLinks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partyLinks.d.ts","sourceRoot":"","sources":["../../src/migrations/partyLinks.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAG3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;IACjD,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;IAC5C,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;IAChD,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,4BAA4B,EAAE,oBAAoB,EAAE,CAAC;IACrD,mBAAmB,EAAE,yBAAyB,EAAE,CAAC;IACjD,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;IACrD,sBAAsB,EAAE,gCAAgC,EAAE,CAAC;IAC3D,yBAAyB,EAAE,gCAAgC,EAAE,CAAC;CAC/D;AAuCD,yFAAyF;AACzF,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAmJtC"}
+{"version":3,"file":"partyLinks.d.ts","sourceRoot":"","sources":["../../src/migrations/partyLinks.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAG3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iFAAiF;AACjF,MAAM,WAAW,gCAAgC;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;IACjD,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;IAC5C,uBAAuB,EAAE,oBAAoB,EAAE,CAAC;IAChD,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,4BAA4B,EAAE,oBAAoB,EAAE,CAAC;IACrD,mBAAmB,EAAE,yBAAyB,EAAE,CAAC;IACjD,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;IACrD,sBAAsB,EAAE,gCAAgC,EAAE,CAAC;IAC3D,yBAAyB,EAAE,gCAAgC,EAAE,CAAC;CAC/D;AA4CD,yFAAyF;AACzF,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,2BAA2B,CAAC,CAmJtC"}

package/dist/models/Contract.d.ts

@@ -3,14 +3,20 @@
  * @packageDocumentation
  */
 import { type Meta, SmrtObject } from '@happyvertical/smrt-core';
-import { type ContractOptions, ContractStatus, ContractType, type LicenseSaleOptions, type PurchaseContractOptions, type PurchaseOrderOptions, type SalesContractOptions } from '../types/index.js';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type DocumentMoneyReadRebindCapability, type DocumentMoneyWriteCapability } from '../document-money-internal.js';
+import { type ContractOptions, ContractStatus, ContractType, type LicenseSaleOptions, type PurchaseContractOptions, type PurchaseOrderOptions, type SalesContractOptions, type TaxRegistrationOptions } from '../types/index.js';
+/** Whether a Contract belongs to the purchase STI branch, including descendants. */
+export declare function classifyContractPurchase(contract: Contract): boolean;
+/** Frozen snapshots are reportable except cancelled contracts and supplier quotes. */
+export declare function isContractSnapshotReportEligible(contract: Contract): boolean;
 /**
  * Contract is the base class for all commercial agreements.
  *
- * Uses Single Table Inheritance (STI) for nine leaf types. SalesContract owns
+ * Uses Single Table Inheritance (STI) for ten leaf types. SalesContract owns
  * the customer link for Estimate, Order, WholesaleOrder, Cart, Lease,
  * Agreement, and LicenseSale. PurchaseContract owns the vendor link for
- * PurchaseOrder and ProductionOrder. Both branches share `contracts`.
+ * SupplierQuote, PurchaseOrder and ProductionOrder. Both branches share `contracts`.
  *
  * @example
  * ```typescript
@@ -32,6 +38,8 @@ import { type ContractOptions, ContractStatus, ContractType, type LicenseSaleOpt
  * ```
  */
 export declare class Contract extends SmrtObject {
+    /** @internal Collection read guard returns this snapshot on its root DB. */
+    rebindMoneyRead(capability: DocumentMoneyReadRebindCapability, db: DatabaseInterface): this;
     /**
      * Tenant ID for multi-tenant isolation
      * Nullable to support both tenant-scoped and global contracts
@@ -54,6 +62,8 @@ export declare class Contract extends SmrtObject {
      * (#2401).
      */
     subtotal: number;
+    /** Informational sum of resolved line discounts, in integer minor units. */
+    discountTotal: number;
     /**
      * Tax amount, in integer minor units (#2401).
      */
@@ -66,6 +76,18 @@ export declare class Contract extends SmrtObject {
      * Currency code (ISO 4217)
      */
     currency: string;
+    /** Pricing interpretation fixed before the Contract leaves draft. */
+    lineAmountType: 'exclusive' | 'inclusive' | 'none';
+    /** Component rounding scope fixed before the Contract leaves draft. */
+    taxRoundingScope: 'line' | 'document';
+    /** Immutable seller registration snapshot once the Contract leaves draft. */
+    sellerTaxRegistrationsJson: string;
+    get sellerTaxRegistrations(): TaxRegistrationOptions[];
+    set sellerTaxRegistrations(value: TaxRegistrationOptions[]);
+    /** Immutable customer or vendor tax identifier snapshot after issue. */
+    partyTaxId: string;
+    /** Stable issue/freeze identity, independent of lifecycle updated_at. */
+    moneySnapshotId: string;
     /**
      * Date contract was issued
      */
@@ -146,6 +168,8 @@ export declare class Contract extends SmrtObject {
      * write surface (#2401).
      */
     save(): Promise<this>;
+    /** @internal Contract aggregate persistence only. */
+    saveDerived(capability: DocumentMoneyWriteCapability): Promise<this>;
     /**
      * Reject an illegal status flip done via raw assignment. No-op transitions
      * and brand-new rows are always allowed.
@@ -174,7 +198,7 @@ export declare abstract class SalesContract extends Contract {
     customerId: string | null;
     constructor(options?: SalesContractOptions);
 }
-/** Supplier-side contracts, including purchase and production orders. */
+/** Supplier-side contracts, including supplier quotes, purchase and production orders. */
 export declare abstract class PurchaseContract extends Contract {
     vendorId: string | null;
     constructor(options?: PurchaseContractOptions);
@@ -211,6 +235,12 @@ export declare class Agreement extends SalesContract {
     contractType: ContractType;
     constructor(options?: SalesContractOptions);
 }
+/** Supplier quotation received from a vendor; acceptance does not create an order. */
+export declare class SupplierQuote extends PurchaseContract {
+    vendorId: string | null;
+    contractType: ContractType;
+    constructor(options?: PurchaseContractOptions);
+}
 /**
  * PurchaseOrder - Order sent to vendor/supplier
  */

package/dist/models/Contract.d.ts.map

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

package/dist/models/ContractLineItem.d.ts

@@ -3,7 +3,9 @@
  * @packageDocumentation
  */
 import { SmrtObject } from '@happyvertical/smrt-core';
-import type { ContractLineItemOptions } from '../types/index.js';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type DocumentMoneyReadRebindCapability, type DocumentMoneyWriteCapability } from '../document-money-internal.js';
+import type { ContractLineItemOptions, ContractTaxComponentSnapshot } from '../types/index.js';
 /**
  * ContractLineItem represents a single line item on a contract.
  *
@@ -22,6 +24,8 @@ import type { ContractLineItemOptions } from '../types/index.js';
  * ```
  */
 export declare class ContractLineItem extends SmrtObject {
+    /** @internal Collection read guard returns this snapshot on its root DB. */
+    rebindMoneyRead(capability: DocumentMoneyReadRebindCapability, db: DatabaseInterface): this;
     /**
      * Tenant ID for multi-tenant isolation
      * Nullable to support both tenant-scoped and global line items
@@ -41,7 +45,9 @@ export declare class ContractLineItem extends SmrtObject {
      */
     quantity: number;
     /**
-     * Unit price before discount, in **integer minor units** (cents, satoshis).
+     * Unit price before discount, in **integer minor units** (cents, satoshis),
+     * in the document's pricing mode: tax-inclusive when its `lineAmountType`
+     * is `inclusive`.
      *
      * The `= 0` initializer is load-bearing: SMRT maps an integer literal to
      * INTEGER and a decimal literal to DECIMAL. Money is exact, so `$49.99` is
@@ -52,15 +58,36 @@ export declare class ContractLineItem extends SmrtObject {
      * Discount amount (flat, not percentage), in integer minor units (#2401).
      */
     discount: number;
+    discountType: 'none' | 'percent' | 'amount';
+    discountRate: string;
     /**
      * Tax rate as decimal (e.g., 0.08 for 8%). A rate is inherently fractional,
      * so it stays DECIMAL — INTEGER would truncate every meaningful value.
      */
     taxRate: number;
-    /**
-     * Calculated line amount (qty * price - discount + tax), in integer minor
-     * units. Derived by {@link ContractLineItem.calculateAmount}, which rounds
-     * the fractional tax to a whole minor unit (#2401).
+    taxMode: 'inherit' | 'override';
+    taxCodeId: string | null;
+    taxCodeCode: string | null;
+    taxCodeName: string | null;
+    taxComponentsJson: string | null;
+    get taxComponents(): ContractTaxComponentSnapshot[];
+    set taxComponents(value: ContractTaxComponentSnapshot[]);
+    /** Exact sum of frozen component taxes, in integer minor units. */
+    taxAmount: number;
+    /**
+     * @internal Pre-v2 amount preserved only by the migration path for
+     * rollback; not a user-facing amount, so it carries no money hint.
+     */
+    legacyAmount: number | null;
+    /** Stable issue/freeze identity, independent of lifecycle updated_at. */
+    moneySnapshotId: string;
+    /**
+     * Calculated line amount, in integer minor units. Under money v2 it is net
+     * of discount and before tax for `exclusive` / `none` documents, and
+     * tax-inclusive for `inclusive` ones; {@link taxAmount} holds the tax. The
+     * legacy model stores qty * price - discount + tax, derived by
+     * {@link ContractLineItem.calculateAmount}, which rounds the fractional tax
+     * to a whole minor unit (#2401).
      */
     amount: number;
     /**
@@ -98,6 +125,16 @@ export declare class ContractLineItem extends SmrtObject {
      * plain `===` instead of an epsilon tolerance (#2401).
      */
     calculateAmount(): number;
+    save(): Promise<this>;
+    /** @internal Contract aggregate persistence only. */
+    saveDerived(capability: DocumentMoneyWriteCapability, legacy: boolean): Promise<this>;
+    delete(options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
+    /** @internal Contract aggregate persistence only. */
+    deleteDerived(capability: DocumentMoneyWriteCapability, options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
     /**
      * Check if this is a subscription/recurring item
      */

package/dist/models/ContractLineItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContractLineItem.d.ts","sourceRoot":"","sources":["../../src/models/ContractLineItem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAOa,gBAAiB,SAAQ,UAAU;IAC9C;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAGH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IAEH,WAAW,EAAE,MAAM,CAAM;IAEzB;;;OAGG;IAEH,QAAQ,EAAE,MAAM,CAAO;IAEvB;;;;;;OAMG;IAKH,SAAS,EAAE,MAAM,CAAK;IAEtB;;OAEG;IAEH,QAAQ,EAAE,MAAM,CAAK;IAErB;;;OAGG;IAIH,OAAO,EAAE,MAAM,CAAO;IAEtB;;;;OAIG;IAEH,MAAM,EAAE,MAAM,CAAK;IAEnB;;OAEG;IAKH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAM;IAEjB;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE9B;;OAEG;IACH,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE5B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAM;IAE3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAK;gBAEV,OAAO,GAAE,uBAA4B;IAoBjD;;;;;;;;OAQG;IACH,eAAe,IAAI,MAAM;IAMzB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,oBAAoB,IAAI,OAAO;CAUhC;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"ContractLineItem.d.ts","sourceRoot":"","sources":["../../src/models/ContractLineItem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE7E,OAAO,EAGL,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAOa,gBAAiB,SAAQ,UAAU;IAC9C,4EAA4E;IAC5E,eAAe,CACb,UAAU,EAAE,iCAAiC,EAC7C,EAAE,EAAE,iBAAiB,GACpB,IAAI;IAUP;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IAGH,UAAU,EAAE,MAAM,CAAM;IAExB;;OAEG;IAEH,WAAW,EAAE,MAAM,CAAM;IAEzB;;;OAGG;IAEH,QAAQ,EAAE,MAAM,CAAO;IAEvB;;;;;;;;OAQG;IAMH,SAAS,EAAE,MAAM,CAAK;IAEtB;;OAEG;IAEH,QAAQ,EAAE,MAAM,CAAK;IAErB,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAU;IAGrD,YAAY,SAAS;IAErB;;;OAGG;IAKH,OAAO,EAAE,MAAM,CAAO;IAEtB,OAAO,EAAE,SAAS,GAAG,UAAU,CAAa;IAG5C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAExC,IAAI,aAAa,IAAI,4BAA4B,EAAE,CAoBlD;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,4BAA4B,EAAE,EAEtD;IAED,mEAAmE;IAEnE,SAAS,SAAK;IAEd;;;OAGG;IAEH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC,yEAAyE;IACzE,eAAe,SAAM;IAErB;;;;;;;OAOG;IAMH,MAAM,EAAE,MAAM,CAAK;IAEnB;;OAEG;IAKH,SAAS,EAAE,MAAM,CAAM;IAEvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAM;IAEjB;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE9B;;OAEG;IACH,OAAO,EAAE,IAAI,GAAG,IAAI,CAAQ;IAE5B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAM;IAE3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAK;gBAEV,OAAO,GAAE,uBAA4B;IAuCjD;;;;;;;;OAQG;IACH,eAAe,IAAI,MAAM;IAMV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC,qDAAqD;IAC/C,WAAW,CACf,UAAU,EAAE,4BAA4B,EACxC,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC;IAOD,MAAM,CACnB,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;KAAO,GAClD,OAAO,CAAC,IAAI,CAAC;IAKhB,qDAAqD;IAC/C,aAAa,CACjB,UAAU,EAAE,4BAA4B,EACxC,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;KAAO,GAClD,OAAO,CAAC,IAAI,CAAC;IAMhB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,oBAAoB,IAAI,OAAO;CAUhC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/Customer.d.ts

@@ -55,6 +55,13 @@ export declare class Customer extends SmrtObject {
      * rejected as a `where` filter key.
      */
     taxId: string;
+    /**
+     * Tax code normally used for this customer's sales.
+     *
+     * An exempt customer always resolves to the tenant's exempt code before
+     * this preference is considered.
+     */
+    defaultTaxCodeId: string;
     /**
      * Default shipping address
      */

package/dist/models/Customer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Customer.d.ts","sourceRoot":"","sources":["../../src/models/Customer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,qBAMa,QAAS,SAAQ,UAAU;IACtC;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;OAGG;IAKH,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;;;;;OAQG;IAMH,WAAW,EAAE,MAAM,CAAK;IAExB;;OAEG;IAKH,YAAY,EAAE,MAAM,CAAM;IAE1B;;OAEG;IAIH,SAAS,EAAE,OAAO,CAAS;IAE3B;;;;;OAKG;IAMH,KAAK,EAAE,MAAM,CAAM;IAEnB;;OAEG;IAKH,sBAAsB,EAAE,OAAO,CAAM;IAErC;;OAEG;IAEH,qBAAqB,EAAE,OAAO,CAAM;IAEpC;;OAEG;IAKH,MAAM,EAAE,cAAc,CAAyB;IAE/C;;;;;OAKG;IAKH,YAAY,EAAE,YAAY,CAAoB;IAE9C;;OAEG;IAKH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;OAGG;IAKH,QAAQ,EAAE,YAAY,EAAE,CAAM;gBAElB,OAAO,GAAE,eAAoB;IA8BzC;;;OAGG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1C,0EAA0E;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK3C;;;;;;;;;;OAUG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Customer.d.ts","sourceRoot":"","sources":["../../src/models/Customer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,cAAc,EACd,YAAY,EACZ,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;GAcG;AACH,qBAMa,QAAS,SAAQ,UAAU;IACtC;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;;OAGG;IAKH,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;;;;;OAQG;IAMH,WAAW,EAAE,MAAM,CAAK;IAExB;;OAEG;IAKH,YAAY,EAAE,MAAM,CAAM;IAE1B;;OAEG;IAIH,SAAS,EAAE,OAAO,CAAS;IAE3B;;;;;OAKG;IAMH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;;;OAKG;IAIH,gBAAgB,EAAE,MAAM,CAAM;IAE9B;;OAEG;IAKH,sBAAsB,EAAE,OAAO,CAAM;IAErC;;OAEG;IAEH,qBAAqB,EAAE,OAAO,CAAM;IAEpC;;OAEG;IAKH,MAAM,EAAE,cAAc,CAAyB;IAE/C;;;;;OAKG;IAKH,YAAY,EAAE,YAAY,CAAoB;IAE9C;;OAEG;IAKH,KAAK,EAAE,MAAM,CAAM;IAEnB;;;OAGG;IAKH,QAAQ,EAAE,YAAY,EAAE,CAAM;gBAElB,OAAO,GAAE,eAAoB;IAgCzC;;;OAGG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM1C,0EAA0E;IAC3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKpC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK3C;;;;;;;;;;OAUG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED,eAAe,QAAQ,CAAC"}

package/dist/models/DocumentTax.d.ts

@@ -0,0 +1,50 @@
+/** Persisted per-code/component tax totals for a commerce document. */
+import { SmrtObject, type SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { type DocumentMoneyWriteCapability } from '../document-money-internal.js';
+import { type TaxCodeKind } from '../money.js';
+export type CommerceDocumentType = 'invoice' | 'contract' | 'credit_note';
+export interface DocumentTaxOptions extends SmrtObjectOptions {
+    tenantId?: string;
+    documentType?: CommerceDocumentType;
+    documentId?: string;
+    currency?: string;
+    taxCodeId?: string | null;
+    taxCodeCode?: string | null;
+    kind?: TaxCodeKind | null;
+    taxComponentId?: string | null;
+    taxComponentName?: string | null;
+    percent?: string | null;
+    liabilityAccountId?: string | null;
+    taxableMinor?: number;
+    taxMinor?: number;
+    recoverableMinor?: number;
+}
+export declare class DocumentTax extends SmrtObject {
+    tenantId: string;
+    documentType: CommerceDocumentType;
+    documentId: string;
+    currency: string;
+    taxCodeId: string | null;
+    taxCodeCode: string | null;
+    kind: TaxCodeKind | null;
+    taxComponentId: string | null;
+    taxComponentName: string | null;
+    percent: string | null;
+    liabilityAccountId: string | null;
+    taxableMinor: number;
+    taxMinor: number;
+    recoverableMinor: number;
+    constructor(options?: DocumentTaxOptions);
+    private assertValidDerivedRow;
+    save(): Promise<this>;
+    delete(_options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
+    /** @internal Aggregate persistence only. */
+    saveDerived(capability: DocumentMoneyWriteCapability): Promise<this>;
+    /** @internal Aggregate persistence only. */
+    deleteDerived(capability: DocumentMoneyWriteCapability, options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=DocumentTax.d.ts.map

package/dist/models/DocumentTax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentTax.d.ts","sourceRoot":"","sources":["../../src/models/DocumentTax.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,EAEL,UAAU,EACV,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAE1E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,qBAaa,WAAY,SAAQ,UAAU;IAEzC,QAAQ,SAAM;IAGd,YAAY,EAAE,oBAAoB,CAAa;IAG/C,UAAU,SAAM;IAGhB,QAAQ,SAAS;IAGjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGhC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGlC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAQ;IAGhC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGrC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGvC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMzC,YAAY,SAAK;IAMjB,QAAQ,SAAK;IAMb,gBAAgB,SAAK;gBAET,OAAO,GAAE,kBAAuB;IAyB5C,OAAO,CAAC,qBAAqB;IAwFd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,MAAM,CACnB,QAAQ,GAAE;QAAE,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;KAAO,GACnD,OAAO,CAAC,IAAI,CAAC;IAOhB,4CAA4C;IACtC,WAAW,CAAC,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E,4CAA4C;IACtC,aAAa,CACjB,UAAU,EAAE,4BAA4B,EACxC,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;KAAO,GAClD,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/models/Invoice.d.ts

@@ -3,8 +3,11 @@
  * @packageDocumentation
  */
 import { SmrtObject } from '@happyvertical/smrt-core';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
 import type { Journal } from '@happyvertical/smrt-ledgers';
-import { type AccountingInvoiceInput, type InvoiceCollectionMethod, type InvoiceOptions, InvoiceStatus, type RecognizeRevenueOptions } from '../types/index.js';
+import { type DocumentMoneyReadRebindCapability, type DocumentMoneyWriteCapability } from '../document-money-internal.js';
+import type { FrozenInvoiceAccountingOptions } from '../invoice-accounting-sync.js';
+import { type AccountingInvoiceInput, type CancelRevenueOptions, type InvoiceCollectionMethod, type InvoiceKind, type InvoiceOptions, InvoiceStatus, type RecognizeRevenueOptions, type TaxRegistrationOptions } from '../types/index.js';
 /**
  * Invoice represents a bill sent to a customer for goods or services.
  *
@@ -38,6 +41,12 @@ import { type AccountingInvoiceInput, type InvoiceCollectionMethod, type Invoice
  * ```
  */
 export declare class Invoice extends SmrtObject {
+    /** @internal Collection read guard returns this snapshot on its root DB. */
+    rebindMoneyRead(capability: DocumentMoneyReadRebindCapability, db: DatabaseInterface): this;
+    kind: InvoiceKind;
+    creditedInvoiceId: string | null;
+    /** Issued credit-note total cached under the source invoice lock. */
+    creditedAmount: number;
     /**
      * Tenant ID for multi-tenant isolation
      * Nullable to support both tenant-scoped and global invoices
@@ -107,6 +116,20 @@ export declare class Invoice extends SmrtObject {
      * Currency code (ISO 4217)
      */
     currency: string;
+    /** Pricing interpretation fixed for the document before issue. */
+    lineAmountType: 'exclusive' | 'inclusive' | 'none';
+    /** Component rounding scope fixed for the document before issue. */
+    taxRoundingScope: 'line' | 'document';
+    /** Informational sum of resolved line discounts, in minor units. */
+    discountTotal: number;
+    /** Immutable seller registration snapshot once the invoice leaves draft. */
+    sellerTaxRegistrationsJson: string;
+    get sellerTaxRegistrations(): TaxRegistrationOptions[];
+    set sellerTaxRegistrations(value: TaxRegistrationOptions[]);
+    /** Immutable customer tax identifier snapshot once issued. */
+    partyTaxId: string;
+    /** Stable issue/freeze identity, independent of lifecycle updated_at. */
+    moneySnapshotId: string;
     /**
      * Current invoice status
      */
@@ -115,6 +138,8 @@ export declare class Invoice extends SmrtObject {
      * Journal ID for AR recognition (cross-package ref to smrt-ledgers)
      */
     arJournalId: string;
+    /** Posted journal that exactly reverses arJournalId on cancellation. */
+    arReversalJournalId: string | null;
     /**
      * Journal ID for revenue recognition (cross-package ref to smrt-ledgers)
      */
@@ -136,6 +161,8 @@ export declare class Invoice extends SmrtObject {
      * When invoice was last synced to provider
      */
     syncedAt: Date | null;
+    /** Server-owned prepared/in-flight/result identity for frozen accounting sync. */
+    accountingSyncStateJson: string;
     /**
      * How the provider collects this invoice (#3190), decided once by billing
      * period close before its first push and reused on every retry, so it is
@@ -205,6 +232,17 @@ export declare class Invoice extends SmrtObject {
      *  - **Status transitions** are validated against the prior persisted status.
      */
     save(): Promise<this>;
+    /** @internal Aggregate persistence only. */
+    saveDerived(capability: DocumentMoneyWriteCapability, options: {
+        recomputeLegacy: boolean;
+    }): Promise<this>;
+    delete(options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
+    /** @internal Aggregate persistence only. */
+    deleteDerived(capability: DocumentMoneyWriteCapability, options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
     /**
      * Resolve the AUTHORITATIVE prior status (S5 audit #1390 round 4). The
      * {@link loadedInvoiceStatus} WeakMap is only populated when {@link initialize}
@@ -222,6 +260,7 @@ export declare class Invoice extends SmrtObject {
      * (the dynamic imports stay inside the package).
      */
     private recomputeAmountsForSave;
+    private recomputeAmountPaid;
     /**
      * Whether `amountPaid` covers `totalAmount`. This is the SINGLE source of
      * truth for the **PAID** decision — both {@link updatePaymentStatus} (which
@@ -311,6 +350,8 @@ export declare class Invoice extends SmrtObject {
      * Get remaining amount due
      */
     getAmountDue(): number;
+    /** Signed amount still owed after payments and issued credit notes. */
+    getBalance(): number;
     /**
      * Mark invoice as sent
      */
@@ -337,6 +378,8 @@ export declare class Invoice extends SmrtObject {
      * Cancel the invoice
      */
     cancel(): void;
+    /** Cancel a posted money-v2 invoice with an exact atomic journal reversal. */
+    cancelWithRevenueReversal(options: CancelRevenueOptions): Promise<Journal | null>;
     /**
      * Write off the invoice (bad debt)
      */
@@ -388,7 +431,8 @@ export declare class Invoice extends SmrtObject {
      * await invoice.save();
      * ```
      */
-    toAccountingInput(): Promise<AccountingInvoiceInput>;
+    toAccountingInput(options?: FrozenInvoiceAccountingOptions): Promise<AccountingInvoiceInput>;
+    private toAccountingInputLocked;
 }
 export default Invoice;
 //# sourceMappingURL=Invoice.d.ts.map

package/dist/models/Invoice.d.ts.map

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

package/dist/models/InvoiceLineItem.d.ts

@@ -3,8 +3,10 @@
  * @packageDocumentation
  */
 import { SmrtObject } from '@happyvertical/smrt-core';
+import type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';
+import { type DocumentMoneyReadRebindCapability, type DocumentMoneyWriteCapability } from '../document-money-internal.js';
 import { type InvoiceCalculationContext, type InvoiceLineDraft } from '../svelte/invoices/calculations.js';
-import type { AccountingLineItemInput, InvoiceLineEditorState, InvoiceLineItemOptions } from '../types/index.js';
+import type { AccountingLineItemInput, InvoiceCreditCalculationBasis, InvoiceLineEditorState, InvoiceLineItemOptions, InvoiceTaxComponentSnapshot } from '../types/index.js';
 /**
  * InvoiceLineItem represents a single line item on an invoice.
  *
@@ -27,6 +29,8 @@ import type { AccountingLineItemInput, InvoiceLineEditorState, InvoiceLineItemOp
  * ```
  */
 export declare class InvoiceLineItem extends SmrtObject {
+    /** @internal Collection read guard returns this snapshot on its root DB. */
+    rebindMoneyRead(capability: DocumentMoneyReadRebindCapability, db: DatabaseInterface): this;
     /**
      * Tenant ID for multi-tenant isolation
      * Nullable to support both tenant-scoped and global invoice line items
@@ -36,6 +40,10 @@ export declare class InvoiceLineItem extends SmrtObject {
      * Parent invoice
      */
     invoiceId: string;
+    creditedLineId: string | null;
+    creditCalculationBasisJson: string;
+    get creditCalculationBasis(): InvoiceCreditCalculationBasis | null;
+    set creditCalculationBasis(value: InvoiceCreditCalculationBasis | null);
     /**
      * Item description
      */
@@ -44,6 +52,7 @@ export declare class InvoiceLineItem extends SmrtObject {
      * SKU or item code
      */
     sku: string;
+    productId: string | null;
     /** Nonnegative decimal quantity (hours, weight, units), up to six fractional digits. */
     quantity: number;
     /** Raw editor modes retained only while they resolve to the authoritative model fields. */
@@ -53,7 +62,9 @@ export declare class InvoiceLineItem extends SmrtObject {
     /** Store only this model's editor state, preserving unrelated metadata. */
     set invoiceEditorState(value: InvoiceLineEditorState | null);
     /**
-     * Unit price before discount, in **integer minor units** (cents, satoshis).
+     * Unit price before discount, in **integer minor units** (cents, satoshis),
+     * in the document's pricing mode: tax-inclusive when its `lineAmountType`
+     * is `inclusive`.
      *
      * Money is exact, so it is stored as minor units and never as a float —
      * `$19.99` is `1999`. An integer literal is what maps this to an INTEGER
@@ -64,6 +75,8 @@ export declare class InvoiceLineItem extends SmrtObject {
      * Discount amount (flat, not percentage), in integer minor units (#2361).
      */
     discount: number;
+    discountType: 'none' | 'percent' | 'amount';
+    discountRate: string;
     /**
      * Tax rate as a decimal fraction (e.g., 0.05 for 5%).
      *
@@ -72,8 +85,27 @@ export declare class InvoiceLineItem extends SmrtObject {
      * truncate every rate to 0 (#2361).
      */
     taxRate: number;
-    /**
-     * Calculated line amount, in integer minor units (#2361).
+    taxMode: 'inherit' | 'override';
+    taxCodeId: string | null;
+    taxCodeCode: string | null;
+    taxCodeName: string | null;
+    taxComponentsJson: string | null;
+    get taxComponents(): InvoiceTaxComponentSnapshot[];
+    set taxComponents(value: InvoiceTaxComponentSnapshot[]);
+    /** Exact sum of frozen component taxes, in integer minor units. */
+    taxAmount: number;
+    /**
+     * @internal Pre-v2 line amount preserved only by the line-amount migration
+     * for rollback; not a user-facing amount, so it carries no money hint.
+     */
+    legacyAmount: number | null;
+    /** Stable document snapshot identity; ordinary lifecycle saves do not change it. */
+    moneySnapshotId: string;
+    /**
+     * Calculated line amount, in integer minor units (#2361). Under money v2 it
+     * is net of discount and before tax for `exclusive` / `none` documents, and
+     * tax-inclusive for `inclusive` ones; {@link taxAmount} holds the tax. A
+     * legacy-model tenant still stores qty * price - discount + tax.
      */
     amount: number;
     /**
@@ -96,7 +128,7 @@ export declare class InvoiceLineItem extends SmrtObject {
      * Revenue account ID (cross-package ref to smrt-ledgers)
      * Used for revenue recognition to specific accounts
      */
-    revenueAccountId: string;
+    revenueAccountId: string | null;
     /**
      * Sort order within the invoice
      */
@@ -114,6 +146,15 @@ export declare class InvoiceLineItem extends SmrtObject {
     getEditorDraft(authorizedContext: InvoiceCalculationContext): InvoiceLineDraft | null;
     /** Validate resolved fields and recompute amount before persistence; editor metadata never determines money. */
     save(): Promise<this>;
+    /** @internal Aggregate persistence only. */
+    saveDerived(capability: DocumentMoneyWriteCapability, legacy: boolean): Promise<this>;
+    delete(options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
+    /** @internal Aggregate persistence only. */
+    deleteDerived(capability: DocumentMoneyWriteCapability, options?: {
+        expectedUpdatedAt?: Date | string;
+    }): Promise<void>;
     /**
      * Check if line item has source tracking
      */