Backend e SDK

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:

OperadorExemplo
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" } }
RegraQuem pode lerQuem pode escrever
publicQualquer pessoaQualquer pessoa
authUtilizadores da app com sessão iniciadaUtilizadores da app com sessão iniciada
privateCada utilizador vê apenas os seus registosApenas o dono do registo
readonlyQualquer pessoaApenas você, no separador Dados
submitApenas você e os administradores da appQualquer pessoa pode enviar entradas
appendQualquer pessoaQualquer pessoa pode acrescentar; cada um só altera ou apaga o que é seu
membersUtilizadores com sessão iniciada e uma subscrição ativaUtilizadores com sessão iniciada e uma subscrição ativa
members-privateCada subscritor vê apenas os seus registosApenas o dono do registo
teamVocê e os utilizadores que tornar administradoresVocê e os utilizadores que tornar administradores
directO remetente, o destinatário e os administradores da appSó 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.