@moonpay/platform-sdk-react-native 1.9.0 → 1.11.0

package/dist/index.d.cts

@@ -28,7 +28,7 @@ import * as GooglePaySdk from '@moonpay/platform-protocol/sdks/google-pay';
 export { Event as GooglePayEvent, SetupError as SetupGooglePayError } from '@moonpay/platform-protocol/sdks/google-pay';
 import * as WidgetSdk from '@moonpay/platform-protocol/sdks/widget';
 export { SetupError as SetupWidgetError, Event as WidgetEvent } from '@moonpay/platform-protocol/sdks/widget';
-import { FrameTransport, FrameOptions, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
+import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
 export { ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
 import { GetPaymentMethodsError, GetQuoteError, GetAssetsError, GetTransactionsError, DevPlatformApiError, GetCustomerError, SubmitCustomerKycError, GetCustomerUploadUrlError, SubmitCustomerFilesError, CreateIdentityError, GetIdentityError, UpdateIdentityError, VerifyIdentityError, GetIdentityUploadUrlError, SubmitIdentityFilesError } from '@moonpay/platform-protocol/api/errors';
 import { UpdateIdentityRequestBody, IdentityFileUploadUrlRequestBody, IdentityFileUploadUrl, SubmitIdentityFilesRequestBody, CreateIdentityRequestBody, Identity, IdentityVerificationResponse } from '@moonpay/platform-protocol/api/identity';
@@ -73,6 +73,8 @@ declare class WebViewTransport implements RNFrameTransport {
 }
 
 interface SetupAddCardOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for add-card frame lifecycle events. */
     onEvent?: (event: AddCardSdk.Event) => void;
 }
@@ -85,6 +87,8 @@ interface SetupApplePayOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for Apple Pay lifecycle events. */
     onEvent?: (event: ApplePaySdk.Event) => void;
 }
@@ -95,6 +99,8 @@ interface ApplePayFrame {
 }
 
 interface SetupAuthOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for auth frame lifecycle events. */
     onEvent?: (event: AuthSdk.Event) => void;
 }
@@ -121,6 +127,8 @@ interface SetupBuyButtonOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for buy-button frame lifecycle events. */
     onEvent?: (event: BuyButtonSdk.Event) => void;
 }
@@ -133,6 +141,8 @@ interface BuyButtonFrame {
 interface SetupChallengeOptions {
     /** Full challenge URL received from a frame's `challenge` event. */
     url: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for challenge frame lifecycle events. */
     onEvent?: (event: ChallengeSdk.Event) => void;
 }
@@ -143,6 +153,8 @@ interface ChallengeFrame {
 interface ConnectOptions {
     /** Theme for this connect frame. Overrides the provider-level `theme`. */
     theme?: ThemeOptions;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for connect lifecycle events. */
     onEvent?: (event: ConnectSdk.Event) => void;
 }
@@ -160,6 +172,8 @@ interface GetConnectionOptions {
 }
 
 interface SetupCustomerExportOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for customer-export frame lifecycle events. */
     onEvent?: (event: CustomerExportSdk.Event) => void;
 }
@@ -172,6 +186,8 @@ interface SetupGooglePayOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for Google Pay lifecycle events. */
     onEvent?: (event: GooglePaySdk.Event) => void;
 }
@@ -186,6 +202,8 @@ interface SetupWidgetOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for widget lifecycle events. */
     onEvent?: (event: WidgetSdk.Event) => void;
 }
