hrpc-inspector 0.1.2 → 0.1.3

package/dist/index.js

@@ -28,9 +28,12 @@ function createWebSocketReporter(url, opts = {}) {
   const maxQueue = opts.maxQueue ?? 1e3;
   const reconnectMs = opts.reconnectMs ?? 3e3;
   const OPEN = 1;
+  const maxReconnectMs = opts.maxReconnectMs ?? 3e4;
   let ws = null;
   let queue = [];
   let closed = false;
+  let retryTimer = null;
+  let backoffMs = reconnectMs;
   function enqueue(ev) {
     queue.push(ev);
     if (queue.length > maxQueue) queue.shift();
@@ -42,12 +45,23 @@ function createWebSocketReporter(url, opts = {}) {
       enqueue(ev);
     }
   }
+  function scheduleRetry() {
+    if (closed || retryTimer) return;
+    retryTimer = setTimeout(() => {
+      retryTimer = null;
+      ensure();
+    }, backoffMs);
+    backoffMs = Math.min(backoffMs * 2, maxReconnectMs);
+    if (typeof retryTimer?.unref === "function") retryTimer.unref();
+  }
   function ensure() {
     if (closed || !WS) return;
     if (ws && (ws.readyState === 0 || ws.readyState === 1)) return;
+    if (retryTimer) return;
     try {
       ws = new WS(url);
       ws.onopen = () => {
+        backoffMs = reconnectMs;
         if (opts.announce !== void 0) rawSend({ __source: opts.announce });
         const q = queue;
         queue = [];
@@ -55,7 +69,7 @@ function createWebSocketReporter(url, opts = {}) {
       };
       ws.onclose = () => {
         ws = null;
-        if (!closed) setTimeout(ensure, reconnectMs);
+        scheduleRetry();
       };
       ws.onerror = () => {
       };
@@ -67,6 +81,7 @@ function createWebSocketReporter(url, opts = {}) {
       };
     } catch {
       ws = null;
+      scheduleRetry();
     }
   }
   return {
@@ -80,6 +95,10 @@ function createWebSocketReporter(url, opts = {}) {
     },
     close() {
       closed = true;
+      if (retryTimer) {
+        clearTimeout(retryTimer);
+        retryTimer = null;
+      }
       try {
         ws?.close();
       } catch {
@@ -137,7 +156,7 @@ function monitorStream(report, endpoint, corrId, stream, t0, preview, tag) {
   }
 }
 function wrapFn(report, endpoint, fn, self, preview, monitorStreams, onCall) {
-  return function observed(...args) {
+  const wrapped = function observed(...args) {
     const corrId = "rpc-" + ++seq;
     let tag = {};
     if (invokeCtx && invokeCtx.method === endpoint) {
@@ -171,6 +190,12 @@ function wrapFn(report, endpoint, fn, self, preview, monitorStreams, onCall) {
     }
     return result;
   };
+  try {
+    Object.defineProperty(wrapped, "name", { value: fn.name, configurable: true });
+    Object.defineProperty(wrapped, "length", { value: fn.length, configurable: true });
+  } catch {
+  }
+  return wrapped;
 }
 function wrapClient(client, report, opts = {}) {
   if (!client || typeof client !== "object") return client;

package/dist/observe.js

@@ -28,9 +28,12 @@ function createWebSocketReporter(url, opts = {}) {
   const maxQueue = opts.maxQueue ?? 1e3;
   const reconnectMs = opts.reconnectMs ?? 3e3;
   const OPEN = 1;
+  const maxReconnectMs = opts.maxReconnectMs ?? 3e4;
   let ws = null;
   let queue = [];
   let closed = false;
+  let retryTimer = null;
+  let backoffMs = reconnectMs;
   function enqueue(ev) {
     queue.push(ev);
     if (queue.length > maxQueue) queue.shift();
@@ -42,12 +45,23 @@ function createWebSocketReporter(url, opts = {}) {
       enqueue(ev);
     }
   }
+  function scheduleRetry() {
+    if (closed || retryTimer) return;
+    retryTimer = setTimeout(() => {
+      retryTimer = null;
+      ensure();
+    }, backoffMs);
+    backoffMs = Math.min(backoffMs * 2, maxReconnectMs);
+    if (typeof retryTimer?.unref === "function") retryTimer.unref();
+  }
   function ensure() {
     if (closed || !WS) return;
     if (ws && (ws.readyState === 0 || ws.readyState === 1)) return;
+    if (retryTimer) return;
     try {
       ws = new WS(url);
       ws.onopen = () => {
+        backoffMs = reconnectMs;
         if (opts.announce !== void 0) rawSend({ __source: opts.announce });
         const q = queue;
         queue = [];
@@ -55,7 +69,7 @@ function createWebSocketReporter(url, opts = {}) {
       };
       ws.onclose = () => {
         ws = null;
-        if (!closed) setTimeout(ensure, reconnectMs);
+        scheduleRetry();
       };
       ws.onerror = () => {
       };
@@ -67,6 +81,7 @@ function createWebSocketReporter(url, opts = {}) {
       };
     } catch {
       ws = null;
+      scheduleRetry();
     }
   }
   return {
@@ -80,6 +95,10 @@ function createWebSocketReporter(url, opts = {}) {
     },
     close() {
       closed = true;
+      if (retryTimer) {
+        clearTimeout(retryTimer);
+        retryTimer = null;
+      }
       try {
         ws?.close();
       } catch {
@@ -137,7 +156,7 @@ function monitorStream(report, endpoint, corrId, stream, t0, preview, tag) {
   }
 }
 function wrapFn(report, endpoint, fn, self, preview, monitorStreams, onCall) {
-  return function observed(...args) {
+  const wrapped = function observed(...args) {
     const corrId = "rpc-" + ++seq;
     let tag = {};
     if (invokeCtx && invokeCtx.method === endpoint) {
@@ -171,6 +190,12 @@ function wrapFn(report, endpoint, fn, self, preview, monitorStreams, onCall) {
     }
     return result;
   };
+  try {
+    Object.defineProperty(wrapped, "name", { value: fn.name, configurable: true });
+    Object.defineProperty(wrapped, "length", { value: fn.length, configurable: true });
+  } catch {
+  }
+  return wrapped;
 }
 function wrapClient(client, report, opts = {}) {
   if (!client || typeof client !== "object") return client;

package/dist/reporters.d.ts

@@ -17,6 +17,8 @@ export interface WebSocketReporterOptions {
      * replay/invoke path); leaving it undefined keeps the reporter strictly send-only, as before.
      */
     onMessage?: (msg: any) => void;
+    /** Ceiling for the reconnect backoff, in ms. Default 30000. */
+    maxReconnectMs?: number;
 }
 /**
  * Send each event as one JSON WebSocket message to `url` (e.g. ws://127.0.0.1:9420/ws).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hrpc-inspector",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "hrpc based debugging and observability for Bare. Tap an RPC client or a raw transport and read endpoint, request, response, latency and live subscription streams in a local GUI, or merge multi-peer timelines over a Hyperswarm hub.",
   "type": "module",
   "main": "./dist/index.js",

package/src/reporters.ts

@@ -25,6 +25,8 @@ export interface WebSocketReporterOptions {
    * replay/invoke path); leaving it undefined keeps the reporter strictly send-only, as before.
    */
   onMessage?: (msg: any) => void;
+  /** Ceiling for the reconnect backoff, in ms. Default 30000. */
+  maxReconnectMs?: number;
 }
 
 /**
@@ -37,9 +39,17 @@ export function createWebSocketReporter(url: string, opts: WebSocketReporterOpti
   const reconnectMs = opts.reconnectMs ?? 3000;
   const OPEN = 1;
 
+  const maxReconnectMs = opts.maxReconnectMs ?? 30000;
+
   let ws: any = null;
   let queue: unknown[] = [];
   let closed = false;
+  // A reconnect already scheduled. Without this, export() — which runs on every flush, i.e. every
+  // ~200ms — would open a fresh socket the moment the previous one failed, defeating the backoff
+  // entirely. A browser logs EVERY refused WebSocket connect to the console itself, before any
+  // onerror handler runs, so that turned "no GUI running" into a console flooded at 5 errors/sec.
+  let retryTimer: any = null;
+  let backoffMs = reconnectMs;
 
   function enqueue(ev: unknown) {
     queue.push(ev);
@@ -48,21 +58,33 @@ export function createWebSocketReporter(url: string, opts: WebSocketReporterOpti
   function rawSend(ev: unknown) {
     try { ws.send(JSON.stringify(ev)); } catch { enqueue(ev); }
   }
+  function scheduleRetry() {
+    if (closed || retryTimer) return;
+    retryTimer = setTimeout(() => { retryTimer = null; ensure(); }, backoffMs);
+    // Widen the gap each time the viewer stays absent, so a dev session with no GUI settles at one
+    // attempt per maxReconnectMs instead of one per flush. Reset to `reconnectMs` on a real open.
+    backoffMs = Math.min(backoffMs * 2, maxReconnectMs);
+    if (typeof retryTimer?.unref === 'function') retryTimer.unref();
+  }
+
   function ensure() {
     if (closed || !WS) return;
     if (ws && (ws.readyState === 0 || ws.readyState === 1)) return;
+    if (retryTimer) return; // a reconnect is already pending — do not stack another socket on top
     try {
       ws = new WS(url);
       ws.onopen = () => {
+        backoffMs = reconnectMs; // the viewer is back; retry promptly if it goes away again
         if (opts.announce !== undefined) rawSend({ __source: opts.announce }); // identify this device first
         const q = queue; queue = []; for (const e of q) rawSend(e);
       };
-      ws.onclose = () => { ws = null; if (!closed) setTimeout(ensure, reconnectMs); };
+      ws.onclose = () => { ws = null; scheduleRetry(); };
       ws.onerror = () => {};
       // Bidirectional only when a handler was supplied (dev/replay path). Never throws inward.
       if (opts.onMessage) ws.onmessage = (m: any) => { try { opts.onMessage!(JSON.parse(m.data)); } catch { /* ignore malformed inbound */ } };
     } catch {
       ws = null;
+      scheduleRetry();
     }
   }
 
@@ -77,6 +99,7 @@ export function createWebSocketReporter(url: string, opts: WebSocketReporterOpti
     },
     close() {
       closed = true;
+      if (retryTimer) { clearTimeout(retryTimer); retryTimer = null; }
       try { ws?.close(); } catch {}
       ws = null;
     },

package/src/wrap-client.ts

@@ -101,7 +101,7 @@ function monitorStream(report: Report, endpoint: string, corrId: string, stream:
 }
 
 function wrapFn(report: Report, endpoint: string, fn: any, self: any, preview: (v: unknown) => unknown, monitorStreams: boolean, onCall?: (corrId: string, method: string, args: unknown[]) => void): any {
-  return function observed(this: unknown, ...args: unknown[]) {
+  const wrapped = function observed(this: unknown, ...args: unknown[]) {
     const corrId = 'rpc-' + ++seq;
     // Consume the invoke tag ONCE, and only for the exact method being replayed.
     let tag: Record<string, unknown> = {};
@@ -131,6 +131,18 @@ function wrapFn(report: Report, endpoint: string, fn: any, self: any, preview: (
     }
     return result;
   };
+
+  // Carry the original identity across. An app may read `fn.name` — keet's own System Log does
+  // (`method: apiFn.name`), and every entry showed "observed" instead of the endpoint. `length`
+  // goes too, since arity is the other thing reflection commonly checks. Both are configurable
+  // on a function, so this cannot throw; guarded anyway, because the tap must never break a client.
+  try {
+    Object.defineProperty(wrapped, 'name', { value: fn.name, configurable: true });
+    Object.defineProperty(wrapped, 'length', { value: fn.length, configurable: true });
+  } catch {
+    /* identity is a nicety; never fail the wrap over it */
+  }
+  return wrapped;
 }
 
 /**