@hydranium/protocol 1.0.0-next.10

package/lib/testing/data-doubles.js

@@ -0,0 +1,102 @@
+"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.makeFakeDataPort = makeFakeDataPort;
+exports.makeCapturingDataClient = makeCapturingDataClient;
+/**
+ * The two CLIENT-side doubles of the data head: a {@link DataPort} whose
+ * transport the test supplies, and a {@link DataClientProtocol} that records
+ * what arrived.
+ *
+ * # Why standalone, when a harness already builds one
+ *
+ * `makeDataServerHarness` builds a capturing client too, but fused into a
+ * server-bearing harness: taking it means taking a duplex pair, a `DataServer`
+ * and a proxy. That is the right shape for testing the server. It is the wrong
+ * shape — and not available at all — for testing the CLIENT half: a
+ * `DataSession`, a widget model, a host's port adapter. Those need to stand a
+ * double on one side of the boundary and something else entirely on the other,
+ * which is why both halves get hand-rolled per suite instead.
+ *
+ * # Runner-agnostic, deliberately
+ *
+ * No `jest.fn`, no `vi.fn`, no `expect`. The recorded arrays ARE the assertion
+ * surface, so the same double works under vitest, jest and a bare script. A
+ * mock-framework double would also make "was it called" the observable, when
+ * what a data-head test actually asserts is the CONTENT of what arrived —
+ * which `sourceClientId`, which version, which reason.
+ */
+const vscode_jsonrpc_1 = require("vscode-jsonrpc");
+/**
+ * A {@link DataPort} over a transport the caller supplies.
+ *
+ * It deliberately does not create the transport itself. What varies between the
+ * cases worth testing is exactly that: an in-process duplex pair, a socket, a
+ * connection with no server behind it, a different one per generation.
+ */
+function makeFakeDataPort(options) {
+    const connections = [];
+    const reported = [];
+    const disposeEmitter = new vscode_jsonrpc_1.Emitter();
+    return {
+        clientId: options.clientId ?? 'fake-data-port',
+        connections,
+        reported,
+        onDispose: disposeEmitter.event,
+        async connect() {
+            const connection = await options.connect();
+            connections.push(connection);
+            return connection;
+        },
+        reportError(error, context) {
+            reported.push({ error, context });
+        },
+        fireDispose() {
+            disposeEmitter.fire(undefined);
+        },
+        dispose() {
+            disposeEmitter.dispose();
+        }
+    };
+}
+/**
+ * A {@link DataClientProtocol} that records every notification it receives.
+ *
+ * Recording ALL THREE channels even when a suite reads one is deliberate: an
+ * event delivered on the wrong channel is a real defect of the data head, and a
+ * double that drops the other two turns it into silence on the one being
+ * watched.
+ *
+ * An override replaces a channel's recording rather than supplementing it, so
+ * the corresponding array stays empty — that is what makes an override usable
+ * as a barrier (rejecting, counting differently, throwing) rather than only as
+ * a spy.
+ */
+function makeCapturingDataClient(overrides = {}) {
+    const updates = [];
+    const saves = [];
+    const projectsChanges = [];
+    const client = {
+        onDocumentUpdated: overrides.onDocumentUpdated ??
+            (event => {
+                updates.push(event);
+            }),
+        onDocumentSaved: overrides.onDocumentSaved ??
+            (event => {
+                saves.push(event);
+            }),
+        onProjectsChanged: overrides.onProjectsChanged ??
+            (event => {
+                projectsChanges.push(event);
+            })
+    };
+    return { client, updates, saves, projectsChanges };
+}
+//# sourceMappingURL=data-doubles.js.map

