@statewalker/webrun-rpc 0.4.3 → 0.5.0

package/dist/duplex-over-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duplex-over-port.d.ts","sourceRoot":"","sources":["../src/duplex-over-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EAOZ,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AActD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAE/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CA6BZ"}
+{"version":3,"file":"duplex-over-port.d.ts","sourceRoot":"","sources":["../src/duplex-over-port.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EAOZ,MAAM,6BAA6B,CAAC;AAIrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,4BAA4B,CAAC;AActD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAE/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,qBAA0B,GAClC,MAAM,IAAI,CA8BZ"}

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export * from "./io-send.js";
 export * from "./listen-bidi.js";
 export * from "./listen-port.js";
 export * from "./message-target.js";
-export { DEFAULT_MAX_PORTS, multiplexPort } from "./multiplex-port.js";
+export { DEFAULT_MAX_PORTS, MUX_CLOSED_MESSAGE, multiplexPort } from "./multiplex-port.js";
 export type { PortCodec, PortEnvelope, PortMux, PortMuxOptions } from "./port-types.js";
 export * from "./recieve.js";
 export * from "./send.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,QAAQ,EACR,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,GACN,MAAM,oBAAoB,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxF,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,QAAQ,EACR,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,GACN,MAAM,oBAAoB,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxF,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -505,6 +505,7 @@ function duplexOverPort(port, options = {}) {
 function serveDuplexOverPort(port, handler, options = {}) {
 	const controller = new AbortController();
 	const notice = installAbortNotice(port, controller);
+	abortOnPortClose(port, controller);
 	const clock = installStreamTimeout(controller, options.timeout);
 	const inbound = receiveChunks(port, CHANNEL_IN, controller, clock.touch);
 	let output;
@@ -559,6 +560,7 @@ function teardownOnce(controller, notice, clock, inbound, output) {
 function runCallerSide(port, input, options) {
 	const controller = new AbortController();
 	const notice = installAbortNotice(port, controller);
+	abortOnPortClose(port, controller);
 	const clock = installStreamTimeout(controller, options.timeout);
 	const inbound = receiveChunks(port, CHANNEL_OUT, controller, clock.touch);
 	const pump = sendChunks(port, CHANNEL_IN, input, options, controller.signal, clock.touch);
@@ -607,6 +609,27 @@ function installAbortNotice(port, controller) {
 	};
 }
 /**
+* Aborts the stream when its port closes underneath it — the multiplexer was
+* closed, or the peer closed the port — for ports that report it (see
+* `getPortCloseSignal`). Without this a stream waiting for the peer's next
+* chunk would wait forever on a port that can no longer deliver one: the
+* outbound half's `callPort` already fails on the close signal, but nothing
+* failed the inbound half.
+*/
+function abortOnPortClose(port, controller) {
+	const closed = getPortCloseSignal(port);
+	if (!closed) return;
+	const onClose = () => {
+		if (!controller.signal.aborted) controller.abort(closed.reason);
+	};
+	if (closed.aborted) {
+		onClose();
+		return;
+	}
+	closed.addEventListener("abort", onClose, { once: true });
+	controller.signal.addEventListener("abort", () => closed.removeEventListener("abort", onClose), { once: true });
+}
+/**
 * The per-stream inactivity timeout (spec D8). Reset by any chunk in either
 * direction; elapsing aborts the stream. Unset, zero or non-finite installs no
 * timer at all, which is the default: a slow consumer is throttled, not failed.
@@ -768,26 +791,34 @@ async function sendChunks(port, channelName, output, { maxMessageSize, log }, si
 function newVirtualPort(send, requestClose) {
 	const listeners = /* @__PURE__ */ new Set();
 	let closed = false;
-	return {
-		port: {
-			addEventListener(_type, listener) {
-				listeners.add(listener);
-			},
-			removeEventListener(_type, listener) {
-				listeners.delete(listener);
-			},
-			postMessage(message, transfer) {
-				if (closed) return;
-				send(message, transfer);
-			},
-			close() {
-				if (closed) return;
-				closed = true;
-				const notify = requestClose;
-				listeners.clear();
-				notify();
-			}
+	const closing = new AbortController();
+	const abort = (reason) => {
+		if (closing.signal.aborted) return;
+		closing.abort(reason ?? /* @__PURE__ */ new Error("webrun-rpc: the port was closed"));
+	};
+	const port = {
+		addEventListener(_type, listener) {
+			listeners.add(listener);
 		},
+		removeEventListener(_type, listener) {
+			listeners.delete(listener);
+		},
+		postMessage(message, transfer) {
+			if (closed) return;
+			send(message, transfer);
+		},
+		close() {
+			if (closed) return;
+			closed = true;
+			const notify = requestClose;
+			listeners.clear();
+			notify();
+			abort();
+		}
+	};
+	setPortCloseSignal(port, closing.signal);
+	return {
+		port,
 		deliver(payload) {
 			if (closed) return;
 			const event = new MessageEvent("message", { data: payload });
@@ -795,9 +826,10 @@ function newVirtualPort(send, requestClose) {
 				listener(event);
 			} catch {}
 		},
-		markClosed() {
+		markClosed(reason) {
 			closed = true;
 			listeners.clear();
+			abort(reason);
 		},
 		isClosed() {
 			return closed;
@@ -806,6 +838,11 @@ function newVirtualPort(send, requestClose) {
 }
 //#endregion
 //#region src/multiplex-port.ts
+/**
+* The message of the error that fails the calls still in flight on a
+* multiplexer when it is closed (`PortMux.close()`).
+*/
+const MUX_CLOSED_MESSAGE = "webrun-rpc: the multiplexer was closed";
 /** Ceiling on concurrently open virtual ports. Bounds the id table only. */
 const DEFAULT_MAX_PORTS = 1024;
 /**
@@ -864,7 +901,7 @@ function multiplexPort(port, options) {
 			}
 			if (!accepted) {
 				open.delete(envelope.id);
-				handle.markClosed();
+				handle.markClosed(/* @__PURE__ */ new Error("webrun-rpc: the port was rejected"));
 				post({
 					type: "close",
 					id: envelope.id,
@@ -881,7 +918,7 @@ function multiplexPort(port, options) {
 		}
 		if (!handle) return;
 		open.delete(envelope.id);
-		handle.markClosed();
+		handle.markClosed(/* @__PURE__ */ new Error("webrun-rpc: the peer closed the port"));
 	};
 	const listener = (event) => {
 		const envelope = codec.read(event);
@@ -913,7 +950,7 @@ function multiplexPort(port, options) {
 					id
 				});
 				open.delete(id);
-				handle.markClosed();
+				handle.markClosed(/* @__PURE__ */ new Error(MUX_CLOSED_MESSAGE));
 			}
 			muxClosed = true;
 			port.removeEventListener("message", listener);
@@ -1177,4 +1214,4 @@ function transferPortMux(target, options = {}) {
 	};
 }
 //#endregion
-export { CANCEL_CHANNEL_TYPE, DEFAULT_MAX_PORTS, NO_TIMEOUT, PORT_TRANSFER, STREAM_ABORT, byteChannelFromMessagePort, callBidi, callPort, connect, duplexOverPort, getPortCloseSignal, ioHandle, ioSend, listenBidi, listenCancelChannel, listenPort, multiplexPort, overPipe, overPorts, postCancelChannel, recieve, send, serve, serveDuplexOverPort, setPortCloseSignal, structuredCodec, transferPortMux };
+export { CANCEL_CHANNEL_TYPE, DEFAULT_MAX_PORTS, MUX_CLOSED_MESSAGE, NO_TIMEOUT, PORT_TRANSFER, STREAM_ABORT, byteChannelFromMessagePort, callBidi, callPort, connect, duplexOverPort, getPortCloseSignal, ioHandle, ioSend, listenBidi, listenCancelChannel, listenPort, multiplexPort, overPipe, overPorts, postCancelChannel, recieve, send, serve, serveDuplexOverPort, setPortCloseSignal, structuredCodec, transferPortMux };

package/dist/multiplex-port.d.ts

@@ -1,5 +1,10 @@
 import type { MessageTarget } from "./message-target.js";
 import type { PortMux, PortMuxOptions } from "./port-types.js";
+/**
+ * The message of the error that fails the calls still in flight on a
+ * multiplexer when it is closed (`PortMux.close()`).
+ */
+export declare const MUX_CLOSED_MESSAGE = "webrun-rpc: the multiplexer was closed";
 /** Ceiling on concurrently open virtual ports. Bounds the id table only. */
 export declare const DEFAULT_MAX_PORTS = 1024;
 /**

package/dist/multiplex-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multiplex-port.d.ts","sourceRoot":"","sources":["../src/multiplex-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAgB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG7E,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAwHnF"}
+{"version":3,"file":"multiplex-port.d.ts","sourceRoot":"","sources":["../src/multiplex-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAgB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG7E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAE3E,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAwHnF"}

package/dist/virtual-port.d.ts

@@ -4,8 +4,12 @@ export interface VirtualPortHandle {
     port: MessageTarget;
     /** Multiplexer-only: hand an inbound payload to the consumer's listeners. */
     deliver(payload: unknown): void;
-    /** Multiplexer-only: the port is finished; drop listeners and go inert. */
-    markClosed(): void;
+    /**
+     * Multiplexer-only: the port is finished; drop listeners and go inert.
+     * `reason` becomes the reason of the port's close signal (see
+     * `getPortCloseSignal`), which is what fails the calls still waiting on it.
+     */
+    markClosed(reason?: unknown): void;
     isClosed(): boolean;
 }
 /**

package/dist/virtual-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-port.d.ts","sourceRoot":"","sources":["../src/virtual-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,EAC3D,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GACvC,iBAAiB,CAgDnB"}
+{"version":3,"file":"virtual-port.d.ts","sourceRoot":"","sources":["../src/virtual-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,IAAI,EAAE,aAAa,CAAC;IACpB,6EAA6E;IAC7E,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,KAAK,IAAI,EAC3D,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GACvC,iBAAiB,CA6DnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/webrun-rpc",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "description": "Ports and RPC over them: a port multiplexer, and typed request/response and streaming primitives over any MessageTarget.",

package/src/duplex-over-port.ts

@@ -9,6 +9,7 @@ import {
   toChunks,
 } from "@statewalker/webrun-streams";
 import { callPort, NO_TIMEOUT } from "./call-port.js";
+import { getPortCloseSignal } from "./close-signal.js";
 import { listenPort } from "./listen-port.js";
 import type { MessageTarget } from "./message-target.js";
 import { throughAbort } from "./through-abort.js";
@@ -82,6 +83,7 @@ export function serveDuplexOverPort(
 ): () => void {
   const controller = new AbortController();
   const notice = installAbortNotice(port, controller);
+  abortOnPortClose(port, controller);
   const clock = installStreamTimeout(controller, options.timeout);
   const inbound = receiveChunks(port, CHANNEL_IN, controller, clock.touch);
   let output: AsyncGenerator<Uint8Array>;
@@ -166,6 +168,7 @@ function runCallerSide(
 ): AsyncGenerator<Uint8Array> {
   const controller = new AbortController();
   const notice = installAbortNotice(port, controller);
+  abortOnPortClose(port, controller);
   const clock = installStreamTimeout(controller, options.timeout);
   const inbound = receiveChunks(port, CHANNEL_OUT, controller, clock.touch);
   const pump = sendChunks(port, CHANNEL_IN, input, options, controller.signal, clock.touch);
@@ -234,6 +237,30 @@ function installAbortNotice(
   };
 }
 
+/**
+ * Aborts the stream when its port closes underneath it — the multiplexer was
+ * closed, or the peer closed the port — for ports that report it (see
+ * `getPortCloseSignal`). Without this a stream waiting for the peer's next
+ * chunk would wait forever on a port that can no longer deliver one: the
+ * outbound half's `callPort` already fails on the close signal, but nothing
+ * failed the inbound half.
+ */
+function abortOnPortClose(port: MessageTarget, controller: AbortController): void {
+  const closed = getPortCloseSignal(port);
+  if (!closed) return;
+  const onClose = () => {
+    if (!controller.signal.aborted) controller.abort(closed.reason);
+  };
+  if (closed.aborted) {
+    onClose();
+    return;
+  }
+  closed.addEventListener("abort", onClose, { once: true });
+  controller.signal.addEventListener("abort", () => closed.removeEventListener("abort", onClose), {
+    once: true,
+  });
+}
+
 /**
  * The per-stream inactivity timeout (spec D8). Reset by any chunk in either
  * direction; elapsing aborts the stream. Unset, zero or non-finite installs no

package/src/index.ts

@@ -21,7 +21,7 @@ export * from "./io-send.js";
 export * from "./listen-bidi.js";
 export * from "./listen-port.js";
 export * from "./message-target.js";
-export { DEFAULT_MAX_PORTS, multiplexPort } from "./multiplex-port.js";
+export { DEFAULT_MAX_PORTS, MUX_CLOSED_MESSAGE, multiplexPort } from "./multiplex-port.js";
 export type { PortCodec, PortEnvelope, PortMux, PortMuxOptions } from "./port-types.js";
 export * from "./recieve.js";
 export * from "./send.js";

package/src/multiplex-port.ts

@@ -2,6 +2,12 @@ import type { MessageTarget } from "./message-target.js";
 import type { PortEnvelope, PortMux, PortMuxOptions } from "./port-types.js";
 import { newVirtualPort, type VirtualPortHandle } from "./virtual-port.js";
 
+/**
+ * The message of the error that fails the calls still in flight on a
+ * multiplexer when it is closed (`PortMux.close()`).
+ */
+export const MUX_CLOSED_MESSAGE = "webrun-rpc: the multiplexer was closed";
+
 /** Ceiling on concurrently open virtual ports. Bounds the id table only. */
 export const DEFAULT_MAX_PORTS = 1024;
 
@@ -70,7 +76,7 @@ export function multiplexPort(port: MessageTarget, options: PortMuxOptions): Por
       }
       if (!accepted) {
         open.delete(envelope.id);
-        handle.markClosed();
+        handle.markClosed(new Error("webrun-rpc: the port was rejected"));
         post({ type: "close", id: envelope.id, reason: "rejected" });
       }
       return;
@@ -89,7 +95,7 @@ export function multiplexPort(port: MessageTarget, options: PortMuxOptions): Por
 
     if (!handle) return;
     open.delete(envelope.id);
-    handle.markClosed();
+    handle.markClosed(new Error("webrun-rpc: the peer closed the port"));
   };
 
   const listener = (event: MessageEvent): void => {
@@ -124,7 +130,7 @@ export function multiplexPort(port: MessageTarget, options: PortMuxOptions): Por
       for (const [id, handle] of [...open]) {
         post({ type: "close", id });
         open.delete(id);
-        handle.markClosed();
+        handle.markClosed(new Error(MUX_CLOSED_MESSAGE));
       }
       muxClosed = true;
       port.removeEventListener("message", listener);

package/src/virtual-port.ts

@@ -1,3 +1,4 @@
+import { setPortCloseSignal } from "./close-signal.js";
 import type { MessageListener, MessageTarget } from "./message-target.js";
 
 export interface VirtualPortHandle {
@@ -5,8 +6,12 @@ export interface VirtualPortHandle {
   port: MessageTarget;
   /** Multiplexer-only: hand an inbound payload to the consumer's listeners. */
   deliver(payload: unknown): void;
-  /** Multiplexer-only: the port is finished; drop listeners and go inert. */
-  markClosed(): void;
+  /**
+   * Multiplexer-only: the port is finished; drop listeners and go inert.
+   * `reason` becomes the reason of the port's close signal (see
+   * `getPortCloseSignal`), which is what fails the calls still waiting on it.
+   */
+  markClosed(reason?: unknown): void;
   isClosed(): boolean;
 }
 
@@ -23,6 +28,16 @@ export function newVirtualPort(
 ): VirtualPortHandle {
   const listeners = new Set<MessageListener>();
   let closed = false;
+  // A virtual port knows when it is finished, unlike a raw `MessagePort`. Its
+  // close signal is what lets the calls still waiting on it — `callPort`, and
+  // the streams of `duplexOverPort` — fail at once instead of hanging on a
+  // port that has gone inert. Without it, closing a multiplexer left every call
+  // in flight on it pending forever.
+  const closing = new AbortController();
+  const abort = (reason?: unknown) => {
+    if (closing.signal.aborted) return;
+    closing.abort(reason ?? new Error("webrun-rpc: the port was closed"));
+  };
 
   const port: MessageTarget = {
     addEventListener(_type, listener) {
@@ -41,8 +56,10 @@ export function newVirtualPort(
       const notify = requestClose;
       listeners.clear();
       notify();
+      abort();
     },
   };
+  setPortCloseSignal(port, closing.signal);
 
   return {
     port,
@@ -60,9 +77,10 @@ export function newVirtualPort(
         }
       }
     },
-    markClosed() {
+    markClosed(reason) {
       closed = true;
       listeners.clear();
+      abort(reason);
     },
     isClosed() {
       return closed;