moonbridge-ts 0.1.0

package/dist/moonbridge-ipc/client/types/ipc_event_bus.js

@@ -0,0 +1,12 @@
+'use strict';
+
+class Subscriber {
+  constructor(eventType, onEvent) {
+    this.eventType = eventType;
+    this.onEvent = onEvent;
+  }
+}
+
+exports.Subscriber = Subscriber;
+//# sourceMappingURL=ipc_event_bus.js.map
+//# sourceMappingURL=ipc_event_bus.js.map

package/dist/moonbridge-ipc/client/types/ipc_event_bus.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_event_bus.ts"],"names":[],"mappings":";;AAmBO,MAAM,UAAA,CAAW;AAAA,EACtB,WAAA,CAEkB,WAEA,OAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAEA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EACd;AACN","file":"ipc_event_bus.js","sourcesContent":["/**\n * IPC 事件总线接口与订阅者类型，对应 Flutter lib/client/types/ipc_event_bus.dart。\n */\n\nimport { Event } from '../../general/message/event';\n\n/** IPC 事件总线接口。 */\nexport interface EventBus {\n  /** 注册事件订阅者，订阅特定类型的事件。 */\n  register(subscriber: Subscriber): void;\n\n  /** 注销事件订阅者，取消订阅事件。 */\n  unregister(subscriber: Subscriber): void;\n\n  /** 发布事件，通知所有订阅者。 */\n  post(event: Event): Promise<void>;\n}\n\n/** IPC 事件订阅者，定义处理特定类型 IPC 事件的方式。 */\nexport class Subscriber {\n  constructor(\n    /** 事件类型 */\n    public readonly eventType: string,\n    /** 匹配到感兴趣事件类型时的处理函数 */\n    public readonly onEvent: (event: Event) => void,\n  ) { }\n}\n\n"]}

package/dist/moonbridge-ipc/client/types/ipc_event_bus.mjs

@@ -0,0 +1,10 @@
+class Subscriber {
+  constructor(eventType, onEvent) {
+    this.eventType = eventType;
+    this.onEvent = onEvent;
+  }
+}
+
+export { Subscriber };
+//# sourceMappingURL=ipc_event_bus.mjs.map
+//# sourceMappingURL=ipc_event_bus.mjs.map

package/dist/moonbridge-ipc/client/types/ipc_event_bus.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_event_bus.ts"],"names":[],"mappings":"AAmBO,MAAM,UAAA,CAAW;AAAA,EACtB,WAAA,CAEkB,WAEA,OAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAEA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EACd;AACN","file":"ipc_event_bus.mjs","sourcesContent":["/**\n * IPC 事件总线接口与订阅者类型，对应 Flutter lib/client/types/ipc_event_bus.dart。\n */\n\nimport { Event } from '../../general/message/event';\n\n/** IPC 事件总线接口。 */\nexport interface EventBus {\n  /** 注册事件订阅者，订阅特定类型的事件。 */\n  register(subscriber: Subscriber): void;\n\n  /** 注销事件订阅者，取消订阅事件。 */\n  unregister(subscriber: Subscriber): void;\n\n  /** 发布事件，通知所有订阅者。 */\n  post(event: Event): Promise<void>;\n}\n\n/** IPC 事件订阅者，定义处理特定类型 IPC 事件的方式。 */\nexport class Subscriber {\n  constructor(\n    /** 事件类型 */\n    public readonly eventType: string,\n    /** 匹配到感兴趣事件类型时的处理函数 */\n    public readonly onEvent: (event: Event) => void,\n  ) { }\n}\n\n"]}

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

@@ -0,0 +1,17 @@
+/**
+ * IPC 消息策略类，对应 Flutter lib/client/types/ipc_message_strategy.dart IpcMessageStrategy。
+ */
+declare class IpcMessageStrategy {
+    /** 重试次数，默认为 1 */
+    readonly retries: number;
+    /** 是否应该自动启动目标应用，默认为 true */
+    readonly autoLaunch: boolean;
+    constructor(
+    /** 重试次数，默认为 1 */
+    retries?: number, 
+    /** 是否应该自动启动目标应用，默认为 true */
+    autoLaunch?: boolean);
+    toString(): string;
+}
+
+export { IpcMessageStrategy };

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

@@ -0,0 +1,16 @@
+/**
+ * IPC 消息策略类，对应 Flutter lib/client/types/ipc_message_strategy.dart IpcMessageStrategy。
+ */
+export declare class IpcMessageStrategy {
+    /** 重试次数，默认为 1 */
+    readonly retries: number;
+    /** 是否应该自动启动目标应用，默认为 true */
+    readonly autoLaunch: boolean;
+    constructor(
+    /** 重试次数，默认为 1 */
+    retries?: number, 
+    /** 是否应该自动启动目标应用，默认为 true */
+    autoLaunch?: boolean);
+    toString(): string;
+}
+//# sourceMappingURL=ipc_message_strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_message_strategy.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/client/types/ipc_message_strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,kBAAkB;IAE3B,iBAAiB;aACD,OAAO,EAAE,MAAM;IAC/B,4BAA4B;aACZ,UAAU,EAAE,OAAO;;IAHnC,iBAAiB;IACD,OAAO,GAAE,MAAU;IACnC,4BAA4B;IACZ,UAAU,GAAE,OAAc;IAO5C,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/moonbridge-ipc/client/types/ipc_message_strategy.js

