@visitor-analytics-sdk/utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Visitor Analytics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+declare const SDK_VERSION = "1.0.0";
+declare function generateId(): string;
+declare function generateShortId(): string;
+declare function debounce<T extends (...args: readonly unknown[]) => void>(fn: T, delay: number): T & {
+    cancel(): void;
+};
+declare function throttle<T extends (...args: readonly unknown[]) => void>(fn: T, limit: number): T & {
+    cancel(): void;
+};
+declare function safeCall<T>(fn: () => T, fallback: T): T;
+declare function safeCallAsync<T>(fn: () => Promise<T>, fallback: T): Promise<T>;
+declare function requestIdle(callback: () => void, timeout?: number): void;
+declare function deepFreeze<T extends object>(obj: T): Readonly<T>;
+declare function cloneRecord<T>(record: T): T;
+declare function isBrowser(): boolean;
+declare function noop(): void;
+declare function padZero(n: number): string;
+
+export { SDK_VERSION, cloneRecord, debounce, deepFreeze, generateId, generateShortId, isBrowser, noop, padZero, requestIdle, safeCall, safeCallAsync, throttle };

package/dist/index.js

@@ -0,0 +1,120 @@
+// src/index.ts
+var SDK_VERSION = "1.0.0";
+function generateId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function generateShortId() {
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    const bytes = new Uint8Array(8);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  return generateId().replace(/-/g, "").slice(0, 16);
+}
+function debounce(fn, delay) {
+  let timer = null;
+  const debounced = (...args) => {
+    if (timer !== null) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn(...args);
+      timer = null;
+    }, delay);
+  };
+  debounced.cancel = () => {
+    if (timer !== null) {
+      clearTimeout(timer);
+      timer = null;
+    }
+  };
+  return debounced;
+}
+function throttle(fn, limit) {
+  let inThrottle = false;
+  let lastArgs = null;
+  const throttled = (...args) => {
+    if (!inThrottle) {
+      fn(...args);
+      inThrottle = true;
+      setTimeout(() => {
+        inThrottle = false;
+        if (lastArgs) {
+          fn(...lastArgs);
+          lastArgs = null;
+        }
+      }, limit);
+    } else {
+      lastArgs = args;
+    }
+  };
+  throttled.cancel = () => {
+    inThrottle = false;
+    lastArgs = null;
+  };
+  return throttled;
+}
+function safeCall(fn, fallback) {
+  try {
+    return fn();
+  } catch {
+    return fallback;
+  }
+}
+async function safeCallAsync(fn, fallback) {
+  try {
+    return await fn();
+  } catch {
+    return fallback;
+  }
+}
+function requestIdle(callback, timeout = 5e3) {
+  if (typeof window !== "undefined" && "requestIdleCallback" in window) {
+    window.requestIdleCallback(callback, { timeout });
+  } else {
+    setTimeout(callback, 0);
+  }
+}
+function deepFreeze(obj) {
+  Object.freeze(obj);
+  for (const key of Object.keys(obj)) {
+    const val = obj[key];
+    if (val !== null && typeof val === "object" && !Object.isFrozen(val)) {
+      deepFreeze(val);
+    }
+  }
+  return obj;
+}
+function cloneRecord(record) {
+  return JSON.parse(JSON.stringify(record));
+}
+function isBrowser() {
+  return typeof window !== "undefined" && typeof document !== "undefined" && typeof navigator !== "undefined";
+}
+function noop() {
+}
+function padZero(n) {
+  return n < 10 ? `0${n}` : `${n}`;
+}
+export {
+  SDK_VERSION,
+  cloneRecord,
+  debounce,
+  deepFreeze,
+  generateId,
+  generateShortId,
+  isBrowser,
+  noop,
+  padZero,
+  requestIdle,
+  safeCall,
+  safeCallAsync,
+  throttle
+};

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@visitor-analytics-sdk/utils",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "typecheck": "tsc --noEmit"
+  }
+}