moonbridge-ts 0.1.0

package/dist/moonbridge-ipc/client/moonbridge_ipc_client.d.mts

@@ -0,0 +1,134 @@
+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 { IpcConnectionCompletionHandler, MessageInterceptor, ConnectionObserver } from './types/ipc_types.mjs';
+import { EventBus } from './types/ipc_event_bus.mjs';
+import { Messenger } from './types/ipc_messenger.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';
+import '../general/message/event.mjs';
+
+/**
+ * MoonBridge IPC 客户端入口类，对应 Flutter lib/client/moonbridge_ipc_client.dart。
+ * 定义连接管理、消息发送与事件总线等公开 API；不含 RPC（JS 端不实现）。
+ */
+
+/** MoonBridge IPC 客户端抽象接口 */
+interface MoonBridgeIpcClient {
+    /**
+     * 连接到 IPC 服务器
+     */
+    connect(onResult?: IpcConnectionCompletionHandler): void;
+    /**
+     * 断开与 IPC 服务器的连接
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 检查是否已连接到 IPC 服务器
+     */
+    isConnected(): boolean;
+    /**
+     * 客户端名称
+     */
+    readonly clientName: string;
+    /**
+     * 消息发送器
+     */
+    readonly messenger: Messenger;
+    /**
+     * 事件总线
+     */
+    readonly eventBus: EventBus;
+}
+/** 构造器，用于链式配置并构建客户端实例 */
+declare class MoonBridgeIpcClientBuilder {
+    private _clientName;
+    private _webSocketServerEndpoint?;
+    private _serverInstallationPath?;
+    private _serverLaunchIdentifier?;
+    private _enableHeartbeat?;
+    private _heartbeatIntervalMs?;
+    private _messageStrategy?;
+    private _messageInterceptor?;
+    private _connectionObserver?;
+    private _appLauncher?;
+    /**
+     * 创建客户端构建器
+     */
+    static builder(): MoonBridgeIpcClientBuilder;
+    /**
+     * 设置客户端名称
+     */
+    clientName(name: string): this;
+    /**
+     * 设置 WebSocket 连接配置
+     */
+    useWebSocketChannel(endpoint: WebSocketServerEndpoint | undefined): this;
+    /**
+     * 设置服务器应用路径
+     */
+    serverInstallationPath(path: AppInstallationPath): this;
+    /**
+     * 设置服务器应用标识符
+     */
+    serverLaunchIdentifier(identifier: AppLaunchIdentifier): this;
+    /**
+     * 设置是否启用心跳检测
+     */
+    enableHeartbeat(enable: boolean): this;
+    /**
+     * 设置心跳检测间隔时间
+     */
+    heartbeatIntervalMs(ms: number): this;
+    /**
+     * 设置消息策略
+     */
+    messageStrategy(strategy: IpcMessageStrategy): this;
+    /**
+     * 设置消息拦截器
+     */
+    messageInterceptor(interceptor?: MessageInterceptor): this;
+    /**
+     * 设置连接状态观察者
+     */
+    connectionObserver(observer?: ConnectionObserver): this;
+    /**
+     * 注入应用启动器
+     * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起）
+     */
+    appLauncher(launcher: AppLauncher | undefined): this;
+    /**
+     * 构建客户端实例并可选注册为默认客户端。
+     */
+    build(makeDefault?: boolean): MoonBridgeIpcClient;
+}
+/**
+ * 客户端注册表单例
+ */
+declare class MoonBridgeIpcClientRegistry {
+    private static _instance;
+    private readonly _clientMap;
+    /**
+     * 获取客户端注册表单例
+     */
+    static getInstance(): MoonBridgeIpcClientRegistry;
+    /**
+     * 设置默认客户端
+     */
+    setDefault(client: MoonBridgeIpcClient): void;
+    /**
+     * 注册客户端
+     */
+    register(client: MoonBridgeIpcClient): void;
+    /**
+     * 获取客户端
+     */
+    get(clientName?: string): MoonBridgeIpcClient | undefined;
+}
+
+export { type MoonBridgeIpcClient, MoonBridgeIpcClientBuilder, MoonBridgeIpcClientRegistry };

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

