@tracetail/react 2.3.3 → 2.3.5

package/README.md

@@ -2,7 +2,7 @@
 
 > React hooks for TraceTail enterprise browser fingerprinting with **over 99.5% accuracy**. Built for React 18 with full TypeScript support.
 
-[![npm version](https://badge.fury.io/js/@tracetail/react.svg)](https://www.npmjs.com/package/@tracetail/react)
+[![npm version](https://img.shields.io/npm/v/@tracetail/react.svg)](https://www.npmjs.com/package/@tracetail/react)
 [![Downloads](https://img.shields.io/npm/dm/@tracetail/react)](https://www.npmjs.com/package/@tracetail/react)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-18%2B-blue.svg)](https://reactjs.org/)
@@ -76,49 +76,6 @@ function MyComponent() {
 }
 ```
 
-### `useEnhancedTraceTail`
-
-Enhanced fingerprinting with fraud detection capabilities.
-
-```tsx
-import { useEnhancedTraceTail } from '@tracetail/react';
-
-function SecurityComponent() {
-  const { fingerprint, loading, error } = useEnhancedTraceTail({
-    apiKey: 'your-api-key',
-    immediate: true
-  });
-
-  if (loading) return <div>Analyzing security...</div>;
-  if (error) return <div>Error: {error.message}</div>;
-
-  return (
-    <div>
-      <div className={`alert ${fingerprint?.threatLevel}`}>
-        <h3>Security Analysis</h3>
-        <p>Risk Level: {fingerprint?.threatLevel}</p>
-        <p>Risk Score: {(fingerprint?.riskScore * 100).toFixed(1)}%</p>
-        <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>
-        
-        {fingerprint?.fraudSignals.length > 0 && (
-          <div>
-            <h4>Fraud Signals:</h4>
-            <ul>
-              {fingerprint.fraudSignals.map((signal, i) => (
-                <li key={i}>{signal}</li>
-              ))}
-            </ul>
-          </div>
-        )}
-        
-        {fingerprint?.geolocation && (
-          <p>Location: {fingerprint.geolocation.city}, {fingerprint.geolocation.country}</p>
-        )}
-      </div>
-    </div>
-  );
-}
-```
 
 ### `useVisitorId`
 
@@ -155,51 +112,6 @@ function UserTrackingComponent() {
 }
 ```
 
-### `useFraudDetection`
-
-Specialized hook for fraud detection with configurable thresholds.
-
-```tsx
-import { useFraudDetection } from '@tracetail/react';
-
-function FraudCheck() {
-  const { 
-    isFraudulent, 
-    riskLevel, 
-    riskScore, 
-    botProbability,
-    fraudSignals,
-    loading, 
-    recheck 
-  } = useFraudDetection({
-    apiKey: 'your-api-key',
-    riskThreshold: 0.7,  // Fraud threshold (0-1)
-    botThreshold: 0.5    // Bot detection threshold (0-1)
-  });
-
-  if (loading) return <div>🔍 Checking for fraud...</div>;
-
-  if (isFraudulent) {
-    return (
-      <div className="fraud-alert">
-        <h3>⚠️ High Risk Detected</h3>
-        <p>Additional verification required</p>
-        <p>Risk Score: {(riskScore * 100).toFixed(1)}%</p>
-        <p>Bot Probability: {(botProbability * 100).toFixed(1)}%</p>
-        <button onClick={recheck}>Recheck</button>
-      </div>
-    );
-  }
-
-  return (
-    <div className="fraud-clear">
-      <h3>✅ Security Check Passed</h3>
-      <p>Risk Level: {riskLevel}</p>
-      <p>Score: {(riskScore * 100).toFixed(1)}%</p>
-    </div>
-  );
-}
-```
 
 ## 🌟 Advanced Usage
 
@@ -237,37 +149,34 @@ function SSRSafeComponent() {
 ### Custom Hook Pattern
 
 ```tsx
-import { useEnhancedTraceTail } from '@tracetail/react';
+import { useTraceTail } from '@tracetail/react';
 
-function useSecurityCheck() {
-  const { fingerprint, loading, error } = useEnhancedTraceTail({
+function useVisitorTracking() {
+  const { fingerprint, loading, error } = useTraceTail({
     apiKey: process.env.REACT_APP_TRACETAIL_KEY!,
     immediate: true
   });
 
-  const securityStatus = fingerprint ? {
-    isSecure: fingerprint.riskScore < 0.3,
-    needsVerification: fingerprint.riskScore > 0.7,
-    isBot: fingerprint.botProbability > 0.5,
-    level: fingerprint.threatLevel
+  const trackingData = fingerprint ? {
+    visitorId: fingerprint.visitorId,
+    confidence: fingerprint.confidence,
+    isHighConfidence: fingerprint.confidence > 0.95,
+    processingTime: fingerprint.processingTime
   } : null;
 
-  return { securityStatus, loading, error };
+  return { trackingData, loading, error };
 }
 
 // Usage
 function App() {
-  const { securityStatus, loading } = useSecurityCheck();
+  const { trackingData, loading } = useVisitorTracking();
   
-  if (loading) return <div>Security check...</div>;
+  if (loading) return <div>Identifying visitor...</div>;
   
   return (
     <div>
-      {securityStatus?.needsVerification ? (
-        <AdditionalVerification />
-      ) : (
-        <MainContent />
-      )}
+      <p>Visitor: {trackingData?.visitorId}</p>
+      <p>Confidence: {(trackingData?.confidence * 100).toFixed(1)}%</p>
     </div>
   );
 }

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 /**
  * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting
- * Version: 2.3.3
+ * Version: 2.3.4
  *
- * Over 99.5% accuracy browser fingerprinting with React hooks.
+ * Over 99.5% accuracy browser fingerprinting with React hooks and server-side processing.
  * Perfect for fraud detection, user analytics, and security applications.
  */
 import type { FC, ReactNode } from 'react';
-import { FingerprintOptions, FingerprintResult, EnhancedFingerprintResult } from '@tracetail/js';
+import { FingerprintOptions, FingerprintResult } from '@tracetail/js';
 export interface UseTraceTailOptions extends FingerprintOptions {
     immediate?: boolean;
     suspense?: boolean;
@@ -18,13 +18,6 @@ export interface UseTraceTailReturn {
     generate: () => Promise<FingerprintResult>;
     regenerate: () => Promise<FingerprintResult>;
 }
-export interface UseEnhancedTraceTailReturn {
-    fingerprint: EnhancedFingerprintResult | null;
-    loading: boolean;
-    error: Error | null;
-    generate: () => Promise<EnhancedFingerprintResult>;
-    regenerate: () => Promise<EnhancedFingerprintResult>;
-}
 /**
  * React hook for basic browser fingerprinting
  *
@@ -46,33 +39,6 @@ export interface UseEnhancedTraceTailReturn {
  * ```
  */
 export declare function useTraceTail(options: UseTraceTailOptions): UseTraceTailReturn;
-/**
- * React hook for enhanced browser fingerprinting with fraud detection
- *
- * @example
- * ```typescript
- * import { useEnhancedTraceTail } from '@tracetail/react';
- *
- * function SecurityComponent() {
- *   const { fingerprint, loading, error } = useEnhancedTraceTail({
- *     apiKey: 'your-api-key',
- *     immediate: true
- *   });
- *
- *   if (loading) return <div>Analyzing security...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *
- *   const riskLevel = fingerprint?.threatLevel || 'unknown';
- *   return (
- *     <div>
- *       <p>Risk Level: {riskLevel}</p>
- *       <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useEnhancedTraceTail(options: UseTraceTailOptions): UseEnhancedTraceTailReturn;
 /**
  * React hook for visitor identification with persistent storage
  *
@@ -104,42 +70,7 @@ export declare function useVisitorId(options: UseTraceTailOptions & {
     error: Error | null;
     refresh: () => Promise<void>;
 };
-/**
- * React hook for fraud detection with configurable thresholds
- *
- * @example
- * ```typescript
- * import { useFraudDetection } from '@tracetail/react';
- *
- * function SecurityCheck() {
- *   const { isFraudulent, riskLevel, loading } = useFraudDetection({
- *     apiKey: 'your-api-key',
- *     riskThreshold: 0.7,
- *     botThreshold: 0.5
- *   });
- *
- *   if (isFraudulent) {
- *     return <div>⚠️ High risk detected - additional verification required</div>;
- *   }
- *
- *   return <div>✅ Security check passed (Risk: {riskLevel})</div>;
- * }
- * ```
- */
-export declare function useFraudDetection(options: UseTraceTailOptions & {
-    riskThreshold?: number;
-    botThreshold?: number;
-}): {
-    isFraudulent: boolean;
-    riskLevel: 'low' | 'medium' | 'high' | null;
-    riskScore: number;
-    botProbability: number;
-    fraudSignals: string[];
-    loading: boolean;
-    error: Error | null;
-    recheck: () => Promise<void>;
-};
-export type { FingerprintOptions, FingerprintResult, EnhancedFingerprintResult, ComponentData } from '@tracetail/js';
+export type { FingerprintOptions, FingerprintResult, ComponentData } from '@tracetail/js';
 export { TraceTail } from '@tracetail/js';
 interface TraceTailProviderProps {
     children: ReactNode;
@@ -153,9 +84,7 @@ export declare const TraceTailProvider: FC<TraceTailProviderProps>;
 export declare const getVersion: () => string;
 declare const _default: {
     useTraceTail: typeof useTraceTail;
-    useEnhancedTraceTail: typeof useEnhancedTraceTail;
     useVisitorId: typeof useVisitorId;
-    useFraudDetection: typeof useFraudDetection;
     TraceTailProvider: FC<TraceTailProviderProps>;
     getVersion: () => string;
 };

package/dist/index.esm.js

@@ -42,87 +42,7 @@ function useTraceTail(options) {
         setError(null);
         try {
             const result = await traceTailRef.current.generateFingerprint({
-                includeComponents: true
-            });
-            setFingerprint(result);
-            return result;
-        }
-        catch (err) {
-            const error = err instanceof Error ? err : new Error('Unknown error');
-            setError(error);
-            throw error;
-        }
-        finally {
-            setLoading(false);
-        }
-    }, []);
-    const regenerate = useCallback(async () => {
-        setFingerprint(null);
-        return generate();
-    }, [generate]);
-    // Auto-generate on mount if immediate is true
-    useEffect(() => {
-        if (options.immediate && !fingerprint && !loading) {
-            generate().catch(() => {
-                // Error is already handled in generate function
-            });
-        }
-    }, [options.immediate, fingerprint, loading, generate]);
-    return {
-        fingerprint,
-        loading,
-        error,
-        generate,
-        regenerate
-    };
-}
-/**
- * React hook for enhanced browser fingerprinting with fraud detection
- *
- * @example
- * ```typescript
- * import { useEnhancedTraceTail } from '@tracetail/react';
- *
- * function SecurityComponent() {
- *   const { fingerprint, loading, error } = useEnhancedTraceTail({
- *     apiKey: 'your-api-key',
- *     immediate: true
- *   });
- *
- *   if (loading) return <div>Analyzing security...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *
- *   const riskLevel = fingerprint?.threatLevel || 'unknown';
- *   return (
- *     <div>
- *       <p>Risk Level: {riskLevel}</p>
- *       <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>
- *     </div>
- *   );
- * }
- * ```
- */
-function useEnhancedTraceTail(options) {
-    const [fingerprint, setFingerprint] = useState(null);
-    const [loading, setLoading] = useState(false);
-    const [error, setError] = useState(null);
-    const traceTailRef = useRef(null);
-    // Initialize TraceTail instance
-    useEffect(() => {
-        if (!traceTailRef.current) {
-            traceTailRef.current = new TraceTail(options);
-        }
-    }, [options.apiKey, options.endpoint]);
-    const generate = useCallback(async () => {
-        if (!traceTailRef.current) {
-            throw new Error('TraceTail not initialized');
-        }
-        setLoading(true);
-        setError(null);
-        try {
-            const result = await traceTailRef.current.generateEnhancedFingerprint({
-                includeComponents: true,
-                fraudDetection: true
+                verbose: true
             });
             setFingerprint(result);
             return result;
@@ -211,52 +131,6 @@ function useVisitorId(options) {
         refresh
     };
 }
-/**
- * React hook for fraud detection with configurable thresholds
- *
- * @example
- * ```typescript
- * import { useFraudDetection } from '@tracetail/react';
- *
- * function SecurityCheck() {
- *   const { isFraudulent, riskLevel, loading } = useFraudDetection({
- *     apiKey: 'your-api-key',
- *     riskThreshold: 0.7,
- *     botThreshold: 0.5
- *   });
- *
- *   if (isFraudulent) {
- *     return <div>⚠️ High risk detected - additional verification required</div>;
- *   }
- *
- *   return <div>✅ Security check passed (Risk: {riskLevel})</div>;
- * }
- * ```
- */
-function useFraudDetection(options) {
-    const riskThreshold = options.riskThreshold || 0.7;
-    const botThreshold = options.botThreshold || 0.5;
-    const { fingerprint, loading, error, generate } = useEnhancedTraceTail({
-        ...options,
-        immediate: true
-    });
-    const isFraudulent = fingerprint ?
-        fingerprint.riskScore > riskThreshold || fingerprint.botProbability > botThreshold :
-        false;
-    const recheck = useCallback(async () => {
-        await generate();
-    }, [generate]);
-    return {
-        isFraudulent,
-        riskLevel: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.threatLevel) || null,
-        riskScore: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.riskScore) || 0,
-        botProbability: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.botProbability) || 0,
-        fraudSignals: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.fraudSignals) || [],
-        loading,
-        error,
-        recheck
-    };
-}
 const TraceTailProvider = ({ children }) => {
     // This is a simple provider that could be extended with context
     // For now, it just renders children since hooks manage their own instances
@@ -265,16 +139,14 @@ const TraceTailProvider = ({ children }) => {
 /**
  * Get the current React package version
  */
-const getVersion = () => '2.3.3';
+const getVersion = () => '2.3.4';
 // Default export
 var index = {
     useTraceTail,
-    useEnhancedTraceTail,
     useVisitorId,
-    useFraudDetection,
     TraceTailProvider,
     getVersion
 };
 
-export { TraceTailProvider, index as default, getVersion, useEnhancedTraceTail, useFraudDetection, useTraceTail, useVisitorId };
+export { TraceTailProvider, index as default, getVersion, useTraceTail, useVisitorId };
 //# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/index.tsx"],"sourcesContent":["/**\n * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting\n * Version: 2.3.3\n * \n * Over 99.5% accuracy browser fingerprinting with React hooks.\n * Perfect for fraud detection, user analytics, and security applications.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { FC, ReactNode } from 'react';\nimport { TraceTail, FingerprintOptions, FingerprintResult, EnhancedFingerprintResult } from '@tracetail/js';\n\nexport interface UseTraceTailOptions extends FingerprintOptions {\n  immediate?: boolean;\n  suspense?: boolean;\n}\n\nexport interface UseTraceTailReturn {\n  fingerprint: FingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<FingerprintResult>;\n  regenerate: () => Promise<FingerprintResult>;\n}\n\nexport interface UseEnhancedTraceTailReturn {\n  fingerprint: EnhancedFingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<EnhancedFingerprintResult>;\n  regenerate: () => Promise<EnhancedFingerprintResult>;\n}\n\n/**\n * React hook for basic browser fingerprinting\n * \n * @example\n * ```typescript\n * import { useTraceTail } from '@tracetail/react';\n * \n * function MyComponent() {\n *   const { fingerprint, loading, error } = useTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Generating fingerprint...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;\n * }\n * ```\n */\nexport function useTraceTail(options: UseTraceTailOptions): UseTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<FingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<FingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateFingerprint({\n        includeComponents: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<FingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n/**\n * React hook for enhanced browser fingerprinting with fraud detection\n * \n * @example\n * ```typescript\n * import { useEnhancedTraceTail } from '@tracetail/react';\n * \n * function SecurityComponent() {\n *   const { fingerprint, loading, error } = useEnhancedTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Analyzing security...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   const riskLevel = fingerprint?.threatLevel || 'unknown';\n *   return (\n *     <div>\n *       <p>Risk Level: {riskLevel}</p>\n *       <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useEnhancedTraceTail(options: UseTraceTailOptions): UseEnhancedTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<EnhancedFingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<EnhancedFingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateEnhancedFingerprint({\n        includeComponents: true,\n        fraudDetection: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<EnhancedFingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n/**\n * React hook for visitor identification with persistent storage\n * \n * @example\n * ```typescript\n * import { useVisitorId } from '@tracetail/react';\n * \n * function UserTrackingComponent() {\n *   const { visitorId, isReturningVisitor, loading } = useVisitorId({\n *     apiKey: 'your-api-key',\n *     storageKey: 'app_visitor_id'\n *   });\n * \n *   return (\n *     <div>\n *       <p>Visitor: {visitorId}</p>\n *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useVisitorId(options: UseTraceTailOptions & {\n  storageKey?: string;\n}): {\n  visitorId: string | null;\n  isReturningVisitor: boolean;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n} {\n  const storageKey = options.storageKey || 'tracetail_visitor_id';\n  const [visitorId, setVisitorId] = useState<string | null>(null);\n  const [isReturningVisitor, setIsReturningVisitor] = useState(false);\n  \n  const { fingerprint, loading, error, generate } = useTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  // Update visitor ID when fingerprint changes\n  useEffect(() => {\n    if (fingerprint?.visitorId) {\n      const storedVisitorId = localStorage.getItem(storageKey);\n      \n      if (storedVisitorId) {\n        setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);\n      } else {\n        setIsReturningVisitor(false);\n      }\n      \n      setVisitorId(fingerprint.visitorId);\n      localStorage.setItem(storageKey, fingerprint.visitorId);\n    }\n  }, [fingerprint?.visitorId, storageKey]);\n\n  const refresh = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    visitorId,\n    isReturningVisitor,\n    loading,\n    error,\n    refresh\n  };\n}\n\n/**\n * React hook for fraud detection with configurable thresholds\n * \n * @example\n * ```typescript\n * import { useFraudDetection } from '@tracetail/react';\n * \n * function SecurityCheck() {\n *   const { isFraudulent, riskLevel, loading } = useFraudDetection({\n *     apiKey: 'your-api-key',\n *     riskThreshold: 0.7,\n *     botThreshold: 0.5\n *   });\n * \n *   if (isFraudulent) {\n *     return <div>⚠️ High risk detected - additional verification required</div>;\n *   }\n * \n *   return <div>✅ Security check passed (Risk: {riskLevel})</div>;\n * }\n * ```\n */\nexport function useFraudDetection(options: UseTraceTailOptions & {\n  riskThreshold?: number;\n  botThreshold?: number;\n}): {\n  isFraudulent: boolean;\n  riskLevel: 'low' | 'medium' | 'high' | null;\n  riskScore: number;\n  botProbability: number;\n  fraudSignals: string[];\n  loading: boolean;\n  error: Error | null;\n  recheck: () => Promise<void>;\n} {\n  const riskThreshold = options.riskThreshold || 0.7;\n  const botThreshold = options.botThreshold || 0.5;\n  \n  const { fingerprint, loading, error, generate } = useEnhancedTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  const isFraudulent = fingerprint ? \n    fingerprint.riskScore > riskThreshold || fingerprint.botProbability > botThreshold : \n    false;\n\n  const recheck = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    isFraudulent,\n    riskLevel: fingerprint?.threatLevel || null,\n    riskScore: fingerprint?.riskScore || 0,\n    botProbability: fingerprint?.botProbability || 0,\n    fraudSignals: fingerprint?.fraudSignals || [],\n    loading,\n    error,\n    recheck\n  };\n}\n\n// Re-export types and utilities from the base package\nexport type {\n  FingerprintOptions,\n  FingerprintResult,\n  EnhancedFingerprintResult,\n  ComponentData\n} from '@tracetail/js';\n\nexport { TraceTail } from '@tracetail/js';\n\n// React-specific utilities\ninterface TraceTailProviderProps {\n  children: ReactNode;\n  apiKey: string;\n  options?: Partial<FingerprintOptions>;\n}\n\nexport const TraceTailProvider: FC<TraceTailProviderProps> = ({ children }) => {\n  // This is a simple provider that could be extended with context\n  // For now, it just renders children since hooks manage their own instances\n  return <>{children}</>;\n};\n\n/**\n * Get the current React package version\n */\nexport const getVersion = (): string => '2.3.3';\n\n// Default export\nexport default {\n  useTraceTail,\n  useEnhancedTraceTail,\n  useVisitorId,\n  useFraudDetection,\n  TraceTailProvider,\n  getVersion\n};"],"names":["_jsx","_Fragment"],"mappings":"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"}
+{"version":3,"file":"index.esm.js","sources":["../src/index.tsx"],"sourcesContent":["/**\n * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting\n * Version: 2.3.4\n *\n * Over 99.5% accuracy browser fingerprinting with React hooks and server-side processing.\n * Perfect for fraud detection, user analytics, and security applications.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { FC, ReactNode } from 'react';\nimport { TraceTail, FingerprintOptions, FingerprintResult } from '@tracetail/js';\n\nexport interface UseTraceTailOptions extends FingerprintOptions {\n  immediate?: boolean;\n  suspense?: boolean;\n}\n\nexport interface UseTraceTailReturn {\n  fingerprint: FingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<FingerprintResult>;\n  regenerate: () => Promise<FingerprintResult>;\n}\n\n\n/**\n * React hook for basic browser fingerprinting\n * \n * @example\n * ```typescript\n * import { useTraceTail } from '@tracetail/react';\n * \n * function MyComponent() {\n *   const { fingerprint, loading, error } = useTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Generating fingerprint...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;\n * }\n * ```\n */\nexport function useTraceTail(options: UseTraceTailOptions): UseTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<FingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<FingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateFingerprint({\n        verbose: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<FingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n\n/**\n * React hook for visitor identification with persistent storage\n * \n * @example\n * ```typescript\n * import { useVisitorId } from '@tracetail/react';\n * \n * function UserTrackingComponent() {\n *   const { visitorId, isReturningVisitor, loading } = useVisitorId({\n *     apiKey: 'your-api-key',\n *     storageKey: 'app_visitor_id'\n *   });\n * \n *   return (\n *     <div>\n *       <p>Visitor: {visitorId}</p>\n *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useVisitorId(options: UseTraceTailOptions & {\n  storageKey?: string;\n}): {\n  visitorId: string | null;\n  isReturningVisitor: boolean;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n} {\n  const storageKey = options.storageKey || 'tracetail_visitor_id';\n  const [visitorId, setVisitorId] = useState<string | null>(null);\n  const [isReturningVisitor, setIsReturningVisitor] = useState(false);\n  \n  const { fingerprint, loading, error, generate } = useTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  // Update visitor ID when fingerprint changes\n  useEffect(() => {\n    if (fingerprint?.visitorId) {\n      const storedVisitorId = localStorage.getItem(storageKey);\n      \n      if (storedVisitorId) {\n        setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);\n      } else {\n        setIsReturningVisitor(false);\n      }\n      \n      setVisitorId(fingerprint.visitorId);\n      localStorage.setItem(storageKey, fingerprint.visitorId);\n    }\n  }, [fingerprint?.visitorId, storageKey]);\n\n  const refresh = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    visitorId,\n    isReturningVisitor,\n    loading,\n    error,\n    refresh\n  };\n}\n\n\n// Re-export types and utilities from the base package\nexport type {\n  FingerprintOptions,\n  FingerprintResult,\n  ComponentData\n} from '@tracetail/js';\n\nexport { TraceTail } from '@tracetail/js';\n\n// React-specific utilities\ninterface TraceTailProviderProps {\n  children: ReactNode;\n  apiKey: string;\n  options?: Partial<FingerprintOptions>;\n}\n\nexport const TraceTailProvider: FC<TraceTailProviderProps> = ({ children }) => {\n  // This is a simple provider that could be extended with context\n  // For now, it just renders children since hooks manage their own instances\n  return <>{children}</>;\n};\n\n/**\n * Get the current React package version\n */\nexport const getVersion = (): string => '2.3.4';\n\n// Default export\nexport default {\n  useTraceTail,\n  useVisitorId,\n  TraceTailProvider,\n  getVersion\n};"],"names":["_jsx","_Fragment"],"mappings":"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"}

package/dist/index.js

@@ -45,87 +45,7 @@ function useTraceTail(options) {
         setError(null);
         try {
             const result = await traceTailRef.current.generateFingerprint({
-                includeComponents: true
-            });
-            setFingerprint(result);
-            return result;
-        }
-        catch (err) {
-            const error = err instanceof Error ? err : new Error('Unknown error');
-            setError(error);
-            throw error;
-        }
-        finally {
-            setLoading(false);
-        }
-    }, []);
-    const regenerate = react.useCallback(async () => {
-        setFingerprint(null);
-        return generate();
-    }, [generate]);
-    // Auto-generate on mount if immediate is true
-    react.useEffect(() => {
-        if (options.immediate && !fingerprint && !loading) {
-            generate().catch(() => {
-                // Error is already handled in generate function
-            });
-        }
-    }, [options.immediate, fingerprint, loading, generate]);
-    return {
-        fingerprint,
-        loading,
-        error,
-        generate,
-        regenerate
-    };
-}
-/**
- * React hook for enhanced browser fingerprinting with fraud detection
- *
- * @example
- * ```typescript
- * import { useEnhancedTraceTail } from '@tracetail/react';
- *
- * function SecurityComponent() {
- *   const { fingerprint, loading, error } = useEnhancedTraceTail({
- *     apiKey: 'your-api-key',
- *     immediate: true
- *   });
- *
- *   if (loading) return <div>Analyzing security...</div>;
- *   if (error) return <div>Error: {error.message}</div>;
- *
- *   const riskLevel = fingerprint?.threatLevel || 'unknown';
- *   return (
- *     <div>
- *       <p>Risk Level: {riskLevel}</p>
- *       <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>
- *     </div>
- *   );
- * }
- * ```
- */
-function useEnhancedTraceTail(options) {
-    const [fingerprint, setFingerprint] = react.useState(null);
-    const [loading, setLoading] = react.useState(false);
-    const [error, setError] = react.useState(null);
-    const traceTailRef = react.useRef(null);
-    // Initialize TraceTail instance
-    react.useEffect(() => {
-        if (!traceTailRef.current) {
-            traceTailRef.current = new js.TraceTail(options);
-        }
-    }, [options.apiKey, options.endpoint]);
-    const generate = react.useCallback(async () => {
-        if (!traceTailRef.current) {
-            throw new Error('TraceTail not initialized');
-        }
-        setLoading(true);
-        setError(null);
-        try {
-            const result = await traceTailRef.current.generateEnhancedFingerprint({
-                includeComponents: true,
-                fraudDetection: true
+                verbose: true
             });
             setFingerprint(result);
             return result;
@@ -214,52 +134,6 @@ function useVisitorId(options) {
         refresh
     };
 }
-/**
- * React hook for fraud detection with configurable thresholds
- *
- * @example
- * ```typescript
- * import { useFraudDetection } from '@tracetail/react';
- *
- * function SecurityCheck() {
- *   const { isFraudulent, riskLevel, loading } = useFraudDetection({
- *     apiKey: 'your-api-key',
- *     riskThreshold: 0.7,
- *     botThreshold: 0.5
- *   });
- *
- *   if (isFraudulent) {
- *     return <div>⚠️ High risk detected - additional verification required</div>;
- *   }
- *
- *   return <div>✅ Security check passed (Risk: {riskLevel})</div>;
- * }
- * ```
- */
-function useFraudDetection(options) {
-    const riskThreshold = options.riskThreshold || 0.7;
-    const botThreshold = options.botThreshold || 0.5;
-    const { fingerprint, loading, error, generate } = useEnhancedTraceTail({
-        ...options,
-        immediate: true
-    });
-    const isFraudulent = fingerprint ?
-        fingerprint.riskScore > riskThreshold || fingerprint.botProbability > botThreshold :
-        false;
-    const recheck = react.useCallback(async () => {
-        await generate();
-    }, [generate]);
-    return {
-        isFraudulent,
-        riskLevel: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.threatLevel) || null,
-        riskScore: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.riskScore) || 0,
-        botProbability: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.botProbability) || 0,
-        fraudSignals: (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.fraudSignals) || [],
-        loading,
-        error,
-        recheck
-    };
-}
 const TraceTailProvider = ({ children }) => {
     // This is a simple provider that could be extended with context
     // For now, it just renders children since hooks manage their own instances
@@ -268,13 +142,11 @@ const TraceTailProvider = ({ children }) => {
 /**
  * Get the current React package version
  */
-const getVersion = () => '2.3.3';
+const getVersion = () => '2.3.4';
 // Default export
 var index = {
     useTraceTail,
-    useEnhancedTraceTail,
     useVisitorId,
-    useFraudDetection,
     TraceTailProvider,
     getVersion
 };
@@ -286,8 +158,6 @@ Object.defineProperty(exports, "TraceTail", {
 exports.TraceTailProvider = TraceTailProvider;
 exports.default = index;
 exports.getVersion = getVersion;
-exports.useEnhancedTraceTail = useEnhancedTraceTail;
-exports.useFraudDetection = useFraudDetection;
 exports.useTraceTail = useTraceTail;
 exports.useVisitorId = useVisitorId;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.tsx"],"sourcesContent":["/**\n * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting\n * Version: 2.3.3\n * \n * Over 99.5% accuracy browser fingerprinting with React hooks.\n * Perfect for fraud detection, user analytics, and security applications.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { FC, ReactNode } from 'react';\nimport { TraceTail, FingerprintOptions, FingerprintResult, EnhancedFingerprintResult } from '@tracetail/js';\n\nexport interface UseTraceTailOptions extends FingerprintOptions {\n  immediate?: boolean;\n  suspense?: boolean;\n}\n\nexport interface UseTraceTailReturn {\n  fingerprint: FingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<FingerprintResult>;\n  regenerate: () => Promise<FingerprintResult>;\n}\n\nexport interface UseEnhancedTraceTailReturn {\n  fingerprint: EnhancedFingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<EnhancedFingerprintResult>;\n  regenerate: () => Promise<EnhancedFingerprintResult>;\n}\n\n/**\n * React hook for basic browser fingerprinting\n * \n * @example\n * ```typescript\n * import { useTraceTail } from '@tracetail/react';\n * \n * function MyComponent() {\n *   const { fingerprint, loading, error } = useTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Generating fingerprint...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;\n * }\n * ```\n */\nexport function useTraceTail(options: UseTraceTailOptions): UseTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<FingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<FingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateFingerprint({\n        includeComponents: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<FingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n/**\n * React hook for enhanced browser fingerprinting with fraud detection\n * \n * @example\n * ```typescript\n * import { useEnhancedTraceTail } from '@tracetail/react';\n * \n * function SecurityComponent() {\n *   const { fingerprint, loading, error } = useEnhancedTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Analyzing security...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   const riskLevel = fingerprint?.threatLevel || 'unknown';\n *   return (\n *     <div>\n *       <p>Risk Level: {riskLevel}</p>\n *       <p>Bot Probability: {(fingerprint?.botProbability * 100).toFixed(1)}%</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useEnhancedTraceTail(options: UseTraceTailOptions): UseEnhancedTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<EnhancedFingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<EnhancedFingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateEnhancedFingerprint({\n        includeComponents: true,\n        fraudDetection: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<EnhancedFingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n/**\n * React hook for visitor identification with persistent storage\n * \n * @example\n * ```typescript\n * import { useVisitorId } from '@tracetail/react';\n * \n * function UserTrackingComponent() {\n *   const { visitorId, isReturningVisitor, loading } = useVisitorId({\n *     apiKey: 'your-api-key',\n *     storageKey: 'app_visitor_id'\n *   });\n * \n *   return (\n *     <div>\n *       <p>Visitor: {visitorId}</p>\n *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useVisitorId(options: UseTraceTailOptions & {\n  storageKey?: string;\n}): {\n  visitorId: string | null;\n  isReturningVisitor: boolean;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n} {\n  const storageKey = options.storageKey || 'tracetail_visitor_id';\n  const [visitorId, setVisitorId] = useState<string | null>(null);\n  const [isReturningVisitor, setIsReturningVisitor] = useState(false);\n  \n  const { fingerprint, loading, error, generate } = useTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  // Update visitor ID when fingerprint changes\n  useEffect(() => {\n    if (fingerprint?.visitorId) {\n      const storedVisitorId = localStorage.getItem(storageKey);\n      \n      if (storedVisitorId) {\n        setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);\n      } else {\n        setIsReturningVisitor(false);\n      }\n      \n      setVisitorId(fingerprint.visitorId);\n      localStorage.setItem(storageKey, fingerprint.visitorId);\n    }\n  }, [fingerprint?.visitorId, storageKey]);\n\n  const refresh = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    visitorId,\n    isReturningVisitor,\n    loading,\n    error,\n    refresh\n  };\n}\n\n/**\n * React hook for fraud detection with configurable thresholds\n * \n * @example\n * ```typescript\n * import { useFraudDetection } from '@tracetail/react';\n * \n * function SecurityCheck() {\n *   const { isFraudulent, riskLevel, loading } = useFraudDetection({\n *     apiKey: 'your-api-key',\n *     riskThreshold: 0.7,\n *     botThreshold: 0.5\n *   });\n * \n *   if (isFraudulent) {\n *     return <div>⚠️ High risk detected - additional verification required</div>;\n *   }\n * \n *   return <div>✅ Security check passed (Risk: {riskLevel})</div>;\n * }\n * ```\n */\nexport function useFraudDetection(options: UseTraceTailOptions & {\n  riskThreshold?: number;\n  botThreshold?: number;\n}): {\n  isFraudulent: boolean;\n  riskLevel: 'low' | 'medium' | 'high' | null;\n  riskScore: number;\n  botProbability: number;\n  fraudSignals: string[];\n  loading: boolean;\n  error: Error | null;\n  recheck: () => Promise<void>;\n} {\n  const riskThreshold = options.riskThreshold || 0.7;\n  const botThreshold = options.botThreshold || 0.5;\n  \n  const { fingerprint, loading, error, generate } = useEnhancedTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  const isFraudulent = fingerprint ? \n    fingerprint.riskScore > riskThreshold || fingerprint.botProbability > botThreshold : \n    false;\n\n  const recheck = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    isFraudulent,\n    riskLevel: fingerprint?.threatLevel || null,\n    riskScore: fingerprint?.riskScore || 0,\n    botProbability: fingerprint?.botProbability || 0,\n    fraudSignals: fingerprint?.fraudSignals || [],\n    loading,\n    error,\n    recheck\n  };\n}\n\n// Re-export types and utilities from the base package\nexport type {\n  FingerprintOptions,\n  FingerprintResult,\n  EnhancedFingerprintResult,\n  ComponentData\n} from '@tracetail/js';\n\nexport { TraceTail } from '@tracetail/js';\n\n// React-specific utilities\ninterface TraceTailProviderProps {\n  children: ReactNode;\n  apiKey: string;\n  options?: Partial<FingerprintOptions>;\n}\n\nexport const TraceTailProvider: FC<TraceTailProviderProps> = ({ children }) => {\n  // This is a simple provider that could be extended with context\n  // For now, it just renders children since hooks manage their own instances\n  return <>{children}</>;\n};\n\n/**\n * Get the current React package version\n */\nexport const getVersion = (): string => '2.3.3';\n\n// Default export\nexport default {\n  useTraceTail,\n  useEnhancedTraceTail,\n  useVisitorId,\n  useFraudDetection,\n  TraceTailProvider,\n  getVersion\n};"],"names":["useState","useRef","useEffect","TraceTail","useCallback","_jsx","_Fragment"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/index.tsx"],"sourcesContent":["/**\n * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting\n * Version: 2.3.4\n *\n * Over 99.5% accuracy browser fingerprinting with React hooks and server-side processing.\n * Perfect for fraud detection, user analytics, and security applications.\n */\n\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport type { FC, ReactNode } from 'react';\nimport { TraceTail, FingerprintOptions, FingerprintResult } from '@tracetail/js';\n\nexport interface UseTraceTailOptions extends FingerprintOptions {\n  immediate?: boolean;\n  suspense?: boolean;\n}\n\nexport interface UseTraceTailReturn {\n  fingerprint: FingerprintResult | null;\n  loading: boolean;\n  error: Error | null;\n  generate: () => Promise<FingerprintResult>;\n  regenerate: () => Promise<FingerprintResult>;\n}\n\n\n/**\n * React hook for basic browser fingerprinting\n * \n * @example\n * ```typescript\n * import { useTraceTail } from '@tracetail/react';\n * \n * function MyComponent() {\n *   const { fingerprint, loading, error } = useTraceTail({\n *     apiKey: 'your-api-key',\n *     immediate: true\n *   });\n * \n *   if (loading) return <div>Generating fingerprint...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *   \n *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;\n * }\n * ```\n */\nexport function useTraceTail(options: UseTraceTailOptions): UseTraceTailReturn {\n  const [fingerprint, setFingerprint] = useState<FingerprintResult | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  \n  const traceTailRef = useRef<TraceTail | null>(null);\n  \n  // Initialize TraceTail instance\n  useEffect(() => {\n    if (!traceTailRef.current) {\n      traceTailRef.current = new TraceTail(options);\n    }\n  }, [options.apiKey, options.endpoint]);\n\n  const generate = useCallback(async (): Promise<FingerprintResult> => {\n    if (!traceTailRef.current) {\n      throw new Error('TraceTail not initialized');\n    }\n\n    setLoading(true);\n    setError(null);\n\n    try {\n      const result = await traceTailRef.current.generateFingerprint({\n        verbose: true\n      });\n      setFingerprint(result);\n      return result;\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error('Unknown error');\n      setError(error);\n      throw error;\n    } finally {\n      setLoading(false);\n    }\n  }, []);\n\n  const regenerate = useCallback(async (): Promise<FingerprintResult> => {\n    setFingerprint(null);\n    return generate();\n  }, [generate]);\n\n  // Auto-generate on mount if immediate is true\n  useEffect(() => {\n    if (options.immediate && !fingerprint && !loading) {\n      generate().catch(() => {\n        // Error is already handled in generate function\n      });\n    }\n  }, [options.immediate, fingerprint, loading, generate]);\n\n  return {\n    fingerprint,\n    loading,\n    error,\n    generate,\n    regenerate\n  };\n}\n\n\n/**\n * React hook for visitor identification with persistent storage\n * \n * @example\n * ```typescript\n * import { useVisitorId } from '@tracetail/react';\n * \n * function UserTrackingComponent() {\n *   const { visitorId, isReturningVisitor, loading } = useVisitorId({\n *     apiKey: 'your-api-key',\n *     storageKey: 'app_visitor_id'\n *   });\n * \n *   return (\n *     <div>\n *       <p>Visitor: {visitorId}</p>\n *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useVisitorId(options: UseTraceTailOptions & {\n  storageKey?: string;\n}): {\n  visitorId: string | null;\n  isReturningVisitor: boolean;\n  loading: boolean;\n  error: Error | null;\n  refresh: () => Promise<void>;\n} {\n  const storageKey = options.storageKey || 'tracetail_visitor_id';\n  const [visitorId, setVisitorId] = useState<string | null>(null);\n  const [isReturningVisitor, setIsReturningVisitor] = useState(false);\n  \n  const { fingerprint, loading, error, generate } = useTraceTail({\n    ...options,\n    immediate: true\n  });\n\n  // Update visitor ID when fingerprint changes\n  useEffect(() => {\n    if (fingerprint?.visitorId) {\n      const storedVisitorId = localStorage.getItem(storageKey);\n      \n      if (storedVisitorId) {\n        setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);\n      } else {\n        setIsReturningVisitor(false);\n      }\n      \n      setVisitorId(fingerprint.visitorId);\n      localStorage.setItem(storageKey, fingerprint.visitorId);\n    }\n  }, [fingerprint?.visitorId, storageKey]);\n\n  const refresh = useCallback(async () => {\n    await generate();\n  }, [generate]);\n\n  return {\n    visitorId,\n    isReturningVisitor,\n    loading,\n    error,\n    refresh\n  };\n}\n\n\n// Re-export types and utilities from the base package\nexport type {\n  FingerprintOptions,\n  FingerprintResult,\n  ComponentData\n} from '@tracetail/js';\n\nexport { TraceTail } from '@tracetail/js';\n\n// React-specific utilities\ninterface TraceTailProviderProps {\n  children: ReactNode;\n  apiKey: string;\n  options?: Partial<FingerprintOptions>;\n}\n\nexport const TraceTailProvider: FC<TraceTailProviderProps> = ({ children }) => {\n  // This is a simple provider that could be extended with context\n  // For now, it just renders children since hooks manage their own instances\n  return <>{children}</>;\n};\n\n/**\n * Get the current React package version\n */\nexport const getVersion = (): string => '2.3.4';\n\n// Default export\nexport default {\n  useTraceTail,\n  useVisitorId,\n  TraceTailProvider,\n  getVersion\n};"],"names":["useState","useRef","useEffect","TraceTail","useCallback","_jsx","_Fragment"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracetail/react",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "React hooks for TraceTail enterprise browser fingerprinting with over 99.5% accuracy. TypeScript support and React 18 compatibility.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,18 +17,28 @@
     "react",
     "hooks",
     "fingerprinting",
-    "browser",
+    "browser-fingerprinting",
     "fraud-detection",
     "security",
     "authentication",
     "device-identification",
     "privacy",
     "enterprise",
-    "typescript"
+    "typescript",
+    "tracetail",
+    "live-demo"
   ],
   "author": "TraceTail",
   "license": "MIT",
-  "homepage": "https://tracetail.io",
+  "homepage": "https://demo.tracetail.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tracetail/tracetail-js.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/tracetail/tracetail-js/issues"
+  },
   "engines": {
     "node": ">=14"
   },
@@ -53,4 +63,4 @@
     "rollup": "^4.9.6",
     "typescript": "^5.3.3"
   }
-}
+}