@onramper/onramper-react-native 1.2.2 → 1.3.1

package/src/errors.ts

@@ -8,6 +8,9 @@ export type OnramperErrorCode =
   | 'networkError'
   | 'decodingError'
   | 'timeout'
+  | 'paymentFailed'
+  | 'providerFailed'
+  | 'applePayNotConfigured'
   | 'requirementNotSatisfied'
   | 'amountOutOfRange'
   | 'oidcFlowCancelled'
@@ -26,42 +29,62 @@ export type OnramperErrorCode =
   | 'deviceBlocked'
   | 'securityStorageFailed'
   | 'securityTrustFailed'
-  // JS-only codes
+  // Wrapper lifecycle and platform codes
   | 'platformUnsupported'
   | 'intentInvalidated'
   | 'intentAlreadyConsumed'
   | 'clientAlreadyConfigured'
+  | 'clientDestroyed'
   | 'sessionExpirationHandlerFailed';
 
 export interface OnramperErrorPayload {
   code: OnramperErrorCode;
   message: string;
+  /** Customer-facing SDK copy; optional for backwards-compatible payload construction. */
+  userMessage?: string;
+  supportCode?: string;
   info?: Record<string, unknown>;
 }
 
 export class OnramperError extends Error implements OnramperErrorPayload {
   readonly code: OnramperErrorCode;
+  readonly userMessage: string;
+  readonly supportCode: string;
   readonly info?: Record<string, unknown>;
 
   constructor(payload: OnramperErrorPayload) {
     super(payload.message);
     this.name = 'OnramperError';
     this.code = payload.code;
+    this.userMessage = payload.userMessage ?? 'Something went wrong. Please try again.';
+    this.supportCode = payload.supportCode ?? payload.code;
     this.info = payload.info;
   }
 
   static from(value: unknown): OnramperError {
     if (value instanceof OnramperError) return value;
+    // Nitro transports Swift exceptions as message-only JS Errors. Our native
+    // bridge encodes SDK errors explicitly so Promise rejections retain the
+    // same fields as failed events, without consulting unrelated client state.
+    const message = value instanceof Error ? value.message : typeof value === 'string' ? value : undefined;
+    if (message?.startsWith('ONRAMPER_ERROR:')) {
+      try {
+        const payload = JSON.parse(message.slice('ONRAMPER_ERROR:'.length));
+        if (payload && typeof payload.code === 'string' && typeof payload.message === 'string') {
+          return OnramperError.from(payload);
+        }
+      } catch {
+        // A malformed/non-SDK error falls back to the ordinary error path.
+      }
+    }
     if (value && typeof value === 'object') {
-      // Structured errors (from the `.failed` state) arrive as a plain
-      // `{ code, message, info? }` object. Thrown promise rejections surface
-      // as a JS Error with just a message; we default the code in that case
-      // (the structured error is also available on `client.state` / lastError).
-      const v = value as { code?: string; message?: string; info?: Record<string, unknown> };
+      const v = value as Partial<OnramperErrorPayload>;
       return new OnramperError({
         code: (v.code ?? 'unrecoverable') as OnramperErrorCode,
         message: v.message ?? 'Unknown error',
         info: v.info,
+        userMessage: typeof v.userMessage === 'string' ? v.userMessage : undefined,
+        supportCode: typeof v.supportCode === 'string' ? v.supportCode : undefined,
       });
     }
     return new OnramperError({ code: 'unrecoverable', message: String(value) });

package/src/events.ts

@@ -16,6 +16,11 @@ export type CheckoutEvent =
   | { type: 'providerReady' }
   | { type: 'paymentAuthorized' }
   | { type: 'paymentProcessing' }
+  /** Accepted but not settled; use currentTransactionId to track the payment. */
+  | { type: 'paymentPending' }
+  | { type: 'challengeStarted' }
+  | { type: 'challengeCompleted' }
+  | { type: 'customerOnboardingRequired' }
   | { type: 'paymentCancelled' }
   | { type: 'providerError'; reason: string };
 

package/src/generated/OnramperCheckoutButtonConfig.json

@@ -5,6 +5,7 @@
   "directEventTypes": {},
   "validAttributes": {
     "intentHandle": true,
+    "onContentHeightChange": true,
     "hybridRef": true
   }
 }

package/src/index.ts

@@ -16,6 +16,9 @@ export type {
   OnramperConfiguration,
   OnramperEnvironment,
   OnramperLogLevel,
+  OnramperLogRecord,
+  ProviderJSONValue,
+  PaymentDisclosure,
   OnramperState,
   OnramperTheme,
   OnramperUserPrefill,

package/src/specs/OnramperCheckoutButton.nitro.ts

@@ -5,6 +5,12 @@ import type { HybridView, HybridViewMethods, HybridViewProps } from 'react-nativ
 // UIHostingController. iOS-only (Android is a platformUnsupported stub).
 export interface OnramperCheckoutButtonProps extends HybridViewProps {
   intentHandle: string;
+  /**
+   * Called with the hosted SwiftUI content's height (points) whenever it changes —
+   * e.g. when ToS text appears under the Buy button. React Native can't measure
+   * the SwiftUI content itself, so the JS wrapper applies this as `height`.
+   */
+  onContentHeightChange?: (height: number) => void;
 }
 
 export interface OnramperCheckoutButtonMethods extends HybridViewMethods {}

package/src/specs/OnramperNitro.nitro.ts

@@ -8,6 +8,8 @@ export interface OnramperNitroConfig {
   environment: string; // 'development' | 'production'
   theme: string; // 'system' | 'light' | 'dark'
   logLevel: string; // 'off' | 'error' | 'info' | 'debug'
+  isEventLoggingEnabled: boolean;
+  isEventConsoleLoggingEnabled: boolean;
 }
 
 // Mirrors OnramperSDK.SessionCredentials. Named with a Nitro prefix to avoid a
@@ -34,6 +36,8 @@ export interface PreparedIntentResult {
  * them back into the fully-typed `OnramperState`/`CheckoutEvent` unions.
  */
 export interface OnramperNitro extends HybridObject<{ ios: 'swift' }> {
+  // Compiled native SDK version, readable before configure/initialize.
+  readonly sdkVersion: string;
   configure(config: OnramperNitroConfig): Promise<void>;
   initialize(sessionId: string, sessionToken: string): Promise<void>;
   reset(): Promise<void>;
@@ -50,6 +54,7 @@ export interface OnramperNitro extends HybridObject<{ ios: 'swift' }> {
   cancelPreparedIntent(intentHandle: string): Promise<void>;
 
   // Single native callback per stream; the JS wrapper fans out to multiple listeners.
+  setLogListener(onLog: (recordJson: string) => void): void;
   setStateListener(onState: (stateJson: string) => void): void;
   setEventListener(onEvent: (eventJson: string) => void): void;
   // Mirrors OnramperSDK.$currentTransactionId. `undefined` represents native nil.

package/src/types.ts

@@ -5,6 +5,16 @@ import type { OnramperErrorPayload } from './errors';
 
 export type OnramperEnvironment = 'development' | 'production';
 export type OnramperLogLevel = 'off' | 'error' | 'info' | 'debug';
+/** A sanitized native SDK diagnostic. Timestamp is Unix milliseconds. */
+export interface OnramperLogRecord {
+  timestamp: number;
+  level: OnramperLogLevel;
+  category: string;
+  event: string;
+  context: Record<string, string>;
+  message: string;
+}
+
 export type OnramperTheme = 'system' | 'light' | 'dark';
 
 export type TransactionType = 'buy' | 'sell';
@@ -20,12 +30,16 @@ export interface OnramperConfiguration {
   environment: OnramperEnvironment;
   theme?: OnramperTheme;
   logLevel?: OnramperLogLevel;
+  /** Receives native records in JS; system Console output is preserved. Off unless logLevel enables it. */
+  logHandler?: (record: OnramperLogRecord) => void;
+  /** Opt-in provider-event telemetry to the BFF. Defaults to false. */
+  isEventLoggingEnabled?: boolean;
+  /** Emit provider events at info even when logLevel is lower. Defaults to false. */
+  isEventConsoleLoggingEnabled?: boolean;
   /**
    * Called by the SDK when the session token expires and needs to be re-issued.
    *
-   * May be synchronous or async — under the hood the bridge uses an event
-   * round-trip (`onSessionExpired` → `provideSessionCredentials`) so Promises
-   * are awaited normally. Throw or reject to signal that no fresh credentials
+   * May be synchronous or async; the Nitro bridge awaits the callback directly. Throw or reject to signal that no fresh credentials
    * are available; the SDK will surface `userTokenRefreshFailed`.
    */
   onSessionExpired: () => SessionCredentials | Promise<SessionCredentials>;
@@ -67,6 +81,23 @@ export interface QuoteResponse {
   networkFee: number;
   transactionFee: number;
   recommendations?: string[];
+  providerContext?: Record<string, ProviderJSONValue>;
+}
+
+/** JSON values used in provider-specific quote metadata (including booleans and limits). */
+export type ProviderJSONValue =
+  | string
+  | number
+  | boolean
+  | null
+  | ProviderJSONValue[]
+  | { [key: string]: ProviderJSONValue };
+
+export interface PaymentDisclosure {
+  code: string;
+  version: string;
+  contentMarkdown: string;
+  contentHtml: string;
 }
 
 // Mirrors Swift `OnramperUserPrefill`. Values you already know about the user,
@@ -111,6 +142,7 @@ export interface HeadlessCheckoutData {
   checkoutPaymentType: CheckoutPaymentType;
   url: string;
   renderType: RenderType;
+  providerBootstrap?: { framesBaseUrl?: string };
 }
 
 export interface CheckoutFinalizeResponse {
@@ -181,6 +213,7 @@ export type OnramperState =
   | { kind: 'readyToCheckout' }
   | { kind: 'finalizing' }
   | { kind: 'rendering'; url: string; renderType: RenderType; paymentType: CheckoutPaymentType }
+  | { kind: 'paymentPending' }
   | { kind: 'completed' }
   | { kind: 'failed'; error: OnramperErrorPayload };