exrout 1.0.4 → 1.1.1

package/dist/esm/loadRoutes.js

@@ -0,0 +1,166 @@
+import fs from "fs";
+import path from "path";
+import { pathToFileURL } from "url";
+import { Router } from "express";
+import { normalizeRouteName, cleanSlashes, shouldExclude, extractHttpMethod, getRouteFromMethodFile, sortRoutes, } from "./utils.js";
+/**
+ * Recursively loads route files from a directory structure
+ */
+export default async function loadRoutes(app, dir, options = {}) {
+    const { prefix = "", middleware = [], log = false, exclude = [] } = options;
+    const loadedRoutes = [];
+    async function processDirectory(currentDir, baseRoute) {
+        let files;
+        try {
+            files = fs.readdirSync(currentDir);
+        }
+        catch (error) {
+            const err = error;
+            if (err.code === "ENOENT") {
+                console.warn(`[exrout] Warning: Directory not found: ${currentDir}`);
+                return;
+            }
+            throw new Error(`[exrout] Failed to read directory "${currentDir}": ${err.message}`);
+        }
+        // Collect routes for sorting
+        const routesToProcess = [];
+        for (const file of files) {
+            const fullPath = path.join(currentDir, file);
+            // Check exclusion patterns
+            if (shouldExclude(file, exclude)) {
+                if (log) {
+                    console.log(`[exrout] Skipped (excluded): ${file}`);
+                }
+                continue;
+            }
+            let stat;
+            try {
+                stat = fs.statSync(fullPath);
+            }
+            catch (error) {
+                console.warn(`[exrout] Warning: Cannot stat file: ${fullPath}`);
+                continue;
+            }
+            if (stat.isDirectory()) {
+                routesToProcess.push({
+                    fullPath,
+                    routePath: cleanSlashes(`${baseRoute}/${normalizeRouteName(file)}`),
+                    isDirectory: true,
+                });
+                continue;
+            }
+            // Only process .js and .ts files (not .d.ts)
+            if (!file.match(/\.(js|ts)$/) || file.endsWith(".d.ts")) {
+                continue;
+            }
+            const name = file.replace(/\.(js|ts)$/, "");
+            const isIndex = name === "index";
+            const httpMethod = extractHttpMethod(file);
+            let routePath;
+            if (httpMethod) {
+                // HTTP method file: get.ts -> route handled with specific method
+                const routeName = getRouteFromMethodFile(file);
+                routePath = cleanSlashes(routeName
+                    ? `${baseRoute}/${normalizeRouteName(routeName)}`
+                    : baseRoute);
+            }
+            else {
+                // Regular file: users.ts -> /users
+                routePath = cleanSlashes(isIndex ? baseRoute : `${baseRoute}/${normalizeRouteName(name)}`);
+            }
+            routesToProcess.push({
+                fullPath,
+                routePath,
+                isDirectory: false,
+                httpMethod: httpMethod || undefined,
+            });
+        }
+        // Sort routes for consistent order (static before dynamic)
+        const sortedRoutePaths = sortRoutes(routesToProcess.filter((r) => !r.isDirectory).map((r) => r.routePath));
+        // Process directories first (recursively)
+        for (const item of routesToProcess.filter((r) => r.isDirectory)) {
+            await processDirectory(item.fullPath, item.routePath);
+        }
+        // Process files in sorted order
+        for (const routePath of sortedRoutePaths) {
+            const item = routesToProcess.find((r) => !r.isDirectory && r.routePath === routePath);
+            if (!item)
+                continue;
+            try {
+                // Use pathToFileURL for cross-platform compatibility
+                const fileUrl = pathToFileURL(item.fullPath).href;
+                // Clear module cache for hot reload support
+                if (typeof require !== "undefined" && require.cache) {
+                    delete require.cache[require.resolve(item.fullPath)];
+                }
+                let mod;
+                try {
+                    mod = await import(fileUrl);
+                }
+                catch (importError) {
+                    // Fallback for CommonJS environments
+                    mod = require(item.fullPath);
+                }
+                let router = mod.default || mod;
+                // Support async router factory functions
+                if (typeof router === "function" && !isRouter(router)) {
+                    try {
+                        router = await router();
+                    }
+                    catch (factoryError) {
+                        throw new Error(`[exrout] Router factory in "${item.fullPath}" threw an error: ${factoryError.message}`);
+                    }
+                }
+                // Validate router
+                if (!isRouter(router)) {
+                    console.warn(`[exrout] Warning: "${item.fullPath}" does not export a valid Router. Skipping.`);
+                    continue;
+                }
+                // Register route with appropriate method or use all methods
+                if (item.httpMethod && item.httpMethod !== "all") {
+                    // For method-specific files, wrap in a new router
+                    const methodRouter = Router();
+                    methodRouter[item.httpMethod]("/", router);
+                    app.use(routePath, ...middleware, methodRouter);
+                }
+                else {
+                    app.use(routePath, ...middleware, router);
+                }
+                loadedRoutes.push({
+                    path: routePath,
+                    file: item.fullPath,
+                    method: item.httpMethod,
+                });
+                if (log) {
+                    const methodStr = item.httpMethod
+                        ? ` [${item.httpMethod.toUpperCase()}]`
+                        : "";
+                    console.log(`[exrout] ${routePath}${methodStr}`);
+                }
+            }
+            catch (error) {
+                const err = error;
+                console.error(`[exrout] Error loading route "${item.fullPath}": ${err.message}`);
+                // Re-throw in production, continue in development
+                if (process.env.NODE_ENV === "production") {
+                    throw err;
+                }
+            }
+        }
+    }
+    // Resolve the directory path
+    const resolvedDir = path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);
+    await processDirectory(resolvedDir, prefix);
+    return loadedRoutes;
+}
+/**
+ * Type guard to check if a value is an Express Router
+ */
+function isRouter(obj) {
+    return (obj &&
+        typeof obj === "function" &&
+        typeof obj.use === "function" &&
+        typeof obj.get === "function" &&
+        typeof obj.post === "function");
+}
+//# sourceMappingURL=loadRoutes.js.map

