vike 0.4.163-commit-407cb5c → 0.4.164

package/dist/cjs/__internal/index.js

@@ -13,7 +13,7 @@ const renderPageAlreadyRouted_js_1 = require("../node/runtime/renderPage/renderP
  * @param config
  */
 async function getPagesAndRoutes() {
-    (0, assertNodeEnv_js_1.setNodeEnvToProduction)();
+    (0, assertNodeEnv_js_1.handleNodeEnv_vitePluginVercel)();
     await (0, globalContext_js_1.initGlobalContext)(true);
     const globalContext = (0, globalContext_js_1.getGlobalContext)();
     (0, assert_js_1.assert)(globalContext.isProduction === true);

package/dist/cjs/node/plugin/index.js

@@ -27,7 +27,7 @@ const baseUrls_js_1 = require("./plugins/baseUrls.js");
 const envVars_js_1 = require("./plugins/envVars.js");
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
 const fileEnv_js_1 = require("./plugins/fileEnv.js");
-assertNodeEnv();
+(0, utils_js_2.assertNodeEnv_onVikePluginLoad)();
 (0, utils_js_2.markEnvAsVikePluginLoaded)();
 // Return as `any` to avoid Plugin type mismatches when there are multiple Vite versions installed
 function plugin(vikeConfig) {
@@ -69,21 +69,3 @@ Object.defineProperty(plugin, 'apply', {
         (0, utils_js_2.assertUsage)(false, `Add ${picocolors_1.default.cyan('vike()')} instead of ${picocolors_1.default.cyan('vike')} to vite.config.js#plugins (i.e. call the function and add the return value instead of adding the function itself)`, { showStackTrace: true });
     }
 });
-function assertNodeEnv() {
-    const nodeEnv = (0, utils_js_2.getNodeEnv)();
-    if (nodeEnv === 'test')
-        return;
-    // We should change this to be a warning if it blocks users (e.g. if a bad-citizen tool sets a wrong process.env.NODE_ENV value).
-    (0, utils_js_2.assertUsage)(
-    /* We can enable this assertion after Vike's CLI is implemented and using Vite's CLI is deprecated (we can then check whether the context is a `$ vike build`).
-    isNodeEnvDev() || isVikeCliBuild(),
-    /*/
-    (0, utils_js_2.isNodeEnvDev)() || true, 
-    ///*/
-    [
-        picocolors_1.default.cyan(`process.env.NODE_ENV === ${JSON.stringify(nodeEnv)}`),
-        '(which Vike interprets as a non-development environment https://vike.dev/NODE_ENV)',
-        'while the vike/plugin module is loaded.',
-        utils_js_2.vikeVitePluginLoadedInProductionError
-    ].join(' '));
-}

package/dist/cjs/node/plugin/plugins/buildConfig/fixServerAssets.js

@@ -45,9 +45,9 @@ async function copyAssets(filesToCopy, config) {
     const { outDirClient, outDirServer } = (0, utils_js_1.getOutDirs)(config);
     const assetsDir = (0, getAssetsDir_js_1.getAssetsDir)(config);
     const assetsDirServer = path_1.default.posix.join(outDirServer, assetsDir);
-    (0, utils_js_1.assert)((0, fs_1.existsSync)(assetsDirServer));
     if (!filesToCopy.length)
         return;
+    (0, utils_js_1.assert)((0, fs_1.existsSync)(assetsDirServer));
     const concurrencyLimit = (0, utils_js_1.pLimit)(10);
     await Promise.all(filesToCopy.map((file) => concurrencyLimit(() => promises_1.default.cp(path_1.default.posix.join(outDirServer, file), path_1.default.posix.join(outDirClient, file), {
         recursive: true

package/dist/cjs/node/plugin/plugins/buildConfig.js

@@ -36,7 +36,7 @@ function buildConfig() {
             order: 'post',
             async handler(config_) {
                 config = config_;
-                assertNodeEnv();
+                (0, utils_js_1.assertNodeEnv_build)();
                 assertRollupInput(config);
                 const entries = await getEntries(config);
                 (0, utils_js_1.assert)(Object.keys(entries).length > 0);
@@ -55,7 +55,7 @@ function buildConfig() {
             }
         },
         config(config) {
-            assertNodeEnv();
+            (0, utils_js_1.assertNodeEnv_build)();
             isSsrBuild = (0, utils_js_1.viteIsSSR)(config);
             return {
                 build: {
@@ -66,7 +66,7 @@ function buildConfig() {
             };
         },
         buildStart() {
-            assertNodeEnv();
+            (0, utils_js_1.assertNodeEnv_build)();
         },
         writeBundle: {
             order: 'post',
@@ -260,6 +260,3 @@ function assertRollupInput(config) {
     (0, utils_js_1.assertUsage)(htmlInput === undefined, `The entry ${htmlInput} of config build.rollupOptions.input is an HTML entry which is forbidden when using Vike, instead follow https://vike.dev/add`);
 }
 exports.assertRollupInput = assertRollupInput;
-function assertNodeEnv() {
-    (0, utils_js_1.assertNodeEnvIsNotDev)('building');
-}

package/dist/cjs/node/prerender/runPrerender.js

@@ -87,7 +87,7 @@ async function runPrerender(options, manuallyTriggered) {
     if (logLevel === 'info') {
         console.log(`${picocolors_1.default.cyan(`vike v${utils_js_1.projectInfo.projectVersion}`)} ${picocolors_1.default.green('pre-rendering HTML...')}`);
     }
-    handleNodeEnv();
+    (0, utils_js_1.handleNodeEnv_prerender)();
     await disableReactStreaming();
     const viteConfig = await (0, vite_1.resolveConfig)(options.viteConfig || {}, 'vike pre-rendering', 'production');
     (0, globalContext_js_1.setGlobalContext_prerender)(viteConfig);
@@ -743,10 +743,3 @@ function assertIsNotAbort(err, urlOr404) {
     (0, utils_js_1.assert)(abortCall);
     (0, utils_js_1.assertUsage)(false, `${picocolors_1.default.cyan(abortCall)} thrown${thrownBy} while pre-rendering ${urlOr404} but ${picocolors_1.default.cyan(abortCaller)} isn't supported for pre-rendered pages`);
 }
-function handleNodeEnv() {
-    const assertNodeEnv = () => (0, utils_js_1.assertNodeEnvIsNotDev)('pre-rendering');
-    if ((0, utils_js_1.getNodeEnv)())
-        assertNodeEnv();
-    (0, utils_js_1.setNodeEnvToProduction)();
-    assertNodeEnv();
-}

package/dist/cjs/node/runtime/globalContext.js

@@ -85,7 +85,7 @@ async function initGlobalContext(isPrerendering = false, outDir) {
     if (globalObject.globalContext)
         return;
     const { viteDevServer, viteConfig } = globalObject;
-    assertNodeEnv(!!viteDevServer);
+    (0, utils_js_1.assertNodeEnv_runtime)(!!viteDevServer);
     const isProduction = !viteDevServer;
     if (!isProduction) {
         (0, utils_js_1.assert)(viteConfig);
@@ -183,15 +183,3 @@ function assertViteManifest(manifest) {
       })
     */
 }
-function assertNodeEnv(hasViteDevServer) {
-    const nodeEnv = (0, utils_js_1.getNodeEnv)();
-    if (nodeEnv === null || nodeEnv === 'test')
-        return;
-    const isDev = (0, utils_js_1.isNodeEnvDev)();
-    // Calling Vite's createServer() is enough for hasViteDevServer to be true, even without actually adding Vite's development middleware to the server: https://github.com/vikejs/vike/issues/792#issuecomment-1516830759
-    if (hasViteDevServer === isDev)
-        return;
-    const nodeEnvDesc = (0, utils_js_1.getNodeEnvDesc)();
-    // We should change this to be a warning if it blocks users (e.g. if a bad-citizen tool sets a wrong process.env.NODE_ENV value)
-    (0, utils_js_1.assertUsage)(false, `Vite's development server was${hasViteDevServer ? '' : "n't"} instantiated while the ${nodeEnvDesc} which is contradictory, see https://vike.dev/NODE_ENV`);
-}

package/dist/cjs/utils/assertNodeEnv.js

@@ -1,29 +1,84 @@
 "use strict";
-// Utils to manage process.env.NODE_ENV and, most notably, to assert correct usage, which is crucial:
-//  - https://github.com/vikejs/vike/issues/1469#issuecomment-1919518096
-//  - https://github.com/vitejs/vite/blob/76f30ae23b92f9af910ec02d98e2baaefa12141f/packages/vite/src/node/config.ts#L567
+// This file serves the following three purposes:
+//   1. Upon building the app, we ensure the right NODE_ENV value is set.
+//      - Both Vue and React use NODE_ENV for enabling production-specific features:
+//        - Vue: https://github.com/vuejs/core/blob/f66a75ea75c8aece065b61e2126b4c5b2338aa6e/packages/vue/index.js
+//        - React: https://github.com/facebook/react/blob/01ab35a9a731dec69995fbd28f3ac7eaad11e183/packages/react/npm/index.js
+//      - Setting NODE_ENV to 'production' doesn't seem to make any sense in development.
+//      - With React upon building the app, setting NODE_ENV to a value other than 'production' triggers an error: https://github.com/vikejs/vike/issues/1469#issuecomment-1969301797
+//      - With Vue upon building the app, NODE_ENV can be set to a value other than 'production', e.g. 'development'.
+//   2. Ensure Vite isn't loaded in production.
+//      - We currently only check whether Vite's development middleware is instantiated (i.e. whether Vite's `createServer()` was called). Is there a way to detect whether Vite's code is loaded?
+//   3. Ensure NODE_ENV isn't mistakenly set to a wrong value.
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertNodeEnvIsNotDev = exports.getNodeEnvDesc = exports.isNodeEnvDev = exports.setNodeEnvToProduction = exports.getNodeEnv = void 0;
+exports.handleNodeEnv_vitePluginVercel = exports.handleNodeEnv_prerender = exports.assertNodeEnv_onVikePluginLoad = exports.assertNodeEnv_runtime = exports.assertNodeEnv_build = void 0;
 const picocolors_1 = __importDefault(require("@brillout/picocolors"));
 const assertIsNotBrowser_js_1 = require("./assertIsNotBrowser.js");
 const assert_js_1 = require("./assert.js");
+const assertIsNotProductionRuntime_js_1 = require("./assertIsNotProductionRuntime.js");
 (0, assertIsNotBrowser_js_1.assertIsNotBrowser)();
+function assertNodeEnv_build() {
+    assertNodeEnvIsNotDev('building');
+}
+exports.assertNodeEnv_build = assertNodeEnv_build;
+function assertNodeEnv_runtime(viteDevServerExists) {
+    const nodeEnv = getNodeEnv();
+    if (nodeEnv === null || nodeEnv === 'test')
+        return;
+    const isDev = isNodeEnvDev();
+    // Calling Vite's createServer() is enough for hasViteDevServer to be true, even without actually adding Vite's development middleware to the server: https://github.com/vikejs/vike/issues/792#issuecomment-1516830759
+    if (viteDevServerExists === isDev)
+        return;
+    const nodeEnvDesc = getNodeEnvDesc();
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    (0, assert_js_1.assertWarning)(false, `Vite's development server was${viteDevServerExists ? '' : "n't"} instantiated while the ${nodeEnvDesc} which is contradictory, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+}
+exports.assertNodeEnv_runtime = assertNodeEnv_runtime;
+function assertNodeEnv_onVikePluginLoad() {
+    const nodeEnv = getNodeEnv();
+    if (nodeEnv === 'test')
+        return;
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    (0, assert_js_1.assertWarning)(
+    /* We can enable this assertion after Vike's CLI is implemented and using Vite's CLI is deprecated (we can then check whether the context is a `$ vike build`).
+    isNodeEnvDev() || isVikeCliBuild(),
+    /*/
+    isNodeEnvDev() || true, 
+    ///*/
+    [
+        picocolors_1.default.cyan(`process.env.NODE_ENV === ${JSON.stringify(nodeEnv)}`),
+        '(which Vike interprets as a non-development environment https://vike.dev/NODE_ENV)',
+        'while the vike/plugin module is loaded.',
+        assertIsNotProductionRuntime_js_1.vikeVitePluginLoadedInProductionError
+    ].join(' '), { onlyOnce: true });
+}
+exports.assertNodeEnv_onVikePluginLoad = assertNodeEnv_onVikePluginLoad;
+function handleNodeEnv_prerender() {
+    const assertNodeEnv = () => assertNodeEnvIsNotDev('pre-rendering');
+    if (getNodeEnv())
+        assertNodeEnv();
+    setNodeEnvToProduction();
+    assertNodeEnv();
+}
+exports.handleNodeEnv_prerender = handleNodeEnv_prerender;
+function handleNodeEnv_vitePluginVercel() {
+    setNodeEnvToProduction();
+}
+exports.handleNodeEnv_vitePluginVercel = handleNodeEnv_vitePluginVercel;
 function getNodeEnv() {
     if (typeof process === 'undefined')
         return null;
     return process.env.NODE_ENV;
 }
-exports.getNodeEnv = getNodeEnv;
 function setNodeEnvToProduction() {
     // The statement `process.env['NODE_ENV'] = 'production'` chokes webpack v4
     const proc = process;
     const { env } = proc;
     env.NODE_ENV = 'production';
 }
-exports.setNodeEnvToProduction = setNodeEnvToProduction;
 function isNodeEnvDev() {
     const nodeEnv = getNodeEnv();
     if (!nodeEnv)
@@ -33,19 +88,19 @@ function isNodeEnvDev() {
     // That's quite aggressive, let's see if some user complains
     return false;
 }
-exports.isNodeEnvDev = isNodeEnvDev;
 function getNodeEnvDesc() {
     const nodeEnv = getNodeEnv();
     const isDev = isNodeEnvDev();
     const nodeEnvDesc = `environment is set to be a ${(isDev ? 'development' : 'production')} environment by ${picocolors_1.default.cyan(`process.env.NODE_ENV === ${JSON.stringify(nodeEnv)}`)}`;
     return nodeEnvDesc;
 }
-exports.getNodeEnvDesc = getNodeEnvDesc;
 function assertNodeEnvIsNotDev(operation) {
     const isDev = isNodeEnvDev();
     if (!isDev)
         return;
     const nodeEnvDesc = getNodeEnvDesc();
-    (0, assert_js_1.assertUsage)(false, `The ${nodeEnvDesc} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`);
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    (0, assert_js_1.assertWarning)(false, `The ${nodeEnvDesc} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`, {
+        onlyOnce: true
+    });
 }
-exports.assertNodeEnvIsNotDev = assertNodeEnvIsNotDev;

package/dist/cjs/utils/projectInfo.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROJECT_VERSION = exports.projectInfo = void 0;
 const assertSingleInstance_js_1 = require("./assertSingleInstance.js");
-const PROJECT_VERSION = '0.4.163-commit-407cb5c';
+const PROJECT_VERSION = '0.4.164';
 exports.PROJECT_VERSION = PROJECT_VERSION;
 const projectInfo = {
     projectName: 'Vike',

package/dist/esm/__internal/index.js

@@ -2,7 +2,7 @@
 export { route, getPagesAndRoutes };
 import { route as routeInternal } from '../shared/route/index.js';
 import { getGlobalContext, initGlobalContext } from '../node/runtime/globalContext.js';
-import { setNodeEnvToProduction } from '../utils/assertNodeEnv.js';
+import { handleNodeEnv_vitePluginVercel } from '../utils/assertNodeEnv.js';
 import { assert } from '../utils/assert.js';
 import { getRenderContext } from '../node/runtime/renderPage/renderPageAlreadyRouted.js';
 /**
@@ -12,7 +12,7 @@ import { getRenderContext } from '../node/runtime/renderPage/renderPageAlreadyRo
  * @param config
  */
 async function getPagesAndRoutes() {
-    setNodeEnvToProduction();
+    handleNodeEnv_vitePluginVercel();
     await initGlobalContext(true);
     const globalContext = getGlobalContext();
     assert(globalContext.isProduction === true);

package/dist/esm/node/plugin/index.js

@@ -3,7 +3,7 @@ export { plugin };
 // TODO/v1-release: remove
 export { plugin as ssr };
 export { PROJECT_VERSION as version } from './utils.js';
-import { assertUsage, getNodeEnv, isNodeEnvDev, markEnvAsVikePluginLoaded, vikeVitePluginLoadedInProductionError } from './utils.js';
+import { assertNodeEnv_onVikePluginLoad, assertUsage, markEnvAsVikePluginLoaded } from './utils.js';
 import { buildConfig } from './plugins/buildConfig.js';
 import { previewConfig } from './plugins/previewConfig.js';
 import { autoFullBuild } from './plugins/autoFullBuild.js';
@@ -23,7 +23,7 @@ import { baseUrls } from './plugins/baseUrls.js';
 import { envVarsPlugin } from './plugins/envVars.js';
 import pc from '@brillout/picocolors';
 import { fileEnv } from './plugins/fileEnv.js';
-assertNodeEnv();
+assertNodeEnv_onVikePluginLoad();
 markEnvAsVikePluginLoaded();
 // Return as `any` to avoid Plugin type mismatches when there are multiple Vite versions installed
 function plugin(vikeConfig) {
@@ -63,21 +63,3 @@ Object.defineProperty(plugin, 'apply', {
         assertUsage(false, `Add ${pc.cyan('vike()')} instead of ${pc.cyan('vike')} to vite.config.js#plugins (i.e. call the function and add the return value instead of adding the function itself)`, { showStackTrace: true });
     }
 });
-function assertNodeEnv() {
-    const nodeEnv = getNodeEnv();
-    if (nodeEnv === 'test')
-        return;
-    // We should change this to be a warning if it blocks users (e.g. if a bad-citizen tool sets a wrong process.env.NODE_ENV value).
-    assertUsage(
-    /* We can enable this assertion after Vike's CLI is implemented and using Vite's CLI is deprecated (we can then check whether the context is a `$ vike build`).
-    isNodeEnvDev() || isVikeCliBuild(),
-    /*/
-    isNodeEnvDev() || true, 
-    ///*/
-    [
-        pc.cyan(`process.env.NODE_ENV === ${JSON.stringify(nodeEnv)}`),
-        '(which Vike interprets as a non-development environment https://vike.dev/NODE_ENV)',
-        'while the vike/plugin module is loaded.',
-        vikeVitePluginLoadedInProductionError
-    ].join(' '));
-}

package/dist/esm/node/plugin/plugins/buildConfig/fixServerAssets.js

@@ -39,9 +39,9 @@ async function copyAssets(filesToCopy, config) {
     const { outDirClient, outDirServer } = getOutDirs(config);
     const assetsDir = getAssetsDir(config);
     const assetsDirServer = path.posix.join(outDirServer, assetsDir);
-    assert(existsSync(assetsDirServer));
     if (!filesToCopy.length)
         return;
+    assert(existsSync(assetsDirServer));
     const concurrencyLimit = pLimit(10);
     await Promise.all(filesToCopy.map((file) => concurrencyLimit(() => fs.cp(path.posix.join(outDirServer, file), path.posix.join(outDirClient, file), {
         recursive: true

package/dist/esm/node/plugin/plugins/buildConfig.js

@@ -2,7 +2,7 @@ export { buildConfig };
 export { assertRollupInput };
 export { analyzeClientEntries };
 export { manifestTempFile };
-import { assert, resolveOutDir, viteIsSSR, getFilePathAbsolute, addOnBeforeLogHook, removeFileExtention, unique, assertPosixPath, assertUsage, injectRollupInputs, normalizeRollupInput, assertNodeEnvIsNotDev, getOutDirs, isNpmPackageImport } from '../utils.js';
+import { assert, resolveOutDir, viteIsSSR, getFilePathAbsolute, addOnBeforeLogHook, removeFileExtention, unique, assertPosixPath, assertUsage, injectRollupInputs, normalizeRollupInput, getOutDirs, isNpmPackageImport, assertNodeEnv_build } from '../utils.js';
 import { getVikeConfig, isV1Design } from './importUserCode/v1-design/getVikeConfig.js';
 import { getConfigValue } from '../../../shared/page-configs/helpers.js';
 import { findPageFiles } from '../shared/findPageFiles.js';
@@ -33,7 +33,7 @@ function buildConfig() {
             order: 'post',
             async handler(config_) {
                 config = config_;
-                assertNodeEnv();
+                assertNodeEnv_build();
                 assertRollupInput(config);
                 const entries = await getEntries(config);
                 assert(Object.keys(entries).length > 0);
@@ -52,7 +52,7 @@ function buildConfig() {
             }
         },
         config(config) {
-            assertNodeEnv();
+            assertNodeEnv_build();
             isSsrBuild = viteIsSSR(config);
             return {
                 build: {
@@ -63,7 +63,7 @@ function buildConfig() {
             };
         },
         buildStart() {
-            assertNodeEnv();
+            assertNodeEnv_build();
         },
         writeBundle: {
             order: 'post',
@@ -254,6 +254,3 @@ function assertRollupInput(config) {
     const htmlInput = htmlInputs[0];
     assertUsage(htmlInput === undefined, `The entry ${htmlInput} of config build.rollupOptions.input is an HTML entry which is forbidden when using Vike, instead follow https://vike.dev/add`);
 }
-function assertNodeEnv() {
-    assertNodeEnvIsNotDev('building');
-}

package/dist/esm/node/prerender/runPrerender.js

@@ -5,7 +5,7 @@ export { runPrerender_forceExit };
 import '../runtime/page-files/setup.js';
 import path from 'path';
 import { route } from '../../shared/route/index.js';
-import { assert, assertUsage, assertWarning, hasProp, projectInfo, objectAssign, isObjectWithKeys, isCallable, getOutDirs, isPropertyGetter, assertPosixPath, urlToFile, executeHook, isPlainObject, setNodeEnvToProduction, isUserHookError, assertNodeEnvIsNotDev, getNodeEnv } from './utils.js';
+import { assert, assertUsage, assertWarning, hasProp, projectInfo, objectAssign, isObjectWithKeys, isCallable, getOutDirs, isPropertyGetter, assertPosixPath, urlToFile, executeHook, isPlainObject, isUserHookError, handleNodeEnv_prerender } from './utils.js';
 import { pLimit } from '../../utils/pLimit.js';
 import { prerenderPage, prerender404Page, getRenderContext, getPageContextInitEnhanced } from '../runtime/renderPage/renderPageAlreadyRouted.js';
 import pc from '@brillout/picocolors';
@@ -59,7 +59,7 @@ async function runPrerender(options, manuallyTriggered) {
     if (logLevel === 'info') {
         console.log(`${pc.cyan(`vike v${projectInfo.projectVersion}`)} ${pc.green('pre-rendering HTML...')}`);
     }
-    handleNodeEnv();
+    handleNodeEnv_prerender();
     await disableReactStreaming();
     const viteConfig = await resolveConfig(options.viteConfig || {}, 'vike pre-rendering', 'production');
     setGlobalContext_prerender(viteConfig);
@@ -714,10 +714,3 @@ function assertIsNotAbort(err, urlOr404) {
     assert(abortCall);
     assertUsage(false, `${pc.cyan(abortCall)} thrown${thrownBy} while pre-rendering ${urlOr404} but ${pc.cyan(abortCaller)} isn't supported for pre-rendered pages`);
 }
-function handleNodeEnv() {
-    const assertNodeEnv = () => assertNodeEnvIsNotDev('pre-rendering');
-    if (getNodeEnv())
-        assertNodeEnv();
-    setNodeEnvToProduction();
-    assertNodeEnv();
-}

package/dist/esm/node/runtime/globalContext.js

@@ -9,7 +9,7 @@ export { getViteConfig };
 export { setGlobalContext_viteDevServer };
 export { setGlobalContext_prerender };
 export { getRuntimeManifest };
-import { assert, assertUsage, assertWarning, getGlobalObject, getNodeEnv, getNodeEnvDesc, isNodeEnvDev, isPlainObject, objectAssign, objectKeys } from './utils.js';
+import { assert, assertNodeEnv_runtime, assertUsage, assertWarning, getGlobalObject, isPlainObject, objectAssign, objectKeys } from './utils.js';
 import { loadImportBuild } from './globalContext/loadImportBuild.js';
 import { setPageFiles } from '../../shared/getPageFiles.js';
 import { assertPluginManifest } from '../shared/assertPluginManifest.js';
@@ -83,7 +83,7 @@ async function initGlobalContext(isPrerendering = false, outDir) {
     if (globalObject.globalContext)
         return;
     const { viteDevServer, viteConfig } = globalObject;
-    assertNodeEnv(!!viteDevServer);
+    assertNodeEnv_runtime(!!viteDevServer);
     const isProduction = !viteDevServer;
     if (!isProduction) {
         assert(viteConfig);
@@ -179,15 +179,3 @@ function assertViteManifest(manifest) {
       })
     */
 }
-function assertNodeEnv(hasViteDevServer) {
-    const nodeEnv = getNodeEnv();
-    if (nodeEnv === null || nodeEnv === 'test')
-        return;
-    const isDev = isNodeEnvDev();
-    // Calling Vite's createServer() is enough for hasViteDevServer to be true, even without actually adding Vite's development middleware to the server: https://github.com/vikejs/vike/issues/792#issuecomment-1516830759
-    if (hasViteDevServer === isDev)
-        return;
-    const nodeEnvDesc = getNodeEnvDesc();
-    // We should change this to be a warning if it blocks users (e.g. if a bad-citizen tool sets a wrong process.env.NODE_ENV value)
-    assertUsage(false, `Vite's development server was${hasViteDevServer ? '' : "n't"} instantiated while the ${nodeEnvDesc} which is contradictory, see https://vike.dev/NODE_ENV`);
-}

package/dist/esm/utils/assertNodeEnv.d.ts

@@ -1,10 +1,10 @@
-export { getNodeEnv };
-export { setNodeEnvToProduction };
-export { isNodeEnvDev };
-export { getNodeEnvDesc };
-export { assertNodeEnvIsNotDev };
-declare function getNodeEnv(): null | undefined | string;
-declare function setNodeEnvToProduction(): void | undefined;
-declare function isNodeEnvDev(): boolean;
-declare function getNodeEnvDesc(): `environment is set to be a ${string} environment by process.env.NODE_ENV === ${string}`;
-declare function assertNodeEnvIsNotDev(operation: 'building' | 'pre-rendering'): void;
+export { assertNodeEnv_build };
+export { assertNodeEnv_runtime };
+export { assertNodeEnv_onVikePluginLoad };
+export { handleNodeEnv_prerender };
+export { handleNodeEnv_vitePluginVercel };
+declare function assertNodeEnv_build(): void;
+declare function assertNodeEnv_runtime(viteDevServerExists: boolean): void;
+declare function assertNodeEnv_onVikePluginLoad(): void;
+declare function handleNodeEnv_prerender(): void;
+declare function handleNodeEnv_vitePluginVercel(): void;

package/dist/esm/utils/assertNodeEnv.js

@@ -1,15 +1,69 @@
-// Utils to manage process.env.NODE_ENV and, most notably, to assert correct usage, which is crucial:
-//  - https://github.com/vikejs/vike/issues/1469#issuecomment-1919518096
-//  - https://github.com/vitejs/vite/blob/76f30ae23b92f9af910ec02d98e2baaefa12141f/packages/vite/src/node/config.ts#L567
-export { getNodeEnv };
-export { setNodeEnvToProduction };
-export { isNodeEnvDev };
-export { getNodeEnvDesc };
-export { assertNodeEnvIsNotDev };
+// This file serves the following three purposes:
+//   1. Upon building the app, we ensure the right NODE_ENV value is set.
+//      - Both Vue and React use NODE_ENV for enabling production-specific features:
+//        - Vue: https://github.com/vuejs/core/blob/f66a75ea75c8aece065b61e2126b4c5b2338aa6e/packages/vue/index.js
+//        - React: https://github.com/facebook/react/blob/01ab35a9a731dec69995fbd28f3ac7eaad11e183/packages/react/npm/index.js
+//      - Setting NODE_ENV to 'production' doesn't seem to make any sense in development.
+//      - With React upon building the app, setting NODE_ENV to a value other than 'production' triggers an error: https://github.com/vikejs/vike/issues/1469#issuecomment-1969301797
+//      - With Vue upon building the app, NODE_ENV can be set to a value other than 'production', e.g. 'development'.
+//   2. Ensure Vite isn't loaded in production.
+//      - We currently only check whether Vite's development middleware is instantiated (i.e. whether Vite's `createServer()` was called). Is there a way to detect whether Vite's code is loaded?
+//   3. Ensure NODE_ENV isn't mistakenly set to a wrong value.
+// TODO: to fully implement the aforementioned points we need to implement a [new setting `allowNodeEnv`](https://github.com/vikejs/vike/issues/1528)
+export { assertNodeEnv_build };
+export { assertNodeEnv_runtime };
+export { assertNodeEnv_onVikePluginLoad };
+// Vite already handles build
+export { handleNodeEnv_prerender };
+export { handleNodeEnv_vitePluginVercel };
 import pc from '@brillout/picocolors';
 import { assertIsNotBrowser } from './assertIsNotBrowser.js';
-import { assertUsage } from './assert.js';
+import { assertWarning } from './assert.js';
+import { vikeVitePluginLoadedInProductionError } from './assertIsNotProductionRuntime.js';
 assertIsNotBrowser();
+function assertNodeEnv_build() {
+    assertNodeEnvIsNotDev('building');
+}
+function assertNodeEnv_runtime(viteDevServerExists) {
+    const nodeEnv = getNodeEnv();
+    if (nodeEnv === null || nodeEnv === 'test')
+        return;
+    const isDev = isNodeEnvDev();
+    // Calling Vite's createServer() is enough for hasViteDevServer to be true, even without actually adding Vite's development middleware to the server: https://github.com/vikejs/vike/issues/792#issuecomment-1516830759
+    if (viteDevServerExists === isDev)
+        return;
+    const nodeEnvDesc = getNodeEnvDesc();
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    assertWarning(false, `Vite's development server was${viteDevServerExists ? '' : "n't"} instantiated while the ${nodeEnvDesc} which is contradictory, see https://vike.dev/NODE_ENV`, { onlyOnce: true });
+}
+function assertNodeEnv_onVikePluginLoad() {
+    const nodeEnv = getNodeEnv();
+    if (nodeEnv === 'test')
+        return;
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    assertWarning(
+    /* We can enable this assertion after Vike's CLI is implemented and using Vite's CLI is deprecated (we can then check whether the context is a `$ vike build`).
+    isNodeEnvDev() || isVikeCliBuild(),
+    /*/
+    isNodeEnvDev() || true, 
+    ///*/
+    [
+        pc.cyan(`process.env.NODE_ENV === ${JSON.stringify(nodeEnv)}`),
+        '(which Vike interprets as a non-development environment https://vike.dev/NODE_ENV)',
+        'while the vike/plugin module is loaded.',
+        vikeVitePluginLoadedInProductionError
+    ].join(' '), { onlyOnce: true });
+}
+function handleNodeEnv_prerender() {
+    const assertNodeEnv = () => assertNodeEnvIsNotDev('pre-rendering');
+    if (getNodeEnv())
+        assertNodeEnv();
+    setNodeEnvToProduction();
+    assertNodeEnv();
+}
+function handleNodeEnv_vitePluginVercel() {
+    setNodeEnvToProduction();
+}
 function getNodeEnv() {
     if (typeof process === 'undefined')
         return null;
@@ -41,5 +95,8 @@ function assertNodeEnvIsNotDev(operation) {
     if (!isDev)
         return;
     const nodeEnvDesc = getNodeEnvDesc();
-    assertUsage(false, `The ${nodeEnvDesc} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`);
+    // TODO: make it assertUsage() again once #1528 is implemented.
+    assertWarning(false, `The ${nodeEnvDesc} which is forbidden upon ${operation}, see https://vike.dev/NODE_ENV`, {
+        onlyOnce: true
+    });
 }

package/dist/esm/utils/projectInfo.d.ts

@@ -1,7 +1,7 @@
 export { projectInfo };
 export { PROJECT_VERSION };
-declare const PROJECT_VERSION: "0.4.163-commit-407cb5c";
+declare const PROJECT_VERSION: "0.4.164";
 declare const projectInfo: {
     projectName: "Vike";
-    projectVersion: "0.4.163-commit-407cb5c";
+    projectVersion: "0.4.164";
 };

package/dist/esm/utils/projectInfo.js

@@ -1,7 +1,7 @@
 export { projectInfo };
 export { PROJECT_VERSION };
 import { onProjectInfo } from './assertSingleInstance.js';
-const PROJECT_VERSION = '0.4.163-commit-407cb5c';
+const PROJECT_VERSION = '0.4.164';
 const projectInfo = {
     projectName: 'Vike',
     projectVersion: PROJECT_VERSION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike",
-  "version": "0.4.163-commit-407cb5c",
+  "version": "0.4.164",
   "scripts": {
     "dev": "tsc --watch",
     "build": "rimraf dist/ && pnpm run build:esm && pnpm run build:cjs",