@grainql/analytics-web 1.7.4 → 2.0.0

package/dist/react/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/react/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/react/react/GrainProvider.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrainProvider = GrainProvider;
+const React = require("react");
+const index_1 = require("../index");
+const context_1 = require("./context");
+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 index_1.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(context_1.GrainContext.Provider, { value: { client: activeClient, isProviderManaged } }, children));
+}

package/dist/react/react/GrainProvider.mjs

@@ -0,0 +1,42 @@
+/**
+ * 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));
+}

package/dist/react/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>;
+//# sourceMappingURL=context.d.ts.map

package/dist/react/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,kCAAsD,CAAC"}

package/dist/react/react/context.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * React context for Grain Analytics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrainContext = void 0;
+const React = require("react");
+exports.GrainContext = React.createContext(null);
+exports.GrainContext.displayName = 'GrainContext';

package/dist/react/react/context.mjs

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

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

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * useAllConfigs - Get all configurations with automatic updates
+ *
+ * Returns all configs as a reactive object with cache-first strategy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAllConfigs = useAllConfigs;
+const React = require("react");
+const useGrainAnalytics_1 = require("./useGrainAnalytics");
+function useAllConfigs(options = {}) {
+    const client = (0, useGrainAnalytics_1.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,
+    };
+}

package/dist/react/react/hooks/useAllConfigs.mjs

@@ -0,0 +1,75 @@
+/**
+ * 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,
+    };
+}

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

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useConfig = useConfig;
+const React = require("react");
+const useGrainAnalytics_1 = require("./useGrainAnalytics");
+function useConfig(key, options = {}) {
+    const client = (0, useGrainAnalytics_1.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,
+    };
+}

package/dist/react/react/hooks/useConfig.mjs

@@ -0,0 +1,79 @@
+/**
+ * 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,
+    };
+}

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

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

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

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

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

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * useGrainAnalytics - Access the GrainAnalytics client from context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGrainAnalytics = useGrainAnalytics;
+const React = require("react");
+const context_1 = require("../context");
+function useGrainAnalytics() {
+    const context = React.useContext(context_1.GrainContext);
+    if (!context) {
+        throw new Error('useGrainAnalytics must be used within a GrainProvider. ' +
+            'Wrap your component tree with <GrainProvider client={client}> or <GrainProvider config={{...}}>');
+    }
+    return context.client;
+}

package/dist/react/react/hooks/useGrainAnalytics.mjs

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

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

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

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

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

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

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * useTrack - Get a stable, memoized track function
+ *
+ * Returns a track function that doesn't cause re-renders when passed to child components.
+ * Prevents unnecessary re-renders compared to using useCallback.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTrack = useTrack;
+const React = require("react");
+const useGrainAnalytics_1 = require("./useGrainAnalytics");
+function useTrack() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    // Create stable track function that won't change across renders
+    const track = React.useCallback(async (eventName, properties, options) => {
+        await client.track(eventName, properties, options);
+    }, [client]);
+    return track;
+}

package/dist/react/react/hooks/useTrack.mjs

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/react/react/index.js

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