@hydranium/data-client-theia 1.0.0-next.10

package/lib/browser/references-data-service-frontend.js

@@ -0,0 +1,55 @@
+"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.AbstractReferencesDataServiceFrontend = void 0;
+const data_service_frontend_1 = require("./data-service-frontend");
+/**
+ * {@link AbstractDataServiceFrontend} specialised for a server that also
+ * composes the framework {@link ReferenceServerProtocol} fragment. It
+ * implements each reference method as a readiness-gated pass-through —
+ * `await this.ensureConnected()`, then delegate to `this.server` — so an
+ * adopter frontend gets the candidate / resolve / next-name surface without
+ * hand-writing identical one-liner bodies.
+ *
+ * The sibling of `AbstractDiagnosticsDataServiceFrontend`, and the same
+ * shape for the same reason: `this.server` is already a forwarding proxy, but
+ * it queues only on the channel being live, not on the server's `waitForReady`
+ * gate — so the gate has to be interposed per method.
+ *
+ * Extend this instead of {@link AbstractDataServiceFrontend} whenever the
+ * head's `DataServer` registers the reference fragment (typically via a
+ * subclass's `additionalMethods`, since
+ * `REFERENCE_SERVER_PROTOCOL_METHODS` is deliberately NOT part of
+ * `DATA_SERVER_PROTOCOL_METHODS`). The `TServer` bound carries
+ * `ReferenceServerProtocol`, so the delegates are type-checked without casts.
+ *
+ * A frontend needing both fragments extends the diagnostics base and mixes
+ * these three in, or vice versa — TypeScript allows only one base class, so
+ * the two bases are deliberately independent rather than chained. Chaining
+ * them would force every reference-fragment adopter to also carry the
+ * diagnostics surface, which a head that dropped those methods via
+ * `DataServerOptions.excludedMethods` cannot satisfy.
+ */
+class AbstractReferencesDataServiceFrontend extends data_service_frontend_1.AbstractDataServiceFrontend {
+    async findReferenceCandidates(ctx) {
+        await this.ensureConnected();
+        return this.server.findReferenceCandidates(ctx);
+    }
+    async resolveReference(ref) {
+        await this.ensureConnected();
+        return this.server.resolveReference(ref);
+    }
+    async findNextName(args) {
+        await this.ensureConnected();
+        return this.server.findNextName(args);
+    }
+}
+exports.AbstractReferencesDataServiceFrontend = AbstractReferencesDataServiceFrontend;
+//# sourceMappingURL=references-data-service-frontend.js.map

package/lib/browser/references-data-service-frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references-data-service-frontend.js","sourceRoot":"","sources":["../../src/browser/references-data-service-frontend.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAWlF,mEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAsB,qCAKnB,SAAQ,mDAA6C;IAGrD,KAAK,CAAC,uBAAuB,CAAC,GAAqB;QAChD,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAAqB;QACzC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAsB;QACtC,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;CACH;AAtBD,sFAsBC"}

package/lib/browser/workspace-gate.d.ts

@@ -0,0 +1,21 @@
+/********************************************************************************
+ * 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 WorkspaceService } from '@theia/workspace/lib/browser';
+/**
+ * Resolve once a workspace is open (one or more roots present). Resolves
+ * immediately if a workspace is already open, otherwise on the first
+ * `onWorkspaceChanged` that reports roots — the listener disposes itself.
+ *
+ * The common Theia gate for a data-server head: the model-server only starts
+ * once the LSP launches for a workspace, so connecting earlier would hang on
+ * port discovery. Pass the returned promise as
+ * `OpenChannelConnectionOptions.whenReady`.
+ */
+export declare function whenWorkspaceOpen(workspaceService: WorkspaceService): Promise<void>;
+//# sourceMappingURL=workspace-gate.d.ts.map

package/lib/browser/workspace-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-gate.d.ts","sourceRoot":"","sources":["../../src/browser/workspace-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAanF"}

package/lib/browser/workspace-gate.js

