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

package/lib/node/messaging/ipc-bootstrap.js

@@ -0,0 +1,25 @@
+"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 });
+require("reflect-metadata");
+const dynamic_require_1 = require("../dynamic-require");
+const ipc_channel_1 = require("./ipc-channel");
+const ipc_protocol_1 = require("./ipc-protocol");
+(0, ipc_protocol_1.checkParentAlive)();
+const entryPoint = ipc_protocol_1.IPCEntryPoint.getScriptFromEnv();
+(0, dynamic_require_1.dynamicRequire)(entryPoint).default(new ipc_channel_1.IPCChannel());
+//# sourceMappingURL=ipc-bootstrap.js.map

package/lib/node/messaging/ipc-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-bootstrap.js","sourceRoot":"","sources":["../../../src/node/messaging/ipc-bootstrap.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,4BAA0B;AAC1B,wDAAoD;AACpD,+CAA2C;AAC3C,iDAAiE;AAEjE,IAAA,+BAAgB,GAAE,CAAC;AAEnB,MAAM,UAAU,GAAG,4BAAa,CAAC,gBAAgB,EAAE,CAAC;AAEpD,IAAA,gCAAc,EAA6B,UAAU,CAAC,CAAC,OAAO,CAAC,IAAI,wBAAU,EAAE,CAAC,CAAC"}

package/lib/node/messaging/ipc-channel.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import * as cp from 'child_process';
+import { AbstractChannel, WriteBuffer } from '../../common';
+import { BinaryMessagePipe } from './binary-message-pipe';
+/**
+ * A {@link Channel} to send messages between two processes using a dedicated pipe/fd for binary messages.
+ * This fd is opened as 5th channel in addition to the default stdios (stdin, stdout, stderr, ipc). This means the default channels
+ * are not blocked and can be used by the respective process for additional custom message handling.
+ */
+export declare class IPCChannel extends AbstractChannel {
+    protected messagePipe: BinaryMessagePipe;
+    protected ipcErrorListener: (error: Error) => void;
+    constructor(childProcess?: cp.ChildProcess);
+    protected setupChildProcess(childProcess: cp.ChildProcess): void;
+    protected setupProcess(): void;
+    getWriteBuffer(): WriteBuffer;
+}
+//# sourceMappingURL=ipc-channel.d.ts.map

package/lib/node/messaging/ipc-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-channel.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/ipc-channel.ts"],"names":[],"mappings":";AAiBA,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAc,WAAW,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAE3C,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAEzC,SAAS,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAA4C;gBAElF,YAAY,CAAC,EAAE,EAAE,CAAC,YAAY;IAY1C,SAAS,CAAC,iBAAiB,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,GAAG,IAAI;IAUhE,SAAS,CAAC,YAAY,IAAI,IAAI;IAU9B,cAAc,IAAI,WAAW;CAShC"}

package/lib/node/messaging/ipc-channel.js

