underpost 2.8.878 → 2.8.881

package/cli.md

@@ -1,46 +1,47 @@
-## underpost ci/cd cli v2.8.878
+## underpost ci/cd cli v2.8.881
 
 ### Usage: `underpost [options] [command]`
-  ```
- Options:
-  -V, --version                                              output the version number
-  -h, --help                                                 display help for command
+
+```
+Options:
+-V, --version                                              output the version number
+-h, --help                                                 display help for command
 
 Commands:
-  new [options] <app-name>                                   Initializes a new Underpost project with a predefined structure.
-  start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
-  clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
-  pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
-  cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
-  push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
-  env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
-  config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
-  root                                                       Displays the root path of the npm installation.
-  cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
-  deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
-  secret [options] <platform>                                Manages secrets for various platforms.
-  dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
-  dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
-  install                                                    Quickly imports Underpost npm dependencies by copying them.
-  db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
-  metadata [options] [deploy-id] [host] [path]               Manages cluster metadata operations, including import and export.
-  script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
-  cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
-  fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
-  test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
-  monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
-  ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
-  run [options] <runner-id> [path]                           Runs a script from the specified path.
-  lxd [options]                                              Manages LXD containers and virtual machines.
-  baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
-  help [command]                                             display help for command
- 
+new [options] <app-name>                                   Initializes a new Underpost project with a predefined structure.
+start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
+clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
+pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
+cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
+push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
+env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
+config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
+root                                                       Displays the root path of the npm installation.
+cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
+deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
+secret [options] <platform>                                Manages secrets for various platforms.
+dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
+dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
+install                                                    Quickly imports Underpost npm dependencies by copying them.
+db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
+metadata [options] [deploy-id] [host] [path]               Manages cluster metadata operations, including import and export.
+script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
+cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
+fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
+test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
+monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
+ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
+run [options] <runner-id> [path]                           Runs a script from the specified path.
+lxd [options]                                              Manages LXD containers and virtual machines.
+baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+help [command]                                             display help for command
+
 ```
 
 ## Commands:
-    
 
 ### `new` :
+
 ```
  Usage: underpost new [options] <app-name>
 
@@ -54,11 +55,11 @@ Options:
   --cluster    Create deploy ID cluster files and sync to current cluster
   --dev        Sets the development cli context
   -h, --help   display help for command
- 
+
 ```
-  
 
 ### `start` :
+
 ```
  Usage: underpost start [options] <deploy-id> [env]
 
@@ -74,11 +75,11 @@ Options:
   --run       Starts application servers and monitors their health.
   --build     Triggers the client-side application build process.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `clone` :
+
 ```
  Usage: underpost clone [options] <uri>
 
@@ -91,11 +92,11 @@ Options:
   --bare      Performs a bare clone, downloading only the .git files.
   -g8         Uses the g8 repository extension for cloning.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `pull` :
+
 ```
  Usage: underpost pull [options] <path> <uri>
 
@@ -109,11 +110,11 @@ Arguments:
 Options:
   -g8         Uses the g8 repository extension for pulling.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `cmt` :
+
 ```
  Usage: underpost cmt [options] <path> <commit-type> [module-tag] [message]
 
@@ -133,11 +134,11 @@ Options:
   --copy       Copies the generated commit message to the clipboard.
   --info       Displays information about available commit types.
   -h, --help   display help for command
- 
+
 ```
-  
 
 ### `push` :
+
 ```
  Usage: underpost push [options] <path> <uri>
 
@@ -151,11 +152,11 @@ Options:
   -f          Forces the push, overwriting the remote repository history.
   -g8         Uses the g8 repository extension for pushing.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `env` :
+
 ```
  Usage: underpost env [options] <deploy-id> [env]
 
@@ -170,11 +171,11 @@ Arguments:
 
 Options:
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `config` :
+
 ```
  Usage: underpost config [options] <operator> [key] [value]
 
@@ -189,11 +190,11 @@ Arguments:
 Options:
   --plain     Prints the configuration value in plain text.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `root` :
+
 ```
  Usage: underpost root [options]
 
@@ -201,11 +202,11 @@ Displays the root path of the npm installation.
 
 Options:
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `cluster` :
+
 ```
  Usage: underpost cluster [options] [pod-name]
 
@@ -262,11 +263,11 @@ Options:
   --k3s                   Initializes the cluster using K3s (Lightweight
                           Kubernetes).
   -h, --help              display help for command
- 
+
 ```
