@dotcms/analytics 1.2.0-next.9 → 1.2.1-next.1

package/lib/core/plugin/click/dot-analytics.click.plugin.d.ts

@@ -0,0 +1,36 @@
+import { AnalyticsInstance } from 'analytics';
+import { DotCMSAnalyticsConfig } from '../../shared/models';
+/**
+ * Click Plugin for DotAnalytics
+ * Handles automatic tracking of clicks on content elements.
+ *
+ * This plugin initializes the click tracker which:
+ * - Uses MutationObserver to detect contentlet containers
+ * - Attaches click listeners to each .dotcms-analytics-contentlet element
+ * - Filters for clicks on <a> or <button> elements inside tracked contentlets
+ * - Extracts contentlet data and element metadata
+ * - Throttles clicks to prevent duplicates
+ * - Fires 'content_click' events via subscription callback
+ *
+ * Note: This plugin is only registered if config.clicks is enabled.
+ * See getEnhancedTrackingPlugins() for conditional loading logic.
+ *
+ * @param {DotCMSAnalyticsConfig} config - Configuration with clicks settings
+ * @returns {Object} Plugin object with lifecycle methods
+ */
+export declare const dotAnalyticsClickPlugin: (config: DotCMSAnalyticsConfig) => {
+    name: string;
+    /**
+     * Initialize click tracking
+     * Called when Analytics.js initializes the plugin with instance context
+     * @param instance - Analytics.js instance with track method
+     */
+    initialize: ({ instance }: {
+        instance: AnalyticsInstance;
+    }) => Promise<void>;
+    /**
+     * Setup cleanup handlers when plugin is loaded
+     * Called after Analytics.js completes plugin loading
+     */
+    loaded: () => boolean;
+};

package/lib/core/plugin/click/dot-analytics.click.plugin.js

@@ -0,0 +1,27 @@
+import { DotCMSClickTracker as o } from "./dot-analytics.click-tracker.js";
+import { createPluginLogger as u, isBrowser as a, setupPluginCleanup as s } from "../../shared/utils/dot-analytics.utils.js";
+const g = (n) => {
+  let i = null, l = null;
+  const e = u("Click", n);
+  return {
+    name: "dot-analytics-click",
+    /**
+     * Initialize click tracking
+     * Called when Analytics.js initializes the plugin with instance context
+     * @param instance - Analytics.js instance with track method
+     */
+    initialize: ({ instance: r }) => (i = new o(n), l = i.onClick((c, t) => {
+      r.track(c, t);
+    }), i.initialize(), e.info("Click tracking plugin initialized"), Promise.resolve()),
+    /**
+     * Setup cleanup handlers when plugin is loaded
+     * Called after Analytics.js completes plugin loading
+     */
+    loaded: () => (a() && i && s(() => {
+      l && (l.unsubscribe(), l = null), i && (i.cleanup(), i = null, e.info("Click tracking cleaned up on page unload"));
+    }), !0)
+  };
+};
+export {
+  g as dotAnalyticsClickPlugin
+};

package/lib/core/plugin/click/dot-analytics.click.utils.d.ts

@@ -0,0 +1,12 @@
+import { DotCMSContentClickPayload } from '../../shared/models';
+import { createPluginLogger } from '../../shared/utils/dot-analytics.utils';
+/**
+ * Handles click events on elements within a contentlet.
+ * The contentlet element is already known since we attach listeners to contentlets.
+ *
+ * @param event - The mouse event
+ * @param contentletElement - The contentlet container element
+ * @param trackCallback - Callback to execute if the click is valid
+ * @param logger - Logger instance for debug messages
+ */
+export declare const handleContentletClick: (event: MouseEvent, contentletElement: HTMLElement, trackCallback: (eventName: string, payload: DotCMSContentClickPayload) => void, logger: ReturnType<typeof createPluginLogger>) => void;

package/lib/core/plugin/click/dot-analytics.click.utils.js

