@moonpay/platform-sdk-react-native 1.10.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;
 }

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;
 }

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: {
@@ -191,13 +196,22 @@ var connectSpec = {
   path: FRAME_PATHS.connect,
   hidden: false,
   needsKeyPair: true,
-  buildParams: (ctx, props, publicKey) => ({
-    sessionToken: requireSessionToken(ctx),
-    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) {
@@ -221,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) => {
@@ -261,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) {
@@ -323,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":
@@ -348,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":
@@ -380,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) {
@@ -639,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) {
@@ -656,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 });
@@ -678,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);
@@ -731,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 });
@@ -754,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) {
@@ -769,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);
@@ -846,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) {
@@ -863,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 });
@@ -881,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 });