@tracelog/lib 0.0.1

package/dist/cjs/app.js

@@ -0,0 +1,272 @@
+"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");
+const session_handler_1 = require("./handlers/session.handler");
+const page_view_handler_1 = require("./handlers/page-view.handler");
+const click_handler_1 = require("./handlers/click.handler");
+const scroll_handler_1 = require("./handlers/scroll.handler");
+const validations_1 = require("./utils/validations");
+const event_types_1 = require("./types/event.types");
+const google_analytics_integration_1 = require("./integrations/google-analytics.integration");
+const utils_1 = require("./utils");
+const storage_manager_1 = require("./managers/storage.manager");
+const constants_1 = require("./constants");
+const performance_handler_1 = require("./handlers/performance.handler");
+const error_handler_1 = require("./handlers/error.handler");
+const network_handler_1 = require("./handlers/network.handler");
+const validation_error_types_1 = require("./types/validation-error.types");
+const logging_1 = require("./utils/logging");
+class App extends state_manager_1.StateManager {
+    constructor() {
+        super(...arguments);
+        this.isInitialized = false;
+        this.googleAnalytics = null;
+        this.suppressNextScrollTimer = null;
+    }
+    /**
+     * Returns the initialization status of the app
+     * @returns true if the app is fully initialized, false otherwise
+     */
+    get initialized() {
+        return this.isInitialized;
+    }
+    async init(appConfig) {
+        if (this.isInitialized) {
+            logging_1.debugLog.debug('App', 'App already initialized, skipping re-initialization', { projectId: appConfig.id });
+            return;
+        }
+        logging_1.debugLog.info('App', 'App initialization started', { projectId: appConfig.id });
+        this.validateAppReadiness(appConfig);
+        try {
+            this.initStorage();
+            await this.setState(appConfig);
+            await this.setIntegrations();
+            this.setEventManager();
+            await this.initHandlers();
+            this.isInitialized = true;
+            logging_1.debugLog.info('App', 'App initialization completed successfully', {
+                projectId: appConfig.id,
+            });
+        }
+        catch (error) {
+            this.isInitialized = false;
+            logging_1.debugLog.error('App', 'App initialization failed', { projectId: appConfig.id, error });
+            throw error;
+        }
+    }
+    /**
+     * Validates that the app is ready to initialize with the provided config
+     * This is a lightweight runtime validation layer that ensures the app receives proper config
+     * @param appConfig - The validated and normalized configuration
+     * @throws {ProjectIdValidationError} If project ID is invalid at runtime
+     */
+    validateAppReadiness(appConfig) {
+        // Lightweight validation - config should already be validated and normalized by api.ts
+        if (!appConfig?.id) {
+            logging_1.debugLog.clientError('App', 'Configuration integrity check failed - missing project ID', {
+                hasConfig: !!appConfig,
+                hasId: !!appConfig?.id,
+            });
+            throw new validation_error_types_1.ProjectIdValidationError('Configuration integrity check failed', 'app');
+        }
+    }
+    sendCustomEvent(name, metadata) {
+        if (!this.eventManager) {
+            logging_1.debugLog.warn('App', 'Custom event attempted before eventManager initialization', { eventName: name });
+            return;
+        }
+        const { valid, error, sanitizedMetadata } = (0, validations_1.isEventValid)(name, metadata);
+        if (valid) {
+            logging_1.debugLog.debug('App', 'Custom event validated and queued', { eventName: name, hasMetadata: !!sanitizedMetadata });
+            this.eventManager.track({
+                type: event_types_1.EventType.CUSTOM,
+                custom_event: {
+                    name,
+                    ...(sanitizedMetadata && { metadata: sanitizedMetadata }),
+                },
+            });
+        }
+        else {
+            const currentMode = this.get('config')?.mode;
+            logging_1.debugLog.clientError('App', `Custom event validation failed: ${error ?? 'unknown error'}`, {
+                eventName: name,
+                validationError: error,
+                hasMetadata: !!metadata,
+                mode: currentMode,
+            });
+            if (currentMode === 'qa' || currentMode === 'debug') {
+                throw new Error(`custom event "${name}" validation failed (${error ?? 'unknown error'}). Please, review your event data and try again.`);
+            }
+        }
+    }
+    destroy() {
+        if (!this.isInitialized) {
+            logging_1.debugLog.warn('App', 'Destroy called but app was not initialized');
+            return;
+        }
+        logging_1.debugLog.info('App', 'App cleanup started');
+        if (this.googleAnalytics) {
+            this.googleAnalytics.cleanup();
+        }
+        if (this.sessionHandler) {
+            this.sessionHandler.stopTracking();
+        }
+        if (this.pageViewHandler) {
+            this.pageViewHandler.stopTracking();
+        }
+        if (this.clickHandler) {
+            this.clickHandler.stopTracking();
+        }
+        if (this.scrollHandler) {
+            this.scrollHandler.stopTracking();
+        }
+        if (this.performanceHandler) {
+            this.performanceHandler.stopTracking();
+        }
+        if (this.errorHandler) {
+            this.errorHandler.stopTracking();
+        }
+        if (this.networkHandler) {
+            this.networkHandler.stopTracking();
+        }
+        if (this.suppressNextScrollTimer) {
+            clearTimeout(this.suppressNextScrollTimer);
+            this.suppressNextScrollTimer = null;
+        }
+        if (this.eventManager) {
+            this.eventManager.stop();
+        }
+        this.set('hasStartSession', false);
+        this.set('suppressNextScroll', false);
+        this.set('sessionId', null);
+        this.isInitialized = false;
+        logging_1.debugLog.info('App', 'App cleanup completed successfully');
+    }
+    async setState(appConfig) {
+        this.setApiUrl(appConfig.id, appConfig.allowHttp);
+        await this.setConfig(appConfig);
+        this.setUserId();
+        this.setDevice();
+        this.setPageUrl();
+    }
+    setApiUrl(id, allowHttp = false) {
+        const apiManager = new api_manager_1.ApiManager();
+        this.set('apiUrl', apiManager.getUrl(id, allowHttp));
+    }
+    async setConfig(appConfig) {
+        const configManager = new config_manager_1.ConfigManager();
+        const config = await configManager.get(this.get('apiUrl'), appConfig);
+        this.set('config', config);
+    }
+    setUserId() {
+        const userManager = new user_manager_1.UserManager(this.storageManager);
+        const userId = userManager.getId();
+        this.set('userId', userId);
+    }
+    setDevice() {
+        const device = (0, utils_1.getDeviceType)();
+        this.set('device', device);
+    }
+    setPageUrl() {
+        const initialUrl = (0, utils_1.normalizeUrl)(window.location.href, this.get('config').sensitiveQueryParams);
+        this.set('pageUrl', initialUrl);
+    }
+    async setIntegrations() {
+        const isIPExcluded = this.get('config').ipExcluded;
+        const measurementId = this.get('config').integrations?.googleAnalytics?.measurementId;
+        if (!isIPExcluded && measurementId?.trim()) {
+            this.googleAnalytics = new google_analytics_integration_1.GoogleAnalyticsIntegration();
+            await this.googleAnalytics.initialize();
+        }
+    }
+    async initHandlers() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before handlers');
+        }
+        if (!this.storageManager) {
+            throw new Error('StorageManager must be initialized before handlers');
+        }
+        this.initSessionHandler();
+        this.initPageViewHandler();
+        this.initClickHandler();
+        this.initScrollHandler();
+        await this.initPerformanceHandler();
+        this.initErrorHandler();
+        this.initNetworkHandler();
+    }
+    initStorage() {
+        this.storageManager = new storage_manager_1.StorageManager();
+    }
+    setEventManager() {
+        if (!this.storageManager) {
+            throw new Error('StorageManager must be initialized before EventManager');
+        }
+        this.eventManager = new event_manager_1.EventManager(this.storageManager, this.googleAnalytics);
+    }
+    initSessionHandler() {
+        if (!this.storageManager || !this.eventManager) {
+            throw new Error('StorageManager and EventManager must be initialized before SessionHandler');
+        }
+        this.sessionHandler = new session_handler_1.SessionHandler(this.storageManager, this.eventManager);
+        this.sessionHandler.startTracking();
+    }
+    initPageViewHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before PageViewHandler');
+        }
+        const onPageViewTrack = () => this.onPageViewTrack();
+        this.pageViewHandler = new page_view_handler_1.PageViewHandler(this.eventManager, onPageViewTrack);
+        this.pageViewHandler.startTracking();
+    }
+    onPageViewTrack() {
+        this.set('suppressNextScroll', true);
+        if (this.suppressNextScrollTimer) {
+            clearTimeout(this.suppressNextScrollTimer);
+            this.suppressNextScrollTimer = null;
+        }
+        this.suppressNextScrollTimer = window.setTimeout(() => {
+            this.set('suppressNextScroll', false);
+        }, constants_1.SCROLL_DEBOUNCE_TIME_MS * constants_1.SCROLL_SUPPRESSION_CONSTANTS.SUPPRESS_MULTIPLIER);
+    }
+    initClickHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before ClickHandler');
+        }
+        this.clickHandler = new click_handler_1.ClickHandler(this.eventManager);
+        this.clickHandler.startTracking();
+    }
+    initScrollHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before ScrollHandler');
+        }
+        this.scrollHandler = new scroll_handler_1.ScrollHandler(this.eventManager);
+        this.scrollHandler.startTracking();
+    }
+    async initPerformanceHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before PerformanceHandler');
+        }
+        this.performanceHandler = new performance_handler_1.PerformanceHandler(this.eventManager);
+        await this.performanceHandler.startTracking();
+    }
+    initErrorHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before ErrorHandler');
+        }
+        this.errorHandler = new error_handler_1.ErrorHandler(this.eventManager);
+        this.errorHandler.startTracking();
+    }
+    initNetworkHandler() {
+        if (!this.eventManager) {
+            throw new Error('EventManager must be initialized before NetworkHandler');
+        }
+        this.networkHandler = new network_handler_1.NetworkHandler(this.eventManager);
+        this.networkHandler.startTracking();
+    }
+}
+exports.App = App;

