> ## 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.

# Servidor por script

> Tablas tipadas, endpoints y publicación explícita mediante el Panel Dev o MCP.

El **Servidor** mantiene separados los datos y endpoints de cada script. Solo el dueño administra esta sección. Las tablas son lógicas y tipadas, persistidas en PostgreSQL; no son proyectos Supabase independientes.

## Preparar y publicar

1. Abre **Panel Dev → Servidor → Vista general → Preparar servidor**.
2. Crea columnas, tipos y permisos en **Tablas**. Define método, ruta, entrada y handler en **Endpoints**.
3. **Guardar archivo** modifica el repositorio, pero no activa el servidor. Valida y revisa los cambios.
4. Elige **Publicar servidor** y confirma. Los recursos públicos podrán usarse sin iniciar sesión.
5. Prueba el endpoint con una entrada real y consulta el registro guardado en su tabla.

Mediante MCP, usa `server_get_guide`, `server_get`, `server_prepare`, `table_create`, `endpoint_create`, `server_validate`, `server_plan_changes`, `server_publish` y `endpoint_test`. La edición exige `expected_head`; publicar exige `request_key` y confirmación del acceso público cuando corresponda. Las herramientas de IA siguen las mismas aprobaciones y permisos del panel.

## Archivos y ficha

`supabase/script.md` contiene nombre, foto, descripción e ID inmutable del script. Cambiar la ficha del script sincroniza este Markdown. `supabase/server.json` contiene `{"version":1}`. Lee `supabase/README.md` y `supabase/SKILL.md` antes de editar.

Cada tabla ocupa `supabase/tables/<nombre>.json`. Cada endpoint ocupa `supabase/endpoints/<nombre>/endpoint.json` y `handler.js`. Esta carpeta es privada; no expongas la implementación en el README mostrado a los usuarios.

## Campos, permisos y operaciones

Tipos: `text`, `number`, `integer`, `boolean`, `date`, `datetime`, `enum`, `json` y `reference`. Usa `required`, `default`, `min`, `max`, `minLength` y `maxLength` según el tipo. Enum exige `values`; una referencia exige `table`, siempre dentro del mismo script. `unique` e `indexes` son listas de listas de columnas. Los índices son declarativos; las consultas utilizan infraestructura compartida, no índices PostgreSQL arbitrarios.

Reglas por operación (`read`, `insert`, `update`, `delete`): `owner` es el dueño del script; `users` acepta cualquier sesión validada; `own` filtra registros de la propia sesión; `public` acepta visitantes. El valor predeterminado es `owner`. El servidor impone autoría e identidad del script, nunca campos enviados por el cliente.

`doglytdc.db.table(nombre)` ofrece `get(id)`, `list({limit,cursor,where,sort,order})`, `count(where)`, `insert(data)`, `update(id,data,revision)` y `delete(id,revision)`. Actualizar exige la revisión del registro. Los filtros son objetos de igualdad sobre columnas declaradas. La ordenación personalizada no se combina con cursor en esta versión.

## Endpoints y límites

Métodos: GET, POST, PUT, PATCH y DELETE. La ruta es literal y relativa, sin parámetros dinámicos en esta versión. GET lee `request.query`; los demás métodos leen `request.body`. `input` y `output` validan campos declarados; `output` es opcional. Define un `handler` síncrono, sin Deno, filesystem ni red libre. Las llamadas `doglytdc.*` ya esperan el resultado.

Copia la URL completa mostrada en Probar. Los endpoints de usuarios utilizan una sesión validada; nunca incluyas una clave administrativa en un script distribuido. Los endpoints públicos funcionan sin iniciar sesión. La prueba del panel se ejecuta como dueño, no simula otro usuario.

Límites: 20 tablas, 30 endpoints, 40 columnas/tabla, 10.000 registros/tabla, 64 KB/registro, 100 registros/página y 5 segundos/ejecución. La importación JSON/CSV usa lotes de hasta 100 registros con validación individual; si uno falla, los anteriores permanecen guardados. La exportación recorre páginas.

## Versiones, datos y errores

La publicación es atómica; un error mantiene la versión anterior. Eliminar columnas/tablas con datos, cambiar tipos o restringir enums de forma incompatible queda bloqueado. Exporta antes de cambiar estructuras. Volver una versión no revierte registros; los datos incompatibles bloquean el rollback.

`supabase/migrations/*.json` acepta notas declarativas `{"version":1,"description":"..."}`. No ejecuta SQL ni elimina datos. Las definiciones de tablas determinan los cambios aditivos.

Errores principales: `OWNER_ONLY`, `HEAD_MOVED`, `INVALID_SERVER`, `PUBLIC_ACCESS_CONFIRMATION`, `REVISION_CONFLICT`, `VERSION_CONFLICT`, `UNIQUE_CONFLICT`, `INVALID_REFERENCE`, `DATA_MIGRATION_REQUIRED`, `QUOTA_EXCEEDED`, `BACKEND_UNAVAILABLE`.

El sistema anterior `supabase/functions/*.js`, `collections.json` y `doglytdc.db.collection()` sigue siendo compatible. Preparar la carpeta no convierte ni publica esos recursos. Sin SQL libre, joins arbitrarios, extensiones ni Realtime en esta entrega.

## Ejemplo completo

```json supabase/tables/tasks.json theme={null}
{
  "columns": {
    "text": {
      "type": "text",
      "required": true,
      "maxLength": 200
    },
    "done": {
      "type": "boolean",
      "default": false
    }
  },
  "permissions": {
    "read": "own",
    "insert": "users",
    "update": "own",
    "delete": "own"
  },
  "unique": [],
  "indexes": []
}
```

```json supabase/endpoints/save-task/endpoint.json theme={null}
{
  "method": "POST",
  "path": "tasks",
  "access": "users",
  "input": {
    "text": {
      "type": "text",
      "required": true,
      "maxLength": 200
    }
  }
}
```

```javascript supabase/endpoints/save-task/handler.js theme={null}
function handler(request) {
  return doglytdc.db.table('tasks').insert({
    text: request.body.text
  });
}
```


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