Pular para o conteúdo
OwbaseOwbase

Usuários pelo servidor

O serviço Users do @owbase/node administra todos os usuários do projeto com uma chave de API: é o que o seu backend usa para importar contas, montar um painel de suporte ou marcar clientes especiais.

usuarios.ts
import { ID, Query, Users } from '@owbase/node';
import { client } from './client';


// A chave precisa dos escopos users.read e users.write.
const users = new Users(client);


const bia = await users.create({ userId: ID.unique(), email: '[email protected]', password: 'uma-senha-forte', name: 'Bia' });


// Rótulos viram papel nas permissões: Role.label('vip').
await users.updateLabels({ userId: bia.$id, labels: ['vip'] });


// Bloquear (status false) impede novas sessões; true desbloqueia.
await users.updateStatus({ userId: bia.$id, status: false });


const { users: vips } = await users.list({ queries: [Query.contains('labels', ['vip'])] });
console.log(vips.map((u) => u.email));

O que dá para fazer

Seção intitulada “O que dá para fazer”
  • Criar com e-mail e senha, só com e-mail (o usuário entra depois por outro método) ou importar senhas que você já tem em hash (createBcryptUser, createArgon2User e outros).
  • Rótulos (updateLabels): marcas que viram papel nas permissões (Role.label('vip')).
  • Bloquear (updateStatus com false): o usuário não abre novas sessões, e as que ele já tem deixam de valer (todo pedido com elas é recusado).
  • Sessões (listSessions, deleteSessions): ver e encerrar os acessos de alguém.
  • Preferências (getPrefs, updatePrefs): um objeto livre por usuário.

No console, o mesmo fica em Autenticação → Usuários.