hola-server 2.0.1 → 3.0.0

package/core/array.js

@@ -1,124 +0,0 @@
-/**
- * @fileoverview Array manipulation utility functions.
- * @module core/array
- */
-
-const { round_to_fixed2 } = require('./number');
-
-/**
- * Shuffle array elements randomly in place.
- * @param {Array} arr - Array to shuffle.
- */
-const shuffle = (arr) => {
-    for (let i = arr.length; i; i--) {
-        const j = Math.floor(Math.random() * i);
-        [arr[i - 1], arr[j]] = [arr[j], arr[i - 1]];
-    }
-};
-
-/**
- * Remove elements from array by matching field value.
- * @param {Object[]} array - Array of objects to modify.
- * @param {string} field - Field name to match.
- * @param {*} value - Value to match for removal.
- */
-const remove_element = (array, field, value) => {
-    for (let i = array.length - 1; i >= 0; --i) {
-        if (array[i][field] == value) array.splice(i, 1);
-    }
-};
-
-/**
- * Extract n elements from array using specified method.
- * @param {Array} array - Source array.
- * @param {number} n - Number of elements to extract.
- * @param {string} method - 'pop' or 'shift'.
- * @returns {Array|undefined} Array of extracted elements or undefined if empty.
- */
-const extract_n = (array, n, method) => {
-    const result = [];
-    while (result.length < n) {
-        const ele = array[method]();
-        if (ele) result.push(ele);
-        else break;
-    }
-    return result.length > 0 ? result : undefined;
-};
-
-const pop_n = (array, n) => extract_n(array, n, 'pop');
-const shift_n = (array, n) => extract_n(array, n, 'shift');
-
-/**
- * Calculate sum of number array.
- * @param {number[]} arr - Array of numbers.
- * @returns {number} Sum rounded to 2 decimal places.
- */
-const sum = (arr) => round_to_fixed2(arr.reduce((pre, cur) => pre + cur, 0));
-
-/**
- * Calculate average of number array.
- * @param {number[]} arr - Array of numbers.
- * @returns {number} Average rounded to 2 decimal places.
- */
-const avg = (arr) => arr.length === 0 ? 0 : round_to_fixed2(sum(arr) / arr.length);
-
-/**
- * Convert array of objects to key-value object.
- * @param {Object[]} arr - Array of objects.
- * @param {string} key_attr - Attribute to use as key.
- * @param {string} value_attr - Attribute to use as value.
- * @returns {Object} Mapped object.
- */
-const map_array_to_obj = (arr, key_attr, value_attr) => {
-    return arr.reduce((obj, el) => ({ ...obj, [el[key_attr]]: el[value_attr] }), {});
-};
-
-/**
- * Sort array of objects by attribute.
- * @param {Object[]} arr - Array to sort.
- * @param {string} attr - Attribute name to sort by.
- * @param {boolean} [desc=false] - Sort descending if true.
- * @returns {Object[]} Sorted array.
- */
-const sort_by_attr = (arr, attr, desc = false) => {
-    arr.sort((a, b) => desc ? b[attr] - a[attr] : a[attr] - b[attr]);
-    return arr;
-};
-
-const sort_desc = (arr, attr) => sort_by_attr(arr, attr, true);
-const sort_asc = (arr, attr) => sort_by_attr(arr, attr, false);
-
-/**
- * Sort array by predefined key sequence.
- * @param {Object[]} arr - Array to sort.
- * @param {string} attr - Attribute name to sort by.
- * @param {Array} keys - Ordered array of key values.
- * @returns {Object[]} Sorted array.
- */
-const sort_by_key_seq = (arr, attr, keys) => {
-    arr.sort((a, b) => keys.indexOf(a[attr]) - keys.indexOf(b[attr]));
-    return arr;
-};
-
-/**
- * Create cartesian product of two object arrays.
- * @param {Object[]} arr1 - First array.
- * @param {Object[]} arr2 - Second array.
- * @returns {Object[]} Combined array with length arr1.length * arr2.length.
- */
-const combine = (arr1, arr2) => arr1.flatMap(obj1 => arr2.map(obj2 => ({ ...obj1, ...obj2 })));
-
-/**
- * Remove duplicate elements from array.
- * @param {Array} array - Array to deduplicate.
- * @returns {Array} Array with unique elements.
- */
-const unique = (array) => {
-    const seen = new Map();
-    return array.filter(value => {
-        const key = JSON.stringify(value);
-        return seen.has(key) ? false : (seen.set(key, true), true);
-    });
-};
-
-module.exports = { shuffle, remove_element, pop_n, shift_n, sum, avg, combine, sort_desc, sort_asc, sort_by_key_seq, unique, map_array_to_obj };

