@safaricom-mxl/web-sdk 0.0.16 → 0.0.18

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.cjs

@@ -0,0 +1,240 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+const require_constants_attributes = require("../../../constants/attributes.cjs");
+const require_instrumentations_MXLInstrumentationBase_MXLInstrumentationBase = require("../../MXLInstrumentationBase/MXLInstrumentationBase.cjs");
+const require_instrumentations_replay_utils_session_recording_utils = require("../utils/session-recording-utils.cjs");
+const require_instrumentations_replay_ReplayInstrumentation_constants = require("./constants.cjs");
+const require_instrumentations_replay_rrwebLoader_loadRrwebModule_esm = require("../rrwebLoader/loadRrwebModule.esm.cjs");
+let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+//#region src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts
+var ReplayInstrumentation = class extends require_instrumentations_MXLInstrumentationBase_MXLInstrumentationBase.MXLInstrumentationBase {
+	_flushIntervalMs;
+	_maxBufferSize;
+	_recordUserSessions;
+	_rrwebUserOptions;
+	_debug;
+	_eventBuffer = [];
+	_flushIntervalId;
+	_removeSessionEndListener;
+	_removeSessionStartedListener;
+	_stopRecording;
+	_rrwebModule;
+	_mutationRateLimiter;
+	_lastKnownSession = "";
+	_sessionStartTime = 0;
+	_paused = false;
+	_enableRequested = false;
+	_startInProgress = false;
+	_queuedFullSnapshotTimeout;
+	_destroyed = false;
+	constructor({ diag, perf, flushIntervalMs = require_instrumentations_replay_ReplayInstrumentation_constants.DEFAULT_FLUSH_INTERVAL_MS, maxBufferSize = 50, recordUserSessions = true, rrwebOptions } = {}) {
+		super({
+			config: {},
+			diag,
+			instrumentationName: "ReplayInstrumentation",
+			instrumentationVersion: "1.0.0",
+			perf
+		});
+		this._flushIntervalMs = flushIntervalMs;
+		this._maxBufferSize = maxBufferSize;
+		this._recordUserSessions = recordUserSessions;
+		this._debug = rrwebOptions?.debug ?? false;
+		this._rrwebUserOptions = rrwebOptions;
+		if (!this._config.enabled) this._diag.debug("disabled, not starting");
+	}
+	setUserSessionManager(userSessionManager) {
+		super.setUserSessionManager(userSessionManager);
+		this._registerSessionEndListener();
+	}
+	isRecording() {
+		return Boolean(this._stopRecording) && !this._paused;
+	}
+	enable(options) {
+		if (!this._recordUserSessions && !options?.force) {
+			this._diag.debug("recordUserSessions disabled, waiting for manual enable");
+			return;
+		}
+		this._enableRequested = true;
+		this._paused = false;
+		this._tryStartRecording();
+	}
+	pause() {
+		if (!this._stopRecording) return;
+		this._enableRequested = false;
+		this._paused = true;
+		clearTimeout(this._flushIntervalId);
+		this._flushIntervalId = void 0;
+	}
+	resume() {
+		if (!this._stopRecording) {
+			this.enable();
+			return;
+		}
+		const wasPaused = this._paused;
+		this._enableRequested = true;
+		this._paused = false;
+		if (wasPaused) {
+			this._scheduleFlush();
+			this._rrwebModule?.record.takeFullSnapshot();
+		}
+	}
+	_scheduleFlush() {
+		if (this._destroyed || this._flushIntervalId || this._paused || !this._stopRecording) return;
+		this._flushIntervalId = setTimeout(() => {
+			this._flushIntervalId = void 0;
+			if (this._destroyed || this._paused || !this._stopRecording) return;
+			this._flush();
+			this._scheduleFlush();
+		}, this._flushIntervalMs);
+	}
+	disable() {
+		this._destroyed = true;
+		this._enableRequested = false;
+		this._paused = false;
+		clearTimeout(this._flushIntervalId);
+		this._flushIntervalId = void 0;
+		this._removeSessionEndListener?.();
+		this._removeSessionEndListener = void 0;
+		this._removeSessionStartedListener?.();
+		this._removeSessionStartedListener = void 0;
+		clearTimeout(this._queuedFullSnapshotTimeout);
+		this._queuedFullSnapshotTimeout = void 0;
+		if (this._stopRecording) {
+			this._diag.debug("stopping recording");
+			this._stopRecording();
+			this._stopRecording = void 0;
+			this._flush();
+		}
+		this._mutationRateLimiter?.destroy();
+		this._mutationRateLimiter = void 0;
+	}
+	_registerSessionEndListener() {
+		if (!this._stopRecording) return;
+		this._removeSessionEndListener?.();
+		this._removeSessionEndListener = this.userSessionManager.addSessionPartEndedListener(() => {
+			try {
+				this._flush();
+			} catch (error) {
+				this._diag.error("error flushing on session end", error);
+			}
+		});
+	}
+	async _tryStartRecording() {
+		if (!this._enableRequested || this._stopRecording || this._startInProgress) return;
+		if (typeof window === "undefined") {
+			this._diag.warn("session replay cannot run in non-browser environments");
+			return;
+		}
+		if (this.userSessionManager.getUserSessionId() === null) {
+			if (!this._removeSessionStartedListener) this._removeSessionStartedListener = this.userSessionManager.addSessionPartStartedListener(() => {
+				this._removeSessionStartedListener?.();
+				this._removeSessionStartedListener = void 0;
+				this._tryStartRecording();
+			});
+			return;
+		}
+		this._startInProgress = true;
+		try {
+			this._rrwebModule = await require_instrumentations_replay_rrwebLoader_loadRrwebModule_esm.loadRrwebModule();
+			if (!this._enableRequested || this._stopRecording) return;
+			this._lastKnownSession = this.userSessionManager.getUserSessionId() ?? "";
+			this._sessionStartTime = Date.now();
+			const { record } = this._rrwebModule;
+			const { debug: _debug, ...rrwebOptions } = this._rrwebUserOptions ?? {};
+			this._mutationRateLimiter = this._mutationRateLimiter ?? new require_instrumentations_replay_utils_session_recording_utils.MutationRateLimiter(record, { onBlockedNode: (id, node) => {
+				const message = `MXL Session Replay: Rate limiting recording mutations on node ${id}. This can be due to excessive animations.`;
+				if (this._debug) console.warn(message, node);
+				clearTimeout(this._queuedFullSnapshotTimeout);
+				this._queuedFullSnapshotTimeout = setTimeout(() => {
+					record.takeFullSnapshot();
+				}, 1e3);
+			} });
+			const stopFn = record({
+				maskAllInputs: true,
+				maskTextSelector: "*",
+				...rrwebOptions,
+				emit: this._onEvent
+			});
+			if (!stopFn) {
+				this._diag.warn("record() returned undefined, did not start");
+				return;
+			}
+			this._stopRecording = stopFn;
+			this._scheduleFlush();
+			this._registerSessionEndListener();
+			this._diag.debug("recording started");
+		} catch (error) {
+			this._diag.error("failed to start recording", error);
+		} finally {
+			this._startInProgress = false;
+		}
+	}
+	_onEvent = (srcEvent) => {
+		if (this._paused) return;
+		const currentSession = this.userSessionManager.getUserSessionId() ?? "";
+		if (currentSession !== this._lastKnownSession) {
+			if (typeof document !== "undefined" && document.hidden) return;
+			this._lastKnownSession = currentSession;
+			this._sessionStartTime = Date.now();
+			this._rrwebModule?.record.takeFullSnapshot();
+		}
+		if (srcEvent.timestamp > this._sessionStartTime + 1446e4) return;
+		const event = this._mutationRateLimiter ? this._mutationRateLimiter.throttleMutations(srcEvent) : srcEvent;
+		if (!event) return;
+		this._diag.debug("event received", event.type);
+		this._eventBuffer.push(event);
+		if (this._eventBuffer.length >= this._maxBufferSize) this._flush();
+	};
+	_flush() {
+		if (this._eventBuffer.length === 0 || this._paused) return;
+		this._diag.debug("flushing", this._eventBuffer.length, "events");
+		const events = this._eventBuffer;
+		this._eventBuffer = [];
+		try {
+			this._emitEventBatches(events);
+		} catch (error) {
+			this._diag.error("failed to save events", error);
+		}
+	}
+	_emitEventBatches(events) {
+		let batchStart = 0;
+		while (batchStart < events.length) {
+			let batchEnd = events.length;
+			while (batchEnd > batchStart) {
+				const slice = events.slice(batchStart, batchEnd);
+				const json = require_instrumentations_replay_utils_session_recording_utils.ensureStringifiedMaxMessageSize(JSON.stringify(slice));
+				if (json.length <= 5e6) {
+					this._emitBatch(slice, json);
+					batchStart = batchEnd;
+					break;
+				}
+				batchEnd--;
+			}
+			if (batchEnd === batchStart) {
+				const slice = events.slice(batchStart, batchStart + 1);
+				const json = require_instrumentations_replay_utils_session_recording_utils.ensureStringifiedMaxMessageSize(JSON.stringify(slice));
+				this._emitBatch(slice, json);
+				batchStart++;
+			}
+		}
+	}
+	_emitBatch(events, json) {
+		if (this._debug) console.log("replay batch", events.length, json.length);
+		this.logger.emit({
+			attributes: {
+				[require_constants_attributes.KEY_MXL_TYPE]: "ux.replay",
+				[require_instrumentations_replay_ReplayInstrumentation_constants.KEY_REPLAY_EVENTS]: json,
+				[require_instrumentations_replay_ReplayInstrumentation_constants.KEY_REPLAY_COUNT]: events.length
+			},
+			eventName: "replay",
+			severityNumber: _opentelemetry_api_logs.SeverityNumber.INFO
+		});
+	}
+};
+//#endregion
+exports.ReplayInstrumentation = ReplayInstrumentation;
+exports.loadRrwebModule = require_instrumentations_replay_rrwebLoader_loadRrwebModule_esm.loadRrwebModule;
+exports.resetRrwebModuleCacheForTests = require_instrumentations_replay_rrwebLoader_loadRrwebModule_esm.resetRrwebModuleCacheForTests;
+exports.setRrwebModuleLoaderForTests = require_instrumentations_replay_rrwebLoader_loadRrwebModule_esm.setRrwebModuleLoaderForTests;
+
+//# sourceMappingURL=ReplayInstrumentation.cjs.map

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayInstrumentation.cjs","names":["MXLInstrumentationBase","DEFAULT_FLUSH_INTERVAL_MS","loadRrwebModule","MutationRateLimiter","ensureStringifiedMaxMessageSize","KEY_MXL_TYPE","KEY_REPLAY_EVENTS","KEY_REPLAY_COUNT","SeverityNumber"],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts"],"sourcesContent":["import { SeverityNumber } from '@opentelemetry/api-logs';\nimport type { eventWithTime } from 'rrweb';\nimport { KEY_MXL_TYPE, MXL_TYPES } from '../../../constants/attributes';\nimport { MXLInstrumentationBase } from '../../MXLInstrumentationBase/MXLInstrumentationBase';\nimport { MAX_MESSAGE_SIZE, MutationRateLimiter, ensureStringifiedMaxMessageSize } from '../utils/session-recording-utils';\nimport {\n  DEFAULT_FLUSH_INTERVAL_MS,\n  DEFAULT_MAX_BUFFER_SIZE,\n  KEY_REPLAY_COUNT,\n  KEY_REPLAY_EVENTS,\n  MAX_RECORDING_LENGTH_MS,\n} from './constants';\nimport { loadRrwebModule } from '../rrwebLoader/loadRrwebModule';\nimport type { RrwebModule } from '../rrwebLoader/types';\nimport type { ReplayInstrumentationArgs } from './types';\n\nexport {\n  loadRrwebModule,\n  resetRrwebModuleCacheForTests,\n  setRrwebModuleLoaderForTests,\n} from '../rrwebLoader/loadRrwebModule';\n\nexport class ReplayInstrumentation extends MXLInstrumentationBase {\n  private readonly _flushIntervalMs: number;\n  private readonly _maxBufferSize: number;\n  private readonly _recordUserSessions: boolean;\n  private readonly _rrwebUserOptions: ReplayInstrumentationArgs['rrwebOptions'];\n  private readonly _debug: boolean;\n\n  private _eventBuffer: eventWithTime[] = [];\n  private _flushIntervalId?: ReturnType<typeof setTimeout>;\n  private _removeSessionEndListener?: () => void;\n  private _removeSessionStartedListener?: () => void;\n  private _stopRecording?: () => void;\n  private _rrwebModule?: RrwebModule;\n  private _mutationRateLimiter?: MutationRateLimiter;\n  private _lastKnownSession = '';\n  private _sessionStartTime = 0;\n  private _paused = false;\n  private _enableRequested = false;\n  private _startInProgress = false;\n  private _queuedFullSnapshotTimeout?: ReturnType<typeof setTimeout>;\n  private _destroyed = false;\n\n  public constructor({\n    diag,\n    perf,\n    flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS,\n    maxBufferSize = DEFAULT_MAX_BUFFER_SIZE,\n    recordUserSessions = true,\n    rrwebOptions,\n  }: ReplayInstrumentationArgs = {}) {\n    super({\n      config: {},\n      diag,\n      instrumentationName: 'ReplayInstrumentation',\n      instrumentationVersion: '1.0.0',\n      perf,\n    });\n\n    this._flushIntervalMs = flushIntervalMs;\n    this._maxBufferSize = maxBufferSize;\n    this._recordUserSessions = recordUserSessions;\n    this._debug = rrwebOptions?.debug ?? false;\n    this._rrwebUserOptions = rrwebOptions;\n\n    if (!this._config.enabled) {\n      this._diag.debug('disabled, not starting');\n    }\n  }\n\n  public override setUserSessionManager(\n    userSessionManager: Parameters<\n      MXLInstrumentationBase['setUserSessionManager']\n    >[0],\n  ): void {\n    super.setUserSessionManager(userSessionManager);\n    this._registerSessionEndListener();\n  }\n\n  public isRecording(): boolean {\n    return Boolean(this._stopRecording) && !this._paused;\n  }\n\n  public enable(options?: { force?: boolean }): void {\n    if (!this._recordUserSessions && !options?.force) {\n      this._diag.debug(\n        'recordUserSessions disabled, waiting for manual enable',\n      );\n      return;\n    }\n\n    this._enableRequested = true;\n    this._paused = false;\n    void this._tryStartRecording();\n  }\n\n  public pause(): void {\n    if (!this._stopRecording) {\n      return;\n    }\n\n    this._enableRequested = false;\n    this._paused = true;\n    clearTimeout(this._flushIntervalId);\n    this._flushIntervalId = undefined;\n  }\n\n  public resume(): void {\n    if (!this._stopRecording) {\n      this.enable();\n      return;\n    }\n\n    const wasPaused = this._paused;\n    this._enableRequested = true;\n    this._paused = false;\n\n    if (wasPaused) {\n      this._scheduleFlush();\n      this._rrwebModule?.record.takeFullSnapshot();\n    }\n  }\n\n  private _scheduleFlush(): void {\n    if (\n      this._destroyed ||\n      this._flushIntervalId ||\n      this._paused ||\n      !this._stopRecording\n    ) {\n      return;\n    }\n\n    this._flushIntervalId = setTimeout(() => {\n      this._flushIntervalId = undefined;\n      if (this._destroyed || this._paused || !this._stopRecording) {\n        return;\n      }\n      this._flush();\n      this._scheduleFlush();\n    }, this._flushIntervalMs);\n  }\n\n  public disable(): void {\n    this._destroyed = true;\n    this._enableRequested = false;\n    this._paused = false;\n\n    clearTimeout(this._flushIntervalId);\n    this._flushIntervalId = undefined;\n    this._removeSessionEndListener?.();\n    this._removeSessionEndListener = undefined;\n    this._removeSessionStartedListener?.();\n    this._removeSessionStartedListener = undefined;\n    clearTimeout(this._queuedFullSnapshotTimeout);\n    this._queuedFullSnapshotTimeout = undefined;\n\n    if (this._stopRecording) {\n      this._diag.debug('stopping recording');\n      this._stopRecording();\n      this._stopRecording = undefined;\n      this._flush();\n    }\n\n    this._mutationRateLimiter?.destroy();\n    this._mutationRateLimiter = undefined;\n  }\n\n  private _registerSessionEndListener(): void {\n    if (!this._stopRecording) {\n      return;\n    }\n\n    this._removeSessionEndListener?.();\n    this._removeSessionEndListener =\n      this.userSessionManager.addSessionPartEndedListener(() => {\n        try {\n          this._flush();\n        } catch (error) {\n          this._diag.error('error flushing on session end', error);\n        }\n      });\n  }\n\n  private async _tryStartRecording(): Promise<void> {\n    if (\n      !this._enableRequested ||\n      this._stopRecording ||\n      this._startInProgress\n    ) {\n      return;\n    }\n\n    if (typeof window === 'undefined') {\n      this._diag.warn('session replay cannot run in non-browser environments');\n      return;\n    }\n\n    if (this.userSessionManager.getUserSessionId() === null) {\n      if (!this._removeSessionStartedListener) {\n        this._removeSessionStartedListener =\n          this.userSessionManager.addSessionPartStartedListener(() => {\n            this._removeSessionStartedListener?.();\n            this._removeSessionStartedListener = undefined;\n            void this._tryStartRecording();\n          });\n      }\n      return;\n    }\n\n    this._startInProgress = true;\n\n    try {\n      this._rrwebModule = await loadRrwebModule();\n      if (!this._enableRequested || this._stopRecording) {\n        return;\n      }\n\n      this._lastKnownSession = this.userSessionManager.getUserSessionId() ?? '';\n      this._sessionStartTime = Date.now();\n\n      const { record } = this._rrwebModule;\n      const { debug: _debug, ...rrwebOptions } = this._rrwebUserOptions ?? {};\n\n      this._mutationRateLimiter =\n        this._mutationRateLimiter ??\n        new MutationRateLimiter(record, {\n          onBlockedNode: (id, node) => {\n            const message = `MXL Session Replay: Rate limiting recording mutations on node ${id}. This can be due to excessive animations.`;\n            if (this._debug) {\n              // oxlint-disable-next-line no-console -- debug-only replay diagnostics\n              console.warn(message, node);\n            }\n\n            clearTimeout(this._queuedFullSnapshotTimeout);\n            this._queuedFullSnapshotTimeout = setTimeout(() => {\n              record.takeFullSnapshot();\n            }, 1000);\n          },\n        });\n\n      const stopFn = record({\n        maskAllInputs: true,\n        maskTextSelector: '*',\n        ...rrwebOptions,\n        emit: this._onEvent,\n      });\n\n      if (!stopFn) {\n        this._diag.warn('record() returned undefined, did not start');\n        return;\n      }\n\n      this._stopRecording = stopFn;\n      this._scheduleFlush();\n      this._registerSessionEndListener();\n      this._diag.debug('recording started');\n    } catch (error) {\n      this._diag.error('failed to start recording', error);\n    } finally {\n      this._startInProgress = false;\n    }\n  }\n\n  private readonly _onEvent = (srcEvent: eventWithTime) => {\n    if (this._paused) {\n      return;\n    }\n\n    const currentSession = this.userSessionManager.getUserSessionId() ?? '';\n    if (currentSession !== this._lastKnownSession) {\n      if (typeof document !== 'undefined' && document.hidden) {\n        return;\n      }\n      this._lastKnownSession = currentSession;\n      this._sessionStartTime = Date.now();\n      this._rrwebModule?.record.takeFullSnapshot();\n    }\n\n    if (srcEvent.timestamp > this._sessionStartTime + MAX_RECORDING_LENGTH_MS) {\n      return;\n    }\n\n    const event = this._mutationRateLimiter\n      ? this._mutationRateLimiter.throttleMutations(srcEvent)\n      : srcEvent;\n\n    if (!event) {\n      return;\n    }\n\n    this._diag.debug('event received', event.type);\n    this._eventBuffer.push(event);\n    if (this._eventBuffer.length >= this._maxBufferSize) {\n      this._flush();\n    }\n  };\n\n  private _flush(): void {\n    if (this._eventBuffer.length === 0 || this._paused) {\n      return;\n    }\n\n    this._diag.debug('flushing', this._eventBuffer.length, 'events');\n    const events = this._eventBuffer;\n    this._eventBuffer = [];\n\n    try {\n      this._emitEventBatches(events);\n    } catch (error) {\n      this._diag.error('failed to save events', error);\n    }\n  }\n\n  private _emitEventBatches(events: eventWithTime[]): void {\n    let batchStart = 0;\n\n    while (batchStart < events.length) {\n      let batchEnd = events.length;\n\n      while (batchEnd > batchStart) {\n        const slice = events.slice(batchStart, batchEnd);\n        const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));\n\n        if (json.length <= MAX_MESSAGE_SIZE) {\n          this._emitBatch(slice, json);\n          batchStart = batchEnd;\n          break;\n        }\n\n        batchEnd--;\n      }\n\n      if (batchEnd === batchStart) {\n        const slice = events.slice(batchStart, batchStart + 1);\n        const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));\n        this._emitBatch(slice, json);\n        batchStart++;\n      }\n    }\n  }\n\n  private _emitBatch(events: eventWithTime[], json: string): void {\n    if (this._debug) {\n      // oxlint-disable-next-line no-console -- debug-only replay diagnostics\n      console.log('replay batch', events.length, json.length);\n    }\n\n    this.logger.emit({\n      attributes: {\n        [KEY_MXL_TYPE]: MXL_TYPES.Replay,\n        [KEY_REPLAY_EVENTS]: json,\n        [KEY_REPLAY_COUNT]: events.length,\n      },\n      eventName: 'replay',\n      severityNumber: SeverityNumber.INFO,\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.cts

@@ -0,0 +1,51 @@
+import { MXLInstrumentationBase } from "../../MXLInstrumentationBase/MXLInstrumentationBase.cjs";
+import { ReplayInstrumentationArgs } from "./types.cjs";
+import { loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests } from "../rrwebLoader/loadRrwebModule.esm.cjs";
+//#region src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.ts
+declare class ReplayInstrumentation extends MXLInstrumentationBase {
+  private readonly _flushIntervalMs;
+  private readonly _maxBufferSize;
+  private readonly _recordUserSessions;
+  private readonly _rrwebUserOptions;
+  private readonly _debug;
+  private _eventBuffer;
+  private _flushIntervalId?;
+  private _removeSessionEndListener?;
+  private _removeSessionStartedListener?;
+  private _stopRecording?;
+  private _rrwebModule?;
+  private _mutationRateLimiter?;
+  private _lastKnownSession;
+  private _sessionStartTime;
+  private _paused;
+  private _enableRequested;
+  private _startInProgress;
+  private _queuedFullSnapshotTimeout?;
+  private _destroyed;
+  constructor({
+    diag,
+    perf,
+    flushIntervalMs,
+    maxBufferSize,
+    recordUserSessions,
+    rrwebOptions
+  }?: ReplayInstrumentationArgs);
+  setUserSessionManager(userSessionManager: Parameters<MXLInstrumentationBase['setUserSessionManager']>[0]): void;
+  isRecording(): boolean;
+  enable(options?: {
+    force?: boolean;
+  }): void;
+  pause(): void;
+  resume(): void;
+  private _scheduleFlush;
+  disable(): void;
+  private _registerSessionEndListener;
+  private _tryStartRecording;
+  private readonly _onEvent;
+  private _flush;
+  private _emitEventBatches;
+  private _emitBatch;
+}
+//#endregion
+export { ReplayInstrumentation, loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests };
+//# sourceMappingURL=ReplayInstrumentation.d.cts.map

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayInstrumentation.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts"],"mappings":";;;;cAsBa,qBAAA,SAA8B,sBAAA;EAAA,iBACxB,gBAAA;EAAA,iBACA,cAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,iBAAA;EAAA,iBACA,MAAA;EAAA,QAET,YAAA;EAAA,QACA,gBAAA;EAAA,QACA,yBAAA;EAAA,QACA,6BAAA;EAAA,QACA,cAAA;EAAA,QACA,YAAA;EAAA,QACA,oBAAA;EAAA,QACA,iBAAA;EAAA,QACA,iBAAA;EAAA,QACA,OAAA;EAAA,QACA,gBAAA;EAAA,QACA,gBAAA;EAAA,QACA,0BAAA;EAAA,QACA,UAAA;;IAGN,IAAA;IACA,IAAA;IACA,eAAA;IACA,aAAA;IACA,kBAAA;IACA;EAAA,IACC,yBAAA;EAoBa,qBAAA,CACd,kBAAA,EAAoB,UAAA,CAClB,sBAAA;EAOG,WAAA,CAAA;EAIA,MAAA,CAAO,OAAA;IAAY,KAAA;EAAA;EAanB,KAAA,CAAA;EAWA,MAAA,CAAA;EAAA,QAgBC,cAAA;EAoBD,OAAA,CAAA;EAAA,QAyBC,2BAAA;EAAA,QAgBM,kBAAA;EAAA,iBAgFG,QAAA;EAAA,QAkCT,MAAA;EAAA,QAgBA,iBAAA;EAAA,QA4BA,UAAA;AAAA"}

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.ts

@@ -0,0 +1,51 @@
+import { MXLInstrumentationBase } from "../../MXLInstrumentationBase/MXLInstrumentationBase.js";
+import { ReplayInstrumentationArgs } from "./types.js";
+import { loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests } from "../rrwebLoader/loadRrwebModule.esm.js";
+//#region src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.ts
+declare class ReplayInstrumentation extends MXLInstrumentationBase {
+  private readonly _flushIntervalMs;
+  private readonly _maxBufferSize;
+  private readonly _recordUserSessions;
+  private readonly _rrwebUserOptions;
+  private readonly _debug;
+  private _eventBuffer;
+  private _flushIntervalId?;
+  private _removeSessionEndListener?;
+  private _removeSessionStartedListener?;
+  private _stopRecording?;
+  private _rrwebModule?;
+  private _mutationRateLimiter?;
+  private _lastKnownSession;
+  private _sessionStartTime;
+  private _paused;
+  private _enableRequested;
+  private _startInProgress;
+  private _queuedFullSnapshotTimeout?;
+  private _destroyed;
+  constructor({
+    diag,
+    perf,
+    flushIntervalMs,
+    maxBufferSize,
+    recordUserSessions,
+    rrwebOptions
+  }?: ReplayInstrumentationArgs);
+  setUserSessionManager(userSessionManager: Parameters<MXLInstrumentationBase['setUserSessionManager']>[0]): void;
+  isRecording(): boolean;
+  enable(options?: {
+    force?: boolean;
+  }): void;
+  pause(): void;
+  resume(): void;
+  private _scheduleFlush;
+  disable(): void;
+  private _registerSessionEndListener;
+  private _tryStartRecording;
+  private readonly _onEvent;
+  private _flush;
+  private _emitEventBatches;
+  private _emitBatch;
+}
+//#endregion
+export { ReplayInstrumentation, loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests };
+//# sourceMappingURL=ReplayInstrumentation.d.ts.map

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayInstrumentation.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts"],"mappings":";;;;cAsBa,qBAAA,SAA8B,sBAAA;EAAA,iBACxB,gBAAA;EAAA,iBACA,cAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,iBAAA;EAAA,iBACA,MAAA;EAAA,QAET,YAAA;EAAA,QACA,gBAAA;EAAA,QACA,yBAAA;EAAA,QACA,6BAAA;EAAA,QACA,cAAA;EAAA,QACA,YAAA;EAAA,QACA,oBAAA;EAAA,QACA,iBAAA;EAAA,QACA,iBAAA;EAAA,QACA,OAAA;EAAA,QACA,gBAAA;EAAA,QACA,gBAAA;EAAA,QACA,0BAAA;EAAA,QACA,UAAA;;IAGN,IAAA;IACA,IAAA;IACA,eAAA;IACA,aAAA;IACA,kBAAA;IACA;EAAA,IACC,yBAAA;EAoBa,qBAAA,CACd,kBAAA,EAAoB,UAAA,CAClB,sBAAA;EAOG,WAAA,CAAA;EAIA,MAAA,CAAO,OAAA;IAAY,KAAA;EAAA;EAanB,KAAA,CAAA;EAWA,MAAA,CAAA;EAAA,QAgBC,cAAA;EAoBD,OAAA,CAAA;EAAA,QAyBC,2BAAA;EAAA,QAgBM,kBAAA;EAAA,iBAgFG,QAAA;EAAA,QAkCT,MAAA;EAAA,QAgBA,iBAAA;EAAA,QA4BA,UAAA;AAAA"}

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.js

@@ -0,0 +1,235 @@
+import { KEY_MXL_TYPE } from "../../../constants/attributes.js";
+import { MXLInstrumentationBase } from "../../MXLInstrumentationBase/MXLInstrumentationBase.js";
+import { MutationRateLimiter, ensureStringifiedMaxMessageSize } from "../utils/session-recording-utils.js";
+import { DEFAULT_FLUSH_INTERVAL_MS, KEY_REPLAY_COUNT, KEY_REPLAY_EVENTS } from "./constants.js";
+import { loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests } from "../rrwebLoader/loadRrwebModule.esm.js";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+//#region src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts
+var ReplayInstrumentation = class extends MXLInstrumentationBase {
+	_flushIntervalMs;
+	_maxBufferSize;
+	_recordUserSessions;
+	_rrwebUserOptions;
+	_debug;
+	_eventBuffer = [];
+	_flushIntervalId;
+	_removeSessionEndListener;
+	_removeSessionStartedListener;
+	_stopRecording;
+	_rrwebModule;
+	_mutationRateLimiter;
+	_lastKnownSession = "";
+	_sessionStartTime = 0;
+	_paused = false;
+	_enableRequested = false;
+	_startInProgress = false;
+	_queuedFullSnapshotTimeout;
+	_destroyed = false;
+	constructor({ diag, perf, flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS, maxBufferSize = 50, recordUserSessions = true, rrwebOptions } = {}) {
+		super({
+			config: {},
+			diag,
+			instrumentationName: "ReplayInstrumentation",
+			instrumentationVersion: "1.0.0",
+			perf
+		});
+		this._flushIntervalMs = flushIntervalMs;
+		this._maxBufferSize = maxBufferSize;
+		this._recordUserSessions = recordUserSessions;
+		this._debug = rrwebOptions?.debug ?? false;
+		this._rrwebUserOptions = rrwebOptions;
+		if (!this._config.enabled) this._diag.debug("disabled, not starting");
+	}
+	setUserSessionManager(userSessionManager) {
+		super.setUserSessionManager(userSessionManager);
+		this._registerSessionEndListener();
+	}
+	isRecording() {
+		return Boolean(this._stopRecording) && !this._paused;
+	}
+	enable(options) {
+		if (!this._recordUserSessions && !options?.force) {
+			this._diag.debug("recordUserSessions disabled, waiting for manual enable");
+			return;
+		}
+		this._enableRequested = true;
+		this._paused = false;
+		this._tryStartRecording();
+	}
+	pause() {
+		if (!this._stopRecording) return;
+		this._enableRequested = false;
+		this._paused = true;
+		clearTimeout(this._flushIntervalId);
+		this._flushIntervalId = void 0;
+	}
+	resume() {
+		if (!this._stopRecording) {
+			this.enable();
+			return;
+		}
+		const wasPaused = this._paused;
+		this._enableRequested = true;
+		this._paused = false;
+		if (wasPaused) {
+			this._scheduleFlush();
+			this._rrwebModule?.record.takeFullSnapshot();
+		}
+	}
+	_scheduleFlush() {
+		if (this._destroyed || this._flushIntervalId || this._paused || !this._stopRecording) return;
+		this._flushIntervalId = setTimeout(() => {
+			this._flushIntervalId = void 0;
+			if (this._destroyed || this._paused || !this._stopRecording) return;
+			this._flush();
+			this._scheduleFlush();
+		}, this._flushIntervalMs);
+	}
+	disable() {
+		this._destroyed = true;
+		this._enableRequested = false;
+		this._paused = false;
+		clearTimeout(this._flushIntervalId);
+		this._flushIntervalId = void 0;
+		this._removeSessionEndListener?.();
+		this._removeSessionEndListener = void 0;
+		this._removeSessionStartedListener?.();
+		this._removeSessionStartedListener = void 0;
+		clearTimeout(this._queuedFullSnapshotTimeout);
+		this._queuedFullSnapshotTimeout = void 0;
+		if (this._stopRecording) {
+			this._diag.debug("stopping recording");
+			this._stopRecording();
+			this._stopRecording = void 0;
+			this._flush();
+		}
+		this._mutationRateLimiter?.destroy();
+		this._mutationRateLimiter = void 0;
+	}
+	_registerSessionEndListener() {
+		if (!this._stopRecording) return;
+		this._removeSessionEndListener?.();
+		this._removeSessionEndListener = this.userSessionManager.addSessionPartEndedListener(() => {
+			try {
+				this._flush();
+			} catch (error) {
+				this._diag.error("error flushing on session end", error);
+			}
+		});
+	}
+	async _tryStartRecording() {
+		if (!this._enableRequested || this._stopRecording || this._startInProgress) return;
+		if (typeof window === "undefined") {
+			this._diag.warn("session replay cannot run in non-browser environments");
+			return;
+		}
+		if (this.userSessionManager.getUserSessionId() === null) {
+			if (!this._removeSessionStartedListener) this._removeSessionStartedListener = this.userSessionManager.addSessionPartStartedListener(() => {
+				this._removeSessionStartedListener?.();
+				this._removeSessionStartedListener = void 0;
+				this._tryStartRecording();
+			});
+			return;
+		}
+		this._startInProgress = true;
+		try {
+			this._rrwebModule = await loadRrwebModule();
+			if (!this._enableRequested || this._stopRecording) return;
+			this._lastKnownSession = this.userSessionManager.getUserSessionId() ?? "";
+			this._sessionStartTime = Date.now();
+			const { record } = this._rrwebModule;
+			const { debug: _debug, ...rrwebOptions } = this._rrwebUserOptions ?? {};
+			this._mutationRateLimiter = this._mutationRateLimiter ?? new MutationRateLimiter(record, { onBlockedNode: (id, node) => {
+				const message = `MXL Session Replay: Rate limiting recording mutations on node ${id}. This can be due to excessive animations.`;
+				if (this._debug) console.warn(message, node);
+				clearTimeout(this._queuedFullSnapshotTimeout);
+				this._queuedFullSnapshotTimeout = setTimeout(() => {
+					record.takeFullSnapshot();
+				}, 1e3);
+			} });
+			const stopFn = record({
+				maskAllInputs: true,
+				maskTextSelector: "*",
+				...rrwebOptions,
+				emit: this._onEvent
+			});
+			if (!stopFn) {
+				this._diag.warn("record() returned undefined, did not start");
+				return;
+			}
+			this._stopRecording = stopFn;
+			this._scheduleFlush();
+			this._registerSessionEndListener();
+			this._diag.debug("recording started");
+		} catch (error) {
+			this._diag.error("failed to start recording", error);
+		} finally {
+			this._startInProgress = false;
+		}
+	}
+	_onEvent = (srcEvent) => {
+		if (this._paused) return;
+		const currentSession = this.userSessionManager.getUserSessionId() ?? "";
+		if (currentSession !== this._lastKnownSession) {
+			if (typeof document !== "undefined" && document.hidden) return;
+			this._lastKnownSession = currentSession;
+			this._sessionStartTime = Date.now();
+			this._rrwebModule?.record.takeFullSnapshot();
+		}
+		if (srcEvent.timestamp > this._sessionStartTime + 1446e4) return;
+		const event = this._mutationRateLimiter ? this._mutationRateLimiter.throttleMutations(srcEvent) : srcEvent;
+		if (!event) return;
+		this._diag.debug("event received", event.type);
+		this._eventBuffer.push(event);
+		if (this._eventBuffer.length >= this._maxBufferSize) this._flush();
+	};
+	_flush() {
+		if (this._eventBuffer.length === 0 || this._paused) return;
+		this._diag.debug("flushing", this._eventBuffer.length, "events");
+		const events = this._eventBuffer;
+		this._eventBuffer = [];
+		try {
+			this._emitEventBatches(events);
+		} catch (error) {
+			this._diag.error("failed to save events", error);
+		}
+	}
+	_emitEventBatches(events) {
+		let batchStart = 0;
+		while (batchStart < events.length) {
+			let batchEnd = events.length;
+			while (batchEnd > batchStart) {
+				const slice = events.slice(batchStart, batchEnd);
+				const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));
+				if (json.length <= 5e6) {
+					this._emitBatch(slice, json);
+					batchStart = batchEnd;
+					break;
+				}
+				batchEnd--;
+			}
+			if (batchEnd === batchStart) {
+				const slice = events.slice(batchStart, batchStart + 1);
+				const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));
+				this._emitBatch(slice, json);
+				batchStart++;
+			}
+		}
+	}
+	_emitBatch(events, json) {
+		if (this._debug) console.log("replay batch", events.length, json.length);
+		this.logger.emit({
+			attributes: {
+				[KEY_MXL_TYPE]: "ux.replay",
+				[KEY_REPLAY_EVENTS]: json,
+				[KEY_REPLAY_COUNT]: events.length
+			},
+			eventName: "replay",
+			severityNumber: SeverityNumber.INFO
+		});
+	}
+};
+//#endregion
+export { ReplayInstrumentation, loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests };
+
+//# sourceMappingURL=ReplayInstrumentation.js.map

