@tracelog/lib 0.11.5 → 0.12.1

package/dist/public-api.js

@@ -202,12 +202,12 @@ var Mode = /* @__PURE__ */ ((Mode2) => {
 })(Mode || {});
 
 // src/types/scroll.types.ts
-function isPrimaryScrollEvent(event2) {
+var isPrimaryScrollEvent = (event2) => {
   return event2.type === "scroll" /* SCROLL */ && "scroll_data" in event2 && event2.scroll_data.is_primary === true;
-}
-function isSecondaryScrollEvent(event2) {
+};
+var isSecondaryScrollEvent = (event2) => {
   return event2.type === "scroll" /* SCROLL */ && "scroll_data" in event2 && event2.scroll_data.is_primary === false;
-}
+};
 
 // src/types/validation-error.types.ts
 var TraceLogValidationError = class extends Error {
@@ -255,12 +255,25 @@ var formatLogMsg = (msg, error) => {
       const sanitizedMessage = error.message.replace(/\s+at\s+.*$/gm, "").replace(/\(.*?:\d+:\d+\)/g, "");
       return `[TraceLog] ${msg}: ${sanitizedMessage}`;
     }
-    return `[TraceLog] ${msg}: ${error instanceof Error ? error.message : "Unknown error"}`;
+    if (error instanceof Error) {
+      return `[TraceLog] ${msg}: ${error.message}`;
+    }
+    if (typeof error === "string") {
+      return `[TraceLog] ${msg}: ${error}`;
+    }
+    if (typeof error === "object") {
+      try {
+        return `[TraceLog] ${msg}: ${JSON.stringify(error)}`;
+      } catch {
+        return `[TraceLog] ${msg}: [Unable to serialize error]`;
+      }
+    }
+    return `[TraceLog] ${msg}: ${String(error)}`;
   }
   return `[TraceLog] ${msg}`;
 };
 var log = (type, msg, extra) => {
-  const { error, data, showToClient = false } = extra ?? {};
+  const { error, data, showToClient = false, style } = extra ?? {};
   const formattedMsg = error ? formatLogMsg(msg, error) : `[TraceLog] ${msg}`;
   const method = type === "error" ? "error" : type === "warn" ? "warn" : "log";
   const isProduction = process.env.NODE_ENV !== "development";
@@ -272,13 +285,21 @@ var log = (type, msg, extra) => {
       return;
     }
   }
-  if (isProduction && data !== void 0) {
-    const sanitizedData = sanitizeLogData(data);
-    console[method](formattedMsg, sanitizedData);
-  } else if (data !== void 0) {
-    console[method](formattedMsg, data);
+  const hasStyle = style !== void 0 && style !== "";
+  const styledMsg = hasStyle ? `%c${formattedMsg}` : formattedMsg;
+  if (data !== void 0) {
+    const sanitizedData = isProduction ? sanitizeLogData(data) : data;
+    if (hasStyle) {
+      console[method](styledMsg, style, sanitizedData);
+    } else {
+      console[method](styledMsg, sanitizedData);
+    }
   } else {
-    console[method](formattedMsg);
+    if (hasStyle) {
+      console[method](styledMsg, style);
+    } else {
+      console[method](styledMsg);
+    }
   }
 };
 var sanitizeLogData = (data) => {
@@ -288,6 +309,14 @@ var sanitizeLogData = (data) => {
     const lowerKey = key.toLowerCase();
     if (sensitiveKeys.some((sensitiveKey) => lowerKey.includes(sensitiveKey))) {
       sanitized[key] = "[REDACTED]";
+      continue;
+    }
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      sanitized[key] = sanitizeLogData(value);
+    } else if (Array.isArray(value)) {
+      sanitized[key] = value.map(
+        (item) => item !== null && typeof item === "object" && !Array.isArray(item) ? sanitizeLogData(item) : item
+      );
     } else {
       sanitized[key] = value;
     }
@@ -335,23 +364,75 @@ var getDeviceType = () => {
   }
 };
 
