moonbridge-ts 0.2.0 → 0.2.2

package/dist/moonbridge-ipc/general/transport/websocket/websocket_message_channel.d.mts

@@ -1,44 +0,0 @@
-import { SerialMessageChannel, SerialMessageChannelSubscribeOptions } from '../interface/serial_message_channel.mjs';
-
-/**
- * 基于 WebSocket 的 SerialMessageChannel 实现，对应 Flutter lib/general/transport/websocket/websocket_message_channel.dart。
- * 复用 data_frame_codec 帧格式，以二进制帧收发，与 Flutter 端协议一致。
- */
-
-/** 可选日志接口（与 Flutter Logger 简化对应） */
-interface ChannelLogger {
-    log(level: string, message: string, meta?: {
-        file?: string;
-        func?: string;
-    }): void;
-}
-interface WebSocketMessageChannelOptions {
-    address: string;
-    port: number;
-    remoteAddress: string;
-    remotePort: number;
-    logger?: ChannelLogger;
-}
-/**
- * WebSocket 消息通道
- */
-declare class WebSocketMessageChannel implements SerialMessageChannel {
-    private readonly _ws;
-    private readonly _address;
-    private readonly _port;
-    private readonly _remoteAddress;
-    private readonly _remotePort;
-    private readonly _logger;
-    private readonly _lock;
-    constructor(ws: WebSocket, options: WebSocketMessageChannelOptions);
-    get address(): string;
-    get port(): number;
-    get remoteAddress(): string;
-    get remotePort(): number;
-    sendMessage(message: string): Promise<boolean>;
-    close(): Promise<void>;
-    destroy(): void;
-    subscribe(onMessage: ((value: string) => void) | undefined, options?: SerialMessageChannelSubscribeOptions): () => void;
-}
-
-export { type ChannelLogger, WebSocketMessageChannel, type WebSocketMessageChannelOptions };

package/dist/moonbridge-ipc/general/transport/websocket/websocket_server.d.mts

@@ -1,71 +0,0 @@
-import { SerialMessageChannel } from '../interface/serial_message_channel.mjs';
-
-/**
- * WebSocket 服务端，基于 HttpServer 升级为 WebSocket。
- *
- * 每收到一次 WebSocket 升级请求即生成一个 [SerialMessageChannel]（[WebSocketMessageChannel]），
- * 通过 [onClientConnected] 交给上层，与 [SocketServer] 产出的 [SerialMessageSocket] 契约一致。
- */
-
-/**
- * 封装服务器的 IP 地址和端口号信息
- *
- * 该类用于存储和展示服务器的 IP 地址和端口号信息。
- */
-declare class ServerAddressInfo {
-    /** 服务器的 IP 地址 */
-    readonly ip: string;
-    /** 服务器的端口号 */
-    readonly port: number;
-    constructor(ip: string, port: number);
-    toString(): string;
-}
-/**
- * SocketServer 类用于处理服务器端的 TCP 通信。
- *
- * 它可以启动服务器并监听来自客户端的连接。
- */
-declare abstract class SocketServer {
-    static readonly anyIPv4 = "anyIPv4";
-    static readonly anyIPv6 = "anyIPv6";
-}
-/**
- * WebSocket 服务端，基于 HttpServer 升级为 WebSocket。
- * 仅支持 Node 环境，使用 ws + Node http。
- */
-declare class WebSocketServer {
-    /** 绑定地址，同 [SocketServer] 语义（如 `anyIPv4`） */
-    readonly address: string;
-    /** 监听端口（建议与 Socket 端口不同） */
-    readonly port: number;
-    /** 升级路径，如 `/` 或 `/ws` */
-    readonly path: string;
-    private _httpServer?;
-    private _isServerRunning;
-    private _resolvedAddress;
-    /**
-     * 构造 WebSocket 服务端。
-     * @param address 绑定地址
-     * @param port 监听端口
-     * @param options.path 升级路径，默认 `'/'`
-     */
-    constructor(address: string, port: number, options?: {
-        path?: string;
-    });
-    /**
-     * 启动 HTTP 服务并处理 WebSocket 升级；每建立一个 WebSocket 连接即调用 [onClientConnected]。
-     * @param onClientConnected 客户端连接回调
-     * @returns true 表示启动成功，false 表示失败
-     */
-    startServer(onClientConnected: (channel: SerialMessageChannel) => void): Promise<boolean>;
-    /**
-     * 关闭 HTTP 服务并停止接受新连接
-     */
-    close(): Promise<void>;
-    /** 是否正在运行 */
-    get isServerRunning(): boolean;
-    /** 本机地址与端口（若已启动） */
-    get serverAddressInfo(): ServerAddressInfo | undefined;
-}
-
-export { ServerAddressInfo, SocketServer, WebSocketServer };