@@ -0,0 +1,36 @@
+"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.whenWorkspaceOpen = whenWorkspaceOpen;
+/**
+ * Resolve once a workspace is open (one or more roots present). Resolves
+ * immediately if a workspace is already open, otherwise on the first
+ * `onWorkspaceChanged` that reports roots — the listener disposes itself.
+ *
+ * The common Theia gate for a data-server head: the model-server only starts
+ * once the LSP launches for a workspace, so connecting earlier would hang on
+ * port discovery. Pass the returned promise as
+ * `OpenChannelConnectionOptions.whenReady`.
+ */
+function whenWorkspaceOpen(workspaceService) {
+    const roots = workspaceService.tryGetRoots();
+    if (roots && roots.length > 0) {
+        return Promise.resolve();
+    }
+    return new Promise(resolve => {
+        const disposable = workspaceService.onWorkspaceChanged(changedRoots => {
+            if (changedRoots && changedRoots.length > 0) {
+                disposable.dispose();
+                resolve();
+            }
+        });
+    });
+}
+//# sourceMappingURL=workspace-gate.js.map

package/lib/browser/workspace-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-gate.js","sourceRoot":"","sources":["../../src/browser/workspace-gate.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAclF,8CAaC;AAvBD;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAAC,gBAAkC;IACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAC7C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;QAChC,MAAM,UAAU,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE;YACnE,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,UAAU,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACb,CAAC;QACJ,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/common/emitter-data-client.d.ts

@@ -0,0 +1,40 @@
+/********************************************************************************
+ * 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 { DataClientProtocol, Project, ProjectsChangedEvent, TransferDiagnostic, TransferDocumentSavedEvent, TransferDocumentUpdatedEvent, TransferElement } from '@hydranium/protocol';
+import { Emitter, type Event } from '@theia/core';
+/**
+ * Default {@link DataClientProtocol} implementation for a Theia frontend:
+ * each inbound `on*` notification is fanned out to a Theia {@link Event} so
+ * multiple local listeners can subscribe (the framework deliberately leaves
+ * fan-out to the consumer — see `DataClientProtocol`).
+ *
+ * Bind an instance as the `localTarget` of the frontend's `createRpcProxy`
+ * (with `DATA_CLIENT_PROTOCOL_METHODS` as `localMethods`); incoming
+ * `<namespace>onDocumentUpdated` etc. dispatch to the matching method here,
+ * which fires the paired `Event`.
+ *
+ * Adopters subclass to add signals that are not wire notifications, or to
+ * expose domain-renamed aliases of these channels — the event getters stay
+ * accessible to the subclass.
+ */
+export declare class EmitterDataClient<TTransfer extends TransferElement, TDiagnostic extends TransferDiagnostic = TransferDiagnostic, TProject extends Project = Project> implements DataClientProtocol<TTransfer, TDiagnostic, TProject> {
+    protected readonly onDocumentUpdatedEmitter: Emitter<TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>>;
+    /** Fires for each inbound {@link onDocumentUpdated} notification. */
+    readonly onDidUpdateDocument: Event<TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>>;
+    protected readonly onDocumentSavedEmitter: Emitter<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
+    /** Fires for each inbound {@link onDocumentSaved} notification. */
+    readonly onDidSaveDocument: Event<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
+    protected readonly onProjectsChangedEmitter: Emitter<ProjectsChangedEvent<TProject>>;
+    /** Fires for each inbound {@link onProjectsChanged} notification. */
+    readonly onDidChangeProjects: Event<ProjectsChangedEvent<TProject>>;
+    onDocumentUpdated(event: TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>): void;
+    onDocumentSaved(event: TransferDocumentSavedEvent<TTransfer, TDiagnostic>): void;
+    onProjectsChanged(event: ProjectsChangedEvent<TProject>): void;
+}
+//# sourceMappingURL=emitter-data-client.d.ts.map

package/lib/common/emitter-data-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter-data-client.d.ts","sourceRoot":"","sources":["../../src/common/emitter-data-client.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EACT,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC5B,eAAe,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB,CAC3B,SAAS,SAAS,eAAe,EACjC,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,QAAQ,SAAS,OAAO,GAAG,OAAO,CACnC,YAAW,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,wBAAwB,gEAAuE;IAClH,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAuC;IAEhI,SAAS,CAAC,QAAQ,CAAC,sBAAsB,8DAAqE;IAC9G,mEAAmE;IACnE,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAqC;IAE1H,SAAS,CAAC,QAAQ,CAAC,wBAAwB,0CAAiD;IAC5F,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAuC;IAE1G,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;IAIpF,eAAe,CAAC,KAAK,EAAE,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;IAIhF,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI;CAGhE"}

package/lib/common/emitter-data-client.js

