@grackle-ai/ahp-transport 0.132.0

package/dist/json-rpc-session.js

@@ -0,0 +1,294 @@
+/**
+ * JSON-RPC 2.0 framing engine over a single WebSocket. Owns:
+ *   - outbound request/response correlation by numeric id
+ *   - inbound dispatch to `onRequest` / `onNotification`
+ *   - per-request timeouts
+ *   - close-rejects-all-pending-with-ConnectionLost
+ *
+ * Channels (AHP routing) are deliberately NOT understood here — that's
+ * `MultiHostClient`'s job. This class only does framing.
+ */
+import { JsonRpcErrorCodes } from "@grackle-ai/ahp";
+import { TransportError, WsCloseCode } from "./error-codes.js";
+/**
+ * Bidirectional JSON-RPC session over one WebSocket.
+ *
+ * @example Wrap an already-OPEN ws connection and exchange a typed request:
+ * ```ts
+ * import { WebSocket } from "ws";
+ * const socket = new WebSocket(url);
+ * await new Promise((r) => socket.once("open", r));
+ *
+ * const session = new JsonRpcSession({
+ *   socket,
+ *   onNotification: (n) => console.log("inbound:", n.method),
+ * });
+ * const result = await session.request("ping", { channel: "ahp-root://" });
+ * ```
+ *
+ * @example Send a response that closes the session after the frame flushes:
+ * ```ts
+ * const session = new JsonRpcSession({
+ *   socket,
+ *   onRequest: async (req) => ({
+ *     response: { jsonrpc: "2.0", id: req.id, error: { code: -32600, message: "bad" } },
+ *     afterSend: () => session.close(1000, "bye"),
+ *   }),
+ * });
+ * ```
+ */
+export class JsonRpcSession {
+    socket;
+    onRequest;
+    onNotification;
+    onClose;
+    requestTimeoutMs;
+    nextRequestId = 1;
+    pendingRequests = new Map();
+    closed = false;
+    constructor(opts) {
+        this.socket = opts.socket;
+        this.onRequest = opts.onRequest;
+        this.onNotification = opts.onNotification;
+        this.onClose = opts.onClose;
+        this.requestTimeoutMs = opts.requestTimeoutMs;
+        this.socket.on("message", this.handleMessage);
+        this.socket.on("close", this.handleClose);
+        this.socket.on("error", this.handleError);
+    }
+    /** Sends a request and resolves with the result (or rejects with the error). */
+    request(method, params) {
+        if (this.closed) {
+            return Promise.reject(new TransportError("connection-lost", `request ${String(method)} after close`));
+        }
+        const id = this.nextRequestId++;
+        return new Promise((resolve, reject) => {
+            const entry = {
+                method: String(method),
+                resolve: resolve,
+                reject,
+                timeoutHandle: undefined,
+            };
+            if (this.requestTimeoutMs !== undefined) {
+                entry.timeoutHandle = setTimeout(() => {
+                    if (this.pendingRequests.delete(id)) {
+                        reject(new TransportError("request-timeout", `request ${entry.method} timed out after ${this.requestTimeoutMs}ms`));
+                    }
+                }, this.requestTimeoutMs);
+            }
+            this.pendingRequests.set(id, entry);
+            // If sending fails (e.g., socket closed mid-call), reject immediately.
+            try {
+                this.socket.send(JSON.stringify({ jsonrpc: "2.0", id, method, params }));
+            }
+            catch (err) {
+                this.pendingRequests.delete(id);
+                if (entry.timeoutHandle !== undefined) {
+                    clearTimeout(entry.timeoutHandle);
+                }
+                reject(new TransportError("connection-lost", `request ${entry.method} failed to send: ${err.message}`));
+            }
+        });
+    }
+    /** Sends a notification (fire-and-forget). Silently drops if already closed. */
+    notify(method, params) {
+        if (this.closed) {
+            return;
+        }
+        try {
+            this.socket.send(JSON.stringify({ jsonrpc: "2.0", method, params }));
+        }
+        catch {
+            // Socket closed between the check and send; drop silently.
+        }
+    }
+    /** Closes the underlying socket. Idempotent. */
+    close(code, reason) {
+        if (this.closed) {
+            return;
+        }
+        this.socket.close(code, reason);
+    }
+    /** True between construction and the socket's "close" event firing. */
+    get isOpen() {
+        return !this.closed;
+    }
+    // ─── Inbound message dispatch ──────────────────────────────────────
+    handleMessage = (data, isBinary) => {
+        if (isBinary) {
+            this.socket.close(WsCloseCode.UnsupportedData, "binary frames not supported");
+            return;
+        }
+        const text = typeof data === "string"
+            ? data
+            : Buffer.isBuffer(data)
+                ? data.toString("utf8")
+                : Buffer.concat(Array.isArray(data) ? data : [Buffer.from(data)]).toString("utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // Malformed JSON: if it looked like a request with an id, we can't
+            // recover the id, so just drop. JSON-RPC spec says respond with
+            // ParseError + id=null, but a null id is rarely actionable.
+            this.tryWriteParseError();
+            return;
+        }
+        if (!isObject(parsed) || parsed["jsonrpc"] !== "2.0") {
+            // Not a JSON-RPC envelope; drop.
+            return;
+        }
+        const idValue = parsed["id"];
+        const hasId = typeof idValue === "number";
+        if (hasId) {
+            if ("result" in parsed) {
+                this.resolvePending(idValue, parsed["result"]);
+                return;
+            }
+            if ("error" in parsed) {
+                this.rejectPending(idValue, parsed["error"]);
+                return;
+            }
+            if (typeof parsed["method"] === "string") {
+                void this.handleInboundRequest(parsed);
+                return;
+            }
+            // Has an id but neither result/error/method: invalid.
+            this.writeError(idValue, JsonRpcErrorCodes.InvalidRequest, "malformed envelope");
+            return;
+        }
+        if (typeof parsed["method"] === "string") {
+            this.handleInboundNotification(parsed);
+            return;
+        }
+        // No id and no method: drop silently.
+    };
+    resolvePending(id, result) {
+        const entry = this.pendingRequests.get(id);
+        if (entry === undefined) {
+            return;
+        }
+        this.pendingRequests.delete(id);
+        if (entry.timeoutHandle !== undefined) {
+            clearTimeout(entry.timeoutHandle);
+        }
+        entry.resolve(result);
+    }
+    rejectPending(id, error) {
+        const entry = this.pendingRequests.get(id);
+        if (entry === undefined) {
+            return;
+        }
+        this.pendingRequests.delete(id);
+        if (entry.timeoutHandle !== undefined) {
+            clearTimeout(entry.timeoutHandle);
+        }
+        entry.reject(error);
+    }
+    async handleInboundRequest(req) {
+        if (this.onRequest === undefined) {
+            this.writeError(req.id, JsonRpcErrorCodes.MethodNotFound, `no handler for ${req.method}`);
+            return;
+        }
+        try {
+            const result = await this.onRequest(req);
+            const isWrapped = isObject(result) && "response" in result && "afterSend" in result;
+            if (isWrapped) {
+                const { response, afterSend } = result;
+                this.sendAndThen(response, afterSend);
+            }
+            else {
+                this.socket.send(JSON.stringify(result));
+            }
+        }
+        catch (err) {
+            this.writeError(req.id, JsonRpcErrorCodes.InternalError, err.message || "handler threw");
+        }
+    }
+    /**
+     * Sends `frame` and invokes `after` once the data has been flushed to the
+     * OS socket buffer. Use this when a side effect (e.g., closing the session)
+     * MUST follow the frame on the wire.
+     *
+     * `after` runs even if `socket.send` errors — the typical close-after-error
+     * caller wants the close to proceed regardless.
+     */
+    sendAndThen(frame, after) {
+        if (this.closed) {
+            // Fire `after` immediately if the socket is already gone; otherwise the
+            // callback would leak.
+            after();
+            return;
+        }
+        try {
+            this.socket.send(JSON.stringify(frame), (err) => {
+                // The callback fires once the data is flushed to the kernel buffer
+                // (or immediately with an error if the socket is no longer writable).
+                // We always run `after` regardless.
+                void err;
+                after();
+            });
+        }
+        catch {
+            // Synchronous send failure (socket already closed mid-call). Run after.
+            after();
+        }
+    }
+    handleInboundNotification(notif) {
+        if (this.onNotification === undefined) {
+            return;
+        }
+        try {
+            this.onNotification(notif);
+        }
+        catch {
+            // Notification handler errors are swallowed to keep the session alive.
+        }
+    }
+    writeError(id, code, message) {
+        try {
+            this.socket.send(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }));
+        }
+        catch {
+            // Socket likely closing; ignore.
+        }
+    }
+    tryWriteParseError() {
+        try {
+            this.socket.send(JSON.stringify({
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: JsonRpcErrorCodes.ParseError, message: "parse error" },
+            }));
+        }
+        catch {
+            // Ignore.
+        }
+    }
+    // ─── Lifecycle ─────────────────────────────────────────────────────
+    handleClose = (code, reason) => {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        const reasonStr = reason.toString("utf8");
+        for (const [, entry] of this.pendingRequests) {
+            if (entry.timeoutHandle !== undefined) {
+                clearTimeout(entry.timeoutHandle);
+            }
+            entry.reject(new TransportError("connection-lost", `connection lost while ${entry.method} pending (code=${code})`));
+        }
+        this.pendingRequests.clear();
+        this.onClose?.(code, reasonStr);
+    };
+    handleError = (_err) => {
+        // ws emits "error" before "close" on transport failures. The "close"
+        // handler does the work; this listener exists so the EventEmitter doesn't
+        // crash the process on unhandled "error" events.
+    };
+}
+function isObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=json-rpc-session.js.map

