@feng3d/chuantou-shared 0.0.9 → 0.0.11

package/README.md

@@ -1,11 +1,13 @@
 # @feng3d/chuantou-shared
 
-内网穿透转发系统的共享类型定义和消息协议。
+内网穿透转发系统的共享类型定义、消息协议和数据通道帧协议。
 
 ## 特性
 
 - 完整的 TypeScript 类型定义
-- 服务端和客户端通用的消息协议
+- 服务端和客户端通用的 JSON 消息协议（控制通道）
+- 数据通道二进制帧协议（TCP 帧 + UDP 帧）
+- FrameParser 流式帧解析器
 - 代理配置类型
 - 连接管理类型
 
@@ -44,7 +46,28 @@ interface ProxyConfig {
 
 **推荐**：本地地址为 localhost 时推荐省略，使用 `8080:3000` 而非 `8080:3000:localhost`。
 
-每个代理端口同时支持 HTTP 和 WebSocket 协议，无需单独指定协议类型。
+每个代理端口同时支持 HTTP/WebSocket/TCP/UDP 协议，无需单独指定协议类型。
+
+### ConnectionProtocol
+
+连接协议类型：
+
+```typescript
+type ConnectionProtocol = 'http' | 'websocket' | 'tcp' | 'udp';
+```
+
+### ConnectionInfo
+
+连接信息接口：
+
+```typescript
+interface ConnectionInfo {
+  id: string;                  // 连接唯一 ID
+  remoteAddress: string;       // 远程客户端 IP
+  protocol: ConnectionProtocol; // 协议类型
+  createdAt: number;           // 创建时间戳
+}
+```
 
 ### ClientConfig
 
@@ -74,7 +97,9 @@ interface ServerConfig {
 }
 ```
 
-## 消息类型
+## 消息类型（控制通道）
+
+控制通道使用 JSON 消息，通过 WebSocket 传输：
 
 - `AUTH` - 客户端认证
 - `AUTH_RESP` - 认证响应
@@ -83,10 +108,87 @@ interface ServerConfig {
 - `UNREGISTER` - 注销代理服务
 - `HEARTBEAT` - 心跳
 - `HEARTBEAT_RESP` - 心跳响应
-- `NEW_CONNECTION` - 新连接通知
+- `NEW_CONNECTION` - 新连接通知（包含 protocol 字段：`http`/`websocket`/`tcp`/`udp`）
 - `CONNECTION_CLOSE` - 连接关闭通知
 - `CONNECTION_ERROR` - 连接错误通知
 
+## 数据通道帧协议
+
+数据通道使用二进制帧协议，分为 TCP 数据通道和 UDP 数据通道。
+
+### TCP 数据通道
+
+TCP 数据通道用于高效传输 HTTP/WebSocket/TCP 的原始二进制数据。
+
+**认证帧**（客户端 → 服务端，建立连接时发送一次）：
+
+```
+[0xFD][0x01][36 字节 clientId]
+```
+
+**认证响应**（服务端 → 客户端，1 字节）：
+
+```
+0x01 = 成功，0x00 = 失败
+```
+
+**数据帧**（双向传输）：
+
+```
+[4 字节 帧长度 (Big-Endian)][36 字节 connectionId][N 字节 数据]
+```
+
+帧长度 = 36 + N（connectionId 长度 + 数据长度）。
+
+### UDP 数据通道
+
+UDP 数据通道用于保留 UDP 语义的数据转发。
+
+**注册帧**（客户端 → 服务端）：
+
+```
+[0xFD][0x02][36 字节 clientId]
+```
+
+**保活帧**（客户端 → 服务端，每 15 秒发送一次）：
+
+```
+[0xFD][0x03][36 字节 clientId]
+```
+
+**数据帧**（双向传输）：
+
+```
+[36 字节 connectionId][N 字节 数据]
+```
+
+### 相关导出
+
+```typescript
+// TCP 帧函数
+writeTcpAuthFrame(clientId: string): Buffer
+writeDataFrame(connectionId: string, data: Buffer): Buffer
+parseTcpAuthFrame(data: Buffer): string | null
+isDataChannelAuth(data: Buffer): boolean
+
+// UDP 帧函数
+writeUdpRegisterFrame(clientId: string): Buffer
+writeUdpKeepaliveFrame(clientId: string): Buffer
+writeUdpDataFrame(connectionId: string, data: Buffer): Buffer
+parseUdpDataFrame(buffer: Buffer): { connectionId: string; data: Buffer } | null
+parseUdpControlFrame(buffer: Buffer): { type: 'register' | 'keepalive'; clientId: string } | null
+
+// TCP 流式帧解析器
+class FrameParser extends EventEmitter {
+  push(chunk: Buffer): void   // 推入 TCP 数据块
+  reset(): void                // 重置解析器状态
+  // 事件: 'frame' (connectionId: string, data: Buffer)
+}
+
+// 常量
+AUTH_RESPONSE = { SUCCESS: Buffer<[0x01]>, FAILURE: Buffer<[0x00]> }
+```
+
 ## 许可证
 
 ISC

package/dist/data-channel.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @module data-channel
+ *
+ * 二进制数据通道协议定义与工具。
+ *
+ * 定义了 TCP 数据通道和 UDP 数据通道的帧格式、魔数常量，
+ * 以及帧的构建与解析工具，用于在穿透服务端与客户端之间高效传输原始二进制数据。
+ */
+import { EventEmitter } from 'events';
+/** connectionId 的固定长度（UUID v4 字符串 36 字节） */
+export declare const CONNECTION_ID_LENGTH = 36;
+/** clientId 的固定长度（UUID v4 字符串 36 字节） */
+export declare const CLIENT_ID_LENGTH = 36;
+/** 帧长度字段的字节数 */
+export declare const FRAME_LENGTH_SIZE = 4;
+/**
+ * 数据通道魔数常量
+ *
+ * 用于在协议复用时区分不同类型的连接和消息。
+ */
+export declare const DATA_CHANNEL_MAGIC: {
+    /** TCP 数据通道认证握手魔数 */
+    readonly TCP_AUTH: Buffer<ArrayBuffer>;
+    /** UDP 数据通道注册魔数 */
+    readonly UDP_REGISTER: Buffer<ArrayBuffer>;
+    /** UDP 保活魔数 */
+    readonly UDP_KEEPALIVE: Buffer<ArrayBuffer>;
+};
+/** TCP 认证响应 */
+export declare const AUTH_RESPONSE: {
+    readonly SUCCESS: Buffer<ArrayBuffer>;
+    readonly FAILURE: Buffer<ArrayBuffer>;
+};
+/**
+ * 构建 TCP 数据通道认证帧
+ *
+ * @param clientId - 客户端 ID（36 字节 UUID 字符串）
+ * @returns 认证帧 Buffer：[0xFD][0x01][36B clientId]
+ */
+export declare function writeTcpAuthFrame(clientId: string): Buffer;
+/**
+ * 构建 TCP 数据帧
+ *
+ * @param connectionId - 连接 ID（36 字节 UUID 字符串）
+ * @param data - 要发送的原始数据
+ * @returns 数据帧 Buffer：[4B 帧长度 BE][36B connectionId][NB data]
+ */
+export declare function writeDataFrame(connectionId: string, data: Buffer): Buffer;
+/**
+ * TCP 数据帧解析器
+ *
+ * 从 TCP 流中解析二进制数据帧，处理 TCP 粘包/拆包问题。
+ * 当解析出完整帧时触发 `'frame'` 事件。
+ *
+ * @example
+ * ```typescript
+ * const parser = new FrameParser();
+ * parser.on('frame', (connectionId, data) => { ... });
+ * socket.on('data', (chunk) => parser.push(chunk));
+ * ```
+ */
+export declare class FrameParser extends EventEmitter {
+    private buffer;
+    /**
+     * 向解析器推入数据块
+     *
+     * @param chunk - 从 TCP 流接收到的数据块
+     */
+    push(chunk: Buffer): void;
+    private parse;
+    /** 重置解析器状态 */
+    reset(): void;
+}
+/**
+ * 构建 UDP 注册帧
+ *
+ * @param clientId - 客户端 ID
+ * @returns 注册帧 Buffer：[0xFD][0x02][36B clientId]
+ */
+export declare function writeUdpRegisterFrame(clientId: string): Buffer;
+/**
+ * 构建 UDP 保活帧
+ *
+ * @param clientId - 客户端 ID
+ * @returns 保活帧 Buffer：[0xFD][0x03][36B clientId]
+ */
+export declare function writeUdpKeepaliveFrame(clientId: string): Buffer;
+/**
+ * 构建 UDP 数据帧
+ *
+ * @param connectionId - 连接 ID
+ * @param data - 要发送的原始数据
+ * @returns 数据帧 Buffer：[36B connectionId][NB data]
+ */
+export declare function writeUdpDataFrame(connectionId: string, data: Buffer): Buffer;
+/**
+ * 解析 UDP 数据帧
+ *
+ * @param buffer - 收到的 UDP 数据包
+ * @returns 解析后的 connectionId 和数据，或 null（如果是控制帧或格式无效）
+ */
+export declare function parseUdpDataFrame(buffer: Buffer): {
+    connectionId: string;
+    data: Buffer;
+} | null;
+/**
+ * 解析 UDP 控制帧（注册/保活）
+ *
+ * @param buffer - 收到的 UDP 数据包
+ * @returns 解析结果：类型和 clientId，或 null
+ */
+export declare function parseUdpControlFrame(buffer: Buffer): {
+    type: 'register' | 'keepalive';
+    clientId: string;
+} | null;
+/**
+ * 检测 TCP 连接是否为数据通道认证
+ *
+ * 检查数据的前两个字节是否为 TCP 数据通道魔数。
+ *
+ * @param data - TCP 连接的初始数据
+ * @returns 是否为数据通道连接
+ */
+export declare function isDataChannelAuth(data: Buffer): boolean;
+/**
+ * 解析 TCP 数据通道认证帧
+ *
+ * @param data - 初始数据（至少 38 字节：2B 魔数 + 36B clientId）
+ * @returns clientId，或 null
+ */
+export declare function parseTcpAuthFrame(data: Buffer): string | null;
+//# 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;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,wCAAwC;AACxC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;IAC7B,qBAAqB;;IAErB,mBAAmB;;IAEnB,eAAe;;CAEP,CAAC;AAEX,eAAe;AACf,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,MAAM,CAA2B;IAEzC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzB,OAAO,CAAC,KAAK;IAsBb,cAAc;IACd,KAAK,IAAI,IAAI;CAGd;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW/F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchH;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D"}

package/dist/data-channel.js

@@ -0,0 +1,209 @@
+/**
+ * @module data-channel
+ *
+ * 二进制数据通道协议定义与工具。
+ *
+ * 定义了 TCP 数据通道和 UDP 数据通道的帧格式、魔数常量，
+ * 以及帧的构建与解析工具，用于在穿透服务端与客户端之间高效传输原始二进制数据。
+ */
+import { EventEmitter } from 'events';
+/** connectionId 的固定长度（UUID v4 字符串 36 字节） */
+export const CONNECTION_ID_LENGTH = 36;
+/** clientId 的固定长度（UUID v4 字符串 36 字节） */
+export const CLIENT_ID_LENGTH = 36;
+/** 帧长度字段的字节数 */
+export const FRAME_LENGTH_SIZE = 4;
+/**
+ * 数据通道魔数常量
+ *
+ * 用于在协议复用时区分不同类型的连接和消息。
+ */
+export const DATA_CHANNEL_MAGIC = {
+    /** TCP 数据通道认证握手魔数 */
+    TCP_AUTH: Buffer.from([0xFD, 0x01]),
+    /** UDP 数据通道注册魔数 */
+    UDP_REGISTER: Buffer.from([0xFD, 0x02]),
+    /** UDP 保活魔数 */
+    UDP_KEEPALIVE: Buffer.from([0xFD, 0x03]),
+};
+/** TCP 认证响应 */
+export const AUTH_RESPONSE = {
+    SUCCESS: Buffer.from([0x01]),
+    FAILURE: Buffer.from([0x00]),
+};
+/**
+ * 构建 TCP 数据通道认证帧
+ *
+ * @param clientId - 客户端 ID（36 字节 UUID 字符串）
+ * @returns 认证帧 Buffer：[0xFD][0x01][36B clientId]
+ */
+export function writeTcpAuthFrame(clientId) {
+    const buf = Buffer.alloc(2 + CLIENT_ID_LENGTH);
+    DATA_CHANNEL_MAGIC.TCP_AUTH.copy(buf, 0);
+    buf.write(clientId, 2, CLIENT_ID_LENGTH, 'utf-8');
+    return buf;
+}
+/**
+ * 构建 TCP 数据帧
+ *
+ * @param connectionId - 连接 ID（36 字节 UUID 字符串）
+ * @param data - 要发送的原始数据
+ * @returns 数据帧 Buffer：[4B 帧长度 BE][36B connectionId][NB data]
+ */
+export function writeDataFrame(connectionId, data) {
+    const payloadLength = CONNECTION_ID_LENGTH + data.length;
+    const buf = Buffer.alloc(FRAME_LENGTH_SIZE + payloadLength);
+    buf.writeUInt32BE(payloadLength, 0);
+    buf.write(connectionId, FRAME_LENGTH_SIZE, CONNECTION_ID_LENGTH, 'utf-8');
+    data.copy(buf, FRAME_LENGTH_SIZE + CONNECTION_ID_LENGTH);
+    return buf;
+}
+/**
+ * TCP 数据帧解析器
+ *
+ * 从 TCP 流中解析二进制数据帧，处理 TCP 粘包/拆包问题。
+ * 当解析出完整帧时触发 `'frame'` 事件。
+ *
+ * @example
+ * ```typescript
+ * const parser = new FrameParser();
+ * parser.on('frame', (connectionId, data) => { ... });
+ * socket.on('data', (chunk) => parser.push(chunk));
+ * ```
+ */
+export class FrameParser extends EventEmitter {
+    constructor() {
+        super(...arguments);
+        this.buffer = Buffer.alloc(0);
+    }
+    /**
+     * 向解析器推入数据块
+     *
+     * @param chunk - 从 TCP 流接收到的数据块
+     */
+    push(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        this.parse();
+    }
+    parse() {
+        while (true) {
+            // 至少需要 4 字节读取帧长度
+            if (this.buffer.length < FRAME_LENGTH_SIZE)
+                break;
+            const payloadLength = this.buffer.readUInt32BE(0);
+            // 等待完整帧
+            const totalLength = FRAME_LENGTH_SIZE + payloadLength;
+            if (this.buffer.length < totalLength)
+                break;
+            // 解析 connectionId 和数据
+            const connectionId = this.buffer.toString('utf-8', FRAME_LENGTH_SIZE, FRAME_LENGTH_SIZE + CONNECTION_ID_LENGTH);
+            const data = this.buffer.subarray(FRAME_LENGTH_SIZE + CONNECTION_ID_LENGTH, totalLength);
+            this.emit('frame', connectionId, Buffer.from(data));
+            // 移除已解析的帧
+            this.buffer = this.buffer.subarray(totalLength);
+        }
+    }
+    /** 重置解析器状态 */
+    reset() {
+        this.buffer = Buffer.alloc(0);
+    }
+}
+/**
+ * 构建 UDP 注册帧
+ *
+ * @param clientId - 客户端 ID
+ * @returns 注册帧 Buffer：[0xFD][0x02][36B clientId]
+ */
+export function writeUdpRegisterFrame(clientId) {
+    const buf = Buffer.alloc(2 + CLIENT_ID_LENGTH);
+    DATA_CHANNEL_MAGIC.UDP_REGISTER.copy(buf, 0);
+    buf.write(clientId, 2, CLIENT_ID_LENGTH, 'utf-8');
+    return buf;
+}
+/**
+ * 构建 UDP 保活帧
+ *
+ * @param clientId - 客户端 ID
+ * @returns 保活帧 Buffer：[0xFD][0x03][36B clientId]
+ */
+export function writeUdpKeepaliveFrame(clientId) {
+    const buf = Buffer.alloc(2 + CLIENT_ID_LENGTH);
+    DATA_CHANNEL_MAGIC.UDP_KEEPALIVE.copy(buf, 0);
+    buf.write(clientId, 2, CLIENT_ID_LENGTH, 'utf-8');
+    return buf;
+}
+/**
+ * 构建 UDP 数据帧
+ *
+ * @param connectionId - 连接 ID
+ * @param data - 要发送的原始数据
+ * @returns 数据帧 Buffer：[36B connectionId][NB data]
+ */
+export function writeUdpDataFrame(connectionId, data) {
+    const buf = Buffer.alloc(CONNECTION_ID_LENGTH + data.length);
+    buf.write(connectionId, 0, CONNECTION_ID_LENGTH, 'utf-8');
+    data.copy(buf, CONNECTION_ID_LENGTH);
+    return buf;
+}
+/**
+ * 解析 UDP 数据帧
+ *
+ * @param buffer - 收到的 UDP 数据包
+ * @returns 解析后的 connectionId 和数据，或 null（如果是控制帧或格式无效）
+ */
+export function parseUdpDataFrame(buffer) {
+    if (buffer.length < CONNECTION_ID_LENGTH)
+        return null;
+    // 检查是否为控制帧（魔数开头）
+    if (buffer[0] === 0xFD && buffer.length >= 2) {
+        return null; // 控制帧，不是数据帧
+    }
+    const connectionId = buffer.toString('utf-8', 0, CONNECTION_ID_LENGTH);
+    const data = buffer.subarray(CONNECTION_ID_LENGTH);
+    return { connectionId, data: Buffer.from(data) };
+}
+/**
+ * 解析 UDP 控制帧（注册/保活）
+ *
+ * @param buffer - 收到的 UDP 数据包
+ * @returns 解析结果：类型和 clientId，或 null
+ */
+export function parseUdpControlFrame(buffer) {
+    if (buffer.length < 2 + CLIENT_ID_LENGTH)
+        return null;
+    if (buffer[0] !== 0xFD)
+        return null;
+    const clientId = buffer.toString('utf-8', 2, 2 + CLIENT_ID_LENGTH);
+    if (buffer[1] === 0x02) {
+        return { type: 'register', clientId };
+    }
+    if (buffer[1] === 0x03) {
+        return { type: 'keepalive', clientId };
+    }
+    return null;
+}
+/**
+ * 检测 TCP 连接是否为数据通道认证
+ *
+ * 检查数据的前两个字节是否为 TCP 数据通道魔数。
+ *
+ * @param data - TCP 连接的初始数据
+ * @returns 是否为数据通道连接
+ */
+export function isDataChannelAuth(data) {
+    return data.length >= 2 && data[0] === 0xFD && data[1] === 0x01;
+}
+/**
+ * 解析 TCP 数据通道认证帧
+ *
+ * @param data - 初始数据（至少 38 字节：2B 魔数 + 36B clientId）
+ * @returns clientId，或 null
+ */
+export function parseTcpAuthFrame(data) {
+    if (data.length < 2 + CLIENT_ID_LENGTH)
+        return null;
+    if (!isDataChannelAuth(data))
+        return null;
+    return data.toString('utf-8', 2, 2 + CLIENT_ID_LENGTH);
+}
+//# 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/index.d.ts

@@ -12,4 +12,6 @@ export * from './messages.js';
 export * from './protocol.js';
 /** 导出日志工具 */
 export * from './logger.js';
+/** 导出数据通道二进制帧协议工具 */
+export * from './data-channel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,cAAc,eAAe,CAAC;AAC9B,6BAA6B;AAC7B,cAAc,eAAe,CAAC;AAC9B,aAAa;AACb,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,cAAc,eAAe,CAAC;AAC9B,6BAA6B;AAC7B,cAAc,eAAe,CAAC;AAC9B,aAAa;AACb,cAAc,aAAa,CAAC;AAC5B,qBAAqB;AACrB,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -12,4 +12,6 @@ export * from './messages.js';
 export * from './protocol.js';
 /** 导出日志工具 */
 export * from './logger.js';
+/** 导出数据通道二进制帧协议工具 */
+export * from './data-channel.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,cAAc,eAAe,CAAC;AAC9B,6BAA6B;AAC7B,cAAc,eAAe,CAAC;AAC9B,aAAa;AACb,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2BAA2B;AAC3B,cAAc,eAAe,CAAC;AAC9B,6BAA6B;AAC7B,cAAc,eAAe,CAAC;AAC9B,aAAa;AACb,cAAc,aAAa,CAAC;AAC5B,qBAAqB;AACrB,cAAc,mBAAmB,CAAC"}

package/dist/messages.d.ts

@@ -6,12 +6,14 @@
  * 本模块定义了穿透代理系统中客户端与服务端之间通过 WebSocket 控制通道传输的所有消息类型，
  * 包括认证消息、控制消息（注册/注销/心跳）、连接通知消息等，
  * 以及消息的创建、序列化、反序列化和类型守卫等工具函数。
+ *
+ * 注意：实际数据传输已移至独立的二进制 TCP 数据通道和 UDP 数据通道，
+ * WebSocket 控制通道仅用于控制消息。
  */
 /**
  * 消息类型枚举
  *
- * 定义穿透代理协议中所有消息的类型标识，
- * 涵盖认证、控制和连接通知三大类消息。
+ * 定义穿透代理协议中所有控制消息的类型标识。
  */
 export declare enum MessageType {
     /** 客户端发送的认证请求消息 */
@@ -38,9 +40,9 @@ export declare enum MessageType {
 /**
  * 协议类型
  *
- * 穿透代理支持的传输协议类型，可选 HTTP 或 WebSocket。
+ * 穿透代理支持的传输协议类型。
  */
-export type Protocol = 'http' | 'websocket';
+export type Protocol = 'http' | 'websocket' | 'tcp' | 'udp';
 /**
  * 基础消息接口
  *
@@ -72,6 +74,7 @@ export interface AuthMessage extends Message {
  * 认证响应消息
  *
  * 服务端对客户端认证请求的响应，表明认证是否成功。
+ * 认证成功后会包含服务端分配的 clientId，客户端需要用此 ID 建立数据通道。
  */
 export interface AuthRespMessage extends Message {
     /** 消息类型，固定为 {@link MessageType.AUTH_RESP} */
@@ -80,6 +83,8 @@ export interface AuthRespMessage extends Message {
     payload: {
         /** 认证是否成功 */
         success: boolean;
+        /** 服务端分配的客户端 ID（认证成功时返回，用于建立数据通道） */
+        clientId?: string;
         /** 认证失败时的错误描述信息 */
         error?: string;
     };
@@ -88,7 +93,7 @@ export interface AuthRespMessage extends Message {
  * 注册代理服务消息
  *
  * 客户端向服务端请求注册一条代理隧道，指定远程端口到本地服务的映射。
- * 每个端口同时支持 HTTP 和 WebSocket 协议。
+ * 每个端口同时支持 HTTP、WebSocket、TCP 和 UDP 所有协议。
  */
 export interface RegisterMessage extends Message {
     /** 消息类型，固定为 {@link MessageType.REGISTER} */
@@ -165,20 +170,11 @@ export interface HeartbeatRespMessage extends Message {
         timestamp: number;
     };
 }
-/**
- * HTTP 请求头信息
- *
- * 表示 HTTP 请求或响应的头部字段映射，值可以是单个字符串、字符串数组或未定义。
- */
-export interface HttpHeaders {
-    /** HTTP 头部字段，键为头部名称，值为头部内容 */
-    [key: string]: string | string[] | undefined;
-}
 /**
  * 新连接通知消息
  *
- * 当外部用户连接到服务端的代理端口时，服务端向客户端发送此消息通知新连接的到来，
- * 并携带连接的详细信息（HTTP 请求数据或 WebSocket 握手头）。
+ * 当外部用户连接到服务端的代理端口时，服务端向客户端发送此消息通知新连接的到来。
+ * 实际数据传输通过独立的二进制数据通道进行。
  */
 export interface NewConnectionMessage extends Message {
     /** 消息类型，固定为 {@link MessageType.NEW_CONNECTION} */
@@ -189,31 +185,12 @@ export interface NewConnectionMessage extends Message {
         connectionId: string;
         /** 连接使用的传输协议类型 */
         protocol: Protocol;
-        /** HTTP 请求方法（仅 HTTP 协议时存在），如 GET、POST 等 */
-        method?: string;
-        /** HTTP 请求的 URL 路径（仅 HTTP 协议时存在） */
-        url?: string;
-        /** HTTP 请求头（仅 HTTP 协议时存在） */
-        headers?: HttpHeaders;
-        /** HTTP 请求体（仅 HTTP 协议时存在） */
-        body?: string | Buffer;
-        /** WebSocket 握手请求头（仅 WebSocket 协议时存在） */
-        wsHeaders?: HttpHeaders;
+        /** 服务端监听的远程端口号 */
+        remotePort: number;
+        /** 外部客户端的远程地址 */
+        remoteAddress?: string;
     };
 }
-/**
- * HTTP 响应数据
- *
- * 描述一个 HTTP 响应的结构，包含状态码、响应头和可选的响应体。
- */
-export interface HttpResponseData {
-    /** HTTP 响应状态码 */
-    statusCode: number;
-    /** HTTP 响应头 */
-    headers: HttpHeaders;
-    /** HTTP 响应体 */
-    body?: string | Buffer;
-}
 /**
  * 连接关闭消息
  *
@@ -246,8 +223,6 @@ export interface ConnectionErrorMessage extends Message {
 }
 /**
  * 所有消息类型的联合类型
- *
- * 包含穿透代理协议中所有具体消息类型的联合，可用于消息处理函数的参数类型。
  */
 export type AnyMessage = AuthMessage | AuthRespMessage | RegisterMessage | RegisterRespMessage | UnregisterMessage | HeartbeatMessage | HeartbeatRespMessage | NewConnectionMessage | ConnectionCloseMessage | ConnectionErrorMessage;
 /**
@@ -262,9 +237,7 @@ export declare function isMessage(obj: unknown): obj is Message;
 /**
  * 检查消息是否为指定类型
  *
- * 类型守卫函数，判断一条消息是否属于特定的消息类型，并在类型系统中收窄类型。
- *
- * @typeParam T - 目标消息类型，必须是 {@link AnyMessage} 的子类型
+ * @typeParam T - 目标消息类型
  * @param msg - 待检查的消息对象
  * @param type - 期望的消息类型标识
  * @returns 如果消息的 `type` 字段与期望类型匹配则返回 `true`
@@ -274,12 +247,11 @@ export declare function isMessageType<T extends AnyMessage>(msg: Message, type:
  * 创建消息
  *
  * 工厂函数，根据指定的消息类型和负载数据创建一条新的消息实例。
- * 若未提供消息 ID，将自动生成一个唯一 ID。
  *
- * @typeParam T - 目标消息类型（不含 `id` 字段），必须是 {@link AnyMessage} 的子类型
+ * @typeParam T - 目标消息类型
  * @param type - 消息类型标识
  * @param payload - 消息负载数据
- * @param id - 可选的消息唯一标识符，若不提供则自动生成
+ * @param id - 可选的消息唯一标识符
  * @returns 包含完整字段的消息对象
  */
 export declare function createMessage<T extends Omit<AnyMessage, 'id'>>(type: T['type'], payload: T['payload'], id?: string): T & {
@@ -288,16 +260,12 @@ export declare function createMessage<T extends Omit<AnyMessage, 'id'>>(type: T[
 /**
  * 生成消息ID
  *
- * 生成一个格式为 `msg_{timestamp}_{random}` 的唯一消息标识符。
- *
  * @returns 唯一的消息 ID 字符串
  */
 export declare function generateMessageId(): string;
 /**
  * 序列化消息
  *
- * 将消息对象转换为 JSON 字符串，用于通过 WebSocket 发送。
- *
  * @param msg - 要序列化的消息对象
  * @returns 消息的 JSON 字符串表示
  */
@@ -305,9 +273,6 @@ export declare function serializeMessage(msg: Message): string;
 /**
  * 反序列化消息
  *
- * 将 JSON 字符串解析为消息对象。如果字符串不是有效的 JSON 或解析后的对象不符合消息格式，
- * 将抛出错误。
- *
  * @param data - 要反序列化的 JSON 字符串
  * @returns 解析后的消息对象
  * @throws 当 JSON 解析失败或消息格式无效时抛出错误

package/dist/messages.d.ts.map

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

package/dist/messages.js

@@ -6,12 +6,14 @@
  * 本模块定义了穿透代理系统中客户端与服务端之间通过 WebSocket 控制通道传输的所有消息类型，
  * 包括认证消息、控制消息（注册/注销/心跳）、连接通知消息等，
  * 以及消息的创建、序列化、反序列化和类型守卫等工具函数。
+ *
+ * 注意：实际数据传输已移至独立的二进制 TCP 数据通道和 UDP 数据通道，
+ * WebSocket 控制通道仅用于控制消息。
  */
 /**
  * 消息类型枚举
  *
- * 定义穿透代理协议中所有消息的类型标识，
- * 涵盖认证、控制和连接通知三大类消息。
+ * 定义穿透代理协议中所有控制消息的类型标识。
  */
 export var MessageType;
 (function (MessageType) {
@@ -54,9 +56,7 @@ export function isMessage(obj) {
 /**
  * 检查消息是否为指定类型
  *
- * 类型守卫函数，判断一条消息是否属于特定的消息类型，并在类型系统中收窄类型。
- *
- * @typeParam T - 目标消息类型，必须是 {@link AnyMessage} 的子类型
+ * @typeParam T - 目标消息类型
  * @param msg - 待检查的消息对象
  * @param type - 期望的消息类型标识
  * @returns 如果消息的 `type` 字段与期望类型匹配则返回 `true`
@@ -68,12 +68,11 @@ export function isMessageType(msg, type) {
  * 创建消息
  *
  * 工厂函数，根据指定的消息类型和负载数据创建一条新的消息实例。
- * 若未提供消息 ID，将自动生成一个唯一 ID。
  *
- * @typeParam T - 目标消息类型（不含 `id` 字段），必须是 {@link AnyMessage} 的子类型
+ * @typeParam T - 目标消息类型
  * @param type - 消息类型标识
  * @param payload - 消息负载数据
- * @param id - 可选的消息唯一标识符，若不提供则自动生成
+ * @param id - 可选的消息唯一标识符
  * @returns 包含完整字段的消息对象
  */
 export function createMessage(type, payload, id) {
@@ -86,8 +85,6 @@ export function createMessage(type, payload, id) {
 /**
  * 生成消息ID
  *
- * 生成一个格式为 `msg_{timestamp}_{random}` 的唯一消息标识符。
- *
  * @returns 唯一的消息 ID 字符串
  */
 export function generateMessageId() {
@@ -96,8 +93,6 @@ export function generateMessageId() {
 /**
  * 序列化消息
  *
- * 将消息对象转换为 JSON 字符串，用于通过 WebSocket 发送。
- *
  * @param msg - 要序列化的消息对象
  * @returns 消息的 JSON 字符串表示
  */
@@ -107,9 +102,6 @@ export function serializeMessage(msg) {
 /**
  * 反序列化消息
  *
- * 将 JSON 字符串解析为消息对象。如果字符串不是有效的 JSON 或解析后的对象不符合消息格式，
- * 将抛出错误。
- *
  * @param data - 要反序列化的 JSON 字符串
  * @returns 解析后的消息对象
  * @throws 当 JSON 解析失败或消息格式无效时抛出错误

package/dist/messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,WAuBX;AAvBD,WAAY,WAAW;IACrB,mBAAmB;IACnB,4BAAa,CAAA;IACb,mBAAmB;IACnB,sCAAuB,CAAA;IAEvB,qBAAqB;IACrB,oCAAqB,CAAA;IACrB,qBAAqB;IACrB,wCAAyB,CAAA;IACzB,mBAAmB;IACnB,8CAA+B,CAAA;IAC/B,iBAAiB;IACjB,sCAAuB,CAAA;IACvB,mBAAmB;IACnB,gDAAiC,CAAA;IAEjC,oBAAoB;IACpB,gDAAiC,CAAA;IACjC,eAAe;IACf,oDAAqC,CAAA;IACrC,eAAe;IACf,oDAAqC,CAAA;AACvC,CAAC,EAvBW,WAAW,KAAX,WAAW,QAuBtB;AAkPD;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,GAAuB,CAAC;IACpC,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC;AACpE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,IAAe;IAEf,OAAO,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,OAAqB,EACrB,EAAW;IAEX,OAAO;QACL,IAAI;QACJ,EAAE,EAAE,EAAE,IAAI,iBAAiB,EAAE;QAC7B,OAAO;KACc,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAuBX;AAvBD,WAAY,WAAW;IACrB,mBAAmB;IACnB,4BAAa,CAAA;IACb,mBAAmB;IACnB,sCAAuB,CAAA;IAEvB,qBAAqB;IACrB,oCAAqB,CAAA;IACrB,qBAAqB;IACrB,wCAAyB,CAAA;IACzB,mBAAmB;IACnB,8CAA+B,CAAA;IAC/B,iBAAiB;IACjB,sCAAuB,CAAA;IACvB,mBAAmB;IACnB,gDAAiC,CAAA;IAEjC,oBAAoB;IACpB,gDAAiC,CAAA;IACjC,eAAe;IACf,oDAAqC,CAAA;IACrC,eAAe;IACf,oDAAqC,CAAA;AACvC,CAAC,EAvBW,WAAW,KAAX,WAAW,QAuBtB;AAqND;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,GAAuB,CAAC;IACpC,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC;AACpE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAY,EACZ,IAAe;IAEf,OAAO,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,OAAqB,EACrB,EAAW;IAEX,OAAO;QACL,IAAI;QACJ,EAAE,EAAE,EAAE,IAAI,iBAAiB,EAAE;QAC7B,OAAO;KACc,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/protocol.d.ts

@@ -110,11 +110,17 @@ export declare const DEFAULT_CONFIG: {
     /** 数据传输缓冲区大小，单位字节（默认 64KB） */
     readonly BUFFER_SIZE: number;
 };
+/**
+ * 连接协议类型
+ *
+ * 运行时自动检测的传输协议类型。
+ */
+export type ConnectionProtocol = 'http' | 'websocket' | 'tcp' | 'udp';
 /**
  * 代理配置接口
  *
  * 描述单条代理隧道的配置，指定远程端口到本地端口的映射关系。
- * 每个端口同时支持 HTTP 和 WebSocket 协议，无需单独指定。
+ * 每个端口同时支持 HTTP、WebSocket 和 TCP 所有协议。
  */
 export interface ProxyConfig {
     /** 服务端监听的远程端口号，外部用户通过此端口访问代理服务 */
@@ -179,7 +185,7 @@ export interface ConnectionInfo {
     /** 发起连接的远程客户端 IP 地址 */
     remoteAddress: string;
     /** 该连接使用的传输协议类型 */
-    protocol: 'http' | 'websocket';
+    protocol: 'http' | 'websocket' | 'tcp' | 'udp';
     /** 连接建立的时间戳（Unix 毫秒） */
     createdAt: number;
 }

package/dist/protocol.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng3d/chuantou-shared",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,7 +15,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "watch": "tsc --watch"
+    "watch": "tsc --watch --pretty"
   },
   "devDependencies": {
     "typescript": "^5.3.3"