@statsig/session-replay 3.16.1 → 3.16.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statsig/session-replay",
-  "version": "3.16.1",
+  "version": "3.16.2",
   "license": "ISC",
   "homepage": "https://github.com/statsig-io/js-client-monorepo",
   "repository": {
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "rrweb": "2.0.0-alpha.14",
-    "@statsig/client-core": "3.16.1"
+    "@statsig/client-core": "3.16.2"
   },
   "devDependencies": {
     "@rrweb/types": "2.0.0-alpha.14"

package/src/SessionReplay.js

@@ -39,6 +39,10 @@ class SessionReplay extends SessionReplayBase_1.SessionReplayBase {
             this._shutdown();
             return;
         }
+        if ((values === null || values === void 0 ? void 0 : values.passes_session_recording_targeting) === false) {
+            this._shutdown();
+            return;
+        }
         if (this._replayer.isRecording()) {
             return;
         }

package/src/SessionReplayBase.d.ts

@@ -28,6 +28,7 @@ export declare abstract class SessionReplayBase {
     protected _getSessionIdFromClient(): string;
     protected abstract _shutdown(endReason?: EndReason): void;
     protected _shutdownImpl(endReason?: EndReason): void;
+    private _makeEmptySessionData;
     protected _onRecordingEvent(event: ReplayEvent, data: ReplaySessionData): void;
 }
 export {};

package/src/SessionReplayBase.js

@@ -8,7 +8,7 @@ const SizeOf_1 = require("./SizeOf");
 class SessionReplayBase {
     constructor(client, options) {
         this._sessionData = {
-            startTime: 0,
+            startTime: -1,
             endTime: 0,
             clickCount: 0,
         };
@@ -106,13 +106,24 @@ class SessionReplayBase {
     _shutdownImpl(endReason) {
         this._replayer.stop();
         client_core_1.StatsigMetadataProvider.add({ isRecordingSession: 'false' });
-        this._currentEventIndex = 0;
         if (this._events.length === 0) {
+            // only reset if session expired otherwise we might start recording again
+            if (endReason === 'session_expired') {
+                this._currentEventIndex = 0;
+                this._sessionData = this._makeEmptySessionData();
+            }
             return;
         }
         this._logRecording(endReason);
-        this._sessionData = {
-            startTime: 0,
+        // only reset if session expired otherwise we might start recording again
+        if (endReason === 'session_expired') {
+            this._currentEventIndex = 0;
+            this._sessionData = this._makeEmptySessionData();
+        }
+    }
+    _makeEmptySessionData() {
+        return {
+            startTime: -1,
             endTime: 0,
             clickCount: 0,
         };
@@ -126,7 +137,10 @@ class SessionReplayBase {
         event.eventIndex = this._currentEventIndex++;
         // Update the session data
         this._sessionData.clickCount += data.clickCount;
-        this._sessionData.startTime = Math.min(this._sessionData.startTime, data.startTime);
+        this._sessionData.startTime =
+            this._sessionData.startTime === -1
+                ? data.startTime
+                : Math.min(this._sessionData.startTime, data.startTime);
         this._sessionData.endTime = Math.max(this._sessionData.endTime, data.endTime);
         const eventApproxSize = (0, SizeOf_1._fastApproxSizeOf)(event, SessionReplayUtils_1.MAX_INDIVIDUAL_EVENT_BYTES);
         if (eventApproxSize > SessionReplayUtils_1.MAX_INDIVIDUAL_EVENT_BYTES) {

package/src/SessionReplayClient.d.ts

@@ -15,7 +15,6 @@ export declare class SessionReplayClient {
     private _stopCallback?;
     private _startTimestamp;
     private _endTimestamp;
-    private _eventCounter;
     record(callback: (latest: ReplayEvent, data: ReplaySessionData, isCheckout?: boolean) => void, config: RRWebConfig, stopCallback?: () => void, keepRollingWindow?: boolean): void;
     stop(): void;
     isRecording(): boolean;

package/src/SessionReplayClient.js

@@ -4,12 +4,11 @@ exports.SessionReplayClient = void 0;
 const rrweb = require("rrweb");
 const client_core_1 = require("@statsig/client-core");
 const TIMEOUT_MS = 1000 * 60 * 60 * 4; // 4 hours
-const CHECKOUT_WINDOW_MS = 1000 * 60; // 1 minute
+const CHECKOUT_WINDOW_MS = 1000 * 30; // 30 seconds
 class SessionReplayClient {
     constructor() {
         this._startTimestamp = null;
         this._endTimestamp = null;
-        this._eventCounter = 0;
     }
     record(callback, config, stopCallback, keepRollingWindow = false) {
         if ((0, client_core_1._getDocumentSafe)() == null) {
@@ -18,7 +17,6 @@ class SessionReplayClient {
         // Always reset session id and tracking fields for a new recording
         this._startTimestamp = null;
         this._endTimestamp = null;
-        this._eventCounter = 0;
         this._stopCallback = stopCallback;
         if (this._stopFn) {
             return;

package/src/TriggeredSessionReplay.d.ts

@@ -17,6 +17,7 @@ export declare class StatsigTriggeredSessionReplayPlugin implements StatsigPlugi
 }
 export declare function runStatsigSessionReplay(client: PrecomputedEvaluationsInterface, options?: SessionReplayOptions): void;
 export declare function startRecording(sdkKey: string): void;
+export declare function forceStartRecording(sdkKey: string): void;
 export declare function stopRecording(sdkKey: string): void;
 export declare class TriggeredSessionReplay extends SessionReplayBase {
     private _runningEventData;

package/src/TriggeredSessionReplay.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TriggeredSessionReplay = exports.stopRecording = exports.startRecording = exports.runStatsigSessionReplay = exports.StatsigTriggeredSessionReplayPlugin = void 0;
+exports.TriggeredSessionReplay = exports.stopRecording = exports.forceStartRecording = exports.startRecording = exports.runStatsigSessionReplay = exports.StatsigTriggeredSessionReplayPlugin = void 0;
 const client_core_1 = require("@statsig/client-core");
 const SessionReplayBase_1 = require("./SessionReplayBase");
 class StatsigTriggeredSessionReplayPlugin {
@@ -25,6 +25,14 @@ function startRecording(sdkKey) {
     }
 }
 exports.startRecording = startRecording;
+function forceStartRecording(sdkKey) {
+    var _a, _b;
+    const inst = (_b = (_a = (0, client_core_1._getStatsigGlobal)()) === null || _a === void 0 ? void 0 : _a.srInstances) === null || _b === void 0 ? void 0 : _b[sdkKey];
+    if (inst instanceof TriggeredSessionReplay) {
+        inst.forceStartRecording();
+    }
+}
+exports.forceStartRecording = forceStartRecording;
 function stopRecording(sdkKey) {
     var _a, _b;
     const inst = (_b = (_a = (0, client_core_1._getStatsigGlobal)()) === null || _a === void 0 ? void 0 : _a.srInstances) === null || _b === void 0 ? void 0 : _b[sdkKey];
@@ -50,6 +58,56 @@ class TriggeredSessionReplay extends SessionReplayBase_1.SessionReplayBase {
                 }
             }
         });
+        this._client.$on('log_event_called', (event) => {
+            var _a;
+            if (this._wasStopped) {
+                return;
+            }
+            const values = this._client.getContext().values;
+            const passedTargeting = values === null || values === void 0 ? void 0 : values.passes_session_recording_targeting;
+            if (passedTargeting === false ||
+                (values === null || values === void 0 ? void 0 : values.session_recording_event_triggers) == null) {
+                return;
+            }
+            const trigger = values.session_recording_event_triggers[event.event.eventName];
+            if (trigger == null) {
+                return;
+            }
+            const targetValues = trigger.values;
+            if (targetValues == null) {
+                this._attemptToStartRecording(true);
+                return;
+            }
+            if (targetValues.includes(String((_a = event.event.value) !== null && _a !== void 0 ? _a : ''))) {
+                this._attemptToStartRecording(true);
+                return;
+            }
+        });
+        this._client.$on('gate_evaluation', (event) => {
+            var _a, _b;
+            if (this._wasStopped) {
+                return;
+            }
+            const values = this._client.getContext().values;
+            const passedTargeting = values === null || values === void 0 ? void 0 : values.passes_session_recording_targeting;
+            if (passedTargeting === false ||
+                (values === null || values === void 0 ? void 0 : values.session_recording_exposure_triggers) == null) {
+                return;
+            }
+            const trigger = (_a = values.session_recording_exposure_triggers[event.gate.name]) !== null && _a !== void 0 ? _a : values.session_recording_exposure_triggers[(0, client_core_1._DJB2)(event.gate.name)];
+            if (trigger == null) {
+                return;
+            }
+            const targetValues = trigger.values;
+            if (targetValues == null) {
+                this._attemptToStartRecording(true);
+                return;
+            }
+            if (targetValues.includes(String((_b = event.gate.value) !== null && _b !== void 0 ? _b : false))) {
+                this._attemptToStartRecording(true);
+                return;
+            }
+        });
         if (options === null || options === void 0 ? void 0 : options.autoStartRecording) {
             this._attemptToStartRecording((_a = this._options) === null || _a === void 0 ? void 0 : _a.forceRecording);
         }
@@ -79,7 +137,10 @@ class TriggeredSessionReplay extends SessionReplayBase_1.SessionReplayBase {
         for (let i = 0; i < currentEvents.length; i++) {
             currentEvents[i].event.eventIndex = i;
             this._sessionData.clickCount += currentEvents[i].data.clickCount;
-            this._sessionData.startTime = Math.min(this._sessionData.startTime, currentEvents[i].data.startTime);
+            this._sessionData.startTime =
+                this._sessionData.startTime === -1
+                    ? currentEvents[i].data.startTime
+                    : Math.min(this._sessionData.startTime, currentEvents[i].data.startTime);
             this._sessionData.endTime = Math.max(this._sessionData.endTime, currentEvents[i].data.endTime);
         }
         this._events = currentEvents.map((e) => e.event);
@@ -90,6 +151,8 @@ class TriggeredSessionReplay extends SessionReplayBase_1.SessionReplayBase {
         else {
             this._logRecording();
         }
+        // stop recording and since it will be started again
+        this._replayer.stop();
     }
     _shutdown(endReason) {
         this._isActiveRecording = false;
@@ -124,7 +187,7 @@ class TriggeredSessionReplay extends SessionReplayBase_1.SessionReplayBase {
     _attemptToStartRollingWindow() {
         var _a, _b;
         const values = this._client.getContext().values;
-        if ((values === null || values === void 0 ? void 0 : values.can_record_session) !== true) {
+        if ((values === null || values === void 0 ? void 0 : values.passes_session_recording_targeting) === false) {
             this._shutdown();
             return;
         }
@@ -142,6 +205,10 @@ class TriggeredSessionReplay extends SessionReplayBase_1.SessionReplayBase {
             this._shutdown();
             return;
         }
+        if ((values === null || values === void 0 ? void 0 : values.passes_session_recording_targeting) === false) {
+            this._shutdown();
+            return;
+        }
         this._handleStartActiveRecording();
         this._wasStopped = false;
         client_core_1.StatsigMetadataProvider.add({ isRecordingSession: 'true' });

package/src/index.d.ts

@@ -1,5 +1,5 @@
 import { SessionReplay, StatsigSessionReplayPlugin, runStatsigSessionReplay } from './SessionReplay';
 import { SessionReplayClient } from './SessionReplayClient';
-import { StatsigTriggeredSessionReplayPlugin, startRecording, stopRecording } from './TriggeredSessionReplay';
+import { StatsigTriggeredSessionReplayPlugin, forceStartRecording, startRecording, stopRecording } from './TriggeredSessionReplay';
 export type { ReplaySessionData as ReplayData, ReplayEvent, } from './SessionReplayClient';
-export { SessionReplayClient, SessionReplay, runStatsigSessionReplay, StatsigSessionReplayPlugin, StatsigTriggeredSessionReplayPlugin, startRecording, stopRecording, };
+export { SessionReplayClient, SessionReplay, runStatsigSessionReplay, StatsigSessionReplayPlugin, StatsigTriggeredSessionReplayPlugin, startRecording, stopRecording, forceStartRecording, };

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.stopRecording = exports.startRecording = exports.StatsigTriggeredSessionReplayPlugin = exports.StatsigSessionReplayPlugin = exports.runStatsigSessionReplay = exports.SessionReplay = exports.SessionReplayClient = void 0;
+exports.forceStartRecording = exports.stopRecording = exports.startRecording = exports.StatsigTriggeredSessionReplayPlugin = exports.StatsigSessionReplayPlugin = exports.runStatsigSessionReplay = exports.SessionReplay = exports.SessionReplayClient = void 0;
 const client_core_1 = require("@statsig/client-core");
 const SessionReplay_1 = require("./SessionReplay");
 Object.defineProperty(exports, "SessionReplay", { enumerable: true, get: function () { return SessionReplay_1.SessionReplay; } });
@@ -10,6 +10,7 @@ const SessionReplayClient_1 = require("./SessionReplayClient");
 Object.defineProperty(exports, "SessionReplayClient", { enumerable: true, get: function () { return SessionReplayClient_1.SessionReplayClient; } });
 const TriggeredSessionReplay_1 = require("./TriggeredSessionReplay");
 Object.defineProperty(exports, "StatsigTriggeredSessionReplayPlugin", { enumerable: true, get: function () { return TriggeredSessionReplay_1.StatsigTriggeredSessionReplayPlugin; } });
+Object.defineProperty(exports, "forceStartRecording", { enumerable: true, get: function () { return TriggeredSessionReplay_1.forceStartRecording; } });
 Object.defineProperty(exports, "startRecording", { enumerable: true, get: function () { return TriggeredSessionReplay_1.startRecording; } });
 Object.defineProperty(exports, "stopRecording", { enumerable: true, get: function () { return TriggeredSessionReplay_1.stopRecording; } });
 Object.assign((0, client_core_1._getStatsigGlobal)(), {