Base de dades (b77.db)
Col·leccions, consultes i dades per usuari.
b77.db és una base de dades documental sense esquema. Les col·leccions es creen automàticament la primera vegada que hi escrius.
Crear
const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }Llegir
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 } });Filtres
where compara camps de manera exacta i admet operadors:
| Operador | Exemple |
|---|---|
| igual | { status: 'paid' } |
$ne | { status: { $ne: 'draft' } } |
$in | { status: { $in: ['sent', 'paid'] } } |
$gt / $gte / $lt / $lte | { total: { $gte: 100 } } |
$contains | { name: { $contains: 'ann' } } (sense distingir majúscules) |
sort rep un nom de camp, amb - al davant per a ordre descendent (per defecte -createdAt). limit arriba fins a 500 i offset serveix per paginar.
Actualitzar i esborrar
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);Dades per usuari
Els registres creats mentre un usuari té la sessió iniciada reben un ownerId. Per consultar només els registres de l'usuari actual, fes servir mine: true:
const myNotes = await b77.db.list('notes', { mine: true });Els registres amb propietari només els pot actualitzar o esborrar aquest propietari.
Regles d'accés
Cada col·lecció té una regla d'accés que es comprova al servidor. Si una col·lecció no en té, rep una regla per defecte segons el nom: el que t'envia la gent (orders, bookings, messages…) rep submit; el contingut que publiques (products, menu, posts…) rep readonly; leaderboard i guestbook reben append, i tota la resta és private. Pots canviar la regla de cada col·lecció a la pestanya Dades de l'editor, o deixar que la teva app declari les regles en un fitxer b77.config.json:
{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }| Regla | Qui pot llegir | Qui pot escriure |
|---|---|---|
public | Tothom | Tothom |
auth | Usuaris de l'app amb sessió iniciada | Usuaris de l'app amb sessió iniciada |
private | Cada usuari només veu els seus registres | Només el propietari del registre |
readonly | Tothom | Només tu, des de la pestanya Dades |
submit | Només tu i els administradors de l'app | Tothom pot enviar entrades |
append | Tothom | Tothom pot afegir-ne; cadascú només canvia o esborra les seves |
members | Usuaris amb sessió iniciada i una subscripció activa | Usuaris amb sessió iniciada i una subscripció activa |
members-private | Cada subscriptor només veu els seus registres | Només el propietari del registre |
team | Tu i els usuaris que facis administradors | Tu i els usuaris que facis administradors |
direct | El remitent, el destinatari i els administradors de l'app | Només el remitent pot canviar o esborrar un missatge |
Límits
Registres de fins a 64 KB cadascun (per als fitxers, fes servir b77.storage.upload). El nombre de registres per app depèn del pla: 2.000 amb Free, 20.000 amb Starter, 50.000 amb Plus, 100.000 amb Pro i 200.000 amb Elite.