@tracelog/lib 0.0.1

package/dist/cjs/managers/event.manager.d.ts

@@ -0,0 +1,61 @@
+import { EventData } from '../types';
+import { StateManager } from './state.manager';
+import { StorageManager } from './storage.manager';
+import { GoogleAnalyticsIntegration } from '../integrations/google-analytics.integration';
+export declare class EventManager extends StateManager {
+    private readonly googleAnalytics;
+    private readonly samplingManager;
+    private readonly tagsManager;
+    private readonly dataSender;
+    private readonly storageManager;
+    private eventsQueue;
+    private lastEvent;
+    private eventsQueueIntervalId;
+    private intervalActive;
+    private failureCount;
+    private readonly MAX_FAILURES;
+    private circuitOpen;
+    private circuitOpenTime;
+    private backoffDelay;
+    private circuitResetTimeoutId;
+    private readonly eventFingerprints;
+    private readonly PERSISTENCE_KEY;
+    constructor(storeManager: StorageManager, googleAnalytics?: GoogleAnalyticsIntegration | null);
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, session_end_reason, session_start_recovered, }: Partial<EventData>): void;
+    stop(): void;
+    private processAndSend;
+    private trackGoogleAnalyticsEvent;
+    private initEventsQueueInterval;
+    flushImmediately(): Promise<boolean>;
+    flushImmediatelySync(): boolean;
+    getQueueLength(): number;
+    private sendEventsQueue;
+    private buildEventsPayload;
+    private clearQueueInterval;
+    private getEventFingerprint;
+    private isDuplicatedEvent;
+    /**
+     * Cleans up old fingerprints to prevent memory leaks
+     */
+    private cleanupOldFingerprints;
+    /**
+     * Opens the circuit breaker with time-based recovery and event persistence
+     */
+    private openCircuitBreaker;
+    /**
+     * Resets the circuit breaker and attempts to restore persisted events
+     */
+    private resetCircuitBreaker;
+    /**
+     * Persists current events queue to localStorage for recovery
+     */
+    private persistEventsToStorage;
+    /**
+     * Restores events from localStorage if available and not expired
+     */
+    private restoreEventsFromStorage;
+    /**
+     * Clears persisted events from localStorage
+     */
+    private clearPersistedEvents;
+}

package/dist/cjs/managers/event.manager.js

