@grainql/analytics-web 2.1.0 → 2.1.1

package/dist/activity.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Activity Detection for Grain Analytics
+ * Tracks user activity (mouse, keyboard, touch, scroll) to determine if user is active
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivityDetector = void 0;
+class ActivityDetector {
+    constructor() {
+        this.activityThreshold = 30000; // 30 seconds
+        this.listeners = [];
+        this.isDestroyed = false;
+        // Events that indicate user activity
+        this.activityEvents = [
+            'mousemove',
+            'mousedown',
+            'keydown',
+            'scroll',
+            'touchstart',
+            'click',
+        ];
+        this.lastActivityTime = Date.now();
+        this.boundActivityHandler = this.debounce(this.handleActivity.bind(this), 500);
+        this.setupListeners();
+    }
+    /**
+     * Setup event listeners for activity detection
+     */
+    setupListeners() {
+        if (typeof window === 'undefined')
+            return;
+        for (const event of this.activityEvents) {
+            window.addEventListener(event, this.boundActivityHandler, { passive: true });
+        }
+    }
+    /**
+     * Handle activity event
+     */
+    handleActivity() {
+        if (this.isDestroyed)
+            return;
+        this.lastActivityTime = Date.now();
+        this.notifyListeners();
+    }
+    /**
+     * Debounce function to limit how often activity handler is called
+     */
+    debounce(func, wait) {
+        let timeout = null;
+        return () => {
+            if (timeout !== null) {
+                clearTimeout(timeout);
+            }
+            timeout = window.setTimeout(() => {
+                func();
+                timeout = null;
+            }, wait);
+        };
+    }
+    /**
+     * Check if user is currently active
+     * @param threshold Time in ms to consider user inactive (default: 30s)
+     */
+    isActive(threshold) {
+        const thresholdToUse = threshold ?? this.activityThreshold;
+        const now = Date.now();
+        return (now - this.lastActivityTime) < thresholdToUse;
+    }
+    /**
+     * Get time since last activity in milliseconds
+     */
+    getTimeSinceLastActivity() {
+        return Date.now() - this.lastActivityTime;
+    }
+    /**
+     * Get last activity timestamp
+     */
+    getLastActivityTime() {
+        return this.lastActivityTime;
+    }
+    /**
+     * Set activity threshold
+     */
+    setActivityThreshold(threshold) {
+        this.activityThreshold = threshold;
+    }
+    /**
+     * Add listener for activity changes
+     */
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * Remove listener
+     */
+    removeListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index > -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * Notify all listeners
+     */
+    notifyListeners() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch (error) {
+                console.error('[Activity Detector] Listener error:', error);
+            }
+        }
+    }
+    /**
+     * Cleanup and remove listeners
+     */
+    destroy() {
+        if (this.isDestroyed)
+            return;
+        if (typeof window !== 'undefined') {
+            for (const event of this.activityEvents) {
+                window.removeEventListener(event, this.boundActivityHandler);
+            }
+        }
+        this.listeners = [];
+        this.isDestroyed = true;
+    }
+}
+exports.ActivityDetector = ActivityDetector;
+//# sourceMappingURL=activity.js.map

package/dist/consent.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Consent management for Grain Analytics
+ * Handles GDPR-compliant consent tracking and state management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsentManager = exports.CONSENT_VERSION = exports.DEFAULT_CONSENT_CATEGORIES = void 0;
+exports.DEFAULT_CONSENT_CATEGORIES = ['necessary', 'analytics', 'functional'];
+exports.CONSENT_VERSION = '1.0.0';
+/**
+ * Consent manager for handling user consent state
+ */
+class ConsentManager {
+    constructor(tenantId, consentMode = 'opt-out') {
+        this.consentState = null;
+        this.listeners = [];
+        this.consentMode = consentMode;
+        this.storageKey = `grain_consent_${tenantId}`;
+        this.loadConsentState();
+    }
+    /**
+     * Load consent state from localStorage
+     */
+    loadConsentState() {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            const stored = localStorage.getItem(this.storageKey);
+            if (stored) {
+                const parsed = JSON.parse(stored);
+                this.consentState = {
+                    ...parsed,
+                    timestamp: new Date(parsed.timestamp),
+                };
+            }
+            else if (this.consentMode === 'opt-out' || this.consentMode === 'disabled') {
+                // Auto-grant consent for opt-out and disabled modes
+                this.consentState = {
+                    granted: true,
+                    categories: exports.DEFAULT_CONSENT_CATEGORIES,
+                    timestamp: new Date(),
+                    version: exports.CONSENT_VERSION,
+                };
+                this.saveConsentState();
+            }
+        }
+        catch (error) {
+            console.error('[Grain Consent] Failed to load consent state:', error);
+        }
+    }
+    /**
+     * Save consent state to localStorage
+     */
+    saveConsentState() {
+        if (typeof window === 'undefined' || !this.consentState)
+            return;
+        try {
+            localStorage.setItem(this.storageKey, JSON.stringify(this.consentState));
+        }
+        catch (error) {
+            console.error('[Grain Consent] Failed to save consent state:', error);
+        }
+    }
+    /**
+     * Grant consent with optional categories
+     */
+    grantConsent(categories) {
+        const grantedCategories = categories || exports.DEFAULT_CONSENT_CATEGORIES;
+        this.consentState = {
+            granted: true,
+            categories: grantedCategories,
+            timestamp: new Date(),
+            version: exports.CONSENT_VERSION,
+        };
+        this.saveConsentState();
+        this.notifyListeners();
+    }
+    /**
+     * Revoke consent (opt-out)
+     */
+    revokeConsent(categories) {
+        if (!this.consentState) {
+            this.consentState = {
+                granted: false,
+                categories: [],
+                timestamp: new Date(),
+                version: exports.CONSENT_VERSION,
+            };
+        }
+        else if (categories) {
+            // Remove specific categories
+            this.consentState = {
+                ...this.consentState,
+                categories: this.consentState.categories.filter(cat => !categories.includes(cat)),
+                granted: this.consentState.categories.length > 0,
+                timestamp: new Date(),
+            };
+        }
+        else {
+            // Revoke all consent
+            this.consentState = {
+                granted: false,
+                categories: [],
+                timestamp: new Date(),
+                version: exports.CONSENT_VERSION,
+            };
+        }
+        this.saveConsentState();
+        this.notifyListeners();
+    }
+    /**
+     * Get current consent state
+     */
+    getConsentState() {
+        return this.consentState ? { ...this.consentState } : null;
+    }
+    /**
+     * Check if user has granted consent
+     */
+    hasConsent(category) {
+        // Disabled mode always returns true (no consent required)
+        if (this.consentMode === 'disabled') {
+            return true;
+        }
+        // No consent state in opt-in mode means no consent
+        if (this.consentMode === 'opt-in' && !this.consentState) {
+            return false;
+        }
+        // Check consent state
+        if (!this.consentState?.granted) {
+            return false;
+        }
+        // Check specific category if provided
+        if (category) {
+            return this.consentState.categories.includes(category);
+        }
+        return true;
+    }
+    /**
+     * Check if we should wait for consent before tracking
+     */
+    shouldWaitForConsent() {
+        return this.consentMode === 'opt-in' && !this.consentState?.granted;
+    }
+    /**
+     * Add consent change listener
+     */
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * Remove consent change listener
+     */
+    removeListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index > -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * Notify all listeners of consent state change
+     */
+    notifyListeners() {
+        if (!this.consentState)
+            return;
+        this.listeners.forEach(listener => {
+            try {
+                listener(this.consentState);
+            }
+            catch (error) {
+                console.error('[Grain Consent] Listener error:', error);
+            }
+        });
+    }
+    /**
+     * Clear all consent data
+     */
+    clearConsent() {
+        if (typeof window === 'undefined')
+            return;
+        try {
+            localStorage.removeItem(this.storageKey);
+            this.consentState = null;
+        }
+        catch (error) {
+            console.error('[Grain Consent] Failed to clear consent:', error);
+        }
+    }
+}
+exports.ConsentManager = ConsentManager;
+//# sourceMappingURL=consent.js.map

