@fantastic.dev/better-stripe 0.7.0 → 0.8.0

package/dist/react/workflows/index.js

@@ -0,0 +1,38 @@
+export { useWorkflowAction } from "./useWorkflowAction.js";
+export { useWorkflowResource } from "./useWorkflowResource.js";
+export { Checkout } from "./Checkout.js";
+export { CheckoutElementsForm, PaymentIntentForm, CheckoutForm, } from "./CheckoutForms.js";
+export { Connect } from "./Connect.js";
+export { Payouts } from "./Payouts.js";
+export { Refunds, useRefunds, parseAmountCents } from "./Refunds.js";
+export { Collection } from "./Collection.js";
+export { Sales, Invoices, RefundHistory, ReferredSales, WebhookEvents, } from "./Collections.js";
+export { Products, useProductManager } from "./Products.js";
+export { Onboarding, useOnboarding } from "./Onboarding.js";
+export { Disputes, useDisputeResponse } from "./Disputes.js";
+export { InvoiceEstimate, useInvoiceEstimate, BalancePaymentSource, useBalanceFunding, BillingPortal, } from "./Billing.js";
+export { SubscriptionManager, useSubscriptionManager, Subscriptions, useSubscriptionFilter, SUBSCRIPTION_FILTERS, } from "./Subscriptions.js";
+export { PaymentMethods, usePaymentMethodsManager, toPaymentMethodItem, } from "./PaymentMethods.js";
+export { ReferralLinks, useReferralLinks } from "./ReferralLinks.js";
+export { IntegrationSwitch } from "./IntegrationSwitch.js";
+export { CHECKOUT_OPTIONS } from "./checkout-options.js";
+export { Account, useAccountManager } from "./Account.js";
+export { WorkflowTasks, StripeSetup, SandboxTesting, useTaskRunner, } from "./Tasks.js";
+export { WebhookSetup, useWebhookSetup, EnvironmentStatus, FixtureProgress, } from "./Setup.js";
+export { BillingPlans, usePlanBilling } from "./BillingPlans.js";
+export { CostRecovery, ChargebackLedger } from "./Costs.js";
+export { Storefront } from "./Storefront.js";
+export { PaymentReceipt } from "./PaymentReceipt.js";
+export { Earnings, earningsFromBalance } from "./Earnings.js";
+export { ClipboardButton } from "./ClipboardButton.js";
+export { useWebhookFilters, webhookQueryArgs } from "./filters.js";
+export { AccountConfigurations } from "./Account.js";
+export { Overview, getPayoutTotals } from "./Overview.js";
+export { currentSubscriptionFrom } from "./current-subscription.js";
+export { CheckoutChooser } from "./CheckoutChooser.js";
+export { SubscriptionOverview } from "./SubscriptionOverview.js";
+export { DEFAULT_CONNECT_COUNTRIES } from "./Onboarding.js";
+export { PayoutHistory } from "./Payouts.js";
+export { PayoutOverview } from "./Overview.js";
+export { ChargeSummary, PaymentDetails } from "./Financials.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AASzC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAUrE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,OAAO,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAU5D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAO7D,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,GACd,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAQ1D,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMjE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAS9D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,11 @@
+export type WorkflowActionState<T, Args extends unknown[]> = {
+    isPending: boolean;
+    error: string | null;
+    result: T | undefined;
+    /** Errors are exposed in state; failed and duplicate calls return undefined. */
+    run: (...args: Args) => Promise<T | undefined>;
+    reset: () => void;
+};
+/** Shared async action lifecycle. Scope identifies the authenticated account/resource, not authorization. */
+export declare function useWorkflowAction<T, Args extends unknown[]>(action: (...args: Args) => Promise<T>, scope?: string): WorkflowActionState<T, Args>;
+//# sourceMappingURL=useWorkflowAction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowAction.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/useWorkflowAction.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,IAAI;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,gFAAgF;IAChF,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AACF,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EACzD,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EACrC,KAAK,GAAE,MAAkB,GACxB,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,CA4D9B"}

