vanilla-jet 1.4.1 → 1.4.3

package/.scripts/generate_packages_json.js

@@ -41,7 +41,6 @@ async function createFileIfnotExists(content) {
 // -- Helpers
 function processCwd() {
     return process.cwd()
-        .replace('/.grunt', '')
         .replace('/.scripts', '');
 }
 

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable project changes are documented in this file.
 
 The format follows a structure inspired by Keep a Changelog and semantic versioning.
 
+## [1.4.3] - 2026-02-19
+
+### Removed
+
+- Grunt build artifacts: removed `.grunt/` folder, `build_styles_task.js`, and `compile_html.js`.
+- Build pipeline now uses only Gulp; template compilation moved to `scripts/compile_html.js`.
+
+### Changed
+
+- `gulpfile.js`: `compileTemplates` now invokes `node scripts/compile_html.js` instead of `.grunt/compile_html.js`.
+- `framework/dipper.js`, `.scripts/generate_packages_json.js`: removed `.grunt` references from `processCwd` helpers.
+
+### Fixed
+
+- **Reliability under rapid reloads (F5)**: server no longer stops responding after repeated refreshes.
+  - Removed `fs.watch` per static file (`staticFileWatchers`); could exhaust resources with prolonged use.
+  - Added fallback to `404` for routes without a handled static extension (avoids hanging requests).
+  - Destroy file streams when client disconnects (`res.on('close')`) to avoid orphaned streams.
+  - Applied same stream cleanup in `response.render()` for HTML template delivery.
+- Added defensive server timeouts: `requestTimeout`, `headersTimeout`, `keepAliveTimeout` (configurable via `settings.profile`).
+
+### Compatibility notes
+
+- No public API changes.
+- Build output and route behavior unchanged; only internal reliability improvements.
+
+## [1.4.2] - 2026-02-19
+
+### Changed
+
+- Version bump to 1.4.2.
+
 ## [1.4.1] - 2026-02-19
 
 ### Highlights (v1.4.1)
@@ -11,9 +43,11 @@ The format follows a structure inspired by Keep a Changelog and semantic version
 - Completed HU 2.1 (`Fast path de estaticos en Node`).
 - Optimized static serving in `framework/router.js`:
   - Added warm-path static resolution cache (`route + accept-encoding`) to avoid repeated candidate resolution work.
-  - Added bounded metadata revalidation window for conditional requests to reduce repeated `fs.stat` pressure.
+  - Keeps strict conditional metadata revalidation so content changes are visible on reload without stale `304`.
   - Consolidated static header assembly and reused mime header maps.
   - Kept stream-based delivery for large assets and tuned `createReadStream` chunk size.
+- Added asset URL versioning in `framework/dipper.js` (`?v=size-mtime`) for local scripts/styles.
+- Updated `gulp dev` watch flow so JS/CSS recompiles also trigger template compilation and refresh asset URLs in HTML.
 - Added reproducible local benchmark:
   - New script: `npm run benchmark:static`.
   - New guide: `docs/benchmark-static.md`.
@@ -103,4 +137,6 @@ The format follows a structure inspired by Keep a Changelog and semantic version
 [1.3.4]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.3.4
 [1.3.5]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.3.5
 [1.3.6]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.3.6
+[1.4.2]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.4.2
+[1.4.3]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.4.3
 [1.4.1]: https://github.com/nalancer08/VanillaJet/releases/tag/v1.4.1

package/README.md

@@ -6,7 +6,7 @@ Node.js framework for building SPA applications with a JS/CSS/HTML build pipelin
 
 ## Current version
 
-- Version: `1.4.1`
+- Version: `1.4.3`
 - Changelog: see [`CHANGELOG.md`](./CHANGELOG.md)
 - Improvement plan (performance and backward compatibility): see `ROADMAP_INTEGRAL.md`
 
@@ -93,6 +93,8 @@ VanillaJet expects a structure similar to:
 
 ## Build pipeline (summary)
 
+Gulp-based pipeline (no Grunt):
+
 - Minifies JS and concatenates into `public/scripts/vanilla.min.js`
 - Compiles LESS and generates `public/styles/app.min.css`
 - Compiles templates and generates `public/pages/home.html`
@@ -125,7 +127,7 @@ Behavior details:
 Static serving includes a warm-path optimization focused on Node runtime latency:
 
 - Reuses static resolution for repeated requests (`route + accept-encoding`).
-- Reduces repeated metadata refresh with bounded revalidation windows.
+- Keeps conditional revalidation (`ETag`/`Last-Modified`) strict so reload reflects changes immediately.
 - Keeps streaming strategy for large assets (`fs.createReadStream`) with tuned chunk size.
 - Preserves conditional cache behavior (`ETag`/`Last-Modified` + `304`) and precompressed fallback contract.
 

package/ROADMAP_INTEGRAL.md

@@ -117,7 +117,7 @@ Cada historia incluye su ciclo completo: fases, tareas, entregables, metricas, c
 
 ## EPIC 2 - Performance Node + DX de compilacion (foco actual)
 
-### HU 2.1 - Fast path de estaticos en Node (completada `v1.4.1`)
+### HU 2.1 - Fast path de estaticos en Node (completada `v1.4.2`)
 
 #### Fases
 - F1: profiling de request estatico.

package/framework/dipper.js

@@ -93,12 +93,12 @@ Dipper.prototype.img = function(filename) {
 
 Dipper.prototype.script = function(filename) {
 	let dir = this.getDir('scripts', false);
-	return this.urlTo(dir + filename);
+	return this.versionedUrl(dir + filename);
 }
 
 Dipper.prototype.style = function(filename) {
 	let dir = this.getDir('styles', false);
-	return this.urlTo(dir + filename);;
+	return this.versionedUrl(dir + filename);;
 }
 
 Dipper.prototype.pdf = function(filename) {
@@ -128,6 +128,36 @@ Dipper.prototype.urlTo = function (route) {
   return '/' + route.replace(/^\/+/, '');
 };
 
+Dipper.prototype.versionedUrl = function(route) {
+	const fs = require('fs');
+	const path = require('path');
+	const normalizedUrl = this.urlTo(route);
+
+	// External URLs should remain untouched.
+	if (/^(?:[a-z][a-z0-9+.-]*:)?\/\//i.test(normalizedUrl)) {
+		return normalizedUrl;
+	}
+
+	try {
+		const filePath = path.join(this.processCwd(), normalizedUrl.replace(/^\//, ''));
+		const stats = fs.statSync(filePath);
+		if (!stats.isFile()) {
+			return normalizedUrl;
+		}
+
+		const version = `${stats.size}-${Math.floor(stats.mtimeMs)}`;
+		return this.appendQueryParam(normalizedUrl, 'v', version);
+	} catch (err) {
+		// If file does not exist yet, keep legacy behavior.
+		return normalizedUrl;
+	}
+}
+
+Dipper.prototype.appendQueryParam = function(url, key, value) {
+	const separator = url.includes('?') ? '&' : '?';
+	return `${url}${separator}${key}=${encodeURIComponent(value)}`;
+}
+
 Dipper.prototype.registerStyle = function(
 	name, url, requires,
 	cdn = false, async = false,
@@ -515,7 +545,6 @@ Dipper.prototype.includeEnvironment = function() {
 Dipper.prototype.processCwd = function() {
 
 	let cwd = process.cwd()
-		.replace('/.grunt', '')
 		.replace('/.scripts', '')
 		.replace('/node_modules', '')
 		.replace('/vanilla-jet', '');

package/framework/response.js

@@ -111,6 +111,11 @@ class Response {
       fileStream.on('error', () => {
         obj.error404();
       });
+      obj.res.on('close', () => {
+        if (!obj.res.writableEnded) {
+          fileStream.destroy();
+        }
+      });
       fileStream.pipe(obj.res);
     });
 	}

package/framework/router.js

@@ -19,8 +19,6 @@ class Router {
     this.staticBasePath = this.cwd.replace('core/framework', '');
     this.staticMetadataCache = new Map();
     this.staticResolutionCache = new Map();
-    this.staticFileWatchers = new Map();
-    this.staticMetadataMaxAgeMs = 1000;
     this.staticStreamChunkSize = 128 * 1024;
     this.mimes = {
       'png': 'image/png',
@@ -150,12 +148,18 @@ class Router {
                 res.writeHead(500);
                 res.end('Server Error');
               });
+              res.on('close', () => {
+                if (!res.writableEnded) {
+                  fileStream.destroy();
+                }
+              });
 
               res.writeHead(200, staticHeaders);
               fileStream.pipe(res);
-              res.on('close', () => {});
             });
-					}
+					} else {
+            return obj.onNotFound(response);
+          }
 				}
 			}
 		}), handled = false;
