@inslytic/sdk-browser 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,38 @@
+type InslyticConfig = {
+    apiKey: string;
+    endpoint?: string;
+    debug?: boolean;
+    flushInterval?: number;
+    maxBatchSize?: number;
+};
+type TrackOptions = {
+    properties?: Record<string, string>;
+};
+type QueuedEvent = {
+    eventName: string;
+    timestamp: string;
+    anonymousId: string;
+    sessionId: string;
+    userId: string | null;
+    consentGiven: boolean;
+    properties: Record<string, string>;
+    pageUrl: string;
+    pageTitle: string;
+    referrer: string;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    deviceType: "desktop" | "mobile" | "tablet";
+    browser: string;
+    os: string;
+};
+type IdentifyTraits = Record<string, string>;
+
+declare function init(cfg: InslyticConfig): void;
+declare function track(eventName: string, options?: TrackOptions): void;
+declare function identify(userId: string, _traits?: IdentifyTraits): void;
+declare function page(properties?: Record<string, string>): void;
+declare function setConsent(granted: boolean): void;
+declare function reset(): void;
+
+export { type IdentifyTraits, type InslyticConfig, type QueuedEvent, type TrackOptions, identify, init, page, reset, setConsent, track };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+type InslyticConfig = {
+    apiKey: string;
+    endpoint?: string;
+    debug?: boolean;
+    flushInterval?: number;
+    maxBatchSize?: number;
+};
+type TrackOptions = {
+    properties?: Record<string, string>;
+};
+type QueuedEvent = {
+    eventName: string;
+    timestamp: string;
+    anonymousId: string;
+    sessionId: string;
+    userId: string | null;
+    consentGiven: boolean;
+    properties: Record<string, string>;
+    pageUrl: string;
+    pageTitle: string;
+    referrer: string;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    deviceType: "desktop" | "mobile" | "tablet";
+    browser: string;
+    os: string;
+};
+type IdentifyTraits = Record<string, string>;
+
+declare function init(cfg: InslyticConfig): void;
+declare function track(eventName: string, options?: TrackOptions): void;
+declare function identify(userId: string, _traits?: IdentifyTraits): void;
+declare function page(properties?: Record<string, string>): void;
+declare function setConsent(granted: boolean): void;
+declare function reset(): void;
+
+export { type IdentifyTraits, type InslyticConfig, type QueuedEvent, type TrackOptions, identify, init, page, reset, setConsent, track };

package/dist/index.js

