@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/service/PodMigrationService.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodMigrationService = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const db_1 = require("../identity/drizzle/db");
+const PodLookupRepository_1 = require("../identity/drizzle/PodLookupRepository");
+const EdgeNodeRepository_1 = require("../identity/drizzle/EdgeNodeRepository");
+/**
+ * Service for managing Pod migrations between Center nodes.
+ *
+ * Simplified migration process:
+ * 1. Validate pod and target node exist
+ * 2. Update nodeId to target node (atomic update)
+ *
+ * Data does NOT need to be copied upfront:
+ * - Metadata is in shared PostgreSQL (Quadstore), already accessible from all nodes
+ * - Binary files use cross-region fallback read (TieredMinioDataAccessor)
+ * - Files are lazily copied on first access if configured
+ *
+ * This provides instant, user-transparent migration.
+ */
+class PodMigrationService {
+    constructor(config) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        const db = (0, db_1.getIdentityDatabase)(config.identityDbUrl);
+        this.podLookupRepository = new PodLookupRepository_1.PodLookupRepository(db);
+        this.edgeNodeRepository = new EdgeNodeRepository_1.EdgeNodeRepository(db);
+        this.currentNodeId = config.currentNodeId;
+    }
+    /**
+     * Migrate a pod to a different node.
+     *
+     * This is instant - only updates the nodeId in database.
+     * Subsequent requests will be routed to the new node.
+     * Binary files are read via cross-region fallback if not present locally.
+     */
+    async migratePod(podId, targetNodeId) {
+        // Get pod info
+        const pod = await this.podLookupRepository.findById(podId);
+        if (!pod) {
+            throw new Error(`Pod ${podId} not found`);
+        }
+        // Get target node info
+        const targetNode = await this.edgeNodeRepository.getCenterNode(targetNodeId);
+        if (!targetNode) {
+            throw new Error(`Target node ${targetNodeId} not found`);
+        }
+        const sourceNodeId = pod.nodeId ?? this.currentNodeId;
+        // Check if already on target
+        if (sourceNodeId === targetNodeId) {
+            throw new Error(`Pod ${podId} is already on node ${targetNodeId}`);
+        }
+        // Update nodeId - this is the only thing we need to do!
+        await this.podLookupRepository.setNodeId(podId, targetNodeId);
+        this.logger.info(`Pod migrated: pod=${podId}, source=${sourceNodeId}, target=${targetNodeId}`);
+        return {
+            podId,
+            sourceNodeId,
+            targetNodeId,
+            migratedAt: new Date(),
+        };
+    }
+    /**
+     * Get which node a pod is currently on.
+     */
+    async getPodNode(podId) {
+        const pod = await this.podLookupRepository.findById(podId);
+        return pod?.nodeId ?? null;
+    }
+}
+exports.PodMigrationService = PodMigrationService;
+//# sourceMappingURL=PodMigrationService.js.map

