@tracelog/lib 0.10.0 → 0.11.1

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

@@ -1,111 +1,235 @@
 import { MetadataType } from './common.types';
 import { SessionEndReason } from './session.types';
+/**
+ * Coordinate information from a click event
+ * Includes absolute and relative positioning
+ */
+export type ClickCoordinates = Pick<ClickData, 'x' | 'y' | 'relativeX' | 'relativeY'>;
+/**
+ * Web performance metric types tracked by the library
+ * - LCP: Largest Contentful Paint
+ * - CLS: Cumulative Layout Shift
+ * - INP: Interaction to Next Paint
+ * - FCP: First Contentful Paint
+ * - TTFB: Time to First Byte
+ * - LONG_TASK: Tasks exceeding 50ms
+ */
 export type WebVitalType = 'LCP' | 'CLS' | 'INP' | 'FCP' | 'TTFB' | 'LONG_TASK';
+/**
+ * Core event types tracked by TraceLog
+ */
 export declare enum EventType {
+    /** Page navigation and view tracking */
     PAGE_VIEW = "page_view",
+    /** User click interactions */
     CLICK = "click",
+    /** Scroll depth and behavior */
     SCROLL = "scroll",
+    /** Session initialization */
     SESSION_START = "session_start",
+    /** Session termination */
     SESSION_END = "session_end",
+    /** Custom business events */
     CUSTOM = "custom",
+    /** Performance metrics */
     WEB_VITALS = "web_vitals",
-    ERROR = "error"
+    /** JavaScript errors and rejections */
+    ERROR = "error",
+    /** Element visibility tracking */
+    VIEWPORT_VISIBLE = "viewport_visible"
 }
+/**
+ * Scroll direction indicators
+ */
 export declare enum ScrollDirection {
+    /** Scrolling upward */
     UP = "up",
+    /** Scrolling downward */
     DOWN = "down"
 }
+/**
+ * JavaScript error classification
+ */
 export declare enum ErrorType {
+    /** Runtime JavaScript errors */
     JS_ERROR = "js_error",
+    /** Unhandled promise rejections */
     PROMISE_REJECTION = "promise_rejection"
 }
+/**
+ * Scroll event data captured during user scrolling
+ */
 export interface ScrollData {
+    /** Current scroll depth as percentage (0-100) */
     depth: number;
+    /** Direction of scroll movement */
     direction: ScrollDirection;
+    /** CSS selector of the scrolled container */
     container_selector: string;
+    /** Whether this is the primary viewport scroll */
     is_primary: boolean;
+    /** Scroll velocity in pixels per second */
     velocity: number;
+    /** Maximum scroll depth reached during session (0-100) */
     max_depth_reached: number;
 }
-export type PrimaryScrollEvent = EventData & {
-    type: EventType.SCROLL;
-    scroll_data: ScrollData & {
-        is_primary: true;
-    };
-};
-export type SecondaryScrollEvent = EventData & {
-    type: EventType.SCROLL;
-    scroll_data: ScrollData & {
-        is_primary: false;
-    };
-};
-export declare function isPrimaryScrollEvent(event: EventData): event is PrimaryScrollEvent;
-export declare function isSecondaryScrollEvent(event: EventData): event is SecondaryScrollEvent;
+/**
+ * Click event data capturing user interaction details
+ */
 export interface ClickData {
+    /** Absolute X coordinate in viewport (pixels) */
     x: number;
+    /** Absolute Y coordinate in viewport (pixels) */
     y: number;
+    /** Relative X position within element (0-1) */
     relativeX: number;
+    /** Relative Y position within element (0-1) */
     relativeY: number;
+    /** Element ID attribute */
     id?: string;
+    /** Element class attribute */
     class?: string;
+    /** HTML tag name */
     tag?: string;
+    /** Element text content (truncated) */
     text?: string;
+    /** Link href for anchor elements */
     href?: string;
+    /** Element title attribute */
     title?: string;
+    /** Image alt text for img elements */
     alt?: string;
+    /** ARIA role attribute */
     role?: string;
+    /** ARIA label attribute */
     ariaLabel?: string;
+    /** Custom data attributes (data-*) */
     dataAttributes?: Record<string, string>;
 }
