@safaricom-mxl/web-sdk 0.0.16 → 0.0.17

package/dist/sdk/setupSessionRecorder.d.ts

@@ -1,30 +0,0 @@
-import { SessionRecorderUserConfig, SessionRecordingControl } from "./types.js";
-import { DiagLogger } from "@opentelemetry/api";
-import { Resource } from "@opentelemetry/resources";
-import { WebTracerProvider } from "@opentelemetry/sdk-trace-web";
-import * as _$_safaricom_mxl_session_recorder0 from "@safaricom-mxl/session-recorder";
-
-//#region src/sdk/setupSessionRecorder.d.ts
-type SessionRecorderModule = typeof _$_safaricom_mxl_session_recorder0;
-declare function loadSessionRecorderModule(): Promise<SessionRecorderModule>;
-declare function resetSessionRecorderModuleCache(): void;
-declare function setSessionRecorderModuleLoaderForTests(loader: (() => Promise<SessionRecorderModule>) | undefined): void;
-interface SpanSessionManagerForRecorder {
-  getSessionId: () => string | null;
-  addSessionStartedListener: (listener: () => void) => () => void;
-}
-interface CreateSessionRecordingControlArgs {
-  resource: Resource;
-  spanSessionManager: SpanSessionManagerForRecorder;
-  tracerProvider: WebTracerProvider;
-  appID: string;
-  userID: string;
-  mxlDataURL?: string;
-  recordUserSessions: boolean;
-  sessionRecorder?: SessionRecorderUserConfig;
-  diagLogger: DiagLogger;
-}
-declare function createSessionRecordingControl(args: CreateSessionRecordingControlArgs): SessionRecordingControl;
-//#endregion
-export { createSessionRecordingControl, loadSessionRecorderModule, resetSessionRecorderModuleCache, setSessionRecorderModuleLoaderForTests };
-//# sourceMappingURL=setupSessionRecorder.d.ts.map

package/dist/sdk/setupSessionRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setupSessionRecorder.d.ts","names":[],"sources":["../../src/sdk/setupSessionRecorder.ts"],"mappings":";;;;;;;KAWK,qBAAA,UAAqB,kCAAA;AAAA,iBAOV,yBAAA,CAAA,GAA6B,OAAA,CAAQ,qBAAA;AAAA,iBASrC,+BAAA,CAAA;AAAA,iBAKA,sCAAA,CACd,MAAA,SAAe,OAAA,CAAQ,qBAAA;AAAA,UAMf,6BAAA;EACR,YAAA;EACA,yBAAA,GAA4B,QAAA;AAAA;AAAA,UAGpB,iCAAA;EACR,QAAA,EAAU,QAAA;EACV,kBAAA,EAAoB,6BAAA;EACpB,cAAA,EAAgB,iBAAA;EAChB,KAAA;EACA,MAAA;EACA,UAAA;EACA,kBAAA;EACA,eAAA,GAAkB,yBAAA;EAClB,UAAA,EAAY,UAAA;AAAA;AAAA,iBA6BE,6BAAA,CACd,IAAA,EAAM,iCAAA,GACL,uBAAA"}

package/dist/sdk/setupSessionRecorder.js

@@ -1,83 +0,0 @@
-import { getMXLHeaders } from "../exporters/utils.js";
-import { getLogEndpoint } from "../exporters/MXLLogExporter/utils.js";
-//#region src/sdk/setupSessionRecorder.ts
-let sessionRecorderModulePromise;
-let sessionRecorderModuleLoaderOverride;
-function loadSessionRecorderModule() {
-	if (sessionRecorderModuleLoaderOverride) return sessionRecorderModuleLoaderOverride();
-	sessionRecorderModulePromise ??= import("@safaricom-mxl/session-recorder");
-	return sessionRecorderModulePromise;
-}
-function resetSessionRecorderModuleCache() {
-	sessionRecorderModulePromise = void 0;
-	sessionRecorderModuleLoaderOverride = void 0;
-}
-function setSessionRecorderModuleLoaderForTests(loader) {
-	sessionRecorderModuleLoaderOverride = loader;
-	sessionRecorderModulePromise = void 0;
-}
-function buildInitConfig({ resource, spanSessionManager, tracerProvider, appID, userID, mxlDataURL, sessionRecorder: userOptions }, sessionRecorderVersion) {
-	return {
-		resource,
-		getSessionId: () => spanSessionManager.getSessionId(),
-		tracer: tracerProvider.getTracer("mxl.session-recorder", sessionRecorderVersion),
-		url: getLogEndpoint(appID, mxlDataURL),
-		headers: getMXLHeaders(appID, userID),
-		...userOptions
-	};
-}
-function createSessionRecordingControl(args) {
-	let sessionRecorderModule;
-	let initStarted = false;
-	let initComplete = false;
-	let initFailed = false;
-	let pendingInit;
-	const getSessionRecorder = () => sessionRecorderModule?.SessionRecorder;
-	const waitForSessionStart = () => new Promise((resolve) => {
-		const removeListener = args.spanSessionManager.addSessionStartedListener(() => {
-			removeListener();
-			resolve();
-		});
-	});
-	const initSessionRecorderWhenReady = () => {
-		if (initComplete || initFailed) return Promise.resolve();
-		pendingInit ??= (async () => {
-			if (args.spanSessionManager.getSessionId() === null) await waitForSessionStart();
-			if (initComplete || initFailed || initStarted) return;
-			initStarted = true;
-			try {
-				sessionRecorderModule = await loadSessionRecorderModule();
-				const config = buildInitConfig(args, sessionRecorderModule.VERSION);
-				sessionRecorderModule.SessionRecorder.init(config);
-				initComplete = true;
-			} catch (error) {
-				initFailed = true;
-				args.diagLogger.error("Failed to initialize session recorder", error);
-			} finally {
-				pendingInit = void 0;
-			}
-		})();
-		return pendingInit;
-	};
-	if (args.recordUserSessions) initSessionRecorderWhenReady();
-	return {
-		isRecording: () => Boolean(getSessionRecorder()?.isRecording()),
-		setEnabled: (enabled) => {
-			if (enabled) {
-				if (initComplete) {
-					getSessionRecorder()?.setEnabled(true);
-					return;
-				}
-				initSessionRecorderWhenReady().then(() => {
-					if (initComplete) getSessionRecorder()?.setEnabled(true);
-				});
-				return;
-			}
-			if (initComplete) getSessionRecorder()?.setEnabled(false);
-		}
-	};
-}
-//#endregion
-export { createSessionRecordingControl, loadSessionRecorderModule, resetSessionRecorderModuleCache, setSessionRecorderModuleLoaderForTests };
-
-//# sourceMappingURL=setupSessionRecorder.js.map

