@amplitude/plugin-session-replay-react-native 0.4.10 → 0.5.0-sr-4646-rc.0

package/README.md

@@ -20,15 +20,35 @@ const config: SessionReplayConfig = {
     enableRemoteConfig: true, // default true
     sampleRate: 1, // default 0
     logLevel: LogLevel.Warn, // default LogLevel.Warn
+    privacyConfig: { maskLevel: 'medium' }, // 'medium' is the default
 };
 await init('YOUR_API_KEY').promise;
 await add(new SessionReplayPlugin(config)).promise;
 
 ```
 
+## Mask levels
+
+Control how aggressively Session Replay masks sensitive content via the `privacyConfig.maskLevel` config option:
+
+| Value | What gets masked |
+|---|---|
+| `'light'` | Password and phone-number `<TextInput>` fields only |
+| `'medium'` (default) | All `<TextInput>` fields |
+| `'conservative'` | All `<TextInput>` fields **and** all `<Text>` elements |
+
+```js
+import { SessionReplayPlugin } from '@amplitude/plugin-session-replay-react-native';
+
+const config: SessionReplayConfig = {
+    privacyConfig: { maskLevel: 'conservative' }, // mask all text and inputs
+};
+```
+
+> **Note:** Third-party text renderers that bypass UIKit/Android's standard text views (for example `react-native-svg`, `@shopify/react-native-skia`) are not detected by automatic masking. Wrap such content in `<AmpMaskView mask="amp-mask">` to mask it manually.
 
 ## Masking views
-To maks certain views, add the `AmpMaskView` tag with the mask property `amp-mask` around the section to be masked
+To mask certain views, add the `AmpMaskView` tag with the mask property `amp-mask` around the section to be masked
 
 ```js
 import { AmpMaskView } from '@amplitude/plugin-session-replay-react-native';

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

@@ -1,6 +1,8 @@
 package com.amplitude.pluginsessionreplayreactnative
 
 import com.amplitude.android.sessionreplay.SessionReplay
+import com.amplitude.android.sessionreplay.config.MaskLevel
+import com.amplitude.android.sessionreplay.config.PrivacyConfig
 import com.amplitude.common.Logger
 import com.amplitude.common.android.LogcatLogger
 import com.amplitude.core.ServerZone
@@ -20,7 +22,7 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
   }
 
   @ReactMethod
-  fun setup(apiKey: String, deviceId: String?, sessionId: Double, serverZone: String?, sampleRate: Double, enableRemoteConfig: Boolean, logLevel: Int, autoStart: Boolean) {
+  fun setup(apiKey: String, deviceId: String?, sessionId: Double, serverZone: String?, sampleRate: Double, enableRemoteConfig: Boolean, logLevel: Int, autoStart: Boolean, maskLevel: String) {
     LogcatLogger.logger.logMode = when (logLevel) {
         0 -> Logger.LogMode.OFF
         1 -> Logger.LogMode.ERROR
@@ -30,6 +32,13 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
         else -> Logger.LogMode.WARN
     }
 
+    val mappedMaskLevel = when (maskLevel.lowercase()) {
+        "light" -> MaskLevel.LIGHT
+        "medium" -> MaskLevel.MEDIUM
+        "conservative" -> MaskLevel.CONSERVATIVE
+        else -> MaskLevel.MEDIUM
+    }
+
     LogcatLogger.logger.debug("""
         setup:
         API Key: $apiKey
@@ -40,6 +49,7 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
         Enable Remote Config: $enableRemoteConfig
         Log Level: $logLevel
         Auto Start: $autoStart
+        Mask Level: $maskLevel
     """.trimIndent())
 
     sessionReplay = SessionReplay(
@@ -54,7 +64,8 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
         "EU" -> ServerZone.EU
         else -> ServerZone.US
       },
-      autoStart = autoStart
+      autoStart = autoStart,
+      privacyConfig = PrivacyConfig(maskLevel = mappedMaskLevel)
     )
   }
 
@@ -87,7 +98,7 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
     }
     promise.resolve(map)
   }
