@solvapay/react 2.0.0 → 2.0.1-preview-fab746232bff615a7302c55ee7293205ac645de4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @solvapay/react changelog
 
+## 2.0.1-preview-fab746232bff615a7302c55ee7293205ac645de4
+
+### Patch Changes
+
+- a47adff: Free plans with an included allowance now count usage and label the meter correctly.
+
+  `@solvapay/core` adds `countsUsage` (per-unit charge, tier, or limit) and `meterName`
+  (per-unit charge's meter, else the first limit's meter). A free tier with a bare
+  limit is not priced per unit, but it still needs a usage counter and a meter noun —
+  `isMetered` on the wire was the wrong question for both.
+
+  `planMeterName` uses the new reader, so a recurring allowance no longer renders the
+  literal "units". `useAutoActivateFreePlan` no longer requires deprecated `freeUnits`
+  on the plan row. Usage surfaces (`useUsage`, `getUsageCore`, plan cards) derive
+  from `options[]` instead of trusting `planSnapshot.isMetered` alone.
+
+- 30f7021: PAYG embedded checkout now activates first, then shows the credit top-up picker only when the wallet is empty.
+
+  A funded wallet skips the amount and payment steps. `ActivationFlow` follows the same contract: API `activated` at zero credits opens the amount picker instead of firing `onSuccess`. Once the customer is on the amount or payment step, a later zero-credit balance refetch no longer rewinds them back to the picker.
+
+- Updated dependencies [a47adff]
+  - @solvapay/core@1.5.0-preview-fab746232bff615a7302c55ee7293205ac645de4
+  - @solvapay/mcp-core@0.3.2-preview-fab746232bff615a7302c55ee7293205ac645de4
+
 ## 2.0.0
 
 ### Major Changes

package/dist/{chunk-D6TOFFNL.js → chunk-BHG7Z5XV.js}

@@ -14,7 +14,7 @@ import {
   usePurchaseStatus,
   useSolvaPay,
   useTransport
-} from "./chunk-6ABOJOEV.js";
+} from "./chunk-GMZU5M6R.js";
 
 // src/components/CancelledPlanNotice.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -362,6 +362,7 @@ var UpdatePaymentMethodButton = forwardRef2(function UpdatePaymentMethodButton2(
 });
 
 // src/components/CurrentPlanCard.tsx
