@fantastic.dev/better-stripe 0.16.0 → 0.17.1

package/dist/component/earnings/triggers.js.map

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

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

@@ -0,0 +1,28 @@
+/** Host-authorized scopes are conjunctive; use the package React pagination binding. */
+export declare const paginateRefunds: import("convex/server").RegisteredQuery<"public", {
+    accountId?: string | undefined;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+    status?: "canceled" | "failed" | "pending" | "requires_action" | "succeeded" | undefined;
+    stripePaymentIntentId?: string | undefined;
+}, Promise<import("convex/server").PaginationResult<{
+    _creationTime: number;
+    _id: import("convex/values").GenericId<"refunds">;
+    accountId?: string | undefined;
+    amount: number;
+    currency: string;
+    failureReason?: string | undefined;
+    metadata?: any;
+    reason?: "duplicate" | "expired_uncaptured_charge" | "fraudulent" | "requested_by_customer" | undefined;
+    status: "canceled" | "failed" | "pending" | "requires_action" | "succeeded";
+    stripeChargeId?: string | undefined;
+    stripePaymentIntentId?: string | undefined;
+    stripeRefundId: string;
+}>>>;
+//# sourceMappingURL=queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/refundHistory/queries.ts"],"names":[],"mappings":"AAeA,wFAAwF;AACxF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;IA0B1B,CAAC"}

package/dist/component/refundHistory/queries.js

@@ -0,0 +1,59 @@
+import { paginationOptsValidator, paginationResultValidator, } from "convex/server";
+import { v } from "convex/values";
+import { paginator } from "convex-helpers/server/pagination";
+import { query } from "../_generated/server.js";
+import schema from "../schema.js";
+import { refundDocValidator, refundStatusValidator, } from "../connect/validators.js";
+/** Host-authorized scopes are conjunctive; use the package React pagination binding. */
+export const paginateRefunds = query({
+    args: {
+        accountId: v.optional(v.string()),
+        stripePaymentIntentId: v.optional(v.string()),
+        status: v.optional(refundStatusValidator),
+        paginationOpts: paginationOptsValidator,
+    },
+    returns: paginationResultValidator(refundDocValidator),
+    handler: (ctx, args) => {
+        const { paginationOpts } = args;
+        if (!Number.isSafeInteger(paginationOpts.numItems) ||
+            paginationOpts.numItems < 1 ||
+            paginationOpts.numItems > 100)
+            throw new Error("Refund history page size must be an integer from 1 to 100");
+        return scopedRefunds(ctx, args)
+            .order("desc")
+            .paginate({
+            ...paginationOpts,
+            maximumRowsRead: 200,
+            maximumBytesRead: 1_000_000,
+        });
+    },
+});
+function scopedRefunds(ctx, args) {
+    const { accountId, stripePaymentIntentId, status } = args;
+    const refunds = paginator(ctx.db, schema).query("refunds");
+    if (accountId !== undefined &&
+        stripePaymentIntentId !== undefined &&
+        status === undefined)
+        return refunds.withIndex("by_account_id_and_stripe_payment_intent_id", (q) => q
+            .eq("accountId", accountId)
+            .eq("stripePaymentIntentId", stripePaymentIntentId));
+    if (accountId !== undefined &&
+        stripePaymentIntentId !== undefined &&
+        status !== undefined)
+        return refunds.withIndex("by_account_id_and_stripe_payment_intent_id_and_status", (q) => q
+            .eq("accountId", accountId)
+            .eq("stripePaymentIntentId", stripePaymentIntentId)
+            .eq("status", status));
+    if (accountId !== undefined && status !== undefined)
+        return refunds.withIndex("by_account_id_and_status", (q) => q.eq("accountId", accountId).eq("status", status));
+    if (stripePaymentIntentId !== undefined && status !== undefined)
+        return refunds.withIndex("by_payment_intent_id_and_status", (q) => q.eq("stripePaymentIntentId", stripePaymentIntentId).eq("status", status));
+    if (accountId !== undefined)
+        return refunds.withIndex("by_account_id", (q) => q.eq("accountId", accountId));
+    if (stripePaymentIntentId !== undefined)
+        return refunds.withIndex("by_stripe_payment_intent_id", (q) => q.eq("stripePaymentIntentId", stripePaymentIntentId));
+    if (status !== undefined)
+        return refunds.withIndex("by_status", (q) => q.eq("status", status));
+    return refunds;
+}
+//# sourceMappingURL=queries.js.map

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

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

package/dist/component/schema.d.ts