@@ -0,0 +1,49 @@
+"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.EmitterDataClient = void 0;
+const core_1 = require("@theia/core");
+/**
+ * Default {@link DataClientProtocol} implementation for a Theia frontend:
+ * each inbound `on*` notification is fanned out to a Theia {@link Event} so
+ * multiple local listeners can subscribe (the framework deliberately leaves
+ * fan-out to the consumer — see `DataClientProtocol`).
+ *
+ * Bind an instance as the `localTarget` of the frontend's `createRpcProxy`
+ * (with `DATA_CLIENT_PROTOCOL_METHODS` as `localMethods`); incoming
+ * `<namespace>onDocumentUpdated` etc. dispatch to the matching method here,
+ * which fires the paired `Event`.
+ *
+ * Adopters subclass to add signals that are not wire notifications, or to
+ * expose domain-renamed aliases of these channels — the event getters stay
+ * accessible to the subclass.
+ */
+class EmitterDataClient {
+    onDocumentUpdatedEmitter = new core_1.Emitter();
+    /** Fires for each inbound {@link onDocumentUpdated} notification. */
+    onDidUpdateDocument = this.onDocumentUpdatedEmitter.event;
+    onDocumentSavedEmitter = new core_1.Emitter();
+    /** Fires for each inbound {@link onDocumentSaved} notification. */
+    onDidSaveDocument = this.onDocumentSavedEmitter.event;
+    onProjectsChangedEmitter = new core_1.Emitter();
+    /** Fires for each inbound {@link onProjectsChanged} notification. */
+    onDidChangeProjects = this.onProjectsChangedEmitter.event;
+    onDocumentUpdated(event) {
+        this.onDocumentUpdatedEmitter.fire(event);
+    }
+    onDocumentSaved(event) {
+        this.onDocumentSavedEmitter.fire(event);
+    }
+    onProjectsChanged(event) {
+        this.onProjectsChangedEmitter.fire(event);
+    }
+}
+exports.EmitterDataClient = EmitterDataClient;
+//# sourceMappingURL=emitter-data-client.js.map

package/lib/common/emitter-data-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter-data-client.js","sourceRoot":"","sources":["../../src/common/emitter-data-client.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAWlF,sCAAkD;AAElD;;;;;;;;;;;;;;GAcG;AACH,MAAa,iBAAiB;IAKR,wBAAwB,GAAG,IAAI,cAAO,EAAwD,CAAC;IAClH,qEAAqE;IAC5D,mBAAmB,GAAgE,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAE7G,sBAAsB,GAAG,IAAI,cAAO,EAAsD,CAAC;IAC9G,mEAAmE;IAC1D,iBAAiB,GAA8D,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC;IAEvG,wBAAwB,GAAG,IAAI,cAAO,EAAkC,CAAC;IAC5F,qEAAqE;IAC5D,mBAAmB,GAA0C,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAE1G,iBAAiB,CAAC,KAA2D;QAC1E,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,eAAe,CAAC,KAAyD;QACtE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,iBAAiB,CAAC,KAAqC;QACpD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACH;AA5BD,8CA4BC"}

package/lib/common/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 './emitter-data-client';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/common/index.js

@@ -0,0 +1,37 @@
+"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 });
+// Environment-agnostic shared surface for the data-server-head Theia
+// integration. A module lands here only when its whole dependency closure —
+// values, types and relative imports alike — is either neutral or Theia's
+// COMMON tier; `@theia/core`'s root entry is that tier, while anything reaching
+// `@theia/*/lib/browser` or `/lib/node` belongs in the tier it names, even when
+// the import is type-only and erases at runtime.
+//
+// This tier deliberately holds no error-reconstruction bridge, and that is a
+// property of the transport rather than an omission: the direct vscode-jsonrpc
+// connection carries a typed error such as `ConflictError` across the channel
+// relay natively, with no Theia msgpack hop to drop its data.
+__exportStar(require("./emitter-data-client"), exports);
+//# sourceMappingURL=index.js.map

package/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,qEAAqE;AACrE,4EAA4E;AAC5E,0EAA0E;AAC1E,gFAAgF;AAChF,gFAAgF;AAChF,iDAAiD;AACjD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,8DAA8D;AAC9D,wDAAsC"}

