@hydranium/data-client-theia 1.0.0-next.123 → 1.0.0-next.127

package/README.md

@@ -41,8 +41,13 @@ text edits.
 - **`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`),
+- **`DataSessionStopContribution`** — ends a frontend's data sessions with its
+  page, so the server ends them as closed rather than waiting for the connection
+  to go, and holds the page while one of them is saving. Bind it as a
+  `FrontendApplicationContribution` and call its `track(connection)` once, where
+  the connection is bound.
+- **Backend (`./node`)** — `DataServerConnectionHandler` (the socket bridge,
+  over `@hydranium/client-theia`'s `SocketChannelForwarder`),
   `createDataServerConnectionContainerModule(...handlers)` for the
   frontend-scoped module boilerplate, and `HostDiagnosticsServer` with
   `createHostDiagnosticsBackendModule()` — which, paired with the browser-side
@@ -102,8 +107,8 @@ its loading state indefinitely with nothing in the server log to say why.
 | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
 | `.`         | 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             |
+| `./browser` | `openChannelConnection`, `createChannelConnection`, the three `Abstract*DataServiceFrontend` bases, `bindHostDiagnostics`, `whenWorkspaceOpen`, `DataSessionStopContribution` | browser / Theia frontend (gated) |
+| `./node`    | `DataServerConnectionHandler`, `createDataServerConnectionContainerModule`, `HostDiagnosticsServer`, `createHostDiagnosticsBackendModule`                                    | Node / Theia backend             |
 
 Every subpath also has a `./lib/<name>` twin for consumers on
 `moduleResolution: "Node"`. "Gated" means the repository's neutral-bundle check

package/lib/browser/data-session-stop-contribution.d.ts

@@ -0,0 +1,64 @@
+/********************************************************************************
+ * 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 { DataConnection, DataServerProtocol, DataSession, DiagnosticOf, TransferElement } from '@hydranium/protocol';
+import type { FrontendApplicationContribution, OnWillStopAction } from '@theia/core/lib/browser';
+/**
+ * Ends a Theia frontend's data sessions with its page, and holds the page
+ * while one of them is still saving. Bind it as a
+ * `FrontendApplicationContribution` in singleton scope and {@link track} each
+ * data connection the frontend binds, once.
+ *
+ * **Stop.** {@link onStop} disposes every tracked session, which sends its
+ * `closeSession`, so the server ends it as closed: each document it was the
+ * last to hold reverts at once. Otherwise the server learns of the page only
+ * when its connection goes, which Theia may hold open for its reconnect
+ * timeout, and then ends the sessions as lost, so their documents wait out the
+ * revert grace. The close is best effort: under load the page's last frames
+ * can be lost on the way, and the server then ends the sessions as lost. A
+ * session with calls still in flight at the stop closes after them, which is
+ * too late for a page going away, and is left to the server's connection-close
+ * cleanup. A call a session makes in the same tick as the stop is refused and
+ * never sent.
+ *
+ * **Veto.** While a tracked session has a save in flight, {@link onWillStop}
+ * vetoes, including a session disposed meanwhile. In Electron, Theia awaits
+ * the veto's action, which waits for the saves to answer, a save started during
+ * the wait included, up to {@link maxSettlePasses} times. The browser runs no
+ * action before unload, so there the veto shows the leave-page prompt and
+ * nothing more. Theia ignores every veto under
+ * `application.confirmExit: 'never'`, so there a save in flight at the stop
+ * may be cut off.
+ */
+export declare class DataSessionStopContribution implements FrontendApplicationContribution {
+    /** The sessions to end at the stop, and to wait for while they save. */
+    protected readonly sessions: Set<DataSession<TransferElement, DataServerProtocol<TransferElement, import("@hydranium/protocol").TransferDiagnostic, import("@hydranium/protocol").Project>>>;
+    /**
+     * How many times the veto's action waits for the saves in flight before it
+     * lets the stop go. Each wait ends by the session's own bound, so a save
+     * that never answers holds the stop for a few bounds, not for good.
+     */
+    protected readonly maxSettlePasses: number;
+    /**
+     * Take every session of `connection` into the stop: the ones it has
+     * started already, and each one it starts from now on. Generic, so a
+     * connection of any transfer root, server and client fits.
+     */
+    track<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>>, TClient extends object>(connection: DataConnection<TTransfer, TServer, TClient>): void;
+    /**
+     * Take `session` into the stop. It leaves once it has ended and its saves
+     * have answered, so a session disposed with a save in flight still holds
+     * the page.
+     */
+    protected trackSession(session: DataSession<TransferElement>): void;
+    onWillStop(): OnWillStopAction | undefined;
+    /** The tracked sessions with a save in flight. */
+    protected savingSessions(): DataSession<TransferElement>[];
+    onStop(): void;
+}
+//# sourceMappingURL=data-session-stop-contribution.d.ts.map

package/lib/browser/data-session-stop-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-session-stop-contribution.d.ts","sourceRoot":"","sources":["../../src/browser/data-session-stop-contribution.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG1H,OAAO,KAAK,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGjG;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,2BAA4B,YAAW,+BAA+B;IAChF,wEAAwE;IACxE,SAAS,CAAC,QAAQ,CAAC,QAAQ,kKAA2C;IACtE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAK;IAE/C;;;;OAIG;IACH,KAAK,CAAC,SAAS,SAAS,eAAe,EAAE,OAAO,SAAS,kBAAkB,CAAC,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,SAAS,MAAM,EAClI,UAAU,EAAE,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,GACvD,IAAI;IAKP;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,GAAG,IAAI;IAcnE,UAAU,IAAI,gBAAgB,GAAG,SAAS;IAsB1C,kDAAkD;IAClD,SAAS,CAAC,cAAc,IAAI,WAAW,CAAC,eAAe,CAAC,EAAE;IAI1D,MAAM,IAAI,IAAI;CAKhB"}

package/lib/browser/data-session-stop-contribution.js

@@ -0,0 +1,117 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataSessionStopContribution = void 0;
+const inversify_1 = require("@theia/core/shared/inversify");
+/**
+ * Ends a Theia frontend's data sessions with its page, and holds the page
+ * while one of them is still saving. Bind it as a
+ * `FrontendApplicationContribution` in singleton scope and {@link track} each
+ * data connection the frontend binds, once.
+ *
+ * **Stop.** {@link onStop} disposes every tracked session, which sends its
+ * `closeSession`, so the server ends it as closed: each document it was the
+ * last to hold reverts at once. Otherwise the server learns of the page only
+ * when its connection goes, which Theia may hold open for its reconnect
+ * timeout, and then ends the sessions as lost, so their documents wait out the
+ * revert grace. The close is best effort: under load the page's last frames
+ * can be lost on the way, and the server then ends the sessions as lost. A
+ * session with calls still in flight at the stop closes after them, which is
+ * too late for a page going away, and is left to the server's connection-close
+ * cleanup. A call a session makes in the same tick as the stop is refused and
+ * never sent.
+ *
+ * **Veto.** While a tracked session has a save in flight, {@link onWillStop}
+ * vetoes, including a session disposed meanwhile. In Electron, Theia awaits
+ * the veto's action, which waits for the saves to answer, a save started during
+ * the wait included, up to {@link maxSettlePasses} times. The browser runs no
+ * action before unload, so there the veto shows the leave-page prompt and
+ * nothing more. Theia ignores every veto under
+ * `application.confirmExit: 'never'`, so there a save in flight at the stop
+ * may be cut off.
+ */
+let DataSessionStopContribution = class DataSessionStopContribution {
+    /** The sessions to end at the stop, and to wait for while they save. */
+    sessions = new Set();
+    /**
+     * How many times the veto's action waits for the saves in flight before it
+     * lets the stop go. Each wait ends by the session's own bound, so a save
+     * that never answers holds the stop for a few bounds, not for good.
+     */
+    maxSettlePasses = 3;
+    /**
+     * Take every session of `connection` into the stop: the ones it has
+     * started already, and each one it starts from now on. Generic, so a
+     * connection of any transfer root, server and client fits.
+     */
+    track(connection) {
+        connection.liveSessions.forEach(session => this.trackSession(session));
+        connection.onDidCreateSession(session => this.trackSession(session));
+    }
+    /**
+     * Take `session` into the stop. It leaves once it has ended and its saves
+     * have answered, so a session disposed with a save in flight still holds
+     * the page.
+     */
+    trackSession(session) {
+        this.sessions.add(session);
+        // A save can outlast the wait's bound, so the session stays until none
+        // is left in flight.
+        const release = () => void session.whenSavesSettled().then(() => (session.hasSavesInFlight ? release() : this.sessions.delete(session)));
+        // An ended session has fired its event already, and never fires it again.
+        if (session.isDisposed) {
+            release();
+        }
+        else {
+            session.onDidDispose(release);
+        }
+    }
+    onWillStop() {
+        if (this.savingSessions().length === 0) {
+            return undefined;
+        }
+        return {
+            // Theia logs the reason and shows it nowhere, so it is not translated.
+            reason: 'Data sessions are saving',
+            action: async () => {
+                // The page stays usable while Theia awaits this, so a save can
+                // start during a wait; each pass waits for the saves then in flight.
+                for (let pass = 0; pass < this.maxSettlePasses; pass++) {
+                    const saving = this.savingSessions();
+                    if (saving.length === 0) {
+                        break;
+                    }
+                    await Promise.all(saving.map(session => session.whenSavesSettled()));
+                }
+                return true;
+            }
+        };
+    }
+    /** The tracked sessions with a save in flight. */
+    savingSessions() {
+        return [...this.sessions].filter(session => session.hasSavesInFlight);
+    }
+    onStop() {
+        for (const session of this.sessions) {
+            session.dispose();
+        }
+    }
+};
+exports.DataSessionStopContribution = DataSessionStopContribution;
+exports.DataSessionStopContribution = DataSessionStopContribution = __decorate([
+    (0, inversify_1.injectable)()
+], DataSessionStopContribution);
+//# sourceMappingURL=data-session-stop-contribution.js.map

package/lib/browser/data-session-stop-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-session-stop-contribution.js","sourceRoot":"","sources":["../../src/browser/data-session-stop-contribution.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;AAMlF,4DAA0D;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACrC,wEAAwE;IACrD,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IACtE;;;;OAIG;IACgB,eAAe,GAAW,CAAC,CAAC;IAE/C;;;;OAIG;IACH,KAAK,CACF,UAAuD;QAEvD,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,UAAU,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACO,YAAY,CAAC,OAAqC;QACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,uEAAuE;QACvE,qBAAqB;QACrB,MAAM,OAAO,GAAG,GAAS,EAAE,CACxB,KAAK,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtH,0EAA0E;QAC1E,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACL,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACJ,CAAC;IAED,UAAU;QACP,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QACpB,CAAC;QACD,OAAO;YACJ,uEAAuE;YACvE,MAAM,EAAE,0BAA0B;YAClC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAChB,+DAA+D;gBAC/D,qEAAqE;gBACrE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;oBACtD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;oBACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACvB,MAAM;oBACT,CAAC;oBACD,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;gBACxE,CAAC;gBACD,OAAO,IAAI,CAAC;YACf,CAAC;SACH,CAAC;IACL,CAAC;IAED,kDAAkD;IACxC,cAAc;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED,MAAM;QACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACJ,CAAC;CACH,CAAA;AAzEY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;GACA,2BAA2B,CAyEvC"}

package/lib/browser/index.d.ts

@@ -8,6 +8,7 @@
  ********************************************************************************/
 export * from './channel-connection';
 export * from './channel-data-port';
+export * from './data-session-stop-contribution';
 export * from './host-diagnostics-frontend';
 export * from './workspace-gate';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC"}

package/lib/browser/index.js

@@ -24,6 +24,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./channel-connection"), exports);
 __exportStar(require("./channel-data-port"), exports);
+__exportStar(require("./data-session-stop-contribution"), exports);
 __exportStar(require("./host-diagnostics-frontend"), exports);
 __exportStar(require("./workspace-gate"), exports);
 //# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,uDAAqC;AACrC,sDAAoC;AACpC,8DAA4C;AAC5C,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,uDAAqC;AACrC,sDAAoC;AACpC,mEAAiD;AACjD,8DAA4C;AAC5C,mDAAiC"}

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

@@ -6,7 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import type { DataClientProtocol, Project, ProjectsChangedEvent, TransferDiagnostic, TransferDocumentDeletedEvent, TransferDocumentSavedEvent, TransferDocumentsBuiltEvent, TransferDocumentUpdatedEvent, TransferElement } from '@hydranium/protocol';
+import type { DataClientProtocol, Project, ProjectsChangedEvent, TransferDiagnostic, TransferDocumentDeletedEvent, TransferDocumentDirtyChangedEvent, TransferDocumentSavedEvent, TransferDocumentsBuiltEvent, TransferDocumentUpdatedEvent, TransferElement } from '@hydranium/protocol';
 import { Emitter, type Event } from '@theia/core';
 /**
  * Default {@link DataClientProtocol} implementation for a Theia frontend:
@@ -30,6 +30,9 @@ export declare class EmitterDataClient<TTransfer extends TransferElement, TDiagn
     protected readonly onDocumentSavedEmitter: Emitter<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
     /** Fires for each inbound {@link onDocumentSaved} notification. */
     readonly onDidSaveDocument: Event<TransferDocumentSavedEvent<TTransfer, TDiagnostic>>;
+    protected readonly onDocumentDirtyChangedEmitter: Emitter<TransferDocumentDirtyChangedEvent>;
+    /** Fires for each inbound {@link onDocumentDirtyChanged} notification. */
+    readonly onDidChangeDocumentDirty: Event<TransferDocumentDirtyChangedEvent>;
     protected readonly onDocumentDeletedEmitter: Emitter<TransferDocumentDeletedEvent>;
     /** Fires for each inbound {@link onDocumentDeleted} notification. */
     readonly onDidDeleteDocument: Event<TransferDocumentDeletedEvent>;
@@ -41,6 +44,7 @@ export declare class EmitterDataClient<TTransfer extends TransferElement, TDiagn
     readonly onDidChangeProjects: Event<ProjectsChangedEvent<TProject>>;
     onDocumentUpdated(event: TransferDocumentUpdatedEvent<TTransfer, TDiagnostic>): void;
     onDocumentSaved(event: TransferDocumentSavedEvent<TTransfer, TDiagnostic>): void;
+    onDocumentDirtyChanged(event: TransferDocumentDirtyChangedEvent): void;
     onDocumentDeleted(event: TransferDocumentDeletedEvent): void;
     onDocumentsBuilt(event: TransferDocumentsBuiltEvent): void;
     onProjectsChanged(event: ProjectsChangedEvent<TProject>): void;

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

@@ -1 +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,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,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,wCAA+C;IAC1F,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAuC;IAExG,SAAS,CAAC,QAAQ,CAAC,uBAAuB,uCAA8C;IACxF,oEAAoE;IACpE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,2BAA2B,CAAC,CAAsC;IAEtG,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,4BAA4B,GAAG,IAAI;IAI5D,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI;IAI1D,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI;CAGhE"}
+{"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,4BAA4B,EAC5B,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,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,6BAA6B,6CAAoD;IACpG,0EAA0E;IAC1E,QAAQ,CAAC,wBAAwB,EAAE,KAAK,CAAC,iCAAiC,CAAC,CAA4C;IAEvH,SAAS,CAAC,QAAQ,CAAC,wBAAwB,wCAA+C;IAC1F,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAuC;IAExG,SAAS,CAAC,QAAQ,CAAC,uBAAuB,uCAA8C;IACxF,oEAAoE;IACpE,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,2BAA2B,CAAC,CAAsC;IAEtG,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,sBAAsB,CAAC,KAAK,EAAE,iCAAiC,GAAG,IAAI;IAItE,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI;IAI5D,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,GAAG,IAAI;IAI1D,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GAAG,IAAI;CAGhE"}

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

@@ -32,6 +32,9 @@ class EmitterDataClient {
     onDocumentSavedEmitter = new core_1.Emitter();
     /** Fires for each inbound {@link onDocumentSaved} notification. */
     onDidSaveDocument = this.onDocumentSavedEmitter.event;
+    onDocumentDirtyChangedEmitter = new core_1.Emitter();
+    /** Fires for each inbound {@link onDocumentDirtyChanged} notification. */
+    onDidChangeDocumentDirty = this.onDocumentDirtyChangedEmitter.event;
     onDocumentDeletedEmitter = new core_1.Emitter();
     /** Fires for each inbound {@link onDocumentDeleted} notification. */
     onDidDeleteDocument = this.onDocumentDeletedEmitter.event;
@@ -47,6 +50,9 @@ class EmitterDataClient {
     onDocumentSaved(event) {
         this.onDocumentSavedEmitter.fire(event);
     }
+    onDocumentDirtyChanged(event) {
+        this.onDocumentDirtyChangedEmitter.fire(event);
+    }
     onDocumentDeleted(event) {
         this.onDocumentDeletedEmitter.fire(event);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"emitter-data-client.js","sourceRoot":"","sources":["../../src/common/emitter-data-client.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAalF,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,EAAgC,CAAC;IAC1F,qEAAqE;IAC5D,mBAAmB,GAAwC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAErF,uBAAuB,GAAG,IAAI,cAAO,EAA+B,CAAC;IACxF,oEAAoE;IAC3D,mBAAmB,GAAuC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;IAEnF,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,KAAmC;QAClD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,gBAAgB,CAAC,KAAkC;QAChD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB,CAAC,KAAqC;QACpD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACH;AA5CD,8CA4CC"}
+{"version":3,"file":"emitter-data-client.js","sourceRoot":"","sources":["../../src/common/emitter-data-client.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAclF,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,6BAA6B,GAAG,IAAI,cAAO,EAAqC,CAAC;IACpG,0EAA0E;IACjE,wBAAwB,GAA6C,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC;IAEpG,wBAAwB,GAAG,IAAI,cAAO,EAAgC,CAAC;IAC1F,qEAAqE;IAC5D,mBAAmB,GAAwC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;IAErF,uBAAuB,GAAG,IAAI,cAAO,EAA+B,CAAC;IACxF,oEAAoE;IAC3D,mBAAmB,GAAuC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;IAEnF,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,sBAAsB,CAAC,KAAwC;QAC5D,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,iBAAiB,CAAC,KAAmC;QAClD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,gBAAgB,CAAC,KAAkC;QAChD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB,CAAC,KAAqC;QACpD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;CACH;AApDD,8CAoDC"}

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

@@ -7,7 +7,6 @@
  * 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
@@ -51,16 +50,12 @@ export interface DataServerConnectionHandlerOptions {
  * 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`.
+ * The port discovery, the buffer-and-replay race fix, the connect orchestration
+ * and the byte forwarder live on the cross-head
+ * {@link AbstractSocketForwardingConnectionHandler} base; this subclass supplies
+ * only the data-server defaults (service path / port command / log labels).
  */
 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

@@ -1 +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;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,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"}
+{"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;AAG7F,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AAErC;;;;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;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,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;;;;;;;;GAQG;AACH,qBACa,2BAA4B,SAAQ,yCAAyC;gBAC9D,OAAO,GAAE,kCAAuC;CAY3E"}

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

@@ -24,18 +24,14 @@ 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`.
+ * The port discovery, the buffer-and-replay race fix, the connect orchestration
+ * and the byte forwarder live on the cross-head
+ * {@link AbstractSocketForwardingConnectionHandler} base; this subclass supplies
+ * only the data-server defaults (service path / port command / log labels).
  */
 let DataServerConnectionHandler = class DataServerConnectionHandler extends node_1.AbstractSocketForwardingConnectionHandler {
     constructor(options = {}) {
@@ -50,9 +46,6 @@ let DataServerConnectionHandler = class DataServerConnectionHandler extends node
             onSocketCreated: options.onSocketCreated
         });
     }
-    forwardToSocketConnection(clientChannel, socket) {
-        return new socket_channel_forwarder_1.SocketChannelForwarder(clientChannel, socket);
-    }
 };
 exports.DataServerConnectionHandler = DataServerConnectionHandler;
 exports.DataServerConnectionHandler = DataServerConnectionHandler = __decorate([

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

@@ -1 +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;AAyCpE;;;;;;;;;;;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,OAAO,CAAC,UAAU,IAAI,cAAc;YAChD,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"}
+{"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;AACjF,4DAAqE;AA0CrE;;;;;;;;GAQG;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,OAAO,CAAC,UAAU,IAAI,cAAc;YAChD,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;CACH,CAAA;AAbY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,sBAAU,GAAE;IAEG,WAAA,IAAA,qBAAS,GAAE,CAAA;;GADd,2BAA2B,CAavC"}

package/lib/node/index.d.ts

@@ -9,5 +9,4 @@
 export * from './connection-container-module';
 export * from './data-server-connection-handler';
 export * from './host-diagnostics-server';
-export * from './socket-channel-forwarder';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC"}

package/lib/node/index.js

@@ -25,5 +25,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./connection-container-module"), exports);
 __exportStar(require("./data-server-connection-handler"), exports);
 __exportStar(require("./host-diagnostics-server"), exports);
-__exportStar(require("./socket-channel-forwarder"), exports);
 //# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,gEAA8C;AAC9C,mEAAiD;AACjD,4DAA0C;AAC1C,6DAA2C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,gEAA8C;AAC9C,mEAAiD;AACjD,4DAA0C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydranium/data-client-theia",
-  "version": "1.0.0-next.123",
+  "version": "1.0.0-next.127",
   "description": "Theia-coupled client primitives for the hydranium data-server protocol head; companion of @hydranium/data-server. Bridges framework typed errors (e.g. ConflictError) across Theia's RPC boundary so their code + data survive the wire.",
   "keywords": [
     "hydranium",
@@ -70,9 +70,9 @@
     "watch": "tsc -b -w --preserveWatchOutput"
   },
   "devDependencies": {
-    "@hydranium/client-theia": "1.0.0-next.123",
-    "@hydranium/core": "1.0.0-next.123",
-    "@hydranium/protocol": "1.0.0-next.123",
+    "@hydranium/client-theia": "1.0.0-next.127",
+    "@hydranium/core": "1.0.0-next.127",
+    "@hydranium/protocol": "1.0.0-next.127",
     "@theia/core": "^1.70.0",
     "@theia/workspace": "^1.70.0",
     "@types/node": "^22.0.0",
@@ -83,9 +83,9 @@
     "vscode-jsonrpc": "9.0.1"
   },
   "peerDependencies": {
-    "@hydranium/client-theia": "1.0.0-next.123",
-    "@hydranium/core": "1.0.0-next.123",
-    "@hydranium/protocol": "1.0.0-next.123",
+    "@hydranium/client-theia": "1.0.0-next.127",
+    "@hydranium/core": "1.0.0-next.127",
+    "@hydranium/protocol": "1.0.0-next.127",
     "@theia/core": "^1.70.0",
     "@theia/workspace": "^1.70.0",
     "inversify": "^6.0.0",

package/src/browser/data-session-stop-contribution.ts

@@ -0,0 +1,117 @@
+/********************************************************************************
+ * 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 { DataConnection, DataServerProtocol, DataSession, DiagnosticOf, TransferElement } from '@hydranium/protocol';
+// Type-only: the `@theia/core/lib/browser` barrel touches DOM globals at module
+// load, which the node-environment unit tests cannot provide.
+import type { FrontendApplicationContribution, OnWillStopAction } from '@theia/core/lib/browser';
+import { injectable } from '@theia/core/shared/inversify';
+
+/**
+ * Ends a Theia frontend's data sessions with its page, and holds the page
+ * while one of them is still saving. Bind it as a
+ * `FrontendApplicationContribution` in singleton scope and {@link track} each
+ * data connection the frontend binds, once.
+ *
+ * **Stop.** {@link onStop} disposes every tracked session, which sends its
+ * `closeSession`, so the server ends it as closed: each document it was the
+ * last to hold reverts at once. Otherwise the server learns of the page only
+ * when its connection goes, which Theia may hold open for its reconnect
+ * timeout, and then ends the sessions as lost, so their documents wait out the
+ * revert grace. The close is best effort: under load the page's last frames
+ * can be lost on the way, and the server then ends the sessions as lost. A
+ * session with calls still in flight at the stop closes after them, which is
+ * too late for a page going away, and is left to the server's connection-close
+ * cleanup. A call a session makes in the same tick as the stop is refused and
+ * never sent.
+ *
+ * **Veto.** While a tracked session has a save in flight, {@link onWillStop}
+ * vetoes, including a session disposed meanwhile. In Electron, Theia awaits
+ * the veto's action, which waits for the saves to answer, a save started during
+ * the wait included, up to {@link maxSettlePasses} times. The browser runs no
+ * action before unload, so there the veto shows the leave-page prompt and
+ * nothing more. Theia ignores every veto under
+ * `application.confirmExit: 'never'`, so there a save in flight at the stop
+ * may be cut off.
+ */
+@injectable()
+export class DataSessionStopContribution implements FrontendApplicationContribution {
+   /** The sessions to end at the stop, and to wait for while they save. */
+   protected readonly sessions = new Set<DataSession<TransferElement>>();
+   /**
+    * How many times the veto's action waits for the saves in flight before it
+    * lets the stop go. Each wait ends by the session's own bound, so a save
+    * that never answers holds the stop for a few bounds, not for good.
+    */
+   protected readonly maxSettlePasses: number = 3;
+
+   /**
+    * Take every session of `connection` into the stop: the ones it has
+    * started already, and each one it starts from now on. Generic, so a
+    * connection of any transfer root, server and client fits.
+    */
+   track<TTransfer extends TransferElement, TServer extends DataServerProtocol<TTransfer, DiagnosticOf<TServer>>, TClient extends object>(
+      connection: DataConnection<TTransfer, TServer, TClient>
+   ): void {
+      connection.liveSessions.forEach(session => this.trackSession(session));
+      connection.onDidCreateSession(session => this.trackSession(session));
+   }
+
+   /**
+    * Take `session` into the stop. It leaves once it has ended and its saves
+    * have answered, so a session disposed with a save in flight still holds
+    * the page.
+    */
+   protected trackSession(session: DataSession<TransferElement>): void {
+      this.sessions.add(session);
+      // A save can outlast the wait's bound, so the session stays until none
+      // is left in flight.
+      const release = (): void =>
+         void session.whenSavesSettled().then(() => (session.hasSavesInFlight ? release() : this.sessions.delete(session)));
+      // An ended session has fired its event already, and never fires it again.
+      if (session.isDisposed) {
+         release();
+      } else {
+         session.onDidDispose(release);
+      }
+   }
+
+   onWillStop(): OnWillStopAction | undefined {
+      if (this.savingSessions().length === 0) {
+         return undefined;
+      }
+      return {
+         // Theia logs the reason and shows it nowhere, so it is not translated.
+         reason: 'Data sessions are saving',
+         action: async () => {
+            // The page stays usable while Theia awaits this, so a save can
+            // start during a wait; each pass waits for the saves then in flight.
+            for (let pass = 0; pass < this.maxSettlePasses; pass++) {
+               const saving = this.savingSessions();
+               if (saving.length === 0) {
+                  break;
+               }
+               await Promise.all(saving.map(session => session.whenSavesSettled()));
+            }
+            return true;
+         }
+      };
+   }
+
+   /** The tracked sessions with a save in flight. */
+   protected savingSessions(): DataSession<TransferElement>[] {
+      return [...this.sessions].filter(session => session.hasSavesInFlight);
+   }
+
+   onStop(): void {
+      for (const session of this.sessions) {
+         session.dispose();
+      }
+   }
+}

package/src/browser/index.ts

@@ -9,5 +9,6 @@
 
 export * from './channel-connection';
 export * from './channel-data-port';
+export * from './data-session-stop-contribution';
 export * from './host-diagnostics-frontend';
 export * from './workspace-gate';

package/src/common/emitter-data-client.ts

@@ -13,6 +13,7 @@ import type {
    ProjectsChangedEvent,
    TransferDiagnostic,
    TransferDocumentDeletedEvent,
+   TransferDocumentDirtyChangedEvent,
    TransferDocumentSavedEvent,
    TransferDocumentsBuiltEvent,
    TransferDocumentUpdatedEvent,
@@ -48,6 +49,10 @@ export class EmitterDataClient<
    /** Fires for each inbound {@link onDocumentSaved} notification. */
    readonly onDidSaveDocument: Event<TransferDocumentSavedEvent<TTransfer, TDiagnostic>> = this.onDocumentSavedEmitter.event;
 
+   protected readonly onDocumentDirtyChangedEmitter = new Emitter<TransferDocumentDirtyChangedEvent>();
+   /** Fires for each inbound {@link onDocumentDirtyChanged} notification. */
+   readonly onDidChangeDocumentDirty: Event<TransferDocumentDirtyChangedEvent> = this.onDocumentDirtyChangedEmitter.event;
+
    protected readonly onDocumentDeletedEmitter = new Emitter<TransferDocumentDeletedEvent>();
    /** Fires for each inbound {@link onDocumentDeleted} notification. */
    readonly onDidDeleteDocument: Event<TransferDocumentDeletedEvent> = this.onDocumentDeletedEmitter.event;
@@ -68,6 +73,10 @@ export class EmitterDataClient<
       this.onDocumentSavedEmitter.fire(event);
    }
 
+   onDocumentDirtyChanged(event: TransferDocumentDirtyChangedEvent): void {
+      this.onDocumentDirtyChangedEmitter.fire(event);
+   }
+
    onDocumentDeleted(event: TransferDocumentDeletedEvent): void {
       this.onDocumentDeletedEmitter.fire(event);
    }

package/src/node/data-server-connection-handler.ts

@@ -9,10 +9,8 @@
 
 import { AbstractSocketForwardingConnectionHandler } from '@hydranium/client-theia/lib/node';
 import { DATA_SERVER_PATH, DATA_SERVER_PORT_COMMAND } from '@hydranium/protocol';
-import { type Channel, type Disposable } from '@theia/core';
 import { injectable, unmanaged } from '@theia/core/shared/inversify';
 import type * as net from 'node:net';
-import { SocketChannelForwarder } from './socket-channel-forwarder';
 
 /** Options for {@link DataServerConnectionHandler}. `servicePath` is the Theia
  *  service path the browser frontend opens a channel to; `portCommand` is the
@@ -57,13 +55,10 @@ export interface DataServerConnectionHandlerOptions {
  * 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`.
+ * The port discovery, the buffer-and-replay race fix, the connect orchestration
+ * and the byte forwarder live on the cross-head
+ * {@link AbstractSocketForwardingConnectionHandler} base; this subclass supplies
+ * only the data-server defaults (service path / port command / log labels).
  */
 @injectable()
 export class DataServerConnectionHandler extends AbstractSocketForwardingConnectionHandler {
@@ -79,8 +74,4 @@ export class DataServerConnectionHandler extends AbstractSocketForwardingConnect
          onSocketCreated: options.onSocketCreated
       });
    }
-
-   protected forwardToSocketConnection(clientChannel: Channel, socket: net.Socket): Disposable {
-      return new SocketChannelForwarder(clientChannel, socket);
-   }
 }

package/src/node/index.ts

@@ -10,4 +10,3 @@
 export * from './connection-container-module';
 export * from './data-server-connection-handler';
 export * from './host-diagnostics-server';
-export * from './socket-channel-forwarder';

package/lib/node/socket-channel-forwarder.d.ts

@@ -1,34 +0,0 @@
-/********************************************************************************
- * 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 Channel, Disposable, DisposableCollection, type MessageProvider } from '@theia/core';
-import type * as net from 'node:net';
-import { type Message } from 'vscode-jsonrpc/node';
-/**
- * Relays JSON-RPC messages between a Theia browser-frontend {@link Channel} and
- * a data-server's TCP socket — the backend half of the data-server head's
- * transport. The model-server speaks vscode-jsonrpc (Content-Length framed) on
- * the socket; the frontend speaks the same protocol over the channel (via
- * `createChannelConnection`). This forwarder decodes each side and re-emits on
- * the other, so the two ends share one protocol with no semantic re-proxy in
- * between.
- *
- * Framework-owned equivalent of `@eclipse-glsp/theia-integration`'s
- * `SocketConnectionForwarder` — reproduced here (rather than imported) so the
- * data-server head carries no GLSP dependency.
- */
-export declare class SocketChannelForwarder implements Disposable {
-    protected readonly channel: Channel;
-    protected readonly socket: net.Socket;
-    protected readonly toDispose: DisposableCollection;
-    constructor(channel: Channel, socket: net.Socket);
-    protected decodeChannelMessage(provider: MessageProvider): Message;
-    protected writeToChannel(message: Message): void;
-    dispose(): void;
-}
-//# sourceMappingURL=socket-channel-forwarder.d.ts.map

package/lib/node/socket-channel-forwarder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-channel-forwarder.d.ts","sourceRoot":"","sources":["../../src/node/socket-channel-forwarder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AACrC,OAAO,EAA2B,KAAK,OAAO,EAA4C,MAAM,qBAAqB,CAAC;AAEtH;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,UAAU;IAInD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM;IAJxC,SAAS,CAAC,QAAQ,CAAC,SAAS,uBAA8B;gBAGpC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,GAAG,CAAC,MAAM;IAuBxC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAKlE,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMhD,OAAO,IAAI,IAAI;CAGjB"}

package/lib/node/socket-channel-forwarder.js

@@ -1,68 +0,0 @@
-"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.SocketChannelForwarder = void 0;
-const core_1 = require("@theia/core");
-const node_1 = require("vscode-jsonrpc/node");
-/**
- * Relays JSON-RPC messages between a Theia browser-frontend {@link Channel} and
- * a data-server's TCP socket — the backend half of the data-server head's
- * transport. The model-server speaks vscode-jsonrpc (Content-Length framed) on
- * the socket; the frontend speaks the same protocol over the channel (via
- * `createChannelConnection`). This forwarder decodes each side and re-emits on
- * the other, so the two ends share one protocol with no semantic re-proxy in
- * between.
- *
- * Framework-owned equivalent of `@eclipse-glsp/theia-integration`'s
- * `SocketConnectionForwarder` — reproduced here (rather than imported) so the
- * data-server head carries no GLSP dependency.
- */
-class SocketChannelForwarder {
-    channel;
-    socket;
-    toDispose = new core_1.DisposableCollection();
-    constructor(channel, socket) {
-        this.channel = channel;
-        this.socket = socket;
-        const reader = new node_1.SocketMessageReader(socket);
-        const writer = new node_1.SocketMessageWriter(socket);
-        const connection = (0, node_1.createMessageConnection)(reader, writer);
-        // Nothing here destroys the socket, and adding it back would be dead
-        // code in both directions. `SocketMessageWriter.dispose()` destroys it
-        // itself, which covers the dispose path; and `connection.onClose` fires
-        // only from the reader's or writer's own close, which for a socket means
-        // the socket has already gone — so a destroy handler there is downstream
-        // of the effect it would be trying to cause.
-        this.toDispose.pushAll([
-            reader.listen(message => this.writeToChannel(message)),
-            channel.onMessage(provider => void writer.write(this.decodeChannelMessage(provider))),
-            channel.onClose(() => connection.dispose()),
-            connection.onClose(() => channel.close()),
-            core_1.Disposable.create(() => {
-                channel.close();
-                connection.dispose();
-            })
-        ]);
-    }
-    decodeChannelMessage(provider) {
-        const buffer = provider().readBytes();
-        return JSON.parse(new TextDecoder().decode(buffer));
-    }
-    writeToChannel(message) {
-        const writeBuffer = this.channel.getWriteBuffer();
-        writeBuffer.writeBytes(new TextEncoder().encode(JSON.stringify(message)));
-        writeBuffer.commit();
-    }
-    dispose() {
-        this.toDispose.dispose();
-    }
-}
-exports.SocketChannelForwarder = SocketChannelForwarder;
-//# sourceMappingURL=socket-channel-forwarder.js.map

package/lib/node/socket-channel-forwarder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-channel-forwarder.js","sourceRoot":"","sources":["../../src/node/socket-channel-forwarder.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;AAElF,sCAAmG;AAEnG,8CAAsH;AAEtH;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAsB;IAIV;IACA;IAJH,SAAS,GAAG,IAAI,2BAAoB,EAAE,CAAC;IAE1D,YACsB,OAAgB,EAChB,MAAkB;QADlB,YAAO,GAAP,OAAO,CAAS;QAChB,WAAM,GAAN,MAAM,CAAY;QAErC,MAAM,MAAM,GAAG,IAAI,0BAAmB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,0BAAmB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAA,8BAAuB,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3D,qEAAqE;QACrE,uEAAuE;QACvE,wEAAwE;QACxE,yEAAyE;QACzE,yEAAyE;QACzE,6CAA6C;QAC7C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACtD,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrF,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC3C,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACzC,iBAAU,CAAC,MAAM,CAAC,GAAG,EAAE;gBACpB,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC;SACJ,CAAC,CAAC;IACN,CAAC;IAES,oBAAoB,CAAC,QAAyB;QACrD,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAY,CAAC;IAClE,CAAC;IAES,cAAc,CAAC,OAAgB;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,WAAW,CAAC,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1E,WAAW,CAAC,MAAM,EAAE,CAAC;IACxB,CAAC;IAED,OAAO;QACJ,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACH;AA1CD,wDA0CC"}

package/src/node/socket-channel-forwarder.ts

@@ -1,69 +0,0 @@
-/********************************************************************************
- * 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 Channel, Disposable, DisposableCollection, type MessageProvider } from '@theia/core';
-import type * as net from 'node:net';
-import { createMessageConnection, type Message, SocketMessageReader, SocketMessageWriter } from 'vscode-jsonrpc/node';
-
-/**
- * Relays JSON-RPC messages between a Theia browser-frontend {@link Channel} and
- * a data-server's TCP socket — the backend half of the data-server head's
- * transport. The model-server speaks vscode-jsonrpc (Content-Length framed) on
- * the socket; the frontend speaks the same protocol over the channel (via
- * `createChannelConnection`). This forwarder decodes each side and re-emits on
- * the other, so the two ends share one protocol with no semantic re-proxy in
- * between.
- *
- * Framework-owned equivalent of `@eclipse-glsp/theia-integration`'s
- * `SocketConnectionForwarder` — reproduced here (rather than imported) so the
- * data-server head carries no GLSP dependency.
- */
-export class SocketChannelForwarder implements Disposable {
-   protected readonly toDispose = new DisposableCollection();
-
-   constructor(
-      protected readonly channel: Channel,
-      protected readonly socket: net.Socket
-   ) {
-      const reader = new SocketMessageReader(socket);
-      const writer = new SocketMessageWriter(socket);
-      const connection = createMessageConnection(reader, writer);
-      // Nothing here destroys the socket, and adding it back would be dead
-      // code in both directions. `SocketMessageWriter.dispose()` destroys it
-      // itself, which covers the dispose path; and `connection.onClose` fires
-      // only from the reader's or writer's own close, which for a socket means
-      // the socket has already gone — so a destroy handler there is downstream
-      // of the effect it would be trying to cause.
-      this.toDispose.pushAll([
-         reader.listen(message => this.writeToChannel(message)),
-         channel.onMessage(provider => void writer.write(this.decodeChannelMessage(provider))),
-         channel.onClose(() => connection.dispose()),
-         connection.onClose(() => channel.close()),
-         Disposable.create(() => {
-            channel.close();
-            connection.dispose();
-         })
-      ]);
-   }
-
-   protected decodeChannelMessage(provider: MessageProvider): Message {
-      const buffer = provider().readBytes();
-      return JSON.parse(new TextDecoder().decode(buffer)) as Message;
-   }
-
-   protected writeToChannel(message: Message): void {
-      const writeBuffer = this.channel.getWriteBuffer();
-      writeBuffer.writeBytes(new TextEncoder().encode(JSON.stringify(message)));
-      writeBuffer.commit();
-   }
-
-   dispose(): void {
-      this.toDispose.dispose();
-   }
-}