@fantastic.dev/better-stripe 0.23.2 → 0.25.0

package/dist/client/connect/payoutWorker.js

@@ -0,0 +1,78 @@
+import { runMutationOrThrow } from "../helpers.js";
+import { componentRef } from "../webhooks/helpers.js";
+/** Host cron only. No method on this worker represents a customer withdrawal request. */
+export class PayoutWorkerClient {
+    component;
+    release;
+    reconcile;
+    constructor(component, release, reconcile) {
+        this.component = component;
+        this.release = release;
+        this.reconcile = reconcile;
+    }
+    get(ctx, scope) {
+        return ctx.runQuery(componentRef(this.component, "payoutWorker/queries/get"), {
+            accountId: scope.accountId,
+            ownerKey: scope.ownerKey,
+            currency: scope.currency,
+        });
+    }
+    policies(ctx, paginationOpts) {
+        return ctx.runQuery(componentRef(this.component, "payoutWorker/queries/policies"), { paginationOpts });
+    }
+    recovering(ctx, paginationOpts) {
+        return ctx.runQuery(componentRef(this.component, "payoutWorker/queries/recovering"), { paginationOpts });
+    }
+    changing(ctx, paginationOpts) {
+        return ctx.runQuery(componentRef(this.component, "payoutWorker/queries/changing"), { paginationOpts });
+    }
+    async run(ctx, opts) {
+        if (!Number.isSafeInteger(opts.independentLiabilities) ||
+            opts.independentLiabilities < 0 ||
+            (opts.maxPages !== undefined &&
+                (!Number.isInteger(opts.maxPages) ||
+                    opts.maxPages < 1 ||
+                    opts.maxPages > 100)))
+            throw new Error("Invalid automatic payout liabilities or page budget.");
+        const scope = {
+            accountId: opts.accountId,
+            ownerKey: opts.ownerKey,
+            currency: opts.currency,
+        };
+        const started = (await runMutationOrThrow(ctx, componentRef(this.component, "payoutWorker/mutations/begin"), {
+            ...scope,
+            cadenceMs: opts.cadenceMs ?? 300000,
+        }));
+        if (started.status === "held")
+            return started;
+        const operationKey = started.job.operationKey;
+        const finish = (reason) => runMutationOrThrow(ctx, componentRef(this.component, "payoutWorker/mutations/finish"), { ...scope, operationKey, generation: started.job.generation, reason });
+        let payout;
+        try {
+            payout = started.reconcileOnly
+                ? await this.reconcile(ctx, {
+                    ...scope,
+                    operationKey,
+                    maxPages: opts.maxPages,
+                })
+                : await this.release(ctx, {
+                    ...scope,
+                    operationKey,
+                    independentLiabilities: opts.independentLiabilities,
+                    maxPages: opts.maxPages,
+                });
+        }
+        catch (error) {
+            try {
+                await finish("worker_error");
+            }
+            catch (completionError) {
+                throw new AggregateError([error, completionError], "Payout worker outcome requires reconciliation.");
+            }
+            throw error;
+        }
+        const reason = payout.status === "held" ? payout.reason : payout.claim.status;
+        return { status: "completed", job: await finish(reason), payout };
+    }
+}
+//# sourceMappingURL=payoutWorker.js.map

package/dist/client/connect/payoutWorker.js.map

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

package/dist/client/connect/payouts.d.ts

