@mathisalarcon/express-next 1.0.0

package/dist/index.js

@@ -0,0 +1,82 @@
+import fs from "node:fs";
+import path from "node:path";
+import express, { Router } from "express";
+import { pathToFileURL } from "node:url";
+export class ExpressNext {
+    constructor(options) {
+        this.app = express();
+        this.root = options.root;
+        this.port = options.port ?? 3000;
+    }
+    set(key, value) {
+        this.app.set(key, value);
+    }
+    use(middleware) {
+        this.app.use(middleware);
+    }
+    async start() {
+        await this.handleRoute(this.app, this.root);
+        return new Promise((resolve) => {
+            this.app.listen(this.port, (err) => {
+                if (err instanceof Error) {
+                    // If port is in use, still resolve the promise
+                    console.error("Couldn't start server:", err.message);
+                    console.log(`Port ${this.port} might be in use. Trying with port ${++this.port}...`);
+                    this.start().then(() => resolve());
+                }
+                else {
+                    console.log(`Server is running on port ${this.port}`);
+                    resolve();
+                }
+            });
+        });
+    }
+    async handleRoute(router, dir) {
+        const files = fs
+            .readdirSync(dir)
+            .filter((file) => fs.statSync(path.join(dir, file)).isFile() &&
+            (file === "middleware.js" ||
+                file === "middleware.ts" ||
+                file === "route.js" ||
+                file === "route.ts"))
+            .sort((a, b) => {
+            if (a === "middleware.js" || a === "middleware.ts")
+                return -1;
+            if (b === "middleware.js" || b === "middleware.ts")
+                return 1;
+            return 0;
+        });
+        for (let file of files) {
+            const fullPath = path.join(dir, file);
+            if (file === "middleware.js" || file === "middleware.ts") {
+                const middleware = await import(pathToFileURL(fullPath).href);
+                router.use(middleware.default);
+            }
+            else {
+                const route = await import(pathToFileURL(fullPath).href);
+                if (route.GET)
+                    router.get("/", route.GET);
+                if (route.POST)
+                    router.post("/", route.POST);
+                if (route.PUT)
+                    router.put("/", route.PUT);
+                if (route.DELETE)
+                    router.delete("/", route.DELETE);
+                if (route.PATCH)
+                    router.patch("/", route.PATCH);
+            }
+        }
+        const subdirs = fs
+            .readdirSync(dir)
+            .filter((file) => fs.statSync(path.join(dir, file)).isDirectory());
+        for (let subdir of subdirs) {
+            const subdirPath = path.join(dir, subdir);
+            const subRouter = Router({ mergeParams: true });
+            const routerName = subdir.startsWith("[") && subdir.endsWith("]")
+                ? `:${subdir.slice(1, -1)}`
+                : subdir;
+            await this.handleRoute(subRouter, subdirPath);
+            router.use(`/${routerName}`, subRouter);
+        }
+    }
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@mathisalarcon/express-next",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "npx tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "dependencies": {
+    "@types/express": "^5.0.6",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,108 @@
+import fs from "node:fs";
+import path from "node:path";
+import express, { Router } from "express";
+import { pathToFileURL } from "node:url";
+
+export type ExpressNextOptions = {
+	root: string; // The root directory of the Next.js application
+	port?: number;
+};
+
+type RouteExport = {
+	GET: express.RequestHandler;
+	POST?: express.RequestHandler;
+	PUT?: express.RequestHandler;
+	DELETE?: express.RequestHandler;
+	PATCH?: express.RequestHandler;
+};
+type MiddlewareExport = {
+	default: express.RequestHandler;
+};
+
+export class ExpressNext {
+	app: express.Express;
+	root: string;
+	port: number;
+
+	constructor(options: ExpressNextOptions) {
+		this.app = express();
+		this.root = options.root;
+		this.port = options.port ?? 3000;
+	}
+
+	set(key: string, value: any) {
+		this.app.set(key, value);
+	}
+	use(middleware: express.RequestHandler) {
+		this.app.use(middleware);
+	}
+
+	async start(): Promise<void> {
+		await this.handleRoute(this.app, this.root);
+		return new Promise((resolve) => {
+			this.app.listen(this.port, (err) => {
+				if (err instanceof Error) {
+					// If port is in use, still resolve the promise
+					console.error("Couldn't start server:", err.message);
+					console.log(
+						`Port ${this.port} might be in use. Trying with port ${++this.port}...`,
+					);
+					this.start().then(() => resolve());
+				} else {
+					console.log(`Server is running on port ${this.port}`);
+					resolve();
+				}
+			});
+		});
+	}
+
+	private async handleRoute(router: Router, dir: string) {
+		const files = fs
+			.readdirSync(dir)
+			.filter(
+				(file) =>
+					fs.statSync(path.join(dir, file)).isFile() &&
+					(file === "middleware.js" ||
+						file === "middleware.ts" ||
+						file === "route.js" ||
+						file === "route.ts"),
+			)
+			.sort((a, b) => {
+				if (a === "middleware.js" || a === "middleware.ts") return -1;
+				if (b === "middleware.js" || b === "middleware.ts") return 1;
+				return 0;
+			});
+		for (let file of files) {
+			const fullPath = path.join(dir, file);
+			if (file === "middleware.js" || file === "middleware.ts") {
+				const middleware: MiddlewareExport = await import(
+					pathToFileURL(fullPath).href
+				);
+				router.use(middleware.default);
+			} else {
+				const route: RouteExport = await import(
+					pathToFileURL(fullPath).href
+				);
+				if (route.GET) router.get("/", route.GET);
+				if (route.POST) router.post("/", route.POST);
+				if (route.PUT) router.put("/", route.PUT);
+				if (route.DELETE) router.delete("/", route.DELETE);
+				if (route.PATCH) router.patch("/", route.PATCH);
+			}
+		}
+		const subdirs = fs
+			.readdirSync(dir)
+			.filter((file) => fs.statSync(path.join(dir, file)).isDirectory());
+
+		for (let subdir of subdirs) {
+			const subdirPath = path.join(dir, subdir);
+			const subRouter = Router({ mergeParams: true });
+			const routerName =
+				subdir.startsWith("[") && subdir.endsWith("]")
+					? `:${subdir.slice(1, -1)}`
+					: subdir;
+			await this.handleRoute(subRouter, subdirPath);
+			router.use(`/${routerName}`, subRouter);
+		}
+	}
+}

package/src/types/express.d.ts

@@ -0,0 +1,7 @@
+import "express";
+
+declare module "express-serve-static-core" {
+    interface Request {
+        [key: string]: any;
+	}
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compileOnSave": true,
+    "compilerOptions": {
+        "target": "es2020",
+        "lib": ["ES2020"],
+        "module": "nodenext",
+        "moduleResolution": "nodenext",
+
+        "strict": true,
+        "esModuleInterop": true,
+        "verbatimModuleSyntax": true,
+
+        "resolveJsonModule": true,
+        "forceConsistentCasingInFileNames": true,
+        "skipLibCheck": true,
+
+        "outDir": "./dist",
+        "rootDir": "./src"
+    },
+    "include": ["src"],
+}