feat(added in swagger): added the base for swagger to implement fully later

app/main.ts

@@ -8,6 +8,8 @@ import { createProxyMiddleware, fixRequestBody } from "http-proxy-middleware";
 import morgan from "morgan";
 import os from "os";
 import { dirname, join } from "path";
+import swaggerJsdoc from "swagger-jsdoc";
+import swaggerUi from "swagger-ui-express";
 import { fileURLToPath } from "url";
 import { userMigrate } from "./src/internal/auth/controller/userMigrate.js";
 import { schedulerManager } from "./src/internal/logistics/controller/schedulerManager.js";
@@ -15,6 +17,8 @@ import { printers } from "./src/internal/ocp/printers/printers.js";
 import { setupRoutes } from "./src/internal/routerHandler/routeHandler.js";
 import { baseModules } from "./src/internal/system/controller/modules/baseModules.js";
 import { baseSettings } from "./src/internal/system/controller/settings/baseSettings.js";
+import { addListeners } from "./src/internal/system/utlis/addListeners.js";
+import { swaggerOptions } from "./src/pkg/apiDocs/swaggerOptions.js";
 import { auth } from "./src/pkg/auth/auth.js";
 import { db } from "./src/pkg/db/db.js";
 import { settings } from "./src/pkg/db/schema/settings.js";
@@ -30,7 +34,7 @@ import { setupIoServer } from "./src/ws/server.js";
 
 const main = async () => {
 	const env = validateEnv(process.env);
-	const PORT = Number(env.VITE_PORT) || 4200;
+	const PORT = Number(process.env.VITE_PORT) || 4200;
 
 	//create the logger
 	const log = createLogger({ module: "system", subModule: "main start" });
@@ -159,7 +163,14 @@ const main = async () => {
 		}),
 	);
 
-	// docs and api stuff
+	// docs and routes
+	const openapiSpec: any = swaggerJsdoc(swaggerOptions);
+	app.use(
+		basePath + "/api/docs",
+		swaggerUi.serve,
+		swaggerUi.setup(openapiSpec),
+	);
+
 	app.use(basePath + "/d", express.static(join(__dirname, "../lstDocs/build")));
 	app.use(
 		basePath + "/app",
@@ -192,6 +203,7 @@ const main = async () => {
 
 		// start up the v1listener
 		v1Listener();
+		addListeners();
 		userMigrate();
 	}, 5 * 1000);
 

app/src/pkg/apiDocs/swaggerOptions.ts

@@ -0,0 +1,11 @@
+export const swaggerOptions = {
+	definition: {
+		openapi: "3.0.0",
+		info: {
+			title: "Logistics Support Tool",
+			version: "1.0.0",
+		},
+	},
+	// globs where swagger-jsdoc should look for annotations:
+	apis: ["../../src/**/*.ts"],
+};