moonbridge-ts 0.1.0

package/dist/moonbridge-ipc/client/internal/ipc/connect/ipc_connection_manager.js

@@ -0,0 +1,364 @@
+'use strict';
+
+var handshake = require('../../../../general/message/handshake');
+var session_setup = require('../../../../general/message/session_setup');
+var ipc_error = require('../../../../general/error/ipc_error');
+var message_types = require('../../../../general/message/constants/message_types');
+var ipc_message_decoder = require('../../../../general/encode/ipc_message_decoder');
+var platform_app_launcher = require('../../../../general/app_launch/platform_app_launcher');
+var logger = require('../../../../utils/logger');
+var transport_client_extension = require('../../../../general/transport/interface/transport_client_extension');
+var websocket_client = require('../../../../general/transport/websocket/websocket_client');
+
+class IpcConnectionManager {
+  constructor(componentProvider) {
+    this.connectionHandlers = [];
+    this.sessionSetupCallbacks = /* @__PURE__ */ new Map();
+    var _a;
+    this.componentProvider = componentProvider;
+    this.settings = componentProvider.settings;
+    this.clientName = componentProvider.settings.clientName;
+    const ws = this.settings.webSocketServerEndpoint;
+    if (!ws) {
+      throw new Error(
+        "IpcConnectionManager: webSocketServerEndpoint must be provided in IpcClientSettings for JS client."
+      );
+    }
+    const ports = this.getPortList(ws.port, (_a = ws.portCandidateRule) != null ? _a : void 0);
+    this.transportClient = new websocket_client.WebSocketClient(
+      ws.address,
+      ports[0],
+      ws.path,
+      ws.useTls
+    );
+  }
+  initialize() {
+    this.bindTransportEvents();
+  }
+  onMessageReceived(listener) {
+    this.onMessageReceivedListener = listener;
+    this.transportClient.onMessage(listener);
+  }
+  async connect(onResult, options) {
+    var _a, _b;
+    logger.logger.debug(`[ConnectionManager] connect \u5F00\u59CB clientName=${this.clientName}`);
+    if (this.isConnected()) {
+      this.handleAlreadyConnected(onResult);
+      return;
+    }
+    if (onResult) {
+      this.connectionHandlers.push(onResult);
+    }
+    if (this.connectionHandlers.length > 1) {
+      return;
+    }
+    if (await this.attemptConnection({
+      maxConnectionAttempts: 2,
+      notifyIfConnectionFailed: false
+    })) {
+      logger.logger.info("\u76F4\u63A5\u5EFA\u7ACB\u4E0E\u670D\u52A1\u7AEF\u8FDB\u7A0B\u7684\u8FDE\u63A5\u6210\u529F!");
+      return;
+    }
+    const shouldWakeUp = this.shouldAttemptWakeUp(options == null ? void 0 : options.autoLaunch);
+    if (shouldWakeUp) {
+      logger.logger.warn("\u670D\u52A1\u7AEF\u8FDB\u7A0B\u4E0D\u5B58\u5728\uFF0C\u5C1D\u8BD5\u5524\u9192\u670D\u52A1\u7AEF\u5E76\u5EFA\u7ACB\u8FDE\u63A5.");
+      const appLauncher = (_a = this.settings.appLauncher) != null ? _a : platform_app_launcher.PlatformAppLauncherFactory.create({
+        appIdentifier: this.settings.serverLaunchIdentifier,
+        appInstallationPath: this.settings.serverInstallationPath
+      });
+      const result = await appLauncher.launchApp();
+      if (!result.isSuccess) {
+        logger.logger.fatal(`\u5BA2\u6237\u7AEF('${this.clientName}')\u5524\u9192\u670D\u52A1\u7AEF App \u5931\u8D25: ${(_b = result.error) != null ? _b : "\u672A\u77E5\u539F\u56E0"}`);
+        this.handleConnectionFailed(result.error);
+        return;
+      }
+      logger.logger.info(`\u5BA2\u6237\u7AEF('${this.clientName}')\u5DF2\u89E6\u53D1\u5524\u9192\uFF0C\u5373\u5C06\u8FDB\u884C\u8FDE\u63A5\u63A2\u6D4B!`);
+      const connected = await this.attemptConnectionWithProbe();
+      if (connected) return;
+      this.handleConnectionFailed();
+    } else {
+      logger.logger.warn("\u670D\u52A1\u7AEF\u8FDB\u7A0B\u4E0D\u5B58\u5728\uFF0C\u89E6\u53D1\u670D\u52A1\u7AEF socket \u5173\u95ED\u4E8B\u4EF6.");
+      this.onServerClose();
+    }
+  }
+  async disconnect() {
+    await this.componentProvider.communicationAgent.unregister();
+    await this.transportClient.close();
+  }
+  isConnected() {
+    return this.transportClient.isClientConnected;
+  }
+  setupSession(request, callback, autoLaunch) {
+    if (!this.isConnected()) {
+      logger.logger.info(`\u5BA2\u6237\u7AEF('${this.clientName}')\u672A\u8FDE\u63A5\uFF0C\u5C1D\u8BD5\u5EFA\u7ACB\u8FDE\u63A5...`);
+      void this.connect((success, error) => {
+        if (success) {
+          this.setupSessionAfterConnection(request, callback, autoLaunch);
+        } else {
+          callback(false, error != null ? error : void 0);
+        }
+      }, { autoLaunch });
+      return;
+    }
+    this.setupSessionAfterConnection(request, callback, autoLaunch);
+  }
+  onSessionSetupCallback(response) {
+    var _a;
+    const callbacks = this.sessionSetupCallbacks.get(response.callbackId);
+    if (!callbacks) {
+      return;
+    }
+    this.sessionSetupCallbacks.delete(response.callbackId);
+    const error = new ipc_error.IpcError(
+      ipc_error.IpcError.ERROR_IPC_SESSION_ABNORMAL,
+      response.message,
+      (_a = response.userInfo) != null ? _a : void 0
+    );
+    const result = response.result === session_setup.IpcSessionSetupResponse.success;
+    for (const cb of callbacks) {
+      cb(result, result ? void 0 : error);
+    }
+  }
+  get transportClientInstance() {
+    return this.transportClient;
+  }
+  // PRIVATE HELPERS
+  bindTransportEvents() {
+    this.transportClient.onErrorAndClose({
+      onError: this.onError.bind(this),
+      onServerClose: this.onServerClose.bind(this)
+    });
+    if (this.onMessageReceivedListener) {
+      this.transportClient.onMessage(this.onMessageReceivedListener);
+    }
+  }
+  getPortList(port, portCandidateRule) {
+    if (portCandidateRule) {
+      return portCandidateRule.toOrderedPortList();
+    }
+    return [port];
+  }
+  /**
+   * 生成环境回调 ID，与 Flutter _generateSessionCallbackId 一致。
+   * 同一 (fromClient, toClient) 对的多个请求共享同一 sessionCallbackId，仅首次会发送 IpcSessionSetupRequest。
+   */
+  generateSessionCallbackId(request) {
+    return `${request.fromClient}_${request.toClient}`;
+  }
+  /**
+   * 对指定 client 执行应用层握手，与 Flutter _performHandshake 语义一致：
+   * 发送握手请求后，在短超时内等待带相同 magic 与 server 角色的握手响应，成功才返回 true。
+   */
+  async performHandshake(client) {
+    logger.logger.debug(`[ConnectionManager] \u5F00\u59CB\u63E1\u624B clientName=${this.clientName}`);
+    const hello = new handshake.Handshake(
+      this.clientName,
+      handshake.Handshake.ipcMagic,
+      handshake.Handshake.clientRole,
+      handshake.Handshake.ipcVersion
+    );
+    const sent = await transport_client_extension.sendHandshake(client, hello);
+    if (!sent) {
+      return false;
+    }
+    let settled = false;
+    let complete;
+    const handshakePromise = new Promise((resolve) => {
+      complete = resolve;
+    });
+    const resolveOnce = (value) => {
+      if (settled) return;
+      settled = true;
+      complete(value);
+    };
+    const onMessage = (message) => {
+      if (settled) return;
+      if (!message.includes(message_types.MessageType.HANDSHAKE)) {
+        resolveOnce(false);
+        return;
+      }
+      try {
+        const hs = ipc_message_decoder.IpcMessageDecoder.decodeHandshake(message);
+        const isTargetServer = hs.magic === handshake.Handshake.ipcMagic && hs.role === handshake.Handshake.serverRole;
+        resolveOnce(isTargetServer);
+      } catch {
+        resolveOnce(false);
+      }
+    };
+    client.onMessage(onMessage);
+    const timeoutMs = 1e3;
+    const timeoutId = setTimeout(() => {
+      resolveOnce(false);
+    }, timeoutMs);
+    try {
+      const result = await handshakePromise;
+      logger.logger.debug(`[ConnectionManager] \u63E1\u624B\u7ED3\u675F clientName=${this.clientName} success=${result}`);
+      return result;
+    } finally {
+      clearTimeout(timeoutId);
+      if (this.onMessageReceivedListener) {
+        client.onMessage(this.onMessageReceivedListener);
+      }
+    }
+  }
+  /**
+   * 019：唤醒后连接探测。立即尝试连接，失败则短间隔重试，成功即停止；支持多轮端口遍历。
+   */
+  async attemptConnectionWithProbe() {
+    const intervalMs = this.settings.wakeUpProbeIntervalMs;
+    const timeoutMs = this.settings.wakeUpProbeTimeoutMs;
+    const start = Date.now();
+    let round = 0;
+    while (true) {
+      round += 1;
+      logger.logger.debug(
+        `[ConnectionManager] \u8FDE\u63A5\u63A2\u6D4B \u7B2C ${round} \u8F6E clientName=${this.clientName}`
+      );
+      const ok = await this.attemptConnection({
+        maxConnectionAttempts: 1,
+        notifyIfConnectionFailed: false
+      });
+      if (ok) {
+        logger.logger.info(`\u5BA2\u6237\u7AEF('${this.clientName}')\u8FDE\u63A5\u63A2\u6D4B\u6210\u529F`);
+        return true;
+      }
+      const elapsed = Date.now() - start;
+      if (elapsed >= timeoutMs) {
+        logger.logger.warn(
+          `\u5BA2\u6237\u7AEF('${this.clientName}')\u8FDE\u63A5\u63A2\u6D4B\u8D85\u65F6\uFF0C\u5DF2\u8017\u65F6 ${elapsed}ms`
+        );
+        return false;
+      }
+      await new Promise((r) => setTimeout(r, intervalMs));
+    }
+  }
+  async attemptConnection(options) {
+    var _a, _b, _c;
+    const maxAttempts = (_a = options == null ? void 0 : options.maxConnectionAttempts) != null ? _a : 1;
+    const ws = this.settings.webSocketServerEndpoint;
+    if (!ws) return false;
+    const portList = this.getPortList(ws.port, (_b = ws.portCandidateRule) != null ? _b : void 0);
+    const hasPortRule = portList.length > 1;
+    if (hasPortRule) {
+      logger.logger.debug(`[ConnectionManager] attemptConnection \u904D\u5386\u7AEF\u53E3\u5217\u8868\uFF0C\u5171 ${portList.length} \u4E2A\u7AEF\u53E3`);
+      for (const port of portList) {
+        try {
+          const client = new websocket_client.WebSocketClient(ws.address, port, ws.path, ws.useTls);
+          if (await client.connectWithServer()) {
+            const ok = await this.performHandshake(client);
+            if (ok) {
+              await this.transportClient.close();
+              this.transportClient = client;
+              this.bindTransportEvents();
+              const registered = await this.componentProvider.communicationAgent.register();
+              if (registered) {
+                logger.logger.info(`\u5BA2\u6237\u7AEF(${this.clientName})\u6CE8\u518C\u6210\u529F.`);
+              }
+              this.notifyConnectionResult(true, void 0);
+              return true;
+            }
+            await client.close();
+          }
+        } catch (e) {
+          this.handleConnectionException(e);
+        }
+      }
+    } else {
+      logger.logger.debug(`[ConnectionManager] attemptConnection maxAttempts=${maxAttempts}`);
+      for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        try {
+          if (await this.transportClient.connectWithServer()) {
+            const ok = await this.performHandshake(this.transportClient);
+            if (ok) {
+              const registered = await this.componentProvider.communicationAgent.register();
+              if (registered) {
+                logger.logger.info(`\u5BA2\u6237\u7AEF(${this.clientName})\u6CE8\u518C\u6210\u529F.`);
+              }
+              this.notifyConnectionResult(true, void 0);
+              return true;
+            }
+            await this.transportClient.close();
+          }
+        } catch (e) {
+          this.handleConnectionException(e);
+        }
+      }
+    }
+    if ((_c = options == null ? void 0 : options.notifyIfConnectionFailed) != null ? _c : true) {
+      this.handleConnectionFailed();
+    }
+    return false;
+  }
+  handleConnectionFailed(launchError) {
+    const message = launchError ? `Connect server socket failed! Launch error: ${launchError}` : "Connect server socket failed!";
+    const userInfo = launchError ? { launchError } : void 0;
+    this.notifyConnectionResult(
+      false,
+      new ipc_error.IpcError(ipc_error.IpcError.ERROR_BIND_SERVER, message, userInfo)
+    );
+    logger.logger.error(`\u5BA2\u6237\u7AEF('${this.clientName}')\u4E0E\u670D\u52A1\u7AEF\u5EFA\u7ACB\u8FDE\u63A5\u5931\u8D25${launchError ? `: ${launchError}` : ""}`);
+  }
+  handleConnectionException(e) {
+    this.notifyConnectionResult(
+      false,
+      new ipc_error.IpcError(
+        ipc_error.IpcError.ERROR_BIND_SERVER_EXCEPTION,
+        "Connect server socket exception!"
+      )
+    );
+    logger.logger.error(`\u5BA2\u6237\u7AEF('${this.clientName}')\u4E0E\u670D\u52A1\u7AEF\u5EFA\u7ACB\u8FDE\u63A5\u5F02\u5E38: ${String(e)}`);
+  }
+  handleAlreadyConnected(handler) {
+    if (handler) {
+      handler(true, void 0);
+    }
+  }
+  shouldAttemptWakeUp(autoLaunchOverride) {
+    if (typeof autoLaunchOverride === "boolean") {
+      return autoLaunchOverride;
+    }
+    const strategy = this.settings.messageStrategy;
+    return strategy.autoLaunch;
+  }
+  setupSessionAfterConnection(request, callback, autoLaunch) {
+    var _a;
+    const sessionCallbackId = this.generateSessionCallbackId(request);
+    const callbacks = (_a = this.sessionSetupCallbacks.get(sessionCallbackId)) != null ? _a : [];
+    callbacks.push(callback);
+    this.sessionSetupCallbacks.set(sessionCallbackId, callbacks);
+    if (callbacks.length === 1) {
+      const setupRequest = new session_setup.IpcSessionSetupRequest(
+        this.clientName,
+        request.toClient,
+        sessionCallbackId,
+        autoLaunch
+      );
+      transport_client_extension.setupSession(this.transportClient, setupRequest);
+    }
+  }
+  onError(_error) {
+    logger.logger.error(`\u5BA2\u6237\u7AEF('${this.clientName}')\u4E0E\u670D\u52A1\u7AEF\u8FDE\u63A5\u51FA\u9519: ${String(_error)}!`);
+    this.notifyConnectionResult(
+      false,
+      new ipc_error.IpcError(ipc_error.IpcError.ERROR_DISCONNECTED_WITH_SERVER, "Disconnected from server!")
+    );
+  }
+  onServerClose() {
+    logger.logger.error(`\u5BA2\u6237\u7AEF('${this.clientName}')\u65AD\u5F00\u4E0E\u670D\u52A1\u7AEF\u7684\u8FDE\u63A5\uFF0C\u670D\u52A1\u7AEF socket \u5173\u95ED!`);
+    this.notifyConnectionResult(
+      false,
+      new ipc_error.IpcError(ipc_error.IpcError.ERROR_SERVER_SOCKET_CLOSED, "Server socket closed!")
+    );
+  }
+  notifyConnectionResult(success, error) {
+    const handlers = this.connectionHandlers;
+    this.connectionHandlers = [];
+    for (const handler of handlers) {
+      handler(success, error != null ? error : void 0);
+    }
+  }
+}
+
+exports.IpcConnectionManager = IpcConnectionManager;
+//# sourceMappingURL=ipc_connection_manager.js.map
+//# sourceMappingURL=ipc_connection_manager.js.map

