@fantastic.dev/better-stripe 0.18.0 → 0.20.0

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

@@ -0,0 +1,289 @@
+export declare const observation: import("convex/values").VObject<{
+    currency: string;
+    ledgerFingerprint: string;
+    matureNet: number;
+    observedAt: number;
+    pendingCredits: number;
+    stripeTransferId: string;
+    transactionIds: string[];
+}, {
+    stripeTransferId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    matureNet: import("convex/values").VFloat64<number, "required">;
+    pendingCredits: import("convex/values").VFloat64<number, "required">;
+    ledgerFingerprint: import("convex/values").VString<string, "required">;
+    observedAt: import("convex/values").VFloat64<number, "required">;
+    transactionIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+}, "required", "currency" | "ledgerFingerprint" | "matureNet" | "observedAt" | "pendingCredits" | "stripeTransferId" | "transactionIds">;
+export declare const allocation: import("convex/values").VObject<{
+    amount: number;
+    role?: "affiliate" | "other" | "store" | undefined;
+    stripeTransferId: string;
+}, {
+    stripeTransferId: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    role: import("convex/values").VUnion<"affiliate" | "other" | "store" | undefined, [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "optional", never>;
+}, "required", "amount" | "role" | "stripeTransferId">;
+export declare const claimFields: {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+    expectedRevision: import("convex/values").VFloat64<number, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    allocations: import("convex/values").VArray<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }[], import("convex/values").VObject<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        role: import("convex/values").VUnion<"affiliate" | "other" | "store" | undefined, [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "optional", never>;
+    }, "required", "amount" | "role" | "stripeTransferId">, "required">;
+    observations: import("convex/values").VArray<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[], import("convex/values").VObject<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        matureNet: import("convex/values").VFloat64<number, "required">;
+        pendingCredits: import("convex/values").VFloat64<number, "required">;
+        ledgerFingerprint: import("convex/values").VString<string, "required">;
+        observedAt: import("convex/values").VFloat64<number, "required">;
+        transactionIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    }, "required", "currency" | "ledgerFingerprint" | "matureNet" | "observedAt" | "pendingCredits" | "stripeTransferId" | "transactionIds">, "required">;
+    status: import("convex/values").VUnion<"canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"paid", "required">, import("convex/values").VLiteral<"returned", "required">, import("convex/values").VLiteral<"canceled", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+    attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+    returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    rejection: import("convex/values").VObject<{
+        code: "amount_too_small" | "balance_insufficient";
+        requestId: string;
+    } | undefined, {
+        requestId: import("convex/values").VString<string, "required">;
+        code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
+    }, "optional", "code" | "requestId">;
+};
+export declare const claimDoc: import("convex/values").VObject<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"payoutReleaseClaims">;
+    accountId: string;
+    allocations: {
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }[];
+    amount: number;
+    attemptedAt?: number | undefined;
+    currency: string;
+    expectedRevision: number;
+    observations: {
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[];
+    operationKey: string;
+    ownerKey: string;
+    rejection?: {
+        code: "amount_too_small" | "balance_insufficient";
+        requestId: string;
+    } | undefined;
+    returnTransactionId?: string | undefined;
+    status: "canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted";
+    stripePayoutId?: string | undefined;
+}, {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+    expectedRevision: import("convex/values").VFloat64<number, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    allocations: import("convex/values").VArray<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }[], import("convex/values").VObject<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        role: import("convex/values").VUnion<"affiliate" | "other" | "store" | undefined, [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "optional", never>;
+    }, "required", "amount" | "role" | "stripeTransferId">, "required">;
+    observations: import("convex/values").VArray<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[], import("convex/values").VObject<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        matureNet: import("convex/values").VFloat64<number, "required">;
+        pendingCredits: import("convex/values").VFloat64<number, "required">;
+        ledgerFingerprint: import("convex/values").VString<string, "required">;
+        observedAt: import("convex/values").VFloat64<number, "required">;
+        transactionIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    }, "required", "currency" | "ledgerFingerprint" | "matureNet" | "observedAt" | "pendingCredits" | "stripeTransferId" | "transactionIds">, "required">;
+    status: import("convex/values").VUnion<"canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"paid", "required">, import("convex/values").VLiteral<"returned", "required">, import("convex/values").VLiteral<"canceled", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+    attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+    returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    rejection: import("convex/values").VObject<{
+        code: "amount_too_small" | "balance_insufficient";
+        requestId: string;
+    } | undefined, {
+        requestId: import("convex/values").VString<string, "required">;
+        code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
+    }, "optional", "code" | "requestId">;
+    _id: import("convex/values").VId<import("convex/values").GenericId<"payoutReleaseClaims">, "required">;
+    _creationTime: import("convex/values").VFloat64<number, "required">;
+}, "required", "_creationTime" | "_id" | "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">;
+export declare const claimsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    accountId: string;
+    allocations: {
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }[];
+    amount: number;
+    attemptedAt?: number | undefined;
+    currency: string;
+    expectedRevision: number;
+    observations: {
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[];
+    operationKey: string;
+    ownerKey: string;
+    rejection?: {
+        code: "amount_too_small" | "balance_insufficient";
+        requestId: string;
+    } | undefined;
+    returnTransactionId?: string | undefined;
+    status: "canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted";
+    stripePayoutId?: string | undefined;
+}, {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+    expectedRevision: import("convex/values").VFloat64<number, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    amount: import("convex/values").VFloat64<number, "required">;
+    allocations: import("convex/values").VArray<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }[], import("convex/values").VObject<{
+        amount: number;
+        role?: "affiliate" | "other" | "store" | undefined;
+        stripeTransferId: string;
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        role: import("convex/values").VUnion<"affiliate" | "other" | "store" | undefined, [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "optional", never>;
+    }, "required", "amount" | "role" | "stripeTransferId">, "required">;
+    observations: import("convex/values").VArray<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[], import("convex/values").VObject<{
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }, {
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        matureNet: import("convex/values").VFloat64<number, "required">;
+        pendingCredits: import("convex/values").VFloat64<number, "required">;
+        ledgerFingerprint: import("convex/values").VString<string, "required">;
+        observedAt: import("convex/values").VFloat64<number, "required">;
+        transactionIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+    }, "required", "currency" | "ledgerFingerprint" | "matureNet" | "observedAt" | "pendingCredits" | "stripeTransferId" | "transactionIds">, "required">;
+    status: import("convex/values").VUnion<"canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"paid", "required">, import("convex/values").VLiteral<"returned", "required">, import("convex/values").VLiteral<"canceled", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+    attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+    stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+    returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+    rejection: import("convex/values").VObject<{
+        code: "amount_too_small" | "balance_insufficient";
+        requestId: string;
+    } | undefined, {
+        requestId: import("convex/values").VString<string, "required">;
+        code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
+    }, "optional", "code" | "requestId">;
+}, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
+    by_account_status: ["accountId", "status", "_creationTime"];
+    by_operation: ["operationKey", "_creationTime"];
+    by_provider_payout: ["stripePayoutId", "_creationTime"];
+    by_rejection_request: ["rejection.requestId", "_creationTime"];
+    by_return_receipt: ["returnTransactionId", "_creationTime"];
+}, {}, {}>;
+export declare const sourcesTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    accountId: string;
+    currency: string;
+    ownerKey: string;
+    paidAmount: number;
+    reservedAmount: number;
+    stripeTransferId: string;
+}, {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    stripeTransferId: import("convex/values").VString<string, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    paidAmount: import("convex/values").VFloat64<number, "required">;
+    reservedAmount: import("convex/values").VFloat64<number, "required">;
+}, "required", "accountId" | "currency" | "ownerKey" | "paidAmount" | "reservedAmount" | "stripeTransferId">, {
+    by_account: ["accountId", "_creationTime"];
+    by_transfer: ["stripeTransferId", "_creationTime"];
+}, {}, {}>;
+export declare const identity: {
+    accountId: import("convex/values").VString<string, "required">;
+    ownerKey: import("convex/values").VString<string, "required">;
+    operationKey: import("convex/values").VString<string, "required">;
+};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;wIAQtB,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;sDAMrB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BvB,CAAC;AACF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gSAInB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAKiC,CAAC;AAC1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;UAQY,CAAC;AACtC,eAAO,MAAM,QAAQ;;;;CAA+C,CAAC"}

