Backend e SDK

Database (b77.db)

Collezioni, query e dati per utente.

b77.db è un database documentale senza schema. Le collezioni vengono create automaticamente la prima volta che ci scrivi.

Creare

const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }

Leggere

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 } });

Filtri

where confronta i campi in modo esatto e supporta operatori:

OperatoreEsempio
uguale{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (senza distinzione tra maiuscole e minuscole)

sort accetta il nome di un campo, preceduto da - per l'ordine decrescente (predefinito -createdAt). limit arriva fino a 500, offset serve per la paginazione.

Aggiornare ed eliminare

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);

Dati per utente

I record creati mentre un utente ha effettuato l'accesso ricevono un ownerId. Per leggere solo i record dell'utente corrente usa mine: true:

const myNotes = await b77.db.list('notes', { mine: true });

I record con un proprietario possono essere aggiornati o eliminati solo da quel proprietario.

Regole di accesso

Ogni collezione ha una regola di accesso, verificata sul server. Una collezione senza regola ne riceve una predefinita in base al nome: ciò che le persone ti inviano (orders, bookings, messages…) riceve submit, i contenuti che pubblichi tu (products, menu, posts…) ricevono readonly, leaderboard e guestbook ricevono append, e tutto il resto è private. Puoi cambiare la regola collezione per collezione nella scheda Dati dell'editor, oppure far dichiarare le regole alla tua app in un file b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
RegolaChi può leggereChi può scrivere
publicChiunqueChiunque
authUtenti dell'app che hanno effettuato l'accessoUtenti dell'app che hanno effettuato l'accesso
privateOgni utente vede solo i propri recordSolo il proprietario del record
readonlyChiunqueSolo tu, dalla scheda Dati
submitSolo tu e gli amministratori dell'appChiunque può inviare dati
appendChiunqueChiunque può aggiungere; ognuno modifica o elimina solo i propri record
membersUtenti che hanno effettuato l'accesso e hanno un abbonamento attivoUtenti che hanno effettuato l'accesso e hanno un abbonamento attivo
members-privateOgni abbonato vede solo i propri recordSolo il proprietario del record
teamTu e gli utenti che nomini amministratoriTu e gli utenti che nomini amministratori
directIl mittente, il destinatario e gli amministratori dell'appSolo il mittente può modificare o eliminare un messaggio

Limiti

Record fino a 64 KB ciascuno (per i file usa invece b77.storage.upload). Il numero di record per app dipende dal piano: 2.000 con Free, 20.000 con Starter, 50.000 con Plus, 100.000 con Pro e 200.000 con Elite.