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:
| Operatore | Esempio |
|---|---|
| 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" } }| Regola | Chi può leggere | Chi può scrivere |
|---|---|---|
public | Chiunque | Chiunque |
auth | Utenti dell'app che hanno effettuato l'accesso | Utenti dell'app che hanno effettuato l'accesso |
private | Ogni utente vede solo i propri record | Solo il proprietario del record |
readonly | Chiunque | Solo tu, dalla scheda Dati |
submit | Solo tu e gli amministratori dell'app | Chiunque può inviare dati |
append | Chiunque | Chiunque può aggiungere; ognuno modifica o elimina solo i propri record |
members | Utenti che hanno effettuato l'accesso e hanno un abbonamento attivo | Utenti che hanno effettuato l'accesso e hanno un abbonamento attivo |
members-private | Ogni abbonato vede solo i propri record | Solo il proprietario del record |
team | Tu e gli utenti che nomini amministratori | Tu e gli utenti che nomini amministratori |
direct | Il mittente, il destinatario e gli amministratori dell'app | Solo 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.