@hydranium/client-theia 1.0.0-next.10

package/lib/node/abstract-socket-forwarding-connection-handler.js

@@ -0,0 +1,224 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSocketForwardingConnectionHandler = void 0;
+const core_1 = require("@theia/core");
+const channel_1 = require("@theia/core/lib/common/message-rpc/channel");
+const promise_util_1 = require("@theia/core/lib/common/promise-util");
+const inversify_1 = require("@theia/core/shared/inversify");
+const net = __importStar(require("node:net"));
+/**
+ * Cross-head base for the Theia backend half of a protocol head's transport:
+ * it bridges a Theia browser-frontend {@link Channel} to a server's TCP socket
+ * by relaying bytes between the two.
+ *
+ * Theia delivers each frontend connection to a registered `ConnectionHandler`
+ * keyed by its `path`. The handler asks the language server (via a registered
+ * command) for the target server's listening port, opens a `net.Socket` to that
+ * port, and forwards the Theia channel onto the socket. The frontend terminates
+ * the same wire protocol the server speaks, so the backend performs no semantic
+ * re-proxy — it relays bytes only and stays oblivious to the server's method set.
+ *
+ * The single per-head variation — *which* byte forwarder bridges the channel and
+ * the socket — is the abstract {@link forwardToSocketConnection} hook: the GLSP
+ * head plugs in `@eclipse-glsp/theia-integration`'s `SocketConnectionForwarder`,
+ * the data-server head its own `SocketChannelForwarder`. Keeping the forwarder
+ * behind the hook is what lets the data head stay GLSP-free while sharing the
+ * port-discovery + buffer-and-replay race fix + connect orchestration here.
+ */
+let AbstractSocketForwardingConnectionHandler = class AbstractSocketForwardingConnectionHandler {
+    messageService;
+    commandService;
+    // Theia backend `ILogger` — this handler runs in the Theia backend process,
+    // not the spawned language-server process, so the framework `LspLogger`
+    // (which needs the Langium connection/services) is out of reach here.
+    logger;
+    path;
+    portCommand;
+    logComponent;
+    serverName;
+    findPortTimeout;
+    findPortAttempts;
+    connectTimeoutMs;
+    onSocketCreated;
+    constructor(options) {
+        this.path = options.path;
+        this.portCommand = options.portCommand;
+        this.logComponent = options.logComponent;
+        this.serverName = options.serverName;
+        this.findPortTimeout = options.findPortTimeout ?? 500;
+        this.findPortAttempts = options.findPortAttempts ?? -1;
+        this.connectTimeoutMs = options.connectTimeoutMs ?? 10000;
+        this.onSocketCreated = options.onSocketCreated;
+    }
+    onConnection(connection) {
+        this.initializeServerConnection(connection);
+    }
+    async initializeServerConnection(channel) {
+        // RACE FIX: subscribe to `channel.onMessage` synchronously and buffer
+        // every `MessageProvider` until the forwarder is wired. Theia's
+        // `ForwardingChannel.onMessage` is a plain `Emitter` — it does NOT replay
+        // to listeners that subscribe later. Without this buffer, frontend writes
+        // arriving between `onConnection` and the forwarder subscribing (worst
+        // case: the whole `findPort` delay plus the socket connect time) are
+        // dropped silently. A frontend builds its proxy synchronously on the
+        // channel and may send requests immediately, so it reliably hits this
+        // window.
+        const buffered = [];
+        const bufferSub = channel.onMessage(provider => buffered.push(provider));
+        try {
+            const port = await this.findPort();
+            this.logger.info(`[${this.logComponent}] Connecting to ${this.serverName} on port ${port}...`);
+            await this.connectToServer(channel, port, { bufferSub, buffered });
+            this.logger.info(`[${this.logComponent}] Connected to ${this.serverName} on port ${port}.`);
+        }
+        catch (error) {
+            bufferSub.dispose();
+            const message = error && typeof error === 'object' && 'message' in error ? String(error.message) : String(error);
+            this.logger.error(`[${this.logComponent}] Could not connect to ${this.serverName}: ${message}`);
+            this.messageService.error(`Could not connect to ${this.serverName}: ` + message);
+        }
+    }
+    async findPort() {
+        const pendingContent = new promise_util_1.Deferred();
+        let counter = 0;
+        const tryQueryingPort = () => {
+            setTimeout(async () => {
+                try {
+                    const port = await this.commandService.executeCommand(this.portCommand);
+                    if (port) {
+                        pendingContent.resolve(port);
+                    }
+                }
+                catch (error) {
+                    counter++;
+                    if (this.findPortAttempts >= 0 && counter > this.findPortAttempts) {
+                        pendingContent.reject(error);
+                    }
+                    else {
+                        tryQueryingPort();
+                    }
+                }
+            }, this.findPortTimeout);
+        };
+        tryQueryingPort();
+        return pendingContent.promise;
+    }
+    async connectToServer(channel, port, preForwardBuffer) {
+        const connected = new promise_util_1.Deferred();
+        const socket = new net.Socket();
+        this.onSocketCreated?.(socket);
+        socket.on('ready', () => connected.resolve());
+        socket.on('close', () => connected.reject(`Socket to ${this.serverName} was closed.`));
+        socket.on('error', error => this.logger.error(`Error occurred with the ${this.serverName} socket: ${error.name}; ${error.message}`));
+        // Synchronous hand-off: dispose the pre-forward buffer FIRST, then wire the
+        // forwarder, then replay buffered messages. The event loop cannot
+        // interleave between these synchronous statements, so no message is both
+        // buffered AND forwarded (no double delivery), and none arriving this tick
+        // slips through without a subscriber.
+        preForwardBuffer?.bufferSub.dispose();
+        this.forwardToSocketConnection(channel, socket);
+        if (preForwardBuffer && preForwardBuffer.buffered.length > 0) {
+            this.replayBufferedMessages(channel, preForwardBuffer.buffered);
+        }
+        if (channel instanceof channel_1.ForwardingChannel) {
+            socket.on('error', error => channel.onErrorEmitter.fire(error));
+        }
+        socket.connect({ port });
+        setTimeout(() => connected.reject('Timeout reached.'), this.connectTimeoutMs);
+        return connected.promise;
+    }
+    /**
+     * Re-fire pre-forward buffered `MessageProvider`s on the channel's internal
+     * `onMessageEmitter` so the now-subscribed forwarder picks them up in arrival
+     * order. `MessageProvider` is a thunk (`() => ReadBuffer`) — buffering does
+     * not consume the read position, so replay produces the same bytes the
+     * forwarder would have seen if wired earlier.
+     *
+     * `AbstractChannel.onMessageEmitter` is `protected` in `@theia/core` but
+     * reachable at runtime; the cast is the workaround. A future Theia rename
+     * surfaces as a clear warning here.
+     */
+    replayBufferedMessages(channel, buffered) {
+        if (!(channel instanceof channel_1.ForwardingChannel)) {
+            this.logger.warn(`[${this.logComponent}] dropping ${buffered.length} pre-forward message(s) — channel is not a ForwardingChannel`);
+            return;
+        }
+        const internals = channel;
+        if (!internals.onMessageEmitter) {
+            this.logger.warn(`[${this.logComponent}] dropping ${buffered.length} pre-forward message(s) — ForwardingChannel.onMessageEmitter not accessible`);
+            return;
+        }
+        this.logger.info(`[${this.logComponent}] replaying ${buffered.length} pre-forward message(s) onto the wired socket forwarder`);
+        for (const provider of buffered) {
+            internals.onMessageEmitter.fire(provider);
+        }
+    }
+};
+exports.AbstractSocketForwardingConnectionHandler = AbstractSocketForwardingConnectionHandler;
+__decorate([
+    (0, inversify_1.inject)(core_1.MessageService),
+    __metadata("design:type", core_1.MessageService)
+], AbstractSocketForwardingConnectionHandler.prototype, "messageService", void 0);
+__decorate([
+    (0, inversify_1.inject)(core_1.CommandService),
+    __metadata("design:type", Object)
+], AbstractSocketForwardingConnectionHandler.prototype, "commandService", void 0);
+__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    __metadata("design:type", Object)
+], AbstractSocketForwardingConnectionHandler.prototype, "logger", void 0);
+exports.AbstractSocketForwardingConnectionHandler = AbstractSocketForwardingConnectionHandler = __decorate([
+    (0, inversify_1.injectable)(),
+    __metadata("design:paramtypes", [Object])
+], AbstractSocketForwardingConnectionHandler);
+//# sourceMappingURL=abstract-socket-forwarding-connection-handler.js.map

