@happyvertical/smrt-commerce 0.57.3 → 0.57.4

package/dist/chunks/HistoricalCustomerFundsCollections-B5x8gTW3.js

@@ -0,0 +1,170 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { t as assertHistoricalCommerceWrite } from "./historical-commerce-internal-C9ButfuH.js";
+import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/models/HistoricalCustomerFunds.ts
+var __defProp$1 = Object.defineProperty;
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp$1(target, key, result);
+	return result;
+};
+var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
+var HistoricalCustomerFunds = class extends SmrtObject {
+	tenantId = "";
+	customerId = "";
+	contractId = null;
+	sourceKeyHash = "";
+	kind = "receipt";
+	origin = "historical";
+	paymentId = null;
+	currency = "";
+	amountMinor = 0;
+	effectiveOn = "";
+	sourceReceiptId = null;
+	sourceCreditNoteId = null;
+	snapshotJson = "";
+	constructor(options = {}) {
+		super(options);
+		for (const key of [
+			"tenantId",
+			"customerId",
+			"contractId",
+			"sourceKeyHash",
+			"kind",
+			"origin",
+			"paymentId",
+			"currency",
+			"amountMinor",
+			"effectiveOn",
+			"sourceReceiptId",
+			"sourceCreditNoteId",
+			"snapshotJson"
+		]) if (options[key] !== void 0) Object.assign(this, { [key]: options[key] });
+	}
+	async save(options) {
+		assertHistoricalCommerceWrite(this);
+		if (!this.tenantId || !this.customerId || !this.sourceKeyHash || !this.snapshotJson || !Number.isSafeInteger(this.amountMinor) || this.amountMinor <= 0) throw new Error("Historical customer funds require complete exact source evidence");
+		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Historical customer funds are immutable");
+		return super.save(options);
+	}
+	async delete() {
+		throw new Error("Historical customer cash evidence cannot be deleted");
+	}
+};
+__publicField$1(HistoricalCustomerFunds, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass$1([tenantId()], HistoricalCustomerFunds.prototype, "tenantId", 2);
+__decorateClass$1([foreignKey("Customer")], HistoricalCustomerFunds.prototype, "customerId", 2);
+__decorateClass$1([foreignKey("Contract", { nullable: true })], HistoricalCustomerFunds.prototype, "contractId", 2);
+__decorateClass$1([foreignKey("Payment", { nullable: true })], HistoricalCustomerFunds.prototype, "paymentId", 2);
+__decorateClass$1([field({ ui: { format: "money" } })], HistoricalCustomerFunds.prototype, "amountMinor", 2);
+__decorateClass$1([foreignKey("HistoricalCustomerFunds", { nullable: true })], HistoricalCustomerFunds.prototype, "sourceReceiptId", 2);
+__decorateClass$1([foreignKey("Invoice", { nullable: true })], HistoricalCustomerFunds.prototype, "sourceCreditNoteId", 2);
+HistoricalCustomerFunds = __decorateClass$1([TenantScoped({ mode: "required" }), smrt({
+	tableName: "historical_customer_funds",
+	indexes: [{
+		name: "historical_customer_funds_source",
+		columns: ["tenantId", "sourceKeyHash"],
+		unique: true
+	}],
+	api: { include: ["get", "list"] },
+	cli: { include: ["get", "list"] },
+	mcp: { include: ["get", "list"] }
+})], HistoricalCustomerFunds);
+//#endregion
+//#region src/models/HistoricalCustomerFundsAllocation.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var HistoricalCustomerFundsAllocation = class extends SmrtObject {
+	tenantId = "";
+	receiptId = null;
+	creditNoteId = null;
+	invoiceId = "";
+	sourceKeyHash = "";
+	amountMinor = 0;
+	effectiveOn = "";
+	origin = "historical";
+	effect = "payment";
+	journalId = null;
+	snapshotJson = "";
+	constructor(options = {}) {
+		super(options);
+		for (const key of [
+			"tenantId",
+			"receiptId",
+			"creditNoteId",
+			"invoiceId",
+			"sourceKeyHash",
+			"amountMinor",
+			"effectiveOn",
+			"origin",
+			"effect",
+			"journalId",
+			"snapshotJson"
+		]) if (options[key] !== void 0) Object.assign(this, { [key]: options[key] });
+	}
+	async save(options) {
+		assertHistoricalCommerceWrite(this);
+		if (!this.tenantId || !this.invoiceId || !this.sourceKeyHash || !this.snapshotJson || !Number.isSafeInteger(this.amountMinor) || this.amountMinor <= 0 || Boolean(this.receiptId) === Boolean(this.creditNoteId)) throw new Error("Historical funds allocation requires one exact source and an owned invoice");
+		if (this.id && await this.db.get(this.tableName, { id: this.id })) throw new Error("Historical customer funds applications are immutable");
+		return super.save(options);
+	}
+	async delete() {
+		throw new Error("Historical customer funds applications cannot be deleted");
+	}
+};
+__publicField(HistoricalCustomerFundsAllocation, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass([tenantId()], HistoricalCustomerFundsAllocation.prototype, "tenantId", 2);
+__decorateClass([foreignKey("HistoricalCustomerFunds", { nullable: true })], HistoricalCustomerFundsAllocation.prototype, "receiptId", 2);
+__decorateClass([foreignKey("Invoice", { nullable: true })], HistoricalCustomerFundsAllocation.prototype, "creditNoteId", 2);
+__decorateClass([foreignKey("Invoice")], HistoricalCustomerFundsAllocation.prototype, "invoiceId", 2);
+__decorateClass([field({ ui: { format: "money" } })], HistoricalCustomerFundsAllocation.prototype, "amountMinor", 2);
+__decorateClass([crossPackageRef("@happyvertical/smrt-ledgers:Journal", { nullable: true })], HistoricalCustomerFundsAllocation.prototype, "journalId", 2);
+HistoricalCustomerFundsAllocation = __decorateClass([TenantScoped({ mode: "required" }), smrt({
+	tableName: "historical_customer_funds_allocations",
+	indexes: [{
+		name: "historical_funds_allocation_source",
+		columns: ["tenantId", "sourceKeyHash"],
+		unique: true
+	}],
+	api: { include: ["get", "list"] },
+	cli: { include: ["get", "list"] },
+	mcp: { include: ["get", "list"] }
+})], HistoricalCustomerFundsAllocation);
+//#endregion
+//#region src/collections/HistoricalCustomerFundsCollections.ts
+var HistoricalCustomerFundsCollections_exports = /* @__PURE__ */ __exportAll({
+	HistoricalCustomerFundsAllocationCollection: () => HistoricalCustomerFundsAllocationCollection,
+	HistoricalCustomerFundsCollection: () => HistoricalCustomerFundsCollection
+});
+var HistoricalCustomerFundsCollection = class extends SmrtCollection {
+	static _itemClass = HistoricalCustomerFunds;
+};
+var HistoricalCustomerFundsAllocationCollection = class extends SmrtCollection {
+	static _itemClass = HistoricalCustomerFundsAllocation;
+};
+//#endregion
+export { HistoricalCustomerFunds as a, HistoricalCustomerFundsAllocation as i, HistoricalCustomerFundsCollection as n, HistoricalCustomerFundsCollections_exports as r, HistoricalCustomerFundsAllocationCollection as t };
+
+//# sourceMappingURL=HistoricalCustomerFundsCollections-B5x8gTW3.js.map

package/dist/chunks/HistoricalCustomerFundsCollections-B5x8gTW3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalCustomerFundsCollections-B5x8gTW3.js","names":[],"sources":["../../src/models/HistoricalCustomerFunds.ts","../../src/models/HistoricalCustomerFundsAllocation.ts","../../src/collections/HistoricalCustomerFundsCollections.ts"],"sourcesContent":["import {\n  field,\n  foreignKey,\n  SmrtObject,\n  type SmrtObjectOptions,\n  type SmrtSaveOptions,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport { assertHistoricalCommerceWrite } from '../historical-commerce-internal.js';\nexport interface HistoricalCustomerFundsOptions extends SmrtObjectOptions {\n  tenantId?: string;\n  customerId?: string;\n  contractId?: string | null;\n  sourceKeyHash?: string;\n  kind?: 'receipt' | 'refund';\n  origin?: 'historical' | 'live';\n  paymentId?: string | null;\n  currency?: string;\n  amountMinor?: number;\n  effectiveOn?: string;\n  sourceReceiptId?: string | null;\n  sourceCreditNoteId?: string | null;\n  snapshotJson?: string;\n}\n/** Retained original cash evidence. It is deliberately not a completed ledger-backed Payment. */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  tableName: 'historical_customer_funds',\n  indexes: [\n    {\n      name: 'historical_customer_funds_source',\n      columns: ['tenantId', 'sourceKeyHash'],\n      unique: true,\n    },\n  ],\n  api: { include: ['get', 'list'] },\n  cli: { include: ['get', 'list'] },\n  mcp: { include: ['get', 'list'] },\n})\nexport class HistoricalCustomerFunds extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId() tenantId = '';\n  @foreignKey('Customer') customerId = '';\n  @foreignKey('Contract', { nullable: true }) contractId: string | null = null;\n  sourceKeyHash = '';\n  kind: 'receipt' | 'refund' = 'receipt';\n  origin: 'historical' | 'live' = 'historical';\n  @foreignKey('Payment', { nullable: true }) paymentId: string | null = null;\n  currency = '';\n  @field({ ui: { format: 'money' } }) amountMinor = 0;\n  effectiveOn = '';\n  @foreignKey('HistoricalCustomerFunds', { nullable: true }) sourceReceiptId:\n    | string\n    | null = null;\n  @foreignKey('Invoice', { nullable: true }) sourceCreditNoteId: string | null =\n    null;\n  snapshotJson = '';\n  constructor(options: HistoricalCustomerFundsOptions = {}) {\n    super(options);\n    for (const key of [\n      'tenantId',\n      'customerId',\n      'contractId',\n      'sourceKeyHash',\n      'kind',\n      'origin',\n      'paymentId',\n      'currency',\n      'amountMinor',\n      'effectiveOn',\n      'sourceReceiptId',\n      'sourceCreditNoteId',\n      'snapshotJson',\n    ] as const)\n      if (options[key] !== undefined)\n        Object.assign(this, { [key]: options[key] });\n  }\n  override async save(options?: SmrtSaveOptions): Promise<this> {\n    assertHistoricalCommerceWrite(this);\n    if (\n      !this.tenantId ||\n      !this.customerId ||\n      !this.sourceKeyHash ||\n      !this.snapshotJson ||\n      !Number.isSafeInteger(this.amountMinor) ||\n      this.amountMinor <= 0\n    )\n      throw new Error(\n        'Historical customer funds require complete exact source evidence',\n      );\n    if (this.id && (await this.db.get(this.tableName, { id: this.id })))\n      throw new Error('Historical customer funds are immutable');\n    return super.save(options);\n  }\n  override async delete(): Promise<void> {\n    throw new Error('Historical customer cash evidence cannot be deleted');\n  }\n}\n","import {\n  crossPackageRef,\n  field,\n  foreignKey,\n  SmrtObject,\n  type SmrtObjectOptions,\n  type SmrtSaveOptions,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport { TenantScoped, tenantId } from '@happyvertical/smrt-tenancy';\nimport { assertHistoricalCommerceWrite } from '../historical-commerce-internal.js';\nexport interface HistoricalCustomerFundsAllocationOptions\n  extends SmrtObjectOptions {\n  tenantId?: string;\n  receiptId?: string | null;\n  creditNoteId?: string | null;\n  invoiceId?: string;\n  sourceKeyHash?: string;\n  amountMinor?: number;\n  effectiveOn?: string;\n  origin?: 'historical' | 'live';\n  effect?: 'payment' | 'credit-audit' | 'refund-audit';\n  journalId?: string | null;\n  snapshotJson?: string;\n}\n/** Original applications have concrete identities; credit-audit records never count twice. */\n@TenantScoped({ mode: 'required' })\n@smrt({\n  tableName: 'historical_customer_funds_allocations',\n  indexes: [\n    {\n      name: 'historical_funds_allocation_source',\n      columns: ['tenantId', 'sourceKeyHash'],\n      unique: true,\n    },\n  ],\n  api: { include: ['get', 'list'] },\n  cli: { include: ['get', 'list'] },\n  mcp: { include: ['get', 'list'] },\n})\nexport class HistoricalCustomerFundsAllocation extends SmrtObject { static __smrtPackage__ = \"@happyvertical/smrt-commerce\";\n  @tenantId() tenantId = '';\n  @foreignKey('HistoricalCustomerFunds', { nullable: true }) receiptId:\n    | string\n    | null = null;\n  @foreignKey('Invoice', { nullable: true }) creditNoteId: string | null = null;\n  @foreignKey('Invoice') invoiceId = '';\n  sourceKeyHash = '';\n  @field({ ui: { format: 'money' } }) amountMinor = 0;\n  effectiveOn = '';\n  origin: 'historical' | 'live' = 'historical';\n  effect: 'payment' | 'credit-audit' | 'refund-audit' = 'payment';\n  @crossPackageRef('@happyvertical/smrt-ledgers:Journal', { nullable: true })\n  journalId: string | null = null;\n  snapshotJson = '';\n  constructor(options: HistoricalCustomerFundsAllocationOptions = {}) {\n    super(options);\n    for (const key of [\n      'tenantId',\n      'receiptId',\n      'creditNoteId',\n      'invoiceId',\n      'sourceKeyHash',\n      'amountMinor',\n      'effectiveOn',\n      'origin',\n      'effect',\n      'journalId',\n      'snapshotJson',\n    ] as const)\n      if (options[key] !== undefined)\n        Object.assign(this, { [key]: options[key] });\n  }\n  override async save(options?: SmrtSaveOptions): Promise<this> {\n    assertHistoricalCommerceWrite(this);\n    if (\n      !this.tenantId ||\n      !this.invoiceId ||\n      !this.sourceKeyHash ||\n      !this.snapshotJson ||\n      !Number.isSafeInteger(this.amountMinor) ||\n      this.amountMinor <= 0 ||\n      Boolean(this.receiptId) === Boolean(this.creditNoteId)\n    )\n      throw new Error(\n        'Historical funds allocation requires one exact source and an owned invoice',\n      );\n    if (this.id && (await this.db.get(this.tableName, { id: this.id })))\n      throw new Error('Historical customer funds applications are immutable');\n    return super.save(options);\n  }\n  override async delete(): Promise<void> {\n    throw new Error('Historical customer funds applications cannot be deleted');\n  }\n}\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport { HistoricalCustomerFunds } from '../models/HistoricalCustomerFunds.js';\nimport { HistoricalCustomerFundsAllocation } from '../models/HistoricalCustomerFundsAllocation.js';\nexport class HistoricalCustomerFundsCollection extends SmrtCollection<HistoricalCustomerFunds> {\n  static readonly _itemClass = HistoricalCustomerFunds;\n}\nexport class HistoricalCustomerFundsAllocationCollection extends SmrtCollection<HistoricalCustomerFundsAllocation> {\n  static readonly _itemClass = HistoricalCustomerFundsAllocation;\n}\n"],"mappings":"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"}