@@ -0,0 +1,508 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventManager = void 0;
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+const logging_1 = require("../utils/logging");
+const sender_manager_1 = require("./sender.manager");
+const sampling_manager_1 = require("./sampling.manager");
+const state_manager_1 = require("./state.manager");
+const tags_manager_1 = require("./tags.manager");
+class EventManager extends state_manager_1.StateManager {
+    constructor(storeManager, googleAnalytics = null) {
+        super();
+        this.eventsQueue = [];
+        this.lastEvent = null;
+        this.eventsQueueIntervalId = null;
+        this.intervalActive = false;
+        // Circuit breaker properties
+        this.failureCount = 0;
+        this.MAX_FAILURES = constants_1.CIRCUIT_BREAKER_CONSTANTS.MAX_FAILURES;
+        this.circuitOpen = false;
+        this.circuitOpenTime = 0;
+        this.backoffDelay = constants_1.CIRCUIT_BREAKER_CONSTANTS.INITIAL_BACKOFF_DELAY_MS;
+        this.circuitResetTimeoutId = null;
+        // Event deduplication properties
+        this.eventFingerprints = new Map();
+        // Persistence storage key
+        this.PERSISTENCE_KEY = 'tl:circuit_breaker_events';
+        this.storageManager = storeManager;
+        this.googleAnalytics = googleAnalytics;
+        this.samplingManager = new sampling_manager_1.SamplingManager();
+        this.tagsManager = new tags_manager_1.TagsManager();
+        this.dataSender = new sender_manager_1.SenderManager(storeManager);
+        // Restore any persisted events on initialization
+        this.restoreEventsFromStorage();
+        logging_1.debugLog.debug('EventManager', 'EventManager initialized', {
+            hasGoogleAnalytics: !!googleAnalytics,
+            restoredEventsCount: this.eventsQueue.length,
+        });
+    }
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, session_end_reason, session_start_recovered, }) {
+        logging_1.debugLog.info('EventManager', `📥 Event captured: ${type}`, {
+            type,
+            page_url,
+            hasCustomEvent: !!custom_event,
+            hasClickData: !!click_data,
+            hasScrollData: !!scroll_data,
+            hasWebVitals: !!web_vitals,
+        });
+        if (!this.samplingManager.shouldSampleEvent(type, web_vitals)) {
+            logging_1.debugLog.debug('EventManager', 'Event filtered by sampling', { type, samplingActive: true });
+            return;
+        }
+        const isDuplicatedEvent = this.isDuplicatedEvent({
+            type,
+            page_url,
+            scroll_data,
+            click_data,
+            custom_event,
+            web_vitals,
+            session_end_reason,
+            session_start_recovered,
+        });
+        if (isDuplicatedEvent) {
+            const now = Date.now();
+            if (this.eventsQueue && this.eventsQueue.length > 0) {
+                const lastEvent = this.eventsQueue.at(-1);
+                if (lastEvent) {
+                    lastEvent.timestamp = now;
+                }
+            }
+            if (this.lastEvent) {
+                this.lastEvent.timestamp = now;
+            }
+            logging_1.debugLog.debug('EventManager', 'Duplicate event detected, timestamp updated', {
+                type,
+                queueLength: this.eventsQueue.length,
+            });
+            return;
+        }
+        const effectivePageUrl = page_url || this.get('pageUrl');
+        const isRouteExcluded = (0, utils_1.isUrlPathExcluded)(effectivePageUrl, this.get('config').excludedUrlPaths);
+        const hasStartSession = this.get('hasStartSession');
+        const isSessionEndEvent = type == types_1.EventType.SESSION_END;
+        if (isRouteExcluded && (!isSessionEndEvent || (isSessionEndEvent && !hasStartSession))) {
+            if (this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug') {
+                logging_1.debugLog.debug('EventManager', `Event ${type} on excluded route: ${page_url}`);
+            }
+            return;
+        }
+        const isSessionStartEvent = type === types_1.EventType.SESSION_START;
+        if (isSessionStartEvent) {
+            this.set('hasStartSession', true);
+        }
+        const utmParams = isSessionStartEvent ? (0, utils_1.getUTMParameters)() : undefined;
+        const payload = {
+            type: type,
+            page_url: isRouteExcluded ? 'excluded' : effectivePageUrl,
+            timestamp: Date.now(),
+            ...(isSessionStartEvent && { referrer: document.referrer || 'Direct' }),
+            ...(from_page_url && !isRouteExcluded ? { from_page_url } : {}),
+            ...(scroll_data && { scroll_data }),
+            ...(click_data && { click_data }),
+            ...(custom_event && { custom_event }),
+            ...(utmParams && { utm: utmParams }),
+            ...(web_vitals && { web_vitals }),
+            ...(session_end_reason && { session_end_reason }),
+            ...(session_start_recovered && { session_start_recovered }),
+        };
+        if (this.get('config')?.tags?.length) {
+            const matchedTags = this.tagsManager.getEventTagsIds(payload, this.get('device'));
+            if (matchedTags?.length) {
+                payload.tags =
+                    this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug'
+                        ? matchedTags.map((id) => ({
+                            id,
+                            key: this.get('config')?.tags?.find((t) => t.id === id)?.key ?? '',
+                        }))
+                        : matchedTags;
+            }
+        }
+        this.lastEvent = payload;
+        this.processAndSend(payload);
+    }
+    stop() {
+        // Clear interval and reset interval state
+        if (this.eventsQueueIntervalId) {
+            clearInterval(this.eventsQueueIntervalId);
+            this.eventsQueueIntervalId = null;
+            this.intervalActive = false;
+        }
+        // Clean up circuit breaker timeout
+        if (this.circuitResetTimeoutId) {
+            clearTimeout(this.circuitResetTimeoutId);
+            this.circuitResetTimeoutId = null;
+        }
+        // Persist any remaining events before stopping
+        if (this.eventsQueue.length > 0) {
+            this.persistEventsToStorage();
+        }
+        // Clean up all state variables
+        this.eventFingerprints.clear();
+        this.circuitOpen = false;
+        this.circuitOpenTime = 0;
+        this.failureCount = 0;
+        this.backoffDelay = constants_1.CIRCUIT_BREAKER_CONSTANTS.INITIAL_BACKOFF_DELAY_MS;
+        this.lastEvent = null;
+        // Stop the data sender to clean up retry timeouts
+        this.dataSender.stop();
+    }
+    processAndSend(payload) {
+        logging_1.debugLog.info('EventManager', `🔄 Event processed and queued: ${payload.type}`, {
+            type: payload.type,
+            timestamp: payload.timestamp,
+            page_url: payload.page_url,
+            queueLengthBefore: this.eventsQueue.length,
+        });
+        if (this.get('config').ipExcluded) {
+            logging_1.debugLog.info('EventManager', `❌ Event blocked: IP excluded`);
+            return;
+        }
+        this.eventsQueue.push(payload);
+        if (this.eventsQueue.length > constants_1.MAX_EVENTS_QUEUE_LENGTH) {
+            const removedEvent = this.eventsQueue.shift();
+            logging_1.debugLog.warn('EventManager', 'Event queue overflow, oldest event removed', {
+                maxLength: constants_1.MAX_EVENTS_QUEUE_LENGTH,
+                currentLength: this.eventsQueue.length,
+                removedEventType: removedEvent?.type,
+            });
+        }
+        if (!this.eventsQueueIntervalId) {
+            this.initEventsQueueInterval();
+            logging_1.debugLog.info('EventManager', `⏰ Event sender initialized - queue will be sent periodically`, {
+                queueLength: this.eventsQueue.length,
+            });
+        }
+        if (this.googleAnalytics && payload.type === types_1.EventType.CUSTOM) {
+            const customEvent = payload.custom_event;
+            this.trackGoogleAnalyticsEvent(customEvent);
+        }
+    }
+    trackGoogleAnalyticsEvent(customEvent) {
+        if (this.get('config').mode === 'qa' || this.get('config').mode === 'debug') {
+            logging_1.debugLog.debug('EventManager', `Google Analytics event: ${JSON.stringify(customEvent)}`);
+        }
+        else if (this.googleAnalytics) {
+            this.googleAnalytics.trackEvent(customEvent.name, customEvent.metadata ?? {});
+        }
+    }
+    initEventsQueueInterval() {
+        if (this.eventsQueueIntervalId || this.intervalActive) {
+            return;
+        }
+        const interval = this.get('config')?.id === 'test' ? constants_1.EVENT_SENT_INTERVAL_TEST_MS : constants_1.EVENT_SENT_INTERVAL_MS;
+        this.eventsQueueIntervalId = window.setInterval(() => {
+            if (this.eventsQueue.length > 0) {
+                this.sendEventsQueue();
+            }
+        }, interval);
+        this.intervalActive = true;
+    }
+    async flushImmediately() {
+        if (this.eventsQueue.length === 0) {
+            return true;
+        }
+        const body = this.buildEventsPayload();
+        const success = await this.dataSender.sendEventsQueueAsync(body);
+        if (success) {
+            this.eventsQueue = [];
+            this.clearQueueInterval();
+        }
+        return success;
+    }
+    flushImmediatelySync() {
+        if (this.eventsQueue.length === 0) {
+            return true;
+        }
+        const body = this.buildEventsPayload();
+        const success = this.dataSender.sendEventsQueueSync(body);
+        if (success) {
+            this.eventsQueue = [];
+            this.clearQueueInterval();
+        }
+        return success;
+    }
+    getQueueLength() {
+        return this.eventsQueue.length;
+    }
+    sendEventsQueue() {
+        if (this.eventsQueue.length === 0) {
+            return;
+        }
+        logging_1.debugLog.info('EventManager', `📤 Preparing to send event queue`, {
+            queueLength: this.eventsQueue.length,
+            hasSessionId: !!this.get('sessionId'),
+            circuitOpen: this.circuitOpen,
+        });
+        // Circuit breaker: check if it should be reset or continue blocking
+        if (this.circuitOpen) {
+            const timeSinceOpen = Date.now() - this.circuitOpenTime;
+            if (timeSinceOpen >= constants_1.CIRCUIT_BREAKER_CONSTANTS.RECOVERY_TIME_MS) {
+                this.resetCircuitBreaker();
+                logging_1.debugLog.info('EventManager', 'Circuit breaker reset after timeout', {
+                    timeSinceOpen,
+                    recoveryTime: constants_1.CIRCUIT_BREAKER_CONSTANTS.RECOVERY_TIME_MS,
+                });
+            }
+            else {
+                logging_1.debugLog.debug('EventManager', 'Circuit breaker is open - skipping event sending', {
+                    queueLength: this.eventsQueue.length,
+                    failureCount: this.failureCount,
+                    timeSinceOpen,
+                    recoveryTime: constants_1.CIRCUIT_BREAKER_CONSTANTS.RECOVERY_TIME_MS,
+                });
+                return;
+            }
+        }
+        if (!this.get('sessionId')) {
+            logging_1.debugLog.info('EventManager', `⏳ Queue waiting: ${this.eventsQueue.length} events waiting for active session`);
+            return;
+        }
+        const body = this.buildEventsPayload();
+        const success = this.dataSender.sendEventsQueue(body);
+        if (success) {
+            logging_1.debugLog.info('EventManager', `✅ Event queue sent successfully`, {
+                eventsCount: body.events.length,
+                sessionId: body.session_id,
+                uniqueEventsAfterDedup: body.events.length,
+            });
+            this.eventsQueue = [];
+            this.failureCount = 0;
+            this.backoffDelay = constants_1.CIRCUIT_BREAKER_CONSTANTS.INITIAL_BACKOFF_DELAY_MS;
+            // Clear any persisted events on successful send
+            this.clearPersistedEvents();
+        }
+        else {
+            logging_1.debugLog.info('EventManager', `❌ Failed to send event queue`, {
+                eventsCount: body.events.length,
+                failureCount: this.failureCount + 1,
+                willOpenCircuit: this.failureCount + 1 >= this.MAX_FAILURES,
+            });
+            // Persist failed events for recovery instead of restoring queue to prevent duplicates
+            this.persistEventsToStorage();
+            this.eventsQueue = [];
+            this.failureCount++;
+            if (this.failureCount >= this.MAX_FAILURES) {
+                this.openCircuitBreaker();
+            }
+        }
+    }
+    buildEventsPayload() {
+        const uniqueEvents = new Map();
+        for (const event of this.eventsQueue) {
+            let key = `${event.type}_${event.page_url}`;
+            if (event.click_data) {
+                key += `_${event.click_data.x}_${event.click_data.y}`;
+            }
+            if (event.scroll_data) {
+                key += `_${event.scroll_data.depth}_${event.scroll_data.direction}`;
+            }
+            if (event.custom_event) {
+                key += `_${event.custom_event.name}`;
+            }
+            if (event.web_vitals) {
+                key += `_${event.web_vitals.type}`;
+            }
+            if (!uniqueEvents.has(key)) {
+                uniqueEvents.set(key, event);
+            }
+        }
+        const deduplicatedEvents = [...uniqueEvents.values()];
+        deduplicatedEvents.sort((a, b) => a.timestamp - b.timestamp);
+        return {
+            user_id: this.get('userId'),
+            session_id: this.get('sessionId'),
+            device: this.get('device'),
+            events: deduplicatedEvents,
+            ...(this.get('config')?.globalMetadata && { global_metadata: this.get('config')?.globalMetadata }),
+        };
+    }
+    clearQueueInterval() {
+        if (this.eventsQueueIntervalId) {
+            clearInterval(this.eventsQueueIntervalId);
+            this.eventsQueueIntervalId = null;
+            this.intervalActive = false;
+        }
+    }
+    getEventFingerprint(event) {
+        const key = `${event.type}_${event.page_url}`;
+        if (event.click_data) {
+            // Round coordinates to reduce false positives
+            const x = Math.round((event.click_data.x || 0) / constants_1.CLICK_COORDINATE_PRECISION) * constants_1.CLICK_COORDINATE_PRECISION;
+            const y = Math.round((event.click_data.y || 0) / constants_1.CLICK_COORDINATE_PRECISION) * constants_1.CLICK_COORDINATE_PRECISION;
+            return `${key}_${x}_${y}_${event.click_data.tag}_${event.click_data.id}`;
+        }
+        if (event.scroll_data) {
+            return `${key}_${event.scroll_data.depth}_${event.scroll_data.direction}`;
+        }
+        if (event.custom_event) {
+            return `${key}_${event.custom_event.name}`;
+        }
+        if (event.web_vitals) {
+            return `${key}_${event.web_vitals.type}`;
+        }
+        if (event.session_end_reason) {
+            return `${key}_${event.session_end_reason}`;
+        }
+        if (event.session_start_recovered !== undefined) {
+            return `${key}_${event.session_start_recovered}`;
+        }
+        return key;
+    }
+    isDuplicatedEvent(event) {
+        const fingerprint = this.getEventFingerprint(event);
+        const lastTime = this.eventFingerprints.get(fingerprint) ?? 0;
+        const now = Date.now();
+        if (now - lastTime < constants_1.DUPLICATE_EVENT_THRESHOLD_MS) {
+            return true;
+        }
+        this.eventFingerprints.set(fingerprint, now);
+        // Clean up old fingerprints to prevent memory leaks
+        this.cleanupOldFingerprints();
+        return false;
+    }
+    /**
+     * Cleans up old fingerprints to prevent memory leaks
+     */
+    cleanupOldFingerprints() {
+        if (this.eventFingerprints.size <= constants_1.MAX_FINGERPRINTS) {
+            return;
+        }
+        const now = Date.now();
+        const cleanupThreshold = constants_1.DUPLICATE_EVENT_THRESHOLD_MS * constants_1.FINGERPRINT_CLEANUP_MULTIPLIER;
+        const keysToDelete = [];
+        for (const [key, timestamp] of this.eventFingerprints) {
+            if (now - timestamp > cleanupThreshold) {
+                keysToDelete.push(key);
+            }
+        }
+        // Delete old entries
+        for (const key of keysToDelete) {
+            this.eventFingerprints.delete(key);
+        }
+        logging_1.debugLog.debug('EventManager', 'Cleaned up old event fingerprints', {
+            totalFingerprints: this.eventFingerprints.size + keysToDelete.length,
+            cleanedCount: keysToDelete.length,
+            remainingCount: this.eventFingerprints.size,
+            cleanupThreshold,
+        });
+    }
+    /**
+     * Opens the circuit breaker with time-based recovery and event persistence
+     */
+    openCircuitBreaker() {
+        this.circuitOpen = true;
+        this.circuitOpenTime = Date.now();
+        // Persist events before clearing queue to prevent data loss
+        this.persistEventsToStorage();
+        const eventsCount = this.eventsQueue.length;
+        this.eventsQueue = []; // Clear memory queue
+        logging_1.debugLog.warn('EventManager', 'Circuit breaker opened with time-based recovery', {
+            maxFailures: this.MAX_FAILURES,
+            persistedEvents: eventsCount,
+            failureCount: this.failureCount,
+            recoveryTime: constants_1.CIRCUIT_BREAKER_CONSTANTS.RECOVERY_TIME_MS,
+            openTime: this.circuitOpenTime,
+        });
+        // Increase backoff for next failure
+        this.backoffDelay = Math.min(this.backoffDelay * constants_1.CIRCUIT_BREAKER_CONSTANTS.BACKOFF_MULTIPLIER, constants_1.CIRCUIT_BREAKER_CONSTANTS.MAX_BACKOFF_DELAY_MS);
+    }
+    /**
+     * Resets the circuit breaker and attempts to restore persisted events
+     */
+    resetCircuitBreaker() {
+        this.circuitOpen = false;
+        this.circuitOpenTime = 0;
+        this.failureCount = 0;
+        this.circuitResetTimeoutId = null;
+        logging_1.debugLog.info('EventManager', 'Circuit breaker reset - attempting to restore events', {
+            currentQueueLength: this.eventsQueue.length,
+        });
+        // Restore persisted events
+        this.restoreEventsFromStorage();
+        logging_1.debugLog.info('EventManager', 'Circuit breaker reset completed', {
+            restoredQueueLength: this.eventsQueue.length,
+            backoffDelay: this.backoffDelay,
+        });
+    }
+    /**
+     * Persists current events queue to localStorage for recovery
+     */
+    persistEventsToStorage() {
+        try {
+            if (this.eventsQueue.length === 0) {
+                return;
+            }
+            const persistData = {
+                events: this.eventsQueue,
+                timestamp: Date.now(),
+                failureCount: this.failureCount,
+            };
+            this.storageManager.setItem(this.PERSISTENCE_KEY, JSON.stringify(persistData));
+            logging_1.debugLog.debug('EventManager', 'Events persisted to storage for recovery', {
+                eventsCount: this.eventsQueue.length,
+                failureCount: this.failureCount,
+            });
+        }
+        catch (error) {
+            logging_1.debugLog.warn('EventManager', 'Failed to persist events to storage', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+                eventsCount: this.eventsQueue.length,
+            });
+        }
+    }
+    /**
+     * Restores events from localStorage if available and not expired
+     */
+    restoreEventsFromStorage() {
+        try {
+            const persistedData = this.storageManager.getItem(this.PERSISTENCE_KEY);
+            if (!persistedData) {
+                return;
+            }
+            const parsed = JSON.parse(persistedData);
+            const now = Date.now();
+            const maxAge = constants_1.EVENT_PERSISTENCE_MAX_AGE_MS;
+            // Check if persisted data is not too old
+            if (now - parsed.timestamp > maxAge) {
+                this.clearPersistedEvents();
+                logging_1.debugLog.debug('EventManager', 'Cleared expired persisted events', {
+                    age: now - parsed.timestamp,
+                    maxAge,
+                });
+                return;
+            }
+            // Restore events if we don't already have events in queue
+            if (Array.isArray(parsed.events) && parsed.events.length > 0 && this.eventsQueue.length === 0) {
+                this.eventsQueue = parsed.events;
+                logging_1.debugLog.info('EventManager', 'Restored events from storage', {
+                    restoredCount: parsed.events.length,
+                    originalFailureCount: parsed.failureCount ?? 0,
+                });
+            }
+        }
+        catch (error) {
+            logging_1.debugLog.warn('EventManager', 'Failed to restore events from storage', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            this.clearPersistedEvents();
+        }
+    }
+    /**
+     * Clears persisted events from localStorage
+     */
+    clearPersistedEvents() {
+        try {
+            this.storageManager.removeItem(this.PERSISTENCE_KEY);
+            logging_1.debugLog.debug('EventManager', 'Cleared persisted events from storage');
+        }
+        catch (error) {
+            logging_1.debugLog.warn('EventManager', 'Failed to clear persisted events', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+    }
+}
+exports.EventManager = EventManager;

package/dist/cjs/managers/sampling.manager.d.ts

@@ -0,0 +1,8 @@
+import { EventType, WebVitalsData } from '../types';
+import { StateManager } from './state.manager';
+export declare class SamplingManager extends StateManager {
+    shouldSampleEvent(type: EventType, webVitals?: WebVitalsData): boolean;
+    private isSampledIn;
+    private isWebVitalEventSampledIn;
+    private getHash;
+}

package/dist/cjs/managers/sampling.manager.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SamplingManager = void 0;
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const state_manager_1 = require("./state.manager");
+class SamplingManager extends state_manager_1.StateManager {
+    shouldSampleEvent(type, webVitals) {
+        const isQaMode = this.get('config')?.mode === 'qa' || this.get('config')?.mode === 'debug';
+        if (isQaMode) {
+            return true;
+        }
+        if (type === types_1.EventType.WEB_VITALS) {
+            return this.isWebVitalEventSampledIn(webVitals?.type);
+        }
+        return this.isSampledIn();
+    }
+    isSampledIn() {
+        const samplingRate = this.get('config').samplingRate ?? constants_1.DEFAULT_SAMPLING_RATE;
+        if (samplingRate >= 1.0) {
+            return true;
+        }
+        if (samplingRate <= 0) {
+            return false;
+        }
+        const userHash = this.getHash(this.get('userId'));
+        const userValue = (userHash % 100) / 100;
+        const isSampled = userValue < samplingRate;
+        return isSampled;
+    }
+    isWebVitalEventSampledIn(type) {
+        const isLongTask = type === 'LONG_TASK';
+        const rate = isLongTask ? constants_1.WEB_VITALS_LONG_TASK_SAMPLING : constants_1.WEB_VITALS_SAMPLING;
+        if (rate >= 1)
+            return true;
+        if (rate <= 0)
+            return false;
+        const seed = `${this.get('userId')}|${isLongTask ? 'long_task' : 'web_vitals'}`;
+        const hash = this.getHash(seed);
+        const value = (hash % 100) / 100;
+        return value < rate;
+    }
+    getHash(input) {
+        let hash = 0;
+        for (let i = 0; i < input.length; i++) {
+            const char = input.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash |= 0;
+        }
+        return Math.abs(hash);
+    }
+}
+exports.SamplingManager = SamplingManager;

package/dist/cjs/managers/sender.manager.d.ts

@@ -0,0 +1,46 @@
+import { BaseEventsQueueDto } from '../types';
+import { StorageManager } from './storage.manager';
+import { StateManager } from './state.manager';
+export declare class SenderManager extends StateManager {
+    private readonly storeManager;
+    private readonly queueStorageKey;
+    private retryDelay;
+    private retryTimeoutId;
+    private lastAsyncSend;
+    private lastSyncSend;
+    constructor(storeManager: StorageManager);
+    sendEventsQueueAsync(body: BaseEventsQueueDto): Promise<boolean>;
+    sendEventsQueueSync(body: BaseEventsQueueDto): boolean;
+    sendEventsQueue(body: BaseEventsQueueDto): boolean;
+    recoverPersistedEvents(): void;
+    stop(): void;
+    /**
+     * Sends recovered events without re-deduplication since they were already processed
+     */
+    private sendRecoveredEvents;
+    /**
+     * Schedules retry for recovered events using the specific recovery method
+     */
+    private scheduleRetryForRecoveredEvents;
+    private canSendAsync;
+    private canSendSync;
+    private sendQueueAsync;
+    private sendQueueSync;
+    private sendQueue;
+    private sendSyncXHR;
+    private prepareRequest;
+    private getPersistedData;
+    private isDataRecent;
+    private createRecoveryBody;
+    private logQueue;
+    private handleSendFailure;
+    private persistFailedEvents;
+    private clearPersistedEvents;
+    private resetRetryState;
+    private scheduleRetry;
+    private executeSend;
+    private executeSendSync;
+    private shouldSkipSend;
+    private isSendBeaconAvailable;
+    private clearRetryTimeout;
+}