package/core/bash.js

@@ -1,294 +0,0 @@
-/**
- * @fileoverview Bash command execution and SSH utility functions.
- * @module core/bash
- */
-
-const fs = require('fs');
-const { exec } = require("child_process");
-const { random_code } = require('./random');
-const { is_log_debug, is_log_error, log_debug, log_error } = require('../db/db');
-
-const LOG_BASH = "bash";
-const SSH_OPTIONS = "-o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no";
-
-/**
- * Execute command with unified logging and error handling.
- * @param {string} cmd - Command to execute.
- * @param {Object} options - Exec options.
- * @param {string} error_msg - Error message prefix.
- * @param {string} success_msg - Success message prefix.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const exec_with_logging = (cmd, options, error_msg, success_msg, log_extra) => {
-    return new Promise((resolve) => {
-        exec(cmd, options, (error, stdout) => {
-            if (error) {
-                if (is_log_error()) log_error(LOG_BASH, `${error_msg}, error:${error}`, log_extra);
-                resolve({ stdout, err: `${error_msg}, error:${error}` });
-            } else {
-                if (is_log_debug()) log_debug(LOG_BASH, `${success_msg}, stdout:${stdout}`, log_extra);
-                resolve({ stdout });
-            }
-        });
-    });
-};
-
-/**
- * Get temporary log file path.
- * @returns {Promise<string>} Path to temporary log file.
- */
-const get_log_file = async () => {
-    const home = await run_simple_local_cmd("echo ~");
-    const log_dir = `${home}/.hola/ssh`;
-    await run_local_cmd(`mkdir -p ${log_dir}`);
-    return `${log_dir}/l_${random_code()}.log`;
-};
-
-/**
- * Build SSH command prefix.
- * @param {Object} host - Host configuration.
- * @returns {string} SSH command prefix.
- */
-const build_ssh_prefix = (host) => `ssh ${host.auth} ${SSH_OPTIONS} -p ${host.port} ${host.user}@${host.ip}`;
-
-/**
- * Build SCP command.
- * @param {Object} host - Host configuration.
- * @param {string} src - Source path.
- * @param {string} dest - Destination path.
- * @param {boolean} to_remote - True if copying to remote.
- * @returns {string} SCP command.
- */
-const build_scp_cmd = (host, src, dest, to_remote) => {
-    const remote_path = `${host.user}@${host.ip}:${to_remote ? dest : src}`;
-    const local_path = to_remote ? src : dest;
-    const [first, second] = to_remote ? [local_path, remote_path] : [remote_path, local_path];
-    return `scp ${host.auth} ${SSH_OPTIONS} -P ${host.port} -q ${first} ${second}`;
-};
-
-/**
- * Run script on remote host via SSH.
- * @param {Object} host - Host info with user, ip, port, auth, name.
- * @param {string} script - Commands to run.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const run_script = (host, script, log_extra) => {
-    const cmd = `${build_ssh_prefix(host)} /bin/bash <<'EOT'\n ${script} \nEOT\n`;
-    return exec_with_logging(cmd, { maxBuffer: 1024 * 150000 },
-        `error running on host:${host.name} script:${script}`,
-        `executing on host:${host.name}, script:${script}`, log_extra);
-};
-
-/**
- * Run script on remote host with file redirect to avoid progress bar issues.
- * @param {Object} host - Host info with user, ip, port, auth, name.
- * @param {string} script - Commands to run.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const run_script_extra = async (host, script, log_extra) => {
-    const log_file = await get_log_file();
-    const cmd = `${build_ssh_prefix(host)} /bin/bash <<'EOT' > ${log_file} \n ${script} \nEOT\n`;
-
-    return new Promise((resolve) => {
-        exec(cmd, { maxBuffer: 1024 * 150000 }, (error, stdout) => {
-            if (error) {
-                if (is_log_error()) log_error(LOG_BASH, `error running on host:${host.name} script:${script}, error:${error}`, log_extra);
-                resolve({ stdout, err: `error running script:${script}, error:${error}` });
-            } else {
-                const output = fs.readFileSync(log_file, { encoding: 'utf8', flag: 'r' });
-                if (is_log_debug()) log_debug(LOG_BASH, `executing on host:${host.name}, script:${script}, stdout:${output}`, log_extra);
-                fs.unlinkSync(log_file);
-                resolve({ stdout: output });
-            }
-        });
-    });
-};
-
-/**
- * Run script file on remote host.
- * @param {Object} host - Host info.
- * @param {string} script_file - Path to local script file.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const run_script_file = (host, script_file, log_extra) => {
-    const cmd = `${build_ssh_prefix(host)} /bin/bash < ${script_file}`;
-    return exec_with_logging(cmd, {},
-        `error running on host:${host.name} script_file:${script_file}`,
-        `executing on host:${host.name}, script_file:${script_file}`, log_extra);
-};
-
-/**
- * Run command on local host.
- * @param {string} cmd - Command to execute.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const run_local_cmd = (cmd, log_extra) => {
-    return exec_with_logging(cmd, { maxBuffer: 1024 * 15000000 },
-        `error running on local host cmd:${cmd}`,
-        `executing on local host cmd:${cmd}`, log_extra);
-};
-
-/**
- * SCP remote file to local.
- * @param {Object} host - Remote host info.
- * @param {string} remote_file - Remote file path.
- * @param {string} local_file - Local file path.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const scp = (host, remote_file, local_file, log_extra) => {
-    const cmd = build_scp_cmd(host, remote_file, local_file, false);
-    return exec_with_logging(cmd, {},
-        `error scp on host:${host.name} remote:${remote_file}, local:${local_file}`,
-        `executing scp on host:${host.name}, remote:${remote_file}, local:${local_file}`, log_extra);
-};
-
-/**
- * SCP local file to remote.
- * @param {Object} host - Remote host info.
- * @param {string} local_file - Local file path.
- * @param {string} remote_file - Remote file path.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<{stdout: string, err?: string}>} Command result.
- */
-const scpr = (host, local_file, remote_file, log_extra) => {
-    const cmd = build_scp_cmd(host, local_file, remote_file, true);
-    return exec_with_logging(cmd, {},
-        `error scpr on host:${host.name} remote:${remote_file}, local:${local_file}`,
-        `executing scpr on host:${host.name}, remote:${remote_file}, local:${local_file}`, log_extra);
-};
-
-/**
- * Run simple command on remote host and get trimmed result.
- * @param {Object} host - Host info.
- * @param {string} cmd - Command to run.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<string|null>} Trimmed output or null on error.
- */
-const run_simple_cmd = async (host, cmd, log_extra) => {
-    const { err, stdout } = await run_script(host, cmd, log_extra);
-    return err ? null : stdout.trim();
-};
-
-/**
- * Run simple command locally and get trimmed result.
- * @param {string} cmd - Command to run.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<string|null>} Trimmed output or null on error.
- */
-const run_simple_local_cmd = async (cmd, log_extra) => {
-    const { err, stdout } = await run_local_cmd(cmd, log_extra);
-    return err ? null : stdout.trim();
-};
-
-/**
- * Extract info from stdout using regex pattern matching.
- * @param {string} stdout - Command output.
- * @param {string} key - Key to search for.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {string[]} Array of matched values.
- */
-const get_info = (stdout, key, log_extra) => {
-    const word_key = key.split(" ").join("\\s+");
-    const regex = new RegExp(`\n\\s?${word_key}\\s?:(.*)\\s`, 'g');
-    if (is_log_debug()) log_debug(LOG_BASH, `get_info regex:${JSON.stringify(regex)}`, log_extra);
-
-    const matched = [...stdout.matchAll(regex)].map(result => result[1].trim());
-    if (is_log_debug()) log_debug(LOG_BASH, `get_info matched:${JSON.stringify(matched)}`, log_extra);
-    return matched;
-};
-
-/**
- * Read key-value pairs from stdout.
- * @param {string} stdout - Command output.
- * @param {string} [delimiter=":"] - Key-value delimiter.
- * @param {number[]} [lines] - Specific lines to read.
- * @param {Object} [config] - Filter config for keys.
- * @param {boolean} [exclude_mode] - If true, exclude keys in config.
- * @returns {Object} Parsed key-value object.
- */
-const read_key_value_line = (stdout, delimiter = ":", lines, config, exclude_mode) => {
-    if (!stdout) return {};
-
-    const contents = stdout.toString().split(/(?:\r\n|\r|\n)/g);
-    const line_texts = lines ? lines.map(i => contents[i]) : contents;
-
-    return line_texts.reduce((obj, content) => {
-        const key_value = content.split(delimiter);
-        if (key_value.length !== 2) return obj;
-
-        const key = key_value[0].trim();
-        const should_include = !config ||
-            (exclude_mode !== true && config[key]) ||
-            (exclude_mode === true && !config[`!${key}`]);
-
-        if (key && should_include) obj[key] = key_value[1].trim();
-        return obj;
-    }, {});
-};
-
-/**
- * Read structured lines into array of objects.
- * @param {string} stdout - Command output.
- * @param {string[]} keys - Attribute keys for columns.
- * @param {number} [ignore=1] - Lines to skip at start.
- * @param {string} [delimiter="  "] - Column delimiter.
- * @returns {Object[]} Array of parsed objects.
- */
-const read_obj_line = (stdout, keys, ignore = 1, delimiter = "  ") => {
-    if (!stdout) return [];
-
-    return stdout.toString().split(/(?:\r\n|\r|\n)/g)
-        .slice(ignore)
-        .filter(content => content.trim().length > 0)
-        .map(content => {
-            const attrs = content.split(delimiter).filter(f => f.trim().length > 0);
-            return keys.reduce((obj, key, i) => {
-                if (attrs[i]) obj[key] = attrs[i].trim();
-                return obj;
-            }, {});
-        });
-};
-
-/**
- * Get multiple system attributes from remote host.
- * @param {Object} host - Host info.
- * @param {Array<{name: string, cmd: string}>} attrs - Attributes to fetch.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<Object>} Object with attribute values.
- */
-const get_system_attributes = async (host, attrs, log_extra) => {
-    const results = await Promise.all(attrs.map(attr => run_simple_cmd(host, attr.cmd, log_extra)));
-    return attrs.reduce((obj, attr, i) => {
-        if (results[i]) obj[attr.name] = results[i];
-        return obj;
-    }, {});
-};
-
-/**
- * Stop process on remote host if running.
- * @param {Object} host - Host info.
- * @param {string} process_name - Process name to stop.
- * @param {string} stop_cmd - Command to stop the process.
- * @param {boolean} [using_full] - Use pgrep -f for full command match.
- * @param {Object} [log_extra] - Additional logging context.
- * @returns {Promise<boolean>} True if process was running and stopped.
- */
-const stop_process = async (host, process_name, stop_cmd, using_full, log_extra) => {
-    const grep_cmd = using_full ? `pgrep -f "${process_name}" | wc -l` : `pgrep ${process_name} | wc -l`;
-    const { stdout } = await run_script(host, grep_cmd, log_extra);
-    const has_process = stdout && parseInt(stdout) > 0;
-    if (has_process) await run_script(host, stop_cmd, log_extra);
-    return has_process;
-};
-
-module.exports = {
-    stop_process, scp, scpr, run_script, run_script_extra, run_script_file,
-    run_simple_cmd, run_local_cmd, run_simple_local_cmd, get_info,
-    get_system_attributes, read_key_value_line, read_obj_line
-};

