Inicio de sesión y 2FA
Cargando la demo interactiva…
La demo de arriba ejecuta el SDK real (createEnginexClient) con fetch: createMockFetch(...) de @getenginex/sdk/testing: ninguna llamada sale a la red. Cambia el escenario para ver el paso de 2FA y el error INVALID_CREDENTIALS. El panel Under the hood muestra la llamada realizada (contraseñas y tokens enmascarados), los requests vistos por los hooks, el resultado o el EnginexError y la sesión. El código de abajo es el equivalente para tu 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'Si ya hay alguien con sesión iniciada y un inicio de sesión de otra cuenta devuelve 2fa_required, la sesión actual sigue activa hasta que el inicio de sesión con twoFactorCode se complete. Para cambiar de cuenta de forma limpia, llama a enginex.auth.logout() antes.
Activar 2FA para el jugador con sesión iniciada
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 })Desactivar: await enginex.auth.disable2fa({ twoFactorCode, password }).
Cerrar sesión
await enginex.auth.logout() // never throws; the local session is always clearedEl cierre de sesión envía el access token actual tal como está (no renueva la sesión antes) y nunca dispara onSessionExpired. También envía el refresh token guardado en el cuerpo, para que el gateway lo revoque: una copia de él no renueva la sesión después del cierre. La ruta de cierre exige un access token válido; con uno expirado, el gateway rechaza la llamada antes de revocar, y el cierre renueva entonces una vez, sin guardar los tokens nuevos, y revoca el refresh token renovado. Si la renovación o el request fallan, la sesión local se limpia igualmente, pero el refresh token puede seguir válido en el servidor hasta expirar.