@keverdjs/fraud-sdk-react 1.0.0 → 1.1.2

package/README.md

@@ -85,7 +85,6 @@ interface KeverdProviderProps {
 ```typescript
 interface KeverdLoadOptions {
   apiKey: string;              // Required: Your Keverd API key
-  endpoint?: string;           // Optional: Custom API endpoint (default: https://app.keverd.com)
   debug?: boolean;             // Optional: Enable debug logging (default: false)
 }
 ```
@@ -151,21 +150,6 @@ const sdk = useKeverdContext();
 
 ## Configuration
 
-### Custom Endpoint
-
-If you're using a custom backend endpoint:
-
-```tsx
-<KeverdProvider
-  loadOptions={{
-    apiKey: 'your-api-key',
-    endpoint: 'https://api.yourdomain.com/v1/fingerprint/score',
-  }}
->
-  {children}
-</KeverdProvider>
-```
-
 ### Debug Mode
 
 Enable debug logging for development:

package/dist/index.d.mts

@@ -28,11 +28,19 @@ interface KeverdSessionInfo {
     firstSession?: string;
     timestamp?: string;
 }
+interface KeverdBehavioralSequence {
+    featureNames: string[];
+    windowSize: number;
+    maskValue: number;
+    sequence: number[][];
+}
 interface KeverdBehavioralData {
     typing_dwell_ms?: number[];
     typing_flight_ms?: number[];
     swipe_velocity?: number;
     session_entropy?: number;
+    suspicious_swipe_velocity?: number;
+    behavioral_vectors?: KeverdBehavioralSequence;
 }
 interface KeverdFingerprintRequest {
     userId?: string;
@@ -74,7 +82,6 @@ interface KeverdVisitorData {
 }
 interface KeverdConfig {
     apiKey: string;
-    endpoint?: string;
     userId?: string;
     debug?: boolean;
     extendedResult?: boolean;
@@ -82,7 +89,6 @@ interface KeverdConfig {
 }
 interface KeverdLoadOptions {
     apiKey: string;
-    endpoint?: string;
     debug?: boolean;
 }
 interface KeverdVisitorDataOptions {
@@ -127,6 +133,10 @@ declare class KeverdSDK {
      * Get visitor data (fingerprint and risk assessment)
      */
     getVisitorData(options?: KeverdVisitorDataOptions): Promise<KeverdVisitorData>;
+    /**
+     * Extract origin and referrer from browser
+     */
+    private getOriginHeaders;
     /**
      * Send fingerprint request to backend
      */
@@ -143,10 +153,44 @@ declare class KeverdSDK {
      * Generate a session ID
      */
     private generateSessionId;
+    /**
+     * Start a new session (called automatically on init, but can be called manually)
+     */
+    startSession(userId?: string, deviceHash?: string, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * End the current session
+     */
+    endSession(): Promise<void>;
+    /**
+     * Pause the current session (e.g., when app goes to background)
+     */
+    pauseSession(): Promise<void>;
+    /**
+     * Resume a paused session (e.g., when app comes to foreground)
+     */
+    resumeSession(): Promise<void>;
+    /**
+     * Get current session status
+     */
+    getSessionStatus(): Promise<{
+        session_id: string;
+        status: string;
+        is_active: boolean;
+        is_paused: boolean;
+        event_count: number;
+        started_at: string;
+        last_activity_at: string;
+        duration_seconds: number | null;
+    } | null>;
+    /**
+     * Helper methods for browser/OS detection
+     */
+    private _detectBrowser;
+    private _detectOS;
     /**
      * Destroy the SDK instance
      */
-    destroy(): void;
+    destroy(): Promise<void>;
     /**
      * Get current configuration
      */
@@ -294,72 +338,19 @@ declare class KeverdDeviceCollector {
     clearCache(): void;
 }
 
-/**
- * Keverd Behavioral Data Collector
- * Collects typing patterns, mouse movements, swipe gestures, and calculates session entropy
- */
-
 declare class KeverdBehavioralCollector {
-    private keystrokes;
-    private mouseMovements;
-    private lastKeyDownTime;
-    private lastKeyUpTime;
     private isActive;
-    private sessionStartTime;
-    private typingDwellTimes;
-    private typingFlightTimes;
-    private swipeVelocities;
     private sessionEvents;
-    private touchStartPositions;
-    private keyDownHandler;
-    private keyUpHandler;
-    private mouseMoveHandler;
-    private touchStartHandler;
-    private touchEndHandler;
-    /**
-     * Start collecting behavioral data
-     */
+    private kinematicEngine;
+    private keystrokeMonitor;
+    constructor();
     start(): void;
-    /**
-     * Stop collecting behavioral data
-     */
     stop(): void;
-    /**
-     * Get collected behavioral data
-     */
-    getData(): KeverdBehavioralData;
-    /**
-     * Reset collected data
-     */
     reset(): void;
-    /**
-     * Handle keydown event
-     */
-    private handleKeyDown;
-    /**
-     * Handle keyup event
-     */
-    private handleKeyUp;
-    /**
-     * Handle mouse move event
-     */
-    private handleMouseMove;
-    /**
-     * Handle touch start (for swipe detection)
-     */
-    private handleTouchStart;
-    /**
-     * Handle touch end (calculate swipe velocity)
-     */
-    private handleTouchEnd;
-    /**
-     * Calculate session entropy based on event diversity
-     */
+    getData(): KeverdBehavioralData;
+    private buildSequence;
+    private trackEvent;
     private calculateSessionEntropy;
-    /**
-     * Check if key should be ignored
-     */
-    private shouldIgnoreKey;
 }
 
 export { KeverdBehavioralCollector, type KeverdBehavioralData, type KeverdConfig, KeverdDeviceCollector, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdProvider, KeverdSDK, type KeverdSessionInfo, type KeverdSimSwapEngine, type KeverdVisitorData, type KeverdVisitorDataHookOptions, type KeverdVisitorDataOptions, type KeverdVisitorDataResult$1 as KeverdVisitorDataResult, useKeverdContext, useKeverdVisitorData };

package/dist/index.d.ts

@@ -28,11 +28,19 @@ interface KeverdSessionInfo {
     firstSession?: string;
     timestamp?: string;
 }
+interface KeverdBehavioralSequence {
+    featureNames: string[];
+    windowSize: number;
+    maskValue: number;
+    sequence: number[][];
+}
 interface KeverdBehavioralData {
     typing_dwell_ms?: number[];
     typing_flight_ms?: number[];
     swipe_velocity?: number;
     session_entropy?: number;
+    suspicious_swipe_velocity?: number;
+    behavioral_vectors?: KeverdBehavioralSequence;
 }
 interface KeverdFingerprintRequest {
     userId?: string;
@@ -74,7 +82,6 @@ interface KeverdVisitorData {
 }
 interface KeverdConfig {
     apiKey: string;
-    endpoint?: string;
     userId?: string;
     debug?: boolean;
     extendedResult?: boolean;
@@ -82,7 +89,6 @@ interface KeverdConfig {
 }
 interface KeverdLoadOptions {
     apiKey: string;
-    endpoint?: string;
     debug?: boolean;
 }
 interface KeverdVisitorDataOptions {
@@ -127,6 +133,10 @@ declare class KeverdSDK {
      * Get visitor data (fingerprint and risk assessment)
      */
     getVisitorData(options?: KeverdVisitorDataOptions): Promise<KeverdVisitorData>;
+    /**
+     * Extract origin and referrer from browser
+     */
+    private getOriginHeaders;
     /**
      * Send fingerprint request to backend
      */
@@ -143,10 +153,44 @@ declare class KeverdSDK {
      * Generate a session ID
      */
     private generateSessionId;
+    /**
+     * Start a new session (called automatically on init, but can be called manually)
+     */
+    startSession(userId?: string, deviceHash?: string, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * End the current session
+     */
+    endSession(): Promise<void>;
+    /**
+     * Pause the current session (e.g., when app goes to background)
+     */
+    pauseSession(): Promise<void>;
+    /**
+     * Resume a paused session (e.g., when app comes to foreground)
+     */
+    resumeSession(): Promise<void>;
+    /**
+     * Get current session status
+     */
+    getSessionStatus(): Promise<{
+        session_id: string;
+        status: string;
+        is_active: boolean;
+        is_paused: boolean;
+        event_count: number;
+        started_at: string;
+        last_activity_at: string;
+        duration_seconds: number | null;
+    } | null>;
+    /**
+     * Helper methods for browser/OS detection
+     */
+    private _detectBrowser;
+    private _detectOS;
     /**
      * Destroy the SDK instance
      */
-    destroy(): void;
+    destroy(): Promise<void>;
     /**
      * Get current configuration
      */
@@ -294,72 +338,19 @@ declare class KeverdDeviceCollector {
     clearCache(): void;
 }
 
-/**
- * Keverd Behavioral Data Collector
- * Collects typing patterns, mouse movements, swipe gestures, and calculates session entropy
- */
-
 declare class KeverdBehavioralCollector {
-    private keystrokes;
-    private mouseMovements;
-    private lastKeyDownTime;
-    private lastKeyUpTime;
     private isActive;
-    private sessionStartTime;
-    private typingDwellTimes;
-    private typingFlightTimes;
-    private swipeVelocities;
     private sessionEvents;
-    private touchStartPositions;
-    private keyDownHandler;
-    private keyUpHandler;
-    private mouseMoveHandler;
-    private touchStartHandler;
-    private touchEndHandler;
-    /**
-     * Start collecting behavioral data
-     */
+    private kinematicEngine;
+    private keystrokeMonitor;
+    constructor();
     start(): void;
-    /**
-     * Stop collecting behavioral data
-     */
     stop(): void;
-    /**
-     * Get collected behavioral data
-     */
-    getData(): KeverdBehavioralData;
-    /**
-     * Reset collected data
-     */
     reset(): void;
-    /**
-     * Handle keydown event
-     */
-    private handleKeyDown;
-    /**
-     * Handle keyup event
-     */
-    private handleKeyUp;
-    /**
-     * Handle mouse move event
-     */
-    private handleMouseMove;
-    /**
-     * Handle touch start (for swipe detection)
-     */
-    private handleTouchStart;
-    /**
-     * Handle touch end (calculate swipe velocity)
-     */
-    private handleTouchEnd;
-    /**
-     * Calculate session entropy based on event diversity
-     */
+    getData(): KeverdBehavioralData;
+    private buildSequence;
+    private trackEvent;
     private calculateSessionEntropy;
-    /**
-     * Check if key should be ignored
-     */
-    private shouldIgnoreKey;
 }
 
 export { KeverdBehavioralCollector, type KeverdBehavioralData, type KeverdConfig, KeverdDeviceCollector, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdProvider, KeverdSDK, type KeverdSessionInfo, type KeverdSimSwapEngine, type KeverdVisitorData, type KeverdVisitorDataHookOptions, type KeverdVisitorDataOptions, type KeverdVisitorDataResult$1 as KeverdVisitorDataResult, useKeverdContext, useKeverdVisitorData };