moonbridge-ts 0.1.0

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MoonBridge IPC 客户端实际实现与注册表，对应 Flutter lib/client/internal/moonbridge_ipc_client.internal.dart。
+ * JS 端不实现 RPC（getService 恒返回 undefined）。
+ */
+import { IpcClientSettings } from './settings/ipc_client_settings';
+import { IpcConnectionCompletionHandler } from '../types/ipc_types';
+import { MoonBridgeIpcClient } from '../moonbridge_ipc_client';
+import { Messenger, MessageEndpoint, MessageCallOptions } from '../types/ipc_messenger';
+import { EventBus } from '../types/ipc_event_bus';
+import { IpcClientComponentProvider } from './ipc/ipc_client_component_provider';
+import { IpcConnectionManager } from './ipc/connect/ipc_connection_manager';
+import { IpcRequestCoordinator } from './ipc/coordinator/ipc_request_coordinator';
+import { IpcCommunicationAgent } from './ipc/communication/ipc_communication_agent';
+import { IpcEventBus } from './ipc/eventbus/ipc_event_bus';
+import { IpcConnectionKeeper } from './ipc/keep/ipc_connection_keeper';
+import { IpcClientBridge } from './bridge/ipc_client_bridge';
+/**
+ * 实际 IPC 客户端实现：继承组件装配，并实现 MoonBridgeIpcClient、Messenger。
+ * 装配顺序与 Flutter RealMoonBridgeIpcClient 一致；JS 不传入 moduleFactories（见 spec 012）。
+ */
+export declare class RealMoonBridgeIpcClient implements IpcClientComponentProvider, MoonBridgeIpcClient, Messenger {
+    readonly settings: IpcClientSettings;
+    readonly connectionManager: IpcConnectionManager;
+    readonly requestCoordinator: IpcRequestCoordinator;
+    readonly communicationAgent: IpcCommunicationAgent;
+    readonly ipcEventBus: IpcEventBus;
+    readonly connectionKeeper: IpcConnectionKeeper;
+    readonly bridge: IpcClientBridge;
+    constructor(settings: IpcClientSettings);
+    get clientName(): string;
+    connect(onResult?: IpcConnectionCompletionHandler): void;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    get messenger(): Messenger;
+    get eventBus(): EventBus;
+    postMessage(target: MessageEndpoint, argsOrOptions?: unknown[] | MessageCallOptions): void;
+    getService<T = unknown>(_clientName?: string): T | undefined;
+    private realPostMessage;
+}
+//# sourceMappingURL=moonbridge_ipc_client.internal.d.ts.map

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonbridge_ipc_client.internal.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,8BAA8B,EAAoB,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,0BAA0B,EAAE,mBAAmB,EAAE,SAAS;IACxG,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IACnD,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;gBAIrB,QAAQ,EAAE,iBAAiB;IAsBvC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,CAAC,QAAQ,CAAC,EAAE,8BAA8B,GAAG,IAAI;IAKlD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,WAAW,IAAI,OAAO;IAItB,IAAI,SAAS,IAAI,SAAS,CAEzB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,WAAW,CACT,MAAM,EAAE,eAAe,EACvB,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,kBAAkB,GAC7C,IAAI;IAwBP,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAM5D,OAAO,CAAC,eAAe;CAqCxB"}

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.js

