@solvapay/react 2.5.0 → 2.6.0

package/dist/mcp/index.d.cts

@@ -1,10 +1,10 @@
-import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-DwwQ-jAO.cjs';
+import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-CPlXBdC5.cjs';
 import { TOOL_FOR_VIEW, SolvaPayMcpViewKind, BootstrapMerchant, BootstrapProduct, BootstrapPlan, BootstrapCustomer } from '@solvapay/mcp-core';
 export { MCP_TOOL_NAMES, McpToolName } from '@solvapay/mcp-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import { PricingOptionLike, PricedLike, BalancePegLike } from '@solvapay/core';
-import { U as UsageMeterRootProps } from '../UsageMeter-YX-icS_X.cjs';
+import { U as UsageMeterRootProps } from '../UsageMeter-Cxn3_A-q.cjs';
 import '@stripe/stripe-js';
 import '../adapters/auth.cjs';
 
@@ -281,10 +281,10 @@ declare function useMcpBridge(): McpBridgeValue;
 /**
  * Bootstrap helper for SolvaPay MCP Apps.
  *
- * `fetchMcpBootstrap(app)` — kicks off the MCP session by invoking the
- * `open_*` tool matching the host's invocation context and returns the
+ * `fetchMcpBootstrap(app)` — replays the account viewer and returns the
  * view discriminator + bootstrap payload every view needs (merchant,
- * product, plans, and customer snapshot).
+ * product, plans, and customer snapshot). The payload's `view` is the
+ * surface; `fallbackViewFromHost` applies only when a payload omits it.
  */
 
 /**
@@ -422,16 +422,14 @@ type HostEntryClassification = {
  */
 declare function classifyHostEntry(app: McpAppBootstrapLike): HostEntryClassification;
 /**
- * Kick off the MCP session by calling the `open_*` tool that matches the
- * host's invocation context. Returns the bootstrap payload every view
- * needs (product ref, publishable key, return url) along with the view
- * discriminator so the top-level router can pick the right screen.
+ * Replay the account viewer for a fresh bootstrap snapshot. Returns the
+ * payload every view needs (product ref, publishable key, return url)
+ * along with the view discriminator so the top-level router can pick
+ * the right screen.
  *
- * Used for intent-tool iframe entries and for `refreshInitial` after a
- * committed action (purchase, topup, etc.). Data-tool iframe entries
- * (paywall/nudge) bypass this helper; `<McpApp>` consumes the initial
- * `ui/notifications/tool-result` directly via
- * `parseBootstrapFromToolResult` so the merchant tool is not re-called.
+ * Used for transport-tool iframe entries and for `refreshInitial` after
+ * a committed action (purchase, topup, etc.). The payload's `view` is
+ * the surface; `fallbackViewFromHost` applies only when it is omitted.
  */
 declare function fetchMcpBootstrap(app: McpAppBootstrapLike): Promise<McpBootstrap>;
 /**
@@ -439,8 +437,9 @@ declare function fetchMcpBootstrap(app: McpAppBootstrapLike): Promise<McpBootstr
  *
  * Used when the host scrubs `structuredContent` from the opening
  * `toolresult` notification (e.g. MCPJam) so the widget can recover
- * without replaying the intent tool. The view is resolved locally from
- * host context — the resource body is view-agnostic.
+ * without replaying the viewer. The payload's `view` is the surface —
+ * the server stamps the same default the viewer picks when `view` is
+ * omitted.
  *
  * Throws when `readServerResource` is unavailable, the resource body is
  * missing, or parsing fails. Callers fall back to `fetchMcpBootstrap`.
@@ -716,7 +715,15 @@ interface McpViewClassNames {
     awaitingHeader?: string;
     balanceRow?: string;
     amountPicker?: string;
+    /**
+     * @deprecated Quick amounts render as `.solvapay-mcp-preset-tile`s.
+     * Slot retained for integrator overrides that still target it.
+     */
     amountOptions?: string;
+    /**
+     * @deprecated Quick amounts render as `.solvapay-mcp-preset-tile`s.
+     * Slot retained for integrator overrides that still target it.
+     */
     amountOption?: string;
     amountCustom?: string;
     topupForm?: string;

package/dist/mcp/index.d.ts