package/dist/sdk/setupSessionRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setupSessionRecorder.js","names":[],"sources":["../../src/sdk/setupSessionRecorder.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { Resource } from '@opentelemetry/resources';\nimport type { WebTracerProvider } from '@opentelemetry/sdk-trace-web';\nimport type { SessionRecorderConfig } from '@safaricom-mxl/session-recorder';\nimport { getLogEndpoint } from '../exporters/MXLLogExporter/utils';\nimport { getMXLHeaders } from '../exporters/utils';\nimport type {\n  SessionRecorderUserConfig,\n  SessionRecordingControl,\n} from './types';\n\ntype SessionRecorderModule = typeof import('@safaricom-mxl/session-recorder');\n\nlet sessionRecorderModulePromise: Promise<SessionRecorderModule> | undefined;\nlet sessionRecorderModuleLoaderOverride:\n  | (() => Promise<SessionRecorderModule>)\n  | undefined;\n\nexport function loadSessionRecorderModule(): Promise<SessionRecorderModule> {\n  if (sessionRecorderModuleLoaderOverride) {\n    return sessionRecorderModuleLoaderOverride();\n  }\n\n  sessionRecorderModulePromise ??= import('@safaricom-mxl/session-recorder');\n  return sessionRecorderModulePromise;\n}\n\nexport function resetSessionRecorderModuleCache(): void {\n  sessionRecorderModulePromise = undefined;\n  sessionRecorderModuleLoaderOverride = undefined;\n}\n\nexport function setSessionRecorderModuleLoaderForTests(\n  loader: (() => Promise<SessionRecorderModule>) | undefined,\n): void {\n  sessionRecorderModuleLoaderOverride = loader;\n  sessionRecorderModulePromise = undefined;\n}\n\ninterface SpanSessionManagerForRecorder {\n  getSessionId: () => string | null;\n  addSessionStartedListener: (listener: () => void) => () => void;\n}\n\ninterface CreateSessionRecordingControlArgs {\n  resource: Resource;\n  spanSessionManager: SpanSessionManagerForRecorder;\n  tracerProvider: WebTracerProvider;\n  appID: string;\n  userID: string;\n  mxlDataURL?: string;\n  recordUserSessions: boolean;\n  sessionRecorder?: SessionRecorderUserConfig;\n  diagLogger: DiagLogger;\n}\n\nfunction buildInitConfig(\n  {\n    resource,\n    spanSessionManager,\n    tracerProvider,\n    appID,\n    userID,\n    mxlDataURL,\n    sessionRecorder: userOptions,\n  }: CreateSessionRecordingControlArgs,\n  sessionRecorderVersion: string,\n): SessionRecorderConfig {\n  const tracer = tracerProvider.getTracer(\n    'mxl.session-recorder',\n    sessionRecorderVersion,\n  );\n  return {\n    resource,\n    getSessionId: () => spanSessionManager.getSessionId(),\n    tracer,\n    url: getLogEndpoint(appID, mxlDataURL),\n    headers: getMXLHeaders(appID, userID),\n    ...userOptions,\n  } as SessionRecorderConfig;\n}\n\nexport function createSessionRecordingControl(\n  args: CreateSessionRecordingControlArgs,\n): SessionRecordingControl {\n  let sessionRecorderModule: SessionRecorderModule | undefined;\n  let initStarted = false;\n  let initComplete = false;\n  let initFailed = false;\n  let pendingInit: Promise<void> | undefined;\n\n  const getSessionRecorder = ():\n    | SessionRecorderModule['SessionRecorder']\n    | undefined => sessionRecorderModule?.SessionRecorder;\n\n  const waitForSessionStart = (): Promise<void> =>\n    new Promise((resolve) => {\n      const removeListener = args.spanSessionManager.addSessionStartedListener(\n        () => {\n          removeListener();\n          resolve();\n        },\n      );\n    });\n\n  const initSessionRecorderWhenReady = (): Promise<void> => {\n    if (initComplete || initFailed) {\n      return Promise.resolve();\n    }\n\n    pendingInit ??= (async () => {\n      if (args.spanSessionManager.getSessionId() === null) {\n        await waitForSessionStart();\n      }\n\n      if (initComplete || initFailed || initStarted) {\n        return;\n      }\n      initStarted = true;\n\n      try {\n        sessionRecorderModule = await loadSessionRecorderModule();\n        const config = buildInitConfig(args, sessionRecorderModule.VERSION);\n        sessionRecorderModule.SessionRecorder.init(config);\n        initComplete = true;\n      } catch (error) {\n        initFailed = true;\n        args.diagLogger.error('Failed to initialize session recorder', error);\n      } finally {\n        pendingInit = undefined;\n      }\n    })();\n\n    return pendingInit;\n  };\n\n  if (args.recordUserSessions) {\n    void initSessionRecorderWhenReady();\n  }\n\n  return {\n    isRecording: () => Boolean(getSessionRecorder()?.isRecording()),\n    setEnabled: (enabled: boolean) => {\n      if (enabled) {\n        if (initComplete) {\n          getSessionRecorder()?.setEnabled(true);\n          return;\n        }\n        void initSessionRecorderWhenReady().then(() => {\n          if (initComplete) {\n            getSessionRecorder()?.setEnabled(true);\n          }\n        });\n        return;\n      }\n\n      if (initComplete) {\n        getSessionRecorder()?.setEnabled(false);\n      }\n    },\n  };\n}\n"],"mappings":";;;AAaA,IAAI;AACJ,IAAI;AAIJ,SAAgB,4BAA4D;AAC1E,KAAI,oCACF,QAAO,qCAAqC;AAG9C,kCAAiC,OAAO;AACxC,QAAO;;AAGT,SAAgB,kCAAwC;AACtD,gCAA+B,KAAA;AAC/B,uCAAsC,KAAA;;AAGxC,SAAgB,uCACd,QACM;AACN,uCAAsC;AACtC,gCAA+B,KAAA;;AAoBjC,SAAS,gBACP,EACE,UACA,oBACA,gBACA,OACA,QACA,YACA,iBAAiB,eAEnB,wBACuB;AAKvB,QAAO;EACL;EACA,oBAAoB,mBAAmB,cAAc;EACrD,QAPa,eAAe,UAC5B,wBACA,uBAKM;EACN,KAAK,eAAe,OAAO,WAAW;EACtC,SAAS,cAAc,OAAO,OAAO;EACrC,GAAG;EACJ;;AAGH,SAAgB,8BACd,MACyB;CACzB,IAAI;CACJ,IAAI,cAAc;CAClB,IAAI,eAAe;CACnB,IAAI,aAAa;CACjB,IAAI;CAEJ,MAAM,2BAEW,uBAAuB;CAExC,MAAM,4BACJ,IAAI,SAAS,YAAY;EACvB,MAAM,iBAAiB,KAAK,mBAAmB,gCACvC;AACJ,mBAAgB;AAChB,YAAS;IAEZ;GACD;CAEJ,MAAM,qCAAoD;AACxD,MAAI,gBAAgB,WAClB,QAAO,QAAQ,SAAS;AAG1B,mBAAiB,YAAY;AAC3B,OAAI,KAAK,mBAAmB,cAAc,KAAK,KAC7C,OAAM,qBAAqB;AAG7B,OAAI,gBAAgB,cAAc,YAChC;AAEF,iBAAc;AAEd,OAAI;AACF,4BAAwB,MAAM,2BAA2B;IACzD,MAAM,SAAS,gBAAgB,MAAM,sBAAsB,QAAQ;AACnE,0BAAsB,gBAAgB,KAAK,OAAO;AAClD,mBAAe;YACR,OAAO;AACd,iBAAa;AACb,SAAK,WAAW,MAAM,yCAAyC,MAAM;aAC7D;AACR,kBAAc,KAAA;;MAEd;AAEJ,SAAO;;AAGT,KAAI,KAAK,mBACF,+BAA8B;AAGrC,QAAO;EACL,mBAAmB,QAAQ,oBAAoB,EAAE,aAAa,CAAC;EAC/D,aAAa,YAAqB;AAChC,OAAI,SAAS;AACX,QAAI,cAAc;AAChB,yBAAoB,EAAE,WAAW,KAAK;AACtC;;AAEG,kCAA8B,CAAC,WAAW;AAC7C,SAAI,aACF,qBAAoB,EAAE,WAAW,KAAK;MAExC;AACF;;AAGF,OAAI,aACF,qBAAoB,EAAE,WAAW,MAAM;;EAG5C"}