@@ -0,0 +1,18 @@
+'use strict';
+
+class IpcMessageStrategy {
+  constructor(retries = 1, autoLaunch = true) {
+    this.retries = retries;
+    this.autoLaunch = autoLaunch;
+    if (this.retries < 0) {
+      throw new Error("retries must be greater than 0");
+    }
+  }
+  toString() {
+    return `IpcMessageStrategy(retries: ${this.retries}, autoLaunch: ${this.autoLaunch})`;
+  }
+}
+
+exports.IpcMessageStrategy = IpcMessageStrategy;
+//# sourceMappingURL=ipc_message_strategy.js.map
+//# sourceMappingURL=ipc_message_strategy.js.map

package/dist/moonbridge-ipc/client/types/ipc_message_strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_message_strategy.ts"],"names":[],"mappings":";;AAIO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,OAAA,GAAkB,CAAA,EAElB,UAAA,GAAsB,IAAA,EACtC;AAHgB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAEA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAEhB,IAAA,IAAI,IAAA,CAAK,UAAU,CAAA,EAAG;AACpB,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,QAAA,GAAmB;AACjB,IAAA,OAAO,CAAA,4BAAA,EAA+B,IAAA,CAAK,OAAO,CAAA,cAAA,EAAiB,KAAK,UAAU,CAAA,CAAA,CAAA;AAAA,EACpF;AACF","file":"ipc_message_strategy.js","sourcesContent":["/**\n * IPC 消息策略类，对应 Flutter lib/client/types/ipc_message_strategy.dart IpcMessageStrategy。\n */\n\nexport class IpcMessageStrategy {\n  constructor(\n    /** 重试次数，默认为 1 */\n    public readonly retries: number = 1,\n    /** 是否应该自动启动目标应用，默认为 true */\n    public readonly autoLaunch: boolean = true,\n  ) {\n    if (this.retries < 0) {\n      throw new Error('retries must be greater than 0');\n    }\n  }\n\n  toString(): string {\n    return `IpcMessageStrategy(retries: ${this.retries}, autoLaunch: ${this.autoLaunch})`;\n  }\n}\n\n"]}

package/dist/moonbridge-ipc/client/types/ipc_message_strategy.mjs

@@ -0,0 +1,16 @@
+class IpcMessageStrategy {
+  constructor(retries = 1, autoLaunch = true) {
+    this.retries = retries;
+    this.autoLaunch = autoLaunch;
+    if (this.retries < 0) {
+      throw new Error("retries must be greater than 0");
+    }
+  }
+  toString() {
+    return `IpcMessageStrategy(retries: ${this.retries}, autoLaunch: ${this.autoLaunch})`;
+  }
+}
+
+export { IpcMessageStrategy };
+//# sourceMappingURL=ipc_message_strategy.mjs.map
+//# sourceMappingURL=ipc_message_strategy.mjs.map

package/dist/moonbridge-ipc/client/types/ipc_message_strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_message_strategy.ts"],"names":[],"mappings":"AAIO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,OAAA,GAAkB,CAAA,EAElB,UAAA,GAAsB,IAAA,EACtC;AAHgB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAEA,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAEhB,IAAA,IAAI,IAAA,CAAK,UAAU,CAAA,EAAG;AACpB,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,QAAA,GAAmB;AACjB,IAAA,OAAO,CAAA,4BAAA,EAA+B,IAAA,CAAK,OAAO,CAAA,cAAA,EAAiB,KAAK,UAAU,CAAA,CAAA,CAAA;AAAA,EACpF;AACF","file":"ipc_message_strategy.mjs","sourcesContent":["/**\n * IPC 消息策略类，对应 Flutter lib/client/types/ipc_message_strategy.dart IpcMessageStrategy。\n */\n\nexport class IpcMessageStrategy {\n  constructor(\n    /** 重试次数，默认为 1 */\n    public readonly retries: number = 1,\n    /** 是否应该自动启动目标应用，默认为 true */\n    public readonly autoLaunch: boolean = true,\n  ) {\n    if (this.retries < 0) {\n      throw new Error('retries must be greater than 0');\n    }\n  }\n\n  toString(): string {\n    return `IpcMessageStrategy(retries: ${this.retries}, autoLaunch: ${this.autoLaunch})`;\n  }\n}\n\n"]}

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

