moonbridge-ts 0.1.0

package/src/moonbridge-ipc/general/app_launch/platform_app_launcher.ts

@@ -0,0 +1,89 @@
+/**
+ * 平台应用启动器接口与工厂，与 Flutter PlatformAppLauncher 行为对齐。
+ * 与 contracts/app_launch_api.md 一致。
+ * 平台分派：浏览器且存在 iOSScheme → BrowserPlatformAppLauncher；
+ * Node (win32/darwin) 且存在当前平台安装路径 → NodePlatformAppLauncher；否则 → StubPlatformAppLauncher。
+ */
+
+import { AppInstallationPath } from './model/app_info.js';
+import { AppLaunchArguments, AppLaunchResult } from './model/app_launch_models.js';
+import { AppLaunchIdentifier } from './model/app_info.js';
+import {
+  BrowserPlatformAppLauncher,
+  NodePlatformAppLauncher,
+  StubPlatformAppLauncher,
+} from './internal/real_platform_app_launcher.js';
+
+/** launchApp 可选参数，与 Flutter 语义一致 */
+export interface LaunchAppOptions {
+  /** 应用启动标识对应的启动参数 */
+  argumentsForIdentifier?: AppLaunchArguments;
+  /** 应用安装路径对应的启动参数 */
+  argumentsForInstallationPath?: AppLaunchArguments;
+  /** 状态检查间隔（秒），默认 0.3 */
+  statusCheckInterval?: number;
+  /** 操作超时（秒），默认 3.0 */
+  operationTimeout?: number;
+}
+
+/**
+ * 平台应用启动器：按标识符或安装路径启动应用，并支持进程/运行状态检测。
+ */
+export interface PlatformAppLauncher {
+  launchApp(options?: LaunchAppOptions): Promise<AppLaunchResult>;
+  isAppRunning(): Promise<boolean>;
+}
+
+/** 
+ * 是否为浏览器环境 
+ */
+const isBrowser =
+  typeof window !== 'undefined' && typeof window.document !== 'undefined';
+
+/** 
+ * Node 官方 Platform 集合（@types/node process.d.ts），用于区分 Node 与浏览器等环境 
+ */
+const NODE_PLATFORMS: readonly NodeJS.Platform[] = [
+  'aix', 'android', 'darwin', 'freebsd', 'haiku', 'linux',
+  'openbsd', 'sunos', 'win32', 'cygwin', 'netbsd',
+];
+
+/** 
+ * 是否为 Node 环境 
+ */
+const isNode =
+  typeof process !== 'undefined' &&
+  typeof process.platform === 'string' &&
+  NODE_PLATFORMS.includes(process.platform as NodeJS.Platform);
+
+/**
+ * 平台启动器工厂（013：一级函数收敛为类静态方法）。
+ * 根据当前运行环境返回平台启动器实例。
+ */
+export class PlatformAppLauncherFactory {
+  /**
+   * 根据当前运行环境返回平台启动器实例。
+   * 浏览器且 appIdentifier 含 iOSScheme 时返回 BrowserPlatformAppLauncher；
+   * Node 且 (win32/darwin) 且 appInstallationPath 含当前平台路径时返回 NodePlatformAppLauncher；
+   * 否则返回 Stub。
+   */
+  static create({
+    appIdentifier,
+    appInstallationPath,
+  }: {
+    appIdentifier?: AppLaunchIdentifier;
+    appInstallationPath?: AppInstallationPath;
+  }): PlatformAppLauncher {
+    if (!appIdentifier && !appInstallationPath) {
+      throw new Error('appIdentifier 或 appInstallationPath 不能为空');
+    }
+
+    if (isBrowser) {
+      return new BrowserPlatformAppLauncher(appIdentifier ?? new AppLaunchIdentifier({}));
+    } else if (isNode) {
+      return new NodePlatformAppLauncher(appInstallationPath ?? new AppInstallationPath({}));
+    } else {
+      return new StubPlatformAppLauncher();
+    }
+  }
+}

package/src/moonbridge-ipc/general/config/port_candidate_rule.ts

