Configuração do Provider
Opção A: Provider + Hook (Recomendado)
Envolva a raiz do seu app com GuardianProvider. Isso inicializa o SDK e o expõe a todos os componentes filhos pelo hook useGuardian.
App.tsx
import { GuardianProvider } from '@surtai/guardian-rn';
export default function App() {
return (
<GuardianProvider
collectLocation={true}
>
<Navigation />
</GuardianProvider>
);
}
O SDK não guarda uma chave de API. O contexto de cliente e transação vem de um JWT de curta duração que seu backend gera. Veja Verificar Transações para mais detalhes.
Props do Provider
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
logLevel | 'debug' | 'info' | 'warn' | 'error' | 'none' | 'warn' | Nível de detalhe dos logs do SDK. Aplicado no iOS. O Android o ignora e registra logs no nível INFO. |
collectLocation | boolean | false | Habilita a coleta de GPS (requer permissões) |
collectWifiInfo | boolean | false | Habilita os detalhes da rede WiFi (somente Android) |
collectSimCardInfo | boolean | false | Habilita as informações de SIM/operadora (somente Android) |
collectCameraInfo | boolean | false | Habilita a quantidade de câmeras (somente Android) |
Opção B: API Imperativa
Se você preferir não usar o contexto do React, chame initialize() diretamente na inicialização do 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() deve ser chamado dentro de um <GuardianProvider>. Chamá-lo fora lança um erro.
Solução de Problemas
| Erro | Causa | Solução |
|---|---|---|
verification_failed com not_initialized na mensagem (iOS) | verify() chamado antes de o SDK estar pronto | Use GuardianProvider ou chame initialize() na inicialização |
Erro do hook useGuardian | Hook usado fora do provider | Envolva a árvore de componentes com <GuardianProvider> |
verification_failed | A requisição à Surt falhou. Um JWT ausente, malformado ou expirado é uma das causas. No Android, a mensagem contém o status HTTP. | Solicite um novo JWT ao seu backend para cada chamada e passe-o para verify() |
verify() e collect() rejeitam com error.code definido como verification_failed, collect_failed ou sdk_error. Veja Códigos de Erro para saber como ler o detalhe.