@@ -0,0 +1,45 @@
+import { IpcErrorCallback } from './ipc_types.mjs';
+import { IpcMessageStrategy } from './ipc_message_strategy.mjs';
+import '../../general/error/ipc_error.mjs';
+import '../../general/message/request.mjs';
+import '../../general/message/response.mjs';
+import '../../general/message/error.mjs';
+
+/**
+ * IPC 消息信使抽象，对应 Flutter lib/client/types/ipc_messenger.dart Messenger。
+ * 仅定义接口，不包含具体实现。
+ */
+
+/**
+ * 消息端点类型
+ * 用于唯一标识一个方法，包括客户端名称、模块名称和方法名称。
+ */
+type MessageEndpoint = {
+    clientName: string;
+    moduleName: string;
+    methodName: string;
+};
+/**
+ * 消息调用配置类型
+ * 用于传递消息调用时的参数和配置。
+ */
+interface MessageCallOptions {
+    args?: unknown[];
+    strategy?: IpcMessageStrategy;
+    onError?: IpcErrorCallback;
+}
+interface Messenger {
+    /** 极简调用：仅传核心定位+参数 */
+    postMessage(target: MessageEndpoint, args?: unknown[]): void;
+    /** 完整调用：传定位+全量配置 */
+    postMessage(target: MessageEndpoint, options?: MessageCallOptions): void;
+    /**
+     * 获取指定 RPC 服务接口的代理实例。
+     *
+     * @param clientName 目标客户端名称，可选
+     * @returns 类型为 T 的服务代理实例，或 undefined（如客户端不存在 / 服务未注册）。US2：统一使用 undefined。
+     */
+    getService<T = unknown>(clientName?: string): T | undefined;
+}
+
+export type { MessageCallOptions, MessageEndpoint, Messenger };

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

@@ -0,0 +1,38 @@
+/**
+ * IPC 消息信使抽象，对应 Flutter lib/client/types/ipc_messenger.dart Messenger。
+ * 仅定义接口，不包含具体实现。
+ */
+import { IpcErrorCallback } from './ipc_types';
+import { IpcMessageStrategy } from './ipc_message_strategy';
+/**
+ * 消息端点类型
+ * 用于唯一标识一个方法，包括客户端名称、模块名称和方法名称。
+ */
+export type MessageEndpoint = {
+    clientName: string;
+    moduleName: string;
+    methodName: string;
+};
+/**
+ * 消息调用配置类型
+ * 用于传递消息调用时的参数和配置。
+ */
+export interface MessageCallOptions {
+    args?: unknown[];
+    strategy?: IpcMessageStrategy;
+    onError?: IpcErrorCallback;
+}
+export interface Messenger {
+    /** 极简调用：仅传核心定位+参数 */
+    postMessage(target: MessageEndpoint, args?: unknown[]): void;
+    /** 完整调用：传定位+全量配置 */
+    postMessage(target: MessageEndpoint, options?: MessageCallOptions): void;
+    /**
+     * 获取指定 RPC 服务接口的代理实例。
+     *
+     * @param clientName 目标客户端名称，可选
+     * @returns 类型为 T 的服务代理实例，或 undefined（如客户端不存在 / 服务未注册）。US2：统一使用 undefined。
+     */
+    getService<T = unknown>(clientName?: string): T | undefined;
+}
+//# sourceMappingURL=ipc_messenger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_messenger.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/client/types/ipc_messenger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7D,oBAAoB;IACpB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEzE;;;;;OAKG;IACH,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAC7D"}

package/dist/moonbridge-ipc/client/types/ipc_messenger.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=ipc_messenger.js.map
+//# sourceMappingURL=ipc_messenger.js.map

package/dist/moonbridge-ipc/client/types/ipc_messenger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ipc_messenger.js"}

package/dist/moonbridge-ipc/client/types/ipc_messenger.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=ipc_messenger.mjs.map
+//# sourceMappingURL=ipc_messenger.mjs.map

package/dist/moonbridge-ipc/client/types/ipc_messenger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"ipc_messenger.mjs"}

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

@@ -0,0 +1,52 @@
+import { IpcError } from '../../general/error/ipc_error.mjs';
+import { Request } from '../../general/message/request.mjs';
+import { Response } from '../../general/message/response.mjs';
+import { Error } from '../../general/message/error.mjs';
+
+/**
+ * IPC 类型定义，对应 Flutter lib/client/types/ipc_types.dart。
+ * 仅定义类型，不包含具体实现逻辑。
+ */
+
+/** 响应回调：接收动态数组形式的响应载荷。 */
+type IpcResponseCallback = (response: unknown[]) => void;
+/** 错误回调：接收 IpcError。 */
+type IpcErrorCallback = (error: IpcError) => void;
+/** 服务端进程连接完成处理器。US2：统一使用 undefined 表示无错误，不再使用 | null。 */
+type IpcConnectionCompletionHandler = (isConnected: boolean, error?: IpcError) => void;
+/**
+ * IPC 消息拦截器，用于拦截和处理 IPC 消息。
+ * 对应 Flutter MessageInterceptor。
+ */
+declare class MessageInterceptor {
+    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */
+    readonly interceptRequest?: ((request: Request) => boolean) | undefined;
+    /** 拦截响应消息；返回 true 表示已处理 */
+    readonly interceptResponse?: ((response: Response) => boolean) | undefined;
+    /** 拦截错误消息；返回 true 表示已处理 */
+    readonly interceptError?: ((error: Error) => boolean) | undefined;
+    constructor(
+    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */
+    interceptRequest?: ((request: Request) => boolean) | undefined, 
+    /** 拦截响应消息；返回 true 表示已处理 */
+    interceptResponse?: ((response: Response) => boolean) | undefined, 
+    /** 拦截错误消息；返回 true 表示已处理 */
+    interceptError?: ((error: Error) => boolean) | undefined);
+}
+/**
+ * IPC 连接状态观察器，定义处理与服务端连接状态变化的方式。
+ * 对应 Flutter ConnectionObserver。
+ */
+declare class ConnectionObserver {
+    /** 当与服务端建立连接时调用 */
+    readonly onConnected?: (() => void) | undefined;
+    /** 当与服务端断开连接时调用 */
+    readonly onDisconnected?: (() => void) | undefined;
+    constructor(
+    /** 当与服务端建立连接时调用 */
+    onConnected?: (() => void) | undefined, 
+    /** 当与服务端断开连接时调用 */
+    onDisconnected?: (() => void) | undefined);
+}
+
+export { ConnectionObserver, type IpcConnectionCompletionHandler, type IpcErrorCallback, type IpcResponseCallback, MessageInterceptor };

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