@@ -0,0 +1,70 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2022 STMicroelectronics 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
+// *****************************************************************************
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IPCChannel = void 0;
+const net_1 = require("net");
+const common_1 = require("../../common");
+const uint8_array_message_buffer_1 = require("../../common/message-rpc/uint8-array-message-buffer");
+const binary_message_pipe_1 = require("./binary-message-pipe");
+/**
+ * A {@link Channel} to send messages between two processes using a dedicated pipe/fd for binary messages.
+ * This fd is opened as 5th channel in addition to the default stdios (stdin, stdout, stderr, ipc). This means the default channels
+ * are not blocked and can be used by the respective process for additional custom message handling.
+ */
+class IPCChannel extends common_1.AbstractChannel {
+    constructor(childProcess) {
+        super();
+        this.ipcErrorListener = error => this.onErrorEmitter.fire(error);
+        if (childProcess) {
+            this.setupChildProcess(childProcess);
+        }
+        else {
+            this.setupProcess();
+        }
+        this.messagePipe.onMessage(message => {
+            this.onMessageEmitter.fire(() => new uint8_array_message_buffer_1.Uint8ArrayReadBuffer(message));
+        });
+    }
+    setupChildProcess(childProcess) {
+        childProcess.once('exit', code => this.onCloseEmitter.fire({ reason: 'Child process has been terminated', code: code !== null && code !== void 0 ? code : undefined }));
+        this.messagePipe = new binary_message_pipe_1.BinaryMessagePipe(childProcess.stdio[4]);
+        childProcess.on('error', this.ipcErrorListener);
+        this.toDispose.push(common_1.Disposable.create(() => {
+            childProcess.removeListener('error', this.ipcErrorListener);
+            this.messagePipe.dispose();
+        }));
+    }
+    setupProcess() {
+        process.once('beforeExit', code => this.onCloseEmitter.fire({ reason: 'Process is about to be terminated', code }));
+        this.messagePipe = new binary_message_pipe_1.BinaryMessagePipe(new net_1.Socket({ fd: 4 }));
+        process.on('uncaughtException', this.ipcErrorListener);
+        this.toDispose.push(common_1.Disposable.create(() => {
+            process.removeListener('uncaughtException', this.ipcErrorListener);
+            this.messagePipe.dispose();
+        }));
+    }
+    getWriteBuffer() {
+        const result = new uint8_array_message_buffer_1.Uint8ArrayWriteBuffer();
+        result.onCommit(buffer => {
+            this.messagePipe.send(buffer);
+        });
+        return result;
+    }
+}
+exports.IPCChannel = IPCChannel;
+//# sourceMappingURL=ipc-channel.js.map

package/lib/node/messaging/ipc-channel.js.map

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

package/lib/node/messaging/ipc-connection-provider.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as cp from 'child_process';
+import { Channel, ConnectionErrorHandler, Disposable, ILogger } from '../../common';
+export interface ResolvedIPCConnectionOptions {
+    readonly serverName: string;
+    readonly entryPoint: string;
+    readonly logger: ILogger;
+    readonly args: string[];
+    readonly errorHandler?: ConnectionErrorHandler;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export type IPCConnectionOptions = Partial<ResolvedIPCConnectionOptions> & {
+    readonly serverName: string;
+    readonly entryPoint: string;
+};
+export declare class IPCConnectionProvider {
+    protected readonly logger: ILogger;
+    listen(options: IPCConnectionOptions, acceptor: (connection: Channel) => void): Disposable;
+    protected doListen(options: ResolvedIPCConnectionOptions, acceptor: (connection: Channel) => void): Disposable;
+    protected fork(options: ResolvedIPCConnectionOptions): cp.ChildProcess;
+}
+//# sourceMappingURL=ipc-connection-provider.d.ts.map

package/lib/node/messaging/ipc-connection-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-connection-provider.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/ipc-connection-provider.ts"],"names":[],"mappings":";;AAgBA,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AAIpC,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAwB,OAAO,EAAE,MAAM,cAAc,CAAC;AAI1G,MAAM,WAAW,4BAA4B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAA;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CACnC;AACD,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,4BAA4B,CAAC,GAAG;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC9B,CAAC;AAEF,qBACa,qBAAqB;IAG9B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEnC,MAAM,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,GAAG,UAAU;IAQ1F,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,GAAG,UAAU;IA4B9G,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,4BAA4B,GAAG,EAAE,CAAC,YAAY;CA2BzE"}

package/lib/node/messaging/ipc-connection-provider.js

@@ -0,0 +1,93 @@
+"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.IPCConnectionProvider = void 0;
+const tslib_1 = require("tslib");
+const cp = require("child_process");
+const inversify_1 = require("inversify");
+const path = require("path");
+const readline_1 = require("readline");
+const common_1 = require("../../common");
+const ipc_channel_1 = require("./ipc-channel");
+const ipc_protocol_1 = require("./ipc-protocol");
+let IPCConnectionProvider = class IPCConnectionProvider {
+    listen(options, acceptor) {
+        return this.doListen({
+            logger: this.logger,
+            args: [],
+            ...options
+        }, acceptor);
+    }
+    doListen(options, acceptor) {
+        const childProcess = this.fork(options);
+        const channel = new ipc_channel_1.IPCChannel(childProcess);
+        const toStop = new common_1.DisposableCollection();
+        const toCancelStop = toStop.push(common_1.Disposable.create(() => childProcess.kill()));
+        const errorHandler = options.errorHandler;
+        if (errorHandler) {
+            let errorCount = 0;
+            channel.onError((err) => {
+                errorCount++;
+                if (errorHandler.shouldStop(err, errorCount)) {
+                    toStop.dispose();
+                }
+            });
+            channel.onClose(() => {
+                if (toStop.disposed) {
+                    return;
+                }
+                if (errorHandler.shouldRestart()) {
+                    toCancelStop.dispose();
+                    toStop.push(this.doListen(options, acceptor));
+                }
+            });
+        }
+        acceptor(channel);
+        return toStop;
+    }
+    fork(options) {
+        const forkOptions = {
+            env: (0, ipc_protocol_1.createIpcEnv)(options),
+            execArgv: [],
+            // 5th element MUST be 'overlapped' for it to work properly on Windows.
+            // 'overlapped' works just like 'pipe' on non-Windows platforms.
+            // See: https://nodejs.org/docs/latest-v14.x/api/child_process.html#child_process_options_stdio
+            // Note: For some reason `@types/node` does not know about 'overlapped'.
+            stdio: ['pipe', 'pipe', 'pipe', 'ipc', 'overlapped']
+        };
+        const inspectArgPrefix = `--${options.serverName}-inspect`;
+        const inspectArg = process.argv.find(v => v.startsWith(inspectArgPrefix));
+        if (inspectArg !== undefined) {
+            forkOptions.execArgv = ['--nolazy', `--inspect${inspectArg.substring(inspectArgPrefix.length)}`];
+        }
+        const childProcess = cp.fork(path.join(__dirname, 'ipc-bootstrap'), options.args, forkOptions);
+        (0, readline_1.createInterface)(childProcess.stdout).on('line', line => this.logger.info(`[${options.serverName}: ${childProcess.pid}] ${line}`));
+        (0, readline_1.createInterface)(childProcess.stderr).on('line', line => this.logger.error(`[${options.serverName}: ${childProcess.pid}] ${line}`));
+        this.logger.debug(`[${options.serverName}: ${childProcess.pid}] IPC started`);
+        childProcess.once('exit', () => this.logger.debug(`[${options.serverName}: ${childProcess.pid}] IPC exited`));
+        return childProcess;
+    }
+};
+exports.IPCConnectionProvider = IPCConnectionProvider;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.ILogger),
+    tslib_1.__metadata("design:type", Object)
+], IPCConnectionProvider.prototype, "logger", void 0);
+exports.IPCConnectionProvider = IPCConnectionProvider = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], IPCConnectionProvider);
+//# sourceMappingURL=ipc-connection-provider.js.map

