moonbridge-ts 0.1.0

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

@@ -0,0 +1,44 @@
+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_message_channel.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 基于 WebSocket 的 SerialMessageChannel 实现，对应 Flutter lib/general/transport/websocket/websocket_message_channel.dart。
+ * 复用 data_frame_codec 帧格式，以二进制帧收发，与 Flutter 端协议一致。
+ */
+import { SerialMessageChannel, SerialMessageChannelSubscribeOptions } from '../interface/serial_message_channel';
+/** 可选日志接口（与 Flutter Logger 简化对应） */
+export interface ChannelLogger {
+    log(level: string, message: string, meta?: {
+        file?: string;
+        func?: string;
+    }): void;
+}
+export interface WebSocketMessageChannelOptions {
+    address: string;
+    port: number;
+    remoteAddress: string;
+    remotePort: number;
+    logger?: ChannelLogger;
+}
+/**
+ * WebSocket 消息通道
+ */
+export 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;
+}
+//# sourceMappingURL=websocket_message_channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket_message_channel.d.ts","sourceRoot":"","sources":["../../../../../src/moonbridge-ipc/general/transport/websocket/websocket_message_channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAKjH,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IAClE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAGvC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,8BAA8B;IAUzC,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,aAAa,IAAI,MAAM,CAE1B;IACD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,IAAI;IAIf,SAAS,CACP,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,EAChD,OAAO,CAAC,EAAE,oCAAoC,GAC7C,MAAM,IAAI;CAyDd"}

package/dist/moonbridge-ipc/general/transport/websocket/websocket_message_channel.js

@@ -0,0 +1,109 @@
+'use strict';
+
+var data_frame_codec = require('../encode/data_frame_codec');
+var async_lock = require('../../lock/async_lock');
+
+const FRAME_HEADER = 126;
+class WebSocketMessageChannel {
+  constructor(ws, options) {
+    this._lock = new async_lock.AsyncLock();
+    this._ws = ws;
+    this._address = options.address;
+    this._port = options.port;
+    this._remoteAddress = options.remoteAddress;
+    this._remotePort = options.remotePort;
+    this._logger = options.logger;
+  }
+  get address() {
+    return this._address;
+  }
+  get port() {
+    return this._port;
+  }
+  get remoteAddress() {
+    return this._remoteAddress;
+  }
+  get remotePort() {
+    return this._remotePort;
+  }
+  async sendMessage(message) {
+    var _a, _b, _c;
+    await this._lock.lock();
+    try {
+      (_a = this._logger) == null ? void 0 : _a.log("info", `[Send] \u51C6\u5907\u53D1\u9001\u6D88\u606F: ${message}`, { file: "websocket_message_channel" });
+      this._ws.send(data_frame_codec.encodeDataFrame(message));
+      (_b = this._logger) == null ? void 0 : _b.log("info", "[Send] \u53D1\u9001\u6210\u529F", { file: "websocket_message_channel" });
+      return true;
+    } catch (e) {
+      (_c = this._logger) == null ? void 0 : _c.log("error", `[Send] \u53D1\u9001\u5931\u8D25: ${e}`, { file: "websocket_message_channel" });
+      return false;
+    } finally {
+      this._lock.unlock();
+    }
+  }
+  async close() {
+    this._ws.close();
+  }
+  destroy() {
+    this._ws.close();
+  }
+  subscribe(onMessage, options) {
+    const buffer = [];
+    const onError = options == null ? void 0 : options.onError;
+    const onDone = options == null ? void 0 : options.onDone;
+    const onMessageHandler = (ev) => {
+      var _a, _b, _c;
+      const data = ev.data;
+      (_b = this._logger) == null ? void 0 : _b.log("debug", `[WebSocketMessageChannel] \u6536\u5230\u6D88\u606F dataType=${typeof data} isBuffer=${typeof Buffer !== "undefined" && ((_a = Buffer.isBuffer) == null ? void 0 : _a.call(Buffer, data))}`, {
+        file: "websocket_message_channel",
+        func: "onMessageHandler"
+      });
+      if (typeof data === "string") {
+        buffer.push(...Array.from(new TextEncoder().encode(data)));
+      } else if (data instanceof ArrayBuffer) {
+        buffer.push(...new Uint8Array(data));
+      } else if (data instanceof Uint8Array || typeof Buffer !== "undefined" && Buffer.isBuffer(data)) {
+        buffer.push(...new Uint8Array(data));
+      }
+      while (buffer.length >= 9) {
+        try {
+          const result = data_frame_codec.decodeDataFrame(buffer);
+          if (result.message != null) {
+            onMessage == null ? void 0 : onMessage(result.message);
+            buffer.length = 0;
+            buffer.push(...result.remainingBuffer);
+          } else {
+            break;
+          }
+        } catch (e) {
+          (_c = this._logger) == null ? void 0 : _c.log("fatal", `\u89E3\u7801\u6570\u636E\u5E27\u9519\u8BEF: ${e}`, {
+            file: "websocket_message_channel",
+            func: "subscribe"
+          });
+          const nextFrameStart = buffer.indexOf(FRAME_HEADER, 1);
+          if (nextFrameStart === -1) {
+            buffer.length = 0;
+          } else {
+            buffer.splice(0, nextFrameStart);
+          }
+        }
+      }
+    };
+    this._ws.addEventListener("message", onMessageHandler);
+    this._ws.addEventListener("error", (ev) => {
+      buffer.length = 0;
+      onError == null ? void 0 : onError(ev);
+    });
+    this._ws.addEventListener("close", () => {
+      buffer.length = 0;
+      onDone == null ? void 0 : onDone();
+    });
+    return () => {
+      this._ws.removeEventListener("message", onMessageHandler);
+    };
+  }
+}
+
+exports.WebSocketMessageChannel = WebSocketMessageChannel;
+//# sourceMappingURL=websocket_message_channel.js.map
+//# sourceMappingURL=websocket_message_channel.js.map

