@usiv/sdk-react

SDK de verificación biométrica para React - USIV

Instalación

npm install @usiv/sdk-react

Uso Básico

import { UsivVerificationWizard } from '@usiv/sdk-react';

function App() {
  return (
    <UsivVerificationWizard 
      sessionToken="tu-jwt-token-aqui"
      onComplete={(result) => console.log('Verificación completada:', result)}
      onError={(error) => console.error('Error:', error)}
    />
  );
}

Configuración de Ambientes

El SDK detecta automáticamente el ambiente:

• Desarrollo: localhost → URL de desarrollo
• Staging: Dominios con "staging" → URL de staging
• Producción: Cualquier otro dominio → URL de producción

Configuración Manual

// Forzar ambiente específico
<UsivVerificationWizard 
  sessionToken="token"
  environment="staging"
/>

// URL personalizada
<UsivVerificationWizard 
  sessionToken="token"
  apiUrl="https://mi-api-custom.com"
/>

// Configuración avanzada
<UsivVerificationWizard 
  sessionToken="token"
  config={{
    timeout: 60000,
    retryAttempts: 5,
    debug: true
  }}
/>

Props

| Prop | Tipo | Descripción | |------|------|-------------| | sessionToken | string | Requerido - JWT token para autenticación | | environment | 'development' | 'staging' | 'production' | Ambiente específico (opcional) | | apiUrl | string | URL personalizada para override (opcional) | | config | Partial<UsivConfig> | Configuración avanzada (opcional) | | onComplete | (result: VerificationResult) => void | Callback cuando la verificación se completa | | onError | (error: UsivError) => void | Callback cuando ocurre un error | | onStepComplete | (step: VerificationStep, result: any) => void | Callback cuando se completa cada paso | | onCreditUpdate | (credits: number) => void | Callback cuando se actualizan créditos | | showDebugInfo | boolean | Mostrar información de debug en consola |

Flujo de Verificación

1. Liveness Detection (100 créditos)
2. Documento Frontal (100 créditos)
3. Documento Trasero (100 créditos)

Total: 300 créditos por verificación completa

Tipos de Error

interface UsivError {
  type: 'authentication_error' | 'network_error' | 'verification_error' | 'credit_error';
  message: string;
  details?: any;
}

Requisitos

• React >= 16.8.0
• Node.js >= 14.0.0

Licencia

MIT