@fantastic.dev/better-stripe 0.23.1 → 0.24.0

package/dist/component/settlement/clawbacks.d.ts

@@ -0,0 +1,55 @@
+import type { Infer } from "convex/values";
+import type { Doc } from "../_generated/dataModel.js";
+import type { MutationCtx } from "../_generated/server.js";
+import { commissionExposureValidator } from "./clawbackSchema.js";
+export type CommissionExposure = Infer<typeof commissionExposureValidator>;
+/** Exact round-half-up proportional commission in integer currency units. */
+export declare function proportionalCommission(commission: number, principal: number, charge: number): number;
+/** Lazily migrate one immutable original affiliate leg, also used by backfill. */
+export declare function ensureCommissionObligation(ctx: MutationCtx, transfer: Doc<"transfers">, chargeAmount: number): Promise<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"affiliateObligations">;
+    accounted?: boolean | undefined;
+    activeOperationId?: import("convex/values").GenericId<"affiliateRecoveryOperations"> | undefined;
+    affiliateAccountId: string;
+    chargeAmount: number;
+    creditAmount?: number | undefined;
+    currency: string;
+    debtAmount?: number | undefined;
+    debtStatus?: "open" | "settled" | undefined;
+    disputeId?: string | undefined;
+    disputeState?: "lost" | "open" | "won" | undefined;
+    disputedPrincipal: number;
+    earningId?: import("convex/values").GenericId<"affiliateEarnings"> | undefined;
+    finalizedAmount: number;
+    lastError?: string | undefined;
+    lastRefundId?: string | undefined;
+    lastState?: string | undefined;
+    legacyReceiptIds?: string[] | undefined;
+    legacyRestorationIds?: string[] | undefined;
+    lostPrincipal: number;
+    needsReconciliation: boolean;
+    offsetAmount?: number | undefined;
+    operationSequence?: number | undefined;
+    operatorNote?: string | undefined;
+    originalCommission: number;
+    paymentId?: string | undefined;
+    paymentIntentId?: string | undefined;
+    provisionalAmount: number;
+    recoveredAmount: number;
+    refundedPrincipal: number;
+    releasedCommission?: number | undefined;
+    reservedRecovery?: number | undefined;
+    reservedRestoration?: number | undefined;
+    restoredAmount?: number | undefined;
+    sourceChargeId: string;
+    sourceInvoiceId?: string | undefined;
+    storeAccountId?: string | undefined;
+    stripeTransferId?: string | undefined;
+}>;
+/** Refunds and disputes share the same original-principal exposure axis. */
+export declare function applyCommissionExposure(ctx: MutationCtx, transfer: Doc<"transfers">, exposure: CommissionExposure): Promise<number>;
+export declare function applyObligationExposure(ctx: MutationCtx, row: Doc<"affiliateObligations">, exposure: CommissionExposure): Promise<number>;
+/** Webhook upserts cannot rewrite a frozen commission or its confirmed balance. */
+export declare function syncCommissionTransfer(ctx: MutationCtx, transfer: Doc<"transfers">): Promise<void>;
+//# sourceMappingURL=clawbacks.d.ts.map

package/dist/component/settlement/clawbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clawbacks.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/clawbacks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE3E,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAWR;AAED,kFAAkF;AAClF,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAC1B,YAAY,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFrB;AAED,4EAA4E;AAC5E,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,EAC1B,QAAQ,EAAE,kBAAkB,mBAe7B;AACD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAChC,QAAQ,EAAE,kBAAkB,mBA0D7B;AAED,mFAAmF;AACnF,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,iBA0B3B"}

package/dist/component/settlement/clawbacks.js