package/lib/node/messaging/ipc-connection-provider.js.map

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

package/lib/node/messaging/ipc-protocol.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import { Channel } from '../../common/message-rpc/channel';
+export declare const ipcEntryPoint: string | undefined;
+export type IPCEntryPoint = (connection: Channel) => void;
+export declare namespace IPCEntryPoint {
+    /**
+     * Throws if `THEIA_ENTRY_POINT` is undefined or empty.
+     */
+    function getScriptFromEnv(): string;
+}
+/**
+ * Exit the current process if the parent process is not alive.
+ * Relevant only for some OS, like Windows
+ */
+export declare function checkParentAlive(): void;
+export declare function createIpcEnv(options?: {
+    entryPoint?: string;
+    env?: NodeJS.ProcessEnv;
+}): NodeJS.ProcessEnv;
+//# sourceMappingURL=ipc-protocol.d.ts.map

package/lib/node/messaging/ipc-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-protocol.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/ipc-protocol.ts"],"names":[],"mappings":";AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAK3D,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG,SAA0C,CAAC;AAEhF,MAAM,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;AAC1D,yBAAiB,aAAa,CAAC;IAC3B;;OAEG;IACH,SAAgB,gBAAgB,IAAI,MAAM,CAKzC;CACJ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAevC;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAC1B,GAAG,MAAM,CAAC,UAAU,CAcpB"}

package/lib/node/messaging/ipc-protocol.js

