@safaricom-mxl/web-sdk 0.0.18 → 0.0.20

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

@@ -1,235 +1,83 @@
-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";
+import { SessionRecording } from "../session-recording/SessionRecording.js";
 //#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 } = {}) {
+	_args;
+	_sessionRecording;
+	_wasPaused = false;
+	_stopPromise;
+	constructor(args = {}) {
 		super({
 			config: {},
-			diag,
+			diag: args.diag,
 			instrumentationName: "ReplayInstrumentation",
-			instrumentationVersion: "1.0.0",
-			perf
+			instrumentationVersion: "2.0.0",
+			perf: args.perf
 		});
-		this._flushIntervalMs = flushIntervalMs;
-		this._maxBufferSize = maxBufferSize;
-		this._recordUserSessions = recordUserSessions;
-		this._debug = rrwebOptions?.debug ?? false;
-		this._rrwebUserOptions = rrwebOptions;
+		this._args = args;
+		if (!args.replayContext || !args.sessionStorage) this._diag.warn("replayContext and sessionStorage are required for session recording");
 		if (!this._config.enabled) this._diag.debug("disabled, not starting");
 	}
 	setUserSessionManager(userSessionManager) {
 		super.setUserSessionManager(userSessionManager);
-		this._registerSessionEndListener();
+		this._ensureSessionRecording();
+		if (this._config.enabled && this._args.recordUserSessions !== false && this._args.replayContext && this._args.sessionStorage) this.enable();
+	}
+	_ensureSessionRecording() {
+		if (this._sessionRecording) return this._sessionRecording;
+		const { replayContext, sessionStorage, recordUserSessions, rrwebOptions } = this._args;
+		if (!replayContext || !sessionStorage) return;
+		this._sessionRecording = new SessionRecording({
+			context: replayContext,
+			diag: this._diag,
+			recordUserSessions,
+			rrwebOptions,
+			sessionStorage,
+			userSessionManager: this.userSessionManager
+		});
+		return this._sessionRecording;
 	}
 	isRecording() {
-		return Boolean(this._stopRecording) && !this._paused;
+		return this._sessionRecording?.isRecording() ?? false;
 	}
 	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();
+		this._wasPaused = false;
+		this._enableWhenReady(options);
 	}
 	pause() {
-		if (!this._stopRecording) return;
-		this._enableRequested = false;
-		this._paused = true;
-		clearTimeout(this._flushIntervalId);
-		this._flushIntervalId = void 0;
+		this._wasPaused = true;
+		this._sessionRecording?.pause();
 	}
 	resume() {
-		if (!this._stopRecording) {
-			this.enable();
+		if (this._wasPaused) {
+			this._resumeWhenReady();
 			return;
 		}
-		const wasPaused = this._paused;
-		this._enableRequested = true;
-		this._paused = false;
-		if (wasPaused) {
-			this._scheduleFlush();
-			this._rrwebModule?.record.takeFullSnapshot();
-		}
+		this._enableWhenReady({ force: true });
 	}
-	_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);
+	async _enableWhenReady(options) {
+		await this._stopPromise;
+		this._ensureSessionRecording()?.enable(options);
 	}
-	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;
+	async _resumeWhenReady() {
+		await this._stopPromise;
+		this._sessionRecording?.resume();
+		this._wasPaused = false;
 	}
-	_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);
-			}
+	disable() {
+		const recording = this._sessionRecording;
+		if (!recording) return;
+		this._stopPromise = recording.stop().finally(() => {
+			if (this._sessionRecording === recording) this._sessionRecording = void 0;
+			this._stopPromise = void 0;
 		});
 	}
-	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
-		});
+	/** Await in-flight disable teardown (tests / advanced callers). */
+	async waitForDisable() {
+		await this._stopPromise;
 	}
 };
 //#endregion
-export { ReplayInstrumentation, loadRrwebModule, resetRrwebModuleCacheForTests, setRrwebModuleLoaderForTests };
+export { ReplayInstrumentation };
 
 //# sourceMappingURL=ReplayInstrumentation.js.map

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

