@feng3d/ctc 0.0.9 → 0.0.11

package/dist/controller.d.ts

@@ -3,171 +3,75 @@
  *
  * 客户端控制器模块。
  *
- * 管理客户端与穿透服务器之间的 WebSocket 控制连接，
- * 负责身份认证、心跳保活、消息收发、断线重连等核心通信逻辑。
+ * 管理客户端与穿透服务器之间的 WebSocket 控制连接和二进制数据通道，
+ * 负责身份认证、心跳保活、数据通道建立、消息收发、断线重连等核心通信逻辑。
  */
 import { EventEmitter } from 'events';
 import { Config } from './config.js';
+import { DataChannel } from './data-channel.js';
 /**
- * 客户端控制器类，管理与穿透服务器的 WebSocket 控制连接。
+ * 客户端控制器类。
  *
- * 继承自 {@link EventEmitter}，提供以下事件：
- * - `connected` - 成功连接到服务器时触发
- * - `disconnected` - 与服务器断开连接时触发
- * - `authenticated` - 身份认证成功时触发
- * - `maxReconnectAttemptsReached` - 达到最大重连次数时触发
- * - `newConnection` - 收到新的代理连接请求时触发
- * - `connectionClose` - 收到连接关闭通知时触发
- * - `connectionError` - 收到连接错误通知时触发
- *
- * @example
- * ```typescript
- * const controller = new Controller(config);
- * controller.on('authenticated', () => logger.log('已认证'));
- * await controller.connect();
- * ```
+ * 事件：
+ * - `connected` — 成功连接到服务器
+ * - `disconnected` — 与服务器断开连接
+ * - `authenticated` — 身份认证成功
+ * - `maxReconnectAttemptsReached` — 达到最大重连次数
+ * - `newConnection` — 收到新的代理连接请求
+ * - `connectionClose` — 收到连接关闭通知
+ * - `connectionError` — 收到连接错误通知
  */
 export declare class Controller extends EventEmitter {
-    /** 客户端配置实例 */
     private config;
-    /** 与服务器的 WebSocket 连接实例 */
     private ws;
-    /** 是否已连接到服务器 */
     private connected;
-    /** 是否已通过身份认证 */
     private authenticated;
-    /** 重连定时器 */
     private reconnectTimer;
-    /** 心跳定时器 */
     private heartbeatTimer;
-    /** 当前重连尝试次数 */
     private reconnectAttempts;
-    /** 待响应的请求映射表，键为消息 ID */
     private pendingRequests;
+    /** 服务端分配的客户端 ID（认证成功后获得） */
+    private clientId;
+    /** 二进制数据通道 */
+    private dataChannel;
+    constructor(config: Config);
     /**
-     * 创建控制器实例。
-     *
-     * @param config - 客户端配置对象
+     * 获取数据通道实例
      */
-    constructor(config: Config);
+    getDataChannel(): DataChannel;
+    /**
+     * 获取客户端 ID
+     */
+    getClientId(): string;
     /**
      * 连接到穿透服务器。
      *
-     * 建立 WebSocket 连接后会自动进行身份认证和启动心跳。
-     * 连接断开时会自动安排重连。
-     *
-     * @returns 连接并认证成功后解析的 Promise
-     * @throws {Error} 连接失败或认证失败时抛出错误
+     * 建立 WebSocket 连接 → 认证 → 建立数据通道 → 启动心跳。
      */
     connect(): Promise<void>;
     /**
-     * 向服务器发送身份认证请求。
-     *
-     * 使用配置中的 token 进行认证，认证成功后触发 `authenticated` 事件。
-     *
-     * @throws {Error} 认证失败时抛出错误，包含服务器返回的错误信息
+     * 认证并获取 clientId
      */
     private authenticate;
     /**
-     * 启动心跳定时器。
-     *
-     * 每 30 秒向服务器发送一次心跳消息，仅在已连接且已认证状态下发送。
+     * 建立数据通道（TCP + UDP）
      */
+    private establishDataChannels;
     private startHeartbeat;
-    /**
-     * 停止心跳定时器。
-     *
-     * 清除心跳定时器并将其设置为 null。
-     */
     private stopHeartbeat;
-    /**
-     * 安排断线重连。
-     *
-     * 使用指数退避策略计算重连延迟时间。如果已达到最大重连次数，
-     * 则触发 `maxReconnectAttemptsReached` 事件并停止重连。
-     */
     private scheduleReconnect;
-    /**
-     * 计算重连延迟时间（指数退避算法）。
-     *
-     * 基于重连间隔和当前重连次数计算延迟，最大不超过 60 秒，
-     * 并添加 0~1 秒的随机抖动以避免多客户端同时重连造成服务器压力。
-     *
-     * @returns 重连延迟时间（毫秒）
-     */
     private calculateReconnectDelay;
     /**
-     * 处理从服务器接收到的消息。
-     *
-     * 根据消息类型进行分发：
-     * - 响应类消息（AUTH_RESP、REGISTER_RESP、HEARTBEAT_RESP）交由 {@link handleResponse} 处理
-     * - 新连接、连接关闭、连接错误等消息通过事件触发通知上层
-     *
-     * @param data - 接收到的原始消息数据
+     * 处理控制消息（仅控制消息，数据通过 DataChannel 传输）
      */
     private handleMessage;
-    /**
-     * 处理响应类消息。
-     *
-     * 根据消息 ID 查找对应的待处理请求，清除超时定时器并解析 Promise。
-     *
-     * @param message - 服务器返回的响应消息对象
-     */
     private handleResponse;
-    /**
-     * 发送请求消息并等待服务器响应。
-     *
-     * 将消息发送到服务器，并在指定超时时间内等待对应的响应消息。
-     * 如果超时未收到响应，Promise 将被拒绝。
-     *
-     * @typeParam T - 期望的响应消息类型
-     * @param message - 要发送的请求消息对象，必须包含 `id` 字段
-     * @param timeout - 请求超时时间（毫秒），默认为 30000
-     * @returns 服务器响应消息的 Promise
-     * @throws {Error} 请求超时时抛出 "Request timeout" 错误
-     */
     sendRequest<T>(message: any, timeout?: number): Promise<T>;
-    /**
-     * 向服务器发送消息。
-     *
-     * 将消息对象序列化为 JSON 并通过 WebSocket 发送。
-     * 仅在 WebSocket 连接处于 OPEN 状态时才能发送。
-     *
-     * @param message - 要发送的消息对象
-     * @returns 发送成功返回 `true`，未连接时返回 `false`
-     */
     sendMessage(message: any): boolean;
-    /**
-     * 检查是否已连接到服务器。
-     *
-     * @returns 已连接返回 `true`，否则返回 `false`
-     */
     isConnected(): boolean;
-    /**
-     * 检查是否已通过身份认证。
-     *
-     * @returns 已认证返回 `true`，否则返回 `false`
-     */
     isAuthenticated(): boolean;
-    /**
-     * 获取当前重连尝试次数。
-     *
-     * @returns 当前重连次数
-     */
     getReconnectAttempts(): number;
-    /**
-     * 断开与服务器的连接。
-     *
-     * 清除重连定时器、停止心跳、关闭 WebSocket 连接，
-     * 并重置连接和认证状态。
-     */
     disconnect(): void;
-    /**
-     * 销毁控制器实例，释放所有资源。
-     *
-     * 断开连接、清除所有待处理请求的超时定时器、
-     * 清空待处理请求映射表并移除所有事件监听器。
-     */
     destroy(): void;
 }
 //# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AActC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,cAAc;IACd,OAAO,CAAC,MAAM,CAAS;IAEvB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAA0B;IAEpC,gBAAgB;IAChB,OAAO,CAAC,SAAS,CAAkB;IAEnC,gBAAgB;IAChB,OAAO,CAAC,aAAa,CAAkB;IAEvC,YAAY;IACZ,OAAO,CAAC,cAAc,CAA+B;IAErD,YAAY;IACZ,OAAO,CAAC,cAAc,CAA+B;IAErD,eAAe;IACf,OAAO,CAAC,iBAAiB,CAAa;IAEtC,wBAAwB;IACxB,OAAO,CAAC,eAAe,CAIR;IAEf;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAK1B;;;;;;;;OAQG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C9B;;;;;;OAMG;YACW,YAAY;IAiB1B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAkCrB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAYjE;;;;;;;;OAQG;IACH,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IASlC;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;;;;OAKG;IACH,UAAU,IAAI,IAAI;IAclB;;;;;OAKG;IACH,OAAO,IAAI,IAAI;CAQhB"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAYtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,eAAe,CAIR;IAEf,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAc;IAE9B,cAAc;IACd,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,MAAM;IAM1B;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C9B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;YACW,qBAAqB;IAuBnC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,cAAc;IAStB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAYjE,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IASlC,WAAW,IAAI,OAAO;IAItB,eAAe,IAAI,OAAO;IAI1B,oBAAoB,IAAI,MAAM;IAI9B,UAAU,IAAI,IAAI;IAelB,OAAO,IAAI,IAAI;CAQhB"}

