@mixpanel/react-native-session-replay 0.1.3 → 0.3.0

package/MixpanelReactNativeSessionReplay.podspec

@@ -15,7 +15,7 @@ Pod::Spec.new do |s|
 
   s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
   s.private_header_files = "ios/**/*.h"
-  s.dependency 'MixpanelSessionReplay', '1.1.5'
+  s.dependency 'MixpanelSessionReplay', '1.1.6'
 # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
 # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
 if respond_to?(:install_modules_dependencies, true)

package/README.md

@@ -9,7 +9,7 @@ Official React Native turbo module for Mixpanel Session Replay. Capture and anal
 - ⚡ **High Performance** - Native implementation with minimal JavaScript overhead
 - 🎯 **Selective Recording** - Configurable sampling rates and recording controls
 - 📱 **Cross Platform** - Unified API for both iOS and Android
-- 🚀 **New Architecture Ready** - Built as a Turbo Module for React Native's new architecture
+- 🏗️ **Dual Architecture Support** - Works with both old (Bridge) and new (Turbo Module) React Native architectures
 
 ## Installation
 
@@ -41,10 +41,7 @@ Dependencies are automatically added through Gradle. Requirements:
 
 ```typescript
 import {
-  initialize,
-  startRecording,
-  stopRecording,
-  isRecording,
+  MPSessionReplay,
   MPSessionReplayConfig,
   MPSessionReplayMask,
 } from '@mixpanel/react-native-session-replay';
@@ -59,16 +56,16 @@ const config = new MPSessionReplayConfig({
   enableLogging: true,
 });
 
-await initialize(token, distinctId, config).catch((error) => {
+await MPSessionReplay.initialize(token, distinctId, config).catch((error) => {
   console.error('Initialization error:', error);
 });
 
 // Control recording
-await startRecording();
-await stopRecording();
+await MPSessionReplay.startRecording();
+await MPSessionReplay.stopRecording();
 
 // Check recording status
-const recording = await isRecording();
+const recording = await MPSessionReplay.isRecording();
 ```
 
 ## Configuration
@@ -133,39 +130,75 @@ Enables debug logging for development and troubleshooting.
 
 ## API Methods
 
-### initialize(token: string, distinctId: string, config: MPSessionReplayConfig): Promise<void>
+### MPSessionReplay.initialize(token: string, distinctId: string, config: MPSessionReplayConfig): Promise<void>
 Initializes the session replay system with your configuration. Checks remote settings to confirm recording is enabled, then creates a new session replay instance. Any existing instance is deinitialized first.
 
 **Returns:** Promise that resolves when initialization completes successfully.
 
 **Throws:** Error if initialization fails.
 
-### startRecording(): Promise<void>
+### MPSessionReplay.startRecording(): Promise<void>
 Manually starts session recording. Has no effect if recording is already active.
 
 Recording continues until you stop it manually or the app moves to the background.
 
-### stopRecording(): Promise<void>
+### MPSessionReplay.stopRecording(): Promise<void>
 Stops the current recording session and performs cleanup.
 
-### isRecording(): Promise<boolean>
+### MPSessionReplay.isRecording(): Promise<boolean>
 Returns whether recording is currently active.
 
-### identify(distinctId: string): Promise<void>
+### MPSessionReplay.identify(distinctId: string): Promise<void>
 Updates the distinct ID for session replays after initialization.
 
 **Best practice:** Call `identify()` on the main Mixpanel SDK first, then call it on the Session Replay SDK. This ensures users are properly merged.
 
-## Privacy & Security
-
+## Privacy & Data Masking
 The SDK automatically masks sensitive information to protect user privacy. Text input fields are always masked and cannot be disabled.
 
-Additional configurable masking options:
+Session Replay provides two approaches to protect sensitive data: automatic masking and manual masking.
+
+### Automatic Masking
+Configure which view types are automatically masked during initialization:
 - Images
 - Text elements
 - WebView content
 - Apple Maps (iOS only)
 
+```tsx
+import { MPSessionReplayConfig } from '@mixpanel/react-native-session-replay';
+
+const config = new MPSessionReplayConfig({
+  autoMaskedViews: [
+    MPSessionReplayMask.Text,   // Masks all text
+    MPSessionReplayMask.Image,  // Masks all images
+    MPSessionReplayMask.Web,    // Masks all WebViews
+    MPSessionReplayMask.Map,    // Masks map views (iOS only)
+  ],
+});
+```
+
+**Default Behavior:** All view types are masked by default for maximum privacy.
+
+### Manual Masking with MPSessionReplayView
+
+Use the `MPSessionReplayView` wrapper component for granular control over what gets masked:
+
+```tsx
+import { MPSessionReplayView } from '@mixpanel/react-native-session-replay';
+
+// Mask sensitive content
+<MPSessionReplayView sensitive={true}>
+  <Text>Credit card Number: {ccn}</Text>
+  <Text>Social Security Number: {ssn}</Text>
+</MPSessionReplayView>
+
+// Explicitly mark content as safe (unmasked)
+<MPSessionReplayView sensitive={false}>
+  <Text>Public information that should always be visible</Text>
+</MPSessionReplayView>
+```
+
 ## Example App
 
 Test the integration using the example app:
@@ -189,7 +222,14 @@ yarn example android
 - React Native 0.70 or higher
 - iOS 13.0 or higher
 - Android API Level 21 or higher