@@ -0,0 +1,69 @@
+"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.createIpcEnv = exports.checkParentAlive = exports.IPCEntryPoint = exports.ipcEntryPoint = void 0;
+const THEIA_PARENT_PID = 'THEIA_PARENT_PID';
+const THEIA_ENTRY_POINT = 'THEIA_ENTRY_POINT';
+exports.ipcEntryPoint = process.env[THEIA_ENTRY_POINT];
+var IPCEntryPoint;
+(function (IPCEntryPoint) {
+    /**
+     * Throws if `THEIA_ENTRY_POINT` is undefined or empty.
+     */
+    function getScriptFromEnv() {
+        if (!exports.ipcEntryPoint) {
+            throw new Error(`"${THEIA_ENTRY_POINT}" is missing from the environment`);
+        }
+        return exports.ipcEntryPoint;
+    }
+    IPCEntryPoint.getScriptFromEnv = getScriptFromEnv;
+})(IPCEntryPoint || (exports.IPCEntryPoint = IPCEntryPoint = {}));
+/**
+ * Exit the current process if the parent process is not alive.
+ * Relevant only for some OS, like Windows
+ */
+function checkParentAlive() {
+    if (process.env[THEIA_PARENT_PID]) {
+        const parentPid = Number(process.env[THEIA_PARENT_PID]);
+        if (typeof parentPid === 'number' && !isNaN(parentPid)) {
+            setInterval(() => {
+                try {
+                    // throws an exception if the main process doesn't exist anymore.
+                    process.kill(parentPid, 0);
+                }
+                catch {
+                    process.exit();
+                }
+            }, 5000).unref(); // we don't want this timeout to keep the process alive
+        }
+    }
+}
+exports.checkParentAlive = checkParentAlive;
+function createIpcEnv(options) {
+    const op = Object.assign({}, options);
+    const childEnv = Object.assign({}, op.env);
+    for (const key of Object.keys(childEnv)) {
+        if (key.startsWith('THEIA_')) {
+            delete childEnv[key];
+        }
+    }
+    childEnv[THEIA_PARENT_PID] = String(process.pid);
+    childEnv[THEIA_ENTRY_POINT] = op.entryPoint;
+    return childEnv;
+}
+exports.createIpcEnv = createIpcEnv;
+//# sourceMappingURL=ipc-protocol.js.map

package/lib/node/messaging/ipc-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-protocol.js","sourceRoot":"","sources":["../../../src/node/messaging/ipc-protocol.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;;;AAIhF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAC5C,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAEjC,QAAA,aAAa,GAAuB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAGhF,IAAiB,aAAa,CAU7B;AAVD,WAAiB,aAAa;IAC1B;;OAEG;IACH,SAAgB,gBAAgB;QAC5B,IAAI,CAAC,qBAAa,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,IAAI,iBAAiB,mCAAmC,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,qBAAa,CAAC;IACzB,CAAC;IALe,8BAAgB,mBAK/B,CAAA;AACL,CAAC,EAVgB,aAAa,6BAAb,aAAa,QAU7B;AAED;;;GAGG;AACH,SAAgB,gBAAgB;IAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAExD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,WAAW,CAAC,GAAG,EAAE;gBACb,IAAI,CAAC;oBACD,iEAAiE;oBACjE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACL,OAAO,CAAC,IAAI,EAAE,CAAC;gBACnB,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,uDAAuD;QAC7E,CAAC;IACL,CAAC;AACL,CAAC;AAfD,4CAeC;AAED,SAAgB,YAAY,CAAC,OAG5B;IACG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjD,QAAQ,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC;IAE5C,OAAO,QAAQ,CAAC;AACpB,CAAC;AAjBD,oCAiBC"}

package/lib/node/messaging/messaging-backend-module.d.ts

@@ -0,0 +1,3 @@
+import { ContainerModule } from 'inversify';
+export declare const messagingBackendModule: ContainerModule;
+//# sourceMappingURL=messaging-backend-module.d.ts.map

package/lib/node/messaging/messaging-backend-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-backend-module.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/messaging-backend-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAa5C,eAAO,MAAM,sBAAsB,iBAsBjC,CAAC"}

package/lib/node/messaging/messaging-backend-module.js

