@thejrsoft/subway-protocol 1.3.0

package/dist/index.js

@@ -0,0 +1,413 @@
+"use strict";
+/**
+ * JRSoft Subway 统一WebSocket协议定义
+ * 版本: 1.0
+ *
+ * 功能特性:
+ * 1. 统一消息格式定义
+ * 2. 支持设备注册、命令执行、心跳等核心功能
+ * 3. 支持 Edge 代理模式
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolUtils = exports.MessageValidator = exports.DEFAULT_PRIORITY = exports.DEFAULT_TIMEOUT = exports.PROTOCOL_VERSION = exports.MessageFactory = exports.ReportLevel = exports.ProgressStatus = exports.ProgressPhase = exports.ProgramDirection = exports.ProgramType = exports.CommandType = exports.CommandStatus = exports.Priority = exports.OperationType = exports.ClientType = exports.MessageType = void 0;
+exports.isRegisterMessage = isRegisterMessage;
+exports.isRegisterAckMessage = isRegisterAckMessage;
+exports.isUnregisterMessage = isUnregisterMessage;
+exports.isUnregisterAckMessage = isUnregisterAckMessage;
+exports.isHeartbeatMessage = isHeartbeatMessage;
+exports.isHeartbeatAckMessage = isHeartbeatAckMessage;
+exports.isCommandMessage = isCommandMessage;
+exports.isCommandResponseMessage = isCommandResponseMessage;
+exports.isProgramMessage = isProgramMessage;
+exports.isProgramResponseMessage = isProgramResponseMessage;
+exports.isProgressUpdateMessage = isProgressUpdateMessage;
+exports.isErrorMessage = isErrorMessage;
+// 消息类型枚举
+var MessageType;
+(function (MessageType) {
+    // 连接管理
+    MessageType["REGISTER"] = "REGISTER";
+    MessageType["REGISTER_ACK"] = "REGISTER_ACK";
+    MessageType["UNREGISTER"] = "UNREGISTER";
+    MessageType["UNREGISTER_ACK"] = "UNREGISTER_ACK";
+    // 心跳
+    MessageType["HEARTBEAT"] = "HEARTBEAT";
+    MessageType["HEARTBEAT_ACK"] = "HEARTBEAT_ACK";
+    // 命令执行
+    MessageType["COMMAND"] = "COMMAND";
+    MessageType["COMMAND_RESPONSE"] = "COMMAND_RESPONSE";
+    // 程序管理
+    MessageType["PROGRAM"] = "PROGRAM";
+    MessageType["PROGRAM_RESPONSE"] = "PROGRAM_RESPONSE";
+    // 进度更新
+    MessageType["PROGRESS_UPDATE"] = "PROGRESS_UPDATE";
+    // 错误
+    MessageType["ERROR"] = "ERROR";
+})(MessageType || (exports.MessageType = MessageType = {}));
+// 客户端类型
+var ClientType;
+(function (ClientType) {
+    ClientType["DEVICE"] = "DEVICE";
+    ClientType["BACKEND"] = "BACKEND";
+    ClientType["EDGE"] = "EDGE";
+    ClientType["GATEWAY"] = "GATEWAY"; // 添加缺失的 GATEWAY 类型
+})(ClientType || (exports.ClientType = ClientType = {}));
+// 操作类型
+var OperationType;
+(function (OperationType) {
+    OperationType["READ"] = "READ";
+    OperationType["WRITE"] = "WRITE";
+    OperationType["QUERY"] = "QUERY";
+    OperationType["UPDATE"] = "UPDATE";
+    OperationType["CONTROL"] = "CONTROL";
+})(OperationType || (exports.OperationType = OperationType = {}));
+// 优先级
+var Priority;
+(function (Priority) {
+    Priority["LOW"] = "LOW";
+    Priority["NORMAL"] = "NORMAL";
+    Priority["HIGH"] = "HIGH";
+    Priority["CRITICAL"] = "CRITICAL";
+    Priority["EMERGENCY"] = "EMERGENCY";
+})(Priority || (exports.Priority = Priority = {}));
+// 命令状态
+var CommandStatus;
+(function (CommandStatus) {
+    CommandStatus["COMPLETED"] = "COMPLETED";
+    CommandStatus["FAILED"] = "FAILED";
+    CommandStatus["TIMEOUT"] = "TIMEOUT";
+    CommandStatus["CANCELLED"] = "CANCELLED";
+    CommandStatus["IN_PROGRESS"] = "IN_PROGRESS"; // Gateway特有
+})(CommandStatus || (exports.CommandStatus = CommandStatus = {}));
+// 命令类型
+var CommandType;
+(function (CommandType) {
+    CommandType["SIMPLE"] = "SIMPLE";
+    CommandType["BATCH"] = "BATCH";
+    CommandType["COMPLEX"] = "COMPLEX"; // 持续响应命令
+})(CommandType || (exports.CommandType = CommandType = {}));
+// 程序类型
+var ProgramType;
+(function (ProgramType) {
+    ProgramType["DYNAMIC"] = "DYNAMIC";
+    ProgramType["STATIC"] = "STATIC";
+})(ProgramType || (exports.ProgramType = ProgramType = {}));
+// 程序方向
+var ProgramDirection;
+(function (ProgramDirection) {
+    ProgramDirection["LEFT_TO_RIGHT"] = "LEFT_TO_RIGHT";
+    ProgramDirection["RIGHT_TO_LEFT"] = "RIGHT_TO_LEFT";
+})(ProgramDirection || (exports.ProgramDirection = ProgramDirection = {}));
+// 进度阶段
+var ProgressPhase;
+(function (ProgressPhase) {
+    ProgressPhase["DOWNLOAD"] = "DOWNLOAD";
+    ProgressPhase["DECOMPRESS"] = "DECOMPRESS";
+    ProgressPhase["PREPROCESS"] = "PREPROCESS";
+    ProgressPhase["FRAMES"] = "FRAMES";
+    ProgressPhase["UPLOAD"] = "UPLOAD";
+    ProgressPhase["STATS"] = "STATS"; // 统计信息
+})(ProgressPhase || (exports.ProgressPhase = ProgressPhase = {}));
+// 进度状态
+var ProgressStatus;
+(function (ProgressStatus) {
+    ProgressStatus["PENDING"] = "PENDING";
+    ProgressStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    ProgressStatus["PAUSED"] = "PAUSED";
+    ProgressStatus["COMPLETED"] = "COMPLETED";
+    ProgressStatus["FAILED"] = "FAILED";
+    ProgressStatus["CANCELLED"] = "CANCELLED";
+})(ProgressStatus || (exports.ProgressStatus = ProgressStatus = {}));
+// 报告级别
+var ReportLevel;
+(function (ReportLevel) {
+    ReportLevel["DEBUG"] = "DEBUG";
+    ReportLevel["INFO"] = "INFO";
+    ReportLevel["WARNING"] = "WARNING";
+    ReportLevel["ERROR"] = "ERROR";
+    ReportLevel["CRITICAL"] = "CRITICAL";
+})(ReportLevel || (exports.ReportLevel = ReportLevel = {}));
+// 类型守卫函数
+function isRegisterMessage(msg) {
+    return msg && msg.type === MessageType.REGISTER;
+}
+function isRegisterAckMessage(msg) {
+    return msg && msg.type === MessageType.REGISTER_ACK;
+}
+function isUnregisterMessage(msg) {
+    return msg && msg.type === MessageType.UNREGISTER;
+}
+function isUnregisterAckMessage(msg) {
+    return msg && msg.type === MessageType.UNREGISTER_ACK;
+}
+function isHeartbeatMessage(msg) {
+    return msg && msg.type === MessageType.HEARTBEAT;
+}
+function isHeartbeatAckMessage(msg) {
+    return msg && msg.type === MessageType.HEARTBEAT_ACK;
+}
+function isCommandMessage(msg) {
+    return msg && msg.type === MessageType.COMMAND;
+}
+function isCommandResponseMessage(msg) {
+    return msg && msg.type === MessageType.COMMAND_RESPONSE;
+}
+function isProgramMessage(msg) {
+    return msg && msg.type === MessageType.PROGRAM;
+}
+function isProgramResponseMessage(msg) {
+    return msg && msg.type === MessageType.PROGRAM_RESPONSE;
+}
+function isProgressUpdateMessage(msg) {
+    return msg && msg.type === MessageType.PROGRESS_UPDATE;
+}
+function isErrorMessage(msg) {
+    return msg && msg.type === MessageType.ERROR;
+}
+// 消息工厂类 - 创建符合新协议的消息
+class MessageFactory {
+    /**
+     * 创建注册消息
+     */
+    static createRegisterMessage(clientId, clientType, clientInfo) {
+        return {
+            type: MessageType.REGISTER,
+            clientId,
+            clientType,
+            clientInfo,
+            timestamp: new Date().toISOString(),
+            version: '1.0'
+        };
+    }
+    /**
+     * 创建命令消息
+     */
+    static createCommandMessage(requestRef, targetClientId, command, callback, options) {
+        return {
+            type: MessageType.COMMAND,
+            requestRef,
+            targetClientId,
+            command: {
+                ...command,
+                commandType: command.commandType || CommandType.SIMPLE
+            },
+            priority: options?.priority || Priority.NORMAL,
+            timeout: options?.timeout || exports.DEFAULT_TIMEOUT,
+            retryCount: options?.retryCount || 0, // 默认值 0
+            callback,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建心跳消息
+     */
+    static createHeartbeatMessage(clientId, sequence) {
+        const now = new Date().toISOString();
+        return {
+            type: MessageType.HEARTBEAT,
+            clientId,
+            sequence,
+            clientTime: now,
+            timestamp: now,
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建注销消息
+     */
+    static createUnregisterMessage(clientId, reason) {
+        return {
+            type: MessageType.UNREGISTER,
+            clientId,
+            reason,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建程序上传消息
+     */
+    static createProgramMessage(requestRef, targetClientId, parameters, callback, options) {
+        return {
+            type: MessageType.PROGRAM,
+            requestRef,
+            targetClientId,
+            command: {
+                commandCode: 'UPLOAD_PROGRAM',
+                parameters
+            },
+            priority: options?.priority || Priority.NORMAL,
+            timeout: options?.timeout || 1800000, // 30分钟
+            callback,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建进度更新消息
+     */
+    static createProgressUpdateMessage(requestRef, phase, progress, message, status = ProgressStatus.IN_PROGRESS, options) {
+        return {
+            type: MessageType.PROGRESS_UPDATE,
+            requestRef,
+            status,
+            phase,
+            progress,
+            sourceType: options?.command ? 'COMMAND' : 'SYSTEM', // 根据是否有command自动判断
+            context: options?.context,
+            command: options?.command,
+            report: message ? {
+                level: options?.level || ReportLevel.INFO,
+                message,
+                code: options?.code,
+                data: options?.data
+            } : undefined,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建命令响应消息 (Backend 急需)
+     */
+    static createCommandResponseMessage(requestRef, status, result, message, options) {
+        // 如果提供了开始时间但没有 executionTime，自动计算
+        const executionTime = options?.executionTime ||
+            (options?.commandStartTime ? Date.now() - options.commandStartTime : undefined);
+        return {
+            type: MessageType.COMMAND_RESPONSE,
+            requestRef,
+            status,
+            result,
+            report: options?.report || (message ? {
+                level: ReportLevel.INFO,
+                message
+            } : undefined),
+            executionTime,
+            timestamp: new Date().toISOString(),
+            version: options?.version || exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建程序响应消息
+     */
+    static createProgramResponseMessage(requestRef, status, result, message, options) {
+        // 如果提供了开始时间但没有 executionTime，自动计算
+        const executionTime = options?.executionTime ||
+            (options?.programStartTime ? Date.now() - options.programStartTime : undefined);
+        return {
+            type: MessageType.PROGRAM_RESPONSE,
+            requestRef,
+            status,
+            context: result,
+            report: message ? {
+                level: ReportLevel.INFO,
+                message
+            } : undefined,
+            executionTime,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建错误消息 (Gateway & Backend 都需要)
+     */
+    static createErrorMessage(code, message, requestRef, options) {
+        return {
+            type: MessageType.ERROR,
+            code,
+            message,
+            severity: options?.severity || 'ERROR',
+            category: options?.category,
+            context: {
+                requestRef,
+                data: options?.data
+            },
+            retryable: options?.retryable,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建心跳确认消息 (Gateway 急需)
+     */
+    static createHeartbeatAckMessage(sequence, clientId, clientTime, options) {
+        const now = new Date().toISOString();
+        const nowMs = Date.now();
+        // 如果提供了接收时间但没有 latency，自动计算处理延迟
+        const latency = options?.latency ||
+            (options?.heartbeatReceivedTime ? nowMs - options.heartbeatReceivedTime : undefined);
+        return {
+            type: MessageType.HEARTBEAT_ACK,
+            clientId: clientId || '',
+            sequence,
+            clientTime: clientTime || now, // 使用传入的客户端时间或当前时间
+            serverTime: now,
+            latency,
+            timestamp: now,
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建注册确认消息 (Gateway 需要)
+     */
+    static createRegisterAckMessage(clientId, success, message, sessionId) {
+        return {
+            type: MessageType.REGISTER_ACK,
+            clientId,
+            success,
+            sessionId,
+            error: !success && message ? {
+                code: 'REGISTRATION_FAILED',
+                message
+            } : undefined,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+    /**
+     * 创建注销确认消息
+     */
+    static createUnregisterAckMessage(clientId, success) {
+        return {
+            type: MessageType.UNREGISTER_ACK,
+            clientId,
+            success,
+            timestamp: new Date().toISOString(),
+            version: exports.PROTOCOL_VERSION
+        };
+    }
+}
+exports.MessageFactory = MessageFactory;
+// 导出常量
+exports.PROTOCOL_VERSION = '1.0';
+exports.DEFAULT_TIMEOUT = 10000;
+exports.DEFAULT_PRIORITY = Priority.NORMAL;
+// 导出强类型命令系统
+__exportStar(require("./command-types"), exports);
+__exportStar(require("./command-factory"), exports);
+// 导出消息验证器
+var message_validator_1 = require("./message-validator");
+Object.defineProperty(exports, "MessageValidator", { enumerable: true, get: function () { return message_validator_1.MessageValidator; } });
+// 导出协议工具类
+var protocol_utils_1 = require("./protocol-utils");
+Object.defineProperty(exports, "ProtocolUtils", { enumerable: true, get: function () { return protocol_utils_1.ProtocolUtils; } });
+// 导出 Gateway 扩展 (暂时禁用，有编译错误)
+// export * from './gateway-extensions';
+// 导出 Edge 代理模式 (暂时禁用，有编译错误)
+// export * from './edge-proxy';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/message-validator.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 消息验证器 - 提供全面的消息验证功能
+ */
+import { MessageType } from './index';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+interface ValidationSchema {
+    required: string[];
+    optional?: string[];
+    types: Record<string, string>;
+    validators?: Record<string, (value: any) => boolean>;
+}
+/**
+ * 消息验证器类
+ */
+export declare class MessageValidator {
+    /**
+     * 通用验证方法，返回详细的验证结果
+     */
+    static validate(message: any): ValidationResult;
+    /**
+     * 验证消息基本结构
+     */
+    static validateStructure(message: any): boolean;
+    /**
+     * 验证命令消息
+     */
+    static validateCommandMessage(message: any): ValidationResult;
+    /**
+     * 验证程序消息
+     */
+    static validateProgramMessage(message: any): ValidationResult;
+    /**
+     * 验证进度更新消息
+     */
+    static validateProgressUpdate(message: any): ValidationResult;
+    /**
+     * 验证注册消息
+     */
+    static validateRegisterMessage(message: any): ValidationResult;
+    /**
+     * 验证心跳消息
+     */
+    static validateHeartbeatMessage(message: any): ValidationResult;
+    /**
+     * 验证错误消息
+     */
+    static validateErrorMessage(message: any): ValidationResult;
+    /**
+     * 验证消息类型
+     */
+    static isValidMessageType(type: string): boolean;
+    /**
+     * 验证客户端类型
+     */
+    static isValidClientType(clientType: string): boolean;
+    /**
+     * 验证优先级
+     */
+    static isValidPriority(priority: string): boolean;
+    /**
+     * 验证命令状态
+     */
+    static isValidCommandStatus(status: string): boolean;
+    /**
+     * 验证操作类型
+     */
+    static isValidOperationType(operationType: string): boolean;
+    /**
+     * 验证命令类型
+     */
+    static isValidCommandType(commandType: string): boolean;
+    /**
+     * 验证进度状态
+     */
+    static isValidProgressStatus(status: string): boolean;
+    /**
+     * 验证进度阶段
+     */
+    static isValidProgressPhase(phase: string): boolean;
+    /**
+     * 验证报告级别
+     */
+    static isValidReportLevel(level: string): boolean;
+    /**
+     * 验证程序类型
+     */
+    static isValidProgramType(type: string): boolean;
+    /**
+     * 验证程序方向
+     */
+    static isValidProgramDirection(direction: string): boolean;
+    /**
+     * 获取验证模式
+     */
+    static getValidationSchema(messageType: MessageType): ValidationSchema | null;
+}
+export {};
+//# sourceMappingURL=message-validator.d.ts.map

package/dist/message-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-validator.d.ts","sourceRoot":"","sources":["../src/message-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EAyBZ,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IA+C/C;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAM/C;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAoG7D;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAmF7D;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IAsD7D;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IA4C9D;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IA+B/D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,gBAAgB;IA8B3D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI3D;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIvD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIjD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI1D;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,GAAG,IAAI;CA+K9E"}