package/dist/cjs/app.types.d.ts

@@ -0,0 +1,6 @@
+export * from './types/common.types';
+export * from './types/config.types';
+export * from './types/device.types';
+export * from './types/event.types';
+export * from './types/queue.types';
+export * from './types/tag.types';

package/dist/cjs/app.types.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./types/common.types"), exports);
+__exportStar(require("./types/config.types"), exports);
+__exportStar(require("./types/device.types"), exports);
+__exportStar(require("./types/event.types"), exports);
+__exportStar(require("./types/queue.types"), exports);
+__exportStar(require("./types/tag.types"), exports);

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

@@ -0,0 +1,4 @@
+import { ApiConfig, Config } from '../types';
+export declare const API_BASE_URL = "https://api.tracelog.io";
+export declare const DEFAULT_API_CONFIG: ApiConfig;
+export declare const DEFAULT_CONFIG: (config: Config) => Config;

package/dist/cjs/constants/api.constants.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.DEFAULT_API_CONFIG = exports.API_BASE_URL = void 0;
+const limits_constants_1 = require("./limits.constants");
+const timing_constants_1 = require("./timing.constants");
+exports.API_BASE_URL = 'https://api.tracelog.io';
+exports.DEFAULT_API_CONFIG = {
+    samplingRate: limits_constants_1.DEFAULT_SAMPLING_RATE,
+    tags: [],
+    excludedUrlPaths: [],
+};
+const DEFAULT_CONFIG = (config) => ({
+    ...exports.DEFAULT_API_CONFIG,
+    ...config,
+    sessionTimeout: timing_constants_1.DEFAULT_SESSION_TIMEOUT_MS,
+    allowHttp: false,
+});
+exports.DEFAULT_CONFIG = DEFAULT_CONFIG;

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