+import { countsUsage } from "@solvapay/core";
 import { jsx as jsx5, jsxs as jsxs4 } from "react/jsx-runtime";
 function PlanTypeLine({
   purchase,
@@ -369,7 +370,7 @@ function PlanTypeLine({
   className
 }) {
   const copy = useCopy();
-  const isMetered = purchase.planSnapshot?.isMetered === true;
+  const isMetered = countsUsage(purchase.planSnapshot) || purchase.planSnapshot?.isMetered === true;
   if (purchase.isRecurring) {
     const date2 = formatDate(purchase.nextBillingDate);
     if (!date2) return null;
@@ -429,7 +430,7 @@ var CurrentPlanCard = ({
   const { formatDate, shouldShowCancelledNotice } = usePurchaseStatus();
   const { paymentMethod } = usePaymentMethod();
   if (!activePurchase) return null;
-  const isUsageBased = activePurchase.planSnapshot?.isMetered === true;
+  const isUsageBased = countsUsage(activePurchase.planSnapshot) || activePurchase.planSnapshot?.isMetered === true;
   const planType = activePurchase.isRecurring ? "recurring" : isUsageBased ? "usage-based" : "one-time";
   const amount = activePurchase.originalAmount ?? activePurchase.amount ?? 0;
   const currency = activePurchase.currency ?? "usd";

package/dist/{chunk-6ABOJOEV.js → chunk-GMZU5M6R.js}

@@ -303,10 +303,10 @@ function createHttpTransport(config) {
       onErrorContext: "getUsage",
       errorPrefix: "Failed to load usage"
     }),
-    getLimits: async ({ productRef, meterName }) => {
+    getLimits: async ({ productRef, meterName: meterName2 }) => {
       const base = routeFor(config, "getLimits");
       const params = new URLSearchParams({ productRef });
-      if (meterName) params.set("meterName", meterName);
+      if (meterName2) params.set("meterName", meterName2);
       const url = `${base}?${params.toString()}`;
       const data = await request(config, url, {
         method: "GET",
@@ -483,7 +483,7 @@ var enCopy = {
     activateButton: "Activate",
     activatingLabel: "Activating...",
     topupHeading: "Add credits",
-    topupSubheading: "Top up your credits to activate this plan.",
+    topupSubheading: "Top up your credits to start using this plan.",
     continueToPayment: "Continue to payment",
     changeAmountButton: "Change amount",
     retryingHeading: "Activating your plan...",
@@ -816,7 +816,7 @@ var SolvaPayProvider = ({ config, children }) => {
     setHasAttachBusinessDetails(!!transportRef.current.attachBusinessDetails);
   }, [config]);
   const fetchBalanceImpl = useCallback(async () => {
-    if (optimisticUntilRef.current > Date.now()) return;
+    if (optimisticUntilRef.current > Date.now()) return creditsValueRef.current;
     if (!isAuthenticated && !internalCustomerRef) {
       creditsValueRef.current = null;
       setCreditsValue(null);
@@ -826,18 +826,16 @@ var SolvaPayProvider = ({ config, children }) => {
       setDisplayBlockValue(null);
       setBalanceLoading(false);
       balanceLoadedRef.current = false;
-      return;
+      return null;
     }
-    if (balanceInFlightRef.current) return;
+    if (balanceInFlightRef.current) return creditsValueRef.current;
     balanceInFlightRef.current = true;
     if (!balanceLoadedRef.current) {
       setBalanceLoading(true);
     }
     try {
       if (!transportRef.current.getBalance) {
-        setBalanceLoading(false);
-        balanceInFlightRef.current = false;
-        return;
+        return creditsValueRef.current;
       }
       const data = await transportRef.current.getBalance();
       creditsValueRef.current = data.credits ?? null;
@@ -847,8 +845,10 @@ var SolvaPayProvider = ({ config, children }) => {
       setDisplayExchangeRateValue(data.displayExchangeRate ?? null);
       setDisplayBlockValue(data.display ?? null);
       balanceLoadedRef.current = true;
+      return creditsValueRef.current;
     } catch (error) {
       console.error("[SolvaPayProvider] Failed to fetch balance:", error);
+      return creditsValueRef.current;
     } finally {
       setBalanceLoading(false);
       balanceInFlightRef.current = false;
@@ -3010,7 +3010,8 @@ function normalizeOneTimePurchase(input) {
     planSnapshot: {
       price: input.amount,
       currency: input.currency,
-      isMetered: false
+      isMetered: false,
+      options: []
     }
   };
 }
@@ -5796,12 +5797,13 @@ function usePurchaseActions() {
 }
 
 // src/primitives/CancelPlanButton.tsx
+import { countsUsage } from "@solvapay/core";
 import { forwardRef as forwardRef10, useCallback as useCallback16, useContext as useContext13 } from "react";
 import { Fragment as Fragment9, jsx as jsx17 } from "react/jsx-runtime";
 function resolveConfirmText(confirm, purchase, defaults) {
   if (confirm === false) return null;
   if (typeof confirm === "string") return confirm;
-  const isUsageBased = purchase?.planSnapshot?.isMetered === true && purchase.isRecurring !== true;
+  const isUsageBased = (countsUsage(purchase?.planSnapshot) || purchase?.planSnapshot?.isMetered === true) && purchase?.isRecurring !== true;
   if (isUsageBased) return defaults.usageBased;
   return defaults.recurring;
 }
@@ -6098,19 +6100,19 @@ import { useCallback as useCallback19, useEffect as useEffect12, useRef as useRe
 var CACHE_TTL_MS = 1e4;
 var OPTIMISTIC_GRACE_MS = 8e3;
 var limitsCache = /* @__PURE__ */ new Map();
-function cacheKey(customerRef, productRef, meterName) {
-  return `${customerRef ?? "anonymous"}:${productRef}:${meterName}`;
+function cacheKey(customerRef, productRef, meterName2) {
+  return `${customerRef ?? "anonymous"}:${productRef}:${meterName2}`;
 }
 function isUnlimited(remaining) {
   return remaining < 0;
 }
 function useLimits(options) {
   const { productRef, meterName: rawMeterName, enabled = true } = options;
-  const meterName = rawMeterName || "requests";
+  const meterName2 = rawMeterName || "requests";
   const transport = useTransport();
   const { customerRef } = useCustomer();
   const { purchase } = useSolvaPay();
-  const currentKey = !productRef || !enabled ? null : cacheKey(customerRef, productRef, meterName);
+  const currentKey = !productRef || !enabled ? null : cacheKey(customerRef, productRef, meterName2);
   const [data, setData] = useState15(() => {
     if (!currentKey) return null;
     const cached = limitsCache.get(currentKey);
@@ -6165,7 +6167,7 @@ function useLimits(options) {
         setLoading(false);
         return;
       }
-      const key = cacheKey(customerRef, productRef, meterName);
+      const key = cacheKey(customerRef, productRef, meterName2);
       const cached = limitsCache.get(key);
       const now = Date.now();
       if (cached?.promise) {
@@ -6178,7 +6180,7 @@ function useLimits(options) {
         setError(null);
         return;
       }
-      const promise = transport.getLimits({ productRef, meterName });
+      const promise = transport.getLimits({ productRef, meterName: meterName2 });
       limitsCache.set(key, { data: cached?.data ?? null, timestamp: now, promise });
       const fresh = await attachToFetch(promise);
       if (fresh !== null) {
@@ -6187,7 +6189,7 @@ function useLimits(options) {
         limitsCache.delete(key);
       }
     },
-    [transport, customerRef, productRef, meterName, enabled, attachToFetch]
+    [transport, customerRef, productRef, meterName2, enabled, attachToFetch]
   );
   useEffect12(() => {
     fetchLimits(false);
@@ -6205,7 +6207,7 @@ function useLimits(options) {
     (delta) => {
       if (!productRef || !enabled) return;
       if (unlimitedRef.current) return;
-      const key = cacheKey(customerRef, productRef, meterName);
+      const key = cacheKey(customerRef, productRef, meterName2);
       setData((prev) => {
         const cached = limitsCache.get(key);
         const baseline = prev ?? cached?.data ?? null;
@@ -6232,7 +6234,7 @@ function useLimits(options) {
         });
       }, OPTIMISTIC_GRACE_MS);
     },
-    [customerRef, productRef, meterName, enabled, fetchLimits]
+    [customerRef, productRef, meterName2, enabled, fetchLimits]
   );
   return {
     remaining: data?.remaining ?? null,
@@ -6248,11 +6250,14 @@ function useLimits(options) {
 }
 
 // src/hooks/useUsage.ts
+import { countsUsage as countsUsage2 } from "@solvapay/core";
 import { useCallback as useCallback20, useEffect as useEffect13, useMemo as useMemo14, useState as useState16 } from "react";
 function deriveUsage(purchase, limits) {
   if (!purchase) return null;
   const usage = purchase.usage;
-  if (purchase.planSnapshot?.isMetered !== true && !usage) return null;
+  if (!countsUsage2(purchase.planSnapshot) && purchase.planSnapshot?.isMetered !== true && !usage) {
+    return null;
+  }
   const used = typeof usage?.used === "number" ? usage.used : 0;
   const hasFiniteCap = limits.unlimited === false && limits.remaining !== null;
   const remaining = hasFiniteCap ? limits.remaining : null;
@@ -6275,18 +6280,18 @@ function useUsage() {
   const [override, setOverride] = useState16(null);
   const [error, setError] = useState16(null);
   const [transportLoading, setTransportLoading] = useState16(false);
-  const isMetered = activePurchase?.planSnapshot?.isMetered === true;
+  const usageCounted = countsUsage2(activePurchase?.planSnapshot) || activePurchase?.planSnapshot?.isMetered === true;
   const {
     remaining: limitRemaining,
     unlimited,
-    meterName
+    meterName: meterName2
   } = useLimits({
     productRef: activePurchase?.productRef,
-    enabled: isMetered
+    enabled: usageCounted
   });
   const derived = useMemo14(
-    () => deriveUsage(activePurchase ?? null, { remaining: limitRemaining, unlimited, meterName }),
-    [activePurchase, limitRemaining, unlimited, meterName]
+    () => deriveUsage(activePurchase ?? null, { remaining: limitRemaining, unlimited, meterName: meterName2 }),
+    [activePurchase, limitRemaining, unlimited, meterName2]
   );
   const activePurchaseRef = activePurchase?.reference ?? null;
   useEffect13(() => {
@@ -6547,6 +6552,7 @@ import {
   billingCycle as readBillingCycle,
   creditsPerUnitFromBalance,
   includedUnits,
+  meterName,
   perUnitCharge
 } from "@solvapay/core";
 function isPayg(plan) {
@@ -6607,7 +6613,7 @@ function inferIncludedUnits(plan) {
   return cap != null && cap > 0 ? cap : null;
 }
 function planMeterName(plan) {
-  return perUnitCharge(plan)?.meter ?? null;
+  return meterName(plan);
 }
 function shortCycle(cycle) {
   if (!cycle) return "mo";
@@ -6692,8 +6698,23 @@ function useCheckoutFlow(opts) {
     setStatus("activating");
     try {
       await transport.activatePlan({ productRef, planRef: selectedPlanRef });
+      const credits = await balance.refetch() ?? balance.credits;
+      if (credits == null) {
+        throw new Error("Credit balance is unavailable");
+      }
       setStatus("idle");
-      setStep("amount");
+      if (credits === 0) {
+        setStep("amount");
+      } else {
+        const meta = {
+          branch: "payg",
+          plan: selectedPlanShape,
+          rateLabel: formatPaygRate(selectedPlanShape, locale, balance)
+        };
+        setSuccessMeta(meta);
+        setStep("success");
+        onPurchaseSuccessRef.current?.(meta);
+      }
       return true;
     } catch (err) {
       const wrapped = err instanceof Error ? err : new Error("Activation failed");
@@ -6702,13 +6723,37 @@ function useCheckoutFlow(opts) {
       onErrorRef.current?.(wrapped, "activate");
       return false;
     }
-  }, [productRef, selectedPlanRef, selectedPlanShape, transport]);
+  }, [balance, locale, productRef, selectedPlanRef, selectedPlanShape, transport]);
   const advanceFromPlan = useCallback21(async () => {
     if (!selectedPlanShape || !selectedPlanRef) return;
     if (branch === "payg") {
       if (planCtx.currentPlanRef === selectedPlanRef) {
         setError(null);
-        setStep("amount");
+        setStatus("activating");
+        try {
+          const credits = await balance.refetch() ?? balance.credits;
+          if (credits == null) {
+            throw new Error("Credit balance is unavailable");
+          }
+          setStatus("idle");
+          if (credits === 0) {
+            setStep("amount");
+          } else {
+            const meta = {
+              branch: "payg",
+              plan: selectedPlanShape,
+              rateLabel: formatPaygRate(selectedPlanShape, locale, balance)
+            };
+            setSuccessMeta(meta);
+            setStep("success");
+            onPurchaseSuccessRef.current?.(meta);
+          }
+        } catch (err) {
+          const wrapped = err instanceof Error ? err : new Error("Activation failed");
+          setError(wrapped.message);
+          setStatus("error");
+          onErrorRef.current?.(wrapped, "activate");
+        }
         return;
       }
       await runActivate();
@@ -6716,7 +6761,7 @@ function useCheckoutFlow(opts) {
     }
     setError(null);
     setStep("payment");
-  }, [branch, planCtx.currentPlanRef, runActivate, selectedPlanRef, selectedPlanShape]);
+  }, [balance, branch, locale, planCtx.currentPlanRef, runActivate, selectedPlanRef, selectedPlanShape]);
   const recordPaygSuccess = useCallback21(
     (creditsAddedFromBackend) => {
       if (!selectedPlanShape || selectedAmountMinor == null) return;

package/dist/{chunk-PKZJIV3G.js → chunk-ZKFTT5WD.js}

@@ -40,7 +40,7 @@ import {
   useTopupAmountSelector,
   withPaymentElementDefaults,
   writeAutoRechargeCache
-} from "./chunk-6ABOJOEV.js";
+} from "./chunk-GMZU5M6R.js";
 
 // src/TopupForm.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -216,12 +216,29 @@ var Root2 = forwardRef3(function ActivationFlowRoot({
   const { activate, state, error, result, reset } = useActivation();
   const currency = plan?.currency ?? "USD";
   const amountSelector = useTopupAmountSelector({ currency });
-  const { adjustBalance, creditsPerMinorUnit, displayExchangeRate } = useBalance();
+  const {
+    credits,
+    adjustBalance,
+    creditsPerMinorUnit,
+    displayExchangeRate,
+    refetch,
+    loading: balanceLoading
+  } = useBalance();
   const [step, setStep] = useState2("summary");
   const calledSuccessRef = useRef(false);
   const retryTimeoutRef = useRef(null);
   useEffect2(() => {
-    if (state === "activated" && !calledSuccessRef.current) {
+    if (state !== "activated") return;
+    if (step === "selectAmount" || step === "topupPayment") return;
+    const isUsagePlan = plan?.type === "usage-based";
+    if (isUsagePlan && (credits === null || balanceLoading)) {
+      return;
+    }
+    if (isUsagePlan && credits === 0) {
+      setStep("selectAmount");
+      return;
+    }
+    if (!calledSuccessRef.current) {
       calledSuccessRef.current = true;
       setStep("activated");
       if (result) {
@@ -229,7 +246,7 @@ var Root2 = forwardRef3(function ActivationFlowRoot({
         onSuccess?.(activationResult);
       }
     }
-  }, [state, result, onSuccess]);
+  }, [state, result, onSuccess, credits, plan, balanceLoading, step]);
   useEffect2(() => {
     if (state === "topup_required" && (step === "summary" || step === "activating")) {
       setStep("selectAmount");
@@ -245,7 +262,8 @@ var Root2 = forwardRef3(function ActivationFlowRoot({
     if (!resolvedPlanRef) return;
     setStep("activating");
     await activate({ productRef, planRef: resolvedPlanRef });
-  }, [activate, productRef, resolvedPlanRef]);
+    await refetch();
+  }, [activate, productRef, resolvedPlanRef, refetch]);
   const goToTopupPayment = useCallback(() => {
     if (amountSelector.validate()) setStep("topupPayment");
   }, [amountSelector]);
@@ -336,16 +354,7 @@ var Root2 = forwardRef3(function ActivationFlowRoot({
     ]
   );
   const Comp = asChild ? Slot : "div";
-  return /* @__PURE__ */ jsx4(ActivationFlowContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx4(
-    Comp,
-    {
-      ref: forwardedRef,
-      "data-solvapay-activation-flow": "",
-      "data-state": step,
-      ...rest,
-      children
-    }
-  ) });
+  return /* @__PURE__ */ jsx4(ActivationFlowContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx4(Comp, { ref: forwardedRef, "data-solvapay-activation-flow": "", "data-state": step, ...rest, children }) });
 });
 function matchStep(step, allowed) {
   return allowed.includes(step);
@@ -435,16 +444,7 @@ var ErrorSlot2 = forwardRef3(function ActivationFlowError({ asChild, children, .
   const ctx = useFlowCtx("Error");
   if (ctx.step !== "error") return null;
   const Comp = asChild ? Slot : "div";
-  return /* @__PURE__ */ jsx4(
-    Comp,
-    {
-      ref: forwardedRef,
-      role: "alert",
-      "data-solvapay-activation-flow-error": "",
-      ...rest,
-      children: children ?? ctx.error
-    }
-  );
+  return /* @__PURE__ */ jsx4(Comp, { ref: forwardedRef, role: "alert", "data-solvapay-activation-flow-error": "", ...rest, children: children ?? ctx.error });
 });
 var ActivationFlowRoot2 = Root2;
 var ActivationFlowSummary2 = Summary;
@@ -2885,22 +2885,27 @@ function Success({ className, children }) {
   }
   const meta = flow.successMeta;
   if (meta.branch === "payg") {
+    const chargedAmount = meta.amountMinor;
+    const chargedCurrency = meta.currency;
+    const charged = chargedAmount != null && chargedCurrency != null;
     return /* @__PURE__ */ jsxs3("div", { className: className ?? "solvapay-checkout-success", "data-branch": "payg", children: [
       /* @__PURE__ */ jsx7("div", { className: "solvapay-checkout-success-check", "aria-hidden": "true", children: "\u2713" }),
-      /* @__PURE__ */ jsx7("h2", { className: "solvapay-checkout-success-heading", children: "Credits added" }),
+      /* @__PURE__ */ jsx7("h2", { className: "solvapay-checkout-success-heading", children: charged ? "Credits added" : "Plan activated" }),
       /* @__PURE__ */ jsx7("p", { className: "solvapay-checkout-success-subheading", children: "Pay as you go plan is active." }),
       /* @__PURE__ */ jsxs3("dl", { className: "solvapay-checkout-receipt", "data-variant": "payg", children: [
-        /* @__PURE__ */ jsxs3("div", { className: "solvapay-checkout-receipt-row", children: [
-          /* @__PURE__ */ jsx7("dt", { children: "Amount" }),
-          /* @__PURE__ */ jsx7("dd", { children: formatPrice(meta.amountMinor, meta.currency, { locale }) })
-        ] }),
-        /* @__PURE__ */ jsxs3("div", { className: "solvapay-checkout-receipt-row", children: [
-          /* @__PURE__ */ jsx7("dt", { children: "Credits" }),
-          /* @__PURE__ */ jsxs3("dd", { children: [
-            "+",
-            meta.creditsAdded.toLocaleString(locale)
+        charged ? /* @__PURE__ */ jsxs3(Fragment4, { children: [
+          /* @__PURE__ */ jsxs3("div", { className: "solvapay-checkout-receipt-row", children: [
+            /* @__PURE__ */ jsx7("dt", { children: "Amount" }),
+            /* @__PURE__ */ jsx7("dd", { children: formatPrice(chargedAmount, chargedCurrency, { locale }) })
+          ] }),
+          /* @__PURE__ */ jsxs3("div", { className: "solvapay-checkout-receipt-row", children: [
+            /* @__PURE__ */ jsx7("dt", { children: "Credits" }),
+            /* @__PURE__ */ jsxs3("dd", { children: [
+              "+",
+              (meta.creditsAdded ?? 0).toLocaleString(locale)
+            ] })
           ] })
-        ] }),
+        ] }) : null,
         /* @__PURE__ */ jsxs3("div", { className: "solvapay-checkout-receipt-row", children: [
           /* @__PURE__ */ jsx7("dt", { children: "Plan" }),
           /* @__PURE__ */ jsx7("dd", { children: meta.plan.name ?? "Pay as you go" })

package/dist/{index-DomaahLG.d.ts → index-DHcgeDBy.d.ts}

@@ -1,4 +1,4 @@
-import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-CAxz5wWs.js';
+import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-BI78qUom.js';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -411,8 +411,11 @@ declare const BalanceBadge: React.ForwardRefExoticComponent<React.HTMLAttributes
  * ActivationFlow compound primitive.
  *
  * Drives the usage-based plan activation state machine:
- *   summary → activating → (topup_required → selectAmount → topupPayment →
- *     retrying) → activated | error.
+ *   summary → activating → (activated + empty wallet → selectAmount →
+ *     topupPayment → retrying) → activated | error.
+ *
+ * `topup_required` remains a tolerated legacy activate status that also
+ * opens the amount picker.
  *
  * `Root` exposes `data-state` set to the current step and publishes the
  * shared context consumed by leaves. Leaves render only during their
@@ -527,15 +530,6 @@ declare const ActivationFlow: {
 };
 declare function useActivationFlow(): ActivationFlowContextValue;
 
-/**
- * CancelPlanButton leaf primitive.
- *
- * Cancels the active (or specified) purchase via `usePurchaseActions`.
- * Emits `data-state=idle|cancelling` and auto-derives the confirm dialog
- * copy from the plan type (`recurring` vs. `usage-based`) unless overridden
- * via the `confirm` prop (`false` to skip, string to replace).
- */
-
 declare const CancelPlanButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
     asChild?: boolean;
     /** Defaults to the active purchase from `usePurchase()`. */

package/dist/{index-D6KKDguz.d.cts → index-jmmZYs2K.d.cts}

@@ -1,4 +1,4 @@
-import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-A_Sg-fJE.cjs';
+import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-BgyNW-D3.cjs';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -411,8 +411,11 @@ declare const BalanceBadge: React.ForwardRefExoticComponent<React.HTMLAttributes
  * ActivationFlow compound primitive.
  *
  * Drives the usage-based plan activation state machine:
- *   summary → activating → (topup_required → selectAmount → topupPayment →
- *     retrying) → activated | error.
+ *   summary → activating → (activated + empty wallet → selectAmount →
+ *     topupPayment → retrying) → activated | error.
+ *
+ * `topup_required` remains a tolerated legacy activate status that also
+ * opens the amount picker.
  *
  * `Root` exposes `data-state` set to the current step and publishes the
  * shared context consumed by leaves. Leaves render only during their
@@ -527,15 +530,6 @@ declare const ActivationFlow: {
 };
 declare function useActivationFlow(): ActivationFlowContextValue;
 
-/**
- * CancelPlanButton leaf primitive.
- *
- * Cancels the active (or specified) purchase via `usePurchaseActions`.
- * Emits `data-state=idle|cancelling` and auto-derives the confirm dialog
- * copy from the plan type (`recurring` vs. `usage-based`) unless overridden
- * via the `confirm` prop (`false` to skip, string to replace).
- */
-
 declare const CancelPlanButton: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
     asChild?: boolean;
     /** Defaults to the active purchase from `usePurchase()`. */