@@ -0,0 +1,146 @@
+import { updateObligation } from "../affiliateRecovery/accounting.js";
+/** Exact round-half-up proportional commission in integer currency units. */
+export function proportionalCommission(commission, principal, charge) {
+    for (const n of [commission, principal, charge]) {
+        if (!Number.isSafeInteger(n) || n < 0)
+            throw new Error("Commission recovery requires non-negative integer units.");
+    }
+    if (charge === 0)
+        throw new Error("Commission recovery requires a positive charge.");
+    const numerator = BigInt(commission) * BigInt(Math.min(principal, charge));
+    return Number((2n * numerator + BigInt(charge)) / (2n * BigInt(charge)));
+}
+/** Lazily migrate one immutable original affiliate leg, also used by backfill. */
+export async function ensureCommissionObligation(ctx, transfer, chargeAmount) {
+    if (transfer.role !== "affiliate" ||
+        transfer.reinstatement ||
+        !transfer.sourceChargeId)
+        throw new Error("Commission obligation requires an original affiliate transfer.");
+    const existing = await ctx.db
+        .query("affiliateObligations")
+        .withIndex("by_transfer", (q) => q.eq("stripeTransferId", transfer.stripeTransferId))
+        .unique();
+    if (existing) {
+        if (existing.chargeAmount !== chargeAmount ||
+            (existing.releasedCommission ?? existing.originalCommission) !==
+                transfer.amount ||
+            existing.affiliateAccountId !== transfer.destinationAccountId ||
+            existing.currency !== transfer.currency ||
+            existing.sourceChargeId !== transfer.sourceChargeId ||
+            (transfer.sourceInvoiceId !== undefined &&
+                existing.sourceInvoiceId !== transfer.sourceInvoiceId))
+            throw new Error("Original affiliate commission identity cannot change.");
+        return existing;
+    }
+    proportionalCommission(transfer.amount, 0, chargeAmount);
+    const allocation = await ctx.db
+        .query("settlementAllocations")
+        .withIndex("by_source_charge", (q) => q.eq("sourceChargeId", transfer.sourceChargeId))
+        .unique();
+    const earning = await ctx.db
+        .query("affiliateEarnings")
+        .withIndex("by_charge_affiliate", (q) => q
+        .eq("sourceChargeId", transfer.sourceChargeId)
+        .eq("affiliateAccountId", transfer.destinationAccountId))
+        .unique();
+    if (allocation &&
+        (allocation.gross !== chargeAmount ||
+            allocation.currency !== transfer.currency ||
+            !allocation.transfers.some((leg) => leg.role === "affiliate" &&
+                leg.destinationAccountId === transfer.destinationAccountId &&
+                leg.amount === (earning?.originalCommission ?? transfer.amount))))
+        throw new Error("Commission recovery conflicts with original settlement.");
+    const recoveredAmount = transfer.reversedAmount ?? 0;
+    if (!Number.isSafeInteger(recoveredAmount) ||
+        recoveredAmount < 0 ||
+        recoveredAmount > transfer.amount)
+        throw new Error("Invalid original affiliate reversal balance.");
+    const id = await ctx.db.insert("affiliateObligations", {
+        stripeTransferId: transfer.stripeTransferId,
+        sourceChargeId: transfer.sourceChargeId,
+        sourceInvoiceId: transfer.sourceInvoiceId ?? allocation?.sourceInvoiceId,
+        paymentIntentId: allocation?.paymentIntentId,
+        paymentId: transfer.paymentId ?? allocation?.paymentId,
+        storeAccountId: allocation?.transfers.find((leg) => leg.role === "store")
+            ?.destinationAccountId,
+        affiliateAccountId: transfer.destinationAccountId,
+        currency: transfer.currency,
+        chargeAmount,
+        originalCommission: earning?.originalCommission ?? transfer.amount,
+        releasedCommission: transfer.amount,
+        earningId: earning?._id,
+        refundedPrincipal: 0,
+        disputedPrincipal: 0,
+        lostPrincipal: 0,
+        finalizedAmount: 0,
+        provisionalAmount: 0,
+        recoveredAmount,
+        needsReconciliation: recoveredAmount > 0 || (transfer.reversalClaimedAmount ?? 0) > 0,
+    });
+    return (await ctx.db.get("affiliateObligations", id));
+}
+/** Refunds and disputes share the same original-principal exposure axis. */
+export async function applyCommissionExposure(ctx, transfer, exposure) {
+    proportionalCommission(transfer.amount, exposure.principal, exposure.chargeAmount);
+    if (exposure.kind === "refund" && !exposure.finalized)
+        throw new Error("Pending refunds cannot create commission obligations.");
+    const row = await ensureCommissionObligation(ctx, transfer, exposure.chargeAmount);
+    return applyObligationExposure(ctx, row, exposure);
+}
+export async function applyObligationExposure(ctx, row, exposure) {
+    proportionalCommission(row.originalCommission, exposure.principal, exposure.chargeAmount);
+    if (row.chargeAmount !== exposure.chargeAmount)
+        throw new Error("Original charge amount cannot change.");
+    const principal = Math.min(exposure.principal, exposure.chargeAmount);
+    const refundedPrincipal = Math.max(row.refundedPrincipal, exposure.refundedPrincipal ?? 0, exposure.kind === "refund" ? principal : 0);
+    let disputedPrincipal = Math.max(row.disputedPrincipal, exposure.kind === "dispute" ? principal : 0);
+    let lostPrincipal = Math.max(row.lostPrincipal, exposure.kind === "dispute" && exposure.finalized ? principal : 0);
+    const incomingState = exposure.disputeState ?? (exposure.finalized ? "lost" : "open");
+    const rank = { open: 0, lost: 1, won: 2 };
+    const disputeState = exposure.kind === "dispute" &&
+        rank[incomingState] >= rank[row.disputeState ?? "open"]
+        ? incomingState
+        : row.disputeState;
+    if (disputeState === "won") {
+        disputedPrincipal = 0;
+        lostPrincipal = 0;
+    }
+    if (exposure.kind === "dispute" && disputeState === "lost")
+        lostPrincipal = Math.max(lostPrincipal, disputedPrincipal);
+    const finalizedAmount = proportionalCommission(row.originalCommission, Math.max(refundedPrincipal, lostPrincipal), row.chargeAmount);
+    const target = proportionalCommission(row.originalCommission, Math.max(refundedPrincipal, disputedPrincipal), row.chargeAmount);
+    await updateObligation(ctx, row, {
+        disputeState,
+        lastRefundId: exposure.refundId ?? row.lastRefundId,
+        disputeId: exposure.disputeId ?? row.disputeId,
+        refundedPrincipal,
+        disputedPrincipal,
+        lostPrincipal,
+        finalizedAmount,
+        provisionalAmount: target - finalizedAmount,
+    });
+    return target;
+}
+/** Webhook upserts cannot rewrite a frozen commission or its confirmed balance. */
+export async function syncCommissionTransfer(ctx, transfer) {
+    const row = await ctx.db
+        .query("affiliateObligations")
+        .withIndex("by_transfer", (q) => q.eq("stripeTransferId", transfer.stripeTransferId))
+        .unique();
+    if (!row)
+        return;
+    await ensureCommissionObligation(ctx, transfer, row.chargeAmount);
+    const recoveredAmount = Math.max(row.recoveredAmount, transfer.reversedAmount ?? 0);
+    if (!Number.isSafeInteger(recoveredAmount) ||
+        recoveredAmount > row.originalCommission)
+        throw new Error("Invalid confirmed affiliate reversal balance.");
+    if (recoveredAmount > row.recoveredAmount && row.activeOperationId)
+        return;
+    await updateObligation(ctx, row, {
+        recoveredAmount,
+        ...(recoveredAmount > row.recoveredAmount && row.accounted
+            ? { needsReconciliation: true }
+            : {}),
+    });
+}
+//# sourceMappingURL=clawbacks.js.map