package/dist/moonbridge-ipc/index.d.mts

@@ -1,26 +0,0 @@
-export { MoonBridgeIpcClient, MoonBridgeIpcClientBuilder, MoonBridgeIpcClientRegistry } from './client/moonbridge_ipc_client.mjs';
-export { AppInstallationPath, AppLaunchIdentifier } from './general/app_launch/model/app_info.mjs';
-export { AppLaunchArguments, AppLaunchResult, emptyAppLaunchArguments } from './general/app_launch/model/app_launch_models.mjs';
-export { APP_NOT_INSTALLED, LAUNCH_TIMEOUT, PERMISSION_DENIED, UNKNOWN } from './general/app_launch/model/app_launch_error_codes.mjs';
-export { PortCandidateRule, maxAttemptsCap } from './general/config/port_candidate_rule.mjs';
-export { WebSocketServerEndpoint } from './general/config/websocket_server_endpoint.mjs';
-export { ServerAddressInfo, SocketServer, WebSocketServer } from './general/transport/websocket/websocket_server.mjs';
-export { IpcError } from './general/error/ipc_error.mjs';
-export { MessageType } from './general/message/constants/message_types.mjs';
-export { Event } from './general/message/event.mjs';
-export { DisconnectedCallback, IpcMessageReply, MessagePreprocessor, MoonBridgeIpcServer, MoonBridgeIpcServerBuilder, MoonBridgeIpcServerRegistry, OnMessageReceived, WakeAppInterceptor } from './server/moonbridge_ipc_server.mjs';
-export { ClientIdentity, ClientIdentityProvider } from './server/credential/client_identity.mjs';
-export { MessageCallOptions, MessageEndpoint, Messenger } from './client/types/ipc_messenger.mjs';
-export { EventBus, Subscriber } from './client/types/ipc_event_bus.mjs';
-export { IpcMessageStrategy } from './client/types/ipc_message_strategy.mjs';
-export { ConnectionObserver, IpcConnectionCompletionHandler, IpcErrorCallback, IpcResponseCallback, MessageInterceptor } from './client/types/ipc_types.mjs';
-export { BridgeModuleUtils } from './extension/bridge_extension.mjs';
-import './general/app_launch/app_launcher.mjs';
-import './general/transport/interface/serial_message_channel.mjs';
-import './general/message/request.mjs';
-import './general/message/response.mjs';
-import './general/message/error.mjs';
-import '../bridge_module-Dd27cxv9.mjs';
-import '../moonbridge/message/message_parser_manager.mjs';
-import '../moonbridge/message/message.mjs';
-import '../moonbridge/message/message_parser.mjs';

package/dist/moonbridge-ipc/server/credential/client_identity.d.mts

@@ -1,38 +0,0 @@
-import { AppInstallationPath, AppLaunchIdentifier } from '../../general/app_launch/model/app_info.mjs';
-
-/**
- * IPC 客户端身份信息类
- *
- * 该类用于封装 IPC 客户端的身份信息，包括客户端名称、应用路径和启动标识符。
- *
- * 适用于需要通过跨平台（如 Windows、macOS、iOS 和 Android）的应用身份管理和操作场景。
- *
- * - **clientName**: 客户端的名称，用于标识特定的客户端应用。
- * - **appInstallationPath**: 表示应用在不同平台上的安装路径，可选。
- * - **appLaunchIdentifier**: 应用的启动标识符信息，用于唤醒或启动应用程序，可选。
- */
-
-/** 提供客户端身份信息的函数类型 */
-type ClientIdentityProvider = (clientName: string) => ClientIdentity | undefined;
-declare class ClientIdentity {
-    /** 客户端名称 */
-    readonly clientName: string;
-    /** 应用的安装路径信息 */
-    readonly appInstallationPath?: AppInstallationPath;
-    /** 应用的启动标识符信息 */
-    readonly appLaunchIdentifier?: AppLaunchIdentifier;
-    /**
-     * 构造函数
-     *
-     * @param clientName 客户端名称，用于标识特定的 IPC 客户端
-     * @param options.appInstallationPath 客户端的安装路径信息，默认为空
-     * @param options.appLaunchIdentifier 客户端的启动标识符信息，默认为空
-     */
-    constructor(clientName: string, options?: {
-        appInstallationPath?: AppInstallationPath;
-        appLaunchIdentifier?: AppLaunchIdentifier;
-    });
-    toString(): string;
-}
-
-export { ClientIdentity, type ClientIdentityProvider };

