@happyvertical/smrt-commerce 0.58.0 → 0.59.0

package/agents/accounting-snapshot-mapper.md

@@ -120,3 +120,6 @@ public accounting SDK without changing statutory percentages or declared taxes.
 Missing/mismatched configuration fails explicitly. Hosts own tenant-scoped review
 and provenance of the existing realm code's applicability/order; a taxCodeRef
 string alone is insufficient evidence. Use the SDK release containing sdk#1412.
+
+The [QuickBooks invoice pilot](quickbooks-pilot.md) uses the same persisted
+reservation and request descriptor for accepted quote obligations.

package/agents/quickbooks-pilot.md

@@ -0,0 +1,56 @@
+# QuickBooks invoice pilot (#4621)
+
+The pilot is disabled by default. The trusted server host explicitly calls
+`runQuickBooksPilot` with a sandbox-scoped deterministic fixture. Commerce
+accepts no credentials or production mappings at this entry point. The
+existing generic accounting APIs and manual QuickBooks invoicing remain
+separate entry points.
+
+1. The host records operator approval and customer acceptance of the exact
+   quote version, including lines, discounts, tax, rounding and due terms.
+   Prepare the issued Commerce invoice at
+   `quickBooksPilotInvoiceId(tenantId, obligationId)` and associate the
+   accepted version with its frozen `moneySnapshotId`. The host is responsible
+   for proving authorization and the accepted quote-to-invoice correspondence.
+   A quote revision does not create another obligation ID.
+2. Pass that acceptance, the reviewed QuickBooks customer, Item and tax
+   mapping, and a fixture scoped to the active tenant, realm and sandbox.
+   `issue` reserves one frozen accounting create and verifies provider identity,
+   currency, subtotal, discount, tax, total and due date before saving the
+   binding. Exact money checks use integer minor units.
+3. An authorized operator can use `link` with the ID of an already-issued
+   QuickBooks invoice. The operator reviews the link against the accepted
+   version, then Commerce verifies readback and records the same durable
+   binding. A subsequent `issue` reads the bound invoice. An unresolved create
+   requires `recover`, which accepts only a verified match for its persisted
+   request ID and payload hash. Interrupted owners must first be stopped.
+   Missing or ambiguous evidence leaves the original reservation in place.
+4. Call `poll` to reconcile current invoice and complete linked transaction
+   evidence. The fixture supplies the exact amount attributable to this
+   invoice for each payment, credit application and refund. The result exposes
+   those separate amounts alongside balance and void status. A balance of zero
+   alone cannot prove payment. Inconsistent or incomplete readback throws and
+   preserves the last successful projection. Read that projection and its
+   observation time using `readFrozenAccountingSyncState`. Poll triggers carry
+   no settlement data, so duplicate or out-of-order triggers read current
+   evidence each time. The pilot projection is for reporting and does not post
+   local accounting payments or mutate booking status.
+
+The fixture reads during manual linking, recovery and polling run under the
+same tenant and invoice locks as binding. Any later network implementation
+needs a separately reviewed transport and concurrency policy.
+
+## Provider capability matrix
+
+| Capability | Primary evidence | Pilot disposition |
+| --- | --- | --- |
+| Canadian invoice payment | [Intuit Canada invoice payment](https://quickbooks.intuit.com/learn-support/en-ca/help-article/invoicing/take-process-payments-quickbooks-online/L2vHwwVmh_CA_en_CA) describes card, Apple Pay and bank payment. [Intuit Canada settings](https://quickbooks.intuit.com/learn-support/en-ca/help-article/invoicing/troubleshooting-canada-merchant-services-issues/L9jwTHfgx_CA_en_CA) describes merchant configuration and online delivery. | Merchant activation, methods, company region and payable delivery require authorized account evidence. |
+| Invoice create and duplicate request | [Intuit error 600](https://static.developer.intuit.com/output_html/qbo/docs/develop/troubleshooting/error-codes.html) documents duplicate request IDs. The installed public accounting SDK prepares a payload hash and forwards the request ID. | Fixture verifies create and ambiguous recovery. A stable API lookup by request ID and hash is unverified. Customer, amount and time are investigation clues only. |
+| Invoice options, hosted link and email | [Intuit invoice reference](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/invoice) and [Intuit Canada hosted invoice](https://quickbooks.intuit.com/learn-support/en-ca/help-article/invoicing/pay-invoice-using-bank-payments/L8T7x9nDA_CA_en_CA). The installed SDK exposes invoice send. | The pilot does not call send. Prove that the company can issue a payable invoice before enabling email. SDK support for setting online payment flags or retrieving a hosted link is unverified. |
+| Invoice and linked money | [Intuit Payment reference](https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/payment) and [Intuit V3 LinkedTxn schema](https://static.developer.intuit.com/sdkdocs/qbv3doc/ippphpdevkitv3/entities/files/IPPLinkedTxn.html). The installed public accounting SDK exposes invoice pull, invoice void, payments and credit operations. | Exact payment allocation, applied credits, attributed refunds and void readback are fixture evidence. Verify how the pilot company exposes the original invoice amounts after void and invoice attribution for refunds. Zero balance alone is insufficient. |
+| Webhooks | [Intuit event configuration](https://static.developer.intuit.com/output_html/qbo/docs/develop/webhooks/configure-webhooks.html) and [ordering and delivery guidance](https://static.developer.intuit.com/output_html/qbo/docs/develop/webhooks/best-practices.html) describe company-scoped notifications, separate environment setup and missed or out-of-order delivery. | Polling is the baseline. A future verified notification can trigger a poll after routing by tenant, company and environment. |
+| Sandbox credentials | [Intuit sandbox FAQs](https://static.developer.intuit.com/output_html/qbo/docs/develop/sandboxes/sandbox-faqs.html) require development credentials for sandbox and distinguish production credentials. | Deterministic fixtures only. No account or credential access, network requests, customer email, charges, voids or credits were used for validation. |
+
+No SDK change is part of this pilot. Production remains gated on authorized
+company verification, supported payment methods, payable delivery, exact
+readback and reviewed business policies.

package/dist/chunks/{ContractLineItemCollection-D74LbDOI.js → ContractLineItemCollection-BFWJ2e6a.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-DAE-_NAk.js";
-import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-j1m0r6pe.js";
+import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-BbbInDGP.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
@@ -116,7 +116,7 @@ var ContractLineItem = class extends SmrtObject {
 		return this;
 	}
 	async save(options) {
-		const { saveContractLineItem } = await import("./contract-money-BxvY2Kcp.js");
+		const { saveContractLineItem } = await import("./contract-money-By1XIzp_.js");
 		return await saveContractLineItem(this, options);
 	}
 	/** @internal Contract aggregate persistence only. */
@@ -126,7 +126,7 @@ var ContractLineItem = class extends SmrtObject {
 		return await super.save(options);
 	}
 	async delete(options = {}) {
-		const { deleteContractLineItem } = await import("./contract-money-BxvY2Kcp.js");
+		const { deleteContractLineItem } = await import("./contract-money-By1XIzp_.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-D74LbDOI.js.map
+//# sourceMappingURL=ContractLineItemCollection-BFWJ2e6a.js.map

package/dist/chunks/{ContractLineItemCollection-D74LbDOI.js.map → ContractLineItemCollection-BFWJ2e6a.js.map}

@@ -1 +1 @@
-{"version":3,"file":"ContractLineItemCollection-D74LbDOI.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  type SmrtSaveOptions,\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(options?: SmrtSaveOptions): Promise<this> {\n    const { saveContractLineItem } = await import('../contract-money.js');\n    return (await saveContractLineItem(this, options)) as this;\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async saveDerived(\n    capability: DocumentMoneyWriteCapability,\n    options?: SmrtSaveOptions,\n  ): 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(options)) 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-BFWJ2e6a.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  type SmrtSaveOptions,\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(options?: SmrtSaveOptions): Promise<this> {\n    const { saveContractLineItem } = await import('../contract-money.js');\n    return (await saveContractLineItem(this, options)) as this;\n  }\n\n  /** @internal Contract aggregate persistence only. */\n  async saveDerived(\n    capability: DocumentMoneyWriteCapability,\n    options?: SmrtSaveOptions,\n  ): 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(options)) 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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"}

package/dist/chunks/{DocumentTaxCollection-BmKyJGZi.js → DocumentTaxCollection-MFfprLH-.js}

@@ -4,11 +4,11 @@ import { MoneyValidationError, assertIntegerMinorUnits, calculateMoneyDocument,
 import { n as withHistoricalCommerceWrite, t as assertHistoricalCommerceWrite } from "./historical-commerce-internal-C9ButfuH.js";
 import { t as allocateFrozenCredit } from "./credit-allocation-yspz0Lab.js";
 import { _ as withDocumentMoneyTransaction, a as assertCommerceMoneySchemaCurrent, f as DOCUMENT_MONEY_READ_REBIND, g as withDocumentMoneyObjectTransaction, h as lockDocumentMoneyParents, p as DOCUMENT_MONEY_WRITE } from "./detect-DAE-_NAk.js";
-import { s as parseInvoiceRetention, t as InvoiceCollection } from "./InvoiceCollection-BPEzXaKm.js";
-import { n as withTenantMoneyCollectionRead, r as withTenantMoneyRuntime, t as lockTenantMoneyRuntime } from "./tenant-money-barrier-j1m0r6pe.js";
-import { t as TaxCodeCollection } from "./TaxCodeCollection-DpQeIqP4.js";
-import { t as ContractLineItemCollection } from "./ContractLineItemCollection-D74LbDOI.js";
-import { t as TaxComponentCollection } from "./TaxComponentCollection-wFGWOaxy.js";
+import { s as parseInvoiceRetention, t as InvoiceCollection } from "./InvoiceCollection-D_8NXuaw.js";
+import { n as withTenantMoneyCollectionRead, r as withTenantMoneyRuntime, t as lockTenantMoneyRuntime } from "./tenant-money-barrier-BbbInDGP.js";
+import { t as TaxCodeCollection } from "./TaxCodeCollection-Bc-Z8alx.js";
+import { t as ContractLineItemCollection } from "./ContractLineItemCollection-BFWJ2e6a.js";
+import { t as TaxComponentCollection } from "./TaxComponentCollection-DUY7A2sU.js";
 import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, smrt } from "@happyvertical/smrt-core";
 import { TenantScoped, getTenantId, queryGlobal, queryWithGlobals, tenantId, withTenant } from "@happyvertical/smrt-tenancy";
 import { ISO_4217_MINOR_UNITS } from "@happyvertical/smrt-ui/currency";
@@ -1226,7 +1226,7 @@ var Contract = class extends SmrtObject {
 	* Calculate and update totals from line items
 	*/
 	async recalculateTotals() {
-		const { recalculateContractTotals } = await import("./contract-money-BxvY2Kcp.js");
+		const { recalculateContractTotals } = await import("./contract-money-By1XIzp_.js");
 		await recalculateContractTotals(this);
 	}
 	/**
@@ -1257,12 +1257,12 @@ var Contract = class extends SmrtObject {
 	* write surface (#2401).
 	*/
 	async save(options) {
-		const { saveContract } = await import("./contract-money-BxvY2Kcp.js");
+		const { saveContract } = await import("./contract-money-By1XIzp_.js");
 		return await saveContract(this, options);
 	}
 	/** Received purchase monetary history cannot be deleted. */
 	async delete(options = {}) {
-		const { deleteContract } = await import("./contract-money-BxvY2Kcp.js");
+		const { deleteContract } = await import("./contract-money-By1XIzp_.js");
 		await deleteContract(this, options);
 	}
 	/** @internal Contract aggregate persistence only. */
@@ -4399,4 +4399,4 @@ var DocumentTaxCollection = class extends SmrtCollection {
 //#endregion
 export { DEFAULT_PARTY_CONTACT_FIELD_NAMES as $, PurchaseContractCollection as A, PurchaseOrder as B, refreshIssuedCreditBalance as C, issueContractMilestoneInvoice as D, getContractBillingSchedule as E, Lease as F, isContractSnapshotReportEligible as G, SupplierQuote as H, LicenseSale as I, HistoricalSalesLine as J, Vendor as K, Order as L, Cart as M, Contract as N, ContractCollection as O, Estimate as P, Customer as Q, ProductionOrder as R, previewInvoiceMoney as S, approveContractBillingSchedule as T, WholesaleOrder as U, SalesContract as V, classifyContractPurchase as W, InvoiceLineItem as X, InvoiceLineItemCollection as Y, CustomerCollection as Z, historicalText as _, getReceivedSalesContractMoney as a, normalizePartyContacts as at, getInvoiceMoneyFacts as b, validateReceivedPurchaseMoneyFacts as c, validatePartyContactRows as ct, HistoricalSalesTaxClassificationRequired as d, PARTY_CONTACT_MAX_LENGTHS as et, listHistoricalSalesHeaderFacts as f, historicalCalendarDate as g, recordHistoricalSalesMoney as h, getReceivedPurchaseMoney as i, applyPartyContactIntent as it, Agreement as j, SalesContractCollection as k, VendorCollection as l, readHistoricalSalesLines as m, DocumentTaxCollection_exports as n, PartyContactPayloadError as nt, recordReceivedPurchaseMoney as o, readPartyContactRows as ot, getHistoricalSalesMoney as p, HistoricalSalesLineCollection as q, ReceivedPurchaseTaxClassificationRequired as r, PartyContactValidationError as rt, recordReceivedSalesContractMoney as s, savePartyContacts as st, DocumentTaxCollection as t, PartyContactPartyNotFoundError as tt, DocumentTax as u, validateHistoricalSalesMoneyFacts as v, allocateContractMilestones as w, lockAndReloadInvoice as x, document_money_exports as y, PurchaseContract as z };
 
-//# sourceMappingURL=DocumentTaxCollection-BmKyJGZi.js.map
+//# sourceMappingURL=DocumentTaxCollection-MFfprLH-.js.map