blockmine 1.19.1 → 1.21.0

package/backend/src/core/nodes/action_send_log.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с пина.
+ * @param {function} helpers.traverse - Функция для перехода к следующему узлу.
+ */
+async function execute(node, context, helpers) {
+    const message = await helpers.resolvePinValue(node, 'message', '');
+    
+    // this.botManager - это экземпляр botManager из GraphExecutionEngine
+    if (this.botManager?.appendLog && context?.botId) {
+        this.botManager.appendLog(context.botId, `[Graph] ${message}`);
+    } else {
+        console.log(`[Graph Log] ${message}`);
+    }
+
+    await helpers.traverse(node, 'exec');
+}
+
+module.exports = {
+    execute,
+};

package/backend/src/core/nodes/action_send_message.js

@@ -0,0 +1,32 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с пина.
+ * @param {function} helpers.traverse - Функция для перехода к следующему узлу.
+ */
+async function execute(node, context, helpers) {
+    const { resolvePinValue, traverse } = helpers;
+
+    let message = String(await resolvePinValue(node, 'message', ''));
+    const chatType = await resolvePinValue(node, 'chat_type', context.typeChat);
+    const recipient = await resolvePinValue(node, 'recipient', context.user?.username);
+
+    // Парсим и заменяем переменные в формате {varName}
+    const variablePattern = /\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+    const matches = [...message.matchAll(variablePattern)];
+
+    for (const match of matches) {
+        const varName = match[1];
+        // Для динамических пинов, созданных на фронтенде, значение нужно будет получить, используя resolvePinValue
+        const varValue = await resolvePinValue(node, `var_${varName}`, '');
+        message = message.replace(match[0], String(varValue));
+    }
+
+    context.bot.sendMessage(chatType, message, recipient);
+    await traverse(node, 'exec');
+}
+
+module.exports = {
+    execute,
+};

package/backend/src/core/nodes/array_add_element.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'result') {
+        const arr = await resolvePinValue(node, 'array', []);
+        const element = await resolvePinValue(node, 'element', null);
+        return Array.isArray(arr) ? [...arr, element] : [element];
+    }
+
+    return [];
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/array_contains.js

@@ -0,0 +1,40 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @param {Map} helpers.memo - Map для хранения мемоизированных значений.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue, memo } = helpers;
+
+    const arr = await resolvePinValue(node, 'array', []);
+    const element = await resolvePinValue(node, 'element', null);
+
+    if (Array.isArray(arr)) {
+        const index = arr.indexOf(element);
+        memo.set(`${node.id}:index`, index);
+
+        if (pinId === 'result') {
+            return index !== -1;
+        } else if (pinId === 'index') {
+            return index;
+        }
+    } else {
+        memo.set(`${node.id}:index`, -1);
+
+        if (pinId === 'result') {
+            return false;
+        } else if (pinId === 'index') {
+            return -1;
+        }
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/array_find_index.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'index') {
+        const arr = await resolvePinValue(node, 'array', []);
+        const element = await resolvePinValue(node, 'element', null);
+        return Array.isArray(arr) ? arr.indexOf(element) : -1;
+    }
+
+    return -1;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/array_get_by_index.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'element') {
+        const arr = await resolvePinValue(node, 'array', []);
+        const index = await resolvePinValue(node, 'index', -1);
+        return (!Array.isArray(arr) || index < 0 || index >= arr.length) ? null : arr[index];
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/array_get_random_element.js

@@ -0,0 +1,32 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @param {Map} helpers.memo - Map для хранения мемоизированных значений.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue, memo } = helpers;
+
+    const arr = await resolvePinValue(node, 'array', []);
+    if (!Array.isArray(arr) || arr.length === 0) {
+        return pinId === 'index' ? -1 : null;
+    }
+
+    const randomIndex = Math.floor(Math.random() * arr.length);
+    memo.set(`${node.id}:index`, randomIndex);
+
+    if (pinId === 'element') {
+        return arr[randomIndex];
+    } else if (pinId === 'index') {
+        return randomIndex;
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/array_remove_by_index.js

@@ -0,0 +1,30 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'result') {
+        const arr = await resolvePinValue(node, 'array', []);
+        const index = await resolvePinValue(node, 'index', -1);
+
+        if (!Array.isArray(arr) || index < 0 || index >= arr.length) {
+            return arr || [];
+        }
+
+        const newArr = [...arr];
+        newArr.splice(index, 1);
+        return newArr;
+    }
+
+    return [];
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/bot_get_position.js

@@ -0,0 +1,20 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    if (pinId === 'position') {
+        if (context.bot?.entity?.position) {
+            return context.bot.entity.position;
+        }
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_array_literal.js

@@ -0,0 +1,31 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        const numPins = node.data?.pinCount || 0;
+        const items = [];
+
+        for (let i = 0; i < numPins; i++) {
+            const value = await resolvePinValue(node, `pin_${i}`) ||
+                         node.data?.[`item_${i}`] ||
+                         node.data?.[`value_${i}`];
+            items.push(value);
+        }
+
+        return items;
+    }
+
+    return [];
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_boolean_literal.js

@@ -0,0 +1,21 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        return await resolvePinValue(node, 'value', false);
+    }
+
+    return false;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_cast.js

