blockmine 1.20.0 → 1.22.0

package/backend/src/core/PluginManager.js

@@ -38,7 +38,7 @@ function reportPluginDownload(pluginName) {
 
 
 class PluginManager {
-    constructor(botManager) {
+    constructor({ botManager } = {}) {
         this.botManager = botManager;
         this.ensureBaseDirExists();
     }
@@ -125,7 +125,7 @@ class PluginManager {
         return newPlugin;
     }
 
-    async installFromGithub(botId, repoUrl, prismaClient = prisma, isUpdate = false) {
+    async installFromGithub(botId, repoUrl, prismaClient = prisma, isUpdate = false, tag = null) {
         const botPluginsDir = path.join(PLUGINS_BASE_DIR, `bot_${botId}`);
         await fse.mkdir(botPluginsDir, { recursive: true });
 
@@ -137,17 +137,36 @@ class PluginManager {
         try {
             const url = new URL(repoUrl);
             const repoPath = url.pathname.replace(/^\/|\.git$/g, '');
-            const archiveUrlMain = `https://github.com/${repoPath}/archive/refs/heads/main.zip`;
-            const archiveUrlMaster = `https://github.com/${repoPath}/archive/refs/heads/master.zip`;
+            
+            let response;
+            
+            // Если указан тег - скачиваем конкретный релиз
+            if (tag) {
+                const archiveUrlTag = `https://github.com/${repoPath}/archive/refs/tags/${encodeURIComponent(tag)}.zip`;
+                console.log(`[PluginManager] Скачиваем релиз ${tag} из ${repoUrl}...`);
+                try {
+                    response = await fetch(archiveUrlTag);
+                } catch (err) {
+                    throw new Error(`Ошибка сети при скачивании релиза ${tag}: ${err.message || err}`);
+                }
+                if (!response.ok) {
+                    throw new Error(`Не удалось скачать релиз ${tag}. Статус: ${response.status}. Возможно, тег не существует.`);
+                }
+            } else {
+                // Если тег не указан - скачиваем последний коммит из main/master (старое поведение)
+                const archiveUrlMain = `https://github.com/${repoPath}/archive/refs/heads/main.zip`;
+                const archiveUrlMaster = `https://github.com/${repoPath}/archive/refs/heads/master.zip`;
 
-            let response = await fetch(archiveUrlMain);
-            if (!response.ok) {
-                console.log(`[PluginManager] Ветка 'main' не найдена для ${repoUrl}, пробую 'master'...`);
-                response = await fetch(archiveUrlMaster);
+                response = await fetch(archiveUrlMain);
                 if (!response.ok) {
-                    throw new Error(`Не удалось скачать архив плагина. Статус: ${response.status}`);
+                    console.log(`[PluginManager] Ветка 'main' не найдена для ${repoUrl}, пробую 'master'...`);
+                    response = await fetch(archiveUrlMaster);
+                    if (!response.ok) {
+                        throw new Error(`Не удалось скачать архив плагина. Статус: ${response.status}`);
+                    }
                 }
             }
+            
             const buffer = await response.arrayBuffer();
 
             const zip = new AdmZip(Buffer.from(buffer));
@@ -324,6 +343,7 @@ class PluginManager {
                         sourceUri: plugin.sourceUri,
                         currentVersion: localVersion,
                         recommendedVersion: recommendedVersion,
+                        latestTag: catalogInfo.latestTag, // 🏷️ Добавляем тег для использования при обновлении
                     });
                 }
             } catch (error) {
@@ -333,21 +353,51 @@ class PluginManager {
         return updatesAvailable;
     }
 
-    async updatePlugin(pluginId) {
+    async updatePlugin(pluginId, targetTag = null) {
         const plugin = await prisma.installedPlugin.findUnique({ where: { id: pluginId } });
         if (!plugin || plugin.sourceType !== 'GITHUB') {
             throw new Error('Плагин не найден или не является GitHub-плагином.');
         }
 
-        console.log(`[PluginManager] Начало обновления плагина ${plugin.name}...`);
+        console.log(`[PluginManager] Начало обновления плагина ${plugin.name}${targetTag ? ` до версии ${targetTag}` : ''}...`);
         
         const repoUrl = plugin.sourceUri;
         const botId = plugin.botId;
         
+        // Сохраняем настройки и важные данные перед удалением
+        const backupData = {
+            name: plugin.name,
+            settings: plugin.settings,
+            isEnabled: plugin.isEnabled,
+            // PluginDataStore сохранятся автоматически (привязаны к pluginName + botId)
+        };
+        console.log(`[PluginManager] Настройки плагина ${plugin.name} сохранены для миграции.`);
+        
+        // Удаляем старую версию
         await this.deletePlugin(pluginId);
         console.log(`[PluginManager] Старая версия ${plugin.name} удалена, устанавливаем новую...`);
         
-        return await this.installFromGithub(botId, repoUrl, prisma, true);
+        // Устанавливаем новую версию с конкретным тегом (если указан)
+        const newPlugin = await this.installFromGithub(botId, repoUrl, prisma, true, targetTag);
+        
+        // Восстанавливаем настройки
+        if (backupData.settings && newPlugin) {
+            try {
+                await prisma.installedPlugin.update({
+                    where: { id: newPlugin.id },
+                    data: {
+                        settings: backupData.settings,
+                        isEnabled: backupData.isEnabled,
+                    },
+                });
+                console.log(`[PluginManager] Настройки успешно восстановлены для ${plugin.name}`);
+            } catch (settingsError) {
+                console.error(`[PluginManager] Не удалось восстановить настройки для ${plugin.name}:`, settingsError);
+                // Не бросаем ошибку, т.к. плагин уже установлен
+            }
+        }
+        
+        return newPlugin;
     }
 
     async loadPluginGraphs(botId, pluginId, pluginPath) {

package/backend/src/core/PrismaService.js

@@ -0,0 +1,32 @@
+const { PrismaClient } = require('@prisma/client');
+
+/**
+ * Singleton service для PrismaClient
+ * Предотвращает утечки памяти используя одно соединение с БД
+ * Благодаря кешированию require в Node.js это фактический singleton
+ */
+class PrismaService {
+    constructor() {
+        this.prisma = new PrismaClient({
+            log: ['error', 'warn'],
+        });
+    }
+
+    /**
+     * Получить экземпляр Prisma client
+     * @returns {PrismaClient}
+     */
+    getClient() {
+        return this.prisma;
+    }
+
+    /**
+     * Отключиться от БД (вызывать при выключении приложения)
+     */
+    async disconnect() {
+        await this.prisma.$disconnect();
+    }
+}
+
+const prismaService = new PrismaService();
+module.exports = prismaService;

package/backend/src/core/UserService.js

@@ -10,15 +10,15 @@ class User {
     constructor(userInstance, botConfig = {}) {
         this.user = userInstance;
         this.botConfig = botConfig;
-        
+
         const globalOwners = ["merka", "akrem"];
         const keksikServers = ["mc.mineblaze.net", "mc.masedworld.net", "mc.cheatmine.net", "mc.dexland.org"];
-        
+
         const botOwners = (this.botConfig.owners || '').toLowerCase().split(',').map(s => s.trim()).filter(Boolean);
         const usernameLower = this.user.username.toLowerCase();
 
         this.isOwner = botOwners.includes(usernameLower) || (keksikServers.includes(this.botConfig.server?.host) && globalOwners.includes(usernameLower));
-        
+
         this.permissionsSet = new Set();
         if (this.user.groups) {
             this.user.groups.forEach(userGroup => {

package/backend/src/core/__tests__/PrismaService.test.js

@@ -0,0 +1,24 @@
+const prismaService = require('../PrismaService');
+
+describe('PrismaService', () => {
+    it('should return singleton instance', () => {
+        const service1 = require('../PrismaService');
+        const service2 = require('../PrismaService');
+
+        expect(service1).toBe(service2);
+    });
+
+    it('should provide getClient method', () => {
+        const client = prismaService.getClient();
+
+        expect(client).toBeDefined();
+        expect(typeof client.$connect).toBe('function');
+    });
+
+    it('should reuse same client instance', () => {
+        const client1 = prismaService.getClient();
+        const client2 = prismaService.getClient();
+
+        expect(client1).toBe(client2);
+    });
+});

package/backend/src/core/commands/README.md

@@ -0,0 +1,305 @@
+
+
+> ⚠️ **АХТУНГ**: ДОКУМЕНТАЦИЯ СГЕНЕРИРОВАНА @CLAUDE.
+
+# Создание команд для BlockMine
+
+Система команд BlockMine поддерживает две сигнатуры для handler'ов: **старую** (обратно совместимую) и **новую** (с CommandContext).
+
+## 📋 Две сигнатуры команд
+
+### 1️⃣ Старая сигнатура (рекомендуется для простых команд)
+
+```javascript
+async handler(bot, typeChat, user, args) {
+    // bot - экземпляр бота
+    // typeChat - тип чата ('chat', 'clan', 'private', 'websocket', etc)
+    // user - User объект с методами (hasPermission, addGroup, etc)
+    // args - объект с аргументами команды
+
+    const message = `Привет, ${user.username}!`;
+
+    // Для WebSocket API нужно вернуть результат
+    if (typeChat === 'websocket') {
+        return message;
+    }
+
+    // Для остальных отправляем в чат
+    bot.sendMessage(typeChat, message, user.username);
+}
+```
+
+### 2️⃣ Новая сигнатура (рекомендуется для универсальных команд)
+
+```javascript
+async handler(context) {
+    // context.bot - экземпляр бота
+    // context.user - User объект с методами
+    // context.args - объект с аргументами
+    // context.transport - Transport объект
+    // context.typeChat - тип чата (для совместимости)
+
+    const message = `Привет, ${context.user.username}!`;
+
+    // context.reply() автоматически работает для всех транспортов
+    return context.reply(message);
+}
+```
+
+## ✨ Автоматическое определение сигнатуры
+
+Система **автоматически** определяет какую сигнатуру использует команда:
+
+- **4 параметра** (`handler(bot, typeChat, user, args)`) → старая сигнатура
+- **1 параметр** (`handler(context)`) → новая сигнатура
+
+Вы можете использовать любую из них!
+
+## 📖 Примеры команд
+
+### Пример 1: Простая команда (старая сигнатура)
+
+```javascript
+const Command = require('../system/Command');
+
+class HelloCommand extends Command {
+    constructor() {
+        super({
+            name: 'hello',
+            description: 'Поздороваться с пользователем',
+            aliases: ['hi', 'привет'],
+            cooldown: 5,
+            permissions: 'user.say',
+            owner: 'system',
+            allowedChatTypes: ['chat', 'clan', 'private', 'websocket'],
+            args: []
+        });
+    }
+
+    async handler(bot, typeChat, user) {
+        const message = `Привет, ${user.username}!`;
+
+        if (typeChat === 'websocket') {
+            return message;
+        }
+
+        bot.sendMessage(typeChat, message, user.username);
+    }
+}
+
+module.exports = HelloCommand;
+```
+
+### Пример 2: Команда с аргументами (старая сигнатура)
+
+```javascript
+const Command = require('../system/Command');
+
+class SayCommand extends Command {
+    constructor() {
+        super({
+            name: 'say',
+            description: 'Отправить сообщение от имени бота',
+            cooldown: 3,
+            permissions: 'admin.say',
+            owner: 'system',
+            allowedChatTypes: ['chat', 'clan', 'websocket'],
+            args: [
+                {
+                    name: 'message',
+                    type: 'greedy_string',
+                    required: true,
+                    description: 'Текст сообщения'
+                }
+            ]
+        });
+    }
+
+    async handler(bot, typeChat, user, { message }) {
+        if (typeChat === 'websocket') {
+            bot.sendMessage('chat', message);
+            return `Сообщение отправлено: "${message}"`;
+        }
+
+        bot.sendMessage('chat', message);
+    }
+}
+
+module.exports = SayCommand;
+```
+
+### Пример 3: Универсальная команда (новая сигнатура)
+
+```javascript
+const Command = require('../system/Command');
+
+class InfoCommand extends Command {
+    constructor() {
+        super({
+            name: 'info',
+            description: 'Информация о пользователе',
+            cooldown: 10,
+            permissions: 'user.info',
+            owner: 'system',
+            allowedChatTypes: ['chat', 'private', 'websocket'],
+            args: [
+                {
+                    name: 'target',
+                    type: 'string',
+                    required: false,
+                    description: 'Имя пользователя'
+                }
+            ]
+        });
+    }
+
+    async handler(context) {
+        const targetUsername = context.args.target || context.user.username;
+
+        // Получаем данные о пользователе
+        const targetUser = await context.bot.api.getUser(targetUsername);
+
+        const groups = targetUser.groups.map(g => g.group.name).join(', ');
+        const message = `👤 ${targetUser.username}\n📋 Группы: ${groups}`;
+
+        // Автоматически работает для всех транспортов
+        return context.reply(message);
+    }
+}
+
+module.exports = InfoCommand;
+```
+
+### Пример 4: Команда с методами User (новая сигнатура)
+
+```javascript
+const Command = require('../system/Command');
+
+class PromoteCommand extends Command {
+    constructor() {
+        super({
+            name: 'promote',
+            description: 'Повысить пользователя до VIP',
+            cooldown: 0,
+            permissions: 'admin.promote',
+            owner: 'system',
+            allowedChatTypes: ['chat', 'private', 'websocket'],
+            args: [
+                {
+                    name: 'username',
+                    type: 'string',
+                    required: true,
+                    description: 'Имя пользователя'
+                }
+            ]
+        });
+    }
+
+    async handler(context) {
+        const targetUsername = context.args.username;
+
+        // Получаем полноценный User объект с методами
+        const targetUser = await context.bot.api.getUser(targetUsername);
+
+        // Используем методы User
+        if (targetUser.hasPermission('vip.*')) {
+            return context.reply(`${targetUsername} уже VIP!`);
+        }
+
+        await targetUser.addGroup('vip');
+        return context.reply(`✅ ${targetUsername} повышен до VIP!`);
+    }
+}
+
+module.exports = PromoteCommand;
+```
+
+## 🔄 Transport и CommandContext API
+
+### CommandContext
+
+```javascript
+class CommandContext {
+    bot          // Экземпляр бота
+    user         // User объект с методами
+    args         // Объект с аргументами
+    transport    // Transport объект
+    typeChat     // Тип чата (для обратной совместимости)
+
+    // Методы
+    reply(message)                           // Отправить ответ пользователю
+    sendTo(chatType, message, recipient)     // Отправить в конкретный чат
+    isWebSocket()                            // Проверка на WebSocket API
+    isMinecraft()                            // Проверка на Minecraft
+    getTransportName()                       // Получить название транспорта
+}
+```
+
+### Transport
+
+```javascript
+class Transport {
+    type         // 'websocket' | 'chat' | 'clan' | 'private' | 'telegram'
+    bot          // Экземпляр бота
+
+    // Методы
+    send(message, recipient)          // Отправить сообщение
+    isMinecraftTransport()            // Проверка на Minecraft
+    isUniversal()                     // Проверка на универсальный транспорт
+    isAllowedFor(allowedTypes)        // Проверка разрешений
+    getDisplayName()                  // Получить читаемое название
+}
+```
+
+## 🎯 Когда использовать какую сигнатуру?
+
+### Используйте **старую сигнатуру** если:
+- ✅ Команда простая и не требует сложной логики
+- ✅ Не нужны методы User (hasPermission, addGroup, etc)
+- ✅ Вы портируете существующие команды
+- ✅ Команда работает только в Minecraft
+
+### Используйте **новую сигнатуру** если:
+- ✅ Команда должна работать везде (Minecraft, WebSocket)
+- ✅ Нужны методы User (для управления группами, проверки прав и т.д.)
+- ✅ Команда сложная и требует чистого кода
+- ✅ Вы пишете новую команду с нуля
+
+## 🚀 Будущие транспорты
+
+Архитектура готова к добавлению новых транспортов:
+
+- **WebSocket API** ✅ (уже работает)
+- **Minecraft** ✅ (уже работает)
+
+Команды с новой сигнатурой (`handler(context)`) будут **автоматически** работать во всех транспортах!
+
+## 📝 Важные замечания
+
+1. **User восстановление**: User объект полностью восстанавливается в child process с помощью `UserService.getUser()`, поэтому все методы класса User доступны в командах.
+
+2. **Кэширование User**: UserService использует кэш, поэтому повторные вызовы `getUser()` не создают лишних запросов к БД.
+
+3. **WebSocket результаты**: Для WebSocket API команды должны либо **вернуть** результат через `return`, либо вызвать `context.reply()` (в новой сигнатуре).
+
+4. **Обратная совместимость**: Все существующие команды продолжают работать без изменений!
+
+## 🔍 Как система определяет сигнатуру
+
+Магия в `BotProcess.js`:
+
+```javascript
+// Проверяем количество параметров функции handler
+const handlerParamCount = commandInstance.handler.length;
+
+if (handlerParamCount === 1) {
+    // Новая сигнатура: handler(context)
+    const context = new CommandContext(bot, user, args, transport);
+    await commandInstance.handler(context);
+} else {
+    // Старая сигнатура: handler(bot, typeChat, user, args)
+    await commandInstance.handler(bot, typeChat, user, args);
+}
+```
+
+Система **автоматически** выбирает правильный способ вызова!

package/backend/src/core/commands/dev.js

@@ -14,29 +14,29 @@ class DevCommand extends Command {
             cooldown: 10,
             permissions: 'user.say',
             owner: 'system',
-            allowedChatTypes: ['chat', 'local', 'clan', 'private'],
+            allowedChatTypes: ['chat', 'local', 'clan', 'private', 'websocket'],
             args: []
         });
     }
 
     // Переопределяем метод для кастомного сообщения при отсутствии прав
     onInsufficientPermissions(bot, typeChat, user) {
-        bot.api.sendMessage(typeChat, `${user.username}, у вас нет прав для этой команды.`, user.username);
+        bot.sendMessage(typeChat, `${user.username}, у вас нет прав для этой команды.`, user.username);
     }
 
     // Переопределяем метод для неправильного типа чата
     onWrongChatType(bot, typeChat, user) {
-        bot.api.sendMessage('private', `${user.username}, команду dev нельзя использовать в чате типа "${typeChat}"`, user.username);
+        bot.sendMessage('private', `${user.username}, команду dev нельзя использовать в чате типа "${typeChat}"`, user.username);
     }
 
     // Переопределяем метод для кулдауна
     onCooldown(bot, typeChat, user, timeLeft) {
-        bot.api.sendMessage(typeChat, `${user.username}, подождите еще ${timeLeft} секунд перед повторным использованием команды.`, user.username);
+        bot.sendMessage(typeChat, `${user.username}, подождите еще ${timeLeft} секунд перед повторным использованием команды.`, user.username);
     }
 
     // Переопределяем метод для черного списка (по умолчанию ничего не отправляется)
     onBlacklisted(bot, typeChat, user) {
-        bot.api.sendMessage(typeChat, `${user.username}, вы находитесь в черном списке.`, user.username);
+        bot.sendMessage(typeChat, `${user.username}, вы находитесь в черном списке.`, user.username);
     }
 
     async handler(bot, typeChat, user) {
@@ -52,14 +52,20 @@ class DevCommand extends Command {
         }
 
         const enabledPluginsCount = bot.config.plugins.length;
-        
+
         const uniqueCommands = new Set();
         for (const command of bot.commands.values()) {
             uniqueCommands.add(command.name);
         }
         const totalCommandsCount = uniqueCommands.size;
 
-        bot.api.sendMessage(typeChat, `Бот создан с помощью - BlockMine. Версия: v${appVersion}. Активных плагинов: ${enabledPluginsCount}. Всего команд: ${totalCommandsCount}`, user.username);
+        const message = `Бот создан с помощью - BlockMine. Версия: v${appVersion}. Активных плагинов: ${enabledPluginsCount}. Всего команд: ${totalCommandsCount}`;
+
+        if (typeChat === 'websocket') {
+            return message;
+        }
+
+        bot.sendMessage(typeChat, message, user.username);
     }
 }
 

package/backend/src/core/commands/ping.js

@@ -9,7 +9,7 @@ class PingCommand extends Command {
             cooldown: 5,
             permissions: 'user.ping',
             owner: 'system',
-            allowedChatTypes: ['local', 'clan', 'private'],
+            allowedChatTypes: ['local', 'clan', 'private', 'websocket'],
             
             args: [
                 {
@@ -23,12 +23,18 @@ class PingCommand extends Command {
     }
 
     async handler(bot, typeChat, user, { target }) {
-
+        let message;
         if (target) {
-            bot.api.sendMessage(typeChat, `Понг, ${user.username}! Пингую игрока ${target}.`, user.username);
+            message = `Понг, ${user.username}! Пингую игрока ${target}.`;
         } else {
-            bot.api.sendMessage(typeChat, `Понг, ${user.username}!`, user.username);
+            message = `Понг, ${user.username}!`;
+        }
+
+        if (typeChat === 'websocket') {
+            return message;
         }
+
+        bot.sendMessage(typeChat, message, user.username);
     }
 }
 

package/backend/src/core/commands/whois.js

@@ -0,0 +1,63 @@
+const Command = require('../system/Command');
+
+class WhoisCommand extends Command {
+    constructor() {
+        super({
+            name: 'whois',
+            description: 'Показывает информацию о пользователе',
+            aliases: ['userinfo', 'кто'],
+            cooldown: 5,
+            permissions: 'user.whois',
+            owner: 'system',
+            allowedChatTypes: ['chat', 'local', 'clan', 'private', 'websocket'],
+            args: [
+                {
+                    name: 'username',
+                    type: 'string',
+                    required: false,
+                    description: 'Имя пользователя (по умолчанию - вы)'
+                }
+            ]
+        });
+    }
+
+    async handler(context) {
+        const targetUsername = context.args.username || context.user.username;
+
+        try {
+            const targetUser = await context.getUser(targetUsername);
+
+            // Получаем список групп
+            const groups = targetUser.groups
+                .map(ug => ug.group.name)
+                .join(', ') || 'Нет групп';
+
+            // Статус
+            const status = targetUser.isBlacklisted ? '⛔ В черном списке' : '✅ Активен';
+
+            // Форматируем вывод в зависимости от транспорта
+            let message;
+
+            if (context.isWebSocket()) {
+                // Для WebSocket API возвращаем структурированные данные
+                message = {
+                    username: targetUser.username,
+                    isOwner: targetUser.isOwner,
+                    isBlacklisted: targetUser.isBlacklisted,
+                    groups: targetUser.groups.map(ug => ug.group.name),
+                    status: status
+                };
+            } else {
+                message = `${targetUser.username} | Группы: ${groups} | ${status}`;
+            }
+
+            return context.reply(message);
+
+        } catch (error) {
+            const errorMsg = `❌ Ошибка: ${error.message}`;
+            return context.reply(errorMsg);
+        }
+    }
+}
+
+module.exports = WhoisCommand;