@fantastic.dev/better-stripe 0.9.0 → 0.10.1

package/dist/component/settlement/mutations.js

@@ -0,0 +1,104 @@
+import { v } from "convex/values";
+import { mutation } from "../_generated/server.js";
+import { allocationFields, commissionFields, termValidator } from "./schema.js";
+const doc = v.object({
+    ...allocationFields,
+    _id: v.id("settlementAllocations"),
+    _creationTime: v.number(),
+});
+export const reserveSettlementAllocation = mutation({
+    args: allocationFields,
+    returns: doc,
+    handler: async (ctx, args) => {
+        const existing = await ctx.db
+            .query("settlementAllocations")
+            .withIndex("by_source_charge", (q) => q.eq("sourceChargeId", args.sourceChargeId))
+            .first();
+        if (existing) {
+            if (existing.currency !== args.currency ||
+                existing.paymentIntentId !== args.paymentIntentId ||
+                existing.sourceInvoiceId !== args.sourceInvoiceId)
+                throw new Error("Settlement source identity cannot change.");
+            return existing;
+        }
+        const adjustment = args.adjustmentAmount ?? 0;
+        const amounts = [
+            args.gross,
+            args.processingFee,
+            args.platformNet,
+            ...args.transfers.map((t) => t.amount),
+        ];
+        const keys = args.transfers.map((t) => `${t.destinationAccountId}:${t.role}`);
+        if (!Number.isSafeInteger(adjustment) ||
+            args.processingFee + args.platformNet + adjustment < 0 ||
+            amounts.some((n) => !Number.isSafeInteger(n) || n < 0) ||
+            args.gross <= 0 ||
+            !args.currency ||
+            !args.sourceChargeId ||
+            args.transfers.some((t) => !t.destinationAccountId) ||
+            new Set(keys).size !== keys.length ||
+            args.gross !==
+                args.processingFee +
+                    args.platformNet +
+                    adjustment +
+                    args.transfers.reduce((sum, t) => sum + t.amount, 0))
+            throw new Error("Settlement allocation must reconcile in integer currency units with unique recipient legs.");
+        const id = await ctx.db.insert("settlementAllocations", args);
+        return (await ctx.db.get("settlementAllocations", id));
+    },
+});
+export const claimCommissionInvoice = mutation({
+    args: { ...commissionFields, invoiceId: v.string() },
+    returns: v.object({
+        eligible: v.boolean(),
+        term: termValidator,
+        firstPaidInvoiceId: v.string(),
+        claimKey: v.string(),
+        replay: v.boolean(),
+    }),
+    handler: async (ctx, args) => {
+        let stored = await ctx.db
+            .query("commissionTerms")
+            .withIndex("by_subscription", (q) => q.eq("subscriptionId", args.subscriptionId))
+            .first();
+        if (stored && stored.affiliateAccountId !== args.affiliateAccountId)
+            throw new Error("Subscription affiliate identity cannot change.");
+        if (!stored) {
+            const fields = {
+                subscriptionId: args.subscriptionId,
+                term: args.term,
+                affiliateAccountId: args.affiliateAccountId,
+                firstPaidInvoiceId: args.firstPaidInvoiceId,
+            };
+            const id = await ctx.db.insert("commissionTerms", fields);
+            stored = (await ctx.db.get("commissionTerms", id));
+        }
+        const existing = await ctx.db
+            .query("commissionDecisions")
+            .withIndex("by_subscription_invoice", (q) => q
+            .eq("subscriptionId", args.subscriptionId)
+            .eq("invoiceId", args.invoiceId))
+            .first();
+        const claimKey = existing?.claimKey ??
+            `commission:${args.subscriptionId}:${args.invoiceId}`;
+        const eligible = existing?.eligible ??
+            (!!stored.affiliateAccountId &&
+                (stored.term === "forever" ||
+                    args.invoiceId === stored.firstPaidInvoiceId));
+        if (!existing)
+            await ctx.db.insert("commissionDecisions", {
+                subscriptionId: args.subscriptionId,
+                invoiceId: args.invoiceId,
+                eligible,
+                claimKey,
+            });
+        return {
+            eligible,
+            term: stored.term,
+            firstPaidInvoiceId: stored.firstPaidInvoiceId,
+            claimKey,
+            replay: !!existing,
+        };
+    },
+});
+//# sourceMappingURL=mutations.js.map