-- New Architecture support
+
+## Architecture Support
+
+This module supports both the old and new React Native architectures:
+- ✅ **Old Architecture (Bridge)** - Full support for traditional React Native apps
+- ✅ **New Architecture (Turbo Module)** - Optimized for React Native's new architecture
+
+The module automatically detects and uses the appropriate architecture at runtime, providing seamless compatibility regardless of your app's configuration.
 
 ## Contributing
 
@@ -198,3 +238,5 @@ See our [contributing guide](CONTRIBUTING.md) to learn how to contribute and und
 ## License
 
 MIT
+
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/mixpanel/mixpanel-react-native-session-replay)

package/android/build.gradle

@@ -79,7 +79,7 @@ dependencies {
   implementation "com.mixpanel.android:mixpanel-android:8.0.2"
   
   // Mixpanel Android Session Replay SDK dependency
-  implementation "com.mixpanel.android:mixpanel-android-session-replay:1.0.3"
+  implementation "com.mixpanel.android:mixpanel-android-session-replay:1.0.4"
 }
 
 react {

package/android/src/main/java/com/mixpanelreactnativesessionreplay/MixpanelReactNativeSessionReplayModule.kt

@@ -2,6 +2,7 @@ package com.mixpanelreactnativesessionreplay
 
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.module.annotations.ReactModule
 import com.mixpanel.android.sessionreplay.MPSessionReplay
 import com.mixpanel.android.sessionreplay.MPSessionReplayInstance
@@ -20,6 +21,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     return NAME
   }
 