package/dist/moonbridge-ipc/general/transport/websocket/websocket_message_channel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/general/transport/websocket/websocket_message_channel.ts"],"names":["AsyncLock","encodeDataFrame","decodeDataFrame"],"mappings":"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","file":"websocket_message_channel.js","sourcesContent":["/**\n * 基于 WebSocket 的 SerialMessageChannel 实现，对应 Flutter lib/general/transport/websocket/websocket_message_channel.dart。\n * 复用 data_frame_codec 帧格式，以二进制帧收发，与 Flutter 端协议一致。\n */\n\nimport { encodeDataFrame, decodeDataFrame } from '../encode/data_frame_codec';\nimport { SerialMessageChannel, SerialMessageChannelSubscribeOptions } from '../interface/serial_message_channel';\nimport { AsyncLock } from '../../lock/async_lock';\n\nconst FRAME_HEADER = 0x7e;\n\n/** 可选日志接口（与 Flutter Logger 简化对应） */\nexport interface ChannelLogger {\n  log(level: string, message: string, meta?: { file?: string; func?: string }): void;\n}\n\nexport interface WebSocketMessageChannelOptions {\n  address: string;\n  port: number;\n  remoteAddress: string;\n  remotePort: number;\n  logger?: ChannelLogger;\n}\n\n/**\n * WebSocket 消息通道\n */\nexport class WebSocketMessageChannel implements SerialMessageChannel {\n  private readonly _ws: WebSocket;\n  private readonly _address: string;\n  private readonly _port: number;\n  private readonly _remoteAddress: string;\n  private readonly _remotePort: number;\n  private readonly _logger: ChannelLogger | undefined;\n  private readonly _lock = new AsyncLock();\n\n  constructor(\n    ws: WebSocket,\n    options: WebSocketMessageChannelOptions,\n  ) {\n    this._ws = ws;\n    this._address = options.address;\n    this._port = options.port;\n    this._remoteAddress = options.remoteAddress;\n    this._remotePort = options.remotePort;\n    this._logger = options.logger;\n  }\n\n  get address(): string {\n    return this._address;\n  }\n  get port(): number {\n    return this._port;\n  }\n  get remoteAddress(): string {\n    return this._remoteAddress;\n  }\n  get remotePort(): number {\n    return this._remotePort;\n  }\n\n  async sendMessage(message: string): Promise<boolean> {\n    await this._lock.lock();\n    try {\n      this._logger?.log('info', `[Send] 准备发送消息: ${message}`, { file: 'websocket_message_channel' });\n      this._ws.send(encodeDataFrame(message));\n      this._logger?.log('info', '[Send] 发送成功', { file: 'websocket_message_channel' });\n      return true;\n    } catch (e) {\n      this._logger?.log('error', `[Send] 发送失败: ${e}`, { file: 'websocket_message_channel' });\n      return false;\n    } finally {\n      this._lock.unlock();\n    }\n  }\n\n  async close(): Promise<void> {\n    this._ws.close();\n  }\n\n  destroy(): void {\n    this._ws.close();\n  }\n\n  subscribe(\n    onMessage: ((value: string) => void) | undefined,\n    options?: SerialMessageChannelSubscribeOptions,\n  ): () => void {\n    const buffer: number[] = [];\n    const onError = options?.onError;\n    const onDone = options?.onDone;\n\n    const onMessageHandler = (ev: MessageEvent): void => {\n      const data = ev.data;\n      this._logger?.log('debug', `[WebSocketMessageChannel] 收到消息 dataType=${typeof data} isBuffer=${typeof Buffer !== 'undefined' && Buffer.isBuffer?.(data)}`, {\n        file: 'websocket_message_channel',\n        func: 'onMessageHandler',\n      });\n      if (typeof data === 'string') {\n        buffer.push(...Array.from(new TextEncoder().encode(data)));\n      } else if (data instanceof ArrayBuffer) {\n        buffer.push(...new Uint8Array(data));\n      } else if (data instanceof Uint8Array || (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))) {\n        buffer.push(...new Uint8Array(data as ArrayBuffer | ArrayLike<number>));\n      }\n      while (buffer.length >= 9) {\n        try {\n          const result = decodeDataFrame(buffer);\n          if (result.message != null) {\n            onMessage?.(result.message);\n            buffer.length = 0;\n            buffer.push(...result.remainingBuffer);\n          } else {\n            break;\n          }\n        } catch (e) {\n          this._logger?.log('fatal', `解码数据帧错误: ${e}`, {\n            file: 'websocket_message_channel',\n            func: 'subscribe',\n          });\n          const nextFrameStart = buffer.indexOf(FRAME_HEADER, 1);\n          if (nextFrameStart === -1) {\n            buffer.length = 0;\n          } else {\n            buffer.splice(0, nextFrameStart);\n          }\n        }\n      }\n    };\n\n    this._ws.addEventListener('message', onMessageHandler);\n    this._ws.addEventListener('error', (ev) => {\n      buffer.length = 0;\n      onError?.(ev);\n    });\n    this._ws.addEventListener('close', () => {\n      buffer.length = 0;\n      onDone?.();\n    });\n\n    return () => {\n      this._ws.removeEventListener('message', onMessageHandler);\n    };\n  }\n}\n"]}

