@underpostnet/cyberia 3.3.0 → 3.3.76

package/scripts/coverall-test.sh

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-set -u -o pipefail
-
-EXCLUDES=(
-    --exclude="test/cyberia-instance-conf-defaults.test.js"
-    --exclude="test/cyberia-load.test.js"
-    --exclude="test/object-layer-item-id.test.js"
-    --exclude="test/api.test.js"
-    --exclude="test/crypto.test.js"
-    --exclude="test/shape-generator.test.js"
-)
-
-TESTS=(
-    test/cluster-instances.test.js
-    test/deploy-monitor.test.js
-    test/deploy-node-placement.test.js
-    test/instance-traffic-plan.test.js
-    test/sops-secret-store.test.js
-    test/underpost-gateway.test.js
-    test/underpost-ingress.test.js
-    test/wireguard-edge.test.js
-)
-
-c8 "${EXCLUDES[@]}" mocha "${TESTS[@]}"

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

@@ -1,6 +0,0 @@
-
-#!/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

package/src/api/cyberia-instance/cyberia-fallback-default-items.js

@@ -1,63 +0,0 @@
-/**
- * Fallback-world default items — process-local override store.
- *
- * The procedural fallback world is never persisted, so its default item set
- * has no collection to live in. This module holds the set the FallbackWorldEngine
- * view composed, in memory, for the lifetime of the engine process:
- *
- *   - written by  POST /api/cyberia-instance/fallback-world/hot-reload
- *   - read by     fetchFullInstance()'s fallback branch (instance-data.js) and
- *                 GET /api/cyberia-instance/fallback-world[/default-items]
- *
- * Deliberately NOT persisted: an engine restart drops back to the code defaults,
- * so a stale editor session can never become the permanent shape of the world.
- * This keeps the fallback path's "code defaults are authoritative" invariant —
- * the only thing an operator can layer on top is this explicit, volatile list.
- *
- * @module src/api/cyberia-instance/cyberia-fallback-default-items.js
- */
-
-/** @typedef {{ id: string, defaultPlayerInventory: boolean }} FallbackDefaultItem */
-
-/** @type {FallbackDefaultItem[]} */
-let defaultItems = [];
-
-/**
- * Coerce a caller-supplied list into the canonical `{ id, defaultPlayerInventory }`
- * shape. Accepts the legacy `string[]` form and drops blank/duplicate ids so the
- * world generator never sees a malformed entry.
- *
- * @param {Array<string|FallbackDefaultItem>} entries
- * @returns {FallbackDefaultItem[]}
- */
-function normalizeFallbackDefaultItems(entries) {
-  if (!Array.isArray(entries)) return [];
-  const seen = new Set();
-  const normalized = [];
-  for (const entry of entries) {
-    const raw = typeof entry === 'string' ? { id: entry } : entry;
-    const id = typeof raw?.id === 'string' ? raw.id.trim() : '';
-    if (!id || seen.has(id)) continue;
-    seen.add(id);
-    normalized.push({ id, defaultPlayerInventory: !!raw.defaultPlayerInventory });
-  }
-  return normalized;
-}
-
-/**
- * Current override set. Returns a copy so callers cannot mutate the store.
- * @returns {FallbackDefaultItem[]}
- */
-const getFallbackDefaultItems = () => defaultItems.map((entry) => ({ ...entry }));
-
-/**
- * Replace the override set. An empty list clears it, restoring pure code defaults.
- * @param {Array<string|FallbackDefaultItem>} entries
- * @returns {FallbackDefaultItem[]} The stored set.
- */
-function setFallbackDefaultItems(entries) {
-  defaultItems = normalizeFallbackDefaultItems(entries);
-  return getFallbackDefaultItems();
-}
-
-export { getFallbackDefaultItems, setFallbackDefaultItems, normalizeFallbackDefaultItems };

package/src/api/user/user.build.js

