@pachca/cli 2026.6.3 → 2026.7.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2026.7.0  (7 июля 2026)
+
+- **Добавлено** (bots list): Новая команда — список ботов с поиском по имени (`--query`)
+- **Добавлено** (bots delete): Новая команда — удаление бота по его `id`
+- **Добавлено** (bots create): Права доступа бота — параметры `who-can-add` (кто может добавлять бота в чаты), `can-edit` (роли, редактирующие настройки) и `single-chat` (только один чат)
+- **Добавлено** (bots update): Права доступа бота — параметры `who-can-add` (кто может добавлять бота в чаты) и `can-edit` (роли, редактирующие настройки)
+- **Добавлено** (search users): Значение сортировки `--sort creation` — по дате создания
+
 ## 2026.6.3  (24 июня 2026)
 
 - **Изменено** (files, custom-properties, oauth): Команды реорганизованы по разделам: `common uploads`→`files uploads`, `common direct-url`→`files direct-url`, `common custom-properties`→`custom-properties list`, `common request-export`→`chats request-export`, `common get-exports`→`chats download-export`, `profile get-info`→`oauth token-info`, `link-previews add`→`messages unfurl`. Старые имена продолжают работать (скрытые алиасы)

package/README.md

@@ -80,9 +80,11 @@ pachca guide            # список всех сценариев
 |---------|---------|
 | `pachca bots recreate-token-self` | Ротация собственного токена бота |
 | `pachca bots update-webhook` | Саморегистрация вебхука бота |
+| `pachca bots list` | Список ботов |
 | `pachca bots create` | Новый бот |
 | `pachca bots get` | Информация о боте |
 | `pachca bots update` | Редактирование бота |
+| `pachca bots delete` | Удаление бота |
 | `pachca bots recreate-token` | Ротация токена бота |
 | `pachca bots list-events` | История событий |
 | `pachca bots remove-event` | Удаление события |

package/dist/commands/bots/create.js

@@ -6,7 +6,8 @@ export default class BotsCreate extends BaseCommand {
     static description = "Новый бот";
     static examples = [
         "Создать бота через API и получить токен:\n  $ pachca bots create",
-        "Настроить бота с исходящим вебхуком:\n  $ pachca bots create"
+        "Настроить бота с исходящим вебхуком:\n  $ pachca bots create",
+        "Найти и удалить бота:\n  $ pachca bots list"
     ];
     static scope = "bots:write";
     static apiMethod = "POST";
@@ -58,6 +59,16 @@ export default class BotsCreate extends BaseCommand {
             description: "Сохранять историю событий бота для последующего получения через метод истории событий",
             allowNo: true,
         }),
+        'who-can-add': Flags.string({
+            description: "Кто может добавлять бота в чаты",
+        }),
+        'can-edit': Flags.string({
+            description: "Роли, которым, помимо создателя, разрешено редактировать настройки бота. Создатель может редактировать всегда. Пустой массив — редактировать может только создатель.",
+        }),
+        'single-chat': Flags.boolean({
+            description: "Ограничивает бота одной беседой или каналом: `true` — бота можно добавить только в один такой чат, `false` — в несколько. Личные чаты и треды в ограничение не входят. Задаётся только при создании, при редактировании не меняется.",
+            allowNo: true,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(BotsCreate);
@@ -102,6 +113,9 @@ export default class BotsCreate extends BaseCommand {
                 link_preview_enabled: flags['link-preview-enabled'],
                 ignore_self_messages: flags['ignore-self-messages'],
                 events_history_enabled: flags['events-history-enabled'],
+                who_can_add: flags['who-can-add'],
+                can_edit: flags['can-edit'] ? this.parseJSON(flags['can-edit'], 'can-edit') : undefined,
+                single_chat: flags['single-chat'],
             } };
         // Clean undefined fields
         const inner = body['webhook'];

package/dist/commands/bots/delete.js

@@ -0,0 +1,46 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class BotsDelete extends BaseCommand {
+    static description = "Удаление бота";
+    static examples = [
+        "Обновить Webhook URL бота:\n  $ pachca bots update",
+        "Найти и удалить бота:\n  $ pachca bots delete"
+    ];
+    static scope = "bots:write";
+    static apiMethod = "DELETE";
+    static apiPath = "/bots/{id}";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор бота (pachca bots list)",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Пропустить подтверждение',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsDelete);
+        this.parsedFlags = flags;
+        if (!flags.force) {
+            if (!this.isInteractive()) {
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca bots delete <id> --force" });
+            }
+            const confirm = await clack.confirm({ message: 'Вы уверены?' });
+            if (clack.isCancel(confirm) || !confirm) {
+                process.stderr.write('Отменено.\n');
+                this.exit(0);
+            }
+        }
+        const { data } = await this.apiRequest({
+            method: 'DELETE',
+            path: `/bots/${args.id}`,
+        });
+        this.success('Удалено');
+    }
+}

package/dist/commands/bots/get.js

@@ -4,7 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsGet extends BaseCommand {
     static description = "Информация о боте";
     static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update"
+        "Обновить Webhook URL бота:\n  $ pachca bots update",
+        "Найти и удалить бота:\n  $ pachca bots delete"
     ];
     static scope = "bots:read";
     static apiMethod = "GET";

package/dist/commands/bots/list.js