package/dist/component/payoutRelease/schema.js

@@ -0,0 +1,56 @@
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+import { scopeFields } from "../payoutPolicy/schema.js";
+export const observation = v.object({
+    stripeTransferId: v.string(),
+    currency: v.string(),
+    matureNet: v.number(),
+    pendingCredits: v.number(),
+    ledgerFingerprint: v.string(),
+    observedAt: v.number(),
+    transactionIds: v.array(v.string()),
+});
+export const allocation = v.object({
+    stripeTransferId: v.string(),
+    amount: v.number(),
+    role: v.optional(v.union(v.literal("store"), v.literal("affiliate"), v.literal("other"))),
+});
+export const claimFields = {
+    ...scopeFields,
+    operationKey: v.string(),
+    expectedRevision: v.number(),
+    currency: v.string(),
+    amount: v.number(),
+    allocations: v.array(allocation),
+    observations: v.array(observation),
+    status: v.union(v.literal("reserved"), v.literal("submitted"), v.literal("paid"), v.literal("returned"), v.literal("canceled"), v.literal("rejected")),
+    attemptedAt: v.optional(v.number()),
+    stripePayoutId: v.optional(v.string()),
+    returnTransactionId: v.optional(v.string()),
+    rejection: v.optional(v.object({
+        requestId: v.string(),
+        code: v.union(v.literal("balance_insufficient"), v.literal("amount_too_small")),
+    })),
+};
+export const claimDoc = v.object({
+    ...claimFields,
+    _id: v.id("payoutReleaseClaims"),
+    _creationTime: v.number(),
+});
+export const claimsTable = defineTable(claimFields)
+    .index("by_operation", ["operationKey"])
+    .index("by_account_status", ["accountId", "status"])
+    .index("by_provider_payout", ["stripePayoutId"])
+    .index("by_return_receipt", ["returnTransactionId"])
+    .index("by_rejection_request", ["rejection.requestId"]);
+export const sourcesTable = defineTable({
+    ...scopeFields,
+    stripeTransferId: v.string(),
+    currency: v.string(),
+    paidAmount: v.number(),
+    reservedAmount: v.number(),
+})
+    .index("by_transfer", ["stripeTransferId"])
+    .index("by_account", ["accountId"]);
+export const identity = { ...scopeFields, operationKey: v.string() };
+//# sourceMappingURL=schema.js.map

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

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

