feat: modularize documentation

Author: simply-alliv

src/jsdocs/admins.yaml

@@ -1,6 +1,6 @@
 definitions:
-  # BadRequestResponse model
-  BadRequestResponse:
+  # BadRequest model
+  BadRequest:
     type: object
     properties:
       status:

src/jsdocs/definitions.yaml src/jsdocs/definitions/badRequest.yamlsrc/jsdocs/definitions.yaml renamed to src/jsdocs/definitions/badRequest.yaml

@@ -9,7 +9,7 @@ paths:
       summary: Authenticates with Google
 
       security:
-        - Bearer: []
+        - AdminToken: []
 
       responses:
         "200":
@@ -29,4 +29,4 @@ paths:
         "400":
           description: Invalid body supplied
           schema:
-            $ref: "#/definitions/BadRequestResponse"
+            $ref: "#/definitions/BadRequest"

src/jsdocs/providers.yaml src/jsdocs/providers/google.yamlsrc/jsdocs/providers.yaml renamed to src/jsdocs/providers/google.yaml

@@ -1,14 +1,5 @@
 import swaggerJSDoc from "swagger-jsdoc";
 
-// List of tags used by documentation.
-export const GENERAL_TAG = "General";
-export const ADMINISTRATOR_TAG = "Administrators";
-export const USER_TAG = "Users";
-export const AUTH_PROVIDER_TAG = "Authentication Providers";
-
-// Security schema.
-export const apiKeySecurity = [{ Bearer: {} }];
-
 // Swagger definition
 const swaggerDefinition = {
   info: {
@@ -59,7 +50,12 @@ const swaggerDefinition = {
   ],
   components: {
     securitySchemes: {
-      Bearer: {
+      AdminToken: {
+        type: "http",
+        scheme: "bearer",
+        bearerFormat: "JWT",
+      },
+      UserToken: {
         type: "http",
         scheme: "bearer",
         bearerFormat: "JWT",