@fantastic.dev/better-stripe 0.18.0 → 0.20.0

package/dist/component/payoutRelease/allocation.js

@@ -0,0 +1,98 @@
+function money(value) {
+    if (!Number.isSafeInteger(value))
+        throw new Error("Unsafe payout arithmetic.");
+    return value;
+}
+function nonnegative(value) {
+    if (money(value) < 0)
+        throw new Error("Invalid payout accounting amount.");
+}
+function currency(value) {
+    if (value.length !== 3 || !/^[a-z]{3}$/.test(value))
+        throw new Error("Invalid payout currency.");
+}
+/**
+ * Pure allocation step, not authorization to call Stripe. Inputs must be a
+ * complete, verified still-unpaid snapshot for this recipient. Policy controls,
+ * source ownership/maturity, prior payout adoption, independent liabilities and
+ * atomic reservations must be established by the execution boundary.
+ *
+ * Negative source entitlement survives refunds after payout. Pending credits
+ * never qualify. Each source's reservations reduce entitlement; they are not
+ * subtracted again from fresh provider availability, which may already include
+ * the provider debit for those same in-flight payouts.
+ */
+export function planRecipientPayout(opts) {
+    currency(opts.currency);
+    if (money(opts.threshold) <= 0)
+        throw new Error("Invalid payout threshold.");
+    money(opts.providerAvailable);
+    nonnegative(opts.independentLiabilities);
+    const seen = new Set();
+    for (const source of opts.sources) {
+        if (!/^tr_\w+$/.test(source.stripeTransferId) ||
+            source.stripeTransferId.trim() !== source.stripeTransferId ||
+            source.stripeTransferId.length > 100)
+            throw new Error("Invalid payout source identity.");
+        if (seen.has(source.stripeTransferId))
+            throw new Error("Duplicate payout source.");
+        seen.add(source.stripeTransferId);
+        currency(source.currency);
+        money(source.matureNet);
+        nonnegative(source.paidAmount);
+        nonnegative(source.reservedAmount);
+        nonnegative(source.pendingCredits);
+        if (source.role !== undefined &&
+            !["store", "affiliate", "other"].includes(source.role))
+            throw new Error("Invalid payout source role.");
+    }
+    const sources = opts.sources
+        .filter((source) => source.currency === opts.currency)
+        .sort((a, b) => a.stripeTransferId < b.stripeTransferId
+        ? -1
+        : a.stripeTransferId > b.stripeTransferId
+            ? 1
+            : 0);
+    let matureUnpaid = 0;
+    let pendingCredits = 0;
+    const credits = sources.map((source) => {
+        const unpaid = money(money(source.matureNet - source.paidAmount) - source.reservedAmount);
+        matureUnpaid = money(matureUnpaid + unpaid);
+        pendingCredits = money(pendingCredits + source.pendingCredits);
+        return { source, unpaid };
+    });
+    const totals = {
+        currency: opts.currency,
+        matureUnpaid,
+        pendingCredits,
+        providerMinimum: null,
+    };
+    const providerAvailable = money(opts.providerAvailable - opts.independentLiabilities);
+    if (matureUnpaid < opts.threshold)
+        return { ...totals, status: "held", reason: "below_threshold", amount: 0 };
+    const amount = Math.min(matureUnpaid, providerAvailable);
+    if (amount < opts.threshold)
+        return {
+            ...totals,
+            status: "held",
+            reason: "insufficient_available",
+            amount: 0,
+        };
+    let remaining = amount;
+    const allocations = [];
+    for (const { source, unpaid } of credits) {
+        const allocated = Math.min(Math.max(0, unpaid), remaining);
+        if (allocated) {
+            allocations.push({
+                stripeTransferId: source.stripeTransferId,
+                amount: allocated,
+                ...(source.role === undefined ? {} : { role: source.role }),
+            });
+            remaining = money(remaining - allocated);
+        }
+    }
+    if (remaining !== 0)
+        throw new Error("Invalid payout source allocation.");
+    return { ...totals, status: "qualified", amount, allocations };
+}
+//# sourceMappingURL=allocation.js.map

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

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

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

