@safaricom-mxl/web-sdk 0.0.12 → 0.0.13

package/dist/utils/index.d.ts

@@ -1,19 +1,18 @@
 import { bulkAddEventListener } from "./bulkAddEventListener/bulkAddEventListener.js";
 import { bulkRemoveEventListener } from "./bulkRemoveEventListener/bulkRemoveEventListener.js";
 import { createSafeProxy } from "./createSafeProxy/createSafeProxy.js";
-import "./createSafeProxy/index.js";
 import { generateUUID } from "./generateUUID.js";
+import { generateWebVitalID } from "./generateWebVitalID.js";
 import { getIncrementedCount } from "./getIncrementedCount.js";
 import { getVisibilityState } from "./getVisibilityState.js";
 import { GLOBAL_CONFIG } from "./globalConfig.js";
 import { isDeviceIdEnabled } from "./isDeviceIdEnabled.js";
-import { MXLSpanStorage, SpanStorageOptions } from "./MXLSpanStorage/MXLSpanStorage.js";
-import "./MXLSpanStorage/index.js";
+import { MXLSpanStorage } from "./MXLSpanStorage/MXLSpanStorage.js";
 import { NamespacedStorage } from "./NamespacedStorage/NamespacedStorage.js";
 import { nsfConfigValidation } from "./nsfConfigValidation.js";
 import { PerformanceManager } from "./PerformanceManager/types.js";
 import { OTelPerformanceManager } from "./PerformanceManager/OTelPerformanceManager.js";
-import "./PerformanceManager/index.js";
+import { createPerformanceObserver, isEntryTypeSupported } from "./performanceObserver/performanceObserver.js";
 import { throttle } from "./throttle.js";
 import { TimeoutRef } from "./timeout/types.js";
-export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type SpanStorageOptions, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, createSafeProxy, generateUUID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, nsfConfigValidation, throttle };
+export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };

package/dist/utils/index.js

@@ -2,6 +2,7 @@ import { bulkAddEventListener } from "./bulkAddEventListener/bulkAddEventListene
 import { bulkRemoveEventListener } from "./bulkRemoveEventListener/bulkRemoveEventListener.js";
 import { createSafeProxy } from "./createSafeProxy/createSafeProxy.js";
 import { generateUUID } from "./generateUUID.js";
+import { generateWebVitalID } from "./generateWebVitalID.js";
 import { getIncrementedCount } from "./getIncrementedCount.js";
 import { getVisibilityState } from "./getVisibilityState.js";
 import { GLOBAL_CONFIG } from "./globalConfig.js";
@@ -10,6 +11,6 @@ import { MXLSpanStorage } from "./MXLSpanStorage/MXLSpanStorage.js";
 import { NamespacedStorage } from "./NamespacedStorage/NamespacedStorage.js";
 import { nsfConfigValidation } from "./nsfConfigValidation.js";
 import { OTelPerformanceManager } from "./PerformanceManager/OTelPerformanceManager.js";
+import { createPerformanceObserver, isEntryTypeSupported } from "./performanceObserver/performanceObserver.js";
 import { throttle } from "./throttle.js";
-
-export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, bulkAddEventListener, bulkRemoveEventListener, createSafeProxy, generateUUID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, nsfConfigValidation, throttle };
+export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, bulkAddEventListener, bulkRemoveEventListener, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };

