@onramper/onramper-react-native 1.2.2-1 → 1.3.0

package/lib/commonjs/OnramperClient.js

@@ -30,9 +30,23 @@ class OnramperClient {
   // Resolved when the constructor-issued configure() completes. Public methods
   // that need the native client await this first.
 
+  destroyed = false;
   constructor(config) {
+    if (config.logHandler) {
+      const handler = config.logHandler;
+      this.native.setLogListener(json => {
+        if (this.destroyed) return;
+        try {
+          handler(JSON.parse(json));
+        } catch {
+          // Diagnostics must never interrupt checkout; do not log callback data.
+          console.warn('Onramper logHandler failed.');
+        }
+      });
+    }
     // Single native state callback → update the mirror + fan out to listeners.
     this.native.setStateListener(json => {
+      if (this.destroyed) return;
       const s = JSON.parse(json);
       this.state = s;
       if (s.kind === 'failed') this.lastError = _errors.OnramperError.from(s.error);
@@ -42,6 +56,7 @@ class OnramperClient {
     // Single native checkout-event callback → keep the transaction ID mirror
     // synchronized at finalization, then fan out to checkout listeners.
     this.native.setEventListener(json => {
+      if (this.destroyed) return;
       const e = JSON.parse(json);
       if (e.type === 'checkoutFinalized') {
         this.updateCurrentTransactionId(e.response.onramperTransactionId);
@@ -49,6 +64,7 @@ class OnramperClient {
       for (const fn of this.eventListeners) fn(e);
     });
     this.native.setTransactionIdListener(transactionId => {
+      if (this.destroyed) return;
       // The SDK transiently publishes nil while re-preparing after the payment
       // sheet is dismissed. The finalized transaction ID remains durable across
       // that attempt change; only explicit reset()/signOut() clear the JS mirror.
@@ -59,7 +75,9 @@ class OnramperClient {
     // Nitro stores the async callback natively and awaits it directly — no
     // event round-trip needed.
     this.native.setSessionExpirationHandler(async () => {
+      this.assertActive();
       const creds = await config.onSessionExpired();
+      this.assertActive();
       return {
         sessionId: creds.sessionId,
         sessionToken: creds.sessionToken
@@ -70,20 +88,33 @@ class OnramperClient {
       clientId: config.clientId,
       environment: config.environment,
       theme: config.theme ?? 'system',
-      logLevel: config.logLevel ?? 'off'
+      logLevel: config.logLevel ?? 'off',
+      isEventLoggingEnabled: config.isEventLoggingEnabled ?? false,
+      isEventConsoleLoggingEnabled: config.isEventConsoleLoggingEnabled ?? false
     }).catch(e => {
       const err = _errors.OnramperError.from(e);
-      this.lastError = err;
+      if (!this.destroyed) this.lastError = err;
       throw err;
     });
     // Swallow the unhandled-rejection warning when no one awaits .configured
     // before calling initialize(). The error still surfaces via initialize().
     this.configured.catch(() => undefined);
   }
+  assertActive() {
+    if (this.destroyed) {
+      throw new _errors.OnramperError({
+        code: 'clientDestroyed',
+        message: 'This OnramperClient has been destroyed. Create a new client before making SDK calls.',
+        userMessage: 'This checkout session has ended. Please reopen checkout.'
+      });
+    }
+  }
   updateCurrentTransactionId(next) {
+    if (this.destroyed) return;
     if (next === this.currentTransactionId) return;
     this.currentTransactionId = next;
     for (const fn of [...this.transactionIdListeners]) {
+      if (this.destroyed) break;
       try {
         fn(next);
       } catch (error) {
@@ -93,18 +124,26 @@ class OnramperClient {
   }
   async initialize(creds) {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.initialize(creds.sessionId, creds.sessionToken);
+      this.assertActive();
     } catch (e) {
+      this.assertActive();
       throw _errors.OnramperError.from(e);
     }
   }
   async reset() {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.reset();
+      this.assertActive();
       this.updateCurrentTransactionId(null);
     } catch (e) {
+      this.assertActive();
       throw _errors.OnramperError.from(e);
     }
   }
@@ -117,10 +156,14 @@ class OnramperClient {
    */
   async signOut() {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.signOut();
+      this.assertActive();
       this.updateCurrentTransactionId(null);
     } catch (e) {
+      this.assertActive();
       throw _errors.OnramperError.from(e);
     }
   }
@@ -129,6 +172,8 @@ class OnramperClient {
    * Fetches checkout requirements + quote and returns a native checkout button
    * to render plus the quote. The button handles login / finalize / webview
    * internally; outcomes surface via the event stream (`addEventListener`).
+   * A newer preparation, reset, or sign-out invalidates older unmounted buttons
+   * and rejects obsolete in-flight preparations with `intentInvalidated`.
    *
    * Pass `prefill` to pre-populate the OnramperID sign-in and additional-info
    * screens with values you already know about the user. It is best-effort and
@@ -142,8 +187,11 @@ class OnramperClient {
    */
   async getCheckoutRequirements(request, buttonStyle = {}, prefill = {}) {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       const result = await this.native.getCheckoutRequirements(JSON.stringify(request), JSON.stringify(prefill), JSON.stringify(buttonStyle));
+      this.assertActive();
       const quote = JSON.parse(result.quoteJson);
       const button = /*#__PURE__*/(0, _react.createElement)(_CheckoutButton.CheckoutButton, {
         intentHandle: result.intentHandle
@@ -153,17 +201,26 @@ class OnramperClient {
         quote
       };
     } catch (e) {
+      this.assertActive();
       throw _errors.OnramperError.from(e);
     }
   }
 
   /** Discards a prepared intent (e.g. if the user navigates away before checkout). */
-  cancelPreparedIntent(intentHandle) {
-    return this.native.cancelPreparedIntent(intentHandle);
+  async cancelPreparedIntent(intentHandle) {
+    try {
+      this.assertActive();
+      await this.native.cancelPreparedIntent(intentHandle);
+      this.assertActive();
+    } catch (e) {
+      this.assertActive();
+      throw _errors.OnramperError.from(e);
+    }
   }
 
   /** Subscribe to state changes. Returns an unsubscribe function. */
   addStateListener(fn) {
+    this.assertActive();
     this.stateListeners.add(fn);
     return () => {
       this.stateListeners.delete(fn);
@@ -172,6 +229,7 @@ class OnramperClient {
 
   /** Subscribe to the durable Onramper transaction ID. Successful reset/signOut publish null. */
   addTransactionIdListener(fn) {
+    this.assertActive();
     this.transactionIdListeners.add(fn);
     return () => {
       this.transactionIdListeners.delete(fn);
@@ -180,6 +238,7 @@ class OnramperClient {
 
   /** Subscribe to a specific checkout event. Returns an unsubscribe function. */
   addEventListener(name, fn) {
+    this.assertActive();
     const wrapper = e => {
       if (e.type === name) fn(e);
     };
@@ -189,8 +248,10 @@ class OnramperClient {
     };
   }
 
-  /** Tear down: clears JS listeners and releases the native callbacks + SDK client. */
+  /** Idempotent teardown. Further operations reject with `clientDestroyed`; create a new client to restart. */
   destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
     this.stateListeners.clear();
     this.eventListeners.clear();
     this.transactionIdListeners.clear();

package/lib/commonjs/OnramperClient.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_CheckoutButton","_OnramperNative","_errors","OnramperClient","state","kind","lastError","currentTransactionId","native","createOnramperNative","stateListeners","Set","eventListeners","transactionIdListeners","constructor","config","setStateListener","json","s","JSON","parse","OnramperError","from","error","fn","setEventListener","e","type","updateCurrentTransactionId","response","onramperTransactionId","setTransactionIdListener","transactionId","undefined","setSessionExpirationHandler","creds","onSessionExpired","sessionId","sessionToken","configured","configure","apiKey","clientId","environment","theme","logLevel","catch","err","next","console","initialize","reset","signOut","getCheckoutRequirements","request","buttonStyle","prefill","result","stringify","quote","quoteJson","button","createElement","CheckoutButton","intentHandle","cancelPreparedIntent","addStateListener","add","delete","addTransactionIdListener","addEventListener","name","wrapper","destroy","clear","dispose","exports"],"sourceRoot":"../../src","sources":["OnramperClient.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_CheckoutButton","_OnramperNative","_errors","OnramperClient","state","kind","lastError","currentTransactionId","native","createOnramperNative","stateListeners","Set","eventListeners","transactionIdListeners","destroyed","constructor","config","logHandler","handler","setLogListener","json","JSON","parse","console","warn","setStateListener","s","OnramperError","from","error","fn","setEventListener","e","type","updateCurrentTransactionId","response","onramperTransactionId","setTransactionIdListener","transactionId","undefined","setSessionExpirationHandler","assertActive","creds","onSessionExpired","sessionId","sessionToken","configured","configure","apiKey","clientId","environment","theme","logLevel","isEventLoggingEnabled","isEventConsoleLoggingEnabled","catch","err","code","message","userMessage","next","initialize","reset","signOut","getCheckoutRequirements","request","buttonStyle","prefill","result","stringify","quote","quoteJson","button","createElement","CheckoutButton","intentHandle","cancelPreparedIntent","addStateListener","add","delete","addTransactionIdListener","addEventListener","name","wrapper","destroy","clear","dispose","exports"],"sourceRoot":"../../src","sources":["OnramperClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/errors.js

@@ -9,20 +9,34 @@ class OnramperError extends Error {
     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) {
     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;
       return new OnramperError({
         code: v.code ?? 'unrecoverable',
         message: v.message ?? 'Unknown error',
-        info: v.info
+        info: v.info,
+        userMessage: typeof v.userMessage === 'string' ? v.userMessage : undefined,
+        supportCode: typeof v.supportCode === 'string' ? v.supportCode : undefined
       });
     }
     return new OnramperError({

package/lib/commonjs/errors.js.map

@@ -1 +1 @@
-{"version":3,"names":["OnramperError","Error","constructor","payload","message","name","code","info","from","value","v","String","exports"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;;;;;AAyCO,MAAMA,aAAa,SAASC,KAAK,CAAiC;EAIvEC,WAAWA,CAACC,OAA6B,EAAE;IACzC,KAAK,CAACA,OAAO,CAACC,OAAO,CAAC;IACtB,IAAI,CAACC,IAAI,GAAG,eAAe;IAC3B,IAAI,CAACC,IAAI,GAAGH,OAAO,CAACG,IAAI;IACxB,IAAI,CAACC,IAAI,GAAGJ,OAAO,CAACI,IAAI;EAC1B;EAEA,OAAOC,IAAIA,CAACC,KAAc,EAAiB;IACzC,IAAIA,KAAK,YAAYT,aAAa,EAAE,OAAOS,KAAK;IAChD,IAAIA,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MACtC;MACA;MACA;MACA;MACA,MAAMC,CAAC,GAAGD,KAA4E;MACtF,OAAO,IAAIT,aAAa,CAAC;QACvBM,IAAI,EAAGI,CAAC,CAACJ,IAAI,IAAI,eAAqC;QACtDF,OAAO,EAAEM,CAAC,CAACN,OAAO,IAAI,eAAe;QACrCG,IAAI,EAAEG,CAAC,CAACH;MACV,CAAC,CAAC;IACJ;IACA,OAAO,IAAIP,aAAa,CAAC;MAAEM,IAAI,EAAE,eAAe;MAAEF,OAAO,EAAEO,MAAM,CAACF,KAAK;IAAE,CAAC,CAAC;EAC7E;AACF;AAACG,OAAA,CAAAZ,aAAA,GAAAA,aAAA","ignoreList":[]}
+{"version":3,"names":["OnramperError","Error","constructor","payload","message","name","code","userMessage","supportCode","info","from","value","undefined","startsWith","JSON","parse","slice","length","v","String","exports"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;;;;;AAgDO,MAAMA,aAAa,SAASC,KAAK,CAAiC;EAMvEC,WAAWA,CAACC,OAA6B,EAAE;IACzC,KAAK,CAACA,OAAO,CAACC,OAAO,CAAC;IACtB,IAAI,CAACC,IAAI,GAAG,eAAe;IAC3B,IAAI,CAACC,IAAI,GAAGH,OAAO,CAACG,IAAI;IACxB,IAAI,CAACC,WAAW,GAAGJ,OAAO,CAACI,WAAW,IAAI,yCAAyC;IACnF,IAAI,CAACC,WAAW,GAAGL,OAAO,CAACK,WAAW,IAAIL,OAAO,CAACG,IAAI;IACtD,IAAI,CAACG,IAAI,GAAGN,OAAO,CAACM,IAAI;EAC1B;EAEA,OAAOC,IAAIA,CAACC,KAAc,EAAiB;IACzC,IAAIA,KAAK,YAAYX,aAAa,EAAE,OAAOW,KAAK;IAChD;IACA;IACA;IACA,MAAMP,OAAO,GAAGO,KAAK,YAAYV,KAAK,GAAGU,KAAK,CAACP,OAAO,GAAG,OAAOO,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAGC,SAAS;IACtG,IAAIR,OAAO,EAAES,UAAU,CAAC,iBAAiB,CAAC,EAAE;MAC1C,IAAI;QACF,MAAMV,OAAO,GAAGW,IAAI,CAACC,KAAK,CAACX,OAAO,CAACY,KAAK,CAAC,iBAAiB,CAACC,MAAM,CAAC,CAAC;QACnE,IAAId,OAAO,IAAI,OAAOA,OAAO,CAACG,IAAI,KAAK,QAAQ,IAAI,OAAOH,OAAO,CAACC,OAAO,KAAK,QAAQ,EAAE;UACtF,OAAOJ,aAAa,CAACU,IAAI,CAACP,OAAO,CAAC;QACpC;MACF,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;IACA,IAAIQ,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MACtC,MAAMO,CAAC,GAAGP,KAAsC;MAChD,OAAO,IAAIX,aAAa,CAAC;QACvBM,IAAI,EAAGY,CAAC,CAACZ,IAAI,IAAI,eAAqC;QACtDF,OAAO,EAAEc,CAAC,CAACd,OAAO,IAAI,eAAe;QACrCK,IAAI,EAAES,CAAC,CAACT,IAAI;QACZF,WAAW,EAAE,OAAOW,CAAC,CAACX,WAAW,KAAK,QAAQ,GAAGW,CAAC,CAACX,WAAW,GAAGK,SAAS;QAC1EJ,WAAW,EAAE,OAAOU,CAAC,CAACV,WAAW,KAAK,QAAQ,GAAGU,CAAC,CAACV,WAAW,GAAGI;MACnE,CAAC,CAAC;IACJ;IACA,OAAO,IAAIZ,aAAa,CAAC;MAAEM,IAAI,EAAE,eAAe;MAAEF,OAAO,EAAEe,MAAM,CAACR,KAAK;IAAE,CAAC,CAAC;EAC7E;AACF;AAACS,OAAA,CAAApB,aAAA,GAAAA,aAAA","ignoreList":[]}

package/lib/module/OnramperClient.js

@@ -26,9 +26,23 @@ export class OnramperClient {
   // Resolved when the constructor-issued configure() completes. Public methods
   // that need the native client await this first.
 
+  destroyed = false;
   constructor(config) {
+    if (config.logHandler) {
+      const handler = config.logHandler;
+      this.native.setLogListener(json => {
+        if (this.destroyed) return;
+        try {
+          handler(JSON.parse(json));
+        } catch {
+          // Diagnostics must never interrupt checkout; do not log callback data.
+          console.warn('Onramper logHandler failed.');
+        }
+      });
+    }
     // Single native state callback → update the mirror + fan out to listeners.
     this.native.setStateListener(json => {
+      if (this.destroyed) return;
       const s = JSON.parse(json);
       this.state = s;
       if (s.kind === 'failed') this.lastError = OnramperError.from(s.error);
@@ -38,6 +52,7 @@ export class OnramperClient {
     // Single native checkout-event callback → keep the transaction ID mirror
     // synchronized at finalization, then fan out to checkout listeners.
     this.native.setEventListener(json => {
+      if (this.destroyed) return;
       const e = JSON.parse(json);
       if (e.type === 'checkoutFinalized') {
         this.updateCurrentTransactionId(e.response.onramperTransactionId);
@@ -45,6 +60,7 @@ export class OnramperClient {
       for (const fn of this.eventListeners) fn(e);
     });
     this.native.setTransactionIdListener(transactionId => {
+      if (this.destroyed) return;
       // The SDK transiently publishes nil while re-preparing after the payment
       // sheet is dismissed. The finalized transaction ID remains durable across
       // that attempt change; only explicit reset()/signOut() clear the JS mirror.
@@ -55,7 +71,9 @@ export class OnramperClient {
     // Nitro stores the async callback natively and awaits it directly — no
     // event round-trip needed.
     this.native.setSessionExpirationHandler(async () => {
+      this.assertActive();
       const creds = await config.onSessionExpired();
+      this.assertActive();
       return {
         sessionId: creds.sessionId,
         sessionToken: creds.sessionToken
@@ -66,20 +84,33 @@ export class OnramperClient {
       clientId: config.clientId,
       environment: config.environment,
       theme: config.theme ?? 'system',
-      logLevel: config.logLevel ?? 'off'
+      logLevel: config.logLevel ?? 'off',
+      isEventLoggingEnabled: config.isEventLoggingEnabled ?? false,
+      isEventConsoleLoggingEnabled: config.isEventConsoleLoggingEnabled ?? false
     }).catch(e => {
       const err = OnramperError.from(e);
-      this.lastError = err;
+      if (!this.destroyed) this.lastError = err;
       throw err;
     });
     // Swallow the unhandled-rejection warning when no one awaits .configured
     // before calling initialize(). The error still surfaces via initialize().
     this.configured.catch(() => undefined);
   }
+  assertActive() {
+    if (this.destroyed) {
+      throw new OnramperError({
+        code: 'clientDestroyed',
+        message: 'This OnramperClient has been destroyed. Create a new client before making SDK calls.',
+        userMessage: 'This checkout session has ended. Please reopen checkout.'
+      });
+    }
+  }
   updateCurrentTransactionId(next) {
+    if (this.destroyed) return;
     if (next === this.currentTransactionId) return;
     this.currentTransactionId = next;
     for (const fn of [...this.transactionIdListeners]) {
+      if (this.destroyed) break;
       try {
         fn(next);
       } catch (error) {
@@ -89,18 +120,26 @@ export class OnramperClient {
   }
   async initialize(creds) {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.initialize(creds.sessionId, creds.sessionToken);
+      this.assertActive();
     } catch (e) {
+      this.assertActive();
       throw OnramperError.from(e);
     }
   }
   async reset() {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.reset();
+      this.assertActive();
       this.updateCurrentTransactionId(null);
     } catch (e) {
+      this.assertActive();
       throw OnramperError.from(e);
     }
   }
@@ -113,10 +152,14 @@ export class OnramperClient {
    */
   async signOut() {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       await this.native.signOut();
+      this.assertActive();
       this.updateCurrentTransactionId(null);
     } catch (e) {
+      this.assertActive();
       throw OnramperError.from(e);
     }
   }
@@ -125,6 +168,8 @@ export class OnramperClient {
    * Fetches checkout requirements + quote and returns a native checkout button
    * to render plus the quote. The button handles login / finalize / webview
    * internally; outcomes surface via the event stream (`addEventListener`).
+   * A newer preparation, reset, or sign-out invalidates older unmounted buttons
+   * and rejects obsolete in-flight preparations with `intentInvalidated`.
    *
    * Pass `prefill` to pre-populate the OnramperID sign-in and additional-info
    * screens with values you already know about the user. It is best-effort and
@@ -138,8 +183,11 @@ export class OnramperClient {
    */
   async getCheckoutRequirements(request, buttonStyle = {}, prefill = {}) {
     try {
+      this.assertActive();
       await this.configured;
+      this.assertActive();
       const result = await this.native.getCheckoutRequirements(JSON.stringify(request), JSON.stringify(prefill), JSON.stringify(buttonStyle));
+      this.assertActive();
       const quote = JSON.parse(result.quoteJson);
       const button = /*#__PURE__*/createElement(CheckoutButton, {
         intentHandle: result.intentHandle
@@ -149,17 +197,26 @@ export class OnramperClient {
         quote
       };
     } catch (e) {
+      this.assertActive();
       throw OnramperError.from(e);
     }
   }
 
   /** Discards a prepared intent (e.g. if the user navigates away before checkout). */
-  cancelPreparedIntent(intentHandle) {
-    return this.native.cancelPreparedIntent(intentHandle);
+  async cancelPreparedIntent(intentHandle) {
+    try {
+      this.assertActive();
+      await this.native.cancelPreparedIntent(intentHandle);
+      this.assertActive();
+    } catch (e) {
+      this.assertActive();
+      throw OnramperError.from(e);
+    }
   }
 
   /** Subscribe to state changes. Returns an unsubscribe function. */
   addStateListener(fn) {
+    this.assertActive();
     this.stateListeners.add(fn);
     return () => {
       this.stateListeners.delete(fn);
@@ -168,6 +225,7 @@ export class OnramperClient {
 
   /** Subscribe to the durable Onramper transaction ID. Successful reset/signOut publish null. */
   addTransactionIdListener(fn) {
+    this.assertActive();
     this.transactionIdListeners.add(fn);
     return () => {
       this.transactionIdListeners.delete(fn);
@@ -176,6 +234,7 @@ export class OnramperClient {
 
   /** Subscribe to a specific checkout event. Returns an unsubscribe function. */
   addEventListener(name, fn) {
+    this.assertActive();
     const wrapper = e => {
       if (e.type === name) fn(e);
     };
@@ -185,8 +244,10 @@ export class OnramperClient {
     };
   }
 
-  /** Tear down: clears JS listeners and releases the native callbacks + SDK client. */
+  /** Idempotent teardown. Further operations reject with `clientDestroyed`; create a new client to restart. */
   destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
     this.stateListeners.clear();
     this.eventListeners.clear();
     this.transactionIdListeners.clear();

package/lib/module/OnramperClient.js.map

@@ -1 +1 @@
-{"version":3,"names":["createElement","CheckoutButton","createOnramperNative","OnramperError","OnramperClient","state","kind","lastError","currentTransactionId","native","stateListeners","Set","eventListeners","transactionIdListeners","constructor","config","setStateListener","json","s","JSON","parse","from","error","fn","setEventListener","e","type","updateCurrentTransactionId","response","onramperTransactionId","setTransactionIdListener","transactionId","undefined","setSessionExpirationHandler","creds","onSessionExpired","sessionId","sessionToken","configured","configure","apiKey","clientId","environment","theme","logLevel","catch","err","next","console","initialize","reset","signOut","getCheckoutRequirements","request","buttonStyle","prefill","result","stringify","quote","quoteJson","button","intentHandle","cancelPreparedIntent","addStateListener","add","delete","addTransactionIdListener","addEventListener","name","wrapper","destroy","clear","dispose"],"sourceRoot":"../../src","sources":["OnramperClient.ts"],"mappings":";;AAAA,SAA4BA,aAAa,QAAQ,OAAO;AAExD,SAASC,cAAc,QAAQ,qBAAkB;AACjD,SAASC,oBAAoB,QAAQ,qBAAkB;AACvD,SAASC,aAAa,QAAQ,aAAU;AAmBxC;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,CAAC;EAC1BC,KAAK,GAAkB;IAAEC,IAAI,EAAE;EAAO,CAAC;EACvCC,SAAS,GAAyB,IAAI;EACtCC,oBAAoB,GAAkB,IAAI;;EAE1C;EACiBC,MAAM,GAAGP,oBAAoB,CAAC,CAAC;EAE/BQ,cAAc,GAAG,IAAIC,GAAG,CAAiC,CAAC;EAC1DC,cAAc,GAAG,IAAID,GAAG,CAAiC,CAAC;EAC1DE,sBAAsB,GAAG,IAAIF,GAAG,CAAyC,CAAC;;EAE3F;EACA;;EAGAG,WAAWA,CAACC,MAA6B,EAAE;IACzC;IACA,IAAI,CAACN,MAAM,CAACO,gBAAgB,CAAEC,IAAI,IAAK;MACrC,MAAMC,CAAC,GAAGC,IAAI,CAACC,KAAK,CAACH,IAAI,CAAkB;MAC3C,IAAI,CAACZ,KAAK,GAAGa,CAAC;MACd,IAAIA,CAAC,CAACZ,IAAI,KAAK,QAAQ,EAAE,IAAI,CAACC,SAAS,GAAGJ,aAAa,CAACkB,IAAI,CAACH,CAAC,CAACI,KAAK,CAAC;MACrE,KAAK,MAAMC,EAAE,IAAI,IAAI,CAACb,cAAc,EAAEa,EAAE,CAACL,CAAC,CAAC;IAC7C,CAAC,CAAC;;IAEF;IACA;IACA,IAAI,CAACT,MAAM,CAACe,gBAAgB,CAAEP,IAAI,IAAK;MACrC,MAAMQ,CAAC,GAAGN,IAAI,CAACC,KAAK,CAACH,IAAI,CAAkB;MAC3C,IAAIQ,CAAC,CAACC,IAAI,KAAK,mBAAmB,EAAE;QAClC,IAAI,CAACC,0BAA0B,CAACF,CAAC,CAACG,QAAQ,CAACC,qBAAqB,CAAC;MACnE;MACA,KAAK,MAAMN,EAAE,IAAI,IAAI,CAACX,cAAc,EAAEW,EAAE,CAACE,CAAC,CAAC;IAC7C,CAAC,CAAC;IAEF,IAAI,CAAChB,MAAM,CAACqB,wBAAwB,CAAEC,aAAa,IAAK;MACtD;MACA;MACA;MACA,IAAIA,aAAa,KAAKC,SAAS,EAAE,IAAI,CAACL,0BAA0B,CAACI,aAAa,CAAC;IACjF,CAAC,CAAC;;IAEF;IACA;IACA;IACA,IAAI,CAACtB,MAAM,CAACwB,2BAA2B,CAAC,YAAY;MAClD,MAAMC,KAAK,GAAG,MAAMnB,MAAM,CAACoB,gBAAgB,CAAC,CAAC;MAC7C,OAAO;QAAEC,SAAS,EAAEF,KAAK,CAACE,SAAS;QAAEC,YAAY,EAAEH,KAAK,CAACG;MAAa,CAAC;IACzE,CAAC,CAAC;IAEF,IAAI,CAACC,UAAU,GAAG,IAAI,CAAC7B,MAAM,CAC1B8B,SAAS,CAAC;MACTC,MAAM,EAAEzB,MAAM,CAACyB,MAAM;MACrBC,QAAQ,EAAE1B,MAAM,CAAC0B,QAAQ;MACzBC,WAAW,EAAE3B,MAAM,CAAC2B,WAAW;MAC/BC,KAAK,EAAE5B,MAAM,CAAC4B,KAAK,IAAI,QAAQ;MAC/BC,QAAQ,EAAE7B,MAAM,CAAC6B,QAAQ,IAAI;IAC/B,CAAC,CAAC,CACDC,KAAK,CAAEpB,CAAU,IAAK;MACrB,MAAMqB,GAAG,GAAG3C,aAAa,CAACkB,IAAI,CAACI,CAAC,CAAC;MACjC,IAAI,CAAClB,SAAS,GAAGuC,GAAG;MACpB,MAAMA,GAAG;IACX,CAAC,CAAC;IACJ;IACA;IACA,IAAI,CAACR,UAAU,CAACO,KAAK,CAAC,MAAMb,SAAS,CAAC;EACxC;EAEQL,0BAA0BA,CAACoB,IAAmB,EAAQ;IAC5D,IAAIA,IAAI,KAAK,IAAI,CAACvC,oBAAoB,EAAE;IAExC,IAAI,CAACA,oBAAoB,GAAGuC,IAAI;IAChC,KAAK,MAAMxB,EAAE,IAAI,CAAC,GAAG,IAAI,CAACV,sBAAsB,CAAC,EAAE;MACjD,IAAI;QACFU,EAAE,CAACwB,IAAI,CAAC;MACV,CAAC,CAAC,OAAOzB,KAAc,EAAE;QACvB0B,OAAO,CAAC1B,KAAK,CAAC,yCAAyC,EAAEA,KAAK,CAAC;MACjE;IACF;EACF;EAEA,MAAM2B,UAAUA,CAACf,KAAyB,EAAiB;IACzD,IAAI;MACF,MAAM,IAAI,CAACI,UAAU;MACrB,MAAM,IAAI,CAAC7B,MAAM,CAACwC,UAAU,CAACf,KAAK,CAACE,SAAS,EAAEF,KAAK,CAACG,YAAY,CAAC;IACnE,CAAC,CAAC,OAAOZ,CAAU,EAAE;MACnB,MAAMtB,aAAa,CAACkB,IAAI,CAACI,CAAC,CAAC;IAC7B;EACF;EAEA,MAAMyB,KAAKA,CAAA,EAAkB;IAC3B,IAAI;MACF,MAAM,IAAI,CAACZ,UAAU;MACrB,MAAM,IAAI,CAAC7B,MAAM,CAACyC,KAAK,CAAC,CAAC;MACzB,IAAI,CAACvB,0BAA0B,CAAC,IAAI,CAAC;IACvC,CAAC,CAAC,OAAOF,CAAU,EAAE;MACnB,MAAMtB,aAAa,CAACkB,IAAI,CAACI,CAAC,CAAC;IAC7B;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;EACE,MAAM0B,OAAOA,CAAA,EAAkB;IAC7B,IAAI;MACF,MAAM,IAAI,CAACb,UAAU;MACrB,MAAM,IAAI,CAAC7B,MAAM,CAAC0C,OAAO,CAAC,CAAC;MAC3B,IAAI,CAACxB,0BAA0B,CAAC,IAAI,CAAC;IACvC,CAAC,CAAC,OAAOF,CAAU,EAAE;MACnB,MAAMtB,aAAa,CAACkB,IAAI,CAACI,CAAC,CAAC;IAC7B;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAM2B,uBAAuBA,CAC3BC,OAAwB,EACxBC,WAAgC,GAAG,CAAC,CAAC,EACrCC,OAA4B,GAAG,CAAC,CAAC,EACO;IACxC,IAAI;MACF,MAAM,IAAI,CAACjB,UAAU;MACrB,MAAMkB,MAAM,GAAG,MAAM,IAAI,CAAC/C,MAAM,CAAC2C,uBAAuB,CACtDjC,IAAI,CAACsC,SAAS,CAACJ,OAAO,CAAC,EACvBlC,IAAI,CAACsC,SAAS,CAACF,OAAO,CAAC,EACvBpC,IAAI,CAACsC,SAAS,CAACH,WAAW,CAC5B,CAAC;MACD,MAAMI,KAAK,GAAGvC,IAAI,CAACC,KAAK,CAACoC,MAAM,CAACG,SAAS,CAAkB;MAC3D,MAAMC,MAAM,gBAAG5D,aAAa,CAACC,cAAc,EAAE;QAAE4D,YAAY,EAAEL,MAAM,CAACK;MAAa,CAAC,CAAC;MACnF,OAAO;QAAED,MAAM;QAAEF;MAAM,CAAC;IAC1B,CAAC,CAAC,OAAOjC,CAAU,EAAE;MACnB,MAAMtB,aAAa,CAACkB,IAAI,CAACI,CAAC,CAAC;IAC7B;EACF;;EAEA;EACAqC,oBAAoBA,CAACD,YAAoB,EAAiB;IACxD,OAAO,IAAI,CAACpD,MAAM,CAACqD,oBAAoB,CAACD,YAAY,CAAC;EACvD;;EAEA;EACAE,gBAAgBA,CAACxC,EAAkC,EAAc;IAC/D,IAAI,CAACb,cAAc,CAACsD,GAAG,CAACzC,EAAE,CAAC;IAC3B,OAAO,MAAM;MACX,IAAI,CAACb,cAAc,CAACuD,MAAM,CAAC1C,EAAE,CAAC;IAChC,CAAC;EACH;;EAEA;EACA2C,wBAAwBA,CAAC3C,EAA0C,EAAc;IAC/E,IAAI,CAACV,sBAAsB,CAACmD,GAAG,CAACzC,EAAE,CAAC;IACnC,OAAO,MAAM;MACX,IAAI,CAACV,sBAAsB,CAACoD,MAAM,CAAC1C,EAAE,CAAC;IACxC,CAAC;EACH;;EAEA;EACA4C,gBAAgBA,CAAsBC,IAAO,EAAE7C,EAAgC,EAAc;IAC3F,MAAM8C,OAAO,GAAI5C,CAAgB,IAAK;MACpC,IAAIA,CAAC,CAACC,IAAI,KAAK0C,IAAI,EAAE7C,EAAE,CAACE,CAAoB,CAAC;IAC/C,CAAC;IACD,IAAI,CAACb,cAAc,CAACoD,GAAG,CAACK,OAAO,CAAC;IAChC,OAAO,MAAM;MACX,IAAI,CAACzD,cAAc,CAACqD,MAAM,CAACI,OAAO,CAAC;IACrC,CAAC;EACH;;EAEA;EACAC,OAAOA,CAAA,EAAS;IACd,IAAI,CAAC5D,cAAc,CAAC6D,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC3D,cAAc,CAAC2D,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC1D,sBAAsB,CAAC0D,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC9D,MAAM,CAAC+D,OAAO,CAAC,CAAC;EACvB;AACF","ignoreList":[]}
+{"version":3,"names":["createElement","CheckoutButton","createOnramperNative","OnramperError","OnramperClient","state","kind","lastError","currentTransactionId","native","stateListeners","Set","eventListeners","transactionIdListeners","destroyed","constructor","config","logHandler","handler","setLogListener","json","JSON","parse","console","warn","setStateListener","s","from","error","fn","setEventListener","e","type","updateCurrentTransactionId","response","onramperTransactionId","setTransactionIdListener","transactionId","undefined","setSessionExpirationHandler","assertActive","creds","onSessionExpired","sessionId","sessionToken","configured","configure","apiKey","clientId","environment","theme","logLevel","isEventLoggingEnabled","isEventConsoleLoggingEnabled","catch","err","code","message","userMessage","next","initialize","reset","signOut","getCheckoutRequirements","request","buttonStyle","prefill","result","stringify","quote","quoteJson","button","intentHandle","cancelPreparedIntent","addStateListener","add","delete","addTransactionIdListener","addEventListener","name","wrapper","destroy","clear","dispose"],"sourceRoot":"../../src","sources":["OnramperClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/errors.js

@@ -5,20 +5,34 @@ export class OnramperError extends Error {
     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) {
     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;
       return new OnramperError({
         code: v.code ?? 'unrecoverable',
         message: v.message ?? 'Unknown error',
-        info: v.info
+        info: v.info,
+        userMessage: typeof v.userMessage === 'string' ? v.userMessage : undefined,
+        supportCode: typeof v.supportCode === 'string' ? v.supportCode : undefined
       });
     }
     return new OnramperError({

package/lib/module/errors.js.map

@@ -1 +1 @@
-{"version":3,"names":["OnramperError","Error","constructor","payload","message","name","code","info","from","value","v","String"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAyCA,OAAO,MAAMA,aAAa,SAASC,KAAK,CAAiC;EAIvEC,WAAWA,CAACC,OAA6B,EAAE;IACzC,KAAK,CAACA,OAAO,CAACC,OAAO,CAAC;IACtB,IAAI,CAACC,IAAI,GAAG,eAAe;IAC3B,IAAI,CAACC,IAAI,GAAGH,OAAO,CAACG,IAAI;IACxB,IAAI,CAACC,IAAI,GAAGJ,OAAO,CAACI,IAAI;EAC1B;EAEA,OAAOC,IAAIA,CAACC,KAAc,EAAiB;IACzC,IAAIA,KAAK,YAAYT,aAAa,EAAE,OAAOS,KAAK;IAChD,IAAIA,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MACtC;MACA;MACA;MACA;MACA,MAAMC,CAAC,GAAGD,KAA4E;MACtF,OAAO,IAAIT,aAAa,CAAC;QACvBM,IAAI,EAAGI,CAAC,CAACJ,IAAI,IAAI,eAAqC;QACtDF,OAAO,EAAEM,CAAC,CAACN,OAAO,IAAI,eAAe;QACrCG,IAAI,EAAEG,CAAC,CAACH;MACV,CAAC,CAAC;IACJ;IACA,OAAO,IAAIP,aAAa,CAAC;MAAEM,IAAI,EAAE,eAAe;MAAEF,OAAO,EAAEO,MAAM,CAACF,KAAK;IAAE,CAAC,CAAC;EAC7E;AACF","ignoreList":[]}
+{"version":3,"names":["OnramperError","Error","constructor","payload","message","name","code","userMessage","supportCode","info","from","value","undefined","startsWith","JSON","parse","slice","length","v","String"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAgDA,OAAO,MAAMA,aAAa,SAASC,KAAK,CAAiC;EAMvEC,WAAWA,CAACC,OAA6B,EAAE;IACzC,KAAK,CAACA,OAAO,CAACC,OAAO,CAAC;IACtB,IAAI,CAACC,IAAI,GAAG,eAAe;IAC3B,IAAI,CAACC,IAAI,GAAGH,OAAO,CAACG,IAAI;IACxB,IAAI,CAACC,WAAW,GAAGJ,OAAO,CAACI,WAAW,IAAI,yCAAyC;IACnF,IAAI,CAACC,WAAW,GAAGL,OAAO,CAACK,WAAW,IAAIL,OAAO,CAACG,IAAI;IACtD,IAAI,CAACG,IAAI,GAAGN,OAAO,CAACM,IAAI;EAC1B;EAEA,OAAOC,IAAIA,CAACC,KAAc,EAAiB;IACzC,IAAIA,KAAK,YAAYX,aAAa,EAAE,OAAOW,KAAK;IAChD;IACA;IACA;IACA,MAAMP,OAAO,GAAGO,KAAK,YAAYV,KAAK,GAAGU,KAAK,CAACP,OAAO,GAAG,OAAOO,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAGC,SAAS;IACtG,IAAIR,OAAO,EAAES,UAAU,CAAC,iBAAiB,CAAC,EAAE;MAC1C,IAAI;QACF,MAAMV,OAAO,GAAGW,IAAI,CAACC,KAAK,CAACX,OAAO,CAACY,KAAK,CAAC,iBAAiB,CAACC,MAAM,CAAC,CAAC;QACnE,IAAId,OAAO,IAAI,OAAOA,OAAO,CAACG,IAAI,KAAK,QAAQ,IAAI,OAAOH,OAAO,CAACC,OAAO,KAAK,QAAQ,EAAE;UACtF,OAAOJ,aAAa,CAACU,IAAI,CAACP,OAAO,CAAC;QACpC;MACF,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;IACA,IAAIQ,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MACtC,MAAMO,CAAC,GAAGP,KAAsC;MAChD,OAAO,IAAIX,aAAa,CAAC;QACvBM,IAAI,EAAGY,CAAC,CAACZ,IAAI,IAAI,eAAqC;QACtDF,OAAO,EAAEc,CAAC,CAACd,OAAO,IAAI,eAAe;QACrCK,IAAI,EAAES,CAAC,CAACT,IAAI;QACZF,WAAW,EAAE,OAAOW,CAAC,CAACX,WAAW,KAAK,QAAQ,GAAGW,CAAC,CAACX,WAAW,GAAGK,SAAS;QAC1EJ,WAAW,EAAE,OAAOU,CAAC,CAACV,WAAW,KAAK,QAAQ,GAAGU,CAAC,CAACV,WAAW,GAAGI;MACnE,CAAC,CAAC;IACJ;IACA,OAAO,IAAIZ,aAAa,CAAC;MAAEM,IAAI,EAAE,eAAe;MAAEF,OAAO,EAAEe,MAAM,CAACR,KAAK;IAAE,CAAC,CAAC;EAC7E;AACF","ignoreList":[]}

package/lib/typescript/commonjs/src/OnramperClient.d.ts

@@ -23,7 +23,9 @@ export declare class OnramperClient {
     private readonly eventListeners;
     private readonly transactionIdListeners;
     private readonly configured;
+    private destroyed;
     constructor(config: OnramperConfiguration);
+    private assertActive;
     private updateCurrentTransactionId;
     initialize(creds: SessionCredentials): Promise<void>;
     reset(): Promise<void>;
@@ -38,6 +40,8 @@ export declare class OnramperClient {
      * Fetches checkout requirements + quote and returns a native checkout button
      * to render plus the quote. The button handles login / finalize / webview
      * internally; outcomes surface via the event stream (`addEventListener`).
+     * A newer preparation, reset, or sign-out invalidates older unmounted buttons
+     * and rejects obsolete in-flight preparations with `intentInvalidated`.
      *
      * Pass `prefill` to pre-populate the OnramperID sign-in and additional-info
      * screens with values you already know about the user. It is best-effort and
@@ -58,7 +62,7 @@ export declare class OnramperClient {
     addTransactionIdListener(fn: (transactionId: string | null) => void): () => void;
     /** Subscribe to a specific checkout event. Returns an unsubscribe function. */
     addEventListener<K extends EventName>(name: K, fn: (e: EventPayload<K>) => void): () => void;
-    /** Tear down: clears JS listeners and releases the native callbacks + SDK client. */
+    /** Idempotent teardown. Further operations reject with `clientDestroyed`; create a new client to restart. */
     destroy(): void;
 }
 //# sourceMappingURL=OnramperClient.d.ts.map

package/lib/typescript/commonjs/src/OnramperClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OnramperClient.d.ts","sourceRoot":"","sources":["../../../../src/OnramperClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,OAAO,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAiB,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,6BAA6B;IAC5C,yHAAyH;IACzH,MAAM,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,KAAK,EAAE,aAAa,CAAoB;IACxC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAQ;IACvC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqD;IAI5F,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;gBAE/B,MAAM,EAAE,qBAAqB;IAoDzC,OAAO,CAAC,0BAA0B;IAa5B,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;;;;;;;;;;;;;OAcG;IACG,uBAAuB,CAC3B,OAAO,EAAE,eAAe,EACxB,WAAW,GAAE,mBAAwB,EACrC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,6BAA6B,CAAC;IAgBzC,oFAAoF;IACpF,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAOhE,+FAA+F;IAC/F,wBAAwB,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAOhF,+EAA+E;IAC/E,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAU5F,qFAAqF;IACrF,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"OnramperClient.d.ts","sourceRoot":"","sources":["../../../../src/OnramperClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,OAAO,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAiB,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EAErB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,6BAA6B;IAC5C,yHAAyH;IACzH,MAAM,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,KAAK,EAAE,aAAa,CAAoB;IACxC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAQ;IACvC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6C;IAC5E,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqD;IAI5F,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,qBAAqB;IAuEzC,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,0BAA0B;IAe5B,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;;;;;;;;;;;;;;;OAgBG;IACG,uBAAuB,CAC3B,OAAO,EAAE,eAAe,EACxB,WAAW,GAAE,mBAAwB,EACrC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,6BAA6B,CAAC;IAoBzC,oFAAoF;IAC9E,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAQhE,+FAA+F;IAC/F,wBAAwB,CAAC,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAQhF,+EAA+E;IAC/E,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAW5F,6GAA6G;IAC7G,OAAO,IAAI,IAAI;CAQhB"}