@tracetail/react 2.3.1

package/README.md

@@ -0,0 +1,419 @@
+# @tracetail/react
+
+> 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)
+[![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/)
+
+## 🚀 Quick Start
+
+```bash
+npm install @tracetail/react
+```
+
+```tsx
+import { useTraceTail } from '@tracetail/react';
+
+function App() {
+  const { fingerprint, loading, error } = useTraceTail({
+    apiKey: 'your-api-key',
+    immediate: true
+  });
+
+  if (loading) return <div>Generating fingerprint...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+  
+  return <div>Visitor ID: {fingerprint?.visitorId}</div>;
+}
+```
+
+## ✨ Features
+
+- **🎯 Over 99.5% accuracy** - Industry-leading device identification
+- **⚡ React optimized** - Built specifically for React with hooks
+- **🔒 Enterprise security** - Bank-grade fraud detection hooks
+- **📱 Cross-platform** - Works on all browsers and devices  
+- **🔧 TypeScript** - Full type safety and IntelliSense
+- **🌐 Incognito consistent** - Same ID across normal and private browsing
+- **🚀 Performance optimized** - < 25ms fingerprint generation
+- **🎣 React 18 ready** - Supports concurrent features and Suspense
+
+## 🎣 Hooks Reference
+
+### `useTraceTail`
+
+Basic fingerprinting hook for visitor identification.
+
+```tsx
+import { useTraceTail } from '@tracetail/react';
+
+function MyComponent() {
+  const { fingerprint, loading, error, generate, regenerate } = useTraceTail({
+    apiKey: 'tt_prod_...',
+    immediate: true,     // Generate on mount
+    caching: true,       // Cache results
+    debug: false         // Enable debug logging
+  });
+
+  return (
+    <div>
+      {loading && <p>Generating fingerprint...</p>}
+      {error && <p>Error: {error.message}</p>}
+      {fingerprint && (
+        <div>
+          <p>Visitor ID: {fingerprint.visitorId}</p>
+          <p>Confidence: {(fingerprint.confidence * 100).toFixed(1)}%</p>
+          <p>Processing Time: {fingerprint.processingTime}ms</p>
+        </div>
+      )}
+      <button onClick={regenerate} disabled={loading}>
+        Regenerate Fingerprint
+      </button>
+    </div>
+  );
+}
+```
+
+### `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`
+
+Simplified hook focused on visitor identification with persistence.
+
+```tsx
+import { useVisitorId } from '@tracetail/react';
+
+function UserTrackingComponent() {
+  const { 
+    visitorId, 
+    isReturningVisitor, 
+    loading, 
+    error, 
+    refresh 
+  } = useVisitorId({
+    apiKey: 'your-api-key',
+    storageKey: 'my_app_visitor_id' // Custom localStorage key
+  });
+
+  return (
+    <div>
+      {loading && <p>Identifying visitor...</p>}
+      {error && <p>Error: {error.message}</p>}
+      {visitorId && (
+        <div>
+          <p>Visitor ID: {visitorId}</p>
+          <p>Status: {isReturningVisitor ? '🔄 Returning' : '✨ New'} visitor</p>
+          <button onClick={refresh}>Refresh ID</button>
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+### `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
+
+### Server-Side Rendering (SSR)
+
+```tsx
+import { useEffect, useState } from 'react';
+import { useTraceTail } from '@tracetail/react';
+
+function SSRSafeComponent() {
+  const [isClient, setIsClient] = useState(false);
+  
+  // Only run fingerprinting on client-side
+  const { fingerprint, loading } = useTraceTail({
+    apiKey: 'your-api-key',
+    immediate: isClient
+  });
+
+  useEffect(() => {
+    setIsClient(true);
+  }, []);
+
+  if (!isClient) {
+    return <div>Loading...</div>;
+  }
+
+  return (
+    <div>
+      {loading ? 'Generating...' : `ID: ${fingerprint?.visitorId}`}
+    </div>
+  );
+}
+```
+
+### Custom Hook Pattern
+
+```tsx
+import { useEnhancedTraceTail } from '@tracetail/react';
+
+function useSecurityCheck() {
+  const { fingerprint, loading, error } = useEnhancedTraceTail({
+    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
+  } : null;
+
+  return { securityStatus, loading, error };
+}
+
+// Usage
+function App() {
+  const { securityStatus, loading } = useSecurityCheck();
+  
+  if (loading) return <div>Security check...</div>;
+  
+  return (
+    <div>
+      {securityStatus?.needsVerification ? (
+        <AdditionalVerification />
+      ) : (
+        <MainContent />
+      )}
+    </div>
+  );
+}
+```
+
+### Integration with React Query
+
+```tsx
+import { useQuery } from '@tanstack/react-query';
+import { useTraceTail } from '@tracetail/react';
+
+function useUserProfile() {
+  const { fingerprint } = useTraceTail({
+    apiKey: 'your-api-key',
+    immediate: true
+  });
+
+  return useQuery({
+    queryKey: ['userProfile', fingerprint?.visitorId],
+    queryFn: () => fetchUserProfile(fingerprint?.visitorId),
+    enabled: !!fingerprint?.visitorId
+  });
+}
+```
+
+## 🔧 TypeScript Support
+
+Full TypeScript definitions included:
+
+```tsx
+import type { 
+  FingerprintResult, 
+  EnhancedFingerprintResult, 
+  UseTraceTailReturn 
+} from '@tracetail/react';
+
+const MyComponent: React.FC = () => {
+  const result: UseTraceTailReturn = useTraceTail({
+    apiKey: 'your-key',
+    immediate: true
+  });
+
+  // Full type safety
+  const visitorId: string | null = result.fingerprint?.visitorId || null;
+  const confidence: number = result.fingerprint?.confidence || 0;
+  
+  return <div>{visitorId}</div>;
+};
+```
+
+## ⚡ Performance Optimization
+
+### Lazy Loading
+
+```tsx
+import { lazy, Suspense } from 'react';
+
+const FingerprintComponent = lazy(() => import('./FingerprintComponent'));
+
+function App() {
+  return (
+    <Suspense fallback={<div>Loading security...</div>}>
+      <FingerprintComponent />
+    </Suspense>
+  );
+}
+```
+
+### Conditional Loading
+
+```tsx
+function ConditionalFingerprinting() {
+  const [needsFingerprint, setNeedsFingerprint] = useState(false);
+  
+  const { fingerprint, loading } = useTraceTail({
+    apiKey: 'your-api-key',
+    immediate: needsFingerprint // Only when needed
+  });
+
+  return (
+    <div>
+      <button onClick={() => setNeedsFingerprint(true)}>
+        Enable Security Check
+      </button>
+      {needsFingerprint && (
+        <div>
+          {loading ? 'Checking...' : `ID: ${fingerprint?.visitorId}`}
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
+## 🌐 Browser Support
+
+- Chrome 80+
+- Firefox 75+  
+- Safari 13+
+- Edge 80+
+- React Native WebView
+- Electron
+
+## 🔄 Migration Guide
+
+### From @tracetail/js
+
+```tsx
+// Before (vanilla JS)
+import { TraceTail } from '@tracetail/js';
+const tracetail = new TraceTail({ apiKey: 'key' });
+const fingerprint = await tracetail.generateFingerprint();
+
+// After (React hooks)
+import { useTraceTail } from '@tracetail/react';
+const { fingerprint, loading } = useTraceTail({ 
+  apiKey: 'key', 
+  immediate: true 
+});
+```
+
+### From other libraries
+
+```tsx
+// Replace custom fingerprinting hooks
+const { fingerprint } = useTraceTail({
+  apiKey: 'your-key',
+  immediate: true
+});
+
+// Same visitor ID across sessions and devices
+const visitorId = fingerprint?.visitorId;
+```
+
+## 📞 Support
+
+- **Documentation:** https://tracetail.io/docs
+- **API Reference:** https://tracetail.io/api-docs  
+- **Issues:** https://github.com/sirrodgepodge/TraceTail/issues
+- **Discord:** https://discord.gg/tracetail
+- **Email:** support@tracetail.io
+
+## 📝 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+**[Get your API key](https://tracetail.io/auth) • [View Documentation](https://tracetail.io/docs) • [Try Live Demo](https://tracetail.io/live-demo)**

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting
+ * Version: 2.3.1
+ *
+ * Over 99.5% accuracy browser fingerprinting with React hooks.
+ * Perfect for fraud detection, user analytics, and security applications.
+ */
+import type { FC, ReactNode } from 'react';
+import { FingerprintOptions, FingerprintResult, EnhancedFingerprintResult } from '@tracetail/js';
+export interface UseTraceTailOptions extends FingerprintOptions {
+    immediate?: boolean;
+    suspense?: boolean;
+}
+export interface UseTraceTailReturn {
+    fingerprint: FingerprintResult | null;
+    loading: boolean;
+    error: Error | null;
+    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
+ *
+ * @example
+ * ```typescript
+ * import { useTraceTail } from '@tracetail/react';
+ *
+ * function MyComponent() {
+ *   const { fingerprint, loading, error } = useTraceTail({
+ *     apiKey: 'your-api-key',
+ *     immediate: true
+ *   });
+ *
+ *   if (loading) return <div>Generating fingerprint...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;
+ * }
+ * ```
+ */
+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
+ *
+ * @example
+ * ```typescript
+ * import { useVisitorId } from '@tracetail/react';
+ *
+ * function UserTrackingComponent() {
+ *   const { visitorId, isReturningVisitor, loading } = useVisitorId({
+ *     apiKey: 'your-api-key',
+ *     storageKey: 'app_visitor_id'
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <p>Visitor: {visitorId}</p>
+ *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useVisitorId(options: UseTraceTailOptions & {
+    storageKey?: string;
+}): {
+    visitorId: string | null;
+    isReturningVisitor: boolean;
+    loading: boolean;
+    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 { TraceTail } from '@tracetail/js';
+interface TraceTailProviderProps {
+    children: ReactNode;
+    apiKey: string;
+    options?: Partial<FingerprintOptions>;
+}
+export declare const TraceTailProvider: FC<TraceTailProviderProps>;
+/**
+ * Get the current React package version
+ */
+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;
+};
+export default _default;

package/dist/index.esm.js

@@ -0,0 +1,280 @@
+import { jsx, Fragment } from 'react/jsx-runtime';
+import { useState, useRef, useEffect, useCallback } from 'react';
+import { TraceTail } from '@tracetail/js';
+export { TraceTail } from '@tracetail/js';
+
+/**
+ * React hook for basic browser fingerprinting
+ *
+ * @example
+ * ```typescript
+ * import { useTraceTail } from '@tracetail/react';
+ *
+ * function MyComponent() {
+ *   const { fingerprint, loading, error } = useTraceTail({
+ *     apiKey: 'your-api-key',
+ *     immediate: true
+ *   });
+ *
+ *   if (loading) return <div>Generating fingerprint...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;
+ * }
+ * ```
+ */
+function useTraceTail(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.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
+            });
+            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 visitor identification with persistent storage
+ *
+ * @example
+ * ```typescript
+ * import { useVisitorId } from '@tracetail/react';
+ *
+ * function UserTrackingComponent() {
+ *   const { visitorId, isReturningVisitor, loading } = useVisitorId({
+ *     apiKey: 'your-api-key',
+ *     storageKey: 'app_visitor_id'
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <p>Visitor: {visitorId}</p>
+ *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useVisitorId(options) {
+    const storageKey = options.storageKey || 'tracetail_visitor_id';
+    const [visitorId, setVisitorId] = useState(null);
+    const [isReturningVisitor, setIsReturningVisitor] = useState(false);
+    const { fingerprint, loading, error, generate } = useTraceTail({
+        ...options,
+        immediate: true
+    });
+    // Update visitor ID when fingerprint changes
+    useEffect(() => {
+        if (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.visitorId) {
+            const storedVisitorId = localStorage.getItem(storageKey);
+            if (storedVisitorId) {
+                setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);
+            }
+            else {
+                setIsReturningVisitor(false);
+            }
+            setVisitorId(fingerprint.visitorId);
+            localStorage.setItem(storageKey, fingerprint.visitorId);
+        }
+    }, [fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.visitorId, storageKey]);
+    const refresh = useCallback(async () => {
+        await generate();
+    }, [generate]);
+    return {
+        visitorId,
+        isReturningVisitor,
+        loading,
+        error,
+        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
+    return jsx(Fragment, { children: children });
+};
+/**
+ * Get the current React package version
+ */
+const getVersion = () => '2.3.1';
+// Default export
+var index = {
+    useTraceTail,
+    useEnhancedTraceTail,
+    useVisitorId,
+    useFraudDetection,
+    TraceTailProvider,
+    getVersion
+};
+
+export { TraceTailProvider, index as default, getVersion, useEnhancedTraceTail, useFraudDetection, useTraceTail, useVisitorId };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +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.1\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.1';\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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"}

package/dist/index.js

@@ -0,0 +1,293 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var js = require('@tracetail/js');
+
+/**
+ * React hook for basic browser fingerprinting
+ *
+ * @example
+ * ```typescript
+ * import { useTraceTail } from '@tracetail/react';
+ *
+ * function MyComponent() {
+ *   const { fingerprint, loading, error } = useTraceTail({
+ *     apiKey: 'your-api-key',
+ *     immediate: true
+ *   });
+ *
+ *   if (loading) return <div>Generating fingerprint...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return <div>Visitor ID: {fingerprint?.visitorId}</div>;
+ * }
+ * ```
+ */
+function useTraceTail(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.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
+            });
+            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 visitor identification with persistent storage
+ *
+ * @example
+ * ```typescript
+ * import { useVisitorId } from '@tracetail/react';
+ *
+ * function UserTrackingComponent() {
+ *   const { visitorId, isReturningVisitor, loading } = useVisitorId({
+ *     apiKey: 'your-api-key',
+ *     storageKey: 'app_visitor_id'
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <p>Visitor: {visitorId}</p>
+ *       <p>Status: {isReturningVisitor ? 'Returning' : 'New'} visitor</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useVisitorId(options) {
+    const storageKey = options.storageKey || 'tracetail_visitor_id';
+    const [visitorId, setVisitorId] = react.useState(null);
+    const [isReturningVisitor, setIsReturningVisitor] = react.useState(false);
+    const { fingerprint, loading, error, generate } = useTraceTail({
+        ...options,
+        immediate: true
+    });
+    // Update visitor ID when fingerprint changes
+    react.useEffect(() => {
+        if (fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.visitorId) {
+            const storedVisitorId = localStorage.getItem(storageKey);
+            if (storedVisitorId) {
+                setIsReturningVisitor(storedVisitorId === fingerprint.visitorId);
+            }
+            else {
+                setIsReturningVisitor(false);
+            }
+            setVisitorId(fingerprint.visitorId);
+            localStorage.setItem(storageKey, fingerprint.visitorId);
+        }
+    }, [fingerprint === null || fingerprint === void 0 ? void 0 : fingerprint.visitorId, storageKey]);
+    const refresh = react.useCallback(async () => {
+        await generate();
+    }, [generate]);
+    return {
+        visitorId,
+        isReturningVisitor,
+        loading,
+        error,
+        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
+    return jsxRuntime.jsx(jsxRuntime.Fragment, { children: children });
+};
+/**
+ * Get the current React package version
+ */
+const getVersion = () => '2.3.1';
+// Default export
+var index = {
+    useTraceTail,
+    useEnhancedTraceTail,
+    useVisitorId,
+    useFraudDetection,
+    TraceTailProvider,
+    getVersion
+};
+
+Object.defineProperty(exports, "TraceTail", {
+    enumerable: true,
+    get: function () { return js.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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.tsx"],"sourcesContent":["/**\n * @tracetail/react - React Hooks for Enterprise Browser Fingerprinting\n * Version: 2.3.1\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.1';\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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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@tracetail/react",
+  "version": "2.3.1",
+  "description": "React hooks for TraceTail enterprise browser fingerprinting with over 99.5% accuracy. TypeScript support and React 18 compatibility.",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "react",
+    "hooks",
+    "fingerprinting",
+    "browser",
+    "fraud-detection",
+    "security",
+    "authentication",
+    "device-identification",
+    "privacy",
+    "enterprise",
+    "typescript"
+  ],
+  "author": "TraceTail",
+  "license": "MIT",
+  "homepage": "https://tracetail.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sirrodgepodge/TraceTail.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/sirrodgepodge/TraceTail/issues"
+  },
+  "engines": {
+    "node": ">=14"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "dependencies": {
+    "@tracetail/js": "^2.3.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/jest": "^29.5.11",
+    "@types/react": "^18.3.11",
+    "jest": "^29.7.0",
+    "react": "^18.3.1",
+    "rollup": "^4.9.6",
+    "typescript": "^5.3.3"
+  }
+}