@cc-livekit/ttsignal 1.0.6 → 1.0.8

package/index.js

@@ -1,91 +1,33 @@
-"use strict";
-
 /*******************************************************************************
  * javascript glue wrapper of ttsignal module
  * @module index.js
- * @author antoniozhou.
- ******************************************************************************/
-
-// var util = require('util');
-const EventEmitter = require("events").EventEmitter;
-const fs = require("fs");
-const path = require("path");
-const Module = require("module");
-
-const PLATFORM = process.platform;
-const ARCH = process.arch;
-const ADDON_BASENAME = `ttsignal.${PLATFORM}.${ARCH}.node`;
-
-function expandAsar(candidate) {
-  if (!candidate) return candidate;
-  const idx = candidate.indexOf(".asar/");
-  if (idx === -1) return candidate;
-  return candidate.replace(".asar/", ".asar.unpacked/");
-}
+ * @author anto.
+*******************************************************************************/
 
-function resolveAddonPath() {
-  const candidates = [];
-  if (process.env.TTSIGNAL_NATIVE_PATH) {
-    candidates.push(process.env.TTSIGNAL_NATIVE_PATH);
-  }
-
-  const baseDir = __dirname;
-  const searchRoots = [
-    path.join(baseDir, "build", "Release"),
-    path.join(baseDir, "dist", "build", "Release"),
-    path.join(baseDir, "..", "build", "Release"),
-    path.join(baseDir, "..", "dist", "build", "Release"),
-  ];
-
-  for (const root of searchRoots) {
-    candidates.push(path.join(root, ADDON_BASENAME));
-  }
-
-  const unique = [...new Set(candidates.filter(Boolean))];
-
-  for (const candidate of unique) {
-    if (fs.existsSync(candidate)) {
-      return candidate;
-    }
-    const unpacked = expandAsar(candidate);
-    if (unpacked !== candidate && fs.existsSync(unpacked)) {
-      return unpacked;
-    }
-  }
-
-  const tried = unique.concat(unique.map(expandAsar)).filter(Boolean);
-  throw new Error(
-    `Unable to locate ttsignal native addon (${PLATFORM}/${ARCH}). Tried: ${tried.join(
-      ", "
-    )}`
-  );
-}
+var util			= require('util');
+var EventEmitter    = require('events').EventEmitter;
 
-function loadNativeAddon() {
-  const createRequire =
-    Module.createRequire ||
-    Module.createRequireFromPath ||
-    require("module").createRequire;
-  const req = createRequire(__filename);
-  const addonPath = resolveAddonPath();
-  return req(addonPath);
-}
+var ttsignal             = null;
 
-const ttsignal = loadNativeAddon();
+if (process.ttsBuildType == 'debug') {
+    ttsignal = require('./Debug/ttsignal.'+process.platform+'.'+process.arch+'.node');
+} else {
+    ttsignal = require('./Release/ttsignal.'+process.platform+'.'+process.arch+'.node');
+}
 
 const CONST = {
-  TTS_TYPE_COMMAND: 0x01,
-  TTS_TYPE_MESSAGE: 0x02,
-  TTS_TYPE_USER_CONTROL: 0x03,
-  TTS_CC_BBR: 0x62,
-  TTS_CC_BBR2: 0x42,
-  TTS_CC_CUBIC: 0x63,
-  TTS_CC_RENO: 0x72,
-  LOG_LEVEL_DEBUG: 0x01,
-  LOG_LEVEL_INFO: 0x02,
-  LOG_LEVEL_WARN: 0x03,
-  LOG_LEVEL_ERROR: 0x04,
-  LOG_LEVEL_FATAL: 0x05,
+    TTS_TYPE_COMMAND			: 0x01,
+    TTS_TYPE_MESSAGE			: 0x02,
+    TTS_TYPE_USER_CONTROL		: 0x03,
+    TTS_CC_BBR                  : 0x62,
+    TTS_CC_BBR2                 : 0x42,
+    TTS_CC_CUBIC                : 0x63,
+    TTS_CC_RENO                 : 0x72,
+    LOG_LEVEL_DEBUG             : 0x01,
+    LOG_LEVEL_INFO              : 0x02,
+    LOG_LEVEL_WARN              : 0x03,
+    LOG_LEVEL_ERROR             : 0x04,
+    LOG_LEVEL_FATAL             : 0x05
 };
 
 //*******************************************************************************
