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

> Tabelas tipadas, endpoints e publicação explícita pelo Painel Dev ou MCP.

O **Servidor** mantém dados e endpoints separados para cada script. Só o dono administra esta área. Tabelas são lógicas e tipadas, persistidas no PostgreSQL; não é um projeto Supabase independente.

## Preparar e publicar

1. Abra **Painel Dev → Servidor → Visão geral → Preparar servidor**.
2. Em **Tabelas**, crie colunas, tipos e permissões. Em **Endpoints**, defina método, caminho, entrada e handler.
3. **Salvar arquivo** grava o repositório, mas não ativa o servidor. Valide e revise as diferenças.
4. Use **Publicar servidor** e confirme. Recursos marcados como públicos poderão ser usados sem login.
5. Em Endpoints, teste com entrada real; confira o registro na tabela.

Pelo MCP, use `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

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