package/dist/utils/MXLSpanStorage/MXLSpanStorage.cjs

@@ -1,116 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../_virtual/_rolldown/runtime.cjs");
-const require_constants_attributes = require("../../constants/attributes.cjs");
-let _opentelemetry_api = require("@opentelemetry/api");
-let _opentelemetry_resources = require("@opentelemetry/resources");
-let _opentelemetry_sdk_trace_web = require("@opentelemetry/sdk-trace-web");
-//#region src/utils/MXLSpanStorage/MXLSpanStorage.ts
-const PENDING_SPANS_STORAGE_KEY_PREFIX = "mxl_pending_";
-const MAX_PENDING_SPANS_ITEMS = 10;
-var MXLSpanStorage = class {
-	_noExportTracer;
-	_storage;
-	_diag;
-	_onExpiredSpansExport;
-	_storedSpansExpireTimeoutMS;
-	_spanSessionManager;
-	_checkExpiredSpansInterval;
-	constructor({ resource = (0, _opentelemetry_resources.emptyResource)(), storage = window.localStorage, diag: diagParam = _opentelemetry_api.diag.createComponentLogger({ namespace: "MXLSpanStorage" }), storedSpansExpireTimeoutMS = 3600 * 1e3, onExpiredSpansExport, spanSessionManager }) {
-		this._noExportTracer = new _opentelemetry_sdk_trace_web.BasicTracerProvider({ resource }).getTracer("mxl-web-sdk-sessions");
-		this._storage = storage;
-		this._diag = diagParam;
-		this._storedSpansExpireTimeoutMS = storedSpansExpireTimeoutMS;
-		this._onExpiredSpansExport = onExpiredSpansExport;
-		this._spanSessionManager = spanSessionManager;
-		this.startExpiredSpansCheck();
-	}
-	storePendingSpans(sessionId, sessionSpan, pendingSpans) {
-		try {
-			this.clearStoredSpans(sessionId);
-			if (this._getPendingSpansKeys().length >= MAX_PENDING_SPANS_ITEMS) {
-				this._spanSessionManager.incrSessionCountForKey(require_constants_attributes.KEY_MXL_MAX_PENDING_SPANS_REACHED);
-				this._diag.warn("Not storing pending spans as the max number of items was reached");
-				return;
-			}
-			const key = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_${Date.now()}`;
-			this._storage.setItem(key, JSON.stringify([sessionSpan, ...pendingSpans], (key, value) => key.startsWith("_") ? void 0 : value));
-			this._diag.debug(`Stored pending span: ${key}`);
-		} catch (error) {
-			this._diag.error("Failed to store spans to storage:", error);
-		}
-	}
-	clearStoredSpans(sessionId) {
-		try {
-			const prefix = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_`;
-			this._getPendingSpansKeys().forEach((key) => {
-				if (key.startsWith(prefix)) this._storage.removeItem(key);
-			});
-		} catch (error) {
-			this._diag.error("Failed to clear stored spans from storage:", error);
-		}
-	}
-	startExpiredSpansCheck() {
-		this._checkExpiredSpansInterval = setInterval(() => {
-			this.checkAndExportExpiredSpans();
-		}, 300 * 1e3);
-	}
-	stopExpiredSpansCheck() {
-		if (this._checkExpiredSpansInterval) {
-			clearInterval(this._checkExpiredSpansInterval);
-			this._checkExpiredSpansInterval = void 0;
-		}
-	}
-	checkAndExportExpiredSpans() {
-		try {
-			const keys = this._getPendingSpansKeys();
-			if (keys.length === 0) return;
-			const currentTime = Date.now();
-			keys.forEach((key) => {
-				const parts = key.split("_");
-				const storedTime = parseInt(parts[parts.length - 1], 10);
-				if (Number.isNaN(storedTime)) {
-					this._diag.error("Found invalid timestamp in stored span:", storedTime);
-					this._storage.removeItem(key);
-				}
-				if (currentTime - storedTime <= this._storedSpansExpireTimeoutMS) return;
-				const storedData = this._storage.getItem(key);
-				if (!storedData) return;
-				try {
-					const spans = [];
-					for (const storedSpan of JSON.parse(storedData)) {
-						const span = this._noExportTracer.startSpan(storedSpan.name, {
-							kind: storedSpan.kind,
-							attributes: storedSpan.attributes,
-							links: storedSpan.links,
-							startTime: storedSpan.startTime
-						});
-						span.setStatus(storedSpan.status);
-						span.end(storedSpan.endTime);
-						spans.push(span);
-					}
-					if (this._onExpiredSpansExport && spans.length > 0) this._onExpiredSpansExport(spans);
-				} catch (e) {
-					this._diag.error("Failed to process expired spans:", e);
-				}
-				this._storage.removeItem(key);
-			});
-		} catch (e) {
-			this._diag.error("Failed to check and export expired spans:", e);
-		}
-	}
-	_getPendingSpansKeys() {
-		const keys = [];
-		for (let i = 0; i < this._storage.length; i++) {
-			const key = this._storage.key(i);
-			if (key?.startsWith(PENDING_SPANS_STORAGE_KEY_PREFIX)) keys.push(key);
-		}
-		return keys;
-	}
-	destroy() {
-		this.stopExpiredSpansCheck();
-	}
-};
-//#endregion
-exports.MXLSpanStorage = MXLSpanStorage;
-
-//# sourceMappingURL=MXLSpanStorage.cjs.map

