@keverdjs/fraud-sdk-angular 1.0.0 → 2.0.0

package/dist/index.d.mts

@@ -1,60 +1,217 @@
 import { Observable } from 'rxjs';
+import { ModuleWithProviders } from '@angular/core';
 
 /**
- * Types for Angular SDK
- * TODO: Copy and adapt types from React SDK
+ * Keverd Fraud SDK Angular - Type Definitions
  */
-interface KeverdConfig {
-    apiKey: string;
-    endpoint?: string;
-}
-interface KeverdLoadOptions {
-    apiKey: string;
-    endpoint?: string;
+interface KeverdDeviceInfo {
+    deviceId: string;
+    fingerprint: string;
+    manufacturer?: string;
+    model?: string;
+    brand?: string;
+    device?: string;
+    product?: string;
+    hardware?: string;
+    sdkVersion?: string;
+    osVersion?: string;
+    screenWidth?: string;
+    screenHeight?: string;
+    screenDensity?: string;
+    locale?: string;
+    timezone: string;
 }
-interface KeverdVisitorData {
+interface KeverdSessionInfo {
+    sessionId?: string;
+    installId?: string;
+    sessionCount?: string;
+    firstSession?: string;
+    timestamp?: string;
 }
-interface KeverdVisitorDataOptions {
+interface KeverdBehavioralSequence {
+    featureNames: string[];
+    windowSize: number;
+    maskValue: number;
+    sequence: number[][];
 }
-interface KeverdVisitorDataResult {
+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;
+    device: KeverdDeviceInfo;
+    session?: KeverdSessionInfo;
+    behavioral?: KeverdBehavioralData;
+}
+interface KeverdSimSwapEngine {
+    userId?: string;
+    risk: number;
+    flags: {
+        sim_changed?: boolean;
+        device_changed?: boolean;
+        behavior_anomaly?: boolean;
+        time_anomaly?: boolean;
+        velocity_anomaly?: boolean;
+    };
+    updatedProfile?: Record<string, unknown>;
 }
 interface KeverdFingerprintResponse {
+    risk_score: number;
+    score: number;
+    action: 'allow' | 'soft_challenge' | 'hard_challenge' | 'block';
+    reason: string[];
+    session_id: string;
+    requestId: string;
+    sim_swap_engine?: KeverdSimSwapEngine;
 }
-interface KeverdDeviceInfo {
+interface KeverdPrivacySignals {
+    isIncognito?: boolean;
+    isVPN?: boolean;
+    isAutomated?: boolean;
+    hasAdBlocker?: boolean;
 }
-interface KeverdSessionInfo {
+interface KeverdVisitorData {
+    visitorId: string;
+    riskScore: number;
+    score: number;
+    action: 'allow' | 'soft_challenge' | 'hard_challenge' | 'block';
+    reasons: string[];
+    sessionId: string;
+    requestId: string;
+    simSwapEngine?: KeverdSimSwapEngine;
+    confidence?: number;
+    fingerprintjsVisitorId?: string;
+    privacySignals?: KeverdPrivacySignals;
+    deviceMatch?: boolean;
+    fraudProbability?: number;
+    recommendedAction?: string;
 }
-interface KeverdBehavioralData {
+interface KeverdConfig {
+    apiKey: string;
+    userId?: string;
+    debug?: boolean;
+    extendedResult?: boolean;
+    ignoreCache?: boolean;
+}
+interface KeverdLoadOptions {
+    apiKey: string;
+    debug?: boolean;
+}
+interface KeverdVisitorDataOptions {
+    extendedResult?: boolean;
+    ignoreCache?: boolean;
+    tag?: string;
 }
 interface KeverdError {
+    message: string;
+    code?: string;
+    statusCode?: number;
 }
 
 /**
  * Angular service for Keverd SDK
- * TODO: Implement Angular service
+ * Provides RxJS observables for reactive data access
+ * Wraps the web SDK to provide Angular-specific interface with all enhanced signals
  */
 
 declare class KeverdService {
     private config;
+    private isInitialized;
+    constructor(config?: KeverdConfig);
+    /**
+     * Initialize the SDK with configuration
+     * Wraps the web SDK initialization
+     */
     init(config: KeverdConfig): void;
+    /**
+     * Get visitor data (fingerprint and risk assessment)
+     * Returns an RxJS Observable
+     */
     getVisitorData(options?: KeverdVisitorDataOptions): Observable<KeverdVisitorData>;
+    /**
+     * Collect data and send fingerprint request
+     * Uses the web SDK which includes all enhanced signals including FingerprintJS
+     */
+    private collectAndSendFingerprint;
+    /**
+     * Transform API response to visitor data format
+     */
+    private transformResponse;
+    /**
+     * 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>): Observable<void>;
+    /**
+     * End the current session
+     */
+    endSession(): Observable<void>;
+    /**
+     * Pause the current session (e.g., when app goes to background)
+     */
+    pauseSession(): Observable<void>;
+    /**
+     * Resume a paused session (e.g., when app comes to foreground)
+     */
+    resumeSession(): Observable<void>;
+    /**
+     * Get current session status
+     */
+    getSessionStatus(): Observable<{
+        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>;
+    /**
+     * Destroy the SDK instance
+     */
+    destroy(): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): KeverdConfig | null;
+    /**
+     * Check if SDK is initialized
+     */
+    isReady(): boolean;
 }
 
 /**
  * Angular module for Keverd SDK
- * TODO: Implement Angular module
+ * Provides module configuration for easy setup
  */
 
 declare class KeverdModule {
-    static forRoot(config: any): {
-        ngModule: typeof KeverdModule;
-        providers: (typeof KeverdService | {
-            provide: string;
-            useValue: any;
-        })[];
-    };
+    /**
+     * Configure the module with SDK settings
+     * Call this in your app.module.ts imports array
+     *
+     * @example
+     * ```typescript
+     * @NgModule({
+     *   imports: [
+     *     KeverdModule.forRoot({
+     *       apiKey: 'your-api-key',
+     *     })
+     *   ]
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(config: KeverdConfig): ModuleWithProviders<KeverdModule>;
 }
 
-export { type KeverdBehavioralData, type KeverdConfig, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdModule, KeverdService, type KeverdSessionInfo, type KeverdVisitorData, type KeverdVisitorDataOptions, type KeverdVisitorDataResult };
+export { type KeverdBehavioralData, type KeverdConfig, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdModule, KeverdService, type KeverdSessionInfo, type KeverdVisitorData, type KeverdVisitorDataOptions };

package/dist/index.d.ts

@@ -1,60 +1,217 @@
 import { Observable } from 'rxjs';
+import { ModuleWithProviders } from '@angular/core';
 
 /**
- * Types for Angular SDK
- * TODO: Copy and adapt types from React SDK
+ * Keverd Fraud SDK Angular - Type Definitions
  */
-interface KeverdConfig {
-    apiKey: string;
-    endpoint?: string;
-}
-interface KeverdLoadOptions {
-    apiKey: string;
-    endpoint?: string;
+interface KeverdDeviceInfo {
+    deviceId: string;
+    fingerprint: string;
+    manufacturer?: string;
+    model?: string;
+    brand?: string;
+    device?: string;
+    product?: string;
+    hardware?: string;
+    sdkVersion?: string;
+    osVersion?: string;
+    screenWidth?: string;
+    screenHeight?: string;
+    screenDensity?: string;
+    locale?: string;
+    timezone: string;
 }
-interface KeverdVisitorData {
+interface KeverdSessionInfo {
+    sessionId?: string;
+    installId?: string;
+    sessionCount?: string;
+    firstSession?: string;
+    timestamp?: string;
 }
-interface KeverdVisitorDataOptions {
+interface KeverdBehavioralSequence {
+    featureNames: string[];
+    windowSize: number;
+    maskValue: number;
+    sequence: number[][];
 }
-interface KeverdVisitorDataResult {
+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;
+    device: KeverdDeviceInfo;
+    session?: KeverdSessionInfo;
+    behavioral?: KeverdBehavioralData;
+}
+interface KeverdSimSwapEngine {
+    userId?: string;
+    risk: number;
+    flags: {
+        sim_changed?: boolean;
+        device_changed?: boolean;
+        behavior_anomaly?: boolean;
+        time_anomaly?: boolean;
+        velocity_anomaly?: boolean;
+    };
+    updatedProfile?: Record<string, unknown>;
 }
 interface KeverdFingerprintResponse {
+    risk_score: number;
+    score: number;
+    action: 'allow' | 'soft_challenge' | 'hard_challenge' | 'block';
+    reason: string[];
+    session_id: string;
+    requestId: string;
+    sim_swap_engine?: KeverdSimSwapEngine;
 }
-interface KeverdDeviceInfo {
+interface KeverdPrivacySignals {
+    isIncognito?: boolean;
+    isVPN?: boolean;
+    isAutomated?: boolean;
+    hasAdBlocker?: boolean;
 }
-interface KeverdSessionInfo {
+interface KeverdVisitorData {
+    visitorId: string;
+    riskScore: number;
+    score: number;
+    action: 'allow' | 'soft_challenge' | 'hard_challenge' | 'block';
+    reasons: string[];
+    sessionId: string;
+    requestId: string;
+    simSwapEngine?: KeverdSimSwapEngine;
+    confidence?: number;
+    fingerprintjsVisitorId?: string;
+    privacySignals?: KeverdPrivacySignals;
+    deviceMatch?: boolean;
+    fraudProbability?: number;
+    recommendedAction?: string;
 }
-interface KeverdBehavioralData {
+interface KeverdConfig {
+    apiKey: string;
+    userId?: string;
+    debug?: boolean;
+    extendedResult?: boolean;
+    ignoreCache?: boolean;
+}
+interface KeverdLoadOptions {
+    apiKey: string;
+    debug?: boolean;
+}
+interface KeverdVisitorDataOptions {
+    extendedResult?: boolean;
+    ignoreCache?: boolean;
+    tag?: string;
 }
 interface KeverdError {
+    message: string;
+    code?: string;
+    statusCode?: number;
 }
 
 /**
  * Angular service for Keverd SDK
- * TODO: Implement Angular service
+ * Provides RxJS observables for reactive data access
+ * Wraps the web SDK to provide Angular-specific interface with all enhanced signals
  */
 
 declare class KeverdService {
     private config;
+    private isInitialized;
+    constructor(config?: KeverdConfig);
+    /**
+     * Initialize the SDK with configuration
+     * Wraps the web SDK initialization
+     */
     init(config: KeverdConfig): void;
+    /**
+     * Get visitor data (fingerprint and risk assessment)
+     * Returns an RxJS Observable
+     */
     getVisitorData(options?: KeverdVisitorDataOptions): Observable<KeverdVisitorData>;
+    /**
+     * Collect data and send fingerprint request
+     * Uses the web SDK which includes all enhanced signals including FingerprintJS
+     */
+    private collectAndSendFingerprint;
+    /**
+     * Transform API response to visitor data format
+     */
+    private transformResponse;
+    /**
+     * 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>): Observable<void>;
+    /**
+     * End the current session
+     */
+    endSession(): Observable<void>;
+    /**
+     * Pause the current session (e.g., when app goes to background)
+     */
+    pauseSession(): Observable<void>;
+    /**
+     * Resume a paused session (e.g., when app comes to foreground)
+     */
+    resumeSession(): Observable<void>;
+    /**
+     * Get current session status
+     */
+    getSessionStatus(): Observable<{
+        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>;
+    /**
+     * Destroy the SDK instance
+     */
+    destroy(): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): KeverdConfig | null;
+    /**
+     * Check if SDK is initialized
+     */
+    isReady(): boolean;
 }
 
 /**
  * Angular module for Keverd SDK
- * TODO: Implement Angular module
+ * Provides module configuration for easy setup
  */
 
 declare class KeverdModule {
-    static forRoot(config: any): {
-        ngModule: typeof KeverdModule;
-        providers: (typeof KeverdService | {
-            provide: string;
-            useValue: any;
-        })[];
-    };
+    /**
+     * Configure the module with SDK settings
+     * Call this in your app.module.ts imports array
+     *
+     * @example
+     * ```typescript
+     * @NgModule({
+     *   imports: [
+     *     KeverdModule.forRoot({
+     *       apiKey: 'your-api-key',
+     *     })
+     *   ]
+     * })
+     * export class AppModule {}
+     * ```
+     */
+    static forRoot(config: KeverdConfig): ModuleWithProviders<KeverdModule>;
 }
 
-export { type KeverdBehavioralData, type KeverdConfig, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdModule, KeverdService, type KeverdSessionInfo, type KeverdVisitorData, type KeverdVisitorDataOptions, type KeverdVisitorDataResult };
+export { type KeverdBehavioralData, type KeverdConfig, type KeverdDeviceInfo, type KeverdError, type KeverdFingerprintRequest, type KeverdFingerprintResponse, type KeverdLoadOptions, KeverdModule, KeverdService, type KeverdSessionInfo, type KeverdVisitorData, type KeverdVisitorDataOptions };