@opensumi/ide-connection 2.12.1-next-079c1930

package/README.md

@@ -0,0 +1,208 @@
+# 通信模块(connection)
+
+基于 jsonrpc 完成多端远程调用场景，兼容 lsp 等通信方式
+
+
+### opensumi 中使用
+
+**准备**
+1. 框架中服务分为运行在浏览器环境的 前端服务(frontService) 与运行在 node 环境的 后端服务(backService)，服务在两端的实现方式是一致的
+2. 目前在 `tools/dev-tool` 中的启动逻辑中完成了服务的注册和获取逻辑，在具体功能模块中无需关心具体的通信注册获取逻辑
+
+**后端服务(backService)**
+后端服务(backService) 即在 Web Server 暴露的能力，类似 web 应用框架中 controller提供的请求响应逻辑
+
+1. 注册服务
+
+`packages/file-service/src/node/index.ts`
+```javascript
+import { FileSystemNodeOptions, FileService } from './file-service';
+import {servicePath} from '../common/index';
+
+export class FileServiceModule extends NodeModule {
+  providers = [{ token: 'FileServiceOptions', useValue: FileSystemNodeOptions.DEFAULT }];
+
+  backServices = [
+    {
+      servicePath,
+      token: FileService,
+    },
+  ];
+}
+```
+
+例如在 file-service 模块中，通过定义 `backServices` 数组，传递模块提供的后端服务，`servicePath` 为前端模块引用的服务地址，以及对应服务的注入 `token`
+
+2. 服务调用
+
+`packages/file-tree/src/browser/index.ts`
+```javascript
+
+import {servicePath as FileServicePath} from '@opensumi/ide-file-service';
+
+@Injectable()
+export class FileTreeModule extends BrowserModule {
+
+  providers: Provider[] = [
+    createFileTreeAPIProvider(FileTreeAPIImpl),
+  ];
+  backServices = [{
+    servicePath: FileServicePath,
+  }];
+}
+
+```
+
+例如在 file-tree 模块中，首先在模块入口位置声明需要用到的 `backServices`，传入引用的服务 `servicePath`，与服务注册时的 `servicePath` 一致
+
+`packages/file-tree/src/browser/file-tree.service.ts`
+```javascript
+import {servicePath as FileServicePath} from '@opensumi/ide-file-service';
+
+@Injectable()
+export default class FileTreeService extends Disposable {
+
+  @observable.shallow
+  files: CloudFile[] = [];
+
+  @Autowired()
+  private fileAPI: FileTreeAPI;
+
+  @Autowired(CommandService)
+  private commandService: CommandService;
+
+  constructor(@Inject(FileServicePath) protected readonly fileSevice) {
+    super();
+
+    this.getFiles();
+  }
+   createFile = async () => {
+    const {content} = await this.fileSevice.resolveContent('/Users/franklife/work/ide/ac/ide-framework/tsconfig.json');
+    const file = await this.fileAPI.createFile({
+      name: 'name' + Date.now() + '\n' + content,
+      path: 'path' + Date.now(),
+    });
+
+    // 只会执行注册在 Module 里声明的 Contribution
+    this.commandService.executeCommand('file.tree.console');
+
+    if (this.files) {
+      this.files.push(file);
+    } else {
+      this.files = [file];
+    }
+  }
+}
+```
+
+在 file-tree.service.ts 中通过 `servicePath` 进行注入，并直接调用在服务类上的方法
+
+```javascript
+constructor(@Inject(FileServicePath) protected readonly fileSevice) {
+    super();
+
+    this.getFiles();
+  }
+```
+
+方法调用会转换成一个远程调用进行响应，返回结果
+
+```javascript
+const {content} = await this.fileSevice.resolveContent('/Users/franklife/work/ide/ac/ide-framework/tsconfig.json');
+```
+
+
+**前端服务(frontService)**
+后端服务(backService) 即在 Browser 环境下运行的代码暴露的能力
+
+1. 注册服务
+
+`packages/file-ree/src/browser/index.ts`
+```javascript
+@Injectable()
+export class FileTreeModule extends BrowserModule {
+
+  providers: Provider[] = [
+    createFileTreeAPIProvider(FileTreeAPIImpl),
+  ];
+  backServices = [{
+    servicePath: FileServicePath,
+  }];
+  frontServices = [{
+    servicePath: FileTreeServicePath,
+    token: FileTreeService,
+  }];
+}
+```
+
+与后端服务注册类似，例如在 file-tree 模块中声明 `frontServices` 字段，传入对应的服务地址 `servicePath` 和对应服务的注入 `token`
+
+2. 服务使用
+
+`packages/file-service/src/node/index.ts`
+```javascript
+import {servicePath as FileTreeServicePath} from '@opensumi/ide-file-tree';
+
+@Injectable()
+export class FileServiceModule extends NodeModule {
+  providers = [{ token: 'FileServiceOptions', useValue: FileSystemNodeOptions.DEFAULT }];
+
+  backServices = [
+    {
+      servicePath,
+      token: FileService,
+    },
+  ];
+  frontServices = [
+    {
+      servicePath: FileTreeServicePath,
+    },
+  ];
+}
+```
+
+与使用后端服务一致，在模块定义中声明需要使用的前端服务 `frontServices`，传入前端服务注册时用的 `servicePath` 一致
+
+`packages/file-service/src/node/file-service.ts`
+```javascript
+@Injectable()
+export class FileService implements IFileService {
+
+  constructor(
+    @Inject('FileServiceOptions') protected readonly options: FileSystemNodeOptions,
+    @Inject(FileTreeServicePath) protected readonly fileTreeService
+  ) { }
+
+  async resolveContent(uri: string, options?: { encoding?: string }): Promise<{ stat: FileStat, content: string }> {
+    const fileTree = await this.fileTreeService
+    fileTree.fileName(uri.substr(-5))
+
+    ...
+    return { stat, content };
+  }
+```
+
+与使用后端服务使用方式一致，在 file-service.ts 中通过 `servicePath` 进行注入，通过调用注入服务的对应方法
+
+```javascript
+  constructor(
+    @Inject('FileServiceOptions') protected readonly options: FileSystemNodeOptions,
+    @Inject(FileTreeServicePath) protected readonly fileTreeService
+  ) { }
+```
+
+方法调用会转换成一个远程调用进行响应，返回结果
+```javascript
+const fileTree = await this.fileTreeService
+fileTree.fileName(uri.substr(-5))
+```
+
+与后端服务调用区别的是，目前因前端代码后置执行，所以首先需要获取服务 `await thie.fileTreeService` 后进行调用
+
+
+
+
+
+
+
+

