vanilla-jet 1.1.6 → 1.1.8

package/docs/router.md

@@ -0,0 +1,84 @@
+# Router Documentation
+
+## routeToRegExp Method
+
+The `routeToRegExp` method converts URL route patterns into regular expressions for route matching. This method is inspired by Backbone's router implementation and supports various parameter types.
+
+### Syntax
+```javascript
+router.routeToRegExp(route)
+```
+
+### Parameters
+- `route` (String): The route pattern to convert to a regular expression
+
+### Return Value
+Returns a RegExp object that can be used to match URLs against the route pattern.
+
+### Supported Pattern Types
+
+1. **Optional Parameters**: `(param)`
+   - Matches optional segments in the URL
+   - Example: `/items(/:id)` matches both `/items` and `/items/123`
+
+2. **Named Parameters**: `:param`
+   - Matches any segment in the URL and captures it as a parameter
+   - Example: `/users/:id` matches `/users/123`
+
+3. **Splat Parameters**: `*param`
+   - Matches any number of URL segments
+   - Example: `/files/*path` matches `/files/folder/subfolder/file.txt`
+
+### Examples
+
+```javascript
+const router = new Router();
+
+// Example 1: Simple route
+router.routeToRegExp('/users')
+// Matches: /users
+// Does not match: /users/123, /user
+
+// Example 2: Route with named parameter
+router.routeToRegExp('/users/:id')
+// Matches: /users/123, /users/abc
+// Does not match: /users, /users/123/edit
+
+// Example 3: Route with optional parameter
+router.routeToRegExp('/items(/:id)')
+// Matches: /items, /items/123
+// Does not match: /items/123/edit
+
+// Example 4: Route with splat parameter
+router.routeToRegExp('/files/*path')
+// Matches: /files/document.pdf, /files/images/photo.jpg
+// Matches any number of segments after /files/
+
+// Example 5: Route with query parameters
+router.routeToRegExp('/search')
+// Matches: /search, /search?q=test
+// The query parameters are captured in the regex
+```
+
+### Regular Expression Components
+
+The method uses several regex patterns to handle different URL components:
+
+1. `escapeRegExp`: `/[\-{}\[\]+?.,\\\^$|#\s]/g`
+   - Escapes special regex characters in the route
+
+2. `optionalParam`: `/\((.*?)\)/g`
+   - Matches optional parameters in parentheses
+
+3. `namedParam`: `/(\(\?)?:\w+/g`
+   - Matches named parameters starting with ':'
+
+4. `splatParam`: `/\*\w+/g`
+   - Matches splat parameters starting with '*'
+
+### Notes
+
+- The method automatically handles query strings in URLs
+- All routes are anchored to the start of the string with `^`
+- The method is case-sensitive
+- Special characters in routes should be escaped properly 

package/framework/router.js

@@ -1,6 +1,8 @@
 let Request  = require('./request.js');
 let Response = require('./response.js');
 let _ = require('underscore');
+let path = require('path');
+let fs = require('fs');
 
 class Router {
 
@@ -14,11 +16,33 @@ class Router {
 		this.defaultRoute = '';
 		this.server = server;
 		this.cwd = process.cwd();
+    this.mimes = {
+      'png': 'image/png',
+      'webp': 'image/webp',
+      'jpg': 'image/jpg',
+      'css': 'text/css',
+      'gz': 'application/x-gzip',
+      'gif': 'image/gif',
+      'js': 'text/javascript',
+      'svg': 'image/svg+xml',
+      'ttf': 'application/x-font-ttf',
+      'otf': 'application/x-font-opentype',
+      'pdf': 'application/pdf',
+      'json': 'application/json'
+    };
+    this.compressionMimes = {
+      'css': 'text/css',
+      'js': 'text/javascript',
+      'gz': 'application/x-gzip'
+    };
 	}
 
 	routeToRegExp(route) {
 
-		var optionalParam = /\((.*?)\)/g, namedParam = /(\(\?)?:\w+/g, splatParam = /\*\w+/g, escapeRegExp = /[\-{}\[\]+?.,\\\^$|#\s]/g;
+		let optionalParam = /\((.*?)\)/g, 
+      namedParam = /(\(\?)?:\w+/g, 
+      splatParam = /\*\w+/g, 
+      escapeRegExp = /[\-{}\[\]+?.,\\\^$|#\s]/g;
 		// Convert route to regular expression, this was taken from Backbone's router
 		route = route.replace(escapeRegExp, '\\$&')
 			.replace(optionalParam, '(?:$1)?')
@@ -93,21 +117,18 @@ class Router {
                 return obj.onNotFound(response);
               }
 
-              const acceptEncoding = req.headers['accept-encoding'] || '';
+              // -- const acceptEncoding = req.headers['accept-encoding'] || '';
               const fileStream = fs.createReadStream(filename);
               fileStream.on('error', (streamErr) => {
-                //console.error("❌ Error leyendo archivo:", streamErr);
+                console.error("Error reading file:", streamErr);
                 res.writeHead(500);
-                res.end('Error interno');
+                res.end('Server Error');
               });
 
               extHeader['Content-Length'] = stats.size;
               res.writeHead(200, extHeader);
               fileStream.pipe(res);
-
-              res.on('close', () => {
-                //console.log("✅ Archivo servido y cerrado:", filename);
-              });
+              res.on('close', () => {});
             });
 					}
 				}
@@ -119,7 +140,7 @@ class Router {
 	isProtectedFile(route) {
 
 		let protectedDirs = ['framework', 'external', 'node_mudules'];
-		var routeParts = route.split('/');
+		let routeParts = route.split('/');
 		if (routeParts[1] != undefined && routeParts.length > 2) {
 			return protectedDirs.includes(routeParts[1]);
 		}
@@ -128,12 +149,11 @@ class Router {
 
 	validateCallback(clazz, method) {
 
-		var obj = this, endpoints = obj.server.endpoints;
+		let obj = this, 
+      endpoints = obj.server.endpoints;
 
 		if (endpoints[clazz] != undefined) {
-
 			clazz = endpoints[clazz];
-
 			if (typeof clazz[method] === 'function') {
 				return clazz[method];
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-jet",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "VannilaJet framework",
   "main": "index.js",
   "bin": {