@fantastic.dev/better-stripe 0.23.1 → 0.24.0

package/dist/component/affiliateRecovery/queries.js

@@ -0,0 +1,113 @@
+import { paginator } from "convex-helpers/server/pagination";
+import schema from "../schema.js";
+import { paginationOptsValidator, paginationResultValidator, } from "convex/server";
+import { v } from "convex/values";
+import { query } from "../_generated/server.js";
+import { obligationFields } from "../settlement/clawbackSchema.js";
+import { balanceFields, operationFields, earningFields } from "./schema.js";
+export const obligationDoc = v.object({
+    ...obligationFields,
+    _id: v.id("affiliateObligations"),
+    _creationTime: v.number(),
+});
+export const getObligation = query({
+    args: { obligationId: v.id("affiliateObligations") },
+    returns: v.union(obligationDoc, v.null()),
+    handler: (ctx, args) => ctx.db.get("affiliateObligations", args.obligationId),
+});
+export const chargeObligations = query({
+    args: { sourceChargeId: v.string() },
+    returns: v.array(obligationDoc),
+    handler: async (ctx, args) => {
+        const rows = await ctx.db
+            .query("affiliateObligations")
+            .withIndex("by_charge", (q) => q.eq("sourceChargeId", args.sourceChargeId))
+            .take(1001);
+        if (rows.length > 1000)
+            throw new Error("Affiliate charge recovery limit exceeded.");
+        return rows;
+    },
+});
+export const getEarning = query({
+    args: { sourceChargeId: v.string(), affiliateAccountId: v.string() },
+    returns: v.union(v.object({
+        ...earningFields,
+        _id: v.id("affiliateEarnings"),
+        _creationTime: v.number(),
+    }), v.null()),
+    handler: (ctx, args) => ctx.db
+        .query("affiliateEarnings")
+        .withIndex("by_charge_affiliate", (q) => q
+        .eq("sourceChargeId", args.sourceChargeId)
+        .eq("affiliateAccountId", args.affiliateAccountId))
+        .unique(),
+});
+export const recoverySnapshot = query({
+    args: {
+        affiliateAccountId: v.string(),
+        currency: v.string(),
+        paginationOpts: paginationOptsValidator,
+    },
+    returns: v.object({
+        balance: v.union(v.object({
+            ...balanceFields,
+            _id: v.id("affiliateRecoveryBalances"),
+            _creationTime: v.number(),
+        }), v.null()),
+        obligations: paginationResultValidator(obligationDoc),
+    }),
+    handler: async (ctx, args) => ({
+        balance: await ctx.db
+            .query("affiliateRecoveryBalances")
+            .withIndex("by_affiliate_currency", (q) => q
+            .eq("affiliateAccountId", args.affiliateAccountId)
+            .eq("currency", args.currency))
+            .unique(),
+        obligations: await 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),
+        }),
+    }),
+});
+export const operationHistory = query({
+    args: {
+        obligationId: v.id("affiliateObligations"),
+        paginationOpts: paginationOptsValidator,
+    },
+    returns: paginationResultValidator(v.object({
+        ...operationFields,
+        _id: v.id("affiliateRecoveryOperations"),
+        _creationTime: v.number(),
+    })),
+    handler: (ctx, args) => paginator(ctx.db, schema)
+        .query("affiliateRecoveryOperations")
+        .withIndex("by_obligation", (q) => q.eq("obligationId", args.obligationId))
+        .paginate({
+        ...args.paginationOpts,
+        numItems: Math.min(100, args.paginationOpts.numItems),
+    }),
+});
+export const pendingOperations = query({
+    args: {
+        paginationOpts: paginationOptsValidator,
+        state: v.union(v.literal("pending"), v.literal("unknown")),
+    },
+    returns: paginationResultValidator(v.object({
+        ...operationFields,
+        _id: v.id("affiliateRecoveryOperations"),
+        _creationTime: v.number(),
+    })),
+    handler: (ctx, args) => paginator(ctx.db, schema)
+        .query("affiliateRecoveryOperations")
+        .withIndex("by_state", (q) => q.eq("state", args.state))
+        .paginate({
+        ...args.paginationOpts,
+        numItems: Math.min(50, args.paginationOpts.numItems),
+    }),
+});
+//# sourceMappingURL=queries.js.map

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

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

package/dist/component/affiliateRecovery/schema.d.ts