package/lib/browser/ws-channel-handler.d.ts

@@ -0,0 +1,27 @@
+import { WSChannel } from '../common/ws-channel';
+import { IReporterService } from '@opensumi/ide-core-common';
+export declare class WSChannelHandler {
+    wsPath: string;
+    protocols?: string[] | undefined;
+    connection: WebSocket;
+    private channelMap;
+    private logger;
+    clientId: string;
+    private heartbeatMessageTimer;
+    private reporterService;
+    constructor(wsPath: string, logger: any, protocols?: string[] | undefined, clientId?: string);
+    replaceLogger(logger: any): void;
+    setReporter(reporterService: IReporterService): void;
+    private clientMessage;
+    private heartbeatMessage;
+    initHandler(): Promise<void>;
+    private getChannelSend;
+    openChannel(channelPath: string): Promise<WSChannel>;
+    dispose(): void;
+}
+export declare class WSChanneHandler extends WSChannelHandler {
+    wsPath: string;
+    protocols?: string[] | undefined;
+    constructor(wsPath: string, logger: any, protocols?: string[] | undefined, clientId?: string);
+}
+//# sourceMappingURL=ws-channel-handler.d.ts.map

package/lib/browser/ws-channel-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-channel-handler.d.ts","sourceRoot":"","sources":["../../src/browser/ws-channel-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,sBAAsB,CAAC;AAIhE,OAAO,EAAE,gBAAgB,EAAe,MAAM,2BAA2B,CAAC;AAU1E,qBAAa,gBAAgB;IAQR,MAAM,EAAE,MAAM;IAAsB,SAAS,CAAC;IAP1D,UAAU,EAAE,SAAS,CAAC;IAC7B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,MAAM,CAAW;IAClB,QAAQ,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,eAAe,CAAmB;gBAEvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAS,SAAS,CAAC,sBAAU,EAAE,QAAQ,CAAC,EAAE,MAAM;IAM9F,aAAa,CAAC,MAAM,EAAE,GAAG;IAKzB,WAAW,CAAC,eAAe,EAAE,gBAAgB;IAG7C,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,gBAAgB;IAcX,WAAW;IA2CxB,OAAO,CAAC,cAAc,CAQrB;IACY,WAAW,CAAC,WAAW,EAAE,MAAM;IAgBrC,OAAO;CAKf;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;IAChC,MAAM,EAAE,MAAM;IAAsB,SAAS,CAAC;gBAA9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAS,SAAS,CAAC,sBAAU,EAAE,QAAQ,CAAC,EAAE,MAAM;CAI/F"}

