swagger-routes-express/src/extract/v2/extractPaths.js

Connect Express route controllers to restful paths using a Swagger 2 or OpenAPI 3 definition file

const { METHODS } = require('../../constants')
const normaliseSecurity = require('../../normalise/normaliseSecurity')
const normaliseOperationId = require('../../normalise/normaliseOperationId')
const normaliseMiddleware = require('../../normalise/normaliseMiddleware')
const normaliseRoute = require('../../normalise/normaliseRoute')

/**
 *  Extracts all of the path data into an array of routes in the form:
 *  [
 *    {
 *      method,
 *      route, (normalised and inclues basePath if not a root route)
 *      operationId,
 *      security,
 *      middleware
 *    }
 *  ]
 *
 */
const extractPaths = ({ security, basePath, paths }, options = {}) => {
  const {
    apiSeparator, // What to swap for `/` in the swagger doc
    rootTag = 'root', // The tag that tells us not to prepend the basePath
    middleware = {}
  } = options

  const defaultSecurity = normaliseSecurity(security)

  const reduceRoutes = (acc, elem) => {
    METHODS.forEach(method => {
      const op = paths[elem][method]
      if (op) {
        const isRoot = Array.isArray(op.tags) && op.tags[0] === rootTag
        acc.push({
          method,
          route: normaliseRoute(`${isRoot ? '' : basePath}${elem}`),
          operationId: normaliseOperationId(op.operationId, apiSeparator),
          security: normaliseSecurity(op.security, defaultSecurity),
          middleware: normaliseMiddleware(middleware, op['x-middleware'])
        })
      }
    })
    return acc
  }

  return Object.keys(paths).reduce(reduceRoutes, [])
}

module.exports = extractPaths