@grainql/analytics-web 1.7.4 → 2.1.0

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

@@ -0,0 +1,11 @@
+/**
+ * GrainProvider - Context provider for Grain Analytics
+ *
+ * Supports two patterns:
+ * 1. Provider-managed: Pass `config` prop, provider creates and manages client lifecycle
+ * 2. External client: Pass `client` prop, user manages lifecycle
+ */
+import * as React from 'react';
+import type { GrainProviderProps } from './types';
+export declare function GrainProvider({ children, client, config }: GrainProviderProps): React.JSX.Element;
+//# sourceMappingURL=GrainProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrainProvider.d.ts","sourceRoot":"","sources":["../../../src/react/GrainProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,qBA8C7E"}

package/dist/esm/react/GrainProvider.js

@@ -0,0 +1,43 @@
+/**
+ * GrainProvider - Context provider for Grain Analytics
+ *
+ * Supports two patterns:
+ * 1. Provider-managed: Pass `config` prop, provider creates and manages client lifecycle
+ * 2. External client: Pass `client` prop, user manages lifecycle
+ */
+import * as React from 'react';
+import { GrainAnalytics } from '../index';
+import { GrainContext } from './context';
+export function GrainProvider({ children, client, config }) {
+    // Validate props
+    if (client && config) {
+        throw new Error('GrainProvider: Cannot provide both "client" and "config" props. ' +
+            'Use "client" for external management or "config" for provider-managed client.');
+    }
+    if (!client && !config) {
+        throw new Error('GrainProvider: Must provide either "client" or "config" prop. ' +
+            'Use "client" to pass an existing GrainAnalytics instance, or "config" to create one automatically.');
+    }
+    const isProviderManaged = Boolean(config);
+    const clientRef = React.useRef(null);
+    // Initialize client if config is provided
+    if (isProviderManaged && !clientRef.current && config) {
+        clientRef.current = new GrainAnalytics(config);
+    }
+    // Use external client if provided
+    const activeClient = client || clientRef.current;
+    if (!activeClient) {
+        throw new Error('GrainProvider: Failed to initialize client');
+    }
+    // Cleanup on unmount (only for provider-managed clients)
+    React.useEffect(() => {
+        return () => {
+            if (isProviderManaged && clientRef.current) {
+                clientRef.current.destroy();
+                clientRef.current = null;
+            }
+        };
+    }, [isProviderManaged]);
+    return (React.createElement(GrainContext.Provider, { value: { client: activeClient, isProviderManaged } }, children));
+}
+//# sourceMappingURL=GrainProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GrainProvider.js","sourceRoot":"","sources":["../../../src/react/GrainProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAsB;IAC5E,iBAAiB;IACjB,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kEAAkE;YAClE,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gEAAgE;YAChE,oGAAoG,CACrG,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAwB,IAAI,CAAC,CAAC;IAE5D,0CAA0C;IAC1C,IAAI,iBAAiB,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;QACtD,SAAS,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,kCAAkC;IAClC,MAAM,YAAY,GAAG,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC;IAEjD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,OAAO,GAAG,EAAE;YACV,IAAI,iBAAiB,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBAC3C,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC5B,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExB,OAAO,CACL,oBAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,IACtE,QAAQ,CACa,CACzB,CAAC;AACJ,CAAC"}

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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAe/D,MAAM,UAAU,GAAyB;IACvC;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qEAAqE;QAClF,QAAQ,EAAE,IAAI;KACf;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,EACtC,MAAM,EACN,OAAO,EACP,MAAM,GACuB;IAC7B,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5F,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAC9C,IAAI,YAAY,EAAE,CAAC;YACjB,qBAAqB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAE,QAAiB,EAAE,EAAE;QAC7D,IAAI,QAAQ;YAAE,OAAO,CAAC,oCAAoC;QAE1D,qBAAqB,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACvB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,UAAU,CAAC;YACxC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAC1B,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;QACD,MAAM,EAAE,CAAC,kBAAkB,CAAC,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,CAAsB,EAAE,EAAE;QAC9C,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,OAAO,CACL,6BACE,SAAS,EAAC,qDAAqD,EAC/D,SAAS,EAAE,YAAY,EACvB,IAAI,EAAC,QAAQ,qBACG,mBAAmB,gBACxB,MAAM;QAGjB,6BACE,SAAS,EAAC,+CAA+C,EACzD,OAAO,EAAE,OAAO,GAChB;QAGF,6BAAK,SAAS,EAAC,oHAAoH;YACjI,4BAAI,EAAE,EAAC,mBAAmB,EAAC,SAAS,EAAC,0CAA0C,0BAE1E;YAEL,6BAAK,SAAS,EAAC,gBAAgB,IAC5B,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAC5B,6BACE,GAAG,EAAE,QAAQ,CAAC,EAAE,EAChB,SAAS,EAAC,yDAAyD;gBAEnE,6BAAK,SAAS,EAAC,kCAAkC;oBAC/C,6BAAK,SAAS,EAAC,QAAQ;wBACrB,4BAAI,SAAS,EAAC,gCAAgC;4BAC3C,QAAQ,CAAC,IAAI;4BACb,QAAQ,CAAC,QAAQ,IAAI,CACpB,8BAAM,SAAS,EAAC,+BAA+B,iBAAkB,CAClE,CACE;wBACL,2BAAG,SAAS,EAAC,uBAAuB,IAAE,QAAQ,CAAC,WAAW,CAAK,CAC3D;oBACN,+BAAO,SAAS,EAAC,kDAAkD;wBACjE,+BACE,IAAI,EAAC,UAAU,EACf,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EACjD,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,SAAS,EAAC,cAAc,GACxB;wBACF,6BAAK,SAAS,EAAC,8SAA8S,GAAO,CAC9T,CACJ,CACF,CACP,CAAC,CACE;YAEN,6BAAK,SAAS,EAAC,wBAAwB;gBACrC,gCACE,OAAO,EAAE,OAAO,EAChB,SAAS,EAAC,6HAA6H;;oBAGvI,6BAAK,SAAS,EAAC,sFAAsF,UAE/F,CACC;gBACT,gCACE,OAAO,EAAE,UAAU,EACnB,SAAS,EAAC,gGAAgG,uBAGnG,CACL,CACF,CACF,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * React context for Grain Analytics
+ */
+import * as React from 'react';
+import type { GrainAnalytics } from '../index';
+export interface GrainContextValue {
+    client: GrainAnalytics;
+    isProviderManaged: boolean;
+}
+export declare const GrainContext: React.Context<GrainContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,YAAY,yCAAsD,CAAC"}