-export type ClickCoordinates = Pick<ClickData, 'x' | 'y' | 'relativeX' | 'relativeY'>;
+/**
+ * Element data for specialized click tracking
+ * Used for form inputs and interactive elements
+ */
 export interface ClickTrackingElementData {
+    /** DOM element being tracked */
     element: HTMLElement;
+    /** Descriptive name for the element */
     name: string;
+    /** Element value (for inputs) */
     value?: string;
 }
+/**
+ * Custom event data for business-specific tracking
+ */
 export interface CustomEventData {
+    /** Event name identifier */
     name: string;
+    /** Additional event metadata */
     metadata?: Record<string, MetadataType> | Record<string, MetadataType>[];
 }
+/**
+ * Web performance metrics data
+ */
 export interface WebVitalsData {
+    /** Type of performance metric */
     type: WebVitalType;
+    /** Metric value (varies by type) */
     value: number;
 }
+/**
+ * JavaScript error details
+ */
 export interface ErrorData {
+    /** Error classification */
     type: ErrorType;
+    /** Error message text */
     message: string;
+    /** Source file where error occurred */
     filename?: string;
+    /** Line number in source file */
     line?: number;
+    /** Column number in source file */
     column?: number;
 }
+/**
+ * UTM campaign tracking parameters
+ */
 export interface UTM {
+    /** Campaign source (e.g., google, newsletter) */
     source?: string;
+    /** Campaign medium (e.g., cpc, email) */
     medium?: string;
+    /** Campaign name identifier */
     campaign?: string;
+    /** Campaign search term */
     term?: string;
+    /** Campaign content variation */
     content?: string;
 }
+/**
+ * Page view navigation data
+ */
 export interface PageViewData {
+    /** Previous page URL */
     referrer?: string;
+    /** Page title from document */
     title?: string;
+    /** URL pathname */
     pathname?: string;
+    /** URL query string */
     search?: string;
+    /** URL hash fragment */
     hash?: string;
 }
+/**
+ * Data captured when element becomes visible
+ */
+export interface ViewportEventData {
+    /** CSS selector that matched the element */
+    selector: string;
+    /** Optional unique identifier for analytics (if configured) */
+    id?: string;
+    /** Optional human-readable name (if configured) */
+    name?: string;
+    /** Actual time (ms) element was visible before event fired */
+    dwellTime: number;
+    /** Actual visibility ratio when event fired (0-1) */
+    visibilityRatio: number;
+}
+/**
+ * Complete event data structure
+ * All events share base properties with type-specific data
+ */
 export interface EventData {
+    /** Unique event identifier */
     id: string;
+    /** Event type classification */
     type: EventType;
+    /** Current page URL where event occurred */
     page_url: string;
+    /** Unix timestamp (milliseconds) */
     timestamp: number;
+    /** HTTP referrer header */
     referrer?: string;
+    /** Previous page URL for navigation events */
     from_page_url?: string;
+    /** Scroll event details (when type is SCROLL) */
     scroll_data?: ScrollData;
+    /** Click event details (when type is CLICK) */
     click_data?: ClickData;
+    /** Custom event details (when type is CUSTOM) */
     custom_event?: CustomEventData;
+    /** Performance metrics (when type is WEB_VITALS) */
     web_vitals?: WebVitalsData;
+    /** Page view details (when type is PAGE_VIEW) */
     page_view?: PageViewData;
+    /** Session termination reason (when type is SESSION_END) */
     session_end_reason?: SessionEndReason;
+    /** Error details (when type is ERROR) */
     error_data?: ErrorData;
+    /** Viewport visibility details (when type is VIEWPORT_VISIBLE) */
+    viewport_data?: ViewportEventData;
+    /** Campaign tracking parameters */
     utm?: UTM;
 }
 //# sourceMappingURL=event.types.d.ts.map

package/dist/cjs/types/event.types.d.ts.map

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

package/dist/cjs/types/event.types.js

