@dotcms/analytics 1.2.4 → 1.2.5

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/react/hook/useContentAnalytics.d.ts

@@ -51,7 +51,6 @@ import { DotCMSAnalytics, DotCMSAnalyticsConfig } from '../../core/shared/models
  * @param config.server - The URL of your DotCMS Analytics server
  * @param config.siteKey - Your unique site key for authentication
  * @param config.debug - Optional. Set to true to see analytics events in the console
- * @returns Object with `track()` and `pageView()` methods for analytics tracking
- * @throws {Error} If the configuration is invalid (missing server or siteKey)
+ * @returns Object with `track()`, `pageView()`, and `conversion()` methods for analytics tracking
  */
 export declare const useContentAnalytics: (config: DotCMSAnalyticsConfig) => DotCMSAnalytics;

package/lib/react/hook/useContentAnalytics.js

@@ -1,35 +1,47 @@
-import { useMemo as s, useCallback as o } from "react";
+import { useMemo as c, useCallback as r } from "react";
 import { getUVEState as l } from "../../../uve/src/lib/core/core.utils.js";
 import "../../../uve/src/internal/constants.js";
-import { initializeAnalytics as m } from "../internal/utils.js";
-const h = (i) => {
-  const t = s(() => m(i), [i.server, i.siteAuth]), e = s(() => !!l(), []);
+import { initializeAnalytics as u } from "../internal/utils.js";
+const A = {
+  track: () => {
+  },
+  pageView: () => {
+  },
+  conversion: () => {
+  }
+}, v = (i) => {
+  const t = c(() => {
+    const e = u(i);
+    return e || (l() ? console.warn(
+      "DotCMS Analytics [React]: Analytics is not initialized because the site is inside the UVE editor. All tracking calls will be ignored."
+    ) : console.error(
+      "DotCMS Analytics [React]: Failed to initialize. Please verify the required configuration (server and siteAuth)."
+    )), e;
+  }, [i.server, i.siteAuth]);
   if (!t)
-    throw new Error(
-      "DotCMS Analytics: Failed to initialize. Please verify the required configuration (server and siteAuth)."
-    );
-  const a = o(
-    (r, n = {}) => {
-      e || t.track(r, n);
+    return A;
+  const o = r(
+    (e, n = {}) => {
+      t.track(e, n);
     },
-    [t, e]
-  ), c = o(
-    (r = {}) => {
-      e || t.pageView(r);
+    [t]
+  ), s = r(
+    (e = {}) => {
+      t.pageView(e);
     },
-    [t, e]
-  ), u = o(
-    (r, n = {}) => {
-      e || t.conversion(r, n);
+    [t]
+  ), a = r(
+    (e, n = {}) => {
+      t.conversion(e, n);
     },
-    [t, e]
+    [t]
   );
   return {
-    track: a,
-    pageView: c,
-    conversion: u
+    track: o,
+    pageView: s,
+    conversion: a
   };
 };
 export {
-  h as useContentAnalytics
+  v as useContentAnalytics
 };

package/lib/react/hook/useRouterTracker.d.ts

@@ -2,7 +2,7 @@ import { DotCMSAnalytics } from '../../core/shared/models';
 /**
  * Tracks page views on route changes using Next.js App Router signals.
  * - Fires a single pageView per unique path+search.
- * - Disabled inside UVE editor.
+ * - Automatically disabled inside UVE editor (analytics instance is null).
  * - Requires Next.js App Router; no SPA fallback.
  *
  * @param analytics Analytics singleton instance; if null, does nothing

package/lib/react/hook/useRouterTracker.js

@@ -1,18 +1,16 @@
-import { usePathname as s, useSearchParams as u } from "next/navigation";
-import { useRef as c, useEffect as a } from "react";
-import { getUVEState as m } from "../../../uve/src/lib/core/core.utils.js";
-import "../../../uve/src/internal/constants.js";
-const p = (t, e) => `${t}${e?.toString() ? "?" + e.toString() : ""}`;
-function l(t, e = !1) {
-  const r = c(null), o = s(), n = u();
+import { usePathname as f, useSearchParams as u } from "next/navigation";
+import { useRef as i, useEffect as a } from "react";
+const m = (e, t) => `${e}${t?.toString() ? "?" + t.toString() : ""}`;
+function R(e, t = !1) {
+  const r = i(null), n = f(), o = u();
   a(() => {
-    if (!t) return;
-    const i = (f) => {
-      m() || f !== r.current && (r.current = f, t.pageView());
+    if (!e) return;
+    const c = (s) => {
+      s !== r.current && (r.current = s, e.pageView());
     };
-    e && console.info("DotCMS Analytics [React]: using Next.js App Router tracking"), i(p(o, n));
-  }, [t, o, n, e]);
+    t && console.info("DotCMS Analytics [React]: using Next.js App Router tracking"), c(m(n, o));
+  }, [e, n, o, t]);
 }
 export {
-  l as useRouterTracker
+  R as useRouterTracker
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/analytics",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Official JavaScript library for Content Analytics with DotCMS.",
   "repository": {
     "type": "git",