Esta versão (v0.7) ainda não foi publicada no npm.
Pular para o conteúdo

Perfil e sessões ​

O namespace profile lê e atualiza os dados do jogador logado e lista os dispositivos com sessão aberta. Todos os métodos exigem login: sem sessão (ou se ela não puder ser renovada), rejeitam com UNAUTHENTICATED antes de qualquer chamada. Em testes, o createMockFetch de @getenginex/sdk/testing já responde /me e /me/sessions com dados realistas.

Ler o perfil ​

ts
const me = await enginex.profile.get()
me.displayName // 'Ana Souza'
me.emailVerified // true
me.cpf // '***.456.789-**'

O CPF sempre vem mascarado pelo gateway; o SDK não tem como devolvê-lo completo. Campos sem valor (avatarUrl, phone...) chegam como texto vazio, e createdAt é uma data ISO 8601 em UTC.

Atualizar o perfil ​

Só username e displayName são atualizáveis. Informe ao menos um (o tipo não compila com o objeto vazio); texto vazio é recusado pelo gateway com INVALID_ARGUMENT (400). A resposta é o perfil completo já atualizado:

ts
try {
  const me = await enginex.profile.update({ displayName: 'Ana S.' })
} catch (e) {
  if (isEnginexError(e, 'INVALID_ARGUMENT')) showError(e.message)
  else throw e
}

E-mail, telefone e senha têm fluxos próprios em Cadastro e Senha.

Sessões de login ​

ts
const sessions = await enginex.profile.listSessions()
const others = sessions.filter((s) => !s.current)

await enginex.profile.revokeSession({ sessionId: others[0].id }) // encerra o outro dispositivo

Cada sessão traz id, ip, device (user agent), lastActive e current (a sessão que fez o request).

Estado atual do gateway

Hoje o gateway devolve só a sessão atual (id: 'current'), com lastActive como texto livre ('now'), e DELETE /me/sessions/{id} responde sucesso sem revogar de fato (a gestão de sessões ainda não foi ligada ao serviço de autenticação). O SDK já expõe o contrato final; não trate lastActive como data e não dependa de revokeSession para segurança até o gateway implementar.