@theia/core 1.53.0-next.5 → 1.53.0-next.55

package/src/browser/menu/context-menu-context.ts

@@ -1,41 +1,41 @@
-// *****************************************************************************
-// Copyright (C) 2019 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
-// *****************************************************************************
-
-import { injectable } from 'inversify';
-import { OS } from '../../common/os';
-
-@injectable()
-export class ContextMenuContext {
-
-    protected _altPressed = false;
-    get altPressed(): boolean {
-        return this._altPressed;
-    }
-
-    protected setAltPressed(altPressed: boolean): void {
-        this._altPressed = altPressed;
-    }
-
-    resetAltPressed(): void {
-        this.setAltPressed(false);
-    }
-
-    constructor() {
-        document.addEventListener('keydown', e => this.setAltPressed(e.altKey || (OS.type() !== OS.Type.OSX && e.shiftKey)), true);
-        document.addEventListener('keyup', () => this.resetAltPressed(), true);
-    }
-
-}
+// *****************************************************************************
+// Copyright (C) 2019 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
+// *****************************************************************************
+
+import { injectable } from 'inversify';
+import { OS } from '../../common/os';
+
+@injectable()
+export class ContextMenuContext {
+
+    protected _altPressed = false;
+    get altPressed(): boolean {
+        return this._altPressed;
+    }
+
+    protected setAltPressed(altPressed: boolean): void {
+        this._altPressed = altPressed;
+    }
+
+    resetAltPressed(): void {
+        this.setAltPressed(false);
+    }
+
+    constructor() {
+        document.addEventListener('keydown', e => this.setAltPressed(e.altKey || (OS.type() !== OS.Type.OSX && e.shiftKey)), true);
+        document.addEventListener('keyup', () => this.resetAltPressed(), true);
+    }
+
+}

package/src/browser/messaging/connection-source.ts

@@ -1,26 +1,26 @@
-// *****************************************************************************
-// Copyright (C) 2023 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
-// *****************************************************************************
-
-import { Channel, Event } from '../../common';
-
-export const ConnectionSource = Symbol('ConnectionSource');
-
-/**
- * A ConnectionSource creates a Channel. The channel is valid until it sends a close event.
- */
-export interface ConnectionSource {
-    onConnectionDidOpen: Event<Channel>;
-}
+// *****************************************************************************
+// Copyright (C) 2023 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
+// *****************************************************************************
+
+import { Channel, Event } from '../../common';
+
+export const ConnectionSource = Symbol('ConnectionSource');
+
+/**
+ * A ConnectionSource creates a Channel. The channel is valid until it sends a close event.
+ */
+export interface ConnectionSource {
+    onConnectionDidOpen: Event<Channel>;
+}

package/src/browser/messaging/frontend-id-provider.ts

