From 63e65abd0013eb3e2e920333e4bffb25875d3bae Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 28 Jan 2024 08:38:08 +0100
Subject: [PATCH 01/20] Upgraded dependencies

---
 package.json | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/package.json b/package.json
index 0e0f8e8..74f3b62 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "node-red-node-swagger",
-    "version": "0.1.9",
+    "version": "0.2.0",
     "description": "A set of tools for generating Swagger API documentation based on the HTTP nodes deployed in a flow",
     "license": "Apache",
     "repository": {
@@ -9,10 +9,11 @@
     },
     "keywords": [
         "node-red",
-        "swagger"
+        "swagger",
+        "open-api"
     ],
     "node-red": {
-        "version": ">=0.11.0",
+        "version": ">=3.0.0",
         "nodes": {
             "swagger": "swagger/swagger.js"
         }
@@ -23,10 +24,11 @@
         "Jon Silver <js@jfdi.info>"
     ],
     "dependencies": {
-        "swagger-ui": "2.1.4",
-        "i18next-client": "1.11.4"
+        "i18next": "^23.7.20",
+        "swagger-ui": "^5.11.1",
+        "swagger-ui-dist": "^5.11.1"
     },
     "devDependencies": {
-        "eslint": "^6.4.0"
+        "eslint": "^8.56.0"
     }
 }

From 48af206708340a146f6b5ffa93a34cfd6cb4fff2 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 28 Jan 2024 08:38:20 +0100
Subject: [PATCH 02/20] updated basics in readme

---
 README.md | 76 +++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 49 insertions(+), 27 deletions(-)

diff --git a/README.md b/README.md
index 12e566a..00b41f8 100644
--- a/README.md
+++ b/README.md
@@ -13,39 +13,61 @@ based on the HTTP nodes deployed in a flow.
   
         npm install node-red/node-red-node-swagger
 
