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

package/dist/{index-CBWGkBqF.d.ts → index-APG9WYgS.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 { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, u as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-BQbMyX5V.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.

package/dist/{index-SylJb9Rh.d.cts → index-ofZwGvIZ.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 { $ as components, b as Plan, P as PaymentFormProps, a as PrefillCustomer, A as ActivationResult, s as UseTopupAmountSelectorReturn, a0 as AutoRechargeInput, u as AutoRechargeConfig, a1 as AutoRechargeDisplayBlock, E as CheckoutStep, O as SuccessMeta } from './shared-DJdsOLag.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.