@@ -0,0 +1,171 @@
+export declare const recoveryState: import("convex/values").VUnion<"canceled" | "failed" | "insufficient_balance" | "pending" | "succeeded" | "unknown" | "unsupported", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"insufficient_balance", "required">, import("convex/values").VLiteral<"unsupported", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"succeeded", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
+export declare const operationFields: {
+    obligationId: import("convex/values").VId<import("convex/values").GenericId<"affiliateObligations">, "required">;
+    sourceEventId: import("convex/values").VString<string | undefined, "optional">;
+    kind: import("convex/values").VUnion<"recovery" | "restoration", [import("convex/values").VLiteral<"recovery", "required">, import("convex/values").VLiteral<"restoration", "required">], "required", never>;
+    amount: import("convex/values").VFloat64<number, "required">;
+    state: import("convex/values").VUnion<"canceled" | "failed" | "insufficient_balance" | "pending" | "succeeded" | "unknown" | "unsupported", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"insufficient_balance", "required">, import("convex/values").VLiteral<"unsupported", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"succeeded", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
+    receiptId: import("convex/values").VString<string | undefined, "optional">;
+    error: import("convex/values").VString<string | undefined, "optional">;
+    attempted: import("convex/values").VBoolean<boolean, "required">;
+    providerBaseline: import("convex/values").VFloat64<number | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+};
+export declare const operationsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    amount: number;
+    attempted: boolean;
+    createdAt: number;
+    error?: string | undefined;
+    kind: "recovery" | "restoration";
+    obligationId: import("convex/values").GenericId<"affiliateObligations">;
+    providerBaseline?: number | undefined;
+    receiptId?: string | undefined;
+    sourceEventId?: string | undefined;
+    state: "canceled" | "failed" | "insufficient_balance" | "pending" | "succeeded" | "unknown" | "unsupported";
+}, {
+    obligationId: import("convex/values").VId<import("convex/values").GenericId<"affiliateObligations">, "required">;
+    sourceEventId: import("convex/values").VString<string | undefined, "optional">;
+    kind: import("convex/values").VUnion<"recovery" | "restoration", [import("convex/values").VLiteral<"recovery", "required">, import("convex/values").VLiteral<"restoration", "required">], "required", never>;
+    amount: import("convex/values").VFloat64<number, "required">;
+    state: import("convex/values").VUnion<"canceled" | "failed" | "insufficient_balance" | "pending" | "succeeded" | "unknown" | "unsupported", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"insufficient_balance", "required">, import("convex/values").VLiteral<"unsupported", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"succeeded", "required">, import("convex/values").VLiteral<"canceled", "required">], "required", never>;
+    receiptId: import("convex/values").VString<string | undefined, "optional">;
+    error: import("convex/values").VString<string | undefined, "optional">;
+    attempted: import("convex/values").VBoolean<boolean, "required">;
+    providerBaseline: import("convex/values").VFloat64<number | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "amount" | "attempted" | "createdAt" | "error" | "kind" | "obligationId" | "providerBaseline" | "receiptId" | "sourceEventId" | "state">, {
+    by_obligation: ["obligationId", "_creationTime"];
+    by_state: ["state", "_creationTime"];
+}, {}, {}>;
+export declare const earningFields: {
+    sourceChargeId: import("convex/values").VString<string, "required">;
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    originalCommission: import("convex/values").VFloat64<number, "required">;
+    withheldAmount: import("convex/values").VFloat64<number, "required">;
+    releaseAmount: import("convex/values").VFloat64<number, "required">;
+    sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+    paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+    stripeTransferId: import("convex/values").VString<string | undefined, "optional">;
+    status: import("convex/values").VUnion<"paid" | "reserved", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"paid", "required">], "required", never>;
+};
+export declare const earningsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    affiliateAccountId: string;
+    currency: string;
+    originalCommission: number;
+    paymentIntentId?: string | undefined;
+    releaseAmount: number;
+    sourceChargeId: string;
+    sourceInvoiceId?: string | undefined;
+    status: "paid" | "reserved";
+    stripeTransferId?: string | undefined;
+    withheldAmount: number;
+}, {
+    sourceChargeId: import("convex/values").VString<string, "required">;
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    originalCommission: import("convex/values").VFloat64<number, "required">;
+    withheldAmount: import("convex/values").VFloat64<number, "required">;
+    releaseAmount: import("convex/values").VFloat64<number, "required">;
+    sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+    paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+    stripeTransferId: import("convex/values").VString<string | undefined, "optional">;
+    status: import("convex/values").VUnion<"paid" | "reserved", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"paid", "required">], "required", never>;
+}, "required", "affiliateAccountId" | "currency" | "originalCommission" | "paymentIntentId" | "releaseAmount" | "sourceChargeId" | "sourceInvoiceId" | "status" | "stripeTransferId" | "withheldAmount">, {
+    by_affiliate_currency: ["affiliateAccountId", "currency", "_creationTime"];
+    by_charge_affiliate: ["sourceChargeId", "affiliateAccountId", "_creationTime"];
+}, {}, {}>;
+export declare const offsetsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    amount: number;
+    earningId: import("convex/values").GenericId<"affiliateEarnings">;
+    obligationId: import("convex/values").GenericId<"affiliateObligations">;
+}, {
+    earningId: import("convex/values").VId<import("convex/values").GenericId<"affiliateEarnings">, "required">;
+    obligationId: import("convex/values").VId<import("convex/values").GenericId<"affiliateObligations">, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+}, "required", "amount" | "earningId" | "obligationId">, {
+    by_earning: ["earningId", "_creationTime"];
+    by_obligation: ["obligationId", "_creationTime"];
+}, {}, {}>;
+export declare const balanceFields: {
+    activePayoutKey: import("convex/values").VString<string | undefined, "optional">;
+    pendingPayoutAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    originalCommission: import("convex/values").VFloat64<number, "required">;
+    recoveredAmount: import("convex/values").VFloat64<number, "required">;
+    offsetAmount: import("convex/values").VFloat64<number, "required">;
+    restoredAmount: import("convex/values").VFloat64<number, "required">;
+    outstandingDebt: import("convex/values").VFloat64<number, "required">;
+    reservedRecovery: import("convex/values").VFloat64<number, "required">;
+    reservedRestoration: import("convex/values").VFloat64<number, "required">;
+    restorationDue: import("convex/values").VFloat64<number, "required">;
+    withheldAmount: import("convex/values").VFloat64<number, "required">;
+    netPayable: import("convex/values").VFloat64<number, "required">;
+};
+export declare const balancesTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    activePayoutKey?: string | undefined;
+    affiliateAccountId: string;
+    currency: string;
+    netPayable: number;
+    offsetAmount: number;
+    originalCommission: number;
+    outstandingDebt: number;
+    pendingPayoutAmount?: number | undefined;
+    recoveredAmount: number;
+    reservedRecovery: number;
+    reservedRestoration: number;
+    restorationDue: number;
+    restoredAmount: number;
+    withheldAmount: number;
+}, {
+    activePayoutKey: import("convex/values").VString<string | undefined, "optional">;
+    pendingPayoutAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    originalCommission: import("convex/values").VFloat64<number, "required">;
+    recoveredAmount: import("convex/values").VFloat64<number, "required">;
+    offsetAmount: import("convex/values").VFloat64<number, "required">;
+    restoredAmount: import("convex/values").VFloat64<number, "required">;
+    outstandingDebt: import("convex/values").VFloat64<number, "required">;
+    reservedRecovery: import("convex/values").VFloat64<number, "required">;
+    reservedRestoration: import("convex/values").VFloat64<number, "required">;
+    restorationDue: import("convex/values").VFloat64<number, "required">;
+    withheldAmount: import("convex/values").VFloat64<number, "required">;
+    netPayable: import("convex/values").VFloat64<number, "required">;
+}, "required", "activePayoutKey" | "affiliateAccountId" | "currency" | "netPayable" | "offsetAmount" | "originalCommission" | "outstandingDebt" | "pendingPayoutAmount" | "recoveredAmount" | "reservedRecovery" | "reservedRestoration" | "restorationDue" | "restoredAmount" | "withheldAmount">, {
+    by_affiliate_currency: ["affiliateAccountId", "currency", "_creationTime"];
+}, {}, {}>;
+export declare const payoutReleaseFields: {
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    minimumAmount: import("convex/values").VFloat64<number, "required">;
+    state: import("convex/values").VUnion<"failed" | "pending" | "submitted" | "unknown", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+    stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+};
+export declare const payoutReleasesTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    affiliateAccountId: string;
+    amount: number;
+    createdAt: number;
+    currency: string;
+    minimumAmount: number;
+    operationKey: string;
+    state: "failed" | "pending" | "submitted" | "unknown";
+    stripePayoutId?: string | undefined;
+}, {
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    minimumAmount: import("convex/values").VFloat64<number, "required">;
+    state: import("convex/values").VUnion<"failed" | "pending" | "submitted" | "unknown", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
+    stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+}, "required", "affiliateAccountId" | "amount" | "createdAt" | "currency" | "minimumAmount" | "operationKey" | "state" | "stripePayoutId">, {
+    by_key: ["operationKey", "_creationTime"];
+    by_state: ["state", "_creationTime"];
+}, {}, {}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/component/affiliateRecovery/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/affiliateRecovery/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,6jBAQzB,CAAC;AACF,eAAO,MAAM,eAAe;IAC1B,YAAY;IACZ,aAAa;IACb,IAAI;IACJ,MAAM;IACN,KAAK;IACL,SAAS;IACT,KAAK;IACL,SAAS;IACT,gBAAgB;IAChB,SAAS;CACV,CAAC;AACF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;UAEG,CAAC;AAChC,eAAO,MAAM,aAAa;IACxB,cAAc;IACd,kBAAkB;IAClB,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,aAAa;IACb,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,MAAM;CACP,CAAC;AACF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;UAE2C,CAAC;AACtE,eAAO,MAAM,YAAY;;;;;;;;;;;UAMkB,CAAC;AAC5C,eAAO,MAAM,aAAa;IACxB,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,kBAAkB;IAClB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,mBAAmB;IACnB,cAAc;IACd,cAAc;IACd,UAAU;CACX,CAAC;AACF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAGzB,CAAC;AACF,eAAO,MAAM,mBAAmB;IAC9B,kBAAkB;IAClB,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,aAAa;IACb,KAAK;IAML,cAAc;IACd,SAAS;CACV,CAAC;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;UAED,CAAC"}