package/dist/component/settlement/clawbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clawbacks.js","sourceRoot":"","sources":["../../../src/component/settlement/clawbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAQtE,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,SAAiB,EACjB,MAAc;IAEd,KAAK,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACN,CAAC;IACD,IAAI,MAAM,KAAK,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAgB,EAChB,QAA0B,EAC1B,YAAoB;IAEpB,IACE,QAAQ,CAAC,IAAI,KAAK,WAAW;QAC7B,QAAQ,CAAC,aAAa;QACtB,CAAC,QAAQ,CAAC,cAAc;QAExB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;SAC1B,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAC9B,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CACpD;SACA,MAAM,EAAE,CAAC;IACZ,IAAI,QAAQ,EAAE,CAAC;QACb,IACE,QAAQ,CAAC,YAAY,KAAK,YAAY;YACtC,CAAC,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;gBAC1D,QAAQ,CAAC,MAAM;YACjB,QAAQ,CAAC,kBAAkB,KAAK,QAAQ,CAAC,oBAAoB;YAC7D,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YACvC,QAAQ,CAAC,cAAc,KAAK,QAAQ,CAAC,cAAc;YACnD,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;gBACrC,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC,eAAe,CAAC;YAExD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,EAAE;SAC5B,KAAK,CAAC,uBAAuB,CAAC;SAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,cAAe,CAAC,CACjD;SACA,MAAM,EAAE,CAAC;IACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE;SACzB,KAAK,CAAC,mBAAmB,CAAC;SAC1B,SAAS,CAAC,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,CACtC,CAAC;SACE,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,cAAe,CAAC;SAC9C,EAAE,CAAC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAC3D;SACA,MAAM,EAAE,CAAC;IACZ,IACE,UAAU;QACV,CAAC,UAAU,CAAC,KAAK,KAAK,YAAY;YAChC,UAAU,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;YACzC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CACxB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,IAAI,KAAK,WAAW;gBACxB,GAAG,CAAC,oBAAoB,KAAK,QAAQ,CAAC,oBAAoB;gBAC1D,GAAG,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAClE,CAAC;QAEJ,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,QAAQ,CAAC,cAAc,IAAI,CAAC,CAAC;IACrD,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;QACtC,eAAe,GAAG,CAAC;QACnB,eAAe,GAAG,QAAQ,CAAC,MAAM;QAEjC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;QACrD,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,UAAU,EAAE,eAAe;QACxE,eAAe,EAAE,UAAU,EAAE,eAAe;QAC5C,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,UAAU,EAAE,SAAS;QACtD,cAAc,EAAE,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;YACvE,EAAE,oBAAoB;QACxB,kBAAkB,EAAE,QAAQ,CAAC,oBAAoB;QACjD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,YAAY;QACZ,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,IAAI,QAAQ,CAAC,MAAM;QAClE,kBAAkB,EAAE,QAAQ,CAAC,MAAM;QACnC,SAAS,EAAE,OAAO,EAAE,GAAG;QACvB,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,CAAC;QAChB,eAAe,EAAE,CAAC;QAClB,iBAAiB,EAAE,CAAC;QACpB,eAAe;QACf,mBAAmB,EACjB,eAAe,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,IAAI,CAAC,CAAC,GAAG,CAAC;KACnE,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAE,CAAC;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,QAA0B,EAC1B,QAA4B;IAE5B,sBAAsB,CACpB,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,YAAY,CACtB,CAAC;IACF,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS;QACnD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,MAAM,GAAG,GAAG,MAAM,0BAA0B,CAC1C,GAAG,EACH,QAAQ,EACR,QAAQ,CAAC,YAAY,CACtB,CAAC;IACF,OAAO,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,GAAgC,EAChC,QAA4B;IAE5B,sBAAsB,CACpB,GAAG,CAAC,kBAAkB,EACtB,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,YAAY,CACtB,CAAC;IACF,IAAI,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,YAAY;QAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAChC,GAAG,CAAC,iBAAiB,EACrB,QAAQ,CAAC,iBAAiB,IAAI,CAAC,EAC/B,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAC;IACF,IAAI,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAC9B,GAAG,CAAC,iBAAiB,EACrB,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC5C,CAAC;IACF,IAAI,aAAa,GAAG,IAAI,CAAC,GAAG,CAC1B,GAAG,CAAC,aAAa,EACjB,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAClE,CAAC;IACF,MAAM,aAAa,GACjB,QAAQ,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC1C,MAAM,YAAY,GAChB,QAAQ,CAAC,IAAI,KAAK,SAAS;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC;QACrD,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;IACvB,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3B,iBAAiB,GAAG,CAAC,CAAC;QACtB,aAAa,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,KAAK,MAAM;QACxD,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC7D,MAAM,eAAe,GAAG,sBAAsB,CAC5C,GAAG,CAAC,kBAAkB,EACtB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAC1C,GAAG,CAAC,YAAY,CACjB,CAAC;IACF,MAAM,MAAM,GAAG,sBAAsB,CACnC,GAAG,CAAC,kBAAkB,EACtB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAC9C,GAAG,CAAC,YAAY,CACjB,CAAC;IACF,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE;QAC/B,YAAY;QACZ,YAAY,EAAE,QAAQ,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY;QACnD,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;QAC9C,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,eAAe;QACf,iBAAiB,EAAE,MAAM,GAAG,eAAe;KAC5C,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,QAA0B;IAE1B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE;SACrB,KAAK,CAAC,sBAAsB,CAAC;SAC7B,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAC9B,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CACpD;SACA,MAAM,EAAE,CAAC;IACZ,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,0BAA0B,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B,GAAG,CAAC,eAAe,EACnB,QAAQ,CAAC,cAAc,IAAI,CAAC,CAC7B,CAAC;IACF,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;QACtC,eAAe,GAAG,GAAG,CAAC,kBAAkB;QAExC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,IAAI,eAAe,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,iBAAiB;QAAE,OAAO;IAC3E,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE;QAC/B,eAAe;QACf,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,SAAS;YACxD,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE;YAC/B,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/component/settlement/mutations.d.ts