package/dist/utils/MXLSpanStorage/MXLSpanStorage.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"MXLSpanStorage.cjs","names":["diag","BasicTracerProvider","KEY_MXL_MAX_PENDING_SPANS_REACHED"],"sources":["../../../src/utils/MXLSpanStorage/MXLSpanStorage.ts"],"sourcesContent":["import type { DiagLogger, Tracer } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { Resource } from '@opentelemetry/resources';\nimport { emptyResource } from '@opentelemetry/resources';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-web';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-web';\nimport { KEY_MXL_MAX_PENDING_SPANS_REACHED } from '../../constants';\nimport type { SpanSessionManagerInternal } from '../../managers';\n\nconst PENDING_SPANS_STORAGE_KEY_PREFIX = 'mxl_pending_';\nconst MAX_PENDING_SPANS_ITEMS = 10;\n\nexport interface SpanStorageOptions {\n  spanSessionManager: SpanSessionManagerInternal;\n  resource?: Resource;\n  storage?: Storage;\n  diag?: DiagLogger;\n  storedSpansExpireTimeoutMS?: number;\n  onExpiredSpansExport?: (spans: ReadableSpan[]) => void;\n}\n\n// MXLSpanStorage is used to keep pending spans that are not meant to be exported (yet) in localStorage,\n// and periodically checks whenever those stored spans are ready to be exported.\n// This functionality has some custom logic to be able to store these spans as JSONs and then recreate them back\n// that could eventually be improved. In particular the things that would need to be improved are:\n// - Avoid serializing as JSON and instead try to use a customExporter that produces the body as it was going to be\n//   sent over the wire (serialized, compressed, etc), and store that, so that later when it decides to export those,\n//   it's just using that body as a regular fetch call.\n// - Create a service worker that is responsible for tracking the pending spans and deciding when to actually export them.\n//   That way we would avoid a potential race condition where two different tabs would try to export the same data.\n// - Make this a more comprehensive component so that the MXLSessionBatchedSpanProcessor doesn't need to be in the\n//   middle of SpanSessionVisibilityInstrumentation and this component. Ideally this component would know when and how\n//   to take snapshots of the current pending spans and the current session span at any moment, so that the visibility\n//   instrumentation doesn't need to be telling that to the batch span processor.\nexport class MXLSpanStorage {\n  private readonly _noExportTracer: Tracer;\n  private readonly _storage: Storage;\n  private readonly _diag: DiagLogger;\n  private readonly _onExpiredSpansExport?: (spans: ReadableSpan[]) => void;\n  private readonly _storedSpansExpireTimeoutMS: number;\n  private readonly _spanSessionManager: SpanSessionManagerInternal;\n  private _checkExpiredSpansInterval?: ReturnType<typeof setInterval>;\n\n  public constructor({\n    resource = emptyResource(),\n    storage = window.localStorage,\n    diag: diagParam = diag.createComponentLogger({\n      namespace: 'MXLSpanStorage',\n    }),\n    storedSpansExpireTimeoutMS = 60 * 60 * 1000, // 1 hour\n    onExpiredSpansExport,\n    spanSessionManager,\n  }: SpanStorageOptions) {\n    this._noExportTracer = new BasicTracerProvider({ resource }).getTracer(\n      'mxl-web-sdk-sessions',\n    );\n    this._storage = storage;\n    this._diag = diagParam;\n    this._storedSpansExpireTimeoutMS = storedSpansExpireTimeoutMS;\n    this._onExpiredSpansExport = onExpiredSpansExport;\n    this._spanSessionManager = spanSessionManager;\n\n    this.startExpiredSpansCheck();\n  }\n\n  public storePendingSpans(\n    sessionId: string,\n    sessionSpan: ReadableSpan,\n    pendingSpans: ReadableSpan[],\n  ): void {\n    try {\n      // If this session was already stored, clear it first:\n      this.clearStoredSpans(sessionId);\n\n      if (this._getPendingSpansKeys().length >= MAX_PENDING_SPANS_ITEMS) {\n        this._spanSessionManager.incrSessionCountForKey(\n          KEY_MXL_MAX_PENDING_SPANS_REACHED,\n        );\n        this._diag.warn(\n          'Not storing pending spans as the max number of items was reached',\n        );\n        return;\n      }\n\n      const key = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_${Date.now()}`;\n      this._storage.setItem(\n        key,\n        JSON.stringify([sessionSpan, ...pendingSpans], (key, value) =>\n          key.startsWith('_') ? undefined : value,\n        ),\n      );\n\n      this._diag.debug(`Stored pending span: ${key}`);\n    } catch (error) {\n      this._diag.error('Failed to store spans to storage:', error);\n    }\n  }\n\n  public clearStoredSpans(sessionId: string): void {\n    try {\n      const prefix = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_`;\n      this._getPendingSpansKeys().forEach((key) => {\n        if (key.startsWith(prefix)) {\n          this._storage.removeItem(key);\n        }\n      });\n    } catch (error) {\n      this._diag.error('Failed to clear stored spans from storage:', error);\n    }\n  }\n\n  public startExpiredSpansCheck(): void {\n    this._checkExpiredSpansInterval = setInterval(\n      () => {\n        this.checkAndExportExpiredSpans();\n      },\n      5 * 60 * 1000,\n    ); // Check every 5 minutes\n  }\n\n  public stopExpiredSpansCheck(): void {\n    if (this._checkExpiredSpansInterval) {\n      clearInterval(this._checkExpiredSpansInterval);\n      this._checkExpiredSpansInterval = undefined;\n    }\n  }\n\n  public checkAndExportExpiredSpans(): void {\n    try {\n      const keys = this._getPendingSpansKeys();\n      if (keys.length === 0) {\n        return;\n      }\n\n      const currentTime = Date.now();\n      keys.forEach((key) => {\n        const parts = key.split('_');\n        const storedTime = parseInt(parts[parts.length - 1], 10);\n\n        if (Number.isNaN(storedTime)) {\n          this._diag.error(\n            'Found invalid timestamp in stored span:',\n            storedTime,\n          );\n          this._storage.removeItem(key);\n        }\n\n        if (currentTime - storedTime <= this._storedSpansExpireTimeoutMS) {\n          return;\n        }\n\n        const storedData = this._storage.getItem(key);\n        if (!storedData) return;\n\n        try {\n          const spans: ReadableSpan[] = [];\n          for (const storedSpan of JSON.parse(storedData) as ReadableSpan[]) {\n            const span = this._noExportTracer.startSpan(storedSpan.name, {\n              kind: storedSpan.kind,\n              attributes: storedSpan.attributes,\n              links: storedSpan.links,\n              startTime: storedSpan.startTime,\n            });\n            span.setStatus(storedSpan.status);\n            span.end(storedSpan.endTime);\n            spans.push(span as unknown as ReadableSpan);\n          }\n\n          if (this._onExpiredSpansExport && spans.length > 0) {\n            this._onExpiredSpansExport(spans);\n          }\n        } catch (e) {\n          this._diag.error('Failed to process expired spans:', e);\n        }\n\n        // Always remove the storage item even if processing failed\n        this._storage.removeItem(key);\n      });\n    } catch (e) {\n      this._diag.error('Failed to check and export expired spans:', e);\n    }\n  }\n\n  public _getPendingSpansKeys(): string[] {\n    const keys: string[] = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(PENDING_SPANS_STORAGE_KEY_PREFIX)) {\n        keys.push(key);\n      }\n    }\n    return keys;\n  }\n\n  public destroy(): void {\n    this.stopExpiredSpansCheck();\n  }\n}\n"],"mappings":";;;;;;;AASA,MAAM,mCAAmC;AACzC,MAAM,0BAA0B;AAwBhC,IAAa,iBAAb,MAA4B;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAmB,EACjB,YAAA,GAAA,yBAAA,gBAA0B,EAC1B,UAAU,OAAO,cACjB,MAAM,YAAYA,mBAAAA,KAAK,sBAAsB,EAC3C,WAAW,kBACZ,CAAC,EACF,6BAA6B,OAAU,KACvC,sBACA,sBACqB;AACrB,OAAK,kBAAkB,IAAIC,6BAAAA,oBAAoB,EAAE,UAAU,CAAC,CAAC,UAC3D,uBACD;AACD,OAAK,WAAW;AAChB,OAAK,QAAQ;AACb,OAAK,8BAA8B;AACnC,OAAK,wBAAwB;AAC7B,OAAK,sBAAsB;AAE3B,OAAK,wBAAwB;;CAG/B,kBACE,WACA,aACA,cACM;AACN,MAAI;AAEF,QAAK,iBAAiB,UAAU;AAEhC,OAAI,KAAK,sBAAsB,CAAC,UAAU,yBAAyB;AACjE,SAAK,oBAAoB,uBACvBC,6BAAAA,kCACD;AACD,SAAK,MAAM,KACT,mEACD;AACD;;GAGF,MAAM,MAAM,GAAG,mCAAmC,UAAU,GAAG,KAAK,KAAK;AACzE,QAAK,SAAS,QACZ,KACA,KAAK,UAAU,CAAC,aAAa,GAAG,aAAa,GAAG,KAAK,UACnD,IAAI,WAAW,IAAI,GAAG,KAAA,IAAY,MACnC,CACF;AAED,QAAK,MAAM,MAAM,wBAAwB,MAAM;WACxC,OAAO;AACd,QAAK,MAAM,MAAM,qCAAqC,MAAM;;;CAIhE,iBAAwB,WAAyB;AAC/C,MAAI;GACF,MAAM,SAAS,GAAG,mCAAmC,UAAU;AAC/D,QAAK,sBAAsB,CAAC,SAAS,QAAQ;AAC3C,QAAI,IAAI,WAAW,OAAO,CACxB,MAAK,SAAS,WAAW,IAAI;KAE/B;WACK,OAAO;AACd,QAAK,MAAM,MAAM,8CAA8C,MAAM;;;CAIzE,yBAAsC;AACpC,OAAK,6BAA6B,kBAC1B;AACJ,QAAK,4BAA4B;KAEnC,MAAS,IACV;;CAGH,wBAAqC;AACnC,MAAI,KAAK,4BAA4B;AACnC,iBAAc,KAAK,2BAA2B;AAC9C,QAAK,6BAA6B,KAAA;;;CAItC,6BAA0C;AACxC,MAAI;GACF,MAAM,OAAO,KAAK,sBAAsB;AACxC,OAAI,KAAK,WAAW,EAClB;GAGF,MAAM,cAAc,KAAK,KAAK;AAC9B,QAAK,SAAS,QAAQ;IACpB,MAAM,QAAQ,IAAI,MAAM,IAAI;IAC5B,MAAM,aAAa,SAAS,MAAM,MAAM,SAAS,IAAI,GAAG;AAExD,QAAI,OAAO,MAAM,WAAW,EAAE;AAC5B,UAAK,MAAM,MACT,2CACA,WACD;AACD,UAAK,SAAS,WAAW,IAAI;;AAG/B,QAAI,cAAc,cAAc,KAAK,4BACnC;IAGF,MAAM,aAAa,KAAK,SAAS,QAAQ,IAAI;AAC7C,QAAI,CAAC,WAAY;AAEjB,QAAI;KACF,MAAM,QAAwB,EAAE;AAChC,UAAK,MAAM,cAAc,KAAK,MAAM,WAAW,EAAoB;MACjE,MAAM,OAAO,KAAK,gBAAgB,UAAU,WAAW,MAAM;OAC3D,MAAM,WAAW;OACjB,YAAY,WAAW;OACvB,OAAO,WAAW;OAClB,WAAW,WAAW;OACvB,CAAC;AACF,WAAK,UAAU,WAAW,OAAO;AACjC,WAAK,IAAI,WAAW,QAAQ;AAC5B,YAAM,KAAK,KAAgC;;AAG7C,SAAI,KAAK,yBAAyB,MAAM,SAAS,EAC/C,MAAK,sBAAsB,MAAM;aAE5B,GAAG;AACV,UAAK,MAAM,MAAM,oCAAoC,EAAE;;AAIzD,SAAK,SAAS,WAAW,IAAI;KAC7B;WACK,GAAG;AACV,QAAK,MAAM,MAAM,6CAA6C,EAAE;;;CAIpE,uBAAwC;EACtC,MAAM,OAAiB,EAAE;AACzB,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,KAAK;GAC7C,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,KAAK,WAAW,iCAAiC,CACnD,MAAK,KAAK,IAAI;;AAGlB,SAAO;;CAGT,UAAuB;AACrB,OAAK,uBAAuB"}

