@grainql/analytics-web 2.0.0 → 2.1.0

package/dist/esm/react/components/ConsentBanner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ConsentBanner - Glassmorphic consent popup for GDPR compliance
+ * Follows Grain Design System specifications
+ */
+import * as React from 'react';
+export interface ConsentBannerProps {
+    position?: 'top' | 'bottom' | 'center';
+    theme?: 'light' | 'dark' | 'glass';
+    customText?: string;
+    onAccept?: () => void;
+    onDecline?: () => void;
+    showPreferences?: boolean;
+    privacyPolicyUrl?: string;
+}
+export declare function ConsentBanner({ position, theme, customText, onAccept, onDecline, showPreferences, privacyPolicyUrl, }: ConsentBannerProps): React.JSX.Element | null;
+//# sourceMappingURL=ConsentBanner.d.ts.map

package/dist/esm/react/components/ConsentBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsentBanner.d.ts","sourceRoot":"","sources":["../../../../src/react/components/ConsentBanner.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAmB,EACnB,KAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,eAAuB,EACvB,gBAAgB,GACjB,EAAE,kBAAkB,4BA8HpB"}

package/dist/esm/react/components/ConsentBanner.js

@@ -0,0 +1,76 @@
+/**
+ * ConsentBanner - Glassmorphic consent popup for GDPR compliance
+ * Follows Grain Design System specifications
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from '../hooks/useGrainAnalytics';
+export function ConsentBanner({ position = 'bottom', theme = 'glass', customText, onAccept, onDecline, showPreferences = false, privacyPolicyUrl, }) {
+    const client = useGrainAnalytics();
+    const [visible, setVisible] = React.useState(false);
+    const [showPreferencesModal, setShowPreferencesModal] = React.useState(false);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        // Check if user has already made a consent decision
+        const consentState = client.getConsentState();
+        if (!consentState) {
+            setVisible(true);
+        }
+    }, [client]);
+    const handleAccept = () => {
+        if (client) {
+            client.grantConsent(['necessary', 'analytics', 'functional']);
+        }
+        setVisible(false);
+        onAccept?.();
+    };
+    const handleDecline = () => {
+        if (client) {
+            client.revokeConsent();
+        }
+        setVisible(false);
+        onDecline?.();
+    };
+    const handleEscape = (e) => {
+        if (e.key === 'Escape') {
+            handleDecline();
+        }
+    };
+    if (!visible)
+        return null;
+    const defaultText = customText ||
+        "We use cookies and similar technologies to improve your experience. By accepting, you consent to our use of analytics and functional cookies.";
+    // Position styles
+    const positionStyles = {
+        top: 'top-4 left-4 right-4',
+        bottom: 'bottom-4 left-4 right-4',
+        center: 'top-1/2 left-1/2 -translate-x-1/2 -translate-y-1/2',
+    };
+    // Theme styles (glassmorphic by default)
+    const themeStyles = {
+        light: 'bg-white/95 border-gray-200 text-gray-900',
+        dark: 'bg-zinc-900/95 border-zinc-800 text-zinc-100',
+        glass: 'bg-zinc-950/40 backdrop-blur-xl border-zinc-800/40 text-zinc-100',
+    };
+    const buttonAcceptStyles = {
+        light: 'bg-blue-600 hover:bg-blue-700 text-white',
+        dark: 'bg-emerald-600 hover:bg-emerald-700 text-white',
+        glass: 'bg-emerald-600 hover:bg-emerald-700 text-white',
+    };
+    const buttonDeclineStyles = {
+        light: 'bg-gray-200 hover:bg-gray-300 text-gray-800',
+        dark: 'bg-zinc-800 hover:bg-zinc-700 text-zinc-200',
+        glass: 'bg-zinc-900/60 hover:bg-zinc-800/60 text-zinc-300 border border-zinc-800/60',
+    };
+    return (React.createElement("div", { className: `fixed z-50 max-w-2xl ${positionStyles[position]}`, onKeyDown: handleEscape, role: "dialog", "aria-labelledby": "consent-title", "aria-describedby": "consent-description" },
+        React.createElement("div", { className: `rounded-lg shadow-2xl border p-6 transition-all ${themeStyles[theme]}` },
+            React.createElement("h2", { id: "consent-title", className: "text-lg font-semibold mb-2" }, "Cookie Consent"),
+            React.createElement("p", { id: "consent-description", className: "text-sm opacity-80 mb-4" }, defaultText),
+            privacyPolicyUrl && (React.createElement("a", { href: privacyPolicyUrl, target: "_blank", rel: "noopener noreferrer", className: "text-sm underline opacity-70 hover:opacity-100 transition-opacity block mb-4" }, "Read our Privacy Policy")),
+            React.createElement("div", { className: "flex flex-wrap gap-2" },
+                React.createElement("button", { onClick: handleAccept, className: `px-4 py-2 rounded-lg font-medium transition-all ${buttonAcceptStyles[theme]}`, "aria-label": "Accept cookies" }, "Accept All"),
+                React.createElement("button", { onClick: handleDecline, className: `px-4 py-2 rounded-lg font-medium transition-all ${buttonDeclineStyles[theme]}`, "aria-label": "Decline cookies" }, "Decline"),
+                showPreferences && (React.createElement("button", { onClick: () => setShowPreferencesModal(true), className: `px-4 py-2 rounded-lg font-medium transition-all ${buttonDeclineStyles[theme]}`, "aria-label": "Manage preferences" }, "Manage Preferences")),
+                React.createElement("kbd", { className: "ml-auto px-2 py-1 bg-zinc-900/50 border border-zinc-800 rounded text-[10px] font-mono self-center" }, "ESC")))));
+}
+//# sourceMappingURL=ConsentBanner.js.map

package/dist/esm/react/components/ConsentBanner.js.map

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

package/dist/esm/react/components/CookieNotice.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CookieNotice - Simple cookie notification banner
+ */
+import * as React from 'react';
+export interface CookieNoticeProps {
+    message?: string;
+    privacyPolicyUrl?: string;
+    onDismiss?: () => void;
+    position?: 'top' | 'bottom';
+}
+export declare function CookieNotice({ message, privacyPolicyUrl, onDismiss, position, }: CookieNoticeProps): React.JSX.Element | null;
+//# sourceMappingURL=CookieNotice.d.ts.map