@@ -1,34 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorType = exports.ScrollDirection = exports.EventType = void 0;
-exports.isPrimaryScrollEvent = isPrimaryScrollEvent;
-exports.isSecondaryScrollEvent = isSecondaryScrollEvent;
+/**
+ * Core event types tracked by TraceLog
+ */
 var EventType;
 (function (EventType) {
+    /** Page navigation and view tracking */
     EventType["PAGE_VIEW"] = "page_view";
+    /** User click interactions */
     EventType["CLICK"] = "click";
+    /** Scroll depth and behavior */
     EventType["SCROLL"] = "scroll";
+    /** Session initialization */
     EventType["SESSION_START"] = "session_start";
+    /** Session termination */
     EventType["SESSION_END"] = "session_end";
+    /** Custom business events */
     EventType["CUSTOM"] = "custom";
+    /** Performance metrics */
     EventType["WEB_VITALS"] = "web_vitals";
+    /** JavaScript errors and rejections */
     EventType["ERROR"] = "error";
+    /** Element visibility tracking */
+    EventType["VIEWPORT_VISIBLE"] = "viewport_visible";
 })(EventType || (exports.EventType = EventType = {}));
+/**
+ * Scroll direction indicators
+ */
 var ScrollDirection;
 (function (ScrollDirection) {
+    /** Scrolling upward */
     ScrollDirection["UP"] = "up";
+    /** Scrolling downward */
     ScrollDirection["DOWN"] = "down";
 })(ScrollDirection || (exports.ScrollDirection = ScrollDirection = {}));
+/**
+ * JavaScript error classification
+ */
 var ErrorType;
 (function (ErrorType) {
+    /** Runtime JavaScript errors */
     ErrorType["JS_ERROR"] = "js_error";
+    /** Unhandled promise rejections */
     ErrorType["PROMISE_REJECTION"] = "promise_rejection";
 })(ErrorType || (exports.ErrorType = ErrorType = {}));
-// Type guard functions
-function isPrimaryScrollEvent(event) {
-    return (event.type === EventType.SCROLL && 'scroll_data' in event && event.scroll_data.is_primary === true);
-}
-function isSecondaryScrollEvent(event) {
-    return (event.type === EventType.SCROLL && 'scroll_data' in event && event.scroll_data.is_primary === false);
-}
 //# sourceMappingURL=event.types.js.map

package/dist/cjs/types/event.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.types.js","sourceRoot":"","sources":["../../../src/types/event.types.ts"],"names":[],"mappings":";;;AA+CA,oDAIC;AAED,wDAIC;AApDD,IAAY,SASX;AATD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,4BAAe,CAAA;IACf,8BAAiB,CAAA;IACjB,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;IAC3B,8BAAiB,CAAA;IACjB,sCAAyB,CAAA;IACzB,4BAAe,CAAA;AACjB,CAAC,EATW,SAAS,yBAAT,SAAS,QASpB;AAED,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,gCAAa,CAAA;AACf,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B;AAED,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,kCAAqB,CAAA;IACrB,oDAAuC,CAAA;AACzC,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB;AAsBD,uBAAuB;AACvB,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,aAAa,IAAI,KAAK,IAAK,KAAK,CAAC,WAA0B,CAAC,UAAU,KAAK,IAAI,CACnH,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAgB;IACrD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,aAAa,IAAI,KAAK,IAAK,KAAK,CAAC,WAA0B,CAAC,UAAU,KAAK,KAAK,CACpH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"event.types.js","sourceRoot":"","sources":["../../../src/types/event.types.ts"],"names":[],"mappings":";;;AAoBA;;GAEG;AACH,IAAY,SAmBX;AAnBD,WAAY,SAAS;IACnB,wCAAwC;IACxC,oCAAuB,CAAA;IACvB,8BAA8B;IAC9B,4BAAe,CAAA;IACf,gCAAgC;IAChC,8BAAiB,CAAA;IACjB,6BAA6B;IAC7B,4CAA+B,CAAA;IAC/B,0BAA0B;IAC1B,wCAA2B,CAAA;IAC3B,6BAA6B;IAC7B,8BAAiB,CAAA;IACjB,0BAA0B;IAC1B,sCAAyB,CAAA;IACzB,uCAAuC;IACvC,4BAAe,CAAA;IACf,kCAAkC;IAClC,kDAAqC,CAAA;AACvC,CAAC,EAnBW,SAAS,yBAAT,SAAS,QAmBpB;AAED;;GAEG;AACH,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,uBAAuB;IACvB,4BAAS,CAAA;IACT,yBAAyB;IACzB,gCAAa,CAAA;AACf,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B;AAED;;GAEG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,gCAAgC;IAChC,kCAAqB,CAAA;IACrB,mCAAmC;IACnC,oDAAuC,CAAA;AACzC,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB"}

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

