Saltar al contenido principal
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

supabase/tables/tasks.json
supabase/endpoints/save-task/endpoint.json
supabase/endpoints/save-task/handler.js