@grainql/analytics-web 2.0.0 → 2.1.0

package/dist/cjs/react/hooks/useConsent.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * useConsent - Hook for managing user consent
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useConsent = useConsent;
+const React = __importStar(require("react"));
+const useGrainAnalytics_1 = require("./useGrainAnalytics");
+function useConsent() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    const [consentState, setConsentState] = React.useState(null);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        // Get initial consent state
+        const initialState = client.getConsentState();
+        setConsentState(initialState);
+        // Listen for consent changes
+        const listener = (state) => {
+            setConsentState(state);
+        };
+        client.onConsentChange(listener);
+        return () => {
+            client.offConsentChange(listener);
+        };
+    }, [client]);
+    const grantConsent = React.useCallback((categories) => {
+        if (client) {
+            client.grantConsent(categories);
+        }
+    }, [client]);
+    const revokeConsent = React.useCallback((categories) => {
+        if (client) {
+            client.revokeConsent(categories);
+        }
+    }, [client]);
+    const hasConsent = React.useCallback((category) => {
+        if (!client)
+            return false;
+        return client.hasConsent(category);
+    }, [client]);
+    return {
+        consentState,
+        grantConsent,
+        revokeConsent,
+        hasConsent,
+        isGranted: consentState?.granted ?? false,
+        categories: consentState?.categories ?? [],
+    };
+}
+//# sourceMappingURL=useConsent.js.map

package/dist/cjs/react/hooks/useConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,gCAyDC;AA7DD,6CAA+B;AAC/B,2DAAwD;AAGxD,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAA,qCAAiB,GAAE,CAAC;IACnC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAsB,IAAI,CAAC,CAAC;IAElF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,4BAA4B;QAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,eAAe,CAAC,YAAY,CAAC,CAAC;QAE9B,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;YACvC,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEjC,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CACpC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CACrC,CAAC,UAAqB,EAAE,EAAE;QACxB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,CAClC,CAAC,QAAiB,EAAE,EAAE;QACpB,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,UAAU;QACV,SAAS,EAAE,YAAY,EAAE,OAAO,IAAI,KAAK;QACzC,UAAU,EAAE,YAAY,EAAE,UAAU,IAAI,EAAE;KAC3C,CAAC;AACJ,CAAC"}

package/dist/cjs/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/cjs/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/cjs/react/hooks/useDataDeletion.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * useDataDeletion - Hook for triggering data deletion requests
+ * This is a client-side utility - actual deletion happens on the server
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDataDeletion = useDataDeletion;
+const React = __importStar(require("react"));
+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/cjs/react/hooks/useDataDeletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataDeletion.js","sourceRoot":"","sources":["../../../../src/react/hooks/useDataDeletion.ts"],"names":[],"mappings":"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"}

package/dist/cjs/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/cjs/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/cjs/react/hooks/usePrivacyPreferences.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * usePrivacyPreferences - Hook for managing privacy preferences
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePrivacyPreferences = usePrivacyPreferences;
+const React = __importStar(require("react"));
+const useConsent_1 = require("./useConsent");
+function usePrivacyPreferences() {
+    const { consentState, grantConsent, revokeConsent } = (0, useConsent_1.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/cjs/react/hooks/usePrivacyPreferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrivacyPreferences.js","sourceRoot":"","sources":["../../../../src/react/hooks/usePrivacyPreferences.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,sDAkDC;AA3DD,6CAA+B;AAC/B,6CAA0C;AAQ1C,SAAgB,qBAAqB;IACnC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,IAAA,uBAAU,GAAE,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/cjs/react/index.d.ts

@@ -32,5 +32,16 @@ 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/cjs/react/index.d.ts.map

@@ -1 +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,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC"}
+{"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/cjs/react/index.js

@@ -29,7 +29,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTrack = exports.useAllConfigs = exports.useConfig = exports.useGrainAnalytics = exports.GrainProvider = void 0;
+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; } });
@@ -42,4 +42,18 @@ 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; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAEH,WAAW;AACX,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,QAAQ;AACR,+DAA8D;AAArD,sHAAA,iBAAiB,OAAA;AAC1B,+CAA8C;AAArC,sGAAA,SAAS,OAAA;AAClB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,oGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAEH,WAAW;AACX,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,QAAQ;AACR,+DAA8D;AAArD,sHAAA,iBAAiB,OAAA;AAC1B,+CAA8C;AAArC,sGAAA,SAAS,OAAA;AAClB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,oGAAA,QAAQ,OAAA;AAEjB,gBAAgB;AAChB,iDAAgD;AAAvC,wGAAA,UAAU,OAAA;AACnB,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAC9B,2DAA0D;AAAjD,kHAAA,eAAe,OAAA;AAExB,qBAAqB;AACrB,4DAA2D;AAAlD,8GAAA,aAAa,OAAA;AACtB,gFAA+E;AAAtE,kIAAA,uBAAuB,OAAA;AAChC,0DAAyD;AAAhD,4GAAA,YAAY,OAAA"}

package/dist/consent.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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
+     */
+    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/consent.d.ts.map

@@ -0,0 +1 @@
+{"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;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;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/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/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/esm/activity.d.ts

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

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