Configuración del proveedor
Opción A: Proveedor + Hook (recomendado)
Envuelve la raíz de tu app con GuardianProvider. Esto inicializa el SDK y lo expone a todos los componentes hijos mediante el hook useGuardian.
App.tsx
import { GuardianProvider } from '@surtai/guardian-rn';
export default function App() {
return (
<GuardianProvider
collectLocation={true}
>
<Navigation />
</GuardianProvider>
);
}
El SDK no maneja ninguna clave de API. El contexto de cliente y de transacción provienen de un JWT de corta duración que genera tu backend. Consulta Verificar transacciones para más detalles.
Props del proveedor
| Prop | Tipo | Predeterminado | Descripción |
|---|---|---|---|
logLevel | 'debug' | 'info' | 'warn' | 'error' | 'none' | 'warn' | Nivel de registro del SDK. Se aplica en iOS. Android lo ignora y registra en el nivel INFO. |
collectLocation | boolean | false | Habilita la recopilación GPS (requiere permisos) |
collectWifiInfo | boolean | false | Habilita los detalles de red WiFi (solo Android) |
collectSimCardInfo | boolean | false | Habilita la información de SIM/operador (solo Android) |
collectCameraInfo | boolean | false | Habilita la cantidad de cámaras (solo Android) |
Opción B: API imperativa
Si prefieres no usar el contexto de React, llama a initialize() directamente al iniciar la app:
index.ts
import { GuardianSDK } from '@surtai/guardian-rn';
GuardianSDK.initialize({
logLevel: 'warn',
collectLocation: true,
});
Hook useGuardian
const {
isInitialized, // boolean - true after SDK is ready
verify, // (jwt: string, options?: VerifyOptions) => Promise<VerificationResult>
collect, // (jwt?: string, options?: VerifyOptions) => Promise<CollectResult>
} = useGuardian();
aviso
useGuardian() debe llamarse dentro de un <GuardianProvider>. Llamarlo fuera lanza un error.
Solución de problemas
| Error | Causa | Solución |
|---|---|---|
verification_failed con not_initialized en el mensaje (iOS) | verify() llamado antes de que el SDK esté listo | Usa GuardianProvider o llama a initialize() al iniciar |
Error del hook useGuardian | Hook usado fuera del proveedor | Envuelve el árbol de componentes con <GuardianProvider> |
verification_failed | La solicitud a Surt falló. Un JWT faltante, malformado o expirado es una de las causas. En Android el mensaje contiene el estado HTTP. | Solicita un JWT nuevo a tu backend para cada llamada y pásalo a verify() |
verify() y collect() rechazan con error.code igual a verification_failed, collect_failed o sdk_error. Consulta Códigos de error para saber cómo leer el detalle.