@fantastic.dev/better-stripe 0.24.0 → 0.25.0

package/dist/component/schema.d.ts

@@ -1,4 +1,233 @@
 declare const _default: import("convex/server").SchemaDefinition<{
+    payoutWorkerJobs: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        cadenceMs: number;
+        completedGeneration?: number | undefined;
+        completedOperationKey?: string | undefined;
+        currency: string;
+        generation: number;
+        hasOperation: boolean;
+        lastAttemptAt?: number | undefined;
+        lastReason?: string | undefined;
+        leaseUntil?: number | undefined;
+        nextAttemptAt: number;
+        operationKey?: string | undefined;
+        ownerKey: string;
+        sequence: number;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        ownerKey: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        generation: import("convex/values").VFloat64<number, "required">;
+        sequence: import("convex/values").VFloat64<number, "required">;
+        cadenceMs: import("convex/values").VFloat64<number, "required">;
+        nextAttemptAt: import("convex/values").VFloat64<number, "required">;
+        leaseUntil: import("convex/values").VFloat64<number | undefined, "optional">;
+        operationKey: import("convex/values").VString<string | undefined, "optional">;
+        hasOperation: import("convex/values").VBoolean<boolean, "required">;
+        lastReason: import("convex/values").VString<string | undefined, "optional">;
+        lastAttemptAt: import("convex/values").VFloat64<number | undefined, "optional">;
+        completedGeneration: import("convex/values").VFloat64<number | undefined, "optional">;
+        completedOperationKey: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "accountId" | "cadenceMs" | "completedGeneration" | "completedOperationKey" | "currency" | "generation" | "hasOperation" | "lastAttemptAt" | "lastReason" | "leaseUntil" | "nextAttemptAt" | "operationKey" | "ownerKey" | "sequence">, {
+        by_account_currency: ["accountId", "currency", "_creationTime"];
+        by_operation_pending: ["hasOperation", "nextAttemptAt", "_creationTime"];
+    }, {}, {}>;
+    payoutFinancialRevisions: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        revision: number;
+        riskRevision: number;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        revision: import("convex/values").VFloat64<number, "required">;
+        riskRevision: import("convex/values").VFloat64<number, "required">;
+    }, "required", "accountId" | "revision" | "riskRevision">, {
+        by_account: ["accountId", "_creationTime"];
+    }, {}, {}>;
+    payoutRiskEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        key: string;
+        kind: "allocation" | "claim" | "fee" | "provider_payout" | "transfer";
+        removed?: boolean | undefined;
+        riskRevision: number;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        riskRevision: import("convex/values").VFloat64<number, "required">;
+        kind: import("convex/values").VUnion<"allocation" | "claim" | "fee" | "provider_payout" | "transfer", [import("convex/values").VLiteral<"transfer", "required">, import("convex/values").VLiteral<"provider_payout", "required">, import("convex/values").VLiteral<"allocation", "required">, import("convex/values").VLiteral<"claim", "required">, import("convex/values").VLiteral<"fee", "required">], "required", never>;
+        key: import("convex/values").VString<string, "required">;
+        removed: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    }, "required", "accountId" | "key" | "kind" | "removed" | "riskRevision">, {
+        by_account_revision: ["accountId", "riskRevision", "_creationTime"];
+    }, {}, {}>;
+    payoutRiskRevisions: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        riskRevision: number;
+    }, {
+        accountId: import("convex/values").VString<string, "required">;
+        riskRevision: import("convex/values").VFloat64<number, "required">;
+    }, "required", "accountId" | "riskRevision">, {
+        by_account: ["accountId", "_creationTime"];
+    }, {}, {}>;
+    payoutSnapshots: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        accountId: string;
+        allocationCount: number;
+        allocationCursor?: string | undefined;
+        claimCount: number;
+        claimCursor?: string | undefined;
+        deferredPositiveChanges: boolean;
+        expectedRevision: number;
+        expiresAt: number;
+        feeCount: number;
+        feeCursor?: string | undefined;
+        initialRevision: number;
+        initialRiskRevision: number;
+        observedRevision: number;
+        operationKey: string;
+        ownerKey: string;
+        phase: "allocations" | "check" | "claims" | "discarding" | "fees" | "invalidated" | "local_ready" | "repair" | "sources";
+        policyMode?: string | undefined;
+        policyOperationKey?: string | undefined;
+        providerChanged: boolean;
+        readOnly: boolean;
+        reason?: string | undefined;
+        riskRevision: number;
+        sourceCount: number;
+        sourceCursor?: string | undefined;
+        sourceFence: number;
+        step: number;
+    }, {
+        readOnly: import("convex/values").VBoolean<boolean, "required">;
+        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">;
+        policyMode: import("convex/values").VString<string | undefined, "optional">;
+        policyOperationKey: import("convex/values").VString<string | undefined, "optional">;
+        phase: import("convex/values").VUnion<"allocations" | "check" | "claims" | "discarding" | "fees" | "invalidated" | "local_ready" | "repair" | "sources", [import("convex/values").VLiteral<"sources", "required">, import("convex/values").VLiteral<"allocations", "required">, import("convex/values").VLiteral<"fees", "required">, import("convex/values").VLiteral<"claims", "required">, import("convex/values").VLiteral<"repair", "required">, import("convex/values").VLiteral<"check", "required">, import("convex/values").VLiteral<"local_ready", "required">, import("convex/values").VLiteral<"invalidated", "required">, import("convex/values").VLiteral<"discarding", "required">], "required", never>;
+        step: import("convex/values").VFloat64<number, "required">;
+        sourceFence: import("convex/values").VFloat64<number, "required">;
+        sourceCursor: import("convex/values").VString<string | undefined, "optional">;
+        allocationCursor: import("convex/values").VString<string | undefined, "optional">;
+        feeCursor: import("convex/values").VString<string | undefined, "optional">;
+        claimCursor: import("convex/values").VString<string | undefined, "optional">;
+        initialRevision: import("convex/values").VFloat64<number, "required">;
+        initialRiskRevision: import("convex/values").VFloat64<number, "required">;
+        riskRevision: import("convex/values").VFloat64<number, "required">;
+        observedRevision: import("convex/values").VFloat64<number, "required">;
+        sourceCount: import("convex/values").VFloat64<number, "required">;
+        allocationCount: import("convex/values").VFloat64<number, "required">;
+        claimCount: import("convex/values").VFloat64<number, "required">;
+        feeCount: import("convex/values").VFloat64<number, "required">;
+        deferredPositiveChanges: import("convex/values").VBoolean<boolean, "required">;
+        providerChanged: import("convex/values").VBoolean<boolean, "required">;
+        expiresAt: import("convex/values").VFloat64<number, "required">;
+        reason: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "accountId" | "allocationCount" | "allocationCursor" | "claimCount" | "claimCursor" | "deferredPositiveChanges" | "expectedRevision" | "expiresAt" | "feeCount" | "feeCursor" | "initialRevision" | "initialRiskRevision" | "observedRevision" | "operationKey" | "ownerKey" | "phase" | "policyMode" | "policyOperationKey" | "providerChanged" | "readOnly" | "reason" | "riskRevision" | "sourceCount" | "sourceCursor" | "sourceFence" | "step">, {
+        by_account_phase: ["accountId", "phase", "_creationTime"];
+        by_operation: ["operationKey", "_creationTime"];
+        by_read_only: ["readOnly", "_creationTime"];
+    }, {}, {}>;
+    payoutSnapshotSources: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        allocationCurrency?: string | undefined;
+        allocationPresent: boolean;
+        amount: number;
+        currency: string;
+        expectedPaid: number;
+        expectedReserved: number;
+        ledgerFingerprint: string;
+        needsCheck: boolean;
+        paidAmount: number;
+        reinstatement: boolean;
+        reservedAmount: number;
+        reversalClaimedAmount: number;
+        reversedAmount: number;
+        role?: string | undefined;
+        snapshotId: import("convex/values").GenericId<"payoutSnapshots">;
+        sourceChargeId?: string | undefined;
+        sourceCreatedAt: number;
+        status: string;
+        stripeTransferId: string;
+    }, {
+        snapshotId: import("convex/values").VId<import("convex/values").GenericId<"payoutSnapshots">, "required">;
+        stripeTransferId: import("convex/values").VString<string, "required">;
+        ledgerFingerprint: import("convex/values").VString<string, "required">;
+        sourceCreatedAt: import("convex/values").VFloat64<number, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        status: import("convex/values").VString<string, "required">;
+        role: import("convex/values").VString<string | undefined, "optional">;
+        sourceChargeId: import("convex/values").VString<string | undefined, "optional">;
+        reversedAmount: import("convex/values").VFloat64<number, "required">;
+        reversalClaimedAmount: import("convex/values").VFloat64<number, "required">;
+        reinstatement: import("convex/values").VBoolean<boolean, "required">;
+        allocationPresent: import("convex/values").VBoolean<boolean, "required">;
+        allocationCurrency: import("convex/values").VString<string | undefined, "optional">;
+        paidAmount: import("convex/values").VFloat64<number, "required">;
+        reservedAmount: import("convex/values").VFloat64<number, "required">;
+        expectedPaid: import("convex/values").VFloat64<number, "required">;
+        expectedReserved: import("convex/values").VFloat64<number, "required">;
+        needsCheck: import("convex/values").VBoolean<boolean, "required">;
+    }, "required", "allocationCurrency" | "allocationPresent" | "amount" | "currency" | "expectedPaid" | "expectedReserved" | "ledgerFingerprint" | "needsCheck" | "paidAmount" | "reinstatement" | "reservedAmount" | "reversalClaimedAmount" | "reversedAmount" | "role" | "snapshotId" | "sourceChargeId" | "sourceCreatedAt" | "status" | "stripeTransferId">, {
+        by_snapshot: ["snapshotId", "_creationTime"];
+        by_snapshot_check: ["snapshotId", "needsCheck", "_creationTime"];
+        by_snapshot_transfer: ["snapshotId", "stripeTransferId", "_creationTime"];
+    }, {}, {}>;
+    payoutSnapshotClaims: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        allocations: {
+            amount: number;
+            role?: string | undefined;
+            stripeTransferId: string;
+        }[];
+        amount: number;
+        currency: string;
+        fingerprint: string;
+        historical?: boolean | undefined;
+        operationKey: string;
+        providerFee?: number | undefined;
+        snapshotId: import("convex/values").GenericId<"payoutSnapshots">;
+        status: string;
+        stripePayoutId?: string | undefined;
+    }, {
+        snapshotId: import("convex/values").VId<import("convex/values").GenericId<"payoutSnapshots">, "required">;
+        operationKey: import("convex/values").VString<string, "required">;
+        fingerprint: import("convex/values").VString<string, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        status: import("convex/values").VString<string, "required">;
+        stripePayoutId: import("convex/values").VString<string | undefined, "optional">;
+        historical: import("convex/values").VBoolean<boolean | undefined, "optional">;
+        providerFee: import("convex/values").VFloat64<number | undefined, "optional">;
+        allocations: import("convex/values").VArray<{
+            amount: number;
+            role?: string | undefined;
+            stripeTransferId: string;
+        }[], import("convex/values").VObject<{
+            amount: number;
+            role?: string | undefined;
+            stripeTransferId: string;
+        }, {
+            stripeTransferId: import("convex/values").VString<string, "required">;
+            amount: import("convex/values").VFloat64<number, "required">;
+            role: import("convex/values").VString<string | undefined, "optional">;
+        }, "required", "amount" | "role" | "stripeTransferId">, "required">;
+    }, "required", "allocations" | "amount" | "currency" | "fingerprint" | "historical" | "operationKey" | "providerFee" | "snapshotId" | "status" | "stripePayoutId">, {
+        by_snapshot: ["snapshotId", "_creationTime"];
+        by_snapshot_operation: ["snapshotId", "operationKey", "_creationTime"];
+    }, {}, {}>;
+    payoutSnapshotFees: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        amount: number;
+        currency: string;
+        revision: number;
+        snapshotId: import("convex/values").GenericId<"payoutSnapshots">;
+    }, {
+        snapshotId: import("convex/values").VId<import("convex/values").GenericId<"payoutSnapshots">, "required">;
+        currency: import("convex/values").VString<string, "required">;
+        amount: import("convex/values").VFloat64<number, "required">;
+        revision: import("convex/values").VFloat64<number, "required">;
+    }, "required", "amount" | "currency" | "revision" | "snapshotId">, {
+        by_snapshot: ["snapshotId", "_creationTime"];
+        by_snapshot_currency: ["snapshotId", "currency", "_creationTime"];
+    }, {}, {}>;
     affiliateObligations: import("convex/server").TableDefinition<import("convex/values").VObject<{
         accounted?: boolean | undefined;
         activeOperationId?: import("convex/values").GenericId<"affiliateRecoveryOperations"> | undefined;
@@ -355,6 +584,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         by_provider_payout: ["stripePayoutId", "_creationTime"];
         by_rejection_request: ["rejection.requestId", "_creationTime"];
         by_return_receipt: ["returnTransactionId", "_creationTime"];
+        by_status: ["status", "_creationTime"];
     }, {}, {}>;
     payoutSourceAllocations: import("convex/server").TableDefinition<import("convex/values").VObject<{
         accountId: string;
@@ -423,6 +653,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
     }, "required", "accountId" | "country" | "holdDeadline" | "mode" | "operationKey" | "ownerKey" | "previousSchedule" | "previousSchedule.interval" | "previousSchedule.monthlyDays" | "previousSchedule.weeklyDays" | "revision" | "status" | "thresholds">, {
         by_account: ["accountId", "_creationTime"];
         by_deadline: ["holdDeadline", "_creationTime"];
+        by_mode_status: ["mode", "status", "_creationTime"];
+        by_status: ["status", "_creationTime"];
     }, {}, {}>;
     payoutPolicyOperations: import("convex/server").TableDefinition<import("convex/values").VObject<{
         accountId: string;

package/dist/component/schema.js

@@ -1,3 +1,5 @@
+import { jobsTable as payoutWorkerJobsTable } from "./payoutWorker/schema.js";
+import { financialRevisionsTable, riskEventsTable, riskRevisionsTable, snapshotsTable, snapshotSourcesTable, snapshotClaimsTable, snapshotFeesTable, } from "./payoutSnapshots/schema.js";
 import { claimsTable as payoutSyncClaimsTable } from "./payoutSync/schema.js";
 import { payoutReleasesTable as affiliatePayoutReleases, operationsTable as affiliateOperations, earningsTable as affiliateEarnings, offsetsTable as affiliateOffsets, balancesTable as affiliateBalances, } from "./affiliateRecovery/schema.js";
 import { affiliateObligationsTable, affiliateReversalReceiptsTable, } from "./settlement/clawbackSchema.js";
@@ -13,6 +15,14 @@ import { accountsTable } from "./core/schema";
 import { pricesTable, productsTable } from "./products/schema";
 import { webhookEventsTable } from "./webhooks/schema";
 export default defineSchema({
+    payoutWorkerJobs: payoutWorkerJobsTable,
+    payoutFinancialRevisions: financialRevisionsTable,
+    payoutRiskEvents: riskEventsTable,
+    payoutRiskRevisions: riskRevisionsTable,
+    payoutSnapshots: snapshotsTable,
+    payoutSnapshotSources: snapshotSourcesTable,
+    payoutSnapshotClaims: snapshotClaimsTable,
+    payoutSnapshotFees: snapshotFeesTable,
     affiliateObligations: affiliateObligationsTable,
     affiliateRecoveryOperations: affiliateOperations,
     affiliatePayoutReleases,

package/dist/component/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EACL,mBAAmB,IAAI,uBAAuB,EAC9C,eAAe,IAAI,mBAAmB,EACtC,aAAa,IAAI,iBAAiB,EAClC,YAAY,IAAI,gBAAgB,EAChC,aAAa,IAAI,iBAAiB,GACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,gBAAgB,IAAI,sBAAsB,EAC1C,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,oBAAoB,EAAE,yBAAyB;IAC/C,2BAA2B,EAAE,mBAAmB;IAChD,uBAAuB;IACvB,iBAAiB;IACjB,gBAAgB;IAChB,yBAAyB,EAAE,iBAAiB;IAC5C,yBAAyB,EAAE,8BAA8B;IACzD,gBAAgB,EAAE,qBAAqB;IACvC,iBAAiB,EAAE,sBAAsB;IACzC,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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"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"}

package/docs/read-contracts.md

@@ -174,6 +174,54 @@ Host apps should translate known codes into safe recovery instructions and a
 settings link. Do not log or blindly render raw provider messages. Authorize
 reads using the recipient's shared connected account.
 
+## Prepared Checkout requests
+
+Use `betterStripe.checkoutRequests.prepare(ctx, options)` when a host purchase
+intent must bind the exact provider request before creation or a plan change's
+cancellation. Preparation performs only reads. It never provisions an account,
+creates a Checkout Session or cancels a subscription. If a buyer needs a V2
+customer account, register the host intent first, provision through the existing
+package account operation with a stable account identity, then prepare using the
+verified account reference.
+
+Preparation returns a serializable versioned snapshot containing the final
+`request`, component correlation `row`, captured rendering `options`, descriptor
+and generated routing metadata. Persist the entire snapshot in the host's owned
+intent before any subsequent provider write. The snapshot includes account or
+customer email, server metadata, quantity, trial behavior, nested overrides and
+resolved fees. Its contents may contain private data; do not return the snapshot
+to a browser or log it.
+
+Call `betterStripe.checkoutRequests.execute(ctx, { prepared, idempotencyKey })`
+with that persisted snapshot and a stable intent-derived key. Execution validates
+its correlation and deterministic rendering against the captured context, then
+sends the stored request unchanged. It does not resolve current fee or descriptor
+defaults. Necessary platform-price checks may still read the provider. If a key
+was explicitly included during preparation, execution must use the same key.
+Retries reuse the exact request and preserve the existing Checkout response shape
+and component upsert. Missing or conflicting keys and inconsistent snapshots
+fail before creation.
+
+The host must authorize the buyer and catalog, bind the complete snapshot and key
+immutably, validate fresh session eligibility and own recovery. Consistency
+validation is not a signature or a replacement for host authorization. Never
+accept a browser-supplied snapshot. An unknown provider outcome remains unknown;
+use authoritative provider reads and saved references rather than blindly
+recreating after an idempotency retention window. This API does not record paid
+facts, award attribution, grant access or cancel a current plan automatically.
+
+For a plan change, authorize and register the intent, prepare and bind a request
+with no new trial, then perform any authorized cancellation before executing the
+persisted request. Preserve cancellation and creation recovery separately. A
+failed or lost response does not establish successful cancellation or payment.
+
+The original `createCheckoutSession` uses the same maintained renderer and
+submission path and retains its existing behavior. The prepared contract adds
+strict correlation checks for the buyer, account and price and preserves
+server-owned metadata and package-generated routing markers. Application React
+callbacks remain authenticated host adapters. The package's unstyled React
+checkout workflow and Vite example can use these callbacks with application styles.
+
 ## Publication and consumer acceptance
 
 A source merge does not activate an API in a published package. DOJO-908,

package/docs/settlement.md

@@ -533,4 +533,131 @@ shorten the pending operation's deadline. `migration_required.adoptionReason`
 explains unknown history or an expired holding period. This flow does not enable
 Dashboard accounts with withdrawal bypasses, Global Payouts, unsupported source
 rails, unknown numeric provider floors or accounts beyond the current atomic
-snapshot bounds. It installs no host cron or UI.
+snapshot bounds. Activation itself does not install a host cron or UI.
+
+## Automatic recipient worker
+
+`stripe.payoutPolicy.worker` runs authorized custom policies from a host cron.
+It invokes the maintained release and reconciliation APIs, including their live
+schedule, source-maturity, history, fee and balance checks. A worker lease never
+replaces the financial payout claim.
+
+```ts
+const result = await stripe.payoutPolicy.worker.run(ctx, {
+  accountId,
+  ownerKey,
+  currency,
+  // Resolve all off-provider debts and reserves for this owner/currency first.
+  // Do not count Stripe receipt debits twice.
+  independentLiabilities,
+  cadenceMs: 300_000,
+});
+const job = await stripe.payoutPolicy.worker.get(ctx, {
+  accountId,
+  ownerKey,
+  currency,
+});
+// job.nextAttemptAt is the next application attempt, not a bank arrival date.
+```
+
+The default retry cadence is five minutes; hosts can configure one minute to
+one day. Concurrent callers share a ten-minute lease. A crashed worker resumes
+the same operation ID. Unknown provider outcomes retain their attempted claim
+and reconcile on later runs, including after a recipient opts out. They never
+trigger a blind payout recreation. Expired worker leases permit observation
+retries; they do not release monetary reservations. A generation check prevents
+an older worker from replacing a newer worker's result. Completion replays keep
+the original next attempt time.
+
+Affiliate clawback debt, pending recoveries/restorations and competing affiliate
+payout reservations hold fresh worker attempts with `affiliate_recovery_pending`.
+The recipient claim boundary checks the same recovery lock again atomically
+before reservation and immediately before the provider attempt. Existing unknown
+attempts continue to reconcile even when new recovery debt arrives. Do not add
+the same affiliate debt to `independentLiabilities` again; that option is for
+separate host liabilities.
+
+The host must page all four queues, using bounded pages and scheduling each
+recipient/currency independently:
+
+- `worker.policies(ctx, paginationOpts)` discovers ready custom policies.
+- `worker.recovering(ctx, paginationOpts)` discovers retained operations,
+  including recipients who switched back to Stripe-managed payouts.
+- `worker.changing(ctx, paginationOpts)` discovers pending schedule operations
+  to retry through `payoutPolicy.apply`.
+- `payoutPolicy.due(ctx, paginationOpts)` discovers expired holding deadlines
+  to restore through `payoutPolicy.expire`.
+
+Authorize the host's owner/account mapping before each action. Read outstanding
+liabilities again before every attempt. In the example, uncollected seller cost
+reservations remain withheld even while attached to an unpaid invoice. Confirmed
+collections are already reflected in the store's transferred amount. Additional
+host liability scopes must be included when adopting this worker in another app.
+
+The example's `convex/crons.ts` installs a five-minute dispatcher. Its internal
+actions in `convex/payoutWorkers.ts` page these queues and use the package APIs;
+they do not call the Stripe SDK directly. Stripe-managed recipients continue to
+use Stripe's automatic schedule. Custom activation still requires explicit
+consent and verified exclusive payout control. The worker preserves the current
+release/adoption history limits and reports held results when those limits are
+exceeded. It does not yet consume the resumable local manifest described below.
+
+These are server worker APIs, not manual withdrawal actions for a customer UI.
+`worker.get` exposes the latest reason, attempt time and next application attempt
+for an authorized host to display. Bank availability, pending funds and bank
+arrival dates come from the recipient payout snapshot API.
+
+## Resumable local collections
+
+An authorized host worker can collect the local recipient ledger in bounded
+steps, retaining its cursor and step number across restarts:
+
+```ts
+let state = await stripe.payoutPolicy.collectSnapshot(ctx, {
+  accountId,
+  ownerKey,
+  operationKey: collectionKey,
+  expectedRevision: policy?.revision ?? -1,
+});
+state = await stripe.payoutPolicy.collectSnapshot(ctx, {
+  accountId,
+  ownerKey,
+  operationKey: collectionKey,
+  expectedRevision: policy?.revision ?? -1,
+  expectedStep: state.step,
+  batchSize: 25,
+});
+```
+
+Repeat bounded calls until `phase` reaches `local_ready` or `invalidated`.
+Duplicate step submissions preserve cursor progress. Sources, source allocations,
+payout fees and payout claims are copied across pages, with no 100-row limit on the local
+collection. New positive funding can be deferred to a later collection; refunds,
+reservations, payouts and fees enter an ordered account risk journal. The worker
+repairs changed entries and checks claim/source allocation rollups before local
+completion. Missing journal events, orphaned sources and changed policy identity
+stop collection with an explicit reason.
+
+`local_ready` describes a read-only local manifest. Complete provider receipts,
+provider history and monetary claim binding are still required before a payout.
+These local APIs do not remove the current bounded release/adoption limits by
+themselves. Provider-history continuation and scalable claim execution remain
+under implementation.
+
+After a read-only collection is no longer needed, repeatedly call
+`discardSnapshot(ctx, { accountId, ownerKey, operationKey: collectionKey })` until
+it returns `null`. Cleanup removes only collection caches. Read-only collection
+leases last 24 hours. Financially bound collections reject read-only cleanup and
+expiry; payout claims and their source reservations keep their own lifecycle.
+
+### Development reset safeguards
+
+`clearAllTables` is a development/test utility. It rejects active or changing
+payout schedules, unresolved reserved/submitted claims, financially bound
+collections and known pending/in-transit provider payouts. The host must quiesce
+provider writers and verify live provider state before invoking reset. Restore
+schedules through the policy APIs and reconcile unresolved operations first.
+Pending or unknown direct affiliate payouts and recovery operations also block
+reset, preserving the receipts and obligations needed for reconciliation.
+The guard preserves the restoration and payout records until that work is done.
+Read-only cache collections can be cleared with the other development data.

package/package.json

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