blockmine 1.20.0 → 1.22.0

package/backend/src/core/config/validation.js

@@ -0,0 +1,27 @@
+/**
+ * Конфигурация для валидации
+ *
+ * Строгая валидация (выброс исключений) включена в dev/test окружениях
+ * В production валидация тоже выполняется, но только логирует ошибки
+ * вместо выброса исключений для предотвращения полного падения
+ */
+const VALIDATION_ENABLED = true;
+
+/**
+ * Строгий режим валидации - выбрасывать исключения при ошибках
+ * В production отключен для graceful degradation
+ */
+const VALIDATION_STRICT_MODE = process.env.NODE_ENV !== 'production';
+
+/**
+ * Максимальная глубина рекурсии для операций обхода графа
+ * Предотвращает бесконечные циклы в циклических структурах графа
+ * Значение 100 выбрано как норм лимит для типичной глубины графов
+ */
+const MAX_RECURSION_DEPTH = 100;
+
+module.exports = {
+    VALIDATION_ENABLED,
+    VALIDATION_STRICT_MODE,
+    MAX_RECURSION_DEPTH,
+};

package/backend/src/core/constants/graphTypes.js

@@ -0,0 +1,21 @@
+/**
+ * Константы для типов графов
+ * Используются для фильтрации доступных нод в зависимости от контекста
+ */
+
+/**
+ * @typedef {('all'|'command'|'event')} GraphType
+ */
+
+const GRAPH_TYPES = {
+    /** Нода доступна во всех типах графов */
+    ALL: 'all',
+    /** Нода доступна только в графах команд */
+    COMMAND: 'command',
+    /** Нода доступна только в графах событий */
+    EVENT: 'event',
+};
+
+module.exports = {
+    GRAPH_TYPES,
+};

package/backend/src/core/node-registries/actions.js

