Ir al contenido
inicio / kit / exec
ExecHOODY EXEC

Tus archivos son APIs. Un comentario lo cambia todo.

Escribe una función TypeScript: al instante es un endpoint HTTP en vivo. Añade un comentario para controlar auth, CORS, modo o IA. Sin configuración. Sin middleware.

exec / hello.ts

// @mode serverless

// @cors reflective

// @token my-secret-key

return { message: 'Hello!', time: Date.now() };

# En vivo en:

https://proj-cont-exec-1.us1.containers.hoody.com/hello

Endpoint HTTP instantáneo: no se necesita configuración
home / kit / exec / modes
MODOS DE EJECUCIÓN

Dos modos. Un comentario.

Cada script elige un modo. Worker para apps con estado en tiempo real. Serverless para ejecución aislada y efímera. Un comentario es todo lo que se necesita.

Modo Worker

// @mode worker
  • Aislado V8 persistente: siempre caliente
  • Estado compartido entre todas las solicitudes
  • Compatible con WebSocket
  • Cero cold start tras la primera solicitud

Modo Serverless

// @mode serverless // @concurrent 10
  • Aislado V8 nuevo por solicitud
  • Aislamiento completo, sin fuga de estado
  • Concurrencia configurable vía @concurrent
  • Ideal para webhooks y tráfico esporádico
home / kit / exec / magic-carousel
COMENTARIOS MÁGICOS

Cada comportamiento. Una línea.

Añade un comentario al inicio de tu archivo. Sin cambios de código, sin archivos de configuración, sin middleware. Cambia el comentario y el comportamiento cambia al instante.

EJECUCIÓN
// @mode worker

Modo de ejecución

Elige entre una VM Worker persistente o un aislado Serverless nuevo por solicitud. Determina el estado, WebSocket y el comportamiento de cold start.

RED
// @cors reflective

Control CORS

Refleja el origen de la solicitud con 'reflective', abre todos los orígenes con '*' o bloquea a una URL específica. Sin middleware requerido.

LÍMITES
// @timeout 30000

Timeout de solicitud

Establece el timeout en milisegundos. Por defecto 30s. Usa 0 o 'unlimited' para scripts de larga duración. Previene ejecuciones descontroladas.

LÍMITES
// @concurrent 10

Límite de concurrencia

Solo Serverless: limita ejecuciones simultáneas. Ponlo a 'false' para procesamiento en serie, esencial para ordenar webhooks.

AUTH
// @token my-secret

Auth de endpoint

Protege cualquier endpoint con un secreto compartido. Los clientes se autentican vía Bearer, Basic, cabecera X-Token o parámetro de consulta. Comparación en tiempo constante.

TIEMPO REAL
// @websocket true

Soporte WebSocket

Activa conexiones bidireccionales en tiempo real. Requiere modo Worker. Los manejadores ws.message, ws.open y ws.close se inyectan automáticamente.

IA
// @ai true

Helpers de IA

Inyecta generateText, streamText y generateObject del Vercel AI SDK. Sin imports, sin configuración de claves API. Modelo preconfigurado.

IA
// @ai-model anthropic/claude-sonnet-4.5

Selección de modelo IA

Override the default AI model per script. Default: google/gemini-2.5-flash-lite. Supports 300+ models from 15+ providers.

CLOUD
// @aws true

Integración AWS

Activa el AWS SDK dentro de tu script con un solo comentario. Accede a S3, DynamoDB, Lambda y cualquier otro servicio AWS directamente.

home / kit / exec / accordion
REFERENCIA

Referencia completa de comentarios mágicos.

Cada comentario, cada valor, cada valor por defecto. Todo en un solo lugar.

@modeEJECUCIÓN

Establece el modo de ejecución del script. 'worker' crea una VM persistente; 'serverless' (por defecto) crea una VM nueva por solicitud.

SINTAXIS

// @mode worker // @mode serverless
home / kit / exec / use-cases
CASOS DE USO

