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

package/src/electron-main/electron-main-constants.ts

@@ -1,23 +1,23 @@
-// *****************************************************************************
-// Copyright (C) 2022 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
-// *****************************************************************************
-
-export const ElectronMainApplicationGlobals = Symbol('ElectronMainApplicationGlobals');
-export interface ElectronMainApplicationGlobals {
-    readonly THEIA_APP_PROJECT_PATH: string;
-    readonly THEIA_BACKEND_MAIN_PATH: string;
-    readonly THEIA_FRONTEND_HTML_PATH: string;
-    readonly THEIA_SECONDARY_WINDOW_HTML_PATH: string
-}
+// *****************************************************************************
+// Copyright (C) 2022 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
+// *****************************************************************************
+
+export const ElectronMainApplicationGlobals = Symbol('ElectronMainApplicationGlobals');
+export interface ElectronMainApplicationGlobals {
+    readonly THEIA_APP_PROJECT_PATH: string;
+    readonly THEIA_BACKEND_MAIN_PATH: string;
+    readonly THEIA_FRONTEND_HTML_PATH: string;
+    readonly THEIA_SECONDARY_WINDOW_HTML_PATH: string
+}

package/src/electron-main/electron-main-window-service-impl.ts

@@ -1,44 +1,44 @@
-// *****************************************************************************
-// 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 { shell } from '@theia/electron/shared/electron';
-import { injectable, inject } from 'inversify';
-import { ElectronMainWindowService } from '../electron-common/electron-main-window-service';
-import { ElectronMainApplication } from './electron-main-application';
-import { NewWindowOptions, WindowSearchParams } from '../common/window';
-
-@injectable()
-export class ElectronMainWindowServiceImpl implements ElectronMainWindowService {
-
-    @inject(ElectronMainApplication)
-    protected readonly app: ElectronMainApplication;
-
-    openNewWindow(url: string, { external }: NewWindowOptions): undefined {
-        if (external) {
-            shell.openExternal(url);
-        } else {
-            this.app.createWindow().then(electronWindow => {
-                electronWindow.loadURL(url);
-            });
-        }
-        return undefined;
-    }
-
-    openNewDefaultWindow(params?: WindowSearchParams): void {
-        this.app.openDefaultWindow(params);
-    }
-
-}
+// *****************************************************************************
+// 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 { shell } from '@theia/electron/shared/electron';
+import { injectable, inject } from 'inversify';
+import { ElectronMainWindowService } from '../electron-common/electron-main-window-service';
+import { ElectronMainApplication } from './electron-main-application';
+import { NewWindowOptions, WindowSearchParams } from '../common/window';
+
+@injectable()
+export class ElectronMainWindowServiceImpl implements ElectronMainWindowService {
+
+    @inject(ElectronMainApplication)
+    protected readonly app: ElectronMainApplication;
+
+    openNewWindow(url: string, { external }: NewWindowOptions): undefined {
+        if (external) {
+            shell.openExternal(url);
+        } else {
+            this.app.createWindow().then(electronWindow => {
+                electronWindow.loadURL(url);
+            });
+        }
+        return undefined;
+    }
+
+    openNewDefaultWindow(params?: WindowSearchParams): void {
+        this.app.openDefaultWindow(params);
+    }
+
+}

package/src/electron-main/electron-security-token-service.ts

@@ -1,36 +1,36 @@
-// *****************************************************************************
-// 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 { session } from '@theia/electron/shared/electron';
-import { inject, injectable } from 'inversify';
-import { ElectronSecurityToken } from '../electron-common/electron-token';
-
-@injectable()
-export class ElectronSecurityTokenService {
-
-    @inject(ElectronSecurityToken)
-    protected readonly electronSecurityToken: ElectronSecurityToken;
-
-    async setElectronSecurityTokenCookie(url: string): Promise<void> {
-        await session.defaultSession.cookies.set({
-            url,
-            name: ElectronSecurityToken,
-            value: JSON.stringify(this.electronSecurityToken),
-            httpOnly: true,
-            sameSite: 'no_restriction'
-        });
-    }
-}
+// *****************************************************************************
+// 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 { session } from '@theia/electron/shared/electron';
+import { inject, injectable } from 'inversify';
+import { ElectronSecurityToken } from '../electron-common/electron-token';
+
+@injectable()
+export class ElectronSecurityTokenService {
+
+    @inject(ElectronSecurityToken)
+    protected readonly electronSecurityToken: ElectronSecurityToken;
+
+    async setElectronSecurityTokenCookie(url: string): Promise<void> {
+        await session.defaultSession.cookies.set({
+            url,
+            name: ElectronSecurityToken,
+            value: JSON.stringify(this.electronSecurityToken),
+            httpOnly: true,
+            sameSite: 'no_restriction'
+        });
+    }
+}

