@procedures/client 0.2.3 → 0.3.0

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

@@ -7,6 +7,7 @@ import type { IncomingMessage } from "http";
 import type { Server as HttpServer } from "http";
 import type { WebSocket } from "ws";
 import type { BrowserGuardOptions } from "../../../server/browser-guard.js";
+import type { Duration } from "../../../duration.js";
 /**
  * WebSocket authentication handler.
  * Called during WebSocket upgrade to authenticate the connection.
@@ -62,6 +63,22 @@ export interface WebSocketServerTransportOptions extends Omit<BrowserGuardOption
      * @default 1 MiB
      */
     highWaterMark?: number;
+    /**
+     * The heartbeat of the server: a WebSocket ping to each connection at each interval. A
+     * connection that misses `misses` pongs one after the other is closed, so the server finds a
+     * client that went silent (roadmap R3: before, only the client sent pings). Browsers and the
+     * `ws` client answer a ping without code. `false` turns it off.
+     * @default { interval: seconds(15), misses: 2 } (`TIMER_DEFAULTS.webSocketServer`)
+     */
+    heartbeat?: {
+        interval?: Duration;
+        misses?: number;
+    } | false;
+    /**
+     * The time until the first frame of a call that the server sends to a client (roadmap R24).
+     * @default seconds(30)
+     */
+    reverseRequestTimeout?: Duration;
 }
 /**
  * WebSocket message format for RPC.
@@ -70,7 +87,9 @@ export interface WebSocketMessage<TReq = 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/server/types.d.ts.map

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

package/dist/adapters/websocket/shared/rpc.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The calls over one WebSocket in the two directions (roadmap R24).
+ *
+ * A WebSocket connection carries the calls of each side to the other side, with the same frames:
+ * a `request`, then a `response`, an `error`, or `stream` frames that end with `stream.done`. The
+ * reader of a stream gives `credit`, and the caller can `cancel`. `OutgoingCalls` is the side that
+ * sends calls. `IncomingCalls` is the side that serves them with a `RequestHandler`, so a call runs
+ * through `invokeProcedure` (validation, the expose rule, the capability, the deadline of
+ * `procedure-timeout`). The server serves the calls of the client, and the client can serve the
+ * calls of the server: before, the reverse calls had frames of their own (`server-request`,
+ * `server-response`), with one value, no stream, no cancel and no signal.
+ */
+import type { Message, ResponseItem } from "../../../client/types.js";
+import type { RequestHandler, ServerRequest } from "../../../server/types.js";
+import type { WebSocketMessage } from "../server/types.js";
+/**
+ * A queue of response items that one reader takes in order: push, then end or fail. The reader
+ * waits for the next item without polling.
+ */
+export declare class ItemQueue<T> {
+    private items;
+    private ended;
+    private failure;
+    private wake;
+    push(item: T): void;
+    end(): void;
+    fail(error: Error): void;
+    private notify;
+    [Symbol.asyncIterator](): AsyncGenerator<T, void, undefined>;
+}
+/**
+ * The credit of a stream (deep dive TRN-3): the number of items that the reader has room for.
+ * The stream takes one for each item that it sends, and waits when it has none.
+ */
+export declare class StreamCredit {
+    private credit;
+    private wake;
+    constructor(credit: number);
+    grant(n: number): void;
+    /** Take one item of credit. Returns false when the signal aborted the wait. */
+    take(signal: AbortSignal): Promise<boolean>;
+}
+/** The error of a failed stream or handler: its code (a string) and its retryable flag. */
+export declare function errorStatus(error: unknown): {
+    type: "error";
+    code: string;
+    message: string;
+    retryable: boolean;
+};
+/** The response item of a `response` or an `error` frame, for the caller's message id. */
+export declare function itemOfFrame(frame: WebSocketMessage, messageId: string): ResponseItem<unknown>;
+/** The options of `OutgoingCalls`. */
+export interface OutgoingCallsOptions {
+    /** This function sends a frame on the socket. */
+    send: (frame: WebSocketMessage) => void;
+    /** True while the socket is open. */
+    isOpen: () => boolean;
+    /** The time until the first frame of a call, in milliseconds. 0 or less: no limit. */
+    requestTimeoutMs: number;
+    /** The number of stream items that the reader can hold. */
+    streamWindow: number;
+    /** The start of the wire id of each call: the two sides use different ones. */
+    idPrefix: string;
+}
+/** The calls that this side sends on one socket. */
+export declare class OutgoingCalls {
+    private readonly options;
+    private readonly pending;
+    private seq;
+    constructor(options: OutgoingCallsOptions);
+    /** The number of calls that wait for their frames. */
+    get size(): number;
+    /** This function sends a call, and gives its response items. */
+    call<TReq, TRes>(message: Message<TReq>): AsyncGenerator<ResponseItem<TRes>, void, undefined>;
+    /**
+     * This function takes a `response`, `error` or `stream` frame of a call that this side sent.
+     * It gives false for another frame.
+     */
+    receive(frame: WebSocketMessage): boolean;
+    /**
+     * This function fails each call that waits: the socket closed. The other side can have run
+     * them, so their outcome is indeterminate (R1).
+     */
+    failAll(reason: string): void;
+    private sendCancel;
+    private sendCredit;
+}
+/** The options of `IncomingCalls`. */
+export interface IncomingCallsOptions {
+    /** The handler that serves each call: a `ProcedureServer`, a `Server`, or a function object. */
+    handler: RequestHandler;
+    /** This function sends a frame on the socket. */
+    send: (frame: WebSocketMessage) => void;
+    /** This function sends a frame and waits while the send buffer of the socket is full. */
+    sendWithBackpressure?: ((frame: WebSocketMessage, signal: AbortSignal) => Promise<void>) | undefined;
+    /** True while the socket is open. */
+    isOpen: () => boolean;
+    /** This function makes the server request of a `request` frame: the metadata, the credentials. */
+    requestOf: (frame: WebSocketMessage, signal: AbortSignal) => ServerRequest;
+}
+/** The calls that the other side sends on one socket, served by a handler. */
+export declare class IncomingCalls {
+    private readonly options;
+    /** The calls that run, by wire id: a cancel frame or a closed socket aborts them */
+    private readonly inflight;
+    /** The flow control of the streams that run, by wire id */
+    private readonly credits;
+    constructor(options: IncomingCallsOptions);
+    /** The number of calls that run. */
+    get size(): number;
+    /**
+     * This function takes a `request`, `cancel` or `credit` frame of the other side. It gives false
+     * for another frame.
+     */
+    receive(frame: WebSocketMessage): boolean;
+    /** This function aborts each call that runs: the socket closed, or the side stops. */
+    abortAll(): void;
+    private serve;
+    /**
+     * Send a stream (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 frame, a closed socket), the loop stops, and the handler of the stream gets
+     * return(). The stream takes its next item only when the reader has credit for it.
+     */
+    private sendStream;
+    private send;
+    private sendError;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/adapters/websocket/shared/rpc.d.ts.map

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

package/dist/adapters/websocket/shared/rpc.js

@@ -0,0 +1,425 @@
+/**
+ * The calls over one WebSocket in the two directions (roadmap R24).
+ *
+ * A WebSocket connection carries the calls of each side to the other side, with the same frames:
+ * a `request`, then a `response`, an `error`, or `stream` frames that end with `stream.done`. The
+ * reader of a stream gives `credit`, and the caller can `cancel`. `OutgoingCalls` is the side that
+ * sends calls. `IncomingCalls` is the side that serves them with a `RequestHandler`, so a call runs
+ * through `invokeProcedure` (validation, the expose rule, the capability, the deadline of
+ * `procedure-timeout`). The server serves the calls of the client, and the client can serve the
+ * calls of the server: before, the reverse calls had frames of their own (`server-request`,
+ * `server-response`), with one value, no stream, no cancel and no signal.
+ */
+import { withoutInternalKeys } from "../../metadata.js";
+import { DELIVERY_METADATA_KEY } from "../../../client/middleware/items.js";
+/**
+ * A queue of response items that one reader takes in order: push, then end or fail. The reader
+ * waits for the next item without polling.
+ */
+export class ItemQueue {
+    items = [];
+    ended = false;
+    failure;
+    wake;
+    push(item) {
+        this.items.push(item);
+        this.notify();
+    }
+    end() {
+        this.ended = true;
+        this.notify();
+    }
+    fail(error) {
+        this.failure = { error };
+        this.notify();
+    }
+    notify() {
+        const wake = this.wake;
+        this.wake = undefined;
+        wake?.();
+    }
+    async *[Symbol.asyncIterator]() {
+        for (;;) {
+            if (this.items.length > 0) {
+                yield this.items.shift();
+                continue;
+            }
+            if (this.failure)
+                throw this.failure.error;
+            if (this.ended)
+                return;
+            await new Promise((resolve) => {
+                this.wake = resolve;
+            });
+        }
+    }
+}
+/**
+ * The credit of a stream (deep dive TRN-3): the number of items that the reader has room for.
+ * The stream takes one for each item that it sends, and waits when it has none.
+ */
+export class StreamCredit {
+    credit;
+    wake;
+    constructor(credit) {
+        this.credit = credit;
+    }
+    grant(n) {
+        this.credit += n;
+        const wake = this.wake;
+        this.wake = undefined;
+        wake?.();
+    }
+    /** Take one item of credit. Returns false when the signal aborted the wait. */
+    async take(signal) {
+        while (this.credit <= 0) {
+            if (signal.aborted)
+                return false;
+            await new Promise((resolve) => {
+                const onAbort = () => resolve();
+                signal.addEventListener("abort", onAbort, { once: true });
+                this.wake = () => {
+                    signal.removeEventListener("abort", onAbort);
+                    resolve();
+                };
+            });
+        }
+        if (signal.aborted)
+            return false;
+        this.credit--;
+        return true;
+    }
+}
+/** The error of a failed stream or handler: its code (a string) and its retryable flag. */
+export function errorStatus(error) {
+    const code = error?.code;
+    const retryable = error?.retryable;
+    return {
+        type: "error",
+        code: typeof code === "string" ? code : "HANDLER_ERROR",
+        message: error instanceof Error ? error.message : String(error),
+        // Before, every stream error lost its retryable flag (deep dive TRN-7)
+        retryable: typeof retryable === "boolean" ? retryable : false,
+    };
+}
+/** A text of an error message of a frame: a string, or the JSON of another value. */
+function textOf(value) {
+    if (typeof value === "string")
+        return value;
+    return value === undefined ? "Unknown error" : JSON.stringify(value);
+}
+/** The response item of a `response` or an `error` frame, for the caller's message id. */
+export function itemOfFrame(frame, messageId) {
+    let status;
+    if (frame.status && frame.status.type === "error") {
+        status = { type: "error", code: String(frame.status.code), message: textOf(frame.status.message), retryable: frame.status.retryable || false };
+    }
+    else if (frame.status && frame.status.type === "success") {
+        status = { type: "success", code: Number(frame.status.code) };
+    }
+    else if (frame.type === "error") {
+        status = {
+            type: "error",
+            code: String(frame.error?.code || "UNKNOWN_ERROR"),
+            message: textOf(frame.error?.message),
+            retryable: frame.error?.retryable || false,
+        };
+    }
+    else {
+        status = { type: "success", code: 200 };
+    }
+    return { id: messageId, status, payload: frame.payload, metadata: frame.metadata || {} };
+}
+/** The calls that this side sends on one socket. */
+export class OutgoingCalls {
+    options;
+    pending = new Map();
+    seq = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    /** The number of calls that wait for their frames. */
+    get size() {
+        return this.pending.size;
+    }
+    /** This function sends a call, and gives its response items. */
+    async *call(message) {
+        if (message.signal?.aborted) {
+            yield abortedItem(message.id);
+            return;
+        }
+        if (!this.options.isOpen()) {
+            // The call did not leave: a retry can send it
+            yield {
+                id: message.id,
+                status: { type: "error", code: "CONNECTION_CLOSED", message: "The connection is closed", retryable: true },
+                payload: null,
+                metadata: { [DELIVERY_METADATA_KEY]: "not-sent" },
+            };
+            return;
+        }
+        const wireId = `${this.options.idPrefix}${message.id}~${++this.seq}`;
+        const window = this.options.streamWindow;
+        const queue = new ItemQueue();
+        const pending = { messageId: message.id, queue };
+        const limited = Number.isFinite(this.options.requestTimeoutMs) && this.options.requestTimeoutMs > 0;
+        if (limited)
+            pending.timeout = setTimeout(() => {
+                if (this.pending.get(wireId) !== pending)
+                    return;
+                this.pending.delete(wireId);
+                this.sendCancel(wireId);
+                queue.push({
+                    id: message.id,
+                    status: { type: "error", code: "TIMEOUT", message: `Request timeout after ${this.options.requestTimeoutMs}ms`, retryable: false },
+                    payload: null,
+                    metadata: { [DELIVERY_METADATA_KEY]: "indeterminate" },
+                });
+                queue.end();
+            }, this.options.requestTimeoutMs);
+        this.pending.set(wireId, pending);
+        const onAbort = () => {
+            if (this.pending.get(wireId) !== pending)
+                return;
+            this.pending.delete(wireId);
+            if (pending.timeout)
+                clearTimeout(pending.timeout);
+            this.sendCancel(wireId);
+            queue.push(abortedItem(message.id));
+            queue.end();
+        };
+        message.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            this.options.send({
+                id: wireId,
+                type: "request",
+                method: message.method,
+                payload: message.payload,
+                // The internal metadata keys stay in this process (deep dive TRN-11)
+                metadata: withoutInternalKeys(message.metadata),
+                credit: window,
+            });
+            let taken = 0;
+            for await (const item of queue) {
+                yield item;
+                // The reader took the item: give the other side credit, in batches of half the window
+                if (++taken >= window / 2 && this.pending.get(wireId) === pending) {
+                    this.sendCredit(wireId, taken);
+                    taken = 0;
+                }
+            }
+        }
+        finally {
+            message.signal?.removeEventListener("abort", onAbort);
+            if (pending.timeout)
+                clearTimeout(pending.timeout);
+            if (this.pending.get(wireId) === pending) {
+                // The reader stopped before the end: the other side stops the stream
+                this.pending.delete(wireId);
+                this.sendCancel(wireId);
+            }
+        }
+    }
+    /**
+     * This function takes a `response`, `error` or `stream` frame of a call that this side sent.
+     * It gives false for another frame.
+     */
+    receive(frame) {
+        if (frame.type !== "response" && frame.type !== "error" && frame.type !== "stream")
+            return false;
+        const pending = this.pending.get(frame.id);
+        if (!pending)
+            return false;
+        // The first frame arrived: the time limit ends. A stream can stay open longer.
+        if (pending.timeout) {
+            clearTimeout(pending.timeout);
+            pending.timeout = undefined;
+        }
+        if (frame.type === "stream" && !frame.status) {
+            if (frame.stream?.done) {
+                this.pending.delete(frame.id);
+                pending.queue.end();
+                return true;
+            }
+            pending.queue.push({ id: pending.messageId, status: { type: "success", code: 200 }, payload: frame.payload, metadata: frame.metadata || {} });
+            return true;
+        }
+        this.pending.delete(frame.id);
+        pending.queue.push(itemOfFrame(frame, pending.messageId));
+        pending.queue.end();
+        return true;
+    }
+    /**
+     * This function fails each call that waits: the socket closed. The other side can have run
+     * them, so their outcome is indeterminate (R1).
+     */
+    failAll(reason) {
+        for (const pending of this.pending.values()) {
+            if (pending.timeout)
+                clearTimeout(pending.timeout);
+            pending.queue.fail(new Error(reason));
+        }
+        this.pending.clear();
+    }
+    sendCancel(id) {
+        if (this.options.isOpen())
+            this.options.send({ id, type: "cancel" });
+    }
+    sendCredit(id, credit) {
+        if (this.options.isOpen())
+            this.options.send({ id, type: "credit", credit });
+    }
+}
+/** The calls that the other side sends on one socket, served by a handler. */
+export class IncomingCalls {
+    options;
+    /** The calls that run, by wire id: a cancel frame or a closed socket aborts them */
+    inflight = new Map();
+    /** The flow control of the streams that run, by wire id */
+    credits = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    /** The number of calls that run. */
+    get size() {
+        return this.inflight.size;
+    }
+    /**
+     * This function takes a `request`, `cancel` or `credit` frame of the other side. It gives false
+     * for another frame.
+     */
+    receive(frame) {
+        if (frame.type === "cancel") {
+            this.inflight.get(frame.id)?.abort();
+            this.inflight.delete(frame.id);
+            return true;
+        }
+        if (frame.type === "credit") {
+            if (typeof frame.credit === "number" && frame.credit > 0)
+                this.credits.get(frame.id)?.grant(frame.credit);
+            return true;
+        }
+        if (frame.type !== "request")
+            return false;
+        if (!frame.id || !frame.method) {
+            this.sendError(frame.id || "unknown", "Invalid message format", "INVALID_REQUEST");
+            return true;
+        }
+        // A request id names one request while it runs. A second request with the id would take the
+        // first one's controller: its stream could not be cancelled (deep dive TRN-9).
+        if (this.inflight.has(frame.id)) {
+            this.sendError(frame.id, "A request with this id is still running", "DUPLICATE_REQUEST");
+            return true;
+        }
+        void this.serve(frame);
+        return true;
+    }
+    /** This function aborts each call that runs: the socket closed, or the side stops. */
+    abortAll() {
+        for (const controller of this.inflight.values())
+            controller.abort();
+        this.inflight.clear();
+        this.credits.clear();
+    }
+    async serve(frame) {
+        const controller = new AbortController();
+        this.inflight.set(frame.id, controller);
+        try {
+            const response = await this.options.handler.handle(this.options.requestOf(frame, controller.signal));
+            if (response.stream) {
+                const credit = typeof frame.credit === "number" && frame.credit > 0 ? new StreamCredit(frame.credit) : undefined;
+                if (credit)
+                    this.credits.set(frame.id, credit);
+                await this.sendStream(frame.id, response.stream, controller.signal, credit);
+            }
+            else {
+                const out = {
+                    id: frame.id,
+                    type: response.status.type === "success" ? "response" : "error",
+                    payload: response.payload,
+                    metadata: response.metadata,
+                    status: response.status,
+                };
+                if (response.status.type === "error") {
+                    out.error = { code: response.status.code, message: response.status.message || "Unknown error", retryable: response.status.retryable };
+                }
+                this.send(out);
+            }
+        }
+        catch (error) {
+            this.sendError(frame.id, error instanceof Error ? error.message : "Internal server error", "INTERNAL_ERROR");
+        }
+        finally {
+            // Delete only this request's entries (deep dive TRN-9)
+            if (this.inflight.get(frame.id) === controller)
+                this.inflight.delete(frame.id);
+            this.credits.delete(frame.id);
+        }
+    }
+    /**
+     * Send a stream (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 frame, a closed socket), the loop stops, and the handler of the stream gets
+     * return(). The stream takes its next item only when the reader has credit for it.
+     */
+    async sendStream(id, stream, signal, credit) {
+        const iterator = stream[Symbol.asyncIterator]();
+        let done = false;
+        try {
+            for (;;) {
+                if (credit && !(await credit.take(signal)))
+                    return;
+                if (signal.aborted || !this.options.isOpen())
+                    return;
+                const result = await iterator.next();
+                if (result.done) {
+                    done = true;
+                    break;
+                }
+                if (signal.aborted || !this.options.isOpen())
+                    return;
+                const item = { id, type: "stream", payload: result.value, stream: { done: false } };
+                if (this.options.sendWithBackpressure)
+                    await this.options.sendWithBackpressure(item, signal);
+                else
+                    this.send(item);
+            }
+            this.send({ id, type: "stream", stream: { done: true } });
+        }
+        catch (error) {
+            done = true;
+            if (signal.aborted)
+                return;
+            const status = errorStatus(error);
+            this.send({
+                id,
+                type: "error",
+                status,
+                error: { code: status.code, message: status.message, retryable: status.retryable },
+                stream: { done: true },
+            });
+        }
+        finally {
+            // The loop stopped before the end: the handler gets return()
+            if (!done)
+                await iterator.return?.();
+        }
+    }
+    send(frame) {
+        if (this.options.isOpen())
+            this.options.send(frame);
+    }
+    sendError(id, message, code) {
+        this.send({
+            id,
+            type: "error",
+            status: { type: "error", code, message, retryable: false },
+            error: { code, message, retryable: false },
+        });
+    }
+}
+/** The error item of a call that its caller aborted. A retry does not repeat it. */
+function abortedItem(id) {
+    return { id, status: { type: "error", code: "ABORTED", message: "Request was aborted", retryable: false }, payload: null, metadata: {} };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/adapters/websocket/shared/rpc.js.map

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