@grainql/analytics-web 1.7.4 → 2.1.0

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

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

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

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

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

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

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

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * usePrivacyPreferences - Hook for managing privacy preferences
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePrivacyPreferences = usePrivacyPreferences;
+const React = __importStar(require("react"));
+const useConsent_1 = require("./useConsent");
+function usePrivacyPreferences() {
+    const { consentState, grantConsent, revokeConsent } = (0, useConsent_1.useConsent)();
+    const preferences = React.useMemo(() => {
+        const categories = consentState?.categories ?? [];
+        return {
+            necessary: categories.includes('necessary'),
+            analytics: categories.includes('analytics'),
+            functional: categories.includes('functional'),
+        };
+    }, [consentState]);
+    const updatePreferences = React.useCallback((newPreferences) => {
+        const categories = [];
+        // Necessary is always enabled
+        categories.push('necessary');
+        if (newPreferences.analytics ?? preferences.analytics) {
+            categories.push('analytics');
+        }
+        if (newPreferences.functional ?? preferences.functional) {
+            categories.push('functional');
+        }
+        if (categories.length > 0) {
+            grantConsent(categories);
+        }
+        else {
+            revokeConsent();
+        }
+    }, [preferences, grantConsent, revokeConsent]);
+    const acceptAll = React.useCallback(() => {
+        grantConsent(['necessary', 'analytics', 'functional']);
+    }, [grantConsent]);
+    const rejectAll = React.useCallback(() => {
+        grantConsent(['necessary']); // Keep only necessary
+    }, [grantConsent]);
+    return {
+        preferences,
+        updatePreferences,
+        acceptAll,
+        rejectAll,
+    };
+}
+//# sourceMappingURL=usePrivacyPreferences.js.map

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

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

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

@@ -0,0 +1,53 @@
+"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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTrack = useTrack;
+const React = __importStar(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;
+}
+//# sourceMappingURL=useTrack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTrack.js","sourceRoot":"","sources":["../../../../src/react/hooks/useTrack.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMH,4BAYC;AAhBD,6CAA+B;AAC/B,2DAAwD;AAGxD,SAAgB,QAAQ;IACtB,MAAM,MAAM,GAAG,IAAA,qCAAiB,GAAE,CAAC;IAEnC,gEAAgE;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAC7B,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGzD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,YAAY,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cjs/react/index.js

@@ -0,0 +1,59 @@
+"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.CookieNotice = exports.PrivacyPreferenceCenter = exports.ConsentBanner = exports.useDataDeletion = exports.usePrivacyPreferences = exports.useConsent = exports.useTrack = exports.useAllConfigs = exports.useConfig = exports.useGrainAnalytics = exports.GrainProvider = void 0;
+// Provider
+var GrainProvider_1 = require("./GrainProvider");
+Object.defineProperty(exports, "GrainProvider", { enumerable: true, get: function () { return GrainProvider_1.GrainProvider; } });
+// 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; } });
+// Privacy hooks
+var useConsent_1 = require("./hooks/useConsent");
+Object.defineProperty(exports, "useConsent", { enumerable: true, get: function () { return useConsent_1.useConsent; } });
+var usePrivacyPreferences_1 = require("./hooks/usePrivacyPreferences");
+Object.defineProperty(exports, "usePrivacyPreferences", { enumerable: true, get: function () { return usePrivacyPreferences_1.usePrivacyPreferences; } });
+var useDataDeletion_1 = require("./hooks/useDataDeletion");
+Object.defineProperty(exports, "useDataDeletion", { enumerable: true, get: function () { return useDataDeletion_1.useDataDeletion; } });
+// Privacy components
+var ConsentBanner_1 = require("./components/ConsentBanner");
+Object.defineProperty(exports, "ConsentBanner", { enumerable: true, get: function () { return ConsentBanner_1.ConsentBanner; } });
+var PrivacyPreferenceCenter_1 = require("./components/PrivacyPreferenceCenter");
+Object.defineProperty(exports, "PrivacyPreferenceCenter", { enumerable: true, get: function () { return PrivacyPreferenceCenter_1.PrivacyPreferenceCenter; } });
+var CookieNotice_1 = require("./components/CookieNotice");
+Object.defineProperty(exports, "CookieNotice", { enumerable: true, get: function () { return CookieNotice_1.CookieNotice; } });
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

