scada-engine 1.0.0

package/dist/src/features/data-source/services/dataParser.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 数据解析工具
+ * 提供通用的数据格式解析和转换功能
+ */
+/**
+ * 设备数据接口
+ */
+export interface DeviceData {
+    id: string;
+    name: string;
+    points: Array<{
+        id: string;
+        name?: string;
+        value: any;
+        quality?: 'good' | 'bad' | 'uncertain';
+        timestamp?: string;
+        unit?: string;
+        dataType?: 'number' | 'boolean' | 'string';
+    }>;
+}
+/**
+ * 数据解析器类
+ */
+export declare class DataParser {
+    /**
+     * 自动解析设备数据（支持多种格式）
+     * @param data 原始数据
+     * @param defaultDeviceId 默认设备ID（用于简化点位数组格式）
+     * @param defaultDeviceName 默认设备名称（用于简化点位数组格式）
+     */
+    static parseDeviceData(data: any, defaultDeviceId?: string, defaultDeviceName?: string): DeviceData | null;
+    /**
+     * 检查是否为简化点位数组格式
+     */
+    private static isSimplifiedPointsArray;
+    /**
+     * 解析简化点位数组格式
+     */
+    private static parseSimplifiedPointsArray;
+    /**
+     * 检查是否为标准格式
+     */
+    private static isStandardFormat;
+    /**
+     * 解析标准格式
+     */
+    private static parseStandardFormat;
+    /**
+     * 检查是否为单点位格式
+     */
+    private static isSinglePointFormat;
+    /**
+     * 解析单点位格式
+     */
+    private static parseSinglePointFormat;
+    /**
+     * 检查是否为扁平化格式
+     */
+    private static isFlatFormat;
+    /**
+     * 解析扁平化格式
+     */
+    private static parseFlatFormat;
+    /**
+     * 检查是否为嵌套格式
+     */
+    private static isNestedFormat;
+    /**
+     * 解析嵌套格式
+     */
+    private static parseNestedFormat;
+    /**
+     * 推断数据类型
+     */
+    private static inferDataType;
+    /**
+     * 创建自定义解析器
+     * @param mappingConfig 字段映射配置
+     * @returns 解析函数
+     */
+    static createCustomParser(mappingConfig: {
+        deviceId: string | ((data: any) => string);
+        deviceName?: string | ((data: any) => string);
+        points: string | ((data: any) => any[]);
+        pointId?: string | ((data: any, point: any) => string);
+        pointValue?: string | ((data: any, point: any) => any);
+    }): (data: any) => DeviceData;
+    /**
+     * 通过路径获取值
+     */
+    private static getValueByPath;
+}
+/**
+ * 常用解析器预设
+ */
+export declare const ParserPresets: {
+    /**
+     * 物联网平台标准格式
+     */
+    iotPlatform: (data: any) => DeviceData;
+    /**
+     * Modbus 格式
+     */
+    modbus: (data: any) => DeviceData;
+    /**
+     * OPC UA 格式
+     */
+    opcua: (data: any) => DeviceData;
+};
+export declare const defaultParser: typeof DataParser.parseDeviceData;

package/dist/src/features/data-source/services/dataSourceManager.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 数据源管理服务
+ * 统一管理多个数据源连接（MQTT、WebSocket、HTTP等）
+ */
+export interface DataSource {
+    id: string;
+    name: string;
+    type: 'MQTT' | 'WebSocket' | 'HTTP' | 'SSE';
+    enabled: boolean;
+    config: {
+        broker?: string;
+        topic?: string;
+        clientId?: string;
+        username?: string;
+        password?: string;
+        wsUrl?: string;
+        url?: string;
+        method?: string;
+        pollInterval?: number;
+        headers?: Record<string, string>;
+        sseUrl?: string;
+        eventType?: string;
+        dataPath?: string;
+        retryCount?: number;
+        customParser?: (data: any) => any;
+    };
+    status?: {
+        connected: boolean;
+        lastUpdate?: string;
+        error?: string;
+    };
+    devices: Array<{
+        id: string;
+        name: string;
+        points: Array<{
+            id: string;
+            value: any;
+            quality?: string;
+            timestamp?: string;
+        }>;
+    }>;
+}
+export declare class DataSourceManager {
+    private dataSources;
+    private connections;
+    private onDataCallbacks;
+    /**
+     * 添加数据源
+     */
+    addDataSource(dataSource: DataSource): void;
+    /**
+     * 更新数据源
+     */
+    updateDataSource(id: string, updates: Partial<DataSource>): void;
+    /**
+     * 删除数据源
+     */
+    removeDataSource(id: string): void;
+    /**
+     * 获取数据源
+     */
+    getDataSource(id: string): DataSource | undefined;
+    /**
+     * 获取所有数据源
+     */
+    getAllDataSources(): DataSource[];
+    /**
+     * 获取所有设备（来自所有数据源）
+     */
+    getAllDevices(): Array<{
+        dataSourceId: string;
+        dataSourceName: string;
+        device: any;
+    }>;
+    /**
+     * 连接数据源
+     */
+    private connectDataSource;
+    /**
+     * 断开数据源连接
+     */
+    private disconnectDataSource;
+    /**
+     * 重新连接数据源
+     */
+    private reconnectDataSource;
+    /**
+     * 连接 MQTT
+     */
+    private connectMqtt;
+    /**
+     * 连接 WebSocket
+     */
+    private connectWebSocket;
+    /**
+     * 连接 HTTP
+     */
+    private connectHttp;
+    /**
+     * 连接 SSE
+     */
+    private connectSSE;
+    /**
+     * 处理接收到的原始数据
+     * 解析并更新设备列表，然后传递给回调
+     */
+    private handleDeviceData;
+    /**
+     * 解析并更新设备列表
+     */
+    private parseAndUpdateDevices;
+    /**
+     * 注册数据接收回调
+     */
+    onData(callback: (dataSourceId: string, deviceData: any) => void): void;
+    /**
+     * 断开所有连接
+     */
+    disconnectAll(): void;
+    /**
+     * 获取数据源状态
+     */
+    getDataSourceStatus(id: string): {
+        connected: boolean;
+    } | null;
+}
+export declare const dataSourceManager: DataSourceManager;

