@onramper/onramper-react-native 1.2.0 → 1.2.1

package/nitrogen/generated/ios/swift/HybridOnramperNitroSpec_cxx.swift

@@ -270,6 +270,28 @@ open class HybridOnramperNitroSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func setTransactionIdListener(onTransactionId: bridge.Func_void_std__optional_std__string_) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.setTransactionIdListener(onTransactionId: { () -> (String?) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__optional_std__string_(onTransactionId)
+        return { (__transactionId: String?) -> Void in
+          __wrappedFunction.call({ () -> bridge.std__optional_std__string_ in
+            if let __unwrappedValue = __transactionId {
+              return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+            } else {
+              return .init()
+            }
+          }())
+        }
+      }())
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func setSessionExpirationHandler(handler: bridge.Func_std__shared_ptr_Promise_std__shared_ptr_Promise_NitroSessionCredentials____) -> bridge.Result_void_ {
     do {

package/nitrogen/generated/shared/c++/HybridOnramperNitroSpec.cpp

@@ -22,6 +22,7 @@ namespace margelo::nitro::onramper {
       prototype.registerHybridMethod("cancelPreparedIntent", &HybridOnramperNitroSpec::cancelPreparedIntent);
       prototype.registerHybridMethod("setStateListener", &HybridOnramperNitroSpec::setStateListener);
       prototype.registerHybridMethod("setEventListener", &HybridOnramperNitroSpec::setEventListener);
+      prototype.registerHybridMethod("setTransactionIdListener", &HybridOnramperNitroSpec::setTransactionIdListener);
       prototype.registerHybridMethod("setSessionExpirationHandler", &HybridOnramperNitroSpec::setSessionExpirationHandler);
     });
   }

package/nitrogen/generated/shared/c++/HybridOnramperNitroSpec.hpp

@@ -25,6 +25,7 @@ namespace margelo::nitro::onramper { struct NitroSessionCredentials; }
 #include <string>
 #include "PreparedIntentResult.hpp"
 #include <functional>
