@levo-so/insights 0.1.78 → 0.1.80

package/dist/lib/analytics.js

@@ -1,140 +0,0 @@
-import { getLevoError as S } from "@levo-so/core";
-import { Analytics as j } from "analytics";
-import { getConfig as k } from "../stores/config.js";
-import { resetRateLimit as z } from "../stores/events.js";
-import { getSession as f, updateSession as a } from "../stores/session.js";
-import { getCurrentTab as D } from "../tracking/currentTab.js";
-import { getAuthHeaders as M } from "../utils/getAuthHeaders.js";
-const q = (r, p, s) => {
-  const { debug: I } = k();
-  if (!r)
-    return null;
-  const h = {
-    name: r.workspace,
-    /**
-     * Handle track events (custom events like clicks, scrolls, etc.)
-     *
-     * Enriches the event with:
-     * - Session/device IDs
-     * - Page metadata (URL, title, etc.)
-     * - Tab information
-     * - Timestamp
-     *
-     * Then queues for batched sending.
-     */
-    track: ({ payload: e }) => {
-      if (!s()) return;
-      const o = e?.properties || {};
-      p(e.event, o);
-    },
-    /**
-     * Handle page view events.
-     *
-     * Called when navigating to a new page (in SPAs) or on initial load.
-     * Resets the rate limit counter and tracks a page.view event.
-     */
-    page: ({ payload: e }) => {
-      if (!s()) return;
-      z();
-      const o = e?.properties || {};
-      p("page.view", {
-        ...o,
-        resource: "page"
-      });
-    },
-    /**
-     * Handle identify events (session establishment).
-     *
-     * This is called when identify() is invoked. It:
-     * 1. Reads identity from session store (set by init())
-     * 2. Checks if already identified (via BroadcastChannel) - if so, skip
-     * 3. Calls /welcome API to get session/device IDs
-     * 4. On success, broadcasts session to other tabs
-     *
-     * The /welcome API uses HttpOnly cookies to maintain persistent
-     * device identity across sessions.
-     */
-    identify: ({ payload: e }) => {
-      if (!s()) return;
-      const { workspace: o, site_id: w, debug: l } = k(), {
-        mode: d,
-        isIdentified: m,
-        isIdentifying: g,
-        sessionToken: _,
-        deviceToken: b,
-        insightsBaseUrl: u,
-        identity: i
-      } = f(), y = D(), T = f().allTabs.length;
-      if (!u || !i)
-        return;
-      const v = {
-        ...{
-          private_mode: e.traits?.private_mode ?? i.privateMode ?? !1,
-          dark_mode: e.traits?.dark_mode ?? i.darkMode ?? !1,
-          timezone: e.traits?.timezone ?? i.timezone ?? "",
-          locale: e.traits?.locale ?? i.locale ?? "",
-          referrer: e.traits?.referrer ?? i.referrer ?? { type: "", referrer: {}, data: {} },
-          properties: {
-            ...i.properties
-          }
-        },
-        workspace_id: o ?? "",
-        site_id: w ?? void 0,
-        hostname: window.location.hostname,
-        pathname: window.location.pathname,
-        page_title: document.title,
-        url: window.location.href,
-        created_at: (/* @__PURE__ */ new Date()).toISOString(),
-        tab_id: y ?? "",
-        tab_count: T ?? 0
-      };
-      if (l && console.log("[@levo-so/insights] Identification triggered:", {
-        isIdentified: m,
-        isIdentifying: g,
-        welcomeInput: v
-      }), m || g)
-        return;
-      if (a({ isIdentifying: !0 }), l) {
-        console.log("[@levo-so/insights] Debug mode enabled. Mocking session identification."), a({
-          isIdentified: !0,
-          isIdentifying: !1,
-          sessionId: "debug-session",
-          deviceId: "debug-device"
-        });
-        return;
-      }
-      const A = {
-        Accept: "application/json",
-        "Content-Type": "application/json",
-        ...M({ sessionToken: _, deviceToken: b, mode: d })
-      };
-      r.fetch.url(u, !0).url("/v1/insights/event/welcome").options({
-        keepAlive: !0,
-        credentials: d === "proxy" ? "include" : "omit"
-      }).headers(A).post(v).json().then((t) => {
-        if (!s()) return;
-        const { isIdentified: C } = f();
-        if (!C) {
-          const n = { isIdentified: !0 };
-          if (t?.content?.data?.session && (n.sessionId = t?.content?.data?.session), t?.content?.data?.device && (n.deviceId = t?.content?.data?.device), d === "direct" && t?.content?.meta) {
-            const c = t.content.meta;
-            c.device_token && (n.deviceToken = c.device_token), c.session_token && (n.sessionToken = c.session_token);
-          }
-          a(n);
-        }
-      }).catch((t) => {
-        console.log("/welcome failed with error", S(t));
-      }).finally(() => {
-        a({ isIdentifying: !1 });
-      });
-    }
-  };
-  return j({
-    app: r.workspace || "",
-    debug: !!I,
-    plugins: [h]
-  });
-};
-export {
-  q as createAnalytics
-};

