Preparar e publicar
- Abra Painel Dev → Servidor → Visão geral → Preparar servidor.
- Em Tabelas, crie colunas, tipos e permissões. Em Endpoints, defina método, caminho, entrada e handler.
- Salvar arquivo grava o repositório, mas não ativa o servidor. Valide e revise as diferenças.
- Use Publicar servidor e confirme. Recursos marcados como públicos poderão ser usados sem login.
- Em Endpoints, teste com entrada real; confira o registro na tabela.
server_get_guide, server_get, server_prepare, table_create, endpoint_create, server_validate, server_plan_changes, server_publish e endpoint_test. Edição exige expected_head; publicação exige request_key e confirmação de acesso público quando aplicável. A IA segue as mesmas aprovações e permissões do painel.
Arquivos e ficha
supabase/script.md contém nome, foto, descrição e o ID imutável do script. Alterar a ficha do script sincroniza esse Markdown. supabase/server.json contém {"version":1}. Leia supabase/README.md e supabase/SKILL.md antes de editar.
Cada tabela ocupa supabase/tables/<nome>.json. Cada endpoint ocupa supabase/endpoints/<nome>/endpoint.json e handler.js. Essa pasta é privada: não coloque sua implementação no README mostrado aos usuários.
Campos, permissões e operações
Tipos:text, number, integer, boolean, date, datetime, enum, json e reference. Use required, default, min, max, minLength e maxLength conforme o tipo. Enum exige values; referência exige table, sempre no mesmo script. unique e indexes são listas de listas de colunas. Índices são declarativos; consultas usam a infraestrutura compartilhada, não índices PostgreSQL livres.
Regras por operação (read, insert, update, delete): owner é o dono do script; users aceita qualquer sessão validada; own filtra registros da própria sessão; public aceita visitantes. O padrão é owner. Autoria e identificação do script são impostas pelo servidor, nunca por campos enviados pelo cliente.
doglytdc.db.table(nome) oferece get(id), list({limit,cursor,where,sort,order}), count(where), insert(data), update(id,data,revision) e delete(id,revision). Atualizações exigem revisão. Filtros são objetos de igualdade sobre colunas declaradas. Ordenação personalizada não combina com cursor nesta versão.
Endpoints e limites
Métodos: GET, POST, PUT, PATCH e DELETE. Caminho é literal e relativo, sem parâmetros dinâmicos nesta versão. GET lêrequest.query; os demais leem request.body. input e output validam campos declarados; output é opcional. Código define um handler síncrono, sem Deno, filesystem ou rede livre. As chamadas doglytdc.* já aguardam o resultado.
Copie a URL completa mostrada em Testar. Endpoints de usuários usam sessão validada; nunca inclua uma chave administrativa no script distribuído. Endpoints públicos funcionam sem login. O teste no painel executa como o dono, não simula outro usuário.
Limites: 20 tabelas, 30 endpoints, 40 colunas/tabela, 10.000 registros/tabela, 64 KB/registro, 100 registros/página e 5 segundos/execução. Importação JSON/CSV usa lotes de até 100 registros, com validação individual; se um registro falhar, os anteriores permanecem salvos. Exportação percorre páginas.
Versões, dados e erros
Publicação é atômica; erro mantém a versão anterior. Remover coluna/tabela com dados, mudar tipo ou restringir enum incompatível é bloqueado. Exporte os dados antes de alterar sua estrutura. Voltar uma versão não desfaz registros; dados incompatíveis bloqueiam o rollback.supabase/migrations/*.json permite notas declarativas {"version":1,"description":"..."}. Não executa SQL nem apaga dados. A definição da tabela é a fonte das mudanças aditivas.
Erros principais: OWNER_ONLY, HEAD_MOVED, INVALID_SERVER, PUBLIC_ACCESS_CONFIRMATION, REVISION_CONFLICT, VERSION_CONFLICT, UNIQUE_CONFLICT, INVALID_REFERENCE, DATA_MIGRATION_REQUIRED, QUOTA_EXCEEDED, BACKEND_UNAVAILABLE.
O legado supabase/functions/*.js, collections.json e doglytdc.db.collection() continua compatível; preparar a pasta não converte nem publica esses recursos. Sem SQL livre, joins arbitrários, extensões ou Realtime nesta entrega.
Exemplo completo
supabase/tables/tasks.json
supabase/endpoints/save-task/endpoint.json
supabase/endpoints/save-task/handler.js

