@fantastic.dev/better-stripe 0.18.0 → 0.20.0

package/dist/component/payoutRelease/mutations.js

@@ -0,0 +1,254 @@
+import { v } from "convex/values";
+import { mutation } from "../_generated/server.js";
+import { identity, observation, claimDoc } from "./schema.js";
+import { claimByKey, readyPolicy, checkSnapshot, sourceById, moveAllocations, validateIdentity, add, } from "./helpers.js";
+import { planRecipientPayout } from "./allocation.js";
+const held = v.object({
+    status: v.literal("held"),
+    reason: v.union(v.literal("below_threshold"), v.literal("insufficient_available"), v.literal("pending_claim")),
+    amount: v.literal(0),
+    matureUnpaid: v.optional(v.number()),
+    pendingCredits: v.optional(v.number()),
+    currency: v.string(),
+    providerMinimum: v.null(),
+});
+/** Trusted server package boundary only: provider observations are verified upstream. Not a Stripe executor. */
+export const claim = mutation({
+    args: {
+        ...identity,
+        expectedRevision: v.number(),
+        currency: v.string(),
+        providerAvailable: v.number(),
+        independentLiabilities: v.number(),
+        observations: v.array(observation),
+    },
+    returns: v.union(claimDoc, held),
+    handler: async (ctx, args) => {
+        validateIdentity(args);
+        const existing = await claimByKey(ctx, args);
+        if (existing) {
+            if (existing.currency !== args.currency ||
+                existing.expectedRevision !== args.expectedRevision)
+                throw new Error("Payout claim identity cannot be reused.");
+            return existing;
+        }
+        const policy = await readyPolicy(ctx, args);
+        const minimum = policy.thresholds.find((value) => value.currency === args.currency);
+        if (!minimum)
+            throw new Error("Payout policy currency is not configured.");
+        const pending = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_account_status", (q) => q.eq("accountId", args.accountId).eq("status", "reserved"))
+            .first();
+        if (pending)
+            return {
+                status: "held",
+                reason: "pending_claim",
+                amount: 0,
+                currency: args.currency,
+                providerMinimum: null,
+            };
+        const rows = await checkSnapshot(ctx, args.accountId, args.observations, true);
+        const sources = [];
+        for (const observation of args.observations) {
+            const prior = await sourceById(ctx, observation.stripeTransferId);
+            if (prior &&
+                (prior.accountId !== args.accountId ||
+                    prior.ownerKey !== args.ownerKey ||
+                    prior.currency !== observation.currency))
+                throw new Error("Payout source allocation identity changed.");
+            sources.push({
+                ...observation,
+                role: rows.get(observation.stripeTransferId).role,
+                paidAmount: prior?.paidAmount ?? 0,
+                reservedAmount: prior?.reservedAmount ?? 0,
+            });
+        }
+        const plan = planRecipientPayout({
+            currency: args.currency,
+            threshold: minimum.amount,
+            providerAvailable: args.providerAvailable,
+            independentLiabilities: args.independentLiabilities,
+            sources,
+        });
+        if (plan.status === "held")
+            return plan;
+        for (const allocation of plan.allocations) {
+            const prior = await sourceById(ctx, allocation.stripeTransferId);
+            if (prior)
+                await ctx.db.patch("payoutSourceAllocations", prior._id, {
+                    reservedAmount: add(prior.reservedAmount, allocation.amount),
+                });
+            else
+                await ctx.db.insert("payoutSourceAllocations", {
+                    accountId: args.accountId,
+                    ownerKey: args.ownerKey,
+                    stripeTransferId: allocation.stripeTransferId,
+                    currency: args.currency,
+                    paidAmount: 0,
+                    reservedAmount: allocation.amount,
+                });
+        }
+        const id = await ctx.db.insert("payoutReleaseClaims", {
+            accountId: args.accountId,
+            ownerKey: args.ownerKey,
+            operationKey: args.operationKey,
+            expectedRevision: args.expectedRevision,
+            currency: args.currency,
+            amount: plan.amount,
+            allocations: plan.allocations,
+            observations: args.observations,
+            status: "reserved",
+        });
+        return (await ctx.db.get("payoutReleaseClaims", id));
+    },
+});
+export const beginAttempt = mutation({
+    args: identity,
+    returns: claimDoc,
+    handler: async (ctx, args) => {
+        const claim = await claimByKey(ctx, args);
+        if (!claim || claim.status !== "reserved")
+            throw new Error("Payout claim is not reserved.");
+        if (claim.attemptedAt !== undefined)
+            return claim;
+        await readyPolicy(ctx, claim);
+        await checkSnapshot(ctx, claim.accountId, claim.observations, true);
+        await ctx.db.patch("payoutReleaseClaims", claim._id, {
+            attemptedAt: Date.now(),
+        });
+        return (await ctx.db.get("payoutReleaseClaims", claim._id));
+    },
+});
+export const cancelUnattempted = mutation({
+    args: identity,
+    returns: claimDoc,
+    handler: async (ctx, args) => {
+        const claim = await claimByKey(ctx, args);
+        if (!claim ||
+            claim.attemptedAt !== undefined ||
+            (claim.status !== "reserved" && claim.status !== "canceled"))
+            throw new Error("An attempted payout claim cannot be canceled.");
+        if (claim.status === "canceled")
+            return claim;
+        await moveAllocations(ctx, claim, "release");
+        await ctx.db.patch("payoutReleaseClaims", claim._id, {
+            status: "canceled",
+        });
+        return (await ctx.db.get("payoutReleaseClaims", claim._id));
+    },
+});
+export const recordOutcome = mutation({
+    args: {
+        ...identity,
+        stripePayoutId: v.string(),
+        amount: v.number(),
+        currency: v.string(),
+        providerStatus: v.union(v.literal("pending"), v.literal("in_transit"), v.literal("paid"), v.literal("failed"), v.literal("canceled")),
+        returnTransactionId: v.optional(v.string()),
+    },
+    returns: claimDoc,
+    handler: async (ctx, args) => {
+        const claim = await claimByKey(ctx, args);
+        if (!claim ||
+            claim.attemptedAt === undefined ||
+            claim.status === "canceled" ||
+            claim.status === "rejected")
+            throw new Error("Payout receipt has no attempted claim.");
+        if (!/^po_\w+$/.test(args.stripePayoutId) ||
+            args.stripePayoutId.trim() !== args.stripePayoutId ||
+            args.currency !== claim.currency ||
+            args.amount !== claim.amount ||
+            (claim.stripePayoutId !== undefined &&
+                claim.stripePayoutId !== args.stripePayoutId))
+            throw new Error("Payout receipt identity or amount does not match.");
+        const adopted = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_provider_payout", (q) => q.eq("stripePayoutId", args.stripePayoutId))
+            .unique();
+        if (adopted && adopted._id !== claim._id)
+            throw new Error("Payout receipt identity is already allocated.");
+        if (args.returnTransactionId !== undefined &&
+            (!/^txn_\w+$/.test(args.returnTransactionId) ||
+                args.returnTransactionId.trim() !== args.returnTransactionId))
+            throw new Error("Invalid payout return receipt identity.");
+        const returned = (args.providerStatus === "failed" ||
+            args.providerStatus === "canceled") &&
+            args.returnTransactionId !== undefined;
+        if (returned) {
+            const adoptedReturn = await ctx.db
+                .query("payoutReleaseClaims")
+                .withIndex("by_return_receipt", (q) => q.eq("returnTransactionId", args.returnTransactionId))
+                .unique();
+            if (adoptedReturn && adoptedReturn._id !== claim._id)
+                throw new Error("Payout return receipt is already allocated.");
+        }
+        if (claim.status === "returned") {
+            if (returned && args.returnTransactionId !== claim.returnTransactionId)
+                throw new Error("Payout return receipt identity changed.");
+            return claim;
+        }
+        if (returned) {
+            await moveAllocations(ctx, claim, claim.status === "paid" ? "return" : "release");
+            await ctx.db.patch("payoutReleaseClaims", claim._id, {
+                status: "returned",
+                stripePayoutId: args.stripePayoutId,
+                returnTransactionId: args.returnTransactionId,
+            });
+        }
+        else if (args.providerStatus === "paid" && claim.status !== "paid") {
+            await moveAllocations(ctx, claim, "pay");
+            await ctx.db.patch("payoutReleaseClaims", claim._id, {
+                status: "paid",
+                stripePayoutId: args.stripePayoutId,
+            });
+        }
+        else if (claim.status !== "paid") {
+            await ctx.db.patch("payoutReleaseClaims", claim._id, {
+                status: "submitted",
+                stripePayoutId: args.stripePayoutId,
+            });
+        }
+        return (await ctx.db.get("payoutReleaseClaims", claim._id));
+    },
+});
+/** Only a verified, no-object rejection within the original idempotency window. */
+export const recordRejection = mutation({
+    args: {
+        ...identity,
+        requestId: v.string(),
+        code: v.union(v.literal("balance_insufficient"), v.literal("amount_too_small")),
+    },
+    returns: claimDoc,
+    handler: async (ctx, args) => {
+        const claim = await claimByKey(ctx, args);
+        if (!claim ||
+            !/^req_\w+$/.test(args.requestId) ||
+            args.requestId.trim() !== args.requestId)
+            throw new Error("Invalid payout rejection receipt.");
+        if (claim.status === "rejected") {
+            if (claim.rejection?.requestId !== args.requestId ||
+                claim.rejection.code !== args.code)
+                throw new Error("Payout rejection receipt identity changed.");
+            return claim;
+        }
+        if (claim.status !== "reserved" ||
+            claim.stripePayoutId ||
+            claim.attemptedAt === undefined ||
+            Date.now() - claim.attemptedAt >= 23 * 60 * 60 * 1000)
+            throw new Error("An accepted or uncertain expired payout attempt cannot be released as a rejection.");
+        const adoptedRejection = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_rejection_request", (q) => q.eq("rejection.requestId", args.requestId))
+            .unique();
+        if (adoptedRejection && adoptedRejection._id !== claim._id)
+            throw new Error("Payout rejection receipt is already allocated.");
+        await moveAllocations(ctx, claim, "release");
+        await ctx.db.patch("payoutReleaseClaims", claim._id, {
+            status: "rejected",
+            rejection: { requestId: args.requestId, code: args.code },
+        });
+        return (await ctx.db.get("payoutReleaseClaims", claim._id));
+    },
+});
+//# sourceMappingURL=mutations.js.map

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

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

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

