@pixelhue/event-controller-sdk 0.0.1

package/README.md

@@ -0,0 +1,76 @@
+# PixelHue Event Control
+
+Node service for PixelHue Event Control device.
+
+## 项目结构
+
+```
+pixelhue-event-controller-sdk/
+├── src/              # 源代码目录
+│   └── index.ts      # 主文件
+├── dist/             # 编译输出目录 (自动生成)
+├── package.json
+├── tsconfig.json     # TypeScript 配置
+├── jest.config.js    # Jest 测试配置
+├── .eslintrc.js      # ESLint 配置
+├── .prettierrc.json  # Prettier 配置
+├── .editorconfig     # 编辑器配置
+├── .npmrc            # npm 配置
+└── README.md
+```
+
+## 安装依赖
+
+```bash
+yarn install
+# 或简写
+yarn
+```
+
+## 开发
+
+```bash
+yarn start:dev
+
+yarn dev
+
+yarn build
+
+yarn start
+```
+
+## 测试
+
+```bash
+# 运行测试
+yarn test
+
+# 监听模式测试
+yarn test:watch
+
+# 生成覆盖率报告
+yarn test:coverage
+```
+
+## 技术栈
+
+- **TypeScript**: 类型安全的 JavaScript
+- **ES Modules**: 现代模块系统
+- **Jest**: 测试框架
+- **ESLint**: 代码检查
+- **Prettier**: 代码格式化
+
+## 配置文件说明
+
+项目包含以下配置文件，参考了 umi/dumi 项目的最佳实践：
+
+- `.editorconfig`: 统一编辑器配置（缩进、换行符等）
+- `.gitattributes`: Git 文件处理配置（文本/二进制文件处理）
+- `.npmrc`: npm 配置（可配置 registry、lockfile 版本等）
+- `jest.config.js`: Jest 测试框架配置
+- `.eslintrc.js`: ESLint 代码检查配置
+- `.prettierrc.json`: Prettier 代码格式化配置
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PixelHue U5 Mini Event Controller SDK
+ *
+ * 提供 PixelHue U5 Mini 设备的连接管理、设备发现、协议处理等功能
+ */
+export { MiniConnectionManager } from './packages/tcp/ConnectManager.js';
+export { MiniDiscoveryService } from './packages/tcp/discoveryService.js';
+export { ProtocolHandler } from './packages/tcp/protocolHandler.js';
+export { QueueManager, DEFAULT_QUEUE_OPTIONS } from './packages/tcp/QueueManager.js';
+export { SocketWrapper } from './packages/tcp/SocketWrapper.js';
+export { TcpWrapper } from './packages/tcp/tcpWrapper.js';
+export type { SocketConnectOptions, QueueOptions, QueueMetrics, ProtocolHandlerOptions, ProtocolSendPayload, SocketWrapperEvents, ISocketWrapper, ResponseQueueItem, SocketWrapperInstance, RequestIdExtractor, HeartbeatBuilder, HeartbeatResponseChecker, ConnectionManagerEvents, DiscoveryEvents, MiniDeviceInfo, MiniDiscoveredDevice, DiscoveryServiceOptions, } from './packages/tcp/types.js';
+export { QueueOverflowStrategy } from './packages/tcp/types.js';
+export { SUPPORTED_MODELS, DEFAULT_TCP_PORT, DEFAULT_ENABLE_HEARTBEAT, DEFAULT_AUTO_RECONNECT, DEFAULT_HEARTBEAT_INTERVAL, DEFAULT_RECONNECT_INTERVAL, DEFAULT_HEARTBEAT_TIMEOUT, DEFAULT_MAX_RECONNECT_INTERVAL, DEFAULT_ENABLE_EXPONENTIAL_BACKOFF, DEFAULT_MDNS_QUERY_INTERVAL, DEFAULT_MAX_RECONNECT_ATTEMPTS, } from './packages/tcp/constants.js';
+export { parseHost, parsePort } from './packages/tcp/utils.js';
+export type { ProtocolParseResult } from './packages/tcp/protocolHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG1D,YAAY,EACX,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,uBAAuB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,2BAA2B,EAC3B,8BAA8B,GAC9B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAG/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * PixelHue U5 Mini Event Controller SDK
+ *
+ * 提供 PixelHue U5 Mini 设备的连接管理、设备发现、协议处理等功能
+ */
+// 主要类导出
+export { MiniConnectionManager } from './packages/tcp/ConnectManager.js';
+export { MiniDiscoveryService } from './packages/tcp/discoveryService.js';
+export { ProtocolHandler } from './packages/tcp/protocolHandler.js';
+export { QueueManager, DEFAULT_QUEUE_OPTIONS } from './packages/tcp/QueueManager.js';
+export { SocketWrapper } from './packages/tcp/SocketWrapper.js';
+export { TcpWrapper } from './packages/tcp/tcpWrapper.js';
+export { QueueOverflowStrategy } from './packages/tcp/types.js';
+// 常量导出
+export { SUPPORTED_MODELS, DEFAULT_TCP_PORT, DEFAULT_ENABLE_HEARTBEAT, DEFAULT_AUTO_RECONNECT, DEFAULT_HEARTBEAT_INTERVAL, DEFAULT_RECONNECT_INTERVAL, DEFAULT_HEARTBEAT_TIMEOUT, DEFAULT_MAX_RECONNECT_INTERVAL, DEFAULT_ENABLE_EXPONENTIAL_BACKOFF, DEFAULT_MDNS_QUERY_INTERVAL, DEFAULT_MAX_RECONNECT_ATTEMPTS, } from './packages/tcp/constants.js';
+// 工具函数导出
+export { parseHost, parsePort } from './packages/tcp/utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAuB1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO;AACP,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,EAC9B,kCAAkC,EAClC,2BAA2B,EAC3B,8BAA8B,GAC9B,MAAM,6BAA6B,CAAC;AAErC,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["/**\r\n * PixelHue U5 Mini Event Controller SDK\r\n *\r\n * 提供 PixelHue U5 Mini 设备的连接管理、设备发现、协议处理等功能\r\n */\r\n\r\n// 主要类导出\r\nexport { MiniConnectionManager } from './packages/tcp/ConnectManager.js';\r\nexport { MiniDiscoveryService } from './packages/tcp/discoveryService.js';\r\nexport { ProtocolHandler } from './packages/tcp/protocolHandler.js';\r\nexport { QueueManager, DEFAULT_QUEUE_OPTIONS } from './packages/tcp/QueueManager.js';\r\nexport { SocketWrapper } from './packages/tcp/SocketWrapper.js';\r\nexport { TcpWrapper } from './packages/tcp/tcpWrapper.js';\r\n\r\n// 类型导出\r\nexport type {\r\n\tSocketConnectOptions,\r\n\tQueueOptions,\r\n\tQueueMetrics,\r\n\tProtocolHandlerOptions,\r\n\tProtocolSendPayload,\r\n\tSocketWrapperEvents,\r\n\tISocketWrapper,\r\n\tResponseQueueItem,\r\n\tSocketWrapperInstance,\r\n\tRequestIdExtractor,\r\n\tHeartbeatBuilder,\r\n\tHeartbeatResponseChecker,\r\n\tConnectionManagerEvents,\r\n\tDiscoveryEvents,\r\n\tMiniDeviceInfo,\r\n\tMiniDiscoveredDevice,\r\n\tDiscoveryServiceOptions,\r\n} from './packages/tcp/types.js';\r\n\r\nexport { QueueOverflowStrategy } from './packages/tcp/types.js';\r\n\r\n// 常量导出\r\nexport {\r\n\tSUPPORTED_MODELS,\r\n\tDEFAULT_TCP_PORT,\r\n\tDEFAULT_ENABLE_HEARTBEAT,\r\n\tDEFAULT_AUTO_RECONNECT,\r\n\tDEFAULT_HEARTBEAT_INTERVAL,\r\n\tDEFAULT_RECONNECT_INTERVAL,\r\n\tDEFAULT_HEARTBEAT_TIMEOUT,\r\n\tDEFAULT_MAX_RECONNECT_INTERVAL,\r\n\tDEFAULT_ENABLE_EXPONENTIAL_BACKOFF,\r\n\tDEFAULT_MDNS_QUERY_INTERVAL,\r\n\tDEFAULT_MAX_RECONNECT_ATTEMPTS,\r\n} from './packages/tcp/constants.js';\r\n\r\n// 工具函数导出\r\nexport { parseHost, parsePort } from './packages/tcp/utils.js';\r\n\r\n// 协议处理结果类型导出\r\nexport type { ProtocolParseResult } from './packages/tcp/protocolHandler.js';\r\n"]}