package/dist/utils/isDeviceIdEnabled.cjs

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/isDeviceIdEnabled.ts
 const DIGITS = 6;
 /**
@@ -26,8 +25,8 @@ const getNormalizedDeviceId = (deviceId) => {
 	const space = radix ** DIGITS - 1;
 	return parseInt(finalChars, radix) / space * 100;
 };
-
 //#endregion
 exports.getNormalizedDeviceId = getNormalizedDeviceId;
 exports.isDeviceIdEnabled = isDeviceIdEnabled;
+
 //# sourceMappingURL=isDeviceIdEnabled.cjs.map

package/dist/utils/isDeviceIdEnabled.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"isDeviceIdEnabled.cjs","names":[],"sources":["../../src/utils/isDeviceIdEnabled.ts"],"sourcesContent":["const DIGITS = 6;\n\n/**\n * Determines whether a deviceId is enabled for the given pctEnabled. This is achieved\n * by taking a normalized hex value from the last 6 digits of the device ID, and comparing\n * it against the enabled percentage. This ensures that devices are consistently in a given\n * group for beta functionality.\n *\n * This can be used to:\n * - Select sample devices for telemetry collection\n * - Enable/disable features for a percentage of users\n *\n * The normalized device ID has 16^6 possibilities (roughly 1.6m) which should be sufficient\n * granularity for our needs.\n */\nexport const isDeviceIdEnabled = (deviceId: string, pctEnabled?: number) => {\n  if (!pctEnabled || pctEnabled <= 0 || pctEnabled > 100) {\n    return false;\n  }\n\n  const normalizedDeviceId = getNormalizedDeviceId(deviceId);\n\n  return pctEnabled >= normalizedDeviceId;\n};\n\nexport const getNormalizedDeviceId = (deviceId: string): number => {\n  if (deviceId.length < DIGITS) {\n    return 0;\n  }\n\n  const finalChars = deviceId.slice(-DIGITS); // last 6 chars\n  const radix = 16;\n  const space = radix ** DIGITS - 1;\n  const value = parseInt(finalChars, radix);\n\n  return (value / space) * 100;\n};\n"],"mappings":";;;AAAA,MAAM,SAAS;;;;;;;;;;;;;;AAef,MAAa,qBAAqB,UAAkB,eAAwB;AAC1E,KAAI,CAAC,cAAc,cAAc,KAAK,aAAa,IACjD,QAAO;AAKT,QAAO,cAFoB,sBAAsB,SAAS;;AAK5D,MAAa,yBAAyB,aAA6B;AACjE,KAAI,SAAS,SAAS,OACpB,QAAO;CAGT,MAAM,aAAa,SAAS,MAAM,CAAC,OAAO;CAC1C,MAAM,QAAQ;CACd,MAAM,QAAQ,SAAS,SAAS;AAGhC,QAFc,SAAS,YAAY,MAAM,GAEzB,QAAS"}
+{"version":3,"file":"isDeviceIdEnabled.cjs","names":[],"sources":["../../src/utils/isDeviceIdEnabled.ts"],"sourcesContent":["const DIGITS = 6;\n\n/**\n * Determines whether a deviceId is enabled for the given pctEnabled. This is achieved\n * by taking a normalized hex value from the last 6 digits of the device ID, and comparing\n * it against the enabled percentage. This ensures that devices are consistently in a given\n * group for beta functionality.\n *\n * This can be used to:\n * - Select sample devices for telemetry collection\n * - Enable/disable features for a percentage of users\n *\n * The normalized device ID has 16^6 possibilities (roughly 1.6m) which should be sufficient\n * granularity for our needs.\n */\nexport const isDeviceIdEnabled = (deviceId: string, pctEnabled?: number) => {\n  if (!pctEnabled || pctEnabled <= 0 || pctEnabled > 100) {\n    return false;\n  }\n\n  const normalizedDeviceId = getNormalizedDeviceId(deviceId);\n\n  return pctEnabled >= normalizedDeviceId;\n};\n\nexport const getNormalizedDeviceId = (deviceId: string): number => {\n  if (deviceId.length < DIGITS) {\n    return 0;\n  }\n\n  const finalChars = deviceId.slice(-DIGITS); // last 6 chars\n  const radix = 16;\n  const space = radix ** DIGITS - 1;\n  const value = parseInt(finalChars, radix);\n\n  return (value / space) * 100;\n};\n"],"mappings":";;AAAA,MAAM,SAAS;;;;;;;;;;;;;;AAef,MAAa,qBAAqB,UAAkB,eAAwB;AAC1E,KAAI,CAAC,cAAc,cAAc,KAAK,aAAa,IACjD,QAAO;AAKT,QAAO,cAFoB,sBAAsB,SAEV;;AAGzC,MAAa,yBAAyB,aAA6B;AACjE,KAAI,SAAS,SAAS,OACpB,QAAO;CAGT,MAAM,aAAa,SAAS,MAAM,CAAC,OAAO;CAC1C,MAAM,QAAQ;CACd,MAAM,QAAQ,SAAS,SAAS;AAGhC,QAFc,SAAS,YAAY,MAEtB,GAAG,QAAS"}

package/dist/utils/isDeviceIdEnabled.js

@@ -24,7 +24,7 @@ const getNormalizedDeviceId = (deviceId) => {
 	const space = radix ** DIGITS - 1;
 	return parseInt(finalChars, radix) / space * 100;
 };
-
 //#endregion
 export { getNormalizedDeviceId, isDeviceIdEnabled };
+
 //# sourceMappingURL=isDeviceIdEnabled.js.map

package/dist/utils/isDeviceIdEnabled.js.map

@@ -1 +1 @@
-{"version":3,"file":"isDeviceIdEnabled.js","names":[],"sources":["../../src/utils/isDeviceIdEnabled.ts"],"sourcesContent":["const DIGITS = 6;\n\n/**\n * Determines whether a deviceId is enabled for the given pctEnabled. This is achieved\n * by taking a normalized hex value from the last 6 digits of the device ID, and comparing\n * it against the enabled percentage. This ensures that devices are consistently in a given\n * group for beta functionality.\n *\n * This can be used to:\n * - Select sample devices for telemetry collection\n * - Enable/disable features for a percentage of users\n *\n * The normalized device ID has 16^6 possibilities (roughly 1.6m) which should be sufficient\n * granularity for our needs.\n */\nexport const isDeviceIdEnabled = (deviceId: string, pctEnabled?: number) => {\n  if (!pctEnabled || pctEnabled <= 0 || pctEnabled > 100) {\n    return false;\n  }\n\n  const normalizedDeviceId = getNormalizedDeviceId(deviceId);\n\n  return pctEnabled >= normalizedDeviceId;\n};\n\nexport const getNormalizedDeviceId = (deviceId: string): number => {\n  if (deviceId.length < DIGITS) {\n    return 0;\n  }\n\n  const finalChars = deviceId.slice(-DIGITS); // last 6 chars\n  const radix = 16;\n  const space = radix ** DIGITS - 1;\n  const value = parseInt(finalChars, radix);\n\n  return (value / space) * 100;\n};\n"],"mappings":";AAAA,MAAM,SAAS;;;;;;;;;;;;;;AAef,MAAa,qBAAqB,UAAkB,eAAwB;AAC1E,KAAI,CAAC,cAAc,cAAc,KAAK,aAAa,IACjD,QAAO;AAKT,QAAO,cAFoB,sBAAsB,SAAS;;AAK5D,MAAa,yBAAyB,aAA6B;AACjE,KAAI,SAAS,SAAS,OACpB,QAAO;CAGT,MAAM,aAAa,SAAS,MAAM,CAAC,OAAO;CAC1C,MAAM,QAAQ;CACd,MAAM,QAAQ,SAAS,SAAS;AAGhC,QAFc,SAAS,YAAY,MAAM,GAEzB,QAAS"}
+{"version":3,"file":"isDeviceIdEnabled.js","names":[],"sources":["../../src/utils/isDeviceIdEnabled.ts"],"sourcesContent":["const DIGITS = 6;\n\n/**\n * Determines whether a deviceId is enabled for the given pctEnabled. This is achieved\n * by taking a normalized hex value from the last 6 digits of the device ID, and comparing\n * it against the enabled percentage. This ensures that devices are consistently in a given\n * group for beta functionality.\n *\n * This can be used to:\n * - Select sample devices for telemetry collection\n * - Enable/disable features for a percentage of users\n *\n * The normalized device ID has 16^6 possibilities (roughly 1.6m) which should be sufficient\n * granularity for our needs.\n */\nexport const isDeviceIdEnabled = (deviceId: string, pctEnabled?: number) => {\n  if (!pctEnabled || pctEnabled <= 0 || pctEnabled > 100) {\n    return false;\n  }\n\n  const normalizedDeviceId = getNormalizedDeviceId(deviceId);\n\n  return pctEnabled >= normalizedDeviceId;\n};\n\nexport const getNormalizedDeviceId = (deviceId: string): number => {\n  if (deviceId.length < DIGITS) {\n    return 0;\n  }\n\n  const finalChars = deviceId.slice(-DIGITS); // last 6 chars\n  const radix = 16;\n  const space = radix ** DIGITS - 1;\n  const value = parseInt(finalChars, radix);\n\n  return (value / space) * 100;\n};\n"],"mappings":";AAAA,MAAM,SAAS;;;;;;;;;;;;;;AAef,MAAa,qBAAqB,UAAkB,eAAwB;AAC1E,KAAI,CAAC,cAAc,cAAc,KAAK,aAAa,IACjD,QAAO;AAKT,QAAO,cAFoB,sBAAsB,SAEV;;AAGzC,MAAa,yBAAyB,aAA6B;AACjE,KAAI,SAAS,SAAS,OACpB,QAAO;CAGT,MAAM,aAAa,SAAS,MAAM,CAAC,OAAO;CAC1C,MAAM,QAAQ;CACd,MAAM,QAAQ,SAAS,SAAS;AAGhC,QAFc,SAAS,YAAY,MAEtB,GAAG,QAAS"}

package/dist/utils/nsfConfigValidation.cjs

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/nsfConfigValidation.ts
 const nsfConfigValidation = ({ diag, featureManager, registerGlobally, propagator, defaultInstrumentationConfig }) => {
 	if (!featureManager.isNetworkSpanForwardingEnabled()) return false;
@@ -12,7 +11,7 @@ const nsfConfigValidation = ({ diag, featureManager, registerGlobally, propagato
 	});
 	return warnings.length === 0;
 };
-
 //#endregion
 exports.nsfConfigValidation = nsfConfigValidation;
+
 //# sourceMappingURL=nsfConfigValidation.cjs.map

package/dist/utils/nsfConfigValidation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"nsfConfigValidation.cjs","names":[],"sources":["../../src/utils/nsfConfigValidation.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { SDKFeaturesManager } from '../managers/index.ts';\nimport type { SDKInitConfig } from '../sdk/index.ts';\n\ntype ValidateConfigArgs = {\n  featureManager: SDKFeaturesManager;\n  diag: DiagLogger;\n} & Pick<\n  SDKInitConfig,\n  'propagator' | 'registerGlobally' | 'defaultInstrumentationConfig'\n>;\n\nexport const nsfConfigValidation = ({\n  diag,\n  featureManager,\n  registerGlobally,\n  propagator,\n  defaultInstrumentationConfig,\n}: ValidateConfigArgs) => {\n  if (!featureManager.isNetworkSpanForwardingEnabled()) {\n    return false;\n  }\n\n  const warnings = [];\n\n  if (!registerGlobally) {\n    warnings.push(\n      'Network span forwarding cannot be used when `registerGlobally` is set to false. Turning off network span forwarding.',\n    );\n  }\n\n  if (propagator) {\n    warnings.push(\n      'Network span forwarding cannot be used alongside a custom `propagator`. Turning off network span forwarding.',\n    );\n  }\n\n  if (\n    defaultInstrumentationConfig?.omit?.has(\n      '@opentelemetry/instrumentation-xml-http-request',\n    ) &&\n    defaultInstrumentationConfig.omit.has(\n      '@opentelemetry/instrumentation-fetch',\n    )\n  ) {\n    warnings.push(\n      \"Network span forwarding cannot be used when both '@opentelemetry/instrumentation-xml-http-request' and \" +\n        \"'@opentelemetry/instrumentation-fetch' are omitted. Turning off network span forwarding.\",\n    );\n  }\n\n  warnings.forEach((warning) => {\n    diag.warn(warning);\n  });\n\n  return warnings.length === 0;\n};\n"],"mappings":";;;AAYA,MAAa,uBAAuB,EAClC,MACA,gBACA,kBACA,YACA,mCACwB;AACxB,KAAI,CAAC,eAAe,gCAAgC,CAClD,QAAO;CAGT,MAAM,WAAW,EAAE;AAEnB,KAAI,CAAC,iBACH,UAAS,KACP,uHACD;AAGH,KAAI,WACF,UAAS,KACP,+GACD;AAGH,KACE,8BAA8B,MAAM,IAClC,kDACD,IACD,6BAA6B,KAAK,IAChC,uCACD,CAED,UAAS,KACP,kMAED;AAGH,UAAS,SAAS,YAAY;AAC5B,OAAK,KAAK,QAAQ;GAClB;AAEF,QAAO,SAAS,WAAW"}
+{"version":3,"file":"nsfConfigValidation.cjs","names":[],"sources":["../../src/utils/nsfConfigValidation.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\nimport type { SDKFeaturesManager } from '../managers/index.ts';\nimport type { SDKInitConfig } from '../sdk/index.ts';\n\ntype ValidateConfigArgs = {\n  featureManager: SDKFeaturesManager;\n  diag: DiagLogger;\n} & Pick<\n  SDKInitConfig,\n  'propagator' | 'registerGlobally' | 'defaultInstrumentationConfig'\n>;\n\nexport const nsfConfigValidation = ({\n  diag,\n  featureManager,\n  registerGlobally,\n  propagator,\n  defaultInstrumentationConfig,\n}: ValidateConfigArgs) => {\n  if (!featureManager.isNetworkSpanForwardingEnabled()) {\n    return false;\n  }\n\n  const warnings = [];\n\n  if (!registerGlobally) {\n    warnings.push(\n      'Network span forwarding cannot be used when `registerGlobally` is set to false. Turning off network span forwarding.',\n    );\n  }\n\n  if (propagator) {\n    warnings.push(\n      'Network span forwarding cannot be used alongside a custom `propagator`. Turning off network span forwarding.',\n    );\n  }\n\n  if (\n    defaultInstrumentationConfig?.omit?.has(\n      '@opentelemetry/instrumentation-xml-http-request',\n    ) &&\n    defaultInstrumentationConfig.omit.has(\n      '@opentelemetry/instrumentation-fetch',\n    )\n  ) {\n    warnings.push(\n      \"Network span forwarding cannot be used when both '@opentelemetry/instrumentation-xml-http-request' and \" +\n        \"'@opentelemetry/instrumentation-fetch' are omitted. Turning off network span forwarding.\",\n    );\n  }\n\n  warnings.forEach((warning) => {\n    diag.warn(warning);\n  });\n\n  return warnings.length === 0;\n};\n"],"mappings":";;AAYA,MAAa,uBAAuB,EAClC,MACA,gBACA,kBACA,YACA,mCACwB;AACxB,KAAI,CAAC,eAAe,gCAAgC,CAClD,QAAO;CAGT,MAAM,WAAW,EAAE;AAEnB,KAAI,CAAC,iBACH,UAAS,KACP,uHACD;AAGH,KAAI,WACF,UAAS,KACP,+GACD;AAGH,KACE,8BAA8B,MAAM,IAClC,kDACD,IACD,6BAA6B,KAAK,IAChC,uCACD,CAED,UAAS,KACP,kMAED;AAGH,UAAS,SAAS,YAAY;AAC5B,OAAK,KAAK,QAAQ;GAClB;AAEF,QAAO,SAAS,WAAW"}