package/dist/chunks/{InvoiceCollection-cinzAqt6.js → InvoiceCollection-BIcge9Wl.js}

@@ -1,11 +1,92 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { s as InvoiceStatus } from "./types-Bbm0Xflc.js";
-import { i as claimAllocationParent, r as assertAllocationParent } from "./allocation-integrity-WmWyXhtG.js";
+import { i as claimAllocationParent, r as assertAllocationParent } from "./allocation-integrity-DJ7-LY1j.js";
 import { MoneyValidationError, assertIntegerMinorUnits } from "../money.js";
-import { a as assertCommerceMoneySchemaCurrent, f as DOCUMENT_MONEY_READ_REBIND, p as DOCUMENT_MONEY_WRITE } from "./detect-CY9ufaFb.js";
-import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-6TlqUeVj.js";
+import { a as assertCommerceMoneySchemaCurrent, f as DOCUMENT_MONEY_READ_REBIND, p as DOCUMENT_MONEY_WRITE } from "./detect-DAE-_NAk.js";
+import { n as withTenantMoneyCollectionRead } from "./tenant-money-barrier-DoF6lR8h.js";
 import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, smrt } from "@happyvertical/smrt-core";
 import { TenantScoped, getTenantId, queryGlobal, queryWithGlobals, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/retention-money.ts
+function invalid(message) {
+	throw new MoneyValidationError("INVALID_MONEY_INPUT", message);
+}
+function assertRetentionMinor(amount, label) {
+	if (!Number.isSafeInteger(amount)) invalid(`${label} must be a safe integer minor-unit amount`);
+}
+function validateRetentionEvidence(input) {
+	for (const key of [
+		"requestId",
+		"policyVersion",
+		"evidenceRef",
+		"actorId",
+		"reason"
+	]) {
+		const value = input[key];
+		if (typeof value !== "string" || !value || value.trim() !== value) invalid(`Retention ${key} must be nonempty trimmed text`);
+	}
+}
+function parseInvoiceRetention(json) {
+	if (json === "") return null;
+	let state;
+	try {
+		state = JSON.parse(json);
+	} catch {
+		return invalid("Invalid retention state JSON");
+	}
+	if (!state || state.version !== 1 || state.creditPolicy !== "retained-first" || !Array.isArray(state.releases)) invalid("Unsupported retention state or credit policy");
+	validateRetentionEvidence(state);
+	if (!/^[A-Z]{3}$/.test(state.currency)) invalid("Retention currency is required");
+	const keys = /* @__PURE__ */ new Set([state.requestId]);
+	for (const event of [state, ...state.releases]) {
+		validateRetentionEvidence(event);
+		if (typeof event.recordedAt !== "string" || !Number.isFinite(Date.parse(event.recordedAt))) invalid("Retention event timestamp is required");
+		if (event.effectiveOn !== void 0 && (!/^\d{4}-\d{2}-\d{2}$/.test(event.effectiveOn) || !Number.isFinite(Date.parse(event.effectiveOn)) || new Date(event.effectiveOn).toISOString().slice(0, 10) !== event.effectiveOn)) invalid("Original retention event requires an exact calendar date");
+		if (event.sameDayCreditOrder !== void 0 && event.sameDayCreditOrder !== null && event.sameDayCreditOrder !== "release-before-credit" && event.sameDayCreditOrder !== "credit-before-release") invalid("Unsupported original retention release/credit ordering");
+		if (event !== state) {
+			if (keys.has(event.requestId)) invalid("Duplicate retention request identity");
+			keys.add(event.requestId);
+		}
+	}
+	return state;
+}
+function calculateInvoicePayable(input) {
+	for (const [name, amount] of Object.entries({
+		gross: input.totalAmount,
+		credits: input.creditedAmount,
+		paid: input.amountPaid
+	})) {
+		assertRetentionMinor(amount, name);
+		if (amount < 0) invalid(`${name} cannot be negative`);
+	}
+	if (input.creditedAmount > input.totalAmount || input.amountPaid > input.totalAmount) invalid("Credits or payments exceed invoice gross");
+	const state = parseInvoiceRetention(input.retentionStateJson ?? "");
+	const retained = state?.retainedMinor ?? 0;
+	assertRetentionMinor(retained, "Retained amount");
+	if (retained < 0 || retained > input.totalAmount) invalid("Retention exceeds invoice gross");
+	if (state && state.currency !== input.currency) invalid("Retention currency does not match invoice");
+	let released = 0n;
+	for (const event of state?.releases ?? []) {
+		assertRetentionMinor(event.amountMinor, "Released amount");
+		if (event.amountMinor <= 0) invalid("Release amount must be positive");
+		released += BigInt(event.amountMinor);
+	}
+	if (released > BigInt(retained)) invalid("Releases exceed retained amount");
+	const unreleased = retained - Number(released);
+	const creditedRetention = Math.min(unreleased, input.creditedAmount);
+	const remaining = unreleased - creditedRetention;
+	const cap = Math.max(0, input.totalAmount - input.creditedAmount - remaining);
+	return {
+		grossMinor: input.totalAmount,
+		retainedMinor: retained,
+		releasedMinor: Number(released),
+		creditedRetentionMinor: creditedRetention,
+		retainedRemainingMinor: remaining,
+		allocationCapMinor: cap,
+		grossBalanceMinor: input.totalAmount - input.creditedAmount - input.amountPaid,
+		currentlyDueMinor: Math.max(0, cap - input.amountPaid)
+	};
+}
+//#endregion
 //#region src/models/Invoice.ts
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -77,6 +158,9 @@ var INVOICE_STATUS_TRANSITIONS = {
 };
 var loadedInvoiceStatus = /* @__PURE__ */ new WeakMap();
 var Invoice = class extends SmrtObject {
+	moneyAuthority = "calculated";
+	historicalSalesMoneyJson = "";
+	historicalSourceKeyHash = null;
 	/** @internal Collection read guard returns this snapshot on its root DB. */
 	rebindMoneyRead(capability, db) {
 		if (capability !== DOCUMENT_MONEY_READ_REBIND) throw new MoneyValidationError("FROZEN_DOCUMENT", "Invoice read rebinding requires the owning capability");
@@ -87,6 +171,12 @@ var Invoice = class extends SmrtObject {
 	kind = "invoice";
 	creditedInvoiceId = null;
 	creditedAmount = 0;
+	/** Server-owned immutable retention policy and append-only release evidence. */
+	retentionStateJson = "";
+	retentionAccountingStateJson = "";
+	getPayableFacts() {
+		return calculateInvoicePayable(this);
+	}
 	tenantId = null;
 	customerId = "";
 	contractId = "";
@@ -180,6 +270,9 @@ var Invoice = class extends SmrtObject {
 		super(options);
 		if (options.kind !== void 0) this.kind = options.kind;
 		if (options.creditedInvoiceId !== void 0) this.creditedInvoiceId = options.creditedInvoiceId;
+		if (options.moneyAuthority !== void 0) this.moneyAuthority = options.moneyAuthority;
+		if (options.historicalSalesMoneyJson !== void 0) this.historicalSalesMoneyJson = options.historicalSalesMoneyJson;
+		if (options.historicalSourceKeyHash !== void 0) this.historicalSourceKeyHash = options.historicalSourceKeyHash;
 		if (options.creditedAmount !== void 0) this.creditedAmount = options.creditedAmount;
 		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
 		if (options.customerId !== void 0) this.customerId = options.customerId;
@@ -231,7 +324,7 @@ var Invoice = class extends SmrtObject {
 	async initialize() {
 		await super.initialize();
 		if (this.isPersisted) {
-			const { assertHydratedMoneyRowCurrent } = await import("./detect-CY9ufaFb.js").then((n) => n.c);
+			const { assertHydratedMoneyRowCurrent } = await import("./detect-DAE-_NAk.js").then((n) => n.c);
 			await assertHydratedMoneyRowCurrent(this);
 		}
 		if (await this.isSaved()) loadedInvoiceStatus.set(this, this.status);
@@ -254,7 +347,7 @@ var Invoice = class extends SmrtObject {
 	*  - **Status transitions** are validated against the prior persisted status.
 	*/
 	async save() {
-		const { saveInvoice } = await import("./document-money-DV5t4vlK.js").then((n) => n.t);
+		const { saveInvoice } = await import("./DocumentTaxCollection-C42x0YLW.js").then((n) => n.y);
 		return await saveInvoice(this);
 	}
 	/** @internal Aggregate persistence only. */
@@ -272,6 +365,10 @@ var Invoice = class extends SmrtObject {
 		this.assertNonNegativeAmounts();
 		this.assertStatusTransition(prior);
 		this.assertPaymentStatusConsistent();
+		const payable = calculateInvoicePayable(this);
+		if (this.retentionAccountingStateJson && [InvoiceStatus.CANCELLED, InvoiceStatus.WRITTEN_OFF].includes(this.status)) throw new MoneyValidationError("ACCOUNTING_SYNC_RECONCILIATION_REQUIRED", "Provider retention cannot be voided or written off without an explicit reconciled reversal contract");
+		if (this.retentionAccountingStateJson && (this.collectionMethod || this.providerTaxAmount)) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Retention accounting does not support provider collection or tax overrides");
+		if (payable.retainedRemainingMinor > 0 && !this.retentionAccountingStateJson && (this.externalId || this.externalProvider || this.accountingSyncStateJson || this.collectionMethod || this.providerTaxAmount)) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Unreleased retention requires an explicit provider retention contract");
 		await this.assertDraftDeliveryHistory(persisted);
 		await assertAllocationParent(this, "invoice");
 		const result = await super.save();
@@ -279,7 +376,7 @@ var Invoice = class extends SmrtObject {
 		return result;
 	}
 	async delete(options = {}) {
-		const { deleteInvoice } = await import("./document-money-DV5t4vlK.js").then((n) => n.t);
+		const { deleteInvoice } = await import("./DocumentTaxCollection-C42x0YLW.js").then((n) => n.y);
 		await deleteInvoice(this, options);
 	}
 	/** @internal Aggregate persistence only. */
@@ -304,7 +401,7 @@ var Invoice = class extends SmrtObject {
 		return loadedInvoiceStatus.get(this);
 	}
 	async recomputeAmountPaid() {
-		const { PaymentAllocationCollection } = await import("../index.js").then((n) => n.n);
+		const { PaymentAllocationCollection } = await import("./retention-accounting-Brdj9x-V.js").then((n) => n.x);
 		const allocationCollection = await PaymentAllocationCollection.create({
 			...this.options,
 			db: this.db
@@ -438,15 +535,16 @@ var Invoice = class extends SmrtObject {
 	* Check if invoice is overdue
 	*/
 	isOverdue() {
+		if (this.getAmountDue() === 0) return false;
 		if (this.status === InvoiceStatus.OVERDUE) return true;
 		if (this.isPaid() || this.status === InvoiceStatus.CANCELLED) return false;
-		return /* @__PURE__ */ new Date() > this.dueDate;
+		return this.dueDate !== null && /* @__PURE__ */ new Date() > this.dueDate;
 	}
 	/**
 	* Get remaining amount due
 	*/
 	getAmountDue() {
-		return Math.max(0, this.getBalance());
+		return this.getPayableFacts().currentlyDueMinor;
 	}
 	/** Signed amount still owed after payments and issued credit notes. */
 	getBalance() {
@@ -489,7 +587,7 @@ var Invoice = class extends SmrtObject {
 		this.amountPaid = amountPaid;
 		if (this.status === InvoiceStatus.CANCELLED || this.status === InvoiceStatus.WRITTEN_OFF) return;
 		if (this.isFullyPaid()) {
-			if (this.status !== InvoiceStatus.PAID || !this.paidDate) this.paidDate = /* @__PURE__ */ new Date();
+			if (this.moneyAuthority !== "historical" && (this.status !== InvoiceStatus.PAID || !this.paidDate)) this.paidDate = /* @__PURE__ */ new Date();
 			this.status = InvoiceStatus.PAID;
 		} else if (amountPaid + this.creditedAmount > 0) {
 			this.status = InvoiceStatus.PARTIAL;
@@ -497,7 +595,7 @@ var Invoice = class extends SmrtObject {
 		} else {
 			this.paidDate = null;
 			if (this.viewedAt) this.status = InvoiceStatus.VIEWED;
-			else if (this.sentAt) this.status = InvoiceStatus.SENT;
+			else if (this.sentAt || this.moneyAuthority === "historical") this.status = InvoiceStatus.SENT;
 			else this.status = InvoiceStatus.DRAFT;
 		}
 	}
@@ -510,7 +608,7 @@ var Invoice = class extends SmrtObject {
 	}
 	/** Cancel a posted invoice with an exact atomic journal reversal. */
 	async cancelWithRevenueReversal(options) {
-		const { cancelInvoiceWithRevenueReversal, rebindJournal } = await import("./invoice-posting-C2i5dOVZ.js");
+		const { cancelInvoiceWithRevenueReversal, rebindJournal } = await import("./invoice-posting-BeTPw3h9.js");
 		return rebindJournal(this.db, await cancelInvoiceWithRevenueReversal(this, options));
 	}
 	/**
@@ -541,7 +639,7 @@ var Invoice = class extends SmrtObject {
 	* ```
 	*/
 	async recognizeRevenue(options) {
-		const { recognizeInvoiceRevenue, rebindJournal } = await import("./invoice-posting-C2i5dOVZ.js");
+		const { recognizeInvoiceRevenue, rebindJournal } = await import("./invoice-posting-BeTPw3h9.js");
 		return rebindJournal(this.db, await recognizeInvoiceRevenue(this, options));
 	}
 	/**
@@ -579,7 +677,7 @@ var Invoice = class extends SmrtObject {
 	async toAccountingInput(options) {
 		if (!options) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Accounting conversion requires explicit realm mapping");
 		if (!this.id || !this.tenantId) throw new MoneyValidationError("INVALID_MONEY_INPUT", "Accounting conversion requires a persisted tenant invoice");
-		const { toFrozenInvoiceAccountingInput } = await import("../index.js").then((n) => n.t);
+		const { toFrozenInvoiceAccountingInput } = await import("./retention-accounting-Brdj9x-V.js").then((n) => n.m);
 		return toFrozenInvoiceAccountingInput({
 			db: this.db,
 			tenantId: this.tenantId,
@@ -589,15 +687,25 @@ var Invoice = class extends SmrtObject {
 	}
 };
 __publicField(Invoice, "__smrtPackage__", "@happyvertical/smrt-commerce");
+__decorateClass([field({ description: "Whether amounts were calculated or retained from an original issued invoice." })], Invoice.prototype, "moneyAuthority", 2);
+__decorateClass([field({
+	type: "text",
+	nullable: true
+})], Invoice.prototype, "historicalSourceKeyHash", 2);
 __decorateClass([field({ description: "Invoice or customer credit note." })], Invoice.prototype, "kind", 2);
 __decorateClass([foreignKey("Invoice", { nullable: true })], Invoice.prototype, "creditedInvoiceId", 2);
 __decorateClass([field({ ui: { format: "money" } })], Invoice.prototype, "creditedAmount", 2);
+__decorateClass([field({ sensitive: true })], Invoice.prototype, "retentionAccountingStateJson", 2);
 __decorateClass([tenantId({ nullable: true })], Invoice.prototype, "tenantId", 2);
 __decorateClass([field({ description: "The customer being billed." }), foreignKey("Customer")], Invoice.prototype, "customerId", 2);
 __decorateClass([field({ description: "The order or agreement this invoice bills for, if any." }), foreignKey("SalesContract", { validateSubtype: true })], Invoice.prototype, "contractId", 2);
 __decorateClass([field({ description: "The number printed on the invoice." })], Invoice.prototype, "invoiceNumber", 2);
 __decorateClass([field({ description: "The date the invoice was issued." })], Invoice.prototype, "issueDate", 2);
-__decorateClass([field({ description: "The date payment is expected." })], Invoice.prototype, "dueDate", 2);
+__decorateClass([field({
+	type: "datetime",
+	nullable: true,
+	description: "The date payment is expected; null when the original source did not establish it."
+})], Invoice.prototype, "dueDate", 2);
 __decorateClass([field({ description: "The date it was paid in full." })], Invoice.prototype, "paidDate", 2);
 __decorateClass([field({
 	description: "The amount before tax.",
@@ -671,7 +779,12 @@ Invoice = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
 			exportName: "serializeInvoiceMcpGet"
 		} }
 	},
-	cli: { skipApiCheck: true }
+	cli: { skipApiCheck: true },
+	indexes: [{
+		name: "invoice_historical_source_identity",
+		columns: ["tenantId", "historicalSourceKeyHash"],
+		unique: true
+	}]
 })], Invoice);
 //#endregion
 //#region src/collections/InvoiceCollection.ts
@@ -931,6 +1044,6 @@ var InvoiceCollection = class extends SmrtCollection {
 	}
 };
 //#endregion
-export { Invoice as i, InvoiceCollection_exports as n, UNPAID_STATUSES as r, InvoiceCollection as t };
+export { assertRetentionMinor as a, validateRetentionEvidence as c, Invoice as i, InvoiceCollection_exports as n, calculateInvoicePayable as o, UNPAID_STATUSES as r, parseInvoiceRetention as s, InvoiceCollection as t };
 
-//# sourceMappingURL=InvoiceCollection-cinzAqt6.js.map
+//# sourceMappingURL=InvoiceCollection-BIcge9Wl.js.map