@tracelog/lib 0.11.5 → 0.12.1

package/dist/public-api.d.mts

@@ -58,60 +58,6 @@ interface ViewportConfig {
     maxTrackedElements?: number;
 }
 
-interface Config {
-    /** Session inactivity timeout in milliseconds. @default 900000 */
-    sessionTimeout?: number;
-    /** Metadata appended to every tracked event. */
-    globalMetadata?: Record<string, MetadataType>;
-    /** Query parameters to remove before tracking URLs. */
-    sensitiveQueryParams?: string[];
-    /** Error event sampling rate between 0 and 1. @default 1 */
-    errorSampling?: number;
-    /** Event sampling rate between 0 and 1. @default 1 */
-    samplingRate?: number;
-    /** CSS selector to manually override primary scroll container detection. */
-    primaryScrollSelector?: string;
-    /** Viewport visibility tracking configuration. */
-    viewport?: ViewportConfig;
-    /** Page view throttle duration in milliseconds to prevent rapid navigation spam. @default 1000 */
-    pageViewThrottleMs?: number;
-    /** Click throttle duration in milliseconds to prevent double-clicks and rapid spam. @default 300 */
-    clickThrottleMs?: number;
-    /** Maximum number of same custom event name allowed per minute to prevent infinite loops. @default 60 */
-    maxSameEventPerMinute?: number;
-    /** Optional configuration for third-party integrations. */
-    integrations?: {
-        /** TraceLog integration options. */
-        tracelog?: {
-            /** Required project ID TraceLog SaaS integration. */
-            projectId: string;
-        };
-        /** Custom integration options. */
-        custom?: {
-            /** Endpoint for collecting events. */
-            collectApiUrl: string;
-            /** Allow HTTP URLs (not recommended for production). @default false */
-            allowHttp?: boolean;
-        };
-        /** Google Analytics integration options. */
-        googleAnalytics?: {
-            /** Required measurement ID for Google Analytics. */
-            measurementId: string;
-        };
-    };
-}
-declare enum SpecialApiUrl {
-    Localhost = "localhost:8080",
-    Fail = "localhost:9999"
-}
-
-declare enum DeviceType {
-    Mobile = "mobile",
-    Tablet = "tablet",
-    Desktop = "desktop",
-    Unknown = "unknown"
-}
-
 type SessionEndReason = 'inactivity' | 'page_unload' | 'manual_stop' | 'orphaned_cleanup' | 'tab_closed';
 
 /**
@@ -347,6 +293,79 @@ interface EventData {
     utm?: UTM;
 }
 
+/**
+ * Web Vitals filtering mode
+ * - 'all': Track all Web Vitals metrics (full analytics)
+ * - 'needs-improvement': Track metrics that need improvement or are poor (default, balanced)
+ * - 'poor': Track only poor metrics (minimal data)
+ */
+type WebVitalsMode = 'all' | 'needs-improvement' | 'poor';
+interface Config {
+    /** Session inactivity timeout in milliseconds. @default 900000 */
+    sessionTimeout?: number;
+    /** Metadata appended to every tracked event. */
+    globalMetadata?: Record<string, MetadataType>;
+    /** Query parameters to remove before tracking URLs. */
+    sensitiveQueryParams?: string[];
+    /** Error event sampling rate between 0 and 1. @default 1 */
+    errorSampling?: number;
+    /** Event sampling rate between 0 and 1. @default 1 */
+    samplingRate?: number;
+    /** CSS selector to manually override primary scroll container detection. */
+    primaryScrollSelector?: string;
+    /** Viewport visibility tracking configuration. */
+    viewport?: ViewportConfig;
+    /** Page view throttle duration in milliseconds to prevent rapid navigation spam. @default 1000 */
+    pageViewThrottleMs?: number;
+    /** Click throttle duration in milliseconds to prevent double-clicks and rapid spam. @default 300 */
+    clickThrottleMs?: number;
+    /** Maximum number of same custom event name allowed per minute to prevent infinite loops. @default 60 */
+    maxSameEventPerMinute?: number;
+    /**
+     * Web Vitals filtering mode. @default 'needs-improvement'
+     * - 'all': Track all metrics (good, needs-improvement, poor) - full trend analysis
+     * - 'needs-improvement': Track metrics that need improvement or are poor - balanced approach
+     * - 'poor': Track only poor metrics - minimal data, focus on problems
+     */
+    webVitalsMode?: WebVitalsMode;
+    /**
+     * Custom Web Vitals thresholds in milliseconds (except CLS which is unitless).
+     * Only applies when webVitalsMode is set. Overrides default thresholds for the selected mode.
+     */
+    webVitalsThresholds?: Partial<Record<WebVitalType, number>>;
+    /** Optional configuration for third-party integrations. */
+    integrations?: {
+        /** TraceLog integration options. */
+        tracelog?: {
+            /** Required project ID TraceLog SaaS integration. */
+            projectId: string;
+        };
+        /** Custom integration options. */
+        custom?: {
+            /** Endpoint for collecting events. */
+            collectApiUrl: string;
+            /** Allow HTTP URLs (not recommended for production). @default false */
+            allowHttp?: boolean;
+        };
+        /** Google Analytics integration options. */
+        googleAnalytics?: {
+            /** Required measurement ID for Google Analytics. */
+            measurementId: string;
+        };
+    };
+}
+declare enum SpecialApiUrl {
+    Localhost = "localhost:8080",
+    Fail = "localhost:9999"
+}
+
+declare enum DeviceType {
+    Mobile = "mobile",
+    Tablet = "tablet",
+    Desktop = "desktop",
+    Unknown = "unknown"
+}
+
 interface EventsQueue {
     user_id: string;
     session_id: string;
@@ -407,8 +426,8 @@ type SecondaryScrollEvent = EventData & {
         is_primary: false;
     };
 };