@@ -27,6 +27,8 @@ export declare function getAccountBalance(stripe: Stripe, opts: {
     stripeAccountId: string;
 }): Promise<AccountBalance[]>;
 export type CreatePayoutOptions = {
+    /** Host-authorized minimum in the payout currency. */
+    minimumAmount?: number;
     stripeAccountId: string;
     amount: number;
     currency?: string;
@@ -34,7 +36,7 @@ export type CreatePayoutOptions = {
     /** Stripe idempotency key for retry-safe payout creation. */
     idempotencyKey?: string;
 };
-export declare function createPayout(stripe: Stripe, _ctx: RunCtx, opts: CreatePayoutOptions): Promise<{
+export declare function createPayout(stripe: Stripe, ctx: RunCtx, opts: CreatePayoutOptions, component?: Component): Promise<{
     stripePayoutId: string;
 }>;
 export declare function getPayout(component: Component, ctx: RunCtx, opts: {

package/dist/client/connect/payouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payouts.d.ts","sourceRoot":"","sources":["../../../src/client/connect/payouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAOvD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB;;GAgB1B;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,gBAM3B;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,gBAO3E"}
+{"version":3,"file":"payouts.d.ts","sourceRoot":"","sources":["../../../src/client/connect/payouts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAOvD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB3B;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,mBAAmB,EACzB,SAAS,CAAC,EAAE,SAAS;;GAmEtB;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,gBAM3B;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,gBAO3E"}

package/dist/client/connect/payouts.js

@@ -1,3 +1,5 @@
+import { reserveAffiliatePayout, completeAffiliatePayout, reconcileAffiliatePayout, } from "../affiliateRecovery/payoutGate.js";
+import { classifyRecoveryError } from "../affiliateRecovery/provider.js";
 import { componentRef } from "../webhooks/helpers.js";
 /**
  * Retrieve a connected account's balance (BTS-65), scoped to that account via
@@ -26,18 +28,49 @@ export async function getAccountBalance(stripe, opts) {
         entryFor(p.currency).pending += p.amount;
     return [...byCurrency.values()];
 }
-export async function createPayout(stripe, _ctx, opts) {
-    const payout = await stripe.payouts.create({
-        amount: opts.amount,
-        currency: opts.currency ?? "usd",
-        metadata: opts.metadata ?? undefined,
-    }, {
-        stripeAccount: opts.stripeAccountId,
-        ...(opts.idempotencyKey !== undefined
-            ? { idempotencyKey: opts.idempotencyKey }
-            : {}),
-    });
-    return { stripePayoutId: payout.id };
+export async function createPayout(stripe, ctx, opts, component) {
+    const release = component
+        ? await reserveAffiliatePayout(component, ctx, opts)
+        : null;
+    if (release?.state === "submitted")
+        return { stripePayoutId: release.stripePayoutId };
+    if (release?.state === "failed")
+        throw new Error("Affiliate payout failed; use a new authorized operation key.");
+    try {
+        if (release) {
+            const receiptId = await reconcileAffiliatePayout(stripe, release);
+            if (receiptId) {
+                await completeAffiliatePayout(component, ctx, release.operationKey, "submitted", receiptId);
+                return { stripePayoutId: receiptId };
+            }
+        }
+        if (release) {
+            if (Date.now() - release.createdAt >= 23 * 60 * 60 * 1000)
+                throw new Error("Affiliate payout idempotency window expired; reconcile the provider receipt before retrying.");
+            // Receipt lookup may yield while a refund records new debt.
+            await reserveAffiliatePayout(component, ctx, opts);
+        }
+        const payout = await stripe.payouts.create({
+            amount: opts.amount,
+            currency: opts.currency ?? "usd",
+            metadata: release
+                ? { ...opts.metadata, bsAffiliatePayout: release._id }
+                : (opts.metadata ?? undefined),
+        }, {
+            stripeAccount: opts.stripeAccountId,
+            ...(opts.idempotencyKey !== undefined
+                ? { idempotencyKey: opts.idempotencyKey }
+                : {}),
+        });
+        if (release)
+            await completeAffiliatePayout(component, ctx, release.operationKey, "submitted", payout.id);
+        return { stripePayoutId: payout.id };
+    }
+    catch (error) {
+        if (release)
+            await completeAffiliatePayout(component, ctx, release.operationKey, classifyRecoveryError(error).state === "unknown" ? "unknown" : "failed");
+        throw error;
+    }
 }
 export async function getPayout(component, ctx, opts) {
     return ctx.runQuery(componentRef(component, "connect/queries/getPayout"), opts);

package/dist/client/connect/payouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"payouts.js","sourceRoot":"","sources":["../../../src/client/connect/payouts.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAqBtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,IAAiC;IAEjC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE;QACvD,aAAa,EAAE,IAAI,CAAC,eAAe;KACpC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IACrD,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAkB,EAAE;QACpD,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;YAC/C,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS;QAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO;QAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1E,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAY,EACZ,IAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CACxC;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;QAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;KACrC,EACD;QACE,aAAa,EAAE,IAAI,CAAC,eAAe;QACnC,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;YACnC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;KACR,CACF,CAAC;IACF,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAoB,EACpB,GAAW,EACX,IAA0B;IAE1B,OAAO,GAAG,CAAC,QAAQ,CACjB,YAAY,CAAC,SAAS,EAAE,2BAA2B,CAAC,EACpD,IAAI,CACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAoB,EACpB,GAAW,EACX,IAA0E;IAE1E,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAChD,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,6BAA6B,CAAC,EAAE;QAC1E,GAAG,IAAI;QACP,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"payouts.js","sourceRoot":"","sources":["../../../src/client/connect/payouts.ts"],"names":[],"mappings":"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"}

package/dist/client/connect/refundPrincipal.d.ts

@@ -0,0 +1,4 @@
+import type Stripe from "stripe";
+/** Charge.amount_refunded also includes pending refunds; only success is final. */
+export declare function successfulRefundPrincipal(stripe: Stripe, chargeId: string): Promise<number>;
+//# sourceMappingURL=refundPrincipal.d.ts.map

package/dist/client/connect/refundPrincipal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refundPrincipal.d.ts","sourceRoot":"","sources":["../../../src/client/connect/refundPrincipal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,mFAAmF;AACnF,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,mBAoBjB"}

package/dist/client/connect/refundPrincipal.js

@@ -0,0 +1,21 @@
+/** Charge.amount_refunded also includes pending refunds; only success is final. */
+export async function successfulRefundPrincipal(stripe, chargeId) {
+    let principal = 0;
+    let count = 0;
+    for await (const refund of stripe.refunds.list({
+        charge: chargeId,
+        limit: 100,
+    })) {
+        if (++count > 1000)
+            throw new Error("Successful refund lookup limit exceeded.");
+        if (refund.status !== "succeeded")
+            continue;
+        if (!Number.isSafeInteger(refund.amount) ||
+            refund.amount < 0 ||
+            !Number.isSafeInteger(principal + refund.amount))
+            throw new Error("Invalid successful refund principal.");
+        principal += refund.amount;
+    }
+    return principal;
+}
+//# sourceMappingURL=refundPrincipal.js.map

package/dist/client/connect/refundPrincipal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refundPrincipal.js","sourceRoot":"","sources":["../../../src/client/connect/refundPrincipal.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAc,EACd,QAAgB;IAEhB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7C,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,GAAG;KACX,CAAC,EAAE,CAAC;QACH,IAAI,EAAE,KAAK,GAAG,IAAI;YAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QAC5C,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;YACpC,MAAM,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAEhD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/client/connect/reversalExecution.d.ts

@@ -0,0 +1,47 @@
+import type Stripe from "stripe";
+import type { Component, RunCtx } from "../helpers.js";
+export type ClaimedSlice = {
+    stripeTransferId: string;
+    /** Cumulative reversed amount this slice starts from. */
+    from: number;
+    /** Cumulative reversed amount this slice raises the leg to. */
+    to: number;
+    /** The leg's confirmed `reversedAmount` at claim time. */
+    confirmed: number;
+    commissionTracked?: boolean;
+};
+export type ReversalClaim = {
+    replay: boolean;
+    slices: ClaimedSlice[];
+};
+/**
+ * Execute the slices an operation claimed via `claimReversalSlices` (BTS-63).
+ * The claim already reserved this money atomically, so all that's left is
+ * moving it: one `bs_rev_<operationId>_<transferId>` reversal per slice, then
+ * confirming the new cumulative total in the ledger. A replayed claim always
+ * re-sends byte-identical params under the same key, which Stripe answers
+ * from its idempotency cache without moving money twice.
+ *
+ * Because Stripe prunes idempotency keys after ~24h (and a crash can land
+ * between the Stripe call and the ledger confirm), a replay first checks the
+ * transfer's live `amount_reversed`: if the slice's money already moved, it
+ * just confirms the ledger instead of re-sending the reversal.
+ *
+ * A slice only executes once every predecessor slice on its leg is confirmed
+ * (`confirmed ≥ from`). Without that gate, a sibling operation landing behind
+ * a transiently-failed claim would execute and confirm PAST the hole; the
+ * failed operation's retry would then see `confirmed ≥ to` and silently skip
+ * — its money would never move while the ledger says it did. Throwing instead
+ * fails this operation's webhook event, and at-least-once delivery retries
+ * both operations until the predecessor fills its hole and each claimed slice
+ * has actually moved. The ledger's `reversedAmount` therefore always covers a
+ * solid, hole-free prefix of the reversed axis — which is exactly what makes
+ * the `confirmed`/`amount_reversed` checks above sound.
+ */
+export declare function executeClaimedSlices(stripe: Stripe, component: Component, ctx: RunCtx, operationId: string, claim: ReversalClaim): Promise<{
+    reversals: {
+        stripeTransferId: string;
+        amount: number;
+    }[];
+}>;
+//# sourceMappingURL=reversalExecution.d.ts.map

package/dist/client/connect/reversalExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reversalExecution.d.ts","sourceRoot":"","sources":["../../../src/client/connect/reversalExecution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKvD,MAAM,MAAM,YAAY,GAAG;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC,CAgFxE"}

package/dist/client/connect/reversalExecution.js

@@ -0,0 +1,84 @@
+import { runMutationOrThrow } from "../helpers.js";
+import { componentRef } from "../webhooks/helpers.js";
+import { findCommissionReversal } from "./commissionReceipts.js";
+/**
+ * Execute the slices an operation claimed via `claimReversalSlices` (BTS-63).
+ * The claim already reserved this money atomically, so all that's left is
+ * moving it: one `bs_rev_<operationId>_<transferId>` reversal per slice, then
+ * confirming the new cumulative total in the ledger. A replayed claim always
+ * re-sends byte-identical params under the same key, which Stripe answers
+ * from its idempotency cache without moving money twice.
+ *
+ * Because Stripe prunes idempotency keys after ~24h (and a crash can land
+ * between the Stripe call and the ledger confirm), a replay first checks the
+ * transfer's live `amount_reversed`: if the slice's money already moved, it
+ * just confirms the ledger instead of re-sending the reversal.
+ *
+ * A slice only executes once every predecessor slice on its leg is confirmed
+ * (`confirmed ≥ from`). Without that gate, a sibling operation landing behind
+ * a transiently-failed claim would execute and confirm PAST the hole; the
+ * failed operation's retry would then see `confirmed ≥ to` and silently skip
+ * — its money would never move while the ledger says it did. Throwing instead
+ * fails this operation's webhook event, and at-least-once delivery retries
+ * both operations until the predecessor fills its hole and each claimed slice
+ * has actually moved. The ledger's `reversedAmount` therefore always covers a
+ * solid, hole-free prefix of the reversed axis — which is exactly what makes
+ * the `confirmed`/`amount_reversed` checks above sound.
+ */
+export async function executeClaimedSlices(stripe, component, ctx, operationId, claim) {
+    const reversals = [];
+    for (const slice of claim.slices) {
+        const receiptAmount = slice.to - slice.from;
+        if (slice.commissionTracked && claim.replay) {
+            const receipt = await findCommissionReversal(stripe, slice.stripeTransferId, operationId, receiptAmount);
+            if (receipt) {
+                await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/recordTransferReversal"), {
+                    stripeTransferId: slice.stripeTransferId,
+                    reversedAmount: slice.to,
+                    receipt: {
+                        stripeReversalId: receipt.id,
+                        operationId,
+                        amount: receiptAmount,
+                    },
+                });
+                continue;
+            }
+            if (slice.confirmed >= slice.to)
+                throw new Error("Commission reversal requires receipt reconciliation.");
+        }
+        if (slice.confirmed >= slice.to)
+            continue; // executed and recorded already
+        if (slice.confirmed < slice.from) {
+            throw new Error(`reversal slice [${slice.from},${slice.to}) on ${slice.stripeTransferId} ` +
+                `blocked: predecessor claim unexecuted (confirmed=${slice.confirmed})`);
+        }
+        if (claim.replay && !slice.commissionTracked) {
+            const transfer = await stripe.transfers.retrieve(slice.stripeTransferId);
+            if ((transfer.amount_reversed ?? 0) >= slice.to) {
+                // The money moved on a previous attempt that died before confirming.
+                await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/recordTransferReversal"), {
+                    stripeTransferId: slice.stripeTransferId,
+                    reversedAmount: slice.to,
+                });
+                continue;
+            }
+        }
+        const amount = slice.to - slice.from;
+        const receipt = await stripe.transfers.createReversal(slice.stripeTransferId, {
+            amount,
+            ...(slice.commissionTracked
+                ? { metadata: { bsReversalOperation: operationId } }
+                : {}),
+        }, { idempotencyKey: `bs_rev_${operationId}_${slice.stripeTransferId}` });
+        await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/recordTransferReversal"), {
+            stripeTransferId: slice.stripeTransferId,
+            reversedAmount: slice.to,
+            ...(slice.commissionTracked
+                ? { receipt: { stripeReversalId: receipt.id, operationId, amount } }
+                : {}),
+        });
+        reversals.push({ stripeTransferId: slice.stripeTransferId, amount });
+    }
+    return { reversals };
+}
+//# sourceMappingURL=reversalExecution.js.map

