@hydranium/data-client-vscode 0.0.0-stage → 1.0.0-next.315

package/lib/messenger-channel.js

@@ -0,0 +1,106 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_TO_EXTENSION = exports.DATA_TO_WEBVIEW = void 0;
+exports.createMessengerChannel = createMessengerChannel;
+exports.createExtensionSideChannel = createExtensionSideChannel;
+exports.createWebviewSideChannel = createWebviewSideChannel;
+/**
+ * The data head's two notification types, one per direction.
+ *
+ * `vscode-messenger` addresses a notification to its receiver, so one method
+ * for both directions would also deliver correctly. Two keep the direction
+ * readable on the wire and in a messenger trace, and keep a delivery that
+ * routes by method alone, such as `BROADCAST`, from reaching the sender's own
+ * handler.
+ */
+exports.DATA_TO_WEBVIEW = { method: 'hydranium/data/toWebview' };
+exports.DATA_TO_EXTENSION = { method: 'hydranium/data/toExtension' };
+/**
+ * Present a messenger as a {@link PostMessageChannel}, so the data head's
+ * transport rides a host's existing notification hop.
+ *
+ * `createPostMessageTransport` turns the channel into a reader and writer,
+ * `relayToPostMessageChannel` pumps the extension host's socket onto it from
+ * the other side, and everything above, `createRpcProxy` and `DataSession`
+ * included, is host-invariant. Sharing GLSP's `Messenger` rather than opening a
+ * second hop gives a diagram and a data webview one lifecycle and one dispose.
+ *
+ * **`onMessage`'s `Disposable` means "stop delivering", not necessarily
+ * "unregister".** The webview-side messenger cannot unregister, so a flag keeps
+ * the promise on both sides. Where unregistering is possible,
+ * {@link MessengerChannelOptions.releaseRegistration} does it too, or every
+ * disposed webview would leave a handler on a shared hop.
+ */
+function createMessengerChannel(options) {
+    const { messenger, receiver, outbound, inbound, sender, onClose, releaseRegistration } = options;
+    return {
+        post(message) {
+            messenger.sendNotification(outbound, receiver, message);
+        },
+        onMessage(listener) {
+            let delivering = true;
+            const registration = messenger.onNotification(inbound, message => {
+                if (delivering) {
+                    listener(message);
+                }
+            }, sender ? { sender } : undefined);
+            return {
+                dispose: () => {
+                    delivering = false;
+                    releaseRegistration?.(registration);
+                }
+            };
+        },
+        ...(onClose ? { onClose } : {})
+    };
+}
+/**
+ * The extension host's end: posts toward the webview, listens for what the
+ * webview sends.
+ */
+function createExtensionSideChannel(messenger, webview, onClose) {
+    return createMessengerChannel({
+        messenger,
+        receiver: webview,
+        outbound: exports.DATA_TO_WEBVIEW,
+        inbound: exports.DATA_TO_EXTENSION,
+        // Only this webview's traffic, since the hop is shared.
+        sender: webview,
+        onClose,
+        // This side can unregister, and must: the hop outlives every webview on it.
+        releaseRegistration: registration => registration.dispose()
+    });
+}
+/**
+ * The webview's end: the mirror image, addressed at the extension host.
+ *
+ * Two preconditions the webview's bootstrap owns, both of which present as "no
+ * data ever arrives" when missed:
+ *
+ * - **Read the channel through `WebviewDataPort`**, or build its connection
+ *   with `createMessageConnection` from `vscode-jsonrpc/browser`: the package
+ *   root installs no runtime abstraction layer and throws on the first
+ *   message.
+ * - **Call the messenger's own `start()`**, which attaches the `window`
+ *   listener.
+ *
+ * No `sender` filter: a webview has one peer.
+ */
+function createWebviewSideChannel(messenger, hostExtension, onClose) {
+    return createMessengerChannel({
+        messenger,
+        receiver: hostExtension,
+        outbound: exports.DATA_TO_EXTENSION,
+        inbound: exports.DATA_TO_WEBVIEW,
+        onClose
+    });
+}
+//# sourceMappingURL=messenger-channel.js.map

