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

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.
Files changed (40) hide show
  1. package/AmplitudeSessionReplayReactNative.podspec +1 -1
  2. package/README.md +27 -0
  3. package/android/src/main/java/com/amplitude/sessionreplayreactnative/SessionReplayReactNativeModule.kt +76 -13
  4. package/android/src/oldarch/java/com/amplitude/sessionreplayreactnative/SessionReplayReactNativeSpec.kt +3 -0
  5. package/ios/AMPNativeSessionReplay.mm +4 -1
  6. package/ios/NativeSessionReplay.swift +106 -7
  7. package/lib/commonjs/index.js +12 -0
  8. package/lib/commonjs/index.js.map +1 -1
  9. package/lib/commonjs/native-module.js +1 -2
  10. package/lib/commonjs/native-module.js.map +1 -1
  11. package/lib/commonjs/session-replay.js +37 -0
  12. package/lib/commonjs/session-replay.js.map +1 -1
  13. package/lib/commonjs/specs/NativeAmpSessionReplay.js.map +1 -1
  14. package/lib/commonjs/version.js +1 -1
  15. package/lib/commonjs/version.js.map +1 -1
  16. package/lib/module/index.js +1 -1
  17. package/lib/module/index.js.map +1 -1
  18. package/lib/module/native-module.js +1 -2
  19. package/lib/module/native-module.js.map +1 -1
  20. package/lib/module/session-replay.js +35 -0
  21. package/lib/module/session-replay.js.map +1 -1
  22. package/lib/module/specs/NativeAmpSessionReplay.js.map +1 -1
  23. package/lib/module/version.js +1 -1
  24. package/lib/module/version.js.map +1 -1
  25. package/lib/typescript/index.d.ts +1 -1
  26. package/lib/typescript/index.d.ts.map +1 -1
  27. package/lib/typescript/native-module.d.ts +6 -2
  28. package/lib/typescript/native-module.d.ts.map +1 -1
  29. package/lib/typescript/session-replay.d.ts +4 -0
  30. package/lib/typescript/session-replay.d.ts.map +1 -1
  31. package/lib/typescript/specs/NativeAmpSessionReplay.d.ts +3 -0
  32. package/lib/typescript/specs/NativeAmpSessionReplay.d.ts.map +1 -1
  33. package/lib/typescript/version.d.ts +1 -1
  34. package/lib/typescript/version.d.ts.map +1 -1
  35. package/package.json +1 -1
  36. package/src/index.tsx +2 -0
  37. package/src/native-module.ts +7 -2
  38. package/src/session-replay.ts +40 -0
  39. package/src/specs/NativeAmpSessionReplay.ts +3 -0
  40. package/src/version.ts +1 -1
@@ -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.12.6'
19
+ s.dependency 'AmplitudeSessionReplay', '>=0.16.1'
20
20
  s.dependency 'AmplitudeCore', '>=1.5.2'
21
21
 
22
22
  # This code is to support RN prior to 0.71.0. Should be removed when we drop support for RN < 0.71.0.
package/README.md CHANGED
@@ -46,6 +46,17 @@ idle, even after `start()`.
46
46
 