package/dist/packages/tcp/ConnectManager.d.ts

@@ -0,0 +1,66 @@
+import { EventEmitter } from 'eventemitter3';
+import type { ConnectionManagerEvents, SocketConnectOptions } from './types.js';
+import { SocketWrapper } from './SocketWrapper.js';
+/**
+ * MINI连接管理器
+ */
+export declare class MiniConnectionManager extends EventEmitter<ConnectionManagerEvents> {
+    /** 连接池 - 每个地址只维护一个连接 */
+    private readonly connections;
+    /** 默认连接选项 */
+    private readonly defaultOptions;
+    /** 标记是否正在销毁，避免销毁过程中触发自动重连 */
+    private isShuttingDown;
+    constructor(options?: Partial<SocketConnectOptions>);
+    /**
+     * 连接到指定设备
+     * @param address 设备地址
+     * @param port 设备端口
+     * @param options 连接选项
+     * @returns Promise<SocketWrapper> Socket包装器
+     */
+    connectTo(address: string, port?: number, options?: Partial<SocketConnectOptions>): Promise<SocketWrapper>;
+    /**
+     * 断开指定设备的连接
+     * @param address 设备地址
+     * @param port 设备端口
+     */
+    disconnectFrom(address: string, port?: number, options?: {
+        autoReconnect?: boolean;
+    }): Promise<void>;
+    /**
+     * 断开所有连接
+     */
+    disconnectAll(): void;
+    /**
+     * 生成连接ID
+     * @param address 设备地址
+     * @param port 设备端口
+     * @returns string
+     */
+    private getConnectionId;
+    /**
+     * 设置Socket事件处理器
+     * @param socketWrapper Socket包装器
+     * @param connectionId 连接ID
+     */
+    private setupSocketEventHandlers;
+    /**
+     * 在发起新连接前，断开现有的其他设备连接，确保同一时间仅保留一个MINI设备连接
+     * 仅当目标设备与已连接设备的地址不同（不同MINI）时，才会执行挤占
+     * @param activeConnectionId 新的连接ID
+     * @param activeAddress 新设备的地址
+     */
+    private preemptOtherConnections;
+    /**
+     * 判断是否为内置设备（127.0.0.1）
+     * @param address 设备地址
+     * @returns boolean
+     */
+    private isBuiltInDevice;
+    /**
+     * 销毁连接管理器
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=ConnectManager.d.ts.map

package/dist/packages/tcp/ConnectManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectManager.d.ts","sourceRoot":"","sources":["../../../src/packages/tcp/ConnectManager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY,CAAC,uBAAuB,CAAC;IAC/E,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAEhE,aAAa;IACb,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAE/D,6BAA6B;IAC7B,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAMnD;;;;;;OAMG;IACG,SAAS,CACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAyB,EAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,OAAO,CAAC,aAAa,CAAC;IA4CzB;;;;OAIG;IACG,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAyB,EAC/B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC;IAqBhB;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA+BhC;;;;;OAKG;YACW,uBAAuB;IA4BrC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK9B"}

package/dist/packages/tcp/ConnectManager.js

@@ -0,0 +1,176 @@
+// ALL_CODE_LINE: 330
+// AI_CODE_LINE: 151
+import { EventEmitter } from 'eventemitter3';
+import { DEFAULT_TCP_PORT } from './constants.js';
+import { SocketWrapper } from './SocketWrapper.js';
+/**
+ * MINI连接管理器
+ */
+export class MiniConnectionManager extends EventEmitter {
+    /** 连接池 - 每个地址只维护一个连接 */
+    connections = new Map();
+    /** 默认连接选项 */
+    defaultOptions;
+    /** 标记是否正在销毁，避免销毁过程中触发自动重连 */
+    isShuttingDown = false;
+    constructor(options) {
+        super();
+        this.defaultOptions = { ...options };
+    }
+    /**
+     * 连接到指定设备
+     * @param address 设备地址
+     * @param port 设备端口
+     * @param options 连接选项
+     * @returns Promise<SocketWrapper> Socket包装器
+     */
+    async connectTo(address, port = DEFAULT_TCP_PORT, options) {
+        const connectionId = this.getConnectionId(address, port);
+        // 检查是否已存在连接（可能是自己之前的连接）
+        if (this.connections.has(connectionId)) {
+            const existingSocketWrapper = this.connections.get(connectionId);
+            if (existingSocketWrapper) {
+                return existingSocketWrapper;
+            }
+        }
+        // 在建立新连接前，主动断开其他设备的连接，实现后来的连接挤占前一个连接
+        await this.preemptOtherConnections(connectionId, address);
+        // 创建Socket包装器
+        const mergedOptions = {
+            ...this.defaultOptions,
+            ...options,
+        };
+        if (this.isBuiltInDevice(address)) {
+            mergedOptions.autoReconnect = true;
+            mergedOptions.maxReconnectAttempts = 0;
+        }
+        // 合并选项，直接使用 SocketConnectOptions
+        const socketOptions = {
+            ...mergedOptions,
+        };
+        const socketWrapper = new SocketWrapper();
+        // 存储连接（在连接前存储，确保事件触发时可获取）
+        this.connections.set(connectionId, socketWrapper);
+        // 设置事件监听
+        this.setupSocketEventHandlers(socketWrapper, connectionId);
+        socketWrapper.connect(address, port, socketOptions);
+        // 返回 SocketWrapper 实例
+        return socketWrapper;
+    }
+    /**
+     * 断开指定设备的连接
+     * @param address 设备地址
+     * @param port 设备端口
+     */
+    async disconnectFrom(address, port = DEFAULT_TCP_PORT, options) {
+        const _autoReconnect = options?.autoReconnect ?? false;
+        // UI 场景下不允许删除内置设备连接，除非明确要求关闭自动重连
+        if (!this.isShuttingDown && !_autoReconnect && this.isBuiltInDevice(address)) {
+            return;
+        }
+        const connectionId = this.getConnectionId(address, port);
+        const socketWrapper = this.connections.get(connectionId);
+        if (socketWrapper) {
+            await socketWrapper.disconnect();
+            this.connections.delete(connectionId);
+            // 触发断开事件，传递 SocketWrapper
+            this.emit('disconnected', socketWrapper);
+        }
+    }
+    /**
+     * 断开所有连接
+     */
+    disconnectAll() {
+        for (const [, socketWrapper] of this.connections) {
+            socketWrapper.disconnect();
+        }
+        this.connections.clear();
+    }
+    /**
+     * 生成连接ID
+     * @param address 设备地址
+     * @param port 设备端口
+     * @returns string
+     */
+    getConnectionId(address, port) {
+        return `${address}:${port}`;
+    }
+    /**
+     * 设置Socket事件处理器
+     * @param socketWrapper Socket包装器
+     * @param connectionId 连接ID
+     */
+    setupSocketEventHandlers(socketWrapper, connectionId) {
+        const tcpWrapper = socketWrapper.getTcpWrapper();
+        socketWrapper.on('connected', () => {
+            // 触发连接事件（包括首次连接和自动重连），传递 SocketWrapper
+            this.emit('connected', socketWrapper);
+        });
+        socketWrapper.on('disconnected', () => {
+            this.emit('disconnected', socketWrapper);
+            // 内置设备：保留实例等待自动重连
+            // 外置设备：删除实例（即使显式启用了自动重连，被动断连时也应该删除）
+            const address = tcpWrapper.getAddress();
+            if (address && !this.isBuiltInDevice(address)) {
+                this.connections.delete(connectionId);
+            }
+        });
+        socketWrapper.on('error', (error) => {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.emit('error', errorMessage, socketWrapper);
+            // 如果重连失败（达到最大次数）或非内置设备连接失败，清理实例
+            // 对于首次连接失败，如果不是内置设备，也会清理
+            const address = tcpWrapper.getAddress();
+            if (address && !this.isBuiltInDevice(address)) {
+                this.connections.delete(connectionId);
+            }
+        });
+    }
+    /**
+     * 在发起新连接前，断开现有的其他设备连接，确保同一时间仅保留一个MINI设备连接
+     * 仅当目标设备与已连接设备的地址不同（不同MINI）时，才会执行挤占
+     * @param activeConnectionId 新的连接ID
+     * @param activeAddress 新设备的地址
+     */
+    async preemptOtherConnections(activeConnectionId, activeAddress) {
+        const targets = Array.from(this.connections.entries()).filter(([connectionId, socketWrapper]) => {
+            const tcpWrapper = socketWrapper.getTcpWrapper();
+            const address = tcpWrapper.getAddress();
+            return connectionId !== activeConnectionId && address !== null && address !== activeAddress;
+        });
+        if (targets.length === 0) {
+            return;
+        }
+        await Promise.all(targets.map(async ([, socketWrapper]) => {
+            const tcpWrapper = socketWrapper.getTcpWrapper();
+            const address = tcpWrapper.getAddress();
+            const port = tcpWrapper.getPort();
+            if (address && port) {
+                try {
+                    await this.disconnectFrom(address, port, { autoReconnect: true });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : 'Unknown error';
+                    this.emit('error', `主动断开旧连接失败(${address}:${port}): ${message}`);
+                }
+            }
+        }));
+    }
+    /**
+     * 判断是否为内置设备（127.0.0.1）
+     * @param address 设备地址
+     * @returns boolean
+     */
+    isBuiltInDevice(address) {
+        return address === '127.0.0.1' || address === '::1' || address === 'localhost';
+    }
+    /**
+     * 销毁连接管理器
+     */
+    async destroy() {
+        this.isShuttingDown = true;
+        await this.disconnectAll();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=ConnectManager.js.map

package/dist/packages/tcp/ConnectManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectManager.js","sourceRoot":"","sources":["../../../src/packages/tcp/ConnectManager.ts"],"names":[],"mappings":"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","sourcesContent":["// ALL_CODE_LINE: 330\r\n// AI_CODE_LINE: 151\r\n\r\nimport { EventEmitter } from 'eventemitter3';\r\nimport type { ConnectionManagerEvents, SocketConnectOptions } from './types.js';\r\nimport { DEFAULT_TCP_PORT } from './constants.js';\r\nimport { SocketWrapper } from './SocketWrapper.js';\r\n\r\n/**\r\n * MINI连接管理器\r\n */\r\nexport class MiniConnectionManager extends EventEmitter<ConnectionManagerEvents> {\r\n\t/** 连接池 - 每个地址只维护一个连接 */\r\n\tprivate readonly connections = new Map<string, SocketWrapper>();\r\n\r\n\t/** 默认连接选项 */\r\n\tprivate readonly defaultOptions: Partial<SocketConnectOptions>;\r\n\r\n\t/** 标记是否正在销毁，避免销毁过程中触发自动重连 */\r\n\tprivate isShuttingDown = false;\r\n\r\n\tconstructor(options?: Partial<SocketConnectOptions>) {\r\n\t\tsuper();\r\n\r\n\t\tthis.defaultOptions = { ...options };\r\n\t}\r\n\r\n\t/**\r\n\t * 连接到指定设备\r\n\t * @param address 设备地址\r\n\t * @param port 设备端口\r\n\t * @param options 连接选项\r\n\t * @returns Promise<SocketWrapper> Socket包装器\r\n\t */\r\n\tasync connectTo(\r\n\t\taddress: string,\r\n\t\tport: number = DEFAULT_TCP_PORT,\r\n\t\toptions?: Partial<SocketConnectOptions>\r\n\t): Promise<SocketWrapper> {\r\n\t\tconst connectionId = this.getConnectionId(address, port);\r\n\r\n\t\t// 检查是否已存在连接（可能是自己之前的连接）\r\n\t\tif (this.connections.has(connectionId)) {\r\n\t\t\tconst existingSocketWrapper = this.connections.get(connectionId);\r\n\t\t\tif (existingSocketWrapper) {\r\n\t\t\t\treturn existingSocketWrapper;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// 在建立新连接前，主动断开其他设备的连接，实现后来的连接挤占前一个连接\r\n\t\tawait this.preemptOtherConnections(connectionId, address);\r\n\r\n\t\t// 创建Socket包装器\r\n\t\tconst mergedOptions = {\r\n\t\t\t...this.defaultOptions,\r\n\t\t\t...options,\r\n\t\t};\r\n\r\n\t\tif (this.isBuiltInDevice(address)) {\r\n\t\t\tmergedOptions.autoReconnect = true;\r\n\t\t\tmergedOptions.maxReconnectAttempts = 0;\r\n\t\t}\r\n\r\n\t\t// 合并选项，直接使用 SocketConnectOptions\r\n\t\tconst socketOptions: SocketConnectOptions = {\r\n\t\t\t...mergedOptions,\r\n\t\t};\r\n\r\n\t\tconst socketWrapper = new SocketWrapper();\r\n\r\n\t\t// 存储连接（在连接前存储，确保事件触发时可获取）\r\n\t\tthis.connections.set(connectionId, socketWrapper);\r\n\r\n\t\t// 设置事件监听\r\n\t\tthis.setupSocketEventHandlers(socketWrapper, connectionId);\r\n\r\n\t\tsocketWrapper.connect(address, port, socketOptions);\r\n\r\n\t\t// 返回 SocketWrapper 实例\r\n\t\treturn socketWrapper;\r\n\t}\r\n\r\n\t/**\r\n\t * 断开指定设备的连接\r\n\t * @param address 设备地址\r\n\t * @param port 设备端口\r\n\t */\r\n\tasync disconnectFrom(\r\n\t\taddress: string,\r\n\t\tport: number = DEFAULT_TCP_PORT,\r\n\t\toptions?: { autoReconnect?: boolean }\r\n\t): Promise<void> {\r\n\t\tconst _autoReconnect = options?.autoReconnect ?? false;\r\n\r\n\t\t// UI 场景下不允许删除内置设备连接，除非明确要求关闭自动重连\r\n\t\tif (!this.isShuttingDown && !_autoReconnect && this.isBuiltInDevice(address)) {\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tconst connectionId = this.getConnectionId(address, port);\r\n\r\n\t\tconst socketWrapper = this.connections.get(connectionId);\r\n\r\n\t\tif (socketWrapper) {\r\n\t\t\tawait socketWrapper.disconnect();\r\n\t\t\tthis.connections.delete(connectionId);\r\n\r\n\t\t\t// 触发断开事件，传递 SocketWrapper\r\n\t\t\tthis.emit('disconnected', socketWrapper);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * 断开所有连接\r\n\t */\r\n\tdisconnectAll(): void {\r\n\t\tfor (const [, socketWrapper] of this.connections) {\r\n\t\t\tsocketWrapper.disconnect();\r\n\t\t}\r\n\r\n\t\tthis.connections.clear();\r\n\t}\r\n\r\n\t/**\r\n\t * 生成连接ID\r\n\t * @param address 设备地址\r\n\t * @param port 设备端口\r\n\t * @returns string\r\n\t */\r\n\tprivate getConnectionId(address: string, port: number): string {\r\n\t\treturn `${address}:${port}`;\r\n\t}\r\n\r\n\t/**\r\n\t * 设置Socket事件处理器\r\n\t * @param socketWrapper Socket包装器\r\n\t * @param connectionId 连接ID\r\n\t */\r\n\tprivate setupSocketEventHandlers(socketWrapper: SocketWrapper, connectionId: string): void {\r\n\t\tconst tcpWrapper = socketWrapper.getTcpWrapper();\r\n\t\tsocketWrapper.on('connected', () => {\r\n\t\t\t// 触发连接事件（包括首次连接和自动重连），传递 SocketWrapper\r\n\t\t\tthis.emit('connected', socketWrapper);\r\n\t\t});\r\n\r\n\t\tsocketWrapper.on('disconnected', () => {\r\n\t\t\tthis.emit('disconnected', socketWrapper);\r\n\r\n\t\t\t// 内置设备：保留实例等待自动重连\r\n\t\t\t// 外置设备：删除实例（即使显式启用了自动重连，被动断连时也应该删除）\r\n\t\t\tconst address = tcpWrapper.getAddress();\r\n\t\t\tif (address && !this.isBuiltInDevice(address)) {\r\n\t\t\t\tthis.connections.delete(connectionId);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tsocketWrapper.on('error', (error: Error) => {\r\n\t\t\tconst errorMessage = error instanceof Error ? error.message : String(error);\r\n\t\t\tthis.emit('error', errorMessage, socketWrapper);\r\n\r\n\t\t\t// 如果重连失败（达到最大次数）或非内置设备连接失败，清理实例\r\n\t\t\t// 对于首次连接失败，如果不是内置设备，也会清理\r\n\t\t\tconst address = tcpWrapper.getAddress();\r\n\t\t\tif (address && !this.isBuiltInDevice(address)) {\r\n\t\t\t\tthis.connections.delete(connectionId);\r\n\t\t\t}\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * 在发起新连接前，断开现有的其他设备连接，确保同一时间仅保留一个MINI设备连接\r\n\t * 仅当目标设备与已连接设备的地址不同（不同MINI）时，才会执行挤占\r\n\t * @param activeConnectionId 新的连接ID\r\n\t * @param activeAddress 新设备的地址\r\n\t */\r\n\tprivate async preemptOtherConnections(activeConnectionId: string, activeAddress: string): Promise<void> {\r\n\t\tconst targets = Array.from(this.connections.entries()).filter(([connectionId, socketWrapper]) => {\r\n\t\t\tconst tcpWrapper = socketWrapper.getTcpWrapper();\r\n\t\t\tconst address = tcpWrapper.getAddress();\r\n\t\t\treturn connectionId !== activeConnectionId && address !== null && address !== activeAddress;\r\n\t\t});\r\n\r\n\t\tif (targets.length === 0) {\r\n\t\t\treturn;\r\n\t\t}\r\n\r\n\t\tawait Promise.all(\r\n\t\t\ttargets.map(async ([, socketWrapper]) => {\r\n\t\t\t\tconst tcpWrapper = socketWrapper.getTcpWrapper();\r\n\t\t\t\tconst address = tcpWrapper.getAddress();\r\n\t\t\t\tconst port = tcpWrapper.getPort();\r\n\t\t\t\tif (address && port) {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tawait this.disconnectFrom(address, port, { autoReconnect: true });\r\n\t\t\t\t\t} catch (error) {\r\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : 'Unknown error';\r\n\t\t\t\t\t\tthis.emit('error', `主动断开旧连接失败(${address}:${port}): ${message}`);\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t})\r\n\t\t);\r\n\t}\r\n\r\n\t/**\r\n\t * 判断是否为内置设备（127.0.0.1）\r\n\t * @param address 设备地址\r\n\t * @returns boolean\r\n\t */\r\n\tprivate isBuiltInDevice(address: string): boolean {\r\n\t\treturn address === '127.0.0.1' || address === '::1' || address === 'localhost';\r\n\t}\r\n\r\n\t/**\r\n\t * 销毁连接管理器\r\n\t */\r\n\tasync destroy(): Promise<void> {\r\n\t\tthis.isShuttingDown = true;\r\n\t\tawait this.disconnectAll();\r\n\t\tthis.removeAllListeners();\r\n\t}\r\n}\r\n"]}

package/dist/packages/tcp/QueueManager.d.ts

@@ -0,0 +1,41 @@
+import type { QueueOptions } from './types.js';
+/**
+ * 默认队列配置
+ */
+export declare const DEFAULT_QUEUE_OPTIONS: Required<QueueOptions>;
+/**
+ * 队列管理器
+ * 负责处理数据队列、去重等功能
+ */
+export declare class QueueManager {
+    private queue;
+    private queueOptions;
+    private processedRequestIds;
+    constructor(queueOptions: Required<QueueOptions>);
+    /**
+     * 添加任务到队列
+     * @param requestId 请求ID
+     * @param data 数据
+     * @param processor 处理函数
+     * @param onError 错误处理函数
+     * @param cachedParseResult 已解析的结果（可选，用于避免重复解析）
+     */
+    addToQueue(requestId: number, data: Buffer, processor: (requestId: number, data: Buffer, cachedParseResult?: any) => Promise<void>, onError?: (error: Error, requestId: number) => void, cachedParseResult?: any): void;
+    /**
+     * 检查是否可以添加到队列
+     */
+    canAdd(): boolean;
+    /**
+     * 检查是否已处理过（去重）
+     */
+    isProcessed(requestId: number): boolean;
+    /**
+     * 处理队列溢出
+     */
+    handleOverflow(requestId: number, data: Buffer, processor: (requestId: number, data: Buffer, cachedParseResult?: any) => Promise<void>, onError: (error: Error, requestId: number) => void, cachedParseResult?: any): void;
+    /**
+     * 清空队列
+     */
+    clear(): void;
+}
+//# sourceMappingURL=QueueManager.d.ts.map

package/dist/packages/tcp/QueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueManager.d.ts","sourceRoot":"","sources":["../../../src/packages/tcp/QueueManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAOxD,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,mBAAmB,CAA0B;gBAEzC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC;IAUhD;;;;;;;OAOG;IACH,UAAU,CACT,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACtF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,EACnD,iBAAiB,CAAC,EAAE,GAAG,GACrB,IAAI;IAuBP;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,cAAc,CACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,EACtF,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,EAClD,iBAAiB,CAAC,EAAE,GAAG,GACrB,IAAI;IAkBP;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb"}

package/dist/packages/tcp/QueueManager.js

@@ -0,0 +1,102 @@
+// ALL_CODE_LINE: 120
+// AI_CODE_LINE: 2
+import PQueue from 'p-queue';
+import { QueueOverflowStrategy } from './types.js';
+/**
+ * 默认队列配置
+ */
+export const DEFAULT_QUEUE_OPTIONS = {
+    /** 最大队列长度，默认 1000 */
+    maxLength: 1000,
+    /** 溢出策略*/
+    overflowStrategy: QueueOverflowStrategy.DROP_OLDEST,
+    /** 单条数据处理超时时间（毫秒），默认 5000 */
+    processTimeout: 5000,
+};
+/**
+ * 队列管理器
+ * 负责处理数据队列、去重等功能
+ */
+export class QueueManager {
+    queue;
+    queueOptions;
+    processedRequestIds = new Set();
+    constructor(queueOptions) {
+        this.queueOptions = queueOptions;
+        // 初始化 p-queue
+        this.queue = new PQueue({
+            concurrency: 1, // 串行处理，保证顺序
+            timeout: this.queueOptions.processTimeout,
+        });
+    }
+    /**
+     * 添加任务到队列
+     * @param requestId 请求ID
+     * @param data 数据
+     * @param processor 处理函数
+     * @param onError 错误处理函数
+     * @param cachedParseResult 已解析的结果（可选，用于避免重复解析）
+     */
+    addToQueue(requestId, data, processor, onError, cachedParseResult) {
+        this.queue
+            .add(async () => {
+            try {
+                // 处理队列项
+                await processor(requestId, data, cachedParseResult);
+                // 去重标记
+                this.processedRequestIds.add(requestId);
+                // 限制去重集合大小，防止内存泄漏
+                if (this.processedRequestIds.size > this.queueOptions.maxLength * 2) {
+                    this.processedRequestIds.clear();
+                }
+            }
+            catch (error) {
+                throw error; // 重新抛出，让 p-queue 处理
+            }
+        })
+            .catch((error) => {
+            // p-queue 的超时错误会在这里捕获
+            onError?.(error, requestId);
+        });
+    }
+    /**
+     * 检查是否可以添加到队列
+     */
+    canAdd() {
+        return this.queue.size < this.queueOptions.maxLength;
+    }
+    /**
+     * 检查是否已处理过（去重）
+     */
+    isProcessed(requestId) {
+        return this.processedRequestIds.has(requestId);
+    }
+    /**
+     * 处理队列溢出
+     */
+    handleOverflow(requestId, data, processor, onError, cachedParseResult) {
+        switch (this.queueOptions.overflowStrategy) {
+            case QueueOverflowStrategy.DROP_NEWEST:
+                // 丢弃最新数据
+                break;
+            case QueueOverflowStrategy.REJECT:
+                // 拒绝新数据并触发错误
+                const error = new Error(`Queue overflow: max length ${this.queueOptions.maxLength} reached`);
+                onError(error, requestId);
+                break;
+            case QueueOverflowStrategy.DROP_OLDEST:
+            default:
+                // p-queue 不支持直接丢弃最旧的任务
+                this.addToQueue(requestId, data, processor, onError, cachedParseResult);
+                break;
+        }
+    }
+    /**
+     * 清空队列
+     */
+    clear() {
+        this.queue.clear();
+        this.processedRequestIds.clear();
+    }
+}
+//# sourceMappingURL=QueueManager.js.map

package/dist/packages/tcp/QueueManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueManager.js","sourceRoot":"","sources":["../../../src/packages/tcp/QueueManager.ts"],"names":[],"mappings":"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","sourcesContent":["// ALL_CODE_LINE: 120\r\n// AI_CODE_LINE: 2\r\nimport PQueue from 'p-queue';\r\nimport type { QueueOptions } from './types.js';\r\nimport { QueueOverflowStrategy } from './types.js';\r\n\r\n/**\r\n * 默认队列配置\r\n */\r\nexport const DEFAULT_QUEUE_OPTIONS: Required<QueueOptions> = {\r\n\t/** 最大队列长度，默认 1000 */\r\n\tmaxLength: 1000,\r\n\t/** 溢出策略*/\r\n\toverflowStrategy: QueueOverflowStrategy.DROP_OLDEST,\r\n\t/** 单条数据处理超时时间（毫秒），默认 5000 */\r\n\tprocessTimeout: 5000,\r\n};\r\n\r\n/**\r\n * 队列管理器\r\n * 负责处理数据队列、去重等功能\r\n */\r\nexport class QueueManager {\r\n\tprivate queue: PQueue;\r\n\tprivate queueOptions: Required<QueueOptions>;\r\n\tprivate processedRequestIds: Set<number> = new Set();\r\n\r\n\tconstructor(queueOptions: Required<QueueOptions>) {\r\n\t\tthis.queueOptions = queueOptions;\r\n\r\n\t\t// 初始化 p-queue\r\n\t\tthis.queue = new PQueue({\r\n\t\t\tconcurrency: 1, // 串行处理，保证顺序\r\n\t\t\ttimeout: this.queueOptions.processTimeout,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * 添加任务到队列\r\n\t * @param requestId 请求ID\r\n\t * @param data 数据\r\n\t * @param processor 处理函数\r\n\t * @param onError 错误处理函数\r\n\t * @param cachedParseResult 已解析的结果（可选，用于避免重复解析）\r\n\t */\r\n\taddToQueue(\r\n\t\trequestId: number,\r\n\t\tdata: Buffer,\r\n\t\tprocessor: (requestId: number, data: Buffer, cachedParseResult?: any) => Promise<void>,\r\n\t\tonError?: (error: Error, requestId: number) => void,\r\n\t\tcachedParseResult?: any\r\n\t): void {\r\n\t\tthis.queue\r\n\t\t\t.add(async () => {\r\n\t\t\t\ttry {\r\n\t\t\t\t\t// 处理队列项\r\n\t\t\t\t\tawait processor(requestId, data, cachedParseResult);\r\n\r\n\t\t\t\t\t// 去重标记\r\n\t\t\t\t\tthis.processedRequestIds.add(requestId);\r\n\t\t\t\t\t// 限制去重集合大小，防止内存泄漏\r\n\t\t\t\t\tif (this.processedRequestIds.size > this.queueOptions.maxLength * 2) {\r\n\t\t\t\t\t\tthis.processedRequestIds.clear();\r\n\t\t\t\t\t}\r\n\t\t\t\t} catch (error) {\r\n\t\t\t\t\tthrow error; // 重新抛出，让 p-queue 处理\r\n\t\t\t\t}\r\n\t\t\t})\r\n\t\t\t.catch((error) => {\r\n\t\t\t\t// p-queue 的超时错误会在这里捕获\r\n\t\t\t\tonError?.(error, requestId);\r\n\t\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * 检查是否可以添加到队列\r\n\t */\r\n\tcanAdd(): boolean {\r\n\t\treturn this.queue.size < this.queueOptions.maxLength;\r\n\t}\r\n\r\n\t/**\r\n\t * 检查是否已处理过（去重）\r\n\t */\r\n\tisProcessed(requestId: number): boolean {\r\n\t\treturn this.processedRequestIds.has(requestId);\r\n\t}\r\n\r\n\t/**\r\n\t * 处理队列溢出\r\n\t */\r\n\thandleOverflow(\r\n\t\trequestId: number,\r\n\t\tdata: Buffer,\r\n\t\tprocessor: (requestId: number, data: Buffer, cachedParseResult?: any) => Promise<void>,\r\n\t\tonError: (error: Error, requestId: number) => void,\r\n\t\tcachedParseResult?: any\r\n\t): void {\r\n\t\tswitch (this.queueOptions.overflowStrategy) {\r\n\t\t\tcase QueueOverflowStrategy.DROP_NEWEST:\r\n\t\t\t\t// 丢弃最新数据\r\n\t\t\t\tbreak;\r\n\t\t\tcase QueueOverflowStrategy.REJECT:\r\n\t\t\t\t// 拒绝新数据并触发错误\r\n\t\t\t\tconst error = new Error(`Queue overflow: max length ${this.queueOptions.maxLength} reached`);\r\n\t\t\t\tonError(error, requestId);\r\n\t\t\t\tbreak;\r\n\t\t\tcase QueueOverflowStrategy.DROP_OLDEST:\r\n\t\t\tdefault:\r\n\t\t\t\t// p-queue 不支持直接丢弃最旧的任务\r\n\t\t\t\tthis.addToQueue(requestId, data, processor, onError, cachedParseResult);\r\n\t\t\t\tbreak;\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * 清空队列\r\n\t */\r\n\tclear(): void {\r\n\t\tthis.queue.clear();\r\n\t\tthis.processedRequestIds.clear();\r\n\t}\r\n}\r\n"]}