@@ -1 +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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"}
+{"version":3,"file":"ReplayInstrumentation.js","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/ReplayInstrumentation.ts"],"sourcesContent":["import { MXLInstrumentationBase } from '../../MXLInstrumentationBase/MXLInstrumentationBase';\nimport { SessionRecording } from '../session-recording/SessionRecording';\nimport type { ReplayInstrumentationArgs } from './types';\n\nexport class ReplayInstrumentation extends MXLInstrumentationBase {\n  private readonly _args: ReplayInstrumentationArgs;\n  private _sessionRecording: SessionRecording | undefined;\n  private _wasPaused = false;\n  private _stopPromise: Promise<void> | undefined;\n\n  public constructor(args: ReplayInstrumentationArgs = {}) {\n    super({\n      config: {},\n      diag: args.diag,\n      instrumentationName: 'ReplayInstrumentation',\n      instrumentationVersion: '2.0.0',\n      perf: args.perf,\n    });\n\n    this._args = args;\n\n    if (!args.replayContext || !args.sessionStorage) {\n      this._diag.warn(\n        'replayContext and sessionStorage are required for session recording',\n      );\n    }\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._ensureSessionRecording();\n\n    if (\n      this._config.enabled &&\n      this._args.recordUserSessions !== false &&\n      this._args.replayContext &&\n      this._args.sessionStorage\n    ) {\n      this.enable();\n    }\n  }\n\n  private _ensureSessionRecording(): SessionRecording | undefined {\n    if (this._sessionRecording) {\n      return this._sessionRecording;\n    }\n\n    const { replayContext, sessionStorage, recordUserSessions, rrwebOptions } =\n      this._args;\n\n    if (!replayContext || !sessionStorage) {\n      return undefined;\n    }\n\n    this._sessionRecording = new SessionRecording({\n      context: replayContext,\n      diag: this._diag,\n      recordUserSessions,\n      rrwebOptions,\n      sessionStorage,\n      userSessionManager: this.userSessionManager,\n    });\n\n    return this._sessionRecording;\n  }\n\n  public isRecording(): boolean {\n    return this._sessionRecording?.isRecording() ?? false;\n  }\n\n  public enable(options?: { force?: boolean }): void {\n    this._wasPaused = false;\n    void this._enableWhenReady(options);\n  }\n\n  public pause(): void {\n    this._wasPaused = true;\n    this._sessionRecording?.pause();\n  }\n\n  public resume(): void {\n    if (this._wasPaused) {\n      void this._resumeWhenReady();\n      return;\n    }\n    void this._enableWhenReady({ force: true });\n  }\n\n  private async _enableWhenReady(options?: { force?: boolean }): Promise<void> {\n    await this._stopPromise;\n    this._ensureSessionRecording()?.enable(options);\n  }\n\n  private async _resumeWhenReady(): Promise<void> {\n    await this._stopPromise;\n    this._sessionRecording?.resume();\n    this._wasPaused = false;\n  }\n\n  public disable(): void {\n    const recording = this._sessionRecording;\n    if (!recording) {\n      return;\n    }\n\n    this._stopPromise = recording.stop().finally(() => {\n      if (this._sessionRecording === recording) {\n        this._sessionRecording = undefined;\n      }\n      this._stopPromise = undefined;\n    });\n  }\n\n  /** Await in-flight disable teardown (tests / advanced callers). */\n  public async waitForDisable(): Promise<void> {\n    await this._stopPromise;\n  }\n}\n"],"mappings":";;;AAIA,IAAa,wBAAb,cAA2C,uBAAuB;CAChE;CACA;CACA,aAAqB;CACrB;CAEA,YAAmB,OAAkC,EAAE,EAAE;AACvD,QAAM;GACJ,QAAQ,EAAE;GACV,MAAM,KAAK;GACX,qBAAqB;GACrB,wBAAwB;GACxB,MAAM,KAAK;GACZ,CAAC;AAEF,OAAK,QAAQ;AAEb,MAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,eAC/B,MAAK,MAAM,KACT,sEACD;AAGH,MAAI,CAAC,KAAK,QAAQ,QAChB,MAAK,MAAM,MAAM,yBAAyB;;CAI9C,sBACE,oBAGM;AACN,QAAM,sBAAsB,mBAAmB;AAC/C,OAAK,yBAAyB;AAE9B,MACE,KAAK,QAAQ,WACb,KAAK,MAAM,uBAAuB,SAClC,KAAK,MAAM,iBACX,KAAK,MAAM,eAEX,MAAK,QAAQ;;CAIjB,0BAAgE;AAC9D,MAAI,KAAK,kBACP,QAAO,KAAK;EAGd,MAAM,EAAE,eAAe,gBAAgB,oBAAoB,iBACzD,KAAK;AAEP,MAAI,CAAC,iBAAiB,CAAC,eACrB;AAGF,OAAK,oBAAoB,IAAI,iBAAiB;GAC5C,SAAS;GACT,MAAM,KAAK;GACX;GACA;GACA;GACA,oBAAoB,KAAK;GAC1B,CAAC;AAEF,SAAO,KAAK;;CAGd,cAA8B;AAC5B,SAAO,KAAK,mBAAmB,aAAa,IAAI;;CAGlD,OAAc,SAAqC;AACjD,OAAK,aAAa;AACb,OAAK,iBAAiB,QAAQ;;CAGrC,QAAqB;AACnB,OAAK,aAAa;AAClB,OAAK,mBAAmB,OAAO;;CAGjC,SAAsB;AACpB,MAAI,KAAK,YAAY;AACd,QAAK,kBAAkB;AAC5B;;AAEG,OAAK,iBAAiB,EAAE,OAAO,MAAM,CAAC;;CAG7C,MAAc,iBAAiB,SAA8C;AAC3E,QAAM,KAAK;AACX,OAAK,yBAAyB,EAAE,OAAO,QAAQ;;CAGjD,MAAc,mBAAkC;AAC9C,QAAM,KAAK;AACX,OAAK,mBAAmB,QAAQ;AAChC,OAAK,aAAa;;CAGpB,UAAuB;EACrB,MAAM,YAAY,KAAK;AACvB,MAAI,CAAC,UACH;AAGF,OAAK,eAAe,UAAU,MAAM,CAAC,cAAc;AACjD,OAAI,KAAK,sBAAsB,UAC7B,MAAK,oBAAoB,KAAA;AAE3B,QAAK,eAAe,KAAA;IACpB;;;CAIJ,MAAa,iBAAgC;AAC3C,QAAM,KAAK"}

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