package/dist/utils/nsfConfigValidation.d.ts

@@ -1,7 +1,5 @@
 import { SDKInitConfig } from "../sdk/types.js";
-import "../sdk/index.js";
 import { SDKFeaturesManager } from "../managers/MXLSDKFeaturesManager/types.js";
-import "../managers/index.js";
 import { DiagLogger } from "@opentelemetry/api";
 
 //#region src/utils/nsfConfigValidation.d.ts

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

@@ -1 +1 @@
-{"version":3,"file":"nsfConfigValidation.d.ts","names":[],"sources":["../../src/utils/nsfConfigValidation.ts"],"mappings":";;;;;;;KAIK,kBAAA;EACH,cAAA,EAAgB,kBAAA;EAChB,IAAA,EAAM,UAAA;AAAA,IACJ,IAAA,CACF,aAAA;AAAA,cAIW,mBAAA;EAAuB,IAAA;EAAA,cAAA;EAAA,gBAAA;EAAA,UAAA;EAAA;AAAA,GAMjC,kBAAA"}
+{"version":3,"file":"nsfConfigValidation.d.ts","names":[],"sources":["../../src/utils/nsfConfigValidation.ts"],"mappings":";;;;;KAIK,kBAAA;EACH,cAAA,EAAgB,kBAAA;EAChB,IAAA,EAAM,UAAA;AAAA,IACJ,IAAA,CACF,aAAA;AAAA,cAIW,mBAAA;EAAuB,IAAA;EAAA,cAAA;EAAA,gBAAA;EAAA,UAAA;EAAA;AAAA,GAMjC,kBAAA"}

