@moonpay/platform-protocol 1.5.0 → 1.7.0

package/dist/api/index.d.ts

@@ -1,569 +1 @@
-/**
- * A fiat currency or crypto token
- */
-type Asset = {
-    /**
-     * A fiat or crypto currency code.
-     *
-     * **Fiat**
-     * Fiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.
-     *
-     * Currently only `USD` is supported.
-     *
-     * **Crypto**
-     * For crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).
-     *
-     * Examples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`
-     */
-    code: string;
-    /**
-     * The human-readable name
-     */
-    name?: string;
-    /**
-     * The number of supported decimal places
-     */
-    precision?: number;
-};
-type AssetBase = {
-    /**
-     * A fiat or crypto currency code.
-     *
-     * **Fiat**
-     * Fiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.
-     *
-     * Currently only `USD` is supported.
-     *
-     * **Crypto**
-     * For crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).
-     *
-     * Examples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`
-     */
-    code: string;
-};
-/**
- * Current status flags for an asset.
- */
-type AssetStatus = {
-    /**
-     * Reviewed and approved by MoonPay. DeFi tokens are returned with `verified: false`.
-     */
-    verified: boolean;
-    /**
-     * Temporarily unavailable for trading.
-     */
-    suspended: boolean;
-    /**
-     * Disabled for trading.
-     */
-    disabled: boolean;
-};
-/**
- * Destination crypto asset. Identify it by `code` for CeFi assets, or by `caip19` (the CAIP-19 identifier from the assets listing) for DeFi tokens, whose `code` is not unique. Provide exactly one; `caip19` takes precedence if both are sent.
- */
-type BuyQuoteDestinationAsset = {
-    /**
-     * CeFi currency code, e.g. `BTC` or `ETH`. Use for centralised assets.
-     */
-    code?: string;
-    /**
-     * CAIP-19 asset identifier from the assets listing. Required for DeFi tokens.
-     */
-    caip19?: string;
-};
-type CreateSessionTokenRequestBody = {
-    /**
-     * A unique identifier for the customer from your system.
-     */
-    externalCustomerId?: string;
-    /**
-     * The IP address of the user's device to ensure the integrity of the session. Both IPv4 and IPv6 values are supported.
-     */
-    deviceIp: IPv4Address | IPv6Address;
-    /**
-     * The customer's email address. Must be a valid email. If provided, enables email OTP authentication.
-     */
-    email?: string;
-    /**
-     * The customer's phone number in E.164 format. If both email and phone are provided, enables phone OTP authentication for returning customers.
-     */
-    phoneNumber?: string;
-    /**
-     * An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the customer accepted MoonPay's Terms of Use. Send this when you capture Terms of Use acceptance in your own UI. The value can be at most 60 seconds ahead of server time, with no past limit. MoonPay records the terms version live at this timestamp and binds the acceptance to the customer when the session is authorized.
-     */
-    termsAcceptedAt?: string;
-};
-type CreateSessionTokenResponse = {
-    /**
-     * An opaque session token used to set up a connection on your frontend. This token is single-use and must be generated each time the customer visits your app.
-     *
-     * Token expires 24 hours after issuance.
-     */
-    sessionToken: string;
-};
-type Fees = {
-    /**
-     * Network fees (in fiat) for the transaction.
-     */
-    network?: MonetaryFeeAmount;
-    /**
-     * MoonPay fees (in fiat) for the transaction.
-     */
-    moonpay?: MonetaryFeeAmount;
-    /**
-     * Ecosystem fees (in fiat) for the transaction, if applicable.
-     */
-    ecosystem?: MonetaryFeeAmount;
-    /**
-     * DeFi swap fee (in fiat) for the transaction, converted to the quote's base currency like the other fees. Present only for DeFi swaps that carry an itemized swap fee; when the fee is taken on-chain it is reflected in `destination.amount` instead.
-     */
-    defi?: MonetaryFeeAmount;
-    /**
-     * Partner fees (in fiat) for the transaction, if applicable. Deprecated: use `fees.ecosystem` instead. This field will be removed in a future release.
-     * @deprecated
-     */
-    partner?: MonetaryFeeAmount;
-};
-type GetQuoteBody = {
-    /**
-     * Source asset in fiat. Amount can be set in `source` or `destination`.
-     */
-    source: {
-        /**
-         * The currency or token being spent
-         */
-        asset: AssetBase;
-        /**
-         * A stringified amount, which can include decimals.
-         */
-        amount?: string;
-    };
-    /**
-     * Destination asset in crypto. Amount can be set in `destination` or `source`. For DeFi tokens, identify the asset by `caip19` and set the amount on `source` only (quoting by destination token amount is not supported).
-     */
-    destination: {
-        asset: BuyQuoteDestinationAsset;
-        /**
-         * The amount being received, if known
-         */
-        amount?: string;
-    };
-    /**
-     * Wallet address and optional tag where the crypto will be sent. Required for the quote to be executable.
-     */
-    wallet?: Wallet;
-    /**
-     * Payment method for the transaction. Required for the quote to be executable.
-     */
-    paymentMethod?: QuotePaymentMethod;
-};
-/**
- * Quote for a fiat-to-crypto buy. Contains locked rate, fees, expiry, and signature for payment execution.
- */
-type GetQuoteResponse = {
-    /**
-     * Source side of the quote: amount and asset (fiat currency) you send.
-     */
-    source: {
-        /**
-         * A stringified amount, which can include decimals.
-         */
-        amount: string;
-        /**
-         * The currency or token being spent
-         */
-        asset: Asset;
-    };
-    /**
-     * Destination side of the quote: amount and asset (cryptocurrency) the customer receives.
-     */
-    destination: {
-        /**
-         * A stringified amount, which can include decimals.
-         */
-        amount: string;
-        asset: QuoteDestinationAsset;
-    };
-    /**
-     * Breakdown of network, MoonPay, and ecosystem fees.
-     */
-    fees: Fees;
-    /**
-     * Wallet address and optional tag where the crypto will be sent. Null when not provided.
-     */
-    wallet: Wallet | null;
-    /**
-     * The payment method used for the quote.
-     */
-    paymentMethod: QuotePaymentMethod | null;
-    limits: QuoteLimits | null;
-    /**
-     * An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the quote expires.
-     */
-    expiresAt: string;
-    /**
-     * Whether the quote can be executed. Only `executable` quotes can be used to initiate payment frames.
-     */
-    executable: boolean;
-    /**
-     * The rate used to convert fiat <-> crypto, expressed as the fiat value of one unit of crypto (e.g. `1 SOL = {exchangeRate} USD`).
-     */
-    exchangeRate: string;
-    /**
-     * Slippage tolerance applied to the DeFi swap, in basis points (e.g. `50` = 0.5%). Only present when the destination is a DeFi token.
-     */
-    slippageBps?: number;
-    /**
-     * Disclosures the partner must render verbatim before the customer can complete the transaction. Empty when no disclosure is required for the customer's geography, payment method, and asset combination.
-     */
-    paymentDisclosures: Array<PaymentDisclosure>;
-    /**
-     * An opaque token representing the quote to initiate payment frames.
-     */
-    signature: string;
-};
-type IPv4Address = string;
-type IPv6Address = string;
-type LimitWithAsset = {
-    /**
-     * A stringified amount, which can include decimals.
-     */
-    amount: string;
-    asset: AssetBase;
-};
-type MonetaryFeeAmount = {
-    /**
-     * The amount of fees in fiat.
-     */
-    amount: string;
-    /**
-     * The fiat currency used to pay the fees.
-     */
-    asset: AssetBase;
-};
-type MoonPayCorePaginationInfo = {
-    /**
-     * The cursor to use as the starting point for the next page of results.
-     */
-    nextCursor: string | null;
-};
-/**
- * The card network brand.
- */
-type MoonPayPaymentsCardBrand = 'visa' | 'mastercard' | 'maestro' | 'american_express' | 'other';
-/**
- * The type of card: credit, debit, or unknown.
- */
-type MoonPayPaymentsCardType = 'credit' | 'debit' | 'unknown';
-type MoonPayPaymentsListPaymentMethodsResponse = {
-    /**
-     * List of available payment method configurations
-     */
-    paymentMethodConfigs?: Array<MoonPayPaymentsPaymentMethod>;
-    /**
-     * List of stored payment methods available for the customer
-     */
-    paymentMethods?: Array<MoonPayPaymentsStoredPaymentMethod>;
-};
-type MoonPayPaymentsPaymentMethod = {
-    type: PaymentMethodType;
-    /**
-     * Details of how the payment method can be used.
-     */
-    capabilities: MoonPayPaymentsPaymentMethodCapabilities;
-    availability: MoonPayPaymentsPaymentMethodAvailability;
-};
-type MoonPayPaymentsPaymentMethodAvailability = {
-    /**
-     * Whether the payment method is available
-     */
-    active: boolean;
-    /**
-     * If the payment method is not available, reasons explaining why.
-     */
-    reasons?: Array<string>;
-};
-type MoonPayPaymentsPaymentMethodCapabilities = {
-    /**
-     * [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes of fiat currencies supported by this payment method.
-     */
-    supportedCurrencies: Array<string>;
-    /**
-     * Transaction types supported by this payment method.
-     */
-    supportedTransactionTypes: Array<string>;
-    /**
-     * Whether this payment method can be deleted.
-     */
-    allowsDeletion: boolean;
-    /**
-     * Whether this payment method requires the MoonPay widget to complete the payment flow.
-     */
-    requiresWidget: boolean;
-};
-type MoonPayPaymentsStoredCardPaymentMethod = MoonPayPaymentsStoredPaymentMethodBase & {
-    cardType: MoonPayPaymentsCardType;
-    /**
-     * The card network brand
-     */
-    brand: MoonPayPaymentsCardBrand;
-    /**
-     * Last 4 digits of the card number
-     */
-    last4: string;
-    /**
-     * Expiration month as 2-digit string
-     */
-    expirationMonth: string;
-    /**
-     * Expiration year as 4-digit string
-     */
-    expirationYear: string;
-    /**
-     * Current availability of this stored card
-     */
-    availability: MoonPayPaymentsPaymentMethodAvailability;
-};
-/**
- * A stored payment method.
- */
-type MoonPayPaymentsStoredPaymentMethod = MoonPayPaymentsStoredPaymentMethodBase | MoonPayPaymentsStoredCardPaymentMethod;
-type MoonPayPaymentsStoredPaymentMethodBase = {
-    /**
-     * Unique identifier for the stored payment method
-     */
-    id: string;
-    type: PaymentMethodType;
-};
-/**
- * A payment disclosure that the partner must render verbatim before the customer can complete the transaction.
- */
-type PaymentDisclosure = {
-    /**
-     * Stable identifier of the disclosure. Each id maps to one specific piece of text. The full list of ids and their canonical text is published in the developer documentation.
-     */
-    id: string;
-    /**
-     * Version of the disclosure text. Bumped whenever the canonical wording for this `id` changes. Partners that receive an unknown `(id, version)` pair should fall back to a conservative disclosure and alert their integration team.
-     */
-    version: string;
-};
-type PaymentMethodType = 'apple_pay' | 'card' | 'ach' | 'fps' | 'fps_open_banking' | 'google_pay' | 'sepa' | 'sepa_open_banking' | 'pix' | 'paypal' | 'venmo' | 'revolut_pay' | 'moonpay_balance' | 'interac';
-/**
- * A crypto asset available for purchase through MoonPay.
- */
-type PlatformAsset = {
-    /**
-     * The CAIP-19 asset identifier (encodes chain and contract). Use this value when creating quotes for unverified tokens.
-     */
-    caip19: string;
-    /**
-     * The asset code. Use this value when creating quotes for verified tokens.
-     */
-    code: string;
-    /**
-     * The human-readable name of the asset.
-     */
-    name: string;
-    /**
-     * The blockchain network code this asset belongs to.
-     */
-    network: string;
-    /**
-     * The on-chain contract address. Null for native gas tokens.
-     */
-    contractAddress: string | null;
-    /**
-     * The number of decimal places used on-chain, or null if unknown.
-     */
-    decimals: number | null;
-    /**
-     * The maximum decimal places MoonPay supports for trading this asset, or null if unknown.
-     */
-    precision: number | null;
-    status: AssetStatus;
-};
-/**
- * Destination crypto asset returned on the quote. Adds the resolved network and, for DeFi tokens, the CAIP-19 identifier on top of the base asset fields.
- */
-type QuoteDestinationAsset = {
-    /**
-     * A fiat or crypto currency code.
-     *
-     * **Fiat**
-     * Fiat codes are represented as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) codes.
-     *
-     * Currently only `USD` is supported.
-     *
-     * **Crypto**
-     * For crypto currency codes, see [supported currencies](https://dev.moonpay.com/docs/list-of-supported-cryptocurrencies).
-     *
-     * Examples: `BTC` `SOL` `ETH` `USDC_BASE` `USDC_SOL`
-     */
-    code: string;
-    /**
-     * The human-readable name
-     */
-    name?: string;
-    /**
-     * The number of supported decimal places
-     */
-    precision?: number;
-    /**
-     * The CAIP-19 asset identifier (encodes chain and contract). Present for DeFi tokens.
-     */
-    caip19?: string;
-};
-type QuoteLimitEntry = {
-    /**
-     * The maximum amount.
-     */
-    limit: LimitWithAsset;
-    /**
-     * The remaining amount.
-     */
-    remaining: LimitWithAsset;
-};
-/**
- * Limits applicable to the quote.
- */
-type QuoteLimits = {
-    /**
-     * The daily limit.
-     */
-    daily?: QuoteLimitEntry;
-    /**
-     * The monthly limit.
-     */
-    monthly?: QuoteLimitEntry;
-    /**
-     * The yearly limit.
-     */
-    yearly?: QuoteLimitEntry;
-};
-type QuotePaymentMethod = {
-    type: PaymentMethodType;
-    /**
-     * Unique identifier of the payment method. Used to identify the specific card when type is card.
-     */
-    id?: string;
-};
-/**
- * A stage in the transaction lifecycle
- */
-type Stage = {
-    kind?: StageKind;
-    /**
-     * The human-readable name of the stage.
-     */
-    name?: string;
-    status?: StageStatus;
-    /**
-     * A developer-friendly message if the status is `failed`
-     */
-    failureReason?: string | null;
-};
-/**
- * The stages in a transaction lifecycle.
- */
-type StageKind = 'ordering' | 'waiting_payment' | 'waiting_authentication' | 'verification' | 'processing' | 'delivery' | 'crypto_hold';
-/**
- * The status of a transaction stage.
- */
-type StageStatus = 'not_started' | 'in_progress' | 'success' | 'failed';
-type Transaction = {
-    /**
-     * The MoonPay ID of the transaction.
-     */
-    id: string;
-    /**
-     * An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the transaction was created.
-     */
-    createdAt: string;
-    /**
-     * An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp of when the transaction was last updated.
-     */
-    updatedAt: string;
-    status: TransactionStatus;
-    /**
-     * Source amount and asset (fiat currency) the customer paid.
-     */
-    source: {
-        /**
-         * A stringified amount, which can include decimals.
-         */
-        amount: string;
-        /**
-         * The currency or token being spent
-         */
-        asset: AssetBase;
-    };
-    /**
-     * Destination amount and asset (cryptocurrency) the customer receives.
-     */
-    destination: {
-        /**
-         * A stringified amount, which can include decimals.
-         */
-        amount: string;
-        asset: AssetBase;
-    };
-    /**
-     * Details of fees for the transaction.
-     */
-    fees: Fees;
-    /**
-     * The wallet used for the transaction.
-     */
-    wallet: Wallet;
-    customer: TransactionCustomer;
-    paymentMethod?: TransactionPaymentMethod;
-};
-type TransactionCustomer = {
-    /**
-     * The MoonPay ID of the customer associated with the transaction.
-     */
-    id: string;
-};
-type TransactionPaymentMethod = {
-    type: PaymentMethodType;
-};
-/**
- * The status of a transaction.
- *
- * - `completed`: The transaction is finalized and assets were delivered.
- * - `failed`: The transaction failed. No payment was executed and funds were not transferred.
- * - `pending`: The transaction was created and payment is accepted. The transfer is in progress.
- */
-type TransactionStatus = 'completed' | 'failed' | 'pending';
-/**
- * Transaction with lifecycle stages showing step-by-step progress.
- */
-type TransactionWithStages = Transaction & {
-    /**
-     * Details of the stages in the transaction lifecycle.
-     */
-    stages?: Array<Stage>;
-};
-type Wallet = {
-    /**
-     * The wallet address used for the transaction.
-     */
-    address: string;
-    /**
-     * An optional memo or destination tag (used by some blockchains such as XRP or XLM).
-     */
-    tag?: string;
-};
-type AssetControllerListAssetsResponses = {
-    /**
-     * The request has succeeded.
-     */
-    200: {
-        data: Array<PlatformAsset>;
-        pageInfo: MoonPayCorePaginationInfo;
-    };
-};
-type AssetControllerListAssetsResponse = AssetControllerListAssetsResponses[keyof AssetControllerListAssetsResponses];
-
-export type { Asset, AssetBase, AssetStatus, CreateSessionTokenRequestBody, CreateSessionTokenResponse as CreateSessionTokenReturnType, Fees, GetQuoteBody as GetQuoteParams, LimitWithAsset, AssetControllerListAssetsResponse as ListAssetsResponse, MoonPayPaymentsListPaymentMethodsResponse as ListPaymentMethodsResponse, MonetaryFeeAmount, MoonPayCorePaginationInfo as PaginationInfo, MoonPayPaymentsPaymentMethodAvailability as PaymentMethodAvailability, MoonPayPaymentsPaymentMethodCapabilities as PaymentMethodCapabilities, MoonPayPaymentsPaymentMethod as PaymentMethodConfig, PaymentMethodType, PlatformAsset, GetQuoteResponse as Quote, QuoteLimitEntry, QuoteLimits, QuotePaymentMethod, Stage, StageKind, StageStatus, MoonPayPaymentsStoredCardPaymentMethod as StoredCardPaymentMethod, MoonPayPaymentsStoredPaymentMethod as StoredPaymentMethod, Transaction, TransactionCustomer, TransactionPaymentMethod, TransactionStatus, TransactionWithStages, Wallet };
+export { A as Asset, y as AssetBase, z as AssetStatus, B as CreateSessionTokenRequestBody, D as CreateSessionTokenReturnType, F as Fees, G as GetQuoteParams, L as LimitWithAsset, E as ListAssetsResponse, M as ListPaymentMethodsResponse, H as MonetaryFeeAmount, J as PaginationInfo, K as PaymentMethodAvailability, N as PaymentMethodCapabilities, O as PaymentMethodConfig, P as PaymentMethodType, Q as PlatformAsset, T as Quote, V as QuoteLimitEntry, W as QuoteLimits, X as QuotePaymentMethod, Y as Stage, Z as StageKind, _ as StageStatus, $ as StoredCardPaymentMethod, a0 as StoredPaymentMethod, a1 as Transaction, a2 as TransactionCustomer, a3 as TransactionPaymentMethod, a4 as TransactionStatus, a5 as TransactionWithStages, a6 as Wallet } from './customer.js';