package/dist/utils/MXLSpanStorage/MXLSpanStorage.d.cts

@@ -1,42 +0,0 @@
-import { SpanSessionManagerInternal } from "../../managers/MXLSpanSessionManager/types.cjs";
-import { DiagLogger } from "@opentelemetry/api";
-import { ReadableSpan } from "@opentelemetry/sdk-trace-web";
-import { Resource } from "@opentelemetry/resources";
-
-//#region src/utils/MXLSpanStorage/MXLSpanStorage.d.ts
-interface SpanStorageOptions {
-  spanSessionManager: SpanSessionManagerInternal;
-  resource?: Resource;
-  storage?: Storage;
-  diag?: DiagLogger;
-  storedSpansExpireTimeoutMS?: number;
-  onExpiredSpansExport?: (spans: ReadableSpan[]) => void;
-}
-declare class MXLSpanStorage {
-  private readonly _noExportTracer;
-  private readonly _storage;
-  private readonly _diag;
-  private readonly _onExpiredSpansExport?;
-  private readonly _storedSpansExpireTimeoutMS;
-  private readonly _spanSessionManager;
-  private _checkExpiredSpansInterval?;
-  constructor({
-    resource,
-    storage,
-    diag: diagParam,
-    storedSpansExpireTimeoutMS,
-    // 1 hour
-    onExpiredSpansExport,
-    spanSessionManager
-  }: SpanStorageOptions);
-  storePendingSpans(sessionId: string, sessionSpan: ReadableSpan, pendingSpans: ReadableSpan[]): void;
-  clearStoredSpans(sessionId: string): void;
-  startExpiredSpansCheck(): void;
-  stopExpiredSpansCheck(): void;
-  checkAndExportExpiredSpans(): void;
-  _getPendingSpansKeys(): string[];
-  destroy(): void;
-}
-//#endregion
-export { MXLSpanStorage, SpanStorageOptions };
-//# sourceMappingURL=MXLSpanStorage.d.cts.map