package/dist/esm/react/components/CookieNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieNotice.d.ts","sourceRoot":"","sources":["../../../../src/react/components/CookieNotice.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAmB,GACpB,EAAE,iBAAiB,4BA6CnB"}

package/dist/esm/react/components/CookieNotice.js

@@ -0,0 +1,26 @@
+/**
+ * CookieNotice - Simple cookie notification banner
+ */
+import * as React from 'react';
+export function CookieNotice({ message, privacyPolicyUrl, onDismiss, position = 'bottom', }) {
+    const [visible, setVisible] = React.useState(true);
+    const defaultMessage = message ||
+        "This website uses cookies to enhance your experience.";
+    const handleDismiss = () => {
+        setVisible(false);
+        onDismiss?.();
+    };
+    if (!visible)
+        return null;
+    const positionStyles = position === 'top' ? 'top-0' : 'bottom-0';
+    return (React.createElement("div", { className: `fixed ${positionStyles} left-0 right-0 z-40` },
+        React.createElement("div", { className: "bg-zinc-950/90 backdrop-blur-sm border-t border-zinc-800/40 px-4 py-3" },
+            React.createElement("div", { className: "max-w-7xl mx-auto flex items-center justify-between gap-4" },
+                React.createElement("p", { className: "text-sm text-zinc-300" },
+                    defaultMessage,
+                    privacyPolicyUrl && (React.createElement(React.Fragment, null,
+                        ' ',
+                        React.createElement("a", { href: privacyPolicyUrl, target: "_blank", rel: "noopener noreferrer", className: "underline opacity-70 hover:opacity-100 transition-opacity" }, "Learn more")))),
+                React.createElement("button", { onClick: handleDismiss, className: "px-3 py-1 bg-zinc-800/60 hover:bg-zinc-700/60 text-zinc-300 rounded text-sm font-medium transition-all flex-shrink-0" }, "Dismiss")))));
+}
+//# sourceMappingURL=CookieNotice.js.map

