@dotcms/analytics 1.2.0 → 1.2.1

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

@@ -1,40 +1,51 @@
-import p from "@analytics/queue-utils";
-import { DEFAULT_QUEUE_CONFIG as c } from "../constants/dot-content-analytics.constants.js";
-import { sendAnalyticsEvent as y } from "../dot-content-analytics.http.js";
-const z = (n) => {
-  let e = null, i = null, o = "fetch";
-  const l = {
-    ...c,
-    ...typeof n.queue == "object" ? n.queue : {}
-  }, f = (t) => {
-    if (!i) return;
-    n.debug && console.log(`DotCMS Analytics Queue: Sending batch of ${t.length} event(s)`, {
+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 = (o) => {
+  const i = w("Queue", o);
+  let e = null, n = null, u = !1, d = !1, f = typeof window < "u" ? window.location.pathname : "";
+  const a = {
+    ...y,
+    ...typeof o.queue == "object" ? o.queue : {}
+  }, g = (t, s) => {
+    if (!n) return;
+    i.debug(`Sending batch of ${t.length} event(s)`, {
       events: t,
-      transport: o
-    }), y({ context: i, events: t }, n, o);
-  }, u = () => {
-    !e || e.size() === 0 || !i || (n.debug && console.warn(
-      `DotCMS Analytics: Flushing ${e.size()} events (page hidden/unload)`
-    ), o = "beacon", e.flush(!0));
-  }, d = () => {
-    document.visibilityState === "hidden" && u();
+      keepalive: u
+    }), b({ context: n, events: t }, o, u);
+  }, l = () => {
+    !e || e.size() === 0 || !n || (i.info(`Flushing ${e.size()} events (page hidden/unload)`), u = !0, e.flush(!0));
+  }, c = () => {
+    if (i.debug("handleVisibilityChange", document.visibilityState), document.visibilityState === "hidden") {
+      if (d) {
+        i.debug("Skipping flush (SPA navigation detected)");
+        return;
+      }
+      l();
+    } else document.visibilityState === "visible" && (d = !1);
   };
   return {
     /**
      * Initialize the queue with smart batching
      */
     initialize: () => {
-      e = p(
-        (t) => {
-          f(t);
+      e = m(
+        (t, s) => {
+          g(t);
         },
         {
-          max: l.eventBatchSize,
-          interval: l.flushInterval,
+          max: a.eventBatchSize,
+          interval: a.flushInterval,
           throttle: !1
           // Always false - enables both batch size and interval triggers
         }
-      ), typeof window < "u" && typeof document < "u" && (document.addEventListener("visibilitychange", d), window.addEventListener("pagehide", u));
+      ), typeof window < "u" && typeof document < "u" && (document.addEventListener("visibilitychange", c), window.addEventListener("pagehide", l), v((t) => {
+        d = !0, f = t, i.debug(`SPA navigation detected (${f})`), setTimeout(() => {
+          d = !1;
+        }, 100);
+      }));
     },
     /**
      * Add event to queue
@@ -43,16 +54,12 @@ const z = (n) => {
      * - Sends pending events every flushInterval
      */
     enqueue: (t, s) => {
-      if (i = s, !!e) {
-        if (n.debug) {
-          const a = e.size() + 1, r = l.eventBatchSize ?? c.eventBatchSize, h = a >= r;
-          console.log(
-            `DotCMS Analytics Queue: Event added. Queue size: ${a}/${r}${h ? " (full, sending...)" : ""}`,
-            { eventType: t.event_type, event: t }
-          );
-        }
-        e.push(t);
-      }
+      if (n = s, !e) return;
+      const r = e.size() + 1, p = a.eventBatchSize, h = r >= p;
+      i.debug(
+        `Event added. Queue size: ${r}/${p}${h ? " (full, sending...)" : ""}`,
+        { eventType: t.event_type, event: t }
+      ), e.push(t);
     },
     /**
      * Get queue size for debugging
@@ -64,10 +71,10 @@ const z = (n) => {
      * Flushes remaining events and cleans up listeners
      */
     cleanup: () => {
-      u(), typeof window < "u" && typeof document < "u" && (document.removeEventListener("visibilitychange", d), window.removeEventListener("pagehide", u)), e = null, i = null, o = "fetch";
+      l(), typeof window < "u" && typeof document < "u" && (document.removeEventListener("visibilitychange", c), window.removeEventListener("pagehide", l)), e = null, n = null, u = !1;
     }
   };
 };
 export {
-  z as createAnalyticsQueue
+  L as createAnalyticsQueue
 };

package/lib/core/shared/{dot-content-analytics.utils.d.ts → utils/dot-analytics.utils.d.ts}

@@ -1,6 +1,27 @@
-import { PageData } from 'analytics';
-import { AnalyticsBasePayloadWithContext, DotCMSAnalyticsConfig, DotCMSAnalyticsEventContext, DotCMSBrowserData, DotCMSEventDeviceData, DotCMSEventUtmData, EnrichedAnalyticsPayload } from './models';
-export { cleanupActivityTracking, getLastActivity, getSessionInfo, initializeActivityTracking, isUserInactive, updateSessionActivity } from './dot-content-analytics.activity-tracker';
+import { AnalyticsPlugin, PageData } from 'analytics';
+import { DotCMSPredefinedEventType } from '../constants';
+import { DotLogger, LogLevel } from '../dot-analytics.logger';
+import { AnalyticsBasePayloadWithContext, ContentletData, DotCMSAnalyticsConfig, DotCMSAnalyticsEventContext, DotCMSBrowserData, DotCMSEventDeviceData, DotCMSEventUtmData, EnrichedAnalyticsPayload } from '../models';
+export { cleanupActivityTracking, initializeActivityTracking, updateSessionActivity } from '../../plugin/identity/dot-analytics.identity.activity-tracker';
+/**
+ * Type guard to check if an event is a predefined event type.
+ * Enables TypeScript type narrowing for better type safety.
+ *
+ * @param event - Event name to check
+ * @returns True if event is a predefined type, false for custom events
+ *
+ * @example
+ * ```typescript
+ * if (isPredefinedEventType(eventName)) {
+ *   // TypeScript knows eventName is DotCMSPredefinedEventType here
+ *   console.log('Predefined event:', eventName);
+ * } else {
+ *   // TypeScript knows eventName is string (custom) here
+ *   console.log('Custom event:', eventName);
+ * }
+ * ```
+ */
+export declare function isPredefinedEventType(event: string): event is DotCMSPredefinedEventType;
 /**
  * Validates required configuration fields for Analytics initialization.
  *
@@ -170,3 +191,70 @@ export declare const enrichPagePayload: (payload: {
         properties: Record<string, unknown>;
     };
 };
+/**
+ * Creates a throttled version of a callback function
+ * Ensures the callback is executed at most once every `limitMs` milliseconds
+ * @param callback - The function to throttle
+ * @param limitMs - The time limit in milliseconds
+ * @returns A throttled function
+ */
+export declare function createThrottle<T extends (...args: unknown[]) => void>(callback: T, limitMs: number): (...args: Parameters<T>) => void;
+/**
+ * Extracts the contentlet identifier from a DOM element
+ * @param element - The HTML element containing data attributes
+ * @returns The contentlet identifier or null if not found
+ */
+export declare function extractContentletIdentifier(element: HTMLElement): string | null;
+/**
+ * Extracts all contentlet data from a DOM element's data attributes
+ * @param element - The HTML element containing data attributes
+ * @returns Complete contentlet data object
+ */
+export declare function extractContentletData(element: HTMLElement): ContentletData;
+/**
+ * Initial scan delay for DOM readiness
+ * Allows React/Next.js to finish rendering before scanning for contentlets
+ */
+export declare const INITIAL_SCAN_DELAY_MS = 100;
+/**
+ * Checks if code is running in a browser environment
+ * @returns true if window and document are available
+ */
+export declare const isBrowser: () => boolean;
+/**
+ * Finds all contentlet elements in the DOM
+ * @returns Array of contentlet HTMLElements
+ */
+export declare const findContentlets: () => HTMLElement[];
+/**
+ * Creates a MutationObserver that watches for contentlet changes in the DOM
+ * @param callback - Function to call when mutations are detected
+ * @param debounceMs - Debounce time in milliseconds (default: 250ms)
+ * @returns Configured and active MutationObserver
+ */
+export declare const createContentletObserver: (callback: () => void, debounceMs?: number) => MutationObserver;
+/**
+ * Sets up cleanup handlers for page unload events
+ * Registers cleanup function to both 'beforeunload' and 'pagehide' for maximum compatibility
+ * @param cleanup - Function to call on page unload
+ */
+export declare const setupPluginCleanup: (cleanup: () => void) => void;
+/**
+ * Creates a logger with plugin-specific prefix and configurable log level
+ * @param pluginName - Name of the plugin (e.g., 'Click', 'Impression')
+ * @param config - Analytics configuration with debug flag and optional logLevel
+ * @returns DotLogger instance with configured log level
+ */
+export declare const createPluginLogger: (pluginName: string, config: {
+    debug: boolean;
+    logLevel?: LogLevel;
+}) => DotLogger;
+/**
+ * Gets enhanced tracking plugins based on configuration
+ * Returns content impression and click tracking plugins if enabled
+ * @param config - Analytics configuration
+ * @param impressionPlugin - Impression tracking plugin factory
+ * @param clickPlugin - Click tracking plugin factory
+ * @returns Array of enabled tracking plugins
+ */
+export declare const getEnhancedTrackingPlugins: (config: DotCMSAnalyticsConfig, impressionPlugin: (config: DotCMSAnalyticsConfig) => AnalyticsPlugin, clickPlugin: (config: DotCMSAnalyticsConfig) => AnalyticsPlugin) => AnalyticsPlugin[];

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

@@ -0,0 +1,202 @@
+import { ANALYTICS_JS_DEFAULT_PROPERTIES as T, SESSION_STORAGE_KEY as h, DEFAULT_SESSION_TIMEOUT_MINUTES as y, USER_ID_KEY as w, DEFAULT_IMPRESSION_MUTATION_OBSERVER_DEBOUNCE_MS as I, EXPECTED_UTM_KEYS as D, ANALYTICS_CONTENTLET_CLASS as S } from "../constants/dot-analytics.constants.js";
+import { DotLogger as E } from "../dot-analytics.logger.js";
+import "../../../../uve/src/internal/constants.js";
+function Y(t) {
+  var n, s;
+  const e = [];
+  return (n = t.siteAuth) != null && n.trim() || e.push('"siteAuth"'), (s = t.server) != null && s.trim() || e.push('"server"'), e.length > 0 ? e : null;
+}
+let u = null, l = null;
+const g = (t) => {
+  const e = Date.now(), n = Math.random().toString(36).substr(2, 9), s = Math.random().toString(36).substr(2, 9);
+  return `${t}_${e}_${n}${s}`;
+}, _ = {
+  getItem: (t) => {
+    try {
+      return localStorage.getItem(t);
+    } catch {
+      return null;
+    }
+  },
+  setItem: (t, e) => {
+    try {
+      localStorage.setItem(t, e);
+    } catch {
+      console.warn(`DotCMS Analytics [Core]: Could not save ${t} to localStorage`);
+    }
+  }
+}, A = () => {
+  let t = _.getItem(w);
+  return t || (t = g("user"), _.setItem(w, t)), t;
+}, C = (t) => {
+  const e = new Date(t), n = /* @__PURE__ */ new Date(), s = new Date(
+    e.getUTCFullYear(),
+    e.getUTCMonth(),
+    e.getUTCDate()
+  ), r = new Date(n.getUTCFullYear(), n.getUTCMonth(), n.getUTCDate());
+  return s.getTime() !== r.getTime();
+}, v = () => {
+  const t = Date.now();
+  if (typeof window > "u")
+    return g("session_fallback");
+  try {
+    const e = sessionStorage.getItem(h);
+    if (e) {
+      const { sessionId: r, startTime: o, lastActivity: a } = JSON.parse(e), i = !C(o), c = t - a < y * 60 * 1e3;
+      if (i && c)
+        return sessionStorage.setItem(
+          h,
+          JSON.stringify({
+            sessionId: r,
+            startTime: o,
+            lastActivity: t
+          })
+        ), r;
+    }
+    const n = g("session"), s = {
+      sessionId: n,
+      startTime: t,
+      lastActivity: t
+    };
+    return sessionStorage.setItem(h, JSON.stringify(s)), n;
+  } catch {
+    return g("session_fallback");
+  }
+}, x = (t) => {
+  const e = v(), n = A(), s = O();
+  return {
+    site_auth: t.siteAuth,
+    session_id: e,
+    user_id: n,
+    device: s
+  };
+}, p = () => u || (u = {
+  user_language: navigator.language,
+  doc_encoding: document.characterSet || document.charset,
+  screen_resolution: typeof screen < "u" && screen.width && screen.height ? `${screen.width}x${screen.height}` : ""
+}, u), O = () => {
+  const t = p(), e = window.innerWidth || document.documentElement.clientWidth || 0, n = window.innerHeight || document.documentElement.clientHeight || 0;
+  return {
+    screen_resolution: t.screen_resolution ?? "",
+    language: t.user_language ?? "",
+    viewport_width: String(e),
+    viewport_height: String(n)
+  };
+}, N = (t) => {
+  const e = t.search;
+  if (l && l.search === e)
+    return l.params;
+  const n = new URLSearchParams(e), s = {};
+  return D.forEach((r) => {
+    const o = n.get(r);
+    if (o) {
+      const a = r.replace("utm_", "");
+      s[a] = o;
+    }
+  }), l = { search: e, params: s }, s;
+}, b = () => {
+  try {
+    const t = (/* @__PURE__ */ new Date()).getTimezoneOffset(), e = t > 0 ? "-" : "+", n = Math.abs(t), s = Math.floor(n / 60), r = n % 60;
+    return `${e}${s.toString().padStart(2, "0")}:${r.toString().padStart(2, "0")}`;
+  } catch {
+    return "+00:00";
+  }
+}, M = () => {
+  try {
+    const t = /* @__PURE__ */ new Date(), e = b(), n = t.getFullYear(), s = (t.getMonth() + 1).toString().padStart(2, "0"), r = t.getDate().toString().padStart(2, "0"), o = t.getHours().toString().padStart(2, "0"), a = t.getMinutes().toString().padStart(2, "0"), i = t.getSeconds().toString().padStart(2, "0");
+    return `${n}-${s}-${r}T${o}:${a}:${i}${e}`;
+  } catch {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+}, B = (t, e = typeof window < "u" ? window.location : {}) => {
+  const n = M(), s = p(), { properties: r } = t, o = {};
+  Object.keys(r).forEach((c) => {
+    T.includes(c) || (o[c] = r[c]);
+  });
+  const a = {
+    url: e.href,
+    doc_encoding: s.doc_encoding,
+    doc_hash: e.hash,
+    doc_protocol: e.protocol,
+    doc_search: e.search,
+    doc_host: e.hostname,
+    doc_path: e.pathname,
+    title: r.title ?? (document == null ? void 0 : document.title)
+  }, i = N(e);
+  return {
+    ...t,
+    page: a,
+    ...Object.keys(i).length > 0 && { utm: i },
+    // Only include custom if there are user-provided properties
+    ...Object.keys(o).length > 0 && { custom: o },
+    local_time: n
+  };
+};
+function L(t, e) {
+  let n = 0;
+  return (...s) => {
+    const r = Date.now();
+    r - n >= e && (t(...s), n = r);
+  };
+}
+function F(t) {
+  return t.dataset.dotAnalyticsIdentifier || null;
+}
+function k(t) {
+  return {
+    identifier: t.dataset.dotAnalyticsIdentifier || "",
+    inode: t.dataset.dotAnalyticsInode || "",
+    contentType: t.dataset.dotAnalyticsContenttype || "",
+    title: t.dataset.dotAnalyticsTitle || "",
+    baseType: t.dataset.dotAnalyticsBasetype || ""
+  };
+}
+const z = 100, U = () => typeof window < "u" && typeof document < "u", H = () => Array.from(document.querySelectorAll(`.${S}`)), J = (t, e = I) => {
+  const n = L(t, e), s = new MutationObserver((r) => {
+    r.some((a) => a.addedNodes.length === 0 && a.removedNodes.length === 0 ? !1 : [
+      ...Array.from(a.addedNodes),
+      ...Array.from(a.removedNodes)
+    ].some((c) => {
+      var f, m;
+      if (c.nodeType !== Node.ELEMENT_NODE)
+        return !1;
+      const d = c;
+      return (f = d.classList) != null && f.contains(S) ? !0 : ((m = d.querySelector) == null ? void 0 : m.call(d, `.${S}`)) !== null;
+    })) && n();
+  });
+  return s.observe(document.body, {
+    childList: !0,
+    subtree: !0,
+    attributes: !1,
+    characterData: !1
+  }), s;
+}, K = (t) => {
+  U() && (window.addEventListener("beforeunload", t), window.addEventListener("pagehide", t));
+}, j = (t, e) => {
+  const n = e.logLevel ?? (e.debug ? "debug" : "warn");
+  return new E("Analytics", t, n);
+}, W = (t, e, n) => [
+  t.impressions && e(t),
+  t.clicks && n(t)
+].filter(Boolean);
+export {
+  z as INITIAL_SCAN_DELAY_MS,
+  J as createContentletObserver,
+  j as createPluginLogger,
+  L as createThrottle,
+  B as enrichPagePayloadOptimized,
+  k as extractContentletData,
+  F as extractContentletIdentifier,
+  N as extractUTMParameters,
+  H as findContentlets,
+  g as generateSecureId,
+  x as getAnalyticsContext,
+  O as getDeviceDataForContext,
+  W as getEnhancedTrackingPlugins,
+  M as getLocalTime,
+  v as getSessionId,
+  A as getUserId,
+  U as isBrowser,
+  K as setupPluginCleanup,
+  Y as validateAnalyticsConfig
+};

package/lib/react/hook/useContentAnalytics.js

@@ -1,27 +1,33 @@
-import { useMemo as n, useCallback as o } from "react";
-import { getUVEState as u } from "../../../uve/src/lib/core/core.utils.js";
+import { useMemo as s, useCallback as o } from "react";
+import { getUVEState as l } from "../../../uve/src/lib/core/core.utils.js";
 import "../../../uve/src/internal/constants.js";
-import { initializeAnalytics as l } from "../internal/utils.js";
-const h = (r) => {
-  const t = n(() => l(r), [r.server, r.siteAuth]), e = n(() => !!u(), []);
+import { initializeAnalytics as m } from "../internal/utils.js";
+const h = (i) => {
+  const t = s(() => m(i), [i.server, i.siteAuth]), e = s(() => !!l(), []);
   if (!t)
     throw new Error(
       "DotCMS Analytics: Failed to initialize. Please verify the required configuration (server and siteAuth)."
     );
   const a = o(
-    (i, c = {}) => {
-      e || t.track(i, c);
+    (r, n = {}) => {
+      e || t.track(r, n);
     },
     [t, e]
-  ), s = o(
-    (i = {}) => {
-      e || t.pageView(i);
+  ), c = o(
+    (r = {}) => {
+      e || t.pageView(r);
+    },
+    [t, e]
+  ), u = o(
+    (r, n = {}) => {
+      e || t.conversion(r, n);
     },
     [t, e]
   );
   return {
     track: a,
-    pageView: s
+    pageView: c,
+    conversion: u
   };
 };
 export {

package/lib/react/hook/useRouterTracker.js

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

package/lib/react/internal/utils.js

@@ -1,4 +1,4 @@
-import { initializeContentAnalytics as r } from "../../core/dot-content-analytics.js";
+import { initializeContentAnalytics as r } from "../../core/dot-analytics.content.js";
 let t, i;
 const s = (e) => (i && (i.server !== e.server || i.siteAuth !== e.siteAuth) && (t = void 0), t !== void 0 || (i = e, t = r(e)), t);
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/analytics",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Official JavaScript library for Content Analytics with DotCMS.",
   "repository": {
     "type": "git",
@@ -20,20 +20,21 @@
   },
   "homepage": "https://github.com/dotCMS/core/tree/main/core-web/libs/sdk/analytics/README.md",
   "dependencies": {
-    "analytics": "^0.8.0",
     "@analytics/core": "^0.13.0",
-    "@analytics/storage-utils": "^0.4.0",
     "@analytics/queue-utils": "^0.1.3",
-    "@dotcms/uve": "latest"
+    "@analytics/router-utils": "^0.1.1",
+    "@analytics/storage-utils": "^0.4.0",
+    "@dotcms/uve": "latest",
+    "analytics": "^0.8.0"
   },
   "peerDependencies": {
     "react": "^18 || ^19"
   },
   "devDependencies": {
+    "@dotcms/types": "latest",
     "@testing-library/jest-dom": "^6.1.6",
     "@testing-library/react": "^14.0.0",
-    "vite": "~5.0.0",
-    "@dotcms/types": "latest"
+    "vite": "~5.0.0"
   },
   "main": "./index.js",
   "module": "./index.js",

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

@@ -1,46 +0,0 @@
-import { Analytics as a } from "analytics";
-import { ANALYTICS_WINDOWS_ACTIVE_KEY as r, ANALYTICS_WINDOWS_CLEANUP_KEY as s } from "../../uve/src/internal/constants.js";
-import { dotAnalytics as l } from "./plugin/dot-analytics.plugin.js";
-import { dotAnalyticsEnricherPlugin as c } from "./plugin/enricher/dot-analytics.enricher.plugin.js";
-import { dotAnalyticsIdentityPlugin as p } from "./plugin/identity/dot-analytics.identity.plugin.js";
-import { validateAnalyticsConfig as m } from "./shared/dot-content-analytics.utils.js";
-import { cleanupActivityTracking as u } from "./shared/dot-content-analytics.activity-tracker.js";
-const I = (n) => {
-  const o = m(n);
-  if (o)
-    return console.error(`DotCMS Analytics: Missing ${o.join(" and ")} in configuration`), typeof window < "u" && (window[r] = !1), null;
-  const i = a({
-    app: "dotAnalytics",
-    debug: n.debug,
-    plugins: [
-      p(n),
-      // Inject identity context (user_id, session_id, local_tz)
-      c(),
-      // Enrich and clean payload with page, device, utm data and custom data
-      l(n)
-      // Send events to server
-    ]
-  }), e = () => u();
-  return typeof window < "u" && (window.addEventListener("beforeunload", e), window[s] = e, window[r] = !0, window.dispatchEvent(new CustomEvent("dotcms:analytics:ready"))), {
-    /**
-     * Track a page view.
-     * Session activity is automatically updated by the identity plugin.
-     * @param payload - Optional custom data to include with the page view (any valid JSON object)
-     */
-    pageView: (t = {}) => {
-      i == null || i.page(t);
-    },
-    /**
-     * Track a custom event.
-     * Session activity is automatically updated by the identity plugin.
-     * @param eventName - The name of the event to track
-     * @param payload - Custom data to include with the event (any valid JSON object)
-     */
-    track: (t, d = {}) => {
-      i == null || i.track(t, d);
-    }
-  };
-};
-export {
-  I as initializeContentAnalytics
-};

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

@@ -1,33 +0,0 @@
-import { DotCMSAnalyticsConfig, DotCMSAnalyticsParams } from '../shared/models';
-/**
- * Analytics plugin for tracking page views and custom events in DotCMS applications.
- * This plugin handles sending analytics data to the DotCMS server, managing initialization,
- * and processing both automatic and manual tracking events.
- * Supports optional queue management for batching events before sending.
- *
- * @param {DotCMSAnalyticsConfig} config - Configuration object containing API key, server URL,
- *                                     debug mode, auto page view settings, and queue config
- * @returns {Object} Plugin object with methods for initialization and event tracking
- */
-export declare const dotAnalytics: (config: DotCMSAnalyticsConfig) => {
-    name: string;
-    config: DotCMSAnalyticsConfig;
-    /**
-     * Initialize the plugin with optional queue management
-     */
-    initialize: () => Promise<void>;
-    /**
-     * Track a page view event
-     * The enricher plugin has already built the complete request body
-     */
-    page: (params: DotCMSAnalyticsParams) => void;
-    /**
-     * Track a custom event
-     * The enricher plugin has already built the complete request body
-     */
-    track: (params: DotCMSAnalyticsParams) => void;
-    /**
-     * Check if the plugin is loaded
-     */
-    loaded: () => boolean;
-};

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

@@ -1,42 +0,0 @@
-import { sendAnalyticsEvent as u } from "../shared/dot-content-analytics.http.js";
-import { createAnalyticsQueue as d } from "../shared/queue/dot-analytics.queue.utils.js";
-const v = (t) => {
-  let n = !1;
-  const i = t.queue !== !1;
-  let e = null;
-  const o = (r) => {
-    const { config: c, payload: l } = r;
-    if (!n)
-      throw new Error("DotCMS Analytics: Plugin not initialized");
-    const a = l.events[0], s = l.context;
-    i && e ? e.enqueue(a, s) : u({
-      context: s,
-      events: [a]
-    }, c);
-  };
-  return {
-    name: "dot-analytics",
-    config: t,
-    /**
-     * Initialize the plugin with optional queue management
-     */
-    initialize: () => (n = !0, i && (e = d(t), e.initialize()), Promise.resolve()),
-    /**
-     * Track a page view event
-     * The enricher plugin has already built the complete request body
-     */
-    page: o,
-    /**
-     * Track a custom event
-     * The enricher plugin has already built the complete request body
-     */
-    track: o,
-    /**
-     * Check if the plugin is loaded
-     */
-    loaded: () => n
-  };
-};
-export {
-  v as dotAnalytics
-};