package/dist/esm/loadRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadRoutes.js","sourceRoot":"","sources":["../../src/loadRoutes.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Utility functions for route path processing
+ */
+/**
+ * Converts bracket notation in filenames to Express route parameters
+ * @example normalizeRouteName("[id]") => ":id"
+ * @example normalizeRouteName("[userId]") => ":userId"
+ */
+export declare function normalizeRouteName(name: string): string;
+/**
+ * Cleans up multiple consecutive slashes and ensures consistent path format
+ * @example cleanSlashes("//api///users") => "/api/users"
+ */
+export declare function cleanSlashes(routePath: string): string;
+/**
+ * Checks if a filename should be excluded based on patterns
+ * @param filename The filename to check
+ * @param patterns Array of glob-like patterns (supports * and ?)
+ * @returns true if the file should be excluded
+ */
+export declare function shouldExclude(filename: string, patterns: string[]): boolean;
+/**
+ * Extracts HTTP method from filename if it follows the pattern
+ * @example extractHttpMethod("get.ts") => "get"
+ * @example extractHttpMethod("post.users.ts") => "post"
+ * @example extractHttpMethod("users.ts") => null
+ */
+export declare function extractHttpMethod(filename: string): string | null;
+/**
+ * Gets the route name from a method-prefixed filename
+ * @example getRouteFromMethodFile("get.users.ts") => "users"
+ * @example getRouteFromMethodFile("post.ts") => ""
+ */
+export declare function getRouteFromMethodFile(filename: string): string;
+/**
+ * Sorts route paths for consistent registration order
+ * Static routes come before dynamic routes (with :params)
+ */
+export declare function sortRoutes(routes: string[]): string[];
+/**
+ * Validates that a path exists and is accessible
+ */
+export declare function validatePath(dirPath: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAetD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAS3E;AAgBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlD"}

package/dist/esm/utils.js

@@ -0,0 +1,112 @@
+/**
+ * Utility functions for route path processing
+ */
+/**
+ * Converts bracket notation in filenames to Express route parameters
+ * @example normalizeRouteName("[id]") => ":id"
+ * @example normalizeRouteName("[userId]") => ":userId"
+ */
+export function normalizeRouteName(name) {
+    return name.replace(/\[(.+?)\]/g, ":$1");
+}
+/**
+ * Cleans up multiple consecutive slashes and ensures consistent path format
+ * @example cleanSlashes("//api///users") => "/api/users"
+ */
+export function cleanSlashes(routePath) {
+    // Replace multiple slashes with single slash
+    let cleaned = routePath.replace(/\/+/g, "/");
+    // Ensure path starts with /
+    if (cleaned && !cleaned.startsWith("/")) {
+        cleaned = "/" + cleaned;
+    }
+    // Remove trailing slash (except for root)
+    if (cleaned.length > 1 && cleaned.endsWith("/")) {
+        cleaned = cleaned.slice(0, -1);
+    }
+    return cleaned || "/";
+}
+/**
+ * Checks if a filename should be excluded based on patterns
+ * @param filename The filename to check
+ * @param patterns Array of glob-like patterns (supports * and ?)
+ * @returns true if the file should be excluded
+ */
+export function shouldExclude(filename, patterns) {
+    if (!patterns || patterns.length === 0)
+        return false;
+    for (const pattern of patterns) {
+        if (matchPattern(filename, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Simple glob-like pattern matching
+ * Supports * (any characters) and ? (single character)
+ */
+function matchPattern(str, pattern) {
+    // Escape special regex chars except * and ?
+    const regexPattern = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, ".*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${regexPattern}$`, "i").test(str);
+}
+/**
+ * Extracts HTTP method from filename if it follows the pattern
+ * @example extractHttpMethod("get.ts") => "get"
+ * @example extractHttpMethod("post.users.ts") => "post"
+ * @example extractHttpMethod("users.ts") => null
+ */
+export function extractHttpMethod(filename) {
+    const methods = ["get", "post", "put", "patch", "delete", "head", "options", "all"];
+    const name = filename.replace(/\.(js|ts)$/, "").toLowerCase();
+    // Check if filename starts with HTTP method
+    for (const method of methods) {
+        if (name === method || name.startsWith(`${method}.`)) {
+            return method;
+        }
+    }
+    return null;
+}
+/**
+ * Gets the route name from a method-prefixed filename
+ * @example getRouteFromMethodFile("get.users.ts") => "users"
+ * @example getRouteFromMethodFile("post.ts") => ""
+ */
+export function getRouteFromMethodFile(filename) {
+    const name = filename.replace(/\.(js|ts)$/, "");
+    const parts = name.split(".");
+    if (parts.length > 1) {
+        return parts.slice(1).join(".");
+    }
+    return "";
+}
+/**
+ * Sorts route paths for consistent registration order
+ * Static routes come before dynamic routes (with :params)
+ */
+export function sortRoutes(routes) {
+    return [...routes].sort((a, b) => {
+        // Static routes first
+        const aHasParam = a.includes(":");
+        const bHasParam = b.includes(":");
+        if (aHasParam && !bHasParam)
+            return 1;
+        if (!aHasParam && bHasParam)
+            return -1;
+        // Alphabetical within same type
+        return a.localeCompare(b);
+    });
+}
+/**
+ * Validates that a path exists and is accessible
+ */
+export function validatePath(dirPath) {
+    if (!dirPath) {
+        throw new Error("[exrout] Routes directory path is required");
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,6CAA6C;IAC7C,IAAI,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7C,4BAA4B;IAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,GAAG,GAAG,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,IAAI,GAAG,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,QAAkB;IAChE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAErD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW,EAAE,OAAe;IAChD,4CAA4C;IAC5C,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEvB,OAAO,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE9D,4CAA4C;IAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAgB;IACzC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/B,sBAAsB;QACtB,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,SAAS,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,IAAI,SAAS;YAAE,OAAO,CAAC,CAAC,CAAC;QAEvC,gCAAgC;QAChC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exrout",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "description": "Automatically load and register Express routes from folder structure",
   "type": "module",
 
@@ -10,8 +10,14 @@
 
   "exports": {
     ".": {
-      "require": "./dist/cjs/index.cjs",
-      "import": "./dist/esm/index.js"
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.cjs"
+      },
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
     }
   },
 
@@ -19,21 +25,56 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc && tsc-esm",
-    "test": "jest"
+    "build": "npm run build:cjs && npm run build:esm && npm run fix:extensions",
+    "build:cjs": "tsc -p tsconfig.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "fix:extensions": "node scripts/fix-extensions.js",
+    "test": "npx jest --runInBand",
+    "prepublishOnly": "npm run build && npm test"
   },
-  "dependencies": {
-    "express": "^4.18.2"
+  "dependencies": {},
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0",
+    "chokidar": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "chokidar": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/express": "^4.17.17",
     "@types/jest": "^29.5.3",
+    "@types/supertest": "^2.0.12",
+    "chokidar": "^3.5.3",
+    "express": "^4.18.2",
     "jest": "^29.6.1",
     "supertest": "^6.3.3",
-    "typescript": "^5.2.2",
-    "tsc-alias": "^1.8.16"
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.2.2"
   },
-  "keywords": ["express", "routes", "auto", "typescript", "commonjs", "esm"],
+  "keywords": [
+    "express",
+    "routes",
+    "auto",
+    "automatic",
+    "loader",
+    "file-based",
+    "routing",
+    "typescript",
+    "commonjs",
+    "esm"
+  ],
   "license": "MIT",
-  "author": "Marouane Akrich"
+  "author": "Marouane Akrich",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marouaneakrich/exrout"
+  },
+  "bugs": {
+    "url": "https://github.com/marouaneakrich/exrout/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
 }