slower 2.1.2 → 2.1.4

package/package.json

@@ -3,7 +3,7 @@
 		"path-to-regexp": "^6.2.2"
 	},
 	"name": "slower",
-	"version": "2.1.2",
+	"version": "2.1.4",
 	"main": "index.js",
 	"devDependencies": {},
 	"scripts": {

package/src/slower.js

@@ -2,6 +2,7 @@
 const http = require('node:http');
 const https = require('node:https');
 const path = require('node:path');
+const fs = require('node:fs');
 const { createReadStream } = require('node:fs');
 const { pipeline } = require('node:stream/promises');
 
@@ -67,8 +68,9 @@ class SlowerRouter {
             // Get all routes that match the URL and join with middlewares to cycle
             let foundRoutes = utils.getMatchingRoute(req.url, req.method, self.layers);
             let layers = foundRoutes;
-            // If there are no layers, add an Error:404 special layer (not found)
-            if (layers.length === 0) layers.push(utils.noLayersFoundFallback);
+            // Add an Error:404 special layer to the end of the layers list
+            // This prevents accidental requests hanging
+            layers.push(utils.noLayersFoundFallback);
 
             // Set properties on request and response objects
             req = await setupRequest(req);
@@ -171,6 +173,9 @@ class SlowerRouter {
      */
     static (directoryPath, mountPath = '') {
         const absoluteDir = path.resolve(directoryPath);
+        if (!fs.existsSync(absoluteDir))
+            throw new Error(`Invalid directory provided for [SlowerRouter].static(): [${directoryPath}]`);
+
         for (const file of utils.getFiles(absoluteDir)) {
             // Get only the file name from the absolute file path 'c:\u\a.txt' -> 'a.txt'
             let fileAsURLPath = file.replaceAll(/\\/g, '/').split('/').slice(-1)[0];
@@ -238,21 +243,24 @@ class SlowerRouter {
 
 
 /**
- * Used as the class for micro-routing with "app.route"
- * 
- * only method acessors (.get(), .post(), .put(), ...)
- * and .all() and .use()
- * 
- * .static() is not allowed
+ * Used as the class for modular routers
+ * used in "slower.Router()"
  */
-class SlowerMicroRouter {
-    constructor (path, layerPool) {
-        this.path = path;
-        this.layers = layerPool;
+class SlowerSubRouter {
+    constructor () {
+        this.METHODS = HTTP_VERBS;
+        this.layers = new Array();
+
+        // Create basic route shortcuts
+        // get(), post(), put(), delete()
+        for (let verb of HTTP_VERBS) {
+            this[verb] = function (path, callback) {
+                return this.#setRoute(verb, path, callback);
+            };
+        }
     }
 
-    #setRoute (method, handler) {
-        const path = this.path;
+    #setRoute (method, path, handler) {
         if (typeof method !== 'string') 
             throw new Error('<SlowerSubRouter>.route :: "method" parameter must be of type String');
         if (typeof path !== 'string' && path?.constructor?.name !== 'RegExp')
@@ -263,8 +271,7 @@ class SlowerMicroRouter {
         return this;
     }
 
-    all (handler) {
-        const path = this.path;
+    all (path, handler) {
         if (typeof path === 'string')
             for (let verb of HTTP_VERBS) this.#setRoute(verb, path, handler);
         else if (typeof path !== 'function')
@@ -274,28 +281,54 @@ class SlowerMicroRouter {
     }
     // Just a more comprehensive call to app.all for defining middlewares
     use (...b) { this.all(...b); return this; };
+
+    static (directoryPath, mountPath = '') {
+        this.layers.push({ static: true, directoryPath, mountPath });
+        return this;
+    }
+
+    /**
+     * Creates a temporary synced mini-router for a specific path
+     * Allows to declare multiple handlers for methods of a specific path
+     * @param {string} path 
+     * @returns {SlowerMicroRouter}
+     * @example 
+     *  app.route('/books')
+     *      .get((req, res) => console.log('you retrieved a book with GET'))
+     *      .post((req, res) => console.log('you added a book with POST'))
+     *  ;
+     */
+    route (path) {
+        return new SlowerMicroRouter(path, this.layers);
+    }
 }
 
 
+
 /**
- * Used as the class for modular routers
- * used in "slower.Router()"
+ * Used as the class for micro-routing with "app.route"
+ * 
+ * only method acessors (.get(), .post(), .put(), ...)
+ * and .all() and .use()
+ * 
+ * .static() is not allowed
  */
-class SlowerSubRouter {
-    constructor () {
-        this.METHODS = HTTP_VERBS;
-        this.layers = new Array();
+class SlowerMicroRouter {
+    constructor (path, layerPool) {
+        this.path = path;
+        this.layers = layerPool;
 
         // Create basic route shortcuts
         // get(), post(), put(), delete()
         for (let verb of HTTP_VERBS) {
-            this[verb] = function (path, callback) {
-                return this.#setRoute(verb, path, callback);
+            this[verb] = function (callback) {
+                return this.#setRoute(verb, callback);
             };
         }
     }
 
-    #setRoute (method, path, handler) {
+    #setRoute (method, handler) {
+        const path = this.path;
         if (typeof method !== 'string') 
             throw new Error('<SlowerSubRouter>.route :: "method" parameter must be of type String');
         if (typeof path !== 'string' && path?.constructor?.name !== 'RegExp')
@@ -306,7 +339,8 @@ class SlowerSubRouter {
         return this;
     }
 
-    all (path, handler) {
+    all (handler) {
+        const path = this.path;
         if (typeof path === 'string')
             for (let verb of HTTP_VERBS) this.#setRoute(verb, path, handler);
         else if (typeof path !== 'function')
@@ -316,13 +350,9 @@ class SlowerSubRouter {
     }
     // Just a more comprehensive call to app.all for defining middlewares
     use (...b) { this.all(...b); return this; };
-
-    static (directoryPath, mountPath = '') {
-        this.layers.push({ static: true, directoryPath, mountPath });
-        return this;
-    }
 }
 
+
 // Create basic main routing creation
 function slower (options) {
     return new SlowerRouter(options);