Backend et SDK

Base de données (b77.db)

Collections, requêtes et données par utilisateur.

b77.db est une base de données documentaire sans schéma. Les collections sont créées automatiquement la première fois que vous y écrivez.

Créer

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

Lire

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

Filtres

where compare les champs à l'identique et prend en charge des opérateurs :

OpérateurExemple
égal{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (insensible à la casse)

sort prend un nom de champ, précédé de - pour l'ordre décroissant (par défaut -createdAt). limit va jusqu'à 500, offset sert à paginer.

Modifier et supprimer

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

Données par utilisateur

Les enregistrements créés pendant qu'un utilisateur est connecté reçoivent un ownerId. Interrogez uniquement les enregistrements de l'utilisateur actuel avec mine: true :

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

Un enregistrement qui a un propriétaire ne peut être modifié ou supprimé que par lui.

Règles d'accès

Chaque collection a une règle d'accès, vérifiée sur le serveur. Une collection qui n'en a pas reçoit une règle par défaut selon son nom : ce que les gens envoient (orders, bookings, messages…) reçoit submit, le contenu que vous publiez (products, menu, posts…) reçoit readonly, leaderboard et guestbook reçoivent append, et tout le reste est private. Changez la règle collection par collection dans l'onglet Données de l'outil de création, ou laissez votre application déclarer ses règles dans un fichier b77.config.json :

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
RègleQui peut lireQui peut écrire
publicTout le mondeTout le monde
authUtilisateurs connectés de l'applicationUtilisateurs connectés de l'application
privateChacun ne voit que ses propres enregistrementsUniquement le propriétaire de l'enregistrement
readonlyTout le mondeVous seul, depuis l'onglet Données
submitVous et les administrateurs de l'application uniquementTout le monde peut envoyer des entrées
appendTout le mondeTout le monde peut ajouter ; chacun ne modifie ou ne supprime que ses propres entrées
membersUtilisateurs connectés avec un abonnement actifUtilisateurs connectés avec un abonnement actif
members-privateChaque abonné ne voit que ses propres enregistrementsUniquement le propriétaire de l'enregistrement
teamVous et les utilisateurs que vous nommez administrateursVous et les utilisateurs que vous nommez administrateurs
directL'expéditeur, le destinataire et les administrateurs de l'applicationSeul l'expéditeur peut modifier ou supprimer un message

Limites

Jusqu'à 64 Ko par enregistrement (pour les fichiers, utilisez plutôt b77.storage.upload). Le nombre d'enregistrements par application dépend de votre forfait : 2 000 avec Gratuit, 20 000 avec Starter, 50 000 avec Plus, 100 000 avec Pro et 200 000 avec Elite.