@safaricom-mxl/web-sdk 0.0.18 → 0.0.20

package/dist/instrumentations/replay/session-recording/SessionRecording.js

@@ -0,0 +1,174 @@
+import { startEventCapture } from "../events/startEventCapture.js";
+import { loadRrwebModule } from "../rrwebLoader/loadRrwebModule.esm.js";
+import { startRecording } from "../recorder/startRecording.js";
+import { clearObservedTraceIds, clearReplaySessionSink, publishReplaySessionSink } from "../trace-sink/traceSink.js";
+import { createChunkSeqStore } from "./chunkSeq.js";
+import { resolveReplayConfig } from "./config.js";
+import { getSessionStartedAt, installReplayLifecycleHandlers, sessionMetaRow } from "./lifecycle.js";
+//#region src/instrumentations/replay/session-recording/SessionRecording.ts
+var SessionRecording = class {
+	_context;
+	_userSessionManager;
+	_chunkSeqStore;
+	_config;
+	_diag;
+	_recordUserSessions;
+	_active;
+	_paused = false;
+	_enableRequested = false;
+	_startInProgress = false;
+	_stopInProgress = false;
+	_removeSessionStartedListener;
+	constructor({ context, userSessionManager, sessionStorage, rrwebOptions, recordUserSessions = true, diag }) {
+		this._context = context;
+		this._userSessionManager = userSessionManager;
+		this._chunkSeqStore = createChunkSeqStore(sessionStorage);
+		this._recordUserSessions = recordUserSessions;
+		this._config = resolveReplayConfig(context, rrwebOptions, recordUserSessions);
+		this._diag = diag ?? {
+			debug: () => void 0,
+			error: () => void 0,
+			info: () => void 0,
+			verbose: () => void 0,
+			warn: () => void 0
+		};
+	}
+	isRecording() {
+		return Boolean(this._active) && !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._tryStart();
+	}
+	pause() {
+		if (!this._active) return;
+		this._enableRequested = false;
+		this._paused = true;
+		this._active.recorder.pause();
+		this._active.events.pause();
+	}
+	resume() {
+		if (!this._active) {
+			this.enable();
+			return;
+		}
+		const wasPaused = this._paused;
+		this._enableRequested = true;
+		this._paused = false;
+		this._active.recorder.resume();
+		this._active.events.resume();
+		if (wasPaused) this._active.rrwebModule.record.takeFullSnapshot();
+	}
+	async stop() {
+		this._enableRequested = false;
+		this._paused = false;
+		this._removeSessionStartedListener?.();
+		this._removeSessionStartedListener = void 0;
+		if (!this._active) {
+			clearReplaySessionSink();
+			clearObservedTraceIds();
+			return;
+		}
+		if (this._stopInProgress) return;
+		this._stopInProgress = true;
+		const active = this._active;
+		this._active = void 0;
+		try {
+			active.removeSessionEndListener?.();
+			active.removeLifecycle();
+			await active.recorder.flush(true);
+			await active.events.flush(true);
+			active.recorder.stop();
+			active.events.stop();
+		} finally {
+			clearReplaySessionSink();
+			clearObservedTraceIds();
+			this._stopInProgress = false;
+		}
+	}
+	async _tryStart() {
+		if (!this._enableRequested || this._active || this._startInProgress || this._stopInProgress) return;
+		if (typeof window === "undefined") {
+			this._diag.warn("session replay cannot run in non-browser environments");
+			return;
+		}
+		const sessionId = this._userSessionManager.getUserSessionId();
+		if (sessionId === null) {
+			if (!this._removeSessionStartedListener) this._removeSessionStartedListener = this._userSessionManager.addSessionPartStartedListener(() => {
+				this._removeSessionStartedListener?.();
+				this._removeSessionStartedListener = void 0;
+				this._tryStart();
+			});
+			return;
+		}
+		if (!this._config.replayEnabled) return;
+		if (Math.random() >= this._config.replaySampleRate) {
+			this._diag.debug("session replay skipped by sample rate");
+			return;
+		}
+		this._startInProgress = true;
+		try {
+			const rrwebModule = await loadRrwebModule();
+			if (!this._enableRequested || this._active) return;
+			publishReplaySessionSink(sessionId);
+			clearObservedTraceIds();
+			const startedAt = getSessionStartedAt(this._userSessionManager);
+			const onActivity = () => {};
+			const recorder = startRecording({
+				chunkSeqStore: this._chunkSeqStore,
+				config: this._config,
+				flushIntervalMs: this._config.flushIntervalMs,
+				onActivity,
+				rrwebModule,
+				sessionId,
+				transport: this._context.transport
+			});
+			const events = startEventCapture({
+				config: this._config,
+				flushIntervalMs: this._config.flushIntervalMs,
+				onActivity,
+				sessionId,
+				transport: this._context.transport
+			});
+			this._context.transport.postSessionMeta(sessionMetaRow(this._config, sessionId, startedAt, 1, "active", null));
+			const removeLifecycle = globalThis.__MXL_TEST_SKIP_REPLAY_LIFECYCLE__ === true ? () => void 0 : installReplayLifecycleHandlers({
+				config: this._config,
+				events,
+				onFinalize: () => {
+					this._active = void 0;
+					clearReplaySessionSink();
+					clearObservedTraceIds();
+				},
+				recorder,
+				sessionId,
+				startedAt,
+				transport: this._context.transport
+			});
+			const removeSessionEndListener = this._userSessionManager.addSessionPartEndedListener(() => {
+				recorder.flush(true);
+				events.flush(true);
+			});
+			this._active = {
+				events,
+				recorder,
+				removeLifecycle,
+				removeSessionEndListener,
+				rrwebModule
+			};
+			this._diag.debug("session recording started");
+		} catch (error) {
+			this._diag.error("failed to start session recording", error);
+		} finally {
+			this._startInProgress = false;
+		}
+	}
+};
+//#endregion
+export { SessionRecording };
+
+//# sourceMappingURL=SessionRecording.js.map

