@happyvertical/smrt-expenses 0.55.13 → 0.55.15

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Shared vocabulary, option shapes, and errors for smrt-expenses.\n *\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\nimport type { ExpenseReceipt } from './models/ExpenseReceipt.js';\n\n/**\n * Review state of an expense. Only `reviewed` expenses count toward a\n * commitment's drawdown or a cost roll-up of reviewed actuals.\n *\n * - `unreviewed` — recorded, not yet looked at (every expense starts here).\n * - `reviewed` — a reviewer accepted it as a real cost.\n * - `rejected` — a reviewer refused it (including as a duplicate).\n */\nexport type ExpenseReviewStatus = 'unreviewed' | 'reviewed' | 'rejected';\n\n/** Every {@link ExpenseReviewStatus}, in lifecycle order. */\nexport const EXPENSE_REVIEW_STATUSES: readonly ExpenseReviewStatus[] =\n  Object.freeze(['unreviewed', 'reviewed', 'rejected']);\n\n/**\n * Who paid for an expense: the `company` (card, account, vendor terms) or a\n * named `person` out of pocket, who may then be owed a reimbursement.\n */\nexport type ExpensePayer = 'company' | 'person';\n\n/** Every {@link ExpensePayer}. */\nexport const EXPENSE_PAYERS: readonly ExpensePayer[] = Object.freeze([\n  'company',\n  'person',\n]);\n\n/**\n * Suggested expense categories. `Expense.category` is an open string so a\n * vertical can add its own; these cover teamworks-os `JobExpense`\n * (`material | consumable | outside-service | freight | other`) plus the\n * common additions `equipment` and `travel`.\n */\nexport const SUGGESTED_EXPENSE_CATEGORIES: readonly string[] = Object.freeze([\n  'material',\n  'consumable',\n  'outside-service',\n  'freight',\n  'equipment',\n  'travel',\n  'other',\n]);\n\n/** Constructor options for {@link Expense}. */\nexport interface ExpenseOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  costObjectType?: string;\n  costObjectId?: string;\n  category?: string;\n  description?: string;\n  amount?: number;\n  currency?: string;\n  incurredOn?: string;\n  recordedAt?: Date | null;\n  recordedByProfileId?: string | null;\n  paidBy?: ExpensePayer;\n  paidByProfileId?: string | null;\n  vendorId?: string | null;\n  commitmentId?: string | null;\n  commitmentLineId?: string | null;\n  reimbursable?: boolean;\n  reimbursedAt?: Date | null;\n  reimbursementReference?: string;\n}\n\n/** Constructor options for {@link ExpenseReceipt}. */\nexport interface ExpenseReceiptOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  expenseId?: string;\n  assetId?: string;\n  uploadedByProfileId?: string | null;\n  filename?: string;\n  mimeType?: string;\n  byteCount?: number;\n  contentSha256?: string;\n}\n\n/** Arguments for `Expense.review()`. */\nexport interface ReviewExpenseInput {\n  /** Profile id of the reviewer. Required: a review is always attributed. */\n  reviewerProfileId: string;\n  /** Optional note kept on the expense. */\n  note?: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.reject()`. */\nexport interface RejectExpenseInput {\n  /** Profile id of the reviewer. */\n  reviewerProfileId: string;\n  /** Why the expense was refused. Required. */\n  reason: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.markDuplicate()`. */\nexport interface MarkDuplicateExpenseInput {\n  /** Profile id of the reviewer. */\n  reviewerProfileId: string;\n  /** Id of the expense this one duplicates (same tenant, not itself). */\n  duplicateOfId: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.reopen()`. */\nexport interface ReopenExpenseInput {\n  /** Profile id of the person reopening the review. */\n  reviewerProfileId: string;\n  /** Optional note kept on the expense. */\n  note?: string;\n}\n\n/** Arguments for `Expense.markReimbursed()`. */\nexport interface MarkReimbursedInput {\n  /** When the person was paid back; defaults to now. */\n  at?: Date;\n  /** Payroll line, payables reference, or transfer id. */\n  reference?: string;\n}\n\n/** Arguments for `ExpenseReceiptCollection.attachReceipt()`. */\nexport interface AttachReceiptInput {\n  /** The expense the receipt proves. */\n  expenseId: string;\n  /** The smrt-assets `Asset` holding the file. */\n  assetId: string;\n  /** Lowercase hex SHA-256 of the file's bytes (see `computeContentSha256`). */\n  contentSha256: string;\n  /** Who uploaded the file. */\n  uploadedByProfileId?: string | null;\n  /** Original filename; defaults to the asset's name. */\n  filename?: string;\n  /** MIME type; defaults to the asset's MIME type. */\n  mimeType?: string;\n  /** Size of the file in bytes. */\n  byteCount?: number;\n}\n\n/** Per-currency total. Amounts are integer minor units. */\nexport interface CurrencyTotal {\n  /** Sum of `amount` in integer minor units. */\n  amount: number;\n  /** Number of expenses in the sum. */\n  count: number;\n}\n\n/**\n * Totals keyed by ISO 4217 currency code. Amounts in different currencies\n * are never added together.\n */\nexport type CurrencyTotals = Record<string, CurrencyTotal>;\n\n/** Options for `ExpenseCollection.totalsByCurrency()`. */\nexport interface ExpenseTotalsOptions {\n  /** Extra SMRT `where` filters (cost object, category, date range...). */\n  where?: Record<string, unknown>;\n  /**\n   * Review states to include. Defaults to `['reviewed']`; expenses marked as\n   * a duplicate are never included.\n   */\n  reviewStatuses?: readonly ExpenseReviewStatus[];\n}\n\n/** Open position of a commitment (or one of its lines). */\nexport interface CommitmentPosition {\n  /** The commerce `Contract` (usually a `PurchaseOrder`) drawn down. */\n  commitmentId: string;\n  /** The line drawn down, when the position is for one line. */\n  commitmentLineId: string | null;\n  /** The commitment's currency; the only currency that draws it down. */\n  currency: string;\n  /** Committed amount: the contract's `totalAmount`, or the line's `amount`. */\n  committed: number;\n  /** Sum of reviewed, non-duplicate actuals in the commitment's currency. */\n  drawn: number;\n  /** `committed - drawn`, never below zero. */\n  open: number;\n  /** `drawn - committed` when actuals exceed the commitment, else zero. */\n  overrun: number;\n  /** Ids of the expenses counted in `drawn`, each exactly once. */\n  countedExpenseIds: string[];\n  /** Matched expenses not counted, by reason. */\n  excluded: {\n    unreviewed: number;\n    rejected: number;\n    duplicate: number;\n  };\n  /**\n   * Reviewed actuals matched to this commitment in another currency. Shown,\n   * never summed into `drawn` (expenses refuse a mismatched match on save, so\n   * this only fills when a commitment's currency changes after matching).\n   */\n  otherCurrencies: CurrencyTotals;\n}\n\n/** A content hash attached to more than one expense. */\nexport interface DuplicateReceiptGroup {\n  /** The shared SHA-256. */\n  contentSha256: string;\n  /** Distinct expenses carrying the file, sorted. */\n  expenseIds: string[];\n  /** Every receipt row carrying the file. */\n  receipts: ExpenseReceipt[];\n}\n\n/** Options for `ExpenseReceiptCollection.findDuplicateReceipts()`. */\nexport interface FindDuplicateReceiptsOptions {\n  /** Only report files that this expense shares with other expenses. */\n  expenseId?: string;\n  /** Maximum number of groups to return (default 100, at most 1,000). */\n  limit?: number;\n}\n\n/** Stable error codes raised by this package. */\nexport type ExpenseErrorCode =\n  | 'EXPENSE_INVALID'\n  | 'EXPENSE_REVIEW_TRANSITION'\n  | 'EXPENSE_REVIEW_FIELDS_LOCKED'\n  | 'EXPENSE_COMMITMENT_MISMATCH'\n  | 'EXPENSE_RECEIPT_INVALID'\n  | 'EXPENSE_RECEIPT_DUPLICATE'\n  | 'EXPENSE_IDENTITY_CONFLICT'\n  | 'EXPENSE_VENDOR_MISMATCH';\n\n/**\n * Base error for this package. `code` is stable and safe to branch on.\n */\nexport class ExpenseError extends Error {\n  readonly code: ExpenseErrorCode;\n\n  constructor(code: ExpenseErrorCode, message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ExpenseError';\n    this.code = code;\n  }\n}\n\n/**\n * Raised when the same file (same SHA-256) is attached to one expense twice.\n * The same file on two different expenses is allowed and reported by\n * `findDuplicateReceipts()` instead.\n */\nexport class DuplicateReceiptError extends ExpenseError {\n  readonly expenseId: string;\n  readonly contentSha256: string;\n\n  constructor(\n    expenseId: string,\n    contentSha256: string,\n    options?: ErrorOptions,\n  ) {\n    super(\n      'EXPENSE_RECEIPT_DUPLICATE',\n      `Expense ${expenseId} already has a receipt with SHA-256 ` +\n        `${contentSha256}; the same file cannot be attached twice.`,\n      options,\n    );\n    this.name = 'DuplicateReceiptError';\n    this.expenseId = expenseId;\n    this.contentSha256 = contentSha256;\n  }\n}\n"],"mappings":";AAoBO,IAAM,0BACX,OAAO,OAAO;CAAC;CAAc;CAAY;AAAU,CAAC;AAS/C,IAAM,iBAA0C,OAAO,OAAO,CACnE,WACA,QACF,CAAC;AAQM,IAAM,+BAAkD,OAAO,OAAO;CAC3E;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AA6LM,IAAM,eAAN,cAA2B,MAAM;CAC7B;CAET,YAAY,MAAwB,SAAiB,SAAwB;EAC3E,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,OAAO;CACd;AACF;AAOO,IAAM,wBAAN,cAAoC,aAAa;CAC7C;CACA;CAET,YACE,WACA,eACA,SACA;EACA,MACE,6BACA,WAAW,UAAS,sCACf,cAAa,4CAClB,OACF;EACA,KAAK,OAAO;EACZ,KAAK,YAAY;EACjB,KAAK,gBAAgB;CACvB;AACF"}
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["/**\n * Shared vocabulary, option shapes, and errors for smrt-expenses.\n *\n * @packageDocumentation\n */\n\nimport type { SmrtObjectOptions } from '@happyvertical/smrt-core';\nimport type { ExpenseReceipt } from './models/ExpenseReceipt.js';\n\n/**\n * Review state of an expense. Only `reviewed` expenses count toward a\n * commitment's drawdown or a cost roll-up of reviewed actuals.\n *\n * - `unreviewed` — recorded, not yet looked at (every expense starts here).\n * - `reviewed` — a reviewer accepted it as a real cost.\n * - `rejected` — a reviewer refused it (including as a duplicate).\n */\nexport type ExpenseReviewStatus = 'unreviewed' | 'reviewed' | 'rejected';\n\n/** Every {@link ExpenseReviewStatus}, in lifecycle order. */\nexport const EXPENSE_REVIEW_STATUSES: readonly ExpenseReviewStatus[] =\n  Object.freeze(['unreviewed', 'reviewed', 'rejected']);\n\n/**\n * Who paid for an expense: the `company` (card, account, vendor terms) or a\n * named `person` out of pocket, or a named `third-party`. Only a person may\n * be owed an employee reimbursement.\n */\nexport type ExpensePayer = 'company' | 'person' | 'third-party';\n\n/** Every {@link ExpensePayer}. */\nexport const EXPENSE_PAYERS: readonly ExpensePayer[] = Object.freeze([\n  'company',\n  'person',\n  'third-party',\n]);\n\n/**\n * Suggested expense categories. `Expense.category` is an open string so a\n * vertical can add its own; these cover teamworks-os `JobExpense`\n * (`material | consumable | outside-service | freight | other`) plus the\n * common additions `equipment` and `travel`.\n */\nexport const SUGGESTED_EXPENSE_CATEGORIES: readonly string[] = Object.freeze([\n  'material',\n  'consumable',\n  'outside-service',\n  'freight',\n  'equipment',\n  'travel',\n  'other',\n]);\n\n/** Explicit supplier tax in signed integer minor units; no jurisdiction defaults. */\nexport interface ExpenseTaxComponent {\n  /** Unique caller-defined lower-case kebab-case identifier. */\n  code: string;\n  /** Tax charged by the supplier, negative for a refund. */\n  amount: number;\n  /** Explicit recoverable portion, same sign and no larger than amount. */\n  recoverableAmount: number;\n}\n\n/** Complete optional purchase facts; subtotal plus taxes must equal total. */\nexport interface ExpenseFinancialBreakdown {\n  /** Exact ISO currency of the expense. */\n  currency: string;\n  /** Supplier amount before the explicit taxes. */\n  subtotal: number;\n  /** Explicit components; an empty array asserts no tax. */\n  taxes: ExpenseTaxComponent[];\n  /** Supplier total, exactly equal to Expense.amount. */\n  total: number;\n}\n\n/** Exact retained basis; never implies customer markup or sales tax treatment. */\nexport interface ExpenseCostBasis {\n  /** Currency shared by every value. */\n  currency: string;\n  /** Supplier subtotal. */\n  subtotal: number;\n  /** Sum of supplier tax components. */\n  taxTotal: number;\n  /** Explicit recoverable supplier tax. */\n  recoverableTax: number;\n  /** Supplier tax retained as cost. */\n  nonRecoverableTax: number;\n  /** Supplier gross total. */\n  total: number;\n  /** Subtotal plus non-recoverable tax. */\n  costBasis: number;\n}\n\n/** Constructor options for {@link Expense}. */\nexport interface ExpenseOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  costObjectType?: string;\n  costObjectId?: string;\n  category?: string;\n  description?: string;\n  amount?: number;\n  currency?: string;\n  /** Complete supplier facts as JSON text; absent means unknown. */\n  financialBreakdown?: string | null;\n  /** Required only for third-party payers. */\n  paidByName?: string | null;\n  /** Same-tenant/currency positive source required for a negative refund. */\n  refundOfId?: string | null;\n  incurredOn?: string;\n  recordedAt?: Date | null;\n  recordedByProfileId?: string | null;\n  paidBy?: ExpensePayer;\n  paidByProfileId?: string | null;\n  vendorId?: string | null;\n  commitmentId?: string | null;\n  commitmentLineId?: string | null;\n  reimbursable?: boolean;\n  reimbursedAt?: Date | null;\n  reimbursementReference?: string;\n}\n\n/** Constructor options for {@link ExpenseReceipt}. */\nexport interface ExpenseReceiptOptions extends SmrtObjectOptions {\n  tenantId?: string | null;\n  expenseId?: string;\n  assetId?: string;\n  uploadedByProfileId?: string | null;\n  filename?: string;\n  mimeType?: string;\n  byteCount?: number;\n  contentSha256?: string;\n}\n\n/** Arguments for `Expense.review()`. */\nexport interface ReviewExpenseInput {\n  /** Profile id of the reviewer. Required: a review is always attributed. */\n  reviewerProfileId: string;\n  /** Optional note kept on the expense. */\n  note?: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.reject()`. */\nexport interface RejectExpenseInput {\n  /** Profile id of the reviewer. */\n  reviewerProfileId: string;\n  /** Why the expense was refused. Required. */\n  reason: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.markDuplicate()`. */\nexport interface MarkDuplicateExpenseInput {\n  /** Profile id of the reviewer. */\n  reviewerProfileId: string;\n  /** Id of the expense this one duplicates (same tenant, not itself). */\n  duplicateOfId: string;\n  /** Review time; defaults to now. */\n  at?: Date;\n}\n\n/** Arguments for `Expense.reopen()`. */\nexport interface ReopenExpenseInput {\n  /** Profile id of the person reopening the review. */\n  reviewerProfileId: string;\n  /** Optional note kept on the expense. */\n  note?: string;\n}\n\n/** Arguments for `Expense.markReimbursed()`. */\nexport interface MarkReimbursedInput {\n  /** When the person was paid back; defaults to now. */\n  at?: Date;\n  /** Payroll line, payables reference, or transfer id. */\n  reference?: string;\n}\n\n/** Arguments for `ExpenseReceiptCollection.attachReceipt()`. */\nexport interface AttachReceiptInput {\n  /** The expense the receipt proves. */\n  expenseId: string;\n  /** The smrt-assets `Asset` holding the file. */\n  assetId: string;\n  /** Lowercase hex SHA-256 of the file's bytes (see `computeContentSha256`). */\n  contentSha256: string;\n  /** Who uploaded the file. */\n  uploadedByProfileId?: string | null;\n  /** Original filename; defaults to the asset's name. */\n  filename?: string;\n  /** MIME type; defaults to the asset's MIME type. */\n  mimeType?: string;\n  /** Size of the file in bytes. */\n  byteCount?: number;\n}\n\n/** Per-currency total. Amounts are integer minor units. */\nexport interface CurrencyTotal {\n  /** Sum of `amount` in integer minor units. */\n  amount: number;\n  /** Number of expenses in the sum. */\n  count: number;\n}\n\n/**\n * Totals keyed by ISO 4217 currency code. Amounts in different currencies\n * are never added together.\n */\nexport type CurrencyTotals = Record<string, CurrencyTotal>;\n\n/** Options for `ExpenseCollection.totalsByCurrency()`. */\nexport interface ExpenseTotalsOptions {\n  /** Extra SMRT `where` filters (cost object, category, date range...). */\n  where?: Record<string, unknown>;\n  /**\n   * Review states to include. Defaults to `['reviewed']`; expenses marked as\n   * a duplicate are never included.\n   */\n  reviewStatuses?: readonly ExpenseReviewStatus[];\n}\n\n/** Open position of a commitment (or one of its lines). */\nexport interface CommitmentPosition {\n  /** The commerce `Contract` (usually a `PurchaseOrder`) drawn down. */\n  commitmentId: string;\n  /** The line drawn down, when the position is for one line. */\n  commitmentLineId: string | null;\n  /** The commitment's currency; the only currency that draws it down. */\n  currency: string;\n  /** Committed amount: the contract's `totalAmount`, or the line's `amount`. */\n  committed: number;\n  /** Sum of reviewed, non-duplicate actuals in the commitment's currency. */\n  drawn: number;\n  /** `committed - drawn`, never below zero. */\n  open: number;\n  /** `drawn - committed` when actuals exceed the commitment, else zero. */\n  overrun: number;\n  /** Ids of the expenses counted in `drawn`, each exactly once. */\n  countedExpenseIds: string[];\n  /** Matched expenses not counted, by reason. */\n  excluded: {\n    unreviewed: number;\n    rejected: number;\n    duplicate: number;\n  };\n  /**\n   * Reviewed actuals matched to this commitment in another currency. Shown,\n   * never summed into `drawn` (expenses refuse a mismatched match on save, so\n   * this only fills when a commitment's currency changes after matching).\n   */\n  otherCurrencies: CurrencyTotals;\n}\n\n/** A content hash attached to more than one expense. */\nexport interface DuplicateReceiptGroup {\n  /** The shared SHA-256. */\n  contentSha256: string;\n  /** Distinct expenses carrying the file, sorted. */\n  expenseIds: string[];\n  /** Every receipt row carrying the file. */\n  receipts: ExpenseReceipt[];\n}\n\n/** Options for `ExpenseReceiptCollection.findDuplicateReceipts()`. */\nexport interface FindDuplicateReceiptsOptions {\n  /** Only report files that this expense shares with other expenses. */\n  expenseId?: string;\n  /** Maximum number of groups to return (default 100, at most 1,000). */\n  limit?: number;\n}\n\n/** Stable error codes raised by this package. */\nexport type ExpenseErrorCode =\n  | 'EXPENSE_INVALID'\n  | 'EXPENSE_REVIEW_TRANSITION'\n  | 'EXPENSE_REVIEW_FIELDS_LOCKED'\n  | 'EXPENSE_COMMITMENT_MISMATCH'\n  | 'EXPENSE_RECEIPT_INVALID'\n  | 'EXPENSE_RECEIPT_DUPLICATE'\n  | 'EXPENSE_IDENTITY_CONFLICT'\n  | 'EXPENSE_VENDOR_MISMATCH';\n\n/**\n * Base error for this package. `code` is stable and safe to branch on.\n */\nexport class ExpenseError extends Error {\n  readonly code: ExpenseErrorCode;\n\n  constructor(code: ExpenseErrorCode, message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ExpenseError';\n    this.code = code;\n  }\n}\n\n/**\n * Raised when the same file (same SHA-256) is attached to one expense twice.\n * The same file on two different expenses is allowed and reported by\n * `findDuplicateReceipts()` instead.\n */\nexport class DuplicateReceiptError extends ExpenseError {\n  readonly expenseId: string;\n  readonly contentSha256: string;\n\n  constructor(\n    expenseId: string,\n    contentSha256: string,\n    options?: ErrorOptions,\n  ) {\n    super(\n      'EXPENSE_RECEIPT_DUPLICATE',\n      `Expense ${expenseId} already has a receipt with SHA-256 ` +\n        `${contentSha256}; the same file cannot be attached twice.`,\n      options,\n    );\n    this.name = 'DuplicateReceiptError';\n    this.expenseId = expenseId;\n    this.contentSha256 = contentSha256;\n  }\n}\n"],"mappings":";AAoBO,IAAM,0BACX,OAAO,OAAO;CAAC;CAAc;CAAY;AAAU,CAAC;AAU/C,IAAM,iBAA0C,OAAO,OAAO;CACnE;CACA;CACA;AACF,CAAC;AAQM,IAAM,+BAAkD,OAAO,OAAO;CAC3E;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AA2OM,IAAM,eAAN,cAA2B,MAAM;CAC7B;CAET,YAAY,MAAwB,SAAiB,SAAwB;EAC3E,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;EACZ,KAAK,OAAO;CACd;AACF;AAOO,IAAM,wBAAN,cAAoC,aAAa;CAC7C;CACA;CAET,YACE,WACA,eACA,SACA;EACA,MACE,6BACA,WAAW,UAAS,sCACf,cAAa,4CAClB,OACF;EACA,KAAK,OAAO;EACZ,KAAK,YAAY;EACjB,KAAK,gBAAgB;CACvB;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-expenses",
-  "version": "0.55.13",
+  "version": "0.55.15",
   "description": "Expense records for the SMRT framework - reviewed costs against a cost object, deduplicated receipts, and commitment drawdown",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,15 +33,15 @@
     }
   },
   "dependencies": {
-    "@happyvertical/smrt-assets": "0.55.13",
-    "@happyvertical/smrt-commerce": "0.55.13",
-    "@happyvertical/smrt-core": "0.55.13",
-    "@happyvertical/smrt-tenancy": "0.55.13",
-    "@happyvertical/smrt-types": "0.55.13",
-    "@happyvertical/smrt-ui": "0.55.13"
+    "@happyvertical/smrt-assets": "0.55.15",
+    "@happyvertical/smrt-commerce": "0.55.15",
+    "@happyvertical/smrt-core": "0.55.15",
+    "@happyvertical/smrt-tenancy": "0.55.15",
+    "@happyvertical/smrt-types": "0.55.15",
+    "@happyvertical/smrt-ui": "0.55.15"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.55.13",
+    "@happyvertical/smrt-vitest": "0.55.15",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",

package/dist/chunks/Expense-C8HXtsJw.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Expense-C8HXtsJw.js","names":[],"sources":["../../src/validation.ts","../../src/models/Expense.ts"],"sourcesContent":["/**\n * Small, pure validators shared by the expense models.\n *\n * @packageDocumentation\n */\n\nimport { createHash } from 'node:crypto';\nimport { getTenantId } from '@happyvertical/smrt-tenancy';\nimport { ExpenseError, type ExpenseErrorCode } from './types.js';\n\n/** Lowercase kebab-case: `material`, `outside-service`. */\nexport const CATEGORY_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\nconst ISO_CURRENCY = /^[A-Z]{3}$/;\nconst ISO_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst QUALIFIED_CLASS = /^[^\\s:]+:[A-Za-z_$][\\w$]*$/;\nconst SHA256_HEX = /^[0-9a-f]{64}$/;\n\n/**\n * Throw unless `value` is a non-negative, JavaScript-safe integer number of\n * minor units. Money is exact: `$19.99` is `1999`, never `19.99`.\n */\nexport function assertMinorUnits(\n  model: string,\n  label: string,\n  fieldName: string,\n  value: number,\n  code: ExpenseErrorCode = 'EXPENSE_INVALID',\n): void {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new ExpenseError(\n      code,\n      `${model} ${label}: ${fieldName} must be a non-negative integer ` +\n        `number of minor units (cents) — got ${value}. $19.99 is 1999.`,\n    );\n  }\n}\n\n/** Throw unless `value` is an upper-case ISO 4217 code such as `USD`. */\nexport function assertIsoCurrency(\n  model: string,\n  label: string,\n  value: string,\n): void {\n  if (!ISO_CURRENCY.test(value)) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: currency must be a three-letter ISO 4217 code ` +\n        `(for example 'USD'), got '${value}'.`,\n    );\n  }\n}\n\n/** Throw unless `value` is a real calendar date written `YYYY-MM-DD`. */\nexport function assertIsoDate(\n  model: string,\n  label: string,\n  fieldName: string,\n  value: string,\n): void {\n  const match = ISO_DATE.exec(value);\n  const valid =\n    match !== null &&\n    (() => {\n      const [year, month, day] = match.slice(1).map(Number);\n      const date = new Date(Date.UTC(year, month - 1, day));\n      return (\n        date.getUTCFullYear() === year &&\n        date.getUTCMonth() === month - 1 &&\n        date.getUTCDate() === day\n      );\n    })();\n  if (!valid) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: ${fieldName} must be a calendar date written ` +\n        `YYYY-MM-DD, got '${value}'.`,\n    );\n  }\n}\n\n/**\n * Throw unless `value` is a package-qualified class name such as\n * `@happyvertical/smrt-projects:Project`. A bare class name is ambiguous\n * (packages can share names) and is refused.\n */\nexport function assertQualifiedClassName(\n  model: string,\n  label: string,\n  value: string,\n): void {\n  if (!QUALIFIED_CLASS.test(value)) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      `${model} ${label}: costObjectType must be a qualified class name ` +\n        `such as '@happyvertical/smrt-projects:Project', got '${value}'.`,\n    );\n  }\n}\n\n/** Normalize and check a SHA-256 hex digest; returns it in lower case. */\nexport function normalizeSha256(model: string, label: string, value: string) {\n  const digest = String(value ?? '')\n    .trim()\n    .toLowerCase();\n  if (!SHA256_HEX.test(digest)) {\n    throw new ExpenseError(\n      'EXPENSE_RECEIPT_INVALID',\n      `${model} ${label}: contentSha256 must be a 64-character hex SHA-256 ` +\n        'digest of the file bytes.',\n    );\n  }\n  return digest;\n}\n\n/**\n * Lowercase hex SHA-256 of a file's bytes — the value\n * `ExpenseReceipt.contentSha256` expects.\n *\n * @example\n * ```typescript\n * const digest = computeContentSha256(await readFile('receipt.pdf'));\n * ```\n */\nexport function computeContentSha256(data: Uint8Array | string): string {\n  return createHash('sha256').update(data).digest('hex');\n}\n\n/** Milliseconds since the epoch of a date-ish value; `null` when empty. */\nexport function instantMs(value: unknown): number | null {\n  if (value === null || value === undefined || value === '') return null;\n  const ms =\n    value instanceof Date ? value.getTime() : new Date(String(value)).getTime();\n  return Number.isNaN(ms) ? null : ms;\n}\n\n/** The slice of `SmrtObject` the natural-key identity guard needs. */\ninterface NaturalKeyed {\n  id?: string | null;\n  slug?: string | null;\n  context?: string | null;\n  readonly isPersisted: boolean;\n  getSlug(): Promise<unknown>;\n  requireInsertOnSave(): void;\n}\n\n/**\n * Make a save write only the row its guards checked.\n *\n * Core's natural-key save adopts any same-owner row on\n * `(tenant_id, slug, context)` and upserts it without a revision predicate,\n * and these models have no human slug. So:\n *\n * - a fresh (never loaded, never saved) instance may only INSERT\n *   (`requireInsertOnSave`): naming an existing row's id is refused here, and\n *   a row that appears between this check and the write makes the INSERT\n *   fail rather than be adopted;\n * - an existing row is changed only through a loaded instance, whose save\n *   carries core's revision compare-and-swap, and it must keep the slug and\n *   context it is stored under, so the write targets that row and no other.\n *\n * @returns `true` when this save is an INSERT.\n * @throws {ExpenseError} `EXPENSE_IDENTITY_CONFLICT` when a fresh instance\n *   names an existing row, or a loaded one changes its natural key.\n */\nexport async function pinNaturalKey(\n  model: string,\n  object: NaturalKeyed,\n  persisted: Record<string, unknown> | null,\n): Promise<boolean> {\n  await object.getSlug();\n  if (!object.isPersisted) {\n    if (persisted) {\n      throw new ExpenseError(\n        'EXPENSE_IDENTITY_CONFLICT',\n        `${model} ${object.id} already exists; load it and save the loaded ` +\n          'instance instead of creating one with its id.',\n      );\n    }\n    object.requireInsertOnSave();\n    return true;\n  }\n  if (\n    persisted &&\n    (String(persisted.slug ?? '') !== String(object.slug ?? '') ||\n      String(persisted.context ?? '') !== String(object.context ?? ''))\n  ) {\n    throw new ExpenseError(\n      'EXPENSE_IDENTITY_CONFLICT',\n      `${model} ${object.id}: slug and context cannot change; they would ` +\n        'point the save at a different row.',\n    );\n  }\n  return false;\n}\n\n/** The error a refused natural-key INSERT is reported as. */\nexport function identityConflict(\n  model: string,\n  object: { id?: string | null; slug?: string | null },\n  cause: unknown,\n): ExpenseError {\n  return new ExpenseError(\n    'EXPENSE_IDENTITY_CONFLICT',\n    `${model} ${object.id}: another row already uses slug ` +\n      `'${object.slug}' in this tenant; a new ${model} cannot take it over.`,\n    { cause },\n  );\n}\n\n/**\n * The tenant a save will actually write: tenancy's `beforeSave` interceptor\n * fills an unset `tenantId` from the active tenant context, after the\n * model's own checks have run, and \"unset\" is falsy there — `''` included.\n * Compare against this, not the raw field.\n */\nexport function effectiveTenant(\n  tenantId: string | null | undefined,\n): string | null {\n  return tenantId || getTenantId() || null;\n}\n\n/**\n * An empty tenant id is unset, never a tenant of its own: core and tenancy\n * treat it as falsy (and real tenant ids are UUIDs), so it is stored as\n * NULL — a global row — rather than as a `''` pseudo-tenant.\n */\nexport function normalizeTenantId(\n  tenantId: string | null | undefined,\n): string | null {\n  return tenantId || null;\n}\n","/**\n * Expense — a cost someone incurred, against a cost object, with a review\n * state and optional reimbursement and commitment links.\n *\n * @packageDocumentation\n */\n\nimport {\n  ContractCollection,\n  ContractLineItemCollection,\n  VendorCollection,\n} from '@happyvertical/smrt-commerce';\nimport {\n  crossPackageRef,\n  field,\n  foreignKey,\n  isUniqueViolationError,\n  ObjectRegistry,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport {\n  ExpenseError,\n  type ExpenseOptions,\n  type ExpensePayer,\n  type ExpenseReviewStatus,\n  type MarkDuplicateExpenseInput,\n  type MarkReimbursedInput,\n  type RejectExpenseInput,\n  type ReopenExpenseInput,\n  type ReviewExpenseInput,\n} from '../types.js';\nimport {\n  assertIsoCurrency,\n  assertIsoDate,\n  assertMinorUnits,\n  assertQualifiedClassName,\n  CATEGORY_PATTERN,\n  effectiveTenant,\n  identityConflict,\n  instantMs,\n  normalizeTenantId,\n  pinNaturalKey,\n} from '../validation.js';\n\nconst PROFILE = '@happyvertical/smrt-profiles:Profile';\n\n/**\n * Legal review moves, keyed by the persisted status. Only the dedicated\n * methods perform them; `save()` refuses a review-field change they did not\n * authorize.\n */\nconst REVIEW_TRANSITIONS: Record<\n  'review' | 'reject' | 'markDuplicate' | 'reopen',\n  { from: readonly ExpenseReviewStatus[]; to: ExpenseReviewStatus }\n> = {\n  review: { from: ['unreviewed'], to: 'reviewed' },\n  reject: { from: ['unreviewed', 'reviewed'], to: 'rejected' },\n  markDuplicate: { from: ['unreviewed', 'reviewed'], to: 'rejected' },\n  reopen: { from: ['reviewed', 'rejected'], to: 'unreviewed' },\n};\n\n/**\n * Fields a reviewed expense freezes. Changing one needs `reopen()` first, so\n * a reviewed amount can never move without a fresh review.\n */\nconst LOCKED_WHEN_REVIEWED = [\n  ['amount', 'amount'],\n  ['currency', 'currency'],\n  ['incurredOn', 'incurred_on'],\n  ['recordedAt', 'recorded_at'],\n  ['category', 'category'],\n  ['costObjectType', 'cost_object_type'],\n  ['costObjectId', 'cost_object_id'],\n  ['vendorId', 'vendor_id'],\n  ['commitmentId', 'commitment_id'],\n  ['commitmentLineId', 'commitment_line_id'],\n  ['paidBy', 'paid_by'],\n  ['paidByProfileId', 'paid_by_profile_id'],\n] as const;\n\n/** The review transition a dedicated method has authorized for one save. */\nconst authorizedTransition = new WeakMap<\n  Expense,\n  { from: ExpenseReviewStatus; expected: ReviewFieldState }\n>();\n\n/** Every review field, normalized for comparison. */\ninterface ReviewFieldState {\n  status: ExpenseReviewStatus;\n  reviewer: string | null;\n  reviewedAtMs: number | null;\n  note: string;\n  duplicateOf: string | null;\n}\n\nfunction sameReviewState(a: ReviewFieldState, b: ReviewFieldState): boolean {\n  return (\n    a.status === b.status &&\n    a.reviewer === b.reviewer &&\n    a.reviewedAtMs === b.reviewedAtMs &&\n    a.note === b.note &&\n    a.duplicateOf === b.duplicateOf\n  );\n}\n\ntype PersistedRow = Record<string, unknown>;\n\nfunction asNullableString(value: unknown): string | null {\n  return value === null || value === undefined || value === ''\n    ? null\n    : String(value);\n}\n\n/**\n * A cost someone incurred.\n *\n * - **Cost object** — polymorphic `(costObjectType, costObjectId)`: a job, a\n *   work package, a project, any registered SMRT object. Exactly one per\n *   expense, so a cost is never rolled up into two jobs.\n * - **Money** — `amount` in integer minor units with an ISO 4217 `currency`.\n * - **Dates** — `incurredOn` (calendar date, `YYYY-MM-DD`) is when the cost\n *   happened; `recordedAt` is when it was entered.\n * - **Review** — `unreviewed → reviewed | rejected`, only through\n *   {@link Expense.review}, {@link Expense.reject},\n *   {@link Expense.markDuplicate} and {@link Expense.reopen}. A plain field\n *   write to the review state is refused on save.\n * - **Reimbursement** — recording only: whether a person who paid is owed\n *   back and when they were paid. Never changes review state.\n * - **Commitment** — optional commerce `Contract` (usually a `PurchaseOrder`)\n *   or one of its lines that this actual draws down.\n *\n * The generated REST/MCP/CLI surface is closed (`api: { include: [] }`):\n * cost visibility is permission-gated by every consumer, so they expose\n * expenses through their own routes and call the domain methods here.\n */\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: 'expenses',\n  api: { include: [] },\n  mcp: { include: [] },\n  cli: false,\n  indexes: [\n    {\n      name: 'expenses_cost_object_idx',\n      columns: ['tenantId', 'costObjectType', 'costObjectId', 'incurredOn'],\n    },\n    {\n      name: 'expenses_commitment_review_idx',\n      columns: ['tenantId', 'commitmentId', 'reviewStatus'],\n    },\n    {\n      name: 'expenses_review_status_idx',\n      columns: ['tenantId', 'reviewStatus', 'incurredOn'],\n    },\n  ],\n})\nexport class Expense extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-expenses\";\n  /** Owning tenant. Nullable: optional tenancy, like every commerce model. */\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  /**\n   * Qualified class of the cost object, e.g.\n   * `@happyvertical/smrt-projects:Project`. Empty only for an unallocated\n   * expense (then `costObjectId` is empty too).\n   */\n  @field({ type: 'text' })\n  costObjectType: string = '';\n\n  /** Id of the cost object. Bare string: the target table is polymorphic. */\n  @field({ type: 'text' })\n  costObjectId: string = '';\n\n  /**\n   * Lowercase kebab-case category. See `SUGGESTED_EXPENSE_CATEGORIES`;\n   * any value matching the pattern is accepted.\n   */\n  @field({ type: 'text' })\n  category: string = 'other';\n\n  /** What was bought or paid for. */\n  @field({ type: 'text' })\n  description: string = '';\n\n  /** Amount in integer minor units (cents). `= 0` makes the column INTEGER. */\n  @field({ type: 'integer' })\n  amount: number = 0;\n\n  /** ISO 4217 currency code, upper case. Required. */\n  @field({ type: 'text' })\n  currency: string = '';\n\n  /** Calendar date the cost was incurred, `YYYY-MM-DD`. Required. */\n  @field({ type: 'text' })\n  incurredOn: string = '';\n\n  /** When the expense was recorded; set on first save when empty. */\n  recordedAt: Date | null = null;\n\n  /** Profile that recorded the expense. */\n  @crossPackageRef(PROFILE)\n  recordedByProfileId: string | null = null;\n\n  /** `company`, or `person` (then {@link Expense.paidByProfileId} is set). */\n  @field({ type: 'text' })\n  paidBy: ExpensePayer = 'company';\n\n  /** Profile that paid out of pocket; required when `paidBy` is `person`. */\n  @crossPackageRef(PROFILE)\n  paidByProfileId: string | null = null;\n\n  /** Optional commerce vendor the cost was paid to. */\n  @crossPackageRef('@happyvertical/smrt-commerce:Vendor')\n  vendorId: string | null = null;\n\n  /**\n   * Optional commitment this actual draws down: a commerce `Contract`\n   * (normally a `PurchaseOrder`). Must be in the same currency and tenant.\n   */\n  @crossPackageRef('@happyvertical/smrt-commerce:Contract')\n  commitmentId: string | null = null;\n\n  /** Optional line of {@link Expense.commitmentId} this actual draws down. */\n  @crossPackageRef('@happyvertical/smrt-commerce:ContractLineItem')\n  commitmentLineId: string | null = null;\n\n  /** Review state. Changed only by the review methods. */\n  @field({ type: 'text', readonly: true })\n  reviewStatus: ExpenseReviewStatus = 'unreviewed';\n\n  /** Profile that made the current review decision. */\n  @crossPackageRef(PROFILE, { readonly: true })\n  reviewedByProfileId: string | null = null;\n\n  /** When the current review decision was made. */\n  @field({ type: 'datetime', readonly: true })\n  reviewedAt: Date | null = null;\n\n  /** Review note or rejection reason. */\n  @field({ type: 'text', readonly: true })\n  reviewNote: string = '';\n\n  /**\n   * Set when a reviewer marked this expense a duplicate of another one. A\n   * duplicate is `rejected` and never counts toward any total.\n   */\n  @foreignKey('Expense', { readonly: true, onDelete: 'SET NULL' })\n  duplicateOfId: string | null = null;\n\n  /** Whether the person who paid is owed the amount back. */\n  @field({ type: 'boolean' })\n  reimbursable: boolean = false;\n\n  /** When the person was paid back; set by {@link Expense.markReimbursed}. */\n  reimbursedAt: Date | null = null;\n\n  /** Payroll line, payables reference, or transfer id of the payback. */\n  @field({ type: 'text' })\n  reimbursementReference: string = '';\n\n  constructor(options: ExpenseOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.costObjectType !== undefined)\n      this.costObjectType = options.costObjectType;\n    if (options.costObjectId !== undefined)\n      this.costObjectId = options.costObjectId;\n    if (options.category !== undefined) this.category = options.category;\n    if (options.description !== undefined)\n      this.description = options.description;\n    if (options.amount !== undefined) this.amount = options.amount;\n    if (options.currency !== undefined) this.currency = options.currency;\n    if (options.incurredOn !== undefined) this.incurredOn = options.incurredOn;\n    if (options.recordedAt !== undefined) this.recordedAt = options.recordedAt;\n    if (options.recordedByProfileId !== undefined)\n      this.recordedByProfileId = options.recordedByProfileId;\n    if (options.paidBy !== undefined) this.paidBy = options.paidBy;\n    if (options.paidByProfileId !== undefined)\n      this.paidByProfileId = options.paidByProfileId;\n    if (options.vendorId !== undefined) this.vendorId = options.vendorId;\n    if (options.commitmentId !== undefined)\n      this.commitmentId = options.commitmentId;\n    if (options.commitmentLineId !== undefined)\n      this.commitmentLineId = options.commitmentLineId;\n    if (options.reimbursable !== undefined)\n      this.reimbursable = options.reimbursable;\n    if (options.reimbursedAt !== undefined)\n      this.reimbursedAt = options.reimbursedAt;\n    if (options.reimbursementReference !== undefined)\n      this.reimbursementReference = options.reimbursementReference;\n  }\n\n  /** True when the person who paid has been paid back. */\n  isReimbursed(): boolean {\n    return this.reimbursedAt !== null && this.reimbursedAt !== undefined;\n  }\n\n  /** True when this expense counts toward reviewed totals and drawdown. */\n  isCountable(): boolean {\n    return this.reviewStatus === 'reviewed' && !this.duplicateOfId;\n  }\n\n  /**\n   * Accept the expense as a real cost: `unreviewed → reviewed`.\n   *\n   * This is the separately authorizable review action: gate it in your route\n   * or service (for example on `expenses.review`). The expense must already\n   * be saved and must not be marked a duplicate.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from any other state.\n   */\n  async review(input: ReviewExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    return this.transition('review', () => {\n      this.reviewStatus = 'reviewed';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = input.note ?? '';\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Refuse the expense: `unreviewed | reviewed → rejected`. A rejected\n   * expense is kept and shown, and never counted.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `rejected`, or\n   *   `EXPENSE_INVALID` without a reason.\n   */\n  async reject(input: RejectExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    const reason = (input.reason ?? '').trim();\n    if (!reason) {\n      throw new ExpenseError('EXPENSE_INVALID', 'A rejection needs a reason.');\n    }\n    return this.transition('reject', () => {\n      this.reviewStatus = 'rejected';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = reason;\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Mark this expense a duplicate of another expense in the same tenant:\n   * `unreviewed | reviewed → rejected` with {@link Expense.duplicateOfId}\n   * set. A duplicate never counts toward any total.\n   *\n   * @throws {ExpenseError} `EXPENSE_INVALID` when the target is this expense\n   *   or is not visible in this expense's tenant.\n   */\n  async markDuplicate(input: MarkDuplicateExpenseInput): Promise<this> {\n    const reviewer = requireReviewer(input?.reviewerProfileId);\n    const targetId = String(input.duplicateOfId ?? '').trim();\n    if (!targetId || targetId === this.id) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        'An expense can only be a duplicate of a different expense.',\n      );\n    }\n    const { ExpenseCollection } = await import(\n      '../collections/ExpenseCollection.js'\n    );\n    const expenses = await ExpenseCollection.create({ db: this.db });\n    const target = await expenses.get({ id: targetId });\n    if (!target || (target.tenantId ?? null) !== (this.tenantId ?? null)) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${targetId} was not found in this expense's tenant.`,\n      );\n    }\n    return this.transition('markDuplicate', () => {\n      this.reviewStatus = 'rejected';\n      this.reviewedByProfileId = reviewer;\n      this.reviewedAt = input.at ?? new Date();\n      this.reviewNote = `Duplicate of expense ${targetId}`;\n      this.duplicateOfId = targetId;\n    });\n  }\n\n  /**\n   * Send the expense back for review: `reviewed | rejected → unreviewed`.\n   * Clears the reviewer, the review time and any duplicate marker.\n   *\n   * @throws {ExpenseError} `EXPENSE_REVIEW_TRANSITION` from `unreviewed`.\n   */\n  async reopen(input: ReopenExpenseInput): Promise<this> {\n    requireReviewer(input?.reviewerProfileId);\n    return this.transition('reopen', () => {\n      this.reviewStatus = 'unreviewed';\n      this.reviewedByProfileId = null;\n      this.reviewedAt = null;\n      this.reviewNote = input.note ?? '';\n      this.duplicateOfId = null;\n    });\n  }\n\n  /**\n   * Record that the person who paid has been paid back. Recording only:\n   * paying happens in payroll or payables, and this never changes the review\n   * state.\n   *\n   * @throws {ExpenseError} `EXPENSE_INVALID` unless the expense is\n   *   `reimbursable`.\n   */\n  async markReimbursed(input: MarkReimbursedInput = {}): Promise<this> {\n    if (!this.reimbursable) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${this.id} is not owed back to anyone.`,\n      );\n    }\n    this.reimbursedAt = input.at ?? new Date();\n    if (input.reference !== undefined)\n      this.reimbursementReference = input.reference;\n    return this.save();\n  }\n\n  /**\n   * Load the cost object this expense is charged to, through its registered\n   * collection (so tenant interceptors apply). Returns `null` when unset,\n   * when the type is not registered, when the row is gone, or when the row\n   * belongs to a different tenant than this expense.\n   */\n  async getCostObject<T extends SmrtObject = SmrtObject>(): Promise<T | null> {\n    if (!this.costObjectType || !this.costObjectId) return null;\n    let registered = ObjectRegistry.getClassByQualifiedName(\n      this.costObjectType,\n    );\n    if (!registered) {\n      const loaded = await ObjectRegistry.tryLoadFromExternalPackage(\n        this.costObjectType,\n      );\n      if (!loaded) return null;\n      registered = ObjectRegistry.getClassByQualifiedName(this.costObjectType);\n    }\n    if (!registered) return null;\n    const collection = await ObjectRegistry.getCollection<SmrtObject>(\n      registered.qualifiedName ?? this.costObjectType,\n      { db: this.db },\n    );\n    const target = await collection.get({ id: this.costObjectId });\n    if (!target) return null;\n    const targetTenant = (target as unknown as { tenantId?: string | null })\n      .tenantId;\n    if (\n      targetTenant !== undefined &&\n      targetTenant !== null &&\n      this.tenantId !== null &&\n      targetTenant !== this.tenantId\n    ) {\n      return null;\n    }\n    return target as T;\n  }\n\n  /**\n   * Validate, enforce the review and reviewed-field locks, check the\n   * commitment, then persist.\n   */\n  override async save(): Promise<this> {\n    this.normalize();\n    this.validateShape();\n\n    const persisted = await this.readPersisted();\n    // The guards below check `persisted`; pin the write to that row.\n    const inserting = await pinNaturalKey('Expense', this, persisted);\n    if (\n      persisted &&\n      String(persisted.tenant_id ?? '') !==\n        String(effectiveTenant(this.tenantId) ?? '')\n    ) {\n      // Includes the quiet case: saving a global expense inside a tenant\n      // context, where the interceptor would fill in that tenant and split\n      // the expense from its global receipts and links.\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${this.id}: its tenant cannot change after it is recorded.`,\n      );\n    }\n    this.assertReviewFields(persisted);\n    this.assertReviewedLock(persisted);\n    await this.assertCommitment(persisted);\n    await this.assertVendor(persisted);\n\n    if (!this.recordedAt) this.recordedAt = new Date();\n    try {\n      return await super.save();\n    } catch (error) {\n      // A new expense is a plain INSERT; its only unique keys are the id and\n      // the natural key, so a violation means it named an existing row.\n      if (inserting && isUniqueViolationError(error)) {\n        throw identityConflict('Expense', this, error);\n      }\n      throw error;\n    }\n  }\n\n  private normalize(): void {\n    this.tenantId = normalizeTenantId(this.tenantId);\n    this.currency = String(this.currency ?? '')\n      .trim()\n      .toUpperCase();\n    this.category = String(this.category ?? '').trim();\n    this.costObjectType = String(this.costObjectType ?? '').trim();\n    this.costObjectId = String(this.costObjectId ?? '').trim();\n    this.incurredOn = String(this.incurredOn ?? '').trim();\n    this.vendorId = asNullableString(this.vendorId);\n    this.commitmentId = asNullableString(this.commitmentId);\n    this.commitmentLineId = asNullableString(this.commitmentLineId);\n    this.paidByProfileId = asNullableString(this.paidByProfileId);\n    this.recordedByProfileId = asNullableString(this.recordedByProfileId);\n  }\n\n  private validateShape(): void {\n    const label = this.id || '<new>';\n    assertMinorUnits('Expense', label, 'amount', this.amount);\n    assertIsoCurrency('Expense', label, this.currency);\n    assertIsoDate('Expense', label, 'incurredOn', this.incurredOn);\n    if (!CATEGORY_PATTERN.test(this.category) || this.category.length > 64) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: category must be lowercase kebab-case ` +\n          `(for example 'outside-service'), got '${this.category}'.`,\n      );\n    }\n    if (Boolean(this.costObjectType) !== Boolean(this.costObjectId)) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: costObjectType and costObjectId are set together ` +\n          'or not at all.',\n      );\n    }\n    if (this.costObjectType) {\n      assertQualifiedClassName('Expense', label, this.costObjectType);\n    }\n    if (this.paidBy !== 'company' && this.paidBy !== 'person') {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: paidBy must be 'company' or 'person'.`,\n      );\n    }\n    if (this.paidBy === 'person' && !this.paidByProfileId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: an expense paid by a person names that person ` +\n          '(paidByProfileId).',\n      );\n    }\n    if (this.paidBy === 'company' && this.paidByProfileId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: paidByProfileId is only set when paidBy is 'person'.`,\n      );\n    }\n    if (this.reimbursable && this.paidBy !== 'person') {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: only an expense a person paid can be owed back.`,\n      );\n    }\n    if (this.reimbursedAt && !this.reimbursable) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: reimbursedAt needs reimbursable.`,\n      );\n    }\n    if (this.reviewStatus === 'reviewed' && this.duplicateOfId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: a reviewed expense cannot be marked a duplicate.`,\n      );\n    }\n    if (this.commitmentLineId && !this.commitmentId) {\n      throw new ExpenseError(\n        'EXPENSE_INVALID',\n        `Expense ${label}: a commitment line needs its commitment ` +\n          '(commitmentId).',\n      );\n    }\n  }\n\n  /**\n   * Read the stored row directly. The authoritative prior state for the\n   * review and lock guards: the in-memory copy may have been mass-assigned.\n   */\n  private async readPersisted(): Promise<PersistedRow | null> {\n    if (!this.id) return null;\n    const row = await this.db.get(this.tableName, { id: this.id });\n    return (row as PersistedRow | null | undefined) ?? null;\n  }\n\n  private reviewState(): ReviewFieldState {\n    return {\n      status: this.reviewStatus,\n      reviewer: asNullableString(this.reviewedByProfileId),\n      reviewedAtMs: instantMs(this.reviewedAt),\n      note: this.reviewNote ?? '',\n      duplicateOf: asNullableString(this.duplicateOfId),\n    };\n  }\n\n  /**\n   * Refuse any review-field change a transition did not authorize. The token\n   * binds the transition's complete resulting state — status, reviewer,\n   * time, note and duplicate marker — so a field set directly beside a\n   * legitimate `review()` / `reject()` cannot ride along with it.\n   */\n  private assertReviewFields(persisted: PersistedRow | null): void {\n    const token = authorizedTransition.get(this);\n    const prior: ReviewFieldState = {\n      status: (persisted?.review_status ?? 'unreviewed') as ExpenseReviewStatus,\n      reviewer: asNullableString(persisted?.reviewed_by_profile_id),\n      reviewedAtMs: instantMs(persisted?.reviewed_at),\n      note: String(persisted?.review_note ?? ''),\n      duplicateOf: asNullableString(persisted?.duplicate_of_id),\n    };\n    const current = this.reviewState();\n    if (sameReviewState(current, prior)) return;\n    if (\n      !token ||\n      token.from !== prior.status ||\n      !sameReviewState(current, token.expected)\n    ) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_FIELDS_LOCKED',\n        `Expense ${this.id || '<new>'}: review state changes only through ` +\n          'review(), reject(), markDuplicate() or reopen().',\n      );\n    }\n  }\n\n  private assertReviewedLock(persisted: PersistedRow | null): void {\n    if (persisted?.review_status !== 'reviewed') return;\n    const self = this as unknown as Record<string, unknown>;\n    for (const [fieldName, column] of LOCKED_WHEN_REVIEWED) {\n      const before = persisted[column];\n      const after = self[fieldName];\n      const same =\n        fieldName === 'amount'\n          ? Number(before) === Number(after)\n          : fieldName === 'recordedAt'\n            ? instantMs(before) === instantMs(after)\n            : asNullableString(before) === asNullableString(after);\n      if (!same) {\n        throw new ExpenseError(\n          'EXPENSE_REVIEW_FIELDS_LOCKED',\n          `Expense ${this.id}: ${fieldName} of a reviewed expense cannot ` +\n            'change; reopen() it first.',\n        );\n      }\n    }\n  }\n\n  /**\n   * A matched commitment must be visible in this expense's tenant, owned by\n   * the same tenant, and in the same currency; a matched line must belong to\n   * it. Mixed currencies are refused here rather than summed later.\n   *\n   * Checked when the match is made or changed, not on every save: a later\n   * change to the commitment (its currency, or its deletion) must not stop\n   * an unrelated save such as recording a reimbursement.\n   */\n  private async assertCommitment(\n    persisted: PersistedRow | null,\n  ): Promise<void> {\n    if (!this.commitmentId) return;\n    if (\n      persisted &&\n      asNullableString(persisted.commitment_id) === this.commitmentId &&\n      asNullableString(persisted.commitment_line_id) ===\n        this.commitmentLineId &&\n      String(persisted.currency ?? '') === this.currency\n    ) {\n      return;\n    }\n    const contracts = await ContractCollection.create({ db: this.db });\n    const commitment = await contracts.get({ id: this.commitmentId });\n    // Before super.save() the tenant interceptor has not populated tenantId\n    // yet, so compare against the tenant the row is about to be written in.\n    const owner = effectiveTenant(this.tenantId);\n    if (!commitment || !sameTenant(commitment.tenantId, owner)) {\n      throw new ExpenseError(\n        'EXPENSE_COMMITMENT_MISMATCH',\n        `Expense ${this.id || '<new>'}: commitment ${this.commitmentId} was ` +\n          \"not found in this expense's tenant.\",\n      );\n    }\n    if (String(commitment.currency).toUpperCase() !== this.currency) {\n      throw new ExpenseError(\n        'EXPENSE_COMMITMENT_MISMATCH',\n        `Expense ${this.id || '<new>'}: currency ${this.currency} does not ` +\n          `match commitment ${this.commitmentId} (${commitment.currency}). ` +\n          'Amounts in different currencies are never summed.',\n      );\n    }\n    if (this.commitmentLineId) {\n      const lines = await ContractLineItemCollection.create({ db: this.db });\n      const line = await lines.get({ id: this.commitmentLineId });\n      if (!line || line.contractId !== this.commitmentId) {\n        throw new ExpenseError(\n          'EXPENSE_COMMITMENT_MISMATCH',\n          `Expense ${this.id || '<new>'}: line ${this.commitmentLineId} is ` +\n            `not a line of commitment ${this.commitmentId}.`,\n        );\n      }\n    }\n  }\n\n  /**\n   * A vendor must be visible in, and owned by, the expense's tenant. A\n   * `crossPackageRef` neither validates its target nor creates a foreign\n   * key, so without this an expense in one tenant could name another\n   * tenant's vendor. Checked when the vendor is set or changed.\n   */\n  private async assertVendor(persisted: PersistedRow | null): Promise<void> {\n    if (!this.vendorId) return;\n    if (persisted && asNullableString(persisted.vendor_id) === this.vendorId) {\n      return;\n    }\n    const vendors = await VendorCollection.create({ db: this.db });\n    const vendor = await vendors.get({ id: this.vendorId });\n    const owner = effectiveTenant(this.tenantId);\n    if (!vendor || !sameTenant(vendor.tenantId, owner)) {\n      throw new ExpenseError(\n        'EXPENSE_VENDOR_MISMATCH',\n        `Expense ${this.id || '<new>'}: vendor ${this.vendorId} was not ` +\n          \"found in this expense's tenant.\",\n      );\n    }\n  }\n\n  private async transition(\n    action: keyof typeof REVIEW_TRANSITIONS,\n    apply: () => void,\n  ): Promise<this> {\n    const rule = REVIEW_TRANSITIONS[action];\n    const persisted = await this.readPersisted();\n    if (!persisted) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id || '<new>'}: save the expense before ${action}().`,\n      );\n    }\n    const from = String(persisted.review_status) as ExpenseReviewStatus;\n    if (!rule.from.includes(from)) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id}: cannot ${action}() an expense that is ${from}.`,\n      );\n    }\n    if (action === 'review' && persisted.duplicate_of_id) {\n      throw new ExpenseError(\n        'EXPENSE_REVIEW_TRANSITION',\n        `Expense ${this.id}: a duplicate cannot be reviewed; reopen() it first.`,\n      );\n    }\n    const snapshot = {\n      reviewStatus: this.reviewStatus,\n      reviewedByProfileId: this.reviewedByProfileId,\n      reviewedAt: this.reviewedAt,\n      reviewNote: this.reviewNote,\n      duplicateOfId: this.duplicateOfId,\n    };\n    // Every transition assigns every review field, so the token below\n    // describes the whole resulting review state.\n    apply();\n    authorizedTransition.set(this, { from, expected: this.reviewState() });\n    try {\n      return await this.save();\n    } catch (error) {\n      Object.assign(this, snapshot);\n      throw error;\n    } finally {\n      authorizedTransition.delete(this);\n    }\n  }\n}\n\nfunction requireReviewer(reviewerProfileId: string | undefined): string {\n  const reviewer = String(reviewerProfileId ?? '').trim();\n  if (!reviewer) {\n    throw new ExpenseError(\n      'EXPENSE_INVALID',\n      'A review decision names its reviewer (reviewerProfileId).',\n    );\n  }\n  return reviewer;\n}\n\nfunction sameTenant(\n  a: string | null | undefined,\n  b: string | null | undefined,\n): boolean {\n  return (a ?? null) === (b ?? null);\n}\n"],"mappings":"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"}