@mixpanel/react-native-session-replay 1.0.1 → 1.2.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.2.0'
+  s.dependency 'MixpanelSessionReplay', '1.3.2'
 # 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/android/app/build/generated/source/codegen/java/com/facebook/fbreact/specs/NativeMixpanelReactNativeSessionReplaySpec.java

@@ -38,7 +38,7 @@ public abstract class NativeMixpanelReactNativeSessionReplaySpec extends ReactCo
 
   @ReactMethod
   @DoNotStrip
-  public abstract void startRecording(Promise promise);
+  public abstract void startRecording(double recordingSessionsPercent, Promise promise);
 
   @ReactMethod
   @DoNotStrip
@@ -51,4 +51,12 @@ public abstract class NativeMixpanelReactNativeSessionReplaySpec extends ReactCo
   @ReactMethod
   @DoNotStrip
   public abstract void identify(String distinctId, Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void getReplayId(Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void flush(Promise promise);
 }

package/android/app/build/generated/source/codegen/jni/MixpanelReactNativeSessionReplaySpec-generated.cpp

@@ -19,7 +19,7 @@ static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionRepla
 
 static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_startRecording(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
   static jmethodID cachedMethodId = nullptr;
-  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "startRecording", "(Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "startRecording", "(DLcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
 }
 
 static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_stopRecording(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
@@ -37,13 +37,25 @@ static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionRepla
   return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "identify", "(Ljava/lang/String;Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
 }
 
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_getReplayId(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "getReplayId", "(Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_flush(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "flush", "(Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
 NativeMixpanelReactNativeSessionReplaySpecJSI::NativeMixpanelReactNativeSessionReplaySpecJSI(const JavaTurboModule::InitParams &params)
   : JavaTurboModule(params) {
   methodMap_["initialize"] = MethodMetadata {3, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_initialize};
-  methodMap_["startRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_startRecording};
+  methodMap_["startRecording"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_startRecording};
   methodMap_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_stopRecording};
   methodMap_["isRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_isRecording};
   methodMap_["identify"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_identify};
+  methodMap_["getReplayId"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_getReplayId};
+  methodMap_["flush"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_flush};
 }
 
 std::shared_ptr<TurboModule> MixpanelReactNativeSessionReplaySpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params) {

package/android/app/build/generated/source/codegen/jni/react/renderer/components/MixpanelReactNativeSessionReplaySpec/MixpanelReactNativeSessionReplaySpecJSI-generated.cpp

@@ -21,7 +21,8 @@ static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJS
 }
 static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_startRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
   return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->startRecording(
-    rt
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asNumber()
   );
 }
 static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_stopRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
@@ -40,14 +41,26 @@ static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJS
     count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asString(rt)
   );
 }
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_getReplayId(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->getReplayId(
+    rt
+  );
+}
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_flush(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->flush(
+    rt
+  );
+}
 
 NativeMixpanelReactNativeSessionReplayCxxSpecJSI::NativeMixpanelReactNativeSessionReplayCxxSpecJSI(std::shared_ptr<CallInvoker> jsInvoker)
   : TurboModule("MixpanelReactNativeSessionReplay", jsInvoker) {
   methodMap_["initialize"] = MethodMetadata {3, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_initialize};
-  methodMap_["startRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_startRecording};
+  methodMap_["startRecording"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_startRecording};
   methodMap_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_stopRecording};
   methodMap_["isRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_isRecording};
   methodMap_["identify"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_identify};
+  methodMap_["getReplayId"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_getReplayId};
+  methodMap_["flush"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_flush};
 }
 
 

package/android/app/build/generated/source/codegen/jni/react/renderer/components/MixpanelReactNativeSessionReplaySpec/MixpanelReactNativeSessionReplaySpecJSI.h

@@ -21,10 +21,12 @@ protected:
 
 public:
   virtual jsi::Value initialize(jsi::Runtime &rt, jsi::String token, jsi::String distinctId, jsi::String configJSON) = 0;
-  virtual jsi::Value startRecording(jsi::Runtime &rt) = 0;
+  virtual jsi::Value startRecording(jsi::Runtime &rt, double recordingSessionsPercent) = 0;
   virtual jsi::Value stopRecording(jsi::Runtime &rt) = 0;
   virtual jsi::Value isRecording(jsi::Runtime &rt) = 0;
   virtual jsi::Value identify(jsi::Runtime &rt, jsi::String distinctId) = 0;
+  virtual jsi::Value getReplayId(jsi::Runtime &rt) = 0;
+  virtual jsi::Value flush(jsi::Runtime &rt) = 0;
 
 };
 
@@ -63,13 +65,13 @@ private:
       return bridging::callFromJs<jsi::Value>(
           rt, &T::initialize, jsInvoker_, instance_, std::move(token), std::move(distinctId), std::move(configJSON));
     }