package/dist/component/settlement/mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/settlement/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChF,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,GAAG,gBAAgB;IACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;aAC1B,KAAK,CAAC,uBAAuB,CAAC;aAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;aACA,KAAK,EAAE,CAAC;QACX,IAAI,QAAQ,EAAE,CAAC;YACb,IACE,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;gBACnC,QAAQ,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe;gBACjD,QAAQ,CAAC,eAAe,KAAK,IAAI,CAAC,eAAe;gBAEjD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC/D,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG;YACd,IAAI,CAAC,KAAK;YACV,IAAI,CAAC,aAAa;YAClB,IAAI,CAAC,WAAW;YAChB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;SACvC,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,IAAI,EAAE,CAC7C,CAAC;QACF,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,UAAU,GAAG,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,KAAK,IAAI,CAAC;YACf,CAAC,IAAI,CAAC,QAAQ;YACd,CAAC,IAAI,CAAC,cAAc;YACpB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;YACnD,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM;YAClC,IAAI,CAAC,KAAK;gBACR,IAAI,CAAC,aAAa;oBAChB,IAAI,CAAC,WAAW;oBAChB,UAAU;oBACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAExD,MAAM,IAAI,KAAK,CACb,4FAA4F,CAC7F,CAAC;QACJ,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAE,CAAC;IAC1D,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC7C,IAAI,EAAE,EAAE,GAAG,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACpD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;QACrB,IAAI,EAAE,aAAa;QACnB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACtB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;aACA,KAAK,EAAE,CAAC;QACX,IAAI,MAAM,IAAI,MAAM,CAAC,kBAAkB,KAAK,IAAI,CAAC,kBAAkB;YACjE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG;gBACb,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;aAC5C,CAAC;YACF,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAE,CAAC;QACtD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;aAC1B,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,yBAAyB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC1C,CAAC;aACE,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC;aACzC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CACnC;aACA,KAAK,EAAE,CAAC;QACX,MAAM,QAAQ,GACZ,QAAQ,EAAE,QAAQ;YAClB,cAAc,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACxD,MAAM,QAAQ,GACZ,QAAQ,EAAE,QAAQ;YAClB,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB;gBAC1B,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;oBACxB,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ;YACX,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,qBAAqB,EAAE;gBACzC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;QACL,OAAO;YACL,QAAQ;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,QAAQ;YACR,MAAM,EAAE,CAAC,CAAC,QAAQ;SACnB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/component/settlement/queries.d.ts

@@ -0,0 +1,29 @@
+export declare const getSettlementAllocation: import("convex/server").RegisteredQuery<"public", {
+    sourceChargeId: string;
+}, Promise<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"settlementAllocations">;
+    adjustmentAmount?: number | undefined;
+    currency: string;
+    gross: number;
+    paymentId?: string | undefined;
+    paymentIntentId?: string | undefined;
+    platformNet: number;
+    processingFee: number;
+    sourceChargeId: string;
+    sourceInvoiceId?: string | undefined;
+    transfers: {
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }[];
+} | null>>;
+export declare const getCommissionTerm: import("convex/server").RegisteredQuery<"public", {
+    subscriptionId: string;
+}, Promise<{
+    subscriptionId: string;
+    term: "forever" | "one_time";
+    affiliateAccountId: string | undefined;
+    firstPaidInvoiceId: string;
+} | null>>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/component/settlement/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;UAUlC,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;UAkB5B,CAAC"}

package/dist/component/settlement/queries.js