@@ -0,0 +1,53 @@
+"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.messagingBackendModule = void 0;
+const inversify_1 = require("inversify");
+const common_1 = require("../../common");
+// import { BackendApplicationContribution } from '../backend-application';
+const default_messaging_service_1 = require("./default-messaging-service");
+const connection_container_module_1 = require("./connection-container-module");
+const messaging_service_1 = require("./messaging-service");
+const messaging_listeners_1 = require("./messaging-listeners");
+const frontend_connection_service_1 = require("./frontend-connection-service");
+const backend_application_1 = require("../backend-application");
+const connection_management_1 = require("../../common/messaging/connection-management");
+const websocket_frontend_connection_service_1 = require("./websocket-frontend-connection-service");
+const websocket_endpoint_1 = require("./websocket-endpoint");
+exports.messagingBackendModule = new inversify_1.ContainerModule(bind => {
+    (0, common_1.bindContributionProvider)(bind, connection_container_module_1.ConnectionContainerModule);
+    (0, common_1.bindContributionProvider)(bind, messaging_service_1.MessagingService.Contribution);
+    bind(default_messaging_service_1.DefaultMessagingService).toSelf().inSingletonScope();
+    bind(messaging_service_1.MessagingService.Identifier).toService(default_messaging_service_1.DefaultMessagingService);
+    bind(backend_application_1.BackendApplicationContribution).toService(default_messaging_service_1.DefaultMessagingService);
+    bind(default_messaging_service_1.MessagingContainer).toDynamicValue(({ container }) => container).inSingletonScope();
+    bind(websocket_endpoint_1.WebsocketEndpoint).toSelf().inSingletonScope();
+    bind(backend_application_1.BackendApplicationContribution).toService(websocket_endpoint_1.WebsocketEndpoint);
+    bind(websocket_frontend_connection_service_1.WebsocketFrontendConnectionService).toSelf().inSingletonScope();
+    bind(frontend_connection_service_1.FrontendConnectionService).toService(websocket_frontend_connection_service_1.WebsocketFrontendConnectionService);
+    bind(messaging_listeners_1.MessagingListener).toSelf().inSingletonScope();
+    (0, common_1.bindContributionProvider)(bind, messaging_listeners_1.MessagingListenerContribution);
+    bind(common_1.ConnectionHandler).toDynamicValue(context => {
+        const connectionService = context.container.get(frontend_connection_service_1.FrontendConnectionService);
+        return new common_1.RpcConnectionHandler(connection_management_1.connectionCloseServicePath, () => ({
+            markForClose: (channelId) => {
+                connectionService.markForClose(channelId);
+            }
+        }));
+    }).inSingletonScope();
+});
+//# sourceMappingURL=messaging-backend-module.js.map

package/lib/node/messaging/messaging-backend-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-backend-module.js","sourceRoot":"","sources":["../../../src/node/messaging/messaging-backend-module.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,yCAA4C;AAC5C,yCAAiG;AACjG,2EAA2E;AAC3E,2EAA0F;AAC1F,+EAA0E;AAC1E,2DAAuD;AACvD,+DAAyF;AACzF,+EAA0E;AAC1E,gEAAwE;AACxE,wFAA0F;AAC1F,mGAA6F;AAC7F,6DAAyD;AAE5C,QAAA,sBAAsB,GAAG,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IAC7D,IAAA,iCAAwB,EAAC,IAAI,EAAE,uDAAyB,CAAC,CAAC;IAC1D,IAAA,iCAAwB,EAAC,IAAI,EAAE,oCAAgB,CAAC,YAAY,CAAC,CAAC;IAC9D,IAAI,CAAC,mDAAuB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAC1D,IAAI,CAAC,oCAAgB,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,mDAAuB,CAAC,CAAC;IACrE,IAAI,CAAC,oDAA8B,CAAC,CAAC,SAAS,CAAC,mDAAuB,CAAC,CAAC;IACxE,IAAI,CAAC,8CAAkB,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACzF,IAAI,CAAC,sCAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACpD,IAAI,CAAC,oDAA8B,CAAC,CAAC,SAAS,CAAC,sCAAiB,CAAC,CAAC;IAClE,IAAI,CAAC,0EAAkC,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACrE,IAAI,CAAC,uDAAyB,CAAC,CAAC,SAAS,CAAC,0EAAkC,CAAC,CAAC;IAC9E,IAAI,CAAC,uCAAiB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACpD,IAAA,iCAAwB,EAAC,IAAI,EAAE,mDAA6B,CAAC,CAAC;IAE9D,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE;QAC7C,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAqC,uDAAyB,CAAC,CAAC;QAC/G,OAAO,IAAI,6BAAoB,CAAS,kDAA0B,EAAE,GAAG,EAAE,CAAC,CAAC;YACvE,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE;gBAChC,iBAAiB,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC9C,CAAC;SACJ,CAAC,CAAC,CAAC;IACR,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;AAC1B,CAAC,CAAC,CAAC"}

