@safaricom-mxl/web-sdk 0.0.20 → 0.0.21

package/DATA_EXPORT.md

@@ -22,11 +22,12 @@ failures following an exponential backoff. See [FetchTransport](./src/transport/
 
 ## Session replay
 
-When `recordUserSessions` is enabled (default) and the SDK sends data to MXL, session replay uses **three dedicated HTTP ingest paths** (gzip NDJSON or octet-stream), separate from OTLP spans and logs:
+When `recordUserSessions` is enabled (default) and the SDK sends data to MXL, session replay uses **dedicated HTTP ingest paths** (gzip NDJSON or octet-stream), separate from OTLP spans and logs. All replay ingest requests include the `mxl-client-id` header set to the init `appID`.
 
 
 | Endpoint                    | Payload                                                                                                  |
 | --------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `POST /replay`              | Session registration at session start when `apiKey` is configured (`mxl-api-key` header, body `null`)   |
 | `POST /sessionReplays/meta` | Session metadata (`active` on start, `ended` on finalize with `trace_ids`, `click_count`, `duration_ms`) |
 | `POST /sessionReplays/blob` | Gzip-compressed rrweb event chunks (`x-mxl-session-id`, `x-mxl-chunk-seq`, `x-mxl-is-checkpoint`, …)     |
 | `POST /sessionEvents`       | Distilled timeline events (console, network, errors, navigation, interactions)                           |

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

@@ -136,6 +136,7 @@ var SessionRecording = class {
 				sessionId,
 				transport: this._context.transport
 			});