package/dist/cjs/react/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * React-specific types for Grain Analytics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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

package/dist/consent.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Consent management for Grain Analytics
+ * Handles GDPR-compliant consent tracking and state management
+ */
+export type ConsentMode = 'opt-in' | 'opt-out' | 'disabled';
+export interface ConsentState {
+    granted: boolean;
+    categories: string[];
+    timestamp: Date;
+    version: string;
+}
+export declare const DEFAULT_CONSENT_CATEGORIES: string[];
+export declare const CONSENT_VERSION = "1.0.0";
+/**
+ * Consent manager for handling user consent state
+ */
+export declare class ConsentManager {
+    private consentState;
+    private consentMode;
+    private storageKey;
+    private listeners;
+    constructor(tenantId: string, consentMode?: ConsentMode);
+    /**
+     * Load consent state from localStorage
+     */
+    private loadConsentState;
+    /**
+     * Save consent state to localStorage
+     */
+    private saveConsentState;
+    /**
+     * Grant consent with optional categories
+     */
+    grantConsent(categories?: string[]): void;
+    /**
+     * Revoke consent (opt-out)
+     */
+    revokeConsent(categories?: string[]): void;
+    /**
+     * Get current consent state
+     */
+    getConsentState(): ConsentState | null;
+    /**
+     * Check if user has granted consent
+     */
+    hasConsent(category?: string): boolean;
+    /**
+     * Check if we should wait for consent before tracking
+     */
+    shouldWaitForConsent(): boolean;
+    /**
+     * Add consent change listener
+     */
+    addListener(listener: (state: ConsentState) => void): void;
+    /**
+     * Remove consent change listener
+     */
+    removeListener(listener: (state: ConsentState) => void): void;
+    /**
+     * Notify all listeners of consent state change
+     */
+    private notifyListeners;
+    /**
+     * Clear all consent data
+     */
+    clearConsent(): void;
+}
+//# sourceMappingURL=consent.d.ts.map

package/dist/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../src/consent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,UAA2C,CAAC;AACnF,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAE,WAAuB;IAMlE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAczC;;OAEG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IA8B1C;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAwBtC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAI1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAO7D;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,YAAY,IAAI,IAAI;CAUrB"}