-  
 
 ### `deploy` :
+
 ```
  Usage: underpost deploy [options] [deploy-list] [env]
 
@@ -315,11 +316,11 @@ Options:
                                     deployment operations.
   --restore-hosts                   Restores default `/etc/hosts` entries.
   -h, --help                        display help for command
- 
+
 ```
-  
 
 ### `secret` :
+
 ```
  Usage: underpost secret [options] <platform>
 
@@ -337,11 +338,11 @@ Options:
   --list                              Lists all available secrets for the
                                       platform.
   -h, --help                          display help for command
- 
+
 ```
-  
 
 ### `dockerfile-image-build` :
+
 ```
  Usage: underpost dockerfile-image-build [options]
 
@@ -368,11 +369,11 @@ Options:
                                        cache.
   --k3s-load                           Loads the image into a K3s cluster.
   -h, --help                           display help for command
- 
+
 ```
-  
 
 ### `dockerfile-pull-base-images` :
+
 ```
  Usage: underpost dockerfile-pull-base-images [options]
 
@@ -386,11 +387,11 @@ Options:
   --version       Sets a custom version for the base images.
   --k3s-load      Loads the image into a K3s cluster.
   -h, --help      display help for command
- 
+
 ```
-  
 
 ### `install` :
+
 ```
  Usage: underpost install [options]
 
@@ -398,11 +399,11 @@ Quickly imports Underpost npm dependencies by copying them.
 
 Options:
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `db` :
+
 ```
  Usage: underpost db [options] <deploy-list>
 
@@ -432,11 +433,11 @@ Options:
   --ns <ns-name>               Optional: Specifies the namespace context for
                                database operations.
   -h, --help                   display help for command
- 
+
 ```
-  
 
 ### `metadata` :
+
 ```
  Usage: underpost metadata [options] [deploy-id] [host] [path]
 
@@ -455,11 +456,11 @@ Options:
   --generate   Generate cluster metadata
   --itc        Apply under container execution context
   -h, --help   display help for command
- 
+
 ```
-  
 
 ### `script` :
+
 ```
  Usage: underpost script [options] <operator> <script-name> [script-value]
 
@@ -481,11 +482,11 @@ Options:
                          execution.
   --pod-name <pod-name>  Optional: Specifies the pod name for script execution.
   -h, --help             display help for command
- 
+
 ```
-  
 
 ### `cron` :
+
 ```
  Usage: underpost cron [options] [deploy-list] [job-list]
 
@@ -503,11 +504,11 @@ Options:
   --init       Initializes cron jobs for the default deployment ID.
   --git        Uploads cron job configurations to GitHub.
   -h, --help   display help for command
- 
+
 ```
-  
 
 ### `fs` :
+
 ```
  Usage: underpost fs [options] [path]
 
@@ -525,11 +526,11 @@ Options:
   --force                                  Forces the action, overriding any warnings or conflicts.
   --storage-file-path <storage-file-path>  Specifies a custom file storage path.
   -h, --help                               display help for command
- 
+
 ```
-  
 
 ### `test` :
+
 ```
  Usage: underpost test [options] [deploy-list]
 
@@ -551,11 +552,11 @@ Options:
   --kind-type <kind-type>    Optional: Specifies the Kind cluster type for
                              tests.
   -h, --help                 display help for command
- 
+
 ```
-  
 
 ### `monitor` :
+
 ```
  Usage: underpost monitor [options] <deploy-id> [env]
 
@@ -578,11 +579,11 @@ Options:
   --sync                       Synchronizes with current proxy deployments and
                                traffic configurations.
   -h, --help                   display help for command
- 
+
 ```
-  
 
 ### `ssh` :
+
 ```
  Usage: underpost ssh [options]
 
@@ -592,11 +593,11 @@ Options:
   --generate  Generates new ssh credential and stores it in current private
               keys file storage.
   -h, --help  display help for command
- 
+
 ```
-  
 
 ### `run` :
+
 ```
  Usage: underpost run [options] <runner-id> [path]
 
@@ -619,12 +620,14 @@ Options:
   --image-name <image-name>                Optional: Specifies the image name for test execution.
   --container-name <container-name>        Optional: Specifies the container name for test execution.
   --namespace <namespace>                  Optional: Specifies the namespace for test execution.
