@grainql/analytics-web 2.3.0 → 2.5.0

package/dist/cjs/section-tracking.js

@@ -0,0 +1,373 @@
+"use strict";
+/**
+ * Section Tracking Manager for Grain Analytics
+ * Intelligent scroll tracking with viewport metrics, visible sections, and engagement analysis
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionTrackingManager = void 0;
+const DEFAULT_OPTIONS = {
+    minDwellTime: 1000, // 1 second minimum
+    scrollVelocityThreshold: 500, // 500px/s
+    intersectionThreshold: 0.1, // 10% visible
+    debounceDelay: 100,
+    batchDelay: 2000, // 2 seconds
+    debug: false,
+};
+class SectionTrackingManager {
+    constructor(tracker, sections, options = {}) {
+        this.isDestroyed = false;
+        // Tracking state
+        this.sectionStates = new Map();
+        this.intersectionObserver = null;
+        this.xpathCache = new Map();
+        // Scroll tracking
+        this.lastScrollPosition = 0;
+        this.lastScrollTime = Date.now();
+        this.scrollVelocity = 0;
+        this.scrollDebounceTimer = null;
+        // Event batching
+        this.pendingEvents = [];
+        this.batchTimer = null;
+        this.tracker = tracker;
+        this.sections = sections;
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+            // Initialize after DOM is ready
+            if (document.readyState === 'loading') {
+                document.addEventListener('DOMContentLoaded', () => this.initialize());
+            }
+            else {
+                setTimeout(() => this.initialize(), 0);
+            }
+        }
+    }
+    /**
+     * Initialize section tracking
+     */
+    initialize() {
+        if (this.isDestroyed)
+            return;
+        this.log('Initializing section tracking for', this.sections.length, 'sections');
+        // Setup intersection observer
+        this.setupIntersectionObserver();
+        // Setup scroll listener for velocity tracking
+        this.setupScrollListener();
+        // Initialize sections
+        this.initializeSections();
+    }
+    /**
+     * Setup IntersectionObserver for section visibility
+     */
+    setupIntersectionObserver() {
+        if (typeof IntersectionObserver === 'undefined') {
+            this.log('IntersectionObserver not supported');
+            return;
+        }
+        this.intersectionObserver = new IntersectionObserver((entries) => {
+            entries.forEach((entry) => {
+                this.handleIntersection(entry);
+            });
+        }, {
+            threshold: [0, 0.1, 0.25, 0.5, 0.75, 1.0],
+            rootMargin: '0px',
+        });
+        this.log('IntersectionObserver created');
+    }
+    /**
+     * Setup scroll listener for velocity calculation
+     */
+    setupScrollListener() {
+        if (typeof window === 'undefined')
+            return;
+        const scrollHandler = () => {
+            if (this.scrollDebounceTimer !== null) {
+                clearTimeout(this.scrollDebounceTimer);
+            }
+            this.scrollDebounceTimer = window.setTimeout(() => {
+                this.updateScrollVelocity();
+                this.scrollDebounceTimer = null;
+            }, this.options.debounceDelay);
+        };
+        window.addEventListener('scroll', scrollHandler, { passive: true });
+        this.log('Scroll listener attached');
+    }
+    /**
+     * Initialize sections and start observing
+     */
+    initializeSections() {
+        for (const section of this.sections) {
+            const element = this.findElementByXPath(section.selector);
+            if (!element) {
+                this.log('Section element not found:', section.sectionName, 'selector:', section.selector);
+                continue;
+            }
+            // Initialize state
+            const state = {
+                element,
+                config: section,
+                entryTime: null,
+                exitTime: null,
+                isVisible: false,
+                lastScrollPosition: window.scrollY,
+                lastScrollTime: Date.now(),
+                entryScrollSpeed: 0,
+                exitScrollSpeed: 0,
+                maxVisibleArea: 0,
+            };
+            this.sectionStates.set(section.sectionName, state);
+            // Start observing
+            if (this.intersectionObserver) {
+                this.intersectionObserver.observe(element);
+            }
+            this.log('Section initialized and observed:', section.sectionName);
+        }
+    }
+    /**
+     * Handle intersection observer entry
+     */
+    handleIntersection(entry) {
+        if (this.isDestroyed)
+            return;
+        // Find which section this element belongs to
+        const state = Array.from(this.sectionStates.values()).find((s) => s.element === entry.target);
+        if (!state)
+            return;
+        const isVisible = entry.isIntersecting && entry.intersectionRatio >= this.options.intersectionThreshold;
+        const visibleArea = entry.intersectionRatio;
+        // Update max visible area
+        if (visibleArea > state.maxVisibleArea) {
+            state.maxVisibleArea = visibleArea;
+        }
+        // Handle visibility change
+        if (isVisible && !state.isVisible) {
+            // Section became visible
+            this.handleSectionEntry(state);
+        }
+        else if (!isVisible && state.isVisible) {
+            // Section became invisible
+            this.handleSectionExit(state);
+        }
+        state.isVisible = isVisible;
+    }
+    /**
+     * Handle section entry (became visible)
+     */
+    handleSectionEntry(state) {
+        this.log('Section entered view:', state.config.sectionName);
+        state.entryTime = Date.now();
+        state.entryScrollSpeed = this.scrollVelocity;
+        state.lastScrollPosition = window.scrollY;
+        state.lastScrollTime = Date.now();
+        state.maxVisibleArea = 0;
+    }
+    /**
+     * Handle section exit (became invisible)
+     */
+    handleSectionExit(state) {
+        this.log('Section exited view:', state.config.sectionName);
+        if (state.entryTime === null)
+            return;
+        state.exitTime = Date.now();
+        state.exitScrollSpeed = this.scrollVelocity;
+        const duration = state.exitTime - state.entryTime;
+        // Create section view data
+        const viewData = {
+            sectionName: state.config.sectionName,
+            sectionType: state.config.sectionType,
+            entryTime: state.entryTime,
+            exitTime: state.exitTime,
+            duration,
+            viewportWidth: window.innerWidth,
+            viewportHeight: window.innerHeight,
+            scrollDepth: this.calculateScrollDepth(),
+            visibleAreaPercentage: Math.round(state.maxVisibleArea * 100),
+            scrollSpeedAtEntry: state.entryScrollSpeed,
+            scrollSpeedAtExit: state.exitScrollSpeed,
+        };
+        // Apply sanitization and track if valid
+        if (this.shouldTrackSection(viewData)) {
+            this.queueSectionView(viewData);
+        }
+        else {
+            this.log('Section view filtered out:', state.config.sectionName, 'duration:', duration);
+        }
+        // Reset entry time
+        state.entryTime = null;
+    }
+    /**
+     * Update scroll velocity
+     */
+    updateScrollVelocity() {
+        const now = Date.now();
+        const currentPosition = window.scrollY;
+        const timeDelta = now - this.lastScrollTime;
+        const positionDelta = Math.abs(currentPosition - this.lastScrollPosition);
+        if (timeDelta > 0) {
+            this.scrollVelocity = (positionDelta / timeDelta) * 1000; // pixels per second
+        }
+        this.lastScrollPosition = currentPosition;
+        this.lastScrollTime = now;
+    }
+    /**
+     * Calculate current scroll depth as percentage
+     */
+    calculateScrollDepth() {
+        if (typeof window === 'undefined' || typeof document === 'undefined')
+            return 0;
+        const windowHeight = window.innerHeight;
+        const documentHeight = Math.max(document.body.scrollHeight, document.body.offsetHeight, document.documentElement.clientHeight, document.documentElement.scrollHeight, document.documentElement.offsetHeight);
+        const scrollTop = window.scrollY;
+        const scrollableHeight = documentHeight - windowHeight;
+        if (scrollableHeight <= 0)
+            return 100;
+        return Math.round((scrollTop / scrollableHeight) * 100);
+    }
+    /**
+     * Determine if section view should be tracked (sanitization)
+     */
+    shouldTrackSection(viewData) {
+        // Minimum dwell time check
+        if (viewData.duration < this.options.minDwellTime) {
+            return false;
+        }
+        // Check if user was rapidly scrolling through
+        const avgScrollSpeed = (viewData.scrollSpeedAtEntry + viewData.scrollSpeedAtExit) / 2;
+        if (avgScrollSpeed > this.options.scrollVelocityThreshold * 2) {
+            // Very fast scroll - likely not engaged
+            return false;
+        }
+        // Must have had some meaningful visible area
+        if (viewData.visibleAreaPercentage < 10) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Queue section view for batching
+     */
+    queueSectionView(viewData) {
+        this.pendingEvents.push(viewData);
+        this.log('Queued section view:', viewData.sectionName, 'duration:', viewData.duration);
+        // Setup batch timer if not already set
+        if (this.batchTimer === null) {
+            this.batchTimer = window.setTimeout(() => {
+                this.flushPendingEvents();
+            }, this.options.batchDelay);
+        }
+    }
+    /**
+     * Flush pending section view events
+     */
+    flushPendingEvents() {
+        if (this.isDestroyed || this.pendingEvents.length === 0)
+            return;
+        if (!this.tracker.hasConsent('analytics')) {
+            this.pendingEvents = [];
+            return;
+        }
+        this.log('Flushing', this.pendingEvents.length, 'section view events');
+        // Track each section view
+        for (const viewData of this.pendingEvents) {
+            this.tracker.trackSystemEvent('_grain_section_view', {
+                section_name: viewData.sectionName,
+                section_type: viewData.sectionType,
+                duration_ms: viewData.duration,
+                viewport_width: viewData.viewportWidth,
+                viewport_height: viewData.viewportHeight,
+                scroll_depth_percent: viewData.scrollDepth,
+                visible_area_percent: viewData.visibleAreaPercentage,
+                scroll_speed_entry: Math.round(viewData.scrollSpeedAtEntry || 0),
+                scroll_speed_exit: Math.round(viewData.scrollSpeedAtExit || 0),
+                entry_timestamp: viewData.entryTime,
+                exit_timestamp: viewData.exitTime,
+            });
+        }
+        // Clear pending events
+        this.pendingEvents = [];
+        this.batchTimer = null;
+    }
+    /**
+     * Find element by XPath selector
+     */
+    findElementByXPath(xpath) {
+        // Check cache first
+        if (this.xpathCache.has(xpath)) {
+            const cached = this.xpathCache.get(xpath);
+            if (cached && document.contains(cached)) {
+                return cached;
+            }
+            this.xpathCache.delete(xpath);
+        }
+        try {
+            const result = document.evaluate(xpath, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+            const element = result.singleNodeValue;
+            if (element) {
+                this.xpathCache.set(xpath, element);
+            }
+            return element;
+        }
+        catch (error) {
+            this.log('Error evaluating XPath:', xpath, error);
+            return null;
+        }
+    }
+    /**
+     * Log debug messages
+     */
+    log(...args) {
+        if (this.options.debug) {
+            console.log('[SectionTracking]', ...args);
+        }
+    }
+    /**
+     * Update sections configuration
+     */
+    updateSections(sections) {
+        if (this.isDestroyed)
+            return;
+        this.log('Updating sections configuration');
+        // Disconnect observer
+        if (this.intersectionObserver) {
+            this.intersectionObserver.disconnect();
+        }
+        // Clear state
+        this.sectionStates.clear();
+        this.xpathCache.clear();
+        // Update configuration
+        this.sections = sections;
+        // Reinitialize
+        this.setupIntersectionObserver();
+        this.initializeSections();
+    }
+    /**
+     * Cleanup and destroy
+     */
+    destroy() {
+        if (this.isDestroyed)
+            return;
+        this.log('Destroying section tracking manager');
+        this.isDestroyed = true;
+        // Flush any pending events
+        this.flushPendingEvents();
+        // Clear timers
+        if (this.scrollDebounceTimer !== null) {
+            clearTimeout(this.scrollDebounceTimer);
+            this.scrollDebounceTimer = null;
+        }
+        if (this.batchTimer !== null) {
+            clearTimeout(this.batchTimer);
+            this.batchTimer = null;
+        }
+        // Disconnect intersection observer
+        if (this.intersectionObserver) {
+            this.intersectionObserver.disconnect();
+            this.intersectionObserver = null;
+        }
+        // Clear state
+        this.sectionStates.clear();
+        this.xpathCache.clear();
+        this.pendingEvents = [];
+    }
+}
+exports.SectionTrackingManager = SectionTrackingManager;
+//# sourceMappingURL=section-tracking.js.map

package/dist/cjs/section-tracking.js.map

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

package/dist/cjs/types/auto-tracking.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Auto-tracking types for Grain Analytics SDK
+ */
+export interface InteractionConfig {
+    eventName: string;
+    description: string;
+    selector: string;
+    priority: number;
+    label: string;
+}
+export interface SectionConfig {
+    sectionName: string;
+    description: string;
+    sectionType: string;
+    selector: string;
+    importance: number;
+}
+export interface AutoTrackingConfig {
+    interactions: InteractionConfig[];
+    sections: SectionConfig[];
+}
+export interface SectionViewData {
+    sectionName: string;
+    sectionType: string;
+    entryTime: number;
+    exitTime: number;
+    duration: number;
+    viewportWidth: number;
+    viewportHeight: number;
+    scrollDepth: number;
+    visibleAreaPercentage: number;
+    scrollSpeedAtEntry?: number;
+    scrollSpeedAtExit?: number;
+}
+export interface SectionTrackingOptions {
+    minDwellTime: number;
+    scrollVelocityThreshold: number;
+    intersectionThreshold: number;
+    debounceDelay: number;
+    batchDelay: number;
+    debug?: boolean;
+}
+export interface SectionTrackingState {
+    element: Element;
+    config: SectionConfig;
+    entryTime: number | null;
+    exitTime: number | null;
+    isVisible: boolean;
+    lastScrollPosition: number;
+    lastScrollTime: number;
+    entryScrollSpeed: number;
+    exitScrollSpeed: number;
+    maxVisibleArea: number;
+}
+//# sourceMappingURL=auto-tracking.d.ts.map

package/dist/cjs/types/auto-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-tracking.d.ts","sourceRoot":"","sources":["../../../src/types/auto-tracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/cjs/types/auto-tracking.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Auto-tracking types for Grain Analytics SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=auto-tracking.js.map

package/dist/cjs/types/auto-tracking.js.map

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

package/dist/countries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get full country name from user's timezone
+ * @returns Full country name or null if timezone is unavailable
+ */
+export declare function getCountry(): string | null;
+/**
+ * Get country code (ISO 3166-1 alpha-2) from user's timezone
+ * Privacy-friendly alternative to IP geolocation
+ * @returns ISO 3166-1 alpha-2 country code (e.g., "US", "GB") or "Unknown"
+ */
+export declare function getCountryCodeFromTimezone(): string;
+export declare function getState(): string | null;
+//# sourceMappingURL=countries.d.ts.map

package/dist/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../src/countries.ts"],"names":[],"mappings":"AAyyFA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAe1C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAanD;AAED,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAUxC"}