@tracelog/lib 0.10.0 → 0.11.0

package/dist/esm/handlers/error.handler.d.ts

@@ -7,9 +7,16 @@ import { StateManager } from '../managers/state.manager';
 export declare class ErrorHandler extends StateManager {
     private readonly eventManager;
     private readonly recentErrors;
+    private errorBurstCounter;
+    private burstWindowStart;
+    private burstBackoffUntil;
     constructor(eventManager: EventManager);
     startTracking(): void;
     stopTracking(): void;
+    /**
+     * Checks sampling rate and burst detection (Phase 3)
+     * Returns false if in cooldown period after burst detection
+     */
     private shouldSample;
     private readonly handleError;
     private readonly handleRejection;

package/dist/esm/handlers/error.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/error.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAWzD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAE9C,YAAY,EAAE,YAAY;IAKtC,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IAMpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAqB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAmB9B;IAEF,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,cAAc;CAsBvB"}
+{"version":3,"file":"error.handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/error.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAezD;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;gBAElB,YAAY,EAAE,YAAY;IAKtC,aAAa,IAAI,IAAI;IAKrB,YAAY,IAAI,IAAI;IASpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAmCpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAqB1B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAmB9B;IAEF,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,cAAc;CAsBvB"}

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

@@ -1,6 +1,7 @@
 import { StateManager } from '../managers/state.manager';
 import { ErrorType, EventType } from '../types';
-import { PII_PATTERNS, MAX_ERROR_MESSAGE_LENGTH, ERROR_SUPPRESSION_WINDOW_MS, MAX_TRACKED_ERRORS, MAX_TRACKED_ERRORS_HARD_LIMIT, DEFAULT_ERROR_SAMPLING_RATE, } from '../constants/error.constants';
+import { log } from '../utils';
+import { PII_PATTERNS, MAX_ERROR_MESSAGE_LENGTH, ERROR_SUPPRESSION_WINDOW_MS, MAX_TRACKED_ERRORS, MAX_TRACKED_ERRORS_HARD_LIMIT, DEFAULT_ERROR_SAMPLING_RATE, ERROR_BURST_WINDOW_MS, ERROR_BURST_THRESHOLD, ERROR_BURST_BACKOFF_MS, } from '../constants/error.constants';
 /**
  * Simplified error handler for tracking JavaScript errors and unhandled promise rejections
  * Includes PII sanitization and sampling support
@@ -9,6 +10,9 @@ export class ErrorHandler extends StateManager {
     constructor(eventManager) {
         super();
         this.recentErrors = new Map();
+        this.errorBurstCounter = 0;
+        this.burstWindowStart = 0;
+        this.burstBackoffUntil = 0;
         this.handleError = (event) => {
             if (!this.shouldSample()) {
                 return;
@@ -55,8 +59,39 @@ export class ErrorHandler extends StateManager {
         window.removeEventListener('error', this.handleError);
         window.removeEventListener('unhandledrejection', this.handleRejection);
         this.recentErrors.clear();
+        this.errorBurstCounter = 0;
+        this.burstWindowStart = 0;
+        this.burstBackoffUntil = 0;
     }
+    /**
+     * Checks sampling rate and burst detection (Phase 3)
+     * Returns false if in cooldown period after burst detection
+     */
     shouldSample() {
+        const now = Date.now();
+        // Check if in backoff period (Phase 3)
+        if (now < this.burstBackoffUntil) {
+            return false;
+        }
+        // Reset burst counter if window expired
+        if (now - this.burstWindowStart > ERROR_BURST_WINDOW_MS) {
+            this.errorBurstCounter = 0;
+            this.burstWindowStart = now;
+        }
+        // Increment burst counter
+        this.errorBurstCounter++;
+        // Trigger backoff if burst threshold exceeded
+        if (this.errorBurstCounter > ERROR_BURST_THRESHOLD) {
+            this.burstBackoffUntil = now + ERROR_BURST_BACKOFF_MS;
+            log('warn', 'Error burst detected - entering cooldown', {
+                data: {
+                    errorsInWindow: this.errorBurstCounter,
+                    cooldownMs: ERROR_BURST_BACKOFF_MS,
+                },
+            });
+            return false;
+        }
+        // Normal sampling logic
         const config = this.get('config');
         const samplingRate = config?.errorSampling ?? DEFAULT_ERROR_SAMPLING_RATE;
         return Math.random() < samplingRate;

package/dist/esm/handlers/error.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.handler.js","sourceRoot":"","sources":["../../../src/handlers/error.handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error.handler.js","sourceRoot":"","sources":["../../../src/handlers/error.handler.ts"],"names":[],"mappings":"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"}

package/dist/esm/handlers/page-view.handler.d.ts

@@ -5,6 +5,7 @@ export declare class PageViewHandler extends StateManager {
     private readonly onTrack;
     private originalPushState?;
     private originalReplaceState?;
+    private lastPageViewTime;
     constructor(eventManager: EventManager, onTrack: () => void);
     startTracking(): void;
     stopTracking(): void;

package/dist/esm/handlers/page-view.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-view.handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/page-view.handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,OAAO,CAAC,iBAAiB,CAAC,CAAkC;IAC5D,OAAO,CAAC,oBAAoB,CAAC,CAAqC;gBAEtD,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI;IAO3D,aAAa,IAAI,IAAI;IAUrB,YAAY,IAAI,IAAI;IAapB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAqB/B;IAEF,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,mBAAmB;CAoB5B"}
+{"version":3,"file":"page-view.handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/page-view.handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,OAAO,CAAC,iBAAiB,CAAC,CAAkC;IAC5D,OAAO,CAAC,oBAAoB,CAAC,CAAqC;IAClE,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,IAAI;IAO3D,aAAa,IAAI,IAAI;IAUrB,YAAY,IAAI,IAAI;IAepB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CA+B/B;IAEF,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,mBAAmB;CAoB5B"}

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

@@ -1,15 +1,24 @@
 import { EventType } from '../types';
 import { normalizeUrl } from '../utils';
 import { StateManager } from '../managers/state.manager';
+import { DEFAULT_PAGE_VIEW_THROTTLE_MS } from '../constants/config.constants';
 export class PageViewHandler extends StateManager {
     constructor(eventManager, onTrack) {
         super();
+        this.lastPageViewTime = 0;
         this.trackCurrentPage = () => {
             const rawUrl = window.location.href;
             const normalizedUrl = normalizeUrl(rawUrl, this.get('config').sensitiveQueryParams);
             if (this.get('pageUrl') === normalizedUrl) {
                 return;
             }
+            // Throttle: Prevent rapid navigation spam
+            const now = Date.now();
+            const throttleMs = this.get('config').pageViewThrottleMs ?? DEFAULT_PAGE_VIEW_THROTTLE_MS;
+            if (now - this.lastPageViewTime < throttleMs) {
+                return;
+            }
+            this.lastPageViewTime = now;
             this.onTrack();
             const fromUrl = this.get('pageUrl');
             this.set('pageUrl', normalizedUrl);
@@ -40,6 +49,7 @@ export class PageViewHandler extends StateManager {
         if (this.originalReplaceState) {
             window.history.replaceState = this.originalReplaceState;
         }
+        this.lastPageViewTime = 0;
     }
     patchHistory(method) {
         const original = window.history[method];
@@ -57,6 +67,7 @@ export class PageViewHandler extends StateManager {
     trackInitialPageView() {
         const normalizedUrl = normalizeUrl(window.location.href, this.get('config').sensitiveQueryParams);
         const pageViewData = this.extractPageViewData();
+        this.lastPageViewTime = Date.now();
         this.eventManager.track({
             type: EventType.PAGE_VIEW,
             page_url: normalizedUrl,

package/dist/esm/handlers/page-view.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-view.handler.js","sourceRoot":"","sources":["../../../src/handlers/page-view.handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"page-view.handler.js","sourceRoot":"","sources":["../../../src/handlers/page-view.handler.ts"],"names":[],"mappings":"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"}

package/dist/esm/handlers/performance.handler.js

@@ -81,11 +81,11 @@ export class PerformanceHandler extends StateManager {
                 const value = Number(metric.value.toFixed(PRECISION_TWO_DECIMALS));
                 this.sendVital({ type, value });
             };
-            onLCP(report('LCP'));
-            onCLS(report('CLS'));
-            onFCP(report('FCP'));
-            onTTFB(report('TTFB'));
-            onINP(report('INP'));
+            onLCP(report('LCP'), { reportAllChanges: false });
+            onCLS(report('CLS'), { reportAllChanges: false });
+            onFCP(report('FCP'), { reportAllChanges: false });
+            onTTFB(report('TTFB'), { reportAllChanges: false });
+            onINP(report('INP'), { reportAllChanges: false });
         }
         catch (error) {
             log('warn', 'Failed to load web-vitals library, using fallback', { error });

package/dist/esm/handlers/performance.handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"performance.handler.js","sourceRoot":"","sources":["../../../src/handlers/performance.handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"performance.handler.js","sourceRoot":"","sources":["../../../src/handlers/performance.handler.ts"],"names":[],"mappings":"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"}

package/dist/esm/handlers/viewport.handler.d.ts

@@ -0,0 +1,44 @@
+import { EventManager } from '../managers/event.manager';
+import { StateManager } from '../managers/state.manager';
+/**
+ * Handles viewport visibility tracking using IntersectionObserver API.
+ * Fires events when elements become visible for a minimum dwell time.
+ */
+export declare class ViewportHandler extends StateManager {
+    private readonly eventManager;
+    private readonly trackedElements;
+    private observer;
+    private mutationObserver;
+    private mutationDebounceTimer;
+    private config;
+    constructor(eventManager: EventManager);
+    /**
+     * Starts tracking viewport visibility for configured elements
+     */
+    startTracking(): void;
+    /**
+     * Stops tracking and cleans up resources
+     */
+    stopTracking(): void;
+    /**
+     * Query and observe all elements matching configured elements
+     */
+    private observeElements;
+    /**
+     * Handles intersection events from IntersectionObserver
+     */
+    private readonly handleIntersection;
+    /**
+     * Fires a viewport visible event
+     */
+    private fireViewportEvent;
+    /**
+     * Sets up MutationObserver to detect dynamically added elements
+     */
+    private setupMutationObserver;
+    /**
+     * Cleans up tracking for removed DOM nodes
+     */
+    private cleanupRemovedNodes;
+}
+//# sourceMappingURL=viewport.handler.d.ts.map

package/dist/esm/handlers/viewport.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/viewport.handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAezD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IACtE,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,MAAM,CAA+B;gBAEjC,YAAY,EAAE,YAAY;IAKtC;;OAEG;IACH,aAAa,IAAI,IAAI;IAyCrB;;OAEG;IACH,YAAY,IAAI,IAAI;IA4BpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAyDvB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CA+BjC;IAEF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8C7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA8B5B"}

package/dist/esm/handlers/viewport.handler.js

@@ -0,0 +1,282 @@
+import { HTML_DATA_ATTR_PREFIX, DEFAULT_VIEWPORT_COOLDOWN_PERIOD, DEFAULT_VIEWPORT_MAX_TRACKED_ELEMENTS, VIEWPORT_MUTATION_DEBOUNCE_MS, } from '../constants';
+import { StateManager } from '../managers/state.manager';
+import { EventType } from '../types';
+import { log } from '../utils';
+/**
+ * Handles viewport visibility tracking using IntersectionObserver API.
+ * Fires events when elements become visible for a minimum dwell time.
+ */
+export class ViewportHandler extends StateManager {
+    constructor(eventManager) {
+        super();
+        this.trackedElements = new Map();
+        this.observer = null;
+        this.mutationObserver = null;
+        this.mutationDebounceTimer = null;
+        this.config = null;
+        /**
+         * Handles intersection events from IntersectionObserver
+         */
+        this.handleIntersection = (entries) => {
+            if (!this.config)
+                return;
+            const minDwellTime = this.config.minDwellTime ?? 1000;
+            for (const entry of entries) {
+                const tracked = this.trackedElements.get(entry.target);
+                if (!tracked)
+                    continue;
+                if (entry.isIntersecting) {
+                    // Element became visible
+                    if (tracked.startTime === null) {
+                        tracked.startTime = performance.now();
+                        // Set timer to fire event after minDwellTime
+                        tracked.timeoutId = window.setTimeout(() => {
+                            this.fireViewportEvent(tracked, entry.intersectionRatio);
+                        }, minDwellTime);
+                    }
+                }
+                else {
+                    // Element became hidden
+                    if (tracked.startTime !== null) {
+                        // Clear timer if element hidden before minDwellTime elapsed
+                        if (tracked.timeoutId !== null) {
+                            window.clearTimeout(tracked.timeoutId);
+                            tracked.timeoutId = null;
+                        }
+                        tracked.startTime = null;
+                    }
+                }
+            }
+        };
+        this.eventManager = eventManager;
+    }
+    /**
+     * Starts tracking viewport visibility for configured elements
+     */
+    startTracking() {
+        // Get viewport config from state
+        const config = this.get('config');
+        this.config = config.viewport ?? null;
+        if (!this.config?.elements || this.config.elements.length === 0) {
+            return;
+        }
+        // Set defaults
+        const threshold = this.config.threshold ?? 0.5;
+        const minDwellTime = this.config.minDwellTime ?? 1000;
+        if (threshold < 0 || threshold > 1) {
+            log('warn', 'ViewportHandler: Invalid threshold, must be between 0 and 1');
+            return;
+        }
+        if (minDwellTime < 0) {
+            log('warn', 'ViewportHandler: Invalid minDwellTime, must be non-negative');
+            return;
+        }
+        // Check IntersectionObserver support
+        if (typeof IntersectionObserver === 'undefined') {
+            log('warn', 'ViewportHandler: IntersectionObserver not supported in this browser');
+            return;
+        }
+        // Create observer
+        this.observer = new IntersectionObserver(this.handleIntersection, {
+            threshold,
+        });
+        // Find and observe all matching elements
+        this.observeElements();
+        // Set up MutationObserver to detect dynamically added elements
+        this.setupMutationObserver();
+    }
+    /**
+     * Stops tracking and cleans up resources
+     */
+    stopTracking() {
+        // Disconnect observers
+        if (this.observer) {
+            this.observer.disconnect();
+            this.observer = null;
+        }
+        if (this.mutationObserver) {
+            this.mutationObserver.disconnect();
+            this.mutationObserver = null;
+        }
+        // Clear debounce timer
+        if (this.mutationDebounceTimer !== null) {
+            window.clearTimeout(this.mutationDebounceTimer);
+            this.mutationDebounceTimer = null;
+        }
+        // Clear all timers and tracked elements
+        for (const tracked of this.trackedElements.values()) {
+            if (tracked.timeoutId !== null) {
+                window.clearTimeout(tracked.timeoutId);
+            }
+        }
+        this.trackedElements.clear();
+    }
+    /**
+     * Query and observe all elements matching configured elements
+     */
+    observeElements() {
+        if (!this.config || !this.observer)
+            return;
+        const maxTrackedElements = this.config.maxTrackedElements ?? DEFAULT_VIEWPORT_MAX_TRACKED_ELEMENTS;
+        let totalTracked = this.trackedElements.size;
+        for (const elementConfig of this.config.elements) {
+            try {
+                const elements = document.querySelectorAll(elementConfig.selector);
+                for (const element of Array.from(elements)) {
+                    // Check max limit (Phase 3)
+                    if (totalTracked >= maxTrackedElements) {
+                        log('warn', 'ViewportHandler: Maximum tracked elements reached', {
+                            data: {
+                                limit: maxTrackedElements,
+                                selector: elementConfig.selector,
+                                message: 'Some elements will not be tracked. Consider more specific selectors.',
+                            },
+                        });
+                        return; // Stop tracking more elements
+                    }
+                    // Skip if element has data-tlog-ignore attribute
+                    if (element.hasAttribute(`${HTML_DATA_ATTR_PREFIX}-ignore`)) {
+                        continue;
+                    }
+                    // Skip if already tracked
+                    if (this.trackedElements.has(element)) {
+                        continue;
+                    }
+                    // Track and observe element with identifiers
+                    this.trackedElements.set(element, {
+                        element,
+                        selector: elementConfig.selector,
+                        id: elementConfig.id,
+                        name: elementConfig.name,
+                        startTime: null,
+                        timeoutId: null,
+                        lastFiredTime: null,
+                    });
+                    this.observer?.observe(element);
+                    totalTracked++;
+                }
+            }
+            catch (error) {
+                log('warn', `ViewportHandler: Invalid selector "${elementConfig.selector}"`, { error });
+            }
+        }
+        log('debug', 'ViewportHandler: Elements tracked', {
+            data: { count: totalTracked, limit: maxTrackedElements },
+        });
+    }
+    /**
+     * Fires a viewport visible event
+     */
+    fireViewportEvent(tracked, visibilityRatio) {
+        if (tracked.startTime === null)
+            return;
+        const dwellTime = Math.round(performance.now() - tracked.startTime);
+        // Check data-tlog-ignore again (element might have changed)
+        if (tracked.element.hasAttribute('data-tlog-ignore')) {
+            return;
+        }
+        // Check cooldown period to prevent repeated events from carousels/sticky elements
+        const cooldownPeriod = this.config?.cooldownPeriod ?? DEFAULT_VIEWPORT_COOLDOWN_PERIOD;
+        const now = Date.now();
+        if (tracked.lastFiredTime !== null && now - tracked.lastFiredTime < cooldownPeriod) {
+            log('debug', 'ViewportHandler: Event suppressed by cooldown period', {
+                data: {
+                    selector: tracked.selector,
+                    cooldownRemaining: cooldownPeriod - (now - tracked.lastFiredTime),
+                },
+            });
+            tracked.startTime = null;
+            tracked.timeoutId = null;
+            return;
+        }
+        const eventData = {
+            selector: tracked.selector,
+            dwellTime,
+            visibilityRatio,
+            ...(tracked.id !== undefined && { id: tracked.id }),
+            ...(tracked.name !== undefined && { name: tracked.name }),
+        };
+        this.eventManager.track({
+            type: EventType.VIEWPORT_VISIBLE,
+            viewport_data: eventData,
+        });
+        // Reset tracking state after firing event and record timestamp
+        tracked.startTime = null;
+        tracked.timeoutId = null;
+        tracked.lastFiredTime = now;
+    }
+    /**
+     * Sets up MutationObserver to detect dynamically added elements
+     */
+    setupMutationObserver() {
+        if (!this.config || typeof MutationObserver === 'undefined') {
+            return;
+        }
+        // Check if document.body exists
+        if (!document.body) {
+            log('warn', 'ViewportHandler: document.body not available, skipping MutationObserver setup');
+            return;
+        }
+        this.mutationObserver = new MutationObserver((mutations) => {
+            let hasAddedNodes = false;
+            // Check what changed
+            for (const mutation of mutations) {
+                if (mutation.type === 'childList') {
+                    if (mutation.addedNodes.length > 0) {
+                        hasAddedNodes = true;
+                    }
+                    if (mutation.removedNodes.length > 0) {
+                        // Clean up removed nodes immediately
+                        this.cleanupRemovedNodes(mutation.removedNodes);
+                    }
+                }
+            }
+            // Debounce re-observing for added nodes (batch multiple mutations)
+            if (hasAddedNodes) {
+                if (this.mutationDebounceTimer !== null) {
+                    window.clearTimeout(this.mutationDebounceTimer);
+                }
+                this.mutationDebounceTimer = window.setTimeout(() => {
+                    this.observeElements();
+                    this.mutationDebounceTimer = null;
+                }, VIEWPORT_MUTATION_DEBOUNCE_MS);
+            }
+        });
+        // Observe the entire document for added/removed nodes
+        this.mutationObserver.observe(document.body, {
+            childList: true,
+            subtree: true,
+        });
+    }
+    /**
+     * Cleans up tracking for removed DOM nodes
+     */
+    cleanupRemovedNodes(removedNodes) {
+        removedNodes.forEach((node) => {
+            if (node.nodeType !== 1)
+                return; // 1 = ELEMENT_NODE
+            const element = node;
+            const tracked = this.trackedElements.get(element);
+            if (tracked) {
+                // Clear pending timer
+                if (tracked.timeoutId !== null) {
+                    window.clearTimeout(tracked.timeoutId);
+                }
+                // Unobserve and remove from tracking
+                this.observer?.unobserve(element);
+                this.trackedElements.delete(element);
+            }
+            // Also check descendants
+            const descendants = Array.from(this.trackedElements.keys()).filter((el) => element.contains(el));
+            descendants.forEach((el) => {
+                const descendantTracked = this.trackedElements.get(el);
+                if (descendantTracked && descendantTracked.timeoutId !== null) {
+                    window.clearTimeout(descendantTracked.timeoutId);
+                }
+                this.observer?.unobserve(el);
+                this.trackedElements.delete(el);
+            });
+        });
+    }
+}
+//# sourceMappingURL=viewport.handler.js.map

package/dist/esm/handlers/viewport.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.handler.js","sourceRoot":"","sources":["../../../src/handlers/viewport.handler.ts"],"names":[],"mappings":"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"}

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

@@ -9,14 +9,16 @@ export declare class EventManager extends StateManager {
     private readonly emitter;
     private eventsQueue;
     private pendingEventsBuffer;
-    private lastEventFingerprint;
-    private lastEventTime;
+    private readonly recentEventFingerprints;
     private sendIntervalId;
     private rateLimitCounter;
     private rateLimitWindowStart;
+    private readonly perEventRateLimits;
+    private sessionEventCounts;
+    private lastSessionId;
     constructor(storeManager: StorageManager, googleAnalytics?: GoogleAnalyticsIntegration | null, emitter?: Emitter | null);
     recoverPersistedEvents(): Promise<void>;
-    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, }: Partial<EventData>): void;
+    track({ type, page_url, from_page_url, scroll_data, click_data, custom_event, web_vitals, error_data, session_end_reason, viewport_data, }: Partial<EventData>): void;
     stop(): void;
     flushImmediately(): Promise<boolean>;
     flushImmediatelySync(): boolean;
@@ -27,7 +29,16 @@ export declare class EventManager extends StateManager {
     private sendEventsQueue;
     private buildEventsPayload;
     private buildEventPayload;
+    /**
+     * Checks if event is a duplicate using time-based cache
+     * Tracks recent event fingerprints with timestamp-based cleanup
+     */
     private isDuplicateEvent;
+    /**
+     * Prunes old fingerprints from cache based on timestamp
+     * Removes entries older than 10x the duplicate threshold (5 seconds)
+     */
+    private pruneOldFingerprints;
     private createEventFingerprint;
     private createEventSignature;
     private addToQueue;
@@ -35,6 +46,15 @@ export declare class EventManager extends StateManager {
     private handleGoogleAnalyticsIntegration;
     private shouldSample;
     private checkRateLimit;
+    /**
+     * Checks per-event-name rate limiting to prevent infinite loops in user code
+     * Tracks timestamps per event name and limits to maxSameEventPerMinute per minute
+     */
+    private checkPerEventRateLimit;
+    /**
+     * Gets the per-session limit for a specific event type (Phase 3)
+     */
+    private getTypeLimitForEvent;
     private removeProcessedEvents;
     private emitEvent;
     private emitEventsQueue;