package/dist/cookies.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Cookie utilities for Grain Analytics
+ * Provides GDPR-compliant cookie management with configurable options
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCookie = setCookie;
+exports.getCookie = getCookie;
+exports.deleteCookie = deleteCookie;
+exports.areCookiesEnabled = areCookiesEnabled;
+/**
+ * Set a cookie with configurable options
+ */
+function setCookie(name, value, config) {
+    if (typeof document === 'undefined')
+        return;
+    const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];
+    if (config?.maxAge !== undefined) {
+        parts.push(`max-age=${config.maxAge}`);
+    }
+    if (config?.domain) {
+        parts.push(`domain=${config.domain}`);
+    }
+    if (config?.path) {
+        parts.push(`path=${config.path}`);
+    }
+    else {
+        parts.push('path=/');
+    }
+    if (config?.sameSite) {
+        parts.push(`samesite=${config.sameSite}`);
+    }
+    if (config?.secure) {
+        parts.push('secure');
+    }
+    document.cookie = parts.join('; ');
+}
+/**
+ * Get a cookie value by name
+ */
+function getCookie(name) {
+    if (typeof document === 'undefined')
+        return null;
+    const nameEQ = encodeURIComponent(name) + '=';
+    const cookies = document.cookie.split(';');
+    for (let i = 0; i < cookies.length; i++) {
+        let cookie = cookies[i];
+        while (cookie.charAt(0) === ' ') {
+            cookie = cookie.substring(1);
+        }
+        if (cookie.indexOf(nameEQ) === 0) {
+            return decodeURIComponent(cookie.substring(nameEQ.length));
+        }
+    }
+    return null;
+}
+/**
+ * Delete a cookie by name
+ */
+function deleteCookie(name, config) {
+    if (typeof document === 'undefined')
+        return;
+    const parts = [
+        `${encodeURIComponent(name)}=`,
+        'max-age=0',
+    ];
+    if (config?.domain) {
+        parts.push(`domain=${config.domain}`);
+    }
+    if (config?.path) {
+        parts.push(`path=${config.path}`);
+    }
+    else {
+        parts.push('path=/');
+    }
+    document.cookie = parts.join('; ');
+}
+/**
+ * Check if cookies are available and working
+ */
+function areCookiesEnabled() {
+    if (typeof document === 'undefined')
+        return false;
+    try {
+        const testCookie = '_grain_cookie_test';
+        setCookie(testCookie, 'test', { maxAge: 1 });
+        const result = getCookie(testCookie) === 'test';
+        deleteCookie(testCookie);
+        return result;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cookies.js.map

package/dist/heartbeat.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Heartbeat Manager for Grain Analytics
+ * Tracks session activity with consent-aware behavior
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeartbeatManager = void 0;
+class HeartbeatManager {
+    constructor(tracker, activityDetector, config) {
+        this.heartbeatTimer = null;
+        this.isDestroyed = false;
+        this.tracker = tracker;
+        this.activityDetector = activityDetector;
+        this.config = config;
+        this.lastHeartbeatTime = Date.now();
+        this.currentInterval = config.activeInterval;
+        // Start heartbeat tracking
+        this.scheduleNextHeartbeat();
+    }
+    /**
+     * Schedule the next heartbeat based on current activity
+     */
+    scheduleNextHeartbeat() {
+        if (this.isDestroyed)
+            return;
+        // Clear existing timer
+        if (this.heartbeatTimer !== null) {
+            clearTimeout(this.heartbeatTimer);
+        }
+        // Determine interval based on activity
+        const isActive = this.activityDetector.isActive(60000); // 1 minute threshold
+        this.currentInterval = isActive ? this.config.activeInterval : this.config.inactiveInterval;
+        // Schedule next heartbeat
+        this.heartbeatTimer = window.setTimeout(() => {
+            this.sendHeartbeat();
+            this.scheduleNextHeartbeat();
+        }, this.currentInterval);
+        if (this.config.debug) {
+            console.log(`[Heartbeat] Scheduled next heartbeat in ${this.currentInterval / 1000}s (${isActive ? 'active' : 'inactive'})`);
+        }
+    }
+    /**
+     * Send heartbeat event
+     */
+    sendHeartbeat() {
+        if (this.isDestroyed)
+            return;
+        const now = Date.now();
+        const isActive = this.activityDetector.isActive(60000); // 1 minute threshold
+        const hasConsent = this.tracker.hasConsent('analytics');
+        // Base properties (always included)
+        const properties = {
+            type: 'heartbeat',
+            status: isActive ? 'active' : 'inactive',
+            timestamp: now,
+        };
+        // Enhanced properties when consent is granted
+        if (hasConsent) {
+            const page = this.tracker.getCurrentPage();
+            if (page) {
+                properties.page = page;
+            }
+            properties.duration = now - this.lastHeartbeatTime;
+            properties.event_count = this.tracker.getEventCountSinceLastHeartbeat();
+            // Reset event count
+            this.tracker.resetEventCountSinceLastHeartbeat();
+        }
+        // Track the heartbeat event
+        this.tracker.trackSystemEvent('_grain_heartbeat', properties);
+        this.lastHeartbeatTime = now;
+        if (this.config.debug) {
+            console.log('[Heartbeat] Sent heartbeat:', properties);
+        }
+    }
+    /**
+     * Destroy the heartbeat manager
+     */
+    destroy() {
+        if (this.isDestroyed)
+            return;
+        if (this.heartbeatTimer !== null) {
+            clearTimeout(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this.isDestroyed = true;
+        if (this.config.debug) {
+            console.log('[Heartbeat] Destroyed');
+        }
+    }
+}
+exports.HeartbeatManager = HeartbeatManager;
+//# sourceMappingURL=heartbeat.js.map

package/dist/index.global.dev.js

@@ -1,4 +1,4 @@
-/* Grain Analytics Web SDK v2.1.0 | MIT License | Development Build */
+/* Grain Analytics Web SDK v2.1.1 | MIT License | Development Build */
 "use strict";
 var Grain = (() => {
   var __defProp = Object.defineProperty;

package/dist/index.global.js

@@ -1,3 +1,3 @@
-/* Grain Analytics Web SDK v2.1.0 | MIT License */
+/* Grain Analytics Web SDK v2.1.1 | MIT License */
 "use strict";var Grain=(()=>{var C=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var x=(c,e)=>{for(var t in e)C(c,t,{get:e[t],enumerable:!0})},U=(c,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of A(e))!T.call(c,n)&&n!==t&&C(c,n,{get:()=>e[n],enumerable:!(r=R(e,n))||r.enumerable});return c};var D=c=>U(C({},"__esModule",{value:!0}),c);var $={};x($,{GrainAnalytics:()=>u,createGrainAnalytics:()=>P,default:()=>O});var S=["necessary","analytics","functional"],f="1.0.0",p=class{constructor(e,t="opt-out"){this.consentState=null;this.listeners=[];this.consentMode=t,this.storageKey=`grain_consent_${e}`,this.loadConsentState()}loadConsentState(){if(!(typeof window>"u"))try{let e=localStorage.getItem(this.storageKey);if(e){let t=JSON.parse(e);this.consentState={...t,timestamp:new Date(t.timestamp)}}else(this.consentMode==="opt-out"||this.consentMode==="disabled")&&(this.consentState={granted:!0,categories:S,timestamp:new Date,version:f},this.saveConsentState())}catch(e){console.error("[Grain Consent] Failed to load consent state:",e)}}saveConsentState(){if(!(typeof window>"u"||!this.consentState))try{localStorage.setItem(this.storageKey,JSON.stringify(this.consentState))}catch(e){console.error("[Grain Consent] Failed to save consent state:",e)}}grantConsent(e){let t=e||S;this.consentState={granted:!0,categories:t,timestamp:new Date,version:f},this.saveConsentState(),this.notifyListeners()}revokeConsent(e){this.consentState?e?this.consentState={...this.consentState,categories:this.consentState.categories.filter(t=>!e.includes(t)),granted:this.consentState.categories.length>0,timestamp:new Date}:this.consentState={granted:!1,categories:[],timestamp:new Date,version:f}:this.consentState={granted:!1,categories:[],timestamp:new Date,version:f},this.saveConsentState(),this.notifyListeners()}getConsentState(){return this.consentState?{...this.consentState}:null}hasConsent(e){return this.consentMode==="disabled"?!0:this.consentMode==="opt-in"&&!this.consentState||!this.consentState?.granted?!1:e?this.consentState.categories.includes(e):!0}shouldWaitForConsent(){return this.consentMode==="opt-in"&&!this.consentState?.granted}addListener(e){this.listeners.push(e)}removeListener(e){let t=this.listeners.indexOf(e);t>-1&&this.listeners.splice(t,1)}notifyListeners(){this.consentState&&this.listeners.forEach(e=>{try{e(this.consentState)}catch(t){console.error("[Grain Consent] Listener error:",t)}})}clearConsent(){if(!(typeof window>"u"))try{localStorage.removeItem(this.storageKey),this.consentState=null}catch(e){console.error("[Grain Consent] Failed to clear consent:",e)}}};function b(c,e,t){if(typeof document>"u")return;let r=[`${encodeURIComponent(c)}=${encodeURIComponent(e)}`];t?.maxAge!==void 0&&r.push(`max-age=${t.maxAge}`),t?.domain&&r.push(`domain=${t.domain}`),t?.path?r.push(`path=${t.path}`):r.push("path=/"),t?.sameSite&&r.push(`samesite=${t.sameSite}`),t?.secure&&r.push("secure"),document.cookie=r.join("; ")}function w(c){if(typeof document>"u")return null;let e=encodeURIComponent(c)+"=",t=document.cookie.split(";");for(let r=0;r<t.length;r++){let n=t[r];for(;n.charAt(0)===" ";)n=n.substring(1);if(n.indexOf(e)===0)return decodeURIComponent(n.substring(e.length))}return null}function L(c,e){if(typeof document>"u")return;let t=[`${encodeURIComponent(c)}=`,"max-age=0"];e?.domain&&t.push(`domain=${e.domain}`),e?.path?t.push(`path=${e.path}`):t.push("path=/"),document.cookie=t.join("; ")}function k(){if(typeof document>"u")return!1;try{let c="_grain_cookie_test";b(c,"test",{maxAge:1});let e=w(c)==="test";return L(c),e}catch{return!1}}var m=class{constructor(){this.activityThreshold=3e4;this.listeners=[];this.isDestroyed=!1;this.activityEvents=["mousemove","mousedown","keydown","scroll","touchstart","click"];this.lastActivityTime=Date.now(),this.boundActivityHandler=this.debounce(this.handleActivity.bind(this),500),this.setupListeners()}setupListeners(){if(!(typeof window>"u"))for(let e of this.activityEvents)window.addEventListener(e,this.boundActivityHandler,{passive:!0})}handleActivity(){this.isDestroyed||(this.lastActivityTime=Date.now(),this.notifyListeners())}debounce(e,t){let r=null;return()=>{r!==null&&clearTimeout(r),r=window.setTimeout(()=>{e(),r=null},t)}}isActive(e){let t=e??this.activityThreshold;return Date.now()-this.lastActivityTime<t}getTimeSinceLastActivity(){return Date.now()-this.lastActivityTime}getLastActivityTime(){return this.lastActivityTime}setActivityThreshold(e){this.activityThreshold=e}addListener(e){this.listeners.push(e)}removeListener(e){let t=this.listeners.indexOf(e);t>-1&&this.listeners.splice(t,1)}notifyListeners(){for(let e of this.listeners)try{e()}catch(t){console.error("[Activity Detector] Listener error:",t)}}destroy(){if(!this.isDestroyed){if(typeof window<"u")for(let e of this.activityEvents)window.removeEventListener(e,this.boundActivityHandler);this.listeners=[],this.isDestroyed=!0}}};var v=class{constructor(e,t,r){this.heartbeatTimer=null;this.isDestroyed=!1;this.tracker=e,this.activityDetector=t,this.config=r,this.lastHeartbeatTime=Date.now(),this.currentInterval=r.activeInterval,this.scheduleNextHeartbeat()}scheduleNextHeartbeat(){if(this.isDestroyed)return;this.heartbeatTimer!==null&&clearTimeout(this.heartbeatTimer);let e=this.activityDetector.isActive(6e4);this.currentInterval=e?this.config.activeInterval:this.config.inactiveInterval,this.heartbeatTimer=window.setTimeout(()=>{this.sendHeartbeat(),this.scheduleNextHeartbeat()},this.currentInterval),this.config.debug&&console.log(`[Heartbeat] Scheduled next heartbeat in ${this.currentInterval/1e3}s (${e?"active":"inactive"})`)}sendHeartbeat(){if(this.isDestroyed)return;let e=Date.now(),t=this.activityDetector.isActive(6e4),r=this.tracker.hasConsent("analytics"),n={type:"heartbeat",status:t?"active":"inactive",timestamp:e};if(r){let s=this.tracker.getCurrentPage();s&&(n.page=s),n.duration=e-this.lastHeartbeatTime,n.event_count=this.tracker.getEventCountSinceLastHeartbeat(),this.tracker.resetEventCountSinceLastHeartbeat()}this.tracker.trackSystemEvent("_grain_heartbeat",n),this.lastHeartbeatTime=e,this.config.debug&&console.log("[Heartbeat] Sent heartbeat:",n)}destroy(){this.isDestroyed||(this.heartbeatTimer!==null&&(clearTimeout(this.heartbeatTimer),this.heartbeatTimer=null),this.isDestroyed=!0,this.config.debug&&console.log("[Heartbeat] Destroyed"))}};var y=class{constructor(e,t){this.isDestroyed=!1;this.currentPath=null;this.originalPushState=null;this.originalReplaceState=null;this.handlePopState=()=>{this.isDestroyed||this.trackCurrentPage()};this.handleHashChange=()=>{this.isDestroyed||this.trackCurrentPage()};this.tracker=e,this.config=t,this.trackCurrentPage(),this.setupHistoryListeners(),this.setupHashChangeListener()}setupHistoryListeners(){typeof window>"u"||typeof history>"u"||(this.originalPushState=history.pushState,history.pushState=(e,t,r)=>{this.originalPushState?.call(history,e,t,r),this.trackCurrentPage()},this.originalReplaceState=history.replaceState,history.replaceState=(e,t,r)=>{this.originalReplaceState?.call(history,e,t,r),this.trackCurrentPage()},window.addEventListener("popstate",this.handlePopState))}setupHashChangeListener(){typeof window>"u"||window.addEventListener("hashchange",this.handleHashChange)}trackCurrentPage(){if(this.isDestroyed||typeof window>"u")return;let e=this.extractPath(window.location.href);if(e===this.currentPath)return;this.currentPath=e;let t=this.tracker.hasConsent("analytics"),r={page:e,timestamp:Date.now()};t&&(r.referrer=document.referrer||"",r.title=document.title||"",r.full_url=window.location.href),this.tracker.trackSystemEvent("page_view",r),this.config.debug&&console.log("[Page Tracking] Tracked page view:",r)}extractPath(e){try{let t=new URL(e),r=t.pathname+t.hash;return!this.config.stripQueryParams&&t.search&&(r+=t.search),r}catch(t){return this.config.debug&&console.warn("[Page Tracking] Failed to parse URL:",e,t),e}}getCurrentPage(){return this.currentPath}trackPage(e,t){if(this.isDestroyed)return;let r=this.tracker.hasConsent("analytics"),n={page:e,timestamp:Date.now(),...t};r&&typeof document<"u"&&(n.referrer||(n.referrer=document.referrer||""),n.title||(n.title=document.title||""),!n.full_url&&typeof window<"u"&&(n.full_url=window.location.href)),this.tracker.trackSystemEvent("page_view",n),this.config.debug&&console.log("[Page Tracking] Manually tracked page:",n)}destroy(){this.isDestroyed||(typeof history<"u"&&(this.originalPushState&&(history.pushState=this.originalPushState),this.originalReplaceState&&(history.replaceState=this.originalReplaceState)),typeof window<"u"&&(window.removeEventListener("popstate",this.handlePopState),window.removeEventListener("hashchange",this.handleHashChange)),this.isDestroyed=!0,this.config.debug&&console.log("[Page Tracking] Destroyed"))}};var u=class{constructor(e){this.eventQueue=[];this.waitingForConsentQueue=[];this.flushTimer=null;this.isDestroyed=!1;this.globalUserId=null;this.persistentAnonymousUserId=null;this.configCache=null;this.configRefreshTimer=null;this.configChangeListeners=[];this.configFetchPromise=null;this.cookiesEnabled=!1;this.activityDetector=null;this.heartbeatManager=null;this.pageTrackingManager=null;this.ephemeralSessionId=null;this.eventCountSinceLastHeartbeat=0;this.config={apiUrl:"https://api.grainql.com",authStrategy:"NONE",batchSize:50,flushInterval:5e3,retryAttempts:3,retryDelay:1e3,maxEventsPerRequest:160,debug:!1,defaultConfigurations:{},configCacheKey:"grain_config",configRefreshInterval:3e5,enableConfigCache:!0,consentMode:"opt-out",waitForConsent:!1,enableCookies:!1,anonymizeIP:!1,disableAutoProperties:!1,enableHeartbeat:!0,heartbeatActiveInterval:12e4,heartbeatInactiveInterval:3e5,enableAutoPageView:!0,stripQueryParams:!0,...e,tenantId:e.tenantId},this.consentManager=new p(this.config.tenantId,this.config.consentMode),this.config.enableCookies&&(this.cookiesEnabled=k(),!this.cookiesEnabled&&this.config.debug&&console.warn("[Grain Analytics] Cookies are not available, falling back to localStorage")),e.userId&&(this.globalUserId=e.userId),this.validateConfig(),this.initializePersistentAnonymousUserId(),this.setupBeforeUnload(),this.startFlushTimer(),this.initializeConfigCache(),this.ephemeralSessionId=this.generateUUID(),typeof window<"u"&&this.initializeAutomaticTracking(),this.consentManager.addListener(t=>{t.granted&&this.handleConsentGranted()})}validateConfig(){if(!this.config.tenantId)throw new Error("Grain Analytics: tenantId is required");if(this.config.authStrategy==="SERVER_SIDE"&&!this.config.secretKey)throw new Error("Grain Analytics: secretKey is required for SERVER_SIDE auth strategy");if(this.config.authStrategy==="JWT"&&!this.config.authProvider)throw new Error("Grain Analytics: authProvider is required for JWT auth strategy")}generateUUID(){return typeof crypto<"u"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,function(e){let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}generateAnonymousUserId(){return this.generateUUID()}initializePersistentAnonymousUserId(){if(typeof window>"u")return;let e=`grain_anonymous_user_id_${this.config.tenantId}`,t="_grain_uid";try{if(this.cookiesEnabled){let n=w(t);if(n){this.persistentAnonymousUserId=n,this.log("Loaded persistent anonymous user ID from cookie:",this.persistentAnonymousUserId);return}}let r=localStorage.getItem(e);r?(this.persistentAnonymousUserId=r,this.log("Loaded persistent anonymous user ID from localStorage:",this.persistentAnonymousUserId),this.cookiesEnabled&&this.savePersistentAnonymousUserId(r)):(this.persistentAnonymousUserId=this.generateAnonymousUserId(),this.savePersistentAnonymousUserId(this.persistentAnonymousUserId),this.log("Generated new persistent anonymous user ID:",this.persistentAnonymousUserId))}catch(r){this.log("Failed to initialize persistent anonymous user ID:",r),this.persistentAnonymousUserId=this.generateAnonymousUserId()}}savePersistentAnonymousUserId(e){if(typeof window>"u")return;let t=`grain_anonymous_user_id_${this.config.tenantId}`,r="_grain_uid";try{if(this.cookiesEnabled){let n={maxAge:31536e3,sameSite:"lax",secure:window.location.protocol==="https:",...this.config.cookieOptions};b(r,e,n)}localStorage.setItem(t,e)}catch(n){this.log("Failed to save persistent anonymous user ID:",n)}}getEffectiveUserIdInternal(){if(this.globalUserId)return this.globalUserId;if(this.persistentAnonymousUserId)return this.persistentAnonymousUserId;if(this.persistentAnonymousUserId=this.generateAnonymousUserId(),typeof window<"u")try{let e=`grain_anonymous_user_id_${this.config.tenantId}`;localStorage.setItem(e,this.persistentAnonymousUserId)}catch(e){this.log("Failed to persist generated anonymous user ID:",e)}return this.persistentAnonymousUserId}log(...e){this.config.debug&&console.log("[Grain Analytics]",...e)}createErrorDigest(e){let t=[...new Set(e.map(i=>i.eventName))],r=[...new Set(e.map(i=>i.userId))],n=0,s=0;return e.forEach(i=>{let o=i.properties||{};n+=Object.keys(o).length,s+=JSON.stringify(i).length}),{eventCount:e.length,totalProperties:n,totalSize:s,eventNames:t,userIds:r}}formatError(e,t,r){let n=r?this.createErrorDigest(r):{eventCount:0,totalProperties:0,totalSize:0,eventNames:[],userIds:[]},s="UNKNOWN_ERROR",i="An unknown error occurred";if(e instanceof Error)i=e.message,i.includes("fetch failed")||i.includes("network error")?s="NETWORK_ERROR":i.includes("timeout")?s="TIMEOUT_ERROR":i.includes("HTTP 4")?s="CLIENT_ERROR":i.includes("HTTP 5")?s="SERVER_ERROR":i.includes("JSON")?s="PARSE_ERROR":i.includes("auth")||i.includes("unauthorized")?s="AUTH_ERROR":i.includes("rate limit")||i.includes("429")?s="RATE_LIMIT_ERROR":s="GENERAL_ERROR";else if(typeof e=="string")i=e,s="STRING_ERROR";else if(e&&typeof e=="object"&&"status"in e){let o=e.status;s=`HTTP_${o}`,i=`HTTP ${o} error`}return{code:s,message:i,digest:n,timestamp:new Date().toISOString(),context:t,originalError:e}}logError(e){let{code:t,message:r,digest:n,timestamp:s,context:i}=e,o={"\u{1F6A8} Grain Analytics Error":{"Error Code":t,Message:r,Context:i,Timestamp:s,"Event Digest":{Events:n.eventCount,Properties:n.totalProperties,"Size (bytes)":n.totalSize,"Event Names":n.eventNames.length>0?n.eventNames.join(", "):"None","User IDs":n.userIds.length>0?n.userIds.slice(0,3).join(", ")+(n.userIds.length>3?"...":""):"None"}}};console.error("\u{1F6A8} Grain Analytics Error:",o),this.config.debug&&console.error(`[Grain Analytics] ${t}: ${r} (${i}) - Events: ${n.eventCount}, Props: ${n.totalProperties}, Size: ${n.totalSize}B`)}async safeExecute(e,t,r){try{return await e()}catch(n){let s=this.formatError(n,t,r);return this.logError(s),null}}formatEvent(e){return{eventName:e.eventName,userId:e.userId||this.getEffectiveUserIdInternal(),properties:e.properties||{}}}async getAuthHeaders(){let e={"Content-Type":"application/json"};switch(this.config.authStrategy){case"NONE":break;case"SERVER_SIDE":e.Authorization=`Chase ${this.config.secretKey}`;break;case"JWT":if(this.config.authProvider){let t=await this.config.authProvider.getToken();e.Authorization=`Bearer ${t}`}break}return e}async delay(e){return new Promise(t=>setTimeout(t,e))}isRetriableError(e){if(e instanceof Error){let t=e.message.toLowerCase();if(t.includes("fetch failed")||t==="network error"||t.includes("timeout")||t.includes("connection"))return!0}if(typeof e=="object"&&e!==null&&"status"in e){let t=e.status;return t>=500||t===429}return!1}async sendEvents(e){if(e.length===0)return;let t;for(let r=0;r<=this.config.retryAttempts;r++)try{let n=await this.getAuthHeaders(),s=`${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/multi`;this.log(`Sending ${e.length} events to ${s} (attempt ${r+1})`);let i=await fetch(s,{method:"POST",headers:n,body:JSON.stringify(e)});if(!i.ok){let o=`HTTP ${i.status}`;try{let h=await i.json();h?.message&&(o=h.message)}catch{let h=await i.text();h&&(o=h)}let a=new Error(`Failed to send events: ${o}`);throw a.status=i.status,a}this.log(`Successfully sent ${e.length} events`);return}catch(n){if(t=n,r===this.config.retryAttempts){let i=this.formatError(n,`sendEvents (attempt ${r+1}/${this.config.retryAttempts+1})`,e);this.logError(i);return}if(!this.isRetriableError(n)){let i=this.formatError(n,"sendEvents (non-retriable error)",e);this.logError(i);return}let s=this.config.retryDelay*Math.pow(2,r);this.log(`Retrying in ${s}ms after error:`,n),await this.delay(s)}}async sendEventsWithBeacon(e){if(e.length!==0)try{let t=await this.getAuthHeaders(),r=`${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/multi`,n=JSON.stringify({events:e});if(typeof navigator<"u"&&"sendBeacon"in navigator){let s=new Blob([n],{type:"application/json"});if(navigator.sendBeacon(r,s)){this.log(`Successfully sent ${e.length} events via beacon`);return}}await fetch(r,{method:"POST",headers:t,body:n,keepalive:!0}),this.log(`Successfully sent ${e.length} events via fetch (keepalive)`)}catch(t){let r=this.formatError(t,"sendEventsWithBeacon",e);this.logError(r)}}startFlushTimer(){this.flushTimer&&clearInterval(this.flushTimer),this.flushTimer=window.setInterval(()=>{this.eventQueue.length>0&&this.flush().catch(e=>{let t=this.formatError(e,"auto-flush");this.logError(t)})},this.config.flushInterval)}setupBeforeUnload(){if(typeof window>"u")return;let e=()=>{if(this.eventQueue.length>0){let t=[...this.eventQueue];this.eventQueue=[];let r=this.chunkEvents(t,this.config.maxEventsPerRequest);r.length>0&&this.sendEventsWithBeacon(r[0]).catch(()=>{})}};window.addEventListener("beforeunload",e),window.addEventListener("pagehide",e),document.addEventListener("visibilitychange",()=>{if(document.visibilityState==="hidden"&&this.eventQueue.length>0){let t=[...this.eventQueue];this.eventQueue=[];let r=this.chunkEvents(t,this.config.maxEventsPerRequest);r.length>0&&this.sendEventsWithBeacon(r[0]).catch(()=>{})}})}initializeAutomaticTracking(){if(this.config.enableHeartbeat)try{this.activityDetector=new m,this.heartbeatManager=new v(this,this.activityDetector,{activeInterval:this.config.heartbeatActiveInterval,inactiveInterval:this.config.heartbeatInactiveInterval,debug:this.config.debug}),this.log("Heartbeat tracking initialized")}catch(e){this.log("Failed to initialize heartbeat tracking:",e)}if(this.config.enableAutoPageView)try{this.pageTrackingManager=new y(this,{stripQueryParams:this.config.stripQueryParams,debug:this.config.debug}),this.log("Auto page view tracking initialized")}catch(e){this.log("Failed to initialize page view tracking:",e)}}handleConsentGranted(){this.flushWaitingForConsentQueue(),this.ephemeralSessionId&&this.trackSystemEvent("_grain_consent_granted",{previous_session_id:this.ephemeralSessionId,new_user_id:this.getEffectiveUserId(),timestamp:Date.now()})}trackSystemEvent(e,t){if(this.isDestroyed)return;let r=this.consentManager.hasConsent("analytics"),n={eventName:e,userId:r?this.getEffectiveUserId():this.getEphemeralSessionId(),properties:{...t,_minimal:!r,_consent_status:r?"granted":"pending"}};this.eventQueue.push(n),this.eventCountSinceLastHeartbeat++,this.log(`Queued system event: ${e}`,t),this.eventQueue.length>=this.config.batchSize&&this.flush().catch(s=>{let i=this.formatError(s,"flush system event");this.logError(i)})}getEphemeralSessionId(){return this.ephemeralSessionId||(this.ephemeralSessionId=this.generateUUID()),this.ephemeralSessionId}getCurrentPage(){return this.pageTrackingManager?.getCurrentPage()||null}getEventCountSinceLastHeartbeat(){return this.eventCountSinceLastHeartbeat}resetEventCountSinceLastHeartbeat(){this.eventCountSinceLastHeartbeat=0}getEffectiveUserId(){return this.getEffectiveUserIdInternal()}getSessionId(){return this.consentManager.hasConsent("analytics")?this.getEffectiveUserId():this.getEphemeralSessionId()}async track(e,t,r){try{if(this.isDestroyed){let o=new Error("Grain Analytics: Client has been destroyed"),a=this.formatError(o,"track (client destroyed)");this.logError(a);return}let n,s={};if(typeof e=="string"?(n={eventName:e,properties:t},s=r||{}):(n=e,s=t||{}),this.config.allowedProperties&&n.properties){let o={};for(let a of this.config.allowedProperties)a in n.properties&&(o[a]=n.properties[a]);n.properties=o}let i=this.formatEvent(n);if(this.consentManager.shouldWaitForConsent()&&this.config.waitForConsent){this.waitingForConsentQueue.push(i),this.log(`Event waiting for consent: ${n.eventName}`,n.properties);return}if(!this.consentManager.hasConsent("analytics")){this.log(`Event blocked by consent: ${n.eventName}`);return}this.eventQueue.push(i),this.eventCountSinceLastHeartbeat++,this.log(`Queued event: ${n.eventName}`,n.properties),(s.flush||this.eventQueue.length>=this.config.batchSize)&&await this.flush()}catch(n){let s=this.formatError(n,"track");this.logError(s)}}flushWaitingForConsentQueue(){this.waitingForConsentQueue.length!==0&&(this.log(`Flushing ${this.waitingForConsentQueue.length} events waiting for consent`),this.eventQueue.push(...this.waitingForConsentQueue),this.waitingForConsentQueue=[],this.flush().catch(e=>{let t=this.formatError(e,"flush waiting for consent queue");this.logError(t)}))}identify(e){this.log(`Identified user: ${e}`),this.globalUserId=e,this.persistentAnonymousUserId=null}setUserId(e){if(this.log(`Set global user ID: ${e}`),this.globalUserId=e,e)this.persistentAnonymousUserId=null;else if(!this.persistentAnonymousUserId&&(this.persistentAnonymousUserId=this.generateAnonymousUserId(),typeof window<"u"))try{let t=`grain_anonymous_user_id_${this.config.tenantId}`;localStorage.setItem(t,this.persistentAnonymousUserId)}catch(t){this.log("Failed to persist new anonymous user ID:",t)}}getUserId(){return this.globalUserId}getEffectiveUserIdPublic(){return this.getEffectiveUserIdInternal()}login(e){try{if(this.isDestroyed){let t=new Error("Grain Analytics: Client has been destroyed"),r=this.formatError(t,"login (client destroyed)");this.logError(r);return}e.userId&&(this.log(`Login: Setting user ID to ${e.userId}`),this.globalUserId=e.userId,this.persistentAnonymousUserId=null),e.authToken&&(this.log("Login: Setting auth token"),this.config.authStrategy==="NONE"&&(this.config.authStrategy="JWT"),this.config.authProvider={getToken:()=>e.authToken}),e.authStrategy&&(this.log(`Login: Setting auth strategy to ${e.authStrategy}`),this.config.authStrategy=e.authStrategy),this.log(`Login successful. Effective user ID: ${this.getEffectiveUserIdInternal()}`)}catch(t){let r=this.formatError(t,"login");this.logError(r)}}logout(){try{if(this.isDestroyed){let e=new Error("Grain Analytics: Client has been destroyed"),t=this.formatError(e,"logout (client destroyed)");this.logError(t);return}if(this.log("Logout: Clearing user session"),this.globalUserId=null,this.config.authStrategy="NONE",this.config.authProvider=void 0,!this.persistentAnonymousUserId&&(this.persistentAnonymousUserId=this.generateAnonymousUserId(),typeof window<"u"))try{let e=`grain_anonymous_user_id_${this.config.tenantId}`;localStorage.setItem(e,this.persistentAnonymousUserId)}catch(e){this.log("Failed to persist new anonymous user ID after logout:",e)}this.log(`Logout successful. Effective user ID: ${this.getEffectiveUserIdInternal()}`)}catch(e){let t=this.formatError(e,"logout");this.logError(t)}}async setProperty(e,t){try{if(this.isDestroyed){let o=new Error("Grain Analytics: Client has been destroyed"),a=this.formatError(o,"setProperty (client destroyed)");this.logError(a);return}let r=t?.userId||this.getEffectiveUserIdInternal(),n=Object.keys(e);if(n.length>4){let o=new Error("Grain Analytics: Maximum 4 properties allowed per request"),a=this.formatError(o,"setProperty (validation)");this.logError(a);return}if(n.length===0){let o=new Error("Grain Analytics: At least one property is required"),a=this.formatError(o,"setProperty (validation)");this.logError(a);return}let s={};for(let[o,a]of Object.entries(e))a==null?s[o]="":typeof a=="string"?s[o]=a:s[o]=JSON.stringify(a);let i={userId:r,...s};await this.sendProperties(i)}catch(r){let n=this.formatError(r,"setProperty");this.logError(n)}}async sendProperties(e){let t;for(let r=0;r<=this.config.retryAttempts;r++)try{let n=await this.getAuthHeaders(),s=`${this.config.apiUrl}/v1/events/${encodeURIComponent(this.config.tenantId)}/properties`;this.log(`Setting properties for user ${e.userId} (attempt ${r+1})`);let i=await fetch(s,{method:"POST",headers:n,body:JSON.stringify(e)});if(!i.ok){let o=`HTTP ${i.status}`;try{let h=await i.json();h?.message&&(o=h.message)}catch{let h=await i.text();h&&(o=h)}let a=new Error(`Failed to set properties: ${o}`);throw a.status=i.status,a}this.log(`Successfully set properties for user ${e.userId}`);return}catch(n){if(t=n,r===this.config.retryAttempts){let i=this.formatError(n,`sendProperties (attempt ${r+1}/${this.config.retryAttempts+1})`);this.logError(i);return}if(!this.isRetriableError(n)){let i=this.formatError(n,"sendProperties (non-retriable error)");this.logError(i);return}let s=this.config.retryDelay*Math.pow(2,r);this.log(`Retrying in ${s}ms after error:`,n),await this.delay(s)}}async trackLogin(e,t){try{return await this.track("login",e,t)}catch(r){let n=this.formatError(r,"trackLogin");this.logError(n)}}async trackSignup(e,t){try{return await this.track("signup",e,t)}catch(r){let n=this.formatError(r,"trackSignup");this.logError(n)}}async trackCheckout(e,t){try{return await this.track("checkout",e,t)}catch(r){let n=this.formatError(r,"trackCheckout");this.logError(n)}}async trackPageView(e,t){try{return await this.track("page_view",e,t)}catch(r){let n=this.formatError(r,"trackPageView");this.logError(n)}}async trackPurchase(e,t){try{return await this.track("purchase",e,t)}catch(r){let n=this.formatError(r,"trackPurchase");this.logError(n)}}async trackSearch(e,t){try{return await this.track("search",e,t)}catch(r){let n=this.formatError(r,"trackSearch");this.logError(n)}}async trackAddToCart(e,t){try{return await this.track("add_to_cart",e,t)}catch(r){let n=this.formatError(r,"trackAddToCart");this.logError(n)}}async trackRemoveFromCart(e,t){try{return await this.track("remove_from_cart",e,t)}catch(r){let n=this.formatError(r,"trackRemoveFromCart");this.logError(n)}}async flush(){try{if(this.eventQueue.length===0)return;let e=[...this.eventQueue];this.eventQueue=[];let t=this.chunkEvents(e,this.config.maxEventsPerRequest);for(let r of t)await this.sendEvents(r)}catch(e){let t=this.formatError(e,"flush");this.logError(t)}}initializeConfigCache(){if(!(!this.config.enableConfigCache||typeof window>"u"))try{let e=localStorage.getItem(this.config.configCacheKey);e&&(this.configCache=JSON.parse(e),this.log("Loaded configuration from cache:",this.configCache))}catch(e){this.log("Failed to load configuration cache:",e)}}saveConfigCache(e){if(!(!this.config.enableConfigCache||typeof window>"u"))try{localStorage.setItem(this.config.configCacheKey,JSON.stringify(e)),this.log("Saved configuration to cache:",e)}catch(t){this.log("Failed to save configuration cache:",t)}}getConfig(e){if(this.configCache?.configurations?.[e])return this.configCache.configurations[e];if(this.config.defaultConfigurations?.[e])return this.config.defaultConfigurations[e]}getAllConfigs(){let e={...this.config.defaultConfigurations};return this.configCache?.configurations&&Object.assign(e,this.configCache.configurations),e}async fetchConfig(e={}){try{if(this.isDestroyed){let o=new Error("Grain Analytics: Client has been destroyed"),a=this.formatError(o,"fetchConfig (client destroyed)");return this.logError(a),null}let t=e.userId||this.getEffectiveUserIdInternal(),r=e.immediateKeys||[],n=e.properties||{},s={userId:t,immediateKeys:r,properties:n},i;for(let o=0;o<=this.config.retryAttempts;o++)try{let a=await this.getAuthHeaders(),h=`${this.config.apiUrl}/v1/client/${encodeURIComponent(this.config.tenantId)}/config/configurations`;this.log(`Fetching configurations for user ${t} (attempt ${o+1})`);let g=await fetch(h,{method:"POST",headers:a,body:JSON.stringify(s)});if(!g.ok){let E=`HTTP ${g.status}`;try{let l=await g.json();l?.message&&(E=l.message)}catch{let l=await g.text();l&&(E=l)}let I=new Error(`Failed to fetch configurations: ${E}`);throw I.status=g.status,I}let d=await g.json();return d.configurations&&this.updateConfigCache(d,t),this.log(`Successfully fetched configurations for user ${t}:`,d),d}catch(a){if(i=a,o===this.config.retryAttempts){let g=this.formatError(a,`fetchConfig (attempt ${o+1}/${this.config.retryAttempts+1})`);return this.logError(g),null}if(!this.isRetriableError(a)){let g=this.formatError(a,"fetchConfig (non-retriable error)");return this.logError(g),null}let h=this.config.retryDelay*Math.pow(2,o);this.log(`Retrying config fetch in ${h}ms after error:`,a),await this.delay(h)}return null}catch(t){let r=this.formatError(t,"fetchConfig");return this.logError(r),null}}async getConfigAsync(e,t={}){try{if(!t.forceRefresh&&this.configCache?.configurations?.[e])return this.configCache.configurations[e];if(!t.forceRefresh&&this.config.defaultConfigurations?.[e])return this.config.defaultConfigurations[e];let r=await this.fetchConfig(t);return r?r.configurations[e]:this.config.defaultConfigurations?.[e]}catch(r){let n=this.formatError(r,"getConfigAsync");return this.logError(n),this.config.defaultConfigurations?.[e]}}async getAllConfigsAsync(e={}){try{if(!e.forceRefresh&&this.configCache?.configurations)return{...this.config.defaultConfigurations,...this.configCache.configurations};let t=await this.fetchConfig(e);return t?{...this.config.defaultConfigurations,...t.configurations}:{...this.config.defaultConfigurations}}catch(t){let r=this.formatError(t,"getAllConfigsAsync");return this.logError(r),{...this.config.defaultConfigurations}}}updateConfigCache(e,t){let r={configurations:e.configurations,snapshotId:e.snapshotId,timestamp:e.timestamp,userId:t},n=this.configCache?.configurations||{};this.configCache=r,this.saveConfigCache(r),JSON.stringify(n)!==JSON.stringify(e.configurations)&&this.notifyConfigChangeListeners(e.configurations)}addConfigChangeListener(e){this.configChangeListeners.push(e)}removeConfigChangeListener(e){let t=this.configChangeListeners.indexOf(e);t>-1&&this.configChangeListeners.splice(t,1)}notifyConfigChangeListeners(e){this.configChangeListeners.forEach(t=>{try{t(e)}catch(r){console.error("[Grain Analytics] Config change listener error:",r)}})}startConfigRefreshTimer(){this.configRefreshTimer&&clearInterval(this.configRefreshTimer),this.configRefreshTimer=window.setInterval(()=>{this.isDestroyed||this.fetchConfig().catch(e=>{let t=this.formatError(e,"auto-config refresh");this.logError(t)})},this.config.configRefreshInterval)}stopConfigRefreshTimer(){this.configRefreshTimer&&(clearInterval(this.configRefreshTimer),this.configRefreshTimer=null)}async preloadConfig(e=[],t){try{let r=this.getEffectiveUserIdInternal();this.log(`Preloading config for user: ${r}`),await this.fetchConfig({immediateKeys:e,properties:t})&&this.startConfigRefreshTimer()}catch(r){let n=this.formatError(r,"preloadConfig");this.logError(n)}}chunkEvents(e,t){let r=[];for(let n=0;n<e.length;n+=t)r.push(e.slice(n,n+t));return r}grantConsent(e){try{this.consentManager.grantConsent(e),this.log("Consent granted",e)}catch(t){let r=this.formatError(t,"grantConsent");this.logError(r)}}revokeConsent(e){try{this.consentManager.revokeConsent(e),this.log("Consent revoked",e),this.eventQueue=[],this.waitingForConsentQueue=[]}catch(t){let r=this.formatError(t,"revokeConsent");this.logError(r)}}getConsentState(){return this.consentManager.getConsentState()}hasConsent(e){return this.consentManager.hasConsent(e)}onConsentChange(e){this.consentManager.addListener(e)}offConsentChange(e){this.consentManager.removeListener(e)}destroy(){if(this.isDestroyed=!0,this.flushTimer&&(clearInterval(this.flushTimer),this.flushTimer=null),this.stopConfigRefreshTimer(),this.configChangeListeners=[],this.heartbeatManager&&(this.heartbeatManager.destroy(),this.heartbeatManager=null),this.pageTrackingManager&&(this.pageTrackingManager.destroy(),this.pageTrackingManager=null),this.activityDetector&&(this.activityDetector.destroy(),this.activityDetector=null),this.eventQueue.length>0){let e=[...this.eventQueue];this.eventQueue=[];let t=this.chunkEvents(e,this.config.maxEventsPerRequest);if(t.length>0){this.sendEventsWithBeacon(t[0]).catch(()=>{});for(let r=1;r<t.length;r++)this.sendEventsWithBeacon(t[r]).catch(()=>{})}}}};function P(c){return new u(c)}var O=u;typeof window<"u"&&(window.Grain={GrainAnalytics:u,createGrainAnalytics:P});return D($);})();
 //# sourceMappingURL=index.global.js.map

package/dist/index.mjs

@@ -2,11 +2,11 @@
  * Grain Analytics Web SDK
  * A lightweight, dependency-free TypeScript SDK for sending analytics events to Grain's REST API
  */
-import { ConsentManager } from './consent';
-import { setCookie, getCookie, areCookiesEnabled } from './cookies';
-import { ActivityDetector } from './activity';
-import { HeartbeatManager } from './heartbeat';
-import { PageTrackingManager } from './page-tracking';
+import { ConsentManager } from './consent.js';
+import { setCookie, getCookie, areCookiesEnabled } from './cookies.js';
+import { ActivityDetector } from './activity.js';
+import { HeartbeatManager } from './heartbeat.js';
+import { PageTrackingManager } from './page-tracking.js';
 export class GrainAnalytics {
     constructor(config) {
         this.eventQueue = [];

package/dist/page-tracking.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * Page Tracking for Grain Analytics
+ * Automatically tracks page views with consent-aware behavior
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageTrackingManager = void 0;
+class PageTrackingManager {
+    constructor(tracker, config) {
+        this.isDestroyed = false;
+        this.currentPath = null;
+        this.originalPushState = null;
+        this.originalReplaceState = null;
+        /**
+         * Handle popstate event (back/forward navigation)
+         */
+        this.handlePopState = () => {
+            if (this.isDestroyed)
+                return;
+            this.trackCurrentPage();
+        };
+        /**
+         * Handle hash change event
+         */
+        this.handleHashChange = () => {
+            if (this.isDestroyed)
+                return;
+            this.trackCurrentPage();
+        };
+        this.tracker = tracker;
+        this.config = config;
+        // Track initial page load
+        this.trackCurrentPage();
+        // Setup listeners
+        this.setupHistoryListeners();
+        this.setupHashChangeListener();
+    }
+    /**
+     * Setup History API listeners (pushState, replaceState, popstate)
+     */
+    setupHistoryListeners() {
+        if (typeof window === 'undefined' || typeof history === 'undefined')
+            return;
+        // Wrap pushState
+        this.originalPushState = history.pushState;
+        history.pushState = (state, title, url) => {
+            this.originalPushState?.call(history, state, title, url);
+            this.trackCurrentPage();
+        };
+        // Wrap replaceState
+        this.originalReplaceState = history.replaceState;
+        history.replaceState = (state, title, url) => {
+            this.originalReplaceState?.call(history, state, title, url);
+            this.trackCurrentPage();
+        };
+        // Listen to popstate (back/forward buttons)
+        window.addEventListener('popstate', this.handlePopState);
+    }
+    /**
+     * Setup hash change listener
+     */
+    setupHashChangeListener() {
+        if (typeof window === 'undefined')
+            return;
+        window.addEventListener('hashchange', this.handleHashChange);
+    }
+    /**
+     * Track the current page
+     */
+    trackCurrentPage() {
+        if (this.isDestroyed || typeof window === 'undefined')
+            return;
+        const page = this.extractPath(window.location.href);
+        // Don't track if it's the same page
+        if (page === this.currentPath) {
+            return;
+        }
+        this.currentPath = page;
+        const hasConsent = this.tracker.hasConsent('analytics');
+        // Base properties (always included)
+        const properties = {
+            page,
+            timestamp: Date.now(),
+        };
+        // Enhanced properties when consent is granted
+        if (hasConsent) {
+            properties.referrer = document.referrer || '';
+            properties.title = document.title || '';
+            properties.full_url = window.location.href;
+        }
+        // Track the page view event
+        this.tracker.trackSystemEvent('page_view', properties);
+        if (this.config.debug) {
+            console.log('[Page Tracking] Tracked page view:', properties);
+        }
+    }
+    /**
+     * Extract path from URL, optionally stripping query parameters
+     */
+    extractPath(url) {
+        try {
+            const urlObj = new URL(url);
+            let path = urlObj.pathname + urlObj.hash;
+            if (!this.config.stripQueryParams && urlObj.search) {
+                path += urlObj.search;
+            }
+            return path;
+        }
+        catch (error) {
+            // If URL parsing fails, return the raw string
+            if (this.config.debug) {
+                console.warn('[Page Tracking] Failed to parse URL:', url, error);
+            }
+            return url;
+        }
+    }
+    /**
+     * Get the current page path
+     */
+    getCurrentPage() {
+        return this.currentPath;
+    }
+    /**
+     * Manually track a page view (for custom navigation)
+     */
+    trackPage(page, properties) {
+        if (this.isDestroyed)
+            return;
+        const hasConsent = this.tracker.hasConsent('analytics');
+        // Base properties
+        const baseProperties = {
+            page,
+            timestamp: Date.now(),
+            ...properties,
+        };
+        // Enhanced properties when consent is granted
+        if (hasConsent && typeof document !== 'undefined') {
+            if (!baseProperties.referrer) {
+                baseProperties.referrer = document.referrer || '';
+            }
+            if (!baseProperties.title) {
+                baseProperties.title = document.title || '';
+            }
+            if (!baseProperties.full_url && typeof window !== 'undefined') {
+                baseProperties.full_url = window.location.href;
+            }
+        }
+        this.tracker.trackSystemEvent('page_view', baseProperties);
+        if (this.config.debug) {
+            console.log('[Page Tracking] Manually tracked page:', baseProperties);
+        }
+    }
+    /**
+     * Destroy the page tracker
+     */
+    destroy() {
+        if (this.isDestroyed)
+            return;
+        // Restore original history methods
+        if (typeof history !== 'undefined') {
+            if (this.originalPushState) {
+                history.pushState = this.originalPushState;
+            }
+            if (this.originalReplaceState) {
+                history.replaceState = this.originalReplaceState;
+            }
+        }
+        // Remove event listeners
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('popstate', this.handlePopState);
+            window.removeEventListener('hashchange', this.handleHashChange);
+        }
+        this.isDestroyed = true;
+        if (this.config.debug) {
+            console.log('[Page Tracking] Destroyed');
+        }
+    }
+}
+exports.PageTrackingManager = PageTrackingManager;
+//# sourceMappingURL=page-tracking.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Lightweight TypeScript SDK for sending analytics events and managing remote configurations via Grain's REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,8 +31,8 @@
   "scripts": {
     "build": "npm run build:types && npm run build:esm && npm run build:cjs && npm run build:react && npm run build:iife",
     "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
-    "build:esm": "tsc --module esnext --target es2020 --outDir dist/esm && mv dist/esm/index.js dist/index.mjs",
-    "build:cjs": "tsc --module commonjs --target es2020 --outDir dist/cjs && mv dist/cjs/index.js dist/index.js",
+    "build:esm": "tsc --module esnext --target es2020 --outDir dist/esm && mv dist/esm/index.js dist/index.mjs && cp dist/esm/*.js dist/ && node scripts/fix-esm-imports.js",
+    "build:cjs": "tsc --module commonjs --target es2020 --outDir dist/cjs && mv dist/cjs/index.js dist/index.js && cp dist/cjs/*.js dist/",
     "build:react": "node scripts/build-react.js",
     "build:iife": "node scripts/build-iife.js",
     "clean": "rm -rf dist",