@cc-livekit/ttsignal 1.1.0 → 1.1.1

package/index.js

@@ -1391,13 +1391,34 @@ ttsignal.HttpConnector.prototype.close = function () {
  * @method info
  * @public
  * @return {Object} { closed, vpnPolicy, pendingRequests, maxResponseBytes,
- *   drainTimeoutMs, hasPathMonitor }
+ *   drainTimeoutMs, maxIdleConnections, idleTimeoutMs, hasPathMonitor }
  *   hasPathMonitor 为 false = 这个产物把网卡绑定条件编译掉了，见本节文档第五条。
  **/
 ttsignal.HttpConnector.prototype.info = function () {
     return this.__info__();
 };
 
+/**
+ * 运行期调整 keep-alive 空闲连接的存活上限。
+ *
+ * 0 = 不设本地超时，完全听服务端的。上限 24 小时（越界夹住并打 WARN）。
+ * 连接器已关闭时静默忽略（与 close() 的幂等语义一致）。
+ *
+ * ⚠️ 只影响**此后**归还入池的连接：已经躺在池里的那些仍按各自入池时的时长
+ * 计时。要让新值立刻对全部连接生效，改完再重建连接器。
+ *
+ * @method setIdleTimeoutMs
+ * @public
+ * @param ms {Number} 毫秒，0 .. 4294967295。非数字抛 TypeError，越界抛 RangeError
+ * @example
+ *     const http = ttsignal.createHttpConnector();
+ *     http.setIdleTimeoutMs(5 * 60 * 1000);   // 空闲 5 分钟就收
+ *     console.log(http.info().idleTimeoutMs); // 300000
+ **/
+ttsignal.HttpConnector.prototype.setIdleTimeoutMs = function (ms) {
+    this.__setIdleTimeoutMs__(ms);
+};
+
 }   // typeof ttsignal.HttpConnector === 'function'
 
 /*******************************************************************************
@@ -1712,6 +1733,17 @@ ttsignal.WsConnection.prototype.info = function () {
  * @param config.maxResponseBytes {Number=} 响应上限，超了报 73
  * @param config.drainTimeoutMs {Number=} 关闭时等在途请求的上限
  * @param config.dnsServers {String=} / @param config.dnsTimeoutMs {Number=}
+ * @param config.idleTimeoutMs {Number=} 空闲连接在池里躺多久没人用就自行关掉，
+ *   默认 3600000（60 分钟），上限 86400000（24 小时）。每次归还重新计时。
+ *   **0 = 不设本地超时**，完全听服务端的。运行期可用 `setIdleTimeoutMs()` 改。
+ *   它是一道兜底：正常情况下服务端自己的 keep-alive 超时会先把连接收走，这里
+ *   只负责挡住「永不主动关连接」的服务端把 fd 长期占住。
+ * @param config.maxIdleConnections {Number=} keep-alive 连接池里每个目标
+ *   （host+port+tls+网卡策略）最多囤几条空闲连接，默认 4，上限 64。
+ *   **0 = 关掉复用**，退回「一次请求一条连接」并显式发 Connection: close。
+ *   默认开着复用：同一个 connector 连发多条请求时，第二条起省掉 TCP 握手和
+ *   整套 TLS 握手（实测同一 https 端点 280ms -> 95ms）。要吃到这个收益就得
+ *   **复用同一个 connector**，每条请求现建一个等于没开。
  * @return {ttsignal.HttpConnector}
  * @example
  *     const http = ttsignal.createHttpConnector({ vpnPolicy: 'force-physical' });

package/package.json

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