@@ -0,0 +1,3 @@
+export declare const HTML_DATA_ATTR_PREFIX = "data-tl";
+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[];

package/dist/cjs/constants/browser.constants.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UTM_PARAMS = exports.INTERACTIVE_SELECTORS = exports.HTML_DATA_ATTR_PREFIX = void 0;
+// Click tracking constants
+exports.HTML_DATA_ATTR_PREFIX = 'data-tl';
+// Interactive element selectors for click tracking
+exports.INTERACTIVE_SELECTORS = [
+    '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"]',
+];
+// UTM parameters for tracking
+exports.UTM_PARAMS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];

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

@@ -0,0 +1,8 @@
+export * from './api.constants';
+export * from './browser.constants';
+export * from './initialization.constants';
+export * from './limits.constants';
+export * from './security.constants';
+export * from './storage.constants';
+export * from './timing.constants';
+export * from './validation.constants';

package/dist/cjs/constants/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./browser.constants"), exports);
+__exportStar(require("./initialization.constants"), exports);
+__exportStar(require("./limits.constants"), exports);
+__exportStar(require("./security.constants"), exports);
+__exportStar(require("./storage.constants"), exports);
+__exportStar(require("./timing.constants"), exports);
+__exportStar(require("./validation.constants"), exports);

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