package/lib/node/abstract-socket-forwarding-connection-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-socket-forwarding-connection-handler.js","sourceRoot":"","sources":["../../src/node/abstract-socket-forwarding-connection-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElF,sCAQqB;AACrB,wEAA+E;AAC/E,sEAA+D;AAC/D,4DAAkE;AAClE,8CAAgC;AA8BhC;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAe,yCAAyC,GAAxD,MAAe,yCAAyC;IAC1B,cAAc,CAAkB;IAChC,cAAc,CAAkB;IAClE,4EAA4E;IAC5E,wEAAwE;IACxE,sEAAsE;IAClC,MAAM,CAAW;IAE5C,IAAI,CAAS;IAEH,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,UAAU,CAAS;IACnB,eAAe,CAAS;IACxB,gBAAgB,CAAS;IACzB,gBAAgB,CAAS;IACzB,eAAe,CAAgC;IAElE,YAAY,OAAiD;QAC1D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,GAAG,CAAC;QACtD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;QAC1D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,UAAmB;QAC7B,IAAI,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAES,KAAK,CAAC,0BAA0B,CAAC,OAAgB;QACxD,sEAAsE;QACtE,gEAAgE;QAChE,0EAA0E;QAC1E,0EAA0E;QAC1E,uEAAuE;QACvE,qEAAqE;QACrE,qEAAqE;QACrE,sEAAsE;QACtE,UAAU;QACV,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,mBAAmB,IAAI,CAAC,UAAU,YAAY,IAAI,KAAK,CAAC,CAAC;YAC/F,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,kBAAkB,IAAI,CAAC,UAAU,YAAY,IAAI,GAAG,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,YAAY,0BAA0B,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;YAChG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,UAAU,IAAI,GAAG,OAAO,CAAC,CAAC;QACpF,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,QAAQ;QACrB,MAAM,cAAc,GAAG,IAAI,uBAAQ,EAAU,CAAC;QAC9C,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,eAAe,GAAG,GAAS,EAAE;YAChC,UAAU,CAAC,KAAK,IAAI,EAAE;gBACnB,IAAI,CAAC;oBACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAS,IAAI,CAAC,WAAW,CAAC,CAAC;oBAChF,IAAI,IAAI,EAAE,CAAC;wBACR,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAChC,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACd,OAAO,EAAE,CAAC;oBACV,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;wBACjE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChC,CAAC;yBAAM,CAAC;wBACL,eAAe,EAAE,CAAC;oBACrB,CAAC;gBACJ,CAAC;YACJ,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,CAAC,CAAC;QACF,eAAe,EAAE,CAAC;QAClB,OAAO,cAAc,CAAC,OAAO,CAAC;IACjC,CAAC;IAES,KAAK,CAAC,eAAe,CAC5B,OAAgB,EAChB,IAAY,EACZ,gBAAyE;QAEzE,MAAM,SAAS,GAAG,IAAI,uBAAQ,EAAQ,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,UAAU,cAAc,CAAC,CAAC,CAAC;QACvF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,UAAU,YAAY,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACrI,4EAA4E;QAC5E,kEAAkE;QAClE,yEAAyE;QACzE,2EAA2E;QAC3E,sCAAsC;QACtC,gBAAgB,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,YAAY,2BAAiB,EAAE,CAAC;YACxC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACzB,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9E,OAAO,SAAS,CAAC,OAAO,CAAC;IAC5B,CAAC;IASD;;;;;;;;;;OAUG;IACO,sBAAsB,CAAC,OAAgB,EAAE,QAA2B;QAC3E,IAAI,CAAC,CAAC,OAAO,YAAY,2BAAiB,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,cAAc,QAAQ,CAAC,MAAM,8DAA8D,CAAC,CAAC;YACnI,OAAO;QACV,CAAC;QACD,MAAM,SAAS,GAAG,OAAsF,CAAC;QACzG,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CACb,IAAI,IAAI,CAAC,YAAY,cAAc,QAAQ,CAAC,MAAM,6EAA6E,CACjI,CAAC;YACF,OAAO;QACV,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,eAAe,QAAQ,CAAC,MAAM,yDAAyD,CAAC,CAAC;QAC/H,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAC/B,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;IACJ,CAAC;CACH,CAAA;AAlJqB,8FAAyC;AAC1B;IAAjC,IAAA,kBAAM,EAAC,qBAAc,CAAC;8BAA4B,qBAAc;iFAAC;AAChC;IAAjC,IAAA,kBAAM,EAAC,qBAAc,CAAC;;iFAA2C;AAI9B;IAAnC,IAAA,kBAAM,EAAC,cAAO,CAAC;;yEAAqC;oDANlC,yCAAyC;IAD9D,IAAA,sBAAU,GAAE;;GACS,yCAAyC,CAkJ9D"}