package/dist/esm/react/context.js

@@ -0,0 +1,7 @@
+/**
+ * React context for Grain Analytics
+ */
+import * as React from 'react';
+export const GrainContext = React.createContext(null);
+GrainContext.displayName = 'GrainContext';
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/react/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAA2B,IAAI,CAAC,CAAC;AAEhF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * useAllConfigs - Get all configurations with automatic updates
+ *
+ * Returns all configs as a reactive object with cache-first strategy.
+ */
+import type { UseAllConfigsOptions, UseAllConfigsResult } from '../types';
+export declare function useAllConfigs(options?: UseAllConfigsOptions): UseAllConfigsResult;
+//# sourceMappingURL=useAllConfigs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAllConfigs.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useAllConfigs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE1E,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA4ErF"}

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

@@ -0,0 +1,76 @@
+/**
+ * useAllConfigs - Get all configurations with automatic updates
+ *
+ * Returns all configs as a reactive object with cache-first strategy.
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from './useGrainAnalytics';
+export function useAllConfigs(options = {}) {
+    const client = useGrainAnalytics();
+    // Get initial configs from cache/defaults (synchronous, instant)
+    const [configs, setConfigs] = React.useState(() => client.getAllConfigs());
+    const [isRefreshing, setIsRefreshing] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const isMountedRef = React.useRef(true);
+    // Fetch fresh configs from API
+    const fetchConfigs = React.useCallback(async () => {
+        if (!isMountedRef.current)
+            return;
+        setIsRefreshing(true);
+        setError(null);
+        try {
+            const response = await client.fetchConfig({
+                immediateKeys: options.immediateKeys || [],
+                properties: options.properties,
+                forceRefresh: options.forceRefresh,
+            });
+            if (isMountedRef.current && response) {
+                setConfigs(response.configurations);
+            }
+        }
+        catch (err) {
+            if (isMountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        finally {
+            if (isMountedRef.current) {
+                setIsRefreshing(false);
+            }
+        }
+    }, [client, options.immediateKeys, options.properties, options.forceRefresh]);
+    // Manual refresh function
+    const refresh = React.useCallback(async () => {
+        await fetchConfigs();
+    }, [fetchConfigs]);
+    // Background fetch on mount and when options change
+    React.useEffect(() => {
+        fetchConfigs();
+    }, [fetchConfigs]);
+    // Subscribe to config changes
+    React.useEffect(() => {
+        const listener = (configurations) => {
+            if (isMountedRef.current) {
+                setConfigs(configurations);
+            }
+        };
+        client.addConfigChangeListener(listener);
+        return () => {
+            client.removeConfigChangeListener(listener);
+        };
+    }, [client]);
+    // Track mount state
+    React.useEffect(() => {
+        isMountedRef.current = true;
+        return () => {
+            isMountedRef.current = false;
+        };
+    }, []);
+    return {
+        configs,
+        isRefreshing,
+        error,
+        refresh,
+    };
+}
+//# sourceMappingURL=useAllConfigs.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * useConfig - Cache-first config access with automatic background refresh
+ *
+ * Returns cached/default value immediately, fetches fresh data in background,
+ * and automatically updates when configuration changes.
+ */
+import type { UseConfigOptions, UseConfigResult } from '../types';
+export declare function useConfig(key: string, options?: UseConfigOptions): UseConfigResult;
+//# sourceMappingURL=useConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useConfig.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks/useConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAElE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CA+EtF"}

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

