docs(api): improve Swagger documentation and API config

Author: AlkenD

apps/api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Express API with TypeScript",
   "main": "dist/index.js",
   "scripts": {
@@ -38,6 +38,7 @@
     "express-rate-limit": "^7.4.1",
     "helmet": "^7.1.0",
     "jsonwebtoken": "^9.0.2",
+    "node-vibrant": "^4.0.2",
     "pg": "^8.16.3",
     "swagger-jsdoc": "^6.2.8",
     "swagger-ui-express": "^5.0.1",

apps/api/src/lib/config/swagger.ts

@@ -4,6 +4,19 @@ import { config } from "../../core/config/env";
 import { logger } from "../../lib/utils";
 import path from "path";
 import os from "os";
+import { readFileSync } from "fs";
+
+// Read version from package.json
+function getApiVersion(): string {
+  try {
+    const packageJson = JSON.parse(
+      readFileSync(path.join(__dirname, "../../../package.json"), "utf-8")
+    );
+    return packageJson.version;
+  } catch (error) {
+    return "0.1.0"; // Fallback version
+  }
+}
 
 /// Get local machine IP address for LAN access
 function getLocalIpAddress(): string {
@@ -22,13 +35,14 @@ function getLocalIpAddress(): string {
 }
 
 const localIp = getLocalIpAddress();
+const apiVersion = getApiVersion();
 
 const options = {
   definition: {
     openapi: "3.0.0",
     info: {
       title: "DesterLib API",
-      version: "1.0.0",
+      version: apiVersion,
       description:
         "API documentation for DesterLib - A comprehensive media library management system",
       contact: {
@@ -93,6 +107,11 @@ const options = {
               type: "string",
               example: "OK",
             },
+            version: {
+              type: "string",
+              example: "0.1.0",
+              description: "API version",
+            },
             timestamp: {
               type: "string",
               format: "date-time",
@@ -231,7 +250,7 @@ try {
     openapi: "3.0.0",
     info: {
       title: "DesterLib API",
-      version: "1.0.0",
+      version: apiVersion,
       description: "API documentation for DesterLib",
     },
     paths: {},