codehost 0.18.1 → 0.18.2

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.18.2](https://github.com/snomiao/codehost/compare/v0.18.1...v0.18.2) (2026-06-11)
+
+
+### Bug Fixes
+
+* **signaling:** recover instantly when a throttled tab wakes (visibility/focus/online) ([d459132](https://github.com/snomiao/codehost/commit/d45913267f053ee1fee062bae550cfe60a193207))
+
 ## [0.18.1](https://github.com/snomiao/codehost/compare/v0.18.0...v0.18.1) (2026-06-11)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codehost",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "type": "module",
   "repository": {
     "type": "git",

package/src/shared/signaling-client.ts

@@ -53,6 +53,7 @@ export class SignalingClient {
   private ws: WebSocket | null = null;
   private closed = false;
   private reconnectDelay = 1000;
+  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;
   private heartbeat: ReturnType<typeof setInterval> | null = null;
   /** Fires STABLE_MS after a socket opens; only then is the backoff reset. */
   private stableTimer: ReturnType<typeof setTimeout> | null = null;
@@ -65,9 +66,53 @@ export class SignalingClient {
 
   connect(): void {
     this.closed = false;
+    this.attachWakeListeners();
     this.open();
   }
 
+  // ---- background-tab recovery -------------------------------------------
+  // Chrome throttles timers in hidden tabs to minutes, so the backoff retry
+  // (and the connect-timeout abort) may be arbitrarily far away even though a
+  // fresh socket would connect in milliseconds. When the tab becomes visible /
+  // focused / back online, recover NOW instead of waiting for a timer.
+
+  private onWake = (): void => {
+    if (this.closed) return;
+    const state = this.ws?.readyState;
+    if (state === 1 /* OPEN */) return;
+    if (state === 0 /* CONNECTING */) {
+      // Stuck handshake: abort — onclose reschedules, and timers run normally
+      // now that the tab is active.
+      try {
+        this.ws?.close();
+      } catch {
+        // ignore
+      }
+      return;
+    }
+    // Closed and waiting out the (throttled) backoff: skip the wait.
+    if (this.reconnectTimer != null) {
+      this.clearReconnectTimer();
+      this.open();
+    }
+  };
+
+  private attachWakeListeners(): void {
+    const doc = (globalThis as { document?: EventTarget }).document;
+    doc?.addEventListener("visibilitychange", this.onWake);
+    const win = (globalThis as { window?: EventTarget }).window;
+    win?.addEventListener("focus", this.onWake);
+    win?.addEventListener("online", this.onWake);
+  }
+
+  private detachWakeListeners(): void {
+    const doc = (globalThis as { document?: EventTarget }).document;
+    doc?.removeEventListener("visibilitychange", this.onWake);
+    const win = (globalThis as { window?: EventTarget }).window;
+    win?.removeEventListener("focus", this.onWake);
+    win?.removeEventListener("online", this.onWake);
+  }
+
   private roomUrl(): string {
     const base = this.opts.url.replace(/\/+$/, "");
     return `${base}/room/${encodeURIComponent(this.opts.token)}`;
@@ -172,11 +217,20 @@ export class SignalingClient {
   private scheduleReconnect(): void {
     const delay = this.reconnectDelay;
     this.reconnectDelay = Math.min(delay * 2, 15000);
-    setTimeout(() => {
+    this.clearReconnectTimer();
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
       if (!this.closed) this.open();
     }, delay);
   }
 
+  private clearReconnectTimer(): void {
+    if (this.reconnectTimer != null) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+  }
+
   sendSignal(to: string, data: unknown): void {
     const msg: ClientMessage = { type: "signal", to, data };
     this.ws?.send(JSON.stringify(msg));
@@ -194,6 +248,8 @@ export class SignalingClient {
 
   close(): void {
     this.closed = true;
+    this.detachWakeListeners();
+    this.clearReconnectTimer();
     this.stopHeartbeat();
     this.clearStableTimer();
     try {