blockmine 1.21.0 → 1.22.0

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

@@ -0,0 +1,187 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "События"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'event:command',
+    label: '▶️ При выполнении команды',
+    category: 'События',
+    description: 'Стартовая точка для графа команды.',
+    graphType: GRAPH_TYPES.ALL, // нужно что бы события можно было расширять делая систему событий более комплексную объединяю функии команды и так далее
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'command_name', name: 'Имя команды', type: 'String' },
+        { id: 'user', name: 'Пользователь', type: 'User' },
+        { id: 'args', name: 'Аргументы', type: 'Object' },
+        { id: 'chat_type', name: 'Тип чата', type: 'String' },
+        { id: 'success', name: 'Успешно', type: 'Boolean', description: 'Возвращает true, если команда не попала на ошибку (нет прав, кулдаун, неверный тип чата и т.д.)' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:chat',
+    name: 'Событие: Сообщение в чате',
+    label: '💬 Сообщение в чате',
+    description: 'Срабатывает, когда в чат приходит сообщение.',
+    category: 'События',
+    graphType: GRAPH_TYPES.EVENT,
+    isEvent: true,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', type: 'Exec', name: 'Выполнить' },
+        { id: 'username', type: 'String', name: 'Игрок' },
+        { id: 'message', type: 'String', name: 'Сообщение' },
+        { id: 'chatType', type: 'String', name: 'Тип чата' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:raw_message',
+    name: 'Событие: Сырое сообщение',
+    label: '📝 Сырое сообщение',
+    description: 'Срабатывает при получении любого сообщения в сыром виде (до парсинга).',
+    category: 'События',
+    graphType: GRAPH_TYPES.EVENT,
+    isEvent: true,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', type: 'Exec', name: 'Выполнить' },
+        { id: 'rawText', type: 'String', name: 'Сырой текст' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:playerJoined',
+    label: '👋 Игрок зашел',
+    category: 'События',
+    description: 'Срабатывает, когда игрок заходит на сервер.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'user', name: 'Пользователь', type: 'User' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:playerLeft',
+    label: '🚪 Игрок вышел',
+    category: 'События',
+    description: 'Срабатывает, когда игрок покидает сервер.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'user', name: 'Пользователь', type: 'User' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:entitySpawn',
+    label: '📦 Сущность появилась',
+    category: 'События',
+    description: 'Вызывается, когда новая сущность появляется в поле зрения бота.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'entity', name: 'Сущность', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:entityMoved',
+    label: '🧍 Сущность подвинулась',
+    category: 'События',
+    description: 'Вызывается, когда любая сущность перемещается.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'entity', name: 'Сущность', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:entityGone',
+    label: '❌ Сущность исчезла',
+    category: 'События',
+    description: 'Вызывается, когда сущность пропадает из зоны видимости бота.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'entity', name: 'Сущность', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:botDied',
+    label: '💀 Бот умер',
+    category: 'События',
+    description: 'Срабатывает, когда бот умирает.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:health',
+    label: '❤️ Здоровье/Голод изменилось',
+    category: 'События',
+    description: 'Срабатывает при изменении здоровья, голода или насыщения бота.',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'health', name: 'Здоровье', type: 'Number' },
+        { id: 'food', name: 'Голод', type: 'Number' },
+        { id: 'saturation', name: 'Насыщение', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'event:websocket_call',
+    label: '📡 Вызов из WebSocket API',
+    category: 'События',
+    description: 'Срабатывает, когда граф вызывается через WebSocket API методом callGraph().',
+    graphType: GRAPH_TYPES.EVENT,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec' },
+        { id: 'graphName', name: 'Имя графа', type: 'String' },
+        { id: 'data', name: 'Данные', type: 'Object' },
+        { id: 'socketId', name: 'Socket ID', type: 'String' },
+        { id: 'keyPrefix', name: 'API ключ (префикс)', type: 'String' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

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

@@ -0,0 +1,139 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Управление потоком" (Поток)
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'flow:branch',
+    label: '↔️ Ветвление (Branch)',
+    category: 'Поток',
+    description: 'if/else логика',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/branch').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'condition', name: 'Условие', type: 'Boolean', required: true }
+      ],
+      outputs: [
+        { id: 'exec_true', name: 'True', type: 'Exec' },
+        { id: 'exec_false', name: 'False', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:sequence',
+    label: '⛓️ Последовательность',
+    category: 'Поток',
+    description: 'Выполняет действия по очереди',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/sequence').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true }
+      ],
+      outputs: [
+        { id: 'exec_0', name: '0', type: 'Exec' },
+        { id: 'exec_1', name: '1', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:for_each',
+    label: '🔁 Перебор массива (цикл)',
+    category: 'Поток',
+    description: 'Выполняет "Тело цикла" для каждого элемента в "Массиве".',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/for_each').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'array', name: 'Массив', type: 'Array', required: true }
+      ],
+      outputs: [
+        { id: 'loop_body', name: 'Тело цикла', type: 'Exec' },
+        { id: 'element', name: 'Элемент', type: 'Any' },
+        { id: 'index', name: 'Индекс', type: 'Number' },
+        { id: 'completed', name: 'Завершено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:while',
+    label: '🔁 Цикл While',
+    category: 'Поток',
+    description: 'Выполняет "Тело цикла" пока условие истинно.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/while').execute,
+    evaluator: require('../nodes/flow/while').evaluate,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'condition', name: 'Условие', type: 'Boolean', required: true }
+      ],
+      outputs: [
+        { id: 'loop_body', name: 'Тело цикла', type: 'Exec' },
+        { id: 'iteration', name: 'Итерация', type: 'Number' },
+        { id: 'completed', name: 'Завершено', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:break',
+    label: '🛑 Выйти из цикла',
+    category: 'Поток',
+    description: 'Немедленно прерывает выполнение цикла (For Each Loop) и передает управление на его выход Completed.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/break').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true }
+      ],
+      outputs: []
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:delay',
+    label: '⏱️ Задержка',
+    category: 'Поток',
+    description: 'Ожидает указанное количество миллисекунд, затем продолжает выполнение.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../nodes/flow/delay').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'delay', name: 'Задержка (мс)', type: 'Number', required: false }
+      ],
+      outputs: [
+        { id: 'exec', name: 'Далее', type: 'Exec' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'flow:switch',
+    label: '🔄 Switch (свитч)',
+    category: 'Поток',
+    description: 'Выполняет разные действия в зависимости от значения. Автоматически определяет тип сравнения.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    executor: require('../nodes/flow/switch').execute,
+    pins: {
+      inputs: [
+        { id: 'exec', name: 'Выполнить', type: 'Exec', required: true },
+        { id: 'value', name: 'Значение', type: 'Wildcard', required: true }
+      ],
+      outputs: [
+        { id: 'default', name: 'Default', type: 'Exec' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

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

@@ -0,0 +1,45 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Логика"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'logic:operation',
+    label: '💡 Логика',
+    category: 'Логика',
+    description: 'Выполняет логическую операцию. Для НЕ (NOT) используется только вход А.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/logic/operation').evaluate,
+    pins: {
+      inputs: [
+        { id: 'a', name: 'A', type: 'Boolean', required: true },
+        { id: 'b', name: 'B', type: 'Boolean', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Результат', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'logic:compare',
+    label: '⎗ Сравнение',
+    category: 'Логика',
+    description: 'Сравнивает два значения.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/logic/compare').evaluate,
+    pins: {
+      inputs: [
+        { id: 'a', name: 'A', type: 'Wildcard' },
+        { id: 'b', name: 'B', type: 'Wildcard' }
+      ],
+      outputs: [
+        { id: 'result', name: 'Результат', type: 'Boolean' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

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

@@ -0,0 +1,42 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Математика"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'math:operation',
+    label: '🔢 Математика',
+    category: 'Математика',
+    description: 'Выполняет математическую операцию над двумя числами.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/math/operation').evaluate,
+    pins: {
+      inputs: [
+        { id: 'a', name: 'A', type: 'Number', required: true },
+        { id: 'b', name: 'B', type: 'Number', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Результат', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'math:random_number',
+    label: '🎲 Случайное число',
+    category: 'Математика',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Генерирует случайное число в заданном диапазоне.',
+    evaluator: require('../nodes/math/random_number').evaluate,
+    pins: {
+      inputs: [
+        { id: 'min', name: 'Мин', type: 'Number' },
+        { id: 'max', name: 'Макс', type: 'Number' }
+      ],
+      outputs: [{ id: 'result', name: 'Результат', type: 'Number' }]
+    }
+  });
+}
+
+module.exports = { registerNodes };

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

@@ -0,0 +1,98 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Объекты"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'object:create',
+    label: '🏗️ Создать объект',
+    category: 'Объект',
+    description: 'Создает объект из пар ключ-значение.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/objects/create').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'object', name: 'Объект', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'object:get',
+    label: '📤 Получить значение',
+    category: 'Объект',
+    description: 'Получает значение по ключу из объекта.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/objects/get').evaluate,
+    pins: {
+      inputs: [
+        { id: 'object', name: 'Объект', type: 'Object', required: true },
+        { id: 'key', name: 'Ключ', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'value', name: 'Значение', type: 'Any' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'object:set',
+    label: '➕ Добавить/Изменить ключ',
+    category: 'Объект',
+    description: 'Добавляет или изменяет значение по ключу в объекте.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/objects/set').evaluate,
+    pins: {
+      inputs: [
+        { id: 'object', name: 'Объект', type: 'Object', required: true },
+        { id: 'key', name: 'Ключ', type: 'String', required: true },
+        { id: 'value', name: 'Значение', type: 'Any', required: true }
+      ],
+      outputs: [
+        { id: 'new_object', name: 'Новый объект', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'object:delete',
+    label: '➖ Удалить ключ',
+    category: 'Объект',
+    description: 'Удаляет ключ из объекта.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/objects/delete').evaluate,
+    pins: {
+      inputs: [
+        { id: 'object', name: 'Объект', type: 'Object', required: true },
+        { id: 'key', name: 'Ключ', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'new_object', name: 'Новый объект', type: 'Object' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'object:has_key',
+    label: '🔍 Проверить ключ',
+    category: 'Объект',
+    description: 'Проверяет наличие ключа в объекте и возвращает значение.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/objects/has_key').evaluate,
+    pins: {
+      inputs: [
+        { id: 'object', name: 'Объект', type: 'Object', required: true },
+        { id: 'key', name: 'Ключ', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Найден', type: 'Boolean' },
+        { id: 'value', name: 'Значение', type: 'Any' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };

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

@@ -0,0 +1,153 @@
+const { GRAPH_TYPES } = require('../constants/graphTypes');
+
+/**
+ * Регистрация нод категории "Строки"
+ */
+function registerNodes(registry) {
+  registry.registerNodeType({
+    type: 'string:contains',
+    label: '🔍 Строка содержит',
+    category: 'Строки',
+    description: 'Проверяет, содержит ли одна строка другую.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/contains').evaluate,
+    pins: {
+      inputs: [
+        { id: 'haystack', name: 'Строка', type: 'String', required: true },
+        { id: 'needle', name: 'Подстрока', type: 'String', required: true },
+        { id: 'case_sensitive', name: 'Учет регистра', type: 'Boolean', required: false }
+      ],
+      outputs: [
+        { id: 'result', name: 'Содержит?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:matches',
+    label: '🔎 RegEx совпадает',
+    category: 'Строки',
+    description: 'Проверяет совпадение с регулярным выражением.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/matches').evaluate,
+    pins: {
+      inputs: [
+        { id: 'string', name: 'Строка', type: 'String', required: true },
+        { id: 'regex', name: 'RegEx', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'result', name: 'Совпадает?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:equals',
+    label: '🔤 Строка равна',
+    category: 'Строки',
+    description: 'Проверяет равенство двух строк.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/equals').evaluate,
+    pins: {
+      inputs: [
+        { id: 'a', name: 'A', type: 'String', required: true },
+        { id: 'b', name: 'B', type: 'String', required: true },
+        { id: 'case_sensitive', name: 'Учет регистра', type: 'Boolean', required: false }
+      ],
+      outputs: [
+        { id: 'result', name: 'Равны?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:starts_with',
+    label: '▶️ Начинается с',
+    category: 'Строки',
+    description: 'Проверяет, начинается ли строка с подстроки.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/starts_with').evaluate,
+    pins: {
+      inputs: [
+        { id: 'string', name: 'Строка', type: 'String', required: true },
+        { id: 'prefix', name: 'Префикс', type: 'String', required: true },
+        { id: 'case_sensitive', name: 'Учет регистра', type: 'Boolean', required: false }
+      ],
+      outputs: [
+        { id: 'result', name: 'Начинается?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:ends_with',
+    label: '◀️ Заканчивается на',
+    category: 'Строки',
+    description: 'Проверяет, заканчивается ли строка подстрокой.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/ends_with').evaluate,
+    pins: {
+      inputs: [
+        { id: 'string', name: 'Строка', type: 'String', required: true },
+        { id: 'suffix', name: 'Суффикс', type: 'String', required: true },
+        { id: 'case_sensitive', name: 'Учет регистра', type: 'Boolean', required: false }
+      ],
+      outputs: [
+        { id: 'result', name: 'Заканчивается?', type: 'Boolean' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:length',
+    label: '📏 Длина строки',
+    category: 'Строки',
+    description: 'Возвращает количество символов.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/length').evaluate,
+    pins: {
+      inputs: [
+        { id: 'string', name: 'Строка', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'length', name: 'Длина', type: 'Number' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:split',
+    label: '✂️ Разделить строку',
+    category: 'Строки',
+    description: 'Разделяет строку на массив по разделителю.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/strings/split').evaluate,
+    pins: {
+      inputs: [
+        { id: 'string', name: 'Строка', type: 'String', required: true },
+        { id: 'separator', name: 'Разделитель', type: 'String', required: true }
+      ],
+      outputs: [
+        { id: 'array', name: 'Массив', type: 'Array' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'string:concat',
+    label: 'Строка: Объединить',
+    category: 'Строки',
+    description: 'Объединяет две или более строки в одну.',
+    graphType: GRAPH_TYPES.ALL,
+    dynamicPins: true,
+    evaluator: require('../nodes/strings/concat').evaluate,
+    pins: {
+      inputs: [],
+      outputs: [
+        { id: 'result', name: 'Результат', type: 'String' }
+      ]
+    }
+  });
+}
+
+module.exports = { registerNodes };