package/lib/messenger-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-channel.js","sourceRoot":"","sources":["../src/messenger-channel.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;AA+DlF;;;;;;;;GAQG;AACU,QAAA,eAAe,GAAyB,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;AAC/E,QAAA,iBAAiB,GAAyB,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;AAgDhG;;;;;;;;;;;;;;;GAeG;AACH,gCACG,OAA6D;IAE7D,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IACjG,OAAO;QACJ,IAAI,CAAC,OAAgB;YAClB,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QACD,SAAS,CAAC,QAAoC;YAC3C,IAAI,UAAU,GAAG,IAAI,CAAC;YACtB,MAAM,YAAY,GAAG,SAAS,CAAC,cAAc,CAC1C,OAAO,EACP,OAAO,CAAC,EAAE;gBACP,IAAI,UAAU,EAAE,CAAC;oBACd,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrB,CAAC;YACJ,CAAC,EACD,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACjC,CAAC;YACF,OAAO;gBACJ,OAAO,EAAE,GAAG,EAAE;oBACX,UAAU,GAAG,KAAK,CAAC;oBACnB,mBAAmB,EAAE,CAAC,YAAY,CAAC,CAAC;gBACvC,CAAC;aACH,CAAC;QACL,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,oCACG,SAAsC,EACtC,OAAqB,EACrB,OAA8C;IAE9C,OAAO,sBAAsB,CAA2B;QACrD,SAAS;QACT,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,QAAA,eAAe;QACzB,OAAO,EAAE,QAAA,iBAAiB;QAC1B,wDAAwD;QACxD,MAAM,EAAE,OAAO;QACf,OAAO;QACP,4EAA4E;QAC5E,mBAAmB,EAAE,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE;KAC7D,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,kCACG,SAA6C,EAC7C,aAA2B,EAC3B,OAA8C;IAE9C,OAAO,sBAAsB,CAAwB;QAClD,SAAS;QACT,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,QAAA,iBAAiB;QAC3B,OAAO,EAAE,QAAA,eAAe;QACxB,OAAO;KACT,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,57 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * The extension host's end of the data head.
+ *
+ * A webview has no `net`, so the extension host holds the socket to the
+ * data-server and moves whole JSON-RPC messages between it and the webview over
+ * a `vscode-messenger` hop, typically GLSP's own, so a diagram and a data
+ * webview share one lifecycle and one dispose.
+ */
+import { type MessageRelay, type RelayTransport, type ResolvedMessage } from '@hydranium/protocol';
+import type { Disposable } from 'vscode-jsonrpc';
+import { type MessengerLike } from '../messenger-channel';
+/** Connect to a head's socket and present it as a relay's framed side. */
+export declare function openSocketTransport(port: number, host?: string): Promise<RelayTransport>;
+/** What {@link connectDataServer} needs from the host. */
+export interface DataServerConnectionOptions<TParticipant> {
+    /**
+     * The extension-side messenger, typically `GlspVscodeConnector.messenger`.
+     * It must be constructed with `ignoreHiddenViews: false`, or a hidden
+     * webview misses every message the data-server sends it.
+     */
+    readonly messenger: MessengerLike<TParticipant>;
+    /** The registered webview this connection serves. */
+    readonly webview: TParticipant;
+    /**
+     * Resolve the data-server's listening port. Called once per connection
+     * generation, so a restarted server is re-discovered rather than cached —
+     * the language server binds a fresh ephemeral port each start.
+     */
+    readonly findPort: () => Promise<number>;
+    /** Observe the webview going away, so the relay releases with it. */
+    readonly onWebviewDisposed?: (listener: () => void) => Disposable;
+    /**
+     * Surface a relay failure. `reported` is a complete sentence plus the
+     * identity needed to render it in another language — the extension host holds
+     * the locale, so it renders and the relay does not.
+     */
+    readonly reportError?: (error: unknown, reported: ResolvedMessage) => void;
+}
+/**
+ * Wire one webview to the data head.
+ *
+ * The returned relay's `onClose` is the host's ONLY notice that the framed side
+ * died — a `PostMessageChannel` has no `close()`, so a dead data-server is
+ * invisible to the webview, whose pending requests would otherwise hang with no
+ * rejection. Tell the webview, whose `WebviewDataPort.connectionLost` rejects
+ * them, or dispose the webview; doing nothing is the one wrong choice.
+ */
+export declare function connectDataServer<TParticipant>(options: DataServerConnectionOptions<TParticipant>): MessageRelay;
+//# sourceMappingURL=data-server-connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-server-connection.d.ts","sourceRoot":"","sources":["../../src/node/data-server-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;GAOG;AAEH,OAAO,EAA6B,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE9H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIjD,OAAO,EAA8B,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEtF,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAe7F;AAED,0DAA0D;AAC1D,MAAM,WAAW,2BAA2B,CAAC,YAAY;IACtD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAChD,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,UAAU,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAC7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,OAAO,EAAE,2BAA2B,CAAC,YAAY,CAAC,GAAG,YAAY,CAKhH"}

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

