added swager

Author: tigran-hostaways

package.json

@@ -41,16 +41,20 @@
     "mongoose": "^8.8.0",
     "nodemailer": "^7.0.12",
     "sanitize-html": "^2.17.0",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "@types/body-parser": "^1.19.5",
-    "@types/sanitize-html": "^2.16.0",
     "@types/cookie-parser": "^1.4.7",
     "@types/cors": "^2.8.17",
     "@types/dotenv-safe": "^8.1.6",
     "@types/jsonwebtoken": "^9.0.6",
     "@types/nodemailer": "^6.4.14",
+    "@types/sanitize-html": "^2.16.0",
+    "@types/swagger-jsdoc": "^6.0.4",
+    "@types/swagger-ui-express": "^4.1.8",
     "@typescript-eslint/eslint-plugin": "^7.1.0",
     "@typescript-eslint/parser": "^7.1.0",
     "eslint": "^8.57.0",

src/app.ts

@@ -6,9 +6,11 @@ import express, { ErrorRequestHandler } from 'express';
 import http from 'http';
 import cors from 'cors';
 import rateLimit from 'express-rate-limit';
+import swaggerUi from 'swagger-ui-express';
 import api from './api';
 import { migrate } from './migrations';
 import { AppError } from '@/utils';
+import { swaggerSpec } from './services/swagger';
 
 // Validate required environment variables
 const requiredEnvVars = ['JWT_SECRET', 'MONGODB_URI'];
@@ -64,6 +66,22 @@ app.get('/health', (req, res) => {
   });
 });
 
+// Swagger documentation
+app.use(
+  '/docs',
+  swaggerUi.serve,
+  swaggerUi.setup(swaggerSpec, {
+    customCss: '.swagger-ui .topbar { display: none }',
+    customSiteTitle: 'Zoomment API Docs'
+  })
+);
+
+// Swagger JSON endpoint
+app.get('/docs.json', (req, res) => {
+  res.setHeader('Content-Type', 'application/json');
+  res.send(swaggerSpec);
+});
+
 app.use('/api', api);
 
 // Error handler
@@ -87,6 +105,7 @@ const server = http.createServer(app);
 setImmediate(() => {
   server.listen(process.env.PORT, () => {
     console.log('Express server listening on http://localhost:%s/', process.env.PORT);
+    console.log('API Docs available at http://localhost:%s/docs', process.env.PORT);
   });
 });