package/lib/node/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './abstract-socket-forwarding-connection-handler';
+//# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,iDAAiD,CAAC"}

package/lib/node/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./abstract-socket-forwarding-connection-handler"), exports);
+//# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,kFAAgE"}

package/lib/testing/index.d.ts

@@ -0,0 +1,11 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './stub-output-channel';
+export * from './stub-inversify-context';
+//# sourceMappingURL=index.d.ts.map

package/lib/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/lib/testing/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Subpath barrel for `@hydranium/client-theia/testing` — cross-head Theia
+// test doubles (`makeStubOutputChannelManager`, `makeStubInversifyContext`).
+__exportStar(require("./stub-output-channel"), exports);
+__exportStar(require("./stub-inversify-context"), exports);
+//# sourceMappingURL=index.js.map

package/lib/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,0EAA0E;AAC1E,6EAA6E;AAE7E,wDAAsC;AACtC,2DAAyC"}

package/lib/testing/stub-inversify-context.d.ts

@@ -0,0 +1,15 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type interfaces } from '@theia/core/shared/inversify';
+/** Builds the minimal slice of an Inversify Context needed by
+ *  `getRequestParentName`: just the `currentRequest.parentRequest.bindings[0].implementationType.name`
+ *  shape. Tests pass the desired parent class name (or undefined) and receive a
+ *  cast context for the helper to walk. */
+export declare function makeStubInversifyContext(parentClassName?: string): interfaces.Context;
+//# sourceMappingURL=stub-inversify-context.d.ts.map