@@ -0,0 +1,92 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openSocketTransport = openSocketTransport;
+exports.connectDataServer = connectDataServer;
+/**
+ * The extension host's end of the data head.
+ *
+ * A webview has no `net`, so the extension host holds the socket to the
+ * data-server and moves whole JSON-RPC messages between it and the webview over
+ * a `vscode-messenger` hop, typically GLSP's own, so a diagram and a data
+ * webview share one lifecycle and one dispose.
+ */
+const protocol_1 = require("@hydranium/protocol");
+const net = __importStar(require("node:net"));
+// `/node` because the extension host is Node and holds the socket. The webview
+// imports `/browser`; the package root installs no runtime abstraction layer.
+const node_1 = require("vscode-jsonrpc/node");
+const messenger_channel_1 = require("../messenger-channel");
+/** Connect to a head's socket and present it as a relay's framed side. */
+function openSocketTransport(port, host = '127.0.0.1') {
+    return new Promise((resolve, reject) => {
+        const socket = net.createConnection({ port, host });
+        socket.once('error', reject);
+        socket.once('connect', () => {
+            // Drop the construction-time handler so a later socket error goes to
+            // the relay's reader rather than rejecting an already-settled promise.
+            socket.removeAllListeners('error');
+            resolve({
+                reader: new node_1.SocketMessageReader(socket),
+                writer: new node_1.SocketMessageWriter(socket),
+                dispose: () => socket.destroy()
+            });
+        });
+    });
+}
+/**
+ * Wire one webview to the data head.
+ *
+ * The returned relay's `onClose` is the host's ONLY notice that the framed side
+ * died — a `PostMessageChannel` has no `close()`, so a dead data-server is
+ * invisible to the webview, whose pending requests would otherwise hang with no
+ * rejection. Tell the webview, whose `WebviewDataPort.connectionLost` rejects
+ * them, or dispose the webview; doing nothing is the one wrong choice.
+ */
+function connectDataServer(options) {
+    const channel = (0, messenger_channel_1.createExtensionSideChannel)(options.messenger, options.webview, options.onWebviewDisposed);
+    return (0, protocol_1.relayToPostMessageChannel)(channel, async () => openSocketTransport(await options.findPort()), {
+        reportError: options.reportError
+    });
+}
+//# sourceMappingURL=data-server-connection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-server-connection.js","sourceRoot":"","sources":["../../src/node/data-server-connection.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElF;;;;;;;GAOG;AAEH,kDAA8H;AAC9H,MAAY,GAAG,qCAAiB;AAEhC,+EAA+E;AAC/E,8EAA8E;AAC9E,8CAA+E;AAC/E,4DAAsF;AAEtF,0EAA0E;AAC1E,6BAAoC,IAAY,EAAE,IAAI,GAAG,WAAW;IACjE,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,qEAAqE;YACrE,uEAAuE;YACvE,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACnC,OAAO,CAAC;gBACL,MAAM,EAAE,IAAI,0BAAmB,CAAC,MAAM,CAAC;gBACvC,MAAM,EAAE,IAAI,0BAAmB,CAAC,MAAM,CAAC;gBACvC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;aACjC,CAAC,CAAC;QACN,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACN,CAAC;AA4BD;;;;;;;;GAQG;AACH,2BAAgD,OAAkD;IAC/F,MAAM,OAAO,GAAG,IAAA,8CAA0B,EAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1G,OAAO,IAAA,oCAAyB,EAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,mBAAmB,CAAC,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE;QAClG,WAAW,EAAE,OAAO,CAAC,WAAW;KAClC,CAAC,CAAC;AACN,CAAC"}

package/lib/node/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './data-server-connection';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/node/index.js

@@ -0,0 +1,26 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./data-server-connection"), exports);
+//# sourceMappingURL=index.js.map

package/lib/node/index.js.map

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

package/lib/testing/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './messenger-harness';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/testing/index.js

@@ -0,0 +1,26 @@
+"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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./messenger-harness"), exports);
+//# sourceMappingURL=index.js.map

package/lib/testing/index.js.map

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

package/lib/testing/messenger-harness.d.ts

