@happyvertical/smrt-commerce 0.57.2 → 0.57.4

package/agents/observed-purchase-prices.md

@@ -0,0 +1,37 @@
+# Incomplete observed purchase prices
+
+`recordPurchasePriceObservation` records a supplier quote or purchase-order source
+instrument when the source does not establish every monetary total. Each of
+`netMinor`, `taxMinor`, and `grossMinor` is an explicit safe nonnegative integer
+or `null`. Zero is a known value; null is unknown. At least one amount is known.
+The host explicitly interprets whether a source amount is net or gross. The
+command neither derives absent tax nor uses current tax rates.
+
+The public `PurchasePriceObservation` is separate from `Contract`. Its readback
+has `monetaryAggregate: null`, the complete original snapshot, and an optional
+completion link. It cannot appear in ordinary purchase tax reports or be
+accepted as a calculated Contract. Source `selected`, `approved`, or other
+status text remains original evidence and grants no current approval.
+
+Source identity is `(tenant, namespace, kind, sourceKey)`. Exact replay returns
+the original object. Changed evidence or request identity requires a new source
+revision; it cannot rewrite the original. Concrete source lines retain their
+keys and exact quantity/rate text, even when those texts do not explain the
+supplier's observed amount. They are evidence, not calculator inputs.
+
+`completePurchasePriceObservation` requires separate reviewed evidence and the
+existing complete `ReceivedPurchaseMoneyFacts` contract. It preserves every
+known original header amount and every fully known source-line total. When
+complete line detail is supplied, identities, descriptions, quantity/rate text,
+and known amounts must also match. Header-only completion does not allocate tax
+or invent source line amounts: the original lines remain in the observation.
+The command atomically creates a **draft** received SupplierQuote or
+PurchaseOrder and appends its link. The host separately authorizes any later
+acceptance. This is completion of unknown facts, not a negotiated price change.
+
+All commands require the matching active tenant. The host authorizes the human
+operation and supplies the owning executor. The tenant money barrier serializes
+recording/completion and participates in caller rollback. Ordinary model saves,
+collection creates, and deletes are rejected. No original journal or provider
+write is created. The existing received-purchase tax-classification requirements
+apply if a completed purchase order is subsequently accepted and reported.

package/agents/payment-allocations.md

@@ -62,3 +62,62 @@ For PARTIAL/PAID invoices it records the first `sentAt` while preserving payment
 status, paid amount, paid date and any existing view timestamp. Repeating this
 call preserves the first send timestamp. It records the caller's delivery
 event; it does not send a customer message or manufacture earlier delivery.
+
+
+## Original settlement dates (#4099)
+
+`Payment.recordPayment` and `recordRefund` accept optional `effectiveOn`, a strict
+real `YYYY-MM-DD` calendar date. Explicit dates set the posted journal and `paidAt`
+to noon UTC on that date; omission preserves current-clock ordinary posting.
+Customer-funds commands retain their reviewed date and reject a conflicting
+explicit override. Recording cash evidence does not initiate a provider transfer.
+Completed or refunded payment settlement dates and journal identities are immutable,
+including direct save; correcting evidence requires an explicit reversal workflow.
+Posting retains the caller transaction and rejects duplicate completion.
+
+Validation: shared payment-posting contracts and customer-funds proofs pass on
+SQLite and PostgreSQL (55 passed, one PostgreSQL-only case skipped in the SQLite
+lane). They cover leap-day settlement, malformed/impossible dates, immutable
+reloads, duplicate posting, rollback, concurrency and conflicting managed dates.
+Package typecheck/Svelte check (zero errors/warnings) and build pass. Initial
+failures retained in the MVP evidence identified the missing direct-save date
+freeze and an order-dependent journal assertion; both were corrected.
+
+## Allocation deletion versus retained-refund reservation (#4063 / PR #4101)
+
+Deletion claims the persisted Payment revision in its owning transaction before
+checking provider or customer-funds authority. It holds that revision through the
+allocation DELETE. A retained-refund reservation uses the same Payment revision
+claim when saving its binding, so a stale unbound parent read cannot authorize
+removal after the provider reservation commits. If deletion commits first, the
+provider reservation must fail its stale Payment claim before provider I/O.
+Ordinary deletion advances the Payment revision; reload held Payment instances
+before subsequent edits. Invoice status refresh remains caller-owned.
+
+The accepted review fix is high risk because concurrent deletion could remove
+settlement evidence already reserved by an external accounting operation. No API,
+schema, accounting mapping or bank execution contract changes.
+
+| Behavior / reachable trigger | Positive / negative case | Actor / executor / runtime | External edge / focused evidence |
+| --- | --- | --- | --- |
+| Direct allocation deletion | Ordinary unbound row deletes; failed outer transaction preserves row and parent revision | Active owning tenant; one caller transaction; SQLite and PostgreSQL | No bank I/O; dedicated allocation-delete suite |
+| Existing provider binding | Protected row remains and rejected delete rolls back parent revision; foreign tenant cannot delete | Owning versus foreign active tenant; transaction-bound parent claim; both dialects | Public retained-refund sync plus immutable binding readback |
+| Claimed deletion commits first | Provider reservation reaches its Payment revision claim, then fails without binding, refund reservation or provider I/O | Separate native PostgreSQL transactions; deterministic claim barriers | Public refund operation fails closed after its stale settlement evidence is removed |
+| Stale unbound parent read | Provider reservation commits while delete is paused, then stale delete fails and exact allocation remains | Separate native PostgreSQL transactions; deterministic read barrier | Real public provider saga with fake provider port; exact retry creates no extra provider operation |
+
+The PostgreSQL concurrency interleaving is intentionally not run on SQLite:
+SQLite serializes the owning write transaction instead of allowing PostgreSQL's
+stale-read interleaving. Shared mutation/rollback/tenant/binding cases run on both.
+The dedicated native test must fail against the pre-fix implementation before
+claiming regression coverage. External outcome recovery and malformed provider
+inputs are unchanged and covered by the retained-accounting suite; no new provider
+request shape is introduced here.
+
+Focused validation: the dedicated SQLite/PostgreSQL test file passes all four
+cases; both PostgreSQL races use real independent transactions and explicit
+method barriers, without sleeps or mocked database results. The stale deletion
+case fails against the unchanged base because deletion succeeds after provider
+reservation. Existing SQLite allocation-integrity and customer-funds suites also
+pass (19 cases), including the managed reversal caller. Scoped model/test
+TypeScript passes. Run the dedicated PostgreSQL proof with the standard managed
+`run-with-ci-postgres.mjs` wrapper; it creates and cleans its own database.

