@tracelog/lib 0.12.0 → 0.12.1

package/dist/public-api.cjs

@@ -257,12 +257,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";
@@ -274,13 +287,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) => {
@@ -290,6 +311,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;
     }
@@ -337,10 +366,17 @@ 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`;
@@ -430,32 +466,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
@@ -1582,9 +1651,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;
@@ -4360,6 +4432,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);
@@ -4389,23 +4467,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,
@@ -4418,20 +4483,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,
@@ -4441,14 +4492,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"
@@ -4461,15 +4504,14 @@ var tracelog = {
   on,
   off,
   isInitialized,
-  destroy
+  destroy,
+  setQaMode: setQaMode2
 };
 
 exports.ANALYTICS_QUERY_LIMITS = ANALYTICS_QUERY_LIMITS;
-exports.ANOMALY_DETECTION = ANOMALY_DETECTION;
 exports.AppConfigValidationError = AppConfigValidationError;
-exports.CONTENT_ANALYTICS = CONTENT_ANALYTICS;
+exports.DEFAULT_SESSION_TIMEOUT = DEFAULT_SESSION_TIMEOUT;
 exports.DEFAULT_WEB_VITALS_MODE = DEFAULT_WEB_VITALS_MODE;
-exports.DEVICE_ANALYTICS = DEVICE_ANALYTICS;
 exports.DeviceType = DeviceType;
 exports.ENGAGEMENT_THRESHOLDS = ENGAGEMENT_THRESHOLDS;
 exports.EmitterEvent = EmitterEvent;
@@ -4490,14 +4532,12 @@ exports.MAX_STRING_LENGTH_IN_ARRAY = MAX_STRING_LENGTH_IN_ARRAY;
 exports.Mode = Mode;
 exports.PII_PATTERNS = PII_PATTERNS;
 exports.PermanentError = PermanentError;
-exports.SEGMENTATION_ANALYTICS = SEGMENTATION_ANALYTICS;
 exports.SESSION_ANALYTICS = SESSION_ANALYTICS;
 exports.SPECIAL_PAGE_URLS = SPECIAL_PAGE_URLS;
 exports.SamplingRateValidationError = SamplingRateValidationError;
 exports.ScrollDirection = ScrollDirection;
 exports.SessionTimeoutValidationError = SessionTimeoutValidationError;
 exports.SpecialApiUrl = SpecialApiUrl;
-exports.TEMPORAL_ANALYSIS = TEMPORAL_ANALYSIS;
 exports.TraceLogValidationError = TraceLogValidationError;
 exports.WEB_VITALS_GOOD_THRESHOLDS = WEB_VITALS_GOOD_THRESHOLDS;
 exports.WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS = WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS;