@classytic/revenue 2.5.0 → 2.6.0

package/dist/{settlement.repository-BDrJQc27.mjs → settlement.repository-oypYDjKq.mjs}

@@ -3,7 +3,7 @@ import { n as createEvent, t as REVENUE_EVENTS } from "./event-constants-DM_-A57
 import { g as SETTLEMENT_STATUS, r as SUBSCRIPTION_STATUS, w as HOLD_STATUS } from "./subscription.enums-95othr0i.mjs";
 import { _ as WrongTransactionKindError, g as ValidationError, h as TransactionNotFoundError, m as SubscriptionNotFoundError, n as BankFeedImportError, o as MethodKindLockedError, p as SettlementNotFoundError } from "./errors-Bt5NRVMq.mjs";
 import { SETTLEMENT_STATE_MACHINE, SUBSCRIPTION_STATE_MACHINE, TRANSACTION_STATE_MACHINE, smFor } from "./core/state-machines.mjs";
-import { a as reverseTax, c as reverseCommission, n as calculateSplits, s as calculateCommission, t as calculateOrganizationPayout } from "./splits-CNfQj92L.mjs";
+import { c as calculateCommission, l as reverseCommission, n as calculateSplits, o as reverseTax, t as calculateOrganizationPayout } from "./splits-CEdZN6OT.mjs";
 import { Repository, repoOptionsFromCtx, withTransaction } from "@classytic/mongokit";
 
 //#region src/repositories/base.repository.ts