package/core/chart.js

@@ -1,46 +0,0 @@
-/**
- * @fileoverview Chart data processing utility functions.
- * @module core/chart
- */
-
-const { has_value } = require("./validate");
-
-/**
- * Set chart header prefix for all columns except the first.
- * @param {Array[]} arr - 2D array with headers in first row.
- * @param {string} prefix - Prefix to add to header names.
- */
-const set_chart_header = (arr, prefix) => {
-    if (!arr || arr.length < 1) return;
-    const headers = arr[0];
-    if (!headers || headers.length < 1) return;
-    for (let i = 1; i < headers.length; i++) {
-        headers[i] = `${prefix}${headers[i]}`;
-    }
-};
-
-/**
- * Merge two chart data arrays by combining columns.
- * @param {Array[]} arr1 - First 2D data array (will be modified).
- * @param {Array[]} arr2 - Second 2D data array to merge.
- */
-const merge_chart_data = (arr1, arr2) => {
-    if (!arr1 || arr1.length < 2 || !arr2 || arr2.length < 2) return;
-
-    const max = Math.max(arr1.length, arr2.length);
-    const arr1_cols = arr1[0].length;
-    const arr2_cols = arr2[0].length;
-
-    for (let i = 0; i < max; i++) {
-        if (!has_value(arr1[i])) {
-            arr1[i] = [...new Array(arr1_cols)].map(() => "");
-            arr1[i][0] = arr2[i][0];
-        }
-        if (!has_value(arr2[i])) {
-            arr2[i] = [...new Array(arr2_cols)].map(() => "");
-        }
-        arr1[i] = [...arr1[i], ...arr2[i].splice(1)];
-    }
-};
-
-module.exports = { set_chart_header, merge_chart_data };