package/dist/frames/customer-export.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/frames/customer-export.ts
+var customer_export_exports = {};
+module.exports = __toCommonJS(customer_export_exports);
+//# sourceMappingURL=customer-export.cjs.map

package/dist/frames/customer-export.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frames/customer-export.ts"],"sourcesContent":["import type { ConnectionError } from '../models/connection.js';\n\nexport interface MessageMap {\n  ready: void;\n  error: ConnectionError;\n  /**\n   * The customer authorized the export. Forward `token` to your backend and\n   * call `exportCustomer` (node SDK) before `tokenExpiresAt`.\n   */\n  complete: { token: string; tokenExpiresAt: string };\n  close: void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/frames/customer-export.d.cts

@@ -0,0 +1,17 @@
+import { ConnectionError } from '../models/connection.cjs';
+
+interface MessageMap {
+    ready: void;
+    error: ConnectionError;
+    /**
+     * The customer authorized the export. Forward `token` to your backend and
+     * call `exportCustomer` (node SDK) before `tokenExpiresAt`.
+     */
+    complete: {
+        token: string;
+        tokenExpiresAt: string;
+    };
+    close: void;
+}
+
+export type { MessageMap };

package/dist/frames/customer-export.d.ts

@@ -0,0 +1,17 @@
+import { ConnectionError } from '../models/connection.js';
+
+interface MessageMap {
+    ready: void;
+    error: ConnectionError;
+    /**
+     * The customer authorized the export. Forward `token` to your backend and
+     * call `exportCustomer` (node SDK) before `tokenExpiresAt`.
+     */
+    complete: {
+        token: string;
+        tokenExpiresAt: string;
+    };
+    close: void;
+}
+
+export type { MessageMap };

package/dist/frames/customer-export.js

@@ -0,0 +1 @@
+//# sourceMappingURL=customer-export.js.map

package/dist/frames/customer-export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/models/connection.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/models/connection.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Connection statuses\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionStatus {\n  /**\n   * New or expired user — needs the full connect flow.\n   */\n  connectionRequired = 'connectionRequired',\n\n  /**\n   * Valid connection — encrypted credentials are included.\n   */\n  active = 'active',\n\n  /**\n   * Restricted location — connection cannot be used.\n   */\n  unavailable = 'unavailable',\n\n  /**\n   * KYC decision delayed — may resolve on a subsequent visit.\n   */\n  pending = 'pending',\n\n  /**\n   * Terminal failure — KYC fail, rejection, etc.\n   */\n  failed = 'failed',\n\n  /**\n   * Customer has no valid Terms of Use attestation on file (headless/Identity API partners).\n   * Display Terms of Use in your own UI, capture acceptance, call\n   * `POST /platform/v1/terms/attestations`, then retry the connection.\n   */\n  termsAcceptanceRequired = 'termsAcceptanceRequired',\n}\n\nexport interface ConnectionRequired {\n  status: ConnectionStatus.connectionRequired;\n  /**\n   * Base64-encoded, X25519+AES-GCM encrypted anonymous token payload.\n   * These are frame-internal tokens used by the connect frame — they cannot be\n   * used to call MoonPay APIs directly. Decrypt via `decryptCredentials()` only\n   * if you need the `clientToken` to bootstrap the connect frame manually.\n   */\n  credentials: string;\n  /**\n   * Capabilities and regulatory requirements available before authentication, if any.\n   * Present when guest checkout is enabled for the partner.\n   */\n  capabilities?: CustomerCapabilities;\n}\n\nexport interface ActiveConnection {\n  status: ConnectionStatus.active;\n  /** The authenticated MoonPay customer. */\n  customer: {\n    /** The MoonPay customer ID. */\n    id: string;\n    /** ISO 3166-1 alpha-3 country code for the customer's jurisdiction. */\n    country?: string;\n    /** State or province code within the country (e.g. `'NY'` for New York). Present for US customers only. */\n    administrativeArea?: string;\n    /** Supra-national regulatory area code (e.g. `'EEA'`, `'EFTA'`). Present when the customer is in a regulated area. */\n    area?: string;\n  };\n  /**\n   * Base64-encoded, X25519+AES-GCM encrypted JSON containing:\n   * ```json\n   * {\n   *   \"accessToken\": \"<token>\",\n   *   \"clientToken\": \"<token>\",\n   *   \"expiresAt\": \"<iso8601>\"\n   * }\n   * ```\n   *\n   * - `accessToken`: A token that can be used to make API requests from the client.\n   * - `clientToken`: A token that can be used to initialize sensitive frames such as Apple Pay.\n   * - `expiresAt`: An ISO 8601 formatted string indicating when the tokens expire.\n   */\n  credentials: string;\n  /**\n   * Capabilities and regulatory requirements for the authenticated customer.\n   */\n  capabilities: CustomerCapabilities;\n}\n\nexport interface UnavailableConnection {\n  status: ConnectionStatus.unavailable;\n}\n\nexport interface PendingConnection {\n  status: ConnectionStatus.pending;\n}\n\nexport interface FailedConnection {\n  status: ConnectionStatus.failed;\n  reason: string;\n}\n\nexport interface TermsAcceptanceRequiredConnection {\n  status: ConnectionStatus.termsAcceptanceRequired;\n}\n\n/** Discriminated union of all connection result statuses. */\nexport type Connection =\n  | ConnectionRequired\n  | ActiveConnection\n  | UnavailableConnection\n  | PendingConnection\n  | FailedConnection\n  | TermsAcceptanceRequiredConnection;\n\n// ---------------------------------------------------------------------------\n// Decrypted credentials (what the SDK exposes after decryption)\n// ---------------------------------------------------------------------------\n\nexport interface DecryptedCredentials {\n  accessToken: string;\n  clientToken: string;\n  expiresAt: string;\n}\n\n// ---------------------------------------------------------------------------\n// Customer capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Capabilities and regulatory requirements for the authenticated customer.\n */\nexport interface CustomerCapabilities {\n  /** Capabilities for the ramps (buy and sell) product. */\n  ramps?: RampsCapability;\n  /** Capabilities for the guest checkout flow. Present when guest checkout is enabled for the partner and the session is a guest-checkout session. */\n  guestCheckout?: RampsCapability;\n}\n\n/**\n * Capabilities and requirements for the ramps (buy and sell) product.\n */\nexport interface RampsCapability {\n  /** Regulatory requirements for ramps operations in the customer's jurisdiction. */\n  requirements: RampsRequirements;\n}\n\n/**\n * Regulatory requirements that apply to ramps operations for the customer.\n */\nexport interface RampsRequirements {\n  /**\n   * Present when the customer's jurisdiction requires payment disclosures\n   * before a ramps transaction. Omitted when no disclosures are required.\n   *\n   * @deprecated Use `customer.country`, `customer.administrativeArea`, and `customer.area`\n   * from the active connection instead. This field will be removed in a future release.\n   */\n  paymentDisclosures?: PaymentDisclosuresRequirement;\n}\n\n/**\n * A jurisdiction that requires payment disclosures before a ramps transaction.\n */\nexport interface PaymentDisclosuresRequirement {\n  /** The ISO 3166-1 alpha-3 country code for the jurisdiction. */\n  country: string;\n  /** The state or province code within the country (e.g. `'NY'` for New York). Present for US customers only. */\n  administrativeArea?: string;\n  /** Supra-national regulatory area code (e.g. `'EEA'`, `'EFTA'`). */\n  area?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Connection errors\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionErrorCode {\n  validationError = 'validationError',\n  /** Wire value is `'generic'`. */\n  connectionFailedGeneric = 'generic',\n}\n\nexport interface ConfigValidationFieldError {\n  code: 'invalidSessionToken' | 'invalidClientToken' | 'invalidPublicKey';\n  message: string;\n}\n\nexport type ConnectionError =\n  | {\n      code: ConnectionErrorCode.validationError;\n      errors: ConfigValidationFieldError[];\n    }\n  | {\n      code: ConnectionErrorCode.connectionFailedGeneric;\n      message?: string;\n    };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAK,mBAAL,kBAAKA,sBAAL;AAIL,EAAAA,kBAAA,wBAAqB;AAKrB,EAAAA,kBAAA,YAAS;AAKT,EAAAA,kBAAA,iBAAc;AAKd,EAAAA,kBAAA,aAAU;AAKV,EAAAA,kBAAA,YAAS;AAOT,EAAAA,kBAAA,6BAA0B;AA/BhB,SAAAA;AAAA,GAAA;AA4KL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;","names":["ConnectionStatus","ConnectionErrorCode"]}
+{"version":3,"sources":["../../src/models/connection.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Connection statuses\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionStatus {\n  /**\n   * New or expired user — needs the full connect flow.\n   */\n  connectionRequired = 'connectionRequired',\n\n  /**\n   * Valid connection — encrypted credentials are included.\n   */\n  active = 'active',\n\n  /**\n   * Restricted location — connection cannot be used.\n   */\n  unavailable = 'unavailable',\n\n  /**\n   * KYC decision delayed — may resolve on a subsequent visit.\n   */\n  pending = 'pending',\n\n  /**\n   * Terminal failure — KYC fail, rejection, etc.\n   */\n  failed = 'failed',\n\n  /**\n   * Customer has no valid Terms of Use attestation on file (headless/Identity API partners).\n   * Display Terms of Use in your own UI, capture acceptance, call\n   * `POST /platform/v1/terms/attestations`, then retry the connection.\n   */\n  termsAcceptanceRequired = 'termsAcceptanceRequired',\n}\n\nexport interface ConnectionRequired {\n  status: ConnectionStatus.connectionRequired;\n  /**\n   * Base64-encoded, X25519+AES-GCM encrypted anonymous token payload.\n   * These are frame-internal tokens used by the connect frame — they cannot be\n   * used to call MoonPay APIs directly. Decrypt via `decryptCredentials()` only\n   * if you need the `clientToken` to bootstrap the connect frame manually.\n   */\n  credentials: string;\n  /**\n   * Capabilities and regulatory requirements available before authentication, if any.\n   * Present when guest checkout is enabled for the partner.\n   */\n  capabilities?: CustomerCapabilities;\n  /**\n   * Set when the session's email and phone number resolve to two different\n   * MoonPay customers (a conflict). Partners should route the customer\n   * through Connect proactively before rendering payment UI (e.g. Apple Pay).\n   *\n   * Note: the check-connection frame does not emit this field yet — treat\n   * it as absent until frame support ships.\n   */\n  mismatch?: boolean;\n}\n\nexport interface ActiveConnection {\n  status: ConnectionStatus.active;\n  /** The authenticated MoonPay customer. */\n  customer: {\n    /** The MoonPay customer ID. */\n    id: string;\n    /** ISO 3166-1 alpha-3 country code for the customer's jurisdiction. */\n    country?: string;\n    /** State or province code within the country (e.g. `'NY'` for New York). Present for US customers only. */\n    administrativeArea?: string;\n    /** Supra-national regulatory area code (e.g. `'EEA'`, `'EFTA'`). Present when the customer is in a regulated area. */\n    area?: string;\n  };\n  /**\n   * Base64-encoded, X25519+AES-GCM encrypted JSON containing:\n   * ```json\n   * {\n   *   \"accessToken\": \"<token>\",\n   *   \"clientToken\": \"<token>\",\n   *   \"expiresAt\": \"<iso8601>\"\n   * }\n   * ```\n   *\n   * - `accessToken`: A token that can be used to make API requests from the client.\n   * - `clientToken`: A token that can be used to initialize sensitive frames such as Apple Pay.\n   * - `expiresAt`: An ISO 8601 formatted string indicating when the tokens expire.\n   */\n  credentials: string;\n  /**\n   * Capabilities and regulatory requirements for the authenticated customer.\n   */\n  capabilities: CustomerCapabilities;\n}\n\nexport interface UnavailableConnection {\n  status: ConnectionStatus.unavailable;\n}\n\nexport interface PendingConnection {\n  status: ConnectionStatus.pending;\n}\n\nexport interface FailedConnection {\n  status: ConnectionStatus.failed;\n  reason: string;\n}\n\nexport interface TermsAcceptanceRequiredConnection {\n  status: ConnectionStatus.termsAcceptanceRequired;\n}\n\n/** Discriminated union of all connection result statuses. */\nexport type Connection =\n  | ConnectionRequired\n  | ActiveConnection\n  | UnavailableConnection\n  | PendingConnection\n  | FailedConnection\n  | TermsAcceptanceRequiredConnection;\n\n// ---------------------------------------------------------------------------\n// Decrypted credentials (what the SDK exposes after decryption)\n// ---------------------------------------------------------------------------\n\nexport interface DecryptedCredentials {\n  accessToken: string;\n  clientToken: string;\n  expiresAt: string;\n}\n\n// ---------------------------------------------------------------------------\n// Customer capabilities\n// ---------------------------------------------------------------------------\n\n/**\n * Capabilities and regulatory requirements for the authenticated customer.\n */\nexport interface CustomerCapabilities {\n  /** Capabilities for the ramps (buy and sell) product. */\n  ramps?: RampsCapability;\n  /** Capabilities for the guest checkout flow. Present when guest checkout is enabled for the partner and the session is a guest-checkout session. */\n  guestCheckout?: RampsCapability;\n}\n\n/**\n * Capabilities and requirements for the ramps (buy and sell) product.\n */\nexport interface RampsCapability {\n  /** Regulatory requirements for ramps operations in the customer's jurisdiction. */\n  requirements: RampsRequirements;\n}\n\n/**\n * Regulatory requirements that apply to ramps operations for the customer.\n */\nexport interface RampsRequirements {\n  /**\n   * Present when the customer's jurisdiction requires payment disclosures\n   * before a ramps transaction. Omitted when no disclosures are required.\n   *\n   * @deprecated Use `customer.country`, `customer.administrativeArea`, and `customer.area`\n   * from the active connection instead. This field will be removed in a future release.\n   */\n  paymentDisclosures?: PaymentDisclosuresRequirement;\n}\n\n/**\n * A jurisdiction that requires payment disclosures before a ramps transaction.\n */\nexport interface PaymentDisclosuresRequirement {\n  /** The ISO 3166-1 alpha-3 country code for the jurisdiction. */\n  country: string;\n  /** The state or province code within the country (e.g. `'NY'` for New York). Present for US customers only. */\n  administrativeArea?: string;\n  /** Supra-national regulatory area code (e.g. `'EEA'`, `'EFTA'`). */\n  area?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Connection errors\n// ---------------------------------------------------------------------------\n\nexport enum ConnectionErrorCode {\n  validationError = 'validationError',\n  /** Wire value is `'generic'`. */\n  connectionFailedGeneric = 'generic',\n}\n\nexport interface ConfigValidationFieldError {\n  code: 'invalidSessionToken' | 'invalidClientToken' | 'invalidPublicKey';\n  message: string;\n}\n\nexport type ConnectionError =\n  | {\n      code: ConnectionErrorCode.validationError;\n      errors: ConfigValidationFieldError[];\n    }\n  | {\n      code: ConnectionErrorCode.connectionFailedGeneric;\n      message?: string;\n    };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,IAAK,mBAAL,kBAAKA,sBAAL;AAIL,EAAAA,kBAAA,wBAAqB;AAKrB,EAAAA,kBAAA,YAAS;AAKT,EAAAA,kBAAA,iBAAc;AAKd,EAAAA,kBAAA,aAAU;AAKV,EAAAA,kBAAA,YAAS;AAOT,EAAAA,kBAAA,6BAA0B;AA/BhB,SAAAA;AAAA,GAAA;AAqLL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;","names":["ConnectionStatus","ConnectionErrorCode"]}

package/dist/models/connection.d.cts

@@ -40,6 +40,15 @@ interface ConnectionRequired {
      * Present when guest checkout is enabled for the partner.
      */
     capabilities?: CustomerCapabilities;
+    /**
+     * Set when the session's email and phone number resolve to two different
+     * MoonPay customers (a conflict). Partners should route the customer
+     * through Connect proactively before rendering payment UI (e.g. Apple Pay).
+     *
+     * Note: the check-connection frame does not emit this field yet — treat
+     * it as absent until frame support ships.
+     */
+    mismatch?: boolean;
 }
 interface ActiveConnection {
     status: ConnectionStatus.active;