@@ -0,0 +1,48 @@
+/********************************************************************************
+ * 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 { Messenger } from 'vscode-messenger';
+import type { WebviewIdMessageParticipant } from 'vscode-messenger-common';
+import { Messenger as WebviewMessenger } from 'vscode-messenger-webview';
+/** One webview on a {@link MessengerHarness}. */
+export interface MessengerHarnessWebview {
+    /** How the extension-side messenger addresses this webview. */
+    readonly participant: WebviewIdMessageParticipant;
+    /** The webview's own messenger, already started. */
+    readonly messenger: WebviewMessenger;
+    /** Close the webview, as VS Code disposing its panel does: the extension-side messenger forgets it. */
+    dispose(): void;
+}
+/** The real `vscode-messenger` classes, joined without VS Code. */
+export interface MessengerHarness {
+    /** The extension host's messenger, constructed as `GlspVscodeConnector` constructs its own. */
+    readonly extension: Messenger;
+    /** Open a webview: a panel registered with {@link extension}, and the webview's messenger behind it. */
+    openWebview(): MessengerHarnessWebview;
+    /**
+     * Restore the global `window` this harness replaced. A webview messenger
+     * reads `window.crypto` for every request it sends, so its requests throw
+     * once the harness is disposed; notifications still go.
+     */
+    dispose(): void;
+}
+/**
+ * Join the real extension-side and webview-side messengers in a Node test,
+ * through a fake webview panel on one end and a fake `window` on the other.
+ *
+ * Both classes run unchanged, so their routing is the real one: delivery is
+ * asynchronous, the webview side keeps one handler per method, and the
+ * extension side filters by sender. The webview messenger listens on the
+ * global `window`, so the harness installs one for its lifetime and routes each
+ * listener to the webview that registered it.
+ *
+ * One harness at a time: a second replaces the `window` the first routes its
+ * webviews through, and disposing them out of order restores the wrong one.
+ */
+export declare function makeMessengerHarness(): MessengerHarness;
+//# sourceMappingURL=messenger-harness.d.ts.map

package/lib/testing/messenger-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-harness.d.ts","sourceRoot":"","sources":["../../src/testing/messenger-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAkB,MAAM,0BAA0B,CAAC;AAEzF,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,uGAAuG;IACvG,OAAO,IAAI,IAAI,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,wGAAwG;IACxG,WAAW,IAAI,uBAAuB,CAAC;IACvC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CAClB;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAgEvD"}

package/lib/testing/messenger-harness.js

@@ -0,0 +1,91 @@
+"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
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeMessengerHarness = makeMessengerHarness;
+const vscode_messenger_1 = require("vscode-messenger");
+const vscode_messenger_webview_1 = require("vscode-messenger-webview");
+/**
+ * Join the real extension-side and webview-side messengers in a Node test,
+ * through a fake webview panel on one end and a fake `window` on the other.
+ *
+ * Both classes run unchanged, so their routing is the real one: delivery is
+ * asynchronous, the webview side keeps one handler per method, and the
+ * extension side filters by sender. The webview messenger listens on the
+ * global `window`, so the harness installs one for its lifetime and routes each
+ * listener to the webview that registered it.
+ *
+ * One harness at a time: a second replaces the `window` the first routes its
+ * webviews through, and disposing them out of order restores the wrong one.
+ */
+function makeMessengerHarness() {
+    const host = globalThis;
+    const previousWindow = host.window;
+    let starting;
+    const harnessWindow = {
+        addEventListener: (type, listener) => {
+            if (type === 'message') {
+                starting?.push(listener);
+            }
+        },
+        crypto: globalThis.crypto
+    };
+    host.window = harnessWindow;
+    const extension = new vscode_messenger_1.Messenger({ ignoreHiddenViews: false });
+    return {
+        extension,
+        openWebview: () => {
+            const toWebview = [];
+            const toExtension = [];
+            const disposeListeners = [];
+            const panel = {
+                viewType: 'hydranium.messengerHarness',
+                visible: true,
+                webview: {
+                    postMessage: async (message) => {
+                        [...toWebview].forEach(listener => listener({ data: message }));
+                        return true;
+                    },
+                    onDidReceiveMessage: (listener) => {
+                        toExtension.push(listener);
+                        return {
+                            dispose: () => {
+                                const index = toExtension.indexOf(listener);
+                                if (index >= 0) {
+                                    toExtension.splice(index, 1);
+                                }
+                            }
+                        };
+                    }
+                },
+                onDidDispose: (listener) => {
+                    disposeListeners.push(listener);
+                    return { dispose: () => undefined };
+                },
+                onDidChangeViewState: () => ({ dispose: () => undefined })
+            };
+            // The members the extension-side messenger reads; the rest of a panel is VS Code's.
+            const participant = extension.registerWebviewPanel(panel);
+            const vscodeApi = {
+                postMessage: message => [...toExtension].forEach(listener => listener(message)),
+                getState: () => undefined,
+                setState: () => undefined
+            };
+            const messenger = new vscode_messenger_webview_1.Messenger(vscodeApi);
+            starting = toWebview;
+            messenger.start();
+            starting = undefined;
+            return { participant, messenger, dispose: () => disposeListeners.forEach(listener => listener()) };
+        },
+        dispose: () => {
+            host.window = previousWindow;
+        }
+    };
+}
+//# sourceMappingURL=messenger-harness.js.map