package/dist/react/workflows/useWorkflowAction.js

@@ -0,0 +1,68 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+/** Shared async action lifecycle. Scope identifies the authenticated account/resource, not authorization. */
+export function useWorkflowAction(action, scope = "default") {
+    const initial = {
+        scope,
+        isPending: false,
+        error: null,
+        result: undefined,
+    };
+    const [state, setState] = useState(initial);
+    if (state.scope !== scope)
+        setState(initial);
+    const callback = useRef(action);
+    const lifecycle = useRef({ version: 0, mounted: false });
+    const lock = useRef(null);
+    useEffect(() => {
+        callback.current = action;
+    }, [action]);
+    useEffect(() => {
+        const version = ++lifecycle.current.version;
+        lifecycle.current.mounted = true;
+        lock.current = null;
+        return () => {
+            if (lifecycle.current.version === version) {
+                lifecycle.current.mounted = false;
+                lifecycle.current.version++;
+                lock.current = null;
+            }
+        };
+    }, [scope]);
+    const reset = useCallback(() => {
+        if (lock.current !== null)
+            return;
+        setState({ scope, isPending: false, error: null, result: undefined });
+    }, [scope]);
+    const run = useCallback(async (...args) => {
+        if (lock.current !== null)
+            return undefined;
+        const version = lifecycle.current.version;
+        lock.current = version;
+        setState({ scope, isPending: true, error: null, result: undefined });
+        const current = () => lifecycle.current.mounted && lifecycle.current.version === version;
+        try {
+            const result = await callback.current(...args);
+            if (!current())
+                return undefined;
+            setState({ scope, isPending: false, error: null, result });
+            return result;
+        }
+        catch (error) {
+            if (current())
+                setState({
+                    scope,
+                    isPending: false,
+                    error: error instanceof Error ? error.message : String(error),
+                    result: undefined,
+                });
+            return undefined;
+        }
+        finally {
+            if (lock.current === version)
+                lock.current = null;
+        }
+    }, [scope]);
+    return { ...state, run, reset };
+}
+//# sourceMappingURL=useWorkflowAction.js.map

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

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

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

@@ -0,0 +1,9 @@
+/** Loads once per scope/refresh, including under React StrictMode. Stale requests cannot update another scope. */
+export declare function useWorkflowResource<T>(load: () => Promise<T>, scope?: string): {
+    revision: number;
+    data: T | undefined;
+    error: string | null;
+    isLoading: boolean;
+    refresh: () => void;
+};
+//# sourceMappingURL=useWorkflowResource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowResource.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/useWorkflowResource.ts"],"names":[],"mappings":"AAEA,kHAAkH;AAClH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,KAAK,SAAY;;;;;;EAwElB"}

package/dist/react/workflows/useWorkflowResource.js