@@ -1,37 +1,37 @@
-// *****************************************************************************
-// Copyright (C) 2023 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
-// *****************************************************************************
-
-import { injectable } from 'inversify';
-import { generateUuid } from '../../common/uuid';
-
-export const FrontendIdProvider = Symbol('FrontendIdProvider');
-
-/**
- * A FrontendIdProvider computes an id for an instance of the front end that may be reconnected to a back end
- * connection context.
- */
-export interface FrontendIdProvider {
-    getId(): string;
-}
-
-@injectable()
-export class BrowserFrontendIdProvider implements FrontendIdProvider {
-    protected readonly id = generateUuid(); // generate a new id each time we load the application
-
-    getId(): string {
-        return this.id;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2023 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
+// *****************************************************************************
+
+import { injectable } from 'inversify';
+import { generateUuid } from '../../common/uuid';
+
+export const FrontendIdProvider = Symbol('FrontendIdProvider');
+
+/**
+ * A FrontendIdProvider computes an id for an instance of the front end that may be reconnected to a back end
+ * connection context.
+ */
+export interface FrontendIdProvider {
+    getId(): string;
+}
+
+@injectable()
+export class BrowserFrontendIdProvider implements FrontendIdProvider {
+    protected readonly id = generateUuid(); // generate a new id each time we load the application
+
+    getId(): string {
+        return this.id;
+    }
+}

package/src/browser/messaging/index.ts

@@ -1,18 +1,18 @@
-// *****************************************************************************
-// 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
-// *****************************************************************************
-
-export * from './ws-connection-provider';
-export * from './service-connection-provider';
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+export * from './ws-connection-provider';
+export * from './service-connection-provider';

package/src/browser/messaging/messaging-frontend-module.ts

@@ -1,41 +1,41 @@
-// *****************************************************************************
-// 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
-// *****************************************************************************
-
-import { ContainerModule } from 'inversify';
-import { BrowserFrontendIdProvider, FrontendIdProvider } from './frontend-id-provider';
-import { WebSocketConnectionSource } from './ws-connection-source';
-import { LocalConnectionProvider, RemoteConnectionProvider, ServiceConnectionProvider } from './service-connection-provider';
-import { ConnectionSource } from './connection-source';
-import { ConnectionCloseService, connectionCloseServicePath } from '../../common/messaging/connection-management';
-import { WebSocketConnectionProvider } from './ws-connection-provider';
-
-const backendServiceProvider = Symbol('backendServiceProvider');
-
-export const messagingFrontendModule = new ContainerModule(bind => {
-    bind(ConnectionCloseService).toDynamicValue(ctx => WebSocketConnectionProvider.createProxy(ctx.container, connectionCloseServicePath)).inSingletonScope();
-    bind(BrowserFrontendIdProvider).toSelf().inSingletonScope();
-    bind(FrontendIdProvider).toService(BrowserFrontendIdProvider);
-    bind(WebSocketConnectionSource).toSelf().inSingletonScope();
-    bind(backendServiceProvider).toDynamicValue(ctx => {
-        bind(ServiceConnectionProvider).toSelf().inSingletonScope();
-        const container = ctx.container.createChild();
-        container.bind(ConnectionSource).toService(WebSocketConnectionSource);
-        return container.get(ServiceConnectionProvider);
-    }).inSingletonScope();
-    bind(LocalConnectionProvider).toService(backendServiceProvider);
-    bind(RemoteConnectionProvider).toService(backendServiceProvider);
-    bind(WebSocketConnectionProvider).toSelf().inSingletonScope();
-});
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+import { ContainerModule } from 'inversify';
+import { BrowserFrontendIdProvider, FrontendIdProvider } from './frontend-id-provider';
+import { WebSocketConnectionSource } from './ws-connection-source';
+import { LocalConnectionProvider, RemoteConnectionProvider, ServiceConnectionProvider } from './service-connection-provider';
+import { ConnectionSource } from './connection-source';
+import { ConnectionCloseService, connectionCloseServicePath } from '../../common/messaging/connection-management';
+import { WebSocketConnectionProvider } from './ws-connection-provider';
+
+const backendServiceProvider = Symbol('backendServiceProvider');
+
+export const messagingFrontendModule = new ContainerModule(bind => {
+    bind(ConnectionCloseService).toDynamicValue(ctx => WebSocketConnectionProvider.createProxy(ctx.container, connectionCloseServicePath)).inSingletonScope();
+    bind(BrowserFrontendIdProvider).toSelf().inSingletonScope();
+    bind(FrontendIdProvider).toService(BrowserFrontendIdProvider);
+    bind(WebSocketConnectionSource).toSelf().inSingletonScope();
+    bind(backendServiceProvider).toDynamicValue(ctx => {
+        bind(ServiceConnectionProvider).toSelf().inSingletonScope();
+        const container = ctx.container.createChild();
+        container.bind(ConnectionSource).toService(WebSocketConnectionSource);
+        return container.get(ServiceConnectionProvider);
+    }).inSingletonScope();
+    bind(LocalConnectionProvider).toService(backendServiceProvider);
+    bind(RemoteConnectionProvider).toService(backendServiceProvider);
+    bind(WebSocketConnectionProvider).toSelf().inSingletonScope();
+});

package/src/browser/messaging/service-connection-provider.ts

@@ -1,140 +1,140 @@
-// *****************************************************************************
-// Copyright (C) 2020 Ericsson 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
-// *****************************************************************************
-
-import { inject, injectable, interfaces, postConstruct } from 'inversify';
-import { Channel, RpcProxy, RpcProxyFactory } from '../../common';
-import { ChannelMultiplexer } from '../../common/message-rpc/channel';
-import { Deferred } from '../../common/promise-util';
-import { ConnectionSource } from './connection-source';
-
-/**
- * Service id for the local connection provider
- */
-export const LocalConnectionProvider = Symbol('LocalConnectionProvider');
-/**
- * Service id for the remote connection provider
- */
-export const RemoteConnectionProvider = Symbol('RemoteConnectionProvider');
-
-export namespace ServiceConnectionProvider {
-    export type ConnectionHandler = (path: String, channel: Channel) => void;
-}
-
-/**
- * This class manages the channels for remote services in the back end.
- *
- * Since we have the ability to use a remote back end via SSH, we need to distinguish
- * between two types of services: those that will be redirected to the remote back end
- * and those which must remain in the local back end. For example the service that manages
- * the remote ssh connections and port forwarding to the remote instance must remain local
- * while e.g. the file system service will run in the remote back end. For each set
- * of services, we will bind an instance of this class to {@linkcode LocalConnectionProvider}
- * and {@linkcode RemoteConnectionProvider} respectively.
- */
-@injectable()
-export class ServiceConnectionProvider {
-
-    static createProxy<T extends object>(container: interfaces.Container, path: string, arg?: object): RpcProxy<T> {
-        return container.get<ServiceConnectionProvider>(RemoteConnectionProvider).createProxy(path, arg);
-    }
-
-    static createLocalProxy<T extends object>(container: interfaces.Container, path: string, arg?: object): RpcProxy<T> {
-        return container.get<ServiceConnectionProvider>(LocalConnectionProvider).createProxy(path, arg);
-    }
-
-    static createHandler(container: interfaces.Container, path: string, arg?: object): void {
-        const remote = container.get<ServiceConnectionProvider>(RemoteConnectionProvider);
-        const local = container.get<ServiceConnectionProvider>(LocalConnectionProvider);
-        remote.createProxy(path, arg);
-        if (remote !== local) {
-            local.createProxy(path, arg);
-        }
-    }
-
-    protected readonly channelHandlers = new Map<string, ServiceConnectionProvider.ConnectionHandler>();
-
-    /**
-     * Create a proxy object to remote interface of T type
-     * over a web socket connection for the given path and proxy factory.
-     */
-    createProxy<T extends object>(path: string, factory: RpcProxyFactory<T>): RpcProxy<T>;
-    /**
-     * Create a proxy object to remote interface of T type
-     * over a web socket connection for the given path.
-     *
-     * An optional target can be provided to handle
-     * notifications and requests from a remote side.
-     */
-    createProxy<T extends object>(path: string, target?: object): RpcProxy<T>;
-    createProxy<T extends object>(path: string, arg?: object): RpcProxy<T> {
-        const factory = arg instanceof RpcProxyFactory ? arg : new RpcProxyFactory<T>(arg);
-        this.listen(path, (_, c) => factory.listen(c), true);
-        return factory.createProxy();
-    }
-
-    protected channelMultiplexer: ChannelMultiplexer;
-
-    private channelReadyDeferred = new Deferred<void>();
-    protected get channelReady(): Promise<void> {
-        return this.channelReadyDeferred.promise;
-    }
-
-    @postConstruct()
-    init(): void {
-        this.connectionSource.onConnectionDidOpen(channel => this.handleChannelCreated(channel));
-    }
-
-    @inject(ConnectionSource)
-    protected connectionSource: ConnectionSource;
-
-    /**
-     * This method must be invoked by subclasses when they have created the main channel.
-     * @param mainChannel
-     */
-    protected handleChannelCreated(channel: Channel): void {
-        channel.onClose(() => {
-            this.handleChannelClosed(channel);
-        });
-
-        this.channelMultiplexer = new ChannelMultiplexer(channel);
-        this.channelReadyDeferred.resolve();
-        for (const entry of this.channelHandlers.entries()) {
-            this.openChannel(entry[0], entry[1]);
-        }
-    }
-
-    handleChannelClosed(channel: Channel): void {
-        this.channelReadyDeferred = new Deferred();
-    }
-
-    /**
-     * Install a connection handler for the given path.
-     */
-    listen(path: string, handler: ServiceConnectionProvider.ConnectionHandler, reconnect: boolean): void {
-        this.openChannel(path, handler).then(() => {
-            if (reconnect) {
-                this.channelHandlers.set(path, handler);
-            }
-        });
-
-    }
-
-    private async openChannel(path: string, handler: ServiceConnectionProvider.ConnectionHandler): Promise<void> {
-        await this.channelReady;
-        const newChannel = await this.channelMultiplexer.open(path);
-        handler(path, newChannel);
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2020 Ericsson 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
+// *****************************************************************************
+
+import { inject, injectable, interfaces, postConstruct } from 'inversify';
+import { Channel, RpcProxy, RpcProxyFactory } from '../../common';
+import { ChannelMultiplexer } from '../../common/message-rpc/channel';
+import { Deferred } from '../../common/promise-util';
+import { ConnectionSource } from './connection-source';
+
+/**
+ * Service id for the local connection provider
+ */
+export const LocalConnectionProvider = Symbol('LocalConnectionProvider');
+/**
+ * Service id for the remote connection provider
+ */
+export const RemoteConnectionProvider = Symbol('RemoteConnectionProvider');
+
+export namespace ServiceConnectionProvider {
+    export type ConnectionHandler = (path: String, channel: Channel) => void;
+}
+
+/**
+ * This class manages the channels for remote services in the back end.
+ *
+ * Since we have the ability to use a remote back end via SSH, we need to distinguish
+ * between two types of services: those that will be redirected to the remote back end
+ * and those which must remain in the local back end. For example the service that manages
+ * the remote ssh connections and port forwarding to the remote instance must remain local
+ * while e.g. the file system service will run in the remote back end. For each set
+ * of services, we will bind an instance of this class to {@linkcode LocalConnectionProvider}
+ * and {@linkcode RemoteConnectionProvider} respectively.
+ */
+@injectable()
+export class ServiceConnectionProvider {
+
+    static createProxy<T extends object>(container: interfaces.Container, path: string, arg?: object): RpcProxy<T> {
+        return container.get<ServiceConnectionProvider>(RemoteConnectionProvider).createProxy(path, arg);
+    }
+
+    static createLocalProxy<T extends object>(container: interfaces.Container, path: string, arg?: object): RpcProxy<T> {
+        return container.get<ServiceConnectionProvider>(LocalConnectionProvider).createProxy(path, arg);
+    }
+
+    static createHandler(container: interfaces.Container, path: string, arg?: object): void {
+        const remote = container.get<ServiceConnectionProvider>(RemoteConnectionProvider);
+        const local = container.get<ServiceConnectionProvider>(LocalConnectionProvider);
+        remote.createProxy(path, arg);
+        if (remote !== local) {
+            local.createProxy(path, arg);
+        }
+    }
+
+    protected readonly channelHandlers = new Map<string, ServiceConnectionProvider.ConnectionHandler>();
+
+    /**
+     * Create a proxy object to remote interface of T type
+     * over a web socket connection for the given path and proxy factory.
+     */
+    createProxy<T extends object>(path: string, factory: RpcProxyFactory<T>): RpcProxy<T>;
+    /**
+     * Create a proxy object to remote interface of T type
+     * over a web socket connection for the given path.
+     *
+     * An optional target can be provided to handle
+     * notifications and requests from a remote side.
+     */
+    createProxy<T extends object>(path: string, target?: object): RpcProxy<T>;
+    createProxy<T extends object>(path: string, arg?: object): RpcProxy<T> {
+        const factory = arg instanceof RpcProxyFactory ? arg : new RpcProxyFactory<T>(arg);
+        this.listen(path, (_, c) => factory.listen(c), true);
+        return factory.createProxy();
+    }
+
+    protected channelMultiplexer: ChannelMultiplexer;
+
+    private channelReadyDeferred = new Deferred<void>();
+    protected get channelReady(): Promise<void> {
+        return this.channelReadyDeferred.promise;
+    }
+
+    @postConstruct()
+    init(): void {
+        this.connectionSource.onConnectionDidOpen(channel => this.handleChannelCreated(channel));
+    }
+
+    @inject(ConnectionSource)
+    protected connectionSource: ConnectionSource;
+
+    /**
+     * This method must be invoked by subclasses when they have created the main channel.
+     * @param mainChannel
+     */
+    protected handleChannelCreated(channel: Channel): void {
+        channel.onClose(() => {
+            this.handleChannelClosed(channel);
+        });
+
+        this.channelMultiplexer = new ChannelMultiplexer(channel);
+        this.channelReadyDeferred.resolve();
+        for (const entry of this.channelHandlers.entries()) {
+            this.openChannel(entry[0], entry[1]);
+        }
+    }
+
+    handleChannelClosed(channel: Channel): void {
+        this.channelReadyDeferred = new Deferred();
+    }
+
+    /**
+     * Install a connection handler for the given path.
+     */
+    listen(path: string, handler: ServiceConnectionProvider.ConnectionHandler, reconnect: boolean): void {
+        this.openChannel(path, handler).then(() => {
+            if (reconnect) {
+                this.channelHandlers.set(path, handler);
+            }
+        });
+
+    }
+
+    private async openChannel(path: string, handler: ServiceConnectionProvider.ConnectionHandler): Promise<void> {
+        await this.channelReady;
+        const newChannel = await this.channelMultiplexer.open(path);
+        handler(path, newChannel);
+    }
+}