@hydranium/data-client-theia 1.0.0-next.28 → 1.0.0-next.280

package/README.md

@@ -1,57 +1,20 @@
 # `@hydranium/data-client-theia`
 
-Theia client primitives for the hydranium **data head** — the companion of
-`@hydranium/data-server` in the
-[Hydranium](https://github.com/eclipse-emfcloud/hydranium) framework.
-
-The data head's frontend speaks the data server's own `vscode-jsonrpc` protocol
-over a channel that the Theia backend relays byte-for-byte onto the server's
-socket. This package is both halves of that arrangement: the browser-side
-connection and typed-frontend bases, and the backend-side connection handler and
-forwarder. Install it if a Theia application needs form editors, trees, or
-code-gen driven from the live AST rather than from LSP text edits.
+The Theia connection for the
+[Hydranium](https://github.com/eclipse-emfcloud/hydranium) data head, the
+companion of `@hydranium/data-server`. Install it when forms, trees or views in
+a Theia application work on the live model rather than on text. It builds on
+`@hydranium/client-theia`.
 
 ## What it gives you
 
-- **`openChannelConnection`** with `createChannelConnection` and
-  `ChannelConnectionHandle` — wraps a Theia `Channel` as a `vscode-jsonrpc`
-  `MessageConnection`, gated on a `whenReady` promise, and by default
-  re-establishes it by **re-opening the channel** when the connection is lost.
-  Re-opening rather than rebuilding is what recovers a restarted language server:
-  a server restart closes only the multiplexed sub-channel, so no replacement
-  channel ever arrives on its own. Retries follow `DEFAULT_RECONNECT_DELAYS`,
-  escalating per consecutive loss and resetting after
-  `RECONNECT_ESCALATION_RESET_MS`.
-- **`AbstractDataServiceFrontend`** — base for a frontend that owns the
-  data-server connection: the workspace-gated connect, the typed server proxy,
-  the inbound client binding, and a lazy idempotent init gate (`ensureConnected`).
-  You supply the connection seams (`connectionProvider`, `servicePath`,
-  `methodNamespace`, `client`, `clientMethods`); progress UI and domain caching
-  layer on top.
-- **`AbstractDiagnosticsDataServiceFrontend`** and
-  **`AbstractReferencesDataServiceFrontend`** — the same base specialised for the
-  two protocol fragments an adopter most often keeps: each diagnostics
-  (`dumpServerState`, `writeHeapSnapshot`, `dumpPodMemory`, the profiling and
-  latency calls) and each reference method is implemented as a readiness-gated
-  pass-through, so you do not hand-write identical one-line bodies. They are
-  deliberately independent bases rather than chained.
-- **`EmitterDataClient`** (on `./common`, not `./browser`) — the default
-  client-side implementation of the data protocol's inbound notifications,
-  fanning each one out to a Theia `Event`: `onDidUpdateDocument`,
-  `onDidSaveDocument`, `onDidChangeProjects`. Bind an instance as the
-  `localTarget` of the frontend's RPC proxy. It sits on the common tier because
-  its only runtime dependency is `@theia/core`'s root entry, which is Theia's own
-  common tier, so a backend or a plain-Node consumer can bind it too.
-- **`whenWorkspaceOpen`** — resolves once Theia reports a workspace root. The data
-  server only starts once the LSP launches for a workspace, so connecting earlier
-  would hang in port discovery; pass this as `whenReady`.
-- **Backend (`./node`)** — `DataServerConnectionHandler` (the socket bridge, with
-  its own GLSP-free `SocketChannelForwarder`),
-  `createDataServerConnectionContainerModule(...handlers)` for the
-  frontend-scoped module boilerplate, and `HostDiagnosticsServer` with
-  `createHostDiagnosticsBackendModule()` — which, paired with the browser-side
-  `bindHostDiagnostics`, lights up the "Backend" diagnostics commands in
-  `@hydranium/client-theia`'s contribution.
+- A data connection in the Theia frontend: you subclass `ChannelDataPort`, and
+  the connection and sessions from `@hydranium/protocol` run over it.
+- A connection that waits for a workspace, and reconnects on its own when the
+  channel is lost, a restarted server included.
+- Sessions that end with the page, and a page held while one of them saves.
+- The backend handler that relays the channel to the data server's socket.
+- Diagnostics commands for the Theia backend process, beside the server's.
 
 ## Install
 
@@ -59,68 +22,61 @@ code-gen driven from the live AST rather than from LSP text edits.
 npm install @hydranium/data-client-theia
 ```
 
-You must already have a Theia application with `@theia/workspace` available, and a
-running hydranium data server to connect to. The declared peer dependencies are:
-
-| Peer                      | Range                |
-| ------------------------- | -------------------- |
-| `@hydranium/client-theia` | `^1.0.0-next`        |
-| `@hydranium/core`         | `^1.0.0-next`        |
-| `@hydranium/protocol`     | `^1.0.0-next`        |
-| `@theia/core`             | `^1.70.0`            |
-| `@theia/workspace`        | `^1.70.0`            |
-| `inversify`               | `^6.0.0`             |
-| `vscode-jsonrpc`          | `9.0.1`              |
-
-`@hydranium/core` is reached only from the `./node` tier (the host-diagnostics
-service), so a frontend-only consumer never loads it.
+| Peer                      | Range         |
+| ------------------------- | ------------- |
+| `@hydranium/client-theia` | `^1.0.0-next` |
+| `@hydranium/protocol`     | `^1.0.0-next` |
+| `@theia/core`             | `^1.70.0`     |
+| `@theia/workspace`        | `^1.70.0`     |
+| `inversify`               | `^6.0.0`      |
+| `vscode-jsonrpc`          | `^9.0.0`      |
 
 ## Wiring
 
-This package declares no `theiaExtensions` — it is a library your own Theia
-extension builds on. That extension's `package.json` declares the entries, and
-each entry names one frontend/backend module pair:
-
-- the **frontend** module binds your `AbstractDataServiceFrontend` subclass (and,
-  for the diagnostics commands, calls `bindHostDiagnostics`);
-- the **backend** module is typically a one-liner:
-  `export default createDataServerConnectionContainerModule(MyHandler)`, where
-  `MyHandler` extends `DataServerConnectionHandler`.
-
-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
-`servicePath` — while the shared `portCommand` still names the one server process
-behind them all.
-
-The refusal is silent, which is what makes it expensive: the loser's promise is
-left unsettled rather than rejected, so a frontend that shared a path hangs on
-its loading state indefinitely with nothing in the server log to say why.
+This package declares no `theiaExtensions`; your own Theia extension declares
+them and binds from here.
+
+- In a frontend module, subclass `ChannelDataPort` with a `servicePath` and
+  bind it in singleton scope. Call `bindDataConnection` for the connection
+  over it.
+- In the same frontend, call `bindChannelLogger` from
+  `@hydranium/client-theia`, and its `bindEditorDiskSync`, since a data server
+  save writes a file an editor can have open.
+- For the backend diagnostics commands, call `bindHostDiagnostics` in the
+  frontend and export `createHostDiagnosticsBackendModule()` from a backend
+  module.
+- In the backend, export
+  `createDataServerConnectionContainerModule(MyHandler)`, where `MyHandler`
+  extends `DataServerConnectionHandler` and names your server's port command.
+
+Give each frontend channel its own `servicePath`. Theia refuses a second
+channel on a path already open, silently: the frontend hangs with nothing in
+the log. For several participants on one channel, use sessions instead.
+
+For the whole setup, see *Host in Theia* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## Entry points
 
-| Subpath     | Holds                                                                                                                                                                                                | Environment                      |
-| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| `.`         | Nothing — the surface is split by environment, so the root barrel stays empty.                                                                                                                        | browser-neutral (gated)          |
-| `./common`  | `EmitterDataClient` — a module lands here only when values, types and relative imports are all neutral or Theia COMMON tier. No error-reconstruction bridge, and that is a property of the transport: the direct `vscode-jsonrpc` connection carries a typed error across the relay natively. | browser-neutral (gated)          |
-| `./browser` | `openChannelConnection`, `createChannelConnection`, the three `Abstract*DataServiceFrontend` bases, `bindHostDiagnostics`, `whenWorkspaceOpen`                                                         | browser / Theia frontend (gated) |
-| `./node`    | `DataServerConnectionHandler`, `createDataServerConnectionContainerModule`, `SocketChannelForwarder`, `HostDiagnosticsServer`, `createHostDiagnosticsBackendModule`                                    | Node / Theia backend             |
+| Subpath     | Use it for                                                    | Runs in         |
+| ----------- | ------------------------------------------------------------- | --------------- |
+| `.`         | Nothing; import a subpath                                     | browser-neutral |
+| `./common`  | The data server's notifications as Theia events, on any side  | browser-neutral |
+| `./browser` | The port, the connection binding and the diagnostics proxy    | Theia frontend  |
+| `./node`    | The connection handler and the backend modules                | Theia backend   |
 
-Every subpath also has a `./lib/<name>` twin for consumers on
-`moduleResolution: "Node"`. "Gated" means the repository's neutral-bundle check
-enforces that the entry bundles for the browser with no `node:*` import,
-transitive ones included; `./node` is deliberately outside that gate. Also
-worth reading: [what "gated neutral" does and does not promise](../../docs/concepts/browser-hosting.md#a-note-on-what-gated-neutral-does-and-does-not-promise).
+The subpaths need a TypeScript `moduleResolution` that reads `exports`
+(`NodeNext` or `Bundler`); see *Requirements* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## Status
 
-Alpha — pre-v0, not yet published. The API is not stable and may change without a
-deprecation cycle. See [`docs/concepts/architecture.md`](../../docs/concepts/architecture.md) for
-the data head's place among the heads, and the
-[repository README](../../README.md) for current status and known limitations.
+Alpha: every release is a prerelease that may break the API, so pin an exact
+version. Guides and known limitations:
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## License
 
-`MIT` — see this package's [`LICENSE`](./LICENSE). Third-party notices for the
-runtime dependency closure are collected in the repository
-[`NOTICE.md`](../../NOTICE.md).
+`MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
+[`NOTICE.md`](https://github.com/eclipse-emfcloud/hydranium/blob/main/NOTICE.md)
+for third-party notices.

package/lib/browser/channel-connection.d.ts

@@ -6,6 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+import { type Clock } from '@hydranium/protocol';
 import { type Channel, type Event } from '@theia/core';
 import { type ServiceConnectionProvider } from '@theia/core/lib/browser';
 import { type Logger, type MessageConnection } from 'vscode-jsonrpc/browser';
@@ -21,7 +22,7 @@ import { type Logger, type MessageConnection } from 'vscode-jsonrpc/browser';
  * Mirrors `@eclipse-glsp/theia-integration`'s `createChannelConnection`, but
  * lives here so the data-server head carries no GLSP dependency.
  */
-export declare function createChannelConnection(channel: Channel, logger?: Logger): MessageConnection;
+export declare function createChannelConnection(channel: Channel, logger: Logger): MessageConnection;
 /** Options for {@link openChannelConnection}. */
 export interface OpenChannelConnectionOptions {
     /**
@@ -32,8 +33,10 @@ export interface OpenChannelConnectionOptions {
      * publishes the port) exists.
      */
     whenReady?: Promise<void>;
-    /** Optional `vscode-jsonrpc` logger threaded into the connection. */
-    logger?: Logger;
+    /** Where the connection logs its protocol faults; without one they leave no trace. */
+    logger: Logger;
+    /** Times the escalation reset. Default a `SystemClock`. */
+    clock?: Clock;
     /**
      * Re-establish the connection whenever the live one is lost, by RE-OPENING
      * the channel on `path` — not merely by rebuilding over a channel Theia hands
@@ -107,8 +110,8 @@ export interface ChannelConnectionHandle {
     /**
      * The current connection. Read it per use rather than caching it: after a
      * reconnect this returns a NEW promise, and a cached one resolves to the
-     * dead connection forever. The same reasoning makes
-     * `AbstractDataServiceFrontend` rebuild its proxy rather than hold one.
+     * dead connection forever. The same reasoning makes `RpcConnection` rebuild
+     * its proxy per generation rather than hold one.
      */
     readonly current: Promise<MessageConnection>;
     /**
@@ -120,10 +123,10 @@ export interface ChannelConnectionHandle {
      *
      * **This is the event a consumer wants, not {@link onDidReconnect}.** Anything
      * derived from a connection — an `createRpcProxy`, a readiness gate, a
-     * `DataSession` generation — is dead from this moment, and a consumer that
+     * `DataConnection` generation — is dead from this moment, and a consumer that
      * waits for the replacement to be live instead keeps sending into the dead one
      * for the whole gap. A `DataPort` implementation translates this into the
-     * port's own `onDispose`, which is what makes `DataSession` drop its
+     * port's own `onDispose`, which is what makes `DataConnection` drop its
      * generation.
      *
      * Never fires when {@link OpenChannelConnectionOptions.reconnect} is off.
@@ -170,5 +173,5 @@ export interface ChannelConnectionHandle {
  * so the consumer's request is left unsettled: a hang with a clean log, not an
  * error. Owning the re-open here means owning it exclusively.
  */
-export declare function openChannelConnection(connectionProvider: ServiceConnectionProvider, path: string, options?: OpenChannelConnectionOptions): ChannelConnectionHandle;
+export declare function openChannelConnection(connectionProvider: ServiceConnectionProvider, path: string, options: OpenChannelConnectionOptions): ChannelConnectionHandle;
 //# sourceMappingURL=channel-connection.d.ts.map

package/lib/browser/channel-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-connection.d.ts","sourceRoot":"","sources":["../../src/browser/channel-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,OAAO,EAAiC,KAAK,KAAK,EAAwB,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAMJ,KAAK,MAAM,EAEX,KAAK,iBAAiB,EAQxB,MAAM,wBAAwB,CAAC;AAkEhC;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAI5F;AAED,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAA2C,CAAC;AAElG,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7C;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAElD;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAClC,kBAAkB,EAAE,yBAAyB,EAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,4BAAiC,GAC1C,uBAAuB,CA4IzB"}
+{"version":3,"file":"channel-connection.d.ts","sourceRoot":"","sources":["../../src/browser/channel-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,KAAK,EAA+B,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,KAAK,OAAO,EAAiC,KAAK,KAAK,EAAwB,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAMJ,KAAK,MAAM,EAEX,KAAK,iBAAiB,EAQxB,MAAM,wBAAwB,CAAC;AAkEhC;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAI3F;AAED,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAA2C,CAAC;AAElG,iFAAiF;AACjF,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7C;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAElD;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,qBAAqB,CAClC,kBAAkB,EAAE,yBAAyB,EAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,4BAA4B,GACrC,uBAAuB,CA6IzB"}

package/lib/browser/channel-connection.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RECONNECT_ESCALATION_RESET_MS = exports.DEFAULT_RECONNECT_DELAYS = void 0;
 exports.createChannelConnection = createChannelConnection;
 exports.openChannelConnection = openChannelConnection;
+const protocol_1 = require("@hydranium/protocol");
 const core_1 = require("@theia/core");
 const promise_util_1 = require("@theia/core/lib/common/promise-util");
 const browser_1 = require("vscode-jsonrpc/browser");
@@ -126,7 +127,7 @@ exports.RECONNECT_ESCALATION_RESET_MS = 30_000;
  * so the consumer's request is left unsettled: a hang with a clean log, not an
  * error. Owning the re-open here means owning it exclusively.
  */
-function openChannelConnection(connectionProvider, path, options = {}) {
+function openChannelConnection(connectionProvider, path, options) {
     const reconnect = options.reconnect ?? true;
     const reconnectDelays = options.reconnectDelays ?? exports.DEFAULT_RECONNECT_DELAYS;
     const reconnectEmitter = new core_1.Emitter();
@@ -139,8 +140,9 @@ function openChannelConnection(connectionProvider, path, options = {}) {
     let awaitingReplacement = false;
     /** Consecutive losses, indexing `reconnectDelays`. */
     let losses = 0;
-    /** When the live connection was built, for the escalation reset. `0` before the first. */
-    let liveSince = 0;
+    const clock = options.clock ?? new protocol_1.SystemClock();
+    /** Running since the live connection was built, for the escalation reset. */
+    let sinceLive;
     let reopenTimer;
     // Own synchronous flag, deliberately NOT `deferred.state`. Theia's
     // `Deferred` sets `state` inside a `.then()` on its own promise, so it is
@@ -153,7 +155,7 @@ function openChannelConnection(connectionProvider, path, options = {}) {
     // that; it takes counting the connections built per channel.
     let built = false;
     const scheduleReopen = () => {
-        if (liveSince > 0 && Date.now() - liveSince >= exports.RECONNECT_ESCALATION_RESET_MS) {
+        if (sinceLive !== undefined && sinceLive.elapsedMs >= exports.RECONNECT_ESCALATION_RESET_MS) {
             losses = 0;
         }
         const delay = reconnectDelays[Math.min(losses, reconnectDelays.length - 1)];
@@ -208,7 +210,7 @@ function openChannelConnection(connectionProvider, path, options = {}) {
         built = true;
         awaitingReplacement = false;
         generation++;
-        liveSince = Date.now();
+        sinceLive = clock.stopwatch();
         if (reconnect) {
             // Registered AFTER `createChannelConnection`, so the connection's own
             // reader and writer see the close first and `connection.onClose` still

package/lib/browser/channel-connection.js.map

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

package/lib/browser/channel-data-port.d.ts

@@ -0,0 +1,92 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { ChannelLogger, ConnectionReporter, type ConnectionAttempt, type ConnectionTarget } from '@hydranium/client-theia/browser';
+import { Clock } from '@hydranium/client-theia/common';
+import { type DataPort, type ResolvedMessage, type RpcConnectionLifecycle } from '@hydranium/protocol';
+import { Emitter, MessageService, type Event } from '@theia/core';
+import { type ServiceConnectionProvider } from '@theia/core/lib/browser';
+import { WorkspaceService } from '@theia/workspace/lib/browser';
+import type { MessageConnection } from 'vscode-jsonrpc';
+import { type ChannelConnectionHandle } from './channel-connection';
+/**
+ * A {@link DataPort} over a Theia frontend channel.
+ *
+ * Subclasses supply {@link servicePath}; everything above the port —
+ * `DataConnection`, its sessions, and whatever model a widget drives — is
+ * host-neutral and shared with the VS Code and browser shells.
+ *
+ * Bind one per service path and in singleton scope. Theia keys a frontend
+ * channel by its path and refuses a second on a path already open, and the
+ * throw escapes the `openChannelConnection` the loser is awaiting, leaving that
+ * promise unsettled rather than rejected.
+ */
+export declare abstract class ChannelDataPort implements DataPort {
+    protected readonly connectionProvider: ServiceConnectionProvider;
+    protected readonly workspaceService: WorkspaceService;
+    protected readonly messageService: MessageService;
+    protected readonly connectionReporter: ConnectionReporter;
+    readonly logger: ChannelLogger;
+    /** Times the channel's reconnect escalation: the container's {@link Clock}, or a `SystemClock`. */
+    protected readonly clock: Clock;
+    /** Frontend service path the backend forwarder for this head is registered under. */
+    protected abstract readonly servicePath: string;
+    /**
+     * Re-open the channel when the current connection is lost. Default `true` —
+     * re-opening is the only thing that recovers a restarted language server,
+     * which binds new ephemeral ports. Turn it off for a frontend that tears
+     * itself down on transport loss instead.
+     */
+    protected readonly reconnectOnConnectionLoss: boolean;
+    protected readonly disposeEmitter: Emitter<void>;
+    readonly onDispose: Event<void>;
+    protected handle?: ChannelConnectionHandle;
+    /** Set by {@link dispose}, after which {@link connect} rejects. */
+    protected disposed: boolean;
+    /** How long a connection may take before it is reported as failed; it keeps trying after. */
+    protected readonly connectFailureNoticeMs: number;
+    protected attempt?: ConnectionAttempt;
+    protected attemptTimer?: ReturnType<typeof setTimeout>;
+    /** Set once {@link connectionLifecycle} reports, which then owns the connection failures. */
+    protected reportsConnections: boolean;
+    /** Reports each connection generation through the {@link ConnectionReporter}. */
+    readonly connectionLifecycle: RpcConnectionLifecycle;
+    /**
+     * Open the workspace-gated channel and hand back its listening connection.
+     *
+     * Gated because the backend forwarder discovers the head's port by executing
+     * a command the language server answers, and the language server only
+     * launches once there is a workspace to launch it for. Asking earlier polls
+     * a command nobody has registered.
+     *
+     * Rejects once the port is disposed: the consumer reconnects when the
+     * dispose fires {@link onDispose}, and a channel opened then is closed by
+     * nothing.
+     */
+    connect(): Promise<MessageConnection>;
+    /**
+     * Surface a transport or write failure as a Theia notification.
+     *
+     * Swallowing it is the failure this exists to prevent: a dead connection and
+     * an empty document are indistinguishable in a widget.
+     *
+     * `reported` is already a complete sentence with the detail interpolated, so
+     * wrapping it in a sentence of the host's own would nest one owner's clause
+     * inside another's and leave no translator in control of the whole.
+     */
+    reportError(_error: unknown, reported: ResolvedMessage): void;
+    /** End the current attempt through `settle`, or cancel it. */
+    protected settleAttempt(settle?: (attempt: ConnectionAttempt) => void): void;
+    protected get connectionTarget(): ConnectionTarget;
+    /** One object per port: the reporter keys what it has shown on it. */
+    protected cachedConnectionTarget?: ConnectionTarget;
+    protected unreachableMessage(): string;
+    protected connectTimeoutMessage(): string;
+    dispose(): void;
+}
+//# sourceMappingURL=channel-data-port.d.ts.map

package/lib/browser/channel-data-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-data-port.d.ts","sourceRoot":"","sources":["../../src/browser/channel-data-port.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnI,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAKJ,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,cAAc,EAAO,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,uBAAuB,EAAyB,MAAM,sBAAsB,CAAC;AAG3F;;;;;;;;;;;GAWG;AACH,8BACsB,eAAgB,YAAW,QAAQ;IACpB,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAG,yBAAyB,CAAC;IAC1E,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAG,gBAAgB,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAG,cAAc,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAG,kBAAkB,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAG,aAAa,CAAC;IACvD,mGAAmG;IACxE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAqB;IAE/E,qFAAqF;IACrF,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEhD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,yBAAyB,EAAE,OAAO,CAAQ;IAE7D,SAAS,CAAC,QAAQ,CAAC,cAAc,gBAAuB;IACxD,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAA6B;IAE5D,SAAS,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAC3C,mEAAmE;IACnE,SAAS,CAAC,QAAQ,UAAS;IAE3B,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAU;IAC3D,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACtC,SAAS,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACvD,6FAA6F;IAC7F,SAAS,CAAC,kBAAkB,UAAS;IAErC,iFAAiF;IACjF,QAAQ,CAAC,mBAAmB,EAAE,sBAAsB,CAclD;IAEF;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAqBpC;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAS5D;IAED,8DAA8D;IAC9D,SAAS,CAAC,aAAa,CAAC,MAAM,GAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAqC,GAAG,IAAI,CAO3G;IAED,SAAS,KAAK,gBAAgB,IAAI,gBAAgB,CAKjD;IACD,sEAAsE;IACtE,SAAS,CAAC,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAEpD,SAAS,CAAC,kBAAkB,IAAI,MAAM,CAErC;IAED,SAAS,CAAC,qBAAqB,IAAI,MAAM,CAMxC;IAED,OAAO,IAAI,IAAI,CAOd;CACH"}

package/lib/browser/channel-data-port.js

@@ -0,0 +1,199 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelDataPort = void 0;
+const browser_1 = require("@hydranium/client-theia/browser");
+const common_1 = require("@hydranium/client-theia/common");
+const protocol_1 = require("@hydranium/protocol");
+const core_1 = require("@theia/core");
+const service_connection_provider_1 = require("@theia/core/lib/browser/messaging/service-connection-provider");
+const inversify_1 = require("@theia/core/shared/inversify");
+const browser_2 = require("@theia/workspace/lib/browser");
+const channel_connection_1 = require("./channel-connection");
+const workspace_gate_1 = require("./workspace-gate");
+/**
+ * A {@link DataPort} over a Theia frontend channel.
+ *
+ * Subclasses supply {@link servicePath}; everything above the port —
+ * `DataConnection`, its sessions, and whatever model a widget drives — is
+ * host-neutral and shared with the VS Code and browser shells.
+ *
+ * Bind one per service path and in singleton scope. Theia keys a frontend
+ * channel by its path and refuses a second on a path already open, and the
+ * throw escapes the `openChannelConnection` the loser is awaiting, leaving that
+ * promise unsettled rather than rejected.
+ */
+let ChannelDataPort = class ChannelDataPort {
+    connectionProvider;
+    workspaceService;
+    messageService;
+    connectionReporter;
+    logger;
+    /** Times the channel's reconnect escalation: the container's {@link Clock}, or a `SystemClock`. */
+    clock = new protocol_1.SystemClock();
+    /**
+     * Re-open the channel when the current connection is lost. Default `true` —
+     * re-opening is the only thing that recovers a restarted language server,
+     * which binds new ephemeral ports. Turn it off for a frontend that tears
+     * itself down on transport loss instead.
+     */
+    reconnectOnConnectionLoss = true;
+    disposeEmitter = new core_1.Emitter();
+    onDispose = this.disposeEmitter.event;
+    handle;
+    /** Set by {@link dispose}, after which {@link connect} rejects. */
+    disposed = false;
+    /** How long a connection may take before it is reported as failed; it keeps trying after. */
+    connectFailureNoticeMs = 30_000;
+    attempt;
+    attemptTimer;
+    /** Set once {@link connectionLifecycle} reports, which then owns the connection failures. */
+    reportsConnections = false;
+    /** Reports each connection generation through the {@link ConnectionReporter}. */
+    connectionLifecycle = {
+        onConnecting: () => {
+            this.reportsConnections = true;
+            this.settleAttempt();
+            const attempt = this.connectionReporter.connecting(this.connectionTarget);
+            this.attempt = attempt;
+            this.attemptTimer = setTimeout(() => {
+                attempt.failed(this.connectTimeoutMessage());
+                // The generation keeps waiting; a follow-up attempt reports it connecting.
+                this.attempt = this.connectionReporter.connecting(this.connectionTarget);
+            }, this.connectFailureNoticeMs);
+        },
+        onReady: () => this.settleAttempt(attempt => attempt.connected()),
+        onFailed: () => this.settleAttempt(attempt => attempt.failed(this.unreachableMessage()))
+    };
+    /**
+     * Open the workspace-gated channel and hand back its listening connection.
+     *
+     * Gated because the backend forwarder discovers the head's port by executing
+     * a command the language server answers, and the language server only
+     * launches once there is a workspace to launch it for. Asking earlier polls
+     * a command nobody has registered.
+     *
+     * Rejects once the port is disposed: the consumer reconnects when the
+     * dispose fires {@link onDispose}, and a channel opened then is closed by
+     * nothing.
+     */
+    connect() {
+        if (this.disposed) {
+            return Promise.reject(new Error(`${this.constructor.name}: the port is disposed`));
+        }
+        // Read per call rather than cached: `current` is repointed at a fresh
+        // promise every time the channel is re-opened, so reading through the
+        // handle is what makes a later generation reach the live server.
+        if (!this.handle) {
+            this.handle = (0, channel_connection_1.openChannelConnection)(this.connectionProvider, this.servicePath, {
+                whenReady: (0, workspace_gate_1.whenWorkspaceOpen)(this.workspaceService),
+                logger: this.logger,
+                clock: this.clock,
+                reconnect: this.reconnectOnConnectionLoss
+            });
+            // A relaunched server binds new ephemeral ports; the handle re-opens
+            // and the forwarder rediscovers, but `DataConnection` caches its
+            // generation and would go on addressing the dead one. Its signal to
+            // drop that generation is this event.
+            this.handle.onDidLoseConnection(() => this.disposeEmitter.fire(undefined));
+        }
+        return this.handle.current;
+    }
+    /**
+     * Surface a transport or write failure as a Theia notification.
+     *
+     * Swallowing it is the failure this exists to prevent: a dead connection and
+     * an empty document are indistinguishable in a widget.
+     *
+     * `reported` is already a complete sentence with the detail interpolated, so
+     * wrapping it in a sentence of the host's own would nest one owner's clause
+     * inside another's and leave no translator in control of the whole.
+     */
+    reportError(_error, reported) {
+        const connectionFailure = reported.code === protocol_1.DATA_SERVER_CONNECT_FAILED.code || reported.code === protocol_1.DATA_SERVER_NOT_READY.code;
+        const message = (0, protocol_1.renderFrameworkMessage)(reported, core_1.nls.localization?.translations);
+        if (connectionFailure && this.reportsConnections) {
+            // The reporter shows the failure without its detail, so it is kept here.
+            this.logger.warn(message);
+            return;
+        }
+        this.messageService.error(message);
+    }
+    /** End the current attempt through `settle`, or cancel it. */
+    settleAttempt(settle = attempt => attempt.cancelled()) {
+        clearTimeout(this.attemptTimer);
+        const attempt = this.attempt;
+        this.attempt = undefined;
+        if (attempt) {
+            settle(attempt);
+        }
+    }
+    get connectionTarget() {
+        return (this.cachedConnectionTarget ??= {
+            connectingMessage: core_1.nls.localize('hydranium/data-client-theia/data-server-connecting', 'Connecting to the data server…'),
+            connectedMessage: core_1.nls.localize('hydranium/data-client-theia/data-server-connected', 'Connected to the data server.')
+        });
+    }
+    /** One object per port: the reporter keys what it has shown on it. */
+    cachedConnectionTarget;
+    unreachableMessage() {
+        return core_1.nls.localize('hydranium/data-client-theia/data-server-unreachable', 'Could not connect to the data server.');
+    }
+    connectTimeoutMessage() {
+        return core_1.nls.localize('hydranium/data-client-theia/data-server-timeout', 'The data server did not answer within {0} seconds.', String(Math.round(this.connectFailureNoticeMs / 1000)));
+    }
+    dispose() {
+        this.disposed = true;
+        this.settleAttempt();
+        this.handle?.dispose();
+        this.handle = undefined;
+        this.disposeEmitter.fire(undefined);
+        this.disposeEmitter.dispose();
+    }
+};
+exports.ChannelDataPort = ChannelDataPort;
+__decorate([
+    (0, inversify_1.inject)(service_connection_provider_1.RemoteConnectionProvider),
+    __metadata("design:type", Function)
+], ChannelDataPort.prototype, "connectionProvider", void 0);
+__decorate([
+    (0, inversify_1.inject)(browser_2.WorkspaceService),
+    __metadata("design:type", browser_2.WorkspaceService)
+], ChannelDataPort.prototype, "workspaceService", void 0);
+__decorate([
+    (0, inversify_1.inject)(core_1.MessageService),
+    __metadata("design:type", core_1.MessageService)
+], ChannelDataPort.prototype, "messageService", void 0);
+__decorate([
+    (0, inversify_1.inject)(browser_1.ConnectionReporter),
+    __metadata("design:type", Object)
+], ChannelDataPort.prototype, "connectionReporter", void 0);
+__decorate([
+    (0, inversify_1.inject)(browser_1.ChannelLogger),
+    __metadata("design:type", browser_1.ChannelLogger)
+], ChannelDataPort.prototype, "logger", void 0);
+__decorate([
+    (0, inversify_1.inject)(common_1.Clock),
+    (0, inversify_1.optional)(),
+    __metadata("design:type", Object)
+], ChannelDataPort.prototype, "clock", void 0);
+exports.ChannelDataPort = ChannelDataPort = __decorate([
+    (0, inversify_1.injectable)()
+], ChannelDataPort);
+//# sourceMappingURL=channel-data-port.js.map