tirtc-devtools-cli 0.0.2 → 0.0.3

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

@@ -9,7 +9,7 @@ const session_manager_1 = require("./session_manager");
 const media_assets_1 = require("./media_assets");
 const transport_1 = require("./transport");
 const token_tool_1 = require("./token_tool");
-const CLI_VERSION = '0.0.1';
+const CLI_VERSION = '0.0.3';
 const HOST_VERSION = '1.0.0';
 const PROTOCOL_VERSION = '1.0.0';
 if (process.argv.includes('--version') || process.argv.includes('-V')) {

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

@@ -25,9 +25,11 @@ export type TokenIssueOutput = {
     payloadJson: string;
     token: string;
     qrCodePngPath: string;
+    qrCodeAscii: string;
 };
 export declare function issueToken(input: TokenIssueInput): Promise<string>;
 export declare function buildIssuedTokenPayload(input: TokenIssueInput, token: string): IssuedTokenPayload;
 export declare function writePngQrcode(payloadJson: string, outputPath: string): Promise<string>;
+export declare function buildAsciiQrcode(payloadJson: string): Promise<string>;
 export declare function issueTokenWithQrcode(input: TokenIssueInput): Promise<TokenIssueOutput>;
 export declare function formatTokenIssueConsoleOutput(output: TokenIssueOutput): string;

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

@@ -6,17 +6,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.issueToken = issueToken;
 exports.buildIssuedTokenPayload = buildIssuedTokenPayload;
 exports.writePngQrcode = writePngQrcode;
+exports.buildAsciiQrcode = buildAsciiQrcode;
 exports.issueTokenWithQrcode = issueTokenWithQrcode;
 exports.formatTokenIssueConsoleOutput = formatTokenIssueConsoleOutput;
-const module_1 = require("module");
+const child_process_1 = require("child_process");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const qrcode_1 = __importDefault(require("qrcode"));
 const embedded_paths_1 = require("./embedded_paths");
-const runtimeRequire = (0, module_1.createRequire)(__filename);
 const kDefaultOpenapiEntry = 'http://api-test-tirtc.tange365.com';
 const kDefaultUserTtlSeconds = 86400;
 const kDefaultChannelTtlSeconds = 300;
+const kAsciiQrBlack = '██';
+const kAsciiQrWhite = '  ';
+const kAsciiQrQuietZoneModules = 2;
 function pathExists(filePath) {
     return fs_1.default.existsSync(filePath);
 }
@@ -117,18 +120,6 @@ function resolveAddonPath(repoRoot, runtimePlatform) {
     throw new Error('credential addon missing for platform ' + runtimePlatform +
         '; run: npm --prefix app-server run build:native');
 }
-function loadCredentialBinding() {
-    const runtimePlatform = resolveRuntimePlatform();
-    const runtimeBundleRoot = resolveRuntimeBundleRoot(runtimePlatform);
-    const repoRoot = resolveRepoRoot();
-    ensureRuntimeBundleReady(runtimeBundleRoot);
-    const addonPath = resolveAddonPath(repoRoot, runtimePlatform);
-    const loaded = runtimeRequire(addonPath);
-    if (!loaded || typeof loaded.issueToken !== 'function') {
-        throw new Error('credential addon missing issueToken() export: ' + addonPath);
-    }
-    return loaded;
-}
 function normalizeIssuedToken(token) {
     const normalized = token.trim();
     if (normalized.length === 0) {
@@ -136,25 +127,68 @@ function normalizeIssuedToken(token) {
     }
     return normalized;
 }
+function buildIssueTokenHelperSource() {
+    return [
+        'const addon = require(process.env.TIRTC_CREDENTIAL_ADDON_PATH_HELPER);',
+        'const input = JSON.parse(process.env.TIRTC_CREDENTIAL_INPUT_JSON || "{}");',
+        'const originalWrite = process.stderr.write.bind(process.stderr);',
+        'process.stderr.write = ((chunk, encoding, callback) => {',
+        '  if (typeof callback === "function") {',
+        '    callback();',
+        '  }',
+        '  return true;',
+        '});',
+        'try {',
+        '  const token = addon.issueToken({',
+        '    openapiEntry: input.openapiEntry,',
+        '    accessId: input.accessId,',
+        '    secretKey: input.secretKey,',
+        '    localId: input.localId,',
+        '    peerId: input.peerId,',
+        '    userTtlSeconds: input.userTtlSeconds,',
+        '    channelTtlSeconds: input.channelTtlSeconds,',
+        '  });',
+        '  process.stdout.write(String(token).trim());',
+        '} finally {',
+        '  process.stderr.write = originalWrite;',
+        '}',
+    ].join('\n');
+}
+function issueTokenViaSubprocess(addonPath, input) {
+    const result = (0, child_process_1.spawnSync)(process.execPath, ['-e', buildIssueTokenHelperSource()], {
+        encoding: 'utf8',
+        env: {
+            ...process.env,
+            TIRTC_CREDENTIAL_ADDON_PATH_HELPER: addonPath,
+            TIRTC_CREDENTIAL_INPUT_JSON: JSON.stringify(input),
+        },
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (result.error) {
+        throw result.error;
+    }
+    if (result.status !== 0) {
+        const details = String(result.stderr || result.stdout || 'issue token subprocess failed').trim();
+        throw new Error(details || 'issue token subprocess failed');
+    }
+    return normalizeIssuedToken(String(result.stdout || ''));
+}
+function readQrModule(modules, row, column) {
+    return Boolean(modules.data[row * modules.size + column]);
+}
 async function issueToken(input) {
-    const binding = loadCredentialBinding();
-    let token;
+    const runtimePlatform = resolveRuntimePlatform();
+    const runtimeBundleRoot = resolveRuntimeBundleRoot(runtimePlatform);
+    const repoRoot = resolveRepoRoot();
+    ensureRuntimeBundleReady(runtimeBundleRoot);
+    const addonPath = resolveAddonPath(repoRoot, runtimePlatform);
     try {
-        token = binding.issueToken({
-            openapiEntry: input.openapiEntry,
-            accessId: input.accessId,
-            secretKey: input.secretKey,
-            localId: input.localId,
-            peerId: input.peerId,
-            userTtlSeconds: input.userTtlSeconds,
-            channelTtlSeconds: input.channelTtlSeconds,
-        });
+        return issueTokenViaSubprocess(addonPath, input);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         throw new Error('issue token failed: ' + message);
     }
-    return normalizeIssuedToken(token);
 }
 function buildIssuedTokenPayload(input, token) {
     return {
@@ -181,16 +215,39 @@ async function writePngQrcode(payloadJson, outputPath) {
     });
     return resolvedPath;
 }
+async function buildAsciiQrcode(payloadJson) {
+    const qr = qrcode_1.default.create(payloadJson, { errorCorrectionLevel: 'M' });
+    const quietZone = kAsciiQrWhite.repeat(kAsciiQrQuietZoneModules);
+    const fullQuietLine = quietZone + kAsciiQrWhite.repeat(qr.modules.size) + quietZone;
+    const lines = [];
+    for (let index = 0; index < kAsciiQrQuietZoneModules; index += 1) {
+        lines.push(fullQuietLine);
+    }
+    for (let row = 0; row < qr.modules.size; row += 1) {
+        let line = quietZone;
+        for (let column = 0; column < qr.modules.size; column += 1) {
+            line += readQrModule(qr.modules, row, column) ? kAsciiQrBlack : kAsciiQrWhite;
+        }
+        line += quietZone;
+        lines.push(line);
+    }
+    for (let index = 0; index < kAsciiQrQuietZoneModules; index += 1) {
+        lines.push(fullQuietLine);
+    }
+    return lines.join('\n');
+}
 async function issueTokenWithQrcode(input) {
     const token = await issueToken(input);
     const payload = buildIssuedTokenPayload(input, token);
     const payloadJson = JSON.stringify(payload);
     const qrCodePngPath = await writePngQrcode(payloadJson, buildQrCodePngPath(payload));
+    const qrCodeAscii = await buildAsciiQrcode(payloadJson);
     return {
         payload,
         payloadJson,
         token,
         qrCodePngPath,
+        qrCodeAscii,
     };
 }
 function formatTokenIssueConsoleOutput(output) {
@@ -210,6 +267,9 @@ function formatTokenIssueConsoleOutput(output) {
         'Payload JSON:',
         JSON.stringify(output.payload, null, 2),
         '',
+        'QR Code ASCII:',
+        output.qrCodeAscii,
+        '',
         'QR Code PNG:',
         output.qrCodePngPath,
     ];

package/package.json

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

package/vendor/app-server/bin/runtime/macos-arm64/include/tirtc/audio.h

@@ -209,8 +209,7 @@ TirtcError tirtc_conn_attach_audio_input(TirtcConn* connection, uint8_t stream_i
  * ::tirtc_audio_output_set_aout and any desired options before attaching it.
  *
  * If an observer is already installed, a successful attach typically reports an
- * initial IDLE state before playback begins. A successful attach also asks the
- * remote peer to start sending audio for this ::stream_id on this connection.
+ * initial IDLE state before playback begins.
  *
  * @param connection Target connection.
  * @param stream_id Remote audio stream identifier to render.
@@ -235,8 +234,7 @@ TirtcError tirtc_conn_detach_audio_input(TirtcConn* connection, uint8_t stream_i
 /**
  * @brief Detach an audio output from a connection stream.
  *
- * This call is idempotent. A successful detach also asks the remote peer to
- * stop sending audio for this ::stream_id on this connection.
+ * This call is idempotent.
  *
  * @param connection Target connection.
  * @param stream_id Stream identifier to detach.

package/vendor/app-server/bin/runtime/macos-arm64/include/tirtc/av.h

@@ -239,6 +239,8 @@ TirtcError tirtc_conn_attach_video_input(TirtcConn* connection, uint8_t stream_i
  *
  * If an observer is already installed, a successful attach typically reports an
  * initial IDLE state before decoded frames begin to render.
+ * Attach is a local bind only; it does not send a remote request for this
+ * stream.
  *
  * @param connection Target connection.
  * @param stream_id Remote video stream identifier to render.

package/vendor/app-server/bin/runtime/macos-arm64/include/tirtc/trp.h

@@ -79,6 +79,27 @@ typedef struct TirtcOptions {
   int environment;
 } TirtcOptions;
 
+/**
+ * @brief Default media send policy applied by the facade.
+ *
+ * The effective send gate still uses `connection + stream_id + media_kind` as
+ * the smallest scope. The policy only decides how those gates become open.
+ */
+typedef enum TirtcMediaSendPolicy {
+  /**
+   * @brief Keep send gates closed until the consumer explicitly opens them.
+   */
+  TIRTC_MEDIA_SEND_POLICY_ON_REQUEST = 0,
+
+  /**
+   * @brief Open send gates automatically once the accepted connection exists.
+   *
+   * When the bound input is ready, the facade may start sending without first
+   * waiting for an explicit remote request.
+   */
+  TIRTC_MEDIA_SEND_POLICY_AUTO_ON_CONNECTED = 1,
+} TirtcMediaSendPolicy;
+
 /**
  * @brief Options for starting a service-side connection listener.
  *
@@ -102,6 +123,15 @@ typedef struct TirtcConnServiceStartOptions {
    * This field is required and must be non-zero.
    */
   uint32_t max_connections;
+
+  /**
+   * @brief Service-level media send policy applied to accepted connections.
+   *
+   * This policy controls how the facade opens per-connection send gates after
+   * a connection becomes available. It does not change the underlying
+   * transport request/release primitives.
+   */
+  TirtcMediaSendPolicy media_send_policy;
 } TirtcConnServiceStartOptions;
 
 /**
@@ -199,9 +229,21 @@ typedef struct TirtcStreamMessage {
 
 /**
  * @brief Fire-and-forget command payload.
+ *
+ * Command identifiers are application-defined and must be agreed with the
+ * remote peer.
+ *
+ * The current runtime accepts application command ids in the range
+ * `[0x1000, 0x7FFF]`. Values below `0x1000` are reserved for
+ * runtime-internal commands and must not be used by consumers.
  */
 typedef struct TirtcConnCommand {
-  /** @brief Application-defined command identifier. */
+  /**
+   * @brief Application-defined command identifier agreed with the remote peer.
+   *
+   * A request and its reply typically reuse the same ::command_id, while the
+   * per-request correlation is carried separately by ::remote_request_id.
+   */
   uint16_t command_id;
 
   /** @brief Payload bytes, or NULL when ::length is zero. */
@@ -213,9 +255,21 @@ typedef struct TirtcConnCommand {
 
 /**
  * @brief Request payload for an asynchronous command round-trip.
+ *
+ * Command identifiers are application-defined and must be agreed with the
+ * remote peer.
+ *
+ * The current runtime accepts application command ids in the range
+ * `[0x1000, 0x7FFF]`. Values below `0x1000` are reserved for
+ * runtime-internal commands and must not be used by consumers.
  */
 typedef struct TirtcConnCommandRequest {
-  /** @brief Application-defined command identifier. */
+  /**
+   * @brief Application-defined command identifier agreed with the remote peer.
+   *
+   * In the common request-response pattern, the responder echoes the same
+   * ::command_id back in ::TirtcConnCommandResponse.
+   */
   uint16_t command_id;
 
   /** @brief Payload bytes, or NULL when ::length is zero. */
@@ -235,9 +289,20 @@ typedef struct TirtcConnCommandRequest {
 
 /**
  * @brief Response payload returned by a remote peer or local reply logic.
+ *
+ * Command identifiers are application-defined and must be agreed with the
+ * remote peer.
+ *
+ * The current runtime accepts application command ids in the range
+ * `[0x1000, 0x7FFF]`. Values below `0x1000` are reserved for
+ * runtime-internal commands and must not be used by consumers.
  */
 typedef struct TirtcConnCommandResponse {
-  /** @brief Application-defined command identifier. */
+  /**
+   * @brief Application-defined command identifier agreed with the remote peer.
+   *
+   * This usually matches the original request's ::command_id.
+   */
   uint16_t command_id;
 
   /** @brief Payload bytes, or NULL when ::length is zero. */
@@ -490,6 +555,11 @@ TirtcError tirtc_conn_send_stream_message(TirtcConn* connection, uint8_t stream_
 /**
  * @brief Send an application-defined command without waiting for a response.
  *
+ * Choose ::TirtcConnCommand.command_id from the command ids agreed with the
+ * remote peer. The current runtime accepts application command ids in
+ * `[0x1000, 0x7FFF]`; values below `0x1000` are reserved for
+ * runtime-internal commands.
+ *
  * @param connection Target connection.
  * @param command Non-NULL command payload.
  * @return ::TIRTC_ERROR_OK on success.
@@ -500,6 +570,11 @@ TirtcError tirtc_conn_send_command(TirtcConn* connection, const TirtcConnCommand
  * @brief Send an application-defined request command and complete it
  * asynchronously.
  *
+ * Choose ::TirtcConnCommandRequest.command_id from the command ids agreed
+ * with the remote peer. The current runtime accepts application command
+ * ids in `[0x1000, 0x7FFF]`; values below `0x1000` are reserved for
+ * runtime-internal commands.
+ *
  * Callback delivery is mixed synchronous/asynchronous. If request submission
  * fails immediately after the facade has accepted the request, ::callback may
  * run before this function returns. After request submission succeeds,
@@ -521,7 +596,8 @@ TirtcError tirtc_conn_request_command(TirtcConn* connection, const TirtcConnComm
 /**
  * @brief Reply to an inbound remote command request.
  *
- * Use the ::remote_request_id delivered by
+ * In the common request-response pattern, ::TirtcConnCommandResponse.command_id
+ * matches the inbound request's ::command_id. Use the ::remote_request_id delivered by
  * ::TirtcConnObserver.on_remote_command_request on the same connection. If the
  * request is no longer pending, this function returns a not-ready error.
  * In the normal case, reply at most once for each delivered request id.

package/vendor/app-server/bin/runtime/macos-arm64/manifest.txt

@@ -1,8 +1,8 @@
 platform=macos-arm64
-staged_at_utc=2026-04-09T05:31:28Z
+staged_at_utc=2026-04-09T05:56:18Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-58cbe872af5a68a1f5832912ab9deb7ef5af1ac5d19439b523ce6619978214c0  include/tirtc/audio.h
+dcca0b7ab8055d84e5bcfab7f1dde56df9037c40ddb99e9ca924ef2e867d8309  include/tirtc/audio.h
 6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
 7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
 84f1bbe67efa15ab3b2d995d661025aac43e2fe547a14a012a24d89cfe3cb859  include/tirtc/audio_io.h
@@ -12,7 +12,7 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 51cbc911fe9f9834046f0e0a1a7cdd814a8e194a615894a8b4d11f9e5f095610  include/tirtc/audio_io_windows.h
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
-64d0005d726ed7d29e6c5a9c7bc25e931693ba8fa4ab6af8d21e7adc8767f66e  include/tirtc/av.h
+59b7df33fdc2ad92b3142299ffab832443179ef895784ad51a2f6544c5b02766  include/tirtc/av.h
 4198c95c48ae579d1c782635b00fa5c9009d0c56ba466e6e3873e8298faae029  include/tirtc/credential.h
 92da1614c1cbc22d5ba7c1aefd3bbfba88be4a698d1b9990f470fe959ddd84ba  include/tirtc/error.h
 ae805545a9515edc9b94262e72ad2c7b7d649288166f4daeb450d8a55e82ae0b  include/tirtc/foundation/build_info.h
@@ -25,7 +25,7 @@ ae805545a9515edc9b94262e72ad2c7b7d649288166f4daeb450d8a55e82ae0b  include/tirtc/
 a4f8ab44c1a20ad37f250363a403a9d4d007e61ddb2426c7966dbc05f6a04b4f  include/tirtc/media_live_source.h
 1b3be6954e547f91a047866438bff1820c8406afaf91cef68ddee29a6ac70234  include/tirtc/media_uplink.h
 1e12daf9c5fc2e2f848444688081c9be0cb738245f0155327e8003b49308058f  include/tirtc/transport.h
-f836768a4dd8b8595bd53cd96cca98bb56e802dd3ee3e520b18546d999908928  include/tirtc/trp.h
+99b4b31b8359009ee74f0f2a52be6473d9c6c37b184e53eeb554d4bf61f6ee33  include/tirtc/trp.h
 dff5b0a0ac4a40ad17c93e1e56b3c416371c81ab365e287ea8cd6ce37ccbed3b  include/tirtc/video_codec.h
 e51379666c199588cc33279ccf52248035d1cae3d1d468b1615ebf29f0b39c9c  include/tirtc/video_frame.h
 d920afad955b9f206b02b19ca152315190fa84ab6f24e895a5b24c3ab9ffd701  include/tirtc/video_io.h
@@ -36,14 +36,14 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-e96e6d57ff90f3cb34d98d69036987c4d4839c48094168261fbe776a524185a1  lib/libmatrix_runtime_audio.a
-8255fc3eb34a44c5ee5cd6f1ca88d06392527fbe91d492692152eb719fda9887  lib/libmatrix_runtime_credential.a
-467c2440813c73211dd71775d7a49fdeb785975c998ab1c7268e967c07650399  lib/libmatrix_runtime_facade.a
-9499a182dde5cd3cd908ddd2d44b1d6b2cd884bd5041379f2d1144cbb49297b3  lib/libmatrix_runtime_foundation_http.a
-79aba2a4f43ca5f4aca9187d07c656b6696e9b644bf678418ed2e79ed718ce2e  lib/libmatrix_runtime_foundation_logging.a
-99ae6ebbe3f3faa3b9591e049691842cef8bdbc3fd6f1e0cb82c7f9acb7ac85e  lib/libmatrix_runtime_media.a
-a9cba88ca9db63c2712b3e0088c8525e55763ce62836b238b042bb0514b0f669  lib/libmatrix_runtime_transport.a
-86845113a79fa1c7503b17bcf44cff061b5491127d38995206c2afce59aa4560  lib/libmatrix_runtime_video.a
+6ad596f3ad055be11f121f418aeff4e02c650f3cec6b37c471ed54e9498a1268  lib/libmatrix_runtime_audio.a
+42d1a2e4aa59d53c0c35ad204a365b7d7d83698c21857f5ffe7421da240da3e1  lib/libmatrix_runtime_credential.a
+2153ac1352ebb401f7920e8358c4988f9bd7f5275009ab94f6c4b7d7eb2a71c3  lib/libmatrix_runtime_facade.a
+25d70d18d4b69e0f28514035811a4ae8e18a1dcbcdd88d6a68e3d7609e2537bb  lib/libmatrix_runtime_foundation_http.a
+78b82c288d2e58f1219d5f56772a1dc8683e8da5f2f4724c160e6bf97f9ddadc  lib/libmatrix_runtime_foundation_logging.a
+548230c283e262838d2492ae28817870cd191eb3b9cb3e943446645562a2e20f  lib/libmatrix_runtime_media.a
+e5afb3d24fd62ad5f4fd68ea7ba65957e79bf27d5669a8d6bceb44aa9f297c16  lib/libmatrix_runtime_transport.a
+e0a087c9d0b0c929a20677db1aa8e053813baa3682458f407f04dc751d0d225a  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 dc3e0e6ded26e90fd59c166933a5289d57f4cf25fbe6246b6b83c86fe898e63d  lib/libwebrtc_apm.a