polyv-live-cli 1.2.27 → 1.2.29-rc.0

package/dist/commands/channel.commands.js

@@ -6,10 +6,17 @@ exports.validateScene = validateScene;
 exports.validateTemplate = validateTemplate;
 exports.validateLimit = validateLimit;
 exports.validateOutputFormat = validateOutputFormat;
+exports.validateChannelViewerScope = validateChannelViewerScope;
+exports.validateYnFlag = validateYnFlag;
+exports.validateChatTokenRole = validateChatTokenRole;
+exports.parseBoolean = parseBoolean;
+exports.ensureAtLeastOneOption = ensureAtLeastOneOption;
 const channel_handler_1 = require("../handlers/channel.handler");
+const channel_service_sdk_1 = require("../services/channel.service.sdk");
 const manager_1 = require("../config/manager");
 const auth_adapter_1 = require("../config/auth-adapter");
 const errors_1 = require("../utils/errors");
+const api_command_1 = require("../utils/api-command");
 async function loadAuthAndServiceConfig(parentOptions) {
     const authResult = auth_adapter_1.authAdapter.tryGetAuthConfig(parentOptions);
     if (!authResult) {
@@ -66,6 +73,53 @@ async function loadAuthAndServiceConfig(parentOptions) {
 function registerChannelCommands(program) {
     const channelCmd = program.command('channel');
     channelCmd.description('Manage live streaming channels');
+    const runChannelViewerCommand = async (action) => {
+        try {
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const channelHandler = new channel_handler_1.ChannelHandler(authConfig, serviceConfig);
+            await action(channelHandler);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    };
+    const runChannelViewerWriteCommand = async (options, confirmationMessage, action) => {
+        try {
+            await (0, api_command_1.confirmWrite)(options.force, confirmationMessage);
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const channelHandler = new channel_handler_1.ChannelHandler(authConfig, serviceConfig);
+            await action(channelHandler);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    };
+    const runChannelApiCommand = async (options, action) => {
+        try {
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const service = new channel_service_sdk_1.ChannelServiceSdk(authConfig, serviceConfig);
+            (0, api_command_1.displayApiResult)(await action(service), options.output);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    };
+    const runChannelApiWriteCommand = async (options, confirmationMessage, action) => {
+        try {
+            await (0, api_command_1.confirmWrite)(options.force, confirmationMessage);
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const service = new channel_service_sdk_1.ChannelServiceSdk(authConfig, serviceConfig);
+            const result = await action(service);
+            (0, api_command_1.displayApiResult)({ success: true, result: result ?? true }, options.output);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    };
     const createCmd = channelCmd
         .command('create')
         .description('Create a new live streaming channel')
@@ -446,6 +500,671 @@ Note:
   This command allows deleting up to 100 channels in a single operation.
   For single channel deletion with interactive confirmation, use 'channel delete' instead.
 `);
+    const addViewerCommonOptions = (cmd) => cmd
+        .option('--scope <scope>', 'live-bg endpoint scope (user|teacher)', validateChannelViewerScope, 'user')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table');
+    const addViewerFilterOptions = (cmd) => addViewerCommonOptions(cmd
+        .option('--group-id <id>', 'viewer group ID', parseInteger)
+        .option('--viewer-id <viewerId>', 'viewer ID')
+        .option('--nickname <nickname>', 'viewer nickname')
+        .option('--mobile <mobile>', 'viewer mobile'));
+    const viewerCmd = channelCmd
+        .command('viewer')
+        .description('Manage channel-owned viewers and viewer groups');
+    viewerCmd.addHelpText('after', `
+Examples:
+  $ polyv-live-cli channel viewer group list --channel-id 3151318
+  $ polyv-live-cli channel viewer list --channel-id 3151318 --page 1 --size 20 -o json
+  $ polyv-live-cli channel viewer import --channel-id 3151318 --file viewers.xlsx --force
+
+Scope:
+  --scope user     Use /live-bg/v3/user endpoints (default)
+  --scope teacher  Use /live-bg/v3/teacher endpoints
+`);
+    const viewerGroupCmd = viewerCmd
+        .command('group')
+        .description('Manage channel viewer groups');
+    addViewerCommonOptions(viewerGroupCmd.command('list')
+        .description('List channel viewer groups')
+        .requiredOption('--channel-id <id>', 'channel ID')).action((options) => runChannelViewerCommand((handler) => handler.listChannelViewerGroups(options)));
+    addViewerCommonOptions(viewerGroupCmd.command('create')
+        .description('Create a channel viewer group')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--name <name>', 'group name')
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Create channel viewer group "${options.name}"?`, (handler) => handler.createChannelViewerGroup(options)));
+    addViewerCommonOptions(viewerGroupCmd.command('update')
+        .description('Update a channel viewer group')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--id <id>', 'group ID', parseInteger)
+        .requiredOption('--name <name>', 'group name')
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Update channel viewer group ${options.id}?`, (handler) => handler.updateChannelViewerGroup(options)));
+    addViewerCommonOptions(viewerGroupCmd.command('delete')
+        .description('Delete a channel viewer group')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--id <id>', 'group ID', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Delete channel viewer group ${options.id}?`, (handler) => handler.deleteChannelViewerGroup(options)));
+    const viewerGroupSettingCmd = viewerCmd
+        .command('group-setting')
+        .description('Manage channel viewer group settings');
+    addViewerCommonOptions(viewerGroupSettingCmd.command('get')
+        .description('Get channel viewer group settings')
+        .requiredOption('--channel-id <id>', 'channel ID')).action((options) => runChannelViewerCommand((handler) => handler.getChannelViewerGroupSetting(options)));
+    addViewerCommonOptions(viewerGroupSettingCmd.command('update')
+        .description('Update channel viewer group settings')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--channel-viewer-group-enabled <Y|N>', 'enable channel viewer groups', validateYnFlag)
+        .option('--not-in-group-watch-enabled <Y|N>', 'allow viewers outside groups to watch', validateYnFlag)
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Update channel viewer group settings for ${options.channelId}?`, (handler) => handler.updateChannelViewerGroupSetting(options)));
+    addViewerFilterOptions(viewerCmd.command('list')
+        .description('List viewers belonging to a channel')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--page <page>', 'page number', parseInteger, 1)
+        .option('--size <size>', 'page size', parseInteger, 10)).action((options) => runChannelViewerCommand((handler) => handler.listChannelViewers(options)));
+    addViewerFilterOptions(viewerCmd.command('export')
+        .description('Export viewers belonging to a channel')
+        .requiredOption('--channel-id <id>', 'channel ID')).action((options) => runChannelViewerCommand((handler) => handler.exportChannelViewers(options)));
+    addViewerCommonOptions(viewerCmd.command('add')
+        .description('Add viewers to a channel')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--viewer-ids <ids>', 'viewer IDs, comma-separated')
+        .option('--group-id <id>', 'target group ID', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Add viewers to channel ${options.channelId}?`, (handler) => handler.addChannelViewers(options)));
+    addViewerCommonOptions(viewerCmd.command('delete')
+        .description('Delete viewers from a channel')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--viewer-ids <ids>', 'viewer IDs, comma-separated')
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Delete viewers from channel ${options.channelId}?`, (handler) => handler.deleteChannelViewers(options)));
+    addViewerCommonOptions(viewerCmd.command('transfer')
+        .description('Transfer viewers to another group')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--viewer-ids <ids>', 'viewer IDs, comma-separated')
+        .option('--target-group-id <id>', 'target group ID; omit to clear group association', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Transfer viewers in channel ${options.channelId}?`, (handler) => handler.transferChannelViewers(options)));
+    addViewerCommonOptions(viewerCmd.command('import')
+        .description('Import channel viewers from a file')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--file <path>', 'viewer import file (.xls, .xlsx, or .csv)')
+        .option('--group-id <id>', 'target group ID', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')).action((options) => runChannelViewerWriteCommand(options, `Import viewers into channel ${options.channelId} from ${options.file}?`, (handler) => handler.importChannelViewers(options)));
+    addViewerCommonOptions(viewerCmd.command('unrelated-list')
+        .description('List viewers not joined to any channel group')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--name <name>', 'viewer name')
+        .option('--mobile <mobile>', 'mobile number')
+        .option('--external-viewer-id <id>', 'external viewer ID')
+        .option('--wx-open-id <id>', 'WeChat OpenID')
+        .option('--wx-union-id <id>', 'WeChat UnionID')
+        .option('--nickname <nickname>', 'viewer nickname')
+        .option('--wx-nick-name <nickname>', 'WeChat nickname')
+        .option('--source <source>', 'viewer source')
+        .option('--email <email>', 'email')
+        .option('--area <area>', 'area')
+        .option('--last-collect-mobile <mobile>', 'last collected mobile')
+        .option('--search-keyword <keyword>', 'keyword for nickname search')
+        .option('--viewer-id <viewerId>', 'viewer ID')
+        .option('--status <status>', 'viewer status')
+        .option('--start-create-time <time>', 'registration start time, yyyy-MM-dd HH:mm:ss')
+        .option('--end-create-time <time>', 'registration end time, yyyy-MM-dd HH:mm:ss')
+        .option('--label-ids <ids>', 'label IDs, comma-separated')
+        .option('--page <page>', 'page number', parseInteger, 1)
+        .option('--size <size>', 'page size', parseInteger, 10)).action((options) => runChannelViewerCommand((handler) => handler.listUnrelatedChannelViewers(options)));
+    channelCmd.command('basic-list')
+        .description('List V4 channel basic information')
+        .option('--page-number <page>', 'page number', parseInteger)
+        .option('--page-size <size>', 'page size', parseInteger)
+        .option('--category-ids <ids>', 'category IDs, comma-separated', api_command_1.parseStringList)
+        .option('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .option('--watch-status <status>', 'watch status filter')
+        .option('--start-time <timestamp>', 'start timestamp', parseInteger)
+        .option('--end-time <timestamp>', 'end timestamp', parseInteger)
+        .option('--order-by <orderBy>', 'order by value')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.listChannelBasicExact((0, api_command_1.apiParams)(options))));
+    channelCmd.command('simple-list')
+        .description('List V4 channel compact information')
+        .option('--page-number <page>', 'page number', parseInteger)
+        .option('--page-size <size>', 'page size', parseInteger)
+        .option('--category-id <id>', 'category ID')
+        .option('--watch-status <status>', 'watch status filter')
+        .option('--keyword <keyword>', 'channel keyword')
+        .option('--order-by <orderBy>', 'order by value')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.listChannelSimple((0, api_command_1.apiParams)(options))));
+    channelCmd.command('live-status-list')
+        .description('Batch query V4 channel live status')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated, max 200', api_command_1.parseStringList)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.listLiveStatus((0, api_command_1.apiParams)(options))));
+    channelCmd.command('batch-create')
+        .description('Batch create V4 live channels')
+        .requiredOption('--channels-json <json>', 'channels JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Create ${options.channelsJson.length} channel(s)?`, (service) => service.createBatch((0, api_command_1.apiParams)({
+        ...options,
+        channels: options.channelsJson,
+        channelsJson: undefined,
+    }))));
+    channelCmd.command('v4-update')
+        .description('Update V4 channel basic information')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--name <name>', 'channel name')
+        .option('--publisher <publisher>', 'publisher name')
+        .option('--channel-passwd <password>', 'channel password')
+        .option('--start-time <timestamp>', 'start timestamp', parseInteger)
+        .option('--end-time <timestamp>', 'end timestamp', parseInteger)
+        .option('--cover-img <url>', 'cover image URL')
+        .option('--splash-img <url>', 'splash image URL')
+        .option('--desc <description>', 'channel description')
+        .option('--publishing-region <region>', 'publishing region')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            ensureAtLeastOneOption(options, [
+                'name',
+                'publisher',
+                'channelPasswd',
+                'startTime',
+                'endTime',
+                'coverImg',
+                'splashImg',
+                'desc',
+                'publishingRegion',
+            ]);
+            await runChannelApiWriteCommand(options, `Update V4 channel ${options.channelId}?`, (service) => service.updateV4((0, api_command_1.apiParams)(options)));
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    channelCmd.command('create-init')
+        .description('Create and initialize a V4 channel')
+        .requiredOption('--basic-setting-json <json>', 'basicSetting JSON object', api_command_1.parseJsonObject)
+        .option('--master-auth-setting-json <json>', 'masterAuthSetting JSON object', api_command_1.parseJsonObject)
+        .option('--playback-setting-json <json>', 'playbackSetting JSON object', api_command_1.parseJsonObject)
+        .option('--roles-json <json>', 'roles JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Create initialized channel "${options.basicSettingJson?.name || ''}"?`, (service) => service.createInit((0, api_command_1.apiParams)({
+        ...options,
+        basicSetting: options.basicSettingJson,
+        masterAuthSetting: options.masterAuthSettingJson,
+        playbackSetting: options.playbackSettingJson,
+        roles: options.rolesJson,
+        basicSettingJson: undefined,
+        masterAuthSettingJson: undefined,
+        playbackSettingJson: undefined,
+        rolesJson: undefined,
+    }))));
+    channelCmd.command('mr-create')
+        .description('Create a V4 MR channel')
+        .requiredOption('--name <name>', 'channel name')
+        .option('--category-id <id>', 'category ID', parseInteger)
+        .option('--start-time <timestamp>', 'start timestamp', parseInteger)
+        .option('--channel-passwd <password>', 'channel password')
+        .option('--assistant-passwd <password>', 'assistant password')
+        .option('--splash-img <url>', 'splash image URL')
+        .option('--sub-account <email>', 'sub account email')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Create MR channel "${options.name}"?`, (service) => service.createMrChannel((0, api_command_1.apiParams)(options))));
+    channelCmd.command('pull-bitrate-set')
+        .description('Set V4 channel pull bitrate')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--pull-bit-rate <bitrate>', 'pull bitrate: -1,400,600,800,1000,1500,2000,2500', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Set pull bitrate for channel ${options.channelId}?`, (service) => service.setPullBitrate((0, api_command_1.apiParams)(options))));
+    channelCmd.command('template-update')
+        .description('Update V4 channel live template')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--template <template>', 'template value', validateTemplate)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update template for channel ${options.channelId}?`, (service) => service.updateTemplate((0, api_command_1.apiParams)(options))));
+    const roleCmd = channelCmd.command('role').description('Manage historical channel role accounts');
+    roleCmd.command('get')
+        .description('Get one role account')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--account <account>', 'role account ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getRoleAccount(options)));
+    roleCmd.command('list')
+        .description('List role accounts')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.listRoleAccounts(options)));
+    roleCmd.command('batch-create')
+        .description('Batch create role accounts')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--accounts-json <json>', 'accounts JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.batchCreateRoleAccounts({
+        ...options,
+        accounts: options.accountsJson
+    })));
+    roleCmd.command('delete')
+        .description('Delete one role account')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--account <account>', 'role account ID')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.deleteRoleAccount(options)));
+    roleCmd.command('account-create')
+        .description('Create a V4 assistant or guest role account')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--role <role>', 'role, for example Assistant or Guest')
+        .option('--actor <actor>', 'actor label')
+        .option('--nick-name <name>', 'nickname')
+        .option('--avatar <url>', 'avatar URL')
+        .option('--passwd <password>', 'role account password')
+        .option('--purview-list-json <json>', 'purviewList JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Create ${options.role} account in channel ${options.channelId}?`, (service) => service.createAccount((0, api_command_1.apiParams)({
+        ...options,
+        purviewList: options.purviewListJson,
+        purviewListJson: undefined,
+    }))));
+    roleCmd.command('account-update')
+        .description('Update a V4 role account')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--account <account>', 'role account')
+        .option('--actor <actor>', 'actor label')
+        .option('--nick-name <name>', 'nickname')
+        .option('--avatar <url>', 'avatar URL')
+        .option('--passwd <password>', 'role account password')
+        .option('--purview-list-json <json>', 'purviewList JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update role account ${options.account} in channel ${options.channelId}?`, (service) => service.updateAccountInfo((0, api_command_1.apiParams)({
+        ...options,
+        purviewList: options.purviewListJson,
+        purviewListJson: undefined,
+    }))));
+    roleCmd.command('accounts-delete')
+        .description('Batch delete V4 role accounts')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--accounts <accounts>', 'role accounts, comma-separated', api_command_1.parseStringList)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Delete ${options.accounts.length} role account(s) from channel ${options.channelId}?`, (service) => service.deleteAccountsBatch((0, api_command_1.apiParams)(options))));
+    roleCmd.command('teacher-list')
+        .description('Batch query V4 teacher information')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.teacherList((0, api_command_1.apiParams)(options))));
+    roleCmd.command('viewer-get')
+        .description('Get V4 role-viewer display config')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getAccountViewerConfig((0, api_command_1.apiParams)(options))));
+    roleCmd.command('viewer-update')
+        .description('Update V4 role-viewer display config')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--actor <actor>', 'actor title')
+        .option('--actor-enabled <Y|N>', 'actor title switch', validateYnFlag)
+        .option('--question-student-title <title>', 'question student title')
+        .option('--question-student-title-enabled <Y|N>', 'question student title switch', validateYnFlag)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update role-viewer config for channel ${options.channelId}?`, (service) => service.updateAccountViewerConfig((0, api_command_1.apiParams)(options))));
+    roleCmd.command('config-get')
+        .description('Get V4 role config by role')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--role <role>', 'role')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getByRole((0, api_command_1.apiParams)(options))));
+    roleCmd.command('config-update')
+        .description('Update V4 role config by role')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--role <role>', 'role')
+        .requiredOption('--config-json <json>', 'config JSON object', api_command_1.parseJsonObject)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update role config ${options.role} for channel ${options.channelId}?`, (service) => service.updateByRole((0, api_command_1.apiParams)({
+        ...options,
+        config: options.configJson,
+        configJson: undefined,
+    }))));
+    const subtitleCmd = channelCmd.command('subtitle').description('Manage V4 realtime subtitle settings');
+    subtitleCmd.command('config-get')
+        .description('Get realtime subtitle config')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getSubtitleConfig((0, api_command_1.apiParams)(options))));
+    subtitleCmd.command('languages')
+        .description('List all realtime subtitle languages')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.listSubtitleLanguages()));
+    subtitleCmd.command('config-update')
+        .description('Update realtime subtitle config')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--real-time-subtitle-enabled <Y|N>', 'realtime subtitle switch', validateYnFlag)
+        .option('--real-time-subtitle-display-enabled <Y|N>', 'display realtime subtitle switch', validateYnFlag)
+        .option('--source-language <code>', 'source language code')
+        .option('--subtitle-translation-enabled <Y|N>', 'translation switch', validateYnFlag)
+        .option('--translation-language <code>', 'single translation language')
+        .option('--translation-languages <codes>', 'translation language codes, comma-separated', api_command_1.parseStringList)
+        .option('--subtitle-callback-enabled <Y|N>', 'subtitle callback switch', validateYnFlag)
+        .option('--subtitle-callback-url <url>', 'subtitle callback URL')
+        .option('--real-time-subtitle-display-number-limit-enabled <Y|N>', 'display line limit switch', validateYnFlag)
+        .option('--real-time-subtitle-display-number <number>', 'display line count', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update subtitle config for channel ${options.channelId}?`, (service) => service.updateSubtitleConfig((0, api_command_1.apiParams)(options))));
+    const distributeCmd = channelCmd.command('distribute').description('Manage V4 cloud distribution');
+    distributeCmd.command('list')
+        .description('List cloud distribution endpoints')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--distribute-ids <ids>', 'distribution IDs, comma-separated')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.distributeList((0, api_command_1.apiParams)(options))));
+    distributeCmd.command('create-batch')
+        .description('Batch create cloud distribution endpoints')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--distributes-json <json>', 'distributes JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Create ${options.distributesJson.length} distribution endpoint(s) for channel ${options.channelId}?`, (service) => service.distributeCreateBatch((0, api_command_1.apiParams)({
+        ...options,
+        distributes: options.distributesJson,
+        distributesJson: undefined,
+    }))));
+    distributeCmd.command('update-batch')
+        .description('Batch update cloud distribution endpoints')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--distributes-json <json>', 'distributes JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update ${options.distributesJson.length} distribution endpoint(s) for channel ${options.channelId}?`, (service) => service.distributeUpdateBatch((0, api_command_1.apiParams)({
+        ...options,
+        distributes: options.distributesJson,
+        distributesJson: undefined,
+    }))));
+    distributeCmd.command('delete-batch')
+        .description('Batch delete cloud distribution endpoints')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--ids <ids>', 'distribution IDs, comma-separated', api_command_1.parseNumberList)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Delete ${options.ids.length} distribution endpoint(s) from channel ${options.channelId}?`, (service) => service.distributeDeleteBatch((0, api_command_1.apiParams)(options))));
+    distributeCmd.command('statistic')
+        .description('Get cloud distribution statistics')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--session-ids <ids>', 'session IDs, comma-separated', api_command_1.parseStringList)
+        .option('--start-time <timestamp>', 'start timestamp', parseInteger)
+        .option('--end-time <timestamp>', 'end timestamp', parseInteger)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getDistributeStatistic((0, api_command_1.apiParams)(options))));
+    distributeCmd.command('master-switch')
+        .description('Update cloud distribution master switch')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--enabled <Y|N>', 'master switch', validateYnFlag)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update distribution master switch for channel ${options.channelId}?`, (service) => service.updateMasterSwitch((0, api_command_1.apiParams)(options))));
+    distributeCmd.command('switch')
+        .description('Update one cloud distribution endpoint switch')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--distribute-id <id>', 'distribution ID', parseInteger)
+        .requiredOption('--enabled <Y|N>', 'endpoint switch', validateYnFlag)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiWriteCommand(options, `Update distribution ${options.distributeId} switch for channel ${options.channelId}?`, (service) => service.updateSwitch((0, api_command_1.apiParams)(options))));
+    channelCmd.command('advert-list')
+        .description('List channel adverts')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getChannelAdverts(options)));
+    const callbackCmd = channelCmd.command('callback').description('Manage channel callback settings');
+    callbackCmd.command('get')
+        .description('Get channel callback settings')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getCallbackSetting(options)));
+    callbackCmd.command('update')
+        .description('Update channel callback settings')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--record-callback-url <url>', 'record callback URL')
+        .option('--record-callback-video-type <type>', 'record callback video type')
+        .option('--playback-callback-url <url>', 'playback callback URL')
+        .option('--stream-callback-url <url>', 'stream callback URL')
+        .option('--ppt-record-callback-url <url>', 'PPT record callback URL')
+        .option('--live-scan-callback-url <url>', 'live scan callback URL')
+        .option('--playback-cache-callback-url <url>', 'playback cache callback URL')
+        .option('--subtitle-callback-url <url>', 'subtitle callback URL')
+        .option('--live-violation-cutoff-callback-url <url>', 'live violation cutoff callback URL')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.updateCallbackSetting(options)));
+    const pptRecordCmd = channelCmd.command('ppt-record').description('Manage PPT record remake tasks and settings');
+    const pptRecordSettingCmd = pptRecordCmd.command('setting').description('Manage PPT record setting');
+    pptRecordSettingCmd.command('get')
+        .description('Get PPT record setting')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getPptRecordSetting(options)));
+    pptRecordSettingCmd.command('update')
+        .description('Update PPT record setting')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--global-setting-enabled <Y|N>', 'global setting enabled', validateYnFlag)
+        .option('--type <type>', 'record layout type: 0|1|2', parseInteger)
+        .option('--video-ratio <ratio>', 'camera ratio: 0|1', parseInteger)
+        .option('--brand-img-file <pathOrUrl>', 'brand image file or URL')
+        .option('--background-img-file <pathOrUrl>', 'background image file or URL')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.updatePptRecordSetting(options)));
+    pptRecordCmd.command('list')
+        .description('List PPT record tasks')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--session-id <id>', 'session ID')
+        .option('--status <status>', 'task status')
+        .option('--start-time <time>', 'start time yyyyMMddHHmmss')
+        .option('--end-time <time>', 'end time yyyyMMddHHmmss')
+        .option('--page <page>', 'page number', parseInteger)
+        .option('--page-size <size>', 'page size', parseInteger)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.listPptRecordTasks(options)));
+    pptRecordCmd.command('add-task')
+        .description('Create a PPT record remake task')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--video-id <id>', 'playback video ID')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.addPptRecordTask(options)));
+    pptRecordCmd.command('delete')
+        .description('Delete PPT record tasks')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--task-ids <ids>', 'task IDs, comma-separated', api_command_1.parseStringList)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.deletePptRecord(options)));
+    channelCmd.command('copy')
+        .description('Copy a channel')
+        .requiredOption('--channel-id <id>', 'source channel ID')
+        .option('--name <name>', 'new channel name')
+        .option('--category-id <id>', 'category ID', parseInteger)
+        .option('--start-time <timestamp>', 'start time timestamp', parseInteger)
+        .option('--sub-account <account>', 'sub account')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.copyChannel(options)));
+    channelCmd.command('children-list')
+        .description('List channels owned by a child account')
+        .requiredOption('--child-user-id <id>', 'child user ID')
+        .option('--start-time <timestamp>', 'created start timestamp', parseInteger)
+        .option('--end-time <timestamp>', 'created end timestamp', parseInteger)
+        .option('--page-number <page>', 'page number', parseInteger, 1)
+        .option('--page-size <size>', 'page size', parseInteger, 20)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getUserChildrenChannels(options)));
+    const tokenCmd = channelCmd.command('token').description('Manage channel historical tokens');
+    tokenCmd.command('watch-api')
+        .description('Get watch API token')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--viewer-id <id>', 'viewer ID')
+        .option('--nickname <nickname>', 'viewer nickname')
+        .option('--avatar <url>', 'viewer avatar')
+        .option('--openid <openid>', 'WeChat OpenID')
+        .option('--actor <actor>', 'viewer actor')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getWatchApiToken(options)));
+    tokenCmd.command('api')
+        .description('Get channel API token')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--viewer-id <id>', 'viewer ID')
+        .option('--nickname <nickname>', 'viewer nickname')
+        .option('--avatar <url>', 'viewer avatar')
+        .option('--openid <openid>', 'WeChat OpenID')
+        .option('--actor <actor>', 'viewer actor')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getApiToken(options)));
+    tokenCmd.command('login-url')
+        .description('Get passwordless role login URL')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--account-id <id>', 'role account ID')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getTokenLoginUrl(options)));
+    tokenCmd.command('chat')
+        .description('Get chat token')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--user-id <id>', 'viewer/user ID')
+        .requiredOption('--role <role>', 'role: teacher|admin|guest|assistant|viewer', validateChatTokenRole)
+        .option('--origin <origin>', 'watch origin')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.getChatToken(options)));
+    tokenCmd.command('set')
+        .description('Set one-time login token for a channel')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--token <token>', 'token')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.setChannelToken(options)));
+    tokenCmd.command('set-account')
+        .description('Set one-time login token for a sub-account channel')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--token <token>', 'token')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.setAccountToken(options)));
+    const authCmd = channelCmd.command('auth').description('Manage channel auth tokens');
+    authCmd.command('api-token')
+        .description('Get a channel API access token')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--disposable <true|false>', 'whether the token is disposable', parseBoolean)
+        .option('--expire-seconds <seconds>', 'token expiration seconds', parseInteger)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getChannelApiAccessToken((0, api_command_1.apiParams)(options))));
+    authCmd.command('test-mode-token')
+        .description('Get a watch-page test mode token')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .option('--expire-time <seconds>', 'token validity seconds, max 30 days', parseInteger)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelApiCommand(options, (service) => service.getTestModeToken((0, api_command_1.apiParams)(options))));
+    const followCmd = channelCmd.command('follow').description('Manage follow-public-account settings');
+    followCmd.command('list')
+        .description('List channel follow settings')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.listChannelsFollow(options)));
+    followCmd.command('update')
+        .description('Update channel follow settings')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .requiredOption('--qr-code-url <url>', 'QR code image URL')
+        .option('--enabled <Y|N>', 'follow feature switch', validateYnFlag)
+        .option('--auto-show-enabled <Y|N>', 'auto popup switch', validateYnFlag)
+        .option('--entrance-text <text>', 'entry text')
+        .option('--tips <text>', 'popup tips')
+        .option('--pc-follow-tips <text>', 'PC popup tips')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.updateChannelsFollow(options)));
+    channelCmd.command('submeeting-batch-add')
+        .description('Batch save submeeting channels')
+        .requiredOption('--channel-id <id>', 'main meeting channel ID')
+        .requiredOption('--sub-channels-json <json>', 'sub channels JSON array', api_command_1.parseJsonArray)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.batchAddSubmeeting({
+        ...options,
+        subChannels: options.subChannelsJson
+    })));
+    channelCmd.command('questionnaire-stop')
+        .description('Stop questionnaires for channels')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.stopQuestionnaires(options)));
+    channelCmd.command('danmu-batch-update')
+        .description('Batch update channel danmu settings')
+        .requiredOption('--channel-ids <ids>', 'channel IDs, comma-separated', api_command_1.parseStringList)
+        .requiredOption('--close-danmu <Y|N>', 'Y closes danmu, N opens danmu', validateYnFlag)
+        .requiredOption('--show-danmu-info-enabled <Y|N>', 'show danmu info enabled', validateYnFlag)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.batchUpdateDanmu(options)));
+    channelCmd.command('max-viewer-set')
+        .description('Set max viewer count')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--user-id <id>', 'user ID')
+        .requiredOption('--max-viewer <count>', 'max viewer count', parseInteger)
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.setMaxViewer(options)));
+    channelCmd.command('password-update')
+        .description('Update channel password')
+        .requiredOption('--user-id <id>', 'user ID')
+        .requiredOption('--passwd <password>', 'new password')
+        .option('--channel-id <id>', 'channel ID; omit to update all channels')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.updateChannelPassword(options)));
+    channelCmd.command('marquee-url-set')
+        .description('Set custom URL marquee protection')
+        .requiredOption('--channel-id <id>', 'channel ID')
+        .requiredOption('--marquee-restrict <Y|N>', 'marquee restriction switch', validateYnFlag)
+        .option('--url <url>', 'marquee URL, required when switch is Y')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action((options) => runChannelViewerCommand((handler) => handler.setDiyUrlMarquee(options)));
+    channelCmd.command('status-valid')
+        .description('Check whether channel statuses are valid')
+        .requiredOption('--channels <ids>', 'channel IDs, comma-separated, max 100')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const result = await new channel_service_sdk_1.ChannelServiceSdk(authConfig, serviceConfig).checkChannelStatusValid((0, api_command_1.apiParams)(options));
+            console.log(JSON.stringify(result, null, 2));
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    channelCmd.command('ccb-focus-reset')
+        .description('Reset CCB focus channels')
+        .option('--channel-ids <ids>', 'channel IDs, comma-separated; omit to clear focus')
+        .option('-f, --force', 'skip confirmation prompt')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            await (0, api_command_1.confirmWrite)(options.force, 'Reset CCB focus channels?');
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(program.opts());
+            const params = (0, api_command_1.apiParams)(options);
+            const result = await new channel_service_sdk_1.ChannelServiceSdk(authConfig, serviceConfig).resetCcbFocus(params);
+            console.log(JSON.stringify({ success: true, result }, null, 2));
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
 }
 function parseInteger(value) {
     const parsed = parseInt(value, 10);
@@ -454,6 +1173,19 @@ function parseInteger(value) {
     }
     return parsed;
 }
