@procedures/client 0.2.2 → 0.3.0

package/dist/adapters/websocket/client/types.d.ts

@@ -3,8 +3,12 @@
  *
  * Type definitions for WebSocket client adapter.
  */
+import type { Duration } from "../../../duration.js";
+import type { Clock } from "../../../clock.js";
+import type { MachineTransition } from "../../../machines.js";
+import type { RequestHandler } from "../../../server/types.js";
 /**
- * WebSocket client transport options.
+ * WebSocket client transport options. Each time is a `Duration` (roadmap R11).
  */
 export interface WebSocketTransportOptions {
     /**
@@ -27,32 +31,41 @@ export interface WebSocketTransportOptions {
          */
         maxAttempts?: number;
         /**
-         * Initial delay before reconnecting (ms).
-         * @default 1000
+         * Initial delay before reconnecting.
+         * @default 1 second
          */
-        initialDelay?: number;
+        initialDelay?: Duration;
         /**
-         * Maximum delay between reconnection attempts (ms).
-         * @default 30000
+         * Maximum delay between reconnection attempts.
+         * @default 30 seconds
          */
-        maxDelay?: number;
+        maxDelay?: Duration;
         /**
          * Backoff multiplier for reconnection delay.
          * @default 1.5
          */
         backoffMultiplier?: number;
+        /**
+         * The random part of each reconnect delay, from 0 to 1. With 1 (full jitter), the delay is a
+         * random time from 0 to the backoff delay, so many clients that lost one server do not
+         * reconnect at the same time (roadmap R3). 0 gives the backoff delay exactly.
+         * @default 1
+         */
+        jitter?: number;
     };
     /**
-     * Connection timeout (ms): how long to wait for the WebSocket to open.
-     * @default 10000
+     * Connection timeout: how long to wait for the WebSocket to open. A handshake that takes
+     * longer closes the socket, and the transport reconnects (roadmap R3: before, an address that
+     * never answered kept the socket in CONNECTING).
+     * @default 10 seconds
      */
-    connectionTimeout?: number;
+    connectionTimeout?: Duration;
     /**
-     * Request timeout (ms): how long to wait for the response to one request.
+     * Request timeout: how long to wait for the response to one request.
      * (Before, requests used connectionTimeout, so every call was capped at 10s.)
-     * @default 30000
+     * @default 30 seconds
      */
-    requestTimeout?: number;
+    requestTimeout?: Duration;
     /**
      * The number of stream items that the transport holds for a reader that has not taken them.
      * The server sends no more items until the reader takes some (deep dive TRN-3).
@@ -69,15 +82,21 @@ export interface WebSocketTransportOptions {
          */
         enabled?: boolean;
         /**
-         * Heartbeat interval (ms).
-         * @default 30000
+         * Heartbeat interval.
+         * @default 20 seconds (`TIMER_DEFAULTS.webSocketClient.heartbeatIntervalMs`)
+         */
+        interval?: Duration;
+        /**
+         * Heartbeat timeout.
+         * @default 5 seconds
          */
-        interval?: number;
+        timeout?: Duration;
         /**
-         * Heartbeat timeout (ms).
-         * @default 5000
+         * The number of pings without a pong, one after the other, that drop the connection. The
+         * time to find a dead server is at most `misses × interval + timeout`.
+         * @default 1
          */
-        timeout?: number;
+        misses?: number;
     };
     /**
      * Callback when connection is established.
@@ -97,15 +116,43 @@ export interface WebSocketTransportOptions {
     onError?: (error: Error) => void;
     /**
      * Handler for server-initiated procedure calls.
-     * Called when the server wants to call a procedure on this client.
+     * Called when the server wants to call a procedure on this client. It gets the path and the
+     * input, and gives the value. `serve` is the full form (roadmap R24).
      */
     onServerRequest?: ServerRequestHandler;
+    /**
+     * The handler of the calls that the server sends to this client (roadmap R24), for example a
+     * `ProcedureServer` with the registry of the client. A call gets the same frames as a call of
+     * the client: streaming, credit, cancel, the signal and the deadline (`procedure-timeout`). The
+     * server reaches it with `callConnection()` or `transportFor()`. Without it (and without
+     * `onServerRequest`), the client answers each call of the server with `NOT_FOUND`.
+     */
+    serve?: RequestHandler;
     /**
      * Handler for subscription events.
      * Called when the server pushes an event to a subscribed topic.
      */
     onEvent?: EventHandler;
