@tracelog/lib 0.11.5 → 0.12.0

package/dist/public-api.cjs

@@ -204,12 +204,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 {
@@ -346,14 +346,59 @@ var SESSION_STORAGE_KEY = (id) => id ? `${STORAGE_BASE_KEY}:${id}: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;
 
@@ -695,6 +740,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) {
@@ -3461,13 +3541,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();
   }
@@ -4285,14 +4372,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,
@@ -4389,7 +4468,7 @@ exports.ANALYTICS_QUERY_LIMITS = ANALYTICS_QUERY_LIMITS;
 exports.ANOMALY_DETECTION = ANOMALY_DETECTION;
 exports.AppConfigValidationError = AppConfigValidationError;
 exports.CONTENT_ANALYTICS = CONTENT_ANALYTICS;
-exports.DATA_PROTECTION = DATA_PROTECTION;
+exports.DEFAULT_WEB_VITALS_MODE = DEFAULT_WEB_VITALS_MODE;
 exports.DEVICE_ANALYTICS = DEVICE_ANALYTICS;
 exports.DeviceType = DeviceType;
 exports.ENGAGEMENT_THRESHOLDS = ENGAGEMENT_THRESHOLDS;
@@ -4409,7 +4488,7 @@ exports.MAX_NESTED_OBJECT_KEYS = MAX_NESTED_OBJECT_KEYS;
 exports.MAX_STRING_LENGTH = MAX_STRING_LENGTH;
 exports.MAX_STRING_LENGTH_IN_ARRAY = MAX_STRING_LENGTH_IN_ARRAY;
 exports.Mode = Mode;
-exports.PERFORMANCE_CONFIG = PERFORMANCE_CONFIG;
+exports.PII_PATTERNS = PII_PATTERNS;
 exports.PermanentError = PermanentError;
 exports.SEGMENTATION_ANALYTICS = SEGMENTATION_ANALYTICS;
 exports.SESSION_ANALYTICS = SESSION_ANALYTICS;
@@ -4420,6 +4499,10 @@ 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;
+exports.WEB_VITALS_POOR_THRESHOLDS = WEB_VITALS_POOR_THRESHOLDS;
+exports.getWebVitalsThresholds = getWebVitalsThresholds;
 exports.isPrimaryScrollEvent = isPrimaryScrollEvent;
 exports.isSecondaryScrollEvent = isSecondaryScrollEvent;
 exports.tracelog = tracelog;