package/dist/component/affiliateRecovery/schema.js

@@ -0,0 +1,71 @@
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+export const recoveryState = v.union(v.literal("pending"), v.literal("unknown"), v.literal("insufficient_balance"), v.literal("unsupported"), v.literal("failed"), v.literal("succeeded"), v.literal("canceled"));
+export const operationFields = {
+    obligationId: v.id("affiliateObligations"),
+    sourceEventId: v.optional(v.string()),
+    kind: v.union(v.literal("recovery"), v.literal("restoration")),
+    amount: v.number(),
+    state: recoveryState,
+    receiptId: v.optional(v.string()),
+    error: v.optional(v.string()),
+    attempted: v.boolean(),
+    providerBaseline: v.optional(v.number()),
+    createdAt: v.number(),
+};
+export const operationsTable = defineTable(operationFields)
+    .index("by_obligation", ["obligationId"])
+    .index("by_state", ["state"]);
+export const earningFields = {
+    sourceChargeId: v.string(),
+    affiliateAccountId: v.string(),
+    currency: v.string(),
+    originalCommission: v.number(),
+    withheldAmount: v.number(),
+    releaseAmount: v.number(),
+    sourceInvoiceId: v.optional(v.string()),
+    paymentIntentId: v.optional(v.string()),
+    stripeTransferId: v.optional(v.string()),
+    status: v.union(v.literal("reserved"), v.literal("paid")),
+};
+export const earningsTable = defineTable(earningFields)
+    .index("by_charge_affiliate", ["sourceChargeId", "affiliateAccountId"])
+    .index("by_affiliate_currency", ["affiliateAccountId", "currency"]);
+export const offsetsTable = defineTable({
+    earningId: v.id("affiliateEarnings"),
+    obligationId: v.id("affiliateObligations"),
+    amount: v.number(),
+})
+    .index("by_earning", ["earningId"])
+    .index("by_obligation", ["obligationId"]);
+export const balanceFields = {
+    activePayoutKey: v.optional(v.string()),
+    pendingPayoutAmount: v.optional(v.number()),
+    affiliateAccountId: v.string(),
+    currency: v.string(),
+    originalCommission: v.number(),
+    recoveredAmount: v.number(),
+    offsetAmount: v.number(),
+    restoredAmount: v.number(),
+    outstandingDebt: v.number(),
+    reservedRecovery: v.number(),
+    reservedRestoration: v.number(),
+    restorationDue: v.number(),
+    withheldAmount: v.number(),
+    netPayable: v.number(),
+};
+export const balancesTable = defineTable(balanceFields).index("by_affiliate_currency", ["affiliateAccountId", "currency"]);
+export const payoutReleaseFields = {
+    affiliateAccountId: v.string(),
+    currency: v.string(),
+    operationKey: v.string(),
+    amount: v.number(),
+    minimumAmount: v.number(),
+    state: v.union(v.literal("pending"), v.literal("unknown"), v.literal("submitted"), v.literal("failed")),
+    stripePayoutId: v.optional(v.string()),
+    createdAt: v.number(),
+};
+export const payoutReleasesTable = defineTable(payoutReleaseFields)
+    .index("by_key", ["operationKey"])
+    .index("by_state", ["state"]);
+//# sourceMappingURL=schema.js.map

