Aller au contenu
accueil / kit / exec
ExecHOODY EXEC

Vos fichiers sont des APIs. Un commentaire change tout.

Écrivez une fonction TypeScript — c'est instantanément un endpoint HTTP en direct. Ajoutez un commentaire pour contrôler l'auth, CORS, le mode ou l'IA. Zéro config. Zéro middleware.

exec / hello.ts

// @mode serverless

// @cors reflective

// @token my-secret-key

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

# En direct sur :

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

Endpoint HTTP instantané — aucune configuration nécessaire
home / kit / exec / modes
MODES D'EXÉCUTION

Deux modes. Un commentaire.

Chaque script choisit un mode. Worker pour les applications stateful en temps réel. Serverless pour l'exécution isolée et éphémère. Un seul commentaire suffit.

Mode Worker

// @mode worker
  • Isolat V8 persistant — reste actif indéfiniment
  • État partagé entre toutes les requêtes
  • WebSocket supporté
  • Zéro démarrage à froid après la première requête

Mode Serverless

// @mode serverless // @concurrent 10
  • Nouvel isolat V8 par requête
  • Isolation complète, aucune fuite d'état
  • Concurrence configurable via @concurrent
  • Idéal pour les webhooks et le trafic sporadique
home / kit / exec / magic-carousel
COMMENTAIRES MAGIQUES

Chaque comportement. Une ligne.

Ajoutez un commentaire en haut de votre fichier. Aucun changement de code, aucun fichier de config, aucun middleware. Changez le commentaire — le comportement change instantanément.

EXÉCUTION
// @mode worker

Mode d'exécution

Choisissez entre une VM Worker persistante ou un isolat Serverless frais par requête. Détermine l'état, WebSocket et le comportement au démarrage à froid.

RÉSEAU
// @cors reflective

Contrôle CORS

Répercutez l'origine de la requête avec 'reflective', ouvrez toutes les origines avec '*', ou verrouillez sur une URL spécifique. Aucun middleware requis.

LIMITES
// @timeout 30000

Timeout de requête

Définissez le timeout en millisecondes. Par défaut 30 s. Utilisez 0 ou 'unlimited' pour les scripts longs. Évite les exécutions incontrôlées.

LIMITES
// @concurrent 10

Plafond de concurrence

Serverless uniquement : limite les exécutions simultanées. Mettez à 'false' pour le traitement série — essentiel pour l'ordre des webhooks.

AUTH
// @token my-secret

Auth d'endpoint

Protégez n'importe quel endpoint avec un secret partagé. Les clients s'authentifient via Bearer, Basic, l'en-tête X-Token ou un paramètre de requête. Comparaison en temps constant.

TEMPS RÉEL
// @websocket true

Support WebSocket

Activez les connexions bidirectionnelles en temps réel. Nécessite le mode Worker. Handlers ws.message, ws.open, ws.close injectés automatiquement.

IA
// @ai true

Helpers IA

Injecte generateText, streamText, generateObject depuis le SDK Vercel AI. Aucune importation, aucune configuration de clé API. Modèle préconfiguré.

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

Sélection du modèle IA

Remplacez le modèle IA par défaut par script. Défaut : google/gemini-2.5-flash-lite. Prend en charge 300+ modèles de 15+ fournisseurs.

CLOUD
// @aws true

Intégration AWS

Activez le SDK AWS dans votre script avec un seul commentaire. Accédez directement à S3, DynamoDB, Lambda et tout autre service AWS.

home / kit / exec / accordion
RÉFÉRENCE

Référence complète des commentaires magiques.

Chaque commentaire, chaque valeur, chaque défaut. En un seul endroit.

@modeEXÉCUTION

Définit le mode d'exécution du script. 'worker' crée une VM persistante ; 'serverless' (par défaut) crée une nouvelle VM par requête.

SYNTAXE

// @mode worker // @mode serverless
home / kit / exec / use-cases
CAS D'USAGE

Du webhook au WebSocket en quelques minutes.