-2. Provide a template swagger file in `settings.js`:
-
-        swagger: {
-          "template": {
-            "swagger": "2.0",
-            "info": {
-              "title": "My Node-RED API",
-              "version": "0.0.1"
+2. Provide a template OpenAPI file in `settings.js`:
+
+        openapi: {
+          template: {
+            openapi: "3.0.0",
+            info: {
+              title: "My Node-RED API",
+              version: "0.0.1",
+              description: "API documentation generated by Node-RED"
+            },
+            servers: [
+              {
+                url: "http://localhost:1880/",
+                description: "Local server"
+              }
+            ],
+            paths: {},
+            components: {
+              schemas: {},
+              responses: {},
+              parameters: {},
+              securitySchemes: {}
+              // Add other components here
             }
           }
         }
 
-3. This template will remain unchanged and serve as the basis for the swagger doc.
+3. This template will remain unchanged and serve as the basis for the OpenAPI documentation.
 
-  **Note:** You may additionally add parameters to the swagger file in 'settings.js' to have those parameters automatically added to each path in the generated swagger doc.
-  
-        "swagger": {
-          "template": {
-            "swagger": "2.0",
-            "info": {
-              "title": "My Node-RED API",
-              "version": "0.0.1"
-            }
+  **Note:** You may additionally add components like `schemas`, `responses`, `parameters`, `securitySchemes`, etc., to the OpenAPI file in 'settings.js' to have those components available for reuse in the generated OpenAPI documentation.
+
+        openapi: {
+          template: {
+            // ... (rest of your OpenAPI template)
           },
-          "parameters": [
-            {
-              "name": "parameterA",
-              "type": "string",
-              "in": "header",
-              "required": false,
-              "description": "This is a test parameter to show how parameters are automatically added to each path in the generated swagger doc."
+          components: {
+            schemas: {
+              MySchema: {
+                type: "object",
+                properties: {
+                  name: {
+                    type: "string"
+                  }
+                }
+              }
+            },
+            securitySchemes: {
+              ApiKeyAuth: {
+                type: "apiKey",
+                in: "header",
+                name: "X-API-Key"
+              }
             }
-          ]
+            // Add other reusable components here
+          }
         }
 
 4. After installing the package, you have the option to identify metadata for each HTTP-In node that will be used in the swagger doc generation.
@@ -131,4 +153,4 @@ Swagger-UI is including in the plugin. Once loaded, the plugin will show a swagg
   if that value is something other than `/`.
 
   
-###### Attribute definitions provided come from the [Swagger 2.0 Spec](https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md)
\ No newline at end of file
+###### Attribute definitions provided come from the [OpenAPI Specification Version 3.1.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md)
\ No newline at end of file

From 3a23fb37327a69893279f03896d30825ee7465b4 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 10:52:01 +0100
Subject: [PATCH 03/20] ignore package-lock.json

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index b512c09..25c8fdb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
-node_modules
\ No newline at end of file
+node_modules
+package-lock.json
\ No newline at end of file

From 3e35e914297ceb280125e58e6034ca5f33f531ca Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 11:50:33 +0100
Subject: [PATCH 04/20] Basic working example compliant with openapi3

---
 swagger/swagger-ui/swagger-ui.html |  16 +-
 swagger/swagger.js                 | 278 ++++++++++++++++++++++++++---
 2 files changed, 269 insertions(+), 25 deletions(-)

diff --git a/swagger/swagger-ui/swagger-ui.html b/swagger/swagger-ui/swagger-ui.html
index ddb91e5..36cdeb8 100644
--- a/swagger/swagger-ui/swagger-ui.html
+++ b/swagger/swagger-ui/swagger-ui.html
@@ -1,13 +1,14 @@
 <html>
 <head>
   <title>Swagger UI</title>
+ <!--  
   <link href='reqs/css/typography.css' media='screen' rel='stylesheet' type='text/css'/>
   <link href='reqs/css/reset.css' media='screen' rel='stylesheet' type='text/css'/>
   <link href='reqs/css/screen.css' media='screen' rel='stylesheet' type='text/css'/>
   <link href='reqs/css/reset.css' media='print' rel='stylesheet' type='text/css'/>
   <link href='reqs/css/screen.css' media='print' rel='stylesheet' type='text/css'/>
   <link href='reqs/css/print.css' media='print' rel='stylesheet' type='text/css'/>
-  <link rel="stylesheet" href="../vendor/font-awesome/css/font-awesome.min.css">
+  
   <script src='reqs/lib/jquery-1.8.0.min.js' type='text/javascript'></script>
   <script src='reqs/lib/jquery.slideto.min.js' type='text/javascript'></script>
   <script src='reqs/lib/jquery.wiggle.min.js' type='text/javascript'></script>
@@ -15,11 +16,20 @@
   <script src='reqs/lib/handlebars-2.0.0.js' type='text/javascript'></script>
   <script src='reqs/lib/underscore-min.js' type='text/javascript'></script>
   <script src='reqs/lib/backbone-min.js' type='text/javascript'></script>
-  <script src='reqs/swagger-ui.js' type='text/javascript'></script>
+
   <script src='reqs/lib/highlight.7.3.pack.js' type='text/javascript'></script>
   <script src='reqs/lib/jsoneditor.min.js' type='text/javascript'></script>
   <script src='reqs/lib/marked.js' type='text/javascript'></script>
-  <script src='reqs/i18next.min.js' type='text/javascript'></script>
+
+     -->
+<link rel="stylesheet" href="../vendor/font-awesome/css/font-awesome.min.css">
+
+
+  <script src='i18next.min.js' type='text/javascript'></script>
+ 
+  <script src='swagger-ui.js' type='text/javascript'></script>
+
+  
   <script type="text/javascript">
     var url = parent.swaggerDocUrl;
     window.swaggerUi = new SwaggerUi({
diff --git a/swagger/swagger.js b/swagger/swagger.js
index 28d06be..15ef300 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -12,14 +12,35 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
- **/
+**/
+
+
+//const swaggerUiDistPath = require('swagger-ui-dist').getAbsoluteFSPath();
+
 
 const DEFAULT_TEMPLATE = {
-    swagger: "2.0",
+    openapi: "3.0.0",
     info: {
         title: "My Node-RED API",
-        version: "0.0.1"
-    }
+        version: "1.0.0",
+        description: "A sample API",
+        // You can also add 'termsOfService', 'contact', and 'license' information here
+    },
+    servers: [
+        {
+            url: 'http://localhost:1880/',
+            description: 'Local server'
+        },
+    ],
+    paths: {},
+    components: {
+        schemas: {},
+        responses: {},
+        parameters: {},
+        securitySchemes: {}
+    },
+    tags: [],
+    // Add more properties as needed
 };
 
 module.exports = function(RED) {
@@ -35,6 +56,7 @@ module.exports = function(RED) {
         url.length > 1 && url.endsWith("/") ? url.slice(0, -1) : url;
     const regexColons = /\/:\w*/g;
 
+    /*
     RED.httpNode.get("/http-api/swagger.json", (req, res) => {
         const {
             httpNodeRoot,
@@ -86,6 +108,159 @@ module.exports = function(RED) {
         res.json(resp);
     });
 
+    RED.httpNode.get("/http-api/swagger.json", (req, res) => {
+        // Use the default template as the base for the response
+        const openApiSpec = { ...DEFAULT_TEMPLATE };
+    
+        // Iterate over each node that could have associated API documentation
+        RED.nodes.eachNode(node => {
+            if (node.type === "http in") {
+                // Get the Swagger documentation node associated with this http in node
+                const swaggerDocNode = RED.nodes.getNode(node.swaggerDoc);
+    
+                if (swaggerDocNode) {
+                    // Construct the path for the endpoint
+                    const path = ensureLeadingSlash(node.url.replace(regexColons, convToSwaggerPath));
+    
+                    // Initialize the path object if not already initialized
+                    if (!openApiSpec.paths[path]) {
+                        openApiSpec.paths[path] = {};
+                    }
+    
+                    // Define the operation object for this method and path
+                    const operation = {
+                        summary: swaggerDocNode.summary || `${node.method.toUpperCase()} ${path}`,
+                        description: swaggerDocNode.description || '',
+                        tags: csvStrToArray(swaggerDocNode.tags),
+                        parameters: [], // This will need to be populated based on your parameter definitions
+                        responses: {} // This will need to be populated based on your response definitions
+                    };
+    
+                    // Populate parameters array
+                    // You'll need to construct your parameter objects according to OpenAPI 3.0
+                    // For example:
+                    swaggerDocNode.parameters.forEach(param => {
+                        operation.parameters.push({
+                            name: param.name,
+                            in: param.in, // 'query', 'header', 'path' or 'cookie'
+                            description: param.description,
+                            required: param.required,
+                            schema: {
+                                type: param.type
+                                // More schema properties can be set here
+                            }
+                        });
+                    });
+    
+                    // Populate responses object
+                    // You'll need to map your response objects to status codes
+                    // For example:
+                    console.log(swaggerDocNode); // Should log true if it's an array
+
+                    swaggerDocNode.responses.forEach(resp => {
+                        operation.responses[resp.code] = {
+                            description: resp.description,
+                            content: {
+                                'application/json': {
+                                    schema: {
+                                        // Define the schema for the response
+                                    }
+                                }
+                            }
+                        };
+                    });
+    
+                    // Add the operation to the path in the spec
+                    openApiSpec.paths[path][node.method.toLowerCase()] = operation;
+                }
+            }
+        });
+    
+        // Send the OpenAPI Specification as JSON
+        res.json(openApiSpec);
+    });
+        */
+
+    RED.httpNode.get("/http-api/swagger.json", (req, res) => {
+        const {
+            httpNodeRoot,
+            swagger: { parameters: additionalParams = [], template: resp = { ...DEFAULT_TEMPLATE } } = {}
+        } = RED.settings;
+        const { basePath = httpNodeRoot } = resp;
+        
+        resp.paths = {};
+    
+        RED.nodes.eachNode(node => {
+            const { name, type, method, swaggerDoc, url } = node;
+    
+            if (type === "http in") {
+                const swaggerDocNode = RED.nodes.getNode(swaggerDoc);
+                
+                if (swaggerDocNode) {
+                    const endPoint = ensureLeadingSlash(url.replace(regexColons, convToSwaggerPath));
+                    if (!resp.paths[endPoint]) resp.paths[endPoint] = {};
+    
+                    const {
+                        summary = swaggerDocNode.summary || name || method + " " + endPoint,
+                        description = swaggerDocNode.description || '',
+                        tags = swaggerDocNode.tags || '',
+                        deprecated = swaggerDocNode.deprecated || false,
+                        parameters = swaggerDocNode.parameters || []
+                    } = swaggerDocNode;
+    
+                    const aryTags = csvStrToArray(tags);
+    
+                    const operation = {
+                        summary,
+                        description,
+                        tags: aryTags,
+                        deprecated,
+                        parameters: [...parameters, ...additionalParams].map(param => {
+                            return {
+                                name: param.name,
+                                in: param.in,
+                                required: param.required,
+                                schema: {
+                                    type: param.type,
+                                    // Add other schema properties here
+                                },
+                                description: param.description
+                            };
+                        }),
+                        responses: {}
+                    };
+    
+                    // Check if responses is an object and not null or undefined
+                    if (swaggerDocNode && typeof swaggerDocNode.responses === 'object' && swaggerDocNode.responses !== null) {
+                        Object.keys(swaggerDocNode.responses).forEach(status => {
+                            const responseDetails = swaggerDocNode.responses[status];
+                            operation.responses[status] = {
+                                description: responseDetails.description || '',
+                                content: {
+                                    'application/json': {
+                                        schema: {
+                                            // Define or reference your schema here
+                                        }
+                                    }
+                                }
+                            };
+                        });
+                    } else {
+                        console.error('swaggerDocNode.responses is not an object or is null:', swaggerDocNode.responses);
+                    }
+    
+                    // Add the operation to the path in the spec
+                    resp.paths[endPoint][method.toLowerCase()] = operation;
+                } else {
+                    console.error('No Swagger Documentation node found for HTTP In node:', node.id);
+                }
+            }
+        });
+    
+        res.json(resp);
+    });
+    
+
     function SwaggerDoc(n) {
         RED.nodes.createNode(this, n);
         this.summary = n.summary;
@@ -98,7 +273,7 @@ module.exports = function(RED) {
         this.deprecated = n.deprecated;
     }
     RED.nodes.registerType("swagger-doc", SwaggerDoc);
-
+/*
     function sendFile(res, filename) {
         // Use the right function depending on Express 3.x/4.x
         if (res.sendFile) {
@@ -107,23 +282,82 @@ module.exports = function(RED) {
             res.sendfile(filename);
         }
     }
-
-    RED.httpAdmin.get("/swagger-ui/reqs/i18next.min.js", (req, res) => {
-        const basePath = require.resolve("i18next-client").replace(/[\\/]i18next.js$/, "");
-        const filename = path.join(basePath, "i18next.min.js");
-        sendFile(res, filename);
-    });
-    RED.httpAdmin.get("/swagger-ui/reqs/*", (req, res) => {
-        const basePath = require.resolve("swagger-ui").replace(/[\\/]swagger-ui.js$/, "");
-        const filename = path.join(basePath, req.params[0]);
-        sendFile(res, filename);
-    });
-    RED.httpAdmin.get("/swagger-ui/nls/*", (req, res) => {
-        const filename = path.join(__dirname, "locales", req.params[0]);
-        sendFile(res, filename);
+/*
+    RED.httpAdmin.get('/swagger-ui/*', (req, res) => {
+        const filename = req.params[0];
+        const filePath = path.join(swaggerUiDistPath, filename);
+        sendFile(res, filePath);
     });
-    RED.httpAdmin.get("/swagger-ui/*", (req, res) => {
-        const filename = path.join(__dirname, "swagger-ui", req.params[0]);
-        sendFile(res, filename);
+    
+    function sendFile(res, filePath) {
+        res.sendFile(filePath, (err) => {
+            if (err) {
+                console.error('Error sending file:', err);
+                res.status(500).send('Error sending file.');
+            }
+        });
+    }
+*/
+
+// Serve the main Swagger UI HTML file
+RED.httpAdmin.get("/swagger-ui/swagger-ui.html", (req, res) => {
+    // Correct the path to point directly to the 'swagger-ui.html' file
+    const filename = path.join(__dirname, "swagger-ui/swagger-ui.html");
+    sendFile(res, filename);
+});
+
+
+// Serve i18next localization files
+RED.httpAdmin.get("/swagger-ui/i18next.min.js", (req, res) => {
+    const filename = path.join(__dirname, '..', 'node_modules', 'i18next', 'i18next.min.js');
+    sendFile(res, filename);
+});
+
+
+// Serve Swagger UI assets like CSS and JS from swagger-ui-dist
+RED.httpAdmin.get("/swagger-ui/*", (req, res, next) => {
+    // Extract the actual file name from the request params
+    let filename = req.params[0];
+    
+    // If the filename is 'swagger-ui.html', redirect to the correct handler
+    if (filename === 'swagger-ui.html') {
+        return next();
+    }
+
+    // Serve the file from swagger-ui-dist
+    try {
+        const basePath = require('swagger-ui-dist').getAbsoluteFSPath();
+        const filePath = path.join(basePath, filename);
+        sendFile(res, filePath);
+    } catch (err) {
+        console.error(err);
+        res.status(404).send("File not found");
+    }
+}, (req, res) => {
+    // Fallback handler for 'swagger-ui.html', in case the above handler is triggered
+    // due to the way Express handles wildcard routes
+    const filename = path.join(__dirname, "swagger", "swagger-ui.html");
+    sendFile(res, filename);
+});
+
+// Serve any other localization files
+RED.httpAdmin.get("/swagger-ui/nls/*", (req, res) => {
+    const filename = path.join(__dirname, "locales", req.params[0]);
+    sendFile(res, filename);
+});
+
+// Generic function to send files
+function sendFile(res, filePath) {
+    // Implement the logic to send the file
+    // For example, using Express' res.sendFile:
+    res.sendFile(filePath, (err) => {
+        if (err) {
+            console.error('Error sending file:', err);
+            res.status(err.status || 500).send('Error sending file.');
+        }
     });
+}
+    
+
+    
 };

From 0262ff34626a6792c2f9f07bcdb3ebe294f88ed7 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 11:58:45 +0100
Subject: [PATCH 05/20] Removed schema if not set

---
 swagger/swagger.js | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/swagger/swagger.js b/swagger/swagger.js
index 15ef300..e021559 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -235,15 +235,16 @@ module.exports = function(RED) {
                         Object.keys(swaggerDocNode.responses).forEach(status => {
                             const responseDetails = swaggerDocNode.responses[status];
                             operation.responses[status] = {
-                                description: responseDetails.description || '',
-                                content: {
-                                    'application/json': {
-                                        schema: {
-                                            // Define or reference your schema here
-                                        }
-                                    }
-                                }
+                                description: responseDetails.description || 'No description',
+                                content: {}
                             };
+                        
+                            // Conditionally add schema if it's set
+                            if (responseDetails.schema) {
+                                operation.responses[status].content['application/json'] = {
+                                    schema: responseDetails.schema
+                                };
+                            }
                         });
                     } else {
                         console.error('swaggerDocNode.responses is not an object or is null:', swaggerDocNode.responses);

From e2038bed5dad60a3ad912fb9697fe9cff73a36e3 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 13:48:45 +0100
Subject: [PATCH 06/20] Removed unused code

---
 swagger/swagger.js | 148 ++++++++-------------------------------------
 1 file changed, 24 insertions(+), 124 deletions(-)

diff --git a/swagger/swagger.js b/swagger/swagger.js
index e021559..d51ae78 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -43,6 +43,8 @@ const DEFAULT_TEMPLATE = {
     // Add more properties as needed
 };
 
+
+
 module.exports = function(RED) {
     "use strict";
 
@@ -56,130 +58,7 @@ module.exports = function(RED) {
         url.length > 1 && url.endsWith("/") ? url.slice(0, -1) : url;
     const regexColons = /\/:\w*/g;
 
-    /*
-    RED.httpNode.get("/http-api/swagger.json", (req, res) => {
-        const {
-            httpNodeRoot,
-            swagger: { parameters: additionalParams = [], template: resp = { ...DEFAULT_TEMPLATE } } = {}
-        } = RED.settings;
-        const { basePath = httpNodeRoot } = resp;
-        resp.basePath = stripTerminalSlash(basePath);
-        resp.paths = {};
-
-        RED.nodes.eachNode(node => {
-            const { name, type, method, swaggerDoc, url } = node;
-
-            if (type === "http in") {
-                const swagger = RED.nodes.getNode(swaggerDoc);
-                const endPoint = ensureLeadingSlash(url.replace(regexColons, convToSwaggerPath));
-                if (!resp.paths[endPoint]) resp.paths[endPoint] = {};
-
-                const {
-                    summary = name || method + " " + endPoint,
-                    description = "",
-                    tags = "",
-                    consumes,
-                    produces,
-                    deprecated,
-                    parameters = [],
-                    responses = {
-                        default: {
-                            description: ""
-                        }
-                    }
-                } = swagger || {};
-                
-                const aryTags = csvStrToArray(tags),
-                    aryConsumes = csvStrToArray(consumes),
-                    aryProduces = csvStrToArray(produces);
-
-                resp.paths[endPoint][method] = {
-                    summary,
-                    description,
-                    tags: aryTags,
-                    consumes: aryConsumes,
-                    produces: aryProduces,
-                    deprecated,
-                    parameters: [...parameters, ...additionalParams],
-                    responses
-                };
-            }
-        });
-        res.json(resp);
-    });
-
-    RED.httpNode.get("/http-api/swagger.json", (req, res) => {
-        // Use the default template as the base for the response
-        const openApiSpec = { ...DEFAULT_TEMPLATE };
-    
-        // Iterate over each node that could have associated API documentation
-        RED.nodes.eachNode(node => {
-            if (node.type === "http in") {
-                // Get the Swagger documentation node associated with this http in node
-                const swaggerDocNode = RED.nodes.getNode(node.swaggerDoc);
-    
-                if (swaggerDocNode) {
-                    // Construct the path for the endpoint
-                    const path = ensureLeadingSlash(node.url.replace(regexColons, convToSwaggerPath));
-    
-                    // Initialize the path object if not already initialized
-                    if (!openApiSpec.paths[path]) {
-                        openApiSpec.paths[path] = {};
-                    }
-    
-                    // Define the operation object for this method and path
-                    const operation = {
-                        summary: swaggerDocNode.summary || `${node.method.toUpperCase()} ${path}`,
-                        description: swaggerDocNode.description || '',
-                        tags: csvStrToArray(swaggerDocNode.tags),
-                        parameters: [], // This will need to be populated based on your parameter definitions
-                        responses: {} // This will need to be populated based on your response definitions
-                    };
-    
-                    // Populate parameters array
-                    // You'll need to construct your parameter objects according to OpenAPI 3.0
-                    // For example:
-                    swaggerDocNode.parameters.forEach(param => {
-                        operation.parameters.push({
-                            name: param.name,
-                            in: param.in, // 'query', 'header', 'path' or 'cookie'
-                            description: param.description,
-                            required: param.required,
-                            schema: {
-                                type: param.type
-                                // More schema properties can be set here
-                            }
-                        });
-                    });
-    
-                    // Populate responses object
-                    // You'll need to map your response objects to status codes
-                    // For example:
-                    console.log(swaggerDocNode); // Should log true if it's an array
 
-                    swaggerDocNode.responses.forEach(resp => {
-                        operation.responses[resp.code] = {
-                            description: resp.description,
-                            content: {
-                                'application/json': {
-                                    schema: {
-                                        // Define the schema for the response
-                                    }
-                                }
-                            }
-                        };
-                    });
-    
-                    // Add the operation to the path in the spec
-                    openApiSpec.paths[path][node.method.toLowerCase()] = operation;
-                }
-            }
-        });
-    
-        // Send the OpenAPI Specification as JSON
-        res.json(openApiSpec);
-    });
-        */
 
     RED.httpNode.get("/http-api/swagger.json", (req, res) => {
         const {
@@ -257,10 +136,31 @@ module.exports = function(RED) {
                 }
             }
         });
-    
+         // Final cleanup to remove empty sections
+    cleanupOpenAPISpec(resp);
         res.json(resp);
     });
     
+    function cleanupOpenAPISpec(spec) {
+    // Clean up components
+    if (spec.components) {
+        ['schemas', 'responses', 'parameters', 'securitySchemes'].forEach(key => {
+            if (spec.components[key] && Object.keys(spec.components[key]).length === 0) {
+                delete spec.components[key];
+            }
+        });
+
+        // If all components are empty, remove the components object itself
+        if (Object.keys(spec.components).length === 0) {
+            delete spec.components;
+        }
+    }
+
+    // Clean up empty tags array
+    if (Array.isArray(spec.tags) && spec.tags.length === 0) {
+        delete spec.tags;
+    }
+}
 
     function SwaggerDoc(n) {
         RED.nodes.createNode(this, n);

From f0d8446a24b71c66607633075873b78e3aad08a4 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 16:43:47 +0100
Subject: [PATCH 07/20] Swagger-UI working

---
 swagger/swagger-ui/swagger-ui.html | 178 +++++------------------------
 1 file changed, 28 insertions(+), 150 deletions(-)

diff --git a/swagger/swagger-ui/swagger-ui.html b/swagger/swagger-ui/swagger-ui.html
index 36cdeb8..3b04787 100644
--- a/swagger/swagger-ui/swagger-ui.html
+++ b/swagger/swagger-ui/swagger-ui.html
@@ -1,157 +1,35 @@
+<!DOCTYPE html>
 <html>
 <head>
   <title>Swagger UI</title>
- <!--  
-  <link href='reqs/css/typography.css' media='screen' rel='stylesheet' type='text/css'/>
-  <link href='reqs/css/reset.css' media='screen' rel='stylesheet' type='text/css'/>
-  <link href='reqs/css/screen.css' media='screen' rel='stylesheet' type='text/css'/>
-  <link href='reqs/css/reset.css' media='print' rel='stylesheet' type='text/css'/>
-  <link href='reqs/css/screen.css' media='print' rel='stylesheet' type='text/css'/>
-  <link href='reqs/css/print.css' media='print' rel='stylesheet' type='text/css'/>
-  
-  <script src='reqs/lib/jquery-1.8.0.min.js' type='text/javascript'></script>
-  <script src='reqs/lib/jquery.slideto.min.js' type='text/javascript'></script>
-  <script src='reqs/lib/jquery.wiggle.min.js' type='text/javascript'></script>
-  <script src='reqs/lib/jquery.ba-bbq.min.js' type='text/javascript'></script>
-  <script src='reqs/lib/handlebars-2.0.0.js' type='text/javascript'></script>
-  <script src='reqs/lib/underscore-min.js' type='text/javascript'></script>
-  <script src='reqs/lib/backbone-min.js' type='text/javascript'></script>
-
-  <script src='reqs/lib/highlight.7.3.pack.js' type='text/javascript'></script>
-  <script src='reqs/lib/jsoneditor.min.js' type='text/javascript'></script>
-  <script src='reqs/lib/marked.js' type='text/javascript'></script>
-
-     -->
-<link rel="stylesheet" href="../vendor/font-awesome/css/font-awesome.min.css">
-
-
-  <script src='i18next.min.js' type='text/javascript'></script>
- 
-  <script src='swagger-ui.js' type='text/javascript'></script>
-
-  
-  <script type="text/javascript">
-    var url = parent.swaggerDocUrl;
-    window.swaggerUi = new SwaggerUi({
-      url: url,
-      dom_id: "swagger-ui-container",
-	  validatorUrl: null,
-      onComplete: function(data) {
-        if(window.swaggerUi.api.apisArray.length == 0){
-            $('.empty-swagger-doc').show(1000);
-        } else{
-            $('.empty-swagger-doc').hide(1000);
-        }
-      },
-      onFailure: function(data) {
-		console.log("Unable to load SwaggerUI");
-      },
-    });
-    i18n.init({
-        resGetPath: 'nls/__lng__/__ns__.json',
-        load: 'current',
-        ns: 'swagger',
-        fallbackLng: 'en-us'
-    }, function() {
-        $('.empty-swagger-doc').i18n();
-    });
-  </script>
-  <style>
-    .empty-swagger-doc {
-      margin: 10px;
-      padding: 10px;
-      background-color: #5AAAFA;
-      border-radius: 5px;
-      font-family: Helvetica Neue, Helvetica, sans-serif;
-      font-size: 14px;
-      line-height: 150%;
-    }
-
-    .empty-swagger-doc h2 {
-        font-weight: bold;
-        font-size: 16px;
-        text-align: center;
-    }
-
-    .empty-swagger-doc p {
-        padding: 10px 0px;
-    }
-  </style>
-<!-- Styling mods by JS -->
-<style>
-    .swagger-section .swagger-ui-wrap ul#resources .resource .endpoints .endpoint .operations .operation .heading h3 .path {
-        font-size: small;
-        font-weight: 600;
-        display: block;
-        margin: 5px 0;
-    }
-
-    .swagger-section .swagger-ui-wrap ul#resources li.resource ul.endpoints li.endpoint ul.operations li.operation div.heading ul.options {
-        margin: 5px 10px 5px 0;
-    }
-
-    .swagger-section .swagger-ui-wrap h4 {
-        font-weight: 600;
-    }
-
-    .swagger-section .swagger-ui-wrap input.parameter {
-        padding: 5px 5px;
-        border-color: #bbb;
-        border-radius: 4px;
-    }
-
-    .swagger-section .swagger-ui-wrap input.parameter::placeholder {
-        color: #bbb;font-weight: 100;
-    }
- 
-    .swagger-section .swagger-ui-wrap th {
-        font-weight: 600;
-        line-height: 1.2;
-    }
-    .swagger-section .swagger-ui-wrap td label {
-        line-height: 27px;
-    }
-
-    .swagger-section .swagger-ui-wrap input.submit {
-        background-color: #007bff;
-        color: #fff;
-        font-weight: 600;
-        border: 1px solid #bbb;
-        border-radius: 4px;
-        width: 100px;
-        height: 40px;
-    }
-
-    .swagger-section .swagger-ui-wrap .endpoint ul.options {
-        position: absolute;
-        right: 5px;
-    }
-
-    .swagger-section .swagger-ui-wrap #resources .resource .endpoints .endpoint .operations .operation.get .content > h4:first-of-type:last-of-type {
-        color: inherit;
-    }
-
-    .swagger-section .swagger-ui-wrap #resources .resource .endpoints .endpoint .operations .operation.get .content > h4:first-of-type {
-        color: red;
-    }
-  </style>
+  <link rel="stylesheet" type="text/css" href="swagger-ui.css" > <!-- Update the path to where your Swagger UI CSS file is located -->
 </head>
 
-<body class="swagger-section">
-  <div class="empty-swagger-doc">
-    <h2><span class="fa-stack fa-lg">
-        <i class="fa fa-circle-thin fa-stack-2x"></i>
-        <i class="fa fa-question fa-stack-1x"></i>
-    </span></h2>
-    <h2 data-i18n>swagger.helpBox.title</h2>
-    <p data-i18n>swagger.helpBox.swaggerIntro</p>
-    <p data-i18n>swagger.helpBox.swaggerInfo</p>
-    <p data-i18n>swagger.helpBox.swaggerInstructions0</p>
-    <p data-i18n>swagger.helpBox.swaggerInstructions1</p>
-    <p data-i18n>swagger.helpBox.swaggerInstructions2</p>
-    <p data-i18n>swagger.helpBox.swaggerOutro<p>
-  </div>
-  <div id="swagger-ui-container" class="swagger-ui-wrap" style="margin: 10px"></div>
-
+<body>
+  <div id="swagger-ui"></div>
+
+  <script src="swagger-ui-bundle.js"></script> <!-- Update the path to where your Swagger UI JS bundle file is located -->
+  <script src="swagger-ui-standalone-preset.js"></script> <!-- Update the path if you're using the standalone preset -->
+  <script>
+  window.onload = function() {
+    // Begin Swagger UI call region
+    const ui = SwaggerUIBundle({
+      url: "/http-api/swagger.json", // Update with the path to your OpenAPI spec
+      dom_id: '#swagger-ui',
+      deepLinking: true,
+      presets: [
+        SwaggerUIBundle.presets.apis,
+        SwaggerUIStandalonePreset
+      ],
+      plugins: [
+        SwaggerUIBundle.plugins.DownloadUrl
+      ],
+      layout: "StandaloneLayout"
+    })
+    // End Swagger UI call region
+
+    window.ui = ui
+  }
+  </script>
 </body>
 </html>

From 339b6b5e8f653cde5486a26b1633f6d8673c75bc Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 16:47:45 +0100
Subject: [PATCH 08/20] Removed help section on parameters and status

---
 swagger/swagger.html | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/swagger/swagger.html b/swagger/swagger.html
index 1b2e1dd..4c1377e 100644
--- a/swagger/swagger.html
+++ b/swagger/swagger.html
@@ -55,15 +55,8 @@
                 <div class="form-row" style="box-sizing: border-box; border-radius: 5px; height: 310px; padding: 5px; border: 1px solid #ccc; overflow-y:scroll;">
                     <ul id="node-config-parameter-list" style="padding: 0; margin:0;"></ul>
                 </div>
-                <div class="form-row">
-                    <a href="#" class="red-ui-button red-ui-button-small" id="node-config-input-add-parameter"><i class="fa fa-plus"></i> <span data-i18n="swagger.label.parameter"></span></a>
-                    <a href="#" id="node-config-input-parameter-info" class="popover-closable" style="font-size: 10px; text-decoration: underline; float: right"><span data-i18n="swagger.label.parameters-help"></span></a>
-                </div>
             </div>
             <div id="swagger-tab-responses">
-                <div class="form-row" style="box-sizing: border-box; border-radius: 5px; height: 310px; padding: 5px; border: 1px solid #ccc; overflow-y:scroll;">
-                    <ul id="node-config-response-list" style="padding: 0; margin:0;"></ul>
-                </div>
                 <div class="form-row">
                     <a href="#" class="red-ui-button red-ui-button-small" id="node-config-input-add-response"><i class="fa fa-plus"></i> <span data-i18n="swagger.label.response"></span></a>
                     <a href="#" id="node-config-input-response-info" class="popover-closable" style="font-size: 10px; text-decoration: underline; float: right"><span data-i18n="swagger.label.responses-help"></span></a>

From 8948c12a46892020362eccaa6c72884d5c36ff57 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:17:55 +0100
Subject: [PATCH 09/20] Removed not needed load

---
 swagger/swagger.html | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/swagger/swagger.html b/swagger/swagger.html
index 4c1377e..f0ee5ac 100644
--- a/swagger/swagger.html
+++ b/swagger/swagger.html
@@ -118,6 +118,7 @@
                     swaggerUi.load();
                 }
             });
+            
             swaggerDocUrl = window.location.protocol + "//" + window.location.hostname + ":" + window.location.port + RED.settings.httpNodeRoot + 'http-api/swagger.json';
             var swaggerFrame = $("<iframe/>", {
                 id:"swagger-ui-frame",
@@ -131,11 +132,12 @@
                 content: content,
                 iconClass: "fa fa-file-text-o" 
             });
-
+/*
             swaggerFrame.load(function(){
                 swaggerUi = document.getElementById('swagger-ui-frame').contentWindow.swaggerUi;
                 swaggerUi.load();
             });
+            */
         },
         oneditprepare: function() {
 

From 7c8b07b2103fc2ebf888947b2408c0564c9f2598 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:19:30 +0100
Subject: [PATCH 10/20] Minor formatting

---
 swagger/swagger.js | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/swagger/swagger.js b/swagger/swagger.js
index d51ae78..6efffed 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -136,7 +136,9 @@ module.exports = function(RED) {
                 }
             }
         });
-         // Final cleanup to remove empty sections
+        
+        
+    // Final cleanup to remove empty sections
     cleanupOpenAPISpec(resp);
         res.json(resp);
     });

