@grainql/analytics-web 2.2.0 → 2.3.0

package/dist/react/page-tracking.d.ts

@@ -1,60 +0,0 @@
-/**
- * Page Tracking for Grain Analytics
- * Automatically tracks page views with consent-aware behavior
- */
-export interface PageTrackingConfig {
-    stripQueryParams: boolean;
-    debug?: boolean;
-}
-export interface PageTracker {
-    trackSystemEvent(eventName: string, properties: Record<string, unknown>): void;
-    hasConsent(category?: string): boolean;
-    getEffectiveUserId(): string;
-    getEphemeralSessionId(): string;
-}
-export declare class PageTrackingManager {
-    private config;
-    private tracker;
-    private isDestroyed;
-    private currentPath;
-    private originalPushState;
-    private originalReplaceState;
-    constructor(tracker: PageTracker, config: PageTrackingConfig);
-    /**
-     * Setup History API listeners (pushState, replaceState, popstate)
-     */
-    private setupHistoryListeners;
-    /**
-     * Setup hash change listener
-     */
-    private setupHashChangeListener;
-    /**
-     * Handle popstate event (back/forward navigation)
-     */
-    private handlePopState;
-    /**
-     * Handle hash change event
-     */
-    private handleHashChange;
-    /**
-     * Track the current page
-     */
-    private trackCurrentPage;
-    /**
-     * Extract path from URL, optionally stripping query parameters
-     */
-    private extractPath;
-    /**
-     * Get the current page path
-     */
-    getCurrentPage(): string | null;
-    /**
-     * Manually track a page view (for custom navigation)
-     */
-    trackPage(page: string, properties?: Record<string, unknown>): void;
-    /**
-     * Destroy the page tracker
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=page-tracking.d.ts.map

package/dist/react/page-tracking.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"page-tracking.d.ts","sourceRoot":"","sources":["../../src/page-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,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;CACjC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,oBAAoB,CAA4C;gBAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB;IAY5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAGpB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAGtB;IAEF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgCnE;;OAEG;IACH,OAAO,IAAI,IAAI;CAyBhB"}

package/dist/react/page-tracking.js

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

package/dist/react/page-tracking.mjs

@@ -1,175 +0,0 @@
-/**
- * Page Tracking for Grain Analytics
- * Automatically tracks page views with consent-aware behavior
- */
-export 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');
-        }
-    }
-}

package/dist/react/react/index.d.ts

@@ -1,47 +0,0 @@
-/**
- * Grain Analytics React Hooks
- *
- * React integration for @grainql/analytics-web
- *
- * @example
- * ```tsx
- * import { GrainProvider, useConfig, useTrack } from '@grainql/analytics-web/react';
- *
- * // Pattern 1: Provider-managed client
- * <GrainProvider config={{ tenantId: 'xxx' }}>
- *   <App />
- * </GrainProvider>
- *
- * // Pattern 2: External client
- * const grain = new GrainAnalytics({ tenantId: 'xxx' });
- * <GrainProvider client={grain}>
- *   <App />
- * </GrainProvider>
- *
- * // Use hooks in components
- * function MyComponent() {
- *   const { value } = useConfig('hero_variant');
- *   const track = useTrack();
- *
- *   return <button onClick={() => track('clicked')}>Click</button>;
- * }
- * ```
- */
-export { GrainProvider } from './GrainProvider';
-export { useGrainAnalytics } from './hooks/useGrainAnalytics';
-export { useConfig } from './hooks/useConfig';
-export { useAllConfigs } from './hooks/useAllConfigs';
-export { useTrack } from './hooks/useTrack';
-export { useConsent } from './hooks/useConsent';
-export { usePrivacyPreferences } from './hooks/usePrivacyPreferences';
-export { useDataDeletion } from './hooks/useDataDeletion';
-export { ConsentBanner } from './components/ConsentBanner';
-export { PrivacyPreferenceCenter } from './components/PrivacyPreferenceCenter';
-export { CookieNotice } from './components/CookieNotice';
-export type { GrainProviderProps, UseConfigOptions, UseConfigResult, UseAllConfigsOptions, UseAllConfigsResult, TrackFunction, } from './types';
-export type { ConsentBannerProps } from './components/ConsentBanner';
-export type { PrivacyPreferenceCenterProps } from './components/PrivacyPreferenceCenter';
-export type { CookieNoticeProps } from './components/CookieNotice';
-export type { PrivacyPreferences } from './hooks/usePrivacyPreferences';
-export type { DataDeletionOptions } from './hooks/useDataDeletion';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/react/react/index.js