Del webhook al WebSocket en minutos.

Seis patrones que cubren todo el espectro: desde APIs HTTP instantáneas hasta proxies de IA en tiempo real.

APIs instantáneas

Olvídate de configurar Express. Crea un archivo y tendrás un endpoint HTTP en vivo. Worker para tráfico alto, serverless para aislamiento.

Receptores de webhooks

Webhooks de Stripe, GitHub y Slack con aislamiento serverless. Usa @concurrent false para procesamiento en serie y ordenación consistente.

Servidores WebSocket

Servidores de chat, dashboards en vivo, streams SSE. El modo Worker mantiene conexiones persistentes con estado de sala compartido.

Proxy MITM para IA

Intercepta y controla solicitudes de IA. Añade verificaciones de seguridad, modifica prompts, bloquea datos sensibles y rastrea el uso, todo en un script.

Limitación de tasa

Rastrea conteos de solicitudes por IP en el objeto compartido entre solicitudes. El modo Worker hace que la limitación de tasa en memoria sea trivial.

Composición de scripts

Cada script es un endpoint HTTP. Llama a otros scripts con fetch(). Compone microservicios a partir de funciones simples: sin colas, sin descubrimiento de servicios.

home / kit / exec / endpoints
MÁS DE 50 ENDPOINTS

Toda la superficie de API, en un solo lugar.

Ejecución de scripts, gestión, validación, plantillas, enrutamiento, monitorización y control de comentarios mágicos: todo en una sola API.

Monitorización y API mágica

8 endpoints

GET /api/v1/exec/monitor/stats

GET
/api/v1/exec/monitor/statsMétricas de rendimiento
GET
/api/v1/exec/monitor/active-requestsSolicitudes activas
POST
/api/v1/exec/monitor/script-performanceMétricas por script
GET
/api/v1/exec/monitor/healthVerificación de estado
GET
/api/v1/exec/magic-comments/schemaObtener esquema de comentarios mágicos
GET
/api/v1/exec/magic-comments/readLeer comentarios mágicos del script
PUT
/api/v1/exec/magic-comments/updateActualizar comentarios mágicos
POST
/api/v1/exec/magic-comments/bulk-updateActualización masiva de comentarios mágicos

Ejecución y scripts

7 endpoints

GET/POST /:path

GET
/:pathEjecutar script vía ruta basada en archivo
POST
/:pathEjecutar script con body de solicitud
GET
/api/v1/exec/scripts/listListar todos los scripts
GET
/api/v1/exec/scripts/readLeer contenido de un script
POST
/api/v1/exec/scripts/writeCrear o actualizar un script
DELETE
/api/v1/exec/scripts/deleteEliminar un script
POST
/api/v1/exec/scripts/treeObtener árbol de directorios

Validación

6 endpoints

POST /api/v1/exec/validate/script

POST
/api/v1/exec/validate/scriptValidación exhaustiva de script
POST
/api/v1/exec/validate/typescriptVerificación de tipos TypeScript
POST
/api/v1/exec/validate/syntaxValidación de sintaxis
POST
/api/v1/exec/validate/magic-commentsParsear y validar comentarios mágicos
POST
/api/v1/exec/validate/dependenciesAnálisis de dependencias
POST
/api/v1/exec/validate/return-typeValidación de tipo de retorno

Plantillas y enrutamiento

6 endpoints

GET /api/v1/exec/templates/list

GET
/api/v1/exec/templates/listListar plantillas disponibles
GET
/api/v1/exec/templates/previewPrevisualizar una plantilla
POST
/api/v1/exec/templates/generateCrear script a partir de plantilla
POST
/api/v1/exec/route/resolveResolver URL a ruta de script
POST
/api/v1/exec/route/discoverDescubrir todas las rutas
POST
/api/v1/exec/route/testProbar coincidencia de rutas
inicio / kit / exec / cta

Tu código es la API.

Escribe una función TypeScript. Añade un comentario. Está en vivo.

Leer la documentación