-    jsi::Value startRecording(jsi::Runtime &rt) override {
+    jsi::Value startRecording(jsi::Runtime &rt, double recordingSessionsPercent) override {
       static_assert(
-          bridging::getParameterCount(&T::startRecording) == 1,
-          "Expected startRecording(...) to have 1 parameters");
+          bridging::getParameterCount(&T::startRecording) == 2,
+          "Expected startRecording(...) to have 2 parameters");
 
       return bridging::callFromJs<jsi::Value>(
-          rt, &T::startRecording, jsInvoker_, instance_);
+          rt, &T::startRecording, jsInvoker_, instance_, std::move(recordingSessionsPercent));
     }
     jsi::Value stopRecording(jsi::Runtime &rt) override {
       static_assert(
@@ -95,6 +97,22 @@ private:
       return bridging::callFromJs<jsi::Value>(
           rt, &T::identify, jsInvoker_, instance_, std::move(distinctId));
     }
+    jsi::Value getReplayId(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::getReplayId) == 1,
+          "Expected getReplayId(...) to have 1 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::getReplayId, jsInvoker_, instance_);
+    }
+    jsi::Value flush(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::flush) == 1,
+          "Expected flush(...) to have 1 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::flush, jsInvoker_, instance_);
+    }
 
   private:
     friend class NativeMixpanelReactNativeSessionReplayCxxSpec;

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.5"
+  implementation "com.mixpanel.android:mixpanel-android-session-replay:1.1.2"
 }
 
 react {

package/android/generated/java/com/mpsessionreplay/NativeMpSessionReplaySpec.java

@@ -0,0 +1,49 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJavaSpec.js
+ *
+ * @nolint
+ */
+
+package com.mpsessionreplay;
+
+import com.facebook.proguard.annotations.DoNotStrip;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.turbomodule.core.interfaces.TurboModule;
+import javax.annotation.Nonnull;
+
+public abstract class NativeMpSessionReplaySpec extends ReactContextBaseJavaModule implements TurboModule {
+  public static final String NAME = "MpSessionReplay";
+
+  public NativeMpSessionReplaySpec(ReactApplicationContext reactContext) {
+    super(reactContext);
+  }
+
+  @Override
+  public @Nonnull String getName() {
+    return NAME;
+  }
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void startRecording();
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void stopRecording();
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void initialize(String token, String distinctId, String configJSON);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void captureScreenshot();
+}

package/android/generated/jni/CMakeLists.txt

@@ -0,0 +1,36 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+file(GLOB react_codegen_SRCS CONFIGURE_DEPENDS *.cpp react/renderer/components/RNMpSessionReplaySpec/*.cpp)
+
+add_library(
+  react_codegen_RNMpSessionReplaySpec
+  OBJECT
+  ${react_codegen_SRCS}
+)
+
+target_include_directories(react_codegen_RNMpSessionReplaySpec PUBLIC . react/renderer/components/RNMpSessionReplaySpec)
+
+target_link_libraries(
+  react_codegen_RNMpSessionReplaySpec
+  fbjni
+  jsi
+  # We need to link different libraries based on whether we are building rncore or not, that's necessary
+  # because we want to break a circular dependency between react_codegen_rncore and reactnative
+  reactnative
+)
+
+target_compile_options(
+  react_codegen_RNMpSessionReplaySpec
+  PRIVATE
+  -DLOG_TAG=\"ReactNative\"
+  -fexceptions
+  -frtti
+  -std=c++20
+  -Wall
+)

package/android/generated/jni/RNMpSessionReplaySpec-generated.cpp

@@ -0,0 +1,50 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJniCpp.js
+ */
+
+#include "RNMpSessionReplaySpec.h"
+
+namespace facebook::react {
+
+static facebook::jsi::Value __hostFunction_NativeMpSessionReplaySpecJSI_startRecording(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "startRecording", "()V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMpSessionReplaySpecJSI_stopRecording(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "stopRecording", "()V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMpSessionReplaySpecJSI_initialize(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "initialize", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMpSessionReplaySpecJSI_captureScreenshot(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "captureScreenshot", "()V", args, count, cachedMethodId);
+}
+
+NativeMpSessionReplaySpecJSI::NativeMpSessionReplaySpecJSI(const JavaTurboModule::InitParams &params)
+  : JavaTurboModule(params) {
+  methodMap_["startRecording"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplaySpecJSI_startRecording};
+  methodMap_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplaySpecJSI_stopRecording};
+  methodMap_["initialize"] = MethodMetadata {3, __hostFunction_NativeMpSessionReplaySpecJSI_initialize};
+  methodMap_["captureScreenshot"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplaySpecJSI_captureScreenshot};
+}
+
+std::shared_ptr<TurboModule> RNMpSessionReplaySpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params) {
+  if (moduleName == "MpSessionReplay") {
+    return std::make_shared<NativeMpSessionReplaySpecJSI>(params);
+  }
+  return nullptr;
+}
+
+} // namespace facebook::react

package/android/generated/jni/RNMpSessionReplaySpec.h

@@ -0,0 +1,31 @@
+
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleJniH.js
+ */
+
+#pragma once
+
+#include <ReactCommon/JavaTurboModule.h>
+#include <ReactCommon/TurboModule.h>
+#include <jsi/jsi.h>
+
+namespace facebook::react {
+
+/**
+ * JNI C++ class for module 'NativeMpSessionReplay'
+ */
+class JSI_EXPORT NativeMpSessionReplaySpecJSI : public JavaTurboModule {
+public:
+  NativeMpSessionReplaySpecJSI(const JavaTurboModule::InitParams &params);
+};
+
+
+JSI_EXPORT
+std::shared_ptr<TurboModule> RNMpSessionReplaySpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params);
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNMpSessionReplaySpec/RNMpSessionReplaySpecJSI-generated.cpp

@@ -0,0 +1,51 @@
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleCpp.js
+ */
+
+#include "RNMpSessionReplaySpecJSI.h"
+
+namespace facebook::react {
+
+static jsi::Value __hostFunction_NativeMpSessionReplayCxxSpecJSI_startRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeMpSessionReplayCxxSpecJSI *>(&turboModule)->startRecording(
+    rt
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeMpSessionReplayCxxSpecJSI_stopRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeMpSessionReplayCxxSpecJSI *>(&turboModule)->stopRecording(
+    rt
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeMpSessionReplayCxxSpecJSI_initialize(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeMpSessionReplayCxxSpecJSI *>(&turboModule)->initialize(
+    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),
+    count <= 2 ? throw jsi::JSError(rt, "Expected argument in position 2 to be passed") : args[2].asString(rt)
+  );
+  return jsi::Value::undefined();
+}
+static jsi::Value __hostFunction_NativeMpSessionReplayCxxSpecJSI_captureScreenshot(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  static_cast<NativeMpSessionReplayCxxSpecJSI *>(&turboModule)->captureScreenshot(
+    rt
+  );
+  return jsi::Value::undefined();
+}
+
+NativeMpSessionReplayCxxSpecJSI::NativeMpSessionReplayCxxSpecJSI(std::shared_ptr<CallInvoker> jsInvoker)
+  : TurboModule("MpSessionReplay", jsInvoker) {
+  methodMap_["startRecording"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplayCxxSpecJSI_startRecording};
+  methodMap_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplayCxxSpecJSI_stopRecording};
+  methodMap_["initialize"] = MethodMetadata {3, __hostFunction_NativeMpSessionReplayCxxSpecJSI_initialize};
+  methodMap_["captureScreenshot"] = MethodMetadata {0, __hostFunction_NativeMpSessionReplayCxxSpecJSI_captureScreenshot};
+}
+
+
+} // namespace facebook::react

package/android/generated/jni/react/renderer/components/RNMpSessionReplaySpec/RNMpSessionReplaySpecJSI.h

@@ -0,0 +1,98 @@
+/**
+ * This code was generated by [react-native-codegen](https://www.npmjs.com/package/react-native-codegen).
+ *
+ * Do not edit this file as changes may cause incorrect behavior and will be lost
+ * once the code is regenerated.
+ *
+ * @generated by codegen project: GenerateModuleH.js
+ */
+
+#pragma once
+
+#include <ReactCommon/TurboModule.h>
+#include <react/bridging/Bridging.h>
+
+namespace facebook::react {
+
+
+  class JSI_EXPORT NativeMpSessionReplayCxxSpecJSI : public TurboModule {
+protected:
+  NativeMpSessionReplayCxxSpecJSI(std::shared_ptr<CallInvoker> jsInvoker);
+
+public:
+  virtual void startRecording(jsi::Runtime &rt) = 0;
+  virtual void stopRecording(jsi::Runtime &rt) = 0;
+  virtual void initialize(jsi::Runtime &rt, jsi::String token, jsi::String distinctId, jsi::String configJSON) = 0;
+  virtual void captureScreenshot(jsi::Runtime &rt) = 0;
+
+};
+
+template <typename T>
+class JSI_EXPORT NativeMpSessionReplayCxxSpec : public TurboModule {
+public:
+  jsi::Value create(jsi::Runtime &rt, const jsi::PropNameID &propName) override {
+    return delegate_.create(rt, propName);
+  }
+
+  std::vector<jsi::PropNameID> getPropertyNames(jsi::Runtime& runtime) override {
+    return delegate_.getPropertyNames(runtime);
+  }
+
+  static constexpr std::string_view kModuleName = "MpSessionReplay";
+
+protected:
+  NativeMpSessionReplayCxxSpec(std::shared_ptr<CallInvoker> jsInvoker)
+    : TurboModule(std::string{NativeMpSessionReplayCxxSpec::kModuleName}, jsInvoker),
+      delegate_(reinterpret_cast<T*>(this), jsInvoker) {}
+
+
+private:
+  class Delegate : public NativeMpSessionReplayCxxSpecJSI {
+  public:
+    Delegate(T *instance, std::shared_ptr<CallInvoker> jsInvoker) :
+      NativeMpSessionReplayCxxSpecJSI(std::move(jsInvoker)), instance_(instance) {
+
+    }
+
+    void startRecording(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::startRecording) == 1,
+          "Expected startRecording(...) to have 1 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::startRecording, jsInvoker_, instance_);
+    }
+    void stopRecording(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::stopRecording) == 1,
+          "Expected stopRecording(...) to have 1 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::stopRecording, jsInvoker_, instance_);
+    }
+    void initialize(jsi::Runtime &rt, jsi::String token, jsi::String distinctId, jsi::String configJSON) override {
+      static_assert(
+          bridging::getParameterCount(&T::initialize) == 4,
+          "Expected initialize(...) to have 4 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::initialize, jsInvoker_, instance_, std::move(token), std::move(distinctId), std::move(configJSON));
+    }
+    void captureScreenshot(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::captureScreenshot) == 1,
+          "Expected captureScreenshot(...) to have 1 parameters");
+
+      return bridging::callFromJs<void>(
+          rt, &T::captureScreenshot, jsInvoker_, instance_);
+    }
+
+  private:
+    friend class NativeMpSessionReplayCxxSpec;
+    T *instance_;
+  };
+
+  Delegate delegate_;
+};
+
+} // namespace facebook::react

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

