@safaricom-mxl/web-sdk 0.0.16 → 0.0.17

package/dist/transport/FetchTransport/FetchTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"FetchTransport.js","names":[],"sources":["../../../src/transport/FetchTransport/FetchTransport.ts"],"sourcesContent":["import { diag } from '@opentelemetry/api';\nimport type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { FetchRequestParameters } from './types';\n\n// The fetch spec limits inflight keepalive request bodies to 64KiB total per\n// page context. We use a conservative budget to leave room for third-party\n// scripts that may also use keepalive or sendBeacon.\n// https://fetch.spec.whatwg.org/#http-network-or-cache-fetch\nconst KEEPALIVE_BYTE_BUDGET = 49152; // 48KiB\n\n// Chrome enforces a 9-request concurrent keepalive limit per renderer process.\nconst MAX_KEEPALIVE_REQUESTS = 9;\n\nlet inflightKeepaliveBytes = 0;\nlet inflightKeepaliveCount = 0;\n\n/** @internal for testing only */\nexport function _resetKeepaliveTracking(): void {\n  inflightKeepaliveBytes = 0;\n  inflightKeepaliveCount = 0;\n}\n\nexport class FetchTransport implements IExporterTransport {\n  public constructor(private readonly _config: FetchRequestParameters) {}\n\n  // MXL endpoints require request bodies to be compressed with gzip\n  private static async _compressRequest(\n    data: Uint8Array<ArrayBuffer>,\n  ): Promise<Uint8Array<ArrayBuffer>> {\n    const stream = new CompressionStream('gzip');\n    const writer = stream.writable.getWriter();\n\n    void writer.write(data);\n    void writer.close();\n\n    const compressedChunks: Uint8Array[] = [];\n    const reader = stream.readable.getReader();\n\n    let done = false;\n    while (!done) {\n      const result = await reader.read();\n\n      if (result.value) {\n        compressedChunks.push(result.value);\n      }\n\n      done = result.done;\n    }\n\n    const compressedData = new Uint8Array(\n      compressedChunks.reduce((acc, chunk) => acc + chunk.length, 0),\n    );\n\n    let offset = 0;\n\n    for (const chunk of compressedChunks) {\n      compressedData.set(chunk, offset);\n      offset += chunk.length;\n    }\n\n    return compressedData;\n  }\n\n  public send(\n    data: Uint8Array<ArrayBuffer>,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    return this._asyncSend(data, timeoutMillis);\n  }\n\n  public shutdown(): void {\n    // Intentionally left empty, nothing to do.\n  }\n\n  public async _asyncSend(\n    data: Uint8Array<ArrayBuffer>,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    let request = data;\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      ...this._config.headers,\n    };\n\n    // Use AbortSignal.timeout if available, otherwise fallback to AbortController\n    // https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static\n    let signal: AbortSignal;\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n    if ('timeout' in AbortSignal) {\n      // ok to ignore because there is a guard\n      // eslint-disable-next-line baseline-js/use-baseline\n      signal = AbortSignal.timeout(timeoutMillis);\n    } else {\n      const controller = new AbortController();\n      signal = controller.signal;\n      timeoutId = setTimeout(() => {\n        controller.abort(new DOMException('TimeoutError', 'TimeoutError'));\n      }, timeoutMillis);\n    }\n\n    let keepalive = false;\n\n    try {\n      if (this._config.compression === 'gzip') {\n        try {\n          request = await FetchTransport._compressRequest(data);\n        } catch (error) {\n          const compressError =\n            error instanceof Error ? error : new Error(String(error));\n          diag.warn(\n            `Fetch transport gzip compression failed: ${compressError.message}`,\n          );\n          return { status: 'failure', error: compressError };\n        }\n        headers['Content-Encoding'] = 'gzip';\n        headers['Content-Length'] = request.length.toString();\n      }\n\n      const wouldExceedBytes =\n        inflightKeepaliveBytes + request.byteLength > KEEPALIVE_BYTE_BUDGET;\n      const wouldExceedCount = inflightKeepaliveCount >= MAX_KEEPALIVE_REQUESTS;\n      keepalive = !wouldExceedBytes && !wouldExceedCount;\n\n      if (keepalive) {\n        inflightKeepaliveBytes += request.byteLength;\n        inflightKeepaliveCount++;\n      } else {\n        const reason = wouldExceedBytes\n          ? `inflight bytes (${inflightKeepaliveBytes} + ${request.byteLength}) would exceed ${KEEPALIVE_BYTE_BUDGET}B budget`\n          : `concurrent count (${inflightKeepaliveCount}) at limit of ${MAX_KEEPALIVE_REQUESTS}`;\n        diag.debug(`Sending without keepalive: ${reason}`);\n      }\n\n      const response = await fetch(this._config.url, {\n        method: 'POST',\n        keepalive,\n        headers,\n        body: request,\n        signal,\n      });\n\n      if (response.ok) {\n        return { status: 'success' };\n      }\n\n      const error = new Error(`${response.status} Fetch request failed`);\n      const message = `Fetch transport received HTTP ${response.status} (keepalive=${keepalive})`;\n      if (response.status >= 500) {\n        diag.debug(message);\n        return { status: 'retryable', error };\n      }\n      diag.warn(message);\n      return { status: 'failure', error };\n    } catch (error) {\n      const fetchError =\n        error instanceof Error ? error : new Error(String(error));\n      const isRetryable =\n        fetchError instanceof TypeError ||\n        (fetchError instanceof DOMException &&\n          fetchError.name === 'TimeoutError');\n      const message = `Fetch transport failed (keepalive=${keepalive}): ${fetchError.message}`;\n      if (isRetryable) {\n        diag.debug(message);\n      } else {\n        diag.warn(message);\n      }\n      return {\n        status: isRetryable ? 'retryable' : 'failure',\n        error: fetchError,\n      };\n    } finally {\n      if (timeoutId !== undefined) {\n        clearTimeout(timeoutId);\n      }\n      if (keepalive) {\n        inflightKeepaliveBytes -= request.byteLength;\n        inflightKeepaliveCount--;\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"FetchTransport.js","names":[],"sources":["../../../src/transport/FetchTransport/FetchTransport.ts"],"sourcesContent":["import { diag } from '@opentelemetry/api';\nimport type {\n  ExportResponse,\n  IExporterTransport,\n} from '@opentelemetry/otlp-exporter-base';\nimport type { FetchRequestParameters } from './types';\n\n// The fetch spec limits inflight keepalive request bodies to 64KiB total per\n// Page context. We use a conservative budget to leave room for third-party\n// Scripts that may also use keepalive or sendBeacon.\n// https://fetch.spec.whatwg.org/#http-network-or-cache-fetch\nconst KEEPALIVE_BYTE_BUDGET = 49_152; // 48KiB\n\n// Chrome enforces a 9-request concurrent keepalive limit per renderer process.\nconst MAX_KEEPALIVE_REQUESTS = 9;\n\nlet inflightKeepaliveBytes = 0;\nlet inflightKeepaliveCount = 0;\n\n/** @internal for testing only */\nexport function _resetKeepaliveTracking(): void {\n  inflightKeepaliveBytes = 0;\n  inflightKeepaliveCount = 0;\n}\n\nexport class FetchTransport implements IExporterTransport {\n  public constructor(private readonly _config: FetchRequestParameters) {}\n\n  // MXL endpoints require request bodies to be compressed with gzip\n  private static async _compressRequest(\n    data: Uint8Array<ArrayBuffer>,\n  ): Promise<Uint8Array<ArrayBuffer>> {\n    const stream = new CompressionStream('gzip');\n    const writer = stream.writable.getWriter();\n\n    void writer.write(data);\n    void writer.close();\n\n    const compressedChunks: Uint8Array[] = [];\n    const reader = stream.readable.getReader();\n\n    let done = false;\n    while (!done) {\n      const result = await reader.read();\n\n      if (result.value) {\n        compressedChunks.push(result.value);\n      }\n\n      ({ done } = result);\n    }\n\n    const compressedData = new Uint8Array(\n      compressedChunks.reduce((acc, chunk) => acc + chunk.length, 0),\n    );\n\n    let offset = 0;\n\n    for (const chunk of compressedChunks) {\n      compressedData.set(chunk, offset);\n      offset += chunk.length;\n    }\n\n    return compressedData;\n  }\n\n  public send(\n    data: Uint8Array<ArrayBuffer>,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    return this._asyncSend(data, timeoutMillis);\n  }\n\n  public shutdown(): void {\n    // Intentionally left empty, nothing to do.\n  }\n\n  public async _asyncSend(\n    data: Uint8Array<ArrayBuffer>,\n    timeoutMillis: number,\n  ): Promise<ExportResponse> {\n    let request = data;\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      ...this._config.headers,\n    };\n\n    // Use AbortSignal.timeout if available, otherwise fallback to AbortController\n    // https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal/timeout_static\n    let signal: AbortSignal;\n    let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n    if ('timeout' in AbortSignal) {\n      // Ok to ignore because there is a guard\n      // eslint-disable-next-line baseline-js/use-baseline\n      signal = AbortSignal.timeout(timeoutMillis);\n    } else {\n      const controller = new AbortController();\n      ({ signal } = controller);\n      timeoutId = setTimeout(() => {\n        controller.abort(new DOMException('TimeoutError', 'TimeoutError'));\n      }, timeoutMillis);\n    }\n\n    let keepalive = false;\n\n    try {\n      if (this._config.compression === 'gzip') {\n        try {\n          request = await FetchTransport._compressRequest(data);\n        } catch (error) {\n          const compressError =\n            error instanceof Error ? error : new Error(String(error));\n          diag.warn(\n            `Fetch transport gzip compression failed: ${compressError.message}`,\n          );\n          return { error: compressError, status: 'failure' };\n        }\n        headers['Content-Encoding'] = 'gzip';\n        headers['Content-Length'] = request.length.toString();\n      }\n\n      const wouldExceedBytes =\n        inflightKeepaliveBytes + request.byteLength > KEEPALIVE_BYTE_BUDGET;\n      const wouldExceedCount = inflightKeepaliveCount >= MAX_KEEPALIVE_REQUESTS;\n      keepalive = !wouldExceedBytes && !wouldExceedCount;\n\n      if (keepalive) {\n        inflightKeepaliveBytes += request.byteLength;\n        inflightKeepaliveCount++;\n      } else {\n        const reason = wouldExceedBytes\n          ? `inflight bytes (${inflightKeepaliveBytes} + ${request.byteLength}) would exceed ${KEEPALIVE_BYTE_BUDGET}B budget`\n          : `concurrent count (${inflightKeepaliveCount}) at limit of ${MAX_KEEPALIVE_REQUESTS}`;\n        diag.debug(`Sending without keepalive: ${reason}`);\n      }\n\n      const response = await fetch(this._config.url, {\n        body: request,\n        headers,\n        keepalive,\n        method: 'POST',\n        signal,\n      });\n\n      if (response.ok) {\n        return { status: 'success' };\n      }\n\n      const error = new Error(`${response.status} Fetch request failed`);\n      const message = `Fetch transport received HTTP ${response.status} (keepalive=${keepalive})`;\n      if (response.status >= 500) {\n        diag.debug(message);\n        return { error, status: 'retryable' };\n      }\n      diag.warn(message);\n      return { error, status: 'failure' };\n    } catch (error) {\n      const fetchError =\n        error instanceof Error ? error : new Error(String(error));\n      const isRetryable =\n        fetchError instanceof TypeError ||\n        (fetchError instanceof DOMException &&\n          fetchError.name === 'TimeoutError');\n      const message = `Fetch transport failed (keepalive=${keepalive}): ${fetchError.message}`;\n      if (isRetryable) {\n        diag.debug(message);\n      } else {\n        diag.warn(message);\n      }\n      return {\n        error: fetchError,\n        status: isRetryable ? 'retryable' : 'failure',\n      };\n    } finally {\n      if (timeoutId !== undefined) {\n        clearTimeout(timeoutId);\n      }\n      if (keepalive) {\n        inflightKeepaliveBytes -= request.byteLength;\n        inflightKeepaliveCount--;\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/transport/RetryingTransport/RetryingTransport.cjs

@@ -19,7 +19,7 @@ var RetryingTransport = class {
 		while (result.status === "retryable" && attempts > 0) {
 			attempts--;
 			const backoff = Math.max(Math.min(nextBackoff, require_transport_RetryingTransport_constants.MAX_BACKOFF) + getJitter(), 0);
-			nextBackoff = nextBackoff * require_transport_RetryingTransport_constants.BACKOFF_MULTIPLIER;
+			nextBackoff *= require_transport_RetryingTransport_constants.BACKOFF_MULTIPLIER;
 			const retryInMillis = result.retryInMillis ?? backoff;
 			const remainingTimeoutMillis = deadline - this._perf.getNowMillis();
 			if (retryInMillis > remainingTimeoutMillis) return result;

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

@@ -1 +1 @@
-{"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';\nimport { OTelPerformanceManager } from '../../utils';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants';\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"}
+{"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';\nimport { OTelPerformanceManager } from '../../utils';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants';\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 *= 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,kBAAeC,8CAAAA;GACf,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.js

@@ -18,7 +18,7 @@ var RetryingTransport = class {
 		while (result.status === "retryable" && attempts > 0) {
 			attempts--;
 			const backoff = Math.max(Math.min(nextBackoff, MAX_BACKOFF) + getJitter(), 0);
-			nextBackoff = nextBackoff * BACKOFF_MULTIPLIER;
+			nextBackoff *= BACKOFF_MULTIPLIER;
 			const retryInMillis = result.retryInMillis ?? backoff;
 			const remainingTimeoutMillis = deadline - this._perf.getNowMillis();
 			if (retryInMillis > remainingTimeoutMillis) return result;

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';\nimport { OTelPerformanceManager } from '../../utils';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants';\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"}
+{"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';\nimport { OTelPerformanceManager } from '../../utils';\nimport {\n  BACKOFF_MULTIPLIER,\n  INITIAL_BACKOFF,\n  JITTER,\n  MAX_ATTEMPTS,\n  MAX_BACKOFF,\n} from './constants';\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 *= 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,kBAAe;GACf,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/utils/NamespacedStorage/NamespacedStorage.cjs

@@ -1,49 +1,94 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../_virtual/_rolldown/runtime.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
 //#region src/utils/NamespacedStorage/NamespacedStorage.ts
+/**
+* `Storage`-shaped wrapper that isolates the SDK from storage errors and
+* optionally namespaces keys with a prefix. Mutation methods return `true`
+* on success and `false` when the call failed or writes have been disabled.
+*/
 var NamespacedStorage = class {
+	_diag;
 	_keyPrefix;
 	_storage;
-	constructor(namespace, storage) {
-		this._keyPrefix = `${namespace}_`;
+	_writeDisabled = false;
+	constructor({ namespace, storage, diag: diagParam }) {
+		this._diag = diagParam ?? _opentelemetry_api.diag.createComponentLogger({ namespace: "NamespacedStorage" });
+		this._keyPrefix = namespace ? `${namespace}__` : "";
 		this._storage = storage;
 	}
-	getNamespacedKeys() {
-		const keys = [];
-		for (let i = 0; i < this._storage.length; i++) {
+	keys() {
+		let length;
+		try {
+			({length} = this._storage);
+		} catch (error) {
+			this._diag.warn("failed to read storage length", String(error));
+			return [];
+		}
+		const result = [];
+		for (let i = 0; i < length; i++) try {
 			const key = this._storage.key(i);
-			if (key?.startsWith(this._keyPrefix)) keys.push(key.substring(this._keyPrefix.length));
+			if (key === null) continue;
+			if (this._keyPrefix) {
+				if (key.startsWith(this._keyPrefix)) result.push(key.substring(this._keyPrefix.length));
+			} else result.push(key);
+		} catch (error) {
+			this._diag.warn(`failed to read storage key at index ${i.toString()}`, String(error));
 		}
-		return keys;
+		return result;
 	}
 	get length() {
-		return this.getNamespacedKeys().length;
+		return this.keys().length;
 	}
 	clear() {
-		this.getNamespacedKeys().forEach((key) => {
-			this._storage.removeItem(`${this._keyPrefix}${key}`);
-		});
+		let allRemoved = true;
+		for (const key of this.keys()) if (!this._safeRemove(this._keyName(key))) allRemoved = false;
+		return allRemoved;
 	}
 	getItem(key) {
-		return this._storage.getItem(`${this._keyPrefix}${key}`);
+		try {
+			return this._storage.getItem(this._keyName(key));
+		} catch (error) {
+			this._diag.warn(`failed to read ${key}`, String(error));
+			return null;
+		}
 	}
 	key(index) {
-		return this.getNamespacedKeys()[index] || null;
+		return this.keys()[index] ?? null;
 	}
 	removeItem(key) {
-		this._storage.removeItem(`${this._keyPrefix}${key}`);
+		return this._safeRemove(this._keyName(key));
 	}
 	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.
-	*/
+		if (this._writeDisabled) return false;
+		try {
+			this._storage.setItem(this._keyName(key), value);
+			return true;
+		} catch (error) {
+			this._disableWrites(error);
+			return false;
+		}
+	}
 	getStorageEventKey(logicalKey) {
-		return `${this._keyPrefix}${logicalKey}`;
+		return this._keyName(logicalKey);
+	}
+	_keyName(key) {
+		return `${this._keyPrefix}${key}`;
+	}
+	_safeRemove(keyName) {
+		try {
+			this._storage.removeItem(keyName);
+			return true;
+		} catch (error) {
+			this._diag.warn(`failed to remove ${keyName}`, String(error));
+			return false;
+		}
+	}
+	_disableWrites(error) {
+		if (this._writeDisabled) return;
+		this._writeDisabled = true;
+		const errorName = error instanceof Error ? error.name : "UnknownError";
+		this._diag.error("writes disabled after failure; continuing in-memory only", errorName);
 	}
 };
 //#endregion

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  /**\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"}
+{"version":3,"file":"NamespacedStorage.cjs","names":["diag"],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\n\ninterface NamespacedStorageArgs {\n  storage: Storage;\n  namespace?: string;\n  diag?: DiagLogger;\n}\n\n/**\n * `Storage`-shaped wrapper that isolates the SDK from storage errors and\n * optionally namespaces keys with a prefix. Mutation methods return `true`\n * on success and `false` when the call failed or writes have been disabled.\n */\nexport class NamespacedStorage {\n  private readonly _diag: DiagLogger;\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n  private _writeDisabled = false;\n\n  public constructor({\n    namespace,\n    storage,\n    diag: diagParam,\n  }: NamespacedStorageArgs) {\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({ namespace: 'NamespacedStorage' });\n    this._keyPrefix = namespace ? `${namespace}__` : '';\n    this._storage = storage;\n  }\n\n  public keys(): string[] {\n    let length: number;\n    try {\n      ({ length } = this._storage);\n    } catch (error) {\n      this._diag.warn('failed to read storage length', String(error));\n      return [];\n    }\n    const result: string[] = [];\n    for (let i = 0; i < length; i++) {\n      try {\n        const key = this._storage.key(i);\n        if (key === null) {\n          continue;\n        }\n        if (this._keyPrefix) {\n          if (key.startsWith(this._keyPrefix)) {\n            result.push(key.substring(this._keyPrefix.length));\n          }\n        } else {\n          result.push(key);\n        }\n      } catch (error) {\n        this._diag.warn(\n          `failed to read storage key at index ${i.toString()}`,\n          String(error),\n        );\n      }\n    }\n    return result;\n  }\n\n  public get length(): number {\n    return this.keys().length;\n  }\n\n  public clear(): boolean {\n    let allRemoved = true;\n    for (const key of this.keys()) {\n      if (!this._safeRemove(this._keyName(key))) {\n        allRemoved = false;\n      }\n    }\n    return allRemoved;\n  }\n\n  public getItem(key: string): string | null {\n    try {\n      return this._storage.getItem(this._keyName(key));\n    } catch (error) {\n      this._diag.warn(`failed to read ${key}`, String(error));\n      return null;\n    }\n  }\n\n  public key(index: number): string | null {\n    return this.keys()[index] ?? null;\n  }\n\n  public removeItem(key: string): boolean {\n    return this._safeRemove(this._keyName(key));\n  }\n\n  public setItem(key: string, value: string): boolean {\n    if (this._writeDisabled) {\n      return false;\n    }\n    try {\n      this._storage.setItem(this._keyName(key), value);\n      return true;\n    } catch (error) {\n      this._disableWrites(error);\n      return false;\n    }\n  }\n\n  public getStorageEventKey(logicalKey: string): string {\n    return this._keyName(logicalKey);\n  }\n\n  private _keyName(key: string): string {\n    return `${this._keyPrefix}${key}`;\n  }\n\n  private _safeRemove(keyName: string): boolean {\n    try {\n      this._storage.removeItem(keyName);\n      return true;\n    } catch (error) {\n      this._diag.warn(`failed to remove ${keyName}`, String(error));\n      return false;\n    }\n  }\n\n  private _disableWrites(error: unknown): void {\n    if (this._writeDisabled) {\n      return;\n    }\n    this._writeDisabled = true;\n    const errorName = error instanceof Error ? error.name : 'UnknownError';\n    this._diag.error(\n      'writes disabled after failure; continuing in-memory only',\n      errorName,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;AAcA,IAAa,oBAAb,MAA+B;CAC7B;CACA;CACA;CACA,iBAAyB;CAEzB,YAAmB,EACjB,WACA,SACA,MAAM,aACkB;AACxB,OAAK,QACH,aACAA,mBAAAA,KAAK,sBAAsB,EAAE,WAAW,qBAAqB,CAAC;AAChE,OAAK,aAAa,YAAY,GAAG,UAAU,MAAM;AACjD,OAAK,WAAW;;CAGlB,OAAwB;EACtB,IAAI;AACJ,MAAI;AACF,IAAC,CAAE,UAAW,KAAK;WACZ,OAAO;AACd,QAAK,MAAM,KAAK,iCAAiC,OAAO,MAAM,CAAC;AAC/D,UAAO,EAAE;;EAEX,MAAM,SAAmB,EAAE;AAC3B,OAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,KAAI;GACF,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,QAAQ,KACV;AAEF,OAAI,KAAK;QACH,IAAI,WAAW,KAAK,WAAW,CACjC,QAAO,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;SAGpD,QAAO,KAAK,IAAI;WAEX,OAAO;AACd,QAAK,MAAM,KACT,uCAAuC,EAAE,UAAU,IACnD,OAAO,MAAM,CACd;;AAGL,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,MAAM,CAAC;;CAGrB,QAAwB;EACtB,IAAI,aAAa;AACjB,OAAK,MAAM,OAAO,KAAK,MAAM,CAC3B,KAAI,CAAC,KAAK,YAAY,KAAK,SAAS,IAAI,CAAC,CACvC,cAAa;AAGjB,SAAO;;CAGT,QAAe,KAA4B;AACzC,MAAI;AACF,UAAO,KAAK,SAAS,QAAQ,KAAK,SAAS,IAAI,CAAC;WACzC,OAAO;AACd,QAAK,MAAM,KAAK,kBAAkB,OAAO,OAAO,MAAM,CAAC;AACvD,UAAO;;;CAIX,IAAW,OAA8B;AACvC,SAAO,KAAK,MAAM,CAAC,UAAU;;CAG/B,WAAkB,KAAsB;AACtC,SAAO,KAAK,YAAY,KAAK,SAAS,IAAI,CAAC;;CAG7C,QAAe,KAAa,OAAwB;AAClD,MAAI,KAAK,eACP,QAAO;AAET,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,SAAS,IAAI,EAAE,MAAM;AAChD,UAAO;WACA,OAAO;AACd,QAAK,eAAe,MAAM;AAC1B,UAAO;;;CAIX,mBAA0B,YAA4B;AACpD,SAAO,KAAK,SAAS,WAAW;;CAGlC,SAAiB,KAAqB;AACpC,SAAO,GAAG,KAAK,aAAa;;CAG9B,YAAoB,SAA0B;AAC5C,MAAI;AACF,QAAK,SAAS,WAAW,QAAQ;AACjC,UAAO;WACA,OAAO;AACd,QAAK,MAAM,KAAK,oBAAoB,WAAW,OAAO,MAAM,CAAC;AAC7D,UAAO;;;CAIX,eAAuB,OAAsB;AAC3C,MAAI,KAAK,eACP;AAEF,OAAK,iBAAiB;EACtB,MAAM,YAAY,iBAAiB,QAAQ,MAAM,OAAO;AACxD,OAAK,MAAM,MACT,4DACA,UACD"}

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

@@ -1,23 +1,37 @@
+import { DiagLogger } from "@opentelemetry/api";
+
 //#region src/utils/NamespacedStorage/NamespacedStorage.d.ts
-declare class NamespacedStorage implements Storage {
+interface NamespacedStorageArgs {
+  storage: Storage;
+  namespace?: string;
+  diag?: DiagLogger;
+}
+/**
+ * `Storage`-shaped wrapper that isolates the SDK from storage errors and
+ * optionally namespaces keys with a prefix. Mutation methods return `true`
+ * on success and `false` when the call failed or writes have been disabled.
+ */
+declare class NamespacedStorage {
+  private readonly _diag;
   private readonly _keyPrefix;
   private readonly _storage;
-  constructor(namespace: string, storage: Storage);
-  protected getNamespacedKeys(): string[];
+  private _writeDisabled;
+  constructor({
+    namespace,
+    storage,
+    diag: diagParam
+  }: NamespacedStorageArgs);
+  keys(): string[];
   get length(): number;
-  clear(): void;
+  clear(): boolean;
   getItem(key: string): string | null;
   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.
-   */
+  removeItem(key: string): boolean;
+  setItem(key: string, value: string): boolean;
   getStorageEventKey(logicalKey: string): string;
+  private _keyName;
+  private _safeRemove;
+  private _disableWrites;
 }
 //#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;EAvCU;;;;;;;EAkD/B,kBAAA,CAAmB,UAAA;AAAA"}
+{"version":3,"file":"NamespacedStorage.d.cts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";;;UAGU,qBAAA;EACR,OAAA,EAAS,OAAA;EACT,SAAA;EACA,IAAA,GAAO,UAAA;AAAA;;;;;;cAQI,iBAAA;EAAA,iBACM,KAAA;EAAA,iBACA,UAAA;EAAA,iBACA,QAAA;EAAA,QACT,cAAA;;IAGN,SAAA;IACA,OAAA;IACA,IAAA,EAAM;EAAA,GACL,qBAAA;EAQI,IAAA,CAAA;EAAA,IAgCI,MAAA,CAAA;EAIJ,KAAA,CAAA;EAUA,OAAA,CAAQ,GAAA;EASR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;EAarB,kBAAA,CAAmB,UAAA;EAAA,QAIlB,QAAA;EAAA,QAIA,WAAA;EAAA,QAUA,cAAA;AAAA"}

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

@@ -1,23 +1,37 @@
+import { DiagLogger } from "@opentelemetry/api";
+
 //#region src/utils/NamespacedStorage/NamespacedStorage.d.ts
-declare class NamespacedStorage implements Storage {
+interface NamespacedStorageArgs {
+  storage: Storage;
+  namespace?: string;
+  diag?: DiagLogger;
+}
+/**
+ * `Storage`-shaped wrapper that isolates the SDK from storage errors and
+ * optionally namespaces keys with a prefix. Mutation methods return `true`
+ * on success and `false` when the call failed or writes have been disabled.
+ */
+declare class NamespacedStorage {
+  private readonly _diag;
   private readonly _keyPrefix;
   private readonly _storage;
-  constructor(namespace: string, storage: Storage);
-  protected getNamespacedKeys(): string[];
+  private _writeDisabled;
+  constructor({
+    namespace,
+    storage,
+    diag: diagParam
+  }: NamespacedStorageArgs);
+  keys(): string[];
   get length(): number;
-  clear(): void;
+  clear(): boolean;
   getItem(key: string): string | null;
   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.
-   */
+  removeItem(key: string): boolean;
+  setItem(key: string, value: string): boolean;
   getStorageEventKey(logicalKey: string): string;
+  private _keyName;
+  private _safeRemove;
+  private _disableWrites;
 }
 //#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;EAvCU;;;;;;;EAkD/B,kBAAA,CAAmB,UAAA;AAAA"}
+{"version":3,"file":"NamespacedStorage.d.ts","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"mappings":";;;UAGU,qBAAA;EACR,OAAA,EAAS,OAAA;EACT,SAAA;EACA,IAAA,GAAO,UAAA;AAAA;;;;;;cAQI,iBAAA;EAAA,iBACM,KAAA;EAAA,iBACA,UAAA;EAAA,iBACA,QAAA;EAAA,QACT,cAAA;;IAGN,SAAA;IACA,OAAA;IACA,IAAA,EAAM;EAAA,GACL,qBAAA;EAQI,IAAA,CAAA;EAAA,IAgCI,MAAA,CAAA;EAIJ,KAAA,CAAA;EAUA,OAAA,CAAQ,GAAA;EASR,GAAA,CAAI,KAAA;EAIJ,UAAA,CAAW,GAAA;EAIX,OAAA,CAAQ,GAAA,UAAa,KAAA;EAarB,kBAAA,CAAmB,UAAA;EAAA,QAIlB,QAAA;EAAA,QAIA,WAAA;EAAA,QAUA,cAAA;AAAA"}

package/dist/utils/NamespacedStorage/NamespacedStorage.js

@@ -1,48 +1,92 @@
+import { diag } from "@opentelemetry/api";
 //#region src/utils/NamespacedStorage/NamespacedStorage.ts
+/**
+* `Storage`-shaped wrapper that isolates the SDK from storage errors and
+* optionally namespaces keys with a prefix. Mutation methods return `true`
+* on success and `false` when the call failed or writes have been disabled.
+*/
 var NamespacedStorage = class {
+	_diag;
 	_keyPrefix;
 	_storage;
-	constructor(namespace, storage) {
-		this._keyPrefix = `${namespace}_`;
+	_writeDisabled = false;
+	constructor({ namespace, storage, diag: diagParam }) {
+		this._diag = diagParam ?? diag.createComponentLogger({ namespace: "NamespacedStorage" });
+		this._keyPrefix = namespace ? `${namespace}__` : "";
 		this._storage = storage;
 	}
-	getNamespacedKeys() {
-		const keys = [];
-		for (let i = 0; i < this._storage.length; i++) {
+	keys() {
+		let length;
+		try {
+			({length} = this._storage);
+		} catch (error) {
+			this._diag.warn("failed to read storage length", String(error));
+			return [];
+		}
+		const result = [];
+		for (let i = 0; i < length; i++) try {
 			const key = this._storage.key(i);
-			if (key?.startsWith(this._keyPrefix)) keys.push(key.substring(this._keyPrefix.length));
+			if (key === null) continue;
+			if (this._keyPrefix) {
+				if (key.startsWith(this._keyPrefix)) result.push(key.substring(this._keyPrefix.length));
+			} else result.push(key);
+		} catch (error) {
+			this._diag.warn(`failed to read storage key at index ${i.toString()}`, String(error));
 		}
-		return keys;
+		return result;
 	}
 	get length() {
-		return this.getNamespacedKeys().length;
+		return this.keys().length;
 	}
 	clear() {
-		this.getNamespacedKeys().forEach((key) => {
-			this._storage.removeItem(`${this._keyPrefix}${key}`);
-		});
+		let allRemoved = true;
+		for (const key of this.keys()) if (!this._safeRemove(this._keyName(key))) allRemoved = false;
+		return allRemoved;
 	}
 	getItem(key) {
-		return this._storage.getItem(`${this._keyPrefix}${key}`);
+		try {
+			return this._storage.getItem(this._keyName(key));
+		} catch (error) {
+			this._diag.warn(`failed to read ${key}`, String(error));
+			return null;
+		}
 	}
 	key(index) {
-		return this.getNamespacedKeys()[index] || null;
+		return this.keys()[index] ?? null;
 	}
 	removeItem(key) {
-		this._storage.removeItem(`${this._keyPrefix}${key}`);
+		return this._safeRemove(this._keyName(key));
 	}
 	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.
-	*/
+		if (this._writeDisabled) return false;
+		try {
+			this._storage.setItem(this._keyName(key), value);
+			return true;
+		} catch (error) {
+			this._disableWrites(error);
+			return false;
+		}
+	}
 	getStorageEventKey(logicalKey) {
-		return `${this._keyPrefix}${logicalKey}`;
+		return this._keyName(logicalKey);
+	}
+	_keyName(key) {
+		return `${this._keyPrefix}${key}`;
+	}
+	_safeRemove(keyName) {
+		try {
+			this._storage.removeItem(keyName);
+			return true;
+		} catch (error) {
+			this._diag.warn(`failed to remove ${keyName}`, String(error));
+			return false;
+		}
+	}
+	_disableWrites(error) {
+		if (this._writeDisabled) return;
+		this._writeDisabled = true;
+		const errorName = error instanceof Error ? error.name : "UnknownError";
+		this._diag.error("writes disabled after failure; continuing in-memory only", errorName);
 	}
 };
 //#endregion

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  /**\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"}
+{"version":3,"file":"NamespacedStorage.js","names":[],"sources":["../../../src/utils/NamespacedStorage/NamespacedStorage.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport { diag } from '@opentelemetry/api';\n\ninterface NamespacedStorageArgs {\n  storage: Storage;\n  namespace?: string;\n  diag?: DiagLogger;\n}\n\n/**\n * `Storage`-shaped wrapper that isolates the SDK from storage errors and\n * optionally namespaces keys with a prefix. Mutation methods return `true`\n * on success and `false` when the call failed or writes have been disabled.\n */\nexport class NamespacedStorage {\n  private readonly _diag: DiagLogger;\n  private readonly _keyPrefix: string;\n  private readonly _storage: Storage;\n  private _writeDisabled = false;\n\n  public constructor({\n    namespace,\n    storage,\n    diag: diagParam,\n  }: NamespacedStorageArgs) {\n    this._diag =\n      diagParam ??\n      diag.createComponentLogger({ namespace: 'NamespacedStorage' });\n    this._keyPrefix = namespace ? `${namespace}__` : '';\n    this._storage = storage;\n  }\n\n  public keys(): string[] {\n    let length: number;\n    try {\n      ({ length } = this._storage);\n    } catch (error) {\n      this._diag.warn('failed to read storage length', String(error));\n      return [];\n    }\n    const result: string[] = [];\n    for (let i = 0; i < length; i++) {\n      try {\n        const key = this._storage.key(i);\n        if (key === null) {\n          continue;\n        }\n        if (this._keyPrefix) {\n          if (key.startsWith(this._keyPrefix)) {\n            result.push(key.substring(this._keyPrefix.length));\n          }\n        } else {\n          result.push(key);\n        }\n      } catch (error) {\n        this._diag.warn(\n          `failed to read storage key at index ${i.toString()}`,\n          String(error),\n        );\n      }\n    }\n    return result;\n  }\n\n  public get length(): number {\n    return this.keys().length;\n  }\n\n  public clear(): boolean {\n    let allRemoved = true;\n    for (const key of this.keys()) {\n      if (!this._safeRemove(this._keyName(key))) {\n        allRemoved = false;\n      }\n    }\n    return allRemoved;\n  }\n\n  public getItem(key: string): string | null {\n    try {\n      return this._storage.getItem(this._keyName(key));\n    } catch (error) {\n      this._diag.warn(`failed to read ${key}`, String(error));\n      return null;\n    }\n  }\n\n  public key(index: number): string | null {\n    return this.keys()[index] ?? null;\n  }\n\n  public removeItem(key: string): boolean {\n    return this._safeRemove(this._keyName(key));\n  }\n\n  public setItem(key: string, value: string): boolean {\n    if (this._writeDisabled) {\n      return false;\n    }\n    try {\n      this._storage.setItem(this._keyName(key), value);\n      return true;\n    } catch (error) {\n      this._disableWrites(error);\n      return false;\n    }\n  }\n\n  public getStorageEventKey(logicalKey: string): string {\n    return this._keyName(logicalKey);\n  }\n\n  private _keyName(key: string): string {\n    return `${this._keyPrefix}${key}`;\n  }\n\n  private _safeRemove(keyName: string): boolean {\n    try {\n      this._storage.removeItem(keyName);\n      return true;\n    } catch (error) {\n      this._diag.warn(`failed to remove ${keyName}`, String(error));\n      return false;\n    }\n  }\n\n  private _disableWrites(error: unknown): void {\n    if (this._writeDisabled) {\n      return;\n    }\n    this._writeDisabled = true;\n    const errorName = error instanceof Error ? error.name : 'UnknownError';\n    this._diag.error(\n      'writes disabled after failure; continuing in-memory only',\n      errorName,\n    );\n  }\n}\n"],"mappings":";;;;;;;AAcA,IAAa,oBAAb,MAA+B;CAC7B;CACA;CACA;CACA,iBAAyB;CAEzB,YAAmB,EACjB,WACA,SACA,MAAM,aACkB;AACxB,OAAK,QACH,aACA,KAAK,sBAAsB,EAAE,WAAW,qBAAqB,CAAC;AAChE,OAAK,aAAa,YAAY,GAAG,UAAU,MAAM;AACjD,OAAK,WAAW;;CAGlB,OAAwB;EACtB,IAAI;AACJ,MAAI;AACF,IAAC,CAAE,UAAW,KAAK;WACZ,OAAO;AACd,QAAK,MAAM,KAAK,iCAAiC,OAAO,MAAM,CAAC;AAC/D,UAAO,EAAE;;EAEX,MAAM,SAAmB,EAAE;AAC3B,OAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,IAC1B,KAAI;GACF,MAAM,MAAM,KAAK,SAAS,IAAI,EAAE;AAChC,OAAI,QAAQ,KACV;AAEF,OAAI,KAAK;QACH,IAAI,WAAW,KAAK,WAAW,CACjC,QAAO,KAAK,IAAI,UAAU,KAAK,WAAW,OAAO,CAAC;SAGpD,QAAO,KAAK,IAAI;WAEX,OAAO;AACd,QAAK,MAAM,KACT,uCAAuC,EAAE,UAAU,IACnD,OAAO,MAAM,CACd;;AAGL,SAAO;;CAGT,IAAW,SAAiB;AAC1B,SAAO,KAAK,MAAM,CAAC;;CAGrB,QAAwB;EACtB,IAAI,aAAa;AACjB,OAAK,MAAM,OAAO,KAAK,MAAM,CAC3B,KAAI,CAAC,KAAK,YAAY,KAAK,SAAS,IAAI,CAAC,CACvC,cAAa;AAGjB,SAAO;;CAGT,QAAe,KAA4B;AACzC,MAAI;AACF,UAAO,KAAK,SAAS,QAAQ,KAAK,SAAS,IAAI,CAAC;WACzC,OAAO;AACd,QAAK,MAAM,KAAK,kBAAkB,OAAO,OAAO,MAAM,CAAC;AACvD,UAAO;;;CAIX,IAAW,OAA8B;AACvC,SAAO,KAAK,MAAM,CAAC,UAAU;;CAG/B,WAAkB,KAAsB;AACtC,SAAO,KAAK,YAAY,KAAK,SAAS,IAAI,CAAC;;CAG7C,QAAe,KAAa,OAAwB;AAClD,MAAI,KAAK,eACP,QAAO;AAET,MAAI;AACF,QAAK,SAAS,QAAQ,KAAK,SAAS,IAAI,EAAE,MAAM;AAChD,UAAO;WACA,OAAO;AACd,QAAK,eAAe,MAAM;AAC1B,UAAO;;;CAIX,mBAA0B,YAA4B;AACpD,SAAO,KAAK,SAAS,WAAW;;CAGlC,SAAiB,KAAqB;AACpC,SAAO,GAAG,KAAK,aAAa;;CAG9B,YAAoB,SAA0B;AAC5C,MAAI;AACF,QAAK,SAAS,WAAW,QAAQ;AACjC,UAAO;WACA,OAAO;AACd,QAAK,MAAM,KAAK,oBAAoB,WAAW,OAAO,MAAM,CAAC;AAC7D,UAAO;;;CAIX,eAAuB,OAAsB;AAC3C,MAAI,KAAK,eACP;AAEF,OAAK,iBAAiB;EACtB,MAAM,YAAY,iBAAiB,QAAQ,MAAM,OAAO;AACxD,OAAK,MAAM,MACT,4DACA,UACD"}

package/dist/utils/PerformanceManager/OTelPerformanceManager.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"OTelPerformanceManager.cjs","names":[],"sources":["../../../src/utils/PerformanceManager/OTelPerformanceManager.ts"],"sourcesContent":["import type { HrTime } from '@opentelemetry/api';\nimport { hrTimeToMilliseconds, millisToHrTime } from '@opentelemetry/core';\nimport type { PerformanceClock, PerformanceManager } from './types';\n\nexport class OTelPerformanceManager implements PerformanceManager {\n  private readonly _clock: PerformanceClock;\n\n  public constructor(clock: PerformanceClock = window.performance) {\n    this._clock = clock;\n  }\n\n  public epochMillisFromOriginOffset = (originOffset: number) =>\n    this._clock.timeOrigin + originOffset;\n\n  public getNowHRTime = () => millisToHrTime(this.getNowMillis());\n\n  public getNowMillis = () =>\n    this.epochMillisFromOriginOffset(this._clock.now()); // otperformance.now() returns milliseconds since timeOrigin, timeOrigin is the time from epoch to the start of the page load\n\n  public millisSinceHRTime = (time: HrTime) =>\n    this.getNowMillis() - hrTimeToMilliseconds(time);\n\n  // Returns milliseconds elapsed since the SDK's zero time (currently navigation\n  // start). When soft-navigation support is added, this method will subtract the\n  // reset point so timings remain relative to the soft navigation.\n  public millisFromZeroTime = (originOffset: number) => originOffset;\n}\n"],"mappings":";;;;AAIA,IAAa,yBAAb,MAAkE;CAChE;CAEA,YAAmB,QAA0B,OAAO,aAAa;AAC/D,OAAK,SAAS;;CAGhB,+BAAsC,iBACpC,KAAK,OAAO,aAAa;CAE3B,sBAAO,GAAA,oBAAA,gBAAoC,KAAK,cAAc,CAAC;CAE/D,qBACE,KAAK,4BAA4B,KAAK,OAAO,KAAK,CAAC;CAErD,qBAA4B,SAC1B,KAAK,cAAc,IAAA,GAAA,oBAAA,sBAAwB,KAAK;CAKlD,sBAA6B,iBAAyB"}
+{"version":3,"file":"OTelPerformanceManager.cjs","names":[],"sources":["../../../src/utils/PerformanceManager/OTelPerformanceManager.ts"],"sourcesContent":["import type { HrTime } from '@opentelemetry/api';\nimport { hrTimeToMilliseconds, millisToHrTime } from '@opentelemetry/core';\nimport type { PerformanceClock, PerformanceManager } from './types';\n\nexport class OTelPerformanceManager implements PerformanceManager {\n  private readonly _clock: PerformanceClock;\n\n  public constructor(clock: PerformanceClock = window.performance) {\n    this._clock = clock;\n  }\n\n  public epochMillisFromOriginOffset = (originOffset: number) =>\n    this._clock.timeOrigin + originOffset;\n\n  public getNowHRTime = () => millisToHrTime(this.getNowMillis());\n\n  public getNowMillis = () =>\n    this.epochMillisFromOriginOffset(this._clock.now()); // Otperformance.now() returns milliseconds since timeOrigin, timeOrigin is the time from epoch to the start of the page load\n\n  public millisSinceHRTime = (time: HrTime) =>\n    this.getNowMillis() - hrTimeToMilliseconds(time);\n\n  // Returns milliseconds elapsed since the SDK's zero time (currently navigation\n  // Start). When soft-navigation support is added, this method will subtract the\n  // Reset point so timings remain relative to the soft navigation.\n  public millisFromZeroTime = (originOffset: number) => originOffset;\n}\n"],"mappings":";;;;AAIA,IAAa,yBAAb,MAAkE;CAChE;CAEA,YAAmB,QAA0B,OAAO,aAAa;AAC/D,OAAK,SAAS;;CAGhB,+BAAsC,iBACpC,KAAK,OAAO,aAAa;CAE3B,sBAAO,GAAA,oBAAA,gBAAoC,KAAK,cAAc,CAAC;CAE/D,qBACE,KAAK,4BAA4B,KAAK,OAAO,KAAK,CAAC;CAErD,qBAA4B,SAC1B,KAAK,cAAc,IAAA,GAAA,oBAAA,sBAAwB,KAAK;CAKlD,sBAA6B,iBAAyB"}

package/dist/utils/PerformanceManager/OTelPerformanceManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"OTelPerformanceManager.js","names":[],"sources":["../../../src/utils/PerformanceManager/OTelPerformanceManager.ts"],"sourcesContent":["import type { HrTime } from '@opentelemetry/api';\nimport { hrTimeToMilliseconds, millisToHrTime } from '@opentelemetry/core';\nimport type { PerformanceClock, PerformanceManager } from './types';\n\nexport class OTelPerformanceManager implements PerformanceManager {\n  private readonly _clock: PerformanceClock;\n\n  public constructor(clock: PerformanceClock = window.performance) {\n    this._clock = clock;\n  }\n\n  public epochMillisFromOriginOffset = (originOffset: number) =>\n    this._clock.timeOrigin + originOffset;\n\n  public getNowHRTime = () => millisToHrTime(this.getNowMillis());\n\n  public getNowMillis = () =>\n    this.epochMillisFromOriginOffset(this._clock.now()); // otperformance.now() returns milliseconds since timeOrigin, timeOrigin is the time from epoch to the start of the page load\n\n  public millisSinceHRTime = (time: HrTime) =>\n    this.getNowMillis() - hrTimeToMilliseconds(time);\n\n  // Returns milliseconds elapsed since the SDK's zero time (currently navigation\n  // start). When soft-navigation support is added, this method will subtract the\n  // reset point so timings remain relative to the soft navigation.\n  public millisFromZeroTime = (originOffset: number) => originOffset;\n}\n"],"mappings":";;AAIA,IAAa,yBAAb,MAAkE;CAChE;CAEA,YAAmB,QAA0B,OAAO,aAAa;AAC/D,OAAK,SAAS;;CAGhB,+BAAsC,iBACpC,KAAK,OAAO,aAAa;CAE3B,qBAA4B,eAAe,KAAK,cAAc,CAAC;CAE/D,qBACE,KAAK,4BAA4B,KAAK,OAAO,KAAK,CAAC;CAErD,qBAA4B,SAC1B,KAAK,cAAc,GAAG,qBAAqB,KAAK;CAKlD,sBAA6B,iBAAyB"}
+{"version":3,"file":"OTelPerformanceManager.js","names":[],"sources":["../../../src/utils/PerformanceManager/OTelPerformanceManager.ts"],"sourcesContent":["import type { HrTime } from '@opentelemetry/api';\nimport { hrTimeToMilliseconds, millisToHrTime } from '@opentelemetry/core';\nimport type { PerformanceClock, PerformanceManager } from './types';\n\nexport class OTelPerformanceManager implements PerformanceManager {\n  private readonly _clock: PerformanceClock;\n\n  public constructor(clock: PerformanceClock = window.performance) {\n    this._clock = clock;\n  }\n\n  public epochMillisFromOriginOffset = (originOffset: number) =>\n    this._clock.timeOrigin + originOffset;\n\n  public getNowHRTime = () => millisToHrTime(this.getNowMillis());\n\n  public getNowMillis = () =>\n    this.epochMillisFromOriginOffset(this._clock.now()); // Otperformance.now() returns milliseconds since timeOrigin, timeOrigin is the time from epoch to the start of the page load\n\n  public millisSinceHRTime = (time: HrTime) =>\n    this.getNowMillis() - hrTimeToMilliseconds(time);\n\n  // Returns milliseconds elapsed since the SDK's zero time (currently navigation\n  // Start). When soft-navigation support is added, this method will subtract the\n  // Reset point so timings remain relative to the soft navigation.\n  public millisFromZeroTime = (originOffset: number) => originOffset;\n}\n"],"mappings":";;AAIA,IAAa,yBAAb,MAAkE;CAChE;CAEA,YAAmB,QAA0B,OAAO,aAAa;AAC/D,OAAK,SAAS;;CAGhB,+BAAsC,iBACpC,KAAK,OAAO,aAAa;CAE3B,qBAA4B,eAAe,KAAK,cAAc,CAAC;CAE/D,qBACE,KAAK,4BAA4B,KAAK,OAAO,KAAK,CAAC;CAErD,qBAA4B,SAC1B,KAAK,cAAc,GAAG,qBAAqB,KAAK;CAKlD,sBAA6B,iBAAyB"}

package/dist/utils/clampNumber.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/clampNumber.ts
+/**
+* Validates `value` against `[min, max]`, returning `defaultValue` (and
+* warning via `diag`) when the value is non-finite or out of range.
+* Returns `defaultValue` silently when `value` is undefined.
+*/
+const clampNumber = ({ diag, value, defaultValue, min, max }) => {
+	if (value === void 0) return defaultValue;
+	if (!Number.isFinite(value)) {
+		diag?.warn(`value is not a finite number; falling back to default (${defaultValue.toString()}).`);
+		return defaultValue;
+	}
+	if (value < min || value > max) {
+		diag?.warn(`value (${value.toString()}) is outside the allowed range [${min.toString()}, ${max.toString()}]; falling back to default (${defaultValue.toString()}).`);
+		return defaultValue;
+	}
+	return value;
+};
+//#endregion
+exports.clampNumber = clampNumber;
+
+//# sourceMappingURL=clampNumber.cjs.map

package/dist/utils/clampNumber.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.cjs","names":[],"sources":["../../src/utils/clampNumber.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n/**\n * Validates `value` against `[min, max]`, returning `defaultValue` (and\n * warning via `diag`) when the value is non-finite or out of range.\n * Returns `defaultValue` silently when `value` is undefined.\n */\nexport const clampNumber = ({\n  diag,\n  value,\n  defaultValue,\n  min,\n  max,\n}: {\n  diag?: DiagLogger;\n  value: number | undefined;\n  defaultValue: number;\n  min: number;\n  max: number;\n}): number => {\n  if (value === undefined) {\n    return defaultValue;\n  }\n  if (!Number.isFinite(value)) {\n    diag?.warn(\n      `value is not a finite number; falling back to default (${defaultValue.toString()}).`,\n    );\n    return defaultValue;\n  }\n  if (value < min || value > max) {\n    diag?.warn(\n      `value (${value.toString()}) is outside the allowed range ` +\n        `[${min.toString()}, ${max.toString()}]; ` +\n        `falling back to default (${defaultValue.toString()}).`,\n    );\n    return defaultValue;\n  }\n  return value;\n};\n"],"mappings":";;;;;;;AAOA,MAAa,eAAe,EAC1B,MACA,OACA,cACA,KACA,UAOY;AACZ,KAAI,UAAU,KAAA,EACZ,QAAO;AAET,KAAI,CAAC,OAAO,SAAS,MAAM,EAAE;AAC3B,QAAM,KACJ,0DAA0D,aAAa,UAAU,CAAC,IACnF;AACD,SAAO;;AAET,KAAI,QAAQ,OAAO,QAAQ,KAAK;AAC9B,QAAM,KACJ,UAAU,MAAM,UAAU,CAAC,kCACrB,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,8BACV,aAAa,UAAU,CAAC,IACvD;AACD,SAAO;;AAET,QAAO"}

package/dist/utils/clampNumber.d.cts

@@ -0,0 +1,24 @@
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/utils/clampNumber.d.ts
+/**
+ * Validates `value` against `[min, max]`, returning `defaultValue` (and
+ * warning via `diag`) when the value is non-finite or out of range.
+ * Returns `defaultValue` silently when `value` is undefined.
+ */
+declare const clampNumber: ({
+  diag,
+  value,
+  defaultValue,
+  min,
+  max
+}: {
+  diag?: DiagLogger;
+  value: number | undefined;
+  defaultValue: number;
+  min: number;
+  max: number;
+}) => number;
+//#endregion
+export { clampNumber };
+//# sourceMappingURL=clampNumber.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.d.cts","names":[],"sources":["../../src/utils/clampNumber.ts"],"mappings":";;;;;AAOA;;;cAAa,WAAA;EAAe,IAAA;EAAA,KAAA;EAAA,YAAA;EAAA,GAAA;EAAA;AAAA;EAO1B,IAAA,GAAO,UAAA;EACP,KAAA;EACA,YAAA;EACA,GAAA;EACA,GAAA;AAAA"}

package/dist/utils/clampNumber.d.ts

@@ -0,0 +1,24 @@
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/utils/clampNumber.d.ts
+/**
+ * Validates `value` against `[min, max]`, returning `defaultValue` (and
+ * warning via `diag`) when the value is non-finite or out of range.
+ * Returns `defaultValue` silently when `value` is undefined.
+ */
+declare const clampNumber: ({
+  diag,
+  value,
+  defaultValue,
+  min,
+  max
+}: {
+  diag?: DiagLogger;
+  value: number | undefined;
+  defaultValue: number;
+  min: number;
+  max: number;
+}) => number;
+//#endregion
+export { clampNumber };
+//# sourceMappingURL=clampNumber.d.ts.map