@underpostnet/cyberia 3.3.0 → 3.3.76

package/compose.env

@@ -43,25 +43,37 @@ VALKEY_PORT=6379
 # cyberia-server-* -> stable engine gateway for HTTP and the raw engine runtime
 # for gRPC. The public engine-cyberia name belongs to nginx, avoiding ambiguous
 # Docker DNS while keeping one stable HTTP endpoint for every module.
-ENGINE_API_BASE_URL=http://engine-cyberia
-ENGINE_GRPC_ADDRESS=engine-cyberia-runtime:50051
+CYBERIA_DATA_SERVER_URL=http://engine-cyberia
+CYBERIA_DATA_SERVER_GRPC=engine-cyberia-runtime:50051
 
 # Client-visible Content Authority origin, forwarded to browser/Raylib clients
 # for every engine-cyberia content/asset/metadata request. Host-reachable
 # (Docker publishes the raw engine runtime on host :4005). Unlike the internal
-# ENGINE_API_BASE_URL, this value is consumed outside the Compose network:
+# CYBERIA_DATA_SERVER_URL, this value is consumed outside the Compose network:
 # the two responsibilities must never overwrite each other.
 ENGINE_PUBLIC_URL=http://localhost:4005
 ENGINE_GRPC_RELOAD_INTERVAL_SEC=300
 
-# --- Browser-facing client runtime config (injected by docker-driver.py) -----
+# Shared secret between the engine and every game server. It guards the server
+# registry report (server -> engine) and the hot-reload trigger (engine ->
+# server). Unset disables both: a server then stays out of the public list.
+CYBERIA_SERVER_API_KEY=change_me_dev_server_api_key
+
+# Public origin of the server gateway. Each server reports this origin plus its
+# own sub-path, which is the URL a client dials.
+CYBERIA_SERVER_PUBLIC_ORIGIN=http://localhost:8081
+
+# --- Browser-facing client runtime config (injected by wasm-driver.py) -----
 # The single WASM bundle resolves its instance from the URL sub-path and builds
 # its endpoints from these origins. HTTP client/API traffic uses nginx on :80;
 # WebSocket traffic uses the dedicated multi-path server gateway on :8081.
 #   http://localhost/          -> default, ws://localhost:8081/ws
 #   http://localhost/FOREST    -> FOREST,  ws://localhost:8081/FOREST/ws
 CYBERIA_WS_ORIGIN=ws://localhost:8081
-CYBERIA_ENGINE_API_ORIGIN=http://localhost
+# The browser's own route to the Data Server, through nginx on :80. Distinct from the internal
+# CYBERIA_DATA_SERVER_URL above: both name a Data Server origin, but from opposite sides of the
+# Compose network, and one file cannot hold two values under one name.
+CYBERIA_CLIENT_DATA_SERVER_URL=http://localhost
 CYBERIA_DEFAULT_INSTANCE=amethyst-strata-expansion
 
 # cyberia-server logging. This is the dev stack, so default to DEBUG. Set

package/conf.js