package/dist/client/connect/reversalExecution.js.map

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

package/dist/client/connect/transfers.d.ts

@@ -104,9 +104,9 @@ export declare function reverseTransfers(stripe: Stripe, component: Component, c
     }[];
 }>;
 /**
- * Reverse a split sale's transfers pro-rata to the cumulatively refunded
- * amount (BTS-34) — the refund counterpart of the dispute clawback. Every leg
- * converges on a cumulative reversal TARGET, `round(leg × amountRefunded /
+ * Reverse a split sale's transfers pro-rata to cumulative succeeded refunds.
+ * Affiliate legs retain the larger refund/dispute commission exposure. Other
+ * legs converge on a cumulative reversal TARGET, `round(leg × amountRefunded /
  * chargeAmount)`, and only the delta above the ledger's recorded
  * `reversedAmount` is reversed. Delta-to-target (rather than percent-of-
  * original like {@link reverseTransfers}) is what makes at-least-once webhook
@@ -127,7 +127,7 @@ export declare function reverseTransfersForRefund(stripe: Stripe, component: Com
     refundId: string;
     /** The original charge amount (minor units). */
     chargeAmount: number;
-    /** Stripe's cumulative `charge.amount_refunded`, including this refund. */
+    /** Cumulative principal of succeeded refunds; exclude pending/failed refunds. */
     amountRefunded: number;
 }): Promise<{
     reversals: {
@@ -135,6 +135,7 @@ export declare function reverseTransfersForRefund(stripe: Stripe, component: Com
         amount: number;
     }[];
 }>;
+export { reverseTransfersForDispute } from "../affiliateRecovery/disputes.js";
 /**
  * Webhook-driven split transfer engine (BTS-22). After a charge succeeds for a
  * separate-charges sale, fan funds out to each split recipient: compute the
@@ -163,6 +164,9 @@ export declare function reinstateTransfers(stripe: Stripe, component: Component,
     sourceChargeId: string;
     operationId: string;
     currency: string;
+    excludeAffiliates?: boolean;
+    chargeAmount?: number;
+    refundedPrincipal?: number;
 }): Promise<{
     reinstated: {
         destinationAccountId: string;

package/dist/client/connect/transfers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../src/client/connect/transfers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../src/client/connect/transfers.ts"],"names":[],"mappings":"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"}

package/dist/client/connect/transfers.js

@@ -1,58 +1,17 @@
+import { reconcileAffiliateCharge } from "../affiliateRecovery/engine.js";
+import { executeClaimedSlices, } from "./reversalExecution.js";
 import { recoverSettlementTransfers } from "../settlement/reconciliation.js";
 import { executeResolvedTransfers } from "../settlement/execution.js";
 import { computeSplit } from "../core/fees.js";
 import { runMutationOrThrow } from "../helpers.js";
 import { componentRef } from "../webhooks/helpers.js";
-/**
- * Execute the slices an operation claimed via `claimReversalSlices` (BTS-63).
- * The claim already reserved this money atomically, so all that's left is
- * moving it: one `bs_rev_<operationId>_<transferId>` reversal per slice, then
- * confirming the new cumulative total in the ledger. A replayed claim always
- * re-sends byte-identical params under the same key, which Stripe answers
- * from its idempotency cache without moving money twice.
- *
- * Because Stripe prunes idempotency keys after ~24h (and a crash can land
- * between the Stripe call and the ledger confirm), a replay first checks the
- * transfer's live `amount_reversed`: if the slice's money already moved, it
- * just confirms the ledger instead of re-sending the reversal.
- *
- * A slice only executes once every predecessor slice on its leg is confirmed
- * (`confirmed ≥ from`). Without that gate, a sibling operation landing behind
- * a transiently-failed claim would execute and confirm PAST the hole; the
- * failed operation's retry would then see `confirmed ≥ to` and silently skip
- * — its money would never move while the ledger says it did. Throwing instead
- * fails this operation's webhook event, and at-least-once delivery retries
- * both operations until the predecessor fills its hole and each claimed slice
- * has actually moved. The ledger's `reversedAmount` therefore always covers a
- * solid, hole-free prefix of the reversed axis — which is exactly what makes
- * the `confirmed`/`amount_reversed` checks above sound.
- */
-async function executeClaimedSlices(stripe, component, ctx, operationId, claim) {
-    const reversals = [];
-    for (const slice of claim.slices) {
-        if (slice.confirmed >= slice.to)
-            continue; // executed and recorded already
-        if (slice.confirmed < slice.from) {
-            throw new Error(`reversal slice [${slice.from},${slice.to}) on ${slice.stripeTransferId} ` +
-                `blocked: predecessor claim unexecuted (confirmed=${slice.confirmed})`);
-        }
-        if (claim.replay) {
-            const transfer = await stripe.transfers.retrieve(slice.stripeTransferId);
-            if ((transfer.amount_reversed ?? 0) >= slice.to) {
-                // The money moved on a previous attempt that died before confirming.
-                await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/recordTransferReversal"), {
-                    stripeTransferId: slice.stripeTransferId,
-                    reversedAmount: slice.to,
-                });
-                continue;
-            }
-        }
-        const amount = slice.to - slice.from;
-        await stripe.transfers.createReversal(slice.stripeTransferId, { amount }, { idempotencyKey: `bs_rev_${operationId}_${slice.stripeTransferId}` });
-        await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/recordTransferReversal"), { stripeTransferId: slice.stripeTransferId, reversedAmount: slice.to });
-        reversals.push({ stripeTransferId: slice.stripeTransferId, amount });
-    }
-    return { reversals };
+async function trackedAffiliateTransfers(component, ctx, sourceChargeId) {
+    const rows = (await ctx.runQuery(componentRef(component, "affiliateRecovery/queries/chargeObligations"), { sourceChargeId }));
+    return new Set(Array.isArray(rows)
+        ? rows
+            .filter((row) => row.accounted && row.stripeTransferId)
+            .map((row) => row.stripeTransferId)
+        : []);
 }
 /** Stripe prunes idempotency keys after ~24h; a release must wait past this. */
 const REVERSAL_IDEMPOTENCY_WINDOW_MS = 24 * 60 * 60 * 1000;
