Zum Inhalt springen
Home / Kit / Exec
ExecHOODY EXEC

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

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

Exec / hello.ts

// @mode serverless

// @cors reflective

// @token my-secret-key

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

# Live unter:

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

Sofortiger HTTP-Endpunkt – keine Konfiguration nötig
home / kit / exec / modes
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 10
  • Frisches V8-Isolate pro Anfrage
  • Vollständige Isolation, kein Zustandsabfluss
  • Konfigurierbare Parallelität über @concurrent
  • Ideal für Webhooks und sporadischen Traffic
home / kit / exec / magic-carousel
MAGIC COMMENTS

Jedes Verhalten. Eine Zeile.

Fuege einen Kommentar oben in deine Datei ein. Keine Code-Änderungen, keine Konfigurationsdateien, keine Middleware. Aendere 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 30000

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 10

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

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 true

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

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

CLOUD
// @aws true

AWS-Integration

Das AWS SDK innerhalb deines Skripts mit einem einzigen Kommentar aktivieren. S3, DynamoDB, Lambda und andere AWS-Services zugreifen – keine Anmeldeinformationen erforderlich, IAM-Rollen über Container-Auth.

home / kit / exec / accordion
REFERENCE

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
home / kit / exec / use-cases
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. Sicherheitspruefungen hinzufuegen, Prompts modifizieren, sensible Daten blockieren, Nutzung tracken — alles in einem Skript.

Rate Limiting

IP-bezogene Anfragezaehler 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.

home / kit / exec / endpoints
50+ ENDPUNKTE

Jede API-Fläche. Ein Ort.

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

Monitoring & Magic API

8 Endpunkte

GET /api/v1/exec/monitor/stats

GET
/api/v1/exec/monitor/statsPerformance-Metriken
GET
/api/v1/exec/monitor/active-requestsAktive Anfragen
POST
/api/v1/exec/monitor/script-performanceMetriken pro Skript
GET
/api/v1/exec/monitor/healthHealth-Check
GET
/api/v1/exec/magic-comments/schemaMagic-Comments-Schema abrufen
GET
/api/v1/exec/magic-comments/readMagic Comments eines Skripts lesen
PUT
/api/v1/exec/magic-comments/updateMagic Comments aktualisieren
POST
/api/v1/exec/magic-comments/bulk-updateMagic Comments in Bulk aktualisieren

Ausführung & Skripte

7 Endpunkte

GET/POST /:path

GET
/:pathSkript über dateibasierten Route ausführen
POST
/:pathSkript mit Request-Body ausführen
GET
/api/v1/exec/scripts/listAlle Skripte auflisten
GET
/api/v1/exec/scripts/readSkript-Inhalt lesen
POST
/api/v1/exec/scripts/writeSkript erstellen oder aktualisieren
DELETE
/api/v1/exec/scripts/deleteSkript löschen
POST
/api/v1/exec/scripts/treeVerzeichnisbaum abrufen

Validation

6 Endpunkte

POST /api/v1/exec/validate/script

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/magic-commentsMagic Comments parsen und validieren
POST
/api/v1/exec/validate/dependenciesAbhaengigkeitsanalyse
POST
/api/v1/exec/validate/return-typeRueckgabetyp-Validierung

Templates & Routing

6 Endpunkte

GET /api/v1/exec/templates/list

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/route/resolveURL zum Skript-Pfad auflösen
POST
/api/v1/exec/route/discoverAlle Routen entdecken
POST
/api/v1/exec/route/testRouten-Matching testen
Home / Kit / Exec / CTA

Dein Code ist die API.

Schreib eine TypeScript-Funktion. Fuege einen Kommentar hinzu. Sie ist live.

Docs lesen