package/core/cron.js

@@ -1,21 +0,0 @@
-/**
- * @fileoverview Cron job scheduling utility functions.
- * @module core/cron
- */
-
-const node_cron = require('node-cron');
-
-/**
- * Initialize and start cron jobs.
- * @param {string[]} crons - Array of cron expressions.
- * @param {Function[]} tasks - Array of task functions to execute.
- * @param {string} [timezone="Asia/Shanghai"] - Timezone for scheduling.
- */
-const init_cron = async (crons, tasks, timezone = "Asia/Shanghai") => {
-    crons.forEach((cron, index) => {
-        const schedule = node_cron.schedule(cron, () => tasks[index](), { scheduled: true, timezone });
-        schedule.start();
-    });
-};
-
-module.exports = { init_cron };

package/core/date.js

@@ -1,26 +0,0 @@
-/**
- * @fileoverview Date formatting and parsing utility functions.
- * @module core/date
- */
-
-const date_format = require("dateformat");
-
-const format_time = (date) => date_format(date, "HH:MM");
-const simple_date = (date) => date_format(date, "mm/dd");
-const format_date = (date) => date_format(date, "yyyymmdd");
-const format_date_time = (date) => date_format(date, "yyyymmdd HH:MM:ss");
-
-/**
- * Parse yyyymmdd formatted string to Date object.
- * @param {string} date - Date string in yyyymmdd format.
- * @returns {Date} Parsed Date object with time set to 00:00:00.
- */
-const parse_date = (date) => {
-  const [year, month, day] = [date.slice(0, 4), date.slice(4, 6), date.slice(6, 8)].map(Number);
-  const date_obj = new Date();
-  date_obj.setFullYear(year, month - 1, day);
-  date_obj.setHours(0, 0, 0, 0);
-  return date_obj;
-};
-
-module.exports = { simple_date, format_date, format_time, format_date_time, parse_date };