package/dist/src/features/data-source/services/httpService.d.ts

@@ -0,0 +1,73 @@
+/**
+ * HTTP 轮询服务模块
+ * 负责 HTTP 轮询原始数据接收
+ */
+/**
+ * HTTP 配置接口
+ */
+export interface HttpConfig {
+    /** 接口地址 */
+    url: string;
+    /** 请求方法 */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** 轮询间隔(ms) */
+    pollInterval?: number;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 请求体（POST/PUT） */
+    body?: any;
+    /** 数据路径（用于解析嵌套数据） */
+    dataPath?: string;
+    /** 启用状态 */
+    enabled?: boolean;
+    /** 超时时间(ms) */
+    timeout?: number;
+}
+/**
+ * HTTP 轮询服务类
+ */
+export declare class HttpService {
+    private config;
+    private onDataCallback;
+    private onErrorCallback;
+    private onStatusChangeCallback;
+    private intervalId;
+    private isPolling;
+    private abortController;
+    /**
+     * 启动轮询
+     */
+    start(config: HttpConfig): Promise<void>;
+    /**
+     * 执行轮询请求
+     */
+    private poll;
+    /**
+     * 设置数据接收回调
+     */
+    onData(callback: (data: any) => void): void;
+    /**
+     * 设置错误回调
+     */
+    onError(callback: (error: Error) => void): void;
+    /**
+     * 设置状态变化回调
+     */
+    onStatusChange(callback: (connected: boolean) => void): void;
+    /**
+     * 停止轮询
+     */
+    stop(): void;
+    /**
+     * 获取轮询状态
+     */
+    getPollingStatus(): boolean;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): HttpConfig | null;
+}
+/**
+ * 创建 HTTP 服务实例
+ */
+export declare function createHttpService(): HttpService;

package/dist/src/features/data-source/services/mqttService.d.ts

@@ -0,0 +1,110 @@
+/**
+ * MQTT 服务模块
+ * 负责 MQTT 连接管理和数据接收
+ */
+/**
+ * MQTT 配置接口
+ */
+export interface MqttConfig {
+    /** 服务器地址 */
+    broker: string;
+    /** 客户端ID（可选，自动生成） */
+    clientId?: string;
+    /** 订阅主题 */
+    topic: string;
+    /** 用户名（可选） */
+    username?: string;
+    /** 密码（可选） */
+    password?: string;
+    /** 数据路径（用于解析嵌套数据，例如：value） */
+    dataPath?: string;
+    /** 启用状态 */
+    enabled?: boolean;
+    /** 错误重试次数 */
+    retryCount?: number;
+}
+/**
+ * 设备点位数据接口
+ */
+export interface DevicePointData {
+    /** 点位 ID */
+    id: string;
+    /** 点位名称 */
+    name?: string;
+    /** 点位编码 */
+    code?: string;
+    /** 数据类型 */
+    dataType?: 'boolean' | 'number' | 'string';
+    /** 访问权限 */
+    accessMode?: 'read' | 'write' | 'readWrite';
+    /** 点位值 */
+    value: any;
+    /** 数据质量 */
+    quality?: 'good' | 'bad' | 'uncertain';
+    /** 时间戳 */
+    timestamp?: string;
+    /** 单位 */
+    unit?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 精度 */
+    precision?: number;
+}
+/**
+ * 设备数据接口
+ */
+export interface DeviceData {
+    /** 设备ID */
+    id: string;
+    /** 设备名称 */
+    name?: string;
+    /** 点位数据 */
+    points: DevicePointData[];
+}
+/**
+ * MQTT 服务类
+ */
+export declare class MqttService {
+    private client;
+    private config;
+    private onDataCallback;
+    private onErrorCallback;
+    private onStatusChangeCallback;
+    private isConnected;
+    /**
+     * 连接 MQTT 服务器
+     */
+    connect(config: MqttConfig): Promise<void>;
+    /**
+     * 设置数据接收回调
+     */
+    onData(callback: (data: DeviceData) => void): void;
+    /**
+     * 设置错误回调
+     */
+    onError(callback: (error: Error) => void): void;
+    /**
+     * 设置连接状态变化回调
+     */
+    onStatusChange(callback: (connected: boolean) => void): void;
+    /**
+     * 发布消息
+     */
+    publish(topic: string, message: string | object): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取连接状态
+     */
+    getConnectionStatus(): boolean;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): MqttConfig | null;
+}
+/**
+ * 创建 MQTT 服务实例
+ */
+export declare function createMqttService(): MqttService;