@@ -0,0 +1,102 @@
+'use strict';
+
+var logger = require('../../utils/logger');
+var ipc_connection_manager = require('./ipc/connect/ipc_connection_manager');
+var ipc_request_coordinator = require('./ipc/coordinator/ipc_request_coordinator');
+var ipc_communication_agent = require('./ipc/communication/ipc_communication_agent');
+var ipc_event_bus = require('./ipc/eventbus/ipc_event_bus');
+var ipc_connection_keeper = require('./ipc/keep/ipc_connection_keeper');
+var ipc_client_bridge = require('./bridge/ipc_client_bridge');
+
+class RealMoonBridgeIpcClient {
+  // CONSTRUCTOR
+  constructor(settings) {
+    this.settings = settings;
+    this.connectionManager = new ipc_connection_manager.IpcConnectionManager(this);
+    this.requestCoordinator = new ipc_request_coordinator.IpcRequestCoordinator(this);
+    this.communicationAgent = new ipc_communication_agent.IpcCommunicationAgent(this);
+    this.ipcEventBus = new ipc_event_bus.IpcEventBus(this);
+    this.connectionKeeper = new ipc_connection_keeper.IpcConnectionKeeper(this);
+    this.bridge = new ipc_client_bridge.IpcClientBridge(this, this.communicationAgent);
+    this.connectionManager.initialize();
+    this.requestCoordinator.initialize();
+    this.communicationAgent.initialize();
+    this.ipcEventBus.initialize();
+    this.connectionKeeper.initialize();
+    this.bridge.initialize();
+    logger.logger.info(`[MoonBridgeIpcClient] \u5BA2\u6237\u7AEF "${settings.clientName}" \u5DF2\u521B\u5EFA`);
+  }
+  // PUBLIC METHODS
+  get clientName() {
+    return this.settings.clientName;
+  }
+  connect(onResult) {
+    this.connectionManager.connect(onResult);
+    this.connectionKeeper.startHeartbeat();
+  }
+  async disconnect() {
+    await this.connectionManager.disconnect();
+    this.connectionKeeper.stopHeartbeat();
+  }
+  isConnected() {
+    return this.connectionManager.isConnected();
+  }
+  get messenger() {
+    return this;
+  }
+  get eventBus() {
+    return this.ipcEventBus;
+  }
+  postMessage(target, argsOrOptions) {
+    var _a, _b;
+    const args = Array.isArray(argsOrOptions) ? argsOrOptions : (_a = argsOrOptions == null ? void 0 : argsOrOptions.args) != null ? _a : [];
+    const strategy = argsOrOptions && !Array.isArray(argsOrOptions) ? (_b = argsOrOptions.strategy) != null ? _b : this.settings.messageStrategy : this.settings.messageStrategy;
+    const onError = argsOrOptions && !Array.isArray(argsOrOptions) ? argsOrOptions.onError : void 0;
+    const remainingRetries = Math.max(strategy.retries, 0);
+    this.realPostMessage(
+      target.clientName,
+      target.moduleName,
+      target.methodName,
+      args,
+      onError,
+      strategy,
+      remainingRetries
+    );
+  }
+  getService(_clientName) {
+    return void 0;
+  }
+  // PRIVATE METHODS
+  realPostMessage(clientName, moduleName, methodName, argumentsList, onError, strategy, remainingRetries) {
+    const request = this.requestCoordinator.prepareAndCreateIpcRequest({
+      toClient: clientName,
+      moduleName,
+      methodName,
+      arguments: argumentsList,
+      onError
+    });
+    this.communicationAgent.sendRequestAfterSetupSession(
+      request,
+      strategy,
+      (success, error) => {
+        if (remainingRetries - 1 <= 0) {
+          if (!success && error) onError == null ? void 0 : onError(error);
+          return;
+        }
+        this.realPostMessage(
+          clientName,
+          moduleName,
+          methodName,
+          argumentsList,
+          onError,
+          strategy,
+          remainingRetries - 1
+        );
+      }
+    );
+  }
+}
+
+exports.RealMoonBridgeIpcClient = RealMoonBridgeIpcClient;
+//# sourceMappingURL=moonbridge_ipc_client.internal.js.map
+//# sourceMappingURL=moonbridge_ipc_client.internal.js.map

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.ts"],"names":["IpcConnectionManager","IpcRequestCoordinator","IpcCommunicationAgent","IpcEventBus","IpcConnectionKeeper","IpcClientBridge","logger"],"mappings":"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","file":"moonbridge_ipc_client.internal.js","sourcesContent":["/**\n * MoonBridge IPC 客户端实际实现与注册表，对应 Flutter lib/client/internal/moonbridge_ipc_client.internal.dart。\n * JS 端不实现 RPC（getService 恒返回 undefined）。\n */\n\nimport { IpcClientSettings } from './settings/ipc_client_settings';\nimport { IpcMessageStrategy } from '../types/ipc_message_strategy';\nimport { IpcConnectionCompletionHandler, IpcErrorCallback } from '../types/ipc_types';\nimport { MoonBridgeIpcClient } from '../moonbridge_ipc_client';\nimport { Messenger, MessageEndpoint, MessageCallOptions } from '../types/ipc_messenger';\nimport { EventBus } from '../types/ipc_event_bus';\nimport { logger } from '../../utils/logger';\nimport { IpcClientComponentProvider } from './ipc/ipc_client_component_provider';\nimport { IpcConnectionManager } from './ipc/connect/ipc_connection_manager';\nimport { IpcRequestCoordinator } from './ipc/coordinator/ipc_request_coordinator';\nimport { IpcCommunicationAgent } from './ipc/communication/ipc_communication_agent';\nimport { IpcEventBus } from './ipc/eventbus/ipc_event_bus';\nimport { IpcConnectionKeeper } from './ipc/keep/ipc_connection_keeper';\nimport { IpcClientBridge } from './bridge/ipc_client_bridge';\n\n/**\n * 实际 IPC 客户端实现：继承组件装配，并实现 MoonBridgeIpcClient、Messenger。\n * 装配顺序与 Flutter RealMoonBridgeIpcClient 一致；JS 不传入 moduleFactories（见 spec 012）。\n */\nexport class RealMoonBridgeIpcClient implements IpcClientComponentProvider, MoonBridgeIpcClient, Messenger {\n  readonly settings: IpcClientSettings;\n  readonly connectionManager: IpcConnectionManager;\n  readonly requestCoordinator: IpcRequestCoordinator;\n  readonly communicationAgent: IpcCommunicationAgent;\n  readonly ipcEventBus: IpcEventBus;\n  readonly connectionKeeper: IpcConnectionKeeper;\n  readonly bridge: IpcClientBridge;\n\n  // CONSTRUCTOR\n\n  constructor(settings: IpcClientSettings) {\n    this.settings = settings;\n\n    this.connectionManager = new IpcConnectionManager(this);\n    this.requestCoordinator = new IpcRequestCoordinator(this);\n    this.communicationAgent = new IpcCommunicationAgent(this);\n    this.ipcEventBus = new IpcEventBus(this);\n    this.connectionKeeper = new IpcConnectionKeeper(this);\n    this.bridge = new IpcClientBridge(this, this.communicationAgent);\n\n    this.connectionManager.initialize();\n    this.requestCoordinator.initialize();\n    this.communicationAgent.initialize();\n    this.ipcEventBus.initialize();\n    this.connectionKeeper.initialize();\n    this.bridge.initialize();\n\n    logger.info(`[MoonBridgeIpcClient] 客户端 \"${settings.clientName}\" 已创建`);\n  }\n\n  // PUBLIC METHODS\n\n  get clientName(): string {\n    return this.settings.clientName;\n  }\n\n  connect(onResult?: IpcConnectionCompletionHandler): void {\n    this.connectionManager.connect(onResult);\n    this.connectionKeeper.startHeartbeat();\n  }\n\n  async disconnect(): Promise<void> {\n    await this.connectionManager.disconnect();\n    this.connectionKeeper.stopHeartbeat();\n  }\n\n  isConnected(): boolean {\n    return this.connectionManager.isConnected();\n  }\n\n  get messenger(): Messenger {\n    return this;\n  }\n\n  get eventBus(): EventBus {\n    return this.ipcEventBus;\n  }\n\n  postMessage(\n    target: MessageEndpoint,\n    argsOrOptions?: unknown[] | MessageCallOptions,\n  ): void {\n    const args = Array.isArray(argsOrOptions)\n      ? argsOrOptions\n      : (argsOrOptions?.args ?? []);\n    const strategy =\n      argsOrOptions && !Array.isArray(argsOrOptions)\n        ? argsOrOptions.strategy ?? this.settings.messageStrategy\n        : this.settings.messageStrategy;\n    const onError =\n      argsOrOptions && !Array.isArray(argsOrOptions)\n        ? argsOrOptions.onError\n        : undefined;\n    const remainingRetries = Math.max(strategy.retries, 0);\n    this.realPostMessage(\n      target.clientName,\n      target.moduleName,\n      target.methodName,\n      args,\n      onError,\n      strategy,\n      remainingRetries,\n    );\n  }\n\n  getService<T = unknown>(_clientName?: string): T | undefined {\n    return undefined;\n  }\n\n  // PRIVATE METHODS\n\n  private realPostMessage(\n    clientName: string,\n    moduleName: string,\n    methodName: string,\n    argumentsList: unknown[],\n    onError: IpcErrorCallback | undefined,\n    strategy: IpcMessageStrategy,\n    remainingRetries: number,\n  ): void {\n    const request = this.requestCoordinator.prepareAndCreateIpcRequest({\n      toClient: clientName,\n      moduleName,\n      methodName,\n      arguments: argumentsList,\n      onError,\n    });\n\n    this.communicationAgent.sendRequestAfterSetupSession(\n      request,\n      strategy,\n      (success, error) => {\n        if (remainingRetries - 1 <= 0) {\n          if (!success && error) onError?.(error);\n          return;\n        }\n        this.realPostMessage(\n          clientName,\n          moduleName,\n          methodName,\n          argumentsList,\n          onError,\n          strategy,\n          remainingRetries - 1,\n        );\n      },\n    );\n  }\n}\n"]}

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.mjs

@@ -0,0 +1,100 @@
+import { logger } from '../../utils/logger';
+import { IpcConnectionManager } from './ipc/connect/ipc_connection_manager';
+import { IpcRequestCoordinator } from './ipc/coordinator/ipc_request_coordinator';
+import { IpcCommunicationAgent } from './ipc/communication/ipc_communication_agent';
+import { IpcEventBus } from './ipc/eventbus/ipc_event_bus';
+import { IpcConnectionKeeper } from './ipc/keep/ipc_connection_keeper';
+import { IpcClientBridge } from './bridge/ipc_client_bridge';
+
+class RealMoonBridgeIpcClient {
+  // CONSTRUCTOR
+  constructor(settings) {
+    this.settings = settings;
+    this.connectionManager = new IpcConnectionManager(this);
+    this.requestCoordinator = new IpcRequestCoordinator(this);
+    this.communicationAgent = new IpcCommunicationAgent(this);
+    this.ipcEventBus = new IpcEventBus(this);
+    this.connectionKeeper = new IpcConnectionKeeper(this);
+    this.bridge = new IpcClientBridge(this, this.communicationAgent);
+    this.connectionManager.initialize();
+    this.requestCoordinator.initialize();
+    this.communicationAgent.initialize();
+    this.ipcEventBus.initialize();
+    this.connectionKeeper.initialize();
+    this.bridge.initialize();
+    logger.info(`[MoonBridgeIpcClient] \u5BA2\u6237\u7AEF "${settings.clientName}" \u5DF2\u521B\u5EFA`);
+  }
+  // PUBLIC METHODS
+  get clientName() {
+    return this.settings.clientName;
+  }
+  connect(onResult) {
+    this.connectionManager.connect(onResult);
+    this.connectionKeeper.startHeartbeat();
+  }
+  async disconnect() {
+    await this.connectionManager.disconnect();
+    this.connectionKeeper.stopHeartbeat();
+  }
+  isConnected() {
+    return this.connectionManager.isConnected();
+  }
+  get messenger() {
+    return this;
+  }
+  get eventBus() {
+    return this.ipcEventBus;
+  }
+  postMessage(target, argsOrOptions) {
+    var _a, _b;
+    const args = Array.isArray(argsOrOptions) ? argsOrOptions : (_a = argsOrOptions == null ? void 0 : argsOrOptions.args) != null ? _a : [];
+    const strategy = argsOrOptions && !Array.isArray(argsOrOptions) ? (_b = argsOrOptions.strategy) != null ? _b : this.settings.messageStrategy : this.settings.messageStrategy;
+    const onError = argsOrOptions && !Array.isArray(argsOrOptions) ? argsOrOptions.onError : void 0;
+    const remainingRetries = Math.max(strategy.retries, 0);
+    this.realPostMessage(
+      target.clientName,
+      target.moduleName,
+      target.methodName,
+      args,
+      onError,
+      strategy,
+      remainingRetries
+    );
+  }
+  getService(_clientName) {
+    return void 0;
+  }
+  // PRIVATE METHODS
+  realPostMessage(clientName, moduleName, methodName, argumentsList, onError, strategy, remainingRetries) {
+    const request = this.requestCoordinator.prepareAndCreateIpcRequest({
+      toClient: clientName,
+      moduleName,
+      methodName,
+      arguments: argumentsList,
+      onError
+    });
+    this.communicationAgent.sendRequestAfterSetupSession(
+      request,
+      strategy,
+      (success, error) => {
+        if (remainingRetries - 1 <= 0) {
+          if (!success && error) onError == null ? void 0 : onError(error);
+          return;
+        }
+        this.realPostMessage(
+          clientName,
+          moduleName,
+          methodName,
+          argumentsList,
+          onError,
+          strategy,
+          remainingRetries - 1
+        );
+      }
+    );
+  }
+}
+
+export { RealMoonBridgeIpcClient };
+//# sourceMappingURL=moonbridge_ipc_client.internal.mjs.map
+//# sourceMappingURL=moonbridge_ipc_client.internal.mjs.map

package/dist/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/internal/moonbridge_ipc_client.internal.ts"],"names":[],"mappings":"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","file":"moonbridge_ipc_client.internal.mjs","sourcesContent":["/**\n * MoonBridge IPC 客户端实际实现与注册表，对应 Flutter lib/client/internal/moonbridge_ipc_client.internal.dart。\n * JS 端不实现 RPC（getService 恒返回 undefined）。\n */\n\nimport { IpcClientSettings } from './settings/ipc_client_settings';\nimport { IpcMessageStrategy } from '../types/ipc_message_strategy';\nimport { IpcConnectionCompletionHandler, IpcErrorCallback } from '../types/ipc_types';\nimport { MoonBridgeIpcClient } from '../moonbridge_ipc_client';\nimport { Messenger, MessageEndpoint, MessageCallOptions } from '../types/ipc_messenger';\nimport { EventBus } from '../types/ipc_event_bus';\nimport { logger } from '../../utils/logger';\nimport { IpcClientComponentProvider } from './ipc/ipc_client_component_provider';\nimport { IpcConnectionManager } from './ipc/connect/ipc_connection_manager';\nimport { IpcRequestCoordinator } from './ipc/coordinator/ipc_request_coordinator';\nimport { IpcCommunicationAgent } from './ipc/communication/ipc_communication_agent';\nimport { IpcEventBus } from './ipc/eventbus/ipc_event_bus';\nimport { IpcConnectionKeeper } from './ipc/keep/ipc_connection_keeper';\nimport { IpcClientBridge } from './bridge/ipc_client_bridge';\n\n/**\n * 实际 IPC 客户端实现：继承组件装配，并实现 MoonBridgeIpcClient、Messenger。\n * 装配顺序与 Flutter RealMoonBridgeIpcClient 一致；JS 不传入 moduleFactories（见 spec 012）。\n */\nexport class RealMoonBridgeIpcClient implements IpcClientComponentProvider, MoonBridgeIpcClient, Messenger {\n  readonly settings: IpcClientSettings;\n  readonly connectionManager: IpcConnectionManager;\n  readonly requestCoordinator: IpcRequestCoordinator;\n  readonly communicationAgent: IpcCommunicationAgent;\n  readonly ipcEventBus: IpcEventBus;\n  readonly connectionKeeper: IpcConnectionKeeper;\n  readonly bridge: IpcClientBridge;\n\n  // CONSTRUCTOR\n\n  constructor(settings: IpcClientSettings) {\n    this.settings = settings;\n\n    this.connectionManager = new IpcConnectionManager(this);\n    this.requestCoordinator = new IpcRequestCoordinator(this);\n    this.communicationAgent = new IpcCommunicationAgent(this);\n    this.ipcEventBus = new IpcEventBus(this);\n    this.connectionKeeper = new IpcConnectionKeeper(this);\n    this.bridge = new IpcClientBridge(this, this.communicationAgent);\n\n    this.connectionManager.initialize();\n    this.requestCoordinator.initialize();\n    this.communicationAgent.initialize();\n    this.ipcEventBus.initialize();\n    this.connectionKeeper.initialize();\n    this.bridge.initialize();\n\n    logger.info(`[MoonBridgeIpcClient] 客户端 \"${settings.clientName}\" 已创建`);\n  }\n\n  // PUBLIC METHODS\n\n  get clientName(): string {\n    return this.settings.clientName;\n  }\n\n  connect(onResult?: IpcConnectionCompletionHandler): void {\n    this.connectionManager.connect(onResult);\n    this.connectionKeeper.startHeartbeat();\n  }\n\n  async disconnect(): Promise<void> {\n    await this.connectionManager.disconnect();\n    this.connectionKeeper.stopHeartbeat();\n  }\n\n  isConnected(): boolean {\n    return this.connectionManager.isConnected();\n  }\n\n  get messenger(): Messenger {\n    return this;\n  }\n\n  get eventBus(): EventBus {\n    return this.ipcEventBus;\n  }\n\n  postMessage(\n    target: MessageEndpoint,\n    argsOrOptions?: unknown[] | MessageCallOptions,\n  ): void {\n    const args = Array.isArray(argsOrOptions)\n      ? argsOrOptions\n      : (argsOrOptions?.args ?? []);\n    const strategy =\n      argsOrOptions && !Array.isArray(argsOrOptions)\n        ? argsOrOptions.strategy ?? this.settings.messageStrategy\n        : this.settings.messageStrategy;\n    const onError =\n      argsOrOptions && !Array.isArray(argsOrOptions)\n        ? argsOrOptions.onError\n        : undefined;\n    const remainingRetries = Math.max(strategy.retries, 0);\n    this.realPostMessage(\n      target.clientName,\n      target.moduleName,\n      target.methodName,\n      args,\n      onError,\n      strategy,\n      remainingRetries,\n    );\n  }\n\n  getService<T = unknown>(_clientName?: string): T | undefined {\n    return undefined;\n  }\n\n  // PRIVATE METHODS\n\n  private realPostMessage(\n    clientName: string,\n    moduleName: string,\n    methodName: string,\n    argumentsList: unknown[],\n    onError: IpcErrorCallback | undefined,\n    strategy: IpcMessageStrategy,\n    remainingRetries: number,\n  ): void {\n    const request = this.requestCoordinator.prepareAndCreateIpcRequest({\n      toClient: clientName,\n      moduleName,\n      methodName,\n      arguments: argumentsList,\n      onError,\n    });\n\n    this.communicationAgent.sendRequestAfterSetupSession(\n      request,\n      strategy,\n      (success, error) => {\n        if (remainingRetries - 1 <= 0) {\n          if (!success && error) onError?.(error);\n          return;\n        }\n        this.realPostMessage(\n          clientName,\n          moduleName,\n          methodName,\n          argumentsList,\n          onError,\n          strategy,\n          remainingRetries - 1,\n        );\n      },\n    );\n  }\n}\n"]}

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.d.mts

@@ -0,0 +1,90 @@
+import { WebSocketServerEndpoint } from '../../../general/config/websocket_server_endpoint.mjs';
+import { AppInstallationPath, AppLaunchIdentifier } from '../../../general/app_launch/model/app_info.mjs';
+import { AppLauncher } from '../../../general/app_launch/app_launcher.mjs';
+import { IpcMessageStrategy } from '../../types/ipc_message_strategy.mjs';
+import { MessageInterceptor, ConnectionObserver } from '../../types/ipc_types.mjs';
+import '../../../general/config/port_candidate_rule.mjs';
+import '../../../general/app_launch/model/app_launch_models.mjs';
+import '../../../general/error/ipc_error.mjs';
+import '../../../general/message/request.mjs';
+import '../../../general/message/response.mjs';
+import '../../../general/message/error.mjs';
+
+/**
+ * 构造函数参数类型。
+ * 使用独立的 options 类型，避免在构造函数上直接声明复杂对象类型。
+ */
+interface IpcClientSettingsOptions {
+    clientName: string;
+    serverInstallationPath?: AppInstallationPath;
+    serverLaunchIdentifier?: AppLaunchIdentifier;
+    enableHeartbeat?: boolean;
+    /**
+     * 心跳检测间隔时间（毫秒）。与 Flutter Duration 对应：默认 3000 即 Flutter 的 Duration(seconds: 3)。
+     */
+    heartbeatIntervalMs?: number;
+    messageStrategy?: IpcMessageStrategy;
+    messageInterceptor?: MessageInterceptor;
+    connectionObserver?: ConnectionObserver;
+    webSocketServerEndpoint?: WebSocketServerEndpoint;
+    /** US4：可选注入，用于跨进程唤醒服务端；未提供时使用 StubAppLauncher */
+    appLauncher?: AppLauncher;
+    /**
+     * 019：唤醒后连接探测间隔（毫秒）；默认 400。
+     * 每次连接尝试失败后等待此间隔再重试。
+     */
+    wakeUpProbeIntervalMs?: number;
+    /**
+     * 019：唤醒后连接探测总超时（毫秒）；默认 12000。
+     * 超过此时长未连上则返回失败。
+     */
+    wakeUpProbeTimeoutMs?: number;
+}
+/**
+ * IPC 客户端配置类。
+ *
+ * 传输方式由 socketServerEndpoint 或 webSocketServerEndpoint 二选一决定，至多一个非 null。
+ */
+declare class IpcClientSettings {
+    /** 客户端名称 */
+    readonly clientName: string;
+    /** 服务器应用路径，用于唤醒服务器应用 */
+    readonly serverInstallationPath?: AppInstallationPath;
+    /** 服务端应用标识符信息，用于唤醒服务器应用 */
+    readonly serverLaunchIdentifier?: AppLaunchIdentifier;
+    /** 是否启用心跳检测 */
+    readonly enableHeartbeat: boolean;
+    /** 心跳检测间隔时间（毫秒） */
+    readonly heartbeatInterval: number;
+    /** 消息策略 */
+    readonly messageStrategy: IpcMessageStrategy;
+    /** 消息拦截器，可选 */
+    readonly messageInterceptor?: MessageInterceptor;
+    /** 连接状态观察者，可选 */
+    readonly connectionObserver?: ConnectionObserver;
+    /**
+     * WebSocket 连接配置；
+     */
+    readonly webSocketServerEndpoint?: WebSocketServerEndpoint;
+    /** JS 扩展：可选注入的唤醒器（Flutter 暂无此字段）；未提供时 ConnectionManager 使用 StubAppLauncher。 */
+    readonly appLauncher?: AppLauncher;
+    /** 019：唤醒后连接探测间隔（毫秒）；默认 400 */
+    readonly wakeUpProbeIntervalMs: number;
+    /** 019：唤醒后连接探测总超时（毫秒）；默认 12000 */
+    readonly wakeUpProbeTimeoutMs: number;
+    constructor(options: IpcClientSettingsOptions);
+    /** 有效服务端地址（来自当前使用的传输配置） */
+    get serverAddress(): string;
+    /** 有效服务端端口（来自当前使用的传输配置） */
+    get serverPort(): number;
+    /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */
+    get useWebSocket(): boolean;
+    /** WebSocket 端口（仅当使用 WebSocket 时有效） */
+    get webSocketPort(): number | undefined;
+    /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */
+    get webSocketPath(): string;
+    /** 是否使用 wss（仅当使用 WebSocket 时有效） */
+    get useTls(): boolean;
+}
+
+export { IpcClientSettings, type IpcClientSettingsOptions };

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.d.ts

@@ -0,0 +1,82 @@
+import { WebSocketServerEndpoint } from '../../../general/config/websocket_server_endpoint';
+import { AppInstallationPath, AppLaunchIdentifier } from '../../../general/app_launch/model/app_info';
+import { AppLauncher } from '../../../general/app_launch/app_launcher';
+import { IpcMessageStrategy } from '../../types/ipc_message_strategy';
+import { ConnectionObserver, MessageInterceptor } from '../../types/ipc_types';
+/**
+ * 构造函数参数类型。
+ * 使用独立的 options 类型，避免在构造函数上直接声明复杂对象类型。
+ */
+export interface IpcClientSettingsOptions {
+    clientName: string;
+    serverInstallationPath?: AppInstallationPath;
+    serverLaunchIdentifier?: AppLaunchIdentifier;
+    enableHeartbeat?: boolean;
+    /**
+     * 心跳检测间隔时间（毫秒）。与 Flutter Duration 对应：默认 3000 即 Flutter 的 Duration(seconds: 3)。
+     */
+    heartbeatIntervalMs?: number;
+    messageStrategy?: IpcMessageStrategy;
+    messageInterceptor?: MessageInterceptor;
+    connectionObserver?: ConnectionObserver;
+    webSocketServerEndpoint?: WebSocketServerEndpoint;
+    /** US4：可选注入，用于跨进程唤醒服务端；未提供时使用 StubAppLauncher */
+    appLauncher?: AppLauncher;
+    /**
+     * 019：唤醒后连接探测间隔（毫秒）；默认 400。
+     * 每次连接尝试失败后等待此间隔再重试。
+     */
+    wakeUpProbeIntervalMs?: number;
+    /**
+     * 019：唤醒后连接探测总超时（毫秒）；默认 12000。
+     * 超过此时长未连上则返回失败。
+     */
+    wakeUpProbeTimeoutMs?: number;
+}
+/**
+ * IPC 客户端配置类。
+ *
+ * 传输方式由 socketServerEndpoint 或 webSocketServerEndpoint 二选一决定，至多一个非 null。
+ */
+export declare class IpcClientSettings {
+    /** 客户端名称 */
+    readonly clientName: string;
+    /** 服务器应用路径，用于唤醒服务器应用 */
+    readonly serverInstallationPath?: AppInstallationPath;
+    /** 服务端应用标识符信息，用于唤醒服务器应用 */
+    readonly serverLaunchIdentifier?: AppLaunchIdentifier;
+    /** 是否启用心跳检测 */
+    readonly enableHeartbeat: boolean;
+    /** 心跳检测间隔时间（毫秒） */
+    readonly heartbeatInterval: number;
+    /** 消息策略 */
+    readonly messageStrategy: IpcMessageStrategy;
+    /** 消息拦截器，可选 */
+    readonly messageInterceptor?: MessageInterceptor;
+    /** 连接状态观察者，可选 */
+    readonly connectionObserver?: ConnectionObserver;
+    /**
+     * WebSocket 连接配置；
+     */
+    readonly webSocketServerEndpoint?: WebSocketServerEndpoint;
+    /** JS 扩展：可选注入的唤醒器（Flutter 暂无此字段）；未提供时 ConnectionManager 使用 StubAppLauncher。 */
+    readonly appLauncher?: AppLauncher;
+    /** 019：唤醒后连接探测间隔（毫秒）；默认 400 */
+    readonly wakeUpProbeIntervalMs: number;
+    /** 019：唤醒后连接探测总超时（毫秒）；默认 12000 */
+    readonly wakeUpProbeTimeoutMs: number;
+    constructor(options: IpcClientSettingsOptions);
+    /** 有效服务端地址（来自当前使用的传输配置） */
+    get serverAddress(): string;
+    /** 有效服务端端口（来自当前使用的传输配置） */
+    get serverPort(): number;
+    /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */
+    get useWebSocket(): boolean;
+    /** WebSocket 端口（仅当使用 WebSocket 时有效） */
+    get webSocketPort(): number | undefined;
+    /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */
+    get webSocketPath(): string;
+    /** 是否使用 wss（仅当使用 WebSocket 时有效） */
+    get useTls(): boolean;
+}
+//# sourceMappingURL=ipc_client_settings.d.ts.map

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_client_settings.d.ts","sourceRoot":"","sources":["../../../../../src/moonbridge-ipc/client/internal/settings/ipc_client_settings.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAS/E;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAC7C,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,YAAY;IACZ,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,wBAAwB;IACxB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAEtD,2BAA2B;IAC3B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,mBAAmB,CAAC;IAEtD,eAAe;IACf,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,mBAAmB;IACnB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,WAAW;IACX,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAE7C,eAAe;IACf,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAEjD,iBAAiB;IACjB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAE3D,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC,+BAA+B;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAEvC,kCAAkC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;gBAE1B,OAAO,EAAE,wBAAwB;IAe7C,2BAA2B;IAC3B,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,2BAA2B;IAC3B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,yCAAyC;IACzC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,uCAAuC;IACvC,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,yCAAyC;IACzC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,mCAAmC;IACnC,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF"}

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.js

@@ -0,0 +1,55 @@
+'use strict';
+
+var ipc_message_strategy = require('../../types/ipc_message_strategy');
+
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 3e3;
+const DEFAULT_WAKE_UP_PROBE_INTERVAL_MS = 400;
+const DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS = 12e3;
+class IpcClientSettings {
+  constructor(options) {
+    var _a, _b, _c, _d, _e;
+    this.clientName = options.clientName;
+    this.serverInstallationPath = options.serverInstallationPath;
+    this.serverLaunchIdentifier = options.serverLaunchIdentifier;
+    this.enableHeartbeat = (_a = options.enableHeartbeat) != null ? _a : true;
+    this.heartbeatInterval = (_b = options.heartbeatIntervalMs) != null ? _b : DEFAULT_HEARTBEAT_INTERVAL_MS;
+    this.messageStrategy = (_c = options.messageStrategy) != null ? _c : new ipc_message_strategy.IpcMessageStrategy();
+    this.messageInterceptor = options.messageInterceptor;
+    this.connectionObserver = options.connectionObserver;
+    this.webSocketServerEndpoint = options.webSocketServerEndpoint;
+    this.appLauncher = options.appLauncher;
+    this.wakeUpProbeIntervalMs = (_d = options.wakeUpProbeIntervalMs) != null ? _d : DEFAULT_WAKE_UP_PROBE_INTERVAL_MS;
+    this.wakeUpProbeTimeoutMs = (_e = options.wakeUpProbeTimeoutMs) != null ? _e : DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS;
+  }
+  /** 有效服务端地址（来自当前使用的传输配置） */
+  get serverAddress() {
+    return this.webSocketServerEndpoint.address;
+  }
+  /** 有效服务端端口（来自当前使用的传输配置） */
+  get serverPort() {
+    return this.webSocketServerEndpoint.port;
+  }
+  /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */
+  get useWebSocket() {
+    return this.webSocketServerEndpoint != null;
+  }
+  /** WebSocket 端口（仅当使用 WebSocket 时有效） */
+  get webSocketPort() {
+    var _a;
+    return (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.port;
+  }
+  /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */
+  get webSocketPath() {
+    var _a, _b;
+    return (_b = (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.path) != null ? _b : "/";
+  }
+  /** 是否使用 wss（仅当使用 WebSocket 时有效） */
+  get useTls() {
+    var _a, _b;
+    return (_b = (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.useTls) != null ? _b : false;
+  }
+}
+
+exports.IpcClientSettings = IpcClientSettings;
+//# sourceMappingURL=ipc_client_settings.js.map
+//# sourceMappingURL=ipc_client_settings.js.map

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/client/internal/settings/ipc_client_settings.ts"],"names":["IpcMessageStrategy"],"mappings":";;;;AAcA,MAAM,6BAAA,GAAgC,GAAA;AAEtC,MAAM,iCAAA,GAAoC,GAAA;AAE1C,MAAM,gCAAA,GAAmC,IAAA;AAsClC,MAAM,iBAAA,CAAkB;AAAA,EAuC7B,YAAY,OAAA,EAAmC;AA/FjD,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AAgGI,IAAA,IAAA,CAAK,aAAa,OAAA,CAAQ,UAAA;AAC1B,IAAA,IAAA,CAAK,yBAAyB,OAAA,CAAQ,sBAAA;AACtC,IAAA,IAAA,CAAK,yBAAyB,OAAA,CAAQ,sBAAA;AACtC,IAAA,IAAA,CAAK,eAAA,GAAA,CAAkB,EAAA,GAAA,OAAA,CAAQ,eAAA,KAAR,IAAA,GAAA,EAAA,GAA2B,IAAA;AAClD,IAAA,IAAA,CAAK,iBAAA,GAAA,CAAoB,EAAA,GAAA,OAAA,CAAQ,mBAAA,KAAR,IAAA,GAAA,EAAA,GAA+B,6BAAA;AACxD,IAAA,IAAA,CAAK,eAAA,GAAA,CAAkB,EAAA,GAAA,OAAA,CAAQ,eAAA,KAAR,IAAA,GAAA,EAAA,GAA2B,IAAIA,uCAAA,EAAmB;AACzE,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAClC,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAClC,IAAA,IAAA,CAAK,0BAA0B,OAAA,CAAQ,uBAAA;AACvC,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAC3B,IAAA,IAAA,CAAK,qBAAA,GAAA,CAAwB,EAAA,GAAA,OAAA,CAAQ,qBAAA,KAAR,IAAA,GAAA,EAAA,GAAiC,iCAAA;AAC9D,IAAA,IAAA,CAAK,oBAAA,GAAA,CAAuB,EAAA,GAAA,OAAA,CAAQ,oBAAA,KAAR,IAAA,GAAA,EAAA,GAAgC,gCAAA;AAAA,EAC9D;AAAA;AAAA,EAGA,IAAI,aAAA,GAAwB;AAC1B,IAAA,OAAO,KAAK,uBAAA,CAAyB,OAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,UAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,uBAAA,CAAyB,IAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,YAAA,GAAwB;AAC1B,IAAA,OAAO,KAAK,uBAAA,IAA2B,IAAA;AAAA,EACzC;AAAA;AAAA,EAGA,IAAI,aAAA,GAAoC;AA9H1C,IAAA,IAAA,EAAA;AA+HI,IAAA,OAAA,CAAO,EAAA,GAAA,IAAA,CAAK,4BAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,IAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,aAAA,GAAwB;AAnI9B,IAAA,IAAA,EAAA,EAAA,EAAA;AAoII,IAAA,OAAA,CAAO,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,uBAAA,KAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,IAAA,KAA9B,IAAA,GAAA,EAAA,GAAsC,GAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,IAAI,MAAA,GAAkB;AAxIxB,IAAA,IAAA,EAAA,EAAA,EAAA;AAyII,IAAA,OAAA,CAAO,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,uBAAA,KAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,MAAA,KAA9B,IAAA,GAAA,EAAA,GAAwC,KAAA;AAAA,EACjD;AACF","file":"ipc_client_settings.js","sourcesContent":["// IPC 客户端配置，对应\n// moonbridge-ipc-flutter/lib/client/internal/settings/ipc_client_settings.dart\n// 012 US3：字段、必填/可选、默认值与 Flutter 一致；appLauncher 为 JS 扩展；heartbeatInterval 用毫秒存储，默认 3000 对应 Flutter Duration(seconds: 3)。\n\nimport { WebSocketServerEndpoint } from '../../../general/config/websocket_server_endpoint';\nimport {\n  AppInstallationPath,\n  AppLaunchIdentifier,\n} from '../../../general/app_launch/model/app_info';\nimport { AppLauncher } from '../../../general/app_launch/app_launcher';\nimport { IpcMessageStrategy } from '../../types/ipc_message_strategy';\nimport { ConnectionObserver, MessageInterceptor } from '../../types/ipc_types';\n\n/** 心跳间隔默认值（毫秒），对应 Flutter Duration(seconds: 3) */\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 3000;\n/** 唤醒后连接探测间隔（毫秒），每次失败后等待再重试 */\nconst DEFAULT_WAKE_UP_PROBE_INTERVAL_MS = 400;\n/** 唤醒后连接探测总超时（毫秒），超过则返回失败 */\nconst DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS = 12000;\n\n/**\n * 构造函数参数类型。\n * 使用独立的 options 类型，避免在构造函数上直接声明复杂对象类型。\n */\nexport interface IpcClientSettingsOptions {\n  clientName: string;\n  serverInstallationPath?: AppInstallationPath;\n  serverLaunchIdentifier?: AppLaunchIdentifier;\n  enableHeartbeat?: boolean;\n  /**\n   * 心跳检测间隔时间（毫秒）。与 Flutter Duration 对应：默认 3000 即 Flutter 的 Duration(seconds: 3)。\n   */\n  heartbeatIntervalMs?: number;\n  messageStrategy?: IpcMessageStrategy;\n  messageInterceptor?: MessageInterceptor;\n  connectionObserver?: ConnectionObserver;\n  webSocketServerEndpoint?: WebSocketServerEndpoint;\n  /** US4：可选注入，用于跨进程唤醒服务端；未提供时使用 StubAppLauncher */\n  appLauncher?: AppLauncher;\n  /**\n   * 019：唤醒后连接探测间隔（毫秒）；默认 400。\n   * 每次连接尝试失败后等待此间隔再重试。\n   */\n  wakeUpProbeIntervalMs?: number;\n  /**\n   * 019：唤醒后连接探测总超时（毫秒）；默认 12000。\n   * 超过此时长未连上则返回失败。\n   */\n  wakeUpProbeTimeoutMs?: number;\n}\n\n/**\n * IPC 客户端配置类。\n *\n * 传输方式由 socketServerEndpoint 或 webSocketServerEndpoint 二选一决定，至多一个非 null。\n */\nexport class IpcClientSettings {\n  /** 客户端名称 */\n  readonly clientName: string;\n\n  /** 服务器应用路径，用于唤醒服务器应用 */\n  readonly serverInstallationPath?: AppInstallationPath;\n\n  /** 服务端应用标识符信息，用于唤醒服务器应用 */\n  readonly serverLaunchIdentifier?: AppLaunchIdentifier;\n\n  /** 是否启用心跳检测 */\n  readonly enableHeartbeat: boolean;\n\n  /** 心跳检测间隔时间（毫秒） */\n  readonly heartbeatInterval: number;\n\n  /** 消息策略 */\n  readonly messageStrategy: IpcMessageStrategy;\n\n  /** 消息拦截器，可选 */\n  readonly messageInterceptor?: MessageInterceptor;\n\n  /** 连接状态观察者，可选 */\n  readonly connectionObserver?: ConnectionObserver;\n\n  /**\n   * WebSocket 连接配置；\n   */\n  readonly webSocketServerEndpoint?: WebSocketServerEndpoint;\n\n  /** JS 扩展：可选注入的唤醒器（Flutter 暂无此字段）；未提供时 ConnectionManager 使用 StubAppLauncher。 */\n  readonly appLauncher?: AppLauncher;\n\n  /** 019：唤醒后连接探测间隔（毫秒）；默认 400 */\n  readonly wakeUpProbeIntervalMs: number;\n\n  /** 019：唤醒后连接探测总超时（毫秒）；默认 12000 */\n  readonly wakeUpProbeTimeoutMs: number;\n\n  constructor(options: IpcClientSettingsOptions) {\n    this.clientName = options.clientName;\n    this.serverInstallationPath = options.serverInstallationPath;\n    this.serverLaunchIdentifier = options.serverLaunchIdentifier;\n    this.enableHeartbeat = options.enableHeartbeat ?? true;\n    this.heartbeatInterval = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;\n    this.messageStrategy = options.messageStrategy ?? new IpcMessageStrategy();\n    this.messageInterceptor = options.messageInterceptor;\n    this.connectionObserver = options.connectionObserver;\n    this.webSocketServerEndpoint = options.webSocketServerEndpoint;\n    this.appLauncher = options.appLauncher;\n    this.wakeUpProbeIntervalMs = options.wakeUpProbeIntervalMs ?? DEFAULT_WAKE_UP_PROBE_INTERVAL_MS;\n    this.wakeUpProbeTimeoutMs = options.wakeUpProbeTimeoutMs ?? DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS;\n  }\n\n  /** 有效服务端地址（来自当前使用的传输配置） */\n  get serverAddress(): string {\n    return this.webSocketServerEndpoint!.address;\n  }\n\n  /** 有效服务端端口（来自当前使用的传输配置） */\n  get serverPort(): number {\n    return this.webSocketServerEndpoint!.port;\n  }\n\n  /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */\n  get useWebSocket(): boolean {\n    return this.webSocketServerEndpoint != null;\n  }\n\n  /** WebSocket 端口（仅当使用 WebSocket 时有效） */\n  get webSocketPort(): number | undefined {\n    return this.webSocketServerEndpoint?.port;\n  }\n\n  /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */\n  get webSocketPath(): string {\n    return this.webSocketServerEndpoint?.path ?? '/';\n  }\n\n  /** 是否使用 wss（仅当使用 WebSocket 时有效） */\n  get useTls(): boolean {\n    return this.webSocketServerEndpoint?.useTls ?? false;\n  }\n}\n\n\n"]}

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.mjs

@@ -0,0 +1,53 @@
+import { IpcMessageStrategy } from '../../types/ipc_message_strategy';
+
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 3e3;
+const DEFAULT_WAKE_UP_PROBE_INTERVAL_MS = 400;
+const DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS = 12e3;
+class IpcClientSettings {
+  constructor(options) {
+    var _a, _b, _c, _d, _e;
+    this.clientName = options.clientName;
+    this.serverInstallationPath = options.serverInstallationPath;
+    this.serverLaunchIdentifier = options.serverLaunchIdentifier;
+    this.enableHeartbeat = (_a = options.enableHeartbeat) != null ? _a : true;
+    this.heartbeatInterval = (_b = options.heartbeatIntervalMs) != null ? _b : DEFAULT_HEARTBEAT_INTERVAL_MS;
+    this.messageStrategy = (_c = options.messageStrategy) != null ? _c : new IpcMessageStrategy();
+    this.messageInterceptor = options.messageInterceptor;
+    this.connectionObserver = options.connectionObserver;
+    this.webSocketServerEndpoint = options.webSocketServerEndpoint;
+    this.appLauncher = options.appLauncher;
+    this.wakeUpProbeIntervalMs = (_d = options.wakeUpProbeIntervalMs) != null ? _d : DEFAULT_WAKE_UP_PROBE_INTERVAL_MS;
+    this.wakeUpProbeTimeoutMs = (_e = options.wakeUpProbeTimeoutMs) != null ? _e : DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS;
+  }
+  /** 有效服务端地址（来自当前使用的传输配置） */
+  get serverAddress() {
+    return this.webSocketServerEndpoint.address;
+  }
+  /** 有效服务端端口（来自当前使用的传输配置） */
+  get serverPort() {
+    return this.webSocketServerEndpoint.port;
+  }
+  /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */
+  get useWebSocket() {
+    return this.webSocketServerEndpoint != null;
+  }
+  /** WebSocket 端口（仅当使用 WebSocket 时有效） */
+  get webSocketPort() {
+    var _a;
+    return (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.port;
+  }
+  /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */
+  get webSocketPath() {
+    var _a, _b;
+    return (_b = (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.path) != null ? _b : "/";
+  }
+  /** 是否使用 wss（仅当使用 WebSocket 时有效） */
+  get useTls() {
+    var _a, _b;
+    return (_b = (_a = this.webSocketServerEndpoint) == null ? void 0 : _a.useTls) != null ? _b : false;
+  }
+}
+
+export { IpcClientSettings };
+//# sourceMappingURL=ipc_client_settings.mjs.map
+//# sourceMappingURL=ipc_client_settings.mjs.map

package/dist/moonbridge-ipc/client/internal/settings/ipc_client_settings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/client/internal/settings/ipc_client_settings.ts"],"names":[],"mappings":";;AAcA,MAAM,6BAAA,GAAgC,GAAA;AAEtC,MAAM,iCAAA,GAAoC,GAAA;AAE1C,MAAM,gCAAA,GAAmC,IAAA;AAsClC,MAAM,iBAAA,CAAkB;AAAA,EAuC7B,YAAY,OAAA,EAAmC;AA/FjD,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AAgGI,IAAA,IAAA,CAAK,aAAa,OAAA,CAAQ,UAAA;AAC1B,IAAA,IAAA,CAAK,yBAAyB,OAAA,CAAQ,sBAAA;AACtC,IAAA,IAAA,CAAK,yBAAyB,OAAA,CAAQ,sBAAA;AACtC,IAAA,IAAA,CAAK,eAAA,GAAA,CAAkB,EAAA,GAAA,OAAA,CAAQ,eAAA,KAAR,IAAA,GAAA,EAAA,GAA2B,IAAA;AAClD,IAAA,IAAA,CAAK,iBAAA,GAAA,CAAoB,EAAA,GAAA,OAAA,CAAQ,mBAAA,KAAR,IAAA,GAAA,EAAA,GAA+B,6BAAA;AACxD,IAAA,IAAA,CAAK,eAAA,GAAA,CAAkB,EAAA,GAAA,OAAA,CAAQ,eAAA,KAAR,IAAA,GAAA,EAAA,GAA2B,IAAI,kBAAA,EAAmB;AACzE,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAClC,IAAA,IAAA,CAAK,qBAAqB,OAAA,CAAQ,kBAAA;AAClC,IAAA,IAAA,CAAK,0BAA0B,OAAA,CAAQ,uBAAA;AACvC,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAC3B,IAAA,IAAA,CAAK,qBAAA,GAAA,CAAwB,EAAA,GAAA,OAAA,CAAQ,qBAAA,KAAR,IAAA,GAAA,EAAA,GAAiC,iCAAA;AAC9D,IAAA,IAAA,CAAK,oBAAA,GAAA,CAAuB,EAAA,GAAA,OAAA,CAAQ,oBAAA,KAAR,IAAA,GAAA,EAAA,GAAgC,gCAAA;AAAA,EAC9D;AAAA;AAAA,EAGA,IAAI,aAAA,GAAwB;AAC1B,IAAA,OAAO,KAAK,uBAAA,CAAyB,OAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,UAAA,GAAqB;AACvB,IAAA,OAAO,KAAK,uBAAA,CAAyB,IAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,YAAA,GAAwB;AAC1B,IAAA,OAAO,KAAK,uBAAA,IAA2B,IAAA;AAAA,EACzC;AAAA;AAAA,EAGA,IAAI,aAAA,GAAoC;AA9H1C,IAAA,IAAA,EAAA;AA+HI,IAAA,OAAA,CAAO,EAAA,GAAA,IAAA,CAAK,4BAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,IAAA;AAAA,EACvC;AAAA;AAAA,EAGA,IAAI,aAAA,GAAwB;AAnI9B,IAAA,IAAA,EAAA,EAAA,EAAA;AAoII,IAAA,OAAA,CAAO,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,uBAAA,KAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,IAAA,KAA9B,IAAA,GAAA,EAAA,GAAsC,GAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,IAAI,MAAA,GAAkB;AAxIxB,IAAA,IAAA,EAAA,EAAA,EAAA;AAyII,IAAA,OAAA,CAAO,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,uBAAA,KAAL,IAAA,GAAA,MAAA,GAAA,EAAA,CAA8B,MAAA,KAA9B,IAAA,GAAA,EAAA,GAAwC,KAAA;AAAA,EACjD;AACF","file":"ipc_client_settings.mjs","sourcesContent":["// IPC 客户端配置，对应\n// moonbridge-ipc-flutter/lib/client/internal/settings/ipc_client_settings.dart\n// 012 US3：字段、必填/可选、默认值与 Flutter 一致；appLauncher 为 JS 扩展；heartbeatInterval 用毫秒存储，默认 3000 对应 Flutter Duration(seconds: 3)。\n\nimport { WebSocketServerEndpoint } from '../../../general/config/websocket_server_endpoint';\nimport {\n  AppInstallationPath,\n  AppLaunchIdentifier,\n} from '../../../general/app_launch/model/app_info';\nimport { AppLauncher } from '../../../general/app_launch/app_launcher';\nimport { IpcMessageStrategy } from '../../types/ipc_message_strategy';\nimport { ConnectionObserver, MessageInterceptor } from '../../types/ipc_types';\n\n/** 心跳间隔默认值（毫秒），对应 Flutter Duration(seconds: 3) */\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 3000;\n/** 唤醒后连接探测间隔（毫秒），每次失败后等待再重试 */\nconst DEFAULT_WAKE_UP_PROBE_INTERVAL_MS = 400;\n/** 唤醒后连接探测总超时（毫秒），超过则返回失败 */\nconst DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS = 12000;\n\n/**\n * 构造函数参数类型。\n * 使用独立的 options 类型，避免在构造函数上直接声明复杂对象类型。\n */\nexport interface IpcClientSettingsOptions {\n  clientName: string;\n  serverInstallationPath?: AppInstallationPath;\n  serverLaunchIdentifier?: AppLaunchIdentifier;\n  enableHeartbeat?: boolean;\n  /**\n   * 心跳检测间隔时间（毫秒）。与 Flutter Duration 对应：默认 3000 即 Flutter 的 Duration(seconds: 3)。\n   */\n  heartbeatIntervalMs?: number;\n  messageStrategy?: IpcMessageStrategy;\n  messageInterceptor?: MessageInterceptor;\n  connectionObserver?: ConnectionObserver;\n  webSocketServerEndpoint?: WebSocketServerEndpoint;\n  /** US4：可选注入，用于跨进程唤醒服务端；未提供时使用 StubAppLauncher */\n  appLauncher?: AppLauncher;\n  /**\n   * 019：唤醒后连接探测间隔（毫秒）；默认 400。\n   * 每次连接尝试失败后等待此间隔再重试。\n   */\n  wakeUpProbeIntervalMs?: number;\n  /**\n   * 019：唤醒后连接探测总超时（毫秒）；默认 12000。\n   * 超过此时长未连上则返回失败。\n   */\n  wakeUpProbeTimeoutMs?: number;\n}\n\n/**\n * IPC 客户端配置类。\n *\n * 传输方式由 socketServerEndpoint 或 webSocketServerEndpoint 二选一决定，至多一个非 null。\n */\nexport class IpcClientSettings {\n  /** 客户端名称 */\n  readonly clientName: string;\n\n  /** 服务器应用路径，用于唤醒服务器应用 */\n  readonly serverInstallationPath?: AppInstallationPath;\n\n  /** 服务端应用标识符信息，用于唤醒服务器应用 */\n  readonly serverLaunchIdentifier?: AppLaunchIdentifier;\n\n  /** 是否启用心跳检测 */\n  readonly enableHeartbeat: boolean;\n\n  /** 心跳检测间隔时间（毫秒） */\n  readonly heartbeatInterval: number;\n\n  /** 消息策略 */\n  readonly messageStrategy: IpcMessageStrategy;\n\n  /** 消息拦截器，可选 */\n  readonly messageInterceptor?: MessageInterceptor;\n\n  /** 连接状态观察者，可选 */\n  readonly connectionObserver?: ConnectionObserver;\n\n  /**\n   * WebSocket 连接配置；\n   */\n  readonly webSocketServerEndpoint?: WebSocketServerEndpoint;\n\n  /** JS 扩展：可选注入的唤醒器（Flutter 暂无此字段）；未提供时 ConnectionManager 使用 StubAppLauncher。 */\n  readonly appLauncher?: AppLauncher;\n\n  /** 019：唤醒后连接探测间隔（毫秒）；默认 400 */\n  readonly wakeUpProbeIntervalMs: number;\n\n  /** 019：唤醒后连接探测总超时（毫秒）；默认 12000 */\n  readonly wakeUpProbeTimeoutMs: number;\n\n  constructor(options: IpcClientSettingsOptions) {\n    this.clientName = options.clientName;\n    this.serverInstallationPath = options.serverInstallationPath;\n    this.serverLaunchIdentifier = options.serverLaunchIdentifier;\n    this.enableHeartbeat = options.enableHeartbeat ?? true;\n    this.heartbeatInterval = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;\n    this.messageStrategy = options.messageStrategy ?? new IpcMessageStrategy();\n    this.messageInterceptor = options.messageInterceptor;\n    this.connectionObserver = options.connectionObserver;\n    this.webSocketServerEndpoint = options.webSocketServerEndpoint;\n    this.appLauncher = options.appLauncher;\n    this.wakeUpProbeIntervalMs = options.wakeUpProbeIntervalMs ?? DEFAULT_WAKE_UP_PROBE_INTERVAL_MS;\n    this.wakeUpProbeTimeoutMs = options.wakeUpProbeTimeoutMs ?? DEFAULT_WAKE_UP_PROBE_TIMEOUT_MS;\n  }\n\n  /** 有效服务端地址（来自当前使用的传输配置） */\n  get serverAddress(): string {\n    return this.webSocketServerEndpoint!.address;\n  }\n\n  /** 有效服务端端口（来自当前使用的传输配置） */\n  get serverPort(): number {\n    return this.webSocketServerEndpoint!.port;\n  }\n\n  /** 是否使用 WebSocket 传输（由“哪个配置非 null”推断） */\n  get useWebSocket(): boolean {\n    return this.webSocketServerEndpoint != null;\n  }\n\n  /** WebSocket 端口（仅当使用 WebSocket 时有效） */\n  get webSocketPort(): number | undefined {\n    return this.webSocketServerEndpoint?.port;\n  }\n\n  /** WebSocket 升级路径（仅当使用 WebSocket 时有效） */\n  get webSocketPath(): string {\n    return this.webSocketServerEndpoint?.path ?? '/';\n  }\n\n  /** 是否使用 wss（仅当使用 WebSocket 时有效） */\n  get useTls(): boolean {\n    return this.webSocketServerEndpoint?.useTls ?? false;\n  }\n}\n\n\n"]}