package/src/electron-main/event-utils.ts

@@ -1,36 +1,36 @@
-// *****************************************************************************
-// Copyright (C) 2022 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 { Disposable, DisposableCollection } from '../common';
-
-/**
- * @param collection If a collection is passed in, the new disposable is added to that collection. Otherwise, the new disposable is returned.
- */
-export function createDisposableListener<K>(
-    emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown, collection: DisposableCollection
-): void;
-export function createDisposableListener<K>(emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown): Disposable;
-export function createDisposableListener<K>(
-    emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown, collection?: DisposableCollection
-): Disposable | void {
-    emitter.on(signal, handler);
-    const disposable = Disposable.create(() => { try { emitter.off(signal, handler); } catch { } });
-    if (collection) {
-        collection.push(disposable);
-    } else {
-        return disposable;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2022 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 { Disposable, DisposableCollection } from '../common';
+
+/**
+ * @param collection If a collection is passed in, the new disposable is added to that collection. Otherwise, the new disposable is returned.
+ */
+export function createDisposableListener<K>(
+    emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown, collection: DisposableCollection
+): void;
+export function createDisposableListener<K>(emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown): Disposable;
+export function createDisposableListener<K>(
+    emitter: NodeJS.EventEmitter, signal: string, handler: (event: K, ...args: unknown[]) => unknown, collection?: DisposableCollection
+): Disposable | void {
+    emitter.on(signal, handler);
+    const disposable = Disposable.create(() => { try { emitter.off(signal, handler); } catch { } });
+    if (collection) {
+        collection.push(disposable);
+    } else {
+        return disposable;
+    }
+}

package/src/electron-main/messaging/electron-connection-handler.ts

@@ -1,21 +1,21 @@
-// *****************************************************************************
-// 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
-// *****************************************************************************
-
-/**
- * Electron-IPC-specific connection handler.
- * Use this if you want to establish communication between the frontend and the electron-main process.
- */
-export const ElectronConnectionHandler = Symbol('ElectronConnectionHandler');
+// *****************************************************************************
+// 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
+// *****************************************************************************
+
+/**
+ * Electron-IPC-specific connection handler.
+ * Use this if you want to establish communication between the frontend and the electron-main process.
+ */
+export const ElectronConnectionHandler = Symbol('ElectronConnectionHandler');

package/src/electron-main/messaging/electron-messaging-contribution.ts

@@ -1,143 +1,143 @@
-// *****************************************************************************
-// 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 { WebContents } from '@theia/electron/shared/electron';
-import { inject, injectable, named, postConstruct } from 'inversify';
-import { ConnectionHandlers } from '../../node/messaging/default-messaging-service';
-import { AbstractChannel, Channel, ChannelMultiplexer, MessageProvider } from '../../common/message-rpc/channel';
-import { ConnectionHandler, ContributionProvider, Emitter, WriteBuffer } from '../../common';
-import { Uint8ArrayReadBuffer, Uint8ArrayWriteBuffer } from '../../common/message-rpc/uint8-array-message-buffer';
-import { TheiaRendererAPI } from '../electron-api-main';
-import { MessagingService } from '../../node';
-import { ElectronMessagingService } from './electron-messaging-service';
-import { ElectronConnectionHandler } from './electron-connection-handler';
-import { ElectronMainApplicationContribution } from '../electron-main-application';
-
-/**
- * This component replicates the role filled by `MessagingContribution` but for Electron.
- * Unlike the WebSocket based implementation, we do not expect to receive
- * connection events. Instead, we'll create channels based on incoming `open`
- * events on the `ipcMain` channel.
- * This component allows communication between renderer process (frontend) and electron main process.
- */
-
-@injectable()
-export class ElectronMessagingContribution implements ElectronMainApplicationContribution, ElectronMessagingService {
-    @inject(ContributionProvider) @named(ElectronMessagingService.Contribution)
-    protected readonly messagingContributions: ContributionProvider<ElectronMessagingService.Contribution>;
-
-    @inject(ContributionProvider) @named(ElectronConnectionHandler)
-    protected readonly connectionHandlers: ContributionProvider<ConnectionHandler>;
-
-    protected readonly channelHandlers = new ConnectionHandlers<Channel>();
-
-    /**
-     * Each electron window has a main channel and its own multiplexer to route multiple client messages the same IPC connection.
-     */
-    protected readonly openChannels = new Map<number, ElectronWebContentChannel>();
-
-    @postConstruct()
-    protected init(): void {
-        TheiaRendererAPI.onIpcData((sender, data) => this.handleIpcEvent(sender, data));
-    }
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ipcChannel(spec: string, callback: (params: any, channel: Channel) => void): void {
-        this.channelHandlers.push(spec, callback);
-    }
-
-    onStart(): void {
-        for (const contribution of this.messagingContributions.getContributions()) {
-            contribution.configure(this);
-        }
-        for (const connectionHandler of this.connectionHandlers.getContributions()) {
-            this.channelHandlers.push(connectionHandler.path, (params, channel) => {
-                connectionHandler.onConnection(channel);
-            });
-        }
-    }
-
-    protected handleIpcEvent(sender: WebContents, data: Uint8Array): void {
-        // Get the multiplexer for a given window id
-        try {
-            const windowChannel = this.openChannels.get(sender.id) ?? this.createWindowChannel(sender);
-            windowChannel.onMessageEmitter.fire(() => new Uint8ArrayReadBuffer(data));
-        } catch (error) {
-            console.error('IPC: Failed to handle message', { error, data });
-        }
-    }
-
-    // Creates a new channel for a given sender/window
-    protected createWindowChannel(sender: Electron.WebContents): ElectronWebContentChannel {
-        const mainChannel = new ElectronWebContentChannel(sender);
-
-        const multiplexer = new ChannelMultiplexer(mainChannel);
-        multiplexer.onDidOpenChannel(openEvent => {
-            const { channel, id } = openEvent;
-            if (this.channelHandlers.route(id, channel)) {
-                console.debug(`Opening channel for service path '${id}'.`);
-                channel.onClose(() => console.debug(`Closing channel on service path '${id}'.`));
-            }
-        });
-        sender.once('did-navigate', () => this.deleteChannel(sender.id, 'Window was refreshed'));
-        sender.once('destroyed', () => this.deleteChannel(sender.id, 'Window was closed'));
-        this.openChannels.set(sender.id, mainChannel);
-        return mainChannel;
-    }
-
-    protected deleteChannel(senderId: number, reason: string): void {
-        const channel = this.openChannels.get(senderId);
-        if (channel) {
-            this.openChannels.delete(senderId);
-            channel.onCloseEmitter.fire({
-                reason: reason
-            });
-        }
-    }
-
-    protected readonly wsHandlers = new ConnectionHandlers();
-
-    registerConnectionHandler(spec: string, callback: (params: MessagingService.PathParams, channel: Channel) => void): void {
-        this.wsHandlers.push(spec, callback);
-    }
-}
-
-/**
- * Used to establish a connection between the ipcMain and the Electron frontend (window).
- * Messages a transferred via electron IPC.
- */
-export class ElectronWebContentChannel extends AbstractChannel {
-
-    // Make the message emitter public so that we can easily forward messages received from the ipcMain.
-    override readonly onMessageEmitter: Emitter<MessageProvider> = new Emitter();
-
-    constructor(protected readonly sender: Electron.WebContents) {
-        super();
-    }
-
-    getWriteBuffer(): WriteBuffer {
-        const writer = new Uint8ArrayWriteBuffer();
-
-        writer.onCommit(buffer => {
-            if (!this.sender.isDestroyed()) {
-                TheiaRendererAPI.sendData(this.sender, buffer);
-            }
-        });
-
-        return writer;
-    }
-
-}
+// *****************************************************************************
+// 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 { WebContents } from '@theia/electron/shared/electron';
+import { inject, injectable, named, postConstruct } from 'inversify';
+import { ConnectionHandlers } from '../../node/messaging/default-messaging-service';
+import { AbstractChannel, Channel, ChannelMultiplexer, MessageProvider } from '../../common/message-rpc/channel';
+import { ConnectionHandler, ContributionProvider, Emitter, WriteBuffer } from '../../common';
+import { Uint8ArrayReadBuffer, Uint8ArrayWriteBuffer } from '../../common/message-rpc/uint8-array-message-buffer';
+import { TheiaRendererAPI } from '../electron-api-main';
+import { MessagingService } from '../../node';
+import { ElectronMessagingService } from './electron-messaging-service';
+import { ElectronConnectionHandler } from './electron-connection-handler';
+import { ElectronMainApplicationContribution } from '../electron-main-application';
+
+/**
+ * This component replicates the role filled by `MessagingContribution` but for Electron.
+ * Unlike the WebSocket based implementation, we do not expect to receive
+ * connection events. Instead, we'll create channels based on incoming `open`
+ * events on the `ipcMain` channel.
+ * This component allows communication between renderer process (frontend) and electron main process.
+ */
+
+@injectable()
+export class ElectronMessagingContribution implements ElectronMainApplicationContribution, ElectronMessagingService {
+    @inject(ContributionProvider) @named(ElectronMessagingService.Contribution)
+    protected readonly messagingContributions: ContributionProvider<ElectronMessagingService.Contribution>;
+
+    @inject(ContributionProvider) @named(ElectronConnectionHandler)
+    protected readonly connectionHandlers: ContributionProvider<ConnectionHandler>;
+
+    protected readonly channelHandlers = new ConnectionHandlers<Channel>();
+
+    /**
+     * Each electron window has a main channel and its own multiplexer to route multiple client messages the same IPC connection.
+     */
+    protected readonly openChannels = new Map<number, ElectronWebContentChannel>();
+
+    @postConstruct()
+    protected init(): void {
+        TheiaRendererAPI.onIpcData((sender, data) => this.handleIpcEvent(sender, data));
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ipcChannel(spec: string, callback: (params: any, channel: Channel) => void): void {
+        this.channelHandlers.push(spec, callback);
+    }
+
+    onStart(): void {
+        for (const contribution of this.messagingContributions.getContributions()) {
+            contribution.configure(this);
+        }
+        for (const connectionHandler of this.connectionHandlers.getContributions()) {
+            this.channelHandlers.push(connectionHandler.path, (params, channel) => {
+                connectionHandler.onConnection(channel);
+            });
+        }
+    }
+
+    protected handleIpcEvent(sender: WebContents, data: Uint8Array): void {
+        // Get the multiplexer for a given window id
+        try {
+            const windowChannel = this.openChannels.get(sender.id) ?? this.createWindowChannel(sender);
+            windowChannel.onMessageEmitter.fire(() => new Uint8ArrayReadBuffer(data));
+        } catch (error) {
+            console.error('IPC: Failed to handle message', { error, data });
+        }
+    }
+
+    // Creates a new channel for a given sender/window
+    protected createWindowChannel(sender: Electron.WebContents): ElectronWebContentChannel {
+        const mainChannel = new ElectronWebContentChannel(sender);
+
+        const multiplexer = new ChannelMultiplexer(mainChannel);
+        multiplexer.onDidOpenChannel(openEvent => {
+            const { channel, id } = openEvent;
+            if (this.channelHandlers.route(id, channel)) {
+                console.debug(`Opening channel for service path '${id}'.`);
+                channel.onClose(() => console.debug(`Closing channel on service path '${id}'.`));
+            }
+        });
+        sender.once('did-navigate', () => this.deleteChannel(sender.id, 'Window was refreshed'));
+        sender.once('destroyed', () => this.deleteChannel(sender.id, 'Window was closed'));
+        this.openChannels.set(sender.id, mainChannel);
+        return mainChannel;
+    }
+
+    protected deleteChannel(senderId: number, reason: string): void {
+        const channel = this.openChannels.get(senderId);
+        if (channel) {
+            this.openChannels.delete(senderId);
+            channel.onCloseEmitter.fire({
+                reason: reason
+            });
+        }
+    }
+
+    protected readonly wsHandlers = new ConnectionHandlers();
+
+    registerConnectionHandler(spec: string, callback: (params: MessagingService.PathParams, channel: Channel) => void): void {
+        this.wsHandlers.push(spec, callback);
+    }
+}
+
+/**
+ * Used to establish a connection between the ipcMain and the Electron frontend (window).
+ * Messages a transferred via electron IPC.
+ */
+export class ElectronWebContentChannel extends AbstractChannel {
+
+    // Make the message emitter public so that we can easily forward messages received from the ipcMain.
+    override readonly onMessageEmitter: Emitter<MessageProvider> = new Emitter();
+
+    constructor(protected readonly sender: Electron.WebContents) {
+        super();
+    }
+
+    getWriteBuffer(): WriteBuffer {
+        const writer = new Uint8ArrayWriteBuffer();
+
+        writer.onCommit(buffer => {
+            if (!this.sender.isDestroyed()) {
+                TheiaRendererAPI.sendData(this.sender, buffer);
+            }
+        });
+
+        return writer;
+    }
+
+}