@grainql/analytics-web 2.8.0 → 3.0.0

package/dist/react/hooks/useConsent.js

@@ -1,9 +1,13 @@
 "use strict";
 /**
- * useConsent - Hook for managing user consent
+ * useConsent - Hook for managing user consent (v2.0)
+ * Updated for new consent modes: cookieless, gdpr-strict, gdpr-opt-out
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useConsent = useConsent;
+exports.useConsentMode = useConsentMode;
+exports.useTrackingId = useTrackingId;
+exports.useCanTrack = useCanTrack;
 const React = require("react");
 const useGrainAnalytics_1 = require("./useGrainAnalytics");
 function useConsent() {
@@ -48,3 +52,50 @@ function useConsent() {
         categories: consentState?.categories ?? [],
     };
 }
+/**
+ * useConsentMode - Hook to get current consent mode
+ * v2.0: Returns 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out'
+ */
+function useConsentMode() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    const [mode, setMode] = React.useState(null);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        // Access internal consent manager via client methods
+        // This is a simplified version - mode doesn't change at runtime
+        const config = client.config;
+        setMode(config?.consentMode ?? 'cookieless');
+    }, [client]);
+    return mode;
+}
+/**
+ * useTrackingId - Hook to get current tracking ID
+ * v2.0: Returns daily rotating ID or permanent ID based on consent
+ */
+function useTrackingId() {
+    const client = (0, useGrainAnalytics_1.useGrainAnalytics)();
+    const [trackingId, setTrackingId] = React.useState(null);
+    const { consentState } = useConsent();
+    React.useEffect(() => {
+        if (!client)
+            return;
+        try {
+            const id = client.getEffectiveUserId();
+            setTrackingId(id);
+        }
+        catch (error) {
+            console.warn('Failed to get tracking ID:', error);
+        }
+    }, [client, consentState]); // Re-fetch when consent changes
+    return trackingId;
+}
+/**
+ * useCanTrack - Hook to check if tracking is allowed
+ * v2.0: Always returns true (even cookieless mode allows basic tracking)
+ */
+function useCanTrack() {
+    const mode = useConsentMode();
+    // All modes allow some form of tracking in v2.0
+    return mode !== null;
+}

package/dist/react/hooks/useConsent.mjs

@@ -1,5 +1,6 @@
 /**
- * useConsent - Hook for managing user consent
+ * useConsent - Hook for managing user consent (v2.0)
+ * Updated for new consent modes: cookieless, gdpr-strict, gdpr-opt-out
  */
 import * as React from 'react';
 import { useGrainAnalytics } from './useGrainAnalytics';
@@ -45,3 +46,50 @@ export function useConsent() {
         categories: consentState?.categories ?? [],
     };
 }
+/**
+ * useConsentMode - Hook to get current consent mode
+ * v2.0: Returns 'cookieless' | 'gdpr-strict' | 'gdpr-opt-out'
+ */
+export function useConsentMode() {
+    const client = useGrainAnalytics();
+    const [mode, setMode] = React.useState(null);
+    React.useEffect(() => {
+        if (!client)
+            return;
+        // Access internal consent manager via client methods
+        // This is a simplified version - mode doesn't change at runtime
+        const config = client.config;
+        setMode(config?.consentMode ?? 'cookieless');
+    }, [client]);
+    return mode;
+}
+/**
+ * useTrackingId - Hook to get current tracking ID
+ * v2.0: Returns daily rotating ID or permanent ID based on consent
+ */
+export function useTrackingId() {
+    const client = useGrainAnalytics();
+    const [trackingId, setTrackingId] = React.useState(null);
+    const { consentState } = useConsent();
+    React.useEffect(() => {
+        if (!client)
+            return;
+        try {
+            const id = client.getEffectiveUserId();
+            setTrackingId(id);
+        }
+        catch (error) {
+            console.warn('Failed to get tracking ID:', error);
+        }
+    }, [client, consentState]); // Re-fetch when consent changes
+    return trackingId;
+}
+/**
+ * useCanTrack - Hook to check if tracking is allowed
+ * v2.0: Always returns true (even cookieless mode allows basic tracking)
+ */
+export function useCanTrack() {
+    const mode = useConsentMode();
+    // All modes allow some form of tracking in v2.0
+    return mode !== null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainql/analytics-web",
-  "version": "2.8.0",
+  "version": "3.0.0",
   "description": "Lightweight TypeScript SDK for sending analytics events and managing remote configurations via Grain's REST API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",