@dotcms/analytics 1.5.4 → 1.5.5-next.2176

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

@@ -93,7 +93,10 @@ export interface DotCMSAnalyticsConfig {
      */
     logLevel?: LogLevel;
     /**
-     * Automatically track page views when set to true.
+     * Automatically track page views. Defaults to `true` (opt-out).
+     * Set explicitly to `false` to disable automatic page view tracking.
+     * Via the HTML `data-analytics-auto-page-view` attribute, only the literal string "false"
+     * disables it (any other value, including "", enables it).
      */
     autoPageView?: boolean;
     /**

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

@@ -92,7 +92,9 @@ export interface AnalyticsConfigResult {
  * Always returns a config (with defaults if needed).
  *
  * - If no data-analytics-server attribute is found, uses the current domain as the server endpoint
- * - Both debug and autoPageView default to false (must be explicitly set to "true")
+ * - debug defaults to false (opt-in: must be explicitly set to "true")
+ * - autoPageView defaults to true (opt-out: only the literal string "false" disables it via
+ *   `data-analytics-auto-page-view="false"`)
  *
  * @returns The analytics configuration object
  */

package/lib/react/components/DotContentAnalytics.js

@@ -1,16 +1,16 @@
-import { jsx as o } from "react/jsx-runtime";
-import { Suspense as e, useMemo as i } from "react";
+import { jsx as e } from "react/jsx-runtime";
+import { Suspense as r, useMemo as a } from "react";
 import { useRouterTracker as l } from "../hook/useRouterTracker.js";
-import { initializeAnalytics as u } from "../internal/utils.js";
-function a({
+import { initializeAnalytics as i } from "../internal/utils.js";
+function u({
   config: t
 }) {
-  const n = i(() => u(t), [t]), r = !!t.debug;
-  return n && l(n, r), null;
+  const n = a(() => i(t), [t]), o = !!t.debug;
+  return l(n, o, t.autoPageView !== !1), null;
 }
-function p({ config: t }) {
-  return /* @__PURE__ */ o(e, { fallback: null, children: /* @__PURE__ */ o(a, { config: t }) });
+function f({ config: t }) {
+  return /* @__PURE__ */ e(r, { fallback: null, children: /* @__PURE__ */ e(u, { config: t }) });
 }
 export {
-  p as DotContentAnalytics
+  f as DotContentAnalytics
 };

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

@@ -7,5 +7,6 @@ import { DotCMSAnalytics } from '../../core/shared/models';
  *
  * @param analytics Analytics singleton instance; if null, does nothing
  * @param debug When true, logs which tracking path is used
+ * @param enabled When false, tracking is disabled even if analytics is present (defaults to true)
  */
-export declare function useRouterTracker(analytics: DotCMSAnalytics | null, debug?: boolean): void;
+export declare function useRouterTracker(analytics: DotCMSAnalytics | null, debug?: boolean, enabled?: boolean): void;

package/lib/react/hook/useRouterTracker.js

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

package/package.json

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