@@ -0,0 +1,132 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Действия"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'action:send_message',
+    label: '🗣️ Отправить сообщение',
+    category: 'Действия',
+    description: 'Отправляет сообщение в чат. Поддерживает переменные в формате {varName}',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    executor: require('../nodes/actions/send_message').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'chat_type', name: 'Тип чата', type: 'String', required: true },
+        { id: 'message', name: 'Сообщение', type: 'String', required: true },
+        { id: 'recipient', name: 'Адресат', type: 'String', required: false }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Выполнено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'action:send_log',
+    label: '📝 Записать в лог (веб)',
+    category: 'Действия',
+    description: 'Отправляет сообщение в консоль на странице бота.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/actions/send_log').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'message', name: 'Сообщение', type: 'String', required: true },
+      ],
+      outputs: [
+        { id: 'exec', name: 'Выполнено', type: 'Exec' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'action:send_websocket_response',
+    label: '📤 Отправить ответ в WebSocket',
+    category: 'WebSocket API',
+    description: 'Отправляет данные обратно клиенту, вызвавшему граф через WebSocket API.',
+    graphType: GRAPH_TYPES.EVENT,
+    executor: require('../nodes/actions/send_websocket_response').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'data', name: 'Данные', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Выполнено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'action:bot_look_at',
+    label: '🤖 Бот: Посмотреть на',
+    category: 'Действия',
+    description: 'Поворачивает голову бота в сторону координат или сущности.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/actions/bot_look_at').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'target', name: 'Цель (Позиция/Сущность)', type: 'Object', required: true },
+        { id: 'add_y', name: 'Прибавить к Y', type: 'Number', required: false }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Выполнено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'action:bot_set_variable',
+    label: '💾 Записать переменную',
+    category: 'Действия',
+    description: 'Сохраняет значение в переменную графа.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/actions/bot_set_variable').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'name', name: 'Имя', type: 'String', required: true },
+        { id: 'value', name: 'Значение', type: 'Wildcard', required: true },
+        { id: 'persist', name: 'Хранить в БД?', type: 'Boolean', required: false }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Выполнено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'action:http_request',
+    label: '🌐 HTTP-запрос',
+    category: 'Действия',
+    description: 'Выполняет HTTP-запрос (GET, POST, PUT, DELETE и т.д.) и возвращает ответ.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/actions/http_request').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'url', name: 'URL', type: 'String', required: true },
+        { id: 'method', name: 'Метод', type: 'String', required: false },
+        { id: 'headers', name: 'Заголовки (JSON)', type: 'String', required: false },
+        { id: 'body', name: 'Тело (JSON)', type: 'Wildcard', required: false },
+        { id: 'timeout', name: 'Таймаут (мс)', type: 'Number', required: false }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Успех', type: 'Exec' },
+        { id: 'exec_error', name: 'Ошибка', type: 'Exec' },
+        { id: 'status', name: 'Статус', type: 'Number' },
+        { id: 'response', name: 'Ответ', type: 'Wildcard' },
+        { id: 'response_headers', name: 'Заголовки ответа', type: 'Object' },
+        { id: 'success', name: 'Успешно', type: 'Boolean' },
+        { id: 'error', name: 'Ошибка', type: 'String' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

package/backend/src/core/node-registries/arrays.js

@@ -0,0 +1,137 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Массивы"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'array:get_random_element',
+    label: '🎲 Случайный элемент',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Возвращает случайный элемент из массива и его индекс.',
+    evaluator: require('../nodes/arrays/get_random_element').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true }
+      ],
+      outputs: [
+        { id: 'element', name: 'Элемент', type: 'Any' },
+        { id: 'index', name: 'Индекс', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:contains',
+    label: '🔍 Массив: Содержит',
+    category: 'Массив',
+    description: 'Проверяет, содержит ли массив указанный элемент и возвращает его индекс.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/contains').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'element', name: 'Элемент', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Найден', type: 'Boolean' },
+        { id: 'index', name: 'Индекс', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:get_by_index',
+    label: '📦 Элемент по индексу',
+    category: 'Массив',
+    description: 'Получает элемент массива по его индексу.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/get_by_index').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'index', name: 'Индекс', type: 'Number', required: true }
+      ],
+      outputs: [
+        { id: 'element', name: 'Элемент', type: 'Any' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:get_next',
+    label: '➡️ Следующий элемент',
+    category: 'Массив',
+    description: 'Получает следующий элемент массива.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/get_next').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'current_index', name: 'Текущий индекс', type: 'Number', required: true }
+      ],
+      outputs: [
+        { id: 'next_element', name: 'Следующий элемент', type: 'Any' },
+        { id: 'next_index', name: 'Следующий индекс', type: 'Number' },
+        { id: 'has_next', name: 'Есть следующий?', type: 'Boolean', description: 'True, если следующий элемент существует' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:add_element',
+    label: '➕ Добавить элемент',
+    category: 'Массив',
+    description: 'Добавляет элемент в конец массива.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/add_element').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'element', name: 'Элемент', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Новый массив', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:remove_by_index',
+    label: '➖ Удалить по индексу',
+    category: 'Массив',
+    description: 'Удаляет элемент из массива по его индексу.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/remove_by_index').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'index', name: 'Индекс', type: 'Number', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Новый массив', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'array:find_index',
+    label: '🔍 Найти индекс',
+    category: 'Массив',
+    description: 'Находит индекс элемента в массиве (или -1 если не найден).',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/arrays/find_index').evaluate,
+    pins: {
+      inputs: [
+        { id: 'array', name: 'Массив', type: 'Array', required: true },
+        { id: 'element', name: 'Элемент', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'index', name: 'Индекс', type: 'Number' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

package/backend/src/core/node-registries/bot.js

@@ -0,0 +1,23 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Бот"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'bot:get_position',
+    label: '🤖 Позиция бота',
+    category: 'Бот',
+    description: 'Возвращает текущую позицию бота в мире.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/bot/get_position').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'position', name: 'Позиция', type: 'Object' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

package/backend/src/core/node-registries/data.js

@@ -0,0 +1,290 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Данные"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'data:get_argument',
+    label: '📥 Получить аргумент',
+    category: 'Данные',
+    description: 'Получает значение аргумента команды по его имени.',
+    graphType: GRAPH_TYPES.COMMAND,
+    evaluator: require('../nodes/data/get_argument').evaluate,
+    data: {
+      argumentName: {
+        type: 'argument',
+        label: 'Аргумент'
+      }
+    },
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Any' },
+        { id: 'exists', name: 'Существует', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_variable',
+    label: '📤 Получить переменную',
+    category: 'Данные',
+    description: 'Получает значение переменной графа.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/get_variable').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Wildcard' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_entity_field',
+    label: '📦 Получить поле сущности',
+    category: 'Данные',
+    description: 'Получает определенное поле из объекта сущности (например, "position.x", "username").',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/get_entity_field').evaluate,
+    pins: {
+      inputs: [
+        { id: 'entity', name: 'Сущность', type: 'Object', required: true },
+      ],
+      outputs: [
+        { id: 'username', name: 'Никнейм', type: 'String' },
+        { id: 'type', name: 'Тип', type: 'String' },
+        { id: 'position', name: 'Позиция', type: 'Object' },
+        { id: 'isValid', name: 'Валидна', type: 'Boolean' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:string_literal',
+    label: '📜 Строка',
+    category: 'Данные',
+    description: 'Текстовое значение с поддержкой переменных. Используйте {имя} для вставки значений.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/data/string_literal').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'String' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:number_literal',
+    label: '🔢 Число',
+    category: 'Данные',
+    description: 'Простое числовое значение.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/number_literal').evaluate,
+    pins: {
+      inputs: [
+        { id: 'value', name: 'Значение', type: 'Number', required: true }
+      ],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:boolean_literal',
+    label: '✔️ Булево',
+    category: 'Данные',
+    description: 'Значение Истина/Ложь.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/boolean_literal').evaluate,
+    pins: {
+      inputs: [
+        { id: 'value', name: 'Значение', type: 'Boolean', required: true }
+      ],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:make_object',
+    label: '🏗️ Собрать объект',
+    category: 'Данные',
+    description: 'Создает JSON-объект из пар ключ-значение.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/data/make_object').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'value', name: 'Объект', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:cast',
+    label: '✨ Приведение типов',
+    category: 'Данные',
+    description: 'Приводит входящее значение к указанному целевому типу.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/cast').evaluate,
+    pins: {
+      inputs: [
+        { id: 'value', name: 'Значение', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Wildcard' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:type_check',
+    label: '🔍 Проверка типа',
+    category: 'Данные',
+    description: 'Проверяет тип входного значения.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/type_check').evaluate,
+    pins: {
+      inputs: [
+        { id: 'value', name: 'Значение', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Совпадает?', type: 'Boolean', description: 'True, если значение соответствует выбранному типу' },
+        { id: 'type_name', name: 'Имя типа', type: 'String', description: 'Фактическое название типа значения' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_server_players',
+    label: '👥 Список игроков',
+    category: 'Данные',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Возвращает массив с именами всех игроков на сервере.',
+    evaluator: require('../nodes/data/get_server_players').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'players', name: 'Игроки', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_nearby_entities',
+    label: '👁️ Получить существ рядом',
+    category: 'Данные',
+    description: 'Возвращает массив существ в радиусе от бота.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/get_nearby_entities').evaluate,
+    pins: {
+      inputs: [
+        { id: 'radius', name: 'Радиус', type: 'Number', required: false }
+      ],
+      outputs: [
+        { id: 'entities', name: 'Существа', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_nearby_players',
+    label: '👥 Игроки рядом',
+    category: 'Данные',
+    description: 'Возвращает массив игроков с расстоянием.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/get_nearby_players').evaluate,
+    pins: {
+      inputs: [
+        { id: 'radius', name: 'Радиус', type: 'Number', required: false }
+      ],
+      outputs: [
+        { id: 'players', name: 'Игроки', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:entity_info',
+    label: '🔍 Информация о существе',
+    category: 'Данные',
+    description: 'Извлекает данные из объекта существа.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/entity_info').evaluate,
+    pins: {
+      inputs: [
+        { id: 'entity', name: 'Существо', type: 'Object', required: true }
+      ],
+      outputs: [
+        { id: 'type', name: 'Тип', type: 'String' },
+        { id: 'username', name: 'Имя', type: 'String' },
+        { id: 'distance', name: 'Расстояние', type: 'Number' },
+        { id: 'position', name: 'Позиция', type: 'Object' },
+        { id: 'id', name: 'ID', type: 'Number' },
+        { id: 'isPlayer', name: 'Это игрок?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:get_user_field',
+    label: '👤 Данные пользователя',
+    category: 'Данные',
+    description: 'Получает различные данные из объекта пользователя.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/data/get_user_field').evaluate,
+    pins: {
+      inputs: [
+        { id: 'user', name: 'Пользователь', type: 'User', required: true }
+      ],
+      outputs: [
+        { id: 'username', name: 'Никнейм', type: 'String' },
+        { id: 'groups', name: 'Группы', type: 'Array' },
+        { id: 'permissions', name: 'Права', type: 'Array' },
+        { id: 'isBlacklisted', name: 'В черном списке', type: 'Boolean' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:length',
+    label: '📏 Размер (длина)',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Возвращает количество элементов в массиве или длину строки.',
+    evaluator: require('../nodes/data/length').evaluate,
+    pins: {
+      inputs: [
+        { id: 'data', name: 'Массив или Строка', type: 'Any', required: true }
+      ],
+      outputs: [
+        { id: 'length', name: 'Длина', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'data:array_literal',
+    label: '📋 Массив',
+    category: 'Массив',
+    description: 'Создает массив из элементов.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/data/array_literal').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'value', name: 'Массив', type: 'Array' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

package/backend/src/core/node-registries/debug.js

@@ -0,0 +1,26 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Отладка"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'debug:log',
+    label: '🐞 Отладка (консоль)',
+    category: 'Отладка',
+    description: 'Выводит значение в консоль терминала, где запущен бот.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/debug/log').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Exec', type: 'Exec' },
+        { id: 'value', name: 'Значение', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Exec', type: 'Exec' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };