React Hook API

useWaspada(config, callbacks?)

React hook that manages the full SDK lifecycle.

Parameters

Parameter	Type	Description
config	WaspadaSdkConfig	SDK configuration
callbacks.onThreatDetected	(result, metrics) => void	Threat found
callbacks.onClean	(result, metrics) => void	No threats
callbacks.onError	(error) => void	Error occurred

Returns UseWaspadaReturn

interface UseWaspadaReturn {
  state: ScannerState;
  initStatus: InitStatus | null;
  lastResult: ExtractionResult | null;
  lastMetrics: ScanMetrics | null;
  version: string;
  warnings: string[];
  error: string | null;
  processFile: (file: File) => Promise<void>;
  reset: () => void;
}

ScanMetrics

interface ScanMetrics {
  latencyMs: number;
  extractionTier: string;
  confidence: number;
  piiClean: boolean;
  documentType: string;
  timestamp: string;
}

ScannerState

type ScannerState =
  | 'IDLE'
  | 'LOADING_MODELS'
  | 'READY'
  | 'SCANNING'
  | 'THREAT_DETECTED'
  | 'CLEAN'
  | 'ERROR';