@feng3d/cts 0.0.9 → 0.0.11

package/README.md

@@ -6,7 +6,9 @@
 
 ## 特性
 
-- WebSocket 控制通道
+- 三通道架构：WebSocket 控制通道 + TCP 二进制数据通道 + UDP 数据通道
+- **每个代理端口同时支持 HTTP/WebSocket/TCP/UDP 四种协议**，自动识别协议类型
+- 控制端口复用：同一端口处理 WebSocket 控制连接、TCP 数据通道和 UDP 数据通道
 - 动态端口分配
 - 自动心跳检测
 - 多客户端支持
@@ -140,10 +142,17 @@ npx @feng3d/cts start -t "client1-token,client2-token,client3-token"
 ## 架构
 
 ```
-公网用户请求 -> 服务端监听端口 -> WebSocket 控制通道 -> 内网客户端 -> 本地服务
+控制端口（复用）:
+  ├─ WebSocket 控制通道 ── JSON 消息（认证/注册/心跳/连接通知）
+  ├─ TCP 数据通道 ─────── 二进制帧（HTTP/WS/TCP 数据转发）
+  └─ UDP 数据通道 ─────── UDP 数据帧（UDP 数据转发）
+
+代理端口（每端口同时监听 TCP + UDP）:
+  ├─ TCP 服务器 → 自动识别 HTTP/WebSocket/TCP 协议
+  └─ UDP 服务器 → 转发 UDP 数据
 ```
 
-**每个代理端口同时支持 HTTP 和 WebSocket 协议**，客户端无需指定协议类型。
+**每个代理端口同时支持 HTTP/WebSocket/TCP/UDP 四种协议**，客户端无需指定协议类型。
 
 ## 许可证
 

