@dotcms/analytics 1.1.1 → 1.2.0-next.10

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

@@ -1,111 +0,0 @@
-import { PageData } from 'analytics';
-import { DotCMSAnalyticsConfig, DotCMSAnalyticsContext, DotCMSAnalyticsPayload, DotCMSBrowserEventData, DotCMSDeviceData, DotCMSPageData, DotCMSUtmData } from './dot-content-analytics.model';
-export { cleanupActivityTracking, getLastActivity, getSessionInfo, initializeActivityTracking, isUserInactive, updateSessionActivity } from './dot-content-analytics.activity-tracker';
-/**
- * Generates a cryptographically secure random ID
- */
-export declare const generateSecureId: (prefix: string) => string;
-/**
- * Safe sessionStorage wrapper with error handling
- */
-export declare const safeSessionStorage: {
-    getItem: (key: string) => string | null;
-    setItem: (key: string, value: string) => void;
-};
-/**
- * Gets or generates a user ID
- */
-export declare const getUserId: () => string;
-/**
- * Gets session ID with comprehensive lifecycle management
- * Returns existing valid session ID or creates a new one if needed
- *
- * Session validation criteria:
- * 1. User is still active (< 30 min inactivity)
- * 2. Session hasn't passed midnight (UTC)
- * 3. UTM parameters haven't changed
- */
-export declare const getSessionId: () => string;
-/**
- * Gets analytics context with user and session identification
- */
-export declare const getAnalyticsContext: (config: DotCMSAnalyticsConfig) => DotCMSAnalyticsContext;
-/**
- * Configuration result with warnings for analytics setup
- */
-export interface AnalyticsConfigResult {
-    config: DotCMSAnalyticsConfig;
-    warnings?: string[];
-    missingAttributes?: string[];
-    hasIssues: boolean;
-}
-/**
- * Gets analytics configuration, 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")
- */
-export declare const getAnalyticsConfig: () => DotCMSAnalyticsConfig;
-/**
- * Retrieves the browser event data - optimized but accurate.
- */
-export declare const getBrowserEventData: (location: Location) => DotCMSBrowserEventData;
-/**
- * Extracts UTM parameters from the URL - cached for performance
- */
-export declare const extractUTMParameters: (location: Location) => Record<string, string>;
-/**
- * Default redirect function
- */
-export declare const defaultRedirectFn: (href: string) => string;
-/**
- * Gets local time in ISO format without milliseconds
- */
-export declare const getLocalTime: () => string;
-/**
- * Gets page data from browser event data and payload
- */
-export declare const getPageData: (browserData: DotCMSBrowserEventData, payload: DotCMSAnalyticsPayload) => PageData;
-/**
- * Gets device data from browser event data
- */
-export declare const getDeviceData: (browserData: DotCMSBrowserEventData) => DotCMSDeviceData;
-/**
- * Gets UTM data from browser event data
- */
-export declare const getUtmData: (browserData: DotCMSBrowserEventData) => DotCMSUtmData;
-/**
- * Enriches payload with UTM data
- */
-export declare const enrichWithUtmData: (payload: DotCMSAnalyticsPayload) => DotCMSAnalyticsPayload;
-/**
- * Optimized payload enrichment using existing analytics.js data
- * Reuses payload.properties data instead of recalculating from DOM when available
- * Maintains the same output structure as the original function
- */
-export declare const enrichPagePayloadOptimized: (payload: DotCMSAnalyticsPayload, location?: Location) => {
-    local_time: string;
-    utm?: DotCMSUtmData;
-    page: DotCMSPageData;
-    device: DotCMSDeviceData;
-    event: string;
-    properties: Record<string, unknown>;
-    options: Record<string, unknown>;
-    context?: DotCMSAnalyticsContext;
-};
-/**
- * @deprecated Use enrichPagePayloadOptimized instead to avoid data duplication
- * Legacy function that enriches page payload with all data in one call
- * This function duplicates data already available in analytics.js payload
- */
-export declare const enrichPagePayload: (payload: DotCMSAnalyticsPayload, location?: Location) => {
-    payload: {
-        local_time: string;
-        utm?: DotCMSUtmData;
-        page: PageData;
-        device: DotCMSDeviceData;
-        event: string;
-        properties: Record<string, unknown>;
-        options: Record<string, unknown>;
-        context?: DotCMSAnalyticsContext;
-    };
-};

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