@@ -0,0 +1,55 @@
+import { CLICKABLE_ELEMENTS_SELECTOR as l, CLICK_EVENT_TYPE as m } from "../../shared/constants/dot-analytics.constants.js";
+import { extractContentletData as p } from "../../shared/utils/dot-analytics.utils.js";
+import { getViewportMetrics as b } from "../impression/dot-analytics.impression.utils.js";
+const _ = (r, o, c, e) => {
+  const a = r.target;
+  e.debug("Click detected on:", a);
+  const t = a.closest(l);
+  if (!t) {
+    e.debug("No <a> or <button> found in click path");
+    return;
+  }
+  if (!o.contains(t)) {
+    e.debug("Click was outside contentlet boundary");
+    return;
+  }
+  e.debug("Found clickable element:", t);
+  const n = p(o);
+  if (!n.identifier) {
+    e.debug("Contentlet has no identifier");
+    return;
+  }
+  e.debug("Contentlet data:", n);
+  const d = b(o), s = [];
+  for (const i of t.attributes)
+    !i.name.startsWith("data-dot-analytics") && i.name !== "class" && i.name !== "id" && i.name !== "href" && s.push(`${i.name}:${i.value}`);
+  const f = parseInt(o.dataset.dotAnalyticsDomIndex || "-1", 10), u = {
+    content: {
+      identifier: n.identifier,
+      inode: n.inode,
+      title: n.title,
+      content_type: n.contentType
+    },
+    position: {
+      viewport_offset_pct: d.offsetPercentage,
+      dom_index: f
+    },
+    element: {
+      text: (t.innerText || t.textContent || "").trim().substring(0, 100),
+      // Limit length
+      type: t.tagName.toLowerCase(),
+      id: t.id || "",
+      // Required by backend, empty string if not present
+      class: t.className || "",
+      // Required by backend, empty string if not present
+      href: t.getAttribute("href") || "",
+      // Path as written in HTML (relative), empty string for buttons
+      attributes: s
+      // Additional attributes (data-*, aria-*, target, etc.)
+    }
+  };
+  c(m, u);
+};
+export {
+  _ as handleContentletClick
+};

package/lib/core/plugin/enricher/dot-analytics.enricher.plugin.d.ts

@@ -21,7 +21,7 @@ export declare const dotAnalyticsEnricherPlugin: () => {
     }) => EnrichedAnalyticsPayload;
     /**
      * TRACK EVENT ENRICHMENT - Runs after identity context injection
-     * Adds page data and timestamp for predefined events.
+     * Adds page data and timestamp for predefined content events.
      * For custom events, only adds timestamp.
      *
      * @returns {EnrichedTrackPayload} Enriched payload ready for event structuring

package/lib/core/plugin/enricher/dot-analytics.enricher.plugin.js

@@ -1,5 +1,5 @@
-import { DotCMSPredefinedEventType as n } from "../../shared/constants/dot-content-analytics.constants.js";
-import { getLocalTime as i, enrichPagePayloadOptimized as o } from "../../shared/dot-content-analytics.utils.js";
+import { DotCMSPredefinedEventType as r } from "../../shared/constants/dot-analytics.constants.js";
+import { getLocalTime as i, enrichPagePayloadOptimized as o } from "../../shared/utils/dot-analytics.utils.js";
 const l = () => ({
   name: "enrich-dot-analytics",
   /**
@@ -8,34 +8,34 @@ const l = () => ({
    * @returns {EnrichedAnalyticsPayload} Enriched payload ready for event creation
    */
   "page:dot-analytics": ({
-    payload: t
+    payload: e
   }) => {
-    const e = o(t);
-    if (!e.page)
+    const t = o(e);
+    if (!t.page)
       throw new Error("DotCMS Analytics: Missing required page data");
-    return e;
+    return t;
   },
   /**
    * TRACK EVENT ENRICHMENT - Runs after identity context injection
-   * Adds page data and timestamp for predefined events.
+   * Adds page data and timestamp for predefined content events.
    * For custom events, only adds timestamp.
    *
    * @returns {EnrichedTrackPayload} Enriched payload ready for event structuring
    */
   "track:dot-analytics": ({
-    payload: t
+    payload: e
   }) => {
-    const { event: e } = t, r = i();
-    return e === n.CONTENT_IMPRESSION ? {
-      ...t,
+    const { event: t } = e, n = i();
+    return t === r.CONTENT_IMPRESSION || t === r.CONTENT_CLICK || t === r.CONVERSION ? {
+      ...e,
       page: {
         title: document.title,
         url: window.location.href
       },
-      local_time: r
+      local_time: n
     } : {
-      ...t,
-      local_time: r
+      ...e,
+      local_time: n
     };
   }
 });

package/lib/core/{shared/dot-content-analytics.activity-tracker.d.ts → plugin/identity/dot-analytics.identity.activity-tracker.d.ts}