@@ -170,10 +174,6 @@ class Router {
       return callback(null, cachedMetadata);
     }
 
-    if (cachedMetadata && forceRefresh && !obj.shouldRefreshConditionalMetadata(cachedMetadata)) {
-      return callback(null, cachedMetadata);
-    }
-
     fs.stat(filename, (err, stats) => {
       if (err || !stats.isFile()) {
         return callback(err || new Error('File not found'));
@@ -182,12 +182,10 @@ class Router {
       let metadata = {
         size: stats.size,
         lastModified: stats.mtime.toUTCString(),
-        etag: `W/"${stats.size}-${Math.floor(stats.mtimeMs)}"`,
-        cachedAt: Date.now()
+        etag: `W/"${stats.size}-${Math.floor(stats.mtimeMs)}"`
       };
 
       obj.staticMetadataCache.set(filename, metadata);
-      obj.watchStaticFile(filename);
       callback(null, metadata);
     });
   }
@@ -268,13 +266,6 @@ class Router {
     return `${route}|${normalizedEncodings}`;
   }
 
-  shouldRefreshConditionalMetadata(metadata) {
-    if (!metadata || !metadata.cachedAt) {
-      return true;
-    }
-    return Date.now() - metadata.cachedAt > this.staticMetadataMaxAgeMs;
-  }
-
   buildStaticHeaders(extHeader, candidates, contentEncoding, metadata) {
     let staticHeaders = Object.assign({}, extHeader);
     if (contentEncoding) {
@@ -323,41 +314,6 @@ class Router {
     });
   }
 
-  watchStaticFile(filename) {
-    let obj = this;
-    if (obj.staticFileWatchers.has(filename)) {
-      return;
-    }
-
-    try {
-      let watcher = fs.watch(filename, (eventType) => {
-        obj.staticMetadataCache.delete(filename);
-        obj.staticResolutionCache.clear();
-        if (eventType === 'rename') {
-          let renamedWatcher = obj.staticFileWatchers.get(filename);
-          if (renamedWatcher) {
-            renamedWatcher.close();
-          }
-          obj.staticFileWatchers.delete(filename);
-        }
-      });
-
-      watcher.on('error', () => {
-        obj.staticMetadataCache.delete(filename);
-        obj.staticResolutionCache.clear();
-        let activeWatcher = obj.staticFileWatchers.get(filename);
-        if (activeWatcher) {
-          activeWatcher.close();
-        }
-        obj.staticFileWatchers.delete(filename);
-      });
-
-      obj.staticFileWatchers.set(filename, watcher);
-    } catch (err) {
-      // If watch cannot be created, keep runtime behavior and continue.
-    }
-  }
-
   isNotModified(req, metadata) {
     let ifNoneMatch = req.headers['if-none-match'];
     if (ifNoneMatch) {

package/framework/server.js

@@ -32,7 +32,10 @@ class Server {
 		_.defaults(opts, {
 			https_server: false,
 			wsServer: false,
-      enable_precompressed_negotiation: false
+      enable_precompressed_negotiation: false,
+      request_timeout_ms: 30000,
+      headers_timeout_ms: 35000,
+      keep_alive_timeout_ms: 5000
 		});
 		obj.options = opts;
 
@@ -91,6 +94,9 @@ class Server {
     }
 
     // -- Set the port
+    obj.httpx.requestTimeout = Number(obj.options.request_timeout_ms) || 30000;
+    obj.httpx.headersTimeout = Number(obj.options.headers_timeout_ms) || 35000;
+    obj.httpx.keepAliveTimeout = Number(obj.options.keep_alive_timeout_ms) || 5000;
     obj.httpx.listen(obj.options.port || 8080);
   }
 

package/gulpfile.js

@@ -113,7 +113,7 @@ function compressCss() {
 // Template compilation
 function compileTemplates() {
   return gulp.src('.')
-    .pipe(shell([`node .grunt/compile_html.js`]));
+    .pipe(shell([`node scripts/compile_html.js`]));
 }
 
 // Watch task
@@ -123,7 +123,8 @@ function watchFiles(cb) {
   // Watch LESS files
   watch([`${base}/assets/styles/less/**/*.less`], gulp.series(
     buildLess,
-    compressCss
+    compressCss,
+    compileTemplates
   ));
 
   // Watch HTML files
@@ -138,7 +139,8 @@ function watchFiles(cb) {
     uglifyJs,
     concatJs,
     cleanMinified,
-    compressJs
+    compressJs,
+    compileTemplates
   ));
   
   cb();

package/package.json

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

package/{.grunt → scripts}/compile_html.js

@@ -2,7 +2,6 @@
 const path = require("path"),
 	fs = require("fs"),
 	nunjucks = require('nunjucks'),
-  identifier = 'templates',
   chalk = require('chalk'),
   zlib = require('zlib');
 
@@ -43,9 +42,11 @@ function main() {
   // -- Get home.html
   let homePageName = 'home.html';
   getHtmlFromPage(homePageName).then((htmlContent) => {
-    if (htmlContent) {
+    if (htmlContent) {      
+      // -- Compile the htmlContent
+      const compiledHtmlContent = compileTemplate(htmlContent);
       // -- Divide content line by line
-      const htmlContentLines = htmlContent.split('\n');
+      const htmlContentLines = compiledHtmlContent.split('\n');
       let lines = Array.from(htmlContentLines);
       // -- Iterate over each line
       for (let line of htmlContentLines) {
@@ -58,7 +59,7 @@ function main() {
           // -- Get template name
           var templateName = line.replace('include::', '');
           // -- Check if its name "templates" add all templates if not add specific one
-          if (templateName === identifier) {
+          if (templateName === 'templates') {
 
             let allTemplatesCompiled = '';
             for (let templateName in templates) {
@@ -211,7 +212,7 @@ function cleanALine(line) {
 
 function processCwd() {
   return process.cwd()
-    .replace('/.grunt', '')
+    .replace('/scripts', '')
     .replace('/gulp', '')
     .replace('/node_modules/vanilla-jet', '');
-}
+}

package/.grunt/build_styles_task.js

@@ -1,30 +0,0 @@
-module.exports = function(grunt) {
-    grunt.registerTask('buildLess', 'Compile admin.less and add .section.less', function() {
-
-        // -- Functions
-        function getCleanedCWD() {
-            const cwd = process.cwd();
-            return cwd
-                .replace('/node_modules', '')
-                .replace('/vanilla-jet', '')
-                .replace('/.grunt', '');
-        }
-
-        // -- Content
-        let adminContent = grunt.file.read(`${getCleanedCWD()}/assets/styles/less/admin.less`);
-        let sectionFiles = grunt.file.expand([
-            `${getCleanedCWD()}/assets/styles/less/sections/**/*.section.less`,
-            `${getCleanedCWD()}/assets/styles/less/sections/*.section.less`
-        ]);
-        
-        let combinedContent = adminContent + '\n';
-        sectionFiles.forEach(function(filePath) {
-            let sectionContent = grunt.file.read(filePath);
-            combinedContent += `\n/* ${filePath} */\n` + sectionContent;
-        });
- 
-       // -- New file
-       grunt.file.write(`${getCleanedCWD()}/assets/styles/less/admin_build.less`, combinedContent);
-       grunt.task.run(['less']);
-    });
- };