@videinfra/static-website-builder 2.3.2 → 2.4.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.4.1] - 2026-04-23
+### Added
+- Allow to specify additional static data for env variables in task config
+
+## [2.4.0] - 2026-04-23
+### Added
+- Allow to specify builder config file path using `BUILDER_CONFIG_FILE` env variable
+
 ## [2.3.2] - 2026-04-13
 ### Fixed
 - Translation error output

package/gulpfile.js

@@ -1,5 +1,7 @@
 import { getConfigAsync } from './lib/get-config.js';
 import generateGulpTasks from './lib/generate-gulp-tasks.js';
+import { getProjectPath } from './lib/get-path.js';
+import dotenv from 'dotenv';
 
 // Set mode globally it can be used by tasks
 let hasProductionArg = false;
@@ -15,9 +17,27 @@ for (let i = 0; i < process.argv.length; i++) {
 global.production = global.production || hasProductionArg || process.env.NODE_ENV === 'production';
 global.development = !global.production;
 
-// Config file
-let builderConfigFile = process.env.BUILDER_CONFIG_FILE || 'config/config.js';
+// Load environment variables from .env files
+let builderConfigFile = 'config/config.js';
+
+if (process.env.BUILDER_CONFIG_FILE) {
+    builderConfigFile = process.env.BUILDER_CONFIG_FILE;
+} else {
+    const envVariables = {};
+    dotenv.config({
+        // dotenv file order is reversed, values in first file overwrite all other
+        // file values
+        path: ['../.env', '../.env.local'].map((path) => getProjectPath(path)).reverse(),
+        processEnv: envVariables,
+        quiet: true,
+    });
+
+    if (envVariables.BUILDER_CONFIG_FILE) {
+        builderConfigFile = envVariables.BUILDER_CONFIG_FILE;
+    }
+}
 
+// Config file
 if (process.argv.indexOf('--config') !== -1) {
     builderConfigFile = process.argv[process.argv.indexOf('--config') + 1];
 } else {

package/init/test/config/config.js

@@ -67,6 +67,11 @@ export const env = {
         'TYPE_EMPTY': 'typeEmpty',
         'NON_EXISTING': 'nonExisting',
     },
+
+    // Additional env variables
+    data: {
+        'baz': 'bazValue',
+    },
 };
 
 export const translations = {

package/init/test/src/javascripts/main.js

@@ -3,6 +3,7 @@ console.log('Hello from main page!');
 console.log('env.host ==', process.env.host);
 console.log('env.foo ==', process.env.foo);
 console.log('env.bar ==', process.env.bar);
+console.log('env.baz ==', process.env.baz);
 console.log('env.typeBoolTrue ==', process.env.typeBoolTrue);
 console.log('env.typeBoolFalse ==', process.env.typeBoolFalse);
 console.log('env.typeNumber ==', process.env.typeNumber);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@videinfra/static-website-builder",
-  "version": "2.3.2",
+  "version": "2.4.1",
   "description": "Customizable static site project builder",
   "license": "MIT",
   "engines": {

package/tasks/env/config.js

@@ -14,7 +14,10 @@ export const env = {
     // How env variable names should be remapped
     // Example:
     //     map: { 'HOST': 'host', 'RECAPTCHA3_PUBLIC_KEY': 'recaptcha3_site_key' }
-    map: {}
+    map: {},
+
+    // Additional data to add to env variables
+    data: {},
 };
 
 export const paths = {

package/tasks/env/get-env.js

@@ -88,16 +88,26 @@ const getEnvData = nanomemoize.nanomemoize(function () {
     const envOutVariables = {};
 
     // Remap property names
-    const map = getTaskConfig('env', 'map');
+    const map = getTaskConfig('env', 'map') || {};
 
     Object.keys(map).forEach((key) => {
         const value = key in envVariables ? envVariables[key] : '';
-        const camelCase = map[key];
-        const kebabCase = map[key];
-        twigVariables[camelCase] = normalizeTwigVariable(value);
-        envOutVariables[camelCase] = value;
-        jsVariables[`process.env.${camelCase}`] = escapeJSVariable(value);
-        scssVariables.env[kebabCase] = value;
+        const mappedKey = map[key];
+        twigVariables[mappedKey] = normalizeTwigVariable(value);
+        envOutVariables[mappedKey] = value;
+        jsVariables[`process.env.${mappedKey}`] = escapeJSVariable(value);
+        scssVariables.env[mappedKey] = value;
+    });
+
+    // Add additional data
+    const data = getTaskConfig('env', 'data') || {};
+
+    Object.keys(data).forEach((key) => {
+        const value = data[key];
+        twigVariables[key] = normalizeTwigVariable(value);
+        envOutVariables[key] = value;
+        jsVariables[`process.env.${key}`] = escapeJSVariable(value);
+        scssVariables.env[key] = value;
     });
 
     return {

package/tests/build/env.test.js

@@ -34,6 +34,14 @@ test('.env and .env.local files loaded', () => {
     ]);
 });
 
+test('Additional ENV data is set', () => {
+    return Promise.all([
+        fsPromises.readFile(path.resolve(publicPath, 'assets/javascripts/main.js'), { encoding: 'utf8' }).then((js) => {
+            expect(js.indexOf('console.log(`env.baz ==`,`bazValue`)')).not.toBe(-1);
+        }),
+    ]);
+});
+
 test('process.env available in html/data', () => {
     return fsPromises.readFile(path.resolve(publicPath, 'env.html'), { encoding: 'utf8' }).then((html) => {
         expect(html.indexOf('<p>HOST FROM GLOBAL JS: https://test-local.tld</p>')).not.toBe(-1);