Aller au contenu
Fichier = API
Isolates V8
Zéro config
Commentaires magiques
Auto-installation des deps
Support WebSocket
TypeScript natif
300+ modèles IA
Fichier = API
Isolates V8
Zéro config
Commentaires magiques
Auto-installation des deps
Support WebSocket
TypeScript natif
300+ modèles IA
Fichier = API
Isolates V8
Zéro config
Commentaires magiques
Auto-installation des deps
Support WebSocket
TypeScript natif
300+ modèles IA
Fichier = API
Isolates V8
Zéro config
Commentaires magiques
Auto-installation des deps
Support WebSocket
TypeScript natif
300+ modèles IA
ExecHOODY EXEC

vos fichiers sont des APIs. Un commentaire change tout.

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

Voir la documentation
exec / hello.ts

// @mode serverless

// @cors reflective

// @timeout 5000

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

# Live à :

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

Endpoint HTTP instantané — aucune config requise
MODES D'EXÉCUTION

Deux modes. Un commentaire.

Chaque script choisit un mode. Worker pour les apps temps réel à état. Serverless pour une exécution isolée et éphémère. Un commentaire suffit.

Mode Worker

// @mode worker
  • Isolate V8 persistant — reste chaud indéfiniment
  • État partagé entre toutes les requêtes
  • WebSocket supporté
  • Zéro cold start après la première requête

Mode Serverless

// @mode serverless // @concurrent 5
  • Isolate V8 neuf à chaque requête
  • Isolation complète, aucune fuite d'état
  • Concurrence configurable via @concurrent
  • Idéal pour les webhooks et le trafic sporadique
COMMENTAIRES MAGIQUES

Chaque comportement. Une ligne.

Pose un commentaire en haut de votre fichier. Aucune modif de code, aucun fichier de config, aucun middleware. Change le commentaire — le comportement change instantanément.

EXÉCUTION
// @mode worker

Mode d'exécution

Choisissez entre une VM Worker persistante ou un isolate Serverless neuf à chaque requête. Détermine l'état, le WebSocket et le comportement au cold start.

RÉSEAU
// @cors reflective

Contrôle CORS

Reflétez l'origine de la requête avec 'reflective', ouvrez toutes les origines avec '*', ou verrouillez sur une URL précise. Aucun middleware nécessaire.

LIMITES
// @timeout 60000

Timeout de requête

Définissez le timeout en millisecondes. Défaut : 30s. Utilisez 0 ou 'unlimited' pour les scripts longs. Évitez les exécutions hors contrôle.

LIMITES
// @concurrent false

Plafond de concurrence

Serverless uniquement : limitez les exécutions simultanées. Mettez 'false' pour un traitement en série — essentiel pour ordonner les webhooks.

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

Auth d'endpoint

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

TEMPS RÉEL
// @websocket

Support WebSocket

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

IA
// @ai true

Helpers IA

Injecte generateText, streamText, generateObject depuis le Vercel AI SDK. Aucun import, aucune clé API à configurer. Modèle préconfiguré.

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

Sélection du modèle IA

Changez de modèle par script. Par défaut google/gemini-2.5-flash-lite, avec accès à plus de 300 modèles chez plus de 15 fournisseurs d'inférence via Hoody AI.

LOGGING
// @log-level full

Verbosité des logs

Ajustez la journalisation de aucune et minimale jusqu'à standard (la valeur par défaut), complète et debug. Aucune stack de logging externe à brancher.

RÉFÉRENCE

Référence complète des Magic Comments.

Chaque commentaire, chaque valeur, chaque défaut. Tout au même endroit.

@modeEXÉCUTION

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

SYNTAXE

// @mode worker // @mode serverless
CAS D'USAGE

Du webhook au WebSocket en quelques minutes.

Six patterns qui couvrent toute la gamme — des APIs HTTP instantanées aux proxys IA temps réel.

APIs instantanées

Oubliez complètement la mise en place d'Express. Créez un fichier — c'est un endpoint HTTP live. Worker pour le gros trafic, serverless pour l'isolation.

Récepteurs de webhooks

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

Serveurs WebSocket

Serveurs de chat, dashboards live, streams SSE. Le mode Worker maintient des connexions persistantes avec un état de room partagé.

Proxy IA MITM

Interceptez et contrôlez les requêtes IA. Ajoutez des contrôles de sécurité, modifiez les prompts, bloquez les données sensibles, suivez l'usage — tout dans un script.

Rate limiting

Suivez le nombre de requêtes par IP dans l'objet partagé entre les requêtes. Le mode Worker rend le rate limiting en mémoire trivial.

Composition de scripts

Chaque script est un endpoint HTTP. Appelez d'autres scripts avec fetch(). Composez des microservices à partir de fonctions simples — sans queue, sans discovery.

50+ ENDPOINTS

Toute la surface API, au même endroit.

Exécution de scripts, gestion, validation, templates, routing, monitoring et contrôle des Magic Comments — tout dans une seule API.

67 endpoints documentéshttps://abc123-def456-exec-1.node-us-1.containers.hoody.com

Exécution de scripts

1 endpoint
POST
/{path}Exécutez n'importe quel script via sa route basée sur fichier

