tirtc-devtools-cli 0.0.6 → 0.0.7

package/README.md

@@ -12,7 +12,7 @@
 
 - **唯一用户产品门面**：提供 `tirtc-devtools-cli` 命令族，覆盖常见的 RTC 测试操作，让内部研发、外部开发者和 AI agent 脚本无需手写底层协议。
 - **配置解析与翻译**：负责解析用户传入的 CLI 参数和 TOML 配置文件，进行本地必填校验、脱敏，并翻译为 App Server 协议的 request。
-- **产品级 Observability**：将底层的运行时事件和状态翻译为结构化输出 (JSON) 或友好的终端日志输出。
+- **产品级 Observability**：将底层的运行时事件和状态翻译为结构化输出 (JSON) 或友好的终端日志输出；对长耗时命令补轻量进度提示。
 - **调试期工具内聚**：承接调试期必要工具（如 token bootstrap、二维码与媒体预处理）的产品化入口，避免把调试流程散落在 runtime 或外部手工步骤中。
 - **本地 token 工具**：提供直接签发 token、打印组合 JSON、单独 token 与本地二维码 PNG 路径的公开 CLI 能力，服务本地联调与体验验证。
 

package/USAGE.md

@@ -130,8 +130,8 @@ server-only 正式路径只认 `[server] + [logging]`：
 service_entry = ""
 license = "runtime-license"
 mp4_path = "/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.refers/simple.mp4"
-video_stream_id = 10
-audio_stream_id = 11
+video_stream_id = 11
+audio_stream_id = 10
 
 [logging]
 root_dir = "./.tmp/tirtc-devtools-cli/logging"
@@ -159,6 +159,8 @@ node devtools/cli/bin/tirtc-devtools-cli.js --config ./server.toml --json servic
 4. 自动调用两次 `stream/sendStart`：一次音频、一次视频。
 5. 返回 `autoApplied` 摘要：`preparedAssetsDir`、固定 `mediaSendPolicy=AUTO_ON_CONNECTED`、以及音视频 sendStart 结果。
 
+非 `--json` 模式下，CLI 会在 `stderr` 输出轻量进度提示：先显示 MP4 prepare，再显示 service start，避免长时间静默。
+
 ### 3. 自动发送语义
 
 - App Server server 角色固定使用 `AUTO_ON_CONNECTED`。

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

