fix: resolve swagger yaml indentation errors

Author: Aditya-18849

backend/Swagger.js

@@ -23,7 +23,7 @@ const options = {
         },
       },
     },
-    // --- DOCUMENTATION DEFINED HERE TO PREVENT INDENTATION ERRORS ---
+    // Keep existing hardcoded paths for now so Registration/Login don't disappear
     paths: {
       '/api/auth/registration': {
         post: {
@@ -74,8 +74,8 @@ const options = {
       }
     }
   },
-  // We turn off file scanning so it doesn't look for broken comments
-  apis: [], 
+  // FIX: Enable scanner to find docs in route files
+  apis: ['./routes/*.js'], 
 };
 
 const specs = swaggerJsdoc(options);

backend/package-lock.json

@@ -17,6 +17,7 @@
     "cors": "^2.8.5",
     "dotenv": "^16.5.0",
     "express": "^5.1.0",
+    "joi": "^18.0.2",
     "jsonwebtoken": "^9.0.2",
     "mongoose": "^8.15.2",
     "multer": "^2.0.1",

backend/package.json

@@ -5,12 +5,82 @@ import { registerSchema, loginSchema } from "../validators/authSchemas.js";
 
 const authRoutes = express.Router();
 
-// Routes are now documented in Swagger.js to avoid crash errors
+// Note: Registration and Login are documented in Swagger.js
 authRoutes.post("/registration", validateRequest(registerSchema), registration);
 authRoutes.post("/login", validateRequest(loginSchema), login);
 
-authRoutes.get("/logout", logOut);
+/**
+ * @swagger
+ * /api/auth/logout:
+ *   get:
+ *     summary: Logout the current user
+ *     tags: [Auth]
+ *     responses:
+ *       200:
+ *         description: Successfully logged out
+ *       500:
+ *         description: Server error
+ */
+authRoutes.get("/lout", logOut);
+
+/**
+ * @swagger
+ * /api/auth/googlelogin:
+ *   post:
+ *     summary: Login using Google OAuth
+ *     tags: [Auth]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - tokenId
+ *             properties:
+ *               tokenId:
+ *                 type: string
+ *                 description: The token received from Google
+ *     responses:
+ *       200:
+ *         description: Google login successful
+ *       400:
+ *         description: Invalid token
+ *       500:
+ *         description: Server error
+ */
 authRoutes.post("/googlelogin", googleLogin);
+
+/**
+ * @swagger
+ * /api/auth/adminlogin:
+ *   post:
+ *     summary: Login for Admin users
+ *     tags: [Auth]
+ *     requestBody:
+ *       required: true
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             required:
+ *               - email
+ *               - password
+ *             properties:
+ *               email:
+ *                 type: string
+ *                 description: Admin email address
+ *               password:
+ *                 type: string
+ *                 description: Admin password
+ *     responses:
+ *       200:
+ *         description: Admin login successful
+ *       401:
+ *         description: Unauthorized credentials
+ *       500:
+ *         description: Server error
+ */
 authRoutes.post("/adminlogin", adminLogin);
 
 export default authRoutes;