underpost 2.8.55 → 2.8.56

package/.github/workflows/ghpkg.yml

@@ -43,7 +43,7 @@ jobs:
         run: |
           npm install -g underpost
           underpost config set GITHUB_TOKEN ${{ secrets.GIT_AUTH_TOKEN }}
-          underpost install
+          npm install
           node ./bin/deploy rename-package @underpostnet/underpost
           node ./bin/deploy set-repo underpostnet/pwa-microservices-template-ghpkg
 

package/.github/workflows/npmpkg.yml

@@ -28,7 +28,7 @@ jobs:
         run: |
           npm install -g underpost
           underpost config set GITHUB_TOKEN ${{ secrets.GIT_AUTH_TOKEN }}
-          underpost install
+          npm install
 
       - name: Set git credentials
         run: |

package/.github/workflows/pwa-microservices-template.page.yml

@@ -43,7 +43,7 @@ jobs:
       - name: Build the site
         run: |
           npm install -g underpost
-          underpost install
+          npm install
           node bin/deploy update-default-conf ghpkg
           env-cmd -f .env.production node bin/deploy build-full-client github-pages underpostnet.github.io /pwa-microservices-template-ghpkg
       # git lfs install

package/bin/build.js

@@ -155,6 +155,15 @@ const { DefaultConf } = await import(`../conf.${confName}.js`);
     `${basePath}/.github/workflows/engine.${confName.split('dd-')[1]}.ci.yml`,
   );
 