package/dist/moonbridge-ipc/client/internal/ipc/connect/ipc_connection_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/moonbridge-ipc/client/internal/ipc/connect/ipc_connection_manager.ts"],"names":["WebSocketClient","logger","PlatformAppLauncherFactory","IpcError","IpcSessionSetupResponse","Handshake","sendHandshake","MessageType","IpcMessageDecoder","IpcSessionSetupRequest","setupSession"],"mappings":"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","file":"ipc_connection_manager.js","sourcesContent":["// 对应：\n// moonbridge-ipc-flutter/lib/client/internal/ipc/connect/ipc_connection_manager.dart\n//\n// IPC 连接管理器，负责维护 IPC 通信的连接状态。\n// 012 US1：JS 端仅使用 webSocketServerEndpoint 构造 WebSocket 客户端，不使用 socketServerEndpoint。\n// 010 US1：握手在 performHandshake 内等待服务端 TYPE_NAME_HANDSHAKE 响应并校验 magic/role，与 Flutter 一致。\n// 010 US4：当直接连接失败且 shouldAttemptWakeUp 为 true 时，调用 settings.appLauncher.launchApp() 后重试。\n// 019：连接探测——唤醒后立即尝试连接，失败则短间隔重试，成功即停止；launchApp 返回 AppLaunchResult。\n\nimport { IpcClientComponentProvider } from '../ipc_client_component_provider';\nimport { IpcClientSettings } from '../../settings/ipc_client_settings';\nimport { IpcMessageStrategy } from '../../../types/ipc_message_strategy';\nimport { IpcConnectionCompletionHandler } from '../../../types/ipc_types';\nimport { TransportClient } from '../../../../general/transport/interface/transport_client';\nimport { PortCandidateRule } from '../../../../general/config/port_candidate_rule';\nimport { Handshake } from '../../../../general/message/handshake';\nimport { IpcSessionSetupRequest, IpcSessionSetupResponse } from '../../../../general/message/session_setup';\nimport { Request } from '../../../../general/message/request';\nimport { IpcError } from '../../../../general/error/ipc_error';\nimport { MessageType } from '../../../../general/message/constants/message_types';\nimport { IpcMessageDecoder } from '../../../../general/encode/ipc_message_decoder';\nimport { PlatformAppLauncherFactory } from '../../../../general/app_launch/platform_app_launcher';\nimport { logger } from '../../../../utils/logger';\nimport { sendHandshake, setupSession, } from '../../../../general/transport/interface/transport_client_extension';\nimport { WebSocketClient } from '../../../../general/transport/websocket/websocket_client';\n\n/** \n * IPC 通信环境构建结果回调\n */\nexport type IpcSessionSetupCallback = (success: boolean, error?: IpcError) => void;\n\n/**\n * IPC 连接管理器，负责维护 IPC 通信的连接状态\n */\nexport class IpcConnectionManager {\n  private readonly settings: IpcClientSettings;\n  private readonly componentProvider: IpcClientComponentProvider;\n  private readonly clientName: string;\n\n  private transportClient: TransportClient;\n  private connectionHandlers: Array<IpcConnectionCompletionHandler> = [];\n  private sessionSetupCallbacks: Map<string, Array<IpcSessionSetupCallback>> = new Map();\n  private onMessageReceivedListener?: (message: string) => void;\n\n  constructor(componentProvider: IpcClientComponentProvider) {\n    this.componentProvider = componentProvider;\n    this.settings = componentProvider.settings;\n    this.clientName = componentProvider.settings.clientName;\n\n    // 初始化传输通道（JS 端仅实现 WebSocket 通道）\n    const ws = this.settings.webSocketServerEndpoint;\n    if (!ws) {\n      throw new Error(\n        'IpcConnectionManager: webSocketServerEndpoint must be provided in IpcClientSettings for JS client.',\n      );\n    }\n    const ports = this.getPortList(ws.port, ws.portCandidateRule ?? undefined);\n    // 使用首个端口创建初始 client；有 portCandidateRule 时 attemptConnection 会按端口列表依次尝试\n    this.transportClient = new WebSocketClient(\n      ws.address,\n      ports[0],\n      ws.path,\n      ws.useTls,\n    );\n  }\n\n  initialize(): void {\n    this.bindTransportEvents();\n  }\n\n  onMessageReceived(listener: (message: string) => void): void {\n    this.onMessageReceivedListener = listener;\n    this.transportClient.onMessage(listener);\n  }\n\n  async connect(\n    onResult?: IpcConnectionCompletionHandler,\n    options?: { autoLaunch?: boolean },\n  ): Promise<void> {\n    logger.debug(`[ConnectionManager] connect 开始 clientName=${this.clientName}`);\n    if (this.isConnected()) {\n      this.handleAlreadyConnected(onResult);\n      return;\n    }\n\n    if (onResult) {\n      this.connectionHandlers.push(onResult);\n    }\n    if (this.connectionHandlers.length > 1) {\n      return;\n    }\n\n    if (\n      await this.attemptConnection({\n        maxConnectionAttempts: 2,\n        notifyIfConnectionFailed: false,\n      })\n    ) {\n      logger.info('直接建立与服务端进程的连接成功!');\n      return;\n    }\n\n    const shouldWakeUp = this.shouldAttemptWakeUp(options?.autoLaunch);\n    if (shouldWakeUp) {\n      logger.warn('服务端进程不存在，尝试唤醒服务端并建立连接.');\n      const appLauncher = this.settings.appLauncher ?? PlatformAppLauncherFactory.create({\n        appIdentifier: this.settings.serverLaunchIdentifier,\n        appInstallationPath: this.settings.serverInstallationPath,\n      });\n\n      const result = await appLauncher.launchApp();\n      if (!result.isSuccess) {\n        logger.fatal(`客户端('${this.clientName}')唤醒服务端 App 失败: ${result.error ?? '未知原因'}`);\n        this.handleConnectionFailed(result.error);\n        return;\n      }\n      logger.info(`客户端('${this.clientName}')已触发唤醒，即将进行连接探测!`);\n      const connected = await this.attemptConnectionWithProbe();\n      if (connected) return;\n      this.handleConnectionFailed();\n    } else {\n      logger.warn('服务端进程不存在，触发服务端 socket 关闭事件.');\n      this.onServerClose();\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    await this.componentProvider.communicationAgent.unregister();\n    await this.transportClient.close();\n  }\n\n  isConnected(): boolean {\n    return this.transportClient.isClientConnected;\n  }\n\n  setupSession(\n    request: Request,\n    callback: IpcSessionSetupCallback,\n    autoLaunch: boolean,\n  ): void {\n    if (!this.isConnected()) {\n      logger.info(`客户端('${this.clientName}')未连接，尝试建立连接...`);\n      void this.connect((success, error) => {\n        if (success) {\n          this.setupSessionAfterConnection(request, callback, autoLaunch);\n        } else {\n          callback(false, error ?? undefined);\n        }\n      }, { autoLaunch });\n      return;\n    }\n\n    this.setupSessionAfterConnection(request, callback, autoLaunch);\n  }\n\n  onSessionSetupCallback(response: IpcSessionSetupResponse): void {\n    const callbacks = this.sessionSetupCallbacks.get(response.callbackId);\n    if (!callbacks) {\n      return;\n    }\n    this.sessionSetupCallbacks.delete(response.callbackId);\n\n    const error = new IpcError(\n      IpcError.ERROR_IPC_SESSION_ABNORMAL,\n      response.message,\n      response.userInfo ?? undefined,\n    );\n    const result = response.result === IpcSessionSetupResponse.success;\n\n    for (const cb of callbacks) {\n      cb(result, result ? undefined : error);\n    }\n  }\n\n  get transportClientInstance(): TransportClient {\n    return this.transportClient;\n  }\n\n  // PRIVATE HELPERS\n\n  private bindTransportEvents(): void {\n    this.transportClient.onErrorAndClose({\n      onError: this.onError.bind(this),\n      onServerClose: this.onServerClose.bind(this),\n    });\n\n    if (this.onMessageReceivedListener) {\n      this.transportClient.onMessage(this.onMessageReceivedListener);\n    }\n  }\n\n  private getPortList(port: number, portCandidateRule?: PortCandidateRule): Array<number> {\n    if (portCandidateRule) {\n      return portCandidateRule.toOrderedPortList();\n    }\n    return [port];\n  }\n\n  /**\n   * 生成环境回调 ID，与 Flutter _generateSessionCallbackId 一致。\n   * 同一 (fromClient, toClient) 对的多个请求共享同一 sessionCallbackId，仅首次会发送 IpcSessionSetupRequest。\n   */\n  private generateSessionCallbackId(request: Request): string {\n    return `${request.fromClient}_${request.toClient}`;\n  }\n\n  /**\n   * 对指定 client 执行应用层握手，与 Flutter _performHandshake 语义一致：\n   * 发送握手请求后，在短超时内等待带相同 magic 与 server 角色的握手响应，成功才返回 true。\n   */\n  private async performHandshake(client: TransportClient): Promise<boolean> {\n    logger.debug(`[ConnectionManager] 开始握手 clientName=${this.clientName}`);\n    const hello = new Handshake(\n      this.clientName,\n      Handshake.ipcMagic,\n      Handshake.clientRole,\n      Handshake.ipcVersion,\n    );\n    const sent = await sendHandshake(client, hello);\n    if (!sent) {\n      return false;\n    }\n\n    let settled = false;\n    let complete: (value: boolean) => void;\n    const handshakePromise = new Promise<boolean>((resolve) => {\n      complete = resolve;\n    });\n    const resolveOnce = (value: boolean) => {\n      if (settled) return;\n      settled = true;\n      complete(value);\n    };\n\n    const onMessage = (message: string): void => {\n      if (settled) return;\n      // 约定：首条应用层消息若非握手响应，则判定非目标 IPC 服务，立即失败\n      if (!message.includes(MessageType.HANDSHAKE)) {\n        resolveOnce(false);\n        return;\n      }\n      try {\n        const hs = IpcMessageDecoder.decodeHandshake(message);\n        const isTargetServer =\n          hs.magic === Handshake.ipcMagic && hs.role === Handshake.serverRole;\n        resolveOnce(isTargetServer);\n      } catch {\n        resolveOnce(false);\n      }\n    };\n\n    client.onMessage(onMessage);\n\n    const timeoutMs = 1000;\n    const timeoutId = setTimeout(() => {\n      resolveOnce(false);\n    }, timeoutMs);\n\n    try {\n      const result = await handshakePromise;\n      logger.debug(`[ConnectionManager] 握手结束 clientName=${this.clientName} success=${result}`);\n      return result;\n    } finally {\n      clearTimeout(timeoutId);\n      if (this.onMessageReceivedListener) {\n        client.onMessage(this.onMessageReceivedListener);\n      }\n    }\n  }\n\n  /**\n   * 019：唤醒后连接探测。立即尝试连接，失败则短间隔重试，成功即停止；支持多轮端口遍历。\n   */\n  private async attemptConnectionWithProbe(): Promise<boolean> {\n    const intervalMs = this.settings.wakeUpProbeIntervalMs;\n    const timeoutMs = this.settings.wakeUpProbeTimeoutMs;\n    const start = Date.now();\n    let round = 0;\n\n    // eslint-disable-next-line no-constant-condition -- 连接探测循环，通过 return 退出\n    while (true) {\n      round += 1;\n      logger.debug(\n        `[ConnectionManager] 连接探测 第 ${round} 轮 clientName=${this.clientName}`,\n      );\n      const ok = await this.attemptConnection({\n        maxConnectionAttempts: 1,\n        notifyIfConnectionFailed: false,\n      });\n      if (ok) {\n        logger.info(`客户端('${this.clientName}')连接探测成功`);\n        return true;\n      }\n      const elapsed = Date.now() - start;\n      if (elapsed >= timeoutMs) {\n        logger.warn(\n          `客户端('${this.clientName}')连接探测超时，已耗时 ${elapsed}ms`,\n        );\n        return false;\n      }\n      await new Promise((r) => setTimeout(r, intervalMs));\n    }\n  }\n\n  private async attemptConnection(options?: {\n    maxConnectionAttempts?: number;\n    notifyIfConnectionFailed?: boolean;\n  }): Promise<boolean> {\n    const maxAttempts = options?.maxConnectionAttempts ?? 1;\n    const ws = this.settings.webSocketServerEndpoint;\n    if (!ws) return false;\n\n    const portList = this.getPortList(ws.port, ws.portCandidateRule ?? undefined);\n    const hasPortRule = portList.length > 1;\n\n    if (hasPortRule) {\n      // 有 portCandidateRule 时：遍历端口列表，依次尝试 9100、9101、9102...\n      logger.debug(`[ConnectionManager] attemptConnection 遍历端口列表，共 ${portList.length} 个端口`);\n      for (const port of portList) {\n        try {\n          const client = new WebSocketClient(ws.address, port, ws.path, ws.useTls);\n          if (await client.connectWithServer()) {\n            const ok = await this.performHandshake(client);\n            if (ok) {\n              await this.transportClient.close();\n              this.transportClient = client;\n              this.bindTransportEvents();\n              const registered = await this.componentProvider.communicationAgent.register();\n              if (registered) {\n                logger.info(`客户端(${this.clientName})注册成功.`);\n              }\n              this.notifyConnectionResult(true, undefined);\n              return true;\n            }\n            await client.close();\n          }\n        } catch (e) {\n          this.handleConnectionException(e);\n        }\n      }\n    } else {\n      // 无 portCandidateRule：沿用原逻辑，重试同一端口\n      logger.debug(`[ConnectionManager] attemptConnection maxAttempts=${maxAttempts}`);\n      for (let attempt = 0; attempt < maxAttempts; attempt += 1) {\n        try {\n          if (await this.transportClient.connectWithServer()) {\n            const ok = await this.performHandshake(this.transportClient);\n            if (ok) {\n              const registered = await this.componentProvider.communicationAgent.register();\n              if (registered) {\n                logger.info(`客户端(${this.clientName})注册成功.`);\n              }\n              this.notifyConnectionResult(true, undefined);\n              return true;\n            }\n            await this.transportClient.close();\n          }\n        } catch (e) {\n          this.handleConnectionException(e);\n        }\n      }\n    }\n\n    if (options?.notifyIfConnectionFailed ?? true) {\n      this.handleConnectionFailed();\n    }\n    return false;\n  }\n\n  private handleConnectionFailed(launchError?: string): void {\n    const message = launchError\n      ? `Connect server socket failed! Launch error: ${launchError}`\n      : 'Connect server socket failed!';\n    const userInfo = launchError ? { launchError } : undefined;\n    this.notifyConnectionResult(\n      false,\n      new IpcError(IpcError.ERROR_BIND_SERVER, message, userInfo),\n    );\n    logger.error(`客户端('${this.clientName}')与服务端建立连接失败${launchError ? `: ${launchError}` : ''}`);\n  }\n\n  private handleConnectionException(e: unknown): void {\n    this.notifyConnectionResult(\n      false,\n      new IpcError(\n        IpcError.ERROR_BIND_SERVER_EXCEPTION,\n        'Connect server socket exception!',\n      ),\n    );\n    logger.error(`客户端('${this.clientName}')与服务端建立连接异常: ${String(e)}`);\n  }\n\n  private handleAlreadyConnected(handler?: IpcConnectionCompletionHandler): void {\n    if (handler) {\n      handler(true, undefined);\n    }\n  }\n\n  private shouldAttemptWakeUp(autoLaunchOverride?: boolean): boolean {\n    if (typeof autoLaunchOverride === 'boolean') {\n      return autoLaunchOverride;\n    }\n    const strategy: IpcMessageStrategy = this.settings.messageStrategy;\n    return strategy.autoLaunch;\n  }\n\n  private setupSessionAfterConnection(\n    request: Request,\n    callback: IpcSessionSetupCallback,\n    autoLaunch: boolean,\n  ): void {\n    const sessionCallbackId = this.generateSessionCallbackId(request);\n    const callbacks =\n      this.sessionSetupCallbacks.get(sessionCallbackId) ?? [];\n    callbacks.push(callback);\n    this.sessionSetupCallbacks.set(sessionCallbackId, callbacks);\n\n    // 仅首次构建目标会话时发起 IpcSessionSetupRequest（与 Flutter 一致）\n    if (callbacks.length === 1) {\n      const setupRequest = new IpcSessionSetupRequest(\n        this.clientName,\n        request.toClient,\n        sessionCallbackId,\n        autoLaunch,\n      );\n      setupSession(this.transportClient, setupRequest);\n    }\n  }\n\n  private onError(_error: unknown): void {\n    logger.error(`客户端('${this.clientName}')与服务端连接出错: ${String(_error)}!`);\n    this.notifyConnectionResult(\n      false,\n      new IpcError(IpcError.ERROR_DISCONNECTED_WITH_SERVER, 'Disconnected from server!'),\n    );\n  }\n\n  private onServerClose(): void {\n    logger.error(`客户端('${this.clientName}')断开与服务端的连接，服务端 socket 关闭!`);\n    this.notifyConnectionResult(\n      false,\n      new IpcError(IpcError.ERROR_SERVER_SOCKET_CLOSED, 'Server socket closed!'),\n    );\n  }\n\n  private notifyConnectionResult(success: boolean, error?: IpcError): void {\n    const handlers = this.connectionHandlers;\n    this.connectionHandlers = [];\n    for (const handler of handlers) {\n      handler(success, error ?? undefined);\n    }\n  }\n}\n\n"]}