Pular para o conteúdo
Arquivo = API
V8 Isolates
Zero Config
Magic Comments
Instalação Automática de Deps
Suporte a WebSocket
TypeScript Nativo
300+ Modelos de IA
Arquivo = API
V8 Isolates
Zero Config
Magic Comments
Instalação Automática de Deps
Suporte a WebSocket
TypeScript Nativo
300+ Modelos de IA
Arquivo = API
V8 Isolates
Zero Config
Magic Comments
Instalação Automática de Deps
Suporte a WebSocket
TypeScript Nativo
300+ Modelos de IA
Arquivo = API
V8 Isolates
Zero Config
Magic Comments
Instalação Automática de Deps
Suporte a WebSocket
TypeScript Nativo
300+ Modelos de IA
ExecHOODY EXEC

Seus Arquivos São APIs. Um Comentário Muda Tudo.

Escreva uma função TypeScript — ela vira um endpoint HTTP ao vivo instantaneamente. Adicione um comentário para controlar auth, CORS, modo ou IA. Sem config. Sem middleware.

exec / hello.ts

// @mode serverless

// @cors reflective

// @timeout 5000

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

# Disponível em:

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

Endpoint HTTP instantâneo — sem configuração necessária
MODOS DE EXECUÇÃO

Dois Modos. Um Comentário.

Cada script escolhe um modo. Worker para aplicativos com estado em tempo real. Serverless para execução isolada e efêmera. Um comentário é tudo que é preciso.

Modo Worker

// @mode worker
  • V8 isolate persistente — fica ativo para sempre
  • Estado compartilhado entre todas as requisições
  • WebSocket suportado
  • Zero cold start após a primeira requisição

Modo Serverless

// @mode serverless // @concurrent 5
  • V8 isolate fresco por requisição
  • Isolamento completo, sem vazamento de estado
  • Concorrência configurável via @concurrent
  • Ideal para webhooks e tráfego esporádico
MAGIC COMMENTS

Cada Comportamento. Uma Linha.

Coloque um comentário no topo do seu arquivo. Sem mudanças de código, sem arquivos de config, sem middleware. Mude o comentário — o comportamento muda instantaneamente.

EXECUÇÃO
// @mode worker

Modo de Execução

Escolha entre uma VM Worker persistente ou um isolate Serverless fresco por requisição. Determina comportamento de estado, WebSocket e cold start.

REDE
// @cors reflective

Controle de CORS

Espelhe a origem da requisição com 'reflective', abra todas as origens com '*', ou bloqueie para uma URL específica. Zero middleware necessário.

LIMITES
// @timeout 60000

Timeout da Requisição

Defina o timeout em milissegundos. O padrão é 30s. Use 0 ou 'unlimited' para scripts de longa duração. Evita execuções fora de controle.

LIMITES
// @concurrent false

Limite de Concorrência

Apenas Serverless: limite de execuções simultâneas. Defina como 'false' para processamento serial — essencial para ordenação de webhooks.

AUTH
// @token my-secret-key-123

Autenticação do Endpoint

Proteja qualquer endpoint com um segredo compartilhado. Clientes se autenticam via Bearer, Basic, cabeçalho X-Token ou parâmetro de query. Comparação em tempo constante.

TEMPO REAL
// @websocket

Suporte a WebSocket

Habilite conexões bidirecionais em tempo real. Requer modo Worker. Handlers ws.message, ws.open, ws.close injetados automaticamente.

AI
// @ai true

Helpers de IA

Injeta generateText, streamText, generateObject do Vercel AI SDK. Sem imports, sem configuração de chave de API. Modelo pré-configurado.

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

Seleção de Modelo de IA

Troque o modelo por script. O padrão é google/gemini-2.5-flash-lite, com acesso a mais de 300 modelos de mais de 15 provedores de inferência através do Hoody AI.

LOGS
// @log-level full

Verbosidade dos Logs

Ajuste o logging de none e minimal até standard (o padrão), full e debug. Sem stack de logging externa para configurar.

REFERÊNCIA

Referência Completa de Magic Comments.

Cada comentário, cada valor, cada padrão. Tudo em um só lugar.

@modeEXECUÇÃO

Define o modo de execução do script. 'worker' cria uma VM persistente; 'serverless' (padrão) cria uma VM fresca por requisição.

SINTAXE

// @mode worker // @mode serverless
CASOS DE USO

De Webhook a WebSocket em Minutos.

Seis padrões que cobrem toda a gama — de APIs HTTP instantâneas a proxies de IA em tempo real.

APIs Instantâneas

Esqueça a configuração do Express. Crie um arquivo — ele é um endpoint HTTP ao vivo. Worker para alto tráfego, serverless para isolamento.

Receptores de Webhook

Webhooks do Stripe, GitHub, Slack com isolamento serverless. Use @concurrent false para processamento serial e ordenação consistente.

Servidores WebSocket

Servidores de chat, dashboards ao vivo, streams SSE. Modo Worker mantém conexões persistentes com estado compartilhado de sala.

Proxy MITM de IA

Intercepte e controle requisições de IA. Adicione verificações de segurança, modifique prompts, bloqueie dados sensíveis, rastreie uso — tudo em um script.

Rate Limiting

Rastreie contagens de requisições por IP no objeto compartilhado entre requisições. Modo Worker torna o rate limiting em memória trivial.

Composição de Scripts

Cada script é um endpoint HTTP. Chame outros scripts com fetch(). Componha microsserviços a partir de funções simples — sem filas, sem descoberta de serviço.

50+ ENDPOINTS

Toda Superfície de API, Um Lugar.

Execução de scripts, gerenciamento, validação, templates, roteamento, monitoramento e controle por magic comment — tudo em uma API.