@@ -44,4 +44,20 @@ export declare const claimCommissionInvoice: import("convex/server").RegisteredM
     claimKey: string;
     replay: boolean;
 }>>;
+/** Explicit, resumable migration. Never fabricate legacy refund provenance. */
+export declare const migrateAffiliateObligations: import("convex/server").RegisteredMutation<"public", {
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<{
+    migrated: number;
+    skipped: number;
+    isDone: boolean;
+    continueCursor: string;
+}>>;
 //# sourceMappingURL=mutations.d.ts.map

package/dist/component/settlement/mutations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/mutations.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDtC,CAAC;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;GA2DjC,CAAC"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/mutations.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDtC,CAAC;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;GA2DjC,CAAC;AAEH,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;GA8CtC,CAAC"}

package/dist/component/settlement/mutations.js

@@ -1,3 +1,8 @@
+import { paginator } from "convex-helpers/server/pagination";
+import schema from "../schema.js";
+import { updateObligation } from "../affiliateRecovery/accounting.js";
+import { paginationOptsValidator } from "convex/server";
+import { ensureCommissionObligation } from "./clawbacks.js";
 import { v } from "convex/values";
 import { mutation } from "../_generated/server.js";
 import { allocationFields, commissionFields, termValidator } from "./schema.js";
@@ -101,4 +106,47 @@ export const claimCommissionInvoice = mutation({
         };
     },
 });
