@happyvertical/smrt-commerce 0.57.9 → 0.57.11

package/dist/chunks/{retention-accounting-Ct5Df6xx.js → retention-accounting-DGuXzt9g.js}

@@ -1,20 +1,31 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { Y as InvoiceLineItemCollection, t as DocumentTaxCollection, x as lockAndReloadInvoice } from "./DocumentTaxCollection-Dg942m_Z.js";
+import { Y as InvoiceLineItemCollection, t as DocumentTaxCollection, x as lockAndReloadInvoice } from "./DocumentTaxCollection-D85ut-Fo.js";
 import { d as PaymentStatus, s as InvoiceStatus, u as PaymentMethod } from "./types-Bbm0Xflc.js";
 import { o as minorToMajorUnits } from "./units-8ElbjVZK.js";
 import { i as withOrdinaryAccountingAuthority, n as withRetentionAccountingAuthority, r as hasOrdinaryAccountingAuthority, t as hasRetentionAccountingAuthority } from "./retention-accounting-internal-DNxLLVvK.js";
-import { i as claimAllocationParent, n as allocationTotal, r as assertAllocationParent, t as allocationOwner } from "./allocation-integrity-Kr8uceRx.js";
+import { i as claimAllocationParent, n as allocationTotal, r as assertAllocationParent, t as allocationOwner } from "./allocation-integrity-B2SyO1mu.js";
 import { n as customerFundsState, t as assertCustomerFundsWrite } from "./customer-funds-internal-BQzoJXK5.js";
 import { MoneyValidationError, assertIntegerMinorUnits, calculateMoneyDocument } from "../money.js";
 import { t as HistoricalCustomerFundsAllocationCollection } from "./HistoricalCustomerFundsCollections-B5x8gTW3.js";
 import { n as calculateAvailableRefund } from "./credit-allocation-yspz0Lab.js";
 import { _ as withDocumentMoneyTransaction, m as isMoneyTransaction, p as DOCUMENT_MONEY_WRITE } from "./detect-DAE-_NAk.js";
-import { c as validateRetentionEvidence, o as calculateInvoicePayable, s as parseInvoiceRetention, t as InvoiceCollection } from "./InvoiceCollection-XPcPyibo.js";
-import { t as lockTenantMoneyRuntime } from "./tenant-money-barrier-CG78Xxja.js";
+import { c as validateRetentionEvidence, o as calculateInvoicePayable, s as parseInvoiceRetention, t as InvoiceCollection } from "./InvoiceCollection-Datg_eZM.js";
+import { t as lockTenantMoneyRuntime } from "./tenant-money-barrier-DXnJWxiZ.js";
 import { SmrtCollection, SmrtObject, crossPackageRef, field, foreignKey, isPostgresDatabase, smrt } from "@happyvertical/smrt-core";
 import { TenantScoped, getTenantId, queryGlobal, queryWithGlobals, tenantId } from "@happyvertical/smrt-tenancy";
+import { AsyncLocalStorage } from "node:async_hooks";
 import { createHash, randomUUID } from "node:crypto";
 import { prepareQuickBooksCreditMemoRequest, prepareQuickBooksInvoiceRequest, prepareQuickBooksReceivableRequest, requireCreditMemoOperations } from "@happyvertical/accounting";
+//#region src/connected-payments-internal.ts
+var authority = new AsyncLocalStorage();
+function withConnectedPaymentAuthority(tenantId, operation) {
+	return authority.run({ tenantId: tenantId.toLowerCase() }, operation);
+}
+function hasConnectedPaymentAuthority(tenantId) {
+	const current = authority.getStore();
+	return !!current && typeof tenantId === "string" && current.tenantId === tenantId.toLowerCase();
+}
+//#endregion
 //#region src/models/Payment.ts
 var __defProp$1 = Object.defineProperty;
 var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