package/lib/testing/data-doubles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-doubles.js","sourceRoot":"","sources":["../../src/testing/data-doubles.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAyFlF,4CAwBC;AA+BD,0DA0BC;AAxKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,mDAAiE;AAwDjE;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,OAA4B;IAC1D,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAA0C,EAAE,CAAC;IAC3D,MAAM,cAAc,GAAG,IAAI,wBAAO,EAAQ,CAAC;IAC3C,OAAO;QACJ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB;QAC9C,WAAW;QACX,QAAQ;QACR,SAAS,EAAE,cAAc,CAAC,KAAK;QAC/B,KAAK,CAAC,OAAO;YACV,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3C,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7B,OAAO,UAAU,CAAC;QACrB,CAAC;QACD,WAAW,CAAC,KAAc,EAAE,OAAe;YACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,WAAW;YACR,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,OAAO;YACJ,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC;KACH,CAAC;AACL,CAAC;AAkBD;;;;;;;;;;;;GAYG;AACH,SAAgB,uBAAuB,CAIrC,YAA2E,EAAE;IAC5E,MAAM,OAAO,GAA2D,EAAE,CAAC;IAC3E,MAAM,KAAK,GAAyD,EAAE,CAAC;IACvE,MAAM,eAAe,GAAqC,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAyD;QAClE,iBAAiB,EACd,SAAS,CAAC,iBAAiB;YAC3B,CAAC,KAAK,CAAC,EAAE;gBACN,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC,CAAC;QACL,eAAe,EACZ,SAAS,CAAC,eAAe;YACzB,CAAC,KAAK,CAAC,EAAE;gBACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC;QACL,iBAAiB,EACd,SAAS,CAAC,iBAAiB;YAC3B,CAAC,KAAK,CAAC,EAAE;gBACN,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC,CAAC;KACP,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;AACtD,CAAC"}

package/lib/testing/fake-clock.d.ts

@@ -0,0 +1,35 @@
+/********************************************************************************
+ * 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 Clock } from '../clock';
+/** A {@link Clock} whose time only moves when the test calls {@link FakeClock.advance}. */
+export interface FakeClock extends Clock {
+    /**
+     * Move virtual time forward by `ms`, firing every {@link Clock.setTimer}
+     * whose deadline falls within the window — in chronological order, each at
+     * its own deadline (so `now()` inside a callback reads the fire instant, not
+     * the advance target). Timers scheduled by a callback fire too if they fall
+     * within the same window.
+     */
+    advance(ms: number): void;
+}
+/**
+ * In-process {@link Clock} double for deterministic time. The real
+ * `SystemClock` has two underlying sources
+ * (`Date.now` for `now()`, `performance.now()` for the stopwatch); the fake
+ * collapses them onto ONE virtual time axis, so a single
+ * {@link FakeClock.advance} drives `now()`, every live stopwatch's elapsed, and
+ * any due timer together.
+ *
+ * Server-free and DI-free — lives in `@hydranium/protocol/testing` so every
+ * head can bind it without pulling in a server package.
+ */
+export declare function makeFakeClock(options?: {
+    now?: number;
+}): FakeClock;
+//# sourceMappingURL=fake-clock.d.ts.map

package/lib/testing/fake-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-clock.d.ts","sourceRoot":"","sources":["../../src/testing/fake-clock.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,KAAK,EAA8B,MAAM,UAAU,CAAC;AAGlE,2FAA2F;AAC3F,MAAM,WAAW,SAAU,SAAQ,KAAK;IACrC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,CA+DvE"}

package/lib/testing/fake-clock.js

