@hydranium/protocol 1.0.0-next.381 → 1.0.0-next.384

package/src/pending-work-tracker.ts

@@ -17,14 +17,15 @@ export class PendingWorkTracker {
    /** The tracked work. {@link track} removes each entry once it settles. */
    protected readonly pending = new Set<Promise<unknown>>();
 
-   /** Watch `work` until it settles, and hand it back. */
+   /**
+    * Watch `work` until it settles. The promise handed back settles as `work`
+    * does, so a caller that drops it still sees a failure reported.
+    */
    track<T>(work: Promise<T>): Promise<T> {
       this.pending.add(work);
-      const done = (): void => {
+      return work.finally(() => {
          this.pending.delete(work);
-      };
-      work.then(done, done);
-      return work;
+      });
    }
 
    /** How much of the tracked work has not settled yet. */

package/src/testing/harness.ts

@@ -22,3 +22,13 @@ export interface Harness {
    /** Release every resource the harness holds. Idempotent; the uniform teardown hook. */
    dispose(): void;
 }
+
+/**
+ * {@link Harness} for a harness whose teardown has to wait, such as one that
+ * deletes a directory only once its server reads none of it. Separate rather
+ * than a widened `Harness`, whose callers rely on a synchronous `dispose()`.
+ */
+export interface AsyncHarness {
+   /** Release every resource the harness holds, resolving once it has. Idempotent. */
+   dispose(): Promise<void>;
+}

package/src/testing/node/index.ts

@@ -8,7 +8,7 @@
  ********************************************************************************/
 
 // Subpath barrel for `@hydranium/protocol/testing/node` — the test transports
-// that need a Node runtime.
+// that need a Node runtime, and the capture of `process`'s unhandled rejections.
 //
 // Separate from `./testing` because a `PassThrough` is in `DuplexStreamPair`'s
 // exported type and `StreamMessageReader` comes from `vscode-jsonrpc/node`, so
@@ -20,3 +20,4 @@
 export * from './duplex-connection';
 export * from './duplex-stream';
 export * from './message-port-pair';
+export * from './unhandled-rejections';

package/src/testing/node/unhandled-rejections.ts

@@ -0,0 +1,31 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+/**
+ * Run a Node-only assertion while collecting process-level unhandled rejection
+ * events. The callback owns the event-loop drain and can therefore choose the
+ * right observation window for the operation under test.
+ *
+ * Inside the window a rejection reaches only the array: while any listener is
+ * registered, Node hands none to its default handler and Vitest reports none as
+ * an error. A callback that never asserts on the array therefore hides every
+ * rejection it provokes.
+ */
+export async function captureUnhandledRejections<T>(callback: (rejections: unknown[]) => Promise<T>): Promise<T> {
+   const rejections: unknown[] = [];
+   const listener = (reason: unknown): void => {
+      rejections.push(reason);
+   };
+   process.on('unhandledRejection', listener);
+   try {
+      return await callback(rejections);
+   } finally {
+      process.off('unhandledRejection', listener);
+   }
+}