@statewalker/webrun-rpc 0.7.0 → 0.10.0

package/dist/multiplex-port.d.ts

@@ -7,6 +7,8 @@ import type { PortInfo, PortMux, PortMuxOptions } from "./port-types.js";
 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;
+/** Default ceiling on one message reassembled from frames (`maxReassembledBytes`). */
+export declare const DEFAULT_MAX_REASSEMBLED_BYTES: number;
 /**
  * What a message costs a port's window when the codec cannot say
  * (`PortCodec.encode`): its bytes and string lengths, found in its values up

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

@@ -1 +1 @@
-{"version":3,"file":"multiplex-port.d.ts","sourceRoot":"","sources":["../src/multiplex-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAGV,QAAQ,EACR,OAAO,EACP,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAY3E,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,GAAG;IAAE,KAAK,IAAI,QAAQ,EAAE,CAAA;CAAE,CAqnBnC"}
+{"version":3,"file":"multiplex-port.d.ts","sourceRoot":"","sources":["../src/multiplex-port.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD,OAAO,KAAK,EAIV,QAAQ,EACR,OAAO,EACP,cAAc,EACf,MAAM,iBAAiB,CAAC;AAGzB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AA6B3E,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,GAAG;IAAE,KAAK,IAAI,QAAQ,EAAE,CAAA;CAAE,CAmzBnC"}

package/dist/port-credit.d.ts

@@ -24,4 +24,55 @@ export declare function portBufferedAmount(port: MessageTarget): number;
  * task (for a port without flow control, on the next one).
  */
 export declare function whenPortReady(port: MessageTarget, below?: number): Promise<void>;
+/** A capability two ends agree on for one windowed port, in its `open` and the ack. */
+export type PortCap = "pipeline" | "end";
+/**
+ * What two ends have agreed for one windowed port so far. `caps`: what both
+ * speak, and so what the peer may send; empty until the handshake settles it
+ * (the opener learns it from the ack, the responder from the `open`).
+ * `enforced`: the window holds this end's own sends — what this end needs
+ * before it relies on the window instead of a confirmation per message.
+ */
+export interface PortAgreement {
+    window: number;
+    caps: ReadonlySet<PortCap>;
+    enforced: boolean;
+}
+/** @internal Registered by the multiplexer for each port with a window. */
+export declare function setPortAgreement(port: MessageTarget, agreement: () => PortAgreement | undefined): void;
+/**
+ * @internal What has been agreed with the peer on `port` so far; `undefined`
+ * on a port without a window. Not exported from the package.
+ */
+export declare function portAgreement(port: MessageTarget): PortAgreement | undefined;
+/** @internal The half-close of one windowed port (capability `"end"`). */
+export interface PortEndState {
+    /** Queue this side's `end`; `false` when `end` was not agreed. */
+    end(): boolean;
+    /**
+     * Calls `resolve` once the peer has ended its direction (at once if it has
+     * already); `false`, and `resolve` is never called, when `end` was not
+     * agreed. The mux holds `resolve` weakly, so a port dropped while someone
+     * waits on it can still be collected (`onLeak`).
+     */
+    watchPeerEnd(resolve: () => void): boolean;
+}
+/** @internal Registered by the multiplexer for each port with a window. */
+export declare function setPortEndState(port: MessageTarget, state: PortEndState): void;
+/**
+ * @internal End this side's direction of `port`: an `end` is queued behind
+ * everything already posted on it, and anything posted afterwards is dropped.
+ * `false`, and nothing changes, when `end` was not agreed (no window, the
+ * handshake not answered yet, or a peer that does not speak it): the caller
+ * then closes the port. Never waits on the peer. Not exported from the package.
+ */
+export declare function endPort(port: MessageTarget): boolean;
+/**
+ * @internal Resolves once the peer has ended its direction of `port`. It never
+ * settles otherwise: not on a port where `end` is not agreed when it is asked
+ * (no window, the handshake not answered yet, a peer or codec without it), and
+ * not when the port closes first, so a caller races it against the port's
+ * close signal. Not exported from the package.
+ */
+export declare function whenPortEnded(port: MessageTarget): Promise<void>;
 //# sourceMappingURL=port-credit.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"port-credit.d.ts","sourceRoot":"","sources":["../src/port-credit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,cAAc,IAAI,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AASD,gBAAgB;AAChB,eAAO,MAAM,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAenC,CAAC;AAIT,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E"}