+/** Explicit, resumable migration. Never fabricate legacy refund provenance. */
+export const migrateAffiliateObligations = mutation({
+    args: { paginationOpts: paginationOptsValidator },
+    returns: v.object({
+        migrated: v.number(),
+        skipped: v.number(),
+        isDone: v.boolean(),
+        continueCursor: v.string(),
+    }),
+    handler: async (ctx, args) => {
+        const page = await paginator(ctx.db, schema)
+            .query("transfers")
+            .paginate({
+            ...args.paginationOpts,
+            numItems: Math.min(100, args.paginationOpts.numItems),
+        });
+        let migrated = 0;
+        let skipped = 0;
+        for (const transfer of page.page) {
+            if (transfer.role !== "affiliate" || transfer.reinstatement)
+                continue;
+            const allocation = transfer.sourceChargeId
+                ? await ctx.db
+                    .query("settlementAllocations")
+                    .withIndex("by_source_charge", (q) => q.eq("sourceChargeId", transfer.sourceChargeId))
+                    .unique()
+                : null;
+            if (!allocation) {
+                skipped++;
+                continue;
+            }
+            const obligation = await ensureCommissionObligation(ctx, transfer, allocation.gross);
+            await updateObligation(ctx, obligation, {});
+            migrated++;
+        }
+        return {
+            migrated,
+            skipped,
+            isDone: page.isDone,
+            continueCursor: page.continueCursor,
+        };
+    },
+});
 //# sourceMappingURL=mutations.js.map

package/dist/component/settlement/mutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/settlement/mutations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/settlement/mutations.ts"],"names":[],"mappings":"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"}

package/dist/component/settlement/queries.d.ts

@@ -26,4 +26,57 @@ export declare const getCommissionTerm: import("convex/server").RegisteredQuery<
     affiliateAccountId: string | undefined;
     firstPaidInvoiceId: string;
 } | null>>;
+/** Trusted host API: authorize account ownership before forwarding arguments. */
+export declare const listAffiliateObligations: import("convex/server").RegisteredQuery<"public", {
+    affiliateAccountId: string;
+    currency: string;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<import("convex/server").PaginationResult<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"affiliateObligations">;
+    accounted?: boolean | undefined;
+    activeOperationId?: import("convex/values").GenericId<"affiliateRecoveryOperations"> | undefined;
+    affiliateAccountId: string;
+    chargeAmount: number;
+    creditAmount?: number | undefined;
+    currency: string;
+    debtAmount?: number | undefined;
+    debtStatus?: "open" | "settled" | undefined;
+    disputeId?: string | undefined;
+    disputeState?: "lost" | "open" | "won" | undefined;
+    disputedPrincipal: number;
+    earningId?: import("convex/values").GenericId<"affiliateEarnings"> | undefined;
+    finalizedAmount: number;
+    lastError?: string | undefined;
+    lastRefundId?: string | undefined;
+    lastState?: string | undefined;
+    legacyReceiptIds?: string[] | undefined;
+    legacyRestorationIds?: string[] | undefined;
+    lostPrincipal: number;
+    needsReconciliation: boolean;
+    offsetAmount?: number | undefined;
+    operationSequence?: number | undefined;
+    operatorNote?: string | undefined;
+    originalCommission: number;
+    paymentId?: string | undefined;
+    paymentIntentId?: string | undefined;
+    provisionalAmount: number;
+    recoveredAmount: number;
+    refundedPrincipal: number;
+    releasedCommission?: number | undefined;
+    reservedRecovery?: number | undefined;
+    reservedRestoration?: number | undefined;
+    restoredAmount?: number | undefined;
+    sourceChargeId: string;
+    sourceInvoiceId?: string | undefined;
+    storeAccountId?: string | undefined;
+    stripeTransferId?: string | undefined;
+}>>>;
 //# sourceMappingURL=queries.d.ts.map

