underpost 3.1.2 → 3.2.0

package/src/client/ssr/body/500.js

@@ -46,9 +46,12 @@ const main = () => {
         a {
           color: black;
         }
+        .main-body-ssr-500 {
+          top: 45%;
+        }
       </style>
 
-      <div class="abs center" style="top: 45%">
+      <div class="abs center main-body-ssr-500">
         ${icon}
         <br />
         <br />
@@ -56,17 +59,18 @@ const main = () => {
         <br />
         <br />${Translate.Render('page-broken')} <br />
         <br />
-        <a href="${location.origin}">${Translate.Render('back')}</a>
+        <a target="_top" href="${location.origin}">${Translate.Render('back')}</a>
       </div>`,
   );
 };
 
-SrrComponent = () => html`<script>
-  {
-    const s = ${s};
-    const append = ${append};
-    const getLang = ${getLang};
-    const main = ${main};
-    window.onload = main;
-  }
-</script>`;
+SrrComponent = () =>
+  html`<script>
+    {
+      const s = ${s};
+      const append = ${append};
+      const getLang = ${getLang};
+      const main = ${main};
+      window.onload = main;
+    }
+  </script>`;

package/src/client/ssr/body/SwaggerDarkMode.js

@@ -0,0 +1,285 @@
+const swaggerDarkCss = css`
+  /* ── Toggle button ── */
+  .swagger-ui .topbar-wrapper {
+    display: flex;
+    align-items: center;
+  }
+  .swagger-theme-toggle-btn {
+    background: rgba(255, 255, 255, 0.12);
+    border: 1px solid rgba(255, 255, 255, 0.3);
+    color: #fff;
+    padding: 5px 14px;
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: 13px;
+    margin-left: auto;
+    margin-right: 16px;
+    white-space: nowrap;
+    transition: background 0.2s ease;
+  }
+  .swagger-theme-toggle-btn:hover {
+    background: rgba(255, 255, 255, 0.25);
+  }
+
+  /* ── Dark mode overrides — black/gray gradients ── */
+  body.swagger-dark {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui .wrapper {
+    background: #0f0f0f;
+  }
+
+  /* Info block */
+  body.swagger-dark .swagger-ui .info .title,
+  body.swagger-dark .swagger-ui .info h1,
+  body.swagger-dark .swagger-ui .info h2,
+  body.swagger-dark .swagger-ui .info h3,
+  body.swagger-dark .swagger-ui .info p,
+  body.swagger-dark .swagger-ui .info li,
+  body.swagger-dark .swagger-ui .info a {
+    color: #e8e8e8;
+  }
+
+  /* Scheme / server selector bar */
+  body.swagger-dark .swagger-ui .scheme-container {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    box-shadow: 0 1px 0 #383838;
+  }
+  body.swagger-dark .swagger-ui select {
+    background: #2a2a2a;
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+
+  /* Operation tags */
+  body.swagger-dark .swagger-ui .opblock-tag {
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock-tag small {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-tag:hover {
+    background: rgba(255, 255, 255, 0.04);
+  }
+
+  /* Operation blocks */
+  body.swagger-dark .swagger-ui .opblock {
+    background: linear-gradient(180deg, #161616 0%, #1e1e1e 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock .opblock-summary {
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock .opblock-summary-description,
+  body.swagger-dark .swagger-ui .opblock .opblock-summary-operation-id {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-body {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui .opblock-description-wrapper p,
+  body.swagger-dark .swagger-ui .opblock-external-docs-wrapper p {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-section-header {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock-section-header h4 {
+    color: #e8e8e8;
+  }
+
+  /* Models section */
+  body.swagger-dark .swagger-ui section.models {
+    background: linear-gradient(180deg, #161616 0%, #1e1e1e 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui section.models h4,
+  body.swagger-dark .swagger-ui section.models h5 {
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .model-container {
+    background: #0f0f0f;
+    border-color: #2a2a2a;
+  }
+  body.swagger-dark .swagger-ui .model-box {
+    background: #1a1a1a;
+  }
+  body.swagger-dark .swagger-ui .model,
+  body.swagger-dark .swagger-ui .model-title,
+  body.swagger-dark .swagger-ui .model span,
+  body.swagger-dark .swagger-ui .model .property {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .model .property.primitive {
+    color: #a8a8a8;
+  }
+
+  /* Tables */
+  body.swagger-dark .swagger-ui table thead tr th {
+    background: linear-gradient(180deg, #222222 0%, #2a2a2a 100%);
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui table tbody tr td {
+    color: #a8a8a8;
+    border-color: #2a2a2a;
+  }
+
+  /* Parameters */
+  body.swagger-dark .swagger-ui .parameter__name,
+  body.swagger-dark .swagger-ui .parameter__type,
+  body.swagger-dark .swagger-ui .parameter__in,
+  body.swagger-dark .swagger-ui .parameter__extension,
+  body.swagger-dark .swagger-ui .parameter__empty_value_toggle {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .parameter__name.required:after {
+    color: #ff6b6b;
+  }
+
+  /* Inputs & textareas */
+  body.swagger-dark .swagger-ui input[type='text'],
+  body.swagger-dark .swagger-ui input[type='email'],
+  body.swagger-dark .swagger-ui input[type='password'],
+  body.swagger-dark .swagger-ui input[type='search'],
+  body.swagger-dark .swagger-ui input[type='number'],
+  body.swagger-dark .swagger-ui textarea {
+    background: #2a2a2a;
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+
+  /* Buttons */
+  body.swagger-dark .swagger-ui .btn {
+    color: #e8e8e8;
+    border-color: #383838;
+    background: #222222;
+  }
+  body.swagger-dark .swagger-ui .btn:hover {
+    background: #2a2a2a;
+  }
+  body.swagger-dark .swagger-ui .btn.authorize {
+    color: #49cc90;
+    border-color: #49cc90;
+    background: transparent;
+  }
+  body.swagger-dark .swagger-ui .btn.execute {
+    background: linear-gradient(180deg, #333333 0%, #262626 100%);
+    border-color: #484848;
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .btn.cancel {
+    color: #ff6b6b;
+    border-color: #ff6b6b;
+  }
+
+  /* Responses */
+  body.swagger-dark .swagger-ui .responses-inner h4,
+  body.swagger-dark .swagger-ui .responses-inner h5 {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .response-col_status {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .response-col_description__inner p {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .response {
+    border-color: #2a2a2a;
+  }
+
+  /* Code / highlight */
+  body.swagger-dark .swagger-ui .highlight-code,
+  body.swagger-dark .swagger-ui .microlight {
+    background: #1a1a1a;
+    border: 1px solid #2a2a2a;
+  }
+
+  /* Markdown */
+  body.swagger-dark .swagger-ui .markdown p,
+  body.swagger-dark .swagger-ui .markdown li,
+  body.swagger-dark .swagger-ui .markdown a {
+    color: #a8a8a8;
+  }
+
+  /* Tabs */
+  body.swagger-dark .swagger-ui .tab li {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .tab li.active {
+    color: #e8e8e8;
+  }
+
+  /* Auth / modal dialog */
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    border: 1px solid #383838;
+    box-shadow: 0 4px 24px rgba(0, 0, 0, 0.7);
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-header {
+    border-bottom: 1px solid #383838;
+    background: linear-gradient(180deg, #222222 0%, #1a1a1a 100%);
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-header h3 {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content p,
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content label,
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content h4 {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .auth-container .errors {
+    color: #ff6b6b;
+  }
+
+  /* Info / description */
+  body.swagger-dark .swagger-ui .info .base-url,
+  body.swagger-dark .swagger-ui .servers-title,
+  body.swagger-dark .swagger-ui .servers > label {
+    color: #a8a8a8;
+  }
+
+  /* Expand/collapse arrows */
+  body.swagger-dark .swagger-ui svg.arrow path {
+    fill: #a8a8a8;
+  }
+`;
+
+const swaggerDarkJs = `(function () {
+  function injectThemeToggle() {
+    var topbarWrapper = document.querySelector('.swagger-ui .topbar-wrapper');
+    if (!topbarWrapper || document.getElementById('swagger-theme-toggle')) return;
+
+    var savedTheme = localStorage.getItem('swagger-theme') || 'light';
+    if (savedTheme === 'dark') document.body.classList.add('swagger-dark');
+
+    var btn = document.createElement('button');
+    btn.id = 'swagger-theme-toggle';
+    btn.className = 'swagger-theme-toggle-btn';
+    btn.setAttribute('title', 'Toggle dark / light mode');
+    btn.textContent = savedTheme === 'dark' ? '\u2600\uFE0F Light Mode' : '\uD83C\uDF19 Dark Mode';
+
+    btn.addEventListener('click', function () {
+      var isDark = document.body.classList.toggle('swagger-dark');
+      localStorage.setItem('swagger-theme', isDark ? 'dark' : 'light');
+      btn.textContent = isDark ? '\u2600\uFE0F Light Mode' : '\uD83C\uDF19 Dark Mode';
+    });
+
+    topbarWrapper.appendChild(btn);
+  }
+
+  var poll = setInterval(function () {
+    if (document.querySelector('.swagger-ui .topbar-wrapper')) {
+      injectThemeToggle();
+      clearInterval(poll);
+    }
+  }, 100);
+})();`;
+
+SrrComponent = () => ({ css: swaggerDarkCss, js: swaggerDarkJs });

package/src/client/ssr/offline/NoNetworkConnection.js

@@ -51,17 +51,18 @@ const main = () => {
         <br />
         <br />${Translate.Render('no-internet-connection')} <br />
         <br />
-        <a href="${location.origin}">${Translate.Render('back')}</a>
+        <a target="_top" href="${location.origin}">${Translate.Render('back')}</a>
       </div>`,
   );
 };
 
-SrrComponent = () => html`<script>
-  {
-    const s = ${s};
-    const append = ${append};
-    const getLang = ${getLang};
-    const main = ${main};
-    window.onload = main;
-  }
-</script>`;
+SrrComponent = () =>
+  html`<script>
+    {
+      const s = ${s};
+      const append = ${append};
+      const getLang = ${getLang};
+      const main = ${main};
+      window.onload = main;
+    }
+  </script>`;

package/src/client/ssr/pages/Test.js

@@ -182,17 +182,18 @@ const main = () => {
         <span class="bold">Test Page</span>
         <br />
         <br />
-        <a href="${location.origin}">${Translate.Render('back')}</a>
+        <a target="_top" href="${location.origin}">${Translate.Render('back')}</a>
       </div>`,
   );
 };
 
-SrrComponent = () => html`<script>
-  {
-    const s = ${s};
-    const append = ${append};
-    const getLang = ${getLang};
-    const main = ${main};
-    window.onload = main;
-  }
-</script>`;
+SrrComponent = () =>
+  html`<script>
+    {
+      const s = ${s};
+      const append = ${append};
+      const getLang = ${getLang};
+      const main = ${main};
+      window.onload = main;
+    }
+  </script>`;

package/src/index.js

@@ -10,6 +10,7 @@ import UnderpostKickStart from './cli/kickstart.js';
 import UnderpostCluster from './cli/cluster.js';
 import UnderpostDB from './cli/db.js';
 import UnderpostDeploy from './cli/deploy.js';
+import UnderpostKubectl from './cli/kubectl.js';
 import UnderpostRootEnv from './cli/env.js';
 import UnderpostFileStorage from './cli/fs.js';
 import UnderpostIPFS from './cli/ipfs.js';
@@ -22,6 +23,7 @@ import UnderpostSecret from './cli/secrets.js';
 import UnderpostSSH from './cli/ssh.js';
 import UnderpostStatic from './cli/static.js';
 import UnderpostTest from './cli/test.js';
+import UnderpostRelease from './cli/release.js';
 import UnderpostSystemProvisionig from './cli/system.js';
 
 import UnderpostDns from './server/dns.js';
@@ -42,7 +44,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v3.1.2';
+  static version = 'v3.2.0';
 
   /**
    * Required Node.js major version
@@ -126,6 +128,15 @@ class Underpost {
   static get db() {
     return UnderpostDB.API;
   }
+  /**
+   * Kubectl cli API
+   * @static
+   * @type {UnderpostKubectl.API}
+   * @memberof Underpost
+   */
+  static get kubectl() {
+    return UnderpostKubectl.API;
+  }
   /**
    * Deployment cli API
    * @static
@@ -280,6 +291,16 @@ class Underpost {
   static get tls() {
     return UnderpostTLS.API;
   }
+
+  /**
+   * Release orchestrator cli API
+   * @static
+   * @type {UnderpostRelease.API}
+   * @memberof Underpost
+   */
+  static get release() {
+    return UnderpostRelease.API;
+  }
 }
 
 if (!process.version || !process.version.startsWith(`${Underpost.majorNodejsVersion}.`))
@@ -300,6 +321,7 @@ export {
   UnderpostCluster,
   UnderpostDB,
   UnderpostDeploy,
+  UnderpostKubectl,
   UnderpostRootEnv,
   UnderpostFileStorage,
   UnderpostImage,
@@ -317,6 +339,7 @@ export {
   UnderpostBackup,
   UnderpostCron,
   UnderpostStartUp,
+  UnderpostRelease,
   UnderpostTLS,
 };
 

package/src/runtime/express/Express.js

@@ -79,6 +79,7 @@ class ExpressService {
     peer,
     valkey,
     apiBaseHost,
+    grpc,
     redirectTarget,
     rootHostPath,
     confSSR,
@@ -135,7 +136,17 @@ class ExpressService {
     });
 
     // Static file serving
-    app.use('/', express.static(directory ? directory : `.${rootHostPath}`));
+    app.use(
+      '/',
+      express.static(directory ? directory : `.${rootHostPath}`, {
+        setHeaders: (res, filePath) => {
+          if (filePath.includes('/assets/')) {
+            res.set('Access-Control-Allow-Origin', '*');
+            res.set('Cross-Origin-Resource-Policy', 'cross-origin');
+          }
+        },
+      }),
+    );
 
     // Handle redirection-only instances
     if (redirect) {
@@ -165,14 +176,7 @@ class ExpressService {
         });
       }
 
-      // Swagger UI setup
-      if (fs.existsSync(swaggerJsonPath)) {
-        const swaggerDoc = JSON.parse(fs.readFileSync(swaggerJsonPath, 'utf8'));
-        const swaggerUiOptions = await buildSwaggerUiOptions();
-        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc, swaggerUiOptions));
-      }
-
-      // Security and CORS
+      // Security and CORS — must run before swagger-ui so CSP headers are included in swagger responses
       if (process.env.NODE_ENV === 'development' && useLocalSsl)
         origins = origins.map((origin) => origin.replace('http', 'https'));
 
@@ -180,6 +184,13 @@ class ExpressService {
         origin: origins,
       });
 
+      // Swagger UI setup (after security middleware so responses carry correct CSP headers)
+      if (fs.existsSync(swaggerJsonPath)) {
+        const swaggerDoc = JSON.parse(fs.readFileSync(swaggerJsonPath, 'utf8'));
+        const swaggerUiOptions = await buildSwaggerUiOptions();
+        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc, swaggerUiOptions));
+      }
+
       // Database and Valkey connections
       if (db && apis) await DataBaseProvider.load({ apis, host, path, db });
 
@@ -198,6 +209,12 @@ class ExpressService {
         });
       }
 
+      // gRPC server
+      if (path === '/' && grpc && grpc.module) {
+        const { GrpcServer } = await import(`../../grpc/${grpc.module}/grpc-server.js`);
+        await GrpcServer.start({ host, path, port: grpc.port || 50051 });
+      }
+
       // API router loading
       if (apis && apis.length > 0) {
         const authMiddleware = authMiddlewareFactory({ host, path });

package/src/runtime/lampp/Dockerfile

@@ -20,8 +20,8 @@ RUN dnf -y update && \
     perl && \
     dnf clean all
 
-# --- Download and install XAMPP
-RUN curl -L -o /tmp/xampp-linux-installer.run "https://sourceforge.net/projects/xampp/files/XAMPP%20Linux/7.4.33/xampp-linux-x64-7.4.33-0-installer.run" && \
+# --- Download and install XAMPP (PHP 8.2)
+RUN curl -L -o /tmp/xampp-linux-installer.run "https://sourceforge.net/projects/xampp/files/XAMPP%20Linux/8.2.12/xampp-linux-x64-8.2.12-0-installer.run" && \
     chmod +x /tmp/xampp-linux-installer.run && \
     bash -c "/tmp/xampp-linux-installer.run --mode unattended" && \
     ln -sf /opt/lampp/lampp /usr/bin/lampp
@@ -31,6 +31,13 @@ RUN mkdir -p /opt/lampp/htdocs && \
     chown -R root:root /opt/lampp/htdocs && \
     chmod -R a+rX /opt/lampp/htdocs
 
+# Add XAMPP binaries and /usr/local/bin to PATH for all shells
+ENV PATH="/opt/lampp/bin:/usr/local/bin:${PATH}"
+RUN echo 'export PATH="/opt/lampp/bin:/usr/local/bin:${PATH}"' > /etc/profile.d/lampp.sh
+
+# Provide a no-op sendmail so PHP plugins don't error on mail calls
+RUN printf '#!/bin/sh\ncat > /dev/null\n' > /usr/sbin/sendmail && chmod +x /usr/sbin/sendmail
+
 # Install Node.js
 RUN curl -fsSL https://rpm.nodesource.com/setup_24.x | bash -
 RUN dnf install nodejs -y

package/src/runtime/lampp/Lampp.js

@@ -169,9 +169,9 @@ class LamppService {
       shellCd(`./engine-private/setup`);
 
       if (!process.argv.includes(`server`)) {
-        // Download and run the XAMPP installer
+        // Download and run the XAMPP installer (PHP 8.2)
         shellExec(
-          `curl -Lo xampp-linux-installer.run https://sourceforge.net/projects/xampp/files/XAMPP%20Linux/7.4.30/xampp-linux-x64-7.4.30-1-installer.run?from_af=true`,
+          `curl -Lo xampp-linux-installer.run https://sourceforge.net/projects/xampp/files/XAMPP%20Linux/8.2.12/xampp-linux-x64-8.2.12-0-installer.run`,
         );
         shellExec(`sudo chmod +x xampp-linux-installer.run`);
         shellExec(
@@ -237,7 +237,8 @@ Listen ${port}
 
 <VirtualHost *:${port}>
   DocumentRoot "${documentRoot}"
-  ServerName ${host}:${port}
+  ServerName ${host}
+  UseCanonicalName Off
 
   <Directory "${documentRoot}">
     Options Indexes FollowSymLinks MultiViews

package/src/runtime/wp/Dockerfile

@@ -0,0 +1,64 @@
+FROM rockylinux:9
+
+# Update and install required packages
+RUN dnf -y update && \
+    dnf -y install epel-release && \
+    dnf -y install --allowerasing \
+    bzip2 \
+    sudo \
+    curl \
+    unzip \
+    net-tools \
+    openssh-server \
+    nano \
+    vim-enhanced \
+    less \
+    openssl-devel \
+    wget \
+    git \
+    gnupg2 \
+    libnsl \
+    perl && \
+    dnf clean all
+
+# --- Download and install XAMPP (PHP 8.2)
+RUN curl -L -o /tmp/xampp-linux-installer.run "https://sourceforge.net/projects/xampp/files/XAMPP%20Linux/8.2.12/xampp-linux-x64-8.2.12-0-installer.run" && \
+    chmod +x /tmp/xampp-linux-installer.run && \
+    bash -c "/tmp/xampp-linux-installer.run --mode unattended" && \
+    ln -sf /opt/lampp/lampp /usr/bin/lampp
+
+# --- Create /xampp/htdocs (static root) and set permissions
+RUN mkdir -p /opt/lampp/htdocs && \
+    chown -R root:root /opt/lampp/htdocs && \
+    chmod -R a+rX /opt/lampp/htdocs
+
+# Add XAMPP binaries and /usr/local/bin to PATH for all shells
+ENV PATH="/opt/lampp/bin:/usr/local/bin:${PATH}"
+RUN echo 'export PATH="/opt/lampp/bin:/usr/local/bin:${PATH}"' > /etc/profile.d/lampp.sh
+
+# Provide a no-op sendmail so WP plugins don't error on mail calls
+RUN printf '#!/bin/sh\ncat > /dev/null\n' > /usr/sbin/sendmail && chmod +x /usr/sbin/sendmail
+
+# Install WP-CLI
+RUN curl -sL https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar -o /usr/local/bin/wp && \
+    chmod +x /usr/local/bin/wp && \
+    wp --info --allow-root
+
+# Install Node.js
+RUN curl -fsSL https://rpm.nodesource.com/setup_24.x | bash -
+RUN dnf install nodejs -y
+RUN dnf clean all
+
+# Verify Node.js and npm versions
+RUN node --version
+RUN npm --version
+
+# Set working directory
+WORKDIR /home/dd
+
+EXPOSE 22
+EXPOSE 80
+EXPOSE 443
+EXPOSE 3000-3100
+EXPOSE 4000-4100
+