@@ -1,58 +0,0 @@
-"use strict";
-/**
- * Grain Analytics React Hooks
- *
- * React integration for @grainql/analytics-web
- *
- * @example
- * ```tsx
- * import { GrainProvider, useConfig, useTrack } from '@grainql/analytics-web/react';
- *
- * // Pattern 1: Provider-managed client
- * <GrainProvider config={{ tenantId: 'xxx' }}>
- *   <App />
- * </GrainProvider>
- *
- * // Pattern 2: External client
- * const grain = new GrainAnalytics({ tenantId: 'xxx' });
- * <GrainProvider client={grain}>
- *   <App />
- * </GrainProvider>
- *
- * // Use hooks in components
- * function MyComponent() {
- *   const { value } = useConfig('hero_variant');
- *   const track = useTrack();
- *
- *   return <button onClick={() => track('clicked')}>Click</button>;
- * }
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CookieNotice = exports.PrivacyPreferenceCenter = exports.ConsentBanner = exports.useDataDeletion = exports.usePrivacyPreferences = exports.useConsent = exports.useTrack = exports.useAllConfigs = exports.useConfig = exports.useGrainAnalytics = exports.GrainProvider = void 0;
-// Provider
-var GrainProvider_1 = require("./GrainProvider");
-Object.defineProperty(exports, "GrainProvider", { enumerable: true, get: function () { return GrainProvider_1.GrainProvider; } });
-// Hooks
-var useGrainAnalytics_1 = require("./hooks/useGrainAnalytics");
-Object.defineProperty(exports, "useGrainAnalytics", { enumerable: true, get: function () { return useGrainAnalytics_1.useGrainAnalytics; } });
-var useConfig_1 = require("./hooks/useConfig");
-Object.defineProperty(exports, "useConfig", { enumerable: true, get: function () { return useConfig_1.useConfig; } });
-var useAllConfigs_1 = require("./hooks/useAllConfigs");
-Object.defineProperty(exports, "useAllConfigs", { enumerable: true, get: function () { return useAllConfigs_1.useAllConfigs; } });
-var useTrack_1 = require("./hooks/useTrack");
-Object.defineProperty(exports, "useTrack", { enumerable: true, get: function () { return useTrack_1.useTrack; } });
-// Privacy hooks
-var useConsent_1 = require("./hooks/useConsent");
-Object.defineProperty(exports, "useConsent", { enumerable: true, get: function () { return useConsent_1.useConsent; } });
-var usePrivacyPreferences_1 = require("./hooks/usePrivacyPreferences");
-Object.defineProperty(exports, "usePrivacyPreferences", { enumerable: true, get: function () { return usePrivacyPreferences_1.usePrivacyPreferences; } });
-var useDataDeletion_1 = require("./hooks/useDataDeletion");
-Object.defineProperty(exports, "useDataDeletion", { enumerable: true, get: function () { return useDataDeletion_1.useDataDeletion; } });
-// Privacy components
-var ConsentBanner_1 = require("./components/ConsentBanner");
-Object.defineProperty(exports, "ConsentBanner", { enumerable: true, get: function () { return ConsentBanner_1.ConsentBanner; } });
-var PrivacyPreferenceCenter_1 = require("./components/PrivacyPreferenceCenter");
-Object.defineProperty(exports, "PrivacyPreferenceCenter", { enumerable: true, get: function () { return PrivacyPreferenceCenter_1.PrivacyPreferenceCenter; } });
-var CookieNotice_1 = require("./components/CookieNotice");
-Object.defineProperty(exports, "CookieNotice", { enumerable: true, get: function () { return CookieNotice_1.CookieNotice; } });

package/dist/react/react/index.mjs

@@ -1,44 +0,0 @@
-/**
- * Grain Analytics React Hooks
- *
- * React integration for @grainql/analytics-web
- *
- * @example
- * ```tsx
- * import { GrainProvider, useConfig, useTrack } from '@grainql/analytics-web/react';
- *
- * // Pattern 1: Provider-managed client
- * <GrainProvider config={{ tenantId: 'xxx' }}>
- *   <App />
- * </GrainProvider>
- *
- * // Pattern 2: External client
- * const grain = new GrainAnalytics({ tenantId: 'xxx' });
- * <GrainProvider client={grain}>
- *   <App />
- * </GrainProvider>
- *
- * // Use hooks in components
- * function MyComponent() {
- *   const { value } = useConfig('hero_variant');
- *   const track = useTrack();
- *
- *   return <button onClick={() => track('clicked')}>Click</button>;
- * }
- * ```
- */
-// Provider
-export { GrainProvider } from './GrainProvider';
-// Hooks
-export { useGrainAnalytics } from './hooks/useGrainAnalytics';
-export { useConfig } from './hooks/useConfig';
-export { useAllConfigs } from './hooks/useAllConfigs';
-export { useTrack } from './hooks/useTrack';
-// Privacy hooks
-export { useConsent } from './hooks/useConsent';
-export { usePrivacyPreferences } from './hooks/usePrivacyPreferences';
-export { useDataDeletion } from './hooks/useDataDeletion';
-// Privacy components
-export { ConsentBanner } from './components/ConsentBanner';
-export { PrivacyPreferenceCenter } from './components/PrivacyPreferenceCenter';
-export { CookieNotice } from './components/CookieNotice';