@underpostnet/cyberia 3.3.0 → 3.3.73

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;

package/src/client/public/doc/sitemap

@@ -1,148 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet version="2.0"
-    xmlns:html="http://www.w3.org/TR/REC-html40"
-    xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"
-    xmlns:sitemap="http://www.sitemaps.org/schemas/sitemap/0.9"
-    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
-    <xsl:output method="html" version="1.0" encoding="UTF-8" indent="yes" />
-    <xsl:template match="/">
-        <html xmlns="http://www.w3.org/1999/xhtml">
-            <head>
-                <title>XML Sitemap</title>
-                <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-                <style type="text/css">
-                    body {
-                    font-family: sans-serif;
-                    font-size: 16px;
-                    color: #242628;
-                    }
-                    a {
-                    color: #000;
-                    text-decoration: none;
-                    }
-                    a:hover {
-                    text-decoration: underline;
-                    }
-                    table {
-                    border: none;
-                    border-collapse: collapse;
-                    width: 100%
-                    }
-                    th {
-                    text-align: left;
-                    padding-right: 30px;
-                    font-size: 11px;
-                    }
-                    thead th {
-                    border-bottom: 1px solid #7d878a;
-                    cursor: pointer;
-                    }
-                    td {
-                    font-size:11px;
-                    padding: 5px;
-                    }
-                    tr:nth-child(odd) td {
-                    background-color: rgba(0,0,0,0.04);
-                    }
-                    tr:hover td {
-                    background-color: #e2edf2;
-                    }
-
-                    #content {
-                    margin: 0 auto;
-                    padding: 2% 5%;
-                    max-width: 800px;
-                    }
-
-                    .desc {
-                    margin: 18px 3px;
-                    line-height: 1.2em;
-                    }
-                    .desc a {
-                    color: #5ba4e5;
-                    }
-                </style>
-            </head>
-            <body>
-                <div id="content">
-                    <h1>XML Sitemap</h1>
-                    <p class="desc"> This is a sitemap generated by <a
-                            href="https://www.nexodev.org">nexodev.org</a>
-                    </p>
-                    <xsl:if test="count(sitemap:sitemapindex/sitemap:sitemap) &gt; 0">
-                        <table id="sitemap" cellpadding="3">
-                            <thead>
-                                <tr>
-                                    <th width="75%">Sitemap</th>
-                                    <th width="25%">Last Modified</th>
-                                </tr>
-                            </thead>
-                            <tbody>
-                                <xsl:for-each select="sitemap:sitemapindex/sitemap:sitemap">
-                                    <xsl:variable name="sitemapURL">
-                                        <xsl:value-of select="sitemap:loc" />
-                                    </xsl:variable>
-                                <tr>
-                                        <td>
-                                            <a href="{$sitemapURL}">
-                                                <xsl:value-of select="sitemap:loc" />
-                                            </a>
-                                        </td>
-                                        <td>
-                                            <xsl:value-of
-                                                select="concat(substring(sitemap:lastmod,0,11),concat(' ', substring(sitemap:lastmod,12,5)))" />
-                                        </td>
-                                    </tr>
-                                </xsl:for-each>
-                            </tbody>
-                        </table>
-                    </xsl:if>
-                    <xsl:if test="count(sitemap:sitemapindex/sitemap:sitemap) &lt; 1">
-                        <p class="desc">
-                            <a href="{{web-url}}sitemap.xml" class="back-link">&#8592; Back to index</a>
-                        </p>
-                        <table
-                            id="sitemap" cellpadding="3">
-                            <thead>
-                                <tr>
-                                    <th width="70%">URL (<xsl:value-of
-                                            select="count(sitemap:urlset/sitemap:url)" /> total)</th>
-                                    <th width="15%">Images</th>
-                                    <th title="Last Modification Time" width="15%">Last Modified</th>
-                                </tr>
-                            </thead>
-                            <tbody>
-                                <xsl:variable name="lower" select="'abcdefghijklmnopqrstuvwxyz'" />
-                                <xsl:variable name="upper" select="'ABCDEFGHIJKLMNOPQRSTUVWXYZ'" />
-                                <xsl:for-each select="sitemap:urlset/sitemap:url">
-                                    <tr>
-                                        <td>
-                                            <xsl:variable name="itemURL">
-                                                <xsl:value-of select="sitemap:loc" />
-                                            </xsl:variable>
-                                            <a href="{$itemURL}">
-                                                <xsl:value-of select="sitemap:loc" />
-                                            </a>
-                                        </td>
-                                        <td>
-                                            <xsl:value-of select="count(image:image)" />
-                                        </td>
-                                        <td>
-                                            <xsl:value-of
-                                                select="concat(substring(sitemap:lastmod,0,11),concat(' ', substring(sitemap:lastmod,12,5)))" />
-                                        </td>
-                                    </tr>
-                                </xsl:for-each>
-                            </tbody>
-                        </table>
-                        <p
-                            class="desc">
-                            <a href="{{web-url}}sitemap.xml" class="back-link">&#8592; Back to index</a>
-                        </p>
-                    </xsl:if>
-                </div>
-            </body>
-        </html>
-
-    </xsl:template>
-</xsl:stylesheet>