package/dist/src/features/data-source/services/sseService.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SSE (Server-Sent Events) 服务模块
+ * 负责 SSE 连接管理和原始数据接收
+ */
+/**
+ * SSE 配置接口
+ */
+export interface SseConfig {
+    /** SSE 服务地址 */
+    url: string;
+    /** 事件类型（默认 'message'） */
+    eventType?: string;
+    /** 数据路径（用于解析嵌套数据） */
+    dataPath?: string;
+    /** 启用状态 */
+    enabled?: boolean;
+    /** 自动重连 */
+    autoReconnect?: boolean;
+    /** 重连延迟(ms) */
+    reconnectDelay?: number;
+    /** 请求头（用于认证等） */
+    withCredentials?: boolean;
+}
+/**
+ * SSE 服务类
+ */
+export declare class SseService {
+    private eventSource;
+    private config;
+    private onDataCallback;
+    private onErrorCallback;
+    private onStatusChangeCallback;
+    private isConnected;
+    private reconnectTimer;
+    /**
+     * 连接 SSE 服务器
+     */
+    connect(config: SseConfig): Promise<void>;
+    /**
+     * 处理接收到的消息
+     */
+    private handleMessage;
+    /**
+     * 设置数据接收回调
+     */
+    onData(callback: (data: any) => void): void;
+    /**
+     * 设置错误回调
+     */
+    onError(callback: (error: Error) => void): void;
+    /**
+     * 设置状态变化回调
+     */
+    onStatusChange(callback: (connected: boolean) => void): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取连接状态
+     */
+    getConnectionStatus(): boolean;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): SseConfig | null;
+    /**
+     * 获取 EventSource readyState
+     */
+    getReadyState(): number;
+}
+/**
+ * 创建 SSE 服务实例
+ */
+export declare function createSseService(): SseService;

package/dist/src/features/data-source/services/websocketService.d.ts

@@ -0,0 +1,67 @@
+/**
+ * WebSocket 服务模块
+ * 负责 WebSocket 连接管理和原始数据接收
+ */
+/**
+ * WebSocket 配置接口
+ */
+export interface WebSocketConfig {
+    /** WebSocket 服务地址 */
+    url: string;
+    /** 数据路径（用于解析嵌套数据） */
+    dataPath?: string;
+    /** 启用状态 */
+    enabled?: boolean;
+    /** 自动重连 */
+    autoReconnect?: boolean;
+    /** 重连延迟(ms) */
+    reconnectDelay?: number;
+}
+/**
+ * WebSocket 服务类
+ */
+export declare class WebSocketService {
+    private ws;
+    private config;
+    private onDataCallback;
+    private onErrorCallback;
+    private onStatusChangeCallback;
+    private isConnected;
+    private reconnectTimer;
+    /**
+     * 连接 WebSocket 服务器
+     */
+    connect(config: WebSocketConfig): Promise<void>;
+    /**
+     * 发送消息
+     */
+    send(data: any): void;
+    /**
+     * 设置数据接收回调
+     */
+    onData(callback: (data: any) => void): void;
+    /**
+     * 设置错误回调
+     */
+    onError(callback: (error: Error) => void): void;
+    /**
+     * 设置状态变化回调
+     */
+    onStatusChange(callback: (connected: boolean) => void): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取连接状态
+     */
+    getConnectionStatus(): boolean;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): WebSocketConfig | null;
+}
+/**
+ * 创建 WebSocket 服务实例
+ */
+export declare function createWebSocketService(): WebSocketService;