@safaricom-mxl/web-sdk 0.0.15 → 0.0.17

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

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.d.ts","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.js

@@ -0,0 +1,22 @@
+//#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
+export { clampNumber };
+
+//# sourceMappingURL=clampNumber.js.map

package/dist/utils/clampNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clampNumber.js","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/createSafeProxy/createSafeProxy.cjs

@@ -17,8 +17,8 @@ function createSafeProxy(target, noOpFallback, diag, excludeMethods = /* @__PURE
 		return (...args) => {
 			try {
 				return value.apply(obj, args);
-			} catch (e) {
-				const message = e instanceof Error ? e.message : "Unknown error";
+			} catch (error) {
+				const message = error instanceof Error ? error.message : "Unknown error";
 				diag.error(`${String(prop)}: ${message}`);
 				const fallbackMethod = noOpFallback[prop];
 				if (typeof fallbackMethod === "function") return fallbackMethod.apply(noOpFallback, args);

package/dist/utils/createSafeProxy/createSafeProxy.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createSafeProxy.cjs","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n/**\n * Creates a proxy that wraps all method calls in try-catch.\n * On error, logs via diag and returns the NoOp manager's value.\n *\n * @param target - The object to wrap (typically a ProxyManager)\n * @param noOpFallback - A NoOp implementation to get fallback return values\n * @param diag - Logger for error reporting\n * @param excludeMethods - Methods to exclude from wrapping (e.g., internal methods)\n */\nexport function createSafeProxy<T extends object, F extends object>(\n  target: T,\n  noOpFallback: F,\n  diag: DiagLogger,\n  excludeMethods: Set<string> = new Set(),\n): T {\n  return new Proxy(target, {\n    get(obj, prop, receiver) {\n      const value = Reflect.get(obj, prop, receiver);\n\n      if (typeof value !== 'function') {\n        return value;\n      }\n\n      if (excludeMethods.has(prop as string)) {\n        return value;\n      }\n\n      return (...args: unknown[]) => {\n        try {\n          return (value as (...args: unknown[]) => unknown).apply(obj, args);\n        } catch (e) {\n          const message = e instanceof Error ? e.message : 'Unknown error';\n          diag.error(`${String(prop)}: ${message}`);\n\n          // Get fallback from NoOp manager\n          const fallbackMethod = (noOpFallback as Record<string, unknown>)[\n            prop as string\n          ];\n          if (typeof fallbackMethod === 'function') {\n            return (fallbackMethod as (...args: unknown[]) => unknown).apply(\n              noOpFallback,\n              args,\n            );\n          }\n          return undefined;\n        }\n      };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,gBACd,QACA,cACA,MACA,iCAA8B,IAAI,KAAK,EACpC;AACH,QAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,KAAK,MAAM,UAAU;EACvB,MAAM,QAAQ,QAAQ,IAAI,KAAK,MAAM,SAAS;AAE9C,MAAI,OAAO,UAAU,WACnB,QAAO;AAGT,MAAI,eAAe,IAAI,KAAe,CACpC,QAAO;AAGT,UAAQ,GAAG,SAAoB;AAC7B,OAAI;AACF,WAAQ,MAA0C,MAAM,KAAK,KAAK;YAC3D,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU;AACjD,SAAK,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,UAAU;IAGzC,MAAM,iBAAkB,aACtB;AAEF,QAAI,OAAO,mBAAmB,WAC5B,QAAQ,eAAmD,MACzD,cACA,KACD;AAEH;;;IAIP,CAAC"}
+{"version":3,"file":"createSafeProxy.cjs","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n/**\n * Creates a proxy that wraps all method calls in try-catch.\n * On error, logs via diag and returns the NoOp manager's value.\n *\n * @param target - The object to wrap (typically a ProxyManager)\n * @param noOpFallback - A NoOp implementation to get fallback return values\n * @param diag - Logger for error reporting\n * @param excludeMethods - Methods to exclude from wrapping (e.g., internal methods)\n */\nexport function createSafeProxy<T extends object, F extends object>(\n  target: T,\n  noOpFallback: F,\n  diag: DiagLogger,\n  excludeMethods = new Set<string>(),\n): T {\n  return new Proxy(target, {\n    get(obj, prop, receiver) {\n      const value = Reflect.get(obj, prop, receiver);\n\n      if (typeof value !== 'function') {\n        return value;\n      }\n\n      if (excludeMethods.has(prop as string)) {\n        return value;\n      }\n\n      return (...args: unknown[]) => {\n        try {\n          return (value as (...args: unknown[]) => unknown).apply(obj, args);\n        } catch (error) {\n          const message =\n            error instanceof Error ? error.message : 'Unknown error';\n          diag.error(`${String(prop)}: ${message}`);\n\n          // Get fallback from NoOp manager\n          const fallbackMethod = (noOpFallback as Record<string, unknown>)[\n            prop as string\n          ];\n          if (typeof fallbackMethod === 'function') {\n            return (fallbackMethod as (...args: unknown[]) => unknown).apply(\n              noOpFallback,\n              args,\n            );\n          }\n          return undefined;\n        }\n      };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,gBACd,QACA,cACA,MACA,iCAAiB,IAAI,KAAa,EAC/B;AACH,QAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,KAAK,MAAM,UAAU;EACvB,MAAM,QAAQ,QAAQ,IAAI,KAAK,MAAM,SAAS;AAE9C,MAAI,OAAO,UAAU,WACnB,QAAO;AAGT,MAAI,eAAe,IAAI,KAAe,CACpC,QAAO;AAGT,UAAQ,GAAG,SAAoB;AAC7B,OAAI;AACF,WAAQ,MAA0C,MAAM,KAAK,KAAK;YAC3D,OAAO;IACd,MAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,SAAK,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,UAAU;IAGzC,MAAM,iBAAkB,aACtB;AAEF,QAAI,OAAO,mBAAmB,WAC5B,QAAQ,eAAmD,MACzD,cACA,KACD;AAEH;;;IAIP,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"createSafeProxy.d.cts","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"mappings":";;;;;AAWA;;;;;;;iBAAgB,eAAA,oCAAA,CACd,MAAA,EAAQ,CAAA,EACR,YAAA,EAAc,CAAA,EACd,IAAA,EAAM,UAAA,EACN,cAAA,GAAgB,GAAA,WACf,CAAA"}
+{"version":3,"file":"createSafeProxy.d.cts","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"mappings":";;;;;AAWA;;;;;;;iBAAgB,eAAA,oCAAA,CACd,MAAA,EAAQ,CAAA,EACR,YAAA,EAAc,CAAA,EACd,IAAA,EAAM,UAAA,EACN,cAAA,GAAc,GAAA,WACb,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"createSafeProxy.d.ts","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"mappings":";;;;;AAWA;;;;;;;iBAAgB,eAAA,oCAAA,CACd,MAAA,EAAQ,CAAA,EACR,YAAA,EAAc,CAAA,EACd,IAAA,EAAM,UAAA,EACN,cAAA,GAAgB,GAAA,WACf,CAAA"}
+{"version":3,"file":"createSafeProxy.d.ts","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"mappings":";;;;;AAWA;;;;;;;iBAAgB,eAAA,oCAAA,CACd,MAAA,EAAQ,CAAA,EACR,YAAA,EAAc,CAAA,EACd,IAAA,EAAM,UAAA,EACN,cAAA,GAAc,GAAA,WACb,CAAA"}

package/dist/utils/createSafeProxy/createSafeProxy.js

@@ -16,8 +16,8 @@ function createSafeProxy(target, noOpFallback, diag, excludeMethods = /* @__PURE
 		return (...args) => {
 			try {
 				return value.apply(obj, args);
-			} catch (e) {
-				const message = e instanceof Error ? e.message : "Unknown error";
+			} catch (error) {
+				const message = error instanceof Error ? error.message : "Unknown error";
 				diag.error(`${String(prop)}: ${message}`);
 				const fallbackMethod = noOpFallback[prop];
 				if (typeof fallbackMethod === "function") return fallbackMethod.apply(noOpFallback, args);

package/dist/utils/createSafeProxy/createSafeProxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSafeProxy.js","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n/**\n * Creates a proxy that wraps all method calls in try-catch.\n * On error, logs via diag and returns the NoOp manager's value.\n *\n * @param target - The object to wrap (typically a ProxyManager)\n * @param noOpFallback - A NoOp implementation to get fallback return values\n * @param diag - Logger for error reporting\n * @param excludeMethods - Methods to exclude from wrapping (e.g., internal methods)\n */\nexport function createSafeProxy<T extends object, F extends object>(\n  target: T,\n  noOpFallback: F,\n  diag: DiagLogger,\n  excludeMethods: Set<string> = new Set(),\n): T {\n  return new Proxy(target, {\n    get(obj, prop, receiver) {\n      const value = Reflect.get(obj, prop, receiver);\n\n      if (typeof value !== 'function') {\n        return value;\n      }\n\n      if (excludeMethods.has(prop as string)) {\n        return value;\n      }\n\n      return (...args: unknown[]) => {\n        try {\n          return (value as (...args: unknown[]) => unknown).apply(obj, args);\n        } catch (e) {\n          const message = e instanceof Error ? e.message : 'Unknown error';\n          diag.error(`${String(prop)}: ${message}`);\n\n          // Get fallback from NoOp manager\n          const fallbackMethod = (noOpFallback as Record<string, unknown>)[\n            prop as string\n          ];\n          if (typeof fallbackMethod === 'function') {\n            return (fallbackMethod as (...args: unknown[]) => unknown).apply(\n              noOpFallback,\n              args,\n            );\n          }\n          return undefined;\n        }\n      };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,gBACd,QACA,cACA,MACA,iCAA8B,IAAI,KAAK,EACpC;AACH,QAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,KAAK,MAAM,UAAU;EACvB,MAAM,QAAQ,QAAQ,IAAI,KAAK,MAAM,SAAS;AAE9C,MAAI,OAAO,UAAU,WACnB,QAAO;AAGT,MAAI,eAAe,IAAI,KAAe,CACpC,QAAO;AAGT,UAAQ,GAAG,SAAoB;AAC7B,OAAI;AACF,WAAQ,MAA0C,MAAM,KAAK,KAAK;YAC3D,GAAG;IACV,MAAM,UAAU,aAAa,QAAQ,EAAE,UAAU;AACjD,SAAK,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,UAAU;IAGzC,MAAM,iBAAkB,aACtB;AAEF,QAAI,OAAO,mBAAmB,WAC5B,QAAQ,eAAmD,MACzD,cACA,KACD;AAEH;;;IAIP,CAAC"}
+{"version":3,"file":"createSafeProxy.js","names":[],"sources":["../../../src/utils/createSafeProxy/createSafeProxy.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n/**\n * Creates a proxy that wraps all method calls in try-catch.\n * On error, logs via diag and returns the NoOp manager's value.\n *\n * @param target - The object to wrap (typically a ProxyManager)\n * @param noOpFallback - A NoOp implementation to get fallback return values\n * @param diag - Logger for error reporting\n * @param excludeMethods - Methods to exclude from wrapping (e.g., internal methods)\n */\nexport function createSafeProxy<T extends object, F extends object>(\n  target: T,\n  noOpFallback: F,\n  diag: DiagLogger,\n  excludeMethods = new Set<string>(),\n): T {\n  return new Proxy(target, {\n    get(obj, prop, receiver) {\n      const value = Reflect.get(obj, prop, receiver);\n\n      if (typeof value !== 'function') {\n        return value;\n      }\n\n      if (excludeMethods.has(prop as string)) {\n        return value;\n      }\n\n      return (...args: unknown[]) => {\n        try {\n          return (value as (...args: unknown[]) => unknown).apply(obj, args);\n        } catch (error) {\n          const message =\n            error instanceof Error ? error.message : 'Unknown error';\n          diag.error(`${String(prop)}: ${message}`);\n\n          // Get fallback from NoOp manager\n          const fallbackMethod = (noOpFallback as Record<string, unknown>)[\n            prop as string\n          ];\n          if (typeof fallbackMethod === 'function') {\n            return (fallbackMethod as (...args: unknown[]) => unknown).apply(\n              noOpFallback,\n              args,\n            );\n          }\n          return undefined;\n        }\n      };\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,gBACd,QACA,cACA,MACA,iCAAiB,IAAI,KAAa,EAC/B;AACH,QAAO,IAAI,MAAM,QAAQ,EACvB,IAAI,KAAK,MAAM,UAAU;EACvB,MAAM,QAAQ,QAAQ,IAAI,KAAK,MAAM,SAAS;AAE9C,MAAI,OAAO,UAAU,WACnB,QAAO;AAGT,MAAI,eAAe,IAAI,KAAe,CACpC,QAAO;AAGT,UAAQ,GAAG,SAAoB;AAC7B,OAAI;AACF,WAAQ,MAA0C,MAAM,KAAK,KAAK;YAC3D,OAAO;IACd,MAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,SAAK,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,UAAU;IAGzC,MAAM,iBAAkB,aACtB;AAEF,QAAI,OAAO,mBAAmB,WAC5B,QAAQ,eAAmD,MACzD,cACA,KACD;AAEH;;;IAIP,CAAC"}

package/dist/utils/generateWebVitalID.cjs

@@ -1,8 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/utils/generateWebVitalID.ts
-const generateWebVitalID = () => {
-	return `mxlv2-${Date.now()}-${Math.floor(Math.random() * 8999999999999) + 0xe8d4a51000}`;
-};
+const generateWebVitalID = () => `mxlv2-${Date.now()}-${Math.floor(Math.random() * 8999999999999) + 0xe8d4a51000}`;
 //#endregion
 exports.generateWebVitalID = generateWebVitalID;
 

package/dist/utils/generateWebVitalID.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateWebVitalID.cjs","names":[],"sources":["../../src/utils/generateWebVitalID.ts"],"sourcesContent":["// Generates a unique ID for web vitals metrics, following the format \"v5-{timestamp}-{randomNumber}\"\n// https://github.com/GoogleChrome/web-vitals/blob/main/src/lib/generateUniqueID.ts\nexport const generateWebVitalID = () => {\n  return `mxlv2-${Date.now()}-${Math.floor(Math.random() * (9e12 - 1)) + 1e12}`;\n};\n"],"mappings":";;AAEA,MAAa,2BAA2B;AACtC,QAAO,SAAS,KAAK,KAAK,CAAC,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAI,cAAU,GAAG"}
+{"version":3,"file":"generateWebVitalID.cjs","names":[],"sources":["../../src/utils/generateWebVitalID.ts"],"sourcesContent":["// Generates a unique ID for web vitals metrics, following the format \"v5-{timestamp}-{randomNumber}\"\n// https://github.com/GoogleChrome/web-vitals/blob/main/src/lib/generateUniqueID.ts\nexport const generateWebVitalID = () =>\n  `mxlv2-${Date.now()}-${Math.floor(Math.random() * (9e12 - 1)) + 1e12}`;\n"],"mappings":";;AAEA,MAAa,2BACX,SAAS,KAAK,KAAK,CAAC,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAI,cAAU,GAAG"}

package/dist/utils/generateWebVitalID.js

@@ -1,7 +1,5 @@
 //#region src/utils/generateWebVitalID.ts
-const generateWebVitalID = () => {
-	return `mxlv2-${Date.now()}-${Math.floor(Math.random() * 8999999999999) + 0xe8d4a51000}`;
-};
+const generateWebVitalID = () => `mxlv2-${Date.now()}-${Math.floor(Math.random() * 8999999999999) + 0xe8d4a51000}`;
 //#endregion
 export { generateWebVitalID };
 

package/dist/utils/generateWebVitalID.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateWebVitalID.js","names":[],"sources":["../../src/utils/generateWebVitalID.ts"],"sourcesContent":["// Generates a unique ID for web vitals metrics, following the format \"v5-{timestamp}-{randomNumber}\"\n// https://github.com/GoogleChrome/web-vitals/blob/main/src/lib/generateUniqueID.ts\nexport const generateWebVitalID = () => {\n  return `mxlv2-${Date.now()}-${Math.floor(Math.random() * (9e12 - 1)) + 1e12}`;\n};\n"],"mappings":";AAEA,MAAa,2BAA2B;AACtC,QAAO,SAAS,KAAK,KAAK,CAAC,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAI,cAAU,GAAG"}
+{"version":3,"file":"generateWebVitalID.js","names":[],"sources":["../../src/utils/generateWebVitalID.ts"],"sourcesContent":["// Generates a unique ID for web vitals metrics, following the format \"v5-{timestamp}-{randomNumber}\"\n// https://github.com/GoogleChrome/web-vitals/blob/main/src/lib/generateUniqueID.ts\nexport const generateWebVitalID = () =>\n  `mxlv2-${Date.now()}-${Math.floor(Math.random() * (9e12 - 1)) + 1e12}`;\n"],"mappings":";AAEA,MAAa,2BACX,SAAS,KAAK,KAAK,CAAC,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAI,cAAU,GAAG"}

package/dist/utils/getIncrementedCount.cjs

@@ -11,8 +11,8 @@ const getIncrementedCount = (storage, key, diag) => {
 		number++;
 		storage.setItem(key, number.toString());
 		return number;
-	} catch (e) {
-		diag.warn(`Failed to retrieve ${key} from storage: `, e);
+	} catch (error) {
+		diag.warn(`Failed to retrieve ${key} from storage: `, error);
 		return 1;
 	}
 };

package/dist/utils/getIncrementedCount.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIncrementedCount.cjs","names":[],"sources":["../../src/utils/getIncrementedCount.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n// Increments and returns a global counter shared across all tabs\n// Race conditions are possible but acceptable for diagnostic use-cases\nexport const getIncrementedCount = (\n  storage: Storage,\n  key: string,\n  diag: DiagLogger,\n) => {\n  try {\n    const value = storage.getItem(key);\n    let number = value ? parseInt(value, 10) : 0;\n    if (Number.isNaN(number)) {\n      diag.warn(\n        `Non-numeric value stored at ${key} (${String(value)}); resetting counter.`,\n      );\n      number = 0;\n    }\n    number++;\n    storage.setItem(key, number.toString());\n    return number;\n  } catch (e) {\n    diag.warn(`Failed to retrieve ${key} from storage: `, e);\n    return 1;\n  }\n};\n"],"mappings":";;AAIA,MAAa,uBACX,SACA,KACA,SACG;AACH,KAAI;EACF,MAAM,QAAQ,QAAQ,QAAQ,IAAI;EAClC,IAAI,SAAS,QAAQ,SAAS,OAAO,GAAG,GAAG;AAC3C,MAAI,OAAO,MAAM,OAAO,EAAE;AACxB,QAAK,KACH,+BAA+B,IAAI,IAAI,OAAO,MAAM,CAAC,uBACtD;AACD,YAAS;;AAEX;AACA,UAAQ,QAAQ,KAAK,OAAO,UAAU,CAAC;AACvC,SAAO;UACA,GAAG;AACV,OAAK,KAAK,sBAAsB,IAAI,kBAAkB,EAAE;AACxD,SAAO"}
+{"version":3,"file":"getIncrementedCount.cjs","names":[],"sources":["../../src/utils/getIncrementedCount.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n// Increments and returns a global counter shared across all tabs\n// Race conditions are possible but acceptable for diagnostic use-cases\nexport const getIncrementedCount = (\n  storage: Storage,\n  key: string,\n  diag: DiagLogger,\n) => {\n  try {\n    const value = storage.getItem(key);\n    let number = value ? parseInt(value, 10) : 0;\n    if (Number.isNaN(number)) {\n      diag.warn(\n        `Non-numeric value stored at ${key} (${String(value)}); resetting counter.`,\n      );\n      number = 0;\n    }\n    number++;\n    storage.setItem(key, number.toString());\n    return number;\n  } catch (error) {\n    diag.warn(`Failed to retrieve ${key} from storage: `, error);\n    return 1;\n  }\n};\n"],"mappings":";;AAIA,MAAa,uBACX,SACA,KACA,SACG;AACH,KAAI;EACF,MAAM,QAAQ,QAAQ,QAAQ,IAAI;EAClC,IAAI,SAAS,QAAQ,SAAS,OAAO,GAAG,GAAG;AAC3C,MAAI,OAAO,MAAM,OAAO,EAAE;AACxB,QAAK,KACH,+BAA+B,IAAI,IAAI,OAAO,MAAM,CAAC,uBACtD;AACD,YAAS;;AAEX;AACA,UAAQ,QAAQ,KAAK,OAAO,UAAU,CAAC;AACvC,SAAO;UACA,OAAO;AACd,OAAK,KAAK,sBAAsB,IAAI,kBAAkB,MAAM;AAC5D,SAAO"}

package/dist/utils/getIncrementedCount.js

@@ -10,8 +10,8 @@ const getIncrementedCount = (storage, key, diag) => {
 		number++;
 		storage.setItem(key, number.toString());
 		return number;
-	} catch (e) {
-		diag.warn(`Failed to retrieve ${key} from storage: `, e);
+	} catch (error) {
+		diag.warn(`Failed to retrieve ${key} from storage: `, error);
 		return 1;
 	}
 };

package/dist/utils/getIncrementedCount.js.map

@@ -1 +1 @@
-{"version":3,"file":"getIncrementedCount.js","names":[],"sources":["../../src/utils/getIncrementedCount.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n// Increments and returns a global counter shared across all tabs\n// Race conditions are possible but acceptable for diagnostic use-cases\nexport const getIncrementedCount = (\n  storage: Storage,\n  key: string,\n  diag: DiagLogger,\n) => {\n  try {\n    const value = storage.getItem(key);\n    let number = value ? parseInt(value, 10) : 0;\n    if (Number.isNaN(number)) {\n      diag.warn(\n        `Non-numeric value stored at ${key} (${String(value)}); resetting counter.`,\n      );\n      number = 0;\n    }\n    number++;\n    storage.setItem(key, number.toString());\n    return number;\n  } catch (e) {\n    diag.warn(`Failed to retrieve ${key} from storage: `, e);\n    return 1;\n  }\n};\n"],"mappings":";AAIA,MAAa,uBACX,SACA,KACA,SACG;AACH,KAAI;EACF,MAAM,QAAQ,QAAQ,QAAQ,IAAI;EAClC,IAAI,SAAS,QAAQ,SAAS,OAAO,GAAG,GAAG;AAC3C,MAAI,OAAO,MAAM,OAAO,EAAE;AACxB,QAAK,KACH,+BAA+B,IAAI,IAAI,OAAO,MAAM,CAAC,uBACtD;AACD,YAAS;;AAEX;AACA,UAAQ,QAAQ,KAAK,OAAO,UAAU,CAAC;AACvC,SAAO;UACA,GAAG;AACV,OAAK,KAAK,sBAAsB,IAAI,kBAAkB,EAAE;AACxD,SAAO"}
+{"version":3,"file":"getIncrementedCount.js","names":[],"sources":["../../src/utils/getIncrementedCount.ts"],"sourcesContent":["import type { DiagLogger } from '@opentelemetry/api';\n\n// Increments and returns a global counter shared across all tabs\n// Race conditions are possible but acceptable for diagnostic use-cases\nexport const getIncrementedCount = (\n  storage: Storage,\n  key: string,\n  diag: DiagLogger,\n) => {\n  try {\n    const value = storage.getItem(key);\n    let number = value ? parseInt(value, 10) : 0;\n    if (Number.isNaN(number)) {\n      diag.warn(\n        `Non-numeric value stored at ${key} (${String(value)}); resetting counter.`,\n      );\n      number = 0;\n    }\n    number++;\n    storage.setItem(key, number.toString());\n    return number;\n  } catch (error) {\n    diag.warn(`Failed to retrieve ${key} from storage: `, error);\n    return 1;\n  }\n};\n"],"mappings":";AAIA,MAAa,uBACX,SACA,KACA,SACG;AACH,KAAI;EACF,MAAM,QAAQ,QAAQ,QAAQ,IAAI;EAClC,IAAI,SAAS,QAAQ,SAAS,OAAO,GAAG,GAAG;AAC3C,MAAI,OAAO,MAAM,OAAO,EAAE;AACxB,QAAK,KACH,+BAA+B,IAAI,IAAI,OAAO,MAAM,CAAC,uBACtD;AACD,YAAS;;AAEX;AACA,UAAQ,QAAQ,KAAK,OAAO,UAAU,CAAC;AACvC,SAAO;UACA,OAAO;AACd,OAAK,KAAK,sBAAsB,IAAI,kBAAkB,MAAM;AAC5D,SAAO"}

package/dist/utils/globalConfig.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"globalConfig.cjs","names":[],"sources":["../../src/utils/globalConfig.ts"],"sourcesContent":["export type GlobalConfig = {\n  _MXLFileBundleIDs?: Record<string, string>;\n};\n\nexport const GLOBAL_CONFIG = globalThis as unknown as GlobalConfig;\n"],"mappings":";;AAIA,MAAa,gBAAgB"}
+{"version":3,"file":"globalConfig.cjs","names":[],"sources":["../../src/utils/globalConfig.ts"],"sourcesContent":["export interface GlobalConfig {\n  _MXLFileBundleIDs?: Record<string, string>;\n}\n\nexport const GLOBAL_CONFIG = globalThis as unknown as GlobalConfig;\n"],"mappings":";;AAIA,MAAa,gBAAgB"}

package/dist/utils/globalConfig.d.cts

@@ -1,7 +1,7 @@
 //#region src/utils/globalConfig.d.ts
-type GlobalConfig = {
+interface GlobalConfig {
   _MXLFileBundleIDs?: Record<string, string>;
-};
+}
 declare const GLOBAL_CONFIG: GlobalConfig;
 //#endregion
 export { GLOBAL_CONFIG, GlobalConfig };

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

@@ -1 +1 @@
-{"version":3,"file":"globalConfig.d.cts","names":[],"sources":["../../src/utils/globalConfig.ts"],"mappings":";KAAY,YAAA;EACV,iBAAA,GAAoB,MAAA;AAAA;AAAA,cAGT,aAAA,EAAyC,YAAA"}
+{"version":3,"file":"globalConfig.d.cts","names":[],"sources":["../../src/utils/globalConfig.ts"],"mappings":";UAAiB,YAAA;EACf,iBAAA,GAAoB,MAAA;AAAA;AAAA,cAGT,aAAA,EAAyC,YAAA"}

package/dist/utils/globalConfig.d.ts

@@ -1,7 +1,7 @@
 //#region src/utils/globalConfig.d.ts
-type GlobalConfig = {
+interface GlobalConfig {
   _MXLFileBundleIDs?: Record<string, string>;
-};
+}
 declare const GLOBAL_CONFIG: GlobalConfig;
 //#endregion
 export { GLOBAL_CONFIG, GlobalConfig };

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

@@ -1 +1 @@
-{"version":3,"file":"globalConfig.d.ts","names":[],"sources":["../../src/utils/globalConfig.ts"],"mappings":";KAAY,YAAA;EACV,iBAAA,GAAoB,MAAA;AAAA;AAAA,cAGT,aAAA,EAAyC,YAAA"}
+{"version":3,"file":"globalConfig.d.ts","names":[],"sources":["../../src/utils/globalConfig.ts"],"mappings":";UAAiB,YAAA;EACf,iBAAA,GAAoB,MAAA;AAAA;AAAA,cAGT,aAAA,EAAyC,YAAA"}

package/dist/utils/globalConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalConfig.js","names":[],"sources":["../../src/utils/globalConfig.ts"],"sourcesContent":["export type GlobalConfig = {\n  _MXLFileBundleIDs?: Record<string, string>;\n};\n\nexport const GLOBAL_CONFIG = globalThis as unknown as GlobalConfig;\n"],"mappings":";AAIA,MAAa,gBAAgB"}
+{"version":3,"file":"globalConfig.js","names":[],"sources":["../../src/utils/globalConfig.ts"],"sourcesContent":["export interface GlobalConfig {\n  _MXLFileBundleIDs?: Record<string, string>;\n}\n\nexport const GLOBAL_CONFIG = globalThis as unknown as GlobalConfig;\n"],"mappings":";AAIA,MAAa,gBAAgB"}

package/dist/utils/index.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils_clampNumber = require("./clampNumber.cjs");
 const require_utils_bulkAddEventListener_bulkAddEventListener = require("./bulkAddEventListener/bulkAddEventListener.cjs");
 const require_utils_bulkRemoveEventListener_bulkRemoveEventListener = require("./bulkRemoveEventListener/bulkRemoveEventListener.cjs");
 const require_utils_createSafeProxy_createSafeProxy = require("./createSafeProxy/createSafeProxy.cjs");
@@ -8,18 +9,17 @@ const require_utils_getIncrementedCount = require("./getIncrementedCount.cjs");
 const require_utils_getVisibilityState = require("./getVisibilityState.cjs");
 const require_utils_globalConfig = require("./globalConfig.cjs");
 const require_utils_isDeviceIdEnabled = require("./isDeviceIdEnabled.cjs");
-const require_utils_MXLSpanStorage_MXLSpanStorage = require("./MXLSpanStorage/MXLSpanStorage.cjs");
 const require_utils_NamespacedStorage_NamespacedStorage = require("./NamespacedStorage/NamespacedStorage.cjs");
 const require_utils_nsfConfigValidation = require("./nsfConfigValidation.cjs");
 const require_utils_PerformanceManager_OTelPerformanceManager = require("./PerformanceManager/OTelPerformanceManager.cjs");
 const require_utils_performanceObserver_performanceObserver = require("./performanceObserver/performanceObserver.cjs");
 const require_utils_throttle = require("./throttle.cjs");
 exports.GLOBAL_CONFIG = require_utils_globalConfig.GLOBAL_CONFIG;
-exports.MXLSpanStorage = require_utils_MXLSpanStorage_MXLSpanStorage.MXLSpanStorage;
 exports.NamespacedStorage = require_utils_NamespacedStorage_NamespacedStorage.NamespacedStorage;
 exports.OTelPerformanceManager = require_utils_PerformanceManager_OTelPerformanceManager.OTelPerformanceManager;
 exports.bulkAddEventListener = require_utils_bulkAddEventListener_bulkAddEventListener.bulkAddEventListener;
 exports.bulkRemoveEventListener = require_utils_bulkRemoveEventListener_bulkRemoveEventListener.bulkRemoveEventListener;
+exports.clampNumber = require_utils_clampNumber.clampNumber;
 exports.createPerformanceObserver = require_utils_performanceObserver_performanceObserver.createPerformanceObserver;
 exports.createSafeProxy = require_utils_createSafeProxy_createSafeProxy.createSafeProxy;
 exports.generateUUID = require_utils_generateUUID.generateUUID;

package/dist/utils/index.d.cts

@@ -1,3 +1,4 @@
+import { clampNumber } from "./clampNumber.cjs";
 import { bulkAddEventListener } from "./bulkAddEventListener/bulkAddEventListener.cjs";
 import { bulkRemoveEventListener } from "./bulkRemoveEventListener/bulkRemoveEventListener.cjs";
 import { createSafeProxy } from "./createSafeProxy/createSafeProxy.cjs";
@@ -7,12 +8,11 @@ import { getIncrementedCount } from "./getIncrementedCount.cjs";
 import { getVisibilityState } from "./getVisibilityState.cjs";
 import { GLOBAL_CONFIG } from "./globalConfig.cjs";
 import { isDeviceIdEnabled } from "./isDeviceIdEnabled.cjs";
-import { MXLSpanStorage } from "./MXLSpanStorage/MXLSpanStorage.cjs";
 import { NamespacedStorage } from "./NamespacedStorage/NamespacedStorage.cjs";
 import { nsfConfigValidation } from "./nsfConfigValidation.cjs";
 import { PerformanceManager } from "./PerformanceManager/types.cjs";
 import { OTelPerformanceManager } from "./PerformanceManager/OTelPerformanceManager.cjs";
 import { createPerformanceObserver, isEntryTypeSupported } from "./performanceObserver/performanceObserver.cjs";
-import { throttle } from "./throttle.cjs";
+import { ThrottledFunction, throttle } from "./throttle.cjs";
 import { TimeoutRef } from "./timeout/types.cjs";
-export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };
+export { GLOBAL_CONFIG, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type ThrottledFunction, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, clampNumber, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };

package/dist/utils/index.d.ts

@@ -1,3 +1,4 @@
+import { clampNumber } from "./clampNumber.js";
 import { bulkAddEventListener } from "./bulkAddEventListener/bulkAddEventListener.js";
 import { bulkRemoveEventListener } from "./bulkRemoveEventListener/bulkRemoveEventListener.js";
 import { createSafeProxy } from "./createSafeProxy/createSafeProxy.js";
@@ -7,12 +8,11 @@ import { getIncrementedCount } from "./getIncrementedCount.js";
 import { getVisibilityState } from "./getVisibilityState.js";
 import { GLOBAL_CONFIG } from "./globalConfig.js";
 import { isDeviceIdEnabled } from "./isDeviceIdEnabled.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 { createPerformanceObserver, isEntryTypeSupported } from "./performanceObserver/performanceObserver.js";
-import { throttle } from "./throttle.js";
+import { ThrottledFunction, throttle } from "./throttle.js";
 import { TimeoutRef } from "./timeout/types.js";
-export { GLOBAL_CONFIG, MXLSpanStorage, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };
+export { GLOBAL_CONFIG, NamespacedStorage, OTelPerformanceManager, type PerformanceManager, type ThrottledFunction, type TimeoutRef, bulkAddEventListener, bulkRemoveEventListener, clampNumber, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };

package/dist/utils/index.js

@@ -1,3 +1,4 @@
+import { clampNumber } from "./clampNumber.js";
 import { bulkAddEventListener } from "./bulkAddEventListener/bulkAddEventListener.js";
 import { bulkRemoveEventListener } from "./bulkRemoveEventListener/bulkRemoveEventListener.js";
 import { createSafeProxy } from "./createSafeProxy/createSafeProxy.js";
@@ -7,10 +8,9 @@ import { getIncrementedCount } from "./getIncrementedCount.js";
 import { getVisibilityState } from "./getVisibilityState.js";
 import { GLOBAL_CONFIG } from "./globalConfig.js";
 import { isDeviceIdEnabled } from "./isDeviceIdEnabled.js";
-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, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };
+export { GLOBAL_CONFIG, NamespacedStorage, OTelPerformanceManager, bulkAddEventListener, bulkRemoveEventListener, clampNumber, createPerformanceObserver, createSafeProxy, generateUUID, generateWebVitalID, getIncrementedCount, getVisibilityState, isDeviceIdEnabled, isEntryTypeSupported, nsfConfigValidation, throttle };

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,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"}
+{"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.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,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"}
+{"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/performanceObserver/performanceObserver.cjs

@@ -26,13 +26,13 @@ function createPerformanceObserver(type, processEntry, options) {
 		const observer = new PerformanceObserver((list) => {
 			for (const entry of list.getEntries()) try {
 				processEntry(entry);
-			} catch (e) {
-				diag?.error(`error processing ${type} entry`, e);
+			} catch (error) {
+				diag?.error(`error processing ${type} entry`, error);
 			}
 		});
 		observer.observe({
-			type,
 			buffered: true,
+			type,
 			...observeOptions
 		});
 		return observer;

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

@@ -1 +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"}
+{"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 (error) {\n          diag?.error(`error processing ${type} entry`, error);\n        }\n      }\n    });\n    observer.observe({ buffered: true, type, ...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,OAAO;AACd,UAAM,MAAM,oBAAoB,KAAK,SAAS,MAAM;;IAGxD;AACF,WAAS,QAAQ;GAAE,UAAU;GAAM;GAAM,GAAG;GAAgB,CAAC;AAC7D,SAAO;SACD;AACN,SAAO"}

package/dist/utils/performanceObserver/performanceObserver.js

@@ -25,13 +25,13 @@ function createPerformanceObserver(type, processEntry, options) {
 		const observer = new PerformanceObserver((list) => {
 			for (const entry of list.getEntries()) try {
 				processEntry(entry);
-			} catch (e) {
-				diag?.error(`error processing ${type} entry`, e);
+			} catch (error) {
+				diag?.error(`error processing ${type} entry`, error);
 			}
 		});
 		observer.observe({
-			type,
 			buffered: true,
+			type,
 			...observeOptions
 		});
 		return observer;

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

@@ -1 +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"}
+{"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 (error) {\n          diag?.error(`error processing ${type} entry`, error);\n        }\n      }\n    });\n    observer.observe({ buffered: true, type, ...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,OAAO;AACd,UAAM,MAAM,oBAAoB,KAAK,SAAS,MAAM;;IAGxD;AACF,WAAS,QAAQ;GAAE,UAAU;GAAM;GAAM,GAAG;GAAgB,CAAC;AAC7D,SAAO;SACD;AACN,SAAO"}

package/dist/utils/throttle.cjs

@@ -1,21 +1,25 @@
 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.
-*
-* NOTE: if the wrapped function makes use of "this", it must be properly bind from the caller, as this wrapper will not bind it.
-* For this, we suggest you always pass functions declared as fat arrow functions, as they have their "this" lexically defined.
-* */
 const throttle = (func, timeout = 1e3) => {
 	let isWaiting = false;
-	return (...args) => {
+	let timeoutId = null;
+	const throttled = ((...args) => {
 		if (isWaiting) return;
 		func(...args);
-		setTimeout(() => {
+		isWaiting = true;
+		timeoutId = setTimeout(() => {
 			isWaiting = false;
+			timeoutId = null;
 		}, timeout);
-		isWaiting = true;
+	});
+	throttled.cancel = () => {
+		if (timeoutId !== null) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+		isWaiting = false;
 	};
+	return throttled;
 };
 //#endregion
 exports.throttle = throttle;

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 type ThrottledFunction<F extends (...args: never[]) => unknown> = ((\n  ...args: Parameters<F>\n) => ReturnType<F>) & {\n  cancel: () => void;\n};\n\nexport const throttle = <F extends (...args: Parameters<F>) => ReturnType<F>>(\n  func: F,\n  timeout = 1000,\n): ThrottledFunction<F> => {\n  let isWaiting = false;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  const throttled = ((...args: Parameters<F>) => {\n    if (isWaiting) {\n      return;\n    }\n    func(...args);\n    isWaiting = true;\n    timeoutId = setTimeout(() => {\n      isWaiting = false;\n      timeoutId = null;\n    }, timeout);\n  }) as ThrottledFunction<F>;\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    isWaiting = false;\n  };\n\n  return throttled;\n};\n"],"mappings":";;AAYA,MAAa,YACX,MACA,UAAU,QACe;CACzB,IAAI,YAAY;CAChB,IAAI,YAAkD;CAEtD,MAAM,cAAc,GAAG,SAAwB;AAC7C,MAAI,UACF;AAEF,OAAK,GAAG,KAAK;AACb,cAAY;AACZ,cAAY,iBAAiB;AAC3B,eAAY;AACZ,eAAY;KACX,QAAQ;;AAGb,WAAU,eAAe;AACvB,MAAI,cAAc,MAAM;AACtB,gBAAa,UAAU;AACvB,eAAY;;AAEd,cAAY;;AAGd,QAAO"}

package/dist/utils/throttle.d.cts

@@ -1,11 +1,14 @@
 //#region src/utils/throttle.d.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
+/** 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.
  *
  * NOTE: if the wrapped function makes use of "this", it must be properly bind from the caller, as this wrapper will not bind it.
  * For this, we suggest you always pass functions declared as fat arrow functions, as they have their "this" lexically defined.
  * */
-declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(func: F, timeout?: number) => (...args: Parameters<F>) => void;
+type ThrottledFunction<F extends (...args: never[]) => unknown> = ((...args: Parameters<F>) => ReturnType<F>) & {
+  cancel: () => void;
+};
+declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(func: F, timeout?: number) => ThrottledFunction<F>;
 //#endregion
-export { throttle };
+export { ThrottledFunction, throttle };
 //# sourceMappingURL=throttle.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.cts","names":[],"sources":["../../src/utils/throttle.ts"],"mappings":";;AAMA;;;;;cAAa,QAAA,iBAA0B,IAAA,EAAM,UAAA,CAAW,CAAA,MAAO,UAAA,CAAW,CAAA,GACxE,IAAA,EAAM,CAAA,EACN,OAAA,kBAGW,IAAA,EAAM,UAAA,CAAW,CAAA"}
+{"version":3,"file":"throttle.d.cts","names":[],"sources":["../../src/utils/throttle.ts"],"mappings":";;AAMA;;;;;KAAY,iBAAA,eAAgC,IAAA,8BACvC,IAAA,EAAM,UAAA,CAAW,CAAA,MACjB,UAAA,CAAW,CAAA;EACd,MAAA;AAAA;AAAA,cAGW,QAAA,iBAA0B,IAAA,EAAM,UAAA,CAAW,CAAA,MAAO,UAAA,CAAW,CAAA,GACxE,IAAA,EAAM,CAAA,EACN,OAAA,cACC,iBAAA,CAAkB,CAAA"}

package/dist/utils/throttle.d.ts

@@ -1,11 +1,14 @@
 //#region src/utils/throttle.d.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
+/** 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.
  *
  * NOTE: if the wrapped function makes use of "this", it must be properly bind from the caller, as this wrapper will not bind it.
  * For this, we suggest you always pass functions declared as fat arrow functions, as they have their "this" lexically defined.
  * */
-declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(func: F, timeout?: number) => (...args: Parameters<F>) => void;
+type ThrottledFunction<F extends (...args: never[]) => unknown> = ((...args: Parameters<F>) => ReturnType<F>) & {
+  cancel: () => void;
+};
+declare const throttle: <F extends (...args: Parameters<F>) => ReturnType<F>>(func: F, timeout?: number) => ThrottledFunction<F>;
 //#endregion
-export { throttle };
+export { ThrottledFunction, throttle };
 //# sourceMappingURL=throttle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.ts","names":[],"sources":["../../src/utils/throttle.ts"],"mappings":";;AAMA;;;;;cAAa,QAAA,iBAA0B,IAAA,EAAM,UAAA,CAAW,CAAA,MAAO,UAAA,CAAW,CAAA,GACxE,IAAA,EAAM,CAAA,EACN,OAAA,kBAGW,IAAA,EAAM,UAAA,CAAW,CAAA"}
+{"version":3,"file":"throttle.d.ts","names":[],"sources":["../../src/utils/throttle.ts"],"mappings":";;AAMA;;;;;KAAY,iBAAA,eAAgC,IAAA,8BACvC,IAAA,EAAM,UAAA,CAAW,CAAA,MACjB,UAAA,CAAW,CAAA;EACd,MAAA;AAAA;AAAA,cAGW,QAAA,iBAA0B,IAAA,EAAM,UAAA,CAAW,CAAA,MAAO,UAAA,CAAW,CAAA,GACxE,IAAA,EAAM,CAAA,EACN,OAAA,cACC,iBAAA,CAAkB,CAAA"}

package/dist/utils/throttle.js

@@ -1,20 +1,24 @@
 //#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.
-*
-* NOTE: if the wrapped function makes use of "this", it must be properly bind from the caller, as this wrapper will not bind it.
-* For this, we suggest you always pass functions declared as fat arrow functions, as they have their "this" lexically defined.
-* */
 const throttle = (func, timeout = 1e3) => {
 	let isWaiting = false;
-	return (...args) => {
+	let timeoutId = null;
+	const throttled = ((...args) => {
 		if (isWaiting) return;
 		func(...args);
-		setTimeout(() => {
+		isWaiting = true;
+		timeoutId = setTimeout(() => {
 			isWaiting = false;
+			timeoutId = null;
 		}, timeout);
-		isWaiting = true;
+	});
+	throttled.cancel = () => {
+		if (timeoutId !== null) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+		isWaiting = false;
 	};
+	return throttled;
 };
 //#endregion
 export { throttle };

package/dist/utils/throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.js","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.js","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 type ThrottledFunction<F extends (...args: never[]) => unknown> = ((\n  ...args: Parameters<F>\n) => ReturnType<F>) & {\n  cancel: () => void;\n};\n\nexport const throttle = <F extends (...args: Parameters<F>) => ReturnType<F>>(\n  func: F,\n  timeout = 1000,\n): ThrottledFunction<F> => {\n  let isWaiting = false;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  const throttled = ((...args: Parameters<F>) => {\n    if (isWaiting) {\n      return;\n    }\n    func(...args);\n    isWaiting = true;\n    timeoutId = setTimeout(() => {\n      isWaiting = false;\n      timeoutId = null;\n    }, timeout);\n  }) as ThrottledFunction<F>;\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    isWaiting = false;\n  };\n\n  return throttled;\n};\n"],"mappings":";AAYA,MAAa,YACX,MACA,UAAU,QACe;CACzB,IAAI,YAAY;CAChB,IAAI,YAAkD;CAEtD,MAAM,cAAc,GAAG,SAAwB;AAC7C,MAAI,UACF;AAEF,OAAK,GAAG,KAAK;AACb,cAAY;AACZ,cAAY,iBAAiB;AAC3B,eAAY;AACZ,eAAY;KACX,QAAQ;;AAGb,WAAU,eAAe;AACvB,MAAI,cAAc,MAAM;AACtB,gBAAa,UAAU;AACvB,eAAY;;AAEd,cAAY;;AAGd,QAAO"}