vanilla-jet 1.4.1 → 1.4.2

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable project changes are documented in this file.
 
 The format follows a structure inspired by Keep a Changelog and semantic versioning.
 
+## [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 +17,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 +111,5 @@ 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.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.2`
 - Changelog: see [`CHANGELOG.md`](./CHANGELOG.md)
 - Improvement plan (performance and backward compatibility): see `ROADMAP_INTEGRAL.md`
 
@@ -125,7 +125,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,

package/framework/router.js

@@ -20,7 +20,6 @@ class Router {
     this.staticMetadataCache = new Map();
     this.staticResolutionCache = new Map();
     this.staticFileWatchers = new Map();
-    this.staticMetadataMaxAgeMs = 1000;
     this.staticStreamChunkSize = 128 * 1024;
     this.mimes = {
       'png': 'image/png',
@@ -170,10 +169,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,8 +177,7 @@ 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);
@@ -268,13 +262,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) {

package/gulpfile.js

@@ -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.2",
   "description": "VannilaJet framework",
   "main": "index.js",
   "bin": {