Backend & SDK

Datenbank (b77.db)

Collections, Abfragen und Daten pro Nutzer.

b77.db ist eine schemalose Dokumentdatenbank. Collections werden automatisch angelegt, sobald du zum ersten Mal hineinschreibst.

Anlegen

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

Lesen

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

Filter

where vergleicht Felder exakt und unterstützt Operatoren:

OperatorBeispiel
gleich{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (ohne Groß-/Kleinschreibung)

sort erwartet einen Feldnamen; ein - davor sortiert absteigend (Standard: -createdAt). limit geht bis 500, mit offset blätterst du weiter.

Aktualisieren & löschen

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

Daten pro Nutzer

Datensätze, die angelegt werden, während ein Nutzer angemeldet ist, bekommen eine ownerId. Mit mine: true fragst du nur die Datensätze des aktuellen Nutzers ab:

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

Datensätze mit Besitzer kann nur dieser Besitzer ändern oder löschen.

Zugriffsregeln

Jede Collection hat eine Zugriffsregel, die auf dem Server geprüft wird. Hat eine Collection keine, bekommt sie anhand ihres Namens eine Standardregel: Was Leute einsenden (orders, bookings, messages…), bekommt submit, Inhalte, die du veröffentlichst (products, menu, posts…), bekommen readonly, leaderboard und guestbook bekommen append, und alles andere ist private. Ändern kannst du die Regel pro Collection im Tab Daten des Builders, oder deine App legt die Regeln in einer Datei b77.config.json fest:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
RegelWer lesen darfWer schreiben darf
publicAlleAlle
authAngemeldete App-NutzerAngemeldete App-Nutzer
privateJeder Nutzer sieht nur seine eigenen DatensätzeNur der Besitzer des Datensatzes
readonlyAlleNur du, im Tab Daten
submitNur du und die Admins der AppAlle können Einträge senden
appendAlleAlle können etwas hinzufügen; jeder ändert oder löscht nur die eigenen Einträge
membersAngemeldete Nutzer mit aktivem AboAngemeldete Nutzer mit aktivem Abo
members-privateJeder Abonnent sieht nur seine eigenen DatensätzeNur der Besitzer des Datensatzes
teamDu und die Nutzer, die du zu Admins machstDu und die Nutzer, die du zu Admins machst
directAbsender, Empfänger und die Admins der AppNur der Absender kann eine Nachricht ändern oder löschen

Limits

Ein Datensatz darf bis zu 64 KB groß sein (Dateien speicherst du stattdessen mit b77.storage.upload). Wie viele Datensätze eine App haben kann, hängt vom Tarif ab: 2.000 im Free-Tarif, 20.000 bei Starter, 50.000 bei Plus, 100.000 bei Pro und 200.000 bei Elite.