blockmine 1.21.0 → 1.23.0

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 };

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

@@ -0,0 +1,201 @@
+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:botStartup',
+    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,62 @@
+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' }
+      ]
+    }
+  });
+
+  registry.registerNodeType({
+    type: 'logic:not',
+    label: '! НЕ',
+    category: 'Логика',
+    description: 'Инвертирует boolean значение (NOT).',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../nodes/logic/not').evaluate,
+    pins: {
+      inputs: [
+        { id: 'value', name: 'Значение', type: 'Boolean', required: false }
+      ],
+      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 };