@fuzdev/fuz_app 0.29.0 → 0.31.0

package/dist/actions/socket.svelte.js

@@ -13,12 +13,12 @@
  *   message path so request/response correlation is transport-level rather
  *   than re-invented per consumer.
  * - **Durable queue** — `request()` calls made while disconnected buffer up
- *   to {@link DEFAULT_QUEUE_MAX_SIZE} requests and flush on reopen. Overflow
+ *   to `DEFAULT_QUEUE_MAX_SIZE` requests and flush on reopen. Overflow
  *   rejects with `queue_overflow`. Raw {@link FrontendWebsocketClient.send}
  *   is drop-on-disconnect (fire-and-forget notifications want that).
  * - **Activity-aware heartbeat** — idles fire a shared `heartbeat` request;
- *   receive-silence past {@link DEFAULT_HEARTBEAT_RECEIVE_TIMEOUT} closes
- *   with {@link WS_CLOSE_CLIENT_HEARTBEAT_TIMEOUT} and lets auto-reconnect
+ *   receive-silence past `DEFAULT_HEARTBEAT_RECEIVE_TIMEOUT` closes
+ *   with `WS_CLOSE_CLIENT_HEARTBEAT_TIMEOUT` and lets auto-reconnect
  *   pick back up.
  *
  * @module
@@ -27,8 +27,8 @@ 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';
+import { cancel_action_spec } from './cancel.js';
+import { heartbeat_action_spec } from './heartbeat.js';
 /** Default WebSocket close code (normal closure). */
 export const DEFAULT_CLOSE_CODE = 1000;
 /** Base reconnect delay in ms. */
@@ -39,7 +39,7 @@ export const DEFAULT_RECONNECT_DELAY_MAX = 10000;
 export const DEFAULT_BACKOFF_FACTOR = 1.5;
 /** Idle interval before sending a heartbeat (ms). */
 export const DEFAULT_HEARTBEAT_INTERVAL = 30_000;
-/** Max receive silence before closing with {@link WS_CLOSE_CLIENT_HEARTBEAT_TIMEOUT} (ms). */
+/** Max receive silence before closing with `WS_CLOSE_CLIENT_HEARTBEAT_TIMEOUT` (ms). */
 export const DEFAULT_HEARTBEAT_RECEIVE_TIMEOUT = 60_000;
 /** Default bound on buffered requests while disconnected. Overflow rejects. */
 export const DEFAULT_QUEUE_MAX_SIZE = 100;
