@steve31415/baselib 3.19.0 → 3.19.1

package/dist/sync-browser/client.d.ts

@@ -116,6 +116,7 @@ export declare class SyncClient<B, C extends EventBody, S extends EventBody, Sum
     private countdownTimer;
     private pingTimer;
     private watchdogTimer;
+    private socketCreatedAt;
     private rolloverTimer;
     private escalateTimer;
     private escalateArmedAt;
@@ -154,6 +155,9 @@ export declare class SyncClient<B, C extends EventBody, S extends EventBody, Sum
     subscribe(listener: (state: SyncClientState) => void): () => void;
     private installRuntimeListeners;
     private wakeConnection;
+    /** Drops the current socket, if any, without treating it as an outage, and
+     * connects at once. */
+    private replaceSocket;
     private connect;
     private connectNow;
     private scheduleReconnect;

package/dist/sync-browser/client.js

@@ -15,6 +15,7 @@ const GAP_BUFFER_MAX = 1_000;
 const RECONCILE_MOVED_MAX_REFETCHES = 3;
 const CLOSE_NO_USER = 4403;
 const PROBE_AFTER_ATTEMPTS = 2;
+const SOCKET_CONNECTING = 0;
 const SOCKET_OPEN = 1;
 class LifecycleAbort {
     reason;
@@ -45,6 +46,7 @@ export class SyncClient {
     countdownTimer = null;
     pingTimer = null;
     watchdogTimer = null;
+    socketCreatedAt = 0;
     rolloverTimer = null;
     escalateTimer = null;
     escalateArmedAt = 0;
@@ -207,14 +209,7 @@ export class SyncClient {
         if (this.halted || this.disposed)
             return;
         this.options.logger.info('sync reconnect for traffic build');
-        const previous = this.socket;
-        this.socket = null;
-        this.clearConnectionTimers();
-        if (previous) {
-            previous.close();
-            this.detachSocket(previous);
-        }
-        this.connectNow();
+        this.replaceSocket();
     }
     state() {
         return this.currentState;
@@ -232,11 +227,33 @@ export class SyncClient {
     wakeConnection() {
         if (this.halted || this.disposed)
             return;
-        if (this.socket !== null) {
-            if (this.socket.readyState === SOCKET_OPEN)
-                this.sendConnect();
+        const socket = this.socket;
+        if (socket?.readyState === SOCKET_OPEN) {
+            this.sendConnect();
             return;
         }
+        // A handshake still inside its watchdog window may just be slow: leave
+        // it. One past that window began before the page was frozen (a
+        // backgrounded phone tab) and its watchdog never ran; a socket already
+        // closing is gone too. Waiting on either routes the returning user
+        // through the watchdog's close and a full backoff step (16-30 s of
+        // "Reconnecting…" observed on reader, 2026-09-24).
+        if (socket?.readyState === SOCKET_CONNECTING &&
+            this.options.runtime.now() - this.socketCreatedAt < CONNECT_WATCHDOG_MS) {
+            return;
+        }
+        this.replaceSocket();
+    }
+    /** Drops the current socket, if any, without treating it as an outage, and
+     * connects at once. */
+    replaceSocket() {
+        const previous = this.socket;
+        this.socket = null;
+        this.clearConnectionTimers();
+        if (previous) {
+            previous.close();
+            this.detachSocket(previous);
+        }
         this.connectNow();
     }
     connect() {
@@ -256,6 +273,7 @@ export class SyncClient {
             return;
         }
         this.socket = socket;
+        this.socketCreatedAt = this.options.runtime.now();
         this.watchdogTimer = this.options.runtime.setTimeout(() => {
             if (socket.readyState !== SOCKET_OPEN)
                 socket.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steve31415/baselib",
-  "version": "3.19.0",
+  "version": "3.19.1",
   "description": "Plasticine new-world shared platform library: logging, auth, service-to-service auth, db, HTTP, sync, app updates",
   "type": "module",
   "license": "MIT",