> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Colecciones (base de datos del script)

> Declara colecciones y reglas de acceso, y usa la base de datos dentro de las funciones.

Las colecciones son la base de datos del script. Declaras las colecciones y quién puede leer y escribir en `supabase/collections.json`.

## collections.json

```json theme={null}
{
  "collections": {
    "notas": { "read": "users", "write": "users" },
    "placar": { "read": "public", "write": "owner" }
  }
}
```

| Regla | Quién puede |
| - | - |
| `owner` | Solo el propietario del script (valor predeterminado si no lo especificas) |
| `users` | Cualquier persona que haya iniciado sesión en DoglyTdc |
| `public` | Cualquier persona, incluso sin iniciar sesión |

Límites: hasta 20 colecciones; nombre con letras minúsculas, números, `_` y `-`, hasta 40 caracteres. El archivo se lee cuando se publica el backend. Si tiene un error, se conservan las colecciones anteriores y el error aparece en el resumen de la publicación.

## Usar dentro de la función

```js theme={null}
function handler(request) {
  const notas = doglytdc.db.collection("notas");
  const nova = notas.insert({ texto: "Oi" });
  const lista = notas.list({ limit: 20, order: "desc", where: { texto: "Oi" } });
  const total = notas.count({ texto: "Oi" });
  return doglytdc.respond(200, { nova, lista, total });
}
```

| Método | Qué hace |
| - | - |
| `get(id)` | Un documento, o `null` |
| `list({ limit, offset, order, where })` | Lista. `limit` de 1 a 100 (predeterminado: 20), `offset` hasta 10.000, `order` `asc` o `desc` (predeterminado: `desc`, por fecha de creación), `where` con hasta 10 campos de igualdad |
| `count(where)` | Cuántos documentos |
| `insert(data)` | Crea un documento |
| `update(id, data)` | Reemplaza los datos |
| `delete(id)` | Elimina |

## Formato del documento

```json theme={null}
{
  "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
  "data": { "texto": "Oi" },
  "created_at": "2026-11-06T12:00:00Z",
  "updated_at": "2026-11-06T12:00:00Z",
  "mine": true
}
```

`mine` indica si quien hizo la llamada creó el documento. El documento nunca muestra quién lo creó.

## Reglas importantes

* El documento debe ser un objeto y tener hasta **64 KB**.
* Hasta **10.000 documentos** por colección.
* `update` y `delete` solo funcionan para **quien creó el documento** o para el propietario del script, aunque la regla de escritura sea `users` o `public`.

Errores posibles: "La colección … no existe en supabase/collections.json.", "Sin permiso para leer/escribir en …", "Documento no encontrado.", "Documento demasiado grande (máx. 64 KB).", "Límite de 10000 documentos por colección.", "Solo quien creó el documento (o el propietario del script) puede modificarlo."

## Mediante la API

Las mismas colecciones y las mismas reglas se aplican en la API: consulta [Colecciones y documentos](https://docs.doglytdc.dev/es/scripts/api-reference/collections.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.