@@ -0,0 +1,81 @@
+/**
+ * 端口候选规则，对应 Flutter lib/general/config/port_candidate_rule.dart。
+ * 生成确定性有序端口列表，服务端按序 try-bind，客户端按序 try-connect。
+ */
+
+export const maxAttemptsCap = 128;
+
+/**
+ * 端口候选规则
+ */
+export class PortCandidateRule {
+  private readonly _preferredPort: number;
+  private readonly _step: number;
+  private readonly _maxAttempts: number;
+  private readonly _ports: number[] | undefined;
+
+  private constructor(
+    preferredPort: number,
+    step: number,
+    maxAttempts: number,
+    ports: number[] | undefined,
+  ) {
+    this._preferredPort = preferredPort;
+    this._step = step;
+    this._maxAttempts = maxAttempts;
+    this._ports = ports;
+  }
+
+  /** 
+   * 策略一：首选端口 + 步长。生成 [preferredPort, preferredPort+step, ...]，长度不超过 maxAttempts。
+   * @param preferredPort 首选端口
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static preferred(
+    preferredPort: number,
+    options: { step?: number; maxAttempts?: number } = {},
+  ): PortCandidateRule {
+    const step = options.step ?? 1;
+    const maxAttempts = options.maxAttempts ?? 32;
+    if (preferredPort < 1 || preferredPort > 65535) throw new Error('preferredPort must be in 1..65535');
+    if (step < 1) throw new Error('step must be >= 1');
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(preferredPort, step, maxAttempts, undefined);
+  }
+
+  /** 
+   * 策略二：显式端口列表。按 ports 顺序使用，截断至 maxAttempts 并过滤非法端口。
+   * @param ports 端口列表
+   * @param options 选项
+   * @returns 端口候选规则
+   */
+  static explicit(ports: number[], options: { maxAttempts?: number } = {}): PortCandidateRule {
+    const maxAttempts = options.maxAttempts ?? 32;
+    if (ports.length === 0) throw new Error('ports must not be empty');
+    if (maxAttempts < 1 || maxAttempts > maxAttemptsCap) throw new Error(`maxAttempts must be in 1..${maxAttemptsCap}`);
+    return new PortCandidateRule(0, 1, maxAttempts, [...ports]);
+  }
+
+  /** 
+   * 生成有序端口列表，每项 1..65535，长度不超过 maxAttempts。
+   * @returns 有序端口列表
+   */
+  toOrderedPortList(): number[] {
+    if (this._ports != null && this._ports.length > 0) {
+      const list: number[] = [];
+      for (const p of this._ports) {
+        if (list.length >= this._maxAttempts) break;
+        if (p >= 1 && p <= 65535) list.push(p);
+      }
+      return list;
+    }
+    const list: number[] = [];
+    for (let i = 0; i < this._maxAttempts; i++) {
+      const p = this._preferredPort + i * this._step;
+      if (p > 65535) break;
+      if (p >= 1) list.push(p);
+    }
+    return list;
+  }
+}

package/src/moonbridge-ipc/general/config/websocket_server_endpoint.ts

@@ -0,0 +1,48 @@
+/**
+ * WebSocket 服务端端点配置，对应 Flutter lib/general/config/websocket_server_endpoint.dart WebSocketServerEndpoint。
+ */
+
+import { PortCandidateRule } from './port_candidate_rule';
+
+/**
+ * WebSocket 服务端端点配置
+ */
+export class WebSocketServerEndpoint {
+  readonly address: string;
+  readonly port: number;
+  readonly path: string;
+  readonly useTls: boolean;
+  readonly portCandidateRule?: PortCandidateRule;
+
+  /**
+   * 构造函数
+   * @param address 地址
+   * @param port 端口
+   * @param path 路径
+   * @param useTls 是否使用 TLS
+   * @param portCandidateRule 端口候选规则
+   */
+  constructor({
+    address,
+    port,
+    path,
+    useTls,
+    portCandidateRule,
+  }: {
+    address: string;
+    port: number;
+    path: string;
+    useTls: boolean;
+    portCandidateRule?: PortCandidateRule;
+  }) {
+    if (!address || address.length === 0) throw new Error('address must not be empty');
+    if (port < 1 || port > 65535) throw new Error('port must be in 1..65535');
+    if (!path || path.length === 0) throw new Error('path must not be empty');
+
+    this.address = address;
+    this.port = port;
+    this.path = path;
+    this.useTls = useTls;
+    this.portCandidateRule = portCandidateRule;
+  }
+}

