com-tapp-so-sdk 0.1.0 → 0.1.2

package/android/src/main/java/com/comtappsosdk/ComTappSoSdkModule.kt

@@ -1,5 +1,7 @@
 package com.comtappsosdk
 
+import android.os.Handler
+import android.os.Looper
 import android.util.Log
 import com.example.tapp.Tapp
 import com.example.tapp.models.Affiliate
@@ -23,6 +25,7 @@ import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
+import java.util.concurrent.ConcurrentLinkedQueue
 
 @ReactModule(name = ComTappSoSdkModule.NAME)
 class ComTappSoSdkModule(reactContext: ReactApplicationContext) :
@@ -30,16 +33,153 @@ class ComTappSoSdkModule(reactContext: ReactApplicationContext) :
 
   companion object {
     const val NAME = "ComTappSoSdk"
+    private const val FLUSH_RETRY_INTERVAL_MS = 100L
+    private const val FLUSH_RETRY_MAX_DURATION_MS = 2000L
   }
 
   private lateinit var tapp: Tapp
+  private var listenerCount = 0
+  private val eventQueue = ConcurrentLinkedQueue<Pair<String, WritableMap?>>()
+  private val mainHandler = Handler(Looper.getMainLooper())
+  private var flushRetryStartTime: Long = 0
+  private var isFlushRetryScheduled = false
 
   init {
-    Log.i(NAME, "IS_NEW_ARCHITECTURE_ENABLED: ${BuildConfig.IS_NEW_ARCHITECTURE_ENABLED}")
+    // Module initialized
   }
-
   override fun getName(): String = NAME
 
+  // Required by NativeEventEmitter
+  @ReactMethod
+  fun addListener(eventName: String) {
+    listenerCount++
+    flushEvents()
+    // Schedule retry in case React is not active yet
+    scheduleFlushRetry()
+  }
+
+  // Required by NativeEventEmitter
+  @ReactMethod
+  fun removeListeners(count: Int) {
+    listenerCount -= count
+    if (listenerCount < 0) {
+      listenerCount = 0
+    }
+  }
+
+  /**
+   * Check if React Native is active. Prefers hasActiveCatalystInstance(),
+   * falls back to hasActiveReactInstance() for newer RN versions.
+   */
+  private fun isReactActive(): Boolean {
+    return try {
+      reactApplicationContext.hasActiveCatalystInstance()
+    } catch (e: Exception) {
+      try {
+        // Fallback for newer React Native versions
+        val method = reactApplicationContext.javaClass.getMethod("hasActiveReactInstance")
+        method.invoke(reactApplicationContext) as Boolean
+      } catch (e2: Exception) {
+        false
+      }
+    }
+  }
+
+  /**
+   * Schedule flush retries every 100ms for up to 2 seconds.
+   * This ensures buffered events are flushed even if React wasn't active initially.
+   */
+  private fun scheduleFlushRetry() {
+    if (isFlushRetryScheduled) return
+    if (eventQueue.isEmpty()) return
+
+    isFlushRetryScheduled = true
+    flushRetryStartTime = System.currentTimeMillis()
+
+    mainHandler.postDelayed(object : Runnable {
+      override fun run() {
+        val elapsed = System.currentTimeMillis() - flushRetryStartTime
+
+        if (eventQueue.isEmpty() || listenerCount == 0) {
+          isFlushRetryScheduled = false
+          return
+        }
+
+        if (elapsed > FLUSH_RETRY_MAX_DURATION_MS) {
+          isFlushRetryScheduled = false
+          return
+        }
+
+        flushEvents()
+
+        // Continue retrying if queue still has items
+        if (!eventQueue.isEmpty()) {
+          mainHandler.postDelayed(this, FLUSH_RETRY_INTERVAL_MS)
+        } else {
+          isFlushRetryScheduled = false
+        }
+      }
+    }, FLUSH_RETRY_INTERVAL_MS)
+  }
+
+  private fun emitOrBuffer(eventName: String, params: WritableMap?) {
+    // If we have listeners and the React context is active, emit immediately
+    if (listenerCount > 0 && isReactActive()) {
+      mainHandler.post {
+        emitNow(eventName, params)
+      }
+    } else {
+      // Otherwise buffer
+      try {
+        eventQueue.add(Pair(eventName, params))
+        // Cap buffer size at 10 to avoid memory leaks
+        if (eventQueue.size > 10) {
+          eventQueue.poll()
+        }
+        // Start retry scheduler if not already running
+        if (listenerCount > 0) {
+          scheduleFlushRetry()
+        }
+      } catch (e: Exception) {
+        Log.e(NAME, "Error buffering event: ${e.message}")
+      }
+    }
+  }
+
+  private fun flushEvents() {
+    if (!isReactActive() || listenerCount == 0) {
+      return
+    }
+
+    mainHandler.post {
+      while (listenerCount > 0 && isReactActive() && !eventQueue.isEmpty()) {
+        val event = eventQueue.poll()
+        if (event != null) {
+          emitNow(event.first, event.second)
+        }
+      }
+    }
+  }
+
+  private fun emitNow(eventName: String, params: WritableMap?) {
+    try {
+      if (isReactActive()) {
+        reactApplicationContext
+          .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+          .emit(eventName, params)
+      } else {
+        // Re-enqueue if React became inactive
+        eventQueue.add(Pair(eventName, params))
+        scheduleFlushRetry()
+      }
+    } catch (e: Exception) {
+      Log.e(NAME, "Error emitting event $eventName: ${e.message}")
+      // Re-enqueue on error
+      eventQueue.add(Pair(eventName, params))
+      scheduleFlushRetry()
+    }
+  }
+
 
   @ReactMethod
   fun start(authToken: String, env: String, tappToken: String) {
@@ -298,9 +438,7 @@ class ComTappSoSdkModule(reactContext: ReactApplicationContext) :
       putString("url", response.url)
       putString("error", response.error.ifEmpty { "" })
     }