@@ -108,11 +67,29 @@ export async function reclaimReversalClaim(stripe, component, ctx, opts) {
         const slices = [];
         for (const s of op.slices) {
             const leg = (await ctx.runQuery(componentRef(component, "connect/queries/getTransferByStripeId"), { stripeTransferId: s.stripeTransferId }));
-            slices.push({ ...s, confirmed: leg?.reversedAmount ?? 0 });
+            slices.push({
+                ...s,
+                confirmed: leg?.reversedAmount ?? 0,
+                ...(op.commissionExposure
+                    ? { commissionTracked: leg?.role === "affiliate" }
+                    : {}),
+            });
         }
-        const { reversals } = await executeClaimedSlices(stripe, component, ctx, op.operationId, { replay: true, slices });
+        const tracked = op.commissionExposure
+            ? null
+            : await trackedAffiliateTransfers(component, ctx, op.sourceChargeId);
+        const usesRecoveryLedger = !!op.commissionExposure || !!tracked?.size;
+        const { reversals } = await executeClaimedSlices(stripe, component, ctx, op.operationId, {
+            replay: true,
+            slices: slices.filter((s) => !s.commissionTracked && !tracked?.has(s.stripeTransferId)),
+        });
+        if (usesRecoveryLedger)
+            await reconcileAffiliateCharge(stripe, component, ctx, op.sourceChargeId);
         return { mode: "reexecute", reversals };
     }
