@tracelog/lib 0.5.5 → 0.6.1

package/dist/cjs/api.d.ts

@@ -1,8 +1,18 @@
-import { MetadataType, AppConfig, EmitterCallback, EmitterMap } from './types';
+import { App } from './app';
+import { MetadataType, Config, EmitterCallback, EmitterMap } from './types';
 import './types/window.types';
-export declare const init: (appConfig: AppConfig) => Promise<void>;
+export declare const init: (config: Config) => Promise<void>;
 export declare const event: (name: string, metadata?: Record<string, MetadataType> | Record<string, MetadataType>[]) => void;
 export declare const on: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
 export declare const off: <K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>) => void;
 export declare const isInitialized: () => boolean;
 export declare const destroy: () => Promise<void>;
+/**
+ * Internal sync function - ONLY for TestBridge in development
+ *
+ * WARNING: This function is internal and should NEVER be called directly.
+ * It's only exported for TestBridge synchronization in dev mode.
+ *
+ * @internal
+ */
+export declare const __setAppInstance: (instance: App | null) => void;

package/dist/cjs/api.js

@@ -1,51 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.destroy = exports.isInitialized = exports.off = exports.on = exports.event = exports.init = void 0;
+exports.__setAppInstance = exports.destroy = exports.isInitialized = exports.off = exports.on = exports.event = exports.init = void 0;
 const app_1 = require("./app");
 const utils_1 = require("./utils");
 const test_bridge_1 = require("./test-bridge");
+const constants_1 = require("./constants");
 require("./types/window.types");
+// Buffer for listeners registered before init()
+const pendingListeners = [];
 let app = null;
 let isInitializing = false;
 let isDestroying = false;
-const init = async (appConfig) => {
+const init = async (config) => {
     if (typeof window === 'undefined' || typeof document === 'undefined') {
-        throw new Error('This library can only be used in a browser environment');
+        throw new Error('[TraceLog] This library can only be used in a browser environment');
     }
     if (window.__traceLogDisabled) {
         return;
     }
     if (app) {
-        utils_1.debugLog.debug('API', 'Library already initialized, skipping duplicate initialization');
         return;
     }
     if (isInitializing) {
-        utils_1.debugLog.warn('API', 'Initialization already in progress');
-        throw new Error('Initialization already in progress');
+        return;
     }
     isInitializing = true;
     try {
-        utils_1.debugLog.info('API', 'Initializing TraceLog', { projectId: appConfig.id });
-        const validatedConfig = (0, utils_1.validateAndNormalizeConfig)(appConfig);
+        const validatedConfig = (0, utils_1.validateAndNormalizeConfig)(config);
         const instance = new app_1.App();
         try {
-            await instance.init(validatedConfig);
+            // Attach buffered listeners BEFORE init() so they capture initial events
+            pendingListeners.forEach(({ event, callback }) => {
+                instance.on(event, callback);
+            });
+            pendingListeners.length = 0;
+            // Wrap initialization with timeout using Promise.race
+            const initPromise = instance.init(validatedConfig);
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`[TraceLog] Initialization timeout after ${constants_1.INITIALIZATION_TIMEOUT_MS}ms`));
+                }, constants_1.INITIALIZATION_TIMEOUT_MS);
+            });
+            await Promise.race([initPromise, timeoutPromise]);
             app = instance;
