Base de dados (b77.db)
Coleções, consultas e dados por utilizador.
b77.db é uma base de dados de documentos sem esquema. As coleções são criadas automaticamente na primeira vez que escreve nelas.
Criar
const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }Ler
const all = await b77.db.list('tasks');
const open = await b77.db.list('tasks', { where: { done: false }, sort: '-priority', limit: 50 });
const one = await b77.db.get('tasks', id); // null if missing
const count = await b77.db.count('tasks', { where: { done: true } });Filtros
where compara campos de forma exata e aceita operadores:
| Operador | Exemplo |
|---|---|
| igual | { status: 'paid' } |
$ne | { status: { $ne: 'draft' } } |
$in | { status: { $in: ['sent', 'paid'] } } |
$gt / $gte / $lt / $lte | { total: { $gte: 100 } } |
$contains | { name: { $contains: 'ann' } } (sem distinguir maiúsculas) |
sort recebe um nome de campo, com - antes para ordem decrescente (predefinição -createdAt). limit vai até 500 e offset serve para paginar.
Atualizar e apagar
await b77.db.update('tasks', id, { done: true }); // shallow merge
await b77.db.replace('tasks', id, { title: 'New' }); // overwrite all fields
await b77.db.remove('tasks', id);Dados por utilizador
Os registos criados enquanto um utilizador tem sessão iniciada recebem um ownerId. Para consultar só os registos do utilizador atual, use mine: true:
const myNotes = await b77.db.list('notes', { mine: true });Os registos com dono só podem ser atualizados ou apagados por esse dono.
Regras de acesso
Cada coleção tem uma regra de acesso, verificada no servidor. Uma coleção sem regra recebe uma predefinida conforme o nome: o que as pessoas enviam (orders, bookings, messages…) fica com submit, o conteúdo que publica (products, menu, posts…) fica com readonly, leaderboard e guestbook ficam com append, e tudo o resto fica private. Pode mudar a regra de cada coleção no separador Dados do editor, ou deixar que a app declare as regras num ficheiro b77.config.json:
{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }| Regra | Quem pode ler | Quem pode escrever |
|---|---|---|
public | Qualquer pessoa | Qualquer pessoa |
auth | Utilizadores da app com sessão iniciada | Utilizadores da app com sessão iniciada |
private | Cada utilizador vê apenas os seus registos | Apenas o dono do registo |
readonly | Qualquer pessoa | Apenas você, no separador Dados |
submit | Apenas você e os administradores da app | Qualquer pessoa pode enviar entradas |
append | Qualquer pessoa | Qualquer pessoa pode acrescentar; cada um só altera ou apaga o que é seu |
members | Utilizadores com sessão iniciada e uma subscrição ativa | Utilizadores com sessão iniciada e uma subscrição ativa |
members-private | Cada subscritor vê apenas os seus registos | Apenas o dono do registo |
team | Você e os utilizadores que tornar administradores | Você e os utilizadores que tornar administradores |
direct | O remetente, o destinatário e os administradores da app | Só o remetente pode alterar ou apagar uma mensagem |
Limites
Registos até 64 KB cada (para ficheiros, use b77.storage.upload). O número de registos por app depende do plano: 2000 no Free, 20 000 no Starter, 50 000 no Plus, 100 000 no Pro e 200 000 no Elite.