package/dist/json-rpc-session.js.map

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

package/dist/mocks/fake-websocket.d.ts

@@ -0,0 +1,53 @@
+/**
+ * EventEmitter-shaped WebSocket double for unit tests. Implements just the
+ * subset of `ws.WebSocket` that `JsonRpcSession` and `AhpClientSocket`
+ * actually call, plus test-only helpers (`open`, `receive`, `receivePong`,
+ * `remoteClose`) for driving inbound events.
+ *
+ * Tests pass instances to consumers via `as unknown as WebSocket` casts.
+ * Excluded from coverage by the rig's `src/**\/mocks/**` glob.
+ */
+import { EventEmitter } from "node:events";
+/** Mirrors `ws.WebSocket` `readyState` constants. */
+export declare const FakeReadyState: {
+    readonly Connecting: 0;
+    readonly Open: 1;
+    readonly Closing: 2;
+    readonly Closed: 3;
+};
+export type FakeReadyState = (typeof FakeReadyState)[keyof typeof FakeReadyState];
+/** Test-only WebSocket double. */
+export declare class FakeWebSocket extends EventEmitter {
+    readyState: FakeReadyState;
+    /** Frames the SUT sent. UTF-8 strings appear as strings; binary frames as Buffer. */
+    readonly sent: Array<string | Buffer>;
+    /** Counts of `ping()` calls made by the SUT. */
+    pingCount: number;
+    /** Captured close calls from the SUT. */
+    closedBy: {
+        code?: number;
+        reason?: string;
+    } | undefined;
+    /**
+     * Mirrors `ws.WebSocket.send(data[, cb])`. The callback (when provided) is
+     * invoked on the next microtask with `undefined` as the error parameter,
+     * matching ws's "flushed cleanly" semantics. Tests can override the
+     * delivery timing by stubbing this method.
+     */
+    send(data: string | Buffer, cb?: (err?: Error) => void): void;
+    close(code?: number, reason?: string): void;
+    ping(): void;
+    /** Transitions to OPEN and fires the "open" event. */
+    open(): void;
+    /** Fires a "message" event with a text frame. */
+    receive(text: string): void;
+    /** Fires a "message" event with a binary frame. */
+    receiveBinary(data: Buffer): void;
+    /** Fires a "pong" event. */
+    receivePong(): void;
+    /** Simulates a remote close: fires "close" without going through close(). */
+    remoteClose(code: number, reason?: string): void;
+    /** Simulates a transport error. */
+    emitError(err: Error): void;
+}
+//# sourceMappingURL=fake-websocket.d.ts.map