package/dist/lib/insights.js

@@ -1,141 +0,0 @@
-import { setConfig as b, getConfig as h, updateConfigKey as _ } from "../stores/config.js";
-import { queueEvent as T, flushEventQueue as C, getEventQueue as E, clearEventQueue as S, initSessionFlushListener as I } from "../stores/events.js";
-import { updateSession as s, getSession as f, onSessionReady as B, $isContextReady as U } from "../stores/session.js";
-import { initActivityTracker as z } from "../tracking/activity.js";
-import { initBounceTracker as M } from "../tracking/bounce.js";
-import { initClicksTracker as P } from "../tracking/clicks.js";
-import { initClipboardTracker as x } from "../tracking/clipboard.js";
-import { getCurrentTab as L, initCurrentTabTracker as Q } from "../tracking/currentTab.js";
-import { initFormsTracker as q } from "../tracking/forms.js";
-import { initPageTracker as A } from "../tracking/page.js";
-import { initScrollBehaviorTracker as D } from "../tracking/scrollBehavior.js";
-import { initTextSelectionTracker as F } from "../tracking/textSelection.js";
-import { detectMode as N } from "../utils/detectMode.js";
-import { getReferrer as O } from "../utils/getReferrer.js";
-import { getUserProperties as K } from "../utils/getUserProperties.js";
-import { createAnalytics as V } from "./analytics.js";
-let t = null, n = !1;
-const d = [], de = (c, m) => {
-  const { insightsUrl: l, debug: p = !1, site: v = null } = m;
-  b({
-    workspace: c.workspace,
-    debug: p,
-    site_id: v
-  }), typeof window < "u" && Promise.all([K(), O()]).then(([i, e]) => {
-    const r = e?.type ? {
-      type: e.type,
-      referrer: e.referrer,
-      data: e.data,
-      raw: e.raw ?? ""
-    } : null;
-    s({
-      identity: {
-        locale: i.locale,
-        timezone: i.timezone,
-        darkMode: i.dark_mode,
-        privateMode: i.private_mode,
-        referrer: r,
-        properties: i.properties
-      }
-    });
-  }).catch(() => {
-    s({
-      identity: {
-        locale: null,
-        timezone: null,
-        darkMode: null,
-        privateMode: null,
-        referrer: null,
-        properties: null
-      }
-    });
-  });
-  const g = async (i, e) => {
-    if (typeof window > "u")
-      return;
-    const { page_id: r } = h(), { allTabs: u } = f(), a = L(), o = u.length, k = {
-      event: i,
-      version: e?.version || 1,
-      properties: {
-        ...e,
-        version: void 0,
-        resource: void 0,
-        identifier: void 0,
-        hostname: void 0,
-        pathname: void 0,
-        url: void 0,
-        page_title: void 0,
-        created_at: void 0
-      },
-      hostname: window.location.hostname,
-      pathname: window.location.pathname,
-      url: e?.url ?? window.location.href,
-      page_title: e?.page_title ?? document.title,
-      resource: e?.resource ?? "page",
-      identifier: e?.id ?? r ?? void 0,
-      created_at: e?.created_at ?? (/* @__PURE__ */ new Date()).toISOString(),
-      tab_id: a ?? "",
-      tab_count: o
-    };
-    T(k);
-  }, w = (i) => {
-    !t || !n || t.identify("", { withLock: !0 });
-  }, y = (i) => {
-    const { page_id: e } = h();
-    e !== i && _("page_id", i);
-  };
-  return {
-    init: (i = {}) => {
-      if (typeof window > "u")
-        throw new Error("[@levo-so/insights] init() should only be called on the client side.");
-      const { pageId: e } = i;
-      if (e && y(e), !n && !(c.NODE_ENV === "development" && !p)) {
-        if (!l) {
-          console.error(
-            "[@levo-so/insights] The utility could not be initialized due to missing insights endpoint."
-          );
-          return;
-        }
-        n = !0, B(() => {
-          if (!n) return;
-          const { insightsBaseUrl: r } = f();
-          r || N(m).then(({ mode: a, url: o }) => {
-            n && o && s({ mode: a, insightsBaseUrl: o });
-          }).catch(() => {
-            l && s({ mode: "proxy", insightsBaseUrl: l });
-          });
-          const u = U.subscribe((a) => {
-            if (!(!a || !n) && !t) {
-              const o = V(c, g, () => t === o);
-              t = o, f().insightsBaseUrl && t && (d.push(
-                I(),
-                z(t),
-                M(t),
-                P(t),
-                x(t),
-                Q(),
-                q(t),
-                A(t),
-                D(t),
-                F(t)
-              ), w(), t.page({ resource: "page" }));
-            }
-          });
-          d.push(u);
-        });
-      }
-    },
-    destroy: () => {
-      n && (C(E()), S(), d.forEach((i) => {
-        i();
-      }), d.length = 0, t = null, n = !1);
-    },
-    track: g,
-    get instance() {
-      return t;
-    }
-  };
-};
-export {
-  de as createLevoInsights
-};