@@ -1,16 +0,0 @@
-import fs from 'fs-extra';
-import { faBase64Png, getBufferPngText } from '../../server/client-icons.js';
-
-process.exit(0);
-
-fs.writeFileSync(
-  './tmp/api-user-invalid-token.png',
-  await getBufferPngText({ text: 'Invalid token', textColor: '#ff0000' }),
-  'utf8',
-);
-fs.writeFileSync(
-  './tmp/api-user-recover.png',
-  Buffer.from(faBase64Png('rotate-left', 50, 50, '#ffffff'), 'base64'),
-  'utf8',
-);
-fs.writeFileSync('./tmp/api-user-check.png', Buffer.from(faBase64Png('check', 50, 50), 'base64'), 'utf8');

package/src/cli/env.js

@@ -1,177 +0,0 @@
-/**
- * Environment module for managing the environment variables of the underpost root
- * @module src/cli/env.js
- * @namespace UnderpostEnv
- */
-
-import { getNpmRootPath, writeEnv } from '../server/environment.js';
-import fs from 'fs-extra';
-import { loggerFactory } from '../server/logger.js';
-import dotenv from 'dotenv';
-import { pbcopy } from '../server/process.js';
-
-const logger = loggerFactory(import.meta);
-
-/**
- * Guards an env file path against stale directory artifacts.
- * Removes the path if it exists as a directory (e.g. `.env/` created by a previous EISDIR bug).
- * @param {string} envPath - The path to the environment file.
- * @memberof UnderpostEnv
- */
-const guardEnvPath = (envPath) => {
-  if (fs.existsSync(envPath) && !fs.statSync(envPath).isFile()) {
-    logger.warn(`Removing stale directory at env path: ${envPath}`);
-    fs.removeSync(envPath);
-  }
-};
-
-/**
- * @class UnderpostRootEnv
- * @description Manages the environment variables of the underpost root.
- * @memberof UnderpostEnv
- */
-class UnderpostRootEnv {
-  static API = {
-    /**
-     * @method set
-     * @description Sets an environment variable in the underpost root environment.
-     * @param {string} key - The key of the environment variable to set.
-     * @param {string} value - The value of the environment variable to set.
-     * @param {object} options - Options for setting the environment variable.
-     * @param {string} [options.deployId=''] - Deployment ID associated with the environment variable.
-     * @param {boolean} [options.build=false] - If true, sets the environment variable using custom --deploy-id or all dd.router deploy ids configured.
-     * @memberof UnderpostEnv
-     */
-    set(key, value, options = { deployId: '', build: false }) {
-      const _set = (envPath, key, value) => {
-        guardEnvPath(envPath);
-        let env = {};
-        if (fs.existsSync(envPath)) env = dotenv.parse(fs.readFileSync(envPath, 'utf8'));
-        env[key] = value;
-        writeEnv(envPath, env);
-      };
-      if (options.build) {
-        const deployIdList = options.deployId
-          ? [options.deployId]
-          : fs.existsSync(`./engine-private/deploy/dd.router`)
-            ? fs.readFileSync(`./engine-private/deploy/dd.router`, 'utf8').split(',')
-            : [DEFAULT_DEPLOY_ID];
-        for (const deployId of deployIdList)
-          for (const envFile of ['test', 'development', 'production'])
-            _set(`./engine-private/conf/${deployId}/.env.${envFile}`, key, value);
-        return;
-      }
-      const exeRootPath = `${getNpmRootPath()}/underpost`;
-      fs.ensureDirSync(exeRootPath);
-      const envPath = `${exeRootPath}/.env`;
-      _set(envPath, key, value);
-    },
-    /**
-     * @method delete
-     * @description Deletes an environment variable from the underpost root environment.
-     * @param {string} key - The key of the environment variable to delete.
-     * @memberof UnderpostEnv
-     */
-    delete(key) {
-      const exeRootPath = `${getNpmRootPath()}/underpost`;
-      const envPath = `${exeRootPath}/.env`;
-      guardEnvPath(envPath);
-      let env = {};
-      if (fs.existsSync(envPath)) env = dotenv.parse(fs.readFileSync(envPath, 'utf8'));
-      delete env[key];
-      writeEnv(envPath, env);
-    },
-    /**
-     * @method get
-     * @description Gets an environment variable from the underpost root environment.
-     * @param {string} key - The key of the environment variable to get.
-     * @param {string} value - The value of the environment variable to get.
-     * @param {object} options - Options for getting the environment variable.
-     * @param {boolean} [options.plain=false] - If true, returns the environment variable value as a string.
-     * @param {boolean} [options.disableLog=false] - If true, disables logging of the environment variable value.
-     * @param {boolean} [options.copy=false] - If true, copies the environment variable value to the clipboard.
-     * @memberof UnderpostEnv
-     */
-    get(key, value, options = { plain: false, disableLog: false, copy: false }) {
-      const exeRootPath = `${getNpmRootPath()}/underpost`;
-      const envPath = `${exeRootPath}/.env`;
-      if (!fs.existsSync(envPath) || !fs.statSync(envPath).isFile()) return undefined;
-      const env = dotenv.parse(fs.readFileSync(envPath, 'utf8'));
-      if (!options.disableLog)
-        options?.plain === true ? console.log(env[key]) : logger.info(`${key}(${typeof env[key]})`, env[key]);
-      if (options.copy === true) pbcopy(env[key]);
-      return env[key];
-    },
-    /**
-     * @method list
-     * @description Lists all environment variables in the underpost root environment.
-     * @param {string} key - Not used for list operation.
-     * @param {string} value - Not used for list operation.
-     * @param {object} options - Options for listing environment variables.
-     * @param {string} [options.filter] - Filter keyword to match against keys or values.
-     * @memberof UnderpostEnv
-     */
-    list(key, value, options = {}) {
-      const exeRootPath = `${getNpmRootPath()}/underpost`;
-      const envPath = `${exeRootPath}/.env`;
-      guardEnvPath(envPath);
-      if (!fs.existsSync(envPath)) {
-        logger.warn(`Empty environment variables`);
-        return {};
-      }
-      let env = dotenv.parse(fs.readFileSync(envPath, 'utf8'));
-
-      // Apply filter if provided
-      if (options.filter) {
-        const filterKeyword = options.filter.toLowerCase();
-        const filtered = {};
-        for (const [envKey, envValue] of Object.entries(env)) {
-          const keyMatch = envKey.toLowerCase().includes(filterKeyword);
-          const valueMatch = String(envValue).toLowerCase().includes(filterKeyword);
-          if (keyMatch || valueMatch) {
-            filtered[envKey] = envValue;
-          }
-        }
-        env = filtered;
-        logger.info(`underpost root (filtered by: ${options.filter})`, env);
-      } else {
-        logger.info('underpost root', env);
-      }
-
-      return env;
-    },
-    /**
-     * @method clean
-     * @description Cleans the underpost root environment by removing the environment file.
-     * @param {object} options - Options for cleaning the environment.
-     * @param {Array<string>} [options.keepKeys=[]] - List of keys to keep in the environment file. If provided, only these keys will be retained.
-     * @memberof UnderpostEnv
-     */
-    clean(options = { keepKeys: [] }) {
-      const { keepKeys } = options;
-      const exeRootPath = `${getNpmRootPath()}/underpost`;
-      const envPath = `${exeRootPath}/.env`;
-      if (keepKeys && keepKeys.length > 0 && fs.existsSync(envPath)) {
-        const env = dotenv.parse(fs.readFileSync(envPath, 'utf8'));
-        const filteredEnv = Object.fromEntries(Object.entries(env).filter(([key]) => keepKeys.includes(key)));
-        writeEnv(envPath, filteredEnv);
-      } else {
-        fs.removeSync(envPath);
-      }
-    },
-    /**
-     * @method isInsideContainer
-     * @description Detects whether the current process is running inside a container.
-     * Checks for Kubernetes service injection or Docker's .dockerenv marker.
-     * @returns {boolean} True if running inside a container.
-     * @memberof UnderpostEnv
-     */
-    isInsideContainer() {
-      return !!process.env.KUBERNETES_SERVICE_HOST || fs.existsSync('/.dockerenv');
-    },
-  };
-}
-
-export default UnderpostRootEnv;
-
-export { guardEnvPath };