package/src/moonbridge-ipc/general/encode/ipc_message_decoder.ts

@@ -0,0 +1,122 @@
+/**
+ * IPC 消息解码器，与 Flutter lib/general/encode/ipc_message_decoder.dart IpcMessageDecoder 一致。
+ * 所有解码方法为类静态方法。
+ */
+
+import { Event } from '../message/event';
+import { Ping } from '../message/ping';
+import { Handshake } from '../message/handshake';
+import { IpcSessionSetupRequest, IpcSessionSetupResponse } from '../message/session_setup';
+import { Error } from '../message/error';
+import { Registration } from '../message/registration';
+import { Request } from '../message/request';
+import { Response } from '../message/response';
+import { Unregistration } from '../message/unregistration';
+
+interface Envelope {
+  type: string;
+  data?: Record<string, unknown>;
+}
+
+function parseData(jsonString: string): Record<string, unknown> | undefined {
+  try {
+    const envelope = JSON.parse(jsonString) as Envelope;
+    return envelope.data != null && typeof envelope.data === 'object' ? (envelope.data as Record<string, unknown>) : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+export class IpcMessageDecoder {
+  static decodeEvent(jsonString: string): Event {
+    const json = parseData(jsonString) ?? {};
+    return new Event(
+      String(json.type ?? ''),
+      (json.source as string | undefined) ?? undefined,
+      json.data != null ? (json.data as Record<string, unknown>) : undefined
+    );
+  }
+
+  static decodeError(jsonString: string): Error {
+    const json = parseData(jsonString) ?? {};
+    return new Error(
+      String(json.requestId ?? ''),
+      String(json.fromClient ?? ''),
+      String(json.toClient ?? ''),
+      Number(json.code ?? 0),
+      json.message != null ? String(json.message) : undefined,
+      json.userInfo != null ? (json.userInfo as Record<string, unknown>) : undefined
+    );
+  }
+
+  static decodeRegistration(jsonString: string): Registration {
+    const json = parseData(jsonString) ?? {};
+    return new Registration(String(json.clientName ?? ''));
+  }
+
+  static decodeRequest(jsonString: string): Request {
+    const json = parseData(jsonString) ?? {};
+    return new Request(
+      String(json.requestId ?? ''),
+      String(json.fromClient ?? ''),
+      String(json.toClient ?? ''),
+      String(json.moduleName ?? ''),
+      String(json.methodName ?? ''),
+      (json.arguments != null ? Array.from(json.arguments as unknown[]) : [])
+    );
+  }
+
+  static decodeResponse(jsonString: string): Response {
+    const json = parseData(jsonString) ?? {};
+    return new Response(
+      String(json.requestId ?? ''),
+      String(json.fromClient ?? ''),
+      String(json.toClient ?? ''),
+      String(json.callbackId ?? ''),
+      json.response != null ? Array.from(json.response as unknown[]) : [],
+      json.finished !== false
+    );
+  }
+
+  static decodeUnregistration(jsonString: string): Unregistration {
+    const json = parseData(jsonString) ?? {};
+    return new Unregistration(String(json.clientName ?? ''));
+  }
+
+  static decodeSessionSetupRequest(jsonString: string): IpcSessionSetupRequest {
+    const json = parseData(jsonString) ?? {};
+    return new IpcSessionSetupRequest(
+      String(json.sourceClient ?? ''),
+      String(json.targetClient ?? ''),
+      String(json.callbackId ?? ''),
+      Boolean(json.autoLaunch)
+    );
+  }
+
+  static decodeSessionSetupResponse(jsonString: string): IpcSessionSetupResponse {
+    const json = parseData(jsonString) ?? {};
+    return new IpcSessionSetupResponse(
+      String(json.sourceClient ?? ''),
+      String(json.targetClient ?? ''),
+      String(json.callbackId ?? ''),
+      Number(json.result ?? 0),
+      json.message != null ? String(json.message) : undefined,
+      json.userInfo != null ? (json.userInfo as Record<string, unknown>) : undefined
+    );
+  }
+
+  static decodePing(jsonString: string): Ping {
+    const json = parseData(jsonString) ?? {};
+    return new Ping(String(json.fromClient ?? ''));
+  }
+
+  static decodeHandshake(jsonString: string): Handshake {
+    const json = parseData(jsonString) ?? {};
+    return new Handshake(
+      String(json.clientName ?? ''),
+      String(json.magic ?? ''),
+      String(json.role ?? ''),
+      String(json.version ?? '')
+    );
+  }
+}

package/src/moonbridge-ipc/general/encode/ipc_message_encoder.ts

@@ -0,0 +1,108 @@
+/**
+ * IPC 消息编码器，与 Flutter lib/general/encode/ipc_message_encoder.dart IpcMessageEncoder 一致。
+ * 所有编码方法为类静态方法。
+ */
+
+import { MessageType } from '../message/constants/message_types';
+import { Event } from '../message/event';
+import { Error } from '../message/error';
+import { Registration } from '../message/registration';
+import { Request } from '../message/request';
+import { Response } from '../message/response';
+import { Unregistration } from '../message/unregistration';
+import { IpcSessionSetupRequest, IpcSessionSetupResponse } from '../message/session_setup';
+import { Ping } from '../message/ping';
+import { Handshake } from '../message/handshake';
+
+function envelope<T>(type: string, data: T): string {
+  const e = { type: type, data };
+  return JSON.stringify(e);
+}
+
+export class IpcMessageEncoder {
+  static encodeEvent(event: Event): string {
+    return envelope(MessageType.EVENT, {
+      type: event.type,
+      source: event.source ?? undefined,
+      data: event.data ?? undefined,
+    });
+  }
+
+  static encodeError(error: Error): string {
+    return envelope(MessageType.ERROR, {
+      requestId: error.requestId,
+      fromClient: error.fromClient,
+      toClient: error.toClient,
+      code: error.code,
+      message: error.message ?? undefined,
+      userInfo: error.userInfo ?? undefined,
+    });
+  }
+
+  static encodeRegistration(registration: Registration): string {
+    return envelope(MessageType.REGISTRATION, {
+      clientName: registration.clientName,
+    });
+  }
+
+  static encodeRequest(request: Request): string {
+    return envelope(MessageType.REQUEST, {
+      requestId: request.requestId,
+      fromClient: request.fromClient,
+      toClient: request.toClient,
+      moduleName: request.moduleName,
+      methodName: request.methodName,
+      arguments: request.args,
+    });
+  }
+
+  static encodeResponse(response: Response): string {
+    return envelope(MessageType.RESPONSE, {
+      requestId: response.requestId,
+      fromClient: response.fromClient,
+      toClient: response.toClient,
+      callbackId: response.callbackId,
+      response: response.response,
+      finished: response.finished,
+    });
+  }
+
+  static encodeUnregistration(unregistration: Unregistration): string {
+    return envelope(MessageType.UNREGISTRATION, {
+      clientName: unregistration.clientName,
+    });
+  }
+
+  static encodeSessionSetupRequest(request: IpcSessionSetupRequest): string {
+    return envelope(MessageType.SESSION_SETUP_REQUEST, {
+      sourceClient: request.sourceClient,
+      targetClient: request.targetClient,
+      callbackId: request.callbackId,
+      autoLaunch: request.autoLaunch,
+    });
+  }
+
+  static encodeSessionSetupResponse(response: IpcSessionSetupResponse): string {
+    return envelope(MessageType.SESSION_SETUP_RESPONSE, {
+      sourceClient: response.sourceClient,
+      targetClient: response.targetClient,
+      callbackId: response.callbackId,
+      result: response.result,
+      message: response.message ?? undefined,
+      userInfo: response.userInfo ?? undefined,
+    });
+  }
+
+  static encodePing(ping: Ping): string {
+    return envelope(MessageType.PING, { fromClient: ping.fromClient });
+  }
+
+  static encodeHandshake(handshake: Handshake): string {
+    return envelope(MessageType.HANDSHAKE, {
+      clientName: handshake.clientName,
+      magic: handshake.magic,
+      role: handshake.role,
+      version: handshake.version,
+    });
+  }
+}

package/src/moonbridge-ipc/general/error/ipc_error.ts

@@ -0,0 +1,28 @@
+/**
+ * IPC 通信错误常量与类，对应 Flutter lib/general/error/ipc_error.dart IpcError。
+ */
+export class IpcError {
+  static readonly ERROR_UNKNOWN = -1;
+  static readonly ERROR_BIND_SERVER = -2;
+  static readonly ERROR_BIND_SERVER_EXCEPTION = -3;
+  static readonly ERROR_DISCONNECTED_WITH_SERVER = -4;
+  static readonly ERROR_IPC_SESSION_ABNORMAL = -5;
+  static readonly ERROR_SERVER_SOCKET_CLOSED = -6;
+  static readonly ERROR_POST_MESSAGE_EXCEPTION = -7;
+  static readonly ERROR_SEND_REQUEST_FAILED = -8;
+  static readonly ERROR_SEND_RESPONSE_FAILED = -9;
+  static readonly ERROR_SEND_ERROR_FAILED = -10;
+  static readonly ERROR_CLIENT_AUTH_FAILED = -11;
+  static readonly ERROR_WAKEUP_CLIENT_TIMEOUT = -12;
+  static readonly ERROR_CLIENT_UNAVAILABLE = -13;
+  static readonly ERROR_ARG_IS_NULL = -14;
+  static readonly ERROR_PARSE_MESSAGE_FAILED = 100;
+  static readonly ERROR_INVOKER_NOT_FOUND = -101;
+  static readonly ERROR_MODULE_CREATION_FAILED = -102;
+
+  constructor(
+    public readonly code: number,
+    public readonly message?: string,
+    public readonly userInfo?: Record<string, unknown>,
+  ) { }
+}

package/src/moonbridge-ipc/general/index.ts

@@ -0,0 +1,9 @@
+export * from './app_launch/model/app_info';
+export * from './app_launch/model/app_launch_models';
+export * from './app_launch/model/app_launch_error_codes';
+export * from './config/port_candidate_rule';
+export * from './config/websocket_server_endpoint';
+export * from './transport/websocket/websocket_server';
+export * from './error/ipc_error';
+export * from './message/constants/message_types';
+export * from './message/event';

package/src/moonbridge-ipc/general/lock/async_lock.ts

@@ -0,0 +1,58 @@
+/**
+ * 异步互斥锁，对应 Flutter lib/general/lock/async_lock.dart AsyncLock。
+ */
+
+import { Lock } from './lock';
+
+export class AsyncLock implements Lock {
+  private _locked = false;
+  private readonly _waitQueue: Array<() => void> = [];
+
+  /**
+   * 获取异步锁，无锁时立即获取，有锁时排队等待。
+   * @returns Promise<void> 锁获取成功时 resolve
+   */
+  async lock(): Promise<void> {
+    // 未锁定：直接获取锁
+    if (!this._locked) {
+      this._locked = true;
+      return;
+    }
+
+    // 已锁定：推入等待队列，等待唤醒
+    return new Promise<void>((resolve) => {
+      this._waitQueue.push(resolve);
+    });
+  }
+
+  /**
+   * 释放锁，唤醒等待队列中的下一个请求（如有）。
+   * @throws Error 锁未持有时调用会抛出错误
+   */
+  unlock(): void {
+    // 校验：未持有锁时禁止解锁
+    if (!this._locked) {
+      throw new Error('Lock is not currently held (cannot unlock an unlocked lock)');
+    }
+
+    // 有等待请求：唤醒第一个，且保持锁为锁定状态（核心修复）
+    if (this._waitQueue.length > 0) {
+      const nextResolve = this._waitQueue.shift();
+      // 兜底：避免极低频的竞态导致空值
+      if (nextResolve) {
+        nextResolve(); // 唤醒下一个请求，使其获取锁
+      }
+      // 关键：唤醒后锁仍为锁定状态，保证互斥性
+    } else {
+      // 无等待请求：释放锁
+      this._locked = false;
+    }
+  }
+
+  /**
+   * 当前锁是否被持有
+   */
+  get isLocked(): boolean {
+    return this._locked;
+  }
+}

package/src/moonbridge-ipc/general/lock/lock.ts

@@ -0,0 +1,9 @@
+/**
+ * 抽象锁接口，对应 Flutter lib/general/lock/lock.dart Lock。
+ */
+
+export interface Lock {
+  lock(): Promise<void>;
+  unlock(): void;
+  readonly isLocked: boolean;
+}

package/src/moonbridge-ipc/general/message/constants/message_types.ts

@@ -0,0 +1,18 @@
+/**
+ * IPC 消息类型名称常量，与 moonbridge-ipc-flutter MessageType 枚举的 name 字段一致。
+ * 对应 Flutter lib/general/message/constants/types.dart
+ */
+
+export const MessageType = {
+  UNKNOWN: 'TYPE_NAME_UNKNOWN',
+  ERROR: 'TYPE_NAME_ERROR',
+  REGISTRATION: 'TYPE_NAME_REGISTRATION',
+  REQUEST: 'TYPE_NAME_REQUEST',
+  RESPONSE: 'TYPE_NAME_RESPONSE',
+  SESSION_SETUP_REQUEST: 'TYPE_NAME_SESSION_SETUP_REQUEST',
+  SESSION_SETUP_RESPONSE: 'TYPE_NAME_SESSION_SETUP_RESPONSE',
+  UNREGISTRATION: 'TYPE_NAME_UNREGISTRATION',
+  EVENT: 'TYPE_NAME_EVENT',
+  HANDSHAKE: 'TYPE_NAME_HANDSHAKE',
+  PING: 'TYPE_NAME_PING',
+};

package/src/moonbridge-ipc/general/message/error.ts

@@ -0,0 +1,13 @@
+/**
+ * 跨进程通信错误消息体。对应 Flutter lib/general/message/error.dart Error。
+ */
+export class Error {
+  constructor(
+    public readonly requestId: string,
+    public readonly fromClient: string,
+    public readonly toClient: string,
+    public readonly code: number,
+    public readonly message?: string,
+    public readonly userInfo?: Record<string, unknown>
+  ) { }
+}

package/src/moonbridge-ipc/general/message/event.ts

@@ -0,0 +1,10 @@
+/**
+ * IPC 事件总线的事件类。对应 Flutter lib/general/message/event.dart Event。
+ */
+export class Event {
+  constructor(
+    public readonly type: string,
+    public readonly source?: string,
+    public readonly data?: Record<string, unknown>
+  ) { }
+}

package/src/moonbridge-ipc/general/message/handshake.ts

@@ -0,0 +1,16 @@
+/**
+ * IPC 服务握手消息。对应 Flutter lib/general/message/handshake.dart Handshake。
+ */
+export class Handshake {
+  static readonly ipcMagic = 'MoonBridgeIPC';
+  static readonly ipcVersion = '1.0.0';
+  static readonly clientRole = 'client';
+  static readonly serverRole = 'server';
+
+  constructor(
+    public readonly clientName: string,
+    public readonly magic: string,
+    public readonly role: string,
+    public readonly version: string
+  ) { }
+}

package/src/moonbridge-ipc/general/message/ping.ts

@@ -0,0 +1,6 @@
+/**
+ * Ping 消息。对应 Flutter lib/general/message/ping.dart Ping。
+ */
+export class Ping {
+  constructor(public readonly fromClient: string) { }
+}

package/src/moonbridge-ipc/general/message/registration.ts

@@ -0,0 +1,6 @@
+/**
+ * 客户端注册消息类。对应 Flutter lib/general/message/registration.dart Registration。
+ */
+export class Registration {
+  constructor(public readonly clientName: string) { }
+}

package/src/moonbridge-ipc/general/message/request.ts

@@ -0,0 +1,14 @@
+/**
+ * 跨进程通信请求消息类。对应 Flutter lib/general/message/request.dart Request。
+ */
+/** 与 Flutter Request 一致；TS 中避免保留字，用 args 对应 Flutter arguments。 */
+export class Request {
+  constructor(
+    public readonly requestId: string,
+    public readonly fromClient: string,
+    public readonly toClient: string,
+    public readonly moduleName: string,
+    public readonly methodName: string,
+    public readonly args: unknown[] = []
+  ) { }
+}

package/src/moonbridge-ipc/general/message/response.ts

@@ -0,0 +1,13 @@
+/**
+ * 跨进程通信响应消息类。对应 Flutter lib/general/message/response.dart Response。
+ */
+export class Response {
+  constructor(
+    public readonly requestId: string,
+    public readonly fromClient: string,
+    public readonly toClient: string,
+    public readonly callbackId: string,
+    public readonly response: unknown[] = [],
+    public readonly finished: boolean = true
+  ) { }
+}