@@ -0,0 +1,124 @@
+/**
+ * MoonBridge IPC 客户端入口类，对应 Flutter lib/client/moonbridge_ipc_client.dart。
+ * 定义连接管理、消息发送与事件总线等公开 API；不含 RPC（JS 端不实现）。
+ */
+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, IpcConnectionCompletionHandler, MessageInterceptor } from './types/ipc_types';
+import { EventBus } from './types/ipc_event_bus';
+import { Messenger } from './types/ipc_messenger';
+/** MoonBridge IPC 客户端抽象接口 */
+export interface MoonBridgeIpcClient {
+    /**
+     * 连接到 IPC 服务器
+     */
+    connect(onResult?: IpcConnectionCompletionHandler): void;
+    /**
+     * 断开与 IPC 服务器的连接
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 检查是否已连接到 IPC 服务器
+     */
+    isConnected(): boolean;
+    /**
+     * 客户端名称
+     */
+    readonly clientName: string;
+    /**
+     * 消息发送器
+     */
+    readonly messenger: Messenger;
+    /**
+     * 事件总线
+     */
+    readonly eventBus: EventBus;
+}
+/** 构造器，用于链式配置并构建客户端实例 */
+export declare class MoonBridgeIpcClientBuilder {
+    private _clientName;
+    private _webSocketServerEndpoint?;
+    private _serverInstallationPath?;
+    private _serverLaunchIdentifier?;
+    private _enableHeartbeat?;
+    private _heartbeatIntervalMs?;
+    private _messageStrategy?;
+    private _messageInterceptor?;
+    private _connectionObserver?;
+    private _appLauncher?;
+    /**
+     * 创建客户端构建器
+     */
+    static builder(): MoonBridgeIpcClientBuilder;
+    /**
+     * 设置客户端名称
+     */
+    clientName(name: string): this;
+    /**
+     * 设置 WebSocket 连接配置
+     */
+    useWebSocketChannel(endpoint: WebSocketServerEndpoint | undefined): this;
+    /**
+     * 设置服务器应用路径
+     */
+    serverInstallationPath(path: AppInstallationPath): this;
+    /**
+     * 设置服务器应用标识符
+     */
+    serverLaunchIdentifier(identifier: AppLaunchIdentifier): this;
+    /**
+     * 设置是否启用心跳检测
+     */
+    enableHeartbeat(enable: boolean): this;
+    /**
+     * 设置心跳检测间隔时间
+     */
+    heartbeatIntervalMs(ms: number): this;
+    /**
+     * 设置消息策略
+     */
+    messageStrategy(strategy: IpcMessageStrategy): this;
+    /**
+     * 设置消息拦截器
+     */
+    messageInterceptor(interceptor?: MessageInterceptor): this;
+    /**
+     * 设置连接状态观察者
+     */
+    connectionObserver(observer?: ConnectionObserver): this;
+    /**
+     * 注入应用启动器
+     * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起）
+     */
+    appLauncher(launcher: AppLauncher | undefined): this;
+    /**
+     * 构建客户端实例并可选注册为默认客户端。
+     */
+    build(makeDefault?: boolean): MoonBridgeIpcClient;
+}
+/**
+ * 客户端注册表单例
+ */
+export declare class MoonBridgeIpcClientRegistry {
+    private static _instance;
+    private readonly _clientMap;
+    /**
+     * 获取客户端注册表单例
+     */
+    static getInstance(): MoonBridgeIpcClientRegistry;
+    /**
+     * 设置默认客户端
+     */
+    setDefault(client: MoonBridgeIpcClient): void;
+    /**
+     * 注册客户端
+     */
+    register(client: MoonBridgeIpcClient): void;
+    /**
+     * 获取客户端
+     */
+    get(clientName?: string): MoonBridgeIpcClient | undefined;
+}
+//# sourceMappingURL=moonbridge_ipc_client.d.ts.map

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

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

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

