@theia/core 1.67.0-next.56 → 1.67.0-next.86

package/lib/common/message-service.js

@@ -0,0 +1,152 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageService = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const message_service_protocol_1 = require("./message-service-protocol");
+const cancellation_1 = require("./cancellation");
+/**
+ * Service to log and categorize messages, show progress information and offer actions.
+ *
+ * The messages are processed by this service and forwarded to an injected {@link MessageClient}.
+ * For example "@theia/messages" provides such a client, rendering messages as notifications
+ * in the frontend.
+ *
+ * ### Example usage
+ *
+ * ```typescript
+ *   @inject(MessageService)
+ *   protected readonly messageService: MessageService;
+ *
+ *   messageService.warn("Typings not available");
+ *
+ *   messageService.error("Could not restore state", ["Rollback", "Ignore"])
+ *   .then(action => action === "Rollback" && rollback());
+ * ```
+ */
+let MessageService = class MessageService {
+    constructor(client) {
+        this.client = client;
+        this.progressIdPrefix = Math.random().toString(36).substring(5);
+        this.counter = 0;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    log(message, ...args) {
+        return this.processMessage(message_service_protocol_1.MessageType.Log, message, args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    info(message, ...args) {
+        return this.processMessage(message_service_protocol_1.MessageType.Info, message, args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn(message, ...args) {
+        return this.processMessage(message_service_protocol_1.MessageType.Warning, message, args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error(message, ...args) {
+        return this.processMessage(message_service_protocol_1.MessageType.Error, message, args);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    processMessage(type, text, args) {
+        if (!!args && args.length > 0) {
+            const first = args[0];
+            const actions = Array.from(new Set(args.filter(a => typeof a === 'string')));
+            const options = (typeof first === 'object' && !Array.isArray(first))
+                ? first
+                : undefined;
+            return this.client.showMessage({ type, options, text, actions });
+        }
+        return this.client.showMessage({ type, text });
+    }
+    /**
+     * Shows the given message as a progress.
+     *
+     * @param message the message to show for the progress.
+     * @param onDidCancel an optional callback which will be invoked if the progress indicator was canceled.
+     *
+     * @returns a promise resolving to a {@link Progress} object with which the progress can be updated.
+     *
+     * ### Example usage
+     *
+     * ```typescript
+     *   @inject(MessageService)
+     *   protected readonly messageService: MessageService;
+     *
+     *   // this will show "Progress" as a cancelable message
+     *   this.messageService.showProgress({text: 'Progress'});
+     *
+     *   // this will show "Rolling back" with "Cancel" and an additional "Skip" action
+     *   this.messageService.showProgress({
+     *     text: `Rolling back`,
+     *     actions: ["Skip"],
+     *   },
+     *   () => console.log("canceled"))
+     *   .then((progress) => {
+     *     // register if interested in the result (only necessary for custom actions)
+     *     progress.result.then((result) => {
+     *       // will be 'Cancel', 'Skip' or `undefined`
+     *       console.log("result is", result);
+     *     });
+     *     progress.report({message: "Cleaning references", work: {done: 10, total: 100}});
+     *     progress.report({message: "Restoring previous state", work: {done: 80, total: 100}});
+     *     progress.report({message: "Complete", work: {done: 100, total: 100}});
+     *     // we are done so we can cancel the progress message, note that this will also invoke `onDidCancel`
+     *     progress.cancel();
+     *   });
+     * ```
+     */
+    async showProgress(message, onDidCancel) {
+        var _a;
+        const id = this.newProgressId();
+        const cancellationSource = new cancellation_1.CancellationTokenSource();
+        const report = (update) => {
+            this.client.reportProgress(id, update, message, cancellationSource.token);
+        };
+        const type = (_a = message.type) !== null && _a !== void 0 ? _a : message_service_protocol_1.MessageType.Progress;
+        const actions = new Set(message.actions);
+        if (message_service_protocol_1.ProgressMessage.isCancelable(message)) {
+            actions.delete(message_service_protocol_1.ProgressMessage.Cancel);
+            actions.add(message_service_protocol_1.ProgressMessage.Cancel);
+        }
+        const clientMessage = { ...message, type, actions: Array.from(actions) };
+        const result = this.client.showProgress(id, clientMessage, cancellationSource.token);
+        if (message_service_protocol_1.ProgressMessage.isCancelable(message) && typeof onDidCancel === 'function') {
+            result.then(value => {
+                if (value === message_service_protocol_1.ProgressMessage.Cancel) {
+                    onDidCancel();
+                }
+            });
+        }
+        return {
+            id,
+            cancel: () => cancellationSource.cancel(),
+            result,
+            report
+        };
+    }
+    newProgressId() {
+        return `${this.progressIdPrefix}-${++this.counter}`;
+    }
+};
+exports.MessageService = MessageService;
+exports.MessageService = MessageService = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(message_service_protocol_1.MessageClient)),
+    tslib_1.__metadata("design:paramtypes", [message_service_protocol_1.MessageClient])
+], MessageService);
+//# sourceMappingURL=message-service.js.map

package/lib/common/message-service.js.map

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

package/lib/common/messaging/connection-error-handler.d.ts

@@ -0,0 +1,29 @@
+import { ILogger } from '../../common';
+export interface ResolvedConnectionErrorHandlerOptions {
+    readonly serverName: string;
+    readonly logger: ILogger;
+    /**
+     * The maximum amount of errors allowed before stopping the server.
+     */
+    readonly maxErrors: number;
+    /**
+     * The minimum amount of restarts allowed in the restart interval.
+     */
+    readonly maxRestarts: number;
+    /**
+     * In minutes.
+     */
+    readonly restartInterval: number;
+}
+export type ConnectionErrorHandlerOptions = Partial<ResolvedConnectionErrorHandlerOptions> & {
+    readonly serverName: string;
+    readonly logger: ILogger;
+};
+export declare class ConnectionErrorHandler {
+    protected readonly options: ResolvedConnectionErrorHandlerOptions;
+    constructor(options: ConnectionErrorHandlerOptions);
+    shouldStop(error: Error, count?: number): boolean;
+    protected readonly restarts: number[];
+    shouldRestart(): boolean;
+}
+//# sourceMappingURL=connection-error-handler.d.ts.map

package/lib/common/messaging/connection-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-error-handler.d.ts","sourceRoot":"","sources":["../../../src/common/messaging/connection-error-handler.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,WAAW,qCAAqC;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,MAAM,6BAA6B,GAAG,OAAO,CAAC,qCAAqC,CAAC,GAAG;IACzF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAC3B,CAAC;AAEF,qBAAa,sBAAsB;IAE/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,qCAAqC,CAAC;gBACtD,OAAO,EAAE,6BAA6B;IASlD,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAIjD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IAC3C,aAAa,IAAI,OAAO;CAe3B"}

package/lib/common/messaging/connection-error-handler.js

@@ -0,0 +1,48 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionErrorHandler = void 0;
+class ConnectionErrorHandler {
+    constructor(options) {
+        this.restarts = [];
+        this.options = {
+            maxErrors: 3,
+            maxRestarts: 5,
+            restartInterval: 3,
+            ...options
+        };
+    }
+    shouldStop(error, count) {
+        return !count || count > this.options.maxErrors;
+    }
+    shouldRestart() {
+        this.restarts.push(Date.now());
+        if (this.restarts.length <= this.options.maxRestarts) {
+            return true;
+        }
+        const diff = this.restarts[this.restarts.length - 1] - this.restarts[0];
+        if (diff <= this.options.restartInterval * 60 * 1000) {
+            // eslint-disable-next-line max-len
+            this.options.logger.error(`The ${this.options.serverName} server crashed ${this.options.maxRestarts} times in the last ${this.options.restartInterval} minutes. The server will not be restarted.`);
+            return false;
+        }
+        this.restarts.shift();
+        return true;
+    }
+}
+exports.ConnectionErrorHandler = ConnectionErrorHandler;
+//# sourceMappingURL=connection-error-handler.js.map

package/lib/common/messaging/connection-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-error-handler.js","sourceRoot":"","sources":["../../../src/common/messaging/connection-error-handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AA0BhF,MAAa,sBAAsB;IAG/B,YAAY,OAAsC;QAa/B,aAAQ,GAAa,EAAE,CAAC;QAZvC,IAAI,CAAC,OAAO,GAAG;YACX,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,CAAC;YAClB,GAAG,OAAO;SACb,CAAC;IACN,CAAC;IAED,UAAU,CAAC,KAAY,EAAE,KAAc;QACnC,OAAO,CAAC,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;IACpD,CAAC;IAGD,aAAa;QACT,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,eAAe,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YACnD,mCAAmC;YACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,mBAAmB,IAAI,CAAC,OAAO,CAAC,WAAW,sBAAsB,IAAI,CAAC,OAAO,CAAC,eAAe,6CAA6C,CAAC,CAAC;YACpM,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;CAEJ;AAhCD,wDAgCC"}

package/lib/common/messaging/connection-management.d.ts

@@ -0,0 +1,25 @@
+export declare const ConnectionCloseService: unique symbol;
+export declare const connectionCloseServicePath = "/services/ChannelCloseService";
+/**
+ * These messages are used to negotiate service reconnection between a front ends and back end.
+ * Whenever a front end first connects to a back end, it sends the ${@link ConnectionManagementMessages#INITIAL_CONNECT} message
+ * together with its front end id.
+ * The back end then starts a new front end connection context for that front end. If the back end already had another connection context
+ * for the given front end id, it gets discarded.
+ * If the front end reconnects after a websocket disconnect, it sends the ${@link ConnectionManagementMessages#RECONNECT} message
+ * together with its front end id..
+ * If the back end still has a connection context for the front end id, the context is reconnected and the back end replies with the value true.
+ * If there is no context anymore, the back end replies with value false. The front end can then either do an initial connect or reload
+ * the whole UI.
+ */
+export declare namespace ConnectionManagementMessages {
+    const INITIAL_CONNECT = "initialConnection";
+    const RECONNECT = "reconnect";
+}
+/**
+ * A service to mark a front end as unused. As soon as it disconnects from the back end, the connection context will be discarded.
+ */
+export interface ConnectionCloseService {
+    markForClose(frontEndId: string): Promise<void>;
+}
+//# sourceMappingURL=connection-management.d.ts.map

package/lib/common/messaging/connection-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-management.d.ts","sourceRoot":"","sources":["../../../src/common/messaging/connection-management.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AACvE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,yBAAiB,4BAA4B,CAAC;IACnC,MAAM,eAAe,sBAAsB,CAAC;IAC5C,MAAM,SAAS,cAAc,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD"}

package/lib/common/messaging/connection-management.js

@@ -0,0 +1,38 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionManagementMessages = exports.connectionCloseServicePath = exports.ConnectionCloseService = void 0;
+exports.ConnectionCloseService = Symbol('ConnectionCloseService');
+exports.connectionCloseServicePath = '/services/ChannelCloseService';
+/**
+ * These messages are used to negotiate service reconnection between a front ends and back end.
+ * Whenever a front end first connects to a back end, it sends the ${@link ConnectionManagementMessages#INITIAL_CONNECT} message
+ * together with its front end id.
+ * The back end then starts a new front end connection context for that front end. If the back end already had another connection context
+ * for the given front end id, it gets discarded.
+ * If the front end reconnects after a websocket disconnect, it sends the ${@link ConnectionManagementMessages#RECONNECT} message
+ * together with its front end id..
+ * If the back end still has a connection context for the front end id, the context is reconnected and the back end replies with the value true.
+ * If there is no context anymore, the back end replies with value false. The front end can then either do an initial connect or reload
+ * the whole UI.
+ */
+var ConnectionManagementMessages;
+(function (ConnectionManagementMessages) {
+    ConnectionManagementMessages.INITIAL_CONNECT = 'initialConnection';
+    ConnectionManagementMessages.RECONNECT = 'reconnect';
+})(ConnectionManagementMessages || (exports.ConnectionManagementMessages = ConnectionManagementMessages = {}));
+//# sourceMappingURL=connection-management.js.map

package/lib/common/messaging/connection-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-management.js","sourceRoot":"","sources":["../../../src/common/messaging/connection-management.ts"],"names":[],"mappings":";AACA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEnE,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAC1D,QAAA,0BAA0B,GAAG,+BAA+B,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,IAAiB,4BAA4B,CAG5C;AAHD,WAAiB,4BAA4B;IAC5B,4CAAe,GAAG,mBAAmB,CAAC;IACtC,sCAAS,GAAG,WAAW,CAAC;AACzC,CAAC,EAHgB,4BAA4B,4CAA5B,4BAA4B,QAG5C"}

package/lib/common/messaging/handler.d.ts

@@ -0,0 +1,8 @@
+import { Channel } from '../message-rpc/channel';
+export declare const servicesPath = "/services";
+export declare const ConnectionHandler: unique symbol;
+export interface ConnectionHandler {
+    readonly path: string;
+    onConnection(connection: Channel): void;
+}
+//# sourceMappingURL=handler.d.ts.map

package/lib/common/messaging/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/common/messaging/handler.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C"}

package/lib/common/messaging/handler.js

@@ -0,0 +1,21 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionHandler = exports.servicesPath = void 0;
+exports.servicesPath = '/services';
+exports.ConnectionHandler = Symbol('ConnectionHandler');
+//# sourceMappingURL=handler.js.map

package/lib/common/messaging/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/common/messaging/handler.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAInE,QAAA,YAAY,GAAG,WAAW,CAAC;AAE3B,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/lib/common/messaging/index.d.ts

@@ -0,0 +1,4 @@
+export * from './handler';
+export * from './proxy-factory';
+export * from './connection-error-handler';
+//# sourceMappingURL=index.d.ts.map

package/lib/common/messaging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/messaging/index.ts"],"names":[],"mappings":"AAgBA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC"}

package/lib/common/messaging/index.js

@@ -0,0 +1,22 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./handler"), exports);
+tslib_1.__exportStar(require("./proxy-factory"), exports);
+tslib_1.__exportStar(require("./connection-error-handler"), exports);
+//# sourceMappingURL=index.js.map

package/lib/common/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/messaging/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,oDAA0B;AAC1B,0DAAgC;AAChC,qEAA2C"}

package/lib/common/messaging/proxy-factory.d.ts

@@ -0,0 +1,181 @@
+import { Disposable } from '../disposable';
+import { Emitter, Event } from '../event';
+import { Channel } from '../message-rpc/channel';
+import { RequestHandler, RpcProtocol } from '../message-rpc/rpc-protocol';
+import { ConnectionHandler } from './handler';
+import { Deferred } from '../promise-util';
+export type RpcServer<Client> = Disposable & {
+    /**
+     * If this server is a proxy to a remote server then
+     * a client is used as a local object
+     * to handle RPC messages from the remote server.
+     */
+    setClient(client: Client | undefined): void;
+    getClient?(): Client | undefined;
+};
+export interface RpcConnectionEventEmitter {
+    readonly onDidOpenConnection: Event<void>;
+    readonly onDidCloseConnection: Event<void>;
+}
+export type RpcProxy<T> = T & RpcConnectionEventEmitter;
+export declare class RpcConnectionHandler<T extends object> implements ConnectionHandler {
+    readonly path: string;
+    readonly targetFactory: (proxy: RpcProxy<T>) => any;
+    readonly factoryConstructor: new () => RpcProxyFactory<T>;
+    constructor(path: string, targetFactory: (proxy: RpcProxy<T>) => any, factoryConstructor?: new () => RpcProxyFactory<T>);
+    onConnection(connection: Channel): void;
+}
+/**
+ * Factory for creating a new {@link RpcProtocol} for a given chanel and {@link RequestHandler}.
+ */
+export type RpcProtocolFactory = (channel: Channel, requestHandler: RequestHandler) => RpcProtocol;
+/**
+ * Factory for RPC proxy objects.
+ *
+ * A RPC proxy exposes the programmatic interface of an object through
+ * Theia's RPC protocol. This allows remote programs to call methods of this objects by
+ * sending RPC requests. This takes place over a bi-directional stream,
+ * where both ends can expose an object and both can call methods on each other'
+ * exposed object.
+ *
+ * For example, assuming we have an object of the following type on one end:
+ *
+ *     class Foo {
+ *         bar(baz: number): number { return baz + 1 }
+ *     }
+ *
+ * which we want to expose through a RPC interface.  We would do:
+ *
+ *     let target = new Foo()
+ *     let factory = new RpcProxyFactory<Foo>('/foo', target)
+ *     factory.onConnection(connection)
+ *
+ * The party at the other end of the `connection`, in order to remotely call
+ * methods on this object would do:
+ *
+ *     let factory = new RpcProxyFactory<Foo>('/foo')
+ *     factory.onConnection(connection)
+ *     let proxy = factory.createProxy();
+ *     let result = proxy.bar(42)
+ *     // result is equal to 43
+ *
+ * One the wire, it would look like this:
+ *
+ *     --> { "type":"1", "id": 1, "method": "bar", "args": [42]}
+ *     <-- { "type":"3", "id": 1, "res": 43}
+ *
+ * Note that in the code of the caller, we didn't pass a target object to
+ * RpcProxyFactory, because we don't want/need to expose an object.
+ * If we had passed a target object, the other side could've called methods on
+ * it.
+ *
+ * @param <T> - The type of the object to expose to RPC.
+ */
+export declare class RpcProxyFactory<T extends object> implements ProxyHandler<T> {
+    target?: any;
+    protected rpcProtocolFactory: RpcProtocolFactory;
+    protected readonly onDidOpenConnectionEmitter: Emitter<void>;
+    protected readonly onDidCloseConnectionEmitter: Emitter<void>;
+    protected rpcDeferred: Deferred<RpcProtocol>;
+    /**
+     * Build a new RpcProxyFactory.
+     *
+     * @param target - The object to expose to RPC methods calls.  If this
+     *   is omitted, the proxy won't be able to handle requests, only send them.
+     */
+    constructor(target?: any, rpcProtocolFactory?: RpcProtocolFactory);
+    protected waitForConnection(): void;
+    /**
+     * Connect a {@link Channel} to the factory by creating an {@link RpcProtocol} on top of it.
+     *
+     * This protocol will be used to send/receive RPC requests and
+     * responses.
+     */
+    listen(channel: Channel): void;
+    /**
+     * Process an incoming RPC method call.
+     *
+     * onRequest is called when the RPC connection received a method call
+     * request.  It calls the corresponding method on [[target]].
+     *
+     * The return value is a Promise object that is resolved with the return
+     * value of the method call, if it is successful.  The promise is rejected
+     * if the called method does not exist or if it throws.
+     *
+     * @returns A promise of the method call completion.
+     */
+    protected onRequest(method: string, ...args: any[]): Promise<any>;
+    /**
+     * Process an incoming RPC notification.
+     *
+     * Same as [[onRequest]], but called on incoming notifications rather than
+     * methods calls.
+     */
+    protected onNotification(method: string, ...args: any[]): void;
+    /**
+     * Create a Proxy exposing the interface of an object of type T.  This Proxy
+     * can be used to do RPC method calls on the remote target object as
+     * if it was local.
+     *
+     * If `T` implements `RpcServer` then a client is used as a target object for a remote target object.
+     */
+    createProxy(): RpcProxy<T>;
+    /**
+     * Get a callable object that executes a RPC method call.
+     *
+     * Getting a property on the Proxy object returns a callable that, when
+     * called, executes a RPC call.  The name of the property defines the
+     * method to be called.  The callable takes a variable number of arguments,
+     * which are passed in the RPC method call.
+     *
+     * For example, if you have a Proxy object:
+     *
+     *     let fooProxyFactory = RpcProxyFactory<Foo>('/foo')
+     *     let fooProxy = fooProxyFactory.createProxy()
+     *
+     * accessing `fooProxy.bar` will return a callable that, when called,
+     * executes a RPC method call to method `bar`.  Therefore, doing
+     * `fooProxy.bar()` will call the `bar` method on the remote Foo object.
+     *
+     * @param target - unused.
+     * @param p - The property accessed on the Proxy object.
+     * @param receiver - unused.
+     * @returns A callable that executes the RPC call.
+     */
+    get(target: T, p: PropertyKey, receiver: any): any;
+    /**
+     * Return whether the given property represents a notification.
+     *
+     * A property leads to a notification rather than a method call if its name
+     * begins with `notify` or `on`.
+     *
+     * @param p - The property being called on the proxy.
+     * @return Whether `p` represents a notification.
+     */
+    protected isNotification(p: PropertyKey): boolean;
+    protected serializeError(e: any): any;
+    protected deserializeError(capturedError: Error, e: any): any;
+}
+/**
+ * @deprecated since 1.39.0 use `RpcConnectionEventEmitter` instead
+ */
+export type JsonRpcConnectionEventEmitter = RpcConnectionEventEmitter;
+/**
+ * @deprecated since 1.39.0 use `RpcServer` instead
+ */
+export type JsonRpcServer<Client> = RpcServer<Client>;
+/**
+ * @deprecated since 1.39.0 use `RpcProxy` instead
+ */
+export type JsonRpcProxy<T> = RpcProxy<T>;
+/**
+ * @deprecated since 1.39.0 use `RpcConnectionHandler` instead
+ */
+export declare class JsonRpcConnectionHandler<T extends object> extends RpcConnectionHandler<T> {
+}
+/**
+ * @deprecated since 1.39.0 use `RpcProxyFactory` instead
+ */
+export declare class JsonRpcProxyFactory<T extends object> extends RpcProxyFactory<T> {
+}
+//# sourceMappingURL=proxy-factory.d.ts.map

package/lib/common/messaging/proxy-factory.d.ts.map

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