@grainql/analytics-web 1.7.4 → 2.1.0

package/dist/react/cookies.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cookie utilities for Grain Analytics
+ * Provides GDPR-compliant cookie management with configurable options
+ */
+export interface CookieConfig {
+    domain?: string;
+    path?: string;
+    sameSite?: 'strict' | 'lax' | 'none';
+    secure?: boolean;
+    maxAge?: number;
+}
+/**
+ * Set a cookie with configurable options
+ */
+export declare function setCookie(name: string, value: string, config?: CookieConfig): void;
+/**
+ * Get a cookie value by name
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Delete a cookie by name
+ */
+export declare function deleteCookie(name: string, config?: Pick<CookieConfig, 'domain' | 'path'>): void;
+/**
+ * Check if cookies are available and working
+ */
+export declare function areCookiesEnabled(): boolean;
+//# sourceMappingURL=cookies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/cookies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CA4BlF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC,GAAG,IAAI,CAmB/F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/dist/react/cookies.js

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

package/dist/react/cookies.mjs

@@ -0,0 +1,88 @@
+/**
+ * Cookie utilities for Grain Analytics
+ * Provides GDPR-compliant cookie management with configurable options
+ */
+/**
+ * Set a cookie with configurable options
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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;
+    }
+}

package/dist/react/heartbeat.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Heartbeat Manager for Grain Analytics
+ * Tracks session activity with consent-aware behavior
+ */
+import type { ActivityDetector } from './activity';
+export interface HeartbeatConfig {
+    activeInterval: number;
+    inactiveInterval: number;
+    debug?: boolean;
+}
+export interface HeartbeatTracker {
+    trackSystemEvent(eventName: string, properties: Record<string, unknown>): void;
+    hasConsent(category?: string): boolean;
+    getEffectiveUserId(): string;
+    getEphemeralSessionId(): string;
+    getCurrentPage(): string | null;
+    getEventCountSinceLastHeartbeat(): number;
+    resetEventCountSinceLastHeartbeat(): void;
+}
+export declare class HeartbeatManager {
+    private config;
+    private tracker;
+    private activityDetector;
+    private heartbeatTimer;
+    private isDestroyed;
+    private lastHeartbeatTime;
+    private currentInterval;
+    constructor(tracker: HeartbeatTracker, activityDetector: ActivityDetector, config: HeartbeatConfig);
+    /**
+     * Schedule the next heartbeat based on current activity
+     */
+    private scheduleNextHeartbeat;
+    /**
+     * Send heartbeat event
+     */
+    private sendHeartbeat;
+    /**
+     * Destroy the heartbeat manager
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,MAAM,CAAC;IAC7B,qBAAqB,IAAI,MAAM,CAAC;IAChC,cAAc,IAAI,MAAM,GAAG,IAAI,CAAC;IAChC,+BAA+B,IAAI,MAAM,CAAC;IAC1C,iCAAiC,IAAI,IAAI,CAAC;CAC3C;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,eAAe,CAAS;gBAG9B,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,EAAE,gBAAgB,EAClC,MAAM,EAAE,eAAe;IAYzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAchB"}

package/dist/react/heartbeat.js

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

package/dist/react/heartbeat.mjs

@@ -0,0 +1,87 @@
+/**
+ * Heartbeat Manager for Grain Analytics
+ * Tracks session activity with consent-aware behavior
+ */
+export 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');
+        }
+    }
+}