feat: Add OasBundleService for bundling OpenAPI documents

- Implemented OasBundleService to bundle OpenAPI specifications with resolved references.
- Introduced helper functions for guessing file extensions and deriving document names.
- Enhanced error handling for bundling failures.

feat: Update OasConversionService to support target version

- Added functionality to specify target version for OpenAPI conversion.
- Improved version normalization and error handling for unsupported versions.

refactor: Remove OasDereferenceService

- Deleted OasDereferenceService as its functionality is now integrated into OasBundleService.

feat: Introduce OasGeneratorService for generating OpenAPI documents

- Created OasGeneratorService to generate boilerplate OpenAPI documents from JSON input.
- Added validation for required fields in the generator configuration.

refactor: Update ToolsService to use new services

- Replaced OasDereferenceService with OasBundleService in ToolsService.
- Integrated OasGeneratorService for generating OpenAPI documents.
- Updated method signatures and error handling for new service implementations.

Author: pasibun

api/openapi.json

@@ -18,11 +18,11 @@ tags:
 - description: Conversies en hulpmiddelen
   name: Tools
 paths:
-  /v1/arazzo/parse:
+  /v1/arazzo/markdown:
     post:
-      description: "Converteert een OpenAPI Arazzo specificatie naar Markdown en Mermaid.\
-        \ Body: { arazzoUrl|arazzoBody }"
-      operationId: arazzo
+      description: "Genereert alleen de Markdown-uitvoer van een Arazzo specificatie.\
+        \ Body: { oasUrl|oasBody }"
+      operationId: arazzoMarkdown
       requestBody:
         content:
           application/json:
@@ -31,9 +31,9 @@ paths:
       responses:
         "200":
           content:
-            application/json:
+            text/markdown:
               schema:
-                $ref: "#/components/schemas/ModelsArazzoVisualization"
+                type: string
           description: OK
           headers:
             API-Version:
@@ -48,25 +48,26 @@ paths:
       - apiKey: []
         clientCredentials:
         - tools
-      summary: Visualiseer Arazzo (POST)
+      summary: Arazzo Markdown (POST)
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
-  /v1/auth/clients:
+  /v1/arazzo/mermaid:
     post:
-      description: Maak een client aan via de admin API. Body bevat Email.
-      operationId: untrustClient
+      description: "Genereert alleen de Mermaid flowchart van een Arazzo specificatie.\
+        \ Body: { oasUrl|oasBody }"
+      operationId: arazzoMermaid
       requestBody:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/UntrustClientInput"
+              $ref: "#/components/schemas/OASInput"
       responses:
         "200":
           content:
-            application/json:
+            text/plain:
               schema:
-                $ref: "#/components/schemas/ModelsKeycloakClientResult"
+                type: string
           description: OK
           headers:
             API-Version:
@@ -81,22 +82,25 @@ paths:
       - apiKey: []
         clientCredentials:
         - tools
-      summary: Maak client (POST)
+      summary: Arazzo Mermaid (POST)
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
-  /v1/bruno/convert:
+  /v1/auth/clients:
     post:
-      description: "Converteert OpenAPI naar Bruno ZIP. Body: { oasUrl } of { oasBody\
-        \ } (stringified JSON of YAML)."
-      operationId: CreateBrunoCollection
+      description: Maak een client aan via de admin API. Body bevat Email.
+      operationId: untrustClient
       requestBody:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/OASInput"
+              $ref: "#/components/schemas/UntrustClientInput"
       responses:
         "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ModelsKeycloakClientResult"
           description: OK
           headers:
             API-Version:
@@ -111,14 +115,15 @@ paths:
       - apiKey: []
         clientCredentials:
         - tools
-      summary: Maak Bruno-collectie (POST)
+      summary: Maak client (POST)
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
   /v1/oas/convert:
     post:
-      description: "Zet OpenAPI 3.0 om naar 3.1 of andersom. Body: { oasUrl } of {\
-        \ oasBody } (stringified JSON of YAML)."
+      description: "Converteert OpenAPI naar de laatst ondersteunde versie (standaard\
+        \ 3.1). Meegegeven targetVersion (3.0 of 3.1) bepaalt het doel. Body: { oasUrl\
+        \ } of { oasBody } (stringified JSON of YAML)."
       operationId: ConvertOAS
       requestBody:
         content:
@@ -145,11 +150,11 @@ paths:
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
-  /v1/oas/dereference:
+  /v1/oas/bundle:
     post:
-      description: "Haalt externe $ref verwijzingen op en levert één compleet OpenAPI\
-        \ document terug. Body: { oasUrl } of { oasBody }."
-      operationId: DereferenceOAS
+      description: "Bundelt een OpenAPI specificatie en lost externe verwijzingen\
+        \ op. Body: { oasUrl } of { oasBody }."
+      operationId: bundleOAS
       requestBody:
         content:
           application/json:
@@ -171,14 +176,14 @@ paths:
       - apiKey: []
         clientCredentials:
         - tools
-      summary: Dereference OpenAPI
+      summary: Bundle OpenAPI
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
   /v1/oas/generate:
     post:
-      description: "Zet OpenAPI 3.0 om naar 3.1 of andersom. Body: { oasUrl } of {\
-        \ oasBody } (stringified JSON of YAML)."
+      description: "Genereert een boilerplate OpenAPI specificatie op basis van JSON-invoer.\
+        \ Body: { oasUrl } of { oasBody } (stringified JSON)."
       operationId: GenerateOAS
       requestBody:
         content:
@@ -195,6 +200,10 @@ paths:
               schema:
                 type: string
               style: simple
+          content:
+            application/json:
+              schema:
+                type: object
         "404":
           description: Not Found
       security:
@@ -239,7 +248,7 @@ paths:
       tags:
       - Tools
       x-eov-operation-handler: controllers/ToolsController
-  /v1/postman/convert:
+  /v1/oas/postman:
     post:
       description: "Converteert OpenAPI naar Postman Collection JSON. Body: { oasUrl\
         \ } of { oasBody } (stringified JSON of YAML)."
@@ -289,20 +298,14 @@ components:
       example:
         oasUrl: oasUrl
         oasBody: oasBody
+        targetVersion: "3.1"
       properties:
         oasBody:
           type: string
         oasUrl:
           type: string
-      type: object
-    ModelsArazzoVisualization:
-      example:
-        mermaid: mermaid
-        markdown: markdown
-      properties:
-        markdown:
-          type: string
-        mermaid:
+        targetVersion:
+          description: Doelversie voor conversie (momenteel 3.0 of 3.1).
           type: string
       type: object
     ModelsKeycloakClientResult:

api/openapi.yaml

@@ -9,24 +9,24 @@
 const Controller = require("./Controller");
 const service = require("../services/ToolsService");
 
-const arazzo = async (request, response) => {
-  await Controller.handleRequest(request, response, service.arazzo);
+const arazzoMarkdown = async (request, response) => {
+  await Controller.handleRequest(request, response, service.arazzoMarkdown);
 };
 
-const convertOAS = async (request, response) => {
-  await Controller.handleRequest(request, response, service.convertOAS);
+const arazzoMermaid = async (request, response) => {
+  await Controller.handleRequest(request, response, service.arazzoMermaid);
 };
 
-const createBrunoCollection = async (request, response) => {
-  await Controller.handleRequest(request, response, service.createBrunoCollection);
+const convertOAS = async (request, response) => {
+  await Controller.handleRequest(request, response, service.convertOAS);
 };
 
 const createPostmanCollection = async (request, response) => {
   await Controller.handleRequest(request, response, service.createPostmanCollection);
 };
 
-const dereferenceOAS = async (request, response) => {
-  await Controller.handleRequest(request, response, service.dereferenceOAS);
+const bundleOAS = async (request, response) => {
+  await Controller.handleRequest(request, response, service.bundleOAS);
 };
 
 const generateOAS = async (request, response) => {
@@ -42,11 +42,11 @@ const validatorOpenAPIPost = async (request, response) => {
 };
 
 module.exports = {
-  arazzo,
+  arazzoMarkdown,
+  arazzoMermaid,
   convertOAS,
-  createBrunoCollection,
   createPostmanCollection,
-  dereferenceOAS,
+  bundleOAS,
   generateOAS,
   untrustClient,
   validatorOpenAPIPost,

controllers/ToolsController.js

@@ -140,15 +140,9 @@ class ExpressServer {
       res.set("API-Version", this.schema.info.version);
       next();
     });
-    this.app.get("/openapi.json", (_req, res) => res.json(this.schema));
-    this.app.get("/login-redirect", (req, res) => {
-      res.status(200);
-      res.json(req.query);
-    });
-    this.app.get("/oauth2-redirect.html", (req, res) => {
-      res.status(200);
-      res.json(req.query);
-    });
+    const sendOpenApiSpec = (_req, res) => res.json(this.schema);
+    this.app.get("/openapi.json", sendOpenApiSpec);
+    this.app.get("/v1/openapi", sendOpenApiSpec);
     this.app.use(
       OpenApiValidator.middleware({
         apiSpec: this.schema,