@@ -1,123 +0,0 @@
-import { SESSION_STORAGE_KEY as h, DEFAULT_SESSION_TIMEOUT_MINUTES as S, USER_ID_KEY as m } from "./dot-content-analytics.constants.js";
-let d = null;
-const u = (t) => {
-  const e = Date.now(), n = Math.random().toString(36).substr(2, 9), o = Math.random().toString(36).substr(2, 9);
-  return `${t}_${e}_${n}${o}`;
-}, l = {
-  getItem: (t) => {
-    try {
-      return localStorage.getItem(t);
-    } catch {
-      return null;
-    }
-  },
-  setItem: (t, e) => {
-    try {
-      localStorage.setItem(t, e);
-    } catch {
-      console.warn(`DotAnalytics: Could not save ${t} to localStorage`);
-    }
-  }
-}, f = () => {
-  let t = l.getItem(m);
-  return t || (t = u("user"), l.setItem(m, t)), t;
-}, _ = (t) => {
-  const e = new Date(t), n = /* @__PURE__ */ new Date(), o = new Date(
-    e.getUTCFullYear(),
-    e.getUTCMonth(),
-    e.getUTCDate()
-  ), s = new Date(n.getUTCFullYear(), n.getUTCMonth(), n.getUTCDate());
-  return o.getTime() !== s.getTime();
-}, p = () => {
-  const t = Date.now();
-  if (typeof window > "u")
-    return u("session_fallback");
-  try {
-    const e = sessionStorage.getItem(h);
-    if (e) {
-      const { sessionId: s, startTime: c, lastActivity: i } = JSON.parse(e), g = !_(c), a = t - i < S * 60 * 1e3;
-      if (g && a)
-        return sessionStorage.setItem(
-          h,
-          JSON.stringify({
-            sessionId: s,
-            startTime: c,
-            lastActivity: t
-          })
-        ), s;
-    }
-    const n = u("session"), o = {
-      sessionId: n,
-      startTime: t,
-      lastActivity: t
-    };
-    return sessionStorage.setItem(h, JSON.stringify(o)), n;
-  } catch {
-    return u("session_fallback");
-  }
-}, T = (t) => {
-  const e = p(), n = f();
-  return t.debug && console.warn("DotAnalytics Identity Context:", {
-    sessionId: e,
-    userId: n
-  }), {
-    site_key: t.siteKey,
-    session_id: e,
-    user_id: n
-  };
-}, w = () => d || (d = {
-  user_language: navigator.language || void 0,
-  doc_encoding: document.characterSet || document.charset || void 0,
-  screen_resolution: typeof screen < "u" && screen.width && screen.height ? `${screen.width}x${screen.height}` : void 0
-}, d), I = () => {
-  try {
-    const t = (/* @__PURE__ */ new Date()).getTimezoneOffset(), e = t > 0 ? "-" : "+", n = Math.abs(t), o = Math.floor(n / 60), s = n % 60;
-    return `${e}${o.toString().padStart(2, "0")}:${s.toString().padStart(2, "0")}`;
-  } catch {
-    return "+00:00";
-  }
-}, D = () => {
-  try {
-    const t = /* @__PURE__ */ new Date(), e = I(), n = t.getFullYear(), o = (t.getMonth() + 1).toString().padStart(2, "0"), s = t.getDate().toString().padStart(2, "0"), c = t.getHours().toString().padStart(2, "0"), i = t.getMinutes().toString().padStart(2, "0"), g = t.getSeconds().toString().padStart(2, "0");
-    return `${n}-${o}-${s}T${c}:${i}:${g}${e}`;
-  } catch {
-    return (/* @__PURE__ */ new Date()).toISOString();
-  }
-}, $ = (t, e = typeof window < "u" ? window.location : {}) => {
-  const n = D(), o = w(), { properties: s } = t, { utm: c } = s, i = {
-    url: s.url ?? e.href,
-    doc_encoding: o.doc_encoding,
-    doc_hash: s.hash ?? e.hash ?? "",
-    doc_protocol: e.protocol,
-    doc_search: s.search ?? e.search ?? "",
-    doc_host: e.hostname,
-    doc_path: s.path ?? e.pathname,
-    title: s.title ?? (document == null ? void 0 : document.title),
-    language_id: void 0,
-    persona: void 0
-  }, g = {
-    screen_resolution: o.screen_resolution,
-    language: o.user_language,
-    viewport_width: String(s.width),
-    viewport_height: String(s.height)
-  }, a = {};
-  if (c && typeof c == "object") {
-    const r = c;
-    r.medium && (a.medium = r.medium), r.source && (a.source = r.source), r.campaign && (a.campaign = r.campaign), r.term && (a.term = r.term), r.content && (a.content = r.content);
-  }
-  return {
-    ...t,
-    page: i,
-    device: g,
-    ...Object.keys(a).length > 0 && { utm: a },
-    local_time: n
-  };
-};
-export {
-  $ as enrichPagePayloadOptimized,
-  u as generateSecureId,
-  T as getAnalyticsContext,
-  D as getLocalTime,
-  p as getSessionId,
-  f as getUserId
-};