package/dist/cookies.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cookie utilities for Grain Analytics
+ * Provides GDPR-compliant cookie management with configurable options
+ */
+export interface CookieConfig {
+    domain?: string;
+    path?: string;
+    sameSite?: 'strict' | 'lax' | 'none';
+    secure?: boolean;
+    maxAge?: number;
+}
+/**
+ * Set a cookie with configurable options
+ */
+export declare function setCookie(name: string, value: string, config?: CookieConfig): void;
+/**
+ * Get a cookie value by name
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Delete a cookie by name
+ */
+export declare function deleteCookie(name: string, config?: Pick<CookieConfig, 'domain' | 'path'>): void;
+/**
+ * Check if cookies are available and working
+ */
+export declare function areCookiesEnabled(): boolean;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CA4BlF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,MAAM,CAAC,GAAG,IAAI,CAmB/F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/dist/esm/activity.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Activity Detection for Grain Analytics
+ * Tracks user activity (mouse, keyboard, touch, scroll) to determine if user is active
+ */
+export declare class ActivityDetector {
+    private lastActivityTime;
+    private activityThreshold;
+    private listeners;
+    private boundActivityHandler;
+    private isDestroyed;
+    private readonly activityEvents;
+    constructor();
+    /**
+     * Setup event listeners for activity detection
+     */
+    private setupListeners;
+    /**
+     * Handle activity event
+     */
+    private handleActivity;
+    /**
+     * Debounce function to limit how often activity handler is called
+     */
+    private debounce;
+    /**
+     * Check if user is currently active
+     * @param threshold Time in ms to consider user inactive (default: 30s)
+     */
+    isActive(threshold?: number): boolean;
+    /**
+     * Get time since last activity in milliseconds
+     */
+    getTimeSinceLastActivity(): number;
+    /**
+     * Get last activity timestamp
+     */
+    getLastActivityTime(): number;
+    /**
+     * Set activity threshold
+     */
+    setActivityThreshold(threshold: number): void;
+    /**
+     * Add listener for activity changes
+     */
+    addListener(listener: () => void): void;
+    /**
+     * Remove listener
+     */
+    removeListener(listener: () => void): void;
+    /**
+     * Notify all listeners
+     */
+    private notifyListeners;
+    /**
+     * Cleanup and remove listeners
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=activity.d.ts.map

package/dist/esm/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/activity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAOpB;;IAQX;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAMrC;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAIlC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAO1C;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAYhB"}

package/dist/esm/activity.js

@@ -0,0 +1,127 @@
+/**
+ * Activity Detection for Grain Analytics
+ * Tracks user activity (mouse, keyboard, touch, scroll) to determine if user is active
+ */
+export class ActivityDetector {
+    constructor() {
+        this.activityThreshold = 30000; // 30 seconds
+        this.listeners = [];
+        this.isDestroyed = false;
+        // Events that indicate user activity
+        this.activityEvents = [
+            'mousemove',
+            'mousedown',
+            'keydown',
+            'scroll',
+            'touchstart',
+            'click',
+        ];
+        this.lastActivityTime = Date.now();
+        this.boundActivityHandler = this.debounce(this.handleActivity.bind(this), 500);
+        this.setupListeners();
+    }
+    /**
+     * Setup event listeners for activity detection
+     */
+    setupListeners() {
+        if (typeof window === 'undefined')
+            return;
+        for (const event of this.activityEvents) {
+            window.addEventListener(event, this.boundActivityHandler, { passive: true });
+        }
+    }
+    /**
+     * Handle activity event
+     */
+    handleActivity() {
+        if (this.isDestroyed)
+            return;
+        this.lastActivityTime = Date.now();
+        this.notifyListeners();
+    }
+    /**
+     * Debounce function to limit how often activity handler is called
+     */
+    debounce(func, wait) {
+        let timeout = null;
+        return () => {
+            if (timeout !== null) {
+                clearTimeout(timeout);
+            }
+            timeout = window.setTimeout(() => {
+                func();
+                timeout = null;
+            }, wait);
+        };
+    }
+    /**
+     * Check if user is currently active
+     * @param threshold Time in ms to consider user inactive (default: 30s)
+     */
+    isActive(threshold) {
+        const thresholdToUse = threshold ?? this.activityThreshold;
+        const now = Date.now();
+        return (now - this.lastActivityTime) < thresholdToUse;
+    }
+    /**
+     * Get time since last activity in milliseconds
+     */
+    getTimeSinceLastActivity() {
+        return Date.now() - this.lastActivityTime;
+    }
+    /**
+     * Get last activity timestamp
+     */
+    getLastActivityTime() {
+        return this.lastActivityTime;
+    }
+    /**
+     * Set activity threshold
+     */
+    setActivityThreshold(threshold) {
+        this.activityThreshold = threshold;
+    }
+    /**
+     * Add listener for activity changes
+     */
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * Remove listener
+     */
+    removeListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index > -1) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * Notify all listeners
+     */
+    notifyListeners() {
+        for (const listener of this.listeners) {
+            try {
+                listener();
+            }
+            catch (error) {
+                console.error('[Activity Detector] Listener error:', error);
+            }
+        }
+    }
+    /**
+     * Cleanup and remove listeners
+     */
+    destroy() {
+        if (this.isDestroyed)
+            return;
+        if (typeof window !== 'undefined') {
+            for (const event of this.activityEvents) {
+                window.removeEventListener(event, this.boundActivityHandler);
+            }
+        }
+        this.listeners = [];
+        this.isDestroyed = true;
+    }
+}
+//# sourceMappingURL=activity.js.map

package/dist/esm/activity.js.map

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