package/dist/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplayInstrumentation.js","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts"],"sourcesContent":["import { SeverityNumber } from '@opentelemetry/api-logs';\nimport type { eventWithTime } from 'rrweb';\nimport { KEY_MXL_TYPE, MXL_TYPES } from '../../../constants/attributes';\nimport { MXLInstrumentationBase } from '../../MXLInstrumentationBase/MXLInstrumentationBase';\nimport { MAX_MESSAGE_SIZE, MutationRateLimiter, ensureStringifiedMaxMessageSize } from '../utils/session-recording-utils';\nimport {\n  DEFAULT_FLUSH_INTERVAL_MS,\n  DEFAULT_MAX_BUFFER_SIZE,\n  KEY_REPLAY_COUNT,\n  KEY_REPLAY_EVENTS,\n  MAX_RECORDING_LENGTH_MS,\n} from './constants';\nimport { loadRrwebModule } from '../rrwebLoader/loadRrwebModule';\nimport type { RrwebModule } from '../rrwebLoader/types';\nimport type { ReplayInstrumentationArgs } from './types';\n\nexport {\n  loadRrwebModule,\n  resetRrwebModuleCacheForTests,\n  setRrwebModuleLoaderForTests,\n} from '../rrwebLoader/loadRrwebModule';\n\nexport class ReplayInstrumentation extends MXLInstrumentationBase {\n  private readonly _flushIntervalMs: number;\n  private readonly _maxBufferSize: number;\n  private readonly _recordUserSessions: boolean;\n  private readonly _rrwebUserOptions: ReplayInstrumentationArgs['rrwebOptions'];\n  private readonly _debug: boolean;\n\n  private _eventBuffer: eventWithTime[] = [];\n  private _flushIntervalId?: ReturnType<typeof setTimeout>;\n  private _removeSessionEndListener?: () => void;\n  private _removeSessionStartedListener?: () => void;\n  private _stopRecording?: () => void;\n  private _rrwebModule?: RrwebModule;\n  private _mutationRateLimiter?: MutationRateLimiter;\n  private _lastKnownSession = '';\n  private _sessionStartTime = 0;\n  private _paused = false;\n  private _enableRequested = false;\n  private _startInProgress = false;\n  private _queuedFullSnapshotTimeout?: ReturnType<typeof setTimeout>;\n  private _destroyed = false;\n\n  public constructor({\n    diag,\n    perf,\n    flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS,\n    maxBufferSize = DEFAULT_MAX_BUFFER_SIZE,\n    recordUserSessions = true,\n    rrwebOptions,\n  }: ReplayInstrumentationArgs = {}) {\n    super({\n      config: {},\n      diag,\n      instrumentationName: 'ReplayInstrumentation',\n      instrumentationVersion: '1.0.0',\n      perf,\n    });\n\n    this._flushIntervalMs = flushIntervalMs;\n    this._maxBufferSize = maxBufferSize;\n    this._recordUserSessions = recordUserSessions;\n    this._debug = rrwebOptions?.debug ?? false;\n    this._rrwebUserOptions = rrwebOptions;\n\n    if (!this._config.enabled) {\n      this._diag.debug('disabled, not starting');\n    }\n  }\n\n  public override setUserSessionManager(\n    userSessionManager: Parameters<\n      MXLInstrumentationBase['setUserSessionManager']\n    >[0],\n  ): void {\n    super.setUserSessionManager(userSessionManager);\n    this._registerSessionEndListener();\n  }\n\n  public isRecording(): boolean {\n    return Boolean(this._stopRecording) && !this._paused;\n  }\n\n  public enable(options?: { force?: boolean }): void {\n    if (!this._recordUserSessions && !options?.force) {\n      this._diag.debug(\n        'recordUserSessions disabled, waiting for manual enable',\n      );\n      return;\n    }\n\n    this._enableRequested = true;\n    this._paused = false;\n    void this._tryStartRecording();\n  }\n\n  public pause(): void {\n    if (!this._stopRecording) {\n      return;\n    }\n\n    this._enableRequested = false;\n    this._paused = true;\n    clearTimeout(this._flushIntervalId);\n    this._flushIntervalId = undefined;\n  }\n\n  public resume(): void {\n    if (!this._stopRecording) {\n      this.enable();\n      return;\n    }\n\n    const wasPaused = this._paused;\n    this._enableRequested = true;\n    this._paused = false;\n\n    if (wasPaused) {\n      this._scheduleFlush();\n      this._rrwebModule?.record.takeFullSnapshot();\n    }\n  }\n\n  private _scheduleFlush(): void {\n    if (\n      this._destroyed ||\n      this._flushIntervalId ||\n      this._paused ||\n      !this._stopRecording\n    ) {\n      return;\n    }\n\n    this._flushIntervalId = setTimeout(() => {\n      this._flushIntervalId = undefined;\n      if (this._destroyed || this._paused || !this._stopRecording) {\n        return;\n      }\n      this._flush();\n      this._scheduleFlush();\n    }, this._flushIntervalMs);\n  }\n\n  public disable(): void {\n    this._destroyed = true;\n    this._enableRequested = false;\n    this._paused = false;\n\n    clearTimeout(this._flushIntervalId);\n    this._flushIntervalId = undefined;\n    this._removeSessionEndListener?.();\n    this._removeSessionEndListener = undefined;\n    this._removeSessionStartedListener?.();\n    this._removeSessionStartedListener = undefined;\n    clearTimeout(this._queuedFullSnapshotTimeout);\n    this._queuedFullSnapshotTimeout = undefined;\n\n    if (this._stopRecording) {\n      this._diag.debug('stopping recording');\n      this._stopRecording();\n      this._stopRecording = undefined;\n      this._flush();\n    }\n\n    this._mutationRateLimiter?.destroy();\n    this._mutationRateLimiter = undefined;\n  }\n\n  private _registerSessionEndListener(): void {\n    if (!this._stopRecording) {\n      return;\n    }\n\n    this._removeSessionEndListener?.();\n    this._removeSessionEndListener =\n      this.userSessionManager.addSessionPartEndedListener(() => {\n        try {\n          this._flush();\n        } catch (error) {\n          this._diag.error('error flushing on session end', error);\n        }\n      });\n  }\n\n  private async _tryStartRecording(): Promise<void> {\n    if (\n      !this._enableRequested ||\n      this._stopRecording ||\n      this._startInProgress\n    ) {\n      return;\n    }\n\n    if (typeof window === 'undefined') {\n      this._diag.warn('session replay cannot run in non-browser environments');\n      return;\n    }\n\n    if (this.userSessionManager.getUserSessionId() === null) {\n      if (!this._removeSessionStartedListener) {\n        this._removeSessionStartedListener =\n          this.userSessionManager.addSessionPartStartedListener(() => {\n            this._removeSessionStartedListener?.();\n            this._removeSessionStartedListener = undefined;\n            void this._tryStartRecording();\n          });\n      }\n      return;\n    }\n\n    this._startInProgress = true;\n\n    try {\n      this._rrwebModule = await loadRrwebModule();\n      if (!this._enableRequested || this._stopRecording) {\n        return;\n      }\n\n      this._lastKnownSession = this.userSessionManager.getUserSessionId() ?? '';\n      this._sessionStartTime = Date.now();\n\n      const { record } = this._rrwebModule;\n      const { debug: _debug, ...rrwebOptions } = this._rrwebUserOptions ?? {};\n\n      this._mutationRateLimiter =\n        this._mutationRateLimiter ??\n        new MutationRateLimiter(record, {\n          onBlockedNode: (id, node) => {\n            const message = `MXL Session Replay: Rate limiting recording mutations on node ${id}. This can be due to excessive animations.`;\n            if (this._debug) {\n              // oxlint-disable-next-line no-console -- debug-only replay diagnostics\n              console.warn(message, node);\n            }\n\n            clearTimeout(this._queuedFullSnapshotTimeout);\n            this._queuedFullSnapshotTimeout = setTimeout(() => {\n              record.takeFullSnapshot();\n            }, 1000);\n          },\n        });\n\n      const stopFn = record({\n        maskAllInputs: true,\n        maskTextSelector: '*',\n        ...rrwebOptions,\n        emit: this._onEvent,\n      });\n\n      if (!stopFn) {\n        this._diag.warn('record() returned undefined, did not start');\n        return;\n      }\n\n      this._stopRecording = stopFn;\n      this._scheduleFlush();\n      this._registerSessionEndListener();\n      this._diag.debug('recording started');\n    } catch (error) {\n      this._diag.error('failed to start recording', error);\n    } finally {\n      this._startInProgress = false;\n    }\n  }\n\n  private readonly _onEvent = (srcEvent: eventWithTime) => {\n    if (this._paused) {\n      return;\n    }\n\n    const currentSession = this.userSessionManager.getUserSessionId() ?? '';\n    if (currentSession !== this._lastKnownSession) {\n      if (typeof document !== 'undefined' && document.hidden) {\n        return;\n      }\n      this._lastKnownSession = currentSession;\n      this._sessionStartTime = Date.now();\n      this._rrwebModule?.record.takeFullSnapshot();\n    }\n\n    if (srcEvent.timestamp > this._sessionStartTime + MAX_RECORDING_LENGTH_MS) {\n      return;\n    }\n\n    const event = this._mutationRateLimiter\n      ? this._mutationRateLimiter.throttleMutations(srcEvent)\n      : srcEvent;\n\n    if (!event) {\n      return;\n    }\n\n    this._diag.debug('event received', event.type);\n    this._eventBuffer.push(event);\n    if (this._eventBuffer.length >= this._maxBufferSize) {\n      this._flush();\n    }\n  };\n\n  private _flush(): void {\n    if (this._eventBuffer.length === 0 || this._paused) {\n      return;\n    }\n\n    this._diag.debug('flushing', this._eventBuffer.length, 'events');\n    const events = this._eventBuffer;\n    this._eventBuffer = [];\n\n    try {\n      this._emitEventBatches(events);\n    } catch (error) {\n      this._diag.error('failed to save events', error);\n    }\n  }\n\n  private _emitEventBatches(events: eventWithTime[]): void {\n    let batchStart = 0;\n\n    while (batchStart < events.length) {\n      let batchEnd = events.length;\n\n      while (batchEnd > batchStart) {\n        const slice = events.slice(batchStart, batchEnd);\n        const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));\n\n        if (json.length <= MAX_MESSAGE_SIZE) {\n          this._emitBatch(slice, json);\n          batchStart = batchEnd;\n          break;\n        }\n\n        batchEnd--;\n      }\n\n      if (batchEnd === batchStart) {\n        const slice = events.slice(batchStart, batchStart + 1);\n        const json = ensureStringifiedMaxMessageSize(JSON.stringify(slice));\n        this._emitBatch(slice, json);\n        batchStart++;\n      }\n    }\n  }\n\n  private _emitBatch(events: eventWithTime[], json: string): void {\n    if (this._debug) {\n      // oxlint-disable-next-line no-console -- debug-only replay diagnostics\n      console.log('replay batch', events.length, json.length);\n    }\n\n    this.logger.emit({\n      attributes: {\n        [KEY_MXL_TYPE]: MXL_TYPES.Replay,\n        [KEY_REPLAY_EVENTS]: json,\n        [KEY_REPLAY_COUNT]: events.length,\n      },\n      eventName: 'replay',\n      severityNumber: SeverityNumber.INFO,\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/instrumentations/replay/ReplayInstrumentation/constants.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/instrumentations/replay/ReplayInstrumentation/constants.ts
+const DEFAULT_FLUSH_INTERVAL_MS = 3e3;
+const DEFAULT_MAX_BUFFER_SIZE = 50;
+const MAX_RECORDING_LENGTH_MS = 14460 * 1e3;
+const KEY_REPLAY_EVENTS = "replay.events";
+const KEY_REPLAY_COUNT = "replay.count";
+//#endregion
+exports.DEFAULT_FLUSH_INTERVAL_MS = DEFAULT_FLUSH_INTERVAL_MS;
+exports.DEFAULT_MAX_BUFFER_SIZE = DEFAULT_MAX_BUFFER_SIZE;
+exports.KEY_REPLAY_COUNT = KEY_REPLAY_COUNT;
+exports.KEY_REPLAY_EVENTS = KEY_REPLAY_EVENTS;
+exports.MAX_RECORDING_LENGTH_MS = MAX_RECORDING_LENGTH_MS;
+
+//# sourceMappingURL=constants.cjs.map