@solvapay/react 2.3.0 → 2.3.1-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @solvapay/react changelog
 
+## 2.3.1-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7
+
+### Patch Changes
+
+- 389cffa: MCP hosted-checkout fallback now matches Add credits: a Change plan / Change amount back link, copy that the host blocked embedded payments, `Open SolvaPay checkout` as the CTA, and a single card instead of a nested one.
+- Updated dependencies [af077fe]
+  - @solvapay/mcp-core@0.4.4-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7
+
 ## 2.3.0
 
 ### Minor Changes

package/dist/{UsageMeter-zKMPnwCx.d.cts → UsageMeter-DWkwHgTP.d.cts}

@@ -1,5 +1,5 @@
 import React from 'react';
-import { _ as UsageSnapshot } from './useUsage-DNXxsmyG.cjs';
+import { _ as UsageSnapshot } from './useUsage-8NCXS45R.cjs';
 
 /**
  * `<UsageMeter>` compound primitive — renders the authenticated customer's

package/dist/{UsageMeter-DZxLZt4A.d.ts → UsageMeter-DosUKnwg.d.ts}

@@ -1,5 +1,5 @@
 import React from 'react';
-import { _ as UsageSnapshot } from './useUsage-CwvxnICf.js';
+import { _ as UsageSnapshot } from './useUsage-C5_XnS_6.js';
 
 /**
  * `<UsageMeter>` compound primitive — renders the authenticated customer's

package/dist/{index-DN66D54Q.d.ts → index-CxGoNto4.d.ts}

@@ -1,4 +1,4 @@
-import { a4 as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a5 as AutoRechargeInput, u as AutoRechargeConfig, a6 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './useUsage-CwvxnICf.js';
+import { a4 as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a5 as AutoRechargeInput, u as AutoRechargeConfig, a6 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './useUsage-C5_XnS_6.js';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -59,9 +59,9 @@ type PaywallGateRecoveryFields = {
     creditBalance?: number;
     /**
      * `PaywallState.kind` — same vocabulary as the classifier, not a third enum.
-     * `upgrade_required` / `limit_reached` / `reactivation_required` are
-     * SDK-only; the backend's `paywallReason` is a smaller set
-     * (`activation_required` / `topup_required` / `payment_required`).
+     * `upgrade_required` / `reactivation_required` are SDK-only. The
+     * backend's `paywallReason` covers `activation_required` /
+     * `topup_required` / `payment_required` / `limit_reached`.
      */
     reason?: PaywallReason;
     /** Single primary recovery the agent should take. */

package/dist/{index-BadShw3R.d.cts → index-fuaNfBE5.d.cts}