@@ -1,16 +1,29 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.cjs";
 import { MXLInstrumentationBaseArgs } from "../../MXLInstrumentationBase/types.cjs";
+import { ReplayContext } from "../session-recording/config.cjs";
 import { record } from "rrweb";
 
 //#region src/instrumentations/replay/ReplayInstrumentation/types.d.ts
 type RRWebRecordOptions = NonNullable<Parameters<typeof record>[0]>;
 type ReplayUserConfig = RRWebRecordOptions & {
   debug?: boolean;
+  enabled?: boolean;
+  sampleRate?: number;
+  maskAllInputs?: boolean;
+  maskAllText?: boolean;
+  flushIntervalMs?: number;
+  /**
+   * When `true`, omit default click/exception instrumentations and OTel fetch/XHR
+   * instrumentations while replay event capture is active (reduces duplicate signals).
+   * **default**: false
+   */
+  omitRedundantInstrumentations?: boolean;
 };
 type ReplayInstrumentationArgs = Pick<MXLInstrumentationBaseArgs, 'diag' | 'perf'> & {
-  flushIntervalMs?: number;
-  maxBufferSize?: number;
   recordUserSessions?: boolean;
   rrwebOptions?: ReplayUserConfig;
+  replayContext?: ReplayContext;
+  sessionStorage?: NamespacedStorage;
 };
 //#endregion
 export { ReplayInstrumentationArgs, ReplayUserConfig };

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/types.ts"],"mappings":";;;;KAGK,kBAAA,GAAqB,WAAA,CAAY,UAAA,QAAkB,MAAA;AAAA,KAE5C,gBAAA,GAAmB,kBAAA;EAC7B,KAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,IAAA,CACtC,0BAAA;EAGA,eAAA;EACA,aAAA;EACA,kBAAA;EACA,YAAA,GAAe,gBAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/types.ts"],"mappings":";;;;;;KAKK,kBAAA,GAAqB,WAAA,CAAY,UAAA,QAAkB,MAAA;AAAA,KAE5C,gBAAA,GAAmB,kBAAA;EAC7B,KAAA;EACA,OAAA;EACA,UAAA;EACA,aAAA;EACA,WAAA;EACA,eAAA;EARmC;;;;;EAcnC,6BAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,IAAA,CACtC,0BAAA;EAGA,kBAAA;EACA,YAAA,GAAe,gBAAA;EACf,aAAA,GAAgB,aAAA;EAChB,cAAA,GAAiB,iBAAA;AAAA"}

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

@@ -1,16 +1,29 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.js";
 import { MXLInstrumentationBaseArgs } from "../../MXLInstrumentationBase/types.js";