47
47
  To use Amplitude Session Replay with Amplitude Analytics, use the [`@amplitude/plugin-session-replay-react-native`](https://www.npmjs.com/package/@amplitude/plugin-session-replay-react-native) plugin package.
48
48
 
49
+ ## Recording status
50
+
51
+ `isRecording()` returns a `Promise<boolean>`. Await it to check whether native Replay
52
+ is recording and providing UI-change signals:
53
+
54
+ ```js
55
+ import { isRecording } from '@amplitude/session-replay-react-native';
56
+
57
+ const recording = await isRecording();
58
+ ```
59
+
49
60
  ## Masking views
50
61
 
51
62
  To mask certain views, add the `AmpMaskView` tag with the mask property `amp-mask` around the section to be masked
@@ -104,3 +115,19 @@ them by doing the following
104
115
  <WebView source={{ uri: 'https://reactnative.dev/' }} style={{ flex: 1 }} />
105
116
  </AmpMaskView>
106
117
  ```
118
+
119
+
120
+ ## UI change timestamps
121
+
122
+ `addUiChangeListener` passes the UI change time as milliseconds since the Unix epoch:
123
+
124
+ ```typescript
125
+ const unsubscribe = addUiChangeListener((timestamp) => {
126
+ console.log('UI changed at', new Date(timestamp));
127
+ });
128
+ ```
129
+
130
+ Existing callbacks that take no arguments continue to work. On iOS, the timestamp
131
+ comes from Session Replay's interface signal. On Android, it records when the
132
+ native SDK invokes its UI-change callback. Older native binaries without a timestamp
133
+ fall back to the time JavaScript receives the notification.
@@ -9,7 +9,9 @@ import com.amplitude.core.ServerZone
9
9
  import com.facebook.react.bridge.ReactApplicationContext
10
10
  import com.facebook.react.bridge.ReactMethod
11
11
  import com.facebook.react.bridge.Promise
12
+ import com.facebook.react.bridge.Arguments
12
13
  import com.facebook.react.bridge.ReadableMap
14
+ import com.facebook.react.modules.core.DeviceEventManagerModule
13
15
 
14
16
  // `@ReactMethod` is required on the legacy architecture and ignored on the new
15
17
  // one, so it stays on the overrides below.
@@ -26,16 +28,59 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
26
28
  val maskLevel: MaskLevel,
27
29
  )
28
30
 
29
- private var sessionReplay: SessionReplay? = null
31
+ // Never hold the UI-event state monitor while calling into the SDK.
32
+ private val lifecycleLock = Any()
33
+ @Volatile private var sessionReplay: SessionReplay? = null
30
34
  private var nativeConfig: NativeConfig? = null
31
- private var shouldStart = false
35
+ @Volatile private var shouldStart = false
36
+ @Volatile private var invalidated = false
37
+ @Volatile private var uiChangeReceiver: Any? = null
38
+ private var listenerCount = 0
39
+
40
+ @ReactMethod
41
+ override fun isRecording(promise: Promise) {
42
+ promise.resolve(!invalidated && shouldStart && sessionReplay?.shouldRecord() == true)
43
+ }
44
+
45
+ @ReactMethod
46
+ override fun addListener(eventName: String) {
47
+ synchronized(this) {
48
+ if (!invalidated) listenerCount++
49
+ }
50
+ }
51
+
52
+ @ReactMethod
53
+ override fun removeListeners(count: Double) {
54
+ synchronized(this) {
55
+ listenerCount = (listenerCount - count.toInt().coerceAtLeast(0)).coerceAtLeast(0)
56
+ }
57
+ }
58
+
59
+ private fun emitUiChange(receiver: Any) {
60
+ val timestamp = System.currentTimeMillis().toDouble()
61
+ synchronized(this) {
62
+ if (listenerCount == 0 || uiChangeReceiver !== receiver || invalidated || !shouldStart ||
63
+ !reactContext.hasActiveReactInstance()) return
64
+ try {
65
+ val signal = Arguments.createMap().apply { putDouble("timestamp", timestamp) }
66
+ reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
67
+ .emit("amplitudeSessionReplayReactNativeUiChange", signal)
68
+ } catch (_: RuntimeException) {
69
+ // The React instance can be destroyed between the check and the emission.
70
+ }
71
+ }
72
+ }
32
73
 
33
74
  override fun getName(): String {
34
75
  return NAME
35
76
  }
36
77
 
37
78
  @ReactMethod
38
- override fun setup(config: ReadableMap, promise: Promise) {
79
+ override fun setup(config: ReadableMap, promise: Promise) = synchronized(lifecycleLock) {
80
+ if (invalidated) {
81
+ promise.resolve(null)
82
+ return@synchronized
83
+ }
39
84
  try {
40
85
  val apiKey = config.getString("apiKey") ?: throw IllegalArgumentException("apiKey is required")
41
86
  val deviceId = config.getString("deviceId")
@@ -75,7 +120,7 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
75
120
  Opt Out: $optOut
76
121
  """.trimIndent())
77
122
 
78
- nativeConfig = NativeConfig(
123
+ val updatedConfig = NativeConfig(
79
124
  apiKey = apiKey,
80
125
  deviceId = deviceId,
81
126
  customSessionId = customSessionId,
@@ -85,7 +130,8 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
85
130
  optOut = optOut,
86
131
  maskLevel = maskLevel,
87
132
  )
88
- rebootSessionReplay(requireNotNull(nativeConfig))
133
+ rebootSessionReplay(updatedConfig)
134
+ nativeConfig = updatedConfig
89
135
  shouldStart = false
90
136
 
91
137
  promise.resolve(null)
@@ -126,12 +172,16 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
126
172
  }
127
173
 
128
174
  @ReactMethod
129
- override fun setOptOut(optOut: Boolean, promise: Promise) {
175
+ override fun setOptOut(optOut: Boolean, promise: Promise) = synchronized(lifecycleLock) {
176
+ if (invalidated) {
177
+ promise.resolve(null)
178
+ return@synchronized
179
+ }
130
180
  try {
131
181
  val currentConfig = requireNotNull(nativeConfig)
132
182
  if (currentConfig.optOut == optOut) {
133
183
  promise.resolve(null)
134
- return
184
+ return@synchronized
135
185
  }
136
186
 
137
187
  // session-replay-android has no public runtime opt-out setter, so retain
@@ -151,7 +201,11 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
151
201
  }
152
202
 
153
203
  @ReactMethod
154
- override fun start(promise: Promise) {
204
+ override fun start(promise: Promise) = synchronized(lifecycleLock) {
205
+ if (invalidated) {
206
+ promise.resolve(null)
207
+ return@synchronized
208
+ }
155
209
  try {
156
210
  shouldStart = true
157
211
  sessionReplay?.start()
@@ -162,7 +216,7 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
162
216
  }
163
217
 
164
218
  @ReactMethod
165
- override fun stop(promise: Promise) {
219
+ override fun stop(promise: Promise) = synchronized(lifecycleLock) {
166
220
  try {
167
221
  shouldStart = false
168
222
  sessionReplay?.stop()
@@ -183,7 +237,8 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
183
237
  }
184
238
 
185
239
  @ReactMethod
186
- override fun teardown(promise: Promise) {
240
+ override fun teardown(promise: Promise) = synchronized(lifecycleLock) {
241
+ synchronized(this) { uiChangeReceiver = null }
187
242
  try {
188
243
  sessionReplay?.shutdown()
189
244
  sessionReplay = null
@@ -195,7 +250,12 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
195
250
  }
196
251
  }
197
252
 
198
- override fun invalidate() {
253
+ override fun invalidate() = synchronized(lifecycleLock) {
254
+ synchronized(this) {
255
+ invalidated = true
256
+ uiChangeReceiver = null
257
+ listenerCount = 0
258
+ }
199
259
  sessionReplay?.shutdown()
200
260
  sessionReplay = null
201
261
  nativeConfig = null
@@ -203,17 +263,19 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
203
263
  }
204
264
 
205
265
  private fun rebootSessionReplay(config: NativeConfig) {
266
+ val receiver = Any()
206
267
  val nextSessionReplay = if (config.optOut) {
207
268
  LogcatLogger.logger.debug("skipping SessionReplay init because optOut=true")
208
269
  null
209
270
  } else {
210
- createSessionReplay(config)
271
+ createSessionReplay(config, receiver)
211
272
  }
273
+ synchronized(this) { uiChangeReceiver = if (nextSessionReplay == null) null else receiver }
212
274
  sessionReplay?.shutdown()
213
275
  sessionReplay = nextSessionReplay
214
276
  }
215
277
 
216
- private fun createSessionReplay(config: NativeConfig): SessionReplay {
278
+ private fun createSessionReplay(config: NativeConfig, receiver: Any): SessionReplay {
217
279
  val sessionReplay = SessionReplay(
218
280
  apiKey = config.apiKey,
219
281
  context = reactContext.applicationContext,
@@ -229,6 +291,7 @@ class SessionReplayReactNativeModule(private val reactContext: ReactApplicationC
229
291
  },
230
292
  autoStart = false,
231
293
  privacyConfig = PrivacyConfig(maskLevel = config.maskLevel),
294
+ uiChangeCallback = { emitUiChange(receiver) },
232
295
  )
233
296
  sessionReplay.setCustomSessionId(config.customSessionId)
234
297
  return sessionReplay
@@ -9,6 +9,9 @@ import com.facebook.react.bridge.ReadableMap
9
9
  // module's `override`s compile against both bases.
10
10
  abstract class SessionReplayReactNativeSpec(reactContext: ReactApplicationContext) :
11
11
  ReactContextBaseJavaModule(reactContext) {
12
+ abstract fun isRecording(promise: Promise)
13
+ abstract fun addListener(eventName: String)
14
+ abstract fun removeListeners(count: Double)
12
15
  abstract fun setup(config: ReadableMap, promise: Promise)
13
16
  abstract fun setCustomSessionId(customSessionId: String, promise: Promise)
14
17
  abstract fun getCustomSessionId(promise: Promise)
@@ -1,6 +1,9 @@
1
1
  #import <React/RCTBridgeModule.h>
2
+ #import <React/RCTEventEmitter.h>
2
3
 
3
- @interface RCT_EXTERN_MODULE(AMPNativeSessionReplay, NSObject)
4
+ @interface RCT_EXTERN_MODULE(AMPNativeSessionReplay, RCTEventEmitter)
5
+
6
+ RCT_EXTERN_METHOD(isRecording:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
4
7
 
5
8
  RCT_EXTERN_METHOD(flush:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject)
6
9
 
@@ -1,22 +1,83 @@
1
1
  import Foundation
2
2
  import AmplitudeSessionReplay
3
3
  import AmplitudeCore
4
+ import React
4
5
 
5
6
  @objc(AMPNativeSessionReplay)
6
- class NativeSessionReplay: NSObject, RCTBridgeModule {
7
- static func moduleName() -> String! {
8
- "AMPNativeSessionReplay"
7
+ class NativeSessionReplay: RCTEventEmitter {
8
+ // Serialize capture startup with invalidation without holding stateLock in SDK calls.
9
+ private let lifecycleLock = NSLock()
10
+ private let stateLock = NSLock()
11
+ private var currentSessionReplay: SessionReplay?
12
+ var sessionReplay: SessionReplay? {
13
+ get { stateLock.withLock { currentSessionReplay } }
14
+ set { stateLock.withLock { currentSessionReplay = newValue } }
9
15
  }
10
-
11
- var sessionReplay: SessionReplay?
12
16
  var logger: CoreLogger?
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
+
31
+ private func attachUiChangeReceiver() {
32
+ guard let provider = sessionReplay else { return }
33
+ let receiver = UiChangeReceiver { [weak self] receiver, timestamp in
34
+ guard let self = self else { return }
35
+ self.stateLock.withLock {
36
+ // JS cannot distinguish callbacks from an SDK instance already replaced.
37
+ guard !self.invalidated, self.hasUiChangeListeners, self.recordingRequested,
38
+ self.uiChangeReceiver === receiver else { return }
39
+ self.sendEvent(withName: "amplitudeSessionReplayReactNativeUiChange", body: ["timestamp": timestamp])
40
+ }
41
+ }
42
+ stateLock.withLock { uiChangeReceiver = receiver }
43
+ provider.addInterfaceSignalReceiver(receiver)
44
+ }
45
+
46
+ private func removeUiChangeReceiver() {
47
+ let (provider, receiver) = stateLock.withLock {
48
+ let receiver = uiChangeReceiver
49
+ uiChangeReceiver = nil
50
+ return (currentSessionReplay, receiver)
51
+ }
52
+ // Never hold the state lock while calling back into the SDK.
53
+ if let receiver = receiver { provider?.removeInterfaceSignalReceiver(receiver) }
54
+ }
55
+
56
+ override func supportedEvents() -> [String]! {
57
+ return ["amplitudeSessionReplayReactNativeUiChange"]
58
+ }
59
+
60
+ override func startObserving() {
61
+ stateLock.withLock { hasUiChangeListeners = !invalidated }
62
+ }
63
+
64
+ override func stopObserving() {
65
+ stateLock.withLock { hasUiChangeListeners = false }
66
+ }
13
67
 
14
68
  override init() {
69
+ super.init()
15
70
  print("NativeSessionReplay init")
16
71
  }
17
72
 
18
73
  @objc(setup:resolve:reject:)
19
74
  func setup(_ config: NSDictionary, resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
75
+ lifecycleLock.lock()
76
+ defer { lifecycleLock.unlock() }
77
+ guard stateLock.withLock({ !invalidated }) else {
78
+ resolve(nil)
79
+ return
80
+ }
20
81
  guard let apiKey = config["apiKey"] as? String,
21
82
  let serverZone = config["serverZone"] as? String,
22
83
  let sampleRate = config["sampleRate"] as? NSNumber,
@@ -48,6 +109,9 @@ class NativeSessionReplay: NSObject, RCTBridgeModule {
48
109
  """
49
110
  )
50
111
 
112
+ removeUiChangeReceiver()
113
+ stateLock.withLock { recordingRequested = false }
114
+ sessionReplay?.stop()
51
115
  sessionReplay = SessionReplay(
52
116
  apiKey: apiKey,
53
117
  deviceId: deviceId,
@@ -61,6 +125,7 @@ class NativeSessionReplay: NSObject, RCTBridgeModule {
61
125
  )
62
126
 
63
127
  sessionReplay?.customSessionId = customSessionId
128
+ attachUiChangeReceiver()
64
129
 
65
130
  resolve(nil)
66
131
  }
@@ -97,7 +162,14 @@ class NativeSessionReplay: NSObject, RCTBridgeModule {
97
162
 
98
163
  @objc(start:reject:)
99
164
  func start(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
165
+ lifecycleLock.lock()
166
+ defer { lifecycleLock.unlock() }
167
+ guard stateLock.withLock({ !invalidated }) else {
168
+ resolve(nil)
169
+ return
170
+ }
100
171
  logger?.debug(message: "start")
172
+ stateLock.withLock { recordingRequested = true }
101
173
  sessionReplay?.start()
102
174
  resolve(nil)
103
175
  }
@@ -105,6 +177,7 @@ class NativeSessionReplay: NSObject, RCTBridgeModule {
105
177
  @objc(stop:reject:)
106
178
  func stop(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
107
179
  logger?.debug(message: "stop")
180
+ stateLock.withLock { recordingRequested = false }
108
181
  sessionReplay?.stop()
109
182
  resolve(nil)
110
183
  }
@@ -118,24 +191,50 @@ class NativeSessionReplay: NSObject, RCTBridgeModule {
118
191
 
119
192
  @objc(teardown:reject:)
120
193
  func teardown(_ resolve: RCTPromiseResolveBlock, reject: RCTPromiseRejectBlock) -> Void {
194
+ lifecycleLock.lock()
195
+ defer { lifecycleLock.unlock() }
121
196
  logger?.debug(message: "teardown")
122
197
  tearDownSessionReplay()
123
198
  resolve(nil)
124
199
  }
125
200
 
126
- @objc(invalidate)
127
- func invalidate() {
201
+ override func invalidate() {
202
+ lifecycleLock.lock()
203
+ defer { lifecycleLock.unlock() }
204
+ stateLock.withLock {
205
+ invalidated = true
206
+ hasUiChangeListeners = false
207
+ recordingRequested = false
208
+ }
128
209
  print("invalidate")
129
210
  tearDownSessionReplay()
211
+ super.invalidate()
130
212
  }
131
213
 
132
214
  private func tearDownSessionReplay() {
215
+ stateLock.withLock { recordingRequested = false }
216
+ removeUiChangeReceiver()
133
217
  sessionReplay?.stop()
134
218
  sessionReplay = nil
135
219
  logger = nil
136
220
  }
137
221
  }
138
222
 
223
+ private final class UiChangeReceiver: InterfaceSignalReceiver, @unchecked Sendable {
224
+ private let uiChangeCallback: (UiChangeReceiver, Double) -> Void
225
+
226
+ init(uiChangeCallback: @escaping (UiChangeReceiver, Double) -> Void) {
227
+ self.uiChangeCallback = uiChangeCallback
228
+ }
229
+
230
+ func onInterfaceChanged(signal: InterfaceChangeSignal) {
231
+ uiChangeCallback(self, signal.time.timeIntervalSince1970 * 1000)
232
+ }
233
+
234
+ func onStartProviding() {}
235
+ func onStopProviding() {}
236
+ }
237
+
139
238
  extension MaskLevel {
140
239
  static func fromString(_ input: String) -> MaskLevel {
141
240
  switch input.lowercased() {
@@ -15,6 +15,12 @@ Object.defineProperty(exports, "LogLevel", {
15
15
  return _sessionReplayConfig.LogLevel;
16
16
  }
17
17
  });
18
+ Object.defineProperty(exports, "addUiChangeListener", {
19
+ enumerable: true,
20
+ get: function () {
21
+ return _sessionReplay.addUiChangeListener;
22
+ }
23
+ });
18
24
  Object.defineProperty(exports, "flush", {
19
25
  enumerable: true,
20
26
  get: function () {
@@ -33,6 +39,12 @@ Object.defineProperty(exports, "init", {
33
39
  return _sessionReplay.init;
34
40
  }
35
41
  });
42
+ Object.defineProperty(exports, "isRecording", {
43
+ enumerable: true,
44
+ get: function () {
45
+ return _sessionReplay.isRecording;
46
+ }
47
+ });
36
48
  Object.defineProperty(exports, "setDeviceId", {
37
49
  enumerable: true,
38
50
  get: function () {
@@ -1 +1 @@
1
- {"version":3,"names":["_sessionReplay","require","_sessionReplayConfig","_ampMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAYA,IAAAC,oBAAA,GAAAD,OAAA;AAEA,IAAAE,YAAA,GAAAF,OAAA","ignoreList":[]}
1
+ {"version":3,"names":["_sessionReplay","require","_sessionReplayConfig","_ampMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AAcA,IAAAC,oBAAA,GAAAD,OAAA;AAEA,IAAAE,YAAA,GAAAF,OAAA","ignoreList":[]}
@@ -34,7 +34,6 @@ const NativeSessionReplay = exports.NativeSessionReplay = _NativeAmpSessionRepla
34
34
  * This interface provides the contract for communication between JavaScript and
35
35
  * the native iOS/Android session replay modules through React Native's bridge.
36
36
  *
37
- * All methods are asynchronous and return Promises to handle the bridge communication
38
- * between JavaScript and native code.
37
+ * Lifecycle and recording-state queries return Promises; event subscription hooks are synchronous.
39
38
  */
40
39
  //# sourceMappingURL=native-module.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["_reactNative","require","_NativeAmpSessionReplay","_interopRequireDefault","e","__esModule","default","LINKING_ERROR","Platform","select","ios","NativeSessionReplay","exports","SessionReplaySpec","Proxy","get","Error"],"sourceRoot":"../../src","sources":["native-module.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,uBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAA+D,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE/D,MAAMG,aAAa,GACjB,iGAAiG,GACjGC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEJ,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;;AAEjC;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAIE,+BAAiB,IACnD,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACT,aAAa,CAAC;EAChC;AACF,CACF,CAAwC;;AAE1C;AACA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
1
+ {"version":3,"names":["_reactNative","require","_NativeAmpSessionReplay","_interopRequireDefault","e","__esModule","default","LINKING_ERROR","Platform","select","ios","NativeSessionReplay","exports","SessionReplaySpec","Proxy","get","Error"],"sourceRoot":"../../src","sources":["native-module.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,uBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAA+D,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE/D,MAAMG,aAAa,GACjB,iGAAiG,GACjGC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEJ,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;;AAEjC;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAIE,+BAAiB,IACnD,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACT,aAAa,CAAC;EAChC;AACF,CACF,CAAwC;;AAE1C;AACA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
@@ -3,9 +3,11 @@
3
3
  Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
+ exports.addUiChangeListener = addUiChangeListener;
6
7
  exports.flush = flush;
7
8
  exports.getSessionId = getSessionId;
8
9
  exports.init = init;
10
+ exports.isRecording = isRecording;
9
11
  exports.privateInit = privateInit;
10
12
  exports.setDeviceId = setDeviceId;
11
13
  exports.setOptOut = setOptOut;
@@ -13,6 +15,7 @@ exports.setSessionId = setSessionId;
13
15
  exports.start = start;
14
16
  exports.stop = stop;
15
17
  exports.teardown = teardown;
18
+ var _reactNative = require("react-native");
16
19
  var _nativeModule = require("./native-module");
17
20
  var _sessionReplayConfig = require("./session-replay-config");
18
21
  var _logger = require("./logger");
@@ -321,4 +324,38 @@ async function privateInit(config, newLogger) {
321
324
  logger = newLogger;
322
325
  return init(config);
323
326
  }
327
+ const globalUiChangeListeners = new Set();
328
+ let uiChangeSubscription;
329
+ let uiChangeSubscriptionGeneration = 0;
330
+
331
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
332
+ function addUiChangeListener(listener) {
333
+ // Each registration gets its own entry, even when the callback is reused.
334
+ const registeredListener = timestamp => listener(timestamp);
335
+ globalUiChangeListeners.add(registeredListener);
336
+ if (!uiChangeSubscription) {
337
+ const generation = ++uiChangeSubscriptionGeneration;
338
+ uiChangeSubscription = new _reactNative.NativeEventEmitter(_nativeModule.NativeSessionReplay).addListener('amplitudeSessionReplayReactNativeUiChange', event => {
339
+ if (generation !== uiChangeSubscriptionGeneration) return;
340
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
341
+ const timestamp = typeof (event === null || event === void 0 ? void 0 : event.timestamp) === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
342
+ globalUiChangeListeners.forEach(callback => callback(timestamp));
343
+ });
344
+ }
345
+ return () => {
346
+ globalUiChangeListeners.delete(registeredListener);
347
+ if (globalUiChangeListeners.size === 0) {
348
+ var _uiChangeSubscription;
349
+ // Retire callbacks already queued for the previous native subscription.
350
+ uiChangeSubscriptionGeneration++;
351
+ (_uiChangeSubscription = uiChangeSubscription) === null || _uiChangeSubscription === void 0 || _uiChangeSubscription.remove();
352
+ uiChangeSubscription = undefined;
353
+ }
354
+ };
355
+ }
356
+
357
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
358
+ async function isRecording() {
359
+ return _nativeModule.NativeSessionReplay.isRecording();
360
+ }
324
361
  //# sourceMappingURL=session-replay.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["_nativeModule","require","_sessionReplayConfig","_logger","_version","normalizeConfig","config","maskLevel","privacyConfig","rest","undefined","isInitialized","logger","createSessionReplayLogger","CANONICAL_INTEGER","fromNativeSessionId","sessionId","test","numericSessionId","Number","isSafeInteger","normalizeNumericSessionId","isFinite","isInteger","warn","String","toNativeSessionId","init","resolvedConfig","getDefaultConfig","setLogLevel","logLevel","log","VERSION","NativeSessionReplay","setup","nativeConfig","error","setSessionId","setCustomSessionId","setDeviceId","deviceId","getSessionId","getCustomSessionId","flush","start","stop","setOptOut","optOut","teardown","resolvedMaskLevel","customSessionId","privateInit","newLogger"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["_reactNative","require","_nativeModule","_sessionReplayConfig","_logger","_version","normalizeConfig","config","maskLevel","privacyConfig","rest","undefined","isInitialized","logger","createSessionReplayLogger","CANONICAL_INTEGER","fromNativeSessionId","sessionId","test","numericSessionId","Number","isSafeInteger","normalizeNumericSessionId","isFinite","isInteger","warn","String","toNativeSessionId","init","resolvedConfig","getDefaultConfig","setLogLevel","logLevel","log","VERSION","NativeSessionReplay","setup","nativeConfig","error","setSessionId","setCustomSessionId","setDeviceId","deviceId","getSessionId","getCustomSessionId","flush","start","stop","setOptOut","optOut","teardown","resolvedMaskLevel","customSessionId","privateInit","newLogger","globalUiChangeListeners","Set","uiChangeSubscription","uiChangeSubscriptionGeneration","addUiChangeListener","listener","registeredListener","timestamp","add","generation","NativeEventEmitter","addListener","event","Date","now","forEach","callback","delete","size","_uiChangeSubscription","remove","isRecording"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAewB,WAAWA,CAACC,QAAuB,EAAiB;EACxE,IAAI,CAAC9B,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACM,WAAW,CAACC,QAAQ,CAAC;AACjD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,YAAYA,CAAA,EAAoC;EACpE,IAAI,CAAC/B,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C,OAAO,IAAI;EACb;EACA,OAAOT,mBAAmB,CAAC,MAAMmB,iCAAmB,CAACS,kBAAkB,CAAC,CAAC,CAAC;AAC5E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,KAAKA,CAAA,EAAkB;EAC3C,IAAI,CAACjC,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACU,KAAK,CAAC,CAAC;AACnC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,KAAKA,CAAA,EAAkB;EAC3C,IAAI,CAAClC,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACW,KAAK,CAAC,CAAC;AACnC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,IAAIA,CAAA,EAAkB;EAC1C,IAAI,CAACnC,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACY,IAAI,CAAC,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,SAASA,CAACC,MAAe,EAAiB;EAC9D,IAAI,CAACrC,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACa,SAAS,CAACC,MAAM,CAAC;AAC7C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeC,QAAQA,CAAA,EAAkB;EAC9C,IAAI,CAACtC,aAAa,EAAE;IAClBC,MAAM,CAACY,IAAI,CAAC,kCAAkC,CAAC;IAC/C;EACF;EACA,MAAMU,iCAAmB,CAACe,QAAQ,CAAC,CAAC;EACpCtC,aAAa,GAAG,KAAK;EACrBC,MAAM,GAAG,IAAAC,iCAAyB,EAAC,CAAC;AACtC;AAEA,SAASuB,YAAYA,CAAC9B,MAAmC,EAA6B;EACpF;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;IAAEE,aAAa;IAAEQ,SAAS;IAAE,GAAGP;EAAK,CAAC,GAAGH,MAAM;EACpD,MAAM4C,iBAAyD,GAAG1C,aAAa,CAACD,SAAS,IAAI,QAAQ;EACrG,OAAO;IACL,GAAGE,IAAI;IACPsB,QAAQ,EAAEtB,IAAI,CAACsB,QAAiD;IAChE;IACAxB,SAAS,EAAE2C,iBAAiB;IAC5BC,eAAe,EAAEzB,iBAAiB,CAACV,SAAS;EAC9C,CAAC;AACH;AAEO,eAAeoC,WAAWA,CAC/B9C,MAA2B,EAC3B+C,SAAuD,EACxC;EACfzC,MAAM,GAAGyC,SAAS;EAClB,OAAO1B,IAAI,CAACrB,MAAM,CAAC;AACrB;AAEA,MAAMgD,uBAAuB,GAAG,IAAIC,GAAG,CAA8B,CAAC;AACtE,IAAIC,oBAAqD;AACzD,IAAIC,8BAA8B,GAAG,CAAC;;AAEtC;AACO,SAASC,mBAAmBA,CAACC,QAAqC,EAAc;EACrF;EACA,MAAMC,kBAAkB,GAAIC,SAAiB,IAAKF,QAAQ,CAACE,SAAS,CAAC;EACrEP,uBAAuB,CAACQ,GAAG,CAACF,kBAAkB,CAAC;EAC/C,IAAI,CAACJ,oBAAoB,EAAE;IACzB,MAAMO,UAAU,GAAG,EAAEN,8BAA8B;IACnDD,oBAAoB,GAAG,IAAIQ,+BAAkB,CAAC9B,iCAAmB,CAAC,CAAC+B,WAAW,CAC5E,2CAA2C,EAC1CC,KAA8B,IAAK;MAClC,IAAIH,UAAU,KAAKN,8BAA8B,EAAE;MACnD;MACA,MAAMI,SAAS,GACb,QAAOK,KAAK,aAALA,KAAK,uBAALA,KAAK,CAAEL,SAAS,MAAK,QAAQ,IAAI1C,MAAM,CAACG,QAAQ,CAAC4C,KAAK,CAACL,SAAS,CAAC,GAAGK,KAAK,CAACL,SAAS,GAAGM,IAAI,CAACC,GAAG,CAAC,CAAC;MACzGd,uBAAuB,CAACe,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAACT,SAAS,CAAC,CAAC;IACpE,CACF,CAAC;EACH;EAEA,OAAO,MAAM;IACXP,uBAAuB,CAACiB,MAAM,CAACX,kBAAkB,CAAC;IAClD,IAAIN,uBAAuB,CAACkB,IAAI,KAAK,CAAC,EAAE;MAAA,IAAAC,qBAAA;MACtC;MACAhB,8BAA8B,EAAE;MAChC,CAAAgB,qBAAA,GAAAjB,oBAAoB,cAAAiB,qBAAA,eAApBA,qBAAA,CAAsBC,MAAM,CAAC,CAAC;MAC9BlB,oBAAoB,GAAG9C,SAAS;IAClC;EACF,CAAC;AACH;;AAEA;AACO,eAAeiE,WAAWA,CAAA,EAAqB;EACpD,OAAOzC,iCAAmB,CAACyC,WAAW,CAAC,CAAC;AAC1C","ignoreList":[]}
@@ -1 +1 @@
1
- {"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","get"],"sourceRoot":"../../../src","sources":["specs/NativeAmpSessionReplay.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AAeA;AACA;AACA;AACA;AACA;AAAA,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GACeC,gCAAmB,CAACC,GAAG,CAAO,wBAAwB,CAAC","ignoreList":[]}
1
+ {"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","get"],"sourceRoot":"../../../src","sources":["specs/NativeAmpSessionReplay.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AAkBA;AACA;AACA;AACA;AACA;AAAA,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GACeC,gCAAmB,CAACC,GAAG,CAAO,wBAAwB,CAAC","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 = '1.1.2-claudeconfident-mccarthy-373nfy.0';
7
+ const VERSION = exports.VERSION = '1.1.2';
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,yCAAyC","ignoreList":[]}
1
+ {"version":3,"names":["VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAO,MAAMA,OAAO,GAAAC,OAAA,CAAAD,OAAA,GAAG,OAAO","ignoreList":[]}
@@ -1,4 +1,4 @@
1
- export { init, setSessionId, getSessionId, flush, start, stop, setDeviceId, setOptOut, teardown } from './session-replay';
1
+ export { init, setSessionId, getSessionId, flush, start, stop, setDeviceId, setOptOut, teardown, addUiChangeListener, isRecording } from './session-replay';
2
2
  export { LogLevel } from './session-replay-config';
3
3
  export { AmpMaskView } from './amp-mask-view';
4
4
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["init","setSessionId","getSessionId","flush","start","stop","setDeviceId","setOptOut","teardown","LogLevel","AmpMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SACEA,IAAI,EACJC,YAAY,EACZC,YAAY,EACZC,KAAK,EACLC,KAAK,EACLC,IAAI,EACJC,WAAW,EACXC,SAAS,EACTC,QAAQ,QACH,kBAAkB;AAEzB,SAASC,QAAQ,QAAQ,yBAAyB;AAElD,SAASC,WAAW,QAA+B,iBAAiB","ignoreList":[]}
1
+ {"version":3,"names":["init","setSessionId","getSessionId","flush","start","stop","setDeviceId","setOptOut","teardown","addUiChangeListener","isRecording","LogLevel","AmpMaskView"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SACEA,IAAI,EACJC,YAAY,EACZC,YAAY,EACZC,KAAK,EACLC,KAAK,EACLC,IAAI,EACJC,WAAW,EACXC,SAAS,EACTC,QAAQ,EACRC,mBAAmB,EACnBC,WAAW,QACN,kBAAkB;AAEzB,SAASC,QAAQ,QAAQ,yBAAyB;AAElD,SAASC,WAAW,QAA+B,iBAAiB","ignoreList":[]}
@@ -27,7 +27,6 @@ export const NativeSessionReplay = SessionReplaySpec ?? new Proxy({}, {
27
27
  * This interface provides the contract for communication between JavaScript and
28
28
  * the native iOS/Android session replay modules through React Native's bridge.
29
29
  *
30
- * All methods are asynchronous and return Promises to handle the bridge communication
31
- * between JavaScript and native code.
30
+ * Lifecycle and recording-state queries return Promises; event subscription hooks are synchronous.
32
31
  */
33
32
  //# sourceMappingURL=native-module.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["Platform","SessionReplaySpec","LINKING_ERROR","select","ios","default","NativeSessionReplay","Proxy","get","Error"],"sourceRoot":"../../src","sources":["native-module.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,iBAAiB,MAAM,gCAAgC;AAE9D,MAAMC,aAAa,GACjB,iGAAiG,GACjGF,QAAQ,CAACG,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;;AAEjC;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAAIL,iBAAiB,IACnD,IAAIM,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CACF,CAAwC;;AAE1C;AACA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
1
+ {"version":3,"names":["Platform","SessionReplaySpec","LINKING_ERROR","select","ios","default","NativeSessionReplay","Proxy","get","Error"],"sourceRoot":"../../src","sources":["native-module.ts"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,iBAAiB,MAAM,gCAAgC;AAE9D,MAAMC,aAAa,GACjB,iGAAiG,GACjGF,QAAQ,CAACG,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;;AAEjC;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,GAAIL,iBAAiB,IACnD,IAAIM,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CACF,CAAwC;;AAE1C;AACA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA","ignoreList":[]}
@@ -1,5 +1,6 @@
1
1
  // @refresh reset
2
2
 
3
+ import { NativeEventEmitter } from 'react-native';
3
4
  import { NativeSessionReplay } from './native-module';
4
5
  import { getDefaultConfig } from './session-replay-config';
5
6
  import { createSessionReplayLogger } from './logger';
@@ -306,4 +307,38 @@ export async function privateInit(config, newLogger) {
306
307
  logger = newLogger;
307
308
  return init(config);
308
309
  }
310
+ const globalUiChangeListeners = new Set();
311
+ let uiChangeSubscription;
312
+ let uiChangeSubscriptionGeneration = 0;
313
+
314
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
315
+ export function addUiChangeListener(listener) {
316
+ // Each registration gets its own entry, even when the callback is reused.
317
+ const registeredListener = timestamp => listener(timestamp);
318
+ globalUiChangeListeners.add(registeredListener);
319
+ if (!uiChangeSubscription) {
320
+ const generation = ++uiChangeSubscriptionGeneration;
321
+ uiChangeSubscription = new NativeEventEmitter(NativeSessionReplay).addListener('amplitudeSessionReplayReactNativeUiChange', event => {
322
+ if (generation !== uiChangeSubscriptionGeneration) return;
323
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
324
+ const timestamp = typeof (event === null || event === void 0 ? void 0 : event.timestamp) === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
325
+ globalUiChangeListeners.forEach(callback => callback(timestamp));
326
+ });
327
+ }
328
+ return () => {
329
+ globalUiChangeListeners.delete(registeredListener);
330
+ if (globalUiChangeListeners.size === 0) {
331
+ var _uiChangeSubscription;
332
+ // Retire callbacks already queued for the previous native subscription.
333
+ uiChangeSubscriptionGeneration++;
334
+ (_uiChangeSubscription = uiChangeSubscription) === null || _uiChangeSubscription === void 0 || _uiChangeSubscription.remove();
335
+ uiChangeSubscription = undefined;
336
+ }
337
+ };
338
+ }
339
+
340
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
341
+ export async function isRecording() {
342
+ return NativeSessionReplay.isRecording();
343
+ }
309
344
  //# sourceMappingURL=session-replay.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["NativeSessionReplay","getDefaultConfig","createSessionReplayLogger","VERSION","normalizeConfig","config","maskLevel","privacyConfig","rest","undefined","isInitialized","logger","CANONICAL_INTEGER","fromNativeSessionId","sessionId","test","numericSessionId","Number","isSafeInteger","normalizeNumericSessionId","isFinite","isInteger","warn","String","toNativeSessionId","init","resolvedConfig","setLogLevel","logLevel","log","setup","nativeConfig","error","setSessionId","setCustomSessionId","setDeviceId","deviceId","getSessionId","getCustomSessionId","flush","start","stop","setOptOut","optOut","teardown","resolvedMaskLevel","customSessionId","privateInit","newLogger"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
1
+ {"version":3,"names":["NativeEventEmitter","NativeSessionReplay","getDefaultConfig","createSessionReplayLogger","VERSION","normalizeConfig","config","maskLevel","privacyConfig","rest","undefined","isInitialized","logger","CANONICAL_INTEGER","fromNativeSessionId","sessionId","test","numericSessionId","Number","isSafeInteger","normalizeNumericSessionId","isFinite","isInteger","warn","String","toNativeSessionId","init","resolvedConfig","setLogLevel","logLevel","log","setup","nativeConfig","error","setSessionId","setCustomSessionId","setDeviceId","deviceId","getSessionId","getCustomSessionId","flush","start","stop","setOptOut","optOut","teardown","resolvedMaskLevel","customSessionId","privateInit","newLogger","globalUiChangeListeners","Set","uiChangeSubscription","uiChangeSubscriptionGeneration","addUiChangeListener","listener","registeredListener","timestamp","add","generation","addListener","event","Date","now","forEach","callback","delete","size","_uiChangeSubscription","remove","isRecording"],"sourceRoot":"../../src","sources":["session-replay.ts"],"mappings":"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","ignoreList":[]}
@@ -1 +1 @@
1
- {"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../../src","sources":["specs/NativeAmpSessionReplay.ts"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,cAAc;AAClD;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,wBAAwB,CAAC","ignoreList":[]}
1
+ {"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../../src","sources":["specs/NativeAmpSessionReplay.ts"],"mappings":"AACA,SAASA,mBAAmB,QAAQ,cAAc;AAClD;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAkBA;AACA;AACA;AACA;AACA;AACA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,wBAAwB,CAAC","ignoreList":[]}
@@ -1,2 +1,2 @@
1
- export const VERSION = '1.1.2-claudeconfident-mccarthy-373nfy.0';
1
+ export const VERSION = '1.1.2';
2
2
  //# sourceMappingURL=version.js.map
@@ -1 +1 @@
1
- {"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,yCAAyC","ignoreList":[]}
1
+ {"version":3,"names":["VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":"AAAA,OAAO,MAAMA,OAAO,GAAG,OAAO","ignoreList":[]}
@@ -1,4 +1,4 @@
1
- export { init, setSessionId, getSessionId, flush, start, stop, setDeviceId, setOptOut, teardown, } from './session-replay';
1
+ export { init, setSessionId, getSessionId, flush, start, stop, setDeviceId, setOptOut, teardown, addUiChangeListener, isRecording, } from './session-replay';
2
2
  export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
3
3
  export { LogLevel } from './session-replay-config';
4
4
  export { AmpMaskView, type AmpMaskViewProps } from './amp-mask-view';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,KAAK,EACL,IAAI,EACJ,WAAW,EACX,SAAS,EACT,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,KAAK,EACL,IAAI,EACJ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -32,10 +32,14 @@ export interface NativeSessionReplayConfig {
32
32
  * This interface provides the contract for communication between JavaScript and
33
33
  * the native iOS/Android session replay modules through React Native's bridge.
34
34
  *
35
- * All methods are asynchronous and return Promises to handle the bridge communication
36
- * between JavaScript and native code.
35
+ * Lifecycle and recording-state queries return Promises; event subscription hooks are synchronous.
37
36
  */
38
37
  export interface NativeSessionReplaySpec {
38
+ /** Whether native replay is recording and providing UI change signals. */
39
+ isRecording(): Promise<boolean>;
40
+ /** NativeEventEmitter subscription hooks. */
41
+ addListener(eventName: string): void;
42
+ removeListeners(count: number): void;
39
43
  /**
40
44
  * Flushes any pending session replay data to the server.
41
45
  * Forces immediate upload of recorded session data that may be buffered locally.
@@ -1 +1 @@
1
- {"version":3,"file":"native-module.d.ts","sourceRoot":"","sources":["../../src/native-module.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,mBAAmB,yBAQU,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0EAA0E;IAC1E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC/C,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}
1
+ {"version":3,"file":"native-module.d.ts","sourceRoot":"","sources":["../../src/native-module.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,mBAAmB,yBAQU,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0EAA0E;IAC1E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,kEAAkE;IAClE,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;IAC/C,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,6CAA6C;IAC7C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}
@@ -132,4 +132,8 @@ export declare function setOptOut(optOut: boolean): Promise<void>;
132
132
  */
133
133
  export declare function teardown(): Promise<void>;
134
134
  export declare function privateInit(config: SessionReplayConfig, newLogger: ReturnType<typeof createSessionReplayLogger>): Promise<void>;
135
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
136
+ export declare function addUiChangeListener(listener: (timestamp: number) => void): () => void;
137
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
138
+ export declare function isRecording(): Promise<boolean>;
135
139
  //# sourceMappingURL=session-replay.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,mBAAmB,EAA+B,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAgErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAMpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1C;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9C;AAoBD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAGf"}
1
+ {"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/session-replay.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,mBAAmB,EAA+B,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAgErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAMpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1C;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9C;AAoBD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAGf;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,6 +1,9 @@
1
1
  import type { TurboModule } from 'react-native';
2
2
  import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
3
3
  export interface Spec extends TurboModule {
4
+ isRecording(): Promise<boolean>;
5
+ addListener(eventName: string): void;
6
+ removeListeners(count: number): void;
4
7
  setup(config: UnsafeObject): Promise<void>;
5
8
  setCustomSessionId(customSessionId: string): Promise<void>;
6
9
  getCustomSessionId(): Promise<string>;
@@ -1 +1 @@
1
- {"version":3,"file":"NativeAmpSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeAmpSessionReplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAQ9E,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3C,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;;AAOD,wBAAuE"}
1
+ {"version":3,"file":"NativeAmpSessionReplay.d.ts","sourceRoot":"","sources":["../../../src/specs/NativeAmpSessionReplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAQ9E,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3C,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;;AAOD,wBAAuE"}
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "1.1.2-claudeconfident-mccarthy-373nfy.0";
1
+ export declare const VERSION = "1.1.2";
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,4CAA4C,CAAC"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amplitude/session-replay-react-native",
3
- "version": "1.1.2-claudeconfident-mccarthy-373nfy.0",
3
+ "version": "1.1.2",
4
4
  "description": "Amplitude Session Replay for React Native",
5
5
  "keywords": [
6
6
  "analytics",
package/src/index.tsx CHANGED
@@ -8,6 +8,8 @@ export {
8
8
  setDeviceId,
9
9
  setOptOut,
10
10
  teardown,
11
+ addUiChangeListener,
12
+ isRecording,
11
13
  } from './session-replay';
12
14
  export { type SessionReplayConfig, type MaskLevel, type PrivacyConfig } from './session-replay-config';
13
15
  export { LogLevel } from './session-replay-config';
@@ -57,10 +57,15 @@ export interface NativeSessionReplayConfig {
57
57
  * This interface provides the contract for communication between JavaScript and
58
58
  * the native iOS/Android session replay modules through React Native's bridge.
59
59
  *
60
- * All methods are asynchronous and return Promises to handle the bridge communication
61
- * between JavaScript and native code.
60
+ * Lifecycle and recording-state queries return Promises; event subscription hooks are synchronous.
62
61
  */
63
62
  export interface NativeSessionReplaySpec {
63
+ /** Whether native replay is recording and providing UI change signals. */
64
+ isRecording(): Promise<boolean>;
65
+ /** NativeEventEmitter subscription hooks. */
66
+ addListener(eventName: string): void;
67
+ removeListeners(count: number): void;
68
+
64
69
  /**
65
70
  * Flushes any pending session replay data to the server.
66
71
  * Forces immediate upload of recorded session data that may be buffered locally.
@@ -1,5 +1,6 @@
1
1
  // @refresh reset
2
2
 
3
+ import { NativeEventEmitter, type EmitterSubscription } from 'react-native';
3
4
  import { NativeSessionReplay, type NativeSessionReplayConfig } from './native-module';
4
5
  import { getDefaultConfig, SessionReplayConfig, SessionReplayConfigInternal } from './session-replay-config';
5
6
  import { createSessionReplayLogger } from './logger';
@@ -306,3 +307,42 @@ export async function privateInit(
306
307
  logger = newLogger;
307
308
  return init(config);
308
309
  }
310
+
311
+ const globalUiChangeListeners = new Set<(timestamp: number) => void>();
312
+ let uiChangeSubscription: EmitterSubscription | undefined;
313
+ let uiChangeSubscriptionGeneration = 0;
314
+
315
+ /** Subscribe to UI changes with their Unix timestamp in milliseconds. Returns an unsubscribe function. */
316
+ export function addUiChangeListener(listener: (timestamp: number) => void): () => void {
317
+ // Each registration gets its own entry, even when the callback is reused.
318
+ const registeredListener = (timestamp: number) => listener(timestamp);
319
+ globalUiChangeListeners.add(registeredListener);
320
+ if (!uiChangeSubscription) {
321
+ const generation = ++uiChangeSubscriptionGeneration;
322
+ uiChangeSubscription = new NativeEventEmitter(NativeSessionReplay).addListener(
323
+ 'amplitudeSessionReplayReactNativeUiChange',
324
+ (event?: { timestamp?: number }) => {
325
+ if (generation !== uiChangeSubscriptionGeneration) return;
326
+ // Older native binaries sent no payload. Preserve their delivery-time fallback.
327
+ const timestamp =
328
+ typeof event?.timestamp === 'number' && Number.isFinite(event.timestamp) ? event.timestamp : Date.now();
329
+ globalUiChangeListeners.forEach((callback) => callback(timestamp));
330
+ },
331
+ );
332
+ }
333
+
334
+ return () => {
335
+ globalUiChangeListeners.delete(registeredListener);
336
+ if (globalUiChangeListeners.size === 0) {
337
+ // Retire callbacks already queued for the previous native subscription.
338
+ uiChangeSubscriptionGeneration++;
339
+ uiChangeSubscription?.remove();
340
+ uiChangeSubscription = undefined;
341
+ }
342
+ };
343
+ }
344
+
345
+ /** Resolves whether a native replay instance is recording and providing UI change signals. */
346
+ export async function isRecording(): Promise<boolean> {
347
+ return NativeSessionReplay.isRecording();
348
+ }
@@ -11,6 +11,9 @@ import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
11
11
  // public `SessionReplayConfig`. See native-module.ts for the typed facade that
12
12
  // JS callers actually use.
13
13
  export interface Spec extends TurboModule {
14
+ isRecording(): Promise<boolean>;
15
+ addListener(eventName: string): void;
16
+ removeListeners(count: number): void;
14
17
  setup(config: UnsafeObject): Promise<void>;
15
18
  // The RN SDK drives session identity through customSessionId only; the numeric
16
19
  // session id is mapped onto this (as a string) in the JS layer.
package/src/version.ts CHANGED
@@ -1 +1 @@
1
- export const VERSION = '1.1.2-claudeconfident-mccarthy-373nfy.0';
1
+ export const VERSION = '1.1.2';