@@ -0,0 +1,49 @@
+/**
+ * IPC 类型定义，对应 Flutter lib/client/types/ipc_types.dart。
+ * 仅定义类型，不包含具体实现逻辑。
+ */
+import { IpcError } from '../../general/error/ipc_error';
+import { Request } from '../../general/message/request';
+import { Response } from '../../general/message/response';
+import { Error } from '../../general/message/error';
+/** 响应回调：接收动态数组形式的响应载荷。 */
+export type IpcResponseCallback = (response: unknown[]) => void;
+/** 错误回调：接收 IpcError。 */
+export type IpcErrorCallback = (error: IpcError) => void;
+/** 服务端进程连接完成处理器。US2：统一使用 undefined 表示无错误，不再使用 | null。 */
+export type IpcConnectionCompletionHandler = (isConnected: boolean, error?: IpcError) => void;
+/**
+ * IPC 消息拦截器，用于拦截和处理 IPC 消息。
+ * 对应 Flutter MessageInterceptor。
+ */
+export declare class MessageInterceptor {
+    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */
+    readonly interceptRequest?: ((request: Request) => boolean) | undefined;
+    /** 拦截响应消息；返回 true 表示已处理 */
+    readonly interceptResponse?: ((response: Response) => boolean) | undefined;
+    /** 拦截错误消息；返回 true 表示已处理 */
+    readonly interceptError?: ((error: Error) => boolean) | undefined;
+    constructor(
+    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */
+    interceptRequest?: ((request: Request) => boolean) | undefined, 
+    /** 拦截响应消息；返回 true 表示已处理 */
+    interceptResponse?: ((response: Response) => boolean) | undefined, 
+    /** 拦截错误消息；返回 true 表示已处理 */
+    interceptError?: ((error: Error) => boolean) | undefined);
+}
+/**
+ * IPC 连接状态观察器，定义处理与服务端连接状态变化的方式。
+ * 对应 Flutter ConnectionObserver。
+ */
+export declare class ConnectionObserver {
+    /** 当与服务端建立连接时调用 */
+    readonly onConnected?: (() => void) | undefined;
+    /** 当与服务端断开连接时调用 */
+    readonly onDisconnected?: (() => void) | undefined;
+    constructor(
+    /** 当与服务端建立连接时调用 */
+    onConnected?: (() => void) | undefined, 
+    /** 当与服务端断开连接时调用 */
+    onDisconnected?: (() => void) | undefined);
+}
+//# sourceMappingURL=ipc_types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ipc_types.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/client/types/ipc_types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEpD,0BAA0B;AAC1B,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEhE,wBAAwB;AACxB,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEzD,yDAAyD;AACzD,MAAM,MAAM,8BAA8B,GAAG,CAC3C,WAAW,EAAE,OAAO,EACpB,KAAK,CAAC,EAAE,QAAQ,KACb,IAAI,CAAC;AAEV;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,0CAA0C;aAC1B,gBAAgB,CAAC,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO;IAChE,2BAA2B;aACX,iBAAiB,CAAC,GAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO;IACnE,2BAA2B;aACX,cAAc,CAAC,GAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO;;IAL1D,0CAA0C;IAC1B,gBAAgB,CAAC,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,aAAA;IAChE,2BAA2B;IACX,iBAAiB,CAAC,GAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,aAAA;IACnE,2BAA2B;IACX,cAAc,CAAC,GAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,aAAA;CAE7D;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,mBAAmB;aACH,WAAW,CAAC,GAAE,MAAM,IAAI;IACxC,mBAAmB;aACH,cAAc,CAAC,GAAE,MAAM,IAAI;;IAH3C,mBAAmB;IACH,WAAW,CAAC,GAAE,MAAM,IAAI,aAAA;IACxC,mBAAmB;IACH,cAAc,CAAC,GAAE,MAAM,IAAI,aAAA;CAE9C"}

package/dist/moonbridge-ipc/client/types/ipc_types.js

@@ -0,0 +1,20 @@
+'use strict';
+
+class MessageInterceptor {
+  constructor(interceptRequest, interceptResponse, interceptError) {
+    this.interceptRequest = interceptRequest;
+    this.interceptResponse = interceptResponse;
+    this.interceptError = interceptError;
+  }
+}
+class ConnectionObserver {
+  constructor(onConnected, onDisconnected) {
+    this.onConnected = onConnected;
+    this.onDisconnected = onDisconnected;
+  }
+}
+
+exports.ConnectionObserver = ConnectionObserver;
+exports.MessageInterceptor = MessageInterceptor;
+//# sourceMappingURL=ipc_types.js.map
+//# sourceMappingURL=ipc_types.js.map