+  --kubeadm                                Flag to indicate Kubeadm cluster type context
+  --k3s                                    Flag to indicate K3s cluster type context
   -h, --help                               display help for command
- 
+
 ```
-  
 
 ### `lxd` :
+
 ```
  Usage: underpost lxd [options]
 
@@ -665,11 +668,11 @@ Options:
   --auto-expose-k8s-ports <vm-id>  Automatically exposes common Kubernetes
                                    ports for the specified VM.
   -h, --help                       display help for command
- 
+
 ```
-  
 
 ### `baremetal` :
+
 ```
  Usage: underpost baremetal [options] [workflow-id] [hostname] [ip-address]
 
@@ -703,6 +706,5 @@ Options:
                                  baremetal operations.
   --ls                           Lists available boot resources and machines.
   -h, --help                     display help for command
- 
+
 ```
-  

package/conf.js

@@ -92,6 +92,16 @@ const DefaultConf = /**/ {
         { path: '/default-management', client: 'Default', ssr: 'Default' },
         { client: 'Default', ssr: 'Default', path: '/404', title: '404 Not Found' },
         { client: 'Default', ssr: 'Default', path: '/500', title: '500 Server Error' },
+        {
+          path: '/blog',
+          client: 'Default',
+          ssr: 'Default',
+        },
+        {
+          path: '/chat',
+          client: 'Default',
+          ssr: 'Default',
+        },
       ],
       dists: [
         {
@@ -108,7 +118,22 @@ const DefaultConf = /**/ {
           import_name_build: '/dist/sortablejs/sortable.complete.esm.js',
         },
         { folder: './node_modules/validator', public_folder: '/dist/validator' },
-        { folder: './node_modules/@loadingio/css-spinner/entries', public_folder: '/dist/loadingio' },
+        {
+          folder: './node_modules/easymde/dist',
+          public_folder: '/dist/easymde',
+        },
+        {
+          folder: './node_modules/marked/lib',
+          public_folder: '/dist/marked',
+          import_name: 'marked',
+          import_name_build: '/dist/marked/marked.esm.js',
+        },
+        {
+          folder: './node_modules/vanilla-jsoneditor/standalone.js',
+          public_folder: '/dist/vanilla-jsoneditor/standalone.js',
+          import_name: 'vanilla-jsoneditor',
+          import_name_build: '/dist/vanilla-jsoneditor/standalone.js',
+        },
         {
           import_name: 'ag-grid-community',
           import_name_build: '/dist/ag-grid-community/ag-grid-community.min.js',
@@ -125,7 +150,7 @@ const DefaultConf = /**/ {
         },
         { folder: './node_modules/peerjs/dist', public_folder: '/dist/peerjs' },
       ],
-      services: ['default', 'core', 'user', 'test', 'file'],
+      services: ['default', 'core', 'user', 'test', 'file', 'document'],
     },
   },
   ssr: {
@@ -145,7 +170,7 @@ const DefaultConf = /**/ {
       '/': {
         client: 'default',
         runtime: 'nodejs',
-        apis: ['default', 'core', 'user', 'test', 'file'],
+        apis: ['default', 'core', 'user', 'test', 'file', 'document'],
         origins: [],
         minifyBuild: false,
         iconsBuild: false,

package/manifests/deployment/dd-default-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-blue
-          image: localhost/rockylinux9-underpost:v2.8.878
+          image: localhost/rockylinux9-underpost:v2.8.881
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.8.878
+          image: localhost/rockylinux9-underpost:v2.8.881
           #          resources:
           #            requests:
           #              memory: "124Ki"

package/manifests/deployment/dd-test-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.8.878
+          image: localhost/rockylinux9-underpost:v2.8.881
 #          resources:
 #            requests:
 #              memory: "94Ki"
@@ -104,7 +104,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.8.878
+          image: localhost/rockylinux9-underpost:v2.8.881
 #          resources:
 #            requests:
 #              memory: "94Ki"

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.8.878",
+    "version": "2.8.881",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
@@ -51,7 +51,6 @@
     "dependencies": {
         "@fortawesome/fontawesome-free": "^6.4.2",
         "@fullcalendar/rrule": "^6.1.15",
-        "@loadingio/css-spinner": "^2.0.2",
         "@neodrag/vanilla": "^2.0.3",
         "adm-zip": "^0.5.10",
         "ag-grid-community": "^31.3.4",

package/src/api/document/document.controller.js

@@ -0,0 +1,66 @@
+import { loggerFactory } from '../../server/logger.js';
+import { DocumentService } from './document.service.js';
+const logger = loggerFactory(import.meta);
+
+const DocumentController = {
+  post: async (req, res, options) => {
+    try {
+      return res.status(200).json({
+        status: 'success',
+        data: await DocumentService.post(req, res, options),
+      });
+    } catch (error) {
+      logger.error(error, error.stack);
+      return res.status(400).json({
+        status: 'error',
+        message: error.message,
+      });
+    }
+  },
+  get: async (req, res, options) => {
+    try {
+      return res.status(200).json({
+        status: 'success',
+        data: await DocumentService.get(req, res, options),
+      });
+    } catch (error) {
+      logger.error(error, error.stack);
+      return res.status(400).json({
+        status: 'error',
+        message: error.message,
+      });
+    }
+  },
+  delete: async (req, res, options) => {
+    try {
+      const result = await DocumentService.delete(req, res, options);
+      return res.status(200).json({
+        status: 'success',
+        data: result,
+      });
+    } catch (error) {
+      logger.error(error, error.stack);
+      return res.status(400).json({
+        status: 'error',
+        message: error.message,
+      });
+    }
+  },
+  put: async (req, res, options) => {
+    try {
+      const result = await DocumentService.put(req, res, options);
+      return res.status(200).json({
+        status: 'success',
+        data: result,
+      });
+    } catch (error) {
+      logger.error(error, error.stack);
+      return res.status(400).json({
+        status: 'error',
+        message: error.message,
+      });
+    }
+  },
+};
+
+export { DocumentController };

package/src/api/document/document.model.js

@@ -0,0 +1,51 @@
+import { Schema, model, Types } from 'mongoose';
+
+// https://mongoosejs.com/docs/2.7.x/docs/schematypes.html
+
+const DocumentSchema = new Schema(
+  {
+    userId: {
+      type: Schema.Types.ObjectId,
+      ref: 'User',
+    },
+    location: { type: String },
+    title: { type: String },
+    tags: [{ type: String }],
+    fileId: {
+      type: Schema.Types.ObjectId,
+      ref: 'File',
+    },
+    mdFileId: {
+      type: Schema.Types.ObjectId,
+      ref: 'File',
+    },
+  },
+  {
+    timestamps: true,
+  },
+);
+
+const DocumentModel = model('Document', DocumentSchema);
+
+const ProviderSchema = DocumentSchema;
+
+const DocumentDto = {
+  populate: {
+    file: () => {
+      return {
+        path: 'fileId',
+        model: 'File',
+        select: '_id name mimetype',
+      };
+    },
+    user: () => {
+      return {
+        path: 'userId',
+        model: 'User',
+        select: '_id email username',
+      };
+    },
+  },
+};
+
+export { DocumentSchema, DocumentModel, ProviderSchema, DocumentDto };

package/src/api/document/document.router.js

@@ -0,0 +1,24 @@
+import { loggerFactory } from '../../server/logger.js';
+import { DocumentController } from './document.controller.js';
+import express from 'express';
+import fs from 'fs-extra';
+const logger = loggerFactory(import.meta);
+
+const DocumentRouter = (options) => {
+  const router = express.Router();
+  const authMiddleware = options.authMiddleware;
+  router.post(`/:id`, authMiddleware, async (req, res) => await DocumentController.post(req, res, options));
+  router.post(`/`, authMiddleware, async (req, res) => await DocumentController.post(req, res, options));
+  router.get(`/public`, async (req, res) => await DocumentController.get(req, res, options));
+  router.get(`/:id`, authMiddleware, async (req, res) => await DocumentController.get(req, res, options));
+  router.get(`/`, authMiddleware, async (req, res) => await DocumentController.get(req, res, options));
+  router.put(`/:id`, authMiddleware, async (req, res) => await DocumentController.put(req, res, options));
+  router.put(`/`, authMiddleware, async (req, res) => await DocumentController.put(req, res, options));
+  router.delete(`/:id`, authMiddleware, async (req, res) => await DocumentController.delete(req, res, options));
+  router.delete(`/`, authMiddleware, async (req, res) => await DocumentController.delete(req, res, options));
+  return router;
+};
+
+const ApiRouter = DocumentRouter;
+
+export { ApiRouter, DocumentRouter };