@solvapay/react 2.1.1 → 2.2.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79

package/dist/index.d.cts

@@ -1,14 +1,14 @@
 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, 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, B as BalanceStatus, q as UseTopupAmountSelectorOptions, r as UseTopupAmountSelectorReturn, s as UsePaymentMethodReturn, t as AutoRechargeConfig, u as SaveAutoRechargeInput, v as SolvaPayTransport, w as PartialSolvaPayCopy, x as PurchaseInfo, y as Product, z as SolvaPayConfig } from './shared-D0hmT1qU.cjs';
-export { D as BootstrapPlanLike, 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 } from './shared-D0hmT1qU.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-SylJb9Rh.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 UsageSnapshot, x as UseCheckoutFlowOptions, y as UseCheckoutFlowReturn, z as UseUsageReturn, D as configToAutoRechargeInput, E as deriveVariant, F as useCheckoutFlow, G as useCheckoutStepsContext, H as useUsage } from './index-SylJb9Rh.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-CTgRBvFK.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-CTgRBvFK.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-BJGjKUtC.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-BJGjKUtC.cjs';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { AuthAdapter, createAnonymousAuthAdapter, defaultAuthAdapter, getOrCreateAnonymousCustomerRef, resetAnonymousCustomerRef } from './adapters/auth.cjs';
 export { SessionAuthAdapterOptions, createSessionAuthAdapter } from './adapters/session-auth.cjs';
 import '@stripe/react-stripe-js';
-import 'react/jsx-runtime';
 
 /**
  * SolvaPay Provider - Headless Context Provider for React.
@@ -58,8 +58,8 @@ declare const SolvaPayProvider: React.FC<SolvaPayProviderProps>;
  *
  * Consumers who just want a drop-in payment form use this component. It
  * renders the primitive's Root with a golden-path default tree composed of
- * `PaymentForm.Summary`, `CustomerFields`, `PaymentElement`, `MandateText`,
- * an optional `TermsCheckbox`, and `SubmitButton`. Free-plan activation
+ * `PaymentForm.Summary`, `CustomerFields`, `PaymentElement`, an optional
+ * `TermsCheckbox`, `SubmitButton`, and `MandateText`. Free-plan activation
  * flows through the same composition — `FreeInner` in the primitive swaps
  * the submit handler so the default tree works identically for paid and
  * free plans.
@@ -305,6 +305,8 @@ interface CurrentPlanCardClassNames {
     usageMeter?: string;
     paymentMethod?: string;
     actions?: string;
+    /** Small muted caption above a value when `showFieldLabels` is set. */
+    fieldLabel?: string;
     /** Embedded pending-cancellation notice + reactivate CTA. */
     cancelledNotice?: string;
 }
@@ -351,6 +353,17 @@ interface CurrentPlanCardProps {
      * Hosted-page parity for the MCP account surface.
      */
     showReference?: boolean;
+    /**
+     * Caption the price/rate and balance values with a field label
+     * ("Rate", "Balance"). Default: `false`. Those lines are bare
+     * numbers otherwise, which read alike on a surface that shows both.
+     */
+    showFieldLabels?: boolean;
+    /**
+     * Live catalog plans. Used to format a PAYG usage rate when the
+     * frozen snapshot has no `options[]`.
+     */
+    plans?: readonly CatalogPlanLike[];
     /** Per-element classNames. */
     classNames?: CurrentPlanCardClassNames;
     /**
@@ -359,6 +372,20 @@ interface CurrentPlanCardProps {
      */
     className?: string;
 }