-    reactApplicationContext
-      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
-      .emit("onDidFailResolvingURL", map)
+    emitOrBuffer("onDidFailResolvingURL", map)
   }
 
 
@@ -322,18 +460,14 @@ class ComTappSoSdkModule(reactContext: ReactApplicationContext) :
       }
       putMap("data", dataMap)
     }
-    reactApplicationContext
-      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
-      .emit("onDeferredLinkReceived", map)
+    emitOrBuffer("onDeferredLinkReceived", map)
   }
 
   private fun sendTestEvent(test: String) {
     val map: WritableMap = Arguments.createMap().apply {
       putString("test", test)
     }
-    reactApplicationContext
-      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
-      .emit("onTestListener", map)
+    emitOrBuffer("onTestListener", map)
   }
 
   private fun convertResponseToMap(response: RequestModels.TappLinkDataResponse): WritableMap {

package/ios/ComTappSoSdk.mm

@@ -18,28 +18,31 @@
 #endif
 
 //-------------------------------------------------------------
-// MARK: - Internal EventEmitter
+// MARK: - Internal TappEventEmitter
 // This module sends events from native to JS.
 //-------------------------------------------------------------
-@interface EventEmitter : RCTEventEmitter <RCTBridgeModule>
+@interface TappEventEmitter : RCTEventEmitter <RCTBridgeModule>
 + (instancetype)shared;
+- (void)emitOrBuffer:(NSString *)eventName body:(id)body;
 @end
 
 static NSString * const kOnDeferredLinkReceived = @"onDeferredLinkReceived";
 static NSString * const kOnDidFailResolvingURL = @"onDidFailResolvingURL";
 static NSString * const kOnTestListener = @"onTestListener";
-static EventEmitter *sharedInstance = nil;
+static TappEventEmitter *sharedInstance = nil;
 
-@implementation EventEmitter
+@implementation TappEventEmitter {
+  BOOL _hasListeners;
+  NSMutableArray<NSDictionary *> *_pendingEvents;
+}
 
-RCT_EXPORT_MODULE(EventEmitter);
+RCT_EXPORT_MODULE(TappEventEmitter);
 
 - (instancetype)init {
   if ((self = [super init])) {
     sharedInstance = self;
-    [self addListener:kOnDeferredLinkReceived];
-    [self addListener:kOnDidFailResolvingURL];
-    [self addListener:kOnTestListener];
+    _pendingEvents = [NSMutableArray new];
+    _hasListeners = NO;
   }
   return self;
 }
@@ -56,8 +59,38 @@ RCT_EXPORT_MODULE(EventEmitter);
   return @[kOnDeferredLinkReceived, kOnDidFailResolvingURL, kOnTestListener];
 }
 
-- (void)startObserving {}
-- (void)stopObserving {}
+- (void)startObserving {
+  _hasListeners = YES;
+  [self flushEvents];
+}
+
+- (void)stopObserving {
+  _hasListeners = NO;
+}
+
+- (void)emitOrBuffer:(NSString *)eventName body:(id)body {
+  // Ensure main thread for safety, as listeners are JS-side
+  dispatch_async(dispatch_get_main_queue(), ^{
+    if (self->_hasListeners) {
+      [self sendEventWithName:eventName body:body];
+    } else {
+      [self->_pendingEvents addObject:@{@"name": eventName, @"body": body ?: [NSNull null]}];
+      // Keep buffer small (last 5 events) to avoid memory issues if listeners never attach
+      if (self->_pendingEvents.count > 5) {
+        [self->_pendingEvents removeObjectAtIndex:0];
+      }
+    }
+  });
+}
+
+- (void)flushEvents {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    for (NSDictionary *event in self->_pendingEvents) {
+      [self sendEventWithName:event[@"name"] body:event[@"body"]];
+    }
+    [self->_pendingEvents removeAllObjects];
+  });
+}
 
 @end
 
@@ -273,16 +306,97 @@ RCT_EXPORT_METHOD(simulateTestEvent) {
   NSLog(@"[ComTappSoSdk] simulateTestEvent is unsupported on iOS");
 }
 
