@safaricom-mxl/web-sdk 0.0.0

package/dist/managers/MXLTraceManager/MXLExtendedSpan.d.cts

@@ -0,0 +1,34 @@
+import { ExtendedSpan, ExtendedSpanFailedOptions } from "../../api-traces/api/TraceAPI/types.cjs";
+import { AttributeValue, Attributes, Exception, Link, Span, SpanContext, SpanStatus, TimeInput } from "@opentelemetry/api";
+
+//#region src/managers/MXLTraceManager/MXLExtendedSpan.d.ts
+
+/**
+ * MXLSpan for the most part simply delegates to the underlying Span it receives on initialization so
+ * that it satisfies the Span interface. In addition, it gives us a spot where we can implement helpers that are part
+ * of the MXLSpan interface.
+ */
+declare class MXLExtendedSpan implements ExtendedSpan {
+  private readonly _span;
+  constructor(span: Span);
+  /**
+   * Expose attributes by extending OpenTelemetry's ReadableSpan.
+   */
+  get attributes(): Attributes;
+  addEvent(name: string, attributesOrStartTime?: Attributes | TimeInput, startTime?: TimeInput): this;
+  addLink(link: Link): this;
+  addLinks(links: Link[]): this;
+  end(endTime?: TimeInput): void;
+  isRecording(): boolean;
+  recordException(exception: Exception, time?: TimeInput): void;
+  setAttribute(key: string, value: AttributeValue): this;
+  setAttributes(attributes: Attributes): this;
+  removeAttribute(key: string): this;
+  setStatus(status: SpanStatus): this;
+  spanContext(): SpanContext;
+  updateName(name: string): this;
+  fail(options?: ExtendedSpanFailedOptions): void;
+}
+//#endregion
+export { MXLExtendedSpan };
+//# sourceMappingURL=MXLExtendedSpan.d.cts.map

package/dist/managers/MXLTraceManager/MXLExtendedSpan.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLExtendedSpan.d.cts","names":[],"sources":["../../../src/managers/MXLTraceManager/MXLExtendedSpan.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqBA;;;AAgB4B,cAhBf,eAAA,YAA2B,YAgBZ,CAAA;EAAa,iBAAA,KAAA;EACzB,WAAA,CAAA,IAAA,EAdW,IAcX;EAMO;;;EAkBa,IAAA,UAAA,CAAA,CAAA,EA/BT,UA+BS;EAAkB,QAAA,CAAA,IAAA,EAAA,MAAA,EAAA,qBAAA,CAAA,EAzB1B,UAyB0B,GAzBb,SAyBa,EAAA,SAAA,CAAA,EAxBtC,SAwBsC,CAAA,EAAA,IAAA;EAIZ,OAAA,CAAA,IAAA,EAtBnB,IAsBmB,CAAA,EAAA,IAAA;EAKP,QAAA,CAAA,KAAA,EAtBV,IAsBU,EAAA,CAAA,EAAA,IAAA;EAYR,GAAA,CAAA,OAAA,CAAA,EA7BJ,SA6BI,CAAA,EAAA,IAAA;EAKH,WAAA,CAAA,CAAA,EAAA,OAAA;EAUX,eAAA,CAAA,SAAA,EApCuB,SAoCvB,EAAA,IAAA,CAAA,EApCyC,SAoCzC,CAAA,EAAA,IAAA;EA7E2B,YAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EA6CE,cA7CF,CAAA,EAAA,IAAA;EAAY,aAAA,CAAA,UAAA,EAkDjB,UAlDiB,CAAA,EAAA,IAAA;;oBA8DzB;iBAKH;;iBAUX"}

package/dist/managers/MXLTraceManager/MXLExtendedSpan.d.ts

@@ -0,0 +1,35 @@
+import { ExtendedSpan, ExtendedSpanFailedOptions } from "../../api-traces/api/TraceAPI/types.js";
+import "../../api-traces/index.js";
+import { AttributeValue, Attributes, Exception, Link, Span, SpanContext, SpanStatus, TimeInput } from "@opentelemetry/api";
+
+//#region src/managers/MXLTraceManager/MXLExtendedSpan.d.ts
+
+/**
+ * MXLSpan for the most part simply delegates to the underlying Span it receives on initialization so
+ * that it satisfies the Span interface. In addition, it gives us a spot where we can implement helpers that are part
+ * of the MXLSpan interface.
+ */
+declare class MXLExtendedSpan implements ExtendedSpan {
+  private readonly _span;
+  constructor(span: Span);
+  /**
+   * Expose attributes by extending OpenTelemetry's ReadableSpan.
+   */
+  get attributes(): Attributes;
+  addEvent(name: string, attributesOrStartTime?: Attributes | TimeInput, startTime?: TimeInput): this;
+  addLink(link: Link): this;
+  addLinks(links: Link[]): this;
+  end(endTime?: TimeInput): void;
+  isRecording(): boolean;
+  recordException(exception: Exception, time?: TimeInput): void;
+  setAttribute(key: string, value: AttributeValue): this;
+  setAttributes(attributes: Attributes): this;
+  removeAttribute(key: string): this;
+  setStatus(status: SpanStatus): this;
+  spanContext(): SpanContext;
+  updateName(name: string): this;
+  fail(options?: ExtendedSpanFailedOptions): void;
+}
+//#endregion
+export { MXLExtendedSpan };
+//# sourceMappingURL=MXLExtendedSpan.d.ts.map

package/dist/managers/MXLTraceManager/MXLExtendedSpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLExtendedSpan.d.ts","names":[],"sources":["../../../src/managers/MXLTraceManager/MXLExtendedSpan.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAqBA;;AAU2B,cAVd,eAAA,YAA2B,YAUb,CAAA;EAMC,iBAAA,KAAA;EAAa,WAAA,CAAA,IAAA,EAbd,IAac;EACzB;;;EAgBO,IAAA,UAAA,CAAA,CAAA,EAvBI,UAuBJ;EAQa,QAAA,CAAA,IAAA,EAAA,MAAA,EAAA,qBAAA,CAAA,EAzBR,UAyBQ,GAzBK,SAyBL,EAAA,SAAA,CAAA,EAxBpB,SAwBoB,CAAA,EAAA,IAAA;EAAkB,OAAA,CAAA,IAAA,EAlB/B,IAkB+B,CAAA,EAAA,IAAA;EAIZ,QAAA,CAAA,KAAA,EAjBjB,IAiBiB,EAAA,CAAA,EAAA,IAAA;EAKP,GAAA,CAAA,OAAA,CAAA,EAjBZ,SAiBY,CAAA,EAAA,IAAA;EAYR,WAAA,CAAA,CAAA,EAAA,OAAA;EAKH,eAAA,CAAA,SAAA,EA1BY,SA0BZ,EAAA,IAAA,CAAA,EA1B8B,SA0B9B,CAAA,EAAA,IAAA;EAUX,YAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAhC6B,cAgC7B,CAAA,EAAA,IAAA;EA7E2B,aAAA,CAAA,UAAA,EAkDL,UAlDK,CAAA,EAAA,IAAA;EAAY,eAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,IAAA;oBA8DzB;iBAKH;;iBAUX"}

package/dist/managers/MXLTraceManager/MXLExtendedSpan.js

@@ -0,0 +1,73 @@
+import { KEY_EMB_ERROR_CODE } from "../../constants/attributes.js";
+
+//#region src/managers/MXLTraceManager/MXLExtendedSpan.ts
+/**
+* MXLSpan for the most part simply delegates to the underlying Span it receives on initialization so
+* that it satisfies the Span interface. In addition, it gives us a spot where we can implement helpers that are part
+* of the MXLSpan interface.
+*/
+var MXLExtendedSpan = class {
+	_span;
+	constructor(span) {
+		this._span = span;
+	}
+	/**
+	* Expose attributes by extending OpenTelemetry's ReadableSpan.
+	*/
+	get attributes() {
+		return this._span.attributes;
+	}
+	addEvent(name, attributesOrStartTime, startTime) {
+		this._span.addEvent(name, attributesOrStartTime, startTime);
+		return this;
+	}
+	addLink(link) {
+		this._span.addLink(link);
+		return this;
+	}
+	addLinks(links) {
+		this._span.addLinks(links);
+		return this;
+	}
+	end(endTime) {
+		this._span.end(endTime);
+	}
+	isRecording() {
+		return this._span.isRecording();
+	}
+	recordException(exception, time) {
+		this._span.recordException(exception, time);
+	}
+	setAttribute(key, value) {
+		this._span.setAttribute(key, value);
+		return this;
+	}
+	setAttributes(attributes) {
+		this._span.setAttributes(attributes);
+		return this;
+	}
+	removeAttribute(key) {
+		const { [key]: _, ...attributes } = this._span.attributes;
+		this._span.attributes = attributes;
+		return this;
+	}
+	setStatus(status) {
+		this._span.setStatus(status);
+		return this;
+	}
+	spanContext() {
+		return this._span.spanContext();
+	}
+	updateName(name) {
+		this._span.updateName(name);
+		return this;
+	}
+	fail(options = { code: "failure" }) {
+		if (options.code) this._span.setAttribute(KEY_EMB_ERROR_CODE, options.code.toUpperCase());
+		this._span.end(options.endTime);
+	}
+};
+
+//#endregion
+export { MXLExtendedSpan };
+//# sourceMappingURL=MXLExtendedSpan.js.map

