@fantastic.dev/better-stripe 0.23.0 → 0.23.1

package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payoutAdoptionTestHelpers.d.ts","sourceRoot":"","sources":["../../../src/client/connect/payoutAdoptionTestHelpers.ts"],"names":[],"mappings":"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"}

package/dist/client/connect/payoutAdoptionTestHelpers.js

@@ -0,0 +1,231 @@
+// @vitest-environment edge-runtime
+import { convexTest } from "convex-test";
+import { makeFunctionReference } from "convex/server";
+import { vi } from "vitest";
+import schema from "../../component/schema.js";
+import { releaseRecipientPayout } from "./payoutExecution.js";
+import { adoptRecipientPayouts } from "./payoutAdoption.js";
+const modules = import.meta.glob("../../component/**/*.*s");
+const symbol = Symbol.for("toReferencePath");
+export const component = {
+    payoutPolicy: {
+        queries: { get: { [symbol]: "betterStripe/payoutPolicy/queries/get" } },
+    },
+};
+export const scope = {
+    accountId: "acct_recipient",
+    ownerKey: "owner",
+    operationKey: "release-1",
+    currency: "usd",
+    independentLiabilities: 0,
+};
+export async function setup(amounts = [600, 400], currency = "usd") {
+    const t = convexTest(schema, modules);
+    await t.run(async (ctx) => {
+        await ctx.db.insert("payoutPolicies", {
+            accountId: scope.accountId,
+            ownerKey: scope.ownerKey,
+            mode: "stripe_managed",
+            status: "ready",
+            revision: 0,
+            operationKey: "enable",
+            country: "US",
+            thresholds: [],
+            holdDeadline: Date.now() + 86400000,
+        });
+        for (let i = 0; i < amounts.length; i++)
+            await ctx.db.insert("transfers", {
+                stripeTransferId: `tr_${i}`,
+                destinationAccountId: scope.accountId,
+                sourceChargeId: `ch_${i}`,
+                amount: amounts[i],
+                currency,
+                status: "paid",
+                role: i % 2 ? "affiliate" : "store",
+            });
+    });
+    const path = (ref) => ref[symbol].replace("betterStripe/", "").replace(/\/(\w+)$/, ":$1");
+    const ctx = {
+        runQuery: (ref, args) => t.query(makeFunctionReference(path(ref)), args),
+        runMutation: (ref, args) => t.mutation(makeFunctionReference(path(ref)), args),
+    };
+    let transactions = amounts.map((amount, i) => ({
+        id: `txn_${i}`,
+        source: `py_${i}`,
+        amount,
+        fee: 0,
+        net: amount,
+        currency,
+        created: 100,
+        available_on: 200,
+        status: "available",
+        type: "payment",
+        exchange_rate: null,
+    }));
+    let payout;
+    const history = [];
+    const provider = {
+        accounts: {
+            listExternalAccounts: vi.fn(async () => ({
+                data: [
+                    {
+                        id: "ba_one",
+                        object: "bank_account",
+                        currency,
+                        default_for_currency: true,
+                    },
+                ],
+                has_more: false,
+            })),
+        },
+        transfers: {
+            retrieve: vi.fn(async (id) => {
+                const i = Number(id.slice(3));
+                return {
+                    id,
+                    destination: scope.accountId,
+                    destination_payment: `py_${i}`,
+                    source_transaction: `ch_${i}`,
+                    amount: amounts[i],
+                    currency,
+                    amount_reversed: 0,
+                };
+            }),
+            listReversals: vi.fn(async () => ({ data: [], has_more: false })),
+        },
+        charges: {
+            retrieve: vi.fn(async (id) => {
+                const i = Number(id.slice(3));
+                return {
+                    id,
+                    source_transfer: `tr_${i}`,
+                    amount: amounts[i],
+                    currency,
+                    paid: true,
+                    status: "succeeded",
+                    balance_transaction: `txn_${i}`,
+                };
+            }),
+        },
+        balanceTransactions: {
+            list: vi.fn(async (params) => ({
+                data: params.source
+                    ? transactions.filter((t) => t.source === params.source)
+                    : transactions.slice(0, params.limit),
+                has_more: false,
+            })),
+            retrieve: vi.fn(async (id) => transactions.find((t) => t.id === id)),
+        },
+        balance: {
+            retrieve: vi.fn(async () => ({
+                available: [
+                    {
+                        currency,
+                        amount: transactions
+                            .filter((t) => t.status === "available")
+                            .reduce((a, t) => a + t.net, 0),
+                        source_types: {
+                            card: transactions
+                                .filter((t) => t.status === "available")
+                                .reduce((a, t) => a + t.net, 0),
+                        },
+                    },
+                ],
+                pending: [],
+            })),
+        },
+        payouts: {
+            list: vi.fn(async () => ({
+                data: [...history].reverse(),
+                has_more: false,
+            })),
+            retrieve: vi.fn(async (id) => id ? history.find((p) => p.id === id) : payout),
+            create: vi.fn(async (params) => {
+                const id = history.length ? `po_${history.length + 1}` : "po_one";
+                const debitId = history.length
+                    ? `txn_debit_${history.length + 1}`
+                    : "txn_debit";
+                payout = {
+                    id,
+                    ...params,
+                    status: "paid",
+                    automatic: false,
+                    method: "standard",
+                    type: "bank_account",
+                    source_type: "card",
+                    destination: "ba_one",
+                    created: Math.floor(Date.now() / 1000),
+                    arrival_date: Math.floor(Date.now() / 1000),
+                    balance_transaction: debitId,
+                    failure_balance_transaction: null,
+                    reversed_by: null,
+                };
+                transactions = [
+                    {
+                        id: debitId,
+                        source: id,
+                        amount: -params.amount,
+                        fee: 0,
+                        net: -params.amount,
+                        currency,
+                        created: Math.floor(Date.now() / 1000),
+                        available_on: Math.floor(Date.now() / 1000),
+                        status: "available",
+                        type: "payout",
+                        exchange_rate: null,
+                    },
+                    ...transactions,
+                ];
+                history.push(payout);
+                return payout;
+            }),
+        },
+    };
+    const verify = vi.fn(async () => ({
+        status: "verified",
+        policy: (await t.run((ctx) => ctx.db.query("payoutPolicies").first())),
+    }));
+    const run = (extra = {}) => releaseRecipientPayout(provider, component, ctx, { ...scope, currency, ...extra }, verify);
+    return {
+        t,
+        ctx,
+        provider,
+        verify,
+        run,
+        setTransactions: (rows) => {
+            transactions = rows;
+        },
+        transactions: () => transactions,
+    };
+}
+export async function historical(currency = "usd") {
+    const amounts = [600, 400];
+    const s = await setup(amounts, currency);
+    await s.provider.payouts.create({
+        amount: 1000,
+        currency,
+        metadata: {},
+    });
+    s.provider.payouts.create.mockClear();
+    const opts = {
+        accountId: scope.accountId,
+        ownerKey: scope.ownerKey,
+        currency,
+        expectedRevision: 0,
+        payouts: [
+            {
+                stripePayoutId: "po_one",
+                allocations: [
+                    { stripeTransferId: "tr_0", amount: 600 },
+                    { stripeTransferId: "tr_1", amount: 400 },
+                ],
+            },
+        ],
+    };
+    const adopt = (extra = {}) => adoptRecipientPayouts(s.provider, component, s.ctx, {
+        ...opts,
+        ...extra,
+    });
+    return { ...s, adopt, opts, amounts };
+}
+//# sourceMappingURL=payoutAdoptionTestHelpers.js.map