package/dist/component/schema.d.ts

@@ -1,4 +1,114 @@
 declare const _default: import("convex/server").SchemaDefinition<{
+    payoutReleaseClaims: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        allocations: {
+            amount: number;
+            role?: "affiliate" | "other" | "store" | undefined;
+            stripeTransferId: string;
+        }[];
+        amount: number;
+        attemptedAt?: number | undefined;
+        currency: string;
+        expectedRevision: number;
+        observations: {
+            currency: string;
+            ledgerFingerprint: string;
+            matureNet: number;
+            observedAt: number;
+            pendingCredits: number;
+            stripeTransferId: string;
+            transactionIds: string[];
+        }[];
+        operationKey: string;
+        ownerKey: string;
+        rejection?: {
+            code: "amount_too_small" | "balance_insufficient";
+            requestId: string;
+        } | undefined;
+        returnTransactionId?: string | undefined;
+        status: "canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted";
+        stripePayoutId?: string | undefined;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        ownerKey: import("convex/values").VString<string, "required">;
+        operationKey: import("convex/values").VString<string, "required">;
+        expectedRevision: import("convex/values").VFloat64<number, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        allocations: import("convex/values").VArray<{
+            amount: number;
+            role?: "affiliate" | "other" | "store" | undefined;
+            stripeTransferId: string;
+        }[], import("convex/values").VObject<{
+            amount: number;
+            role?: "affiliate" | "other" | "store" | undefined;
+            stripeTransferId: string;
+        }, {
+            stripeTransferId: import("convex/values").VString<string, "required">;
+            amount: import("convex/values").VFloat64<number, "required">;
+            role: import("convex/values").VUnion<"affiliate" | "other" | "store" | undefined, [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "optional", never>;
+        }, "required", "amount" | "role" | "stripeTransferId">, "required">;
+        observations: import("convex/values").VArray<{
+            currency: string;
+            ledgerFingerprint: string;
+            matureNet: number;
+            observedAt: number;
+            pendingCredits: number;
+            stripeTransferId: string;
+            transactionIds: string[];
+        }[], import("convex/values").VObject<{
+            currency: string;
+            ledgerFingerprint: string;
+            matureNet: number;
+            observedAt: number;
+            pendingCredits: number;
+            stripeTransferId: string;
+            transactionIds: string[];
+        }, {
+            stripeTransferId: import("convex/values").VString<string, "required">;
+            currency: import("convex/values").VString<string, "required">;
+            matureNet: import("convex/values").VFloat64<number, "required">;
+            pendingCredits: import("convex/values").VFloat64<number, "required">;
+            ledgerFingerprint: import("convex/values").VString<string, "required">;
+            observedAt: import("convex/values").VFloat64<number, "required">;
+            transactionIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        }, "required", "currency" | "ledgerFingerprint" | "matureNet" | "observedAt" | "pendingCredits" | "stripeTransferId" | "transactionIds">, "required">;
+        status: import("convex/values").VUnion<"canceled" | "paid" | "rejected" | "reserved" | "returned" | "submitted", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"submitted", "required">, import("convex/values").VLiteral<"paid", "required">, import("convex/values").VLiteral<"returned", "required">, import("convex/values").VLiteral<"canceled", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+        attemptedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+        returnTransactionId: import("convex/values").VString<string | undefined, "optional">;
+        rejection: import("convex/values").VObject<{
+            code: "amount_too_small" | "balance_insufficient";
+            requestId: string;
+        } | undefined, {
+            requestId: import("convex/values").VString<string, "required">;
+            code: import("convex/values").VUnion<"amount_too_small" | "balance_insufficient", [import("convex/values").VLiteral<"balance_insufficient", "required">, import("convex/values").VLiteral<"amount_too_small", "required">], "required", never>;
+        }, "optional", "code" | "requestId">;
+    }, "required", "accountId" | "allocations" | "amount" | "attemptedAt" | "currency" | "expectedRevision" | "observations" | "operationKey" | "ownerKey" | "rejection" | "rejection.code" | "rejection.requestId" | "returnTransactionId" | "status" | "stripePayoutId">, {
+        by_account_status: ["accountId", "status", "_creationTime"];
+        by_operation: ["operationKey", "_creationTime"];
+        by_provider_payout: ["stripePayoutId", "_creationTime"];
+        by_rejection_request: ["rejection.requestId", "_creationTime"];
+        by_return_receipt: ["returnTransactionId", "_creationTime"];
+    }, {}, {}>;
+    payoutSourceAllocations: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        currency: string;
+        ownerKey: string;
+        paidAmount: number;
+        reservedAmount: number;
+        stripeTransferId: string;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        ownerKey: import("convex/values").VString<string, "required">;
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        paidAmount: import("convex/values").VFloat64<number, "required">;
+        reservedAmount: import("convex/values").VFloat64<number, "required">;
+    }, "required", "accountId" | "currency" | "ownerKey" | "paidAmount" | "reservedAmount" | "stripeTransferId">, {
+        by_account: ["accountId", "_creationTime"];
+        by_transfer: ["stripeTransferId", "_creationTime"];
+    }, {}, {}>;
     payoutPolicies: import("convex/server").TableDefinition<import("convex/values").VObject<{
         accountId: string;
         country: string;

package/dist/component/schema.js

@@ -1,3 +1,4 @@
+import { claimsTable as payoutReleaseClaimsTable, sourcesTable as payoutSourceAllocationsTable, } from "./payoutRelease/schema.js";
 import { policiesTable, operationsTable } from "./payoutPolicy/schema.js";
 import { currencyTotalsTable } from "./earnings/schema.js";
 import { claimsTable, balancesTable, groupsTable, reservationsTable, } from "./costRecovery/schema";
@@ -9,6 +10,8 @@ import { accountsTable } from "./core/schema";
 import { pricesTable, productsTable } from "./products/schema";
 import { webhookEventsTable } from "./webhooks/schema";
 export default defineSchema({
+    payoutReleaseClaims: payoutReleaseClaimsTable,
+    payoutSourceAllocations: payoutSourceAllocationsTable,
     payoutPolicies: policiesTable,
     payoutPolicyOperations: operationsTable,
     currencyTotals: currencyTotalsTable,

package/dist/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAe,YAAY,CAAC;IAC1B,cAAc,EAAE,aAAa;IAC7B,sBAAsB,EAAE,eAAe;IACvC,cAAc,EAAE,mBAAmB;IACnC,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,WAAW;IAC3B,oBAAoB,EAAE,iBAAiB;IACvC,qBAAqB,EAAE,gBAAgB;IACvC,eAAe,EAAE,oBAAoB;IACrC,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO;IACP,QAAQ,EAAE,aAAa;IAEvB,WAAW;IACX,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;IAEnB,UAAU;IACV,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,qBAAqB;IACvC,QAAQ,EAAE,aAAa;IAEvB,UAAU;IACV,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,iBAAiB,EAAE,sBAAsB;IACzC,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,cAAc;IACzB,mBAAmB,EAAE,wBAAwB;IAE7C,WAAW;IACX,aAAa,EAAE,kBAAkB;CAClC,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,IAAI,wBAAwB,EACvC,YAAY,IAAI,4BAA4B,GAC7C,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAe,YAAY,CAAC;IAC1B,mBAAmB,EAAE,wBAAwB;IAC7C,uBAAuB,EAAE,4BAA4B;IACrD,cAAc,EAAE,aAAa;IAC7B,sBAAsB,EAAE,eAAe;IACvC,cAAc,EAAE,mBAAmB;IACnC,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,WAAW;IAC3B,oBAAoB,EAAE,iBAAiB;IACvC,qBAAqB,EAAE,gBAAgB;IACvC,eAAe,EAAE,oBAAoB;IACrC,mBAAmB,EAAE,wBAAwB;IAC7C,OAAO;IACP,QAAQ,EAAE,aAAa;IAEvB,WAAW;IACX,QAAQ,EAAE,aAAa;IACvB,MAAM,EAAE,WAAW;IAEnB,UAAU;IACV,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,qBAAqB;IACvC,QAAQ,EAAE,aAAa;IAEvB,UAAU;IACV,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,iBAAiB,EAAE,sBAAsB;IACzC,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,cAAc;IACzB,mBAAmB,EAAE,wBAAwB;IAE7C,WAAW;IACX,aAAa,EAAE,kBAAkB;CAClC,CAAC,CAAC"}

package/docs/settlement.md

@@ -218,3 +218,84 @@ numeric payout-floor field, and retained balance reserves are not payout trigger
 Sources: [payout schedules](https://docs.stripe.com/connect/manage-payout-schedule),
 [manual payout holding limits](https://docs.stripe.com/connect/manual-payouts), and
 [Dashboard control limits](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts#control-payout-timing).
+
+### Transactional claim ledger implementation status
+
+The component contains `payoutRelease` claim and source-allocation tables. These
+are server-side building blocks for the release boundary, with no public client
+executor or scheduled bank-payout integration yet. Do not call the claim
+mutation with UI totals or a transfer receipt alone. Its trusted upstream caller
+must establish complete provider history, still-unpaid ownership, adoption of
+prior payouts, independent liabilities, and live payout controls first.
+
+A claim combines mature creator and affiliate entitlement within one currency.
+It deducts persisted paid and reserved allocations, keeps negative entitlement
+after refunds, and caps the allocation by provider availability after independent
+liabilities. Sources and policy revision are checked transactionally. One
+unresolved account claim blocks competing reservations. An attempted claim
+cannot be canceled merely because the provider timed out. Accepted payouts keep
+their allocations reserved until payment is confirmed; a failed or canceled
+payout releases allocations only after its provider return transaction has been
+verified upstream. Return receipt identities cannot be reused across claims. A verified create
+rejection for insufficient balance or an amount below the provider floor can
+release an unaccepted claim within a conservative 23-hour window. It requires
+its own unique Stripe request receipt; ambiguous errors and older attempts stay
+held. This window stays below Stripe's [24-hour v1 idempotency retention minimum](https://docs.stripe.com/api/idempotent_requests).
+
+The current claim snapshot is deliberately bounded to 100 account transfer rows
+and 1,000 receipt IDs per source. Larger or incomplete histories reject the whole
+claim, without using partial totals. A resumable reconciliation/adoption process,
+provider payout creation and receipt verification, payout-fee accounting, and
+recurring release/expiry integration remain required before custom payout
+minimums can be presented as an operational feature. In-memory claim tests are
+not evidence of a completed Stripe bank payout.
+
+## Verified recipient funding receipts
+
+Use `stripe.payoutPolicy.transferReceipt(ctx, { accountId, stripeTransferId })`
+in an authorized action to read a transfer's actual recipient funding. The
+reader binds the component ledger to the provider transfer, destination payment,
+original balance transaction and each transfer reversal's recipient refund.
+It verifies account, amount, currency and source identities, and rechecks the
+transfer and ledger before publishing a result. It performs no financial writes.
+
+A `ready` result contains exact signed recipient settlement transactions and
+`totalNet`, `matureNet`, and `pendingCredits`. `sourceCurrency` describes the
+original transfer; `settlementCurrency` describes the actual recipient balance.
+For supported FX receipts, amounts come directly from Stripe's settlement
+transactions; the reader does not calculate exchange-rate conversions. Mixed
+settlement currencies or missing conversion evidence require explicit allocation.
+Transaction `created` and `availableOn` values are Unix seconds; the snapshot's
+`observedAt` is milliseconds.
+
+Positive credits qualify as mature only when their provider status is available
+and their availability date has passed. Pending debits first cancel the matching
+pending original credit; uncovered pending debits reduce mature credit. Other
+positive pending adjustments never qualify early. Signed mature debt is preserved.
+For example, in one settlement currency's minor units:
+
+| Original credit | Reversal/debit | Total net | Mature net | Pending credits |
+| --------------- | -------------- | --------: | ---------: | --------------: |
+| 1000 pending    | 250 pending    |       750 |          0 |             750 |
+| 1000 available  | 250 pending    |       750 |        750 |               0 |
+| 1000 pending    | 1000 pending   |         0 |          0 |               0 |
+| 1000 pending    | 250 available  |       750 |       -250 |            1000 |
+
+This is **received credit, not still-unpaid entitlement**. Previous bank payouts,
+source allocations, recovery liabilities and outstanding reservations must be
+reconciled before any release. Do not pay `matureNet` directly or infer ownership
+from unrelated account-wide available funds. Stripe's balance-transaction
+`payout` filter maps automatic payouts only; application-created manual payouts
+need a maintained allocation ledger.
+
+The default budget is 20 provider requests; `maxRequests` accepts 1–100. Exhausted
+or incomplete history returns `not_ready` without partial financial totals.
+Reserved reversal claims, changing provider/ledger snapshots and unavailable
+receipts also fail closed. Identity mismatches and invalid financial arithmetic
+throw. Larger histories need continued reconciliation rather than treating the
+missing amount as zero or silently truncating it. The original transfer ledger
+remains intact for retries.
+
+Sources: [transfer provenance](https://docs.stripe.com/api/transfers/object),
+[receipt maturity](https://docs.stripe.com/api/balance_transactions/object), and
+[history pagination and payout-filter limits](https://docs.stripe.com/api/balance_transactions/list).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fantastic.dev/better-stripe",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "A Convex component for Stripe V2 Accounts API integration.",
   "keywords": [
     "stripe",