67 endpoints documentadoshttps://abc123-def456-exec-1.node-us-1.containers.hoody.com

Execução de Scripts

1 endpoint
POST
/{path}Execute qualquer script pela sua rota baseada em arquivo

Gerenciamento de Scripts

6 endpoints
GET
/api/v1/exec/scripts/readLeia o conteúdo do script
POST
/api/v1/exec/scripts/writeCrie ou atualize um script
DELETE
/api/v1/exec/scripts/deleteExclua um script
GET
/api/v1/exec/scripts/listListe todos os scripts
POST
/api/v1/exec/scripts/treeObtenha a árvore de diretórios
POST
/api/v1/exec/scripts/moveMova ou renomeie um script

Validação

6 endpoints
POST
/api/v1/exec/validate/scriptValidação abrangente do script
POST
/api/v1/exec/validate/typescriptVerificação de tipos TypeScript
POST
/api/v1/exec/validate/syntaxValidação de sintaxe
POST
/api/v1/exec/validate/dependenciesAnalisar e validar magic comments
POST
/api/v1/exec/validate/return-typeAnálise de dependências
POST
/api/v1/exec/validate/magic-commentsValidação do tipo de retorno

Templates e Roteamento

6 endpoints
GET
/api/v1/exec/templates/listListar templates disponíveis
GET
/api/v1/exec/templates/previewVisualizar um template
POST
/api/v1/exec/templates/generateCriar script a partir de template
POST
/api/v1/exec/templates/create-customResolver URL para caminho do script
PUT
/api/v1/exec/templates/update-custom/{name}Descobrir todas as rotas
DELETE
/api/v1/exec/templates/delete-custom/{name}Testar correspondência de rota

Magic Comments

4 endpoints
GET
/api/v1/exec/magic-comments/schemaObtenha o schema dos magic comments
GET
/api/v1/exec/magic-comments/readLeia os magic comments de um script
PUT
/api/v1/exec/magic-comments/updateAtualize os magic comments
POST
/api/v1/exec/magic-comments/bulk-updateAtualização em massa em vários scripts

Dependências & Pacotes

9 endpoints
GET
/api/v1/exec/dependencies/bundledListe as dependências pré-empacotadas
POST
/api/v1/exec/dependencies/checkVerifique pacotes faltantes
POST
/api/v1/exec/dependencies/installInstale módulos npm
GET
/api/v1/exec/package/readRead package.json
POST
/api/v1/exec/package/updateUpdate package.json
POST
/api/v1/exec/package/installInstale pacotes
POST
/api/v1/exec/package/compareCompare pacotes
POST
/api/v1/exec/package/pinFixe versões
POST
/api/v1/exec/package/initInitialize package.json

Roteamento

3 endpoints
POST
/api/v1/exec/route/resolveResolva para qual script uma URL aponta
POST
/api/v1/exec/route/discoverDescubra todas as rotas
POST
/api/v1/exec/route/testTeste o casamento de rotas

Cache & Estado Compartilhado

4 endpoints
POST
/api/v1/exec/cache/clearLimpe o cache de execução
POST
/api/v1/exec/shared-state/getLeia o estado compartilhado
POST
/api/v1/exec/shared-state/setEscreva o estado compartilhado
POST
/api/v1/exec/shared-state/clearLimpe o estado compartilhado

Logs

5 endpoints
GET
/api/v1/exec/logs/listListe os logs
POST
/api/v1/exec/logs/readLeia um log
GET
/api/v1/exec/logs/streamFaça stream dos logs via SSE
POST
/api/v1/exec/logs/searchBusque nos logs
DELETE
/api/v1/exec/logs/clearLimpe os logs

Monitoramento e Magic API

6 endpoints
GET
/api/v1/exec/monitor/statsMétricas de desempenho
GET
/api/v1/exec/monitor/active-requestsRequisições ativas
GET
/api/v1/exec/monitor/scriptsMétricas por script
POST
/api/v1/exec/monitor/script-performanceVerificação de saúde
GET
/api/v1/exec/monitor/metricsObter esquema de magic comments
GET
/api/v1/exec/healthLer magic comments do script

Agendamentos

4 endpoints
GET
/api/v1/exec/schedules/listListe os agendamentos
POST
/api/v1/exec/schedules/triggerDispare um agendamento
POST
/api/v1/exec/schedules/reloadRecarregue os agendamentos
GET
/api/v1/exec/schedules/historyHistórico de execuções do agendamento

Gerenciamento de SDKs

4 endpoints
POST
/api/v1/exec/sdk/importImporte um SDK
GET
/api/v1/exec/sdk/listListe os SDKs importados
GET
/api/v1/exec/sdk/{id}Obtenha os detalhes do SDK
DELETE
/api/v1/exec/sdk/{id}Exclua um SDK importado

OpenAPI do Usuário

6 endpoints
POST
/api/v1/exec/user-openapi/generateGere uma spec OpenAPI
GET
/api/v1/exec/user-openapi/listListe os scripts do usuário
POST
/api/v1/exec/user-openapi/validateValide um schema do usuário
GET
/api/v1/exec/user-openapi/schemaSirva o arquivo de schema
GET
/api/v1/exec/user-openapi/specSirva a spec gerada
POST
/api/v1/exec/user-openapi/mergeMescle specs OpenAPI

Instâncias & Sistema

3 endpoints
GET
/api/v1/exec/listListe todos os IDs de instância do exec
POST
/api/v1/exec/system/restartReinicie o servidor
GET
/api/v1/exec/system/restart-statusObtenha o status do reinício

Seu Código É a API.

Escreva uma função TypeScript. Adicione um comentário. Está no ar.

Ler a Documentação