cyberia 3.2.9 → 3.2.22

package/package.json

@@ -2,12 +2,13 @@
     "type": "module",
     "main": "src/index.js",
     "name": "cyberia",
-    "version": "3.2.9",
-    "description": "Cyberia Engine - Object Layer and Assets Management Microservice",
+    "version": "3.2.22",
+    "description": "Cyberia CLI — toolchain for the Cyberia MMO data layer, content pipeline, persistence, gRPC services, and ERC-1155 lifecycle on Hyperledger Besu.",
     "scripts": {
         "start": "node --max-old-space-size=8192 src/server",
         "build": "node bin client",
         "test": "NODE_ENV=test c8 mocha",
+        "test:monitor": "NODE_ENV=test c8 mocha test/deploy-monitor.test.js",
         "dev": "NODE_ENV=development nodemon src/server",
         "dev:container": "NODE_ENV=development node src/server",
         "prod:container": "NODE_ENV=production node src/server",
@@ -36,11 +37,21 @@
     },
     "keywords": [
         "cyberia",
+        "cyberia-cli",
+        "engine-cyberia",
+        "sidecar",
+        "data-layer",
         "object-layer",
-        "game-engine",
-        "assets-management",
+        "atlas-sprite-sheet",
+        "ipfs",
+        "erc-1155",
+        "object-layer-token",
+        "hardhat",
+        "hyperledger-besu",
+        "blockchain",
         "web3",
-        "atlas-sprite-sheet"
+        "underpost-platform",
+        "mmorpg"
     ],
     "author": "https://github.com/underpostnet",
     "license": "MIT",
@@ -51,35 +62,36 @@
     "dependencies": {
         "@fortawesome/fontawesome-free": "^7.2.0",
         "@fullcalendar/rrule": "^6.1.20",
-        "@grpc/grpc-js": "^1.12.5",
-        "@grpc/proto-loader": "^0.8.0",
+        "@grpc/grpc-js": "^1.14.4",
+        "@grpc/proto-loader": "^0.8.1",
         "@neodrag/vanilla": "^2.3.1",
         "adm-zip": "^0.5.17",
-        "ag-grid-community": "^35.2.1",
-        "axios": "^1.16.0",
+        "ag-grid-community": "^35.3.0",
+        "axios": "^1.16.1",
+        "bumpp": "^11.1.0",
         "chai": "^6.2.2",
         "clipboardy": "^5.3.1",
         "cloudinary": "^2.10.0",
         "colors": "^1.4.0",
-        "commander": "^14.0.3",
+        "commander": "^15.0.0",
         "compression": "^1.7.4",
         "cookie-parser": "^1.4.7",
         "cors": "^2.8.6",
         "d3": "^7.9.0",
-        "dexie": "^4.2.1",
+        "dexie": "^4.4.3",
         "dotenv": "^17.4.2",
         "easymde": "^2.21.0",
         "esbuild": "^0.28.0",
         "escape-string-regexp": "^5.0.0",
         "express": "^5.2.1",
         "express-fileupload": "^1.4.3",
-        "express-rate-limit": "^8.4.1",
+        "express-rate-limit": "^8.5.2",
         "express-slow-down": "^3.1.0",
         "fast-json-stable-stringify": "^2.1.0",
-        "favicons": "^7.2.0",
+        "favicons": "^7.3.0",
         "fs-extra": "^11.3.5",
         "fullcalendar": "^6.1.15",
-        "helmet": "^8.1.0",
+        "helmet": "^8.2.0",
         "html-minifier-terser": "^7.2.0",
         "http-proxy-middleware": "^4.0.0",
         "ignore-walk": "^9.0.0",
@@ -87,16 +99,16 @@
         "json-colorizer": "^3.0.1",
         "jsonwebtoken": "^9.0.3",
         "mariadb": "^3.2.2",
-        "marked": "^18.0.3",
-        "mocha": "^11.3.0",
-        "mongoose": "^9.6.2",
+        "mocha": "^11.7.6",
+        "marked": "^18.0.4",
+        "mongoose": "^9.6.3",
         "morgan": "^1.10.0",
-        "nodemailer": "^8.0.7",
+        "nodemailer": "^8.0.10",
         "nodemon": "^3.0.1",
         "peer": "^1.0.2",
         "peerjs": "^1.5.5",
         "prom-client": "^15.1.2",
-        "read": "^5.0.1",
+        "read": "^6.0.0",
         "rrule": "^2.8.1",
         "shelljs": "^0.10.0",
         "sitemap": "^9.0.1",

package/scripts/ipxe-setup.sh

@@ -14,39 +14,39 @@ REBUILD=false
 EMBED_SCRIPT=""
 
 while [[ $# -gt 0 ]]; do
-  case $1 in
-    --rebuild)
-      REBUILD=true
-      shift # past argument
-      ;;
-    --target-arch)
-      case "$2" in
-        arm64)
-          TARGET_ARCH="aarch64"
-          ;;
-        amd64)
-          TARGET_ARCH="x86_64"
-          ;;
+    case $1 in
+        --rebuild)
+            REBUILD=true
+            shift # past argument
+        ;;
+        --target-arch)
+            case "$2" in
+                arm64)
+                    TARGET_ARCH="aarch64"
+                ;;
+                amd64)
+                    TARGET_ARCH="x86_64"
+                ;;
+                *)
+                    echo "Error: Unsupported architecture '$2'. Use 'arm64' or 'amd64'."
+                    exit 1
+                ;;
+            esac
+            shift # past argument
+            shift # past value
+        ;;
+        --embed-script)
+            EMBED_SCRIPT="$2"
+            shift # past argument
+            shift # past value
+        ;;
         *)