package/src/client/components/core/Blockchain.js

@@ -1,41 +0,0 @@
-import { BlockChainService } from '../../services/blockchain/blockchain.service.js';
-import { BtnIcon } from './BtnIcon.js';
-import { dynamicCol } from './Css.js';
-import { EventsUI } from './EventsUI.js';
-import { Input } from './Input.js';
-import { Translate } from './Translate.js';
-
-const BlockChainManagement = {
-  Render: async function (options) {
-    setTimeout(() => {
-      EventsUI.onClick(`.btn-upload-blockchain`, async () => {
-        // const { result, status } = new BlockChainService.post();
-      });
-    });
-    return html` ${dynamicCol({ containerSelector: options.idModal, id: 'blockchain' })}
-      <div class="fl">
-        <div class="in fll blockchain-col-a">
-          <div class="in section-mp">
-            <div class="in sub-title-modal"><i class="fa-solid fa-sliders"></i> ${Translate.Render('config')}</div>
-            <div class="in">
-              ${await Input.Render({
-                id: `blockchain-seed`,
-                label: html`<i class="fa-solid fa-pen-to-square"></i> ${Translate.Render('blockchain-seed')}`,
-                containerClass: 'section-mp width-mini-box input-container',
-                placeholder: true,
-              })}
-              ${await BtnIcon.Render({
-                class: `inl section-mp btn-custom btn-upload-blockchain`,
-                label: html`<i class="fas fa-plus"></i> ${Translate.Render(`create`)}`,
-              })}
-            </div>
-          </div>
-        </div>
-        <div class="in fll blockchain-col-b">
-          <div class="in section-mp"></div>
-        </div>
-      </div>`;
-  },
-};
-
-export { BlockChainManagement };