package/dist/component/settlement/queries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;UAUlC,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;UAkB5B,CAAC"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;UAUlC,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;UAkB5B,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyBnC,CAAC"}

package/dist/component/settlement/queries.js

@@ -1,3 +1,7 @@
+import { paginator } from "convex-helpers/server/pagination";
+import schema from "../schema.js";
+import { paginationOptsValidator, paginationResultValidator, } from "convex/server";
+import { obligationFields } from "./clawbackSchema.js";
 import { v } from "convex/values";
 import { query } from "../_generated/server.js";
 import { allocationFields, commissionFields } from "./schema.js";
@@ -32,4 +36,26 @@ export const getCommissionTerm = query({
         };
     },
 });
+/** Trusted host API: authorize account ownership before forwarding arguments. */
+export const listAffiliateObligations = query({
+    args: {
+        affiliateAccountId: v.string(),
+        currency: v.string(),
+        paginationOpts: paginationOptsValidator,
+    },
+    returns: paginationResultValidator(v.object({
+        ...obligationFields,
+        _id: v.id("affiliateObligations"),
+        _creationTime: v.number(),
+    })),
+    handler: (ctx, args) => paginator(ctx.db, schema)
+        .query("affiliateObligations")
+        .withIndex("by_affiliate_currency", (q) => q
+        .eq("affiliateAccountId", args.affiliateAccountId)
+        .eq("currency", args.currency))
+        .paginate({
+        ...args.paginationOpts,
+        numItems: Math.min(100, args.paginationOpts.numItems),
+    }),
+});
 //# sourceMappingURL=queries.js.map

package/dist/component/settlement/queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,GAAG,gBAAgB;IACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;IAC3C,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACrB,GAAG,CAAC,EAAE;SACH,KAAK,CAAC,uBAAuB,CAAC;SAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;SACA,KAAK,EAAE;CACb,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;IACrC,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE;aACrB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;aACA,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"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"}

