@pixelhue/event-controller-sdk 0.0.1

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

@@ -0,0 +1,232 @@
+import { EventEmitter } from 'events';
+import type { SocketWrapper } from './SocketWrapper.js';
+/**
+ * 连接选项
+ */
+export interface SocketConnectOptions {
+    /** 服务器主机地址 */
+    host?: string;
+    /** 服务器端口号 */
+    port?: number;
+    /** 是否启用自动重连，默认 false */
+    autoReconnect?: boolean;
+    /** 重连间隔（毫秒），默认 5000 */
+    reconnectInterval?: number;
+    /** 是否启用心跳，默认 true */
+    enableHeartbeat?: boolean;
+    /** 心跳间隔（毫秒），默认 5000（5秒） */
+    heartbeatInterval?: number;
+    /** 心跳超时时间（毫秒），默认 5000（5秒），如果心跳发送后超过此时间未收到响应则关闭连接 */
+    heartbeatTimeout?: number;
+    /** 最大重连次数，默认 0 表示无限制 */
+    maxReconnectAttempts?: number;
+    /** 是否启用指数退避（重连间隔逐渐增加），默认 false */
+    enableExponentialBackoff?: boolean;
+    /** 指数退避的最大间隔（毫秒），默认 60000（60秒） */
+    maxReconnectInterval?: number;
+}
+/**
+ * 队列配置选项
+ */
+export interface QueueOptions {
+    /** 最大队列长度，默认 1000 */
+    maxLength?: number;
+    /** 溢出策略 */
+    overflowStrategy?: 'drop-oldest' | 'drop-newest' | 'reject';
+    /** 单条数据处理超时时间（毫秒），默认 5000 */
+    processTimeout?: number;
+}
+/**
+ * 队列溢出策略
+ */
+export declare enum QueueOverflowStrategy {
+    /** 丢弃最旧的数据 */
+    DROP_OLDEST = "drop-oldest",
+    /** 丢弃最新的数据 */
+    DROP_NEWEST = "drop-newest",
+    /** 拒绝新数据并触发错误 */
+    REJECT = "reject"
+}
+/**
+ * 队列监控指标
+ */
+export interface QueueMetrics {
+    /** 总处理数量 */
+    totalProcessed: number;
+    /** 总错误数量 */
+    totalErrors: number;
+    /** 总丢弃数量 */
+    totalDropped: number;
+    /** 当前队列长度 */
+    currentLength: number;
+    /** 最大队列长度 */
+    maxLength: number;
+    /** 平均处理时间（毫秒） */
+    averageProcessTime: number;
+    /** 峰值长度 */
+    peakLength: number;
+    /** 最后处理时间戳 */
+    lastProcessTime: number;
+}
+/**
+ * 协议处理选项
+ */
+export interface ProtocolHandlerOptions {
+    /** 是否启用协议解析（接收时自动解析） */
+    enableParsing?: boolean;
+    /** 是否启用协议构建（发送时自动构建） */
+    enableBuilding?: boolean;
+    /** 解析选项 */
+    parseOptions?: any;
+    /** 默认构建选项 */
+    defaultBuildOptions?: any;
+}
+/**
+ * 协议构建发送负载，用于统一的 send 接口
+ */
+export interface ProtocolSendPayload {
+    /** 协议业务数据（TLV2 部分或等效结构） */
+    data: any;
+    /** 协议头数据（TLV1 部分，可选） */
+    header?: any;
+    /** 协议构建选项（会与默认构建选项合并） */
+    options?: any;
+    /** 是否作为响应包发送（部分协议需要显式设置） */
+    isResponse?: boolean;
+}
+/**
+ * 事件类型定义
+ */
+export interface SocketWrapperEvents {
+    /** 连接成功时触发 */
+    connected: () => void;
+    /** 连接断开时触发（自动重连时会触发） */
+    disconnected: () => void;
+    /** 接收到数据时触发（原始数据） */
+    data: (data: Buffer, requestId: number) => void;
+    /** 接收到协议数据时触发（已解析） */
+    protocolData: (result: any, requestId: number) => void;
+    /** 发生错误时触发 */
+    error: (error: Error, requestId?: number) => void;
+    /** 连接关闭时触发 */
+    close: () => void;
+}
+/**
+ * SocketWrapper 接口
+ * 注意：on/emit/off/once 方法由 EventEmitter 继承提供，无需在接口中声明
+ */
+export interface ISocketWrapper {
+    /**
+     * 连接到服务器
+     * @param host - 服务器主机地址
+     * @param port - 服务器端口号
+     * @param options - 连接选项
+     */
+    connect(host: string, port: number, options: SocketConnectOptions): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 发送数据或协议包
+     * @param payload - 原始 Buffer 或协议负载对象
+     * @param requestId - 当发送原始 Buffer 时必须提供请求 ID
+     * @returns 实际发送所使用的请求 ID
+     */
+    send(payload: Buffer | ProtocolSendPayload): void;
+    /**
+     * 检查是否已连接
+     * @returns 如果已连接返回 true，否则返回 false
+     */
+    isConnected(): boolean;
+    /**
+     * 主动触发 error 事件
+     * 用于外部主动报告错误，例如业务逻辑错误、数据验证错误等
+     * @param error 错误对象
+     * @param requestId 可选的请求ID，用于关联特定的请求
+     */
+    emitError(error: Error, requestId?: number): void;
+}
+/**
+ * 内部响应队列项类型
+ */
+export interface ResponseQueueItem {
+    /** 请求 ID */
+    requestId: number;
+    /** 响应数据 */
+    data: Buffer;
+}
+/**
+ * SocketWrapper 实例类型
+ */
+export type SocketWrapperInstance = ISocketWrapper & EventEmitter;
+/**
+ * requestId 提取函数类型
+ * 用于从接收到的数据中提取 requestId
+ * @param data - 接收到的数据缓冲区
+ * @returns 提取的 requestId (seqId)
+ */
+export type RequestIdExtractor = (data: Buffer) => number;
+/**
+ * 心跳包构建函数类型
+ * @returns 心跳包数据
+ */
+export type HeartbeatBuilder = () => Buffer;
+/**
+ * 心跳响应识别函数类型
+ * @param data 接收到的数据
+ * @returns 是否为心跳响应
+ */
+export type HeartbeatResponseChecker = (data: Buffer) => boolean;
+/**
+ * 连接管理器事件类型
+ */
+export interface ConnectionManagerEvents {
+    /** 连接成功时触发 */
+    connected: (socketWrapper: SocketWrapper) => void;
+    /** 连接断开时触发 */
+    disconnected: (socketWrapper: SocketWrapper) => void;
+    /** 发生错误时触发 */
+    error: (error: string, socketWrapper?: SocketWrapper) => void;
+}
+/**
+ * 设备发现事件
+ */
+export interface DiscoveryEvents {
+    up: [device: MiniDiscoveredDevice];
+    down: [device: MiniDiscoveredDevice];
+}
+/**
+ * 设备信息接口
+ */
+export interface MiniDeviceInfo {
+    serialNumber: string;
+    version: string;
+    model?: string;
+    modelName?: string;
+    keyLayout: {
+        rows: number;
+        columns: number;
+    };
+}
+/**
+ * 发现的设备信息
+ */
+export interface MiniDiscoveredDevice extends MiniDeviceInfo {
+    address: string;
+    port: number;
+    name: string;
+    lastSeen: Date;
+}
+/**
+ * 设备发现服务选项
+ */
+export interface DiscoveryServiceOptions {
+    /** 查询间隔（毫秒） */
+    queryInterval?: number;
+    /** 服务类型 */
+    type?: string;
+    /** 服务协议 */
+    protocol?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/packages/tcp/types.js

@@ -0,0 +1,13 @@
+/**
+ * 队列溢出策略
+ */
+export var QueueOverflowStrategy;
+(function (QueueOverflowStrategy) {
+    /** 丢弃最旧的数据 */
+    QueueOverflowStrategy["DROP_OLDEST"] = "drop-oldest";
+    /** 丢弃最新的数据 */
+    QueueOverflowStrategy["DROP_NEWEST"] = "drop-newest";
+    /** 拒绝新数据并触发错误 */
+    QueueOverflowStrategy["REJECT"] = "reject";
+})(QueueOverflowStrategy || (QueueOverflowStrategy = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/packages/tcp/types.ts"],"names":[],"mappings":"AA2CA;;GAEG;AACH,MAAM,CAAN,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAChC,cAAc;IACd,oDAA2B,CAAA;IAC3B,cAAc;IACd,oDAA2B,CAAA;IAC3B,iBAAiB;IACjB,0CAAiB,CAAA;AAClB,CAAC,EAPW,qBAAqB,KAArB,qBAAqB,QAOhC","sourcesContent":["// ALL_CODE_LINE: 243\r\n// AI_CODE_LINE: 44\r\nimport { EventEmitter } from 'events';\r\nimport type { SocketWrapper } from './SocketWrapper.js';\r\n\r\n/**\r\n * 连接选项\r\n */\r\nexport interface SocketConnectOptions {\r\n\t/** 服务器主机地址 */\r\n\thost?: string;\r\n\t/** 服务器端口号 */\r\n\tport?: number;\r\n\t/** 是否启用自动重连，默认 false */\r\n\tautoReconnect?: boolean;\r\n\t/** 重连间隔（毫秒），默认 5000 */\r\n\treconnectInterval?: number;\r\n\t/** 是否启用心跳，默认 true */\r\n\tenableHeartbeat?: boolean;\r\n\t/** 心跳间隔（毫秒），默认 5000（5秒） */\r\n\theartbeatInterval?: number;\r\n\t/** 心跳超时时间（毫秒），默认 5000（5秒），如果心跳发送后超过此时间未收到响应则关闭连接 */\r\n\theartbeatTimeout?: number;\r\n\t/** 最大重连次数，默认 0 表示无限制 */\r\n\tmaxReconnectAttempts?: number;\r\n\t/** 是否启用指数退避（重连间隔逐渐增加），默认 false */\r\n\tenableExponentialBackoff?: boolean;\r\n\t/** 指数退避的最大间隔（毫秒），默认 60000（60秒） */\r\n\tmaxReconnectInterval?: number;\r\n}\r\n\r\n/**\r\n * 队列配置选项\r\n */\r\nexport interface QueueOptions {\r\n\t/** 最大队列长度，默认 1000 */\r\n\tmaxLength?: number;\r\n\t/** 溢出策略 */\r\n\toverflowStrategy?: 'drop-oldest' | 'drop-newest' | 'reject';\r\n\t/** 单条数据处理超时时间（毫秒），默认 5000 */\r\n\tprocessTimeout?: number;\r\n}\r\n\r\n/**\r\n * 队列溢出策略\r\n */\r\nexport enum QueueOverflowStrategy {\r\n\t/** 丢弃最旧的数据 */\r\n\tDROP_OLDEST = 'drop-oldest',\r\n\t/** 丢弃最新的数据 */\r\n\tDROP_NEWEST = 'drop-newest',\r\n\t/** 拒绝新数据并触发错误 */\r\n\tREJECT = 'reject',\r\n}\r\n\r\n/**\r\n * 队列监控指标\r\n */\r\nexport interface QueueMetrics {\r\n\t/** 总处理数量 */\r\n\ttotalProcessed: number;\r\n\t/** 总错误数量 */\r\n\ttotalErrors: number;\r\n\t/** 总丢弃数量 */\r\n\ttotalDropped: number;\r\n\t/** 当前队列长度 */\r\n\tcurrentLength: number;\r\n\t/** 最大队列长度 */\r\n\tmaxLength: number;\r\n\t/** 平均处理时间（毫秒） */\r\n\taverageProcessTime: number;\r\n\t/** 峰值长度 */\r\n\tpeakLength: number;\r\n\t/** 最后处理时间戳 */\r\n\tlastProcessTime: number;\r\n}\r\n\r\n/**\r\n * 协议处理选项\r\n */\r\nexport interface ProtocolHandlerOptions {\r\n\t/** 是否启用协议解析（接收时自动解析） */\r\n\tenableParsing?: boolean;\r\n\t/** 是否启用协议构建（发送时自动构建） */\r\n\tenableBuilding?: boolean;\r\n\t/** 解析选项 */\r\n\tparseOptions?: any;\r\n\t/** 默认构建选项 */\r\n\tdefaultBuildOptions?: any;\r\n}\r\n\r\n/**\r\n * 协议构建发送负载，用于统一的 send 接口\r\n */\r\nexport interface ProtocolSendPayload {\r\n\t/** 协议业务数据（TLV2 部分或等效结构） */\r\n\tdata: any;\r\n\t/** 协议头数据（TLV1 部分，可选） */\r\n\theader?: any;\r\n\t/** 协议构建选项（会与默认构建选项合并） */\r\n\toptions?: any;\r\n\t/** 是否作为响应包发送（部分协议需要显式设置） */\r\n\tisResponse?: boolean;\r\n}\r\n\r\n/**\r\n * 事件类型定义\r\n */\r\nexport interface SocketWrapperEvents {\r\n\t/** 连接成功时触发 */\r\n\tconnected: () => void;\r\n\t/** 连接断开时触发（自动重连时会触发） */\r\n\tdisconnected: () => void;\r\n\t/** 接收到数据时触发（原始数据） */\r\n\tdata: (data: Buffer, requestId: number) => void;\r\n\t/** 接收到协议数据时触发（已解析） */\r\n\tprotocolData: (result: any, requestId: number) => void;\r\n\t/** 发生错误时触发 */\r\n\terror: (error: Error, requestId?: number) => void;\r\n\t/** 连接关闭时触发 */\r\n\tclose: () => void;\r\n}\r\n\r\n/**\r\n * SocketWrapper 接口\r\n * 注意：on/emit/off/once 方法由 EventEmitter 继承提供，无需在接口中声明\r\n */\r\nexport interface ISocketWrapper {\r\n\t/**\r\n\t * 连接到服务器\r\n\t * @param host - 服务器主机地址\r\n\t * @param port - 服务器端口号\r\n\t * @param options - 连接选项\r\n\t */\r\n\tconnect(host: string, port: number, options: SocketConnectOptions): void;\r\n\t/**\r\n\t * 断开连接\r\n\t */\r\n\tdisconnect(): void;\r\n\r\n\t/**\r\n\t * 发送数据或协议包\r\n\t * @param payload - 原始 Buffer 或协议负载对象\r\n\t * @param requestId - 当发送原始 Buffer 时必须提供请求 ID\r\n\t * @returns 实际发送所使用的请求 ID\r\n\t */\r\n\tsend(payload: Buffer | ProtocolSendPayload): void;\r\n\r\n\t/**\r\n\t * 检查是否已连接\r\n\t * @returns 如果已连接返回 true，否则返回 false\r\n\t */\r\n\tisConnected(): boolean;\r\n\r\n\t/**\r\n\t * 主动触发 error 事件\r\n\t * 用于外部主动报告错误，例如业务逻辑错误、数据验证错误等\r\n\t * @param error 错误对象\r\n\t * @param requestId 可选的请求ID，用于关联特定的请求\r\n\t */\r\n\temitError(error: Error, requestId?: number): void;\r\n}\r\n\r\n/**\r\n * 内部响应队列项类型\r\n */\r\nexport interface ResponseQueueItem {\r\n\t/** 请求 ID */\r\n\trequestId: number;\r\n\t/** 响应数据 */\r\n\tdata: Buffer;\r\n}\r\n\r\n/**\r\n * SocketWrapper 实例类型\r\n */\r\nexport type SocketWrapperInstance = ISocketWrapper & EventEmitter;\r\n\r\n/**\r\n * requestId 提取函数类型\r\n * 用于从接收到的数据中提取 requestId\r\n * @param data - 接收到的数据缓冲区\r\n * @returns 提取的 requestId (seqId)\r\n */\r\nexport type RequestIdExtractor = (data: Buffer) => number;\r\n\r\n/**\r\n * 心跳包构建函数类型\r\n * @returns 心跳包数据\r\n */\r\nexport type HeartbeatBuilder = () => Buffer;\r\n\r\n/**\r\n * 心跳响应识别函数类型\r\n * @param data 接收到的数据\r\n * @returns 是否为心跳响应\r\n */\r\nexport type HeartbeatResponseChecker = (data: Buffer) => boolean;\r\n\r\n/**\r\n * 连接管理器事件类型\r\n */\r\nexport interface ConnectionManagerEvents {\r\n\t/** 连接成功时触发 */\r\n\tconnected: (socketWrapper: SocketWrapper) => void;\r\n\t/** 连接断开时触发 */\r\n\tdisconnected: (socketWrapper: SocketWrapper) => void;\r\n\t/** 发生错误时触发 */\r\n\terror: (error: string, socketWrapper?: SocketWrapper) => void;\r\n}\r\n\r\n/**\r\n * 设备发现事件\r\n */\r\nexport interface DiscoveryEvents {\r\n\t// 兼容 tcp 包的事件命名\r\n\tup: [device: MiniDiscoveredDevice];\r\n\tdown: [device: MiniDiscoveredDevice];\r\n}\r\n\r\n/**\r\n * 设备信息接口\r\n */\r\nexport interface MiniDeviceInfo {\r\n\tserialNumber: string; // 设备序列号，唯一标识设备\r\n\tversion: string; // 固件版本号\r\n\tmodel?: string; // 设备型号代码\r\n\tmodelName?: string; // 设备型号名称\r\n\tkeyLayout: { rows: number; columns: number }; // 按键布局（行数和列数）\r\n}\r\n\r\n/**\r\n * 发现的设备信息\r\n */\r\nexport interface MiniDiscoveredDevice extends MiniDeviceInfo {\r\n\taddress: string;\r\n\tport: number;\r\n\tname: string;\r\n\tlastSeen: Date;\r\n}\r\n\r\n/**\r\n * 设备发现服务选项\r\n */\r\nexport interface DiscoveryServiceOptions {\r\n\t/** 查询间隔（毫秒） */\r\n\tqueryInterval?: number;\r\n\t/** 服务类型 */\r\n\ttype?: string;\r\n\t/** 服务协议 */\r\n\tprotocol?: string;\r\n}\r\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * 工具函数
+ */
+/**
+ * 从 URL 解析主机地址
+ * @param url 连接地址
+ */
+export declare function parseHost(url: string): string | null;
+/**
+ * 从 URL 解析端口
+ * @param url 连接地址
+ */
+export declare function parsePort(url: string): number | null;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/packages/tcp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAepD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBpD"}

package/dist/packages/tcp/utils.js

@@ -0,0 +1,47 @@
+/**
+ * 工具函数
+ */
+/**
+ * 从 URL 解析主机地址
+ * @param url 连接地址
+ */
+export function parseHost(url) {
+    try {
+        // 尝试解析为 URL
+        if (url.includes('://')) {
+            const urlObj = new URL(url);
+            return urlObj.hostname;
+        }
+        // 尝试解析为 host:port 格式
+        if (url.includes(':')) {
+            return url.split(':')[0];
+        }
+        return url;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 从 URL 解析端口
+ * @param url 连接地址
+ */
+export function parsePort(url) {
+    try {
+        // 尝试解析为 URL
+        if (url.includes('://')) {
+            const urlObj = new URL(url);
+            return parseInt(urlObj.port, 10) || null;
+        }
+        // 尝试解析为 host:port 格式
+        if (url.includes(':')) {
+            const port = parseInt(url.split(':')[1], 10);
+            return isNaN(port) ? null : port;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/packages/tcp/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACpC,IAAI,CAAC;QACJ,YAAY;QACZ,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,qBAAqB;QACrB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACpC,IAAI,CAAC;QACJ,YAAY;QACZ,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;QAC1C,CAAC;QACD,qBAAqB;QACrB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC","sourcesContent":["/**\r\n * 工具函数\r\n */\r\n\r\n/**\r\n * 从 URL 解析主机地址\r\n * @param url 连接地址\r\n */\r\nexport function parseHost(url: string): string | null {\r\n\ttry {\r\n\t\t// 尝试解析为 URL\r\n\t\tif (url.includes('://')) {\r\n\t\t\tconst urlObj = new URL(url);\r\n\t\t\treturn urlObj.hostname;\r\n\t\t}\r\n\t\t// 尝试解析为 host:port 格式\r\n\t\tif (url.includes(':')) {\r\n\t\t\treturn url.split(':')[0];\r\n\t\t}\r\n\t\treturn url;\r\n\t} catch {\r\n\t\treturn null;\r\n\t}\r\n}\r\n\r\n/**\r\n * 从 URL 解析端口\r\n * @param url 连接地址\r\n */\r\nexport function parsePort(url: string): number | null {\r\n\ttry {\r\n\t\t// 尝试解析为 URL\r\n\t\tif (url.includes('://')) {\r\n\t\t\tconst urlObj = new URL(url);\r\n\t\t\treturn parseInt(urlObj.port, 10) || null;\r\n\t\t}\r\n\t\t// 尝试解析为 host:port 格式\r\n\t\tif (url.includes(':')) {\r\n\t\t\tconst port = parseInt(url.split(':')[1], 10);\r\n\t\t\treturn isNaN(port) ? null : port;\r\n\t\t}\r\n\t\treturn null;\r\n\t} catch {\r\n\t\treturn null;\r\n\t}\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,82 @@
+{
+	"name": "@pixelhue/event-controller-sdk",
+	"version": "0.0.1",
+	"description": "Node service for PixelHue Event Controller device",
+	"main": "dist/index.js",
+	"type": "module",
+	"types": "dist/index.d.ts",
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"start": "node dist/index.js",
+		"start:dev": "tsx src/index.ts",
+		"test": "jest",
+		"test:watch": "jest --watch",
+		"test:coverage": "jest --coverage",
+		"lint": "eslint src --ext .ts",
+		"lint:fix": "eslint src --ext .ts --fix",
+		"format": "prettier --write \"src/**/*.ts\"",
+		"format:check": "prettier --check \"src/**/*.ts\"",
+		"commit": "cz",
+		"prepare": "husky",
+		"mock:device": "node pixelhue-mock-device.js",
+		"changelog": "standard-version -a -n -r patch",
+		"changelog:minor": "standard-version -a -n -r minor",
+		"changelog:major": "standard-version -a -n -r major",
+		"release": "yarn run changelog && yarn run build && npm publish --access public",
+		"release:dry-run": "yarn run build && npm publish --dry-run"
+	},
+	"config": {
+		"commitizen": {
+			"path": "cz-customizable"
+		},
+		"cz-customizable": {
+			"config": "./.cz-config.cjs"
+		}
+	},
+	"keywords": [
+		"pixelhue",
+		"event-controller",
+		"u5-mini",
+		"device",
+		"service"
+	],
+	"author": "pixelhue-service@novastar.tech",
+	"license": "MIT",
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org/",
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	],
+	"devDependencies": {
+		"@commitlint/cli": "^18.6.0",
+		"@commitlint/config-conventional": "^18.6.0",
+		"@types/jest": "^29.5.11",
+		"@types/node": "^20.11.0",
+		"@typescript-eslint/eslint-plugin": "^6.19.0",
+		"@typescript-eslint/parser": "^6.19.0",
+		"commitizen": "^4.3.0",
+		"cz-customizable": "^7.0.0",
+		"eslint": "^8.56.0",
+		"eslint-config-prettier": "^9.1.0",
+		"eslint-import-resolver-typescript": "^3.6.1",
+		"eslint-plugin-import": "^2.29.1",
+		"eslint-plugin-simple-import-sort": "^12.0.0",
+		"husky": "^9.0.10",
+		"jest": "^29.7.0",
+		"prettier": "^3.2.4",
+		"standard-version": "^9.3.1",
+		"ts-jest": "^29.1.2",
+		"tsx": "^4.7.0",
+		"typescript": "^5.3.3"
+	},
+	"dependencies": {
+		"@julusian/bonjour-service": "^1.4.2",
+		"@unico/uniform-protocol-builder": "^1.0.0",
+		"@unico/uniform-protocol-parser": "^1.0.0",
+		"eventemitter3": "^5.0.1",
+		"p-queue": "^9.0.0"
+	}
+}