express-basic-starter/template-commonjs/config/swagger.js

CLI to set up a basic Express project with MVC structure, Swagger documentation, and support for ES Modules/CommonJS

const path = require("path");
const swaggerJSDoc = require("swagger-jsdoc");
require("dotenv").config();

const LOCALHOST = process.env.LOCALHOST || "http://localhost:3000";

const swaggerDefinition = {
  openapi: "3.0.0",
  info: {
    title: "APP NAME",
    version: "1.0.0",
    description: "APIs Documentation",
    contact: {
      name: "Your Name",
      email: "your_email@example.com",
    },
  },
  servers: [
    {
      url: LOCALHOST,
      description: "Development server",
    },
    // add more hosts...
  ],
};

var options = {
  swaggerDefinition: swaggerDefinition,
  apis: [
    path.join(__dirname, "../docs/swagger/testDocs.js"),
    // add more paths...
  ],
};

var swaggerSpec = swaggerJSDoc(options);

module.exports = swaggerSpec;