package/dist/react/workflows/AffiliateRecovery.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from "react";
+import type { AffiliateRecoverySnapshot, AffiliateRecoveryObligation, AffiliateRecoveryOperation } from "../../client/affiliateRecovery.js";
+export type RecoveryMetric = {
+    key: string;
+    label: string;
+    amount: number;
+    formattedValue: string;
+};
+export type RecoveryAdjustment = {
+    row: AffiliateRecoveryObligation;
+    source: string;
+    commission: string;
+    recovered: string;
+    debt: string;
+    status: string;
+};
+export type AffiliateRecoveryView = {
+    adjustments: RecoveryAdjustment[];
+    metrics: RecoveryMetric[];
+    rows: AffiliateRecoveryObligation[];
+    currency: string;
+    isLoading: boolean;
+    isComplete: boolean;
+    isPending: boolean;
+    error: string | null;
+    retry: (id: string) => Promise<unknown>;
+};
+export type AffiliateRecoveryProps = {
+    snapshot: AffiliateRecoverySnapshot | undefined | null;
+    currency: string;
+    showMetrics?: boolean;
+    locale?: string;
+    className?: string;
+    onRetry?: (obligationId: string) => Promise<unknown>;
+    onInspect?: (obligationId: string) => void;
+    sourceHref?: (row: AffiliateRecoveryObligation) => string | undefined;
+    children?: (state: AffiliateRecoveryView) => ReactNode;
+};
+/** Reusable, unstyled recovery state for earnings, referred sales and payouts. */
+export declare function AffiliateRecovery({ snapshot, showMetrics, currency, locale, className, onRetry, onInspect, sourceHref, children, }: AffiliateRecoveryProps): import("react").JSX.Element;
+export declare function AffiliateRecoveryHistory({ operations, currency, locale, }: {
+    operations: AffiliateRecoveryOperation[];
+    currency: string;
+    locale?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=AffiliateRecovery.d.ts.map

package/dist/react/workflows/AffiliateRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AffiliateRecovery.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/AffiliateRecovery.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,mCAAmC,CAAC;AAG3C,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,2BAA2B,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,IAAI,EAAE,2BAA2B,EAAE,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,yBAAyB,GAAG,SAAS,GAAG,IAAI,CAAC;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,2BAA2B,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,SAAS,CAAC;CACxD,CAAC;AACF,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAkB,EAClB,QAAQ,EACR,MAAM,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,UAAU,EACV,QAAQ,GACT,EAAE,sBAAsB,+BAkLxB;AACD,wBAAgB,wBAAwB,CAAC,EACvC,UAAU,EACV,QAAQ,EACR,MAAM,GACP,EAAE;IACD,UAAU,EAAE,0BAA0B,EAAE,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,+BA6BA"}

package/dist/react/workflows/AffiliateRecovery.js

@@ -0,0 +1,84 @@
+"use client";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { formatPrice } from "../lib/price-helpers.js";
+import { useWorkflowAction } from "./useWorkflowAction.js";
+/** Reusable, unstyled recovery state for earnings, referred sales and payouts. */
+export function AffiliateRecovery({ snapshot, showMetrics = true, currency, locale, className, onRetry, onInspect, sourceHref, children, }) {
+    const action = useWorkflowAction(async (id) => onRetry?.(id), `affiliate-recovery:${currency}`);
+    const balance = snapshot?.balance;
+    if ((balance && balance.currency !== currency) ||
+        snapshot?.obligations.page.some((row) => row.currency !== currency))
+        throw new Error("Affiliate recovery display cannot mix currencies.");
+    const definitions = [
+        ["originalCommission", "Original commission"],
+        ["recoveredAmount", "Reversed"],
+        ["outstandingDebt", "Outstanding debt"],
+        ["offsetAmount", "Recovered from future earnings"],
+        ["withheldAmount", "Withheld earnings"],
+        ["reservedRecovery", "Pending recovery"],
+        ["reservedRestoration", "Pending restoration"],
+        ["restoredAmount", "Restored"],
+        ["restorationDue", "Restoration owed"],
+        ["netPayable", "Net payable"],
+    ];
+    const metrics = definitions.map(([key, label]) => {
+        const amount = balance?.[key] ?? 0;
+        return {
+            key,
+            label,
+            amount,
+            formattedValue: formatPrice(amount, currency, locale),
+        };
+    });
+    const adjustments = (snapshot?.obligations.page ?? []).map((row) => ({
+        row,
+        source: [
+            row.sourceChargeId,
+            row.storeAccountId,
+            row.sourceInvoiceId,
+            row.paymentId,
+            row.lastRefundId,
+            row.disputeId,
+        ]
+            .filter(Boolean)
+            .join(" · "),
+        commission: formatPrice(row.originalCommission, row.currency, locale),
+        recovered: formatPrice(row.recoveredAmount + (row.offsetAmount ?? 0) - (row.restoredAmount ?? 0), row.currency, locale),
+        debt: formatPrice(row.debtAmount ?? 0, row.currency, locale),
+        status: row.needsReconciliation
+            ? "Operator reconciliation required"
+            : (row.lastState ?? "Settled"),
+    }));
+    const state = {
+        adjustments,
+        metrics,
+        rows: snapshot?.obligations.page ?? [],
+        currency,
+        isLoading: snapshot === undefined,
+        isComplete: snapshot?.obligations.isDone ?? false,
+        isPending: action.isPending,
+        error: action.error,
+        retry: action.run,
+    };
+    if (children)
+        return _jsx(_Fragment, { children: children(state) });
+    return (_jsxs("section", { className: className, "data-better-stripe": "affiliate-recovery", children: [_jsxs("h2", { children: ["Commission recovery (", currency.toUpperCase(), ")"] }), state.isLoading ? (_jsx("p", { role: "status", children: "Loading commission recovery\u2026" })) : snapshot === null ? (_jsx("p", { children: "Sign in to view your commission recovery." })) : (_jsxs(_Fragment, { children: [showMetrics && (_jsx("dl", { children: metrics.map((metric) => (_jsxs("div", { children: [_jsx("dt", { children: metric.label }), _jsx("dd", { children: metric.formattedValue })] }, metric.key))) })), state.error && _jsx("p", { role: "alert", children: state.error }), !state.rows.length && _jsx("p", { children: "No commission adjustments yet." }), _jsxs("table", { children: [_jsx("caption", { children: "Commission adjustments" }), _jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", children: "Original sale" }), _jsx("th", { scope: "col", children: "Commission" }), _jsx("th", { scope: "col", children: "Recovered" }), _jsx("th", { scope: "col", children: "Debt" }), _jsx("th", { scope: "col", children: "State" }), (onRetry || onInspect) && _jsx("th", { scope: "col", children: "Action" })] }) }), _jsx("tbody", { children: state.rows.map((row) => (_jsxs("tr", { children: [_jsxs("td", { children: [sourceHref?.(row) ? (_jsx("a", { href: sourceHref(row), children: row.sourceChargeId })) : (row.sourceChargeId), _jsx("br", {}), [
+                                                    row.storeAccountId,
+                                                    row.sourceInvoiceId,
+                                                    row.paymentId,
+                                                    row.lastRefundId,
+                                                    row.disputeId,
+                                                ]
+                                                    .filter(Boolean)
+                                                    .join(" · ")] }), _jsx("td", { children: formatPrice(row.originalCommission, row.currency, locale) }), _jsx("td", { children: formatPrice(row.recoveredAmount +
+                                                (row.offsetAmount ?? 0) -
+                                                (row.restoredAmount ?? 0), row.currency, locale) }), _jsx("td", { children: formatPrice(row.debtAmount ?? 0, row.currency, locale) }), _jsxs("td", { children: [row.needsReconciliation
+                                                    ? "Operator reconciliation required"
+                                                    : (row.lastState ?? "Settled"), row.lastError && _jsx("p", { children: row.lastError })] }), (onRetry || onInspect) && (_jsxs("td", { children: [onInspect && (_jsx("button", { type: "button", onClick: () => onInspect(row._id), children: "Inspect attempts" })), onRetry && (_jsx("button", { type: "button", disabled: state.isPending, onClick: () => {
+                                                        void state.retry(row._id);
+                                                    }, children: "Reconcile" }))] }))] }, row._id))) })] }), !state.isComplete && (_jsx("p", { children: "More adjustments are available. Totals include the complete account ledger." }))] }))] }));
+}
+export function AffiliateRecoveryHistory({ operations, currency, locale, }) {
+    return (_jsxs("table", { "data-better-stripe": "affiliate-recovery-history", children: [_jsx("caption", { children: "Recovery receipts and attempts" }), _jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", children: "Operation" }), _jsx("th", { scope: "col", children: "Amount" }), _jsx("th", { scope: "col", children: "Outcome" }), _jsx("th", { scope: "col", children: "Receipt" })] }) }), _jsx("tbody", { children: operations.map((op) => (_jsxs("tr", { children: [_jsxs("td", { children: [op.kind, " \u00B7 ", op.sourceEventId ?? op._id] }), _jsx("td", { children: formatPrice(op.amount, currency, locale) }), _jsxs("td", { children: [op.state, op.error && _jsx("p", { children: op.error })] }), _jsx("td", { children: op.receiptId ?? "Unconfirmed" })] }, op._id))) })] }));
+}
+//# sourceMappingURL=AffiliateRecovery.js.map

package/dist/react/workflows/AffiliateRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AffiliateRecovery.js","sourceRoot":"","sources":["../../../src/react/workflows/AffiliateRecovery.tsx"],"names":[],"mappings":"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"}

package/dist/react/workflows/index.d.ts

@@ -77,6 +77,8 @@ export { AffiliateRateEditor } from "./AffiliateRateEditor.js";
 export type { AffiliateRateUpdate, AffiliateRateEditorProps, AffiliateRateEditorState, } from "./AffiliateRateEditor.js";
 export { AffiliatePayoutEditor } from "./AffiliatePayoutEditor.js";
 export type { AffiliateCommissionTerm, AffiliatePayoutEditorProps, AffiliatePayoutEditorState, AffiliatePayoutUpdate, } from "./AffiliatePayoutEditor.js";
+export { AffiliateRecovery, AffiliateRecoveryHistory, } from "./AffiliateRecovery.js";
+export type { AffiliateRecoveryProps, AffiliateRecoveryView, RecoveryMetric, } from "./AffiliateRecovery.js";
 export { EvidenceUpload } from "./EvidenceUpload.js";
 export type { EvidenceUploadProps } from "./EvidenceUpload.js";
 //# sourceMappingURL=index.d.ts.map