package/dist/data-channel.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @module data-channel
+ *
+ * 服务端数据通道管理器。
+ *
+ * 管理穿透客户端的 TCP 数据通道和 UDP 数据通道连接。
+ * TCP 数据通道用于高效传输 HTTP/WS/TCP 的原始二进制数据，
+ * UDP 数据通道用于保留 UDP 语义的数据转发。
+ */
+import { Socket } from 'net';
+import { Socket as UdpSocket, RemoteInfo } from 'dgram';
+import { EventEmitter } from 'events';
+import { SessionManager } from './session-manager.js';
+/**
+ * 服务端数据通道管理器
+ *
+ * 管理所有客户端的 TCP 二进制数据通道和 UDP 数据通道。
+ *
+ * 事件：
+ * - `'data'(clientId, connectionId, data)` — 收到客户端 TCP 数据帧
+ * - `'udpData'(clientId, connectionId, data)` — 收到客户端 UDP 数据帧
+ */
+export declare class DataChannelManager extends EventEmitter {
+    /** 客户端 TCP 数据通道：clientId → Socket */
+    private tcpChannels;
+    /** 客户端 TCP 帧解析器：clientId → FrameParser */
+    private frameParsers;
+    /** 客户端 UDP 地址：clientId → RemoteInfo */
+    private udpClients;
+    /** 服务端 UDP socket 引用 */
+    private udpSocket;
+    /** 会话管理器 */
+    private sessionManager;
+    constructor(sessionManager: SessionManager);
+    /**
+     * 设置 UDP socket 引用
+     */
+    setUdpSocket(socket: UdpSocket): void;
+    /**
+     * 处理新的 TCP 数据通道连接
+     *
+     * 解析认证帧，验证 clientId，建立关联。
+     *
+     * @param socket - 新的 TCP 连接
+     * @param initialData - 包含认证帧的初始数据
+     */
+    handleNewTcpConnection(socket: Socket, initialData: Buffer): void;
+    /**
+     * 处理 UDP 消息
+     *
+     * 区分控制帧（注册/保活）和数据帧。
+     *
+     * @param msg - 收到的 UDP 数据包
+     * @param rinfo - 发送方地址信息
+     */
+    handleUdpMessage(msg: Buffer, rinfo: RemoteInfo): void;
+    private handleUdpRegister;
+    /**
+     * 通过 TCP 数据通道发送数据帧给客户端
+     *
+     * @param clientId - 目标客户端 ID
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendToClient(clientId: string, connectionId: string, data: Buffer): boolean;
+    /**
+     * 通过 UDP 通道发送数据帧给客户端
+     *
+     * @param clientId - 目标客户端 ID
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendUdpToClient(clientId: string, connectionId: string, data: Buffer): boolean;
+    /**
+     * 检查客户端是否已建立 TCP 数据通道
+     */
+    hasDataChannel(clientId: string): boolean;
+    /**
+     * 检查客户端是否已注册 UDP 通道
+     */
+    hasUdpChannel(clientId: string): boolean;
+    /**
+     * 移除客户端的所有数据通道
+     */
+    removeClient(clientId: string): void;
+    /**
+     * 清理所有数据通道
+     */
+    clear(): 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;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,qCAAqC;IACrC,OAAO,CAAC,WAAW,CAAkC;IACrD,0CAA0C;IAC1C,OAAO,CAAC,YAAY,CAAuC;IAC3D,uCAAuC;IACvC,OAAO,CAAC,UAAU,CAAsC;IACxD,wBAAwB;IACxB,OAAO,CAAC,SAAS,CAA0B;IAC3C,YAAY;IACZ,OAAO,CAAC,cAAc,CAAiB;gBAE3B,cAAc,EAAE,cAAc;IAK1C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIrC;;;;;;;OAOG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAwDjE;;;;;;;OAOG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IA6BtD,OAAO,CAAC,iBAAiB;IAiBzB;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAS3E;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAU9E;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKzC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUpC;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/data-channel.js

@@ -0,0 +1,211 @@
+/**
+ * @module data-channel
+ *
+ * 服务端数据通道管理器。
+ *
+ * 管理穿透客户端的 TCP 数据通道和 UDP 数据通道连接。
+ * TCP 数据通道用于高效传输 HTTP/WS/TCP 的原始二进制数据，
+ * UDP 数据通道用于保留 UDP 语义的数据转发。
+ */
+import { EventEmitter } from 'events';
+import { parseTcpAuthFrame, parseUdpControlFrame, parseUdpDataFrame, writeDataFrame, writeUdpDataFrame, FrameParser, AUTH_RESPONSE, logger, } from '@feng3d/chuantou-shared';
+/**
+ * 服务端数据通道管理器
+ *
+ * 管理所有客户端的 TCP 二进制数据通道和 UDP 数据通道。
+ *
+ * 事件：
+ * - `'data'(clientId, connectionId, data)` — 收到客户端 TCP 数据帧
+ * - `'udpData'(clientId, connectionId, data)` — 收到客户端 UDP 数据帧
+ */
+export class DataChannelManager extends EventEmitter {
+    constructor(sessionManager) {
+        super();
+        /** 客户端 TCP 数据通道：clientId → Socket */
+        this.tcpChannels = new Map();
+        /** 客户端 TCP 帧解析器：clientId → FrameParser */
+        this.frameParsers = new Map();
+        /** 客户端 UDP 地址：clientId → RemoteInfo */
+        this.udpClients = new Map();
+        /** 服务端 UDP socket 引用 */
+        this.udpSocket = null;
+        this.sessionManager = sessionManager;
+    }
+    /**
+     * 设置 UDP socket 引用
+     */
+    setUdpSocket(socket) {
+        this.udpSocket = socket;
+    }
+    /**
+     * 处理新的 TCP 数据通道连接
+     *
+     * 解析认证帧，验证 clientId，建立关联。
+     *
+     * @param socket - 新的 TCP 连接
+     * @param initialData - 包含认证帧的初始数据
+     */
+    handleNewTcpConnection(socket, initialData) {
+        const clientId = parseTcpAuthFrame(initialData);
+        if (!clientId) {
+            logger.error('数据通道认证帧解析失败');
+            socket.write(AUTH_RESPONSE.FAILURE);
+            socket.destroy();
+            return;
+        }
+        // 验证 clientId 是否为已认证的客户端
+        const clientInfo = this.sessionManager.getClientInfo(clientId);
+        if (!clientInfo || !clientInfo.authenticated) {
+            logger.error(`数据通道认证失败: 客户端 ${clientId} 未认证`);
+            socket.write(AUTH_RESPONSE.FAILURE);
+            socket.destroy();
+            return;
+        }
+        // 关闭旧的数据通道（如果存在）
+        const oldSocket = this.tcpChannels.get(clientId);
+        if (oldSocket) {
+            oldSocket.destroy();
+            this.frameParsers.get(clientId)?.reset();
+        }
+        // 建立新的数据通道
+        socket.write(AUTH_RESPONSE.SUCCESS);
+        this.tcpChannels.set(clientId, socket);
+        const parser = new FrameParser();
+        this.frameParsers.set(clientId, parser);
+        parser.on('frame', (connectionId, data) => {
+            this.emit('data', clientId, connectionId, data);
+        });
+        socket.on('data', (chunk) => {
+            parser.push(chunk);
+        });
+        socket.on('close', () => {
+            logger.log(`客户端 ${clientId} 数据通道已关闭`);
+            this.tcpChannels.delete(clientId);
+            this.frameParsers.delete(clientId);
+        });
+        socket.on('error', (error) => {
+            logger.error(`客户端 ${clientId} 数据通道错误:`, error.message);
+            this.tcpChannels.delete(clientId);
+            this.frameParsers.delete(clientId);
+        });
+        logger.log(`客户端 ${clientId} 数据通道已建立`);
+    }
+    /**
+     * 处理 UDP 消息
+     *
+     * 区分控制帧（注册/保活）和数据帧。
+     *
+     * @param msg - 收到的 UDP 数据包
+     * @param rinfo - 发送方地址信息
+     */
+    handleUdpMessage(msg, rinfo) {
+        // 尝试解析为控制帧
+        const control = parseUdpControlFrame(msg);
+        if (control) {
+            if (control.type === 'register') {
+                this.handleUdpRegister(control.clientId, rinfo);
+            }
+            // keepalive 只需更新地址
+            if (control.type === 'keepalive') {
+                this.udpClients.set(control.clientId, rinfo);
+            }
+            return;
+        }
+        // 尝试解析为数据帧
+        const frame = parseUdpDataFrame(msg);
+        if (frame) {
+            // 查找此连接所属的客户端
+            // 通过遍历已注册的 UDP 客户端，匹配发送方地址
+            for (const [clientId, clientRinfo] of this.udpClients) {
+                if (clientRinfo.address === rinfo.address && clientRinfo.port === rinfo.port) {
+                    this.emit('udpData', clientId, frame.connectionId, frame.data);
+                    return;
+                }
+            }
+            logger.warn(`收到未知来源的 UDP 数据帧: ${rinfo.address}:${rinfo.port}`);
+        }
+    }
+    handleUdpRegister(clientId, rinfo) {
+        const clientInfo = this.sessionManager.getClientInfo(clientId);
+        if (!clientInfo || !clientInfo.authenticated) {
+            logger.error(`UDP 注册失败: 客户端 ${clientId} 未认证`);
+            return;
+        }
+        this.udpClients.set(clientId, rinfo);
+        // 发送确认
+        if (this.udpSocket) {
+            this.udpSocket.send(AUTH_RESPONSE.SUCCESS, rinfo.port, rinfo.address);
+        }
+        logger.log(`客户端 ${clientId} UDP 通道已注册 (${rinfo.address}:${rinfo.port})`);
+    }
+    /**
+     * 通过 TCP 数据通道发送数据帧给客户端
+     *
+     * @param clientId - 目标客户端 ID
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendToClient(clientId, connectionId, data) {
+        const socket = this.tcpChannels.get(clientId);
+        if (socket && !socket.destroyed) {
+            socket.write(writeDataFrame(connectionId, data));
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 通过 UDP 通道发送数据帧给客户端
+     *
+     * @param clientId - 目标客户端 ID
+     * @param connectionId - 连接 ID
+     * @param data - 要发送的原始数据
+     * @returns 是否发送成功
+     */
+    sendUdpToClient(clientId, connectionId, data) {
+        const clientRinfo = this.udpClients.get(clientId);
+        if (clientRinfo && this.udpSocket) {
+            const frame = writeUdpDataFrame(connectionId, data);
+            this.udpSocket.send(frame, clientRinfo.port, clientRinfo.address);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 检查客户端是否已建立 TCP 数据通道
+     */
+    hasDataChannel(clientId) {
+        const socket = this.tcpChannels.get(clientId);
+        return !!socket && !socket.destroyed;
+    }
+    /**
+     * 检查客户端是否已注册 UDP 通道
+     */
+    hasUdpChannel(clientId) {
+        return this.udpClients.has(clientId);
+    }
+    /**
+     * 移除客户端的所有数据通道
+     */
+    removeClient(clientId) {
+        const socket = this.tcpChannels.get(clientId);
+        if (socket) {
+            socket.destroy();
+            this.tcpChannels.delete(clientId);
+        }
+        this.frameParsers.delete(clientId);
+        this.udpClients.delete(clientId);
+    }
+    /**
+     * 清理所有数据通道
+     */
+    clear() {
+        for (const socket of this.tcpChannels.values()) {
+            socket.destroy();
+        }
+        this.tcpChannels.clear();
+        this.frameParsers.clear();
+        this.udpClients.clear();
+    }
+}
+//# sourceMappingURL=data-channel.js.map

package/dist/data-channel.js.map

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

package/dist/handlers/control-handler.d.ts

@@ -1,7 +1,11 @@
 /**
  * @module control-handler
- * @description 控制通道处理器模块，负责处理客户端通过 WebSocket 控制通道发送的各类控制消息。
- * 包括认证、端口注册/注销、心跳以及断开连接等消息的处理逻辑。
+ *
+ * 控制通道处理器模块。
+ *
+ * 负责处理客户端通过 WebSocket 控制通道发送的控制消息，
+ * 包括认证、端口注册/注销、心跳以及连接关闭等。
+ * 实际数据传输已移至独立的二进制数据通道。
  */
 import { WebSocket } from 'ws';
 import { ServerConfig } from '@feng3d/chuantou-shared';
@@ -10,149 +14,33 @@ import { UnifiedProxyHandler } from './unified-proxy.js';
 /**
  * 控制通道处理器
  *
- * 处理客户端通过 WebSocket 控制通道发送的各类控制消息，包括：
+ * 处理客户端通过 WebSocket 控制通道发送的控制消息：
  * - 客户端认证（AUTH）
  * - 端口注册（REGISTER）与注销（UNREGISTER）
  * - 心跳保活（HEARTBEAT）
- * - 连接断开的清理工作
+ * - 连接关闭（CONNECTION_CLOSE）
  */
 export declare class ControlHandler {
-    /** 会话管理器实例 */
     private sessionManager;
-    /** 服务器配置 */
     private config;
-    /** 统一代理处理器（同时支持 HTTP 和 WebSocket） */
     private proxyHandler;
-    /**
-     * 创建控制通道处理器实例
-     *
-     * @param sessionManager - 会话管理器，用于管理客户端会话
-     * @param config - 服务器配置，包含认证令牌等信息
-     * @param proxyHandler - 统一代理处理器，用于启停代理服务器
-     */
     constructor(sessionManager: SessionManager, config: ServerConfig, proxyHandler: UnifiedProxyHandler);
     /**
      * 处理新的 WebSocket 控制通道连接
-     *
-     * 为新连接创建会话，设置消息处理、关闭处理和错误处理回调，
-     * 并启动 30 秒认证超时计时器。
-     *
-     * @param socket - 新建立的 WebSocket 连接
      */
     handleConnection(socket: WebSocket): void;
     /**
-     * 处理收到的控制消息
+     * 处理控制消息
      *
-     * 解析 JSON 消息并根据消息类型分发到对应的处理方法。
-     * 支持的消息类型包括：AUTH、REGISTER、UNREGISTER、HEARTBEAT。
-     *
-     * @param clientId - 发送消息的客户端 ID
-     * @param socket - 客户端的 WebSocket 连接
-     * @param data - 收到的原始消息数据
+     * 仅处理控制消息，数据传输由独立的二进制数据通道处理。
      */
     private handleMessage;
-    /**
-     * 处理认证消息
-     *
-     * 验证客户端提供的令牌是否在配置的有效令牌列表中。
-     * 认证成功后清除认证超时计时器；认证失败则关闭连接。
-     *
-     * @param clientId - 客户端唯一标识 ID
-     * @param socket - 客户端的 WebSocket 连接
-     * @param message - 收到的认证消息
-     */
     private handleAuth;
-    /**
-     * 处理端口注册消息
-     *
-     * 验证客户端认证状态和端口范围（1024-65535），检查端口是否已被占用，
-     * 然后注册端口并启动代理服务器（同时支持 HTTP 和 WebSocket）。
-     * 若启动失败则自动回滚端口注册。
-     *
-     * @param clientId - 客户端唯一标识 ID
-     * @param socket - 客户端的 WebSocket 连接
-     * @param message - 收到的端口注册消息
-     */
     private handleRegister;
-    /**
-     * 处理端口注销消息
-     *
-     * 验证客户端认证状态和端口归属，停止代理服务器并注销端口。
-     *
-     * @param clientId - 客户端唯一标识 ID
-     * @param socket - 客户端的 WebSocket 连接
-     * @param message - 收到的端口注销消息
-     */
     private handleUnregister;
-    /**
-     * 处理心跳消息
-     *
-     * 更新客户端的最后心跳时间并回复心跳响应。
-     *
-     * @param clientId - 客户端唯一标识 ID
-     * @param socket - 客户端的 WebSocket 连接
-     * @param message - 收到的心跳消息
-     */
     private handleHeartbeat;
-    /**
-     * 处理客户端断开连接
-     *
-     * 停止该客户端注册的所有代理服务器，并移除其会话。
-     *
-     * @param clientId - 断开连接的客户端唯一标识 ID
-     */
     private handleDisconnect;
-    /**
-     * 通过 WebSocket 发送消息
-     *
-     * 将消息对象序列化为 JSON 字符串后发送，仅在连接处于 OPEN 状态时发送。
-     *
-     * @param socket - 目标 WebSocket 连接
-     * @param message - 需要发送的消息对象
-     */
     private sendMessage;
-    /**
-     * 发送错误消息
-     *
-     * 构造并发送一条 CONNECTION_ERROR 类型的错误消息给客户端。
-     *
-     * @param socket - 目标 WebSocket 连接
-     * @param error - 错误描述信息
-     */
     private sendError;
-    /**
-     * 处理客户端返回的 HTTP 响应数据
-     *
-     * @param connectionId - 连接唯一标识 ID
-     * @param data - 客户端返回的 HTTP 响应数据
-     */
-    handleClientResponse(connectionId: string, data: any): void;
-    /**
-     * 处理来自客户端的 WebSocket 数据
-     *
-     * @param connectionId - 连接唯一标识 ID
-     * @param data - 客户端发送的数据
-     */
-    handleClientData(connectionId: string, data: Buffer): void;
-    /**
-     * 处理来自客户端的连接关闭请求
-     *
-     * @param connectionId - 需要关闭的连接唯一标识 ID
-     * @param code - 可选的关闭状态码
-     */
-    handleClientClose(connectionId: string, code?: number): void;
-    /**
-     * 处理来自客户端的流式响应数据
-     *
-     * @param connectionId - 连接唯一标识 ID
-     * @param data - 客户端发送的流式数据
-     */
-    handleClientStreamData(connectionId: string, data: Buffer): void;
-    /**
-     * 处理来自客户端的流式响应结束通知
-     *
-     * @param connectionId - 连接唯一标识 ID
-     */
-    handleClientStreamEnd(connectionId: string): void;
 }
 //# sourceMappingURL=control-handler.d.ts.map

package/dist/handlers/control-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/control-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAOL,YAAY,EAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,cAAc;IACd,OAAO,CAAC,cAAc,CAAiB;IACvC,YAAY;IACZ,OAAO,CAAC,MAAM,CAAe;IAC7B,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;;;;OAMG;gBAED,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,mBAAmB;IAOnC;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAqCzC;;;;;;;;;OASG;YACW,aAAa;IA4D3B;;;;;;;;;OASG;YACW,UAAU;IA2CxB;;;;;;;;;;OAUG;YACW,cAAc;IA+D5B;;;;;;;;OAQG;YACW,gBAAgB;IA2B9B;;;;;;;;OAQG;YACW,eAAe;IAO7B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAOjB;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAI3D;;;;;OAKG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1D;;;;;OAKG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;;;;OAKG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhE;;;;OAIG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAGlD"}
+{"version":3,"file":"control-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/control-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAOL,YAAY,EAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAsB;gBAGxC,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,mBAAmB;IAOnC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAiCzC;;;;OAIG;YACW,aAAa;YAsCb,UAAU;YA2CV,cAAc;YA0Dd,gBAAgB;YAuBhB,eAAe;IAO7B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;CAMlB"}