+  switch (confName) {
+    case 'dd-cyberia':
+      fs.copyFileSync(`./bin/cyberia.js`, `${basePath}/bin/cyberia.js`);
+      break;
+
+    default:
+      break;
+  }
+
   const packageJson = JSON.parse(fs.readFileSync(`${basePath}/package.json`, 'utf8'));
   packageJson.name = repoName;
   fs.writeFileSync(

package/bin/index.js

@@ -85,12 +85,14 @@ program
   .option('--reset', `Delete all clusters and prune all data and caches`)
   .option('--mariadb', 'Init with mariadb statefulset')
   .option('--mongodb', 'Init with mongodb statefulset')
+  .option('--mongodb4', 'Init with mongodb 4.4 service')
   .option('--valkey', 'Init with valkey service')
   .option('--contour', 'Init with project contour base HTTPProxy and envoy')
   .option('--cert-manager', 'Init with letsencrypt-prod ClusterIssuer')
   .option('--info', 'Get all kinds objects deployed')
   .option('--full', 'Init with all statefulsets and services available')
   .option('--ns-use <ns-name>', 'Switches current context to namespace')
+  .option('--dev', 'init with dev cluster')
   .option('--list-pods', 'Display list pods information')
   .action(Underpost.cluster.init)
   .description('Manage cluster, for default initialization base kind cluster');
@@ -158,6 +160,8 @@ program
   .argument('<deploy-list>', 'Deploy id list, e.g. default-a,default-b')
   .option('--import', 'Import container backups from repositories')
   .option('--export', 'Export container backups to repositories')
+  .option('--pod-name <pod-name>', 'Optional pod context')
+  .option('--ns <ns-name>', 'Optional name space context')
   .description('Manage databases')
   .action(UnderpostDB.API.callback);
 
@@ -184,6 +188,18 @@ program
   .description('Cron jobs management')
   .action(Underpost.cron.callback);
 
+program
+  .command('fs')
+  .argument('[path]', 'Absolute or relative directory')
+  .option('--rm', 'Remove file')
+  .option('--git', 'Current git changes')
+  .option('--recursive', 'Upload files recursively')
+  .option('--deploy-id <deploy-id>', 'Deploy configuration id')
+  .option('--pull', 'Download file')
+  .option('--force', 'Force action')
+  .description('File storage management, for default upload file')
+  .action(Underpost.fs.callback);
+
 program
   .command('test')
   .argument('[deploy-list]', 'Deploy id list, e.g. default-a,default-b')
@@ -193,6 +209,7 @@ program
   .option('--logs', 'Display container logs')
   .option('--pod-name <pod-name>')
   .option('--pod-status <pod-status>')
+  .option('--kind-type <kind-type>')
   .action(Underpost.test.callback);
 
 program.parse();

package/docker-compose.yml

@@ -58,7 +58,7 @@ services:
           cpus: '0.25'
           memory: 20M
     labels: # labels in Compose file instead of Dockerfile
-      engine.version: '2.8.55'
+      engine.version: '2.8.56'
     networks:
       - load-balancer
 

package/manifests/kind-config-dev.yaml

@@ -0,0 +1,12 @@
+kind: Cluster
+apiVersion: kind.x-k8s.io/v1alpha4
+nodes:
+  - role: control-plane
+  - role: worker
+    # extraPortMappings:
+    # - containerPort: 80
+    #   hostPort: 80
+    #   listenAddress: '0.0.0.0'
+    # - containerPort: 443
+    #   hostPort: 443
+    #   listenAddress: '0.0.0.0'

package/manifests/mongodb-4.4/service-deployment.yaml

@@ -29,10 +29,10 @@ spec:
             - name: mongo-persistent-storage
               mountPath: /data/db
 
-          resources:
-            requests:
-              memory: '500Mi'
-              cpu: '500m'
+      # resources:
+      #   requests:
+      #     memory: '500Mi'
+      #     cpu: '500m'
       volumes:
         - name: mongo-persistent-storage
           persistentVolumeClaim:

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.8.55",
+    "version": "2.8.56",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
@@ -57,9 +57,11 @@
         "ag-grid-community": "31.0.0",
         "axios": "^1.5.1",
         "chai": "^5.1.0",
+        "clean-jsdoc-theme": "^4.3.0",
         "cli-progress": "^3.12.0",
         "cli-spinners": "^3.0.0",
         "clipboardy": "^4.0.0",
+        "cloudinary": "^2.5.1",
         "color": "^4.2.3",
         "colors": "^1.4.0",
         "commander": "^12.1.0",
@@ -67,6 +69,7 @@
         "cors": "^2.8.5",
         "d3": "^7.9.0",
         "dotenv": "^16.3.1",
+        "easy-json-schema": "^0.0.2-beta",
         "easymde": "^2.18.0",
         "env-cmd": "^10.1.0",
         "express": "^4.18.2",
@@ -87,6 +90,7 @@
         "log-update": "^6.0.0",
         "mariadb": "^3.2.2",
         "marked": "^12.0.2",
+        "mocha": "^10.8.2",
         "mongoose": "^8.9.5",
         "morgan": "^1.10.0",
         "nodemailer": "^6.9.9",
@@ -95,6 +99,7 @@
         "peer": "^1.0.2",
         "peerjs": "^1.5.2",
         "pixi.js": "7.4.2",
+        "plantuml": "^0.0.2",
         "prom-client": "^15.1.2",
         "public-ip": "^6.0.1",
         "read": "^2.1.0",
@@ -106,17 +111,13 @@
         "socket.io": "^4.8.0",
         "sortablejs": "^1.15.0",
         "split-file": "^2.3.0",
+        "swagger-autogen": "^2.23.7",
         "swagger-ui-express": "^5.0.0",
         "systeminformation": "^5.23.7",
         "uglify-js": "^3.17.4",
         "validator": "^13.11.0",
         "vanilla-jsoneditor": "^2.3.2",
-        "winston": "^3.11.0",
-        "clean-jsdoc-theme": "^4.3.0",
-        "easy-json-schema": "^0.0.2-beta",
-        "mocha": "^10.8.2",
-        "plantuml": "^0.0.2",
-        "swagger-autogen": "^2.23.7"
+        "winston": "^3.11.0"
     },
     "devDependencies": {
         "clean-jsdoc-theme": "^4.3.0",

package/src/cli/cluster.js

@@ -12,7 +12,8 @@ class UnderpostCluster {
     async init(
       podName,
       options = {
-        valkey: false,
+        mongodb: false,
+        mongodb4: false,
         mariadb: false,
         valkey: false,
         full: false,
@@ -20,19 +21,20 @@ class UnderpostCluster {
         certManager: false,
         listPods: false,
         reset: false,
+        dev: false,
         nsUse: '',
       },
     ) {
       const npmRoot = getNpmRootPath();
-      const underpostRoot = `${npmRoot}/underpost`;
+      const underpostRoot = options?.dev === true ? '.' : `${npmRoot}/underpost`;
       if (options.reset === true) return await UnderpostCluster.API.reset();
       if (options.listPods === true) return console.table(UnderpostDeploy.API.get(podName ?? undefined));
 
-      if (options.nsUse) {
+      if (options.nsUse && typeof options.nsUse === 'string') {
         shellExec(`kubectl config set-context --current --namespace=${options.nsUse}`);
         return;
       }
-      if (options.info) {
+      if (options.info === true) {
         shellExec(`kubectl config get-contexts`); // config env persisente for manage multiple clusters
         shellExec(`kubectl config get-clusters`);
         shellExec(`kubectl get nodes -o wide`); // set of nodes of a cluster
@@ -63,12 +65,8 @@ class UnderpostCluster {
         shellExec(`kubectl get crd --all-namespaces -o wide`);
         return;
       }
-      const testClusterInit = shellExec(`kubectl get pods --all-namespaces -o wide`, {
-        disableLog: true,
-        silent: true,
-        stdout: true,
-      });
-      if (!(testClusterInit.match('kube-system') && testClusterInit.match('kube-proxy'))) {
+
+      if (!UnderpostDeploy.API.get('kube-apiserver-kind-control-plane')[0]) {
         shellExec(`containerd config default > /etc/containerd/config.toml`);
         shellExec(`sed -i -e "s/SystemdCgroup = false/SystemdCgroup = true/g" /etc/containerd/config.toml`);
         // shellExec(`cp /etc/kubernetes/admin.conf ~/.kube/config`);
@@ -76,15 +74,19 @@ class UnderpostCluster {
         shellExec(`sudo service docker restart`);
         shellExec(`sudo systemctl enable --now containerd.service`);
         shellExec(`sudo systemctl restart containerd`);
-        shellExec(`cd ${underpostRoot}/manifests && kind create cluster --config kind-config.yaml`);
+        shellExec(
+          `cd ${underpostRoot}/manifests && kind create cluster --config kind-config${
+            options?.dev === true ? '-dev' : ''
+          }.yaml`,
+        );
         shellExec(`sudo chown $(id -u):$(id -g) $HOME/.kube/config**`);
       } else logger.warn('Cluster already initialized');
 
-      if (options.full || options.valkey) {
+      if (options.full === true || options.valkey === true) {
         shellExec(`kubectl delete statefulset service-valkey`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/valkey`);
       }
-      if (options.full || options.mariadb) {
+      if (options.full === true || options.mariadb === true) {
         shellExec(
           `sudo kubectl create secret generic mariadb-secret --from-file=username=/home/dd/engine/engine-private/mariadb-username --from-file=password=/home/dd/engine/engine-private/mariadb-password`,
         );
@@ -94,7 +96,29 @@ class UnderpostCluster {
         shellExec(`kubectl delete statefulset mariadb-statefulset`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/mariadb`);
       }
-      if (options.full || options.mongodb) {
+      if (options.mongodb4 === true) {
+        shellExec(`kubectl apply -k ${underpostRoot}/manifests/mongodb-4.4`);
+
+        const deploymentName = 'mongodb-deployment';
+
+        const successInstance = await UnderpostTest.API.statusMonitor(deploymentName);
+
+        if (successInstance) {
+          const mongoConfig = {
+            _id: 'rs0',
+            members: [{ _id: 0, host: '127.0.0.1:27017' }],
+          };
+
+          const [pod] = UnderpostDeploy.API.get(deploymentName);
+
+          shellExec(
+            `sudo kubectl exec -i ${pod.NAME} -- mongo --quiet \
+        --eval 'rs.initiate(${JSON.stringify(mongoConfig)})'`,
+          );
+        }
+
+        // await UnderpostTest.API.statusMonitor('mongodb-1');
+      } else if (options.full === true || options.mongodb === true) {
         shellExec(
           `sudo kubectl create secret generic mongodb-keyfile --from-file=/home/dd/engine/engine-private/mongodb-keyfile`,
         );
@@ -104,28 +128,30 @@ class UnderpostCluster {
         shellExec(`kubectl delete statefulset mongodb`);
         shellExec(`kubectl apply -k ${underpostRoot}/manifests/mongodb`);
 
-        await UnderpostTest.API.podStatusMonitor('mongodb-1');
+        const successInstance = await UnderpostTest.API.statusMonitor('mongodb-1');
 
-        const mongoConfig = {
-          _id: 'rs0',
-          members: [
-            { _id: 0, host: 'mongodb-0.mongodb-service:27017', priority: 1 },
-            { _id: 1, host: 'mongodb-1.mongodb-service:27017', priority: 1 },
-          ],
-        };
+        if (successInstance) {
+          const mongoConfig = {
+            _id: 'rs0',
+            members: [
+              { _id: 0, host: 'mongodb-0.mongodb-service:27017', priority: 1 },
+              { _id: 1, host: 'mongodb-1.mongodb-service:27017', priority: 1 },
+            ],
+          };
 
-        shellExec(
-          `sudo kubectl exec -i mongodb-0 -- mongosh --quiet --json=relaxed \
-          --eval 'use admin' \
-          --eval 'rs.initiate(${JSON.stringify(mongoConfig)})' \
-          --eval 'rs.status()'`,
-        );
+          shellExec(
+            `sudo kubectl exec -i mongodb-0 -- mongosh --quiet --json=relaxed \
+        --eval 'use admin' \
+        --eval 'rs.initiate(${JSON.stringify(mongoConfig)})' \
+        --eval 'rs.status()'`,
+          );
+        }
       }
 
-      if (options.full || options.contour)
+      if (options.full === true || options.contour === true)
         shellExec(`kubectl apply -f https://projectcontour.io/quickstart/contour.yaml`);
 
-      if (options.full || options.certManager) {
+      if (options.full === true || options.certManager === true) {
         if (!UnderpostDeploy.API.get('cert-manager').find((p) => p.STATUS === 'Running')) {
           shellExec(`helm repo add jetstack https://charts.jetstack.io --force-update`);
           shellExec(

package/src/cli/db.js

@@ -7,9 +7,9 @@ const logger = loggerFactory(import.meta);
 
 class UnderpostDB {
   static API = {
-    async callback(deployList = 'default', options = { import: false, export: false }) {
+    async callback(deployList = 'default', options = { import: false, export: false, podName: false, ns: false }) {
       const newBackupTimestamp = new Date().getTime();
-      const nameSpace = 'default';
+      const nameSpace = options.ns && typeof options.ns === 'string' ? options.ns : 'default';
       for (const _deployId of deployList.split(',')) {
         const deployId = _deployId.trim();
         if (!deployId) continue;
@@ -74,7 +74,8 @@ class UnderpostDB {
 
               switch (provider) {
                 case 'mariadb': {
-                  const podName = `mariadb-statefulset-0`;
+                  const podName =
+                    options.podName && typeof options.podName === 'string' ? options.podName : `mariadb-statefulset-0`;
                   const serviceName = 'mariadb';
                   if (options.import === true) {
                     shellExec(`sudo kubectl cp ${_toSqlPath} ${nameSpace}/${podName}:/${dbName}.sql`);
@@ -95,7 +96,8 @@ class UnderpostDB {
 
                 case 'mongoose': {
                   if (options.import === true) {
-                    const podName = `mongodb-0`;
+                    const podName =
+                      options.podName && typeof options.podName === 'string' ? options.podName : `mongodb-0`;
                     shellExec(`sudo kubectl cp ${_toBsonPath} ${nameSpace}/${podName}:/${dbName}`);
                     const cmd = `mongorestore -d ${dbName} /${dbName}`;
                     shellExec(`sudo kubectl exec -i ${podName} -- sh -c "${cmd}"`);

package/src/cli/fs.js

@@ -0,0 +1,134 @@
+import { v2 as cloudinary } from 'cloudinary';
+import { loggerFactory } from '../server/logger.js';
+import dotenv from 'dotenv';
+import AdmZip from 'adm-zip';
+import * as dir from 'path';
+import fs from 'fs-extra';
+import { Downloader } from '../server/downloader.js';
+import UnderpostRepository from './repository.js';
+import { shellExec } from '../server/process.js';
+dotenv.config();
+
+const logger = loggerFactory(import.meta);
+
+class UnderpostFileStorage {
+  static API = {
+    cloudinaryConfig() {
+      // https://console.cloudinary.com/
+      cloudinary.config({
+        cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
+        api_key: process.env.CLOUDINARY_API_KEY,
+        api_secret: process.env.CLOUDINARY_API_SECRET,
+      });
+    },
+    getStorageConf(options) {
+      let storage, storageConf;
+      if (options.deployId && typeof options.deployId === 'string') {
+        storageConf = `./engine-private/conf/${options.deployId}/storage.json`;
+        if (!fs.existsSync(storageConf)) fs.writeFileSync(storageConf, JSON.stringify({}), 'utf8');
+        storage = JSON.parse(fs.readFileSync(storageConf, 'utf8'));
+      }
+      return { storage, storageConf };
+    },
+    writeStorageConf(storage, storageConf) {
+      if (storage) fs.writeFileSync(storageConf, JSON.stringify(storage, null, 4), 'utf8');
+    },
+    async recursiveCallback(
+      path,
+      options = { rm: false, recursive: false, deployId: '', force: false, pull: false, git: false },
+    ) {
+      const { storage, storageConf } = UnderpostFileStorage.API.getStorageConf(options);
+      const files =
+        options.git === true
+          ? UnderpostRepository.API.getChangedFiles(path)
+          : await fs.readdir(path, { recursive: true });
+      for (const relativePath of files) {
+        const _path = path + '/' + relativePath;
+        if (fs.statSync(_path).isDirectory()) {
+          if (options.pull === true && !fs.existsSync(_path)) fs.mkdirSync(_path, { recursive: true });
+          continue;
+        }
+        if (options.pull === true) {
+          await UnderpostFileStorage.API.pull(_path, options);
+        } else if (!(_path in storage) || options.force === true) {
+          await UnderpostFileStorage.API.upload(_path, options);
+          if (storage) storage[_path] = {};
+        } else logger.warn('File already exists', _path);
+      }
+      UnderpostFileStorage.API.writeStorageConf(storage, storageConf);
+      if (options.git === true) {
+        shellExec(`cd ${path} && git add .`);
+        shellExec(`underpost cmt ${path} feat`);
+      }
+    },
+    async callback(
+      path,
+      options = { rm: false, recursive: false, deployId: '', force: false, pull: false, git: false },
+    ) {
+      if (options.recursive === true || options.git === true)
+        return await UnderpostFileStorage.API.recursiveCallback(path, options);
+      if (options.pull === true) return await UnderpostFileStorage.API.pull(path, options);
+      if (options.rm === true) return await UnderpostFileStorage.API.delete(path, options);
+      return await UnderpostFileStorage.API.upload(path, options);
+    },
+    async upload(path, options = { rm: false, recursive: false, deployId: '', force: false, pull: false }) {
+      UnderpostFileStorage.API.cloudinaryConfig();
+      const { storage, storageConf } = UnderpostFileStorage.API.getStorageConf(options);
+      // path = UnderpostFileStorage.API.file2Zip(path);
+      const uploadResult = await cloudinary.uploader
+        .upload(path, {
+          public_id: path,
+          resource_type: 'raw',
+          overwrite: options.force === true ? true : false,
+        })
+        .catch((error) => {
+          logger.error(error, { path, stack: error.stack });
+        });
+      logger.info('upload result', uploadResult);
+      if (storage) storage[path] = {};
+      UnderpostFileStorage.API.writeStorageConf(storage, storageConf);
+      return uploadResult;
+    },
+    async pull(path) {
+      UnderpostFileStorage.API.cloudinaryConfig();
+      const downloadResult = await cloudinary.utils.download_archive_url({
+        public_ids: [path],
+        resource_type: 'raw',
+      });
+      logger.info('download result', downloadResult);
+      await Downloader(downloadResult, path + '.zip');
+      path = UnderpostFileStorage.API.zip2File(path + '.zip');
+      fs.removeSync(path + '.zip');
+    },
+    async delete(path) {
+      UnderpostFileStorage.API.cloudinaryConfig();
+      const deleteResult = await cloudinary.api
+        .delete_resources([path], { type: 'upload', resource_type: 'raw' })
+        .catch((error) => {
+          logger.error(error, { path, stack: error.stack });
+        });
+      logger.info('delete result', deleteResult);
+      return deleteResult;
+    },
+    file2Zip(path) {
+      const zip = new AdmZip();
+      zip.addLocalFile(path, '/');
+      path = path + '.zip';
+      zip.writeZip(path);
+      return path;
+    },
+    zip2File(path) {
+      const zip = new AdmZip(path);
+      path = path.replaceAll('.zip', '');
+      zip.extractEntryTo(
+        /*entry name*/ path.split('/').pop(),
+        /*target path*/ dir.dirname(path),
+        /*maintainEntryPath*/ false,
+        /*overwrite*/ true,
+      );
+      return path;
+    },
+  };
+}
+
+export default UnderpostFileStorage;

package/src/cli/repository.js

@@ -98,6 +98,19 @@ class UnderpostRepository {
         }
       });
     },
+
+    getChangedFiles(path = '.', extension = '', head = false) {
+      const extensionFilter = extension ? `-- '***.${extension}'` : '';
+      const command = `cd ${path} && git diff ${head ? 'HEAD^ HEAD ' : ''}--name-only ${extensionFilter}`;
+      const commandUntrack = `cd ${path} && git ls-files --others --exclude-standard`;
+      const diffOutput = shellExec(command, { stdout: true, silent: true });
+      const diffUntrackOutput = shellExec(commandUntrack, { stdout: true, silent: true });
+      return diffOutput
+        .toString()
+        .split('\n')
+        .filter(Boolean)
+        .concat(diffUntrackOutput.toString().split('\n').filter(Boolean));
+    },
   };
 }
 

package/src/cli/test.js

@@ -36,7 +36,7 @@ class UnderpostTest {
         options.podStatus &&
         typeof options.podStatus === 'string'
       )
-        return await UnderpostTest.API.podStatusMonitor(options.podName, options.podStatus);
+        return await UnderpostTest.API.statusMonitor(options.podName, options.podStatus, options.kindType);
 
       if (options.sh === true || options.logs === true) {
         const [pod] = UnderpostDeploy.API.get(deployList);
@@ -86,16 +86,27 @@ class UnderpostTest {
         }
       } else return UnderpostTest.API.run();
     },
-    podStatusMonitor(podName, status = 'Running', deltaMs = 1000) {
+    statusMonitor(podName, status = 'Running', kindType = '', deltaMs = 1000, maxAttempts = 60 * 5) {
+      if (!(kindType && typeof kindType === 'string')) kindType = 'pods';
       return new Promise(async (resolve) => {
         let index = 0;
-        logger.info(`Loading ${podName} instance`, { status, deltaMs });
+        logger.info(`Loading instance`, { podName, status, kindType, deltaMs, maxAttempts });
         const _monitor = async () => {
           await timer(deltaMs);
-          const result = UnderpostDeploy.API.get(podName).find((p) => p.STATUS === status);
-          logger.info(`Testing pod ${podName}... ${result ? 1 : 0}/1 - elapsed time ${deltaMs * (index + 1)}ms`);
-          if (result) return resolve();
+          const pods = UnderpostDeploy.API.get(podName, kindType);
+          const result = pods.find((p) => p.STATUS === status);
+          logger.info(
+            `Testing pod ${podName}... ${result ? 1 : 0}/1 - elapsed time ${deltaMs * (index + 1)}s - attempt ${
+              index + 1
+            }/${maxAttempts}`,
+            pods[0] ? pods[0].STATUS : 'Not found kind object',
+          );
+          if (result) return resolve(true);
           index++;
+          if (index === maxAttempts) {
+            logger.error(`Failed to test pod ${podName} within ${maxAttempts} attempts`);
+            return resolve(false);
+          }
           return _monitor();
         };
         await _monitor();

package/src/index.js

@@ -9,6 +9,7 @@ import UnderpostCron from './cli/cron.js';
 import UnderpostDB from './cli/db.js';
 import UnderpostDeploy from './cli/deploy.js';
 import UnderpostRootEnv from './cli/env.js';
+import UnderpostFileStorage from './cli/fs.js';
 import UnderpostImage from './cli/image.js';
 import UnderpostRepository from './cli/repository.js';
 import UnderpostScript from './cli/script.js';
@@ -27,7 +28,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v2.8.55';
+  static version = 'v2.8.56';
   /**
    * Repository cli API
    * @static
@@ -98,6 +99,13 @@ class Underpost {
    * @memberof Underpost
    */
   static cron = UnderpostCron.API;
+  /**
+   * File Storage cli API
+   * @static
+   * @type {UnderpostFileStorage.API}
+   * @memberof UnderpostFileStorage
+   */
+  static fs = UnderpostFileStorage.API;
 }
 
 const up = Underpost;

package/src/server/client-formatted.js

@@ -2,6 +2,7 @@
 
 import fs from 'fs-extra';
 import vm from 'node:vm';
+import Underpost from '../index.js';
 
 const srcFormatted = (src) =>
   src
@@ -49,7 +50,7 @@ const viewFormatted = (src, dists, proxyPath, baseHost = '') => {
 };
 
 const ssrFactory = async (componentPath = `./src/client/ssr/Render.js`) => {
-  const context = { SrrComponent: () => {}, npm_package_version: process.env.npm_package_version };
+  const context = { SrrComponent: () => {}, npm_package_version: Underpost.version };
   vm.createContext(context);
   vm.runInContext(await srcFormatted(fs.readFileSync(componentPath, 'utf8')), context);
   return context.SrrComponent;

package/src/server/dns.js

@@ -12,8 +12,8 @@ const logger = loggerFactory(import.meta);
 
 class Dns {
   static callback = async function (deployList) {
-    // NAT-VPS modem/router device configuration:
-    // LAN --> [NAT-VPS] --> WAN
+    // Network topology configuration:
+    // LAN -> [NAT-VPS](modem/router device) -> WAN
     // enabled DMZ Host to proxy IP 80-443 (79-444) sometimes router block first port
     // disabled local red DHCP
     // verify inet ip proxy server address