@@ -0,0 +1,67 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+/** Loads once per scope/refresh, including under React StrictMode. Stale requests cannot update another scope. */
+export function useWorkflowResource(load, scope = "default") {
+    const initial = {
+        scope,
+        attempt: 0,
+        data: undefined,
+        error: null,
+        isLoading: true,
+    };
+    const [state, setState] = useState(initial);
+    if (state.scope !== scope)
+        setState(initial);
+    const loader = useRef(load);
+    const request = useRef(null);
+    useEffect(() => {
+        loader.current = load;
+    }, [load]);
+    useEffect(() => {
+        let active = true;
+        if (!request.current ||
+            request.current.scope !== scope ||
+            request.current.attempt !== state.attempt) {
+            request.current = {
+                scope,
+                attempt: state.attempt,
+                promise: Promise.resolve().then(() => loader.current()),
+            };
+        }
+        void request.current.promise
+            .then((data) => {
+            if (active)
+                setState((previous) => ({
+                    ...previous,
+                    data,
+                    error: null,
+                    isLoading: false,
+                }));
+        })
+            .catch((error) => {
+            if (active)
+                setState((previous) => ({
+                    ...previous,
+                    error: error instanceof Error ? error.message : String(error),
+                    isLoading: false,
+                }));
+        });
+        return () => {
+            active = false;
+        };
+    }, [scope, state.attempt]);
+    const refresh = useCallback(() => setState((previous) => ({
+        ...previous,
+        attempt: previous.attempt + 1,
+        isLoading: true,
+        error: null,
+    })), []);
+    return {
+        revision: state.attempt,
+        data: state.data,
+        error: state.error,
+        isLoading: state.isLoading,
+        refresh,
+    };
+}
+//# sourceMappingURL=useWorkflowResource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowResource.js","sourceRoot":"","sources":["../../../src/react/workflows/useWorkflowResource.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,kHAAkH;AAClH,MAAM,UAAU,mBAAmB,CACjC,IAAsB,EACtB,KAAK,GAAG,SAAS;IAEjB,MAAM,OAAO,GAAG;QACd,KAAK;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,SAA0B;QAChC,KAAK,EAAE,IAAqB;QAC5B,SAAS,EAAE,IAAI;KAChB,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;QAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,CAIZ,IAAI,CAAC,CAAC;IAChB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACX,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IACE,CAAC,OAAO,CAAC,OAAO;YAChB,OAAO,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK;YAC/B,OAAO,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EACzC,CAAC;YACD,OAAO,CAAC,OAAO,GAAG;gBAChB,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;aACxD,CAAC;QACJ,CAAC;QACD,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO;aACzB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,MAAM;gBACR,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACtB,GAAG,QAAQ;oBACX,IAAI;oBACJ,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC,CAAC;QACR,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,MAAM;gBACR,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACtB,GAAG,QAAQ;oBACX,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC7D,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC,CAAC;QACR,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,WAAW,CACzB,GAAG,EAAE,CACH,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtB,GAAG,QAAQ;QACX,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,CAAC;QAC7B,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,EACL,EAAE,CACH,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,OAAO;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/docs/react-workflows-audit.md

