Zum Inhalt springen
Datei = API
V8-Isolates
Zero Config
Magic Comments
Auto-Installation von Abhängigkeiten
WebSocket-Unterstützung
TypeScript Native
300+ KI-Modelle
Datei = API
V8-Isolates
Zero Config
Magic Comments
Auto-Installation von Abhängigkeiten
WebSocket-Unterstützung
TypeScript Native
300+ KI-Modelle
Datei = API
V8-Isolates
Zero Config
Magic Comments
Auto-Installation von Abhängigkeiten
WebSocket-Unterstützung
TypeScript Native
300+ KI-Modelle
Datei = API
V8-Isolates
Zero Config
Magic Comments
Auto-Installation von Abhängigkeiten
WebSocket-Unterstützung
TypeScript Native
300+ KI-Modelle
ExecHOODY EXEC

Deine Dateien sind APIs. Ein Kommentar verändert alles.

Schreib eine TypeScript-Funktion — sie ist sofort ein Live-HTTP-Endpunkt. Füge einen Kommentar hinzu, um Auth, CORS, Modus oder AI zu steuern. Keine Konfigurationsdateien, keine Middleware.

Dokumentation ansehen
Exec / hello.ts

// @mode serverless

// @cors reflective

// @timeout 5000

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

# Live unter:

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

Sofortiger HTTP-Endpunkt – keine Konfiguration nötig
AUSFÜHRUNGSMODI

Zwei Modi. Ein Kommentar.

Jedes Skript wählt einen Modus. Worker für zustandsbehaftete Echtzeit-Apps. Serverless für isolierte, ephemere Ausführung. Ein Kommentar — das ist alles.

Worker-Modus

// @mode worker
  • Persistentes V8-Isolate – bleibt dauerhaft warm
  • Gemeinsamer Zustand über alle Anfragen
  • WebSocket unterstützt
  • Kein Cold-Start nach der ersten Anfrage

Serverless-Modus

// @mode serverless // @concurrent 5
  • Frisches V8-Isolate pro Anfrage
  • Vollständige Isolation, kein Zustandsabfluss
  • Konfigurierbare Parallelität über @concurrent
  • Ideal für Webhooks und sporadischen Traffic
MAGIC COMMENTS

Jedes Verhalten. Eine Zeile.

Füge einen Kommentar oben in deine Datei ein. Keine Code-Änderungen, keine Konfigurationsdateien, keine Middleware. Ändere den Kommentar — das Verhalten ändert sich sofort.

AUSFÜHRUNG
// @mode worker

Ausführungsmodus

Wähle zwischen einem persistenten Worker-VM oder einem frischen Serverless-Isolate pro Anfrage. Bestimmt Zustand, WebSocket-Unterstützung und Cold-Start-Verhalten.

NETZWERK
// @cors reflective

CORS-Steuerung

Anfrage-Origin mit 'reflective' spiegeln, alle Origins mit '*' öffnen, oder auf eine spezifische URL sperren. Standard ist no-cors für private Endpunkte.

LIMITS
// @timeout 60000

Anfrage-Timeout

Timeout in Millisekunden setzen. Standard ist 30s. 0 oder 'unlimited' für lang laufende Skripte verwenden. Verhindert hängende Anfragen in der Produktion.

LIMITS
// @concurrent false

Parallelitaetslimit

Nur Serverless: simultane Ausführungen begrenzen. Auf 'false' für serielle Verarbeitung setzen – essentiell für Writes auf dieselbe Datenbank.

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

Endpunkt-Auth

Jeden Endpunkt mit einem gemeinsamen Geheimnis schützen. Clients authentifizieren sich via Bearer, Basic, X-Token-Header oder ?token= Query-Parameter.

REALTIME
// @websocket

WebSocket-Unterstützung

Echtzeit-bidirektionale Verbindungen aktivieren. Erfordert Worker-Modus. ws.message, ws.open, ws.close Handler mit nativen WebSocket-Events verdrahtet.

AI
// @ai true

AI-Helfer

Injiziert generateText, streamText, generateObject aus dem Vercel AI SDK. Keine Imports, kein API-Schlüssel-Setup. Schreibe KI-fähige Endpunkte mit einem Kommentar.

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