package/dist/mocks/fake-websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-websocket.d.ts","sourceRoot":"","sources":["../../src/mocks/fake-websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qDAAqD;AACrD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,kCAAkC;AAClC,qBAAa,aAAc,SAAQ,YAAY;IACtC,UAAU,EAAE,cAAc,CAA6B;IAC9D,qFAAqF;IACrF,SAAgB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAM;IAClD,gDAAgD;IACzC,SAAS,SAAK;IACrB,yCAAyC;IAClC,QAAQ,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAIhE;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAU7D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAa3C,IAAI,IAAI,IAAI;IAMnB,sDAAsD;IAC/C,IAAI,IAAI,IAAI;IAKnB,iDAAiD;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,mDAAmD;IAC5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,4BAA4B;IACrB,WAAW,IAAI,IAAI;IAI1B,6EAA6E;IACtE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,IAAI;IAKnD,mCAAmC;IAC5B,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;CAGnC"}

package/dist/mocks/fake-websocket.js

@@ -0,0 +1,86 @@
+/**
+ * EventEmitter-shaped WebSocket double for unit tests. Implements just the
+ * subset of `ws.WebSocket` that `JsonRpcSession` and `AhpClientSocket`
+ * actually call, plus test-only helpers (`open`, `receive`, `receivePong`,
+ * `remoteClose`) for driving inbound events.
+ *
+ * Tests pass instances to consumers via `as unknown as WebSocket` casts.
+ * Excluded from coverage by the rig's `src/**\/mocks/**` glob.
+ */
+import { EventEmitter } from "node:events";
+/** Mirrors `ws.WebSocket` `readyState` constants. */
+export const FakeReadyState = {
+    Connecting: 0,
+    Open: 1,
+    Closing: 2,
+    Closed: 3,
+};
+/** Test-only WebSocket double. */
+export class FakeWebSocket extends EventEmitter {
+    readyState = FakeReadyState.Connecting;
+    /** Frames the SUT sent. UTF-8 strings appear as strings; binary frames as Buffer. */
+    sent = [];
+    /** Counts of `ping()` calls made by the SUT. */
+    pingCount = 0;
+    /** Captured close calls from the SUT. */
+    closedBy;
+    // ─── ws.WebSocket surface used by JsonRpcSession ───────────────────
+    /**
+     * Mirrors `ws.WebSocket.send(data[, cb])`. The callback (when provided) is
+     * invoked on the next microtask with `undefined` as the error parameter,
+     * matching ws's "flushed cleanly" semantics. Tests can override the
+     * delivery timing by stubbing this method.
+     */
+    send(data, cb) {
+        if (this.readyState !== FakeReadyState.Open) {
+            throw new Error(`FakeWebSocket: send() called in readyState=${this.readyState}`);
+        }
+        this.sent.push(data);
+        if (cb !== undefined) {
+            queueMicrotask(() => cb());
+        }
+    }
+    close(code, reason) {
+        if (this.readyState === FakeReadyState.Closed) {
+            return;
+        }
+        this.closedBy = { code, reason };
+        this.readyState = FakeReadyState.Closing;
+        // Synthesize the close event asynchronously, matching ws behavior.
+        queueMicrotask(() => {
+            this.readyState = FakeReadyState.Closed;
+            this.emit("close", code ?? 1000, Buffer.from(reason ?? ""));
+        });
+    }
+    ping() {
+        this.pingCount += 1;
+    }
+    // ─── Test-only inbound drivers ─────────────────────────────────────
+    /** Transitions to OPEN and fires the "open" event. */
+    open() {
+        this.readyState = FakeReadyState.Open;
+        this.emit("open");
+    }
+    /** Fires a "message" event with a text frame. */
+    receive(text) {
+        this.emit("message", Buffer.from(text, "utf8"), false);
+    }
+    /** Fires a "message" event with a binary frame. */
+    receiveBinary(data) {
+        this.emit("message", data, true);
+    }
+    /** Fires a "pong" event. */
+    receivePong() {
+        this.emit("pong", Buffer.alloc(0));
+    }
+    /** Simulates a remote close: fires "close" without going through close(). */
+    remoteClose(code, reason = "") {
+        this.readyState = FakeReadyState.Closed;
+        this.emit("close", code, Buffer.from(reason));
+    }
+    /** Simulates a transport error. */
+    emitError(err) {
+        this.emit("error", err);
+    }
+}
+//# sourceMappingURL=fake-websocket.js.map