package/dist/instrumentations/replay/session-recording/SessionRecording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionRecording.js","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/SessionRecording.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { UserSessionManagerInternal } from '../../../managers/MXLUserSessionManager/types';\nimport type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\nimport { startEventCapture } from '../events/startEventCapture';\nimport { loadRrwebModule } from '../rrwebLoader/loadRrwebModule';\nimport type { RrwebModule } from '../rrwebLoader/types';\nimport { startRecording } from '../recorder/startRecording';\nimport type { Recorder } from '../recorder/types';\nimport {\n  clearObservedTraceIds,\n  clearReplaySessionSink,\n  publishReplaySessionSink,\n} from '../trace-sink/traceSink';\nimport { createChunkSeqStore } from './chunkSeq';\nimport {\n  type ReplayContext,\n  type ResolvedReplayConfig,\n  resolveReplayConfig,\n} from './config';\nimport type { EventCapture } from '../events/startEventCapture';\nimport {\n  getSessionStartedAt,\n  installReplayLifecycleHandlers,\n  sessionMetaRow,\n} from './lifecycle';\n\nexport interface SessionRecordingArgs {\n  context: ReplayContext;\n  userSessionManager: UserSessionManagerInternal;\n  sessionStorage: NamespacedStorage;\n  rrwebOptions?: ResolvedReplayConfig['rrwebOptions'] & {\n    debug?: boolean;\n    enabled?: boolean;\n    sampleRate?: number;\n    maskAllInputs?: boolean;\n    maskAllText?: boolean;\n    flushIntervalMs?: number;\n  };\n  recordUserSessions?: boolean;\n  diag?: DiagLogger;\n}\n\ninterface ActiveRecording {\n  recorder: Recorder;\n  events: EventCapture;\n  rrwebModule: RrwebModule;\n  removeLifecycle: () => void;\n  removeSessionEndListener?: () => void;\n}\n\nexport class SessionRecording {\n  private readonly _context: ReplayContext;\n  private readonly _userSessionManager: UserSessionManagerInternal;\n  private readonly _chunkSeqStore: ReturnType<typeof createChunkSeqStore>;\n  private readonly _config: ResolvedReplayConfig;\n  private readonly _diag: DiagLogger;\n  private readonly _recordUserSessions: boolean;\n\n  private _active: ActiveRecording | undefined;\n  private _paused = false;\n  private _enableRequested = false;\n  private _startInProgress = false;\n  private _stopInProgress = false;\n  private _removeSessionStartedListener?: () => void;\n\n  public constructor({\n    context,\n    userSessionManager,\n    sessionStorage,\n    rrwebOptions,\n    recordUserSessions = true,\n    diag,\n  }: SessionRecordingArgs) {\n    this._context = context;\n    this._userSessionManager = userSessionManager;\n    this._chunkSeqStore = createChunkSeqStore(sessionStorage);\n    this._recordUserSessions = recordUserSessions;\n    this._config = resolveReplayConfig(\n      context,\n      rrwebOptions,\n      recordUserSessions,\n    );\n    this._diag = diag ?? {\n      debug: () => undefined,\n      error: () => undefined,\n      info: () => undefined,\n      verbose: () => undefined,\n      warn: () => undefined,\n    };\n  }\n\n  public isRecording(): boolean {\n    return Boolean(this._active) && !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._tryStart();\n  }\n\n  public pause(): void {\n    if (!this._active) {\n      return;\n    }\n    this._enableRequested = false;\n    this._paused = true;\n    this._active.recorder.pause();\n    this._active.events.pause();\n  }\n\n  public resume(): void {\n    if (!this._active) {\n      this.enable();\n      return;\n    }\n\n    const wasPaused = this._paused;\n    this._enableRequested = true;\n    this._paused = false;\n    this._active.recorder.resume();\n    this._active.events.resume();\n    if (wasPaused) {\n      this._active.rrwebModule.record.takeFullSnapshot();\n    }\n  }\n\n  public async stop(): Promise<void> {\n    this._enableRequested = false;\n    this._paused = false;\n    this._removeSessionStartedListener?.();\n    this._removeSessionStartedListener = undefined;\n\n    if (!this._active) {\n      clearReplaySessionSink();\n      clearObservedTraceIds();\n      return;\n    }\n\n    if (this._stopInProgress) {\n      return;\n    }\n\n    this._stopInProgress = true;\n\n    const active = this._active;\n    this._active = undefined;\n\n    try {\n      active.removeSessionEndListener?.();\n      active.removeLifecycle();\n\n      await active.recorder.flush(true);\n      await active.events.flush(true);\n      active.recorder.stop();\n      active.events.stop();\n    } finally {\n      clearReplaySessionSink();\n      clearObservedTraceIds();\n      this._stopInProgress = false;\n    }\n  }\n\n  private async _tryStart(): Promise<void> {\n    if (\n      !this._enableRequested ||\n      this._active ||\n      this._startInProgress ||\n      this._stopInProgress\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    const sessionId = this._userSessionManager.getUserSessionId();\n    if (sessionId === null) {\n      if (!this._removeSessionStartedListener) {\n        this._removeSessionStartedListener =\n          this._userSessionManager.addSessionPartStartedListener(() => {\n            this._removeSessionStartedListener?.();\n            this._removeSessionStartedListener = undefined;\n            void this._tryStart();\n          });\n      }\n      return;\n    }\n\n    if (!this._config.replayEnabled) {\n      return;\n    }\n\n    if (Math.random() >= this._config.replaySampleRate) {\n      this._diag.debug('session replay skipped by sample rate');\n      return;\n    }\n\n    this._startInProgress = true;\n\n    try {\n      const rrwebModule = await loadRrwebModule();\n      if (!this._enableRequested || this._active) {\n        return;\n      }\n\n      publishReplaySessionSink(sessionId);\n      clearObservedTraceIds();\n\n      const startedAt = getSessionStartedAt(this._userSessionManager);\n      const onActivity = () => {\n        // Activity is tracked via MXL user session manager; no-op hook for now.\n      };\n\n      const recorder = startRecording({\n        chunkSeqStore: this._chunkSeqStore,\n        config: this._config,\n        flushIntervalMs: this._config.flushIntervalMs,\n        onActivity,\n        rrwebModule,\n        sessionId,\n        transport: this._context.transport,\n      });\n\n      const events = startEventCapture({\n        config: this._config,\n        flushIntervalMs: this._config.flushIntervalMs,\n        onActivity,\n        sessionId,\n        transport: this._context.transport,\n      });\n\n      void this._context.transport.postSessionMeta(\n        sessionMetaRow(this._config, sessionId, startedAt, 1, 'active', null),\n      );\n\n      const skipLifecycle = (\n        globalThis as Record<string, unknown>\n      ).__MXL_TEST_SKIP_REPLAY_LIFECYCLE__;\n\n      const removeLifecycle =\n        skipLifecycle === true\n          ? () => undefined\n          : installReplayLifecycleHandlers({\n              config: this._config,\n              events,\n              onFinalize: () => {\n                this._active = undefined;\n                clearReplaySessionSink();\n                clearObservedTraceIds();\n              },\n              recorder,\n              sessionId,\n              startedAt,\n              transport: this._context.transport,\n            });\n\n      const removeSessionEndListener =\n        this._userSessionManager.addSessionPartEndedListener(() => {\n          void recorder.flush(true);\n          void events.flush(true);\n        });\n\n      this._active = {\n        events,\n        recorder,\n        removeLifecycle,\n        removeSessionEndListener,\n        rrwebModule,\n      };\n\n      this._diag.debug('session recording started');\n    } catch (error) {\n      this._diag.error('failed to start session recording', error);\n    } finally {\n      this._startInProgress = false;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/instrumentations/replay/session-recording/chunkSeq.cjs

@@ -0,0 +1,17 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/instrumentations/replay/session-recording/chunkSeq.ts
+const CHUNK_SEQ_KEY_PREFIX = "replay.chunkSeq.";
+function createChunkSeqStore(storage) {
+	const keyFor = (sessionId) => `${CHUNK_SEQ_KEY_PREFIX}${sessionId}`;
+	return { nextChunkSeq(sessionId) {
+		const raw = storage.getItem(keyFor(sessionId));
+		const seq = raw === null ? 0 : Number.parseInt(raw, 10);
+		const next = Number.isFinite(seq) ? seq : 0;
+		storage.setItem(keyFor(sessionId), String(next + 1));
+		return next;
+	} };
+}
+//#endregion
+exports.createChunkSeqStore = createChunkSeqStore;
+
+//# sourceMappingURL=chunkSeq.cjs.map

package/dist/instrumentations/replay/session-recording/chunkSeq.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkSeq.cjs","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/chunkSeq.ts"],"sourcesContent":["import type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\n\nconst CHUNK_SEQ_KEY_PREFIX = 'replay.chunkSeq.';\n\nexport interface ChunkSeqStore {\n  nextChunkSeq: (sessionId: string) => number;\n}\n\nexport function createChunkSeqStore(\n  storage: NamespacedStorage,\n): ChunkSeqStore {\n  const keyFor = (sessionId: string) => `${CHUNK_SEQ_KEY_PREFIX}${sessionId}`;\n\n  return {\n    nextChunkSeq(sessionId: string): number {\n      const raw = storage.getItem(keyFor(sessionId));\n      const seq = raw === null ? 0 : Number.parseInt(raw, 10);\n      const next = Number.isFinite(seq) ? seq : 0;\n      storage.setItem(keyFor(sessionId), String(next + 1));\n      return next;\n    },\n  };\n}\n"],"mappings":";;AAEA,MAAM,uBAAuB;AAM7B,SAAgB,oBACd,SACe;CACf,MAAM,UAAU,cAAsB,GAAG,uBAAuB;AAEhE,QAAO,EACL,aAAa,WAA2B;EACtC,MAAM,MAAM,QAAQ,QAAQ,OAAO,UAAU,CAAC;EAC9C,MAAM,MAAM,QAAQ,OAAO,IAAI,OAAO,SAAS,KAAK,GAAG;EACvD,MAAM,OAAO,OAAO,SAAS,IAAI,GAAG,MAAM;AAC1C,UAAQ,QAAQ,OAAO,UAAU,EAAE,OAAO,OAAO,EAAE,CAAC;AACpD,SAAO;IAEV"}

package/dist/instrumentations/replay/session-recording/chunkSeq.d.cts

@@ -0,0 +1,10 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.cjs";
+
+//#region src/instrumentations/replay/session-recording/chunkSeq.d.ts
+interface ChunkSeqStore {
+  nextChunkSeq: (sessionId: string) => number;
+}
+declare function createChunkSeqStore(storage: NamespacedStorage): ChunkSeqStore;
+//#endregion
+export { ChunkSeqStore, createChunkSeqStore };
+//# sourceMappingURL=chunkSeq.d.cts.map

package/dist/instrumentations/replay/session-recording/chunkSeq.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkSeq.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/chunkSeq.ts"],"mappings":";;;UAIiB,aAAA;EACf,YAAA,GAAe,SAAA;AAAA;AAAA,iBAGD,mBAAA,CACd,OAAA,EAAS,iBAAA,GACR,aAAA"}

package/dist/instrumentations/replay/session-recording/chunkSeq.d.ts

@@ -0,0 +1,10 @@
+import { NamespacedStorage } from "../../../utils/NamespacedStorage/NamespacedStorage.js";
+
+//#region src/instrumentations/replay/session-recording/chunkSeq.d.ts
+interface ChunkSeqStore {
+  nextChunkSeq: (sessionId: string) => number;
+}
+declare function createChunkSeqStore(storage: NamespacedStorage): ChunkSeqStore;
+//#endregion
+export { ChunkSeqStore, createChunkSeqStore };
+//# sourceMappingURL=chunkSeq.d.ts.map

package/dist/instrumentations/replay/session-recording/chunkSeq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkSeq.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/chunkSeq.ts"],"mappings":";;;UAIiB,aAAA;EACf,YAAA,GAAe,SAAA;AAAA;AAAA,iBAGD,mBAAA,CACd,OAAA,EAAS,iBAAA,GACR,aAAA"}

package/dist/instrumentations/replay/session-recording/chunkSeq.js

@@ -0,0 +1,16 @@
+//#region src/instrumentations/replay/session-recording/chunkSeq.ts
+const CHUNK_SEQ_KEY_PREFIX = "replay.chunkSeq.";
+function createChunkSeqStore(storage) {
+	const keyFor = (sessionId) => `${CHUNK_SEQ_KEY_PREFIX}${sessionId}`;
+	return { nextChunkSeq(sessionId) {
+		const raw = storage.getItem(keyFor(sessionId));
+		const seq = raw === null ? 0 : Number.parseInt(raw, 10);
+		const next = Number.isFinite(seq) ? seq : 0;
+		storage.setItem(keyFor(sessionId), String(next + 1));
+		return next;
+	} };
+}
+//#endregion
+export { createChunkSeqStore };
+
+//# sourceMappingURL=chunkSeq.js.map

package/dist/instrumentations/replay/session-recording/chunkSeq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunkSeq.js","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/chunkSeq.ts"],"sourcesContent":["import type { NamespacedStorage } from '../../../utils/NamespacedStorage/NamespacedStorage';\n\nconst CHUNK_SEQ_KEY_PREFIX = 'replay.chunkSeq.';\n\nexport interface ChunkSeqStore {\n  nextChunkSeq: (sessionId: string) => number;\n}\n\nexport function createChunkSeqStore(\n  storage: NamespacedStorage,\n): ChunkSeqStore {\n  const keyFor = (sessionId: string) => `${CHUNK_SEQ_KEY_PREFIX}${sessionId}`;\n\n  return {\n    nextChunkSeq(sessionId: string): number {\n      const raw = storage.getItem(keyFor(sessionId));\n      const seq = raw === null ? 0 : Number.parseInt(raw, 10);\n      const next = Number.isFinite(seq) ? seq : 0;\n      storage.setItem(keyFor(sessionId), String(next + 1));\n      return next;\n    },\n  };\n}\n"],"mappings":";AAEA,MAAM,uBAAuB;AAM7B,SAAgB,oBACd,SACe;CACf,MAAM,UAAU,cAAsB,GAAG,uBAAuB;AAEhE,QAAO,EACL,aAAa,WAA2B;EACtC,MAAM,MAAM,QAAQ,QAAQ,OAAO,UAAU,CAAC;EAC9C,MAAM,MAAM,QAAQ,OAAO,IAAI,OAAO,SAAS,KAAK,GAAG;EACvD,MAAM,OAAO,OAAO,SAAS,IAAI,GAAG,MAAM;AAC1C,UAAQ,QAAQ,OAAO,UAAU,EAAE,OAAO,OAAO,EAAE,CAAC;AACpD,SAAO;IAEV"}

package/dist/instrumentations/replay/session-recording/config.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/instrumentations/replay/session-recording/config.ts
+function resolveReplayConfig(context, options, recordUserSessions = true) {
+	const { debug = false, enabled, sampleRate, maskAllInputs = true, maskAllText = true, flushIntervalMs = 5e3, omitRedundantInstrumentations: _omitRedundantInstrumentations, ...rrwebOptions } = options ?? {};
+	return {
+		appID: context.appID,
+		appVersion: context.appVersion,
+		debug,
+		environment: void 0,
+		flushIntervalMs,
+		maskAllInputs,
+		maskAllText,
+		replayEnabled: enabled ?? recordUserSessions,
+		replaySampleRate: sampleRate ?? 1,
+		rrwebOptions,
+		serviceName: context.serviceName,
+		userID: context.userID
+	};
+}
+//#endregion
+exports.resolveReplayConfig = resolveReplayConfig;
+
+//# sourceMappingURL=config.cjs.map

package/dist/instrumentations/replay/session-recording/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/config.ts"],"sourcesContent":["import type { ReplayUserConfig } from '../ReplayInstrumentation/types';\nimport type { ReplayTransport } from '../transport/types';\n\nexport interface ResolvedReplayConfig {\n  readonly appID: string;\n  readonly userID: string;\n  readonly appVersion?: string;\n  readonly serviceName?: string;\n  readonly environment?: string;\n  readonly replayEnabled: boolean;\n  readonly replaySampleRate: number;\n  readonly maskAllInputs: boolean;\n  readonly maskAllText: boolean;\n  readonly debug: boolean;\n  readonly flushIntervalMs: number;\n  readonly rrwebOptions: Omit<\n    ReplayUserConfig,\n    | 'debug'\n    | 'enabled'\n    | 'sampleRate'\n    | 'maskAllInputs'\n    | 'maskAllText'\n    | 'flushIntervalMs'\n    | 'omitRedundantInstrumentations'\n  >;\n  userId?: string;\n}\n\nexport interface ReplayContext {\n  readonly appID: string;\n  readonly userID: string;\n  readonly apiURL?: string;\n  readonly appVersion?: string;\n  readonly serviceName?: string;\n  readonly transport: ReplayTransport;\n}\n\nexport function resolveReplayConfig(\n  context: ReplayContext,\n  options?: ReplayUserConfig,\n  recordUserSessions = true,\n): ResolvedReplayConfig {\n  const {\n    debug = false,\n    enabled,\n    sampleRate,\n    maskAllInputs = true,\n    maskAllText = true,\n    flushIntervalMs = 5_000,\n    omitRedundantInstrumentations: _omitRedundantInstrumentations,\n    ...rrwebOptions\n  } = options ?? {};\n\n  return {\n    appID: context.appID,\n    appVersion: context.appVersion,\n    debug,\n    environment: undefined,\n    flushIntervalMs,\n    maskAllInputs,\n    maskAllText,\n    replayEnabled: enabled ?? recordUserSessions,\n    replaySampleRate: sampleRate ?? 1,\n    rrwebOptions,\n    serviceName: context.serviceName,\n    userID: context.userID,\n  };\n}\n"],"mappings":";;AAqCA,SAAgB,oBACd,SACA,SACA,qBAAqB,MACC;CACtB,MAAM,EACJ,QAAQ,OACR,SACA,YACA,gBAAgB,MAChB,cAAc,MACd,kBAAkB,KAClB,+BAA+B,gCAC/B,GAAG,iBACD,WAAW,EAAE;AAEjB,QAAO;EACL,OAAO,QAAQ;EACf,YAAY,QAAQ;EACpB;EACA,aAAa,KAAA;EACb;EACA;EACA;EACA,eAAe,WAAW;EAC1B,kBAAkB,cAAc;EAChC;EACA,aAAa,QAAQ;EACrB,QAAQ,QAAQ;EACjB"}

package/dist/instrumentations/replay/session-recording/config.d.cts

@@ -0,0 +1,31 @@
+import { ReplayTransport } from "../transport/types.cjs";
+import { ReplayUserConfig } from "../ReplayInstrumentation/types.cjs";
+
+//#region src/instrumentations/replay/session-recording/config.d.ts
+interface ResolvedReplayConfig {
+  readonly appID: string;
+  readonly userID: string;
+  readonly appVersion?: string;
+  readonly serviceName?: string;
+  readonly environment?: string;
+  readonly replayEnabled: boolean;
+  readonly replaySampleRate: number;
+  readonly maskAllInputs: boolean;
+  readonly maskAllText: boolean;
+  readonly debug: boolean;
+  readonly flushIntervalMs: number;
+  readonly rrwebOptions: Omit<ReplayUserConfig, 'debug' | 'enabled' | 'sampleRate' | 'maskAllInputs' | 'maskAllText' | 'flushIntervalMs' | 'omitRedundantInstrumentations'>;
+  userId?: string;
+}
+interface ReplayContext {
+  readonly appID: string;
+  readonly userID: string;
+  readonly apiURL?: string;
+  readonly appVersion?: string;
+  readonly serviceName?: string;
+  readonly transport: ReplayTransport;
+}
+declare function resolveReplayConfig(context: ReplayContext, options?: ReplayUserConfig, recordUserSessions?: boolean): ResolvedReplayConfig;
+//#endregion
+export { ReplayContext, ResolvedReplayConfig, resolveReplayConfig };
+//# sourceMappingURL=config.d.cts.map

package/dist/instrumentations/replay/session-recording/config.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/config.ts"],"mappings":";;;;UAGiB,oBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,aAAA;EAAA,SACA,gBAAA;EAAA,SACA,aAAA;EAAA,SACA,WAAA;EAAA,SACA,KAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA,EAAc,IAAA,CACrB,gBAAA;EASF,MAAA;AAAA;AAAA,UAGe,aAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA,EAAW,eAAA;AAAA;AAAA,iBAGN,mBAAA,CACd,OAAA,EAAS,aAAA,EACT,OAAA,GAAU,gBAAA,EACV,kBAAA,aACC,oBAAA"}

package/dist/instrumentations/replay/session-recording/config.d.ts

@@ -0,0 +1,31 @@
+import { ReplayTransport } from "../transport/types.js";
+import { ReplayUserConfig } from "../ReplayInstrumentation/types.js";
+
+//#region src/instrumentations/replay/session-recording/config.d.ts
+interface ResolvedReplayConfig {
+  readonly appID: string;
+  readonly userID: string;
+  readonly appVersion?: string;
+  readonly serviceName?: string;
+  readonly environment?: string;
+  readonly replayEnabled: boolean;
+  readonly replaySampleRate: number;
+  readonly maskAllInputs: boolean;
+  readonly maskAllText: boolean;
+  readonly debug: boolean;
+  readonly flushIntervalMs: number;
+  readonly rrwebOptions: Omit<ReplayUserConfig, 'debug' | 'enabled' | 'sampleRate' | 'maskAllInputs' | 'maskAllText' | 'flushIntervalMs' | 'omitRedundantInstrumentations'>;
+  userId?: string;
+}
+interface ReplayContext {
+  readonly appID: string;
+  readonly userID: string;
+  readonly apiURL?: string;
+  readonly appVersion?: string;
+  readonly serviceName?: string;
+  readonly transport: ReplayTransport;
+}
+declare function resolveReplayConfig(context: ReplayContext, options?: ReplayUserConfig, recordUserSessions?: boolean): ResolvedReplayConfig;
+//#endregion
+export { ReplayContext, ResolvedReplayConfig, resolveReplayConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/instrumentations/replay/session-recording/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/config.ts"],"mappings":";;;;UAGiB,oBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;EAAA,SACA,WAAA;EAAA,SACA,WAAA;EAAA,SACA,aAAA;EAAA,SACA,gBAAA;EAAA,SACA,aAAA;EAAA,SACA,WAAA;EAAA,SACA,KAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA,EAAc,IAAA,CACrB,gBAAA;EASF,MAAA;AAAA;AAAA,UAGe,aAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;EAAA,SACA,UAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA,EAAW,eAAA;AAAA;AAAA,iBAGN,mBAAA,CACd,OAAA,EAAS,aAAA,EACT,OAAA,GAAU,gBAAA,EACV,kBAAA,aACC,oBAAA"}

package/dist/instrumentations/replay/session-recording/config.js

@@ -0,0 +1,22 @@
+//#region src/instrumentations/replay/session-recording/config.ts
+function resolveReplayConfig(context, options, recordUserSessions = true) {
+	const { debug = false, enabled, sampleRate, maskAllInputs = true, maskAllText = true, flushIntervalMs = 5e3, omitRedundantInstrumentations: _omitRedundantInstrumentations, ...rrwebOptions } = options ?? {};
+	return {
+		appID: context.appID,
+		appVersion: context.appVersion,
+		debug,
+		environment: void 0,
+		flushIntervalMs,
+		maskAllInputs,
+		maskAllText,
+		replayEnabled: enabled ?? recordUserSessions,
+		replaySampleRate: sampleRate ?? 1,
+		rrwebOptions,
+		serviceName: context.serviceName,
+		userID: context.userID
+	};
+}
+//#endregion
+export { resolveReplayConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/instrumentations/replay/session-recording/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/config.ts"],"sourcesContent":["import type { ReplayUserConfig } from '../ReplayInstrumentation/types';\nimport type { ReplayTransport } from '../transport/types';\n\nexport interface ResolvedReplayConfig {\n  readonly appID: string;\n  readonly userID: string;\n  readonly appVersion?: string;\n  readonly serviceName?: string;\n  readonly environment?: string;\n  readonly replayEnabled: boolean;\n  readonly replaySampleRate: number;\n  readonly maskAllInputs: boolean;\n  readonly maskAllText: boolean;\n  readonly debug: boolean;\n  readonly flushIntervalMs: number;\n  readonly rrwebOptions: Omit<\n    ReplayUserConfig,\n    | 'debug'\n    | 'enabled'\n    | 'sampleRate'\n    | 'maskAllInputs'\n    | 'maskAllText'\n    | 'flushIntervalMs'\n    | 'omitRedundantInstrumentations'\n  >;\n  userId?: string;\n}\n\nexport interface ReplayContext {\n  readonly appID: string;\n  readonly userID: string;\n  readonly apiURL?: string;\n  readonly appVersion?: string;\n  readonly serviceName?: string;\n  readonly transport: ReplayTransport;\n}\n\nexport function resolveReplayConfig(\n  context: ReplayContext,\n  options?: ReplayUserConfig,\n  recordUserSessions = true,\n): ResolvedReplayConfig {\n  const {\n    debug = false,\n    enabled,\n    sampleRate,\n    maskAllInputs = true,\n    maskAllText = true,\n    flushIntervalMs = 5_000,\n    omitRedundantInstrumentations: _omitRedundantInstrumentations,\n    ...rrwebOptions\n  } = options ?? {};\n\n  return {\n    appID: context.appID,\n    appVersion: context.appVersion,\n    debug,\n    environment: undefined,\n    flushIntervalMs,\n    maskAllInputs,\n    maskAllText,\n    replayEnabled: enabled ?? recordUserSessions,\n    replaySampleRate: sampleRate ?? 1,\n    rrwebOptions,\n    serviceName: context.serviceName,\n    userID: context.userID,\n  };\n}\n"],"mappings":";AAqCA,SAAgB,oBACd,SACA,SACA,qBAAqB,MACC;CACtB,MAAM,EACJ,QAAQ,OACR,SACA,YACA,gBAAgB,MAChB,cAAc,MACd,kBAAkB,KAClB,+BAA+B,gCAC/B,GAAG,iBACD,WAAW,EAAE;AAEjB,QAAO;EACL,OAAO,QAAQ;EACf,YAAY,QAAQ;EACpB;EACA,aAAa,KAAA;EACb;EACA;EACA;EACA,eAAe,WAAW;EAC1B,kBAAkB,cAAc;EAChC;EACA,aAAa,QAAQ;EACrB,QAAQ,QAAQ;EACjB"}

package/dist/instrumentations/replay/session-recording/format.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/instrumentations/replay/session-recording/format.ts
+/**
+* Ported from Maple browser SDK (MIT).
+* @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts
+*/
+/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */
+function formatCHDateTime(date) {
+	const pad = (n, width = 2) => String(n).padStart(width, "0");
+	return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}.${pad(date.getUTCMilliseconds(), 3)}`;
+}
+/** Best-effort UA parse — enough to populate filterable session facets. */
+function parseUserAgent(ua) {
+	const browserName = /edg/i.test(ua) ? "Edge" : /opr|opera/i.test(ua) ? "Opera" : /chrome|crios/i.test(ua) ? "Chrome" : /firefox|fxios/i.test(ua) ? "Firefox" : /safari/i.test(ua) ? "Safari" : "Unknown";
+	const osName = /windows/i.test(ua) ? "Windows" : /mac os|macintosh/i.test(ua) ? "macOS" : /android/i.test(ua) ? "Android" : /iphone|ipad|ios/i.test(ua) ? "iOS" : /linux/i.test(ua) ? "Linux" : "Unknown";
+	return {
+		browserName,
+		deviceType: /mobile|iphone|android.*mobile/i.test(ua) ? "mobile" : /ipad|tablet/i.test(ua) ? "tablet" : "desktop",
+		osName
+	};
+}
+//#endregion
+exports.formatCHDateTime = formatCHDateTime;
+exports.parseUserAgent = parseUserAgent;
+
+//# sourceMappingURL=format.cjs.map

package/dist/instrumentations/replay/session-recording/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.cjs","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/format.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT).\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts\n */\n\n/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */\nexport function formatCHDateTime(date: Date): string {\n  const pad = (n: number, width = 2) => String(n).padStart(width, '0');\n  return (\n    `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ` +\n    `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}.` +\n    `${pad(date.getUTCMilliseconds(), 3)}`\n  );\n}\n\n/** Best-effort UA parse — enough to populate filterable session facets. */\nexport function parseUserAgent(ua: string): {\n  browserName: string;\n  deviceType: string;\n  osName: string;\n} {\n  const browserName = /edg/i.test(ua)\n    ? 'Edge'\n    : /opr|opera/i.test(ua)\n      ? 'Opera'\n      : /chrome|crios/i.test(ua)\n        ? 'Chrome'\n        : /firefox|fxios/i.test(ua)\n          ? 'Firefox'\n          : /safari/i.test(ua)\n            ? 'Safari'\n            : 'Unknown';\n  const osName = /windows/i.test(ua)\n    ? 'Windows'\n    : /mac os|macintosh/i.test(ua)\n      ? 'macOS'\n      : /android/i.test(ua)\n        ? 'Android'\n        : /iphone|ipad|ios/i.test(ua)\n          ? 'iOS'\n          : /linux/i.test(ua)\n            ? 'Linux'\n            : 'Unknown';\n  const deviceType = /mobile|iphone|android.*mobile/i.test(ua)\n    ? 'mobile'\n    : /ipad|tablet/i.test(ua)\n      ? 'tablet'\n      : 'desktop';\n  return { browserName, deviceType, osName };\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,iBAAiB,MAAoB;CACnD,MAAM,OAAO,GAAW,QAAQ,MAAM,OAAO,EAAE,CAAC,SAAS,OAAO,IAAI;AACpE,QACE,GAAG,KAAK,gBAAgB,CAAC,GAAG,IAAI,KAAK,aAAa,GAAG,EAAE,CAAC,GAAG,IAAI,KAAK,YAAY,CAAC,CAAC,GAC/E,IAAI,KAAK,aAAa,CAAC,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,CAAC,GAClF,IAAI,KAAK,oBAAoB,EAAE,EAAE;;;AAKxC,SAAgB,eAAe,IAI7B;CACA,MAAM,cAAc,OAAO,KAAK,GAAG,GAC/B,SACA,aAAa,KAAK,GAAG,GACnB,UACA,gBAAgB,KAAK,GAAG,GACtB,WACA,iBAAiB,KAAK,GAAG,GACvB,YACA,UAAU,KAAK,GAAG,GAChB,WACA;CACZ,MAAM,SAAS,WAAW,KAAK,GAAG,GAC9B,YACA,oBAAoB,KAAK,GAAG,GAC1B,UACA,WAAW,KAAK,GAAG,GACjB,YACA,mBAAmB,KAAK,GAAG,GACzB,QACA,SAAS,KAAK,GAAG,GACf,UACA;AAMZ,QAAO;EAAE;EAAa,YALH,iCAAiC,KAAK,GAAG,GACxD,WACA,eAAe,KAAK,GAAG,GACrB,WACA;EAC4B;EAAQ"}

package/dist/instrumentations/replay/session-recording/format.d.cts

@@ -0,0 +1,16 @@
+//#region src/instrumentations/replay/session-recording/format.d.ts
+/**
+ * Ported from Maple browser SDK (MIT).
+ * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts
+ */
+/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */
+declare function formatCHDateTime(date: Date): string;
+/** Best-effort UA parse — enough to populate filterable session facets. */
+declare function parseUserAgent(ua: string): {
+  browserName: string;
+  deviceType: string;
+  osName: string;
+};
+//#endregion
+export { formatCHDateTime, parseUserAgent };
+//# sourceMappingURL=format.d.cts.map

package/dist/instrumentations/replay/session-recording/format.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/format.ts"],"mappings":";;AAMA;;;;iBAAgB,gBAAA,CAAiB,IAAA,EAAM,IAAA;AAUvC;AAAA,iBAAgB,cAAA,CAAe,EAAA;EAC7B,WAAA;EACA,UAAA;EACA,MAAA;AAAA"}

package/dist/instrumentations/replay/session-recording/format.d.ts

@@ -0,0 +1,16 @@
+//#region src/instrumentations/replay/session-recording/format.d.ts
+/**
+ * Ported from Maple browser SDK (MIT).
+ * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts
+ */
+/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */
+declare function formatCHDateTime(date: Date): string;
+/** Best-effort UA parse — enough to populate filterable session facets. */
+declare function parseUserAgent(ua: string): {
+  browserName: string;
+  deviceType: string;
+  osName: string;
+};
+//#endregion
+export { formatCHDateTime, parseUserAgent };
+//# sourceMappingURL=format.d.ts.map

package/dist/instrumentations/replay/session-recording/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/format.ts"],"mappings":";;AAMA;;;;iBAAgB,gBAAA,CAAiB,IAAA,EAAM,IAAA;AAUvC;AAAA,iBAAgB,cAAA,CAAe,EAAA;EAC7B,WAAA;EACA,UAAA;EACA,MAAA;AAAA"}

package/dist/instrumentations/replay/session-recording/format.js

@@ -0,0 +1,24 @@
+//#region src/instrumentations/replay/session-recording/format.ts
+/**
+* Ported from Maple browser SDK (MIT).
+* @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts
+*/
+/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */
+function formatCHDateTime(date) {
+	const pad = (n, width = 2) => String(n).padStart(width, "0");
+	return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}.${pad(date.getUTCMilliseconds(), 3)}`;
+}
+/** Best-effort UA parse — enough to populate filterable session facets. */
+function parseUserAgent(ua) {
+	const browserName = /edg/i.test(ua) ? "Edge" : /opr|opera/i.test(ua) ? "Opera" : /chrome|crios/i.test(ua) ? "Chrome" : /firefox|fxios/i.test(ua) ? "Firefox" : /safari/i.test(ua) ? "Safari" : "Unknown";
+	const osName = /windows/i.test(ua) ? "Windows" : /mac os|macintosh/i.test(ua) ? "macOS" : /android/i.test(ua) ? "Android" : /iphone|ipad|ios/i.test(ua) ? "iOS" : /linux/i.test(ua) ? "Linux" : "Unknown";
+	return {
+		browserName,
+		deviceType: /mobile|iphone|android.*mobile/i.test(ua) ? "mobile" : /ipad|tablet/i.test(ua) ? "tablet" : "desktop",
+		osName
+	};
+}
+//#endregion
+export { formatCHDateTime, parseUserAgent };
+
+//# sourceMappingURL=format.js.map

package/dist/instrumentations/replay/session-recording/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":[],"sources":["../../../../src/instrumentations/replay/session-recording/format.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT).\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/config.ts\n */\n\n/** ClickHouse-style `YYYY-MM-DD HH:MM:SS.mmm` in UTC. */\nexport function formatCHDateTime(date: Date): string {\n  const pad = (n: number, width = 2) => String(n).padStart(width, '0');\n  return (\n    `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())} ` +\n    `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}.` +\n    `${pad(date.getUTCMilliseconds(), 3)}`\n  );\n}\n\n/** Best-effort UA parse — enough to populate filterable session facets. */\nexport function parseUserAgent(ua: string): {\n  browserName: string;\n  deviceType: string;\n  osName: string;\n} {\n  const browserName = /edg/i.test(ua)\n    ? 'Edge'\n    : /opr|opera/i.test(ua)\n      ? 'Opera'\n      : /chrome|crios/i.test(ua)\n        ? 'Chrome'\n        : /firefox|fxios/i.test(ua)\n          ? 'Firefox'\n          : /safari/i.test(ua)\n            ? 'Safari'\n            : 'Unknown';\n  const osName = /windows/i.test(ua)\n    ? 'Windows'\n    : /mac os|macintosh/i.test(ua)\n      ? 'macOS'\n      : /android/i.test(ua)\n        ? 'Android'\n        : /iphone|ipad|ios/i.test(ua)\n          ? 'iOS'\n          : /linux/i.test(ua)\n            ? 'Linux'\n            : 'Unknown';\n  const deviceType = /mobile|iphone|android.*mobile/i.test(ua)\n    ? 'mobile'\n    : /ipad|tablet/i.test(ua)\n      ? 'tablet'\n      : 'desktop';\n  return { browserName, deviceType, osName };\n}\n"],"mappings":";;;;;;AAMA,SAAgB,iBAAiB,MAAoB;CACnD,MAAM,OAAO,GAAW,QAAQ,MAAM,OAAO,EAAE,CAAC,SAAS,OAAO,IAAI;AACpE,QACE,GAAG,KAAK,gBAAgB,CAAC,GAAG,IAAI,KAAK,aAAa,GAAG,EAAE,CAAC,GAAG,IAAI,KAAK,YAAY,CAAC,CAAC,GAC/E,IAAI,KAAK,aAAa,CAAC,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,CAAC,GAAG,IAAI,KAAK,eAAe,CAAC,CAAC,GAClF,IAAI,KAAK,oBAAoB,EAAE,EAAE;;;AAKxC,SAAgB,eAAe,IAI7B;CACA,MAAM,cAAc,OAAO,KAAK,GAAG,GAC/B,SACA,aAAa,KAAK,GAAG,GACnB,UACA,gBAAgB,KAAK,GAAG,GACtB,WACA,iBAAiB,KAAK,GAAG,GACvB,YACA,UAAU,KAAK,GAAG,GAChB,WACA;CACZ,MAAM,SAAS,WAAW,KAAK,GAAG,GAC9B,YACA,oBAAoB,KAAK,GAAG,GAC1B,UACA,WAAW,KAAK,GAAG,GACjB,YACA,mBAAmB,KAAK,GAAG,GACzB,QACA,SAAS,KAAK,GAAG,GACf,UACA;AAMZ,QAAO;EAAE;EAAa,YALH,iCAAiC,KAAK,GAAG,GACxD,WACA,eAAe,KAAK,GAAG,GACrB,WACA;EAC4B;EAAQ"}

package/dist/instrumentations/replay/session-recording/lifecycle.cjs

@@ -0,0 +1,72 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_api_users_userAPI = require("../../../api-users/userAPI.cjs");
+const require_instrumentations_replay_session_recording_format = require("./format.cjs");
+const require_instrumentations_replay_trace_sink_traceSink = require("../trace-sink/traceSink.cjs");
+//#region src/instrumentations/replay/session-recording/lifecycle.ts
+function installReplayLifecycleHandlers(args) {
+	let finalized = false;
+	const finalize = () => {
+		if (finalized) return;
+		finalized = true;
+		args.recorder.flush(true);
+		args.events.flush(true);
+		args.transport.postSessionMeta(sessionMetaRow(args.config, args.sessionId, args.startedAt, 2, "ended", args.recorder.getClickCount()), true);
+		args.recorder.stop();
+		args.events.stop();
+		require_instrumentations_replay_trace_sink_traceSink.clearObservedTraceIds();
+		args.onFinalize?.();
+	};
+	const onVisibilityChange = () => {
+		if (document.visibilityState === "hidden") finalize();
+	};
+	document.addEventListener("visibilitychange", onVisibilityChange);
+	window.addEventListener("pagehide", finalize);
+	return () => {
+		document.removeEventListener("visibilitychange", onVisibilityChange);
+		window.removeEventListener("pagehide", finalize);
+	};
+}
+function sessionMetaRow(config, sessionId, startedAt, version, status, clickCount) {
+	const ua = require_instrumentations_replay_session_recording_format.parseUserAgent(navigator.userAgent);
+	const now = /* @__PURE__ */ new Date();
+	const row = {
+		browser_name: ua.browserName,
+		device_type: ua.deviceType,
+		os_name: ua.osName,
+		resource_attributes: {
+			...config.environment ? {
+				"deployment.environment": config.environment,
+				"deployment.environment.name": config.environment
+			} : {},
+			...config.appVersion ? { "deployment.commit_sha": config.appVersion } : {}
+		},
+		service_name: config.serviceName ?? "",
+		session_id: sessionId,
+		start_time: require_instrumentations_replay_session_recording_format.formatCHDateTime(startedAt),
+		status,
+		url_initial: window.location.href,
+		user_agent: navigator.userAgent,
+		user_id: resolveExternalUserId(),
+		version
+	};
+	if (status === "ended") {
+		row.click_count = clickCount ?? 0;
+		row.duration_ms = Math.max(0, now.getTime() - startedAt.getTime());
+		row.end_time = require_instrumentations_replay_session_recording_format.formatCHDateTime(now);
+		row.trace_ids = require_instrumentations_replay_trace_sink_traceSink.getObservedTraceIds();
+	}
+	return row;
+}
+function getSessionStartedAt(userSessionManager) {
+	const startTime = userSessionManager.getUserSessionStartTime();
+	return new Date(startTime ?? Date.now());
+}
+function resolveExternalUserId() {
+	return require_api_users_userAPI.user.getUserId() ?? "";
+}
+//#endregion
+exports.getSessionStartedAt = getSessionStartedAt;
+exports.installReplayLifecycleHandlers = installReplayLifecycleHandlers;
+exports.sessionMetaRow = sessionMetaRow;
+
+//# sourceMappingURL=lifecycle.cjs.map

package/dist/instrumentations/replay/session-recording/lifecycle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.cjs","names":["parseUserAgent","formatCHDateTime","getObservedTraceIds","user"],"sources":["../../../../src/instrumentations/replay/session-recording/lifecycle.ts"],"sourcesContent":["import type { UserSessionManagerInternal } from '../../../managers/MXLUserSessionManager/types';\nimport { user } from '../../../api-users/userAPI';\nimport type { EventCapture } from '../events/startEventCapture';\nimport type { Recorder } from '../recorder/types';\nimport type { ResolvedReplayConfig } from './config';\nimport { formatCHDateTime, parseUserAgent } from './format';\nimport type { ReplayTransport } from '../transport/types';\nimport {\n  clearObservedTraceIds,\n  getObservedTraceIds,\n} from '../trace-sink/traceSink';\n\nexport function installReplayLifecycleHandlers(args: {\n  config: ResolvedReplayConfig;\n  sessionId: string;\n  startedAt: Date;\n  transport: ReplayTransport;\n  recorder: Recorder;\n  events: EventCapture;\n  onFinalize?: () => void;\n}): () => void {\n  let finalized = false;\n\n  const finalize = () => {\n    if (finalized) {\n      return;\n    }\n    finalized = true;\n\n    void args.recorder.flush(true);\n    void args.events.flush(true);\n    void args.transport.postSessionMeta(\n      sessionMetaRow(\n        args.config,\n        args.sessionId,\n        args.startedAt,\n        2,\n        'ended',\n        args.recorder.getClickCount(),\n      ),\n      true,\n    );\n    args.recorder.stop();\n    args.events.stop();\n    clearObservedTraceIds();\n    args.onFinalize?.();\n  };\n\n  const onVisibilityChange = () => {\n    if (document.visibilityState === 'hidden') {\n      finalize();\n    }\n  };\n\n  document.addEventListener('visibilitychange', onVisibilityChange);\n  window.addEventListener('pagehide', finalize);\n\n  return () => {\n    document.removeEventListener('visibilitychange', onVisibilityChange);\n    window.removeEventListener('pagehide', finalize);\n  };\n}\n\nexport function sessionMetaRow(\n  config: ResolvedReplayConfig,\n  sessionId: string,\n  startedAt: Date,\n  version: number,\n  status: 'active' | 'ended',\n  clickCount: number | null,\n): Record<string, unknown> {\n  const ua = parseUserAgent(navigator.userAgent);\n  const now = new Date();\n  const row: Record<string, unknown> = {\n    browser_name: ua.browserName,\n    device_type: ua.deviceType,\n    os_name: ua.osName,\n    resource_attributes: {\n      ...(config.environment\n        ? {\n            'deployment.environment': config.environment,\n            'deployment.environment.name': config.environment,\n          }\n        : {}),\n      ...(config.appVersion\n        ? { 'deployment.commit_sha': config.appVersion }\n        : {}),\n    },\n    service_name: config.serviceName ?? '',\n    session_id: sessionId,\n    start_time: formatCHDateTime(startedAt),\n    status,\n    url_initial: window.location.href,\n    user_agent: navigator.userAgent,\n    user_id: resolveExternalUserId(),\n    version,\n  };\n\n  if (status === 'ended') {\n    row.click_count = clickCount ?? 0;\n    row.duration_ms = Math.max(0, now.getTime() - startedAt.getTime());\n    row.end_time = formatCHDateTime(now);\n    row.trace_ids = getObservedTraceIds();\n  }\n\n  return row;\n}\n\nexport function getSessionStartedAt(\n  userSessionManager: UserSessionManagerInternal,\n): Date {\n  const startTime = userSessionManager.getUserSessionStartTime();\n  return new Date(startTime ?? Date.now());\n}\n\nfunction resolveExternalUserId(): string {\n  return user.getUserId() ?? '';\n}\n"],"mappings":";;;;;AAYA,SAAgB,+BAA+B,MAQhC;CACb,IAAI,YAAY;CAEhB,MAAM,iBAAiB;AACrB,MAAI,UACF;AAEF,cAAY;AAEP,OAAK,SAAS,MAAM,KAAK;AACzB,OAAK,OAAO,MAAM,KAAK;AACvB,OAAK,UAAU,gBAClB,eACE,KAAK,QACL,KAAK,WACL,KAAK,WACL,GACA,SACA,KAAK,SAAS,eAAe,CAC9B,EACD,KACD;AACD,OAAK,SAAS,MAAM;AACpB,OAAK,OAAO,MAAM;AAClB,uDAAA,uBAAuB;AACvB,OAAK,cAAc;;CAGrB,MAAM,2BAA2B;AAC/B,MAAI,SAAS,oBAAoB,SAC/B,WAAU;;AAId,UAAS,iBAAiB,oBAAoB,mBAAmB;AACjE,QAAO,iBAAiB,YAAY,SAAS;AAE7C,cAAa;AACX,WAAS,oBAAoB,oBAAoB,mBAAmB;AACpE,SAAO,oBAAoB,YAAY,SAAS;;;AAIpD,SAAgB,eACd,QACA,WACA,WACA,SACA,QACA,YACyB;CACzB,MAAM,KAAKA,yDAAAA,eAAe,UAAU,UAAU;CAC9C,MAAM,sBAAM,IAAI,MAAM;CACtB,MAAM,MAA+B;EACnC,cAAc,GAAG;EACjB,aAAa,GAAG;EAChB,SAAS,GAAG;EACZ,qBAAqB;GACnB,GAAI,OAAO,cACP;IACE,0BAA0B,OAAO;IACjC,+BAA+B,OAAO;IACvC,GACD,EAAE;GACN,GAAI,OAAO,aACP,EAAE,yBAAyB,OAAO,YAAY,GAC9C,EAAE;GACP;EACD,cAAc,OAAO,eAAe;EACpC,YAAY;EACZ,YAAYC,yDAAAA,iBAAiB,UAAU;EACvC;EACA,aAAa,OAAO,SAAS;EAC7B,YAAY,UAAU;EACtB,SAAS,uBAAuB;EAChC;EACD;AAED,KAAI,WAAW,SAAS;AACtB,MAAI,cAAc,cAAc;AAChC,MAAI,cAAc,KAAK,IAAI,GAAG,IAAI,SAAS,GAAG,UAAU,SAAS,CAAC;AAClE,MAAI,WAAWA,yDAAAA,iBAAiB,IAAI;AACpC,MAAI,YAAYC,qDAAAA,qBAAqB;;AAGvC,QAAO;;AAGT,SAAgB,oBACd,oBACM;CACN,MAAM,YAAY,mBAAmB,yBAAyB;AAC9D,QAAO,IAAI,KAAK,aAAa,KAAK,KAAK,CAAC;;AAG1C,SAAS,wBAAgC;AACvC,QAAOC,0BAAAA,KAAK,WAAW,IAAI"}

package/dist/instrumentations/replay/session-recording/lifecycle.d.cts

@@ -0,0 +1,21 @@
+import { UserSessionManagerInternal } from "../../../managers/MXLUserSessionManager/types.cjs";
+import { ReplayTransport } from "../transport/types.cjs";
+import { ResolvedReplayConfig } from "./config.cjs";
+import { EventCapture } from "../events/startEventCapture.cjs";
+import { Recorder } from "../recorder/types.cjs";
+
+//#region src/instrumentations/replay/session-recording/lifecycle.d.ts
+declare function installReplayLifecycleHandlers(args: {
+  config: ResolvedReplayConfig;
+  sessionId: string;
+  startedAt: Date;
+  transport: ReplayTransport;
+  recorder: Recorder;
+  events: EventCapture;
+  onFinalize?: () => void;
+}): () => void;
+declare function sessionMetaRow(config: ResolvedReplayConfig, sessionId: string, startedAt: Date, version: number, status: 'active' | 'ended', clickCount: number | null): Record<string, unknown>;
+declare function getSessionStartedAt(userSessionManager: UserSessionManagerInternal): Date;
+//#endregion
+export { getSessionStartedAt, installReplayLifecycleHandlers, sessionMetaRow };
+//# sourceMappingURL=lifecycle.d.cts.map