@@ -37,8 +37,8 @@ function renderTomlConfigTemplate() {
         '# server-only service start 时必填',
         'license = ""',
         'mp4_path = "./source.mp4"',
-        'video_stream_id = 10',
-        'audio_stream_id = 11',
+        'video_stream_id = 11',
+        'audio_stream_id = 10',
         '',
         '[connection]',
         '# 作为客户端 connection connect 默认 service_entry（可留空）',

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

@@ -16,7 +16,7 @@ function printQuickstartGuide() {
         '  # 记下输出里的 sessionId，后续命令都显式带 --session',
         '',
         '步骤 2：CLI 会自动 prepare MP4 并绑定音视频 stream，不再需要手工 prepare assets_dir',
-        '  [server] service_entry = "" license = "<LICENSE>" mp4_path = "./.refers/simple.mp4" video_stream_id = 10 audio_stream_id = 11',
+        '  [server] service_entry = "" license = "<LICENSE>" mp4_path = "./.refers/simple.mp4" video_stream_id = 11 audio_stream_id = 10',
         '  # service start 成功后会自动 prepare 并按 AUTO_ON_CONNECTED 进入待发流语义',
         '',
         '步骤 3：生成连接 bootstrap 二维码（给安卓扫码）',

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

@@ -14,6 +14,7 @@ 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 progress_1 = require("./progress");
 const CLI_VERSION = '0.0.6';
 const HOST_VERSION = '1.0.0';
 const PROTOCOL_VERSION = '1.0.0';
@@ -161,6 +162,12 @@ function validateServerConfig(config) {
         videoStreamId,
     };
 }
+function createProgressIndicator(options) {
+    if (options.json) {
+        return undefined;
+    }
+    return new progress_1.ProgressIndicator();
+}
 function resolvePrepareOutputRoot(config) {
     const loggingRoot = config.logging?.root_dir?.trim();
     if (loggingRoot && loggingRoot.length > 0) {
@@ -168,12 +175,14 @@ function resolvePrepareOutputRoot(config) {
     }
     return path_1.default.resolve(process.cwd(), '.tmp', 'tirtc-devtools-cli', 'prepared-assets');
 }
-async function applyConfiguredServerBootstrap(client, config) {
+async function applyConfiguredServerBootstrap(client, config, progress) {
     const server = validateServerConfig(config);
+    progress?.start('Preparing MP4 assets');
     const prepared = await (0, media_assets_1.prepareMediaAssets)({
         source: server.mp4Path,
         outputRoot: resolvePrepareOutputRoot(config),
     });
+    progress?.update('Prepared MP4 assets');
     const bootstrapSendStreams = [
         { streamId: server.audioStreamId, media: 'audio' },
         { streamId: server.videoStreamId, media: 'video' },
@@ -207,20 +216,29 @@ async function runCommand(cmdName, params, options) {
         }
         let resultForPrint;
         if (cmdName === 'service start') {
-            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 progress = createProgressIndicator(options);
+            try {
+                const autoApplied = await applyConfiguredServerBootstrap(client, config, progress);
+                progress?.update('Starting service session');
+                const requestParams = {
+                    ...params,
+                    bootstrapSendStreams: autoApplied.bootstrapSendStreams,
+                };
+                const result = await client.sendRequest(method, requestParams, 180_000);
+                progress?.succeed('Service session is ready');
+                const resultObject = toResultObject(result);
+                resultForPrint = {
+                    ...resultObject,
+                    autoApplied,
+                };
+                printSuccess(options, resultForPrint, session, cmdName);
+                transport.stop();
+                return 0;
+            }
+            catch (error) {
+                progress?.fail('Service start failed');
+                throw error;
+            }
         }
         const result = await client.sendRequest(method, params);
         resultForPrint = result;

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

@@ -0,0 +1,19 @@
+export declare const SPINNER_INTERVAL_MS = 120;
+type ProgressStream = {
+    isTTY?: boolean;
+    write(chunk: string): boolean;
+};
+export declare class ProgressIndicator {
+    private readonly stream;
+    private timer;
+    private frameIndex;
+    private activeMessage;
+    constructor(stream?: ProgressStream);
+    start(message: string): void;
+    update(message: string): void;
+    succeed(message: string): void;
+    fail(message: string): void;
+    private render;
+    private finish;
+}
+export {};

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressIndicator = exports.SPINNER_INTERVAL_MS = void 0;
+const SPINNER_FRAMES = ['|', '/', '-', '\\'];
+exports.SPINNER_INTERVAL_MS = 120;
+function clearLine(text) {
+    return `\r\u001b[2K${text}`;
+}
+class ProgressIndicator {
+    stream;
+    timer;
+    frameIndex = 0;
+    activeMessage;
+    constructor(stream = process.stderr) {
+        this.stream = stream;
+    }
+    start(message) {
+        this.activeMessage = message;
+        if (this.stream.isTTY) {
+            if (this.timer === undefined) {
+                this.render();
+                this.timer = setInterval(() => {
+                    this.render();
+                }, exports.SPINNER_INTERVAL_MS);
+                return;
+            }
+            this.render();
+            return;
+        }
+        this.stream.write(`${message}...\n`);
+    }
+    update(message) {
+        this.start(message);
+    }
+    succeed(message) {
+        this.finish('OK', message);
+    }
+    fail(message) {
+        this.finish('FAIL', message);
+    }
+    render() {
+        if (this.activeMessage === undefined) {
+            return;
+        }
+        const frame = SPINNER_FRAMES[this.frameIndex % SPINNER_FRAMES.length];
+        this.frameIndex += 1;
+        this.stream.write(clearLine(`${frame} ${this.activeMessage}...`));
+    }
+    finish(tag, message) {
+        if (this.timer !== undefined) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.stream.isTTY) {
+            this.stream.write(`${clearLine(`[${tag}] ${message}`)}\n`);
+        }
+        else {
+            this.stream.write(`[${tag}] ${message}\n`);
+        }
+        this.activeMessage = undefined;
+    }
+}
+exports.ProgressIndicator = ProgressIndicator;

package/package.json

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