package/dist/moonbridge-ipc/client/types/ipc_types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_types.ts"],"names":[],"mappings":";;AA0BO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,gBAAA,EAEA,iBAAA,EAEA,cAAA,EAChB;AALgB,IAAA,IAAA,CAAA,gBAAA,GAAA,gBAAA;AAEA,IAAA,IAAA,CAAA,iBAAA,GAAA,iBAAA;AAEA,IAAA,IAAA,CAAA,cAAA,GAAA,cAAA;AAAA,EACd;AACN;AAMO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,aAEA,cAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,WAAA,GAAA,WAAA;AAEA,IAAA,IAAA,CAAA,cAAA,GAAA,cAAA;AAAA,EACd;AACN","file":"ipc_types.js","sourcesContent":["/**\n * IPC 类型定义，对应 Flutter lib/client/types/ipc_types.dart。\n * 仅定义类型，不包含具体实现逻辑。\n */\n\nimport { IpcError } from '../../general/error/ipc_error';\nimport { Request } from '../../general/message/request';\nimport { Response } from '../../general/message/response';\nimport { Error } from '../../general/message/error';\n\n/** 响应回调：接收动态数组形式的响应载荷。 */\nexport type IpcResponseCallback = (response: unknown[]) => void;\n\n/** 错误回调：接收 IpcError。 */\nexport type IpcErrorCallback = (error: IpcError) => void;\n\n/** 服务端进程连接完成处理器。US2：统一使用 undefined 表示无错误，不再使用 | null。 */\nexport type IpcConnectionCompletionHandler = (\n  isConnected: boolean,\n  error?: IpcError,\n) => void;\n\n/**\n * IPC 消息拦截器，用于拦截和处理 IPC 消息。\n * 对应 Flutter MessageInterceptor。\n */\nexport class MessageInterceptor {\n  constructor(\n    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */\n    public readonly interceptRequest?: (request: Request) => boolean,\n    /** 拦截响应消息；返回 true 表示已处理 */\n    public readonly interceptResponse?: (response: Response) => boolean,\n    /** 拦截错误消息；返回 true 表示已处理 */\n    public readonly interceptError?: (error: Error) => boolean,\n  ) { }\n}\n\n/**\n * IPC 连接状态观察器，定义处理与服务端连接状态变化的方式。\n * 对应 Flutter ConnectionObserver。\n */\nexport class ConnectionObserver {\n  constructor(\n    /** 当与服务端建立连接时调用 */\n    public readonly onConnected?: () => void,\n    /** 当与服务端断开连接时调用 */\n    public readonly onDisconnected?: () => void,\n  ) { }\n}\n\n"]}

package/dist/moonbridge-ipc/client/types/ipc_types.mjs

@@ -0,0 +1,17 @@
+class MessageInterceptor {
+  constructor(interceptRequest, interceptResponse, interceptError) {
+    this.interceptRequest = interceptRequest;
+    this.interceptResponse = interceptResponse;
+    this.interceptError = interceptError;
+  }
+}
+class ConnectionObserver {
+  constructor(onConnected, onDisconnected) {
+    this.onConnected = onConnected;
+    this.onDisconnected = onDisconnected;
+  }
+}
+
+export { ConnectionObserver, MessageInterceptor };
+//# sourceMappingURL=ipc_types.mjs.map
+//# sourceMappingURL=ipc_types.mjs.map

package/dist/moonbridge-ipc/client/types/ipc_types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/moonbridge-ipc/client/types/ipc_types.ts"],"names":[],"mappings":"AA0BO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,gBAAA,EAEA,iBAAA,EAEA,cAAA,EAChB;AALgB,IAAA,IAAA,CAAA,gBAAA,GAAA,gBAAA;AAEA,IAAA,IAAA,CAAA,iBAAA,GAAA,iBAAA;AAEA,IAAA,IAAA,CAAA,cAAA,GAAA,cAAA;AAAA,EACd;AACN;AAMO,MAAM,kBAAA,CAAmB;AAAA,EAC9B,WAAA,CAEkB,aAEA,cAAA,EAChB;AAHgB,IAAA,IAAA,CAAA,WAAA,GAAA,WAAA;AAEA,IAAA,IAAA,CAAA,cAAA,GAAA,cAAA;AAAA,EACd;AACN","file":"ipc_types.mjs","sourcesContent":["/**\n * IPC 类型定义，对应 Flutter lib/client/types/ipc_types.dart。\n * 仅定义类型，不包含具体实现逻辑。\n */\n\nimport { IpcError } from '../../general/error/ipc_error';\nimport { Request } from '../../general/message/request';\nimport { Response } from '../../general/message/response';\nimport { Error } from '../../general/message/error';\n\n/** 响应回调：接收动态数组形式的响应载荷。 */\nexport type IpcResponseCallback = (response: unknown[]) => void;\n\n/** 错误回调：接收 IpcError。 */\nexport type IpcErrorCallback = (error: IpcError) => void;\n\n/** 服务端进程连接完成处理器。US2：统一使用 undefined 表示无错误，不再使用 | null。 */\nexport type IpcConnectionCompletionHandler = (\n  isConnected: boolean,\n  error?: IpcError,\n) => void;\n\n/**\n * IPC 消息拦截器，用于拦截和处理 IPC 消息。\n * 对应 Flutter MessageInterceptor。\n */\nexport class MessageInterceptor {\n  constructor(\n    /** 拦截请求消息；返回 true 表示已处理，false 表示继续默认逻辑 */\n    public readonly interceptRequest?: (request: Request) => boolean,\n    /** 拦截响应消息；返回 true 表示已处理 */\n    public readonly interceptResponse?: (response: Response) => boolean,\n    /** 拦截错误消息；返回 true 表示已处理 */\n    public readonly interceptError?: (error: Error) => boolean,\n  ) { }\n}\n\n/**\n * IPC 连接状态观察器，定义处理与服务端连接状态变化的方式。\n * 对应 Flutter ConnectionObserver。\n */\nexport class ConnectionObserver {\n  constructor(\n    /** 当与服务端建立连接时调用 */\n    public readonly onConnected?: () => void,\n    /** 当与服务端断开连接时调用 */\n    public readonly onDisconnected?: () => void,\n  ) { }\n}\n\n"]}

