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érateur | Exemple |
|---|---|
| é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ègle | Qui peut lire | Qui peut écrire |
|---|---|---|
public | Tout le monde | Tout le monde |
auth | Utilisateurs connectés de l'application | Utilisateurs connectés de l'application |
private | Chacun ne voit que ses propres enregistrements | Uniquement le propriétaire de l'enregistrement |
readonly | Tout le monde | Vous seul, depuis l'onglet Données |
submit | Vous et les administrateurs de l'application uniquement | Tout le monde peut envoyer des entrées |
append | Tout le monde | Tout le monde peut ajouter ; chacun ne modifie ou ne supprime que ses propres entrées |
members | Utilisateurs connectés avec un abonnement actif | Utilisateurs connectés avec un abonnement actif |
members-private | Chaque abonné ne voit que ses propres enregistrements | Uniquement le propriétaire de l'enregistrement |
team | Vous et les utilisateurs que vous nommez administrateurs | Vous et les utilisateurs que vous nommez administrateurs |
direct | L'expéditeur, le destinataire et les administrateurs de l'application | Seul 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.