+#include <optional>
 #include "NitroSessionCredentials.hpp"
 
 namespace margelo::nitro::onramper {
@@ -66,6 +67,7 @@ namespace margelo::nitro::onramper {
       virtual std::shared_ptr<Promise<void>> cancelPreparedIntent(const std::string& intentHandle) = 0;
       virtual void setStateListener(const std::function<void(const std::string& /* stateJson */)>& onState) = 0;
       virtual void setEventListener(const std::function<void(const std::string& /* eventJson */)>& onEvent) = 0;
+      virtual void setTransactionIdListener(const std::function<void(const std::optional<std::string>& /* transactionId */)>& onTransactionId) = 0;
       virtual void setSessionExpirationHandler(const std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<NitroSessionCredentials>>>>()>& handler) = 0;
 
     protected:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onramper/onramper-react-native",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "React Native wrapper for the Onramper iOS SDK",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -64,7 +64,7 @@
   "license": "Apache-2.0",
   "homepage": "https://github.com/onramper/onramper-react-native#readme",
   "onramperSDK": {
-    "checksum": "2d0f28702120326e5ebb191cb2a812b11bf58a9672fcde8cf1762182e96e932b"
+    "checksum": "305cca364bb24bb5ec964488e1dc815a9a63c734a989482080cbc02993ec7f6b"
   },
   "peerDependencies": {
     "react": ">=19.0.0",

package/src/OnramperClient.ts

@@ -30,12 +30,14 @@ export interface GetCheckoutRequirementsResult {
 export class OnramperClient {
   state: OnramperState = { kind: 'idle' };
   lastError: OnramperError | null = null;
+  currentTransactionId: string | null = null;
 
   // Each client owns its own native instance (and thus its own SDK client).
   private readonly native = createOnramperNative();
 
   private readonly stateListeners = new Set<(state: OnramperState) => void>();
   private readonly eventListeners = new Set<(event: CheckoutEvent) => void>();
+  private readonly transactionIdListeners = new Set<(transactionId: string | null) => void>();
 
   // Resolved when the constructor-issued configure() completes. Public methods
   // that need the native client await this first.
@@ -50,12 +52,23 @@ export class OnramperClient {
       for (const fn of this.stateListeners) fn(s);
     });
 
-    // Single native checkout-event callback → fan out to listeners.
+    // Single native checkout-event callback → keep the transaction ID mirror
+    // synchronized at finalization, then fan out to checkout listeners.
     this.native.setEventListener((json) => {
       const e = JSON.parse(json) as CheckoutEvent;
+      if (e.type === 'checkoutFinalized') {
+        this.updateCurrentTransactionId(e.response.onramperTransactionId);
+      }
       for (const fn of this.eventListeners) fn(e);
     });
 
+    this.native.setTransactionIdListener((transactionId) => {
+      // 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.
+      if (transactionId !== undefined) this.updateCurrentTransactionId(transactionId);
+    });
+
     // The SDK calls this when its session expires; return fresh credentials.
     // Nitro stores the async callback natively and awaits it directly — no
     // event round-trip needed.
@@ -82,6 +95,19 @@ export class OnramperClient {
     this.configured.catch(() => undefined);
   }
 
+  private updateCurrentTransactionId(next: string | null): void {
+    if (next === this.currentTransactionId) return;
+
+    this.currentTransactionId = next;
+    for (const fn of [...this.transactionIdListeners]) {
+      try {
+        fn(next);
+      } catch (error: unknown) {
+        console.error('Onramper transaction ID listener threw:', error);
+      }
+    }
+  }
+
   async initialize(creds: SessionCredentials): Promise<void> {
     try {
       await this.configured;
@@ -95,6 +121,7 @@ export class OnramperClient {
     try {
       await this.configured;
       await this.native.reset();
+      this.updateCurrentTransactionId(null);
     } catch (e: unknown) {
       throw OnramperError.from(e);
     }
@@ -110,6 +137,7 @@ export class OnramperClient {
     try {
       await this.configured;
       await this.native.signOut();
+      this.updateCurrentTransactionId(null);
     } catch (e: unknown) {
       throw OnramperError.from(e);
     }
@@ -166,6 +194,14 @@ export class OnramperClient {
     };
   }
 
+  /** Subscribe to the durable Onramper transaction ID. Successful reset/signOut publish null. */
+  addTransactionIdListener(fn: (transactionId: string | null) => void): () => void {
+    this.transactionIdListeners.add(fn);
+    return () => {
+      this.transactionIdListeners.delete(fn);
+    };
+  }
+
   /** Subscribe to a specific checkout event. Returns an unsubscribe function. */
   addEventListener<K extends EventName>(name: K, fn: (e: EventPayload<K>) => void): () => void {
     const wrapper = (e: CheckoutEvent) => {
@@ -181,6 +217,7 @@ export class OnramperClient {
   destroy(): void {
     this.stateListeners.clear();
     this.eventListeners.clear();
+    this.transactionIdListeners.clear();
     this.native.dispose();
   }
 }

package/src/specs/OnramperNitro.nitro.ts

@@ -52,6 +52,8 @@ export interface OnramperNitro extends HybridObject<{ ios: 'swift' }> {
   // Single native callback per stream; the JS wrapper fans out to multiple listeners.
   setStateListener(onState: (stateJson: string) => void): void;
   setEventListener(onEvent: (eventJson: string) => void): void;
+  // Mirrors OnramperSDK.$currentTransactionId. `undefined` represents native nil.
+  setTransactionIdListener(onTransactionId: (transactionId: string | undefined) => void): void;
 
   // The SDK's sessionExpirationHandler, as a stored async callback that returns
   // fresh credentials. Replaces the Expo-era onSessionExpired/provide/fail dance.

package/src/types.ts

@@ -115,6 +115,8 @@ export interface HeadlessCheckoutData {
 
 export interface CheckoutFinalizeResponse {
   headlessCheckoutId: string;
+  /** Durable Onramper transaction identifier for support, reconciliation, and status lookups. */
+  onramperTransactionId: string;
   headlessCheckoutData: HeadlessCheckoutData;
 }