package/dist/moonbridge-ipc/extension/bridge_extension.d.mts

@@ -0,0 +1,33 @@
+import { a as BridgeModule, B as Bridge } from '../../bridge_module-Dd27cxv9.mjs';
+import { MoonBridgeIpcClient } from '../client/moonbridge_ipc_client.mjs';
+import '../../moonbridge/message/message_parser_manager.mjs';
+import '../../moonbridge/message/message.mjs';
+import '../../moonbridge/message/message_parser.mjs';
+import '../general/config/websocket_server_endpoint.mjs';
+import '../general/config/port_candidate_rule.mjs';
+import '../general/app_launch/model/app_info.mjs';
+import '../general/app_launch/app_launcher.mjs';
+import '../general/app_launch/model/app_launch_models.mjs';
+import '../client/types/ipc_message_strategy.mjs';
+import '../client/types/ipc_types.mjs';
+import '../general/error/ipc_error.mjs';
+import '../general/message/request.mjs';
+import '../general/message/response.mjs';
+import '../general/message/error.mjs';
+import '../client/types/ipc_event_bus.mjs';
+import '../general/message/event.mjs';
+import '../client/types/ipc_messenger.mjs';
+
+/**
+ * 桥接模块工具类
+ */
+declare class BridgeModuleUtils {
+    /**
+     * 获取 IPC 客户端
+     * @param object 桥接实例或桥接模块实例
+     * @returns IPC 客户端实例
+     */
+    static getIpcClient(object?: BridgeModule | Bridge): MoonBridgeIpcClient | undefined;
+}
+
+export { BridgeModuleUtils };

package/dist/moonbridge-ipc/extension/bridge_extension.d.ts

@@ -0,0 +1,15 @@
+import { Bridge } from "../../moonbridge/kernel/bridge";
+import { BridgeModule } from "../../moonbridge/kernel/bridge_module";
+import { MoonBridgeIpcClient } from "../client/moonbridge_ipc_client";
+/**
+ * 桥接模块工具类
+ */
+export declare class BridgeModuleUtils {
+    /**
+     * 获取 IPC 客户端
+     * @param object 桥接实例或桥接模块实例
+     * @returns IPC 客户端实例
+     */
+    static getIpcClient(object?: BridgeModule | Bridge): MoonBridgeIpcClient | undefined;
+}
+//# sourceMappingURL=bridge_extension.d.ts.map

package/dist/moonbridge-ipc/extension/bridge_extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge_extension.d.ts","sourceRoot":"","sources":["../../../src/moonbridge-ipc/extension/bridge_extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,qBAAa,iBAAiB;IAC1B;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,mBAAmB,GAAG,SAAS;CAiBvF"}

package/dist/moonbridge-ipc/extension/bridge_extension.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var bridge_module = require('../../moonbridge/kernel/bridge_module');
+var ipc_client_bridge = require('../client/internal/bridge/ipc_client_bridge');
+
+class BridgeModuleUtils {
+  /**
+   * 获取 IPC 客户端
+   * @param object 桥接实例或桥接模块实例
+   * @returns IPC 客户端实例
+   */
+  static getIpcClient(object) {
+    if (!object) {
+      return void 0;
+    }
+    let bridge;
+    if (object instanceof bridge_module.BridgeModule) {
+      bridge = object.bridge;
+    } else {
+      bridge = object;
+    }
+    if (bridge instanceof ipc_client_bridge.IpcClientBridge) {
+      return bridge.ipcClient;
+    }
+    return void 0;
+  }
+}
+
+exports.BridgeModuleUtils = BridgeModuleUtils;
+//# sourceMappingURL=bridge_extension.js.map
+//# sourceMappingURL=bridge_extension.js.map

