@amplitude/plugin-session-replay-react-native 0.5.14-claudeconfident-mccarthy-373nfy.0 → 0.5.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -27,6 +27,17 @@ await add(new SessionReplayPlugin(config)).promise;
27
27
 
28
28
  ```
29
29
 
30
+ ## Recording status
31
+
32
+ `isRecording()` returns a `Promise<boolean>`. Await it to check whether native Replay
33
+ is recording and providing UI-change signals:
34
+
35
+ ```js
36
+ import { isRecording } from '@amplitude/plugin-session-replay-react-native';
37
+
38
+ const recording = await isRecording();
39
+ ```
40
+
30
41
  ## Mask levels
31
42
 
32
43
  Control how aggressively Session Replay masks sensitive content via the `privacyConfig.maskLevel` config option:
@@ -98,4 +109,20 @@ Web views are blocked by default and will not be tracked. If you'd like webviews
98
109
  <AmpMaskView mask="amp-unmask" style={{ flex: 1 }}>
99
110
  <WebView source={{ uri: 'https://reactnative.dev/' }} style={{ flex: 1 }} />
100
111
  </AmpMaskView>
101
- ```
112
+ ```
113
+
114
+
115
+ ## UI change timestamps
116
+
117
+ `addUiChangeListener` passes the UI change time as milliseconds since the Unix epoch:
118
+
119
+ ```typescript
120
+ const unsubscribe = addUiChangeListener((timestamp) => {
121
+ console.log('UI changed at', new Date(timestamp));
122
+ });
123
+ ```
124
+
125
+ Existing callbacks that take no arguments continue to work. On iOS, the timestamp
126
+ comes from Session Replay's interface signal. On Android, it records when the
127
+ native SDK invokes its UI-change callback. Older native binaries without a timestamp
128
+ fall back to the time JavaScript receives the notification.
@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
16
16
 
17
17
  s.source_files = "ios/**/*.{h,m,mm,swift}"
18
18
 
19
- s.dependency 'AmplitudeSessionReplay', '>=0.11.1'
19
+ s.dependency 'AmplitudeSessionReplay', '>=0.16.1'
20
20
 
21
21
  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
22
22
  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
@@ -10,19 +10,42 @@ import com.facebook.react.bridge.ReactApplicationContext
10
10
  import com.facebook.react.bridge.ReactContextBaseJavaModule
11
11
  import com.facebook.react.bridge.ReactMethod
12
12
  import com.facebook.react.bridge.Promise
13
+ import com.facebook.react.bridge.Arguments
13
14
  import com.facebook.react.bridge.WritableMap
14
15
  import com.facebook.react.bridge.WritableNativeMap
16
+ import com.facebook.react.modules.core.DeviceEventManagerModule
15
17
 
16
18
  class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplicationContext) :
17
19
  ReactContextBaseJavaModule(reactContext) {
20
+ // SDK calls can synchronously emit UI changes, so use a separate lifecycle lock.
21
+ private val lifecycleLock = Any()
18
22
  private lateinit var sessionReplay: SessionReplay
23
+ @Volatile private var recordingRequested = false
24
+ @Volatile private var invalidated = false
25
+ @Volatile private var uiChangeReceiver: Any? = null
26
+ private var listenerCount = 0
27
+
28
+ private fun emitUiChange(receiver: Any) {
29
+ val timestamp = System.currentTimeMillis().toDouble()
30
+ synchronized(this) {
31
+ if (listenerCount == 0 || uiChangeReceiver !== receiver || invalidated || !recordingRequested ||
32
+ !reactContext.hasActiveReactInstance()) return
33
+ try {
34
+ val signal = Arguments.createMap().apply { putDouble("timestamp", timestamp) }
35
+ reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
36
+ .emit("amplitudeSessionReplayUiChange", signal)
37
+ } catch (_: RuntimeException) {
38
+ // The React instance can be destroyed between the check and the emission.
39
+ }
40
+ }
41
+ }
19
42
 
20
43
  override fun getName(): String {
21
44
  return "PluginSessionReplayReactNative"
22
45
  }
23
46
 
24
47
  @ReactMethod
25
- fun setup(apiKey: String, deviceId: String?, sessionId: Double, serverZone: String?, sampleRate: Double, enableRemoteConfig: Boolean, logLevel: Int, autoStart: Boolean, maskLevel: String) {
48
+ fun setup(apiKey: String, deviceId: String?, sessionId: Double, serverZone: String?, sampleRate: Double, enableRemoteConfig: Boolean, logLevel: Int, autoStart: Boolean, maskLevel: String) = synchronized(lifecycleLock) {
26
49
  LogcatLogger.logger.logMode = when (logLevel) {
27
50
  0 -> Logger.LogMode.OFF
28
51
  1 -> Logger.LogMode.ERROR
@@ -52,7 +75,11 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
52
75
  Mask Level: $maskLevel
53
76
  """.trimIndent())
54
77
 
55
- sessionReplay = SessionReplay(
78
+ if (invalidated) return@synchronized
79
+ val receiver = Any()
80
+ // Construct without capturing so a failed replacement leaves the current
81
+ // recorder and its UI-change receiver untouched.
82
+ val nextSessionReplay = SessionReplay(
56
83
  apiKey,
57
84
  reactContext.applicationContext,
58
85
  deviceId ?: "",
@@ -64,9 +91,37 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
64
91
  "EU" -> ServerZone.EU
65
92
  else -> ServerZone.US
66
93
  },
67
- autoStart = autoStart,
68
- privacyConfig = PrivacyConfig(maskLevel = mappedMaskLevel)
94
+ autoStart = false,
95
+ privacyConfig = PrivacyConfig(maskLevel = mappedMaskLevel),
96
+ uiChangeCallback = { emitUiChange(receiver) }
69
97
  )
98
+ val previousSessionReplay = if (::sessionReplay.isInitialized) sessionReplay else null
99
+ synchronized(this) {
100
+ uiChangeReceiver = receiver
101
+ recordingRequested = false
102
+ }
103
+ sessionReplay = nextSessionReplay
104
+ previousSessionReplay?.shutdown()
105
+ if (autoStart) start()
106
+ }
107
+
108
+ @ReactMethod
109
+ fun isRecording(promise: Promise) {
110
+ promise.resolve(!invalidated && recordingRequested && ::sessionReplay.isInitialized && sessionReplay.shouldRecord())
111
+ }
112
+
113
+ @ReactMethod
114
+ fun addListener(eventName: String) {
115
+ synchronized(this) {
116
+ if (!invalidated) listenerCount++
117
+ }
118
+ }
119
+
120
+ @ReactMethod
121
+ fun removeListeners(count: Double) {
122
+ synchronized(this) {
123
+ listenerCount = (listenerCount - count.toInt().coerceAtLeast(0)).coerceAtLeast(0)
124
+ }
70
125
  }
71
126
 
72
127
  @ReactMethod
@@ -100,12 +155,26 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
100
155
  }
101
156
 
102
157
  @ReactMethod
103
- fun start() {
104
- sessionReplay.start()
158
+ fun start() = synchronized(lifecycleLock) {
159
+ if (invalidated) return@synchronized
160
+ val (receiver, previousRequest) = synchronized(this) {
161
+ val previousRequest = recordingRequested
162
+ recordingRequested = true
163
+ Pair(uiChangeReceiver, previousRequest)
164
+ }
165
+ try {
166
+ sessionReplay.start()
167
+ } catch (error: Exception) {
168
+ synchronized(this) {
169
+ if (!invalidated && uiChangeReceiver === receiver) recordingRequested = previousRequest
170
+ }
171
+ throw error
172
+ }
105
173
  }
106
174
 
107
175
  @ReactMethod
108
- fun stop() {
176
+ fun stop() = synchronized(lifecycleLock) {
177
+ recordingRequested = false
109
178
  sessionReplay.stop()
110
179
  }
111
180
 
@@ -115,11 +184,19 @@ class PluginSessionReplayReactNativeModule(private val reactContext: ReactApplic
115
184
  }
116
185
 
117
186
  @ReactMethod
118
- fun teardown() {
187
+ fun teardown() = synchronized(lifecycleLock) {
188
+ synchronized(this) { uiChangeReceiver = null }
189
+ recordingRequested = false
119
190
  sessionReplay.shutdown()
120
191
  }
121
192
 
122
- override fun invalidate() {
193
+ override fun invalidate() = synchronized(lifecycleLock) {
194
+ synchronized(this) {
195
+ invalidated = true
196
+ uiChangeReceiver = null
197
+ listenerCount = 0
198
+ }
199
+ recordingRequested = false
123
200
  if (::sessionReplay.isInitialized) {
124
201
  sessionReplay.shutdown()
125
202
  }
@@ -1,6 +1,9 @@
1
1
  #import <React/RCTBridgeModule.h>
2
+ #import <React/RCTEventEmitter.h>
2
3
 
3
- @interface RCT_EXTERN_MODULE(PluginSessionReplayReactNative, NSObject)
4
+ @interface RCT_EXTERN_MODULE(PluginSessionReplayReactNative, RCTEventEmitter)
5
+
6
+ RCT_EXTERN_METHOD(isRecording:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
4
7
 
5
8
  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)
6
9
 
@@ -1,10 +1,68 @@
1
1
  import Foundation
2
2
  import AmplitudeSessionReplay
3
+ import AmplitudeCore
4
+ import React
3
5
 
4
6
  @objc(PluginSessionReplayReactNative)
5
- class PluginSessionReplayReactNative: NSObject {
7
+ class PluginSessionReplayReactNative: RCTEventEmitter {
6
8
 
7
- var sessionReplay: SessionReplay!
9
+ // Serialize capture startup with invalidation without holding stateLock in SDK calls.
10
+ private let lifecycleLock = NSLock()
11
+ private let stateLock = NSLock()
12
+ private var currentSessionReplay: SessionReplay?
13
+ var sessionReplay: SessionReplay! {
14
+ get { stateLock.withLock { currentSessionReplay } }
15
+ set { stateLock.withLock { currentSessionReplay = newValue } }
16
+ }
17
+ private var hasUiChangeListeners = false
18
+ private var recordingRequested = false
19
+ private var invalidated = false
20
+ private var uiChangeReceiver: UiChangeReceiver?
21
+
22
+ @objc(isRecording:reject:)
23
+ func isRecording(_ resolve: @escaping RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) {
24
+ // SDK >= 0.16.1 synchronizes isProviding internally; read it outside our lock.
25
+ let (requested, replay) = stateLock.withLock {
26
+ (!invalidated && recordingRequested, currentSessionReplay)
27
+ }
28
+ resolve(requested && (replay?.isProviding ?? false))
29
+ }
30
+ private func attachUiChangeReceiver() {
31
+ guard let provider = sessionReplay else { return }
32
+ let receiver = UiChangeReceiver { [weak self] receiver, timestamp in
33
+ guard let self = self else { return }
34
+ self.stateLock.withLock {
35
+ // JS cannot distinguish callbacks from an SDK instance already replaced.
36
+ guard !self.invalidated, self.hasUiChangeListeners, self.recordingRequested,
37
+ self.uiChangeReceiver === receiver else { return }
38
+ self.sendEvent(withName: "amplitudeSessionReplayUiChange", body: ["timestamp": timestamp])
39
+ }
40
+ }
41
+ stateLock.withLock { uiChangeReceiver = receiver }
42
+ provider.addInterfaceSignalReceiver(receiver)
43
+ }
44
+
45
+ private func removeUiChangeReceiver() {
46
+ let (provider, receiver) = stateLock.withLock {
47
+ let receiver = uiChangeReceiver
48
+ uiChangeReceiver = nil
49
+ return (currentSessionReplay, receiver)
50
+ }
51
+ // Never hold the state lock while calling back into the SDK.
52
+ if let receiver = receiver { provider?.removeInterfaceSignalReceiver(receiver) }
53
+ }
54
+
55
+ override func supportedEvents() -> [String]! {
56
+ return ["amplitudeSessionReplayUiChange"]
57
+ }
58
+
59
+ override func startObserving() {
60
+ stateLock.withLock { hasUiChangeListeners = !invalidated }
61
+ }
62
+
63
+ override func stopObserving() {
64
+ stateLock.withLock { hasUiChangeListeners = false }
65
+ }
8
66
 
9
67
  @objc(setup:deviceId:sessionId:serverZone:sampleRate:enableRemoteConfig:logLevel:autoStart:maskLevel:resolve:reject:)
10
68
  func setup(_ apiKey: String,
@@ -18,6 +76,12 @@ class PluginSessionReplayReactNative: NSObject {
18
76
  maskLevel: String,
19
77
  resolve: RCTPromiseResolveBlock,
20
78
  reject: RCTPromiseRejectBlock) -> Void {
79
+ lifecycleLock.lock()
80
+ defer { lifecycleLock.unlock() }
81
+ guard stateLock.withLock({ !invalidated }) else {
82
+ resolve(nil)
83
+ return
84
+ }
21
85
  print(
22
86
  """
23
87
  setup:
@@ -32,6 +96,9 @@ class PluginSessionReplayReactNative: NSObject {
32
96
  Mask Level: \(maskLevel)
33
97
  """
34
98
  )
99
+ removeUiChangeReceiver()
100
+ stateLock.withLock { recordingRequested = false }
101
+ sessionReplay?.stop()
35
102
  sessionReplay = SessionReplay(apiKey:apiKey,
36
103
  deviceId: deviceId,
37
104
  sessionId: sessionId.int64Value,
@@ -40,7 +107,9 @@ class PluginSessionReplayReactNative: NSObject {
40
107
  serverZone: serverZone == "EU" ? .EU : .US,
41
108
  maskLevel: .fromString(maskLevel),
42
109
  enableRemoteConfig: enableRemoteConfig)
110
+ attachUiChangeReceiver()
43
111
  if (autoStart) {
112
+ stateLock.withLock { recordingRequested = true }
44
113
  sessionReplay.start()
45
114
  }
46
115
  resolve(nil)
@@ -67,7 +136,14 @@ class PluginSessionReplayReactNative: NSObject {
67
136
 
68
137
  @objc(start:reject:)
69
138
  func start(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
139
+ lifecycleLock.lock()
140
+ defer { lifecycleLock.unlock() }
141
+ guard stateLock.withLock({ !invalidated }) else {
142
+ resolve(nil)
143
+ return
144
+ }
70
145
  print("start")
146
+ stateLock.withLock { recordingRequested = true }
71
147
  sessionReplay.start()
72
148
  resolve(nil)
73
149
  }
@@ -75,6 +151,7 @@ class PluginSessionReplayReactNative: NSObject {
75
151
  @objc(stop:reject:)
76
152
  func stop(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
77
153
  print("stop")
154
+ stateLock.withLock { recordingRequested = false }
78
155
  sessionReplay.stop()
79
156
  resolve(nil)
80
157
  }
@@ -88,10 +165,42 @@ class PluginSessionReplayReactNative: NSObject {
88
165
 
89
166
  @objc(teardown:reject:)
90
167
  func teardown(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
168
+ lifecycleLock.lock()
169
+ defer { lifecycleLock.unlock() }
91
170
  print("teardown")
171
+ stateLock.withLock { recordingRequested = false }
172
+ removeUiChangeReceiver()
92
173
  sessionReplay.stop()
93
174
  resolve(nil)
94
175
  }
176
+
177
+ override func invalidate() {
178
+ lifecycleLock.lock()
179
+ defer { lifecycleLock.unlock() }
180
+ stateLock.withLock {
181
+ invalidated = true
182
+ hasUiChangeListeners = false
183
+ recordingRequested = false
184
+ }
185
+ removeUiChangeReceiver()
186
+ sessionReplay?.stop()
187
+ super.invalidate()
188
+ }
189
+ }
190
+
191
+ private final class UiChangeReceiver: InterfaceSignalReceiver, @unchecked Sendable {
192
+ private let uiChangeCallback: (UiChangeReceiver, Double) -> Void
193
+
194
+ init(uiChangeCallback: @escaping (UiChangeReceiver, Double) -> Void) {
195
+ self.uiChangeCallback = uiChangeCallback
196
+ }
197
+
198
+ func onInterfaceChanged(signal: InterfaceChangeSignal) {
199
+ uiChangeCallback(self, signal.time.timeIntervalSince1970 * 1000)
200
+ }
201
+
202
+ func onStartProviding() {}
203
+ func onStopProviding() {}
95
204
  }
96
205
 
97
206
  extension MaskLevel {
@@ -15,6 +15,18 @@ Object.defineProperty(exports, "SessionReplayPlugin", {
15
15
  return _sessionReplay.SessionReplayPlugin;
16
16
  }
17
17
  });
18
+ Object.defineProperty(exports, "addUiChangeListener", {
19
+ enumerable: true,
20
+ get: function () {
21
+ return _sessionReplay.addUiChangeListener;
22
+ }
23
+ });
24
+ Object.defineProperty(exports, "isRecording", {
25
+ enumerable: true,
26
+ get: function () {
27
+ return _sessionReplay.isRecording;
28
+ }
29
+ });
18
30
  var _sessionReplay = require("./session-replay");
19
31
  var _appMaskView = require("./app-mask-view");
20
32
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["_sessionReplay","require","_appMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAGA,IAAAC,YAAA,GAAAD,OAAA","ignoreList":[]}
1
+ {"version":3,"names":["_sessionReplay","require","_appMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAGA,IAAAC,YAAA,GAAAD,OAAA","ignoreList":[]}
@@ -4,6 +4,9 @@ Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
6
  exports.SessionReplayPlugin = void 0;
7
+ exports.addUiChangeListener = addUiChangeListener;
8
+ exports.isRecording = isRecording;
9
+ var _reactNative = require("react-native");
7
10
  var _nativeModule = require("./native-module");
8
11
  var _version = require("./version");
9
12
  var _sessionReplayConfig = require("./session-replay-config");
@@ -95,4 +98,38 @@ class SessionReplayPlugin {
95
98
  }
96
99
  }
97
100
  exports.SessionReplayPlugin = SessionReplayPlugin;
101
+ const globalUiChangeListeners = new Set();
102
+ let uiChangeSubscription;
103
+ let uiChangeSubscriptionGeneration = 0;
104
+
105
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
106
+ function addUiChangeListener(listener) {
107
+ // Each registration gets its own entry, even when the callback is reused.
108
+ const registeredListener = timestamp => listener(timestamp);
109
+ globalUiChangeListeners.add(registeredListener);
110
+ if (!uiChangeSubscription) {
111
+ const generation = ++uiChangeSubscriptionGeneration;
112
+ uiChangeSubscription = new _reactNative.NativeEventEmitter(_nativeModule.PluginSessionReplayReactNative).addListener('amplitudeSessionReplayUiChange', event => {
113
+ if (generation !== uiChangeSubscriptionGeneration) return;
114
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
115
+ const timestamp = typeof (event === null || event === void 0 ? void 0 : event.timestamp) === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
116
+ globalUiChangeListeners.forEach(callback => callback(timestamp));
117
+ });
118
+ }
119
+ return () => {
120
+ globalUiChangeListeners.delete(registeredListener);
121
+ if (globalUiChangeListeners.size === 0) {
122
+ var _uiChangeSubscription;
123
+ // Retire callbacks already queued for the previous native subscription.
124
+ uiChangeSubscriptionGeneration++;
125
+ (_uiChangeSubscription = uiChangeSubscription) === null || _uiChangeSubscription === void 0 || _uiChangeSubscription.remove();
126
+ uiChangeSubscription = undefined;
127
+ }
128
+ };
129
+ }
130
+
131
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
132
+ async function isRecording() {
133
+ return await _nativeModule.PluginSessionReplayReactNative.isRecording();
134
+ }
98
135
  //# sourceMappingURL=session-replay.js.map
@@ -1 +1 @@
1
- {"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":[]}
1
+ {"version":3,"names":["_reactNative","require","_nativeModule","_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","globalUiChangeListeners","Set","uiChangeSubscription","uiChangeSubscriptionGeneration","addUiChangeListener","listener","registeredListener","timestamp","add","generation","NativeEventEmitter","addListener","Number","isFinite","Date","now","forEach","callback","delete","size","_uiChangeSubscription","remove","undefined","isRecording"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
@@ -4,5 +4,5 @@ Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
6
  exports.VERSION = void 0;
7
- const VERSION = exports.VERSION = '0.5.14-claudeconfident-mccarthy-373nfy.0';
7
+ const VERSION = exports.VERSION = '0.5.14';
8
8
  //# sourceMappingURL=version.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,0CAA0C","ignoreList":[]}
1
+ {"version":3,"names":["VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,QAAQ","ignoreList":[]}
@@ -1,3 +1,3 @@
1
- export { SessionReplayPlugin } from './session-replay';
1
+ export { SessionReplayPlugin, addUiChangeListener, isRecording } from './session-replay';
2
2
  export { AmpMaskView } from './app-mask-view';
3
3
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["SessionReplayPlugin","AmpMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,mBAAmB,QAAQ,kBAAkB;AAGtD,SAASC,WAAW,QAAQ,iBAAiB","ignoreList":[]}
1
+ {"version":3,"names":["SessionReplayPlugin","addUiChangeListener","isRecording","AmpMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,mBAAmB,EAAEC,mBAAmB,EAAEC,WAAW,QAAQ,kBAAkB;AAGxF,SAASC,WAAW,QAAQ,iBAAiB","ignoreList":[]}
@@ -4,6 +4,7 @@
4
4
  /* eslint-disable @typescript-eslint/ban-ts-comment */
5
5
  /* eslint-disable @typescript-eslint/no-unsafe-return */
6
6
 
7
+ import { NativeEventEmitter } from 'react-native';
7
8
  import { PluginSessionReplayReactNative } from './native-module';
8
9
  import { VERSION } from './version';
9
10
  import { getDefaultConfig } from './session-replay-config';
@@ -88,4 +89,38 @@ export class SessionReplayPlugin {
88
89
  return PluginSessionReplayReactNative.getSessionReplayProperties();
89
90
  }
90
91
  }
92
+ const globalUiChangeListeners = new Set();
93
+ let uiChangeSubscription;
94
+ let uiChangeSubscriptionGeneration = 0;
95
+
96
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
97
+ export function addUiChangeListener(listener) {
98
+ // Each registration gets its own entry, even when the callback is reused.
99
+ const registeredListener = timestamp => listener(timestamp);
100
+ globalUiChangeListeners.add(registeredListener);
101
+ if (!uiChangeSubscription) {
102
+ const generation = ++uiChangeSubscriptionGeneration;
103
+ uiChangeSubscription = new NativeEventEmitter(PluginSessionReplayReactNative).addListener('amplitudeSessionReplayUiChange', event => {
104
+ if (generation !== uiChangeSubscriptionGeneration) return;
105
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
106
+ const timestamp = typeof (event === null || event === void 0 ? void 0 : event.timestamp) === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
107
+ globalUiChangeListeners.forEach(callback => callback(timestamp));
108
+ });
109
+ }
110
+ return () => {
111
+ globalUiChangeListeners.delete(registeredListener);
112
+ if (globalUiChangeListeners.size === 0) {
113
+ var _uiChangeSubscription;
114
+ // Retire callbacks already queued for the previous native subscription.
115
+ uiChangeSubscriptionGeneration++;
116
+ (_uiChangeSubscription = uiChangeSubscription) === null || _uiChangeSubscription === void 0 || _uiChangeSubscription.remove();
117
+ uiChangeSubscription = undefined;
118
+ }
119
+ };
120
+ }
121
+
122
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
123
+ export async function isRecording() {
124
+ return await PluginSessionReplayReactNative.isRecording();
125
+ }
91
126
  //# sourceMappingURL=session-replay.js.map
@@ -1 +1 @@
1
- {"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":[]}
1
+ {"version":3,"names":["NativeEventEmitter","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","globalUiChangeListeners","Set","uiChangeSubscription","uiChangeSubscriptionGeneration","addUiChangeListener","listener","registeredListener","timestamp","add","generation","addListener","Number","isFinite","Date","now","forEach","callback","delete","size","_uiChangeSubscription","remove","undefined","isRecording"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
@@ -1,2 +1,2 @@
1
- export const VERSION = '0.5.14-claudeconfident-mccarthy-373nfy.0';
1
+ export const VERSION = '0.5.14';
2
2
  //# sourceMappingURL=version.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,0CAA0C","ignoreList":[]}
1
+ {"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,QAAQ","ignoreList":[]}
@@ -1,4 +1,4 @@
1
- export { SessionReplayPlugin } from './session-replay';
1
+ export { SessionReplayPlugin, addUiChangeListener, isRecording } from './session-replay';
2
2
  export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
3
3
  export { AmpMaskView } from './app-mask-view';
4
4
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
@@ -15,5 +15,9 @@ export declare class SessionReplayPlugin implements EnrichmentPlugin<ReactNative
15
15
  teardown(): Promise<void>;
16
16
  getSessionReplayProperties(): Promise<any>;
17
17
  }
18
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
19
+ export declare function addUiChangeListener(listener: (timestamp: number) => void): () => void;
20
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
21
+ export declare function isRecording(): Promise<boolean>;
18
22
  export {};
19
23
  //# sourceMappingURL=session-replay.d.ts.map
@@ -1 +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,2BAA2B,CAAC;AAI/G,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"}
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,2BAA2B,CAAC;AAK/G,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;AAMD,0GAA0G;AAC1G,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CA2BrF;AAED,8FAA8F;AAC9F,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAEpD"}
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.5.14-claudeconfident-mccarthy-373nfy.0";
1
+ export declare const VERSION = "0.5.14";
2
2
  //# sourceMappingURL=version.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,6CAA6C,CAAC"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amplitude/plugin-session-replay-react-native",
3
- "version": "0.5.14-claudeconfident-mccarthy-373nfy.0",
3
+ "version": "0.5.14",
4
4
  "description": "Amplitude Session Replay plugin for React Native",
5
5
  "keywords": [
6
6
  "analytics",
@@ -49,7 +49,7 @@
49
49
  "url": "https://github.com/amplitude/Amplitude-TypeScript/issues"
50
50
  },
51
51
  "dependencies": {
52
- "@amplitude/analytics-core": "2.63.0-claudeconfident-mccarthy-373nfy.0"
52
+ "@amplitude/analytics-core": "2.62.1"
53
53
  },
54
54
  "devDependencies": {
55
55
  "@types/react": "^18.0.26",
package/src/index.tsx CHANGED
@@ -1,4 +1,4 @@
1
- export { SessionReplayPlugin } from './session-replay';
1
+ export { SessionReplayPlugin, addUiChangeListener, isRecording } from './session-replay';
2
2
  export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
3
3
 
4
4
  export { AmpMaskView } from './app-mask-view';
@@ -4,6 +4,7 @@
4
4
  /* eslint-disable @typescript-eslint/ban-ts-comment */
5
5
  /* eslint-disable @typescript-eslint/no-unsafe-return */
6
6
  import type { EnrichmentPlugin, Event, ReactNativeClient, ReactNativeConfig } from '@amplitude/analytics-core';
7
+ import { NativeEventEmitter, EmitterSubscription, NativeModule } from 'react-native';
7
8
 
8
9
  import { PluginSessionReplayReactNative } from './native-module';
9
10
  import { VERSION } from './version';
@@ -110,3 +111,42 @@ export class SessionReplayPlugin implements EnrichmentPlugin<ReactNativeClient,
110
111
  return PluginSessionReplayReactNative.getSessionReplayProperties();
111
112
  }
112
113
  }
114
+
115
+ const globalUiChangeListeners = new Set<(timestamp: number) => void>();
116
+ let uiChangeSubscription: EmitterSubscription | undefined;
117
+ let uiChangeSubscriptionGeneration = 0;
118
+
119
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
120
+ export function addUiChangeListener(listener: (timestamp: number) => void): () => void {
121
+ // Each registration gets its own entry, even when the callback is reused.
122
+ const registeredListener = (timestamp: number) => listener(timestamp);
123
+ globalUiChangeListeners.add(registeredListener);
124
+ if (!uiChangeSubscription) {
125
+ const generation = ++uiChangeSubscriptionGeneration;
126
+ uiChangeSubscription = new NativeEventEmitter(PluginSessionReplayReactNative as NativeModule).addListener(
127
+ 'amplitudeSessionReplayUiChange',
128
+ (event?: { timestamp?: number }) => {
129
+ if (generation !== uiChangeSubscriptionGeneration) return;
130
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
131
+ const timestamp =
132
+ typeof event?.timestamp === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
133
+ globalUiChangeListeners.forEach((callback) => callback(timestamp));
134
+ },
135
+ );
136
+ }
137
+
138
+ return () => {
139
+ globalUiChangeListeners.delete(registeredListener);
140
+ if (globalUiChangeListeners.size === 0) {
141
+ // Retire callbacks already queued for the previous native subscription.
142
+ uiChangeSubscriptionGeneration++;
143
+ uiChangeSubscription?.remove();
144
+ uiChangeSubscription = undefined;
145
+ }
146
+ };
147
+ }
148
+
149
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
150
+ export async function isRecording(): Promise<boolean> {
151
+ return (await PluginSessionReplayReactNative.isRecording()) as boolean;
152
+ }
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '0.5.14-claudeconfident-mccarthy-373nfy.0';
1
+ export const VERSION = '0.5.14';