package/src/client/components/core/Blog.js

@@ -1,9 +0,0 @@
-import { RichText } from './RichText.js';
-
-const Blog = {
-  Render: async function () {
-    return html`${await RichText.Render()}`;
-  },
-};
-
-export { Blog };

package/src/client/components/core/KeyboardAvoidance.js

@@ -1,145 +0,0 @@
-/**
- * Mobile virtual keyboard avoidance utility.
- *
- * On mobile browsers, when the software keyboard appears it reduces
- * `window.visualViewport.height`.  Without compensation, the keyboard
- * can cover modals and form inputs so the user cannot see what they type.
- *
- * This module attaches to `window.visualViewport` resize/scroll events and
- * translates a target element upward by the amount of space the keyboard has
- * consumed.  A debounce is applied so that rapid `resize` events (common on
- * Android) do not cause visual jitter.
- *
- * Usage:
- * ```js
- * import { initKeyboardAvoidance } from './KeyboardAvoidance.js';
- *
- * // Attach when a modal opens:
- * const cleanup = initKeyboardAvoidance(document.querySelector('.my-modal'));
- *
- * // Detach when the modal closes:
- * cleanup();
- * ```
- *
- * @module src/client/components/core/KeyboardAvoidance.js
- * @namespace KeyboardAvoidanceModule
- */
-
-/**
- * Minimum keyboard height in pixels below which we consider the keyboard
- * to be hidden.  Values smaller than this are treated as OS chrome
- * (address bar resize, etc.) and ignored.
- *
- * @constant {number}
- * @memberof KeyboardAvoidanceModule
- */
-const MIN_KEYBOARD_HEIGHT_PX = 50;
-
-/**
- * Debounce delay in milliseconds applied to the `resize` handler.
- * Prevents excessive style recalculations when the keyboard animates in.
- *
- * @constant {number}
- * @memberof KeyboardAvoidanceModule
- */
-const DEBOUNCE_MS = 32;
-
-/**
- * Attaches `visualViewport` listeners to translate `targetEl` when the
- * mobile software keyboard appears.
- *
- * The function is a no-op in environments that do not support the
- * `visualViewport` API (desktop browsers, some older mobile browsers).
- *
- * @param {HTMLElement} targetEl - The element to translate (typically a
- *   modal container or form wrapper).
- * @param {object}  [options]
- * @param {number}  [options.debounceMs=32]       - Debounce delay in ms.
- * @param {number}  [options.minKeyboardPx=50]    - Minimum offset to treat
- *   as a real keyboard appearance.
- * @param {string}  [options.transitionStyle='transform 0.15s ease-out'] -
- *   CSS transition applied to `targetEl` during keyboard animations.
- * @returns {function(): void} Cleanup function — call when the element is
- *   unmounted or the modal closes to remove the event listeners.
- *
- * @memberof KeyboardAvoidanceModule
- *
- * @example
- * // Inside a modal's open() method:
- * this._kbCleanup = initKeyboardAvoidance(this._el);
- *
- * // Inside the modal's close() method:
- * if (this._kbCleanup) { this._kbCleanup(); this._kbCleanup = null; }
- */
-export function initKeyboardAvoidance(
-  targetEl,
-  {
-    debounceMs = DEBOUNCE_MS,
-    minKeyboardPx = MIN_KEYBOARD_HEIGHT_PX,
-    transitionStyle = 'transform 0.15s ease-out',
-  } = {},
-) {
-  // Feature-detect visualViewport.  When unavailable, return a no-op cleanup.
-  if (!window.visualViewport || !targetEl) return () => {};
-
-  // Apply transition so movement feels natural.
-  const previousTransition = targetEl.style.transition;
-  targetEl.style.transition = transitionStyle;
-
-  let debounceTimer = null;
-
-  /**
-   * Computes the vertical offset caused by the software keyboard and
-   * applies a CSS translateY correction to `targetEl`.
-   *
-   * @returns {void}
-   * @memberof KeyboardAvoidanceModule
-   */
-  const update = () => {
-    const offset = window.innerHeight - window.visualViewport.height - window.visualViewport.offsetTop;
-
-    if (offset > minKeyboardPx) {
-      // Keyboard is visible — push the element up.
-      targetEl.style.transform = `translateY(-${Math.round(offset)}px)`;
-    } else {
-      // Keyboard is hidden — restore original position.
-      targetEl.style.transform = '';
-    }
-  };
-
-  /**
-   * Debounced wrapper for `update`.
-   * @returns {void}
-   */
-  const onViewportChange = () => {
-    if (debounceTimer !== null) clearTimeout(debounceTimer);
-    debounceTimer = setTimeout(update, debounceMs);
-  };
-
-  window.visualViewport.addEventListener('resize', onViewportChange);
-  window.visualViewport.addEventListener('scroll', onViewportChange);
-
-  // Run once immediately to handle the case where the keyboard was already
-  // open when this function was called.
-  update();
-
-  /**
-   * Cleanup function.  Removes all listeners and restores the element's
-   * original styles.
-   *
-   * @returns {void}
-   */
-  return () => {
-    if (debounceTimer !== null) {
-      clearTimeout(debounceTimer);
-      debounceTimer = null;
-    }
-    window.visualViewport.removeEventListener('resize', onViewportChange);
-    window.visualViewport.removeEventListener('scroll', onViewportChange);
-    // Restore previous styles.
-    targetEl.style.transform = '';
-    targetEl.style.transition = previousTransition;
-  };
-}
-
-export default initKeyboardAvoidance;