npm install swagger-ui-express swagger-jsdocnpm install -D @types/swagger-ui-express @types/swagger-jsdoc

// src/config/swagger.tsimport swaggerJsdoc from 'swagger-jsdoc'; const options = {  definition: {    openapi: '3.0.0',    info: {      title: 'E-commerce API',      version: '1.0.0',      description: 'Complete e-commerce API',    },    servers: [      { url: 'http://localhost:3000', description: 'Development' },    ],    components: {      securitySchemes: {        bearerAuth: { type: 'http', scheme: 'bearer', bearerFormat: 'JWT' },      },    },  },  apis: ['./src/routes/*.ts', './src/schemas/*.ts'],}; export const swaggerSpec = swaggerJsdoc(options);

// src/app.tsimport swaggerUi from 'swagger-ui-express';import { swaggerSpec } from './config/swagger'; app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));

/** * @openapi * /api/products: *   get: *     tags: [Products] *     summary: List all products *     parameters: *       - in: query *         name: page *         schema: *           type: integer *     responses: *       200: *         description: Products list */router.get('/', controller.list); /** * @openapi * /api/products: *   post: *     tags: [Products] *     summary: Create product *     security: *       - bearerAuth: [] *     requestBody: *       required: true *       content: *         application/json: *           schema: *             $ref: '#/components/schemas/CreateProduct' *     responses: *       201: *         description: Product created */router.post('/', authenticate, controller.create);

/** * @openapi * components: *   schemas: *     Product: *       type: object *       properties: *         id: *           type: string *         name: *           type: string *         price: *           type: number */