openhab-multiuser-proxy/src/components/swagger.js

Multi-User support for openHAB REST API with NGINX.

import swaggerJsdoc from 'swagger-jsdoc';
import * as swaggerUi from 'swagger-ui-express';

// Swagger API doc setup
const swaggerDefinition = {
  openapi: '3.0.0',
  info: {
    title: 'openHAB Multiuser Proxy',
    description: 'Multi-User support for openHAB REST API with NGINX.',
    version: process.env.npm_package_version,
    license: {
      name: 'GNU GPL-3.0',
      url: 'https://spdx.org/licenses/GPL-3.0-or-later.html'
    },
    contact: {
      name: '@Davek145',
      url: 'https://github.com/Davek145/openhab-multiuser-proxy'
    }
  },
  servers: [
    {
      url: '/'
    }
  ]
};

const options = {
  swaggerDefinition,
  // Paths to files containing OpenAPI definitions
  //  apis: ['./src/**/routes.js'] // files containing annotations as above
  apis: [`/usr/lib/node_modules/openhab-multiuser-proxy/src/**/routes.js`] // files containing annotations as above - absolute path
};
const swaggerSpec = swaggerJsdoc(options);

export default (app) => app.use('/swagger', swaggerUi.serve, swaggerUi.setup(swaggerSpec));