AI-Modell-Auswahl

Überschreibe das Modell pro Skript. Standard ist google/gemini-2.5-flash-lite, mit Zugriff auf mehr als 300 Modelle von über 15 Inferenz-Anbietern über Hoody AI.

LOGGING
// @log-level full

Log-Ausführlichkeit

Stelle das Logging ein – von none und minimal über standard (Default) bis full und debug. Kein externer Logging-Stack zum Verkabeln.

REFERENZ

Vollständige Magic-Comment-Referenz.

Jeder Kommentar, jeder Wert, jeder Standard. Alles an einem Ort.

@modeAUSFÜHRUNG

Legt den Ausführungsmodus des Skripts fest. 'worker' erstellt eine persistente VM; 'serverless' (Standard) erstellt pro Anfrage eine neue VM.

SYNTAX

// @mode worker // @mode serverless
ANWENDUNGSFÄLLE

Vom Webhook zum WebSocket in Minuten.

Sechs Muster für die ganze Bandbreite — von sofortigen HTTP-APIs bis zu Echtzeit-AI-Proxies.

Sofort-APIs

Express-Setup komplett überspringen. Datei erstellen — sie ist ein Live-HTTP-Endpunkt. Worker für hohen Traffic, Serverless für Isolation.

Webhook-Empfaenger

Stripe-, GitHub-, Slack-Webhooks mit Serverless-Isolation. @concurrent false für serielle Verarbeitung und konsistente Reihenfolge verwenden.

WebSocket-Server

Chat-Server, Live-Dashboards, SSE-Streams. Worker-Modus haelt persistente Verbindungen mit gemeinsamem Room-State aufrecht.

AI-MITM-Proxy

AI-Anfragen abfangen und steuern. Sicherheitsprüfungen hinzufügen, Prompts modifizieren, sensible Daten blockieren, Nutzung tracken — alles in einem Skript.

Rate Limiting

IP-bezogene Anfragezähler im gemeinsamen Objekt über Anfragen hinweg verfolgen. Worker-Modus macht In-Memory-Rate-Limiting trivial.

Skript-Komposition

Jedes Skript ist ein HTTP-Endpunkt. Andere Skripte mit fetch() aufrufen. Microservices aus einfachen Funktionen komponieren — keine Queues nötig.

50+ ENDPUNKTE

Jede API-Fläche. Ein Ort.

Skript-Ausführung, Verwaltung, Validierung, Templates, Routing, Monitoring und Magic-Comment-Steuerung — alles in einer API.

67 dokumentierte Endpointshttps://abc123-def456-exec-1.node-us-1.containers.hoody.com

Script-Ausführung

1 Endpoint
POST
/{path}Jedes Script über seine dateibasierte Route ausführen

Script-Management

6 Endpoints
GET
/api/v1/exec/scripts/readScript-Inhalt lesen
POST
/api/v1/exec/scripts/writeEin Script anlegen oder aktualisieren
DELETE
/api/v1/exec/scripts/deleteEin Script löschen
GET
/api/v1/exec/scripts/listAlle Scripts auflisten
POST
/api/v1/exec/scripts/treeDen Verzeichnisbaum abrufen
POST
/api/v1/exec/scripts/moveEin Script verschieben oder umbenennen

Validierung

6 Endpoints
POST
/api/v1/exec/validate/scriptUmfassende Skript-Validierung
POST
/api/v1/exec/validate/typescriptTypeScript-Typüberprüfung
POST
/api/v1/exec/validate/syntaxSyntax-Validierung
POST
/api/v1/exec/validate/dependenciesMagic Comments parsen und validieren
POST
/api/v1/exec/validate/return-typeAbhaengigkeitsanalyse
POST
/api/v1/exec/validate/magic-commentsRueckgabetyp-Validierung

Templates & Routing

6 Endpoints
GET
/api/v1/exec/templates/listVerfügbare Templates auflisten
GET
/api/v1/exec/templates/previewTemplate vorschau anzeigen
POST
/api/v1/exec/templates/generateSkript aus Template erstellen
POST
/api/v1/exec/templates/create-customURL zum Skript-Pfad auflösen
PUT
/api/v1/exec/templates/update-custom/{name}Alle Routen entdecken
DELETE
/api/v1/exec/templates/delete-custom/{name}Routen-Matching testen