@@ -0,0 +1,35 @@
+import { v } from "convex/values";
+import { query } from "../_generated/server.js";
+import { allocationFields, commissionFields } from "./schema.js";
+const doc = v.object({
+    ...allocationFields,
+    _id: v.id("settlementAllocations"),
+    _creationTime: v.number(),
+});
+export const getSettlementAllocation = query({
+    args: { sourceChargeId: v.string() },
+    returns: v.union(doc, v.null()),
+    handler: (ctx, args) => ctx.db
+        .query("settlementAllocations")
+        .withIndex("by_source_charge", (q) => q.eq("sourceChargeId", args.sourceChargeId))
+        .first(),
+});
+export const getCommissionTerm = query({
+    args: { subscriptionId: v.string() },
+    returns: v.union(v.object(commissionFields), v.null()),
+    handler: async (ctx, args) => {
+        const row = await ctx.db
+            .query("commissionTerms")
+            .withIndex("by_subscription", (q) => q.eq("subscriptionId", args.subscriptionId))
+            .first();
+        if (!row)
+            return null;
+        return {
+            subscriptionId: row.subscriptionId,
+            term: row.term,
+            affiliateAccountId: row.affiliateAccountId,
+            firstPaidInvoiceId: row.firstPaidInvoiceId,
+        };
+    },
+});
+//# sourceMappingURL=queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/settlement/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,GAAG,gBAAgB;IACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;IAC3C,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACrB,GAAG,CAAC,EAAE;SACH,KAAK,CAAC,uBAAuB,CAAC;SAC9B,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;SACA,KAAK,EAAE;CACb,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;IACrC,IAAI,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE;aACrB,KAAK,CAAC,iBAAiB,CAAC;aACxB,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,CAC5C;aACA,KAAK,EAAE,CAAC;QACX,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,99 @@
+export declare const termValidator: import("convex/values").VUnion<"forever" | "one_time", [import("convex/values").VLiteral<"forever", "required">, import("convex/values").VLiteral<"one_time", "required">], "required", never>;
+export declare const allocationFields: {
+    sourceChargeId: import("convex/values").VString<string, "required">;
+    paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+    sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+    gross: import("convex/values").VFloat64<number, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    processingFee: import("convex/values").VFloat64<number, "required">;
+    platformNet: import("convex/values").VFloat64<number, "required">;
+    adjustmentAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    paymentId: import("convex/values").VString<string | undefined, "optional">;
+    transfers: import("convex/values").VArray<{
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }[], import("convex/values").VObject<{
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }, {
+        destinationAccountId: import("convex/values").VString<string, "required">;
+        role: import("convex/values").VUnion<"affiliate" | "other" | "store", [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "required", never>;
+        amount: import("convex/values").VFloat64<number, "required">;
+    }, "required", "amount" | "destinationAccountId" | "role">, "required">;
+};
+export declare const allocationsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    adjustmentAmount?: number | undefined;
+    currency: string;
+    gross: number;
+    paymentId?: string | undefined;
+    paymentIntentId?: string | undefined;
+    platformNet: number;
+    processingFee: number;
+    sourceChargeId: string;
+    sourceInvoiceId?: string | undefined;
+    transfers: {
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }[];
+}, {
+    sourceChargeId: import("convex/values").VString<string, "required">;
+    paymentIntentId: import("convex/values").VString<string | undefined, "optional">;
+    sourceInvoiceId: import("convex/values").VString<string | undefined, "optional">;
+    gross: import("convex/values").VFloat64<number, "required">;
+    currency: import("convex/values").VString<string, "required">;
+    processingFee: import("convex/values").VFloat64<number, "required">;
+    platformNet: import("convex/values").VFloat64<number, "required">;
+    adjustmentAmount: import("convex/values").VFloat64<number | undefined, "optional">;
+    paymentId: import("convex/values").VString<string | undefined, "optional">;
+    transfers: import("convex/values").VArray<{
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }[], import("convex/values").VObject<{
+        amount: number;
+        destinationAccountId: string;
+        role: "affiliate" | "other" | "store";
+    }, {
+        destinationAccountId: import("convex/values").VString<string, "required">;
+        role: import("convex/values").VUnion<"affiliate" | "other" | "store", [import("convex/values").VLiteral<"store", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"other", "required">], "required", never>;
+        amount: import("convex/values").VFloat64<number, "required">;
+    }, "required", "amount" | "destinationAccountId" | "role">, "required">;
+}, "required", "adjustmentAmount" | "currency" | "gross" | "paymentId" | "paymentIntentId" | "platformNet" | "processingFee" | "sourceChargeId" | "sourceInvoiceId" | "transfers">, {
+    by_source_charge: ["sourceChargeId", "_creationTime"];
+}, {}, {}>;
+export declare const commissionFields: {
+    subscriptionId: import("convex/values").VString<string, "required">;
+    term: import("convex/values").VUnion<"forever" | "one_time", [import("convex/values").VLiteral<"forever", "required">, import("convex/values").VLiteral<"one_time", "required">], "required", never>;
+    affiliateAccountId: import("convex/values").VString<string | undefined, "optional">;
+    firstPaidInvoiceId: import("convex/values").VString<string, "required">;
+};
+export declare const commissionTermsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    affiliateAccountId?: string | undefined;
+    firstPaidInvoiceId: string;
+    subscriptionId: string;
+    term: "forever" | "one_time";
+}, {
+    subscriptionId: import("convex/values").VString<string, "required">;
+    term: import("convex/values").VUnion<"forever" | "one_time", [import("convex/values").VLiteral<"forever", "required">, import("convex/values").VLiteral<"one_time", "required">], "required", never>;
+    affiliateAccountId: import("convex/values").VString<string | undefined, "optional">;
+    firstPaidInvoiceId: import("convex/values").VString<string, "required">;
+}, "required", "affiliateAccountId" | "firstPaidInvoiceId" | "subscriptionId" | "term">, {
+    by_subscription: ["subscriptionId", "_creationTime"];
+}, {}, {}>;
+export declare const commissionDecisionsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
+    claimKey: string;
+    eligible: boolean;
+    invoiceId: string;
+    subscriptionId: string;
+}, {
+    subscriptionId: import("convex/values").VString<string, "required">;
+    invoiceId: import("convex/values").VString<string, "required">;
+    eligible: import("convex/values").VBoolean<boolean, "required">;
+    claimKey: import("convex/values").VString<string, "required">;
+}, "required", "claimKey" | "eligible" | "invoiceId" | "subscriptionId">, {
+    by_subscription_invoice: ["subscriptionId", "invoiceId", "_creationTime"];
+}, {}, {}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/settlement/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,gMAGzB,CAAC;AACF,eAAO,MAAM,gBAAgB;IAC3B,cAAc;IACd,eAAe;IACf,eAAe;IACf,KAAK;IACL,QAAQ;IACR,aAAa;IACb,WAAW;IACX,gBAAgB;IAChB,SAAS;IACT,SAAS;;;;;;;;;;;;;CAOV,CAAC;AACF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAG5B,CAAC;AACF,eAAO,MAAM,gBAAgB;IAC3B,cAAc;IACd,IAAI;IACJ,kBAAkB;IAClB,kBAAkB;CACnB,CAAC;AACF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;UAGhC,CAAC;AACF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;UAK+B,CAAC"}

