blockmine 1.21.0 → 1.22.0

package/CHANGELOG.md

@@ -1,57 +1,93 @@
-# История версий
-
-
-## [1.21.0](https://github.com/blockmineJS/blockmine/compare/v1.20.0...v1.21.0) (2025-10-26)
-
-
-### 🛠 Рефакторинг
-
-* [graph-system] все ноды отрефакторены и перенесены. [@claude](https://github.com/claude) author ([55db1b8](https://github.com/blockmineJS/blockmine/commit/55db1b89dbe470691db129a72c7efe55030acfa6))
-
-
-### ✨ Новые возможности
-
-* [graph-system]  пкм. по названию переменной можно найти - Получить/Установить переменную ([83b822f](https://github.com/blockmineJS/blockmine/commit/83b822ff1d278dfb9e280909c81ab32fd0e58bc3))
-* [graph-system] конвертация нод при подключения не к тем типам ([03deac8](https://github.com/blockmineJS/blockmine/commit/03deac83c9468199a8f6ae2b2480248c52a39e57))
-* добавление виртуализации для списков плагинов и ботов ([ea7746f](https://github.com/blockmineJS/blockmine/commit/ea7746f5c7f05ed74e6893bb27774d8541e0c57f))
-* новая нода для http запросов ([3565d06](https://github.com/blockmineJS/blockmine/commit/3565d06bff419c2d2665eba719a4c94696db00ae))
-
-## [1.20.0](https://github.com/blockmineJS/blockmine/compare/v1.19.1...v1.20.0) (2025-10-23)
-
-
-### ✨ Новые возможности
-
-* если бот падает 5 раз с критической ошибкой, то перезапуск отменяется ([2ba022f](https://github.com/blockmineJS/blockmine/commit/2ba022fff038cc83bb1edfa04d3edf97fc76c255))
-* action:send_message to support dynamic variables. example. Сообщение: привет, {username} ([457639d](https://github.com/blockmineJS/blockmine/commit/457639d70e7a8933f0508d93196a2be6951f1a0a))
-
-### [1.19.1](https://github.com/blockmineJS/blockmine/compare/v1.19.0...v1.19.1) (2025-10-01)
-
-
-### 🐛 Исправления
-
-* изменение порядка ботов теперь корректное ([9663737](https://github.com/blockmineJS/blockmine/commit/9663737505201468dd2233bf5658be5b2442f583))
-* фиксим новой вкладки прокси ([7ebdb7d](https://github.com/blockmineJS/blockmine/commit/7ebdb7d0df6c4e5cd6a9b15576cc1907ab7fcd74))
-
-## [1.19.0](https://github.com/blockmineJS/blockmine/compare/v1.18.5...v1.19.0) (2025-08-23)
-
-
-### 🐛 Исправления
-
-* баз команда dev исправлена. теперь не считает алиасы как отдельные кмд ([782c01e](https://github.com/blockmineJS/blockmine/commit/782c01e12f273a04cf78a5772b7be628d22f5791))
-* добавлена автоматическая установка недостающих модулей для плагинов при их загрузке ([27154f1](https://github.com/blockmineJS/blockmine/commit/27154f1d2c588f8d8371493f1d28646ff9d764f7))
-* зависимости плагин устанавливаются ([a7314c4](https://github.com/blockmineJS/blockmine/commit/a7314c4d1c66ef7021d6c265ebbb270c50a3ab62))
-* изменять версия у созданного сервера теперь можно ([a55e3c9](https://github.com/blockmineJS/blockmine/commit/a55e3c9d6a06b9ebd95722aa6487e2b79bda07ff))
-* исправление проблем с импортом ([ef9fde2](https://github.com/blockmineJS/blockmine/commit/ef9fde2aa8b1390910600bfd930c444cbff2d01e))
-* починили установку локальную ([1b28e07](https://github.com/blockmineJS/blockmine/commit/1b28e071d4846b62dd6360f4709a0e263841960b))
-* права юзеров теперь может менять только владелец панели (первый юзер) ([94312d7](https://github.com/blockmineJS/blockmine/commit/94312d7b9c09aabb704f163f8e3205abf7c2acdc))
-
-
-### ✨ Новые возможности
-
-* когда другой юзер заходит в панель, другие клиенты увидят уведомление что он зашел ([a689b4e](https://github.com/blockmineJS/blockmine/commit/a689b4ee91e0dc187b3eeddc75600e880730b885))
-* новая кнопочка - прокси. позволяет установить прокси сразу множеству ботов ([ac75d65](https://github.com/blockmineJS/blockmine/commit/ac75d655289a4b4b4560555ac1fecbcdb199b822))
-* теперь можно для других юзеров назначать определенных ботов которыми они могут управлять ([484685b](https://github.com/blockmineJS/blockmine/commit/484685b1821fa3ad8907f4ab320762cf1c6a3959))
-
+# История версий
+
+
+## [1.22.0](https://github.com/blockmineJS/blockmine/compare/v1.21.0...v1.22.0) (2025-11-16)
+
+
+### ✨ Новые возможности
+
+* апи для дашборд страницы для отображения ресурсов системы ([c903d64](https://github.com/blockmineJS/blockmine/commit/c903d64c2576d22943971226caec1bd610f0f41e))
+* для дашборда добавлен функционал для просмотров ресурсов системы ([b7fa209](https://github.com/blockmineJS/blockmine/commit/b7fa2097274882ea13c01068eac78824560cc22b))
+* добавлены ноды для получения существ и игроков рядом с ботом ([17fad59](https://github.com/blockmineJS/blockmine/commit/17fad592c64833e25a2bd9e259379d4d649e3cb4))
+* много новых нод и обнов для граф системы ([8881aa5](https://github.com/blockmineJS/blockmine/commit/8881aa554b1b8c6cca4d87cb5900bb8cfe535d33))
+* новая большая механика. Вебсокеты ([acda500](https://github.com/blockmineJS/blockmine/commit/acda5005d01cfcb8ee7c85474af966c646c63fcd))
+* новая нода - задержка ([cde63db](https://github.com/blockmineJS/blockmine/commit/cde63db612062f3eb7782e8c1f6af35a22dc03e2))
+* отключение градиента в консоли. Автор - @artemscine ([ba11548](https://github.com/blockmineJS/blockmine/commit/ba1154827c2e5016c668b79f7b80386819cc7ab9))
+* разработчики плагинов теперь могут указать secret: true для маскировки чувствительных значений ([f6c67fb](https://github.com/blockmineJS/blockmine/commit/f6c67fbb0a9cc24eea2175e275593a1b0421d199))
+* сообщение в чате text\ntext разделяется на два. \n разделитель ([560ae7b](https://github.com/blockmineJS/blockmine/commit/560ae7b6c8ddbe0412d7f27d145c447bb5d750d2))
+* теперь при обновлении плагинов настройки тоже мигрируются ([48434e8](https://github.com/blockmineJS/blockmine/commit/48434e853c9f926168873f61ecd49cbb6c10971c))
+* Add date and time manipulation nodes ([80c8dbd](https://github.com/blockmineJS/blockmine/commit/80c8dbd9103a38a03b4ae4ea297322ae699d9c21))
+* websocket. Большая фича ([a321023](https://github.com/blockmineJS/blockmine/commit/a3210230d6e78d46928924d244a6b24acee45443))
+
+
+### 🛠 Рефакторинг
+
+* большой рефакторинг бэкенд части x2 ([49a543a](https://github.com/blockmineJS/blockmine/commit/49a543a122aced41b3725564c66a01269608dd2d))
+* большой рефакторинг нод системы ([85ac50f](https://github.com/blockmineJS/blockmine/commit/85ac50f1f0ea79832bd398f7345029f52f6910e1))
+* обновление компонентов UI и удаление зависимости от MUI ([86a4a5e](https://github.com/blockmineJS/blockmine/commit/86a4a5edfc91f024cd085cbe4282a5c9efb48b84))
+* полный рефакторинг бэкенда ([5e68fd8](https://github.com/blockmineJS/blockmine/commit/5e68fd8fa00a162ae68772bb24ef984d433e9ca5))
+
+
+### 🐛 Исправления
+
+* важный фикс команд ([16f7da2](https://github.com/blockmineJS/blockmine/commit/16f7da23167ece0877cb196c6ba01bbd6fbcc3a3))
+* корректная очистка ANSI ([a9ba9c7](https://github.com/blockmineJS/blockmine/commit/a9ba9c74ab31dbce7ce881a098c204f48aa4e82e))
+* рестарт после падения socks. Автор - @artemscine ([bf98505](https://github.com/blockmineJS/blockmine/commit/bf985052c40d30add6a717748efe37eeb15d5d74))
+* уменьшение отступов в дашборде Автор - @artemscine ([af52a07](https://github.com/blockmineJS/blockmine/commit/af52a07a0615d29c97c6848ea758c83544236cad))
+* remove problematic lcov-reporter-action and update to Node.js 22.x ([ac83208](https://github.com/blockmineJS/blockmine/commit/ac83208eefff2e71075d02fb46c603e8e22a6b9b))
+* resolve CodeRabbit review issues ([a45ee47](https://github.com/blockmineJS/blockmine/commit/a45ee47a02409c67284e165248ac19e6adbd369f))
+
+## [1.21.0](https://github.com/blockmineJS/blockmine/compare/v1.20.0...v1.21.0) (2025-10-26)
+
+
+### 🛠 Рефакторинг
+
+* [graph-system] все ноды отрефакторены и перенесены. [@claude](https://github.com/claude) author ([55db1b8](https://github.com/blockmineJS/blockmine/commit/55db1b89dbe470691db129a72c7efe55030acfa6))
+
+
+### ✨ Новые возможности
+
+* [graph-system]  пкм. по названию переменной можно найти - Получить/Установить переменную ([83b822f](https://github.com/blockmineJS/blockmine/commit/83b822ff1d278dfb9e280909c81ab32fd0e58bc3))
+* [graph-system] конвертация нод при подключения не к тем типам ([03deac8](https://github.com/blockmineJS/blockmine/commit/03deac83c9468199a8f6ae2b2480248c52a39e57))
+* добавление виртуализации для списков плагинов и ботов ([ea7746f](https://github.com/blockmineJS/blockmine/commit/ea7746f5c7f05ed74e6893bb27774d8541e0c57f))
+* новая нода для http запросов ([3565d06](https://github.com/blockmineJS/blockmine/commit/3565d06bff419c2d2665eba719a4c94696db00ae))
+
+## [1.20.0](https://github.com/blockmineJS/blockmine/compare/v1.19.1...v1.20.0) (2025-10-23)
+
+
+### ✨ Новые возможности
+
+* если бот падает 5 раз с критической ошибкой, то перезапуск отменяется ([2ba022f](https://github.com/blockmineJS/blockmine/commit/2ba022fff038cc83bb1edfa04d3edf97fc76c255))
+* action:send_message to support dynamic variables. example. Сообщение: привет, {username} ([457639d](https://github.com/blockmineJS/blockmine/commit/457639d70e7a8933f0508d93196a2be6951f1a0a))
+
+### [1.19.1](https://github.com/blockmineJS/blockmine/compare/v1.19.0...v1.19.1) (2025-10-01)
+
+
+### 🐛 Исправления
+
+* изменение порядка ботов теперь корректное ([9663737](https://github.com/blockmineJS/blockmine/commit/9663737505201468dd2233bf5658be5b2442f583))
+* фиксим новой вкладки прокси ([7ebdb7d](https://github.com/blockmineJS/blockmine/commit/7ebdb7d0df6c4e5cd6a9b15576cc1907ab7fcd74))
+
+## [1.19.0](https://github.com/blockmineJS/blockmine/compare/v1.18.5...v1.19.0) (2025-08-23)
+
+
+### 🐛 Исправления
+
+* баз команда dev исправлена. теперь не считает алиасы как отдельные кмд ([782c01e](https://github.com/blockmineJS/blockmine/commit/782c01e12f273a04cf78a5772b7be628d22f5791))
+* добавлена автоматическая установка недостающих модулей для плагинов при их загрузке ([27154f1](https://github.com/blockmineJS/blockmine/commit/27154f1d2c588f8d8371493f1d28646ff9d764f7))
+* зависимости плагин устанавливаются ([a7314c4](https://github.com/blockmineJS/blockmine/commit/a7314c4d1c66ef7021d6c265ebbb270c50a3ab62))
+* изменять версия у созданного сервера теперь можно ([a55e3c9](https://github.com/blockmineJS/blockmine/commit/a55e3c9d6a06b9ebd95722aa6487e2b79bda07ff))
+* исправление проблем с импортом ([ef9fde2](https://github.com/blockmineJS/blockmine/commit/ef9fde2aa8b1390910600bfd930c444cbff2d01e))
+* починили установку локальную ([1b28e07](https://github.com/blockmineJS/blockmine/commit/1b28e071d4846b62dd6360f4709a0e263841960b))
+* права юзеров теперь может менять только владелец панели (первый юзер) ([94312d7](https://github.com/blockmineJS/blockmine/commit/94312d7b9c09aabb704f163f8e3205abf7c2acdc))
+
+
+### ✨ Новые возможности
+
+* когда другой юзер заходит в панель, другие клиенты увидят уведомление что он зашел ([a689b4e](https://github.com/blockmineJS/blockmine/commit/a689b4ee91e0dc187b3eeddc75600e880730b885))
+* новая кнопочка - прокси. позволяет установить прокси сразу множеству ботов ([ac75d65](https://github.com/blockmineJS/blockmine/commit/ac75d655289a4b4b4560555ac1fecbcdb199b822))
+* теперь можно для других юзеров назначать определенных ботов которыми они могут управлять ([484685b](https://github.com/blockmineJS/blockmine/commit/484685b1821fa3ad8907f4ab320762cf1c6a3959))
+
 ### [1.18.5](https://github.com/blockmineJS/blockmine/compare/v1.18.4...v1.18.5) (2025-08-15)
 
 

package/README.md

@@ -62,6 +62,12 @@
     *   Создавайте **полные резервные копии** ботов в один ZIP-архив, включая все плагины и их настройки.
     *   Делитесь отдельными командами и графами событий через экспорт в JSON.
     *   Легко переносите ботов и их логику между разными установками BlockMine.
+*   **🔌 WebSocket API для интеграций**:
+    *   Управляйте ботами из внешних приложений через WebSocket API.
+    *   Выполняйте команды бота от имени любого пользователя с полной проверкой прав.
+    *   Вызывайте визуальные графы и получайте результаты их выполнения.
+    *   Подписывайтесь на события бота (сообщения в чате, вход/выход игроков, здоровье и др.).
+    *   Официальный SDK `blockmine-api` для Node.js с полной документацией.
 *   **📦 Простая установка**: Запуск всей системы одной командой благодаря `npx`.
 
 ## ✨ Быстрый старт с `npx`
@@ -144,3 +150,91 @@ npm run dev
 
 *   **Бэкенд** будет доступен на `http://localhost:3001`.
 *   **Фронтенд** с горячей перезагрузкой будет доступен на `http://localhost:5173`. Открывайте этот адрес для разработки.
+
+### 3. WebSocket API для интеграций
+
+BlockMine предоставляет мощный WebSocket API для интеграции с внешними приложениями. Вы можете управлять ботами, вызывать графы и подписываться на события из любого языка программирования.
+
+#### Установка SDK
+
+```bash
+npm install blockmine-api
+```
+
+#### Быстрый пример
+
+```javascript
+const BlockMineBot = require('blockmine-api');
+
+const bot = new BlockMineBot({
+    url: 'http://localhost:3001',
+    botId: 1,
+    apiKey: 'bk_your_api_key_here'
+});
+
+async function main() {
+    await bot.connect();
+
+    // Слушать сообщения в чате
+    bot.onChatMessage((data) => {
+        console.log(`${data.username}: ${data.message}`);
+    });
+
+    // Выполнить команду бота от имени пользователя
+    const result = await bot.executeCommand('Steve', 'ping');
+    console.log('Результат команды:', result); // "Понг, Steve!"
+
+    // Вызвать визуальный граф и получить результат
+    const graphResult = await bot.callGraph('calculate', {
+        operation: 'add',
+        a: 10,
+        b: 20
+    });
+    console.log('Результат графа:', graphResult);
+}
+
+main();
+```
+
+#### Документация
+
+Полная документация по WebSocket API доступна в пакете `blockmine-api`:
+- [README.md](./packages/blockmine-api/README.md) - Полное руководство по API
+- [examples/](./packages/blockmine-api/examples/) - Примеры использования
+
+#### Возможности API
+
+**Выполнение команд:**
+```javascript
+// Команды выполняются с полной проверкой прав пользователя
+const result = await bot.executeCommand('Steve', 'ping');
+// Результат: "Понг, Steve!"
+
+// С аргументами
+const result2 = await bot.executeCommand('Steve', 'ping', { target: 'Alex' });
+// Результат: "Понг, Steve! Пингую игрока Alex."
+```
+
+**Вызов графов:**
+```javascript
+// Графы с триггером "Вызов из WebSocket API" возвращают данные
+const data = await bot.callGraph('server_info', {});
+console.log(data); // { players: [...], position: {...} }
+```
+
+**События:**
+```javascript
+// Подписка на события бота
+bot.onChatMessage((data) => {
+    console.log(`${data.username}: ${data.message}`);
+});
+
+bot.onPlayerJoin((username) => {
+    console.log(`${username} присоединился`);
+});
+```
+
+**Универсальная система выполнения:**
+- Команды через WebSocket API используют ту же валидацию, что и команды из Minecraft
+- Все проверки прав, кулдаунов и черного списка работают одинаково
+- Это позволяет создавать единую систему команд для разных источников (игра, API, будущий Telegram бот)

package/backend/docs/SECRETS_DOCUMENTATION.md

@@ -0,0 +1,327 @@
+# Документация по скрытым (секретным) значениям в настройках плагинов
+
+## Обзор
+
+Механика скрытых значений позволяет безопасно хранить чувствительные данные (API ключи, пароли, токены) в настройках плагинов. После сохранения такие значения маскируются при отправке на фронтенд, предотвращая утечку конфиденциальной информации.
+
+## Как использовать
+
+### 1. Объявление секретных настроек в package.json
+
+Чтобы пометить настройку как секретную, добавьте атрибут `"secret": true` в описание настройки:
+
+```json
+{
+  "botpanel": {
+    "settings": {
+      "apiKey": {
+        "type": "string",
+        "label": "API ключ",
+        "description": "Ваш секретный API ключ",
+        "default": "",
+        "secret": true
+      },
+      "apiKeys": {
+        "type": "string[]",
+        "label": "API ключи",
+        "description": "Список API ключей",
+        "default": [],
+        "secret": true
+      },
+      "password": {
+        "type": "string",
+        "label": "Пароль",
+        "description": "Пароль для доступа",
+        "default": "",
+        "secret": true
+      }
+    }
+  }
+}
+```
+
+### 2. Поддерживаемые типы настроек
+
+Атрибут `secret` работает со всеми типами настроек:
+- `string` - будет заменено на `********`
+- `string[]` - каждый элемент массива будет заменен на `********`
+- `object` - каждое значение в объекте будет заменено на `********`
+- `number` - будет заменено на `********`
+- `boolean` - будет заменено на `********`
+
+### 3. Работа с группированными настройками
+
+Механизм также поддерживает группированные настройки:
+
+```json
+{
+  "botpanel": {
+    "settings": {
+      "Аутентификация": {
+        "label": "Настройки аутентификации",
+        "token": {
+          "type": "string",
+          "label": "Токен",
+          "description": "Токен для API",
+          "default": "",
+          "secret": true
+        },
+        "apiKey": {
+          "type": "string",
+          "label": "API ключ",
+          "default": "",
+          "secret": true
+        }
+      }
+    }
+  }
+}
+```
+
+## Поведение системы
+
+### При чтении настроек (GET запросы)
+
+Когда фронтенд запрашивает настройки плагина, все секретные значения автоматически маскируются:
+
+```javascript
+// Реальные значения в БД:
+{
+  "apiKey": "sk-abc123xyz789",
+  "username": "john_doe"
+}
+
+// Что получает фронтенд:
+{
+  "apiKey": "********",  // секретное значение замаскировано
+  "username": "john_doe"  // обычное значение без изменений
+}
+```
+
+### При сохранении настроек (PUT запросы)
+
+Система автоматически определяет, были ли изменены секретные значения:
+
+#### Сценарий 1: Секретное значение не изменилось
+```javascript
+// Пользователь отправляет:
+{
+  "apiKey": "********",  // маска (не изменено)
+  "username": "new_username"
+}
+
+// Система сохраняет:
+{
+  "apiKey": "sk-abc123xyz789",  // оригинальное значение сохранено
+  "username": "new_username"
+}
+```
+
+#### Сценарий 2: Секретное значение изменилось
+```javascript
+// Пользователь отправляет:
+{
+  "apiKey": "sk-new-key-456",  // новое значение
+  "username": "new_username"
+}
+
+// Система сохраняет:
+{
+  "apiKey": "sk-new-key-456",  // новое значение сохранено
+  "username": "new_username"
+}
+```
+
+## Примеры использования
+
+### Пример 1: API ключи
+
+```json
+{
+  "botpanel": {
+    "settings": {
+      "apiKeys": {
+        "type": "string[]",
+        "label": "API ключи Google AI",
+        "description": "Список API ключей от Google AI Studio",
+        "default": [],
+        "secret": true
+      }
+    }
+  }
+}
+```
+
+### Пример 2: Пароль прокси-сервера
+
+```json
+{
+  "botpanel": {
+    "settings": {
+      "proxyPassword": {
+        "type": "string",
+        "label": "Пароль прокси",
+        "description": "Пароль для авторизации на прокси-сервере",
+        "default": "",
+        "secret": true
+      }
+    }
+  }
+}
+```
+
+### Пример 3: Токен доступа
+
+```json
+{
+  "botpanel": {
+    "settings": {
+      "accessToken": {
+        "type": "string",
+        "label": "Токен доступа",
+        "description": "Bearer токен для API",
+        "default": "",
+        "secret": true
+      }
+    }
+  }
+}
+```
+
+## Технические детали
+
+### Константы
+- `SECRET_MASK = '********'` - маска для замены секретных значений
+
+### Функции утилиты
+
+#### `isSecretSetting(settingConfig)`
+Проверяет, является ли настройка секретной.
+
+#### `maskSecretValue(value, settingConfig)`
+Маскирует значение, если настройка секретная.
+
+#### `filterSecretSettings(settings, manifestSettings, isGrouped)`
+Фильтрует настройки плагина, маскируя секретные значения перед отправкой на фронтенд.
+
+#### `prepareSettingsForSave(newSettings, existingSettings, manifestSettings, isGrouped)`
+Подготавливает настройки для сохранения, сохраняя оригинальные значения для замаскированных секретов.
+
+#### `isMaskedValue(value)`
+Проверяет, является ли значение замаскированным.
+
+## Безопасность
+
+### Что защищает эта механика:
+✅ Секретные значения не отправляются на фронтенд  
+✅ API ключи и пароли не отображаются в UI  
+✅ Случайное копирование настроек не раскрывает секреты  
+✅ Логи браузера не содержат чувствительных данных  
+
+### Что НЕ защищает эта механика:
+❌ Прямой доступ к базе данных  
+❌ Доступ к файловой системе сервера  
+❌ Server-side логи (секреты могут попасть в логи при загрузке плагинов)  
+❌ Network traffic sniffing (используйте HTTPS)  
+
+## Рекомендации
+
+1. **Всегда помечайте чувствительные данные как секретные:**
+   - API ключи
+   - Пароли
+   - Токены доступа
+   - OAuth секреты
+   - Приватные ключи
+
+2. **НЕ помечайте как секретные:**
+   - Публичные идентификаторы
+   - Имена пользователей (если не конфиденциальные)
+   - URL адреса
+   - Настройки UI
+
+3. **Дополнительная безопасность:**
+   - Используйте HTTPS для всех API запросов
+   - Ограничьте права доступа к настройкам плагинов
+   - Регулярно ротируйте API ключи
+   - Используйте переменные окружения для критически важных секретов
+
+## Миграция существующих плагинов
+
+Для добавления поддержки секретных значений в существующий плагин:
+
+1. Откройте `package.json` вашего плагина
+2. Найдите секретные настройки в секции `botpanel.settings`
+3. Добавьте `"secret": true` к каждой секретной настройке
+4. Сохраните файл
+5. Переустановите плагин или перезапустите бота
+
+```diff
+  "apiKey": {
+    "type": "string",
+    "label": "API ключ",
+    "description": "Ваш секретный API ключ",
+-   "default": ""
++   "default": "",
++   "secret": true
+  }
+```
+
+## Отладка
+
+Если секретные значения не маскируются:
+
+1. Проверьте, что атрибут `"secret": true` добавлен корректно
+2. Убедитесь, что JSON валиден (нет лишних запятых)
+3. Проверьте логи сервера на наличие ошибок парсинга manifest
+4. Попробуйте переустановить плагин
+
+## API Endpoints
+
+Механика скрытых значений автоматически применяется к следующим endpoints:
+
+- `GET /api/bots/:botId/plugins/:pluginId/settings` - получение настроек плагина
+- `PUT /api/bots/:botId/plugins/:pluginId` - сохранение настроек плагина
+- `GET /api/bots/:id/settings/all` - получение всех настроек бота
+
+## Пример полного package.json
+
+```json
+{
+  "name": "my-secure-plugin",
+  "version": "1.0.0",
+  "description": "Плагин с секретными настройками",
+  "main": "index.js",
+  "botpanel": {
+    "icon": "Shield",
+    "categories": ["Утилиты"],
+    "settings": {
+      "apiKey": {
+        "type": "string",
+        "label": "API ключ",
+        "description": "Ваш секретный API ключ",
+        "default": "",
+        "secret": true
+      },
+      "serverUrl": {
+        "type": "string",
+        "label": "URL сервера",
+        "description": "Адрес API сервера",
+        "default": "https://api.example.com"
+      },
+      "tokens": {
+        "type": "string[]",
+        "label": "Токены",
+        "description": "Список токенов доступа",
+        "default": [],
+        "secret": true
+      },
+      "enableLogging": {
+        "type": "boolean",
+        "label": "Включить логирование",
+        "default": false
+      }
+    }
+  }
+}
+```
+

package/backend/jest.config.js

@@ -0,0 +1,59 @@
+module.exports = {
+    testEnvironment: 'node',
+
+    testMatch: [
+        '**/__tests__/**/*.test.js',
+        '**/?(*.)+(spec|test).js'
+    ],
+
+    testPathIgnorePatterns: [
+        '/node_modules/',
+        '/dist/',
+        '/build/',
+        '/storage/',
+        '/plugins/'
+    ],
+
+    modulePathIgnorePatterns: [
+        '/storage/',
+        '/plugins/'
+    ],
+
+    collectCoverageFrom: [
+        'src/repositories/**/*.js',
+        'src/core/services/**/*.js',
+        'src/container.js',
+        'src/core/BotManager.js',
+        'src/core/EventGraphManager.js',
+        'src/core/PluginManager.js',
+        'src/core/UserService.js',
+        'src/core/DependencyService.js',
+        'src/core/TaskScheduler.js',
+        'src/core/PluginLoader.js',
+        'src/core/PluginService.js',
+        'src/core/PermissionManager.js',
+        'src/core/MessageQueue.js',
+        'src/core/GraphExecutionEngine.js',
+        'src/core/NodeRegistry.js',
+        'src/core/PrismaService.js',
+        'src/api/routes/**/*.js',
+        'src/core/utils/**/*.js',
+        'src/core/nodes/**/*.js',
+        '!src/**/*.test.js',
+        '!src/**/__tests__/**',
+        '!src/core/BotProcess.js',
+        '!src/core/BotManager.old.js',
+        '!src/test-refactor.js',
+    ],
+
+
+    testTimeout: 10000,
+
+    clearMocks: true,
+    resetMocks: true,
+    restoreMocks: true,
+
+    verbose: true,
+
+    setupFilesAfterEnv: ['<rootDir>/src/__tests__/setup.js'],
+};