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

# Funções do script

> O backend do script: como escrever, publicar e chamar funções.

Cada script pode ter um **backend** próprio: funções em JavaScript e coleções de dados, hospedadas pelo DoglyTdc. Você não precisa de servidor.

## Como funciona

**1. Escreva a função**

Crie `supabase/functions/<nome>.js` com `function handler(request) { ... }`. Pode começar de um [modelo](https://docs.doglytdc.dev/pt-BR/scripts/functions/templates.md).

**2. Grave na branch principal**

Um commit na branch principal publica o backend sozinho. Também dá para publicar de novo com `POST /scripts/{script_id}/deploy` ou `deploy_functions`.

**3. Chame a função**

Pelo script, pela API (`POST /scripts/{script_id}/functions/{name}`) ou pela IA (`test_function`).

Na publicação, o DoglyTdc confere a sintaxe de cada função. Uma função com erro fica marcada como **erro** e não é ativada (se havia uma versão boa antes, ela continua). Funções apagadas do repositório são removidas.

## A função

```js theme={null}
function handler(request) {
  return doglytdc.respond(200, { ok: true, method: request.method });
}
```

> [!WARNING]
>
> `handler` precisa ser **síncrono**. Não use `async`/`await`: as chamadas `doglytdc.*` já esperam o resultado sozinhas. Uma função `async` falha com "handler não pode ser async".

## O objeto `request`

| Campo | O que é |
| - | - |
| `request.method` | Método HTTP do pedido |
| `request.body` | Corpo JSON enviado |
| `request.query` | Parâmetros da URL |
| `request.user` | `{ username }` de quem chamou, ou `null` se não estava logado |

## O objeto `doglytdc`

| Item | O que faz |
| - | - |
| `doglytdc.respond(status, body)` | Monta a resposta (status de 200 a 599). Se você devolver outro valor, ele vira o corpo com status 200. |
| `doglytdc.user` | Quem chamou (`{ username }`) ou `null`. |
| `doglytdc.env` | Segredos do script (nome → valor), só leitura. |
| `doglytdc.db.collection(nome)` | Banco do script. Veja [Coleções](https://docs.doglytdc.dev/pt-BR/scripts/functions/collections.md). |
| `doglytdc.fetch(url, init)` | Chama um site autorizado. Veja [fetch e IA](https://docs.doglytdc.dev/pt-BR/scripts/functions/fetch-and-ai.md). |
| `doglytdc.ai.chat(messages, options)` | IA DoglyTdc com os créditos do dono. Veja [fetch e IA](https://docs.doglytdc.dev/pt-BR/scripts/functions/fetch-and-ai.md). |
| `doglytdc.log(...)` / `console.log(...)` | Escreve no log da execução. |

## Limites de cada execução

| Limite | Valor | Se passar |
| - | - | - |
| Tempo | 5 segundos | `504` "Tempo esgotado (5 s)." |
| Memória | 32 MB do programa (teto de 64 MB) | `500` "Memória esgotada (64 MB)." |
| Resposta | 256 KB | `500` "Resposta grande demais (máx. 256 KB)." |
| Linhas de log | 50 (até 2.000 caracteres cada) | As demais são ignoradas |
| `fetch` | 10 por execução, 4 s cada, resposta até 1 MB | Erro na chamada |
| IA | 3 chamadas por execução | Erro na chamada |
| Funções por script | 30 | As demais são ignoradas na publicação |
| Chamadas pela API | 120 por minuto por pessoa e script | `429 RATE_LIMITED` |

A função roda numa caixa isolada: não tem acesso a rede, arquivos ou banco fora do que o objeto `doglytdc` oferece.

## Ver o resultado

Cada chamada fica registrada com status, tempo e erro (sem o corpo). O registro guarda os últimos 7 dias. A lista de funções (`GET /scripts/{script_id}/functions`) mostra `status`, `error`, `live_sha`, `last_run_at` e o endereço público de cada uma.


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