Backend a SDK

Databáze (b77.db)

Kolekce, dotazy a data jednotlivých uživatelů.

b77.db je dokumentová databáze bez schématu. Kolekce se vytvoří sama, jakmile do ní poprvé zapíšeš.

Vytvoření

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

Čtení

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

Filtry

where porovnává pole přesně a podporuje operátory:

OperátorPříklad
rovná se{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (bez ohledu na velikost písmen)

sort bere název pole; - na začátku znamená sestupné řazení (výchozí -createdAt). limit je nejvýš 500, offset slouží ke stránkování.

Úprava a mazání

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

Data jednotlivých uživatelů

Záznamy vytvořené přihlášeným uživatelem dostanou ownerId. Jen záznamy aktuálního uživatele získáš pomocí mine: true:

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

Záznamy s vlastníkem může upravit nebo smazat jen jejich vlastník.

Pravidla přístupu

Každá kolekce má pravidlo přístupu, které kontroluje server. Kolekce bez pravidla dostane výchozí podle svého názvu: věci, které lidé posílají (orders, bookings, messages…), dostanou submit, obsah, který zveřejňuješ ty (products, menu, posts…), dostane readonly, leaderboard a guestbook dostanou append a všechno ostatní je private. Pravidlo každé kolekce změníš v záložce Data v editoru, nebo ho aplikace může nadefinovat v souboru b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
PravidloKdo může čístKdo může zapisovat
publicKdokoliKdokoli
authPřihlášení uživatelé aplikacePřihlášení uživatelé aplikace
privateKaždý uživatel vidí jen své záznamyJen vlastník záznamu
readonlyKdokoliJen ty, v záložce Data
submitJen ty a správci aplikaceZáznamy může poslat kdokoli
appendKdokoliPřidávat může kdokoli; každý mění nebo maže jen své záznamy
membersPřihlášení uživatelé s aktivním předplatnýmPřihlášení uživatelé s aktivním předplatným
members-privateKaždý předplatitel vidí jen své záznamyJen vlastník záznamu
teamTy a uživatelé, které uděláš správciTy a uživatelé, které uděláš správci
directOdesílatel, příjemce a správci aplikaceZprávu může změnit nebo smazat jen odesílatel

Limity

Záznam může mít nejvýš 64 KB (soubory ukládej přes b77.storage.upload). Počet záznamů v aplikaci závisí na tarifu: Free 2 000, Starter 20 000, Plus 50 000, Pro 100 000 a Elite 200 000.