package/dist/utils/MXLSpanStorage/MXLSpanStorage.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MXLSpanStorage.d.cts","names":[],"sources":["../../../src/utils/MXLSpanStorage/MXLSpanStorage.ts"],"mappings":";;;;;;UAYiB,kBAAA;EACf,kBAAA,EAAoB,0BAAA;EACpB,QAAA,GAAW,QAAA;EACX,OAAA,GAAU,OAAA;EACV,IAAA,GAAO,UAAA;EACP,0BAAA;EACA,oBAAA,IAAwB,KAAA,EAAO,YAAA;AAAA;AAAA,cAgBpB,cAAA;EAAA,iBACM,eAAA;EAAA,iBACA,QAAA;EAAA,iBACA,KAAA;EAAA,iBACA,qBAAA;EAAA,iBACA,2BAAA;EAAA,iBACA,mBAAA;EAAA,QACT,0BAAA;;IAGN,QAAA;IACA,OAAA;IACA,IAAA,EAAM,SAAA;IAGN,0BAAA;IAAA;IACA,oBAAA;IACA;EAAA,GACC,kBAAA;EAaI,iBAAA,CACL,SAAA,UACA,WAAA,EAAa,YAAA,EACb,YAAA,EAAc,YAAA;EA8BT,gBAAA,CAAiB,SAAA;EAajB,sBAAA,CAAA;EASA,qBAAA,CAAA;EAOA,0BAAA,CAAA;EAwDA,oBAAA,CAAA;EAWA,OAAA,CAAA;AAAA"}

package/dist/utils/MXLSpanStorage/MXLSpanStorage.d.ts

@@ -1,42 +0,0 @@
-import { SpanSessionManagerInternal } from "../../managers/MXLSpanSessionManager/types.js";
-import { DiagLogger } from "@opentelemetry/api";
-import { Resource } from "@opentelemetry/resources";
-import { ReadableSpan } from "@opentelemetry/sdk-trace-web";
-
-//#region src/utils/MXLSpanStorage/MXLSpanStorage.d.ts
-interface SpanStorageOptions {
-  spanSessionManager: SpanSessionManagerInternal;
-  resource?: Resource;
-  storage?: Storage;
-  diag?: DiagLogger;
-  storedSpansExpireTimeoutMS?: number;
-  onExpiredSpansExport?: (spans: ReadableSpan[]) => void;
-}
-declare class MXLSpanStorage {
-  private readonly _noExportTracer;
-  private readonly _storage;
-  private readonly _diag;
-  private readonly _onExpiredSpansExport?;
-  private readonly _storedSpansExpireTimeoutMS;
-  private readonly _spanSessionManager;
-  private _checkExpiredSpansInterval?;
-  constructor({
-    resource,
-    storage,
-    diag: diagParam,
-    storedSpansExpireTimeoutMS,
-    // 1 hour
-    onExpiredSpansExport,
-    spanSessionManager
-  }: SpanStorageOptions);
-  storePendingSpans(sessionId: string, sessionSpan: ReadableSpan, pendingSpans: ReadableSpan[]): void;
-  clearStoredSpans(sessionId: string): void;
-  startExpiredSpansCheck(): void;
-  stopExpiredSpansCheck(): void;
-  checkAndExportExpiredSpans(): void;
-  _getPendingSpansKeys(): string[];
-  destroy(): void;
-}
-//#endregion
-export { MXLSpanStorage, SpanStorageOptions };
-//# sourceMappingURL=MXLSpanStorage.d.ts.map

package/dist/utils/MXLSpanStorage/MXLSpanStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MXLSpanStorage.d.ts","names":[],"sources":["../../../src/utils/MXLSpanStorage/MXLSpanStorage.ts"],"mappings":";;;;;;UAYiB,kBAAA;EACf,kBAAA,EAAoB,0BAAA;EACpB,QAAA,GAAW,QAAA;EACX,OAAA,GAAU,OAAA;EACV,IAAA,GAAO,UAAA;EACP,0BAAA;EACA,oBAAA,IAAwB,KAAA,EAAO,YAAA;AAAA;AAAA,cAgBpB,cAAA;EAAA,iBACM,eAAA;EAAA,iBACA,QAAA;EAAA,iBACA,KAAA;EAAA,iBACA,qBAAA;EAAA,iBACA,2BAAA;EAAA,iBACA,mBAAA;EAAA,QACT,0BAAA;;IAGN,QAAA;IACA,OAAA;IACA,IAAA,EAAM,SAAA;IAGN,0BAAA;IAAA;IACA,oBAAA;IACA;EAAA,GACC,kBAAA;EAaI,iBAAA,CACL,SAAA,UACA,WAAA,EAAa,YAAA,EACb,YAAA,EAAc,YAAA;EA8BT,gBAAA,CAAiB,SAAA;EAajB,sBAAA,CAAA;EASA,qBAAA,CAAA;EAOA,0BAAA,CAAA;EAwDA,oBAAA,CAAA;EAWA,OAAA,CAAA;AAAA"}

package/dist/utils/MXLSpanStorage/MXLSpanStorage.js

