@grainql/analytics-web 1.7.4 → 2.1.0

package/dist/esm/react/hooks/useDataDeletion.d.ts

@@ -0,0 +1,17 @@
+/**
+ * useDataDeletion - Hook for triggering data deletion requests
+ * This is a client-side utility - actual deletion happens on the server
+ */
+export interface DataDeletionOptions {
+    apiUrl: string;
+    tenantId: string;
+    onSuccess?: (message: string) => void;
+    onError?: (error: string) => void;
+}
+export declare function useDataDeletion(options: DataDeletionOptions): {
+    requestDeletion: (userId: string) => Promise<any>;
+    requestAnonymization: (userId: string) => Promise<any>;
+    loading: boolean;
+    error: string | null;
+};
+//# sourceMappingURL=useDataDeletion.d.ts.map

package/dist/esm/react/hooks/useDataDeletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataDeletion.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useDataDeletion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB;8BAKzC,MAAM;mCAyCN,MAAM;;;EA6CxB"}

package/dist/esm/react/hooks/useDataDeletion.js

@@ -0,0 +1,81 @@
+/**
+ * useDataDeletion - Hook for triggering data deletion requests
+ * This is a client-side utility - actual deletion happens on the server
+ */
+import * as React from 'react';
+export function useDataDeletion(options) {
+    const [loading, setLoading] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const requestDeletion = React.useCallback(async (userId) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const response = await fetch(`${options.apiUrl}/v1/privacy/${options.tenantId}/data-deletion`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    userId,
+                    deleteEvents: true,
+                    deleteProperties: true,
+                    deleteConsentAudit: false,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const result = await response.json();
+            options.onSuccess?.(result.message);
+            return result;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            setError(errorMessage);
+            options.onError?.(errorMessage);
+            throw err;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [options]);
+    const requestAnonymization = React.useCallback(async (userId) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const response = await fetch(`${options.apiUrl}/v1/privacy/${options.tenantId}/anonymize-user`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    userId,
+                    anonymizeEvents: true,
+                    anonymizeProperties: true,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const result = await response.json();
+            options.onSuccess?.(result.message);
+            return result;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            setError(errorMessage);
+            options.onError?.(errorMessage);
+            throw err;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [options]);
+    return {
+        requestDeletion,
+        requestAnonymization,
+        loading,
+        error,
+    };
+}
+//# sourceMappingURL=useDataDeletion.js.map

package/dist/esm/react/hooks/useDataDeletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataDeletion.js","sourceRoot":"","sources":["../../../../src/react/hooks/useDataDeletion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE9D,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CACvC,KAAK,EAAE,MAAc,EAAE,EAAE;QACvB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,QAAQ,gBAAgB,EAChE;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM;oBACN,YAAY,EAAE,IAAI;oBAClB,gBAAgB,EAAE,IAAI;oBACtB,kBAAkB,EAAE,KAAK;iBAC1B,CAAC;aACH,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC1E,QAAQ,CAAC,YAAY,CAAC,CAAC;YACvB,OAAO,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,oBAAoB,GAAG,KAAK,CAAC,WAAW,CAC5C,KAAK,EAAE,MAAc,EAAE,EAAE;QACvB,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,QAAQ,iBAAiB,EACjE;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM;oBACN,eAAe,EAAE,IAAI;oBACrB,mBAAmB,EAAE,IAAI;iBAC1B,CAAC;aACH,CACF,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC1E,QAAQ,CAAC,YAAY,CAAC,CAAC;YACvB,OAAO,CAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;YAChC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO;QACL,eAAe;QACf,oBAAoB;QACpB,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/esm/react/hooks/useGrainAnalytics.d.ts

@@ -0,0 +1,6 @@
+/**
+ * useGrainAnalytics - Access the GrainAnalytics client from context
+ */
+import type { GrainAnalytics } from '../../index';
+export declare function useGrainAnalytics(): GrainAnalytics;
+//# sourceMappingURL=useGrainAnalytics.d.ts.map

package/dist/esm/react/hooks/useGrainAnalytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGrainAnalytics.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useGrainAnalytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD"}

package/dist/esm/react/hooks/useGrainAnalytics.js

@@ -0,0 +1,14 @@
+/**
+ * useGrainAnalytics - Access the GrainAnalytics client from context
+ */
+import * as React from 'react';
+import { GrainContext } from '../context';
+export function useGrainAnalytics() {
+    const context = React.useContext(GrainContext);
+    if (!context) {
+        throw new Error('useGrainAnalytics must be used within a GrainProvider. ' +
+            'Wrap your component tree with <GrainProvider client={client}> or <GrainProvider config={{...}}>');
+    }
+    return context.client;
+}
+//# sourceMappingURL=useGrainAnalytics.js.map

package/dist/esm/react/hooks/useGrainAnalytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGrainAnalytics.js","sourceRoot":"","sources":["../../../../src/react/hooks/useGrainAnalytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yDAAyD;YACzD,iGAAiG,CAClG,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}

package/dist/esm/react/hooks/usePrivacyPreferences.d.ts

@@ -0,0 +1,15 @@
+/**
+ * usePrivacyPreferences - Hook for managing privacy preferences
+ */
+export interface PrivacyPreferences {
+    necessary: boolean;
+    analytics: boolean;
+    functional: boolean;
+}
+export declare function usePrivacyPreferences(): {
+    preferences: PrivacyPreferences;
+    updatePreferences: (newPreferences: Partial<PrivacyPreferences>) => void;
+    acceptAll: () => void;
+    rejectAll: () => void;
+};
+//# sourceMappingURL=usePrivacyPreferences.d.ts.map

package/dist/esm/react/hooks/usePrivacyPreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrivacyPreferences.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/usePrivacyPreferences.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,qBAAqB;;wCAahB,OAAO,CAAC,kBAAkB,CAAC;;;EAqC/C"}

package/dist/esm/react/hooks/usePrivacyPreferences.js

@@ -0,0 +1,46 @@
+/**
+ * usePrivacyPreferences - Hook for managing privacy preferences
+ */
+import * as React from 'react';
+import { useConsent } from './useConsent';
+export function usePrivacyPreferences() {
+    const { consentState, grantConsent, revokeConsent } = useConsent();
+    const preferences = React.useMemo(() => {
+        const categories = consentState?.categories ?? [];
+        return {
+            necessary: categories.includes('necessary'),
+            analytics: categories.includes('analytics'),
+            functional: categories.includes('functional'),
+        };
+    }, [consentState]);
+    const updatePreferences = React.useCallback((newPreferences) => {
+        const categories = [];
+        // Necessary is always enabled
+        categories.push('necessary');
+        if (newPreferences.analytics ?? preferences.analytics) {
+            categories.push('analytics');
+        }
+        if (newPreferences.functional ?? preferences.functional) {
+            categories.push('functional');
+        }
+        if (categories.length > 0) {
+            grantConsent(categories);
+        }
+        else {
+            revokeConsent();
+        }
+    }, [preferences, grantConsent, revokeConsent]);
+    const acceptAll = React.useCallback(() => {
+        grantConsent(['necessary', 'analytics', 'functional']);
+    }, [grantConsent]);
+    const rejectAll = React.useCallback(() => {
+        grantConsent(['necessary']); // Keep only necessary
+    }, [grantConsent]);
+    return {
+        preferences,
+        updatePreferences,
+        acceptAll,
+        rejectAll,
+    };
+}
+//# sourceMappingURL=usePrivacyPreferences.js.map

package/dist/esm/react/hooks/usePrivacyPreferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrivacyPreferences.js","sourceRoot":"","sources":["../../../../src/react/hooks/usePrivacyPreferences.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,CAAC;IAEnE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAqB,GAAG,EAAE;QACzD,MAAM,UAAU,GAAG,YAAY,EAAE,UAAU,IAAI,EAAE,CAAC;QAClD,OAAO;YACL,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC3C,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC3C,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;SAC9C,CAAC;IACJ,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CACzC,CAAC,cAA2C,EAAE,EAAE;QAC9C,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,8BAA8B;QAC9B,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE7B,IAAI,cAAc,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,cAAc,CAAC,UAAU,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YACxD,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,aAAa,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,EACD,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAC3C,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACvC,YAAY,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACvC,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,sBAAsB;IACrD,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO;QACL,WAAW;QACX,iBAAiB;QACjB,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/esm/react/hooks/useTrack.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useTrack - Get a stable, memoized track function
+ *
+ * Returns a track function that doesn't cause re-renders when passed to child components.
+ * Prevents unnecessary re-renders compared to using useCallback.
+ */
+import type { TrackFunction } from '../types';
+export declare function useTrack(): TrackFunction;
+//# sourceMappingURL=useTrack.d.ts.map

package/dist/esm/react/hooks/useTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrack.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useTrack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,QAAQ,IAAI,aAAa,CAYxC"}

package/dist/esm/react/hooks/useTrack.js

@@ -0,0 +1,17 @@
+/**
+ * useTrack - Get a stable, memoized track function
+ *
+ * Returns a track function that doesn't cause re-renders when passed to child components.
+ * Prevents unnecessary re-renders compared to using useCallback.
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from './useGrainAnalytics';
+export function useTrack() {
+    const client = useGrainAnalytics();
+    // Create stable track function that won't change across renders
+    const track = React.useCallback(async (eventName, properties, options) => {
+        await client.track(eventName, properties, options);
+    }, [client]);
+    return track;
+}
+//# sourceMappingURL=useTrack.js.map

package/dist/esm/react/hooks/useTrack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrack.js","sourceRoot":"","sources":["../../../../src/react/hooks/useTrack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,UAAU,QAAQ;IACtB,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,gEAAgE;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAC7B,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * 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/esm/react/index.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/react/index.js

@@ -0,0 +1,45 @@
+/**
+ * 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';
+//# sourceMappingURL=index.js.map

package/dist/esm/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,QAAQ;AACR,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;AAE5C,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,qBAAqB;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/esm/react/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * React-specific types for Grain Analytics
+ */
+import type { GrainAnalytics, GrainConfig, SendEventOptions } from '../index';
+export interface GrainProviderProps {
+    children: React.ReactNode;
+    client?: GrainAnalytics;
+    config?: GrainConfig;
+}
+export interface UseConfigOptions {
+    forceRefresh?: boolean;
+    immediateKeys?: string[];
+    properties?: Record<string, string>;
+}
+export interface UseConfigResult {
+    value: string | undefined;
+    isRefreshing: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+export interface UseAllConfigsOptions {
+    forceRefresh?: boolean;
+    immediateKeys?: string[];
+    properties?: Record<string, string>;
+}
+export interface UseAllConfigsResult {
+    configs: Record<string, string>;
+    isRefreshing: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+}
+export type TrackFunction = (eventName: string, properties?: Record<string, unknown>, options?: SendEventOptions) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/react/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,CAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,gBAAgB,KACvB,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/esm/react/types.js

@@ -0,0 +1,5 @@
+/**
+ * React-specific types for Grain Analytics
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/react/types.js.map

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

package/dist/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/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/index.d.ts

@@ -2,6 +2,10 @@
  * Grain Analytics Web SDK
  * A lightweight, dependency-free TypeScript SDK for sending analytics events to Grain's REST API
  */
+import { ConsentState, ConsentMode } from './consent';
+import { CookieConfig } from './cookies';
+import { type HeartbeatTracker } from './heartbeat';
+import { type PageTracker } from './page-tracking';
 export interface GrainEvent {
     eventName: string;
     userId?: string;
@@ -17,6 +21,7 @@ export type AuthStrategy = 'NONE' | 'SERVER_SIDE' | 'JWT';
 export interface AuthProvider {
     getToken(): Promise<string> | string;
 }
+export type { ConsentState, ConsentMode, CookieConfig };
 export interface GrainConfig {
     tenantId: string;
     apiUrl?: string;
@@ -34,6 +39,18 @@ export interface GrainConfig {
     configCacheKey?: string;
     configRefreshInterval?: number;
     enableConfigCache?: boolean;
+    consentMode?: ConsentMode;
+    waitForConsent?: boolean;
+    enableCookies?: boolean;
+    cookieOptions?: CookieConfig;
+    anonymizeIP?: boolean;
+    disableAutoProperties?: boolean;
+    allowedProperties?: string[];
+    enableHeartbeat?: boolean;
+    heartbeatActiveInterval?: number;
+    heartbeatInactiveInterval?: number;
+    enableAutoPageView?: boolean;
+    stripQueryParams?: boolean;
 }
 export interface SendEventOptions {
     flush?: boolean;
@@ -177,9 +194,10 @@ export interface FormattedError {
     context: string;
     originalError?: unknown;
 }
-export declare class GrainAnalytics {
+export declare class GrainAnalytics implements HeartbeatTracker, PageTracker {
     private config;
     private eventQueue;
+    private waitingForConsentQueue;
     private flushTimer;
     private isDestroyed;
     private globalUserId;
@@ -188,6 +206,13 @@ export declare class GrainAnalytics {
     private configRefreshTimer;
     private configChangeListeners;
     private configFetchPromise;
+    private consentManager;
+    private cookiesEnabled;
+    private activityDetector;
+    private heartbeatManager;
+    private pageTrackingManager;
+    private ephemeralSessionId;
+    private eventCountSinceLastHeartbeat;
     constructor(config: GrainConfig);
     private validateConfig;
     /**
@@ -199,13 +224,18 @@ export declare class GrainAnalytics {
      */
     private generateAnonymousUserId;
     /**
-     * Initialize persistent anonymous user ID from localStorage or create new one
+     * Initialize persistent anonymous user ID from cookies or localStorage
+     * Priority: Cookie → localStorage → generate new
      */
     private initializePersistentAnonymousUserId;
+    /**
+     * Save persistent anonymous user ID to cookie and/or localStorage
+     */
+    private savePersistentAnonymousUserId;
     /**
      * Get the effective user ID (global userId or persistent anonymous ID)
      */
-    private getEffectiveUserId;
+    private getEffectiveUserIdInternal;
     private log;
     /**
      * Create error digest from events
@@ -231,11 +261,51 @@ export declare class GrainAnalytics {
     private sendEventsWithBeacon;
     private startFlushTimer;
     private setupBeforeUnload;
+    /**
+     * Initialize automatic tracking (heartbeat and page views)
+     */
+    private initializeAutomaticTracking;
+    /**
+     * Handle consent granted - upgrade ephemeral session to persistent user
+     */
+    private handleConsentGranted;
+    /**
+     * Track system events that bypass consent checks (for necessary/functional tracking)
+     */
+    trackSystemEvent(eventName: string, properties: Record<string, unknown>): void;
+    /**
+     * Get ephemeral session ID (memory-only, not persisted)
+     */
+    getEphemeralSessionId(): string;
+    /**
+     * Get the current page path from page tracker
+     */
+    getCurrentPage(): string | null;
+    /**
+     * Get event count since last heartbeat
+     */
+    getEventCountSinceLastHeartbeat(): number;
+    /**
+     * Reset event count since last heartbeat
+     */
+    resetEventCountSinceLastHeartbeat(): void;
+    /**
+     * Get the effective user ID (public method)
+     */
+    getEffectiveUserId(): string;
+    /**
+     * Get the session ID (ephemeral or persistent based on consent)
+     */
+    getSessionId(): string;
     /**
      * Track an analytics event
      */
     track(eventName: string, properties?: Record<string, unknown>, options?: SendEventOptions): Promise<void>;
     track(event: GrainEvent, options?: SendEventOptions): Promise<void>;
+    /**
+     * Flush events that were waiting for consent
+     */
+    private flushWaitingForConsentQueue;
     /**
      * Identify a user (sets userId for subsequent events)
      */
@@ -384,6 +454,33 @@ export declare class GrainAnalytics {
      * Split events array into chunks of specified size
      */
     private chunkEvents;
+    /**
+     * Grant consent for tracking
+     * @param categories - Optional array of consent categories (e.g., ['analytics', 'functional'])
+     */
+    grantConsent(categories?: string[]): void;
+    /**
+     * Revoke consent for tracking (opt-out)
+     * @param categories - Optional array of categories to revoke (if not provided, revokes all)
+     */
+    revokeConsent(categories?: string[]): void;
+    /**
+     * Get current consent state
+     */
+    getConsentState(): ConsentState | null;
+    /**
+     * Check if user has granted consent
+     * @param category - Optional category to check (if not provided, checks general consent)
+     */
+    hasConsent(category?: string): boolean;
+    /**
+     * Add listener for consent state changes
+     */
+    onConsentChange(listener: (state: ConsentState) => void): void;
+    /**
+     * Remove consent change listener
+     */
+    offConsentChange(listener: (state: ConsentState) => void): void;
     /**
      * Destroy the client and clean up resources
      */