-declare function isPrimaryScrollEvent(event: EventData): event is PrimaryScrollEvent;
-declare function isSecondaryScrollEvent(event: EventData): event is SecondaryScrollEvent;
+declare const isPrimaryScrollEvent: (event: EventData) => event is PrimaryScrollEvent;
+declare const isSecondaryScrollEvent: (event: EventData) => event is SecondaryScrollEvent;
 
 interface State {
     mode?: Mode;
@@ -657,7 +676,7 @@ declare class PerformanceHandler extends StateManager {
     private readonly reportedByNav;
     private readonly navigationHistory;
     private readonly observers;
-    private readonly vitalThresholds;
+    private vitalThresholds;
     private lastLongTaskSentAt;
     constructor(eventManager: EventManager);
     startTracking(): Promise<void>;
@@ -812,6 +831,11 @@ declare global {
     }
 }
 
+/**
+ * Consolidated configuration constants for TraceLog
+ * This file centralizes all timing, limits, browser, and initialization constants
+ */
+declare const DEFAULT_SESSION_TIMEOUT: number;
 declare const MAX_CUSTOM_EVENT_NAME_LENGTH = 120;
 declare const MAX_CUSTOM_EVENT_STRING_SIZE: number;
 declare const MAX_CUSTOM_EVENT_KEYS = 10;
@@ -822,12 +846,50 @@ declare const MAX_STRING_LENGTH = 1000;
 declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
 declare const MAX_ARRAY_LENGTH = 100;
 
-declare const PERFORMANCE_CONFIG: {
-    readonly WEB_VITALS_THRESHOLDS: Record<WebVitalType, number>;
-};
-declare const DATA_PROTECTION: {
-    readonly PII_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
-};
+/**
+ * Performance monitoring and web vitals constants for TraceLog
+ * Centralizes thresholds and configuration for performance tracking
+ */
+
+/**
+ * Web Vitals "good" thresholds (75th percentile boundaries)
+ * Metrics below or equal to these values are considered good performance.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_GOOD_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Web Vitals "needs improvement" thresholds
+ * Metrics exceeding these values need attention but aren't critically poor.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Web Vitals "poor" thresholds
+ * Metrics exceeding these values indicate poor performance requiring immediate attention.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_POOR_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Default Web Vitals mode
+ * 'needs-improvement' provides balanced approach - captures metrics that need attention
+ * while filtering out good performance (reduces noise and costs)
+ */
+declare const DEFAULT_WEB_VITALS_MODE: WebVitalsMode;
+/**
+ * Get Web Vitals thresholds for the specified mode
+ */
+declare const getWebVitalsThresholds: (mode?: WebVitalsMode) => Record<WebVitalType, number>;
+
+/**
+ * Error handling and PII sanitization constants for TraceLog
+ * Centralizes patterns and limits for error tracking and data protection
+ */
+/**
+ * Regular expressions for detecting and sanitizing Personally Identifiable Information (PII)
+ * These patterns are used to replace sensitive information with [REDACTED] in error messages
+ */
+declare const PII_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+
 declare const ENGAGEMENT_THRESHOLDS: {
     readonly LOW_ACTIVITY_EVENT_COUNT: 50;
     readonly HIGH_ACTIVITY_EVENT_COUNT: 1000;
@@ -843,18 +905,7 @@ declare const SESSION_ANALYTICS: {
     readonly MEDIUM_SESSION_THRESHOLD_MS: number;
     readonly LONG_SESSION_THRESHOLD_MS: number;
     readonly MAX_REALISTIC_SESSION_DURATION_MS: number;
-};
-declare const DEVICE_ANALYTICS: {
-    readonly MOBILE_MAX_WIDTH: 768;
-    readonly TABLET_MAX_WIDTH: 1024;
-    readonly MOBILE_PERFORMANCE_FACTOR: 1.5;
-    readonly TABLET_PERFORMANCE_FACTOR: 1.2;
-};
-declare const CONTENT_ANALYTICS: {
-    readonly MIN_TEXT_LENGTH_FOR_ANALYSIS: 10;
-    readonly MIN_CLICKS_FOR_HOT_ELEMENT: 10;
-    readonly MIN_SCROLL_COMPLETION_PERCENT: 80;
-    readonly MIN_TIME_ON_PAGE_FOR_READ_MS: number;
+    readonly MIN_EVENTS_FOR_DURATION: 2;
 };
 declare const INSIGHT_THRESHOLDS: {
     readonly SIGNIFICANT_CHANGE_PERCENT: 20;
@@ -866,20 +917,6 @@ declare const INSIGHT_THRESHOLDS: {
     readonly HIGH_ERROR_RATE_PERCENT: 5;
     readonly CRITICAL_ERROR_RATE_PERCENT: 10;
 };
-declare const TEMPORAL_ANALYSIS: {
-    readonly SHORT_TERM_TREND_HOURS: 24;
-    readonly MEDIUM_TERM_TREND_DAYS: 7;
-    readonly LONG_TERM_TREND_DAYS: 30;
-    readonly MIN_DATA_POINTS_FOR_TREND: 5;
-    readonly WEEKLY_PATTERN_MIN_WEEKS: 4;
-    readonly DAILY_PATTERN_MIN_DAYS: 14;
-};
-declare const SEGMENTATION_ANALYTICS: {
-    readonly MIN_SEGMENT_SIZE: 10;
-    readonly MIN_COHORT_SIZE: 5;
-    readonly COHORT_ANALYSIS_DAYS: readonly [1, 3, 7, 14, 30];
-    readonly MIN_FUNNEL_EVENTS: 20;
-};
 declare const ANALYTICS_QUERY_LIMITS: {
     readonly DEFAULT_EVENTS_LIMIT: 5;
     readonly DEFAULT_SESSIONS_LIMIT: 5;
@@ -888,14 +925,6 @@ declare const ANALYTICS_QUERY_LIMITS: {
     readonly MAX_TIME_RANGE_DAYS: 365;
     readonly ANALYTICS_BATCH_SIZE: 1000;
 };
-declare const ANOMALY_DETECTION: {
-    readonly ANOMALY_THRESHOLD_SIGMA: 2.5;
-    readonly STRONG_ANOMALY_THRESHOLD_SIGMA: 3;
-    readonly TRAFFIC_DROP_ALERT_PERCENT: -30;
-    readonly TRAFFIC_SPIKE_ALERT_PERCENT: 200;
-    readonly MIN_BASELINE_DAYS: 7;
-    readonly MIN_EVENTS_FOR_ANOMALY_DETECTION: 50;
-};
 declare const SPECIAL_PAGE_URLS: {
     readonly PAGE_URL_EXCLUDED: "excluded";
     readonly PAGE_URL_UNKNOWN: "unknown";
@@ -908,6 +937,7 @@ declare const tracelog: {
     off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
     isInitialized: () => boolean;
     destroy: () => void;
+    setQaMode: (enabled: boolean) => void;
 };
 
-export { ANALYTICS_QUERY_LIMITS, ANOMALY_DETECTION, AppConfigValidationError, CONTENT_ANALYTICS, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, DATA_PROTECTION, DEVICE_ANALYTICS, DeviceType, ENGAGEMENT_THRESHOLDS, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventsQueue, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, type LogLevel, 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, type MetadataType, Mode, PERFORMANCE_CONFIG, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SEGMENTATION_ANALYTICS, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEndReason, SessionTimeoutValidationError, SpecialApiUrl, type State, TEMPORAL_ANALYSIS, type TraceLogTestBridge, TraceLogValidationError, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, type WebVitalType, type WebVitalsData, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { ANALYTICS_QUERY_LIMITS, AppConfigValidationError, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, DeviceType, ENGAGEMENT_THRESHOLDS, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventsQueue, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, type LogLevel, 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, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEndReason, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };

package/dist/public-api.d.ts

@@ -58,60 +58,6 @@ interface ViewportConfig {
     maxTrackedElements?: number;
 }
 
-interface Config {
-    /** Session inactivity timeout in milliseconds. @default 900000 */
-    sessionTimeout?: number;
-    /** Metadata appended to every tracked event. */
-    globalMetadata?: Record<string, MetadataType>;
-    /** Query parameters to remove before tracking URLs. */
-    sensitiveQueryParams?: string[];
-    /** Error event sampling rate between 0 and 1. @default 1 */
-    errorSampling?: number;
-    /** Event sampling rate between 0 and 1. @default 1 */
-    samplingRate?: number;
-    /** CSS selector to manually override primary scroll container detection. */
-    primaryScrollSelector?: string;
-    /** Viewport visibility tracking configuration. */
-    viewport?: ViewportConfig;
-    /** Page view throttle duration in milliseconds to prevent rapid navigation spam. @default 1000 */
-    pageViewThrottleMs?: number;
-    /** Click throttle duration in milliseconds to prevent double-clicks and rapid spam. @default 300 */
-    clickThrottleMs?: number;
-    /** Maximum number of same custom event name allowed per minute to prevent infinite loops. @default 60 */
-    maxSameEventPerMinute?: number;
-    /** Optional configuration for third-party integrations. */
-    integrations?: {
-        /** TraceLog integration options. */
-        tracelog?: {
-            /** Required project ID TraceLog SaaS integration. */
-            projectId: string;
-        };
-        /** Custom integration options. */
-        custom?: {
-            /** Endpoint for collecting events. */
-            collectApiUrl: string;
-            /** Allow HTTP URLs (not recommended for production). @default false */
-            allowHttp?: boolean;
-        };
-        /** Google Analytics integration options. */
-        googleAnalytics?: {
-            /** Required measurement ID for Google Analytics. */
-            measurementId: string;
-        };
-    };
-}
-declare enum SpecialApiUrl {
-    Localhost = "localhost:8080",
-    Fail = "localhost:9999"
-}
-
-declare enum DeviceType {
-    Mobile = "mobile",
-    Tablet = "tablet",
-    Desktop = "desktop",
-    Unknown = "unknown"
-}
-
 type SessionEndReason = 'inactivity' | 'page_unload' | 'manual_stop' | 'orphaned_cleanup' | 'tab_closed';
 
 /**
@@ -347,6 +293,79 @@ interface EventData {
     utm?: UTM;
 }
 
+/**
+ * Web Vitals filtering mode
+ * - 'all': Track all Web Vitals metrics (full analytics)
+ * - 'needs-improvement': Track metrics that need improvement or are poor (default, balanced)
+ * - 'poor': Track only poor metrics (minimal data)
+ */
+type WebVitalsMode = 'all' | 'needs-improvement' | 'poor';
+interface Config {
+    /** Session inactivity timeout in milliseconds. @default 900000 */
+    sessionTimeout?: number;
+    /** Metadata appended to every tracked event. */
+    globalMetadata?: Record<string, MetadataType>;
+    /** Query parameters to remove before tracking URLs. */
+    sensitiveQueryParams?: string[];
+    /** Error event sampling rate between 0 and 1. @default 1 */
+    errorSampling?: number;
+    /** Event sampling rate between 0 and 1. @default 1 */
+    samplingRate?: number;
+    /** CSS selector to manually override primary scroll container detection. */
+    primaryScrollSelector?: string;
+    /** Viewport visibility tracking configuration. */
+    viewport?: ViewportConfig;
+    /** Page view throttle duration in milliseconds to prevent rapid navigation spam. @default 1000 */
+    pageViewThrottleMs?: number;
+    /** Click throttle duration in milliseconds to prevent double-clicks and rapid spam. @default 300 */
+    clickThrottleMs?: number;
+    /** Maximum number of same custom event name allowed per minute to prevent infinite loops. @default 60 */
+    maxSameEventPerMinute?: number;
+    /**
+     * Web Vitals filtering mode. @default 'needs-improvement'
+     * - 'all': Track all metrics (good, needs-improvement, poor) - full trend analysis
+     * - 'needs-improvement': Track metrics that need improvement or are poor - balanced approach
+     * - 'poor': Track only poor metrics - minimal data, focus on problems
+     */
+    webVitalsMode?: WebVitalsMode;
+    /**
+     * Custom Web Vitals thresholds in milliseconds (except CLS which is unitless).
+     * Only applies when webVitalsMode is set. Overrides default thresholds for the selected mode.
+     */
+    webVitalsThresholds?: Partial<Record<WebVitalType, number>>;
+    /** Optional configuration for third-party integrations. */
+    integrations?: {
+        /** TraceLog integration options. */
+        tracelog?: {
+            /** Required project ID TraceLog SaaS integration. */
+            projectId: string;
+        };
+        /** Custom integration options. */
+        custom?: {
+            /** Endpoint for collecting events. */
+            collectApiUrl: string;
+            /** Allow HTTP URLs (not recommended for production). @default false */
+            allowHttp?: boolean;
+        };
+        /** Google Analytics integration options. */
+        googleAnalytics?: {
+            /** Required measurement ID for Google Analytics. */
+            measurementId: string;
+        };
+    };
+}
+declare enum SpecialApiUrl {
+    Localhost = "localhost:8080",
+    Fail = "localhost:9999"
+}
+
+declare enum DeviceType {
+    Mobile = "mobile",
+    Tablet = "tablet",
+    Desktop = "desktop",
+    Unknown = "unknown"
+}
+
 interface EventsQueue {
     user_id: string;
     session_id: string;
@@ -407,8 +426,8 @@ type SecondaryScrollEvent = EventData & {
         is_primary: false;
     };
 };
-declare function isPrimaryScrollEvent(event: EventData): event is PrimaryScrollEvent;
-declare function isSecondaryScrollEvent(event: EventData): event is SecondaryScrollEvent;
+declare const isPrimaryScrollEvent: (event: EventData) => event is PrimaryScrollEvent;
+declare const isSecondaryScrollEvent: (event: EventData) => event is SecondaryScrollEvent;
 
 interface State {
     mode?: Mode;
@@ -657,7 +676,7 @@ declare class PerformanceHandler extends StateManager {
     private readonly reportedByNav;
     private readonly navigationHistory;
     private readonly observers;
-    private readonly vitalThresholds;
+    private vitalThresholds;
     private lastLongTaskSentAt;
     constructor(eventManager: EventManager);
     startTracking(): Promise<void>;
@@ -812,6 +831,11 @@ declare global {
     }
 }
 
+/**
+ * Consolidated configuration constants for TraceLog
+ * This file centralizes all timing, limits, browser, and initialization constants
+ */
+declare const DEFAULT_SESSION_TIMEOUT: number;
 declare const MAX_CUSTOM_EVENT_NAME_LENGTH = 120;
 declare const MAX_CUSTOM_EVENT_STRING_SIZE: number;
 declare const MAX_CUSTOM_EVENT_KEYS = 10;
@@ -822,12 +846,50 @@ declare const MAX_STRING_LENGTH = 1000;
 declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
 declare const MAX_ARRAY_LENGTH = 100;
 
-declare const PERFORMANCE_CONFIG: {
-    readonly WEB_VITALS_THRESHOLDS: Record<WebVitalType, number>;
-};
-declare const DATA_PROTECTION: {
-    readonly PII_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
-};
+/**
+ * Performance monitoring and web vitals constants for TraceLog
+ * Centralizes thresholds and configuration for performance tracking
+ */
+
+/**
+ * Web Vitals "good" thresholds (75th percentile boundaries)
+ * Metrics below or equal to these values are considered good performance.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_GOOD_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Web Vitals "needs improvement" thresholds
+ * Metrics exceeding these values need attention but aren't critically poor.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Web Vitals "poor" thresholds
+ * Metrics exceeding these values indicate poor performance requiring immediate attention.
+ * Reference: https://web.dev/articles/vitals
+ */
+declare const WEB_VITALS_POOR_THRESHOLDS: Record<WebVitalType, number>;
+/**
+ * Default Web Vitals mode
+ * 'needs-improvement' provides balanced approach - captures metrics that need attention
+ * while filtering out good performance (reduces noise and costs)
+ */
+declare const DEFAULT_WEB_VITALS_MODE: WebVitalsMode;
+/**
+ * Get Web Vitals thresholds for the specified mode
+ */
+declare const getWebVitalsThresholds: (mode?: WebVitalsMode) => Record<WebVitalType, number>;
+
+/**
+ * Error handling and PII sanitization constants for TraceLog
+ * Centralizes patterns and limits for error tracking and data protection
+ */
+/**
+ * Regular expressions for detecting and sanitizing Personally Identifiable Information (PII)
+ * These patterns are used to replace sensitive information with [REDACTED] in error messages
+ */
+declare const PII_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+
 declare const ENGAGEMENT_THRESHOLDS: {
     readonly LOW_ACTIVITY_EVENT_COUNT: 50;
     readonly HIGH_ACTIVITY_EVENT_COUNT: 1000;
@@ -843,18 +905,7 @@ declare const SESSION_ANALYTICS: {
     readonly MEDIUM_SESSION_THRESHOLD_MS: number;
     readonly LONG_SESSION_THRESHOLD_MS: number;
     readonly MAX_REALISTIC_SESSION_DURATION_MS: number;
-};
-declare const DEVICE_ANALYTICS: {
-    readonly MOBILE_MAX_WIDTH: 768;
-    readonly TABLET_MAX_WIDTH: 1024;
-    readonly MOBILE_PERFORMANCE_FACTOR: 1.5;
-    readonly TABLET_PERFORMANCE_FACTOR: 1.2;
-};
-declare const CONTENT_ANALYTICS: {
-    readonly MIN_TEXT_LENGTH_FOR_ANALYSIS: 10;
-    readonly MIN_CLICKS_FOR_HOT_ELEMENT: 10;
-    readonly MIN_SCROLL_COMPLETION_PERCENT: 80;
-    readonly MIN_TIME_ON_PAGE_FOR_READ_MS: number;
+    readonly MIN_EVENTS_FOR_DURATION: 2;
 };
 declare const INSIGHT_THRESHOLDS: {
     readonly SIGNIFICANT_CHANGE_PERCENT: 20;
@@ -866,20 +917,6 @@ declare const INSIGHT_THRESHOLDS: {
     readonly HIGH_ERROR_RATE_PERCENT: 5;
     readonly CRITICAL_ERROR_RATE_PERCENT: 10;
 };
-declare const TEMPORAL_ANALYSIS: {
-    readonly SHORT_TERM_TREND_HOURS: 24;
-    readonly MEDIUM_TERM_TREND_DAYS: 7;
-    readonly LONG_TERM_TREND_DAYS: 30;
-    readonly MIN_DATA_POINTS_FOR_TREND: 5;
-    readonly WEEKLY_PATTERN_MIN_WEEKS: 4;
-    readonly DAILY_PATTERN_MIN_DAYS: 14;
-};
-declare const SEGMENTATION_ANALYTICS: {
-    readonly MIN_SEGMENT_SIZE: 10;
-    readonly MIN_COHORT_SIZE: 5;
-    readonly COHORT_ANALYSIS_DAYS: readonly [1, 3, 7, 14, 30];
-    readonly MIN_FUNNEL_EVENTS: 20;
-};
 declare const ANALYTICS_QUERY_LIMITS: {
     readonly DEFAULT_EVENTS_LIMIT: 5;
     readonly DEFAULT_SESSIONS_LIMIT: 5;
@@ -888,14 +925,6 @@ declare const ANALYTICS_QUERY_LIMITS: {
     readonly MAX_TIME_RANGE_DAYS: 365;
     readonly ANALYTICS_BATCH_SIZE: 1000;
 };
-declare const ANOMALY_DETECTION: {
-    readonly ANOMALY_THRESHOLD_SIGMA: 2.5;
-    readonly STRONG_ANOMALY_THRESHOLD_SIGMA: 3;
-    readonly TRAFFIC_DROP_ALERT_PERCENT: -30;
-    readonly TRAFFIC_SPIKE_ALERT_PERCENT: 200;
-    readonly MIN_BASELINE_DAYS: 7;
-    readonly MIN_EVENTS_FOR_ANOMALY_DETECTION: 50;
-};
 declare const SPECIAL_PAGE_URLS: {
     readonly PAGE_URL_EXCLUDED: "excluded";
     readonly PAGE_URL_UNKNOWN: "unknown";
@@ -908,6 +937,7 @@ declare const tracelog: {
     off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
     isInitialized: () => boolean;
     destroy: () => void;
+    setQaMode: (enabled: boolean) => void;
 };
 
-export { ANALYTICS_QUERY_LIMITS, ANOMALY_DETECTION, AppConfigValidationError, CONTENT_ANALYTICS, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, DATA_PROTECTION, DEVICE_ANALYTICS, DeviceType, ENGAGEMENT_THRESHOLDS, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventsQueue, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, type LogLevel, 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, type MetadataType, Mode, PERFORMANCE_CONFIG, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SEGMENTATION_ANALYTICS, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEndReason, SessionTimeoutValidationError, SpecialApiUrl, type State, TEMPORAL_ANALYSIS, type TraceLogTestBridge, TraceLogValidationError, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, type WebVitalType, type WebVitalsData, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };
+export { ANALYTICS_QUERY_LIMITS, AppConfigValidationError, type ClickCoordinates, type ClickData, type ClickTrackingElementData, type Config, type CustomEventData, DEFAULT_SESSION_TIMEOUT, DEFAULT_WEB_VITALS_MODE, DeviceType, ENGAGEMENT_THRESHOLDS, type EmitterCallback, EmitterEvent, type EmitterMap, type ErrorData, ErrorType, type EventData, EventType, type EventsQueue, INSIGHT_THRESHOLDS, InitializationTimeoutError, IntegrationValidationError, type LogLevel, 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, type MetadataType, Mode, PII_PATTERNS, type PageViewData, PermanentError, type PersistedEventsQueue, type PrimaryScrollEvent, SESSION_ANALYTICS, SPECIAL_PAGE_URLS, SamplingRateValidationError, type ScrollData, ScrollDirection, type SecondaryScrollEvent, type SessionEndReason, SessionTimeoutValidationError, SpecialApiUrl, type State, type TraceLogTestBridge, TraceLogValidationError, type UTM, type ViewportConfig, type ViewportElement, type ViewportEventData, WEB_VITALS_GOOD_THRESHOLDS, WEB_VITALS_NEEDS_IMPROVEMENT_THRESHOLDS, WEB_VITALS_POOR_THRESHOLDS, type WebVitalType, type WebVitalsData, type WebVitalsMode, getWebVitalsThresholds, isPrimaryScrollEvent, isSecondaryScrollEvent, tracelog };