+import { ReplayContext } from "../session-recording/config.js";
 import { record } from "rrweb";
 
 //#region src/instrumentations/replay/ReplayInstrumentation/types.d.ts
 type RRWebRecordOptions = NonNullable<Parameters<typeof record>[0]>;
 type ReplayUserConfig = RRWebRecordOptions & {
   debug?: boolean;
+  enabled?: boolean;
+  sampleRate?: number;
+  maskAllInputs?: boolean;
+  maskAllText?: boolean;
+  flushIntervalMs?: number;
+  /**
+   * When `true`, omit default click/exception instrumentations and OTel fetch/XHR
+   * instrumentations while replay event capture is active (reduces duplicate signals).
+   * **default**: false
+   */
+  omitRedundantInstrumentations?: boolean;
 };
 type ReplayInstrumentationArgs = Pick<MXLInstrumentationBaseArgs, 'diag' | 'perf'> & {
-  flushIntervalMs?: number;
-  maxBufferSize?: number;
   recordUserSessions?: boolean;
   rrwebOptions?: ReplayUserConfig;
+  replayContext?: ReplayContext;
+  sessionStorage?: NamespacedStorage;
 };
 //#endregion
 export { ReplayInstrumentationArgs, ReplayUserConfig };

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/types.ts"],"mappings":";;;;KAGK,kBAAA,GAAqB,WAAA,CAAY,UAAA,QAAkB,MAAA;AAAA,KAE5C,gBAAA,GAAmB,kBAAA;EAC7B,KAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,IAAA,CACtC,0BAAA;EAGA,eAAA;EACA,aAAA;EACA,kBAAA;EACA,YAAA,GAAe,gBAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/ReplayInstrumentation/types.ts"],"mappings":";;;;;;KAKK,kBAAA,GAAqB,WAAA,CAAY,UAAA,QAAkB,MAAA;AAAA,KAE5C,gBAAA,GAAmB,kBAAA;EAC7B,KAAA;EACA,OAAA;EACA,UAAA;EACA,aAAA;EACA,WAAA;EACA,eAAA;EARmC;;;;;EAcnC,6BAAA;AAAA;AAAA,KAGU,yBAAA,GAA4B,IAAA,CACtC,0BAAA;EAGA,kBAAA;EACA,YAAA,GAAe,gBAAA;EACf,aAAA,GAAgB,aAAA;EAChB,cAAA,GAAiB,iBAAA;AAAA"}

package/dist/instrumentations/replay/createSessionRecordingControlFromReplay.cjs