-          echo "Error: Unsupported architecture '$2'. Use 'arm64' or 'amd64'."
-          exit 1
-          ;;
-      esac
-      shift # past argument
-      shift # past value
-      ;;
-    --embed-script)
-      EMBED_SCRIPT="$2"
-      shift # past argument
-      shift # past value
-      ;;
-    *)
-      if [ -z "$TARGET_DIR_ARG" ]; then
-          TARGET_DIR_ARG="$1"
-      fi
-      shift # past argument
-      ;;
-  esac
+            if [ -z "$TARGET_DIR_ARG" ]; then
+                TARGET_DIR_ARG="$1"
+            fi
+            shift # past argument
+        ;;
+    esac
 done
 
 # Use argument if provided, otherwise env var, otherwise current dir
@@ -64,7 +64,7 @@ echo "Embed Script:        ${EMBED_SCRIPT:-none}"
 # Determine iPXE build target based on requested architecture
 if [ "$TARGET_ARCH" = "aarch64" ]; then
     BUILD_TARGET="bin-arm64-efi/ipxe.efi"
-elif [ "$TARGET_ARCH" = "x86_64" ]; then
+    elif [ "$TARGET_ARCH" = "x86_64" ]; then
     BUILD_TARGET="bin-x86_64-efi/ipxe.efi"
 else
     echo "Error: Unsupported target architecture '$TARGET_ARCH'"
@@ -79,49 +79,50 @@ DO_BUILD=false
 
 if [ "$REBUILD" = true ]; then
     DO_BUILD=true
-elif [ ! -f "$COMPILED_SRC_PATH" ]; then
+    elif [ ! -f "$COMPILED_SRC_PATH" ]; then
     echo "Binary not found at $COMPILED_SRC_PATH. Initiating build..."
     DO_BUILD=true
+    
 else
-    echo "Binary found at $COMPILED_SRC_PATH. Skipping build."
+    echo "Binary found at $COMPILED_SRC_PATH with matching embedded script. Skipping build."
 fi
 
 if [ "$DO_BUILD" = true ]; then
-
+    
     # Helper function for package manager
     if command -v dnf &> /dev/null; then
         PKG_MGR="dnf"
     else
         PKG_MGR="yum"
     fi
-
+    
     # --- 2. Install Dependencies (RHEL/CentOS/Fedora) ---
     echo ""
     echo "--- Installing Build Dependencies ---"
     echo "Requesting sudo permissions..."
-
+    
     COMMON_PKGS="git make binutils-devel xz-devel perl"
-
+    
     # Logic to determine if we need native or cross-compilers
     if [ "$HOST_ARCH" = "$TARGET_ARCH" ]; then
         # Native compilation
         echo "Architecture match ($HOST_ARCH). Installing native GCC..."
         sudo $PKG_MGR install -y $COMMON_PKGS gcc
         CROSS_COMPILE_PREFIX=""
-
-    elif [ "$HOST_ARCH" = "x86_64" ] && [ "$TARGET_ARCH" = "aarch64" ]; then
+        
+        elif [ "$HOST_ARCH" = "x86_64" ] && [ "$TARGET_ARCH" = "aarch64" ]; then
         # Cross-compilation: x86_64 host -> aarch64 target
         echo "Cross-compiling for $TARGET_ARCH on $HOST_ARCH..."
         # Note: Ensure EPEL repo is enabled on RHEL/CentOS for this package
         sudo $PKG_MGR install -y $COMMON_PKGS gcc-aarch64-linux-gnu
         CROSS_COMPILE_PREFIX="aarch64-linux-gnu-"
-
+        
     else
         echo "Error: No automated path defined for Host: $HOST_ARCH -> Target: $TARGET_ARCH"
         echo "You may need to install specific cross-compilers manually."
         exit 1
     fi
-
+    
     # --- 3. Clone iPXE Source ---
     echo ""
     echo "--- Downloading iPXE Source Code ---"
