Package Exports

usiv-sdk-react
usiv-sdk-react/dist/index.esm.js
usiv-sdk-react/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (usiv-sdk-react) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

Liveness Detection (100 créditos)
Documento Frontal (100 créditos)
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