@mixpanel/react-native-session-replay 0.1.2

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Mixpanel
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MixpanelReactNativeSessionReplay.podspec

@@ -0,0 +1,26 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "MixpanelReactNativeSessionReplay"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/ketanmixpanel/mp-session-replay.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp,swift}"
+  s.private_header_files = "ios/**/*.h"
+  s.dependency 'MixpanelSessionReplay', '1.1.4'
+# 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)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+end

package/README.md

@@ -0,0 +1,200 @@
+# Mixpanel React Native Session Replay
+
+Official React Native turbo module for Mixpanel Session Replay. Capture and analyze user interactions in your mobile app by bridging Mixpanel's native iOS and Android session replay SDKs to React Native.
+
+## Features
+
+- 🎥 **Session Recording** - Capture user interactions and screen recordings
+- 🔒 **Privacy First** - Built-in data masking for sensitive information
+- ⚡ **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
+
+## Installation
+
+```sh
+npm install @mixpanel/react-native-session-replay
+```
+
+or
+
+```sh
+yarn add @mixpanel/react-native-session-replay
+```
+
+### Platform Setup
+
+#### iOS
+The SDK dependencies are automatically added via CocoaPods. Your project must target iOS 13 or later.
+
+```sh
+cd ios && pod install
+```
+
+#### Android
+Dependencies are automatically added through Gradle. Requirements:
+- Minimum Android SDK 21+
+- Kotlin support enabled
+
+## Quick Start
+
+```typescript
+import {
+  initialize,
+  startRecording,
+  stopRecording,
+  isRecording,
+  MPSessionReplayConfig,
+  MPSessionReplayMask,
+} from '@mixpanel/react-native-session-replay';
+
+// Initialize session replay
+const config = new MPSessionReplayConfig({
+  wifiOnly: false,
+  recordingSessionsPercent: 100,
+  autoStartRecording: true,
+  autoMaskedViews: [MPSessionReplayMask.Image, MPSessionReplayMask.Text],
+  flushInterval: 5,
+  enableLogging: true,
+});
+
+await initialize(token, distinctId, config).catch((error) => {
+  console.error('Initialization error:', error);
+});
+
+// Control recording
+await startRecording();
+await stopRecording();
+
+// Check recording status
+const recording = await isRecording();
+```
+
+## Configuration
+
+### MPSessionReplayConfig
+
+```typescript
+class MPSessionReplayConfig {
+  wifiOnly: boolean;                         // Only transmit on WiFi (default: true)
+  recordingSessionsPercent: number;          // Sampling rate 0-100 (default: 100)
+  autoMaskedViews: MPSessionReplayMask[];    // Views to auto-mask (default: all)
+  autoStartRecording: boolean;               // Start recording automatically (default: true)
+  flushInterval: number;                     // Flush interval in seconds (default: 10)
+  enableLogging: boolean;                    // Enable verbose logging (default: false)
+}
+```
+
+### Configuration Options
+
+#### wifiOnly
+Controls whether replay events are sent only over WiFi.
+
+- **true** - Events are flushed only when connected to WiFi. Without WiFi, events are queued in memory and will be lost if the app is killed before WiFi becomes available.
+- **false** - Events are flushed over any network connection, including cellular.
+- **Default:** `true`
+
+#### recordingSessionsPercent
+Sets the sampling rate for automatic session recording.
+
+Accepts values from 0 to 100, representing the percentage of sessions that will automatically start recording.
+
+- **0** - No automatic recording
+- **100** - Record all sessions
+- **Default:** `100`
+- **Note:** This only applies to automatic recording. Manual calls to `startRecording()` are not affected.
+
+#### autoMaskedViews
+Specifies which view types are automatically masked by the SDK.
+
+By default, the SDK masks image, text, web, and map views (iOS only). You can customize this behavior through configuration.
+
+#### autoStartRecording
+Determines whether recording starts automatically on initialization.
+
+- **true** - Recording starts automatically when initialized. The SDK stops and restarts recording as the app moves between background and foreground. Each new session uses `recordingSessionsPercent` to determine if recording should begin.
+- **false** - Recording only starts when you explicitly call `startRecording()`.
+- **Default:** `true`
+
+#### flushInterval
+Sets how often screenshots are sent to Mixpanel, in seconds.
+
+Screenshots are collected in batches of 10 and sent after each flush interval. Adjust this value to control how quickly screenshots are uploaded.
+
+- **Default:** `10` seconds
+
+#### enableLogging
+Enables debug logging for development and troubleshooting.
+
+- **true** - Prints verbose debug logs including internal events, configuration status etc...
+- **false** - No logs from the Session Replay SDK will be printed.
+- **Default:** `false`
+
+## API Methods
+
+### 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>
+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>
+Stops the current recording session and performs cleanup.
+
+### isRecording(): Promise<boolean>
+Returns whether recording is currently active.
+
+### 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
+
+The SDK automatically masks sensitive information to protect user privacy. Text input fields are always masked and cannot be disabled.
+
+Additional configurable masking options:
+- Images
+- Text elements
+- WebView content
+- Apple Maps (iOS only)
+
+## Example App
+
+Test the integration using the example app:
+
+```sh
+# Install dependencies
+yarn
+
+# Start Metro bundler
+yarn example start
+
+# Run on iOS
+yarn example ios
+
+# Run on Android
+yarn example android
+```
+
+## Requirements
+
+- React Native 0.70 or higher
+- iOS 13.0 or higher
+- Android API Level 21 or higher
+- New Architecture support
+
+## Contributing
+
+See our [contributing guide](CONTRIBUTING.md) to learn how to contribute and understand the development workflow.
+
+## License
+
+MIT