Six patterns couvrant l'ensemble du spectre — des APIs HTTP instantanées aux proxies IA en temps réel.

APIs instantanées

Sautez entièrement la configuration Express. Créez un fichier — c'est un endpoint HTTP en direct. Worker pour le trafic élevé, serverless pour l'isolation.

Récepteurs de webhooks

Webhooks Stripe, GitHub, Slack avec isolation serverless. Utilisez @concurrent false pour le traitement série et un ordre cohérent.

Serveurs WebSocket

Serveurs de chat, tableaux de bord en direct, streams SSE. Le mode Worker maintient des connexions persistantes avec un état de salle partagé.

Proxy MITM pour l'IA

Interceptez et contrôlez les requêtes IA. Ajoutez des vérifications de sécurité, modifiez les prompts, bloquez les données sensibles, suivez l'utilisation — en un seul script.

Limitation du débit

Suivez les compteurs de requêtes par IP dans l'objet partagé entre requêtes. Le mode Worker rend la limitation de débit en mémoire triviale.

Composition de scripts

Chaque script est un endpoint HTTP. Appelez d'autres scripts avec fetch(). Composez des microservices à partir de fonctions simples — pas de files d'attente, pas de découverte de service.

home / kit / exec / endpoints
50+ ENDPOINTS

Toute la surface API, en un seul endroit.

Exécution de scripts, gestion, validation, templates, routage, surveillance et contrôle des commentaires magiques — tout en une seule API.

Surveillance & API magique

8 endpoints

GET /api/v1/exec/monitor/stats

GET
/api/v1/exec/monitor/statsMétriques de performance
GET
/api/v1/exec/monitor/active-requestsRequêtes actives
POST
/api/v1/exec/monitor/script-performanceMétriques par script
GET
/api/v1/exec/monitor/healthVérification de santé
GET
/api/v1/exec/magic-comments/schemaObtenir le schéma des commentaires magiques
GET
/api/v1/exec/magic-comments/readLire les commentaires magiques d'un script
PUT
/api/v1/exec/magic-comments/updateMettre à jour les commentaires magiques
POST
/api/v1/exec/magic-comments/bulk-updateMise à jour en masse des commentaires magiques

Exécution & scripts

7 endpoints

GET/POST /:path

GET
/:pathExécuter un script via une route basée sur les fichiers
POST
/:pathExécuter un script avec un corps de requête
GET
/api/v1/exec/scripts/listLister tous les scripts
GET
/api/v1/exec/scripts/readLire le contenu d'un script
POST
/api/v1/exec/scripts/writeCréer ou mettre à jour un script
DELETE
/api/v1/exec/scripts/deleteSupprimer un script
POST
/api/v1/exec/scripts/treeObtenir l'arborescence de répertoires

Validation

6 endpoints

POST /api/v1/exec/validate/script

POST
/api/v1/exec/validate/scriptValidation complète du script
POST
/api/v1/exec/validate/typescriptVérification des types TypeScript
POST
/api/v1/exec/validate/syntaxValidation de la syntaxe
POST
/api/v1/exec/validate/magic-commentsAnalyser et valider les commentaires magiques
POST
/api/v1/exec/validate/dependenciesAnalyse des dépendances
POST
/api/v1/exec/validate/return-typeValidation du type de retour

Templates & routage

6 endpoints

GET /api/v1/exec/templates/list

GET
/api/v1/exec/templates/listLister les templates disponibles
GET
/api/v1/exec/templates/previewPrévisualiser un template
POST
/api/v1/exec/templates/generateCréer un script à partir d'un template
POST
/api/v1/exec/route/resolveRésoudre une URL vers un chemin de script
POST
/api/v1/exec/route/discoverDécouvrir toutes les routes
POST
/api/v1/exec/route/testTester la correspondance de route
accueil / kit / exec / cta

Votre code est l'API.

Écrivez une fonction TypeScript. Ajoutez un commentaire. C'est en direct.

Lire la documentation