@@ -5,7 +5,7 @@ function createSessionRecordingControlFromReplay(replayInstrumentation) {
 		isRecording: () => replayInstrumentation.isRecording(),
 		setEnabled: (enabled) => {
 			if (enabled) {
-				replayInstrumentation.enable({ force: true });
+				replayInstrumentation.resume();
 				return;
 			}
 			replayInstrumentation.pause();

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

@@ -1 +1 @@
-{"version":3,"file":"createSessionRecordingControlFromReplay.cjs","names":[],"sources":["../../../src/instrumentations/replay/createSessionRecordingControlFromReplay.ts"],"sourcesContent":["import type { SessionRecordingControl } from '../../sdk/types';\nimport type { ReplayInstrumentation } from './ReplayInstrumentation/ReplayInstrumentation';\n\nexport function createSessionRecordingControlFromReplay(\n  replayInstrumentation: ReplayInstrumentation,\n): SessionRecordingControl {\n  return {\n    isRecording: () => replayInstrumentation.isRecording(),\n    setEnabled: (enabled: boolean) => {\n      if (enabled) {\n        replayInstrumentation.enable({ force: true });\n        return;\n      }\n\n      replayInstrumentation.pause();\n    },\n  };\n}\n"],"mappings":";;AAGA,SAAgB,wCACd,uBACyB;AACzB,QAAO;EACL,mBAAmB,sBAAsB,aAAa;EACtD,aAAa,YAAqB;AAChC,OAAI,SAAS;AACX,0BAAsB,OAAO,EAAE,OAAO,MAAM,CAAC;AAC7C;;AAGF,yBAAsB,OAAO;;EAEhC"}
+{"version":3,"file":"createSessionRecordingControlFromReplay.cjs","names":[],"sources":["../../../src/instrumentations/replay/createSessionRecordingControlFromReplay.ts"],"sourcesContent":["import type { SessionRecordingControl } from '../../sdk/types';\nimport type { ReplayInstrumentation } from './ReplayInstrumentation/ReplayInstrumentation';\n\nexport function createSessionRecordingControlFromReplay(\n  replayInstrumentation: ReplayInstrumentation,\n): SessionRecordingControl {\n  return {\n    isRecording: () => replayInstrumentation.isRecording(),\n    setEnabled: (enabled: boolean) => {\n      if (enabled) {\n        replayInstrumentation.resume();\n        return;\n      }\n\n      replayInstrumentation.pause();\n    },\n  };\n}\n"],"mappings":";;AAGA,SAAgB,wCACd,uBACyB;AACzB,QAAO;EACL,mBAAmB,sBAAsB,aAAa;EACtD,aAAa,YAAqB;AAChC,OAAI,SAAS;AACX,0BAAsB,QAAQ;AAC9B;;AAGF,yBAAsB,OAAO;;EAEhC"}

package/dist/instrumentations/replay/createSessionRecordingControlFromReplay.js

@@ -4,7 +4,7 @@ function createSessionRecordingControlFromReplay(replayInstrumentation) {
 		isRecording: () => replayInstrumentation.isRecording(),
 		setEnabled: (enabled) => {
 			if (enabled) {
-				replayInstrumentation.enable({ force: true });
+				replayInstrumentation.resume();
 				return;
 			}
 			replayInstrumentation.pause();

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

@@ -1 +1 @@
-{"version":3,"file":"createSessionRecordingControlFromReplay.js","names":[],"sources":["../../../src/instrumentations/replay/createSessionRecordingControlFromReplay.ts"],"sourcesContent":["import type { SessionRecordingControl } from '../../sdk/types';\nimport type { ReplayInstrumentation } from './ReplayInstrumentation/ReplayInstrumentation';\n\nexport function createSessionRecordingControlFromReplay(\n  replayInstrumentation: ReplayInstrumentation,\n): SessionRecordingControl {\n  return {\n    isRecording: () => replayInstrumentation.isRecording(),\n    setEnabled: (enabled: boolean) => {\n      if (enabled) {\n        replayInstrumentation.enable({ force: true });\n        return;\n      }\n\n      replayInstrumentation.pause();\n    },\n  };\n}\n"],"mappings":";AAGA,SAAgB,wCACd,uBACyB;AACzB,QAAO;EACL,mBAAmB,sBAAsB,aAAa;EACtD,aAAa,YAAqB;AAChC,OAAI,SAAS;AACX,0BAAsB,OAAO,EAAE,OAAO,MAAM,CAAC;AAC7C;;AAGF,yBAAsB,OAAO;;EAEhC"}
+{"version":3,"file":"createSessionRecordingControlFromReplay.js","names":[],"sources":["../../../src/instrumentations/replay/createSessionRecordingControlFromReplay.ts"],"sourcesContent":["import type { SessionRecordingControl } from '../../sdk/types';\nimport type { ReplayInstrumentation } from './ReplayInstrumentation/ReplayInstrumentation';\n\nexport function createSessionRecordingControlFromReplay(\n  replayInstrumentation: ReplayInstrumentation,\n): SessionRecordingControl {\n  return {\n    isRecording: () => replayInstrumentation.isRecording(),\n    setEnabled: (enabled: boolean) => {\n      if (enabled) {\n        replayInstrumentation.resume();\n        return;\n      }\n\n      replayInstrumentation.pause();\n    },\n  };\n}\n"],"mappings":";AAGA,SAAgB,wCACd,uBACyB;AACzB,QAAO;EACL,mBAAmB,sBAAsB,aAAa;EACtD,aAAa,YAAqB;AAChC,OAAI,SAAS;AACX,0BAAsB,QAAQ;AAC9B;;AAGF,yBAAsB,OAAO;;EAEhC"}

package/dist/instrumentations/replay/events/capture/console.cjs

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_instrumentations_replay_events_capture_shared = require("./shared.cjs");
+//#region src/instrumentations/replay/events/capture/console.ts
+const LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error",
+	"debug"
+];
+const MAX_MESSAGE = 2e3;
+function installConsoleCapture(emit) {
+	const original = {};
+	for (const level of LEVELS) {
+		const orig = console[level];
+		original[level] = orig;
+		console[level] = (...args) => {
+			require_instrumentations_replay_events_capture_shared.safeEmit(emit, {
+				level,
+				message: formatArgs(args),
+				type: "console"
+			});
+			orig.apply(console, args);
+		};
+	}
+	return () => {
+		for (const level of LEVELS) {
+			const orig = original[level];
+			if (orig) console[level] = orig;
+		}
+	};
+}
+function formatArgs(args) {
+	const text = args.map((a) => {
+		if (typeof a === "string") return a;
+		if (a instanceof Error) return `${a.name}: ${a.message}`;
+		try {
+			return JSON.stringify(a);
+		} catch {
+			return String(a);
+		}
+	}).join(" ");
+	return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;
+}
+//#endregion
+exports.installConsoleCapture = installConsoleCapture;
+
+//# sourceMappingURL=console.cjs.map

package/dist/instrumentations/replay/events/capture/console.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.cjs","names":[],"sources":["../../../../../src/instrumentations/replay/events/capture/console.ts"],"sourcesContent":["import { type Emit, safeEmit } from './shared';\n\nconst LEVELS = ['log', 'info', 'warn', 'error', 'debug'] as const;\ntype Level = (typeof LEVELS)[number];\n\nconst MAX_MESSAGE = 2_000;\n\nexport function installConsoleCapture(emit: Emit): () => void {\n  const original: Partial<Record<Level, (...args: unknown[]) => void>> = {};\n\n  for (const level of LEVELS) {\n    const orig = console[level] as (...args: unknown[]) => void;\n    original[level] = orig;\n    console[level] = (...args: unknown[]) => {\n      safeEmit(emit, { level, message: formatArgs(args), type: 'console' });\n      orig.apply(console, args);\n    };\n  }\n\n  return () => {\n    for (const level of LEVELS) {\n      const orig = original[level];\n      if (orig) {\n        console[level] = orig as never;\n      }\n    }\n  };\n}\n\nfunction formatArgs(args: unknown[]): string {\n  const text = args\n    .map((a) => {\n      if (typeof a === 'string') {\n        return a;\n      }\n      if (a instanceof Error) {\n        return `${a.name}: ${a.message}`;\n      }\n      try {\n        return JSON.stringify(a);\n      } catch {\n        return String(a);\n      }\n    })\n    .join(' ');\n  return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;\n}\n"],"mappings":";;;AAEA,MAAM,SAAS;CAAC;CAAO;CAAQ;CAAQ;CAAS;CAAQ;AAGxD,MAAM,cAAc;AAEpB,SAAgB,sBAAsB,MAAwB;CAC5D,MAAM,WAAiE,EAAE;AAEzE,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,QAAQ;AACrB,WAAS,SAAS;AAClB,UAAQ,UAAU,GAAG,SAAoB;AACvC,yDAAA,SAAS,MAAM;IAAE;IAAO,SAAS,WAAW,KAAK;IAAE,MAAM;IAAW,CAAC;AACrE,QAAK,MAAM,SAAS,KAAK;;;AAI7B,cAAa;AACX,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,OAAO,SAAS;AACtB,OAAI,KACF,SAAQ,SAAS;;;;AAMzB,SAAS,WAAW,MAAyB;CAC3C,MAAM,OAAO,KACV,KAAK,MAAM;AACV,MAAI,OAAO,MAAM,SACf,QAAO;AAET,MAAI,aAAa,MACf,QAAO,GAAG,EAAE,KAAK,IAAI,EAAE;AAEzB,MAAI;AACF,UAAO,KAAK,UAAU,EAAE;UAClB;AACN,UAAO,OAAO,EAAE;;GAElB,CACD,KAAK,IAAI;AACZ,QAAO,KAAK,SAAS,cAAc,GAAG,KAAK,MAAM,GAAG,YAAY,CAAC,KAAK"}

package/dist/instrumentations/replay/events/capture/console.d.cts

@@ -0,0 +1,7 @@
+import { Emit } from "./shared.cjs";
+
+//#region src/instrumentations/replay/events/capture/console.d.ts
+declare function installConsoleCapture(emit: Emit): () => void;
+//#endregion
+export { installConsoleCapture };
+//# sourceMappingURL=console.d.cts.map

package/dist/instrumentations/replay/events/capture/console.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.cts","names":[],"sources":["../../../../../src/instrumentations/replay/events/capture/console.ts"],"mappings":";;;iBAOgB,qBAAA,CAAsB,IAAA,EAAM,IAAA"}

package/dist/instrumentations/replay/events/capture/console.d.ts

@@ -0,0 +1,7 @@
+import { Emit } from "./shared.js";
+
+//#region src/instrumentations/replay/events/capture/console.d.ts
+declare function installConsoleCapture(emit: Emit): () => void;
+//#endregion
+export { installConsoleCapture };
+//# sourceMappingURL=console.d.ts.map

package/dist/instrumentations/replay/events/capture/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","names":[],"sources":["../../../../../src/instrumentations/replay/events/capture/console.ts"],"mappings":";;;iBAOgB,qBAAA,CAAsB,IAAA,EAAM,IAAA"}

package/dist/instrumentations/replay/events/capture/console.js

@@ -0,0 +1,47 @@
+import { safeEmit } from "./shared.js";
+//#region src/instrumentations/replay/events/capture/console.ts
+const LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error",
+	"debug"
+];
+const MAX_MESSAGE = 2e3;
+function installConsoleCapture(emit) {
+	const original = {};
+	for (const level of LEVELS) {
+		const orig = console[level];
+		original[level] = orig;
+		console[level] = (...args) => {
+			safeEmit(emit, {
+				level,
+				message: formatArgs(args),
+				type: "console"
+			});
+			orig.apply(console, args);
+		};
+	}
+	return () => {
+		for (const level of LEVELS) {
+			const orig = original[level];
+			if (orig) console[level] = orig;
+		}
+	};
+}
+function formatArgs(args) {
+	const text = args.map((a) => {
+		if (typeof a === "string") return a;
+		if (a instanceof Error) return `${a.name}: ${a.message}`;
+		try {
+			return JSON.stringify(a);
+		} catch {
+			return String(a);
+		}
+	}).join(" ");
+	return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;
+}
+//#endregion
+export { installConsoleCapture };
+
+//# sourceMappingURL=console.js.map

package/dist/instrumentations/replay/events/capture/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","names":[],"sources":["../../../../../src/instrumentations/replay/events/capture/console.ts"],"sourcesContent":["import { type Emit, safeEmit } from './shared';\n\nconst LEVELS = ['log', 'info', 'warn', 'error', 'debug'] as const;\ntype Level = (typeof LEVELS)[number];\n\nconst MAX_MESSAGE = 2_000;\n\nexport function installConsoleCapture(emit: Emit): () => void {\n  const original: Partial<Record<Level, (...args: unknown[]) => void>> = {};\n\n  for (const level of LEVELS) {\n    const orig = console[level] as (...args: unknown[]) => void;\n    original[level] = orig;\n    console[level] = (...args: unknown[]) => {\n      safeEmit(emit, { level, message: formatArgs(args), type: 'console' });\n      orig.apply(console, args);\n    };\n  }\n\n  return () => {\n    for (const level of LEVELS) {\n      const orig = original[level];\n      if (orig) {\n        console[level] = orig as never;\n      }\n    }\n  };\n}\n\nfunction formatArgs(args: unknown[]): string {\n  const text = args\n    .map((a) => {\n      if (typeof a === 'string') {\n        return a;\n      }\n      if (a instanceof Error) {\n        return `${a.name}: ${a.message}`;\n      }\n      try {\n        return JSON.stringify(a);\n      } catch {\n        return String(a);\n      }\n    })\n    .join(' ');\n  return text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;\n}\n"],"mappings":";;AAEA,MAAM,SAAS;CAAC;CAAO;CAAQ;CAAQ;CAAS;CAAQ;AAGxD,MAAM,cAAc;AAEpB,SAAgB,sBAAsB,MAAwB;CAC5D,MAAM,WAAiE,EAAE;AAEzE,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,QAAQ;AACrB,WAAS,SAAS;AAClB,UAAQ,UAAU,GAAG,SAAoB;AACvC,YAAS,MAAM;IAAE;IAAO,SAAS,WAAW,KAAK;IAAE,MAAM;IAAW,CAAC;AACrE,QAAK,MAAM,SAAS,KAAK;;;AAI7B,cAAa;AACX,OAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,OAAO,SAAS;AACtB,OAAI,KACF,SAAQ,SAAS;;;;AAMzB,SAAS,WAAW,MAAyB;CAC3C,MAAM,OAAO,KACV,KAAK,MAAM;AACV,MAAI,OAAO,MAAM,SACf,QAAO;AAET,MAAI,aAAa,MACf,QAAO,GAAG,EAAE,KAAK,IAAI,EAAE;AAEzB,MAAI;AACF,UAAO,KAAK,UAAU,EAAE;UAClB;AACN,UAAO,OAAO,EAAE;;GAElB,CACD,KAAK,IAAI;AACZ,QAAO,KAAK,SAAS,cAAc,GAAG,KAAK,MAAM,GAAG,YAAY,CAAC,KAAK"}

package/dist/instrumentations/replay/events/capture/errors.cjs

@@ -0,0 +1,41 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_instrumentations_replay_events_capture_shared = require("./shared.cjs");
+const require_instrumentations_replay_events_types = require("../types.cjs");
+//#region src/instrumentations/replay/events/capture/errors.ts
+const MAX_STACK = 4e3;
+function installErrorCapture(emit) {
+	const onError = (event) => {
+		require_instrumentations_replay_events_capture_shared.safeEmit(emit, {
+			errorStack: truncate(event.error?.stack),
+			level: "error",
+			message: event.message || String(event.error ?? "Error"),
+			traceId: require_instrumentations_replay_events_types.activeTraceId(),
+			type: "error"
+		});
+	};
+	const onRejection = (event) => {
+		const reason = event.reason;
+		const message = typeof reason === "string" ? reason : reason?.message ?? "Unhandled promise rejection";
+		require_instrumentations_replay_events_capture_shared.safeEmit(emit, {
+			errorStack: truncate(typeof reason === "object" ? reason?.stack : void 0),
+			level: "error",
+			message,
+			traceId: require_instrumentations_replay_events_types.activeTraceId(),
+			type: "error"
+		});
+	};
+	window.addEventListener("error", onError);
+	window.addEventListener("unhandledrejection", onRejection);
+	return () => {
+		window.removeEventListener("error", onError);
+		window.removeEventListener("unhandledrejection", onRejection);
+	};
+}
+function truncate(stack) {
+	if (!stack) return;
+	return stack.length > MAX_STACK ? `${stack.slice(0, MAX_STACK)}…` : stack;
+}
+//#endregion
+exports.installErrorCapture = installErrorCapture;
+
+//# sourceMappingURL=errors.cjs.map

package/dist/instrumentations/replay/events/capture/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":["activeTraceId"],"sources":["../../../../../src/instrumentations/replay/events/capture/errors.ts"],"sourcesContent":["import { activeTraceId } from '../types';\nimport { type Emit, safeEmit } from './shared';\n\nconst MAX_STACK = 4_000;\n\nexport function installErrorCapture(emit: Emit): () => void {\n  const onError = (event: ErrorEvent): void => {\n    safeEmit(emit, {\n      errorStack: truncate(event.error?.stack),\n      level: 'error',\n      message: event.message || String(event.error ?? 'Error'),\n      traceId: activeTraceId(),\n      type: 'error',\n    });\n  };\n\n  const onRejection = (event: PromiseRejectionEvent): void => {\n    const reason = event.reason as\n      | { message?: string; stack?: string }\n      | string\n      | undefined;\n    const message =\n      typeof reason === 'string'\n        ? reason\n        : (reason?.message ?? 'Unhandled promise rejection');\n    safeEmit(emit, {\n      errorStack: truncate(\n        typeof reason === 'object' ? reason?.stack : undefined,\n      ),\n      level: 'error',\n      message,\n      traceId: activeTraceId(),\n      type: 'error',\n    });\n  };\n\n  window.addEventListener('error', onError);\n  window.addEventListener('unhandledrejection', onRejection);\n\n  return () => {\n    window.removeEventListener('error', onError);\n    window.removeEventListener('unhandledrejection', onRejection);\n  };\n}\n\nfunction truncate(stack: string | undefined): string | undefined {\n  if (!stack) {\n    return undefined;\n  }\n  return stack.length > MAX_STACK ? `${stack.slice(0, MAX_STACK)}…` : stack;\n}\n"],"mappings":";;;;AAGA,MAAM,YAAY;AAElB,SAAgB,oBAAoB,MAAwB;CAC1D,MAAM,WAAW,UAA4B;AAC3C,wDAAA,SAAS,MAAM;GACb,YAAY,SAAS,MAAM,OAAO,MAAM;GACxC,OAAO;GACP,SAAS,MAAM,WAAW,OAAO,MAAM,SAAS,QAAQ;GACxD,SAASA,6CAAAA,eAAe;GACxB,MAAM;GACP,CAAC;;CAGJ,MAAM,eAAe,UAAuC;EAC1D,MAAM,SAAS,MAAM;EAIrB,MAAM,UACJ,OAAO,WAAW,WACd,SACC,QAAQ,WAAW;AAC1B,wDAAA,SAAS,MAAM;GACb,YAAY,SACV,OAAO,WAAW,WAAW,QAAQ,QAAQ,KAAA,EAC9C;GACD,OAAO;GACP;GACA,SAASA,6CAAAA,eAAe;GACxB,MAAM;GACP,CAAC;;AAGJ,QAAO,iBAAiB,SAAS,QAAQ;AACzC,QAAO,iBAAiB,sBAAsB,YAAY;AAE1D,cAAa;AACX,SAAO,oBAAoB,SAAS,QAAQ;AAC5C,SAAO,oBAAoB,sBAAsB,YAAY;;;AAIjE,SAAS,SAAS,OAA+C;AAC/D,KAAI,CAAC,MACH;AAEF,QAAO,MAAM,SAAS,YAAY,GAAG,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK"}

package/dist/instrumentations/replay/events/capture/errors.d.cts

@@ -0,0 +1,7 @@
+import { Emit } from "./shared.cjs";
+
+//#region src/instrumentations/replay/events/capture/errors.d.ts
+declare function installErrorCapture(emit: Emit): () => void;
+//#endregion
+export { installErrorCapture };
+//# sourceMappingURL=errors.d.cts.map

package/dist/instrumentations/replay/events/capture/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../../../../src/instrumentations/replay/events/capture/errors.ts"],"mappings":";;;iBAKgB,mBAAA,CAAoB,IAAA,EAAM,IAAA"}