@@ -0,0 +1,40 @@
+/**
+ * Constants for initialization and reliability patterns
+ * These values control initialization behavior, retry logic, and circuit breaker patterns
+ */
+export declare const INITIALIZATION_CONSTANTS: {
+    /** Maximum number of retries when waiting for concurrent initialization */
+    readonly MAX_CONCURRENT_RETRIES: 20;
+    /** Delay between retries when waiting for concurrent initialization (ms) */
+    readonly CONCURRENT_RETRY_DELAY_MS: 50;
+    /** Timeout for overall initialization process (ms) */
+    readonly INITIALIZATION_TIMEOUT_MS: 10000;
+};
+export declare const CIRCUIT_BREAKER_CONSTANTS: {
+    /** Maximum number of consecutive failures before opening circuit */
+    readonly MAX_FAILURES: 10;
+    /** Initial backoff delay when circuit opens (ms) */
+    readonly INITIAL_BACKOFF_DELAY_MS: 1000;
+    /** Maximum backoff delay (ms) */
+    readonly MAX_BACKOFF_DELAY_MS: 30000;
+    /** Backoff multiplier for exponential backoff */
+    readonly BACKOFF_MULTIPLIER: 2;
+    /** Time-based recovery period for circuit breaker (ms) */
+    readonly RECOVERY_TIME_MS: 30000;
+};
+export declare const SESSION_SYNC_CONSTANTS: {
+    /** Timeout for session synchronization operations (ms) */
+    readonly SYNC_TIMEOUT_MS: 2000;
+    /** Maximum retry attempts for session operations */
+    readonly MAX_RETRY_ATTEMPTS: 3;
+    /** Delay before cleanup operations (ms) */
+    readonly CLEANUP_DELAY_MS: 100;
+};
+export declare const CROSS_TAB_CONSTANTS: {
+    /** Flag to prevent concurrent cross-tab manager initialization */
+    readonly INITIALIZATION_LOCK_TIMEOUT_MS: 5000;
+};
+export declare const SCROLL_SUPPRESSION_CONSTANTS: {
+    /** Multiplier for scroll debounce time when suppressing scroll events */
+    readonly SUPPRESS_MULTIPLIER: 2;
+};

package/dist/cjs/constants/initialization.constants.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Constants for initialization and reliability patterns
+ * These values control initialization behavior, retry logic, and circuit breaker patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCROLL_SUPPRESSION_CONSTANTS = exports.CROSS_TAB_CONSTANTS = exports.SESSION_SYNC_CONSTANTS = exports.CIRCUIT_BREAKER_CONSTANTS = exports.INITIALIZATION_CONSTANTS = void 0;
+// Initialization retry constants
+exports.INITIALIZATION_CONSTANTS = {
+    /** Maximum number of retries when waiting for concurrent initialization */
+    MAX_CONCURRENT_RETRIES: 20,
+    /** Delay between retries when waiting for concurrent initialization (ms) */
+    CONCURRENT_RETRY_DELAY_MS: 50,
+    /** Timeout for overall initialization process (ms) */
+    INITIALIZATION_TIMEOUT_MS: 10000,
+};
+// Circuit breaker constants
+exports.CIRCUIT_BREAKER_CONSTANTS = {
+    /** Maximum number of consecutive failures before opening circuit */
+    MAX_FAILURES: 10,
+    /** Initial backoff delay when circuit opens (ms) */
+    INITIAL_BACKOFF_DELAY_MS: 1000,
+    /** Maximum backoff delay (ms) */
+    MAX_BACKOFF_DELAY_MS: 30000,
+    /** Backoff multiplier for exponential backoff */
+    BACKOFF_MULTIPLIER: 2,
+    /** Time-based recovery period for circuit breaker (ms) */
+    RECOVERY_TIME_MS: 30000, // 30 seconds
+};
+// Session management constants
+exports.SESSION_SYNC_CONSTANTS = {
+    /** Timeout for session synchronization operations (ms) */
+    SYNC_TIMEOUT_MS: 2000,
+    /** Maximum retry attempts for session operations */
+    MAX_RETRY_ATTEMPTS: 3,
+    /** Delay before cleanup operations (ms) */
+    CLEANUP_DELAY_MS: 100,
+};
+// Cross-tab coordination constants
+exports.CROSS_TAB_CONSTANTS = {
+    /** Flag to prevent concurrent cross-tab manager initialization */
+    INITIALIZATION_LOCK_TIMEOUT_MS: 5000,
+};
+// Scroll suppression constants
+exports.SCROLL_SUPPRESSION_CONSTANTS = {
+    /** Multiplier for scroll debounce time when suppressing scroll events */
+    SUPPRESS_MULTIPLIER: 2,
+};

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