package/dist/stores/config.js

@@ -1,13 +0,0 @@
-import { map as n } from "nanostores";
-const t = n({
-  workspace: null,
-  page_id: null,
-  site_id: null,
-  debug: !1
-}), s = () => t.get(), i = (e) => t.set({ ...s(), ...e }), l = (e, o) => t.setKey(e, o);
-export {
-  t as $config,
-  s as getConfig,
-  i as setConfig,
-  l as updateConfigKey
-};

package/dist/stores/events.js

@@ -1,90 +0,0 @@
-import { atom as l, computed as $ } from "nanostores";
-import { getAuthHeaders as k } from "../utils/getAuthHeaders.js";
-import { getConfig as h } from "./config.js";
-import { getSession as v, $session as y } from "./session.js";
-const A = 10, B = 2e3, p = 500, o = l([]), c = l(0), N = $(o, (e) => e.length ?? 0), i = l(null), O = () => {
-  let e = !1;
-  return y.subscribe((t) => {
-    if (t.isIdentified && !e) {
-      e = !0;
-      const s = o.get();
-      s.length > 0 && f(s);
-    }
-  });
-}, _ = () => o.get(), P = () => N.get(), f = (e) => {
-  const { workspace: t, debug: s, site_id: r, page_id: a } = h(), { isIdentified: T, mode: u, sessionId: b, deviceId: w, sessionToken: C, deviceToken: I, insightsBaseUrl: g } = v();
-  if (e.length === 0 || !T || !g || !t)
-    return;
-  const d = e.map(
-    (n) => ({
-      // Default values from stores
-      workspace_id: t,
-      site_id: r ?? void 0,
-      session_id: b ?? void 0,
-      device_id: w ?? void 0,
-      identifier: a ?? void 0,
-      hostname: window.location.hostname,
-      pathname: window.location.pathname,
-      page_title: document.title,
-      url: window.location.href,
-      tab_id: "",
-      tab_count: 0,
-      // Event values override defaults (includes tab_id, tab_count captured at track time)
-      ...n,
-      // Ensure required fields have values
-      event: n.event,
-      created_at: n.created_at,
-      resource: n.resource ?? "page",
-      properties: n.properties ?? {}
-    })
-  );
-  if (o.set([]), s) {
-    console.log("[@levo-so/insights] Debug mode enabled. Events batch:", d);
-    return;
-  }
-  const m = `${g}/v1/insights/event/bulk?workspace=${t}`, S = {
-    "Content-Type": "application/json",
-    ...k({ deviceToken: I, sessionToken: C, mode: u })
-  };
-  u === "proxy" && navigator.sendBeacon && navigator.sendBeacon(m, JSON.stringify(d)) || fetch(m, {
-    method: "POST",
-    body: JSON.stringify(d),
-    headers: S,
-    keepalive: !0,
-    credentials: u === "proxy" ? "include" : "omit"
-  }).catch(() => {
-  });
-}, Q = () => {
-  if (i.get()) return;
-  const e = setTimeout(() => {
-    f(_()), i.set(null);
-  }, B);
-  i.set(e);
-}, E = () => {
-  const e = i.get();
-  e && (clearTimeout(e), i.set(null));
-}, R = (e) => {
-  const { debug: t } = h(), s = c.get();
-  if (s >= p) {
-    t && console.warn(`[@levo-so/core] Event limit (${p}) reached for this page`);
-    return;
-  }
-  c.set(s + 1);
-  const r = o.get();
-  o.set([...r, e]);
-  const { isIdentified: a } = v();
-  P() >= A ? (E(), f(_())) : a && Q();
-}, q = () => c.set(0), J = () => {
-  o.set([]), c.set(0), E();
-};
-export {
-  o as $eventQueue,
-  c as $lifetimePageCount,
-  N as $totalEventCount,
-  J as clearEventQueue,
-  f as flushEventQueue,
-  _ as getEventQueue,
-  O as initSessionFlushListener,
-  R as queueEvent,
-  q as resetRateLimit
-};