@@ -0,0 +1,66 @@
+# Example UI audit
+
+Every financial/account page has a public React component or workflow hook in
+`@fantastic.dev/better-stripe/react`. Native unstyled components implement the
+shared workflows. The example binds authenticated Convex queries/actions and
+uses render props or companion hooks to apply shadcn styling.
+
+| Example page or adapter                   | Package UI and workflow ownership                                                                                                                      |
+| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Home and stores                           | `Storefront`, including store filtering, active catalog prices, purchase actions, and referral attribution                                             |
+| Checkout chooser                          | `CheckoutChooser`, `CHECKOUT_OPTIONS`, recurring-product compatibility and selection                                                                   |
+| Checkout session / PaymentIntent adapters | `Checkout`, `CheckoutElementsForm`, `PaymentIntentForm`, `CheckoutForm`, `EmbeddedCheckout`, including loading, retry, validation and confirmation     |
+| Checkout status                           | `CheckoutStatus`, `PaymentReceipt`, server/webhook confirmation                                                                                        |
+| Customer overview                         | `SubscriptionOverview`                                                                                                                                 |
+| Customer subscription billing             | `useSubscriptionManager`, `SubscriptionManager`, `BuyerBillingView`, `SubscriptionCard`, `Invoices`, `BillingPortalLink`                               |
+| Customer invoices                         | `Invoices`                                                                                                                                             |
+| Customer payment methods                  | `usePaymentMethodsManager`, `PaymentMethods`, `PaymentMethodsList`, `AddCardForm`, Stripe providers                                                    |
+| Seller overview                           | `PayoutOverview`, `AccountCreateCard`, `ConnectStatusBadge`                                                                                            |
+| Seller and affiliate payouts              | `Payouts`, `PayoutHistory`, live balances, upcoming date, history and pagination                                                                       |
+| Seller earnings                           | `EarningsSummary`, `PayoutSchedule`, `PayoutHistory`, `earningsFromBalance`, `useWorkflowResource`                                                     |
+| Seller sales                              | `Sales`                                                                                                                                                |
+| Seller subscriptions                      | `Subscriptions`, `SubscriptionCard`                                                                                                                    |
+| Seller and admin products                 | `useProductManager`, `Products`, `PriceCard`, product/price creation, editing and archiving                                                            |
+| Seller account details                    | `useAccountManager`, `Account`, `AccountLoginCard`, `ConnectRequirements`                                                                              |
+| Seller onboarding / account setup         | `useOnboarding`, `Onboarding`, `AccountCloseCard`, `DEFAULT_CONNECT_COUNTRIES`                                                                         |
+| Seller marketplace account                | Account/onboarding hooks, `AccountConfigurations`, `ConnectStatusBadge`, `CheckoutStatus`, shared action lifecycle                                     |
+| Seller billing                            | `usePlanBilling`, `BillingPlans`, `EmbeddedCheckout`, `useInvoiceEstimate`, `InvoiceEstimate`, `useBalanceFunding`, `BalancePaymentSource`             |
+| Seller refunds                            | `useRefunds`, `Refunds`, `RefundHistory`, `PaymentDetails`, `CostRecovery`                                                                             |
+| Seller disputes                           | `useDisputeResponse`, `Disputes`, `DisputesList`, `DisputeDetail`, `EvidenceForm`, `ChargebackLedger`, `CostRecovery`                                  |
+| Affiliate earnings                        | `Earnings`, `EarningsSummary`                                                                                                                          |
+| Affiliate referred sales                  | `ReferredSales`, store attribution and commission                                                                                                      |
+| Affiliate links                           | `useReferralLinks`, `ReferralLinks`, `ClipboardButton`                                                                                                 |
+| Admin overview                            | `Overview`                                                                                                                                             |
+| Admin subscriptions                       | `Subscriptions`, `useSubscriptionFilter`                                                                                                               |
+| Admin webhooks                            | `WebhookEvents`, `useWebhookFilters`                                                                                                                   |
+| Admin setup                               | `useWebhookSetup`, `WebhookSetup`, `EnvironmentStatus`, `FixtureProgress`, `useTaskRunner`, `StripeSetup`, `ClipboardButton`, shared actions/resources |
+| Admin sandbox testing                     | `useTaskRunner`, `SandboxTesting`, `WorkflowTasks`                                                                                                     |
+| Legacy affiliate split demo               | `Checkout`, `SplitBreakdown`, `EarningsSummary`, bound package hook factories                                                                          |
+| Legacy destination-charge module          | `Checkout`, `ChargeSummary`; the legacy public route currently resolves to the split demo                                                              |
+| Integration presentation switch           | `IntegrationSwitch`; only the active view mounts                                                                                                       |
+| Connect alternatives                      | `Connect` with account management, onboarding, payments/refunds, disputes, balances, payouts and notifications                                         |
+| Styled shared tables                      | `Collection` and domain collections; `WorkflowTable` only maps their state/columns to shadcn                                                           |
+
+The example owns app branding, navigation, theme controls, the persona/store
+switcher, route guards, URL state, and styling. It also owns its users and
+server bindings, fee plans, referral-share policy, recovery billing rules,
+sandbox scenario definitions, and authorization. These are application choices,
+not prerequisites imposed by the public React package.
+
+Some examples use companion hooks with styled markup instead of mounting the
+native component. That markup changes presentation; the package owns the
+workflow state, validation, duplicate-action handling, and async errors. Reusable
+native components exist for consumers who do not want to write those renderers.
+Connect and hosted Stripe UI remain available only where Stripe supports them.
+
+## Verification
+
+- Public-entry tests render native components without example providers, routing,
+  CSS classes, or inline styling and without calling server actions during render.
+- Interaction tests exercise native product-price creation, partial refunds,
+  balance consent, checkout selection, and other workflow controllers.
+- Account changes and duplicate actions have regression tests.
+- Browser smoke coverage visits all five personas' pages and the integration views.
+- Checkout tests complete referred guest purchases through all five integrations
+  in a Stripe sandbox and verify webhook receipts and settlement.
+- `pnpm run check:all` enforces all repository gates, including Shadscan at 100.

package/docs/react-workflows.md