@@ -133,15 +134,15 @@ if [ "$DO_BUILD" = true ]; then
         git clone https://github.com/ipxe/ipxe.git $IPXE_SRC_DIR
         cd $IPXE_SRC_DIR
     fi
-
+    
     # --- 4. Compile the Binary ---
     echo ""
     echo "--- Compiling $EFI_FILENAME for $TARGET_ARCH ---"
     cd src
-
+    
     # Clean previous builds to ensure no arch mismatch
     make clean
-
+    
     # Build with embedded script if provided
     if [ -n "$EMBED_SCRIPT" ]; then
         echo "Embedding script into iPXE binary..."
@@ -155,7 +156,7 @@ if [ "$DO_BUILD" = true ]; then
         echo "Running make for target: $BUILD_TARGET..."
         make CROSS_COMPILE=$CROSS_COMPILE_PREFIX $BUILD_TARGET
     fi
-
+    
     if [ $? -ne 0 ]; then
         echo "Error: Compilation failed."
         if [ -n "$CROSS_COMPILE_PREFIX" ]; then
@@ -163,6 +164,8 @@ if [ "$DO_BUILD" = true ]; then
         fi
         exit 1
     fi
+    
+    
 fi
 
 # --- 5. Deploy Binary ---
@@ -176,10 +179,10 @@ if [ -f "$COMPILED_SRC_PATH" ]; then
         echo "Creating target directory: $TARGET_DIR"
         mkdir -p "$TARGET_DIR"
     fi
-
+    
     echo "Copying $COMPILED_SRC_PATH to $TARGET_DIR/$EFI_FILENAME..."
     cp "$COMPILED_SRC_PATH" "$TARGET_DIR/$EFI_FILENAME"
-
+    
     if [ $? -eq 0 ]; then
         echo "✓ Success!"
         echo "---------------------------------------------------"

package/scripts/k3s-node-setup.sh

@@ -1,39 +1,70 @@
 #!/bin/bash
-set -e
+set -euo pipefail
 
 # ---------------------------------------------------------------------------
 # Underpost K3s Node Setup
+#
+# This script runs INSIDE an LXD VM. It assumes the host has already mirrored
+# the project source into $ENGINE_ROOT (default /home/dd/engine) via the
+# `underpost lxd [vm-id] --vm-init` flow in `src/cli/lxd.js`. There is no
+# fallback to a globally installed `underpost`: every operational command
+# resolves from the local project so the latest local changes are always what
+# runs in the VM.
+#
 # Usage:
-#   --control                   Initialize as K3s control plane node (default)
-#   --worker                    Initialize as K3s worker node
-#   --control-ip=<ip>           Control plane IP (required for --worker)
-#   --token=<token>             K3s node token (required for --worker)
+#   --engine-root=<path>   Path to the mirrored engine source (default: /home/dd/engine)
+#   --control              Initialize as K3s control plane node (default)
+#   --worker               Initialize as K3s worker node
+#   --control-ip=<ip>      Control plane IP (required for --worker)
+#   --token=<token>        K3s node token (required for --worker)
 # ---------------------------------------------------------------------------
 
 ROLE="control"
 CONTROL_IP=""
 K3S_TOKEN=""
+ENGINE_ROOT="/home/dd/engine"
 
 for arg in "$@"; do
-  case $arg in
-    --worker)         ROLE="worker" ;;
-    --control)        ROLE="control" ;;
-    --control-ip=*)   CONTROL_IP="${arg#*=}" ;;
-    --token=*)        K3S_TOKEN="${arg#*=}" ;;
-  esac
+    case $arg in
+        --worker)         ROLE="worker" ;;
+        --control)        ROLE="control" ;;
+        --control-ip=*)   CONTROL_IP="${arg#*=}" ;;
+        --token=*)        K3S_TOKEN="${arg#*=}" ;;
+        --engine-root=*)  ENGINE_ROOT="${arg#*=}" ;;
+    esac
 done
+
+# Fail fast if the bootstrap step did not run / left the directory empty.
+# Split into two checks so `ls -A` only runs against a path that exists; this
+# avoids needing an error-swallowing redirect.
+if [ ! -d "$ENGINE_ROOT" ]; then
+    echo "ERROR: engine source directory $ENGINE_ROOT does not exist."
+    echo "The LXD [vm-id] --vm-init flow must mirror the project here before running this script."
+    exit 1
+fi
+if [ -z "$(ls -A "$ENGINE_ROOT")" ]; then
+    echo "ERROR: engine source directory $ENGINE_ROOT is empty."
+    echo "The LXD [vm-id] --vm-init flow must mirror the project here before running this script."
+    exit 1
+fi
+
 # ---------------------------------------------------------------------------
-# NVM and Node.js
+# NVM and Node.js — required for `node bin ...` entrypoints
 # ---------------------------------------------------------------------------
