@moonpay/platform-sdk-core 1.9.0 → 1.11.0

package/dist/index.d.cts

@@ -169,6 +169,25 @@ declare function themeParams(theme?: ThemeOptions): Record<string, string>;
  * (or partner-embedded) theme always wins over the client default.
  */
 declare function applyThemeParam(url: string, theme?: ThemeOptions): string;
+/**
+ * Presentation modes honoured by every visible MoonPay frame: `bare` (flat,
+ * no backdrop or close button — for hosts that supply their own chrome) or
+ * `modal` (the animated sheet-with-backdrop treatment). Left unset, the frame
+ * applies its own default.
+ */
+type PresentationMode = 'bare' | 'modal';
+/**
+ * Query params for a presentation mode. Returns `{}` when unset, so it
+ * spreads cleanly into a frame URL's query object and the frame's own
+ * default applies.
+ */
+declare function presentationParams(presentation?: PresentationMode): Record<string, string>;
+/**
+ * Set the `presentation` query param on an already-built frame URL (e.g. a
+ * challenge URL supplied via a quote's `challenge` event) — unless the URL
+ * already carries one.
+ */
+declare function applyPresentationParam(url: string, presentation?: PresentationMode): string;
 
 interface CoreClientOptions extends ClientContextOptions, UrlBuilderOptions {
     /**
@@ -313,4 +332,4 @@ declare function isTrustedFrameOrigin(origin: string): boolean;
  */
 declare function isTrustedFrameUrl(value: string): boolean;
 
-export { type ClientContext, type ClientContextOptions, type CoreClient, type CoreClientOptions, FRAME_PATHS, type FrameHandle, type FrameOptions, type FrameOrchestratorOptions, type FrameTransport, type KeyPair, type ListAssetsParams, type ListTransactionsParams, TRUSTED_FRAME_ORIGIN_PATTERNS, type ThemeOptions, type UrlBuilderOptions, apiFetch, applyThemeParam, buildFrameUrl, createClientContext, createClientCore, createFrameOrchestrator, createIdentity, decryptCredentials, deletePaymentMethod, generateKeyPair, getAssets, getCustomer, getCustomerUploadUrl, getIdentity, getIdentityUploadUrl, getPaymentMethods, getQuote, getTransaction, isTrustedFrameOrigin, isTrustedFrameUrl, listTransactions, submitCustomerFiles, submitCustomerKyc, submitIdentityFiles, themeParams, updateIdentity, verifyIdentity };
+export { type ClientContext, type ClientContextOptions, type CoreClient, type CoreClientOptions, FRAME_PATHS, type FrameHandle, type FrameOptions, type FrameOrchestratorOptions, type FrameTransport, type KeyPair, type ListAssetsParams, type ListTransactionsParams, type PresentationMode, TRUSTED_FRAME_ORIGIN_PATTERNS, type ThemeOptions, type UrlBuilderOptions, apiFetch, applyPresentationParam, applyThemeParam, buildFrameUrl, createClientContext, createClientCore, createFrameOrchestrator, createIdentity, decryptCredentials, deletePaymentMethod, generateKeyPair, getAssets, getCustomer, getCustomerUploadUrl, getIdentity, getIdentityUploadUrl, getPaymentMethods, getQuote, getTransaction, isTrustedFrameOrigin, isTrustedFrameUrl, listTransactions, presentationParams, submitCustomerFiles, submitCustomerKyc, submitIdentityFiles, themeParams, updateIdentity, verifyIdentity };

package/dist/index.d.ts

@@ -169,6 +169,25 @@ declare function themeParams(theme?: ThemeOptions): Record<string, string>;
  * (or partner-embedded) theme always wins over the client default.
  */
 declare function applyThemeParam(url: string, theme?: ThemeOptions): string;
+/**
+ * Presentation modes honoured by every visible MoonPay frame: `bare` (flat,
+ * no backdrop or close button — for hosts that supply their own chrome) or
+ * `modal` (the animated sheet-with-backdrop treatment). Left unset, the frame
+ * applies its own default.
+ */
+type PresentationMode = 'bare' | 'modal';
+/**
+ * Query params for a presentation mode. Returns `{}` when unset, so it
+ * spreads cleanly into a frame URL's query object and the frame's own
+ * default applies.
+ */
+declare function presentationParams(presentation?: PresentationMode): Record<string, string>;
+/**
+ * Set the `presentation` query param on an already-built frame URL (e.g. a
+ * challenge URL supplied via a quote's `challenge` event) — unless the URL
+ * already carries one.
+ */
+declare function applyPresentationParam(url: string, presentation?: PresentationMode): string;
 
 interface CoreClientOptions extends ClientContextOptions, UrlBuilderOptions {
     /**
@@ -313,4 +332,4 @@ declare function isTrustedFrameOrigin(origin: string): boolean;
  */
 declare function isTrustedFrameUrl(value: string): boolean;
 
-export { type ClientContext, type ClientContextOptions, type CoreClient, type CoreClientOptions, FRAME_PATHS, type FrameHandle, type FrameOptions, type FrameOrchestratorOptions, type FrameTransport, type KeyPair, type ListAssetsParams, type ListTransactionsParams, TRUSTED_FRAME_ORIGIN_PATTERNS, type ThemeOptions, type UrlBuilderOptions, apiFetch, applyThemeParam, buildFrameUrl, createClientContext, createClientCore, createFrameOrchestrator, createIdentity, decryptCredentials, deletePaymentMethod, generateKeyPair, getAssets, getCustomer, getCustomerUploadUrl, getIdentity, getIdentityUploadUrl, getPaymentMethods, getQuote, getTransaction, isTrustedFrameOrigin, isTrustedFrameUrl, listTransactions, submitCustomerFiles, submitCustomerKyc, submitIdentityFiles, themeParams, updateIdentity, verifyIdentity };
+export { type ClientContext, type ClientContextOptions, type CoreClient, type CoreClientOptions, FRAME_PATHS, type FrameHandle, type FrameOptions, type FrameOrchestratorOptions, type FrameTransport, type KeyPair, type ListAssetsParams, type ListTransactionsParams, type PresentationMode, TRUSTED_FRAME_ORIGIN_PATTERNS, type ThemeOptions, type UrlBuilderOptions, apiFetch, applyPresentationParam, applyThemeParam, buildFrameUrl, createClientContext, createClientCore, createFrameOrchestrator, createIdentity, decryptCredentials, deletePaymentMethod, generateKeyPair, getAssets, getCustomer, getCustomerUploadUrl, getIdentity, getIdentityUploadUrl, getPaymentMethods, getQuote, getTransaction, isTrustedFrameOrigin, isTrustedFrameUrl, listTransactions, presentationParams, submitCustomerFiles, submitCustomerKyc, submitIdentityFiles, themeParams, updateIdentity, verifyIdentity };

package/dist/index.js

@@ -1664,10 +1664,22 @@ function applyThemeParam(url, theme) {
   }
   return parsed.href;
 }
+function presentationParams(presentation) {
+  return presentation ? { presentation } : {};
+}
+function applyPresentationParam(url, presentation) {
+  if (!presentation) return url;
+  const parsed = new URL(url);
+  if (!parsed.searchParams.has("presentation")) {
+    parsed.searchParams.set("presentation", presentation);
+  }
+  return parsed.href;
+}
 export {
   FRAME_PATHS,
   TRUSTED_FRAME_ORIGIN_PATTERNS,
   apiFetch,
+  applyPresentationParam,
   applyThemeParam,
   buildFrameUrl,
   createClientContext,
@@ -1688,6 +1700,7 @@ export {
   isTrustedFrameOrigin,
   isTrustedFrameUrl,
   listTransactions,
+  presentationParams,
   submitCustomerFiles,
   submitCustomerKyc,
   submitIdentityFiles,