Pular para o conteúdo
início / kit / exec
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

// @token my-secret-key

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

# Disponível em:

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

Endpoint HTTP instantâneo — sem configuração necessária
home / kit / exec / modes
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 10
  • 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
home / kit / exec / magic-carousel
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.

EXECUTION
// @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.

NETWORK
// @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.

LIMITS
// @timeout 30000

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.

LIMITS
// @concurrent 10

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

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.

REALTIME
// @websocket true

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

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

CLOUD
// @aws true

Integração com AWS

Habilite o AWS SDK dentro do seu script com um único comentário. Acesse S3, DynamoDB, Lambda e qualquer outro serviço AWS diretamente.

home / kit / exec / accordion
REFERENCE

Referência Completa de Magic Comments.

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

@modeEXECUTION

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

SYNTAX

// @mode worker // @mode serverless
home / kit / exec / use-cases
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.

home / kit / exec / endpoints
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.

Monitoramento e Magic API

8 endpoints

GET /api/v1/exec/monitor/stats

GET
/api/v1/exec/monitor/statsMétricas de desempenho
GET
/api/v1/exec/monitor/active-requestsRequisições ativas
POST
/api/v1/exec/monitor/script-performanceMétricas por script
GET
/api/v1/exec/monitor/healthVerificação de saúde
GET
/api/v1/exec/magic-comments/schemaObter esquema de magic comments
GET
/api/v1/exec/magic-comments/readLer magic comments do script
PUT
/api/v1/exec/magic-comments/updateAtualizar magic comments
POST
/api/v1/exec/magic-comments/bulk-updateAtualizar magic comments em lote

Execução e Scripts

7 endpoints

GET/POST /:path

GET
/:pathExecutar script via rota baseada em arquivo
POST
/:pathExecutar script com corpo da requisição
GET
/api/v1/exec/scripts/listListar todos os scripts
GET
/api/v1/exec/scripts/readLer conteúdo do script
POST
/api/v1/exec/scripts/writeCriar ou atualizar um script
DELETE
/api/v1/exec/scripts/deleteExcluir um script
POST
/api/v1/exec/scripts/treeObter árvore de diretório

Validação

6 endpoints

POST /api/v1/exec/validate/script

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/magic-commentsAnalisar e validar magic comments
POST
/api/v1/exec/validate/dependenciesAnálise de dependências
POST
/api/v1/exec/validate/return-typeValidação do tipo de retorno

Templates e Roteamento

6 endpoints

GET /api/v1/exec/templates/list

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/route/resolveResolver URL para caminho do script
POST
/api/v1/exec/route/discoverDescobrir todas as rotas
POST
/api/v1/exec/route/testTestar correspondência de rota
início / kit / exec / cta

Seu Código É a API.

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

Ler a Documentação