@@ -307,7 +307,7 @@ class MixpanelReactNativeSessionReplayModule(reactContext: ReactApplicationConte
 
   companion object {
     const val NAME = "MixpanelReactNativeSessionReplay"
-    const val LIB_VERSION = "1.0.1"
+    const val LIB_VERSION = "1.2.0"
     const val MP_LIB = "react-native-sr"
   }
 }

package/ios/MixpanelSwiftSessionReplay.swift

@@ -3,7 +3,7 @@ import MixpanelSessionReplay
 import UIKit
 
 @objc public class MixpanelSwiftSessionReplay: NSObject {
-  static let libVersion = "1.0.1"
+  static let libVersion = "1.2.0"
   static let mpLib = "react-native-sr"
 
   @objc public static func startRecording(recordingSessionsPercent: Double = 100.0) {

package/lib/module/index.js

@@ -9,6 +9,12 @@ export let MPSessionReplayMask = /*#__PURE__*/function (MPSessionReplayMask) {
   MPSessionReplayMask["Image"] = "image";
   return MPSessionReplayMask;
 }({});
+export let MPSessionReplayRemoteSettingsMode = /*#__PURE__*/function (MPSessionReplayRemoteSettingsMode) {
+  MPSessionReplayRemoteSettingsMode["Disabled"] = "disabled";
+  MPSessionReplayRemoteSettingsMode["Strict"] = "strict";
+  MPSessionReplayRemoteSettingsMode["Fallback"] = "fallback";
+  return MPSessionReplayRemoteSettingsMode;
+}({});
 export class MPSessionReplayConfig {
   /**
    * Determines whether replay events will only be flushed to the server when the device has a WiFi connection.
@@ -67,13 +73,29 @@ export class MPSessionReplayConfig {
    * - **Default:** `false`
    */
 
+  /**
+   * Controls how remote configuration settings are fetched and applied.
+   *
+   * Remote settings enable server-side control over session replay parameters such as sampling rate.
+   * This setting determines the SDK's behavior when fetching these settings and how failures are handled.
+   *
+   * - **`disabled`** (default): Remote config is fetched to check if session replay is enabled, but SDK config
+   *   settings from the server are not used. The SDK uses only the app-provided configuration.
+   * - **`strict`**: Remote config is required. If the fetch fails or times out, the SDK will not initialize.
+   * - **`fallback`**: Remote config is fetched and merged with local config. On fetch failure, the SDK falls back
+   *   to cached config (if available) or uses the local config.
+   *
+   * - **Default:** `disabled`
+   */
+
   constructor({
     wifiOnly = true,
     autoStartRecording = true,
     recordingSessionsPercent = 100,
     autoMaskedViews = [MPSessionReplayMask.Image, MPSessionReplayMask.Text, MPSessionReplayMask.Web, MPSessionReplayMask.Map],
     flushInterval = 10,
-    enableLogging = false
+    enableLogging = false,
+    remoteSettingsMode = MPSessionReplayRemoteSettingsMode.Disabled
   } = {}) {
     this.wifiOnly = wifiOnly;
     this.autoStartRecording = autoStartRecording;
@@ -81,6 +103,7 @@ export class MPSessionReplayConfig {
     this.autoMaskedViews = autoMaskedViews;
     this.flushInterval = flushInterval;
     this.enableLogging = enableLogging;
+    this.remoteSettingsMode = remoteSettingsMode;
   }
   transformMaskValueForPlatform(value) {
     if (Platform.OS === 'android') {
@@ -93,6 +116,7 @@ export class MPSessionReplayConfig {
   toJSON() {
     // Transform autoMaskedViews for platform-specific requirements
     const transformedAutoMaskedViews = this.autoMaskedViews.filter(mask => !(Platform.OS === 'android' && mask === MPSessionReplayMask.Map)).map(mask => this.transformMaskValueForPlatform(mask));
+    const transformedRemoteSettingsMode = Platform.OS === 'android' ? this.remoteSettingsMode.toUpperCase() : this.remoteSettingsMode;
     const config = {
       wifiOnly: this.wifiOnly,
       recordingSessionsPercent: this.recordingSessionsPercent,
@@ -100,6 +124,7 @@ export class MPSessionReplayConfig {
       autoStartRecording: this.autoStartRecording,
       flushInterval: this.flushInterval,
       enableLogging: this.enableLogging,
+      remoteSettingsMode: transformedRemoteSettingsMode,
       // iOS-specific config to enable session replay on iOS 26 and later
       ...Platform.select({
         ios: {

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","select","ios","enableSessionReplayOniOS26AndLater","default","JSON","stringify","initialize","token","distinctId","Error","undefined","json","startRecording","stopRecording","isRecording","identify","getReplayId","flush","MPSessionReplayView","MPSessionReplay"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Platform","MixpanelReactNativeSessionReplay","MPSessionReplayMask","MPSessionReplayRemoteSettingsMode","MPSessionReplayConfig","constructor","wifiOnly","autoStartRecording","recordingSessionsPercent","autoMaskedViews","Image","Text","Web","Map","flushInterval","enableLogging","remoteSettingsMode","Disabled","transformMaskValueForPlatform","value","OS","charAt","toUpperCase","slice","toJSON","transformedAutoMaskedViews","filter","mask","map","transformedRemoteSettingsMode","config","select","ios","enableSessionReplayOniOS26AndLater","default","JSON","stringify","initialize","token","distinctId","Error","undefined","json","startRecording","stopRecording","isRecording","identify","getReplayId","flush","MPSessionReplayView","MPSessionReplay"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -4,6 +4,11 @@ export declare enum MPSessionReplayMask {
     Map = "map",
     Image = "image"
 }
+export declare enum MPSessionReplayRemoteSettingsMode {
+    Disabled = "disabled",
+    Strict = "strict",
+    Fallback = "fallback"
+}
 export declare class MPSessionReplayConfig {
     /**
      * Determines whether replay events will only be flushed to the server when the device has a WiFi connection.
@@ -62,7 +67,22 @@ export declare class MPSessionReplayConfig {
      * - **Default:** `false`
      */
     enableLogging: boolean;
-    constructor({ wifiOnly, autoStartRecording, recordingSessionsPercent, autoMaskedViews, flushInterval, enableLogging, }?: Partial<MPSessionReplayConfig>);
+    /**
+     * Controls how remote configuration settings are fetched and applied.
+     *
+     * Remote settings enable server-side control over session replay parameters such as sampling rate.
+     * This setting determines the SDK's behavior when fetching these settings and how failures are handled.
+     *
+     * - **`disabled`** (default): Remote config is fetched to check if session replay is enabled, but SDK config
+     *   settings from the server are not used. The SDK uses only the app-provided configuration.
+     * - **`strict`**: Remote config is required. If the fetch fails or times out, the SDK will not initialize.
+     * - **`fallback`**: Remote config is fetched and merged with local config. On fetch failure, the SDK falls back
+     *   to cached config (if available) or uses the local config.
+     *
+     * - **Default:** `disabled`
+     */
+    remoteSettingsMode: MPSessionReplayRemoteSettingsMode;
+    constructor({ wifiOnly, autoStartRecording, recordingSessionsPercent, autoMaskedViews, flushInterval, enableLogging, remoteSettingsMode, }?: Partial<MPSessionReplayConfig>);
     private transformMaskValueForPlatform;
     toJSON(): string;
 }

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;CA8BjB;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;;;;;;;GAOG;AACH,iBAAe,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;CAQ3B,CAAC"}
+{"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,oBAAY,iCAAiC;IAC3C,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;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;IAEvB;;;;;;;;;;;;;OAaG;IACH,kBAAkB,EAAE,iCAAiC,CAAC;gBAE1C,EACV,QAAe,EACf,kBAAyB,EACzB,wBAA8B,EAC9B,eAKC,EACD,aAAkB,EAClB,aAAqB,EACrB,kBAA+D,GAChE,GAAE,OAAO,CAAC,qBAAqB,CAAM;IAUtC,OAAO,CAAC,6BAA6B;IASrC,MAAM,IAAI,MAAM;CAmCjB;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;;;;;;;GAOG;AACH,iBAAe,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;CAQ3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixpanel/react-native-session-replay",
-  "version": "1.0.1",
+  "version": "1.2.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/index.tsx

@@ -8,6 +8,12 @@ export enum MPSessionReplayMask {
   Image = 'image',
 }
 
+export enum MPSessionReplayRemoteSettingsMode {
+  Disabled = 'disabled',
+  Strict = 'strict',
+  Fallback = 'fallback',
+}
+
 export class MPSessionReplayConfig {
   /**
    * Determines whether replay events will only be flushed to the server when the device has a WiFi connection.
@@ -72,6 +78,22 @@ export class MPSessionReplayConfig {
    */
   enableLogging: boolean;
 
+  /**
+   * Controls how remote configuration settings are fetched and applied.
+   *
+   * Remote settings enable server-side control over session replay parameters such as sampling rate.
+   * This setting determines the SDK's behavior when fetching these settings and how failures are handled.
+   *
+   * - **`disabled`** (default): Remote config is fetched to check if session replay is enabled, but SDK config
+   *   settings from the server are not used. The SDK uses only the app-provided configuration.
+   * - **`strict`**: Remote config is required. If the fetch fails or times out, the SDK will not initialize.
+   * - **`fallback`**: Remote config is fetched and merged with local config. On fetch failure, the SDK falls back
+   *   to cached config (if available) or uses the local config.
+   *
+   * - **Default:** `disabled`
+   */
+  remoteSettingsMode: MPSessionReplayRemoteSettingsMode;
+
   constructor({
     wifiOnly = true,
     autoStartRecording = true,
@@ -84,6 +106,7 @@ export class MPSessionReplayConfig {
     ],
     flushInterval = 10,
     enableLogging = false,
+    remoteSettingsMode = MPSessionReplayRemoteSettingsMode.Disabled,
   }: Partial<MPSessionReplayConfig> = {}) {
     this.wifiOnly = wifiOnly;
     this.autoStartRecording = autoStartRecording;
@@ -91,6 +114,7 @@ export class MPSessionReplayConfig {
     this.autoMaskedViews = autoMaskedViews;
     this.flushInterval = flushInterval;
     this.enableLogging = enableLogging;
+    this.remoteSettingsMode = remoteSettingsMode;
   }
 
   private transformMaskValueForPlatform(value: string): string {
@@ -110,6 +134,10 @@ export class MPSessionReplayConfig {
           !(Platform.OS === 'android' && mask === MPSessionReplayMask.Map)
       )
       .map((mask) => this.transformMaskValueForPlatform(mask));
+    const transformedRemoteSettingsMode =
+      Platform.OS === 'android'
+        ? this.remoteSettingsMode.toUpperCase()
+        : this.remoteSettingsMode;
 
     const config = {
       wifiOnly: this.wifiOnly,
@@ -118,6 +146,7 @@ export class MPSessionReplayConfig {
       autoStartRecording: this.autoStartRecording,
       flushInterval: this.flushInterval,
       enableLogging: this.enableLogging,
+      remoteSettingsMode: transformedRemoteSettingsMode,
       // iOS-specific config to enable session replay on iOS 26 and later
       ...Platform.select({
         ios: { enableSessionReplayOniOS26AndLater: true },