package/lib/testing/stub-inversify-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-inversify-context.d.ts","sourceRoot":"","sources":["../../src/testing/stub-inversify-context.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;2CAG2C;AAC3C,wBAAgB,wBAAwB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAgBrF"}

package/lib/testing/stub-inversify-context.js

@@ -0,0 +1,32 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeStubInversifyContext = makeStubInversifyContext;
+/** Builds the minimal slice of an Inversify Context needed by
+ *  `getRequestParentName`: just the `currentRequest.parentRequest.bindings[0].implementationType.name`
+ *  shape. Tests pass the desired parent class name (or undefined) and receive a
+ *  cast context for the helper to walk. */
+function makeStubInversifyContext(parentClassName) {
+    const parentRequest = parentClassName === undefined
+        ? null
+        : {
+            bindings: [
+                {
+                    implementationType: parentClassName === '' ? {} : { name: parentClassName }
+                }
+            ]
+        };
+    return {
+        currentRequest: {
+            parentRequest
+        }
+    };
+}
+//# sourceMappingURL=stub-inversify-context.js.map

package/lib/testing/stub-inversify-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-inversify-context.js","sourceRoot":"","sources":["../../src/testing/stub-inversify-context.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAQlF,4DAgBC;AApBD;;;2CAG2C;AAC3C,SAAgB,wBAAwB,CAAC,eAAwB;IAC9D,MAAM,aAAa,GAChB,eAAe,KAAK,SAAS;QAC1B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC;YACG,QAAQ,EAAE;gBACP;oBACG,kBAAkB,EAAE,eAAe,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;iBAC7E;aACH;SACH,CAAC;IACV,OAAO;QACJ,cAAc,EAAE;YACb,aAAa;SACf;KAC8B,CAAC;AACtC,CAAC"}

package/lib/testing/stub-output-channel.d.ts

