Backend a SDK

Databáza (b77.db)

Kolekcie, dopyty a dáta jednotlivých používateľov.

b77.db je dokumentová databáza bez schémy. Kolekcie sa vytvoria automaticky, keď do nich prvýkrát zapíšeš.

Vytvorenie

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

Čítanie

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

Filtre

where porovnáva polia presne a podporuje operátory:

OperátorPríklad
rovná sa{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (bez ohľadu na veľkosť písmen)

sort prijíma názov poľa, s - na začiatku pre zostupné radenie (predvolene -createdAt). limit je najviac 500, offset stránkuje.

Úprava a mazanie

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

Dáta jednotlivých používateľov

Záznamy vytvorené, keď je používateľ prihlásený, dostanú ownerId. Iba záznamy aktuálneho používateľa získaš pomocou mine: true:

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

Záznamy s vlastníkom môže upraviť alebo vymazať iba ich vlastník.

Pravidlá prístupu

Každá kolekcia má pravidlo prístupu, ktoré kontroluje server. Kolekcia bez pravidla dostane predvolené pravidlo podľa svojho názvu: veci, ktoré ľudia posielajú (orders, bookings, messages…), dostanú submit, obsah, ktorý zverejňuješ ty (products, menu, posts…), dostane readonly, leaderboard a guestbook dostanú append a všetko ostatné je private. Pravidlo zmeníš pre každú kolekciu zvlášť na karte Dáta v editore, alebo ho aplikácia môže deklarovať v súbore b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
PravidloKto môže čítaťKto môže zapisovať
publicKtokoľvekKtokoľvek
authPrihlásení používatelia aplikáciePrihlásení používatelia aplikácie
privateKaždý používateľ vidí iba svoje záznamyIba vlastník záznamu
readonlyKtokoľvekIba ty, z karty Dáta
submitIba ty a správcovia aplikácieZáznamy môže posielať ktokoľvek
appendKtokoľvekPridávať môže ktokoľvek; každý mení alebo maže iba svoje
membersPrihlásení používatelia s aktívnym predplatnýmPrihlásení používatelia s aktívnym predplatným
members-privateKaždý predplatiteľ vidí iba svoje záznamyIba vlastník záznamu
teamTy a používatelia, ktorých urobíš správcamiTy a používatelia, ktorých urobíš správcami
directOdosielateľ, príjemca a správcovia aplikácieSprávu môže zmeniť alebo vymazať iba odosielateľ

Limity

Jeden záznam môže mať najviac 64 KB (súbory ukladaj radšej cez b77.storage.upload). Počet záznamov na aplikáciu závisí od plánu: Free 2 000, Starter 20 000, Plus 50 000, Pro 100 000 a Elite 200 000.