@videinfra/static-website-builder 2.0.2 → 2.0.3

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [2.0.3] - 2026-02-03
+### Added
+- Allow writing ASSETS_VERSION to .env file
+
 ## [2.0.0] - 2026-01-27
 ### Added
 - Replaced webpack with rolldown

package/init/test/.env.local

@@ -1,2 +1,3 @@
 HOST=https://test-local.tld
 BAR=bar-local
+ASSETS_VERSION=12345678

package/init/test/config/config.js

@@ -41,6 +41,10 @@ export const plugins = [
 ];
 
 export const env = {
+    // Write ASSET_VERSION to .env file to enable cache busting
+    // writeAssetVersion: './init/test/.env.local',
+
+    // How env variable names should be remapped
     map: {
         'HOST': 'host',
         'FOO': 'foo',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@videinfra/static-website-builder",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Customizable static site project builder",
   "license": "MIT",
   "engines": {
@@ -22,7 +22,7 @@
   "scripts": {
     "start": "cross-env BUILDER_MODE=development gulp watch",
     "build": "cross-env BUILDER_MODE=production gulp build",
-    "test": "gulp build --silent --config=init/test/config/config.js && node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test": "gulp build --silent --config=init/test/config/config.js && node --disable-warning=ExperimentalWarning --experimental-vm-modules node_modules/jest/bin/jest.js",
     "test-watch": "gulp watch --config=init/test/config/config.js",
     "test-builder": "node bin/builder.js build --config=init/test/config/config.js"
   },

package/tasks/env/config.js

@@ -8,6 +8,9 @@
  */
 
 export const env = {
+    // Write ASSET_VERSION to .env file to enable cache busting
+    writeAssetVersion: false,
+
     // How env variable names should be remapped
     // Example:
     //     map: { 'HOST': 'host', 'RECAPTCHA3_PUBLIC_KEY': 'recaptcha3_site_key' }

package/tasks/env/get-env.js

@@ -1,3 +1,4 @@
+import fs from 'node:fs';
 import dotenv from 'dotenv';
 import nanomemoize from 'nano-memoize';
 import { getPathConfig, getProjectPath } from '../../lib/get-path.js';
@@ -24,6 +25,32 @@ function normalizeTwigVariable(value) {
     }
 }
 
+/**
+ * Write asset version to the env file
+ * @param {string} assetVersion Asset version string
+ */
+function writeEnvFileAssetVersion(assetVersion) {
+    const envFilePath = getTaskConfig('env', 'writeAssetVersion');
+    if (envFilePath) {
+        const envFile = getProjectPath(envFilePath);
+
+        try {
+            let envContent = fs.readFileSync(envFile, 'utf8');
+
+            // Replace ASSETS_VERSION if it exists
+            if (envContent.includes('ASSETS_VERSION=')) {
+                envContent = envContent.replace(/ASSETS_VERSION=.*/, `ASSETS_VERSION=${assetVersion}`);
+            } else {
+                envContent += `\nASSETS_VERSION=${assetVersion}`;
+            }
+
+            fs.writeFileSync(envFile, envContent);
+        } catch (error) {
+            console.error(`Error writing env file "${envFile}"`, error);
+        }
+    }
+}
+
 /**
  * Load data from the .env files
  * @returns {object} List of environment variables
@@ -41,7 +68,10 @@ export const loadEnvData = nanomemoize.nanomemoize(function () {
     });
 
     // Set assets version if it doesn't exist
-    envVariables['ASSETS_VERSION'] = envVariables['ASSETS_VERSION'] || String(Math.floor(Date.now() / 1000));
+    if (!envVariables['ASSETS_VERSION'] || getTaskConfig('env', 'writeAssetVersion')) {
+        envVariables['ASSETS_VERSION'] = String(Math.floor(Date.now() / 1000));
+        writeEnvFileAssetVersion(envVariables['ASSETS_VERSION']);
+    }
 
     return envVariables;
 });
@@ -50,7 +80,7 @@ export const loadEnvData = nanomemoize.nanomemoize(function () {
  * Returns environment variables mapped to the specified names
  * @returns {object} Mapped environment variables
  */
-export default function getEnvData() {
+const getEnvData = nanomemoize.nanomemoize(function () {
     const envVariables = loadEnvData();
     const twigVariables = {};
     const scssVariables = { env: { _tmp: 1 } }; // _tmp is used to avoid SCSS error if object is empty
@@ -78,4 +108,6 @@ export default function getEnvData() {
         js: jsVariables,
         env: envOutVariables,
     };
-}
+});
+
+export default getEnvData;