+function parseBoolean(value) {
+    if (['true', '1', 'Y', 'y', 'yes'].includes(value))
+        return true;
+    if (['false', '0', 'N', 'n', 'no'].includes(value))
+        return false;
+    throw new Error(`Invalid boolean: ${value}. Must be true or false.`);
+}
+function ensureAtLeastOneOption(options, fields) {
+    const hasValue = fields.some((field) => options[field] !== undefined && options[field] !== null && options[field] !== '');
+    if (!hasValue) {
+        throw new Error(`At least one update option is required: ${fields.join(', ')}`);
+    }
+}
 function validateScene(value) {
     const validScenes = ['topclass', 'alone', 'seminar', 'train', 'double', 'guide'];
     if (!validScenes.includes(value)) {
@@ -485,4 +1217,24 @@ function validateOutputFormat(value) {
     }
     return value;
 }
+function validateChannelViewerScope(value) {
+    const validScopes = ['user', 'teacher'];
+    if (!validScopes.includes(value)) {
+        throw new Error(`Invalid scope: ${value}. Must be one of: ${validScopes.join(', ')}`);
+    }
+    return value;
+}
+function validateYnFlag(value) {
+    if (value !== 'Y' && value !== 'N') {
+        throw new Error('Invalid value. Must be Y or N');
+    }
+    return value;
+}
+function validateChatTokenRole(value) {
+    const validRoles = ['teacher', 'admin', 'guest', 'assistant', 'viewer'];
+    if (!validRoles.includes(value)) {
+        throw new Error(`Invalid role: ${value}. Must be one of: ${validRoles.join(', ')}`);
+    }
+    return value;
+}
 //# sourceMappingURL=channel.commands.js.map