package/dist/controller.js

@@ -3,63 +3,56 @@
  *
  * 客户端控制器模块。
  *
- * 管理客户端与穿透服务器之间的 WebSocket 控制连接，
- * 负责身份认证、心跳保活、消息收发、断线重连等核心通信逻辑。
+ * 管理客户端与穿透服务器之间的 WebSocket 控制连接和二进制数据通道，
+ * 负责身份认证、心跳保活、数据通道建立、消息收发、断线重连等核心通信逻辑。
  */
 import { WebSocket } from 'ws';
 import { EventEmitter } from 'events';
 import { MessageType, createMessage, logger, } from '@feng3d/chuantou-shared';
+import { DataChannel } from './data-channel.js';
 /**
- * 客户端控制器类，管理与穿透服务器的 WebSocket 控制连接。
+ * 客户端控制器类。
  *
- * 继承自 {@link EventEmitter}，提供以下事件：
- * - `connected` - 成功连接到服务器时触发
- * - `disconnected` - 与服务器断开连接时触发
- * - `authenticated` - 身份认证成功时触发
- * - `maxReconnectAttemptsReached` - 达到最大重连次数时触发
- * - `newConnection` - 收到新的代理连接请求时触发
- * - `connectionClose` - 收到连接关闭通知时触发
- * - `connectionError` - 收到连接错误通知时触发
- *
- * @example
- * ```typescript
- * const controller = new Controller(config);
- * controller.on('authenticated', () => logger.log('已认证'));
- * await controller.connect();
- * ```
+ * 事件：
+ * - `connected` — 成功连接到服务器
+ * - `disconnected` — 与服务器断开连接
+ * - `authenticated` — 身份认证成功
+ * - `maxReconnectAttemptsReached` — 达到最大重连次数
+ * - `newConnection` — 收到新的代理连接请求
+ * - `connectionClose` — 收到连接关闭通知
+ * - `connectionError` — 收到连接错误通知
  */
 export class Controller extends EventEmitter {
-    /**
-     * 创建控制器实例。
-     *
-     * @param config - 客户端配置对象
-     */
     constructor(config) {
         super();
-        /** 与服务器的 WebSocket 连接实例 */
         this.ws = null;
-        /** 是否已连接到服务器 */
         this.connected = false;
-        /** 是否已通过身份认证 */
         this.authenticated = false;
-        /** 重连定时器 */
         this.reconnectTimer = null;
-        /** 心跳定时器 */
         this.heartbeatTimer = null;
-        /** 当前重连尝试次数 */
         this.reconnectAttempts = 0;
-        /** 待响应的请求映射表，键为消息 ID */
         this.pendingRequests = new Map();
+        /** 服务端分配的客户端 ID（认证成功后获得） */
+        this.clientId = '';
         this.config = config;
+        this.dataChannel = new DataChannel();
+    }
+    /**
+     * 获取数据通道实例
+     */
+    getDataChannel() {
+        return this.dataChannel;
+    }
+    /**
+     * 获取客户端 ID
+     */
+    getClientId() {
+        return this.clientId;
     }
     /**
      * 连接到穿透服务器。
      *
-     * 建立 WebSocket 连接后会自动进行身份认证和启动心跳。
-     * 连接断开时会自动安排重连。
-     *
-     * @returns 连接并认证成功后解析的 Promise
-     * @throws {Error} 连接失败或认证失败时抛出错误
+     * 建立 WebSocket 连接 → 认证 → 建立数据通道 → 启动心跳。
      */
     async connect() {
         return new Promise((resolve, reject) => {
@@ -70,9 +63,9 @@ export class Controller extends EventEmitter {
                 this.connected = true;
                 this.reconnectAttempts = 0;
                 this.emit('connected');
-                // 认证
                 try {
                     await this.authenticate();
+                    await this.establishDataChannels();
                     this.startHeartbeat();
                     resolve();
                 }
@@ -88,6 +81,8 @@ export class Controller extends EventEmitter {
                 this.connected = false;
                 this.authenticated = false;
                 this.stopHeartbeat();
+                this.dataChannel.destroy();
+                this.dataChannel = new DataChannel();
                 this.emit('disconnected');
                 this.scheduleReconnect();
             });
@@ -100,11 +95,7 @@ export class Controller extends EventEmitter {
         });
     }
     /**
-     * 向服务器发送身份认证请求。
-     *
-     * 使用配置中的 token 进行认证，认证成功后触发 `authenticated` 事件。
-     *
-     * @throws {Error} 认证失败时抛出错误，包含服务器返回的错误信息
+     * 认证并获取 clientId
      */
     async authenticate() {
         logger.log('正在认证...');
@@ -115,15 +106,34 @@ export class Controller extends EventEmitter {
         if (!response.payload.success) {
             throw new Error(`认证失败: ${response.payload.error}`);
         }
+        this.clientId = response.payload.clientId || '';
         this.authenticated = true;
-        logger.log('认证成功');
+        logger.log(`认证成功 (clientId: ${this.clientId})`);
         this.emit('authenticated');
     }
     /**
-     * 启动心跳定时器。
-     *
-     * 每 30 秒向服务器发送一次心跳消息，仅在已连接且已认证状态下发送。
+     * 建立数据通道（TCP + UDP）
      */
+    async establishDataChannels() {
+        if (!this.clientId) {
+            throw new Error('无法建立数据通道: clientId 未分配');
+        }
+        // 从 WebSocket URL 解析服务端地址和端口
+        const url = new URL(this.config.serverUrl);
+        const host = url.hostname;
+        const port = parseInt(url.port) || (url.protocol === 'wss:' ? 443 : 80);
+        // 并行建立 TCP 和 UDP 数据通道
+        await Promise.all([
+            this.dataChannel.connectTcp(host, port, this.clientId).catch((error) => {
+                logger.error('TCP 数据通道建立失败:', error.message);
+                throw error;
+            }),
+            this.dataChannel.connectUdp(host, port, this.clientId).catch((error) => {
+                logger.warn('UDP 数据通道建立失败（UDP 穿透将不可用）:', error.message);
+                // UDP 通道失败不阻断启动
+            }),
+        ]);
+    }
     startHeartbeat() {
         this.heartbeatTimer = setInterval(() => {
             if (this.connected && this.authenticated) {
@@ -132,28 +142,17 @@ export class Controller extends EventEmitter {
                 });
                 this.sendMessage(heartbeatMsg);
             }
-        }, 30000); // 30秒
+        }, 30000);
     }