+// DEBUG-only: Simulate a deferred link event for testing
+// This should only be used in development for verifying event delivery
+RCT_EXPORT_METHOD(simulateDeferredLink:(NSDictionary *)payload) {
+#ifdef DEBUG
+  // Guard against nil payload from JS
+  NSDictionary *safePayload = payload ?: @{};
+  NSLog(@"[ComTappSoSdk] simulateDeferredLink called with: %@", safePayload);
+  
+  // Build result on main thread to avoid any thread issues
+  dispatch_async(dispatch_get_main_queue(), ^{
+    NSDictionary *result = @{
+      @"error": @(NO),
+      @"message": [NSNull null],
+      @"tappUrl": safePayload[@"tappUrl"] ?: @"tapp://simulated",
+      @"attrTappUrl": safePayload[@"attrTappUrl"] ?: @"tapp://simulated/attributed",
+      @"influencer": safePayload[@"influencer"] ?: @"test_influencer",
+      @"data": safePayload[@"data"] ?: @{},
+      @"isFirstSession": safePayload[@"isFirstSession"] ?: @(YES)
+    };
+    
+    TappEventEmitter *emitter = [TappEventEmitter shared];
+    if (emitter) {
+      [emitter emitOrBuffer:kOnDeferredLinkReceived body:result];
+      NSLog(@"[ComTappSoSdk] simulateDeferredLink emitted successfully");
+    } else {
+      NSLog(@"[ComTappSoSdk] simulateDeferredLink: No emitter available");
+    }
+  });
+#else
+  NSLog(@"[ComTappSoSdk] simulateDeferredLink is only available in DEBUG builds");
+#endif
+}
+
+// DEBUG-only: Simulate a fail resolving URL event for testing
+RCT_EXPORT_METHOD(simulateFailResolving:(NSString *)url errorMessage:(NSString *)errorMessage) {
+#ifdef DEBUG
+  // Guard against nil values from JS
+  NSString *safeUrl = url ?: @"tapp://unknown";
+  NSString *safeError = errorMessage ?: @"Simulated error for testing";
+  NSLog(@"[ComTappSoSdk] simulateFailResolving called with url: %@, error: %@", safeUrl, safeError);
+  
+  // Build result and emit on main thread
+  dispatch_async(dispatch_get_main_queue(), ^{
+    NSDictionary *result = @{
+      @"url": safeUrl,
+      @"error": safeError
+    };
+    
+    TappEventEmitter *emitter = [TappEventEmitter shared];
+    if (emitter) {
+      [emitter emitOrBuffer:kOnDidFailResolvingURL body:result];
+      NSLog(@"[ComTappSoSdk] simulateFailResolving emitted successfully");
+    } else {
+      NSLog(@"[ComTappSoSdk] simulateFailResolving: No emitter available");
+    }
+  });
+#else
+  NSLog(@"[ComTappSoSdk] simulateFailResolving is only available in DEBUG builds");
+#endif
+}
+
 // ----------------------------------------------------------------------
 // (Keep all existing methods below unchanged.)
 // ----------------------------------------------------------------------
 
 
+#pragma mark - TappDelegate Methods
+
+// Helper to get the TappEventEmitter shared instance.
+// In New Architecture, we must only use the shared static instance.
+// Using self.bridge or moduleForClass causes EXC_BAD_ACCESS crashes.
+- (TappEventEmitter *)ensureEmitter {
+  TappEventEmitter *emitter = [TappEventEmitter shared];
+  if (!emitter) {
+    NSLog(@"[ComTappSoSdk] WARNING: TappEventEmitter shared instance not yet available");
+  }
+  return emitter;
+}
+
 #pragma mark - TappDelegate Methods
 
 - (void)didOpenApplicationWith:(TappDeferredLinkData *)data {
   NSDictionary *result = [self dictionaryFromLinkData:data];
-  [[EventEmitter shared] sendEventWithName:@"onDeferredLinkReceived" body:result];
+  dispatch_async(dispatch_get_main_queue(), ^{
+    TappEventEmitter *emitter = [self ensureEmitter];
+    if (emitter) {
+      [emitter emitOrBuffer:kOnDeferredLinkReceived body:result];
+    } else {
+      NSLog(@"[ComTappSoSdk] ERROR: TappEventEmitter unavailable, event dropped");
+    }
+  });
 }
 
 - (void)didFailResolvingURLWithUrl:(NSURL *)url error:(NSError *)error {
@@ -290,7 +404,14 @@ RCT_EXPORT_METHOD(simulateTestEvent) {
     @"url": url.absoluteString ?: @"",
     @"error": error.localizedDescription ?: @""
   };
-  [[EventEmitter shared] sendEventWithName:@"onDidFailResolvingURL" body:result];
+  dispatch_async(dispatch_get_main_queue(), ^{
+    TappEventEmitter *emitter = [self ensureEmitter];
+    if (emitter) {
+      [emitter emitOrBuffer:kOnDidFailResolvingURL body:result];
+    } else {
+      NSLog(@"[ComTappSoSdk] ERROR: TappEventEmitter unavailable, event dropped");
+    }
+  });
 }
 
 - (NSString *)mapEventAction:(double)eventAction {

package/ios/generated/ComTappSoSdkSpec/ComTappSoSdkSpec-generated.mm

@@ -54,6 +54,22 @@ namespace facebook::react {
       return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "simulateTestEvent", @selector(simulateTestEvent), args, count);
     }
 