@@ -0,0 +1,106 @@
+import type { Infer } from "convex/values";
+import type { transferDocValidator } from "../connect/validators.js";
+import type { MutationCtx } from "../_generated/server.js";
+import type { Doc } from "../_generated/dataModel.js";
+import type { observation } from "./schema.js";
+import { addSummaryAmounts } from "../earnings/arithmetic.js";
+export declare const add: typeof addSummaryAmounts;
+export declare function transferFingerprint(t: Infer<typeof transferDocValidator>): string;
+export declare function validateIdentity(args: {
+    accountId: string;
+    ownerKey: string;
+    operationKey: string;
+}): void;
+export declare function claimByKey(ctx: MutationCtx, args: {
+    accountId: string;
+    ownerKey: string;
+    operationKey: 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 function readyPolicy(ctx: MutationCtx, args: {
+    accountId: string;
+    ownerKey: string;
+    expectedRevision: number;
+}): Promise<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"payoutPolicies">;
+    accountId: string;
+    country: string;
+    holdDeadline?: number | undefined;
+    mode: "custom" | "stripe_managed";
+    operationKey: string;
+    ownerKey: string;
+    previousSchedule?: {
+        interval: "daily" | "manual" | "monthly" | "weekly";
+        monthlyDays?: number[] | undefined;
+        weeklyDays?: string[] | undefined;
+    } | undefined;
+    revision: number;
+    status: "changing" | "ready";
+    thresholds: {
+        amount: number;
+        currency: string;
+    }[];
+}>;
+/** Full local account membership is checked under OCC before any reservation. */
+export declare function checkSnapshot(ctx: MutationCtx, accountId: string, observations: Infer<typeof observation>[], fresh: boolean): Promise<Map<string, {
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"transfers">;
+    amount: number;
+    currency: string;
+    destinationAccountId: string;
+    metadata?: any;
+    paymentId?: string | undefined;
+    reinstatement?: boolean | undefined;
+    reversalClaimedAmount?: number | undefined;
+    reversalStatus?: "fully_reversed" | "partially_reversed" | undefined;
+    reversedAmount?: number | undefined;
+    role?: "affiliate" | "other" | "store" | undefined;
+    sourceChargeId?: string | undefined;
+    sourceInvoiceId?: string | undefined;
+    status: "failed" | "paid" | "pending" | "reversed";
+    stripeTransferId: string;
+    totalsRecorded?: true | undefined;
+}>>;
+export declare function sourceById(ctx: MutationCtx, stripeTransferId: string): Promise<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"payoutSourceAllocations">;
+    accountId: string;
+    currency: string;
+    ownerKey: string;
+    paidAmount: number;
+    reservedAmount: number;
+    stripeTransferId: string;
+} | null>;
+export declare function moveAllocations(ctx: MutationCtx, claim: Doc<"payoutReleaseClaims">, transition: "pay" | "release" | "return"): Promise<void>;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,eAAO,MAAM,GAAG,0BAAoB,CAAC;AACrC,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,oBAAoB,CAAC,UAaxE;AACD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,QAQA;AACD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAapE;AACD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;GAaxE;AACD,iFAAiF;AACjF,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,EACzC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;IAuDf;AACD,wBAAsB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM;;;;;;;;;UAK1E;AACD,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,GAAG,CAAC,qBAAqB,CAAC,EACjC,UAAU,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,iBA8BzC"}

package/dist/component/payoutRelease/helpers.js