package/dist/stores/session.js

@@ -1,66 +0,0 @@
-import { computed as u, atom as g } from "nanostores";
-import { STORAGE_KEYS as i } from "../constants/storageKeys.js";
-import { checkLocalStorageAvailable as y } from "../utils/checkLocalStorage.js";
-const c = {
-  isIdentified: !1,
-  isIdentifying: !1,
-  sessionId: null,
-  deviceId: null,
-  deviceToken: null,
-  sessionToken: null,
-  allTabs: [],
-  mode: "proxy",
-  insightsBaseUrl: null,
-  identity: null
-}, S = JSON.stringify, f = (e) => {
-  if (!e) return c;
-  try {
-    return JSON.parse(e);
-  } catch {
-    return c;
-  }
-}, t = g(c), n = t.set;
-let l = !1;
-const d = [], a = () => {
-  l || (l = !0, d.forEach((e) => {
-    e();
-  }), d.length = 0);
-}, I = (e) => {
-  l ? e() : d.push(e);
-};
-if (y()) {
-  const e = localStorage.getItem(i.session);
-  e && n(f(e)), a(), t.set = (s) => {
-    n(s);
-    try {
-      localStorage.setItem(i.session, S(s));
-    } catch {
-    }
-  }, window.addEventListener("storage", (s) => {
-    s.key === i.session && n(f(s.newValue));
-  });
-} else if (typeof BroadcastChannel < "u") {
-  const e = new BroadcastChannel(i.session);
-  e.onmessage = (s) => {
-    const { type: r, value: o } = s.data;
-    r === "UPDATE" && o ? n(o) : r === "QUERY" ? l && e.postMessage({ type: "RESPONSE", value: t.get() }) : r === "RESPONSE" && o && (n(o), a());
-  }, t.set = (s) => {
-    n(s), e.postMessage({ type: "UPDATE", value: s });
-  }, e.postMessage({ type: "QUERY" }), setTimeout(() => {
-    a();
-  }, 150);
-} else
-  a();
-const p = () => t.get(), R = (e) => {
-  t.set({ ...p(), ...e });
-}, T = u(
-  t,
-  (e) => e.insightsBaseUrl !== null && e.identity !== null
-);
-export {
-  T as $isContextReady,
-  t as $session,
-  p as getSession,
-  I as onSessionReady,
-  R as updateSession
-};

package/dist/tracking/activity.js