@@ -92,7 +92,7 @@ export class FrontendWebsocketClient {
      * when the underlying `ws.send` throws (e.g., buffer full, serialization
      * error); reset to `null` on the next successful send. Not touched when
      * `send()` short-circuits because the socket is not connected — consult
-     * {@link connected} for that case. Wrappers surfacing per-message failure
+     * `connected` for that case. Wrappers surfacing per-message failure
      * reasons can read this after a `false` return from `send()`.
      */
     last_send_error = $state.raw(null);
@@ -182,7 +182,7 @@ export class FrontendWebsocketClient {
      * `null`/omitted restores the defaults, or a config object customizes
      * specific fields (missing fields fall back to defaults, not "keep
      * current" — each call defines the whole policy atomically, same as the
-     * constructor and {@link set_reconnect}).
+     * constructor and `set_reconnect`).
      *
      * When connected, the live timer is restarted immediately so the new
      * `interval` / `receive_timeout` take effect without a reconnect; when
@@ -208,10 +208,10 @@ export class FrontendWebsocketClient {
      * pending.
      *
      * Use this when UI state asks "stop trying for now" without the finality
-     * of {@link disconnect} (which also rejects pending/queued requests and
+     * of `disconnect` (which also rejects pending/queued requests and
      * clears heartbeat) or the policy change of `set_reconnect(false)`
      * (which disables future reconnects). The queue stays intact so that
-     * calling {@link connect} later flushes buffered work.
+     * calling `connect` later flushes buffered work.
      */
     cancel_reconnect() {
         if (this.#reconnect_timeout === null)
@@ -315,7 +315,7 @@ export class FrontendWebsocketClient {
      * disconnect-detection slot.
      *
      * On `AbortSignal` fire: rejects the local promise *and* sends the shared
-     * `cancel` notification ({@link CANCEL_METHOD}) so the server-side
+     * `cancel` notification (`cancel_action_spec.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.
@@ -421,7 +421,7 @@ export class FrontendWebsocketClient {
     #send_cancel(request_id) {
         this.send({
             jsonrpc: JSONRPC_VERSION,
-            method: CANCEL_METHOD,
+            method: cancel_action_spec.method,
             params: { request_id },
         });
     }
@@ -535,7 +535,7 @@ export class FrontendWebsocketClient {
             // receive-silence detection above will close the socket on the next
             // tick. No queue — the heartbeat is the thing that tells us the
             // queue needs flushing, it must not fight the queue for the slot.
-            void this.request(HEARTBEAT_METHOD, {}, { queue: false }).catch((error) => {
+            void this.request(heartbeat_action_spec.method, {}, { queue: false }).catch((error) => {
                 this.#log?.debug('[socket] heartbeat request failed:', error);
             });
         }
@@ -697,14 +697,14 @@ export class FrontendWebsocketClient {
     };
 }
 /**
- * Project {@link SocketStatus} onto fuz_util's {@link AsyncStatus} — the
+ * Project `SocketStatus` onto fuz_util's `AsyncStatus` — the
  * 5-way → 4-way mapping every consumer re-derives to surface connection state
  * to UI (loading indicators, retry banners). Collapses `reconnecting` into
  * `failure` (UI shows "lost, retrying") and splits `closed` by `revoked` so
  * a terminal session-revocation read as `failure` while a clean client-
  * initiated close reads as `initial` (the "not connected, not trying" state).
  *
- * @param status - the socket's current {@link SocketStatus}
+ * @param status - the socket's current `SocketStatus`
  * @param revoked - whether the session has been permanently revoked
  *   (typically `FrontendWebsocketClient.revoked`)
  */

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

@@ -1 +1 @@
-{"version":3,"file":"transports_ws_auth_guard.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws_auth_guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,4BAA4B,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAMxD,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,yBAAyB,EACpC,KAAK,MAAM,KACT,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CA6CjC,CAAC"}
+{"version":3,"file":"transports_ws_auth_guard.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws_auth_guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,4BAA4B,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAMxD,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,GAChC,WAAW,yBAAyB,EACpC,KAAK,MAAM,KACT,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CA6CjC,CAAC"}

package/dist/actions/transports_ws_backend.d.ts

@@ -91,6 +91,21 @@ export declare class BackendWebsocketTransport implements FilterableBroadcastTra
      * @returns the number of sockets the message was sent to
      */
     broadcast_filtered(message: JsonrpcMessageFromServerToClient, predicate: (identity: ConnectionIdentity) => boolean): number;
+    /**
+     * Send a message to every socket bound to a specific account.
+     *
+     * Targeted per-account fan-out for any flow where the delivery target
+     * is a single known account. Prefer this over `broadcast_filtered` when
+     * the filter is exactly "this account_id"; reach for `broadcast_filtered`
+     * when the ACL is an arbitrary predicate over `ConnectionIdentity`.
+     *
+     * Mirrors `close_sockets_for_account` on the send side: every connection
+     * for the account (session, bearer, and daemon-token) receives the
+     * message.
+     *
+     * @returns the number of sockets the message was sent to
+     */
+    send_to_account(account_id: Uuid, message: JsonrpcMessageFromServerToClient): number;
     is_ready(): boolean;
     /**
      * Number of currently tracked WebSocket connections.

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

@@ -1 +1 @@
-{"version":3,"file":"transports_ws_backend.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws_backend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAEX,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAc,KAAK,IAAI,EAAC,MAAM,YAAY,CAAC;AAClD,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAIpG;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAClC,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,UAAU,EAAE,IAAI,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA6B,SAAQ,SAAS;IAC9D,kBAAkB,EAAE,CACnB,OAAO,EAAE,gCAAgC,EACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,KAChD,MAAM,CAAC;CACZ;AAED,qDAAqD;AACrD,eAAO,MAAM,iCAAiC,GAC7C,WAAW,SAAS,KAClB,SAAS,IAAI,4BAEqE,CAAC;AAEtF,qBAAa,yBAA0B,YAAW,4BAA4B;;IAC7E,QAAQ,CAAC,cAAc,EAAG,uBAAuB,CAAU;IAY3D;;;;;;;;OAQG;IACH,cAAc,CACb,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,EAAE,IAAI,EAChB,YAAY,GAAE,MAAM,GAAG,IAAW,GAChC,IAAI;IAQP;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IA0BtC;;;;OAIG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIrD;;;;OAIG;IACH,yBAAyB,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM;IAInD;;;;;;;;OAQG;IACH,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAsB/C,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;IA6CvC;;;;;;;;;OASG;IACH,kBAAkB,CACjB,OAAO,EAAE,gCAAgC,EACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,GAClD,MAAM;IAoBT,QAAQ,IAAI,OAAO;IAInB;;;;;;;OAOG;IACH,oBAAoB,IAAI,MAAM;CAG9B"}
+{"version":3,"file":"transports_ws_backend.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/actions/transports_ws_backend.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAEX,gCAAgC,EAChC,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAc,KAAK,IAAI,EAAC,MAAM,YAAY,CAAC;AAClD,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAC,MAAM,iBAAiB,CAAC;AAIpG;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAClC,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,4CAA4C;IAC5C,UAAU,EAAE,IAAI,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA6B,SAAQ,SAAS;IAC9D,kBAAkB,EAAE,CACnB,OAAO,EAAE,gCAAgC,EACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,KAChD,MAAM,CAAC;CACZ;AAED,qDAAqD;AACrD,eAAO,MAAM,iCAAiC,GAC7C,WAAW,SAAS,KAClB,SAAS,IAAI,4BAEqE,CAAC;AAEtF,qBAAa,yBAA0B,YAAW,4BAA4B;;IAC7E,QAAQ,CAAC,cAAc,EAAG,uBAAuB,CAAU;IAY3D;;;;;;;;OAQG;IACH,cAAc,CACb,EAAE,EAAE,SAAS,EACb,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,UAAU,EAAE,IAAI,EAChB,YAAY,GAAE,MAAM,GAAG,IAAW,GAChC,IAAI;IAQP;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IA0BtC;;;;OAIG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIrD;;;;OAIG;IACH,yBAAyB,CAAC,UAAU,EAAE,IAAI,GAAG,MAAM;IAInD;;;;;;;;OAQG;IACH,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAsB/C,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;IA6CvC;;;;;;;;;OASG;IACH,kBAAkB,CACjB,OAAO,EAAE,gCAAgC,EACzC,SAAS,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,GAClD,MAAM;IAoBT;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,gCAAgC,GAAG,MAAM;IAIpF,QAAQ,IAAI,OAAO;IAInB;;;;;;;OAOG;IACH,oBAAoB,IAAI,MAAM;CAG9B"}

package/dist/actions/transports_ws_backend.js

@@ -167,6 +167,23 @@ export class BackendWebsocketTransport {
         }
         return count;
     }
+    /**
+     * Send a message to every socket bound to a specific account.
+     *
+     * Targeted per-account fan-out for any flow where the delivery target
+     * is a single known account. Prefer this over `broadcast_filtered` when
+     * the filter is exactly "this account_id"; reach for `broadcast_filtered`
+     * when the ACL is an arbitrary predicate over `ConnectionIdentity`.
+     *
+     * Mirrors `close_sockets_for_account` on the send side: every connection
+     * for the account (session, bearer, and daemon-token) receives the
+     * message.
+     *
+     * @returns the number of sockets the message was sent to
+     */
+    send_to_account(account_id, message) {
+        return this.broadcast_filtered(message, (id) => id.account_id === account_id);
+    }
     is_ready() {
         return this.#connections.size > 0;
     }