package/dist/moonbridge-ipc/general/transport/websocket/websocket_message_channel.mjs

@@ -0,0 +1,107 @@
+import { encodeDataFrame, decodeDataFrame } from '../encode/data_frame_codec';
+import { AsyncLock } from '../../lock/async_lock';
+
+const FRAME_HEADER = 126;
+class WebSocketMessageChannel {
+  constructor(ws, options) {
+    this._lock = new AsyncLock();
+    this._ws = ws;
+    this._address = options.address;
+    this._port = options.port;
+    this._remoteAddress = options.remoteAddress;
+    this._remotePort = options.remotePort;
+    this._logger = options.logger;
+  }
+  get address() {
+    return this._address;
+  }
+  get port() {
+    return this._port;
+  }
+  get remoteAddress() {
+    return this._remoteAddress;
+  }
+  get remotePort() {
+    return this._remotePort;
+  }
+  async sendMessage(message) {
+    var _a, _b, _c;
+    await this._lock.lock();
+    try {
+      (_a = this._logger) == null ? void 0 : _a.log("info", `[Send] \u51C6\u5907\u53D1\u9001\u6D88\u606F: ${message}`, { file: "websocket_message_channel" });
+      this._ws.send(encodeDataFrame(message));
+      (_b = this._logger) == null ? void 0 : _b.log("info", "[Send] \u53D1\u9001\u6210\u529F", { file: "websocket_message_channel" });
+      return true;
+    } catch (e) {
+      (_c = this._logger) == null ? void 0 : _c.log("error", `[Send] \u53D1\u9001\u5931\u8D25: ${e}`, { file: "websocket_message_channel" });
+      return false;
+    } finally {
+      this._lock.unlock();
+    }
+  }
+  async close() {
+    this._ws.close();
+  }
+  destroy() {
+    this._ws.close();
+  }
+  subscribe(onMessage, options) {
+    const buffer = [];
+    const onError = options == null ? void 0 : options.onError;
+    const onDone = options == null ? void 0 : options.onDone;
+    const onMessageHandler = (ev) => {
+      var _a, _b, _c;
+      const data = ev.data;
+      (_b = this._logger) == null ? void 0 : _b.log("debug", `[WebSocketMessageChannel] \u6536\u5230\u6D88\u606F dataType=${typeof data} isBuffer=${typeof Buffer !== "undefined" && ((_a = Buffer.isBuffer) == null ? void 0 : _a.call(Buffer, data))}`, {
+        file: "websocket_message_channel",
+        func: "onMessageHandler"
+      });
+      if (typeof data === "string") {
+        buffer.push(...Array.from(new TextEncoder().encode(data)));
+      } else if (data instanceof ArrayBuffer) {
+        buffer.push(...new Uint8Array(data));
+      } else if (data instanceof Uint8Array || typeof Buffer !== "undefined" && Buffer.isBuffer(data)) {
+        buffer.push(...new Uint8Array(data));
+      }
+      while (buffer.length >= 9) {
+        try {
+          const result = decodeDataFrame(buffer);
+          if (result.message != null) {
+            onMessage == null ? void 0 : onMessage(result.message);
+            buffer.length = 0;
+            buffer.push(...result.remainingBuffer);
+          } else {
+            break;
+          }
+        } catch (e) {
+          (_c = this._logger) == null ? void 0 : _c.log("fatal", `\u89E3\u7801\u6570\u636E\u5E27\u9519\u8BEF: ${e}`, {
+            file: "websocket_message_channel",
+            func: "subscribe"
+          });
+          const nextFrameStart = buffer.indexOf(FRAME_HEADER, 1);
+          if (nextFrameStart === -1) {
+            buffer.length = 0;
+          } else {
+            buffer.splice(0, nextFrameStart);
+          }
+        }
+      }
+    };
+    this._ws.addEventListener("message", onMessageHandler);
+    this._ws.addEventListener("error", (ev) => {
+      buffer.length = 0;
+      onError == null ? void 0 : onError(ev);
+    });
+    this._ws.addEventListener("close", () => {
+      buffer.length = 0;
+      onDone == null ? void 0 : onDone();
+    });
+    return () => {
+      this._ws.removeEventListener("message", onMessageHandler);
+    };
+  }
+}
+
+export { WebSocketMessageChannel };
+//# sourceMappingURL=websocket_message_channel.mjs.map
+//# sourceMappingURL=websocket_message_channel.mjs.map