@@ -1,33 +0,0 @@
-import { onUserActivity as o } from "@analytics/activity-utils";
-import { map as n } from "nanostores";
-const s = n({
-  status: "active",
-  seconds: 0
-}), T = (e) => {
-  if (typeof window > "u") return () => {
-  };
-  const i = o({
-    timeout: 6e4,
-    throttle: 1e3,
-    onIdle: (t) => {
-      s.set({ status: "idle", seconds: t });
-    },
-    onWakeUp: (t) => {
-      s.set({ status: "active", seconds: t });
-    }
-  }), c = s.listen((t) => {
-    t.seconds > 0 && (t.status === "idle" ? e.track("user.idle", {
-      seconds_active: t.seconds
-    }) : e.track("user.active", {
-      seconds_idle: t.seconds
-    }));
-  });
-  return () => {
-    c(), i.disable(), s.set({ status: "active", seconds: 0 });
-  };
-}, v = () => s.get();
-export {
-  s as $activity,
-  v as getActivityStatus,
-  T as initActivityTracker
-};

package/dist/tracking/bounce.js

@@ -1,90 +0,0 @@
-import { getLevoError as u } from "@levo-so/core";
-import { atom as y } from "nanostores";
-import { $config as l } from "../stores/config.js";
-import { flushEventQueue as g, getEventQueue as p } from "../stores/events.js";
-import { getActivityStatus as w } from "./activity.js";
-const n = y(
-  "active"
-  /* ACTIVE */
-), b = () => typeof document > "u" ? "active" : document.visibilityState === "hidden" ? "hidden" : document.hasFocus() ? "active" : "passive", S = (v) => {
-  if (typeof window > "u") return () => {
-  };
-  let o = !1;
-  const r = (e) => {
-    if (o) return;
-    o = !0;
-    const i = w(), t = {};
-    i.seconds > 0 && (i.status === "idle" ? t.seconds_idle = i.seconds : t.seconds_active = i.seconds);
-    try {
-      v.track("page.bounce", {
-        resource: "page",
-        ...t,
-        ...e
-      }), g(p());
-    } catch (f) {
-      console.error("[insights] Failed to send bounce event", u(f));
-    }
-  }, a = () => {
-    const e = performance.getEntriesByType("navigation")?.[0];
-    let i = e?.type === "navigate";
-    if (!i)
-      try {
-        const t = document.activeElement;
-        t?.tagName === "A" && t.href && new URL(t.href).origin !== window.location.origin && (i = !0);
-      } catch (t) {
-        console.warn("[insights] Failed to parse link destination", u(t));
-      }
-    r({
-      is_navigating_away: i,
-      navigation_type: e?.type,
-      trigger: "beforeunload"
-    });
-  }, s = (e) => {
-    switch (e.type) {
-      case "pageshow":
-      case "resume":
-      case "blur":
-      case "focus":
-      case "visibilitychange":
-        n.set(b());
-        break;
-      case "freeze":
-        n.set(
-          "frozen"
-          /* FROZEN */
-        );
-        break;
-      case "pagehide":
-        n.set(
-          e.persisted ? "frozen" : "terminated"
-          /* TERMINATED */
-        );
-        break;
-    }
-  }, c = ["pageshow", "pagehide", "focus", "blur", "visibilitychange", "resume", "freeze"];
-  c.forEach((e) => {
-    window.addEventListener(e, s, { capture: !0 });
-  }), window.addEventListener("beforeunload", a);
-  const m = n.listen((e) => {
-    e === "frozen" || e === "terminated" ? r({
-      state: e,
-      trigger: "lifecycle"
-    }) : e === "hidden" && g(p());
-  });
-  let d = l.get().page_id;
-  const h = l.listen((e) => {
-    e.page_id !== d && (o = !1, d = e.page_id);
-  });
-  return () => {
-    c.forEach((e) => {
-      window.removeEventListener(e, s, { capture: !0 });
-    }), window.removeEventListener("beforeunload", a), m(), h(), o = !1, n.set(
-      "active"
-      /* ACTIVE */
-    );
-  };
-};
-export {
-  n as $pageLifecycle,
-  S as initBounceTracker
-};

package/dist/tracking/clicks.js

