tirtc-devtools-cli 0.0.4 → 0.0.6

package/dist/devtools/cli/src/index.js

@@ -1,15 +1,20 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const protocol_client_1 = require("../../../app-server/protocol-client");
 const facade_1 = require("./facade");
 const config_1 = require("./config");
 const guide_1 = require("./guide");
 const session_manager_1 = require("./session_manager");
 const media_assets_1 = require("./media_assets");
+const token_command_1 = require("./token_command");
 const transport_1 = require("./transport");
-const token_tool_1 = require("./token_tool");
-const CLI_VERSION = '0.0.4';
+const CLI_VERSION = '0.0.6';
 const HOST_VERSION = '1.0.0';
 const PROTOCOL_VERSION = '1.0.0';
 if (process.argv.includes('--version') || process.argv.includes('-V')) {
@@ -101,57 +106,91 @@ function toResultObject(result) {
     }
     return { result };
 }
-async function applyConfiguredStreamBootstrap(client, config) {
-    const sendStreams = [];
-    const mode = config.stream?.request_policy?.mode;
-    if (mode === 'manual' || mode === 'auto-if-bound') {
-        await client.sendRequest('stream/requestPolicy/set', { mode });
-    }
-    const configuredSend = config.streams?.send;
-    const assetsDir = configuredSend?.assets_dir;
-    const audioStreamId = configuredSend?.audio_stream_id;
-    const videoStreamId = configuredSend?.video_stream_id;
-    if (assetsDir && assetsDir.length > 0) {
-        if (Number.isFinite(audioStreamId)) {
-            const stream = await client.sendRequest('stream/sendStart', {
-                streamId: audioStreamId,
-                media: 'audio',
-                source: {
-                    mode: 'local_assets',
-                    local_assets: {
-                        assets_dir: assetsDir,
-                    },
-                },
-            }, 180_000);
-            sendStreams.push({
-                streamId: audioStreamId,
-                assetsDir,
-                media: 'audio',
-                stream,
-            });
-        }
-        if (Number.isFinite(videoStreamId)) {
-            const stream = await client.sendRequest('stream/sendStart', {
-                streamId: videoStreamId,
-                media: 'video',
-                source: {
-                    mode: 'local_assets',
-                    local_assets: {
-                        assets_dir: assetsDir,
-                    },
-                },
-            }, 180_000);
-            sendStreams.push({
-                streamId: videoStreamId,
-                assetsDir,
-                media: 'video',
-                stream,
-            });
-        }
+function requireConfigPath(configPath) {
+    if (!configPath || configPath.trim().length === 0) {
+        throw new Error('server-only service start requires --config <path>');
+    }
+    return configPath;
+}
+function validateServerConfig(config) {
+    const server = config.server;
+    const license = server?.license?.trim() ?? '';
+    const mp4Path = server?.mp4_path?.trim() ?? '';
+    const audioStreamIdValue = server?.audio_stream_id;
+    const videoStreamIdValue = server?.video_stream_id;
+    if (license.length === 0) {
+        throw new Error('server-only config requires [server].license');
+    }
+    if (mp4Path.length === 0) {
+        throw new Error('server-only config requires [server].mp4_path');
+    }
+    if (typeof audioStreamIdValue !== 'number') {
+        throw new Error('server-only config requires [server].audio_stream_id as non-negative integer');
+    }
+    if (!Number.isInteger(audioStreamIdValue) || audioStreamIdValue < 0) {
+        throw new Error('server-only config requires [server].audio_stream_id as non-negative integer');
+    }
+    if (typeof videoStreamIdValue !== 'number') {
+        throw new Error('server-only config requires [server].video_stream_id as non-negative integer');
+    }
+    if (!Number.isInteger(videoStreamIdValue) || videoStreamIdValue < 0) {
+        throw new Error('server-only config requires [server].video_stream_id as non-negative integer');
     }
+    const audioStreamId = audioStreamIdValue;
+    const videoStreamId = videoStreamIdValue;
+    if (audioStreamId === videoStreamId) {
+        throw new Error('server-only config requires distinct audio_stream_id and video_stream_id');
+    }
+    const resolvedMp4Path = path_1.default.resolve(mp4Path);
+    let stats;
+    try {
+        stats = fs_1.default.statSync(resolvedMp4Path);
+    }
+    catch {
+        throw new Error('server-only config mp4_path does not exist: ' + resolvedMp4Path);
+    }
+    if (!stats.isFile()) {
+        throw new Error('server-only config mp4_path must be a readable file: ' + resolvedMp4Path);
+    }
+    const serviceEntry = server?.service_entry?.trim();
+    return {
+        serviceEntry: serviceEntry && serviceEntry.length > 0 ? serviceEntry : undefined,
+        license,
+        mp4Path: resolvedMp4Path,
+        audioStreamId,
+        videoStreamId,
+    };
+}
+function resolvePrepareOutputRoot(config) {
+    const loggingRoot = config.logging?.root_dir?.trim();
+    if (loggingRoot && loggingRoot.length > 0) {
+        return path_1.default.resolve(loggingRoot, '..', 'prepared-assets');
+    }
+    return path_1.default.resolve(process.cwd(), '.tmp', 'tirtc-devtools-cli', 'prepared-assets');
+}
+async function applyConfiguredServerBootstrap(client, config) {
+    const server = validateServerConfig(config);
+    const prepared = await (0, media_assets_1.prepareMediaAssets)({
+        source: server.mp4Path,
+        outputRoot: resolvePrepareOutputRoot(config),
+    });
+    const bootstrapSendStreams = [
+        { streamId: server.audioStreamId, media: 'audio' },
+        { streamId: server.videoStreamId, media: 'video' },
+    ].map(({ streamId, media }) => ({
+        streamId,
+        media,
+        source: {
+            mode: 'local_assets',
+            local_assets: {
+                assets_dir: prepared.assets_dir,
+            },
+        },
+    }));
     return {
-        requestPolicyMode: mode,
-        sendStreams,
+        preparedAssetsDir: prepared.assets_dir,
+        mediaSendPolicy: 'AUTO_ON_CONNECTED',
+        bootstrapSendStreams,
     };
 }
 async function runCommand(cmdName, params, options) {
@@ -166,26 +205,25 @@ async function runCommand(cmdName, params, options) {
         if (!method) {
             throw new Error('Unknown command mapping for: ' + cmdName);
         }
-        const commandParams = cmdName === 'stream request-policy set' ? (() => {
-            const mode = String(params.mode ?? '');
-            if (mode !== 'manual' && mode !== 'auto-if-bound') {
-                throw new Error('Invalid mode, expected manual|auto-if-bound');
-            }
-            return { mode };
-        })() : params;
-        const result = await client.sendRequest(method, commandParams);
-        let resultForPrint = result;
+        let resultForPrint;
         if (cmdName === 'service start') {
-            const autoApplied = await applyConfiguredStreamBootstrap(client, config);
-            const hasAutoApplied = autoApplied.requestPolicyMode !== undefined || autoApplied.sendStreams.length > 0;
-            if (hasAutoApplied) {
-                const resultObject = toResultObject(result);
-                resultForPrint = {
-                    ...resultObject,
-                    autoApplied,
-                };
-            }
-        }
+            const autoApplied = await applyConfiguredServerBootstrap(client, config);
+            const requestParams = {
+                ...params,
+                bootstrapSendStreams: autoApplied.bootstrapSendStreams,
+            };
+            const result = await client.sendRequest(method, requestParams, 180_000);
+            const resultObject = toResultObject(result);
+            resultForPrint = {
+                ...resultObject,
+                autoApplied,
+            };
+            printSuccess(options, resultForPrint, session, cmdName);
+            transport.stop();
+            return 0;
+        }
+        const result = await client.sendRequest(method, params);
+        resultForPrint = result;
         printSuccess(options, resultForPrint, session, cmdName);
         transport.stop();
         return 0;
@@ -288,57 +326,11 @@ async function runMediaAssetsPrepare(source, outputRoot, outputDir, overwrite, o
         return exitCode;
     }
 }
-async function runTokenIssue(params, options) {
-    try {
-        const result = await (0, token_tool_1.issueTokenWithQrcode)(params);
-        if (options.json) {
-            console.log(JSON.stringify({
-                code: 0,
-                message: 'OK',
-                data: {
-                    payload: result.payload,
-                    payloadJson: result.payloadJson,
-                    token: result.token,
-                    qrCodePngPath: result.qrCodePngPath,
-                },
-            }));
-        }
-        else {
-            console.log((0, token_tool_1.formatTokenIssueConsoleOutput)(result));
-        }
-        return 0;
-    }
-    catch (error) {
-        const normalized = normalizeError(error);
-        const reasonCode = normalized.reasonCode;
-        const exitCode = facade_1.ErrorReasonCodeMapping[reasonCode] ?? 1;
-        if (options.json) {
-            console.log(JSON.stringify({
-                code: exitCode,
-                message: normalized.message,
-                data: normalized.data,
-            }));
-        }
-        else {
-            console.error('Error (' + reasonCode + '): ' + normalized.message);
-        }
-        return exitCode;
-    }
-}
 function runAndExit(promise) {
     promise.then((code) => {
         process.exit(code);
     });
 }
-function mustParseJsonPayload(input) {
-    try {
-        const parsed = JSON.parse(input);
-        return JSON.stringify(parsed);
-    }
-    catch {
-        throw new Error('payloadJson must be valid JSON text');
-    }
-}
 program.name('tirtc-devtools-cli')
     .description('TiRTC DevTools CLI')
     .option('--config <path>', '配置文件路径（TOML）')
@@ -483,22 +475,18 @@ mediaAssets.command('prepare')
     .action((commandOptions) => {
     runAndExit(runMediaAssetsPrepare(commandOptions.source, commandOptions.outputRoot, commandOptions.outputDir, commandOptions.overwrite === true, getCliOptions()));
 });
-// Backward-compatible alias.
 const hostConfig = host.command('config').description('配置辅助（兼容别名，推荐用顶层 config）');
 hostConfig.command('init [outputPath]').description('生成配置模板（等价于 config init）').action((outputPath) => {
     handleConfigInit(outputPath);
 });
 const service = program.command('service').description('服务端能力：启动/停止服务，等待远端接入');
-service.command('start [service_entry] [license]')
-    .description('启动服务端会话（license 必填，service_entry 可省略走默认）')
-    .action((service_entry, license) => {
-    const config = (0, config_1.loadConfig)(getCliOptions().config);
-    const finalServiceEntry = service_entry ?? config.service?.service_entry;
-    const finalLicense = license ?? config.service?.license;
-    if (!finalLicense) {
-        throw new Error('service start requires license (service_entry can be omitted)');
-    }
-    runAndExit(runCommand('service start', { serviceEntry: finalServiceEntry, license: finalLicense, timeoutMs: 5000 }, getCliOptions()));
+service.command('start')
+    .description('启动 server-only 会话（必须显式提供 --config）')
+    .action(() => {
+    const options = getCliOptions();
+    const config = (0, config_1.loadConfig)(requireConfigPath(options.config));
+    const server = validateServerConfig(config);
+    runAndExit(runCommand('service start', { serviceEntry: server.serviceEntry, license: server.license, timeoutMs: 5000 }, options));
 });
 service.command('stop').description('停止服务端监听').action(() => {
     runAndExit(runCommand('service stop', {}, getCliOptions()));
@@ -509,9 +497,10 @@ connection.command('show').description('查看连接状态').action(() => {
 });
 connection.command('connect [service_entry] <peer_id> [token]')
     .description('作为客户端连接远端（总是新建 session；不传 token 时自动签发）')
-    .action((service_entry, peer_id, token) => {
+    .action((serviceEntry, peerId, token) => {
     const config = (0, config_1.loadConfig)(getCliOptions().config);
-    const finalServiceEntry = [service_entry, config.connection?.service_entry, config.service?.service_entry].find((value) => typeof value === "string" && value.trim().length > 0);
+    const finalServiceEntry = [serviceEntry, config.connection?.service_entry, config.server?.service_entry]
+        .find((value) => typeof value === 'string' && value.trim().length > 0);
     const configuredToken = config.connection?.token?.trim();
     const manualToken = (token ?? configuredToken)?.trim();
     const autoTokenCfg = config.connection?.auto_token;
@@ -521,7 +510,7 @@ connection.command('connect [service_entry] <peer_id> [token]')
     }
     const params = {
         serviceEntry: finalServiceEntry,
-        peerId: peer_id,
+        peerId,
         timeoutMs: 5000,
     };
     if (manualToken && manualToken.length > 0) {
@@ -534,7 +523,7 @@ connection.command('connect [service_entry] <peer_id> [token]')
             openapiEntry: autoTokenCfg?.openapi_entry,
             accessId: autoTokenCfg?.access_id,
             secretKey: autoTokenCfg?.secret_key,
-            localId: autoTokenCfg?.local_id ?? peer_id,
+            localId: autoTokenCfg?.local_id ?? peerId,
             userTtlSeconds: autoTokenCfg?.user_ttl_seconds,
             channelTtlSeconds: autoTokenCfg?.channel_ttl_seconds,
         };
@@ -544,64 +533,22 @@ connection.command('connect [service_entry] <peer_id> [token]')
 connection.command('disconnect').description('断开当前连接').action(() => {
     runAndExit(runCommand('connection disconnect', {}, getCliOptions()));
 });
-const token = program.command('token').description('Token 工具：签发 token，并输出可直接使用的 JSON 与本地二维码 PNG');
-token.command('issue <access_id> <secret_key> <local_id> <peer_id>')
-    .description('使用 access/secret/local/peer 签发 token；输出摘要、payload JSON、token 和二维码 PNG 路径')
-    .option('--openapi-entry <url>', '可选 openapi entry；留空时走 runtime 默认值')
-    .option('--service-entry <entry>', '可选 service entry；用于组合连接 payload 与二维码 PNG')
-    .option('--user-ttl-seconds <seconds>', '可选 user token ttl（秒）')
-    .option('--channel-ttl-seconds <seconds>', '可选 channel token ttl（秒）')
-    .option('--qr-error-correction-level <level>', '二维码纠错级别：L/M/Q/H；默认 M')
-    .option('--ascii-max-columns <columns>', 'ASCII 二维码最大宽度；不传时优先读取当前终端宽度或 COLUMNS')
-    .action((access_id, secret_key, local_id, peer_id, commandOptions) => {
-    const parsePositiveInt = (name, raw) => {
-        if (raw === undefined) {
-            return undefined;
-        }
-        const parsed = Number.parseInt(raw, 10);
-        if (!Number.isInteger(parsed) || parsed <= 0) {
-            throw new Error(name + ' must be a positive integer');
-        }
-        return parsed;
-    };
-    const parseQrErrorCorrectionLevel = (raw) => {
-        if (raw === undefined) {
-            return undefined;
-        }
-        const normalized = raw.trim().toUpperCase();
-        if (normalized !== 'L' && normalized !== 'M' && normalized !== 'Q' && normalized !== 'H') {
-            throw new Error('qr-error-correction-level must be one of: L, M, Q, H');
-        }
-        return normalized;
-    };
-    runAndExit(runTokenIssue({
-        accessId: access_id,
-        secretKey: secret_key,
-        localId: local_id,
-        peerId: peer_id,
-        openapiEntry: commandOptions.openapiEntry,
-        serviceEntry: commandOptions.serviceEntry,
-        userTtlSeconds: parsePositiveInt('user-ttl-seconds', commandOptions.userTtlSeconds),
-        channelTtlSeconds: parsePositiveInt('channel-ttl-seconds', commandOptions.channelTtlSeconds),
-        qrErrorCorrectionLevel: parseQrErrorCorrectionLevel(commandOptions.qrErrorCorrectionLevel),
-        asciiMaxColumns: parsePositiveInt('ascii-max-columns', commandOptions.asciiMaxColumns),
-    }, getCliOptions()));
-});
-const stream = program.command('stream').description('流控制：发送/接收/请求策略');
+(0, token_command_1.registerTokenCommands)(program, getCliOptions, runAndExit);
+const stream = program.command('stream').description('流控制：发送/接收/消息');
 stream.command('list').description('查看流快照列表').action(() => {
     runAndExit(runCommand('stream list', {}, getCliOptions()));
 });
 const streamSend = stream.command('send').description('发送流：绑定 prepared local assets 并发起上行');
 streamSend.command('start <streamId> <media> <assets_dir>')
     .description('开始发送流（绑定 source.local_assets 并触发上行）')
-    .action((streamId, media, assets_dir) => {
+    .action((streamId, media, assetsDir) => {
     runAndExit(runCommand('stream send start', {
         streamId: Number.parseInt(streamId, 10),
         media,
         source: {
             mode: 'local_assets',
             local_assets: {
-                assets_dir,
+                assets_dir: assetsDir,
             },
         },
     }, getCliOptions()));
@@ -623,18 +570,13 @@ streamReceive.command('stop <streamId>')
     .action((streamId) => {
     runAndExit(runCommand('stream receive stop', { streamId: Number.parseInt(streamId, 10) }, getCliOptions()));
 });
-const streamRequestPolicy = stream.command('request-policy').description('远端请求策略：manual/auto-if-bound');
-streamRequestPolicy.command('get').description('查看远端请求策略').action(() => {
-    runAndExit(runCommand('stream request-policy get', {}, getCliOptions()));
-});
-streamRequestPolicy.command('set <mode>')
-    .description('设置远端请求策略（manual|auto-if-bound）')
-    .action((mode) => {
-    runAndExit(runCommand('stream request-policy set', { mode }, getCliOptions()));
+stream.command('message send <streamId> <payload>')
+    .description('发送 UTF-8 字符串型 stream message')
+    .action((streamId, payload) => {
+    runAndExit(runCommand('stream message send', { streamId: Number.parseInt(streamId, 10), payload }, getCliOptions()));
 });
 const output = program.command('output').description('输出挂载：文件等消费者 attach/detach');
-output
-    .command('attach <streamId> <consumer> <mediaView> <format> <delivery> [targetPath] [maxFiles]')
+output.command('attach <streamId> <consumer> <mediaView> <format> <delivery> [targetPath] [maxFiles]')
     .description('挂载输出消费者（如 file_sink）')
     .action((streamId, consumer, mediaView, format, delivery, targetPath, maxFiles) => {
     const parsed = facade_1.OutputAttachCliParamsSchema.safeParse({
@@ -665,7 +607,7 @@ output.command('detach <outputId>').description('卸载输出消费者').action(
 });
 const command = program.command('command').description('命令通道：发送命令与事件跟踪');
 command.command('send <commandId> <kind> <payloadEncoding> <payload>')
-    .description('发送命令并等待响应')
+    .description('发送字符串型命令并等待响应')
     .action((commandId, kind, payloadEncoding, payload) => {
     runAndExit(runCommand('command send', {
         commandId: Number.parseInt(commandId, 10),
@@ -676,28 +618,6 @@ command.command('send <commandId> <kind> <payloadEncoding> <payload>')
         timeoutMs: 5000,
     }, getCliOptions()));
 });
-command.command('send-json <commandId> <kind> <payloadJson>')
-    .description('发送 JSON 命令并等待响应（JSON-first）')
-    .action((commandId, kind, payloadJson) => {
-    const parsed = facade_1.CommandSendJsonParamsSchema.safeParse({
-        commandId: Number.parseInt(commandId, 10),
-        kind,
-        payloadJson,
-    });
-    if (!parsed.success) {
-        const msg = parsed.error.issues.map((issue) => issue.message).join('; ');
-        throw new Error('invalid command send-json params: ' + msg);
-    }
-    const payload = mustParseJsonPayload(payloadJson);
-    runAndExit(runCommand('command send', {
-        commandId: parsed.data.commandId,
-        kind: parsed.data.kind,
-        payloadEncoding: 'json',
-        payload,
-        awaitResponse: true,
-        timeoutMs: 5000,
-    }, getCliOptions()));
-});
 command.command('tail').description('持续监听命令相关事件').action(() => {
     runAndExit(tailEvents('command tail', ['command'], getCliOptions()));
 });
@@ -705,14 +625,14 @@ const debug = program.command('debug').description('调试工具：连接 bootst
 const debugBootstrap = debug.command('bootstrap').description('连接 bootstrap（不在 App Server 侧签发 token）');
 debugBootstrap.command('qrcode <access_id> <secret_key> <peer_id> [service_entry]')
     .description('生成客户端连接 bootstrap 二维码（payload 包含 access_id/secret_key/peer_id）')
-    .action((access_id, secret_key, peer_id, service_entry) => {
+    .action((accessId, secretKey, peerId, serviceEntry) => {
     const payload = JSON.stringify({
         version: 1,
         type: 'tirtc-connect-bootstrap',
-        access_id,
-        secret_key,
-        peer_id,
-        service_entry: service_entry ?? '',
+        access_id: accessId,
+        secret_key: secretKey,
+        peer_id: peerId,
+        service_entry: serviceEntry ?? '',
         generated_at: new Date().toISOString(),
     });
     runAndExit(runCommand('debug bootstrap qrcode', { payload, outputStem: 'connect-bootstrap' }, getCliOptions()));

package/dist/devtools/cli/src/token_command.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+export type CliOptions = {
+    config?: string;
+    json?: boolean;
+    session?: string;
+};
+export declare function registerTokenCommands(program: Command, getCliOptions: () => CliOptions, runAndExit: (promise: Promise<number>) => void): void;

package/dist/devtools/cli/src/token_command.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTokenCommands = registerTokenCommands;
+const facade_1 = require("./facade");
+const token_tool_1 = require("./token_tool");
+const kTokenIssueAccessIdEnvVar = 'TIRTC_CONN_ACCESS_ID';
+const kTokenIssueSecretKeyEnvVar = 'TIRTC_CONN_SECRET_KEY';
+function normalizeTokenCommandError(error) {
+    if (error instanceof Error) {
+        return {
+            reasonCode: 'internal_error',
+            message: error.message,
+            data: undefined,
+        };
+    }
+    if (typeof error === 'object' && error !== null) {
+        const typed = error;
+        return {
+            reasonCode: typed.reasonCode ?? 'internal_error',
+            message: typed.message ?? 'Internal error',
+            data: typed.data,
+        };
+    }
+    return {
+        reasonCode: 'internal_error',
+        message: 'Internal error',
+        data: undefined,
+    };
+}
+function printTokenCommandError(error, options) {
+    const normalized = normalizeTokenCommandError(error);
+    const reasonCode = normalized.reasonCode;
+    const exitCode = facade_1.ErrorReasonCodeMapping[reasonCode] ?? 1;
+    if (options.json) {
+        console.log(JSON.stringify({
+            code: exitCode,
+            message: normalized.message,
+            data: normalized.data,
+        }));
+    }
+    else {
+        console.error('Error (' + reasonCode + '): ' + normalized.message);
+    }
+    return exitCode;
+}
+async function runTokenIssue(params, options) {
+    try {
+        const result = await (0, token_tool_1.issueTokenWithQrcode)(params);
+        if (options.json) {
+            console.log(JSON.stringify({
+                code: 0,
+                message: 'OK',
+                data: {
+                    payload: result.payload,
+                    payloadJson: result.payloadJson,
+                    token: result.token,
+                    qrCodePngPath: result.qrCodePngPath,
+                },
+            }));
+        }
+        else {
+            console.log((0, token_tool_1.formatTokenIssueConsoleOutput)(result));
+        }
+        return 0;
+    }
+    catch (error) {
+        return printTokenCommandError(error, options);
+    }
+}
+function resolveTokenIssueCredential(explicitValue, envVarName, optionName) {
+    const normalizedExplicit = explicitValue?.trim();
+    if (normalizedExplicit) {
+        return normalizedExplicit;
+    }
+    const normalizedEnv = process.env[envVarName]?.trim();
+    if (normalizedEnv) {
+        return normalizedEnv;
+    }
+    throw new Error('missing credential: set environment variable ' + envVarName +
+        ' or pass ' + optionName + ' explicitly');
+}
+async function runTokenIssueFromCli(peerId, commandOptions, options) {
+    const parsePositiveInt = (name, raw) => {
+        if (raw === undefined) {
+            return undefined;
+        }
+        const parsed = Number.parseInt(raw, 10);
+        if (!Number.isInteger(parsed) || parsed <= 0) {
+            throw new Error(name + ' must be a positive integer');
+        }
+        return parsed;
+    };
+    const parseQrErrorCorrectionLevel = (raw) => {
+        if (raw === undefined) {
+            return undefined;
+        }
+        const normalized = raw.trim().toUpperCase();
+        if (normalized !== 'L' && normalized !== 'M' && normalized !== 'Q' && normalized !== 'H') {
+            throw new Error('qr-error-correction-level must be one of: L, M, Q, H');
+        }
+        return normalized;
+    };
+    try {
+        const accessId = resolveTokenIssueCredential(commandOptions.accessId, kTokenIssueAccessIdEnvVar, '--access-id');
+        const secretKey = resolveTokenIssueCredential(commandOptions.secretKey, kTokenIssueSecretKeyEnvVar, '--secret-key');
+        return await runTokenIssue({
+            accessId,
+            secretKey,
+            localId: commandOptions.localId?.trim() || peerId,
+            peerId,
+            openapiEntry: commandOptions.openapiEntry,
+            serviceEntry: commandOptions.serviceEntry,
+            userTtlSeconds: parsePositiveInt('user-ttl-seconds', commandOptions.userTtlSeconds),
+            channelTtlSeconds: parsePositiveInt('channel-ttl-seconds', commandOptions.channelTtlSeconds),
+            qrErrorCorrectionLevel: parseQrErrorCorrectionLevel(commandOptions.qrErrorCorrectionLevel),
+            asciiMaxColumns: parsePositiveInt('ascii-max-columns', commandOptions.asciiMaxColumns),
+        }, options);
+    }
+    catch (error) {
+        return printTokenCommandError(error, options);
+    }
+}
+function registerTokenCommands(program, getCliOptions, runAndExit) {
+    const token = program.command('token').description('Token 工具：签发 token，并输出可直接使用的 JSON 与本地二维码 PNG');
+    token.command('issue <peer_id>')
+        .description('默认从环境变量读取 access/secret，并以 peer_id 作为默认 local_id 来签发 token')
+        .option('--access-id <accessId>', '显式 access id；不传时读取 ' + kTokenIssueAccessIdEnvVar)
+        .option('--secret-key <secretKey>', '显式 secret key；不传时读取 ' + kTokenIssueSecretKeyEnvVar)
+        .option('--local-id <localId>', '显式 local id；不传时默认使用 peer_id')
+        .option('--openapi-entry <url>', '可选 openapi entry；留空时走 runtime 默认值')
+        .option('--service-entry <entry>', '可选 service entry；用于组合连接 payload 与二维码 PNG')
+        .option('--user-ttl-seconds <seconds>', '可选 user token ttl（秒）')
+        .option('--channel-ttl-seconds <seconds>', '可选 channel token ttl（秒）')
+        .option('--qr-error-correction-level <level>', '二维码纠错级别：L/M/Q/H；默认 M')
+        .option('--ascii-max-columns <columns>', 'ASCII 二维码最大宽度；不传时优先读取当前终端宽度或 COLUMNS')
+        .action((peerId, commandOptions) => {
+        runAndExit(runTokenIssueFromCli(peerId, commandOptions, getCliOptions()));
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tirtc-devtools-cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "private": false,
   "main": "dist/index.js",
   "bin": {