+// src/constants/app.constants.ts
+var LOG_STYLE_ACTIVE = "background: #ff9800; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+var LOG_STYLE_DISABLED = "background: #9e9e9e; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+
 // src/constants/storage.constants.ts
 var STORAGE_BASE_KEY = "tlog";
 var QA_MODE_KEY = `${STORAGE_BASE_KEY}:qa_mode`;
 var USER_ID_KEY = `${STORAGE_BASE_KEY}:uid`;
+var QA_MODE_URL_PARAM = "tlog_mode";
+var QA_MODE_ENABLE_VALUE = "qa";
+var QA_MODE_DISABLE_VALUE = "qa_off";
 var QUEUE_KEY = (id) => id ? `${STORAGE_BASE_KEY}:${id}:queue` : `${STORAGE_BASE_KEY}:queue`;
 var SESSION_STORAGE_KEY = (id) => id ? `${STORAGE_BASE_KEY}:${id}:session` : `${STORAGE_BASE_KEY}:session`;
 var BROADCAST_CHANNEL_NAME = (id) => id ? `${STORAGE_BASE_KEY}:${id}:broadcast` : `${STORAGE_BASE_KEY}:broadcast`;
 
 // src/constants/performance.constants.ts
-var WEB_VITALS_THRESHOLDS = {
-  LCP: 4e3,
+var WEB_VITALS_GOOD_THRESHOLDS = {
+  LCP: 2500,
+  // Good: ≤ 2.5s
   FCP: 1800,
-  CLS: 0.25,
+  // Good: ≤ 1.8s
+  CLS: 0.1,
+  // Good: ≤ 0.1
+  INP: 200,
+  // Good: ≤ 200ms
+  TTFB: 800,
+  // Good: ≤ 800ms
+  LONG_TASK: 50
+};
+var WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS = {
+  LCP: 2500,
+  // Needs improvement: > 2.5s (same as good boundary)
+  FCP: 1800,
+  // Needs improvement: > 1.8s
+  CLS: 0.1,
+  // Needs improvement: > 0.1
   INP: 200,
+  // Needs improvement: > 200ms
   TTFB: 800,
+  // Needs improvement: > 800ms
+  LONG_TASK: 50
+};
+var WEB_VITALS_POOR_THRESHOLDS = {
+  LCP: 4e3,
+  // Poor: > 4s
+  FCP: 3e3,
+  // Poor: > 3s
+  CLS: 0.25,
+  // Poor: > 0.25
+  INP: 500,
+  // Poor: > 500ms
+  TTFB: 1800,
+  // Poor: > 1800ms
   LONG_TASK: 50
 };
+var DEFAULT_WEB_VITALS_MODE = "needs-improvement";
+var getWebVitalsThresholds = (mode = DEFAULT_WEB_VITALS_MODE) => {
+  switch (mode) {
+    case "all":
+      return { LCP: 0, FCP: 0, CLS: 0, INP: 0, TTFB: 0, LONG_TASK: 0 };
+    // Track everything
+    case "needs-improvement":
+      return WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS;
+    case "poor":
+      return WEB_VITALS_POOR_THRESHOLDS;
+    default:
+      return WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS;
+  }
+};
 var LONG_TASK_THROTTLE_MS = 1e3;
 var MAX_NAVIGATION_HISTORY = 50;
 
@@ -383,32 +464,65 @@ var ERROR_BURST_BACKOFF_MS = 5e3;
 var PERMANENT_ERROR_LOG_THROTTLE_MS = 6e4;
 
 // src/utils/browser/qa-mode.utils.ts
-var QA_MODE_PARAM = "tlog_mode";
-var QA_MODE_VALUE = "qa";
 var detectQaMode = () => {
-  const stored = sessionStorage.getItem(QA_MODE_KEY);
-  if (stored === "true") {
-    return true;
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return false;
   }
-  const params = new URLSearchParams(window.location.search);
-  const modeParam = params.get(QA_MODE_PARAM);
-  const isQaMode = modeParam === QA_MODE_VALUE;
-  if (isQaMode) {
-    sessionStorage.setItem(QA_MODE_KEY, "true");
-    params.delete(QA_MODE_PARAM);
-    const newSearch = params.toString();
-    const newUrl = `${window.location.pathname}${newSearch ? "?" + newSearch : ""}${window.location.hash}`;
-    try {
-      window.history.replaceState({}, "", newUrl);
-    } catch (error) {
-      log("warn", "History API not available, cannot replace URL", { error });
+  try {
+    const params = new URLSearchParams(window.location.search);
+    const urlParam = params.get(QA_MODE_URL_PARAM);
+    const storedState = sessionStorage.getItem(QA_MODE_KEY);
+    let newState = null;
+    if (urlParam === QA_MODE_ENABLE_VALUE) {
+      newState = true;
+      sessionStorage.setItem(QA_MODE_KEY, "true");
+      log("info", "QA Mode ACTIVE", {
+        showToClient: true,
+        style: LOG_STYLE_ACTIVE
+      });
+    } else if (urlParam === QA_MODE_DISABLE_VALUE) {
+      newState = false;
+      sessionStorage.removeItem(QA_MODE_KEY);
+      log("info", "QA Mode DISABLED", {
+        showToClient: true,
+        style: LOG_STYLE_DISABLED
+      });
     }
-    console.log(
-      "%c[TraceLog] QA Mode ACTIVE",
-      "background: #ff9800; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;"
-    );
+    if (urlParam === QA_MODE_ENABLE_VALUE || urlParam === QA_MODE_DISABLE_VALUE) {
+      try {
+        params.delete(QA_MODE_URL_PARAM);
+        const search = params.toString();
+        const url = window.location.pathname + (search ? "?" + search : "") + window.location.hash;
+        window.history.replaceState({}, "", url);
+      } catch {
+      }
+    }
+    return newState ?? storedState === "true";
+  } catch {
+    return false;
+  }
+};
+var setQaMode = (enabled) => {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return;
+  }
+  try {
+    if (enabled) {
+      sessionStorage.setItem(QA_MODE_KEY, "true");
+      log("info", "QA Mode ENABLED", {
+        showToClient: true,
+        style: LOG_STYLE_ACTIVE
+      });
+    } else {
+      sessionStorage.removeItem(QA_MODE_KEY);
+      log("info", "QA Mode DISABLED", {
+        showToClient: true,
+        style: LOG_STYLE_DISABLED
+      });
+    }
+  } catch {
+    log("warn", "Cannot set QA mode: sessionStorage unavailable");
   }
-  return isQaMode;
 };
 
 // src/utils/browser/utm-params.utils.ts
@@ -693,6 +807,41 @@ var validateAppConfig = (config) => {
   if (config.viewport !== void 0) {
     validateViewportConfig(config.viewport);
   }
+  if (config.webVitalsMode !== void 0) {
+    if (typeof config.webVitalsMode !== "string") {
+      throw new AppConfigValidationError(
+        `Invalid webVitalsMode type: ${typeof config.webVitalsMode}. Must be a string`,
+        "config"
+      );
+    }
+    const validModes = ["all", "needs-improvement", "poor"];
+    if (!validModes.includes(config.webVitalsMode)) {
+      throw new AppConfigValidationError(
+        `Invalid webVitalsMode: "${config.webVitalsMode}". Must be one of: ${validModes.join(", ")}`,
+        "config"
+      );
+    }
+  }
+  if (config.webVitalsThresholds !== void 0) {
+    if (typeof config.webVitalsThresholds !== "object" || config.webVitalsThresholds === null || Array.isArray(config.webVitalsThresholds)) {
+      throw new AppConfigValidationError("webVitalsThresholds must be an object", "config");
+    }
+    const validKeys = ["LCP", "FCP", "CLS", "INP", "TTFB", "LONG_TASK"];
+    for (const [key, value] of Object.entries(config.webVitalsThresholds)) {
+      if (!validKeys.includes(key)) {
+        throw new AppConfigValidationError(
+          `Invalid Web Vitals threshold key: "${key}". Must be one of: ${validKeys.join(", ")}`,
+          "config"
+        );
+      }
+      if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new AppConfigValidationError(
+          `Invalid Web Vitals threshold value for ${key}: ${value}. Must be a non-negative finite number`,
+          "config"
+        );
+      }
+    }
+  }
 };
 var validateViewportConfig = (viewport) => {
   if (typeof viewport !== "object" || viewport === null) {
@@ -1500,9 +1649,12 @@ var EventManager = class extends StateManager {
       return;
     }
     if (this.get("mode") === "qa" /* QA */ && eventType === "custom" /* CUSTOM */ && custom_event) {
-      console.log("[TraceLog] Event", {
-        name: custom_event.name,
-        ...custom_event.metadata && { metadata: custom_event.metadata }
+      log("info", "Event", {
+        showToClient: true,
+        data: {
+          name: custom_event.name,
+          ...custom_event.metadata && { metadata: custom_event.metadata }
+        }
       });
       this.emitEvent(payload);
       return;
@@ -3459,13 +3611,20 @@ var PerformanceHandler = class extends StateManager {
   navigationHistory = [];
   // FIFO queue for tracking navigation order
   observers = [];
-  vitalThresholds = WEB_VITALS_THRESHOLDS;
+  vitalThresholds;
   lastLongTaskSentAt = 0;
   constructor(eventManager) {
     super();
     this.eventManager = eventManager;
+    this.vitalThresholds = getWebVitalsThresholds(DEFAULT_WEB_VITALS_MODE);
   }
   async startTracking() {
+    const config = this.get("config");
+    const mode = config?.webVitalsMode ?? DEFAULT_WEB_VITALS_MODE;
+    this.vitalThresholds = getWebVitalsThresholds(mode);
+    if (config?.webVitalsThresholds) {
+      this.vitalThresholds = { ...this.vitalThresholds, ...config.webVitalsThresholds };
+    }
     await this.initWebVitals();
     this.observeLongTasks();
   }
@@ -4271,6 +4430,12 @@ var __setAppInstance = (instance) => {
   }
   app = instance;
 };
+var setQaMode2 = (enabled) => {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return;
+  }
+  setQaMode(enabled);
+};
 if (process.env.NODE_ENV === "development" && typeof window !== "undefined" && typeof document !== "undefined") {
   const injectTestingBridge = () => {
     window.__traceLogBridge = new TestBridge(isInitializing, isDestroying);
@@ -4283,14 +4448,6 @@ if (process.env.NODE_ENV === "development" && typeof window !== "undefined" && t
 }
 
 // src/app.constants.ts
-var PERFORMANCE_CONFIG = {
-  WEB_VITALS_THRESHOLDS
-  // Business thresholds for performance analysis
-};
-var DATA_PROTECTION = {
-  PII_PATTERNS
-  // Patterns for sensitive data protection
-};
 var ENGAGEMENT_THRESHOLDS = {
   LOW_ACTIVITY_EVENT_COUNT: 50,
   HIGH_ACTIVITY_EVENT_COUNT: 1e3,
@@ -4308,23 +4465,10 @@ var SESSION_ANALYTICS = {
   SHORT_SESSION_THRESHOLD_MS: 30 * 1e3,
   MEDIUM_SESSION_THRESHOLD_MS: 5 * 60 * 1e3,
   LONG_SESSION_THRESHOLD_MS: 30 * 60 * 1e3,
-  MAX_REALISTIC_SESSION_DURATION_MS: 8 * 60 * 60 * 1e3
+  MAX_REALISTIC_SESSION_DURATION_MS: 8 * 60 * 60 * 1e3,
   // Filter outliers
-};
-var DEVICE_ANALYTICS = {
-  MOBILE_MAX_WIDTH: 768,
-  TABLET_MAX_WIDTH: 1024,
-  MOBILE_PERFORMANCE_FACTOR: 1.5,
-  // Mobile typically 1.5x slower
-  TABLET_PERFORMANCE_FACTOR: 1.2
-};
-var CONTENT_ANALYTICS = {
-  MIN_TEXT_LENGTH_FOR_ANALYSIS: 10,
-  MIN_CLICKS_FOR_HOT_ELEMENT: 10,
-  // Popular element threshold
-  MIN_SCROLL_COMPLETION_PERCENT: 80,
-  // Page consumption threshold
-  MIN_TIME_ON_PAGE_FOR_READ_MS: 15 * 1e3
+  MIN_EVENTS_FOR_DURATION: 2
+  // Minimum events required to calculate session duration
 };
 var INSIGHT_THRESHOLDS = {
   SIGNIFICANT_CHANGE_PERCENT: 20,
@@ -4337,20 +4481,6 @@ var INSIGHT_THRESHOLDS = {
   HIGH_ERROR_RATE_PERCENT: 5,
   CRITICAL_ERROR_RATE_PERCENT: 10
 };
-var TEMPORAL_ANALYSIS = {
-  SHORT_TERM_TREND_HOURS: 24,
-  MEDIUM_TERM_TREND_DAYS: 7,
-  LONG_TERM_TREND_DAYS: 30,
-  MIN_DATA_POINTS_FOR_TREND: 5,
-  WEEKLY_PATTERN_MIN_WEEKS: 4,
-  DAILY_PATTERN_MIN_DAYS: 14
-};
-var SEGMENTATION_ANALYTICS = {
-  MIN_SEGMENT_SIZE: 10,
-  MIN_COHORT_SIZE: 5,
-  COHORT_ANALYSIS_DAYS: [1, 3, 7, 14, 30],
-  MIN_FUNNEL_EVENTS: 20
-};
 var ANALYTICS_QUERY_LIMITS = {
   DEFAULT_EVENTS_LIMIT: 5,
   DEFAULT_SESSIONS_LIMIT: 5,
@@ -4360,14 +4490,6 @@ var ANALYTICS_QUERY_LIMITS = {
   ANALYTICS_BATCH_SIZE: 1e3
   // For historical analysis
 };
-var ANOMALY_DETECTION = {
-  ANOMALY_THRESHOLD_SIGMA: 2.5,
-  STRONG_ANOMALY_THRESHOLD_SIGMA: 3,
-  TRAFFIC_DROP_ALERT_PERCENT: -30,
-  TRAFFIC_SPIKE_ALERT_PERCENT: 200,
-  MIN_BASELINE_DAYS: 7,
-  MIN_EVENTS_FOR_ANOMALY_DETECTION: 50
-};
 var SPECIAL_PAGE_URLS = {
   PAGE_URL_EXCLUDED: "excluded",
   PAGE_URL_UNKNOWN: "unknown"
@@ -4380,9 +4502,10 @@ var tracelog = {
   on,
   off,
   isInitialized,
-  destroy
+  destroy,
+  setQaMode: setQaMode2
 };
 
-export { ANALYTICS_QUERY_LIMITS, ANOMALY_DETECTION, AppConfigValidationError, CONTENT_ANALYTICS, DATA_PROTECTION, DEVICE_ANALYTICS, DeviceType, ENGAGEMENT_THRESHOLDS, EmitterEvent, ErrorType, EventType, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_METADATA_NESTING_DEPTH, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, Mode, PERFORMANCE_CONFIG, PermanentError, SEGMENTATION_ANALYTICS, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, ScrollDirection, SessionTimeoutValidationError, SpecialApiUrl, TEMPORAL_ANALYSIS, TraceLogValidationError, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { ANALYTICS_QUERY_LIMITS, AppConfigValidationError, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, DeviceType, ENGAGEMENT_THRESHOLDS, EmitterEvent, ErrorType, EventType, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, MAX_ARRAY_LENGTH, MAX_CUSTOM_EVENT_ARRAY_SIZE, MAX_CUSTOM_EVENT_KEYS, MAX_CUSTOM_EVENT_NAME_LENGTH, MAX_CUSTOM_EVENT_STRING_SIZE, MAX_METADATA_NESTING_DEPTH, MAX_NESTED_OBJECT_KEYS, MAX_STRING_LENGTH, MAX_STRING_LENGTH_IN_ARRAY, Mode, PII_PATTERNS, PermanentError, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, ScrollDirection, SessionTimeoutValidationError, SpecialApiUrl, TraceLogValidationError, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
 //# sourceMappingURL=public-api.js.map
 //# sourceMappingURL=public-api.js.map