@@ -7,9 +7,11 @@ export * from './event.types';
 export * from './log.types';
 export * from './mode.types';
 export * from './queue.types';
+export * from './scroll.types';
 export * from './session.types';
 export * from './state.types';
 export * from './test-bridge.types';
 export * from './validation-error.types';
+export * from './viewport.types';
 export * from './window.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/cjs/types/index.js

@@ -23,9 +23,11 @@ __exportStar(require("./event.types"), exports);
 __exportStar(require("./log.types"), exports);
 __exportStar(require("./mode.types"), exports);
 __exportStar(require("./queue.types"), exports);
+__exportStar(require("./scroll.types"), exports);
 __exportStar(require("./session.types"), exports);
 __exportStar(require("./state.types"), exports);
 __exportStar(require("./test-bridge.types"), exports);
 __exportStar(require("./validation-error.types"), exports);
+__exportStar(require("./viewport.types"), exports);
 __exportStar(require("./window.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,iDAA+B;AAC/B,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAC7B,gDAA8B;AAC9B,kDAAgC;AAChC,gDAA8B;AAC9B,sDAAoC;AACpC,2DAAyC;AACzC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,iDAA+B;AAC/B,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,gDAA8B;AAC9B,8CAA4B;AAC5B,+CAA6B;AAC7B,gDAA8B;AAC9B,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,sDAAoC;AACpC,2DAAyC;AACzC,mDAAiC;AACjC,iDAA+B"}

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

@@ -0,0 +1,16 @@
+import { EventData, EventType, ScrollData } from './event.types';
+export type PrimaryScrollEvent = EventData & {
+    type: EventType.SCROLL;
+    scroll_data: ScrollData & {
+        is_primary: true;
+    };
+};
+export type SecondaryScrollEvent = EventData & {
+    type: EventType.SCROLL;
+    scroll_data: ScrollData & {
+        is_primary: false;
+    };
+};
+export declare function isPrimaryScrollEvent(event: EventData): event is PrimaryScrollEvent;
+export declare function isSecondaryScrollEvent(event: EventData): event is SecondaryScrollEvent;
+//# sourceMappingURL=scroll.types.d.ts.map

package/dist/cjs/types/scroll.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.types.d.ts","sourceRoot":"","sources":["../../../src/types/scroll.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG;IAC3C,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;IACvB,WAAW,EAAE,UAAU,GAAG;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG;IAC7C,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;IACvB,WAAW,EAAE,UAAU,GAAG;QAAE,UAAU,EAAE,KAAK,CAAA;KAAE,CAAC;CACjD,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,kBAAkB,CAIlF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,oBAAoB,CAItF"}

package/dist/cjs/types/scroll.types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPrimaryScrollEvent = isPrimaryScrollEvent;
+exports.isSecondaryScrollEvent = isSecondaryScrollEvent;
+const event_types_1 = require("./event.types");
+function isPrimaryScrollEvent(event) {
+    return (event.type === event_types_1.EventType.SCROLL && 'scroll_data' in event && event.scroll_data.is_primary === true);
+}
+function isSecondaryScrollEvent(event) {
+    return (event.type === event_types_1.EventType.SCROLL && 'scroll_data' in event && event.scroll_data.is_primary === false);
+}
+//# sourceMappingURL=scroll.types.js.map

package/dist/cjs/types/scroll.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.types.js","sourceRoot":"","sources":["../../../src/types/scroll.types.ts"],"names":[],"mappings":";;AAYA,oDAIC;AAED,wDAIC;AAtBD,+CAAiE;AAYjE,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,uBAAS,CAAC,MAAM,IAAI,aAAa,IAAI,KAAK,IAAK,KAAK,CAAC,WAA0B,CAAC,UAAU,KAAK,IAAI,CACnH,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAgB;IACrD,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,uBAAS,CAAC,MAAM,IAAI,aAAa,IAAI,KAAK,IAAK,KAAK,CAAC,WAA0B,CAAC,UAAU,KAAK,KAAK,CACpH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Element configuration for viewport tracking with optional identifiers
+ */
+export interface ViewportElement {
+    /**
+     * CSS selector for the element
+     * @example '.hero' | '.cta-button' | '#pricing'
+     */
+    selector: string;
+    /**
+     * Optional unique identifier for analytics
+     * Used to distinguish between multiple elements with the same selector
+     * @example 'homepage-hero' | 'pricing-cta' | 'customer-testimonials'
+     */
+    id?: string;
+    /**
+     * Optional human-readable name for dashboards and reports
+     * @example 'Homepage Hero Banner' | 'Pricing Page CTA' | 'Customer Testimonials Section'
+     */
+    name?: string;
+}
+/**
+ * Configuration for viewport visibility tracking
+ */
+export interface ViewportConfig {
+    /**
+     * Elements to track with optional identifiers
+     * Provides analytics support with business identifiers
+     * @example [{ selector: '.hero', id: 'homepage-hero', name: 'Homepage Hero Banner' }]
+     */
+    elements: ViewportElement[];
+    /**
+     * Minimum percentage of element that must be visible (0-1)
+     * @default 0.5 (50%)
+     */
+    threshold?: number;
+    /**
+     * Minimum time (ms) element must be visible to count as a view
+     * @default 1000 (1 second)
+     */
+    minDwellTime?: number;
+    /**
+     * Cooldown period (ms) before same element can fire visibility event again
+     * Prevents repeated events from carousels, sticky headers, and scrolling patterns
+     * @default 60000 (60 seconds)
+     */
+    cooldownPeriod?: number;
+    /**
+     * Maximum number of elements to track simultaneously (Phase 3)
+     * Prevents memory/server issues with broad selectors
+     * @default 100
+     */
+    maxTrackedElements?: number;
+}
+//# sourceMappingURL=viewport.types.d.ts.map

package/dist/cjs/types/viewport.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.types.d.ts","sourceRoot":"","sources":["../../../src/types/viewport.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,eAAe,EAAE,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/cjs/types/viewport.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=viewport.types.js.map

package/dist/cjs/types/viewport.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.types.js","sourceRoot":"","sources":["../../../src/types/viewport.types.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/validations/config-validations.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-validations.utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/validations/config-validations.utils.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,IAsEnD,CAAC;AAmEF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,KAAG,MAqB5D,CAAC"}
+{"version":3,"file":"config-validations.utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/validations/config-validations.utils.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,IA4FnD,CAAC;AA8IF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,KAAG,MAmC5D,CAAC"}

package/dist/cjs/utils/validations/config-validations.utils.js

@@ -67,8 +67,86 @@ const validateAppConfig = (config) => {
             }
         }
     }
