Importare un file TypeSpec

TypeSpec (Microsoft) descrive un’API in un linguaggio dedicato e poi la compila verso OpenAPI. Restorm segue questa stessa strada.

Importare

File ▸ Importa (Ctrl+I) e poi un file .tsp del disco.

Restorm compila il file verso OpenAPI 3.x con il proprio compilatore TypeSpec incluso, poi passa il risultato all’importazione OpenAPI. Si ottiene quindi esattamente lo stesso albero ricco: cartelle per etichetta, richieste tipizzate, documentazione, sicurezza precablata.

Modello di fiducia

Il contenuto .tsp viene copiato in una cartella temporanea isolata, nella quale Restorm monta le proprie dipendenze. Conseguenza: un tspconfig.yaml o un node_modules presenti accanto al file di origine non vengono mai consultati. La compilazione non può quindi eseguire codice arbitrario proveniente dall’albero dei file dell’utente.

Limiti

• Soltanto file locale. L’incollaggio e l’importazione tramite URL vengono rifiutati con un messaggio esplicito.
• Specifica in un solo file. Gli import relativi verso .tsp vicini non vengono risolti — conseguenza diretta dell’isolamento descritto sopra. Se il modello è suddiviso in più file, conviene compilarlo da sé verso OpenAPI e importare il risultato.