@@ -0,0 +1,156 @@
+'use strict';
+
+var ipc_client_settings = require('./internal/settings/ipc_client_settings');
+var moonbridge_ipc_client_internal = require('./internal/moonbridge_ipc_client.internal');
+
+class MoonBridgeIpcClientBuilder {
+  constructor() {
+    this._clientName = "";
+  }
+  // PUBLIC METHODS
+  /**
+   * 创建客户端构建器 
+   */
+  static builder() {
+    return new MoonBridgeIpcClientBuilder();
+  }
+  /**
+   * 设置客户端名称 
+   */
+  clientName(name) {
+    this._clientName = name;
+    return this;
+  }
+  /**
+   * 设置 WebSocket 连接配置 
+   */
+  useWebSocketChannel(endpoint) {
+    this._webSocketServerEndpoint = endpoint;
+    return this;
+  }
+  /**
+   * 设置服务器应用路径 
+   */
+  serverInstallationPath(path) {
+    this._serverInstallationPath = path;
+    return this;
+  }
+  /**
+   * 设置服务器应用标识符 
+   */
+  serverLaunchIdentifier(identifier) {
+    this._serverLaunchIdentifier = identifier;
+    return this;
+  }
+  /**
+   * 设置是否启用心跳检测 
+   */
+  enableHeartbeat(enable) {
+    this._enableHeartbeat = enable;
+    return this;
+  }
+  /**
+   * 设置心跳检测间隔时间 
+   */
+  heartbeatIntervalMs(ms) {
+    this._heartbeatIntervalMs = ms;
+    return this;
+  }
+  /**
+   * 设置消息策略 
+   */
+  messageStrategy(strategy) {
+    this._messageStrategy = strategy;
+    return this;
+  }
+  /**
+   * 设置消息拦截器 
+   */
+  messageInterceptor(interceptor) {
+    this._messageInterceptor = interceptor;
+    return this;
+  }
+  /**
+   * 设置连接状态观察者 
+   */
+  connectionObserver(observer) {
+    this._connectionObserver = observer;
+    return this;
+  }
+  /** 
+   * 注入应用启动器
+   * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起） 
+   */
+  appLauncher(launcher) {
+    this._appLauncher = launcher;
+    return this;
+  }
+  /**
+   * 构建客户端实例并可选注册为默认客户端。
+   */
+  build(makeDefault = false) {
+    if (!this._clientName || this._clientName.trim() === "") {
+      throw new Error("clientName must be non-empty.");
+    }
+    if (!this._webSocketServerEndpoint) {
+      throw new Error(
+        "Call useWebSocketChannel to set the transport configuration."
+      );
+    }
+    const settings = new ipc_client_settings.IpcClientSettings({
+      clientName: this._clientName,
+      webSocketServerEndpoint: this._webSocketServerEndpoint,
+      serverInstallationPath: this._serverInstallationPath,
+      serverLaunchIdentifier: this._serverLaunchIdentifier,
+      enableHeartbeat: this._enableHeartbeat,
+      heartbeatIntervalMs: this._heartbeatIntervalMs,
+      messageStrategy: this._messageStrategy,
+      messageInterceptor: this._messageInterceptor,
+      connectionObserver: this._connectionObserver,
+      appLauncher: this._appLauncher
+    });
+    const client = new moonbridge_ipc_client_internal.RealMoonBridgeIpcClient(settings);
+    MoonBridgeIpcClientRegistry.getInstance().register(client);
+    if (makeDefault) {
+      MoonBridgeIpcClientRegistry.getInstance().setDefault(client);
+    }
+    return client;
+  }
+}
+class MoonBridgeIpcClientRegistry {
+  constructor() {
+    this._clientMap = /* @__PURE__ */ new Map();
+  }
+  /**
+   * 获取客户端注册表单例 
+   */
+  static getInstance() {
+    if (!MoonBridgeIpcClientRegistry._instance) {
+      MoonBridgeIpcClientRegistry._instance = new MoonBridgeIpcClientRegistry();
+    }
+    return MoonBridgeIpcClientRegistry._instance;
+  }
+  /**
+   * 设置默认客户端 
+   */
+  setDefault(client) {
+    this._clientMap.set("__default__", client);
+  }
+  /**
+   * 注册客户端 
+   */
+  register(client) {
+    this._clientMap.set(client.clientName, client);
+  }
+  /**
+   * 获取客户端 
+   */
+  get(clientName) {
+    return this._clientMap.get(clientName != null ? clientName : "__default__");
+  }
+}
+
+exports.MoonBridgeIpcClientBuilder = MoonBridgeIpcClientBuilder;
+exports.MoonBridgeIpcClientRegistry = MoonBridgeIpcClientRegistry;
+//# sourceMappingURL=moonbridge_ipc_client.js.map
+//# sourceMappingURL=moonbridge_ipc_client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/moonbridge-ipc/client/moonbridge_ipc_client.ts"],"names":["IpcClientSettings","RealMoonBridgeIpcClient"],"mappings":"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","file":"moonbridge_ipc_client.js","sourcesContent":["/**\n * MoonBridge IPC 客户端入口类，对应 Flutter lib/client/moonbridge_ipc_client.dart。\n * 定义连接管理、消息发送与事件总线等公开 API；不含 RPC（JS 端不实现）。\n */\n\nimport { WebSocketServerEndpoint } from '../general/config/websocket_server_endpoint';\nimport { AppInstallationPath, AppLaunchIdentifier } from '../general/app_launch/model/app_info';\nimport { AppLauncher } from '../general/app_launch/app_launcher';\nimport { IpcClientSettings } from './internal/settings/ipc_client_settings';\nimport { IpcMessageStrategy } from './types/ipc_message_strategy';\nimport { ConnectionObserver, IpcConnectionCompletionHandler, MessageInterceptor } from './types/ipc_types';\nimport { EventBus } from './types/ipc_event_bus';\nimport { Messenger } from './types/ipc_messenger';\nimport { RealMoonBridgeIpcClient } from './internal/moonbridge_ipc_client.internal';\n\n/** MoonBridge IPC 客户端抽象接口 */\nexport interface MoonBridgeIpcClient {\n  /** \n   * 连接到 IPC 服务器 \n   */\n  connect(onResult?: IpcConnectionCompletionHandler): void;\n  /** \n   * 断开与 IPC 服务器的连接 \n   */\n  disconnect(): Promise<void>;\n  /** \n   * 检查是否已连接到 IPC 服务器 \n   */\n  isConnected(): boolean;\n  /** \n   * 客户端名称 \n   */\n  readonly clientName: string;\n  /** \n   * 消息发送器 \n   */\n  readonly messenger: Messenger;\n  /** \n   * 事件总线 \n   */\n  readonly eventBus: EventBus;\n}\n\n// PUBLIC CLASS\n\n/** 构造器，用于链式配置并构建客户端实例 */\nexport class MoonBridgeIpcClientBuilder {\n  private _clientName = '';\n  private _webSocketServerEndpoint?: WebSocketServerEndpoint;\n  private _serverInstallationPath?: AppInstallationPath;\n  private _serverLaunchIdentifier?: AppLaunchIdentifier;\n  private _enableHeartbeat?: boolean;\n  private _heartbeatIntervalMs?: number;\n  private _messageStrategy?: IpcMessageStrategy;\n  private _messageInterceptor?: MessageInterceptor;\n  private _connectionObserver?: ConnectionObserver;\n  private _appLauncher?: AppLauncher;\n\n  // PUBLIC METHODS\n\n  /**\n   * 创建客户端构建器 \n   */\n  static builder(): MoonBridgeIpcClientBuilder {\n    return new MoonBridgeIpcClientBuilder();\n  }\n\n  /**\n   * 设置客户端名称 \n   */\n  clientName(name: string): this {\n    this._clientName = name;\n    return this;\n  }\n\n  /**\n   * 设置 WebSocket 连接配置 \n   */\n  useWebSocketChannel(endpoint: WebSocketServerEndpoint | undefined): this {\n    this._webSocketServerEndpoint = endpoint;\n    return this;\n  }\n\n  /**\n   * 设置服务器应用路径 \n   */\n  serverInstallationPath(path: AppInstallationPath): this {\n    this._serverInstallationPath = path;\n    return this;\n  }\n\n  /**\n   * 设置服务器应用标识符 \n   */\n  serverLaunchIdentifier(identifier: AppLaunchIdentifier): this {\n    this._serverLaunchIdentifier = identifier;\n    return this;\n  }\n\n  /**\n   * 设置是否启用心跳检测 \n   */\n  enableHeartbeat(enable: boolean): this {\n    this._enableHeartbeat = enable;\n    return this;\n  }\n\n  /**\n   * 设置心跳检测间隔时间 \n   */\n  heartbeatIntervalMs(ms: number): this {\n    this._heartbeatIntervalMs = ms;\n    return this;\n  }\n\n  /**\n   * 设置消息策略 \n   */\n  messageStrategy(strategy: IpcMessageStrategy): this {\n    this._messageStrategy = strategy;\n    return this;\n  }\n\n  /**\n   * 设置消息拦截器 \n   */\n  messageInterceptor(interceptor?: MessageInterceptor): this {\n    this._messageInterceptor = interceptor;\n    return this;\n  }\n\n  /**\n   * 设置连接状态观察者 \n   */\n  connectionObserver(observer?: ConnectionObserver): this {\n    this._connectionObserver = observer;\n    return this;\n  }\n\n  /** \n   * 注入应用启动器\n   * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起） \n   */\n  appLauncher(launcher: AppLauncher | undefined): this {\n    this._appLauncher = launcher;\n    return this;\n  }\n\n  /**\n   * 构建客户端实例并可选注册为默认客户端。\n   */\n  build(makeDefault = false): MoonBridgeIpcClient {\n    if (!this._clientName || this._clientName.trim() === '') {\n      throw new Error('clientName must be non-empty.');\n    }\n    if (!this._webSocketServerEndpoint) {\n      throw new Error(\n        'Call useWebSocketChannel to set the transport configuration.',\n      );\n    }\n\n    const settings = new IpcClientSettings({\n      clientName: this._clientName,\n      webSocketServerEndpoint: this._webSocketServerEndpoint,\n      serverInstallationPath: this._serverInstallationPath,\n      serverLaunchIdentifier: this._serverLaunchIdentifier,\n      enableHeartbeat: this._enableHeartbeat,\n      heartbeatIntervalMs: this._heartbeatIntervalMs,\n      messageStrategy: this._messageStrategy,\n      messageInterceptor: this._messageInterceptor,\n      connectionObserver: this._connectionObserver,\n      appLauncher: this._appLauncher,\n    });\n\n    const client = new RealMoonBridgeIpcClient(settings);\n    MoonBridgeIpcClientRegistry.getInstance().register(client);\n    if (makeDefault) {\n      MoonBridgeIpcClientRegistry.getInstance().setDefault(client);\n    }\n    return client;\n  }\n}\n\n\n/** \n * 客户端注册表单例 \n */\nexport class MoonBridgeIpcClientRegistry {\n  private static _instance: MoonBridgeIpcClientRegistry;\n  private readonly _clientMap = new Map<string, MoonBridgeIpcClient>();\n\n  /**\n   * 获取客户端注册表单例 \n   */\n  static getInstance(): MoonBridgeIpcClientRegistry {\n    if (!MoonBridgeIpcClientRegistry._instance) {\n      MoonBridgeIpcClientRegistry._instance = new MoonBridgeIpcClientRegistry();\n    }\n    return MoonBridgeIpcClientRegistry._instance;\n  }\n\n  /**\n   * 设置默认客户端 \n   */\n  setDefault(client: MoonBridgeIpcClient): void {\n    this._clientMap.set('__default__', client);\n  }\n\n  /**\n   * 注册客户端 \n   */\n  register(client: MoonBridgeIpcClient): void {\n    this._clientMap.set(client.clientName, client);\n  }\n\n  /**\n   * 获取客户端 \n   */\n  get(clientName?: string): MoonBridgeIpcClient | undefined {\n    return this._clientMap.get(clientName ?? '__default__');\n  }\n}\n"]}

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