package/dist/moonbridge-ipc/server/internal/identity/client_identity_manager.d.mts

@@ -1,33 +0,0 @@
-import { ClientIdentityProvider, ClientIdentity } from '../../credential/client_identity.mjs';
-import '../../../general/app_launch/model/app_info.mjs';
-
-/**
- * IPC 客户端身份验证管理器类
- *
- * 该类用于管理和验证 IPC 客户端的身份信息。它通过维护一个客户端身份信息的映射表
- * 和多个身份信息提供者来提供身份验证功能。
- */
-
-declare class ClientIdentityManager {
-    /** 客户端身份信息提供者列表 */
-    private readonly _providers;
-    /**
-     * 添加客户端身份信息提供者
-     *
-     * 该方法用于添加一个客户端身份信息提供者到提供者列表中。
-     *
-     * @param provider 一个 [ClientIdentityProvider] 类型的函数，用于提供客户端身份信息
-     */
-    addClientIdentityProvider(provider: ClientIdentityProvider): void;
-    /**
-     * 获取 IPC 客户端身份信息
-     *
-     * 该方法用于根据客户端名称获取对应的客户端身份信息。
-     *
-     * @param clientName 客户端名称
-     * @returns 对应的 [ClientIdentity] 对象，如果未找到则返回 null
-     */
-    getClientIdentity(clientName: string): ClientIdentity | undefined;
-}
-
-export { ClientIdentityManager };

package/dist/moonbridge-ipc/server/internal/moonbridge_ipc_server.internal.d.mts

@@ -1,54 +0,0 @@
-import { WebSocketServerEndpoint } from '../../general/config/websocket_server_endpoint.mjs';
-import { MoonBridgeIpcServer, WakeAppInterceptor, DisconnectedCallback, MessagePreprocessor, OnMessageReceived } from '../moonbridge_ipc_server.mjs';
-import { ClientIdentityProvider } from '../credential/client_identity.mjs';
-import '../../general/config/port_candidate_rule.mjs';
-import '../../general/app_launch/model/app_info.mjs';
-
-/**
- * MoonBridge IPC 服务器实现类
- *
- * 该类用于管理 IPC 服务器，包括启动服务器、处理客户端连接和消息等功能。
- */
-
-declare class RealMoonBridgeIpcServer implements MoonBridgeIpcServer {
-    private readonly _serverName;
-    private readonly _wakeAppInterceptor?;
-    private readonly _onClientDisconnected?;
-    private readonly _messagePreprocessor?;
-    private readonly _onMessageReceived?;
-    private readonly _webSocketServerEndpoint?;
-    private readonly _clientSocketMap;
-    private readonly _addressToClientNameMap;
-    private readonly _clientIdentityManager;
-    private readonly _timerMap;
-    private readonly _sessionSetupRequests;
-    private _webSocketServer?;
-    constructor(serverName: string, webSocketServerEndpoint?: WebSocketServerEndpoint, wakeAppInterceptor?: WakeAppInterceptor, clientIdentityProviders?: ClientIdentityProvider[], onClientDisconnected?: DisconnectedCallback, messagePreprocessor?: MessagePreprocessor, onMessageReceived?: OnMessageReceived);
-    get serverName(): string;
-    start(): Promise<boolean>;
-    stop(): Promise<void>;
-    get serverAddress(): string | undefined;
-    get serverPort(): number | undefined;
-    private _addClient;
-    private _removeClient;
-    private _getClientName;
-    private _getClientAddress;
-    private _onMessage;
-    private _onRegistration;
-    private _onUnregistration;
-    private _onEvent;
-    private _onError;
-    private _onRequest;
-    private _onResponse;
-    private _onSessionSetupRequest;
-    private _onPing;
-    private _onHandshake;
-    private _validateClientIdentity;
-    private _handleExistingTargetClient;
-    private _wakeUpTargetClient;
-    private _sendSessionSetupResponse;
-    private _cancelClientTimer;
-    private _processSessionSetupRequests;
-}
-
-export { RealMoonBridgeIpcServer };