package/dist/mocks/fake-websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-websocket.js","sourceRoot":"","sources":["../../src/mocks/fake-websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,CAAC;IACb,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;CACD,CAAC;AAIX,kCAAkC;AAClC,MAAM,OAAO,aAAc,SAAQ,YAAY;IACtC,UAAU,GAAmB,cAAc,CAAC,UAAU,CAAC;IAC9D,qFAAqF;IACrE,IAAI,GAA2B,EAAE,CAAC;IAClD,gDAAgD;IACzC,SAAS,GAAG,CAAC,CAAC;IACrB,yCAAyC;IAClC,QAAQ,CAAiD;IAEhE,sEAAsE;IAEtE;;;;;OAKG;IACI,IAAI,CAAC,IAAqB,EAAE,EAA0B;QAC3D,IAAI,IAAI,CAAC,UAAU,KAAK,cAAc,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAa,EAAE,MAAe;QACzC,IAAI,IAAI,CAAC,UAAU,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC;QACzC,mEAAmE;QACnE,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,IAAI;QACT,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,sEAAsE;IAEtE,sDAAsD;IAC/C,IAAI;QACT,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAED,iDAAiD;IAC1C,OAAO,CAAC,IAAY;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,mDAAmD;IAC5C,aAAa,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,4BAA4B;IACrB,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,6EAA6E;IACtE,WAAW,CAAC,IAAY,EAAE,MAAM,GAAG,EAAE;QAC1C,IAAI,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,mCAAmC;IAC5B,SAAS,CAAC,GAAU;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/mocks/test-driver.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Test harness that lets a property-based fuzzer (or any test) drive an
+ * `AhpServerSocket` + `AhpClientSocket` pair through arbitrary sequences
+ * of operations and observe the resulting state. Excluded from coverage.
+ */
+import { AhpClientSocket, type AhpConnectionState } from "../ahp-client-socket.js";
+import { type AhpServerConnection, type AhpServerSocketOptions } from "../ahp-server-socket.js";
+/** Records every state transition for invariant checks. */
+export interface StateTransition {
+    readonly at: number;
+    readonly state: AhpConnectionState;
+}
+/** Per-driver state used by tests/fuzzers. */
+export interface TestDriver {
+    readonly client: AhpClientSocket;
+    /** Set after the server has been booted. Cleared on serverDown. */
+    serverConnections: AhpServerConnection[];
+    /** Full history of client state transitions. */
+    readonly transitions: StateTransition[];
+    /** Settle-history for every request the driver issued. */
+    readonly requestOutcomes: Array<"resolved" | "rejected">;
+    /**
+     * Set if any request promise settled MORE than once. The fuzzer asserts
+     * this stays empty as invariant I3 (exactly-once settle).
+     */
+    readonly doubleSettleErrors: string[];
+    /** Start (or restart) the server on the original port. */
+    startServer(opts?: Partial<AhpServerSocketOptions>): Promise<void>;
+    /** Stop the server. Existing client connections drop. */
+    stopServer(): Promise<void>;
+    /** Kick the most-recently-established server session. No-op if no session. */
+    kickSession(): void;
+    /** Issue a typed request through the client. Tracks the settle. */
+    request(): Promise<void>;
+    /** Send a notification through the client. */
+    notify(): void;
+    /** Sleep `ms` of real time. */
+    wait(ms: number): Promise<void>;
+    /** Close + dispose the driver. */
+    dispose(): Promise<void>;
+}
+export interface TestDriverOptions {
+    /** Backoff for the client. Defaults to tight 5ms reconnects for fuzz speed. */
+    readonly backoffMs?: number;
+}
+export declare function createTestDriver(options?: TestDriverOptions): Promise<TestDriver>;
+//# sourceMappingURL=test-driver.d.ts.map