@@ -0,0 +1,25 @@
+export declare const DEFAULT_MOTION_THRESHOLD = 2;
+export declare const SIGNIFICANT_SCROLL_DELTA = 10;
+export declare const DEFAULT_SAMPLING_RATE = 1;
+export declare const MIN_SAMPLING_RATE = 0;
+export declare const MAX_SAMPLING_RATE = 1;
+export declare const BATCH_SIZE_THRESHOLD = 50;
+export declare const MAX_EVENTS_QUEUE_LENGTH = 500;
+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_TEXT_LENGTH = 255;
+export declare const MAX_STRING_LENGTH = 1000;
+export declare const MAX_ARRAY_LENGTH = 100;
+export declare const MAX_OBJECT_DEPTH = 3;
+export declare const PRECISION_TWO_DECIMALS: 2;
+export declare const PRECISION_FOUR_DECIMALS: 4;
+export declare const WEB_VITALS_SAMPLING: 0.75;
+export declare const WEB_VITALS_LONG_TASK_SAMPLING: 0.2;
+export declare const SYNC_XHR_TIMEOUT_MS = 2000;
+export declare const MAX_FINGERPRINTS = 1000;
+export declare const FINGERPRINT_CLEANUP_MULTIPLIER = 10;
+export declare const CLICK_COORDINATE_PRECISION = 10;

package/dist/cjs/constants/limits.constants.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLICK_COORDINATE_PRECISION = exports.FINGERPRINT_CLEANUP_MULTIPLIER = exports.MAX_FINGERPRINTS = exports.SYNC_XHR_TIMEOUT_MS = exports.WEB_VITALS_LONG_TASK_SAMPLING = exports.WEB_VITALS_SAMPLING = exports.PRECISION_FOUR_DECIMALS = 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.MAX_EVENTS_QUEUE_LENGTH = exports.BATCH_SIZE_THRESHOLD = exports.MAX_SAMPLING_RATE = exports.MIN_SAMPLING_RATE = exports.DEFAULT_SAMPLING_RATE = exports.SIGNIFICANT_SCROLL_DELTA = exports.DEFAULT_MOTION_THRESHOLD = void 0;
+// Motion and interaction thresholds
+exports.DEFAULT_MOTION_THRESHOLD = 2;
+exports.SIGNIFICANT_SCROLL_DELTA = 10;
+// Sampling and rate limits
+exports.DEFAULT_SAMPLING_RATE = 1;
+exports.MIN_SAMPLING_RATE = 0;
+exports.MAX_SAMPLING_RATE = 1;
+// Queue and batch limits
+exports.BATCH_SIZE_THRESHOLD = 50;
+exports.MAX_EVENTS_QUEUE_LENGTH = 500;
+// Session timeout validation limits
+exports.MIN_SESSION_TIMEOUT_MS = 30000; // 30 seconds minimum
+exports.MAX_SESSION_TIMEOUT_MS = 86400000; // 24 hours maximum
+// Custom event validation limits
+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;
+// Text content limits
+exports.MAX_TEXT_LENGTH = 255; // For click tracking text content
+// Data sanitization limits
+exports.MAX_STRING_LENGTH = 1000;
+exports.MAX_ARRAY_LENGTH = 100;
+exports.MAX_OBJECT_DEPTH = 3;
+// Precision for numeric metrics
+exports.PRECISION_TWO_DECIMALS = 2;
+exports.PRECISION_FOUR_DECIMALS = 4;
+// Web vitals sampling
+exports.WEB_VITALS_SAMPLING = 0.75;
+exports.WEB_VITALS_LONG_TASK_SAMPLING = 0.2;
+// Sync XHR timeout
+exports.SYNC_XHR_TIMEOUT_MS = 2000; // 2 seconds
+// Event fingerprint management
+exports.MAX_FINGERPRINTS = 1000; // Maximum fingerprints stored before cleanup
+exports.FINGERPRINT_CLEANUP_MULTIPLIER = 10; // Cleanup fingerprints older than 10x threshold
+// Click coordinate precision
+exports.CLICK_COORDINATE_PRECISION = 10; // Round click coordinates to nearest 10px

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

@@ -0,0 +1 @@
+export declare const XSS_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];

