@grainql/analytics-web 2.2.0 → 2.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "2.2.0",
+  "version": "2.2.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",

package/dist/react/activity.d.ts

@@ -1,59 +0,0 @@
-/**
- * Activity Detection for Grain Analytics
- * Tracks user activity (mouse, keyboard, touch, scroll) to determine if user is active
- */
-export declare class ActivityDetector {
-    private lastActivityTime;
-    private activityThreshold;
-    private listeners;
-    private boundActivityHandler;
-    private isDestroyed;
-    private readonly activityEvents;
-    constructor();
-    /**
-     * Setup event listeners for activity detection
-     */
-    private setupListeners;
-    /**
-     * Handle activity event
-     */
-    private handleActivity;
-    /**
-     * Debounce function to limit how often activity handler is called
-     */
-    private debounce;
-    /**
-     * Check if user is currently active
-     * @param threshold Time in ms to consider user inactive (default: 30s)
-     */
-    isActive(threshold?: number): boolean;
-    /**
-     * Get time since last activity in milliseconds
-     */
-    getTimeSinceLastActivity(): number;
-    /**
-     * Get last activity timestamp
-     */
-    getLastActivityTime(): number;
-    /**
-     * Set activity threshold
-     */
-    setActivityThreshold(threshold: number): void;
-    /**
-     * Add listener for activity changes
-     */
-    addListener(listener: () => void): void;
-    /**
-     * Remove listener
-     */
-    removeListener(listener: () => void): void;
-    /**
-     * Notify all listeners
-     */
-    private notifyListeners;
-    /**
-     * Cleanup and remove listeners
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=activity.d.ts.map

package/dist/react/activity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/activity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAOpB;;IAQX;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAMrC;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAIlC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAYhB"}

package/dist/react/activity.js

@@ -1,130 +0,0 @@
-"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;

package/dist/react/activity.mjs

@@ -1,126 +0,0 @@
-/**
- * Activity Detection for Grain Analytics
- * Tracks user activity (mouse, keyboard, touch, scroll) to determine if user is active
- */
-export 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;
-    }
-}

package/dist/react/consent.d.ts

@@ -1,72 +0,0 @@
-/**
- * Consent management for Grain Analytics
- * Handles GDPR-compliant consent tracking and state management
- */
-export type ConsentMode = 'opt-in' | 'opt-out' | 'disabled';
-export interface ConsentState {
-    granted: boolean;
-    categories: string[];
-    timestamp: Date;
-    version: string;
-}
-export declare const DEFAULT_CONSENT_CATEGORIES: string[];
-export declare const CONSENT_VERSION = "1.0.0";
-/**
- * Consent manager for handling user consent state
- */
-export declare class ConsentManager {
-    private consentState;
-    private consentMode;
-    private storageKey;
-    private listeners;
-    constructor(tenantId: string, consentMode?: ConsentMode);
-    /**
-     * Load consent state from localStorage
-     *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
-     */
-    private loadConsentState;
-    /**
-     * Save consent state to localStorage
-     */
-    private saveConsentState;
-    /**
-     * Grant consent with optional categories
-     */
-    grantConsent(categories?: string[]): void;
-    /**
-     * Revoke consent (opt-out)
-     */
-    revokeConsent(categories?: string[]): void;
-    /**
-     * Get current consent state
-     */
-    getConsentState(): ConsentState | null;
-    /**
-     * Check if user has granted consent
-     */
-    hasConsent(category?: string): boolean;
-    /**
-     * Check if we should wait for consent before tracking
-     */
-    shouldWaitForConsent(): boolean;
-    /**
-     * Add consent change listener
-     */
-    addListener(listener: (state: ConsentState) => void): void;
-    /**
-     * Remove consent change listener
-     */
-    removeListener(listener: (state: ConsentState) => void): void;
-    /**
-     * Notify all listeners of consent state change
-     */
-    private notifyListeners;
-    /**
-     * Clear all consent data
-     */
-    clearConsent(): void;
-}
-//# sourceMappingURL=consent.d.ts.map

package/dist/react/consent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}

package/dist/react/consent.js

@@ -1,195 +0,0 @@
-"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
-     *
-     * GDPR Compliance: In opt-in mode, we can use localStorage for consent preferences
-     * since storing consent choices is a legitimate interest and necessary for compliance.
-     * The consent preference itself is not tracking data.
-     */
-    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();
-            }
-            // Note: In opt-in mode without stored consent, consentState remains null (no consent)
-        }
-        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;