package/dist/moonbridge-ipc/extension/bridge_extension.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/moonbridge-ipc/extension/bridge_extension.ts"],"names":["BridgeModule","IpcClientBridge"],"mappings":";;;;;AAQO,MAAM,iBAAA,CAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3B,OAAO,aAAa,MAAA,EAAiE;AACjF,IAAA,IAAI,CAAC,MAAA,EAAQ;AACT,MAAA,OAAO,MAAA;AAAA,IACX;AAEA,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,kBAAkBA,0BAAA,EAAc;AAChC,MAAA,MAAA,GAAS,MAAA,CAAO,MAAA;AAAA,IACpB,CAAA,MAAO;AACH,MAAA,MAAA,GAAS,MAAA;AAAA,IACb;AAEA,IAAA,IAAI,kBAAkBC,iCAAA,EAAiB;AACnC,MAAA,OAAO,MAAA,CAAO,SAAA;AAAA,IAClB;AACA,IAAA,OAAO,MAAA;AAAA,EACX;AACJ","file":"bridge_extension.js","sourcesContent":["import { Bridge } from \"../../moonbridge/kernel/bridge\";\nimport { BridgeModule } from \"../../moonbridge/kernel/bridge_module\";\nimport { IpcClientBridge } from \"../client/internal/bridge/ipc_client_bridge\";\nimport { MoonBridgeIpcClient } from \"../client/moonbridge_ipc_client\";\n\n/**\n * 桥接模块工具类\n */\nexport class BridgeModuleUtils {\n    /**\n     * 获取 IPC 客户端\n     * @param object 桥接实例或桥接模块实例\n     * @returns IPC 客户端实例\n     */\n    static getIpcClient(object?: BridgeModule | Bridge): MoonBridgeIpcClient | undefined {\n        if (!object) {\n            return undefined;\n        }\n\n        let bridge: Bridge | undefined;\n        if (object instanceof BridgeModule) {\n            bridge = object.bridge;\n        } else {\n            bridge = object;\n        }\n\n        if (bridge instanceof IpcClientBridge) {\n            return bridge.ipcClient;\n        }\n        return undefined;\n    }\n}"]}

package/dist/moonbridge-ipc/extension/bridge_extension.mjs

@@ -0,0 +1,29 @@
+import { BridgeModule } from '../../moonbridge/kernel/bridge_module';
+import { IpcClientBridge } from '../client/internal/bridge/ipc_client_bridge';
+
+class BridgeModuleUtils {
+  /**
+   * 获取 IPC 客户端
+   * @param object 桥接实例或桥接模块实例
+   * @returns IPC 客户端实例
+   */
+  static getIpcClient(object) {
+    if (!object) {
+      return void 0;
+    }
+    let bridge;
+    if (object instanceof BridgeModule) {
+      bridge = object.bridge;
+    } else {
+      bridge = object;
+    }
+    if (bridge instanceof IpcClientBridge) {
+      return bridge.ipcClient;
+    }
+    return void 0;
+  }
+}
+
+export { BridgeModuleUtils };
+//# sourceMappingURL=bridge_extension.mjs.map
+//# sourceMappingURL=bridge_extension.mjs.map

package/dist/moonbridge-ipc/extension/bridge_extension.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/moonbridge-ipc/extension/bridge_extension.ts"],"names":[],"mappings":";;;AAQO,MAAM,iBAAA,CAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3B,OAAO,aAAa,MAAA,EAAiE;AACjF,IAAA,IAAI,CAAC,MAAA,EAAQ;AACT,MAAA,OAAO,MAAA;AAAA,IACX;AAEA,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,kBAAkB,YAAA,EAAc;AAChC,MAAA,MAAA,GAAS,MAAA,CAAO,MAAA;AAAA,IACpB,CAAA,MAAO;AACH,MAAA,MAAA,GAAS,MAAA;AAAA,IACb;AAEA,IAAA,IAAI,kBAAkB,eAAA,EAAiB;AACnC,MAAA,OAAO,MAAA,CAAO,SAAA;AAAA,IAClB;AACA,IAAA,OAAO,MAAA;AAAA,EACX;AACJ","file":"bridge_extension.mjs","sourcesContent":["import { Bridge } from \"../../moonbridge/kernel/bridge\";\nimport { BridgeModule } from \"../../moonbridge/kernel/bridge_module\";\nimport { IpcClientBridge } from \"../client/internal/bridge/ipc_client_bridge\";\nimport { MoonBridgeIpcClient } from \"../client/moonbridge_ipc_client\";\n\n/**\n * 桥接模块工具类\n */\nexport class BridgeModuleUtils {\n    /**\n     * 获取 IPC 客户端\n     * @param object 桥接实例或桥接模块实例\n     * @returns IPC 客户端实例\n     */\n    static getIpcClient(object?: BridgeModule | Bridge): MoonBridgeIpcClient | undefined {\n        if (!object) {\n            return undefined;\n        }\n\n        let bridge: Bridge | undefined;\n        if (object instanceof BridgeModule) {\n            bridge = object.bridge;\n        } else {\n            bridge = object;\n        }\n\n        if (bridge instanceof IpcClientBridge) {\n            return bridge.ipcClient;\n        }\n        return undefined;\n    }\n}"]}