@@ -1,10 +1,10 @@
-import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-DwFZIuQW.js';
+import { w as SolvaPayTransport, a1 as SolvaPayProviderInitial, D as SolvaPayConfig, B as BootstrapPlanLike, y as PurchaseInfo, a2 as CreditActivityType, a3 as CreditActivityEntry, H as Merchant } from '../useUsage-Bee4D9Hw.js';
 import { TOOL_FOR_VIEW, SolvaPayMcpViewKind, BootstrapMerchant, BootstrapProduct, BootstrapPlan, BootstrapCustomer } from '@solvapay/mcp-core';
 export { MCP_TOOL_NAMES, McpToolName } from '@solvapay/mcp-core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import { PricingOptionLike, PricedLike, BalancePegLike } from '@solvapay/core';
-import { U as UsageMeterRootProps } from '../UsageMeter-Cg9IAFvV.js';
+import { U as UsageMeterRootProps } from '../UsageMeter-sAFkX-Tz.js';
 import '@stripe/stripe-js';
 import '../adapters/auth.js';
 
@@ -281,10 +281,10 @@ declare function useMcpBridge(): McpBridgeValue;
 /**
  * Bootstrap helper for SolvaPay MCP Apps.
  *
- * `fetchMcpBootstrap(app)` — kicks off the MCP session by invoking the
- * `open_*` tool matching the host's invocation context and returns the
+ * `fetchMcpBootstrap(app)` — replays the account viewer and returns the
  * view discriminator + bootstrap payload every view needs (merchant,
- * product, plans, and customer snapshot).
+ * product, plans, and customer snapshot). The payload's `view` is the
+ * surface; `fallbackViewFromHost` applies only when a payload omits it.
  */
 
 /**
@@ -422,16 +422,14 @@ type HostEntryClassification = {
  */
 declare function classifyHostEntry(app: McpAppBootstrapLike): HostEntryClassification;
 /**
- * Kick off the MCP session by calling the `open_*` tool that matches the
- * host's invocation context. Returns the bootstrap payload every view
- * needs (product ref, publishable key, return url) along with the view
- * discriminator so the top-level router can pick the right screen.
+ * Replay the account viewer for a fresh bootstrap snapshot. Returns the
+ * payload every view needs (product ref, publishable key, return url)
+ * along with the view discriminator so the top-level router can pick
+ * the right screen.
  *
- * Used for intent-tool iframe entries and for `refreshInitial` after a
- * committed action (purchase, topup, etc.). Data-tool iframe entries
- * (paywall/nudge) bypass this helper; `<McpApp>` consumes the initial
- * `ui/notifications/tool-result` directly via
- * `parseBootstrapFromToolResult` so the merchant tool is not re-called.
+ * Used for transport-tool iframe entries and for `refreshInitial` after
+ * a committed action (purchase, topup, etc.). The payload's `view` is
+ * the surface; `fallbackViewFromHost` applies only when it is omitted.
  */
 declare function fetchMcpBootstrap(app: McpAppBootstrapLike): Promise<McpBootstrap>;
 /**
@@ -439,8 +437,9 @@ declare function fetchMcpBootstrap(app: McpAppBootstrapLike): Promise<McpBootstr
  *
  * Used when the host scrubs `structuredContent` from the opening
  * `toolresult` notification (e.g. MCPJam) so the widget can recover
- * without replaying the intent tool. The view is resolved locally from
- * host context — the resource body is view-agnostic.
+ * without replaying the viewer. The payload's `view` is the surface —
+ * the server stamps the same default the viewer picks when `view` is
+ * omitted.
  *
  * Throws when `readServerResource` is unavailable, the resource body is
  * missing, or parsing fails. Callers fall back to `fetchMcpBootstrap`.
@@ -716,7 +715,15 @@ interface McpViewClassNames {
     awaitingHeader?: string;
     balanceRow?: string;
     amountPicker?: string;
+    /**
+     * @deprecated Quick amounts render as `.solvapay-mcp-preset-tile`s.
+     * Slot retained for integrator overrides that still target it.
+     */
     amountOptions?: string;
+    /**
+     * @deprecated Quick amounts render as `.solvapay-mcp-preset-tile`s.
+     * Slot retained for integrator overrides that still target it.
+     */
     amountOption?: string;
     amountCustom?: string;
     topupForm?: string;