@tracelog/lib 2.0.3 → 2.1.0-rc.74.2

package/dist/public-api.cjs

@@ -267,12 +267,6 @@ var init_event_types = __esm({
   }
 });
 
-// src/types/log.types.ts
-var init_log_types = __esm({
-  "src/types/log.types.ts"() {
-  }
-});
-
 // src/types/mode.types.ts
 exports.Mode = void 0;
 var init_mode_types = __esm({
@@ -387,7 +381,6 @@ var init_types = __esm({
     init_emitter_types();
     init_error_types();
     init_event_types();
-    init_log_types();
     init_mode_types();
     init_queue_types();
     init_scroll_types();
@@ -400,10 +393,22 @@ var init_types = __esm({
   }
 });
 
+// src/constants/app.constants.ts
+var LOG_STYLE_ACTIVE, LOG_STYLE_DISABLED, LOG_STYLE_CRITICAL;
+var init_app_constants = __esm({
+  "src/constants/app.constants.ts"() {
+    LOG_STYLE_ACTIVE = "background: #ff9800; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+    LOG_STYLE_DISABLED = "background: #9e9e9e; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+    LOG_STYLE_CRITICAL = "background: #d32f2f; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+  }
+});
+
 // src/utils/logging.utils.ts
-var formatLogMsg, log, sanitizeLogData;
+var formatLogMsg, isQaModeActive, log, shouldShowLog, getEffectiveStyle, outputLog, sanitizeLogData;
 var init_logging_utils = __esm({
   "src/utils/logging.utils.ts"() {
+    init_storage_constants();
+    init_app_constants();
     formatLogMsg = (msg, error) => {
       if (error) {
         if (process.env.NODE_ENV !== "development" && error instanceof Error) {
@@ -427,27 +432,59 @@ var init_logging_utils = __esm({
       }
       return `[TraceLog] ${msg}`;
     };
+    isQaModeActive = () => {
+      if (typeof window === "undefined" || typeof sessionStorage === "undefined") {
+        return false;
+      }
+      try {
+        return sessionStorage.getItem(QA_MODE_KEY) === "true";
+      } catch {
+        return false;
+      }
+    };
     log = (type, msg, extra) => {
-      const { error, data, showToClient = false, style } = extra ?? {};
+      const { error, data, showToClient = false, style, visibility } = 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";
-      if (isProduction) {
-        if (type === "debug") {
-          return;
-        }
-        if (type === "info" && !showToClient) {
-          return;
-        }
+      if (!isProduction) {
+        outputLog(method, formattedMsg, style, data);
+        return;
+      }
+      const shouldShow = shouldShowLog(visibility, showToClient);
+      if (!shouldShow) {
+        return;
+      }
+      const effectiveStyle = getEffectiveStyle(visibility, style);
+      const sanitizedData = data !== void 0 ? sanitizeLogData(data) : void 0;
+      outputLog(method, formattedMsg, effectiveStyle, sanitizedData);
+    };
+    shouldShowLog = (visibility, showToClient) => {
+      if (visibility === "critical") {
+        return true;
+      }
+      if (visibility === "qa" || showToClient) {
+        return isQaModeActive();
       }
+      return false;
+    };
+    getEffectiveStyle = (visibility, providedStyle) => {
+      if (providedStyle !== void 0 && providedStyle !== "") {
+        return providedStyle;
+      }
+      if (visibility === "critical") {
+        return LOG_STYLE_CRITICAL;
+      }
+      return "";
+    };
+    outputLog = (method, formattedMsg, style, 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);
+          console[method](styledMsg, style, data);
         } else {
-          console[method](styledMsg, sanitizedData);
+          console[method](styledMsg, data);
         }
       } else {
         if (hasStyle) {
@@ -482,7 +519,7 @@ var init_logging_utils = __esm({
 });
 
 // src/utils/browser/device-detector.utils.ts
-var coarsePointerQuery, noHoverQuery, initMediaQueries, getDeviceType;
+var coarsePointerQuery, noHoverQuery, initMediaQueries, UNKNOWN, detectOS, detectBrowser, getDeviceType, getDeviceInfo;
 var init_device_detector_utils = __esm({
   "src/utils/browser/device-detector.utils.ts"() {
     init_device_types();
@@ -493,11 +530,53 @@ var init_device_detector_utils = __esm({
         noHoverQuery = window.matchMedia("(hover: none)");
       }
     };
+    UNKNOWN = "Unknown";
+    detectOS = (nav) => {
+      const platform = nav.userAgentData?.platform;
+      if (platform != null && platform !== "") {
+        if (/windows/i.test(platform)) return "Windows";
+        if (/macos/i.test(platform)) return "macOS";
+        if (/android/i.test(platform)) return "Android";
+        if (/linux/i.test(platform)) return "Linux";
+        if (/chromeos/i.test(platform)) return "ChromeOS";
+        if (/ios/i.test(platform)) return "iOS";
+      }
+      const ua = navigator.userAgent;
+      if (/Windows/i.test(ua)) return "Windows";
+      if (/iPhone|iPad|iPod/i.test(ua)) return "iOS";
+      if (/Mac OS X|Macintosh/i.test(ua)) return "macOS";
+      if (/Android/i.test(ua)) return "Android";
+      if (/CrOS/i.test(ua)) return "ChromeOS";
+      if (/Linux/i.test(ua)) return "Linux";
+      return UNKNOWN;
+    };
+    detectBrowser = (nav) => {
+      const brands = nav.userAgentData?.brands;
+      if (brands != null && brands.length > 0) {
+        const validBrands = brands.filter((b) => !/not.?a.?brand|chromium/i.test(b.brand));
+        const firstBrand = validBrands[0];
+        if (firstBrand != null) {
+          const brand = firstBrand.brand;
+          if (/google chrome/i.test(brand)) return "Chrome";
+          if (/microsoft edge/i.test(brand)) return "Edge";
+          if (/opera/i.test(brand)) return "Opera";
+          return brand;
+        }
+      }
+      const ua = navigator.userAgent;
+      if (/Edg\//i.test(ua)) return "Edge";
+      if (/OPR\//i.test(ua)) return "Opera";
+      if (/Chrome/i.test(ua)) return "Chrome";
+      if (/Firefox/i.test(ua)) return "Firefox";
+      if (/Safari/i.test(ua) && !/Chrome/i.test(ua)) return "Safari";
+      return UNKNOWN;
+    };
     getDeviceType = () => {
       try {
         const nav = navigator;
-        if (nav.userAgentData && typeof nav.userAgentData.mobile === "boolean") {
-          if (nav.userAgentData.platform && /ipad|tablet/i.test(nav.userAgentData.platform)) {
+        if (nav.userAgentData != null && typeof nav.userAgentData.mobile === "boolean") {
+          const uaPlatform = nav.userAgentData.platform;
+          if (uaPlatform != null && uaPlatform !== "" && /ipad|tablet/i.test(uaPlatform)) {
             return "tablet" /* Tablet */;
           }
           const result = nav.userAgentData.mobile ? "mobile" /* Mobile */ : "desktop" /* Desktop */;
@@ -519,19 +598,27 @@ var init_device_detector_utils = __esm({
         }
         return "desktop" /* Desktop */;
       } catch (error) {
-        log("warn", "Device detection failed, defaulting to desktop", { error });
+        log("debug", "Device detection failed, defaulting to desktop", { error });
         return "desktop" /* Desktop */;
       }
     };
-  }
-});
-
-// src/constants/app.constants.ts
-var LOG_STYLE_ACTIVE, LOG_STYLE_DISABLED;
-var init_app_constants = __esm({
-  "src/constants/app.constants.ts"() {
-    LOG_STYLE_ACTIVE = "background: #ff9800; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
-    LOG_STYLE_DISABLED = "background: #9e9e9e; color: white; font-weight: bold; padding: 2px 8px; border-radius: 3px;";
+    getDeviceInfo = () => {
+      try {
+        const nav = navigator;
+        return {
+          type: getDeviceType(),
+          os: detectOS(nav),
+          browser: detectBrowser(nav)
+        };
+      } catch (error) {
+        log("debug", "Device info detection failed, using defaults", { error });
+        return {
+          type: "desktop" /* Desktop */,
+          os: UNKNOWN,
+          browser: UNKNOWN
+        };
+      }
+    };
   }
 });
 
@@ -633,7 +720,7 @@ var init_performance_constants = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "2.0.2";
+    version = "2.1.0";
   }
 });
 
@@ -658,19 +745,33 @@ var init_constants = __esm({
   }
 });
 
-// src/utils/browser/qa-mode.utils.ts
-var qa_mode_utils_exports = {};
-__export(qa_mode_utils_exports, {
+// src/utils/browser/mode.utils.ts
+var mode_utils_exports = {};
+__export(mode_utils_exports, {
   detectQaMode: () => detectQaMode,
+  isQaModeActive: () => isQaModeActive2,
   setQaMode: () => setQaMode
 });
-var detectQaMode, setQaMode;
-var init_qa_mode_utils = __esm({
-  "src/utils/browser/qa-mode.utils.ts"() {
+var isBrowserEnvironment, cleanUrlParameter, detectQaMode, setQaMode, isQaModeActive2;
+var init_mode_utils = __esm({
+  "src/utils/browser/mode.utils.ts"() {
     init_constants();
     init_logging_utils();
+    isBrowserEnvironment = () => {
+      return typeof window !== "undefined" && typeof sessionStorage !== "undefined";
+    };
+    cleanUrlParameter = () => {
+      try {
+        const params = new URLSearchParams(window.location.search);
+        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 {
+      }
+    };
     detectQaMode = () => {
-      if (typeof window === "undefined" || typeof document === "undefined") {
+      if (!isBrowserEnvironment()) {
         return false;
       }
       try {
@@ -682,25 +783,19 @@ var init_qa_mode_utils = __esm({
           newState = true;
           sessionStorage.setItem(QA_MODE_KEY, "true");
           log("info", "QA Mode ACTIVE", {
-            showToClient: true,
+            visibility: "qa",
             style: LOG_STYLE_ACTIVE
           });
         } else if (urlParam === QA_MODE_DISABLE_VALUE) {
           newState = false;
           sessionStorage.setItem(QA_MODE_KEY, "false");
           log("info", "QA Mode DISABLED", {
-            showToClient: true,
+            visibility: "qa",
             style: LOG_STYLE_DISABLED
           });
         }
         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 {
-          }
+          cleanUrlParameter();
         }
         return newState ?? storedState === "true";
       } catch {
@@ -708,25 +803,27 @@ var init_qa_mode_utils = __esm({
       }
     };
     setQaMode = (enabled) => {
-      if (typeof window === "undefined" || typeof document === "undefined") {
+      if (!isBrowserEnvironment()) {
         return;
       }
       try {
-        if (enabled) {
-          sessionStorage.setItem(QA_MODE_KEY, "true");
-          log("info", "QA Mode ENABLED", {
-            showToClient: true,
-            style: LOG_STYLE_ACTIVE
-          });
-        } else {
-          sessionStorage.setItem(QA_MODE_KEY, "false");
-          log("info", "QA Mode DISABLED", {
-            showToClient: true,
-            style: LOG_STYLE_DISABLED
-          });
-        }
+        sessionStorage.setItem(QA_MODE_KEY, enabled ? "true" : "false");
+        log("info", enabled ? "QA Mode ACTIVE" : "QA Mode DISABLED", {
+          visibility: "qa",
+          style: enabled ? LOG_STYLE_ACTIVE : LOG_STYLE_DISABLED
+        });
       } catch {
-        log("warn", "Cannot set QA mode: sessionStorage unavailable");
+        log("debug", "Cannot set QA mode: sessionStorage unavailable");
+      }
+    };
+    isQaModeActive2 = () => {
+      if (!isBrowserEnvironment()) {
+        return false;
+      }
+      try {
+        return sessionStorage.getItem(QA_MODE_KEY) === "true";
+      } catch {
+        return false;
       }
     };
   }
@@ -757,7 +854,7 @@ var init_utm_params_utils = __esm({
 var init_browser = __esm({
   "src/utils/browser/index.ts"() {
     init_device_detector_utils();
-    init_qa_mode_utils();
+    init_mode_utils();
     init_utm_params_utils();
   }
 });
@@ -887,7 +984,7 @@ var init_url_utils = __esm({
     };
     normalizeUrl = (url, sensitiveQueryParams = []) => {
       if (!url || typeof url !== "string") {
-        log("warn", "Invalid URL provided to normalizeUrl", { data: { url: String(url) } });
+        log("warn", "Invalid URL provided to normalizeUrl", { data: { type: typeof url } });
         return url || "";
       }
       try {
@@ -910,8 +1007,7 @@ var init_url_utils = __esm({
         const result = urlObject.toString();
         return result;
       } catch (error) {
-        const urlPreview = url && typeof url === "string" ? url.slice(0, 100) : String(url);
-        log("warn", "URL normalization failed, returning original", { error, data: { url: urlPreview } });
+        log("warn", "URL normalization failed, returning original", { error, data: { urlLength: url?.length } });
         return url;
       }
     };
@@ -951,7 +1047,7 @@ var init_sanitize_utils = __esm({
         log("warn", "XSS patterns detected and removed", {
           data: {
             patternMatches: xssPatternMatches,
-            originalValue: value.slice(0, 100)
+            valueLength: value.length
           }
         });
       }
@@ -1467,7 +1563,6 @@ var init_event_validations_utils = __esm({
       const nameValidation = isValidEventName(eventName);
       if (!nameValidation.valid) {
         log("error", "Event name validation failed", {
-          showToClient: true,
           data: { eventName, error: nameValidation.error }
         });
         return nameValidation;
@@ -1478,7 +1573,6 @@ var init_event_validations_utils = __esm({
       const metadataValidation = isValidMetadata(eventName, metadata, "customEvent");
       if (!metadataValidation.valid) {
         log("error", "Event metadata validation failed", {
-          showToClient: true,
           data: {
             eventName,
             error: metadataValidation.error
@@ -1644,7 +1738,10 @@ function transformEvent(event2, transformer, context) {
     log("warn", `beforeSend transformer returned invalid data, using original [${context}]`);
     return event2;
   } catch (error) {
-    log("error", `beforeSend transformer threw error, using original event [${context}]`, { error });
+    log("error", `beforeSend transformer threw error, using original event [${context}]`, {
+      error,
+      visibility: "critical"
+    });
     return event2;
   }
 }
@@ -1670,7 +1767,8 @@ function transformBatch(batch, transformer, context) {
   } catch (error) {
     log("error", `beforeBatch transformer threw error, using original batch [${context}]`, {
       error,
-      data: { eventCount: batch.events.length }
+      data: { eventCount: batch.events.length },
+      visibility: "critical"
     });
     return batch;
   }
@@ -2173,7 +2271,7 @@ var init_sender_manager = __esm({
           return true;
         }
         if (this.apiUrl?.includes("localhost:9999" /* Fail */)) {
-          log("warn", `Fail mode: simulating network failure${this.integrationId ? ` [${this.integrationId}]` : ""}`, {
+          log("debug", `Fail mode: simulating network failure${this.integrationId ? ` [${this.integrationId}]` : ""}`, {
             data: { events: transformedBody.events.length }
           });
           return false;
@@ -2400,7 +2498,7 @@ var init_sender_manager = __esm({
             return JSON.parse(persistedDataString);
           }
         } catch (error) {
-          log("warn", `Failed to parse persisted data${this.integrationId ? ` [${this.integrationId}]` : ""}`, { error });
+          log("debug", `Failed to parse persisted data${this.integrationId ? ` [${this.integrationId}]` : ""}`, { error });
           this.clearPersistedEvents();
         }
         return null;
@@ -2479,7 +2577,7 @@ var init_sender_manager = __esm({
           this.storeManager.setItem(storageKey, JSON.stringify(persistedData));
           return !!this.storeManager.getItem(storageKey);
         } catch (error) {
-          log("warn", `Failed to persist events${this.integrationId ? ` [${this.integrationId}]` : ""}`, { error });
+          log("debug", `Failed to persist events${this.integrationId ? ` [${this.integrationId}]` : ""}`, { error });
           return false;
         }
       }
@@ -2488,7 +2586,9 @@ var init_sender_manager = __esm({
           const key = this.getQueueStorageKey();
           this.storeManager.removeItem(key);
         } catch (error) {
-          log("warn", `Failed to clear persisted events${this.integrationId ? ` [${this.integrationId}]` : ""}`, { error });
+          log("debug", `Failed to clear persisted events${this.integrationId ? ` [${this.integrationId}]` : ""}`, {
+            error
+          });
         }
       }
       shouldSkipSend() {
@@ -2563,7 +2663,7 @@ var init_time_manager = __esm({
         } else {
           this.bootTime = 0;
           this.bootTimestamp = Date.now();
-          log("warn", "performance.now() not available, falling back to Date.now()");
+          log("debug", "performance.now() not available, falling back to Date.now()");
         }
       }
       /**
@@ -2798,7 +2898,7 @@ var init_event_manager = __esm({
               }
             },
             onFailure: () => {
-              log("warn", "Failed to recover persisted events");
+              log("debug", "Failed to recover persisted events");
             }
           })
         );
@@ -2872,7 +2972,8 @@ var init_event_manager = __esm({
         custom_event,
         web_vitals,
         error_data,
-        viewport_data
+        viewport_data,
+        page_view
       }) {
         if (!type) {
           log("error", "Event type is required - event will be ignored");
@@ -2882,7 +2983,7 @@ var init_event_manager = __esm({
         if (!currentSessionId) {
           if (this.pendingEventsBuffer.length >= MAX_PENDING_EVENTS_BUFFER) {
             this.pendingEventsBuffer.shift();
-            log("warn", "Pending events buffer full - dropping oldest event", {
+            log("debug", "Pending events buffer full - dropping oldest event", {
               data: { maxBufferSize: MAX_PENDING_EVENTS_BUFFER }
             });
           }
@@ -2895,7 +2996,8 @@ var init_event_manager = __esm({
             custom_event,
             web_vitals,
             error_data,
-            viewport_data
+            viewport_data,
+            page_view
           });
           return;
         }
@@ -2956,7 +3058,8 @@ var init_event_manager = __esm({
           custom_event,
           web_vitals,
           error_data,
-          viewport_data
+          viewport_data,
+          page_view
         });
         if (!payload) {
           return;
@@ -2971,7 +3074,7 @@ var init_event_manager = __esm({
             return;
           }
           if (this.get("hasStartSession")) {
-            log("warn", "Duplicate session_start detected", {
+            log("debug", "Duplicate session_start detected", {
               data: { sessionId: currentSessionId2 }
             });
             return;
@@ -2981,16 +3084,33 @@ var init_event_manager = __esm({
         if (this.isDuplicateEvent(payload)) {
           return;
         }
-        if (this.get("mode") === "qa" /* QA */ && eventType === "custom" /* CUSTOM */ && custom_event) {
-          log("info", `Custom Event: ${custom_event.name}`, {
-            showToClient: true,
-            data: {
-              name: custom_event.name,
-              ...custom_event.metadata && { metadata: custom_event.metadata }
-            }
-          });
-          this.emitEvent(payload);
-          return;
+        if (this.get("mode") === "qa" /* QA */) {
+          if (eventType === "custom" /* CUSTOM */ && custom_event) {
+            log("info", `Custom Event: ${custom_event.name}`, {
+              visibility: "qa",
+              data: {
+                name: custom_event.name,
+                ...custom_event.metadata && { metadata: custom_event.metadata }
+              }
+            });
+            this.emitEvent(payload);
+            return;
+          }
+          if (eventType === "viewport_visible" /* VIEWPORT_VISIBLE */ && viewport_data) {
+            const displayName = viewport_data.name || viewport_data.id || viewport_data.selector;
+            log("info", `Viewport Visible: ${displayName}`, {
+              visibility: "qa",
+              data: {
+                selector: viewport_data.selector,
+                ...viewport_data.name && { name: viewport_data.name },
+                ...viewport_data.id && { id: viewport_data.id },
+                visibilityRatio: viewport_data.visibilityRatio,
+                dwellTime: viewport_data.dwellTime
+              }
+            });
+            this.emitEvent(payload);
+            return;
+          }
         }
         this.addToQueue(payload);
         if (!isCriticalEvent) {
@@ -3242,7 +3362,7 @@ var init_event_manager = __esm({
         }
         const currentSessionId = this.get("sessionId");
         if (!currentSessionId) {
-          log("warn", "Cannot flush pending events: session not initialized - keeping in buffer", {
+          log("debug", "Cannot flush pending events: session not initialized - keeping in buffer", {
             data: { bufferedEventCount: this.pendingEventsBuffer.length }
           });
           return;
@@ -3284,7 +3404,7 @@ var init_event_manager = __esm({
             this.emitEventsQueue(body);
           } else {
             this.clearSendInterval();
-            log("warn", "Sync flush complete failure, events kept in queue for retry", {
+            log("debug", "Sync flush complete failure, events kept in queue for retry", {
               data: { eventCount: eventIds.length }
             });
           }
@@ -3305,7 +3425,7 @@ var init_event_manager = __esm({
               this.clearSendInterval();
               this.emitEventsQueue(body);
             } else {
-              log("warn", "Async flush complete failure, events kept in queue for retry", {
+              log("debug", "Async flush complete failure, events kept in queue for retry", {
                 data: { eventCount: eventsToSend.length }
               });
             }
@@ -3339,12 +3459,12 @@ var init_event_manager = __esm({
           this.emitEventsQueue(body);
           const failedCount = results.filter((result) => !this.isSuccessfulResult(result)).length;
           if (failedCount > 0) {
-            log("warn", "Periodic send completed with some failures, removed from queue and persisted per-integration", {
+            log("debug", "Periodic send completed with some failures, removed from queue and persisted per-integration", {
               data: { eventCount: eventsToSend.length, failedCount }
             });
           }
         } else {
-          log("warn", "Periodic send complete failure, events kept in queue for retry", {
+          log("debug", "Periodic send complete failure, events kept in queue for retry", {
             data: { eventCount: eventsToSend.length }
           });
         }
@@ -3400,7 +3520,7 @@ var init_event_manager = __esm({
           type: data.type,
           page_url: currentPageUrl,
           timestamp,
-          ...isSessionStart && { referrer: document.referrer || "Direct" },
+          ...isSessionStart && { referrer: this.getExternalReferrer() },
           ...data.from_page_url && { from_page_url: data.from_page_url },
           ...data.scroll_data && { scroll_data: data.scroll_data },
           ...data.click_data && { click_data: data.click_data },
@@ -3408,6 +3528,7 @@ var init_event_manager = __esm({
           ...data.web_vitals && { web_vitals: data.web_vitals },
           ...data.error_data && { error_data: data.error_data },
           ...data.viewport_data && { viewport_data: data.viewport_data },
+          ...data.page_view && { page_view: data.page_view },
           ...isSessionStart && getUTMParameters() && { utm: getUTMParameters() }
         };
         const collectApiUrls = this.get("collectApiUrls");
@@ -3441,7 +3562,7 @@ var init_event_manager = __esm({
         if (this.recentEventFingerprints.size > MAX_FINGERPRINTS_HARD_LIMIT) {
           this.recentEventFingerprints.clear();
           this.recentEventFingerprints.set(fingerprint, now);
-          log("warn", "Event fingerprint cache exceeded hard limit, cleared", {
+          log("debug", "Event fingerprint cache exceeded hard limit, cleared", {
             data: { hardLimit: MAX_FINGERPRINTS_HARD_LIMIT }
           });
         }
@@ -3761,6 +3882,60 @@ var init_event_manager = __esm({
           log("warn", "Failed to cleanup expired session counts", { error });
         }
       }
+      /**
+       * Returns the referrer if it's external, or 'Direct' if internal/empty.
+       *
+       * **Purpose**: Filter out internal referrers (same domain) to ensure
+       * accurate traffic source attribution. Internal referrers occur when:
+       * - Session expires and user navigates within the same site
+       * - User opens new tab from an internal link
+       * - Page refresh after session timeout
+       *
+       * **Logic**:
+       * - Empty referrer → 'Direct'
+       * - Referrer from same domain or subdomain → 'Direct' (internal navigation)
+       * - External referrer → Returns original referrer
+       *
+       * **Subdomain Detection**:
+       * - `www.example.com` → `example.com` ✓ (internal)
+       * - `blog.example.com` → `example.com` ✓ (internal)
+       * - `example.com` → `www.example.com` ✓ (internal)
+       *
+       * @returns External referrer URL or 'Direct'
+       *
+       * @internal
+       */
+      getExternalReferrer() {
+        const referrer = document.referrer;
+        if (!referrer) {
+          return "Direct";
+        }
+        try {
+          const referrerHostname = new URL(referrer).hostname.toLowerCase();
+          const currentHostname = window.location.hostname.toLowerCase();
+          if (this.isSameDomain(referrerHostname, currentHostname)) {
+            return "Direct";
+          }
+          return referrer;
+        } catch {
+          return referrer || "Direct";
+        }
+      }
+      /**
+       * Checks if two hostnames belong to the same domain (including subdomains).
+       *
+       * @param hostname1 - First hostname (e.g., 'www.example.com')
+       * @param hostname2 - Second hostname (e.g., 'example.com')
+       * @returns true if same domain or subdomain relationship exists
+       *
+       * @internal
+       */
+      isSameDomain(hostname1, hostname2) {
+        if (hostname1 === hostname2) {
+          return true;
+        }
+        return hostname1.endsWith(`.${hostname2}`) || hostname2.endsWith(`.${hostname1}`);
+      }
       /**
        * Persists current session event counts to localStorage (debounced).
        *
@@ -3879,7 +4054,7 @@ var init_session_manager = __esm({
       }
       initCrossTabSync() {
         if (typeof BroadcastChannel === "undefined") {
-          log("warn", "BroadcastChannel not supported");
+          log("debug", "BroadcastChannel not supported");
           return;
         }
         const projectId = this.getProjectId();
@@ -4027,7 +4202,7 @@ var init_session_manager = __esm({
        */
       startTracking() {
         if (this.isTracking) {
-          log("warn", "Session tracking already active");
+          log("debug", "Session tracking already active");
           return;
         }
         const recoveredSessionId = this.recoverSession();
@@ -4250,7 +4425,7 @@ var init_session_handler = __esm({
           return;
         }
         if (this.destroyed) {
-          log("warn", "Cannot start tracking on destroyed handler");
+          log("debug", "Cannot start tracking on destroyed handler");
           return;
         }
         const config = this.get("config");
@@ -4486,7 +4661,7 @@ var init_click_handler = __esm({
           const target = mouseEvent.target;
           const clickedElement = typeof HTMLElement !== "undefined" && target instanceof HTMLElement ? target : typeof HTMLElement !== "undefined" && target instanceof Node && target.parentElement instanceof HTMLElement ? target.parentElement : null;
           if (!clickedElement) {
-            log("warn", "Click target not found or not an element");
+            log("debug", "Click target not found or not an element");
             return;
           }
           if (this.shouldIgnoreElement(clickedElement)) {
@@ -4648,7 +4823,7 @@ var init_click_handler = __esm({
               return parent;
             }
           } catch (error) {
-            log("warn", "Invalid selector in element search", { error, data: { selector } });
+            log("debug", "Invalid selector in element search", { error, data: { selector } });
             continue;
           }
         }
@@ -5030,7 +5205,7 @@ var init_scroll_handler = __esm({
           return;
         }
         this.limitWarningLogged = true;
-        log("warn", "Max scroll events per session reached", {
+        log("debug", "Max scroll events per session reached", {
           data: { limit: this.maxEventsPerSession }
         });
       }
@@ -5115,7 +5290,7 @@ var init_scroll_handler = __esm({
         } else {
           const element = document.querySelector(selector);
           if (!(element instanceof HTMLElement)) {
-            log("warn", `Selector "${selector}" did not match an HTMLElement`);
+            log("debug", `Selector "${selector}" did not match an HTMLElement`);
             return;
           }
           targetElement = element;
@@ -5168,15 +5343,15 @@ var init_viewport_handler = __esm({
         const threshold = this.config.threshold ?? 0.5;
         const minDwellTime = this.config.minDwellTime ?? 1e3;
         if (threshold < 0 || threshold > 1) {
-          log("warn", "ViewportHandler: Invalid threshold, must be between 0 and 1");
+          log("debug", "ViewportHandler: Invalid threshold, must be between 0 and 1");
           return;
         }
         if (minDwellTime < 0) {
-          log("warn", "ViewportHandler: Invalid minDwellTime, must be non-negative");
+          log("debug", "ViewportHandler: Invalid minDwellTime, must be non-negative");
           return;
         }
         if (typeof IntersectionObserver === "undefined") {
-          log("warn", "ViewportHandler: IntersectionObserver not supported in this browser");
+          log("debug", "ViewportHandler: IntersectionObserver not supported in this browser");
           return;
         }
         this.observer = new IntersectionObserver(this.handleIntersection, {
@@ -5220,7 +5395,7 @@ var init_viewport_handler = __esm({
             const elements = document.querySelectorAll(elementConfig.selector);
             for (const element of Array.from(elements)) {
               if (totalTracked >= maxTrackedElements) {
-                log("warn", "ViewportHandler: Maximum tracked elements reached", {
+                log("debug", "ViewportHandler: Maximum tracked elements reached", {
                   data: {
                     limit: maxTrackedElements,
                     selector: elementConfig.selector,
@@ -5248,7 +5423,7 @@ var init_viewport_handler = __esm({
               totalTracked++;
             }
           } catch (error) {
-            log("warn", `ViewportHandler: Invalid selector "${elementConfig.selector}"`, { error });
+            log("debug", `ViewportHandler: Invalid selector "${elementConfig.selector}"`, { error });
           }
         }
         log("debug", "ViewportHandler: Elements tracked", {
@@ -5328,7 +5503,7 @@ var init_viewport_handler = __esm({
           return;
         }
         if (!document.body) {
-          log("warn", "ViewportHandler: document.body not available, skipping MutationObserver setup");
+          log("debug", "ViewportHandler: document.body not available, skipping MutationObserver setup");
           return;
         }
         this.mutationObserver = new MutationObserver((mutations) => {
@@ -5403,10 +5578,10 @@ var init_storage_manager = __esm({
         this.storage = this.initializeStorage("localStorage");
         this.sessionStorageRef = this.initializeStorage("sessionStorage");
         if (!this.storage) {
-          log("warn", "localStorage not available, using memory fallback");
+          log("debug", "localStorage not available, using memory fallback");
         }
         if (!this.sessionStorageRef) {
-          log("warn", "sessionStorage not available, using memory fallback");
+          log("debug", "sessionStorage not available, using memory fallback");
         }
       }
       /**
@@ -5792,7 +5967,7 @@ var init_performance_handler = __esm({
           try {
             obs.disconnect();
           } catch (error) {
-            log("warn", "Failed to disconnect performance observer", { error, data: { observerIndex: index } });
+            log("debug", "Failed to disconnect performance observer", { error, data: { observerIndex: index } });
           }
         });
         this.observers.length = 0;
@@ -5877,7 +6052,7 @@ var init_performance_handler = __esm({
           onTTFB(report("TTFB"), { reportAllChanges: false });
           onINP(report("INP"), { reportAllChanges: false });
         } catch (error) {
-          log("warn", "Failed to load web-vitals library, using fallback", { error });
+          log("debug", "Failed to load web-vitals library, using fallback", { error });
           this.observeWebVitalsFallback();
         }
       }
@@ -5892,7 +6067,7 @@ var init_performance_handler = __esm({
             this.sendVital({ type: "TTFB", value: Number(ttfb.toFixed(PRECISION_TWO_DECIMALS)) });
           }
         } catch (error) {
-          log("warn", "Failed to report TTFB", { error });
+          log("debug", "Failed to report TTFB", { error });
         }
       }
       observeLongTasks() {
@@ -5942,7 +6117,7 @@ var init_performance_handler = __esm({
       }
       trackWebVital(type, value) {
         if (!Number.isFinite(value)) {
-          log("warn", "Invalid web vital value", { data: { type, value } });
+          log("debug", "Invalid web vital value", { data: { type, value } });
           return;
         }
         this.eventManager.track({
@@ -5985,7 +6160,7 @@ var init_performance_handler = __esm({
           const baseId = `${timestamp.toFixed(2)}_${window.location.pathname}`;
           return counter > 1 ? `${baseId}_${counter}` : baseId;
         } catch (error) {
-          log("warn", "Failed to get navigation ID", { error });
+          log("debug", "Failed to get navigation ID", { error });
           return null;
         }
       }
@@ -6003,7 +6178,7 @@ var init_performance_handler = __esm({
             try {
               cb(list, observer);
             } catch (callbackError) {
-              log("warn", "Observer callback failed", {
+              log("debug", "Observer callback failed", {
                 error: callbackError,
                 data: { type }
               });
@@ -6021,7 +6196,7 @@ var init_performance_handler = __esm({
           }
           return true;
         } catch (error) {
-          log("warn", "Failed to create performance observer", {
+          log("debug", "Failed to create performance observer", {
             error,
             data: { type }
           });
@@ -6030,7 +6205,7 @@ var init_performance_handler = __esm({
       }
       shouldSendVital(type, value) {
         if (typeof value !== "number" || !Number.isFinite(value)) {
-          log("warn", "Invalid web vital value", { data: { type, value } });
+          log("debug", "Invalid web vital value", { data: { type, value } });
           return false;
         }
         const threshold = this.vitalThresholds[type];
@@ -6102,7 +6277,7 @@ var init_error_handler = __esm({
         this.errorBurstCounter++;
         if (this.errorBurstCounter > ERROR_BURST_THRESHOLD) {
           this.burstBackoffUntil = now + ERROR_BURST_BACKOFF_MS;
-          log("warn", "Error burst detected - entering cooldown", {
+          log("debug", "Error burst detected - entering cooldown", {
             data: {
               errorsInWindow: this.errorBurstCounter,
               cooldownMs: ERROR_BURST_BACKOFF_MS
@@ -6357,13 +6532,13 @@ var init_app = __esm({
         this.set("userId", userId);
         const collectApiUrls = getCollectApiUrls(config);
         this.set("collectApiUrls", collectApiUrls);
-        const device = getDeviceType();
+        const device = getDeviceInfo();
         this.set("device", device);
         const pageUrl = normalizeUrl(window.location.href, config.sensitiveQueryParams);
         this.set("pageUrl", pageUrl);
-        const mode = detectQaMode() ? "qa" /* QA */ : void 0;
-        if (mode) {
-          this.set("mode", mode);
+        const isQaMode = detectQaMode();
+        if (isQaMode) {
+          this.set("mode", "qa" /* QA */);
         }
       }
       /**
@@ -6509,7 +6684,7 @@ var init_test_bridge = __esm({
   "src/test-bridge.ts"() {
     init_app();
     init_api();
-    init_qa_mode_utils();
+    init_mode_utils();
     TestBridge = class extends App {
       constructor() {
         super();
@@ -6986,7 +7161,7 @@ var init_api = __esm({
         }
       }).catch(() => {
       });
-      void Promise.resolve().then(() => (init_qa_mode_utils(), qa_mode_utils_exports)).then((module) => {
+      void Promise.resolve().then(() => (init_mode_utils(), mode_utils_exports)).then((module) => {
         if (typeof module.detectQaMode === "function") {
           module.detectQaMode();
         }