package/dist/managers/MXLTraceManager/MXLExtendedSpan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLExtendedSpan.js","names":[],"sources":["../../../src/managers/MXLTraceManager/MXLExtendedSpan.ts"],"sourcesContent":["import type {\n  Attributes,\n  AttributeValue,\n  Exception,\n  Link,\n  Span,\n  SpanContext,\n  SpanStatus,\n  TimeInput,\n} from '@opentelemetry/api';\nimport type {\n  ExtendedSpan,\n  ExtendedSpanFailedOptions,\n} from '../../api-traces/index.ts';\nimport { KEY_EMB_ERROR_CODE } from '../../constants/index.ts';\n\n/**\n * MXLSpan for the most part simply delegates to the underlying Span it receives on initialization so\n * that it satisfies the Span interface. In addition, it gives us a spot where we can implement helpers that are part\n * of the MXLSpan interface.\n */\nexport class MXLExtendedSpan implements ExtendedSpan {\n  private readonly _span: ExtendedSpan;\n\n  public constructor(span: Span) {\n    this._span = span as ExtendedSpan;\n  }\n\n  /**\n   * Expose attributes by extending OpenTelemetry's ReadableSpan.\n   */\n  public get attributes(): Attributes {\n    return this._span.attributes;\n  }\n\n  public addEvent(\n    name: string,\n    attributesOrStartTime?: Attributes | TimeInput,\n    startTime?: TimeInput,\n  ): this {\n    this._span.addEvent(name, attributesOrStartTime, startTime);\n    return this;\n  }\n\n  public addLink(link: Link): this {\n    this._span.addLink(link);\n    return this;\n  }\n\n  public addLinks(links: Link[]): this {\n    this._span.addLinks(links);\n    return this;\n  }\n\n  public end(endTime?: TimeInput): void {\n    this._span.end(endTime);\n  }\n\n  public isRecording(): boolean {\n    return this._span.isRecording();\n  }\n\n  public recordException(exception: Exception, time?: TimeInput): void {\n    this._span.recordException(exception, time);\n  }\n\n  public setAttribute(key: string, value: AttributeValue): this {\n    this._span.setAttribute(key, value);\n    return this;\n  }\n\n  public setAttributes(attributes: Attributes): this {\n    this._span.setAttributes(attributes);\n    return this;\n  }\n\n  public removeAttribute(key: string): this {\n    const { [key]: _, ...attributes } = this._span.attributes;\n    // @ts-expect-error Read/write spans are allowed per the spec https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/sdk.md#additional-span-interfaces\n    this._span.attributes = attributes;\n    return this;\n  }\n\n  public setStatus(status: SpanStatus): this {\n    this._span.setStatus(status);\n    return this;\n  }\n\n  public spanContext(): SpanContext {\n    return this._span.spanContext();\n  }\n\n  public updateName(name: string): this {\n    this._span.updateName(name);\n    return this;\n  }\n\n  public fail(\n    options: ExtendedSpanFailedOptions = {\n      code: 'failure',\n    },\n  ): void {\n    if (options.code) {\n      this._span.setAttribute(KEY_EMB_ERROR_CODE, options.code.toUpperCase());\n    }\n\n    this._span.end(options.endTime);\n  }\n}\n"],"mappings":";;;;;;;;AAqBA,IAAa,kBAAb,MAAqD;CACnD,AAAiB;CAEjB,AAAO,YAAY,MAAY;AAC7B,OAAK,QAAQ;;;;;CAMf,IAAW,aAAyB;AAClC,SAAO,KAAK,MAAM;;CAGpB,AAAO,SACL,MACA,uBACA,WACM;AACN,OAAK,MAAM,SAAS,MAAM,uBAAuB,UAAU;AAC3D,SAAO;;CAGT,AAAO,QAAQ,MAAkB;AAC/B,OAAK,MAAM,QAAQ,KAAK;AACxB,SAAO;;CAGT,AAAO,SAAS,OAAqB;AACnC,OAAK,MAAM,SAAS,MAAM;AAC1B,SAAO;;CAGT,AAAO,IAAI,SAA2B;AACpC,OAAK,MAAM,IAAI,QAAQ;;CAGzB,AAAO,cAAuB;AAC5B,SAAO,KAAK,MAAM,aAAa;;CAGjC,AAAO,gBAAgB,WAAsB,MAAwB;AACnE,OAAK,MAAM,gBAAgB,WAAW,KAAK;;CAG7C,AAAO,aAAa,KAAa,OAA6B;AAC5D,OAAK,MAAM,aAAa,KAAK,MAAM;AACnC,SAAO;;CAGT,AAAO,cAAc,YAA8B;AACjD,OAAK,MAAM,cAAc,WAAW;AACpC,SAAO;;CAGT,AAAO,gBAAgB,KAAmB;EACxC,MAAM,GAAG,MAAM,GAAG,GAAG,eAAe,KAAK,MAAM;AAE/C,OAAK,MAAM,aAAa;AACxB,SAAO;;CAGT,AAAO,UAAU,QAA0B;AACzC,OAAK,MAAM,UAAU,OAAO;AAC5B,SAAO;;CAGT,AAAO,cAA2B;AAChC,SAAO,KAAK,MAAM,aAAa;;CAGjC,AAAO,WAAW,MAAoB;AACpC,OAAK,MAAM,WAAW,KAAK;AAC3B,SAAO;;CAGT,AAAO,KACL,UAAqC,EACnC,MAAM,WACP,EACK;AACN,MAAI,QAAQ,KACV,MAAK,MAAM,aAAa,oBAAoB,QAAQ,KAAK,aAAa,CAAC;AAGzE,OAAK,MAAM,IAAI,QAAQ,QAAQ"}

package/dist/managers/MXLTraceManager/MXLTraceManager.cjs

@@ -0,0 +1,27 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_constants_attributes = require('../../constants/attributes.cjs');
+const require_managers_MXLTraceManager_MXLExtendedSpan = require('./MXLExtendedSpan.cjs');
+let _opentelemetry_api = require("@opentelemetry/api");
+
+//#region src/managers/MXLTraceManager/MXLTraceManager.ts
+var MXLTraceManager = class {
+	_tracer;
+	constructor({ tracerProvider: globalTraceProviderOverride } = {}) {
+		this._tracer = (globalTraceProviderOverride ?? _opentelemetry_api.trace).getTracer("mxl-web-sdk-traces");
+	}
+	startSpan(name, options = {}, ctx) {
+		options.attributes = options.attributes ? options.attributes : {};
+		options.attributes[require_constants_attributes.KEY_EMB_TYPE] = require_constants_attributes.EMB_TYPES.Perf;
+		const activeContext = options.parentSpan ? _opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(), options.parentSpan) : ctx;
+		return new require_managers_MXLTraceManager_MXLExtendedSpan.MXLExtendedSpan(this._tracer.startSpan(name, options, activeContext));
+	}
+	setSpan = _opentelemetry_api.trace.setSpan;
+	getSpan(context$1) {
+		const span = _opentelemetry_api.trace.getSpan(context$1);
+		if (span) return new require_managers_MXLTraceManager_MXLExtendedSpan.MXLExtendedSpan(span);
+	}
+};
+
+//#endregion
+exports.MXLTraceManager = MXLTraceManager;
+//# sourceMappingURL=MXLTraceManager.cjs.map

package/dist/managers/MXLTraceManager/MXLTraceManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLTraceManager.cjs","names":["trace","KEY_EMB_TYPE","EMB_TYPES","context","MXLExtendedSpan"],"sources":["../../../src/managers/MXLTraceManager/MXLTraceManager.ts"],"sourcesContent":["import type { Context, Tracer } from '@opentelemetry/api';\nimport { context, trace } from '@opentelemetry/api';\nimport type {\n  ExtendedSpan,\n  ExtendedSpanOptions,\n  TraceManager,\n  TraceManagerArgs,\n} from '../../api-traces/index.ts';\nimport { EMB_TYPES, KEY_EMB_TYPE } from '../../constants/index.ts';\nimport { MXLExtendedSpan } from './MXLExtendedSpan.ts';\n\nexport class MXLTraceManager implements TraceManager {\n  private readonly _tracer: Tracer;\n\n  public constructor({\n    tracerProvider: globalTraceProviderOverride,\n  }: TraceManagerArgs = {}) {\n    const tracerProvider = globalTraceProviderOverride ?? trace;\n\n    this._tracer = tracerProvider.getTracer('mxl-web-sdk-traces');\n  }\n\n  public startSpan(\n    name: string,\n    options: ExtendedSpanOptions = {},\n    ctx?: Context,\n  ): ExtendedSpan {\n    options.attributes = options.attributes ? options.attributes : {};\n    options.attributes[KEY_EMB_TYPE] = EMB_TYPES.Perf;\n\n    const activeContext = options.parentSpan\n      ? trace.setSpan(context.active(), options.parentSpan)\n      : ctx;\n\n    return new MXLExtendedSpan(\n      this._tracer.startSpan(name, options, activeContext),\n    );\n  }\n\n  public setSpan: TraceManager['setSpan'] = trace.setSpan;\n\n  public getSpan(context: Context): ExtendedSpan | undefined {\n    const span = trace.getSpan(context);\n\n    if (span) {\n      return new MXLExtendedSpan(span);\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;AAWA,IAAa,kBAAb,MAAqD;CACnD,AAAiB;CAEjB,AAAO,YAAY,EACjB,gBAAgB,gCACI,EAAE,EAAE;AAGxB,OAAK,WAFkB,+BAA+BA,0BAExB,UAAU,qBAAqB;;CAG/D,AAAO,UACL,MACA,UAA+B,EAAE,EACjC,KACc;AACd,UAAQ,aAAa,QAAQ,aAAa,QAAQ,aAAa,EAAE;AACjE,UAAQ,WAAWC,6CAAgBC,uCAAU;EAE7C,MAAM,gBAAgB,QAAQ,aAC1BF,yBAAM,QAAQG,2BAAQ,QAAQ,EAAE,QAAQ,WAAW,GACnD;AAEJ,SAAO,IAAIC,iEACT,KAAK,QAAQ,UAAU,MAAM,SAAS,cAAc,CACrD;;CAGH,AAAO,UAAmCJ,yBAAM;CAEhD,AAAO,QAAQ,WAA4C;EACzD,MAAM,OAAOA,yBAAM,QAAQG,UAAQ;AAEnC,MAAI,KACF,QAAO,IAAIC,iEAAgB,KAAK"}

package/dist/managers/MXLTraceManager/MXLTraceManager.d.cts

@@ -0,0 +1,17 @@
+import { TraceManager, TraceManagerArgs } from "../../api-traces/manager/types.cjs";
+import { ExtendedSpan, ExtendedSpanOptions } from "../../api-traces/api/TraceAPI/types.cjs";
+import { Context } from "@opentelemetry/api";
+
+//#region src/managers/MXLTraceManager/MXLTraceManager.d.ts
+declare class MXLTraceManager implements TraceManager {
+  private readonly _tracer;
+  constructor({
+    tracerProvider: globalTraceProviderOverride
+  }?: TraceManagerArgs);
+  startSpan(name: string, options?: ExtendedSpanOptions, ctx?: Context): ExtendedSpan;
+  setSpan: TraceManager['setSpan'];
+  getSpan(context: Context): ExtendedSpan | undefined;
+}
+//#endregion
+export { MXLTraceManager };
+//# sourceMappingURL=MXLTraceManager.d.cts.map

package/dist/managers/MXLTraceManager/MXLTraceManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLTraceManager.d.cts","names":[],"sources":["../../../src/managers/MXLTraceManager/MXLTraceManager.ts"],"sourcesContent":[],"mappings":";;;;;cAWa,eAAA,YAA2B;;;oBAIpB;MACf;EALQ,SAAA,CAAA,IAAA,EAAA,MAAgB,EAAA,OAAA,CAAA,EAahB,mBAbgB,EAAA,GAAA,CAAA,EAcnB,OAdmB,CAAA,EAexB,YAfwB;EAIT,OAAA,EAwBF,YAxBE,CAAA,SAAA,CAAA;EACf,OAAA,CAAA,OAAA,EAyBqB,OAzBrB,CAAA,EAyB+B,YAzB/B,GAAA,SAAA"}

package/dist/managers/MXLTraceManager/MXLTraceManager.d.ts

@@ -0,0 +1,18 @@
+import { TraceManager, TraceManagerArgs } from "../../api-traces/manager/types.js";
+import { ExtendedSpan, ExtendedSpanOptions } from "../../api-traces/api/TraceAPI/types.js";
+import "../../api-traces/index.js";
+import { Context } from "@opentelemetry/api";
+
+//#region src/managers/MXLTraceManager/MXLTraceManager.d.ts
+declare class MXLTraceManager implements TraceManager {
+  private readonly _tracer;
+  constructor({
+    tracerProvider: globalTraceProviderOverride
+  }?: TraceManagerArgs);
+  startSpan(name: string, options?: ExtendedSpanOptions, ctx?: Context): ExtendedSpan;
+  setSpan: TraceManager['setSpan'];
+  getSpan(context: Context): ExtendedSpan | undefined;
+}
+//#endregion
+export { MXLTraceManager };
+//# sourceMappingURL=MXLTraceManager.d.ts.map

package/dist/managers/MXLTraceManager/MXLTraceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLTraceManager.d.ts","names":[],"sources":["../../../src/managers/MXLTraceManager/MXLTraceManager.ts"],"sourcesContent":[],"mappings":";;;;;;cAWa,eAAA,YAA2B;;;oBAIpB;MACf;oCAQQ,2BACH,UACL;EAfQ,OAAA,EA4BK,YA5BW,CAAA,SAAA,CAAA;EAIT,OAAA,CAAA,OAAA,EA0BM,OA1BN,CAAA,EA0BgB,YA1BhB,GAAA,SAAA"}

package/dist/managers/MXLTraceManager/MXLTraceManager.js

@@ -0,0 +1,26 @@
+import { EMB_TYPES, KEY_EMB_TYPE } from "../../constants/attributes.js";
+import { MXLExtendedSpan } from "./MXLExtendedSpan.js";
+import { context, trace } from "@opentelemetry/api";
+
+//#region src/managers/MXLTraceManager/MXLTraceManager.ts
+var MXLTraceManager = class {
+	_tracer;
+	constructor({ tracerProvider: globalTraceProviderOverride } = {}) {
+		this._tracer = (globalTraceProviderOverride ?? trace).getTracer("mxl-web-sdk-traces");
+	}
+	startSpan(name, options = {}, ctx) {
+		options.attributes = options.attributes ? options.attributes : {};
+		options.attributes[KEY_EMB_TYPE] = EMB_TYPES.Perf;
+		const activeContext = options.parentSpan ? trace.setSpan(context.active(), options.parentSpan) : ctx;
+		return new MXLExtendedSpan(this._tracer.startSpan(name, options, activeContext));
+	}
+	setSpan = trace.setSpan;
+	getSpan(context$1) {
+		const span = trace.getSpan(context$1);
+		if (span) return new MXLExtendedSpan(span);
+	}
+};
+
+//#endregion
+export { MXLTraceManager };
+//# sourceMappingURL=MXLTraceManager.js.map

package/dist/managers/MXLTraceManager/MXLTraceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLTraceManager.js","names":["context"],"sources":["../../../src/managers/MXLTraceManager/MXLTraceManager.ts"],"sourcesContent":["import type { Context, Tracer } from '@opentelemetry/api';\nimport { context, trace } from '@opentelemetry/api';\nimport type {\n  ExtendedSpan,\n  ExtendedSpanOptions,\n  TraceManager,\n  TraceManagerArgs,\n} from '../../api-traces/index.ts';\nimport { EMB_TYPES, KEY_EMB_TYPE } from '../../constants/index.ts';\nimport { MXLExtendedSpan } from './MXLExtendedSpan.ts';\n\nexport class MXLTraceManager implements TraceManager {\n  private readonly _tracer: Tracer;\n\n  public constructor({\n    tracerProvider: globalTraceProviderOverride,\n  }: TraceManagerArgs = {}) {\n    const tracerProvider = globalTraceProviderOverride ?? trace;\n\n    this._tracer = tracerProvider.getTracer('mxl-web-sdk-traces');\n  }\n\n  public startSpan(\n    name: string,\n    options: ExtendedSpanOptions = {},\n    ctx?: Context,\n  ): ExtendedSpan {\n    options.attributes = options.attributes ? options.attributes : {};\n    options.attributes[KEY_EMB_TYPE] = EMB_TYPES.Perf;\n\n    const activeContext = options.parentSpan\n      ? trace.setSpan(context.active(), options.parentSpan)\n      : ctx;\n\n    return new MXLExtendedSpan(\n      this._tracer.startSpan(name, options, activeContext),\n    );\n  }\n\n  public setSpan: TraceManager['setSpan'] = trace.setSpan;\n\n  public getSpan(context: Context): ExtendedSpan | undefined {\n    const span = trace.getSpan(context);\n\n    if (span) {\n      return new MXLExtendedSpan(span);\n    }\n\n    return undefined;\n  }\n}\n"],"mappings":";;;;;AAWA,IAAa,kBAAb,MAAqD;CACnD,AAAiB;CAEjB,AAAO,YAAY,EACjB,gBAAgB,gCACI,EAAE,EAAE;AAGxB,OAAK,WAFkB,+BAA+B,OAExB,UAAU,qBAAqB;;CAG/D,AAAO,UACL,MACA,UAA+B,EAAE,EACjC,KACc;AACd,UAAQ,aAAa,QAAQ,aAAa,QAAQ,aAAa,EAAE;AACjE,UAAQ,WAAW,gBAAgB,UAAU;EAE7C,MAAM,gBAAgB,QAAQ,aAC1B,MAAM,QAAQ,QAAQ,QAAQ,EAAE,QAAQ,WAAW,GACnD;AAEJ,SAAO,IAAI,gBACT,KAAK,QAAQ,UAAU,MAAM,SAAS,cAAc,CACrD;;CAGH,AAAO,UAAmC,MAAM;CAEhD,AAAO,QAAQ,WAA4C;EACzD,MAAM,OAAO,MAAM,QAAQA,UAAQ;AAEnC,MAAI,KACF,QAAO,IAAI,gBAAgB,KAAK"}

package/dist/managers/MXLTraceManager/index.cjs

@@ -0,0 +1,5 @@
+const require_managers_MXLTraceManager_MXLExtendedSpan = require('./MXLExtendedSpan.cjs');
+const require_managers_MXLTraceManager_MXLTraceManager = require('./MXLTraceManager.cjs');
+
+exports.MXLExtendedSpan = require_managers_MXLTraceManager_MXLExtendedSpan.MXLExtendedSpan;
+exports.MXLTraceManager = require_managers_MXLTraceManager_MXLTraceManager.MXLTraceManager;

package/dist/managers/MXLTraceManager/index.d.cts

@@ -0,0 +1,3 @@
+import { MXLExtendedSpan } from "./MXLExtendedSpan.cjs";
+import { MXLTraceManager } from "./MXLTraceManager.cjs";
+export { MXLExtendedSpan, MXLTraceManager };

package/dist/managers/MXLTraceManager/index.d.ts

@@ -0,0 +1,3 @@
+import { MXLExtendedSpan } from "./MXLExtendedSpan.js";
+import { MXLTraceManager } from "./MXLTraceManager.js";
+export { MXLExtendedSpan, MXLTraceManager };

package/dist/managers/MXLTraceManager/index.js

@@ -0,0 +1,4 @@
+import { MXLExtendedSpan } from "./MXLExtendedSpan.js";
+import { MXLTraceManager } from "./MXLTraceManager.js";
+
+export { MXLExtendedSpan, MXLTraceManager };

package/dist/managers/MXLUserManager/MXLUserManager.cjs

@@ -0,0 +1,101 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_utils_generateUUID = require('../../utils/generateUUID.cjs');
+const require_api_users_manager_constants_index = require('../../api-users/manager/constants/index.cjs');
+const require_managers_MXLUserManager_constants = require('./constants.cjs');
+const require_managers_MXLUserManager_types = require('./types.cjs');
+let _opentelemetry_api = require("@opentelemetry/api");
+
+//#region src/managers/MXLUserManager/MXLUserManager.ts
+var MXLUserManager = class {
+	_diag;
+	_storage;
+	_mxlUserId = null;
+	constructor({ diag: diagParam, storage = window.localStorage } = {}) {
+		this._diag = diagParam ?? _opentelemetry_api.diag.createComponentLogger({ namespace: "MXLUserManager" });
+		this._storage = storage;
+		this._migrateOldLocalStorageKey();
+		this._initialSetup();
+	}
+	getMXLUserId() {
+		return this._mxlUserId || this._generateNewMXLUserId();
+	}
+	setMXLUserId(userId) {
+		this._mxlUserId = userId;
+		try {
+			this._storage.setItem(require_managers_MXLUserManager_constants.MXL_USER_ID_STORAGE_KEY, userId);
+		} catch (e) {
+			this._diag.warn("Failed to persist user object for storage, keeping it in-memory only", e);
+		}
+	}
+	clearMXLUserId() {
+		this._mxlUserId = null;
+		try {
+			this._storage.removeItem(require_managers_MXLUserManager_constants.MXL_USER_ID_STORAGE_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to remove mxl user in storage", e);
+		}
+	}
+	_migrateOldLocalStorageKey() {
+		try {
+			const oldUserStorage = this._storage.getItem(require_managers_MXLUserManager_constants.MXL_USER_STORAGE_KEY_DEPRECATED);
+			if (oldUserStorage) {
+				const user = JSON.parse(oldUserStorage);
+				if (require_managers_MXLUserManager_types.isUser(user)) {
+					this._diag.debug("Migrating old user data from storage");
+					this._storage.setItem(require_managers_MXLUserManager_constants.MXL_USER_ID_STORAGE_KEY, user[require_api_users_manager_constants_index.KEY_ENDUSER_PSEUDO_ID]);
+					this._storage.removeItem(require_managers_MXLUserManager_constants.MXL_USER_STORAGE_KEY_DEPRECATED);
+				} else {
+					this._diag.warn("Invalid user data found in storage, clearing old user data");
+					this._storage.removeItem(require_managers_MXLUserManager_constants.MXL_USER_STORAGE_KEY_DEPRECATED);
+				}
+			}
+		} catch (e) {
+			this._diag.warn("Failed to get old user data from storage", e);
+		}
+	}
+	_initialSetup() {
+		try {
+			const mxlUserId = this._storage.getItem(require_managers_MXLUserManager_constants.MXL_USER_ID_STORAGE_KEY);
+			if (!mxlUserId) this._diag.debug("No existing user found in storage, creating a new one");
+			else if (require_managers_MXLUserManager_types.isUserId(mxlUserId)) this._mxlUserId = mxlUserId;
+			else {
+				this._diag.warn("Invalid mxl user id, generating a new one");
+				this.clearMXLUserId();
+			}
+		} catch (e) {
+			this._diag.warn("Failed to get mxl user id from storage, defaulting to a new one", e);
+		}
+		if (!this._mxlUserId) this._mxlUserId = this._generateNewMXLUserId();
+	}
+	_generateNewMXLUserId() {
+		const newUserId = require_utils_generateUUID.generateUUID();
+		this.setMXLUserId(newUserId);
+		return newUserId;
+	}
+	getUserId() {
+		try {
+			return this._storage.getItem(require_managers_MXLUserManager_constants.MXL_EXTERNAL_USER_ID_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to retrieve user id from storage", e);
+			return null;
+		}
+	}
+	setUserId(userId) {
+		try {
+			this._storage.setItem(require_managers_MXLUserManager_constants.MXL_EXTERNAL_USER_ID_KEY, userId);
+		} catch (e) {
+			this._diag.warn("Failed to store user id", e);
+		}
+	}
+	clearUserId() {
+		try {
+			this._storage.removeItem(require_managers_MXLUserManager_constants.MXL_EXTERNAL_USER_ID_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to clear user id", e);
+		}
+	}
+};
+
+//#endregion
+exports.MXLUserManager = MXLUserManager;
+//# sourceMappingURL=MXLUserManager.cjs.map

package/dist/managers/MXLUserManager/MXLUserManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLUserManager.cjs","names":["diag","MXL_USER_ID_STORAGE_KEY","MXL_USER_STORAGE_KEY_DEPRECATED","isUser","KEY_ENDUSER_PSEUDO_ID","isUserId","generateUUID","MXL_EXTERNAL_USER_ID_KEY"],"sources":["../../../src/managers/MXLUserManager/MXLUserManager.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { UserManagerInternal } from '../../api-users/index.ts';\nimport { KEY_ENDUSER_PSEUDO_ID } from '../../api-users/index.ts';\nimport { generateUUID } from '../../utils/index.ts';\nimport {\n  MXL_EXTERNAL_USER_ID_KEY,\n  MXL_USER_ID_STORAGE_KEY,\n  MXL_USER_STORAGE_KEY_DEPRECATED,\n} from './constants.ts';\nimport type { MXLUserManagerArgs } from './types.ts';\nimport { isUser, isUserId } from './types.ts';\n\nexport class MXLUserManager implements UserManagerInternal {\n  private readonly _diag: DiagLogger;\n  private readonly _storage: Storage;\n  private _mxlUserId: string | null = null;\n\n  public constructor({\n    diag: diagParam,\n    storage = window.localStorage,\n  }: MXLUserManagerArgs = {}) {\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLUserManager',\n      });\n    this._storage = storage;\n    this._migrateOldLocalStorageKey();\n    this._initialSetup();\n  }\n\n  // No need to make this API more complicated by returning string | null\n  // mxlUserId should never be null at this point, but just in case defaulting to a new one if is not present\n  public getMXLUserId(): string {\n    return this._mxlUserId || this._generateNewMXLUserId();\n  }\n\n  public setMXLUserId(userId: string) {\n    this._mxlUserId = userId;\n\n    try {\n      this._storage.setItem(MXL_USER_ID_STORAGE_KEY, userId);\n    } catch (e) {\n      this._diag.warn(\n        'Failed to persist user object for storage, keeping it in-memory only',\n        e,\n      );\n    }\n  }\n\n  public clearMXLUserId() {\n    this._mxlUserId = null;\n\n    try {\n      this._storage.removeItem(MXL_USER_ID_STORAGE_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to remove mxl user in storage', e);\n    }\n  }\n\n  // TODO: remove this by 01/08/2025. Two months should be enough time for users to migrate to the new storage key.\n  private _migrateOldLocalStorageKey() {\n    // Since we migrated from storing a User in localStorage to just the user id,\n    // we need to check if the old storage key exists and migrate it.\n    try {\n      const oldUserStorage = this._storage.getItem(\n        MXL_USER_STORAGE_KEY_DEPRECATED,\n      );\n\n      if (oldUserStorage) {\n        const user: unknown = JSON.parse(oldUserStorage);\n        if (isUser(user)) {\n          this._diag.debug('Migrating old user data from storage');\n          this._storage.setItem(\n            MXL_USER_ID_STORAGE_KEY,\n            user[KEY_ENDUSER_PSEUDO_ID],\n          );\n          this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);\n        } else {\n          this._diag.warn(\n            'Invalid user data found in storage, clearing old user data',\n          );\n          this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);\n        }\n      }\n    } catch (e) {\n      this._diag.warn('Failed to get old user data from storage', e);\n    }\n  }\n\n  private _initialSetup() {\n    try {\n      const mxlUserId = this._storage.getItem(MXL_USER_ID_STORAGE_KEY);\n      if (!mxlUserId) {\n        this._diag.debug(\n          'No existing user found in storage, creating a new one',\n        );\n      } else if (isUserId(mxlUserId)) {\n        this._mxlUserId = mxlUserId;\n      } else {\n        this._diag.warn('Invalid mxl user id, generating a new one');\n        this.clearMXLUserId();\n      }\n    } catch (e) {\n      this._diag.warn(\n        'Failed to get mxl user id from storage, defaulting to a new one',\n        e,\n      );\n    }\n\n    if (!this._mxlUserId) {\n      this._mxlUserId = this._generateNewMXLUserId();\n    }\n  }\n\n  private _generateNewMXLUserId() {\n    const newUserId = generateUUID();\n    this.setMXLUserId(newUserId);\n\n    return newUserId;\n  }\n\n  // This is the external user id that can be set by the user\n  public getUserId(): string | null {\n    try {\n      return this._storage.getItem(MXL_EXTERNAL_USER_ID_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to retrieve user id from storage', e);\n      return null;\n    }\n  }\n\n  // Use storage as source of truth so multiple tabs can share the same user id\n  public setUserId(userId: string): void {\n    try {\n      this._storage.setItem(MXL_EXTERNAL_USER_ID_KEY, userId);\n    } catch (e) {\n      this._diag.warn('Failed to store user id', e);\n    }\n  }\n\n  public clearUserId(): void {\n    try {\n      this._storage.removeItem(MXL_EXTERNAL_USER_ID_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to clear user id', e);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAaA,IAAa,iBAAb,MAA2D;CACzD,AAAiB;CACjB,AAAiB;CACjB,AAAQ,aAA4B;CAEpC,AAAO,YAAY,EACjB,MAAM,WACN,UAAU,OAAO,iBACK,EAAE,EAAE;AAC1B,OAAK,QACH,aACAA,wBAAK,sBAAsB,EACzB,WAAW,kBACZ,CAAC;AACJ,OAAK,WAAW;AAChB,OAAK,4BAA4B;AACjC,OAAK,eAAe;;CAKtB,AAAO,eAAuB;AAC5B,SAAO,KAAK,cAAc,KAAK,uBAAuB;;CAGxD,AAAO,aAAa,QAAgB;AAClC,OAAK,aAAa;AAElB,MAAI;AACF,QAAK,SAAS,QAAQC,mEAAyB,OAAO;WAC/C,GAAG;AACV,QAAK,MAAM,KACT,wEACA,EACD;;;CAIL,AAAO,iBAAiB;AACtB,OAAK,aAAa;AAElB,MAAI;AACF,QAAK,SAAS,WAAWA,kEAAwB;WAC1C,GAAG;AACV,QAAK,MAAM,KAAK,wCAAwC,EAAE;;;CAK9D,AAAQ,6BAA6B;AAGnC,MAAI;GACF,MAAM,iBAAiB,KAAK,SAAS,QACnCC,0EACD;AAED,OAAI,gBAAgB;IAClB,MAAM,OAAgB,KAAK,MAAM,eAAe;AAChD,QAAIC,6CAAO,KAAK,EAAE;AAChB,UAAK,MAAM,MAAM,uCAAuC;AACxD,UAAK,SAAS,QACZF,mEACA,KAAKG,iEACN;AACD,UAAK,SAAS,WAAWF,0EAAgC;WACpD;AACL,UAAK,MAAM,KACT,6DACD;AACD,UAAK,SAAS,WAAWA,0EAAgC;;;WAGtD,GAAG;AACV,QAAK,MAAM,KAAK,4CAA4C,EAAE;;;CAIlE,AAAQ,gBAAgB;AACtB,MAAI;GACF,MAAM,YAAY,KAAK,SAAS,QAAQD,kEAAwB;AAChE,OAAI,CAAC,UACH,MAAK,MAAM,MACT,wDACD;YACQI,+CAAS,UAAU,CAC5B,MAAK,aAAa;QACb;AACL,SAAK,MAAM,KAAK,4CAA4C;AAC5D,SAAK,gBAAgB;;WAEhB,GAAG;AACV,QAAK,MAAM,KACT,mEACA,EACD;;AAGH,MAAI,CAAC,KAAK,WACR,MAAK,aAAa,KAAK,uBAAuB;;CAIlD,AAAQ,wBAAwB;EAC9B,MAAM,YAAYC,yCAAc;AAChC,OAAK,aAAa,UAAU;AAE5B,SAAO;;CAIT,AAAO,YAA2B;AAChC,MAAI;AACF,UAAO,KAAK,SAAS,QAAQC,mEAAyB;WAC/C,GAAG;AACV,QAAK,MAAM,KAAK,2CAA2C,EAAE;AAC7D,UAAO;;;CAKX,AAAO,UAAU,QAAsB;AACrC,MAAI;AACF,QAAK,SAAS,QAAQA,oEAA0B,OAAO;WAChD,GAAG;AACV,QAAK,MAAM,KAAK,2BAA2B,EAAE;;;CAIjD,AAAO,cAAoB;AACzB,MAAI;AACF,QAAK,SAAS,WAAWA,mEAAyB;WAC3C,GAAG;AACV,QAAK,MAAM,KAAK,2BAA2B,EAAE"}

package/dist/managers/MXLUserManager/MXLUserManager.d.cts

@@ -0,0 +1,25 @@
+import { UserManagerInternal } from "../../api-users/manager/types.cjs";
+import { MXLUserManagerArgs } from "./types.cjs";
+
+//#region src/managers/MXLUserManager/MXLUserManager.d.ts
+declare class MXLUserManager implements UserManagerInternal {
+  private readonly _diag;
+  private readonly _storage;
+  private _mxlUserId;
+  constructor({
+    diag: diagParam,
+    storage
+  }?: MXLUserManagerArgs);
+  getMXLUserId(): string;
+  setMXLUserId(userId: string): void;
+  clearMXLUserId(): void;
+  private _migrateOldLocalStorageKey;
+  private _initialSetup;
+  private _generateNewMXLUserId;
+  getUserId(): string | null;
+  setUserId(userId: string): void;
+  clearUserId(): void;
+}
+//#endregion
+export { MXLUserManager };
+//# sourceMappingURL=MXLUserManager.d.cts.map

package/dist/managers/MXLUserManager/MXLUserManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLUserManager.d.cts","names":[],"sources":["../../../src/managers/MXLUserManager/MXLUserManager.ts"],"sourcesContent":[],"mappings":";;;;cAaa,cAAA,YAA0B;;EAA1B,iBAAe,QAAA;EAMlB,QAAA,UAAA;EACN,WAAA,CAAA;IAAA,IAAA,EADM,SACN;IAAA;EAAA,CAAA,CAAA,EACC,kBADD;EACC,YAAA,CAAA,CAAA,EAAA,MAAA;EARkC,YAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAmB,cAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/managers/MXLUserManager/MXLUserManager.d.ts

@@ -0,0 +1,25 @@
+import { UserManagerInternal } from "../../api-users/manager/types.js";
+import { MXLUserManagerArgs } from "./types.js";
+
+//#region src/managers/MXLUserManager/MXLUserManager.d.ts
+declare class MXLUserManager implements UserManagerInternal {
+  private readonly _diag;
+  private readonly _storage;
+  private _mxlUserId;
+  constructor({
+    diag: diagParam,
+    storage
+  }?: MXLUserManagerArgs);
+  getMXLUserId(): string;
+  setMXLUserId(userId: string): void;
+  clearMXLUserId(): void;
+  private _migrateOldLocalStorageKey;
+  private _initialSetup;
+  private _generateNewMXLUserId;
+  getUserId(): string | null;
+  setUserId(userId: string): void;
+  clearUserId(): void;
+}
+//#endregion
+export { MXLUserManager };
+//# sourceMappingURL=MXLUserManager.d.ts.map

package/dist/managers/MXLUserManager/MXLUserManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLUserManager.d.ts","names":[],"sources":["../../../src/managers/MXLUserManager/MXLUserManager.ts"],"sourcesContent":[],"mappings":";;;;cAaa,cAAA,YAA0B;;EAA1B,iBAAe,QAAA;EAMlB,QAAA,UAAA;EACN,WAAA,CAAA;IAAA,IAAA,EADM,SACN;IAAA;EAAA,CAAA,CAAA,EACC,kBADD;EACC,YAAA,CAAA,CAAA,EAAA,MAAA;EARkC,YAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAmB,cAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/managers/MXLUserManager/MXLUserManager.js

@@ -0,0 +1,100 @@
+import { generateUUID } from "../../utils/generateUUID.js";
+import { KEY_ENDUSER_PSEUDO_ID } from "../../api-users/manager/constants/index.js";
+import { MXL_EXTERNAL_USER_ID_KEY, MXL_USER_ID_STORAGE_KEY, MXL_USER_STORAGE_KEY_DEPRECATED } from "./constants.js";
+import { isUser, isUserId } from "./types.js";
+import { diag } from "@opentelemetry/api";
+
+//#region src/managers/MXLUserManager/MXLUserManager.ts
+var MXLUserManager = class {
+	_diag;
+	_storage;
+	_mxlUserId = null;
+	constructor({ diag: diagParam, storage = window.localStorage } = {}) {
+		this._diag = diagParam ?? diag.createComponentLogger({ namespace: "MXLUserManager" });
+		this._storage = storage;
+		this._migrateOldLocalStorageKey();
+		this._initialSetup();
+	}
+	getMXLUserId() {
+		return this._mxlUserId || this._generateNewMXLUserId();
+	}
+	setMXLUserId(userId) {
+		this._mxlUserId = userId;
+		try {
+			this._storage.setItem(MXL_USER_ID_STORAGE_KEY, userId);
+		} catch (e) {
+			this._diag.warn("Failed to persist user object for storage, keeping it in-memory only", e);
+		}
+	}
+	clearMXLUserId() {
+		this._mxlUserId = null;
+		try {
+			this._storage.removeItem(MXL_USER_ID_STORAGE_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to remove mxl user in storage", e);
+		}
+	}
+	_migrateOldLocalStorageKey() {
+		try {
+			const oldUserStorage = this._storage.getItem(MXL_USER_STORAGE_KEY_DEPRECATED);
+			if (oldUserStorage) {
+				const user = JSON.parse(oldUserStorage);
+				if (isUser(user)) {
+					this._diag.debug("Migrating old user data from storage");
+					this._storage.setItem(MXL_USER_ID_STORAGE_KEY, user[KEY_ENDUSER_PSEUDO_ID]);
+					this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);
+				} else {
+					this._diag.warn("Invalid user data found in storage, clearing old user data");
+					this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);
+				}
+			}
+		} catch (e) {
+			this._diag.warn("Failed to get old user data from storage", e);
+		}
+	}
+	_initialSetup() {
+		try {
+			const mxlUserId = this._storage.getItem(MXL_USER_ID_STORAGE_KEY);
+			if (!mxlUserId) this._diag.debug("No existing user found in storage, creating a new one");
+			else if (isUserId(mxlUserId)) this._mxlUserId = mxlUserId;
+			else {
+				this._diag.warn("Invalid mxl user id, generating a new one");
+				this.clearMXLUserId();
+			}
+		} catch (e) {
+			this._diag.warn("Failed to get mxl user id from storage, defaulting to a new one", e);
+		}
+		if (!this._mxlUserId) this._mxlUserId = this._generateNewMXLUserId();
+	}
+	_generateNewMXLUserId() {
+		const newUserId = generateUUID();
+		this.setMXLUserId(newUserId);
+		return newUserId;
+	}
+	getUserId() {
+		try {
+			return this._storage.getItem(MXL_EXTERNAL_USER_ID_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to retrieve user id from storage", e);
+			return null;
+		}
+	}
+	setUserId(userId) {
+		try {
+			this._storage.setItem(MXL_EXTERNAL_USER_ID_KEY, userId);
+		} catch (e) {
+			this._diag.warn("Failed to store user id", e);
+		}
+	}
+	clearUserId() {
+		try {
+			this._storage.removeItem(MXL_EXTERNAL_USER_ID_KEY);
+		} catch (e) {
+			this._diag.warn("Failed to clear user id", e);
+		}
+	}
+};
+
+//#endregion
+export { MXLUserManager };
+//# sourceMappingURL=MXLUserManager.js.map

package/dist/managers/MXLUserManager/MXLUserManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXLUserManager.js","names":[],"sources":["../../../src/managers/MXLUserManager/MXLUserManager.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\nimport type { UserManagerInternal } from '../../api-users/index.ts';\nimport { KEY_ENDUSER_PSEUDO_ID } from '../../api-users/index.ts';\nimport { generateUUID } from '../../utils/index.ts';\nimport {\n  MXL_EXTERNAL_USER_ID_KEY,\n  MXL_USER_ID_STORAGE_KEY,\n  MXL_USER_STORAGE_KEY_DEPRECATED,\n} from './constants.ts';\nimport type { MXLUserManagerArgs } from './types.ts';\nimport { isUser, isUserId } from './types.ts';\n\nexport class MXLUserManager implements UserManagerInternal {\n  private readonly _diag: DiagLogger;\n  private readonly _storage: Storage;\n  private _mxlUserId: string | null = null;\n\n  public constructor({\n    diag: diagParam,\n    storage = window.localStorage,\n  }: MXLUserManagerArgs = {}) {\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({\n        namespace: 'MXLUserManager',\n      });\n    this._storage = storage;\n    this._migrateOldLocalStorageKey();\n    this._initialSetup();\n  }\n\n  // No need to make this API more complicated by returning string | null\n  // mxlUserId should never be null at this point, but just in case defaulting to a new one if is not present\n  public getMXLUserId(): string {\n    return this._mxlUserId || this._generateNewMXLUserId();\n  }\n\n  public setMXLUserId(userId: string) {\n    this._mxlUserId = userId;\n\n    try {\n      this._storage.setItem(MXL_USER_ID_STORAGE_KEY, userId);\n    } catch (e) {\n      this._diag.warn(\n        'Failed to persist user object for storage, keeping it in-memory only',\n        e,\n      );\n    }\n  }\n\n  public clearMXLUserId() {\n    this._mxlUserId = null;\n\n    try {\n      this._storage.removeItem(MXL_USER_ID_STORAGE_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to remove mxl user in storage', e);\n    }\n  }\n\n  // TODO: remove this by 01/08/2025. Two months should be enough time for users to migrate to the new storage key.\n  private _migrateOldLocalStorageKey() {\n    // Since we migrated from storing a User in localStorage to just the user id,\n    // we need to check if the old storage key exists and migrate it.\n    try {\n      const oldUserStorage = this._storage.getItem(\n        MXL_USER_STORAGE_KEY_DEPRECATED,\n      );\n\n      if (oldUserStorage) {\n        const user: unknown = JSON.parse(oldUserStorage);\n        if (isUser(user)) {\n          this._diag.debug('Migrating old user data from storage');\n          this._storage.setItem(\n            MXL_USER_ID_STORAGE_KEY,\n            user[KEY_ENDUSER_PSEUDO_ID],\n          );\n          this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);\n        } else {\n          this._diag.warn(\n            'Invalid user data found in storage, clearing old user data',\n          );\n          this._storage.removeItem(MXL_USER_STORAGE_KEY_DEPRECATED);\n        }\n      }\n    } catch (e) {\n      this._diag.warn('Failed to get old user data from storage', e);\n    }\n  }\n\n  private _initialSetup() {\n    try {\n      const mxlUserId = this._storage.getItem(MXL_USER_ID_STORAGE_KEY);\n      if (!mxlUserId) {\n        this._diag.debug(\n          'No existing user found in storage, creating a new one',\n        );\n      } else if (isUserId(mxlUserId)) {\n        this._mxlUserId = mxlUserId;\n      } else {\n        this._diag.warn('Invalid mxl user id, generating a new one');\n        this.clearMXLUserId();\n      }\n    } catch (e) {\n      this._diag.warn(\n        'Failed to get mxl user id from storage, defaulting to a new one',\n        e,\n      );\n    }\n\n    if (!this._mxlUserId) {\n      this._mxlUserId = this._generateNewMXLUserId();\n    }\n  }\n\n  private _generateNewMXLUserId() {\n    const newUserId = generateUUID();\n    this.setMXLUserId(newUserId);\n\n    return newUserId;\n  }\n\n  // This is the external user id that can be set by the user\n  public getUserId(): string | null {\n    try {\n      return this._storage.getItem(MXL_EXTERNAL_USER_ID_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to retrieve user id from storage', e);\n      return null;\n    }\n  }\n\n  // Use storage as source of truth so multiple tabs can share the same user id\n  public setUserId(userId: string): void {\n    try {\n      this._storage.setItem(MXL_EXTERNAL_USER_ID_KEY, userId);\n    } catch (e) {\n      this._diag.warn('Failed to store user id', e);\n    }\n  }\n\n  public clearUserId(): void {\n    try {\n      this._storage.removeItem(MXL_EXTERNAL_USER_ID_KEY);\n    } catch (e) {\n      this._diag.warn('Failed to clear user id', e);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAaA,IAAa,iBAAb,MAA2D;CACzD,AAAiB;CACjB,AAAiB;CACjB,AAAQ,aAA4B;CAEpC,AAAO,YAAY,EACjB,MAAM,WACN,UAAU,OAAO,iBACK,EAAE,EAAE;AAC1B,OAAK,QACH,aACA,KAAK,sBAAsB,EACzB,WAAW,kBACZ,CAAC;AACJ,OAAK,WAAW;AAChB,OAAK,4BAA4B;AACjC,OAAK,eAAe;;CAKtB,AAAO,eAAuB;AAC5B,SAAO,KAAK,cAAc,KAAK,uBAAuB;;CAGxD,AAAO,aAAa,QAAgB;AAClC,OAAK,aAAa;AAElB,MAAI;AACF,QAAK,SAAS,QAAQ,yBAAyB,OAAO;WAC/C,GAAG;AACV,QAAK,MAAM,KACT,wEACA,EACD;;;CAIL,AAAO,iBAAiB;AACtB,OAAK,aAAa;AAElB,MAAI;AACF,QAAK,SAAS,WAAW,wBAAwB;WAC1C,GAAG;AACV,QAAK,MAAM,KAAK,wCAAwC,EAAE;;;CAK9D,AAAQ,6BAA6B;AAGnC,MAAI;GACF,MAAM,iBAAiB,KAAK,SAAS,QACnC,gCACD;AAED,OAAI,gBAAgB;IAClB,MAAM,OAAgB,KAAK,MAAM,eAAe;AAChD,QAAI,OAAO,KAAK,EAAE;AAChB,UAAK,MAAM,MAAM,uCAAuC;AACxD,UAAK,SAAS,QACZ,yBACA,KAAK,uBACN;AACD,UAAK,SAAS,WAAW,gCAAgC;WACpD;AACL,UAAK,MAAM,KACT,6DACD;AACD,UAAK,SAAS,WAAW,gCAAgC;;;WAGtD,GAAG;AACV,QAAK,MAAM,KAAK,4CAA4C,EAAE;;;CAIlE,AAAQ,gBAAgB;AACtB,MAAI;GACF,MAAM,YAAY,KAAK,SAAS,QAAQ,wBAAwB;AAChE,OAAI,CAAC,UACH,MAAK,MAAM,MACT,wDACD;YACQ,SAAS,UAAU,CAC5B,MAAK,aAAa;QACb;AACL,SAAK,MAAM,KAAK,4CAA4C;AAC5D,SAAK,gBAAgB;;WAEhB,GAAG;AACV,QAAK,MAAM,KACT,mEACA,EACD;;AAGH,MAAI,CAAC,KAAK,WACR,MAAK,aAAa,KAAK,uBAAuB;;CAIlD,AAAQ,wBAAwB;EAC9B,MAAM,YAAY,cAAc;AAChC,OAAK,aAAa,UAAU;AAE5B,SAAO;;CAIT,AAAO,YAA2B;AAChC,MAAI;AACF,UAAO,KAAK,SAAS,QAAQ,yBAAyB;WAC/C,GAAG;AACV,QAAK,MAAM,KAAK,2CAA2C,EAAE;AAC7D,UAAO;;;CAKX,AAAO,UAAU,QAAsB;AACrC,MAAI;AACF,QAAK,SAAS,QAAQ,0BAA0B,OAAO;WAChD,GAAG;AACV,QAAK,MAAM,KAAK,2BAA2B,EAAE;;;CAIjD,AAAO,cAAoB;AACzB,MAAI;AACF,QAAK,SAAS,WAAW,yBAAyB;WAC3C,GAAG;AACV,QAAK,MAAM,KAAK,2BAA2B,EAAE"}

package/dist/managers/MXLUserManager/constants.cjs

@@ -0,0 +1,11 @@
+
+//#region src/managers/MXLUserManager/constants.ts
+const MXL_USER_STORAGE_KEY_DEPRECATED = "mxl_user";
+const MXL_USER_ID_STORAGE_KEY = "mxl_user_id";
+const MXL_EXTERNAL_USER_ID_KEY = "mxl_external_user_id";
+
+//#endregion
+exports.MXL_EXTERNAL_USER_ID_KEY = MXL_EXTERNAL_USER_ID_KEY;
+exports.MXL_USER_ID_STORAGE_KEY = MXL_USER_ID_STORAGE_KEY;
+exports.MXL_USER_STORAGE_KEY_DEPRECATED = MXL_USER_STORAGE_KEY_DEPRECATED;
+//# sourceMappingURL=constants.cjs.map

package/dist/managers/MXLUserManager/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/managers/MXLUserManager/constants.ts"],"sourcesContent":["export const MXL_USER_STORAGE_KEY_DEPRECATED = 'mxl_user';\nexport const MXL_USER_ID_STORAGE_KEY = 'mxl_user_id';\nexport const MXL_EXTERNAL_USER_ID_KEY = 'mxl_external_user_id';\n"],"mappings":";;AAAA,MAAa,kCAAkC;AAC/C,MAAa,0BAA0B;AACvC,MAAa,2BAA2B"}

package/dist/managers/MXLUserManager/constants.d.cts

@@ -0,0 +1,7 @@
+//#region src/managers/MXLUserManager/constants.d.ts
+declare const MXL_USER_STORAGE_KEY_DEPRECATED = "mxl_user";
+declare const MXL_USER_ID_STORAGE_KEY = "mxl_user_id";
+declare const MXL_EXTERNAL_USER_ID_KEY = "mxl_external_user_id";
+//#endregion
+export { MXL_EXTERNAL_USER_ID_KEY, MXL_USER_ID_STORAGE_KEY, MXL_USER_STORAGE_KEY_DEPRECATED };
+//# sourceMappingURL=constants.d.cts.map

package/dist/managers/MXLUserManager/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","names":[],"sources":["../../../src/managers/MXLUserManager/constants.ts"],"sourcesContent":[],"mappings":";cAAa,+BAAA;AAAA,cACA,uBAAA,GAD+B,aAAA;AAC/B,cACA,wBAAA,GADuB,sBAAA"}

package/dist/managers/MXLUserManager/constants.d.ts

@@ -0,0 +1,7 @@
+//#region src/managers/MXLUserManager/constants.d.ts
+declare const MXL_USER_STORAGE_KEY_DEPRECATED = "mxl_user";
+declare const MXL_USER_ID_STORAGE_KEY = "mxl_user_id";
+declare const MXL_EXTERNAL_USER_ID_KEY = "mxl_external_user_id";
+//#endregion
+export { MXL_EXTERNAL_USER_ID_KEY, MXL_USER_ID_STORAGE_KEY, MXL_USER_STORAGE_KEY_DEPRECATED };
+//# sourceMappingURL=constants.d.ts.map

package/dist/managers/MXLUserManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../../src/managers/MXLUserManager/constants.ts"],"sourcesContent":[],"mappings":";cAAa,+BAAA;AAAA,cACA,uBAAA,GAD+B,aAAA;AAC/B,cACA,wBAAA,GADuB,sBAAA"}