@safaricom-mxl/web-sdk 0.0.12 → 0.0.13

package/dist/transport/RetryingTransport/RetryingTransport.cjs

@@ -1,12 +1,11 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils_PerformanceManager_OTelPerformanceManager = require('../../utils/PerformanceManager/OTelPerformanceManager.cjs');
-const require_transport_RetryingTransport_constants = require('./constants.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_PerformanceManager_OTelPerformanceManager = require("../../utils/PerformanceManager/OTelPerformanceManager.cjs");
+const require_transport_RetryingTransport_constants = require("./constants.cjs");
 //#region src/transport/RetryingTransport/RetryingTransport.ts
 /**
 * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]
 */
-const getJitter = () => Math.random() * (2 * require_transport_RetryingTransport_constants.JITTER) - require_transport_RetryingTransport_constants.JITTER;
+const getJitter = () => Math.random() * 40 - 20;
 var RetryingTransport = class {
 	constructor(_transport, _perf = new require_utils_PerformanceManager_OTelPerformanceManager.OTelPerformanceManager()) {
 		this._transport = _transport;
@@ -15,7 +14,7 @@ var RetryingTransport = class {
 	async send(data, timeoutMillis) {
 		const deadline = this._perf.getNowMillis() + timeoutMillis;
 		let result = await this._transport.send(data, timeoutMillis);
-		let attempts = require_transport_RetryingTransport_constants.MAX_ATTEMPTS;
+		let attempts = 5;
 		let nextBackoff = require_transport_RetryingTransport_constants.INITIAL_BACKOFF;
 		while (result.status === "retryable" && attempts > 0) {
 			attempts--;
@@ -39,7 +38,7 @@ var RetryingTransport = class {
 		});
 	}
 };
-
 //#endregion
 exports.RetryingTransport = RetryingTransport;
+
 //# sourceMappingURL=RetryingTransport.cjs.map

package/dist/transport/RetryingTransport/RetryingTransport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"RetryingTransport.cjs","names":["JITTER","OTelPerformanceManager","MAX_ATTEMPTS","INITIAL_BACKOFF","MAX_BACKOFF","BACKOFF_MULTIPLIER"],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"sourcesContent":["import type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { PerformanceManager } from '../../utils/index.ts';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants.ts';\n\n/**\n * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]\n */\nconst getJitter = () => Math.random() * (2 * JITTER) - JITTER;\n\n// Taken directly from open-telemetry/opentelemetry-js/experimental/packages/otlp-exporter-base/src/retrying-transport.ts\n// File is not exposed externally\n\n/*\n * Copyright The OpenTelemetry Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport class RetryingTransport implements IExporterTransport {\n  public constructor(\n    private readonly _transport: IExporterTransport,\n    private readonly _perf: PerformanceManager = new OTelPerformanceManager(),\n  ) {}\n\n  public async send(\n    data: Uint8Array,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    const deadline = this._perf.getNowMillis() + timeoutMillis;\n    let result = await this._transport.send(data, timeoutMillis);\n    let attempts = MAX_ATTEMPTS;\n    let nextBackoff = INITIAL_BACKOFF;\n\n    while (result.status === 'retryable' && attempts > 0) {\n      attempts--;\n\n      // use maximum of computed backoff and 0 to avoid negative timeouts\n      const backoff = Math.max(\n        Math.min(nextBackoff, MAX_BACKOFF) + getJitter(),\n        0,\n      );\n      nextBackoff = nextBackoff * BACKOFF_MULTIPLIER;\n      const retryInMillis = result.retryInMillis ?? backoff;\n\n      // return when expected retry time is after the export deadline.\n      const remainingTimeoutMillis = deadline - this._perf.getNowMillis();\n      if (retryInMillis > remainingTimeoutMillis) {\n        return result;\n      }\n\n      result = await this._retry(data, remainingTimeoutMillis, retryInMillis);\n    }\n\n    return result;\n  }\n\n  public shutdown() {\n    this._transport.shutdown();\n  }\n\n  private _retry(\n    data: Uint8Array,\n    timeoutMillis: number,\n    inMillis: number,\n  ): Promise<ExportResponse> {\n    return new Promise((resolve, reject) => {\n      setTimeout(() => {\n        this._transport.send(data, timeoutMillis).then(resolve, reject);\n      }, inMillis);\n    });\n  }\n}\n"],"mappings":";;;;;;;;AAiBA,MAAM,kBAAkB,KAAK,QAAQ,IAAI,IAAIA,wDAAUA;AAoBvD,IAAa,oBAAb,MAA6D;CAC3D,AAAO,YACL,AAAiB,YACjB,AAAiB,QAA4B,IAAIC,gFAAwB,EACzE;EAFiB;EACA;;CAGnB,MAAa,KACX,MACA,eACyB;EACzB,MAAM,WAAW,KAAK,MAAM,cAAc,GAAG;EAC7C,IAAI,SAAS,MAAM,KAAK,WAAW,KAAK,MAAM,cAAc;EAC5D,IAAI,WAAWC;EACf,IAAI,cAAcC;AAElB,SAAO,OAAO,WAAW,eAAe,WAAW,GAAG;AACpD;GAGA,MAAM,UAAU,KAAK,IACnB,KAAK,IAAI,aAAaC,0DAAY,GAAG,WAAW,EAChD,EACD;AACD,iBAAc,cAAcC;GAC5B,MAAM,gBAAgB,OAAO,iBAAiB;GAG9C,MAAM,yBAAyB,WAAW,KAAK,MAAM,cAAc;AACnE,OAAI,gBAAgB,uBAClB,QAAO;AAGT,YAAS,MAAM,KAAK,OAAO,MAAM,wBAAwB,cAAc;;AAGzE,SAAO;;CAGT,AAAO,WAAW;AAChB,OAAK,WAAW,UAAU;;CAG5B,AAAQ,OACN,MACA,eACA,UACyB;AACzB,SAAO,IAAI,SAAS,SAAS,WAAW;AACtC,oBAAiB;AACf,SAAK,WAAW,KAAK,MAAM,cAAc,CAAC,KAAK,SAAS,OAAO;MAC9D,SAAS;IACZ"}
+{"version":3,"file":"RetryingTransport.cjs","names":["OTelPerformanceManager","INITIAL_BACKOFF","MAX_BACKOFF","BACKOFF_MULTIPLIER"],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"sourcesContent":["import type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { PerformanceManager } from '../../utils/index.ts';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants.ts';\n\n/**\n * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]\n */\nconst getJitter = () => Math.random() * (2 * JITTER) - JITTER;\n\n// Taken directly from open-telemetry/opentelemetry-js/experimental/packages/otlp-exporter-base/src/retrying-transport.ts\n// File is not exposed externally\n\n/*\n * Copyright The OpenTelemetry Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport class RetryingTransport implements IExporterTransport {\n  public constructor(\n    private readonly _transport: IExporterTransport,\n    private readonly _perf: PerformanceManager = new OTelPerformanceManager(),\n  ) {}\n\n  public async send(\n    data: Uint8Array,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    const deadline = this._perf.getNowMillis() + timeoutMillis;\n    let result = await this._transport.send(data, timeoutMillis);\n    let attempts = MAX_ATTEMPTS;\n    let nextBackoff = INITIAL_BACKOFF;\n\n    while (result.status === 'retryable' && attempts > 0) {\n      attempts--;\n\n      // use maximum of computed backoff and 0 to avoid negative timeouts\n      const backoff = Math.max(\n        Math.min(nextBackoff, MAX_BACKOFF) + getJitter(),\n        0,\n      );\n      nextBackoff = nextBackoff * BACKOFF_MULTIPLIER;\n      const retryInMillis = result.retryInMillis ?? backoff;\n\n      // return when expected retry time is after the export deadline.\n      const remainingTimeoutMillis = deadline - this._perf.getNowMillis();\n      if (retryInMillis > remainingTimeoutMillis) {\n        return result;\n      }\n\n      result = await this._retry(data, remainingTimeoutMillis, retryInMillis);\n    }\n\n    return result;\n  }\n\n  public shutdown() {\n    this._transport.shutdown();\n  }\n\n  private _retry(\n    data: Uint8Array,\n    timeoutMillis: number,\n    inMillis: number,\n  ): Promise<ExportResponse> {\n    return new Promise((resolve, reject) => {\n      setTimeout(() => {\n        this._transport.send(data, timeoutMillis).then(resolve, reject);\n      }, inMillis);\n    });\n  }\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,kBAAkB,KAAK,QAAQ,GAAI,KAAA;AAoBzC,IAAa,oBAAb,MAA6D;CAC3D,YACE,YACA,QAA6C,IAAIA,wDAAAA,wBAAwB,EACzE;AAFiB,OAAA,aAAA;AACA,OAAA,QAAA;;CAGnB,MAAa,KACX,MACA,eACyB;EACzB,MAAM,WAAW,KAAK,MAAM,cAAc,GAAG;EAC7C,IAAI,SAAS,MAAM,KAAK,WAAW,KAAK,MAAM,cAAc;EAC5D,IAAI,WAAA;EACJ,IAAI,cAAcC,8CAAAA;AAElB,SAAO,OAAO,WAAW,eAAe,WAAW,GAAG;AACpD;GAGA,MAAM,UAAU,KAAK,IACnB,KAAK,IAAI,aAAaC,8CAAAA,YAAY,GAAG,WAAW,EAChD,EACD;AACD,iBAAc,cAAcC,8CAAAA;GAC5B,MAAM,gBAAgB,OAAO,iBAAiB;GAG9C,MAAM,yBAAyB,WAAW,KAAK,MAAM,cAAc;AACnE,OAAI,gBAAgB,uBAClB,QAAO;AAGT,YAAS,MAAM,KAAK,OAAO,MAAM,wBAAwB,cAAc;;AAGzE,SAAO;;CAGT,WAAkB;AAChB,OAAK,WAAW,UAAU;;CAG5B,OACE,MACA,eACA,UACyB;AACzB,SAAO,IAAI,SAAS,SAAS,WAAW;AACtC,oBAAiB;AACf,SAAK,WAAW,KAAK,MAAM,cAAc,CAAC,KAAK,SAAS,OAAO;MAC9D,SAAS;IACZ"}

package/dist/transport/RetryingTransport/RetryingTransport.d.ts

@@ -1,5 +1,4 @@
 import { PerformanceManager } from "../../utils/PerformanceManager/types.js";
-import "../../utils/index.js";
 import { ExportResponse, IExporterTransport } from "@opentelemetry/otlp-exporter-base";
 
 //#region src/transport/RetryingTransport/RetryingTransport.d.ts

package/dist/transport/RetryingTransport/RetryingTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RetryingTransport.d.ts","names":[],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"mappings":";;;;;cAqCa,iBAAA,YAA6B,kBAAA;EAAA,iBAErB,UAAA;EAAA,iBACA,KAAA;cADA,UAAA,EAAY,kBAAA,EACZ,KAAA,GAAO,kBAAA;EAGb,IAAA,CACX,IAAA,EAAM,UAAA,EACN,aAAA,WACC,OAAA,CAAQ,cAAA;EA6BJ,QAAA,CAAA;EAAA,QAIC,MAAA;AAAA"}
+{"version":3,"file":"RetryingTransport.d.ts","names":[],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"mappings":";;;;cAqCa,iBAAA,YAA6B,kBAAA;EAAA,iBAErB,UAAA;EAAA,iBACA,KAAA;cADA,UAAA,EAAY,kBAAA,EACZ,KAAA,GAAO,kBAAA;EAGb,IAAA,CACX,IAAA,EAAM,UAAA,EACN,aAAA,WACC,OAAA,CAAQ,cAAA;EA6BJ,QAAA,CAAA;EAAA,QAIC,MAAA;AAAA"}

package/dist/transport/RetryingTransport/RetryingTransport.js

@@ -1,11 +1,10 @@
 import { OTelPerformanceManager } from "../../utils/PerformanceManager/OTelPerformanceManager.js";
-import { BACKOFF_MULTIPLIER, INITIAL_BACKOFF, JITTER, MAX_ATTEMPTS, MAX_BACKOFF } from "./constants.js";
-
+import { BACKOFF_MULTIPLIER, INITIAL_BACKOFF, MAX_BACKOFF } from "./constants.js";
 //#region src/transport/RetryingTransport/RetryingTransport.ts
 /**
 * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]
 */
-const getJitter = () => Math.random() * (2 * JITTER) - JITTER;
+const getJitter = () => Math.random() * 40 - 20;
 var RetryingTransport = class {
 	constructor(_transport, _perf = new OTelPerformanceManager()) {
 		this._transport = _transport;
@@ -14,7 +13,7 @@ var RetryingTransport = class {
 	async send(data, timeoutMillis) {
 		const deadline = this._perf.getNowMillis() + timeoutMillis;
 		let result = await this._transport.send(data, timeoutMillis);
-		let attempts = MAX_ATTEMPTS;
+		let attempts = 5;
 		let nextBackoff = INITIAL_BACKOFF;
 		while (result.status === "retryable" && attempts > 0) {
 			attempts--;
@@ -38,7 +37,7 @@ var RetryingTransport = class {
 		});
 	}
 };
-
 //#endregion
 export { RetryingTransport };
+
 //# sourceMappingURL=RetryingTransport.js.map

package/dist/transport/RetryingTransport/RetryingTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"RetryingTransport.js","names":[],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"sourcesContent":["import type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { PerformanceManager } from '../../utils/index.ts';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants.ts';\n\n/**\n * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]\n */\nconst getJitter = () => Math.random() * (2 * JITTER) - JITTER;\n\n// Taken directly from open-telemetry/opentelemetry-js/experimental/packages/otlp-exporter-base/src/retrying-transport.ts\n// File is not exposed externally\n\n/*\n * Copyright The OpenTelemetry Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport class RetryingTransport implements IExporterTransport {\n  public constructor(\n    private readonly _transport: IExporterTransport,\n    private readonly _perf: PerformanceManager = new OTelPerformanceManager(),\n  ) {}\n\n  public async send(\n    data: Uint8Array,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    const deadline = this._perf.getNowMillis() + timeoutMillis;\n    let result = await this._transport.send(data, timeoutMillis);\n    let attempts = MAX_ATTEMPTS;\n    let nextBackoff = INITIAL_BACKOFF;\n\n    while (result.status === 'retryable' && attempts > 0) {\n      attempts--;\n\n      // use maximum of computed backoff and 0 to avoid negative timeouts\n      const backoff = Math.max(\n        Math.min(nextBackoff, MAX_BACKOFF) + getJitter(),\n        0,\n      );\n      nextBackoff = nextBackoff * BACKOFF_MULTIPLIER;\n      const retryInMillis = result.retryInMillis ?? backoff;\n\n      // return when expected retry time is after the export deadline.\n      const remainingTimeoutMillis = deadline - this._perf.getNowMillis();\n      if (retryInMillis > remainingTimeoutMillis) {\n        return result;\n      }\n\n      result = await this._retry(data, remainingTimeoutMillis, retryInMillis);\n    }\n\n    return result;\n  }\n\n  public shutdown() {\n    this._transport.shutdown();\n  }\n\n  private _retry(\n    data: Uint8Array,\n    timeoutMillis: number,\n    inMillis: number,\n  ): Promise<ExportResponse> {\n    return new Promise((resolve, reject) => {\n      setTimeout(() => {\n        this._transport.send(data, timeoutMillis).then(resolve, reject);\n      }, inMillis);\n    });\n  }\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,kBAAkB,KAAK,QAAQ,IAAI,IAAI,UAAU;AAoBvD,IAAa,oBAAb,MAA6D;CAC3D,AAAO,YACL,AAAiB,YACjB,AAAiB,QAA4B,IAAI,wBAAwB,EACzE;EAFiB;EACA;;CAGnB,MAAa,KACX,MACA,eACyB;EACzB,MAAM,WAAW,KAAK,MAAM,cAAc,GAAG;EAC7C,IAAI,SAAS,MAAM,KAAK,WAAW,KAAK,MAAM,cAAc;EAC5D,IAAI,WAAW;EACf,IAAI,cAAc;AAElB,SAAO,OAAO,WAAW,eAAe,WAAW,GAAG;AACpD;GAGA,MAAM,UAAU,KAAK,IACnB,KAAK,IAAI,aAAa,YAAY,GAAG,WAAW,EAChD,EACD;AACD,iBAAc,cAAc;GAC5B,MAAM,gBAAgB,OAAO,iBAAiB;GAG9C,MAAM,yBAAyB,WAAW,KAAK,MAAM,cAAc;AACnE,OAAI,gBAAgB,uBAClB,QAAO;AAGT,YAAS,MAAM,KAAK,OAAO,MAAM,wBAAwB,cAAc;;AAGzE,SAAO;;CAGT,AAAO,WAAW;AAChB,OAAK,WAAW,UAAU;;CAG5B,AAAQ,OACN,MACA,eACA,UACyB;AACzB,SAAO,IAAI,SAAS,SAAS,WAAW;AACtC,oBAAiB;AACf,SAAK,WAAW,KAAK,MAAM,cAAc,CAAC,KAAK,SAAS,OAAO;MAC9D,SAAS;IACZ"}
+{"version":3,"file":"RetryingTransport.js","names":[],"sources":["../../../src/transport/RetryingTransport/RetryingTransport.ts"],"sourcesContent":["import type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { PerformanceManager } from '../../utils/index.ts';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants.ts';\n\n/**\n * Get a pseudo-random jitter that falls in the range of [-JITTER, +JITTER]\n */\nconst getJitter = () => Math.random() * (2 * JITTER) - JITTER;\n\n// Taken directly from open-telemetry/opentelemetry-js/experimental/packages/otlp-exporter-base/src/retrying-transport.ts\n// File is not exposed externally\n\n/*\n * Copyright The OpenTelemetry Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nexport class RetryingTransport implements IExporterTransport {\n  public constructor(\n    private readonly _transport: IExporterTransport,\n    private readonly _perf: PerformanceManager = new OTelPerformanceManager(),\n  ) {}\n\n  public async send(\n    data: Uint8Array,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    const deadline = this._perf.getNowMillis() + timeoutMillis;\n    let result = await this._transport.send(data, timeoutMillis);\n    let attempts = MAX_ATTEMPTS;\n    let nextBackoff = INITIAL_BACKOFF;\n\n    while (result.status === 'retryable' && attempts > 0) {\n      attempts--;\n\n      // use maximum of computed backoff and 0 to avoid negative timeouts\n      const backoff = Math.max(\n        Math.min(nextBackoff, MAX_BACKOFF) + getJitter(),\n        0,\n      );\n      nextBackoff = nextBackoff * BACKOFF_MULTIPLIER;\n      const retryInMillis = result.retryInMillis ?? backoff;\n\n      // return when expected retry time is after the export deadline.\n      const remainingTimeoutMillis = deadline - this._perf.getNowMillis();\n      if (retryInMillis > remainingTimeoutMillis) {\n        return result;\n      }\n\n      result = await this._retry(data, remainingTimeoutMillis, retryInMillis);\n    }\n\n    return result;\n  }\n\n  public shutdown() {\n    this._transport.shutdown();\n  }\n\n  private _retry(\n    data: Uint8Array,\n    timeoutMillis: number,\n    inMillis: number,\n  ): Promise<ExportResponse> {\n    return new Promise((resolve, reject) => {\n      setTimeout(() => {\n        this._transport.send(data, timeoutMillis).then(resolve, reject);\n      }, inMillis);\n    });\n  }\n}\n"],"mappings":";;;;;;AAiBA,MAAM,kBAAkB,KAAK,QAAQ,GAAI,KAAA;AAoBzC,IAAa,oBAAb,MAA6D;CAC3D,YACE,YACA,QAA6C,IAAI,wBAAwB,EACzE;AAFiB,OAAA,aAAA;AACA,OAAA,QAAA;;CAGnB,MAAa,KACX,MACA,eACyB;EACzB,MAAM,WAAW,KAAK,MAAM,cAAc,GAAG;EAC7C,IAAI,SAAS,MAAM,KAAK,WAAW,KAAK,MAAM,cAAc;EAC5D,IAAI,WAAA;EACJ,IAAI,cAAc;AAElB,SAAO,OAAO,WAAW,eAAe,WAAW,GAAG;AACpD;GAGA,MAAM,UAAU,KAAK,IACnB,KAAK,IAAI,aAAa,YAAY,GAAG,WAAW,EAChD,EACD;AACD,iBAAc,cAAc;GAC5B,MAAM,gBAAgB,OAAO,iBAAiB;GAG9C,MAAM,yBAAyB,WAAW,KAAK,MAAM,cAAc;AACnE,OAAI,gBAAgB,uBAClB,QAAO;AAGT,YAAS,MAAM,KAAK,OAAO,MAAM,wBAAwB,cAAc;;AAGzE,SAAO;;CAGT,WAAkB;AAChB,OAAK,WAAW,UAAU;;CAG5B,OACE,MACA,eACA,UACyB;AACzB,SAAO,IAAI,SAAS,SAAS,WAAW;AACtC,oBAAiB;AACf,SAAK,WAAW,KAAK,MAAM,cAAc,CAAC,KAAK,SAAS,OAAO;MAC9D,SAAS;IACZ"}

package/dist/transport/RetryingTransport/constants.cjs

@@ -1,16 +1,15 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/transport/RetryingTransport/constants.ts
 const MAX_ATTEMPTS = 5;
 const INITIAL_BACKOFF = 1e3;
 const MAX_BACKOFF = 5e3;
 const BACKOFF_MULTIPLIER = 1.5;
 const JITTER = 20;
-
 //#endregion
 exports.BACKOFF_MULTIPLIER = BACKOFF_MULTIPLIER;
 exports.INITIAL_BACKOFF = INITIAL_BACKOFF;
 exports.JITTER = JITTER;
 exports.MAX_ATTEMPTS = MAX_ATTEMPTS;
 exports.MAX_BACKOFF = MAX_BACKOFF;
+
 //# sourceMappingURL=constants.cjs.map

package/dist/transport/RetryingTransport/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/transport/RetryingTransport/constants.ts"],"sourcesContent":["export const MAX_ATTEMPTS = 5;\nexport const INITIAL_BACKOFF = 1000;\nexport const MAX_BACKOFF = 5000;\nexport const BACKOFF_MULTIPLIER = 1.5;\nexport const JITTER = 20;\n"],"mappings":";;;AAAA,MAAa,eAAe;AAC5B,MAAa,kBAAkB;AAC/B,MAAa,cAAc;AAC3B,MAAa,qBAAqB;AAClC,MAAa,SAAS"}
+{"version":3,"file":"constants.cjs","names":[],"sources":["../../../src/transport/RetryingTransport/constants.ts"],"sourcesContent":["export const MAX_ATTEMPTS = 5;\nexport const INITIAL_BACKOFF = 1000;\nexport const MAX_BACKOFF = 5000;\nexport const BACKOFF_MULTIPLIER = 1.5;\nexport const JITTER = 20;\n"],"mappings":";;AAAA,MAAa,eAAe;AAC5B,MAAa,kBAAkB;AAC/B,MAAa,cAAc;AAC3B,MAAa,qBAAqB;AAClC,MAAa,SAAS"}

package/dist/transport/RetryingTransport/constants.js

@@ -4,7 +4,7 @@ const INITIAL_BACKOFF = 1e3;
 const MAX_BACKOFF = 5e3;
 const BACKOFF_MULTIPLIER = 1.5;
 const JITTER = 20;
-
 //#endregion
 export { BACKOFF_MULTIPLIER, INITIAL_BACKOFF, JITTER, MAX_ATTEMPTS, MAX_BACKOFF };
+
 //# sourceMappingURL=constants.js.map

package/dist/transport/RetryingTransport/createRetryingTransport.cjs

@@ -1,13 +1,12 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils_PerformanceManager_OTelPerformanceManager = require('../../utils/PerformanceManager/OTelPerformanceManager.cjs');
-const require_transport_RetryingTransport_RetryingTransport = require('./RetryingTransport.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_PerformanceManager_OTelPerformanceManager = require("../../utils/PerformanceManager/OTelPerformanceManager.cjs");
+const require_transport_RetryingTransport_RetryingTransport = require("./RetryingTransport.cjs");
 //#region src/transport/RetryingTransport/createRetryingTransport.ts
 /**
 * Creates an Exporter Transport that retries on 'retryable' response.
 */
 const createRetryingTransport = (options) => new require_transport_RetryingTransport_RetryingTransport.RetryingTransport(options.transport, options.perf ?? new require_utils_PerformanceManager_OTelPerformanceManager.OTelPerformanceManager());
-
 //#endregion
 exports.createRetryingTransport = createRetryingTransport;
+
 //# sourceMappingURL=createRetryingTransport.cjs.map

package/dist/transport/RetryingTransport/createRetryingTransport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createRetryingTransport.cjs","names":["RetryingTransport","OTelPerformanceManager"],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"sourcesContent":["import type { IExporterTransport } from '@opentelemetry/otlp-exporter-base';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport { RetryingTransport } from './RetryingTransport.ts';\n\n/**\n * Creates an Exporter Transport that retries on 'retryable' response.\n */\nexport const createRetryingTransport = (options: {\n  // Underlying transport to wrap.\n  transport: IExporterTransport;\n  // Performance manager to use.\n  perf?: OTelPerformanceManager;\n}): IExporterTransport =>\n  new RetryingTransport(\n    options.transport,\n    options.perf ?? new OTelPerformanceManager(),\n  );\n"],"mappings":";;;;;;;;AAOA,MAAa,2BAA2B,YAMtC,IAAIA,wEACF,QAAQ,WACR,QAAQ,QAAQ,IAAIC,gFAAwB,CAC7C"}
+{"version":3,"file":"createRetryingTransport.cjs","names":["RetryingTransport","OTelPerformanceManager"],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"sourcesContent":["import type { IExporterTransport } from '@opentelemetry/otlp-exporter-base';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport { RetryingTransport } from './RetryingTransport.ts';\n\n/**\n * Creates an Exporter Transport that retries on 'retryable' response.\n */\nexport const createRetryingTransport = (options: {\n  // Underlying transport to wrap.\n  transport: IExporterTransport;\n  // Performance manager to use.\n  perf?: OTelPerformanceManager;\n}): IExporterTransport =>\n  new RetryingTransport(\n    options.transport,\n    options.perf ?? new OTelPerformanceManager(),\n  );\n"],"mappings":";;;;;;;AAOA,MAAa,2BAA2B,YAMtC,IAAIA,sDAAAA,kBACF,QAAQ,WACR,QAAQ,QAAQ,IAAIC,wDAAAA,wBAAwB,CAC7C"}

package/dist/transport/RetryingTransport/createRetryingTransport.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"createRetryingTransport.d.cts","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"mappings":";;;;;;AAOA;cAAa,uBAAA,GAA2B,OAAA;EAEtC,SAAA,EAAW,kBAAA;EAEX,IAAA,GAAO,sBAAA;AAAA,MACL,kBAAA"}
+{"version":3,"file":"createRetryingTransport.d.cts","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"mappings":";;;;;;;cAOa,uBAAA,GAA2B,OAAA;EAEtC,SAAA,EAAW,kBAAA;EAEX,IAAA,GAAO,sBAAA;AAAA,MACL,kBAAA"}

package/dist/transport/RetryingTransport/createRetryingTransport.d.ts

@@ -1,5 +1,4 @@
 import { OTelPerformanceManager } from "../../utils/PerformanceManager/OTelPerformanceManager.js";
-import "../../utils/index.js";
 import { IExporterTransport } from "@opentelemetry/otlp-exporter-base";
 
 //#region src/transport/RetryingTransport/createRetryingTransport.d.ts

package/dist/transport/RetryingTransport/createRetryingTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRetryingTransport.d.ts","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"mappings":";;;;;;;;cAOa,uBAAA,GAA2B,OAAA;EAEtC,SAAA,EAAW,kBAAA;EAEX,IAAA,GAAO,sBAAA;AAAA,MACL,kBAAA"}
+{"version":3,"file":"createRetryingTransport.d.ts","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"mappings":";;;;;;;cAOa,uBAAA,GAA2B,OAAA;EAEtC,SAAA,EAAW,kBAAA;EAEX,IAAA,GAAO,sBAAA;AAAA,MACL,kBAAA"}

package/dist/transport/RetryingTransport/createRetryingTransport.js

@@ -1,12 +1,11 @@
 import { OTelPerformanceManager } from "../../utils/PerformanceManager/OTelPerformanceManager.js";
 import { RetryingTransport } from "./RetryingTransport.js";
-
 //#region src/transport/RetryingTransport/createRetryingTransport.ts
 /**
 * Creates an Exporter Transport that retries on 'retryable' response.
 */
 const createRetryingTransport = (options) => new RetryingTransport(options.transport, options.perf ?? new OTelPerformanceManager());
-
 //#endregion
 export { createRetryingTransport };
+
 //# sourceMappingURL=createRetryingTransport.js.map

package/dist/transport/RetryingTransport/createRetryingTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"createRetryingTransport.js","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"sourcesContent":["import type { IExporterTransport } from '@opentelemetry/otlp-exporter-base';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport { RetryingTransport } from './RetryingTransport.ts';\n\n/**\n * Creates an Exporter Transport that retries on 'retryable' response.\n */\nexport const createRetryingTransport = (options: {\n  // Underlying transport to wrap.\n  transport: IExporterTransport;\n  // Performance manager to use.\n  perf?: OTelPerformanceManager;\n}): IExporterTransport =>\n  new RetryingTransport(\n    options.transport,\n    options.perf ?? new OTelPerformanceManager(),\n  );\n"],"mappings":";;;;;;;AAOA,MAAa,2BAA2B,YAMtC,IAAI,kBACF,QAAQ,WACR,QAAQ,QAAQ,IAAI,wBAAwB,CAC7C"}
+{"version":3,"file":"createRetryingTransport.js","names":[],"sources":["../../../src/transport/RetryingTransport/createRetryingTransport.ts"],"sourcesContent":["import type { IExporterTransport } from '@opentelemetry/otlp-exporter-base';\nimport { OTelPerformanceManager } from '../../utils/index.ts';\nimport { RetryingTransport } from './RetryingTransport.ts';\n\n/**\n * Creates an Exporter Transport that retries on 'retryable' response.\n */\nexport const createRetryingTransport = (options: {\n  // Underlying transport to wrap.\n  transport: IExporterTransport;\n  // Performance manager to use.\n  perf?: OTelPerformanceManager;\n}): IExporterTransport =>\n  new RetryingTransport(\n    options.transport,\n    options.perf ?? new OTelPerformanceManager(),\n  );\n"],"mappings":";;;;;;AAOA,MAAa,2BAA2B,YAMtC,IAAI,kBACF,QAAQ,WACR,QAAQ,QAAQ,IAAI,wBAAwB,CAC7C"}

package/dist/transport/RetryingTransport/index.cjs

@@ -1,4 +1,3 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_transport_RetryingTransport_createRetryingTransport = require('./createRetryingTransport.cjs');
-
-exports.createRetryingTransport = require_transport_RetryingTransport_createRetryingTransport.createRetryingTransport;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_transport_RetryingTransport_createRetryingTransport = require("./createRetryingTransport.cjs");
+exports.createRetryingTransport = require_transport_RetryingTransport_createRetryingTransport.createRetryingTransport;

package/dist/transport/RetryingTransport/index.js

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

package/dist/transport/index.cjs

@@ -1,6 +1,5 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_transport_FetchTransport_createFetchTransport = require('./FetchTransport/createFetchTransport.cjs');
-const require_transport_RetryingTransport_createRetryingTransport = require('./RetryingTransport/createRetryingTransport.cjs');
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_transport_FetchTransport_createFetchTransport = require("./FetchTransport/createFetchTransport.cjs");
+const require_transport_RetryingTransport_createRetryingTransport = require("./RetryingTransport/createRetryingTransport.cjs");
 exports.createFetchTransport = require_transport_FetchTransport_createFetchTransport.createFetchTransport;
-exports.createRetryingTransport = require_transport_RetryingTransport_createRetryingTransport.createRetryingTransport;
+exports.createRetryingTransport = require_transport_RetryingTransport_createRetryingTransport.createRetryingTransport;

package/dist/transport/index.d.ts

@@ -1,5 +1,3 @@
 import { createFetchTransport } from "./FetchTransport/createFetchTransport.js";
-import "./FetchTransport/index.js";
 import { createRetryingTransport } from "./RetryingTransport/createRetryingTransport.js";
-import "./RetryingTransport/index.js";
 export { createFetchTransport, createRetryingTransport };

package/dist/transport/index.js

@@ -1,4 +1,3 @@
 import { createFetchTransport } from "./FetchTransport/createFetchTransport.js";
 import { createRetryingTransport } from "./RetryingTransport/createRetryingTransport.js";
-
-export { createFetchTransport, createRetryingTransport };
+export { createFetchTransport, createRetryingTransport };

package/dist/utils/MXLSpanStorage/MXLSpanStorage.cjs

@@ -1,10 +1,9 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_constants_attributes = require('../../constants/attributes.cjs');
+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;
@@ -111,7 +110,7 @@ var MXLSpanStorage = class {
 		this.stopExpiredSpansCheck();
 	}
 };
-
 //#endregion
 exports.MXLSpanStorage = MXLSpanStorage;
+
 //# sourceMappingURL=MXLSpanStorage.cjs.map

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

@@ -1 +1 @@
-{"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/index.ts';\nimport type { SpanSessionManagerInternal } from '../../managers/index.ts';\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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"}
+{"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/index.ts';\nimport type { SpanSessionManagerInternal } from '../../managers/index.ts';\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/MXLSpanStorage.d.ts

@@ -1,5 +1,4 @@
 import { SpanSessionManagerInternal } from "../../managers/MXLSpanSessionManager/types.js";
-import "../../managers/index.js";
 import { DiagLogger } from "@opentelemetry/api";
 import { Resource } from "@opentelemetry/resources";
 import { ReadableSpan } from "@opentelemetry/sdk-trace-web";

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

@@ -1 +1 @@
-{"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"}
+{"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

@@ -2,7 +2,6 @@ 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;
@@ -109,7 +108,7 @@ var MXLSpanStorage = class {
 		this.stopExpiredSpansCheck();
 	}
 };
-
 //#endregion
 export { MXLSpanStorage };
+
 //# sourceMappingURL=MXLSpanStorage.js.map

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

@@ -1 +1 @@
-{"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/index.ts';\nimport type { SpanSessionManagerInternal } from '../../managers/index.ts';\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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"}
+{"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/index.ts';\nimport type { SpanSessionManagerInternal } from '../../managers/index.ts';\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,4 +1,3 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils_MXLSpanStorage_MXLSpanStorage = require('./MXLSpanStorage.cjs');
-
-exports.MXLSpanStorage = require_utils_MXLSpanStorage_MXLSpanStorage.MXLSpanStorage;
+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.ts

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

package/dist/utils/MXLSpanStorage/index.js

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

package/dist/utils/NamespacedStorage/NamespacedStorage.cjs

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/NamespacedStorage/NamespacedStorage.ts
 var NamespacedStorage = class {
 	_keyPrefix;
@@ -36,8 +35,18 @@ var NamespacedStorage = class {
 	setItem(key, value) {
 		this._storage.setItem(`${this._keyPrefix}${key}`, value);
 	}
+	/**
+	* Returns the namespaced underlying-storage key for a logical key. Browser
+	* `storage` events fire with the underlying key, so callers that filter
+	* those events need to compare against this value rather than the logical
+	* key. Plain `Storage` instances do not expose this method; callers should
+	* fall back to the logical key in that case.
+	*/
+	getStorageEventKey(logicalKey) {
+		return `${this._keyPrefix}${logicalKey}`;
+	}
 };
-
 //#endregion
 exports.NamespacedStorage = NamespacedStorage;
+
 //# sourceMappingURL=NamespacedStorage.cjs.map

package/dist/utils/NamespacedStorage/NamespacedStorage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"NamespacedStorage.cjs","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["export class NamespacedStorage implements Storage {\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n\n  public constructor(namespace: string, storage: Storage) {\n    this._keyPrefix = `${namespace}_`;\n    this._storage = storage;\n  }\n\n  protected getNamespacedKeys(): string[] {\n    const keys = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(this._keyPrefix)) {\n        keys.push(key.substring(this._keyPrefix.length));\n      }\n    }\n\n    return keys;\n  }\n\n  public get length(): number {\n    return this.getNamespacedKeys().length;\n  }\n\n  public clear(): void {\n    this.getNamespacedKeys().forEach((key) => {\n      this._storage.removeItem(`${this._keyPrefix}${key}`);\n    });\n  }\n\n  public getItem(key: string): string | null {\n    return this._storage.getItem(`${this._keyPrefix}${key}`);\n  }\n\n  public key(index: number): string | null {\n    return this.getNamespacedKeys()[index] || null;\n  }\n\n  public removeItem(key: string): void {\n    this._storage.removeItem(`${this._keyPrefix}${key}`);\n  }\n\n  public setItem(key: string, value: string): void {\n    this._storage.setItem(`${this._keyPrefix}${key}`, value);\n  }\n}\n"],"mappings":";;;AAAA,IAAa,oBAAb,MAAkD;CAChD,AAAiB;CACjB,AAAiB;CAEjB,AAAO,YAAY,WAAmB,SAAkB;AACtD,OAAK,aAAa,GAAG,UAAU;AAC/B,OAAK,WAAW;;CAGlB,AAAU,oBAA8B;EACtC,MAAM,OAAO,EAAE;AACf,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,KAAK;GAC7C,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,KAAK,WAAW,KAAK,WAAW,CAClC,MAAK,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;;AAIpD,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,mBAAmB,CAAC;;CAGlC,AAAO,QAAc;AACnB,OAAK,mBAAmB,CAAC,SAAS,QAAQ;AACxC,QAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;IACpD;;CAGJ,AAAO,QAAQ,KAA4B;AACzC,SAAO,KAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,MAAM;;CAG1D,AAAO,IAAI,OAA8B;AACvC,SAAO,KAAK,mBAAmB,CAAC,UAAU;;CAG5C,AAAO,WAAW,KAAmB;AACnC,OAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;;CAGtD,AAAO,QAAQ,KAAa,OAAqB;AAC/C,OAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,OAAO,MAAM"}
+{"version":3,"file":"NamespacedStorage.cjs","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["export class NamespacedStorage implements Storage {\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n\n  public constructor(namespace: string, storage: Storage) {\n    this._keyPrefix = `${namespace}_`;\n    this._storage = storage;\n  }\n\n  protected getNamespacedKeys(): string[] {\n    const keys = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(this._keyPrefix)) {\n        keys.push(key.substring(this._keyPrefix.length));\n      }\n    }\n\n    return keys;\n  }\n\n  public get length(): number {\n    return this.getNamespacedKeys().length;\n  }\n\n  public clear(): void {\n    this.getNamespacedKeys().forEach((key) => {\n      this._storage.removeItem(`${this._keyPrefix}${key}`);\n    });\n  }\n\n  public getItem(key: string): string | null {\n    return this._storage.getItem(`${this._keyPrefix}${key}`);\n  }\n\n  public key(index: number): string | null {\n    return this.getNamespacedKeys()[index] || null;\n  }\n\n  public removeItem(key: string): void {\n    this._storage.removeItem(`${this._keyPrefix}${key}`);\n  }\n\n  public setItem(key: string, value: string): void {\n    this._storage.setItem(`${this._keyPrefix}${key}`, value);\n  }\n\n  /**\n   * Returns the namespaced underlying-storage key for a logical key. Browser\n   * `storage` events fire with the underlying key, so callers that filter\n   * those events need to compare against this value rather than the logical\n   * key. Plain `Storage` instances do not expose this method; callers should\n   * fall back to the logical key in that case.\n   */\n  public getStorageEventKey(logicalKey: string): string {\n    return `${this._keyPrefix}${logicalKey}`;\n  }\n}\n"],"mappings":";;AAAA,IAAa,oBAAb,MAAkD;CAChD;CACA;CAEA,YAAmB,WAAmB,SAAkB;AACtD,OAAK,aAAa,GAAG,UAAU;AAC/B,OAAK,WAAW;;CAGlB,oBAAwC;EACtC,MAAM,OAAO,EAAE;AACf,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,KAAK;GAC7C,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,KAAK,WAAW,KAAK,WAAW,CAClC,MAAK,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;;AAIpD,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,mBAAmB,CAAC;;CAGlC,QAAqB;AACnB,OAAK,mBAAmB,CAAC,SAAS,QAAQ;AACxC,QAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;IACpD;;CAGJ,QAAe,KAA4B;AACzC,SAAO,KAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,MAAM;;CAG1D,IAAW,OAA8B;AACvC,SAAO,KAAK,mBAAmB,CAAC,UAAU;;CAG5C,WAAkB,KAAmB;AACnC,OAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;;CAGtD,QAAe,KAAa,OAAqB;AAC/C,OAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,OAAO,MAAM;;;;;;;;;CAU1D,mBAA0B,YAA4B;AACpD,SAAO,GAAG,KAAK,aAAa"}

package/dist/utils/NamespacedStorage/NamespacedStorage.d.cts

@@ -10,6 +10,14 @@ declare class NamespacedStorage implements Storage {
   key(index: number): string | null;
   removeItem(key: string): void;
   setItem(key: string, value: string): void;
+  /**
+   * Returns the namespaced underlying-storage key for a logical key. Browser
+   * `storage` events fire with the underlying key, so callers that filter
+   * those events need to compare against this value rather than the logical
+   * key. Plain `Storage` instances do not expose this method; callers should
+   * fall back to the logical key in that case.
+   */
+  getStorageEventKey(logicalKey: string): string;
 }
 //#endregion
 export { NamespacedStorage };

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

@@ -1 +1 @@
-{"version":3,"file":"NamespacedStorage.d.cts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";cAAa,iBAAA,YAA6B,OAAA;EAAA,iBACvB,UAAA;EAAA,iBACA,QAAA;cAEE,SAAA,UAAmB,OAAA,EAAS,OAAA;EAAA,UAKrC,iBAAA,CAAA;EAAA,IAYC,MAAA,CAAA;EAIJ,KAAA,CAAA;EAMA,OAAA,CAAQ,GAAA;EAIR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;AAAA"}
+{"version":3,"file":"NamespacedStorage.d.cts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";cAAa,iBAAA,YAA6B,OAAA;EAAA,iBACvB,UAAA;EAAA,iBACA,QAAA;cAEE,SAAA,UAAmB,OAAA,EAAS,OAAA;EAAA,UAKrC,iBAAA,CAAA;EAAA,IAYC,MAAA,CAAA;EAIJ,KAAA,CAAA;EAMA,OAAA,CAAQ,GAAA;EAIR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;EAvCU;;;;;;;EAkD/B,kBAAA,CAAmB,UAAA;AAAA"}

package/dist/utils/NamespacedStorage/NamespacedStorage.d.ts

@@ -10,6 +10,14 @@ declare class NamespacedStorage implements Storage {
   key(index: number): string | null;
   removeItem(key: string): void;
   setItem(key: string, value: string): void;
+  /**
+   * Returns the namespaced underlying-storage key for a logical key. Browser
+   * `storage` events fire with the underlying key, so callers that filter
+   * those events need to compare against this value rather than the logical
+   * key. Plain `Storage` instances do not expose this method; callers should
+   * fall back to the logical key in that case.
+   */
+  getStorageEventKey(logicalKey: string): string;
 }
 //#endregion
 export { NamespacedStorage };

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

@@ -1 +1 @@
-{"version":3,"file":"NamespacedStorage.d.ts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";cAAa,iBAAA,YAA6B,OAAA;EAAA,iBACvB,UAAA;EAAA,iBACA,QAAA;cAEE,SAAA,UAAmB,OAAA,EAAS,OAAA;EAAA,UAKrC,iBAAA,CAAA;EAAA,IAYC,MAAA,CAAA;EAIJ,KAAA,CAAA;EAMA,OAAA,CAAQ,GAAA;EAIR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;AAAA"}
+{"version":3,"file":"NamespacedStorage.d.ts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";cAAa,iBAAA,YAA6B,OAAA;EAAA,iBACvB,UAAA;EAAA,iBACA,QAAA;cAEE,SAAA,UAAmB,OAAA,EAAS,OAAA;EAAA,UAKrC,iBAAA,CAAA;EAAA,IAYC,MAAA,CAAA;EAIJ,KAAA,CAAA;EAMA,OAAA,CAAQ,GAAA;EAIR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;EAvCU;;;;;;;EAkD/B,kBAAA,CAAmB,UAAA;AAAA"}

package/dist/utils/NamespacedStorage/NamespacedStorage.js

@@ -34,8 +34,18 @@ var NamespacedStorage = class {
 	setItem(key, value) {
 		this._storage.setItem(`${this._keyPrefix}${key}`, value);
 	}
+	/**
+	* Returns the namespaced underlying-storage key for a logical key. Browser
+	* `storage` events fire with the underlying key, so callers that filter
+	* those events need to compare against this value rather than the logical
+	* key. Plain `Storage` instances do not expose this method; callers should
+	* fall back to the logical key in that case.
+	*/
+	getStorageEventKey(logicalKey) {
+		return `${this._keyPrefix}${logicalKey}`;
+	}
 };
-
 //#endregion
 export { NamespacedStorage };
+
 //# sourceMappingURL=NamespacedStorage.js.map

package/dist/utils/NamespacedStorage/NamespacedStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"NamespacedStorage.js","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["export class NamespacedStorage implements Storage {\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n\n  public constructor(namespace: string, storage: Storage) {\n    this._keyPrefix = `${namespace}_`;\n    this._storage = storage;\n  }\n\n  protected getNamespacedKeys(): string[] {\n    const keys = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(this._keyPrefix)) {\n        keys.push(key.substring(this._keyPrefix.length));\n      }\n    }\n\n    return keys;\n  }\n\n  public get length(): number {\n    return this.getNamespacedKeys().length;\n  }\n\n  public clear(): void {\n    this.getNamespacedKeys().forEach((key) => {\n      this._storage.removeItem(`${this._keyPrefix}${key}`);\n    });\n  }\n\n  public getItem(key: string): string | null {\n    return this._storage.getItem(`${this._keyPrefix}${key}`);\n  }\n\n  public key(index: number): string | null {\n    return this.getNamespacedKeys()[index] || null;\n  }\n\n  public removeItem(key: string): void {\n    this._storage.removeItem(`${this._keyPrefix}${key}`);\n  }\n\n  public setItem(key: string, value: string): void {\n    this._storage.setItem(`${this._keyPrefix}${key}`, value);\n  }\n}\n"],"mappings":";AAAA,IAAa,oBAAb,MAAkD;CAChD,AAAiB;CACjB,AAAiB;CAEjB,AAAO,YAAY,WAAmB,SAAkB;AACtD,OAAK,aAAa,GAAG,UAAU;AAC/B,OAAK,WAAW;;CAGlB,AAAU,oBAA8B;EACtC,MAAM,OAAO,EAAE;AACf,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,KAAK;GAC7C,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,KAAK,WAAW,KAAK,WAAW,CAClC,MAAK,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;;AAIpD,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,mBAAmB,CAAC;;CAGlC,AAAO,QAAc;AACnB,OAAK,mBAAmB,CAAC,SAAS,QAAQ;AACxC,QAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;IACpD;;CAGJ,AAAO,QAAQ,KAA4B;AACzC,SAAO,KAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,MAAM;;CAG1D,AAAO,IAAI,OAA8B;AACvC,SAAO,KAAK,mBAAmB,CAAC,UAAU;;CAG5C,AAAO,WAAW,KAAmB;AACnC,OAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;;CAGtD,AAAO,QAAQ,KAAa,OAAqB;AAC/C,OAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,OAAO,MAAM"}
+{"version":3,"file":"NamespacedStorage.js","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["export class NamespacedStorage implements Storage {\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n\n  public constructor(namespace: string, storage: Storage) {\n    this._keyPrefix = `${namespace}_`;\n    this._storage = storage;\n  }\n\n  protected getNamespacedKeys(): string[] {\n    const keys = [];\n    for (let i = 0; i < this._storage.length; i++) {\n      const key = this._storage.key(i);\n      if (key?.startsWith(this._keyPrefix)) {\n        keys.push(key.substring(this._keyPrefix.length));\n      }\n    }\n\n    return keys;\n  }\n\n  public get length(): number {\n    return this.getNamespacedKeys().length;\n  }\n\n  public clear(): void {\n    this.getNamespacedKeys().forEach((key) => {\n      this._storage.removeItem(`${this._keyPrefix}${key}`);\n    });\n  }\n\n  public getItem(key: string): string | null {\n    return this._storage.getItem(`${this._keyPrefix}${key}`);\n  }\n\n  public key(index: number): string | null {\n    return this.getNamespacedKeys()[index] || null;\n  }\n\n  public removeItem(key: string): void {\n    this._storage.removeItem(`${this._keyPrefix}${key}`);\n  }\n\n  public setItem(key: string, value: string): void {\n    this._storage.setItem(`${this._keyPrefix}${key}`, value);\n  }\n\n  /**\n   * Returns the namespaced underlying-storage key for a logical key. Browser\n   * `storage` events fire with the underlying key, so callers that filter\n   * those events need to compare against this value rather than the logical\n   * key. Plain `Storage` instances do not expose this method; callers should\n   * fall back to the logical key in that case.\n   */\n  public getStorageEventKey(logicalKey: string): string {\n    return `${this._keyPrefix}${logicalKey}`;\n  }\n}\n"],"mappings":";AAAA,IAAa,oBAAb,MAAkD;CAChD;CACA;CAEA,YAAmB,WAAmB,SAAkB;AACtD,OAAK,aAAa,GAAG,UAAU;AAC/B,OAAK,WAAW;;CAGlB,oBAAwC;EACtC,MAAM,OAAO,EAAE;AACf,OAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,KAAK;GAC7C,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,KAAK,WAAW,KAAK,WAAW,CAClC,MAAK,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;;AAIpD,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,mBAAmB,CAAC;;CAGlC,QAAqB;AACnB,OAAK,mBAAmB,CAAC,SAAS,QAAQ;AACxC,QAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;IACpD;;CAGJ,QAAe,KAA4B;AACzC,SAAO,KAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,MAAM;;CAG1D,IAAW,OAA8B;AACvC,SAAO,KAAK,mBAAmB,CAAC,UAAU;;CAG5C,WAAkB,KAAmB;AACnC,OAAK,SAAS,WAAW,GAAG,KAAK,aAAa,MAAM;;CAGtD,QAAe,KAAa,OAAqB;AAC/C,OAAK,SAAS,QAAQ,GAAG,KAAK,aAAa,OAAO,MAAM;;;;;;;;;CAU1D,mBAA0B,YAA4B;AACpD,SAAO,GAAG,KAAK,aAAa"}

package/dist/utils/NamespacedStorage/index.cjs

@@ -1,4 +1,3 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_utils_NamespacedStorage_NamespacedStorage = require('./NamespacedStorage.cjs');
-
-exports.NamespacedStorage = require_utils_NamespacedStorage_NamespacedStorage.NamespacedStorage;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_NamespacedStorage_NamespacedStorage = require("./NamespacedStorage.cjs");
+exports.NamespacedStorage = require_utils_NamespacedStorage_NamespacedStorage.NamespacedStorage;

package/dist/utils/NamespacedStorage/index.js

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