@@ -0,0 +1,231 @@
+# React workflows
+
+Import the example's reusable UI and workflow hooks from
+`@fantastic.dev/better-stripe/react`. You do not need the example's route tree,
+role provider, Tailwind, or shadcn components.
+
+Components render semantic HTML without package CSS. Use their render props or
+companion hooks to supply your own design system. Stripe iframe contents use
+Stripe's `appearance` options and retain Stripe's own styling.
+
+## Bind your backend
+
+Pass authenticated server callbacks and query results to the components. This
+keeps your user IDs, authorization, database schema, and business rules in your
+application. The example's pages demonstrate Convex adapters for these callbacks.
+A callback is an API contract, not an authorization boundary. The server must
+check account ownership, price IDs, amounts, referral attribution, and permissions.
+
+`scopeKey` identifies the authenticated account or customer. Change it when that
+identity changes so pending responses cannot populate another account's UI.
+For checkout, change `orderKey` when the customer, price, or attribution changes.
+Do not put secret keys in these props. Browser code needs only a publishable key
+and short-lived client secrets returned by your server.
+
+## Choose a checkout
+
+`Checkout` supports all five checkout integrations. It creates the session or
+PaymentIntent, handles loading and retry, mounts the required Stripe provider,
+and reports confirmation errors. Hosted Checkout waits for an explicit click.
+`CheckoutChooser` renders the five choices and their pros and cons. It supports
+controlled selection, render props, and a recurring-product compatibility notice.
+`CHECKOUT_OPTIONS` also exports the descriptions.
+
+```tsx
+import { Checkout } from "@fantastic.dev/better-stripe/react";
+
+// createSession is your authenticated server binding. It must validate priceId.
+function Purchase({ publishableKey, priceId, createSession }) {
+  return (
+    <Checkout
+      mode="custom"
+      publishableKey={publishableKey}
+      orderKey={priceId}
+      returnUrl={`${window.location.origin}/receipt?session_id={CHECKOUT_SESSION_ID}`}
+      createSession={({ mode, requestId }) =>
+        createSession({ priceId, uiMode: mode, requestId })
+      }
+    />
+  );
+}
+```
+
+The callback returns `{ stripeSessionId, clientSecret?, url? }`. It must return
+`url` for `redirect` and `clientSecret` for the other session modes. Use the
+request ID for server idempotency. A user-triggered retry creates a new request
+ID; also enforce application-level duplicate-order protection on the server.
+
+| Mode             | Stripe integration                    | Tradeoff                                                               |
+| ---------------- | ------------------------------------- | ---------------------------------------------------------------------- |
+| `redirect`       | Hosted Checkout Session               | Least UI work, leaves your app                                         |
+| `embedded`       | Embedded Checkout Session             | Complete Stripe checkout in your page, less layout control             |
+| `custom`         | Checkout Session with Payment Element | Custom form layout with Checkout's session model                       |
+| `payment-intent` | PaymentIntent with Payment Element    | Payment control, application owns order and subscription orchestration |
+| `form`           | Preview Embedded Checkout Form        | Compact Stripe form, requires the supported Stripe preview             |
+
+For `payment-intent`, provide `createPaymentIntent({ requestId })` instead of
+`createSession`. Return `{ paymentIntentId, clientSecret }`. Payment Intents do
+not create subscriptions. Stripe.js supplies the browser SDK and publishable-key
+handling for these flows; it is not a separate server payment model.
+
+Use `renderForm` on the custom and PaymentIntent modes to render your own email
+input, `paymentElement`, error, and submit button. The preview `form` mode renders
+Stripe's form and does not use that renderer. `children` replaces the outer
+checkout frame and receives `content`, `isLoading`, `error`, and `retry`.
+The lower-level `CheckoutElementsForm`, `PaymentIntentForm`, and `CheckoutForm`
+are also exported for an existing client secret.
+
+Only a server-confirmed payment or checkout session should grant access to the
+product. Use `PaymentReceipt` or `CheckoutStatus` with webhook-backed query data;
+a browser return URL alone does not prove payment.
+
+## Headless or Stripe embedded
+
+`Account`, `Onboarding`, `Disputes`, `Refunds`, `Earnings`, and `Payouts` accept
+`presentation="embedded"` with Connect session props. Their default headless
+presentation accepts domain-specific data and callbacks. `Connect` also exposes
+account, onboarding, payments, refunds, disputes, balances, payouts, and
+notifications widgets directly.
+
+```tsx
+import { IntegrationSwitch, Payouts } from "@fantastic.dev/better-stripe/react";
+
+function AccountPayouts({
+  accountId,
+  publishableKey,
+  loadPayouts,
+  createSession,
+}) {
+  return (
+    <IntegrationSwitch
+      views={{
+        headless: <Payouts scopeKey={accountId} load={loadPayouts} />,
+        embedded: (
+          <Payouts
+            presentation="embedded"
+            scopeKey={accountId}
+            publishableKey={publishableKey}
+            fetchClientSecret={async () => (await createSession()).clientSecret}
+          />
+        ),
+      }}
+    />
+  );
+}
+```
+
+The server creates an Account Session for the authenticated connected account
+and enables the requested component and features. Session refresh uses the latest callback. Appearance and locale updates apply
+to the active Connect instance without remounting it. Changing the publishable
+key creates a new instance. `IntegrationSwitch` mounts only the active view and has
+no router dependency. It also supports controlled `value`/`onValueChange` and
+`components` and `hosted` views when your workflow has those alternatives.
+
+Connect displays only the payment data supported for that connected account.
+The example's platform-owned separate-charges-and-transfers ledger remains in
+its headless sales/refund/dispute views. A Connect embed cannot turn that ledger
+into connected-account-owned charges. Refunds use the Connect Payments widget;
+there is no separate Connect refund catalog widget. Product management,
+customer subscriptions, and platform billing do not have equivalent Connect
+widgets. Use package UI or the hosted Billing Portal for those workflows.
+
+## Component and hook reference
+
+| Workflow              | Unstyled components                                                                                            | Companion hooks/helpers                                                      |
+| --------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| Store browsing        | `Storefront`, `PriceCard`                                                                                      | Store/product/price models and purchase callbacks                            |
+| Checkout              | `CheckoutChooser`, `Checkout`, `CheckoutElementsForm`, `PaymentIntentForm`, `CheckoutForm`, `EmbeddedCheckout` | `CHECKOUT_OPTIONS`                                                           |
+| Receipts              | `PaymentReceipt`, `CheckoutStatus`                                                                             | Server-backed payment/session data                                           |
+| Earnings              | `Earnings`, `EarningsSummary`                                                                                  | `earningsFromBalance`                                                        |
+| Payouts               | `Payouts`, `PayoutSchedule`, `PayoutHistory`, `PayoutOverview`                                                 | `getPayoutTotals`                                                            |
+| Sales                 | `Sales`, `ReferredSales`                                                                                       | Server-authoritative economic rows                                           |
+| Refunds               | `Refunds`, `RefundHistory`                                                                                     | `useRefunds`, `parseAmountCents`                                             |
+| Disputes              | `Disputes`, `DisputesList`, `DisputeDetail`, `EvidenceForm`, `ChargebackLedger`                                | `useDisputeResponse`                                                         |
+| Onboarding            | `Onboarding`                                                                                                   | `useOnboarding`                                                              |
+| Accounts              | `Account`, `AccountConfigurations`                                                                             | `useAccountManager`                                                          |
+| Product management    | `Products`                                                                                                     | `useProductManager`                                                          |
+| Subscriptions         | `Subscriptions`, `SubscriptionManager`, `SubscriptionOverview`, `SubscriptionCard`                             | `useSubscriptionManager`, `useSubscriptionFilter`, `currentSubscriptionFrom` |
+| Billing               | `BillingPlans`, `BillingPortal`, `InvoiceEstimate`, `Invoices`, `BalancePaymentSource`                         | `usePlanBilling`, `useInvoiceEstimate`, `useBalanceFunding`                  |
+| Payment methods       | `PaymentMethods`, `PaymentMethodsList`, `AddCardForm`                                                          | `usePaymentMethodsManager`, `toPaymentMethodItem`                            |
+| Seller cost recovery  | `CostRecovery`                                                                                                 | Server-calculated outstanding/collected/invoiced amounts                     |
+| Referral sharing      | `ReferralLinks`, `ClipboardButton`                                                                             | `useReferralLinks`                                                           |
+| Admin                 | `Overview`, `WebhookEvents`                                                                                    | `useWebhookFilters`, `webhookQueryArgs`                                      |
+| Sandbox setup/testing | `StripeSetup`, `SandboxTesting`, `WorkflowTasks`, `WebhookSetup`, `EnvironmentStatus`, `FixtureProgress`       | `useTaskRunner`, `useWebhookSetup`                                           |
+| Shared state/tables   | `IntegrationSwitch`, `Collection`                                                                              | `useWorkflowAction`, `useWorkflowResource`                                   |
+
+The example still owns its navigation, persona switcher, application branding,
+server authorization, sandbox fixture definitions, and marketplace fee policy.
+Its styled forms and tables consume package hooks/render props. The package's
+default components implement those workflows without the example's providers.
+The package does not seed or reset a Stripe account just because a component
+mounts. Setup/testing tasks call the operations you explicitly bind.
+
+## Data contracts and styling
+
+`Payouts.load(cursor?)` returns a `PayoutSnapshot` with `balances`, `payouts`,
+`upcoming`, and `nextCursor`. Each balance has `currency`, `available`, and
+`pending`. Payout rows include `id`, `amount`, `currency`, `status`, `arrivalDate`,
+and `created`. The component shows available and pending balances, the next
+known payout and arrival date, upcoming payouts, and paginated previous payouts.
+If Stripe has not provided an upcoming payout, the UI says so rather than
+inventing a date.
+
+Payout, invoice-estimate, cost, and webhook timestamps use Unix milliseconds.
+Subscription period/trial fields use ISO date strings, matching the existing
+subscription API. Convert raw Stripe Unix seconds in your adapter. Money values use integer minor units. The current decimal refund
+input and price-formatting helpers use two decimal places, as in the USD
+example. Supply custom rendering/input conversion for zero-decimal and
+three-decimal currencies. Never combine balances across currencies.
+
+Sale fees, affiliate shares, recovery costs, invoice estimates, and settlement
+statuses come from server data. The UI does not recalculate the example's fee
+policy or charge outstanding costs by itself. Balance funding requires explicit
+consent and a server integration with Stripe's supported preview. Card fallback,
+renewal recovery, and debt collection remain server business rules.
+
+Use exported `*Props`, row models, and render-state types for typed adapters.
+Tables accept optional columns and a `children(state)` renderer. Action hooks
+expose pending, error, and results so your buttons and alerts share the same
+validation and duplicate-submit handling as the native components.
+
+```tsx
+import { Invoices } from "@fantastic.dev/better-stripe/react";
+
+function InvoiceList({ invoices }) {
+  return (
+    <Invoices rows={invoices}>
+      {({ rows, isLoading, isEmpty }) =>
+        isLoading ? (
+          <p>Loading invoices…</p>
+        ) : isEmpty ? (
+          <p>No invoices yet.</p>
+        ) : (
+          <ul>
+            {rows.map((row) => (
+              <li key={row.stripeInvoiceId}>{row.stripeInvoiceId}</li>
+            ))}
+          </ul>
+        )
+      }
+    </Invoices>
+  );
+}
+```
+
+Default markup has `data-better-stripe` attributes for scoped CSS. Use render
+props to replace markup with your design system, including labels and locale
+formatting. A render function replaces the supplied markup; render its `content`
+or `paymentElement` where those are part of the state's contract.
+
+## Example coverage
+
+See [the page audit](react-workflows-audit.md) for the mapping from every example
+page to package components and hooks. `ChargeSummary` displays server-calculated
+charge/fee/payout figures. `PaymentDetails` displays recorded charge and refund
+state. `PayoutOverview` shows payout activity totals, which are separate from the
+available and pending Stripe balances shown by `Payouts`.
+
+`DEFAULT_CONNECT_COUNTRIES` provides the example's eight country choices and is
+shared by its account pages and native `Onboarding`. Supply `countries` to limit
+or expand the UI for your platform. This default is not a complete list of
+Stripe-supported countries; your server must validate account eligibility.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fantastic.dev/better-stripe",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A Convex component for Stripe V2 Accounts API integration.",
   "keywords": [
     "stripe",
@@ -57,6 +57,8 @@
   "files": [
     "dist",
     "src",
+    "docs/react-workflows.md",
+    "docs/react-workflows-audit.md",
     "CHANGELOG.md",
     "MIGRATION.md"
   ],
@@ -83,7 +85,18 @@
     "prepublishOnly": "npm run clean && npm run build && npm run typecheck",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "check:design-system": "eslint --config eslint.design-system.config.mjs . --max-warnings 0",
+    "check:shadscan": "shadscan \"./example\" --json --fail-under 100 --no-roast --no-interactive",
+    "check:all": "repo-gates check-all",
+    "check:size": "repo-gates check-size",
+    "check:debt": "repo-gates check-debt",
+    "check:circular": "repo-gates check-circular",
+    "check:secrets": "repo-gates check-secrets",
+    "check:ci-parity": "repo-gates check-ci-parity",
+    "check:coverage": "repo-gates check-coverage",
+    "format:check": "pnpm run format",
+    "check:agents": "repo-gates check-agents"
   },
   "dependencies": {
     "@stripe/connect-js": "^3.4.6",
@@ -95,6 +108,7 @@
   "devDependencies": {
     "@convex-dev/eslint-plugin": "^5.0.0",
     "@edge-runtime/vm": "^5.0.0",
+    "@fantastic.dev/repo-gates": "^0.4.0",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.7",
@@ -113,7 +127,9 @@
     "pretty-quick": "^4.2.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "typescript-eslint": "^8.71.1",
-    "vitest": "^5.0.3"
+    "vitest": "^5.0.3",
+    "@shadcn/lint": "0.1.5",
+    "@shadscan/cli": "0.7.0"
   },
   "peerDependencies": {
     "convex": "^1.29.3",

package/src/client/billing/checkout-ui-modes.test.ts

@@ -0,0 +1,49 @@
+import { expect, it, vi } from "vitest";
+import type Stripe from "stripe";
+import type { Component, RunCtx } from "../helpers.js";
+import { createCheckoutSession } from "./checkout.js";
+for (const [mode, expected] of [
+  ["custom", "elements"],
+  ["form", "form"],
+] as const)
+  it(`creates ${mode} checkout without hosted URLs`, async () => {
+    const create = vi.fn().mockResolvedValue({
+      id: "cs_test",
+      status: "open",
+      mode: "payment",
+      client_secret: "client_secret_test",
+      metadata: {},
+      expires_at: 1800000000,
+    });
+    const component = {
+      billing: {
+        mutations: {
+          upsertCheckoutSession: {
+            [Symbol.for("toReferencePath")]:
+              "betterStripe/billing/mutations/upsertCheckoutSession",
+          },
+        },
+      },
+    } as unknown as Component;
+    await createCheckoutSession(
+      { checkout: { sessions: { create } } } as unknown as Stripe,
+      component,
+      {
+        runQuery: vi.fn().mockResolvedValue(null),
+        runMutation: vi.fn(),
+      } as unknown as RunCtx,
+      {
+        userId: "user_1",
+        stripePriceId: "price_1",
+        mode: "payment",
+        uiMode: mode,
+        returnUrl: "https://app.test/return",
+      },
+    );
+    expect(create.mock.calls[0][0]).toMatchObject({
+      ui_mode: expected,
+      return_url: "https://app.test/return",
+    });
+    expect(create.mock.calls[0][0].success_url).toBeUndefined();
+    expect(create.mock.calls[0][0].cancel_url).toBeUndefined();
+  });