package/lib/node/messaging/messaging-listeners.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" />
+import { ContributionProvider, MaybePromise } from '../../common';
+import { Socket } from 'socket.io';
+import * as http from 'http';
+/**
+ * Bind components to this symbol to subscribe to WebSocket events.
+ */
+export declare const MessagingListenerContribution: unique symbol;
+export interface MessagingListenerContribution {
+    /**
+     * Function invoked when a HTTP connection is upgraded to a websocket.
+     *
+     * @param request The HTTP connection upgrade request received by the server.
+     * @param socket The WebSocket that the connection was upgraded to.
+     */
+    onDidWebSocketUpgrade(request: http.IncomingMessage, socket: Socket): MaybePromise<void>;
+}
+/**
+ * Handler of Theia messaging system events, dispatching to MessagingListenerContribution instances.
+ */
+export declare class MessagingListener {
+    protected readonly messagingListenerContributions: ContributionProvider<MessagingListenerContribution>;
+    /**
+     * Notify all the subscribed `MessagingListenerContribution`s that the Websocket was upgraded.
+     */
+    onDidWebSocketUpgrade(request: http.IncomingMessage, socket: Socket): Promise<void>;
+}
+//# sourceMappingURL=messaging-listeners.d.ts.map

package/lib/node/messaging/messaging-listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-listeners.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/messaging-listeners.ts"],"names":[],"mappings":";AAiBA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,6BAA6B,eAA0C,CAAC;AACrF,MAAM,WAAW,6BAA6B;IAC1C;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED;;GAEG;AACH,qBACa,iBAAiB;IAG1B,SAAS,CAAC,QAAQ,CAAC,8BAA8B,EAAE,oBAAoB,CAAC,6BAA6B,CAAC,CAAC;IAEvG;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5F"}

package/lib/node/messaging/messaging-listeners.js

@@ -0,0 +1,46 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2021 MayStreet Inc. 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.MessagingListener = exports.MessagingListenerContribution = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const common_1 = require("../../common");
+/**
+ * Bind components to this symbol to subscribe to WebSocket events.
+ */
+exports.MessagingListenerContribution = Symbol('MessagingListenerContribution');
+/**
+ * Handler of Theia messaging system events, dispatching to MessagingListenerContribution instances.
+ */
+let MessagingListener = class MessagingListener {
+    /**
+     * Notify all the subscribed `MessagingListenerContribution`s that the Websocket was upgraded.
+     */
+    async onDidWebSocketUpgrade(request, socket) {
+        await Promise.all(Array.from(this.messagingListenerContributions.getContributions(), async (messagingListener) => messagingListener.onDidWebSocketUpgrade(request, socket)));
+    }
+};
+exports.MessagingListener = MessagingListener;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.ContributionProvider),
+    (0, inversify_1.named)(exports.MessagingListenerContribution),
+    tslib_1.__metadata("design:type", Object)
+], MessagingListener.prototype, "messagingListenerContributions", void 0);
+exports.MessagingListener = MessagingListener = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], MessagingListener);
+//# sourceMappingURL=messaging-listeners.js.map

package/lib/node/messaging/messaging-listeners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-listeners.js","sourceRoot":"","sources":["../../../src/node/messaging/messaging-listeners.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,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,yCAAsD;AACtD,yCAAkE;AAKlE;;GAEG;AACU,QAAA,6BAA6B,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAWrF;;GAEG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAK1B;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAA6B,EAAE,MAAc;QACrE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAC,iBAAiB,EAAC,EAAE,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/K,CAAC;CACJ,CAAA;AAXY,8CAAiB;AAGP;IADlB,IAAA,kBAAM,EAAC,6BAAoB,CAAC;IAAE,IAAA,iBAAK,EAAC,qCAA6B,CAAC;;yEACoC;4BAH9F,iBAAiB;IAD7B,IAAA,sBAAU,GAAE;GACA,iBAAiB,CAW7B"}