From 1db08311f0771d9f71f982e639cfea202127ad7f Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:26:10 +0100
Subject: [PATCH 11/20] Ran prettier

---
 swagger/swagger.js | 376 ++++++++++++++++++++++++---------------------
 1 file changed, 197 insertions(+), 179 deletions(-)

diff --git a/swagger/swagger.js b/swagger/swagger.js
index 6efffed..528281f 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -12,171 +12,184 @@
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
-**/
-
+ **/
 
 //const swaggerUiDistPath = require('swagger-ui-dist').getAbsoluteFSPath();
 
-
 const DEFAULT_TEMPLATE = {
-    openapi: "3.0.0",
-    info: {
-        title: "My Node-RED API",
-        version: "1.0.0",
-        description: "A sample API",
-        // You can also add 'termsOfService', 'contact', and 'license' information here
-    },
-    servers: [
-        {
-            url: 'http://localhost:1880/',
-            description: 'Local server'
-        },
-    ],
-    paths: {},
-    components: {
-        schemas: {},
-        responses: {},
-        parameters: {},
-        securitySchemes: {}
+  openapi: "3.0.0",
+  info: {
+    title: "My Node-RED API",
+    version: "1.0.0",
+    description: "A sample API",
+    // You can also add 'termsOfService', 'contact', and 'license' information here
+  },
+  servers: [
+    {
+      url: "http://localhost:1880/",
+      description: "Local server",
     },
-    tags: [],
-    // Add more properties as needed
+  ],
+  paths: {},
+  components: {
+    schemas: {},
+    responses: {},
+    parameters: {},
+    securitySchemes: {},
+  },
+  tags: [],
+  // Add more properties as needed
 };
 
+module.exports = function (RED) {
+  "use strict";
 
+  const path = require("path");
 
-module.exports = function(RED) {
-    "use strict";
+  const convToSwaggerPath = (x) => `/{${x.substring(2)}}`;
+  const trimAll = (ary) => ary.map((x) => x.trim());
+  const csvStrToArray = (csvStr) => (csvStr ? trimAll(csvStr.split(",")) : []);
+  const ensureLeadingSlash = (url) => (url.startsWith("/") ? url : "/" + url);
+  const stripTerminalSlash = (url) =>
+    url.length > 1 && url.endsWith("/") ? url.slice(0, -1) : url;
+  const regexColons = /\/:\w*/g;
 
-    const path = require("path");
+  RED.httpNode.get("/http-api/swagger.json", (req, res) => {
+    const {
+      httpNodeRoot,
+      swagger: {
+        parameters: additionalParams = [],
+        template: resp = { ...DEFAULT_TEMPLATE },
+      } = {},
+    } = RED.settings;
+    const { basePath = httpNodeRoot } = resp;
 
-    const convToSwaggerPath = x => `/{${x.substring(2)}}`;
-    const trimAll = ary => ary.map(x => x.trim());
-    const csvStrToArray = csvStr => csvStr ? trimAll(csvStr.split(",")) : [];
-    const ensureLeadingSlash = url => (url.startsWith("/") ? url : "/" + url);
-    const stripTerminalSlash = url =>
-        url.length > 1 && url.endsWith("/") ? url.slice(0, -1) : url;
-    const regexColons = /\/:\w*/g;
+    resp.paths = {};
 
+    RED.nodes.eachNode((node) => {
+      const { name, type, method, swaggerDoc, url } = node;
 
+      if (type === "http in") {
+        const swaggerDocNode = RED.nodes.getNode(swaggerDoc);
+
+        if (swaggerDocNode) {
+          const endPoint = ensureLeadingSlash(
+            url.replace(regexColons, convToSwaggerPath)
+          );
+          if (!resp.paths[endPoint]) resp.paths[endPoint] = {};
+
+          const {
+            summary = swaggerDocNode.summary || name || method + " " + endPoint,
+            description = swaggerDocNode.description || "",
+            tags = swaggerDocNode.tags || "",
+            deprecated = swaggerDocNode.deprecated || false,
+            parameters = swaggerDocNode.parameters || [],
+          } = swaggerDocNode;
+
+          const aryTags = csvStrToArray(tags);
+
+          const operation = {
+            summary,
+            description,
+            tags: aryTags,
+            deprecated,
+            parameters: [...parameters, ...additionalParams].map((param) => {
+              return {
+                name: param.name,
+                in: param.in,
+                required: param.required,
+                schema: {
+                  type: param.type,
+                  // Add other schema properties here
+                },
+                description: param.description,
+              };
+            }),
+            responses: {},
+          };
+
+          // Check if responses is an object and not null or undefined
+          if (
+            swaggerDocNode &&
+            typeof swaggerDocNode.responses === "object" &&
+            swaggerDocNode.responses !== null
+          ) {
+            Object.keys(swaggerDocNode.responses).forEach((status) => {
+              const responseDetails = swaggerDocNode.responses[status];
+              operation.responses[status] = {
+                description: responseDetails.description || "No description",
+                content: {},
+              };
+
+              // Conditionally add schema if it's set
+              if (responseDetails.schema) {
+                operation.responses[status].content["application/json"] = {
+                  schema: responseDetails.schema,
+                };
+              }
+            });
+          } else {
+            console.error(
+              "swaggerDocNode.responses is not an object or is null:",
+              swaggerDocNode.responses
+            );
+          }
+
+          // Add the operation to the path in the spec
+          resp.paths[endPoint][method.toLowerCase()] = operation;
+        } else {
+          console.error(
+            "No Swagger Documentation node found for HTTP In node:",
+            node.id
+          );
+        }
+      }
+    });
 
-    RED.httpNode.get("/http-api/swagger.json", (req, res) => {
-        const {
-            httpNodeRoot,
-            swagger: { parameters: additionalParams = [], template: resp = { ...DEFAULT_TEMPLATE } } = {}
-        } = RED.settings;
-        const { basePath = httpNodeRoot } = resp;
-        
-        resp.paths = {};
-    
-        RED.nodes.eachNode(node => {
-            const { name, type, method, swaggerDoc, url } = node;
-    
-            if (type === "http in") {
-                const swaggerDocNode = RED.nodes.getNode(swaggerDoc);
-                
-                if (swaggerDocNode) {
-                    const endPoint = ensureLeadingSlash(url.replace(regexColons, convToSwaggerPath));
-                    if (!resp.paths[endPoint]) resp.paths[endPoint] = {};
-    
-                    const {
-                        summary = swaggerDocNode.summary || name || method + " " + endPoint,
-                        description = swaggerDocNode.description || '',
-                        tags = swaggerDocNode.tags || '',
-                        deprecated = swaggerDocNode.deprecated || false,
-                        parameters = swaggerDocNode.parameters || []
-                    } = swaggerDocNode;
-    
-                    const aryTags = csvStrToArray(tags);
-    
-                    const operation = {
-                        summary,
-                        description,
-                        tags: aryTags,
-                        deprecated,
-                        parameters: [...parameters, ...additionalParams].map(param => {
-                            return {
-                                name: param.name,
-                                in: param.in,
-                                required: param.required,
-                                schema: {
-                                    type: param.type,
-                                    // Add other schema properties here
-                                },
-                                description: param.description
-                            };
-                        }),
-                        responses: {}
-                    };
-    
-                    // Check if responses is an object and not null or undefined
-                    if (swaggerDocNode && typeof swaggerDocNode.responses === 'object' && swaggerDocNode.responses !== null) {
-                        Object.keys(swaggerDocNode.responses).forEach(status => {
-                            const responseDetails = swaggerDocNode.responses[status];
-                            operation.responses[status] = {
-                                description: responseDetails.description || 'No description',
-                                content: {}
-                            };
-                        
-                            // Conditionally add schema if it's set
-                            if (responseDetails.schema) {
-                                operation.responses[status].content['application/json'] = {
-                                    schema: responseDetails.schema
-                                };
-                            }
-                        });
-                    } else {
-                        console.error('swaggerDocNode.responses is not an object or is null:', swaggerDocNode.responses);
-                    }
-    
-                    // Add the operation to the path in the spec
-                    resp.paths[endPoint][method.toLowerCase()] = operation;
-                } else {
-                    console.error('No Swagger Documentation node found for HTTP In node:', node.id);
-                }
-            }
-        });
-        
-        
     // Final cleanup to remove empty sections
     cleanupOpenAPISpec(resp);
-        res.json(resp);
-    });
-    
-    function cleanupOpenAPISpec(spec) {
+    res.json(resp);
+  });
+
+  function cleanupOpenAPISpec(spec) {
     // Clean up components
     if (spec.components) {
-        ['schemas', 'responses', 'parameters', 'securitySchemes'].forEach(key => {
-            if (spec.components[key] && Object.keys(spec.components[key]).length === 0) {
-                delete spec.components[key];
-            }
-        });
-
-        // If all components are empty, remove the components object itself
-        if (Object.keys(spec.components).length === 0) {
-            delete spec.components;
+      ["schemas", "responses", "parameters", "securitySchemes"].forEach(
+        (key) => {
+          if (
+            spec.components[key] &&
+            Object.keys(spec.components[key]).length === 0
+          ) {
+            delete spec.components[key];
+          }
         }
+      );
+
+      // If all components are empty, remove the components object itself
+      if (Object.keys(spec.components).length === 0) {
+        delete spec.components;
+      }
     }
 
     // Clean up empty tags array
     if (Array.isArray(spec.tags) && spec.tags.length === 0) {
-        delete spec.tags;
+      delete spec.tags;
     }
-}
+  }
 
-    function SwaggerDoc(n) {
-        RED.nodes.createNode(this, n);
-        this.summary = n.summary;
-        this.description = n.description;
-        this.tags = n.tags;
-        this.consumes = n.consumes;
-        this.produces = n.produces;
-        this.parameters = n.parameters;
-        this.responses = n.responses;
-        this.deprecated = n.deprecated;
-    }
-    RED.nodes.registerType("swagger-doc", SwaggerDoc);
-/*
+  function SwaggerDoc(n) {
+    RED.nodes.createNode(this, n);
+    this.summary = n.summary;
+    this.description = n.description;
+    this.tags = n.tags;
+    this.consumes = n.consumes;
+    this.produces = n.produces;
+    this.parameters = n.parameters;
+    this.responses = n.responses;
+    this.deprecated = n.deprecated;
+  }
+  RED.nodes.registerType("swagger-doc", SwaggerDoc);
+  /*
     function sendFile(res, filename) {
         // Use the right function depending on Express 3.x/4.x
         if (res.sendFile) {
@@ -202,65 +215,70 @@ module.exports = function(RED) {
     }
 */
 
-// Serve the main Swagger UI HTML file
-RED.httpAdmin.get("/swagger-ui/swagger-ui.html", (req, res) => {
+  // Serve the main Swagger UI HTML file
+  RED.httpAdmin.get("/swagger-ui/swagger-ui.html", (req, res) => {
     // Correct the path to point directly to the 'swagger-ui.html' file
     const filename = path.join(__dirname, "swagger-ui/swagger-ui.html");
     sendFile(res, filename);
-});
-
+  });
 
-// Serve i18next localization files
-RED.httpAdmin.get("/swagger-ui/i18next.min.js", (req, res) => {
-    const filename = path.join(__dirname, '..', 'node_modules', 'i18next', 'i18next.min.js');
+  // Serve i18next localization files
+  RED.httpAdmin.get("/swagger-ui/i18next.min.js", (req, res) => {
+    const filename = path.join(
+      __dirname,
+      "..",
+      "node_modules",
+      "i18next",
+      "i18next.min.js"
+    );
     sendFile(res, filename);
-});
+  });
 
+  // Serve Swagger UI assets like CSS and JS from swagger-ui-dist
+  RED.httpAdmin.get(
+    "/swagger-ui/*",
+    (req, res, next) => {
+      // Extract the actual file name from the request params
+      let filename = req.params[0];
 
-// Serve Swagger UI assets like CSS and JS from swagger-ui-dist
-RED.httpAdmin.get("/swagger-ui/*", (req, res, next) => {
-    // Extract the actual file name from the request params
-    let filename = req.params[0];
-    
-    // If the filename is 'swagger-ui.html', redirect to the correct handler
-    if (filename === 'swagger-ui.html') {
+      // If the filename is 'swagger-ui.html', redirect to the correct handler
+      if (filename === "swagger-ui.html") {
         return next();
-    }
+      }
 
-    // Serve the file from swagger-ui-dist
-    try {
-        const basePath = require('swagger-ui-dist').getAbsoluteFSPath();
+      // Serve the file from swagger-ui-dist
+      try {
+        const basePath = require("swagger-ui-dist").getAbsoluteFSPath();
         const filePath = path.join(basePath, filename);
         sendFile(res, filePath);
-    } catch (err) {
+      } catch (err) {
         console.error(err);
         res.status(404).send("File not found");
+      }
+    },
+    (req, res) => {
+      // Fallback handler for 'swagger-ui.html', in case the above handler is triggered
+      // due to the way Express handles wildcard routes
+      const filename = path.join(__dirname, "swagger", "swagger-ui.html");
+      sendFile(res, filename);
     }
-}, (req, res) => {
-    // Fallback handler for 'swagger-ui.html', in case the above handler is triggered
-    // due to the way Express handles wildcard routes
-    const filename = path.join(__dirname, "swagger", "swagger-ui.html");
-    sendFile(res, filename);
-});
+  );
 
-// Serve any other localization files
-RED.httpAdmin.get("/swagger-ui/nls/*", (req, res) => {
+  // Serve any other localization files
+  RED.httpAdmin.get("/swagger-ui/nls/*", (req, res) => {
     const filename = path.join(__dirname, "locales", req.params[0]);
     sendFile(res, filename);
-});
+  });
 
-// Generic function to send files
-function sendFile(res, filePath) {
+  // Generic function to send files
+  function sendFile(res, filePath) {
     // Implement the logic to send the file
     // For example, using Express' res.sendFile:
     res.sendFile(filePath, (err) => {
-        if (err) {
-            console.error('Error sending file:', err);
-            res.status(err.status || 500).send('Error sending file.');
-        }
+      if (err) {
+        console.error("Error sending file:", err);
+        res.status(err.status || 500).send("Error sending file.");
+      }
     });
-}
-    
-
-    
+  }
 };

From e83696d63a71fb440985fd2b38b642edd367a4af Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:28:18 +0100
Subject: [PATCH 12/20] Removed consumes/produces as it is not part of openapi3

---
 swagger/swagger.html | 18 +-----------------
 swagger/swagger.js   |  2 --
 2 files changed, 1 insertion(+), 19 deletions(-)

diff --git a/swagger/swagger.html b/swagger/swagger.html
index f0ee5ac..cd02b5c 100644
--- a/swagger/swagger.html
+++ b/swagger/swagger.html
@@ -39,14 +39,6 @@
                     <label id="node-config-input-tags-label" for="node-config-input-tags" class="popover-right" data-i18n="[data-content]swagger.data-content.tags"><span data-i18n="swagger.label.tags"></span></label>
                     <input type="text" id="node-config-input-tags" data-i18n="[placeholder]swagger.placeholder.tags">
                 </div>
-                <div class="form-row">
-                    <label id="node-config-input-consumes-label" for="node-config-input-consumes" class="popover-right" data-i18n="[data-content]swagger.data-content.consumes"><span data-i18n="swagger.label.consumes"></span></label>
-                    <input type="text" id="node-config-input-consumes" data-i18n="[placeholder]swagger.placeholder.consumes">
-                </div>
-                <div class="form-row">
-                    <label id="node-config-input-produces-label" for="node-config-input-produces" class="popover-right" data-i18n="[data-content]swagger.data-content.produces"><span data-i18n="swagger.label.produces"></span></label>
-                    <input type="text" id="node-config-input-produces" data-i18n="[placeholder]swagger.placeholder.produces">
-                </div>
                 <div  class="form-row">
                     <input type="checkbox" id="node-config-input-deprecated" style="width: auto; vertical-align: top;"> <label id="node-config-input-deprecated-label" for="node-config-input-deprecated" class="popover-right" data-i18n="[data-content]swagger.data-content.deprecated"><span data-i18n="swagger.label.deprecated"></span></label>
                 </div>
@@ -87,12 +79,6 @@
             tags: {
                 value: ""
             },
-            consumes: {
-                value: ""
-            },
-            produces: {
-                value: ""
-            },
             parameters: {
                 value: []
             },
@@ -141,12 +127,10 @@
         },
         oneditprepare: function() {
 
-            // Tooltips for Summary, Description, Tags, Consumes, Produces and Deprecated Labels on Properties Tab.
+            // Tooltips for Summary, Description, Tags, and Deprecated Labels on Properties Tab.
             RED.popover.tooltip($('#node-config-input-summary-label'), this._("swagger.data-content.summary"));
             RED.popover.tooltip($('#node-config-input-description-label'), this._("swagger.data-content.description"));
             RED.popover.tooltip($('#node-config-input-tags-label'), this._("swagger.data-content.tags"));
-            RED.popover.tooltip($('#node-config-input-consumes-label'), this._("swagger.data-content.consumes"));
-            RED.popover.tooltip($('#node-config-input-produces-label'), this._("swagger.data-content.produces"));
             RED.popover.tooltip($('#node-config-input-deprecated-label'), this._("swagger.data-content.deprecated"));
 
             RED.popover.tooltip($('#node-config-input-parameter-info'), this._("swagger.content.parameter-info"));
diff --git a/swagger/swagger.js b/swagger/swagger.js
index 528281f..37d16d9 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -182,8 +182,6 @@ module.exports = function (RED) {
     this.summary = n.summary;
     this.description = n.description;
     this.tags = n.tags;
-    this.consumes = n.consumes;
-    this.produces = n.produces;
     this.parameters = n.parameters;
     this.responses = n.responses;
     this.deprecated = n.deprecated;

From 5059a33381572811d2c209c3b80c0b2595ae7d52 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:31:33 +0100
Subject: [PATCH 13/20] Took back to get parameters and responses working

---
 swagger/swagger.html | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/swagger/swagger.html b/swagger/swagger.html
index cd02b5c..e9813a4 100644
--- a/swagger/swagger.html
+++ b/swagger/swagger.html
@@ -43,12 +43,19 @@
                     <input type="checkbox" id="node-config-input-deprecated" style="width: auto; vertical-align: top;"> <label id="node-config-input-deprecated-label" for="node-config-input-deprecated" class="popover-right" data-i18n="[data-content]swagger.data-content.deprecated"><span data-i18n="swagger.label.deprecated"></span></label>
                 </div>
             </div>
-            <div id="swagger-tab-parameters">
+           <div id="swagger-tab-parameters">
                 <div class="form-row" style="box-sizing: border-box; border-radius: 5px; height: 310px; padding: 5px; border: 1px solid #ccc; overflow-y:scroll;">
                     <ul id="node-config-parameter-list" style="padding: 0; margin:0;"></ul>
                 </div>
+                <div class="form-row">
+                    <a href="#" class="red-ui-button red-ui-button-small" id="node-config-input-add-parameter"><i class="fa fa-plus"></i> <span data-i18n="swagger.label.parameter"></span></a>
+                    <a href="#" id="node-config-input-parameter-info" class="popover-closable" style="font-size: 10px; text-decoration: underline; float: right"><span data-i18n="swagger.label.parameters-help"></span></a>
+                </div>
             </div>
             <div id="swagger-tab-responses">
+                <div class="form-row" style="box-sizing: border-box; border-radius: 5px; height: 310px; padding: 5px; border: 1px solid #ccc; overflow-y:scroll;">
+                    <ul id="node-config-response-list" style="padding: 0; margin:0;"></ul>
+                </div>
                 <div class="form-row">
                     <a href="#" class="red-ui-button red-ui-button-small" id="node-config-input-add-response"><i class="fa fa-plus"></i> <span data-i18n="swagger.label.response"></span></a>
                     <a href="#" id="node-config-input-response-info" class="popover-closable" style="font-size: 10px; text-decoration: underline; float: right"><span data-i18n="swagger.label.responses-help"></span></a>

From 01a05f7f4f996a6cfc95a7d958ef181e87f6fcd5 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:38:19 +0100
Subject: [PATCH 14/20] Minor package update

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 74f3b62..f066a37 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
     "name": "node-red-node-swagger",
     "version": "0.2.0",
-    "description": "A set of tools for generating Swagger API documentation based on the HTTP nodes deployed in a flow",
+    "description": "A set of tools for generating OpenAPI3/Swagger documentation based on the HTTP nodes deployed in a flow",
     "license": "Apache",
     "repository": {
         "type": "git",

From 90a120fabc7c52aeb1aeec07b53dfbdcdd87e587 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:39:32 +0100
Subject: [PATCH 15/20] Removed old code

---
 swagger/swagger.js | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/swagger/swagger.js b/swagger/swagger.js
index 37d16d9..957ac40 100644
--- a/swagger/swagger.js
+++ b/swagger/swagger.js
@@ -187,31 +187,6 @@ module.exports = function (RED) {
     this.deprecated = n.deprecated;
   }
   RED.nodes.registerType("swagger-doc", SwaggerDoc);
-  /*
-    function sendFile(res, filename) {
-        // Use the right function depending on Express 3.x/4.x
-        if (res.sendFile) {
-            res.sendFile(filename);
-        } else {
-            res.sendfile(filename);
-        }
-    }
-/*
-    RED.httpAdmin.get('/swagger-ui/*', (req, res) => {
-        const filename = req.params[0];
-        const filePath = path.join(swaggerUiDistPath, filename);
-        sendFile(res, filePath);
-    });
-    
-    function sendFile(res, filePath) {
-        res.sendFile(filePath, (err) => {
-            if (err) {
-                console.error('Error sending file:', err);
-                res.status(500).send('Error sending file.');
-            }
-        });
-    }
-*/
 
   // Serve the main Swagger UI HTML file
   RED.httpAdmin.get("/swagger-ui/swagger-ui.html", (req, res) => {

From b820ee580fdd4b18c08561acf1ecaa1405035e65 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Sun, 4 Feb 2024 17:40:23 +0100
Subject: [PATCH 16/20] Cleaning

---
 swagger/swagger-ui/swagger-ui.html | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/swagger/swagger-ui/swagger-ui.html b/swagger/swagger-ui/swagger-ui.html
index 3b04787..1f10733 100644
--- a/swagger/swagger-ui/swagger-ui.html
+++ b/swagger/swagger-ui/swagger-ui.html
@@ -2,19 +2,18 @@
 <html>
 <head>
   <title>Swagger UI</title>
-  <link rel="stylesheet" type="text/css" href="swagger-ui.css" > <!-- Update the path to where your Swagger UI CSS file is located -->
+  <link rel="stylesheet" type="text/css" href="swagger-ui.css" > 
 </head>
 
 <body>
   <div id="swagger-ui"></div>
 
-  <script src="swagger-ui-bundle.js"></script> <!-- Update the path to where your Swagger UI JS bundle file is located -->
-  <script src="swagger-ui-standalone-preset.js"></script> <!-- Update the path if you're using the standalone preset -->
+  <script src="swagger-ui-bundle.js"></script> 
+  <script src="swagger-ui-standalone-preset.js"></script> 
   <script>
   window.onload = function() {
-    // Begin Swagger UI call region
     const ui = SwaggerUIBundle({
-      url: "/http-api/swagger.json", // Update with the path to your OpenAPI spec
+      url: "/http-api/swagger.json", 
       dom_id: '#swagger-ui',
       deepLinking: true,
       presets: [
@@ -26,7 +25,6 @@
       ],
       layout: "StandaloneLayout"
     })
-    // End Swagger UI call region
 
     window.ui = ui
   }

From 6747a9628f6d123aea614440283b9c438f019586 Mon Sep 17 00:00:00 2001
From: fasblom <filip.asblom@digitaltvilling.se>
Date: Tue, 6 Feb 2024 07:48:22 +0100
Subject: [PATCH 17/20] Trigger checks


From 226ca7debbd0140313d17de6c1ecdf911a757452 Mon Sep 17 00:00:00 2001
From: fasblom <99992515+fasblom@users.noreply.github.com>
Date: Fri, 21 Jun 2024 06:56:33 +0200
Subject: [PATCH 18/20] Updated more packages

---
 package.json | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/package.json b/package.json
index f066a37..c82383f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
-    "name": "node-red-node-swagger",
-    "version": "0.2.0",
+    "name": "node-red-node-openapi",
+    "version": "0.0.2",
     "description": "A set of tools for generating OpenAPI3/Swagger documentation based on the HTTP nodes deployed in a flow",
     "license": "Apache",
     "repository": {
@@ -18,10 +18,14 @@
             "swagger": "swagger/swagger.js"
         }
     },
+    "conflicts": {
+        "node-red-node-swagger": "<0.3.0"
+    },
     "contributors": [
         "Nick O'Leary <nick.oleary@gmail.com>",
         "Cody Walker <cody@cody-walker.com>",
-        "Jon Silver <js@jfdi.info>"
+        "Jon Silver <js@jfdi.info>",
+        "Filip Åsblom <asblom@gmail.com>"
     ],
     "dependencies": {
         "i18next": "^23.7.20",

From 3ae266ef1af655f0b21750570e229688ece5fd77 Mon Sep 17 00:00:00 2001
From: fasblom <99992515+fasblom@users.noreply.github.com>
Date: Fri, 21 Jun 2024 07:07:27 +0200
Subject: [PATCH 19/20] Minor updates of package

---
 package.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/package.json b/package.json
index c82383f..555d660 100644
--- a/package.json
+++ b/package.json
@@ -1,11 +1,11 @@
 {
-    "name": "node-red-node-openapi",
+    "name": "@digital-tvilling/node-red-openapi-generator",
     "version": "0.0.2",
-    "description": "A set of tools for generating OpenAPI3/Swagger documentation based on the HTTP nodes deployed in a flow",
+    "description": "A set of tools for generating OpenAPI3/Swagger documentation based on the HTTP nodes deployed in a flow. An updated version of the Node-RED Swagger Documentation Generator to support OpenAPI3.",
     "license": "Apache",
     "repository": {
         "type": "git",
-        "url": "https://github.com/node-red/node-red-node-swagger.git"
+        "url": "https://github.com/digital-tvilling/node-red-openapi-generator.git"
     },
     "keywords": [
         "node-red",

From 8db1b2b639c4a3ac990711f6e833b804a10d8d14 Mon Sep 17 00:00:00 2001
From: fasblom <99992515+fasblom@users.noreply.github.com>
Date: Fri, 21 Jun 2024 07:07:34 +0200
Subject: [PATCH 20/20] Some update of readme

---
 README.md | 81 ++++++++++++++++++++++++++-----------------------------
 1 file changed, 38 insertions(+), 43 deletions(-)

diff --git a/README.md b/README.md
index 00b41f8..f9b4737 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,18 @@
-# Node-RED Swagger Documentation Generator
+# Node-RED OpenAPI3 Documentation Generator
 
-This package provides a set of tools for generating Swagger api documentation
-based on the HTTP nodes deployed in a flow.
+This package provides a set of tools for generating OpenAPI3 documentation based on the HTTP nodes deployed in a flow.
+
+It is a fork of the https://github.com/node-red/node-red-node-swagger repo with some significant updates of dependencies and restructuring due to the Openapi3-update. 
 
 ## Usage
 
 1. Install the node module
 
-        npm install node-red-node-swagger
+        npm install node-red-node-openapi
 
-  **Note:** until this is published to npm, you will need to install from git:
+  **Note:** Until this is published to npm, you will need to install from git:
   
-        npm install node-red/node-red-node-swagger
+        npm install your-username/node-red-node-openapi
 
 2. Provide a template OpenAPI file in `settings.js`:
 
@@ -42,7 +43,7 @@ based on the HTTP nodes deployed in a flow.
 
 3. This template will remain unchanged and serve as the basis for the OpenAPI documentation.
 
-  **Note:** You may additionally add components like `schemas`, `responses`, `parameters`, `securitySchemes`, etc., to the OpenAPI file in 'settings.js' to have those components available for reuse in the generated OpenAPI documentation.
+  **Note:** You may additionally add components like `schemas`, `responses`, `parameters`, `securitySchemes`, etc., to the OpenAPI file in `settings.js` to have those components available for reuse in the generated OpenAPI documentation.
 
         openapi: {
           template: {
@@ -70,65 +71,64 @@ based on the HTTP nodes deployed in a flow.
           }
         }
 
-4. After installing the package, you have the option to identify metadata for each HTTP-In node that will be used in the swagger doc generation.
-		
-5. The generated swagger is then available at <http://localhost:1880/http-api/swagger.json>.
+4. After installing the package, you have the option to identify metadata for each HTTP-In node that will be used in the OpenAPI doc generation.
+
+5. The generated OpenAPI documentation is then available at <http://localhost:1880/http-api/swagger.json>.
 
-## Path Swagger Generation
+## Path OpenAPI Generation
 
-Via the editor, you can define metadata for each particular HTTP-In node to be used in swagger generation.
+Via the editor, you can define metadata for each particular HTTP-In node to be used in OpenAPI generation.
 
-To do so,
+To do so:
 
 1. Select an HTTP-In node in the editor.
-![](readme_images/Capture_00.PNG?raw=true)
+![HTTP-In Node](readme_images/Capture_00.PNG?raw=true)
 
-2. From the config panel, you can select a user-defined swagger doc from the dropdown. You may create a new metadata definition by selecting "Add new swagger-doc..." and clicking the edit button.
-![](readme_images/Capture_01.PNG?raw=true)
+2. From the config panel, you can select a user-defined OpenAPI doc from the dropdown. You may create a new metadata definition by selecting "Add new swagger-doc..." and clicking the edit button.
+![Config Panel](readme_images/Capture_01.PNG?raw=true)
 
-3. This will launch the swagger config panel, where you have three distinct tabs that make up the swagger documentation.
+3. This will launch the OpenAPI config panel, where you have three distinct tabs that make up the OpenAPI documentation.
 
 #### Info
 
-![](readme_images/Capture_02.PNG?raw=true)
+![Info Tab](readme_images/Capture_02.PNG?raw=true)
 
 This tab allows you to provide the basic information about the attached paths.
 
-* Summary - A short summary of what the operation does. For maximum readability in the swagger-ui, this field SHOULD be less than 120 characters.
+* Summary - A short summary of what the operation does. For maximum readability in the Swagger-UI, this field SHOULD be less than 120 characters.
 * Description - A verbose explanation of the operation behavior. [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
 * Tags - A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier. These should be provided as a comma-separated list.
-* Consumes - A list of MIME types the operation can consume. These should be provided as a comma-separated list
+* Consumes - A list of MIME types the operation can consume. These should be provided as a comma-separated list.
 * Produces - A list of MIME types the operation can produce. These should be provided as a comma-separated list.
 * Deprecated - Declares this operation to be deprecated. Usage of the declared operation should be refrained.
 
 #### Parameters
 
-![](readme_images/Capture_03.PNG?raw=true)
+![Parameters Tab](readme_images/Capture_03.PNG?raw=true)
 
 This tab allows you to configure the parameters that can be used with the particular operation.
 
 * Name - The name of the parameter. Parameter names are case sensitive.
-* In - The location of the parameter. There are four supported locations of the parameter
-	* _Query_ - Parameters that are appended to the URL. For example, in `/items?id=###`, the query parameter is `id`.
-	* _Header_ - Custom headers that are expected as part of the request.
-	* _Form_ - Used to describe the payload of an HTTP request when either `application/x-www-form-urlencoded` or `multipart/form-data` are used as the content type of the request. This is the only parameter type that can be used to send files, thus supporting the `file` type. Since form parameters are sent in the payload, they cannot be declared together with a body parameter for the same operation. Form parameters have a different format based on the content-type used (for further details, consult <http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4>):
-	* _Body_ - The payload that's appended to the HTTP request. Since there can only be one payload, there can only be *one* body parameter. The name of the body parameter has no effect on the parameter itself and is used for documentation purposes only. Since Form parameters are also in the payload, body and form parameters cannot exist together for the same operation.
-* Description - A brief description of the parameter. This could contain examples of use.  [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
+* In - The location of the parameter. There are four supported locations of the parameter:
+  * _Query_ - Parameters that are appended to the URL. For example, in `/items?id=###`, the query parameter is `id`.
+  * _Header_ - Custom headers that are expected as part of the request.
+  * _Form_ - Used to describe the payload of an HTTP request when either `application/x-www-form-urlencoded` or `multipart/form-data` are used as the content type of the request. This is the only parameter type that can be used to send files, thus supporting the `file` type. Since form parameters are sent in the payload, they cannot be declared together with a body parameter for the same operation. Form parameters have a different format based on the content-type used (for further details, consult <http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4>).
+  * _Body_ - The payload that's appended to the HTTP request. Since there can only be one payload, there can only be *one* body parameter. The name of the body parameter has no effect on the parameter itself and is used for documentation purposes only. Since Form parameters are also in the payload, body and form parameters cannot exist together for the same operation.
+* Description - A brief description of the parameter. This could contain examples of use. [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
 * Required - Determines whether this parameter is mandatory.
 * Type - The type of the parameter. Since the parameter is not located at the request body, it is limited to simple types (that is, not an object).
 * Format - The extending format for the previously mentioned type.
 
 If a body parameter is selected, the user will provide properties included in the body object, rather than specifying a type.
 
-
 #### Responses
 
-![](readme_images/Capture_04.PNG?raw=true)
+![Responses Tab](readme_images/Capture_04.PNG?raw=true)
 
 This tab allows you to define the applicable responses that a user may receive back from the operation.
 
-* Code - You can either select to define the default response, or to provide a specific HTTP status code that the response will be applicable for. A default response is used to cover other undeclared responses
-* Description - A short description of the parameter. This could contain examples of use.  [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
+* Code - You can either select to define the default response, or to provide a specific HTTP status code that the response will be applicable for. A default response is used to cover other undeclared responses.
+* Description - A short description of the response. This could contain examples of use. [GFM syntax](https://help.github.com/articles/github-flavored-markdown) can be used for rich text representation.
 * Properties - The properties are the components that build up the schema of the response.
 * Name - The key name for the particular property.
 * Type - The type of the property.
@@ -136,21 +136,16 @@ This tab allows you to define the applicable responses that a user may receive b
 
 If no responses are provided, a default response with the reply "success" will be used.
 
-##Swagger-UI
-
-![](readme_images/Capture_Swagger_UI.PNG?raw=true)
-
-Swagger-UI is including in the plugin. Once loaded, the plugin will show a swagger tab in the node-red sidebar. From here, you can see the dynamically generated swagger for the current flow. Additionally, you can use the test function to try out your API directly from the editor, providing any parameters you have defined in the docs for the HTTP-In nodes. The Swagger-UI will automatically refresh any time the flow is redeployed.
+## Swagger-UI
 
+![Swagger-UI](readme_images/Capture_Swagger_UI.PNG?raw=true)
 
+Swagger-UI is included in the plugin. Once loaded, the plugin will show a Swagger tab in the Node-RED sidebar. From here, you can see the dynamically generated OpenAPI documentation for the current flow. Additionally, you can use the test function to try out your API directly from the editor, providing any parameters you have defined in the docs for the HTTP-In nodes. The Swagger-UI will automatically refresh any time the flow is redeployed.
 
 ## Notes
 
-- the `paths` entry of the swagger is generated based on the `HTTP In` nodes 
-  present in the flow.
-- if a swagger template is not provided, the example above is used as the default.
-- if `basePath` is not set in the template, it is set to the value of `httpNodeRoot`
-  if that value is something other than `/`.
+- The `paths` entry of the OpenAPI documentation is generated based on the `HTTP In` nodes present in the flow.
+- If an OpenAPI template is not provided, the example above is used as the default.
+- If `basePath` is not set in the template, it is set to the value of `httpNodeRoot` if that value is something other than `/`.
 
-  
-###### Attribute definitions provided come from the [OpenAPI Specification Version 3.1.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md)
\ No newline at end of file
+###### Attribute definitions provided come from the [OpenAPI Specification Version 3.1.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md)