@solvapay/react 2.4.0 → 2.5.0-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @solvapay/react changelog
 
+## 2.5.0-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65
+
+### Minor Changes
+
+- bd029af: Limit checks no longer return `throttled`, `needsUpgrade`, or `upgraded`. `LimitOption.onExceed` is `block` or `top_up`; the API still accepts `charge` and stores it as `top_up`. Rollover options are gone from the plan types; the API drops them on input. Usage on a recurring plan is paid from prepaid credits, never billed to a card: `overage` (and `consequence: 'overage'`) now means access past the included cap paid from credits. The recurring checkout mandate no longer mentions usage past the included allowance.
+
+### Patch Changes
+
+- Updated dependencies [815f9a2]
+- Updated dependencies [bd029af]
+  - @solvapay/mcp-core@0.4.6-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65
+
 ## 2.4.0
 
 ### Minor Changes

package/dist/{UsageMeter-DUeL64V4.d.cts → UsageMeter-D2KW08uB.d.cts}

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

package/dist/{UsageMeter-iI9fukd0.d.ts → UsageMeter-D54b_WOn.d.ts}

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

package/dist/{chunk-MMD6AOUR.js → chunk-67GJCZZU.js}

@@ -319,11 +319,8 @@ function createHttpTransport(config) {
         remaining: data.remaining,
         meterName: data.meterName ?? null,
         activationRequired: data.activationRequired ?? false,
-        throttled: data.throttled,
         overage: data.overage,
         needsTopUp: data.needsTopUp,
-        needsUpgrade: data.needsUpgrade,
-        upgraded: data.upgraded,
         ...data.used !== void 0 ? { used: data.used } : {},
         ...data.limit !== void 0 ? { limit: data.limit } : {}
       };
