@moonpay/platform-protocol 0.2.2 → 0.3.0-next.1

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/connection.ts","../src/errors.ts","../src/message.ts","../src/result.ts"],"sourcesContent":["// API types (clean aliases from generated OpenAPI types)\nexport type {\n  Asset,\n  AssetBase,\n  CreateSessionTokenRequestBody,\n  CreateSessionTokenReturnType,\n  Fees,\n  GetQuoteParams,\n  LimitWithAsset,\n  ListPaymentMethodsResponse,\n  MonetaryFeeAmount,\n  PaginationInfo,\n  PaymentMethodAvailability,\n  PaymentMethodCapabilities,\n  PaymentMethodConfig,\n  PaymentMethodType,\n  Quote,\n  QuoteLimitEntry,\n  QuoteLimits,\n  QuotePaymentMethod,\n  Stage,\n  StageKind,\n  StageStatus,\n  StoredCardPaymentMethod,\n  StoredPaymentMethod,\n  TermsAttestation,\n  Transaction,\n  TransactionCustomer,\n  TransactionPaymentMethod,\n  TransactionStatus,\n  TransactionWithStages,\n  Wallet,\n} from './api.js';\n// Commands (parent → child)\nexport type {\n  SetBuyButtonQuoteCommand,\n  SetBuyQuoteCommand,\n  SetGooglePayQuoteCommand,\n  SetQuoteCommand,\n} from './commands.js';\n// Connection statuses\nexport {\n  type ActiveConnection,\n  type Connection,\n  type ConnectionRequired,\n  ConnectionStatus,\n  type CustomerCapabilities,\n  type DecryptedCredentials,\n  type FailedConnection,\n  type PaymentDisclosuresRequirement,\n  type PendingConnection,\n  type RampsCapability,\n  type RampsRequirements,\n  type TermsAcceptanceRequiredConnection,\n  type UnavailableConnection,\n} from './connection.js';\n// Errors\nexport {\n  type ConfigValidationFieldError,\n  type ConnectError,\n  type ConnectionError,\n  ConnectionErrorCode,\n  type CreateSessionError,\n  type DevPlatformApiError,\n  type DevPlatformApiErrorCode,\n  DevPlatformApiErrorCodes,\n  type DevPlatformApiErrorDetail,\n  type GetConnectionError,\n  type GetPaymentMethodsError,\n  type GetQuoteError,\n  type GetTransactionsError,\n  type ResetConnectionError,\n  type RevokeSessionError,\n  type SetupAddCardError,\n  type SetupApplePayError,\n  type SetupBuyButtonError,\n  type SetupBuyError,\n  type SetupChallengeError,\n  type SetupGooglePayError,\n  type SetupWidgetError,\n} from './errors.js';\n// SDK-facing events\nexport type {\n  AddCardEvent,\n  ApplePayEvent,\n  ApplePayEventError,\n  BuyButtonEvent,\n  BuyEvent,\n  CardResponse,\n  ChallengeCancellation,\n  ChallengeCompleteResult,\n  ChallengeEvent,\n  ConnectEvent,\n  GooglePayEvent,\n  GooglePayEventError,\n  WidgetEvent,\n} from './events.js';\n// Protocol message envelope and message maps\nexport type {\n  AddCardMessageMap,\n  ApplePayInboundMessageMap,\n  ApplePayOutboundMessageMap,\n  BuyButtonMessageMap,\n  BuyButtonOutboundMessageMap,\n  BuyMessageMap,\n  BuyOutboundMessageMap,\n  ChallengeMessageMap,\n  ConnectMessageMap,\n  FrameTransaction,\n  GooglePayInboundMessageMap,\n  GooglePayOutboundMessageMap,\n  HandshakeAck,\n  HandshakeRequest,\n  MessageUnion,\n  ProtocolMessage,\n  ResetMessageMap,\n  TypedMessage,\n  WidgetMessageMap,\n} from './message.js';\nexport { HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND } from './message.js';\nexport { type EmptyResult, err, ok, type Result } from './result.js';\n","// ---------------------------------------------------------------------------\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 Apple Pay 1TAP 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: { id: string };\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 Apple Pay 1TAP flow. Present when 1TAP is enabled for the partner and the customer matches. */\n  oneTapApplePay?: 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  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. */\n  administrativeArea: string;\n}\n","// ---------------------------------------------------------------------------\n// Connection errors (from connect/check-connection frames)\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\n// ---------------------------------------------------------------------------\n// API errors\n// ---------------------------------------------------------------------------\n\nexport const DevPlatformApiErrorCodes = {\n  unknownError: 'unknown_error',\n  unauthorized: 'unauthorized',\n  forbidden: 'forbidden',\n  notFound: 'not_found',\n  invalidRequest: 'invalid_request',\n  notImplemented: 'not_implemented',\n  tooManyRequests: 'too_many_requests',\n  notAllowed: 'not_allowed',\n  conflict: 'conflict',\n  unprocessableEntity: 'unprocessable_entity',\n  sseTimeout: 'sse_timeout',\n  sseError: 'sse_error',\n  connectionRequired: 'connection_required',\n  connectionPending: 'connection_pending',\n  connectionUnavailable: 'connection_unavailable',\n  serviceUnavailable: 'service_unavailable',\n  requirementsIncomplete: 'requirements_incomplete',\n  verificationRejected: 'verification_rejected',\n  countryMismatch: 'country_mismatch',\n  unsupportedCountry: 'unsupported_country',\n} as const;\n\nexport type DevPlatformApiErrorCode =\n  (typeof DevPlatformApiErrorCodes)[keyof typeof DevPlatformApiErrorCodes];\n\nexport interface DevPlatformApiErrorDetail {\n  field?: string;\n  message: string;\n}\n\n/** Shape returned by the MoonPay Platform API on error responses. */\nexport interface DevPlatformApiError {\n  code: DevPlatformApiErrorCode;\n  message: string;\n  errors?: DevPlatformApiErrorDetail[];\n}\n\n// ---------------------------------------------------------------------------\n// SDK-level error types\n// ---------------------------------------------------------------------------\n\nexport interface GetConnectionError {\n  message: string;\n}\n\nexport interface ConnectError {\n  message: string;\n}\n\nexport interface SetupWidgetError {\n  kind: 'configurationError' | 'apiError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupApplePayError {\n  kind:\n    | 'invalidQuote'\n    | 'quoteExpired'\n    | 'applePayUnavailable'\n    | 'oneTapApplePaySecondFactorRequired'\n    | 'genericError';\n  message: string;\n}\n\nexport interface SetupGooglePayError {\n  kind: 'invalidQuote' | 'quoteExpired' | 'googlePayUnavailable' | 'genericError';\n  message: string;\n}\n\nexport type GetQuoteError = DevPlatformApiError;\nexport type GetPaymentMethodsError = DevPlatformApiError;\nexport type GetTransactionsError = DevPlatformApiError;\nexport type CreateSessionError = DevPlatformApiError;\nexport type RevokeSessionError = DevPlatformApiError;\n\nexport interface SetupBuyError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupBuyButtonError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupChallengeError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAddCardError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface ResetConnectionError {\n  message: string;\n}\n","// ---------------------------------------------------------------------------\n// Wire format\n// ---------------------------------------------------------------------------\n\n/** The V2 protocol envelope sent over postMessage between frames and SDK. */\nexport interface ProtocolMessage<K extends string = string, P = unknown> {\n  version: 2;\n  meta: { channelId: string };\n  kind: K;\n  payload?: P;\n}\n\n// ---------------------------------------------------------------------------\n// Handshake\n// ---------------------------------------------------------------------------\n\nexport const HANDSHAKE_REQUEST_KIND = 'handshake' as const;\nexport const HANDSHAKE_ACK_KIND = 'ack' as const;\n\nexport type HandshakeRequest = ProtocolMessage<typeof HANDSHAKE_REQUEST_KIND>;\nexport type HandshakeAck = ProtocolMessage<typeof HANDSHAKE_ACK_KIND>;\n\n// ---------------------------------------------------------------------------\n// Frame → Parent message maps\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the widget frame.\n * Frames use this to type-check what they send; SDK uses it to type-check\n * what it receives.\n */\nexport interface WidgetMessageMap {\n  ready: void;\n  error: {\n    code: 'configurationError' | 'apiError' | 'generic';\n    message: string;\n  };\n  transactionCreated: {\n    transaction: { id: string; status: string };\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n  close: void;\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (child → parent direction).\n */\nexport interface ApplePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'applePayUnavailable'\n      | 'generic'\n      | 'oneTapApplePaySecondFactorRequired';\n    message: string;\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (parent → child direction).\n */\nexport interface ApplePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (child → parent direction).\n */\nexport interface GooglePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'googlePayUnavailable'\n      | 'generic';\n    message: string;\n  };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: 'frame'; url: string };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (parent → child direction).\n */\nexport interface GooglePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the connect/check-connection\n * frame (child → parent direction).\n */\nexport interface ConnectMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete:\n    | ConnectionRequired\n    | ActiveConnection\n    | UnavailableConnection\n    | PendingConnection\n    | FailedConnection\n    | TermsAcceptanceRequiredConnection;\n}\n\n// ---------------------------------------------------------------------------\n// Buy frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (child → parent direction).\n *\n * The buy frame executes the full buy pipeline (pre-check → create →\n * post-check) headlessly. It may escalate to a challenge frame mid-pipeline.\n */\nexport interface BuyMessageMap {\n  ready: void;\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (parent → child direction).\n */\nexport interface BuyOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Buy-button frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (child → parent direction).\n *\n * The buy-button frame renders a payment button (card, Apple Pay, Google Pay)\n * and runs the buy pipeline on tap. It may escalate to a challenge frame.\n */\nexport interface BuyButtonMessageMap {\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (parent → child direction).\n */\nexport interface BuyButtonOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Challenge frame\n// ---------------------------------------------------------------------------\n\nexport type ChallengeCompleteResult =\n  | { flow: 'buy'; transaction: FrameTransaction }\n  | { flow: 'identity'; identityId: string };\n\nexport type ChallengeCancellation =\n  | { flow: 'buy'; transactionId?: string; challengeToken?: string }\n  | { flow: 'identity' };\n\n/**\n * Maps message `kind` to its payload type for the challenge frame\n * (child → parent direction).\n *\n * The challenge frame is fully self-contained — it is driven by the\n * `challengeToken` URL param. There is no parent → child message map.\n */\nexport interface ChallengeMessageMap {\n  ready: void;\n  complete: ChallengeCompleteResult;\n  /** User dismissed the challenge. Carry `transactionId` / `challengeToken` to resume. */\n  cancelled: ChallengeCancellation;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Reset frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the reset frame\n * (child → parent direction).\n *\n * The reset frame clears the customer's MoonPay connection for the partner.\n * It is fully driven by the `sessionToken` URL param. There is no\n * parent → child message map.\n */\nexport interface ResetMessageMap {\n  complete: void;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Add-card frame\n// ---------------------------------------------------------------------------\n\n/** Card returned by the add-card frame on successful creation. */\nexport interface CardResponse {\n  id: string;\n  /** Payment method type, e.g. `'card'`. */\n  type: string;\n  /** Card sub-type, e.g. `'credit'` or `'debit'`. */\n  cardType: string;\n  /** Card network brand, e.g. `'visa'` or `'mastercard'`. */\n  brand: string;\n  last4: string;\n  expirationMonth: string;\n  expirationYear: string;\n  availability: { active: true };\n}\n\n/**\n * Maps message `kind` to its payload type for the add-card frame\n * (child → parent direction).\n *\n * There is no parent → child message map for the add-card frame.\n */\nexport interface AddCardMessageMap {\n  complete: { card: CardResponse };\n  error: { code: 'generic' | 'configurationError'; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Transaction type used inside frame messages\n// ---------------------------------------------------------------------------\n\nimport type {\n  ActiveConnection,\n  ConnectionRequired,\n  FailedConnection,\n  PendingConnection,\n  TermsAcceptanceRequiredConnection,\n  UnavailableConnection,\n} from './connection.js';\nimport type { ConnectionError } from './errors.js';\n\n/** Transaction shape as sent within frame postMessage payloads. */\nexport type FrameTransaction =\n  | { id: string; status: string }\n  | { id?: string; status: 'failed'; failureReason: string };\n\n// ---------------------------------------------------------------------------\n// Typed message constructors (utility types)\n// ---------------------------------------------------------------------------\n\n/** A ProtocolMessage typed to a specific message map entry. */\nexport type TypedMessage<\n  Map extends Record<string, unknown>,\n  K extends keyof Map & string,\n> = Map[K] extends void ? ProtocolMessage<K, undefined> : ProtocolMessage<K, Map[K]>;\n\n/** Union of all typed messages for a given message map. */\nexport type MessageUnion<Map extends Record<string, unknown>> = {\n  [K in keyof Map & string]: TypedMessage<Map, K>;\n}[keyof Map & string];\n","/**\n * A discriminated union representing either a successful value or an error.\n * SDK methods return this type instead of throwing exceptions.\n */\nexport type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/** A Result variant for operations that produce no value on success. */\nexport type EmptyResult<E> = { ok: true } | { ok: false; error: E };\n\n/** Construct a successful Result. */\nexport const ok = <T>(value: T): { ok: true; value: T } => ({\n  ok: true,\n  value,\n});\n\n/** Construct a failed Result. */\nexport const err = <E>(error: E): { ok: false; error: E } => ({\n  ok: false,\n  error,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,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;;;ACAL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;AAyBL,IAAM,2BAA2B;AAAA,EACtC,cAAc;AAAA,EACd,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,oBAAoB;AACtB;;;AClCO,IAAM,yBAAyB;AAC/B,IAAM,qBAAqB;;;ACP3B,IAAM,KAAK,CAAI,WAAsC;AAAA,EAC1D,IAAI;AAAA,EACJ;AACF;AAGO,IAAM,MAAM,CAAI,WAAuC;AAAA,EAC5D,IAAI;AAAA,EACJ;AACF;","names":["ConnectionStatus","ConnectionErrorCode"]}
+{"version":3,"sources":["../src/index.ts","../src/connection.ts","../src/errors.ts","../src/message.ts","../src/result.ts"],"sourcesContent":["// API types (clean aliases from generated OpenAPI types)\nexport type {\n  Asset,\n  AssetBase,\n  CreateSessionTokenRequestBody,\n  CreateSessionTokenReturnType,\n  Fees,\n  GetQuoteParams,\n  LimitWithAsset,\n  ListPaymentMethodsResponse,\n  MonetaryFeeAmount,\n  PaginationInfo,\n  PaymentMethodAvailability,\n  PaymentMethodCapabilities,\n  PaymentMethodConfig,\n  PaymentMethodType,\n  Quote,\n  QuoteLimitEntry,\n  QuoteLimits,\n  QuotePaymentMethod,\n  Stage,\n  StageKind,\n  StageStatus,\n  StoredCardPaymentMethod,\n  StoredPaymentMethod,\n  TermsAttestation,\n  Transaction,\n  TransactionCustomer,\n  TransactionPaymentMethod,\n  TransactionStatus,\n  TransactionWithStages,\n  Wallet,\n} from './api.js';\n// Commands (parent → child)\nexport type {\n  SetBuyButtonQuoteCommand,\n  SetBuyQuoteCommand,\n  SetGooglePayQuoteCommand,\n  SetQuoteCommand,\n} from './commands.js';\n// Connection statuses\nexport {\n  type ActiveConnection,\n  type Connection,\n  type ConnectionRequired,\n  ConnectionStatus,\n  type CustomerCapabilities,\n  type DecryptedCredentials,\n  type FailedConnection,\n  type PaymentDisclosuresRequirement,\n  type PendingConnection,\n  type RampsCapability,\n  type RampsRequirements,\n  type TermsAcceptanceRequiredConnection,\n  type UnavailableConnection,\n} from './connection.js';\n// Errors\nexport {\n  type ConfigValidationFieldError,\n  type ConnectError,\n  type ConnectionError,\n  ConnectionErrorCode,\n  type CreateIdentityError,\n  type CreateSessionError,\n  type DevPlatformApiError,\n  type DevPlatformApiErrorCode,\n  DevPlatformApiErrorCodes,\n  type DevPlatformApiErrorDetail,\n  type GetConnectionError,\n  type GetIdentityError,\n  type GetIdentityUploadUrlError,\n  type GetPaymentMethodsError,\n  type GetQuoteError,\n  type GetTransactionsError,\n  type ResetConnectionError,\n  type RevokeSessionError,\n  type SetupAddCardError,\n  type SetupApplePayError,\n  type SetupAuthError,\n  type SetupBuyButtonError,\n  type SetupBuyError,\n  type SetupChallengeError,\n  type SetupGooglePayError,\n  type SetupWidgetError,\n  type SubmitIdentityFilesError,\n  type UpdateIdentityError,\n  type VerifyIdentityError,\n} from './errors.js';\n// SDK-facing events\nexport type {\n  AddCardEvent,\n  ApplePayEvent,\n  ApplePayEventError,\n  AuthEvent,\n  BuyButtonEvent,\n  BuyEvent,\n  CardResponse,\n  ChallengeCancellation,\n  ChallengeCompleteResult,\n  ChallengeEvent,\n  ConnectEvent,\n  GooglePayEvent,\n  GooglePayEventError,\n  WidgetEvent,\n} from './events.js';\n// Identity API\nexport type {\n  CapabilityProduct,\n  CreateIdentityRequestBody,\n  CreateIdentityResidentialAddress,\n  Identity,\n  IdentityBasicDetailsSubmission,\n  IdentityCapability,\n  IdentityFileMimeType,\n  IdentityFileSide,\n  IdentityFileSubmission,\n  IdentityFileType,\n  IdentityFileUploadUrl,\n  IdentityFileUploadUrlHeaders,\n  IdentityFileUploadUrlRequestBody,\n  IdentityPhoneNumberSubmission,\n  IdentityResidentialAddressSubmission,\n  IdentityStatus,\n  IdentityTaxIdentifierGenericSubmission,\n  IdentityTaxIdentifierSchemeSubmission,\n  IdentityTaxIdentifierSubmission,\n  IdentityTaxIdentifierType,\n  IdentityVerificationChallenge,\n  IdentityVerificationResponse,\n  IdentityVerificationStatus,\n  RequirementEntry,\n  RequirementFieldName,\n  RequirementItemStatus,\n  Requirements,\n  SubmitIdentityFilesRequestBody,\n  UpdateIdentityRequestBody,\n} from './identity.js';\n// Protocol message envelope and message maps\nexport type {\n  AddCardMessageMap,\n  ApplePayInboundMessageMap,\n  ApplePayOutboundMessageMap,\n  AuthMessageMap,\n  BuyButtonMessageMap,\n  BuyButtonOutboundMessageMap,\n  BuyMessageMap,\n  BuyOutboundMessageMap,\n  ChallengeMessageMap,\n  ConnectMessageMap,\n  FrameTransaction,\n  GooglePayInboundMessageMap,\n  GooglePayOutboundMessageMap,\n  HandshakeAck,\n  HandshakeRequest,\n  MessageUnion,\n  ProtocolMessage,\n  ResetMessageMap,\n  TypedMessage,\n  WidgetMessageMap,\n} from './message.js';\nexport { HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND } from './message.js';\nexport { type EmptyResult, err, ok, type Result } from './result.js';\n","// ---------------------------------------------------------------------------\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 Apple Pay 1TAP 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: { id: string };\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 Apple Pay 1TAP flow. Present when 1TAP is enabled for the partner and the customer matches. */\n  oneTapApplePay?: 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  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. */\n  administrativeArea: string;\n}\n","// ---------------------------------------------------------------------------\n// Connection errors (from connect/check-connection frames)\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\n// ---------------------------------------------------------------------------\n// API errors\n// ---------------------------------------------------------------------------\n\nexport const DevPlatformApiErrorCodes = {\n  unknownError: 'unknown_error',\n  unauthorized: 'unauthorized',\n  forbidden: 'forbidden',\n  notFound: 'not_found',\n  invalidRequest: 'invalid_request',\n  notImplemented: 'not_implemented',\n  tooManyRequests: 'too_many_requests',\n  notAllowed: 'not_allowed',\n  conflict: 'conflict',\n  unprocessableEntity: 'unprocessable_entity',\n  sseTimeout: 'sse_timeout',\n  sseError: 'sse_error',\n  connectionRequired: 'connection_required',\n  connectionPending: 'connection_pending',\n  connectionUnavailable: 'connection_unavailable',\n  serviceUnavailable: 'service_unavailable',\n  requirementsIncomplete: 'requirements_incomplete',\n  verificationRejected: 'verification_rejected',\n  countryMismatch: 'country_mismatch',\n  unsupportedCountry: 'unsupported_country',\n} as const;\n\nexport type DevPlatformApiErrorCode =\n  (typeof DevPlatformApiErrorCodes)[keyof typeof DevPlatformApiErrorCodes];\n\nexport interface DevPlatformApiErrorDetail {\n  field?: string;\n  message: string;\n}\n\n/** Shape returned by the MoonPay Platform API on error responses. */\nexport interface DevPlatformApiError {\n  code: DevPlatformApiErrorCode;\n  message: string;\n  errors?: DevPlatformApiErrorDetail[];\n}\n\n// ---------------------------------------------------------------------------\n// SDK-level error types\n// ---------------------------------------------------------------------------\n\nexport interface GetConnectionError {\n  message: string;\n}\n\nexport interface ConnectError {\n  message: string;\n}\n\nexport interface SetupWidgetError {\n  kind: 'configurationError' | 'apiError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupApplePayError {\n  kind:\n    | 'invalidQuote'\n    | 'quoteExpired'\n    | 'applePayUnavailable'\n    | 'oneTapApplePaySecondFactorRequired'\n    | 'genericError';\n  message: string;\n}\n\nexport interface SetupGooglePayError {\n  kind: 'invalidQuote' | 'quoteExpired' | 'googlePayUnavailable' | 'genericError';\n  message: string;\n}\n\nexport type GetQuoteError = DevPlatformApiError;\nexport type GetPaymentMethodsError = DevPlatformApiError;\nexport type GetTransactionsError = DevPlatformApiError;\nexport type CreateSessionError = DevPlatformApiError;\nexport type RevokeSessionError = DevPlatformApiError;\nexport type CreateIdentityError = DevPlatformApiError;\nexport type GetIdentityError = DevPlatformApiError;\nexport type UpdateIdentityError = DevPlatformApiError;\nexport type VerifyIdentityError = DevPlatformApiError;\nexport type GetIdentityUploadUrlError = DevPlatformApiError;\nexport type SubmitIdentityFilesError = DevPlatformApiError;\n\nexport interface SetupBuyError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupBuyButtonError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupChallengeError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAuthError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAddCardError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface ResetConnectionError {\n  message: string;\n}\n","// ---------------------------------------------------------------------------\n// Wire format\n// ---------------------------------------------------------------------------\n\n/** The V2 protocol envelope sent over postMessage between frames and SDK. */\nexport interface ProtocolMessage<K extends string = string, P = unknown> {\n  version: 2;\n  meta: { channelId: string };\n  kind: K;\n  payload?: P;\n}\n\n// ---------------------------------------------------------------------------\n// Handshake\n// ---------------------------------------------------------------------------\n\nexport const HANDSHAKE_REQUEST_KIND = 'handshake' as const;\nexport const HANDSHAKE_ACK_KIND = 'ack' as const;\n\nexport type HandshakeRequest = ProtocolMessage<typeof HANDSHAKE_REQUEST_KIND>;\nexport type HandshakeAck = ProtocolMessage<typeof HANDSHAKE_ACK_KIND>;\n\n// ---------------------------------------------------------------------------\n// Frame → Parent message maps\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the widget frame.\n * Frames use this to type-check what they send; SDK uses it to type-check\n * what it receives.\n */\nexport interface WidgetMessageMap {\n  ready: void;\n  error: {\n    code: 'configurationError' | 'apiError' | 'generic';\n    message: string;\n  };\n  transactionCreated: {\n    transaction: { id: string; status: string };\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n  close: void;\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (child → parent direction).\n */\nexport interface ApplePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'applePayUnavailable'\n      | 'generic'\n      | 'oneTapApplePaySecondFactorRequired';\n    message: string;\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (parent → child direction).\n */\nexport interface ApplePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (child → parent direction).\n */\nexport interface GooglePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'googlePayUnavailable'\n      | 'generic';\n    message: string;\n  };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: 'frame'; url: string };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (parent → child direction).\n */\nexport interface GooglePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the connect/check-connection\n * frame (child → parent direction).\n */\nexport interface ConnectMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete:\n    | ConnectionRequired\n    | ActiveConnection\n    | UnavailableConnection\n    | PendingConnection\n    | FailedConnection\n    | TermsAcceptanceRequiredConnection;\n}\n\n/**\n * Maps message `kind` to its payload type for the auth frame\n * (child → parent direction).\n *\n * The auth frame is the lighter-weight counterpart to the connect frame:\n * partners (typically headless / Identity-API integrations) drive the\n * customer through email/OTP authentication only, then receive the\n * encrypted credentials. The frame is gated on `clientToken` rather than\n * `sessionToken` — partners obtain the `clientToken` via the prior\n * `getConnection()` probe (it is decrypted into `core.context` on a\n * `connectionRequired` result).\n */\nexport interface AuthMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete: ActiveConnection | TermsAcceptanceRequiredConnection;\n}\n\n// ---------------------------------------------------------------------------\n// Buy frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (child → parent direction).\n *\n * The buy frame executes the full buy pipeline (pre-check → create →\n * post-check) headlessly. It may escalate to a challenge frame mid-pipeline.\n */\nexport interface BuyMessageMap {\n  ready: void;\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (parent → child direction).\n */\nexport interface BuyOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Buy-button frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (child → parent direction).\n *\n * The buy-button frame renders a payment button (card, Apple Pay, Google Pay)\n * and runs the buy pipeline on tap. It may escalate to a challenge frame.\n */\nexport interface BuyButtonMessageMap {\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (parent → child direction).\n */\nexport interface BuyButtonOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Challenge frame\n// ---------------------------------------------------------------------------\n\nexport type ChallengeCompleteResult =\n  | { flow: 'buy'; transaction: FrameTransaction }\n  | { flow: 'identity'; identityId: string };\n\nexport type ChallengeCancellation =\n  | { flow: 'buy'; transactionId?: string; challengeToken?: string }\n  | { flow: 'identity' };\n\n/**\n * Maps message `kind` to its payload type for the challenge frame\n * (child → parent direction).\n *\n * The challenge frame is fully self-contained — it is driven by the\n * `challengeToken` URL param. There is no parent → child message map.\n */\nexport interface ChallengeMessageMap {\n  ready: void;\n  complete: ChallengeCompleteResult;\n  /** User dismissed the challenge. Carry `transactionId` / `challengeToken` to resume. */\n  cancelled: ChallengeCancellation;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Reset frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the reset frame\n * (child → parent direction).\n *\n * The reset frame clears the customer's MoonPay connection for the partner.\n * It is fully driven by the `sessionToken` URL param. There is no\n * parent → child message map.\n */\nexport interface ResetMessageMap {\n  complete: void;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Add-card frame\n// ---------------------------------------------------------------------------\n\n/** Card returned by the add-card frame on successful creation. */\nexport interface CardResponse {\n  id: string;\n  /** Payment method type, e.g. `'card'`. */\n  type: string;\n  /** Card sub-type, e.g. `'credit'` or `'debit'`. */\n  cardType: string;\n  /** Card network brand, e.g. `'visa'` or `'mastercard'`. */\n  brand: string;\n  last4: string;\n  expirationMonth: string;\n  expirationYear: string;\n  availability: { active: true };\n}\n\n/**\n * Maps message `kind` to its payload type for the add-card frame\n * (child → parent direction).\n *\n * There is no parent → child message map for the add-card frame.\n */\nexport interface AddCardMessageMap {\n  complete: { card: CardResponse };\n  error: { code: 'generic' | 'configurationError'; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Transaction type used inside frame messages\n// ---------------------------------------------------------------------------\n\nimport type {\n  ActiveConnection,\n  ConnectionRequired,\n  FailedConnection,\n  PendingConnection,\n  TermsAcceptanceRequiredConnection,\n  UnavailableConnection,\n} from './connection.js';\nimport type { ConnectionError } from './errors.js';\n\n/** Transaction shape as sent within frame postMessage payloads. */\nexport type FrameTransaction =\n  | { id: string; status: string }\n  | { id?: string; status: 'failed'; failureReason: string };\n\n// ---------------------------------------------------------------------------\n// Typed message constructors (utility types)\n// ---------------------------------------------------------------------------\n\n/** A ProtocolMessage typed to a specific message map entry. */\nexport type TypedMessage<\n  Map extends Record<string, unknown>,\n  K extends keyof Map & string,\n> = Map[K] extends void ? ProtocolMessage<K, undefined> : ProtocolMessage<K, Map[K]>;\n\n/** Union of all typed messages for a given message map. */\nexport type MessageUnion<Map extends Record<string, unknown>> = {\n  [K in keyof Map & string]: TypedMessage<Map, K>;\n}[keyof Map & string];\n","/**\n * A discriminated union representing either a successful value or an error.\n * SDK methods return this type instead of throwing exceptions.\n */\nexport type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/** A Result variant for operations that produce no value on success. */\nexport type EmptyResult<E> = { ok: true } | { ok: false; error: E };\n\n/** Construct a successful Result. */\nexport const ok = <T>(value: T): { ok: true; value: T } => ({\n  ok: true,\n  value,\n});\n\n/** Construct a failed Result. */\nexport const err = <E>(error: E): { ok: false; error: E } => ({\n  ok: false,\n  error,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,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;;;ACAL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;AAyBL,IAAM,2BAA2B;AAAA,EACtC,cAAc;AAAA,EACd,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,oBAAoB;AACtB;;;AClCO,IAAM,yBAAyB;AAC/B,IAAM,qBAAqB;;;ACP3B,IAAM,KAAK,CAAI,WAAsC;AAAA,EAC1D,IAAI;AAAA,EACJ;AACF;AAGO,IAAM,MAAM,CAAI,WAAuC;AAAA,EAC5D,IAAI;AAAA,EACJ;AACF;","names":["ConnectionStatus","ConnectionErrorCode"]}

package/dist/index.d.cts

@@ -45,7 +45,7 @@ type CreateSessionTokenRequestBody = {
     /**
      * A unique identifier for the customer from your system.
      */
-    externalCustomerId: string;
+    externalCustomerId?: string;
     /**
      * The IP address of the user's device to ensure the integrity of the session. Both IPv4 and IPv6 values are supported.
      */
@@ -171,6 +171,10 @@ type GetQuoteResponse = {
      * The rate used to convert fiat <-> crypto, expressed as the crypto value of one unit of fiat.
      */
     exchangeRate: string;
+    /**
+     * 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.
      */
@@ -289,6 +293,19 @@ type MoonPayPaymentsStoredPaymentMethodBase = {
     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';
 type QuoteLimitEntry = {
     /**
@@ -643,6 +660,12 @@ type GetPaymentMethodsError = DevPlatformApiError;
 type GetTransactionsError = DevPlatformApiError;
 type CreateSessionError = DevPlatformApiError;
 type RevokeSessionError = DevPlatformApiError;
+type CreateIdentityError = DevPlatformApiError;
+type GetIdentityError = DevPlatformApiError;
+type UpdateIdentityError = DevPlatformApiError;
+type VerifyIdentityError = DevPlatformApiError;
+type GetIdentityUploadUrlError = DevPlatformApiError;
+type SubmitIdentityFilesError = DevPlatformApiError;
 interface SetupBuyError {
     kind: 'configurationError' | 'genericError';
     message: string;
@@ -655,6 +678,10 @@ interface SetupChallengeError {
     kind: 'configurationError' | 'genericError';
     message: string;
 }
+interface SetupAuthError {
+    kind: 'configurationError' | 'genericError';
+    message: string;
+}
 interface SetupAddCardError {
     kind: 'configurationError' | 'genericError';
     message: string;
@@ -762,6 +789,23 @@ interface ConnectMessageMap {
     error: ConnectionError;
     complete: ConnectionRequired | ActiveConnection | UnavailableConnection | PendingConnection | FailedConnection | TermsAcceptanceRequiredConnection;
 }
+/**
+ * Maps message `kind` to its payload type for the auth frame
+ * (child → parent direction).
+ *
+ * The auth frame is the lighter-weight counterpart to the connect frame:
+ * partners (typically headless / Identity-API integrations) drive the
+ * customer through email/OTP authentication only, then receive the
+ * encrypted credentials. The frame is gated on `clientToken` rather than
+ * `sessionToken` — partners obtain the `clientToken` via the prior
+ * `getConnection()` probe (it is decrypted into `core.context` on a
+ * `connectionRequired` result).
+ */
+interface AuthMessageMap {
+    ready: void;
+    error: ConnectionError;
+    complete: ActiveConnection | TermsAcceptanceRequiredConnection;
+}
 /**
  * Maps message `kind` to its payload type for the buy frame
  * (child → parent direction).
@@ -1002,6 +1046,15 @@ type ConnectEvent = {
     kind: 'complete';
     payload: ConnectMessageMap['complete'];
 };
+type AuthEvent = {
+    kind: 'ready';
+} | {
+    kind: 'error';
+    payload: AuthMessageMap['error'];
+} | {
+    kind: 'complete';
+    payload: AuthMessageMap['complete'];
+};
 type BuyEvent = {
     kind: 'ready';
 } | {
@@ -1049,6 +1102,161 @@ type AddCardEvent = {
     payload: AddCardMessageMap['error'];
 };
 
+/**
+ * Identity API types.
+ *
+ * Sourced from `moonpay-api/packages/dev-platform/modules/identity/main.tsp`.
+ * The TypeSpec is marked `@vnext` and is not yet emitted into the public
+ * OpenAPI spec, so these types are hand-rolled. Once the spec ships, replace
+ * with aliases re-exported from `./gen/` (same pattern as `Quote`, `Identity`,
+ * etc. in `api.ts`).
+ */
+/** A platform capability a partner wants the customer to unlock. */
+type CapabilityProduct = 'ramps';
+/** A requested capability scoped to an identity. */
+interface IdentityCapability {
+    product: CapabilityProduct;
+}
+/** The state of an identity across the KYC lifecycle. */
+type IdentityStatus = 'created' | 'collecting' | 'verifying' | 'challengeRequired' | 'approved' | 'rejected' | 'manualReview' | 'blocked';
+/** The completion state of a requirement item. */
+type RequirementItemStatus = 'incomplete' | 'complete';
+/** A field a customer must provide to fulfil a requirement. */
+type RequirementFieldName = 'firstName' | 'lastName' | 'dateOfBirth' | 'nationality' | 'street' | 'locality' | 'postalCode' | 'country' | 'administrativeArea' | 'ssn' | 'cpf' | 'tin';
+/** Status of a single requirement group on an identity. */
+interface RequirementEntry {
+    status: RequirementItemStatus;
+    requiredFields?: RequirementFieldName[];
+}
+/** Outstanding and completed requirements for the identity, keyed by category. */
+interface Requirements {
+    basicDetails?: RequirementEntry;
+    residentialAddress?: RequirementEntry;
+    identityDocuments?: RequirementEntry;
+    selfie?: RequirementEntry;
+    taxIdentifiers?: RequirementEntry;
+    proofOfAddress?: RequirementEntry;
+    phoneNumber?: RequirementEntry;
+}
+/** Residential-address fields accepted at identity creation. */
+interface CreateIdentityResidentialAddress {
+    /** ISO 3166-1 alpha-3 country code declared by the partner. */
+    country: string;
+}
+/** Request body for creating an identity. */
+interface CreateIdentityRequestBody {
+    residentialAddress: CreateIdentityResidentialAddress;
+    /** Capabilities the partner wants the customer to unlock. Must contain at least one value. */
+    capabilities: IdentityCapability[];
+}
+/** Customer's basic personal details. */
+interface IdentityBasicDetailsSubmission {
+    firstName?: string;
+    lastName?: string;
+    nationality?: string;
+    /** YYYY-MM-DD. */
+    dateOfBirth?: string;
+}
+/** Customer's residential address. */
+interface IdentityResidentialAddressSubmission {
+    country?: string;
+    administrativeArea?: string;
+    locality?: string;
+    street?: string;
+    subStreet?: string;
+    postalCode?: string;
+}
+/** Customer's phone number in E.164 format. */
+interface IdentityPhoneNumberSubmission {
+    number: string;
+}
+/** Type of tax identifier the customer is submitting. */
+type IdentityTaxIdentifierType = 'tin' | 'ssn' | 'cpf';
+/** Tax Identification Number — country must be supplied. */
+interface IdentityTaxIdentifierGenericSubmission {
+    type: 'tin';
+    country: string;
+    value: string;
+}
+/** Country-specific tax identifier (SSN/CPF). */
+interface IdentityTaxIdentifierSchemeSubmission {
+    type: 'ssn' | 'cpf';
+    value: string;
+}
+type IdentityTaxIdentifierSubmission = IdentityTaxIdentifierGenericSubmission | IdentityTaxIdentifierSchemeSubmission;
+/** Request body for updating an identity by submitting one or more requirements. */
+interface UpdateIdentityRequestBody {
+    residentialAddress?: IdentityResidentialAddressSubmission;
+    basicDetails?: IdentityBasicDetailsSubmission;
+    phoneNumber?: IdentityPhoneNumberSubmission;
+    taxIdentifiers?: IdentityTaxIdentifierSubmission[];
+}
+/** A MoonPay-hosted challenge a partner must surface to the customer. */
+interface IdentityVerificationChallenge {
+    /** Fully-formed challenge URL. */
+    url: string;
+    /** ISO 8601 expiry. */
+    expiresAt: string;
+}
+/** The state of an identity verification request. */
+type IdentityVerificationStatus = 'approved' | 'processing' | 'challengeRequired';
+/** Outcome of `POST /platform/v1/identities/{id}/verifications`. */
+type IdentityVerificationResponse = {
+    status: 'approved';
+} | {
+    status: 'processing';
+} | {
+    status: 'challengeRequired';
+    challenge: IdentityVerificationChallenge;
+};
+/** Type of identity-related file the customer is uploading. */
+type IdentityFileType = 'drivingLicence' | 'nationalIdentityCard' | 'passport' | 'residencePermit' | 'selfie' | 'proofOfAddress';
+/** Side of a two-sided identity document. */
+type IdentityFileSide = 'front' | 'back';
+/** MIME type of the file being uploaded. */
+type IdentityFileMimeType = 'image/jpeg' | 'image/png' | 'application/pdf';
+/** Request body for issuing a presigned upload URL. */
+interface IdentityFileUploadUrlRequestBody {
+    fileType: IdentityFileType;
+    /** Required for two-sided file types (`drivingLicence`, `nationalIdentityCard`, `residencePermit`); omit for single-sided. */
+    side?: IdentityFileSide;
+    /** Must match the `Content-Type` header used on the subsequent upload request. */
+    mimeType: IdentityFileMimeType;
+}
+/** Headers the partner must send when uploading the file to the presigned URL. */
+interface IdentityFileUploadUrlHeaders {
+    'Content-Type': string;
+}
+/** Presigned URL the partner uses to upload an identity-related file. */
+interface IdentityFileUploadUrl {
+    uploadId: string;
+    url: string;
+    /** ISO 8601 expiry. */
+    expiresAt: string;
+    headers: IdentityFileUploadUrlHeaders;
+}
+/** A single uploaded file the partner is confirming for submission. */
+interface IdentityFileSubmission {
+    uploadId: string;
+    fileType: IdentityFileType;
+    side?: IdentityFileSide;
+}
+/** Request body for confirming one or more uploaded identity-related files. */
+interface SubmitIdentityFilesRequestBody {
+    files: IdentityFileSubmission[];
+}
+/** A KYC identity. */
+interface Identity {
+    id: string;
+    status: IdentityStatus;
+    capabilities: IdentityCapability[];
+    requirements: Requirements;
+    /** Present only when `status` is `challengeRequired`. */
+    challenge?: IdentityVerificationChallenge;
+    createdAt: string;
+    updatedAt: string;
+}
+
 /**
  * A discriminated union representing either a successful value or an error.
  * SDK methods return this type instead of throwing exceptions.
@@ -1078,4 +1286,4 @@ declare const err: <E>(error: E) => {
     error: E;
 };
 
-export { type ActiveConnection, type AddCardEvent, type AddCardMessageMap, type ApplePayEvent, type ApplePayEventError, type ApplePayInboundMessageMap, type ApplePayOutboundMessageMap, type Asset, type AssetBase, type BuyButtonEvent, type BuyButtonMessageMap, type BuyButtonOutboundMessageMap, type BuyEvent, type BuyMessageMap, type BuyOutboundMessageMap, type CardResponse, type ChallengeCancellation, type ChallengeCompleteResult, type ChallengeEvent, type ChallengeMessageMap, type ConfigValidationFieldError, type ConnectError, type ConnectEvent, type ConnectMessageMap, type Connection, type ConnectionError, ConnectionErrorCode, type ConnectionRequired, ConnectionStatus, type CreateSessionError, type CreateSessionTokenRequestBody, type CreateSessionTokenResponse as CreateSessionTokenReturnType, type CustomerCapabilities, type DecryptedCredentials, type DevPlatformApiError, type DevPlatformApiErrorCode, DevPlatformApiErrorCodes, type DevPlatformApiErrorDetail, type EmptyResult, type FailedConnection, type Fees, type FrameTransaction, type GetConnectionError, type GetPaymentMethodsError, type GetQuoteError, type GetQuoteBody as GetQuoteParams, type GetTransactionsError, type GooglePayEvent, type GooglePayEventError, type GooglePayInboundMessageMap, type GooglePayOutboundMessageMap, HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND, type HandshakeAck, type HandshakeRequest, type LimitWithAsset, type MoonPayPaymentsListPaymentMethodsResponse as ListPaymentMethodsResponse, type MessageUnion, type MonetaryFeeAmount, type MoonPayCorePaginationInfo as PaginationInfo, type PaymentDisclosuresRequirement, type MoonPayPaymentsPaymentMethodAvailability as PaymentMethodAvailability, type MoonPayPaymentsPaymentMethodCapabilities as PaymentMethodCapabilities, type MoonPayPaymentsPaymentMethod as PaymentMethodConfig, type PaymentMethodType, type PendingConnection, type ProtocolMessage, type GetQuoteResponse as Quote, type QuoteLimitEntry, type QuoteLimits, type QuotePaymentMethod, type RampsCapability, type RampsRequirements, type ResetConnectionError, type ResetMessageMap, type Result, type RevokeSessionError, type SetBuyButtonQuoteCommand, type SetBuyQuoteCommand, type SetGooglePayQuoteCommand, type SetQuoteCommand, type SetupAddCardError, type SetupApplePayError, type SetupBuyButtonError, type SetupBuyError, type SetupChallengeError, type SetupGooglePayError, type SetupWidgetError, type Stage, type StageKind, type StageStatus, type MoonPayPaymentsStoredCardPaymentMethod as StoredCardPaymentMethod, type MoonPayPaymentsStoredPaymentMethod as StoredPaymentMethod, type TermsAcceptanceRequiredConnection, type TermsAttestation, type Transaction, type TransactionCustomer, type TransactionPaymentMethod, type TransactionStatus, type TransactionWithStages, type TypedMessage, type UnavailableConnection, type Wallet, type WidgetEvent, type WidgetMessageMap, err, ok };
+export { type ActiveConnection, type AddCardEvent, type AddCardMessageMap, type ApplePayEvent, type ApplePayEventError, type ApplePayInboundMessageMap, type ApplePayOutboundMessageMap, type Asset, type AssetBase, type AuthEvent, type AuthMessageMap, type BuyButtonEvent, type BuyButtonMessageMap, type BuyButtonOutboundMessageMap, type BuyEvent, type BuyMessageMap, type BuyOutboundMessageMap, type CapabilityProduct, type CardResponse, type ChallengeCancellation, type ChallengeCompleteResult, type ChallengeEvent, type ChallengeMessageMap, type ConfigValidationFieldError, type ConnectError, type ConnectEvent, type ConnectMessageMap, type Connection, type ConnectionError, ConnectionErrorCode, type ConnectionRequired, ConnectionStatus, type CreateIdentityError, type CreateIdentityRequestBody, type CreateIdentityResidentialAddress, type CreateSessionError, type CreateSessionTokenRequestBody, type CreateSessionTokenResponse as CreateSessionTokenReturnType, type CustomerCapabilities, type DecryptedCredentials, type DevPlatformApiError, type DevPlatformApiErrorCode, DevPlatformApiErrorCodes, type DevPlatformApiErrorDetail, type EmptyResult, type FailedConnection, type Fees, type FrameTransaction, type GetConnectionError, type GetIdentityError, type GetIdentityUploadUrlError, type GetPaymentMethodsError, type GetQuoteError, type GetQuoteBody as GetQuoteParams, type GetTransactionsError, type GooglePayEvent, type GooglePayEventError, type GooglePayInboundMessageMap, type GooglePayOutboundMessageMap, HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND, type HandshakeAck, type HandshakeRequest, type Identity, type IdentityBasicDetailsSubmission, type IdentityCapability, type IdentityFileMimeType, type IdentityFileSide, type IdentityFileSubmission, type IdentityFileType, type IdentityFileUploadUrl, type IdentityFileUploadUrlHeaders, type IdentityFileUploadUrlRequestBody, type IdentityPhoneNumberSubmission, type IdentityResidentialAddressSubmission, type IdentityStatus, type IdentityTaxIdentifierGenericSubmission, type IdentityTaxIdentifierSchemeSubmission, type IdentityTaxIdentifierSubmission, type IdentityTaxIdentifierType, type IdentityVerificationChallenge, type IdentityVerificationResponse, type IdentityVerificationStatus, type LimitWithAsset, type MoonPayPaymentsListPaymentMethodsResponse as ListPaymentMethodsResponse, type MessageUnion, type MonetaryFeeAmount, type MoonPayCorePaginationInfo as PaginationInfo, type PaymentDisclosuresRequirement, type MoonPayPaymentsPaymentMethodAvailability as PaymentMethodAvailability, type MoonPayPaymentsPaymentMethodCapabilities as PaymentMethodCapabilities, type MoonPayPaymentsPaymentMethod as PaymentMethodConfig, type PaymentMethodType, type PendingConnection, type ProtocolMessage, type GetQuoteResponse as Quote, type QuoteLimitEntry, type QuoteLimits, type QuotePaymentMethod, type RampsCapability, type RampsRequirements, type RequirementEntry, type RequirementFieldName, type RequirementItemStatus, type Requirements, type ResetConnectionError, type ResetMessageMap, type Result, type RevokeSessionError, type SetBuyButtonQuoteCommand, type SetBuyQuoteCommand, type SetGooglePayQuoteCommand, type SetQuoteCommand, type SetupAddCardError, type SetupApplePayError, type SetupAuthError, type SetupBuyButtonError, type SetupBuyError, type SetupChallengeError, type SetupGooglePayError, type SetupWidgetError, type Stage, type StageKind, type StageStatus, type MoonPayPaymentsStoredCardPaymentMethod as StoredCardPaymentMethod, type MoonPayPaymentsStoredPaymentMethod as StoredPaymentMethod, type SubmitIdentityFilesError, type SubmitIdentityFilesRequestBody, type TermsAcceptanceRequiredConnection, type TermsAttestation, type Transaction, type TransactionCustomer, type TransactionPaymentMethod, type TransactionStatus, type TransactionWithStages, type TypedMessage, type UnavailableConnection, type UpdateIdentityError, type UpdateIdentityRequestBody, type VerifyIdentityError, type Wallet, type WidgetEvent, type WidgetMessageMap, err, ok };

package/dist/index.d.ts

@@ -45,7 +45,7 @@ type CreateSessionTokenRequestBody = {
     /**
      * A unique identifier for the customer from your system.
      */
-    externalCustomerId: string;
+    externalCustomerId?: string;
     /**
      * The IP address of the user's device to ensure the integrity of the session. Both IPv4 and IPv6 values are supported.
      */
@@ -171,6 +171,10 @@ type GetQuoteResponse = {
      * The rate used to convert fiat <-> crypto, expressed as the crypto value of one unit of fiat.
      */
     exchangeRate: string;
+    /**
+     * 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.
      */
@@ -289,6 +293,19 @@ type MoonPayPaymentsStoredPaymentMethodBase = {
     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';
 type QuoteLimitEntry = {
     /**
@@ -643,6 +660,12 @@ type GetPaymentMethodsError = DevPlatformApiError;
 type GetTransactionsError = DevPlatformApiError;
 type CreateSessionError = DevPlatformApiError;
 type RevokeSessionError = DevPlatformApiError;
+type CreateIdentityError = DevPlatformApiError;
+type GetIdentityError = DevPlatformApiError;
+type UpdateIdentityError = DevPlatformApiError;
+type VerifyIdentityError = DevPlatformApiError;
+type GetIdentityUploadUrlError = DevPlatformApiError;
+type SubmitIdentityFilesError = DevPlatformApiError;
 interface SetupBuyError {
     kind: 'configurationError' | 'genericError';
     message: string;
@@ -655,6 +678,10 @@ interface SetupChallengeError {
     kind: 'configurationError' | 'genericError';
     message: string;
 }
+interface SetupAuthError {
+    kind: 'configurationError' | 'genericError';
+    message: string;
+}
 interface SetupAddCardError {
     kind: 'configurationError' | 'genericError';
     message: string;
@@ -762,6 +789,23 @@ interface ConnectMessageMap {
     error: ConnectionError;
     complete: ConnectionRequired | ActiveConnection | UnavailableConnection | PendingConnection | FailedConnection | TermsAcceptanceRequiredConnection;
 }
+/**
+ * Maps message `kind` to its payload type for the auth frame
+ * (child → parent direction).
+ *
+ * The auth frame is the lighter-weight counterpart to the connect frame:
+ * partners (typically headless / Identity-API integrations) drive the
+ * customer through email/OTP authentication only, then receive the
+ * encrypted credentials. The frame is gated on `clientToken` rather than
+ * `sessionToken` — partners obtain the `clientToken` via the prior
+ * `getConnection()` probe (it is decrypted into `core.context` on a
+ * `connectionRequired` result).
+ */
+interface AuthMessageMap {
+    ready: void;
+    error: ConnectionError;
+    complete: ActiveConnection | TermsAcceptanceRequiredConnection;
+}
 /**
  * Maps message `kind` to its payload type for the buy frame
  * (child → parent direction).
@@ -1002,6 +1046,15 @@ type ConnectEvent = {
     kind: 'complete';
     payload: ConnectMessageMap['complete'];
 };
+type AuthEvent = {
+    kind: 'ready';
+} | {
+    kind: 'error';
+    payload: AuthMessageMap['error'];
+} | {
+    kind: 'complete';
+    payload: AuthMessageMap['complete'];
+};
 type BuyEvent = {
     kind: 'ready';
 } | {
@@ -1049,6 +1102,161 @@ type AddCardEvent = {
     payload: AddCardMessageMap['error'];
 };
 
+/**
+ * Identity API types.
+ *
+ * Sourced from `moonpay-api/packages/dev-platform/modules/identity/main.tsp`.
+ * The TypeSpec is marked `@vnext` and is not yet emitted into the public
+ * OpenAPI spec, so these types are hand-rolled. Once the spec ships, replace
+ * with aliases re-exported from `./gen/` (same pattern as `Quote`, `Identity`,
+ * etc. in `api.ts`).
+ */
+/** A platform capability a partner wants the customer to unlock. */
+type CapabilityProduct = 'ramps';
+/** A requested capability scoped to an identity. */
+interface IdentityCapability {
+    product: CapabilityProduct;
+}
+/** The state of an identity across the KYC lifecycle. */
+type IdentityStatus = 'created' | 'collecting' | 'verifying' | 'challengeRequired' | 'approved' | 'rejected' | 'manualReview' | 'blocked';
+/** The completion state of a requirement item. */
+type RequirementItemStatus = 'incomplete' | 'complete';
+/** A field a customer must provide to fulfil a requirement. */
+type RequirementFieldName = 'firstName' | 'lastName' | 'dateOfBirth' | 'nationality' | 'street' | 'locality' | 'postalCode' | 'country' | 'administrativeArea' | 'ssn' | 'cpf' | 'tin';
+/** Status of a single requirement group on an identity. */
+interface RequirementEntry {
+    status: RequirementItemStatus;
+    requiredFields?: RequirementFieldName[];
+}
+/** Outstanding and completed requirements for the identity, keyed by category. */
+interface Requirements {
+    basicDetails?: RequirementEntry;
+    residentialAddress?: RequirementEntry;
+    identityDocuments?: RequirementEntry;
+    selfie?: RequirementEntry;
+    taxIdentifiers?: RequirementEntry;
+    proofOfAddress?: RequirementEntry;
+    phoneNumber?: RequirementEntry;
+}
+/** Residential-address fields accepted at identity creation. */
+interface CreateIdentityResidentialAddress {
+    /** ISO 3166-1 alpha-3 country code declared by the partner. */
+    country: string;
+}
+/** Request body for creating an identity. */
+interface CreateIdentityRequestBody {
+    residentialAddress: CreateIdentityResidentialAddress;
+    /** Capabilities the partner wants the customer to unlock. Must contain at least one value. */
+    capabilities: IdentityCapability[];
+}
+/** Customer's basic personal details. */
+interface IdentityBasicDetailsSubmission {
+    firstName?: string;
+    lastName?: string;
+    nationality?: string;
+    /** YYYY-MM-DD. */
+    dateOfBirth?: string;
+}
+/** Customer's residential address. */
+interface IdentityResidentialAddressSubmission {
+    country?: string;
+    administrativeArea?: string;
+    locality?: string;
+    street?: string;
+    subStreet?: string;
+    postalCode?: string;
+}
+/** Customer's phone number in E.164 format. */
+interface IdentityPhoneNumberSubmission {
+    number: string;
+}
+/** Type of tax identifier the customer is submitting. */
+type IdentityTaxIdentifierType = 'tin' | 'ssn' | 'cpf';
+/** Tax Identification Number — country must be supplied. */
+interface IdentityTaxIdentifierGenericSubmission {
+    type: 'tin';
+    country: string;
+    value: string;
+}
+/** Country-specific tax identifier (SSN/CPF). */
+interface IdentityTaxIdentifierSchemeSubmission {
+    type: 'ssn' | 'cpf';
+    value: string;
+}
+type IdentityTaxIdentifierSubmission = IdentityTaxIdentifierGenericSubmission | IdentityTaxIdentifierSchemeSubmission;
+/** Request body for updating an identity by submitting one or more requirements. */
+interface UpdateIdentityRequestBody {
+    residentialAddress?: IdentityResidentialAddressSubmission;
+    basicDetails?: IdentityBasicDetailsSubmission;
+    phoneNumber?: IdentityPhoneNumberSubmission;
+    taxIdentifiers?: IdentityTaxIdentifierSubmission[];
+}
+/** A MoonPay-hosted challenge a partner must surface to the customer. */
+interface IdentityVerificationChallenge {
+    /** Fully-formed challenge URL. */
+    url: string;
+    /** ISO 8601 expiry. */
+    expiresAt: string;
+}
+/** The state of an identity verification request. */
+type IdentityVerificationStatus = 'approved' | 'processing' | 'challengeRequired';
+/** Outcome of `POST /platform/v1/identities/{id}/verifications`. */
+type IdentityVerificationResponse = {
+    status: 'approved';
+} | {
+    status: 'processing';
+} | {
+    status: 'challengeRequired';
+    challenge: IdentityVerificationChallenge;
+};
+/** Type of identity-related file the customer is uploading. */
+type IdentityFileType = 'drivingLicence' | 'nationalIdentityCard' | 'passport' | 'residencePermit' | 'selfie' | 'proofOfAddress';
+/** Side of a two-sided identity document. */
+type IdentityFileSide = 'front' | 'back';
+/** MIME type of the file being uploaded. */
+type IdentityFileMimeType = 'image/jpeg' | 'image/png' | 'application/pdf';
+/** Request body for issuing a presigned upload URL. */
+interface IdentityFileUploadUrlRequestBody {
+    fileType: IdentityFileType;
+    /** Required for two-sided file types (`drivingLicence`, `nationalIdentityCard`, `residencePermit`); omit for single-sided. */
+    side?: IdentityFileSide;
+    /** Must match the `Content-Type` header used on the subsequent upload request. */
+    mimeType: IdentityFileMimeType;
+}
+/** Headers the partner must send when uploading the file to the presigned URL. */
+interface IdentityFileUploadUrlHeaders {
+    'Content-Type': string;
+}
+/** Presigned URL the partner uses to upload an identity-related file. */
+interface IdentityFileUploadUrl {
+    uploadId: string;
+    url: string;
+    /** ISO 8601 expiry. */
+    expiresAt: string;
+    headers: IdentityFileUploadUrlHeaders;
+}
+/** A single uploaded file the partner is confirming for submission. */
+interface IdentityFileSubmission {
+    uploadId: string;
+    fileType: IdentityFileType;
+    side?: IdentityFileSide;
+}
+/** Request body for confirming one or more uploaded identity-related files. */
+interface SubmitIdentityFilesRequestBody {
+    files: IdentityFileSubmission[];
+}
+/** A KYC identity. */
+interface Identity {
+    id: string;
+    status: IdentityStatus;
+    capabilities: IdentityCapability[];
+    requirements: Requirements;
+    /** Present only when `status` is `challengeRequired`. */
+    challenge?: IdentityVerificationChallenge;
+    createdAt: string;
+    updatedAt: string;
+}
+
 /**
  * A discriminated union representing either a successful value or an error.
  * SDK methods return this type instead of throwing exceptions.
@@ -1078,4 +1286,4 @@ declare const err: <E>(error: E) => {
     error: E;
 };
 
-export { type ActiveConnection, type AddCardEvent, type AddCardMessageMap, type ApplePayEvent, type ApplePayEventError, type ApplePayInboundMessageMap, type ApplePayOutboundMessageMap, type Asset, type AssetBase, type BuyButtonEvent, type BuyButtonMessageMap, type BuyButtonOutboundMessageMap, type BuyEvent, type BuyMessageMap, type BuyOutboundMessageMap, type CardResponse, type ChallengeCancellation, type ChallengeCompleteResult, type ChallengeEvent, type ChallengeMessageMap, type ConfigValidationFieldError, type ConnectError, type ConnectEvent, type ConnectMessageMap, type Connection, type ConnectionError, ConnectionErrorCode, type ConnectionRequired, ConnectionStatus, type CreateSessionError, type CreateSessionTokenRequestBody, type CreateSessionTokenResponse as CreateSessionTokenReturnType, type CustomerCapabilities, type DecryptedCredentials, type DevPlatformApiError, type DevPlatformApiErrorCode, DevPlatformApiErrorCodes, type DevPlatformApiErrorDetail, type EmptyResult, type FailedConnection, type Fees, type FrameTransaction, type GetConnectionError, type GetPaymentMethodsError, type GetQuoteError, type GetQuoteBody as GetQuoteParams, type GetTransactionsError, type GooglePayEvent, type GooglePayEventError, type GooglePayInboundMessageMap, type GooglePayOutboundMessageMap, HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND, type HandshakeAck, type HandshakeRequest, type LimitWithAsset, type MoonPayPaymentsListPaymentMethodsResponse as ListPaymentMethodsResponse, type MessageUnion, type MonetaryFeeAmount, type MoonPayCorePaginationInfo as PaginationInfo, type PaymentDisclosuresRequirement, type MoonPayPaymentsPaymentMethodAvailability as PaymentMethodAvailability, type MoonPayPaymentsPaymentMethodCapabilities as PaymentMethodCapabilities, type MoonPayPaymentsPaymentMethod as PaymentMethodConfig, type PaymentMethodType, type PendingConnection, type ProtocolMessage, type GetQuoteResponse as Quote, type QuoteLimitEntry, type QuoteLimits, type QuotePaymentMethod, type RampsCapability, type RampsRequirements, type ResetConnectionError, type ResetMessageMap, type Result, type RevokeSessionError, type SetBuyButtonQuoteCommand, type SetBuyQuoteCommand, type SetGooglePayQuoteCommand, type SetQuoteCommand, type SetupAddCardError, type SetupApplePayError, type SetupBuyButtonError, type SetupBuyError, type SetupChallengeError, type SetupGooglePayError, type SetupWidgetError, type Stage, type StageKind, type StageStatus, type MoonPayPaymentsStoredCardPaymentMethod as StoredCardPaymentMethod, type MoonPayPaymentsStoredPaymentMethod as StoredPaymentMethod, type TermsAcceptanceRequiredConnection, type TermsAttestation, type Transaction, type TransactionCustomer, type TransactionPaymentMethod, type TransactionStatus, type TransactionWithStages, type TypedMessage, type UnavailableConnection, type Wallet, type WidgetEvent, type WidgetMessageMap, err, ok };
+export { type ActiveConnection, type AddCardEvent, type AddCardMessageMap, type ApplePayEvent, type ApplePayEventError, type ApplePayInboundMessageMap, type ApplePayOutboundMessageMap, type Asset, type AssetBase, type AuthEvent, type AuthMessageMap, type BuyButtonEvent, type BuyButtonMessageMap, type BuyButtonOutboundMessageMap, type BuyEvent, type BuyMessageMap, type BuyOutboundMessageMap, type CapabilityProduct, type CardResponse, type ChallengeCancellation, type ChallengeCompleteResult, type ChallengeEvent, type ChallengeMessageMap, type ConfigValidationFieldError, type ConnectError, type ConnectEvent, type ConnectMessageMap, type Connection, type ConnectionError, ConnectionErrorCode, type ConnectionRequired, ConnectionStatus, type CreateIdentityError, type CreateIdentityRequestBody, type CreateIdentityResidentialAddress, type CreateSessionError, type CreateSessionTokenRequestBody, type CreateSessionTokenResponse as CreateSessionTokenReturnType, type CustomerCapabilities, type DecryptedCredentials, type DevPlatformApiError, type DevPlatformApiErrorCode, DevPlatformApiErrorCodes, type DevPlatformApiErrorDetail, type EmptyResult, type FailedConnection, type Fees, type FrameTransaction, type GetConnectionError, type GetIdentityError, type GetIdentityUploadUrlError, type GetPaymentMethodsError, type GetQuoteError, type GetQuoteBody as GetQuoteParams, type GetTransactionsError, type GooglePayEvent, type GooglePayEventError, type GooglePayInboundMessageMap, type GooglePayOutboundMessageMap, HANDSHAKE_ACK_KIND, HANDSHAKE_REQUEST_KIND, type HandshakeAck, type HandshakeRequest, type Identity, type IdentityBasicDetailsSubmission, type IdentityCapability, type IdentityFileMimeType, type IdentityFileSide, type IdentityFileSubmission, type IdentityFileType, type IdentityFileUploadUrl, type IdentityFileUploadUrlHeaders, type IdentityFileUploadUrlRequestBody, type IdentityPhoneNumberSubmission, type IdentityResidentialAddressSubmission, type IdentityStatus, type IdentityTaxIdentifierGenericSubmission, type IdentityTaxIdentifierSchemeSubmission, type IdentityTaxIdentifierSubmission, type IdentityTaxIdentifierType, type IdentityVerificationChallenge, type IdentityVerificationResponse, type IdentityVerificationStatus, type LimitWithAsset, type MoonPayPaymentsListPaymentMethodsResponse as ListPaymentMethodsResponse, type MessageUnion, type MonetaryFeeAmount, type MoonPayCorePaginationInfo as PaginationInfo, type PaymentDisclosuresRequirement, type MoonPayPaymentsPaymentMethodAvailability as PaymentMethodAvailability, type MoonPayPaymentsPaymentMethodCapabilities as PaymentMethodCapabilities, type MoonPayPaymentsPaymentMethod as PaymentMethodConfig, type PaymentMethodType, type PendingConnection, type ProtocolMessage, type GetQuoteResponse as Quote, type QuoteLimitEntry, type QuoteLimits, type QuotePaymentMethod, type RampsCapability, type RampsRequirements, type RequirementEntry, type RequirementFieldName, type RequirementItemStatus, type Requirements, type ResetConnectionError, type ResetMessageMap, type Result, type RevokeSessionError, type SetBuyButtonQuoteCommand, type SetBuyQuoteCommand, type SetGooglePayQuoteCommand, type SetQuoteCommand, type SetupAddCardError, type SetupApplePayError, type SetupAuthError, type SetupBuyButtonError, type SetupBuyError, type SetupChallengeError, type SetupGooglePayError, type SetupWidgetError, type Stage, type StageKind, type StageStatus, type MoonPayPaymentsStoredCardPaymentMethod as StoredCardPaymentMethod, type MoonPayPaymentsStoredPaymentMethod as StoredPaymentMethod, type SubmitIdentityFilesError, type SubmitIdentityFilesRequestBody, type TermsAcceptanceRequiredConnection, type TermsAttestation, type Transaction, type TransactionCustomer, type TransactionPaymentMethod, type TransactionStatus, type TransactionWithStages, type TypedMessage, type UnavailableConnection, type UpdateIdentityError, type UpdateIdentityRequestBody, type VerifyIdentityError, type Wallet, type WidgetEvent, type WidgetMessageMap, err, ok };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/connection.ts","../src/errors.ts","../src/message.ts","../src/result.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 Apple Pay 1TAP 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: { id: string };\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 Apple Pay 1TAP flow. Present when 1TAP is enabled for the partner and the customer matches. */\n  oneTapApplePay?: 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  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. */\n  administrativeArea: string;\n}\n","// ---------------------------------------------------------------------------\n// Connection errors (from connect/check-connection frames)\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\n// ---------------------------------------------------------------------------\n// API errors\n// ---------------------------------------------------------------------------\n\nexport const DevPlatformApiErrorCodes = {\n  unknownError: 'unknown_error',\n  unauthorized: 'unauthorized',\n  forbidden: 'forbidden',\n  notFound: 'not_found',\n  invalidRequest: 'invalid_request',\n  notImplemented: 'not_implemented',\n  tooManyRequests: 'too_many_requests',\n  notAllowed: 'not_allowed',\n  conflict: 'conflict',\n  unprocessableEntity: 'unprocessable_entity',\n  sseTimeout: 'sse_timeout',\n  sseError: 'sse_error',\n  connectionRequired: 'connection_required',\n  connectionPending: 'connection_pending',\n  connectionUnavailable: 'connection_unavailable',\n  serviceUnavailable: 'service_unavailable',\n  requirementsIncomplete: 'requirements_incomplete',\n  verificationRejected: 'verification_rejected',\n  countryMismatch: 'country_mismatch',\n  unsupportedCountry: 'unsupported_country',\n} as const;\n\nexport type DevPlatformApiErrorCode =\n  (typeof DevPlatformApiErrorCodes)[keyof typeof DevPlatformApiErrorCodes];\n\nexport interface DevPlatformApiErrorDetail {\n  field?: string;\n  message: string;\n}\n\n/** Shape returned by the MoonPay Platform API on error responses. */\nexport interface DevPlatformApiError {\n  code: DevPlatformApiErrorCode;\n  message: string;\n  errors?: DevPlatformApiErrorDetail[];\n}\n\n// ---------------------------------------------------------------------------\n// SDK-level error types\n// ---------------------------------------------------------------------------\n\nexport interface GetConnectionError {\n  message: string;\n}\n\nexport interface ConnectError {\n  message: string;\n}\n\nexport interface SetupWidgetError {\n  kind: 'configurationError' | 'apiError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupApplePayError {\n  kind:\n    | 'invalidQuote'\n    | 'quoteExpired'\n    | 'applePayUnavailable'\n    | 'oneTapApplePaySecondFactorRequired'\n    | 'genericError';\n  message: string;\n}\n\nexport interface SetupGooglePayError {\n  kind: 'invalidQuote' | 'quoteExpired' | 'googlePayUnavailable' | 'genericError';\n  message: string;\n}\n\nexport type GetQuoteError = DevPlatformApiError;\nexport type GetPaymentMethodsError = DevPlatformApiError;\nexport type GetTransactionsError = DevPlatformApiError;\nexport type CreateSessionError = DevPlatformApiError;\nexport type RevokeSessionError = DevPlatformApiError;\n\nexport interface SetupBuyError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupBuyButtonError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupChallengeError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAddCardError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface ResetConnectionError {\n  message: string;\n}\n","// ---------------------------------------------------------------------------\n// Wire format\n// ---------------------------------------------------------------------------\n\n/** The V2 protocol envelope sent over postMessage between frames and SDK. */\nexport interface ProtocolMessage<K extends string = string, P = unknown> {\n  version: 2;\n  meta: { channelId: string };\n  kind: K;\n  payload?: P;\n}\n\n// ---------------------------------------------------------------------------\n// Handshake\n// ---------------------------------------------------------------------------\n\nexport const HANDSHAKE_REQUEST_KIND = 'handshake' as const;\nexport const HANDSHAKE_ACK_KIND = 'ack' as const;\n\nexport type HandshakeRequest = ProtocolMessage<typeof HANDSHAKE_REQUEST_KIND>;\nexport type HandshakeAck = ProtocolMessage<typeof HANDSHAKE_ACK_KIND>;\n\n// ---------------------------------------------------------------------------\n// Frame → Parent message maps\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the widget frame.\n * Frames use this to type-check what they send; SDK uses it to type-check\n * what it receives.\n */\nexport interface WidgetMessageMap {\n  ready: void;\n  error: {\n    code: 'configurationError' | 'apiError' | 'generic';\n    message: string;\n  };\n  transactionCreated: {\n    transaction: { id: string; status: string };\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n  close: void;\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (child → parent direction).\n */\nexport interface ApplePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'applePayUnavailable'\n      | 'generic'\n      | 'oneTapApplePaySecondFactorRequired';\n    message: string;\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (parent → child direction).\n */\nexport interface ApplePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (child → parent direction).\n */\nexport interface GooglePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'googlePayUnavailable'\n      | 'generic';\n    message: string;\n  };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: 'frame'; url: string };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (parent → child direction).\n */\nexport interface GooglePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the connect/check-connection\n * frame (child → parent direction).\n */\nexport interface ConnectMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete:\n    | ConnectionRequired\n    | ActiveConnection\n    | UnavailableConnection\n    | PendingConnection\n    | FailedConnection\n    | TermsAcceptanceRequiredConnection;\n}\n\n// ---------------------------------------------------------------------------\n// Buy frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (child → parent direction).\n *\n * The buy frame executes the full buy pipeline (pre-check → create →\n * post-check) headlessly. It may escalate to a challenge frame mid-pipeline.\n */\nexport interface BuyMessageMap {\n  ready: void;\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (parent → child direction).\n */\nexport interface BuyOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Buy-button frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (child → parent direction).\n *\n * The buy-button frame renders a payment button (card, Apple Pay, Google Pay)\n * and runs the buy pipeline on tap. It may escalate to a challenge frame.\n */\nexport interface BuyButtonMessageMap {\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (parent → child direction).\n */\nexport interface BuyButtonOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Challenge frame\n// ---------------------------------------------------------------------------\n\nexport type ChallengeCompleteResult =\n  | { flow: 'buy'; transaction: FrameTransaction }\n  | { flow: 'identity'; identityId: string };\n\nexport type ChallengeCancellation =\n  | { flow: 'buy'; transactionId?: string; challengeToken?: string }\n  | { flow: 'identity' };\n\n/**\n * Maps message `kind` to its payload type for the challenge frame\n * (child → parent direction).\n *\n * The challenge frame is fully self-contained — it is driven by the\n * `challengeToken` URL param. There is no parent → child message map.\n */\nexport interface ChallengeMessageMap {\n  ready: void;\n  complete: ChallengeCompleteResult;\n  /** User dismissed the challenge. Carry `transactionId` / `challengeToken` to resume. */\n  cancelled: ChallengeCancellation;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Reset frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the reset frame\n * (child → parent direction).\n *\n * The reset frame clears the customer's MoonPay connection for the partner.\n * It is fully driven by the `sessionToken` URL param. There is no\n * parent → child message map.\n */\nexport interface ResetMessageMap {\n  complete: void;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Add-card frame\n// ---------------------------------------------------------------------------\n\n/** Card returned by the add-card frame on successful creation. */\nexport interface CardResponse {\n  id: string;\n  /** Payment method type, e.g. `'card'`. */\n  type: string;\n  /** Card sub-type, e.g. `'credit'` or `'debit'`. */\n  cardType: string;\n  /** Card network brand, e.g. `'visa'` or `'mastercard'`. */\n  brand: string;\n  last4: string;\n  expirationMonth: string;\n  expirationYear: string;\n  availability: { active: true };\n}\n\n/**\n * Maps message `kind` to its payload type for the add-card frame\n * (child → parent direction).\n *\n * There is no parent → child message map for the add-card frame.\n */\nexport interface AddCardMessageMap {\n  complete: { card: CardResponse };\n  error: { code: 'generic' | 'configurationError'; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Transaction type used inside frame messages\n// ---------------------------------------------------------------------------\n\nimport type {\n  ActiveConnection,\n  ConnectionRequired,\n  FailedConnection,\n  PendingConnection,\n  TermsAcceptanceRequiredConnection,\n  UnavailableConnection,\n} from './connection.js';\nimport type { ConnectionError } from './errors.js';\n\n/** Transaction shape as sent within frame postMessage payloads. */\nexport type FrameTransaction =\n  | { id: string; status: string }\n  | { id?: string; status: 'failed'; failureReason: string };\n\n// ---------------------------------------------------------------------------\n// Typed message constructors (utility types)\n// ---------------------------------------------------------------------------\n\n/** A ProtocolMessage typed to a specific message map entry. */\nexport type TypedMessage<\n  Map extends Record<string, unknown>,\n  K extends keyof Map & string,\n> = Map[K] extends void ? ProtocolMessage<K, undefined> : ProtocolMessage<K, Map[K]>;\n\n/** Union of all typed messages for a given message map. */\nexport type MessageUnion<Map extends Record<string, unknown>> = {\n  [K in keyof Map & string]: TypedMessage<Map, K>;\n}[keyof Map & string];\n","/**\n * A discriminated union representing either a successful value or an error.\n * SDK methods return this type instead of throwing exceptions.\n */\nexport type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/** A Result variant for operations that produce no value on success. */\nexport type EmptyResult<E> = { ok: true } | { ok: false; error: E };\n\n/** Construct a successful Result. */\nexport const ok = <T>(value: T): { ok: true; value: T } => ({\n  ok: true,\n  value,\n});\n\n/** Construct a failed Result. */\nexport const err = <E>(error: E): { ok: false; error: E } => ({\n  ok: false,\n  error,\n});\n"],"mappings":";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;;;ACAL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;AAyBL,IAAM,2BAA2B;AAAA,EACtC,cAAc;AAAA,EACd,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,oBAAoB;AACtB;;;AClCO,IAAM,yBAAyB;AAC/B,IAAM,qBAAqB;;;ACP3B,IAAM,KAAK,CAAI,WAAsC;AAAA,EAC1D,IAAI;AAAA,EACJ;AACF;AAGO,IAAM,MAAM,CAAI,WAAuC;AAAA,EAC5D,IAAI;AAAA,EACJ;AACF;","names":["ConnectionStatus","ConnectionErrorCode"]}
+{"version":3,"sources":["../src/connection.ts","../src/errors.ts","../src/message.ts","../src/result.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 Apple Pay 1TAP 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: { id: string };\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 Apple Pay 1TAP flow. Present when 1TAP is enabled for the partner and the customer matches. */\n  oneTapApplePay?: 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  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. */\n  administrativeArea: string;\n}\n","// ---------------------------------------------------------------------------\n// Connection errors (from connect/check-connection frames)\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\n// ---------------------------------------------------------------------------\n// API errors\n// ---------------------------------------------------------------------------\n\nexport const DevPlatformApiErrorCodes = {\n  unknownError: 'unknown_error',\n  unauthorized: 'unauthorized',\n  forbidden: 'forbidden',\n  notFound: 'not_found',\n  invalidRequest: 'invalid_request',\n  notImplemented: 'not_implemented',\n  tooManyRequests: 'too_many_requests',\n  notAllowed: 'not_allowed',\n  conflict: 'conflict',\n  unprocessableEntity: 'unprocessable_entity',\n  sseTimeout: 'sse_timeout',\n  sseError: 'sse_error',\n  connectionRequired: 'connection_required',\n  connectionPending: 'connection_pending',\n  connectionUnavailable: 'connection_unavailable',\n  serviceUnavailable: 'service_unavailable',\n  requirementsIncomplete: 'requirements_incomplete',\n  verificationRejected: 'verification_rejected',\n  countryMismatch: 'country_mismatch',\n  unsupportedCountry: 'unsupported_country',\n} as const;\n\nexport type DevPlatformApiErrorCode =\n  (typeof DevPlatformApiErrorCodes)[keyof typeof DevPlatformApiErrorCodes];\n\nexport interface DevPlatformApiErrorDetail {\n  field?: string;\n  message: string;\n}\n\n/** Shape returned by the MoonPay Platform API on error responses. */\nexport interface DevPlatformApiError {\n  code: DevPlatformApiErrorCode;\n  message: string;\n  errors?: DevPlatformApiErrorDetail[];\n}\n\n// ---------------------------------------------------------------------------\n// SDK-level error types\n// ---------------------------------------------------------------------------\n\nexport interface GetConnectionError {\n  message: string;\n}\n\nexport interface ConnectError {\n  message: string;\n}\n\nexport interface SetupWidgetError {\n  kind: 'configurationError' | 'apiError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupApplePayError {\n  kind:\n    | 'invalidQuote'\n    | 'quoteExpired'\n    | 'applePayUnavailable'\n    | 'oneTapApplePaySecondFactorRequired'\n    | 'genericError';\n  message: string;\n}\n\nexport interface SetupGooglePayError {\n  kind: 'invalidQuote' | 'quoteExpired' | 'googlePayUnavailable' | 'genericError';\n  message: string;\n}\n\nexport type GetQuoteError = DevPlatformApiError;\nexport type GetPaymentMethodsError = DevPlatformApiError;\nexport type GetTransactionsError = DevPlatformApiError;\nexport type CreateSessionError = DevPlatformApiError;\nexport type RevokeSessionError = DevPlatformApiError;\nexport type CreateIdentityError = DevPlatformApiError;\nexport type GetIdentityError = DevPlatformApiError;\nexport type UpdateIdentityError = DevPlatformApiError;\nexport type VerifyIdentityError = DevPlatformApiError;\nexport type GetIdentityUploadUrlError = DevPlatformApiError;\nexport type SubmitIdentityFilesError = DevPlatformApiError;\n\nexport interface SetupBuyError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupBuyButtonError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupChallengeError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAuthError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface SetupAddCardError {\n  kind: 'configurationError' | 'genericError';\n  message: string;\n}\n\nexport interface ResetConnectionError {\n  message: string;\n}\n","// ---------------------------------------------------------------------------\n// Wire format\n// ---------------------------------------------------------------------------\n\n/** The V2 protocol envelope sent over postMessage between frames and SDK. */\nexport interface ProtocolMessage<K extends string = string, P = unknown> {\n  version: 2;\n  meta: { channelId: string };\n  kind: K;\n  payload?: P;\n}\n\n// ---------------------------------------------------------------------------\n// Handshake\n// ---------------------------------------------------------------------------\n\nexport const HANDSHAKE_REQUEST_KIND = 'handshake' as const;\nexport const HANDSHAKE_ACK_KIND = 'ack' as const;\n\nexport type HandshakeRequest = ProtocolMessage<typeof HANDSHAKE_REQUEST_KIND>;\nexport type HandshakeAck = ProtocolMessage<typeof HANDSHAKE_ACK_KIND>;\n\n// ---------------------------------------------------------------------------\n// Frame → Parent message maps\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the widget frame.\n * Frames use this to type-check what they send; SDK uses it to type-check\n * what it receives.\n */\nexport interface WidgetMessageMap {\n  ready: void;\n  error: {\n    code: 'configurationError' | 'apiError' | 'generic';\n    message: string;\n  };\n  transactionCreated: {\n    transaction: { id: string; status: string };\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n  close: void;\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (child → parent direction).\n */\nexport interface ApplePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'applePayUnavailable'\n      | 'generic'\n      | 'oneTapApplePaySecondFactorRequired';\n    message: string;\n  };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Apple Pay frame\n * (parent → child direction).\n */\nexport interface ApplePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (child → parent direction).\n */\nexport interface GooglePayInboundMessageMap {\n  ready: void;\n  error: {\n    code:\n      | 'configurationError'\n      | 'quoteExpired'\n      | 'invalidQuote'\n      | 'googlePayUnavailable'\n      | 'generic';\n    message: string;\n  };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: 'frame'; url: string };\n  complete: {\n    transaction: FrameTransaction;\n  };\n}\n\n/**\n * Maps message `kind` to its payload type for the Google Pay frame\n * (parent → child direction).\n */\nexport interface GooglePayOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n/**\n * Maps message `kind` to its payload type for the connect/check-connection\n * frame (child → parent direction).\n */\nexport interface ConnectMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete:\n    | ConnectionRequired\n    | ActiveConnection\n    | UnavailableConnection\n    | PendingConnection\n    | FailedConnection\n    | TermsAcceptanceRequiredConnection;\n}\n\n/**\n * Maps message `kind` to its payload type for the auth frame\n * (child → parent direction).\n *\n * The auth frame is the lighter-weight counterpart to the connect frame:\n * partners (typically headless / Identity-API integrations) drive the\n * customer through email/OTP authentication only, then receive the\n * encrypted credentials. The frame is gated on `clientToken` rather than\n * `sessionToken` — partners obtain the `clientToken` via the prior\n * `getConnection()` probe (it is decrypted into `core.context` on a\n * `connectionRequired` result).\n */\nexport interface AuthMessageMap {\n  ready: void;\n  error: ConnectionError;\n  complete: ActiveConnection | TermsAcceptanceRequiredConnection;\n}\n\n// ---------------------------------------------------------------------------\n// Buy frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (child → parent direction).\n *\n * The buy frame executes the full buy pipeline (pre-check → create →\n * post-check) headlessly. It may escalate to a challenge frame mid-pipeline.\n */\nexport interface BuyMessageMap {\n  ready: void;\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy frame\n * (parent → child direction).\n */\nexport interface BuyOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Buy-button frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (child → parent direction).\n *\n * The buy-button frame renders a payment button (card, Apple Pay, Google Pay)\n * and runs the buy pipeline on tap. It may escalate to a challenge frame.\n */\nexport interface BuyButtonMessageMap {\n  complete: { transaction: FrameTransaction };\n  /** Signals that the pipeline requires a challenge step. Load `url` in a challenge frame. */\n  challenge: { kind: string; url: string };\n  error: { code: string; message: string };\n}\n\n/**\n * Maps message `kind` to its payload type for the buy-button frame\n * (parent → child direction).\n */\nexport interface BuyButtonOutboundMessageMap {\n  setQuote: { quote: { signature: string } };\n}\n\n// ---------------------------------------------------------------------------\n// Challenge frame\n// ---------------------------------------------------------------------------\n\nexport type ChallengeCompleteResult =\n  | { flow: 'buy'; transaction: FrameTransaction }\n  | { flow: 'identity'; identityId: string };\n\nexport type ChallengeCancellation =\n  | { flow: 'buy'; transactionId?: string; challengeToken?: string }\n  | { flow: 'identity' };\n\n/**\n * Maps message `kind` to its payload type for the challenge frame\n * (child → parent direction).\n *\n * The challenge frame is fully self-contained — it is driven by the\n * `challengeToken` URL param. There is no parent → child message map.\n */\nexport interface ChallengeMessageMap {\n  ready: void;\n  complete: ChallengeCompleteResult;\n  /** User dismissed the challenge. Carry `transactionId` / `challengeToken` to resume. */\n  cancelled: ChallengeCancellation;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Reset frame\n// ---------------------------------------------------------------------------\n\n/**\n * Maps message `kind` to its payload type for the reset frame\n * (child → parent direction).\n *\n * The reset frame clears the customer's MoonPay connection for the partner.\n * It is fully driven by the `sessionToken` URL param. There is no\n * parent → child message map.\n */\nexport interface ResetMessageMap {\n  complete: void;\n  error: { code: string; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Add-card frame\n// ---------------------------------------------------------------------------\n\n/** Card returned by the add-card frame on successful creation. */\nexport interface CardResponse {\n  id: string;\n  /** Payment method type, e.g. `'card'`. */\n  type: string;\n  /** Card sub-type, e.g. `'credit'` or `'debit'`. */\n  cardType: string;\n  /** Card network brand, e.g. `'visa'` or `'mastercard'`. */\n  brand: string;\n  last4: string;\n  expirationMonth: string;\n  expirationYear: string;\n  availability: { active: true };\n}\n\n/**\n * Maps message `kind` to its payload type for the add-card frame\n * (child → parent direction).\n *\n * There is no parent → child message map for the add-card frame.\n */\nexport interface AddCardMessageMap {\n  complete: { card: CardResponse };\n  error: { code: 'generic' | 'configurationError'; message: string };\n}\n\n// ---------------------------------------------------------------------------\n// Transaction type used inside frame messages\n// ---------------------------------------------------------------------------\n\nimport type {\n  ActiveConnection,\n  ConnectionRequired,\n  FailedConnection,\n  PendingConnection,\n  TermsAcceptanceRequiredConnection,\n  UnavailableConnection,\n} from './connection.js';\nimport type { ConnectionError } from './errors.js';\n\n/** Transaction shape as sent within frame postMessage payloads. */\nexport type FrameTransaction =\n  | { id: string; status: string }\n  | { id?: string; status: 'failed'; failureReason: string };\n\n// ---------------------------------------------------------------------------\n// Typed message constructors (utility types)\n// ---------------------------------------------------------------------------\n\n/** A ProtocolMessage typed to a specific message map entry. */\nexport type TypedMessage<\n  Map extends Record<string, unknown>,\n  K extends keyof Map & string,\n> = Map[K] extends void ? ProtocolMessage<K, undefined> : ProtocolMessage<K, Map[K]>;\n\n/** Union of all typed messages for a given message map. */\nexport type MessageUnion<Map extends Record<string, unknown>> = {\n  [K in keyof Map & string]: TypedMessage<Map, K>;\n}[keyof Map & string];\n","/**\n * A discriminated union representing either a successful value or an error.\n * SDK methods return this type instead of throwing exceptions.\n */\nexport type Result<T, E> = { ok: true; value: T } | { ok: false; error: E };\n\n/** A Result variant for operations that produce no value on success. */\nexport type EmptyResult<E> = { ok: true } | { ok: false; error: E };\n\n/** Construct a successful Result. */\nexport const ok = <T>(value: T): { ok: true; value: T } => ({\n  ok: true,\n  value,\n});\n\n/** Construct a failed Result. */\nexport const err = <E>(error: E): { ok: false; error: E } => ({\n  ok: false,\n  error,\n});\n"],"mappings":";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;;;ACAL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,qBAAkB;AAElB,EAAAA,qBAAA,6BAA0B;AAHhB,SAAAA;AAAA,GAAA;AAyBL,IAAM,2BAA2B;AAAA,EACtC,cAAc;AAAA,EACd,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,iBAAiB;AAAA,EACjB,oBAAoB;AACtB;;;AClCO,IAAM,yBAAyB;AAC/B,IAAM,qBAAqB;;;ACP3B,IAAM,KAAK,CAAI,WAAsC;AAAA,EAC1D,IAAI;AAAA,EACJ;AACF;AAGO,IAAM,MAAM,CAAI,WAAuC;AAAA,EAC5D,IAAI;AAAA,EACJ;AACF;","names":["ConnectionStatus","ConnectionErrorCode"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonpay/platform-protocol",
-  "version": "0.2.2",
+  "version": "0.3.0-next.1",
   "description": "Shared protocol types for the MoonPay Developer Platform",
   "type": "module",
   "main": "./dist/index.cjs",