+    if (config.pageViewThrottleMs !== undefined) {
+        if (typeof config.pageViewThrottleMs !== 'number' || config.pageViewThrottleMs < 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_PAGE_VIEW_THROTTLE, 'config');
+        }
+    }
+    if (config.clickThrottleMs !== undefined) {
+        if (typeof config.clickThrottleMs !== 'number' || config.clickThrottleMs < 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_CLICK_THROTTLE, 'config');
+        }
+    }
+    if (config.maxSameEventPerMinute !== undefined) {
+        if (typeof config.maxSameEventPerMinute !== 'number' || config.maxSameEventPerMinute <= 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_MAX_SAME_EVENT_PER_MINUTE, 'config');
+        }
+    }
+    if (config.viewport !== undefined) {
+        validateViewportConfig(config.viewport);
+    }
 };
 exports.validateAppConfig = validateAppConfig;
+/**
+ * Validates viewport configuration
+ * @param viewport - Viewport configuration to validate
+ */
+const validateViewportConfig = (viewport) => {
+    if (typeof viewport !== 'object' || viewport === null) {
+        throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_CONFIG, 'config');
+    }
+    // Validate elements array
+    if (!viewport.elements || !Array.isArray(viewport.elements)) {
+        throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_ELEMENTS, 'config');
+    }
+    if (viewport.elements.length === 0) {
+        throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_ELEMENTS, 'config');
+    }
+    // Track unique selectors to detect duplicates
+    const uniqueSelectors = new Set();
+    // Validate each element
+    for (const element of viewport.elements) {
+        if (!element.selector || typeof element.selector !== 'string' || !element.selector.trim()) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_ELEMENT, 'config');
+        }
+        // Check for duplicate selectors
+        const normalizedSelector = element.selector.trim();
+        if (uniqueSelectors.has(normalizedSelector)) {
+            throw new validation_error_types_1.AppConfigValidationError(`Duplicate viewport selector found: "${normalizedSelector}". Each selector should appear only once.`, 'config');
+        }
+        uniqueSelectors.add(normalizedSelector);
+        if (element.id !== undefined && (typeof element.id !== 'string' || !element.id.trim())) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_ELEMENT_ID, 'config');
+        }
+        if (element.name !== undefined && (typeof element.name !== 'string' || !element.name.trim())) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_ELEMENT_NAME, 'config');
+        }
+    }
+    // Validate threshold
+    if (viewport.threshold !== undefined) {
+        if (typeof viewport.threshold !== 'number' || viewport.threshold < 0 || viewport.threshold > 1) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_THRESHOLD, 'config');
+        }
+    }
+    // Validate minDwellTime
+    if (viewport.minDwellTime !== undefined) {
+        if (typeof viewport.minDwellTime !== 'number' || viewport.minDwellTime < 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_MIN_DWELL_TIME, 'config');
+        }
+    }
+    // Validate cooldownPeriod
+    if (viewport.cooldownPeriod !== undefined) {
+        if (typeof viewport.cooldownPeriod !== 'number' || viewport.cooldownPeriod < 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_COOLDOWN_PERIOD, 'config');
+        }
+    }
+    // Validate maxTrackedElements
+    if (viewport.maxTrackedElements !== undefined) {
+        if (typeof viewport.maxTrackedElements !== 'number' || viewport.maxTrackedElements <= 0) {
+            throw new validation_error_types_1.AppConfigValidationError(constants_1.VALIDATION_MESSAGES.INVALID_VIEWPORT_MAX_TRACKED_ELEMENTS, 'config');
+        }
+    }
+};
 /**
  * Validates integrations configuration
  * @param integrations - Integrations configuration to validate
@@ -131,6 +209,9 @@ const validateAndNormalizeConfig = (config) => {
         sensitiveQueryParams: config?.sensitiveQueryParams ?? [],
         errorSampling: config?.errorSampling ?? error_constants_1.DEFAULT_ERROR_SAMPLING_RATE,
         samplingRate: config?.samplingRate ?? constants_1.DEFAULT_SAMPLING_RATE,
+        pageViewThrottleMs: config?.pageViewThrottleMs ?? constants_1.DEFAULT_PAGE_VIEW_THROTTLE_MS,
+        clickThrottleMs: config?.clickThrottleMs ?? constants_1.DEFAULT_CLICK_THROTTLE_MS,
+        maxSameEventPerMinute: config?.maxSameEventPerMinute ?? constants_1.MAX_SAME_EVENT_PER_MINUTE,
     };
     // Normalize integrations
     if (normalizedConfig.integrations?.custom) {
@@ -139,6 +220,16 @@ const validateAndNormalizeConfig = (config) => {
             allowHttp: normalizedConfig.integrations.custom.allowHttp ?? false,
         };
     }
+    // Normalize viewport config
+    if (normalizedConfig.viewport) {
+        normalizedConfig.viewport = {
+            ...normalizedConfig.viewport,
+            threshold: normalizedConfig.viewport.threshold ?? 0.5,
+            minDwellTime: normalizedConfig.viewport.minDwellTime ?? constants_1.DEFAULT_VISIBILITY_TIMEOUT_MS,
+            cooldownPeriod: normalizedConfig.viewport.cooldownPeriod ?? constants_1.DEFAULT_VIEWPORT_COOLDOWN_PERIOD,
+            maxTrackedElements: normalizedConfig.viewport.maxTrackedElements ?? constants_1.DEFAULT_VIEWPORT_MAX_TRACKED_ELEMENTS,
+        };
+    }
     return normalizedConfig;
 };
 exports.validateAndNormalizeConfig = validateAndNormalizeConfig;

package/dist/cjs/utils/validations/config-validations.utils.js.map

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

package/dist/esm/app.d.ts

@@ -4,6 +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 { ViewportHandler } from './handlers/viewport.handler';
 import { Config, EmitterCallback, EmitterMap } from './types';
 import { GoogleAnalyticsIntegration } from './integrations/google-analytics.integration';
 import { StorageManager } from './managers/storage.manager';
@@ -24,6 +25,7 @@ export declare class App extends StateManager {
         scroll?: ScrollHandler;
         performance?: PerformanceHandler;
         error?: ErrorHandler;
+        viewport?: ViewportHandler;
     };
     protected integrations: {
         googleAnalytics?: GoogleAnalyticsIntegration;