package/android/app/build/generated/source/codegen/java/com/facebook/fbreact/specs/NativeMixpanelReactNativeSessionReplaySpec.java

@@ -0,0 +1,54 @@
+
+/**
+ * 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.facebook.fbreact.specs;
+
+import com.facebook.proguard.annotations.DoNotStrip;
+import com.facebook.react.bridge.Promise;
+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 NativeMixpanelReactNativeSessionReplaySpec extends ReactContextBaseJavaModule implements TurboModule {
+  public static final String NAME = "MixpanelReactNativeSessionReplay";
+
+  public NativeMixpanelReactNativeSessionReplaySpec(ReactApplicationContext reactContext) {
+    super(reactContext);
+  }
+
+  @Override
+  public @Nonnull String getName() {
+    return NAME;
+  }
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void initialize(String token, String distinctId, String configJSON, Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void startRecording(Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void stopRecording(Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void isRecording(Promise promise);
+
+  @ReactMethod
+  @DoNotStrip
+  public abstract void identify(String distinctId, Promise promise);
+}

package/android/app/build/generated/source/codegen/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/MixpanelReactNativeSessionReplaySpec/*.cpp)
+
+add_library(
+  react_codegen_MixpanelReactNativeSessionReplaySpec
+  OBJECT
+  ${react_codegen_SRCS}
+)
+
+target_include_directories(react_codegen_MixpanelReactNativeSessionReplaySpec PUBLIC . react/renderer/components/MixpanelReactNativeSessionReplaySpec)
+
+target_link_libraries(
+  react_codegen_MixpanelReactNativeSessionReplaySpec
+  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_MixpanelReactNativeSessionReplaySpec
+  PRIVATE
+  -DLOG_TAG=\"ReactNative\"
+  -fexceptions
+  -frtti
+  -std=c++20
+  -Wall
+)

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

@@ -0,0 +1,56 @@
+
+/**
+ * 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 "MixpanelReactNativeSessionReplaySpec.h"
+
+namespace facebook::react {
+
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_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, PromiseKind, "initialize", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
+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);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_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, PromiseKind, "stopRecording", "(Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_isRecording(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, "isRecording", "(Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_identify(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, "identify", "(Ljava/lang/String;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_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_stopRecording};
+  methodMap_["isRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_isRecording};
+  methodMap_["identify"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplaySpecJSI_identify};
+}
+
+std::shared_ptr<TurboModule> MixpanelReactNativeSessionReplaySpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params) {
+  if (moduleName == "MixpanelReactNativeSessionReplay") {
+    return std::make_shared<NativeMixpanelReactNativeSessionReplaySpecJSI>(params);
+  }
+  return nullptr;
+}
+
+} // namespace facebook::react

package/android/app/build/generated/source/codegen/jni/MixpanelReactNativeSessionReplaySpec.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 'NativeMixpanelReactNativeSessionReplay'
+ */
+class JSI_EXPORT NativeMixpanelReactNativeSessionReplaySpecJSI : public JavaTurboModule {
+public:
+  NativeMixpanelReactNativeSessionReplaySpecJSI(const JavaTurboModule::InitParams &params);
+};
+
+
+JSI_EXPORT
+std::shared_ptr<TurboModule> MixpanelReactNativeSessionReplaySpec_ModuleProvider(const std::string &moduleName, const JavaTurboModule::InitParams &params);
+
+} // namespace facebook::react

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