@@ -1402,6 +1402,38 @@ var SubscriptionRepository = class extends RevenueRepositoryBase {
 
 //#endregion
 //#region src/repositories/settlement.repository.ts
+function emptySettlementSummary() {
+	return {
+		currency: null,
+		pending: 0,
+		held: 0,
+		available: 0,
+		processing: 0,
+		paidOut: 0,
+		failed: 0,
+		lifetime: 0
+	};
+}
+/** Bucket one aggregated (status, due, total) row into a running summary. */
+function foldSettlementStatus(s, status, due, total) {
+	switch (status) {
+		case SETTLEMENT_STATUS.PENDING:
+			s.pending += total;
+			if (due) s.available += total;
+			else s.held += total;
+			break;
+		case SETTLEMENT_STATUS.PROCESSING:
+			s.processing += total;
+			break;
+		case SETTLEMENT_STATUS.COMPLETED:
+			s.paidOut += total;
+			break;
+		case SETTLEMENT_STATUS.FAILED:
+			s.failed += total;
+			break;
+		default: break;
+	}
+}
 /**
 * SettlementRepository — payouts to recipients (organizations, vendors,
 * affiliates).
@@ -1563,12 +1595,16 @@ var SettlementRepository = class extends RevenueRepositoryBase {
 		}), ctx);
 		return updated;
 	}
-	async recipientBalance(recipientId, options = {}, ctx = {}) {
-		const match = { recipientId };
-		if (options.recipientType !== void 0) match.recipientType = options.recipientType;
-		if (options.currency !== void 0) match.currency = options.currency;
+	/**
+	* Settlement money-state for an ARBITRARY filter — a recipient, an org, or
+	* the whole platform (pass `_bypassTenant` in ctx to span every org). One
+	* tenant-scoped `aggregatePipeline` (the `{ recipientId, status }` index backs
+	* the `$match`), never a raw `Model.aggregate`. The reusable rollup behind
+	* `recipientBalance`, platform reconciliation, and cross-org earnings.
+	*/
+	async summary(filter = {}, ctx = {}) {
 		const now = /* @__PURE__ */ new Date();
-		const rows = await this.aggregatePipeline([{ $match: match }, { $group: {
+		const rows = await this.aggregatePipeline([{ $match: filter }, { $group: {
 			_id: {
 				status: "$status",
 				due: { $lte: ["$scheduledAt", now] }
@@ -1576,39 +1612,64 @@ var SettlementRepository = class extends RevenueRepositoryBase {
 			total: { $sum: "$amount" },
 			currency: { $first: "$currency" }
 		} }], this.optsFromCtx(ctx));
-		const balance = {
-			recipientId,
-			currency: options.currency ?? null,
-			pending: 0,
-			held: 0,
-			available: 0,
-			processing: 0,
-			paidOut: 0,
-			failed: 0,
-			lifetime: 0
-		};
+		const out = emptySettlementSummary();
 		for (const row of rows) {
-			switch (row._id.status) {
-				case SETTLEMENT_STATUS.PENDING:
-					balance.pending += row.total;
-					if (row._id.due) balance.available += row.total;
-					else balance.held += row.total;
-					break;
-				case SETTLEMENT_STATUS.PROCESSING:
-					balance.processing += row.total;
-					break;
-				case SETTLEMENT_STATUS.COMPLETED:
-					balance.paidOut += row.total;
-					break;
-				case SETTLEMENT_STATUS.FAILED:
-					balance.failed += row.total;
-					break;
-				default: break;
+			foldSettlementStatus(out, row._id.status, row._id.due, row.total);
+			if (row.currency && !out.currency) out.currency = row.currency;
+		}
+		out.lifetime = out.pending + out.processing + out.paidOut;
+		return out;
+	}
+	/**
+	* Per-recipient settlement rollup — one {@link RecipientBreakdown} per
+	* distinct (recipientId, recipientType) matching `filter`. The reusable list
+	* behind a platform "who is owed what" view; pass `_bypassTenant` to span all
+	* orgs.
+	*/
+	async breakdownByRecipient(filter = {}, ctx = {}) {
+		const now = /* @__PURE__ */ new Date();
+		const rows = await this.aggregatePipeline([{ $match: filter }, { $group: {
+			_id: {
+				recipientId: "$recipientId",
+				recipientType: "$recipientType",
+				status: "$status",
+				due: { $lte: ["$scheduledAt", now] }
+			},
+			total: { $sum: "$amount" },
+			currency: { $first: "$currency" },
+			role: { $first: "$metadata.role" }
+		} }], this.optsFromCtx(ctx));
+		const byKey = /* @__PURE__ */ new Map();
+		for (const row of rows) {
+			const key = `${row._id.recipientType}:${row._id.recipientId}`;
+			let r = byKey.get(key);
+			if (!r) {
+				r = {
+					recipientId: row._id.recipientId,
+					recipientType: row._id.recipientType,
+					role: row.role ?? null,
+					...emptySettlementSummary()
+				};
+				byKey.set(key, r);
 			}
-			if (row.currency && !balance.currency) balance.currency = row.currency;
+			foldSettlementStatus(r, row._id.status, row._id.due, row.total);
+			if (row.role && !r.role) r.role = row.role;
+			if (row.currency && !r.currency) r.currency = row.currency;
 		}
-		balance.lifetime = balance.pending + balance.processing + balance.paidOut;
-		return balance;
+		for (const r of byKey.values()) r.lifetime = r.pending + r.processing + r.paidOut;
+		return [...byKey.values()];
+	}
+	/** One recipient's wallet — a thin `summary` over `{ recipientId, … }`. */
+	async recipientBalance(recipientId, options = {}, ctx = {}) {
+		const filter = { recipientId };
+		if (options.recipientType !== void 0) filter.recipientType = options.recipientType;
+		if (options.currency !== void 0) filter.currency = options.currency;
+		const s = await this.summary(filter, ctx);
+		return {
+			recipientId,
+			...s,
+			currency: options.currency ?? s.currency
+		};
 	}
 };
 

package/dist/shared/index.d.mts

@@ -1,2 +1,2 @@
-import { A as SplitInfo, B as validateTaxCalculation, C as multiplyMoney, D as toCurrencyCode, E as sumMoney, F as TaxConfig, H as calculateCommission, I as TaxType, L as calculateTax, M as calculateOrganizationPayout, N as calculateSplits, O as toMajor, P as TaxCalculation, R as getTaxType, S as money, T as subtractMoney, U as reverseCommission, V as CommissionInfo, _ as isMoney, a as CurrencyCode, b as isZeroMoney, c as Money, d as addMoney, f as compareMoney, g as isCurrencyCode, h as fromSmallestUnit, i as CURRENCIES, j as SplitRule, k as toSmallestUnit, l as MoneyValue, m as fromMajor, n as getAuditTrail, o as CurrencyMismatchError, p as equalsMoney, r as getLastStateChange, s as MINOR_UNIT_FACTOR, t as appendAuditEvent, u as absMoney, v as isNegativeMoney, w as negateMoney, x as minorUnitFactor, y as isPositiveMoney, z as reverseTax } from "../audit-DRKuLBFO.mjs";
-export { CURRENCIES, CommissionInfo, type CurrencyCode, CurrencyMismatchError, MINOR_UNIT_FACTOR, type Money, type MoneyValue, SplitInfo, SplitRule, TaxCalculation, TaxConfig, TaxType, absMoney, addMoney, appendAuditEvent, calculateCommission, calculateOrganizationPayout, calculateSplits, calculateTax, compareMoney, equalsMoney, fromMajor, fromSmallestUnit, getAuditTrail, getLastStateChange, getTaxType, isCurrencyCode, isMoney, isNegativeMoney, isPositiveMoney, isZeroMoney, minorUnitFactor, money, multiplyMoney, negateMoney, reverseCommission, reverseTax, subtractMoney, sumMoney, toCurrencyCode, toMajor, toSmallestUnit, validateTaxCalculation };
+import { A as SplitInfo, B as reverseTax, C as multiplyMoney, D as toCurrencyCode, E as sumMoney, F as TaxCalculation, H as CommissionInfo, I as TaxConfig, L as TaxType, M as calculateOrganizationPayout, N as calculateSplits, O as toMajor, P as reverseSplits, R as calculateTax, S as money, T as subtractMoney, U as calculateCommission, V as validateTaxCalculation, W as reverseCommission, _ as isMoney, a as CurrencyCode, b as isZeroMoney, c as Money, d as addMoney, f as compareMoney, g as isCurrencyCode, h as fromSmallestUnit, i as CURRENCIES, j as SplitRule, k as toSmallestUnit, l as MoneyValue, m as fromMajor, n as getAuditTrail, o as CurrencyMismatchError, p as equalsMoney, r as getLastStateChange, s as MINOR_UNIT_FACTOR, t as appendAuditEvent, u as absMoney, v as isNegativeMoney, w as negateMoney, x as minorUnitFactor, y as isPositiveMoney, z as getTaxType } from "../audit-BkDdPSed.mjs";
+export { CURRENCIES, CommissionInfo, type CurrencyCode, CurrencyMismatchError, MINOR_UNIT_FACTOR, type Money, type MoneyValue, SplitInfo, SplitRule, TaxCalculation, TaxConfig, TaxType, absMoney, addMoney, appendAuditEvent, calculateCommission, calculateOrganizationPayout, calculateSplits, calculateTax, compareMoney, equalsMoney, fromMajor, fromSmallestUnit, getAuditTrail, getLastStateChange, getTaxType, isCurrencyCode, isMoney, isNegativeMoney, isPositiveMoney, isZeroMoney, minorUnitFactor, money, multiplyMoney, negateMoney, reverseCommission, reverseSplits, reverseTax, subtractMoney, sumMoney, toCurrencyCode, toMajor, toSmallestUnit, validateTaxCalculation };

package/dist/shared/index.mjs

@@ -1,4 +1,4 @@
-import { a as reverseTax, c as reverseCommission, i as getTaxType, n as calculateSplits, o as validateTaxCalculation, r as calculateTax, s as calculateCommission, t as calculateOrganizationPayout } from "../splits-CNfQj92L.mjs";
+import { a as getTaxType, c as calculateCommission, i as calculateTax, l as reverseCommission, n as calculateSplits, o as reverseTax, r as reverseSplits, s as validateTaxCalculation, t as calculateOrganizationPayout } from "../splits-CEdZN6OT.mjs";
 import { C as sumMoney, E as toSmallestUnit, S as subtractMoney, T as toMajor, _ as isZeroMoney, a as CurrencyMismatchError, b as multiplyMoney, c as addMoney, d as fromMajor, f as fromSmallestUnit, g as isPositiveMoney, h as isNegativeMoney, i as CURRENCIES, l as compareMoney, m as isMoney, n as getAuditTrail, o as MINOR_UNIT_FACTOR, p as isCurrencyCode, r as getLastStateChange, s as absMoney, t as appendAuditEvent, u as equalsMoney, v as minorUnitFactor, w as toCurrencyCode, x as negateMoney, y as money } from "../audit-Ba2XB2C4.mjs";
 
-export { CURRENCIES, CurrencyMismatchError, MINOR_UNIT_FACTOR, absMoney, addMoney, appendAuditEvent, calculateCommission, calculateOrganizationPayout, calculateSplits, calculateTax, compareMoney, equalsMoney, fromMajor, fromSmallestUnit, getAuditTrail, getLastStateChange, getTaxType, isCurrencyCode, isMoney, isNegativeMoney, isPositiveMoney, isZeroMoney, minorUnitFactor, money, multiplyMoney, negateMoney, reverseCommission, reverseTax, subtractMoney, sumMoney, toCurrencyCode, toMajor, toSmallestUnit, validateTaxCalculation };
+export { CURRENCIES, CurrencyMismatchError, MINOR_UNIT_FACTOR, absMoney, addMoney, appendAuditEvent, calculateCommission, calculateOrganizationPayout, calculateSplits, calculateTax, compareMoney, equalsMoney, fromMajor, fromSmallestUnit, getAuditTrail, getLastStateChange, getTaxType, isCurrencyCode, isMoney, isNegativeMoney, isPositiveMoney, isZeroMoney, minorUnitFactor, money, multiplyMoney, negateMoney, reverseCommission, reverseSplits, reverseTax, subtractMoney, sumMoney, toCurrencyCode, toMajor, toSmallestUnit, validateTaxCalculation };

package/dist/{splits-CNfQj92L.mjs → splits-CEdZN6OT.mjs}

@@ -1,3 +1,5 @@
+import { g as ValidationError } from "./errors-Bt5NRVMq.mjs";
+
 //#region src/shared/calculators/commission.ts
 function calculateCommission(amount, commissionRate, gatewayFeeRate = 0) {
 	if (!commissionRate || commissionRate <= 0) return null;
@@ -17,9 +19,9 @@ function calculateCommission(amount, commissionRate, gatewayFeeRate = 0) {
 }
 function reverseCommission(originalCommission, originalAmount, refundAmount) {
 	if (!originalCommission?.netAmount) return null;
-	if (!originalAmount || originalAmount <= 0) throw new Error("Original amount must be greater than 0");
-	if (refundAmount < 0) throw new Error("Refund amount cannot be negative");
-	if (refundAmount > originalAmount) throw new Error("Refund amount exceeds original amount");
+	if (!originalAmount || originalAmount <= 0) throw new ValidationError("Original amount must be greater than 0");
+	if (refundAmount < 0) throw new ValidationError("Refund amount cannot be negative");
+	if (refundAmount > originalAmount) throw new ValidationError("Refund amount exceeds original amount");
 	const refundRatio = refundAmount / originalAmount;
 	return {
 		rate: originalCommission.rate,
@@ -74,9 +76,9 @@ function reverseTax(originalTax, originalAmount, refundAmount) {
 		totalAmount: refundAmount,
 		pricesIncludeTax: false
 	};
-	if (!originalAmount || originalAmount <= 0) throw new Error("Original amount must be greater than 0");
-	if (refundAmount < 0) throw new Error("Refund amount cannot be negative");
-	if (refundAmount > originalAmount) throw new Error("Refund amount exceeds original amount");
+	if (!originalAmount || originalAmount <= 0) throw new ValidationError("Original amount must be greater than 0");
+	if (refundAmount < 0) throw new ValidationError("Refund amount cannot be negative");
+	if (refundAmount > originalAmount) throw new ValidationError("Refund amount exceeds original amount");
 	const refundRatio = refundAmount / originalAmount;
 	const reversedType = originalTax.type ? originalTax.type === "collected" ? "paid" : originalTax.type === "paid" ? "collected" : "exempt" : void 0;
 	return {
@@ -118,6 +120,19 @@ function calculateSplits(amount, rules, gatewayFeeRate = 0) {
 function calculateOrganizationPayout(amount, splits) {
 	return amount - splits.reduce((sum, s) => sum + s.grossAmount, 0);
 }
+function reverseSplits(originalSplits, originalAmount, refundAmount) {
+	if (!originalAmount || originalAmount <= 0) throw new ValidationError("Original amount must be greater than 0");
+	if (refundAmount < 0) throw new ValidationError("Refund amount cannot be negative");
+	if (refundAmount > originalAmount) throw new ValidationError("Refund amount exceeds original amount");
+	const refundRatio = refundAmount / originalAmount;
+	return originalSplits.map((s) => ({
+		...s,
+		grossAmount: Math.round(s.grossAmount * refundRatio),
+		gatewayFeeAmount: Math.round(s.gatewayFeeAmount * refundRatio),
+		netAmount: Math.round(s.netAmount * refundRatio),
+		status: "waived"
+	}));
+}
 
 //#endregion
-export { reverseTax as a, reverseCommission as c, getTaxType as i, calculateSplits as n, validateTaxCalculation as o, calculateTax as r, calculateCommission as s, calculateOrganizationPayout as t };
+export { getTaxType as a, calculateCommission as c, calculateTax as i, reverseCommission as l, calculateSplits as n, reverseTax as o, reverseSplits as r, validateTaxCalculation as s, calculateOrganizationPayout as t };

package/dist/validators/index.d.mts

@@ -1,4 +1,4 @@
-import { A as transactionBaseSchema, C as subscriptionBaseSchema, D as TransactionCreateInput, E as subscriptionUpdateSchema, M as transactionListFilterSchema, N as transactionUpdateSchema, O as TransactionListFilter, S as SubscriptionUpdateInput, T as subscriptionListFilterSchema, _ as settlementCreateSchema, a as escrowReleaseSchema, b as SubscriptionCreateInput, c as PaymentVerifyInput, d as paymentVerifySchema, f as refundSchema, g as settlementBaseSchema, h as SettlementUpdateInput, i as escrowHoldSchema, j as transactionCreateSchema, k as TransactionUpdateInput, l as RefundInput, m as SettlementListFilter, n as EscrowReleaseInput, o as splitRuleSchema, p as SettlementCreateInput, r as SplitRuleInput, s as PaymentIntentInput, t as EscrowHoldInput, u as paymentIntentSchema, v as settlementListFilterSchema, w as subscriptionCreateSchema, x as SubscriptionListFilter, y as settlementUpdateSchema } from "../escrow.schema-o4qhjOca.mjs";
+import { A as transactionBaseSchema, C as subscriptionBaseSchema, D as TransactionCreateInput, E as subscriptionUpdateSchema, M as transactionListFilterSchema, N as transactionUpdateSchema, O as TransactionListFilter, S as SubscriptionUpdateInput, T as subscriptionListFilterSchema, _ as settlementCreateSchema, a as escrowReleaseSchema, b as SubscriptionCreateInput, c as PaymentVerifyInput, d as paymentVerifySchema, f as refundSchema, g as settlementBaseSchema, h as SettlementUpdateInput, i as escrowHoldSchema, j as transactionCreateSchema, k as TransactionUpdateInput, l as RefundInput, m as SettlementListFilter, n as EscrowReleaseInput, o as splitRuleSchema, p as SettlementCreateInput, r as SplitRuleInput, s as PaymentIntentInput, t as EscrowHoldInput, u as paymentIntentSchema, v as settlementListFilterSchema, w as subscriptionCreateSchema, x as SubscriptionListFilter, y as settlementUpdateSchema } from "../escrow.schema-DSx7EywJ.mjs";
 import { z } from "zod";
 
 //#region src/validators/bank-feed.schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/revenue",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Payment lifecycle engine — transactions, subscriptions, escrow, settlements, commissions. MongoKit-powered, Arc-compatible, framework-agnostic.",
   "type": "module",
   "sideEffects": false,