@tracelog/lib 2.0.2 → 2.0.3

package/dist/public-api.d.mts

@@ -390,72 +390,6 @@ interface EventData {
     utm?: UTM;
 }
 
-/**
- * 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;
-declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
-declare const MAX_NESTED_OBJECT_KEYS = 20;
-declare const MAX_METADATA_NESTING_DEPTH = 1;
-declare const MAX_STRING_LENGTH = 1000;
-declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
-declare const MAX_ARRAY_LENGTH = 100;
-
-/**
- * Event types that can be disabled from auto-tracking
- * Core events (PAGE_VIEW, CLICK, SESSION_*) cannot be disabled as they are essential for analytics
- */
-declare const DISABLEABLE_EVENT_TYPES: readonly ["scroll", "web_vitals", "error"];
-type DisabledEventType = (typeof DISABLEABLE_EVENT_TYPES)[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];
-
-/**
- * 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>;
-
 /**
  * Web Vitals filtering mode
  * - 'all': Track all Web Vitals metrics (full analytics)
@@ -496,18 +430,6 @@ interface Config {
      * Only applies when webVitalsMode is set. Overrides default thresholds for the selected mode.
      */
     webVitalsThresholds?: Partial<Record<WebVitalType, number>>;
-    /**
-     * Event types to disable from auto-tracking.
-     * Core events (PAGE_VIEW, CLICK, SESSION_*) cannot be disabled as they are essential for analytics.
-     * @default []
-     * @example
-     * // Disable scroll tracking only
-     * disabledEvents: ['scroll']
-     * @example
-     * // Disable performance and error tracking
-     * disabledEvents: ['web_vitals', 'error']
-     */
-    disabledEvents?: DisabledEventType[];
     /** Optional configuration for third-party integrations. */
     integrations?: {
         /** TraceLog integration options. */
@@ -2434,6 +2356,65 @@ declare global {
 declare function setTransformer(hook: 'beforeSend', fn: BeforeSendTransformer): void;
 declare function setTransformer(hook: 'beforeBatch', fn: BeforeBatchTransformer): void;
 
+/**
+ * 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;
+declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
+declare const MAX_NESTED_OBJECT_KEYS = 20;
+declare const MAX_METADATA_NESTING_DEPTH = 1;
+declare const MAX_STRING_LENGTH = 1000;
+declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
+declare const MAX_ARRAY_LENGTH = 100;
+
+/**
+ * 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];
+
+/**
+ * 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>;
+
 declare const tracelog: {
     init: (config?: Config) => Promise<void>;
     event: (name: string, metadata?: Record<string, MetadataType> | Record<string, MetadataType>[]) => void;

package/dist/public-api.d.ts

@@ -390,72 +390,6 @@ interface EventData {
     utm?: UTM;
 }
 
-/**
- * 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;
-declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
-declare const MAX_NESTED_OBJECT_KEYS = 20;
-declare const MAX_METADATA_NESTING_DEPTH = 1;
-declare const MAX_STRING_LENGTH = 1000;
-declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
-declare const MAX_ARRAY_LENGTH = 100;
-
-/**
- * Event types that can be disabled from auto-tracking
- * Core events (PAGE_VIEW, CLICK, SESSION_*) cannot be disabled as they are essential for analytics
- */
-declare const DISABLEABLE_EVENT_TYPES: readonly ["scroll", "web_vitals", "error"];
-type DisabledEventType = (typeof DISABLEABLE_EVENT_TYPES)[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];
-
-/**
- * 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>;
-
 /**
  * Web Vitals filtering mode
  * - 'all': Track all Web Vitals metrics (full analytics)
@@ -496,18 +430,6 @@ interface Config {
      * Only applies when webVitalsMode is set. Overrides default thresholds for the selected mode.
      */
     webVitalsThresholds?: Partial<Record<WebVitalType, number>>;
-    /**
-     * Event types to disable from auto-tracking.
-     * Core events (PAGE_VIEW, CLICK, SESSION_*) cannot be disabled as they are essential for analytics.
-     * @default []
-     * @example
-     * // Disable scroll tracking only
-     * disabledEvents: ['scroll']
-     * @example
-     * // Disable performance and error tracking
-     * disabledEvents: ['web_vitals', 'error']
-     */
-    disabledEvents?: DisabledEventType[];
     /** Optional configuration for third-party integrations. */
     integrations?: {
         /** TraceLog integration options. */
@@ -2434,6 +2356,65 @@ declare global {
 declare function setTransformer(hook: 'beforeSend', fn: BeforeSendTransformer): void;
 declare function setTransformer(hook: 'beforeBatch', fn: BeforeBatchTransformer): void;
 
+/**
+ * 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;
+declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
+declare const MAX_NESTED_OBJECT_KEYS = 20;
+declare const MAX_METADATA_NESTING_DEPTH = 1;
+declare const MAX_STRING_LENGTH = 1000;
+declare const MAX_STRING_LENGTH_IN_ARRAY = 500;
+declare const MAX_ARRAY_LENGTH = 100;
+
+/**
+ * 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];
+
+/**
+ * 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>;
+
 declare const tracelog: {
     init: (config?: Config) => Promise<void>;
     event: (name: string, metadata?: Record<string, MetadataType> | Record<string, MetadataType>[]) => void;

package/dist/public-api.js

@@ -533,14 +533,6 @@ var init_app_constants = __esm({
   }
 });
 
-// src/constants/disabled-events.constants.ts
-var DISABLEABLE_EVENT_TYPES;
-var init_disabled_events_constants = __esm({
-  "src/constants/disabled-events.constants.ts"() {
-    DISABLEABLE_EVENT_TYPES = ["scroll", "web_vitals", "error"];
-  }
-});
-
 // src/constants/error.constants.ts
 var PII_PATTERNS, MAX_ERROR_MESSAGE_LENGTH, ERROR_SUPPRESSION_WINDOW_MS, MAX_TRACKED_ERRORS, MAX_TRACKED_ERRORS_HARD_LIMIT, DEFAULT_ERROR_SAMPLING_RATE, ERROR_BURST_WINDOW_MS, ERROR_BURST_THRESHOLD, ERROR_BURST_BACKOFF_MS, PERMANENT_ERROR_LOG_THROTTLE_MS;
 var init_error_constants = __esm({
@@ -639,7 +631,7 @@ var init_performance_constants = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "2.0.1";
+    version = "2.0.2";
   }
 });
 
@@ -657,7 +649,6 @@ var init_constants = __esm({
   "src/constants/index.ts"() {
     init_app_constants();
     init_config_constants();
-    init_disabled_events_constants();
     init_error_constants();
     init_storage_constants();
     init_performance_constants();
@@ -1109,30 +1100,6 @@ var init_config_validations_utils = __esm({
       if (config.viewport !== void 0) {
         validateViewportConfig(config.viewport);
       }
-      if (config.disabledEvents !== void 0) {
-        if (!Array.isArray(config.disabledEvents)) {
-          throw new AppConfigValidationError("disabledEvents must be an array", "config");
-        }
-        const uniqueEvents = /* @__PURE__ */ new Set();
-        for (const eventType of config.disabledEvents) {
-          if (typeof eventType !== "string") {
-            throw new AppConfigValidationError("All disabled event types must be strings", "config");
-          }
-          if (!DISABLEABLE_EVENT_TYPES.includes(eventType)) {
-            throw new AppConfigValidationError(
-              `Invalid disabled event type: "${eventType}". Must be one of: ${DISABLEABLE_EVENT_TYPES.join(", ")}`,
-              "config"
-            );
-          }
-          if (uniqueEvents.has(eventType)) {
-            throw new AppConfigValidationError(
-              `Duplicate disabled event type found: "${eventType}". Each event type should appear only once.`,
-              "config"
-            );
-          }
-          uniqueEvents.add(eventType);
-        }
-      }
       if (config.webVitalsMode !== void 0) {
         if (typeof config.webVitalsMode !== "string") {
           throw new AppConfigValidationError(
@@ -1260,8 +1227,7 @@ var init_config_validations_utils = __esm({
         samplingRate: config?.samplingRate ?? DEFAULT_SAMPLING_RATE,
         pageViewThrottleMs: config?.pageViewThrottleMs ?? DEFAULT_PAGE_VIEW_THROTTLE_MS,
         clickThrottleMs: config?.clickThrottleMs ?? DEFAULT_CLICK_THROTTLE_MS,
-        maxSameEventPerMinute: config?.maxSameEventPerMinute ?? MAX_SAME_EVENT_PER_MINUTE,
-        disabledEvents: config?.disabledEvents ?? []
+        maxSameEventPerMinute: config?.maxSameEventPerMinute ?? MAX_SAME_EVENT_PER_MINUTE
       };
       if (normalizedConfig.integrations?.custom) {
         normalizedConfig.integrations.custom = {
@@ -6495,7 +6461,6 @@ var init_app = __esm({
       }
       initializeHandlers() {
         const config = this.get("config");
-        const disabledEvents = config.disabledEvents ?? [];
         this.handlers.session = new SessionHandler(
           this.managers.storage,
           this.managers.event
@@ -6514,20 +6479,14 @@ var init_app = __esm({
         this.handlers.pageView.startTracking();
         this.handlers.click = new ClickHandler(this.managers.event);
         this.handlers.click.startTracking();
-        if (!disabledEvents.includes("scroll")) {
-          this.handlers.scroll = new ScrollHandler(this.managers.event);
-          this.handlers.scroll.startTracking();
-        }
-        if (!disabledEvents.includes("web_vitals")) {
-          this.handlers.performance = new PerformanceHandler(this.managers.event);
-          this.handlers.performance.startTracking().catch((error) => {
-            log("warn", "Failed to start performance tracking", { error });
-          });
-        }
-        if (!disabledEvents.includes("error")) {
-          this.handlers.error = new ErrorHandler(this.managers.event);
-          this.handlers.error.startTracking();
-        }
+        this.handlers.scroll = new ScrollHandler(this.managers.event);
+        this.handlers.scroll.startTracking();
+        this.handlers.performance = new PerformanceHandler(this.managers.event);
+        this.handlers.performance.startTracking().catch((error) => {
+          log("warn", "Failed to start performance tracking", { error });
+        });
+        this.handlers.error = new ErrorHandler(this.managers.event);
+        this.handlers.error.startTracking();
         if (config.viewport) {
           this.handlers.viewport = new ViewportHandler(this.managers.event);
           this.handlers.viewport.startTracking();