@@ -0,0 +1,54 @@
+/**
+ * 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 "MixpanelReactNativeSessionReplaySpecJSI.h"
+
+namespace facebook::react {
+
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_initialize(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&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)
+  );
+}
+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
+  );
+}
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_stopRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->stopRecording(
+    rt
+  );
+}
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_isRecording(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->isRecording(
+    rt
+  );
+}
+static jsi::Value __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_identify(jsi::Runtime &rt, TurboModule &turboModule, const jsi::Value* args, size_t count) {
+  return static_cast<NativeMixpanelReactNativeSessionReplayCxxSpecJSI *>(&turboModule)->identify(
+    rt,
+    count <= 0 ? throw jsi::JSError(rt, "Expected argument in position 0 to be passed") : args[0].asString(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_["stopRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_stopRecording};
+  methodMap_["isRecording"] = MethodMetadata {0, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_isRecording};
+  methodMap_["identify"] = MethodMetadata {1, __hostFunction_NativeMixpanelReactNativeSessionReplayCxxSpecJSI_identify};
+}
+
+
+} // namespace facebook::react

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

@@ -0,0 +1,107 @@
+/**
+ * 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 NativeMixpanelReactNativeSessionReplayCxxSpecJSI : public TurboModule {
+protected:
+  NativeMixpanelReactNativeSessionReplayCxxSpecJSI(std::shared_ptr<CallInvoker> jsInvoker);
+
+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 stopRecording(jsi::Runtime &rt) = 0;
+  virtual jsi::Value isRecording(jsi::Runtime &rt) = 0;
+  virtual jsi::Value identify(jsi::Runtime &rt, jsi::String distinctId) = 0;
+
+};
+
+template <typename T>
+class JSI_EXPORT NativeMixpanelReactNativeSessionReplayCxxSpec : 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 = "MixpanelReactNativeSessionReplay";
+
+protected:
+  NativeMixpanelReactNativeSessionReplayCxxSpec(std::shared_ptr<CallInvoker> jsInvoker)
+    : TurboModule(std::string{NativeMixpanelReactNativeSessionReplayCxxSpec::kModuleName}, jsInvoker),
+      delegate_(reinterpret_cast<T*>(this), jsInvoker) {}
+
+
+private:
+  class Delegate : public NativeMixpanelReactNativeSessionReplayCxxSpecJSI {
+  public:
+    Delegate(T *instance, std::shared_ptr<CallInvoker> jsInvoker) :
+      NativeMixpanelReactNativeSessionReplayCxxSpecJSI(std::move(jsInvoker)), instance_(instance) {
+
+    }
+
+    jsi::Value 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<jsi::Value>(
+          rt, &T::initialize, jsInvoker_, instance_, std::move(token), std::move(distinctId), std::move(configJSON));
+    }
+    jsi::Value startRecording(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::startRecording) == 1,
+          "Expected startRecording(...) to have 1 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::startRecording, jsInvoker_, instance_);
+    }
+    jsi::Value stopRecording(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::stopRecording) == 1,
+          "Expected stopRecording(...) to have 1 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::stopRecording, jsInvoker_, instance_);
+    }
+    jsi::Value isRecording(jsi::Runtime &rt) override {
+      static_assert(
+          bridging::getParameterCount(&T::isRecording) == 1,
+          "Expected isRecording(...) to have 1 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::isRecording, jsInvoker_, instance_);
+    }
+    jsi::Value identify(jsi::Runtime &rt, jsi::String distinctId) override {
+      static_assert(
+          bridging::getParameterCount(&T::identify) == 2,
+          "Expected identify(...) to have 2 parameters");
+
+      return bridging::callFromJs<jsi::Value>(
+          rt, &T::identify, jsInvoker_, instance_, std::move(distinctId));
+    }
+
+  private:
+    friend class NativeMixpanelReactNativeSessionReplayCxxSpec;
+    T *instance_;
+  };
+
+  Delegate delegate_;
+};
+
+} // namespace facebook::react

package/android/build.gradle

@@ -0,0 +1,89 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['MixpanelReactNativeSessionReplay_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["MixpanelReactNativeSessionReplay_" + name]).toInteger()
+}
+
+android {
+  namespace "com.mixpanelreactnativesessionreplay"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  
+  // Mixpanel Android SDK dependency (minimum v8.0.2)
+  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"
+}
+
+react {
+  jsRootDir = file("../src/")
+  libraryName = "MixpanelReactNativeSessionReplay"
+  codegenJavaPackageName = "com.mixpanelreactnativesessionreplay"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+MixpanelReactNativeSessionReplay_kotlinVersion=2.0.21
+MixpanelReactNativeSessionReplay_minSdkVersion=24
+MixpanelReactNativeSessionReplay_targetSdkVersion=34
+MixpanelReactNativeSessionReplay_compileSdkVersion=35
+MixpanelReactNativeSessionReplay_ndkVersion=27.1.12297006