package/src/server/environment.js

@@ -1,98 +0,0 @@
-/**
- * Environment and global installation path resolution.
- * @module src/server/environment.js
- * @namespace ServerEnvironment
- */
-'use strict';
-
-import dotenv from 'dotenv';
-import fs from 'fs-extra';
-import { execFileSync } from 'node:child_process';
-import { loggerFactory } from './logger.js';
-
-const logger = loggerFactory(import.meta);
-
-/**
- * Node directory backing every hostPath PersistentVolume the deploy flow
- * materializes (`<root>/<pv id>`), including the shared gateway's static tree.
- * Cluster bring-up gives it the shared container label, because the pods that
- * read these documents are unprivileged.
- * @constant {string}
- * @memberof ServerEnvironment
- */
-const HOST_VOLUME_ROOT = '/home/dd/engine/volume';
-const envFileCache = new Map();
-let rootEnvPath;
-
-/**
- * Resolves the global npm module directory.
- * @returns {string}
- * @memberof ServerEnvironment
- */
-const getNpmRootPath = () => {
-  try {
-    return execFileSync('npm', ['root', '-g'], {
-      encoding: 'utf8',
-      stdio: ['ignore', 'pipe', 'ignore'],
-    }).trim();
-  } catch {
-    return '';
-  }
-};
-
-/**
- * Resolves the global Underpost installation directory.
- * @returns {string}
- * @memberof ServerEnvironment
- */
-const getUnderpostRootPath = () => {
-  const npmRoot = getNpmRootPath();
-  return npmRoot ? `${npmRoot}/underpost` : '';
-};
-
-const readEnvFile = (path) => {
-  if (envFileCache.has(path)) return envFileCache.get(path);
-  let values = {};
-  try {
-    if (path && fs.existsSync(path)) values = dotenv.parse(fs.readFileSync(path, 'utf8'));
-  } catch (error) {
-    logger.warn('Ignoring unreadable env file', { target: path, message: error.message });
-  }
-  envFileCache.set(path, values);
-  return values;
-};
-
-const environmentValueFactory = (key) => {
-  const processValue = `${process.env[key] ?? ''}`.trim();
-  if (processValue) return processValue;
-
-  if (rootEnvPath === undefined) {
-    const underpostRoot = getUnderpostRootPath();
-    rootEnvPath = underpostRoot ? `${underpostRoot}/.env` : '';
-  }
-
-  for (const path of ['./.env', rootEnvPath]) {
-    const value = `${readEnvFile(path)[key] ?? ''}`.trim();
-    if (value) return value;
-  }
-  return '';
-};
-
-/**
- * Writes environment values as a dotenv file.
- * @method writeEnv
- * @param {string} envPath - Destination file path.
- * @param {Object<string, *>} envObj - Environment values keyed by variable name.
- * @returns {void}
- * @memberof ServerEnvironment
- */
-const writeEnv = (envPath, envObj) =>
-  fs.writeFileSync(
-    envPath,
-    Object.keys(envObj)
-      .map((key) => `${key}=${envObj[key]}`)
-      .join('\n'),
-    'utf8',
-  );
-
-export { environmentValueFactory, getNpmRootPath, getUnderpostRootPath, HOST_VOLUME_ROOT, writeEnv };