package/dist/moonbridge-ipc/general/transport/websocket/websocket_message_channel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/moonbridge-ipc/general/transport/websocket/websocket_message_channel.ts"],"names":[],"mappings":"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","file":"websocket_message_channel.mjs","sourcesContent":["/**\n * 基于 WebSocket 的 SerialMessageChannel 实现，对应 Flutter lib/general/transport/websocket/websocket_message_channel.dart。\n * 复用 data_frame_codec 帧格式，以二进制帧收发，与 Flutter 端协议一致。\n */\n\nimport { encodeDataFrame, decodeDataFrame } from '../encode/data_frame_codec';\nimport { SerialMessageChannel, SerialMessageChannelSubscribeOptions } from '../interface/serial_message_channel';\nimport { AsyncLock } from '../../lock/async_lock';\n\nconst FRAME_HEADER = 0x7e;\n\n/** 可选日志接口（与 Flutter Logger 简化对应） */\nexport interface ChannelLogger {\n  log(level: string, message: string, meta?: { file?: string; func?: string }): void;\n}\n\nexport interface WebSocketMessageChannelOptions {\n  address: string;\n  port: number;\n  remoteAddress: string;\n  remotePort: number;\n  logger?: ChannelLogger;\n}\n\n/**\n * WebSocket 消息通道\n */\nexport class WebSocketMessageChannel implements SerialMessageChannel {\n  private readonly _ws: WebSocket;\n  private readonly _address: string;\n  private readonly _port: number;\n  private readonly _remoteAddress: string;\n  private readonly _remotePort: number;\n  private readonly _logger: ChannelLogger | undefined;\n  private readonly _lock = new AsyncLock();\n\n  constructor(\n    ws: WebSocket,\n    options: WebSocketMessageChannelOptions,\n  ) {\n    this._ws = ws;\n    this._address = options.address;\n    this._port = options.port;\n    this._remoteAddress = options.remoteAddress;\n    this._remotePort = options.remotePort;\n    this._logger = options.logger;\n  }\n\n  get address(): string {\n    return this._address;\n  }\n  get port(): number {\n    return this._port;\n  }\n  get remoteAddress(): string {\n    return this._remoteAddress;\n  }\n  get remotePort(): number {\n    return this._remotePort;\n  }\n\n  async sendMessage(message: string): Promise<boolean> {\n    await this._lock.lock();\n    try {\n      this._logger?.log('info', `[Send] 准备发送消息: ${message}`, { file: 'websocket_message_channel' });\n      this._ws.send(encodeDataFrame(message));\n      this._logger?.log('info', '[Send] 发送成功', { file: 'websocket_message_channel' });\n      return true;\n    } catch (e) {\n      this._logger?.log('error', `[Send] 发送失败: ${e}`, { file: 'websocket_message_channel' });\n      return false;\n    } finally {\n      this._lock.unlock();\n    }\n  }\n\n  async close(): Promise<void> {\n    this._ws.close();\n  }\n\n  destroy(): void {\n    this._ws.close();\n  }\n\n  subscribe(\n    onMessage: ((value: string) => void) | undefined,\n    options?: SerialMessageChannelSubscribeOptions,\n  ): () => void {\n    const buffer: number[] = [];\n    const onError = options?.onError;\n    const onDone = options?.onDone;\n\n    const onMessageHandler = (ev: MessageEvent): void => {\n      const data = ev.data;\n      this._logger?.log('debug', `[WebSocketMessageChannel] 收到消息 dataType=${typeof data} isBuffer=${typeof Buffer !== 'undefined' && Buffer.isBuffer?.(data)}`, {\n        file: 'websocket_message_channel',\n        func: 'onMessageHandler',\n      });\n      if (typeof data === 'string') {\n        buffer.push(...Array.from(new TextEncoder().encode(data)));\n      } else if (data instanceof ArrayBuffer) {\n        buffer.push(...new Uint8Array(data));\n      } else if (data instanceof Uint8Array || (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))) {\n        buffer.push(...new Uint8Array(data as ArrayBuffer | ArrayLike<number>));\n      }\n      while (buffer.length >= 9) {\n        try {\n          const result = decodeDataFrame(buffer);\n          if (result.message != null) {\n            onMessage?.(result.message);\n            buffer.length = 0;\n            buffer.push(...result.remainingBuffer);\n          } else {\n            break;\n          }\n        } catch (e) {\n          this._logger?.log('fatal', `解码数据帧错误: ${e}`, {\n            file: 'websocket_message_channel',\n            func: 'subscribe',\n          });\n          const nextFrameStart = buffer.indexOf(FRAME_HEADER, 1);\n          if (nextFrameStart === -1) {\n            buffer.length = 0;\n          } else {\n            buffer.splice(0, nextFrameStart);\n          }\n        }\n      }\n    };\n\n    this._ws.addEventListener('message', onMessageHandler);\n    this._ws.addEventListener('error', (ev) => {\n      buffer.length = 0;\n      onError?.(ev);\n    });\n    this._ws.addEventListener('close', () => {\n      buffer.length = 0;\n      onDone?.();\n    });\n\n    return () => {\n      this._ws.removeEventListener('message', onMessageHandler);\n    };\n  }\n}\n"]}

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