package/dist/service/PodMigrationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodMigrationService.js","sourceRoot":"","sources":["../../src/service/PodMigrationService.ts"],"names":[],"mappings":";;;AAAA,iEAAqD;AACrD,+CAA6D;AAC7D,iFAA8E;AAC9E,+EAA4E;AAc5E;;;;;;;;;;;;;GAaG;AACH,MAAa,mBAAmB;IAO9B,YAAmB,MAAiC;QANjC,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAO7C,MAAM,EAAE,GAAG,IAAA,wBAAmB,EAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACrD,IAAI,CAAC,mBAAmB,GAAG,IAAI,yCAAmB,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,kBAAkB,GAAG,IAAI,uCAAkB,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,YAAoB;QACzD,eAAe;QACf,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,YAAY,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC;QAEtD,6BAA6B;QAC7B,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,uBAAuB,YAAY,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,wDAAwD;QACxD,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,YAAY,YAAY,YAAY,YAAY,EAAE,CAAC,CAAC;QAE/F,OAAO;YACL,KAAK;YACL,YAAY;YACZ,YAAY;YACZ,UAAU,EAAE,IAAI,IAAI,EAAE;SACvB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,KAAa;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3D,OAAO,GAAG,EAAE,MAAM,IAAI,IAAI,CAAC;IAC7B,CAAC;CACF;AA7DD,kDA6DC","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport { getIdentityDatabase } from '../identity/drizzle/db';\nimport { PodLookupRepository } from '../identity/drizzle/PodLookupRepository';\nimport { EdgeNodeRepository } from '../identity/drizzle/EdgeNodeRepository';\n\nexport interface PodMigrationServiceConfig {\n  identityDbUrl: string;\n  currentNodeId: string;\n}\n\nexport interface MigrationResult {\n  podId: string;\n  sourceNodeId: string;\n  targetNodeId: string;\n  migratedAt: Date;\n}\n\n/**\n * Service for managing Pod migrations between Center nodes.\n * \n * Simplified migration process:\n * 1. Validate pod and target node exist\n * 2. Update nodeId to target node (atomic update)\n * \n * Data does NOT need to be copied upfront:\n * - Metadata is in shared PostgreSQL (Quadstore), already accessible from all nodes\n * - Binary files use cross-region fallback read (TieredMinioDataAccessor)\n * - Files are lazily copied on first access if configured\n * \n * This provides instant, user-transparent migration.\n */\nexport class PodMigrationService {\n  protected readonly logger = getLoggerFor(this);\n\n  private readonly podLookupRepository: PodLookupRepository;\n  private readonly edgeNodeRepository: EdgeNodeRepository;\n  private readonly currentNodeId: string;\n\n  public constructor(config: PodMigrationServiceConfig) {\n    const db = getIdentityDatabase(config.identityDbUrl);\n    this.podLookupRepository = new PodLookupRepository(db);\n    this.edgeNodeRepository = new EdgeNodeRepository(db);\n    this.currentNodeId = config.currentNodeId;\n  }\n\n  /**\n   * Migrate a pod to a different node.\n   * \n   * This is instant - only updates the nodeId in database.\n   * Subsequent requests will be routed to the new node.\n   * Binary files are read via cross-region fallback if not present locally.\n   */\n  public async migratePod(podId: string, targetNodeId: string): Promise<MigrationResult> {\n    // Get pod info\n    const pod = await this.podLookupRepository.findById(podId);\n    if (!pod) {\n      throw new Error(`Pod ${podId} not found`);\n    }\n\n    // Get target node info\n    const targetNode = await this.edgeNodeRepository.getCenterNode(targetNodeId);\n    if (!targetNode) {\n      throw new Error(`Target node ${targetNodeId} not found`);\n    }\n\n    const sourceNodeId = pod.nodeId ?? this.currentNodeId;\n\n    // Check if already on target\n    if (sourceNodeId === targetNodeId) {\n      throw new Error(`Pod ${podId} is already on node ${targetNodeId}`);\n    }\n\n    // Update nodeId - this is the only thing we need to do!\n    await this.podLookupRepository.setNodeId(podId, targetNodeId);\n\n    this.logger.info(`Pod migrated: pod=${podId}, source=${sourceNodeId}, target=${targetNodeId}`);\n\n    return {\n      podId,\n      sourceNodeId,\n      targetNodeId,\n      migratedAt: new Date(),\n    };\n  }\n\n  /**\n   * Get which node a pod is currently on.\n   */\n  public async getPodNode(podId: string): Promise<string | null> {\n    const pod = await this.podLookupRepository.findById(podId);\n    return pod?.nodeId ?? null;\n  }\n}\n"]}

package/dist/service/PodMigrationService.jsonld

@@ -0,0 +1,76 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService",
+      "@type": "Class",
+      "requireElement": "PodMigrationService",
+      "comment": "Service for managing Pod migrations between Center nodes.  Simplified migration process: 1. Validate pod and target node exist 2. Update nodeId to target node (atomic update)  Data does NOT need to be copied upfront: - Metadata is in shared PostgreSQL (Quadstore), already accessible from all nodes - Binary files use cross-region fallback read (TieredMinioDataAccessor) - Files are lazily copied on first access if configured  This provides instant, user-transparent migration.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService_config_identityDbUrl",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService_config_currentNodeId",
+          "range": "xsd:string"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_podLookupRepository",
+          "memberFieldName": "podLookupRepository"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_edgeNodeRepository",
+          "memberFieldName": "edgeNodeRepository"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_currentNodeId",
+          "memberFieldName": "currentNodeId"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_migratePod",
+          "memberFieldName": "migratePod"
+        },
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService__member_getPodNode",
+          "memberFieldName": "getPodNode"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService_config__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService_config_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "currentNodeId",
+              "value": {
+                "@id": "undefineds:dist/service/PodMigrationService.jsonld#PodMigrationService_config_currentNodeId"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/signaling/SignalingClient.d.ts

@@ -0,0 +1,142 @@
+import type { HeartbeatMessage, HeartbeatAckMessage, RTCOfferMessage, RTCAnswerMessage, RTCIceCandidateMessage, RTCCloseMessage, RTCIceServer, ErrorMessage } from './types';
+/**
+ * 事件处理器类型
+ */
+export interface SignalingClientEvents {
+    /** 连接建立 */
+    connected: () => void;
+    /** 连接断开 */
+    disconnected: (code: number, reason: string) => void;
+    /** 认证成功 */
+    authenticated: (iceServers: RTCIceServer[]) => void;
+    /** 认证失败 */
+    authFailed: (error: string) => void;
+    /** 收到 RTC offer */
+    rtcOffer: (message: RTCOfferMessage) => void;
+    /** 收到 RTC answer */
+    rtcAnswer: (message: RTCAnswerMessage) => void;
+    /** 收到 ICE candidate */
+    rtcIce: (message: RTCIceCandidateMessage) => void;
+    /** 收到 RTC close */
+    rtcClose: (message: RTCCloseMessage) => void;
+    /** 收到错误 */
+    error: (message: ErrorMessage) => void;
+    /** 心跳确认 */
+    heartbeatAck: (message: HeartbeatAckMessage) => void;
+}
+export interface SignalingClientOptions {
+    /** Cloud 信令服务 URL，如 wss://cloud.example.com/ws/signaling */
+    url: string;
+    /** 节点 ID（Local 必填，Client 可选，不填则由服务端分配） */
+    nodeId?: string;
+    /** 认证令牌（Local 必填，Client 可选） */
+    token?: string;
+    /** 连接类型：local 或 client，默认 local */
+    connectionType?: 'local' | 'client';
+    /** 心跳间隔（毫秒） */
+    heartbeatInterval?: number;
+    /** 重连延迟（毫秒） */
+    reconnectDelay?: number;
+    /** 最大重连延迟（毫秒） */
+    maxReconnectDelay?: number;
+    /** 是否自动重连 */
+    autoReconnect?: boolean;
+}
+type EventName = keyof SignalingClientEvents;
+/**
+ * Local 节点信令客户端
+ *
+ * 功能：
+ * - 连接到 Cloud 信令服务
+ * - 自动认证和心跳
+ * - 处理 WebRTC 信令消息
+ * - 自动重连
+ */
+export declare class SignalingClient {
+    private readonly logger;
+    private readonly url;
+    private readonly nodeId;
+    private readonly token;
+    private readonly connectionType;
+    private readonly heartbeatInterval;
+    private readonly reconnectDelay;
+    private readonly maxReconnectDelay;
+    private readonly autoReconnect;
+    private ws?;
+    private authenticated;
+    private heartbeatTimer?;
+    private reconnectTimer?;
+    private currentReconnectDelay;
+    private closed;
+    private iceServers;
+    private assignedNodeId?;
+    /** 事件监听器 */
+    private readonly listeners;
+    /** 节点状态（用于心跳） */
+    private nodeStatus;
+    constructor(options: SignalingClientOptions);
+    /**
+     * 连接到信令服务器
+     */
+    connect(): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 是否已连接并认证
+     */
+    isConnected(): boolean;
+    /**
+     * 获取 ICE 服务器配置
+     */
+    getIceServers(): RTCIceServer[];
+    /**
+     * 获取有效的节点 ID（优先使用服务端分配的 ID）
+     */
+    getNodeId(): string;
+    /**
+     * 更新节点状态（下次心跳时发送）
+     */
+    updateStatus(status: Partial<HeartbeatMessage>): void;
+    /**
+     * 立即发送心跳
+     */
+    sendHeartbeat(): void;
+    /**
+     * 发送 RTC offer
+     */
+    sendOffer(targetId: string, sdp: string, sessionId: string): void;
+    /**
+     * 发送 RTC answer
+     */
+    sendAnswer(targetId: string, sdp: string, sessionId: string): void;
+    /**
+     * 发送 ICE candidate
+     */
+    sendIceCandidate(targetId: string, candidate: string, sessionId: string, sdpMid?: string, sdpMLineIndex?: number): void;
+    /**
+     * 发送 RTC close
+     */
+    sendClose(targetId: string, sessionId: string, reason?: string): void;
+    /**
+     * 添加事件监听器
+     */
+    on<T extends EventName>(event: T, handler: SignalingClientEvents[T]): void;
+    /**
+     * 移除事件监听器
+     */
+    off<T extends EventName>(event: T, handler: SignalingClientEvents[T]): void;
+    private emit;
+    private handleOpen;
+    private handleMessage;
+    private handleAuthAck;
+    private handleClose;
+    private handleError;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+}
+export {};

package/dist/signaling/SignalingClient.js

@@ -0,0 +1,305 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalingClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * Local 节点信令客户端
+ *
+ * 功能：
+ * - 连接到 Cloud 信令服务
+ * - 自动认证和心跳
+ * - 处理 WebRTC 信令消息
+ * - 自动重连
+ */
+class SignalingClient {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.authenticated = false;
+        this.closed = false;
+        this.iceServers = [];
+        /** 事件监听器 */
+        this.listeners = new Map();
+        /** 节点状态（用于心跳） */
+        this.nodeStatus = {};
+        this.url = options.url;
+        this.nodeId = options.nodeId ?? '';
+        this.token = options.token ?? '';
+        this.connectionType = options.connectionType ?? 'local';
+        this.heartbeatInterval = options.heartbeatInterval ?? 30000;
+        this.reconnectDelay = options.reconnectDelay ?? 1000;
+        this.maxReconnectDelay = options.maxReconnectDelay ?? 30000;
+        this.autoReconnect = options.autoReconnect ?? true;
+        this.currentReconnectDelay = this.reconnectDelay;
+    }
+    /**
+     * 连接到信令服务器
+     */
+    connect() {
+        if (this.ws) {
+            return;
+        }
+        this.closed = false;
+        this.logger.info(`Connecting to signaling server: ${this.url}`);
+        this.ws = new ws_1.default(this.url);
+        this.ws.on('open', () => this.handleOpen());
+        this.ws.on('message', (data) => this.handleMessage(data));
+        this.ws.on('close', (code, reason) => this.handleClose(code, reason.toString()));
+        this.ws.on('error', (error) => this.handleError(error));
+    }
+    /**
+     * 断开连接
+     */
+    disconnect() {
+        this.closed = true;
+        this.stopHeartbeat();
+        this.clearReconnectTimer();
+        if (this.ws) {
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = undefined;
+        }
+        this.authenticated = false;
+    }
+    /**
+     * 是否已连接并认证
+     */
+    isConnected() {
+        return this.ws?.readyState === ws_1.default.OPEN && this.authenticated;
+    }
+    /**
+     * 获取 ICE 服务器配置
+     */
+    getIceServers() {
+        return this.iceServers;
+    }
+    /**
+     * 获取有效的节点 ID（优先使用服务端分配的 ID）
+     */
+    getNodeId() {
+        return this.assignedNodeId ?? this.nodeId;
+    }
+    /**
+     * 更新节点状态（下次心跳时发送）
+     */
+    updateStatus(status) {
+        this.nodeStatus = { ...this.nodeStatus, ...status };
+    }
+    /**
+     * 立即发送心跳
+     */
+    sendHeartbeat() {
+        if (!this.isConnected()) {
+            return;
+        }
+        const heartbeat = {
+            type: 'heartbeat',
+            nodeId: this.nodeId,
+            ...this.nodeStatus,
+        };
+        this.send(heartbeat);
+    }
+    /**
+     * 发送 RTC offer
+     */
+    sendOffer(targetId, sdp, sessionId) {
+        this.send({
+            type: 'rtc-offer',
+            from: this.getNodeId(),
+            targetId,
+            sdp,
+            sessionId,
+        });
+    }
+    /**
+     * 发送 RTC answer
+     */
+    sendAnswer(targetId, sdp, sessionId) {
+        this.send({
+            type: 'rtc-answer',
+            from: this.getNodeId(),
+            targetId,
+            sdp,
+            sessionId,
+        });
+    }
+    /**
+     * 发送 ICE candidate
+     */
+    sendIceCandidate(targetId, candidate, sessionId, sdpMid, sdpMLineIndex) {
+        this.send({
+            type: 'rtc-ice',
+            from: this.getNodeId(),
+            targetId,
+            candidate,
+            sessionId,
+            sdpMid,
+            sdpMLineIndex,
+        });
+    }
+    /**
+     * 发送 RTC close
+     */
+    sendClose(targetId, sessionId, reason) {
+        this.send({
+            type: 'rtc-close',
+            from: this.getNodeId(),
+            targetId,
+            sessionId,
+            reason,
+        });
+    }
+    /**
+     * 添加事件监听器
+     */
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    /**
+     * 移除事件监听器
+     */
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+    emit(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(...args);
+                }
+                catch (error) {
+                    this.logger.error(`Event handler error for ${event}: ${error}`);
+                }
+            }
+        }
+    }
+    handleOpen() {
+        this.logger.info('WebSocket connected, sending auth...');
+        this.currentReconnectDelay = this.reconnectDelay;
+        this.emit('connected');
+        // 发送认证消息
+        const auth = {
+            type: 'auth',
+            connectionType: this.connectionType,
+            id: this.nodeId || undefined,
+            token: this.token || undefined,
+        };
+        this.send(auth);
+    }
+    handleMessage(data) {
+        let message;
+        try {
+            message = JSON.parse(data.toString());
+        }
+        catch {
+            this.logger.error('Invalid JSON message received');
+            return;
+        }
+        switch (message.type) {
+            case 'auth-ack':
+                this.handleAuthAck(message);
+                break;
+            case 'heartbeat-ack':
+                this.emit('heartbeatAck', message);
+                break;
+            case 'rtc-offer':
+                this.emit('rtcOffer', message);
+                break;
+            case 'rtc-answer':
+                this.emit('rtcAnswer', message);
+                break;
+            case 'rtc-ice':
+                this.emit('rtcIce', message);
+                break;
+            case 'rtc-close':
+                this.emit('rtcClose', message);
+                break;
+            case 'error':
+                this.emit('error', message);
+                break;
+            case 'pong':
+                // Ignore pong
+                break;
+            default:
+                this.logger.warn(`Unknown message type: ${message.type}`);
+        }
+    }
+    handleAuthAck(message) {
+        if (message.success) {
+            this.authenticated = true;
+            this.iceServers = message.iceServers ?? [];
+            // 保存服务端分配的 ID
+            if (message.assignedId) {
+                this.assignedNodeId = message.assignedId;
+                this.logger.info(`Authentication successful, assigned ID: ${this.assignedNodeId}`);
+            }
+            else {
+                this.logger.info('Authentication successful');
+            }
+            this.emit('authenticated', this.iceServers);
+            // 启动心跳
+            this.startHeartbeat();
+            // 立即发送第一次心跳
+            this.sendHeartbeat();
+        }
+        else {
+            this.logger.error(`Authentication failed: ${message.error}`);
+            this.emit('authFailed', message.error ?? 'Unknown error');
+            this.disconnect();
+        }
+    }
+    handleClose(code, reason) {
+        this.logger.info(`WebSocket closed: code=${code}, reason=${reason}`);
+        this.ws = undefined;
+        this.authenticated = false;
+        this.stopHeartbeat();
+        this.emit('disconnected', code, reason);
+        // 自动重连
+        if (!this.closed && this.autoReconnect) {
+            this.scheduleReconnect();
+        }
+    }
+    handleError(error) {
+        this.logger.error(`WebSocket error: ${error.message}`);
+    }
+    send(message) {
+        if (this.ws?.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHeartbeat();
+        }, this.heartbeatInterval);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+    }
+    scheduleReconnect() {
+        this.clearReconnectTimer();
+        this.logger.info(`Reconnecting in ${this.currentReconnectDelay}ms...`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect();
+        }, this.currentReconnectDelay);
+        // 指数退避
+        this.currentReconnectDelay = Math.min(this.currentReconnectDelay * 2, this.maxReconnectDelay);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+    }
+}
+exports.SignalingClient = SignalingClient;
+//# sourceMappingURL=SignalingClient.js.map