@@ -1,114 +0,0 @@
-import { KEY_MXL_MAX_PENDING_SPANS_REACHED } from "../../constants/attributes.js";
-import { diag } from "@opentelemetry/api";
-import { emptyResource } from "@opentelemetry/resources";
-import { BasicTracerProvider } from "@opentelemetry/sdk-trace-web";
-//#region src/utils/MXLSpanStorage/MXLSpanStorage.ts
-const PENDING_SPANS_STORAGE_KEY_PREFIX = "mxl_pending_";
-const MAX_PENDING_SPANS_ITEMS = 10;
-var MXLSpanStorage = class {
-	_noExportTracer;
-	_storage;
-	_diag;
-	_onExpiredSpansExport;
-	_storedSpansExpireTimeoutMS;
-	_spanSessionManager;
-	_checkExpiredSpansInterval;
-	constructor({ resource = emptyResource(), storage = window.localStorage, diag: diagParam = diag.createComponentLogger({ namespace: "MXLSpanStorage" }), storedSpansExpireTimeoutMS = 3600 * 1e3, onExpiredSpansExport, spanSessionManager }) {
-		this._noExportTracer = new BasicTracerProvider({ resource }).getTracer("mxl-web-sdk-sessions");
-		this._storage = storage;
-		this._diag = diagParam;
-		this._storedSpansExpireTimeoutMS = storedSpansExpireTimeoutMS;
-		this._onExpiredSpansExport = onExpiredSpansExport;
-		this._spanSessionManager = spanSessionManager;
-		this.startExpiredSpansCheck();
-	}
-	storePendingSpans(sessionId, sessionSpan, pendingSpans) {
-		try {
-			this.clearStoredSpans(sessionId);
-			if (this._getPendingSpansKeys().length >= MAX_PENDING_SPANS_ITEMS) {
-				this._spanSessionManager.incrSessionCountForKey(KEY_MXL_MAX_PENDING_SPANS_REACHED);
-				this._diag.warn("Not storing pending spans as the max number of items was reached");
-				return;
-			}
-			const key = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_${Date.now()}`;
-			this._storage.setItem(key, JSON.stringify([sessionSpan, ...pendingSpans], (key, value) => key.startsWith("_") ? void 0 : value));
-			this._diag.debug(`Stored pending span: ${key}`);
-		} catch (error) {
-			this._diag.error("Failed to store spans to storage:", error);
-		}
-	}
-	clearStoredSpans(sessionId) {
-		try {
-			const prefix = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_`;
-			this._getPendingSpansKeys().forEach((key) => {
-				if (key.startsWith(prefix)) this._storage.removeItem(key);
-			});
-		} catch (error) {
-			this._diag.error("Failed to clear stored spans from storage:", error);
-		}
-	}
-	startExpiredSpansCheck() {
-		this._checkExpiredSpansInterval = setInterval(() => {
-			this.checkAndExportExpiredSpans();
-		}, 300 * 1e3);
-	}
-	stopExpiredSpansCheck() {
-		if (this._checkExpiredSpansInterval) {
-			clearInterval(this._checkExpiredSpansInterval);
-			this._checkExpiredSpansInterval = void 0;
-		}
-	}
-	checkAndExportExpiredSpans() {
-		try {
-			const keys = this._getPendingSpansKeys();
-			if (keys.length === 0) return;
-			const currentTime = Date.now();
-			keys.forEach((key) => {
-				const parts = key.split("_");
-				const storedTime = parseInt(parts[parts.length - 1], 10);
-				if (Number.isNaN(storedTime)) {
-					this._diag.error("Found invalid timestamp in stored span:", storedTime);
-					this._storage.removeItem(key);
-				}
-				if (currentTime - storedTime <= this._storedSpansExpireTimeoutMS) return;
-				const storedData = this._storage.getItem(key);
-				if (!storedData) return;
-				try {
-					const spans = [];
-					for (const storedSpan of JSON.parse(storedData)) {
-						const span = this._noExportTracer.startSpan(storedSpan.name, {
-							kind: storedSpan.kind,
-							attributes: storedSpan.attributes,
-							links: storedSpan.links,
-							startTime: storedSpan.startTime
-						});
-						span.setStatus(storedSpan.status);
-						span.end(storedSpan.endTime);
-						spans.push(span);
-					}
-					if (this._onExpiredSpansExport && spans.length > 0) this._onExpiredSpansExport(spans);
-				} catch (e) {
-					this._diag.error("Failed to process expired spans:", e);
-				}
-				this._storage.removeItem(key);
-			});
-		} catch (e) {
-			this._diag.error("Failed to check and export expired spans:", e);
-		}
-	}
-	_getPendingSpansKeys() {
-		const keys = [];
-		for (let i = 0; i < this._storage.length; i++) {
-			const key = this._storage.key(i);
-			if (key?.startsWith(PENDING_SPANS_STORAGE_KEY_PREFIX)) keys.push(key);
-		}
-		return keys;
-	}
-	destroy() {
-		this.stopExpiredSpansCheck();
-	}
-};
-//#endregion
-export { MXLSpanStorage };
-
-//# sourceMappingURL=MXLSpanStorage.js.map