@@ -0,0 +1,25 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/** Minimal fake `OutputChannel` that captures appended lines into an array. */
+export interface StubOutputChannel {
+    readonly name: string;
+    readonly lines: string[];
+    appendLine(line: string): void;
+}
+/**
+ * Minimal fake `OutputChannelManager` handing out {@link StubOutputChannel}s.
+ * Use in unit tests of `ChannelLogger` (and its subclasses) and of any consumer
+ * that injects an output channel.
+ */
+export interface StubOutputChannelManager {
+    readonly channels: ReadonlyMap<string, StubOutputChannel>;
+    getChannel(name: string): StubOutputChannel;
+}
+export declare function makeStubOutputChannelManager(): StubOutputChannelManager;
+//# sourceMappingURL=stub-output-channel.d.ts.map

package/lib/testing/stub-output-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-output-channel.d.ts","sourceRoot":"","sources":["../../src/testing/stub-output-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC9C;AAED,wBAAgB,4BAA4B,IAAI,wBAAwB,CAoBvE"}

package/lib/testing/stub-output-channel.js

@@ -0,0 +1,33 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeStubOutputChannelManager = makeStubOutputChannelManager;
+function makeStubOutputChannelManager() {
+    const channels = new Map();
+    return {
+        channels,
+        getChannel(name) {
+            let channel = channels.get(name);
+            if (!channel) {
+                const lines = [];
+                channel = {
+                    name,
+                    lines,
+                    appendLine(line) {
+                        lines.push(line);
+                    }
+                };
+                channels.set(name, channel);
+            }
+            return channel;
+        }
+    };
+}
+//# sourceMappingURL=stub-output-channel.js.map

package/lib/testing/stub-output-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-output-channel.js","sourceRoot":"","sources":["../../src/testing/stub-output-channel.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAmBlF,oEAoBC;AApBD,SAAgB,4BAA4B;IACzC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,OAAO;QACJ,QAAQ;QACR,UAAU,CAAC,IAAY;YACpB,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,OAAO,GAAG;oBACP,IAAI;oBACJ,KAAK;oBACL,UAAU,CAAC,IAAY;wBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;iBACH,CAAC;gBACF,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,OAAO,CAAC;QAClB,CAAC;KACH,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@hydranium/client-theia",
+  "version": "1.0.0-next.10",
+  "description": "Cross-head Theia client primitives shared by the hydranium protocol heads. Provides the socket-forwarding connection-handler base that the data-server and GLSP Theia integrations subclass, plus the preference-driven Output-channel logger; carries no head-specific dependency.",
+  "keywords": [
+    "hydranium",
+    "langium",
+    "language-server",
+    "lsp",
+    "theia"
+  ],
+  "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/client-theia",
+  "bugs": {
+    "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-emfcloud/hydranium.git",
+    "directory": "packages/client-theia"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./browser": {
+      "types": "./lib/browser/index.d.ts",
+      "default": "./lib/browser/index.js"
+    },
+    "./lib/browser": {
+      "types": "./lib/browser/index.d.ts",
+      "default": "./lib/browser/index.js"
+    },
+    "./node": {
+      "types": "./lib/node/index.d.ts",
+      "default": "./lib/node/index.js"
+    },
+    "./lib/node": {
+      "types": "./lib/node/index.d.ts",
+      "default": "./lib/node/index.js"
+    },
+    "./testing": {
+      "types": "./lib/testing/index.d.ts",
+      "default": "./lib/testing/index.js"
+    },
+    "./lib/testing": {
+      "types": "./lib/testing/index.d.ts",
+      "default": "./lib/testing/index.js"
+    }
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "lint": "eslint src test --max-warnings 0",
+    "prepack": "node -e \"const m=require('./package.json'),fs=require('node:fs');const missing=[m.main,...Object.values(m.bin||{})].filter(entry=>entry&&!fs.existsSync(entry));if(missing.length){console.error('prepack '+m.name+': not built ('+missing.join(', ')+' missing). Run the build before packing: a files entry that matches nothing is skipped silently, so the tarball would ship src only.');process.exit(1);}\"",
+    "test": "npm run typecheck:test && vitest run",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "watch": "tsc -b -w --preserveWatchOutput"
+  },
+  "devDependencies": {
+    "@hydranium/protocol": "1.0.0-next.10",
+    "@theia/core": "^1.71.0",
+    "@theia/output": "^1.71.0",
+    "@types/node": "^22.0.0",
+    "inversify": "6.2.2",
+    "reflect-metadata": "0.2.2",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "@hydranium/protocol": "1.0.0-next.10",
+    "@theia/core": "^1.71.0",
+    "@theia/output": "^1.71.0",
+    "inversify": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "//prepack": "The publish guard, and it deliberately is NOT a `prepare`: npm runs a workspace `prepare` BEFORE the root `postinstall` that applies patches/vscode-jsonrpc+9.0.1.patch, so building there fails on a cold clone and npm rolls the entire install back. `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. It FAILS rather than rebuilds, because the rebuild is exactly the part that ordering defeats. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error."
+}