@@ -0,0 +1,99 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class BotsList extends BaseCommand {
+    static description = "Список ботов";
+    static examples = [
+        "Создать бота через API и получить токен:\n  $ pachca bots create",
+        "Настроить бота с исходящим вебхуком:\n  $ pachca bots create",
+        "Найти и удалить бота:\n  $ pachca bots list"
+    ];
+    static scope = "bots:read";
+    static apiMethod = "GET";
+    static apiPath = "/bots";
+    static defaultColumns = ["id", "webhook"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'query': Flags.string({
+            description: "Поисковая фраза для фильтрации ботов по имени",
+        }),
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsList);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            while (pages < 500) {
+                const query = {
+                    query: flags['query'],
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/bots', query });
+                const body = response.data;
+                const items = body.data;
+                if (items)
+                    allData.push(...items);
+                const meta = body.meta;
+                const paginate = meta?.paginate;
+                nextCursor = paginate?.next_page;
+                pages++;
+                // Условие конца: списочные методы — has_next === false; методы поиска и /users?query= (без has_next) — пустой data
+                const hasNext = paginate?.has_next;
+                if (typeof hasNext === 'boolean') {
+                    if (!hasNext)
+                        break;
+                }
+                else if (!items || items.length === 0) {
+                    break;
+                }
+                if (process.stderr.isTTY) {
+                    const total = paginate?.total;
+                    const progress = total ? `${allData.length} / ${total}` : String(allData.length);
+                    process.stderr.write(`\r  Загружено: ${progress}...`);
+                }
+                if (!nextCursor)
+                    break;
+                if (seenCursors.has(nextCursor)) {
+                    process.stderr.write('\n⚠ Обнаружен цикл пагинации, остановка.\n');
+                    break;
+                }
+                seenCursors.add(nextCursor);
+            }
+            if (pages >= 500) {
+                process.stderr.write('\n⚠ Достигнут лимит 500 страниц.\n');
+            }
+            if (process.stderr.isTTY)
+                process.stderr.write('\n');
+            this.output(allData);
+            return;
+        }
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: '/bots',
+            query: {
+                query: flags['query'],
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = data;
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

package/dist/commands/bots/update.js

@@ -4,7 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsUpdate extends BaseCommand {
     static description = "Редактирование бота";
     static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update"
+        "Обновить Webhook URL бота:\n  $ pachca bots update",
+        "Найти и удалить бота:\n  $ pachca bots delete"
     ];
     static scope = "bots:write";
     static apiMethod = "PUT";
@@ -60,6 +61,12 @@ export default class BotsUpdate extends BaseCommand {
             description: "Сохранять историю событий бота для последующего получения через метод истории событий",
             allowNo: true,
         }),
+        'who-can-add': Flags.string({
+            description: "Кто может добавлять бота в чаты",
+        }),
+        'can-edit': Flags.string({
+            description: "Роли, которым, помимо создателя, разрешено редактировать настройки бота. Создатель может редактировать всегда. Пустой массив — редактировать может только создатель.",
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(BotsUpdate);
@@ -78,6 +85,8 @@ export default class BotsUpdate extends BaseCommand {
                 link_preview_enabled: flags['link-preview-enabled'],
                 ignore_self_messages: flags['ignore-self-messages'],
                 events_history_enabled: flags['events-history-enabled'],
+                who_can_add: flags['who-can-add'],
+                can_edit: flags['can-edit'] ? this.parseJSON(flags['can-edit'], 'can-edit') : undefined,
             } };
         // Clean undefined fields
         const inner = body['webhook'];

package/dist/commands/search/list-users.js

@@ -20,7 +20,7 @@ export default class SearchListUsers extends BaseCommand {
         }),
         'sort': Flags.string({
             description: "Сортировка результатов",
-            options: ["by_score", "alphabetical"],
+            options: ["by_score", "alphabetical", "creation"],
         }),
         'order': Flags.string({
             description: "Направление сортировки",

package/dist/commands/security/list.js

@@ -24,7 +24,7 @@ export default class SecurityList extends BaseCommand {
         }),
         'event-key': Flags.string({
             description: "Фильтр по конкретному типу события",
-            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated"],
+            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted"],
         }),
         'actor-id': Flags.string({
             description: "Идентификатор пользователя, выполнившего действие",

package/dist/data/alternatives.json

@@ -2,9 +2,11 @@
     "security:list": "Журнал аудита событий",
     "bots:recreate-token-self": "Ротация собственного токена бота",
     "bots:update-webhook": "Саморегистрация вебхука бота",
+    "bots:list": "Список ботов",
     "bots:create": "Новый бот",
     "bots:get": "Информация о боте",
     "bots:update": "Редактирование бота",
+    "bots:delete": "Удаление бота",
     "bots:recreate-token": "Ротация токена бота",
     "chats:create": "Новый чат",
     "chats:list": "Список чатов",

package/dist/data/changelog.json

@@ -1,4 +1,35 @@
 [
+    {
+        "version": "2026.7.0",
+        "date": "7 июля 2026",
+        "changes": [
+            {
+                "type": "+",
+                "command": "bots list",
+                "description": "Новая команда — список ботов с поиском по имени (`--query`)"
+            },
+            {
+                "type": "+",
+                "command": "bots delete",
+                "description": "Новая команда — удаление бота по его `id`"
+            },
+            {
+                "type": "+",
+                "command": "bots create",
+                "description": "Права доступа бота — параметры `who-can-add` (кто может добавлять бота в чаты), `can-edit` (роли, редактирующие настройки) и `single-chat` (только один чат)"
+            },
+            {
+                "type": "+",
+                "command": "bots update",
+                "description": "Права доступа бота — параметры `who-can-add` (кто может добавлять бота в чаты) и `can-edit` (роли, редактирующие настройки)"
+            },
+            {
+                "type": "+",
+                "command": "search users",
+                "description": "Значение сортировки `--sort creation` — по дате создания"
+            }
+        ]
+    },
     {
         "version": "2026.6.3",
         "date": "24 июня 2026",