package/dist/utils/nsfConfigValidation.js

@@ -10,7 +10,7 @@ const nsfConfigValidation = ({ diag, featureManager, registerGlobally, propagato
 	});
 	return warnings.length === 0;
 };
-
 //#endregion
 export { nsfConfigValidation };
+
 //# sourceMappingURL=nsfConfigValidation.js.map

package/dist/utils/performanceObserver/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_performanceObserver_performanceObserver = require("./performanceObserver.cjs");
+exports.createPerformanceObserver = require_utils_performanceObserver_performanceObserver.createPerformanceObserver;
+exports.isEntryTypeSupported = require_utils_performanceObserver_performanceObserver.isEntryTypeSupported;

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

@@ -0,0 +1,2 @@
+import { createPerformanceObserver, isEntryTypeSupported } from "./performanceObserver.cjs";
+export { createPerformanceObserver, isEntryTypeSupported };

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

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

package/dist/utils/performanceObserver/index.js

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

package/dist/utils/performanceObserver/performanceObserver.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/utils/performanceObserver/performanceObserver.ts
+function isEntryTypeSupported(type) {
+	return typeof PerformanceObserver !== "undefined" && (PerformanceObserver.supportedEntryTypes?.includes(type) ?? false);
+}
+/**
+* Creates a PerformanceObserver for the specified entry type if supported, and starts observing.
+* Returns the observer instance, or null if the entry type is not supported or if an error occurs.
+*
+* Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught
+* and logged via `diag` (if provided) so that one bad entry does not block the rest.
+*
+* Note: The observer is created with the "buffered" option set to true, so it will receive entries
+* that were recorded before the observer was created.
+* buffered: true is not supported when observing multiple entry types, so if you need to observe
+* multiple types, you should create separate observers for each type with buffered: true.
+* See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes
+*/
+function createPerformanceObserver(type, processEntry, options) {
+	const { diag, ...observeOptions } = options ?? {};
+	if (!isEntryTypeSupported(type)) {
+		diag?.debug(`${type} not supported, skipping observer`);
+		return null;
+	}
+	try {
+		const observer = new PerformanceObserver((list) => {
+			for (const entry of list.getEntries()) try {
+				processEntry(entry);
+			} catch (e) {
+				diag?.error(`error processing ${type} entry`, e);
+			}
+		});
+		observer.observe({
+			type,
+			buffered: true,
+			...observeOptions
+		});
+		return observer;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+exports.createPerformanceObserver = createPerformanceObserver;
+exports.isEntryTypeSupported = isEntryTypeSupported;
+
+//# sourceMappingURL=performanceObserver.cjs.map

package/dist/utils/performanceObserver/performanceObserver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceObserver.cjs","names":[],"sources":["../../../src/utils/performanceObserver/performanceObserver.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\nexport function isEntryTypeSupported(type: string): boolean {\n  return (\n    typeof PerformanceObserver !== 'undefined' &&\n    (PerformanceObserver.supportedEntryTypes?.includes(type) ?? false)\n  );\n}\n\n/**\n * Creates a PerformanceObserver for the specified entry type if supported, and starts observing.\n * Returns the observer instance, or null if the entry type is not supported or if an error occurs.\n *\n * Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught\n * and logged via `diag` (if provided) so that one bad entry does not block the rest.\n *\n * Note: The observer is created with the \"buffered\" option set to true, so it will receive entries\n * that were recorded before the observer was created.\n * buffered: true is not supported when observing multiple entry types, so if you need to observe\n * multiple types, you should create separate observers for each type with buffered: true.\n * See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes\n */\nexport function createPerformanceObserver<T extends PerformanceEntry>(\n  type: string,\n  processEntry: (entry: T) => void,\n  options?: PerformanceObserverInit & { diag?: DiagLogger },\n): PerformanceObserver | null {\n  const { diag, ...observeOptions } = options ?? {};\n\n  if (!isEntryTypeSupported(type)) {\n    diag?.debug(`${type} not supported, skipping observer`);\n    return null;\n  }\n\n  try {\n    const observer = new PerformanceObserver((list) => {\n      for (const entry of list.getEntries() as T[]) {\n        try {\n          processEntry(entry);\n        } catch (e) {\n          diag?.error(`error processing ${type} entry`, e);\n        }\n      }\n    });\n    observer.observe({ type, buffered: true, ...observeOptions });\n    return observer;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";;AAEA,SAAgB,qBAAqB,MAAuB;AAC1D,QACE,OAAO,wBAAwB,gBAC9B,oBAAoB,qBAAqB,SAAS,KAAK,IAAI;;;;;;;;;;;;;;;AAiBhE,SAAgB,0BACd,MACA,cACA,SAC4B;CAC5B,MAAM,EAAE,MAAM,GAAG,mBAAmB,WAAW,EAAE;AAEjD,KAAI,CAAC,qBAAqB,KAAK,EAAE;AAC/B,QAAM,MAAM,GAAG,KAAK,mCAAmC;AACvD,SAAO;;AAGT,KAAI;EACF,MAAM,WAAW,IAAI,qBAAqB,SAAS;AACjD,QAAK,MAAM,SAAS,KAAK,YAAY,CACnC,KAAI;AACF,iBAAa,MAAM;YACZ,GAAG;AACV,UAAM,MAAM,oBAAoB,KAAK,SAAS,EAAE;;IAGpD;AACF,WAAS,QAAQ;GAAE;GAAM,UAAU;GAAM,GAAG;GAAgB,CAAC;AAC7D,SAAO;SACD;AACN,SAAO"}

package/dist/utils/performanceObserver/performanceObserver.d.cts

@@ -0,0 +1,23 @@
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/utils/performanceObserver/performanceObserver.d.ts
+declare function isEntryTypeSupported(type: string): boolean;
+/**
+ * Creates a PerformanceObserver for the specified entry type if supported, and starts observing.
+ * Returns the observer instance, or null if the entry type is not supported or if an error occurs.
+ *
+ * Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught
+ * and logged via `diag` (if provided) so that one bad entry does not block the rest.
+ *
+ * Note: The observer is created with the "buffered" option set to true, so it will receive entries
+ * that were recorded before the observer was created.
+ * buffered: true is not supported when observing multiple entry types, so if you need to observe
+ * multiple types, you should create separate observers for each type with buffered: true.
+ * See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes
+ */
+declare function createPerformanceObserver<T extends PerformanceEntry>(type: string, processEntry: (entry: T) => void, options?: PerformanceObserverInit & {
+  diag?: DiagLogger;
+}): PerformanceObserver | null;
+//#endregion
+export { createPerformanceObserver, isEntryTypeSupported };
+//# sourceMappingURL=performanceObserver.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performanceObserver.d.cts","names":[],"sources":["../../../src/utils/performanceObserver/performanceObserver.ts"],"mappings":";;;iBAEgB,oBAAA,CAAqB,IAAA;;AAArC;;;;;AAoBA;;;;;;;iBAAgB,yBAAA,WAAoC,gBAAA,CAAA,CAClD,IAAA,UACA,YAAA,GAAe,KAAA,EAAO,CAAA,WACtB,OAAA,GAAU,uBAAA;EAA4B,IAAA,GAAO,UAAA;AAAA,IAC5C,mBAAA"}

package/dist/utils/performanceObserver/performanceObserver.d.ts

@@ -0,0 +1,23 @@
+import { DiagLogger } from "@opentelemetry/api";
+
+//#region src/utils/performanceObserver/performanceObserver.d.ts
+declare function isEntryTypeSupported(type: string): boolean;
+/**
+ * Creates a PerformanceObserver for the specified entry type if supported, and starts observing.
+ * Returns the observer instance, or null if the entry type is not supported or if an error occurs.
+ *
+ * Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught
+ * and logged via `diag` (if provided) so that one bad entry does not block the rest.
+ *
+ * Note: The observer is created with the "buffered" option set to true, so it will receive entries
+ * that were recorded before the observer was created.
+ * buffered: true is not supported when observing multiple entry types, so if you need to observe
+ * multiple types, you should create separate observers for each type with buffered: true.
+ * See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes
+ */
+declare function createPerformanceObserver<T extends PerformanceEntry>(type: string, processEntry: (entry: T) => void, options?: PerformanceObserverInit & {
+  diag?: DiagLogger;
+}): PerformanceObserver | null;
+//#endregion
+export { createPerformanceObserver, isEntryTypeSupported };
+//# sourceMappingURL=performanceObserver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performanceObserver.d.ts","names":[],"sources":["../../../src/utils/performanceObserver/performanceObserver.ts"],"mappings":";;;iBAEgB,oBAAA,CAAqB,IAAA;;AAArC;;;;;AAoBA;;;;;;;iBAAgB,yBAAA,WAAoC,gBAAA,CAAA,CAClD,IAAA,UACA,YAAA,GAAe,KAAA,EAAO,CAAA,WACtB,OAAA,GAAU,uBAAA;EAA4B,IAAA,GAAO,UAAA;AAAA,IAC5C,mBAAA"}

package/dist/utils/performanceObserver/performanceObserver.js

@@ -0,0 +1,45 @@
+//#region src/utils/performanceObserver/performanceObserver.ts
+function isEntryTypeSupported(type) {
+	return typeof PerformanceObserver !== "undefined" && (PerformanceObserver.supportedEntryTypes?.includes(type) ?? false);
+}
+/**
+* Creates a PerformanceObserver for the specified entry type if supported, and starts observing.
+* Returns the observer instance, or null if the entry type is not supported or if an error occurs.
+*
+* Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught
+* and logged via `diag` (if provided) so that one bad entry does not block the rest.
+*
+* Note: The observer is created with the "buffered" option set to true, so it will receive entries
+* that were recorded before the observer was created.
+* buffered: true is not supported when observing multiple entry types, so if you need to observe
+* multiple types, you should create separate observers for each type with buffered: true.
+* See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes
+*/
+function createPerformanceObserver(type, processEntry, options) {
+	const { diag, ...observeOptions } = options ?? {};
+	if (!isEntryTypeSupported(type)) {
+		diag?.debug(`${type} not supported, skipping observer`);
+		return null;
+	}
+	try {
+		const observer = new PerformanceObserver((list) => {
+			for (const entry of list.getEntries()) try {
+				processEntry(entry);
+			} catch (e) {
+				diag?.error(`error processing ${type} entry`, e);
+			}
+		});
+		observer.observe({
+			type,
+			buffered: true,
+			...observeOptions
+		});
+		return observer;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { createPerformanceObserver, isEntryTypeSupported };
+
+//# sourceMappingURL=performanceObserver.js.map

package/dist/utils/performanceObserver/performanceObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceObserver.js","names":[],"sources":["../../../src/utils/performanceObserver/performanceObserver.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\nexport function isEntryTypeSupported(type: string): boolean {\n  return (\n    typeof PerformanceObserver !== 'undefined' &&\n    (PerformanceObserver.supportedEntryTypes?.includes(type) ?? false)\n  );\n}\n\n/**\n * Creates a PerformanceObserver for the specified entry type if supported, and starts observing.\n * Returns the observer instance, or null if the entry type is not supported or if an error occurs.\n *\n * Each entry is passed individually to `processEntry`. Errors thrown by `processEntry` are caught\n * and logged via `diag` (if provided) so that one bad entry does not block the rest.\n *\n * Note: The observer is created with the \"buffered\" option set to true, so it will receive entries\n * that were recorded before the observer was created.\n * buffered: true is not supported when observing multiple entry types, so if you need to observe\n * multiple types, you should create separate observers for each type with buffered: true.\n * See https://developer.mozilla.org/en-US/docs/Web/API/PerformanceObserver/observe#entrytypes\n */\nexport function createPerformanceObserver<T extends PerformanceEntry>(\n  type: string,\n  processEntry: (entry: T) => void,\n  options?: PerformanceObserverInit & { diag?: DiagLogger },\n): PerformanceObserver | null {\n  const { diag, ...observeOptions } = options ?? {};\n\n  if (!isEntryTypeSupported(type)) {\n    diag?.debug(`${type} not supported, skipping observer`);\n    return null;\n  }\n\n  try {\n    const observer = new PerformanceObserver((list) => {\n      for (const entry of list.getEntries() as T[]) {\n        try {\n          processEntry(entry);\n        } catch (e) {\n          diag?.error(`error processing ${type} entry`, e);\n        }\n      }\n    });\n    observer.observe({ type, buffered: true, ...observeOptions });\n    return observer;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AAEA,SAAgB,qBAAqB,MAAuB;AAC1D,QACE,OAAO,wBAAwB,gBAC9B,oBAAoB,qBAAqB,SAAS,KAAK,IAAI;;;;;;;;;;;;;;;AAiBhE,SAAgB,0BACd,MACA,cACA,SAC4B;CAC5B,MAAM,EAAE,MAAM,GAAG,mBAAmB,WAAW,EAAE;AAEjD,KAAI,CAAC,qBAAqB,KAAK,EAAE;AAC/B,QAAM,MAAM,GAAG,KAAK,mCAAmC;AACvD,SAAO;;AAGT,KAAI;EACF,MAAM,WAAW,IAAI,qBAAqB,SAAS;AACjD,QAAK,MAAM,SAAS,KAAK,YAAY,CACnC,KAAI;AACF,iBAAa,MAAM;YACZ,GAAG;AACV,UAAM,MAAM,oBAAoB,KAAK,SAAS,EAAE;;IAGpD;AACF,WAAS,QAAQ;GAAE;GAAM,UAAU;GAAM,GAAG;GAAgB,CAAC;AAC7D,SAAO;SACD;AACN,SAAO"}

package/dist/utils/throttle.cjs

@@ -1,5 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/throttle.ts
 /** throttle wraps a function so it can only be called once, and then a time window must pass before it can be called again
 * any subsequent calls before the time window has passed will be ignored.
@@ -18,7 +17,7 @@ const throttle = (func, timeout = 1e3) => {
 		isWaiting = true;
 	};
 };
-
 //#endregion
 exports.throttle = throttle;
+
 //# sourceMappingURL=throttle.cjs.map

package/dist/utils/throttle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.cjs","names":[],"sources":["../../src/utils/throttle.ts"],"sourcesContent":["/** throttle wraps a function so it can only be called once, and then a time window must pass before it can be called again\n * any subsequent calls before the time window has passed will be ignored.\n *\n * NOTE: if the wrapped function makes use of \"this\", it must be properly bind from the caller, as this wrapper will not bind it.\n * For this, we suggest you always pass functions declared as fat arrow functions, as they have their \"this\" lexically defined.\n * */\nexport const throttle = <F extends (...args: Parameters<F>) => ReturnType<F>>(\n  func: F,\n  timeout = 1000,\n) => {\n  let isWaiting = false;\n  return (...args: Parameters<F>) => {\n    if (isWaiting) {\n      return;\n    }\n    func(...args);\n    setTimeout(() => {\n      isWaiting = false;\n    }, timeout);\n    isWaiting = true;\n  };\n};\n"],"mappings":";;;;;;;;;AAMA,MAAa,YACX,MACA,UAAU,QACP;CACH,IAAI,YAAY;AAChB,SAAQ,GAAG,SAAwB;AACjC,MAAI,UACF;AAEF,OAAK,GAAG,KAAK;AACb,mBAAiB;AACf,eAAY;KACX,QAAQ;AACX,cAAY"}
+{"version":3,"file":"throttle.cjs","names":[],"sources":["../../src/utils/throttle.ts"],"sourcesContent":["/** throttle wraps a function so it can only be called once, and then a time window must pass before it can be called again\n * any subsequent calls before the time window has passed will be ignored.\n *\n * NOTE: if the wrapped function makes use of \"this\", it must be properly bind from the caller, as this wrapper will not bind it.\n * For this, we suggest you always pass functions declared as fat arrow functions, as they have their \"this\" lexically defined.\n * */\nexport const throttle = <F extends (...args: Parameters<F>) => ReturnType<F>>(\n  func: F,\n  timeout = 1000,\n) => {\n  let isWaiting = false;\n  return (...args: Parameters<F>) => {\n    if (isWaiting) {\n      return;\n    }\n    func(...args);\n    setTimeout(() => {\n      isWaiting = false;\n    }, timeout);\n    isWaiting = true;\n  };\n};\n"],"mappings":";;;;;;;;AAMA,MAAa,YACX,MACA,UAAU,QACP;CACH,IAAI,YAAY;AAChB,SAAQ,GAAG,SAAwB;AACjC,MAAI,UACF;AAEF,OAAK,GAAG,KAAK;AACb,mBAAiB;AACf,eAAY;KACX,QAAQ;AACX,cAAY"}

package/dist/utils/throttle.js

@@ -16,7 +16,7 @@ const throttle = (func, timeout = 1e3) => {
 		isWaiting = true;
 	};
 };
-
 //#endregion
 export { throttle };
+
 //# sourceMappingURL=throttle.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@safaricom-mxl/web-sdk",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "MXL Web SDK",
   "type": "module",
   "imports": {
@@ -25,8 +25,8 @@
     "test:manual": "npm run test -- --manual",
     "test:coverage": "npm run test -- --config=web-test-runner.coverage.config.js",
     "test:multiBrowsers": "npm run test -- --config=web-test-runner.multi-browser.config.js",
-    "check": "tsc",
-    "check:dist": "eslint --max-warnings 0 --config eslint.dist.config.ts dist/",
+    "check": "tsc && eslint --max-warnings 0",
+    "check:dist": "eslint --max-warnings 0 --config eslint.dist.config.ts",
     "validate": "tsx scripts/validate.ts",
     "docs": "npx typedoc --readme none && touch docs/.nojekyll"
   },
@@ -79,17 +79,18 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/api-logs": "^0.215.0",
-    "@opentelemetry/core": "^2.7.0",
-    "@opentelemetry/instrumentation": "^0.215.0",
-    "@opentelemetry/instrumentation-fetch": "^0.215.0",
-    "@opentelemetry/instrumentation-xml-http-request": "^0.215.0",
-    "@opentelemetry/otlp-exporter-base": "^0.215.0",
-    "@opentelemetry/resources": "^2.7.0",
-    "@opentelemetry/sdk-logs": "^0.215.0",
-    "@opentelemetry/sdk-trace-web": "^2.7.0",
+    "@opentelemetry/api-logs": "^0.217.0",
+    "@opentelemetry/core": "^2.7.1",
+    "@opentelemetry/instrumentation": "^0.217.0",
+    "@opentelemetry/instrumentation-fetch": "^0.217.0",
+    "@opentelemetry/instrumentation-xml-http-request": "^0.217.0",
+    "@opentelemetry/otlp-exporter-base": "^0.217.0",
+    "@opentelemetry/otlp-transformer": "^0.217.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-logs": "^0.217.0",
+    "@opentelemetry/sdk-trace-web": "^2.7.1",
     "@opentelemetry/semantic-conventions": "^1.40.0",
-    "@opentelemetry/web-common": "^0.215.0",
+    "@opentelemetry/web-common": "^0.217.0",
     "@safaricom-mxl/session-recorder": "0.0.12",
     "hoist-non-react-statics": "^3.3.2",
     "web-vitals": "^5.2.0"