@@ -0,0 +1,71 @@
+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/general/transport/websocket/websocket_server.d.ts

@@ -0,0 +1,68 @@
+/**
+ * WebSocket 服务端，基于 HttpServer 升级为 WebSocket。
+ *
+ * 每收到一次 WebSocket 升级请求即生成一个 [SerialMessageChannel]（[WebSocketMessageChannel]），
+ * 通过 [onClientConnected] 交给上层，与 [SocketServer] 产出的 [SerialMessageSocket] 契约一致。
+ */
+import { SerialMessageChannel } from '../interface/serial_message_channel';
+/**
+ * 封装服务器的 IP 地址和端口号信息
+ *
+ * 该类用于存储和展示服务器的 IP 地址和端口号信息。
+ */
+export declare class ServerAddressInfo {
+    /** 服务器的 IP 地址 */
+    readonly ip: string;
+    /** 服务器的端口号 */
+    readonly port: number;
+    constructor(ip: string, port: number);
+    toString(): string;
+}
+/**
+ * SocketServer 类用于处理服务器端的 TCP 通信。
+ *
+ * 它可以启动服务器并监听来自客户端的连接。
+ */
+export declare abstract class SocketServer {
+    static readonly anyIPv4 = "anyIPv4";
+    static readonly anyIPv6 = "anyIPv6";
+}
+/**
+ * WebSocket 服务端，基于 HttpServer 升级为 WebSocket。
+ * 仅支持 Node 环境，使用 ws + Node http。
+ */
+export 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;
+}
+//# sourceMappingURL=websocket_server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket_server.d.ts","sourceRoot":"","sources":["../../../../../src/moonbridge-ipc/general/transport/websocket/websocket_server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAK3E;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,iBAAiB;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKpC,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;GAIG;AACH,8BAAsB,YAAY;IAEhC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IAGpC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;CACrC;AAgBD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,WAAW,CAAC,CAAwB;IAC5C,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAc;IAEtC;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAMtE;;;;OAIG;IACG,WAAW,CACf,iBAAiB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,GACzD,OAAO,CAAC,OAAO,CAAC;IAiFnB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,aAAa;IACb,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,oBAAoB;IACpB,IAAI,iBAAiB,IAAI,iBAAiB,GAAG,SAAS,CAQrD;CACF"}