@@ -375,7 +372,8 @@ var enCopy = {
       const period = intervalPhrase(ctx);
       const trial = trialPhrase(ctx);
       const every = period ? ` every ${period}` : "";
-      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time. Payments are processed by SolvaPay.${legalSentence(ctx)}`;
+      const savedCard = ctx.savesPaymentMethod ? ` You also authorize ${ctx.merchant.legalName} to save your card for renewals and failed-payment retries.` : "";
+      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time.${savedCard} Payments are processed by SolvaPay.${legalSentence(ctx)}`;
     },
     oneTime: (ctx) => {
       const product = ctx.product?.name ? ` for ${ctx.product.name}` : "";
@@ -6738,11 +6736,8 @@ function useLimits(options) {
     withinLimits: data?.withinLimits ?? null,
     meterName: data?.meterName ?? null,
     activationRequired: data?.activationRequired ?? null,
-    throttled: data?.throttled ?? null,
     overage: data?.overage ?? null,
     needsTopUp: data?.needsTopUp ?? null,
-    needsUpgrade: data?.needsUpgrade ?? null,
-    upgraded: data?.upgraded ?? null,
     used: data?.used ?? null,
     limit: data?.limit ?? null,
     loading,

package/dist/{chunk-P4PPMKIK.js → chunk-BI5MJT24.js}

@@ -8,7 +8,7 @@ import {
   useOpenExternal,
   useSolvaPay,
   useTransport
-} from "./chunk-MMD6AOUR.js";
+} from "./chunk-67GJCZZU.js";
 
 // src/hooks/usePaymentMethod.ts
 import { useCallback, useEffect, useState } from "react";

package/dist/{chunk-BPF5NFWF.js → chunk-IZPE4LKU.js}

@@ -52,7 +52,7 @@ import {
   validateAutoRechargeForm,
   withPaymentElementDefaults,
   writeAutoRechargeCache
-} from "./chunk-MMD6AOUR.js";
+} from "./chunk-67GJCZZU.js";
 
 // src/TopupForm.tsx
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/{index-BTZxR-Le.d.cts → index-CI48gWSF.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-zYGsspbH.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-6bFVuK7L.cjs';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';

package/dist/{index-BY4aA8T2.d.ts → index-DXCVbTGi.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-B144Vck8.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-CNZPv3__.js';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';

package/dist/index.cjs

@@ -563,11 +563,8 @@ function createHttpTransport(config) {
         remaining: data.remaining,
         meterName: data.meterName ?? null,
         activationRequired: data.activationRequired ?? false,
-        throttled: data.throttled,
         overage: data.overage,
         needsTopUp: data.needsTopUp,
-        needsUpgrade: data.needsUpgrade,
-        upgraded: data.upgraded,
         ...data.used !== void 0 ? { used: data.used } : {},
         ...data.limit !== void 0 ? { limit: data.limit } : {}
       };
@@ -622,7 +619,8 @@ var enCopy = {
       const period = intervalPhrase(ctx);
       const trial = trialPhrase(ctx);
       const every = period ? ` every ${period}` : "";
-      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time. Payments are processed by SolvaPay.${legalSentence(ctx)}`;
+      const savedCard = ctx.savesPaymentMethod ? ` You also authorize ${ctx.merchant.legalName} to save your card for renewals and failed-payment retries.` : "";
+      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time.${savedCard} Payments are processed by SolvaPay.${legalSentence(ctx)}`;
     },
     oneTime: (ctx) => {
       const product = ctx.product?.name ? ` for ${ctx.product.name}` : "";
@@ -8382,11 +8380,8 @@ function useLimits(options) {
     withinLimits: data?.withinLimits ?? null,
     meterName: data?.meterName ?? null,
     activationRequired: data?.activationRequired ?? null,
-    throttled: data?.throttled ?? null,
     overage: data?.overage ?? null,
     needsTopUp: data?.needsTopUp ?? null,
-    needsUpgrade: data?.needsUpgrade ?? null,
-    upgraded: data?.upgraded ?? null,
     used: data?.used ?? null,
     limit: data?.limit ?? null,
     loading,

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-zYGsspbH.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-zYGsspbH.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-BTZxR-Le.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-BTZxR-Le.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-6bFVuK7L.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-6bFVuK7L.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-CI48gWSF.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-CI48gWSF.cjs';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -961,16 +961,10 @@ interface UseLimitsReturn {
      * should treat `true` as "needs the activation flow", not "exhausted".
      */
     activationRequired: boolean | null;
-    /** Access granted under `onExceed: throttle` (legacy plans). `null` while loading. */
-    throttled: boolean | null;
-    /** Access granted and usage past the cap accrues overage. `null` while loading. */
+    /** Access granted past the included cap, paid from prepaid credits. `null` while loading. */
     overage: boolean | null;
     /** Access blocked pending a prepaid top-up. `null` while loading. */
     needsTopUp: boolean | null;
-    /** Access blocked pending an auto-upgrade. `null` while loading. */
-    needsUpgrade: boolean | null;
-    /** The customer was auto-upgraded and access was restored. `null` while loading. */
-    upgraded: boolean | null;
     /**
      * Consumed units this period. `null` while loading, when disabled, or
      * when the backend did not measure a finite cap.

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-B144Vck8.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-B144Vck8.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-BY4aA8T2.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-BY4aA8T2.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-CNZPv3__.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-CNZPv3__.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-DXCVbTGi.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-DXCVbTGi.js';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -961,16 +961,10 @@ interface UseLimitsReturn {
      * should treat `true` as "needs the activation flow", not "exhausted".
      */
     activationRequired: boolean | null;
-    /** Access granted under `onExceed: throttle` (legacy plans). `null` while loading. */
-    throttled: boolean | null;
-    /** Access granted and usage past the cap accrues overage. `null` while loading. */
+    /** Access granted past the included cap, paid from prepaid credits. `null` while loading. */
     overage: boolean | null;
     /** Access blocked pending a prepaid top-up. `null` while loading. */
     needsTopUp: boolean | null;
-    /** Access blocked pending an auto-upgrade. `null` while loading. */
-    needsUpgrade: boolean | null;
-    /** The customer was auto-upgraded and access was restored. `null` while loading. */
-    upgraded: boolean | null;
     /**
      * Consumed units this period. `null` while loading, when disabled, or
      * when the backend did not measure a finite cap.

package/dist/index.js

@@ -4,7 +4,7 @@ import {
 import {
   LaunchCustomerPortalButton,
   usePaymentMethod
-} from "./chunk-P4PPMKIK.js";
+} from "./chunk-BI5MJT24.js";
 import {
   ActivationFlow,
   AutoRecharge,
@@ -20,7 +20,7 @@ import {
   useCheckoutSteps,
   useCreditGate,
   usePaywallResolver
-} from "./chunk-BPF5NFWF.js";
+} from "./chunk-IZPE4LKU.js";
 import {
   AmountPicker,
   BalanceBadge,
@@ -100,7 +100,7 @@ import {
   useTopupAmountSelector,
   useTransport,
   useUsage
-} from "./chunk-MMD6AOUR.js";
+} from "./chunk-67GJCZZU.js";
 import {
   createAnonymousAuthAdapter,
   defaultAuthAdapter,

package/dist/mcp/index.cjs

@@ -1185,11 +1185,8 @@ function createHttpTransport(config) {
         remaining: data.remaining,
         meterName: data.meterName ?? null,
         activationRequired: data.activationRequired ?? false,
-        throttled: data.throttled,
         overage: data.overage,
         needsTopUp: data.needsTopUp,
-        needsUpgrade: data.needsUpgrade,
-        upgraded: data.upgraded,
         ...data.used !== void 0 ? { used: data.used } : {},
         ...data.limit !== void 0 ? { limit: data.limit } : {}
       };
@@ -1244,7 +1241,8 @@ var enCopy = {
       const period = intervalPhrase(ctx);
       const trial = trialPhrase(ctx);
       const every = period ? ` every ${period}` : "";
-      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time. Payments are processed by SolvaPay.${legalSentence(ctx)}`;
+      const savedCard = ctx.savesPaymentMethod ? ` You also authorize ${ctx.merchant.legalName} to save your card for renewals and failed-payment retries.` : "";
+      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time.${savedCard} Payments are processed by SolvaPay.${legalSentence(ctx)}`;
     },
     oneTime: (ctx) => {
       const product = ctx.product?.name ? ` for ${ctx.product.name}` : "";
@@ -2824,11 +2822,8 @@ function useLimits(options) {
     withinLimits: data?.withinLimits ?? null,
     meterName: data?.meterName ?? null,
     activationRequired: data?.activationRequired ?? null,
-    throttled: data?.throttled ?? null,
     overage: data?.overage ?? null,
     needsTopUp: data?.needsTopUp ?? null,
-    needsUpgrade: data?.needsUpgrade ?? null,
-    upgraded: data?.upgraded ?? null,
     used: data?.used ?? null,
     limit: data?.limit ?? null,
     loading,
@@ -2961,11 +2956,8 @@ function toTransportLimits(limits) {
     remaining: limits.remaining,
     meterName: limits.meterName ?? null,
     activationRequired: limits.activationRequired === true,
-    ...limits.throttled !== void 0 ? { throttled: limits.throttled } : {},
     ...limits.overage !== void 0 ? { overage: limits.overage } : {},
     ...limits.needsTopUp !== void 0 ? { needsTopUp: limits.needsTopUp } : {},
-    ...limits.needsUpgrade !== void 0 ? { needsUpgrade: limits.needsUpgrade } : {},
-    ...limits.upgraded !== void 0 ? { upgraded: limits.upgraded } : {},
     ...limits.used !== void 0 ? { used: limits.used } : {},
     ...limits.limit !== void 0 ? { limit: limits.limit } : {}
   };
@@ -6049,9 +6041,7 @@ function McpAccountView({
     withinLimits: limits.withinLimits,
     activationRequired: limits.activationRequired,
     overage: limits.overage,
-    needsTopUp: limits.needsTopUp,
-    needsUpgrade: limits.needsUpgrade,
-    throttled: limits.throttled
+    needsTopUp: limits.needsTopUp
   } : null;
   const accountState = resolveAccountState({
     loading: loading || Boolean(productRef && limits.loading),
@@ -11142,7 +11132,7 @@ var RecurringPaymentStep = (0, import_react49.memo)(function RecurringPaymentSte
           /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.BusinessDetails.Root, { className: cx2.businessDetails, children: /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.BusinessDetails.Fields, {}) }),
           /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.Error, { className: cx2.error }),
           /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.SubmitButton, { className: cx2.button, children: /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(RecurringChargeCta, { amountMinor, currency, cycle }) }),
-          /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.MandateText, {})
+          /* @__PURE__ */ (0, import_jsx_runtime43.jsx)(PaymentForm.MandateText, { savesPaymentMethod: true })
         ] })
       ] })
     }

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-zYGsspbH.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-6bFVuK7L.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-DUeL64V4.cjs';
+import { U as UsageMeterRootProps } from '../UsageMeter-D2KW08uB.cjs';
 import '@stripe/stripe-js';
 import '../adapters/auth.cjs';
 