+  @ReactMethod
   override fun initialize(token: String, distinctId: String, configJSON: String, promise: Promise) {
     try {
       if (token.isEmpty() || distinctId.isEmpty()) {
@@ -108,6 +110,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     }
   }
 
+  @ReactMethod
   override fun startRecording(recordingSessionsPercent: Double, promise: Promise) {
     try {
       MPSessionReplay.getInstance()?.startRecording(sessionsPercent = recordingSessionsPercent)
@@ -117,6 +120,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     }
   }
 
+  @ReactMethod
   override fun stopRecording(promise: Promise) {
     try {
       MPSessionReplay.getInstance()?.stopRecording()
@@ -126,6 +130,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     }
   }
 
+  @ReactMethod
   override fun isRecording(promise: Promise) {
     try {
       val recording = MPSessionReplay.getInstance()?.isRecording() ?: false
@@ -135,6 +140,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     }
   }
 
+  @ReactMethod
   override fun identify(distinctId: String, promise: Promise) {
     try {
       if (distinctId.isEmpty()) {
@@ -149,6 +155,15 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
     }
   }
 
+  @ReactMethod
+  override fun getReplayId(promise: Promise) {
+    try {
+      val replayId = MPSessionReplay.getInstance()?.getReplayId()
+      promise.resolve(replayId)
+    } catch (e: Exception) {
+      promise.reject("GET_REPLAY_ID_ERROR", e.message, e)
+    }
+  }
 
   /**
    * Safely configure sensitive classes for comprehensive React Native view masking
@@ -281,7 +296,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
 
   companion object {
     const val NAME = "MixpanelReactNativeSessionReplay"
-    const val LIB_VERSION = "0.1.3"
+    const val LIB_VERSION = "0.2.1"
     const val MP_LIB = "react-native-sr"
   }
 }

package/ios/MixpanelReactNativeSessionReplay.h

@@ -1,5 +1,13 @@
+#ifdef RCT_NEW_ARCH_ENABLED
 #import <MixpanelReactNativeSessionReplaySpec/MixpanelReactNativeSessionReplaySpec.h>
+#else
+#import <React/RCTBridgeModule.h>
+#endif
 
+#ifdef RCT_NEW_ARCH_ENABLED
 @interface MixpanelReactNativeSessionReplay : NSObject <NativeMixpanelReactNativeSessionReplaySpec>
+#else
+@interface MixpanelReactNativeSessionReplay : NSObject <RCTBridgeModule>
+#endif
 
 @end

package/ios/MixpanelReactNativeSessionReplay.mm

@@ -8,7 +8,8 @@
 @implementation MixpanelReactNativeSessionReplay
 RCT_EXPORT_MODULE()
 
-- (void)initialize:(nonnull NSString *)token distinctId:(nonnull NSString *)distinctId configJSON:(nonnull NSString *)configJSON resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
+RCT_EXPORT_METHOD(initialize:(nonnull NSString *)token distinctId:(nonnull NSString *)distinctId configJSON:(nonnull NSString *)configJSON resolve:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject)
+{
     @try {
         if (!token || !distinctId) {
             reject(@"INVALID_CONFIG", @"Token and distinctId are required", nil);
@@ -27,9 +28,10 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)startRecording:(double)recordingSessionsPercent
+RCT_EXPORT_METHOD(startRecording:(double)recordingSessionsPercent
                resolve:(RCTPromiseResolveBlock)resolve
-                reject:(RCTPromiseRejectBlock)reject {
+                reject:(RCTPromiseRejectBlock)reject)
+{
     @try {
       [MixpanelSwiftSessionReplay startRecordingWithRecordingSessionsPercent:recordingSessionsPercent];
         resolve(nil);
@@ -39,8 +41,9 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)stopRecording:(RCTPromiseResolveBlock)resolve
-               reject:(RCTPromiseRejectBlock)reject {
+RCT_EXPORT_METHOD(stopRecording:(RCTPromiseResolveBlock)resolve
+               reject:(RCTPromiseRejectBlock)reject)
+{
     @try {
         [MixpanelSwiftSessionReplay stopRecording];
         resolve(nil);
@@ -50,8 +53,9 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)isRecording:(RCTPromiseResolveBlock)resolve
-             reject:(RCTPromiseRejectBlock)reject {
+RCT_EXPORT_METHOD(isRecording:(RCTPromiseResolveBlock)resolve
+             reject:(RCTPromiseRejectBlock)reject)
+{
     @try {
         BOOL recording = [MixpanelSwiftSessionReplay isRecording];
         resolve(@(recording));
@@ -61,15 +65,16 @@ RCT_EXPORT_MODULE()
     }
 }
 
-- (void)identify:(NSString *)distinctId
+RCT_EXPORT_METHOD(identify:(NSString *)distinctId
          resolve:(RCTPromiseResolveBlock)resolve
-          reject:(RCTPromiseRejectBlock)reject {
+          reject:(RCTPromiseRejectBlock)reject)
+{
     @try {
         if (!distinctId || [distinctId isEqualToString: @""]) {
             reject(@"INVALID_DISTINCT_ID", @"distinctId is required", nil);
             return;
         }
-        
+
         [MixpanelSwiftSessionReplay identify:distinctId];
         resolve(nil);
     }
@@ -78,10 +83,24 @@ RCT_EXPORT_MODULE()
     }
 }
 
+RCT_EXPORT_METHOD(getReplayId:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject)
+{
+    @try {
+        NSString *replayId = [MixpanelSwiftSessionReplay getReplayId];
+        resolve(replayId);
+    }
+    @catch (NSException *exception) {
+        reject(@"GET_REPLAY_ID_ERROR", exception.reason, nil);
+    }
+}
+
+#ifdef RCT_NEW_ARCH_ENABLED
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params
 {
     return std::make_shared<facebook::react::NativeMixpanelReactNativeSessionReplaySpecJSI>(params);
 }
+#endif
 
 @end

package/ios/MixpanelSwiftSessionReplay.swift

@@ -1,9 +1,9 @@
 import Foundation
-import UIKit
 import MixpanelSessionReplay
+import UIKit
 
 @objc public class MixpanelSwiftSessionReplay: NSObject {
-  static let libVersion = "0.1.3"
+  static let libVersion = "0.2.1"
   static let mpLib = "react-native-sr"
 
   @objc public static func startRecording(recordingSessionsPercent: Double = 100.0) {
@@ -18,13 +18,16 @@ import MixpanelSessionReplay
     MPSessionReplay.getInstance()?.captureScreenshot()
   }
 
-  @objc public static func initialize(_ token: String, distinctId: String, configJSON: String, completion: @escaping (Bool, NSError?) -> Void) {
+  @objc public static func initialize(
+    _ token: String, distinctId: String, configJSON: String,
+    completion: @escaping (Bool, NSError?) -> Void
+  ) {
     guard let data = configJSON.data(using: .utf8) else {
-      let error =  createError("Invalid config JSON string", code: 3840)
+      let error = createError("Invalid config JSON string", code: 3840)
       completion(false, error)
       return
     }
-    
+
     do {
       APIConstants.setLibVersion(libVersion)
       APIConstants.setMpLib(mpLib)
@@ -34,17 +37,22 @@ import MixpanelSessionReplay
         case .success(_?):
           setSensitiveClasses(config: config)
           completion(true, nil)
-          
+
         case .success(nil):
           completion(false, createError("Instance found nil after successful initialisation."))
-          
+
         case .failure(let error as MPSessionReplayError):
-          let message = switch error {
-          case .disabledByRemoteSetting(let message): message
-          case .failedToInitialize: "Failed to initialize the SDK: \(error)"
+          let message: String
+          switch error {
+          case .disabledByRemoteSetting(let msg):
+            message = msg
+          case .failedToInitialize:
+            message = "Failed to initialize the SDK: \(error)"
+          default:
+            message = "Session replay initialization failed: \(error)"
           }
           completion(false, createError(message))
-          
+
         case .failure(let error):
           completion(false, createError("Session replay initialization failed: \(error)"))
         }
@@ -53,25 +61,30 @@ import MixpanelSessionReplay
       completion(false, error as NSError)
     }
   }
-  
+
   @objc public static func isRecording() -> Bool {
     return MPSessionReplay.getInstance()?.isRecording ?? false
   }
-  
+
   @objc public static func identify(_ distinctId: String) {
     MPSessionReplay.getInstance()?.identify(distinctId: distinctId)
   }
-  
+
+  @objc public static func getReplayId() -> String? {
+    return MPSessionReplay.getReplayId()
+  }
+
   @objc public static func setMPReplaySensitive(value: Bool, view: UIView) {
     view.mpReplaySensitive = value
   }
-  
+
   private static func createError(_ message: String, code: Int = -1) -> NSError {
-    return NSError(domain: "MixpanelSessionReplay",
-                   code: code,
-                   userInfo: [NSLocalizedDescriptionKey: message])
+    return NSError(
+      domain: "MixpanelSessionReplay",
+      code: code,
+      userInfo: [NSLocalizedDescriptionKey: message])
   }
-  
+
   private static func setSensitiveClasses(config: MPSessionReplayConfig) {
     let legacyTextViewClass: AnyClass? = NSClassFromString("RCTTextView")
     let fabricTextViewClass: AnyClass? = NSClassFromString("RCTParagraphTextView")
@@ -81,11 +94,11 @@ import MixpanelSessionReplay
     if let imageViewClass, config.autoMaskedViews.contains(.image) {
       sessionReplay?.addSensitiveClass(imageViewClass)
     }
-    
+
     if let fabricTextViewClass, config.autoMaskedViews.contains(.text) {
       sessionReplay?.addSensitiveClass(fabricTextViewClass)
     }
-    
+
     if let legacyTextViewClass, config.autoMaskedViews.contains(.text) {
       sessionReplay?.addSensitiveClass(legacyTextViewClass)
     }

package/lib/module/MixpanelSessionReplayView.js

@@ -1,5 +1,5 @@
 "use strict";
 
 import { requireNativeComponent } from 'react-native';
-export const MixpanelSessionReplayView = requireNativeComponent('MixpanelSessionReplayView');
+export const MPSessionReplayView = requireNativeComponent('MixpanelSessionReplayView');
 //# sourceMappingURL=MixpanelSessionReplayView.js.map

package/lib/module/MixpanelSessionReplayView.js.map

@@ -1 +1 @@
-{"version":3,"names":["requireNativeComponent","MixpanelSessionReplayView"],"sourceRoot":"../../src","sources":["MixpanelSessionReplayView.tsx"],"mappings":";;AAAA,SAASA,sBAAsB,QAAwB,cAAc;AAMrE,OAAO,MAAMC,yBAAyB,GACpCD,sBAAsB,CACpB,2BACF,CAAC","ignoreList":[]}
+{"version":3,"names":["requireNativeComponent","MPSessionReplayView"],"sourceRoot":"../../src","sources":["MixpanelSessionReplayView.tsx"],"mappings":";;AAAA,SAASA,sBAAsB,QAAwB,cAAc;AAMrE,OAAO,MAAMC,mBAAmB,GAC9BD,sBAAsB,CACpB,2BACF,CAAC","ignoreList":[]}

package/lib/module/NativeMixpanelReactNativeSessionReplay.js

@@ -1,5 +1,32 @@
 "use strict";
 
-import { TurboModuleRegistry } from 'react-native';
-export default TurboModuleRegistry.getEnforcing('MixpanelReactNativeSessionReplay');
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+// Type declaration for global to include __turboModuleProxy
+
+// Support both old and new architectures
+// Try to use TurboModule (new architecture) first, fallback to NativeModules (old architecture)
+const isTurboModuleEnabled = global.__turboModuleProxy != null;
+let MixpanelReactNativeSessionReplay = null;
+if (isTurboModuleEnabled) {
+  // New architecture with TurboModule
+  try {
+    MixpanelReactNativeSessionReplay = TurboModuleRegistry.get('MixpanelReactNativeSessionReplay');
+  } catch (e) {
+    // TurboModule not available, will fall back to NativeModules
+    console.warn('MixpanelReactNativeSessionReplay: TurboModule not available, falling back to NativeModules');
+  }
+}
+
+// Fallback to NativeModules for old architecture or if TurboModule fails
+if (!MixpanelReactNativeSessionReplay) {
+  MixpanelReactNativeSessionReplay = NativeModules.MixpanelReactNativeSessionReplay;
+}
+
+// If still not available, provide helpful error message
+if (!MixpanelReactNativeSessionReplay) {
+  const errorMessage = `The package '@mixpanel/react-native-session-replay' doesn't seem to be linked. Make sure:\n\n` + "- You have installed the package using 'yarn add @mixpanel/react-native-session-replay' or 'npm install @mixpanel/react-native-session-replay'.\n" + '- You have rebuilt the app after installing the package.\n' + "- For iOS: You have run 'pod install' in the 'ios' directory and opened the .xcworkspace file in Xcode.\n" + '- For Android: You have synced your project with Gradle files and rebuilt the app.\n' + '- If you are using Expo, this package is not compatible with Expo Go.\n';
+  throw new Error(errorMessage);
+}
+export default MixpanelReactNativeSessionReplay;
 //# sourceMappingURL=NativeMixpanelReactNativeSessionReplay.js.map

package/lib/module/NativeMixpanelReactNativeSessionReplay.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeMixpanelReactNativeSessionReplay.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAelD,eAAeA,mBAAmB,CAACC,YAAY,CAC7C,kCACF,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","TurboModuleRegistry","isTurboModuleEnabled","global","__turboModuleProxy","MixpanelReactNativeSessionReplay","get","e","console","warn","errorMessage","Error"],"sourceRoot":"../../src","sources":["NativeMixpanelReactNativeSessionReplay.ts"],"mappings":";;AACA,SAASA,aAAa,EAAEC,mBAAmB,QAAQ,cAAc;;AAgBjE;;AAKA;AACA;AACA,MAAMC,oBAAoB,GAAGC,MAAM,CAACC,kBAAkB,IAAI,IAAI;AAE9D,IAAIC,gCAA6C,GAAG,IAAI;AAExD,IAAIH,oBAAoB,EAAE;EACxB;EACA,IAAI;IACFG,gCAAgC,GAAGJ,mBAAmB,CAACK,GAAG,CACxD,kCACF,CAAC;EACH,CAAC,CAAC,OAAOC,CAAC,EAAE;IACV;IACAC,OAAO,CAACC,IAAI,CACV,4FACF,CAAC;EACH;AACF;;AAEA;AACA,IAAI,CAACJ,gCAAgC,EAAE;EACrCA,gCAAgC,GAC9BL,aAAa,CAACK,gCAAgC;AAClD;;AAEA;AACA,IAAI,CAACA,gCAAgC,EAAE;EACrC,MAAMK,YAAY,GAChB,+FAA+F,GAC/F,mJAAmJ,GACnJ,4DAA4D,GAC5D,2GAA2G,GAC3G,sFAAsF,GACtF,yEAAyE;EAE3E,MAAM,IAAIC,KAAK,CAACD,YAAY,CAAC;AAC/B;AAEA,eAAeL,gCAAgC","ignoreList":[]}

package/lib/module/index.js

@@ -109,7 +109,6 @@ export class MPSessionReplayConfig {
     }
   }
 }
-export { MixpanelSessionReplayView } from "./MixpanelSessionReplayView.js";
 
 /**
  * Initializes the Mixpanel Session Replay system with the provided configuration.
@@ -123,7 +122,7 @@ export { MixpanelSessionReplayView } from "./MixpanelSessionReplayView.js";
  * @throws An error if the token or distinctId is missing or invalid, or if the configuration is invalid,
  *   or if the initialization fails.
  */
-export async function initialize(token, distinctId, config) {
+async function initialize(token, distinctId, config) {
   if (!token || typeof token !== 'string') {
     throw new Error('Mixpanel token is required and must be a string');
   }
@@ -147,7 +146,7 @@ export async function initialize(token, distinctId, config) {
  *   This controls sampling of sessions. The `recordingSessionsPercent` value from the config is ignored when calling this method.
  * @default 100 (record all sessions)
  */
-export async function startRecording(recordingSessionsPercent = 100) {
+async function startRecording(recordingSessionsPercent = 100) {
   return MixpanelReactNativeSessionReplay.startRecording(recordingSessionsPercent);
 }
 
@@ -156,7 +155,7 @@ export async function startRecording(recordingSessionsPercent = 100) {
  *
  * This method stops recording, clears relevant session state, and uploads pending events.
  */
-export async function stopRecording() {
+async function stopRecording() {
   return MixpanelReactNativeSessionReplay.stopRecording();
 }
 
@@ -165,7 +164,7 @@ export async function stopRecording() {
  *
  * @returns A promise that resolves to `true` if recording is active, `false` otherwise.
  */
-export async function isRecording() {
+async function isRecording() {
   return MixpanelReactNativeSessionReplay.isRecording();
 }
 
@@ -179,10 +178,31 @@ export async function isRecording() {
  * @param distinctId - The distinct ID of the user.
  * @throws An error if the distinctId is missing or invalid.
  */
-export async function identify(distinctId) {
+async function identify(distinctId) {
   if (!distinctId || typeof distinctId !== 'string') {
     throw new Error('distinctId is required and must be a string');
   }
   return MixpanelReactNativeSessionReplay.identify(distinctId);
 }
+
+/**
+ * Gets the current replay ID.
+ *
+ * Returns the unique identifier for the current replay session, or null if no replay is active.
+ * This ID can be used to correlate session replays with other analytics data.
+ *
+ * @returns A promise that resolves to the replay ID string or null if no replay is active.
+ */
+async function getReplayId() {
+  return MixpanelReactNativeSessionReplay.getReplayId();
+}
+export { MPSessionReplayView } from "./MixpanelSessionReplayView.js";
+export const MPSessionReplay = {
+  initialize,
+  startRecording,
+  stopRecording,
+  isRecording,
+  identify,
+  getReplayId
+};
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","MixpanelReactNativeSessionReplay","MPSessionReplayMask","MPSessionReplayConfig","constructor","wifiOnly","autoStartRecording","recordingSessionsPercent","autoMaskedViews","Image","Text","Web","Map","flushInterval","enableLogging","transformMaskValueForPlatform","value","OS","charAt","toUpperCase","slice","toJSON","transformedAutoMaskedViews","filter","mask","map","config","JSON","stringify","MixpanelSessionReplayView","initialize","token","distinctId","Error","undefined","json","startRecording","stopRecording","isRecording","identify"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,gCAAgC,MAAM,6CAA0C;AAEvF,WAAYC,mBAAmB,0BAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAnBA,mBAAmB;EAAA,OAAnBA,mBAAmB;AAAA;AAO/B,OAAO,MAAMC,qBAAqB,CAAC;EACjC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;;EAGE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;EAGE;AACF;AACA;AACA;AACA;AACA;;EAGE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;EAGE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;EAGE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;;EAGEC,WAAWA,CAAC;IACVC,QAAQ,GAAG,IAAI;IACfC,kBAAkB,GAAG,IAAI;IACzBC,wBAAwB,GAAG,GAAG;IAC9BC,eAAe,GAAG,CAChBN,mBAAmB,CAACO,KAAK,EACzBP,mBAAmB,CAACQ,IAAI,EACxBR,mBAAmB,CAACS,GAAG,EACvBT,mBAAmB,CAACU,GAAG,CACxB;IACDC,aAAa,GAAG,EAAE;IAClBC,aAAa,GAAG;EACc,CAAC,GAAG,CAAC,CAAC,EAAE;IACtC,IAAI,CAACT,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACC,kBAAkB,GAAGA,kBAAkB;IAC5C,IAAI,CAACC,wBAAwB,GAAGA,wBAAwB;IACxD,IAAI,CAACC,eAAe,GAAGA,eAAe;IACtC,IAAI,CAACK,aAAa,GAAGA,aAAa;IAClC,IAAI,CAACC,aAAa,GAAGA,aAAa;EACpC;EAEQC,6BAA6BA,CAACC,KAAa,EAAU;IAC3D,IAAIhB,QAAQ,CAACiB,EAAE,KAAK,SAAS,EAAE;MAC7B;MACA,OAAOD,KAAK,CAACE,MAAM,CAAC,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,GAAGH,KAAK,CAACI,KAAK,CAAC,CAAC,CAAC;IACvD;IACA;IACA,OAAOJ,KAAK;EACd;EAEAK,MAAMA,CAAA,EAAW;IACf;IACA,MAAMC,0BAA0B,GAAG,IAAI,CAACd,eAAe,CACpDe,MAAM,CACJC,IAAI,IACH,EAAExB,QAAQ,CAACiB,EAAE,KAAK,SAAS,IAAIO,IAAI,KAAKtB,mBAAmB,CAACU,GAAG,CACnE,CAAC,CACAa,GAAG,CAAED,IAAI,IAAK,IAAI,CAACT,6BAA6B,CAACS,IAAI,CAAC,CAAC;IAE1D,MAAME,MAAM,GAAG;MACbrB,QAAQ,EAAE,IAAI,CAACA,QAAQ;MACvBE,wBAAwB,EAAE,IAAI,CAACA,wBAAwB;MACvDC,eAAe,EAAEc,0BAA0B;MAC3ChB,kBAAkB,EAAE,IAAI,CAACA,kBAAkB;MAC3CO,aAAa,EAAE,IAAI,CAACA,aAAa;MACjCC,aAAa,EAAE,IAAI,CAACA;IACtB,CAAC;IAED,IAAId,QAAQ,CAACiB,EAAE,KAAK,KAAK,IAAIjB,QAAQ,CAACiB,EAAE,KAAK,SAAS,EAAE;MACtD;MACA,OAAOU,IAAI,CAACC,SAAS,CAACF,MAAM,CAAC;IAC/B,CAAC,MAAM;MACL,OAAO,EAAE;IACX;EACF;AACF;AAEA,SAASG,yBAAyB,QAAQ,gCAA6B;;AAEvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,UAAUA,CAC9BC,KAAa,EACbC,UAAkB,EAClBN,MAA6B,EACd;EACf,IAAI,CAACK,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IACvC,MAAM,IAAIE,KAAK,CAAC,iDAAiD,CAAC;EACpE;EACA,IAAI,CAACD,UAAU,IAAI,OAAOA,UAAU,KAAK,QAAQ,EAAE;IACjD,MAAM,IAAIC,KAAK,CAAC,6CAA6C,CAAC;EAChE;EACA,IACEP,MAAM,CAACnB,wBAAwB,KAAK2B,SAAS,KAC5CR,MAAM,CAACnB,wBAAwB,GAAG,CAAC,IAClCmB,MAAM,CAACnB,wBAAwB,GAAG,GAAG,CAAC,EACxC;IACA,MAAM,IAAI0B,KAAK,CAAC,oDAAoD,CAAC;EACvE;EACA,MAAME,IAAI,GAAGT,MAAM,CAACL,MAAM,CAAC,CAAC;EAC5B,OAAOpB,gCAAgC,CAAC6B,UAAU,CAACC,KAAK,EAAEC,UAAU,EAAEG,IAAI,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,cAAcA,CAClC7B,wBAAgC,GAAG,GAAG,EACvB;EACf,OAAON,gCAAgC,CAACmC,cAAc,CACpD7B,wBACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAe8B,aAAaA,CAAA,EAAkB;EACnD,OAAOpC,gCAAgC,CAACoC,aAAa,CAAC,CAAC;AACzD;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,WAAWA,CAAA,EAAqB;EACpD,OAAOrC,gCAAgC,CAACqC,WAAW,CAAC,CAAC;AACvD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,QAAQA,CAACP,UAAkB,EAAiB;EAChE,IAAI,CAACA,UAAU,IAAI,OAAOA,UAAU,KAAK,QAAQ,EAAE;IACjD,MAAM,IAAIC,KAAK,CAAC,6CAA6C,CAAC;EAChE;EAEA,OAAOhC,gCAAgC,CAACsC,QAAQ,CAACP,UAAU,CAAC;AAC9D","ignoreList":[]}
+{"version":3,"names":["Platform","MixpanelReactNativeSessionReplay","MPSessionReplayMask","MPSessionReplayConfig","constructor","wifiOnly","autoStartRecording","recordingSessionsPercent","autoMaskedViews","Image","Text","Web","Map","flushInterval","enableLogging","transformMaskValueForPlatform","value","OS","charAt","toUpperCase","slice","toJSON","transformedAutoMaskedViews","filter","mask","map","config","JSON","stringify","initialize","token","distinctId","Error","undefined","json","startRecording","stopRecording","isRecording","identify","getReplayId","MPSessionReplayView","MPSessionReplay"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -2,6 +2,6 @@ import { type ViewProps } from 'react-native';
 interface MixpanelSessionReplayViewProps extends ViewProps {
     sensitive?: boolean;
 }
-export declare const MixpanelSessionReplayView: import("react-native").HostComponent<MixpanelSessionReplayViewProps>;
+export declare const MPSessionReplayView: import("react-native").HostComponent<MixpanelSessionReplayViewProps>;
 export {};
 //# sourceMappingURL=MixpanelSessionReplayView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MixpanelSessionReplayView.d.ts","sourceRoot":"","sources":["../../../src/MixpanelSessionReplayView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtE,UAAU,8BAA+B,SAAQ,SAAS;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB,sEAGnC,CAAC"}
+{"version":3,"file":"MixpanelSessionReplayView.d.ts","sourceRoot":"","sources":["../../../src/MixpanelSessionReplayView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtE,UAAU,8BAA+B,SAAQ,SAAS;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,sEAG7B,CAAC"}

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

@@ -5,6 +5,10 @@ export interface Spec extends TurboModule {
     stopRecording(): Promise<void>;
     isRecording(): Promise<boolean>;
     identify(distinctId: string): Promise<void>;
+    getReplayId(): Promise<string | null>;
+}
+declare global {
+    var __turboModuleProxy: unknown | undefined;
 }
 declare const _default: Spec;
 export default _default;

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

@@ -1 +1 @@
-{"version":3,"file":"NativeMixpanelReactNativeSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/NativeMixpanelReactNativeSessionReplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,CACR,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;;AAED,wBAEE"}
+{"version":3,"file":"NativeMixpanelReactNativeSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/NativeMixpanelReactNativeSessionReplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,CACR,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,wBAAwB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvC;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7C;wBAyCkD,IAAI;AAAvD,wBAAwD"}

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

@@ -66,7 +66,6 @@ export declare class MPSessionReplayConfig {
     private transformMaskValueForPlatform;
     toJSON(): string;
 }
-export { MixpanelSessionReplayView } from './MixpanelSessionReplayView';
 /**
  * Initializes the Mixpanel Session Replay system with the provided configuration.
  *
@@ -79,7 +78,7 @@ export { MixpanelSessionReplayView } from './MixpanelSessionReplayView';
  * @throws An error if the token or distinctId is missing or invalid, or if the configuration is invalid,
  *   or if the initialization fails.
  */
-export declare function initialize(token: string, distinctId: string, config: MPSessionReplayConfig): Promise<void>;
+declare function initialize(token: string, distinctId: string, config: MPSessionReplayConfig): Promise<void>;
 /**
  * Manually starts session replay recording.
  *
@@ -90,19 +89,19 @@ export declare function initialize(token: string, distinctId: string, config: MP
  *   This controls sampling of sessions. The `recordingSessionsPercent` value from the config is ignored when calling this method.
  * @default 100 (record all sessions)
  */
-export declare function startRecording(recordingSessionsPercent?: number): Promise<void>;
+declare function startRecording(recordingSessionsPercent?: number): Promise<void>;
 /**
  * Stops the session recording and performs cleanup tasks.
  *
  * This method stops recording, clears relevant session state, and uploads pending events.
  */
-export declare function stopRecording(): Promise<void>;
+declare function stopRecording(): Promise<void>;
 /**
  * Tells you if the recording is in-progress.
  *
  * @returns A promise that resolves to `true` if recording is active, `false` otherwise.
  */
-export declare function isRecording(): Promise<boolean>;
+declare function isRecording(): Promise<boolean>;
 /**
  * Sets the distinct ID for session replays.
  *
@@ -113,5 +112,23 @@ export declare function isRecording(): Promise<boolean>;
  * @param distinctId - The distinct ID of the user.
  * @throws An error if the distinctId is missing or invalid.
  */
-export declare function identify(distinctId: string): Promise<void>;
+declare function identify(distinctId: string): Promise<void>;
+/**
+ * Gets the current replay ID.
+ *
+ * Returns the unique identifier for the current replay session, or null if no replay is active.
+ * This ID can be used to correlate session replays with other analytics data.
+ *
+ * @returns A promise that resolves to the replay ID string or null if no replay is active.
+ */
+declare function getReplayId(): Promise<string | null>;
+export { MPSessionReplayView } from './MixpanelSessionReplayView';
+export declare const MPSessionReplay: {
+    initialize: typeof initialize;
+    startRecording: typeof startRecording;
+    stopRecording: typeof stopRecording;
+    isRecording: typeof isRecording;
+    identify: typeof identify;
+    getReplayId: typeof getReplayId;
+};
 //# 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":"AAGA,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;OAUG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,eAAe,EAAE,mBAAmB,EAAE,CAAC;IAEvC;;;;;;;;OAQG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,aAAa,EAAE,OAAO,CAAC;gBAEX,EACV,QAAe,EACf,kBAAyB,EACzB,wBAA8B,EAC9B,eAKC,EACD,aAAkB,EAClB,aAAqB,GACtB,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAStC,OAAO,CAAC,6BAA6B;IASrC,MAAM,IAAI,MAAM;CAyBjB;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,wBAAwB,GAAE,MAAY,GACrC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;OAUG;IACH,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,eAAe,EAAE,mBAAmB,EAAE,CAAC;IAEvC;;;;;;;;OAQG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAE5B;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;;;OAOG;IACH,aAAa,EAAE,OAAO,CAAC;gBAEX,EACV,QAAe,EACf,kBAAyB,EACzB,wBAA8B,EAC9B,eAKC,EACD,aAAkB,EAClB,aAAqB,GACtB,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAStC,OAAO,CAAC,6BAA6B;IASrC,MAAM,IAAI,MAAM;CAyBjB;AAED;;;;;;;;;;;GAWG;AACH,iBAAe,UAAU,CACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,iBAAe,cAAc,CAC3B,wBAAwB,GAAE,MAAY,GACrC,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,iBAAe,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;AAED;;;;GAIG;AACH,iBAAe,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7C;AAED;;;;;;;;;GASG;AACH,iBAAe,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzD;AAED;;;;;;;GAOG;AACH,iBAAe,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEnD;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixpanel/react-native-session-replay",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Official React Native turbo module for Mixpanel Session Replay",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/MixpanelSessionReplayView.tsx

@@ -4,7 +4,7 @@ interface MixpanelSessionReplayViewProps extends ViewProps {
   sensitive?: boolean;
 }
 
-export const MixpanelSessionReplayView =
+export const MPSessionReplayView =
   requireNativeComponent<MixpanelSessionReplayViewProps>(
     'MixpanelSessionReplayView'
   );

package/src/NativeMixpanelReactNativeSessionReplay.ts

@@ -1,5 +1,5 @@
 import type { TurboModule } from 'react-native';
-import { TurboModuleRegistry } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
 
 export interface Spec extends TurboModule {
   initialize(
@@ -12,8 +12,51 @@ export interface Spec extends TurboModule {
   // Functionality not available in Android SDK ATM. It returns true always.
   isRecording(): Promise<boolean>;
   identify(distinctId: string): Promise<void>;
+  getReplayId(): Promise<string | null>;
 }
 
-export default TurboModuleRegistry.getEnforcing<Spec>(
-  'MixpanelReactNativeSessionReplay'
-);
+// Type declaration for global to include __turboModuleProxy
+declare global {
+  var __turboModuleProxy: unknown | undefined;
+}
+
+// Support both old and new architectures
+// Try to use TurboModule (new architecture) first, fallback to NativeModules (old architecture)
+const isTurboModuleEnabled = global.__turboModuleProxy != null;
+
+let MixpanelReactNativeSessionReplay: Spec | null = null;
+
+if (isTurboModuleEnabled) {
+  // New architecture with TurboModule
+  try {
+    MixpanelReactNativeSessionReplay = TurboModuleRegistry.get<Spec>(
+      'MixpanelReactNativeSessionReplay'
+    );
+  } catch (e) {
+    // TurboModule not available, will fall back to NativeModules
+    console.warn(
+      'MixpanelReactNativeSessionReplay: TurboModule not available, falling back to NativeModules'
+    );
+  }
+}
+
+// Fallback to NativeModules for old architecture or if TurboModule fails
+if (!MixpanelReactNativeSessionReplay) {
+  MixpanelReactNativeSessionReplay =
+    NativeModules.MixpanelReactNativeSessionReplay;
+}
+
+// If still not available, provide helpful error message
+if (!MixpanelReactNativeSessionReplay) {
+  const errorMessage =
+    `The package '@mixpanel/react-native-session-replay' doesn't seem to be linked. Make sure:\n\n` +
+    "- You have installed the package using 'yarn add @mixpanel/react-native-session-replay' or 'npm install @mixpanel/react-native-session-replay'.\n" +
+    '- You have rebuilt the app after installing the package.\n' +
+    "- For iOS: You have run 'pod install' in the 'ios' directory and opened the .xcworkspace file in Xcode.\n" +
+    '- For Android: You have synced your project with Gradle files and rebuilt the app.\n' +
+    '- If you are using Expo, this package is not compatible with Expo Go.\n';
+
+  throw new Error(errorMessage);
+}
+
+export default MixpanelReactNativeSessionReplay as Spec;

package/src/index.tsx

@@ -129,8 +129,6 @@ export class MPSessionReplayConfig {
   }
 }
 
-export { MixpanelSessionReplayView } from './MixpanelSessionReplayView';
-
 /**
  * Initializes the Mixpanel Session Replay system with the provided configuration.
  *
@@ -143,7 +141,7 @@ export { MixpanelSessionReplayView } from './MixpanelSessionReplayView';
  * @throws An error if the token or distinctId is missing or invalid, or if the configuration is invalid,
  *   or if the initialization fails.
  */
-export async function initialize(
+async function initialize(
   token: string,
   distinctId: string,
   config: MPSessionReplayConfig
@@ -175,7 +173,7 @@ export async function initialize(
  *   This controls sampling of sessions. The `recordingSessionsPercent` value from the config is ignored when calling this method.
  * @default 100 (record all sessions)
  */
-export async function startRecording(
+async function startRecording(
   recordingSessionsPercent: number = 100
 ): Promise<void> {
   return MixpanelReactNativeSessionReplay.startRecording(
@@ -188,7 +186,7 @@ export async function startRecording(
  *
  * This method stops recording, clears relevant session state, and uploads pending events.
  */
-export async function stopRecording(): Promise<void> {
+async function stopRecording(): Promise<void> {
   return MixpanelReactNativeSessionReplay.stopRecording();
 }
 
@@ -197,7 +195,7 @@ export async function stopRecording(): Promise<void> {
  *
  * @returns A promise that resolves to `true` if recording is active, `false` otherwise.
  */
-export async function isRecording(): Promise<boolean> {
+async function isRecording(): Promise<boolean> {
   return MixpanelReactNativeSessionReplay.isRecording();
 }
 
@@ -211,10 +209,33 @@ export async function isRecording(): Promise<boolean> {
  * @param distinctId - The distinct ID of the user.
  * @throws An error if the distinctId is missing or invalid.
  */
-export async function identify(distinctId: string): Promise<void> {
+async function identify(distinctId: string): Promise<void> {
   if (!distinctId || typeof distinctId !== 'string') {
     throw new Error('distinctId is required and must be a string');
   }
 
   return MixpanelReactNativeSessionReplay.identify(distinctId);
 }
+
+/**
+ * Gets the current replay ID.
+ *
+ * Returns the unique identifier for the current replay session, or null if no replay is active.
+ * This ID can be used to correlate session replays with other analytics data.
+ *
+ * @returns A promise that resolves to the replay ID string or null if no replay is active.
+ */
+async function getReplayId(): Promise<string | null> {
+  return MixpanelReactNativeSessionReplay.getReplayId();
+}
+
+export { MPSessionReplayView } from './MixpanelSessionReplayView';
+
+export const MPSessionReplay = {
+  initialize,
+  startRecording,
+  stopRecording,
+  isRecording,
+  identify,
+  getReplayId,
+};