package/lib/node/messaging/messaging-service.d.ts

@@ -0,0 +1,29 @@
+import { Channel } from '../../common/message-rpc/channel';
+export interface MessagingService {
+    /**
+     * Accept a web socket channel on the given path.
+     * A path supports the route syntax: https://github.com/rcs/route-parser#what-can-i-use-in-my-routes.
+     */
+    registerChannelHandler(path: string, handler: (params: MessagingService.PathParams, channel: Channel) => void): void;
+    /**
+     * Accept a web socket connection on the given path.
+     * A path supports the route syntax: https://github.com/rcs/route-parser#what-can-i-use-in-my-routes.
+     *
+     * #### Important
+     * Prefer using web socket channels over establishing new web socket connection. Clients can handle only limited amount of web sockets
+     * and excessive amount can cause performance degradation. All web socket channels share a single web socket connection.
+     */
+    registerConnectionHandler(path: string, callback: (params: MessagingService.PathParams, mainChannel: Channel) => void): void;
+}
+export declare namespace MessagingService {
+    /** Inversify container identifier for the `MessagingService` component. */
+    const Identifier: unique symbol;
+    interface PathParams {
+        [name: string]: string;
+    }
+    const Contribution: unique symbol;
+    interface Contribution {
+        configure(service: MessagingService): void;
+    }
+}
+//# sourceMappingURL=messaging-service.d.ts.map

package/lib/node/messaging/messaging-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-service.d.ts","sourceRoot":"","sources":["../../../src/node/messaging/messaging-service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACrH;;;;;;;OAOG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAChI;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,2EAA2E;IACpE,MAAM,UAAU,eAA6B,CAAC;IACrD,UAAiB,UAAU;QACvB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB;IACM,MAAM,YAAY,eAA0C,CAAC;IACpE,UAAiB,YAAY;QACzB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;KAC9C;CACJ"}

package/lib/node/messaging/messaging-service.js

@@ -0,0 +1,25 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2018 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.MessagingService = void 0;
+var MessagingService;
+(function (MessagingService) {
+    /** Inversify container identifier for the `MessagingService` component. */
+    MessagingService.Identifier = Symbol('MessagingService');
+    MessagingService.Contribution = Symbol('MessagingService.Contribution');
+})(MessagingService || (exports.MessagingService = MessagingService = {}));
+//# sourceMappingURL=messaging-service.js.map

package/lib/node/messaging/messaging-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-service.js","sourceRoot":"","sources":["../../../src/node/messaging/messaging-service.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;;;AAqBhF,IAAiB,gBAAgB,CAUhC;AAVD,WAAiB,gBAAgB;IAC7B,2EAA2E;IAC9D,2BAAU,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAIxC,6BAAY,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAIxE,CAAC,EAVgB,gBAAgB,gCAAhB,gBAAgB,QAUhC"}

package/lib/node/messaging/test/test-web-socket-channel.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as http from 'http';
+import * as https from 'https';
+import { ServiceConnectionProvider } from '../../../browser/messaging/service-connection-provider';
+export declare class TestWebSocketChannelSetup {
+    readonly connectionProvider: ServiceConnectionProvider;
+    constructor({ server, path }: {
+        server: http.Server | https.Server;
+        path: string;
+    });
+    protected createConnectionProvider(socketUrl: string): ServiceConnectionProvider;
+}
+//# sourceMappingURL=test-web-socket-channel.d.ts.map

package/lib/node/messaging/test/test-web-socket-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-web-socket-channel.d.ts","sourceRoot":"","sources":["../../../../src/node/messaging/test/test-web-socket-channel.ts"],"names":[],"mappings":";;AAiBA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAA4B,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AAkB7H,qBAAa,yBAAyB;IAClC,SAAgB,kBAAkB,EAAE,yBAAyB,CAAC;gBAElD,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACnC,IAAI,EAAE,MAAM,CAAA;KACf;IAWD,SAAS,CAAC,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB;CAOnF"}