package/src/browser/browser-capture.ts

@@ -0,0 +1,75 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+/*
+ * Browser-origin capture — what page JS can reach without DevTools attached (it
+ * cannot start a V8 CPU/heap profile). Produces a single-point renderer-runtime
+ * report (memory, source-graded). The shared report shape lives in
+ * `@hydranium/protocol` so this live capture and the Playwright CDP bridge produce
+ * the SAME `browser-runtime.json`. The main-thread timeline is an e2e-only signal,
+ * captured by the CDP bridge; deep renderer CPU/heap profiling stays a manual
+ * DevTools activity.
+ */
+
+import type { BrowserRuntimeReport } from '@hydranium/protocol';
+
+interface MemoryCapablePerformance {
+   measureUserAgentSpecificMemory?: () => Promise<{ bytes: number; breakdown: unknown }>;
+   memory?: { usedJSHeapSize: number; totalJSHeapSize: number; jsHeapSizeLimit: number };
+}
+
+/**
+ * Capture the renderer runtime as a single-point {@link BrowserRuntimeReport}
+ * (`after`-only — the live gauge read). Prefers the standardized
+ * `performance.measureUserAgentSpecificMemory()` (precise, by type + container, but
+ * requires cross-origin isolation and is rate-limited), falling back to Chrome's
+ * coarse `performance.memory` (JS-heap gauge), then to `unavailable`. The two-point
+ * CDP source (`nodes`/`jsEventListeners`/… + delta) is the e2e bridge's job.
+ */
+export async function captureBrowserRuntime(): Promise<BrowserRuntimeReport> {
+   const perf = globalThis.performance as (Performance & MemoryCapablePerformance) | undefined;
+   if (perf?.measureUserAgentSpecificMemory) {
+      try {
+         const result = await perf.measureUserAgentSpecificMemory();
+         return { source: 'measureUserAgentSpecificMemory', after: { totalBytes: result.bytes, breakdown: result.breakdown } };
+      } catch {
+         // COI missing or rate-limited — fall through to the coarse fallback.
+      }
+   }
+   if (perf?.memory) {
+      return {
+         source: 'performance.memory',
+         after: {
+            jsHeapUsedBytes: perf.memory.usedJSHeapSize,
+            jsHeapTotalBytes: perf.memory.totalJSHeapSize,
+            jsHeapLimitBytes: perf.memory.jsHeapSizeLimit
+         }
+      };
+   }
+   return { source: 'unavailable', after: {} };
+}
+
+function mb(bytes: number): string {
+   return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+/** Render a {@link BrowserRuntimeReport} as a one-line summary for a channel / toast. */
+export function formatBrowserRuntime(report: BrowserRuntimeReport): string {
+   const { after } = report;
+   if (report.source === 'measureUserAgentSpecificMemory' && after.totalBytes !== undefined) {
+      return `Browser renderer memory (precise): ${mb(after.totalBytes)} total across JS/DOM/workers.`;
+   }
+   if (report.source === 'performance.memory' && after.jsHeapUsedBytes !== undefined) {
+      const used = after.jsHeapUsedBytes;
+      const total = after.jsHeapTotalBytes ?? 0;
+      const limit = after.jsHeapLimitBytes ?? 0;
+      return `Browser JS heap: ${mb(used)} used / ${mb(total)} total / ${mb(limit)} limit (JS heap only, not the full renderer).`;
+   }
+   return 'Browser memory info unavailable (non-Chromium, or performance.memory disabled / cross-origin isolation off).';
+}