@@ -0,0 +1,153 @@
+import { IpcClientSettings } from './internal/settings/ipc_client_settings';
+import { RealMoonBridgeIpcClient } from './internal/moonbridge_ipc_client.internal';
+
+class MoonBridgeIpcClientBuilder {
+  constructor() {
+    this._clientName = "";
+  }
+  // PUBLIC METHODS
+  /**
+   * 创建客户端构建器 
+   */
+  static builder() {
+    return new MoonBridgeIpcClientBuilder();
+  }
+  /**
+   * 设置客户端名称 
+   */
+  clientName(name) {
+    this._clientName = name;
+    return this;
+  }
+  /**
+   * 设置 WebSocket 连接配置 
+   */
+  useWebSocketChannel(endpoint) {
+    this._webSocketServerEndpoint = endpoint;
+    return this;
+  }
+  /**
+   * 设置服务器应用路径 
+   */
+  serverInstallationPath(path) {
+    this._serverInstallationPath = path;
+    return this;
+  }
+  /**
+   * 设置服务器应用标识符 
+   */
+  serverLaunchIdentifier(identifier) {
+    this._serverLaunchIdentifier = identifier;
+    return this;
+  }
+  /**
+   * 设置是否启用心跳检测 
+   */
+  enableHeartbeat(enable) {
+    this._enableHeartbeat = enable;
+    return this;
+  }
+  /**
+   * 设置心跳检测间隔时间 
+   */
+  heartbeatIntervalMs(ms) {
+    this._heartbeatIntervalMs = ms;
+    return this;
+  }
+  /**
+   * 设置消息策略 
+   */
+  messageStrategy(strategy) {
+    this._messageStrategy = strategy;
+    return this;
+  }
+  /**
+   * 设置消息拦截器 
+   */
+  messageInterceptor(interceptor) {
+    this._messageInterceptor = interceptor;
+    return this;
+  }
+  /**
+   * 设置连接状态观察者 
+   */
+  connectionObserver(observer) {
+    this._connectionObserver = observer;
+    return this;
+  }
+  /** 
+   * 注入应用启动器
+   * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起） 
+   */
+  appLauncher(launcher) {
+    this._appLauncher = launcher;
+    return this;
+  }
+  /**
+   * 构建客户端实例并可选注册为默认客户端。
+   */
+  build(makeDefault = false) {
+    if (!this._clientName || this._clientName.trim() === "") {
+      throw new Error("clientName must be non-empty.");
+    }
+    if (!this._webSocketServerEndpoint) {
+      throw new Error(
+        "Call useWebSocketChannel to set the transport configuration."
+      );
+    }
+    const settings = new IpcClientSettings({
+      clientName: this._clientName,
+      webSocketServerEndpoint: this._webSocketServerEndpoint,
+      serverInstallationPath: this._serverInstallationPath,
+      serverLaunchIdentifier: this._serverLaunchIdentifier,
+      enableHeartbeat: this._enableHeartbeat,
+      heartbeatIntervalMs: this._heartbeatIntervalMs,
+      messageStrategy: this._messageStrategy,
+      messageInterceptor: this._messageInterceptor,
+      connectionObserver: this._connectionObserver,
+      appLauncher: this._appLauncher
+    });
+    const client = new RealMoonBridgeIpcClient(settings);
+    MoonBridgeIpcClientRegistry.getInstance().register(client);
+    if (makeDefault) {
+      MoonBridgeIpcClientRegistry.getInstance().setDefault(client);
+    }
+    return client;
+  }
+}
+class MoonBridgeIpcClientRegistry {
+  constructor() {
+    this._clientMap = /* @__PURE__ */ new Map();
+  }
+  /**
+   * 获取客户端注册表单例 
+   */
+  static getInstance() {
+    if (!MoonBridgeIpcClientRegistry._instance) {
+      MoonBridgeIpcClientRegistry._instance = new MoonBridgeIpcClientRegistry();
+    }
+    return MoonBridgeIpcClientRegistry._instance;
+  }
+  /**
+   * 设置默认客户端 
+   */
+  setDefault(client) {
+    this._clientMap.set("__default__", client);
+  }
+  /**
+   * 注册客户端 
+   */
+  register(client) {
+    this._clientMap.set(client.clientName, client);
+  }
+  /**
+   * 获取客户端 
+   */
+  get(clientName) {
+    return this._clientMap.get(clientName != null ? clientName : "__default__");
+  }
+}
+
+export { MoonBridgeIpcClientBuilder, MoonBridgeIpcClientRegistry };
+//# sourceMappingURL=moonbridge_ipc_client.mjs.map
+//# sourceMappingURL=moonbridge_ipc_client.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/moonbridge-ipc/client/moonbridge_ipc_client.ts"],"names":[],"mappings":";;;AA8CO,MAAM,0BAAA,CAA2B;AAAA,EAAjC,WAAA,GAAA;AACL,IAAA,IAAA,CAAQ,WAAA,GAAc,EAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBtB,OAAO,OAAA,GAAsC;AAC3C,IAAA,OAAO,IAAI,0BAAA,EAA2B;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,IAAA,EAAoB;AAC7B,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAoB,QAAA,EAAqD;AACvE,IAAA,IAAA,CAAK,wBAAA,GAA2B,QAAA;AAChC,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAuB,IAAA,EAAiC;AACtD,IAAA,IAAA,CAAK,uBAAA,GAA0B,IAAA;AAC/B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,uBAAuB,UAAA,EAAuC;AAC5D,IAAA,IAAA,CAAK,uBAAA,GAA0B,UAAA;AAC/B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,MAAA,EAAuB;AACrC,IAAA,IAAA,CAAK,gBAAA,GAAmB,MAAA;AACxB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAoB,EAAA,EAAkB;AACpC,IAAA,IAAA,CAAK,oBAAA,GAAuB,EAAA;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,QAAA,EAAoC;AAClD,IAAA,IAAA,CAAK,gBAAA,GAAmB,QAAA;AACxB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,WAAA,EAAwC;AACzD,IAAA,IAAA,CAAK,mBAAA,GAAsB,WAAA;AAC3B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,mBAAmB,QAAA,EAAqC;AACtD,IAAA,IAAA,CAAK,mBAAA,GAAsB,QAAA;AAC3B,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,QAAA,EAAyC;AACnD,IAAA,IAAA,CAAK,YAAA,GAAe,QAAA;AACpB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,CAAM,cAAc,KAAA,EAA4B;AAC9C,IAAA,IAAI,CAAC,IAAA,CAAK,WAAA,IAAe,KAAK,WAAA,CAAY,IAAA,OAAW,EAAA,EAAI;AACvD,MAAA,MAAM,IAAI,MAAM,+BAA+B,CAAA;AAAA,IACjD;AACA,IAAA,IAAI,CAAC,KAAK,wBAAA,EAA0B;AAClC,MAAA,MAAM,IAAI,KAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,GAAW,IAAI,iBAAA,CAAkB;AAAA,MACrC,YAAY,IAAA,CAAK,WAAA;AAAA,MACjB,yBAAyB,IAAA,CAAK,wBAAA;AAAA,MAC9B,wBAAwB,IAAA,CAAK,uBAAA;AAAA,MAC7B,wBAAwB,IAAA,CAAK,uBAAA;AAAA,MAC7B,iBAAiB,IAAA,CAAK,gBAAA;AAAA,MACtB,qBAAqB,IAAA,CAAK,oBAAA;AAAA,MAC1B,iBAAiB,IAAA,CAAK,gBAAA;AAAA,MACtB,oBAAoB,IAAA,CAAK,mBAAA;AAAA,MACzB,oBAAoB,IAAA,CAAK,mBAAA;AAAA,MACzB,aAAa,IAAA,CAAK;AAAA,KACnB,CAAA;AAED,IAAA,MAAM,MAAA,GAAS,IAAI,uBAAA,CAAwB,QAAQ,CAAA;AACnD,IAAA,2BAAA,CAA4B,WAAA,EAAY,CAAE,QAAA,CAAS,MAAM,CAAA;AACzD,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,2BAAA,CAA4B,WAAA,EAAY,CAAE,UAAA,CAAW,MAAM,CAAA;AAAA,IAC7D;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAMO,MAAM,2BAAA,CAA4B;AAAA,EAAlC,WAAA,GAAA;AAEL,IAAA,IAAA,CAAiB,UAAA,uBAAiB,GAAA,EAAiC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAKnE,OAAO,WAAA,GAA2C;AAChD,IAAA,IAAI,CAAC,4BAA4B,SAAA,EAAW;AAC1C,MAAA,2BAAA,CAA4B,SAAA,GAAY,IAAI,2BAAA,EAA4B;AAAA,IAC1E;AACA,IAAA,OAAO,2BAAA,CAA4B,SAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,MAAA,EAAmC;AAC5C,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,aAAA,EAAe,MAAM,CAAA;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,MAAA,EAAmC;AAC1C,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,MAAA,CAAO,UAAA,EAAY,MAAM,CAAA;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,UAAA,EAAsD;AACxD,IAAA,OAAO,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,UAAA,IAAA,IAAA,GAAA,UAAA,GAAc,aAAa,CAAA;AAAA,EACxD;AACF","file":"moonbridge_ipc_client.mjs","sourcesContent":["/**\n * MoonBridge IPC 客户端入口类，对应 Flutter lib/client/moonbridge_ipc_client.dart。\n * 定义连接管理、消息发送与事件总线等公开 API；不含 RPC（JS 端不实现）。\n */\n\nimport { WebSocketServerEndpoint } from '../general/config/websocket_server_endpoint';\nimport { AppInstallationPath, AppLaunchIdentifier } from '../general/app_launch/model/app_info';\nimport { AppLauncher } from '../general/app_launch/app_launcher';\nimport { IpcClientSettings } from './internal/settings/ipc_client_settings';\nimport { IpcMessageStrategy } from './types/ipc_message_strategy';\nimport { ConnectionObserver, IpcConnectionCompletionHandler, MessageInterceptor } from './types/ipc_types';\nimport { EventBus } from './types/ipc_event_bus';\nimport { Messenger } from './types/ipc_messenger';\nimport { RealMoonBridgeIpcClient } from './internal/moonbridge_ipc_client.internal';\n\n/** MoonBridge IPC 客户端抽象接口 */\nexport interface MoonBridgeIpcClient {\n  /** \n   * 连接到 IPC 服务器 \n   */\n  connect(onResult?: IpcConnectionCompletionHandler): void;\n  /** \n   * 断开与 IPC 服务器的连接 \n   */\n  disconnect(): Promise<void>;\n  /** \n   * 检查是否已连接到 IPC 服务器 \n   */\n  isConnected(): boolean;\n  /** \n   * 客户端名称 \n   */\n  readonly clientName: string;\n  /** \n   * 消息发送器 \n   */\n  readonly messenger: Messenger;\n  /** \n   * 事件总线 \n   */\n  readonly eventBus: EventBus;\n}\n\n// PUBLIC CLASS\n\n/** 构造器，用于链式配置并构建客户端实例 */\nexport class MoonBridgeIpcClientBuilder {\n  private _clientName = '';\n  private _webSocketServerEndpoint?: WebSocketServerEndpoint;\n  private _serverInstallationPath?: AppInstallationPath;\n  private _serverLaunchIdentifier?: AppLaunchIdentifier;\n  private _enableHeartbeat?: boolean;\n  private _heartbeatIntervalMs?: number;\n  private _messageStrategy?: IpcMessageStrategy;\n  private _messageInterceptor?: MessageInterceptor;\n  private _connectionObserver?: ConnectionObserver;\n  private _appLauncher?: AppLauncher;\n\n  // PUBLIC METHODS\n\n  /**\n   * 创建客户端构建器 \n   */\n  static builder(): MoonBridgeIpcClientBuilder {\n    return new MoonBridgeIpcClientBuilder();\n  }\n\n  /**\n   * 设置客户端名称 \n   */\n  clientName(name: string): this {\n    this._clientName = name;\n    return this;\n  }\n\n  /**\n   * 设置 WebSocket 连接配置 \n   */\n  useWebSocketChannel(endpoint: WebSocketServerEndpoint | undefined): this {\n    this._webSocketServerEndpoint = endpoint;\n    return this;\n  }\n\n  /**\n   * 设置服务器应用路径 \n   */\n  serverInstallationPath(path: AppInstallationPath): this {\n    this._serverInstallationPath = path;\n    return this;\n  }\n\n  /**\n   * 设置服务器应用标识符 \n   */\n  serverLaunchIdentifier(identifier: AppLaunchIdentifier): this {\n    this._serverLaunchIdentifier = identifier;\n    return this;\n  }\n\n  /**\n   * 设置是否启用心跳检测 \n   */\n  enableHeartbeat(enable: boolean): this {\n    this._enableHeartbeat = enable;\n    return this;\n  }\n\n  /**\n   * 设置心跳检测间隔时间 \n   */\n  heartbeatIntervalMs(ms: number): this {\n    this._heartbeatIntervalMs = ms;\n    return this;\n  }\n\n  /**\n   * 设置消息策略 \n   */\n  messageStrategy(strategy: IpcMessageStrategy): this {\n    this._messageStrategy = strategy;\n    return this;\n  }\n\n  /**\n   * 设置消息拦截器 \n   */\n  messageInterceptor(interceptor?: MessageInterceptor): this {\n    this._messageInterceptor = interceptor;\n    return this;\n  }\n\n  /**\n   * 设置连接状态观察者 \n   */\n  connectionObserver(observer?: ConnectionObserver): this {\n    this._connectionObserver = observer;\n    return this;\n  }\n\n  /** \n   * 注入应用启动器\n   * 用于覆盖默认的唤醒方式（如 wps-addin 通过 URL Scheme 唤起） \n   */\n  appLauncher(launcher: AppLauncher | undefined): this {\n    this._appLauncher = launcher;\n    return this;\n  }\n\n  /**\n   * 构建客户端实例并可选注册为默认客户端。\n   */\n  build(makeDefault = false): MoonBridgeIpcClient {\n    if (!this._clientName || this._clientName.trim() === '') {\n      throw new Error('clientName must be non-empty.');\n    }\n    if (!this._webSocketServerEndpoint) {\n      throw new Error(\n        'Call useWebSocketChannel to set the transport configuration.',\n      );\n    }\n\n    const settings = new IpcClientSettings({\n      clientName: this._clientName,\n      webSocketServerEndpoint: this._webSocketServerEndpoint,\n      serverInstallationPath: this._serverInstallationPath,\n      serverLaunchIdentifier: this._serverLaunchIdentifier,\n      enableHeartbeat: this._enableHeartbeat,\n      heartbeatIntervalMs: this._heartbeatIntervalMs,\n      messageStrategy: this._messageStrategy,\n      messageInterceptor: this._messageInterceptor,\n      connectionObserver: this._connectionObserver,\n      appLauncher: this._appLauncher,\n    });\n\n    const client = new RealMoonBridgeIpcClient(settings);\n    MoonBridgeIpcClientRegistry.getInstance().register(client);\n    if (makeDefault) {\n      MoonBridgeIpcClientRegistry.getInstance().setDefault(client);\n    }\n    return client;\n  }\n}\n\n\n/** \n * 客户端注册表单例 \n */\nexport class MoonBridgeIpcClientRegistry {\n  private static _instance: MoonBridgeIpcClientRegistry;\n  private readonly _clientMap = new Map<string, MoonBridgeIpcClient>();\n\n  /**\n   * 获取客户端注册表单例 \n   */\n  static getInstance(): MoonBridgeIpcClientRegistry {\n    if (!MoonBridgeIpcClientRegistry._instance) {\n      MoonBridgeIpcClientRegistry._instance = new MoonBridgeIpcClientRegistry();\n    }\n    return MoonBridgeIpcClientRegistry._instance;\n  }\n\n  /**\n   * 设置默认客户端 \n   */\n  setDefault(client: MoonBridgeIpcClient): void {\n    this._clientMap.set('__default__', client);\n  }\n\n  /**\n   * 注册客户端 \n   */\n  register(client: MoonBridgeIpcClient): void {\n    this._clientMap.set(client.clientName, client);\n  }\n\n  /**\n   * 获取客户端 \n   */\n  get(clientName?: string): MoonBridgeIpcClient | undefined {\n    return this._clientMap.get(clientName ?? '__default__');\n  }\n}\n"]}

