Ir al contenido
Archivo = API
Aislados V8
Cero configuración
Comentarios mágicos
Instalación automática de dependencias
Soporte WebSocket
TypeScript nativo
Más de 300 modelos IA
Archivo = API
Aislados V8
Cero configuración
Comentarios mágicos
Instalación automática de dependencias
Soporte WebSocket
TypeScript nativo
Más de 300 modelos IA
Archivo = API
Aislados V8
Cero configuración
Comentarios mágicos
Instalación automática de dependencias
Soporte WebSocket
TypeScript nativo
Más de 300 modelos IA
Archivo = API
Aislados V8
Cero configuración
Comentarios mágicos
Instalación automática de dependencias
Soporte WebSocket
TypeScript nativo
Más de 300 modelos IA
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.

Ver documentación
exec / hello.ts

// @mode serverless

// @cors reflective

// @timeout 5000

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

# En vivo en:

https://abc123-def456-exec-1.node-us-1.containers.hoody.com/hello

Endpoint HTTP instantáneo: no se necesita configuración
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 5
  • Aislado V8 nuevo por solicitud
  • Aislamiento completo, sin fuga de estado
  • Concurrencia configurable vía @concurrent
  • Ideal para webhooks y tráfico esporádico
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 60000

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 false

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-key-123

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

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

Cambia el modelo por script. Por defecto usa google/gemini-2.5-flash-lite, con acceso a más de 300 modelos de más de 15 proveedores de inferencia a través de Hoody AI.

LOGGING
// @log-level full

Verbosidad de logs

Ajusta el logging desde none y minimal hasta standard (el valor por defecto), full y debug. Sin stack de logging externo que montar.

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

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.

67 documented endpointshttps://abc123-def456-exec-1.node-us-1.containers.hoody.com

Ejecución de scripts

1 endpoint
POST
/{path}Ejecuta cualquier script mediante su ruta basada en archivos

Gestión de scripts

6 endpoints
GET
/api/v1/exec/scripts/readLee el contenido de un script
POST
/api/v1/exec/scripts/writeCrea o actualiza un script
DELETE
/api/v1/exec/scripts/deleteElimina un script
GET
/api/v1/exec/scripts/listLista todos los scripts
POST
/api/v1/exec/scripts/treeObtén el árbol de directorios
POST
/api/v1/exec/scripts/moveMueve o renombra un script

Validación

6 endpoints
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/dependenciesParsear y validar comentarios mágicos
POST
/api/v1/exec/validate/return-typeAnálisis de dependencias
POST
/api/v1/exec/validate/magic-commentsValidación de tipo de retorno

Plantillas y enrutamiento

6 endpoints
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/templates/create-customResolver URL a ruta de script
PUT
/api/v1/exec/templates/update-custom/{name}Descubrir todas las rutas
DELETE
/api/v1/exec/templates/delete-custom/{name}Probar coincidencia de rutas

Comentarios mágicos

4 endpoints
GET
/api/v1/exec/magic-comments/schemaObtén el esquema de los comentarios mágicos
GET
/api/v1/exec/magic-comments/readLee los comentarios mágicos de un script
PUT
/api/v1/exec/magic-comments/updateActualiza los comentarios mágicos
POST
/api/v1/exec/magic-comments/bulk-updateActualización masiva en varios scripts

Dependencias y paquetes

9 endpoints
GET
/api/v1/exec/dependencies/bundledLista las dependencias preempaquetadas
POST
/api/v1/exec/dependencies/checkComprueba si faltan paquetes
POST
/api/v1/exec/dependencies/installInstala módulos npm
GET
/api/v1/exec/package/readRead package.json
POST
/api/v1/exec/package/updateUpdate package.json
POST
/api/v1/exec/package/installInstala paquetes
POST
/api/v1/exec/package/compareCompara paquetes
POST
/api/v1/exec/package/pinFija versiones
POST
/api/v1/exec/package/initInitialize package.json

Enrutamiento

3 endpoints
POST
/api/v1/exec/route/resolveResuelve a qué script apunta una URL
POST
/api/v1/exec/route/discoverDescubre todas las rutas
POST
/api/v1/exec/route/testPrueba la coincidencia de rutas

Caché y estado compartido

4 endpoints
POST
/api/v1/exec/cache/clearLimpia la caché de ejecución
POST
/api/v1/exec/shared-state/getLee el estado compartido
POST
/api/v1/exec/shared-state/setEscribe el estado compartido
POST
/api/v1/exec/shared-state/clearLimpia el estado compartido

Logs

5 endpoints
GET
/api/v1/exec/logs/listLista los logs
POST
/api/v1/exec/logs/readLee un log
GET
/api/v1/exec/logs/streamTransmite logs por SSE
POST
/api/v1/exec/logs/searchBusca en los logs
DELETE
/api/v1/exec/logs/clearLimpia los logs

Monitorización y API mágica

6 endpoints
GET
/api/v1/exec/monitor/statsMétricas de rendimiento
GET
/api/v1/exec/monitor/active-requestsSolicitudes activas
GET
/api/v1/exec/monitor/scriptsMétricas por script
POST
/api/v1/exec/monitor/script-performanceVerificación de estado
GET
/api/v1/exec/monitor/metricsObtener esquema de comentarios mágicos
GET
/api/v1/exec/healthLeer comentarios mágicos del script

Programaciones

4 endpoints
GET
/api/v1/exec/schedules/listLista las programaciones
POST
/api/v1/exec/schedules/triggerDispara una programación
POST
/api/v1/exec/schedules/reloadRecarga las programaciones
GET
/api/v1/exec/schedules/historyHistorial de ejecuciones de la programación

Gestión de SDKs

4 endpoints
POST
/api/v1/exec/sdk/importImporta un SDK
GET
/api/v1/exec/sdk/listLista los SDKs importados
GET
/api/v1/exec/sdk/{id}Obtén los detalles de un SDK
DELETE
/api/v1/exec/sdk/{id}Elimina un SDK importado

OpenAPI de usuario

6 endpoints
POST
/api/v1/exec/user-openapi/generateGenera una especificación OpenAPI
GET
/api/v1/exec/user-openapi/listLista los scripts del usuario
POST
/api/v1/exec/user-openapi/validateValida un esquema de usuario
GET
/api/v1/exec/user-openapi/schemaSirve el archivo de esquema
GET
/api/v1/exec/user-openapi/specSirve la especificación generada
POST
/api/v1/exec/user-openapi/mergeCombina especificaciones OpenAPI

Instancias y sistema

3 endpoints
GET
/api/v1/exec/listLista todos los IDs de instancia de exec
POST
/api/v1/exec/system/restartReinicia el servidor
GET
/api/v1/exec/system/restart-statusObtén el estado del reinicio

Tu código es la API.

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

Leer la documentación