@@ -674,6 +674,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
     }, "required", "accountId" | "amount" | "currency" | "failureReason" | "metadata" | "reason" | "status" | "stripeChargeId" | "stripePaymentIntentId" | "stripeRefundId" | `metadata.${string}`>, {
         by_account_id: ["accountId", "_creationTime"];
         by_account_id_and_status: ["accountId", "status", "_creationTime"];
+        by_account_id_and_stripe_payment_intent_id: ["accountId", "stripePaymentIntentId", "_creationTime"];
+        by_account_id_and_stripe_payment_intent_id_and_status: ["accountId", "stripePaymentIntentId", "status", "_creationTime"];
         by_payment_intent_id_and_status: ["stripePaymentIntentId", "status", "_creationTime"];
         by_status: ["status", "_creationTime"];
         by_stripe_payment_intent_id: ["stripePaymentIntentId", "_creationTime"];

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

@@ -8,6 +8,7 @@ export type CostRecoveryRow = {
     amountDue: number;
     collectedAmount: number;
     invoicedAmount: number;
+    reservedAmount?: number;
     outstanding: number;
     currency: string;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"Costs.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Costs.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,wBAAgB,YAAY,CAAC,KAAK,EAAE,uBAAuB,CAAC,eAAe,CAAC,+BA0B3E;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC;CAC/C,CAAC;AACF,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,SAAS,CAAC;CAC9D,+BA2DA"}
+{"version":3,"file":"Costs.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Costs.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,wBAAgB,YAAY,CAAC,KAAK,EAAE,uBAAuB,CAAC,eAAe,CAAC,+BA+B3E;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC;CAC/C,CAAC;AACF,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,SAAS,CAAC;CAC9D,+BA2DA"}

package/dist/react/workflows/Costs.js

@@ -3,18 +3,22 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { Collection } from "./Collection.js";
 import { formatPrice } from "../lib/price-helpers.js";
 export function CostRecovery(props) {
+    const reserved = props.rows?.some((row) => row.reservedAmount !== undefined);
     const columns = [
         { id: "payment", label: "Payment", cell: (row) => row.paymentIntentId },
         ...[
             ["amountDue", "Total cost"],
-            ["collectedAmount", "Deducted from earnings"],
-            ["invoicedAmount", "Added to invoice"],
+            ["collectedAmount", reserved ? "Collected" : "Deducted from earnings"],
+            [
+                reserved ? "reservedAmount" : "invoicedAmount",
+                reserved ? "Reserved" : "Added to invoice",
+            ],
             ["outstanding", "Outstanding"],
         ].map(([field, label]) => ({
             id: field,
             label,
             align: "end",
-            cell: (row) => formatPrice(row[field], row.currency),
+            cell: (row) => formatPrice(row[field] ?? row.invoicedAmount, row.currency),
         })),
     ];
     return (_jsx(Collection, { emptyLabel: "No costs yet.", loadingLabel: "Loading costs\u2026", ...props, columns: props.columns ?? columns, getKey: (row) => row._id ?? row.id ?? row.paymentIntentId }));

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

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

package/docs/react-workflows.md

@@ -391,6 +391,40 @@ Preview grouping performs no reads, writes or provider operations and cannot pro
 bank delivery or complete-account earnings. Authorize and bound the source read in
 the host; keep authoritative full-account aggregates separate.
 
+### Complete refund history (added after 0.16.0)
+
+`BetterStripe.paginateRefunds(ctx, opts)` reads authoritative synchronized component
+refund records. `RefundPageOptions` is exported from the main package entrypoint.
+Pass `paginationOpts: { numItems, cursor }` with an integer page size from 1 to 100
+and `null` for the initial cursor. The result has `page`, `isDone` and
+`continueCursor`; feed the returned cursor into the next request until `isDone`.
+Each request performs one bounded helper-compatible component paginate operation
+in newest-first order. Bind the authorized host query with the package React
+`useComponentPaginatedQuery`, matching the catalog and payout readers. Pinned
+ranges may grow beyond the requested page size; reads cap at 200 rows or 1 MB
+and return split hints for the hook. Existing `listRefunds` retains its
+capped-array compatibility.
+
+The host must authenticate the session and derive an authorized account/payment
+scope before exposing this method through its reactive query. Optional
+`stripeAccountId`, `stripePaymentIntentId` and `status` filters all apply together;
+a mismatched account/payment pair returns no records. Do not expose an unscoped
+reader to ordinary sellers, trust browser-supplied account IDs or treat this
+component API as an authentication boundary.
+
+Render returned records with `RefundHistory` or its render prop, retaining their
+original amount, currency, status and charge/payment identifiers. Dojo supplies
+translated Shadcn presentation and its application audit context. Loaded pages
+and the existing 25-row Vite preview are incomplete until pagination finishes;
+neither is a monetary aggregate. Grouped preview amounts remain explicitly
+bounded, and authoritative monetary totals require currency-isolated aggregate
+APIs. This reader performs no Stripe request, refund or ledger write.
+
+This method is absent from public 0.16.0. Source acceptance does not publish it.
+Host applications must wait for a separately verified published artifact and
+package adoption before importing it; source merges alone do not satisfy that
+consumer gate.
+
 ## Store-plan pricing editor
 
 `PlanPricingEditor` accepts a `plan` with `id`, `name`, `monthlyAmount` in minor
@@ -526,9 +560,11 @@ checking that the response still belongs to the mounted scope. `useOnboarding`
 uses this lifecycle for both create and continue navigation, including its
 `window.location.assign` fallback. An old response cannot navigate after unmount
 or scope replacement. Current requests preserve shared pending locks and errors.
-These APIs ship in the release containing the dispute-upload and stale-navigation
-implementation PR. Version 0.13.0 does not contain them. Consumers must upgrade
-to that release before removing their navigation guard or using the upload API.
+`uploadDisputeEvidence`, `EvidenceUpload` and the onboarding navigation fix shipped
+in [0.14.0](https://github.com/FantasticDevHQ/better-stripe/releases/tag/v0.14.0).
+Version 0.13.0 does not contain them. Consumers must upgrade to
+`@fantastic.dev/better-stripe@0.14.0` or later before using the upload API or relying
+on the package's navigation guard.
 Production storage, session authorization, styling, translations and extended
 hosted onboarding verification remain application responsibilities.
 

package/docs/read-contracts.md

@@ -94,6 +94,19 @@ earnings ledger does not determine settlement availability.
 
 ### Existing installations
 
+Summary amounts, counts and derived net amounts must remain safe integers in the
+public Number representation. Checked integer intermediates reject fractional,
+non-finite or unsupported inputs/results before rounding. A rejected transfer,
+payout, reversal or backfill page rolls back its source changes, markers and
+summary updates together. Stored unsafe summary fields also fail closed on reads.
+
+These guards prevent new precision loss; they do not repair summaries rounded by
+an earlier release. An affected historical summary needs reconciliation against
+its original records before reuse, even if a later rounded value appears safe.
+The ordinary backfill below skips already-marked records and cannot repair that
+case. Do not treat a successful backfill or a current safe-looking Number as
+proof that previously unsupported arithmetic was exact.
+
 After deploying the optional marker fields and summary table, invoke
 `components.betterStripe.earnings.mutations.backfillCurrencyTotals` from a trusted
 server migration. Run separately for `kind: "earnings"` and `kind: "payouts"`,

package/package.json

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

package/src/client/connect/refunds.ts

@@ -1,4 +1,5 @@
 import type Stripe from "stripe";
+import type { PaginationOptions, PaginationResult } from "convex/server";
 
 import type { RefundStatus } from "../../component/connect/validators.js";
 import { throwStripeError } from "../errors.js";
@@ -12,6 +13,33 @@ import { type RefundActor, isRefundAuthorized } from "./refundActor.js";
 
 export type { RefundActor } from "./refundActor.js";
 
+export type RefundListOptions = {
+  stripeAccountId?: string;
+  stripePaymentIntentId?: string;
+  status?: RefundStatus;
+  limit?: number;
+};
+
+export type RefundPageOptions = Omit<RefundListOptions, "limit"> & {
+  paginationOpts: PaginationOptions;
+};
+
+/** The host must authenticate/authorize scopes before exposing this reactive reader. */
+export async function paginateRefunds(
+  component: Component,
+  ctx: RunCtx,
+  opts: RefundPageOptions,
+): Promise<PaginationResult<StripeComponentRefund>> {
+  const { stripeAccountId, ...rest } = opts;
+  return await ctx.runQuery(
+    componentRef(component, "refundHistory/queries/paginateRefunds"),
+    {
+      ...rest,
+      ...(stripeAccountId !== undefined ? { accountId: stripeAccountId } : {}),
+    },
+  );
+}
+
 // =============================================================================
 // Refund methods
 // =============================================================================

package/src/client/index.ts

@@ -79,7 +79,6 @@ import type { ComponentApi } from "../component/_generated/component.js";
 import type {
   DisputeStatus,
   PayoutStatus,
-  RefundStatus,
 } from "../component/connect/validators.js";
 import type { SplitRecipient } from "../component/lib/fees.js";
 import * as checkoutImpl from "./billing/checkout.js";
@@ -89,6 +88,7 @@ import * as disputesImpl from "./connect/disputes.js";
 import * as paymentMethodsImpl from "./connect/paymentMethods.js";
 import * as payoutsImpl from "./connect/payouts.js";
 import * as refundsImpl from "./connect/refunds.js";
+export type { RefundPageOptions } from "./connect/refunds.js";
 import * as transfersImpl from "./connect/transfers.js";
 import * as accountLinksImpl from "./core/accountLinks.js";
 import * as accountsImpl from "./core/accounts.js";
@@ -1360,16 +1360,15 @@ export class BetterStripe extends ReadContractClient {
 
   async listRefunds(
     ctx: RunCtx,
-    opts?: {
-      stripeAccountId?: string;
-      stripePaymentIntentId?: string;
-      status?: RefundStatus;
-      limit?: number;
-    },
+    opts?: refundsImpl.RefundListOptions,
   ): Promise<StripeComponentRefund[]> {
     return refundsImpl.listRefunds(this.component, ctx, opts);
   }
 
+  paginateRefunds(ctx: RunCtx, opts: refundsImpl.RefundPageOptions) {
+    return refundsImpl.paginateRefunds(this.component, ctx, opts);
+  }
+
   // DISPUTE METHODS
 
   async getDisputeByStripeId(

package/src/client/refund-history.test.ts

@@ -0,0 +1,67 @@
+import { componentsGeneric, type FunctionReference } from "convex/server";
+import { expect, it } from "vitest";
+
+import schema from "../component/schema.js";
+import type { Component, RunCtx } from "./helpers.js";
+import { BetterStripe, type RefundPageOptions } from "./index.js";
+import { initConvexTest } from "./setup.test.js";
+
+const modules = import.meta.glob("../component/**/*.{ts,js,tsx,jsx}");
+
+it("reads multiple conjunctively scoped pages through the public client without provider credentials", async () => {
+  const t = initConvexTest();
+  t.registerComponent("betterStripe", schema, modules);
+  const component = componentsGeneric().betterStripe as unknown as Component;
+  const stripe = new BetterStripe(component, {});
+  const ctx = {
+    runQuery: (
+      ref: FunctionReference<"query">,
+      args: Record<string, unknown>,
+    ) => t.query(ref, args),
+  } as unknown as RunCtx;
+  for (let index = 0; index < 5; index++) {
+    await t.mutation(component.connect.mutations.upsertRefund, {
+      stripeRefundId: `re_${index}`,
+      accountId: index === 4 ? "acct_foreign" : "acct_owner",
+      stripePaymentIntentId: index === 3 ? "pi_foreign" : "pi_original",
+      stripeChargeId: "ch_original",
+      amount: 500,
+      currency: "jpy",
+      status: "succeeded",
+    });
+  }
+  const opts: RefundPageOptions = {
+    stripeAccountId: "acct_owner",
+    stripePaymentIntentId: "pi_original",
+    status: "succeeded",
+    paginationOpts: { numItems: 2, cursor: null },
+  };
+  const first = await stripe.paginateRefunds(ctx, opts);
+  expect(first.page).toHaveLength(2);
+  expect(first.isDone).toBe(false);
+  const last = await stripe.paginateRefunds(ctx, {
+    ...opts,
+    paginationOpts: { numItems: 2, cursor: first.continueCursor },
+  });
+  expect(last.isDone).toBe(true);
+  expect([...first.page, ...last.page]).toHaveLength(3);
+  for (const refund of [...first.page, ...last.page]) {
+    expect(refund).toMatchObject({
+      accountId: "acct_owner",
+      stripePaymentIntentId: "pi_original",
+      stripeChargeId: "ch_original",
+      amount: 500,
+      currency: "jpy",
+      status: "succeeded",
+    });
+  }
+  expect(
+    await stripe.paginateRefunds(ctx, {
+      ...opts,
+      stripeAccountId: "acct_absent",
+    }),
+  ).toMatchObject({ page: [], isDone: true });
+  expect(
+    await stripe.listRefunds(ctx, { stripeAccountId: "acct_owner", limit: 1 }),
+  ).toHaveLength(1);
+});

package/src/component/_generated/api.ts

@@ -24,6 +24,7 @@ import type * as costRecovery_imports from "../costRecovery/imports.js";
 import type * as costRecovery_mutations from "../costRecovery/mutations.js";
 import type * as costRecovery_queries from "../costRecovery/queries.js";
 import type * as costRecovery_reservations from "../costRecovery/reservations.js";
+import type * as earnings_arithmetic from "../earnings/arithmetic.js";
 import type * as earnings_legacyReads from "../earnings/legacyReads.js";
 import type * as earnings_mutations from "../earnings/mutations.js";
 import type * as earnings_reads from "../earnings/reads.js";
@@ -36,6 +37,7 @@ import type * as lib_stripeFactory from "../lib/stripeFactory.js";
 import type * as products_mutations from "../products/mutations.js";
 import type * as products_queries from "../products/queries.js";
 import type * as products_validators from "../products/validators.js";
+import type * as refundHistory_queries from "../refundHistory/queries.js";
 import type * as settlement_mutations from "../settlement/mutations.js";
 import type * as settlement_queries from "../settlement/queries.js";
 import type * as webhooks_mutations from "../webhooks/mutations.js";
@@ -66,6 +68,7 @@ const fullApi: ApiFromModules<{
   "costRecovery/mutations": typeof costRecovery_mutations;
   "costRecovery/queries": typeof costRecovery_queries;
   "costRecovery/reservations": typeof costRecovery_reservations;
+  "earnings/arithmetic": typeof earnings_arithmetic;
   "earnings/legacyReads": typeof earnings_legacyReads;
   "earnings/mutations": typeof earnings_mutations;
   "earnings/reads": typeof earnings_reads;
@@ -78,6 +81,7 @@ const fullApi: ApiFromModules<{
   "products/mutations": typeof products_mutations;
   "products/queries": typeof products_queries;
   "products/validators": typeof products_validators;
+  "refundHistory/queries": typeof refundHistory_queries;
   "settlement/mutations": typeof settlement_mutations;
   "settlement/queries": typeof settlement_queries;
   "webhooks/mutations": typeof webhooks_mutations;

package/src/component/_generated/component.ts

@@ -2436,6 +2436,62 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         >;
       };
     };
+    refundHistory: {
+      queries: {
+        paginateRefunds: FunctionReference<
+          "query",
+          "internal",
+          {
+            accountId?: string;
+            paginationOpts: {
+              cursor: string | null;
+              endCursor?: string | null;
+              id?: number;
+              maximumBytesRead?: number;
+              maximumRowsRead?: number;
+              numItems: number;
+            };
+            status?:
+              | "pending"
+              | "requires_action"
+              | "succeeded"
+              | "failed"
+              | "canceled";
+            stripePaymentIntentId?: string;
+          },
+          {
+            continueCursor: string;
+            isDone: boolean;
+            page: Array<{
+              _creationTime: number;
+              _id: string;
+              accountId?: string;
+              amount: number;
+              currency: string;
+              failureReason?: string;
+              metadata?: any;
+              reason?:
+                | "duplicate"
+                | "fraudulent"
+                | "requested_by_customer"
+                | "expired_uncaptured_charge";
+              status:
+                | "pending"
+                | "requires_action"
+                | "succeeded"
+                | "failed"
+                | "canceled";
+              stripeChargeId?: string;
+              stripePaymentIntentId?: string;
+              stripeRefundId: string;
+            }>;
+            pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+            splitCursor?: string | null;
+          },
+          Name
+        >;
+      };
+    };
     settlement: {
       mutations: {
         claimCommissionInvoice: FunctionReference<

package/src/component/connect/queries.ts

@@ -3,6 +3,7 @@ import {
   getAccountPayouts as getAccountPayoutsLegacy,
 } from "../earnings/legacyReads.js";
 import { currencyTotals, previewSize } from "../earnings/reads.js";
+import { addSummaryAmounts } from "../earnings/arithmetic.js";
 import { v } from "convex/values";
 import { paginator } from "convex-helpers/server/pagination";
 import schema from "../schema.js";
@@ -557,7 +558,7 @@ export const getAccountEarningsByCurrency = query({
         currency: r.currency,
         gross: r.gross,
         reversed: r.reversed,
-        net: r.gross - r.reversed,
+        net: addSummaryAmounts(r.gross, -r.reversed),
         transferCount: r.count,
       })),
       transfers,

package/src/component/connect/schema.ts

@@ -54,6 +54,15 @@ export const refundsTable = defineTable(refundFields)
   .index("by_account_id", ["accountId"])
   .index("by_status", ["status"])
   .index("by_account_id_and_status", ["accountId", "status"])
+  .index("by_account_id_and_stripe_payment_intent_id", [
+    "accountId",
+    "stripePaymentIntentId",
+  ])
+  .index("by_account_id_and_stripe_payment_intent_id_and_status", [
+    "accountId",
+    "stripePaymentIntentId",
+    "status",
+  ])
   .index("by_payment_intent_id_and_status", [
     "stripePaymentIntentId",
     "status",

package/src/component/earnings/arithmetic.ts

@@ -0,0 +1,10 @@
+/** Check exact integer arithmetic before converting back to the public Number representation. */
+export function addSummaryAmounts(left: number, right: number): number {
+  if (!Number.isSafeInteger(left) || !Number.isSafeInteger(right))
+    throw new Error("Currency totals require safe integer amounts");
+  const result = BigInt(left) + BigInt(right);
+  const limit = BigInt(Number.MAX_SAFE_INTEGER);
+  if (result > limit || result < -limit)
+    throw new Error("Currency totals exceed supported safe integer bounds");
+  return Number(result);
+}

package/src/component/earnings/reads.ts

@@ -1,4 +1,5 @@
 import type { QueryCtx } from "../_generated/server.js";
+import { addSummaryAmounts } from "./arithmetic.js";
 export function previewSize(value = 50) {
   if (!Number.isInteger(value) || value < 0 || value > 100)
     throw new Error("Preview size must be an integer from 0 to 100");
@@ -37,5 +38,10 @@ export async function currencyTotals(
     .take(501);
   if (rows.length > 500)
     throw new Error("Account exceeds supported currency count");
+  for (const row of rows) {
+    for (const value of [row.gross, row.reversed, row.paidOut, row.count])
+      addSummaryAmounts(value, 0);
+    addSummaryAmounts(row.gross, -row.reversed);
+  }
   return rows;
 }

package/src/component/earnings/triggers.ts

@@ -4,6 +4,7 @@ import {
   customMutation,
 } from "convex-helpers/server/customFunctions";
 import type { DataModel } from "../_generated/dataModel.js";
+import { addSummaryAmounts } from "./arithmetic.js";
 import {
   mutation as rawMutation,
   type MutationCtx,
@@ -21,7 +22,7 @@ async function adjust(
   ctx: MutationCtx,
   kind: "earnings" | "payouts",
   value: Contribution,
-  sign: number,
+  sign: 1 | -1,
 ) {
   const row = await ctx.db
     .query("currencyTotals")
@@ -33,11 +34,12 @@ async function adjust(
     )
     .unique();
   const totals = {
-    gross: (row?.gross ?? 0) + sign * value.gross,
-    reversed: (row?.reversed ?? 0) + sign * value.reversed,
-    paidOut: (row?.paidOut ?? 0) + sign * value.paidOut,
-    count: (row?.count ?? 0) + sign * value.count,
+    gross: addSummaryAmounts(row?.gross ?? 0, sign * value.gross),
+    reversed: addSummaryAmounts(row?.reversed ?? 0, sign * value.reversed),
+    paidOut: addSummaryAmounts(row?.paidOut ?? 0, sign * value.paidOut),
+    count: addSummaryAmounts(row?.count ?? 0, sign * value.count),
   };
+  addSummaryAmounts(totals.gross, -totals.reversed);
   if (row) {
     if (totals.count === 0) await ctx.db.delete("currencyTotals", row._id);
     else await ctx.db.patch("currencyTotals", row._id, totals);
@@ -72,14 +74,17 @@ triggers.register("transfers", async (ctx, change) => {
 triggers.register("payouts", async (ctx, change) => {
   const contribution = (
     row: NonNullable<typeof change.newDoc>,
-  ): Contribution => ({
-    accountId: row.accountId,
-    currency: row.currency,
-    gross: 0,
-    reversed: 0,
-    paidOut: row.status === "paid" ? row.amount : 0,
-    count: 1,
-  });
+  ): Contribution => {
+    const amount = addSummaryAmounts(row.amount, 0);
+    return {
+      accountId: row.accountId,
+      currency: row.currency,
+      gross: 0,
+      reversed: 0,
+      paidOut: row.status === "paid" ? amount : 0,
+      count: 1,
+    };
+  };
   if (change.oldDoc?.totalsRecorded)
     await adjust(ctx, "payouts", contribution(change.oldDoc), -1);
   if (change.newDoc) {