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