+    /**
+     * The clock of each timer of the transport: the handshake, the requests, the heartbeat and the
+     * reconnect (roadmap R35). The default is the clock of the platform. A test gives a fake clock.
+     */
+    clock?: Clock;
+    /**
+     * This function gets each change of the state, with its event, as a transition of
+     * `WEBSOCKET_CONNECTION_MACHINE` (roadmap R35). A test replays them against the document.
+     */
+    onTransition?: (transition: MachineTransition) => void;
+    /**
+     * The class of the sockets. The default is the global `WebSocket`. In Node, give the `WebSocket`
+     * of the `ws` package: a drop then ends its socket at once with `terminate()`. The global
+     * `WebSocket` has only `close()`, which waits for the answer of the peer. With a dead peer, the
+     * socket stays open until the kernel stops it, at most 15 minutes (the harness cells of R36).
+     */
+    webSocket?: WebSocketClass;
 }
+/** A class of WebSockets: the global `WebSocket`, or the `WebSocket` of the `ws` package. */
+export type WebSocketClass = new (url: string) => unknown;
 /**
  * WebSocket connection state.
  */
@@ -123,7 +170,9 @@ export interface WebSocketMessage<T = unknown> {
     /** Message ID for request/response matching */
     id: string;
     /** Message type */
-    type: "request" | "response" | "error" | "stream" | "cancel" | "credit" | "ping" | "pong" | "server-request" | "server-response" | "event";
+    type: "hello" | "request" | "response" | "error" | "stream" | "cancel" | "credit" | "ping" | "pong" | "server-request" | "server-response" | "event";
+    /** The protocol version of a `hello` frame (roadmap R25). */
+    protocol?: number;
     /** RPC method (for requests) */
     method?: {
         service: string;

package/dist/adapters/websocket/client/types.d.ts.map

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

package/dist/adapters/websocket/client/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/adapters/websocket/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2HH;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,iDAA+B,CAAA;IAC/B,+CAA6B,CAAA;IAC7B,+CAA6B,CAAA;AAC/B,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/adapters/websocket/client/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmLH;;GAEG;AACH,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,iDAA+B,CAAA;IAC/B,+CAA6B,CAAA;IAC7B,+CAA6B,CAAA;AAC/B,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB"}

package/dist/adapters/websocket/server/transport.d.ts

@@ -5,24 +5,64 @@
  * Supports bidirectional streaming and persistent connections.
  */
 import type { ServerTransport } from "../../../server/types.js";
-import type { Server } from "../../../server/server.js";
+import type { Message, ResponseItem, Transport } from "../../../client/types.js";
+import type { RequestHandler } from "../../../server/types.js";
 import type { WebSocketServerTransportOptions, WebSocketMessage, TrackedConnection, ConnectionEventHandler } from "./types.js";
+/**
+ * WebSocket server transport adapter.
+ *
+ * Provides persistent, bidirectional RPC over WebSocket.
+ * Perfect for real-time updates and streaming responses.
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from "http";
+ * const httpServer = createServer();
+ *
+ * const server = new Server();
+ * const wsTransport = new WebSocketServerTransport(server, {
+ *   server: httpServer,
+ *   path: "/ws",
+ *   authenticate: async (req) => {
+ *     // Verify token from query string or headers
+ *     return true;
+ *   }
+ * });
+ *
+ * await wsTransport.start();
+ * httpServer.listen(3000);
+ * ```
+ */
 export declare class WebSocketServerTransport implements ServerTransport {
     readonly name = "websocket";
     private wss;
     private options;
     private server;
     private connections;
+    /** The time until the first frame of a call to a client, in milliseconds (R24) */
+    private readonly reverseRequestTimeoutMs;
+    /** The heartbeat of the server, or undefined when it is off (roadmap R3) */
+    private readonly heartbeat;
+    private heartbeatTimer;
+    /** The pings without a pong, one after the other, of each connection */
+    private readonly missedPongs;
     private trackedConnections;
-    private pendingRequests;
     private connectionCounter;
-    private inflight;
-    private credits;
+    /**
+     * The calls of each connection in the two directions (roadmap R24): the calls that the client
+     * sends (served by the server) and the calls that the server sends to the client.
+     */
+    private readonly channels;
     /** The browser checks of each connection (see `server/browser-guard.ts`) */
     private readonly guard;
     private connectHandlers;
     private disconnectHandlers;
-    constructor(server: Server, options: WebSocketServerTransportOptions);
+    constructor(server: RequestHandler, options: WebSocketServerTransportOptions);
+    /**
+     * One beat of the heartbeat: a connection that missed too many pongs closes at once (its close
+     * event aborts its requests), and each other connection gets a ping.
+     */
+    private beat;
     start(): Promise<void>;
     stop(): Promise<void>;
     isRunning(): boolean;
@@ -31,32 +71,20 @@ export declare class WebSocketServerTransport implements ServerTransport {
      */
     private handleConnection;
     /**
-     * Reject the server-to-client requests that wait for a connection that went away,
-     * instead of letting them wait for their timeout (BUGS-2026-07 L29).
+     * The server request of a `request` frame of a connection: the metadata of the frame and of the
+     * connection, the signal of the call, and the credentials of the upgrade (roadmap R18).
      */
-    private abortInflightFor;
-    private rejectPendingFor;
+    private requestOf;
     /**
-     * Handle WebSocket message.
+     * Handle WebSocket message: a heartbeat, a frame of a call that the server sent (a response,
+     * an error, a stream), or a frame of a call of the client (a request, a cancel, a credit).
      */
     private handleMessage;
-    /**
-     * Send a stream response (BUGS-2026-07 H5): one "stream" frame for each item, then a frame
-     * with `stream.done`. An error of the stream ends it with an "error" frame. When the signal
-     * aborts (a cancel message, a closed connection), the loop stops, and the stream's handler
-     * gets return().
-     *
-     * Flow control (deep dive TRN-3): the stream takes its next item only when the client has
-     * credit for it (when the request carried credit), and waits while the connection's send
-     * buffer holds more than `highWaterMark` bytes.
-     */
-    private sendStream;
     /**
      * Send a frame. When the connection's send buffer is past the high-water mark, wait until
      * the socket has written this frame, or the signal aborts.
      */
     private sendWithBackpressure;
-    private sendResponse;
     /**
      * Send error to client.
      */
@@ -86,11 +114,24 @@ export declare class WebSocketServerTransport implements ServerTransport {
      */
     sendToConnection(connectionId: string, message: WebSocketMessage): void;
     /**
-     * Call a procedure on a specific client (server-to-client RPC).
-     * Returns a promise that resolves with the client's response.
+     * Send a call to a client (roadmap R24): the same frames as the calls of the client, with
+     * streaming, credit, cancel, the signal and the remaining time of the call. The client serves it
+     * with its own handler (the `serve` option of `WebSocketTransport`). An unknown connection gives a
+     * `CONNECTION_NOT_FOUND` error item.
+     */
+    callConnection<TReq, TRes>(connectionId: string, message: Message<TReq>): AsyncIterable<ResponseItem<TRes>>;
+    /**
+     * A transport to one client: a `Client` over it calls the procedures that the client serves,
+     * with each client middleware (retry, timeouts) of the caller (roadmap R24).
+     */
+    transportFor(connectionId: string): Transport;
+    /**
+     * Call a procedure on a specific client (server-to-client RPC). It gives the value of the
+     * call, and fails with its error. It is a wrapper of `callConnection` (roadmap R24).
      */
     callClient(connectionId: string, path: string[], input: unknown, timeout?: number): Promise<unknown>;
     /**
+     * Register a handler for new connections.  /**
      * Register a handler for new connections.
      * Returns a function to unregister the handler.
      */

package/dist/adapters/websocket/server/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/websocket/server/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,0BAA0B,CAAC;AAC/F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EACV,+BAA+B,EAC/B,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAsFpB,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAKb;IACF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAA6B;IAGhD,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,iBAAiB,CAAK;IAI9B,OAAO,CAAC,QAAQ,CAAsC;IAGtD,OAAO,CAAC,OAAO,CAAmC;IAElD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAG5C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,kBAAkB,CAAgC;IAE1D,YAAY,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,+BAA+B,EAanE;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAuC3B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B1B;IAED,SAAS,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoExB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;YACW,aAAa;IA0H3B;;;;;;;;;OASG;YACW,UAAU;IAuCxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAoBjB;;OAEG;IACH,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAIzC;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAE3B;IAMD;;OAEG;IACH,qBAAqB,IAAI,iBAAiB,EAAE,CAE3C;IAED;;OAEG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAExE;IAED;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAKtE;IAED;;;OAGG;IACH,UAAU,CACR,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,OAAO,EACd,OAAO,SAAQ,GACd,OAAO,CAAC,OAAO,CAAC,CA+BlB;IAED;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAQrD;IAED;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAQxD;IAED;;OAEG;IACH,wBAAwB,CACtB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAKN;IAED;;OAEG;IACH,uBAAuB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAKxE;CACF"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/websocket/server/transport.ts"],"names":[],"mappings":"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"}