@solvapay/react 2.1.1 → 2.2.0-preview-11dbbe603cd1b9a44cc41b5eee3686bc4000f97f

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 './shared-BQbMyX5V.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 } from './shared-BQbMyX5V.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-APG9WYgS.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-APG9WYgS.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.
@@ -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'> {
@@ -1001,6 +1029,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;
@@ -1258,4 +1323,4 @@ declare const DEFAULT_ROUTES: {
 };
 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 './shared-DJdsOLag.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 } from './shared-DJdsOLag.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-ofZwGvIZ.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-ofZwGvIZ.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.
@@ -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'> {
@@ -1001,6 +1029,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;
@@ -1258,4 +1323,4 @@ declare const DEFAULT_ROUTES: {
 };
 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.js

@@ -7,7 +7,7 @@ import {
   LaunchCustomerPortalButton,
   UpdatePaymentMethodButton,
   usePaymentMethod
-} from "./chunk-QXNNMNCV.js";
+} from "./chunk-M6O7ZWNP.js";
 import {
   ActivationFlow,
   AutoRecharge,
@@ -23,7 +23,7 @@ import {
   useCheckoutSteps,
   useCreditGate,
   usePaywallResolver
-} from "./chunk-HQH6KSXJ.js";
+} from "./chunk-EWB43JVC.js";
 import {
   AmountPicker,
   BalanceBadge,
@@ -32,6 +32,7 @@ import {
   CopyContext,
   CopyProvider,
   DEFAULT_ROUTES,
+  ExternalLinkProvider,
   MandateText,
   PaymentForm,
   PaymentFormBusinessDetails,
@@ -82,9 +83,11 @@ import {
   useCheckoutFlow,
   useCopy,
   useCustomer,
+  useExternalLinkClick,
   useLimits,
   useLocale,
   useMerchant,
+  useOpenExternal,
   usePaymentForm,
   usePlan,
   usePlans,
@@ -97,7 +100,7 @@ import {
   useTopupAmountSelector,
   useTransport,
   useUsage
-} from "./chunk-LL6AYSTC.js";
+} from "./chunk-WISTNSUH.js";
 import {
   createAnonymousAuthAdapter,
   defaultAuthAdapter,
@@ -874,6 +877,7 @@ export {
   CreditGate2 as CreditGate,
   CurrentPlanCard,
   DEFAULT_ROUTES,
+  ExternalLinkProvider,
   LaunchCustomerPortalButton,
   MandateText,
   PaymentForm2 as PaymentForm,
@@ -925,9 +929,11 @@ export {
   useCheckoutSteps as useCheckoutStepsContext,
   useCopy,
   useCustomer,
+  useExternalLinkClick,
   useLimits,
   useLocale,
   useMerchant,
+  useOpenExternal,
   usePaymentForm,
   usePaymentMethod,
   usePaywallResolver,