@@ -139,6 +150,37 @@ var Payment = class extends SmrtObject {
 	* negative) when accepting payment in a volatile native currency (#2401).
 	*/
 	usdAtConfirmation = 0;
+	/**
+	* Connected provider account (for example a Stripe `acct_...`) a direct
+	* charge was made on, so the funds landed with the tenant rather than the
+	* platform (#3831). Empty for platform-account and non-Connect payments.
+	* Server-managed: written only by the connected-payments commands.
+	*/
+	connectedAccountId = "";
+	/**
+	* Platform application fee the provider withheld from this direct charge,
+	* in integer minor units of {@link currency} (#3831). Settled at source, so
+	* {@link recordPayment} books it as a fee expense, never as a payable.
+	* Server-managed.
+	*/
+	applicationFeeCents = 0;
+	/**
+	* For a `refund` of a connected charge, the `Payment` it refunds (#3831).
+	* Server-managed.
+	*/
+	refundOfPaymentId = "";
+	/**
+	* For a `refund` of a connected charge, the provider's refund state:
+	* `requested` (recorded before the provider is asked), `pending` until the
+	* provider confirms it, then `succeeded` (journaled) or `failed` (#3831).
+	* Server-managed.
+	*/
+	connectedRefundState = "";
+	/**
+	* For a `refund` of a connected charge, whether the platform's application
+	* fee was refunded with it (#3831). Server-managed and frozen.
+	*/
+	applicationFeeRefunded = false;
 	constructor(options = {}) {
 		super(options);
 		if (options.kind !== void 0) this.kind = options.kind;
@@ -164,6 +206,11 @@ var Payment = class extends SmrtObject {
 		if (options.nativeCurrency !== void 0) this.nativeCurrency = options.nativeCurrency;
 		if (options.usdAtQuote !== void 0) this.usdAtQuote = options.usdAtQuote;
 		if (options.usdAtConfirmation !== void 0) this.usdAtConfirmation = options.usdAtConfirmation;
+		if (options.connectedAccountId !== void 0) this.connectedAccountId = options.connectedAccountId;
+		if (options.applicationFeeCents !== void 0) this.applicationFeeCents = options.applicationFeeCents;
+		if (options.refundOfPaymentId !== void 0) this.refundOfPaymentId = options.refundOfPaymentId;
+		if (options.connectedRefundState !== void 0) this.connectedRefundState = options.connectedRefundState;
+		if (options.applicationFeeRefunded !== void 0) this.applicationFeeRefunded = options.applicationFeeRefunded;
 	}
 	/**
 	* Capture the persisted status the row was loaded with, so the save-time
@@ -209,14 +256,19 @@ var Payment = class extends SmrtObject {
 				["amount", this.amount],
 				["nativeAmount", this.nativeAmount],
 				["usdAtQuote", this.usdAtQuote],
-				["usdAtConfirmation", this.usdAtConfirmation]
+				["usdAtConfirmation", this.usdAtConfirmation],
+				["applicationFeeCents", this.applicationFeeCents]
 			]);
+			if (this.applicationFeeCents < 0 || this.applicationFeeCents > this.amount) throw new Error("Payment applicationFeeCents must be between 0 and the payment amount");
+			if (this.applicationFeeCents > 0 && !this.connectedAccountId) throw new Error("Payment applicationFeeCents requires a connectedAccountId");
 			const priorRow = await this.loadPersistedRow();
 			if (this.customerFundsJson || priorRow?.customer_funds_json) assertCustomerFundsWrite(this);
 			const ordinaryBinding = this.ordinaryAccountingBindingJson || String(priorRow?.ordinary_accounting_binding_json ?? "");
 			if (ordinaryBinding && !hasOrdinaryAccountingAuthority(this.tenantId, JSON.parse(ordinaryBinding).invoiceId)) throw new Error("Provider-recorded refund is immutable; use an explicit reversal workflow");
 			const retainedBinding = this.retentionAccountingBindingJson || String(priorRow?.retention_accounting_binding_json ?? "");
 			if (retainedBinding && !hasRetentionAccountingAuthority(this.tenantId, JSON.parse(retainedBinding).invoiceId)) throw new Error("Provider-recorded refund is immutable; use an explicit reversal workflow");
+			if ((this.connectedAccountId || String(priorRow?.connected_account_id ?? "")) && !hasConnectedPaymentAuthority(this.tenantId)) throw new Error("Connected payments and refunds are written only by the connected-payments commands");
+			if (priorRow && String(priorRow.connected_account_id ?? "")) this.assertConnectedIdentityUnchanged(priorRow);
 			const prior = priorRow && priorRow.status != null ? priorRow.status : loadedPaymentStatus.get(this);
 			this.assertStatusTransition(prior);
 			if (this.status === PaymentStatus.COMPLETED && prior !== PaymentStatus.COMPLETED && !settlementInProgress.has(this)) throw new Error(`Payment ${this.id || "<new>"}: cannot set status to COMPLETED via raw assignment \u2014 a Payment is only completed through recordPayment(), which posts a balanced settlement journal. Use recordPayment() instead of setting status directly.`);
@@ -236,8 +288,65 @@ var Payment = class extends SmrtObject {
 		const persisted = await this.loadPersistedRow();
 		if (this.retentionAccountingBindingJson || persisted?.retention_accounting_binding_json || this.ordinaryAccountingBindingJson || persisted?.ordinary_accounting_binding_json) throw new Error("Provider-recorded refund history cannot be deleted");
 		if (this.customerFundsJson || persisted?.customer_funds_json) throw new Error("Customer funds cash history cannot be deleted");
+		if (this.connectedAccountId || persisted?.connected_account_id) throw new Error("Connected payment and refund history cannot be deleted");
 		return super.delete(options);
 	}
+	/** See the connected-row guard in {@link save}. */
+	assertConnectedIdentityUnchanged(priorRow) {
+		const frozen = [
+			[
+				"kind",
+				String(priorRow.kind ?? "payment"),
+				this.kind
+			],
+			[
+				"amount",
+				Number(priorRow.amount ?? 0),
+				Number(this.amount ?? 0)
+			],
+			[
+				"currency",
+				String(priorRow.currency ?? ""),
+				this.currency
+			],
+			[
+				"backendId",
+				String(priorRow.backend_id ?? ""),
+				this.backendId
+			],
+			[
+				"backendTxRef",
+				!priorRow.backend_tx_ref && priorRow.connected_refund_state === "requested" && this.connectedRefundState !== "requested" ? this.backendTxRef : String(priorRow.backend_tx_ref ?? ""),
+				this.backendTxRef
+			],
+			[
+				"transactionId",
+				String(priorRow.transaction_id ?? ""),
+				this.transactionId
+			],
+			[
+				"connectedAccountId",
+				String(priorRow.connected_account_id ?? ""),
+				this.connectedAccountId
+			],
+			[
+				"applicationFeeCents",
+				Number(priorRow.application_fee_cents ?? 0),
+				Number(this.applicationFeeCents ?? 0)
+			],
+			[
+				"refundOfPaymentId",
+				String(priorRow.refund_of_payment_id ?? ""),
+				this.refundOfPaymentId
+			],
+			[
+				"applicationFeeRefunded",
+				Boolean(priorRow.application_fee_refunded),
+				Boolean(this.applicationFeeRefunded)
+			]
+		];
+		for (const [field2, prior, next] of frozen) if (prior !== next) throw new Error(`Payment ${this.id}: '${field2}' of a connected payment or refund cannot change`);
+	}
 	/**
 	* Reject an illegal status flip. Compares the about-to-be-written status
 	* against the status the row was loaded with. No-op transitions (status
@@ -332,6 +441,26 @@ var Payment = class extends SmrtObject {
 				"usdAtConfirmation",
 				Number(priorRow.usd_at_confirmation ?? 0),
 				Number(this.usdAtConfirmation ?? 0)
+			],
+			[
+				"connectedAccountId",
+				String(priorRow.connected_account_id ?? ""),
+				String(this.connectedAccountId ?? "")
+			],
+			[
+				"applicationFeeCents",
+				Number(priorRow.application_fee_cents ?? 0),
+				Number(this.applicationFeeCents ?? 0)
+			],
+			[
+				"refundOfPaymentId",
+				String(priorRow.refund_of_payment_id ?? ""),
+				String(this.refundOfPaymentId ?? "")
+			],
+			[
+				"connectedRefundState",
+				String(priorRow.connected_refund_state ?? ""),
+				String(this.connectedRefundState ?? "")
 			]
 		];
 		for (const [field2, prior, next] of frozen) if (prior !== next) throw new Error(`Payment ${this.id}: '${field2}' is frozen once the payment is COMPLETED (was '${prior}', got '${next}'). A settled payment's monetary fields cannot be mutated \u2014 issue a refund instead.`);
@@ -439,6 +568,8 @@ var Payment = class extends SmrtObject {
 	async postPaymentInTransaction(options) {
 		if (this.status === PaymentStatus.COMPLETED) throw new Error("Payment already recorded");
 		if (this.amount <= 0) throw new Error("Payment amount must be positive");
+		const applicationFee = this.kind === "payment" ? this.applicationFeeCents : 0;
+		if (applicationFee > 0 && !options.applicationFeeAccountId) throw new Error("Payment carries an application fee; recordPayment requires applicationFeeAccountId");
 		const funds = customerFundsState(this.customerFundsJson);
 		const explicitDate = options.effectiveOn;
 		if (explicitDate !== void 0 && (typeof explicitDate !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(explicitDate) || !Number.isFinite(Date.parse(explicitDate)) || new Date(explicitDate).toISOString().slice(0, 10) !== explicitDate)) throw new Error("Settlement effectiveOn must be a calendar date");
@@ -461,10 +592,17 @@ var Payment = class extends SmrtObject {
 		await journal.addEntry({
 			accountId: options.cashAccountId,
 			currency: this.currency,
-			debit: this.kind === "payment" ? this.amount : 0,
+			debit: this.kind === "payment" ? this.amount - applicationFee : 0,
 			credit: this.kind === "refund" ? this.amount : 0,
 			memo: `${this.kind === "refund" ? "Refund" : "Payment"} ${this.reference || this.id}`
 		});
+		if (applicationFee > 0) await journal.addEntry({
+			accountId: options.applicationFeeAccountId,
+			currency: this.currency,
+			debit: applicationFee,
+			credit: 0,
+			memo: `Application fee ${this.reference || this.id}`
+		});
 		await journal.addEntry({
 			accountId: creditAccountId,
 			currency: this.currency,
@@ -813,7 +951,7 @@ var PaymentAllocation = class extends SmrtObject {
 		if (!this.paymentId || !this.invoiceId) throw new Error("PaymentAllocation requires payment and invoice");
 		return this.withTransaction(async () => {
 			const { PaymentCollection } = await Promise.resolve().then(() => PaymentCollection_exports);
-			const { InvoiceCollection } = await import("./InvoiceCollection-XPcPyibo.js").then((n) => n.n);
+			const { InvoiceCollection } = await import("./InvoiceCollection-Datg_eZM.js").then((n) => n.n);
 			const { PaymentAllocationCollection } = await Promise.resolve().then(() => PaymentAllocationCollection_exports);
 			const payments = await PaymentCollection.create({ db: this.db });
 			const invoices = await InvoiceCollection.create({ db: this.db });
@@ -920,7 +1058,7 @@ var PaymentAllocationCollection = class PaymentAllocationCollection extends Smrt
 	async allocatePayment(input) {
 		if (!input.allocations.length || new Set(input.allocations.map((item) => item.id)).size !== input.allocations.length) throw new Error("Allocation batch requires distinct stable allocation ids");
 		const { PaymentCollection } = await Promise.resolve().then(() => PaymentCollection_exports);
-		const { InvoiceCollection } = await import("./InvoiceCollection-XPcPyibo.js").then((n) => n.n);
+		const { InvoiceCollection } = await import("./InvoiceCollection-Datg_eZM.js").then((n) => n.n);
 		const { InvoiceStatus } = await import("./types-Bbm0Xflc.js").then((n) => n.m);
 		const payment = await (await PaymentCollection.create({ db: this.db })).get({ id: input.paymentId }, { cache: false });
 		if (!payment) throw new Error("Payment does not exist");
@@ -963,7 +1101,7 @@ var PaymentAllocationCollection = class PaymentAllocationCollection extends Smrt
 		const allocation = await this.get({ id }, { cache: false });
 		if (!allocation) return;
 		const { PaymentCollection } = await Promise.resolve().then(() => PaymentCollection_exports);
-		const { InvoiceCollection } = await import("./InvoiceCollection-XPcPyibo.js").then((n) => n.n);
+		const { InvoiceCollection } = await import("./InvoiceCollection-Datg_eZM.js").then((n) => n.n);
 		const payment = await (await PaymentCollection.create({ db: this.db })).get({ id: allocation.paymentId }, { cache: false });
 		if (!payment) throw new Error("Allocation payment does not exist");
 		await payment.withTransaction(async () => {
@@ -2733,6 +2871,6 @@ async function reconcileRetainedCreditAccounting(input) {
 	}));
 }
 //#endregion
-export { PaymentAllocationCollection_exports as A, invoice_accounting_sync_exports as C, syncFrozenInvoiceToAccounting as D, reconcileFrozenInvoiceAccountingSync as E, Payment as F, historicalCreditRefundCommittedTotal as M, PaymentCollection as N, toFrozenInvoiceAccountingInput as O, PaymentCollection_exports as P, calculateInvoiceMinorLine as S, readFrozenAccountingSyncState as T, reconcileOrdinaryCreditAccounting as _, reconcileRetainedBaseInvoice as a, syncOrdinaryRefundToAccounting as b, syncRetainedCreditToAccounting as c, toRetainedCreditAccountingInput as d, toRetainedInvoiceAccountingInput as f, reconcileOrdinaryBaseInvoice as g, reconcileOrdinaryAccountingStep as h, reconcileRetainedAccountingStep as i, PaymentAllocation as j, PaymentAllocationCollection as k, syncRetainedInvoiceToAccounting as l, readOrdinaryInvoiceAccountingState as m, loadRetainedInvoiceAccountingSnapshot as n, reconcileRetainedCreditAccounting as o, loadOrdinaryCreditAccountingSnapshot as p, readRetainedInvoiceAccountingState as r, releaseRetainedInvoiceToAccounting as s, loadRetainedCreditAccountingSnapshot as t, syncRetainedRefundToAccounting as u, syncOrdinaryCreditToAccounting as v, loadFrozenInvoiceAccountingSnapshot as w, toOrdinaryCreditAccountingInput as x, syncOrdinaryInvoiceToAccounting as y };
+export { PaymentAllocationCollection_exports as A, invoice_accounting_sync_exports as C, syncFrozenInvoiceToAccounting as D, reconcileFrozenInvoiceAccountingSync as E, Payment as F, hasConnectedPaymentAuthority as I, withConnectedPaymentAuthority as L, historicalCreditRefundCommittedTotal as M, PaymentCollection as N, toFrozenInvoiceAccountingInput as O, PaymentCollection_exports as P, calculateInvoiceMinorLine as S, readFrozenAccountingSyncState as T, reconcileOrdinaryCreditAccounting as _, reconcileRetainedBaseInvoice as a, syncOrdinaryRefundToAccounting as b, syncRetainedCreditToAccounting as c, toRetainedCreditAccountingInput as d, toRetainedInvoiceAccountingInput as f, reconcileOrdinaryBaseInvoice as g, reconcileOrdinaryAccountingStep as h, reconcileRetainedAccountingStep as i, PaymentAllocation as j, PaymentAllocationCollection as k, syncRetainedInvoiceToAccounting as l, readOrdinaryInvoiceAccountingState as m, loadRetainedInvoiceAccountingSnapshot as n, reconcileRetainedCreditAccounting as o, loadOrdinaryCreditAccountingSnapshot as p, readRetainedInvoiceAccountingState as r, releaseRetainedInvoiceToAccounting as s, loadRetainedCreditAccountingSnapshot as t, syncRetainedRefundToAccounting as u, syncOrdinaryCreditToAccounting as v, loadFrozenInvoiceAccountingSnapshot as w, toOrdinaryCreditAccountingInput as x, syncOrdinaryInvoiceToAccounting as y };
 
-//# sourceMappingURL=retention-accounting-Ct5Df6xx.js.map
+//# sourceMappingURL=retention-accounting-DGuXzt9g.js.map