O objeto `api.account`

O objeto api.account apresenta métodos para lidar com autenticação.

Métodos

• user() : Undefined | Boolean | User - Retorna o usuário atual. Assim que a biblioteca é carregada pelo navegador, o valor que este método retorna é undefined. Assim que a verificação do usuário é feita, o método retorna falseou uma instância de User.

• createWithEmailAndPassword(email, password) : BluebirdPromise -> Null | User - Cria um usuário usando e-mail e senha. Se o usuário não foi criado por alguma falha interna, null é resolvido pela Promise.

• signInWithEmailAndPassword(email, password) : BluebirdPromise -> Null | User - Autentica o usuário usando e-mail e senha. A promessa quando resolvida retorna os dados do usuários armazenados ou null caso não tenha sido encontrado. É recomendado o uso de onAuthStateChanged para verificar as mudanças no estado de autenticação do usuário.

• signOut() : BluebirdPromise - Retira a autenticação do usuário atual.

• onAuthStateChanged(callback) - Adiciona um listener que é executado sempre que o estado de autenticação do usuário mudar. O callback sempre que executado recebe um argumento user, que pode ser null, caso o usuário tenha saído ou não esteja autenticado, e uma instância de User se o usuário estiver autenticado.

• updateUserState() : BluebirdPromise - Sincroniza o estado do usuário autenticado atual do cliente com sua situação no servidor.

Configurações

É possível atribuir configurações criando o arquivo users.js na pasta store na raiz da aplicação. Veja a documentação "O objeto api.store", já que esse arquivo segue o mesmo padrão.

Exemplos

// Indicar se o usuário está, ou não, autenticado. Sempre que o usuário mudar de estado,
// a mensagem no elemento referenciado por "indicatorNode" será alterada.

api.account.onAuthStateChanged(user => {
  indicatorNode.innerHTML = user
    ? `Bem-vindo de volta, ${user.get('name')}`
    : 'Você não está autenticado!'
})