+    static facebook::jsi::Value __hostFunction_NativeComTappSoSdkSpecJSI_simulateDeferredLink(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "simulateDeferredLink", @selector(simulateDeferredLink:), args, count);
+    }
+
+    static facebook::jsi::Value __hostFunction_NativeComTappSoSdkSpecJSI_simulateFailResolving(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "simulateFailResolving", @selector(simulateFailResolving:errorMessage:), args, count);
+    }
+
+    static facebook::jsi::Value __hostFunction_NativeComTappSoSdkSpecJSI_addListener(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "addListener", @selector(addListener:), args, count);
+    }
+
+    static facebook::jsi::Value __hostFunction_NativeComTappSoSdkSpecJSI_removeListeners(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+      return static_cast<ObjCTurboModule&>(turboModule).invokeObjCMethod(rt, VoidKind, "removeListeners", @selector(removeListeners:), args, count);
+    }
+
   NativeComTappSoSdkSpecJSI::NativeComTappSoSdkSpecJSI(const ObjCTurboModule::InitParams &params)
     : ObjCTurboModule(params) {
       
@@ -77,5 +93,17 @@ namespace facebook::react {
         
         methodMap_["simulateTestEvent"] = MethodMetadata {0, __hostFunction_NativeComTappSoSdkSpecJSI_simulateTestEvent};
         
+        
+        methodMap_["simulateDeferredLink"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkSpecJSI_simulateDeferredLink};
+        
+        
+        methodMap_["simulateFailResolving"] = MethodMetadata {2, __hostFunction_NativeComTappSoSdkSpecJSI_simulateFailResolving};
+        
+        
+        methodMap_["addListener"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkSpecJSI_addListener};
+        
+        
+        methodMap_["removeListeners"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkSpecJSI_removeListeners};
+        
   }
 } // namespace facebook::react

package/ios/generated/ComTappSoSdkSpec/ComTappSoSdkSpec.h

@@ -58,6 +58,11 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)fetchOriginLinkData:(RCTPromiseResolveBlock)resolve
                      reject:(RCTPromiseRejectBlock)reject;
 - (void)simulateTestEvent;
+- (void)simulateDeferredLink:(NSDictionary *)payload;
+- (void)simulateFailResolving:(NSString *)url
+                 errorMessage:(NSString *)errorMessage;
+- (void)addListener:(NSString *)eventName;
+- (void)removeListeners:(double)count;
 
 @end
 

package/ios/generated/ComTappSoSdkSpecJSI-generated.cpp

@@ -60,6 +60,35 @@ static jsi::Value __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateTestEvent(
   );
   return jsi::Value::undefined();
 }