@@ -0,0 +1,86 @@
+"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.makeFakeClock = makeFakeClock;
+const util_1 = require("../util");
+/**
+ * In-process {@link Clock} double for deterministic time. The real
+ * `SystemClock` has two underlying sources
+ * (`Date.now` for `now()`, `performance.now()` for the stopwatch); the fake
+ * collapses them onto ONE virtual time axis, so a single
+ * {@link FakeClock.advance} drives `now()`, every live stopwatch's elapsed, and
+ * any due timer together.
+ *
+ * Server-free and DI-free — lives in `@hydranium/protocol/testing` so every
+ * head can bind it without pulling in a server package.
+ */
+function makeFakeClock(options = {}) {
+    let current = options.now ?? 0;
+    const timers = [];
+    const makeStopwatch = () => {
+        const start = current;
+        let lastLap = current;
+        let stopped;
+        return {
+            get elapsedMs() {
+                return (stopped ?? current) - start;
+            },
+            lap() {
+                const at = stopped ?? current;
+                const split = at - lastLap;
+                lastLap = at;
+                return split;
+            },
+            stop() {
+                if (stopped === undefined) {
+                    stopped = current;
+                }
+                return stopped - start;
+            }
+        };
+    };
+    return {
+        now: () => current,
+        setTimer(callback, ms) {
+            const timer = { at: current + ms, callback, disposed: false, fired: false };
+            timers.push(timer);
+            return util_1.Disposable.create(() => {
+                timer.disposed = true;
+            });
+        },
+        stopwatch: makeStopwatch,
+        measure: ((callback) => {
+            const stopwatch = makeStopwatch();
+            const result = callback();
+            if (result instanceof Promise) {
+                return result.then(value => ({ result: value, elapsedMs: stopwatch.elapsedMs }));
+            }
+            return { result: result, elapsedMs: stopwatch.elapsedMs };
+        }),
+        advance(ms) {
+            const target = current + ms;
+            // Fire due timers one at a time, re-scanning after each so a callback
+            // that schedules a nearer timer still fires within this window.
+            for (;;) {
+                const next = timers
+                    .filter(timer => !timer.disposed && !timer.fired && timer.at <= target)
+                    .sort((left, right) => left.at - right.at)[0];
+                if (!next) {
+                    break;
+                }
+                current = next.at;
+                next.fired = true;
+                next.callback();
+            }
+            current = target;
+        }
+    };
+}
+//# sourceMappingURL=fake-clock.js.map

package/lib/testing/fake-clock.js.map

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

package/lib/testing/harness.d.ts

@@ -0,0 +1,24 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * The uniform contract every framework test harness satisfies. A harness is
+ * a wired bundle around a system-under-test, driven through a seam; its full
+ * shape is `{ <subject>, <seam>, …captureArrays, dispose() }`. This marker
+ * pins the one member that is identical across every harness — `dispose()` —
+ * so teardown is always `harness.dispose()` regardless of which harness, and
+ * a `Harness` reference can release any of them without knowing its concrete
+ * type. Each concrete harness interface — per head, and per conformance driver
+ * port — `extends Harness` and adds its subject / seam / capture members on
+ * top.
+ */
+export interface Harness {
+    /** Release every resource the harness holds. Idempotent; the uniform teardown hook. */
+    dispose(): void;
+}
+//# sourceMappingURL=harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/testing/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACrB,uFAAuF;IACvF,OAAO,IAAI,IAAI,CAAC;CAClB"}

package/lib/testing/harness.js

@@ -0,0 +1,11 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=harness.js.map

package/lib/testing/harness.js.map

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