@@ -460,16 +478,25 @@ interface MoonPayFrameProps {
 declare function MoonPayFrame({ transport, hidden, style }: MoonPayFrameProps): JSX.Element | null;
 
 interface MoonPayProviderProps {
-    sessionToken: string;
+    /**
+     * Session token from your server (via `createSession`). Optional — omit it and
+     * call `initialize(sessionToken)` from `useMoonPay()` once you've fetched it.
+     * When provided, this prop takes precedence over an imperatively-set token.
+     */
+    sessionToken?: string;
     apiBaseUrl?: string;
     frameBaseUrl?: string;
     /** Theme applied to every visible MoonPay frame (connect, widget, Apple/Google Pay, …). */
     theme?: ThemeOptions;
     children: ReactNode;
 }
-declare function MoonPayProvider({ sessionToken, apiBaseUrl, frameBaseUrl, theme, children, }: MoonPayProviderProps): JSX.Element;
+declare function MoonPayProvider({ sessionToken: sessionTokenProp, apiBaseUrl, frameBaseUrl, theme, children, }: MoonPayProviderProps): JSX.Element;
 declare function useMoonPay(): {
     client: RNClient;
+    /** Set or replace the session token after mount. */
+    initialize: (sessionToken: string) => void;
+    /** True once a session token (via prop or `initialize()`) is available. */
+    isInitialized: boolean;
 };
 
 export { type AddCardFrame, type ApplePayFrame, type AuthFrame, type BuyButtonFrame, type BuyFrame, type ChallengeFrame, type ConnectFrame, type ConnectOptions, type ConnectionCheckEvent, type ConnectionResetEvent, type CustomerExportFrame, type GetConnectionOptions, type GooglePayFrame, MoonPayAddCard, type MoonPayAddCardProps, MoonPayApplePayButton, type MoonPayApplePayButtonProps, MoonPayAuth, type MoonPayAuthProps, MoonPayBuyButton, type MoonPayBuyButtonProps, MoonPayBuyFrame, type MoonPayBuyFrameProps, MoonPayChallenge, type MoonPayChallengeProps, MoonPayConnect, type MoonPayConnectProps, MoonPayConnectionCheck, type MoonPayConnectionCheckProps, MoonPayConnectionReset, type MoonPayConnectionResetProps, MoonPayCustomerExport, type MoonPayCustomerExportProps, MoonPayFrame, type MoonPayFrameProps, MoonPayGooglePayButton, type MoonPayGooglePayButtonProps, MoonPayProvider, type MoonPayProviderProps, MoonPayWidget, type MoonPayWidgetProps, type RNClient, type SetupAddCardOptions, type SetupApplePayOptions, type SetupAuthOptions, type SetupBuyButtonOptions, type SetupBuyOptions, type SetupChallengeOptions, type SetupCustomerExportOptions, type SetupGooglePayOptions, type SetupWidgetOptions, WebViewTransport, type WidgetFrame, useMoonPay };

package/dist/index.d.ts

@@ -28,7 +28,7 @@ import * as GooglePaySdk from '@moonpay/platform-protocol/sdks/google-pay';
 export { Event as GooglePayEvent, SetupError as SetupGooglePayError } from '@moonpay/platform-protocol/sdks/google-pay';
 import * as WidgetSdk from '@moonpay/platform-protocol/sdks/widget';
 export { SetupError as SetupWidgetError, Event as WidgetEvent } from '@moonpay/platform-protocol/sdks/widget';
-import { FrameTransport, FrameOptions, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
+import { FrameTransport, FrameOptions, PresentationMode, ThemeOptions, ListAssetsParams, ListTransactionsParams } from '@moonpay/platform-sdk-core';
 export { ListAssetsParams, ThemeOptions } from '@moonpay/platform-sdk-core';
 import { GetPaymentMethodsError, GetQuoteError, GetAssetsError, GetTransactionsError, DevPlatformApiError, GetCustomerError, SubmitCustomerKycError, GetCustomerUploadUrlError, SubmitCustomerFilesError, CreateIdentityError, GetIdentityError, UpdateIdentityError, VerifyIdentityError, GetIdentityUploadUrlError, SubmitIdentityFilesError } from '@moonpay/platform-protocol/api/errors';
 import { UpdateIdentityRequestBody, IdentityFileUploadUrlRequestBody, IdentityFileUploadUrl, SubmitIdentityFilesRequestBody, CreateIdentityRequestBody, Identity, IdentityVerificationResponse } from '@moonpay/platform-protocol/api/identity';
@@ -73,6 +73,8 @@ declare class WebViewTransport implements RNFrameTransport {
 }
 
 interface SetupAddCardOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for add-card frame lifecycle events. */
     onEvent?: (event: AddCardSdk.Event) => void;
 }
@@ -85,6 +87,8 @@ interface SetupApplePayOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for Apple Pay lifecycle events. */
     onEvent?: (event: ApplePaySdk.Event) => void;
 }
@@ -95,6 +99,8 @@ interface ApplePayFrame {
 }
 
 interface SetupAuthOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for auth frame lifecycle events. */
     onEvent?: (event: AuthSdk.Event) => void;
 }
@@ -121,6 +127,8 @@ interface SetupBuyButtonOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for buy-button frame lifecycle events. */
     onEvent?: (event: BuyButtonSdk.Event) => void;
 }