+    if (op.commissionExposure ||
+        (await trackedAffiliateTransfers(component, ctx, op.sourceChargeId)).size)
+        throw new Error("Affiliate exposure audit claims cannot be released; use affiliateRecovery.retry or reviewLegacy.");
     // release: age-gate against the idempotency window, then verify live Stripe.
     const minAgeMs = opts.minAgeMs ?? REVERSAL_IDEMPOTENCY_WINDOW_MS;
     const now = opts.now ?? Date.now();
@@ -169,6 +146,8 @@ export async function reverseTransfers(stripe, component, ctx, opts) {
         throw new Error("reverseTransfers: amount must be a non-negative integer");
     }
     await recoverSettlementTransfers(stripe, component, ctx, opts.sourceChargeId);
+    if ((await trackedAffiliateTransfers(component, ctx, opts.sourceChargeId)).size)
+        throw new Error("Use affiliateRecovery.retry for tracked affiliate commission recovery.");
     if (opts.operationId) {
         const claim = (await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/claimReversalSlices"), {
             operationId: opts.operationId,
@@ -224,9 +203,9 @@ export async function reverseTransfers(stripe, component, ctx, opts) {
     return { reversals };
 }
 /**
- * Reverse a split sale's transfers pro-rata to the cumulatively refunded
- * amount (BTS-34) — the refund counterpart of the dispute clawback. Every leg
- * converges on a cumulative reversal TARGET, `round(leg × amountRefunded /
+ * Reverse a split sale's transfers pro-rata to cumulative succeeded refunds.
+ * Affiliate legs retain the larger refund/dispute commission exposure. Other
+ * legs converge on a cumulative reversal TARGET, `round(leg × amountRefunded /
  * chargeAmount)`, and only the delta above the ledger's recorded
  * `reversedAmount` is reversed. Delta-to-target (rather than percent-of-
  * original like {@link reverseTransfers}) is what makes at-least-once webhook
@@ -250,14 +229,24 @@ export async function reverseTransfersForRefund(stripe, component, ctx, opts) {
     const claim = (await runMutationOrThrow(ctx, componentRef(component, "connect/mutations/claimReversalSlices"), {
         operationId: opts.refundId,
         sourceChargeId: opts.sourceChargeId,
+        commissionExposure: {
+            kind: "refund",
+            refundId: opts.refundId,
+            chargeAmount: opts.chargeAmount,
+            principal: opts.amountRefunded,
+            finalized: true,
+        },
         mode: {
             kind: "fraction",
             chargeAmount: opts.chargeAmount,
             amountRefunded: opts.amountRefunded,
         },
     }));
-    return executeClaimedSlices(stripe, component, ctx, opts.refundId, claim);
+    const result = await executeClaimedSlices(stripe, component, ctx, opts.refundId, { ...claim, slices: claim.slices.filter((s) => !s.commissionTracked) });
+    await reconcileAffiliateCharge(stripe, component, ctx, opts.sourceChargeId);
+    return result;
 }
+export { reverseTransfersForDispute } from "../affiliateRecovery/disputes.js";
 /**
  * Webhook-driven split transfer engine (BTS-22). After a charge succeeds for a
  * separate-charges sale, fan funds out to each split recipient: compute the
@@ -291,7 +280,13 @@ export async function reinstateTransfers(stripe, component, ctx, opts) {
     const transfers = ((await ctx.runQuery(componentRef(component, "connect/queries/listTransfersByCharge"), { sourceChargeId: opts.sourceChargeId })) ?? []);
     const reinstated = [];
     for (const t of transfers) {
-        const amount = t.reversedAmount ?? 0;
+        if (opts.excludeAffiliates && t.role === "affiliate")
+            continue;
+        const independentRefund = opts.chargeAmount
+            ? Math.round(t.amount *
+                Math.min(1, (opts.refundedPrincipal ?? 0) / opts.chargeAmount))
+            : 0;
+        const amount = Math.max(0, (t.reversedAmount ?? 0) - independentRefund);
         if (amount <= 0)
             continue; // nothing was clawed back from this leg
         // Use the original leg's currency; fall back to the dispute currency for