package/dist/component/settlement/schema.js

@@ -0,0 +1,35 @@
+import { defineTable } from "convex/server";
+import { v } from "convex/values";
+import { splitRecipientRoleValidator } from "../lib/fees.js";
+export const termValidator = v.union(v.literal("forever"), v.literal("one_time"));
+export const allocationFields = {
+    sourceChargeId: v.string(),
+    paymentIntentId: v.optional(v.string()),
+    sourceInvoiceId: v.optional(v.string()),
+    gross: v.number(),
+    currency: v.string(),
+    processingFee: v.number(),
+    platformNet: v.number(),
+    adjustmentAmount: v.optional(v.number()),
+    paymentId: v.optional(v.string()),
+    transfers: v.array(v.object({
+        destinationAccountId: v.string(),
+        role: splitRecipientRoleValidator,
+        amount: v.number(),
+    })),
+};
+export const allocationsTable = defineTable(allocationFields).index("by_source_charge", ["sourceChargeId"]);
+export const commissionFields = {
+    subscriptionId: v.string(),
+    term: termValidator,
+    affiliateAccountId: v.optional(v.string()),
+    firstPaidInvoiceId: v.string(),
+};
+export const commissionTermsTable = defineTable(commissionFields).index("by_subscription", ["subscriptionId"]);
+export const commissionDecisionsTable = defineTable({
+    subscriptionId: v.string(),
+    invoiceId: v.string(),
+    eligible: v.boolean(),
+    claimKey: v.string(),
+}).index("by_subscription_invoice", ["subscriptionId", "invoiceId"]);
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/settlement/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAClC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EACpB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CACtB,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;QACP,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;QAChC,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CACH;CACF,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC,KAAK,CACjE,kBAAkB,EAClB,CAAC,gBAAgB,CAAC,CACnB,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,aAAa;IACnB,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC,KAAK,CACrE,iBAAiB,EACjB,CAAC,gBAAgB,CAAC,CACnB,CAAC;AACF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC;IAClD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC"}

