Backend i SDK

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:

OperadorExemple
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" } }
ReglaQui pot llegirQui pot escriure
publicTothomTothom
authUsuaris de l'app amb sessió iniciadaUsuaris de l'app amb sessió iniciada
privateCada usuari només veu els seus registresNomés el propietari del registre
readonlyTothomNomés tu, des de la pestanya Dades
submitNomés tu i els administradors de l'appTothom pot enviar entrades
appendTothomTothom pot afegir-ne; cadascú només canvia o esborra les seves
membersUsuaris amb sessió iniciada i una subscripció activaUsuaris amb sessió iniciada i una subscripció activa
members-privateCada subscriptor només veu els seus registresNomés el propietari del registre
teamTu i els usuaris que facis administradorsTu i els usuaris que facis administradors
directEl remitent, el destinatari i els administradors de l'appNomé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.