package/dist/utils/MXLSpanStorage/MXLSpanStorage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MXLSpanStorage.js","names":[],"sources":["../../../src/utils/MXLSpanStorage/MXLSpanStorage.ts"],"sourcesContent":["import type { DiagLogger, Tracer } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { Resource } from '@opentelemetry/resources';\nimport { emptyResource } from '@opentelemetry/resources';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-web';\nimport { BasicTracerProvider } from '@opentelemetry/sdk-trace-web';\nimport { KEY_MXL_MAX_PENDING_SPANS_REACHED } from '../../constants';\nimport type { SpanSessionManagerInternal } from '../../managers';\n\nconst PENDING_SPANS_STORAGE_KEY_PREFIX = 'mxl_pending_';\nconst MAX_PENDING_SPANS_ITEMS = 10;\n\nexport interface SpanStorageOptions {\n  spanSessionManager: SpanSessionManagerInternal;\n  resource?: Resource;\n  storage?: Storage;\n  diag?: DiagLogger;\n  storedSpansExpireTimeoutMS?: number;\n  onExpiredSpansExport?: (spans: ReadableSpan[]) => void;\n}\n\n// MXLSpanStorage is used to keep pending spans that are not meant to be exported (yet) in localStorage,\n// and periodically checks whenever those stored spans are ready to be exported.\n// This functionality has some custom logic to be able to store these spans as JSONs and then recreate them back\n// that could eventually be improved. In particular the things that would need to be improved are:\n// - Avoid serializing as JSON and instead try to use a customExporter that produces the body as it was going to be\n//   sent over the wire (serialized, compressed, etc), and store that, so that later when it decides to export those,\n//   it's just using that body as a regular fetch call.\n// - Create a service worker that is responsible for tracking the pending spans and deciding when to actually export them.\n//   That way we would avoid a potential race condition where two different tabs would try to export the same data.\n// - Make this a more comprehensive component so that the MXLSessionBatchedSpanProcessor doesn't need to be in the\n//   middle of SpanSessionVisibilityInstrumentation and this component. Ideally this component would know when and how\n//   to take snapshots of the current pending spans and the current session span at any moment, so that the visibility\n//   instrumentation doesn't need to be telling that to the batch span processor.\nexport class MXLSpanStorage {\n  private readonly _noExportTracer: Tracer;\n  private readonly _storage: Storage;\n  private readonly _diag: DiagLogger;\n  private readonly _onExpiredSpansExport?: (spans: ReadableSpan[]) => void;\n  private readonly _storedSpansExpireTimeoutMS: number;\n  private readonly _spanSessionManager: SpanSessionManagerInternal;\n  private _checkExpiredSpansInterval?: ReturnType<typeof setInterval>;\n\n  public constructor({\n    resource = emptyResource(),\n    storage = window.localStorage,\n    diag: diagParam = diag.createComponentLogger({\n      namespace: 'MXLSpanStorage',\n    }),\n    storedSpansExpireTimeoutMS = 60 * 60 * 1000, // 1 hour\n    onExpiredSpansExport,\n    spanSessionManager,\n  }: SpanStorageOptions) {\n    this._noExportTracer = new BasicTracerProvider({ resource }).getTracer(\n      'mxl-web-sdk-sessions',\n    );\n    this._storage = storage;\n    this._diag = diagParam;\n    this._storedSpansExpireTimeoutMS = storedSpansExpireTimeoutMS;\n    this._onExpiredSpansExport = onExpiredSpansExport;\n    this._spanSessionManager = spanSessionManager;\n\n    this.startExpiredSpansCheck();\n  }\n\n  public storePendingSpans(\n    sessionId: string,\n    sessionSpan: ReadableSpan,\n    pendingSpans: ReadableSpan[],\n  ): void {\n    try {\n      // If this session was already stored, clear it first:\n      this.clearStoredSpans(sessionId);\n\n      if (this._getPendingSpansKeys().length >= MAX_PENDING_SPANS_ITEMS) {\n        this._spanSessionManager.incrSessionCountForKey(\n          KEY_MXL_MAX_PENDING_SPANS_REACHED,\n        );\n        this._diag.warn(\n          'Not storing pending spans as the max number of items was reached',\n        );\n        return;\n      }\n\n      const key = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_${Date.now()}`;\n      this._storage.setItem(\n        key,\n        JSON.stringify([sessionSpan, ...pendingSpans], (key, value) =>\n          key.startsWith('_') ? undefined : value,\n        ),\n      );\n\n      this._diag.debug(`Stored pending span: ${key}`);\n    } catch (error) {\n      this._diag.error('Failed to store spans to storage:', error);\n    }\n  }\n\n  public clearStoredSpans(sessionId: string): void {\n    try {\n      const prefix = `${PENDING_SPANS_STORAGE_KEY_PREFIX}${sessionId}_`;\n      this._getPendingSpansKeys().forEach((key) => {\n        if (key.startsWith(prefix)) {\n          this._storage.removeItem(key);\n        }\n      });\n    } catch (error) {\n      this._diag.error('Failed to clear stored spans from storage:', error);\n    }\n  }\n\n  public startExpiredSpansCheck(): void {\n    this._checkExpiredSpansInterval = setInterval(\n      () => {\n        this.checkAndExportExpiredSpans();\n      },\n      5 * 60 * 1000,\n    ); // Check every 5 minutes\n  }\n\n  public stopExpiredSpansCheck(): void {\n    if (this._checkExpiredSpansInterval) {\n      clearInterval(this._checkExpiredSpansInterval);\n      this._checkExpiredSpansInterval = undefined;\n    }\n  }\n\n  public checkAndExportExpiredSpans(): void {\n    try {\n      const keys = this._getPendingSpansKeys();\n      if (keys.length === 0) {\n        return;\n      }\n\n      const currentTime = Date.now();\n      keys.forEach((key) => {\n        const parts = key.split('_');\n        const storedTime = parseInt(parts[parts.length - 1], 10);\n\n        if (Number.isNaN(storedTime)) {\n          this._diag.error(\n            'Found invalid timestamp in stored span:',\n            storedTime,\n          );\n          this._storage.removeItem(key);\n        }\n\n        if (currentTime - storedTime <= this._storedSpansExpireTimeoutMS) {\n          return;\n        }\n\n        const storedData = this._storage.getItem(key);\n        if (!storedData) return;\n\n        try {\n          const spans: ReadableSpan[] = [];\n          for (const storedSpan of JSON.parse(storedData) as ReadableSpan[]) {\n            const span = this._noExportTracer.startSpan(storedSpan.name, {\n              kind: storedSpan.kind,\n              attributes: storedSpan.attributes,\n              links: storedSpan.links,\n              startTime: storedSpan.startTime,\n            });\n            span.setStatus(storedSpan.status);\n            span.end(storedSpan.endTime);\n            spans.push(span as unknown as ReadableSpan);\n          }\n\n          if (this._onExpiredSpansExport && spans.length > 0) {\n            this._onExpiredSpansExport(spans);\n          }\n        } catch (e) {\n          this._diag.error('Failed to process expired spans:', e);\n        }\n\n        // Always remove the storage item even if processing failed\n        this._storage.removeItem(key);\n      });\n    } catch (e) {\n      this._diag.error('Failed to check and export expired spans:', e);\n    }\n  }\n\n  public _getPendingSpansKeys(): string[] {\n    const keys: string[] = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(PENDING_SPANS_STORAGE_KEY_PREFIX)) {\n        keys.push(key);\n      }\n    }\n    return keys;\n  }\n\n  public destroy(): void {\n    this.stopExpiredSpansCheck();\n  }\n}\n"],"mappings":"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"}

package/dist/utils/MXLSpanStorage/index.cjs

@@ -1,3 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_utils_MXLSpanStorage_MXLSpanStorage = require("./MXLSpanStorage.cjs");
-exports.MXLSpanStorage = require_utils_MXLSpanStorage_MXLSpanStorage.MXLSpanStorage;

package/dist/utils/MXLSpanStorage/index.d.cts

@@ -1,2 +0,0 @@
-import { MXLSpanStorage, SpanStorageOptions } from "./MXLSpanStorage.cjs";
-export { MXLSpanStorage, type SpanStorageOptions };

package/dist/utils/MXLSpanStorage/index.d.ts

@@ -1,2 +0,0 @@
-import { MXLSpanStorage, SpanStorageOptions } from "./MXLSpanStorage.js";
-export { MXLSpanStorage, type SpanStorageOptions };

package/dist/utils/MXLSpanStorage/index.js

@@ -1,2 +0,0 @@
-import { MXLSpanStorage } from "./MXLSpanStorage.js";
-export { MXLSpanStorage };

package/dist/utils/MXLSpanStorage/types.d.cts

@@ -1,2 +0,0 @@
-import { SpanStorageOptions } from "./MXLSpanStorage.cjs";
-export { type SpanStorageOptions };

package/dist/utils/MXLSpanStorage/types.d.ts

@@ -1,2 +0,0 @@
-import { SpanStorageOptions } from "./MXLSpanStorage.js";
-export { type SpanStorageOptions };