@amplitude/plugin-session-replay-react-native 0.2.8 → 0.3.0

package/README.md

@@ -19,6 +19,7 @@ import { SessionReplayPlugin } from '@amplitude/plugin-session-replay-react-nati
 const config: SessionReplayConfig = {
     enableRemoteConfig: true, // default true
     sampleRate: 1, // default 0
+    logLevel: LogLevel.Warn, // default LogLevel.Warn
 };
 await init('YOUR_API_KEY').promise;
 await add(new SessionReplayPlugin(config)).promise;

package/android/build.gradle

@@ -90,7 +90,7 @@ repositories {
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
-  implementation("com.amplitude:session-replay-android:[0.16.4, 1.0.0]")
+  implementation("com.amplitude:session-replay-android:[0.19.0, 1.0.0]")
 
   // For < 0.71, this will be from the local maven repo
   // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
@@ -98,4 +98,3 @@ dependencies {
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 }
-

package/android/src/main/java/com/amplitude/pluginsessionreplayreactnative/PluginSessionReplayReactNativeModule.kt

@@ -19,8 +19,15 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
   }
 
   @ReactMethod
-  fun setup(apiKey: String, deviceId: String?, sessionId: Double, sampleRate: Double, enableRemoteConfig: Boolean) {
-    LogcatLogger.logger.logMode = Logger.LogMode.DEBUG
+  fun setup(apiKey: String, deviceId: String?, sessionId: Double, sampleRate: Double, enableRemoteConfig: Boolean, logLevel: Int) {
+    LogcatLogger.logger.logMode = when (logLevel) {
+        0 -> Logger.LogMode.OFF
+        1 -> Logger.LogMode.ERROR
+        2 -> Logger.LogMode.WARN
+        3 -> Logger.LogMode.INFO
+        4 -> Logger.LogMode.DEBUG
+        else -> Logger.LogMode.WARN
+    }
     sessionReplay = SessionReplay(
       apiKey,
       reactContext.applicationContext,
@@ -61,6 +68,16 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
     }
     promise.resolve(map)
   }
+  
+  @ReactMethod
+  fun start() {
+    sessionReplay.start()
+  }
+
+  @ReactMethod
+  fun stop() {
+    sessionReplay.stop()
+  }
 
   @ReactMethod
   fun flush() {

package/ios/PluginSessionReplayReactNative.mm

@@ -2,7 +2,7 @@
 
 @interface RCT_EXTERN_MODULE(PluginSessionReplayReactNative, NSObject)
 
-RCT_EXTERN_METHOD(setup:(NSString)apiKey deviceId:(NSString)deviceId sessionId:(nonnull NSNumber)sessionId sampleRate:(float)sampleRate enableRemoteConfig:(BOOL)enableRemoteConfig resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(setup:(NSString)apiKey deviceId:(NSString)deviceId sessionId:(nonnull NSNumber)sessionId sampleRate:(float)sampleRate enableRemoteConfig:(BOOL)enableRemoteConfig logLevel:(int)logLevel resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 
 RCT_EXTERN_METHOD(setSessionId:(nonnull NSNumber)sessionId resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 
@@ -10,6 +10,10 @@ RCT_EXTERN_METHOD(getSessionId:(RCTPromiseResolveBlock)resolve reject:(RCTPromis
 
 RCT_EXTERN_METHOD(getSessionReplayProperties:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(start:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(stop:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+
 RCT_EXTERN_METHOD(flush:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 
 RCT_EXTERN_METHOD(teardown:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)

package/ios/PluginSessionReplayReactNative.swift

@@ -6,14 +6,14 @@ class PluginSessionReplayReactNative: NSObject {
     
     var sessionReplay: SessionReplay!
     
-    @objc(setup:deviceId:sessionId:sampleRate:enableRemoteConfig:resolve:reject:)
-    func setup(_ apiKey: String, deviceId: String, sessionId: NSNumber, sampleRate: Float, enableRemoteConfig: Bool, resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
-      print("setup: API Key: \(apiKey) Device Id: \(deviceId) Session Id: \(sessionId) Sample Rate: \(sampleRate) Enable Remote Config: \(enableRemoteConfig)")
+    @objc(setup:deviceId:sessionId:sampleRate:enableRemoteConfig:logLevel:resolve:reject:)
+    func setup(_ apiKey: String, deviceId: String, sessionId: NSNumber, sampleRate: Float, enableRemoteConfig: Bool, logLevel: Int, resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
+      print("setup: API Key: \(apiKey) Device Id: \(deviceId) Session Id: \(sessionId) Sample Rate: \(sampleRate) Enable Remote Config: \(enableRemoteConfig) Log Level: \(logLevel)")
       sessionReplay = SessionReplay(apiKey:apiKey,
                                     deviceId: deviceId,
                                     sessionId: sessionId.int64Value,
                                     sampleRate: sampleRate,
-                                    logger:ConsoleLogger(logLevel: LogLevelEnum.DEBUG.rawValue),
+                                    logger:ConsoleLogger(logLevel: logLevel),
                                     enableRemoteConfig: enableRemoteConfig)
       sessionReplay.start()
       resolve(nil)
@@ -38,6 +38,20 @@ class PluginSessionReplayReactNative: NSObject {
       resolve(sessionReplay.additionalEventProperties)
     }
     
+    @objc(start:reject:)
+    func start(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
+      print("start")
+      sessionReplay.start()
+      resolve(nil)
+    }
+    
+    @objc(stop:reject:)
+    func stop(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
+      print("stop")
+      sessionReplay.stop()
+      resolve(nil)
+    }
+    
     @objc(flush:reject:)
     func flush(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
       print("flush")

package/lib/commonjs/session-replay-config.js

@@ -4,10 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getDefaultConfig = void 0;
+var _analyticsTypes = require("@amplitude/analytics-types");
 const getDefaultConfig = () => {
   return {
     sampleRate: 0,
-    enableRemoteConfig: true
+    enableRemoteConfig: true,
+    logLevel: _analyticsTypes.LogLevel.Warn
   };
 };
 exports.getDefaultConfig = getDefaultConfig;

package/lib/commonjs/session-replay-config.js.map

@@ -1 +1 @@
-{"version":3,"names":["getDefaultConfig","sampleRate","enableRemoteConfig"],"sourceRoot":"../../src","sources":["session-replay-config.tsx"],"mappings":";;;;;;AAKO,MAAMA,gBAAgB,GAAG,MAAM;EAClC,OAAO;IACHC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE;EACxB,CAAC;AACL,CAAC;AAAA"}
+{"version":3,"names":["getDefaultConfig","sampleRate","enableRemoteConfig","logLevel","LogLevel","Warn"],"sourceRoot":"../../src","sources":["session-replay-config.tsx"],"mappings":";;;;;;AAAA;AAQO,MAAMA,gBAAgB,GAAG,MAAM;EAClC,OAAO;IACHC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEC,wBAAQ,CAACC;EACvB,CAAC;AACL,CAAC;AAAA"}

package/lib/commonjs/session-replay.js

@@ -7,6 +7,7 @@ exports.SessionReplayPlugin = void 0;
 var _nativeModule = require("./native-module");
 var _version = require("./version");
 var _sessionReplayConfig = require("./session-replay-config");
+var _analyticsTypes = require("@amplitude/analytics-types");
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
 function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
@@ -20,6 +21,7 @@ class SessionReplayPlugin {
     _defineProperty(this, "name", '@amplitude/plugin-session-replay-react-native');
     _defineProperty(this, "type", 'enrichment');
     _defineProperty(this, "config", void 0);
+    _defineProperty(this, "isInitialized", false);
     _defineProperty(this, "sessionReplayConfig", void 0);
     this.sessionReplayConfig = {
       ...(0, _sessionReplayConfig.getDefaultConfig)(),
@@ -30,9 +32,14 @@ class SessionReplayPlugin {
   async setup(config, _) {
     this.config = config;
     console.log(`Installing @amplitude/plugin-session-replay-react-native, version ${_version.VERSION}.`);
-    await _nativeModule.PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true);
+    await _nativeModule.PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true, this.sessionReplayConfig.logLevel ?? _analyticsTypes.LogLevel.Warn);
+    this.isInitialized = true;
   }
   async execute(event) {
+    if (!this.isInitialized) {
+      return Promise.resolve(event);
+    }
+
     // On event, synchronize the session id to the what's on the browserConfig (source of truth)
     // Choosing not to read from event object here, concerned about offline/delayed events messing up the state stored
     // in SR.
@@ -50,15 +57,31 @@ class SessionReplayPlugin {
     }
     return Promise.resolve(event);
   }
+  async start() {
+    if (this.isInitialized) {
+      await _nativeModule.PluginSessionReplayReactNative.start();
+    }
+  }
+  async stop() {
+    if (this.isInitialized) {
+      await _nativeModule.PluginSessionReplayReactNative.stop();
+    }
+  }
   async teardown() {
-    await _nativeModule.PluginSessionReplayReactNative.teardown();
+    if (this.isInitialized) {
+      await _nativeModule.PluginSessionReplayReactNative.teardown();
+    }
     // the following are initialized in setup() which will always be called first
     // here we reset them to null to prevent memory leaks
 
     // @ts-ignore
     this.config = null;
+    this.isInitialized = false;
   }
   async getSessionReplayProperties() {
+    if (!this.isInitialized) {
+      return {};
+    }
     return _nativeModule.PluginSessionReplayReactNative.getSessionReplayProperties();
   }
 }

package/lib/commonjs/session-replay.js.map

@@ -1 +1 @@
-{"version":3,"names":["SessionReplayPlugin","constructor","config","sessionReplayConfig","getDefaultConfig","console","log","setup","_","VERSION","PluginSessionReplayReactNative","apiKey","deviceId","sessionId","sampleRate","enableRemoteConfig","execute","event","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","Promise","resolve","teardown"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AAAgF;AAAA;AAAA;AAEzE,MAAMA,mBAAmB,CAAmE;EAGjG;;EAEA;;EAKAC,WAAW,GAAmC;IAAA,IAAlCC,MAA2B,uEAAG,CAAC,CAAC;IAAA,8BATrC,+CAA+C;IAAA,8BAC/C,YAAY;IAAA;IAAA;IASjB,IAAI,CAACC,mBAAmB,GAAG;MACzB,GAAG,IAAAC,qCAAgB,GAAE;MACrB,GAAGF;IACL,CAAC;IACDG,OAAO,CAACC,GAAG,CAAC,gDAAgD,EAAE,IAAI,CAACH,mBAAmB,CAAC;EACzF;EAEA,MAAMI,KAAK,CAACL,MAAyB,EAAEM,CAAoB,EAAiB;IAC1E,IAAI,CAACN,MAAM,GAAGA,MAAM;IACpBG,OAAO,CAACC,GAAG,CAAE,qEAAoEG,gBAAQ,GAAE,CAAC;IAC5F,MAAMC,4CAA8B,CAACH,KAAK,CACxCL,MAAM,CAACS,MAAM,EACbT,MAAM,CAACU,QAAQ,EACfV,MAAM,CAACW,SAAS,EAChB,IAAI,CAACV,mBAAmB,CAACW,UAAU,IAAI,CAAC,EACxC,IAAI,CAACX,mBAAmB,CAACY,kBAAkB,IAAI,IAAI,CACpD;EACH;EAEA,MAAMC,OAAO,CAACC,KAAY,EAAyB;IACjD;IACA;IACA;IACA,IAAI,IAAI,CAACf,MAAM,CAACW,SAAS,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,MAAM,MAAMH,4CAA8B,CAACQ,YAAY,EAAE,CAAC,EAAE;MAC5G,MAAMR,4CAA8B,CAACS,YAAY,CAAC,IAAI,CAACjB,MAAM,CAACW,SAAS,CAAC;IAC1E;IACA;IACA;IACA,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,KAAKI,KAAK,CAACG,UAAU,EAAE;MACvE,MAAMC,0BAA0B,GAAG,MAAMX,4CAA8B,CAACY,0BAA0B,EAAE;MACpGL,KAAK,CAACM,gBAAgB,GAAG;QACvB,GAAGN,KAAK,CAACM,gBAAgB;QACzB,GAAGF;MACL,CAAC;IACH;IACA,OAAOG,OAAO,CAACC,OAAO,CAACR,KAAK,CAAC;EAC/B;EAEA,MAAMS,QAAQ,GAAkB;IAC9B,MAAMhB,4CAA8B,CAACgB,QAAQ,EAAE;IAC/C;IACA;;IAEA;IACA,IAAI,CAACxB,MAAM,GAAG,IAAI;EACpB;EAEA,MAAMoB,0BAA0B,GAAG;IACjC,OAAOZ,4CAA8B,CAACY,0BAA0B,EAAE;EACpE;AACF;AAAC"}
+{"version":3,"names":["SessionReplayPlugin","constructor","config","sessionReplayConfig","getDefaultConfig","console","log","setup","_","VERSION","PluginSessionReplayReactNative","apiKey","deviceId","sessionId","sampleRate","enableRemoteConfig","logLevel","LogLevel","Warn","isInitialized","execute","event","Promise","resolve","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","start","stop","teardown"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AAAsD;AAAA;AAAA;AAE/C,MAAMA,mBAAmB,CAAmE;EAGjG;;EAEA;;EAMAC,WAAW,GAAmC;IAAA,IAAlCC,MAA2B,uEAAG,CAAC,CAAC;IAAA,8BAVrC,+CAA+C;IAAA,8BAC/C,YAAY;IAAA;IAAA,uCAKH,KAAK;IAAA;IAKnB,IAAI,CAACC,mBAAmB,GAAG;MACzB,GAAG,IAAAC,qCAAgB,GAAE;MACrB,GAAGF;IACL,CAAC;IACDG,OAAO,CAACC,GAAG,CAAC,gDAAgD,EAAE,IAAI,CAACH,mBAAmB,CAAC;EACzF;EAEA,MAAMI,KAAK,CAACL,MAAyB,EAAEM,CAAoB,EAAiB;IAC1E,IAAI,CAACN,MAAM,GAAGA,MAAM;IACpBG,OAAO,CAACC,GAAG,CAAE,qEAAoEG,gBAAQ,GAAE,CAAC;IAC5F,MAAMC,4CAA8B,CAACH,KAAK,CACxCL,MAAM,CAACS,MAAM,EACbT,MAAM,CAACU,QAAQ,EACfV,MAAM,CAACW,SAAS,EAChB,IAAI,CAACV,mBAAmB,CAACW,UAAU,IAAI,CAAC,EACxC,IAAI,CAACX,mBAAmB,CAACY,kBAAkB,IAAI,IAAI,EACnD,IAAI,CAACZ,mBAAmB,CAACa,QAAQ,IAAIC,wBAAQ,CAACC,IAAI,CACnD;IACD,IAAI,CAACC,aAAa,GAAG,IAAI;EAC3B;EAEA,MAAMC,OAAO,CAACC,KAAY,EAAyB;IACjD,IAAI,CAAC,IAAI,CAACF,aAAa,EAAE;MACvB,OAAOG,OAAO,CAACC,OAAO,CAACF,KAAK,CAAC;IAC/B;;IAEA;IACA;IACA;IACA,IAAI,IAAI,CAACnB,MAAM,CAACW,SAAS,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,MAAM,MAAMH,4CAA8B,CAACc,YAAY,EAAE,CAAC,EAAE;MAC5G,MAAMd,4CAA8B,CAACe,YAAY,CAAC,IAAI,CAACvB,MAAM,CAACW,SAAS,CAAC;IAC1E;IACA;IACA;IACA,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,IAAI,IAAI,CAACX,MAAM,CAACW,SAAS,KAAKQ,KAAK,CAACK,UAAU,EAAE;MACvE,MAAMC,0BAA0B,GAAG,MAAMjB,4CAA8B,CAACkB,0BAA0B,EAAE;MACpGP,KAAK,CAACQ,gBAAgB,GAAG;QACvB,GAAGR,KAAK,CAACQ,gBAAgB;QACzB,GAAGF;MACL,CAAC;IACH;IACA,OAAOL,OAAO,CAACC,OAAO,CAACF,KAAK,CAAC;EAC/B;EAEA,MAAMS,KAAK,GAAkB;IAC3B,IAAI,IAAI,CAACX,aAAa,EAAE;MACtB,MAAMT,4CAA8B,CAACoB,KAAK,EAAE;IAC9C;EACF;EAEA,MAAMC,IAAI,GAAkB;IAC1B,IAAI,IAAI,CAACZ,aAAa,EAAE;MACtB,MAAMT,4CAA8B,CAACqB,IAAI,EAAE;IAC7C;EACF;EAEA,MAAMC,QAAQ,GAAkB;IAC9B,IAAI,IAAI,CAACb,aAAa,EAAE;MACtB,MAAMT,4CAA8B,CAACsB,QAAQ,EAAE;IACjD;IACA;IACA;;IAEA;IACA,IAAI,CAAC9B,MAAM,GAAG,IAAI;IAClB,IAAI,CAACiB,aAAa,GAAG,KAAK;EAC5B;EAEA,MAAMS,0BAA0B,GAAG;IACjC,IAAI,CAAC,IAAI,CAACT,aAAa,EAAE;MACvB,OAAO,CAAC,CAAC;IACX;IACA,OAAOT,4CAA8B,CAACkB,0BAA0B,EAAE;EACpE;AACF;AAAC"}

package/lib/commonjs/version.js

@@ -4,6 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.VERSION = void 0;
-const VERSION = '0.2.8';
+const VERSION = '0.3.0';
 exports.VERSION = VERSION;
 //# sourceMappingURL=version.js.map

package/lib/module/session-replay-config.js

@@ -1,7 +1,9 @@
+import { LogLevel } from "@amplitude/analytics-types";
 export const getDefaultConfig = () => {
   return {
     sampleRate: 0,
-    enableRemoteConfig: true
+    enableRemoteConfig: true,
+    logLevel: LogLevel.Warn
   };
 };
 //# sourceMappingURL=session-replay-config.js.map

package/lib/module/session-replay-config.js.map

@@ -1 +1 @@
-{"version":3,"names":["getDefaultConfig","sampleRate","enableRemoteConfig"],"sourceRoot":"../../src","sources":["session-replay-config.tsx"],"mappings":"AAKA,OAAO,MAAMA,gBAAgB,GAAG,MAAM;EAClC,OAAO;IACHC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE;EACxB,CAAC;AACL,CAAC"}
+{"version":3,"names":["LogLevel","getDefaultConfig","sampleRate","enableRemoteConfig","logLevel","Warn"],"sourceRoot":"../../src","sources":["session-replay-config.tsx"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,4BAA4B;AAQrD,OAAO,MAAMC,gBAAgB,GAAG,MAAM;EAClC,OAAO;IACHC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEJ,QAAQ,CAACK;EACvB,CAAC;AACL,CAAC"}

package/lib/module/session-replay.js

@@ -10,6 +10,7 @@ function _toPrimitive(input, hint) { if (typeof input !== "object" || input ===
 import { PluginSessionReplayReactNative } from './native-module';
 import { VERSION } from './version';
 import { getDefaultConfig } from './session-replay-config';
+import { LogLevel } from '@amplitude/analytics-types';
 export class SessionReplayPlugin {
   // this.config is defined in setup() which will always be called first
 
@@ -20,6 +21,7 @@ export class SessionReplayPlugin {
     _defineProperty(this, "name", '@amplitude/plugin-session-replay-react-native');
     _defineProperty(this, "type", 'enrichment');
     _defineProperty(this, "config", void 0);
+    _defineProperty(this, "isInitialized", false);
     _defineProperty(this, "sessionReplayConfig", void 0);
     this.sessionReplayConfig = {
       ...getDefaultConfig(),
@@ -30,9 +32,14 @@ export class SessionReplayPlugin {
   async setup(config, _) {
     this.config = config;
     console.log(`Installing @amplitude/plugin-session-replay-react-native, version ${VERSION}.`);
-    await PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true);
+    await PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true, this.sessionReplayConfig.logLevel ?? LogLevel.Warn);
+    this.isInitialized = true;
   }
   async execute(event) {
+    if (!this.isInitialized) {
+      return Promise.resolve(event);
+    }
+
     // On event, synchronize the session id to the what's on the browserConfig (source of truth)
     // Choosing not to read from event object here, concerned about offline/delayed events messing up the state stored
     // in SR.
@@ -50,15 +57,31 @@ export class SessionReplayPlugin {
     }
     return Promise.resolve(event);
   }
+  async start() {
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.start();
+    }
+  }
+  async stop() {
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.stop();
+    }
+  }
   async teardown() {
-    await PluginSessionReplayReactNative.teardown();
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.teardown();
+    }
     // the following are initialized in setup() which will always be called first
     // here we reset them to null to prevent memory leaks
 
     // @ts-ignore
     this.config = null;
+    this.isInitialized = false;
   }
   async getSessionReplayProperties() {
+    if (!this.isInitialized) {
+      return {};
+    }
     return PluginSessionReplayReactNative.getSessionReplayProperties();
   }
 }

package/lib/module/session-replay.js.map

@@ -1 +1 @@
-{"version":3,"names":["PluginSessionReplayReactNative","VERSION","getDefaultConfig","SessionReplayPlugin","constructor","config","sessionReplayConfig","console","log","setup","_","apiKey","deviceId","sessionId","sampleRate","enableRemoteConfig","execute","event","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","Promise","resolve","teardown"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;;AAGA,SAASA,8BAA8B,QAAQ,iBAAiB;AAChE,SAASC,OAAO,QAAQ,WAAW;AACnC,SAA8BC,gBAAgB,QAAQ,yBAAyB;AAE/E,OAAO,MAAMC,mBAAmB,CAAmE;EAGjG;;EAEA;;EAKAC,WAAW,GAAmC;IAAA,IAAlCC,MAA2B,uEAAG,CAAC,CAAC;IAAA,8BATrC,+CAA+C;IAAA,8BAC/C,YAAY;IAAA;IAAA;IASjB,IAAI,CAACC,mBAAmB,GAAG;MACzB,GAAGJ,gBAAgB,EAAE;MACrB,GAAGG;IACL,CAAC;IACDE,OAAO,CAACC,GAAG,CAAC,gDAAgD,EAAE,IAAI,CAACF,mBAAmB,CAAC;EACzF;EAEA,MAAMG,KAAK,CAACJ,MAAyB,EAAEK,CAAoB,EAAiB;IAC1E,IAAI,CAACL,MAAM,GAAGA,MAAM;IACpBE,OAAO,CAACC,GAAG,CAAE,qEAAoEP,OAAQ,GAAE,CAAC;IAC5F,MAAMD,8BAA8B,CAACS,KAAK,CACxCJ,MAAM,CAACM,MAAM,EACbN,MAAM,CAACO,QAAQ,EACfP,MAAM,CAACQ,SAAS,EAChB,IAAI,CAACP,mBAAmB,CAACQ,UAAU,IAAI,CAAC,EACxC,IAAI,CAACR,mBAAmB,CAACS,kBAAkB,IAAI,IAAI,CACpD;EACH;EAEA,MAAMC,OAAO,CAACC,KAAY,EAAyB;IACjD;IACA;IACA;IACA,IAAI,IAAI,CAACZ,MAAM,CAACQ,SAAS,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,MAAM,MAAMb,8BAA8B,CAACkB,YAAY,EAAE,CAAC,EAAE;MAC5G,MAAMlB,8BAA8B,CAACmB,YAAY,CAAC,IAAI,CAACd,MAAM,CAACQ,SAAS,CAAC;IAC1E;IACA;IACA;IACA,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,KAAKI,KAAK,CAACG,UAAU,EAAE;MACvE,MAAMC,0BAA0B,GAAG,MAAMrB,8BAA8B,CAACsB,0BAA0B,EAAE;MACpGL,KAAK,CAACM,gBAAgB,GAAG;QACvB,GAAGN,KAAK,CAACM,gBAAgB;QACzB,GAAGF;MACL,CAAC;IACH;IACA,OAAOG,OAAO,CAACC,OAAO,CAACR,KAAK,CAAC;EAC/B;EAEA,MAAMS,QAAQ,GAAkB;IAC9B,MAAM1B,8BAA8B,CAAC0B,QAAQ,EAAE;IAC/C;IACA;;IAEA;IACA,IAAI,CAACrB,MAAM,GAAG,IAAI;EACpB;EAEA,MAAMiB,0BAA0B,GAAG;IACjC,OAAOtB,8BAA8B,CAACsB,0BAA0B,EAAE;EACpE;AACF"}
+{"version":3,"names":["PluginSessionReplayReactNative","VERSION","getDefaultConfig","LogLevel","SessionReplayPlugin","constructor","config","sessionReplayConfig","console","log","setup","_","apiKey","deviceId","sessionId","sampleRate","enableRemoteConfig","logLevel","Warn","isInitialized","execute","event","Promise","resolve","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","start","stop","teardown"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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"}

package/lib/module/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.2.8';
+export const VERSION = '0.3.0';
 //# sourceMappingURL=version.js.map

package/lib/typescript/session-replay-config.d.ts

@@ -1,9 +1,12 @@
+import { LogLevel } from "@amplitude/analytics-types";
 export interface SessionReplayConfig {
     sampleRate?: number;
     enableRemoteConfig?: boolean;
+    logLevel?: LogLevel;
 }
 export declare const getDefaultConfig: () => {
     sampleRate: number;
     enableRemoteConfig: boolean;
+    logLevel: LogLevel;
 };
 //# sourceMappingURL=session-replay-config.d.ts.map

package/lib/typescript/session-replay-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay-config.d.ts","sourceRoot":"","sources":["../../src/session-replay-config.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,gBAAgB;;;CAK5B,CAAA"}
+{"version":3,"file":"session-replay-config.d.ts","sourceRoot":"","sources":["../../src/session-replay-config.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,eAAO,MAAM,gBAAgB;;;;CAM5B,CAAA"}

package/lib/typescript/session-replay.d.ts

@@ -4,10 +4,13 @@ export declare class SessionReplayPlugin implements EnrichmentPlugin<ReactNative
     name: string;
     type: "enrichment";
     config: ReactNativeConfig;
+    isInitialized: boolean;
     sessionReplayConfig: SessionReplayConfig;
     constructor(config?: SessionReplayConfig);
     setup(config: ReactNativeConfig, _: ReactNativeClient): Promise<void>;
     execute(event: Event): Promise<Event | null>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
     teardown(): Promise<void>;
     getSessionReplayProperties(): Promise<any>;
 }

package/lib/typescript/session-replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIhH,OAAO,EAAE,mBAAmB,EAAoB,MAAM,yBAAyB,CAAC;AAEhF,qBAAa,mBAAoB,YAAW,gBAAgB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAChG,IAAI,SAAmD;IACvD,IAAI,eAAyB;IAI7B,MAAM,EAAE,iBAAiB,CAAC;IAE1B,mBAAmB,EAAE,mBAAmB,CAAC;gBAE7B,MAAM,GAAE,mBAAwB;IAQtC,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAmB5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IASzB,0BAA0B;CAGjC"}
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAIhH,OAAO,EAAE,mBAAmB,EAAoB,MAAM,yBAAyB,CAAC;AAGhF,qBAAa,mBAAoB,YAAW,gBAAgB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAChG,IAAI,SAAmD;IACvD,IAAI,eAAyB;IAI7B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,UAAS;IAEtB,mBAAmB,EAAE,mBAAmB,CAAC;gBAE7B,MAAM,GAAE,mBAAwB;IAQtC,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAuB5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAYzB,0BAA0B;CAMjC"}

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.8";
+export declare const VERSION = "0.3.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/plugin-session-replay-react-native",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "Amplitude Session Replay plugin for React Native",
   "keywords": [
     "analytics",
@@ -92,5 +92,5 @@
       ]
     ]
   },
-  "gitHead": "e9b1fd973f86c5f262465f2d033b73a742697219"
+  "gitHead": "96fc8d5545967d6c02e4b07e6c0fb26c1a6abf66"
 }

package/src/session-replay-config.tsx

@@ -1,11 +1,15 @@
+import { LogLevel } from "@amplitude/analytics-types";
+
 export interface SessionReplayConfig {
     sampleRate?: number;
     enableRemoteConfig?: boolean;
+    logLevel?: LogLevel;
 }
 
 export const getDefaultConfig = () => {
     return {
         sampleRate: 0,
         enableRemoteConfig: true,
+        logLevel: LogLevel.Warn,
     };
 }

package/src/session-replay.ts

@@ -8,6 +8,7 @@ import type { EnrichmentPlugin, Event, ReactNativeClient, ReactNativeConfig } fr
 import { PluginSessionReplayReactNative } from './native-module';
 import { VERSION } from './version';
 import { SessionReplayConfig, getDefaultConfig } from './session-replay-config';
+import { LogLevel } from '@amplitude/analytics-types';
 
 export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient, ReactNativeConfig> {
   name = '@amplitude/plugin-session-replay-react-native';
@@ -16,6 +17,7 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
 
   // @ts-ignore
   config: ReactNativeConfig;
+  isInitialized = false;
 
   sessionReplayConfig: SessionReplayConfig;
 
@@ -36,10 +38,16 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
       config.sessionId,
       this.sessionReplayConfig.sampleRate ?? 1,
       this.sessionReplayConfig.enableRemoteConfig ?? true,
+      this.sessionReplayConfig.logLevel ?? LogLevel.Warn,
     );
+    this.isInitialized = true;
   }
 
   async execute(event: Event): Promise<Event | null> {
+    if (!this.isInitialized) {
+      return Promise.resolve(event);
+    }
+
     // On event, synchronize the session id to the what's on the browserConfig (source of truth)
     // Choosing not to read from event object here, concerned about offline/delayed events messing up the state stored
     // in SR.
@@ -58,16 +66,34 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
     return Promise.resolve(event);
   }
 
+  async start(): Promise<void> {
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.start();
+    }
+  }
+
+  async stop(): Promise<void> {
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.stop();
+    }
+  }
+
   async teardown(): Promise<void> {
-    await PluginSessionReplayReactNative.teardown();
+    if (this.isInitialized) {
+      await PluginSessionReplayReactNative.teardown();
+    }
     // the following are initialized in setup() which will always be called first
     // here we reset them to null to prevent memory leaks
 
     // @ts-ignore
     this.config = null;
+    this.isInitialized = false;
   }
 
   async getSessionReplayProperties() {
+    if (!this.isInitialized) {
+      return {};
+    }
     return PluginSessionReplayReactNative.getSessionReplayProperties();
   }
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.2.8';
+export const VERSION = '0.3.0';