@@ -0,0 +1,34 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        const value = await resolvePinValue(node, 'value');
+        const targetType = node.data?.targetType || 'String';
+
+        switch (targetType) {
+            case 'String':
+                return String(value ?? '');
+            case 'Number':
+                const num = Number(value);
+                return isNaN(num) ? 0 : num;
+            case 'Boolean':
+                return ['true', '1', 'yes'].includes(String(value).toLowerCase());
+            default:
+                return value;
+        }
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_argument.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers, defaultValue = null) {
+    const args = context.args || {};
+    const argName = node.data?.argumentName || '';
+
+    if (pinId === 'value') {
+        return args && argName && args[argName] !== undefined ? args[argName] : defaultValue;
+    } else if (pinId === 'exists') {
+        return args && argName && args[argName] !== undefined;
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_bot_look.js

@@ -0,0 +1,14 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    return context.botState ? { yaw: context.botState.yaw, pitch: context.botState.pitch } : null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_entity_field.js

@@ -0,0 +1,18 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers, defaultValue = null) {
+    const { resolvePinValue } = helpers;
+
+    const entity = await resolvePinValue(node, 'entity');
+    return entity ? entity[pinId] : defaultValue;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_server_players.js

@@ -0,0 +1,18 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    if (pinId === 'players') {
+        return context.players || [];
+    }
+
+    return [];
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_user_field.js

@@ -0,0 +1,40 @@
+const User = require('../UserService');
+
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers, defaultValue = null) {
+    const { resolvePinValue } = helpers;
+
+    const userIdentifier = await resolvePinValue(node, 'user');
+    let userObject = null;
+
+    if (userIdentifier && typeof userIdentifier === 'object' && userIdentifier.username) {
+        userObject = userIdentifier;
+    } else if (typeof userIdentifier === 'string' && userIdentifier.length > 0) {
+        userObject = await User.getUser(userIdentifier, context.botId);
+    }
+
+    if (userObject) {
+        if (pinId === 'username') {
+            return userObject.username;
+        } else if (pinId === 'groups') {
+            return userObject.groups ? userObject.groups.map(g => g.group?.name).filter(Boolean) : [];
+        } else if (pinId === 'permissions') {
+            return userObject.permissionsSet ? Array.from(userObject.permissionsSet) : [];
+        } else if (pinId === 'isBlacklisted') {
+            return !!userObject.isBlacklisted;
+        }
+    }
+
+    return defaultValue;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_get_variable.js

@@ -0,0 +1,23 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    if (pinId === 'value') {
+        const varName = node.data?.variableName || node.data?.selectedVariable || '';
+        if (!varName) {
+            console.warn('[GraphExecutionEngine] data:get_variable: не указано имя переменной', node.data);
+            return null;
+        }
+        return context.variables.hasOwnProperty(varName) ? context.variables[varName] : null;
+    }
+
+    return null;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_length.js

@@ -0,0 +1,25 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'length') {
+        const data = await resolvePinValue(node, 'data');
+        if (Array.isArray(data) || typeof data === 'string') {
+            return data.length;
+        }
+        return 0;
+    }
+
+    return 0;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_make_object.js

@@ -0,0 +1,31 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        const numPins = node.data?.pinCount || 0;
+        const obj = {};
+
+        for (let i = 0; i < numPins; i++) {
+            const key = node.data[`key_${i}`];
+            if (key) {
+                obj[key] = await resolvePinValue(node, `value_${i}`);
+            }
+        }
+
+        return obj;
+    }
+
+    return {};
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_number_literal.js

@@ -0,0 +1,21 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        return await resolvePinValue(node, 'value', 0);
+    }
+
+    return 0;
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/data_string_literal.js

@@ -0,0 +1,34 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {string} pinId - Идентификатор выходного пина, значение которого нужно вычислить.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с входного пина.
+ * @returns {Promise<any>} - Вычисленное значение для выходного пина.
+ */
+async function evaluate(node, pinId, context, helpers) {
+    const { resolvePinValue } = helpers;
+
+    if (pinId === 'value') {
+        let text = String(node.data?.value || '');
+
+        // Парсим и заменяем переменные в формате {varName}
+        const variablePattern = /\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+        const matches = [...text.matchAll(variablePattern)];
+
+        for (const match of matches) {
+            const varName = match[1];
+            // Получаем значение из динамического пина
+            const varValue = await resolvePinValue(node, `var_${varName}`, '');
+            text = text.replace(match[0], String(varValue));
+        }
+
+        return text;
+    }
+
+    return '';
+}
+
+module.exports = {
+    evaluate,
+};

package/backend/src/core/nodes/debug_log.js

@@ -0,0 +1,16 @@
+/**
+ * @param {object} node - The node instance from the graph.
+ * @param {object} context - The execution context.
+ * @param {object} helpers - Execution helpers.
+ * @param {function} helpers.resolvePinValue - Function to resolve a pin's value.
+ * @param {function} helpers.traverse - Function to continue execution to the next node.
+ */
+async function execute(node, context, helpers) {
+    const value = await helpers.resolvePinValue(node, 'value');
+    console.log('[Graph Debug]', value);
+    await helpers.traverse(node, 'exec');
+}
+
+module.exports = {
+    execute,
+};

package/backend/src/core/nodes/flow_branch.js

@@ -0,0 +1,15 @@
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ * @param {function} helpers.resolvePinValue - Функция для получения значения с пина.
+ * @param {function} helpers.traverse - Функция для перехода к следующему узлу.
+ */
+async function execute(node, context, helpers) {
+    const condition = await helpers.resolvePinValue(node, 'condition', false);
+    await helpers.traverse(node, condition ? 'exec_true' : 'exec_false');
+}
+
+module.exports = {
+    execute,
+};

package/backend/src/core/nodes/flow_break.js

@@ -0,0 +1,14 @@
+const BreakLoopSignal = require('../BreakLoopSignal');
+
+/**
+ * @param {object} node - Экземпляр узла из графа.
+ * @param {object} context - Контекст выполнения графа.
+ * @param {object} helpers - Вспомогательные функции движка.
+ */
+async function execute(node, context, helpers) {
+    throw new BreakLoopSignal();
+}
+
+module.exports = {
+    execute,
+};