-  
+
   @ReactMethod
   fun start() {
     sessionReplay.start()

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 serverZone:(NSString)serverZone sampleRate:(float)sampleRate enableRemoteConfig:(BOOL)enableRemoteConfig logLevel:(int)logLevel autoStart:(BOOL)autoStart resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(setup:(NSString)apiKey deviceId:(NSString)deviceId sessionId:(nonnull NSNumber)sessionId serverZone:(NSString)serverZone sampleRate:(float)sampleRate enableRemoteConfig:(BOOL)enableRemoteConfig logLevel:(int)logLevel autoStart:(BOOL)autoStart maskLevel:(NSString)maskLevel resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 
 RCT_EXTERN_METHOD(setSessionId:(nonnull NSNumber)sessionId resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
 

package/ios/PluginSessionReplayReactNative.swift

@@ -6,7 +6,7 @@ class PluginSessionReplayReactNative: NSObject {
     
     var sessionReplay: SessionReplay!
     
-    @objc(setup:deviceId:sessionId:serverZone:sampleRate:enableRemoteConfig:logLevel:autoStart:resolve:reject:)
+    @objc(setup:deviceId:sessionId:serverZone:sampleRate:enableRemoteConfig:logLevel:autoStart:maskLevel:resolve:reject:)
     func setup(_ apiKey: String,
                deviceId: String,
                sessionId: NSNumber,
@@ -15,6 +15,7 @@ class PluginSessionReplayReactNative: NSObject {
                enableRemoteConfig: Bool,
                logLevel: Int,
                autoStart: Bool,
+               maskLevel: String,
                resolve: RCTPromiseResolveBlock,
                reject: RCTPromiseRejectBlock) -> Void {
         print(
@@ -28,6 +29,7 @@ class PluginSessionReplayReactNative: NSObject {
             Enable Remote Config: \(enableRemoteConfig)
             Log Level: \(logLevel)
             Auto Start: \(autoStart)
+            Mask Level: \(maskLevel)
             """
         )
         sessionReplay = SessionReplay(apiKey:apiKey,
@@ -36,6 +38,7 @@ class PluginSessionReplayReactNative: NSObject {
                                       sampleRate: sampleRate,
                                       logger:ConsoleLogger(logLevel: logLevel),
                                       serverZone: serverZone == "EU" ? .EU : .US,
+                                      maskLevel: .fromString(maskLevel),
                                       enableRemoteConfig: enableRemoteConfig)
         if (autoStart) {
             sessionReplay.start()
@@ -90,3 +93,18 @@ class PluginSessionReplayReactNative: NSObject {
       resolve(nil)
     }
 }
+
+extension MaskLevel {
+    static func fromString(_ input: String) -> MaskLevel {
+        switch input.lowercased() {
+        case "light":
+            return .light
+        case "medium":
+            return .medium
+        case "conservative":
+            return .conservative
+        default:
+            return .medium
+        }
+    }
+}

package/lib/commonjs/index.js

@@ -9,12 +9,6 @@ Object.defineProperty(exports, "AmpMaskView", {
     return _appMaskView.AmpMaskView;
   }
 });
-Object.defineProperty(exports, "SessionReplayConfig", {
-  enumerable: true,
-  get: function () {
-    return _sessionReplayConfig.SessionReplayConfig;
-  }
-});
 Object.defineProperty(exports, "SessionReplayPlugin", {
   enumerable: true,
   get: function () {
@@ -23,5 +17,4 @@ Object.defineProperty(exports, "SessionReplayPlugin", {
 });
 var _sessionReplay = require("./session-replay");
 var _appMaskView = require("./app-mask-view");
-var _sessionReplayConfig = require("./session-replay-config");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_sessionReplay","require","_appMaskView","_sessionReplayConfig"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAEA,IAAAC,YAAA,GAAAD,OAAA;AAEA,IAAAE,oBAAA,GAAAF,OAAA","ignoreList":[]}
+{"version":3,"names":["_sessionReplay","require","_appMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAGA,IAAAC,YAAA,GAAAD,OAAA","ignoreList":[]}

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

@@ -3,14 +3,52 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "LogLevel", {
+  enumerable: true,
+  get: function () {
+    return _analyticsTypes.LogLevel;
+  }
+});
 exports.getDefaultConfig = void 0;
 var _analyticsTypes = require("@amplitude/analytics-types");
+/**
+ * Masking levels for sensitive content in session replay.
+ *
+ * Declared as a string-literal union (rather than an `enum`) to match the
+ * Session Replay browser SDK and avoid the const-enum inlining pitfalls of
+ * string enums under aggressive compilers. Kept structurally identical to the
+ * standalone `@amplitude/session-replay-react-native` SDK's `MaskLevel` so the
+ * two packages stay in lockstep without coupling the plugin's runtime to the
+ * standalone native module.
+ *
+ * - `light`: mask only inputs that are always sensitive (password, etc.).
+ * - `medium`: mask all `<TextInput>` fields.
+ * - `conservative`: mask all `<TextInput>` fields and all `<Text>` content.
+ */
+
+/**
+ * Configuration for the Session Replay React Native plugin.
+ *
+ * Unlike the standalone `@amplitude/session-replay-react-native` SDK, the
+ * plugin auto-sources `apiKey`, `deviceId`, `sessionId`, and `serverZone`
+ * from the analytics client's `ReactNativeConfig` at `setup()` time, so
+ * those fields are intentionally absent from the public plugin config.
+ * The plugin also never shipped a deprecated top-level `maskLevel`, so no
+ * input-boundary normalization (and no `SessionReplayConfigInternal` alias)
+ * is needed here.
+ */
+
 const getDefaultConfig = () => {
   return {
-    sampleRate: 0,
+    autoStart: true,
     enableRemoteConfig: true,
     logLevel: _analyticsTypes.LogLevel.Warn,
-    autoStart: true
+    // Intentionally left without a `maskLevel`: the effective default
+    // (`'medium'`) is resolved once at the native boundary in `setup()`.
+    // Baking it in here would make a partial user `privacyConfig` (e.g. `{}`)
+    // unable to fall through to the `?? 'medium'` resolution.
+    privacyConfig: {},
+    sampleRate: 0
   };
 };
 exports.getDefaultConfig = getDefaultConfig;

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

@@ -1 +1 @@
-{"version":3,"names":["_analyticsTypes","require","getDefaultConfig","sampleRate","enableRemoteConfig","logLevel","LogLevel","Warn","autoStart","exports"],"sourceRoot":"../../src","sources":["session-replay-config.ts"],"mappings":";;;;;;AAAA,IAAAA,eAAA,GAAAC,OAAA;AASO,MAAMC,gBAA2C,GAAGA,CAAA,KAAM;EAC/D,OAAO;IACLC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEC,wBAAQ,CAACC,IAAI;IACvBC,SAAS,EAAE;EACb,CAAC;AACH,CAAC;AAACC,OAAA,CAAAP,gBAAA,GAAAA,gBAAA","ignoreList":[]}
+{"version":3,"names":["_analyticsTypes","require","getDefaultConfig","autoStart","enableRemoteConfig","logLevel","LogLevel","Warn","privacyConfig","sampleRate","exports"],"sourceRoot":"../../src","sources":["session-replay-config.ts"],"mappings":";;;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmCO,MAAMC,gBAAqD,GAAGA,CAAA,KAAM;EACzE,OAAO;IACLC,SAAS,EAAE,IAAI;IACfC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEC,wBAAQ,CAACC,IAAI;IACvB;IACA;IACA;IACA;IACAC,aAAa,EAAE,CAAC,CAAC;IACjBC,UAAU,EAAE;EACd,CAAC;AACH,CAAC;AAACC,OAAA,CAAAR,gBAAA,GAAAA,gBAAA","ignoreList":[]}

package/lib/commonjs/session-replay.js

@@ -7,7 +7,6 @@ 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");
 /* eslint-disable @typescript-eslint/no-unsafe-call */
 /* eslint-disable @typescript-eslint/no-unsafe-member-access */
 /* eslint-disable @typescript-eslint/no-unsafe-assignment */
@@ -32,7 +31,17 @@ 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, config.serverZone, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true, this.sessionReplayConfig.logLevel ?? _analyticsTypes.LogLevel.Warn, this.sessionReplayConfig.autoStart ?? true);
+    // `apiKey`, `deviceId`, `sessionId`, and `serverZone` are sourced from the
+    // analytics client's `ReactNativeConfig` because the plugin runs inside an
+    // initialized Amplitude SDK and inherits identity from it.
+    // Resolve the effective mask level here — the single source of truth for
+    // the default. `privacyConfig.maskLevel` can be `undefined` when a partial
+    // `privacyConfig` (e.g. `{}`) is supplied, so fall back to `'medium'` rather
+    // than forwarding `undefined` across the native bridge.
+    const resolvedMaskLevel = this.sessionReplayConfig.privacyConfig.maskLevel ?? 'medium';
+    await _nativeModule.PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, config.serverZone, this.sessionReplayConfig.sampleRate, this.sessionReplayConfig.enableRemoteConfig, this.sessionReplayConfig.logLevel, this.sessionReplayConfig.autoStart,
+    // TODO(SDKRN-15): Migrate native bridge to accept the full privacyConfig object instead of a flat maskLevel string.
+    resolvedMaskLevel);
     this.isInitialized = true;
   }
   async execute(event) {

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

@@ -1 +1 @@
-{"version":3,"names":["_nativeModule","require","_version","_sessionReplayConfig","_analyticsTypes","SessionReplayPlugin","name","type","isInitialized","constructor","config","sessionReplayConfig","getDefaultConfig","console","log","setup","_","VERSION","PluginSessionReplayReactNative","apiKey","deviceId","sessionId","serverZone","sampleRate","enableRemoteConfig","logLevel","LogLevel","Warn","autoStart","execute","event","Promise","resolve","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","start","stop","teardown","exports"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_nativeModule","require","_version","_sessionReplayConfig","SessionReplayPlugin","name","type","isInitialized","constructor","config","sessionReplayConfig","getDefaultConfig","console","log","setup","_","VERSION","resolvedMaskLevel","privacyConfig","maskLevel","PluginSessionReplayReactNative","apiKey","deviceId","sessionId","serverZone","sampleRate","enableRemoteConfig","logLevel","autoStart","execute","event","Promise","resolve","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","start","stop","teardown","exports"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/version.js

@@ -4,5 +4,5 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.VERSION = void 0;
-const VERSION = exports.VERSION = '0.4.10';
+const VERSION = exports.VERSION = '0.5.0-sr-4646-rc.0';
 //# sourceMappingURL=version.js.map

package/lib/commonjs/version.js.map

@@ -1 +1 @@
-{"version":3,"names":["VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,QAAQ","ignoreList":[]}
+{"version":3,"names":["VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,oBAAoB","ignoreList":[]}

package/lib/module/index.js

@@ -1,4 +1,3 @@
 export { SessionReplayPlugin } from './session-replay';
 export { AmpMaskView } from './app-mask-view';
-export { SessionReplayConfig } from './session-replay-config';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["SessionReplayPlugin","AmpMaskView","SessionReplayConfig"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,kBAAkB;AAEtD,SAASC,WAAW,QAAQ,iBAAiB;AAE7C,SAASC,mBAAmB,QAAQ,yBAAyB","ignoreList":[]}
+{"version":3,"names":["SessionReplayPlugin","AmpMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,kBAAkB;AAGtD,SAASC,WAAW,QAAQ,iBAAiB","ignoreList":[]}

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

@@ -1,10 +1,44 @@
 import { LogLevel } from '@amplitude/analytics-types';
+
+/**
+ * Masking levels for sensitive content in session replay.
+ *
+ * Declared as a string-literal union (rather than an `enum`) to match the
+ * Session Replay browser SDK and avoid the const-enum inlining pitfalls of
+ * string enums under aggressive compilers. Kept structurally identical to the
+ * standalone `@amplitude/session-replay-react-native` SDK's `MaskLevel` so the
+ * two packages stay in lockstep without coupling the plugin's runtime to the
+ * standalone native module.
+ *
+ * - `light`: mask only inputs that are always sensitive (password, etc.).
+ * - `medium`: mask all `<TextInput>` fields.
+ * - `conservative`: mask all `<TextInput>` fields and all `<Text>` content.
+ */
+
+/**
+ * Configuration for the Session Replay React Native plugin.
+ *
+ * Unlike the standalone `@amplitude/session-replay-react-native` SDK, the
+ * plugin auto-sources `apiKey`, `deviceId`, `sessionId`, and `serverZone`
+ * from the analytics client's `ReactNativeConfig` at `setup()` time, so
+ * those fields are intentionally absent from the public plugin config.
+ * The plugin also never shipped a deprecated top-level `maskLevel`, so no
+ * input-boundary normalization (and no `SessionReplayConfigInternal` alias)
+ * is needed here.
+ */
+
 export const getDefaultConfig = () => {
   return {
-    sampleRate: 0,
+    autoStart: true,
     enableRemoteConfig: true,
     logLevel: LogLevel.Warn,
-    autoStart: true
+    // Intentionally left without a `maskLevel`: the effective default
+    // (`'medium'`) is resolved once at the native boundary in `setup()`.
+    // Baking it in here would make a partial user `privacyConfig` (e.g. `{}`)
+    // unable to fall through to the `?? 'medium'` resolution.
+    privacyConfig: {},
+    sampleRate: 0
   };
 };
+export { LogLevel };
 //# sourceMappingURL=session-replay-config.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["LogLevel","getDefaultConfig","sampleRate","enableRemoteConfig","logLevel","Warn","autoStart"],"sourceRoot":"../../src","sources":["session-replay-config.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,4BAA4B;AASrD,OAAO,MAAMC,gBAA2C,GAAGA,CAAA,KAAM;EAC/D,OAAO;IACLC,UAAU,EAAE,CAAC;IACbC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEJ,QAAQ,CAACK,IAAI;IACvBC,SAAS,EAAE;EACb,CAAC;AACH,CAAC","ignoreList":[]}
+{"version":3,"names":["LogLevel","getDefaultConfig","autoStart","enableRemoteConfig","logLevel","Warn","privacyConfig","sampleRate"],"sourceRoot":"../../src","sources":["session-replay-config.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,4BAA4B;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmCA,OAAO,MAAMC,gBAAqD,GAAGA,CAAA,KAAM;EACzE,OAAO;IACLC,SAAS,EAAE,IAAI;IACfC,kBAAkB,EAAE,IAAI;IACxBC,QAAQ,EAAEJ,QAAQ,CAACK,IAAI;IACvB;IACA;IACA;IACA;IACAC,aAAa,EAAE,CAAC,CAAC;IACjBC,UAAU,EAAE;EACd,CAAC;AACH,CAAC;AACD,SAASP,QAAQ","ignoreList":[]}

package/lib/module/session-replay.js

@@ -7,7 +7,6 @@
 import { PluginSessionReplayReactNative } from './native-module';
 import { VERSION } from './version';
 import { getDefaultConfig } from './session-replay-config';
-import { LogLevel } from '@amplitude/analytics-types';
 export class SessionReplayPlugin {
   name = '@amplitude/plugin-session-replay-react-native';
   type = 'enrichment';
@@ -26,7 +25,17 @@ 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, config.serverZone, this.sessionReplayConfig.sampleRate ?? 1, this.sessionReplayConfig.enableRemoteConfig ?? true, this.sessionReplayConfig.logLevel ?? LogLevel.Warn, this.sessionReplayConfig.autoStart ?? true);
+    // `apiKey`, `deviceId`, `sessionId`, and `serverZone` are sourced from the
+    // analytics client's `ReactNativeConfig` because the plugin runs inside an
+    // initialized Amplitude SDK and inherits identity from it.
+    // Resolve the effective mask level here — the single source of truth for
+    // the default. `privacyConfig.maskLevel` can be `undefined` when a partial
+    // `privacyConfig` (e.g. `{}`) is supplied, so fall back to `'medium'` rather
+    // than forwarding `undefined` across the native bridge.
+    const resolvedMaskLevel = this.sessionReplayConfig.privacyConfig.maskLevel ?? 'medium';
+    await PluginSessionReplayReactNative.setup(config.apiKey, config.deviceId, config.sessionId, config.serverZone, this.sessionReplayConfig.sampleRate, this.sessionReplayConfig.enableRemoteConfig, this.sessionReplayConfig.logLevel, this.sessionReplayConfig.autoStart,
+    // TODO(SDKRN-15): Migrate native bridge to accept the full privacyConfig object instead of a flat maskLevel string.
+    resolvedMaskLevel);
     this.isInitialized = true;
   }
   async execute(event) {

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

@@ -1 +1 @@
-{"version":3,"names":["PluginSessionReplayReactNative","VERSION","getDefaultConfig","LogLevel","SessionReplayPlugin","name","type","isInitialized","constructor","config","sessionReplayConfig","console","log","setup","_","apiKey","deviceId","sessionId","serverZone","sampleRate","enableRemoteConfig","logLevel","Warn","autoStart","execute","event","Promise","resolve","getSessionId","setSessionId","session_id","sessionRecordingProperties","getSessionReplayProperties","event_properties","start","stop","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;AAC/E,SAASC,QAAQ,QAAQ,4BAA4B;AAErD,OAAO,MAAMC,mBAAmB,CAAmE;EACjGC,IAAI,GAAG,+CAA+C;EACtDC,IAAI,GAAG,YAAY;EACnB;;EAEA;;EAEAC,aAAa,GAAG,KAAK;EAIrBC,WAAWA,CAACC,MAA2B,GAAG,CAAC,CAAC,EAAE;IAC5C,IAAI,CAACC,mBAAmB,GAAG;MACzB,GAAGR,gBAAgB,CAAC,CAAC;MACrB,GAAGO;IACL,CAAC;IACDE,OAAO,CAACC,GAAG,CAAC,gDAAgD,EAAE,IAAI,CAACF,mBAAmB,CAAC;EACzF;EAEA,MAAMG,KAAKA,CAACJ,MAAyB,EAAEK,CAAoB,EAAiB;IAC1E,IAAI,CAACL,MAAM,GAAGA,MAAM;IACpBE,OAAO,CAACC,GAAG,CAAC,qEAAqEX,OAAO,GAAG,CAAC;IAC5F,MAAMD,8BAA8B,CAACa,KAAK,CACxCJ,MAAM,CAACM,MAAM,EACbN,MAAM,CAACO,QAAQ,EACfP,MAAM,CAACQ,SAAS,EAChBR,MAAM,CAACS,UAAU,EACjB,IAAI,CAACR,mBAAmB,CAACS,UAAU,IAAI,CAAC,EACxC,IAAI,CAACT,mBAAmB,CAACU,kBAAkB,IAAI,IAAI,EACnD,IAAI,CAACV,mBAAmB,CAACW,QAAQ,IAAIlB,QAAQ,CAACmB,IAAI,EAClD,IAAI,CAACZ,mBAAmB,CAACa,SAAS,IAAI,IACxC,CAAC;IACD,IAAI,CAAChB,aAAa,GAAG,IAAI;EAC3B;EAEA,MAAMiB,OAAOA,CAACC,KAAY,EAAyB;IACjD,IAAI,CAAC,IAAI,CAAClB,aAAa,EAAE;MACvB,OAAOmB,OAAO,CAACC,OAAO,CAACF,KAAK,CAAC;IAC/B;;IAEA;IACA;IACA;IACA,IAAI,IAAI,CAAChB,MAAM,CAACQ,SAAS,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,MAAM,MAAMjB,8BAA8B,CAAC4B,YAAY,CAAC,CAAC,CAAC,EAAE;MAC5G,MAAM5B,8BAA8B,CAAC6B,YAAY,CAAC,IAAI,CAACpB,MAAM,CAACQ,SAAS,CAAC;IAC1E;IACA;IACA;IACA,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,IAAI,IAAI,CAACR,MAAM,CAACQ,SAAS,KAAKQ,KAAK,CAACK,UAAU,EAAE;MACvE,MAAMC,0BAA0B,GAAG,MAAM/B,8BAA8B,CAACgC,0BAA0B,CAAC,CAAC;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,KAAKA,CAAA,EAAkB;IAC3B,IAAI,IAAI,CAAC3B,aAAa,EAAE;MACtB,MAAMP,8BAA8B,CAACkC,KAAK,CAAC,CAAC;IAC9C;EACF;EAEA,MAAMC,IAAIA,CAAA,EAAkB;IAC1B,IAAI,IAAI,CAAC5B,aAAa,EAAE;MACtB,MAAMP,8BAA8B,CAACmC,IAAI,CAAC,CAAC;IAC7C;EACF;EAEA,MAAMC,QAAQA,CAAA,EAAkB;IAC9B,IAAI,IAAI,CAAC7B,aAAa,EAAE;MACtB,MAAMP,8BAA8B,CAACoC,QAAQ,CAAC,CAAC;IACjD;IACA;IACA;;IAEA;IACA,IAAI,CAAC3B,MAAM,GAAG,IAAI;IAClB,IAAI,CAACF,aAAa,GAAG,KAAK;EAC5B;EAEA,MAAMyB,0BAA0BA,CAAA,EAAG;IACjC,IAAI,CAAC,IAAI,CAACzB,aAAa,EAAE;MACvB,OAAO,CAAC,CAAC;IACX;IACA,OAAOP,8BAA8B,CAACgC,0BAA0B,CAAC,CAAC;EACpE;AACF","ignoreList":[]}
+{"version":3,"names":["PluginSessionReplayReactNative","VERSION","getDefaultConfig","SessionReplayPlugin","name","type","isInitialized","constructor","config","sessionReplayConfig","console","log","setup","_","resolvedMaskLevel","privacyConfig","maskLevel","apiKey","deviceId","sessionId","serverZone","sampleRate","enableRemoteConfig","logLevel","autoStart","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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","ignoreList":[]}

package/lib/module/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.4.10';
+export const VERSION = '0.5.0-sr-4646-rc.0';
 //# sourceMappingURL=version.js.map

package/lib/module/version.js.map

@@ -1 +1 @@
-{"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,QAAQ","ignoreList":[]}
+{"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,oBAAoB","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -1,4 +1,4 @@
 export { SessionReplayPlugin } from './session-replay';
+export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
 export { AmpMaskView } from './app-mask-view';
-export { SessionReplayConfig } from './session-replay-config';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,9 +1,62 @@
 import { LogLevel } from '@amplitude/analytics-types';
+/**
+ * Masking levels for sensitive content in session replay.
+ *
+ * Declared as a string-literal union (rather than an `enum`) to match the
+ * Session Replay browser SDK and avoid the const-enum inlining pitfalls of
+ * string enums under aggressive compilers. Kept structurally identical to the
+ * standalone `@amplitude/session-replay-react-native` SDK's `MaskLevel` so the
+ * two packages stay in lockstep without coupling the plugin's runtime to the
+ * standalone native module.
+ *
+ * - `light`: mask only inputs that are always sensitive (password, etc.).
+ * - `medium`: mask all `<TextInput>` fields.
+ * - `conservative`: mask all `<TextInput>` fields and all `<Text>` content.
+ */
+export type MaskLevel = 'light' | 'medium' | 'conservative';
+export interface PrivacyConfig {
+    maskLevel?: MaskLevel;
+}
+/**
+ * Configuration for the Session Replay React Native plugin.
+ *
+ * Unlike the standalone `@amplitude/session-replay-react-native` SDK, the
+ * plugin auto-sources `apiKey`, `deviceId`, `sessionId`, and `serverZone`
+ * from the analytics client's `ReactNativeConfig` at `setup()` time, so
+ * those fields are intentionally absent from the public plugin config.
+ * The plugin also never shipped a deprecated top-level `maskLevel`, so no
+ * input-boundary normalization (and no `SessionReplayConfigInternal` alias)
+ * is needed here.
+ */
 export interface SessionReplayConfig {
-    sampleRate?: number;
+    /**
+     * Whether to automatically start recording when the plugin is added
+     * @default true
+     */
+    autoStart?: boolean;
+    /**
+     * Whether to enable remote configuration
+     * @default true
+     */
     enableRemoteConfig?: boolean;
+    /**
+     * Log level for the SDK
+     * @default LogLevel.Warn
+     */
     logLevel?: LogLevel;
-    autoStart?: boolean;
+    /**
+     * Privacy configuration for session replay.
+     * When `maskLevel` is omitted it resolves to `'medium'` at the native boundary.
+     * @default {}
+     */
+    privacyConfig?: PrivacyConfig;
+    /**
+     * Sample rate for session replay (0.0 to 1.0)
+     * Determines what percentage of sessions will be recorded
+     * @default 0
+     */
+    sampleRate?: number;
 }
-export declare const getDefaultConfig: () => SessionReplayConfig;
+export declare const getDefaultConfig: () => Required<SessionReplayConfig>;
+export { 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.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,mBAOpC,CAAC"}
+{"version":3,"file":"session-replay-config.d.ts","sourceRoot":"","sources":["../../src/session-replay-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,QAAQ,CAAC,mBAAmB,CAYhE,CAAC;AACF,OAAO,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -1,11 +1,12 @@
 import type { EnrichmentPlugin, Event, ReactNativeClient, ReactNativeConfig } from '@amplitude/analytics-types';
 import { SessionReplayConfig } from './session-replay-config';
+type ResolvedSessionReplayConfig = Required<SessionReplayConfig>;
 export declare class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient, ReactNativeConfig> {
     name: string;
     type: "enrichment";
     config: ReactNativeConfig;
     isInitialized: boolean;
-    sessionReplayConfig: SessionReplayConfig;
+    sessionReplayConfig: ResolvedSessionReplayConfig;
     constructor(config?: SessionReplayConfig);
     setup(config: ReactNativeConfig, _: ReactNativeClient): Promise<void>;
     execute(event: Event): Promise<Event | null>;
@@ -14,4 +15,5 @@ export declare class SessionReplayPlugin implements EnrichmentPlugin<ReactNative
     teardown(): Promise<void>;
     getSessionReplayProperties(): Promise<any>;
 }
+export {};
 //# sourceMappingURL=session-replay.d.ts.map

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;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;IAgBrE,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"}
+{"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,KAAK,2BAA2B,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAEjE,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,2BAA2B,CAAC;gBAErC,MAAM,GAAE,mBAAwB;IAQtC,KAAK,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrE,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.4.10";
+export declare const VERSION = "0.5.0-sr-4646-rc.0";
 //# sourceMappingURL=version.d.ts.map

package/lib/typescript/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/plugin-session-replay-react-native",
-  "version": "0.4.10",
+  "version": "0.5.0-sr-4646-rc.0",
   "description": "Amplitude Session Replay plugin for React Native",
   "keywords": [
     "analytics",

package/src/index.tsx

@@ -1,5 +1,4 @@
 export { SessionReplayPlugin } from './session-replay';
+export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
 
 export { AmpMaskView } from './app-mask-view';
-
-export { SessionReplayConfig } from './session-replay-config';

package/src/session-replay-config.ts

@@ -1,17 +1,81 @@
 import { LogLevel } from '@amplitude/analytics-types';
 
+/**
+ * Masking levels for sensitive content in session replay.
+ *
+ * Declared as a string-literal union (rather than an `enum`) to match the
+ * Session Replay browser SDK and avoid the const-enum inlining pitfalls of
+ * string enums under aggressive compilers. Kept structurally identical to the
+ * standalone `@amplitude/session-replay-react-native` SDK's `MaskLevel` so the
+ * two packages stay in lockstep without coupling the plugin's runtime to the
+ * standalone native module.
+ *
+ * - `light`: mask only inputs that are always sensitive (password, etc.).
+ * - `medium`: mask all `<TextInput>` fields.
+ * - `conservative`: mask all `<TextInput>` fields and all `<Text>` content.
+ */
+export type MaskLevel = 'light' | 'medium' | 'conservative';
+
+export interface PrivacyConfig {
+  maskLevel?: MaskLevel;
+}
+
+/**
+ * Configuration for the Session Replay React Native plugin.
+ *
+ * Unlike the standalone `@amplitude/session-replay-react-native` SDK, the
+ * plugin auto-sources `apiKey`, `deviceId`, `sessionId`, and `serverZone`
+ * from the analytics client's `ReactNativeConfig` at `setup()` time, so
+ * those fields are intentionally absent from the public plugin config.
+ * The plugin also never shipped a deprecated top-level `maskLevel`, so no
+ * input-boundary normalization (and no `SessionReplayConfigInternal` alias)
+ * is needed here.
+ */
 export interface SessionReplayConfig {
-  sampleRate?: number;
+  /**
+   * Whether to automatically start recording when the plugin is added
+   * @default true
+   */
+  autoStart?: boolean;
+
+  /**
+   * Whether to enable remote configuration
+   * @default true
+   */
   enableRemoteConfig?: boolean;
+
+  /**
+   * Log level for the SDK
+   * @default LogLevel.Warn
+   */
   logLevel?: LogLevel;
-  autoStart?: boolean;
+
+  /**
+   * Privacy configuration for session replay.
+   * When `maskLevel` is omitted it resolves to `'medium'` at the native boundary.
+   * @default {}
+   */
+  privacyConfig?: PrivacyConfig;
+
+  /**
+   * Sample rate for session replay (0.0 to 1.0)
+   * Determines what percentage of sessions will be recorded
+   * @default 0
+   */
+  sampleRate?: number;
 }
 
-export const getDefaultConfig: () => SessionReplayConfig = () => {
+export const getDefaultConfig: () => Required<SessionReplayConfig> = () => {
   return {
-    sampleRate: 0,
+    autoStart: true,
     enableRemoteConfig: true,
     logLevel: LogLevel.Warn,
-    autoStart: true,
+    // Intentionally left without a `maskLevel`: the effective default
+    // (`'medium'`) is resolved once at the native boundary in `setup()`.
+    // Baking it in here would make a partial user `privacyConfig` (e.g. `{}`)
+    // unable to fall through to the `?? 'medium'` resolution.
+    privacyConfig: {},
+    sampleRate: 0,
   };
 };
+export { LogLevel };

package/src/session-replay.ts

@@ -8,7 +8,8 @@ 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';
+
+type ResolvedSessionReplayConfig = Required<SessionReplayConfig>;
 
 export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient, ReactNativeConfig> {
   name = '@amplitude/plugin-session-replay-react-native';
@@ -19,7 +20,7 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
   config: ReactNativeConfig;
   isInitialized = false;
 
-  sessionReplayConfig: SessionReplayConfig;
+  sessionReplayConfig: ResolvedSessionReplayConfig;
 
   constructor(config: SessionReplayConfig = {}) {
     this.sessionReplayConfig = {
@@ -32,15 +33,25 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
   async setup(config: ReactNativeConfig, _: ReactNativeClient): Promise<void> {
     this.config = config;
     console.log(`Installing @amplitude/plugin-session-replay-react-native, version ${VERSION}.`);
+    // `apiKey`, `deviceId`, `sessionId`, and `serverZone` are sourced from the
+    // analytics client's `ReactNativeConfig` because the plugin runs inside an
+    // initialized Amplitude SDK and inherits identity from it.
+    // Resolve the effective mask level here — the single source of truth for
+    // the default. `privacyConfig.maskLevel` can be `undefined` when a partial
+    // `privacyConfig` (e.g. `{}`) is supplied, so fall back to `'medium'` rather
+    // than forwarding `undefined` across the native bridge.
+    const resolvedMaskLevel = this.sessionReplayConfig.privacyConfig.maskLevel ?? 'medium';
     await PluginSessionReplayReactNative.setup(
       config.apiKey,
       config.deviceId,
       config.sessionId,
       config.serverZone,
-      this.sessionReplayConfig.sampleRate ?? 1,
-      this.sessionReplayConfig.enableRemoteConfig ?? true,
-      this.sessionReplayConfig.logLevel ?? LogLevel.Warn,
-      this.sessionReplayConfig.autoStart ?? true,
+      this.sessionReplayConfig.sampleRate,
+      this.sessionReplayConfig.enableRemoteConfig,
+      this.sessionReplayConfig.logLevel,
+      this.sessionReplayConfig.autoStart,
+      // TODO(SDKRN-15): Migrate native bridge to accept the full privacyConfig object instead of a flat maskLevel string.
+      resolvedMaskLevel,
     );
     this.isInitialized = true;
   }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.4.10';
+export const VERSION = '0.5.0-sr-4646-rc.0';