package/dist/moonbridge-ipc/server/moonbridge_ipc_server.d.mts

@@ -1,76 +0,0 @@
-import { WebSocketServerEndpoint } from '../general/config/websocket_server_endpoint.mjs';
-import { ClientIdentityProvider, ClientIdentity } from './credential/client_identity.mjs';
-import '../general/config/port_candidate_rule.mjs';
-import '../general/app_launch/model/app_info.mjs';
-
-/**
- * MoonBridge IPC 服务器入口类
- */
-
-/** 消息回复函数，用于向客户端发送响应消息 */
-type IpcMessageReply = (message: string) => Promise<boolean>;
-/** 唤醒客户端应用拦截器 */
-type WakeAppInterceptor = (clientIdentity: ClientIdentity) => boolean;
-/** 客户端断开连接的回调函数 */
-type DisconnectedCallback = (clientName: string) => void;
-/** 消息预处理器 */
-type MessagePreprocessor = (reply: IpcMessageReply, message: string) => boolean;
-/** 消息接收回调 */
-type OnMessageReceived = (clientName: string, type: string, message: string) => void;
-/**
- * MoonBridge IPC 服务器抽象类
- */
-declare abstract class MoonBridgeIpcServer {
-    static readonly anyIPv4 = "anyIPv4";
-    static readonly anyIPv6 = "anyIPv6";
-    static builder(): MoonBridgeIpcServerBuilder;
-    abstract readonly serverName: string;
-    abstract start(): Promise<boolean>;
-    abstract stop(): Promise<void>;
-    abstract get serverAddress(): string | undefined;
-    abstract get serverPort(): number | undefined;
-}
-/**
- * MoonBridge IPC 服务器构造器
- */
-declare class MoonBridgeIpcServerBuilder {
-    private _serverName;
-    private _webSocketServerEndpoint?;
-    private _clientIdentityProviders?;
-    private _wakeAppInterceptor?;
-    private _onClientDisconnected?;
-    private _messagePreprocessor?;
-    private _onMessageReceived?;
-    /** 设置服务器名称 */
-    serverName(name: string): this;
-    /** 设置 WebSocket 服务端通道监听配置；null 表示不启动 WebSocket。 */
-    useWebSocketChannel(endpoint: WebSocketServerEndpoint): this;
-    /** 设置客户端身份信息提供者列表 */
-    clientIdentityProviders(providers: ClientIdentityProvider[]): this;
-    /** 设置唤醒客户端应用的拦截器 */
-    wakeAppInterceptor(interceptor: WakeAppInterceptor): this;
-    /** 设置客户端断开连接的回调函数 */
-    onClientDisconnected(callback: DisconnectedCallback): this;
-    /** 设置消息预处理器 */
-    messagePreprocessor(preprocessor: MessagePreprocessor): this;
-    /** 设置消息接收回调 */
-    onMessageReceived(callback: OnMessageReceived): this;
-    /**
-     * 构建并返回配置完成的服务器实例
-     * @param makeDefault 是否将该服务器实例设置为默认服务器，默认为 false
-     */
-    build(makeDefault?: boolean): MoonBridgeIpcServer;
-}
-/**
- * MoonBridge IPC 服务端注册器
- */
-declare class MoonBridgeIpcServerRegistry {
-    private static _instance?;
-    private readonly _serverMap;
-    static get instance(): MoonBridgeIpcServerRegistry;
-    setDefault(server: MoonBridgeIpcServer): void;
-    register(server: MoonBridgeIpcServer): void;
-    get(serverName?: string): MoonBridgeIpcServer | undefined;
-}
-
-export { type DisconnectedCallback, type IpcMessageReply, type MessagePreprocessor, MoonBridgeIpcServer, MoonBridgeIpcServerBuilder, MoonBridgeIpcServerRegistry, type OnMessageReceived, type WakeAppInterceptor };

