cyberia 3.2.9 → 3.2.12

package/src/runtime/wp/Wp.js

@@ -56,10 +56,11 @@ class WpService {
    * to `/usr/local/bin/wp` if it is not already present.
    */
   static ensureWpCli() {
-    const existing = shellExec(`PATH="${LAMPP_BIN}:$PATH" which wp 2>/dev/null || true`, {
+    const existing = shellExec(`PATH="${LAMPP_BIN}:$PATH" which wp`, {
       stdout: true,
       silent: true,
       disableLog: true,
+      silentOnError: true,
     });
     if (existing && existing.trim()) return;
     logger.info('WP-CLI not found — installing to /usr/local/bin/wp');
@@ -76,10 +77,11 @@ class WpService {
    */
   static ensureSendmail() {
     const sendmailPath = '/usr/sbin/sendmail';
-    const existing = shellExec(`test -x "${sendmailPath}" && echo ok || true`, {
+    const existing = shellExec(`test -x "${sendmailPath}" && echo ok`, {
       stdout: true,
       silent: true,
       disableLog: true,
+      silentOnError: true,
     });
     if (existing && existing.trim() === 'ok') return;
     logger.info('sendmail stub missing — creating no-op at /usr/sbin/sendmail');
@@ -494,7 +496,7 @@ Thumbs.db
    * `git clone` yields a fully working site without needing a fresh install.
    *
    * Safe to call repeatedly — `git commit` is a no-op when the working tree
-   * is clean (`|| true` prevents non-zero exit).
+   * is clean (`silentOnError: true` swallows the non-zero exit gracefully).
    *
    * @param {object} opts
    * @param {string}      opts.siteRoot   - Absolute path to the WordPress root.
@@ -514,7 +516,8 @@ Thumbs.db
 
     logger.info(`${host}: persisting site to repository`);
     shellExec(
-      `cd "${siteRoot}" && git add -A && git commit -m "wp provision ${host} $(date -u +%Y-%m-%dT%H:%M:%SZ)" || true`,
+      `cd "${siteRoot}" && git add -A && git commit -m "wp provision ${host} $(date -u +%Y-%m-%dT%H:%M:%SZ)"`,
+      { silentOnError: true },
     );
     shellExec(`cd "${siteRoot}" && underpost push . ${githubOrg}/${repoName} -f`);
     logger.info(`${host}: initial commit pushed to ${githubOrg}/${repoName}`);
@@ -627,7 +630,7 @@ if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROT
 
     // MariaDB export is handled by the shared db.js backup flow — no duplicate dump here.
     if (fs.existsSync(path.join(siteRoot, '.git'))) {
-      shellExec(`cd "${siteRoot}" && git add -A && git commit -m "wp backup $(date -u +%Y-%m-%dT%H:%M:%SZ)" || true`);
+      shellExec(`cd "${siteRoot}" && git add -A && git commit -m "wp backup $(date -u +%Y-%m-%dT%H:%M:%SZ)"`, { silentOnError: true });
       shellExec(`cd "${siteRoot}" && underpost push . ${githubOrg}/${repository.split('/').pop().split('.')[0]}`);
       logger.info(`backup: git push done for ${siteRoot}`);
     } else {

package/src/server/auth.js

@@ -20,7 +20,7 @@ import rateLimit from 'express-rate-limit';
 import slowDown from 'express-slow-down';
 import cors from 'cors';
 import cookieParser from 'cookie-parser';
-import { DataBaseProvider } from '../db/DataBaseProvider.js';
+import { DataBaseProviderService } from '../db/DataBaseProvider.js';
 import { isDevProxyContext } from './conf.js';
 
 const logger = loggerFactory(import.meta);
@@ -229,7 +229,7 @@ const authMiddlewareFactory = (options = { host: '', path: '' }) => {
 
       // Non-guest verify session exists
       if (payload.jwtid && payload.role !== 'guest') {
-        const User = DataBaseProvider.instance[`${payload.host}${payload.path}`].mongoose.models.User;
+        const User = DataBaseProviderService.getModel('user', { host: payload.host, path: payload.path });
         const user = await User.findOne({ _id: payload._id, 'activeSessions._id': payload.jwtid }).lean();
 
         if (!user) {

package/src/server/client-build-docs.js

@@ -399,7 +399,7 @@ const buildCoverage = async ({ docs, docsDestination }) => {
         shellExec(`cd ${coveragePath} && npm run coverage`, { silent: true });
       } else if (pkg.scripts && pkg.scripts.test) {
         logger.info('generating coverage via test', coveragePath);
-        shellExec(`cd ${coveragePath} && npm test`, { silent: true });
+        shellExec(`cd ${coveragePath} && npm test`, { silent: true, silentOnError: true });
       }
     }
   }

package/src/server/client-build.js

@@ -724,23 +724,24 @@ const buildClient = async (
       const ssrPath = path === '/' ? path : `${path}/`;
       const Render = await ssrFactory();
 
-      if (views) {
-        const jsSrcPath = `./src/client/sw/core.sw.js`;
-
-        const jsPublicPath = `${rootClientPath}/sw.js`;
-
-        if (!(enableLiveRebuild && !options.liveClientBuildPaths.find((p) => p.srcBuildPath === jsSrcPath))) {
-          const jsSrc = await transformClientJs(jsSrcPath, {
-            dists,
-            proxyPath: path,
-            baseHost,
-            minify: minifyBuild,
-            externalizeBareImports: false,
-          });
-
-          fs.writeFileSync(jsPublicPath, jsSrc, 'utf8');
-        }
+      const swSrcPath = `./src/client/sw/core.sw.js`;
+      const swPublicPath = `${rootClientPath}/sw.js`;
+      const swShouldRebuild =
+        views && !(enableLiveRebuild && !options.liveClientBuildPaths.find((p) => p.srcBuildPath === swSrcPath));
+      // Transformed SW JS is held in memory; it gets prepended with renderPayload
+      // and written once below, after PRE_CACHED_RESOURCES are known.
+      let swTransformedJs = '';
+      if (swShouldRebuild) {
+        swTransformedJs = await transformClientJs(swSrcPath, {
+          dists,
+          proxyPath: path,
+          baseHost,
+          minify: minifyBuild,
+          externalizeBareImports: false,
+        });
+      }
 
+      if (views) {
         if (
           !(
             enableLiveRebuild &&
@@ -750,9 +751,8 @@ const buildClient = async (
           )
         )
           for (const view of views) {
-            const buildPath = `${
-              rootClientPath[rootClientPath.length - 1] === '/' ? rootClientPath.slice(0, -1) : rootClientPath
-            }${view.path === '/' ? view.path : `${view.path}/`}`;
+            const buildPath = `${rootClientPath[rootClientPath.length - 1] === '/' ? rootClientPath.slice(0, -1) : rootClientPath
+              }${view.path === '/' ? view.path : `${view.path}/`}`;
 
             if (!fs.existsSync(buildPath)) fs.mkdirSync(buildPath, { recursive: true });
 
@@ -768,9 +768,8 @@ const buildClient = async (
             fs.writeFileSync(`${buildPath}${buildId}.js`, jsSrc, 'utf8');
             const title = metadata.title ? metadata.title : title;
 
-            const canonicalURL = `https://${host}${path}${
-              view.path === '/' ? (path === '/' ? '' : '/') : path === '/' ? `${view.path.slice(1)}/` : `${view.path}/`
-            }`;
+            const canonicalURL = `https://${host}${path}${view.path === '/' ? (path === '/' ? '' : '/') : path === '/' ? `${view.path.slice(1)}/` : `${view.path}/`
+              }`;
 
             let ssrHeadComponents = ``;
             let ssrBodyComponents = ``;
@@ -904,12 +903,12 @@ const buildClient = async (
               `${buildPath}index.html`,
               minifyBuild
                 ? await minify(htmlSrc, {
-                    minifyCSS: true,
-                    minifyJS: true,
-                    collapseBooleanAttributes: true,
-                    collapseInlineTagWhitespace: true,
-                    collapseWhitespace: true,
-                  })
+                  minifyCSS: true,
+                  minifyJS: true,
+                  collapseBooleanAttributes: true,
+                  collapseInlineTagWhitespace: true,
+                  collapseWhitespace: true,
+                })
                 : htmlSrc,
               'utf8',
             );
@@ -967,119 +966,85 @@ Sitemap: ${sitemapBaseUrl}/sitemap.xml`,
       }
 
       if (client) {
-        let PRE_CACHED_RESOURCES = [];
-
-        const normalizePrecacheRoutePath = (candidatePath) => {
-          const routePath =
-            typeof candidatePath === 'string' && candidatePath.trim().length > 0 ? candidatePath.trim() : '/offline';
-          const withLeadingSlash = routePath.startsWith('/') ? routePath : `/${routePath}`;
-          const withoutTrailingSlash = withLeadingSlash.replace(/\/+$/, '');
-          return withoutTrailingSlash.length > 0 ? withoutTrailingSlash : '/';
-        };
-
-        const toPrecacheIndexUrl = (routePath) => {
-          const normalizedRoutePath = normalizePrecacheRoutePath(routePath);
-          return `${path === '/' ? '' : path}${normalizedRoutePath === '/' ? '' : normalizedRoutePath}/index.html`;
-        };
-
-        for (const pageType of ['offline', 'pages']) {
-          if (confSSR[getCapVariableName(client)] && confSSR[getCapVariableName(client)][pageType]) {
-            for (const page of confSSR[getCapVariableName(client)][pageType]) {
-              const SsrComponent = await ssrFactory(`./src/client/ssr/${pageType}/${page.client}.js`);
-
-              const htmlSrc = Render({
-                title: page.title,
-                ssrPath,
-                ssrHeadComponents: '<base target="_top">',
-                ssrBodyComponents: SsrComponent(),
-                renderPayload: {
-                  apiBaseProxyPath,
-                  apiBaseHost,
-                  apiBasePath: process.env.BASE_API,
-                  version: Underpost.version,
-                  ...(isDevelopment ? { dev: true } : undefined),
-                },
-                renderApi: {
-                  JSONweb,
-                },
-              });
-
-              const buildPath = `${
-                rootClientPath[rootClientPath.length - 1] === '/' ? rootClientPath.slice(0, -1) : rootClientPath
-              }${page.path === '/' ? page.path : `${page.path}/`}`;
-
-              // Install-time precache is intentionally restricted to SSR offline pages.
-              // All other routes/assets are loaded lazily at runtime.
-              if (pageType === 'offline') {
-                PRE_CACHED_RESOURCES.push(toPrecacheIndexUrl(page.path));
-              }
-
-              if (!fs.existsSync(buildPath)) fs.mkdirSync(buildPath, { recursive: true });
-
-              const buildHtmlPath = `${buildPath}index.html`;
-
-              logger.info('ssr page build', buildHtmlPath);
-
-              fs.writeFileSync(
-                buildHtmlPath,
-                minifyBuild
-                  ? await minify(htmlSrc, {
-                      minifyCSS: true,
-                      minifyJS: true,
-                      collapseBooleanAttributes: true,
-                      collapseInlineTagWhitespace: true,
-                      collapseWhitespace: true,
-                    })
-                  : htmlSrc,
-                'utf8',
-              );
-            }
-          }
-        }
+        const proxyPrefix = path === '/' ? '' : path;
+        const buildIndexUrl = (routePath) => `${proxyPrefix}${routePath === '/' ? '' : routePath}/index.html`;
+
+        // SSR views: a single declarative array. The role of each view (regular
+        // page vs. offline/maintenance fallback) is expressed by per-entry flags;
+        // fallback-flagged views are also precached so the SW can serve them
+        // when the network is unreachable.
+        const ssrClientConf = confSSR[getCapVariableName(client)] || {};
+        const ssrViews = Array.isArray(ssrClientConf.views) ? ssrClientConf.views : [];
+        const PRE_CACHED_RESOURCES = [];
+        let offlineFallbackUrl = null;
+        let maintenanceFallbackUrl = null;
+
+        for (const view of ssrViews) {
+          const SsrComponent = await ssrFactory(`./src/client/ssr/views/${view.client}.js`);
+
+          const htmlSrc = Render({
+            title: view.title,
+            ssrPath,
+            ssrHeadComponents: '<base target="_top">',
+            ssrBodyComponents: SsrComponent(),
+            renderPayload: {
+              apiBaseProxyPath,
+              apiBaseHost,
+              apiBasePath: process.env.BASE_API,
+              version: Underpost.version,
+              ...(isDevelopment ? { dev: true } : undefined),
+            },
+            renderApi: { JSONweb },
+          });
 
-        {
-          const cacheScope = path === '/' ? 'root' : path.replaceAll('/', '_');
-          const ssrClientConf = confSSR[getCapVariableName(client)] || {};
-          const ssrOfflinePages = Array.isArray(ssrClientConf.offline) ? ssrClientConf.offline : [];
-          const normalizeSsrRoutePath = (candidatePath, fallbackPath) => {
-            const value =
-              typeof candidatePath === 'string' && candidatePath.trim().length > 0
-                ? candidatePath.trim()
-                : fallbackPath;
-            const withLeadingSlash = value.startsWith('/') ? value : `/${value}`;
-            const withoutTrailingSlash = withLeadingSlash.replace(/\/+$/, '');
-            return withoutTrailingSlash.length > 0 ? withoutTrailingSlash : '/';
-          };
+          const buildPath = `${rootClientPath[rootClientPath.length - 1] === '/' ? rootClientPath.slice(0, -1) : rootClientPath
+            }${view.path === '/' ? view.path : `${view.path}/`}`;
 
-          const offlineSsrPage =
-            ssrOfflinePages.find(
-              (page) =>
-                page?.client === 'NoNetworkConnection' ||
-                /no\s*network|offline/i.test(`${page?.title || ''} ${page?.client || ''} ${page?.path || ''}`),
-            ) || ssrOfflinePages[0];
+          const indexUrl = buildIndexUrl(view.path);
+          if (view.offlineDefault) {
+            offlineFallbackUrl = indexUrl;
+            PRE_CACHED_RESOURCES.push(indexUrl);
+          }
+          if (view.maintenanceDefault) {
+            maintenanceFallbackUrl = indexUrl;
+            PRE_CACHED_RESOURCES.push(indexUrl);
+          }
 
-          const maintenanceSsrPage =
-            ssrOfflinePages.find(
-              (page) =>
-                page?.client === 'Maintenance' ||
-                /maintenance/i.test(`${page?.title || ''} ${page?.client || ''} ${page?.path || ''}`),
-            ) || ssrOfflinePages[1];
+          if (!fs.existsSync(buildPath)) fs.mkdirSync(buildPath, { recursive: true });
+          const buildHtmlPath = `${buildPath}index.html`;
+          logger.info('ssr view build', buildHtmlPath);
 
-          const offlinePath = normalizeSsrRoutePath(offlineSsrPage?.path, '/offline');
-          const maintenancePath = normalizeSsrRoutePath(maintenanceSsrPage?.path, '/maintenance');
+          fs.writeFileSync(
+            buildHtmlPath,
+            minifyBuild
+              ? await minify(htmlSrc, {
+                minifyCSS: true,
+                minifyJS: true,
+                collapseBooleanAttributes: true,
+                collapseInlineTagWhitespace: true,
+                collapseWhitespace: true,
+              })
+              : htmlSrc,
+            'utf8',
+          );
+        }
 
+        if (swShouldRebuild) {
+          const cacheScope = path === '/' ? 'root' : path.replaceAll('/', '_');
           const renderPayload = {
             PRE_CACHED_RESOURCES: uniqueArray(PRE_CACHED_RESOURCES),
             PROXY_PATH: path,
-            CACHE_PREFIX: `engine-core-v3-${cacheScope}`,
-            OFFLINE_PATH: offlinePath,
-            MAINTENANCE_PATH: maintenancePath,
+            CACHE_PREFIX: `engine-core-${cacheScope}`,
+            OFFLINE_URL: offlineFallbackUrl || buildIndexUrl('/offline'),
+            MAINTENANCE_URL: maintenanceFallbackUrl || buildIndexUrl('/maintenance'),
           };
+
+          // Single write: prepend the payload prelude to the transformed SW JS.
           fs.writeFileSync(
-            `${rootClientPath}/sw.js`,
+            swPublicPath,
             `self.renderPayload = ${JSONweb(renderPayload)};
 self.__WB_DISABLE_DEV_LOGS = true;
-${fs.readFileSync(`${rootClientPath}/sw.js`, 'utf8')}`,
+${swTransformedJs}`,
             'utf8',
           );
         }

package/src/server/conf.js

@@ -41,6 +41,20 @@ const logger = loggerFactory(import.meta);
  */
 const ENV_REF_PREFIX = 'env:';
 
+/**
+ * Resolves a standardized context key from host/path descriptors.
+ * The key is used across DB, WS, mailer, and cache registries.
+ *
+ * @method resolveHostKeyContext
+ * @param {{host?: string, path?: string}|string} [context={ host: '', path: '' }] - Context object or prebuilt key.
+ * @returns {string} Host key context string.
+ * @memberof ServerConfBuilder
+ */
+const resolveHostKeyContext = (context = { host: '', path: '' }) => {
+  if (typeof context === 'string') return context;
+  return `${context.host || ''}${context.path || ''}`;
+};
+
 /**
  * Recursively walks a configuration object and replaces every string value that
  * starts with {@link ENV_REF_PREFIX} (`"env:"`) with the corresponding
@@ -320,25 +334,29 @@ const Config = {
 
     if (!fs.existsSync(folder)) fs.mkdirSync(folder, { recursive: true });
 
-    const envTemplate = fs.existsSync('./.env.example')
+    const sharedEnvTemplate = fs.existsSync('./.env.example')
       ? fs.readFileSync('./.env.example', 'utf8')
       : fs.existsSync('./.env.production')
         ? fs.readFileSync('./.env.production', 'utf8')
         : '';
 
-    if (envTemplate) {
-      const prodEnv = envTemplate.replaceAll('dd-default', deployId);
-      fs.writeFileSync(`${folder}/.env.production`, prodEnv, 'utf8');
-      fs.writeFileSync(
-        `${folder}/.env.development`,
-        prodEnv.replace('NODE_ENV=production', 'NODE_ENV=development').replace('PORT=3000', 'PORT=4000'),
-        'utf8',
-      );
-      fs.writeFileSync(
-        `${folder}/.env.test`,
-        prodEnv.replace('NODE_ENV=production', 'NODE_ENV=test').replace('PORT=3000', 'PORT=5000'),
-        'utf8',
-      );
+    const envTemplates = {
+      production: fs.existsSync('./.env.production') ? fs.readFileSync('./.env.production', 'utf8') : sharedEnvTemplate,
+      development: fs.existsSync('./.env.development')
+        ? fs.readFileSync('./.env.development', 'utf8')
+        : sharedEnvTemplate
+          ? sharedEnvTemplate.replace('NODE_ENV=production', 'NODE_ENV=development').replace('PORT=3000', 'PORT=4000')
+          : '',
+      test: fs.existsSync('./.env.test')
+        ? fs.readFileSync('./.env.test', 'utf8')
+        : sharedEnvTemplate
+          ? sharedEnvTemplate.replace('NODE_ENV=production', 'NODE_ENV=test').replace('PORT=3000', 'PORT=5000')
+          : '',
+    };
+
+    for (const [envName, envTemplate] of Object.entries(envTemplates)) {
+      if (!envTemplate) continue;
+      fs.writeFileSync(`${folder}/.env.${envName}`, envTemplate.replaceAll('dd-default', deployId), 'utf8');
     }
 
     fs.writeFileSync(
@@ -1208,7 +1226,11 @@ const validateTemplatePath = (absolutePath = '') => {
   const confSsr = DefaultConf.ssr[ssr];
   const clients = DefaultConf.client.default.services;
 
-  if (absolutePath.match('src/api') && !confServer.apis.find((p) => absolutePath.match(`src/api/${p}/`))) {
+  if (
+    absolutePath.match('src/api') &&
+    !absolutePath.match('src/api/types.js') &&
+    !confServer.apis.find((p) => absolutePath.match(`src/api/${p}/`))
+  ) {
     return false;
   }
   if (absolutePath.match('conf.dd-') && absolutePath.match('.js')) return false;
@@ -1250,14 +1272,8 @@ const validateTemplatePath = (absolutePath = '') => {
     return false;
   }
   if (
-    absolutePath.match('src/client/ssr/offline') &&
-    !confSsr.offline.find((p) => absolutePath.match(`src/client/ssr/offline/${p.client}.js`))
-  ) {
-    return false;
-  }
-  if (
-    absolutePath.match('src/client/ssr/pages') &&
-    !confSsr.pages.find((p) => absolutePath.match(`src/client/ssr/pages/${p.client}.js`))
+    absolutePath.match('src/client/ssr/views') &&
+    !(confSsr.views || []).find((p) => absolutePath.match(`src/client/ssr/views/${p.client}.js`))
   ) {
     return false;
   }
@@ -1279,15 +1295,17 @@ const validateTemplatePath = (absolutePath = '') => {
 /**
  * @method awaitDeployMonitor
  * @description Waits for the deploy monitor.
- * @param {boolean} [init=false] - The init flag.
+ * @param {boolean} [isFinal=false] - If true, logs when the final (non-replica) deployment completes.
  * @param {number} [deltaMs=1000] - The delta ms.
  * @returns {Promise<void>} - The await deploy monitor.
  * @memberof ServerConfBuilder
  */
-const awaitDeployMonitor = async (init = false, deltaMs = 1000) => {
-  if (init) Underpost.env.set('await-deploy', new Date().toISOString());
+const awaitDeployMonitor = async (isFinal = false, deltaMs = 1000) => {
+  Underpost.env.set('await-deploy', new Date().toISOString());
+  if (isFinal) logger.info('Final deployment running (no replica)');
   await timer(deltaMs);
-  if (Underpost.env.get('await-deploy')) return await awaitDeployMonitor();
+  if (Underpost.env.get('container-status') === 'error') throw new Error('Container status error');
+  if (Underpost.env.get('await-deploy')) return await awaitDeployMonitor(isFinal, deltaMs);
 };
 
 /**
@@ -1312,59 +1330,6 @@ const mergeFile = async (parts = [], outputFilePath) => {
   });
 };
 
-/**
- * @method rebuildConfFactory
- * @description Rebuilds the conf factory.
- * @param {object} options - The options.
- * @param {string} options.deployId - The deploy ID.
- * @param {string} options.valkey - The valkey.
- * @param {boolean} [options.mongo=false] - The mongo.
- * @returns {object} - The rebuild conf factory.
- * @memberof ServerConfBuilder
- */
-const rebuildConfFactory = ({ deployId, valkey, mongo }) => {
-  const confServer = loadReplicas(deployId, loadConfServerJson(`./engine-private/conf/${deployId}/conf.server.json`));
-  const hosts = {};
-  for (const host of Object.keys(confServer)) {
-    hosts[host] = {};
-    for (const path of Object.keys(confServer[host])) {
-      if (!confServer[host][path].db) continue;
-      const { singleReplica, replicas, db } = confServer[host][path];
-      const { provider } = db;
-      if (singleReplica) {
-        for (const replica of replicas) {
-          const deployIdReplica = buildReplicaId({ replica, deployId });
-          const confServerReplica = loadConfServerJson(`./engine-private/replica/${deployIdReplica}/conf.server.json`);
-          for (const _host of Object.keys(confServerReplica)) {
-            for (const _path of Object.keys(confServerReplica[_host])) {
-              hosts[host][_path] = { replica: { host, path } };
-              confServerReplica[_host][_path].valkey = valkey;
-              switch (provider) {
-                case 'mongoose':
-                  confServerReplica[_host][_path].db.host = mongo.host;
-                  break;
-              }
-            }
-          }
-          fs.writeFileSync(
-            `./engine-private/replica/${deployIdReplica}/conf.server.json`,
-            JSON.stringify(confServerReplica, null, 4),
-            'utf8',
-          );
-        }
-      } else hosts[host][path] = {};
-      confServer[host][path].valkey = valkey;
-      switch (provider) {
-        case 'mongoose':
-          confServer[host][path].db.host = mongo.host;
-          break;
-      }
-    }
-  }
-  fs.writeFileSync(`./engine-private/conf/${deployId}/conf.server.json`, JSON.stringify(confServer, null, 4), 'utf8');
-  return { hosts };
-};
-
 /**
  * @method getPathsSSR
  * @description Gets the paths SSR.
@@ -1377,8 +1342,7 @@ const getPathsSSR = (conf) => {
   for (const o of conf.head) paths.push(`src/client/ssr/head/${o}.js`);
   for (const o of conf.body) paths.push(`src/client/ssr/body/${o}.js`);
   for (const o of Object.keys(conf.mailer)) paths.push(`src/client/ssr/mailer/${conf.mailer[o]}.js`);
-  for (const o of conf.offline) paths.push(`src/client/ssr/mailer/${o.client}.js`);
-  for (const o of conf.pages) paths.push(`src/client/ssr/pages/${o.client}.js`);
+  for (const o of conf.views || []) paths.push(`src/client/ssr/views/${o.client}.js`);
   return paths;
 };
 
@@ -1746,6 +1710,44 @@ const loadConfServerJson = (jsonPath, options) => {
   return options && options.resolve === true ? resolveConfSecrets(raw) : raw;
 };
 
+/**
+ * Creates and writes the /etc/hosts file for a deployment.
+ * @method etcHostFactory
+ * @param {Array<string>} hosts - List of hosts to be added to the hosts file.
+ * @param {object} options - Options for the hosts file creation.
+ * @param {boolean} options.append - Whether to append to the existing hosts file.
+ * @returns {object} - Object containing the rendered hosts file.
+ * @memberof ServerConfBuilder
+ */
+const etcHostFactory = (hosts = [], options = { append: false }) => {
+  hosts = hosts.map((host) => {
+    try {
+      if (!host.startsWith('http')) host = `http://${host}`;
+      const hostname = new URL(host).hostname;
+      logger.info('Hostname extract valid', { host, hostname });
+      return hostname;
+    } catch (e) {
+      logger.warn('No hostname extract valid', host);
+      return host;
+    }
+  });
+  const renderHosts = `127.0.0.1         ${hosts.join(
+    ' ',
+  )} localhost localhost.localdomain localhost4 localhost4.localdomain4
+::1         localhost localhost.localdomain localhost6 localhost6.localdomain6`;
+
+  if (options && options.append && fs.existsSync(`/etc/hosts`)) {
+    fs.writeFileSync(
+      `/etc/hosts`,
+      fs.readFileSync(`/etc/hosts`, 'utf8') +
+        `
+${renderHosts}`,
+      'utf8',
+    );
+  } else fs.writeFileSync(`/etc/hosts`, renderHosts, 'utf8');
+  return { renderHosts };
+};
+
 export {
   Config,
   loadConf,
@@ -1774,7 +1776,6 @@ export {
   pathPortAssignmentFactory,
   deployRangePortFactory,
   awaitDeployMonitor,
-  rebuildConfFactory,
   buildCliDoc,
   getInstanceContext,
   buildApiConf,
@@ -1784,6 +1785,7 @@ export {
   devProxyHostFactory,
   isTlsDevProxy,
   getTlsHosts,
+  resolveHostKeyContext,
   resolveConfSecrets,
   loadConfServerJson,
   getConfFolder,
@@ -1792,4 +1794,5 @@ export {
   DEFAULT_DEPLOY_ID,
   loadCronDeployEnv,
   cronDeployIdResolve,
+  etcHostFactory,
 };