Eine TypeSpec-Datei importieren

TypeSpec (Microsoft) beschreibt eine API in einer eigenen Sprache und kompiliert sie anschließend nach OpenAPI. Restorm geht denselben Weg.

Importieren

Datei ▸ Importieren (Ctrl+I), dann eine .tsp-Datei von der Festplatte.

Restorm kompiliert die Datei mit seinem eingebetteten TypeSpec-Compiler nach OpenAPI 3.x und übergibt das Ergebnis dann an den OpenAPI-Import. Sie erhalten also genau denselben reichhaltigen Baum: Ordner nach Tag, typisierte Anfragen, Dokumentation, vorverdrahtete Sicherheit.

Vertrauensmodell

Der .tsp-Inhalt wird in einen isolierten temporären Ordner kopiert, in dem Restorm seine eigenen Abhängigkeiten einbindet. Konsequenz: Eine tspconfig.yaml- oder eine node_modules-Datei neben Ihrer Quelldatei werden niemals herangezogen. Die Kompilierung kann also keinen beliebigen Code aus Ihrem Verzeichnisbaum ausführen.

Grenzen

• Nur lokale Dateien. Einfügen und Import per URL werden mit einer eindeutigen Meldung abgelehnt.
• Spezifikation in einer einzigen Datei. Relative Importe zu benachbarten .tsp-Dateien werden nicht aufgelöst – eine direkte Folge der oben beschriebenen Isolation. Kompilieren Sie in diesem Fall selbst nach OpenAPI und importieren Sie das Ergebnis, falls Ihr Modell auf mehrere Dateien verteilt ist.