generate env json

Author: jjpaulino

lib/cmd/vite/scripts.js

@@ -448,6 +448,36 @@ function baseViteConfig(viteCfg) {
 
 // ── Build passes ────────────────────────────────────────────────────────────
 
+/**
+ * Return the output.manualChunks / output.experimentalMinChunkSize entry for
+ * rollupOptions.output based on whether the codebase is fully ESM.
+ *
+ * CJS mode (clientFilesESM:false): @rollup/plugin-commonjs injects \0-prefixed
+ * virtual proxy modules into the graph which inflate apparent module sizes and
+ * add phantom importer edges.  Rollup's native experimentalMinChunkSize would
+ * produce inaccurate merges in this environment.  viteManualChunksPlugin guards
+ * against virtual modules explicitly and uses info.code.length as an honest size
+ * proxy for pre-minification CJS source.
+ *
+ * ESM mode (clientFilesESM:true): the graph is clean — no proxy modules, no CJS
+ * wrapper boilerplate.  Rollup's native experimentalMinChunkSize is accurate and
+ * optimal; viteManualChunksPlugin is no longer needed.  manualChunksMinSize maps
+ * directly to the native threshold (0 = no merging if the site leaves it unset).
+ *
+ * @param {object} viteCfg
+ * @returns {object}
+ */
+function buildChunkingOutput(viteCfg) {
+  const minSize = viteCfg.manualChunksMinSize ?? 0;
+
+  if (viteCfg.clientFilesESM) {
+    return { experimentalMinChunkSize: minSize };
+  }
+
+  return { manualChunks: viteManualChunksPlugin(minSize, CWD) };
+}
+
+
 /**
  * Pass 1 — view mode (splitting pass).
  *
@@ -492,21 +522,8 @@ async function runViewBuild(viteCfg) {
       format:         'esm',
       entryFileNames: '[name]-[hash].js',
       chunkFileNames: 'chunks/[name]-[hash].js',
-      // CJS mode (clientFilesESM:false): @rollup/plugin-commonjs injects \0-prefixed
-      // virtual proxy modules into the graph which inflate apparent module sizes and
-      // add phantom importer edges.  Rollup's native experimentalMinChunkSize would
-      // produce inaccurate merges in this environment.  viteManualChunksPlugin guards
-      // against virtual modules explicitly and uses info.code.length as a honest size
-      // proxy for pre-minification CJS source.
-      //
-      // ESM mode (clientFilesESM:true): the graph is clean — no proxy modules, no CJS
-      // wrapper boilerplate.  Rollup's native experimentalMinChunkSize is accurate and
-      // optimal; viteManualChunksPlugin is no longer needed.  manualChunksMinSize maps
-      // directly to the native threshold (0 = no merging if the site leaves it unset).
-      ...(viteCfg.clientFilesESM
-        ? { experimentalMinChunkSize: viteCfg.manualChunksMinSize ?? 0 }
-        : { manualChunks: viteManualChunksPlugin(viteCfg.manualChunksMinSize ?? 0, CWD) }
-      ),
+      // See buildChunkingOutput() for CJS vs ESM branching rationale.
+      ...buildChunkingOutput(viteCfg),
     },
     onwarn: suppressWarning,
   };
@@ -650,6 +667,56 @@ async function buildJS(options = {}) {
 
 exports.buildJS = buildJS;
 
+// ── Client env ──────────────────────────────────────────────────────────────
+
+/**
+ * Scan source JS/Vue files for `process.env.VAR_NAME` references and write
+ * `client-env.json` — an array of unique env var names.
+ *
+ * amphora-html's `addEnvVars()` call in renderers.js reads this file at server
+ * startup to know which `process.env` values need to be forwarded to the
+ * browser.  Without it the server never exposes those values and client-side
+ * code that reads `process.env.FOO` gets undefined at runtime.
+ *
+ * @returns {Promise<string[]>} sorted list of env var names written
+ */
+async function generateClientEnv() {
+  const SOURCE_GLOBS = [
+    path.join(CWD, 'components', '**', '*.js'),
+    path.join(CWD, 'layouts', '**', '*.js'),
+    path.join(CWD, 'services', '**', '*.js'),
+    path.join(CWD, 'global', '**', '*.js'),
+    path.join(CWD, 'amphora', '**', '*.js'),
+    path.join(CWD, 'app.js'),
+    path.join(CWD, 'components', '**', '*.vue'),
+    path.join(CWD, 'layouts', '**', '*.vue'),
+  ];
+
+  const files = globSync(SOURCE_GLOBS, { nodir: true });
+  const found = new Set();
+  const ENV_VAR_RE = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
+
+  for (const file of files) {
+    let src;
+
+    try {
+      src = await fs.readFile(file, 'utf8');
+    } catch (e) {
+      continue;
+    }
+
+    for (const match of src.matchAll(ENV_VAR_RE)) {
+      found.add(match[1]);
+    }
+  }
+
+  const vars = [...found].sort();
+
+  await fs.outputJson(path.join(CWD, 'client-env.json'), vars, { spaces: 2 });
+
+  return vars;
+}
+
 // ── Full build (JS + assets in parallel) ────────────────────────────────────
 
 /**
@@ -742,11 +809,12 @@ async function buildAll(options = {}) {
   }
 
   await Promise.all([
-    step('js',        () => buildJS(options)),
-    step('styles',    () => buildStyles(options)),
-    step('fonts',     () => buildFonts()),
-    step('templates', () => buildTemplates(options)),
-    step('vendor',    () => copyVendor()),
+    step('js',         () => buildJS(options)),
+    step('styles',     () => buildStyles(options)),
+    step('fonts',      () => buildFonts()),
+    step('templates',  () => buildTemplates(options)),
+    step('vendor',     () => copyVendor()),
+    step('client-env', () => generateClientEnv()),
   ]);
 
   if (timer) { clearInterval(timer); timer = null; }
@@ -852,11 +920,8 @@ async function watch(options = {}) {
       format:         'esm',
       entryFileNames: '[name]-[hash].js',
       chunkFileNames: 'chunks/[name]-[hash].js',
-      // Same CJS/ESM branching as runViewBuild — see that function for full rationale.
-      ...(viteCfg.clientFilesESM
-        ? { experimentalMinChunkSize: viteCfg.manualChunksMinSize ?? 0 }
-        : { manualChunks: viteManualChunksPlugin(viteCfg.manualChunksMinSize ?? 0, CWD) }
-      ),
+      // See buildChunkingOutput() for CJS vs ESM branching rationale.
+      ...buildChunkingOutput(viteCfg),
     },
     onwarn: suppressWarning,
     watch: {