package/dist/esm/react/components/CookieNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieNotice.js","sourceRoot":"","sources":["../../../../src/react/components/CookieNotice.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,UAAU,YAAY,CAAC,EAC3B,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAQ,GAAG,QAAQ,GACD;IAClB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,cAAc,GAAG,OAAO;QAC5B,uDAAuD,CAAC;IAE1D,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,SAAS,EAAE,EAAE,CAAC;IAChB,CAAC,CAAC;IAEF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,cAAc,GAAG,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAEjE,OAAO,CACL,6BAAK,SAAS,EAAE,SAAS,cAAc,sBAAsB;QAC3D,6BAAK,SAAS,EAAC,uEAAuE;YACpF,6BAAK,SAAS,EAAC,2DAA2D;gBACxE,2BAAG,SAAS,EAAC,uBAAuB;oBACjC,cAAc;oBACd,gBAAgB,IAAI,CACnB;wBACG,GAAG;wBACJ,2BACE,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,EACzB,SAAS,EAAC,2DAA2D,iBAGnE,CACH,CACJ,CACC;gBACJ,gCACE,OAAO,EAAE,aAAa,EACtB,SAAS,EAAC,sHAAsH,cAGzH,CACL,CACF,CACF,CACP,CAAC;AACJ,CAAC"}

package/dist/esm/react/components/PrivacyPreferenceCenter.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PrivacyPreferenceCenter - Detailed preference management modal
+ * Follows Grain Design System specifications
+ */
+import * as React from 'react';
+export interface PrivacyPreferenceCenterProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSave?: (categories: string[]) => void;
+}
+export declare function PrivacyPreferenceCenter({ isOpen, onClose, onSave, }: PrivacyPreferenceCenterProps): React.JSX.Element | null;
+//# sourceMappingURL=PrivacyPreferenceCenter.d.ts.map

package/dist/esm/react/components/PrivacyPreferenceCenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrivacyPreferenceCenter.d.ts","sourceRoot":"","sources":["../../../../src/react/components/PrivacyPreferenceCenter.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACzC;AA8BD,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,OAAO,EACP,MAAM,GACP,EAAE,4BAA4B,4BAkH9B"}

package/dist/esm/react/components/PrivacyPreferenceCenter.js