package/dist/moonbridge-ipc/general/transport/websocket/websocket_server.js

@@ -0,0 +1,155 @@
+'use strict';
+
+var websocket_message_channel = require('./websocket_message_channel');
+var env = require('../../../utils/env');
+var logger = require('../../../utils/logger');
+
+class ServerAddressInfo {
+  constructor(ip, port) {
+    this.ip = ip;
+    this.port = port;
+  }
+  toString() {
+    return `IP: ${this.ip}, Port: ${this.port}`;
+  }
+}
+class SocketServer {
+}
+/// 表示绑定到所有 IPv4 地址的常量
+SocketServer.anyIPv4 = "anyIPv4";
+/// 表示绑定到所有 IPv6 地址的常量
+SocketServer.anyIPv6 = "anyIPv6";
+function resolveAddress(address) {
+  if (address === SocketServer.anyIPv4) return "0.0.0.0";
+  if (address === SocketServer.anyIPv6) return "::";
+  return address;
+}
+function isPathMatch(requestPath, expectedPath) {
+  const pathname = requestPath.split("?")[0];
+  return pathname === expectedPath || pathname === `${expectedPath}/`;
+}
+class WebSocketServer {
+  /**
+   * 构造 WebSocket 服务端。
+   * @param address 绑定地址
+   * @param port 监听端口
+   * @param options.path 升级路径，默认 `'/'`
+   */
+  constructor(address, port, options) {
+    this._isServerRunning = false;
+    this._resolvedAddress = "";
+    var _a;
+    this.address = address;
+    this.port = port;
+    this.path = (_a = options == null ? void 0 : options.path) != null ? _a : "/";
+  }
+  /**
+   * 启动 HTTP 服务并处理 WebSocket 升级；每建立一个 WebSocket 连接即调用 [onClientConnected]。
+   * @param onClientConnected 客户端连接回调
+   * @returns true 表示启动成功，false 表示失败
+   */
+  async startServer(onClientConnected) {
+    if (!env.isNodeEnv()) {
+      logger.logger.fatal("WebSocketServer \u4EC5\u652F\u6301 Node \u73AF\u5883");
+      return false;
+    }
+    try {
+      const http = await import('http');
+      const ws = await import('ws');
+      this._resolvedAddress = resolveAddress(this.address);
+      const server = http.createServer();
+      const wss = new ws.WebSocketServer({ noServer: true });
+      wss.on("connection", (wsSocket, request) => {
+        var _a, _b;
+        const socket = request.socket;
+        const localAddress = this._resolvedAddress;
+        const localPort = this.port;
+        const remoteAddress = (_a = socket.remoteAddress) != null ? _a : "127.0.0.1";
+        const remotePort = (_b = socket.remotePort) != null ? _b : 0;
+        const channel = new websocket_message_channel.WebSocketMessageChannel(wsSocket, {
+          address: localAddress,
+          port: localPort,
+          remoteAddress,
+          remotePort,
+          logger: logger.logger
+        });
+        onClientConnected(channel);
+      });
+      server.on("upgrade", (request, socket, head) => {
+        var _a, _b, _c;
+        const pathname = (_b = (_a = request.url) == null ? void 0 : _a.split("?")[0]) != null ? _b : "/";
+        if (!isPathMatch(pathname, this.path)) {
+          socket.write("HTTP/1.1 404 Not Found\r\n\r\n");
+          socket.destroy();
+          return;
+        }
+        const upgradeHeader = (_c = request.headers.upgrade) == null ? void 0 : _c.toLowerCase();
+        if (upgradeHeader !== "websocket") {
+          socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+          socket.destroy();
+          return;
+        }
+        wss.handleUpgrade(request, socket, head, (wsSocket) => {
+          wss.emit("connection", wsSocket, request);
+        });
+      });
+      server.on("request", (request, response) => {
+        var _a, _b;
+        const pathname = (_b = (_a = request.url) == null ? void 0 : _a.split("?")[0]) != null ? _b : "/";
+        if (!isPathMatch(pathname, this.path)) {
+          response.writeHead(404);
+          response.end();
+          return;
+        }
+        response.writeHead(400);
+        response.end();
+      });
+      await new Promise((resolve, reject) => {
+        server.listen(this.port, this._resolvedAddress, () => resolve());
+        server.on("error", reject);
+      });
+      this._httpServer = server;
+      this._isServerRunning = true;
+      const addr = this._httpServer.address();
+      const host = typeof addr === "object" && addr ? addr.address : this._resolvedAddress;
+      const port = typeof addr === "object" && addr ? addr.port : this.port;
+      logger.logger.info(`\u670D\u52A1\u7AEF websocket \u542F\u52A8: ${host}:${port}`);
+      return true;
+    } catch (e) {
+      logger.logger.fatal(`\u670D\u52A1\u7AEF websocket \u542F\u52A8\u5F02\u5E38: ${e}`);
+      return false;
+    }
+  }
+  /**
+   * 关闭 HTTP 服务并停止接受新连接
+   */
+  async close() {
+    if (this._httpServer) {
+      await new Promise((resolve) => {
+        this._httpServer.close(() => resolve());
+      });
+      this._httpServer = void 0;
+    }
+    this._isServerRunning = false;
+  }
+  /** 是否正在运行 */
+  get isServerRunning() {
+    return this._isServerRunning;
+  }
+  /** 本机地址与端口（若已启动） */
+  get serverAddressInfo() {
+    if (this._httpServer) {
+      const addr = this._httpServer.address();
+      if (addr && typeof addr === "object") {
+        return new ServerAddressInfo(addr.address, addr.port);
+      }
+    }
+    return void 0;
+  }
+}
+
+exports.ServerAddressInfo = ServerAddressInfo;
+exports.SocketServer = SocketServer;
+exports.WebSocketServer = WebSocketServer;
+//# sourceMappingURL=websocket_server.js.map
+//# sourceMappingURL=websocket_server.js.map