@@ -56,7 +56,7 @@ const DefaultConf = /**/ {
           'PublicProfile',
           'Scroll',
           'Auth',
-          'FullScreen',
+          'ViewModeController',
           'RichText',
           'CalendarCore',
           'D3Chart',
@@ -80,6 +80,7 @@ const DefaultConf = /**/ {
           'SocketIoHandler',
           'EventBus',
           'ClientEvents',
+          'Repository',
         ],
         underpost: [
           'AppShellUnderpost',
@@ -179,7 +180,6 @@ const DefaultConf = /**/ {
           'InstanceEngineCyberia',
           'ActionEngineCyberia',
           'EntityEngineCyberia',
-          'FallbackWorldEngineCyberia',
           'InstanceSelectionView',
         ],
         core: [
@@ -212,7 +212,7 @@ const DefaultConf = /**/ {
           'PublicProfile',
           'Scroll',
           'Auth',
-          'FullScreen',
+          'ViewModeController',
           'CssCore',
           'Worker',
           'SocketIo',
@@ -232,6 +232,7 @@ const DefaultConf = /**/ {
           'ColorPaletteElement',
           'EventBus',
           'ClientEvents',
+          'Repository',
         ],
         'cyberia-portal': [
           'AppShellCyberiaPortal',
@@ -306,6 +307,10 @@ const DefaultConf = /**/ {
           styles: './node_modules/vanilla-jsoneditor/themes',
           public_styles_folder: '/styles/vanilla-jsoneditor',
         },
+        {
+          folder: './node_modules/vanilla-jsoneditor/standalone.js.map',
+          public_folder: '/dist/vanilla-jsoneditor/standalone.js.map',
+        },
         {
           folder: './node_modules/dexie/dist',
           public_folder: '/dist/dexie',
@@ -379,7 +384,7 @@ const DefaultConf = /**/ {
           'PublicProfile',
           'Scroll',
           'Auth',
-          'FullScreen',
+          'ViewModeController',
           'RichText',
           'CalendarCore',
           'D3Chart',
@@ -400,6 +405,7 @@ const DefaultConf = /**/ {
           'SocketIoHandler',
           'EventBus',
           'ClientEvents',
+          'Repository',
         ],
         cryptokoyn: [
           'AppShellCryptokoyn',
@@ -503,7 +509,7 @@ const DefaultConf = /**/ {
           'PublicProfile',
           'Scroll',
           'Auth',
-          'FullScreen',
+          'ViewModeController',
           'RichText',
           'CalendarCore',
           'D3Chart',
@@ -524,6 +530,7 @@ const DefaultConf = /**/ {
           'SocketIoHandler',
           'EventBus',
           'ClientEvents',
+          'Repository',
         ],
         itemledger: [
           'AppShellItemledger',
@@ -757,13 +764,17 @@ const DefaultConf = /**/ {
           'cyberia-entity-type-default',
           'cyberia-client-hints',
           'cyberia-saga',
+          'cyberia-audio',
+          'cyberia-map-audio-conf',
         ],
         ws: 'core',
         peer: true,
         docs: {
-          coveragePath: './hardhat',
           jsJsonPath: './typedoc.dd-cyberia.json',
-          coverageOutputDir: 'hardhat-coverage',
+          coverage: [
+            { id: 'cyberia', label: 'Cyberia coverage', suite: 'cyberia' },
+            { id: 'hardhat', label: 'Hardhat coverage', path: './hardhat' },
+          ],
           references: [
             './src/client/public/cyberia-docs/CYBERIA.md',
             './src/client/public/cyberia-docs/WHITE-PAPER.md',
@@ -771,6 +782,7 @@ const DefaultConf = /**/ {
             './src/client/public/cyberia-docs/QUEST-SYSTEM.md',
             './src/client/public/cyberia-docs/ACTION-SYSTEM.md',
             './src/client/public/cyberia-docs/ENTITY-PROFILE.md',
+            './src/client/public/cyberia-docs/STATS-PROGRESSION.md',
             './src/client/public/cyberia-docs/OFF-CHAIN-ECONOMY.md',
             './src/client/public/cyberia-docs/HARDHAT-MODULE.md',
             './src/client/public/cyberia-docs/CYBERIA-SERVER.md',
@@ -949,6 +961,85 @@ const DefaultConf = /**/ {
       backups: { expression: '0 1 * * *', enabled: true, instances: 1 },
     },
   },
+  wireguard: {
+    '00.000.00.000': {
+      interfaceName: 'wg0',
+      listenPort: 51820,
+      address: '10.0.0.1/24',
+      publicKey: '',
+      sshForwardPort: 2222,
+      peers: [
+        {
+          id: 'homelab-a',
+          address: '10.0.0.2',
+          managementHost: '192.168.1.80',
+          publicKey: '',
+          allowedIPs: ['10.0.0.2/32'],
+          hosts: [],
+          instances: [],
+          default: true,
+        },
+      ],
+    },
+  },
+  event: {
+    'notification-providers': {
+      'default-cluster-mailer-provider': {
+        type: 'mailer',
+        mailer: {
+          sender: { email: 'env:CLUSTER_MAILER_SENDER_EMAIL', name: 'env:CLUSTER_MAILER_SENDER_NAME:Underpost' },
+          transport: {
+            host: 'env:CLUSTER_MAILER_SMTP_HOST',
+            port: 'env:CLUSTER_MAILER_SMTP_PORT:int:587',
+            secure: 'env:CLUSTER_MAILER_SMTP_SECURE:bool:false',
+            auth: { user: 'env:CLUSTER_MAILER_SMTP_AUTH_USER', pass: 'env:CLUSTER_MAILER_SMTP_AUTH_PASS' },
+          },
+        },
+      },
+    },
+    events: {
+      'wireguard-server-down': {
+        probeInterval: '30s',
+        alertFor: '5m',
+        notifications: [
+          {
+            'notification-provider-id': 'default-cluster-mailer-provider',
+            payload: { subscribers: [{ email: 'admin@default.net', name: 'Admin' }] },
+          },
+        ],
+      },
+      'wireguard-spoke-down': {
+        probeInterval: '30s',
+        alertFor: '2m',
+        notifications: [
+          {
+            'notification-provider-id': 'default-cluster-mailer-provider',
+            payload: { subscribers: [{ email: 'admin@default.net', name: 'Admin' }] },
+          },
+        ],
+      },
+      'public-ingress-down': {
+        probeInterval: '5m',
+        alertFor: '5m',
+        notifications: [
+          {
+            'notification-provider-id': 'default-cluster-mailer-provider',
+            payload: { subscribers: [{ email: 'admin@default.net', name: 'Admin' }] },
+          },
+        ],
+      },
+    },
+  },
+  users: [
+    {
+      user: 'root',
+      password: '',
+      groups: 'wheel',
+      keyPath: './engine-private/deploy/id_rsa',
+      pubKeyPath: './engine-private/deploy/id_rsa.pub',
+      hosts: [{ host: '00.000.00.000', port: 22 }],
+    },
+  ],
 }; /**/
 
 export { DefaultConf };

package/deploy/cyberia-client/deploy.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
+
+DEPLOY_ID=dd-cyberia
+INSTANCE_ID=mmo-client
+TARGET_NODE="${TARGET_NODE:-$WORKER_NODE}"
+
+main() {
+    deploy_start "Starting remote deploy"
+
+    prepare_host "$ENGINE_ROOT"
+
+    deploy_step "Build $DEPLOY_ID configuration" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && node bin/build $DEPLOY_ID --conf"
+
+    deploy_step "Wait for target node readiness" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl wait --for=condition=Ready node/${TARGET_NODE} --timeout=2m"
+
+    deploy_step "Wait for ingress rollout" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl rollout status deployment/underpost-ingress -n default --timeout=5m"
+
+    deploy_step "Wait for gateway rollout" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl rollout status deployment/underpost-gateway -n default --timeout=5m"
+
+    deploy_step "Deploy $DEPLOY_ID $INSTANCE_ID instance" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && node bin run instance \
+          --kubeadm \
+          ${TARGET_NODE:+--node-name ${TARGET_NODE}} \
+          --gateway-api \
+          --image-pull-policy Always \
+          --ingress-node ${INGRESS_NODE} \
+          --ssh-key-path ${DEPLOY_SSH_KEY_PATH} \
+          --deploy-id $DEPLOY_ID \
+          --instance-id $INSTANCE_ID"
+}
+
+main "$@"

package/deploy/cyberia-client/package.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
+
+# This runtime is an instance of its parent deployment, and installs that deployment's manifest.
+DEPLOY_ID=dd-cyberia
+
+main() {
+    deploy_start "Syncing $DEPLOY_ID package manifest"
+
+    install_deploy_dependencies "$ENGINE_ROOT" "$DEPLOY_ID"
+}
+
+main "$@"

package/deploy/cyberia-client/state.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/state.sh"
+
+DEPLOY_ID=dd-cyberia
+INSTANCE_ID=mmo-client
+
+main() {
+    stream_state "$ENGINE_ROOT" "$DEPLOY_ID" "$INSTANCE_ID"
+}
+
+main "$@"

package/deploy/cyberia-server/deploy.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
+
+DEPLOY_ID=dd-cyberia
+INSTANCE_ID=mmo-server
+TARGET_NODE="${TARGET_NODE:-$WORKER_NODE}"
+
+main() {
+    deploy_start "Starting remote deploy"
+
+    prepare_host "$ENGINE_ROOT"
+
+    deploy_step "Build $DEPLOY_ID configuration" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && node bin/build $DEPLOY_ID --conf"
+
+    deploy_step "Wait for target node readiness" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl wait --for=condition=Ready node/${TARGET_NODE} --timeout=2m"
+
+    deploy_step "Wait for ingress rollout" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl rollout status deployment/underpost-ingress -n default --timeout=5m"
+
+    deploy_step "Wait for gateway rollout" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && kubectl rollout status deployment/underpost-gateway -n default --timeout=5m"
+
+    deploy_step "Deploy $DEPLOY_ID $INSTANCE_ID instance" \
+        sudo -n -- /bin/bash -lc \
+        "cd $ENGINE_ROOT && node bin run instance \
+          --kubeadm \
+          ${TARGET_NODE:+--node-name ${TARGET_NODE}} \
+          --gateway-api \
+          --image-pull-policy Always \
+          --ingress-node ${INGRESS_NODE} \
+          --ssh-key-path ${DEPLOY_SSH_KEY_PATH} \
+          --deploy-id $DEPLOY_ID \
+          --instance-id $INSTANCE_ID"
+}
+
+main "$@"

package/deploy/cyberia-server/package.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
+
+# This runtime is an instance of its parent deployment, and installs that deployment's manifest.
+DEPLOY_ID=dd-cyberia
+
+main() {
+    deploy_start "Syncing $DEPLOY_ID package manifest"
+
+    install_deploy_dependencies "$ENGINE_ROOT" "$DEPLOY_ID"
+}
+
+main "$@"

package/deploy/cyberia-server/state.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/state.sh"
+
+DEPLOY_ID=dd-cyberia
+INSTANCE_ID=mmo-server
+
+main() {
+    stream_state "$ENGINE_ROOT" "$DEPLOY_ID" "$INSTANCE_ID"
+}
+
+main "$@"

package/deploy/dd-cyberia/deploy.sh

@@ -2,41 +2,21 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/../lib/logging.sh"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
 
-ENGINE_ROOT=/home/dd/engine
-INGRESS_NODE=localhost.localdomain
+DEPLOY_ID=dd-cyberia
 
 main() {
-    echo "Starting remote deploy"
+    deploy_start "Starting remote deploy"
 
-    run_quiet \
-        "Pull repository" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin run pull"
-
-    run_quiet \
-        "Install dependencies" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && npm install"
-
-    run_quiet \
-        "Sync secrets" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin run secret"
+    prepare_host "$ENGINE_ROOT"
 
-    run_quiet \
-        "Deploy dd-cyberia" \
-        "Target pod:" \
-        14 \
+    deploy_step "Deploy $DEPLOY_ID" \
         sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin run deploy dd-cyberia --gateway-api --ingress-node ${INGRESS_NODE}"
+        "cd $ENGINE_ROOT && node bin run deploy $DEPLOY_ID \
+          --gateway-api \
+          --ingress-node ${INGRESS_NODE}"
 }
 
 main "$@"

package/deploy/dd-cyberia/init.sh

@@ -2,62 +2,55 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/../lib/logging.sh"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
 
-ENGINE_ROOT=/home/dd/engine
-INGRESS_NODE=localhost.localdomain
+DEPLOY_ID=dd-cyberia
+DEPLOY_ENV="${DEPLOY_ENV:-production}"
 
 main() {
-    echo "Starting init deploy"
+    deploy_start "Starting remote init deploy"
 
-    run_quiet \
-        "Pull repository" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin run pull"
-
-    run_quiet \
-        "Install dependencies" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && npm install"
+    prepare_host "$ENGINE_ROOT"
 
-    run_quiet \
-        "Sync secrets" \
-        "Target pod:" \
-        14 \
+    deploy_step "Build $DEPLOY_ID configuration" \
         sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin run secret"
+        "cd $ENGINE_ROOT && node bin/build $DEPLOY_ID --conf"
 
-    run_quiet \
-        "Build dd-cyberia configuration" \
-        "Target pod:" \
-        14 \
-        sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin/build dd-cyberia --conf"
+    local pod_cmd
+    pod_cmd="$(pod_bootstrap_cmd $DEPLOY_ID $DEPLOY_ENV), \
+        underpost start $DEPLOY_ID $DEPLOY_ENV --build --run --skip-pull-repo-base"
 
-    run_quiet \
-        "Deploy dd-cyberia production" \
-        "Target pod:" \
-        14 \
+    deploy_step "Deploy $DEPLOY_ID $DEPLOY_ENV" \
         sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin deploy dd-cyberia production --kubeadm --gateway-api --ingress-node ${INGRESS_NODE} --sync --build-manifest --timeout-response 300000ms --versions green --replicas 1"
-
-    run_quiet \
-        "Clean dd-cyberia working tree" \
-        "Target pod:" \
-        14 \
+        "cd $ENGINE_ROOT && node bin deploy $DEPLOY_ID $DEPLOY_ENV \
+          --versions green \
+          --replicas 1 \
+          --kubeadm \
+          --timeout-response 10000ms \
+          --gateway-api \
+          --ingress-node ${INGRESS_NODE} \
+          --sync \
+          --build-manifest \
+          --cmd '${pod_cmd}'"
+
+    deploy_step "Clean $DEPLOY_ID working tree" \
         sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin deploy dd-cyberia production --kubeadm --gateway-api --ingress-node ${INGRESS_NODE} --disable-update-proxy --git-clean"
-
-    run_quiet \
-        "Promote dd-cyberia deployment" \
-        "Target pod:" \
-        14 \
+        "cd $ENGINE_ROOT && node bin deploy $DEPLOY_ID $DEPLOY_ENV \
+          --kubeadm \
+          --gateway-api \
+          --ingress-node ${INGRESS_NODE} \
+          --disable-update-proxy \
+          --git-clean"
+
+    deploy_step "Promote $DEPLOY_ID deployment" \
         sudo -n -- /bin/bash -lc \
-        "cd $ENGINE_ROOT && node bin monitor dd-cyberia production --ready-deployment --promote --timeout-response 300000ms --versions green --replicas 1"
+        "cd $ENGINE_ROOT && node bin monitor $DEPLOY_ID $DEPLOY_ENV \
+          --ready-deployment \
+          --promote \
+          --timeout-response 10000ms \
+          --versions green \
+          --replicas 1"
 }
 
 main "$@"

package/deploy/dd-cyberia/package.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/host.sh"
+
+DEPLOY_ID=dd-cyberia
+
+main() {
+    deploy_start "Syncing $DEPLOY_ID package manifest"
+
+    install_deploy_dependencies "$ENGINE_ROOT" "$DEPLOY_ID"
+}
+
+main "$@"

package/deploy/dd-cyberia/state.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/github-actions-logging.sh"
+source "$SCRIPT_DIR/../lib/state.sh"
+
+DEPLOY_ID=dd-cyberia
+
+main() {
+    stream_state "$ENGINE_ROOT" "$DEPLOY_ID"
+}
+
+main "$@"