@fuzdev/fuz_app 0.28.0 → 0.29.0

package/dist/actions/action_peer.d.ts

@@ -7,28 +7,29 @@
  * @module
  */
 import { JsonrpcMessageFromServerToClient, JsonrpcNotification, JsonrpcRequest, JsonrpcResponseOrError, JsonrpcErrorResponse } from '../http/jsonrpc.js';
-import { Transports, type TransportName } from './transports.js';
+import { Transports, type TransportName, type TransportSendOptions } from './transports.js';
 import type { ActionEventEnvironment } from './action_event_types.js';
-export interface ActionPeerSendOptions {
+/**
+ * Per-call options for `ActionPeer.send`. Extends `TransportSendOptions`
+ * with `transport_name` for per-call transport selection. The peer-wide
+ * default for any field lives on `ActionPeerOptions.default_send_options` —
+ * set `queue: true` there once for client-authoritative peers and override
+ * per-call for exceptions (e.g. high-frequency position sync where stale
+ * replays are wrong).
+ */
+export interface ActionPeerSendOptions extends TransportSendOptions {
     transport_name?: TransportName;
-    /**
-     * Per-call `AbortSignal`. Forwarded into the chosen transport's `send`,
-     * which bottoms out at `FrontendWebsocketClient.request({signal})` for WS
-     * (sends the shared `cancel` notification on abort) and at
-     * `fetch({signal})` for HTTP. Backend transport ignores it.
-     */
-    signal?: AbortSignal;
 }
 export interface ActionPeerOptions {
     environment: ActionEventEnvironment;
     transports?: Transports;
-    default_send_options?: Partial<ActionPeerSendOptions>;
+    default_send_options?: Omit<ActionPeerSendOptions, 'signal'>;
 }
 export declare class ActionPeer {
     #private;
     readonly environment: ActionEventEnvironment;
     readonly transports: Transports;
-    default_send_options: ActionPeerSendOptions;
+    default_send_options: Omit<ActionPeerSendOptions, 'signal'>;
     constructor(options: ActionPeerOptions);
     send(message: JsonrpcRequest, options?: ActionPeerSendOptions): Promise<JsonrpcResponseOrError>;
     send(message: JsonrpcNotification, options?: ActionPeerSendOptions): Promise<JsonrpcErrorResponse | null>;

package/dist/actions/action_peer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action_peer.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/action_peer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEN,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAAC,UAAU,EAAE,KAAK,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,yBAAyB,CAAC;AAOpE,MAAM,WAAW,qBAAqB;IACrC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,sBAAsB,CAAC;IAGpC,UAAU,CAAC,EAAE,UAAU,CAAC;IAGxB,oBAAoB,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACtD;AAED,qBAAa,UAAU;;IACtB,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAMhC,oBAAoB,EAAE,qBAAqB,CAAC;gBAEhC,OAAO,EAAE,iBAAiB;IAOhC,IAAI,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IAC5B,IAAI,CACT,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA2CjC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;CAyIjF"}
+{"version":3,"file":"action_peer.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/action_peer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEN,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAAC,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,yBAAyB,CAAC;AAOpE;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IAClE,cAAc,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,sBAAsB,CAAC;IAGpC,UAAU,CAAC,EAAE,UAAU,CAAC;IAKxB,oBAAoB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;CAC7D;AAED,qBAAa,UAAU;;IACtB,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAMhC,oBAAoB,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;gBAEhD,OAAO,EAAE,iBAAiB;IAOhC,IAAI,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC;IAC5B,IAAI,CACT,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA8CjC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC;CAyIjF"}

package/dist/actions/action_peer.js

@@ -33,7 +33,10 @@ export class ActionPeer {
             }
             const message_type = is_jsonrpc_request(message) ? 'request' : 'notification';
             this.environment.log?.debug(`[peer] send ${message_type}:`, message.method, `via ${transport.transport_name}`);
-            const result = await transport.send(message, { signal: options?.signal });
+            const result = await transport.send(message, {
+                signal: options?.signal,
+                queue: options?.queue ?? this.default_send_options.queue,
+            });
             if (result && 'error' in result) {
                 this.environment.log?.error(`[peer] send ${message_type} failed:`, message.method, result.error.message);
             }

package/dist/actions/rpc_client.d.ts

@@ -10,7 +10,7 @@
  * @module
  */
 import type { ActionEventEnvironment } from './action_event_types.js';
-import type { ActionPeer } from './action_peer.js';
+import type { ActionPeer, ActionPeerSendOptions } from './action_peer.js';
 import type { ActionEventDataUnion } from './action_event_data.js';
 import type { TransportName } from './transports.js';
 /**
@@ -58,13 +58,11 @@ export interface CreateRpcClientOptions {
  */
 export declare const create_rpc_client: (options: CreateRpcClientOptions) => Record<string, (...args: Array<any>) => any>;
 /**
- * Per-call options accepted by every typed Proxy method. `signal` lets the
- * caller cancel an in-flight request (sends the shared `cancel` notification
- * on the WS path, aborts `fetch` on HTTP). `transport_name` overrides the
- * per-method `transport_for_method` selector for this call.
+ * Per-call options accepted by every typed Proxy method. Same shape as
+ * `ActionPeerSendOptions` — the client threads these through unchanged
+ * to the underlying peer. `transport_name` overrides the per-method
+ * `transport_for_method` selector for this call.
  */
-export interface RpcClientCallOptions {
-    signal?: AbortSignal;
-    transport_name?: TransportName;
+export interface RpcClientCallOptions extends ActionPeerSendOptions {
 }
 //# sourceMappingURL=rpc_client.d.ts.map

package/dist/actions/rpc_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc_client.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/rpc_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,yBAAyB,CAAC;AAOpE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGnD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;AAM/E,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,oBAAoB,CAAA;KAAC,KAC5E;QACA,sBAAsB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;KAC5C,GACD,SAAS,CAAC;CACb;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,sBAAsB,CAAC;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,sBAAsB,KAC7B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAgB7C,CAAC;AA2DF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,CAAC;CAC/B"}
+{"version":3,"file":"rpc_client.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/rpc_client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,yBAAyB,CAAC;AAOpE,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAGnD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;AAM/E,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACtC,aAAa,EAAE,CAAC,IAAI,EAAE;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,oBAAoB,CAAA;KAAC,KAC5E;QACA,sBAAsB,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;KAC5C,GACD,SAAS,CAAC;CACb;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,sBAAsB,CAAC;IACpC,kEAAkE;IAClE,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,sBAAsB,KAC7B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAgB7C,CAAC;AA2DF;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;CAAG"}

package/dist/actions/rpc_client.js

@@ -127,6 +127,7 @@ const create_request_response_method = (peer, environment, spec, actions, transp
         const response = await peer.send(event.data.request, {
             transport_name: options?.transport_name ?? transport_for_method?.(spec.method),
             signal: options?.signal,
+            queue: options?.queue,
         });
         event.transition('receive_response');
         // TODO @api shouldn't this happen in the peer like the other method calls?
@@ -155,6 +156,7 @@ const create_remote_notification_method = (peer, environment, spec, actions, tra
             const send_result = await peer.send(event.data.notification, {
                 transport_name: options?.transport_name ?? transport_for_method?.(spec.method),
                 signal: options?.signal,
+                queue: options?.queue,
             });
             // Check if notification failed to send
             if (send_result !== null) {

package/dist/actions/socket.svelte.d.ts

@@ -218,8 +218,7 @@ export declare class FrontendWebsocketClient implements WebsocketConnection, Dis
      * id (or uses an explicit one supplied via `options.id` — used by
      * `FrontendWebsocketTransport` which delegates to this method and has its
      * own peer-minted UUID), tracks the pending promise, and resolves when the
-     * server sends a matching response (or rejects on error frame, socket
-     * close, or aborted signal).
+     * server sends a matching response.
      *
      * Callers supplying an explicit `options.id` are responsible for
      * uniqueness — the pending map is keyed by id, and a duplicate silently
@@ -234,10 +233,22 @@ export declare class FrontendWebsocketClient implements WebsocketConnection, Dis
      * disconnect-detection slot.
      *
      * On `AbortSignal` fire: rejects the local promise *and* sends the shared
-     * `cancel` notification (`CANCEL_METHOD`) so the server-side dispatcher
-     * can abort the matching handler's `ctx.signal`. Suppressed for
-     * queued-but-never-sent (server doesn't know about it) and
+     * `cancel` notification ({@link CANCEL_METHOD}) so the server-side
+     * dispatcher can abort the matching handler's `ctx.signal`. Suppressed
+     * for queued-but-never-sent (server doesn't know about it) and
      * response-beat-cancel races.
+     *
+     * Rejections throw `ThrownJsonrpcError` with a specific code so
+     * `FrontendWebsocketTransport` can preserve the code verbatim in its
+     * error envelope rather than collapsing every rejection to
+     * `internal_error`:
+     * - `unauthenticated` — session revoked (entry check or close code);
+     * - `request_cancelled` — caller's `AbortSignal` fired;
+     * - `queue_overflow` — durable queue full;
+     * - `service_unavailable` — socket not connected / closed / torn down
+     *   mid-flight;
+     * - `internal_error` — `ws.send` threw (serialization, buffer full);
+     * - server's wire code verbatim — JSON-RPC error frame from peer.
      */
     request<R = unknown>(method: string, params?: unknown, options?: {
         signal?: AbortSignal;

package/dist/actions/socket.svelte.d.ts.map

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

package/dist/actions/socket.svelte.js

@@ -25,6 +25,7 @@
  */
 import { BROWSER } from 'esm-env';
 import { JSONRPC_VERSION } from '../http/jsonrpc.js';
+import { JSONRPC_ERROR_CODES, ThrownJsonrpcError, jsonrpc_errors } from '../http/jsonrpc_errors.js';
 import { WS_CLOSE_CLIENT_HEARTBEAT_TIMEOUT, WS_CLOSE_SESSION_REVOKED } from './transports.js';
 import { CANCEL_METHOD } from './cancel.js';
 import { HEARTBEAT_METHOD } from './heartbeat.js';
@@ -273,7 +274,7 @@ export class FrontendWebsocketClient {
         this.#teardown(code);
         this.status = 'closed';
         this.#reset_reconnect_counters();
-        this.#reject_all('client disconnected');
+        this.#reject_all('client disconnected', jsonrpc_errors.service_unavailable);
     }
     /** Explicit-resource-management hook — supports `using client = new FrontendWebsocketClient(url)`. */
     [Symbol.dispose]() {
@@ -299,8 +300,7 @@ export class FrontendWebsocketClient {
      * id (or uses an explicit one supplied via `options.id` — used by
      * `FrontendWebsocketTransport` which delegates to this method and has its
      * own peer-minted UUID), tracks the pending promise, and resolves when the
-     * server sends a matching response (or rejects on error frame, socket
-     * close, or aborted signal).
+     * server sends a matching response.
      *
      * Callers supplying an explicit `options.id` are responsible for
      * uniqueness — the pending map is keyed by id, and a duplicate silently
@@ -315,17 +315,29 @@ export class FrontendWebsocketClient {
      * disconnect-detection slot.
      *
      * On `AbortSignal` fire: rejects the local promise *and* sends the shared
-     * `cancel` notification (`CANCEL_METHOD`) so the server-side dispatcher
-     * can abort the matching handler's `ctx.signal`. Suppressed for
-     * queued-but-never-sent (server doesn't know about it) and
+     * `cancel` notification ({@link CANCEL_METHOD}) so the server-side
+     * dispatcher can abort the matching handler's `ctx.signal`. Suppressed
+     * for queued-but-never-sent (server doesn't know about it) and
      * response-beat-cancel races.
+     *
+     * Rejections throw `ThrownJsonrpcError` with a specific code so
+     * `FrontendWebsocketTransport` can preserve the code verbatim in its
+     * error envelope rather than collapsing every rejection to
+     * `internal_error`:
+     * - `unauthenticated` — session revoked (entry check or close code);
+     * - `request_cancelled` — caller's `AbortSignal` fired;
+     * - `queue_overflow` — durable queue full;
+     * - `service_unavailable` — socket not connected / closed / torn down
+     *   mid-flight;
+     * - `internal_error` — `ws.send` threw (serialization, buffer full);
+     * - server's wire code verbatim — JSON-RPC error frame from peer.
      */
     request(method, params = {}, options = {}) {
         return new Promise((resolve, reject) => {
             const resolve_typed = resolve;
             const reject_typed = reject;
             if (this.#revoked) {
-                reject_typed(new Error('[socket] session revoked'));
+                reject_typed(jsonrpc_errors.unauthenticated('[socket] session revoked'));
                 return;
             }
             const { signal = null } = options;
@@ -378,7 +390,7 @@ export class FrontendWebsocketClient {
                     return;
                 }
                 this.#detach_signal(pending);
-                reject_typed(new Error(`[socket] send failed for ${method}`));
+                reject_typed(jsonrpc_errors.internal_error(`[socket] send failed for ${method}`));
                 return;
             }
             if (should_queue) {
@@ -386,7 +398,7 @@ export class FrontendWebsocketClient {
                 return;
             }
             this.#detach_signal(pending);
-            reject_typed(new Error(`[socket] not connected (method=${method})`));
+            reject_typed(jsonrpc_errors.service_unavailable(`[socket] not connected (method=${method})`));
         });
     }
     add_message_handler(handler) {
@@ -398,7 +410,7 @@ export class FrontendWebsocketClient {
         return () => this.#error_handlers.delete(handler);
     }
     #build_abort_error(method) {
-        return new Error(`[socket] request aborted (method=${method})`);
+        return jsonrpc_errors.request_cancelled(`[socket] request aborted (method=${method})`);
     }
     /**
      * Fire-and-forget cancel notification to the server. The dispatcher
@@ -421,7 +433,7 @@ export class FrontendWebsocketClient {
     #enqueue(queued) {
         if (this.#queue.length >= this.#queue_max_size) {
             this.#detach_signal(queued);
-            queued.reject(new Error(`[socket] request queue overflow (method=${queued.method}, max=${this.#queue_max_size})`));
+            queued.reject(jsonrpc_errors.queue_overflow(`[socket] request queue overflow (method=${queued.method}, max=${this.#queue_max_size})`));
             return;
         }
         this.#queue.push(queued);
@@ -454,25 +466,25 @@ export class FrontendWebsocketClient {
             }
             else {
                 this.#detach_signal(q);
-                q.reject(new Error(`[socket] queued request send failed (method=${q.method})`));
+                q.reject(jsonrpc_errors.internal_error(`[socket] queued request send failed (method=${q.method})`));
             }
         }
     }
-    #reject_all(reason) {
+    #reject_all(reason, make_error) {
         const pending = this.#pending;
         this.#pending = new Map();
         for (const [id, p] of pending) {
             this.#detach_signal(p);
-            p.reject(new Error(`[socket] ${reason} (method=${p.method}, id=${id})`));
+            p.reject(make_error(`[socket] ${reason} (method=${p.method}, id=${id})`));
         }
         const queued = this.#queue;
         this.#queue = [];
         for (const q of queued) {
             this.#detach_signal(q);
-            q.reject(new Error(`[socket] ${reason} (method=${q.method})`));
+            q.reject(make_error(`[socket] ${reason} (method=${q.method})`));
         }
     }
-    #reject_pending_only(reason) {
+    #reject_pending_only(reason, make_error) {
         // Socket closed but auto-reconnect will try again — pending requests were
         // in flight on the old socket so we can't correlate them after reopen;
         // queued requests haven't been sent yet and stay buffered for the flush.
@@ -480,7 +492,7 @@ export class FrontendWebsocketClient {
         this.#pending = new Map();
         for (const [id, p] of pending) {
             this.#detach_signal(p);
-            p.reject(new Error(`[socket] ${reason} (method=${p.method}, id=${id})`));
+            p.reject(make_error(`[socket] ${reason} (method=${p.method}, id=${id})`));
         }
     }
     #start_heartbeat() {
@@ -547,7 +559,7 @@ export class FrontendWebsocketClient {
             // record it here so the client-initiated close is still observable,
             // and reject any pending requests that can never resolve now.
             this.#record_close(close_code, '');
-            this.#reject_pending_only(`socket torn down (code ${close_code})`);
+            this.#reject_pending_only(`socket torn down (code ${close_code})`, jsonrpc_errors.service_unavailable);
         }
         this.ws = null;
     }
@@ -603,12 +615,12 @@ export class FrontendWebsocketClient {
             this.status = 'closed';
             this.#cancel_reconnect();
             this.#reset_reconnect_counters();
-            this.#reject_all('session revoked');
+            this.#reject_all('session revoked', jsonrpc_errors.unauthenticated);
             return;
         }
         // Pending in-flight requests can't be correlated post-reconnect; reject
         // them. Queue stays so the flush on reopen replays unsent work.
-        this.#reject_pending_only(`connection closed (code ${event.code})`);
+        this.#reject_pending_only(`connection closed (code ${event.code})`, jsonrpc_errors.service_unavailable);
         // Let `#schedule_reconnect` set `status: 'reconnecting'` directly to avoid
         // a transient `'closed'` flicker; only set `'closed'` when reconnect is off.
         if (this.#auto_reconnect) {
@@ -616,7 +628,7 @@ export class FrontendWebsocketClient {
         }
         else {
             this.status = 'closed';
-            this.#reject_all('connection closed, auto-reconnect disabled');
+            this.#reject_all('connection closed, auto-reconnect disabled', jsonrpc_errors.service_unavailable);
         }
     };
     #handle_error = (event) => {
@@ -656,7 +668,16 @@ export class FrontendWebsocketClient {
                     this.#detach_signal(pending);
                     if ('error' in json && json.error) {
                         const err = json.error;
-                        pending.reject(new Error(`[rpc ${pending.method} #${id}] ${err.code ?? '?'} ${err.message ?? 'unknown error'}`));
+                        // Preserve the server's wire code verbatim so the transport's
+                        // catch block re-emits the same code in its envelope. Fall
+                        // back to `internal_error` only when the frame is malformed.
+                        const wire_code = typeof err.code === 'number'
+                            ? err.code
+                            : JSONRPC_ERROR_CODES.internal_error;
+                        const wire_message = typeof err.message === 'string' && err.message.length > 0
+                            ? err.message
+                            : 'unknown error';
+                        pending.reject(new ThrownJsonrpcError(wire_code, wire_message, err.data));
                     }
                     else {
                         pending.resolve(json.result);

package/dist/actions/transports.d.ts

@@ -18,14 +18,31 @@ export declare const TransportName: z.ZodString;
 export type TransportName = z.infer<typeof TransportName>;
 /**
  * Per-call options accepted by every transport's `send`. Optional and
- * extensible — adding a field is non-breaking. Today: an `AbortSignal`
- * for cancellation that bottoms out at `FrontendWebsocketClient.request`
- * (which sends the shared `cancel` notification on abort) and at
- * `fetch({signal})` for HTTP. Backend transport receives the option but
- * has no per-call abort surface to honor.
+ * extensible — adding a field is non-breaking. Source of truth for the
+ * shared option shape; `ActionPeerSendOptions` and `RpcClientCallOptions`
+ * extend it.
  */
 export interface TransportSendOptions {
+    /**
+     * Per-call cancellation. Bottoms out at
+     * `FrontendWebsocketClient.request({signal})` on the WS path (sends the
+     * shared `cancel` notification on abort) and at `fetch({signal})` on
+     * HTTP. Backend transport has no per-call abort surface to honor.
+     */
     signal?: AbortSignal;
+    /**
+     * Per-call durable-queue opt-in. Names the **client-authoritative vs
+     * server-authoritative** distinction — server-authoritative consumers
+     * (e.g. zzz completion calls) fail fast with `service_unavailable` when
+     * the transport is down; client-authoritative consumers (games,
+     * real-time apps) buffer and replay on reconnect because the user
+     * already committed to the action at click time. Honored only by
+     * `FrontendWebsocketTransport` on the `request_response` path (default
+     * `false`). HTTP and backend transports ignore it; WS notifications
+     * also ignore it and always fail-fast when disconnected (fire-and-forget
+     * `connection.send` has no queue semantic).
+     */
+    queue?: boolean;
 }
 export interface Transport {
     transport_name: TransportName;

package/dist/actions/transports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transports.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,KAAK,EACX,gCAAgC,EAChC,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,sEAAsE;AACtE,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,yEAAyE;AACzE,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAKtD,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACzB,cAAc,EAAE,aAAa,CAAC;IAE9B,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/F,IAAI,CACH,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACxC,IAAI,CACH,OAAO,EAAE,gCAAgC,EACzC,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,qBAAa,UAAU;;IAItB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAQ;IAE/B;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAS9C,qBAAqB,CAAC,cAAc,EAAE,aAAa,GAAG,IAAI;IAM1D;;;;;OAKG;IACH,aAAa,CAAC,cAAc,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;IAO/D,QAAQ,IAAI,OAAO,GAAG,IAAI;IAM1B,qBAAqB,IAAI,SAAS,GAAG,IAAI;IAIzC,0BAA0B,IAAI,aAAa,GAAG,IAAI;IAIlD,qBAAqB,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;CAqDtE"}
+{"version":3,"file":"transports.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,KAAK,EACX,gCAAgC,EAChC,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,sEAAsE;AACtE,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,yEAAyE;AACzE,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAKtD,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACzB,cAAc,EAAE,aAAa,CAAC;IAE9B,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC/F,IAAI,CACH,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACxC,IAAI,CACH,OAAO,EAAE,gCAAgC,EACzC,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,qBAAa,UAAU;;IAItB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAQ;IAE/B;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAS9C,qBAAqB,CAAC,cAAc,EAAE,aAAa,GAAG,IAAI;IAM1D;;;;;OAKG;IACH,aAAa,CAAC,cAAc,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;IAO/D,QAAQ,IAAI,OAAO,GAAG,IAAI;IAM1B,qBAAqB,IAAI,SAAS,GAAG,IAAI;IAIzC,0BAA0B,IAAI,aAAa,GAAG,IAAI;IAIlD,qBAAqB,CAAC,cAAc,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI;CAqDtE"}

package/dist/actions/transports_ws.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transports_ws.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAGX,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,SAAS,EAAE,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAIrE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC5E,iBAAiB,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACnE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IAClE,OAAO,EAAE,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,gBAAgB,CAAA;KAAC,KACpE,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,qBAAa,0BAA2B,YAAW,SAAS;;IAC3D,QAAQ,CAAC,cAAc,EAAG,wBAAwB,CAAU;gBAOhD,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC;IAyBtF,IAAI,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAC5B,IAAI,CACT,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAoDvC,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,IAAI;CAUf"}
+{"version":3,"file":"transports_ws.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAGX,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAC,SAAS,EAAE,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAIrE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAC5E,iBAAiB,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACnE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IAClE,OAAO,EAAE,CACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,gBAAgB,CAAA;KAAC,KACpE,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,qBAAa,0BAA2B,YAAW,SAAS;;IAC3D,QAAQ,CAAC,cAAc,EAAG,wBAAwB,CAAU;gBAOhD,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC;IAyBtF,IAAI,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAC5B,IAAI,CACT,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA4DvC,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,IAAI;CAUf"}

package/dist/actions/transports_ws.js

@@ -42,11 +42,19 @@ export class FrontendWebsocketTransport {
         });
     }
     async send(message, options) {
-        // Fail-fast at the transport boundary. The connection's own queue
-        // would buffer the request and flush on reconnect; that's the right
-        // default for direct `client.request()` callers but the typed Proxy
-        // path expects "service unavailable" semantics when the WS is down.
-        if (!this.is_ready()) {
+        // Notifications fail-fast when disconnected regardless of `queue` —
+        // `connection.send()` is fire-and-forget with no queue semantic, so
+        // silently dropping would masquerade as success at the rpc_client
+        // layer (caller would see `{ok: true}` for a lost message).
+        //
+        // Requests have no such gate here: `connection.request()` throws
+        // `ThrownJsonrpcError` with the right code (`service_unavailable`
+        // when not connected, `queue_overflow` when the durable queue is
+        // full, `request_cancelled` on abort, server's wire code for peer
+        // error frames), and the catch block below preserves that code
+        // verbatim in the error envelope. Queuing is routed via `queue`.
+        const queue = options?.queue ?? false;
+        if (is_jsonrpc_notification(message) && !this.is_ready()) {
             return create_jsonrpc_error_response(to_jsonrpc_message_id(message), jsonrpc_error_messages.service_unavailable('WebSocket not connected'));
         }
         if (is_jsonrpc_request(message)) {
@@ -54,7 +62,7 @@ export class FrontendWebsocketTransport {
                 const result = await this.#connection.request(message.method, message.params, {
                     id: message.id,
                     signal: options?.signal,
-                    queue: false,
+                    queue,
                 });
                 return create_jsonrpc_response(message.id, to_jsonrpc_result(result));
             }

package/dist/http/jsonrpc_errors.d.ts

@@ -3,7 +3,7 @@
  *
  * Provides error types, named constructors, and HTTP status mapping
  * for the throw/catch error pattern used by `apply_route_specs`.
- * Core error codes (5 standard + 8 general application). Domain-specific
+ * Core error codes (5 standard + 10 general application). Domain-specific
  * codes stay in consumers — add by casting `as JsonrpcErrorCode`.
  *
  * `JsonrpcErrorCode` and `JsonrpcErrorObject` types are Zod-inferred
@@ -20,9 +20,9 @@ import { type JsonrpcErrorCode, type JsonrpcErrorObject } from './jsonrpc.js';
 /** Default message for unknown errors. */
 export declare const UNKNOWN_ERROR_MESSAGE = "unknown error";
 /** Names of standard and general application JSON-RPC error codes. */
-export type JsonrpcErrorName = 'parse_error' | 'invalid_request' | 'method_not_found' | 'invalid_params' | 'internal_error' | 'unauthenticated' | 'forbidden' | 'not_found' | 'conflict' | 'validation_error' | 'rate_limited' | 'service_unavailable' | 'timeout';
+export type JsonrpcErrorName = 'parse_error' | 'invalid_request' | 'method_not_found' | 'invalid_params' | 'internal_error' | 'unauthenticated' | 'forbidden' | 'not_found' | 'conflict' | 'validation_error' | 'rate_limited' | 'service_unavailable' | 'timeout' | 'queue_overflow' | 'request_cancelled';
 /**
- * Standard JSON-RPC error codes (5) plus general application codes (8).
+ * Standard JSON-RPC error codes (5) plus general application codes (10).
  *
  * Extensible — consumers add domain-specific codes to their own objects
  * by casting `as JsonrpcErrorCode`. Application codes use the -32000 to
@@ -55,6 +55,18 @@ export declare const JSONRPC_ERROR_CODES: {
     readonly rate_limited: JsonrpcErrorCode;
     readonly service_unavailable: JsonrpcErrorCode;
     readonly timeout: JsonrpcErrorCode;
+    /**
+     * Client-side backpressure — an outbound buffer (e.g. `FrontendWebsocketClient`'s
+     * disconnected request queue) refused a new request because it was full.
+     * Distinct from `rate_limited`, which signals a server-side policy.
+     */
+    readonly queue_overflow: JsonrpcErrorCode;
+    /**
+     * Caller-initiated cancellation (e.g. `AbortSignal` fired). Cooperative,
+     * not a failure — the request did not complete because the caller asked
+     * for it to stop.
+     */
+    readonly request_cancelled: JsonrpcErrorCode;
 };
 /**
  * Named constructors for `JsonrpcErrorObject` values.
@@ -77,6 +89,8 @@ export declare const jsonrpc_error_messages: {
     readonly rate_limited: (message?: string, data?: unknown) => JsonrpcErrorObject;
     readonly service_unavailable: (message?: string, data?: unknown) => JsonrpcErrorObject;
     readonly timeout: (message?: string, data?: unknown) => JsonrpcErrorObject;
+    readonly queue_overflow: (message?: string, data?: unknown) => JsonrpcErrorObject;
+    readonly request_cancelled: (message?: string, data?: unknown) => JsonrpcErrorObject;
 };
 /**
  * Error class carrying a JSON-RPC error code — thrown by handlers,
@@ -108,6 +122,8 @@ export declare const jsonrpc_errors: {
     readonly rate_limited: (message?: string | undefined, data?: unknown) => ThrownJsonrpcError;
     readonly service_unavailable: (message?: string | undefined, data?: unknown) => ThrownJsonrpcError;
     readonly timeout: (message?: string | undefined, data?: unknown) => ThrownJsonrpcError;
+    readonly queue_overflow: (message?: string | undefined, data?: unknown) => ThrownJsonrpcError;
+    readonly request_cancelled: (message?: string | undefined, data?: unknown) => ThrownJsonrpcError;
 };
 /**
  * Maps JSON-RPC error codes to HTTP status codes.

package/dist/http/jsonrpc_errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc_errors.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/http/jsonrpc_errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAMN,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,MAAM,cAAc,CAAC;AAEtB,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GACzB,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,UAAU,GACV,kBAAkB,GAClB,cAAc,GACd,qBAAqB,GACrB,SAAS,CAAC;AAEb;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;0BAEK,gBAAgB;8BACR,gBAAgB;+BACd,gBAAgB;6BACpB,gBAAgB;6BAChB,gBAAgB;IAG1D;;;;OAIG;8BACwB,gBAAgB;IAC3C;;;OAGG;wBACkB,gBAAgB;wBAChB,gBAAgB;uBACjB,gBAAgB;IACpC;;;OAGG;+BACyB,gBAAgB;2BACpB,gBAAgB;kCACT,gBAAgB;sBAC5B,gBAAgB;CAC2B,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;kCACb,OAAO,KAAG,kBAAkB;sCAMxB,OAAO,KAAG,kBAAkB;yCAMzB,MAAM,SAAS,OAAO,KAAG,kBAAkB;wCAM5C,MAAM,SAAS,OAAO,KAAG,kBAAkB;wCAO5D,MAAM,SACR,OAAO,KACZ,kBAAkB;yCAMM,MAAM,SAA6B,OAAO,KAAG,kBAAkB;mCAMrE,MAAM,SAAuB,OAAO,KAAG,kBAAkB;oCAMvD,MAAM,SAAS,OAAO,KAAG,kBAAkB;kCAM9C,MAAM,SAAsB,OAAO,KAAG,kBAAkB;0CAMhD,MAAM,SAA8B,OAAO,KAAG,kBAAkB;sCAMpE,MAAM,SAA0B,OAAO,KAAG,kBAAkB;6CAO1E,MAAM,SACR,OAAO,KACZ,kBAAkB;iCAMF,MAAM,SAAqB,OAAO,KAAG,kBAAkB;CAKe,CAAC;AAE3F;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEH,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY;CAK3F;AAWD;;;;GAIG;AACH,eAAO,MAAM,cAAc;8CAXQ,kBAAkB;kDAAlB,kBAAkB;gFAAlB,kBAAkB;+EAAlB,kBAAkB;+EAAlB,kBAAkB;gFAAlB,kBAAkB;0EAAlB,kBAAkB;2EAAlB,kBAAkB;yEAAlB,kBAAkB;iFAAlB,kBAAkB;6EAAlB,kBAAkB;oFAAlB,kBAAkB;wEAAlB,kBAAkB;CAyBqC,CAAC;AAI3F;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAMzC,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAAI,MAAM,gBAAgB,KAAG,MAClB,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,GAAI,QAAQ,MAAM,KAAG,gBACa,CAAC"}
+{"version":3,"file":"jsonrpc_errors.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/http/jsonrpc_errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAMN,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,MAAM,cAAc,CAAC;AAEtB,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GACzB,aAAa,GACb,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,UAAU,GACV,kBAAkB,GAClB,cAAc,GACd,qBAAqB,GACrB,SAAS,GACT,gBAAgB,GAChB,mBAAmB,CAAC;AAEvB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;0BAEK,gBAAgB;8BACR,gBAAgB;+BACd,gBAAgB;6BACpB,gBAAgB;6BAChB,gBAAgB;IAG1D;;;;OAIG;8BACwB,gBAAgB;IAC3C;;;OAGG;wBACkB,gBAAgB;wBAChB,gBAAgB;uBACjB,gBAAgB;IACpC;;;OAGG;+BACyB,gBAAgB;2BACpB,gBAAgB;kCACT,gBAAgB;sBAC5B,gBAAgB;IACnC;;;;OAIG;6BACuB,gBAAgB;IAC1C;;;;OAIG;gCAC0B,gBAAgB;CACiB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;kCACb,OAAO,KAAG,kBAAkB;sCAMxB,OAAO,KAAG,kBAAkB;yCAMzB,MAAM,SAAS,OAAO,KAAG,kBAAkB;wCAM5C,MAAM,SAAS,OAAO,KAAG,kBAAkB;wCAO5D,MAAM,SACR,OAAO,KACZ,kBAAkB;yCAMM,MAAM,SAA6B,OAAO,KAAG,kBAAkB;mCAMrE,MAAM,SAAuB,OAAO,KAAG,kBAAkB;oCAMvD,MAAM,SAAS,OAAO,KAAG,kBAAkB;kCAM9C,MAAM,SAAsB,OAAO,KAAG,kBAAkB;0CAMhD,MAAM,SAA8B,OAAO,KAAG,kBAAkB;sCAMpE,MAAM,SAA0B,OAAO,KAAG,kBAAkB;6CAO1E,MAAM,SACR,OAAO,KACZ,kBAAkB;iCAMF,MAAM,SAAqB,OAAO,KAAG,kBAAkB;wCAMhD,MAAM,SAA4B,OAAO,KAAG,kBAAkB;2CAO9E,MAAM,SACR,OAAO,KACZ,kBAAkB;CAKoE,CAAC;AAE3F;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEH,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY;CAK3F;AAWD;;;;GAIG;AACH,eAAO,MAAM,cAAc;8CAXQ,kBAAkB;kDAAlB,kBAAkB;gFAAlB,kBAAkB;+EAAlB,kBAAkB;+EAAlB,kBAAkB;gFAAlB,kBAAkB;0EAAlB,kBAAkB;2EAAlB,kBAAkB;yEAAlB,kBAAkB;iFAAlB,kBAAkB;6EAAlB,kBAAkB;oFAAlB,kBAAkB;wEAAlB,kBAAkB;+EAAlB,kBAAkB;kFAAlB,kBAAkB;CA2BqC,CAAC;AAI3F;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkBpE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAMzC,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAAI,MAAM,gBAAgB,KAAG,MAClB,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,GAAI,QAAQ,MAAM,KAAG,gBACa,CAAC"}

package/dist/http/jsonrpc_errors.js

@@ -3,7 +3,7 @@
  *
  * Provides error types, named constructors, and HTTP status mapping
  * for the throw/catch error pattern used by `apply_route_specs`.
- * Core error codes (5 standard + 8 general application). Domain-specific
+ * Core error codes (5 standard + 10 general application). Domain-specific
  * codes stay in consumers — add by casting `as JsonrpcErrorCode`.
  *
  * `JsonrpcErrorCode` and `JsonrpcErrorObject` types are Zod-inferred
@@ -20,7 +20,7 @@ import { JSONRPC_PARSE_ERROR, JSONRPC_INVALID_REQUEST, JSONRPC_METHOD_NOT_FOUND,
 /** Default message for unknown errors. */
 export const UNKNOWN_ERROR_MESSAGE = 'unknown error';
 /**
- * Standard JSON-RPC error codes (5) plus general application codes (8).
+ * Standard JSON-RPC error codes (5) plus general application codes (10).
  *
  * Extensible — consumers add domain-specific codes to their own objects
  * by casting `as JsonrpcErrorCode`. Application codes use the -32000 to
@@ -55,6 +55,18 @@ export const JSONRPC_ERROR_CODES = {
     rate_limited: -32006,
     service_unavailable: -32007,
     timeout: -32008,
+    /**
+     * Client-side backpressure — an outbound buffer (e.g. `FrontendWebsocketClient`'s
+     * disconnected request queue) refused a new request because it was full.
+     * Distinct from `rate_limited`, which signals a server-side policy.
+     */
+    queue_overflow: -32009,
+    /**
+     * Caller-initiated cancellation (e.g. `AbortSignal` fired). Cooperative,
+     * not a failure — the request did not complete because the caller asked
+     * for it to stop.
+     */
+    request_cancelled: -32010,
 };
 /**
  * Named constructors for `JsonrpcErrorObject` values.
@@ -129,6 +141,16 @@ export const jsonrpc_error_messages = {
         message,
         data,
     }),
+    queue_overflow: (message = 'queue overflow', data) => ({
+        code: JSONRPC_ERROR_CODES.queue_overflow,
+        message,
+        data,
+    }),
+    request_cancelled: (message = 'request cancelled', data) => ({
+        code: JSONRPC_ERROR_CODES.request_cancelled,
+        message,
+        data,
+    }),
 };
 /**
  * Error class carrying a JSON-RPC error code — thrown by handlers,
@@ -168,6 +190,8 @@ export const jsonrpc_errors = {
     rate_limited: create_error_thrower(jsonrpc_error_messages.rate_limited),
     service_unavailable: create_error_thrower(jsonrpc_error_messages.service_unavailable),
     timeout: create_error_thrower(jsonrpc_error_messages.timeout),
+    queue_overflow: create_error_thrower(jsonrpc_error_messages.queue_overflow),
+    request_cancelled: create_error_thrower(jsonrpc_error_messages.request_cancelled),
 };
 // --- HTTP status mapping ---
 /**
@@ -187,9 +211,13 @@ export const JSONRPC_ERROR_CODE_TO_HTTP_STATUS = {
     [-32003]: 404, // not_found
     [-32004]: 409, // conflict
     [-32005]: 422, // validation_error
+    // queue_overflow shares 429 with rate_limited — listed first so reverse
+    // map wins with rate_limited (server-side) rather than client-side overflow.
+    [-32009]: 429, // queue_overflow (client-side backpressure)
     [-32006]: 429, // rate_limited
     [-32007]: 503, // service_unavailable
     [-32008]: 504, // timeout
+    [-32010]: 499, // request_cancelled (nginx "client closed request")
 };
 /**
  * Maps HTTP status codes to JSON-RPC error codes (reverse mapping).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",