@@ -0,0 +1,80 @@
+/**
+ * useConfig - Cache-first config access with automatic background refresh
+ *
+ * Returns cached/default value immediately, fetches fresh data in background,
+ * and automatically updates when configuration changes.
+ */
+import * as React from 'react';
+import { useGrainAnalytics } from './useGrainAnalytics';
+export function useConfig(key, options = {}) {
+    const client = useGrainAnalytics();
+    // Get initial value from cache/defaults (synchronous, instant)
+    const [value, setValue] = React.useState(() => client.getConfig(key));
+    const [isRefreshing, setIsRefreshing] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const isMountedRef = React.useRef(true);
+    // Fetch fresh config from API
+    const fetchConfig = React.useCallback(async () => {
+        if (!isMountedRef.current)
+            return;
+        setIsRefreshing(true);
+        setError(null);
+        try {
+            const response = await client.fetchConfig({
+                immediateKeys: options.immediateKeys || [key],
+                properties: options.properties,
+                forceRefresh: options.forceRefresh,
+            });
+            if (isMountedRef.current && response) {
+                const newValue = response.configurations[key];
+                if (newValue !== undefined) {
+                    setValue(newValue);
+                }
+            }
+        }
+        catch (err) {
+            if (isMountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        finally {
+            if (isMountedRef.current) {
+                setIsRefreshing(false);
+            }
+        }
+    }, [client, key, options.immediateKeys, options.properties, options.forceRefresh]);
+    // Manual refresh function
+    const refresh = React.useCallback(async () => {
+        await fetchConfig();
+    }, [fetchConfig]);
+    // Background fetch on mount and when key/options change
+    React.useEffect(() => {
+        fetchConfig();
+    }, [fetchConfig]);
+    // Subscribe to config changes
+    React.useEffect(() => {
+        const listener = (configurations) => {
+            if (isMountedRef.current && configurations[key] !== undefined) {
+                setValue(configurations[key]);
+            }
+        };
+        client.addConfigChangeListener(listener);
+        return () => {
+            client.removeConfigChangeListener(listener);
+        };
+    }, [client, key]);
+    // Track mount state
+    React.useEffect(() => {
+        isMountedRef.current = true;
+        return () => {
+            isMountedRef.current = false;
+        };
+    }, []);
+    return {
+        value,
+        isRefreshing,
+        error,
+        refresh,
+    };
+}
+//# sourceMappingURL=useConfig.js.map

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

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