@@ -0,0 +1,119 @@
+import { readPolicy, validateScope } from "../payoutPolicy/helpers.js";
+import { addSummaryAmounts } from "../earnings/arithmetic.js";
+export const add = addSummaryAmounts;
+export function transferFingerprint(t) {
+    return JSON.stringify([
+        t.stripeTransferId,
+        t.destinationAccountId,
+        t.sourceChargeId,
+        t.amount,
+        t.currency,
+        t.role,
+        t.status,
+        t.reversedAmount ?? 0,
+        t.reversalClaimedAmount ?? 0,
+        t.reinstatement ?? false,
+    ]);
+}
+export function validateIdentity(args) {
+    validateScope(args);
+    if (!args.operationKey.trim() ||
+        args.operationKey.length > 180 ||
+        /[\r\n]/.test(args.operationKey))
+        throw new Error("Invalid payout claim identity.");
+}
+export async function claimByKey(ctx, args) {
+    validateIdentity(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 async function readyPolicy(ctx, args) {
+    const policy = await readPolicy(ctx, args);
+    if (!Number.isSafeInteger(args.expectedRevision) ||
+        policy?.revision !== args.expectedRevision ||
+        policy.mode !== "custom" ||
+        policy.status !== "ready" ||
+        !policy.holdDeadline ||
+        policy.holdDeadline <= Date.now())
+        throw new Error("Payout policy is not ready at this revision.");
+    return policy;
+}
+/** Full local account membership is checked under OCC before any reservation. */
+export async function checkSnapshot(ctx, accountId, observations, fresh) {
+    const rows = await ctx.db
+        .query("transfers")
+        .withIndex("by_destination_account_id", (q) => q.eq("destinationAccountId", accountId))
+        .take(101);
+    if (rows.length > 100 ||
+        observations.length !== rows.length ||
+        new Set(observations.map((o) => o.stripeTransferId)).size !== rows.length)
+        throw new Error("Payout source snapshot is incomplete or duplicated.");
+    const byId = new Map(rows.map((row) => [row.stripeTransferId, row]));
+    const allocated = await ctx.db
+        .query("payoutSourceAllocations")
+        .withIndex("by_account", (q) => q.eq("accountId", accountId))
+        .take(101);
+    if (allocated.length > 100 ||
+        allocated.some((source) => !byId.has(source.stripeTransferId)))
+        throw new Error("Payout source allocation snapshot is incomplete.");
+    const receiptIds = new Set();
+    for (const o of observations) {
+        const row = byId.get(o.stripeTransferId);
+        if (!row ||
+            transferFingerprint(row) !== o.ledgerFingerprint ||
+            (row.status !== "paid" && row.status !== "reversed") ||
+            (row.reversalClaimedAmount ?? 0) > (row.reversedAmount ?? 0))
+            throw new Error("Payout source snapshot changed or is not ready.");
+        if (fresh &&
+            (!Number.isSafeInteger(o.observedAt) ||
+                o.observedAt > Date.now() ||
+                o.observedAt < Date.now() - 30000))
+            throw new Error("Payout source observation is stale or in the future.");
+        if (!o.transactionIds.length ||
+            o.transactionIds.length > 1000 ||
+            new Set(o.transactionIds).size !== o.transactionIds.length ||
+            o.transactionIds.some((id) => !/^txn_\w+$/.test(id) || id.trim() !== id))
+            throw new Error("Invalid payout source receipt identities.");
+        for (const id of o.transactionIds) {
+            if (receiptIds.has(id))
+                throw new Error("Duplicate payout source receipt.");
+            receiptIds.add(id);
+        }
+    }
+    return byId;
+}
+export async function sourceById(ctx, stripeTransferId) {
+    return ctx.db
+        .query("payoutSourceAllocations")
+        .withIndex("by_transfer", (q) => q.eq("stripeTransferId", stripeTransferId))
+        .unique();
+}
+export async function moveAllocations(ctx, claim, transition) {
+    for (const allocation of claim.allocations) {
+        const source = await sourceById(ctx, allocation.stripeTransferId);
+        if (!source ||
+            source.accountId !== claim.accountId ||
+            source.ownerKey !== claim.ownerKey ||
+            source.currency !== claim.currency)
+            throw new Error("Payout source allocation identity changed.");
+        const reservedAmount = add(source.reservedAmount, transition === "return" ? 0 : -allocation.amount);
+        const paidAmount = add(source.paidAmount, transition === "pay"
+            ? allocation.amount
+            : transition === "return"
+                ? -allocation.amount
+                : 0);
+        if (reservedAmount < 0 || paidAmount < 0)
+            throw new Error("Payout source allocation underflow.");
+        await ctx.db.patch("payoutSourceAllocations", source._id, {
+            reservedAmount,
+            paidAmount,
+        });
+    }
+}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/payoutRelease/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,GAAG,GAAG,iBAAiB,CAAC;AACrC,MAAM,UAAU,mBAAmB,CAAC,CAAqC;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,cAAc,IAAI,CAAC;QACrB,CAAC,CAAC,qBAAqB,IAAI,CAAC;QAC5B,CAAC,CAAC,aAAa,IAAI,KAAK;KACzB,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,IAIhC;IACC,aAAa,CAAC,IAAI,CAAC,CAAC;IACpB,IACE,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;QACzB,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG;QAC9B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QAEhC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACtD,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAgB,EAChB,IAAmE;IAEnE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,KAAK,CAAC,qBAAqB,CAAC;SAC5B,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;SACzE,MAAM,EAAE,CAAC;IACZ,IACE,KAAK;QACL,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;QAExE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAgB,EAChB,IAAuE;IAEvE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3C,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC5C,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC,gBAAgB;QAC1C,MAAM,CAAC,IAAI,KAAK,QAAQ;QACxB,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,CAAC,MAAM,CAAC,YAAY;QACpB,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE;QAEjC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgB,EAChB,SAAiB,EACjB,YAAyC,EACzC,KAAc;IAEd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACtB,KAAK,CAAC,WAAW,CAAC;SAClB,SAAS,CAAC,2BAA2B,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5C,CAAC,CAAC,EAAE,CAAC,sBAAsB,EAAE,SAAS,CAAC,CACxC;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,IACE,IAAI,CAAC,MAAM,GAAG,GAAG;QACjB,YAAY,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QACnC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM;QAEzE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,EAAE;SAC3B,KAAK,CAAC,yBAAyB,CAAC;SAChC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;SAC5D,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,IACE,SAAS,CAAC,MAAM,GAAG,GAAG;QACtB,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAE9D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACzC,IACE,CAAC,GAAG;YACJ,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,iBAAiB;YAChD,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;YACpD,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC;YAE5D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,IACE,KAAK;YACL,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;gBAClC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE;gBACzB,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAEpC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,IACE,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM;YACxB,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,IAAI;YAC9B,IAAI,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,cAAc,CAAC,MAAM;YAC1D,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAExE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;YAClC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAgB,EAAE,gBAAwB;IACzE,OAAO,GAAG,CAAC,EAAE;SACV,KAAK,CAAC,yBAAyB,CAAC;SAChC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;SAC3E,MAAM,EAAE,CAAC;AACd,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAgB,EAChB,KAAiC,EACjC,UAAwC;IAExC,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAClE,IACE,CAAC,MAAM;YACP,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;YACpC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAClC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAElC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,GAAG,CACxB,MAAM,CAAC,cAAc,EACrB,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CACjD,CAAC;QACF,MAAM,UAAU,GAAG,GAAG,CACpB,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,KAAK;YAClB,CAAC,CAAC,UAAU,CAAC,MAAM;YACnB,CAAC,CAAC,UAAU,KAAK,QAAQ;gBACvB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM;gBACpB,CAAC,CAAC,CAAC,CACR,CAAC;QACF,IAAI,cAAc,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG,EAAE;YACxD,cAAc;YACd,UAAU;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,218 @@
+/** Trusted server package boundary only: provider observations are verified upstream. Not a Stripe executor. */
+export declare const claim: import("convex/server").RegisteredMutation<"public", {
+    accountId: string;
+    currency: string;
+    expectedRevision: number;
+    independentLiabilities: number;
+    observations: {
+        currency: string;
+        ledgerFingerprint: string;
+        matureNet: number;
+        observedAt: number;
+        pendingCredits: number;
+        stripeTransferId: string;
+        transactionIds: string[];
+    }[];
+    operationKey: string;
+    ownerKey: string;
+    providerAvailable: number;
+}, 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;
+} | {
+    status: "held";
+    reason: "pending_claim";
+    amount: 0;
+    currency: string;
+    providerMinimum: null;
+} | ({
+    currency: string;
+    matureUnpaid: number;
+    pendingCredits: number;
+    providerMinimum: null;
+} & {
+    status: "held";
+    reason: "below_threshold" | "insufficient_available";
+    amount: 0;
+})>>;
+export declare const beginAttempt: import("convex/server").RegisteredMutation<"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;
+}>>;
+export declare const cancelUnattempted: import("convex/server").RegisteredMutation<"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;
+}>>;
+export declare const recordOutcome: import("convex/server").RegisteredMutation<"public", {
+    accountId: string;
+    amount: number;
+    currency: string;
+    operationKey: string;
+    ownerKey: string;
+    providerStatus: "canceled" | "failed" | "in_transit" | "paid" | "pending";
+    returnTransactionId?: string | undefined;
+    stripePayoutId: 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;
+}>>;
+/** Only a verified, no-object rejection within the original idempotency window. */
+export declare const recordRejection: import("convex/server").RegisteredMutation<"public", {
+    accountId: string;
+    code: "amount_too_small" | "balance_insufficient";
+    operationKey: string;
+    ownerKey: string;
+    requestId: 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;
+}>>;
+//# sourceMappingURL=mutations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/payoutRelease/mutations.ts"],"names":[],"mappings":"AA0BA,gHAAgH;AAChH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCF,MAAM;YACN,eAAe;YACf,CAAC;;;;;;;;;;;;IAgEf,CAAC;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAevB,CAAC;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkB5B,CAAC;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FxB,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkD1B,CAAC"}