package/dist/mocks/test-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-driver.d.ts","sourceRoot":"","sources":["../../src/mocks/test-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGnF,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAQjC,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,mEAAmE;IACnE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAEtC,0DAA0D;IAC1D,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,yDAAyD;IACzD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,8EAA8E;IAC9E,WAAW,IAAI,IAAI,CAAC;IACpB,mEAAmE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,8CAA8C;IAC9C,MAAM,IAAI,IAAI,CAAC;IACf,+BAA+B;IAC/B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,kCAAkC;IAClC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2G3F"}

package/dist/mocks/test-driver.js

@@ -0,0 +1,122 @@
+/**
+ * Test harness that lets a property-based fuzzer (or any test) drive an
+ * `AhpServerSocket` + `AhpClientSocket` pair through arbitrary sequences
+ * of operations and observe the resulting state. Excluded from coverage.
+ */
+import { createServer } from "node:http";
+import { AhpClientSocket } from "../ahp-client-socket.js";
+import { exponentialBackoff } from "../backoff.js";
+import { InMemoryClientIdStore } from "../client-id-store.js";
+import { AhpServerSocket, } from "../ahp-server-socket.js";
+const INIT_RESULT = {
+    protocolVersion: "0.1.0",
+    serverSeq: 0,
+    snapshots: [],
+};
+export async function createTestDriver(options = {}) {
+    const backoffMs = options.backoffMs ?? 5;
+    // Grab a free port via a brief listen-then-close. There's a small
+    // theoretical race against other vitest workers that could grab the
+    // same port between close and the next startServer, but in practice
+    // operating systems hold recently-freed ports in TIME_WAIT long enough
+    // for the test to re-bind. We tolerate the rare flake rather than pay
+    // the complexity of port-keeping with a fallback upgrade handler.
+    const initialServer = createServer();
+    await new Promise((r) => initialServer.listen(0, "127.0.0.1", r));
+    const port = initialServer.address().port;
+    await new Promise((r) => initialServer.close(() => r()));
+    let server;
+    let ahp;
+    const serverConnections = [];
+    const transitions = [];
+    const requestOutcomes = [];
+    const doubleSettleErrors = [];
+    let startedAt = Date.now();
+    let requestSeq = 0;
+    const client = new AhpClientSocket({
+        url: `ws://127.0.0.1:${port}/ahp`,
+        powerlineToken: "tok",
+        clientIdStore: new InMemoryClientIdStore(),
+        clientIdKey: "fuzz",
+        backoff: exponentialBackoff({ initialMs: backoffMs, maxMs: backoffMs, jitter: 0 }),
+        onStateChange: (s) => transitions.push({ at: Date.now() - startedAt, state: s }),
+    });
+    const driver = {
+        client,
+        serverConnections,
+        transitions,
+        requestOutcomes,
+        doubleSettleErrors,
+        async startServer(opts) {
+            if (server !== undefined) {
+                return;
+            }
+            server = createServer();
+            await new Promise((r) => server.listen(port, "127.0.0.1", r));
+            ahp = new AhpServerSocket({
+                server,
+                powerlineToken: "tok",
+                onInitialize: () => INIT_RESULT,
+                onConnection: (c) => serverConnections.push(c),
+                onRequest: async (req) => ({
+                    jsonrpc: "2.0",
+                    id: req.id,
+                    result: null,
+                }),
+                ...opts,
+            });
+        },
+        async stopServer() {
+            if (server === undefined) {
+                return;
+            }
+            await ahp.close();
+            await new Promise((r) => server.close(() => r()));
+            server = undefined;
+            ahp = undefined;
+            serverConnections.length = 0;
+        },
+        kickSession() {
+            const last = serverConnections[serverConnections.length - 1];
+            if (last !== undefined) {
+                last.session.close(1011, "kicked");
+            }
+        },
+        async request() {
+            const id = requestSeq++;
+            let settled = false;
+            const recordSettle = (outcome) => {
+                if (settled) {
+                    doubleSettleErrors.push(`request ${id} settled twice (last: ${outcome})`);
+                    return;
+                }
+                settled = true;
+                requestOutcomes.push(outcome);
+            };
+            try {
+                await client.request("ping", { channel: "ahp-root://" });
+                recordSettle("resolved");
+            }
+            catch {
+                recordSettle("rejected");
+            }
+        },
+        notify() {
+            try {
+                client.notify("unsubscribe", { channel: "ahp-session:/x" });
+            }
+            catch {
+                // notify is fire-and-forget; swallow
+            }
+        },
+        async wait(ms) {
+            await new Promise((r) => setTimeout(r, ms));
+        },
+        async dispose() {
+            await client.close();
+            await this.stopServer();
+        },
+    };
+    return driver;
+}
+//# sourceMappingURL=test-driver.js.map

package/dist/mocks/test-driver.js.map

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

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}