package/lib/testing/index.d.ts

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './data-doubles';
+export * from './fake-clock';
+export * from './harness';
+export * from './wait-for';
+//# 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,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/lib/testing/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Subpath barrel for `@hydranium/protocol/testing` — the BROWSER-NEUTRAL shared
+// primitives: `makeFakeClock` (deterministic `Clock` double on one virtual time
+// axis), `waitFor` / `tick`, the client-side data-head doubles
+// (`makeFakeDataPort` / `makeCapturingDataClient`), and the `Harness` marker
+// interface every framework harness extends. Kept out of the main barrel so production bundles don't pull
+// the test scaffolding in by default; adopters opt in by importing from
+// `@hydranium/protocol/testing`.
+//
+// Neutrality is gated (`scripts/check-neutral-bundles.mjs`), which is why the
+// duplex transports are NOT here: a `PassThrough` pair is in their exported
+// type, so they cannot be made portable and live at `./testing/node` instead.
+// The same rule the package surface uses — the portable name is the short one.
+__exportStar(require("./data-doubles"), exports);
+__exportStar(require("./fake-clock"), exports);
+__exportStar(require("./harness"), exports);
+__exportStar(require("./wait-for"), 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,gFAAgF;AAChF,gFAAgF;AAChF,+DAA+D;AAC/D,6EAA6E;AAC7E,0GAA0G;AAC1G,wEAAwE;AACxE,iCAAiC;AACjC,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,+EAA+E;AAE/E,iDAA+B;AAC/B,+CAA6B;AAC7B,4CAA0B;AAC1B,6CAA2B"}

package/lib/testing/node/duplex-connection.d.ts

@@ -0,0 +1,25 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type MessageConnection } from 'vscode-jsonrpc/node';
+/**
+ * Bidirectional in-process vscode-jsonrpc bridge — two MessageConnections
+ * crossed over a PassThrough pair, both already listening. The framework's
+ * standard in-process test transport.
+ *
+ * Typical use: wire a `DataServer` to `pair.left` and exercise it from a
+ * client proxy on `pair.right` (or vice versa). Call `dispose` at test
+ * teardown to release the underlying streams.
+ */
+export interface DuplexConnectionPair {
+    readonly left: MessageConnection;
+    readonly right: MessageConnection;
+    dispose(): void;
+}
+export declare function makeDuplexConnectionPair(): DuplexConnectionPair;
+//# sourceMappingURL=duplex-connection.d.ts.map

package/lib/testing/node/duplex-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplex-connection.d.ts","sourceRoot":"","sources":["../../../src/testing/node/duplex-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAqE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhI;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,wBAAwB,IAAI,oBAAoB,CAsB/D"}

package/lib/testing/node/duplex-connection.js

@@ -0,0 +1,34 @@
+"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.makeDuplexConnectionPair = makeDuplexConnectionPair;
+const node_1 = require("vscode-jsonrpc/node");
+const duplex_stream_1 = require("./duplex-stream");
+function makeDuplexConnectionPair() {
+    // `left` is the client side, `right` the server side: `clientToServer` is
+    // what `left` writes and `right` reads; `serverToClient` is what `right`
+    // writes and `left` reads.
+    const pair = (0, duplex_stream_1.makeDuplexStreamPair)();
+    const { clientToServer, serverToClient } = pair;
+    const left = (0, node_1.createMessageConnection)(new node_1.StreamMessageReader(serverToClient), new node_1.StreamMessageWriter(clientToServer));
+    const right = (0, node_1.createMessageConnection)(new node_1.StreamMessageReader(clientToServer), new node_1.StreamMessageWriter(serverToClient));
+    left.listen();
+    right.listen();
+    return {
+        left,
+        right,
+        dispose() {
+            left.dispose();
+            right.dispose();
+            pair.dispose();
+        }
+    };
+}
+//# sourceMappingURL=duplex-connection.js.map

package/lib/testing/node/duplex-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplex-connection.js","sourceRoot":"","sources":["../../../src/testing/node/duplex-connection.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AAoBlF,4DAsBC;AAxCD,8CAAgI;AAChI,mDAAuD;AAiBvD,SAAgB,wBAAwB;IACrC,0EAA0E;IAC1E,yEAAyE;IACzE,2BAA2B;IAC3B,MAAM,IAAI,GAAG,IAAA,oCAAoB,GAAE,CAAC;IACpC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEhD,MAAM,IAAI,GAAG,IAAA,8BAAuB,EAAC,IAAI,0BAAmB,CAAC,cAAc,CAAC,EAAE,IAAI,0BAAmB,CAAC,cAAc,CAAC,CAAC,CAAC;IACvH,MAAM,KAAK,GAAG,IAAA,8BAAuB,EAAC,IAAI,0BAAmB,CAAC,cAAc,CAAC,EAAE,IAAI,0BAAmB,CAAC,cAAc,CAAC,CAAC,CAAC;IAExH,IAAI,CAAC,MAAM,EAAE,CAAC;IACd,KAAK,CAAC,MAAM,EAAE,CAAC;IAEf,OAAO;QACJ,IAAI;QACJ,KAAK;QACL,OAAO;YACJ,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;KACH,CAAC;AACL,CAAC"}