@@ -0,0 +1,84 @@
+/**
+ * PrivacyPreferenceCenter - Detailed preference management modal
+ * Follows Grain Design System specifications
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from '../hooks/useGrainAnalytics';
+const CATEGORIES = [
+    {
+        id: 'necessary',
+        name: 'Necessary',
+        description: 'Essential for the website to function properly. Cannot be disabled.',
+        required: true,
+    },
+    {
+        id: 'analytics',
+        name: 'Analytics',
+        description: 'Help us understand how visitors interact with our website.',
+        required: false,
+    },
+    {
+        id: 'functional',
+        name: 'Functional',
+        description: 'Enable enhanced functionality and personalization.',
+        required: false,
+    },
+];
+export function PrivacyPreferenceCenter({ isOpen, onClose, onSave, }) {
+    const client = useGrainAnalytics();
+    const [selectedCategories, setSelectedCategories] = React.useState(['necessary']);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        const consentState = client.getConsentState();
+        if (consentState) {
+            setSelectedCategories(consentState.categories);
+        }
+    }, [client, isOpen]);
+    const handleToggle = (categoryId, required) => {
+        if (required)
+            return; // Cannot toggle required categories
+        setSelectedCategories((prev) => prev.includes(categoryId)
+            ? prev.filter((id) => id !== categoryId)
+            : [...prev, categoryId]);
+    };
+    const handleSave = () => {
+        if (client) {
+            if (selectedCategories.length > 0) {
+                client.grantConsent(selectedCategories);
+            }
+            else {
+                client.revokeConsent();
+            }
+        }
+        onSave?.(selectedCategories);
+        onClose();
+    };
+    const handleEscape = (e) => {
+        if (e.key === 'Escape') {
+            onClose();
+        }
+    };
+    if (!isOpen)
+        return null;
+    return (React.createElement("div", { className: "fixed inset-0 z-50 flex items-center justify-center", onKeyDown: handleEscape, role: "dialog", "aria-labelledby": "preferences-title", "aria-modal": "true" },
+        React.createElement("div", { className: "fixed inset-0 bg-zinc-950/80 backdrop-blur-sm", onClick: onClose }),
+        React.createElement("div", { className: "relative bg-zinc-950/95 border border-zinc-800/60 backdrop-blur-xl rounded-lg shadow-2xl max-w-2xl w-full mx-4 p-6" },
+            React.createElement("h2", { id: "preferences-title", className: "text-xl font-semibold text-zinc-100 mb-4" }, "Privacy Preferences"),
+            React.createElement("div", { className: "space-y-4 mb-6" }, CATEGORIES.map((category) => (React.createElement("div", { key: category.id, className: "p-4 bg-zinc-900/40 border border-zinc-800/40 rounded-lg" },
+                React.createElement("div", { className: "flex items-start justify-between" },
+                    React.createElement("div", { className: "flex-1" },
+                        React.createElement("h3", { className: "font-medium text-zinc-200 mb-1" },
+                            category.name,
+                            category.required && (React.createElement("span", { className: "ml-2 text-xs text-emerald-500" }, "(Required)"))),
+                        React.createElement("p", { className: "text-sm text-zinc-400" }, category.description)),
+                    React.createElement("label", { className: "relative inline-flex items-center cursor-pointer" },
+                        React.createElement("input", { type: "checkbox", checked: selectedCategories.includes(category.id), onChange: () => handleToggle(category.id, category.required), disabled: category.required, className: "sr-only peer" }),
+                        React.createElement("div", { className: "w-11 h-6 bg-zinc-700 peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-emerald-600" }))))))),
+            React.createElement("div", { className: "flex justify-end gap-2" },
+                React.createElement("button", { onClick: onClose, className: "px-4 py-2 bg-zinc-900/60 hover:bg-zinc-800/60 text-zinc-300 border border-zinc-800/60 rounded-lg font-medium transition-all" },
+                    "Cancel",
+                    React.createElement("kbd", { className: "ml-2 px-2 py-0.5 bg-zinc-900/50 border border-zinc-800 rounded text-[10px] font-mono" }, "ESC")),
+                React.createElement("button", { onClick: handleSave, className: "px-4 py-2 bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg font-medium transition-all" }, "Save Preferences")))));
+}
+//# sourceMappingURL=PrivacyPreferenceCenter.js.map

package/dist/esm/react/components/PrivacyPreferenceCenter.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * useConsent - Hook for managing user consent
+ */
+import type { ConsentState } from '../../consent';
+export declare function useConsent(): {
+    consentState: ConsentState | null;
+    grantConsent: (categories?: string[]) => void;
+    revokeConsent: (categories?: string[]) => void;
+    hasConsent: (category?: string) => boolean;
+    isGranted: boolean;
+    categories: string[];
+};
+//# sourceMappingURL=useConsent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useConsent.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,wBAAgB,UAAU;;gCAwBR,MAAM,EAAE;iCASR,MAAM,EAAE;4BASV,MAAM;;;EAerB"}

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

@@ -0,0 +1,48 @@
+/**
+ * useConsent - Hook for managing user consent
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from './useGrainAnalytics';
+export function useConsent() {
+    const client = 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/esm/react/hooks/useConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsent.js","sourceRoot":"","sources":["../../../../src/react/hooks/useConsent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,iBAAiB,EAAE,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/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":"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"}

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/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/esm/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/esm/react/index.js

@@ -34,4 +34,12 @@ 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

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