package/dist/react/workflows/Checkout.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from "react";
+import { type ReactNode } from "react";
 import { type CheckoutFormOptions } from "./CheckoutForms.js";
 export type CheckoutMode = "redirect" | "embedded" | "custom" | "form" | "payment-intent";
 export type CheckoutSessionResult = {
@@ -27,6 +27,8 @@ type Common = CheckoutFormOptions & {
     publishableKey: string;
     /** Changes when the price, signed-in customer, or referral attribution changes. */
     orderKey: string;
+    /** Optional durable logical-order identity, persisted by the host app. */
+    requestId?: string;
     returnUrl: string;
     onNavigate?: (url: string) => void;
     children?: (state: CheckoutRenderProps) => ReactNode;

package/dist/react/workflows/Checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Checkout.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Checkout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,MAAM,MAAM,YAAY,GACtB,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,gBAAgB,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AACF,KAAK,MAAM,GAAG,mBAAmB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,SAAS,CAAC;CACtD,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,MAAM,GAChC,CACI;IACE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9C,aAAa,EAAE,CACb,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,mBAAmB,EAAE,CAAC,OAAO,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CACJ,CAAC;AACJ,6HAA6H;AAC7H,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,+BAE5C"}
+{"version":3,"file":"Checkout.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Checkout.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjD,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,MAAM,MAAM,YAAY,GACtB,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,gBAAgB,CAAC;AACjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AACF,KAAK,MAAM,GAAG,mBAAmB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,SAAS,CAAC;CACtD,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,MAAM,GAChC,CACI;IACE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9C,aAAa,EAAE,CACb,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,mBAAmB,EAAE,CAAC,OAAO,EAAE;QAC7B,SAAS,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC,CACJ,CAAC;AACJ,6HAA6H;AAC7H,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,+BAO5C"}

package/dist/react/workflows/Checkout.js

@@ -1,15 +1,16 @@
 "use client";
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
 import { EmbeddedCheckout } from "../components/EmbeddedCheckout.js";
 import { useWorkflowResource } from "./useWorkflowResource.js";
 import { CheckoutElementsForm, PaymentIntentForm, CheckoutForm, } from "./CheckoutForms.js";
 /** All checkout integrations share one unstyled lifecycle. Callbacks must authenticate and validate prices on the server. */
 export function Checkout(props) {
-    return _jsx(CheckoutBody, { ...props }, `${props.orderKey}:${props.mode}`);
+    return (_jsx(CheckoutBody, { ...props }, `${props.orderKey}:${props.mode}:${props.requestId ?? ""}`));
 }
 function CheckoutBody(props) {
+    const [requestId] = useState(() => props.requestId ?? crypto.randomUUID());
     const state = useWorkflowResource(async () => {
-        const requestId = crypto.randomUUID();
         const result = props.mode === "payment-intent"
             ? await props.createPaymentIntent({ requestId })
             : await props.createSession({ mode: props.mode, requestId });

package/dist/react/workflows/Checkout.js.map

@@ -1 +1 @@
-{"version":3,"file":"Checkout.js","sourceRoot":"","sources":["../../../src/react/workflows/Checkout.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Checkout.js","sourceRoot":"","sources":["../../../src/react/workflows/Checkout.tsx"],"names":[],"mappings":"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"}

package/dist/react/workflows/Payouts.d.ts

@@ -1,24 +1,9 @@
+import type { RecipientPayoutSnapshot, RecipientPayoutRow } from "../../client/connect/payoutSnapshot.js";
 import { type ReactNode } from "react";
 import { type ConnectProps } from "./Connect.js";
 import { type CollectionProps, type WorkflowColumn } from "./Collection.js";
-export type PayoutRow = {
-    id: string;
-    amount: number;
-    currency: string;
-    status: string;
-    /** Unix milliseconds. */ arrivalDate: number | null;
-    created: number;
-};
-export type PayoutSnapshot = {
-    balances: {
-        currency: string;
-        available: number;
-        pending: number;
-    }[];
-    payouts: PayoutRow[];
-    upcoming: PayoutRow[];
-    nextCursor: string | null;
-};
+export type PayoutRow = RecipientPayoutRow;
+export type PayoutSnapshot = Pick<RecipientPayoutSnapshot, "balances" | "payouts" | "upcoming" | "nextCursor"> & Partial<Pick<RecipientPayoutSnapshot, "status" | "reason" | "upcomingComplete">>;
 export type PayoutsRenderProps = {
     data: PayoutSnapshot | undefined;
     error: string | null;

package/dist/react/workflows/Payouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Payouts.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Payouts.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CACrD,CAAC;AACF,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG;IAAE,YAAY,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAGrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,+BAM1C;AA+DD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,SAAS,EACT,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CACxD,CAAC;AACF,MAAM,MAAM,kBAAkB,CAC5B,GAAG,SAAS,gBAAgB,GAAG,gBAAgB,IAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG;IACrD,OAAO,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;CACjC,CAAC;AACF,wBAAgB,aAAa,CAAC,GAAG,SAAS,gBAAgB,EACxD,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,+BAyB/B"}
+{"version":3,"file":"Payouts.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Payouts.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,uBAAuB,EACvB,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CACnD,GACC,OAAO,CACL,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,QAAQ,GAAG,kBAAkB,CAAC,CACxE,CAAC;AACJ,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,cAAc,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CACrD,CAAC;AACF,MAAM,MAAM,YAAY,GACpB,oBAAoB,GACpB,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG;IAAE,YAAY,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAGrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,+BAM1C;AA+DD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,SAAS,EACT,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CACxD,CAAC;AACF,MAAM,MAAM,kBAAkB,CAC5B,GAAG,SAAS,gBAAgB,GAAG,gBAAgB,IAC7C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG;IACrD,OAAO,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;CACjC,CAAC;AACF,wBAAgB,aAAa,CAAC,GAAG,SAAS,gBAAgB,EACxD,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,+BAyB/B"}

package/dist/react/workflows/Payouts.js

@@ -79,9 +79,9 @@ export function PayoutHistory(props) {
     return (_jsx(Collection, { emptyLabel: "No payouts yet.", ...props, getKey: (row) => row.id, columns: props.columns ?? columns }));
 }
 function NativePayouts({ data, isLoading, isPending, error, nextPayout, previousPayouts, upcomingPayouts, refresh, loadMore, }) {
-    return (_jsxs("section", { "data-better-stripe": "payouts", "aria-busy": isPending, children: [_jsx("h2", { children: "Payouts" }), _jsx("button", { type: "button", disabled: isPending, onClick: refresh, children: isPending ? "Refreshing…" : "Refresh" }), error && _jsx("p", { role: "alert", children: error }), isLoading && !data && _jsx("p", { role: "status", children: "Loading payouts\u2026" }), data && (_jsxs(_Fragment, { children: [_jsxs("dl", { children: [data.balances.map((balance) => (_jsxs("div", { children: [_jsx("dt", { children: "Available" }), _jsx("dd", { children: formatPrice(balance.available, balance.currency) }), _jsx("dt", { children: "Pending" }), _jsx("dd", { children: formatPrice(balance.pending, balance.currency) })] }, balance.currency))), _jsx("dt", { children: "Next payout" }), _jsx("dd", { children: nextPayout
+    return (_jsxs("section", { "data-better-stripe": "payouts", "aria-busy": isPending, children: [_jsx("h2", { children: "Payouts" }), _jsx("button", { type: "button", disabled: isPending, onClick: refresh, children: isPending ? "Refreshing…" : "Refresh" }), error && _jsx("p", { role: "alert", children: error }), isLoading && !data && _jsx("p", { role: "status", children: "Loading payouts\u2026" }), data?.status === "not_ready" && (_jsx("p", { role: "alert", children: "Stripe account data is not available yet." })), data && data.status !== "not_ready" && (_jsxs(_Fragment, { children: [_jsxs("dl", { children: [data.balances.map((balance) => (_jsxs("div", { children: [_jsx("dt", { children: "Available" }), _jsx("dd", { children: formatPrice(balance.available, balance.currency) }), _jsx("dt", { children: "Pending" }), _jsx("dd", { children: formatPrice(balance.pending, balance.currency) })] }, balance.currency))), _jsx("dt", { children: "Next payout" }), _jsx("dd", { children: nextPayout
                                     ? `${formatPrice(nextPayout.amount, nextPayout.currency)} · ${date(nextPayout.arrivalDate)}`
-                                    : "Not scheduled" })] }), _jsx("h3", { children: "Upcoming payouts" }), _jsx(PayoutHistory, { rows: upcomingPayouts, emptyLabel: "No upcoming payouts scheduled." }), _jsx("h3", { children: "Previous payouts" }), _jsx(PayoutHistory, { rows: previousPayouts, emptyLabel: "No previous payouts yet." }), data.nextCursor && (_jsx("button", { type: "button", disabled: isPending, onClick: () => {
+                                    : "Not scheduled" })] }), _jsx("h3", { children: "Upcoming payouts" }), data.upcomingComplete === false && (_jsx("p", { children: "Upcoming payouts are a bounded preview. More may be scheduled." })), _jsx(PayoutHistory, { rows: upcomingPayouts, emptyLabel: "No upcoming payouts scheduled." }), _jsx("h3", { children: "Previous payouts" }), _jsx(PayoutHistory, { rows: previousPayouts, emptyLabel: "No previous payouts yet." }), data.nextCursor && (_jsx("button", { type: "button", disabled: isPending, onClick: () => {
                             void loadMore();
                         }, children: isPending ? "Loading…" : "Load more payouts" }))] }))] }));
 }

package/dist/react/workflows/Payouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"Payouts.js","sourceRoot":"","sources":["../../../src/react/workflows/Payouts.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Payouts.js","sourceRoot":"","sources":["../../../src/react/workflows/Payouts.tsx"],"names":[],"mappings":"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"}

package/docs/accounts-v2-preview.md

@@ -0,0 +1,132 @@
+# Customer-only Accounts v2 preview
+
+Connect platforms keep the default `2026-09-30.endive` API version. Non-Connect
+merchants can explicitly opt into `2026-09-30.preview` for customer-configured
+Accounts. The package does not enable Connect or onboard a merchant/recipient
+when creating a buyer with `ensureCustomerAccount`.
+
+## Enable the sandbox feature first
+
+In the intended sandbox, the account owner must enable **Reusable payment
+methods for Global Payouts** under **Account previews and features**. If the toggle
+is unavailable, request access using Stripe's form. This also enables Stripe's
+reusable payout credentials preview; it is not a Connect onboarding flow.
+Changing an API version cannot enable the feature on the Stripe account.
+
+Enabling the preview synchronizes existing Customers with customer-configured
+Accounts and changes how Stripe-hosted integrations create customers. Review
+Stripe's limitations and migration behavior before changing any live account.
+See [Stripe's customer Account guide](https://docs.stripe.com/accounts-v2/use-accounts-as-customers).
+
+## Configure one client and its webhook route
+
+```ts
+// convex/stripe.ts
+import {
+  BetterStripe,
+  STRIPE_CUSTOMER_PREVIEW_API_VERSION,
+} from "@fantastic.dev/better-stripe";
+import { components } from "./_generated/api";
+
+export const stripe = new BetterStripe(components.betterStripe, {
+  STRIPE_SECRET_KEY: process.env.STRIPE_SECRET_KEY,
+  stripeApiVersion: STRIPE_CUSTOMER_PREVIEW_API_VERSION,
+});
+```
+
+```ts
+// convex/http.ts
+import { httpRouter } from "convex/server";
+import { stripe } from "./stripe";
+
+const http = httpRouter();
+stripe.registerRoutes(http, {
+  webhookPath: "/stripe/webhook",
+  webhookSecret: process.env.STRIPE_WEBHOOK_SECRET,
+  webhookSecretV2: process.env.STRIPE_WEBHOOK_SECRET_V2,
+  // Preserve your existing `webhooks` handler references and retry policy here.
+});
+export default http;
+```
+
+The instance route inherits its client's key and version. Conflicting explicit
+values fail at registration. The standalone `registerRoutes` function remains
+available; when using it, pass `stripeApiVersion: stripe.stripeApiVersion` and the
+same secret key explicitly. The client accepts only the supported GA and customer
+preview versions; unsupported values fail with `INVALID_CONFIGURATION`.
+
+All client operations use the selected version: account creation/configuration,
+Checkout, subscriptions, portal sessions, refunds, authoritative reads, and the
+provider calls made while handling webhooks. Component database writes remain
+provider-version independent. SDK caches separate clients by key and version.
+
+## Create a buyer and Checkout Session
+
+Authenticate the caller and validate ownership/prices on the server. The client
+is not an authorization boundary. Persist logical request identities in your host
+app so retries keep the same provider keys and new purchases use distinct keys.
+
+```ts
+const buyer = await stripe.ensureCustomerAccount(ctx, {
+  userId: identity.subject,
+  email: verifiedEmail,
+  idempotencyKey: accountProvisioningKey,
+});
+const checkout = await stripe.createCheckoutSession(ctx, {
+  userId: identity.subject,
+  accountId: buyer.stripeAccountId,
+  stripePriceId: authorizedPriceId,
+  mode: "subscription",
+  uiMode: "redirect",
+  returnUrl: "https://example.com/receipt?session_id={CHECKOUT_SESSION_ID}",
+  idempotencyKey: orderKey,
+});
+```
+
+The buyer is an `acct_` object with the customer configuration. Checkout uses
+`customer_account`, not a connected-account destination. No seller, recipient,
+transfer, or application fee is added by this configuration.
+
+After verifying buyer/order ownership, use `getCheckoutSessionFromStripe` to
+check current payment status. Completion alone does not prove payment: fulfill
+only when your payment policy accepts the authoritative status, and deduplicate
+fulfillment by a durable order key. Subscription and coupon reads use the same
+configured version. Cancellation/reactivation and refunds keep their existing
+public API signatures and caller idempotency behavior.
+
+## Match webhook payload versions and scope
+
+Snapshot destinations created through this client pin `snapshot_api_version` to
+the selected version. V1 webhook endpoints pin their `api_version`. Thin events
+are unversioned; their related customer Account is fetched with the selected
+request version and only customer/identity includes in customer-preview mode.
+
+The preview's default thin subscription covers Account creation, customer
+configuration changes, and identity changes, using Stripe's `@self` and
+`@accounts` scopes. Subscription and invoice changes continue to use V1 snapshot
+events. No merchant or recipient capability events are subscribed by default in
+customer-preview mode. The GA defaults retain their existing event selection.
+
+Stripe cannot update a destination's snapshot version or event scopes in place.
+`setupEventDestination` refuses an incompatible existing destination rather than
+silently reusing it. Create a replacement at a new webhook path, register the
+matching route and signing secret, verify deliveries, then retire the old
+endpoint. A low-level `createWebhookEndpoint` call retains its existing same-URL
+secret-rotation behavior; do not use it as an implicit migration plan.
+
+See [event destination creation](https://docs.stripe.com/api/v2/core/event-destinations/create)
+and [update restrictions](https://docs.stripe.com/api/v2/core/event-destinations/update).
+
+## Verification boundary
+
+Package tests exercise serialized SDK request headers, customer-only account
+configuration, idempotency keys, Checkout buyer binding, authoritative reads,
+subscription cancellation/reactivation, portal and refund calls, webhook route
+configuration, thin-event synchronization, and snapshot version/scope checks.
+The GA version has regression coverage alongside the preview version.
+
+A real non-Connect sandbox test additionally requires the owner-enabled preview
+and sandbox credentials. A Connect sandbox, mocked transport, or successful
+TypeScript compilation does not prove that separate eligibility requirement.
+Do not report checkout, receipt, renewal, portal or refund acceptance as verified
+for a non-Connect merchant until those flows run in its enabled sandbox.