package/lib/testing/node/duplex-stream.d.ts

@@ -0,0 +1,32 @@
+/********************************************************************************
+ * 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 { PassThrough } from 'node:stream';
+/**
+ * A crossed pair of in-process `PassThrough` streams modelling one
+ * bidirectional client/server transport. Each `PassThrough` is itself both
+ * readable and writable: the side named first writes, the side named second
+ * reads off the same object. The shared substrate under the framework's
+ * in-process test transports — `makeDuplexConnectionPair` layers a
+ * `MessageConnection` pair on top.
+ */
+export interface DuplexStreamPair {
+    /** Client writes here; server reads here. */
+    readonly clientToServer: PassThrough;
+    /** Server writes here; client reads here. */
+    readonly serverToClient: PassThrough;
+    /** Destroy both streams. Idempotent. */
+    dispose(): void;
+}
+/**
+ * Build a fresh {@link DuplexStreamPair}. The two streams are independent;
+ * data written to one never appears on the other. Call `dispose` at test
+ * teardown to release them.
+ */
+export declare function makeDuplexStreamPair(): DuplexStreamPair;
+//# sourceMappingURL=duplex-stream.d.ts.map

package/lib/testing/node/duplex-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplex-stream.d.ts","sourceRoot":"","sources":["../../../src/testing/node/duplex-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,wCAAwC;IACxC,OAAO,IAAI,IAAI,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAiBvD"}

package/lib/testing/node/duplex-stream.js

@@ -0,0 +1,35 @@
+"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.makeDuplexStreamPair = makeDuplexStreamPair;
+const node_stream_1 = require("node:stream");
+/**
+ * Build a fresh {@link DuplexStreamPair}. The two streams are independent;
+ * data written to one never appears on the other. Call `dispose` at test
+ * teardown to release them.
+ */
+function makeDuplexStreamPair() {
+    const clientToServer = new node_stream_1.PassThrough();
+    const serverToClient = new node_stream_1.PassThrough();
+    let disposed = false;
+    return {
+        clientToServer,
+        serverToClient,
+        dispose() {
+            if (disposed) {
+                return;
+            }
+            disposed = true;
+            clientToServer.destroy();
+            serverToClient.destroy();
+        }
+    };
+}
+//# sourceMappingURL=duplex-stream.js.map

package/lib/testing/node/duplex-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplex-stream.js","sourceRoot":"","sources":["../../../src/testing/node/duplex-stream.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;AA0BlF,oDAiBC;AAzCD,6CAA0C;AAmB1C;;;;GAIG;AACH,SAAgB,oBAAoB;IACjC,MAAM,cAAc,GAAG,IAAI,yBAAW,EAAE,CAAC;IACzC,MAAM,cAAc,GAAG,IAAI,yBAAW,EAAE,CAAC;IAEzC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACJ,cAAc;QACd,cAAc;QACd,OAAO;YACJ,IAAI,QAAQ,EAAE,CAAC;gBACZ,OAAO;YACV,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,cAAc,CAAC,OAAO,EAAE,CAAC;YACzB,cAAc,CAAC,OAAO,EAAE,CAAC;QAC5B,CAAC;KACH,CAAC;AACL,CAAC"}

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

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

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

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

package/lib/testing/node/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Subpath barrel for `@hydranium/protocol/testing/node` — the test transports
+// that need a Node runtime: a crossed `PassThrough` pair and the in-process
+// `MessageConnection` bridge over it.
+//
+// Separate from `./testing` because a `PassThrough` is in `DuplexStreamPair`'s
+// exported type and `StreamMessageReader` comes from `vscode-jsonrpc/node`, so
+// neither can be made portable — and keeping them in the neutral barrel taints
+// every subpath that re-exports it, which is what made three of this repo's
+// `./testing` entries unbundleable for a browser while having no Node code of
+// their own.
+__exportStar(require("./duplex-connection"), exports);
+__exportStar(require("./duplex-stream"), exports);
+//# sourceMappingURL=index.js.map