package/dist/client/connect/payoutAdoptionTestHelpers.js.map

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

package/docs/settlement.md

@@ -459,6 +459,12 @@ the currency. Existing package claims supply their immutable allocations on
 subsequent calls; use `payouts: []` to verify/reconcile already imported history.
 The same flow supports explicit accounting for automatic historical payouts.
 
+For a verified bank return, holding-age proof retains the original paid
+principal and adds the returned credit at its availability time. The returned
+claim contributes no currently paid source allocation. Net provider fees still
+reduce the combined unpaid balance. Replaying adoption preserves the same claim;
+a later release can include returned cash and new funding exactly once.
+
 The package retrieves actual recipient funding and payout receipts, verifies
 full history against live available/pending cash, and validates each allocation
 against source maturity at the historical payout date. Future credits and

package/package.json

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

package/src/client/connect/payoutAdoption.test.ts

@@ -1,247 +1,12 @@
 // @vitest-environment edge-runtime
-import { convexTest } from "convex-test";
-import { makeFunctionReference } from "convex/server";
 import { expect, it, vi } from "vitest";
 import type Stripe from "stripe";
-import schema from "../../component/schema.js";
-import type { Component, RunCtx } from "../helpers.js";
-import { releaseRecipientPayout } from "./payoutExecution.js";
-import { adoptRecipientPayouts } from "./payoutAdoption.js";
-const modules = import.meta.glob("../../component/**/*.*s");
-const symbol = Symbol.for("toReferencePath");
-const component = {
-  payoutPolicy: {
-    queries: { get: { [symbol]: "betterStripe/payoutPolicy/queries/get" } },
-  },
-} as unknown as Component;
-const scope = {
-  accountId: "acct_recipient",
-  ownerKey: "owner",
-  operationKey: "release-1",
-  currency: "usd",
-  independentLiabilities: 0,
-};
-async function setup(amounts = [600, 400]) {
-  const t = convexTest(schema, modules);
-  await t.run(async (ctx) => {
-    await ctx.db.insert("payoutPolicies", {
-      accountId: scope.accountId,
-      ownerKey: scope.ownerKey,
-      mode: "stripe_managed",
-      status: "ready",
-      revision: 0,
-      operationKey: "enable",
-      country: "US",
-      thresholds: [],
-      holdDeadline: Date.now() + 86400000,
-    });
-    for (let i = 0; i < amounts.length; i++)
-      await ctx.db.insert("transfers", {
-        stripeTransferId: `tr_${i}`,
-        destinationAccountId: scope.accountId,
-        sourceChargeId: `ch_${i}`,
-        amount: amounts[i],
-        currency: "usd",
-        status: "paid",
-        role: i % 2 ? "affiliate" : "store",
-      });
-  });
-  const path = (ref: Record<symbol, string>) =>
-    ref[symbol].replace("betterStripe/", "").replace(/\/(\w+)$/, ":$1");
-  const ctx = {
-    runQuery: (ref: Record<symbol, string>, args: never) =>
-      t.query(makeFunctionReference<"query">(path(ref)), args),
-    runMutation: (ref: Record<symbol, string>, args: never) =>
-      t.mutation(makeFunctionReference<"mutation">(path(ref)), args),
-  } as unknown as RunCtx;
-  let transactions = amounts.map((amount, i) => ({
-    id: `txn_${i}`,
-    source: `py_${i}`,
-    amount,
-    fee: 0,
-    net: amount,
-    currency: "usd",
-    created: 100,
-    available_on: 200,
-    status: "available",
-    type: "payment",
-    exchange_rate: null,
-  }));
-  let payout: Record<string, unknown> | undefined;
-  const provider = {
-    accounts: {
-      listExternalAccounts: vi.fn(async () => ({
-        data: [
-          {
-            id: "ba_one",
-            object: "bank_account",
-            currency: "usd",
-            default_for_currency: true,
-          },
-        ],
-        has_more: false,
-      })),
-    },
-    transfers: {
-      retrieve: vi.fn(async (id: string) => {
-        const i = Number(id.slice(3));
-        return {
-          id,
-          destination: scope.accountId,
-          destination_payment: `py_${i}`,
-          source_transaction: `ch_${i}`,
-          amount: amounts[i],
-          currency: "usd",
-          amount_reversed: 0,
-        };
-      }),
-      listReversals: vi.fn(async () => ({ data: [], has_more: false })),
-    },
-    charges: {
-      retrieve: vi.fn(async (id: string) => {
-        const i = Number(id.slice(3));
-        return {
-          id,
-          source_transfer: `tr_${i}`,
-          amount: amounts[i],
-          currency: "usd",
-          paid: true,
-          status: "succeeded",
-          balance_transaction: `txn_${i}`,
-        };
-      }),
-    },
-    balanceTransactions: {
-      list: vi.fn(async (params: { source?: string; limit?: number }) => ({
-        data: params.source
-          ? transactions.filter((t) => t.source === params.source)
-          : transactions.slice(0, params.limit),
-        has_more: false,
-      })),
-      retrieve: vi.fn(async (id: string) =>
-        transactions.find((t) => t.id === id),
-      ),
-    },
-    balance: {
-      retrieve: vi.fn(async () => ({
-        available: [
-          {
-            currency: "usd",
-            amount: transactions
-              .filter((t) => t.status === "available")
-              .reduce((a, t) => a + t.net, 0),
-            source_types: {
-              card: transactions
-                .filter((t) => t.status === "available")
-                .reduce((a, t) => a + t.net, 0),
-            },
-          },
-        ],
-        pending: [],
-      })),
-    },
-    payouts: {
-      list: vi.fn(async () => ({
-        data: payout ? [payout] : [],
-        has_more: false,
-      })),
-      retrieve: vi.fn(async () => payout),
-      create: vi.fn(
-        async (params: {
-          amount: number;
-          currency: string;
-          metadata: object;
-        }) => {
-          payout = {
-            id: "po_one",
-            ...params,
-            status: "paid",
-            automatic: false,
-            method: "standard",
-            type: "bank_account",
-            source_type: "card",
-            destination: "ba_one",
-            created: Math.floor(Date.now() / 1000),
-            arrival_date: Math.floor(Date.now() / 1000),
-            balance_transaction: "txn_debit",
-            failure_balance_transaction: null,
-            reversed_by: null,
-          };
-          transactions = [
-            {
-              id: "txn_debit",
-              source: "po_one",
-              amount: -params.amount,
-              fee: 0,
-              net: -params.amount,
-              currency: "usd",
-              created: Math.floor(Date.now() / 1000),
-              available_on: Math.floor(Date.now() / 1000),
-              status: "available",
-              type: "payout",
-              exchange_rate: null,
-            },
-            ...transactions,
-          ];
-          return payout;
-        },
-      ),
-    },
-  };
-  const verify = vi.fn(async () => ({
-    status: "verified" as const,
-    policy: (await t.run((ctx) => ctx.db.query("payoutPolicies").first()))!,
-  }));
-  const run = (extra = {}) =>
-    releaseRecipientPayout(
-      provider as unknown as Stripe,
-      component,
-      ctx,
-      { ...scope, ...extra },
-      verify,
-    );
-  return {
-    t,
-    ctx,
-    provider,
-    verify,
-    run,
-    setTransactions: (rows: typeof transactions) => {
-      transactions = rows;
-    },
-    transactions: () => transactions,
-  };
-}
-async function historical() {
-  const s = await setup();
-  await s.provider.payouts.create({
-    amount: 1000,
-    currency: "usd",
-    metadata: {},
-  });
-  s.provider.payouts.create.mockClear();
-  const opts = {
-    accountId: scope.accountId,
-    ownerKey: scope.ownerKey,
-    currency: "usd",
-    expectedRevision: 0,
-    payouts: [
-      {
-        stripePayoutId: "po_one",
-        allocations: [
-          { stripeTransferId: "tr_0", amount: 600 },
-          { stripeTransferId: "tr_1", amount: 400 },
-        ],
-      },
-    ],
-  };
-  const adopt = (extra = {}) =>
-    adoptRecipientPayouts(s.provider as unknown as Stripe, component, s.ctx, {
-      ...opts,
-      ...extra,
-    });
-  return { ...s, adopt, opts };
-}
+import {
+  component,
+  scope,
+  setup,
+  historical,
+} from "./payoutAdoptionTestHelpers.js";
 it("imports a verified historical manual payout with exact source allocations", async () => {
   const s = await historical();
   expect(await s.adopt()).toMatchObject({

package/src/client/connect/payoutAdoption.ts

@@ -303,8 +303,9 @@ export async function adoptRecipientPayouts(
     )) as { claims: Claim[] };
     claims.push(...result.claims);
   }
-  const paid = claims
-    .filter((c) => c.status === "paid")
+  // Returned cash gets a fresh holding age after consuming its original principal.
+  const originalPaid = claims
+    .filter((c) => c.status === "paid" || c.status === "returned")
     .flatMap((c) => c.allocations);
   const fees = claims.reduce((total, c) => add(total, c.providerFee ?? 0), 0);
   const returned = proofPayouts
@@ -315,7 +316,7 @@ export async function adoptRecipientPayouts(
   const oldestHeldAt = oldestUnpaidFunding(
     opts.currency,
     sources,
-    paid,
+    originalPaid,
     fees,
     returned,
   );