+/**
+ * Structural catalog / snapshot subset `formatPaygRate` can read.
+ * Wider than `BootstrapPlanLike` so MCP `PlanLike` (which allows `null`
+ * on optional fields) is assignable without a cast.
+ */
+interface CatalogPlanLike {
+    reference?: string | null;
+    name?: string;
+    options?: BootstrapPlanLike['options'] | null;
+    price?: number | null;
+    currency?: string | null;
+    requiresPayment?: boolean | null;
+    isMetered?: boolean | null;
+}
 declare const CurrentPlanCard: React.FC<CurrentPlanCardProps>;
 
 type AutoRechargeProps = {
@@ -381,17 +408,18 @@ declare function AutoRecharge({ currency, defaultThresholdAmountMajor, defaultTo
  * Render-eager: the button is enabled and labelled from the first paint
  * regardless of session state. The portal session URL is fetched in the
  * background through `useCustomerSessionUrl()` (a single in-flight call
- * shared across every instance under the same transport). When the URL
- * is ready, click is a synchronous `<a target="_blank">` navigation —
- * which MCP host sandboxes permit even though scripted `window.open`
- * after an async round-trip is blocked.
- *
- * If the user clicks before the URL has resolved, the click handler
- * awaits the in-flight fetch and falls back to `window.open` (works on
- * hosts that don't sandbox scripted opens, e.g. ChatGPT). On Claude the
- * sandbox silently drops the open in that race; the cache-hit path
- * remains the optimal one and is the steady state for any user that
- * doesn't click within a few hundred ms of opening the surface.
+ * shared across every instance under the same transport).
+ *
+ * Opening the portal always goes through `useExternalLink`, which
+ * prefers the host's `ui/open-link` when one is mounted and otherwise
+ * lets the browser navigate. That distinction matters inside MCP hosts:
+ * Claude's iframe sandbox omits `allow-popups`, so both a bare
+ * `<a target="_blank">` and `window.open()` are dropped without an
+ * error — the button looks alive and does nothing.
+ *
+ * If the user clicks before the URL has resolved, the handler awaits
+ * the in-flight fetch and then opens the resolved URL through the same
+ * path, flipping to the error state if the open is refused.
  */
 
 interface LaunchCustomerPortalButtonProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'target' | 'rel' | 'onError'> {
@@ -761,7 +789,7 @@ interface UseActivationReturn {
     activate: (params: {
         productRef: string;
         planRef: string;
-    }) => Promise<void>;
+    }) => Promise<ActivationState>;
     state: ActivationState;
     error: string | null;
     result: ActivatePlanResult | null;
@@ -942,6 +970,16 @@ interface UseLimitsReturn {
     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.
+     */
+    used: number | null;
+    /**
+     * The effective finite cap for this meter. `null` while loading, when
+     * disabled, or when the backend did not measure a finite cap.
+     */
+    limit: number | null;
     loading: boolean;
     error: Error | null;
     refetch: () => Promise<void>;
@@ -1001,6 +1039,43 @@ interface UsePaywallResolverReturn {
 }
 declare function usePaywallResolver(content: PaywallStructuredContent): UsePaywallResolverReturn;
 
+interface ExternalLinkOpener {
+    /**
+     * Whether the host can open links right now. Read synchronously from
+     * the click handler, because suppressing native navigation on a host
+     * that *cannot* open links would turn a working link into a dead one
+     * — so `preventDefault()` is gated on this returning `true`.
+     */
+    canOpen: () => boolean;
+    /**
+     * Hand `url` to the host. Resolves `false` when the host refused
+     * (blocked domain, user cancelled) or the request failed, so callers
+     * can surface the dead end instead of leaving the user guessing.
+     */
+    open: (url: string) => Promise<boolean>;
+}
+interface ExternalLinkProviderProps {
+    opener: ExternalLinkOpener;
+    children: React.ReactNode;
+}
+declare function ExternalLinkProvider({ opener, children }: ExternalLinkProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Imperative opener for flows that only learn the URL after an `await`,
+ * where there is no anchor left to click (the portal button's
+ * cache-miss path). Prefers the host, otherwise asks the browser.
+ *
+ * Resolves `false` only when a host-mediated open was attempted and
+ * refused. The browser path reports `true` because it cannot be
+ * verified: `window.open` with `noopener` returns `null` on success by
+ * spec, so a null handle says nothing about whether the tab opened.
+ */
+declare function useOpenExternal(): (url: string) => Promise<boolean>;
+/**
+ * `onClick` for any `<a href target="_blank">` the SDK renders. A no-op
+ * when no host opener is mounted, which leaves the browser to navigate.
+ */
+declare function useExternalLinkClick(): (event: React.MouseEvent<HTMLAnchorElement>) => void;
+
 type CopyContextValue = {
     locale?: string;
     copy: SolvaPayCopy;
@@ -1164,6 +1239,18 @@ declare function resolveCta(input: ResolveCtaInput): string;
  * Use `'payment-element'` with `PaymentForm.PaymentElement`.
  */
 type ConfirmPaymentMode = 'payment-element' | 'card-element';
+type ConfirmBillingDetails = {
+    email?: string;
+    name?: string;
+    address?: {
+        line1?: string;
+        line2?: string;
+        city?: string;
+        state?: string;
+        postal_code?: string;
+        country?: string;
+    };
+};
 type ConfirmPaymentInput = {
     stripe: Stripe;
     elements: StripeElements;
@@ -1174,11 +1261,8 @@ type ConfirmPaymentInput = {
      */
     mode?: ConfirmPaymentMode;
     returnUrl: string;
-    /** Billing details from `useCustomer()` (echoed from backend). */
-    billingDetails?: {
-        email?: string;
-        name?: string;
-    };
+    /** Billing details from `useCustomer()` plus the SolvaPay-owned address. */
+    billingDetails?: ConfirmBillingDetails;
     /**
      * When true, skip the browser redirect during PaymentElement confirmation
      * and resolve only if the intent finishes synchronously. This is what
@@ -1255,7 +1339,8 @@ declare const DEFAULT_ROUTES: {
     readonly autoRecharge: "/api/auto-recharge";
     readonly getUsage: "/api/usage";
     readonly getLimits: "/api/limits";
+    readonly getHistory: "/api/history";
 };
 declare function createHttpTransport(config: SolvaPayConfig | undefined): SolvaPayTransport;
 
-export { ActivatePlanResult, ActivationFlow, type ActivationFlowProps, ActivationResult, type ActivationState, AmountPicker, type AmountPickerProps, AutoRecharge, type AutoRechargeProps, BalanceStatus, CancelResult, CancelledPlanNotice, type CancelledPlanNoticeProps, CheckoutLayout, type CheckoutLayoutPlanSelectorOptions, type CheckoutLayoutProps, type CheckoutLayoutSize, CheckoutResult, CheckoutVariant, type ConfirmPaymentInput, type ConfirmPaymentMode, type ConfirmPaymentResult, CopyContext, CopyProvider, CreditGate, type CreditGateProps, CurrentPlanCard, type CurrentPlanCardClassNames, type CurrentPlanCardProps, type CustomerInfo, DEFAULT_ROUTES, type FormatPriceOptions, LaunchCustomerPortalButton, type LaunchCustomerPortalButtonProps, PartialSolvaPayCopy, type PaymentElementKind, PaymentForm, PaymentFormContext, type PaymentFormContextValue, PaymentFormProps, PaymentFormProvider, Plan, PlanSelector, type PlanSelectorProps, PrefillCustomer, Product, type PurchaseActions, PurchaseInfo, PurchaseStatus, PurchaseStatusReturn, ReactivateResult, SolvaPayConfig, SolvaPayContextValue, SolvaPayCopy, SolvaPayProvider, SolvaPayProviderProps, SolvaPayTransport, Spinner, StripePaymentFormWrapper, type StripePaymentFormWrapperProps, TopupForm, TopupFormProps, UpdatePaymentMethodButton, type UpdatePaymentMethodButtonMode, type UpdatePaymentMethodButtonProps, type UseActivationReturn, type UseAutoActivateFreePlanOptions, type UseAutoActivateFreePlanReturn, type UseLimitsOptions, type UseLimitsReturn, UseMerchantReturn, UsePaymentMethodReturn, type UsePaywallResolverReturn, UsePlanOptions, UsePlanReturn, UsePlansOptions, UsePlansReturn, UseProductReturn, UseTopupAmountSelectorOptions, UseTopupAmountSelectorReturn, UseTopupOptions, UseTopupReturn, confirmPayment, createHttpTransport, enCopy, filterPurchases, formatPrice, getActivePurchases, getCancelledPurchasesWithEndDate, getMinorUnitsPerMajor, getMostRecentPurchase, getPrimaryPurchase, interpolate, isPaidPurchase, isPlanPurchase, isTopupPurchase, isUnlimited, mergeCopy, readPaymentIntentClientSecret, resolveCta, stripPaymentIntentParams, toMajorUnits, useActivation, useAutoActivateFreePlan, useAutoRecharge, useBalance, useCheckout, useCopy, useCustomer, useLimits, useLocale, useMerchant, usePaymentForm, usePaymentMethod, usePaywallResolver, usePlan, usePlans, useProduct, usePurchase, usePurchaseActions, usePurchaseStatus, useSolvaPay, useTopup, useTopupAmountSelector, useTransport };
+export { ActivatePlanResult, ActivationFlow, type ActivationFlowProps, ActivationResult, type ActivationState, AmountPicker, type AmountPickerProps, AutoRecharge, type AutoRechargeProps, BalanceStatus, BootstrapPlanLike, CancelResult, CancelledPlanNotice, type CancelledPlanNoticeProps, CheckoutLayout, type CheckoutLayoutPlanSelectorOptions, type CheckoutLayoutProps, type CheckoutLayoutSize, CheckoutResult, CheckoutVariant, type ConfirmPaymentInput, type ConfirmPaymentMode, type ConfirmPaymentResult, CopyContext, CopyProvider, CreditGate, type CreditGateProps, CurrentPlanCard, type CurrentPlanCardClassNames, type CurrentPlanCardProps, type CustomerInfo, DEFAULT_ROUTES, type ExternalLinkOpener, ExternalLinkProvider, type ExternalLinkProviderProps, type FormatPriceOptions, LaunchCustomerPortalButton, type LaunchCustomerPortalButtonProps, PartialSolvaPayCopy, type PaymentElementKind, PaymentForm, PaymentFormContext, type PaymentFormContextValue, PaymentFormProps, PaymentFormProvider, Plan, PlanSelector, type PlanSelectorProps, PrefillCustomer, Product, type PurchaseActions, PurchaseInfo, PurchaseStatus, PurchaseStatusReturn, ReactivateResult, SolvaPayConfig, SolvaPayContextValue, SolvaPayCopy, SolvaPayProvider, SolvaPayProviderProps, SolvaPayTransport, Spinner, StripePaymentFormWrapper, type StripePaymentFormWrapperProps, TopupForm, TopupFormProps, UpdatePaymentMethodButton, type UpdatePaymentMethodButtonMode, type UpdatePaymentMethodButtonProps, type UseActivationReturn, type UseAutoActivateFreePlanOptions, type UseAutoActivateFreePlanReturn, type UseLimitsOptions, type UseLimitsReturn, UseMerchantReturn, UsePaymentMethodReturn, type UsePaywallResolverReturn, UsePlanOptions, UsePlanReturn, UsePlansOptions, UsePlansReturn, UseProductReturn, UseTopupAmountSelectorOptions, UseTopupAmountSelectorReturn, UseTopupOptions, UseTopupReturn, confirmPayment, createHttpTransport, enCopy, filterPurchases, formatPrice, getActivePurchases, getCancelledPurchasesWithEndDate, getMinorUnitsPerMajor, getMostRecentPurchase, getPrimaryPurchase, interpolate, isPaidPurchase, isPlanPurchase, isTopupPurchase, isUnlimited, mergeCopy, readPaymentIntentClientSecret, resolveCta, stripPaymentIntentParams, toMajorUnits, useActivation, useAutoActivateFreePlan, useAutoRecharge, useBalance, useCheckout, useCopy, useCustomer, useExternalLinkClick, useLimits, useLocale, useMerchant, useOpenExternal, usePaymentForm, usePaymentMethod, usePaywallResolver, usePlan, usePlans, useProduct, usePurchase, usePurchaseActions, usePurchaseStatus, useSolvaPay, useTopup, useTopupAmountSelector, useTransport };

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 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, 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, B as BalanceStatus, q as UseTopupAmountSelectorOptions, r as UseTopupAmountSelectorReturn, s as UsePaymentMethodReturn, t as AutoRechargeConfig, u as SaveAutoRechargeInput, v as SolvaPayTransport, w as PartialSolvaPayCopy, x as PurchaseInfo, y as Product, z as SolvaPayConfig } from './shared-CUl6mTC1.js';
-export { D as BootstrapPlanLike, 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 } from './shared-CUl6mTC1.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-CBWGkBqF.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 UsageSnapshot, x as UseCheckoutFlowOptions, y as UseCheckoutFlowReturn, z as UseUsageReturn, D as configToAutoRechargeInput, E as deriveVariant, F as useCheckoutFlow, G as useCheckoutStepsContext, H as useUsage } from './index-CBWGkBqF.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-CMqxEF9d.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-CMqxEF9d.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-PsjS_d7V.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-PsjS_d7V.js';
 import { PaymentIntent, Stripe, StripeElements } from '@stripe/stripe-js';
 import { BusinessDetailsInput, TaxBreakdown } from '@solvapay/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { AuthAdapter, createAnonymousAuthAdapter, defaultAuthAdapter, getOrCreateAnonymousCustomerRef, resetAnonymousCustomerRef } from './adapters/auth.js';
 export { SessionAuthAdapterOptions, createSessionAuthAdapter } from './adapters/session-auth.js';
 import '@stripe/react-stripe-js';
-import 'react/jsx-runtime';
 
 /**
  * SolvaPay Provider - Headless Context Provider for React.
@@ -58,8 +58,8 @@ declare const SolvaPayProvider: React.FC<SolvaPayProviderProps>;
  *
  * Consumers who just want a drop-in payment form use this component. It
  * renders the primitive's Root with a golden-path default tree composed of
- * `PaymentForm.Summary`, `CustomerFields`, `PaymentElement`, `MandateText`,
- * an optional `TermsCheckbox`, and `SubmitButton`. Free-plan activation
+ * `PaymentForm.Summary`, `CustomerFields`, `PaymentElement`, an optional
+ * `TermsCheckbox`, `SubmitButton`, and `MandateText`. Free-plan activation
  * flows through the same composition — `FreeInner` in the primitive swaps
  * the submit handler so the default tree works identically for paid and
  * free plans.
@@ -305,6 +305,8 @@ interface CurrentPlanCardClassNames {
     usageMeter?: string;
     paymentMethod?: string;
     actions?: string;
+    /** Small muted caption above a value when `showFieldLabels` is set. */
+    fieldLabel?: string;
     /** Embedded pending-cancellation notice + reactivate CTA. */
     cancelledNotice?: string;
 }
@@ -351,6 +353,17 @@ interface CurrentPlanCardProps {
      * Hosted-page parity for the MCP account surface.
      */
     showReference?: boolean;
+    /**
+     * Caption the price/rate and balance values with a field label
+     * ("Rate", "Balance"). Default: `false`. Those lines are bare
+     * numbers otherwise, which read alike on a surface that shows both.
+     */
+    showFieldLabels?: boolean;
+    /**
+     * Live catalog plans. Used to format a PAYG usage rate when the
+     * frozen snapshot has no `options[]`.
+     */
+    plans?: readonly CatalogPlanLike[];
     /** Per-element classNames. */
     classNames?: CurrentPlanCardClassNames;
     /**
@@ -359,6 +372,20 @@ interface CurrentPlanCardProps {
      */
     className?: string;
 }
+/**
+ * Structural catalog / snapshot subset `formatPaygRate` can read.
+ * Wider than `BootstrapPlanLike` so MCP `PlanLike` (which allows `null`
+ * on optional fields) is assignable without a cast.
+ */
+interface CatalogPlanLike {
+    reference?: string | null;
+    name?: string;
+    options?: BootstrapPlanLike['options'] | null;
+    price?: number | null;
+    currency?: string | null;
+    requiresPayment?: boolean | null;
+    isMetered?: boolean | null;
+}
 declare const CurrentPlanCard: React.FC<CurrentPlanCardProps>;
 
 type AutoRechargeProps = {
@@ -381,17 +408,18 @@ declare function AutoRecharge({ currency, defaultThresholdAmountMajor, defaultTo
  * Render-eager: the button is enabled and labelled from the first paint
  * regardless of session state. The portal session URL is fetched in the
  * background through `useCustomerSessionUrl()` (a single in-flight call
- * shared across every instance under the same transport). When the URL
- * is ready, click is a synchronous `<a target="_blank">` navigation —
- * which MCP host sandboxes permit even though scripted `window.open`
- * after an async round-trip is blocked.
- *
- * If the user clicks before the URL has resolved, the click handler
- * awaits the in-flight fetch and falls back to `window.open` (works on
- * hosts that don't sandbox scripted opens, e.g. ChatGPT). On Claude the
- * sandbox silently drops the open in that race; the cache-hit path
- * remains the optimal one and is the steady state for any user that
- * doesn't click within a few hundred ms of opening the surface.
+ * shared across every instance under the same transport).
+ *
+ * Opening the portal always goes through `useExternalLink`, which
+ * prefers the host's `ui/open-link` when one is mounted and otherwise
+ * lets the browser navigate. That distinction matters inside MCP hosts:
+ * Claude's iframe sandbox omits `allow-popups`, so both a bare
+ * `<a target="_blank">` and `window.open()` are dropped without an
+ * error — the button looks alive and does nothing.
+ *
+ * If the user clicks before the URL has resolved, the handler awaits
+ * the in-flight fetch and then opens the resolved URL through the same
+ * path, flipping to the error state if the open is refused.
  */
 
 interface LaunchCustomerPortalButtonProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href' | 'target' | 'rel' | 'onError'> {
@@ -761,7 +789,7 @@ interface UseActivationReturn {
     activate: (params: {
         productRef: string;
         planRef: string;
-    }) => Promise<void>;
+    }) => Promise<ActivationState>;
     state: ActivationState;
     error: string | null;
     result: ActivatePlanResult | null;
@@ -942,6 +970,16 @@ interface UseLimitsReturn {
     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.
+     */
+    used: number | null;
+    /**
+     * The effective finite cap for this meter. `null` while loading, when
+     * disabled, or when the backend did not measure a finite cap.
+     */
+    limit: number | null;
     loading: boolean;
     error: Error | null;
     refetch: () => Promise<void>;
@@ -1001,6 +1039,43 @@ interface UsePaywallResolverReturn {
 }
 declare function usePaywallResolver(content: PaywallStructuredContent): UsePaywallResolverReturn;
 
+interface ExternalLinkOpener {
+    /**
+     * Whether the host can open links right now. Read synchronously from
+     * the click handler, because suppressing native navigation on a host
+     * that *cannot* open links would turn a working link into a dead one
+     * — so `preventDefault()` is gated on this returning `true`.
+     */
+    canOpen: () => boolean;
+    /**
+     * Hand `url` to the host. Resolves `false` when the host refused
+     * (blocked domain, user cancelled) or the request failed, so callers
+     * can surface the dead end instead of leaving the user guessing.
+     */
+    open: (url: string) => Promise<boolean>;
+}
+interface ExternalLinkProviderProps {
+    opener: ExternalLinkOpener;
+    children: React.ReactNode;
+}
+declare function ExternalLinkProvider({ opener, children }: ExternalLinkProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Imperative opener for flows that only learn the URL after an `await`,
+ * where there is no anchor left to click (the portal button's
+ * cache-miss path). Prefers the host, otherwise asks the browser.
+ *
+ * Resolves `false` only when a host-mediated open was attempted and
+ * refused. The browser path reports `true` because it cannot be
+ * verified: `window.open` with `noopener` returns `null` on success by
+ * spec, so a null handle says nothing about whether the tab opened.
+ */
+declare function useOpenExternal(): (url: string) => Promise<boolean>;
+/**
+ * `onClick` for any `<a href target="_blank">` the SDK renders. A no-op
+ * when no host opener is mounted, which leaves the browser to navigate.
+ */
+declare function useExternalLinkClick(): (event: React.MouseEvent<HTMLAnchorElement>) => void;
+
 type CopyContextValue = {
     locale?: string;
     copy: SolvaPayCopy;
@@ -1164,6 +1239,18 @@ declare function resolveCta(input: ResolveCtaInput): string;
  * Use `'payment-element'` with `PaymentForm.PaymentElement`.
  */
 type ConfirmPaymentMode = 'payment-element' | 'card-element';
+type ConfirmBillingDetails = {
+    email?: string;
+    name?: string;
+    address?: {
+        line1?: string;
+        line2?: string;
+        city?: string;
+        state?: string;
+        postal_code?: string;
+        country?: string;
+    };
+};
 type ConfirmPaymentInput = {
     stripe: Stripe;
     elements: StripeElements;
@@ -1174,11 +1261,8 @@ type ConfirmPaymentInput = {
      */
     mode?: ConfirmPaymentMode;
     returnUrl: string;
-    /** Billing details from `useCustomer()` (echoed from backend). */
-    billingDetails?: {
-        email?: string;
-        name?: string;
-    };
+    /** Billing details from `useCustomer()` plus the SolvaPay-owned address. */
+    billingDetails?: ConfirmBillingDetails;
     /**
      * When true, skip the browser redirect during PaymentElement confirmation
      * and resolve only if the intent finishes synchronously. This is what
@@ -1255,7 +1339,8 @@ declare const DEFAULT_ROUTES: {
     readonly autoRecharge: "/api/auto-recharge";
     readonly getUsage: "/api/usage";
     readonly getLimits: "/api/limits";
+    readonly getHistory: "/api/history";
 };
 declare function createHttpTransport(config: SolvaPayConfig | undefined): SolvaPayTransport;
 
-export { ActivatePlanResult, ActivationFlow, type ActivationFlowProps, ActivationResult, type ActivationState, AmountPicker, type AmountPickerProps, AutoRecharge, type AutoRechargeProps, BalanceStatus, CancelResult, CancelledPlanNotice, type CancelledPlanNoticeProps, CheckoutLayout, type CheckoutLayoutPlanSelectorOptions, type CheckoutLayoutProps, type CheckoutLayoutSize, CheckoutResult, CheckoutVariant, type ConfirmPaymentInput, type ConfirmPaymentMode, type ConfirmPaymentResult, CopyContext, CopyProvider, CreditGate, type CreditGateProps, CurrentPlanCard, type CurrentPlanCardClassNames, type CurrentPlanCardProps, type CustomerInfo, DEFAULT_ROUTES, type FormatPriceOptions, LaunchCustomerPortalButton, type LaunchCustomerPortalButtonProps, PartialSolvaPayCopy, type PaymentElementKind, PaymentForm, PaymentFormContext, type PaymentFormContextValue, PaymentFormProps, PaymentFormProvider, Plan, PlanSelector, type PlanSelectorProps, PrefillCustomer, Product, type PurchaseActions, PurchaseInfo, PurchaseStatus, PurchaseStatusReturn, ReactivateResult, SolvaPayConfig, SolvaPayContextValue, SolvaPayCopy, SolvaPayProvider, SolvaPayProviderProps, SolvaPayTransport, Spinner, StripePaymentFormWrapper, type StripePaymentFormWrapperProps, TopupForm, TopupFormProps, UpdatePaymentMethodButton, type UpdatePaymentMethodButtonMode, type UpdatePaymentMethodButtonProps, type UseActivationReturn, type UseAutoActivateFreePlanOptions, type UseAutoActivateFreePlanReturn, type UseLimitsOptions, type UseLimitsReturn, UseMerchantReturn, UsePaymentMethodReturn, type UsePaywallResolverReturn, UsePlanOptions, UsePlanReturn, UsePlansOptions, UsePlansReturn, UseProductReturn, UseTopupAmountSelectorOptions, UseTopupAmountSelectorReturn, UseTopupOptions, UseTopupReturn, confirmPayment, createHttpTransport, enCopy, filterPurchases, formatPrice, getActivePurchases, getCancelledPurchasesWithEndDate, getMinorUnitsPerMajor, getMostRecentPurchase, getPrimaryPurchase, interpolate, isPaidPurchase, isPlanPurchase, isTopupPurchase, isUnlimited, mergeCopy, readPaymentIntentClientSecret, resolveCta, stripPaymentIntentParams, toMajorUnits, useActivation, useAutoActivateFreePlan, useAutoRecharge, useBalance, useCheckout, useCopy, useCustomer, useLimits, useLocale, useMerchant, usePaymentForm, usePaymentMethod, usePaywallResolver, usePlan, usePlans, useProduct, usePurchase, usePurchaseActions, usePurchaseStatus, useSolvaPay, useTopup, useTopupAmountSelector, useTransport };
+export { ActivatePlanResult, ActivationFlow, type ActivationFlowProps, ActivationResult, type ActivationState, AmountPicker, type AmountPickerProps, AutoRecharge, type AutoRechargeProps, BalanceStatus, BootstrapPlanLike, CancelResult, CancelledPlanNotice, type CancelledPlanNoticeProps, CheckoutLayout, type CheckoutLayoutPlanSelectorOptions, type CheckoutLayoutProps, type CheckoutLayoutSize, CheckoutResult, CheckoutVariant, type ConfirmPaymentInput, type ConfirmPaymentMode, type ConfirmPaymentResult, CopyContext, CopyProvider, CreditGate, type CreditGateProps, CurrentPlanCard, type CurrentPlanCardClassNames, type CurrentPlanCardProps, type CustomerInfo, DEFAULT_ROUTES, type ExternalLinkOpener, ExternalLinkProvider, type ExternalLinkProviderProps, type FormatPriceOptions, LaunchCustomerPortalButton, type LaunchCustomerPortalButtonProps, PartialSolvaPayCopy, type PaymentElementKind, PaymentForm, PaymentFormContext, type PaymentFormContextValue, PaymentFormProps, PaymentFormProvider, Plan, PlanSelector, type PlanSelectorProps, PrefillCustomer, Product, type PurchaseActions, PurchaseInfo, PurchaseStatus, PurchaseStatusReturn, ReactivateResult, SolvaPayConfig, SolvaPayContextValue, SolvaPayCopy, SolvaPayProvider, SolvaPayProviderProps, SolvaPayTransport, Spinner, StripePaymentFormWrapper, type StripePaymentFormWrapperProps, TopupForm, TopupFormProps, UpdatePaymentMethodButton, type UpdatePaymentMethodButtonMode, type UpdatePaymentMethodButtonProps, type UseActivationReturn, type UseAutoActivateFreePlanOptions, type UseAutoActivateFreePlanReturn, type UseLimitsOptions, type UseLimitsReturn, UseMerchantReturn, UsePaymentMethodReturn, type UsePaywallResolverReturn, UsePlanOptions, UsePlanReturn, UsePlansOptions, UsePlansReturn, UseProductReturn, UseTopupAmountSelectorOptions, UseTopupAmountSelectorReturn, UseTopupOptions, UseTopupReturn, confirmPayment, createHttpTransport, enCopy, filterPurchases, formatPrice, getActivePurchases, getCancelledPurchasesWithEndDate, getMinorUnitsPerMajor, getMostRecentPurchase, getPrimaryPurchase, interpolate, isPaidPurchase, isPlanPurchase, isTopupPurchase, isUnlimited, mergeCopy, readPaymentIntentClientSecret, resolveCta, stripPaymentIntentParams, toMajorUnits, useActivation, useAutoActivateFreePlan, useAutoRecharge, useBalance, useCheckout, useCopy, useCustomer, useExternalLinkClick, useLimits, useLocale, useMerchant, useOpenExternal, usePaymentForm, usePaymentMethod, usePaywallResolver, usePlan, usePlans, useProduct, usePurchase, usePurchaseActions, usePurchaseStatus, useSolvaPay, useTopup, useTopupAmountSelector, useTransport };