+			this._context.transport.postReplay();
 			this._context.transport.postSessionMeta(require_instrumentations_replay_session_recording_lifecycle.sessionMetaRow(this._config, sessionId, startedAt, 1, "active", null));
 			const removeLifecycle = globalThis.__MXL_TEST_SKIP_REPLAY_LIFECYCLE__ === true ? () => void 0 : require_instrumentations_replay_session_recording_lifecycle.installReplayLifecycleHandlers({
 				config: this._config,

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

@@ -1 +1 @@
-{"version":3,"file":"SessionRecording.cjs","names":["createChunkSeqStore","resolveReplayConfig","loadRrwebModule","getSessionStartedAt","startRecording","startEventCapture","sessionMetaRow","installReplayLifecycleHandlers"],"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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"}
+{"version":3,"file":"SessionRecording.cjs","names":["createChunkSeqStore","resolveReplayConfig","loadRrwebModule","getSessionStartedAt","startRecording","startEventCapture","sessionMetaRow","installReplayLifecycleHandlers"],"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.postReplay();\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/SessionRecording.js

@@ -135,6 +135,7 @@ var SessionRecording = class {
 				sessionId,
 				transport: this._context.transport
 			});
+			this._context.transport.postReplay();
 			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,

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

@@ -1 +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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"}
+{"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.postReplay();\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/transport/replayTransport.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_instrumentations_replay_transport_gzip = require("./gzip.cjs");
-const require_exporters_utils = require("../../../exporters/utils.cjs");
 const require_managers_MXLConfigManager_utils = require("../../../managers/MXLConfigManager/utils.cjs");
 //#region src/instrumentations/replay/transport/replayTransport.ts
 /**
 * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.
 * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts
 */
+const getReplayHeaders = (appID) => ({ "mxl-client-id": appID });
 let lastWarnAt = 0;
 function warnDropped(what, error) {
 	const now = Date.now();
@@ -15,16 +15,32 @@ function warnDropped(what, error) {
 	console.warn(`[mxl] session replay ${what} failed (dropping; will retry on next chunk):`, error);
 }
 function createReplayTransport(config) {
-	const headers = require_exporters_utils.getMXLHeaders(config.appID, config.userID);
+	const headers = getReplayHeaders(config.appID);
 	const baseUrl = config.baseUrl.replace(/\/$/, "");
 	const otelCollectorURL = config.otelCollectorURL.replace(/\/$/, "");
 	const ignoredPathPrefixes = [
 		`${baseUrl}/sessionReplays/`,
 		`${baseUrl}/sessionEvents`,
+		`${baseUrl}/replay`,
 		`${otelCollectorURL}/v1/logs`,
 		`${otelCollectorURL}/v1/traces`
 	];
 	const shouldIgnoreUrl = (url) => ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));
+	const postReplay = async (keepalive = false) => {
+		if (!config.apiKey) return;
+		await fetch(`${baseUrl}/replay`, {
+			body: "null",
+			headers: {
+				...headers,
+				"content-type": "application/json",
+				"mxl-api-key": config.apiKey
+			},
+			keepalive,
+			method: "POST"
+		}).catch((error) => {
+			warnDropped("replay POST", error);
+		});
+	};
 	const postSessionMeta = async (row, keepalive = false) => {
 		const body = `${JSON.stringify(row)}\n`;
 		await fetch(`${baseUrl}/sessionReplays/meta`, {
@@ -73,6 +89,7 @@ function createReplayTransport(config) {
 		});
 	};
 	return {
+		postReplay,
 		postSessionBlob,
 		postSessionEvents,
 		postSessionMeta,
@@ -81,10 +98,10 @@ function createReplayTransport(config) {
 }
 function createReplayTransportFromInit(args) {
 	return createReplayTransport({
+		apiKey: args.apiKey,
 		appID: args.appID,
 		baseUrl: require_managers_MXLConfigManager_utils.getApiURL(args.apiURL),
-		otelCollectorURL: require_managers_MXLConfigManager_utils.getOtelCollectorURL(args.otelCollectorURL),
-		userID: args.userID
+		otelCollectorURL: require_managers_MXLConfigManager_utils.getOtelCollectorURL(args.otelCollectorURL)
 	});
 }
 //#endregion

package/dist/instrumentations/replay/transport/replayTransport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"replayTransport.cjs","names":["getMXLHeaders","getApiURL","getOtelCollectorURL"],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts\n */\n\nimport { getMXLHeaders } from '../../../exporters/utils';\nimport {\n  getApiURL,\n  getOtelCollectorURL\n} from '../../../managers/MXLConfigManager/utils';\nimport { gzip } from './gzip';\nimport type { ChunkMeta, ReplayTransport, ReplayTransportConfig } from './types';\n\nexport { gzip };\n\nlet lastWarnAt = 0;\n\nfunction warnDropped(what: string, error: unknown): void {\n  const now = Date.now();\n  if (now - lastWarnAt < 30_000) {\n    return;\n  }\n  lastWarnAt = now;\n  // oxlint-disable-next-line no-console -- best-effort replay diagnostics\n  console.warn(\n    `[mxl] session replay ${what} failed (dropping; will retry on next chunk):`,\n    error,\n  );\n}\n\nexport function createReplayTransport(\n  config: ReplayTransportConfig,\n): ReplayTransport {\n  const headers = getMXLHeaders(config.appID, config.userID);\n  const baseUrl = config.baseUrl.replace(/\\/$/, '');\n  const otelCollectorURL = config.otelCollectorURL.replace(/\\/$/, '');\n\n  const ignoredPathPrefixes = [\n    `${baseUrl}/sessionReplays/`,\n    `${baseUrl}/sessionEvents`,\n    `${otelCollectorURL}/v1/logs`,\n    `${otelCollectorURL}/v1/traces`,\n  ];\n\n  const shouldIgnoreUrl = (url: string): boolean =>\n    ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));\n\n  const postSessionMeta = async (\n    row: Record<string, unknown>,\n    keepalive = false,\n  ): Promise<void> => {\n    const body = `${JSON.stringify(row)}\\n`;\n    await fetch(`${baseUrl}/sessionReplays/meta`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('metadata POST', error);\n    });\n  };\n\n  const postSessionEvents = async (\n    rows: ReadonlyArray<Record<string, unknown>>,\n    keepalive = false,\n  ): Promise<void> => {\n    if (rows.length === 0) {\n      return;\n    }\n    const body = `${rows.map((row) => JSON.stringify(row)).join('\\n')}\\n`;\n    await fetch(`${baseUrl}/sessionEvents`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('events POST', error);\n    });\n  };\n\n  const postSessionBlob = async (\n    meta: ChunkMeta,\n    gzipped: Uint8Array,\n    keepalive = false,\n  ): Promise<void> => {\n    await fetch(`${baseUrl}/sessionReplays/blob`, {\n      body: gzipped as unknown as BodyInit,\n      headers: {\n        ...headers,\n        'content-type': 'application/octet-stream',\n        'x-mxl-chunk-seq': String(meta.chunkSeq),\n        'x-mxl-duration-ms': String(meta.durationMs),\n        'x-mxl-event-count': String(meta.eventCount),\n        'x-mxl-is-checkpoint': meta.isCheckpoint ? '1' : '0',\n        'x-mxl-session-id': meta.sessionId,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('blob POST', error);\n    });\n  };\n\n  return {\n    postSessionBlob,\n    postSessionEvents,\n    postSessionMeta,\n    shouldIgnoreUrl,\n  };\n}\n\nexport function createReplayTransportFromInit(args: {\n  appID: string;\n  userID: string;\n  apiURL?: string;\n  otelCollectorURL?: string;\n}): ReplayTransport {\n  return createReplayTransport({\n    appID: args.appID,\n    baseUrl: getApiURL(args.apiURL),\n    otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL),\n    userID: args.userID,\n  });\n}\n"],"mappings":";;;;;;;;;AAeA,IAAI,aAAa;AAEjB,SAAS,YAAY,MAAc,OAAsB;CACvD,MAAM,MAAM,KAAK,KAAK;AACtB,KAAI,MAAM,aAAa,IACrB;AAEF,cAAa;AAEb,SAAQ,KACN,wBAAwB,KAAK,gDAC7B,MACD;;AAGH,SAAgB,sBACd,QACiB;CACjB,MAAM,UAAUA,wBAAAA,cAAc,OAAO,OAAO,OAAO,OAAO;CAC1D,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;CACjD,MAAM,mBAAmB,OAAO,iBAAiB,QAAQ,OAAO,GAAG;CAEnE,MAAM,sBAAsB;EAC1B,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,iBAAiB;EACpB,GAAG,iBAAiB;EACrB;CAED,MAAM,mBAAmB,QACvB,oBAAoB,MAAM,WAAW,IAAI,WAAW,OAAO,CAAC;CAE9D,MAAM,kBAAkB,OACtB,KACA,YAAY,UACM;EAClB,MAAM,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC;AACpC,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,iBAAiB,MAAM;IACnC;;CAGJ,MAAM,oBAAoB,OACxB,MACA,YAAY,UACM;AAClB,MAAI,KAAK,WAAW,EAClB;EAEF,MAAM,OAAO,GAAG,KAAK,KAAK,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;AAClE,QAAM,MAAM,GAAG,QAAQ,iBAAiB;GACtC;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,MACA,SACA,YAAY,UACM;AAClB,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,mBAAmB,OAAO,KAAK,SAAS;IACxC,qBAAqB,OAAO,KAAK,WAAW;IAC5C,qBAAqB,OAAO,KAAK,WAAW;IAC5C,uBAAuB,KAAK,eAAe,MAAM;IACjD,oBAAoB,KAAK;IAC1B;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,aAAa,MAAM;IAC/B;;AAGJ,QAAO;EACL;EACA;EACA;EACA;EACD;;AAGH,SAAgB,8BAA8B,MAK1B;AAClB,QAAO,sBAAsB;EAC3B,OAAO,KAAK;EACZ,SAASC,wCAAAA,UAAU,KAAK,OAAO;EAC/B,kBAAkBC,wCAAAA,oBAAoB,KAAK,iBAAiB;EAC5D,QAAQ,KAAK;EACd,CAAC"}
+{"version":3,"file":"replayTransport.cjs","names":["getApiURL","getOtelCollectorURL"],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts\n */\n\nimport {\n  getApiURL,\n  getOtelCollectorURL,\n} from '../../../managers/MXLConfigManager/utils';\nimport { gzip } from './gzip';\nimport type { ChunkMeta, ReplayTransport, ReplayTransportConfig } from './types';\n\nexport { gzip };\n\nconst getReplayHeaders = (appID: string): Record<string, string> => ({\n  'mxl-client-id': appID,\n});\n\nlet lastWarnAt = 0;\n\nfunction warnDropped(what: string, error: unknown): void {\n  const now = Date.now();\n  if (now - lastWarnAt < 30_000) {\n    return;\n  }\n  lastWarnAt = now;\n  // oxlint-disable-next-line no-console -- best-effort replay diagnostics\n  console.warn(\n    `[mxl] session replay ${what} failed (dropping; will retry on next chunk):`,\n    error,\n  );\n}\n\nexport function createReplayTransport(\n  config: ReplayTransportConfig,\n): ReplayTransport {\n  const headers = getReplayHeaders(config.appID);\n  const baseUrl = config.baseUrl.replace(/\\/$/, '');\n  const otelCollectorURL = config.otelCollectorURL.replace(/\\/$/, '');\n\n  const ignoredPathPrefixes = [\n    `${baseUrl}/sessionReplays/`,\n    `${baseUrl}/sessionEvents`,\n    `${baseUrl}/replay`,\n    `${otelCollectorURL}/v1/logs`,\n    `${otelCollectorURL}/v1/traces`,\n  ];\n\n  const shouldIgnoreUrl = (url: string): boolean =>\n    ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));\n\n  const postReplay = async (keepalive = false): Promise<void> => {\n    if (!config.apiKey) {\n      return;\n    }\n    await fetch(`${baseUrl}/replay`, {\n      body: 'null',\n      headers: {\n        ...headers,\n        'content-type': 'application/json',\n        'mxl-api-key': config.apiKey,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('replay POST', error);\n    });\n  };\n\n  const postSessionMeta = async (\n    row: Record<string, unknown>,\n    keepalive = false,\n  ): Promise<void> => {\n    const body = `${JSON.stringify(row)}\\n`;\n    await fetch(`${baseUrl}/sessionReplays/meta`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('metadata POST', error);\n    });\n  };\n\n  const postSessionEvents = async (\n    rows: ReadonlyArray<Record<string, unknown>>,\n    keepalive = false,\n  ): Promise<void> => {\n    if (rows.length === 0) {\n      return;\n    }\n    const body = `${rows.map((row) => JSON.stringify(row)).join('\\n')}\\n`;\n    await fetch(`${baseUrl}/sessionEvents`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('events POST', error);\n    });\n  };\n\n  const postSessionBlob = async (\n    meta: ChunkMeta,\n    gzipped: Uint8Array,\n    keepalive = false,\n  ): Promise<void> => {\n    await fetch(`${baseUrl}/sessionReplays/blob`, {\n      body: gzipped as unknown as BodyInit,\n      headers: {\n        ...headers,\n        'content-type': 'application/octet-stream',\n        'x-mxl-chunk-seq': String(meta.chunkSeq),\n        'x-mxl-duration-ms': String(meta.durationMs),\n        'x-mxl-event-count': String(meta.eventCount),\n        'x-mxl-is-checkpoint': meta.isCheckpoint ? '1' : '0',\n        'x-mxl-session-id': meta.sessionId,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('blob POST', error);\n    });\n  };\n\n  return {\n    postReplay,\n    postSessionBlob,\n    postSessionEvents,\n    postSessionMeta,\n    shouldIgnoreUrl,\n  };\n}\n\nexport function createReplayTransportFromInit(args: {\n  appID: string;\n  apiKey?: string;\n  apiURL?: string;\n  otelCollectorURL?: string;\n}): ReplayTransport {\n  return createReplayTransport({\n    apiKey: args.apiKey,\n    appID: args.appID,\n    baseUrl: getApiURL(args.apiURL),\n    otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL),\n  });\n}\n"],"mappings":";;;;;;;;AAcA,MAAM,oBAAoB,WAA2C,EACnE,iBAAiB,OAClB;AAED,IAAI,aAAa;AAEjB,SAAS,YAAY,MAAc,OAAsB;CACvD,MAAM,MAAM,KAAK,KAAK;AACtB,KAAI,MAAM,aAAa,IACrB;AAEF,cAAa;AAEb,SAAQ,KACN,wBAAwB,KAAK,gDAC7B,MACD;;AAGH,SAAgB,sBACd,QACiB;CACjB,MAAM,UAAU,iBAAiB,OAAO,MAAM;CAC9C,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;CACjD,MAAM,mBAAmB,OAAO,iBAAiB,QAAQ,OAAO,GAAG;CAEnE,MAAM,sBAAsB;EAC1B,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,iBAAiB;EACpB,GAAG,iBAAiB;EACrB;CAED,MAAM,mBAAmB,QACvB,oBAAoB,MAAM,WAAW,IAAI,WAAW,OAAO,CAAC;CAE9D,MAAM,aAAa,OAAO,YAAY,UAAyB;AAC7D,MAAI,CAAC,OAAO,OACV;AAEF,QAAM,MAAM,GAAG,QAAQ,UAAU;GAC/B,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,eAAe,OAAO;IACvB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,KACA,YAAY,UACM;EAClB,MAAM,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC;AACpC,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,iBAAiB,MAAM;IACnC;;CAGJ,MAAM,oBAAoB,OACxB,MACA,YAAY,UACM;AAClB,MAAI,KAAK,WAAW,EAClB;EAEF,MAAM,OAAO,GAAG,KAAK,KAAK,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;AAClE,QAAM,MAAM,GAAG,QAAQ,iBAAiB;GACtC;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,MACA,SACA,YAAY,UACM;AAClB,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,mBAAmB,OAAO,KAAK,SAAS;IACxC,qBAAqB,OAAO,KAAK,WAAW;IAC5C,qBAAqB,OAAO,KAAK,WAAW;IAC5C,uBAAuB,KAAK,eAAe,MAAM;IACjD,oBAAoB,KAAK;IAC1B;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,aAAa,MAAM;IAC/B;;AAGJ,QAAO;EACL;EACA;EACA;EACA;EACA;EACD;;AAGH,SAAgB,8BAA8B,MAK1B;AAClB,QAAO,sBAAsB;EAC3B,QAAQ,KAAK;EACb,OAAO,KAAK;EACZ,SAASA,wCAAAA,UAAU,KAAK,OAAO;EAC/B,kBAAkBC,wCAAAA,oBAAoB,KAAK,iBAAiB;EAC7D,CAAC"}

package/dist/instrumentations/replay/transport/replayTransport.d.cts

@@ -5,7 +5,7 @@ import { gzip } from "./gzip.cjs";
 declare function createReplayTransport(config: ReplayTransportConfig): ReplayTransport;
 declare function createReplayTransportFromInit(args: {
   appID: string;
-  userID: string;
+  apiKey?: string;
   apiURL?: string;
   otelCollectorURL?: string;
 }): ReplayTransport;

package/dist/instrumentations/replay/transport/replayTransport.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"replayTransport.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"mappings":";;;;iBA8BgB,qBAAA,CACd,MAAA,EAAQ,qBAAA,GACP,eAAA;AAAA,iBAqFa,6BAAA,CAA8B,IAAA;EAC5C,KAAA;EACA,MAAA;EACA,MAAA;EACA,gBAAA;AAAA,IACE,eAAA"}
+{"version":3,"file":"replayTransport.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"mappings":";;;;iBAiCgB,qBAAA,CACd,MAAA,EAAQ,qBAAA,GACP,eAAA;AAAA,iBAyGa,6BAAA,CAA8B,IAAA;EAC5C,KAAA;EACA,MAAA;EACA,MAAA;EACA,gBAAA;AAAA,IACE,eAAA"}

package/dist/instrumentations/replay/transport/replayTransport.d.ts

@@ -5,7 +5,7 @@ import { gzip } from "./gzip.js";
 declare function createReplayTransport(config: ReplayTransportConfig): ReplayTransport;
 declare function createReplayTransportFromInit(args: {
   appID: string;
-  userID: string;
+  apiKey?: string;
   apiURL?: string;
   otelCollectorURL?: string;
 }): ReplayTransport;

package/dist/instrumentations/replay/transport/replayTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replayTransport.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"mappings":";;;;iBA8BgB,qBAAA,CACd,MAAA,EAAQ,qBAAA,GACP,eAAA;AAAA,iBAqFa,6BAAA,CAA8B,IAAA;EAC5C,KAAA;EACA,MAAA;EACA,MAAA;EACA,gBAAA;AAAA,IACE,eAAA"}
+{"version":3,"file":"replayTransport.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"mappings":";;;;iBAiCgB,qBAAA,CACd,MAAA,EAAQ,qBAAA,GACP,eAAA;AAAA,iBAyGa,6BAAA,CAA8B,IAAA;EAC5C,KAAA;EACA,MAAA;EACA,MAAA;EACA,gBAAA;AAAA,IACE,eAAA"}

package/dist/instrumentations/replay/transport/replayTransport.js

@@ -1,11 +1,11 @@
 import { gzip } from "./gzip.js";
-import { getMXLHeaders } from "../../../exporters/utils.js";
 import { getApiURL, getOtelCollectorURL } from "../../../managers/MXLConfigManager/utils.js";
 //#region src/instrumentations/replay/transport/replayTransport.ts
 /**
 * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.
 * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts
 */
+const getReplayHeaders = (appID) => ({ "mxl-client-id": appID });
 let lastWarnAt = 0;
 function warnDropped(what, error) {
 	const now = Date.now();
@@ -14,16 +14,32 @@ function warnDropped(what, error) {
 	console.warn(`[mxl] session replay ${what} failed (dropping; will retry on next chunk):`, error);
 }
 function createReplayTransport(config) {
-	const headers = getMXLHeaders(config.appID, config.userID);
+	const headers = getReplayHeaders(config.appID);
 	const baseUrl = config.baseUrl.replace(/\/$/, "");
 	const otelCollectorURL = config.otelCollectorURL.replace(/\/$/, "");
 	const ignoredPathPrefixes = [
 		`${baseUrl}/sessionReplays/`,
 		`${baseUrl}/sessionEvents`,
+		`${baseUrl}/replay`,
 		`${otelCollectorURL}/v1/logs`,
 		`${otelCollectorURL}/v1/traces`
 	];
 	const shouldIgnoreUrl = (url) => ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));
+	const postReplay = async (keepalive = false) => {
+		if (!config.apiKey) return;
+		await fetch(`${baseUrl}/replay`, {
+			body: "null",
+			headers: {
+				...headers,
+				"content-type": "application/json",
+				"mxl-api-key": config.apiKey
+			},
+			keepalive,
+			method: "POST"
+		}).catch((error) => {
+			warnDropped("replay POST", error);
+		});
+	};
 	const postSessionMeta = async (row, keepalive = false) => {
 		const body = `${JSON.stringify(row)}\n`;
 		await fetch(`${baseUrl}/sessionReplays/meta`, {
@@ -72,6 +88,7 @@ function createReplayTransport(config) {
 		});
 	};
 	return {
+		postReplay,
 		postSessionBlob,
 		postSessionEvents,
 		postSessionMeta,
@@ -80,10 +97,10 @@ function createReplayTransport(config) {
 }
 function createReplayTransportFromInit(args) {
 	return createReplayTransport({
+		apiKey: args.apiKey,
 		appID: args.appID,
 		baseUrl: getApiURL(args.apiURL),
-		otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL),
-		userID: args.userID
+		otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL)
 	});
 }
 //#endregion

package/dist/instrumentations/replay/transport/replayTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"replayTransport.js","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts\n */\n\nimport { getMXLHeaders } from '../../../exporters/utils';\nimport {\n  getApiURL,\n  getOtelCollectorURL\n} from '../../../managers/MXLConfigManager/utils';\nimport { gzip } from './gzip';\nimport type { ChunkMeta, ReplayTransport, ReplayTransportConfig } from './types';\n\nexport { gzip };\n\nlet lastWarnAt = 0;\n\nfunction warnDropped(what: string, error: unknown): void {\n  const now = Date.now();\n  if (now - lastWarnAt < 30_000) {\n    return;\n  }\n  lastWarnAt = now;\n  // oxlint-disable-next-line no-console -- best-effort replay diagnostics\n  console.warn(\n    `[mxl] session replay ${what} failed (dropping; will retry on next chunk):`,\n    error,\n  );\n}\n\nexport function createReplayTransport(\n  config: ReplayTransportConfig,\n): ReplayTransport {\n  const headers = getMXLHeaders(config.appID, config.userID);\n  const baseUrl = config.baseUrl.replace(/\\/$/, '');\n  const otelCollectorURL = config.otelCollectorURL.replace(/\\/$/, '');\n\n  const ignoredPathPrefixes = [\n    `${baseUrl}/sessionReplays/`,\n    `${baseUrl}/sessionEvents`,\n    `${otelCollectorURL}/v1/logs`,\n    `${otelCollectorURL}/v1/traces`,\n  ];\n\n  const shouldIgnoreUrl = (url: string): boolean =>\n    ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));\n\n  const postSessionMeta = async (\n    row: Record<string, unknown>,\n    keepalive = false,\n  ): Promise<void> => {\n    const body = `${JSON.stringify(row)}\\n`;\n    await fetch(`${baseUrl}/sessionReplays/meta`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('metadata POST', error);\n    });\n  };\n\n  const postSessionEvents = async (\n    rows: ReadonlyArray<Record<string, unknown>>,\n    keepalive = false,\n  ): Promise<void> => {\n    if (rows.length === 0) {\n      return;\n    }\n    const body = `${rows.map((row) => JSON.stringify(row)).join('\\n')}\\n`;\n    await fetch(`${baseUrl}/sessionEvents`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('events POST', error);\n    });\n  };\n\n  const postSessionBlob = async (\n    meta: ChunkMeta,\n    gzipped: Uint8Array,\n    keepalive = false,\n  ): Promise<void> => {\n    await fetch(`${baseUrl}/sessionReplays/blob`, {\n      body: gzipped as unknown as BodyInit,\n      headers: {\n        ...headers,\n        'content-type': 'application/octet-stream',\n        'x-mxl-chunk-seq': String(meta.chunkSeq),\n        'x-mxl-duration-ms': String(meta.durationMs),\n        'x-mxl-event-count': String(meta.eventCount),\n        'x-mxl-is-checkpoint': meta.isCheckpoint ? '1' : '0',\n        'x-mxl-session-id': meta.sessionId,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('blob POST', error);\n    });\n  };\n\n  return {\n    postSessionBlob,\n    postSessionEvents,\n    postSessionMeta,\n    shouldIgnoreUrl,\n  };\n}\n\nexport function createReplayTransportFromInit(args: {\n  appID: string;\n  userID: string;\n  apiURL?: string;\n  otelCollectorURL?: string;\n}): ReplayTransport {\n  return createReplayTransport({\n    appID: args.appID,\n    baseUrl: getApiURL(args.apiURL),\n    otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL),\n    userID: args.userID,\n  });\n}\n"],"mappings":";;;;;;;;AAeA,IAAI,aAAa;AAEjB,SAAS,YAAY,MAAc,OAAsB;CACvD,MAAM,MAAM,KAAK,KAAK;AACtB,KAAI,MAAM,aAAa,IACrB;AAEF,cAAa;AAEb,SAAQ,KACN,wBAAwB,KAAK,gDAC7B,MACD;;AAGH,SAAgB,sBACd,QACiB;CACjB,MAAM,UAAU,cAAc,OAAO,OAAO,OAAO,OAAO;CAC1D,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;CACjD,MAAM,mBAAmB,OAAO,iBAAiB,QAAQ,OAAO,GAAG;CAEnE,MAAM,sBAAsB;EAC1B,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,iBAAiB;EACpB,GAAG,iBAAiB;EACrB;CAED,MAAM,mBAAmB,QACvB,oBAAoB,MAAM,WAAW,IAAI,WAAW,OAAO,CAAC;CAE9D,MAAM,kBAAkB,OACtB,KACA,YAAY,UACM;EAClB,MAAM,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC;AACpC,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,iBAAiB,MAAM;IACnC;;CAGJ,MAAM,oBAAoB,OACxB,MACA,YAAY,UACM;AAClB,MAAI,KAAK,WAAW,EAClB;EAEF,MAAM,OAAO,GAAG,KAAK,KAAK,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;AAClE,QAAM,MAAM,GAAG,QAAQ,iBAAiB;GACtC;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,MACA,SACA,YAAY,UACM;AAClB,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,mBAAmB,OAAO,KAAK,SAAS;IACxC,qBAAqB,OAAO,KAAK,WAAW;IAC5C,qBAAqB,OAAO,KAAK,WAAW;IAC5C,uBAAuB,KAAK,eAAe,MAAM;IACjD,oBAAoB,KAAK;IAC1B;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,aAAa,MAAM;IAC/B;;AAGJ,QAAO;EACL;EACA;EACA;EACA;EACD;;AAGH,SAAgB,8BAA8B,MAK1B;AAClB,QAAO,sBAAsB;EAC3B,OAAO,KAAK;EACZ,SAAS,UAAU,KAAK,OAAO;EAC/B,kBAAkB,oBAAoB,KAAK,iBAAiB;EAC5D,QAAQ,KAAK;EACd,CAAC"}
+{"version":3,"file":"replayTransport.js","names":[],"sources":["../../../../src/instrumentations/replay/transport/replayTransport.ts"],"sourcesContent":["/**\n * Ported from Maple browser SDK (MIT), adapted for MXL auth and endpoints.\n * @see https://github.com/Makisuo/maple/tree/main/packages/browser/src/replay/transport.ts\n */\n\nimport {\n  getApiURL,\n  getOtelCollectorURL,\n} from '../../../managers/MXLConfigManager/utils';\nimport { gzip } from './gzip';\nimport type { ChunkMeta, ReplayTransport, ReplayTransportConfig } from './types';\n\nexport { gzip };\n\nconst getReplayHeaders = (appID: string): Record<string, string> => ({\n  'mxl-client-id': appID,\n});\n\nlet lastWarnAt = 0;\n\nfunction warnDropped(what: string, error: unknown): void {\n  const now = Date.now();\n  if (now - lastWarnAt < 30_000) {\n    return;\n  }\n  lastWarnAt = now;\n  // oxlint-disable-next-line no-console -- best-effort replay diagnostics\n  console.warn(\n    `[mxl] session replay ${what} failed (dropping; will retry on next chunk):`,\n    error,\n  );\n}\n\nexport function createReplayTransport(\n  config: ReplayTransportConfig,\n): ReplayTransport {\n  const headers = getReplayHeaders(config.appID);\n  const baseUrl = config.baseUrl.replace(/\\/$/, '');\n  const otelCollectorURL = config.otelCollectorURL.replace(/\\/$/, '');\n\n  const ignoredPathPrefixes = [\n    `${baseUrl}/sessionReplays/`,\n    `${baseUrl}/sessionEvents`,\n    `${baseUrl}/replay`,\n    `${otelCollectorURL}/v1/logs`,\n    `${otelCollectorURL}/v1/traces`,\n  ];\n\n  const shouldIgnoreUrl = (url: string): boolean =>\n    ignoredPathPrefixes.some((prefix) => url.startsWith(prefix));\n\n  const postReplay = async (keepalive = false): Promise<void> => {\n    if (!config.apiKey) {\n      return;\n    }\n    await fetch(`${baseUrl}/replay`, {\n      body: 'null',\n      headers: {\n        ...headers,\n        'content-type': 'application/json',\n        'mxl-api-key': config.apiKey,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('replay POST', error);\n    });\n  };\n\n  const postSessionMeta = async (\n    row: Record<string, unknown>,\n    keepalive = false,\n  ): Promise<void> => {\n    const body = `${JSON.stringify(row)}\\n`;\n    await fetch(`${baseUrl}/sessionReplays/meta`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('metadata POST', error);\n    });\n  };\n\n  const postSessionEvents = async (\n    rows: ReadonlyArray<Record<string, unknown>>,\n    keepalive = false,\n  ): Promise<void> => {\n    if (rows.length === 0) {\n      return;\n    }\n    const body = `${rows.map((row) => JSON.stringify(row)).join('\\n')}\\n`;\n    await fetch(`${baseUrl}/sessionEvents`, {\n      body,\n      headers: {\n        ...headers,\n        'content-type': 'application/x-ndjson',\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('events POST', error);\n    });\n  };\n\n  const postSessionBlob = async (\n    meta: ChunkMeta,\n    gzipped: Uint8Array,\n    keepalive = false,\n  ): Promise<void> => {\n    await fetch(`${baseUrl}/sessionReplays/blob`, {\n      body: gzipped as unknown as BodyInit,\n      headers: {\n        ...headers,\n        'content-type': 'application/octet-stream',\n        'x-mxl-chunk-seq': String(meta.chunkSeq),\n        'x-mxl-duration-ms': String(meta.durationMs),\n        'x-mxl-event-count': String(meta.eventCount),\n        'x-mxl-is-checkpoint': meta.isCheckpoint ? '1' : '0',\n        'x-mxl-session-id': meta.sessionId,\n      },\n      keepalive,\n      method: 'POST',\n    }).catch((error) => {\n      warnDropped('blob POST', error);\n    });\n  };\n\n  return {\n    postReplay,\n    postSessionBlob,\n    postSessionEvents,\n    postSessionMeta,\n    shouldIgnoreUrl,\n  };\n}\n\nexport function createReplayTransportFromInit(args: {\n  appID: string;\n  apiKey?: string;\n  apiURL?: string;\n  otelCollectorURL?: string;\n}): ReplayTransport {\n  return createReplayTransport({\n    apiKey: args.apiKey,\n    appID: args.appID,\n    baseUrl: getApiURL(args.apiURL),\n    otelCollectorURL: getOtelCollectorURL(args.otelCollectorURL),\n  });\n}\n"],"mappings":";;;;;;;AAcA,MAAM,oBAAoB,WAA2C,EACnE,iBAAiB,OAClB;AAED,IAAI,aAAa;AAEjB,SAAS,YAAY,MAAc,OAAsB;CACvD,MAAM,MAAM,KAAK,KAAK;AACtB,KAAI,MAAM,aAAa,IACrB;AAEF,cAAa;AAEb,SAAQ,KACN,wBAAwB,KAAK,gDAC7B,MACD;;AAGH,SAAgB,sBACd,QACiB;CACjB,MAAM,UAAU,iBAAiB,OAAO,MAAM;CAC9C,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;CACjD,MAAM,mBAAmB,OAAO,iBAAiB,QAAQ,OAAO,GAAG;CAEnE,MAAM,sBAAsB;EAC1B,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,QAAQ;EACX,GAAG,iBAAiB;EACpB,GAAG,iBAAiB;EACrB;CAED,MAAM,mBAAmB,QACvB,oBAAoB,MAAM,WAAW,IAAI,WAAW,OAAO,CAAC;CAE9D,MAAM,aAAa,OAAO,YAAY,UAAyB;AAC7D,MAAI,CAAC,OAAO,OACV;AAEF,QAAM,MAAM,GAAG,QAAQ,UAAU;GAC/B,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,eAAe,OAAO;IACvB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,KACA,YAAY,UACM;EAClB,MAAM,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC;AACpC,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,iBAAiB,MAAM;IACnC;;CAGJ,MAAM,oBAAoB,OACxB,MACA,YAAY,UACM;AAClB,MAAI,KAAK,WAAW,EAClB;EAEF,MAAM,OAAO,GAAG,KAAK,KAAK,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;AAClE,QAAM,MAAM,GAAG,QAAQ,iBAAiB;GACtC;GACA,SAAS;IACP,GAAG;IACH,gBAAgB;IACjB;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,eAAe,MAAM;IACjC;;CAGJ,MAAM,kBAAkB,OACtB,MACA,SACA,YAAY,UACM;AAClB,QAAM,MAAM,GAAG,QAAQ,uBAAuB;GAC5C,MAAM;GACN,SAAS;IACP,GAAG;IACH,gBAAgB;IAChB,mBAAmB,OAAO,KAAK,SAAS;IACxC,qBAAqB,OAAO,KAAK,WAAW;IAC5C,qBAAqB,OAAO,KAAK,WAAW;IAC5C,uBAAuB,KAAK,eAAe,MAAM;IACjD,oBAAoB,KAAK;IAC1B;GACD;GACA,QAAQ;GACT,CAAC,CAAC,OAAO,UAAU;AAClB,eAAY,aAAa,MAAM;IAC/B;;AAGJ,QAAO;EACL;EACA;EACA;EACA;EACA;EACD;;AAGH,SAAgB,8BAA8B,MAK1B;AAClB,QAAO,sBAAsB;EAC3B,QAAQ,KAAK;EACb,OAAO,KAAK;EACZ,SAAS,UAAU,KAAK,OAAO;EAC/B,kBAAkB,oBAAoB,KAAK,iBAAiB;EAC7D,CAAC"}

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

@@ -1,7 +1,7 @@
 //#region src/instrumentations/replay/transport/types.d.ts
 interface ReplayTransportConfig {
   readonly appID: string;
-  readonly userID: string;
+  readonly apiKey?: string;
   readonly baseUrl: string;
   readonly otelCollectorURL: string;
 }
@@ -13,6 +13,7 @@ interface ChunkMeta {
   readonly durationMs: number;
 }
 interface ReplayTransport {
+  postReplay: (keepalive?: boolean) => Promise<void>;
   postSessionMeta: (row: Record<string, unknown>, keepalive?: boolean) => Promise<void>;
   postSessionEvents: (rows: ReadonlyArray<Record<string, unknown>>, keepalive?: boolean) => Promise<void>;
   postSessionBlob: (meta: ChunkMeta, gzipped: Uint8Array, keepalive?: boolean) => Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/transport/types.ts"],"mappings":";UAAiB,qBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,gBAAA;AAAA;AAAA,UAGM,SAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGM,eAAA;EACf,eAAA,GACE,GAAA,EAAK,MAAA,mBACL,SAAA,eACG,OAAA;EACL,iBAAA,GACE,IAAA,EAAM,aAAA,CAAc,MAAA,oBACpB,SAAA,eACG,OAAA;EACL,eAAA,GACE,IAAA,EAAM,SAAA,EACN,OAAA,EAAS,UAAA,EACT,SAAA,eACG,OAAA;EACL,eAAA,GAAkB,GAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../../src/instrumentations/replay/transport/types.ts"],"mappings":";UAAiB,qBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,gBAAA;AAAA;AAAA,UAGM,SAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGM,eAAA;EACf,UAAA,GAAa,SAAA,eAAwB,OAAA;EACrC,eAAA,GACE,GAAA,EAAK,MAAA,mBACL,SAAA,eACG,OAAA;EACL,iBAAA,GACE,IAAA,EAAM,aAAA,CAAc,MAAA,oBACpB,SAAA,eACG,OAAA;EACL,eAAA,GACE,IAAA,EAAM,SAAA,EACN,OAAA,EAAS,UAAA,EACT,SAAA,eACG,OAAA;EACL,eAAA,GAAkB,GAAA;AAAA"}

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

@@ -1,7 +1,7 @@
 //#region src/instrumentations/replay/transport/types.d.ts
 interface ReplayTransportConfig {
   readonly appID: string;
-  readonly userID: string;
+  readonly apiKey?: string;
   readonly baseUrl: string;
   readonly otelCollectorURL: string;
 }
@@ -13,6 +13,7 @@ interface ChunkMeta {
   readonly durationMs: number;
 }
 interface ReplayTransport {
+  postReplay: (keepalive?: boolean) => Promise<void>;
   postSessionMeta: (row: Record<string, unknown>, keepalive?: boolean) => Promise<void>;
   postSessionEvents: (rows: ReadonlyArray<Record<string, unknown>>, keepalive?: boolean) => Promise<void>;
   postSessionBlob: (meta: ChunkMeta, gzipped: Uint8Array, keepalive?: boolean) => Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/transport/types.ts"],"mappings":";UAAiB,qBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,gBAAA;AAAA;AAAA,UAGM,SAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGM,eAAA;EACf,eAAA,GACE,GAAA,EAAK,MAAA,mBACL,SAAA,eACG,OAAA;EACL,iBAAA,GACE,IAAA,EAAM,aAAA,CAAc,MAAA,oBACpB,SAAA,eACG,OAAA;EACL,eAAA,GACE,IAAA,EAAM,SAAA,EACN,OAAA,EAAS,UAAA,EACT,SAAA,eACG,OAAA;EACL,eAAA,GAAkB,GAAA;AAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/instrumentations/replay/transport/types.ts"],"mappings":";UAAiB,qBAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;EAAA,SACA,gBAAA;AAAA;AAAA,UAGM,SAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;EAAA,SACA,YAAA;EAAA,SACA,UAAA;EAAA,SACA,UAAA;AAAA;AAAA,UAGM,eAAA;EACf,UAAA,GAAa,SAAA,eAAwB,OAAA;EACrC,eAAA,GACE,GAAA,EAAK,MAAA,mBACL,SAAA,eACG,OAAA;EACL,iBAAA,GACE,IAAA,EAAM,aAAA,CAAc,MAAA,oBACpB,SAAA,eACG,OAAA;EACL,eAAA,GACE,IAAA,EAAM,SAAA,EACN,OAAA,EAAS,UAAA,EACT,SAAA,eACG,OAAA;EACL,eAAA,GAAkB,GAAA;AAAA"}