@@ -1,122 +0,0 @@
-import { getLevoError as s } from "@levo-so/core";
-import { getAttributes as g } from "../utils/autocapture.js";
-import { isRageClick as y } from "../utils/rageclick.js";
-const w = (c) => {
-  let i = c, e = 0;
-  for (; i && e < 10; ) {
-    const o = i.getAttribute?.("href");
-    if (o)
-      return o;
-    i = i.parentElement, e++;
-  }
-  return null;
-}, u = (c) => {
-  const i = c.closest("a[href]"), e = i?.getAttribute("href") || w(c);
-  if (!e) return { type: null, href: null };
-  if (i?.hasAttribute("download"))
-    return { type: "download", href: e };
-  if (e.startsWith("tel:")) return { type: "tel", href: e };
-  if (e.startsWith("mailto:")) return { type: "mailto", href: e };
-  if (e.startsWith("#")) return { type: "anchor", href: e };
-  try {
-    return {
-      type: new URL(e, window.location.origin).origin === window.location.origin ? "internal" : "external",
-      href: e
-    };
-  } catch (o) {
-    return console.warn("[insights] Failed to classify link", s(o)), { type: "internal", href: e };
-  }
-}, _ = (c) => {
-  if (typeof window > "u") return () => {
-  };
-  let i = 0, e = null;
-  const o = (t, r = !1) => {
-    const n = t.target, l = "clientX" in t ? t.clientX : t.changedTouches?.[0]?.clientX ?? 0, m = "clientY" in t ? t.clientY : t.changedTouches?.[0]?.clientY ?? 0;
-    let a = {
-      hostname: window.location.hostname,
-      pathname: window.location.pathname,
-      page_title: document.title,
-      url: window.location.href,
-      created_at: (/* @__PURE__ */ new Date()).toISOString(),
-      event_type: r ? "dblclick" : "click",
-      button_type: "button" in t ? t.button : 0
-    };
-    return n instanceof HTMLElement && (a.rage_click = y(l, m, Date.now()), a = {
-      ...a,
-      ...g(n)
-    }), a;
-  }, k = (t, r) => {
-    try {
-      if (Date.now() - i < 300) return;
-      const n = o(t);
-      c.track("page.click", {
-        ...n,
-        href: r.href || void 0,
-        link_type: r.type,
-        is_navigation: !0
-      });
-    } catch (n) {
-      console.error("[insights] Failed to track navigation click", s(n));
-    }
-  }, d = (t, r = !1) => {
-    try {
-      if (!(t.target instanceof HTMLElement) || Date.now() - i < 300) return;
-      const n = o(t, r), l = u(t.target);
-      c.track("page.click", {
-        ...n,
-        href: l.href || void 0,
-        link_type: l.type || void 0
-      });
-    } catch (n) {
-      console.error("[insights] Failed to track click", s(n));
-    }
-  }, f = (t) => {
-    if (!(t.target instanceof HTMLElement)) return;
-    const r = u(t.target);
-    if (r.type === "external" || r.type === "download") {
-      k(t, r);
-      return;
-    }
-    if (e) {
-      clearTimeout(e), e = null;
-      return;
-    }
-    e = setTimeout(() => {
-      d(t, !1), e = null;
-    }, 250);
-  }, h = (t) => {
-    e && (clearTimeout(e), e = null), d(t, !0);
-  }, p = (t) => {
-    try {
-      if (!(t.target instanceof HTMLElement)) return;
-      i = Date.now();
-      const r = u(t.target);
-      if (r.type === "external" || r.type === "download") {
-        const l = o(t);
-        c.track("page.click", {
-          ...l,
-          href: r.href || void 0,
-          link_type: r.type,
-          is_navigation: !0,
-          is_touch: !0
-        });
-        return;
-      }
-      const n = o(t);
-      c.track("page.click", {
-        ...n,
-        href: r.href || void 0,
-        link_type: r.type || void 0,
-        is_touch: !0
-      });
-    } catch (r) {
-      console.error("[insights] Failed to track touch", s(r));
-    }
-  };
-  return document.addEventListener("click", f), document.addEventListener("dblclick", h), document.addEventListener("touchend", p, { passive: !0 }), () => {
-    document.removeEventListener("click", f), document.removeEventListener("dblclick", h), document.removeEventListener("touchend", p), e && clearTimeout(e);
-  };
-};
-export {
-  _ as initClicksTracker
-};