@solvapay/react 1.3.0 → 1.4.0-preview-ecd61384a4e849717e13d47ab2daa086cdcd91c5

package/dist/mcp/index.cjs

@@ -597,6 +597,29 @@ var import_react7 = require("react");
 // src/SolvaPayProvider.tsx
 var import_react6 = require("react");
 
+// ../server/src/index.ts
+var import_node_crypto = __toESM(require("crypto"), 1);
+var import_core = require("@solvapay/core");
+
+// ../server/src/helpers/balance-poll.ts
+var BALANCE_RECONCILE_DELAYS_MS = [500, 1e3, 2e3, 4e3, 8e3, 16e3];
+async function pollBalanceUntilIncreased(getBalance, baseline, delays = BALANCE_RECONCILE_DELAYS_MS) {
+  for (const delay of delays) {
+    await new Promise((resolve) => setTimeout(resolve, delay));
+    try {
+      const post = await getBalance();
+      if (post.credits > baseline) {
+        return { creditsAdded: post.credits - baseline };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+
+// src/helpers/auto-recharge-cache.ts
+var BALANCE_RECONCILE_GRACE_MS = BALANCE_RECONCILE_DELAYS_MS.reduce((sum, delay) => sum + delay, 0) + 1e3;
+
 // src/utils/purchases.ts
 function filterPurchases(purchases) {
   return purchases.filter((purchase) => purchase.status === "active");
@@ -754,6 +777,7 @@ var DEFAULT_ROUTES = {
   getProduct: "/api/get-product",
   listPlans: "/api/list-plans",
   getPaymentMethod: "/api/payment-method",
+  autoRecharge: "/api/auto-recharge",
   getUsage: "/api/usage",
   getLimits: "/api/limits"
 };
@@ -791,7 +815,11 @@ function createHttpTransport(config) {
     }),
     createTopupPayment: (params) => request(config, routeFor(config, "createTopupPayment"), {
       method: "POST",
-      body: { amount: params.amount, currency: params.currency },
+      body: {
+        amount: params.amount,
+        currency: params.currency,
+        ...params.autoRecharge ? { autoRecharge: params.autoRecharge } : {}
+      },
       onErrorContext: "createTopupPayment",
       errorPrefix: "Failed to create topup payment"
     }),
@@ -840,16 +868,12 @@ function createHttpTransport(config) {
         }
       );
     },
-    createCustomerSession: () => request(
-      config,
-      routeFor(config, "createCustomerSession"),
-      {
-        method: "POST",
-        body: {},
-        onErrorContext: "createCustomerSession",
-        errorPrefix: "Failed to create customer session"
-      }
-    ),
+    createCustomerSession: () => request(config, routeFor(config, "createCustomerSession"), {
+      method: "POST",
+      body: {},
+      onErrorContext: "createCustomerSession",
+      errorPrefix: "Failed to create customer session"
+    }),
     getMerchant: () => request(config, routeFor(config, "getMerchant"), {
       method: "GET",
       onErrorContext: "getMerchant",
@@ -879,6 +903,22 @@ function createHttpTransport(config) {
       onErrorContext: "getPaymentMethod",
       errorPrefix: "Failed to load payment method"
     }),
+    getAutoRecharge: () => request(config, routeFor(config, "autoRecharge"), {
+      method: "GET",
+      onErrorContext: "getAutoRecharge",
+      errorPrefix: "Failed to load auto-recharge"
+    }),
+    saveAutoRecharge: (input) => request(config, routeFor(config, "autoRecharge"), {
+      method: "PUT",
+      body: input,
+      onErrorContext: "saveAutoRecharge",
+      errorPrefix: "Failed to save auto-recharge"
+    }),
+    disableAutoRecharge: () => request(config, routeFor(config, "autoRecharge"), {
+      method: "DELETE",
+      onErrorContext: "disableAutoRecharge",
+      errorPrefix: "Failed to disable auto-recharge"
+    }),
     getUsage: () => request(config, routeFor(config, "getUsage"), {
       method: "GET",
       onErrorContext: "getUsage",
@@ -1017,6 +1057,42 @@ var enCopy = {
     creditEstimateExact: "= {credits} credits",
     creditEstimateApprox: "~ {credits} credits"
   },
+  autoRecharge: {
+    heading: "Auto recharge",
+    description: "Automatically top up so you never run out \u2014 recommended for production. You can turn this off anytime.",
+    settingsHeading: "Auto recharge settings",
+    setupTriggerLabel: "Set up auto-recharge",
+    modifyTriggerLabel: "Modify",
+    notConfiguredHint: "Automatic top-ups are off. Set up auto-recharge if you want credits added when your balance runs low.",
+    enableLabel: "Enable auto-recharge",
+    enableQuestion: "Would you like to set up automatic recharge?",
+    enableSentence: "Yes, automatically recharge my card when my credit balance falls below a threshold",
+    thresholdLabel: "When balance falls below",
+    thresholdAriaLabel: "Balance threshold",
+    fixedAmountLabel: "Add this amount",
+    fixedAmountAriaLabel: "Fixed top-up amount",
+    saveButton: "Save settings",
+    cancelButton: "Cancel",
+    disableButton: "Disable automatic top-up",
+    savedMessage: "Automatic top-up settings saved.",
+    disabledMessage: "Automatic top-ups disabled.",
+    setupRequiredMessage: "Confirm your card to activate automatic top-ups.",
+    setupHeading: "Authorize card",
+    setupDescription: "Authorize a card for automatic top-ups. You will not be charged now.",
+    setupSubmit: "Save card for auto-recharge",
+    setupProcessing: "Authorizing...",
+    setupAwaitingConfirmation: "Card authorized. Finishing activation \u2014 this can take a moment.",
+    setupAuthFailed: "Card authentication failed. Please try a different card.",
+    invalidThreshold: "Enter a valid balance threshold.",
+    thresholdTooLow: "Balance threshold must be greater than zero.",
+    minTopupAmount: "Top-up amount must be at least {amount}.",
+    topupBelowThreshold: "Top-up amount must be at least your balance threshold ({amount}).",
+    creditsPerRecharge: "\u2248 {credits} credits per recharge",
+    creditsPerRechargeApprox: "~ {credits} credits per recharge",
+    currencyPerRecharge: "\u2248 {amount} per recharge",
+    currencyPerRechargeApprox: "~ {amount} per recharge",
+    statusFailed: "Payment failed \u2014 update your card to resume"
+  },
   activationFlow: {
     heading: "Confirm your plan",
     activateButton: "Activate",
@@ -1244,12 +1320,18 @@ var SolvaPayProvider = ({ config, children }) => {
   const [displayExchangeRateValue, setDisplayExchangeRateValue] = (0, import_react6.useState)(
     initial?.balance?.displayExchangeRate ?? null
   );
+  const [displayBlockValue, setDisplayBlockValue] = (0, import_react6.useState)(
+    initial?.balance?.display ?? null
+  );
   const [balanceLoading, setBalanceLoading] = (0, import_react6.useState)(false);
   const balanceInFlightRef = (0, import_react6.useRef)(false);
   const balanceLoadedRef = (0, import_react6.useRef)(!!initial?.balance);
+  const creditsValueRef = (0, import_react6.useRef)(initial?.balance?.credits ?? null);
   const optimisticUntilRef = (0, import_react6.useRef)(0);
   const optimisticTimerRef = (0, import_react6.useRef)(null);
   const fetchBalanceRef = (0, import_react6.useRef)(null);
+  const reconcileRunningRef = (0, import_react6.useRef)(false);
+  const reconcilePollRef = (0, import_react6.useRef)(null);
   const inFlightRef = (0, import_react6.useRef)(null);
   const loadedCacheKeysRef = (0, import_react6.useRef)(
     new Set(initial?.customerRef ? [initial.customerRef] : [])
@@ -1267,10 +1349,12 @@ var SolvaPayProvider = ({ config, children }) => {
   const fetchBalanceImpl = (0, import_react6.useCallback)(async () => {
     if (optimisticUntilRef.current > Date.now()) return;
     if (!isAuthenticated && !internalCustomerRef) {
+      creditsValueRef.current = null;
       setCreditsValue(null);
       setDisplayCurrencyValue(null);
       setCreditsPerMinorUnitValue(null);
       setDisplayExchangeRateValue(null);
+      setDisplayBlockValue(null);
       setBalanceLoading(false);
       balanceLoadedRef.current = false;
       return;
@@ -1287,10 +1371,12 @@ var SolvaPayProvider = ({ config, children }) => {
         return;
       }
       const data = await transportRef.current.getBalance();
+      creditsValueRef.current = data.credits ?? null;
       setCreditsValue(data.credits ?? null);
       setDisplayCurrencyValue(data.displayCurrency ?? null);
       setCreditsPerMinorUnitValue(data.creditsPerMinorUnit ?? null);
       setDisplayExchangeRateValue(data.displayExchangeRate ?? null);
+      setDisplayBlockValue(data.display ?? null);
       balanceLoadedRef.current = true;
     } catch (error) {
       console.error("[SolvaPayProvider] Failed to fetch balance:", error);
@@ -1305,18 +1391,112 @@ var SolvaPayProvider = ({ config, children }) => {
   (0, import_react6.useEffect)(() => {
     return () => {
       if (optimisticTimerRef.current) clearTimeout(optimisticTimerRef.current);
+      reconcilePollRef.current = null;
+      reconcileRunningRef.current = false;
     };
   }, []);
   const OPTIMISTIC_GRACE_MS = 8e3;
-  const adjustBalanceImpl = (0, import_react6.useCallback)((credits) => {
-    setCreditsValue((prev) => (prev ?? 0) + credits);
-    optimisticUntilRef.current = Date.now() + OPTIMISTIC_GRACE_MS;
+  const DEBIT_GRACE_MS = 2e3;
+  const clearOptimisticGrace = (0, import_react6.useCallback)(() => {
+    optimisticUntilRef.current = 0;
+    if (optimisticTimerRef.current) {
+      clearTimeout(optimisticTimerRef.current);
+      optimisticTimerRef.current = null;
+    }
+  }, []);
+  const applyBalanceSnapshot = (0, import_react6.useCallback)(
+    (data) => {
+      creditsValueRef.current = data.credits ?? null;
+      setCreditsValue(data.credits ?? null);
+      setDisplayCurrencyValue(data.displayCurrency ?? null);
+      setCreditsPerMinorUnitValue(data.creditsPerMinorUnit ?? null);
+      setDisplayExchangeRateValue(data.displayExchangeRate ?? null);
+      setDisplayBlockValue(data.display ?? null);
+      balanceLoadedRef.current = true;
+    },
+    []
+  );
+  const reconcileBalanceIncreaseImpl = (0, import_react6.useCallback)(async () => {
+    if (!transportRef.current.getBalance) return;
+    const finishReconcilePoll = () => {
+      reconcilePollRef.current = null;
+      clearOptimisticGrace();
+    };
+    reconcileRunningRef.current = true;
+    try {
+      while (reconcilePollRef.current) {
+        const { baseline: activeBaseline, generation: activeGeneration } = reconcilePollRef.current;
+        const pollResult = await pollBalanceUntilIncreased(
+          async () => {
+            const data = await transportRef.current.getBalance();
+            return { credits: data.credits ?? 0 };
+          },
+          activeBaseline,
+          BALANCE_RECONCILE_DELAYS_MS
+        );
+        const pollState = reconcilePollRef.current;
+        if (!pollState || pollState.generation !== activeGeneration) {
+          continue;
+        }
+        if (!pollResult) {
+          finishReconcilePoll();
+          break;
+        }
+        try {
+          const data = await transportRef.current.getBalance();
+          applyBalanceSnapshot(data);
+          pollState.pending -= 1;
+          if (pollState.pending > 0) {
+            pollState.baseline = data.credits ?? 0;
+            continue;
+          }
+        } catch (error) {
+          console.error("[SolvaPayProvider] Failed to reconcile balance after auto-recharge:", error);
+        }
+        finishReconcilePoll();
+        break;
+      }
+    } finally {
+      reconcileRunningRef.current = false;
+    }
+  }, [applyBalanceSnapshot, clearOptimisticGrace]);
+  const scheduleGraceRefetch = (0, import_react6.useCallback)((graceMs) => {
+    optimisticUntilRef.current = Date.now() + graceMs;
     if (optimisticTimerRef.current) clearTimeout(optimisticTimerRef.current);
     optimisticTimerRef.current = setTimeout(() => {
       optimisticUntilRef.current = 0;
       fetchBalanceRef.current?.();
-    }, OPTIMISTIC_GRACE_MS);
+    }, graceMs);
   }, []);
+  const adjustBalanceImpl = (0, import_react6.useCallback)(
+    (credits) => {
+      const nextCredits = (creditsValueRef.current ?? 0) + credits;
+      creditsValueRef.current = nextCredits;
+      setCreditsValue(nextCredits);
+      if (credits >= 0) {
+        scheduleGraceRefetch(OPTIMISTIC_GRACE_MS);
+      } else {
+        scheduleGraceRefetch(DEBIT_GRACE_MS);
+      }
+    },
+    [scheduleGraceRefetch]
+  );
+  const reconcileAfterUsageDebitImpl = (0, import_react6.useCallback)(
+    (opts) => {
+      if (opts?.expectIncrease !== true) {
+        return;
+      }
+      const nextCredits = creditsValueRef.current ?? 0;
+      const generation = (reconcilePollRef.current?.generation ?? 0) + 1;
+      const pending = (reconcilePollRef.current?.pending ?? 0) + 1;
+      reconcilePollRef.current = { baseline: nextCredits, generation, pending };
+      scheduleGraceRefetch(BALANCE_RECONCILE_GRACE_MS);
+      if (!reconcileRunningRef.current) {
+        void reconcileBalanceIncreaseImpl();
+      }
+    },
+    [reconcileBalanceIncreaseImpl, scheduleGraceRefetch]
+  );
   const createPayment = (0, import_react6.useCallback)(
     (params) => transportRef.current.createPayment(params),
     []
@@ -1488,6 +1668,7 @@ var SolvaPayProvider = ({ config, children }) => {
     setDisplayCurrencyValue(next.balance?.displayCurrency ?? null);
     setCreditsPerMinorUnitValue(next.balance?.creditsPerMinorUnit ?? null);
     setDisplayExchangeRateValue(next.balance?.displayExchangeRate ?? null);
+    setDisplayBlockValue(next.balance?.display ?? null);
     balanceLoadedRef.current = !!next.balance;
   }, []);
   (0, import_react6.useEffect)(() => {
@@ -1592,8 +1773,10 @@ var SolvaPayProvider = ({ config, children }) => {
       displayCurrency: displayCurrencyValue,
       creditsPerMinorUnit: creditsPerMinorUnitValue,
       displayExchangeRate: displayExchangeRateValue,
+      display: displayBlockValue,
       refetch: fetchBalanceImpl,
-      adjustBalance: adjustBalanceImpl
+      adjustBalance: adjustBalanceImpl,
+      reconcileAfterUsageDebit: reconcileAfterUsageDebitImpl
     }),
     [
       balanceLoading,
@@ -1601,8 +1784,10 @@ var SolvaPayProvider = ({ config, children }) => {
       displayCurrencyValue,
       creditsPerMinorUnitValue,
       displayExchangeRateValue,
+      displayBlockValue,
       fetchBalanceImpl,
-      adjustBalanceImpl
+      adjustBalanceImpl,
+      reconcileAfterUsageDebitImpl
     ]
   );
   const contextValue = (0, import_react6.useMemo)(
@@ -2460,7 +2645,7 @@ function interpolate(template, vars) {
 
 // src/utils/errors.ts
 var DOCS_BASE_URL = "https://solvapay.com/docs";
-var SolvaPayError = class extends Error {
+var SolvaPayError2 = class extends Error {
   code;
   docsUrl;
   constructor(code, message, docsUrl) {
@@ -2470,7 +2655,7 @@ var SolvaPayError = class extends Error {
     this.docsUrl = docsUrl;
   }
 };
-var MissingProviderError = class extends SolvaPayError {
+var MissingProviderError = class extends SolvaPayError2 {
   constructor(primitiveName) {
     const docsUrl = `${DOCS_BASE_URL}/troubleshooting/missing-provider`;
     super(
@@ -2481,7 +2666,7 @@ var MissingProviderError = class extends SolvaPayError {
     this.name = "MissingProviderError";
   }
 };
-var MissingProductRefError = class extends SolvaPayError {
+var MissingProductRefError = class extends SolvaPayError2 {
   constructor(primitiveName) {
     const docsUrl = `${DOCS_BASE_URL}/primitives/product-ref`;
     super(
@@ -2679,7 +2864,7 @@ var CancelledPlanNotice2 = ({
 
 // src/primitives/BalanceBadge.tsx
 var import_react17 = require("react");
-var import_core = require("@solvapay/core");
+var import_core2 = require("@solvapay/core");
 
 // src/hooks/useBalance.ts
 var import_react16 = require("react");
@@ -2720,14 +2905,14 @@ var BalanceBadge = (0, import_react17.forwardRef)(function BalanceBadge2({ asChi
   const formattedCredits = new Intl.NumberFormat(locale).format(credits);
   let currencyEquivalent = "";
   if (!numberOnly && displayCurrency && creditsPerMinorUnit) {
-    const displayMinor = (0, import_core.creditsToDisplayMinorUnits)({
+    const displayMinor = (0, import_core2.creditsToDisplayMinorUnits)({
       credits,
       creditsPerMinorUnit,
       displayExchangeRate: displayExchangeRate ?? 1,
       displayCurrency
     });
     if (displayMinor !== null) {
-      const minorPerMajor = (0, import_core.minorUnitsPerMajor)(displayCurrency);
+      const minorPerMajor = (0, import_core2.minorUnitsPerMajor)(displayCurrency);
       const formatted = new Intl.NumberFormat(locale, {
         style: "currency",
         currency: displayCurrency,
@@ -3540,7 +3725,7 @@ var CurrentPlanCard = ({
 };
 
 // src/mcp/views/detail-cards.tsx
-var import_core2 = require("@solvapay/core");
+var import_core3 = require("@solvapay/core");
 
 // src/hooks/useCustomer.ts
 function useCustomer() {
@@ -3629,7 +3814,7 @@ function McpCustomerDetailsCard({
   }
   const displayName = name?.trim() || "Customer";
   const showBalance = !hideBalance && typeof credits === "number" && credits > 0;
-  const displayMinor = showBalance && typeof creditsPerMinorUnit === "number" && creditsPerMinorUnit > 0 && displayCurrency ? (0, import_core2.creditsToDisplayMinorUnits)({
+  const displayMinor = showBalance && typeof creditsPerMinorUnit === "number" && creditsPerMinorUnit > 0 && displayCurrency ? (0, import_core3.creditsToDisplayMinorUnits)({
     credits: credits ?? 0,
     creditsPerMinorUnit,
     displayExchangeRate: displayExchangeRate ?? 1,
@@ -5326,7 +5511,7 @@ function getStripeCacheKey(publishableKey, accountId) {
   return accountId ? `${publishableKey}:${accountId}` : publishableKey;
 }
 function useTopup(options) {
-  const { amount, currency } = options;
+  const { amount, currency, autoRecharge } = options;
   const { createTopupPayment, customerRef, updateCustomerRef } = useSolvaPay();
   const [loading, setLoading] = (0, import_react35.useState)(false);
   const [error, setError] = (0, import_react35.useState)(null);
@@ -5345,7 +5530,7 @@ function useTopup(options) {
     setLoading(true);
     setError(null);
     try {
-      const result = await createTopupPayment({ amount, currency });
+      const result = await createTopupPayment({ amount, currency, autoRecharge });
       if (!result || typeof result !== "object") {
         throw new Error("Invalid topup payment intent response from server");
       }
@@ -5377,7 +5562,7 @@ function useTopup(options) {
       setLoading(false);
       isStartingRef.current = false;
     }
-  }, [amount, currency, createTopupPayment, customerRef, updateCustomerRef, loading]);
+  }, [amount, currency, autoRecharge, createTopupPayment, customerRef, updateCustomerRef, loading]);
   const reset = (0, import_react35.useCallback)(() => {
     isStartingRef.current = false;
     setLoading(false);
@@ -5449,6 +5634,7 @@ var Root5 = (0, import_react36.forwardRef)(function TopupFormRoot(props, forward
   const {
     amount,
     currency,
+    autoRecharge,
     onSuccess,
     onError,
     returnUrl,
@@ -5472,7 +5658,8 @@ var Root5 = (0, import_react36.forwardRef)(function TopupFormRoot(props, forward
     stripePromise
   } = useTopup({
     amount,
-    currency
+    currency,
+    autoRecharge
   });
   const hasInitializedRef = (0, import_react36.useRef)(false);
   const hasAmount = amount > 0;

package/dist/mcp/index.d.cts

@@ -1,4 +1,4 @@
-import { s as SolvaPayTransport, X as SolvaPayProviderInitial, w as SolvaPayConfig, x as BootstrapPlanLike, E as Merchant } from '../shared-BNZAIWkU.cjs';
+import { v as SolvaPayTransport, _ as SolvaPayProviderInitial, z as SolvaPayConfig, D as BootstrapPlanLike, H as Merchant } from '../shared-LcjvX4fD.cjs';
 import { TOOL_FOR_VIEW, SolvaPayMcpViewKind, BootstrapMerchant, BootstrapProduct, BootstrapPlan, BootstrapCustomer } from '@solvapay/mcp-core';
 export { MCP_TOOL_NAMES, McpToolName } from '@solvapay/mcp-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/mcp/index.d.ts

@@ -1,4 +1,4 @@
-import { s as SolvaPayTransport, X as SolvaPayProviderInitial, w as SolvaPayConfig, x as BootstrapPlanLike, E as Merchant } from '../shared-lIhc8DS3.js';
+import { v as SolvaPayTransport, _ as SolvaPayProviderInitial, z as SolvaPayConfig, D as BootstrapPlanLike, H as Merchant } from '../shared-D8raw1Nv.js';
 import { TOOL_FOR_VIEW, SolvaPayMcpViewKind, BootstrapMerchant, BootstrapProduct, BootstrapPlan, BootstrapCustomer } from '@solvapay/mcp-core';
 export { MCP_TOOL_NAMES, McpToolName } from '@solvapay/mcp-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/mcp/index.js

@@ -3,7 +3,7 @@ import {
   ExternalLinkGlyph,
   LaunchCustomerPortalButton,
   paymentMethodCache
-} from "../chunk-4ISNB3JU.js";
+} from "../chunk-SUHDOG7Q.js";
 import {
   AmountPicker,
   BalanceBadge,
@@ -38,8 +38,9 @@ import {
   usePurchase,
   usePurchaseStatus,
   useTransport
-} from "../chunk-DW5FJUUG.js";
+} from "../chunk-6RR4J74H.js";
 import "../chunk-UMXOAUW7.js";
+import "../chunk-MLKGABMK.js";
 
 // src/mcp/adapter.ts
 import { MCP_TOOL_NAMES } from "@solvapay/mcp-core";