+{"version":3,"file":"port-credit.d.ts","sourceRoot":"","sources":["../src/port-credit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,cAAc,IAAI,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AASD,gBAAgB;AAChB,eAAO,MAAM,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAenC,CAAC;AAIT,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,uFAAuF;AACvF,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,GAAG,SAAS,QAE/F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAE5E;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,GAAG,IAAI,OAAO,CAAC;IACf;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC5C;AAID,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAE9E;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE"}

package/dist/port-types.d.ts

@@ -7,12 +7,15 @@ import type { MessageTarget } from "./message-target.js";
  * and no error type: `close` carries an opaque `reason` that layer 1 never
  * inspects, because stream semantics belong above this layer.
  */
-export type PortEnvelope = {
+export type PortEnvelope = 
+/** `caps` (with a window): the capabilities the opener speaks on this port. */
+{
     type: "open";
     id: number;
     meta?: unknown;
     window?: number;
     exact?: boolean;
+    caps?: string[];
 } | {
     type: "message";
     id: number;
@@ -22,12 +25,22 @@ export type PortEnvelope = {
     id: number;
     reason?: unknown;
 }
-/** Per-port flow control (`window`): the receiver has consumed `bytes` more. */
+/**
+ * Per-port flow control (`window`): the receiver has consumed `bytes` more.
+ * The responder's zero-byte ack carries `caps`, the shared subset, when the
+ * opener listed some.
+ */
  | {
     type: "credit";
     id: number;
     bytes: number;
     exact?: boolean;
+    caps?: string[];
+}
+/** Half-close (capability `"end"`): the sender's direction of the port has ended. */
+ | {
+    type: "end";
+    id: number;
 }
 /** Fair framing (`frameSize`): one piece of an encoded `message` envelope. */
  | {
@@ -66,6 +79,15 @@ export interface PortCodec {
     encode?(envelope: PortEnvelope): Uint8Array;
     /** Optional, with `encode`: an envelope back from its bytes, or `undefined`. */
     decode?(data: unknown): PortEnvelope | undefined;
+    /**
+     * Optional: this codec's `read` (and `decode`) accept the `end` envelope.
+     * Only then does a windowed port offer the `end` capability. A codec that
+     * dropped `end` would leave a port that ended normally in the peer's table
+     * (`ports()`) until the mux closes, with no error anywhere. A codec spread
+     * from a built-in (`{ ...structuredCodec, read }`) inherits the flag: its
+     * own `read` must then accept `end` too, or it must drop the flag.
+     */
+    halfClose?: true;
 }
 export interface PortMuxOptions {
     /** How envelopes are placed on the underlying port. */
@@ -147,6 +169,19 @@ export interface PortMuxOptions {
      * whole. 16-64 KiB is a reasonable range.
      */
     frameSize?: number;
+    /**
+     * Ceiling, in bytes, on what this side holds of a peer's framed messages
+     * past their ports' windows, summed over all ports (default 64 MiB).
+     * A partial message counts against its port's window as it arrives: one
+     * begun while this side still owed credit must fit what the window left,
+     * and one begun with nothing owed may pass the window, its excess charged
+     * to this cap. A frame past either limit makes the mux drop that port's
+     * partial message, close the port with a `RangeError` and send the peer a
+     * close with reason `"max-reassembled-bytes"`. A framed message more than
+     * this cap past the window never arrives, though the same message sent
+     * whole would.
+     */
+    maxReassembledBytes?: number;
     /**
      * Liveness of the peer (off when unset). Every `intervalMs` the mux pings
      * and the peer answers; anything from it counts as an answer. After `misses`

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

@@ -1 +1 @@
-{"version":3,"file":"port-types.d.ts","sourceRoot":"","sources":["../src/port-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"port-types.d.ts","sourceRoot":"","sources":["../src/port-types.ts"],"names":[],"mappings":"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"}

package/dist/structured-codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured-codec.d.ts","sourceRoot":"","sources":["../src/structured-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAkB/D;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,SAU7B,CAAC"}
+{"version":3,"file":"structured-codec.d.ts","sourceRoot":"","sources":["../src/structured-codec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,iBAAiB,CAAC;AAmB/D;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,SAa7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statewalker/webrun-rpc",
-  "version": "0.7.0",
+  "version": "0.10.0",
   "private": false,
   "type": "module",
   "description": "Ports and RPC over them: a port multiplexer, and typed request/response and streaming primitives over any MessageTarget.",
@@ -39,6 +39,9 @@
     "rolldown": "^1.2.12",
     "typescript": "^7.0.2",
     "vitest": "^5.0.3",
+    "webrun-rpc-0-5": "npm:@statewalker/webrun-rpc@0.5.1",
+    "webrun-rpc-0-7": "npm:@statewalker/webrun-rpc@0.7.0",
+    "webrun-rpc-0-8": "npm:@statewalker/webrun-rpc@0.8.0",
     "@statewalker/webrun-streams-conformance": "^0.3.3"
   },
   "sideEffects": false,
@@ -49,6 +52,7 @@
   "scripts": {
     "build": "rimraf dist && rolldown -c && tsc --emitDeclarationOnly --declaration",
     "test": "vitest run",
+    "bench": "vitest run --config vitest.bench.config.ts && echo \"all benchmarks passed\"",
     "typecheck": "tsc --noEmit",
     "typecheck:tests": "tsc -p tsconfig.tests.json",
     "lint": "biome check src tests"

package/src/connect-serve.ts

@@ -139,15 +139,24 @@ export const serve: Serve<PortParams> = async ({ mux: factory, timeout }, handle
     // reaches it as `return()` through `throughAbort`, so the `finally` runs
     // on every ending — normal exhaustion, handler throw, peer abort, local
     // teardown. `serveDuplexOverPort` reports no completion of its own.
-    const tracked: Duplex = (input) =>
-      (async function* () {
-        try {
-          yield* handler(input);
-        } finally {
-          finished = true;
-          if (off) live.delete(off);
-        }
-      })();
+    const tracked: Duplex = (input) => {
+      const output = handler(input);
+      // `return()` on this wrapper is queued behind its pending `next()`, as on
+      // any async generator, so the abandonment would reach the handler only
+      // once it answers. Forwarded at once, a handler still waiting (an HTTP
+      // long poll) learns now that its caller left.
+      return returningAtOnce(
+        (async function* () {
+          try {
+            yield* output;
+          } finally {
+            finished = true;
+            if (off) live.delete(off);
+          }
+        })(),
+        () => void output.return(undefined).catch(() => {}),
+      );
+    };
     off = serveDuplexOverPort(port, tracked, streamOptions);
     // `serveDuplexOverPort` invokes the handler synchronously. The generator
     // body above is lazy, so today it cannot have finished by the time `off`
@@ -201,6 +210,8 @@ export interface OverPipeOptions {
   window?: number;
   /** Fair framing in bytes — see `PortMuxOptions.frameSize`. */
   frameSize?: number;
+  /** Ceiling on a message reassembled from frames — see `PortMuxOptions.maxReassembledBytes`. */
+  maxReassembledBytes?: number;
   /** Liveness of the peer by ping/pong — see `PortMuxOptions.keepalive`. */
   keepalive?: { intervalMs: number; misses?: number };
   /** Development aid: report ports dropped without `close()` — see `PortMuxOptions.onLeak`. */