+static jsi::Value __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateDeferredLink(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeComTappSoSdkCxxSpecJSI *>(&turboModule)->simulateDeferredLink(
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asObject(rt)
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateFailResolving(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeComTappSoSdkCxxSpecJSI *>(&turboModule)->simulateFailResolving(
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asString(rt),
+    count <= 1 ? throw jsi::JSError(rt, "Expected argument in position 1 to be passed") : args[1].asString(rt)
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeComTappSoSdkCxxSpecJSI_addListener(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeComTappSoSdkCxxSpecJSI *>(&turboModule)->addListener(
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asString(rt)
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeComTappSoSdkCxxSpecJSI_removeListeners(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeComTappSoSdkCxxSpecJSI *>(&turboModule)->removeListeners(
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber()
+  );
+  return jsi::Value::undefined();
+}
 
 NativeComTappSoSdkCxxSpecJSI::NativeComTappSoSdkCxxSpecJSI(std::shared_ptr<CallInvoker> jsInvoker)
   : TurboModule("ComTappSoSdk", jsInvoker) {
@@ -70,6 +99,10 @@ NativeComTappSoSdkCxxSpecJSI::NativeComTappSoSdkCxxSpecJSI(std::shared_ptr<CallI
   methodMap_["shouldProcess"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkCxxSpecJSI_shouldProcess};
   methodMap_["fetchOriginLinkData"] = MethodMetadata {0, __hostFunction_NativeComTappSoSdkCxxSpecJSI_fetchOriginLinkData};
   methodMap_["simulateTestEvent"] = MethodMetadata {0, __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateTestEvent};
+  methodMap_["simulateDeferredLink"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateDeferredLink};
+  methodMap_["simulateFailResolving"] = MethodMetadata {2, __hostFunction_NativeComTappSoSdkCxxSpecJSI_simulateFailResolving};
+  methodMap_["addListener"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkCxxSpecJSI_addListener};
+  methodMap_["removeListeners"] = MethodMetadata {1, __hostFunction_NativeComTappSoSdkCxxSpecJSI_removeListeners};
 }
 
 

package/ios/generated/ComTappSoSdkSpecJSI.h

@@ -27,6 +27,10 @@ public:
   virtual jsi::Value shouldProcess(jsi::Runtime &rt, jsi::String deepLink) = 0;
   virtual jsi::Value fetchOriginLinkData(jsi::Runtime &rt) = 0;
   virtual void simulateTestEvent(jsi::Runtime &rt) = 0;
+  virtual void simulateDeferredLink(jsi::Runtime &rt, jsi::Object payload) = 0;
+  virtual void simulateFailResolving(jsi::Runtime &rt, jsi::String url, jsi::String errorMessage) = 0;
+  virtual void addListener(jsi::Runtime &rt, jsi::String eventName) = 0;
+  virtual void removeListeners(jsi::Runtime &rt, double count) = 0;
 
 };
 
@@ -113,6 +117,38 @@ private:
       return bridging::callFromJs<void>(
           rt, &T::simulateTestEvent, jsInvoker_, instance_);
     }
+    void simulateDeferredLink(jsi::Runtime &rt, jsi::Object payload) override {
+      static_assert(
+          bridging::getParameterCount(&T::simulateDeferredLink) == 2,
+          "Expected simulateDeferredLink(...) to have 2 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::simulateDeferredLink, jsInvoker_, instance_, std::move(payload));
+    }
+    void simulateFailResolving(jsi::Runtime &rt, jsi::String url, jsi::String errorMessage) override {
+      static_assert(
+          bridging::getParameterCount(&T::simulateFailResolving) == 3,
+          "Expected simulateFailResolving(...) to have 3 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::simulateFailResolving, jsInvoker_, instance_, std::move(url), std::move(errorMessage));
+    }
+    void addListener(jsi::Runtime &rt, jsi::String eventName) override {
+      static_assert(
+          bridging::getParameterCount(&T::addListener) == 2,
+          "Expected addListener(...) to have 2 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::addListener, jsInvoker_, instance_, std::move(eventName));
+    }
+    void removeListeners(jsi::Runtime &rt, double count) override {
+      static_assert(
+          bridging::getParameterCount(&T::removeListeners) == 2,
+          "Expected removeListeners(...) to have 2 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::removeListeners, jsInvoker_, instance_, std::move(count));
+    }
 
   private:
     friend class NativeComTappSoSdkCxxSpec;

package/lib/module/NativeComTappSoSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeComTappSoSdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AA6CpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,cAAc,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeComTappSoSdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAqDpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,cAAc,CAAC","ignoreList":[]}

package/lib/module/events.js

@@ -1,10 +1,26 @@
 "use strict";
 
-import { NativeEventEmitter, NativeModules } from 'react-native';
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 const {
-  EventEmitter
+  TappEventEmitter,
+  ComTappSoSdk
 } = NativeModules;
-const eventEmitter = new NativeEventEmitter(EventEmitter);
+import ComTappSoSdkTurbo from './NativeComTappSoSdk';
+let eventEmitterModule;
+if (Platform.OS === 'ios') {
+  eventEmitterModule = TappEventEmitter;
+} else if (Platform.OS === 'android') {
+  // Policy: Prefer NativeModules.ComTappSoSdk because it is consistently wired
+  if (ComTappSoSdk && typeof ComTappSoSdk.addListener === 'function') {
+    eventEmitterModule = ComTappSoSdk;
+  } else if (ComTappSoSdkTurbo && typeof ComTappSoSdkTurbo.addListener === 'function') {
+    eventEmitterModule = ComTappSoSdkTurbo;
+  }
+}
+if (!eventEmitterModule) {
+  console.warn(`[TappSDK] Event emitter module is undefined for platform: ${Platform.OS}. Events will not be received.`);
+}
+const eventEmitter = new NativeEventEmitter(eventEmitterModule);
 export function addDeferredLinkListener(listener) {
   return eventEmitter.addListener('onDeferredLinkReceived', listener);
 }

package/lib/module/events.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","NativeModules","EventEmitter","eventEmitter","addDeferredLinkListener","listener","addListener","addDidFailResolvingURLListener","addTestListener"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,cAAc;AAGhE,MAAM;EAAEC;AAAa,CAAC,GAAGD,aAAa;AACtC,MAAME,YAAY,GAAG,IAAIH,kBAAkB,CAACE,YAAY,CAAC;AAEzD,OAAO,SAASE,uBAAuBA,CACrCC,QAAkD,EAClD;EACA,OAAOF,YAAY,CAACG,WAAW,CAAC,wBAAwB,EAAED,QAAQ,CAAC;AACrE;AAEA,OAAO,SAASE,8BAA8BA,CAC5CF,QAA4D,EAC5D;EACA,OAAOF,YAAY,CAACG,WAAW,CAAC,uBAAuB,EAAED,QAAQ,CAAC;AACpE;AAEA,OAAO,SAASG,eAAeA,CAACH,QAA0C,EAAE;EAC1E,OAAOF,YAAY,CAACG,WAAW,CAAC,gBAAgB,EAAED,QAAQ,CAAC;AAC7D","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","TappEventEmitter","ComTappSoSdk","ComTappSoSdkTurbo","eventEmitterModule","OS","addListener","console","warn","eventEmitter","addDeferredLinkListener","listener","addDidFailResolvingURLListener","addTestListener"],"sourceRoot":"../../src","sources":["events.ts"],"mappings":";;AAAA,SAASA,kBAAkB,EAAEC,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAG1E,MAAM;EAAEC,gBAAgB;EAAEC;AAAa,CAAC,GAAGH,aAAa;AACxD,OAAOI,iBAAiB,MAAM,sBAAsB;AAEpD,IAAIC,kBAAuB;AAE3B,IAAIJ,QAAQ,CAACK,EAAE,KAAK,KAAK,EAAE;EACzBD,kBAAkB,GAAGH,gBAAgB;AACvC,CAAC,MAAM,IAAID,QAAQ,CAACK,EAAE,KAAK,SAAS,EAAE;EACpC;EACA,IAAIH,YAAY,IAAI,OAAOA,YAAY,CAACI,WAAW,KAAK,UAAU,EAAE;IAClEF,kBAAkB,GAAGF,YAAY;EACnC,CAAC,MAAM,IACLC,iBAAiB,IACjB,OAAOA,iBAAiB,CAACG,WAAW,KAAK,UAAU,EACnD;IACAF,kBAAkB,GAAGD,iBAAiB;EACxC;AACF;AAEA,IAAI,CAACC,kBAAkB,EAAE;EACvBG,OAAO,CAACC,IAAI,CACV,6DAA6DR,QAAQ,CAACK,EAAE,gCAC1E,CAAC;AACH;AAEA,MAAMI,YAAY,GAAG,IAAIX,kBAAkB,CAACM,kBAAkB,CAAC;AAE/D,OAAO,SAASM,uBAAuBA,CACrCC,QAAkD,EAClD;EACA,OAAOF,YAAY,CAACH,WAAW,CAAC,wBAAwB,EAAEK,QAAQ,CAAC;AACrE;AAEA,OAAO,SAASC,8BAA8BA,CAC5CD,QAA4D,EAC5D;EACA,OAAOF,YAAY,CAACH,WAAW,CAAC,uBAAuB,EAAEK,QAAQ,CAAC;AACpE;AAEA,OAAO,SAASE,eAAeA,CAACF,QAA0C,EAAE;EAC1E,OAAOF,YAAY,CAACH,WAAW,CAAC,gBAAgB,EAAEK,QAAQ,CAAC;AAC7D","ignoreList":[]}

package/lib/module/index.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import ComTappSoSdk from './NativeComTappSoSdk';
-import { Platform } from 'react-native';
+import { Platform, NativeModules } from 'react-native';
 import { EventAction } from './Types';
 
 // Helper to handle unsupported platforms
@@ -12,6 +12,15 @@ export function start(config) {
   if (Platform.OS === 'web') {
     unsupportedPlatformMessage('start');
   }
+  // Force-init the event emitter module to prevent race conditions
+  if (Platform.OS === 'ios') {
+    const {
+      TappEventEmitter
+    } = NativeModules;
+    if (TappEventEmitter) {
+      /* no-op access to trigger init */
+    }
+  }
   ComTappSoSdk.start(config.authToken, config.env, config.tappToken);
 }
 export function url(influencer, adGroup, creative, data) {
@@ -53,6 +62,26 @@ export function simulateTestEvent() {
   }
   return ComTappSoSdk.simulateTestEvent();
 }
+
+// DEBUG-only: Simulate a deferred link event for iOS testing
+// Only works in DEBUG builds on iOS
+export function simulateDeferredLink(payload) {
+  if (Platform.OS !== 'ios') {
+    console.log('[simulateDeferredLink] Only supported on iOS');
+    return;
+  }
+  ComTappSoSdk.simulateDeferredLink(payload || {});
+}
+
+// DEBUG-only: Simulate a fail resolving URL event for iOS testing
+// Only works in DEBUG builds on iOS
+export function simulateFailResolving(url, error) {
+  if (Platform.OS !== 'ios') {
+    console.log('[simulateFailResolving] Only supported on iOS');
+    return;
+  }
+  ComTappSoSdk.simulateFailResolving(url, error);
+}
 export * from './Types';
 export * from './events';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ComTappSoSdk","Platform","EventAction","unsupportedPlatformMessage","methodName","console","log","OS","start","config","authToken","env","tappToken","url","influencer","adGroup","creative","data","handleTappEvent","event","value","customValue","eventAction","CUSTOM","undefined","metadata","fetchLinkData","deepLink","shouldProcess","fetchOriginLinkData","simulateTestEvent"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,sBAAsB;AAC/C,SAASC,QAAQ,QAAQ,cAAc;AACvC,SACEC,WAAW,QAIN,SAAS;;AAEhB;AACA,MAAMC,0BAA0B,GAAIC,UAAkB,IAAK;EACzDC,OAAO,CAACC,GAAG,CAAC,IAAIL,QAAQ,CAACM,EAAE,aAAaH,UAAU,qBAAqB,CAAC;AAC1E,CAAC;AAED,OAAO,SAASI,KAAKA,CAACC,MAAkB,EAAQ;EAC9C,IAAIR,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,OAAO,CAAC;EACrC;EACAH,YAAY,CAACQ,KAAK,CAACC,MAAM,CAACC,SAAS,EAAED,MAAM,CAACE,GAAG,EAAEF,MAAM,CAACG,SAAS,CAAC;AACpE;AAEA,OAAO,SAASC,GAAGA,CACjBC,UAAkB,EAClBC,OAAgB,EAChBC,QAAiB,EACjBC,IAAgC,EACf;EACjB,IAAIhB,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,KAAK,CAAC;EACnC;EACA,OAAOH,YAAY,CAACa,GAAG,CAACC,UAAU,EAAEC,OAAO,EAAEC,QAAQ,EAAEC,IAAI,CAAC;AAC9D;AAEA,OAAO,SAASC,eAAeA,CAACC,KAAoB,EAAmB;EACrE,IAAIlB,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,iBAAiB,CAAC;EAC/C;EAEA,MAAMiB,KAAK,GAAGD,KAAK,CAACE,WAAW,IAAI,4BAA4B;EAC/D,MAAMA,WAAW,GACfF,KAAK,CAACG,WAAW,KAAKpB,WAAW,CAACqB,MAAM,GAAGH,KAAK,GAAGI,SAAS;EAE9D,MAAMC,QAAQ,GAAGN,KAAK,CAACM,QAAQ;EAE/B,OAAOzB,YAAY,CAACkB,eAAe,CACjCC,KAAK,CAACG,WAAW,EACjBD,WAAW,EACXI,QACF,CAAC;AACH;AAEA,OAAO,SAASC,aAAaA,CAACC,QAAgB,EAAiC;EAC7E,IAAI1B,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,eAAe,CAAC;EAC7C;EACA,OAAOH,YAAY,CAAC0B,aAAa,CAACC,QAAQ,CAAC;AAC7C;AAEA,OAAO,SAASC,aAAaA,CAACD,QAAgB,EAAoB;EAChE,IAAI1B,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,eAAe,CAAC;EAC7C;EACA,OAAOH,YAAY,CAAC4B,aAAa,CAACD,QAAQ,CAAC;AAC7C;AAEA,OAAO,SAASE,mBAAmBA,CAAA,EAAkC;EACnE,IAAI5B,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IACzBJ,0BAA0B,CAAC,qBAAqB,CAAC;EACnD;EACA,OAAOH,YAAY,CAAC6B,mBAAmB,CAAC,CAAC;AAC3C;AAEA,OAAO,SAASC,iBAAiBA,CAAA,EAAS;EACxC,IAAI7B,QAAQ,CAACM,EAAE,KAAK,KAAK,IAAIN,QAAQ,CAACM,EAAE,KAAK,KAAK,EAAE;IAClDJ,0BAA0B,CAAC,mBAAmB,CAAC;EACjD;EACA,OAAOH,YAAY,CAAC8B,iBAAiB,CAAC,CAAC;AACzC;AAEA,cAAc,SAAS;AACvB,cAAc,UAAU","ignoreList":[]}
+{"version":3,"names":["ComTappSoSdk","Platform","NativeModules","EventAction","unsupportedPlatformMessage","methodName","console","log","OS","start","config","TappEventEmitter","authToken","env","tappToken","url","influencer","adGroup","creative","data","handleTappEvent","event","value","customValue","eventAction","CUSTOM","undefined","metadata","fetchLinkData","deepLink","shouldProcess","fetchOriginLinkData","simulateTestEvent","simulateDeferredLink","payload","simulateFailResolving","error"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/src/NativeComTappSoSdk.d.ts

@@ -31,6 +31,10 @@ export interface Spec extends TurboModule {
         isFirstSession?: boolean;
     }>;
     simulateTestEvent(): void;
+    simulateDeferredLink(payload: UnsafeObject): void;
+    simulateFailResolving(url: string, errorMessage: string): void;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeComTappSoSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeComTappSoSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeComTappSoSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D,GAAG,CACD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACjC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,mBAAmB,IAAI,OAAO,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACjC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC,CAAC;IAEH,iBAAiB,IAAI,IAAI,CAAC;CAC3B;;AAED,wBAAsE"}
+{"version":3,"file":"NativeComTappSoSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeComTappSoSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D,GAAG,CACD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACjC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,mBAAmB,IAAI,OAAO,CAAC;QAC7B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QACjC,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC,CAAC;IAEH,iBAAiB,IAAI,IAAI,CAAC;IAI1B,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAClD,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAED,wBAAsE"}

package/lib/typescript/src/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAKpD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,8CAGnD;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,8CAG7D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,8CAEzE"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA6BpD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,8CAGnD;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,8CAG7D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,8CAEzE"}

package/lib/typescript/src/index.d.ts

@@ -8,6 +8,16 @@ export declare function fetchLinkData(deepLink: string): Promise<TappLinkDataRes
 export declare function shouldProcess(deepLink: string): Promise<boolean>;
 export declare function fetchOriginLinkData(): Promise<TappLinkDataResponse>;
 export declare function simulateTestEvent(): void;
+export declare function simulateDeferredLink(payload?: {
+    tappUrl?: string;
+    attrTappUrl?: string;
+    influencer?: string;
+    data?: {
+        [key: string]: string;
+    };
+    isFirstSession?: boolean;
+}): void;
+export declare function simulateFailResolving(url: string, error: string): void;
 export * from './Types';
 export * from './events';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AAOjB,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAK9C;AAED,wBAAgB,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBrE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAK7E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhE;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAKnE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAC1B,MAAM,SAAS,CAAC;AAOjB,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAY9C;AAED,wBAAgB,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBrE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAK7E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhE;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAKnE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAID,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,IAAI,CAMP;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com-tapp-so-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "react native tapp sdk",
   "sideEffects": false,
   "engines": {
@@ -166,4 +166,4 @@
     "type": "turbo-module",
     "version": "0.54.8"
   }
-}
+}

package/src/NativeComTappSoSdk.ts

@@ -41,6 +41,14 @@ export interface Spec extends TurboModule {
   }>;
 
   simulateTestEvent(): void;
+
+  // DEBUG-only: iOS simulation methods for testing event delivery
+  // Using UnsafeObject to match NSDictionary* in Obj-C TurboModule
+  simulateDeferredLink(payload: UnsafeObject): void;
+  simulateFailResolving(url: string, errorMessage: string): void;
+
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('ComTappSoSdk');

package/src/events.ts

@@ -1,8 +1,32 @@
-import { NativeEventEmitter, NativeModules } from 'react-native';
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 import type { TappLinkDataResponse } from './Types';
 
-const { EventEmitter } = NativeModules;
-const eventEmitter = new NativeEventEmitter(EventEmitter);
+const { TappEventEmitter, ComTappSoSdk } = NativeModules;
+import ComTappSoSdkTurbo from './NativeComTappSoSdk';
+
+let eventEmitterModule: any;
+
+if (Platform.OS === 'ios') {
+  eventEmitterModule = TappEventEmitter;
+} else if (Platform.OS === 'android') {
+  // Policy: Prefer NativeModules.ComTappSoSdk because it is consistently wired
+  if (ComTappSoSdk && typeof ComTappSoSdk.addListener === 'function') {
+    eventEmitterModule = ComTappSoSdk;
+  } else if (
+    ComTappSoSdkTurbo &&
+    typeof ComTappSoSdkTurbo.addListener === 'function'
+  ) {
+    eventEmitterModule = ComTappSoSdkTurbo;
+  }
+}
+
+if (!eventEmitterModule) {
+  console.warn(
+    `[TappSDK] Event emitter module is undefined for platform: ${Platform.OS}. Events will not be received.`
+  );
+}
+
+const eventEmitter = new NativeEventEmitter(eventEmitterModule);
 
 export function addDeferredLinkListener(
   listener: (response: TappLinkDataResponse) => void

package/src/index.tsx

@@ -1,5 +1,5 @@
 import ComTappSoSdk from './NativeComTappSoSdk';
-import { Platform } from 'react-native';
+import { Platform, NativeModules } from 'react-native';
 import {
   EventAction,
   type InitConfig,
@@ -16,6 +16,13 @@ export function start(config: InitConfig): void {
   if (Platform.OS === 'web') {
     unsupportedPlatformMessage('start');
   }
+  // Force-init the event emitter module to prevent race conditions
+  if (Platform.OS === 'ios') {
+    const { TappEventEmitter } = NativeModules;
+    if (TappEventEmitter) {
+      /* no-op access to trigger init */
+    }
+  }
   ComTappSoSdk.start(config.authToken, config.env, config.tappToken);
 }
 
@@ -77,5 +84,31 @@ export function simulateTestEvent(): void {
   return ComTappSoSdk.simulateTestEvent();
 }
 
+// DEBUG-only: Simulate a deferred link event for iOS testing
+// Only works in DEBUG builds on iOS
+export function simulateDeferredLink(payload?: {
+  tappUrl?: string;
+  attrTappUrl?: string;
+  influencer?: string;
+  data?: { [key: string]: string };
+  isFirstSession?: boolean;
+}): void {
+  if (Platform.OS !== 'ios') {
+    console.log('[simulateDeferredLink] Only supported on iOS');
+    return;
+  }
+  ComTappSoSdk.simulateDeferredLink(payload || {});
+}
+
+// DEBUG-only: Simulate a fail resolving URL event for iOS testing
+// Only works in DEBUG builds on iOS
+export function simulateFailResolving(url: string, error: string): void {
+  if (Platform.OS !== 'ios') {
+    console.log('[simulateFailResolving] Only supported on iOS');
+    return;
+  }
+  ComTappSoSdk.simulateFailResolving(url, error);
+}
+
 export * from './Types';
 export * from './events';