Magic Comments

4 Endpoints
GET
/api/v1/exec/magic-comments/schemaDas Magic-Comments-Schema abrufen
GET
/api/v1/exec/magic-comments/readDie Magic Comments eines Scripts lesen
PUT
/api/v1/exec/magic-comments/updateMagic Comments aktualisieren
POST
/api/v1/exec/magic-comments/bulk-updateBulk-Update über mehrere Scripts

Dependencies & Packages

9 Endpoints
GET
/api/v1/exec/dependencies/bundledVorgebündelte Dependencies auflisten
POST
/api/v1/exec/dependencies/checkAuf fehlende Packages prüfen
POST
/api/v1/exec/dependencies/installnpm-Module installieren
GET
/api/v1/exec/package/readRead package.json
POST
/api/v1/exec/package/updateUpdate package.json
POST
/api/v1/exec/package/installPackages installieren
POST
/api/v1/exec/package/comparePackages vergleichen
POST
/api/v1/exec/package/pinVersionen pinnen
POST
/api/v1/exec/package/initInitialize package.json

Routing

3 Endpoints
POST
/api/v1/exec/route/resolveAuflösen, auf welches Script eine URL zeigt
POST
/api/v1/exec/route/discoverAlle Routes entdecken
POST
/api/v1/exec/route/testRoute-Matching testen

Cache & Shared State

4 Endpoints
POST
/api/v1/exec/cache/clearDen Execution-Cache leeren
POST
/api/v1/exec/shared-state/getShared State lesen
POST
/api/v1/exec/shared-state/setShared State schreiben
POST
/api/v1/exec/shared-state/clearShared State leeren

Logs

5 Endpoints
GET
/api/v1/exec/logs/listLogs auflisten
POST
/api/v1/exec/logs/readEin Log lesen
GET
/api/v1/exec/logs/streamLogs über SSE streamen
POST
/api/v1/exec/logs/searchLogs durchsuchen
DELETE
/api/v1/exec/logs/clearLogs leeren

Monitoring & Magic API

6 Endpoints
GET
/api/v1/exec/monitor/statsPerformance-Metriken
GET
/api/v1/exec/monitor/active-requestsAktive Anfragen
GET
/api/v1/exec/monitor/scriptsMetriken pro Skript
POST
/api/v1/exec/monitor/script-performanceHealth-Check
GET
/api/v1/exec/monitor/metricsMagic-Comments-Schema abrufen
GET
/api/v1/exec/healthMagic Comments eines Skripts lesen

Schedules

4 Endpoints
GET
/api/v1/exec/schedules/listSchedules auflisten
POST
/api/v1/exec/schedules/triggerEinen Schedule auslösen
POST
/api/v1/exec/schedules/reloadSchedules neu laden
GET
/api/v1/exec/schedules/historyRun-History eines Schedules

SDK-Management

4 Endpoints
POST
/api/v1/exec/sdk/importEin SDK importieren
GET
/api/v1/exec/sdk/listImportierte SDKs auflisten
GET
/api/v1/exec/sdk/{id}SDK-Details abrufen
DELETE
/api/v1/exec/sdk/{id}Ein importiertes SDK löschen

User OpenAPI

6 Endpoints
POST
/api/v1/exec/user-openapi/generateEine OpenAPI-Spec generieren
GET
/api/v1/exec/user-openapi/listUser-Scripts auflisten
POST
/api/v1/exec/user-openapi/validateEin User-Schema validieren
GET
/api/v1/exec/user-openapi/schemaDie Schema-Datei ausliefern
GET
/api/v1/exec/user-openapi/specDie generierte Spec ausliefern
POST
/api/v1/exec/user-openapi/mergeOpenAPI-Specs zusammenführen

Instances & System

3 Endpoints
GET
/api/v1/exec/listAlle exec-Instanz-IDs auflisten
POST
/api/v1/exec/system/restartDen Server neu starten
GET
/api/v1/exec/system/restart-statusRestart-Status abrufen

Dein Code ist die API.

Schreib eine TypeScript-Funktion. Füge einen Kommentar hinzu. Sie ist live.

Docs lesen