@@ -1113,8 +1113,6 @@ interface AccountLimitsLike {
     activationRequired: boolean | null;
     overage: boolean | null;
     needsTopUp: boolean | null;
-    needsUpgrade: boolean | null;
-    throttled: boolean | null;
 }
 interface AccountPurchaseLike {
     planSnapshot?: PlanLike | null;
@@ -1145,7 +1143,7 @@ interface AccountStateInput {
  *   I `overage` (outranks `withinLimits` → not F)
  *   D `needsTopUp` or a usage-based plan that is out of limits
  *   F allowance plan at cap
- *   B / C / E running plan-shape (`throttled` / `needsUpgrade` land here)
+ *   B / C / E running plan-shape
  *   A no plan
  */
 declare function resolveAccountState(input: AccountStateInput): AccountState;

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-B144Vck8.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-CNZPv3__.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-iI9fukd0.js';
+import { U as UsageMeterRootProps } from '../UsageMeter-D54b_WOn.js';
 import '@stripe/stripe-js';
 import '../adapters/auth.js';
 
@@ -1113,8 +1113,6 @@ interface AccountLimitsLike {
     activationRequired: boolean | null;
     overage: boolean | null;
     needsTopUp: boolean | null;
-    needsUpgrade: boolean | null;
-    throttled: boolean | null;
 }
 interface AccountPurchaseLike {
     planSnapshot?: PlanLike | null;
@@ -1145,7 +1143,7 @@ interface AccountStateInput {
  *   I `overage` (outranks `withinLimits` → not F)
  *   D `needsTopUp` or a usage-based plan that is out of limits
  *   F allowance plan at cap
- *   B / C / E running plan-shape (`throttled` / `needsUpgrade` land here)
+ *   B / C / E running plan-shape
  *   A no plan
  */
 declare function resolveAccountState(input: AccountStateInput): AccountState;

package/dist/mcp/index.js

@@ -2,7 +2,7 @@ import {
   ExternalLinkGlyph,
   LaunchCustomerPortalButton,
   paymentMethodCache
-} from "../chunk-P4PPMKIK.js";
+} from "../chunk-BI5MJT24.js";
 import {
   AmountPicker,
   BalanceBadge,
@@ -57,7 +57,7 @@ import {
   useTransport,
   useUsage,
   validateAutoRechargeForm
-} from "../chunk-MMD6AOUR.js";
+} from "../chunk-67GJCZZU.js";
 import "../chunk-UMXOAUW7.js";
 import "../chunk-MLKGABMK.js";
 
@@ -642,11 +642,8 @@ function toTransportLimits(limits) {
     remaining: limits.remaining,
     meterName: limits.meterName ?? null,
     activationRequired: limits.activationRequired === true,
-    ...limits.throttled !== void 0 ? { throttled: limits.throttled } : {},
     ...limits.overage !== void 0 ? { overage: limits.overage } : {},
     ...limits.needsTopUp !== void 0 ? { needsTopUp: limits.needsTopUp } : {},
-    ...limits.needsUpgrade !== void 0 ? { needsUpgrade: limits.needsUpgrade } : {},
-    ...limits.upgraded !== void 0 ? { upgraded: limits.upgraded } : {},
     ...limits.used !== void 0 ? { used: limits.used } : {},
     ...limits.limit !== void 0 ? { limit: limits.limit } : {}
   };
@@ -2715,9 +2712,7 @@ function McpAccountView({
     withinLimits: limits.withinLimits,
     activationRequired: limits.activationRequired,
     overage: limits.overage,
-    needsTopUp: limits.needsTopUp,
-    needsUpgrade: limits.needsUpgrade,
-    throttled: limits.throttled
+    needsTopUp: limits.needsTopUp
   } : null;
   const accountState = resolveAccountState({
     loading: loading || Boolean(productRef && limits.loading),
@@ -3422,7 +3417,7 @@ var RecurringPaymentStep = memo4(function RecurringPaymentStep2({
           /* @__PURE__ */ jsx23(PaymentForm.BusinessDetails.Root, { className: cx2.businessDetails, children: /* @__PURE__ */ jsx23(PaymentForm.BusinessDetails.Fields, {}) }),
           /* @__PURE__ */ jsx23(PaymentForm.Error, { className: cx2.error }),
           /* @__PURE__ */ jsx23(PaymentForm.SubmitButton, { className: cx2.button, children: /* @__PURE__ */ jsx23(RecurringChargeCta, { amountMinor, currency, cycle }) }),
-          /* @__PURE__ */ jsx23(PaymentForm.MandateText, {})
+          /* @__PURE__ */ jsx23(PaymentForm.MandateText, { savesPaymentMethod: true })
         ] })
       ] })
     }

package/dist/primitives/index.cjs

@@ -681,11 +681,8 @@ function createHttpTransport(config) {
         remaining: data.remaining,
         meterName: data.meterName ?? null,
         activationRequired: data.activationRequired ?? false,
-        throttled: data.throttled,
         overage: data.overage,
         needsTopUp: data.needsTopUp,
-        needsUpgrade: data.needsUpgrade,
-        upgraded: data.upgraded,
         ...data.used !== void 0 ? { used: data.used } : {},
         ...data.limit !== void 0 ? { limit: data.limit } : {}
       };
@@ -740,7 +737,8 @@ var enCopy = {
       const period = intervalPhrase(ctx);
       const trial = trialPhrase(ctx);
       const every = period ? ` every ${period}` : "";
-      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time. Payments are processed by SolvaPay.${legalSentence(ctx)}`;
+      const savedCard = ctx.savesPaymentMethod ? ` You also authorize ${ctx.merchant.legalName} to save your card for renewals and failed-payment retries.` : "";
+      return `By subscribing, you authorize ${ctx.merchant.legalName} to charge ${ctx.amountFormatted}${every}${trial} until you cancel. You can cancel any time.${savedCard} Payments are processed by SolvaPay.${legalSentence(ctx)}`;
     },
     oneTime: (ctx) => {
       const product = ctx.product?.name ? ` for ${ctx.product.name}` : "";
@@ -9913,11 +9911,8 @@ function useLimits(options) {
     withinLimits: data?.withinLimits ?? null,
     meterName: data?.meterName ?? null,
     activationRequired: data?.activationRequired ?? null,
-    throttled: data?.throttled ?? null,
     overage: data?.overage ?? null,
     needsTopUp: data?.needsTopUp ?? null,
-    needsUpgrade: data?.needsUpgrade ?? null,
-    upgraded: data?.upgraded ?? null,
     used: data?.used ?? null,
     limit: data?.limit ?? null,
     loading,

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-zYGsspbH.cjs';
-export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-zYGsspbH.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-6bFVuK7L.cjs';
+export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-6bFVuK7L.cjs';
 import { TaxBreakdown, BusinessDetailsInput } from '@solvapay/core';
-import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-BTZxR-Le.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-BTZxR-Le.cjs';
+import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-CI48gWSF.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-CI48gWSF.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-DUeL64V4.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-D2KW08uB.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-B144Vck8.js';
-export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-B144Vck8.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-CNZPv3__.js';
+export { B as BootstrapPlanLike, E as CheckoutStep, O as SuccessMeta } from '../useUsage-CNZPv3__.js';
 import { TaxBreakdown, BusinessDetailsInput } from '@solvapay/core';
-import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-BY4aA8T2.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-BY4aA8T2.js';
+import { A as AutoRechargeInputPayload, F as AmountInputUnit, G as AutoRechargeFormState, l as PaywallStructuredContent } from '../index-DXCVbTGi.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-DXCVbTGi.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-iI9fukd0.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-D54b_WOn.js';
 import '../adapters/auth.js';
 
 type PlanPricingOption = {

package/dist/primitives/index.js

@@ -89,7 +89,7 @@ import {
   useCreditGate,
   usePaywallNotice,
   usePurchaseGate
-} from "../chunk-BPF5NFWF.js";
+} from "../chunk-IZPE4LKU.js";
 import {
   AmountPicker,
   AmountPickerConfirm,
@@ -175,7 +175,7 @@ import {
   usePlanSelector,
   useTopupForm,
   useUsageMeter
-} from "../chunk-MMD6AOUR.js";
+} from "../chunk-67GJCZZU.js";
 import "../chunk-UMXOAUW7.js";
 import "../chunk-MLKGABMK.js";
 export {

package/dist/{useUsage-zYGsspbH.d.cts → useUsage-6bFVuK7L.d.cts}

@@ -323,12 +323,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'top_up';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -339,12 +336,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -358,17 +354,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -519,12 +504,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'top_up';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -535,12 +517,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -554,17 +535,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -667,7 +637,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'not_credit_drawn' | 'within_included';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -911,11 +881,9 @@ interface components {
              * @example requests
              */
             meterName?: string;
-            /** @description Access is blocked pending an auto-recharge top-up of the prepaid balance — `onExceed: top_up`. */
+            /** @description Access is blocked until prepaid credits cover the next unit — past an included cap with `onExceed: top_up`, or from the first unit on a recurring meter with no limit. */
             needsTopUp?: boolean;
-            /** @description Access is blocked pending a plan switch to the limit's target pricing — `onExceed: auto_upgrade`. */
-            needsUpgrade?: boolean;
-            /** @description Access is granted and usage beyond the included cap accrues an overage charge — `onExceed: charge`. */
+            /** @description Access is granted past the included cap and the usage is paid from prepaid credits — `onExceed: top_up`. */
             overage?: boolean;
             /**
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
@@ -937,10 +905,6 @@ interface components {
              * @example 997
              */
             remaining: number;
-            /** @description Access is granted but the caller should degrade/throttle service — the limit was exceeded with `onExceed: throttle`. */
-            throttled?: boolean;
-            /** @description The customer was auto-upgraded to the target pricing to restore access — `onExceed: auto_upgrade` succeeded. */
-            upgraded?: boolean;
             /** @description Consumed usage units this period. Present only when the backend measured a finite cap. */
             used?: number;
             /**
@@ -1008,12 +972,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'top_up';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -1024,12 +985,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1043,17 +1003,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -1924,12 +1873,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'top_up';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -1940,12 +1886,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1959,17 +1904,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -3879,12 +3813,11 @@ type PurchaseInfo = components['schemas']['SdkPurchaseResponse'];
 /**
  * `LimitResponse` plus a deprecated SDK-only `plan` alias.
  *
- * The backend `LimitResponse` now natively carries the `onExceed` outcome flags
- * (`throttled` / `overage` / `needsTopUp` / `needsUpgrade` / `upgraded`, resolved
- * by `decideLimit`), so they flow through from `generated.ts`. `throttled` /
- * `overage` ride the allow path (`withinLimits: true`) so a protected handler
- * can read them from `decision.limits` and degrade service or note overage; the
- * others accompany a gate outcome.
+ * The backend `LimitResponse` carries the `onExceed` outcome flags
+ * (`overage` / `needsTopUp`, resolved by `decideLimit`), so they flow
+ * through from `generated.ts`. `overage` rides the allow path
+ * (`withinLimits: true`) so a protected handler can read it from
+ * `decision.limits`; `needsTopUp` accompanies a gate outcome.
  *
  * Read `planRef` for the active plan. `plan` is never populated by the
  * backend — it remains optional so older fixtures and callers still type-check.
@@ -4632,16 +4565,10 @@ interface TransportLimitsResult {
      * auto-allocated.
      */
     activationRequired: boolean;
-    /** Access granted under `onExceed: throttle` (legacy plans). */
-    throttled?: boolean;
-    /** Access granted and usage past the cap accrues overage. */
+    /** Access granted past the included cap, paid from prepaid credits. */
     overage?: boolean;
     /** Access blocked pending a prepaid top-up. */
     needsTopUp?: boolean;
-    /** Access blocked pending an auto-upgrade to the target plan. */
-    needsUpgrade?: boolean;
-    /** The customer was auto-upgraded and access was restored. */
-    upgraded?: boolean;
     /**
      * Consumed units this period. Present only when the backend measured
      * a finite cap. Authoritative — do not reconstruct from
@@ -5290,7 +5217,7 @@ interface Plan {
     measures?: string;
     /** @deprecated Not sent by the API. Use the `limit` option's `cap`. */
     limit?: number;
-    /** @deprecated Not sent by the API. Use the presence of a `rollover` option. */
+    /** @deprecated Not sent by the API. Rollover is not a plan option. */
     rolloverUnusedUnits?: boolean;
     limits?: Record<string, unknown>;
     features?: Record<string, unknown> | string[];

package/dist/{useUsage-B144Vck8.d.ts → useUsage-CNZPv3__.d.ts}

@@ -323,12 +323,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'top_up';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -339,12 +336,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -358,17 +354,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -519,12 +504,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'top_up';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -535,12 +517,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -554,17 +535,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -667,7 +637,7 @@ interface components {
              * @example duplicate
              * @enum {string}
              */
-            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'plan_billed_at_period_end';
+            reason: 'duplicate' | 'no_product_ref' | 'customer_not_found' | 'no_active_purchase' | 'plan_not_credit_based' | 'not_credit_drawn' | 'within_included';
         };
         CreditDebitSuccessResponse: {
             /**
@@ -911,11 +881,9 @@ interface components {
              * @example requests
              */
             meterName?: string;
-            /** @description Access is blocked pending an auto-recharge top-up of the prepaid balance — `onExceed: top_up`. */
+            /** @description Access is blocked until prepaid credits cover the next unit — past an included cap with `onExceed: top_up`, or from the first unit on a recurring meter with no limit. */
             needsTopUp?: boolean;
-            /** @description Access is blocked pending a plan switch to the limit's target pricing — `onExceed: auto_upgrade`. */
-            needsUpgrade?: boolean;
-            /** @description Access is granted and usage beyond the included cap accrues an overage charge — `onExceed: charge`. */
+            /** @description Access is granted past the included cap and the usage is paid from prepaid credits — `onExceed: top_up`. */
             overage?: boolean;
             /**
              * Authoritative paywall classification shared with Managed MCP. Present on denial responses only.
@@ -937,10 +905,6 @@ interface components {
              * @example 997
              */
             remaining: number;
-            /** @description Access is granted but the caller should degrade/throttle service — the limit was exceeded with `onExceed: throttle`. */
-            throttled?: boolean;
-            /** @description The customer was auto-upgraded to the target pricing to restore access — `onExceed: auto_upgrade` succeeded. */
-            upgraded?: boolean;
             /** @description Consumed usage units this period. Present only when the backend measured a finite cap. */
             used?: number;
             /**
@@ -1008,12 +972,9 @@ interface components {
                     label?: string;
                     meter: string;
                     /** @enum {string} */
-                    onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                    onExceedPricingId?: string;
+                    onExceed: 'block' | 'top_up';
                     /** @enum {string} */
                     scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                    /** @enum {string} */
-                    uiHint?: 'upgrade_prompt' | 'soft_warning';
                     windowDays?: number;
                 } | {
                     feature: string;
@@ -1024,12 +985,11 @@ interface components {
                     value: boolean | number | string;
                 } | {
                     days: number;
-                    downgradeToPricingId?: string;
                     /** @enum {string} */
                     kind: 'trial';
                     label?: string;
                     /** @enum {string} */
-                    onEnd: 'convert' | 'cancel' | 'downgrade';
+                    onEnd: 'convert' | 'cancel';
                 } | {
                     /** @enum {string} */
                     appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1043,17 +1003,6 @@ interface components {
                     /** @enum {string} */
                     mode: 'percentage' | 'fixed';
                     value: number;
-                } | {
-                    capUnits?: number;
-                    currency?: string;
-                    /** @enum {string} */
-                    kind: 'rollover';
-                    label?: string;
-                    maxCycles?: number;
-                    meter: string;
-                    rateMinor?: number;
-                    /** @enum {string} */
-                    treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
                 } | {
                     /** @enum {string} */
                     kind: 'autoAssigned';
@@ -1924,12 +1873,9 @@ interface components {
                 label?: string;
                 meter: string;
                 /** @enum {string} */
-                onExceed: 'block' | 'throttle' | 'charge' | 'notify' | 'top_up' | 'auto_upgrade';
-                onExceedPricingId?: string;
+                onExceed: 'block' | 'top_up';
                 /** @enum {string} */
                 scope: 'billing_period' | 'lifetime' | 'rolling_window';
-                /** @enum {string} */
-                uiHint?: 'upgrade_prompt' | 'soft_warning';
                 windowDays?: number;
             } | {
                 feature: string;
@@ -1940,12 +1886,11 @@ interface components {
                 value: boolean | number | string;
             } | {
                 days: number;
-                downgradeToPricingId?: string;
                 /** @enum {string} */
                 kind: 'trial';
                 label?: string;
                 /** @enum {string} */
-                onEnd: 'convert' | 'cancel' | 'downgrade';
+                onEnd: 'convert' | 'cancel';
             } | {
                 /** @enum {string} */
                 appliesTo?: 'recurring' | 'setup' | 'usage' | 'all';
@@ -1959,17 +1904,6 @@ interface components {
                 /** @enum {string} */
                 mode: 'percentage' | 'fixed';
                 value: number;
-            } | {
-                capUnits?: number;
-                currency?: string;
-                /** @enum {string} */
-                kind: 'rollover';
-                label?: string;
-                maxCycles?: number;
-                meter: string;
-                rateMinor?: number;
-                /** @enum {string} */
-                treatment: 'forfeit' | 'carry_forward' | 'credit_units' | 'credit_money';
             } | {
                 /** @enum {string} */
                 kind: 'autoAssigned';
@@ -3879,12 +3813,11 @@ type PurchaseInfo = components['schemas']['SdkPurchaseResponse'];
 /**
  * `LimitResponse` plus a deprecated SDK-only `plan` alias.
  *
- * The backend `LimitResponse` now natively carries the `onExceed` outcome flags
- * (`throttled` / `overage` / `needsTopUp` / `needsUpgrade` / `upgraded`, resolved
- * by `decideLimit`), so they flow through from `generated.ts`. `throttled` /
- * `overage` ride the allow path (`withinLimits: true`) so a protected handler
- * can read them from `decision.limits` and degrade service or note overage; the
- * others accompany a gate outcome.
+ * The backend `LimitResponse` carries the `onExceed` outcome flags
+ * (`overage` / `needsTopUp`, resolved by `decideLimit`), so they flow
+ * through from `generated.ts`. `overage` rides the allow path
+ * (`withinLimits: true`) so a protected handler can read it from
+ * `decision.limits`; `needsTopUp` accompanies a gate outcome.
  *
  * Read `planRef` for the active plan. `plan` is never populated by the
  * backend — it remains optional so older fixtures and callers still type-check.
@@ -4632,16 +4565,10 @@ interface TransportLimitsResult {
      * auto-allocated.
      */
     activationRequired: boolean;
-    /** Access granted under `onExceed: throttle` (legacy plans). */
-    throttled?: boolean;
-    /** Access granted and usage past the cap accrues overage. */
+    /** Access granted past the included cap, paid from prepaid credits. */
     overage?: boolean;
     /** Access blocked pending a prepaid top-up. */
     needsTopUp?: boolean;
-    /** Access blocked pending an auto-upgrade to the target plan. */
-    needsUpgrade?: boolean;
-    /** The customer was auto-upgraded and access was restored. */
-    upgraded?: boolean;
     /**
      * Consumed units this period. Present only when the backend measured
      * a finite cap. Authoritative — do not reconstruct from
@@ -5290,7 +5217,7 @@ interface Plan {
     measures?: string;
     /** @deprecated Not sent by the API. Use the `limit` option's `cap`. */
     limit?: number;
-    /** @deprecated Not sent by the API. Use the presence of a `rollover` option. */
+    /** @deprecated Not sent by the API. Rollover is not a plan option. */
     rolloverUnusedUnits?: boolean;
     limits?: Record<string, unknown>;
     features?: Record<string, unknown> | string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/react",
-  "version": "2.4.0",
+  "version": "2.5.0-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65",
   "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.6-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65",
     "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.5",
-    "@solvapay/server": "2.8.0",
+    "@solvapay/mcp-core": "0.4.6-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65",
+    "@solvapay/server": "2.9.0-preview-0b7998345be4ea7f15666fa77c72ea02a914ea65",
     "@solvapay/test-utils": "0.0.0"
   },
   "scripts": {