Gestion des scripts

6 endpoints
GET
/api/v1/exec/scripts/readLisez le contenu d'un script
POST
/api/v1/exec/scripts/writeCréez ou mettez à jour un script
DELETE
/api/v1/exec/scripts/deleteSupprimer un script
GET
/api/v1/exec/scripts/listLister tous les scripts
POST
/api/v1/exec/scripts/treeObtenir l'arborescence des répertoires
POST
/api/v1/exec/scripts/moveDéplacer ou renommer un script

Validation

6 endpoints
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/dependenciesParse et valide les Magic Comments
POST
/api/v1/exec/validate/return-typeAnalyse des dépendances
POST
/api/v1/exec/validate/magic-commentsValidation du type de retour

Templates & routing

6 endpoints
GET
/api/v1/exec/templates/listListe les templates disponibles
GET
/api/v1/exec/templates/previewPrévisualise un template
POST
/api/v1/exec/templates/generateCrée un script depuis un template
POST
/api/v1/exec/templates/create-customRésout une URL vers un chemin de script
PUT
/api/v1/exec/templates/update-custom/{name}Découvre toutes les routes
DELETE
/api/v1/exec/templates/delete-custom/{name}Teste le matching des routes

Commentaires magiques

4 endpoints
GET
/api/v1/exec/magic-comments/schemaObtenir le schéma des magic comments
GET
/api/v1/exec/magic-comments/readLire les magic comments d'un script
PUT
/api/v1/exec/magic-comments/updateMettre à jour les magic comments
POST
/api/v1/exec/magic-comments/bulk-updateMise à jour groupée sur plusieurs scripts

Dépendances et packages

9 endpoints
GET
/api/v1/exec/dependencies/bundledLister les dépendances pré-intégrées
POST
/api/v1/exec/dependencies/checkVérifier les packages manquants
POST
/api/v1/exec/dependencies/installInstaller des modules npm
GET
/api/v1/exec/package/readRead package.json
POST
/api/v1/exec/package/updateUpdate package.json
POST
/api/v1/exec/package/installInstaller des packages
POST
/api/v1/exec/package/compareComparer des packages
POST
/api/v1/exec/package/pinÉpingler des versions
POST
/api/v1/exec/package/initInitialize package.json

Routage

3 endpoints
POST
/api/v1/exec/route/resolveRésoudre vers quel script une URL pointe
POST
/api/v1/exec/route/discoverDécouvrir toutes les routes
POST
/api/v1/exec/route/testTester la correspondance des routes

Cache et état partagé

4 endpoints
POST
/api/v1/exec/cache/clearVider le cache d'exécution
POST
/api/v1/exec/shared-state/getLire l'état partagé
POST
/api/v1/exec/shared-state/setÉcrire l'état partagé
POST
/api/v1/exec/shared-state/clearVider l'état partagé

Logs

5 endpoints
GET
/api/v1/exec/logs/listLister les logs
POST
/api/v1/exec/logs/readLire un log
GET
/api/v1/exec/logs/streamDiffuser les logs en SSE
POST
/api/v1/exec/logs/searchRechercher dans les logs
DELETE
/api/v1/exec/logs/clearVider les logs

Monitoring & Magic API

6 endpoints
GET
/api/v1/exec/monitor/statsMétriques de performance
GET
/api/v1/exec/monitor/active-requestsRequêtes actives
GET
/api/v1/exec/monitor/scriptsMétriques par script
POST
/api/v1/exec/monitor/script-performanceHealth check
GET
/api/v1/exec/monitor/metricsRécupère le schéma des Magic Comments
GET
/api/v1/exec/healthLit les Magic Comments d'un script

Planifications

4 endpoints
GET
/api/v1/exec/schedules/listLister les planifications
POST
/api/v1/exec/schedules/triggerDéclencher une planification
POST
/api/v1/exec/schedules/reloadRecharger les planifications
GET
/api/v1/exec/schedules/historyHistorique des exécutions planifiées

Gestion du SDK

4 endpoints
POST
/api/v1/exec/sdk/importImporter un SDK
GET
/api/v1/exec/sdk/listLister les SDK importés
GET
/api/v1/exec/sdk/{id}Obtenir les détails d'un SDK
DELETE
/api/v1/exec/sdk/{id}Supprimer un SDK importé

OpenAPI utilisateur

6 endpoints
POST
/api/v1/exec/user-openapi/generateGénérer une spec OpenAPI
GET
/api/v1/exec/user-openapi/listLister les scripts utilisateur
POST
/api/v1/exec/user-openapi/validateValider un schéma utilisateur
GET
/api/v1/exec/user-openapi/schemaServir le fichier de schéma
GET
/api/v1/exec/user-openapi/specServir la spec générée
POST
/api/v1/exec/user-openapi/mergeFusionner des specs OpenAPI

Instances et système

3 endpoints
GET
/api/v1/exec/listLister tous les ID d'instance exec
POST
/api/v1/exec/system/restartRedémarrer le serveur
GET
/api/v1/exec/system/restart-statusObtenir l'état du redémarrage

votre code est l'API.

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

Lire la doc