База даних (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.