package/lib/browser/ws-channel-handler.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WSChanneHandler = exports.WSChannelHandler = void 0;
+const tslib_1 = require("tslib");
+const ws_channel_1 = require("../common/ws-channel");
+const shortid_1 = (0, tslib_1.__importDefault)(require("shortid"));
+const utils_1 = require("../common/utils");
+const warning_1 = require("@opensumi/ide-components/lib/utils/warning");
+const ide_core_common_1 = require("@opensumi/ide-core-common");
+let ReconnectingWebSocket = require('reconnecting-websocket');
+if (ReconnectingWebSocket.default) {
+    /* istanbul ignore next */
+    ReconnectingWebSocket = ReconnectingWebSocket.default;
+}
+// 前台链接管理类
+class WSChannelHandler {
+    constructor(wsPath, logger, protocols, clientId) {
+        this.wsPath = wsPath;
+        this.protocols = protocols;
+        this.channelMap = new Map();
+        this.logger = console;
+        this.getChannelSend = (connection) => {
+            return (content) => {
+                connection.send(content, (err) => {
+                    if (err) {
+                        this.logger.warn(err);
+                    }
+                });
+            };
+        };
+        this.logger = logger || this.logger;
+        this.clientId = clientId || `CLIENT_ID_${shortid_1.default.generate()}`;
+        this.connection = new ReconnectingWebSocket(wsPath, protocols, {}); // new WebSocket(wsPath, protocols);
+    }
+    // 为解决建立连接之后，替换成可落盘的 logger
+    replaceLogger(logger) {
+        if (logger) {
+            this.logger = logger;
+        }
+    }
+    setReporter(reporterService) {
+        this.reporterService = reporterService;
+    }
+    clientMessage() {
+        const clientMsg = (0, utils_1.stringify)({
+            kind: 'client',
+            clientId: this.clientId,
+        });
+        this.connection.send(clientMsg);
+    }
+    heartbeatMessage() {
+        if (this.heartbeatMessageTimer) {
+            clearTimeout(this.heartbeatMessageTimer);
+        }
+        this.heartbeatMessageTimer = global.setTimeout(() => {
+            const msg = (0, utils_1.stringify)({
+                kind: 'heartbeat',
+                clientId: this.clientId,
+            });
+            this.connection.send(msg);
+            this.heartbeatMessage();
+        }, 5000);
+    }
+    async initHandler() {
+        this.connection.onmessage = (e) => {
+            // 一个心跳周期内如果有收到消息，则不需要再发送心跳
+            this.heartbeatMessage();
+            const msg = (0, utils_1.parse)(e.data);
+            if (msg.id) {
+                const channel = this.channelMap.get(msg.id);
+                if (channel) {
+                    if (msg.kind === 'data' && !channel.fireMessage) {
+                        // 要求前端发送初始化消息，但后端最先发送消息时，前端并未准备好
+                        this.logger.error(`channel not ready!`, msg);
+                    }
+                    channel.handleMessage(msg);
+                }
+                else {
+                    this.logger.warn(`channel ${msg.id} not found`);
+                }
+            }
+        };
+        await new Promise((resolve) => {
+            this.connection.addEventListener('open', () => {
+                this.clientMessage();
+                this.heartbeatMessage();
+                resolve(undefined);
+                // 重连 channel
+                if (this.channelMap.size) {
+                    this.channelMap.forEach((channel) => {
+                        channel.onOpen(() => {
+                            this.reporterService && this.reporterService.point(ide_core_common_1.REPORT_NAME.CHANNEL_RECONNECT);
+                            this.logger && this.logger.log(`channel reconnect ${this.clientId}:${channel.channelPath}`);
+                        });
+                        channel.open(channel.channelPath);
+                        // 针对前端需要重新设置下后台状态的情况
+                        if (channel.fireReOpen) {
+                            channel.fireReOpen();
+                        }
+                    });
+                }
+            });
+        });
+    }
+    async openChannel(channelPath) {
+        const channelSend = this.getChannelSend(this.connection);
+        const channelId = `${this.clientId}:${channelPath}`;
+        const channel = new ws_channel_1.WSChannel(channelSend, channelId);
+        this.channelMap.set(channel.id, channel);
+        await new Promise((resolve) => {
+            channel.onOpen(() => {
+                resolve(undefined);
+            });
+            channel.open(channelPath);
+        });
+        return channel;
+    }
+    dispose() {
+        if (this.heartbeatMessageTimer) {
+            clearTimeout(this.heartbeatMessageTimer);
+        }
+    }
+}
+exports.WSChannelHandler = WSChannelHandler;
+class WSChanneHandler extends WSChannelHandler {
+    constructor(wsPath, logger, protocols, clientId) {
+        super(wsPath, logger, protocols, clientId);
+        this.wsPath = wsPath;
+        this.protocols = protocols;
+        (0, warning_1.warning)(false, '[Deprecated warning]: WSChanneHandler was a wrong typo, please use WSChannelHandler');
+    }
+}
+exports.WSChanneHandler = WSChanneHandler;
+//# sourceMappingURL=ws-channel-handler.js.map

