@fantastic.dev/better-stripe 0.23.2 → 0.25.0

package/dist/client/affiliateRecovery/review.js

@@ -0,0 +1,86 @@
+import { successfulRefundPrincipal } from "../connect/refundPrincipal.js";
+/** Operator-selected provenance is verified against exact provider receipts. */
+export async function verifiedLegacyReview(stripe, row, opts) {
+    if (!opts.note.trim() ||
+        opts.reversalIds.length > 100 ||
+        new Set(opts.reversalIds).size !== opts.reversalIds.length ||
+        (opts.restorationTransferIds?.length ?? 0) > 100)
+        throw new Error("Provide a review note and at most 100 unique receipts.");
+    if (!row.stripeTransferId)
+        throw new Error("Legacy review requires an original Connect transfer.");
+    const original = await stripe.transfers.retrieve(row.stripeTransferId);
+    const destination = typeof original.destination === "string"
+        ? original.destination
+        : original.destination?.id;
+    if (destination !== row.affiliateAccountId ||
+        original.currency !== row.currency ||
+        original.source_transaction !== row.sourceChargeId)
+        throw new Error("Legacy transfer identity mismatch.");
+    const receipts = [];
+    for (const id of opts.reversalIds) {
+        const receipt = await stripe.transfers.retrieveReversal(row.stripeTransferId, id);
+        if (receipt.transfer !== row.stripeTransferId ||
+            receipt.currency !== row.currency ||
+            receipt.id !== id)
+            throw new Error("Legacy reversal receipt identity mismatch.");
+        receipts.push({ id, amount: receipt.amount });
+    }
+    const recoveredAmount = receipts.reduce((sum, r) => sum + r.amount, 0);
+    if (recoveredAmount > original.amount_reversed)
+        throw new Error("Legacy receipts exceed confirmed provider reversals.");
+    let restoredAmount = 0;
+    const restorationIds = opts.restorationTransferIds ?? [];
+    if (new Set(restorationIds).size !== restorationIds.length)
+        throw new Error("Restoration receipts must be unique.");
+    for (const id of restorationIds) {
+        const transfer = await stripe.transfers.retrieve(id);
+        const recipient = typeof transfer.destination === "string"
+            ? transfer.destination
+            : transfer.destination?.id;
+        if (recipient !== row.affiliateAccountId ||
+            transfer.currency !== row.currency ||
+            transfer.metadata.bsReinstateOf !== row.sourceChargeId)
+            throw new Error("Legacy restoration receipt identity mismatch.");
+        restoredAmount += transfer.amount;
+    }
+    const charge = await stripe.charges.retrieve(row.sourceChargeId);
+    const refundedPrincipal = await successfulRefundPrincipal(stripe, row.sourceChargeId);
+    const disputes = [];
+    for await (const dispute of stripe.disputes.list({
+        charge: row.sourceChargeId,
+        limit: 100,
+    })) {
+        if (disputes.length >= 10)
+            throw new Error("Legacy dispute history requires manual source allocation.");
+        if (!dispute.status.startsWith("warning_") &&
+            dispute.status !== "prevented")
+            disputes.push(dispute);
+    }
+    if (disputes.length > 1)
+        throw new Error("Multiple monetary disputes require manual source allocation.");
+    const dispute = disputes[0];
+    return {
+        obligationId: row._id,
+        recoveredAmount,
+        restoredAmount,
+        receipts,
+        restorationIds,
+        note: opts.note,
+        exposure: {
+            kind: dispute ? "dispute" : "refund",
+            chargeAmount: charge.amount,
+            principal: dispute?.amount ?? refundedPrincipal,
+            finalized: dispute ? dispute.status === "lost" : true,
+            refundedPrincipal,
+            disputeId: dispute?.id,
+            disputeState: dispute
+                ? dispute.status === "won"
+                    ? "won"
+                    : dispute.status === "lost"
+                        ? "lost"
+                        : "open"
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=review.js.map

package/dist/client/affiliateRecovery/review.js.map

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

package/dist/client/affiliateRecovery/validators.d.ts

@@ -0,0 +1,402 @@
+export declare const affiliateObligationValidator: import("convex/values").VObject<{
+    _creationTime: number;
+    _id: string;
+    accounted?: boolean | undefined;
+    activeOperationId?: string | 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?: string | 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;
+}, {
+    stripeTransferId: import("convex/values").VString<string | undefined, "optional">;
+    sourceChargeId: import("convex/values").VString<string, "required">;
+    sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+    paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+    paymentId: import("convex/values").VString<string | undefined, "optional">;
+    storeAccountId: import("convex/values").VString<string | undefined, "optional">;
+    lastRefundId: import("convex/values").VString<string | undefined, "optional">;
+    affiliateAccountId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    chargeAmount: import("convex/values").VFloat64<number, "required">;
+    originalCommission: import("convex/values").VFloat64<number, "required">;
+    refundedPrincipal: import("convex/values").VFloat64<number, "required">;
+    disputedPrincipal: import("convex/values").VFloat64<number, "required">;
+    lostPrincipal: import("convex/values").VFloat64<number, "required">;
+    finalizedAmount: import("convex/values").VFloat64<number, "required">;
+    provisionalAmount: import("convex/values").VFloat64<number, "required">;
+    recoveredAmount: import("convex/values").VFloat64<number, "required">;
+    needsReconciliation: import("convex/values").VBoolean<boolean, "required">;
+    accounted: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    legacyReceiptIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    legacyRestorationIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    operatorNote: import("convex/values").VString<string | undefined, "optional">;
+    releasedCommission: import("convex/values").VFloat64<number | undefined, "optional">;
+    offsetAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    restoredAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    reservedRecovery: import("convex/values").VFloat64<number | undefined, "optional">;
+    reservedRestoration: import("convex/values").VFloat64<number | undefined, "optional">;
+    debtAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    creditAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    debtStatus: import("convex/values").VUnion<"open" | "settled" | undefined, [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"settled", "required">], "optional", never>;
+    disputeState: import("convex/values").VUnion<"lost" | "open" | "won" | undefined, [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"lost", "required">, import("convex/values").VLiteral<"won", "required">], "optional", never>;
+    disputeId: import("convex/values").VString<string | undefined, "optional">;
+    lastState: import("convex/values").VString<string | undefined, "optional">;
+    lastError: import("convex/values").VString<string | undefined, "optional">;
+    operationSequence: import("convex/values").VFloat64<number | undefined, "optional">;
+    _id: import("convex/values").VString<string, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    earningId: import("convex/values").VString<string | undefined, "optional">;
+    activeOperationId: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "_creationTime" | "_id" | "accounted" | "activeOperationId" | "affiliateAccountId" | "chargeAmount" | "creditAmount" | "currency" | "debtAmount" | "debtStatus" | "disputeId" | "disputeState" | "disputedPrincipal" | "earningId" | "finalizedAmount" | "lastError" | "lastRefundId" | "lastState" | "legacyReceiptIds" | "legacyRestorationIds" | "lostPrincipal" | "needsReconciliation" | "offsetAmount" | "operationSequence" | "operatorNote" | "originalCommission" | "paymentId" | "paymentIntentId" | "provisionalAmount" | "recoveredAmount" | "refundedPrincipal" | "releasedCommission" | "reservedRecovery" | "reservedRestoration" | "restoredAmount" | "sourceChargeId" | "sourceInvoiceId" | "storeAccountId" | "stripeTransferId">;
+export declare const affiliateOperationValidator: import("convex/values").VObject<{
+    _creationTime: number;
+    _id: string;
+    amount: number;
+    attempted: boolean;
+    createdAt: number;
+    error?: string | undefined;
+    kind: "recovery" | "restoration";
+    obligationId: string;
+    providerBaseline?: number | undefined;
+    receiptId?: string | undefined;
+    sourceEventId?: string | undefined;
+    state: "canceled" | "failed" | "insufficient_balance" | "pending" | "succeeded" | "unknown" | "unsupported";
+}, {
+    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">;
+    _id: import("convex/values").VString<string, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+    obligationId: import("convex/values").VString<string, "required">;
+}, "required", "_creationTime" | "_id" | "amount" | "attempted" | "createdAt" | "error" | "kind" | "obligationId" | "providerBaseline" | "receiptId" | "sourceEventId" | "state">;
+export declare const affiliateSnapshotValidator: import("convex/values").VObject<{
+    balance: {
+        _creationTime: number;
+        _id: string;
+        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;
+    } | null;
+    obligations: {
+        continueCursor: string;
+        isDone: boolean;
+        page: {
+            _creationTime: number;
+            _id: string;
+            accounted?: boolean | undefined;
+            activeOperationId?: string | 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?: string | 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;
+        }[];
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null | undefined;
+        splitCursor?: string | null | undefined;
+    };
+}, {
+    balance: import("convex/values").VUnion<{
+        _creationTime: number;
+        _id: string;
+        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;
+    } | null, [import("convex/values").VObject<{
+        _creationTime: number;
+        _id: string;
+        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">;
+        _id: import("convex/values").VString<string, "required">;
+        _creationTime: import("convex/values").VFloat64<number, "required">;
+    }, "required", "_creationTime" | "_id" | "activePayoutKey" | "affiliateAccountId" | "currency" | "netPayable" | "offsetAmount" | "originalCommission" | "outstandingDebt" | "pendingPayoutAmount" | "recoveredAmount" | "reservedRecovery" | "reservedRestoration" | "restorationDue" | "restoredAmount" | "withheldAmount">, import("convex/values").VNull<null, "required">], "required", "_creationTime" | "_id" | "activePayoutKey" | "affiliateAccountId" | "currency" | "netPayable" | "offsetAmount" | "originalCommission" | "outstandingDebt" | "pendingPayoutAmount" | "recoveredAmount" | "reservedRecovery" | "reservedRestoration" | "restorationDue" | "restoredAmount" | "withheldAmount">;
+    obligations: import("convex/values").VObject<{
+        continueCursor: string;
+        isDone: boolean;
+        page: {
+            _creationTime: number;
+            _id: string;
+            accounted?: boolean | undefined;
+            activeOperationId?: string | 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?: string | 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;
+        }[];
+        pageStatus?: "SplitRecommended" | "SplitRequired" | null | undefined;
+        splitCursor?: string | null | undefined;
+    }, {
+        page: import("convex/values").VArray<{
+            _creationTime: number;
+            _id: string;
+            accounted?: boolean | undefined;
+            activeOperationId?: string | 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?: string | 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;
+        }[], import("convex/values").VObject<{
+            _creationTime: number;
+            _id: string;
+            accounted?: boolean | undefined;
+            activeOperationId?: string | 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?: string | 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;
+        }, {
+            stripeTransferId: import("convex/values").VString<string | undefined, "optional">;
+            sourceChargeId: import("convex/values").VString<string, "required">;
+            sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+            paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+            paymentId: import("convex/values").VString<string | undefined, "optional">;
+            storeAccountId: import("convex/values").VString<string | undefined, "optional">;
+            lastRefundId: import("convex/values").VString<string | undefined, "optional">;
+            affiliateAccountId: import("convex/values").VString<string, "required">;
+            currency: import("convex/values").VString<string, "required">;
+            chargeAmount: import("convex/values").VFloat64<number, "required">;
+            originalCommission: import("convex/values").VFloat64<number, "required">;
+            refundedPrincipal: import("convex/values").VFloat64<number, "required">;
+            disputedPrincipal: import("convex/values").VFloat64<number, "required">;
+            lostPrincipal: import("convex/values").VFloat64<number, "required">;
+            finalizedAmount: import("convex/values").VFloat64<number, "required">;
+            provisionalAmount: import("convex/values").VFloat64<number, "required">;
+            recoveredAmount: import("convex/values").VFloat64<number, "required">;
+            needsReconciliation: import("convex/values").VBoolean<boolean, "required">;
+            accounted: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            legacyReceiptIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            legacyRestorationIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+            operatorNote: import("convex/values").VString<string | undefined, "optional">;
+            releasedCommission: import("convex/values").VFloat64<number | undefined, "optional">;
+            offsetAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+            restoredAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+            reservedRecovery: import("convex/values").VFloat64<number | undefined, "optional">;
+            reservedRestoration: import("convex/values").VFloat64<number | undefined, "optional">;
+            debtAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+            creditAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+            debtStatus: import("convex/values").VUnion<"open" | "settled" | undefined, [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"settled", "required">], "optional", never>;
+            disputeState: import("convex/values").VUnion<"lost" | "open" | "won" | undefined, [import("convex/values").VLiteral<"open", "required">, import("convex/values").VLiteral<"lost", "required">, import("convex/values").VLiteral<"won", "required">], "optional", never>;
+            disputeId: import("convex/values").VString<string | undefined, "optional">;
+            lastState: import("convex/values").VString<string | undefined, "optional">;
+            lastError: import("convex/values").VString<string | undefined, "optional">;
+            operationSequence: import("convex/values").VFloat64<number | undefined, "optional">;
+            _id: import("convex/values").VString<string, "required">;
+            _creationTime: import("convex/values").VFloat64<number, "required">;
+            earningId: import("convex/values").VString<string | undefined, "optional">;
+            activeOperationId: import("convex/values").VString<string | undefined, "optional">;
+        }, "required", "_creationTime" | "_id" | "accounted" | "activeOperationId" | "affiliateAccountId" | "chargeAmount" | "creditAmount" | "currency" | "debtAmount" | "debtStatus" | "disputeId" | "disputeState" | "disputedPrincipal" | "earningId" | "finalizedAmount" | "lastError" | "lastRefundId" | "lastState" | "legacyReceiptIds" | "legacyRestorationIds" | "lostPrincipal" | "needsReconciliation" | "offsetAmount" | "operationSequence" | "operatorNote" | "originalCommission" | "paymentId" | "paymentIntentId" | "provisionalAmount" | "recoveredAmount" | "refundedPrincipal" | "releasedCommission" | "reservedRecovery" | "reservedRestoration" | "restoredAmount" | "sourceChargeId" | "sourceInvoiceId" | "storeAccountId" | "stripeTransferId">, "required">;
+        continueCursor: import("convex/values").VString<string, "required">;
+        isDone: import("convex/values").VBoolean<boolean, "required">;
+        splitCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+        pageStatus: import("convex/values").VUnion<"SplitRecommended" | "SplitRequired" | null | undefined, [import("convex/values").VLiteral<"SplitRecommended", "required">, import("convex/values").VLiteral<"SplitRequired", "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+    }, "required", "continueCursor" | "isDone" | "page" | "pageStatus" | "splitCursor">;
+}, "required", "balance" | "balance._creationTime" | "balance._id" | "balance.activePayoutKey" | "balance.affiliateAccountId" | "balance.currency" | "balance.netPayable" | "balance.offsetAmount" | "balance.originalCommission" | "balance.outstandingDebt" | "balance.pendingPayoutAmount" | "balance.recoveredAmount" | "balance.reservedRecovery" | "balance.reservedRestoration" | "balance.restorationDue" | "balance.restoredAmount" | "balance.withheldAmount" | "obligations" | "obligations.continueCursor" | "obligations.isDone" | "obligations.page" | "obligations.pageStatus" | "obligations.splitCursor">;
+//# sourceMappingURL=validators.d.ts.map

package/dist/client/affiliateRecovery/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/client/affiliateRecovery/validators.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kuBAMvC,CAAC;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;iLAKtC,CAAC;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0lBAkBrC,CAAC"}

package/dist/client/affiliateRecovery/validators.js

@@ -0,0 +1,27 @@
+import { v } from "convex/values";
+import { obligationFields } from "../../component/settlement/clawbackSchema.js";
+import { balanceFields, operationFields, } from "../../component/affiliateRecovery/schema.js";
+export const affiliateObligationValidator = v.object({
+    ...obligationFields,
+    _id: v.string(),
+    _creationTime: v.number(),
+    earningId: v.optional(v.string()),
+    activeOperationId: v.optional(v.string()),
+});
+export const affiliateOperationValidator = v.object({
+    ...operationFields,
+    _id: v.string(),
+    _creationTime: v.number(),
+    obligationId: v.string(),
+});
+export const affiliateSnapshotValidator = v.object({
+    balance: v.union(v.object({ ...balanceFields, _id: v.string(), _creationTime: v.number() }), v.null()),
+    obligations: v.object({
+        page: v.array(affiliateObligationValidator),
+        continueCursor: v.string(),
+        isDone: v.boolean(),
+        splitCursor: v.optional(v.union(v.string(), v.null())),
+        pageStatus: v.optional(v.union(v.literal("SplitRecommended"), v.literal("SplitRequired"), v.null())),
+    }),
+});
+//# sourceMappingURL=validators.js.map

package/dist/client/affiliateRecovery/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../../src/client/affiliateRecovery/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,EACL,aAAa,EACb,eAAe,GAChB,MAAM,6CAA6C,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,GAAG,gBAAgB;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC1C,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,GAAG,eAAe;IAClB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAC1E,CAAC,CAAC,IAAI,EAAE,CACT;IACD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC;QAC3C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,UAAU,EAAE,CAAC,CAAC,QAAQ,CACpB,CAAC,CAAC,KAAK,CACL,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAC7B,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAC1B,CAAC,CAAC,IAAI,EAAE,CACT,CACF;KACF,CAAC;CACH,CAAC,CAAC"}