-            utils_1.debugLog.info('API', 'TraceLog initialized successfully', { projectId: validatedConfig.id });
         }
         catch (error) {
             try {
                 await instance.destroy(true);
             }
             catch (cleanupError) {
-                utils_1.debugLog.warn('API', 'Failed to cleanup partially initialized app', { cleanupError });
+                (0, utils_1.log)('error', 'Failed to cleanup partially initialized app', { error: cleanupError });
             }
             throw error;
         }
     }
     catch (error) {
         app = null;
-        utils_1.debugLog.error('API', 'Initialization failed', { error });
         throw error;
     }
     finally {
@@ -55,27 +65,31 @@ const init = async (appConfig) => {
 exports.init = init;
 const event = (name, metadata) => {
     if (!app) {
-        throw new Error('TraceLog not initialized. Please call init() first.');
-    }
-    try {
-        app.sendCustomEvent(name, metadata);
+        throw new Error('[TraceLog] TraceLog not initialized. Please call init() first.');
     }
-    catch (error) {
-        utils_1.debugLog.error('API', 'Failed to send custom event', { eventName: name, error });
-        throw error;
+    if (isDestroying) {
+        throw new Error('[TraceLog] Cannot send events while TraceLog is being destroyed');
     }
+    app.sendCustomEvent(name, metadata);
 };
 exports.event = event;
 const on = (event, callback) => {
-    if (!app) {
-        throw new Error('TraceLog not initialized. Please call init() first.');
+    if (!app || isInitializing) {
+        // Buffer listeners registered before or during init()
+        pendingListeners.push({ event, callback });
+        return;
     }
     app.on(event, callback);
 };
 exports.on = on;
 const off = (event, callback) => {
     if (!app) {
-        throw new Error('TraceLog not initialized. Please call init() first.');
+        // Remove from pending listeners if not yet initialized
+        const index = pendingListeners.findIndex((l) => l.event === event && l.callback === callback);
+        if (index !== -1) {
+            pendingListeners.splice(index, 1);
+        }
+        return;
     }
     app.off(event, callback);
 };
@@ -86,25 +100,30 @@ const isInitialized = () => {
 exports.isInitialized = isInitialized;
 const destroy = async () => {
     if (!app) {
-        throw new Error('App not initialized');
+        throw new Error('[TraceLog] App not initialized');
     }
     if (isDestroying) {
-        throw new Error('Destroy operation already in progress');
+        throw new Error('[TraceLog] Destroy operation already in progress');
     }
     isDestroying = true;
     try {
-        utils_1.debugLog.info('API', 'Destroying TraceLog instance');
         await app.destroy();
         app = null;
         isInitializing = false;
-        utils_1.debugLog.info('API', 'TraceLog destroyed successfully');
+        pendingListeners.length = 0;
+        // Clear TestBridge reference in dev mode to prevent stale references
+        if (process.env.NODE_ENV === 'dev' && typeof window !== 'undefined' && window.__traceLogBridge) {
+            // Don't call destroy on bridge (would cause recursion), just clear reference
+            window.__traceLogBridge = undefined;
+        }
     }
     catch (error) {
-        // Force cleanup even if destroy fails
         app = null;
         isInitializing = false;
-        utils_1.debugLog.error('API', 'Error during destroy, forced cleanup', { error });
-        throw error;
+        pendingListeners.length = 0;
+        // Log error but don't re-throw - destroy should always complete successfully
+        // Applications should be able to tear down TraceLog even if internal cleanup fails
+        (0, utils_1.log)('warn', 'Error during destroy, forced cleanup completed', { error });
     }
     finally {
         isDestroying = false;
@@ -122,3 +141,29 @@ if (process.env.NODE_ENV === 'dev' && typeof window !== 'undefined') {
         injectTestingBridge();
     }
 }
+/**
+ * Internal sync function - ONLY for TestBridge in development
+ *
+ * WARNING: This function is internal and should NEVER be called directly.
+ * It's only exported for TestBridge synchronization in dev mode.
+ *
+ * @internal
+ */
+const __setAppInstance = (instance) => {
+    if (instance !== null) {
+        const hasRequiredMethods = typeof instance === 'object' &&
+            'init' in instance &&
+            'destroy' in instance &&
+            'on' in instance &&
+            'off' in instance;
+        if (!hasRequiredMethods) {
+            throw new Error('[TraceLog] Invalid app instance type');
+        }
+    }
+    // Prevent overwriting an already initialized app (except when clearing)
+    if (app !== null && instance !== null && app !== instance) {
+        throw new Error('[TraceLog] Cannot overwrite existing app instance. Call destroy() first.');
+    }
+    app = instance;
+};
+exports.__setAppInstance = __setAppInstance;

package/dist/cjs/app.d.ts

@@ -4,7 +4,7 @@ import { SessionHandler } from './handlers/session.handler';
 import { PageViewHandler } from './handlers/page-view.handler';
 import { ClickHandler } from './handlers/click.handler';
 import { ScrollHandler } from './handlers/scroll.handler';
-import { AppConfig, EmitterCallback, EmitterMap } from './types';
+import { Config, EmitterCallback, EmitterMap } from './types';
 import { GoogleAnalyticsIntegration } from './integrations/google-analytics.integration';
 import { StorageManager } from './managers/storage.manager';
 import { PerformanceHandler } from './handlers/performance.handler';
@@ -29,7 +29,7 @@ export declare class App extends StateManager {
         googleAnalytics?: GoogleAnalyticsIntegration;
     };
     get initialized(): boolean;
-    init(appConfig: AppConfig): Promise<void>;
+    init(config: Config): Promise<void>;
     sendCustomEvent(name: string, metadata?: Record<string, unknown> | Record<string, unknown>[]): void;
     on<K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>): void;
     off<K extends keyof EmitterMap>(event: K, callback: EmitterCallback<EmitterMap[K]>): void;

package/dist/cjs/app.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.App = void 0;
-const api_manager_1 = require("./managers/api.manager");
-const config_manager_1 = require("./managers/config.manager");
 const event_manager_1 = require("./managers/event.manager");
 const user_manager_1 = require("./managers/user.manager");
 const state_manager_1 = require("./managers/state.manager");
@@ -30,27 +28,25 @@ class App extends state_manager_1.StateManager {
     get initialized() {
         return this.isInitialized;
     }
-    async init(appConfig) {
+    async init(config) {
         if (this.isInitialized) {
             return;
         }
-        if (!appConfig.id?.trim()) {
-            throw new Error('Project ID is required');
-        }
         this.managers.storage = new storage_manager_1.StorageManager();
         try {
-            await this.setupState(appConfig);
+            this.setupState(config);
             await this.setupIntegrations();
             this.managers.event = new event_manager_1.EventManager(this.managers.storage, this.integrations.googleAnalytics, this.emitter);
-            this.initializeHandlers();
-            await this.managers.event.recoverPersistedEvents().catch(() => {
-                utils_1.debugLog.warn('App', 'Failed to recover persisted events');
+            await this.initializeHandlers();
+            await this.managers.event.recoverPersistedEvents().catch((error) => {
+                (0, utils_1.log)('warn', 'Failed to recover persisted events', { error });
             });
             this.isInitialized = true;
         }
         catch (error) {
             await this.destroy(true);
-            throw new Error(`TraceLog initialization failed: ${error}`);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`[TraceLog] TraceLog initialization failed: ${errorMessage}`);
         }
     }
     sendCustomEvent(name, metadata) {
@@ -59,9 +55,8 @@ class App extends state_manager_1.StateManager {
         }
         const { valid, error, sanitizedMetadata } = (0, utils_1.isEventValid)(name, metadata);
         if (!valid) {
-            const config = this.get('config');
-            if (config?.mode === 'qa' || config?.mode === 'debug') {
-                throw new Error(`Custom event "${name}" validation failed: ${error}`);
+            if (this.get('mode') === types_1.Mode.QA) {
+                throw new Error(`[TraceLog] Custom event "${name}" validation failed: ${error}`);
             }
             return;
         }
@@ -90,8 +85,8 @@ class App extends state_manager_1.StateManager {
             try {
                 await handler.stopTracking();
             }
-            catch {
-                utils_1.debugLog.warn('App', 'Failed to stop tracking');
+            catch (error) {
+                (0, utils_1.log)('warn', 'Failed to stop tracking', { error });
             }
         });
         await Promise.allSettled(handlerCleanups);
@@ -108,22 +103,25 @@ class App extends state_manager_1.StateManager {
         this.isInitialized = false;
         this.handlers = {};
     }
-    async setupState(appConfig) {
-        const apiUrl = (0, api_manager_1.getApiUrlForProject)(appConfig.id, appConfig.allowHttp);
-        this.set('apiUrl', apiUrl);
-        const configManager = new config_manager_1.ConfigManager();
-        const config = await configManager.get(apiUrl, appConfig);
+    setupState(config) {
         this.set('config', config);
-        const userId = user_manager_1.UserManager.getId(this.managers.storage, config.id);
+        const userId = user_manager_1.UserManager.getId(this.managers.storage);
         this.set('userId', userId);
-        this.set('device', (0, utils_1.getDeviceType)());
+        const apiUrl = (0, utils_1.getApiUrl)(config);
+        this.set('apiUrl', apiUrl);
+        const device = (0, utils_1.getDeviceType)();
+        this.set('device', device);
         const pageUrl = (0, utils_1.normalizeUrl)(window.location.href, config.sensitiveQueryParams);
         this.set('pageUrl', pageUrl);
+        const mode = (0, utils_1.detectQaMode)() ? types_1.Mode.QA : undefined;
+        if (mode) {
+            this.set('mode', mode);
+        }
     }
     async setupIntegrations() {
         const config = this.get('config');
         const measurementId = config.integrations?.googleAnalytics?.measurementId;
-        if (!config.ipExcluded && measurementId?.trim()) {
+        if (measurementId?.trim()) {
             try {
                 this.integrations.googleAnalytics = new google_analytics_integration_1.GoogleAnalyticsIntegration();
                 await this.integrations.googleAnalytics.initialize();
@@ -133,13 +131,9 @@ class App extends state_manager_1.StateManager {
             }
         }
     }
-    initializeHandlers() {
+    async initializeHandlers() {
         this.handlers.session = new session_handler_1.SessionHandler(this.managers.storage, this.managers.event);
-        this.handlers.session.startTracking().catch((error) => {
-            utils_1.debugLog.error('App', 'Session handler failed to start', {
-                message: error instanceof Error ? error.message : 'Unknown error',
-            });
-        });
+        await this.handlers.session.startTracking();
         const onPageView = () => {
             this.set('suppressNextScroll', true);
             if (this.suppressNextScrollTimer) {
@@ -156,8 +150,8 @@ class App extends state_manager_1.StateManager {
         this.handlers.scroll = new scroll_handler_1.ScrollHandler(this.managers.event);
         this.handlers.scroll.startTracking();
         this.handlers.performance = new performance_handler_1.PerformanceHandler(this.managers.event);
-        this.handlers.performance.startTracking().catch(() => {
-            utils_1.debugLog.warn('App', 'Failed to start performance tracking');
+        this.handlers.performance.startTracking().catch((error) => {
+            (0, utils_1.log)('warn', 'Failed to start performance tracking', { error });
         });
         this.handlers.error = new error_handler_1.ErrorHandler(this.managers.event);
         this.handlers.error.startTracking();

package/dist/cjs/constants/config.constants.d.ts

@@ -22,13 +22,17 @@ export declare const MAX_SCROLL_EVENTS_PER_SESSION = 120;
 export declare const DEFAULT_SAMPLING_RATE = 1;
 export declare const MIN_SAMPLING_RATE = 0;
 export declare const MAX_SAMPLING_RATE = 1;
+export declare const RATE_LIMIT_WINDOW_MS = 1000;
+export declare const MAX_EVENTS_PER_SECOND = 200;
 export declare const BATCH_SIZE_THRESHOLD = 50;
+export declare const MAX_PENDING_EVENTS_BUFFER = 100;
 export declare const MIN_SESSION_TIMEOUT_MS = 30000;
 export declare const MAX_SESSION_TIMEOUT_MS = 86400000;
 export declare const MAX_CUSTOM_EVENT_NAME_LENGTH = 120;
 export declare const MAX_CUSTOM_EVENT_STRING_SIZE: number;
 export declare const MAX_CUSTOM_EVENT_KEYS = 10;
 export declare const MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
+export declare const MAX_NESTED_OBJECT_KEYS = 20;
 export declare const MAX_TEXT_LENGTH = 255;
 export declare const MAX_STRING_LENGTH = 1000;
 export declare const MAX_ARRAY_LENGTH = 100;
@@ -38,7 +42,7 @@ export declare const SYNC_XHR_TIMEOUT_MS = 2000;
 export declare const MAX_FINGERPRINTS = 1000;
 export declare const FINGERPRINT_CLEANUP_MULTIPLIER = 10;
 export declare const MAX_FINGERPRINTS_HARD_LIMIT = 2000;
-export declare const HTML_DATA_ATTR_PREFIX = "data-tl";
+export declare const HTML_DATA_ATTR_PREFIX = "data-tlog";
 export declare const INTERACTIVE_SELECTORS: readonly ["button", "a", "input[type=\"button\"]", "input[type=\"submit\"]", "input[type=\"reset\"]", "input[type=\"checkbox\"]", "input[type=\"radio\"]", "select", "textarea", "[role=\"button\"]", "[role=\"link\"]", "[role=\"tab\"]", "[role=\"menuitem\"]", "[role=\"option\"]", "[role=\"checkbox\"]", "[role=\"radio\"]", "[role=\"switch\"]", "[routerLink]", "[ng-click]", "[data-action]", "[data-click]", "[data-navigate]", "[data-toggle]", "[onclick]", ".btn", ".button", ".clickable", ".nav-link", ".menu-item", "[data-testid]", "[tabindex=\"0\"]"];
 export declare const UTM_PARAMS: string[];
 export declare const INITIALIZATION_MAX_CONCURRENT_RETRIES = 20;
@@ -60,13 +64,14 @@ export declare const RETRY_BACKOFF_INITIAL = 1000;
 export declare const RETRY_BACKOFF_MAX = 30000;
 export declare const RATE_LIMIT_INTERVAL = 1000;
 export declare const MAX_RETRY_ATTEMPTS = 10;
-export declare const ALLOWED_API_CONFIG_KEYS: Set<"mode" | "samplingRate" | "excludedUrlPaths" | keyof import("../types").ExclusiveApiConfig>;
 export declare const VALIDATION_MESSAGES: {
     readonly MISSING_PROJECT_ID: "Project ID is required";
     readonly PROJECT_ID_EMPTY_AFTER_TRIM: "Project ID is required";
     readonly INVALID_SESSION_TIMEOUT: "Session timeout must be between 30000ms (30 seconds) and 86400000ms (24 hours)";
     readonly INVALID_SAMPLING_RATE: "Sampling rate must be between 0 and 1";
     readonly INVALID_ERROR_SAMPLING_RATE: "Error sampling must be between 0 and 1";
+    readonly INVALID_TRACELOG_PROJECT_ID: "TraceLog project ID is required when integration is enabled";
+    readonly INVALID_CUSTOM_API_URL: "Custom API URL is required when integration is enabled";
     readonly INVALID_GOOGLE_ANALYTICS_ID: "Google Analytics measurement ID is required when integration is enabled";
     readonly INVALID_SCROLL_CONTAINER_SELECTORS: "Scroll container selectors must be valid CSS selectors";
     readonly INVALID_GLOBAL_METADATA: "Global metadata must be an object";

package/dist/cjs/constants/config.constants.js

@@ -4,8 +4,8 @@
  * This file centralizes all timing, limits, browser, and initialization constants
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SESSION_RECOVERY_WINDOW_MULTIPLIER = exports.TAB_CLEANUP_DELAY_MS = exports.TAB_ELECTION_TIMEOUT_MS = exports.TAB_HEARTBEAT_INTERVAL_MS = exports.CROSS_TAB_INITIALIZATION_LOCK_TIMEOUT_MS = exports.SESSION_CLEANUP_DELAY_MS = exports.SESSION_MAX_RETRY_ATTEMPTS = exports.SESSION_SYNC_TIMEOUT_MS = exports.INITIALIZATION_TIMEOUT_MS = exports.INITIALIZATION_CONCURRENT_RETRY_DELAY_MS = exports.INITIALIZATION_MAX_CONCURRENT_RETRIES = exports.UTM_PARAMS = exports.INTERACTIVE_SELECTORS = exports.HTML_DATA_ATTR_PREFIX = exports.MAX_FINGERPRINTS_HARD_LIMIT = exports.FINGERPRINT_CLEANUP_MULTIPLIER = exports.MAX_FINGERPRINTS = exports.SYNC_XHR_TIMEOUT_MS = exports.PRECISION_TWO_DECIMALS = exports.MAX_OBJECT_DEPTH = exports.MAX_ARRAY_LENGTH = exports.MAX_STRING_LENGTH = exports.MAX_TEXT_LENGTH = exports.MAX_CUSTOM_EVENT_ARRAY_SIZE = exports.MAX_CUSTOM_EVENT_KEYS = exports.MAX_CUSTOM_EVENT_STRING_SIZE = exports.MAX_CUSTOM_EVENT_NAME_LENGTH = exports.MAX_SESSION_TIMEOUT_MS = exports.MIN_SESSION_TIMEOUT_MS = exports.BATCH_SIZE_THRESHOLD = exports.MAX_SAMPLING_RATE = exports.MIN_SAMPLING_RATE = exports.DEFAULT_SAMPLING_RATE = exports.MAX_SCROLL_EVENTS_PER_SESSION = exports.SCROLL_MIN_EVENT_INTERVAL_MS = exports.MIN_SCROLL_DEPTH_CHANGE = exports.SIGNIFICANT_SCROLL_DELTA = exports.DEFAULT_MOTION_THRESHOLD = exports.MAX_METADATA_SIZE = exports.REQUEST_TIMEOUT_MS = exports.RETRY_DELAY_MS = exports.MAX_RETRIES = exports.MAX_EVENTS_QUEUE_LENGTH = exports.EVENT_PERSISTENCE_MAX_AGE_MS = exports.EVENT_EXPIRY_HOURS = exports.DEFAULT_VISIBILITY_TIMEOUT_MS = exports.SCROLL_DEBOUNCE_TIME_MS = exports.EVENT_SENT_INTERVAL_MS = exports.DUPLICATE_EVENT_THRESHOLD_MS = exports.DEFAULT_SESSION_TIMEOUT = void 0;
-exports.XSS_PATTERNS = exports.VALIDATION_MESSAGES = exports.ALLOWED_API_CONFIG_KEYS = exports.MAX_RETRY_ATTEMPTS = exports.RATE_LIMIT_INTERVAL = exports.RETRY_BACKOFF_MAX = exports.RETRY_BACKOFF_INITIAL = exports.SCROLL_SUPPRESS_MULTIPLIER = exports.MIN_SESSION_RECOVERY_WINDOW_MS = exports.MAX_SESSION_RECOVERY_WINDOW_MS = exports.MAX_SESSION_RECOVERY_ATTEMPTS = void 0;
+exports.CROSS_TAB_INITIALIZATION_LOCK_TIMEOUT_MS = exports.SESSION_CLEANUP_DELAY_MS = exports.SESSION_MAX_RETRY_ATTEMPTS = exports.SESSION_SYNC_TIMEOUT_MS = exports.INITIALIZATION_TIMEOUT_MS = exports.INITIALIZATION_CONCURRENT_RETRY_DELAY_MS = exports.INITIALIZATION_MAX_CONCURRENT_RETRIES = exports.UTM_PARAMS = exports.INTERACTIVE_SELECTORS = exports.HTML_DATA_ATTR_PREFIX = exports.MAX_FINGERPRINTS_HARD_LIMIT = exports.FINGERPRINT_CLEANUP_MULTIPLIER = exports.MAX_FINGERPRINTS = exports.SYNC_XHR_TIMEOUT_MS = exports.PRECISION_TWO_DECIMALS = exports.MAX_OBJECT_DEPTH = exports.MAX_ARRAY_LENGTH = exports.MAX_STRING_LENGTH = exports.MAX_TEXT_LENGTH = exports.MAX_NESTED_OBJECT_KEYS = exports.MAX_CUSTOM_EVENT_ARRAY_SIZE = exports.MAX_CUSTOM_EVENT_KEYS = exports.MAX_CUSTOM_EVENT_STRING_SIZE = exports.MAX_CUSTOM_EVENT_NAME_LENGTH = exports.MAX_SESSION_TIMEOUT_MS = exports.MIN_SESSION_TIMEOUT_MS = exports.MAX_PENDING_EVENTS_BUFFER = exports.BATCH_SIZE_THRESHOLD = exports.MAX_EVENTS_PER_SECOND = exports.RATE_LIMIT_WINDOW_MS = exports.MAX_SAMPLING_RATE = exports.MIN_SAMPLING_RATE = exports.DEFAULT_SAMPLING_RATE = exports.MAX_SCROLL_EVENTS_PER_SESSION = exports.SCROLL_MIN_EVENT_INTERVAL_MS = exports.MIN_SCROLL_DEPTH_CHANGE = exports.SIGNIFICANT_SCROLL_DELTA = exports.DEFAULT_MOTION_THRESHOLD = exports.MAX_METADATA_SIZE = exports.REQUEST_TIMEOUT_MS = exports.RETRY_DELAY_MS = exports.MAX_RETRIES = exports.MAX_EVENTS_QUEUE_LENGTH = exports.EVENT_PERSISTENCE_MAX_AGE_MS = exports.EVENT_EXPIRY_HOURS = exports.DEFAULT_VISIBILITY_TIMEOUT_MS = exports.SCROLL_DEBOUNCE_TIME_MS = exports.EVENT_SENT_INTERVAL_MS = exports.DUPLICATE_EVENT_THRESHOLD_MS = exports.DEFAULT_SESSION_TIMEOUT = void 0;
+exports.XSS_PATTERNS = exports.VALIDATION_MESSAGES = exports.MAX_RETRY_ATTEMPTS = exports.RATE_LIMIT_INTERVAL = exports.RETRY_BACKOFF_MAX = exports.RETRY_BACKOFF_INITIAL = exports.SCROLL_SUPPRESS_MULTIPLIER = exports.MIN_SESSION_RECOVERY_WINDOW_MS = exports.MAX_SESSION_RECOVERY_WINDOW_MS = exports.MAX_SESSION_RECOVERY_ATTEMPTS = exports.SESSION_RECOVERY_WINDOW_MULTIPLIER = exports.TAB_CLEANUP_DELAY_MS = exports.TAB_ELECTION_TIMEOUT_MS = exports.TAB_HEARTBEAT_INTERVAL_MS = void 0;
 // ============================================================================
 // SESSION & TIMING
 // ============================================================================
@@ -36,8 +36,11 @@ exports.MAX_SCROLL_EVENTS_PER_SESSION = 120;
 exports.DEFAULT_SAMPLING_RATE = 1;
 exports.MIN_SAMPLING_RATE = 0;
 exports.MAX_SAMPLING_RATE = 1;
+exports.RATE_LIMIT_WINDOW_MS = 1000; // 1 second window
+exports.MAX_EVENTS_PER_SECOND = 200; // Maximum 200 events per second
 // Queue and batch limits
 exports.BATCH_SIZE_THRESHOLD = 50;
+exports.MAX_PENDING_EVENTS_BUFFER = 100; // Maximum events to buffer before session init
 // Session timeout validation limits
 exports.MIN_SESSION_TIMEOUT_MS = 30000; // 30 seconds minimum
 exports.MAX_SESSION_TIMEOUT_MS = 86400000; // 24 hours maximum
@@ -46,6 +49,7 @@ exports.MAX_CUSTOM_EVENT_NAME_LENGTH = 120;
 exports.MAX_CUSTOM_EVENT_STRING_SIZE = 8 * 1024; // 8KB
 exports.MAX_CUSTOM_EVENT_KEYS = 10;
 exports.MAX_CUSTOM_EVENT_ARRAY_SIZE = 10;
+exports.MAX_NESTED_OBJECT_KEYS = 20; // Maximum keys in nested objects within arrays
 // Text content limits
 exports.MAX_TEXT_LENGTH = 255; // For click tracking text content
 // Data sanitization limits
@@ -63,7 +67,7 @@ exports.MAX_FINGERPRINTS_HARD_LIMIT = 2000; // Hard limit for aggressive cleanup
 // ============================================================================
 // BROWSER & HTML
 // ============================================================================
-exports.HTML_DATA_ATTR_PREFIX = 'data-tl';
+exports.HTML_DATA_ATTR_PREFIX = 'data-tlog';
 // Interactive element selectors for click tracking
 exports.INTERACTIVE_SELECTORS = [
     'button',
@@ -137,31 +141,18 @@ exports.MAX_RETRY_ATTEMPTS = 10;
 // ============================================================================
 // VALIDATION
 // ============================================================================
-// Allowed API config keys for runtime validation
-exports.ALLOWED_API_CONFIG_KEYS = new Set([
-    'mode',
-    'tags',
-    'samplingRate',
-    'excludedUrlPaths',
-    'ipExcluded',
-]);
 // Validation error messages - standardized across all layers
 exports.VALIDATION_MESSAGES = {
-    // Project ID validation - consistent message across all layers
     MISSING_PROJECT_ID: 'Project ID is required',
     PROJECT_ID_EMPTY_AFTER_TRIM: 'Project ID is required',
-    // Session timeout validation
     INVALID_SESSION_TIMEOUT: `Session timeout must be between ${exports.MIN_SESSION_TIMEOUT_MS}ms (30 seconds) and ${exports.MAX_SESSION_TIMEOUT_MS}ms (24 hours)`,
-    // Sampling rate validation
     INVALID_SAMPLING_RATE: 'Sampling rate must be between 0 and 1',
     INVALID_ERROR_SAMPLING_RATE: 'Error sampling must be between 0 and 1',
-    // Integration validation
+    INVALID_TRACELOG_PROJECT_ID: 'TraceLog project ID is required when integration is enabled',
+    INVALID_CUSTOM_API_URL: 'Custom API URL is required when integration is enabled',
     INVALID_GOOGLE_ANALYTICS_ID: 'Google Analytics measurement ID is required when integration is enabled',
-    // UI validation
     INVALID_SCROLL_CONTAINER_SELECTORS: 'Scroll container selectors must be valid CSS selectors',
-    // Global metadata validation
     INVALID_GLOBAL_METADATA: 'Global metadata must be an object',
-    // Array validation
     INVALID_SENSITIVE_QUERY_PARAMS: 'Sensitive query params must be an array of strings',
 };
 // ============================================================================

package/dist/cjs/constants/index.d.ts

@@ -1,4 +1,3 @@
-export * from './api.constants';
 export * from './config.constants';
 export * from './storage.constants';
 export * from './performance.constants';

package/dist/cjs/constants/index.js

@@ -14,7 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./api.constants"), exports);
 __exportStar(require("./config.constants"), exports);
 __exportStar(require("./storage.constants"), exports);
 __exportStar(require("./performance.constants"), exports);

package/dist/cjs/constants/storage.constants.d.ts

@@ -1,5 +1,6 @@
-export declare const STORAGE_BASE_KEY = "tl";
-export declare const USER_ID_KEY: (id: string) => string;
+export declare const STORAGE_BASE_KEY = "tlog";
+export declare const QA_MODE_KEY = "tlog:qa_mode";
+export declare const USER_ID_KEY = "tlog:uid";
 export declare const QUEUE_KEY: (id: string) => string;
 export declare const SESSION_STORAGE_KEY: (id: string) => string;
 export declare const CROSS_TAB_SESSION_KEY: (id: string) => string;

package/dist/cjs/constants/storage.constants.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BROADCAST_CHANNEL_NAME = exports.SESSION_RECOVERY_KEY = exports.TAB_SPECIFIC_INFO_KEY = exports.TAB_INFO_KEY = exports.CROSS_TAB_SESSION_KEY = exports.SESSION_STORAGE_KEY = exports.QUEUE_KEY = exports.USER_ID_KEY = exports.STORAGE_BASE_KEY = void 0;
-exports.STORAGE_BASE_KEY = 'tl';
-const USER_ID_KEY = (id) => (id ? `${exports.STORAGE_BASE_KEY}:${id}:uid` : `${exports.STORAGE_BASE_KEY}:uid`);
-exports.USER_ID_KEY = USER_ID_KEY;
+exports.BROADCAST_CHANNEL_NAME = exports.SESSION_RECOVERY_KEY = exports.TAB_SPECIFIC_INFO_KEY = exports.TAB_INFO_KEY = exports.CROSS_TAB_SESSION_KEY = exports.SESSION_STORAGE_KEY = exports.QUEUE_KEY = exports.USER_ID_KEY = exports.QA_MODE_KEY = exports.STORAGE_BASE_KEY = void 0;
+exports.STORAGE_BASE_KEY = 'tlog';
+exports.QA_MODE_KEY = `${exports.STORAGE_BASE_KEY}:qa_mode`;
+exports.USER_ID_KEY = `${exports.STORAGE_BASE_KEY}:uid`;
 const QUEUE_KEY = (id) => (id ? `${exports.STORAGE_BASE_KEY}:${id}:queue` : `${exports.STORAGE_BASE_KEY}:queue`);
 exports.QUEUE_KEY = QUEUE_KEY;
 const SESSION_STORAGE_KEY = (id) => id ? `${exports.STORAGE_BASE_KEY}:${id}:session` : `${exports.STORAGE_BASE_KEY}:session`;

package/dist/cjs/handlers/click.handler.js

@@ -4,7 +4,7 @@ exports.ClickHandler = void 0;
 const constants_1 = require("../constants");
 const types_1 = require("../types");
 const state_manager_1 = require("../managers/state.manager");
-const logging_1 = require("../utils/logging");
+const utils_1 = require("@/utils");
 class ClickHandler extends state_manager_1.StateManager {
     constructor(eventManager) {
         super();
@@ -23,7 +23,7 @@ class ClickHandler extends state_manager_1.StateManager {
                     ? target.parentElement
                     : null;
             if (!clickedElement) {
-                logging_1.debugLog.warn('ClickHandler', 'Click target not found or not an element');
+                (0, utils_1.log)('warn', 'Click target not found or not an element');
                 return;
             }
             const trackingElement = this.findTrackingElement(clickedElement);
@@ -75,10 +75,7 @@ class ClickHandler extends state_manager_1.StateManager {
                 }
             }
             catch (error) {
-                logging_1.debugLog.warn('ClickHandler', 'Invalid selector in element search', {
-                    selector,
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                });
+                (0, utils_1.log)('warn', 'Invalid selector in element search', { error, data: { selector } });
                 continue;
             }
         }

package/dist/cjs/handlers/error.handler.js

@@ -4,7 +4,6 @@ exports.ErrorHandler = void 0;
 const state_manager_1 = require("../managers/state.manager");
 const types_1 = require("../types");
 const error_constants_1 = require("../constants/error.constants");
-const logging_1 = require("../utils/logging");
 /**
  * Simplified error handler for tracking JavaScript errors and unhandled promise rejections
  * Includes PII sanitization and sampling support
@@ -21,11 +20,6 @@ class ErrorHandler extends state_manager_1.StateManager {
             if (this.shouldSuppressError(types_1.ErrorType.JS_ERROR, sanitizedMessage)) {
                 return;
             }
-            logging_1.debugLog.warn('ErrorHandler', 'JS error captured', {
-                message: sanitizedMessage,
-                filename: event.filename,
-                line: event.lineno,
-            });
             this.eventManager.track({
                 type: types_1.EventType.ERROR,
                 error_data: {
@@ -46,7 +40,6 @@ class ErrorHandler extends state_manager_1.StateManager {
             if (this.shouldSuppressError(types_1.ErrorType.PROMISE_REJECTION, sanitizedMessage)) {
                 return;
             }
-            logging_1.debugLog.warn('ErrorHandler', 'Promise rejection captured', { message: sanitizedMessage });
             this.eventManager.track({
                 type: types_1.EventType.ERROR,
                 error_data: {
@@ -110,10 +103,7 @@ class ErrorHandler extends state_manager_1.StateManager {
         }
         this.recentErrors.set(key, now);
         if (this.recentErrors.size > error_constants_1.MAX_TRACKED_ERRORS_HARD_LIMIT) {
-            logging_1.debugLog.warn('ErrorHandler', 'Hard limit exceeded, clearing all tracked errors', {
-                size: this.recentErrors.size,
-                limit: error_constants_1.MAX_TRACKED_ERRORS_HARD_LIMIT,
-            });
+            // Hard limit exceeded, clearing all tracked errors
             this.recentErrors.clear();
             this.recentErrors.set(key, now);
             return false;

package/dist/cjs/handlers/page-view.handler.js

@@ -4,7 +4,6 @@ exports.PageViewHandler = void 0;
 const types_1 = require("../types");
 const utils_1 = require("../utils");
 const state_manager_1 = require("../managers/state.manager");
-const logging_1 = require("../utils/logging");
 class PageViewHandler extends state_manager_1.StateManager {
     constructor(eventManager, onTrack) {
         super();
@@ -16,7 +15,6 @@ class PageViewHandler extends state_manager_1.StateManager {
             }
             this.onTrack();
             const fromUrl = this.get('pageUrl');
-            logging_1.debugLog.debug('PageViewHandler', 'Page navigation detected', { from: fromUrl, to: normalizedUrl });
             this.set('pageUrl', normalizedUrl);
             const pageViewData = this.extractPageViewData();
             this.eventManager.track({
@@ -30,7 +28,6 @@ class PageViewHandler extends state_manager_1.StateManager {
         this.onTrack = onTrack;
     }
     startTracking() {
-        logging_1.debugLog.debug('PageViewHandler', 'Starting page view tracking');
         this.trackInitialPageView();
         window.addEventListener('popstate', this.trackCurrentPage, true);
         window.addEventListener('hashchange', this.trackCurrentPage, true);
@@ -38,7 +35,6 @@ class PageViewHandler extends state_manager_1.StateManager {
         this.patchHistory('replaceState');
     }
     stopTracking() {
-        logging_1.debugLog.debug('PageViewHandler', 'Stopping page view tracking');
         window.removeEventListener('popstate', this.trackCurrentPage, true);
         window.removeEventListener('hashchange', this.trackCurrentPage, true);
         if (this.originalPushState) {