package/core/encrypt.js

@@ -1,26 +0,0 @@
-/**
- * @fileoverview Encryption and hashing utility functions.
- * @module core/encrypt
- */
-
-const crypto = require('crypto');
-const { get_settings } = require('../setting');
-
-/**
- * Generate MD5 hash of content.
- * @param {string} content - Content to hash.
- * @returns {string} MD5 hash in hex format.
- */
-const md5 = (content) => crypto.createHash('md5').update(content).digest('hex');
-
-/**
- * Encrypt password using MD5 with salt.
- * @param {string} password - Plain text password.
- * @returns {string} Encrypted password hash.
- */
-const encrypt_pwd = (password) => {
-    const crypto_key = get_settings().encrypt.key;
-    return md5(`BGT*&+${password}&76w${crypto_key}`);
-};
-
-module.exports = { md5, encrypt_pwd };

package/core/file.js

@@ -1,51 +0,0 @@
-/**
- * @fileoverview File system utility functions.
- * @module core/file
- */
-
-const fs = require('fs');
-const unzipper = require('unzipper');
-
-/**
- * Get file extension from filename.
- * @param {string} file_name - Name of the file.
- * @returns {string} File extension without dot.
- */
-const file_extension = (file_name) => file_name ? file_name.split('.').pop() : "";
-
-/**
- * Get file name without extension.
- * @param {string} file_name - Name of the file.
- * @returns {string} File name prefix.
- */
-const file_prefix = (file_name) => file_name ? file_name.split('.')[0] : "";
-
-/**
- * Read files from zip archive with filter.
- * @param {string} path - Path to zip file.
- * @param {Function} predicate - Filter function for files.
- * @returns {Promise<Object[]>} Array of matching file entries.
- */
-const read_from_zip = async (path, predicate) => {
-    const directory = await unzipper.Open.file(path);
-    return directory.files.filter(predicate);
-};
-
-const read_from_zip_by_extension = (path, extension) => read_from_zip(path, file => file_extension(file.path) === extension);
-const read_from_zip_by_prefix = (path, prefix) => read_from_zip(path, file => file_prefix(file.path) === prefix);
-
-/**
- * Check if file exists at path.
- * @param {string} path - File path to check.
- * @returns {boolean} True if file exists, false otherwise.
- */
-const is_file_exist = (path) => fs.existsSync(path);
-
-/**
- * Get file size in bytes.
- * @param {string} path - File path.
- * @returns {Promise<number>} File size in bytes.
- */
-const get_file_size = async (path) => (await fs.promises.stat(path)).size;
-
-module.exports = { file_extension, file_prefix, read_from_zip_by_extension, read_from_zip_by_prefix, is_file_exist, get_file_size };

