Login e 2FA
Carregando a demo interativa…
A demo acima roda o SDK de verdade (createEnginexClient) com fetch: createMockFetch(...) de @getenginex/sdk/testing: nenhuma chamada sai para a rede. Troque o cenário para ver o passo de 2FA e o erro INVALID_CREDENTIALS. O painel Under the hood mostra a chamada feita (senhas e tokens mascarados), os requests vistos pelos hooks, o resultado ou o EnginexError e a sessão. O código abaixo é o equivalente para o seu app.
let result = await enginex.auth.login({ email, password }) // or { cpf, password }
if (result.status === '2fa_required') {
const twoFactorCode = await askUserFor2faCode()
result = await enginex.auth.login({ email, password, twoFactorCode })
}
// result.status === 'authenticated'Se já houver alguém logado e um login de outra conta devolver 2fa_required, a sessão atual continua ativa até o login com twoFactorCode concluir. Para trocar de conta de forma limpa, chame enginex.auth.logout() antes.
Ativar 2FA para o jogador logado
const { qrCode, backupCodes } = await enginex.auth.enable2fa()
// show the QR (qrCode is an otpauth:// URL) and the recovery codes
await enginex.auth.verify2fa({ twoFactorCode: firstCodeFromApp })Desativar: await enginex.auth.disable2fa({ twoFactorCode, password }).
Sair
await enginex.auth.logout() // never throws; the local session is always clearedO logout manda o access token atual como está (não renova a sessão antes) e nunca dispara onSessionExpired. Também manda o refresh token guardado no corpo, para o gateway revogá-lo: uma cópia dele não renova a sessão depois do logout. A rota de logout exige um access token válido; com um expirado, o gateway recusa a chamada antes de revogar, e o logout então renova uma vez, sem guardar os tokens novos, e revoga o refresh token renovado. Se a renovação ou o request falhar, a sessão local é limpa do mesmo jeito, mas o refresh token pode continuar válido no servidor até expirar.