package/lib/testing/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/node/index.ts"],"names":[],"mappings":";AAAA;;;;;;;kFAOkF;;;;;;;;;;;;;;;;AAElF,8EAA8E;AAC9E,4EAA4E;AAC5E,sCAAsC;AACtC,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,aAAa;AAEb,sDAAoC;AACpC,kDAAgC"}

package/lib/testing/wait-for.d.ts

@@ -0,0 +1,69 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Two test primitives for awaiting in-process asynchrony (RPC notifications
+ * crossing the duplex wire, `DocumentBuilder` phase events, etc.) WITHOUT a
+ * flaky fixed sleep.
+ *
+ * Decision rule:
+ * - Asserting an effect **will** happen ("eventually N events / a build ran /
+ *   the doc reached a phase")? → {@link waitFor} with a predicate over the
+ *   observable. Non-racy: resolves the instant it is true, tolerates a slow CI.
+ * - Asserting an effect **did not / has not yet** happened ("no event for an
+ *   unsubscribed URI", "the gated call has not resolved")? → {@link tick}: a
+ *   negative cannot be polled, so yield the loop a bounded moment to give the
+ *   (unwanted) effect a chance, then assert its absence.
+ *
+ * Default to `waitFor`; reach for `tick` only when the assertion is an absence.
+ * A microtask flush (`await Promise.resolve()` / `queue-microtask`) is never the
+ * answer here — stream-delivered JSON-RPC notifications arrive on a macrotask/IO
+ * turn, after microtasks drain.
+ */
+/** Options for {@link waitFor}. */
+export interface WaitForOptions {
+    /** Reject after this many milliseconds if the predicate is still false. Default 2000. */
+    readonly timeoutMs?: number;
+    /** Poll the predicate every this-many milliseconds. Default 5. */
+    readonly intervalMs?: number;
+    /** Error message on timeout. Default a generic phrasing. */
+    readonly message?: string;
+}
+/**
+ * Resolve once `predicate()` returns true, polling at `intervalMs`; reject with
+ * `message` once `timeoutMs` elapses. The **non-racy** alternative to a fixed
+ * sleep for awaiting an asynchronous side effect that lands on an observable
+ * value.
+ *
+ * It resolves the instant the condition holds, so it is *faster* than a fixed
+ * delay on the happy path, and tolerates a slow event loop up to `timeoutMs`, so
+ * it does not flake under parallel CI where a fixed `setTimeout` can be starved
+ * past the test timeout.
+ *
+ * @example
+ * await proxy.updateModelDocument({ uri, clientId, model });
+ * await waitFor(() => harness.events.length === 1); // the notification crossed
+ * expect(harness.events[0].document.uri).toBe(uri);
+ */
+export declare function waitFor(predicate: () => boolean, options?: WaitForOptions): Promise<void>;
+/**
+ * Yield the event loop for `ms` (default 10). The bounded counterpart to
+ * {@link waitFor}, for the rare assertion that something has NOT happened — a
+ * *negative* you cannot poll positively. Give async delivery a real chance to
+ * (wrongly) occur, then assert it did not.
+ *
+ * A fixed yield is unavoidable here, but the failure mode is a false-green, not
+ * the flaky-red a fixed delay causes on a positive wait.
+ *
+ * @example
+ * await proxy.saveModelDocument({ uri, clientId, model }); // no subscriber yet
+ * await tick();                  // give a (wrongly) fired event a chance to land
+ * expect(savedEvents).toHaveLength(0); // assert the ABSENCE
+ */
+export declare function tick(ms?: number): Promise<void>;
+//# sourceMappingURL=wait-for.d.ts.map

package/lib/testing/wait-for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for.d.ts","sourceRoot":"","sources":["../../src/testing/wait-for.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,EAAE,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C"}