package/lib/browser/ws-channel-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-channel-handler.js","sourceRoot":"","sources":["../../src/browser/ws-channel-handler.ts"],"names":[],"mappings":"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"}

package/lib/common/message.d.ts

@@ -0,0 +1,29 @@
+import { AbstractMessageReader, AbstractMessageWriter } from '@opensumi/vscode-jsonrpc/lib/common/api';
+import { MessageWriter } from '@opensumi/vscode-jsonrpc/lib/common/messageWriter';
+import { MessageReader, DataCallback } from '@opensumi/vscode-jsonrpc/lib/common/messageReader';
+import { Disposable } from '@opensumi/vscode-jsonrpc/lib/common/disposable';
+export declare class WebSocketMessageReader extends AbstractMessageReader implements MessageReader {
+    protected readonly socket: any;
+    protected state: 'initial' | 'listening' | 'closed';
+    protected callback: DataCallback | undefined;
+    protected events: {
+        message?: any;
+        error?: any;
+    }[];
+    constructor(socket: any);
+    listen(callback: DataCallback): Disposable;
+    protected readMessage(message: any): void;
+}
+export declare class WebSocketMessageWriter extends AbstractMessageWriter implements MessageWriter {
+    protected readonly socket: any;
+    constructor(socket: any);
+    write(msg: any): Promise<void>;
+    end(): void;
+}
+/**
+ * 给服务端的 WebSocket 及 Browser 端的 WebSocket 实例共用的方法
+ * @param socket
+ * @returns
+ */
+export declare function createWebSocketConnection(socket: any): import("@opensumi/vscode-jsonrpc/lib/common/connection").MessageConnection;
+//# sourceMappingURL=message.d.ts.map

package/lib/common/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/common/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAA2B,MAAM,yCAAyC,CAAC;AAChI,OAAO,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AAE5E,qBAAa,sBAAuB,SAAQ,qBAAsB,YAAW,aAAa;IAK5E,SAAS,CAAC,QAAQ,CAAC,MAAM;IAJrC,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAa;IAChE,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,EAAE,CAAM;gBAEzB,MAAM,KAAA;IAiB9B,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU;IAoBjD,SAAS,CAAC,WAAW,CAAC,OAAO,KAAA;CAQ9B;AAED,qBAAa,sBAAuB,SAAQ,qBAAsB,YAAW,aAAa;IAC5E,SAAS,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,KAAA;IAIrC,KAAK,CAAC,GAAG,KAAA,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlB,GAAG,IAAI,IAAI;CAEnB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,8EAKpD"}

package/lib/common/message.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocketConnection = exports.WebSocketMessageWriter = exports.WebSocketMessageReader = void 0;
+const api_1 = require("@opensumi/vscode-jsonrpc/lib/common/api");
+const disposable_1 = require("@opensumi/vscode-jsonrpc/lib/common/disposable");
+class WebSocketMessageReader extends api_1.AbstractMessageReader {
+    constructor(socket) {
+        super();
+        this.socket = socket;
+        this.state = 'initial';
+        this.events = [];
+        if (this.socket.onMessage) {
+            this.socket.onMessage((message) => {
+                this.readMessage(message);
+            });
+        }
+        else if (this.socket.onmessage) {
+            this.socket.onmessage = (message) => {
+                this.readMessage(message);
+            };
+        }
+        else if (this.socket.on) {
+            this.socket.on('message', (message) => {
+                this.readMessage(message);
+            });
+        }
+    }
+    listen(callback) {
+        if (this.state === 'initial') {
+            this.state = 'listening';
+            this.callback = callback;
+        }
+        while (this.events.length !== 0) {
+            const event = this.events.pop();
+            if (event.message) {
+                this.readMessage(event.message);
+            }
+        }
+        return disposable_1.Disposable.create(() => {
+            this.state = 'closed';
+            this.callback = undefined;
+            this.events = [];
+        });
+    }
+    readMessage(message) {
+        if (this.state === 'initial') {
+            this.events.splice(0, 0, { message });
+        }
+        else if (this.state === 'listening') {
+            const data = JSON.parse(message);
+            this.callback(data);
+        }
+    }
+}
+exports.WebSocketMessageReader = WebSocketMessageReader;
+class WebSocketMessageWriter extends api_1.AbstractMessageWriter {
+    constructor(socket) {
+        super();
+        this.socket = socket;
+    }
+    write(msg) {
+        try {
+            const content = JSON.stringify(msg);
+            this.socket.send(content);
+            return Promise.resolve();
+        }
+        catch (e) {
+            return Promise.reject(e);
+        }
+    }
+    end() {
+    }
+}
+exports.WebSocketMessageWriter = WebSocketMessageWriter;
+/**
+ * 给服务端的 WebSocket 及 Browser 端的 WebSocket 实例共用的方法
+ * @param socket
+ * @returns
+ */
+function createWebSocketConnection(socket) {
+    return (0, api_1.createMessageConnection)(new WebSocketMessageReader(socket), new WebSocketMessageWriter(socket));
+}
+exports.createWebSocketConnection = createWebSocketConnection;
+//# sourceMappingURL=message.js.map