package/lib/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 {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,11 @@
+"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 });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/node/connection-container-module.d.ts

@@ -0,0 +1,34 @@
+/********************************************************************************
+ * 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 { ConnectionHandler } from '@theia/core';
+import { ContainerModule, type interfaces } from '@theia/core/shared/inversify';
+/**
+ * Creates the frontend-scoped Theia backend module that registers a
+ * data-server {@link ConnectionHandler} (a `DataServerConnectionHandler`
+ * subclass) per browser-frontend connection. Returns a ready-to-export
+ * `ContainerModule` so adopters can
+ * `export default createDataServerConnectionContainerModule(MyHandler)` from
+ * their backend-module entry point.
+ *
+ * Sibling of `@hydranium/glsp-client-theia`'s
+ * `createGlspConnectionContainerModule` — the `ContainerModule +
+ * ConnectionContainerModule.create` boilerplate every frontend-scoped Theia
+ * connection adopter writes by hand, lifted so adopters declare only the
+ * handler class.
+ *
+ * **More than one handler is the normal case, not an exotic one.** Theia keys a
+ * frontend channel by its service path and refuses a second channel on a path
+ * already open, so every frontend abstraction reaching the data head needs its
+ * own path and therefore its own handler — a host-neutral `DataPort` beside a
+ * Theia `AbstractDataServiceFrontend` is exactly that shape. They still forward
+ * to the SAME data server: the path distinguishes the channel, the shared
+ * `portCommand` names the one process behind it.
+ */
+export declare function createDataServerConnectionContainerModule(...handlerClasses: interfaces.Newable<ConnectionHandler>[]): ContainerModule;
+//# sourceMappingURL=connection-container-module.d.ts.map

package/lib/node/connection-container-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-container-module.d.ts","sourceRoot":"","sources":["../../src/node/connection-container-module.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yCAAyC,CAAC,GAAG,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,GAAG,eAAe,CAerI"}

package/lib/node/connection-container-module.js

@@ -0,0 +1,53 @@
+"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.createDataServerConnectionContainerModule = createDataServerConnectionContainerModule;
+const core_1 = require("@theia/core");
+const connection_container_module_1 = require("@theia/core/lib/node/messaging/connection-container-module");
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * Creates the frontend-scoped Theia backend module that registers a
+ * data-server {@link ConnectionHandler} (a `DataServerConnectionHandler`
+ * subclass) per browser-frontend connection. Returns a ready-to-export
+ * `ContainerModule` so adopters can
+ * `export default createDataServerConnectionContainerModule(MyHandler)` from
+ * their backend-module entry point.
+ *
+ * Sibling of `@hydranium/glsp-client-theia`'s
+ * `createGlspConnectionContainerModule` — the `ContainerModule +
+ * ConnectionContainerModule.create` boilerplate every frontend-scoped Theia
+ * connection adopter writes by hand, lifted so adopters declare only the
+ * handler class.
+ *
+ * **More than one handler is the normal case, not an exotic one.** Theia keys a
+ * frontend channel by its service path and refuses a second channel on a path
+ * already open, so every frontend abstraction reaching the data head needs its
+ * own path and therefore its own handler — a host-neutral `DataPort` beside a
+ * Theia `AbstractDataServiceFrontend` is exactly that shape. They still forward
+ * to the SAME data server: the path distinguishes the channel, the shared
+ * `portCommand` names the one process behind it.
+ */
+function createDataServerConnectionContainerModule(...handlerClasses) {
+    const frontendScopedConnectionModule = connection_container_module_1.ConnectionContainerModule.create(({ bind }) => {
+        for (const handlerClass of handlerClasses) {
+            bind(handlerClass).toSelf().inSingletonScope();
+            // `toDynamicValue` over `to(handlerClass)`: `ConnectionHandler` is
+            // multi-bound here, and resolving through the container keeps each
+            // entry the SAME singleton the adopter can inject by its own class.
+            bind(core_1.ConnectionHandler)
+                .toDynamicValue(context => context.container.get(handlerClass))
+                .inSingletonScope();
+        }
+    });
+    return new inversify_1.ContainerModule(bind => {
+        bind(connection_container_module_1.ConnectionContainerModule).toConstantValue(frontendScopedConnectionModule);
+    });
+}
+//# sourceMappingURL=connection-container-module.js.map

package/lib/node/connection-container-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-container-module.js","sourceRoot":"","sources":["../../src/node/connection-container-module.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AA4BlF,8FAeC;AAzCD,sCAAgD;AAChD,4GAAuG;AACvG,4DAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,yCAAyC,CAAC,GAAG,cAAuD;IACjH,MAAM,8BAA8B,GAAG,uDAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QAClF,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;YAC/C,mEAAmE;YACnE,mEAAmE;YACnE,oEAAoE;YACpE,IAAI,CAAC,wBAAiB,CAAC;iBACnB,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;iBAC9D,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;QAC/B,IAAI,CAAC,uDAAyB,CAAC,CAAC,eAAe,CAAC,8BAA8B,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/node/data-server-connection-handler.d.ts

@@ -0,0 +1,56 @@
+/********************************************************************************
+ * 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 { AbstractSocketForwardingConnectionHandler } from '@hydranium/client-theia/lib/node';
+import { type Channel, type Disposable } from '@theia/core';
+import type * as net from 'node:net';
+/** Options for {@link DataServerConnectionHandler}. `servicePath` is the Theia
+ *  service path the browser frontend opens a channel to; `portCommand` is the
+ *  command id whose return value is the data-server's listening port (the
+ *  data-server publishes it on the LSP connection at startup, the same handshake
+ *  GLSP uses). */
+export interface DataServerConnectionHandlerOptions {
+    /** Theia service path the browser frontend opens a channel to. Defaults to
+     *  the framework `DATA_SERVER_PATH`; override for an adopter-specific path,
+     *  and NECESSARILY when a second frontend reaches the same head — Theia
+     *  refuses a second channel on a path already open, so paths are per
+     *  FRONTEND while `portCommand` stays per server. */
+    readonly servicePath?: string;
+    /** Command id whose return value is the data-server's listening port.
+     *  Defaults to the framework `DATA_SERVER_PORT_COMMAND`; override to match
+     *  an adopter's established id. */
+    readonly portCommand?: string;
+    readonly findPortTimeout?: number;
+    readonly findPortAttempts?: number;
+    readonly connectTimeoutMs?: number;
+    /**
+     * Optional diagnostic hook called immediately after the outbound
+     * `net.Socket` to the data-server is created, BEFORE `socket.connect()` is
+     * invoked. Adopters attach `'data'` / `'close'` listeners here for
+     * byte-level observability when debugging wire-level issues; attaching
+     * before `connect()` guarantees the very first bytes are observed.
+     */
+    readonly onSocketCreated?: (socket: net.Socket) => void;
+}
+/**
+ * Bridges a Theia browser-frontend channel to a data-server's TCP socket — the
+ * backend half of the data-server head's transport.
+ *
+ * The port-discovery + buffer-and-replay race fix + connect orchestration live
+ * on the cross-head {@link AbstractSocketForwardingConnectionHandler} base; this
+ * subclass supplies only the data-server defaults (service path / port command /
+ * log labels) and plugs in {@link SocketChannelForwarder} as the byte relay —
+ * its own forwarder, so the data head carries no GLSP dependency. Sibling of
+ * `@hydranium/glsp-client-theia`'s `GlspServerConnectionHandler`, which
+ * subclasses the same base with `@eclipse-glsp`'s `SocketConnectionForwarder`.
+ */
+export declare class DataServerConnectionHandler extends AbstractSocketForwardingConnectionHandler {
+    constructor(options?: DataServerConnectionHandlerOptions);
+    protected forwardToSocketConnection(clientChannel: Channel, socket: net.Socket): Disposable;
+}
+//# sourceMappingURL=data-server-connection-handler.d.ts.map

package/lib/node/data-server-connection-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-server-connection-handler.d.ts","sourceRoot":"","sources":["../../src/node/data-server-connection-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,yCAAyC,EAAE,MAAM,kCAAkC,CAAC;AAE7F,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAGrC;;;;kBAIkB;AAClB,MAAM,WAAW,kCAAkC;IAChD;;;;yDAIqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;uCAEmC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;;;;;;;GAWG;AACH,qBACa,2BAA4B,SAAQ,yCAAyC;gBAC9D,OAAO,GAAE,kCAAuC;IAazE,SAAS,CAAC,yBAAyB,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,UAAU;CAG7F"}

package/lib/node/data-server-connection-handler.js

@@ -0,0 +1,63 @@
+"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 __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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataServerConnectionHandler = void 0;
+const node_1 = require("@hydranium/client-theia/lib/node");
+const protocol_1 = require("@hydranium/protocol");
+const inversify_1 = require("@theia/core/shared/inversify");
+const socket_channel_forwarder_1 = require("./socket-channel-forwarder");
+/**
+ * Bridges a Theia browser-frontend channel to a data-server's TCP socket — the
+ * backend half of the data-server head's transport.
+ *
+ * The port-discovery + buffer-and-replay race fix + connect orchestration live
+ * on the cross-head {@link AbstractSocketForwardingConnectionHandler} base; this
+ * subclass supplies only the data-server defaults (service path / port command /
+ * log labels) and plugs in {@link SocketChannelForwarder} as the byte relay —
+ * its own forwarder, so the data head carries no GLSP dependency. Sibling of
+ * `@hydranium/glsp-client-theia`'s `GlspServerConnectionHandler`, which
+ * subclasses the same base with `@eclipse-glsp`'s `SocketConnectionForwarder`.
+ */
+let DataServerConnectionHandler = class DataServerConnectionHandler extends node_1.AbstractSocketForwardingConnectionHandler {
+    constructor(options = {}) {
+        super({
+            path: options.servicePath ?? protocol_1.DATA_SERVER_PATH,
+            portCommand: options.portCommand ?? protocol_1.DATA_SERVER_PORT_COMMAND,
+            logComponent: 'DataServer',
+            serverName: 'Model Server',
+            findPortTimeout: options.findPortTimeout,
+            findPortAttempts: options.findPortAttempts,
+            connectTimeoutMs: options.connectTimeoutMs,
+            onSocketCreated: options.onSocketCreated
+        });
+    }
+    forwardToSocketConnection(clientChannel, socket) {
+        return new socket_channel_forwarder_1.SocketChannelForwarder(clientChannel, socket);
+    }
+};
+exports.DataServerConnectionHandler = DataServerConnectionHandler;
+exports.DataServerConnectionHandler = DataServerConnectionHandler = __decorate([
+    (0, inversify_1.injectable)(),
+    __param(0, (0, inversify_1.unmanaged)()),
+    __metadata("design:paramtypes", [Object])
+], DataServerConnectionHandler);
+//# sourceMappingURL=data-server-connection-handler.js.map

package/lib/node/data-server-connection-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-server-connection-handler.js","sourceRoot":"","sources":["../../src/node/data-server-connection-handler.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;AAElF,2DAA6F;AAC7F,kDAAiF;AAEjF,4DAAqE;AAErE,yEAAoE;AA+BpE;;;;;;;;;;;GAWG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,gDAAyC;IACvF,YAAyB,UAA8C,EAAE;QACtE,KAAK,CAAC;YACH,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,2BAAgB;YAC7C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,mCAAwB;YAC5D,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,cAAc;YAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;SAC1C,CAAC,CAAC;IACN,CAAC;IAES,yBAAyB,CAAC,aAAsB,EAAE,MAAkB;QAC3E,OAAO,IAAI,iDAAsB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;CACH,CAAA;AAjBY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;IAEG,WAAA,IAAA,qBAAS,GAAE,CAAA;;GADd,2BAA2B,CAiBvC"}

package/lib/node/host-diagnostics-server.d.ts

@@ -0,0 +1,31 @@
+/********************************************************************************
+ * 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 DumpHostStateArgs, type HostDiagnosticsProtocol, type WriteHostHeapSnapshotArgs } from '@hydranium/protocol';
+import { ContainerModule } from '@theia/core/shared/inversify';
+/**
+ * Host-process diagnostics, computed IN the Theia backend process this service
+ * runs in (the parent / host, distinct from the data-server child that holds the
+ * model store). Universal — `process.memoryUsage()` always works — so the
+ * framework wires it by default. Each result is also written to the backend's
+ * stdout so it reaches the pod log (`kubectl logs`), not only the RPC caller.
+ */
+export declare class HostDiagnosticsServer implements HostDiagnosticsProtocol {
+    dumpHostState(args: DumpHostStateArgs): Promise<string>;
+    writeHostHeapSnapshot(args: WriteHostHeapSnapshotArgs): Promise<string>;
+}
+/**
+ * Theia backend module that exposes {@link HostDiagnosticsServer} as an ordinary
+ * in-process RPC service at {@link HOST_DIAGNOSTICS_PATH} (not the socket-
+ * forwarded data-server transport). The frontend reaches it with
+ * `bindHostDiagnostics` (see `../browser`). Adopters
+ * `export default createHostDiagnosticsBackendModule()` from a backend-module
+ * entry point.
+ */
+export declare function createHostDiagnosticsBackendModule(): ContainerModule;
+//# sourceMappingURL=host-diagnostics-server.d.ts.map

package/lib/node/host-diagnostics-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-diagnostics-server.d.ts","sourceRoot":"","sources":["../../src/node/host-diagnostics-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAEJ,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAChC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAc,MAAM,8BAA8B,CAAC;AAE3E;;;;;;GAMG;AACH,qBACa,qBAAsB,YAAW,uBAAuB;IAC5D,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvD,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;CAK/E;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,IAAI,eAAe,CAOpE"}