-    /**
-     * 停止心跳定时器。
-     *
-     * 清除心跳定时器并将其设置为 null。
-     */
     stopHeartbeat() {
         if (this.heartbeatTimer) {
             clearInterval(this.heartbeatTimer);
             this.heartbeatTimer = null;
         }
     }
-    /**
-     * 安排断线重连。
-     *
-     * 使用指数退避策略计算重连延迟时间。如果已达到最大重连次数，
-     * 则触发 `maxReconnectAttemptsReached` 事件并停止重连。
-     */
     scheduleReconnect() {
         if (this.reconnectTimer) {
-            return; // 已经安排了重连
+            return;
         }
         if (this.reconnectAttempts >= this.config.maxReconnectAttempts) {
             logger.error('已达到最大重连次数');
@@ -172,29 +171,14 @@ export class Controller extends EventEmitter {
             });
         }, delay);
     }
-    /**
-     * 计算重连延迟时间（指数退避算法）。
-     *
-     * 基于重连间隔和当前重连次数计算延迟，最大不超过 60 秒，
-     * 并添加 0~1 秒的随机抖动以避免多客户端同时重连造成服务器压力。
-     *
-     * @returns 重连延迟时间（毫秒）
-     */
     calculateReconnectDelay() {
         const baseDelay = this.config.reconnectInterval;
-        const maxDelay = 60000; // 最大60秒
+        const maxDelay = 60000;
         const delay = Math.min(baseDelay * Math.pow(2, this.reconnectAttempts), maxDelay);
-        // 添加随机抖动
         return delay + Math.random() * 1000;
     }
     /**
-     * 处理从服务器接收到的消息。
-     *
-     * 根据消息类型进行分发：
-     * - 响应类消息（AUTH_RESP、REGISTER_RESP、HEARTBEAT_RESP）交由 {@link handleResponse} 处理
-     * - 新连接、连接关闭、连接错误等消息通过事件触发通知上层
-     *
-     * @param data - 接收到的原始消息数据
+     * 处理控制消息（仅控制消息，数据通过 DataChannel 传输）
      */
     handleMessage(data) {
         try {
@@ -204,7 +188,6 @@ export class Controller extends EventEmitter {
                 case MessageType.AUTH_RESP:
                 case MessageType.REGISTER_RESP:
                 case MessageType.HEARTBEAT_RESP:
-                    // 响应消息，由pendingRequests处理
                     this.handleResponse(message);
                     break;
                 case MessageType.NEW_CONNECTION:
@@ -225,13 +208,6 @@ export class Controller extends EventEmitter {
             logger.error('处理消息时出错:', errorMessage);
         }
     }
-    /**
-     * 处理响应类消息。
-     *
-     * 根据消息 ID 查找对应的待处理请求，清除超时定时器并解析 Promise。
-     *
-     * @param message - 服务器返回的响应消息对象
-     */
     handleResponse(message) {
         const pending = this.pendingRequests.get(message.id);
         if (pending) {
@@ -240,18 +216,6 @@ export class Controller extends EventEmitter {
             pending.resolve(message);
         }
     }
-    /**
-     * 发送请求消息并等待服务器响应。
-     *
-     * 将消息发送到服务器，并在指定超时时间内等待对应的响应消息。
-     * 如果超时未收到响应，Promise 将被拒绝。
-     *
-     * @typeParam T - 期望的响应消息类型
-     * @param message - 要发送的请求消息对象，必须包含 `id` 字段
-     * @param timeout - 请求超时时间（毫秒），默认为 30000
-     * @returns 服务器响应消息的 Promise
-     * @throws {Error} 请求超时时抛出 "Request timeout" 错误
-     */
     sendRequest(message, timeout = 30000) {
         return new Promise((resolve, reject) => {
             const timer = setTimeout(() => {
@@ -262,15 +226,6 @@ export class Controller extends EventEmitter {
             this.sendMessage(message);
         });
     }
-    /**
-     * 向服务器发送消息。
-     *
-     * 将消息对象序列化为 JSON 并通过 WebSocket 发送。
-     * 仅在 WebSocket 连接处于 OPEN 状态时才能发送。
-     *
-     * @param message - 要发送的消息对象
-     * @returns 发送成功返回 `true`，未连接时返回 `false`
-     */
     sendMessage(message) {
         if (this.ws && this.ws.readyState === WebSocket.OPEN) {
             this.ws.send(JSON.stringify(message));
@@ -279,42 +234,22 @@ export class Controller extends EventEmitter {
         logger.error('无法发送消息: 未连接');
         return false;
     }
-    /**
-     * 检查是否已连接到服务器。
-     *
-     * @returns 已连接返回 `true`，否则返回 `false`
-     */
     isConnected() {
         return this.connected;
     }
-    /**
-     * 检查是否已通过身份认证。
-     *
-     * @returns 已认证返回 `true`，否则返回 `false`
-     */
     isAuthenticated() {
         return this.authenticated;
     }
-    /**
-     * 获取当前重连尝试次数。
-     *
-     * @returns 当前重连次数
-     */
     getReconnectAttempts() {
         return this.reconnectAttempts;
     }
-    /**
-     * 断开与服务器的连接。
-     *
-     * 清除重连定时器、停止心跳、关闭 WebSocket 连接，
-     * 并重置连接和认证状态。
-     */
     disconnect() {
         if (this.reconnectTimer) {
             clearTimeout(this.reconnectTimer);
             this.reconnectTimer = null;
         }
         this.stopHeartbeat();
+        this.dataChannel.destroy();
         if (this.ws) {
             this.ws.close();
             this.ws = null;
@@ -322,12 +257,6 @@ export class Controller extends EventEmitter {
         this.connected = false;
         this.authenticated = false;
     }
-    /**
-     * 销毁控制器实例，释放所有资源。
-     *
-     * 断开连接、清除所有待处理请求的超时定时器、
-     * 清空待处理请求映射表并移除所有事件监听器。
-     */
     destroy() {
         this.disconnect();
         for (const { timeout } of this.pendingRequests.values()) {

package/dist/controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"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"}

package/dist/data-channel.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @module data-channel
+ *
+ * 客户端数据通道模块。
+ *
+ * 管理与服务端的 TCP 二进制数据通道和 UDP 数据通道连接。
+ * TCP 数据通道用于高效传输 HTTP/WS/TCP 的原始二进制数据，
+ * UDP 数据通道用于保留 UDP 语义的数据转发。
+ */
+import { EventEmitter } from 'events';
+/**
+ * 客户端数据通道
+ *
+ * 管理与服务端的 TCP 数据通道和 UDP 数据通道。
+ *
+ * 事件：
+ * - `'data'(connectionId, data)` — 收到服务端 TCP 数据帧
+ * - `'udpData'(connectionId, data)` — 收到服务端 UDP 数据帧
+ * - `'connected'` — TCP 数据通道已连接
+ * - `'disconnected'` — TCP 数据通道已断开
+ */
+export declare class DataChannel extends EventEmitter {
+    private tcpSocket;
+    private udpSocket;
+    private frameParser;
+    private udpKeepaliveTimer;
+    private clientId;
+    private serverHost;
+    private serverPort;
+    /**
+     * 建立 TCP 数据通道
+     *
+     * @param serverHost - 服务端地址
+     * @param serverPort - 服务端端口（与控制端口相同）
+     * @param clientId - 服务端分配的客户端 ID
+     */
+    connectTcp(serverHost: string, serverPort: number, clientId: string): Promise<void>;
+    /**
+     * 建立 UDP 数据通道
+     *
+     * @param serverHost - 服务端地址
+     * @param serverPort - 服务端端口（与控制端口相同）
+     * @param clientId - 服务端分配的客户端 ID
+     */
+    connectUdp(serverHost: string, serverPort: number, clientId: string): Promise<void>;
+    /**
+     * 通过 TCP 数据通道发送数据帧
+     *
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendData(connectionId: string, data: Buffer): boolean;
+    /**
+     * 通过 UDP 数据通道发送数据帧
+     *
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendUdpData(connectionId: string, data: Buffer): boolean;
+    /** TCP 数据通道是否已连接 */
+    get isTcpConnected(): boolean;
+    /** UDP 数据通道是否已连接 */
+    get isUdpConnected(): boolean;
+    /**
+     * 销毁数据通道，释放所有资源
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=data-channel.d.ts.map

package/dist/data-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-channel.d.ts","sourceRoot":"","sources":["../src/data-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAetC;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;;OAMG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEzF;;;;;;OAMG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDzF;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrD;;;;;;OAMG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IASxD,oBAAoB;IACpB,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,oBAAoB;IACpB,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,OAAO,IAAI,IAAI;CAuBhB"}