База данных (b77.db)
Коллекции, запросы и данные каждого пользователя.
b77.db — документная база данных без схемы. Коллекции создаются автоматически при первой записи.
Создание
const task = await b77.db.create('tasks', { title: 'Ship v2', done: false, priority: 2 });
// → { id, title, done, priority, createdAt, updatedAt, ownerId }Чтение
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 } });Фильтры
where сравнивает поля на точное совпадение и поддерживает операторы:
| Оператор | Пример |
|---|---|
| равно | { status: 'paid' } |
$ne | { status: { $ne: 'draft' } } |
$in | { status: { $in: ['sent', 'paid'] } } |
$gt / $gte / $lt / $lte | { total: { $gte: 100 } } |
$contains | { name: { $contains: 'ann' } } (без учёта регистра) |
sort принимает имя поля, а - перед ним означает сортировку по убыванию (по умолчанию -createdAt). limit не больше 500, а offset нужен для постраничного вывода.
Обновление и удаление
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);Данные каждого пользователя
Записи, созданные вошедшим пользователем, получают ownerId. Чтобы получить только записи текущего пользователя, передайте mine: true:
const myNotes = await b77.db.list('notes', { mine: true });Записи с владельцем может изменить или удалить только их владелец.
Правила доступа
У каждой коллекции есть правило доступа, и проверяется оно на сервере. Если правило не задано, оно выбирается по названию коллекции: то, что присылают люди (orders, bookings, messages…), получает submit, контент, который публикуете вы (products, menu, posts…), получает readonly, leaderboard и guestbook получают append, а всё остальное получает private. Правило для каждой коллекции можно поменять на вкладке Данные в конструкторе или задать в файле b77.config.json приложения:
{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }| Правило | Кто может читать | Кто может записывать |
|---|---|---|
public | Кто угодно | Кто угодно |
auth | Авторизованные пользователи приложения | Авторизованные пользователи приложения |
private | Каждый видит только свои записи | Только владелец записи |
readonly | Кто угодно | Только вы, на вкладке «Данные» |
submit | Только вы и администраторы приложения | Отправлять записи может кто угодно |
append | Кто угодно | Добавлять может кто угодно; каждый меняет или удаляет только свои записи |
members | Вошедшие пользователи с активной подпиской | Вошедшие пользователи с активной подпиской |
members-private | Каждый подписчик видит только свои записи | Только владелец записи |
team | Вы и пользователи, которых вы сделали администраторами | Вы и пользователи, которых вы сделали администраторами |
direct | Отправитель, получатель и администраторы приложения | Изменить или удалить сообщение может только отправитель |
Ограничения
Каждая запись занимает до 64 КБ (файлы храните через b77.storage.upload). Сколько записей может быть в приложении, зависит от тарифа: 2 000 на Free, 20 000 на Starter, 50 000 на Plus, 100 000 на Pro и 200 000 на Elite.