@@ -1,5 +1,5 @@
-import { ANALYTICS_WINDOWS_ACTIVE_KEY, ANALYTICS_WINDOWS_CLEANUP_KEY } from '../../../../../uve/src/internal.ts';
-import { DotCMSAnalyticsConfig } from './models';
+import { ANALYTICS_WINDOWS_ACTIVE_KEY, ANALYTICS_WINDOWS_CLEANUP_KEY } from '../../../../../../uve/src/internal.ts';
+import { DotCMSAnalyticsConfig } from '../../shared/models';
 declare global {
     interface Window {
         [ANALYTICS_WINDOWS_CLEANUP_KEY]?: () => void;
@@ -10,13 +10,6 @@ declare global {
  * Updates session activity with throttling
  */
 export declare const updateSessionActivity: () => void;
-/**
- * Gets session information for debugging
- */
-export declare const getSessionInfo: () => {
-    lastActivity: number;
-    isActive: boolean;
-};
 /**
  * Initializes activity tracking
  */
@@ -25,11 +18,3 @@ export declare const initializeActivityTracking: (config: DotCMSAnalyticsConfig)
  * Cleans up activity tracking listeners and resets analytics state
  */
 export declare const cleanupActivityTracking: () => void;
-/**
- * Checks if user has been inactive
- */
-export declare const isUserInactive: () => boolean;
-/**
- * Gets last activity time
- */
-export declare const getLastActivity: () => number;

package/lib/core/{shared/dot-content-analytics.activity-tracker.js → plugin/identity/dot-analytics.identity.activity-tracker.js}

@@ -1,6 +1,6 @@
-import { ANALYTICS_WINDOWS_ACTIVE_KEY as o, ANALYTICS_WINDOWS_CLEANUP_KEY as r } from "../../../uve/src/internal/constants.js";
-import { DEFAULT_SESSION_TIMEOUT_MINUTES as c, ACTIVITY_EVENTS as v } from "./constants/dot-content-analytics.constants.js";
-class l {
+import { ANALYTICS_WINDOWS_ACTIVE_KEY as a, ANALYTICS_WINDOWS_CLEANUP_KEY as o } from "../../../../uve/src/internal/constants.js";
+import { DEFAULT_SESSION_TIMEOUT_MINUTES as r, ACTIVITY_EVENTS as l } from "../../shared/constants/dot-analytics.constants.js";
+class v {
   constructor() {
     this.activityListeners = [], this.lastActivityTime = Date.now(), this.inactivityTimer = null, this.isThrottled = !1, this.config = null, this.ACTIVITY_THROTTLE_MS = 1e3;
   }
@@ -12,24 +12,11 @@ class l {
     this.lastActivityTime = Date.now(), this.inactivityTimer && clearTimeout(this.inactivityTimer), this.inactivityTimer = setTimeout(
       () => {
         var i;
-        (i = this.config) != null && i.debug && console.warn("DotCMS Analytics: User became inactive after timeout"), this.inactivityTimer = null;
+        (i = this.config) != null && i.debug && console.warn("DotCMS Analytics [Activity]: User became inactive after timeout"), this.inactivityTimer = null;
       },
-      c * 60 * 1e3
+      r * 60 * 1e3
     );
   }
-  /**
-   * Checks if user has been inactive
-   */
-  isUserInactive() {
-    const i = c * 60 * 1e3;
-    return Date.now() - this.lastActivityTime > i;
-  }
-  /**
-   * Gets last activity time
-   */
-  getLastActivity() {
-    return this.lastActivityTime;
-  }
   /**
    * Updates session activity with throttling
    */
@@ -45,17 +32,19 @@ class l {
     if (this.cleanup(), this.config = i, typeof window > "u")
       return;
     const s = () => this.updateSessionActivity();
-    v.forEach((a) => {
-      window.addEventListener(a, s, { passive: !0 }), this.activityListeners.push(
-        () => window.removeEventListener(a, s)
+    l.forEach((c) => {
+      window.addEventListener(c, s, { passive: !0 }), this.activityListeners.push(
+        () => window.removeEventListener(c, s)
       );
     });
     const n = () => {
-      document.visibilityState === "visible" && (this.updateSessionActivity(), i.debug && console.warn("DotCMS Analytics: User returned to tab, session reactivated"));
+      document.visibilityState === "visible" && (this.updateSessionActivity(), i.debug && console.warn(
+        "DotCMS Analytics [Activity]: User returned to tab, session reactivated"
+      ));
     };
     document.addEventListener("visibilitychange", n), this.activityListeners.push(
       () => document.removeEventListener("visibilitychange", n)
-    ), this.updateActivityTime(), i.debug && console.warn("DotCMS Analytics: Activity tracking initialized");
+    ), this.updateActivityTime(), i.debug && console.warn("DotCMS Analytics [Activity]: Activity tracking initialized");
   }
   /**
    * Cleans up all activity tracking listeners
@@ -63,25 +52,16 @@ class l {
   cleanup() {
     this.activityListeners.forEach((i) => i()), this.activityListeners = [], this.inactivityTimer && (clearTimeout(this.inactivityTimer), this.inactivityTimer = null), this.config = null;
   }
-  /**
-   * Gets session information for debugging
-   */
-  getSessionInfo() {
-    return {
-      lastActivity: this.getLastActivity(),
-      isActive: !this.isUserInactive()
-    };
-  }
 }
-const t = new l(), u = () => {
+const t = new v(), d = () => {
   t.updateSessionActivity();
-}, d = (e) => {
+}, u = (e) => {
   t.initialize(e);
 }, y = () => {
-  t.cleanup(), typeof window < "u" && (window[o] = !1, window[r] = void 0, window.dispatchEvent(new CustomEvent("dotcms:analytics:cleanup")));
+  t.cleanup(), typeof window < "u" && (window[a] = !1, window[o] = void 0, window.dispatchEvent(new CustomEvent("dotcms:analytics:cleanup")));
 };
 export {
   y as cleanupActivityTracking,
-  d as initializeActivityTracking,
-  u as updateSessionActivity
+  u as initializeActivityTracking,
+  d as updateSessionActivity
 };

package/lib/core/plugin/identity/dot-analytics.identity.plugin.js

@@ -1,5 +1,5 @@
-import { getAnalyticsContext as n } from "../../shared/dot-content-analytics.utils.js";
-import { cleanupActivityTracking as r, updateSessionActivity as o, initializeActivityTracking as a } from "../../shared/dot-content-analytics.activity-tracker.js";
+import { cleanupActivityTracking as n, updateSessionActivity as r, initializeActivityTracking as a } from "./dot-analytics.identity.activity-tracker.js";
+import { getAnalyticsContext as o } from "../../shared/utils/dot-analytics.utils.js";
 const s = (t) => ({
   name: "dot-analytics-identity",
   /**
@@ -12,8 +12,8 @@ const s = (t) => ({
    * This runs BEFORE the enricher plugin
    */
   pageStart: ({ payload: e }) => {
-    o();
-    const i = n(t);
+    r();
+    const i = o(t);
     return {
       ...e,
       context: i
@@ -24,8 +24,8 @@ const s = (t) => ({
    * This runs BEFORE the enricher plugin
    */
   trackStart: ({ payload: e }) => {
-    o();
-    const i = n(t);
+    r();
+    const i = o(t);
     return {
       ...e,
       context: i
@@ -35,7 +35,7 @@ const s = (t) => ({
    * Clean up on plugin unload
    * Sets up cleanup handlers for activity tracking
    */
-  loaded: () => (typeof window < "u" && (window.addEventListener("beforeunload", r), window.addEventListener("pagehide", r)), !0)
+  loaded: () => (typeof window < "u" && (window.addEventListener("beforeunload", n), window.addEventListener("pagehide", n)), !0)
 });
 export {
   s as dotAnalyticsIdentityPlugin

package/lib/core/plugin/identity/dot-analytics.identity.utils.d.ts

@@ -1,20 +1,4 @@
 import { DotCMSEventUtmData } from '../../shared/models';
-/**
- * Updates activity timestamp
- */
-export declare const updateActivityTime: () => void;
-/**
- * Checks if user has been inactive
- */
-export declare const isUserInactive: () => boolean;
-/**
- * Checks if a new day has started since session creation
- */
-export declare const hasPassedMidnight: (sessionStartTime: number) => boolean;
-/**
- * Gets the last activity time
- */
-export declare const getLastActivityTime: () => number;
 /**
  * Compares UTM parameters to detect campaign changes.
  * Only checks significant parameters: source, medium, and campaign.

package/lib/core/{shared/dot-content-analytics.impression-tracker.d.ts → plugin/impression/dot-analytics.impression-tracker.d.ts}

@@ -1,4 +1,4 @@
-import { DotCMSAnalyticsConfig, DotCMSContentImpressionPayload } from './models';
+import { DotCMSAnalyticsConfig, DotCMSContentImpressionPayload } from '../../shared/models';
 /** Callback function for impression events */
 export type ImpressionCallback = (eventName: string, payload: DotCMSContentImpressionPayload) => void;
 /** Subscription object with unsubscribe method */
@@ -17,7 +17,7 @@ export declare class DotCMSImpressionTracker {
     private impressionConfig;
     private currentPagePath;
     private subscribers;
-    private debug;
+    private logger;
     constructor(config: DotCMSAnalyticsConfig);
     /**
      * Subscribe to impression events

package/lib/core/{shared/dot-content-analytics.impression-tracker.js → plugin/impression/dot-analytics.impression-tracker.js}

@@ -1,10 +1,11 @@
-import { getUVEState as d } from "../../../uve/src/lib/core/core.utils.js";
-import "../../../uve/src/internal/constants.js";
-import { DEFAULT_IMPRESSION_CONFIG as l, ANALYTICS_CONTENTLET_CLASS as a, IMPRESSION_EVENT_TYPE as h, DEFAULT_IMPRESSION_MUTATION_OBSERVER_DEBOUNCE_MS as u } from "./constants/dot-content-analytics.constants.js";
-import { extractContentletIdentifier as c, createDebounce as m, extractContentletData as p, getViewportMetrics as b, isElementMeetingVisibilityThreshold as f } from "../plugin/impression/dot-analytics.impression.utils.js";
-class I {
+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 {
   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.debug = e.debug ?? !1, 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 = p("Impression", e), this.impressionConfig = this.resolveImpressionConfig(e.impressions);
   }
   /**
    * Subscribe to impression events
@@ -24,7 +25,7 @@ class I {
       try {
         t(e, i);
       } catch (s) {
-        this.debug && console.error("DotCMS Analytics: Error in impression subscriber:", s);
+        this.logger.error("Error in impression subscriber:", s);
       }
     });
   }
@@ -37,15 +38,14 @@ class I {
   }
   /** Initializes tracking: sets up observers, finds contentlets, handles visibility/navigation */
   initialize() {
-    if (!(typeof window > "u" || typeof document > "u")) {
-      if (d()) {
-        this.debug && console.warn("DotCMS Analytics: Impression tracking disabled in editor mode");
+    if (a()) {
+      if (m()) {
+        this.logger.warn("Impression tracking disabled in editor mode");
         return;
       }
-      this.initializeIntersectionObserver(), this.findAndObserveContentletElements(), this.initializeDynamicContentDetector(), this.initializePageVisibilityHandler(), this.initializePageNavigationHandler(), this.debug && console.warn(
-        "DotCMS Analytics: Impression tracking initialized with config:",
-        this.impressionConfig
-      );
+      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);
     }
   }
   /** Sets up IntersectionObserver with configured visibility threshold */
@@ -63,11 +63,9 @@ class I {
   /** Finds contentlets in DOM, validates them, and starts observing (respects maxNodes limit) */
   findAndObserveContentletElements() {
     if (!this.observer) return;
-    const e = document.querySelectorAll(
-      `.${a}`
-    );
+    const e = b();
     if (e.length === 0) {
-      this.debug && console.warn("DotCMS Analytics: No contentlets found to track");
+      this.logger.warn("No contentlets found to track");
       return;
     }
     const i = Math.min(e.length, this.impressionConfig.maxNodes);
@@ -77,45 +75,33 @@ class I {
       if (r) {
         const o = this.shouldSkipElement(n);
         if (o) {
-          this.debug && console.warn(
-            `DotCMS Analytics: Skipping element ${r} (${o})`
-          );
+          this.logger.debug(`Skipping element ${r} (${o})`);
           continue;
         }
-        this.elementImpressionStates.has(r) || (this.observer.observe(n), this.elementImpressionStates.set(r, {
+        this.elementImpressionStates.has(r) || (n.dataset.dotAnalyticsDomIndex || (n.dataset.dotAnalyticsDomIndex = String(s)), this.observer.observe(n), this.elementImpressionStates.set(r, {
           timer: null,
           visibleSince: null,
           tracked: this.hasBeenTrackedInSession(r),
           element: n
-        }), t++, this.debug && (n.dataset.dotAnalyticsObserved = "true", n.style.outline = "2px solid red", n.style.outlineOffset = "-2px", n.style.transition = "outline-color 0.5s ease-in-out"));
+        }), t++);
       }
     }
-    this.debug && (console.warn(`DotCMS Analytics: Observing ${t} contentlets`), e.length > i && console.warn(
-      `DotCMS Analytics: ${e.length - i} contentlets not tracked (maxNodes limit: ${this.impressionConfig.maxNodes})`
-    ));
+    this.logger.info(`Observing ${t} contentlets`), e.length > i && this.logger.warn(
+      `${e.length - i} contentlets not tracked (maxNodes limit: ${this.impressionConfig.maxNodes})`
+    );
   }
   /** Watches for new contentlets added to DOM (debounced for performance) */
   initializeDynamicContentDetector() {
-    if (typeof window > "u" || typeof document > "u")
-      return;
-    const e = m(() => {
+    a() && (this.mutationObserver = v(() => {
       this.findAndObserveContentletElements();
-    }, u);
-    this.mutationObserver = new MutationObserver(() => {
-      e();
-    }), this.mutationObserver.observe(document.body, {
-      childList: !0,
-      subtree: !0
-    }), this.debug && console.warn(
-      "DotCMS Analytics: MutationObserver enabled for dynamic content detection"
-    );
+    }), this.logger.info("MutationObserver enabled for dynamic content detection"));
   }
   /** Cancels all timers when page is hidden (prevents false impressions) */
   initializePageVisibilityHandler() {
     document.addEventListener("visibilitychange", () => {
       document.visibilityState === "hidden" && (this.elementImpressionStates.forEach((e) => {
         e.timer !== null && (window.clearTimeout(e.timer), e.timer = null, e.visibleSince = null);
-      }), this.debug && console.warn("DotCMS Analytics: Page hidden, all impression timers cancelled"));
+      }), this.logger.warn("Page hidden, all impression timers cancelled"));
     });
   }
   /** Resets tracking on SPA navigation (listens to pushState, replaceState, popstate) */
@@ -123,8 +109,8 @@ class I {
     this.currentPagePath = window.location.pathname;
     const e = () => {
       const s = window.location.pathname;
-      s !== this.currentPagePath && (this.debug && console.warn(
-        `DotCMS Analytics: Navigation detected (${this.currentPagePath} → ${s}), resetting impression tracking`
+      s !== this.currentPagePath && (this.logger.warn(
+        `Navigation detected (${this.currentPagePath} → ${s}), resetting impression tracking`
       ), this.currentPagePath = s, this.sessionTrackedImpressions.clear(), this.elementImpressionStates.forEach((n) => {
         n.timer !== null && (window.clearTimeout(n.timer), n.timer = null, n.visibleSince = null);
       }), this.elementImpressionStates.clear());
@@ -135,7 +121,7 @@ class I {
       i.apply(this, s), e();
     }, history.replaceState = function(...s) {
       t.apply(this, s), e();
-    }, setInterval(e, 1e3);
+    };
   }
   /** Handles visibility changes: starts timer on enter, cancels on exit */
   processIntersectionChanges(e) {
@@ -148,23 +134,23 @@ class I {
   startImpressionDwellTimer(e, i) {
     const t = this.elementImpressionStates.get(e);
     t && (t.tracked || this.hasBeenTrackedInSession(e) || t.timer === null && document.visibilityState === "visible" && (t.visibleSince = Date.now(), t.element = i, t.timer = window.setTimeout(() => {
-      this.isElementStillVisible(i) ? this.trackAndSendImpression(e, i) : (this.debug && console.warn(
-        `DotCMS Analytics: Dwell timer expired for ${e} but element no longer visible, skipping impression`
+      this.isElementStillVisible(i) ? this.trackAndSendImpression(e, i) : (this.logger.warn(
+        `Dwell timer expired for ${e} but element no longer visible, skipping impression`
       ), t.timer = null, t.visibleSince = null);
-    }, this.impressionConfig.dwellMs), this.debug && console.warn(
-      `DotCMS Analytics: Started dwell timer for ${e} (${this.impressionConfig.dwellMs}ms)`
+    }, this.impressionConfig.dwellMs), this.logger.debug(
+      `Started dwell timer for ${e} (${this.impressionConfig.dwellMs}ms)`
     )));
   }
   /** Cancels active dwell timer (element left viewport before dwell time) */
   cancelImpressionDwellTimer(e) {
     const i = this.elementImpressionStates.get(e);
-    !i || i.timer === null || (window.clearTimeout(i.timer), i.timer = null, i.visibleSince = null, this.debug && console.warn(`DotCMS Analytics: Cancelled dwell timer for ${e}`));
+    !i || i.timer === null || (window.clearTimeout(i.timer), i.timer = null, i.visibleSince = null, this.logger.debug(`Cancelled dwell timer for ${e}`));
   }
   /** Fires impression event with content & position data (page data added by enricher plugin) */
   trackAndSendImpression(e, i) {
     const t = this.elementImpressionStates.get(e);
     if (!t) return;
-    const s = t.visibleSince ? Date.now() - t.visibleSince : 0, n = p(i), r = b(i), o = {
+    const s = t.visibleSince ? Date.now() - t.visibleSince : 0, n = I(i), r = d(i), o = parseInt(i.dataset.dotAnalyticsDomIndex || "-1", 10), h = {
       content: {
         identifier: n.identifier,
         inode: n.inode,
@@ -173,15 +159,13 @@ class I {
       },
       position: {
         viewport_offset_pct: r.offsetPercentage,
-        dom_index: Array.from(
-          document.querySelectorAll(`.${a}`)
-        ).indexOf(i)
+        dom_index: o
       }
     };
-    this.notifySubscribers(h, o), this.markImpressionAsTracked(e), t.timer = null, t.visibleSince = null, t.tracked = !0, this.observer && this.observer.unobserve(i), this.debug && (i.style.outline = "2px solid green", i.style.outlineOffset = "-2px", console.warn(
-      `DotCMS Analytics: Fired impression for ${e} (dwell: ${s}ms) - element unobserved`,
+    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(
+      `Fired impression for ${e} (dwell: ${s}ms) - element unobserved`,
       n
-    ));
+    );
   }
   /** Returns skip reason if element is hidden/too small, null if trackable */
   shouldSkipElement(e) {
@@ -193,7 +177,7 @@ class I {
   }
   /** Post-dwell check: verifies element still meets visibility threshold */
   isElementStillVisible(e) {
-    return document.visibilityState !== "visible" ? !1 : f(
+    return document.visibilityState !== "visible" ? !1 : u(
       e,
       this.impressionConfig.visibilityThreshold
     );
@@ -210,9 +194,9 @@ class I {
   cleanup() {
     this.observer && (this.observer.disconnect(), this.observer = null), this.mutationObserver && (this.mutationObserver.disconnect(), this.mutationObserver = null), this.elementImpressionStates.forEach((e) => {
       e.timer !== null && window.clearTimeout(e.timer);
-    }), this.elementImpressionStates.clear(), this.subscribers.clear(), this.debug && console.warn("DotCMS Analytics: Impression tracking cleaned up");
+    }), this.elementImpressionStates.clear(), this.subscribers.clear(), this.logger.info("Impression tracking cleaned up");
   }
 }
 export {
-  I as DotCMSImpressionTracker
+  E as DotCMSImpressionTracker
 };

package/lib/core/plugin/impression/dot-analytics.impression.plugin.d.ts

@@ -3,7 +3,6 @@ import { DotCMSAnalyticsConfig } from '../../shared/models';
 /**
  * Impression Plugin for DotAnalytics
  * Handles automatic tracking of content visibility and impressions.
- * Only activates when config.impressions is enabled (true or config object).
  *
  * This plugin initializes the impression tracker which:
  * - Uses IntersectionObserver to detect when contentlets are visible
@@ -17,13 +16,16 @@ import { DotCMSAnalyticsConfig } from '../../shared/models';
  * 3. Main Plugin - Sends to queue/server
  * 4. Impression Plugin - Runs independently, fires events via instance.track()
  *
+ * Note: This plugin is only registered if config.impressions is enabled.
+ * See getEnhancedTrackingPlugins() for conditional loading logic.
+ *
  * @param {DotCMSAnalyticsConfig} config - Configuration with impressions settings
  * @returns {Object} Plugin object with lifecycle methods
  */
 export declare const dotAnalyticsImpressionPlugin: (config: DotCMSAnalyticsConfig) => {
     name: string;
     /**
-     * Initialize impression tracking if enabled
+     * Initialize impression tracking
      * Called when Analytics.js initializes the plugin with instance context
      * @param instance - Analytics.js instance with track method
      */