@@ -0,0 +1,84 @@
+export declare const get: import("convex/server").RegisteredQuery<"public", {
+    accountId: string;
+    operationKey: string;
+    ownerKey: string;
+}, Promise<{
+    _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;
+} | null>>;
+export declare const pending: import("convex/server").RegisteredQuery<"public", {
+    accountId: string;
+    ownerKey: string;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<{
+    page: {
+        _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;
+    }[];
+    continueCursor: string;
+    isDone: boolean;
+}>>;
+//# sourceMappingURL=queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiBd,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BlB,CAAC"}

package/dist/component/payoutRelease/queries.js

@@ -0,0 +1,51 @@
+import { paginationOptsValidator } from "convex/server";
+import { v } from "convex/values";
+import { query } from "../_generated/server.js";
+import { identity, claimDoc } from "./schema.js";
+import { validateIdentity } from "./helpers.js";
+import { readPolicy } from "../payoutPolicy/helpers.js";
+export const get = query({
+    args: identity,
+    returns: v.union(claimDoc, v.null()),
+    handler: async (ctx, args) => {
+        validateIdentity(args);
+        await readPolicy(ctx, args);
+        const claim = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_operation", (q) => q.eq("operationKey", args.operationKey))
+            .unique();
+        if (claim &&
+            (claim.accountId !== args.accountId || claim.ownerKey !== args.ownerKey))
+            throw new Error("Payout claim identity does not match.");
+        return claim;
+    },
+});
+export const pending = query({
+    args: {
+        accountId: v.string(),
+        ownerKey: v.string(),
+        paginationOpts: paginationOptsValidator,
+    },
+    returns: v.object({
+        page: v.array(claimDoc),
+        continueCursor: v.string(),
+        isDone: v.boolean(),
+    }),
+    handler: async (ctx, args) => {
+        await readPolicy(ctx, args);
+        if (!Number.isInteger(args.paginationOpts.numItems) ||
+            args.paginationOpts.numItems < 1 ||
+            args.paginationOpts.numItems > 100)
+            throw new Error("Invalid payout claim page.");
+        const result = await ctx.db
+            .query("payoutReleaseClaims")
+            .withIndex("by_account_status", (q) => q.eq("accountId", args.accountId).eq("status", "reserved"))
+            .paginate(args.paginationOpts);
+        return {
+            page: result.page,
+            continueCursor: result.continueCursor,
+            isDone: result.isDone,
+        };
+    },
+});
+//# sourceMappingURL=queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;IACvB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;aACvB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;aACzE,MAAM,EAAE,CAAC;QACZ,IACE,KAAK;YACL,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;YAExE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC;IAC3B,IAAI,EAAE;QACJ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,uBAAuB;KACxC;IACD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QACvB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC;YAC/C,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,CAAC;YAChC,IAAI,CAAC,cAAc,CAAC,QAAQ,GAAG,GAAG;YAElC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACxB,KAAK,CAAC,qBAAqB,CAAC;aAC5B,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACpC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAC3D;aACA,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}