package/dist/moonbridge-ipc/client/types/ipc_event_bus.d.mts

@@ -0,0 +1,29 @@
+import { Event } from '../../general/message/event.mjs';
+
+/**
+ * IPC 事件总线接口与订阅者类型，对应 Flutter lib/client/types/ipc_event_bus.dart。
+ */
+
+/** IPC 事件总线接口。 */
+interface EventBus {
+    /** 注册事件订阅者，订阅特定类型的事件。 */
+    register(subscriber: Subscriber): void;
+    /** 注销事件订阅者，取消订阅事件。 */
+    unregister(subscriber: Subscriber): void;
+    /** 发布事件，通知所有订阅者。 */
+    post(event: Event): Promise<void>;
+}
+/** IPC 事件订阅者，定义处理特定类型 IPC 事件的方式。 */
+declare class Subscriber {
+    /** 事件类型 */
+    readonly eventType: string;
+    /** 匹配到感兴趣事件类型时的处理函数 */
+    readonly onEvent: (event: Event) => void;
+    constructor(
+    /** 事件类型 */
+    eventType: string, 
+    /** 匹配到感兴趣事件类型时的处理函数 */
+    onEvent: (event: Event) => void);
+}
+
+export { type EventBus, Subscriber };

package/dist/moonbridge-ipc/client/types/ipc_event_bus.d.ts