package/agents/received-sales-contract-money.md

@@ -0,0 +1,38 @@
+# Received sales agreement money
+
+`recordReceivedSalesContractMoney({ db, tenantId, contractId, requestId,
+evidenceRef, facts })` records explicitly supplied complete original monetary
+facts on an empty draft `Order` or `Agreement` with a same-tenant customer.
+It reuses the public complete received-money validator: safe nonnegative minor
+units, exact net plus tax equals gross, known zero distinct from unknown tax
+classification, and either header-only evidence or real complete source lines.
+No quantity, price, tax rate, line allocation or current tax policy is invented.
+Sales tax components must retain `recoverableMinor: null`; purchase recovery does
+not apply. Supplier quote lineage is not accepted on this command.
+
+`getReceivedSalesContractMoney(contract)` returns the immutable evidence or null.
+Sales-named facts, snapshot and input types are public. The snapshot shares the
+existing version-1 received-money representation and keeps `sourceQuote: null`.
+The legacy `receivedPurchaseMoneyJson` storage name remains for schema compatibility;
+applications must use commands rather than writing that field.
+
+The host authorizes the review and binds its immutable original source separately
+to this newly completed authority. Merely importing a source label such as signed
+or approved does not grant current acceptance. Normal acceptance freezes the
+complete money snapshot and permits the existing approved billing-schedule
+commands. Issued invoices remain separate actual financial instruments.
+
+Recording or accepting an agreement does not recognize revenue, create an AR or
+tax journal, or add incurred tax-report facts. Only the applicable invoice or
+purchase accounting authority contributes those facts. Incomplete original
+agreement totals remain host evidence until reviewed complete totals are supplied.
+
+The command uses the caller executor and active tenant, locks the parent, rejects
+calculated lines and frozen drafts, and preserves exact retry identity. Ordinary
+money mutations and deletion are guarded. Replays with changed evidence or facts
+require a separate contract revision. Competing requests cannot overwrite the
+first recorded authority; outer transaction rollback includes the entire record.
+
+The customer is frozen as soon as original money is recorded, including while
+the agreement or order is still a draft. Reassignment requires a new contract;
+acceptance and retry preserve the original customer and monetary evidence.

package/dist/accounting-snapshot.d.ts

@@ -1,12 +1,17 @@
 /** Pure projection of frozen commerce money snapshots into accounting SDK inputs. */
 import { type AccountingProvider, type CreditMemoInput, type InvoiceInput, type InvoiceLineItemInput, type SyncResult, type TaxComponentSnapshot } from '@happyvertical/accounting';