package/dist/cjs/constants/security.constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XSS_PATTERNS = void 0;
+// XSS protection patterns
+exports.XSS_PATTERNS = [
+    /<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,
+    /javascript:/gi,
+    /on\w+\s*=/gi,
+    /<iframe\b[^<]*(?:(?!<\/iframe>)<[^<]*)*<\/iframe>/gi,
+    /<embed\b[^>]*>/gi,
+    /<object\b[^<]*(?:(?!<\/object>)<[^<]*)*<\/object>/gi,
+];

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

@@ -0,0 +1,9 @@
+export declare const STORAGE_BASE_KEY = "tl";
+export declare const USER_ID_KEY: (id: string) => string;
+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;
+export declare const TAB_INFO_KEY: (id: string) => string;
+export declare const TAB_SPECIFIC_INFO_KEY: (projectId: string, tabId: string) => string;
+export declare const SESSION_RECOVERY_KEY: (id: string) => string;
+export declare const BROADCAST_CHANNEL_NAME: (id: string) => string;

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

@@ -0,0 +1,22 @@
+"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;
+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`;
+exports.SESSION_STORAGE_KEY = SESSION_STORAGE_KEY;
+// Cross-tab session management storage keys
+const CROSS_TAB_SESSION_KEY = (id) => id ? `${exports.STORAGE_BASE_KEY}:${id}:cross_tab_session` : `${exports.STORAGE_BASE_KEY}:cross_tab_session`;
+exports.CROSS_TAB_SESSION_KEY = CROSS_TAB_SESSION_KEY;
+const TAB_INFO_KEY = (id) => id ? `${exports.STORAGE_BASE_KEY}:${id}:tab_info` : `${exports.STORAGE_BASE_KEY}:tab_info`;
+exports.TAB_INFO_KEY = TAB_INFO_KEY;
+const TAB_SPECIFIC_INFO_KEY = (projectId, tabId) => `${exports.STORAGE_BASE_KEY}:${projectId}:tab:${tabId}:info`;
+exports.TAB_SPECIFIC_INFO_KEY = TAB_SPECIFIC_INFO_KEY;
+const SESSION_RECOVERY_KEY = (id) => id ? `${exports.STORAGE_BASE_KEY}:${id}:recovery` : `${exports.STORAGE_BASE_KEY}:recovery`;
+exports.SESSION_RECOVERY_KEY = SESSION_RECOVERY_KEY;
+// BroadcastChannel name for cross-tab communication
+const BROADCAST_CHANNEL_NAME = (id) => id ? `${exports.STORAGE_BASE_KEY}:${id}:broadcast` : `${exports.STORAGE_BASE_KEY}:broadcast`;
+exports.BROADCAST_CHANNEL_NAME = BROADCAST_CHANNEL_NAME;

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

@@ -0,0 +1,22 @@
+export declare const DEFAULT_SESSION_TIMEOUT_MS: number;
+export declare const SESSION_HEARTBEAT_INTERVAL_MS = 30000;
+export declare const DEFAULT_THROTTLE_DELAY_MS = 1000;
+export declare const SCROLL_DEBOUNCE_TIME_MS = 250;
+export declare const DEFAULT_VISIBILITY_TIMEOUT_MS = 2000;
+export declare const DUPLICATE_EVENT_THRESHOLD_MS = 1000;
+export declare const EVENT_SENT_INTERVAL_MS = 10000;
+export declare const EVENT_SENT_INTERVAL_TEST_MS = 2500;
+export declare const RETRY_BACKOFF_INITIAL = 1000;
+export declare const RETRY_BACKOFF_MAX = 30000;
+export declare const RATE_LIMIT_INTERVAL = 1000;
+export declare const EVENT_EXPIRY_HOURS = 24;
+export declare const EVENT_PERSISTENCE_MAX_AGE_MS: number;
+export declare const LONG_TASK_THROTTLE_MS = 1000;
+export declare const SESSION_END_PRIORITY_DELAY_MS = 100;
+export declare const TAB_HEARTBEAT_INTERVAL_MS = 5000;
+export declare const TAB_ELECTION_TIMEOUT_MS = 2000;
+export declare const TAB_CLEANUP_DELAY_MS = 1000;
+export declare const SESSION_RECOVERY_WINDOW_MULTIPLIER = 2;
+export declare const MAX_SESSION_RECOVERY_ATTEMPTS = 3;
+export declare const MAX_SESSION_RECOVERY_WINDOW_MS: number;
+export declare const MIN_SESSION_RECOVERY_WINDOW_MS: number;