chore(route): ⚡ refactor usecases to use load.ts

Author: Anmol Gangwar

src/app.ts

@@ -53,7 +53,8 @@ export class App {
     // this.app.use(authMiddleware)
   }
 
-  private initializeSwaggerUI() {
+  private initializeSwaggerUI(): void {
+    // OpenAPI documentation for v1
     this.app.doc31('/swagger', (c) => {
       const { protocol: urlProtocol, hostname, port } = new URL(c.req.url)
       const protocol = c.req.header('x-forwarded-proto') ? `${c.req.header('x-forwarded-proto')}:` : urlProtocol
@@ -62,39 +63,49 @@ export class App {
         openapi: '3.1.0',
         info: {
           version: '1.0.0',
-          title: 'ExerciseDB API',
-          description: `# Introduction 
-          \nExerciseDB API, accessible at [v1.exercisedb.dev](https://v1.exercisedb.dev), is an exercises API that allows users to access high-quality exercises data which consists 1300+ exercises. 
-         This API offers extensive information on each exercise, including target body parts, equipment needed, GIFs for visual guidance, and step-by-step instructions.\n`
-        },
+          title: 'ExerciseDB API - v1 (Open Source)',
+          description: `**ExerciseDB API v1** is a fully open-source and developer-friendly fitness exercise database featuring over 1,500 structured exercises with **GIF-based visual media**. It includes detailed metadata like target muscles, equipment, and body parts, designed for fast integration into fitness apps, personal trainer platforms, and health tools.
+
+**📝 NOTE**: This version is public, free to use, and includes both the **code and dataset metadata** — making it perfect for personal projects, prototypes, learning, and community-driven apps.
 
+🔗 Useful Links:
+- 💬 Need full v1 Dataset access: [Chat](https://t.me/exercisedb)
+- 🚀 Explore our new v2 dataset: [v2.exercisedb.dev](https://v2.exercisedb.dev)
+- 🌐 Official Website: [exercisedb.dev](https://exercisedb.dev)`
+        },
         servers: [
           {
             url: `${protocol}//${hostname}${port ? `:${port}` : ''}`,
-            description: 'Current environment'
+            description:
+              'v1 Dataset (Open Source)\n• Public & open license\n• Code and metadata available on GitHub\n• GIF-based media\n• Ideal for demos, personal apps, and learning\n• chat support for full dataset access'
           }
         ]
       }
     })
 
+    // API Documentation UI
     this.app.get(
       '/docs',
       Scalar({
-        pageTitle: 'ExerciseDB API Documentation',
-        theme: 'bluePlanet',
+        pageTitle: 'ExerciseDB API - v1 (Open Source)',
+        theme: 'kepler',
         isEditable: false,
         layout: 'modern',
         darkMode: true,
         url: '/swagger',
         favicon: 'https://cdn.exercisedb.dev/exercisedb/favicon.ico',
         metaData: {
-          applicationName: 'ExerciseDB API',
-          author: 'ExerciseDB API',
-          creator: 'ExerciseDB API',
-          publisher: 'ExerciseDB API',
+          applicationName: 'ExerciseDB API - v1',
+          author: 'Ascend API',
+          creator: 'Ascend API',
+          publisher: 'Ascend API',
           robots: 'index follow',
-          description:
-            'Access detailed data on over 1300+ exercises with the ExerciseDB API. This API offers extensive information on each exercise, including target body parts, equipment needed, GIFs for visual guidance, and step-by-step instructions.'
+          description: `**ExerciseDB API v1** is a fully open-source exercise dataset offering 1,300+ exercises with rich metadata and GIF visualizations. Built for speed and ease of use, it's ideal for personal projects, prototypes, and education.
+
+🔗 Useful Links:
+- 💬 Chat with us for full GIF access: [Telegram](https://t.me/exercisedb)
+- 🚀 Explore our new v2 dataset: [v2.exercisedb.dev](https://v2.exercisedb.dev)
+- 🌐 Official Website: [exercisedb.dev](https://exercisedb.dev)`
         }
       })
     )

src/data/types.ts

@@ -3,13 +3,52 @@ export interface Equipment {
 }
 
 export interface Exercise {
+  /**
+   * The id of the exercise
+   * @example "trmte8s"
+   */
   exerciseId: string
+
+  /**
+   * The name of the exercise.
+   * @example "band shrug"
+   */
   name: string
+
+  /**
+   * The gifUrl of the exercise.
+   * @example "https://v1.cdn.exercisedb.dev/media/trmte8s.gif"
+   */
   gifUrl: string
+
+  /**
+   * List of equipment required for the exercise.
+   * @example ["band"]
+   */
   equipments: string[]
+
+  /**
+   * Primary body parts targeted by the exercise.
+   * @example ["back"]
+   */
   bodyParts: string[]
+
+  /**
+   * Primary muscles targeted by the exercise.
+   * @example ["traps"]
+   */
   targetMuscles: string[]
+
+  /**
+   * Secondary muscles engaged during the exercise.
+   * @example ["traps", "traps", "triceps"]
+   */
   secondaryMuscles: string[]
+
+  /**
+   * Step-by-step instructions to perform the exercise.
+   * @example ["Step:1 Stand with your feet shoulder-width apart and place the band under your feet, holding the ends with your hands..."]
+   */
   instructions: string[]
 }
 

src/middleware/auth/index.ts

@@ -11,7 +11,6 @@
 // const RESTRICTED_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE'])
 // const VALID_ROLES = new Set(['member', 'moderator', 'admin'])
 
-
 // interface RouteConfig {
 //   path: string
 //   allowedEnvs: Set<string>

src/modules/bodyparts/controllers/bodyPart.controller.ts

@@ -18,9 +18,8 @@ export class BodyPartController implements Routes {
       createRoute({
         method: 'get',
         path: '/bodyparts',
-        tags: ['BodyParts'],
-        summary: 'Retrive all bodyParts.',
-        description: 'Retrive list of all bodyparts.',
+        tags: ['BODYPARTS'],
+        summary: 'GetAllBodyparts',
         operationId: 'getBodyParts',
         responses: {
           200: {