@happyvertical/smrt-commerce 0.57.36 → 0.57.38

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-commerce",
-  "packageVersion": "0.57.36",
+  "packageVersion": "0.57.38",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "e9f5370f992d2d14cf7665d3f2274a8714062eff1f5054f7896712eaabdd9f6c",
-    "packageJson": "a1f8f8493682fbcdb8a2566ec3609327dc7e3415ab8f95495a513ec97909ac86",
+    "manifest": "37c07eca3483836a81c2a3ec782216efd083b51a05915594ac27c08e86047a8a",
+    "packageJson": "c5c5f2be98ceecc28cd9ef5f4ec00935f7b2f87993caa8a53d42c98effd3bf0d",
     "agents": "8fae989030badeabdb15109fab804aa7910c01570d449046c24a04678fe432a7",
     "moduleDoc:agents/customer-vendor-ui.md": "2b22e519411a16d8c493496fc168da77b9acd25f6077ea8fbac00cfee3a3501c",
     "moduleDoc:README.md": "beb2fada61d0babc7aa0528b883a9d47d6c827d876ace1cce04a908338fa01f8",
@@ -3868,13 +3868,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -4383,13 +4387,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -4805,13 +4813,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -5226,13 +5238,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -5735,13 +5751,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -6244,13 +6264,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -6753,13 +6777,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -7262,13 +7290,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -7785,13 +7817,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -8294,13 +8330,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -8816,13 +8856,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -9326,13 +9370,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -9936,13 +9984,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -10452,13 +10504,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -11103,13 +11159,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "_options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -11340,6 +11400,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],
@@ -11600,6 +11663,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],
@@ -12809,13 +12875,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         },
@@ -13495,13 +13565,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveDerived",
           "async": true,
           "params": [
-            "capability: DocumentMoneyWriteCapability"
+            "capability: DocumentMoneyWriteCapability",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -14003,6 +14077,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
@@ -14331,6 +14408,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],
@@ -14972,6 +15052,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
@@ -15478,6 +15561,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
@@ -15678,13 +15764,17 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "_options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         },
         {
           "name": "saveObserved",
           "async": true,
           "params": [
-            "capability: any"
+            "capability: any",
+            "options?: SmrtSaveOptions"
           ],
           "returns": "Promise<this>"
         }
@@ -15798,6 +15888,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],
@@ -15978,6 +16071,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],
@@ -16167,6 +16263,9 @@
         {
           "name": "save",
           "async": true,
+          "params": [
+            "options?: SmrtSaveOptions"
+          ],
           "returns": "Promise<this>"
         }
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-commerce",
-  "version": "0.57.36",
+  "version": "0.57.38",
   "smrtJsdoc": "strict",
   "description": "Commerce models for the SMRT framework - contracts, fulfillments, payments",
   "type": "module",
@@ -63,20 +63,20 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/accounting": "^0.109.0",
-    "@happyvertical/payments": "^0.109.0",
-    "@happyvertical/smrt-agents": "0.57.36",
-    "@happyvertical/smrt-core": "0.57.36",
-    "@happyvertical/smrt-jobs": "0.57.36",
-    "@happyvertical/smrt-ledgers": "0.57.36",
-    "@happyvertical/smrt-products": "0.57.36",
-    "@happyvertical/smrt-reports": "0.57.36",
-    "@happyvertical/smrt-subscriptions": "0.57.36",
-    "@happyvertical/smrt-svelte": "0.57.36",
-    "@happyvertical/smrt-tenancy": "0.57.36",
-    "@happyvertical/smrt-types": "0.57.36",
-    "@happyvertical/smrt-ui": "0.57.36",
-    "@happyvertical/sql": "^0.109.0"
+    "@happyvertical/accounting": "^0.110.0",
+    "@happyvertical/payments": "^0.110.0",
+    "@happyvertical/smrt-agents": "0.57.38",
+    "@happyvertical/smrt-core": "0.57.38",
+    "@happyvertical/smrt-jobs": "0.57.38",
+    "@happyvertical/smrt-ledgers": "0.57.38",
+    "@happyvertical/smrt-products": "0.57.38",
+    "@happyvertical/smrt-reports": "0.57.38",
+    "@happyvertical/smrt-subscriptions": "0.57.38",
+    "@happyvertical/smrt-svelte": "0.57.38",
+    "@happyvertical/smrt-tenancy": "0.57.38",
+    "@happyvertical/smrt-types": "0.57.38",
+    "@happyvertical/smrt-ui": "0.57.38",
+    "@happyvertical/sql": "^0.110.0"
   },
   "peerDependencies": {
     "svelte": "^5.57.0"
@@ -87,7 +87,7 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.57.36",
+    "@happyvertical/smrt-vitest": "0.57.38",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@testing-library/jest-dom": "^7.0.1",

package/dist/chunks/ContractLineItemCollection-DKcR46vL.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContractLineItemCollection-DKcR46vL.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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"}