Importar um ficheiro TypeSpec

O TypeSpec (Microsoft) descreve uma API numa linguagem dedicada e compila-a depois para OpenAPI. O Restorm segue esse mesmo caminho.

Importar

Ficheiro ▸ Importar (Ctrl+I) e depois um ficheiro .tsp do disco.

O Restorm compila o ficheiro para OpenAPI 3.x com o seu compilador TypeSpec integrado e passa em seguida o resultado à importação OpenAPI. Obtém, portanto, exatamente a mesma árvore rica: pastas por etiqueta, pedidos tipados, documentação, segurança já preparada.

Modelo de confiança

O conteúdo .tsp é copiado para uma pasta temporária isolada, na qual o Restorm monta as suas próprias dependências. Consequência: um tspconfig.yaml ou um node_modules presentes ao lado do seu ficheiro de origem nunca são consultados. A compilação não pode, por isso, executar código arbitrário proveniente da sua árvore de ficheiros.

Limites

• Apenas ficheiro local. A colagem e a importação por URL são recusadas com uma mensagem explícita.
• Especificação num único ficheiro. As importações relativas para .tsp vizinhos não são resolvidas — consequência direta do isolamento descrito acima. Compile você mesmo para OpenAPI e importe o resultado se o seu modelo estiver dividido em vários ficheiros.