Backend y SDK

Base de datos (b77.db)

Colecciones, consultas y datos por usuario.

b77.db es una base de datos documental sin esquema. Las colecciones se crean automáticamente la primera vez que escribes en ellas.

Crear

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

Leer

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

Filtros

where compara campos de forma exacta y admite operadores:

OperadorEjemplo
igual{ status: 'paid' }
$ne{ status: { $ne: 'draft' } }
$in{ status: { $in: ['sent', 'paid'] } }
$gt / $gte / $lt / $lte{ total: { $gte: 100 } }
$contains{ name: { $contains: 'ann' } } (sin distinguir mayúsculas)

sort recibe un nombre de campo, con - delante para orden descendente (por defecto -createdAt). limit llega hasta 500 y offset sirve para paginar.

Actualizar y borrar

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

Datos por usuario

Los registros creados mientras un usuario tiene la sesión iniciada reciben un ownerId. Consulta solo los registros del usuario actual con mine: true:

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

Los registros con propietario solo puede actualizarlos o borrarlos ese propietario.

Reglas de acceso

Cada colección tiene una regla de acceso que se comprueba en el servidor. Si una colección no la tiene, recibe una por defecto según su nombre: lo que la gente envía (orders, bookings, messages…) recibe submit; el contenido que publicas tú (products, menu, posts…), readonly; leaderboard y guestbook, append, y todo lo demás es private. Cambia la regla de cada colección en la pestaña Datos del editor, o deja que tu app declare las reglas en un archivo b77.config.json:

{ "rules": { "notes": "private", "menu": "readonly", "orders": "auth" } }
ReglaQuién puede leerQuién puede escribir
publicCualquieraCualquiera
authUsuarios de la app con sesión iniciadaUsuarios de la app con sesión iniciada
privateCada usuario ve solo sus registrosSolo el propietario del registro
readonlyCualquieraSolo tú, desde la pestaña Datos
submitSolo tú y los administradores de la appCualquiera puede enviar entradas
appendCualquieraCualquiera puede añadir; cada uno cambia o borra solo las suyas
membersUsuarios con sesión iniciada y suscripción activaUsuarios con sesión iniciada y suscripción activa
members-privateCada suscriptor ve solo sus registrosSolo el propietario del registro
teamTú y los usuarios que hagas administradoresTú y los usuarios que hagas administradores
directEl remitente, el destinatario y los administradores de la appSolo el remitente puede cambiar o borrar un mensaje

Límites

Registros de hasta 64 KB cada uno (para los archivos, usa b77.storage.upload). El número de registros por app depende de tu plan: 2000 en Free, 20.000 en Starter, 50.000 en Plus, 100.000 en Pro y 200.000 en Elite.