package/dist/moonbridge-ipc/general/app_launch/app_launcher.d.mts

@@ -0,0 +1,23 @@
+import { AppLaunchResult } from './model/app_launch_models.mjs';
+
+/**
+ * 跨进程唤醒服务端应用的抽象，与 Flutter PlatformAppLauncher 行为对齐（US4）。
+ *
+ * 宿主（如 WPS 加载项）可通过 IpcClientSettings.appLauncher 注入真实实现；
+ * 例如在 wps-addin 中封装 wakeNpc 等能力后传入。未注入时 ConnectionManager 使用 StubAppLauncher。
+ *
+ * 019：launchApp 返回 AppLaunchResult，含 success 与 error，便于业务层识别失败原因。
+ */
+
+/**
+ * 应用启动器接口：用于在服务端未运行时尝试唤醒目标应用。
+ * 真实实现可由宿主（如 WPS 加载项 / wps-addin wakeNpc）提供并注入。
+ */
+interface AppLauncher {
+    /** 尝试启动/唤醒目标应用；返回结果对象，含 success 与可选 error */
+    launchApp(): Promise<AppLaunchResult>;
+    /** 可选：检查目标应用是否已在运行 */
+    isAppRunning?(): Promise<boolean>;
+}
+
+export type { AppLauncher };

package/dist/moonbridge-ipc/general/app_launch/app_launcher.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 跨进程唤醒服务端应用的抽象，与 Flutter PlatformAppLauncher 行为对齐（US4）。
+ *
+ * 宿主（如 WPS 加载项）可通过 IpcClientSettings.appLauncher 注入真实实现；
+ * 例如在 wps-addin 中封装 wakeNpc 等能力后传入。未注入时 ConnectionManager 使用 StubAppLauncher。
+ *
+ * 019：launchApp 返回 AppLaunchResult，含 success 与 error，便于业务层识别失败原因。
+ */
+import { AppLaunchResult } from './model/app_launch_models.js';
+/**
+ * 应用启动器接口：用于在服务端未运行时尝试唤醒目标应用。
+ * 真实实现可由宿主（如 WPS 加载项 / wps-addin wakeNpc）提供并注入。
+ */
+export interface AppLauncher {
+    /** 尝试启动/唤醒目标应用；返回结果对象，含 success 与可选 error */
+    launchApp(): Promise<AppLaunchResult>;
+    /** 可选：检查目标应用是否已在运行 */
+    isAppRunning?(): Promise<boolean>;
+}
+//# sourceMappingURL=app_launcher.d.ts.map

package/dist/moonbridge-ipc/general/app_launch/app_launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_launcher.d.ts","sourceRoot":"","sources":["../../../../src/moonbridge-ipc/general/app_launch/app_launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACtC,sBAAsB;IACtB,YAAY,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC"}

package/dist/moonbridge-ipc/general/app_launch/app_launcher.js

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=app_launcher.js.map
+//# sourceMappingURL=app_launcher.js.map

package/dist/moonbridge-ipc/general/app_launch/app_launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"app_launcher.js"}

package/dist/moonbridge-ipc/general/app_launch/app_launcher.mjs

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=app_launcher.mjs.map
+//# sourceMappingURL=app_launcher.mjs.map

package/dist/moonbridge-ipc/general/app_launch/app_launcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"app_launcher.mjs"}

package/dist/moonbridge-ipc/general/app_launch/internal/real_platform_app_launcher.d.mts

@@ -0,0 +1,34 @@
+import { AppLaunchIdentifier, AppInstallationPath } from '../model/app_info.mjs';
+import { AppLaunchResult } from '../model/app_launch_models.mjs';
+import { PlatformAppLauncher, LaunchAppOptions } from '../platform_app_launcher.mjs';
+
+/**
+ * Stub 实现：当前环境未实现唤醒时使用；launchApp 返回失败，isAppRunning 返回 false。
+ */
+declare class StubPlatformAppLauncher implements PlatformAppLauncher {
+    launchApp(): Promise<AppLaunchResult>;
+    isAppRunning(): Promise<boolean>;
+}
+/**
+ * 浏览器用启动器：通过 URL Scheme（从 AppLaunchIdentifier 取 iOSScheme）唤起；
+ * isAppRunning 在浏览器端不可知，返回 false。
+ */
+declare class BrowserPlatformAppLauncher implements PlatformAppLauncher {
+    private readonly appIdentifier;
+    constructor(appIdentifier: AppLaunchIdentifier);
+    launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;
+    isAppRunning(): Promise<boolean>;
+}
+/**
+ * Node 端启动器：按 AppInstallationPath 启动并轮询 isProcessRunning；
+ * 桌面优先路径，无路径时不适用（应由工厂返回 Stub）。
+ * 使用动态 import 加载 node_launcher，避免浏览器环境加载 child_process 等 Node 内置模块。
+ */
+declare class NodePlatformAppLauncher implements PlatformAppLauncher {
+    private readonly appInstallationPath;
+    constructor(appInstallationPath: AppInstallationPath);
+    launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;
+    isAppRunning(): Promise<boolean>;
+}
+
+export { BrowserPlatformAppLauncher, NodePlatformAppLauncher, StubPlatformAppLauncher };