@@ -0,0 +1,314 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  identify: () => identify,
+  init: () => init,
+  page: () => page,
+  reset: () => reset,
+  setConsent: () => setConsent,
+  track: () => track
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/context.ts
+function getPageContext() {
+  const url = typeof location !== "undefined" ? location.href : "";
+  const title = typeof document !== "undefined" ? document.title : "";
+  const referrer = typeof document !== "undefined" ? document.referrer : "";
+  let utmSource = null;
+  let utmMedium = null;
+  let utmCampaign = null;
+  try {
+    const params = new URLSearchParams(location.search);
+    utmSource = params.get("utm_source");
+    utmMedium = params.get("utm_medium");
+    utmCampaign = params.get("utm_campaign");
+  } catch {
+  }
+  return { pageUrl: url, pageTitle: title, referrer, utmSource, utmMedium, utmCampaign };
+}
+function getDeviceContext() {
+  const ua = typeof navigator !== "undefined" ? navigator.userAgent : "";
+  return {
+    deviceType: parseDeviceType(ua),
+    browser: parseBrowser(ua),
+    os: parseOS(ua)
+  };
+}
+function parseDeviceType(ua) {
+  if (/tablet|ipad/i.test(ua)) return "tablet";
+  if (/mobile|iphone|android(?!.*tablet)/i.test(ua)) return "mobile";
+  return "desktop";
+}
+function parseBrowser(ua) {
+  if (/edg\//i.test(ua)) return "Edge";
+  if (/opr\//i.test(ua) || /opera/i.test(ua)) return "Opera";
+  if (/firefox\//i.test(ua)) return "Firefox";
+  if (/chrome\//i.test(ua) && !/edg\//i.test(ua)) return "Chrome";
+  if (/safari\//i.test(ua) && !/chrome\//i.test(ua)) return "Safari";
+  return "Other";
+}
+function parseOS(ua) {
+  if (/iphone|ipad|ipod/i.test(ua)) return "iOS";
+  if (/android/i.test(ua)) return "Android";
+  if (/windows/i.test(ua)) return "Windows";
+  if (/macintosh|mac os/i.test(ua)) return "macOS";
+  if (/linux/i.test(ua)) return "Linux";
+  return "Other";
+}
+
+// src/identity.ts
+var ANON_ID_KEY = "inslytic_anon_id";
+var SESSION_ID_KEY = "inslytic_session_id";
+var SESSION_LAST_ACTIVE_KEY = "inslytic_session_ts";
+var SESSION_TIMEOUT_MS = 30 * 60 * 1e3;
+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 getOrCreateAnonymousId() {
+  try {
+    const existing = localStorage.getItem(ANON_ID_KEY);
+    if (existing) return existing;
+    const id = generateId();
+    localStorage.setItem(ANON_ID_KEY, id);
+    return id;
+  } catch {
+    return generateId();
+  }
+}
+function getOrCreateSessionId() {
+  try {
+    const now = Date.now();
+    const lastActive = sessionStorage.getItem(SESSION_LAST_ACTIVE_KEY);
+    const existingId = sessionStorage.getItem(SESSION_ID_KEY);
+    if (existingId && lastActive) {
+      const elapsed = now - parseInt(lastActive, 10);
+      if (elapsed < SESSION_TIMEOUT_MS) {
+        sessionStorage.setItem(SESSION_LAST_ACTIVE_KEY, String(now));
+        return existingId;
+      }
+    }
+    const id = generateId();
+    sessionStorage.setItem(SESSION_ID_KEY, id);
+    sessionStorage.setItem(SESSION_LAST_ACTIVE_KEY, String(now));
+    return id;
+  } catch {
+    return generateId();
+  }
+}
+function resetAnonymousId() {
+  try {
+    localStorage.removeItem(ANON_ID_KEY);
+    sessionStorage.removeItem(SESSION_ID_KEY);
+    sessionStorage.removeItem(SESSION_LAST_ACTIVE_KEY);
+  } catch {
+  }
+}
+
+// src/queue.ts
+var DEFAULT_FLUSH_INTERVAL = 5e3;
+var DEFAULT_MAX_BATCH_SIZE = 20;
+var EventQueue = class {
+  queue = [];
+  timer = null;
+  config;
+  constructor(config) {
+    this.config = {
+      flushInterval: config.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
+      maxBatchSize: config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,
+      debug: config.debug ?? false,
+      endpoint: config.endpoint,
+      apiKey: config.apiKey
+    };
+    this.startTimer();
+    this.setupUnloadHandler();
+  }
+  enqueue(event) {
+    this.queue.push(event);
+    if (this.queue.length >= this.config.maxBatchSize) {
+      this.flush();
+    }
+  }
+  flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, this.config.maxBatchSize);
+    this.send(batch);
+  }
+  destroy() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.flush();
+  }
+  get pending() {
+    return this.queue.length;
+  }
+  startTimer() {
+    this.timer = setInterval(() => this.flush(), this.config.flushInterval);
+  }
+  setupUnloadHandler() {
+    if (typeof document === "undefined") return;
+    const handleUnload = () => {
+      if (this.queue.length === 0) return;
+      const batch = this.queue.splice(0);
+      const url = `${this.config.endpoint}/v1/ingest`;
+      const body = JSON.stringify({ events: batch });
+      if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+        const blob = new Blob([body], { type: "application/json" });
+        const sent = navigator.sendBeacon(url, blob);
+        if (sent) return;
+      }
+      try {
+        fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`
+          },
+          body,
+          keepalive: true
+        });
+      } catch {
+      }
+    };
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") handleUnload();
+    });
+    addEventListener("beforeunload", handleUnload);
+  }
+  send(batch) {
+    if (typeof navigator !== "undefined" && !navigator.onLine) {
+      this.queue.unshift(...batch);
+      this.log("Offline, re-queued", batch.length, "events");
+      return;
+    }
+    const url = `${this.config.endpoint}/v1/ingest`;
+    this.log("Flushing", batch.length, "events");
+    fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.apiKey}`
+      },
+      body: JSON.stringify({ events: batch })
+    }).catch(() => {
+      this.queue.unshift(...batch);
+      this.log("Send failed, re-queued", batch.length, "events");
+    });
+  }
+  log(...args) {
+    if (this.config.debug) {
+      console.log("[inslytic]", ...args);
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_ENDPOINT = "https://api.inslytic.com";
+var queue = null;
+var currentUserId = null;
+var consentGranted = false;
+var initialized = false;
+var _config = null;
+function init(cfg) {
+  if (initialized) return;
+  _config = { ...cfg };
+  consentGranted = false;
+  currentUserId = null;
+  queue = new EventQueue({
+    endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,
+    apiKey: cfg.apiKey,
+    flushInterval: cfg.flushInterval,
+    maxBatchSize: cfg.maxBatchSize,
+    debug: cfg.debug
+  });
+  initialized = true;
+}
+function track(eventName, options) {
+  if (!initialized || !queue) return;
+  const event = buildEvent(eventName, options?.properties ?? {});
+  queue.enqueue(event);
+}
+function identify(userId, _traits) {
+  if (!initialized || !queue) return;
+  currentUserId = userId;
+  const event = buildEvent("$identify", {});
+  queue.enqueue(event);
+}
+function page(properties) {
+  if (!initialized || !queue) return;
+  const event = buildEvent("$pageview", properties ?? {});
+  queue.enqueue(event);
+}
+function setConsent(granted) {
+  consentGranted = granted;
+}
+function reset() {
+  currentUserId = null;
+  consentGranted = false;
+  resetAnonymousId();
+  if (queue) {
+    queue.destroy();
+    queue = null;
+  }
+  initialized = false;
+  _config = null;
+}
+function buildEvent(eventName, properties) {
+  const page2 = getPageContext();
+  const device = getDeviceContext();
+  return {
+    eventName,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    anonymousId: getOrCreateAnonymousId(),
+    sessionId: getOrCreateSessionId(),
+    userId: currentUserId,
+    consentGiven: consentGranted,
+    properties,
+    pageUrl: page2.pageUrl,
+    pageTitle: page2.pageTitle,
+    referrer: page2.referrer,
+    utmSource: page2.utmSource,
+    utmMedium: page2.utmMedium,
+    utmCampaign: page2.utmCampaign,
+    deviceType: device.deviceType,
+    browser: device.browser,
+    os: device.os
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  identify,
+  init,
+  page,
+  reset,
+  setConsent,
+  track
+});

package/dist/index.mjs

@@ -0,0 +1,282 @@
+// src/context.ts
+function getPageContext() {
+  const url = typeof location !== "undefined" ? location.href : "";
+  const title = typeof document !== "undefined" ? document.title : "";
+  const referrer = typeof document !== "undefined" ? document.referrer : "";
+  let utmSource = null;
+  let utmMedium = null;
+  let utmCampaign = null;
+  try {
+    const params = new URLSearchParams(location.search);
+    utmSource = params.get("utm_source");
+    utmMedium = params.get("utm_medium");
+    utmCampaign = params.get("utm_campaign");
+  } catch {
+  }
+  return { pageUrl: url, pageTitle: title, referrer, utmSource, utmMedium, utmCampaign };
+}
+function getDeviceContext() {
+  const ua = typeof navigator !== "undefined" ? navigator.userAgent : "";
+  return {
+    deviceType: parseDeviceType(ua),
+    browser: parseBrowser(ua),
+    os: parseOS(ua)
+  };
+}
+function parseDeviceType(ua) {
+  if (/tablet|ipad/i.test(ua)) return "tablet";
+  if (/mobile|iphone|android(?!.*tablet)/i.test(ua)) return "mobile";
+  return "desktop";
+}
+function parseBrowser(ua) {
+  if (/edg\//i.test(ua)) return "Edge";
+  if (/opr\//i.test(ua) || /opera/i.test(ua)) return "Opera";
+  if (/firefox\//i.test(ua)) return "Firefox";
+  if (/chrome\//i.test(ua) && !/edg\//i.test(ua)) return "Chrome";
+  if (/safari\//i.test(ua) && !/chrome\//i.test(ua)) return "Safari";
+  return "Other";
+}
+function parseOS(ua) {
+  if (/iphone|ipad|ipod/i.test(ua)) return "iOS";
+  if (/android/i.test(ua)) return "Android";
+  if (/windows/i.test(ua)) return "Windows";
+  if (/macintosh|mac os/i.test(ua)) return "macOS";
+  if (/linux/i.test(ua)) return "Linux";
+  return "Other";
+}
+
+// src/identity.ts
+var ANON_ID_KEY = "inslytic_anon_id";
+var SESSION_ID_KEY = "inslytic_session_id";
+var SESSION_LAST_ACTIVE_KEY = "inslytic_session_ts";
+var SESSION_TIMEOUT_MS = 30 * 60 * 1e3;
+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 getOrCreateAnonymousId() {
+  try {
+    const existing = localStorage.getItem(ANON_ID_KEY);
+    if (existing) return existing;
+    const id = generateId();
+    localStorage.setItem(ANON_ID_KEY, id);
+    return id;
+  } catch {
+    return generateId();
+  }
+}
+function getOrCreateSessionId() {
+  try {
+    const now = Date.now();
+    const lastActive = sessionStorage.getItem(SESSION_LAST_ACTIVE_KEY);
+    const existingId = sessionStorage.getItem(SESSION_ID_KEY);
+    if (existingId && lastActive) {
+      const elapsed = now - parseInt(lastActive, 10);
+      if (elapsed < SESSION_TIMEOUT_MS) {
+        sessionStorage.setItem(SESSION_LAST_ACTIVE_KEY, String(now));
+        return existingId;
+      }
+    }
+    const id = generateId();
+    sessionStorage.setItem(SESSION_ID_KEY, id);
+    sessionStorage.setItem(SESSION_LAST_ACTIVE_KEY, String(now));
+    return id;
+  } catch {
+    return generateId();
+  }
+}
+function resetAnonymousId() {
+  try {
+    localStorage.removeItem(ANON_ID_KEY);
+    sessionStorage.removeItem(SESSION_ID_KEY);
+    sessionStorage.removeItem(SESSION_LAST_ACTIVE_KEY);
+  } catch {
+  }
+}
+
+// src/queue.ts
+var DEFAULT_FLUSH_INTERVAL = 5e3;
+var DEFAULT_MAX_BATCH_SIZE = 20;
+var EventQueue = class {
+  queue = [];
+  timer = null;
+  config;
+  constructor(config) {
+    this.config = {
+      flushInterval: config.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
+      maxBatchSize: config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,
+      debug: config.debug ?? false,
+      endpoint: config.endpoint,
+      apiKey: config.apiKey
+    };
+    this.startTimer();
+    this.setupUnloadHandler();
+  }
+  enqueue(event) {
+    this.queue.push(event);
+    if (this.queue.length >= this.config.maxBatchSize) {
+      this.flush();
+    }
+  }
+  flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0, this.config.maxBatchSize);
+    this.send(batch);
+  }
+  destroy() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.flush();
+  }
+  get pending() {
+    return this.queue.length;
+  }
+  startTimer() {
+    this.timer = setInterval(() => this.flush(), this.config.flushInterval);
+  }
+  setupUnloadHandler() {
+    if (typeof document === "undefined") return;
+    const handleUnload = () => {
+      if (this.queue.length === 0) return;
+      const batch = this.queue.splice(0);
+      const url = `${this.config.endpoint}/v1/ingest`;
+      const body = JSON.stringify({ events: batch });
+      if (typeof navigator !== "undefined" && navigator.sendBeacon) {
+        const blob = new Blob([body], { type: "application/json" });
+        const sent = navigator.sendBeacon(url, blob);
+        if (sent) return;
+      }
+      try {
+        fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.config.apiKey}`
+          },
+          body,
+          keepalive: true
+        });
+      } catch {
+      }
+    };
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState === "hidden") handleUnload();
+    });
+    addEventListener("beforeunload", handleUnload);
+  }
+  send(batch) {
+    if (typeof navigator !== "undefined" && !navigator.onLine) {
+      this.queue.unshift(...batch);
+      this.log("Offline, re-queued", batch.length, "events");
+      return;
+    }
+    const url = `${this.config.endpoint}/v1/ingest`;
+    this.log("Flushing", batch.length, "events");
+    fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.config.apiKey}`
+      },
+      body: JSON.stringify({ events: batch })
+    }).catch(() => {
+      this.queue.unshift(...batch);
+      this.log("Send failed, re-queued", batch.length, "events");
+    });
+  }
+  log(...args) {
+    if (this.config.debug) {
+      console.log("[inslytic]", ...args);
+    }
+  }
+};
+
+// src/client.ts
+var DEFAULT_ENDPOINT = "https://api.inslytic.com";
+var queue = null;
+var currentUserId = null;
+var consentGranted = false;
+var initialized = false;
+var _config = null;
+function init(cfg) {
+  if (initialized) return;
+  _config = { ...cfg };
+  consentGranted = false;
+  currentUserId = null;
+  queue = new EventQueue({
+    endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,
+    apiKey: cfg.apiKey,
+    flushInterval: cfg.flushInterval,
+    maxBatchSize: cfg.maxBatchSize,
+    debug: cfg.debug
+  });
+  initialized = true;
+}
+function track(eventName, options) {
+  if (!initialized || !queue) return;
+  const event = buildEvent(eventName, options?.properties ?? {});
+  queue.enqueue(event);
+}
+function identify(userId, _traits) {
+  if (!initialized || !queue) return;
+  currentUserId = userId;
+  const event = buildEvent("$identify", {});
+  queue.enqueue(event);
+}
+function page(properties) {
+  if (!initialized || !queue) return;
+  const event = buildEvent("$pageview", properties ?? {});
+  queue.enqueue(event);
+}
+function setConsent(granted) {
+  consentGranted = granted;
+}
+function reset() {
+  currentUserId = null;
+  consentGranted = false;
+  resetAnonymousId();
+  if (queue) {
+    queue.destroy();
+    queue = null;
+  }
+  initialized = false;
+  _config = null;
+}
+function buildEvent(eventName, properties) {
+  const page2 = getPageContext();
+  const device = getDeviceContext();
+  return {
+    eventName,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    anonymousId: getOrCreateAnonymousId(),
+    sessionId: getOrCreateSessionId(),
+    userId: currentUserId,
+    consentGiven: consentGranted,
+    properties,
+    pageUrl: page2.pageUrl,
+    pageTitle: page2.pageTitle,
+    referrer: page2.referrer,
+    utmSource: page2.utmSource,
+    utmMedium: page2.utmMedium,
+    utmCampaign: page2.utmCampaign,
+    deviceType: device.deviceType,
+    browser: device.browser,
+    os: device.os
+  };
+}
+export {
+  identify,
+  init,
+  page,
+  reset,
+  setConsent,
+  track
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@inslytic/sdk-browser",
+  "version": "0.1.1",
+  "description": "Browser tracking SDK for Inslytic — AI-powered product analytics",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inslytic/inslytic",
+    "directory": "packages/sdk-browser"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "product-analytics",
+    "browser",
+    "inslytic"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo node_modules"
+  }
+}