@solvapay/react 2.1.1 → 2.2.0-preview-e3e546693c002c32f128d83bf6c5fe76ac182a79

package/dist/{index-CBWGkBqF.d.ts → index-BJGjKUtC.d.cts}

@@ -1,4 +1,4 @@
-import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-CUl6mTC1.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-CTgRBvFK.cjs';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -17,7 +17,36 @@ type LimitActivationProduct = components['schemas']['LimitProductBriefDto'];
 /**
  * Structured content for paywall errors (MCP structuredContent and manual handling).
  */
-type PaywallStructuredContent = {
+/**
+ * Fields shared by every `PaywallStructuredContent` kind so a text-only
+ * host can recover from a gate without a second tool call. Every field
+ * other than `kind` / `product` / `checkoutUrl` / `message` is omitted
+ * when the backend did not send it — never defaulted.
+ */
+type PaywallGateRecoveryFields = {
+    /** Active plan reference from `limits.plan`. */
+    planRef?: string;
+    /** Product plans from `checkLimits` (activation already had this). */
+    plans?: LimitPlanSummary[];
+    /** Meter the gated call was charged against. */
+    meterName?: string;
+    /** Per-unit charge of the active plan, in minor currency units. */
+    unitPriceMinor?: number;
+    /** ISO 4217 currency for `unitPriceMinor`. */
+    currency?: string;
+    /**
+     * Included-usage counters. Omitted when `freeUnits` is absent or `0`
+     * (the unlimited sentinel) so we never emit misleading zeros.
+     */
+    included?: {
+        total: number;
+        used: number;
+        remaining: number;
+    };
+    /** Prepaid credit balance, coalesced from nested or top-level fields. */
+    creditBalance?: number;
+};
+type PaywallStructuredContent = ({
     kind: 'payment_required';
     /** Product ref from paywall metadata (or env default) */
     product: string;
@@ -32,7 +61,7 @@ type PaywallStructuredContent = {
     balance?: LimitActivationBalance;
     /** Rich product context from checkLimits (name, ref, provider slug/id) */
     productDetails?: LimitActivationProduct;
-} | {
+} & PaywallGateRecoveryFields) | ({
     kind: 'activation_required';
     /** Product ref from paywall metadata (or env default) */
     product: string;
@@ -42,11 +71,10 @@ type PaywallStructuredContent = {
      */
     checkoutUrl: string;
     confirmationUrl?: string;
-    plans?: LimitPlanSummary[];
     balance?: LimitActivationBalance;
     /** Rich product context from checkLimits (name, ref, provider slug/id) */
     productDetails?: LimitActivationProduct;
-};
+} & PaywallGateRecoveryFields);
 
 /**
  * Default-tree shim over the `CheckoutSummary` primitive.
@@ -203,6 +231,12 @@ declare const PaymentFormBusinessDetails: {
     readonly Country: React.ForwardRefExoticComponent<React.SelectHTMLAttributes<HTMLSelectElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLSelectElement>>;
+    readonly State: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLInputElement>>;
+    readonly PostalCode: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLInputElement>>;
     readonly TaxId: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLInputElement>>;
@@ -260,6 +294,12 @@ declare const PaymentForm: {
         readonly Country: React.ForwardRefExoticComponent<React.SelectHTMLAttributes<HTMLSelectElement> & {
             asChild?: boolean;
         } & React.RefAttributes<HTMLSelectElement>>;
+        readonly State: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+            asChild?: boolean;
+        } & React.RefAttributes<HTMLInputElement>>;
+        readonly PostalCode: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+            asChild?: boolean;
+        } & React.RefAttributes<HTMLInputElement>>;
         readonly TaxId: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
             asChild?: boolean;
         } & React.RefAttributes<HTMLInputElement>>;
@@ -568,39 +608,6 @@ declare function configToAutoRechargeInput(config: AutoRechargeConfig, options?:
     };
 }): AutoRechargeInput | null;
 
-interface UseUsageReturn {
-    /** Raw usage snapshot (`null` when no usage-based plan is active). */
-    usage: UsageSnapshot | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-    /** 0-100, rounded to 2dp. `null` when total is unknown (unlimited/empty). */
-    percentUsed: number | null;
-    /** Plan is usage-based, `percentUsed >= 80`. */
-    isApproachingLimit: boolean;
-    /** Plan is usage-based, `percentUsed >= 100`. */
-    isAtLimit: boolean;
-    /**
-     * True when the backend reports no finite cap on this meter. Sourced
-     * from `useLimits().unlimited`, never inferred from a missing `total`
-     * — an unknown cap is not an absent one.
-     */
-    isUnlimited: boolean;
-    /** The meter reference (e.g. `'tokens'`). `null` when not usage-based. */
-    meterRef: string | null;
-}
-interface UsageSnapshot {
-    meterRef: string | null;
-    total: number | null;
-    used: number;
-    remaining: number | null;
-    percentUsed: number | null;
-    periodStart?: string;
-    periodEnd?: string;
-    purchaseRef?: string;
-}
-declare function useUsage(): UseUsageReturn;
-
 type CheckoutStatus = 'idle' | 'activating' | 'paying' | 'error';
 type CheckoutErrorPhase = 'activate' | 'pay';
 interface UseCheckoutFlowOptions {
@@ -832,4 +839,4 @@ declare const CheckoutStepsBackLink: React.ForwardRefExoticComponent<Omit<React.
 } & React.RefAttributes<HTMLButtonElement>>;
 declare const CheckoutStepsSuccess: typeof Success;
 
-export { CheckoutStepsPayment as $, type AutoRechargeInputPayload as A, BalanceBadge as B, type CheckoutVariant as C, configToAutoRechargeInput as D, deriveVariant as E, useCheckoutFlow as F, useCheckoutSteps as G, useUsage as H, type AmountInputUnit as I, type AutoRechargeFormState as J, ActivationFlow as K, ActivationFlowActivateButton as L, MandateText as M, ActivationFlowActivated as N, ActivationFlowAmountPicker as O, PaymentFormSummary as P, ActivationFlowContinueButton as Q, ActivationFlowError as R, ActivationFlowLoading as S, ActivationFlowRetrying as T, type UsageSnapshot as U, ActivationFlowRoot as V, ActivationFlowSummary as W, CheckoutStepsAmountContinueButton as X, CheckoutStepsAmountPicker as Y, CheckoutStepsBackLink as Z, CheckoutStepsIfStep as _, PaymentFormCustomerFields as a, CheckoutStepsPlanContinueButton as a0, CheckoutStepsPlanGrid as a1, CheckoutStepsRoot as a2, CheckoutStepsStepHeading as a3, CheckoutStepsStepMessage as a4, CheckoutStepsSuccess as a5, PaymentForm as a6, PaymentFormRoot as a7, PurchaseGateAllowed as a8, PurchaseGateBlocked as a9, PurchaseGateError as aa, PurchaseGateLoading as ab, PurchaseGateRoot as ac, useActivationFlow as ad, usePurchaseGate as ae, PaymentFormPaymentElement as b, PaymentFormCardElement as c, PaymentFormMandateText as d, PaymentFormTermsCheckbox as e, PaymentFormSubmitButton as f, PaymentFormLoading as g, PaymentFormError as h, PaymentFormLegalFooter as i, PaymentFormBusinessDetails as j, PaymentFormTaxSummary as k, type PaywallStructuredContent as l, type ActivationFlowStep as m, CancelPlanButton as n, type CheckoutErrorPhase as o, type CheckoutStatus as p, CheckoutSteps as q, CheckoutSummary as r, type CheckoutSummaryProps as s, type MandateTextProps as t, PlanBadge as u, ProductBadge as v, PurchaseGate as w, type UseCheckoutFlowOptions as x, type UseCheckoutFlowReturn as y, type UseUsageReturn as z };
+export { CheckoutStepsRoot as $, type AutoRechargeInputPayload as A, BalanceBadge as B, type CheckoutVariant as C, useCheckoutFlow as D, useCheckoutSteps as E, type AmountInputUnit as F, type AutoRechargeFormState as G, ActivationFlow as H, ActivationFlowActivateButton as I, ActivationFlowActivated as J, ActivationFlowAmountPicker as K, ActivationFlowContinueButton as L, MandateText as M, ActivationFlowError as N, ActivationFlowLoading as O, PaymentFormSummary as P, ActivationFlowRetrying as Q, ActivationFlowRoot as R, ActivationFlowSummary as S, CheckoutStepsAmountContinueButton as T, type UseCheckoutFlowOptions as U, CheckoutStepsAmountPicker as V, CheckoutStepsBackLink as W, CheckoutStepsIfStep as X, CheckoutStepsPayment as Y, CheckoutStepsPlanContinueButton as Z, CheckoutStepsPlanGrid as _, PaymentFormCustomerFields as a, CheckoutStepsStepHeading as a0, CheckoutStepsStepMessage as a1, CheckoutStepsSuccess as a2, PaymentForm as a3, PaymentFormRoot as a4, PurchaseGateAllowed as a5, PurchaseGateBlocked as a6, PurchaseGateError as a7, PurchaseGateLoading as a8, PurchaseGateRoot as a9, useActivationFlow as aa, usePurchaseGate as ab, PaymentFormPaymentElement as b, PaymentFormCardElement as c, PaymentFormMandateText as d, PaymentFormTermsCheckbox as e, PaymentFormSubmitButton as f, PaymentFormLoading as g, PaymentFormError as h, PaymentFormLegalFooter as i, PaymentFormBusinessDetails as j, PaymentFormTaxSummary as k, type PaywallStructuredContent as l, type ActivationFlowStep as m, CancelPlanButton as n, type CheckoutErrorPhase as o, type CheckoutStatus as p, CheckoutSteps as q, CheckoutSummary as r, type CheckoutSummaryProps as s, type MandateTextProps as t, PlanBadge as u, ProductBadge as v, PurchaseGate as w, type UseCheckoutFlowReturn as x, configToAutoRechargeInput as y, deriveVariant as z };

package/dist/{index-SylJb9Rh.d.cts → index-PsjS_d7V.d.ts}

@@ -1,4 +1,4 @@
-import { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, r as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, t as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-D0hmT1qU.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-CMqxEF9d.js';
 import React from 'react';
 import { PaymentElement, CardElement } from '@stripe/react-stripe-js';
 import { TaxBreakdown } from '@solvapay/core';
@@ -17,7 +17,36 @@ type LimitActivationProduct = components['schemas']['LimitProductBriefDto'];
 /**
  * Structured content for paywall errors (MCP structuredContent and manual handling).
  */
-type PaywallStructuredContent = {
+/**
+ * Fields shared by every `PaywallStructuredContent` kind so a text-only
+ * host can recover from a gate without a second tool call. Every field
+ * other than `kind` / `product` / `checkoutUrl` / `message` is omitted
+ * when the backend did not send it — never defaulted.
+ */
+type PaywallGateRecoveryFields = {
+    /** Active plan reference from `limits.plan`. */
+    planRef?: string;
+    /** Product plans from `checkLimits` (activation already had this). */
+    plans?: LimitPlanSummary[];
+    /** Meter the gated call was charged against. */
+    meterName?: string;
+    /** Per-unit charge of the active plan, in minor currency units. */
+    unitPriceMinor?: number;
+    /** ISO 4217 currency for `unitPriceMinor`. */
+    currency?: string;
+    /**
+     * Included-usage counters. Omitted when `freeUnits` is absent or `0`
+     * (the unlimited sentinel) so we never emit misleading zeros.
+     */
+    included?: {
+        total: number;
+        used: number;
+        remaining: number;
+    };
+    /** Prepaid credit balance, coalesced from nested or top-level fields. */
+    creditBalance?: number;
+};
+type PaywallStructuredContent = ({
     kind: 'payment_required';
     /** Product ref from paywall metadata (or env default) */
     product: string;
@@ -32,7 +61,7 @@ type PaywallStructuredContent = {
     balance?: LimitActivationBalance;
     /** Rich product context from checkLimits (name, ref, provider slug/id) */
     productDetails?: LimitActivationProduct;
-} | {
+} & PaywallGateRecoveryFields) | ({
     kind: 'activation_required';
     /** Product ref from paywall metadata (or env default) */
     product: string;
@@ -42,11 +71,10 @@ type PaywallStructuredContent = {
      */
     checkoutUrl: string;
     confirmationUrl?: string;
-    plans?: LimitPlanSummary[];
     balance?: LimitActivationBalance;
     /** Rich product context from checkLimits (name, ref, provider slug/id) */
     productDetails?: LimitActivationProduct;
-};
+} & PaywallGateRecoveryFields);
 
 /**
  * Default-tree shim over the `CheckoutSummary` primitive.
@@ -203,6 +231,12 @@ declare const PaymentFormBusinessDetails: {
     readonly Country: React.ForwardRefExoticComponent<React.SelectHTMLAttributes<HTMLSelectElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLSelectElement>>;
+    readonly State: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLInputElement>>;
+    readonly PostalCode: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLInputElement>>;
     readonly TaxId: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
         asChild?: boolean;
     } & React.RefAttributes<HTMLInputElement>>;
@@ -260,6 +294,12 @@ declare const PaymentForm: {
         readonly Country: React.ForwardRefExoticComponent<React.SelectHTMLAttributes<HTMLSelectElement> & {
             asChild?: boolean;
         } & React.RefAttributes<HTMLSelectElement>>;
+        readonly State: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+            asChild?: boolean;
+        } & React.RefAttributes<HTMLInputElement>>;
+        readonly PostalCode: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
+            asChild?: boolean;
+        } & React.RefAttributes<HTMLInputElement>>;
         readonly TaxId: React.ForwardRefExoticComponent<React.InputHTMLAttributes<HTMLInputElement> & {
             asChild?: boolean;
         } & React.RefAttributes<HTMLInputElement>>;
@@ -568,39 +608,6 @@ declare function configToAutoRechargeInput(config: AutoRechargeConfig, options?:
     };
 }): AutoRechargeInput | null;
 
-interface UseUsageReturn {
-    /** Raw usage snapshot (`null` when no usage-based plan is active). */
-    usage: UsageSnapshot | null;
-    loading: boolean;
-    error: Error | null;
-    refetch: () => Promise<void>;
-    /** 0-100, rounded to 2dp. `null` when total is unknown (unlimited/empty). */
-    percentUsed: number | null;
-    /** Plan is usage-based, `percentUsed >= 80`. */
-    isApproachingLimit: boolean;
-    /** Plan is usage-based, `percentUsed >= 100`. */
-    isAtLimit: boolean;
-    /**
-     * True when the backend reports no finite cap on this meter. Sourced
-     * from `useLimits().unlimited`, never inferred from a missing `total`
-     * — an unknown cap is not an absent one.
-     */
-    isUnlimited: boolean;
-    /** The meter reference (e.g. `'tokens'`). `null` when not usage-based. */
-    meterRef: string | null;
-}
-interface UsageSnapshot {
-    meterRef: string | null;
-    total: number | null;
-    used: number;
-    remaining: number | null;
-    percentUsed: number | null;
-    periodStart?: string;
-    periodEnd?: string;
-    purchaseRef?: string;
-}
-declare function useUsage(): UseUsageReturn;
-
 type CheckoutStatus = 'idle' | 'activating' | 'paying' | 'error';
 type CheckoutErrorPhase = 'activate' | 'pay';
 interface UseCheckoutFlowOptions {
@@ -832,4 +839,4 @@ declare const CheckoutStepsBackLink: React.ForwardRefExoticComponent<Omit<React.
 } & React.RefAttributes<HTMLButtonElement>>;
 declare const CheckoutStepsSuccess: typeof Success;
 
-export { CheckoutStepsPayment as $, type AutoRechargeInputPayload as A, BalanceBadge as B, type CheckoutVariant as C, configToAutoRechargeInput as D, deriveVariant as E, useCheckoutFlow as F, useCheckoutSteps as G, useUsage as H, type AmountInputUnit as I, type AutoRechargeFormState as J, ActivationFlow as K, ActivationFlowActivateButton as L, MandateText as M, ActivationFlowActivated as N, ActivationFlowAmountPicker as O, PaymentFormSummary as P, ActivationFlowContinueButton as Q, ActivationFlowError as R, ActivationFlowLoading as S, ActivationFlowRetrying as T, type UsageSnapshot as U, ActivationFlowRoot as V, ActivationFlowSummary as W, CheckoutStepsAmountContinueButton as X, CheckoutStepsAmountPicker as Y, CheckoutStepsBackLink as Z, CheckoutStepsIfStep as _, PaymentFormCustomerFields as a, CheckoutStepsPlanContinueButton as a0, CheckoutStepsPlanGrid as a1, CheckoutStepsRoot as a2, CheckoutStepsStepHeading as a3, CheckoutStepsStepMessage as a4, CheckoutStepsSuccess as a5, PaymentForm as a6, PaymentFormRoot as a7, PurchaseGateAllowed as a8, PurchaseGateBlocked as a9, PurchaseGateError as aa, PurchaseGateLoading as ab, PurchaseGateRoot as ac, useActivationFlow as ad, usePurchaseGate as ae, PaymentFormPaymentElement as b, PaymentFormCardElement as c, PaymentFormMandateText as d, PaymentFormTermsCheckbox as e, PaymentFormSubmitButton as f, PaymentFormLoading as g, PaymentFormError as h, PaymentFormLegalFooter as i, PaymentFormBusinessDetails as j, PaymentFormTaxSummary as k, type PaywallStructuredContent as l, type ActivationFlowStep as m, CancelPlanButton as n, type CheckoutErrorPhase as o, type CheckoutStatus as p, CheckoutSteps as q, CheckoutSummary as r, type CheckoutSummaryProps as s, type MandateTextProps as t, PlanBadge as u, ProductBadge as v, PurchaseGate as w, type UseCheckoutFlowOptions as x, type UseCheckoutFlowReturn as y, type UseUsageReturn as z };
+export { CheckoutStepsRoot as $, type AutoRechargeInputPayload as A, BalanceBadge as B, type CheckoutVariant as C, useCheckoutFlow as D, useCheckoutSteps as E, type AmountInputUnit as F, type AutoRechargeFormState as G, ActivationFlow as H, ActivationFlowActivateButton as I, ActivationFlowActivated as J, ActivationFlowAmountPicker as K, ActivationFlowContinueButton as L, MandateText as M, ActivationFlowError as N, ActivationFlowLoading as O, PaymentFormSummary as P, ActivationFlowRetrying as Q, ActivationFlowRoot as R, ActivationFlowSummary as S, CheckoutStepsAmountContinueButton as T, type UseCheckoutFlowOptions as U, CheckoutStepsAmountPicker as V, CheckoutStepsBackLink as W, CheckoutStepsIfStep as X, CheckoutStepsPayment as Y, CheckoutStepsPlanContinueButton as Z, CheckoutStepsPlanGrid as _, PaymentFormCustomerFields as a, CheckoutStepsStepHeading as a0, CheckoutStepsStepMessage as a1, CheckoutStepsSuccess as a2, PaymentForm as a3, PaymentFormRoot as a4, PurchaseGateAllowed as a5, PurchaseGateBlocked as a6, PurchaseGateError as a7, PurchaseGateLoading as a8, PurchaseGateRoot as a9, useActivationFlow as aa, usePurchaseGate as ab, PaymentFormPaymentElement as b, PaymentFormCardElement as c, PaymentFormMandateText as d, PaymentFormTermsCheckbox as e, PaymentFormSubmitButton as f, PaymentFormLoading as g, PaymentFormError as h, PaymentFormLegalFooter as i, PaymentFormBusinessDetails as j, PaymentFormTaxSummary as k, type PaywallStructuredContent as l, type ActivationFlowStep as m, CancelPlanButton as n, type CheckoutErrorPhase as o, type CheckoutStatus as p, CheckoutSteps as q, CheckoutSummary as r, type CheckoutSummaryProps as s, type MandateTextProps as t, PlanBadge as u, ProductBadge as v, PurchaseGate as w, type UseCheckoutFlowReturn as x, configToAutoRechargeInput as y, deriveVariant as z };