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

# Funciones del script

> El backend del script: cómo escribir, publicar y llamar funciones.

Cada script puede tener su propio **backend**: funciones en JavaScript y colecciones de datos, alojadas en DoglyTdc. No necesitas un servidor.

## Cómo funciona

**1. Escribe la función**

Crea `supabase/functions/<nome>.js` con `function handler(request) { ... }`. Puedes empezar con una [plantilla](https://docs.doglytdc.dev/es/scripts/functions/templates.md).

**2. Guarda en la rama principal**

Un commit en la rama principal publica el backend automáticamente. También puedes volver a publicarlo con `POST /scripts/{script_id}/deploy` o `deploy_functions`.

**3. Llama a la función**

Desde el script, mediante la API (`POST /scripts/{script_id}/functions/{name}`) o mediante la IA (`test_function`).

Al publicar, DoglyTdc comprueba la sintaxis de cada función. Una función con errores se marca como **error** y no se activa (si había una versión válida anterior, se conserva). Las funciones eliminadas del repositorio se quitan.

## La función

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

> [!WARNING]
>
> `handler` debe ser **síncrono**. No uses `async`/`await`: las llamadas `doglytdc.*` ya esperan el resultado por sí solas. Una función `async` falla con "handler não pode ser async" (handler no puede ser async).

## El objeto `request`

| Campo | Qué es |
| - | - |
| `request.method` | Método HTTP de la solicitud |
| `request.body` | Cuerpo JSON enviado |
| `request.query` | Parámetros de la URL |
| `request.user` | `{ username }` de quien hizo la llamada, o `null` si no había iniciado sesión |

## El objeto `doglytdc`

| Elemento | Qué hace |
| - | - |
| `doglytdc.respond(status, body)` | Crea la respuesta (estado de 200 a 599). Si devuelves otro valor, se convierte en el cuerpo con estado 200. |
| `doglytdc.user` | Quien hizo la llamada (`{ username }`) o `null`. |
| `doglytdc.env` | Secretos del script (nombre → valor), solo lectura. |
| `doglytdc.db.collection(nome)` | Base de datos del script. Consulta [Colecciones](https://docs.doglytdc.dev/es/scripts/functions/collections.md). |
| `doglytdc.fetch(url, init)` | Llama a un sitio autorizado. Consulta [fetch e IA](https://docs.doglytdc.dev/es/scripts/functions/fetch-and-ai.md). |
| `doglytdc.ai.chat(messages, options)` | IA DoglyTdc con los créditos del propietario. Consulta [fetch e IA](https://docs.doglytdc.dev/es/scripts/functions/fetch-and-ai.md). |
| `doglytdc.log(...)` / `console.log(...)` | Escribe en el registro de ejecución. |

## Límites de cada ejecución

| Límite | Valor | Si se supera |
| - | - | - |
| Tiempo | 5 segundos | `504` "Tempo esgotado (5 s)." (Tiempo agotado) |
| Memoria | 32 MB del programa (máximo de 64 MB) | `500` "Memória esgotada (64 MB)." (Memoria agotada) |
| Respuesta | 256 KB | `500` "Resposta grande demais (máx. 256 KB)." (Respuesta demasiado grande) |
| Líneas de registro | 50 (hasta 2.000 caracteres cada una) | Las demás se ignoran |
| `fetch` | 10 por ejecución, 4 s cada una, respuesta de hasta 1 MB | Error en la llamada |
| IA | 3 llamadas por ejecución | Error en la llamada |
| Funciones por script | 30 | Las demás se ignoran al publicar |
| Llamadas mediante la API | 120 por minuto por persona y script | `429 RATE_LIMITED` |

La función se ejecuta en un entorno aislado: no tiene acceso a la red, los archivos ni las bases de datos fuera de lo que ofrece el objeto `doglytdc`.

## Ver el resultado

Cada llamada se registra con su estado, tiempo y error (sin el cuerpo). El registro conserva los últimos 7 días. La lista de funciones (`GET /scripts/{script_id}/functions`) muestra `status`, `error`, `live_sha`, `last_run_at` y la dirección pública de cada una.


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