@@ -1,4 +1,4 @@
-import { a4 as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a5 as AutoRechargeInput, u as AutoRechargeConfig, a6 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './useUsage-DNXxsmyG.cjs';
+import { a4 as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a5 as AutoRechargeInput, u as AutoRechargeConfig, a6 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './useUsage-8NCXS45R.cjs';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -59,9 +59,9 @@ type PaywallGateRecoveryFields = {
     creditBalance?: number;
     /**
      * `PaywallState.kind` — same vocabulary as the classifier, not a third enum.
-     * `upgrade_required` / `limit_reached` / `reactivation_required` are
-     * SDK-only; the backend's `paywallReason` is a smaller set
-     * (`activation_required` / `topup_required` / `payment_required`).
+     * `upgrade_required` / `reactivation_required` are SDK-only. The
+     * backend's `paywallReason` covers `activation_required` /
+     * `topup_required` / `payment_required` / `limit_reached`.
      */
     reason?: PaywallReason;
     /** Single primary recovery the agent should take. */

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import React from 'react';
-import { S as SolvaPayProviderProps, P as PaymentFormProps, a as PrefillCustomer, T as TopupFormProps, C as CheckoutResult, b as Plan, A as ActivationResult, B as BootstrapPlanLike, c as SaveAutoRechargeResponse, d as PurchaseStatus, e as SolvaPayContextValue, U as UsePlansOptions, f as UsePlansReturn, g as UsePlanOptions, h as UsePlanReturn, i as UseProductReturn, j as UseMerchantReturn, k as SolvaPayCopy, l as PurchaseStatusReturn, m as CancelResult, R as ReactivateResult, n as ActivatePlanResult, o as UseTopupOptions, p as UseTopupReturn, q as BalanceStatus, r as UseTopupAmountSelectorOptions, s as UseTopupAmountSelectorReturn, t as UsePaymentMethodReturn, u as AutoRechargeConfig, v as SaveAutoRechargeInput, w as SolvaPayTransport, x as PartialSolvaPayCopy, y as PurchaseInfo, z as Product, D as SolvaPayConfig } from './useUsage-DNXxsmyG.cjs';
-export { E as CheckoutStep, F as CustomerPurchaseData, M as MandateContext, G as MandateTemplate, H as Merchant, I as PaymentError, J as PaymentIntentResult, K as PaymentMethodInfo, L as PaymentResult, N as PurchaseStatusValue, O as SuccessMeta, Q as TopupPaymentResult, V as TransportBalanceResult, W as TransportCheckoutSessionResult, X as TransportCustomerSessionResult, Y as TransportLimitsResult, Z as UnsupportedTransportMethodError, _ as UsageSnapshot, $ as UseUsageReturn, a0 as useUsage } from './useUsage-DNXxsmyG.cjs';
-import { P as PaymentFormSummary, a as PaymentFormCustomerFields, b as PaymentFormPaymentElement, c as PaymentFormCardElement, d as PaymentFormMandateText, e as PaymentFormTermsCheckbox, f as PaymentFormSubmitButton, g as PaymentFormLoading, h as PaymentFormError, i as PaymentFormLegalFooter, j as PaymentFormBusinessDetails, k as PaymentFormTaxSummary, A as AutoRechargeInputPayload, l as PaywallStructuredContent, C as CheckoutVariant } from './index-BadShw3R.cjs';
-export { m as ActivationFlowStep, B as BalanceBadge, n as CancelPlanButton, o as CheckoutErrorPhase, p as CheckoutStatus, q as CheckoutSteps, r as CheckoutSummary, s as CheckoutSummaryProps, M as MandateText, t as MandateTextProps, u as PlanBadge, v as ProductBadge, w as PurchaseGate, U as UseCheckoutFlowOptions, x as UseCheckoutFlowReturn, y as configToAutoRechargeInput, z as deriveVariant, D as useCheckoutFlow, E as useCheckoutStepsContext } from './index-BadShw3R.cjs';
+import { S as SolvaPayProviderProps, P as PaymentFormProps, a as PrefillCustomer, T as TopupFormProps, C as CheckoutResult, b as Plan, A as ActivationResult, B as BootstrapPlanLike, c as SaveAutoRechargeResponse, d as PurchaseStatus, e as SolvaPayContextValue, U as UsePlansOptions, f as UsePlansReturn, g as UsePlanOptions, h as UsePlanReturn, i as UseProductReturn, j as UseMerchantReturn, k as SolvaPayCopy, l as PurchaseStatusReturn, m as CancelResult, R as ReactivateResult, n as ActivatePlanResult, o as UseTopupOptions, p as UseTopupReturn, q as BalanceStatus, r as UseTopupAmountSelectorOptions, s as UseTopupAmountSelectorReturn, t as UsePaymentMethodReturn, u as AutoRechargeConfig, v as SaveAutoRechargeInput, w as SolvaPayTransport, x as PartialSolvaPayCopy, y as PurchaseInfo, z as Product, D as SolvaPayConfig } from './useUsage-8NCXS45R.cjs';
+export { E as CheckoutStep, F as CustomerPurchaseData, M as MandateContext, G as MandateTemplate, H as Merchant, I as PaymentError, J as PaymentIntentResult, K as PaymentMethodInfo, L as PaymentResult, N as PurchaseStatusValue, O as SuccessMeta, Q as TopupPaymentResult, V as TransportBalanceResult, W as TransportCheckoutSessionResult, X as TransportCustomerSessionResult, Y as TransportLimitsResult, Z as UnsupportedTransportMethodError, _ as UsageSnapshot, $ as UseUsageReturn, a0 as useUsage } from './useUsage-8NCXS45R.cjs';
+import { P as PaymentFormSummary, a as PaymentFormCustomerFields, b as PaymentFormPaymentElement, c as PaymentFormCardElement, d as PaymentFormMandateText, e as PaymentFormTermsCheckbox, f as PaymentFormSubmitButton, g as PaymentFormLoading, h as PaymentFormError, i as PaymentFormLegalFooter, j as PaymentFormBusinessDetails, k as PaymentFormTaxSummary, A as AutoRechargeInputPayload, l as PaywallStructuredContent, C as CheckoutVariant } from './index-fuaNfBE5.cjs';
+export { m as ActivationFlowStep, B as BalanceBadge, n as CancelPlanButton, o as CheckoutErrorPhase, p as CheckoutStatus, q as CheckoutSteps, r as CheckoutSummary, s as CheckoutSummaryProps, M as MandateText, t as MandateTextProps, u as PlanBadge, v as ProductBadge, w as PurchaseGate, U as UseCheckoutFlowOptions, x as UseCheckoutFlowReturn, y as configToAutoRechargeInput, z as deriveVariant, D as useCheckoutFlow, E as useCheckoutStepsContext } from './index-fuaNfBE5.cjs';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
-import { S as SolvaPayProviderProps, P as PaymentFormProps, a as PrefillCustomer, T as TopupFormProps, C as CheckoutResult, b as Plan, A as ActivationResult, B as BootstrapPlanLike, c as SaveAutoRechargeResponse, d as PurchaseStatus, e as SolvaPayContextValue, U as UsePlansOptions, f as UsePlansReturn, g as UsePlanOptions, h as UsePlanReturn, i as UseProductReturn, j as UseMerchantReturn, k as SolvaPayCopy, l as PurchaseStatusReturn, m as CancelResult, R as ReactivateResult, n as ActivatePlanResult, o as UseTopupOptions, p as UseTopupReturn, q as BalanceStatus, r as UseTopupAmountSelectorOptions, s as UseTopupAmountSelectorReturn, t as UsePaymentMethodReturn, u as AutoRechargeConfig, v as SaveAutoRechargeInput, w as SolvaPayTransport, x as PartialSolvaPayCopy, y as PurchaseInfo, z as Product, D as SolvaPayConfig } from './useUsage-CwvxnICf.js';
-export { E as CheckoutStep, F as CustomerPurchaseData, M as MandateContext, G as MandateTemplate, H as Merchant, I as PaymentError, J as PaymentIntentResult, K as PaymentMethodInfo, L as PaymentResult, N as PurchaseStatusValue, O as SuccessMeta, Q as TopupPaymentResult, V as TransportBalanceResult, W as TransportCheckoutSessionResult, X as TransportCustomerSessionResult, Y as TransportLimitsResult, Z as UnsupportedTransportMethodError, _ as UsageSnapshot, $ as UseUsageReturn, a0 as useUsage } from './useUsage-CwvxnICf.js';
-import { P as PaymentFormSummary, a as PaymentFormCustomerFields, b as PaymentFormPaymentElement, c as PaymentFormCardElement, d as PaymentFormMandateText, e as PaymentFormTermsCheckbox, f as PaymentFormSubmitButton, g as PaymentFormLoading, h as PaymentFormError, i as PaymentFormLegalFooter, j as PaymentFormBusinessDetails, k as PaymentFormTaxSummary, A as AutoRechargeInputPayload, l as PaywallStructuredContent, C as CheckoutVariant } from './index-DN66D54Q.js';
-export { m as ActivationFlowStep, B as BalanceBadge, n as CancelPlanButton, o as CheckoutErrorPhase, p as CheckoutStatus, q as CheckoutSteps, r as CheckoutSummary, s as CheckoutSummaryProps, M as MandateText, t as MandateTextProps, u as PlanBadge, v as ProductBadge, w as PurchaseGate, U as UseCheckoutFlowOptions, x as UseCheckoutFlowReturn, y as configToAutoRechargeInput, z as deriveVariant, D as useCheckoutFlow, E as useCheckoutStepsContext } from './index-DN66D54Q.js';
+import { S as SolvaPayProviderProps, P as PaymentFormProps, a as PrefillCustomer, T as TopupFormProps, C as CheckoutResult, b as Plan, A as ActivationResult, B as BootstrapPlanLike, c as SaveAutoRechargeResponse, d as PurchaseStatus, e as SolvaPayContextValue, U as UsePlansOptions, f as UsePlansReturn, g as UsePlanOptions, h as UsePlanReturn, i as UseProductReturn, j as UseMerchantReturn, k as SolvaPayCopy, l as PurchaseStatusReturn, m as CancelResult, R as ReactivateResult, n as ActivatePlanResult, o as UseTopupOptions, p as UseTopupReturn, q as BalanceStatus, r as UseTopupAmountSelectorOptions, s as UseTopupAmountSelectorReturn, t as UsePaymentMethodReturn, u as AutoRechargeConfig, v as SaveAutoRechargeInput, w as SolvaPayTransport, x as PartialSolvaPayCopy, y as PurchaseInfo, z as Product, D as SolvaPayConfig } from './useUsage-C5_XnS_6.js';
+export { E as CheckoutStep, F as CustomerPurchaseData, M as MandateContext, G as MandateTemplate, H as Merchant, I as PaymentError, J as PaymentIntentResult, K as PaymentMethodInfo, L as PaymentResult, N as PurchaseStatusValue, O as SuccessMeta, Q as TopupPaymentResult, V as TransportBalanceResult, W as TransportCheckoutSessionResult, X as TransportCustomerSessionResult, Y as TransportLimitsResult, Z as UnsupportedTransportMethodError, _ as UsageSnapshot, $ as UseUsageReturn, a0 as useUsage } from './useUsage-C5_XnS_6.js';
+import { P as PaymentFormSummary, a as PaymentFormCustomerFields, b as PaymentFormPaymentElement, c as PaymentFormCardElement, d as PaymentFormMandateText, e as PaymentFormTermsCheckbox, f as PaymentFormSubmitButton, g as PaymentFormLoading, h as PaymentFormError, i as PaymentFormLegalFooter, j as PaymentFormBusinessDetails, k as PaymentFormTaxSummary, A as AutoRechargeInputPayload, l as PaywallStructuredContent, C as CheckoutVariant } from './index-CxGoNto4.js';
+export { m as ActivationFlowStep, B as BalanceBadge, n as CancelPlanButton, o as CheckoutErrorPhase, p as CheckoutStatus, q as CheckoutSteps, r as CheckoutSummary, s as CheckoutSummaryProps, M as MandateText, t as MandateTextProps, u as PlanBadge, v as ProductBadge, w as PurchaseGate, U as UseCheckoutFlowOptions, x as UseCheckoutFlowReturn, y as configToAutoRechargeInput, z as deriveVariant, D as useCheckoutFlow, E as useCheckoutStepsContext } from './index-CxGoNto4.js';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/mcp/index.cjs

@@ -11353,17 +11353,20 @@ var UpgradeBody = import_react51.default.memo(function UpgradeBody2({
   planName,
   checkout,
   onLaunch,
+  onBack,
+  backLabel,
   cx: cx2
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime45.jsxs)(import_jsx_runtime45.Fragment, { children: [
+    onBack ? /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(BackLink, { label: backLabel, onClick: onBack }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("h2", { className: cx2.heading, children: planName ? `Complete your ${planName} purchase` : "Upgrade your plan" }),
-    /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("p", { className: cx2.muted, children: "The SolvaPay checkout opens in a new tab. Return here after payment and your purchase will show up automatically." }),
+    /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("p", { className: cx2.muted, children: "This host doesn't allow embedded payments. Open the SolvaPay checkout in a new tab to complete your purchase there. Return here after payment and your purchase will show up automatically." }),
     /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(
       HostedLinkButton,
       {
         state: checkout,
         loadingLabel: "Loading checkout\u2026",
-        readyLabel: "Upgrade",
+        readyLabel: "Open SolvaPay checkout",
         onLaunch,
         cx: cx2
       }
@@ -11376,6 +11379,8 @@ function HostedCheckout({
   planRef,
   planName,
   onPurchaseSuccess,
+  onBack,
+  backLabel = "Change plan",
   cx: cx2,
   children
 }) {
@@ -11499,7 +11504,17 @@ function HostedCheckout({
         }
       );
     }
-    return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(UpgradeBody, { planName, checkout, onLaunch: beginAwaiting, cx: cx2 });
+    return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(
+      UpgradeBody,
+      {
+        planName,
+        checkout,
+        onLaunch: beginAwaiting,
+        onBack,
+        backLabel,
+        cx: cx2
+      }
+    );
   }, [
     awaiting,
     awaitingHref,
@@ -11514,12 +11529,14 @@ function HostedCheckout({
     checkout,
     beginAwaiting,
     planName,
+    onBack,
+    backLabel,
     cx2
   ]);
   if (loading) {
-    return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("div", { className: cx2.card, children: /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("p", { children: "Loading purchase\u2026" }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)("p", { children: "Loading purchase\u2026" });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime45.jsxs)("div", { className: cx2.card, "data-refreshing": isRefetching ? "true" : void 0, children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime45.jsxs)("div", { "data-refreshing": isRefetching ? "true" : void 0, children: [
     inner,
     children
   ] });
@@ -11713,6 +11730,7 @@ function McpCheckoutBody({
       return /* @__PURE__ */ (0, import_jsx_runtime46.jsx)("p", { children: "Loading checkout\u2026" });
     }
     if (stripeProbe === "blocked") {
+      const hostedBackLabel = flow.branch === "payg" ? "Change amount" : "Change plan";
       return /* @__PURE__ */ (0, import_jsx_runtime46.jsx)(
         HostedCheckout,
         {
@@ -11720,6 +11738,8 @@ function McpCheckoutBody({
           planRef: flow.selectedPlanRef ?? void 0,
           planName: selectedPlanShape?.name ?? void 0,
           onPurchaseSuccess,
+          onBack: () => flow.back(),
+          backLabel: hostedBackLabel,
           cx: cx2
         }
       );

package/dist/mcp/index.d.cts

@@ -1,10 +1,10 @@
-import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-DNXxsmyG.cjs';
+import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-8NCXS45R.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';
 import React from 'react';
 import { PricingOptionLike, PricedLike, BalancePegLike } from '@solvapay/core';
-import { U as UsageMeterRootProps } from '../UsageMeter-zKMPnwCx.cjs';
+import { U as UsageMeterRootProps } from '../UsageMeter-DWkwHgTP.cjs';
 import '@stripe/stripe-js';
 import '../adapters/auth.cjs';
 

package/dist/mcp/index.d.ts

@@ -1,10 +1,10 @@
-import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-CwvxnICf.js';
+import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-C5_XnS_6.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';
 import React from 'react';
 import { PricingOptionLike, PricedLike, BalancePegLike } from '@solvapay/core';
-import { U as UsageMeterRootProps } from '../UsageMeter-DZxLZt4A.js';
+import { U as UsageMeterRootProps } from '../UsageMeter-DosUKnwg.js';
 import '@stripe/stripe-js';
 import '../adapters/auth.js';
 

package/dist/mcp/index.js

@@ -3657,17 +3657,20 @@ var UpgradeBody = React10.memo(function UpgradeBody2({
   planName,
   checkout,
   onLaunch,
+  onBack,
+  backLabel,
   cx: cx2
 }) {
   return /* @__PURE__ */ jsxs18(Fragment11, { children: [
+    onBack ? /* @__PURE__ */ jsx25(BackLink, { label: backLabel, onClick: onBack }) : null,
     /* @__PURE__ */ jsx25("h2", { className: cx2.heading, children: planName ? `Complete your ${planName} purchase` : "Upgrade your plan" }),
-    /* @__PURE__ */ jsx25("p", { className: cx2.muted, children: "The SolvaPay checkout opens in a new tab. Return here after payment and your purchase will show up automatically." }),
+    /* @__PURE__ */ jsx25("p", { className: cx2.muted, children: "This host doesn't allow embedded payments. Open the SolvaPay checkout in a new tab to complete your purchase there. Return here after payment and your purchase will show up automatically." }),
     /* @__PURE__ */ jsx25(
       HostedLinkButton,
       {
         state: checkout,
         loadingLabel: "Loading checkout\u2026",
-        readyLabel: "Upgrade",
+        readyLabel: "Open SolvaPay checkout",
         onLaunch,
         cx: cx2
       }
@@ -3680,6 +3683,8 @@ function HostedCheckout({
   planRef,
   planName,
   onPurchaseSuccess,
+  onBack,
+  backLabel = "Change plan",
   cx: cx2,
   children
 }) {
@@ -3803,7 +3808,17 @@ function HostedCheckout({
         }
       );
     }
-    return /* @__PURE__ */ jsx25(UpgradeBody, { planName, checkout, onLaunch: beginAwaiting, cx: cx2 });
+    return /* @__PURE__ */ jsx25(
+      UpgradeBody,
+      {
+        planName,
+        checkout,
+        onLaunch: beginAwaiting,
+        onBack,
+        backLabel,
+        cx: cx2
+      }
+    );
   }, [
     awaiting,
     awaitingHref,
@@ -3818,12 +3833,14 @@ function HostedCheckout({
     checkout,
     beginAwaiting,
     planName,
+    onBack,
+    backLabel,
     cx2
   ]);
   if (loading) {
-    return /* @__PURE__ */ jsx25("div", { className: cx2.card, children: /* @__PURE__ */ jsx25("p", { children: "Loading purchase\u2026" }) });
+    return /* @__PURE__ */ jsx25("p", { children: "Loading purchase\u2026" });
   }
-  return /* @__PURE__ */ jsxs18("div", { className: cx2.card, "data-refreshing": isRefetching ? "true" : void 0, children: [
+  return /* @__PURE__ */ jsxs18("div", { "data-refreshing": isRefetching ? "true" : void 0, children: [
     inner,
     children
   ] });
@@ -4017,6 +4034,7 @@ function McpCheckoutBody({
       return /* @__PURE__ */ jsx26("p", { children: "Loading checkout\u2026" });
     }
     if (stripeProbe === "blocked") {
+      const hostedBackLabel = flow.branch === "payg" ? "Change amount" : "Change plan";
       return /* @__PURE__ */ jsx26(
         HostedCheckout,
         {
@@ -4024,6 +4042,8 @@ function McpCheckoutBody({
           planRef: flow.selectedPlanRef ?? void 0,
           planName: selectedPlanShape?.name ?? void 0,
           onPurchaseSuccess,
+          onBack: () => flow.back(),
+          backLabel: hostedBackLabel,
           cx: cx2
         }
       );

package/dist/primitives/index.d.cts

@@ -1,13 +1,13 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { Ref } from 'react';
-import { b as Plan, z as Product, s as UseTopupAmountSelectorReturn, y as PurchaseInfo, T as TopupFormProps, c as SaveAutoRechargeResponse, u as AutoRechargeConfig } from '../useUsage-DNXxsmyG.cjs';
-export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-DNXxsmyG.cjs';
+import { b as Plan, z as Product, s as UseTopupAmountSelectorReturn, y as PurchaseInfo, T as TopupFormProps, c as SaveAutoRechargeResponse, u as AutoRechargeConfig } from '../useUsage-8NCXS45R.cjs';
+export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-8NCXS45R.cjs';
 import { TaxBreakdown, BusinessDetailsInput } from '@solvapay/core';
-import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-BadShw3R.cjs';
-export { H as ActivationFlow, I as ActivationFlowActivateButton, J as ActivationFlowActivated, K as ActivationFlowAmountPicker, L as ActivationFlowContinueButton, N as ActivationFlowError, O as ActivationFlowLoading, Q as ActivationFlowRetrying, R as ActivationFlowRoot, m as ActivationFlowStep, S as ActivationFlowSummary, B as BalanceBadge, n as CancelPlanButton, p as CheckoutStatus, q as CheckoutSteps, T as CheckoutStepsAmountContinueButton, V as CheckoutStepsAmountPicker, W as CheckoutStepsBackLink, X as CheckoutStepsIfStep, Y as CheckoutStepsPayment, Z as CheckoutStepsPlanContinueButton, _ as CheckoutStepsPlanGrid, $ as CheckoutStepsRoot, a0 as CheckoutStepsStepHeading, a1 as CheckoutStepsStepMessage, a2 as CheckoutStepsSuccess, M as MandateText, t as MandateTextProps, a3 as PaymentForm, j as PaymentFormBusinessDetails, c as PaymentFormCardElement, a as PaymentFormCustomerFields, h as PaymentFormError, i as PaymentFormLegalFooter, g as PaymentFormLoading, d as PaymentFormMandateText, b as PaymentFormPaymentElement, a4 as PaymentFormRoot, f as PaymentFormSubmitButton, P as PaymentFormSummary, k as PaymentFormTaxSummary, e as PaymentFormTermsCheckbox, u as PlanBadge, v as ProductBadge, w as PurchaseGate, a5 as PurchaseGateAllowed, a6 as PurchaseGateBlocked, a7 as PurchaseGateError, a8 as PurchaseGateLoading, a9 as PurchaseGateRoot, aa as useActivationFlow, E as useCheckoutStepsContext, ab as usePurchaseGate } from '../index-BadShw3R.cjs';
+import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-fuaNfBE5.cjs';
+export { H as ActivationFlow, I as ActivationFlowActivateButton, J as ActivationFlowActivated, K as ActivationFlowAmountPicker, L as ActivationFlowContinueButton, N as ActivationFlowError, O as ActivationFlowLoading, Q as ActivationFlowRetrying, R as ActivationFlowRoot, m as ActivationFlowStep, S as ActivationFlowSummary, B as BalanceBadge, n as CancelPlanButton, p as CheckoutStatus, q as CheckoutSteps, T as CheckoutStepsAmountContinueButton, V as CheckoutStepsAmountPicker, W as CheckoutStepsBackLink, X as CheckoutStepsIfStep, Y as CheckoutStepsPayment, Z as CheckoutStepsPlanContinueButton, _ as CheckoutStepsPlanGrid, $ as CheckoutStepsRoot, a0 as CheckoutStepsStepHeading, a1 as CheckoutStepsStepMessage, a2 as CheckoutStepsSuccess, M as MandateText, t as MandateTextProps, a3 as PaymentForm, j as PaymentFormBusinessDetails, c as PaymentFormCardElement, a as PaymentFormCustomerFields, h as PaymentFormError, i as PaymentFormLegalFooter, g as PaymentFormLoading, d as PaymentFormMandateText, b as PaymentFormPaymentElement, a4 as PaymentFormRoot, f as PaymentFormSubmitButton, P as PaymentFormSummary, k as PaymentFormTaxSummary, e as PaymentFormTermsCheckbox, u as PlanBadge, v as ProductBadge, w as PurchaseGate, a5 as PurchaseGateAllowed, a6 as PurchaseGateBlocked, a7 as PurchaseGateError, a8 as PurchaseGateLoading, a9 as PurchaseGateRoot, aa as useActivationFlow, E as useCheckoutStepsContext, ab as usePurchaseGate } from '../index-fuaNfBE5.cjs';
 import { PaymentElement } from '@stripe/react-stripe-js';
 import { Stripe, StripeElements } from '@stripe/stripe-js';
-export { a as UsageMeter, B as UsageMeterBar, b as UsageMeterClassNames, E as UsageMeterEmpty, L as UsageMeterLabel, c as UsageMeterLoading, P as UsageMeterPercentage, R as UsageMeterResetsIn, d as UsageMeterRoot, U as UsageMeterRootProps, u as useUsageMeter } from '../UsageMeter-zKMPnwCx.cjs';
+export { a as UsageMeter, B as UsageMeterBar, b as UsageMeterClassNames, E as UsageMeterEmpty, L as UsageMeterLabel, c as UsageMeterLoading, P as UsageMeterPercentage, R as UsageMeterResetsIn, d as UsageMeterRoot, U as UsageMeterRootProps, u as useUsageMeter } from '../UsageMeter-DWkwHgTP.cjs';
 import '../adapters/auth.cjs';
 
 type PlanPricingOption = {

package/dist/primitives/index.d.ts

@@ -1,13 +1,13 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { Ref } from 'react';
-import { b as Plan, z as Product, s as UseTopupAmountSelectorReturn, y as PurchaseInfo, T as TopupFormProps, c as SaveAutoRechargeResponse, u as AutoRechargeConfig } from '../useUsage-CwvxnICf.js';
-export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-CwvxnICf.js';
+import { b as Plan, z as Product, s as UseTopupAmountSelectorReturn, y as PurchaseInfo, T as TopupFormProps, c as SaveAutoRechargeResponse, u as AutoRechargeConfig } from '../useUsage-C5_XnS_6.js';
+export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-C5_XnS_6.js';
 import { TaxBreakdown, BusinessDetailsInput } from '@solvapay/core';
-import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-DN66D54Q.js';
-export { H as ActivationFlow, I as ActivationFlowActivateButton, J as ActivationFlowActivated, K as ActivationFlowAmountPicker, L as ActivationFlowContinueButton, N as ActivationFlowError, O as ActivationFlowLoading, Q as ActivationFlowRetrying, R as ActivationFlowRoot, m as ActivationFlowStep, S as ActivationFlowSummary, B as BalanceBadge, n as CancelPlanButton, p as CheckoutStatus, q as CheckoutSteps, T as CheckoutStepsAmountContinueButton, V as CheckoutStepsAmountPicker, W as CheckoutStepsBackLink, X as CheckoutStepsIfStep, Y as CheckoutStepsPayment, Z as CheckoutStepsPlanContinueButton, _ as CheckoutStepsPlanGrid, $ as CheckoutStepsRoot, a0 as CheckoutStepsStepHeading, a1 as CheckoutStepsStepMessage, a2 as CheckoutStepsSuccess, M as MandateText, t as MandateTextProps, a3 as PaymentForm, j as PaymentFormBusinessDetails, c as PaymentFormCardElement, a as PaymentFormCustomerFields, h as PaymentFormError, i as PaymentFormLegalFooter, g as PaymentFormLoading, d as PaymentFormMandateText, b as PaymentFormPaymentElement, a4 as PaymentFormRoot, f as PaymentFormSubmitButton, P as PaymentFormSummary, k as PaymentFormTaxSummary, e as PaymentFormTermsCheckbox, u as PlanBadge, v as ProductBadge, w as PurchaseGate, a5 as PurchaseGateAllowed, a6 as PurchaseGateBlocked, a7 as PurchaseGateError, a8 as PurchaseGateLoading, a9 as PurchaseGateRoot, aa as useActivationFlow, E as useCheckoutStepsContext, ab as usePurchaseGate } from '../index-DN66D54Q.js';
+import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-CxGoNto4.js';
+export { H as ActivationFlow, I as ActivationFlowActivateButton, J as ActivationFlowActivated, K as ActivationFlowAmountPicker, L as ActivationFlowContinueButton, N as ActivationFlowError, O as ActivationFlowLoading, Q as ActivationFlowRetrying, R as ActivationFlowRoot, m as ActivationFlowStep, S as ActivationFlowSummary, B as BalanceBadge, n as CancelPlanButton, p as CheckoutStatus, q as CheckoutSteps, T as CheckoutStepsAmountContinueButton, V as CheckoutStepsAmountPicker, W as CheckoutStepsBackLink, X as CheckoutStepsIfStep, Y as CheckoutStepsPayment, Z as CheckoutStepsPlanContinueButton, _ as CheckoutStepsPlanGrid, $ as CheckoutStepsRoot, a0 as CheckoutStepsStepHeading, a1 as CheckoutStepsStepMessage, a2 as CheckoutStepsSuccess, M as MandateText, t as MandateTextProps, a3 as PaymentForm, j as PaymentFormBusinessDetails, c as PaymentFormCardElement, a as PaymentFormCustomerFields, h as PaymentFormError, i as PaymentFormLegalFooter, g as PaymentFormLoading, d as PaymentFormMandateText, b as PaymentFormPaymentElement, a4 as PaymentFormRoot, f as PaymentFormSubmitButton, P as PaymentFormSummary, k as PaymentFormTaxSummary, e as PaymentFormTermsCheckbox, u as PlanBadge, v as ProductBadge, w as PurchaseGate, a5 as PurchaseGateAllowed, a6 as PurchaseGateBlocked, a7 as PurchaseGateError, a8 as PurchaseGateLoading, a9 as PurchaseGateRoot, aa as useActivationFlow, E as useCheckoutStepsContext, ab as usePurchaseGate } from '../index-CxGoNto4.js';
 import { PaymentElement } from '@stripe/react-stripe-js';
 import { Stripe, StripeElements } from '@stripe/stripe-js';
-export { a as UsageMeter, B as UsageMeterBar, b as UsageMeterClassNames, E as UsageMeterEmpty, L as UsageMeterLabel, c as UsageMeterLoading, P as UsageMeterPercentage, R as UsageMeterResetsIn, d as UsageMeterRoot, U as UsageMeterRootProps, u as useUsageMeter } from '../UsageMeter-DZxLZt4A.js';
+export { a as UsageMeter, B as UsageMeterBar, b as UsageMeterClassNames, E as UsageMeterEmpty, L as UsageMeterLabel, c as UsageMeterLoading, P as UsageMeterPercentage, R as UsageMeterResetsIn, d as UsageMeterRoot, U as UsageMeterRootProps, u as useUsageMeter } from '../UsageMeter-DosUKnwg.js';
 import '../adapters/auth.js';
 
 type PlanPricingOption = {

package/dist/{useUsage-DNXxsmyG.d.cts → useUsage-8NCXS45R.d.cts}

@@ -257,6 +257,15 @@ interface components {
         };
         CheckLimitRequest: {
             customerRef: string;
+            /** @description SDK-only free-tool allowance. Authenticated by the provider secret key, so `cap` is the provider's own declaration, not customer input. */
+            freeAllowance?: {
+                cap?: number;
+                /** @description Free meter name. Must match `/^free-[a-z0-9-]+$/`. */
+                meter?: string;
+                /** @enum {string} */
+                scope?: 'rolling_window' | 'lifetime';
+                windowDays?: number;
+            };
             includeCheckoutSession?: boolean;
             meterName?: string;
             productRef: string;
@@ -912,7 +921,7 @@ interface components {
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
              * @enum {string}
              */
-            paywallReason?: 'activation_required' | 'topup_required' | 'payment_required';
+            paywallReason?: 'activation_required' | 'topup_required' | 'payment_required' | 'limit_reached';
             /** @description Display name of the active or default plan */
             planName?: string;
             /** @description Active plan reference when the customer already holds a purchase */

package/dist/{useUsage-CwvxnICf.d.ts → useUsage-C5_XnS_6.d.ts}

@@ -257,6 +257,15 @@ interface components {
         };
         CheckLimitRequest: {
             customerRef: string;
+            /** @description SDK-only free-tool allowance. Authenticated by the provider secret key, so `cap` is the provider's own declaration, not customer input. */
+            freeAllowance?: {
+                cap?: number;
+                /** @description Free meter name. Must match `/^free-[a-z0-9-]+$/`. */
+                meter?: string;
+                /** @enum {string} */
+                scope?: 'rolling_window' | 'lifetime';
+                windowDays?: number;
+            };
             includeCheckoutSession?: boolean;
             meterName?: string;
             productRef: string;
@@ -912,7 +921,7 @@ interface components {
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
              * @enum {string}
              */
-            paywallReason?: 'activation_required' | 'topup_required' | 'payment_required';
+            paywallReason?: 'activation_required' | 'topup_required' | 'payment_required' | 'limit_reached';
             /** @description Display name of the active or default plan */
             planName?: string;
             /** @description Active plan reference when the customer already holds a purchase */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/react",
-  "version": "2.3.0",
+  "version": "2.3.1-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -57,7 +57,7 @@
     "directory": "packages/react"
   },
   "peerDependencies": {
-    "@solvapay/mcp-core": "^0.2.8 || ^0.3.0 || ^0.4.0",
+    "@solvapay/mcp-core": "0.4.4-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
   },
@@ -85,8 +85,8 @@
     "react-dom": "^19.2.5",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@solvapay/mcp-core": "0.4.3",
-    "@solvapay/server": "2.7.0",
+    "@solvapay/mcp-core": "0.4.4-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7",
+    "@solvapay/server": "2.8.0-preview-fac876555de66d02a17ebc2c433d1f2d5250ede7",
     "@solvapay/test-utils": "0.0.0"
   },
   "scripts": {