package/dist/signaling/SignalingClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalingClient.js","sourceRoot":"","sources":["../../src/signaling/SignalingClient.ts"],"names":[],"mappings":"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","sourcesContent":["import WebSocket from 'ws';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type {\n  SignalingMessage,\n  AuthMessage,\n  AuthAckMessage,\n  HeartbeatMessage,\n  HeartbeatAckMessage,\n  RTCOfferMessage,\n  RTCAnswerMessage,\n  RTCIceCandidateMessage,\n  RTCCloseMessage,\n  RTCIceServer,\n  ErrorMessage,\n} from './types';\n\n/**\n * 事件处理器类型\n */\nexport interface SignalingClientEvents {\n  /** 连接建立 */\n  connected: () => void;\n  /** 连接断开 */\n  disconnected: (code: number, reason: string) => void;\n  /** 认证成功 */\n  authenticated: (iceServers: RTCIceServer[]) => void;\n  /** 认证失败 */\n  authFailed: (error: string) => void;\n  /** 收到 RTC offer */\n  rtcOffer: (message: RTCOfferMessage) => void;\n  /** 收到 RTC answer */\n  rtcAnswer: (message: RTCAnswerMessage) => void;\n  /** 收到 ICE candidate */\n  rtcIce: (message: RTCIceCandidateMessage) => void;\n  /** 收到 RTC close */\n  rtcClose: (message: RTCCloseMessage) => void;\n  /** 收到错误 */\n  error: (message: ErrorMessage) => void;\n  /** 心跳确认 */\n  heartbeatAck: (message: HeartbeatAckMessage) => void;\n}\n\nexport interface SignalingClientOptions {\n  /** Cloud 信令服务 URL，如 wss://cloud.example.com/ws/signaling */\n  url: string;\n  /** 节点 ID（Local 必填，Client 可选，不填则由服务端分配） */\n  nodeId?: string;\n  /** 认证令牌（Local 必填，Client 可选） */\n  token?: string;\n  /** 连接类型：local 或 client，默认 local */\n  connectionType?: 'local' | 'client';\n  /** 心跳间隔（毫秒） */\n  heartbeatInterval?: number;\n  /** 重连延迟（毫秒） */\n  reconnectDelay?: number;\n  /** 最大重连延迟（毫秒） */\n  maxReconnectDelay?: number;\n  /** 是否自动重连 */\n  autoReconnect?: boolean;\n}\n\ntype EventName = keyof SignalingClientEvents;\ntype EventHandler<T extends EventName> = SignalingClientEvents[T];\n\n/**\n * Local 节点信令客户端\n *\n * 功能：\n * - 连接到 Cloud 信令服务\n * - 自动认证和心跳\n * - 处理 WebRTC 信令消息\n * - 自动重连\n */\nexport class SignalingClient {\n  private readonly logger = getLoggerFor(this);\n  private readonly url: string;\n  private readonly nodeId: string;\n  private readonly token: string;\n  private readonly connectionType: 'local' | 'client';\n  private readonly heartbeatInterval: number;\n  private readonly reconnectDelay: number;\n  private readonly maxReconnectDelay: number;\n  private readonly autoReconnect: boolean;\n\n  private ws?: WebSocket;\n  private authenticated = false;\n  private heartbeatTimer?: NodeJS.Timeout;\n  private reconnectTimer?: NodeJS.Timeout;\n  private currentReconnectDelay: number;\n  private closed = false;\n  private iceServers: RTCIceServer[] = [];\n  private assignedNodeId?: string; // 服务端分配的 ID（用于 client 模式）\n\n  /** 事件监听器 */\n  private readonly listeners = new Map<EventName, Set<EventHandler<EventName>>>();\n\n  /** 节点状态（用于心跳） */\n  private nodeStatus: Partial<HeartbeatMessage> = {};\n\n  public constructor(options: SignalingClientOptions) {\n    this.url = options.url;\n    this.nodeId = options.nodeId ?? '';\n    this.token = options.token ?? '';\n    this.connectionType = options.connectionType ?? 'local';\n    this.heartbeatInterval = options.heartbeatInterval ?? 30000;\n    this.reconnectDelay = options.reconnectDelay ?? 1000;\n    this.maxReconnectDelay = options.maxReconnectDelay ?? 30000;\n    this.autoReconnect = options.autoReconnect ?? true;\n    this.currentReconnectDelay = this.reconnectDelay;\n  }\n\n  /**\n   * 连接到信令服务器\n   */\n  public connect(): void {\n    if (this.ws) {\n      return;\n    }\n\n    this.closed = false;\n    this.logger.info(`Connecting to signaling server: ${this.url}`);\n\n    this.ws = new WebSocket(this.url);\n\n    this.ws.on('open', () => this.handleOpen());\n    this.ws.on('message', (data) => this.handleMessage(data));\n    this.ws.on('close', (code, reason) => this.handleClose(code, reason.toString()));\n    this.ws.on('error', (error) => this.handleError(error));\n  }\n\n  /**\n   * 断开连接\n   */\n  public disconnect(): void {\n    this.closed = true;\n    this.stopHeartbeat();\n    this.clearReconnectTimer();\n\n    if (this.ws) {\n      this.ws.close(1000, 'Client disconnect');\n      this.ws = undefined;\n    }\n\n    this.authenticated = false;\n  }\n\n  /**\n   * 是否已连接并认证\n   */\n  public isConnected(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN && this.authenticated;\n  }\n\n  /**\n   * 获取 ICE 服务器配置\n   */\n  public getIceServers(): RTCIceServer[] {\n    return this.iceServers;\n  }\n\n  /**\n   * 获取有效的节点 ID（优先使用服务端分配的 ID）\n   */\n  public getNodeId(): string {\n    return this.assignedNodeId ?? this.nodeId;\n  }\n\n  /**\n   * 更新节点状态（下次心跳时发送）\n   */\n  public updateStatus(status: Partial<HeartbeatMessage>): void {\n    this.nodeStatus = { ...this.nodeStatus, ...status };\n  }\n\n  /**\n   * 立即发送心跳\n   */\n  public sendHeartbeat(): void {\n    if (!this.isConnected()) {\n      return;\n    }\n\n    const heartbeat: HeartbeatMessage = {\n      type: 'heartbeat',\n      nodeId: this.nodeId,\n      ...this.nodeStatus,\n    };\n\n    this.send(heartbeat);\n  }\n\n  /**\n   * 发送 RTC offer\n   */\n  public sendOffer(targetId: string, sdp: string, sessionId: string): void {\n    this.send({\n      type: 'rtc-offer',\n      from: this.getNodeId(),\n      targetId,\n      sdp,\n      sessionId,\n    });\n  }\n\n  /**\n   * 发送 RTC answer\n   */\n  public sendAnswer(targetId: string, sdp: string, sessionId: string): void {\n    this.send({\n      type: 'rtc-answer',\n      from: this.getNodeId(),\n      targetId,\n      sdp,\n      sessionId,\n    });\n  }\n\n  /**\n   * 发送 ICE candidate\n   */\n  public sendIceCandidate(\n    targetId: string,\n    candidate: string,\n    sessionId: string,\n    sdpMid?: string,\n    sdpMLineIndex?: number,\n  ): void {\n    this.send({\n      type: 'rtc-ice',\n      from: this.getNodeId(),\n      targetId,\n      candidate,\n      sessionId,\n      sdpMid,\n      sdpMLineIndex,\n    });\n  }\n\n  /**\n   * 发送 RTC close\n   */\n  public sendClose(targetId: string, sessionId: string, reason?: string): void {\n    this.send({\n      type: 'rtc-close',\n      from: this.getNodeId(),\n      targetId,\n      sessionId,\n      reason,\n    });\n  }\n\n  /**\n   * 添加事件监听器\n   */\n  public on<T extends EventName>(event: T, handler: SignalingClientEvents[T]): void {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n    this.listeners.get(event)!.add(handler as EventHandler<EventName>);\n  }\n\n  /**\n   * 移除事件监听器\n   */\n  public off<T extends EventName>(event: T, handler: SignalingClientEvents[T]): void {\n    this.listeners.get(event)?.delete(handler as EventHandler<EventName>);\n  }\n\n  private emit<T extends EventName>(event: T, ...args: Parameters<SignalingClientEvents[T]>): void {\n    const handlers = this.listeners.get(event);\n    if (handlers) {\n      for (const handler of handlers) {\n        try {\n          (handler as (...args: unknown[]) => void)(...args);\n        } catch (error) {\n          this.logger.error(`Event handler error for ${event}: ${error}`);\n        }\n      }\n    }\n  }\n\n  private handleOpen(): void {\n    this.logger.info('WebSocket connected, sending auth...');\n    this.currentReconnectDelay = this.reconnectDelay;\n    this.emit('connected');\n\n    // 发送认证消息\n    const auth: AuthMessage = {\n      type: 'auth',\n      connectionType: this.connectionType,\n      id: this.nodeId || undefined,\n      token: this.token || undefined,\n    };\n    this.send(auth);\n  }\n\n  private handleMessage(data: WebSocket.RawData): void {\n    let message: SignalingMessage;\n    try {\n      message = JSON.parse(data.toString()) as SignalingMessage;\n    } catch {\n      this.logger.error('Invalid JSON message received');\n      return;\n    }\n\n    switch (message.type) {\n      case 'auth-ack':\n        this.handleAuthAck(message as AuthAckMessage);\n        break;\n\n      case 'heartbeat-ack':\n        this.emit('heartbeatAck', message as HeartbeatAckMessage);\n        break;\n\n      case 'rtc-offer':\n        this.emit('rtcOffer', message as RTCOfferMessage);\n        break;\n\n      case 'rtc-answer':\n        this.emit('rtcAnswer', message as RTCAnswerMessage);\n        break;\n\n      case 'rtc-ice':\n        this.emit('rtcIce', message as RTCIceCandidateMessage);\n        break;\n\n      case 'rtc-close':\n        this.emit('rtcClose', message as RTCCloseMessage);\n        break;\n\n      case 'error':\n        this.emit('error', message as ErrorMessage);\n        break;\n\n      case 'pong':\n        // Ignore pong\n        break;\n\n      default:\n        this.logger.warn(`Unknown message type: ${message.type}`);\n    }\n  }\n\n  private handleAuthAck(message: AuthAckMessage): void {\n    if (message.success) {\n      this.authenticated = true;\n      this.iceServers = message.iceServers ?? [];\n      // 保存服务端分配的 ID\n      if (message.assignedId) {\n        this.assignedNodeId = message.assignedId;\n        this.logger.info(`Authentication successful, assigned ID: ${this.assignedNodeId}`);\n      } else {\n        this.logger.info('Authentication successful');\n      }\n      this.emit('authenticated', this.iceServers);\n\n      // 启动心跳\n      this.startHeartbeat();\n\n      // 立即发送第一次心跳\n      this.sendHeartbeat();\n    } else {\n      this.logger.error(`Authentication failed: ${message.error}`);\n      this.emit('authFailed', message.error ?? 'Unknown error');\n      this.disconnect();\n    }\n  }\n\n  private handleClose(code: number, reason: string): void {\n    this.logger.info(`WebSocket closed: code=${code}, reason=${reason}`);\n    this.ws = undefined;\n    this.authenticated = false;\n    this.stopHeartbeat();\n\n    this.emit('disconnected', code, reason);\n\n    // 自动重连\n    if (!this.closed && this.autoReconnect) {\n      this.scheduleReconnect();\n    }\n  }\n\n  private handleError(error: Error): void {\n    this.logger.error(`WebSocket error: ${error.message}`);\n  }\n\n  private send(message: SignalingMessage): void {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.ws.send(JSON.stringify(message));\n    }\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      this.sendHeartbeat();\n    }, this.heartbeatInterval);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n\n  private scheduleReconnect(): void {\n    this.clearReconnectTimer();\n\n    this.logger.info(`Reconnecting in ${this.currentReconnectDelay}ms...`);\n\n    this.reconnectTimer = setTimeout(() => {\n      this.connect();\n    }, this.currentReconnectDelay);\n\n    // 指数退避\n    this.currentReconnectDelay = Math.min(\n      this.currentReconnectDelay * 2,\n      this.maxReconnectDelay,\n    );\n  }\n\n  private clearReconnectTimer(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n  }\n}\n"]}