package/lib/common/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/common/message.ts"],"names":[],"mappings":"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"}

package/lib/common/proxy.d.ts

@@ -0,0 +1,2 @@
+export * from '../node/center/proxy';
+//# sourceMappingURL=proxy.d.ts.map

package/lib/common/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/common/proxy.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/lib/common/proxy.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("../node/center/proxy"), exports);
+//# sourceMappingURL=proxy.js.map

package/lib/common/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/common/proxy.ts"],"names":[],"mappings":";;;AAAA,oEAAqC"}

package/lib/common/rpcProtocol.d.ts

@@ -0,0 +1,68 @@
+import { Event } from '@opensumi/ide-core-common';
+export declare enum RPCProtocolEnv {
+    MAIN = 0,
+    EXT = 1
+}
+export interface SerializedError {
+    readonly $isError: true;
+    readonly name: string;
+    readonly message: string;
+    readonly stack: string;
+}
+export declare function transformErrorForSerialization(error: Error): SerializedError;
+export declare function transformErrorForSerialization(error: any): any;
+export interface IProxyIdentifier {
+    serviceId: string;
+    countId: number;
+}
+export declare class ProxyIdentifier<T = any> {
+    static count: number;
+    readonly serviceId: string;
+    readonly countId: number;
+    constructor(serviceId: string);
+}
+export declare function createExtHostContextProxyIdentifier<T>(serviceId: string): ProxyIdentifier<T>;
+export declare function createMainContextProxyIdentifier<T>(identifier: string): ProxyIdentifier<T>;
+export interface IMessagePassingProtocol {
+    send(msg: any): void;
+    onMessage: Event<string>;
+}
+export declare namespace ObjectTransfer {
+    function replacer(key: string | undefined, value: any): any;
+    function reviver(key: string | undefined, value: any): any;
+}
+export declare class MessageIO {
+    static cancel(req: string, messageToSendHostId?: string): string;
+    static serializeRequest(callId: string, rpcId: string, method: string, args: any[]): string;
+    static serializeReplyOK(callId: string, res: any, logger?: any): string;
+    static serializeReplyError(callId: string, error: Error, logger?: any): string;
+}
+export declare const IRPCProtocol: unique symbol;
+export interface IRPCProtocol {
+    getProxy<T>(proxyId: ProxyIdentifier<T>): T;
+    set<T>(identifier: ProxyIdentifier<T>, instance: T): T;
+    get<T>(identifier: ProxyIdentifier<T>): T;
+}
+export declare class RPCProtocol implements IRPCProtocol {
+    private readonly _protocol;
+    private readonly _locals;
+    private readonly _proxies;
+    private readonly _cancellationTokenSources;
+    private _lastMessageId;
+    private _pendingRPCReplies;
+    private logger;
+    constructor(connection: IMessagePassingProtocol, logger?: any);
+    set<T>(identifier: ProxyIdentifier<T>, instance: any): any;
+    get<T>(identifier: ProxyIdentifier<T>): any;
+    getProxy<T>(proxyId: ProxyIdentifier<T>): any;
+    private _createProxy;
+    private _remoteCall;
+    private _receiveOneMessage;
+    private _receiveCancel;
+    private _receiveError;
+    private _receiveRequest;
+    private _invokeHandler;
+    private _doInvokeHandler;
+    private _receiveReply;
+}
+//# sourceMappingURL=rpcProtocol.d.ts.map

package/lib/common/rpcProtocol.d.ts.map

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