underpost 2.95.3 → 2.96.0

package/README.md

@@ -18,7 +18,7 @@
 
 <!-- badges -->
 
-[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.95.3)](https://socket.dev/npm/package/underpost/overview/2.95.3) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
+[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.96.0)](https://socket.dev/npm/package/underpost/overview/2.96.0) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
 
 <!-- end-badges -->
 
@@ -66,7 +66,7 @@ Run dev client server
 npm run dev
 ```
 <!-- -->
-## underpost ci/cd cli v2.95.3
+## underpost ci/cd cli v2.96.0
 
 ### Usage: `underpost [options] [command]`
   ```

package/baremetal/commission-workflows.json

@@ -0,0 +1,44 @@
+{
+  "rpi4mb": {
+    "menuentryStr": "UNDERPOST.NET UEFI/GRUB/MAAS RPi4 commissioning (ARM64)",
+    "systemProvisioning": "ubuntu",
+    "kernelLibVersion": "6.8.0-41-generic",
+    "networkInterfaceName": "enabcm6e4ei0",
+    "netmask": "255.255.255.0",
+    "firmwares": [
+      {
+        "url": "https://github.com/pftf/RPi4/releases/download/v1.41/RPi4_UEFI_Firmware_v1.41.zip",
+        "gateway": "192.168.1.1",
+        "subnet": "255.255.255.0"
+      }
+    ],
+    "chronyc": {
+      "timezone": "America/New_York",
+      "chronyConfPath": "/etc/chrony/chrony.conf"
+    },
+    "debootstrap": {
+      "image": {
+        "architecture": "arm64",
+        "name": "noble"
+      }
+    },
+    "maas": {
+      "image": {
+        "architecture": "arm64/ga-24.04",
+        "name": "ubuntu/noble"
+      }
+    },
+    "nfs": {
+      "mounts": {
+        "bind": [
+          "/proc",
+          "/sys",
+          "/run"
+        ],
+        "rbind": [
+          "/dev"
+        ]
+      }
+    }
+  }
+}

package/baremetal/packer-workflows.json

@@ -0,0 +1,13 @@
+{
+  "Rocky9Amd64": {
+    "dir": "packer/images/Rocky9Amd64",
+    "maas": {
+      "name": "custom/rocky9",
+      "title": "Rocky 9 Custom",
+      "architecture": "amd64/generic",
+      "base_image": "rhel/9",
+      "filetype": "tgz",
+      "content": "rocky9.tar.gz"
+    }
+  }
+}

package/bin/deploy.js

@@ -27,6 +27,7 @@ import { buildClient } from '../src/server/client-build.js';
 import colors from 'colors';
 import { program } from '../src/cli/index.js';
 import { timer } from '../src/client/components/core/CommonJs.js';
+import Underpost from '../src/index.js';
 
 colors.enable();
 
@@ -364,23 +365,10 @@ try {
       break;
     }
 
-    case 'clean-core-repo': {
-      shellCd(`/home/dd/engine`);
-      shellExec(`git reset`);
-      shellExec(`git checkout .`);
-      shellExec(`git clean -f -d`);
-      shellCd(`/home/dd/engine/engine-private`);
-      shellExec(`git reset`);
-      shellExec(`git checkout .`);
-      shellExec(`git clean -f -d`);
-      shellCd(`/home/dd/engine`);
-      break;
-    }
-
     case 'version-build': {
       dotenv.config({ path: `./engine-private/conf/dd-cron/.env.production`, override: true });
       shellCd(`/home/dd/engine`);
-      shellExec(`node bin/deploy clean-core-repo`);
+      Underpost.repo.clean({ paths: ['/home/dd/engine', '/home/dd/engine/engine-private '] });
       shellExec(`node bin pull . ${process.env.GITHUB_USERNAME}/engine`);
       shellExec(`node bin run kill 4001`);
       shellExec(`node bin run kill 4002`);
@@ -399,7 +387,7 @@ try {
         break;
       }
       shellCd(`/home/dd/engine`);
-      shellExec(`node bin/deploy clean-core-repo`);
+      Underpost.repo.clean({ paths: ['/home/dd/engine', '/home/dd/engine/engine-private '] });
       const originPackageJson = JSON.parse(fs.readFileSync(`package.json`, 'utf8'));
       const newVersion = process.argv[3] ?? originPackageJson.version;
       const node = process.argv[4] ?? 'kind-control-plane';
@@ -483,14 +471,6 @@ try {
       break;
     }
 
-    case 'private': {
-      shellExec(`node bin/deploy sync-deploy-envs`);
-      shellExec(`node bin/build dd conf`);
-      shellExec(`cd ./engine-private && git add . && node ../bin cmt . build`);
-      shellExec(`cd ./engine-private && node ../bin push . ${process.env.GITHUB_USERNAME}/engine-private`);
-      break;
-    }
-
     case 'version-deploy': {
       dotenv.config({ path: `./engine-private/conf/dd-cron/.env.production`, override: true });
       shellExec(
@@ -1046,15 +1026,15 @@ nvidia/gpu-operator \
     case 'update-static-guide': {
       fs.writeFileSync(
         `src/client/public/nexodev/docs/references/Static Site Generator Quick Reference.md`,
-        fs.readFileSync(`examples/QUICK-REFERENCE.md`, 'utf8'),
+        fs.readFileSync(`examples/static-page/QUICK-REFERENCE.md`, 'utf8'),
       );
       fs.writeFileSync(
         `src/client/public/nexodev/docs/references/Static Site Generator Examples.md`,
-        fs.readFileSync(`examples/README.md`, 'utf8'),
+        fs.readFileSync(`examples/static-page/README.md`, 'utf8'),
       );
       fs.writeFileSync(
         `src/client/public/nexodev/docs/references/Static Generator Guide.md`,
-        fs.readFileSync(`examples/STATIC-GENERATOR-GUIDE.md`, 'utf8'),
+        fs.readFileSync(`examples/static-page/STATIC-GENERATOR-GUIDE.md`, 'utf8'),
       );
       break;
     }

package/cli.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v2.95.3
+## underpost ci/cd cli v2.96.0
 
 ### Usage: `underpost [options] [command]`
   ```
@@ -268,14 +268,16 @@ Options:
 Manages Underpost configurations using various operators.
 
 Arguments:
-  operator    The configuration operation to perform. Options: set, delete,
-              get, list, clean.
-  key         Optional: The specific configuration key to manage.
-  value       Optional: The value to set for the configuration key.
+  operator            The configuration operation to perform. Options: set,
+                      delete, get, list, clean.
+  key                 Optional: The specific configuration key to manage.
+  value               Optional: The value to set for the configuration key.
 
 Options:
-  --plain     Prints the configuration value in plain text.
-  -h, --help  display help for command
+  --plain             Prints the configuration value in plain text.
+  --filter <keyword>  Filters the list by matching key or value (only for list
+                      operation).
+  -h, --help          display help for command
  
 ```
   
@@ -563,8 +565,6 @@ Options:
   --import                                   Imports container backups from specified repositories.
   --export                                   Exports container backups to specified repositories.
   --pod-name <pod-name>                      Comma-separated list of pod names or patterns (supports wildcards like "mariadb-*").
-  --node-name <node-name>                    Comma-separated list of node names to filter pods by their node placement.
-  --label-selector <selector>                Kubernetes label selector for filtering pods (e.g., "app=mariadb").
   --all-pods                                 Target all matching pods instead of just the first one.
   --primary-pod                              Automatically detect and use MongoDB primary pod (MongoDB only).
   --stats                                    Display database statistics (collection/table names with document/row counts).
@@ -640,16 +640,20 @@ Manages cron jobs, including initialization, execution, and configuration
 updates.
 
 Arguments:
-  deploy-list  A comma-separated list of deployment IDs (e.g.,
-               "default-a,default-b").
-  job-list     A comma-separated list of job IDs. Options: callback,
-               getRelatedDeployId. Defaults to all available jobs.
+  deploy-list               A comma-separated list of deployment IDs (e.g.,
+                            "default-a,default-b").
+  job-list                  A comma-separated list of job IDs. Options:
+                            callback, initCronJobs, updatePackageScripts,
+                            getRelatedDeployIdList. Defaults to all available
+                            jobs.
 
 Options:
-  --itc        Executes cron jobs within the container execution context.
-  --init       Initializes cron jobs for the default deployment ID.
-  --git        Uploads cron job configurations to GitHub.
-  -h, --help   display help for command
+  --init-pm2-cronjobs       Initializes PM2 cron jobs from configuration for
+                            the specified deployment IDs.
+  --git                     Uploads cron job configurations to GitHub.
+  --update-package-scripts  Updates package.json start scripts for each
+                            deploy-id configuration.
+  -h, --help                display help for command
  
 ```
   
@@ -896,32 +900,25 @@ Manages baremetal server operations, including installation, database setup,
 commissioning, and user management.
 
 Options:
-  --control-server-install       Installs the baremetal control server.
-  --control-server-uninstall     Uninstalls the baremetal control server.
-  --control-server-db-install    Installs up the database for the baremetal
-                                 control server.
-  --control-server-db-uninstall  Uninstalls the database for the baremetal
-                                 control server.
-  --commission                   Init workflow for commissioning a physical
-                                 machine.
-  --nfs-build                    Builds an NFS root filesystem for a workflow
-                                 id config architecture using QEMU emulation.
-  --nfs-mount                    Mounts the NFS root filesystem for a workflow
-                                 id config architecture.
-  --nfs-unmount                  Unmounts the NFS root filesystem for a
-                                 workflow id config architecture.
-  --nfs-sh                       Copies QEMU emulation root entrypoint shell
-                                 command to the clipboard.
-  --cloud-init-update            Updates cloud init for a workflow id config
-                                 architecture.
-  --cloud-init-reset             Resets cloud init for a workflow id config
-                                 architecture.
-  --logs <log-id>                Displays logs for log id: dhcp, cloud,
-                                 machine, cloud-config.
-  --dev                          Sets the development context environment for
-                                 baremetal operations.
-  --ls                           Lists available boot resources and machines.
-  -h, --help                     display help for command
+  --control-server-install                      Installs the baremetal control server.
+  --control-server-uninstall                    Uninstalls the baremetal control server.
+  --control-server-db-install                   Installs up the database for the baremetal control server.
+  --control-server-db-uninstall                 Uninstalls the database for the baremetal control server.
+  --install-packer                              Installs Packer CLI.
+  --packer-maas-image-template <template-path>  Creates a new image folder from canonical/packer-maas template path (requires workflow-id).
+  --packer-workflow-id <workflow-id>            Specifies the workflow ID for Packer MAAS image operations.
+  --packer-maas-image-build                     Builds a MAAS image using Packer for the workflow specified by --packer-workflow-id.
+  --packer-maas-image-upload                    Uploads an existing MAAS image artifact without rebuilding for the workflow specified by --packer-workflow-id.
+  --commission                                  Init workflow for commissioning a physical machine.
+  --nfs-build                                   Builds an NFS root filesystem for a workflow id config architecture using QEMU emulation.
+  --nfs-mount                                   Mounts the NFS root filesystem for a workflow id config architecture.
+  --nfs-unmount                                 Unmounts the NFS root filesystem for a workflow id config architecture.
+  --nfs-sh                                      Copies QEMU emulation root entrypoint shell command to the clipboard.
+  --cloud-init-update                           Updates cloud init for a workflow id config architecture.
+  --logs <log-id>                               Displays logs for log id: dhcp, cloud, machine, cloud-config.
+  --dev                                         Sets the development context environment for baremetal operations.
+  --ls                                          Lists available boot resources and machines.
+  -h, --help                                    display help for command
  
 ```
   

package/conf.js

@@ -211,7 +211,10 @@ const DefaultConf = /**/ {
   },
   cron: {
     records: { A: [{ host: 'example.com', dns: 'dondominio', api_key: '???', user: '???' }] },
-    jobs: { dns: { expression: '* * * * *', enabled: true }, backups: { expression: '0 1 * * *', enabled: true } },
+    jobs: {
+      dns: { expression: '* * * * *', enabled: true, instances: 1 },
+      backups: { expression: '0 1 * * *', enabled: true, instances: 1 },
+    },
   },
 }; /**/
 

package/examples/{QUICK-REFERENCE.md → static-page/QUICK-REFERENCE.md}

@@ -479,21 +479,3 @@ underpost static --config-file ./config.json
   ]
 }
 ```
-
-## Documentation Links
-
-- [Complete Guide](./STATIC-GENERATOR-GUIDE.md)
-- [Example Config](./static-config-example.json)
-- [Custom Component Example](./ssr-components/CustomPage.js)
-- [Examples README](./README.md)
-
-## Tips
-
-✅ Use config files for complex setups
-✅ Minify in production
-✅ Use async/defer for scripts
-✅ Include structured data for SEO
-✅ Test on multiple devices
-✅ Validate your JSON configs
-✅ Use semantic HTML in components
-✅ Include accessibility attributes

package/examples/{README.md → static-page/README.md}

@@ -10,7 +10,7 @@ This directory contains comprehensive examples and documentation for the Underpo
 
 ### Configuration Examples
 
-- **[static-config-example.json](./static-config-example.json)** - Fully documented configuration file template with all available options
+- **[static-config-example.json](./static-page/static-config-example.json)** - Fully documented configuration file template with all available options
 
 ### SSR Component Examples
 
@@ -68,7 +68,7 @@ underpost static \
 
 ```bash
 underpost static \
-  --page ./examples/ssr-components/CustomPage.js \
+  --page ./examples/static-page/ssr-components/CustomPage.js \
   --output-path ./dist/landing.html \
   --title "Welcome to My App" \
   --description "The best app for your needs" \
@@ -83,7 +83,7 @@ Use the provided `static-config-example.json`:
 
 ```bash
 # Copy the example
-cp ./examples/static-config-example.json ./my-config.json
+cp ./examples/static-page/static-config-example.json ./my-config.json
 
 # Edit with your settings
 nano ./my-config.json
@@ -404,44 +404,3 @@ for (const page of pages) {
   });
 }
 ```
-
-## Troubleshooting
-
-### Component Not Found
-
-**Error:** `Page component does not exist`
-
-**Solution:** Verify the path is correct and the file exists
-
-### Invalid JSON
-
-**Error:** `Error loading config file: Unexpected token`
-
-**Solution:** Validate your JSON using a linter or online validator
-
-### Missing Metadata
-
-**Warning:** No metadata generated
-
-**Solution:** Ensure metadata object is properly configured in your config
-
-## Getting Help
-
-- Read the [Complete Guide](./STATIC-GENERATOR-GUIDE.md)
-- Check the [example config](./static-config-example.json)
-- Review the [custom page example](./ssr-components/CustomPage.js)
-- Check the main project documentation
-
-## Contributing
-
-To add new examples:
-
-1. Create your example file
-2. Add comprehensive comments
-3. Update this README
-4. Test your example thoroughly
-5. Submit a pull request
-
-## License
-
-Part of the Underpost framework. See main project license.

package/examples/{STATIC-GENERATOR-GUIDE.md → static-page/STATIC-GENERATOR-GUIDE.md}

@@ -748,30 +748,6 @@ const config = ConfigLoader.load('./config.json');
 ConfigLoader.save('./config.json', configObject);
 ```
 
----
-
-## Troubleshooting
-
-### Common Issues
-
-**Issue: Component not found**
-```
-Error: Page component does not exist: ./src/client/ssr/body/Missing.js
-```
-**Solution:** Verify the path to your SSR component file.
-
-**Issue: Output directory doesn't exist**
-```
-Error: Output directory does not exist: ./dist/pages
-```
-**Solution:** Create the directory first or use a different output path.
-
-**Issue: Invalid JSON in config file**
-```
-Error: Error loading config file: Unexpected token
-```
-**Solution:** Validate your JSON syntax using a linter.
-
 ### Debug Mode
 
 Use `--dev` flag for development mode with additional logging:
@@ -779,29 +755,3 @@ Use `--dev` flag for development mode with additional logging:
 ```bash
 underpost static --config-file ./config.json --dev
 ```
-
----
-
-## Examples Repository
-
-See the `examples/` directory for complete working examples:
-
-- `static-config-example.json` - Comprehensive configuration example
-- Additional examples coming soon
-
----
-
-## Contributing
-
-To contribute improvements to the static generator:
-
-1. Add new features to `src/cli/static.js`
-2. Update this documentation
-3. Add examples to the `examples/` directory
-4. Include JSDoc comments for all new functions
-
----
-
-## License
-
-This is part of the Underpost framework. See main project license.

package/examples/{ssr-components → static-page/ssr-components}/CustomPage.js

@@ -5,19 +5,6 @@
  * @description
  * This is an example SSR component demonstrating best practices for creating
  * custom static pages with the Underpost Static Site Generator.
- *
- * @example
- * // Usage with static generator
- * underpost static \
- *   --page ./examples/ssr-components/CustomPage.js \
- *   --output-path ./dist/custom.html
- *
- * @example
- * // Usage in configuration file
- * {
- *   "page": "./examples/ssr-components/CustomPage.js",
- *   "outputPath": "./dist/custom.html"
- * }
  */
 
 /**

package/examples/{static-config-simple.json → static-page/static-config-example.json}

@@ -1,5 +1,5 @@
 {
-  "page": "./examples/ssr-components/CustomPage.js",
+  "page": "./examples/static-page/ssr-components/CustomPage.js",
   "outputPath": "./public/default.net/example.html",
   "env": "production",
   "minify": true,

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.95.3
+          image: localhost/rockylinux9-underpost:v2.96.0
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.95.3
+          image: localhost/rockylinux9-underpost:v2.96.0
           #          resources:
           #            requests:
           #              memory: "124Ki"

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

@@ -18,7 +18,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.95.3
+          image: localhost/rockylinux9-underpost:v2.96.0
 
           command:
             - /bin/sh
@@ -103,7 +103,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.95.3
+          image: localhost/rockylinux9-underpost:v2.96.0
 
           command:
             - /bin/sh

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.95.3",
+    "version": "2.96.0",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",

package/packer/images/Rocky9Amd64/Makefile

@@ -0,0 +1,62 @@
+#!/usr/bin/make -f
+
+include ../scripts/check.mk
+
+PACKER ?= packer
+PACKER_LOG ?= 0
+TIMEOUT ?= 1h
+ARCH ?= x86_64
+
+# Detect if running on ARM host
+ifeq ($(shell uname -m),aarch64)
+    HOST_IS_ARM = true
+else
+    HOST_IS_ARM = false
+endif
+
+ifeq ($(wildcard /usr/share/OVMF/OVMF_CODE.fd),)
+	OVMF_SFX ?= _4M
+else
+	OVMF_SFX ?=
+endif
+
+export PACKER_LOG
+
+# Fallback
+ifeq ($(strip $(ARCH)),amd64)
+	ARCH = x86_64
+endif
+
+.PHONY: all clean
+
+all: rocky9.tar.gz
+
+$(eval $(call check_packages_deps))
+
+lint:
+	packer validate .
+	packer fmt -check -diff .
+
+format:
+	packer fmt .
+
+OVMF_VARS.fd: /usr/share/OVMF/OVMF_VARS${OVMF_SFX}.fd
+	cp -v $< ${ARCH}_VARS.fd
+
+SIZE_VARS.fd:
+ifeq ($(strip $(ARCH)),aarch64)
+	truncate -s 64m ${ARCH}_VARS.fd
+else
+	truncate -s 2m ${ARCH}_VARS.fd
+endif
+
+rocky9.tar.gz: check-deps clean OVMF_VARS.fd SIZE_VARS.fd
+	${PACKER} init rocky9.pkr.hcl && ${PACKER} build \
+		-var architecture=${ARCH} \
+		-var host_is_arm=${HOST_IS_ARM} \
+		-var timeout=${TIMEOUT} \
+		-var ovmf_suffix=${OVMF_SFX} \
+		rocky9.pkr.hcl
+
+clean:
+	${RM} -rf *.fd output-rocky9 rocky9.tar.gz