-echo "Installing NVM and Node.js v24.10.0..."
+echo "Installing NVM and Node.js v24.15.0..."
 
 curl -o- https://cdn.jsdelivr.net/gh/nvm-sh/nvm@v0.40.1/install.sh | bash
 
 export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
+# shellcheck disable=SC1090
 [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
 
 nvm install 24.15.0
 nvm use 24.15.0
+nvm alias default 24.15.0
+ln -sf "$(command -v node)" /usr/local/bin/node
+ln -sf "$(command -v npm)" /usr/local/bin/npm
+ln -sf "$(command -v npx)" /usr/local/bin/npx
 
 echo "
 ██╗░░░██╗███╗░░██╗██████╗░███████╗██████╗░██████╗░░█████╗░░██████╗████████╗
@@ -43,47 +74,51 @@ echo "
 ╚██████╔╝██║░╚███║██████╔╝███████╗██║░░██║██║░░░░░╚█████╔╝██████╔╝░░░██║░░░
 ░╚═════╝░╚═╝░░╚══╝╚═════╝░╚══════╝╚═╝░░╚═╝╚═╝░░░░░░╚════╝░╚═════╝░░░░╚═╝░░░
 
-Installing underpost VM node...
+Bringing up underpost VM node from $ENGINE_ROOT (role=$ROLE)
 "
 
-npm install -g underpost
-
-cd /home/dd/engine
-
-echo "Applying host configuration..."
+cd "$ENGINE_ROOT"
 
+# Install JS deps and generate secrets using the local engine entrypoint only.
 npm install
-
 node bin run secret
 
-node bin cluster --dev --config
-
 if [ "$ROLE" = "control" ]; then
-  echo "Initializing K3s control plane..."
-  node bin cluster --dev --k3s
-
-  echo ""
-  echo "K3s control plane is ready."
-  echo "Node token (share with workers to join this cluster):"
-  sudo cat /var/lib/rancher/k3s/server/node-token
-  echo ""
-  echo "Control plane IP addresses:"
-  ip -4 addr show scope global | grep inet | awk '{print $2}' | cut -d/ -f1
-
-elif [ "$ROLE" = "worker" ]; then
-  if [ -z "$CONTROL_IP" ] || [ -z "$K3S_TOKEN" ]; then
-    echo "ERROR: --control-ip and --token are required for worker role."
-    echo "Usage: bash k3s-node-setup.sh --worker --control-ip=<ip> --token=<token>"
-    exit 1
-  fi
-
-  echo "Joining K3s cluster at https://${CONTROL_IP}:6443..."
-  curl -sfL https://get.k3s.io | \
+    echo "Installing underpost CLI..."
+    npm install -g underpost
+    underpost --version
+    echo "Initializing K3s control plane via local engine..."
+    node bin cluster --dev --k3s
+    ln -s /usr/local/bin/k3s /bin/k3s
+    ln -s /usr/local/bin/kubectl /bin/kubectl
+    
+    echo ""
+    echo "K3s control plane is ready."
+    echo "Node token (share with workers to join this cluster):"
+    sudo cat /var/lib/rancher/k3s/server/node-token
+    echo ""
+    echo "Control plane IP addresses:"
+    ip -4 addr show scope global | grep inet | awk '{print $2}' | cut -d/ -f1
+    
+    elif [ "$ROLE" = "worker" ]; then
+    if [ -z "$CONTROL_IP" ] || [ -z "$K3S_TOKEN" ]; then
+        echo "ERROR: --control-ip and --token are required for worker role."
+        echo "Usage: bash k3s-node-setup.sh --worker --control-ip=<ip> --token=<token>"
+        exit 1
+    fi
+    
+    # Worker nodes still need the minimal K3s host prep even though they join via
+    # the upstream installer rather than `node bin cluster --k3s`.
+    echo "Applying minimal K3s host configuration via local engine..."
+    node bin cluster --dev --config --k3s
+    
+    echo "Joining K3s cluster at https://${CONTROL_IP}:6443..."
+    curl -sfL https://get.k3s.io | \
     K3S_URL="https://${CONTROL_IP}:6443" \
     K3S_TOKEN="${K3S_TOKEN}" \
     sh -s - agent
-
-  echo ""
-  echo "K3s worker node joined the cluster at https://${CONTROL_IP}:6443 successfully."
-  sudo systemctl status k3s-agent --no-pager
+    
+    echo ""
+    echo "K3s worker joined https://${CONTROL_IP}:6443 successfully."
+    sudo systemctl status k3s-agent --no-pager
 fi

package/scripts/link-local-underpost-cli.sh

@@ -0,0 +1,6 @@
+
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd /home/dd && underpost clone underpostnet/pwa-microservices-template
+cd /home/dd/pwa-microservices-template && npm install && npm link