@dotcms/analytics 1.2.3 → 1.2.4-next.2

package/lib/core/dot-analytics.content.js

@@ -1,22 +1,26 @@
 import { Analytics as l } from "analytics";
-import { dotAnalyticsClickPlugin as d } from "./plugin/click/dot-analytics.click.plugin.js";
-import { dotAnalyticsEnricherPlugin as y } from "./plugin/enricher/dot-analytics.enricher.plugin.js";
+import { getUVEState as d } from "../../uve/src/lib/core/core.utils.js";
+import "../../uve/src/internal/constants.js";
+import { dotAnalyticsClickPlugin as y } from "./plugin/click/dot-analytics.click.plugin.js";
+import { dotAnalyticsEnricherPlugin as m } from "./plugin/enricher/dot-analytics.enricher.plugin.js";
 import { dotAnalyticsIdentityPlugin as u } from "./plugin/identity/dot-analytics.identity.plugin.js";
-import { dotAnalyticsImpressionPlugin as m } from "./plugin/impression/dot-analytics.impression.plugin.js";
-import { dotAnalytics as A } from "./plugin/main/dot-analytics.plugin.js";
-import { ANALYTICS_WINDOWS_ACTIVE_KEY as a, ANALYTICS_WINDOWS_CLEANUP_KEY as p, DotCMSPredefinedEventType as f } from "./shared/constants/dot-analytics.constants.js";
-import { validateAnalyticsConfig as C, getEnhancedTrackingPlugins as w } from "./shared/utils/dot-analytics.utils.js";
-import { cleanupActivityTracking as g } from "./plugin/identity/dot-analytics.identity.activity-tracker.js";
-const T = (t) => {
-  const e = C(t);
-  if (e)
+import { dotAnalyticsImpressionPlugin as A } from "./plugin/impression/dot-analytics.impression.plugin.js";
+import { dotAnalytics as p } from "./plugin/main/dot-analytics.plugin.js";
+import { ANALYTICS_WINDOWS_ACTIVE_KEY as e, ANALYTICS_WINDOWS_CLEANUP_KEY as f, DotCMSPredefinedEventType as w } from "./shared/constants/dot-analytics.constants.js";
+import { validateAnalyticsConfig as C, isBrowser as g, getEnhancedTrackingPlugins as E } from "./shared/utils/dot-analytics.utils.js";
+import { cleanupActivityTracking as S } from "./plugin/identity/dot-analytics.identity.activity-tracker.js";
+const O = (t) => {
+  const r = C(t);
+  if (r)
     return console.error(
-      `DotCMS Analytics [Core]: Missing ${e.join(" and ")} in configuration`
-    ), typeof window < "u" && (window[a] = !1), null;
-  const s = w(
+      `DotCMS Analytics [Core]: Missing ${r.join(" and ")} in configuration`
+    ), typeof window < "u" && (window[e] = !1), null;
+  if (g() && d())
+    return console.warn("DotCMS Analytics [Core]: Analytics disabled inside UVE editor"), window[e] = !1, null;
+  const s = E(
     t,
-    m,
-    d
+    A,
+    y
   ), i = l({
     app: "dotAnalytics",
     debug: t.debug,
@@ -25,13 +29,13 @@ const T = (t) => {
       // Inject identity context
       ...s,
       //Track content impressions & clicks (conditionally loaded)
-      y(),
+      m(),
       // Enrich and clean payload with page, device, utm data and custom data
-      A(t)
+      p(t)
       // Send events to server
     ]
-  }), r = () => g();
-  return typeof window < "u" && (window.addEventListener("beforeunload", r), window[p] = r, window[a] = !0, window.dispatchEvent(new CustomEvent("dotcms:analytics:ready"))), {
+  }), a = () => S();
+  return typeof window < "u" && (window.addEventListener("beforeunload", a), window[f] = a, window[e] = !0, window.dispatchEvent(new CustomEvent("dotcms:analytics:ready"))), {
     /**
      * Track a page view.
      * Session activity is automatically updated by the identity plugin.
@@ -74,10 +78,10 @@ const T = (t) => {
         name: n,
         ...Object.keys(o).length > 0 && { custom: o }
       };
-      i.track(f.CONVERSION, c);
+      i.track(w.CONVERSION, c);
     }
   };
 };
 export {
-  T as initializeContentAnalytics
+  O as initializeContentAnalytics
 };

package/lib/core/plugin/impression/dot-analytics.impression-tracker.js

@@ -1,11 +1,9 @@
-import { getUVEState as m } from "../../../../uve/src/lib/core/core.utils.js";
-import "../../../../uve/src/internal/constants.js";
-import { getViewportMetrics as d, isElementMeetingVisibilityThreshold as u } from "./dot-analytics.impression.utils.js";
-import { DEFAULT_IMPRESSION_CONFIG as l, IMPRESSION_EVENT_TYPE as g } from "../../shared/constants/dot-analytics.constants.js";
-import { createPluginLogger as p, isBrowser as a, INITIAL_SCAN_DELAY_MS as f, findContentlets as b, extractContentletIdentifier as c, createContentletObserver as v, extractContentletData as I } from "../../shared/utils/dot-analytics.utils.js";
-class E {
+import { getViewportMetrics as m, isElementMeetingVisibilityThreshold as d } from "./dot-analytics.impression.utils.js";
+import { DEFAULT_IMPRESSION_CONFIG as l, IMPRESSION_EVENT_TYPE as u } from "../../shared/constants/dot-analytics.constants.js";
+import { createPluginLogger as g, isBrowser as a, INITIAL_SCAN_DELAY_MS as p, findContentlets as b, extractContentletIdentifier as c, createContentletObserver as f, extractContentletData as v } from "../../shared/utils/dot-analytics.utils.js";
+class T {
   constructor(e) {
-    this.observer = null, this.mutationObserver = null, this.elementImpressionStates = /* @__PURE__ */ new Map(), this.sessionTrackedImpressions = /* @__PURE__ */ new Set(), this.currentPagePath = "", this.subscribers = /* @__PURE__ */ new Set(), this.logger = p("Impression", e), this.impressionConfig = this.resolveImpressionConfig(e.impressions);
+    this.observer = null, this.mutationObserver = null, this.elementImpressionStates = /* @__PURE__ */ new Map(), this.sessionTrackedImpressions = /* @__PURE__ */ new Set(), this.currentPagePath = "", this.subscribers = /* @__PURE__ */ new Set(), this.logger = g("Impression", e), this.impressionConfig = this.resolveImpressionConfig(e.impressions);
   }
   /**
    * Subscribe to impression events
@@ -38,15 +36,9 @@ class E {
   }
   /** Initializes tracking: sets up observers, finds contentlets, handles visibility/navigation */
   initialize() {
-    if (a()) {
-      if (m()) {
-        this.logger.warn("Impression tracking disabled in editor mode");
-        return;
-      }
-      this.initializeIntersectionObserver(), typeof window < "u" && setTimeout(() => {
-        this.logger.debug("Running initial scan after timeout..."), this.findAndObserveContentletElements();
-      }, f), this.initializeDynamicContentDetector(), this.initializePageVisibilityHandler(), this.initializePageNavigationHandler(), this.logger.info("Impression tracking initialized with config:", this.impressionConfig);
-    }
+    a() && (this.initializeIntersectionObserver(), typeof window < "u" && setTimeout(() => {
+      this.logger.debug("Running initial scan after timeout..."), this.findAndObserveContentletElements();
+    }, p), this.initializeDynamicContentDetector(), this.initializePageVisibilityHandler(), this.initializePageNavigationHandler(), this.logger.info("Impression tracking initialized with config:", this.impressionConfig));
   }
   /** Sets up IntersectionObserver with configured visibility threshold */
   initializeIntersectionObserver() {
@@ -92,7 +84,7 @@ class E {
   }
   /** Watches for new contentlets added to DOM (debounced for performance) */
   initializeDynamicContentDetector() {
-    a() && (this.mutationObserver = v(() => {
+    a() && (this.mutationObserver = f(() => {
       this.findAndObserveContentletElements();
     }), this.logger.info("MutationObserver enabled for dynamic content detection"));
   }
@@ -150,7 +142,7 @@ class E {
   trackAndSendImpression(e, i) {
     const t = this.elementImpressionStates.get(e);
     if (!t) return;
-    const s = t.visibleSince ? Date.now() - t.visibleSince : 0, n = I(i), r = d(i), o = parseInt(i.dataset.dotDomIndex || "-1", 10), h = {
+    const s = t.visibleSince ? Date.now() - t.visibleSince : 0, n = v(i), r = m(i), o = parseInt(i.dataset.dotDomIndex || "-1", 10), h = {
       content: {
         identifier: n.identifier,
         inode: n.inode,
@@ -162,7 +154,7 @@ class E {
         dom_index: o
       }
     };
-    this.notifySubscribers(g, h), this.markImpressionAsTracked(e), t.timer = null, t.visibleSince = null, t.tracked = !0, this.observer && this.observer.unobserve(i), this.logger.info(
+    this.notifySubscribers(u, h), this.markImpressionAsTracked(e), t.timer = null, t.visibleSince = null, t.tracked = !0, this.observer && this.observer.unobserve(i), this.logger.info(
       `Fired impression for ${e} (dwell: ${s}ms) - element unobserved`,
       n
     );
@@ -177,7 +169,7 @@ class E {
   }
   /** Post-dwell check: verifies element still meets visibility threshold */
   isElementStillVisible(e) {
-    return document.visibilityState !== "visible" ? !1 : u(
+    return document.visibilityState !== "visible" ? !1 : d(
       e,
       this.impressionConfig.visibilityThreshold
     );
@@ -198,5 +190,5 @@ class E {
   }
 }
 export {
-  E as DotCMSImpressionTracker
+  T as DotCMSImpressionTracker
 };

package/lib/core/shared/constants/dot-analytics.constants.d.ts

@@ -156,3 +156,22 @@ export declare const ANALYTICS_WINDOWS_CLEANUP_KEY = "__dotAnalyticsCleanup__";
  * @see core-web/libs/sdk/react/src/lib/next/components/Contentlet/Contentlet.tsx
  */
 export declare const CONTENTLET_CLASS = "dotcms-contentlet";
+/**
+ * Queue persistence configuration constants
+ * Used for storing events in sessionStorage for traditional page navigations
+ */
+/**
+ * Session storage key for persistent tab ID
+ * This ID remains constant across page navigations within the same browser tab
+ */
+export declare const TAB_ID_STORAGE_KEY = "dot_analytics_tab_id";
+/**
+ * Prefix for queue storage key in sessionStorage
+ * Full key format: dot_analytics_queue_{tabId}
+ */
+export declare const QUEUE_STORAGE_KEY_PREFIX = "dot_analytics_queue";
+/**
+ * Maximum age in milliseconds for persisted events
+ * Events older than this will be discarded (24 hours)
+ */
+export declare const MAX_EVENT_AGE_MS: number;

package/lib/core/shared/constants/dot-analytics.constants.js

@@ -1,20 +1,20 @@
-const I = "/api/v1/analytics/content/event", c = {
+const c = "/api/v1/analytics/content/event", o = {
   PAGEVIEW: "pageview",
   CONTENT_IMPRESSION: "content_impression",
   CONTENT_CLICK: "content_click",
   CONVERSION: "conversion"
-}, o = [
+}, s = [
   "utm_source",
   "utm_medium",
   "utm_campaign",
   "utm_term",
   "utm_content"
-], s = 30, e = "dot_analytics_session_id", N = "dot_analytics_user_id", _ = 15, E = 5e3, A = ["click"], L = {
+], I = 30, e = "dot_analytics_session_id", N = "dot_analytics_user_id", _ = 15, E = 5e3, A = ["click"], O = {
   eventBatchSize: _,
   // Max events per batch - auto-sends when reached
   flushInterval: E
   // Time between flushes - sends whatever is queued
-}, O = [
+}, L = [
   "title",
   "url",
   "path",
@@ -28,28 +28,31 @@ const I = "/api/v1/analytics/content/event", c = {
   dwellMs: n,
   maxNodes: T,
   throttleMs: S
-}, U = "content_impression", D = "content_click", M = 300, a = "a, button", R = "__dotAnalyticsActive__", l = "__dotAnalyticsCleanup__", r = "dotcms-contentlet";
+}, U = "content_impression", a = "content_click", D = 300, M = "a, button", R = "__dotAnalyticsActive__", l = "__dotAnalyticsCleanup__", F = "dotcms-contentlet", P = "dot_analytics_tab_id", d = "dot_analytics_queue", r = 1440 * 60 * 1e3;
 export {
   A as ACTIVITY_EVENTS,
-  I as ANALYTICS_ENDPOINT,
-  O as ANALYTICS_JS_DEFAULT_PROPERTIES,
+  c as ANALYTICS_ENDPOINT,
+  L as ANALYTICS_JS_DEFAULT_PROPERTIES,
   R as ANALYTICS_WINDOWS_ACTIVE_KEY,
   l as ANALYTICS_WINDOWS_CLEANUP_KEY,
-  a as CLICKABLE_ELEMENTS_SELECTOR,
-  D as CLICK_EVENT_TYPE,
-  r as CONTENTLET_CLASS,
-  M as DEFAULT_CLICK_THROTTLE_MS,
+  M as CLICKABLE_ELEMENTS_SELECTOR,
+  a as CLICK_EVENT_TYPE,
+  F as CONTENTLET_CLASS,
+  D as DEFAULT_CLICK_THROTTLE_MS,
   C as DEFAULT_IMPRESSION_CONFIG,
   n as DEFAULT_IMPRESSION_DWELL_MS,
   T as DEFAULT_IMPRESSION_MAX_NODES,
   i as DEFAULT_IMPRESSION_MUTATION_OBSERVER_DEBOUNCE_MS,
   S as DEFAULT_IMPRESSION_THROTTLE_MS,
   t as DEFAULT_IMPRESSION_VISIBILITY_THRESHOLD,
-  L as DEFAULT_QUEUE_CONFIG,
-  s as DEFAULT_SESSION_TIMEOUT_MINUTES,
-  c as DotCMSPredefinedEventType,
-  o as EXPECTED_UTM_KEYS,
+  O as DEFAULT_QUEUE_CONFIG,
+  I as DEFAULT_SESSION_TIMEOUT_MINUTES,
+  o as DotCMSPredefinedEventType,
+  s as EXPECTED_UTM_KEYS,
   U as IMPRESSION_EVENT_TYPE,
+  r as MAX_EVENT_AGE_MS,
+  d as QUEUE_STORAGE_KEY_PREFIX,
   e as SESSION_STORAGE_KEY,
+  P as TAB_ID_STORAGE_KEY,
   N as USER_ID_KEY
 };

package/lib/core/shared/http/dot-analytics.http.d.ts

@@ -6,4 +6,4 @@ import { DotCMSAnalyticsConfig, DotCMSAnalyticsRequestBody } from '../models';
  * @param keepalive - Use keepalive mode for page unload scenarios (default: false)
  * @returns A promise that resolves when the request is complete
  */
-export declare const sendAnalyticsEvent: (payload: DotCMSAnalyticsRequestBody, config: DotCMSAnalyticsConfig, keepalive?: boolean) => Promise<void>;
+export declare const sendAnalyticsEvent: (payload: DotCMSAnalyticsRequestBody, config: DotCMSAnalyticsConfig, keepalive?: boolean) => Promise<boolean>;

package/lib/core/shared/http/dot-analytics.http.js

@@ -1,34 +1,36 @@
-import { ANALYTICS_ENDPOINT as f } from "../constants/dot-analytics.constants.js";
-import { createPluginLogger as T } from "../utils/dot-analytics.utils.js";
-const h = async (n, a, i = !1) => {
-  const r = T("HTTP", a), c = `${a.server}${f}`, g = JSON.stringify(n);
-  r.info(`Sending ${n.events.length} event(s)${i ? " (keepalive)" : ""}`, {
+import { ANALYTICS_ENDPOINT as p } from "../constants/dot-analytics.constants.js";
+import { createPluginLogger as l } from "../utils/dot-analytics.utils.js";
+const m = async (n, i, c = !1) => {
+  const e = l("HTTP", i), f = `${i.server}${p}`, g = JSON.stringify(n);
+  e.info(`Sending ${n.events.length} event(s)${c ? " (keepalive)" : ""}`, {
     payload: n
   });
   try {
-    const e = {
+    const r = {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: g
     };
-    if (i) {
-      e.keepalive = !0, e.credentials = "omit", fetch(c, e);
-      return;
-    }
-    const t = await fetch(c, e);
+    if (c)
+      return r.keepalive = !0, r.credentials = "omit", fetch(f, r).catch((o) => {
+        e.error("Keepalive request failed (browser may have ignored it):", o);
+      }), !0;
+    const t = await fetch(f, r);
     if (!t.ok) {
-      const p = t.statusText || "Unknown Error", o = `HTTP ${t.status}: ${p}`;
+      const o = t.statusText || "Unknown Error", a = `HTTP ${t.status}: ${o}`;
       try {
         const s = await t.json();
-        s.message ? r.warn(`${s.message} (${o})`) : r.warn(`${o} - No error message in response`);
+        s.message ? e.warn(`${s.message} (${a})`) : e.warn(`${a} - No error message in response`);
       } catch (s) {
-        r.warn(`${o} - Failed to parse error response:`, s);
+        e.warn(`${a} - Failed to parse error response:`, s);
       }
+      return !1;
     }
-  } catch (e) {
-    r.error("Error sending event:", e);
+    return !0;
+  } catch (r) {
+    return e.error("Error sending event:", r), !1;
   }
 };
 export {
-  h as sendAnalyticsEvent
+  m as sendAnalyticsEvent
 };

package/lib/core/shared/models/event.model.d.ts

@@ -167,3 +167,15 @@ export type DotCMSCustomEvent = DotCMSEventBase<DotCMSCustomEventType, DotCMSCus
  * Used primarily for type documentation and validation.
  */
 export type DotCMSEvent = DotCMSPageViewEvent | DotCMSContentImpressionEvent | DotCMSContentClickEvent | DotCMSConversionEvent | DotCMSCustomEvent;
+/**
+ * Structure for persisted queue in sessionStorage.
+ * Used to preserve events across traditional page navigations.
+ */
+export interface PersistedQueue {
+    /** Unique identifier for this browser tab */
+    tabId: string;
+    /** Timestamp when the queue was last persisted */
+    timestamp: number;
+    /** Array of events waiting to be sent */
+    events: DotCMSEvent[];
+}

package/lib/core/shared/queue/dot-analytics.queue.utils.d.ts

@@ -23,6 +23,10 @@ export declare const createAnalyticsQueue: (config: DotCMSAnalyticsConfig) => {
     /**
      * Clean up queue resources
      * Flushes remaining events and cleans up listeners
+     *
+     * IMPORTANT: Does NOT clear sessionStorage
+     * - Storage is cleared only after sendBatch succeeds or in initialize()
+     * - This allows events to persist across traditional page navigations
      */
     cleanup: () => void;
 };

package/lib/core/shared/queue/dot-analytics.queue.utils.js

@@ -1,49 +1,125 @@
-import m from "@analytics/queue-utils";
-import v from "@analytics/router-utils";
-import { DEFAULT_QUEUE_CONFIG as y } from "../constants/dot-analytics.constants.js";
-import { sendAnalyticsEvent as b } from "../http/dot-analytics.http.js";
-import { createPluginLogger as w } from "../utils/dot-analytics.utils.js";
-const L = (u) => {
-  const i = w("Queue", u);
-  let t = null, n = null, o = !1, d = !1, f = typeof window < "u" ? window.location.pathname : "";
-  const a = {
-    ...y,
-    ...typeof u.queue == "object" ? u.queue : {}
-  }, g = (e, s) => {
-    if (!n) return;
-    i.debug(`Sending batch of ${e.length} event(s)`, {
+import q from "@analytics/queue-utils";
+import F from "@analytics/router-utils";
+import { DEFAULT_QUEUE_CONFIG as x, TAB_ID_STORAGE_KEY as I, MAX_EVENT_AGE_MS as z, QUEUE_STORAGE_KEY_PREFIX as P } from "../constants/dot-analytics.constants.js";
+import { sendAnalyticsEvent as w } from "../http/dot-analytics.http.js";
+import { createPluginLogger as T, safeSessionStorage as d, generateSecureId as U, getAnalyticsContext as D } from "../utils/dot-analytics.utils.js";
+const R = (l) => {
+  const n = T("Queue", l);
+  let i = null, c = null, f = !1, m = !1, v = typeof window < "u" ? window.location.pathname : "", o = "", a = [];
+  const y = {
+    ...x,
+    ...typeof l.queue == "object" ? l.queue : {}
+  }, g = () => `${P}_${o}`, E = (e) => {
+    const t = e;
+    if (!t || typeof t != "object" || Array.isArray(t))
+      return null;
+    if (typeof t.tabId != "string" || typeof t.timestamp != "number" || !Number.isFinite(t.timestamp) || !Array.isArray(t.events))
+      return n.warn("Invalid persisted queue: structural mismatch"), null;
+    const s = t.events.filter(
+      (r) => r && typeof r == "object" && "event_type" in r
+    );
+    return {
+      tabId: t.tabId,
+      timestamp: t.timestamp,
+      events: s
+    };
+  }, A = () => {
+    try {
+      const e = g(), t = d.getItem(e);
+      if (!t)
+        return n.debug("No persisted queue found"), null;
+      const s = JSON.parse(t), r = E(s);
+      if (!r)
+        return d.removeItem(e), null;
+      const u = Date.now() - r.timestamp;
+      return u > z ? (n.warn(
+        `Persisted events too old (${Math.round(u / 1e3 / 60 / 60)}h), discarding`
+      ), d.removeItem(e), null) : (n.info(
+        `Loaded ${r.events.length} persisted event(s) from storage (age: ${Math.round(u / 1e3)}s)`
+      ), r);
+    } catch (e) {
+      return n.error("Failed to load persisted queue", e), d.removeItem(g()), null;
+    }
+  }, h = () => {
+    if (a.length !== 0)
+      try {
+        const e = g(), t = {
+          tabId: o,
+          timestamp: Date.now(),
+          events: a
+        };
+        d.setItem(e, JSON.stringify(t)), n.debug(`Persisted ${a.length} event(s) to storage`);
+      } catch (e) {
+        e instanceof Error && e.name === "QuotaExceededError" ? n.warn("sessionStorage quota exceeded, continuing without persistence") : n.error("Failed to persist queue", e);
+      }
+  }, b = () => {
+    try {
+      const e = g();
+      d.removeItem(e), n.debug("Persisted queue cleared from storage");
+    } catch (e) {
+      n.error("Failed to clear persisted queue", e);
+    }
+  }, _ = async (e, t = !0) => {
+    if (e.length === 0)
+      return !0;
+    n.info(`Sending ${e.length} persisted event(s) immediately`);
+    const r = { context: D(l), events: e };
+    return w(r, l, t);
+  }, $ = (e, t) => {
+    if (!c) return;
+    n.debug(`Sending batch of ${e.length} event(s)`, {
       events: e,
-      keepalive: o
-    }), b({ context: n, events: e }, u, o);
-  }, l = () => {
-    !t || t.size() === 0 || !n || (i.info(`Flushing ${t.size()} events (page hidden/unload)`), o = !0, t.flush(!0));
-  }, c = () => {
-    if (i.debug("handleVisibilityChange", document.visibilityState), document.visibilityState === "hidden") {
-      if (d) {
-        i.debug("Skipping flush (SPA navigation detected)");
+      keepalive: f
+    }), w({ context: c, events: e }, l, f), a = a.filter(
+      (r) => !e.some((u) => u === r)
+    ), f || (a.length === 0 ? b() : h());
+  }, p = () => {
+    !i || i.size() === 0 || !c || (n.info(`Flushing ${i.size()} events (page hidden/unload)`), f = !0, i.flush(!0));
+  }, S = () => {
+    if (n.debug("handleVisibilityChange", document.visibilityState), document.visibilityState === "hidden") {
+      if (m) {
+        n.debug("Skipping flush (SPA navigation detected), persisting to storage"), h();
         return;
       }
-      l();
-    } else document.visibilityState === "visible" && (d = !1);
+      p();
+    } else document.visibilityState === "visible" && (m = !1);
   };
   return {
     /**
      * Initialize the queue with smart batching
      */
     initialize: () => {
-      t = m(
-        (e, s) => {
-          g(e);
+      if (typeof window < "u") {
+        const t = d.getItem(I);
+        if (t)
+          o = t, n.debug(`Reusing Tab ID: ${o}`);
+        else {
+          typeof crypto < "u" && typeof crypto.randomUUID == "function" ? o = crypto.randomUUID() : (o = U("tab"), n.debug("crypto.randomUUID not available, using fallback generator"));
+          try {
+            d.setItem(I, o);
+          } catch {
+          }
+          n.debug(`Generated new Tab ID: ${o}`);
+        }
+      }
+      const e = A();
+      e && e.events.length > 0 && _(e.events, !1).then((t) => {
+        t ? b() : n.warn(
+          "Failed to send persisted events, keeping in storage for next retry"
+        );
+      }), i = q(
+        (t, s) => {
+          $(t);
         },
         {
-          max: a.eventBatchSize,
-          interval: a.flushInterval,
+          max: y.eventBatchSize,
+          interval: y.flushInterval,
           throttle: !1
           // Always false - enables both batch size and interval triggers
         }
-      ), typeof window < "u" && typeof document < "u" && (document.addEventListener("visibilitychange", c), window.addEventListener("pagehide", l), v((e) => {
-        d = !0, f = e, i.debug(`SPA navigation detected (${f})`), setTimeout(() => {
-          d = !1;
+      ), typeof window < "u" && typeof document < "u" && (document.addEventListener("visibilitychange", S), window.addEventListener("pagehide", p), F((t) => {
+        m = !0, v = t, n.debug(`SPA navigation detected (${v})`), setTimeout(() => {
+          m = !1;
         }, 100);
       }));
     },
@@ -53,28 +129,33 @@ const L = (u) => {
      * - Sends immediately when eventBatchSize reached (with throttle: false)
      * - Sends pending events every flushInterval
      */
-    enqueue: (e, s) => {
-      if (n = s, !t) return;
-      const r = t.size() + 1, p = a.eventBatchSize, h = r >= p;
-      i.debug(
-        `Event added. Queue size: ${r}/${p}${h ? " (full, sending...)" : ""}`,
+    enqueue: (e, t) => {
+      if (c = t, !i) return;
+      a.push(e);
+      const s = i.size() + 1, r = y.eventBatchSize, u = s >= r;
+      n.debug(
+        `Event added. Queue size: ${s}/${r}${u ? " (full, sending...)" : ""}`,
         { eventType: e.event_type, event: e }
-      ), t.push(e);
+      ), i.push(e), h();
     },
     /**
      * Get queue size for debugging
      * Returns the number of events in smartQueue
      */
-    size: () => t?.size() ?? 0,
+    size: () => i?.size() ?? 0,
     /**
      * Clean up queue resources
      * Flushes remaining events and cleans up listeners
+     *
+     * IMPORTANT: Does NOT clear sessionStorage
+     * - Storage is cleared only after sendBatch succeeds or in initialize()
+     * - This allows events to persist across traditional page navigations
      */
     cleanup: () => {
-      l(), typeof window < "u" && typeof document < "u" && (document.removeEventListener("visibilitychange", c), window.removeEventListener("pagehide", l)), t = null, n = null, o = !1;
+      p(), typeof window < "u" && typeof document < "u" && (document.removeEventListener("visibilitychange", S), window.removeEventListener("pagehide", p)), i = null, c = null, f = !1, a = [];
     }
   };
 };
 export {
-  L as createAnalyticsQueue
+  R as createAnalyticsQueue
 };

package/lib/core/shared/utils/dot-analytics.utils.d.ts

@@ -50,6 +50,7 @@ export declare const generateSecureId: (prefix: string) => string;
 export declare const safeSessionStorage: {
     getItem: (key: string) => string | null;
     setItem: (key: string, value: string) => void;
+    removeItem: (key: string) => void;
 };
 /**
  * Gets or generates a user ID from localStorage.