-import type { LineAmountType, TaxRoundingScope } from './money.js';
+import { type LineAmountType, type TaxRoundingScope } from './money.js';
 export type FrozenAccountingDocumentKind = 'invoice' | 'creditMemo';
 /** Realm-specific references are configuration, never inferred from a tax name or rate. */
 export interface FrozenQuickBooksTaxMapping {
     readonly lines: Readonly<Record<string, {
         readonly itemRef: string;
         readonly taxCodeRef: string;
+        /** Caller-verified configuration of the referenced realm TaxCode. */
+        readonly taxComponents?: readonly {
+            readonly taxRateRef: string;
+            readonly compound: boolean;
+        }[];
     }>>;
     readonly components: Readonly<Record<string, {
         readonly quickbooksTaxRateRef: string;
@@ -19,6 +24,8 @@ export interface FrozenAccountingTaxComponent {
     /** Exact percent text: `5` means 5 percent. */
     readonly percent: string;
     readonly taxMinor: number;
+    readonly compound?: boolean;
+    readonly taxableMinor?: number;
 }
 /** A frozen commerce line. `unitPriceMinor` and `discountMinor` are pre-discount document-mode values. */
 export interface FrozenAccountingLineSnapshot {

package/dist/accounting-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounting-snapshot.d.ts","sourceRoot":"","sources":["../src/accounting-snapshot.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAEzB,KAAK,UAAU,EACf,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpE,2FAA2F;AAC3F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CACtB,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAC1E,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAC3B,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC,CAC1D,CAAC;CACH;AAED,8FAA8F;AAC9F,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,0GAA0G;AAC1G,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACjE;AAED,iEAAiE;AACjE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,gDAAgD;IAChD,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAC/D,MAAM,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC1D,MAAM,MAAM,iCAAiC,GAAG,eAAe,CAAC;AAChE,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG,eAAe,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,aAAa,CAAC,EAC1D,QAAQ,EAAE,gCAAgC,EAC1C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CASrB;AAkKD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,gCAAgC,EAC1C,OAAO,EAAE,0BAA0B,GAClC,uBAAuB,CA8FzB"}
+{"version":3,"file":"accounting-snapshot.d.ts","sourceRoot":"","sources":["../src/accounting-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/allocation-integrity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allocation-integrity.d.ts","sourceRoot":"","sources":["../src/allocation-integrity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED,0FAA0F;AAC1F,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,OAAO,GAAG,OAAO,EACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAQR;AAED,4EAA4E;AAC5E,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,OAAO,GAAG,OAAO,EACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAyDf"}
+{"version":3,"file":"allocation-integrity.d.ts","sourceRoot":"","sources":["../src/allocation-integrity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEnE;AAED,0FAA0F;AAC1F,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,OAAO,GAAG,OAAO,EACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,EAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAQR;AAED,4EAA4E;AAC5E,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,OAAO,GAAG,OAAO,EACzB,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/billing/period-close.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"period-close.d.ts","sourceRoot":"","sources":["../../src/billing/period-close.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,WAAW,EAAE,IAAI,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,iDAAiD;IACjD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,OAAO,GACP,MAAM,GACN,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,yEAAyE;AACzE,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;gBAAzB,MAAM,EAAE,iBAAiB;CAW/C;AAmDD,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,GAAG,OAAa,GAAG,aAAa,CAQrE;AAkCD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,gBAAgB,GAAG,MAAM,CAAC,EACxD,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAsED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAwE5B"}
+{"version":3,"file":"period-close.d.ts","sourceRoot":"","sources":["../../src/billing/period-close.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,WAAW,EAAE,IAAI,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,iDAAiD;IACjD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,OAAO,GACP,MAAM,GACN,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,yEAAyE;AACzE,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;gBAAzB,MAAM,EAAE,iBAAiB;CAW/C;AAoDD,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,GAAG,OAAa,GAAG,aAAa,CAQrE;AAkCD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,gBAAgB,GAAG,MAAM,CAAC,EACxD,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAUjB;AAsED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAwE5B"}

package/dist/chunks/{ContractLineItemCollection-BZcrlrrY.js → ContractLineItemCollection-J4xtRtzE.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { MoneyValidationError } from "../money.js";
-import { a as assertCommerceMoneySchemaCurrent, f as DOCUMENT_MONEY_READ_REBIND, p as DOCUMENT_MONEY_WRITE } from "./detect-CY9ufaFb.js";
-import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-6TlqUeVj.js";
+import { a as assertCommerceMoneySchemaCurrent, f as DOCUMENT_MONEY_READ_REBIND, p as DOCUMENT_MONEY_WRITE } from "./detect-DAE-_NAk.js";
+import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-DoF6lR8h.js";
 import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, smrt } from "@happyvertical/smrt-core";
 import { TenantScoped, getTenantId, queryGlobal, queryWithGlobals, tenantId } from "@happyvertical/smrt-tenancy";
 //#region src/models/ContractLineItem.ts
@@ -110,13 +110,13 @@ var ContractLineItem = class extends SmrtObject {
 	async initialize() {
 		await super.initialize();
 		if (this.isPersisted) {
-			const { assertHydratedMoneyRowCurrent } = await import("./detect-CY9ufaFb.js").then((n) => n.c);
+			const { assertHydratedMoneyRowCurrent } = await import("./detect-DAE-_NAk.js").then((n) => n.c);
 			await assertHydratedMoneyRowCurrent(this);
 		}
 		return this;
 	}
 	async save() {
-		const { saveContractLineItem } = await import("./contract-money-EuToOghh.js");
+		const { saveContractLineItem } = await import("./contract-money-DSRTMoXm.js");
 		return await saveContractLineItem(this);
 	}
 	/** @internal Contract aggregate persistence only. */
@@ -126,7 +126,7 @@ var ContractLineItem = class extends SmrtObject {
 		return await super.save();
 	}
 	async delete(options = {}) {
-		const { deleteContractLineItem } = await import("./contract-money-EuToOghh.js");
+		const { deleteContractLineItem } = await import("./contract-money-DSRTMoXm.js");
 		await deleteContractLineItem(this, options);
 	}
 	/** @internal Contract aggregate persistence only. */
@@ -257,4 +257,4 @@ var ContractLineItemCollection = class extends SmrtCollection {
 //#endregion
 export { ContractLineItemCollection_exports as n, ContractLineItem as r, ContractLineItemCollection as t };
 
-//# sourceMappingURL=ContractLineItemCollection-BZcrlrrY.js.map
+//# sourceMappingURL=ContractLineItemCollection-J4xtRtzE.js.map

package/dist/chunks/{ContractLineItemCollection-BZcrlrrY.js.map → ContractLineItemCollection-J4xtRtzE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ContractLineItemCollection-BZcrlrrY.js","names":["field"],"sources":["../../src/models/ContractLineItem.ts","../../src/collections/ContractLineItemCollection.ts"],"sourcesContent":["/**\n * ContractLineItem model - individual items on a contract\n * @packageDocumentation\n */\n\nimport {\n  crossPackageRef,\n  field,\n  foreignKey,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  DOCUMENT_MONEY_READ_REBIND,\n  DOCUMENT_MONEY_WRITE,\n  type DocumentMoneyReadRebindCapability,\n  type DocumentMoneyWriteCapability,\n} from '../document-money-internal.js';\nimport { MoneyValidationError } from '../money.js';\nimport type {\n  ContractLineItemOptions,\n  ContractTaxComponentSnapshot,\n} from '../types/index.js';\n\n/**\n * ContractLineItem represents a single line item on a contract.\n *\n * Line items contain the details of what is being sold/purchased,\n * including quantity, pricing, and optional subscription details.\n *\n * @example\n * ```typescript\n * const lineItem = await lineItems.create({\n *   contractId: order.id,\n *   description: 'Widget Pro',\n *   quantity: 10,\n *   unitPrice: 4999, // $49.99 in cents\n *   taxRate: 0.08\n * });\n * ```\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableStrategy: 'sti',\n  api: { include: ['list', 'get', 'create', 'update', 'delete'] },\n  mcp: { include: ['list', 'get'] },\n  cli: { skipApiCheck: true },\n})\nexport class ContractLineItem extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  /** @internal Collection read guard returns this snapshot on its root DB. */\n  rebindMoneyRead(\n    capability: DocumentMoneyReadRebindCapability,\n    db: DatabaseInterface,\n  ): this {\n    if (capability !== DOCUMENT_MONEY_READ_REBIND)\n      throw new Error(\n        'Contract line read rebinding requires the owning capability',\n      );\n    this._db = db;\n    this.options.db = db;\n    return this;\n  }\n\n  /**\n   * Tenant ID for multi-tenant isolation\n   * Nullable to support both tenant-scoped and global line items\n   */\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  /**\n   * Parent contract\n   */\n  @field({ description: 'The order, quote or agreement this line belongs to.' })\n  @foreignKey('Contract', { role: 'items' })\n  contractId: string = '';\n\n  /**\n   * Item description\n   */\n  @field({ description: 'What is being sold or bought on this line.' })\n  description: string = '';\n\n  /**\n   * Quantity ordered. Decimal on purpose — contracts price fractional\n   * quantities (hours, weight, bandwidth), as do invoice line items.\n   */\n  @field({ description: 'How many.' })\n  quantity: number = 1.0;\n\n  /**\n   * Unit price before discount, in **integer minor units** (cents, satoshis),\n   * in the document's pricing mode: tax-inclusive when its `lineAmountType`\n   * is `inclusive`.\n   *\n   * The `= 0` initializer is load-bearing: SMRT maps an integer literal to\n   * INTEGER and a decimal literal to DECIMAL. Money is exact, so `$49.99` is\n   * `4999` (#2401).\n   */\n  @field({\n    description:\n      \"The price of one, before discount; includes tax when the document's prices include tax.\",\n    ui: { format: 'money' },\n  })\n  unitPrice: number = 0;\n\n  /**\n   * Discount amount (flat, not percentage), in integer minor units (#2401).\n   */\n  @field({ ui: { format: 'money' } })\n  discount: number = 0;\n\n  discountType: 'none' | 'percent' | 'amount' = 'none';\n\n  @field({ type: 'decimal' })\n  discountRate = '0.0';\n\n  /**\n   * Tax rate as decimal (e.g., 0.08 for 8%). A rate is inherently fractional,\n   * so it stays DECIMAL — INTEGER would truncate every meaningful value.\n   */\n  @field({\n    description:\n      'The stored fractional tax rate for this line (0.05 means 5%).',\n  })\n  taxRate: number = 0.0;\n\n  taxMode: 'inherit' | 'override' = 'inherit';\n\n  @foreignKey('TaxCode', { nullable: true })\n  taxCodeId: string | null = null;\n\n  taxCodeCode: string | null = null;\n\n  taxCodeName: string | null = null;\n\n  taxComponentsJson: string | null = null;\n\n  get taxComponents(): ContractTaxComponentSnapshot[] {\n    if (this.taxComponentsJson === null) return [];\n    try {\n      const value: unknown = JSON.parse(this.taxComponentsJson);\n      if (!Array.isArray(value)) return [];\n      return value.filter(\n        (entry): entry is ContractTaxComponentSnapshot =>\n          !!entry &&\n          typeof entry === 'object' &&\n          typeof (entry as ContractTaxComponentSnapshot).taxComponentId ===\n            'string' &&\n          typeof (entry as ContractTaxComponentSnapshot).name === 'string' &&\n          typeof (entry as ContractTaxComponentSnapshot).percent === 'string' &&\n          Number.isSafeInteger(\n            (entry as ContractTaxComponentSnapshot).taxMinor,\n          ),\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  set taxComponents(value: ContractTaxComponentSnapshot[]) {\n    this.taxComponentsJson = JSON.stringify(value);\n  }\n\n  /** Exact sum of frozen component taxes, in integer minor units. */\n  @field({ ui: { format: 'money' } })\n  taxAmount = 0;\n\n  /** Stable issue/freeze identity, independent of lifecycle updated_at. */\n  moneySnapshotId = '';\n\n  /**\n   * Line amount in integer minor units: net of discount and before tax for\n   * `exclusive` / `none` documents, and tax-inclusive for `inclusive` ones;\n   * {@link taxAmount} holds the tax. Derived by the Contract money aggregate\n   * on every save.\n   */\n  @field({\n    description:\n      \"The line amount: net of discount, and including tax only when the document's prices include tax.\",\n    ui: { format: 'money' },\n  })\n  amount: number = 0;\n\n  /**\n   * Optional product reference (cross-package, plain string)\n   */\n  @field({\n    description: 'The product this line is for, if it is one you list.',\n  })\n  @crossPackageRef('@happyvertical/smrt-products:Product')\n  productId: string = '';\n\n  /**\n   * SKU or item code\n   */\n  sku: string = '';\n\n  /**\n   * Start date (for lease/subscription items)\n   */\n  startDate: Date | null = null;\n\n  /**\n   * End date (for lease/subscription items)\n   */\n  endDate: Date | null = null;\n\n  /**\n   * Billing period (for subscriptions: 'monthly', 'yearly', etc.)\n   */\n  billingPeriod: string = '';\n\n  /**\n   * Sort order within the contract\n   */\n  sortOrder: number = 0;\n\n  constructor(options: ContractLineItemOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.contractId !== undefined) this.contractId = options.contractId;\n    if (options.description !== undefined)\n      this.description = options.description;\n    if (options.quantity !== undefined) this.quantity = options.quantity;\n    if (options.unitPrice !== undefined) this.unitPrice = options.unitPrice;\n    if (options.discount !== undefined) this.discount = options.discount;\n    if (options.discountType !== undefined)\n      this.discountType = options.discountType;\n    if (options.discountRate !== undefined)\n      this.discountRate = options.discountRate;\n    if (options.taxRate !== undefined) this.taxRate = options.taxRate;\n    if (options.taxMode !== undefined) this.taxMode = options.taxMode;\n    if (options.taxCodeId !== undefined) this.taxCodeId = options.taxCodeId;\n    if (options.taxCodeCode !== undefined)\n      this.taxCodeCode = options.taxCodeCode;\n    if (options.taxCodeName !== undefined)\n      this.taxCodeName = options.taxCodeName;\n    if (options.taxComponentsJson !== undefined)\n      this.taxComponentsJson = options.taxComponentsJson;\n    if (options.taxComponents !== undefined)\n      this.taxComponents = structuredClone(options.taxComponents);\n    if (options.taxAmount !== undefined) this.taxAmount = options.taxAmount;\n    if (options.moneySnapshotId !== undefined)\n      this.moneySnapshotId = options.moneySnapshotId;\n    if (options.amount !== undefined) this.amount = options.amount;\n    if (options.productId !== undefined) this.productId = options.productId;\n    if (options.sku !== undefined) this.sku = options.sku;\n    if (options.startDate !== undefined) this.startDate = options.startDate;\n    if (options.endDate !== undefined) this.endDate = options.endDate;\n    if (options.billingPeriod !== undefined)\n      this.billingPeriod = options.billingPeriod;\n    if (options.sortOrder !== undefined) this.sortOrder = options.sortOrder;\n  }\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    // A row read from the database must not be old-format money data.\n    if (this.isPersisted) {\n      const { assertHydratedMoneyRowCurrent } = await import(\n        '../upgrade/detect.js'\n      );\n      await assertHydratedMoneyRowCurrent(this);\n    }\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    const { saveContractLineItem } = await import('../contract-money.js');\n    return (await saveContractLineItem(this)) as this;\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async saveDerived(capability: DocumentMoneyWriteCapability): Promise<this> {\n    if (capability !== DOCUMENT_MONEY_WRITE)\n      throw new Error('Contract line money write capability is required');\n    // Money is integer minor units: refuse a major-unit price before it can\n    // reach the database (#2401), ahead of the aggregate recompute.\n    for (const [field, value] of [\n      ['unitPrice', this.unitPrice],\n      ['discount', this.discount],\n    ] as const)\n      if (!Number.isSafeInteger(value))\n        throw new MoneyValidationError(\n          'UNSAFE_MONEY',\n          `Contract line ${field} ${value} must be a safe integer number of minor units`,\n        );\n    return (await super.save()) as this;\n  }\n\n  override async delete(\n    options: { expectedUpdatedAt?: Date | string } = {},\n  ): Promise<void> {\n    const { deleteContractLineItem } = await import('../contract-money.js');\n    await deleteContractLineItem(this, options);\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async deleteDerived(\n    capability: DocumentMoneyWriteCapability,\n    options: { expectedUpdatedAt?: Date | string } = {},\n  ): Promise<void> {\n    if (capability !== DOCUMENT_MONEY_WRITE)\n      throw new Error('Contract line money write capability is required');\n    await super.delete(options);\n  }\n\n  /**\n   * Check if this is a subscription/recurring item\n   */\n  isRecurring(): boolean {\n    return !!this.billingPeriod && !!this.startDate;\n  }\n\n  /**\n   * Check if subscription is active\n   */\n  isSubscriptionActive(): boolean {\n    if (!this.isRecurring()) return false;\n    if (!this.startDate) return false;\n\n    const now = new Date();\n    if (now < this.startDate) return false;\n    if (this.endDate && now > this.endDate) return false;\n\n    return true;\n  }\n}\n\nexport default ContractLineItem;\n","/**\n * ContractLineItemCollection - Collection manager for ContractLineItem objects\n * @packageDocumentation\n */\n\nimport {\n  SmrtCollection,\n  type SmrtListOptions,\n  type SmrtObject,\n  type SmrtSelectedRow,\n  type SmrtSelectField,\n  type SmrtStiReadScope,\n  type SmrtWhereClause,\n} from '@happyvertical/smrt-core';\nimport {\n  getTenantId,\n  queryGlobal,\n  queryWithGlobals,\n} from '@happyvertical/smrt-tenancy';\nimport { DOCUMENT_MONEY_READ_REBIND } from '../document-money-internal.js';\nimport { ContractLineItem } from '../models/ContractLineItem.js';\nimport { withTenantMoneyCollectionRead } from '../tenant-money-barrier.js';\nimport { assertCommerceMoneySchemaCurrent } from '../upgrade/detect.js';\n\nexport class ContractLineItemCollection extends SmrtCollection<ContractLineItem> {\n  static readonly _itemClass = ContractLineItem;\n\n  private async withMoneyRead<T>(operation: () => Promise<T>): Promise<T> {\n    const rootDb = this.db;\n    const tenantId = getTenantId();\n    if (!tenantId) {\n      // Without a tenant, still refuse a database with old money storage.\n      await assertCommerceMoneySchemaCurrent(rootDb);\n      return operation();\n    }\n    const result = await withTenantMoneyCollectionRead(\n      rootDb,\n      tenantId,\n      (boundDb) => this.withDatabase(boundDb, operation),\n    );\n    if (result instanceof ContractLineItem)\n      result.rebindMoneyRead(DOCUMENT_MONEY_READ_REBIND, rootDb);\n    else if (Array.isArray(result))\n      for (const item of result)\n        if (item instanceof ContractLineItem)\n          item.rebindMoneyRead(DOCUMENT_MONEY_READ_REBIND, rootDb);\n    return result;\n  }\n\n  override async get(\n    filter: string | SmrtWhereClause<ContractLineItem>,\n    options: Parameters<SmrtCollection<ContractLineItem>['get']>[1] = {},\n  ): Promise<ContractLineItem | null> {\n    return this.withMoneyRead(() => super.get(filter, options));\n  }\n\n  override async list<\n    const Select extends readonly SmrtSelectField<ContractLineItem>[],\n  >(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select: Select;\n      include?: never;\n      stiScope: SmrtStiReadScope;\n    },\n  ): Promise<Record<string, unknown>[]>;\n  override async list<\n    const Select extends readonly SmrtSelectField<ContractLineItem>[],\n  >(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select: Select;\n      include?: never;\n      stiScope?: undefined;\n    },\n  ): Promise<SmrtSelectedRow<ContractLineItem, Select>[]>;\n  override async list(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select?: undefined;\n      stiScope: SmrtStiReadScope;\n    },\n  ): Promise<SmrtObject[]>;\n  override async list(options?: undefined): Promise<ContractLineItem[]>;\n  override async list(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select?: undefined;\n      stiScope?: undefined;\n    },\n  ): Promise<ContractLineItem[]>;\n  override async list(\n    options:\n      | (Omit<SmrtListOptions<ContractLineItem>, 'select'> & {\n          select?: undefined;\n        })\n      | undefined,\n  ): Promise<SmrtObject[]>;\n  override async list(\n    options: SmrtListOptions<ContractLineItem> | undefined,\n  ): Promise<SmrtObject[] | Record<string, unknown>[]>;\n  override async list(\n    options: SmrtListOptions<ContractLineItem> = {},\n  ): Promise<SmrtObject[] | Record<string, unknown>[]> {\n    return this.withMoneyRead(() => super.list(options));\n  }\n\n  /**\n   * Find contract line items by their parent contract.\n   *\n   * @param contractId - Contract ID\n   * @returns Array of contract line items, sorted by sortOrder\n   */\n  async findByContract(contractId: string): Promise<ContractLineItem[]> {\n    return await this.list({\n      where: { contractId },\n      orderBy: 'sortOrder ASC',\n    });\n  }\n\n  // ============================================================================\n  // Tenant Helper Methods\n  // ============================================================================\n\n  /**\n   * Find all contract line items belonging to a specific tenant\n   *\n   * @param tenantId - Tenant ID\n   * @returns Array of contract line items for the tenant\n   */\n  async findByTenant(tenantId: string): Promise<ContractLineItem[]> {\n    return this.list({ where: { tenantId } });\n  }\n\n  /**\n   * Find all global contract line items (not associated with any tenant).\n   *\n   * Routes through the shared tenant-global helper so it does not throw under\n   * an active tenant context (an explicit `tenant_id IS NULL` filter would be\n   * flagged as an isolation violation). (#1600)\n   *\n   * @returns Array of global contract line items\n   */\n  async findGlobal(): Promise<ContractLineItem[]> {\n    return queryGlobal<ContractLineItem>(this);\n  }\n\n  /**\n   * Find contract line items for a tenant including global line items.\n   *\n   * Fails closed if an active tenant context requests a different tenant's\n   * rows; the admin/system path keeps the cross-tenant capability. (#1600)\n   *\n   * @param tenantId - Tenant ID\n   * @returns Array of tenant-specific and global contract line items\n   */\n  async findWithGlobals(tenantId: string): Promise<ContractLineItem[]> {\n    return queryWithGlobals<ContractLineItem>(\n      this,\n      tenantId,\n      'ContractLineItem.findWithGlobals',\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ContractLineItemCollection-J4xtRtzE.js","names":["field"],"sources":["../../src/models/ContractLineItem.ts","../../src/collections/ContractLineItemCollection.ts"],"sourcesContent":["/**\n * ContractLineItem model - individual items on a contract\n * @packageDocumentation\n */\n\nimport {\n  crossPackageRef,\n  field,\n  foreignKey,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport type { DatabaseInterface } from '@happyvertical/smrt-core/migrations';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  DOCUMENT_MONEY_READ_REBIND,\n  DOCUMENT_MONEY_WRITE,\n  type DocumentMoneyReadRebindCapability,\n  type DocumentMoneyWriteCapability,\n} from '../document-money-internal.js';\nimport { MoneyValidationError } from '../money.js';\nimport type {\n  ContractLineItemOptions,\n  ContractTaxComponentSnapshot,\n} from '../types/index.js';\n\n/**\n * ContractLineItem represents a single line item on a contract.\n *\n * Line items contain the details of what is being sold/purchased,\n * including quantity, pricing, and optional subscription details.\n *\n * @example\n * ```typescript\n * const lineItem = await lineItems.create({\n *   contractId: order.id,\n *   description: 'Widget Pro',\n *   quantity: 10,\n *   unitPrice: 4999, // $49.99 in cents\n *   taxRate: 0.08\n * });\n * ```\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableStrategy: 'sti',\n  api: { include: ['list', 'get', 'create', 'update', 'delete'] },\n  mcp: { include: ['list', 'get'] },\n  cli: { skipApiCheck: true },\n})\nexport class ContractLineItem extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  /** @internal Collection read guard returns this snapshot on its root DB. */\n  rebindMoneyRead(\n    capability: DocumentMoneyReadRebindCapability,\n    db: DatabaseInterface,\n  ): this {\n    if (capability !== DOCUMENT_MONEY_READ_REBIND)\n      throw new Error(\n        'Contract line read rebinding requires the owning capability',\n      );\n    this._db = db;\n    this.options.db = db;\n    return this;\n  }\n\n  /**\n   * Tenant ID for multi-tenant isolation\n   * Nullable to support both tenant-scoped and global line items\n   */\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  /**\n   * Parent contract\n   */\n  @field({ description: 'The order, quote or agreement this line belongs to.' })\n  @foreignKey('Contract', { role: 'items' })\n  contractId: string = '';\n\n  /**\n   * Item description\n   */\n  @field({ description: 'What is being sold or bought on this line.' })\n  description: string = '';\n\n  /**\n   * Quantity ordered. Decimal on purpose — contracts price fractional\n   * quantities (hours, weight, bandwidth), as do invoice line items.\n   */\n  @field({ description: 'How many.' })\n  quantity: number = 1.0;\n\n  /**\n   * Unit price before discount, in **integer minor units** (cents, satoshis),\n   * in the document's pricing mode: tax-inclusive when its `lineAmountType`\n   * is `inclusive`.\n   *\n   * The `= 0` initializer is load-bearing: SMRT maps an integer literal to\n   * INTEGER and a decimal literal to DECIMAL. Money is exact, so `$49.99` is\n   * `4999` (#2401).\n   */\n  @field({\n    description:\n      \"The price of one, before discount; includes tax when the document's prices include tax.\",\n    ui: { format: 'money' },\n  })\n  unitPrice: number = 0;\n\n  /**\n   * Discount amount (flat, not percentage), in integer minor units (#2401).\n   */\n  @field({ ui: { format: 'money' } })\n  discount: number = 0;\n\n  discountType: 'none' | 'percent' | 'amount' = 'none';\n\n  @field({ type: 'decimal' })\n  discountRate = '0.0';\n\n  /**\n   * Tax rate as decimal (e.g., 0.08 for 8%). A rate is inherently fractional,\n   * so it stays DECIMAL — INTEGER would truncate every meaningful value.\n   */\n  @field({\n    description:\n      'The stored fractional tax rate for this line (0.05 means 5%).',\n  })\n  taxRate: number = 0.0;\n\n  taxMode: 'inherit' | 'override' = 'inherit';\n\n  @foreignKey('TaxCode', { nullable: true })\n  taxCodeId: string | null = null;\n\n  taxCodeCode: string | null = null;\n\n  taxCodeName: string | null = null;\n\n  taxComponentsJson: string | null = null;\n\n  get taxComponents(): ContractTaxComponentSnapshot[] {\n    if (this.taxComponentsJson === null) return [];\n    try {\n      const value: unknown = JSON.parse(this.taxComponentsJson);\n      if (!Array.isArray(value)) return [];\n      return value.filter(\n        (entry): entry is ContractTaxComponentSnapshot =>\n          !!entry &&\n          typeof entry === 'object' &&\n          typeof (entry as ContractTaxComponentSnapshot).taxComponentId ===\n            'string' &&\n          typeof (entry as ContractTaxComponentSnapshot).name === 'string' &&\n          typeof (entry as ContractTaxComponentSnapshot).percent === 'string' &&\n          Number.isSafeInteger(\n            (entry as ContractTaxComponentSnapshot).taxMinor,\n          ),\n      );\n    } catch {\n      return [];\n    }\n  }\n\n  set taxComponents(value: ContractTaxComponentSnapshot[]) {\n    this.taxComponentsJson = JSON.stringify(value);\n  }\n\n  /** Exact sum of frozen component taxes, in integer minor units. */\n  @field({ ui: { format: 'money' } })\n  taxAmount = 0;\n\n  /** Stable issue/freeze identity, independent of lifecycle updated_at. */\n  moneySnapshotId = '';\n\n  /**\n   * Line amount in integer minor units: net of discount and before tax for\n   * `exclusive` / `none` documents, and tax-inclusive for `inclusive` ones;\n   * {@link taxAmount} holds the tax. Derived by the Contract money aggregate\n   * on every save.\n   */\n  @field({\n    description:\n      \"The line amount: net of discount, and including tax only when the document's prices include tax.\",\n    ui: { format: 'money' },\n  })\n  amount: number = 0;\n\n  /**\n   * Optional product reference (cross-package, plain string)\n   */\n  @field({\n    description: 'The product this line is for, if it is one you list.',\n  })\n  @crossPackageRef('@happyvertical/smrt-products:Product')\n  productId: string = '';\n\n  /**\n   * SKU or item code\n   */\n  sku: string = '';\n\n  /**\n   * Start date (for lease/subscription items)\n   */\n  startDate: Date | null = null;\n\n  /**\n   * End date (for lease/subscription items)\n   */\n  endDate: Date | null = null;\n\n  /**\n   * Billing period (for subscriptions: 'monthly', 'yearly', etc.)\n   */\n  billingPeriod: string = '';\n\n  /**\n   * Sort order within the contract\n   */\n  sortOrder: number = 0;\n\n  constructor(options: ContractLineItemOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.contractId !== undefined) this.contractId = options.contractId;\n    if (options.description !== undefined)\n      this.description = options.description;\n    if (options.quantity !== undefined) this.quantity = options.quantity;\n    if (options.unitPrice !== undefined) this.unitPrice = options.unitPrice;\n    if (options.discount !== undefined) this.discount = options.discount;\n    if (options.discountType !== undefined)\n      this.discountType = options.discountType;\n    if (options.discountRate !== undefined)\n      this.discountRate = options.discountRate;\n    if (options.taxRate !== undefined) this.taxRate = options.taxRate;\n    if (options.taxMode !== undefined) this.taxMode = options.taxMode;\n    if (options.taxCodeId !== undefined) this.taxCodeId = options.taxCodeId;\n    if (options.taxCodeCode !== undefined)\n      this.taxCodeCode = options.taxCodeCode;\n    if (options.taxCodeName !== undefined)\n      this.taxCodeName = options.taxCodeName;\n    if (options.taxComponentsJson !== undefined)\n      this.taxComponentsJson = options.taxComponentsJson;\n    if (options.taxComponents !== undefined)\n      this.taxComponents = structuredClone(options.taxComponents);\n    if (options.taxAmount !== undefined) this.taxAmount = options.taxAmount;\n    if (options.moneySnapshotId !== undefined)\n      this.moneySnapshotId = options.moneySnapshotId;\n    if (options.amount !== undefined) this.amount = options.amount;\n    if (options.productId !== undefined) this.productId = options.productId;\n    if (options.sku !== undefined) this.sku = options.sku;\n    if (options.startDate !== undefined) this.startDate = options.startDate;\n    if (options.endDate !== undefined) this.endDate = options.endDate;\n    if (options.billingPeriod !== undefined)\n      this.billingPeriod = options.billingPeriod;\n    if (options.sortOrder !== undefined) this.sortOrder = options.sortOrder;\n  }\n\n  override async initialize(): Promise<this> {\n    await super.initialize();\n    // A row read from the database must not be old-format money data.\n    if (this.isPersisted) {\n      const { assertHydratedMoneyRowCurrent } = await import(\n        '../upgrade/detect.js'\n      );\n      await assertHydratedMoneyRowCurrent(this);\n    }\n    return this;\n  }\n\n  override async save(): Promise<this> {\n    const { saveContractLineItem } = await import('../contract-money.js');\n    return (await saveContractLineItem(this)) as this;\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async saveDerived(capability: DocumentMoneyWriteCapability): Promise<this> {\n    if (capability !== DOCUMENT_MONEY_WRITE)\n      throw new Error('Contract line money write capability is required');\n    // Money is integer minor units: refuse a major-unit price before it can\n    // reach the database (#2401), ahead of the aggregate recompute.\n    for (const [field, value] of [\n      ['unitPrice', this.unitPrice],\n      ['discount', this.discount],\n    ] as const)\n      if (!Number.isSafeInteger(value))\n        throw new MoneyValidationError(\n          'UNSAFE_MONEY',\n          `Contract line ${field} ${value} must be a safe integer number of minor units`,\n        );\n    return (await super.save()) as this;\n  }\n\n  override async delete(\n    options: { expectedUpdatedAt?: Date | string } = {},\n  ): Promise<void> {\n    const { deleteContractLineItem } = await import('../contract-money.js');\n    await deleteContractLineItem(this, options);\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async deleteDerived(\n    capability: DocumentMoneyWriteCapability,\n    options: { expectedUpdatedAt?: Date | string } = {},\n  ): Promise<void> {\n    if (capability !== DOCUMENT_MONEY_WRITE)\n      throw new Error('Contract line money write capability is required');\n    await super.delete(options);\n  }\n\n  /**\n   * Check if this is a subscription/recurring item\n   */\n  isRecurring(): boolean {\n    return !!this.billingPeriod && !!this.startDate;\n  }\n\n  /**\n   * Check if subscription is active\n   */\n  isSubscriptionActive(): boolean {\n    if (!this.isRecurring()) return false;\n    if (!this.startDate) return false;\n\n    const now = new Date();\n    if (now < this.startDate) return false;\n    if (this.endDate && now > this.endDate) return false;\n\n    return true;\n  }\n}\n\nexport default ContractLineItem;\n","/**\n * ContractLineItemCollection - Collection manager for ContractLineItem objects\n * @packageDocumentation\n */\n\nimport {\n  SmrtCollection,\n  type SmrtListOptions,\n  type SmrtObject,\n  type SmrtSelectedRow,\n  type SmrtSelectField,\n  type SmrtStiReadScope,\n  type SmrtWhereClause,\n} from '@happyvertical/smrt-core';\nimport {\n  getTenantId,\n  queryGlobal,\n  queryWithGlobals,\n} from '@happyvertical/smrt-tenancy';\nimport { DOCUMENT_MONEY_READ_REBIND } from '../document-money-internal.js';\nimport { ContractLineItem } from '../models/ContractLineItem.js';\nimport { withTenantMoneyCollectionRead } from '../tenant-money-barrier.js';\nimport { assertCommerceMoneySchemaCurrent } from '../upgrade/detect.js';\n\nexport class ContractLineItemCollection extends SmrtCollection<ContractLineItem> {\n  static readonly _itemClass = ContractLineItem;\n\n  private async withMoneyRead<T>(operation: () => Promise<T>): Promise<T> {\n    const rootDb = this.db;\n    const tenantId = getTenantId();\n    if (!tenantId) {\n      // Without a tenant, still refuse a database with old money storage.\n      await assertCommerceMoneySchemaCurrent(rootDb);\n      return operation();\n    }\n    const result = await withTenantMoneyCollectionRead(\n      rootDb,\n      tenantId,\n      (boundDb) => this.withDatabase(boundDb, operation),\n    );\n    if (result instanceof ContractLineItem)\n      result.rebindMoneyRead(DOCUMENT_MONEY_READ_REBIND, rootDb);\n    else if (Array.isArray(result))\n      for (const item of result)\n        if (item instanceof ContractLineItem)\n          item.rebindMoneyRead(DOCUMENT_MONEY_READ_REBIND, rootDb);\n    return result;\n  }\n\n  override async get(\n    filter: string | SmrtWhereClause<ContractLineItem>,\n    options: Parameters<SmrtCollection<ContractLineItem>['get']>[1] = {},\n  ): Promise<ContractLineItem | null> {\n    return this.withMoneyRead(() => super.get(filter, options));\n  }\n\n  override async list<\n    const Select extends readonly SmrtSelectField<ContractLineItem>[],\n  >(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select: Select;\n      include?: never;\n      stiScope: SmrtStiReadScope;\n    },\n  ): Promise<Record<string, unknown>[]>;\n  override async list<\n    const Select extends readonly SmrtSelectField<ContractLineItem>[],\n  >(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select: Select;\n      include?: never;\n      stiScope?: undefined;\n    },\n  ): Promise<SmrtSelectedRow<ContractLineItem, Select>[]>;\n  override async list(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select?: undefined;\n      stiScope: SmrtStiReadScope;\n    },\n  ): Promise<SmrtObject[]>;\n  override async list(options?: undefined): Promise<ContractLineItem[]>;\n  override async list(\n    options: Omit<SmrtListOptions<ContractLineItem>, 'select' | 'stiScope'> & {\n      select?: undefined;\n      stiScope?: undefined;\n    },\n  ): Promise<ContractLineItem[]>;\n  override async list(\n    options:\n      | (Omit<SmrtListOptions<ContractLineItem>, 'select'> & {\n          select?: undefined;\n        })\n      | undefined,\n  ): Promise<SmrtObject[]>;\n  override async list(\n    options: SmrtListOptions<ContractLineItem> | undefined,\n  ): Promise<SmrtObject[] | Record<string, unknown>[]>;\n  override async list(\n    options: SmrtListOptions<ContractLineItem> = {},\n  ): Promise<SmrtObject[] | Record<string, unknown>[]> {\n    return this.withMoneyRead(() => super.list(options));\n  }\n\n  /**\n   * Find contract line items by their parent contract.\n   *\n   * @param contractId - Contract ID\n   * @returns Array of contract line items, sorted by sortOrder\n   */\n  async findByContract(contractId: string): Promise<ContractLineItem[]> {\n    return await this.list({\n      where: { contractId },\n      orderBy: 'sortOrder ASC',\n    });\n  }\n\n  // ============================================================================\n  // Tenant Helper Methods\n  // ============================================================================\n\n  /**\n   * Find all contract line items belonging to a specific tenant\n   *\n   * @param tenantId - Tenant ID\n   * @returns Array of contract line items for the tenant\n   */\n  async findByTenant(tenantId: string): Promise<ContractLineItem[]> {\n    return this.list({ where: { tenantId } });\n  }\n\n  /**\n   * Find all global contract line items (not associated with any tenant).\n   *\n   * Routes through the shared tenant-global helper so it does not throw under\n   * an active tenant context (an explicit `tenant_id IS NULL` filter would be\n   * flagged as an isolation violation). (#1600)\n   *\n   * @returns Array of global contract line items\n   */\n  async findGlobal(): Promise<ContractLineItem[]> {\n    return queryGlobal<ContractLineItem>(this);\n  }\n\n  /**\n   * Find contract line items for a tenant including global line items.\n   *\n   * Fails closed if an active tenant context requests a different tenant's\n   * rows; the admin/system path keeps the cross-tenant capability. (#1600)\n   *\n   * @param tenantId - Tenant ID\n   * @returns Array of tenant-specific and global contract line items\n   */\n  async findWithGlobals(tenantId: string): Promise<ContractLineItem[]> {\n    return queryWithGlobals<ContractLineItem>(\n      this,\n      tenantId,\n      'ContractLineItem.findWithGlobals',\n    );\n  }\n}\n"],"mappings":"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"}