package/core/lhs.js

@@ -1,53 +0,0 @@
-/**
- * @fileoverview Template execution utilities using Node.js VM.
- * @module core/lhs
- */
-
-const vm = require('node:vm');
-const { range, scale, space } = require("./number");
-
-/**
- * Get default context with number utilities.
- * @returns {Object} Context object with range, scale, and space functions.
- */
-const get_context = () => ({ range, scale, space });
-
-/**
- * Run code in VM context.
- * @param {string} code - JavaScript code to execute.
- * @param {Object} ctx - Context object for VM.
- * @returns {Object} Context object after execution.
- */
-const run_in_context = (code, ctx) => {
-    vm.createContext(ctx);
-    vm.runInContext(code, ctx);
-    return ctx;
-};
-
-/**
- * Verify template string is valid JavaScript.
- * @param {string} template - Template string to verify.
- * @param {Object} knob - Variable bindings for template.
- * @returns {string|null} Error message if invalid, null if valid.
- */
-const verify_template = (template, knob) => {
-    try {
-        run_in_context("__output__=`" + template + "`;", knob);
-        return null;
-    } catch (err) {
-        return err.message;
-    }
-};
-
-/**
- * Execute template string and return result.
- * @param {string} template - Template string to execute.
- * @param {Object} knob - Variable bindings for template.
- * @returns {string} Executed template output.
- */
-const execute_template = (template, knob) => {
-    const ctx = run_in_context("__output__=`" + template + "`;", knob);
-    return ctx["__output__"];
-};
-
-module.exports = { get_context, run_in_context, verify_template, execute_template };