@@ -93,47 +35,45 @@ const CONST = {
 //*******************************************************************************
 
 function copyProperties(target, source) {
-  for (var k in source) {
-    if (source.hasOwnProperty(k)) {
-      target[k] = source[k];
+    for (var k in source){
+        if (source.hasOwnProperty(k)) {
+            target[k] = source[k];
+        }
     }
-  }
 }
 copyProperties(ttsignal, CONST);
 
 function inherits(target, source) {
-  for (var k in source.prototype) target.prototype[k] = source.prototype[k];
+  for (var k in source.prototype)
+    target.prototype[k] = source.prototype[k];
 }
 inherits(ttsignal.Connector, EventEmitter);
 inherits(ttsignal.Connection, EventEmitter);
 inherits(ttsignal.Server, EventEmitter);
 inherits(ttsignal.ServerConnection, EventEmitter);
 
+
 /*******************************************************************************
- * @class ttsignal.Connector
- *******************************************************************************/
+* @class ttsignal.Connector
+*******************************************************************************/
 
 /**
  * @method _internalCallback
  * @private
- *
- *
+ * 
+ * 
  **/
-ttsignal.Connector.prototype._internalCallback = function (
-  type,
-  __arg2,
-  __arg3
-) {
-  switch (type) {
-    case "close":
-      this.emit("close");
-      break;
-  }
-};
+ttsignal.Connector.prototype._internalCallback = function(type, __arg2, __arg3){
+    switch(type){
+        case 'close':
+            this.emit('close');
+            break;
+    }
+}
 
 /**
  * 为特定事件添加一个监听处理程序.
- * 当前支持除'_error/_result/onStatus/error/close'等事件之外的
+ * 当前支持除'_error/_result/onStatus/error/close'等事件之外的 
  * 任何自定义事件.上述事件为内部保留事件，用户不应定义与这些事件同名的
  * 远程调用函数名。与用户自定义事件相对应的事件处理函数的参数列表与远端
  * 调用时传入的参数列表一致。
@@ -184,17 +124,17 @@ ttsignal.Connector.prototype._internalCallback = function (
  * @example
  *     press.createConnection(config);
  **/
-ttsignal.Connector.prototype.createConnection = function (config) {
-  if (typeof config != "object") {
-    throw Error("Invalid args value.");
-  }
-  var default_config = {
-    c_cong_ctl: CONST.TTS_CC_BBR2,
-  };
-  copyProperties(default_config, config);
-  let conn = this.__createConnection__(default_config);
-  return conn;
-};
+ttsignal.Connector.prototype.createConnection = function(config){
+    if (typeof(config) != 'object'){
+        throw Error('Invalid args value.');
+    }
+    var default_config = {
+        c_cong_ctl : CONST.TTS_CC_BBR2
+    }
+    copyProperties(default_config, config);
+    let conn = this.__createConnection__(default_config);
+    return conn;
+}
 
 /**
  * 关闭。
@@ -205,73 +145,84 @@ ttsignal.Connector.prototype.createConnection = function (config) {
  * @example
  *     connector.close();
  **/
-ttsignal.Connector.prototype.close = function () {
-  this.__close__();
-};
+ttsignal.Connector.prototype.close = function(){
+    this.__close__();
+}
+
 
 /*******************************************************************************
- * @class ttsignal.Connection
- *******************************************************************************/
+* @class ttsignal.Connection
+*******************************************************************************/
 
 /**
  * @method _internalCallback
  * @private
- *
- *
+ * 
+ * 
  **/
-ttsignal.Connection.prototype._internalCallback = function (
-  type,
-  __arg2,
-  __arg3
-) {
-  let self = this;
-  switch (type) {
-    case "handshakeFinished":
-      this.streams = {};
-      this.emit("handshakeFinished");
-      break;
-    case "streamCreated":
-      if (this.streams.hasOwnProperty(__arg2)) {
-        break;
-      }
-      var stream = new ttsignal.Stream(this, __arg2);
-      this.streams[__arg2] = stream;
-      this.emit("streamCreated", stream);
-      break;
-    case "streamClosed":
-      if (!this.streams.hasOwnProperty(__arg2)) {
-        break;
-      }
-      var stream = this.streams[__arg2];
-      delete this.streams[__arg2];
-      stream.onClose();
-      break;
-    case "command":
-      if (!this.streams.hasOwnProperty(__arg2)) {
-        break;
-      }
-      var stream = this.streams[__arg2];
-      stream.onCommand(__arg3);
-      break;
-    case "data":
-      if (!this.streams.hasOwnProperty(__arg2)) {
-        break;
-      }
-      var stream = this.streams[__arg2];
-      stream.onData(__arg3);
-      break;
-    case "restart":
-      this.emit("restart", __arg2, __arg3);
-      break;
-    case "close":
-      this.emit("close", __arg2);
-      break;
-  }
-};
+ttsignal.Connection.prototype._internalCallback = function(type, __arg2, __arg3, __arg4, __arg5){
+    let self = this;
+    switch(type){
+        case 'handshakeFinished':
+            this.streams = {};
+            this.emit('handshakeFinished');
+            break;
+        case 'streamCreated':
+            if (this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = new ttsignal.Stream(this, __arg2);
+            this.streams[__arg2] = stream;
+            this.emit('streamCreated', stream);
+            break;
+        case 'streamClosed':
+            if (!this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = this.streams[__arg2];
+            delete this.streams[__arg2];
+            stream.onClose();
+            break;
+        case 'streamDataAcked':
+            if (!this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = this.streams[__arg2];
+            stream.onDataAcked(__arg3, __arg4, __arg5);
+            break;
+        case 'streamDataSent':
+            if (!this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = this.streams[__arg2];
+            stream.onDataSent(__arg3, __arg4);
+            break;
+        case 'command':
+            if (!this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = this.streams[__arg2];
+            stream.onCommand(__arg3);
+            break;
+        case 'data':
+            if (!this.streams.hasOwnProperty(__arg2)) {
+                break;
+            }
+            var stream = this.streams[__arg2];
+            stream.onData(__arg3, __arg4);
+            break;
+        case 'restart':
+            this.emit('restart', __arg2, __arg3);
+            break;
+        case 'close':
+            this.emit('close', __arg2);
+            break;
+    }
+}
 
 /**
  * 为特定事件添加一个监听处理程序.
- * 当前支持除'_error/_result/onStatus/error/close'等事件之外的
+ * 当前支持除'_error/_result/onStatus/error/close'等事件之外的 
  * 任何自定义事件.上述事件为内部保留事件，用户不应定义与这些事件同名的
  * 远程调用函数名。与用户自定义事件相对应的事件处理函数的参数列表与远端
  * 调用时传入的参数列表一致。
@@ -336,31 +287,26 @@ ttsignal.Connection.prototype._internalCallback = function (
  *         console.log(result);
  *     });
  **/
-ttsignal.Connection.prototype.connect = function (
-  url,
-  args,
-  timeoutInMs,
-  callback
-) {
-  if (typeof url != "string") {
-    throw Error("Invalid url value.");
-  }
-  if (typeof callback != "function") {
-    throw Error("Invalid callback value.");
-  }
-  this.__connect__(url, JSON.stringify(args), timeoutInMs, (err, response) => {
-    if (typeof response == "string") {
-      try {
-        props = JSON.parse(response);
-        callback(err, props);
-      } catch (e) {
-        callback(err, response);
-      }
-    } else {
-      callback(err, null);
+ttsignal.Connection.prototype.connect = function(url, args, timeoutInMs, callback){
+    if (typeof(url) != 'string'){
+        throw Error('Invalid url value.');
     }
-  });
-};
+    if (typeof(callback) != 'function'){
+        throw Error('Invalid callback value.');
+    }
+    this.__connect__(url, JSON.stringify(args), timeoutInMs, (err, response)=>{
+        if (typeof response == 'string') {
+            try {
+                props = JSON.parse(response);
+                callback(err, props);
+            } catch (e) {
+                callback(err, response);
+            }
+        } else {
+            callback(err, null);
+        }
+    });
+}
 
 /**
  * 重新创建底层socket。
@@ -371,9 +317,9 @@ ttsignal.Connection.prototype.connect = function (
  * @example
  *     conn.restart();
  **/
-ttsignal.Connection.prototype.restart = function () {
-  this.__restart__();
-};
+ttsignal.Connection.prototype.restart = function(){
+    this.__restart__();
+}
 
 /**
  * 关闭。
@@ -384,175 +330,345 @@ ttsignal.Connection.prototype.restart = function () {
  * @example
  *     conn.close();
  **/
-ttsignal.Connection.prototype.close = function () {
-  this.__close__();
-};
+ttsignal.Connection.prototype.close = function(){
+    this.__close__();
+}
 
 /*******************************************************************************
- * @class ttsignal.Stream
- *******************************************************************************/
-
-class Stream extends EventEmitter {
-  constructor(conn, streamId) {
-    super();
-    this.conn = conn;
-    this.streamId = streamId;
-    this.nextTransId = 2;
-    this.stubs = {};
-  }
-
-  onCommand(cmdStr) {
-    let self = this;
-    try {
-      cmd = JSON.parse(cmdStr);
-      if (typeof cmd != "object") {
-        throw Error("Invalid command value." + __arg2);
-      }
-      if (!cmd.hasOwnProperty("name")) {
-        throw Error(
-          'Invalid command value, MUST have "name" property.' + __arg2
-        );
-      }
-      if (cmd.name == "_error" || cmd.name == "_result") {
-        if (self.stubs.hasOwnProperty(cmd.transId)) {
-          self.stubs[cmd.transId](cmd);
-          delete self.stubs[cmd.transId];
+* @class ttsignal.Stream
+*******************************************************************************/
+
+class Stream extends EventEmitter { 
+    constructor(conn, streamId){
+        super();
+        this.conn = conn;
+        this.streamId = streamId;
+        this.nextTransId = 2;
+        this.stubs = {};
+        this.dataStreams = {};
+    }
+    onCommand(cmdStr){ 
+        let self = this;
+        try {
+            let cmd = JSON.parse(cmdStr)
+            if (typeof(cmd) != 'object') {
+                throw Error('Invalid command value.' + __arg2);
+            }
+            if (!cmd.hasOwnProperty('name')){
+                throw Error('Invalid command value, MUST have "name" property.' + __arg2);
+            }
+            if (cmd.name == '_error' || cmd.name == '_result' || cmd.name == 'onStatus'){
+                if (self.stubs.hasOwnProperty(cmd.transId)) {
+                    self.stubs[cmd.transId](cmd);
+                    let keepStub = cmd.name == 'onStatus'
+                    if (!keepStub) {
+                        delete self.stubs[cmd.transId];
+                    }
+                }
+            } else {
+                if (cmd.hasOwnProperty('transId')) {
+                    cmd.echoResult = function(result){
+                        self.sendCommand({
+                            name: '_result',
+                            transId: cmd.transId,
+                            result: result
+                        });
+                    }
+                    cmd.echoError = function(error){
+                        self.sendCommand({
+                            name: '_error',
+                            transId: cmd.transId,
+                            error: error
+                        });
+                    }
+                } else {
+                    cmd.echoResult = ()=>{};
+                    cmd.echoError = ()=>{};
+                }
+                self.emit(cmd.name, cmd);
+            }
+        } catch (error) {
+            console.error('parse command failed', error);
+            return;
         }
-      } else {
-        if (cmd.hasOwnProperty("transId")) {
-          cmd.echoResult = function (result) {
-            self.sendCommand({
-              name: "_result",
-              transId: cmd.transId,
-              result: result,
-            });
-          };
-          cmd.echoError = function (error) {
-            self.sendCommand({
-              name: "_error",
-              transId: cmd.transId,
-              error: error,
-            });
-          };
-        } else {
-          cmd.echoResult = () => {};
-          cmd.echoError = () => {};
+    }
+    onData(data, transId){ 
+        if (transId && this.dataStreams.hasOwnProperty(transId)) {
+            let ds = this.dataStreams[transId];
+            if (data.length === 0) {
+                delete this.dataStreams[transId];
+                ds.emit('end');
+            } else {
+                ds.emit('data', data);
+            }
+            return;
         }
-        self.emit(cmd.name, cmd);
-      }
-    } catch (error) {
-      console.error("parse command failed", error);
-      return;
+        this.emit('data', data);
     }
-  }
-
-  onData(data) {
-    this.emit("data", data);
-  }
-
-  onClose() {
-    this.emit("close");
-  }
-
-  /**
-   * 发送命令.
-   *
-   * @method sendCommand
-   * @public
-   * @param timestamp {Number} timestamp.
-   * @param cmd {Buffer} commnd to send.
-   * @example
-   *     conn.sendCommand(cmd);
-   **/
-  sendCommand(cmd, callback) {
-    if (typeof cmd != "object") {
-      throw Error("Invalid command value.");
+
+    onClose(){ 
+        for (let tid in this.dataStreams) {
+            this.dataStreams[tid].emit('end');
+        }
+        this.dataStreams = {};
+        this.emit('close');
     }
-    if (!cmd.hasOwnProperty("name")) {
-      throw Error('Invalid command value, MUST have "name" property.');
+
+    /** QUIC 发送侧：数据确认回调；emit `dataAcked`(ackDelayTimeµs, ackedBytes, inflightBytes)。 */
+    onDataAcked(ackDelayTime, ackedBytes, inflightBytes){
+        this.emit('dataAcked', ackDelayTime, ackedBytes, inflightBytes);
     }
-    if (typeof callback === "function") {
-      cmd.transId = this.nextTransId++;
-      this.stubs[cmd.transId] = callback;
+
+    /** QUIC 发送侧：数据已从待发队列写入传输；emit `dataSent`(nTransId, size)。putFile 返回的 ws 仅转发本 transId 为 `dataSent`(size)。 */
+    onDataSent(nTransId, size){
+        this.emit('dataSent', nTransId, size);
     }
-    let msg = JSON.stringify(cmd);
-    let buf = Buffer.from(msg, "utf8");
-    this.conn.__sendPacket__(
-      CONST.TTS_TYPE_COMMAND,
-      new Date().getTime(),
-      0,
-      this.streamId,
-      buf
-    );
-  }
-
-  /**
-   * 发送数据.
-   *
-   * @method sendData
-   * @public
-   * @param timestamp {Number} timestamp.
-   * @param data {Buffer} data to send.
-   * @example
-   *     conn.sendData(data);
-   **/
-  sendData(data) {
-    if (data instanceof Buffer == false) {
-      throw Error("Invalid data type, MUST be Buffer.");
+
+    /**
+     * 发送命令.
+     *
+     * @method sendCommand
+     * @public
+     * @param cmd {Object} command to send.
+     * @param callback {Function} callback function.
+     * @example
+     *     conn.sendCommand(cmd);
+     **/
+    sendCommand(cmd, callback){
+        if (typeof(cmd) != 'object') {
+            throw Error('Invalid command value.');
+        }
+        if (!cmd.hasOwnProperty('name')){
+            throw Error('Invalid command value, MUST have "name" property.');
+        }
+        if (typeof callback === 'function') {
+            cmd.transId = this.nextTransId++;
+            this.stubs[cmd.transId] = callback;
+        }
+        let msg = JSON.stringify(cmd);
+        let buf = Buffer.from(msg, 'utf8');
+        this.conn.__sendPacket__(CONST.TTS_TYPE_COMMAND, (new Date).getTime(), 
+            cmd.transId, this.streamId, buf);
+    }
+
+    /**
+     * 发送数据.
+     *
+     * @method sendData
+     * @public
+     * @param timestamp {Number} timestamp.
+     * @param data {Buffer} data to send.
+     * @example
+     *     conn.sendData(data);
+     **/
+    sendData(data){
+        if (data instanceof Buffer == false) {
+            throw Error('Invalid data type, MUST be Buffer.');
+        }
+        this.conn.__sendPacket__(CONST.TTS_TYPE_MESSAGE, (new Date).getTime(), 
+            0, this.streamId, data);
+    }
+
+    /**
+     * 请求文件（数据流下载）。
+     *
+     * @method getFile
+     * @public
+     * @param req {Object} 请求参数，如 {path:"index.html"}
+     * @param callback {Function} 命令响应回调，透传给底层 __sendPacket__
+     * @return {EventEmitter} 数据流对象，支持 'data' 和 'end' 事件
+     * @example
+     *     let ds = stream.getFile({path:"index.html"}, (cmd)=>{
+     *         console.log('response:', cmd);
+     *     });
+     *     ds.on('data', (chunk) => { ... });
+     *     ds.on('end', () => { ... });
+     **/
+    getFile(args, callback){
+        if (typeof(args) != 'object') {
+            throw Error('Invalid request value.');
+        }
+        if (!args.hasOwnProperty('path')) {
+            throw Error('Invalid request value, MUST have "path" property.');
+        }
+        args.method = 'GET';
+        let req = {
+            name: 'staticFile',
+            props: args
+        };
+        let self = this;
+        let transId = this.nextTransId++;
+        req.transId = transId;
+        if (typeof callback === 'function') {
+            this.stubs[transId] = callback;
+        }
+        let ds = new EventEmitter();
+        ds.once('end', () => { delete self.dataStreams[transId]; });
+        this.dataStreams[transId] = ds;
+        let msg = JSON.stringify(req);
+        let buf = Buffer.from(msg, 'utf8');
+        this.conn.__sendPacket__(CONST.TTS_TYPE_COMMAND, (new Date).getTime(),
+            transId, this.streamId, buf);
+        return ds;
+    }
+
+    /**
+     * 上传文件（数据流上传）。
+     *
+     * @method putFile
+     * @public
+     * @param req {Object} 请求参数，如 {path:"upload.bin"}
+     * @param callback {Function} 命令响应回调
+     * @return {events.EventEmitter} 写入流：write(data)、end()，并可 on('dataSent', (size)=>{})（仅本 putFile 事务）。
+     * @example
+     *     let ws = stream.putFile({path:"upload.bin"}, (cmd)=>{
+     *         console.log('response:', cmd);
+     *     });
+     *     ws.on('dataSent', (size) => {});
+     *     ws.write(chunk1);
+     *     ws.write(chunk2);
+     *     ws.end();
+     **/
+    putFile(args, callback){
+        if (typeof(args) != 'object') {
+            throw Error('Invalid request value.');
+        }
+        if (!args.hasOwnProperty('path')) {
+            throw Error('Invalid request value, MUST have "path" property.');
+        }
+        if (!args.hasOwnProperty('size')) {
+            throw Error('Invalid request value, MUST have "path" property.');
+        }
+        args.method = 'PUT';
+        let req = {
+            name: 'staticFile',
+            props: args
+        };
+        let self = this;
+        let transId = this.nextTransId++;
+        req.transId = transId;
+        if (typeof callback === 'function') {
+            this.stubs[transId] = callback;
+        }
+        let msg = JSON.stringify(req);
+        let buf = Buffer.from(msg, 'utf8');
+        this.conn.__sendPacket__(CONST.TTS_TYPE_COMMAND, (new Date).getTime(),
+            transId, this.streamId, buf);
+        let ended = false;
+        let ws = new EventEmitter();
+        let onDataSent = (nTransId, size) => {
+            if (nTransId == transId) {
+                ws.emit('dataSent', size);
+            }
+        }
+        this.on('dataSent', onDataSent);
+        ws.write = (data) => {
+            if (ended) {
+                throw Error('Write after end.');
+            }
+            if (data instanceof Buffer == false) {
+                throw Error('Invalid data type, MUST be Buffer.');
+            }
+            self.conn.__sendPacket__(CONST.TTS_TYPE_MESSAGE, (new Date).getTime(),
+                transId, self.streamId, data);
+        }
+        ws.end = () => {
+            if (ended) return;
+            ended = true;
+            self.conn.__sendPacket__(CONST.TTS_TYPE_MESSAGE, (new Date).getTime(),
+                transId, self.streamId, Buffer.alloc(0));
+            self.removeListener('dataSent', onDataSent);
+        }
+        return ws;
+    }
+
+    /**
+     * 请求文件（数据流下载）。
+     *
+     * @method getLogFile
+     * @public
+     * @param req {Object} 请求参数，如 {path:"room_name"}
+     * @param callback {Function} 命令响应回调，透传给底层 __sendPacket__
+     * @return {EventEmitter} 数据流对象，支持 'data' 和 'end' 事件
+     * @example
+     *     let ds = stream.getLogFile({path:"room_name"}, (cmd)=>{
+     *         console.log('response:', cmd);
+     *     });
+     *     ds.on('data', (chunk) => { ... });
+     *     ds.on('end', () => { ... });
+     **/
+    getLogFile(args, callback){
+        if (typeof(args) != 'object') {
+            throw Error('Invalid request value.');
+        }
+        if (!args.hasOwnProperty('roomId')) {
+            throw Error('Invalid request value, MUST have "roomId" property.');
+        }
+        args.method = 'GET';
+        let req = {
+            name: 'logFile',
+            props: args
+        };
+        let self = this;
+        let transId = this.nextTransId++;
+        req.transId = transId;
+        if (typeof callback === 'function') {
+            this.stubs[transId] = callback;
+        }
+        let ds = new EventEmitter();
+        ds.once('end', () => { delete self.dataStreams[transId]; });
+        this.dataStreams[transId] = ds;
+        let msg = JSON.stringify(req);
+        let buf = Buffer.from(msg, 'utf8');
+        this.conn.__sendPacket__(CONST.TTS_TYPE_COMMAND, (new Date).getTime(),
+            transId, this.streamId, buf);
+        return ds;
+    }
+
+    /**
+     * 关闭。
+     *
+     * @method close
+     * @public
+     * @sync
+     * @example
+     *     conn.close();
+     **/
+    close(){
+        this.conn.__closeStream__(this.streamId);
     }
-    this.conn.__sendPacket__(
-      CONST.TTS_TYPE_MESSAGE,
-      new Date().getTime(),
-      0,
-      this.streamId,
-      data
-    );
-  }
-
-  /**
-   * 关闭。
-   *
-   * @method close
-   * @public
-   * @sync
-   * @example
-   *     conn.close();
-   **/
-  close() {
-    this.conn.__closeStream__(this.streamId);
-  }
 }
 ttsignal.Stream = Stream;
 
 /*******************************************************************************
- * @class ttsignal.Server
- *******************************************************************************/
+* @class ttsignal.Server
+*******************************************************************************/
 
 /**
  * @method _internalCallback
  * @private
- *
- *
+ * 
+ * 
  **/
-ttsignal.Server.prototype._internalCallback = function (type, __arg2, __arg3) {
-  switch (type) {
-    case "connection":
-      if (__arg2 instanceof ttsignal.ServerConnection) {
-        let conn = __arg2;
-        conn.nextTransId = 2;
-        conn.stubs = {};
-        this.emit("connection", conn);
-      }
-      break;
-    case "close":
-      this.emit("close");
-      break;
-  }
-};
+ttsignal.Server.prototype._internalCallback = function(type, __arg2, __arg3){
+    switch(type){
+        case 'connection':
+            if (__arg2 instanceof ttsignal.ServerConnection) {
+                let conn = __arg2;
+                conn.nextTransId = 2;
+                conn.stubs = {};
+                this.emit('connection', conn);
+            }
+            break;
+        case 'close':
+            this.emit('close');
+            break;
+    }
+}
 
 /**
  * 为特定事件添加一个监听处理程序.
- * 当前支持除'_error/_result/onStatus/error/close'等事件之外的
+ * 当前支持除'_error/_result/onStatus/error/close'等事件之外的 
  * 任何自定义事件.上述事件为内部保留事件，用户不应定义与这些事件同名的
  * 远程调用函数名。与用户自定义事件相对应的事件处理函数的参数列表与远端
  * 调用时传入的参数列表一致。
@@ -603,9 +719,9 @@ ttsignal.Server.prototype._internalCallback = function (type, __arg2, __arg3) {
  * @example
  *     connector.start();
  **/
-ttsignal.Server.prototype.start = function () {
-  this.__start__();
-};
+ttsignal.Server.prototype.start = function(){
+    this.__start__();
+}
 
 /**
  * 关闭服务器。
@@ -616,93 +732,88 @@ ttsignal.Server.prototype.start = function () {
  * @example
  *     connector.close();
  **/
-ttsignal.Server.prototype.close = function () {
-  this.__close__();
-};
+ttsignal.Server.prototype.close = function(){
+    this.__close__();
+}
+
 
 /*******************************************************************************
- * @class ttsignal.ServerConnection
- *******************************************************************************/
+* @class ttsignal.ServerConnection
+*******************************************************************************/
 
 /**
  * @method _internalCallback
  * @private
- *
- *
+ * 
+ * 
  **/
-ttsignal.ServerConnection.prototype._internalCallback = function (
-  type,
-  __arg2,
-  __arg3
-) {
-  var self = this;
-  switch (type) {
-    case "handshakeFinished":
-      this.emit("handshakeFinished");
-      break;
-    case "connect":
-      try {
-        props = JSON.parse(__arg2);
-        this.emit("connect", props);
-      } catch (e) {
-        this.emit("connect", e);
-      }
-      break;
-    case "command":
-      try {
-        cmd = JSON.parse(__arg2);
-        if (typeof cmd != "object") {
-          throw Error("Invalid command value." + __arg2);
-        }
-        if (!cmd.hasOwnProperty("name")) {
-          throw Error(
-            'Invalid command value, MUST have "name" property.' + __arg2
-          );
-        }
-        if (cmd.name == "_error" || cmd.name == "_result") {
-          if (self.stubs.hasOwnProperty(cmd.transId)) {
-            self.stubs[cmd.transId](cmd);
-            delete self.stubs[cmd.transId];
-          }
-        } else {
-          if (cmd.hasOwnProperty("transId")) {
-            cmd.echoResult = function (result) {
-              self.sendCommand({
-                name: "_result",
-                transId: cmd.transId,
-                result: result,
-              });
-            };
-            cmd.echoError = function (error) {
-              self.sendCommand({
-                name: "_error",
-                transId: cmd.transId,
-                error: error,
-              });
-            };
-          } else {
-            cmd.echoResult = () => {};
-            cmd.echoError = () => {};
-          }
-          self.emit(cmd.name, cmd);
-        }
-      } catch (error) {
-        console.error("parse command failed", error);
-        return;
-      }
-      break;
-    case "data":
-      this.emit("data", __arg2);
-      break;
-    case "close":
-      this.emit("close", __arg2);
-      break;
-  }
-};
+ttsignal.ServerConnection.prototype._internalCallback = function(type, __arg2, __arg3){
+    var self = this;
+    switch(type){
+        case 'handshakeFinished':
+            this.emit('handshakeFinished');
+            break;
+        case 'connect':
+            try {
+                props = JSON.parse(__arg2);
+                this.emit('connect', props);
+            } catch (e) {
+                this.emit('connect', e);
+            }
+            break;
+        case 'command':
+            try {
+                cmd = JSON.parse(__arg2);
+                if (typeof(cmd) != 'object') {
+                    throw Error('Invalid command value.' + __arg2);
+                }
+                if (!cmd.hasOwnProperty('name')){
+                    throw Error('Invalid command value, MUST have "name" property.' + __arg2);
+                }
+                if (cmd.name == '_error' || cmd.name == '_result'){
+                    if (self.stubs.hasOwnProperty(cmd.transId)) {
+                        self.stubs[cmd.transId](cmd);
+                        delete self.stubs[cmd.transId];
+                    }
+                } else {
+                    if (cmd.hasOwnProperty('transId')) {
+                        cmd.echoResult = function(result){
+                            self.sendCommand({
+                                name: '_result',
+                                transId: cmd.transId,
+                                result: result
+                            });
+                        }
+                        cmd.echoError = function(error){
+                            self.sendCommand({
+                                name: '_error',
+                                transId: cmd.transId,
+                                error: error
+                            });
+                        }
+                    } else {
+                        cmd.echoResult = ()=>{};
+                        cmd.echoError = ()=>{};
+                    }
+                    self.emit(cmd.name, cmd);
+                }
+            } catch (error) {
+                console.error('parse command failed', error);
+                return;
+            }
+            break;
+        case 'data':
+            this.emit('data', __arg2);
+            break;
+        case 'close':
+            this.emit('close', __arg2);
+            break;
+    }
+}
 
 /**
  * 为特定事件添加一个监听处理程序.
- * 当前支持除'_error/_result/onStatus/error/close'等事件之外的
+ * 当前支持除'_error/_result/onStatus/error/close'等事件之外的 
  * 任何自定义事件.上述事件为内部保留事件，用户不应定义与这些事件同名的
  * 远程调用函数名。与用户自定义事件相对应的事件处理函数的参数列表与远端
  * 调用时传入的参数列表一致。
@@ -749,26 +860,28 @@ ttsignal.ServerConnection.prototype._internalCallback = function (
  *
  * @method sendCommand
  * @public
- * @param timestamp {Number} timestamp.
- * @param cmd {Buffer} commnd to send.
+ * @param cmd {Object} command to send.
+ * @param callback {Function} callback function.
  * @example
- *     conn.sendCommand(cmd);
+ *     conn.sendCommand(cmd, function(result){
+ *         console.log(result);
+ *     });
  **/
-ttsignal.ServerConnection.prototype.sendCommand = function (cmd) {
-  if (typeof cmd != "object") {
-    throw Error("Invalid command value.");
-  }
-  if (!cmd.hasOwnProperty("name")) {
-    throw Error('Invalid command value, MUST have "name" property.');
-  }
-  if (typeof callback === "function") {
-    cmd.transId = this.nextTransId++;
-    this.stubs[cmd.transId] = callback;
-  }
-  let msg = JSON.stringify(cmd);
-  let buf = Buffer.from(msg, "utf8");
-  this.__sendPacket__(CONST.TTS_TYPE_COMMAND, new Date().getTime(), 0, buf);
-};
+ttsignal.ServerConnection.prototype.sendCommand = function(cmd, callback){
+    if (typeof(cmd) != 'object') {
+        throw Error('Invalid command value.');
+    }
+    if (!cmd.hasOwnProperty('name')){
+        throw Error('Invalid command value, MUST have "name" property.');
+    }
+    if (typeof callback === 'function') {
+        cmd.transId = this.nextTransId++;
+        this.stubs[cmd.transId] = callback;
+    }
+    let msg = JSON.stringify(cmd);
+    let buf = Buffer.from(msg, 'utf8');
+    this.__sendPacket__(CONST.TTS_TYPE_COMMAND, (new Date).getTime(), cmd.transId, 0, buf);
+}
 
 /**
  * 发送数据.
@@ -780,12 +893,12 @@ ttsignal.ServerConnection.prototype.sendCommand = function (cmd) {
  * @example
  *     conn.sendData(data);
  **/
-ttsignal.ServerConnection.prototype.sendData = function (data) {
-  if (data instanceof Buffer == false) {
-    throw Error("Invalid data type, MUST be Buffer.");
-  }
-  this.__sendPacket__(CONST.TTS_TYPE_MESSAGE, new Date().getTime(), 0, data);
-};
+ttsignal.ServerConnection.prototype.sendData = function(data){
+    if (data instanceof Buffer == false) {
+        throw Error('Invalid data type, MUST be Buffer.');
+    }
+    this.__sendPacket__(CONST.TTS_TYPE_MESSAGE, (new Date).getTime(), 0, data);
+}
 
 /**
  * 接受连接。
@@ -796,12 +909,12 @@ ttsignal.ServerConnection.prototype.sendData = function (data) {
  * @example
  *     conn.accept(true, { server_param: 'server param' });
  **/
-ttsignal.ServerConnection.prototype.accept = function (accept, result) {
-  if (typeof accept != "boolean") {
-    throw Error("Invalid accept value.");
-  }
-  this.__accept__(accept, JSON.stringify(result));
-};
+ttsignal.ServerConnection.prototype.accept = function(accept, result){
+    if (typeof(accept) != 'boolean') {
+        throw Error('Invalid accept value.');
+    }
+    this.__accept__(accept, JSON.stringify(result));
+}
 
 /**
  * 关闭。
@@ -812,13 +925,13 @@ ttsignal.ServerConnection.prototype.accept = function (accept, result) {
  * @example
  *     conn.close();
  **/
-ttsignal.ServerConnection.prototype.close = function () {
-  this.__close__();
-};
+ttsignal.ServerConnection.prototype.close = function(){
+    this.__close__();
+}
 
 /*******************************************************************************
- * @class
- *******************************************************************************/
+* @class 
+*******************************************************************************/
 
 /**
  * 创建连接器.
@@ -826,18 +939,36 @@ ttsignal.ServerConnection.prototype.close = function () {
  * @method createConnector
  * @public
  * @param config {Object} configure info.
+ * @param config.alpn {String} required, ALPN string ('ttsignal' on the wire regardless).
+ * @param config.ca_cert_pem {String=} optional, custom root CA in PEM format.
+ * @param config.disableAutoRestart {Boolean=} optional, default `false`.
+ *   When `false` (default) ttsignal starts a platform-native path-change
+ *   monitor (NWPathMonitor on macOS, NETLINK_ROUTE on Linux,
+ *   NotifyIpInterfaceChange on Windows) and automatically restarts the
+ *   underlying UDP socket whenever the OS reports a different default
+ *   interface (Wi-Fi <-> ethernet, Wi-Fi <-> wired, VPN up/down). Each
+ *   auto-restart fires the existing `connection.on('restart', cb)` event,
+ *   so application code does NOT need to call `connection.restart()`
+ *   manually. Set `disableAutoRestart: true` for long-lived server
+ *   deployments where the box never roams.
  * @example
- *     var succeed = ttsignal.createConnector(config);
+ *     var connector = ttsignal.createConnector({
+ *         alpn: 'ttsignal',
+ *         disableAutoRestart: false,  // default
+ *     });
  **/
-ttsignal.createConnector = function (config) {
-  if (typeof config !== "object") {
-    throw Error("Invalid config.");
-  }
-  if (!config.alpn) {
-    throw Error("Invalid alpn value.");
-  }
-  return ttsignal.__createConnector__(config);
-};
+ttsignal.createConnector = function(config){
+    if (typeof config !== 'object') {
+        throw Error('Invalid config.');
+    }
+    if (!config.alpn){
+        throw Error('Invalid alpn value.');
+    }
+    if (config.caCertPem && !config.ca_cert_pem) {
+        config.ca_cert_pem = config.caCertPem;
+    }
+    return ttsignal.__createConnector__(config);
+}
 
 /**
  * 创建服务器.
@@ -848,23 +979,21 @@ ttsignal.createConnector = function (config) {
  * @example
  *     var succeed = ttsignal.createServer(config);
  **/
-ttsignal.createServer = function (config) {
-  if (typeof config !== "object") {
-    throw Error("Invalid config.");
-  }
-  if (!config.alpn) {
-    throw Error("Invalid alpn value.");
-  }
-  return ttsignal.__createServer__(config);
-};
+ttsignal.createServer = function(config){
+    if (typeof config !== 'object') {
+        throw Error('Invalid config.');
+    }
+    if (!config.alpn){
+        throw Error('Invalid alpn value.');
+    }
+    return ttsignal.__createServer__(config);
+}
 
 //*******************************************************************************
-// Exports :
+// Exports : 
 //*******************************************************************************
 
-// Export for both CommonJS (require) and ESM (dynamic import default)
-// module.exports = ttsignal;
-exports.ttsignal = ttsignal;
+module.exports = ttsignal;
 
 //*******************************************************************************
 // End of file : ttsignal.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cc-livekit/ttsignal",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"