@@ -133,6 +141,8 @@ interface BuyButtonFrame {
 interface SetupChallengeOptions {
     /** Full challenge URL received from a frame's `challenge` event. */
     url: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for challenge frame lifecycle events. */
     onEvent?: (event: ChallengeSdk.Event) => void;
 }
@@ -143,6 +153,8 @@ interface ChallengeFrame {
 interface ConnectOptions {
     /** Theme for this connect frame. Overrides the provider-level `theme`. */
     theme?: ThemeOptions;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for connect lifecycle events. */
     onEvent?: (event: ConnectSdk.Event) => void;
 }
@@ -160,6 +172,8 @@ interface GetConnectionOptions {
 }
 
 interface SetupCustomerExportOptions {
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for customer-export frame lifecycle events. */
     onEvent?: (event: CustomerExportSdk.Event) => void;
 }
@@ -172,6 +186,8 @@ interface SetupGooglePayOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for Google Pay lifecycle events. */
     onEvent?: (event: GooglePaySdk.Event) => void;
 }
@@ -186,6 +202,8 @@ interface SetupWidgetOptions {
     quote: string;
     /** Partner-assigned identifier for this transaction attempt. */
     externalTransactionId?: string;
+    /** Frame chrome. Defaults to the frame's own default (bare) when omitted. */
+    presentation?: PresentationMode;
     /** Callback for widget lifecycle events. */
     onEvent?: (event: WidgetSdk.Event) => void;
 }
@@ -460,16 +478,25 @@ interface MoonPayFrameProps {
 declare function MoonPayFrame({ transport, hidden, style }: MoonPayFrameProps): JSX.Element | null;
 
 interface MoonPayProviderProps {
-    sessionToken: string;
+    /**
+     * Session token from your server (via `createSession`). Optional — omit it and
+     * call `initialize(sessionToken)` from `useMoonPay()` once you've fetched it.
+     * When provided, this prop takes precedence over an imperatively-set token.
+     */
+    sessionToken?: string;
     apiBaseUrl?: string;
     frameBaseUrl?: string;
     /** Theme applied to every visible MoonPay frame (connect, widget, Apple/Google Pay, …). */
     theme?: ThemeOptions;
     children: ReactNode;
 }
-declare function MoonPayProvider({ sessionToken, apiBaseUrl, frameBaseUrl, theme, children, }: MoonPayProviderProps): JSX.Element;
+declare function MoonPayProvider({ sessionToken: sessionTokenProp, apiBaseUrl, frameBaseUrl, theme, children, }: MoonPayProviderProps): JSX.Element;
 declare function useMoonPay(): {
     client: RNClient;
+    /** Set or replace the session token after mount. */
+    initialize: (sessionToken: string) => void;
+    /** True once a session token (via prop or `initialize()`) is available. */
+    isInitialized: boolean;
 };
 
 export { type AddCardFrame, type ApplePayFrame, type AuthFrame, type BuyButtonFrame, type BuyFrame, type ChallengeFrame, type ConnectFrame, type ConnectOptions, type ConnectionCheckEvent, type ConnectionResetEvent, type CustomerExportFrame, type GetConnectionOptions, type GooglePayFrame, MoonPayAddCard, type MoonPayAddCardProps, MoonPayApplePayButton, type MoonPayApplePayButtonProps, MoonPayAuth, type MoonPayAuthProps, MoonPayBuyButton, type MoonPayBuyButtonProps, MoonPayBuyFrame, type MoonPayBuyFrameProps, MoonPayChallenge, type MoonPayChallengeProps, MoonPayConnect, type MoonPayConnectProps, MoonPayConnectionCheck, type MoonPayConnectionCheckProps, MoonPayConnectionReset, type MoonPayConnectionResetProps, MoonPayCustomerExport, type MoonPayCustomerExportProps, MoonPayFrame, type MoonPayFrameProps, MoonPayGooglePayButton, type MoonPayGooglePayButtonProps, MoonPayProvider, type MoonPayProviderProps, MoonPayWidget, type MoonPayWidgetProps, type RNClient, type SetupAddCardOptions, type SetupApplePayOptions, type SetupAuthOptions, type SetupBuyButtonOptions, type SetupBuyOptions, type SetupChallengeOptions, type SetupCustomerExportOptions, type SetupGooglePayOptions, type SetupWidgetOptions, WebViewTransport, type WidgetFrame, useMoonPay };

package/dist/index.js

@@ -7,8 +7,10 @@ import {
   ConnectionStatus
 } from "@moonpay/platform-protocol/models/connection";
 import {
+  applyPresentationParam,
   decryptCredentials,
   FRAME_PATHS,
+  presentationParams,
   themeParams
 } from "@moonpay/platform-sdk-core";
 function createQuoteCommands(send, channelId) {
@@ -28,7 +30,8 @@ var applePaySpec = {
   buildParams: (ctx, props) => ({
     clientToken: ctx.core.context.clientToken,
     signature: props.quote,
-    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId }
+    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId },
+    ...presentationParams(props.presentation)
   }),
   createCommands: createQuoteCommands,
   reactiveProps: {
@@ -71,7 +74,8 @@ var googlePaySpec = {
   buildParams: (ctx, props) => ({
     clientToken: ctx.core.context.clientToken,
     signature: props.quote,
-    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId }
+    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId },
+    ...presentationParams(props.presentation)
   }),
   createCommands: createQuoteCommands,
   reactiveProps: {
@@ -114,7 +118,8 @@ var buyButtonSpec = {
   buildParams: (ctx, props) => ({
     clientToken: ctx.core.context.clientToken,
     signature: props.quote,
-    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId }
+    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId },
+    ...presentationParams(props.presentation)
   }),
   createCommands: createQuoteCommands,
   reactiveProps: {
@@ -155,6 +160,14 @@ function applyCredentialsOnComplete(msg, ctx) {
   ctx.core.context.setAccessToken(creds.accessToken);
   ctx.core.context.setClientToken(creds.clientToken);
 }
+function requireSessionToken(ctx) {
+  if (!ctx.sessionToken) {
+    throw new Error(
+      "No session token \u2014 pass sessionToken to <MoonPayProvider> or call initialize() from useMoonPay() before starting a connection."
+    );
+  }
+  return ctx.sessionToken;
+}
 var connectionCheckSpec = {
   channelPrefix: "check",
   path: FRAME_PATHS.checkConnection,
@@ -162,7 +175,7 @@ var connectionCheckSpec = {
   needsKeyPair: true,
   handshakeTimeout: 1e4,
   buildParams: (ctx, props, publicKey) => ({
-    sessionToken: ctx.sessionToken,
+    sessionToken: requireSessionToken(ctx),
     publicKey,
     ...props.skipKyc && { skipKyc: true }
   }),
@@ -183,13 +196,22 @@ var connectSpec = {
   path: FRAME_PATHS.connect,
   hidden: false,
   needsKeyPair: true,
-  buildParams: (ctx, props, publicKey) => ({
-    sessionToken: ctx.sessionToken,
-    publicKey,
-    // Per-call override; `applyThemeParam` in the engine fills the client
-    // default for connect (and every other visible frame) when this is absent.
-    ...themeParams(props.theme)
-  }),
+  buildParams: (ctx, props, publicKey) => {
+    const clientToken = ctx.core.context.clientToken;
+    if (!clientToken) {
+      throw new Error(
+        'No clientToken in context \u2014 call getConnection() first and ensure it resolved with status "connectionRequired".'
+      );
+    }
+    return {
+      clientToken,
+      publicKey,
+      // Per-call override; `applyThemeParam` in the engine fills the client
+      // default for connect (and every other visible frame) when this is absent.
+      ...themeParams(props.theme),
+      ...presentationParams(props.presentation)
+    };
+  },
   onMessageEffect: applyCredentialsOnComplete,
   mapMessage: (msg) => {
     switch (msg.kind) {
@@ -213,14 +235,14 @@ var authSpec = {
   path: FRAME_PATHS.auth,
   hidden: false,
   needsKeyPair: true,
-  buildParams: (ctx, _props, publicKey) => {
+  buildParams: (ctx, props, publicKey) => {
     const clientToken = ctx.core.context.clientToken;
     if (!clientToken) {
       throw new Error(
         'No clientToken in context \u2014 call getConnection() first and ensure it resolved with status "connectionRequired".'
       );
     }
-    return { clientToken, publicKey };
+    return { clientToken, publicKey, ...presentationParams(props.presentation) };
   },
   onMessageEffect: applyCredentialsOnComplete,
   mapMessage: (msg) => {
@@ -253,7 +275,8 @@ var widgetSpec = {
     flow: "buy",
     clientToken: ctx.core.context.clientToken,
     quoteSignature: props.quote,
-    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId }
+    ...props.externalTransactionId && { externalTransactionId: props.externalTransactionId },
+    ...presentationParams(props.presentation)
   }),
   mapMessage: (msg) => {
     switch (msg.kind) {
@@ -315,7 +338,10 @@ var addCardSpec = {
   channelPrefix: "add-card",
   path: FRAME_PATHS.addCard,
   hidden: false,
-  buildParams: (ctx) => ({ clientToken: ctx.core.context.clientToken }),
+  buildParams: (ctx, props) => ({
+    clientToken: ctx.core.context.clientToken,
+    ...presentationParams(props.presentation)
+  }),
   mapMessage: (msg) => {
     switch (msg.kind) {
       case "ready":
@@ -340,7 +366,10 @@ var customerExportSpec = {
   channelPrefix: "customer-export",
   path: FRAME_PATHS.customerExport,
   hidden: false,
-  buildParams: (ctx) => ({ clientToken: ctx.core.context.clientToken }),
+  buildParams: (ctx, props) => ({
+    clientToken: ctx.core.context.clientToken,
+    ...presentationParams(props.presentation)
+  }),
   mapMessage: (msg) => {
     switch (msg.kind) {
       case "ready":
@@ -372,7 +401,7 @@ var challengeSpec = {
   buildUrl: (_ctx, props, channelId) => {
     const url = new URL(props.url);
     url.searchParams.set("channelId", channelId);
-    return url.toString();
+    return applyPresentationParam(url.toString(), props.presentation);
   },
   mapMessage: (msg) => {
     switch (msg.kind) {
@@ -398,7 +427,7 @@ var connectionResetSpec = {
   path: FRAME_PATHS.reset,
   hidden: true,
   handshakeTimeout: 5e3,
-  buildParams: (ctx) => ({ sessionToken: ctx.sessionToken }),
+  buildParams: (ctx) => ({ sessionToken: requireSessionToken(ctx) }),
   mapMessage: (msg) => {
     if (msg.kind === "complete") return { kind: "complete" };
     if (msg.kind === "error") {
@@ -631,7 +660,9 @@ import {
 import { err, ok } from "@moonpay/platform-protocol/result";
 async function setupAddCard(deps, opts) {
   try {
-    const { handle, dispose } = await deps.mountSession(addCardSpec, {});
+    const { handle, dispose } = await deps.mountSession(addCardSpec, {
+      presentation: opts.presentation
+    });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok({ dispose });
   } catch (e) {
@@ -648,7 +679,8 @@ async function setupApplePay(deps, opts) {
   try {
     const { handle, dispose } = await deps.mountSession(applePaySpec, {
       quote: opts.quote,
-      externalTransactionId: opts.externalTransactionId
+      externalTransactionId: opts.externalTransactionId,
+      presentation: opts.presentation
     });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok2({ setQuote: handle.commands.setQuote, dispose });
@@ -670,7 +702,9 @@ async function setupAuth(deps, opts) {
     });
   }
   try {
-    const { handle, dispose } = await deps.mountSession(authSpec, {});
+    const { handle, dispose } = await deps.mountSession(authSpec, {
+      presentation: opts.presentation
+    });
     return await new Promise((resolve) => {
       handle.onEvent((event) => {
         opts.onEvent?.(event);
@@ -723,7 +757,8 @@ async function setupBuyButton(deps, opts) {
   try {
     const { handle, dispose } = await deps.mountSession(buyButtonSpec, {
       quote: opts.quote,
-      externalTransactionId: opts.externalTransactionId
+      externalTransactionId: opts.externalTransactionId,
+      presentation: opts.presentation
     });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok5({ setQuote: handle.commands.setQuote, dispose });
@@ -746,7 +781,10 @@ async function setupChallenge(deps, opts) {
     });
   }
   try {
-    const { handle, dispose } = await deps.mountSession(challengeSpec, { url: opts.url });
+    const { handle, dispose } = await deps.mountSession(challengeSpec, {
+      url: opts.url,
+      presentation: opts.presentation
+    });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok6({ dispose });
   } catch (e) {
@@ -761,7 +799,10 @@ async function setupChallenge(deps, opts) {
 import { err as err7, ok as ok7 } from "@moonpay/platform-protocol/result";
 async function connect(deps, opts) {
   try {
-    const { handle, dispose } = await deps.mountSession(connectSpec, { theme: opts.theme });
+    const { handle, dispose } = await deps.mountSession(connectSpec, {
+      theme: opts.theme,
+      presentation: opts.presentation
+    });
     return await new Promise((resolve) => {
       handle.onEvent((event) => {
         opts.onEvent?.(event);
@@ -838,7 +879,9 @@ async function resetConnection(deps) {
 import { err as err9, ok as ok10 } from "@moonpay/platform-protocol/result";
 async function setupCustomerExport(deps, opts) {
   try {
-    const { handle, dispose } = await deps.mountSession(customerExportSpec, {});
+    const { handle, dispose } = await deps.mountSession(customerExportSpec, {
+      presentation: opts.presentation
+    });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok10({ dispose });
   } catch (e) {
@@ -855,7 +898,8 @@ async function setupGooglePay(deps, opts) {
   try {
     const { handle, dispose } = await deps.mountSession(googlePaySpec, {
       quote: opts.quote,
-      externalTransactionId: opts.externalTransactionId
+      externalTransactionId: opts.externalTransactionId,
+      presentation: opts.presentation
     });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok11({ setQuote: handle.commands.setQuote, dispose });
@@ -873,7 +917,8 @@ async function setupWidget(deps, opts) {
   try {
     const { handle, dispose } = await deps.mountSession(widgetSpec, {
       quote: opts.quote,
-      externalTransactionId: opts.externalTransactionId
+      externalTransactionId: opts.externalTransactionId,
+      presentation: opts.presentation
     });
     handle.onEvent((event) => opts.onEvent?.(event));
     return ok12({ dispose });
@@ -1166,13 +1211,15 @@ var styles = StyleSheet.create({
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var MoonPayContext = createContext(null);
 function MoonPayProvider({
-  sessionToken,
+  sessionToken: sessionTokenProp,
   apiBaseUrl,
   frameBaseUrl,
   theme,
   children
 }) {
   const [frameSlots, setFrameSlots] = useState2([]);
+  const [internalToken, setInternalToken] = useState2(void 0);
+  const sessionToken = sessionTokenProp ?? internalToken;
   const addSlot = useCallback2((slot) => {
     setFrameSlots((prev) => [...prev, slot]);
   }, []);
@@ -1188,6 +1235,14 @@ function MoonPayProvider({
     });
   }
   const core = coreRef.current;
+  const initialize = useCallback2(
+    (token) => {
+      core.context.setAccessToken("");
+      core.context.setClientToken("");
+      setInternalToken(token);
+    },
+    [core]
+  );
   const client = useMemo2(() => {
     const specCtx = { sessionToken, core, frameBaseUrl, theme };
     return createRNClient({
@@ -1195,21 +1250,28 @@ function MoonPayProvider({
       core
     });
   }, [sessionToken, frameBaseUrl, core, addSlot, removeSlot, theme?.appearance]);
-  return /* @__PURE__ */ jsxs2(MoonPayContext.Provider, { value: { client, sessionToken, core, frameBaseUrl, theme }, children: [
-    children,
-    frameSlots.filter((slot) => slot.hidden).map((slot) => /* @__PURE__ */ jsx3(MoonPayFrame, { transport: slot.transport, hidden: true }, slot.id)),
-    frameSlots.filter((slot) => !slot.hidden).map((slot) => /* @__PURE__ */ jsx3(
-      VisibleFrameSlotSheet,
-      {
-        slot,
-        onClose: () => {
-          slot.dispose();
-          removeSlot(slot.id);
-        }
-      },
-      slot.id
-    ))
-  ] });
+  const isInitialized = sessionToken !== void 0;
+  return /* @__PURE__ */ jsxs2(
+    MoonPayContext.Provider,
+    {
+      value: { client, sessionToken, core, frameBaseUrl, theme, initialize, isInitialized },
+      children: [
+        children,
+        frameSlots.filter((slot) => slot.hidden).map((slot) => /* @__PURE__ */ jsx3(MoonPayFrame, { transport: slot.transport, hidden: true }, slot.id)),
+        frameSlots.filter((slot) => !slot.hidden).map((slot) => /* @__PURE__ */ jsx3(
+          VisibleFrameSlotSheet,
+          {
+            slot,
+            onClose: () => {
+              slot.dispose();
+              removeSlot(slot.id);
+            }
+          },
+          slot.id
+        ))
+      ]
+    }
+  );
 }
 function useMoonPayContext() {
   const ctx = useContext(MoonPayContext);
@@ -1219,7 +1281,8 @@ function useMoonPayContext() {
   return ctx;
 }
 function useMoonPay() {
-  return useMoonPayContext();
+  const { client, initialize, isInitialized } = useMoonPayContext();
+  return { client, initialize, isInitialized };
 }
 
 // src/frame-view.tsx