package/lib/testing/messenger-harness.js.map

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

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "@hydranium/data-client-vscode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-next.315",
+  "description": "VS Code client primitives for the hydranium data-server protocol head; companion of @hydranium/data-server. The extension host relays the data-server's socket to a webview over a vscode-messenger hop, and the webview's data port reads it, so DataConnection and DataSession run unchanged in a webview.",
+  "keywords": [
+    "hydranium",
+    "langium",
+    "language-server",
+    "lsp",
+    "vscode",
+    "vscode-extension",
+    "webview"
+  ],
+  "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/data-client-vscode",
+  "bugs": {
+    "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-emfcloud/hydranium.git",
+    "directory": "packages/data-client-vscode"
+  },
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
+  "sideEffects": false,
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./browser": {
+      "types": "./lib/browser/index.d.ts",
+      "default": "./lib/browser/index.js"
+    },
+    "./node": {
+      "types": "./lib/node/index.d.ts",
+      "default": "./lib/node/index.js"
+    },
+    "./testing": {
+      "types": "./lib/testing/index.d.ts",
+      "default": "./lib/testing/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "lint": "oxlint --format stylish --config ../../oxlint.config.cjs src test --max-warnings 0",
+    "prepack": "node -e \"const m=require('./package.json'),fs=require('node:fs');const missing=[m.main,...Object.values(m.bin||{})].filter(entry=>entry&&!fs.existsSync(entry));if(missing.length){console.error('prepack '+m.name+': not built ('+missing.join(', ')+' missing). Run the build before packing: a files entry that matches nothing is skipped silently, so the tarball would ship src only.');process.exit(1);}\"",
+    "test": "npm run typecheck:test && vitest run",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "watch": "tsc -b -w --preserveWatchOutput"
+  },
+  "devDependencies": {
+    "@hydranium/protocol": "1.0.0-next.315",
+    "@types/node": "^22.0.0",
+    "@types/vscode": "^1.101.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^7.0.2",
+    "vscode-jsonrpc": "9.0.0",
+    "vscode-messenger": "^0.4.5",
+    "vscode-messenger-common": "^0.4.5",
+    "vscode-messenger-webview": "^0.4.5"
+  },
+  "peerDependencies": {
+    "@hydranium/protocol": "1.0.0-next.315",
+    "vscode-jsonrpc": "^9.0.0",
+    "vscode-messenger": "^0.4.5",
+    "vscode-messenger-common": "^0.4.5",
+    "vscode-messenger-webview": "^0.4.5"
+  },
+  "peerDependenciesMeta": {
+    "vscode-messenger": {
+      "optional": true
+    },
+    "vscode-messenger-common": {
+      "optional": true
+    },
+    "vscode-messenger-webview": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.13",
+    "vscode": "^1.101.0"
+  },
+  "//peerDependencies": "`vscode-jsonrpc` takes a caret, so the framework shares the transport the LSP connection resolves, which an `init` scaffold pins: each `vscode-languageserver-protocol` release pins its transport exactly, so an exact peer would name a copy a fresh install rarely holds. The caret excludes 8.x, so a tree whose top holds GLSP's copy fails the peer with a named ERESOLVE warning, an error under `--strict-peer-deps`, rather than resolving silently. No peer reaches a NESTED copy, such as GLSP's or one the LSP packages nest. The wire compares message types and `ResponseError`s by copy identity, so the framework sends typed messages by method name and recognises errors with `isResponseError` rather than `instanceof`.",
+  "//prepack": "The publish guard, a `prepack` rather than a `prepare`: `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error.",
+  "//vscode-messenger": "The `vscode-messenger` packages are optional peers: the channel restates the two messenger shapes structurally, so the runtime tiers never pin the copy GLSP's VS Code integration brings, and only `./testing`, which joins the real classes, loads them."
+}

package/src/browser/index.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+
+export * from './webview-data-port';