package/dist/component/affiliateRecovery/schema.js.map

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

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

@@ -99,29 +99,18 @@ export declare const upsertTransfer: import("convex/server").RegisteredMutation<
  * is the new cumulative total (matches Stripe's `Transfer.amount_reversed`).
  */
 export declare const recordTransferReversal: import("convex/server").RegisteredMutation<"public", {
-    reversedAmount: number;
     stripeTransferId: string;
+    reversedAmount: number;
+    receipt?: {
+        stripeReversalId: string;
+        operationId: string;
+        amount: number;
+    };
 }, Promise<null>>;
-/**
- * Atomically claim reversal slices for one operation (a dispute or refund
- * clawback) BEFORE any money moves (BTS-63). Runs in a single transaction, so
- * concurrent operations serialize here instead of racing between the ledger
- * read and the Stripe call:
- *
- *  - First claim for an `operationId`: computes slices against each leg's
- *    claim frontier (`max(reversedAmount, reversalClaimedAmount)`), advances
- *    the frontier, and records the slices — atomically. A concurrent distinct
- *    operation claiming the same target gets an EMPTY claim, not a duplicate.
- *  - Any later call with the same `operationId` (webhook redelivery, retry
- *    after a partial failure) replays the recorded slices verbatim, so the
- *    caller re-sends byte-identical Stripe params under the same idempotency
- *    keys no matter how the ledger moved in between.
- *
- * Each returned slice carries the leg's current CONFIRMED `reversedAmount` so
- * the executor can skip slices whose money already moved and was recorded.
- */
 export declare const claimReversalSlices: import("convex/server").RegisteredMutation<"public", {
-    mode: {
+    operationId: string;
+    sourceChargeId: string;
+    mode: import("convex/values").Infer<import("convex/values").VUnion<{
         kind: "full";
     } | {
         kind: "percent";
@@ -133,13 +122,37 @@ export declare const claimReversalSlices: import("convex/server").RegisteredMuta
         amountRefunded: number;
         chargeAmount: number;
         kind: "fraction";
-    };
-    operationId: string;
-    sourceChargeId: string;
+    }, [import("convex/values").VObject<{
+        kind: "full";
+    }, {
+        kind: import("convex/values").VLiteral<"full", "required">;
+    }, "required", "kind">, import("convex/values").VObject<{
+        kind: "percent";
+        percent: number;
+    }, {
+        kind: import("convex/values").VLiteral<"percent", "required">;
+        percent: import("convex/values").VFloat64<number, "required">;
+    }, "required", "kind" | "percent">, import("convex/values").VObject<{
+        amount: number;
+        kind: "amount";
+    }, {
+        kind: import("convex/values").VLiteral<"amount", "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+    }, "required", "amount" | "kind">, import("convex/values").VObject<{
+        amountRefunded: number;
+        chargeAmount: number;
+        kind: "fraction";
+    }, {
+        kind: import("convex/values").VLiteral<"fraction", "required">;
+        chargeAmount: import("convex/values").VFloat64<number, "required">;
+        amountRefunded: import("convex/values").VFloat64<number, "required">;
+    }, "required", "amountRefunded" | "chargeAmount" | "kind">], "required", "amount" | "amountRefunded" | "chargeAmount" | "kind" | "percent">>;
+    commissionExposure?: import("convex/values").Infer<typeof import("../settlement/clawbackSchema.js").commissionExposureValidator>;
 }, Promise<{
     replay: boolean;
     slices: {
         confirmed: number;
+        commissionTracked?: boolean | undefined;
         from: number;
         stripeTransferId: string;
         to: number;

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

@@ -1 +1 @@
-{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/connect/mutations.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;iBA6FxB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;iBAkCvB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;iBAiEvB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;;;;iBAwDjC,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;iBAsBxB,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;iBAmCzB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;iBAqCjC,CAAC;AAcH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;GA0F9B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;0BA+EM,MAAM;YAAM,MAAM;;GAWvD,CAAC"}
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/connect/mutations.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;iBA6FxB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;iBAOvB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;iBAiEvB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;;;;iBAwDjC,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;iBAsBxB,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;iBAoCzB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;iBAElC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA0C,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;0BA+EM,MAAM;YAAM,MAAM;;GAWvD,CAAC"}