package/dist/moonbridge-ipc/utils/env.d.mts

@@ -1,7 +0,0 @@
-/**
- * 判断当前是否为 Node.js 环境。
- * @returns true 表示 Node 环境，false 表示浏览器环境
- */
-declare function isNodeEnv(): boolean;
-
-export { isNodeEnv };

package/dist/moonbridge-ipc/utils/logger.d.mts

@@ -1,9 +0,0 @@
-import { Logger } from '../../moonbridge/logger/logger.mjs';
-
-/**
- * moonbridge-ipc 模块共享 logger 实例，tag 为 moonbridge-ipc。
- */
-
-declare const logger: Logger;
-
-export { logger };

package/dist/moonbridge-ipc/utils/string_utils.d.mts

@@ -1,10 +0,0 @@
-/**
- * 字符串工具，对应 Flutter lib/general/utils/string_utils.dart StringExtension.generateRandomString。
- */
-/**
- * 生成指定长度的随机字符串。
- * @param length - 长度，默认 8
- */
-declare function generateRandomString(length?: number): string;
-
-export { generateRandomString };

package/dist/wps-launcher/index.d.mts

@@ -1,3 +0,0 @@
-export { FallbackMethod, WpsAppLauncher, WpsAppLauncherOptions } from './launcher/wps_app_launcher.mjs';
-import '../moonbridge-ipc/general/app_launch/app_launcher.mjs';
-import '../moonbridge-ipc/general/app_launch/model/app_launch_models.mjs';

package/dist/wps-launcher/launcher/wps_app_launcher.d.mts

@@ -1,61 +0,0 @@
-import { AppLauncher } from '../../moonbridge-ipc/general/app_launch/app_launcher.mjs';
-import { AppLaunchResult } from '../../moonbridge-ipc/general/app_launch/model/app_launch_models.mjs';
-
-/**
- * WPS 加载项专属的 AppLauncher 实现。
- * 使用 electron.shell.openExternal 或多种 fallback（模拟链接点击、location.href、iframe、window.open）触发 deeplink；
- * 不包含 WPS.ShowTip、引导下载页等业务层能力，由 wps-addin 负责。
- */
-
-/**
- * fallback 触发方式：模拟链接点击、location.href、隐藏 iframe、window.open
- */
-type FallbackMethod = 'linkClick' | 'locationHref' | 'iframe' | 'windowOpen';
-/**
- * WpsAppLauncher 的配置项。
- * 仅包含唤起所需参数；用户反馈（WPS.ShowTip、引导下载页）由 wps-addin 业务层负责。
- */
-interface WpsAppLauncherOptions {
-    /**
-     * 完整的 Deeplink URL，格式必须为 scheme + "://" + "xxx"（xxx 可选）。
-     * 例如：server:// 或 server://link?source=wps。
-     * 强制要求：`://` 必须存在，调用方传入什么就使用什么，不做二次加工。
-     */
-    appUrl: string;
-    /**
-     * electron 不可用时使用的 fallback 方式。默认 linkClick（模拟链接点击，多数 WebView 允许）。
-     * 可切换为 locationHref、iframe、windowOpen 用于测试。
-     */
-    fallbackMethod?: FallbackMethod;
-    /**
-     * 为 true 时依次执行 linkClick、locationHref、iframe、window.open（间隔 300ms），用于调试。
-     * 会多次触发 scheme，仅用于验证哪种方式在 WPS WebView 中有效。
-     */
-    tryAllMethods?: boolean;
-}
-declare global {
-    interface Window {
-        electron?: {
-            shell?: {
-                openExternal: (url: string) => void;
-            };
-        };
-    }
-}
-/**
- * WPS 加载项专属的 AppLauncher 实现。
- */
-declare class WpsAppLauncher implements AppLauncher {
-    private readonly appUrl;
-    private readonly fallbackMethod;
-    private readonly tryAllMethods;
-    constructor(options: WpsAppLauncherOptions);
-    launchApp(): Promise<AppLaunchResult>;
-    private triggerByLinkClick;
-    private triggerByLocationHref;
-    private triggerByIframe;
-    private triggerByWindowOpen;
-    private runFallback;
-}
-
-export { type FallbackMethod, WpsAppLauncher, type WpsAppLauncherOptions };