@@ -0,0 +1,26 @@
+/**
+ * IPC 事件总线接口与订阅者类型，对应 Flutter lib/client/types/ipc_event_bus.dart。
+ */
+import { Event } from '../../general/message/event';
+/** IPC 事件总线接口。 */
+export interface EventBus {
+    /** 注册事件订阅者，订阅特定类型的事件。 */
+    register(subscriber: Subscriber): void;
+    /** 注销事件订阅者，取消订阅事件。 */
+    unregister(subscriber: Subscriber): void;
+    /** 发布事件，通知所有订阅者。 */
+    post(event: Event): Promise<void>;
+}
+/** IPC 事件订阅者，定义处理特定类型 IPC 事件的方式。 */
+export declare class Subscriber {
+    /** 事件类型 */
+    readonly eventType: string;
+    /** 匹配到感兴趣事件类型时的处理函数 */
+    readonly onEvent: (event: Event) => void;
+    constructor(
+    /** 事件类型 */
+    eventType: string, 
+    /** 匹配到感兴趣事件类型时的处理函数 */
+    onEvent: (event: Event) => void);
+}
+//# sourceMappingURL=ipc_event_bus.d.ts.map

package/dist/moonbridge-ipc/client/types/ipc_event_bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_event_bus.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/client/types/ipc_event_bus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEpD,kBAAkB;AAClB,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAEvC,sBAAsB;IACtB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAEzC,oBAAoB;IACpB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,oCAAoC;AACpC,qBAAa,UAAU;IAEnB,WAAW;aACK,SAAS,EAAE,MAAM;IACjC,uBAAuB;aACP,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;;IAH/C,WAAW;IACK,SAAS,EAAE,MAAM;IACjC,uBAAuB;IACP,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;CAElD"}