reachlo 1.4.2 → 1.4.5

package/README.md

@@ -96,11 +96,13 @@ Deliver real-time metrics, alerts, and notifications at scale.
 
 ## Advanced Configuration
 
-For self-hosted or custom deployments:
+For custom deployments or to tune retry behavior:
 
 ```js
 const client = new Reachlo('YOUR_API_KEY', {
-  url: 'wss://your-custom-backend.com'
+  url: 'wss://your-custom-backend.com', // custom backend URL
+  maxInitialRetries: 3,                 // retries before first successful connect (auth failures)
+  maxNetworkRetries: 50                 // retries after a drop (network failures). 0 = unlimited
 });
 ```
 

package/index.d.ts

@@ -2,6 +2,8 @@ export interface ReachloOptions {
     url?: string;
     heartbeatInterval?: number;
     reconnectInterval?: number;
+    maxInitialRetries?: number;
+    maxNetworkRetries?: number;
 }
 
 export default class Reachlo {

package/index.js

@@ -14,6 +14,8 @@ class Reachlo {
         this.heartbeatInterval = options.heartbeatInterval || 20000;
         this.reconnectBaseDelay = options.reconnectBaseDelay || 1000;
         this.reconnectMaxDelay = options.reconnectMaxDelay || 30000;
+        this.maxInitialRetries = options.maxInitialRetries ?? 3;    // never opened: give up fast
+        this.maxNetworkRetries = options.maxNetworkRetries ?? 50;   // ~25 mins of attempts at max backoff
         this.batchInterval = options.batchInterval || 0; // 0 = disabled
 
         // Batch state
@@ -82,6 +84,7 @@ class Reachlo {
 
     connect() {
         this.shouldReconnect = true;
+        this._connectionEstablished = false;
         return new Promise((resolve, reject) => {
             if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
 
@@ -95,6 +98,7 @@ class Reachlo {
             this.socket = new WebSocket(this.url, protocols);
 
             this.socket.onopen = () => {
+                this._connectionEstablished = true;
                 this._log("Reachlo: Connected");
                 this.reconnecting = false;
                 this._reconnectAttempt = 0; // Reset backoff on successful connect
@@ -115,17 +119,24 @@ class Reachlo {
                 });
                 this.pendingSubs.clear();
 
-                // Flush Offline Buffer (if enabled)
-                if (this.bufferPublish && this.offlineBuffer.length > 0) {
+                // Flush Offline Buffer (non-publish always, publish if enabled)
+                if (this.offlineBuffer.length > 0) {
                     const toFlush = [...this.offlineBuffer];
                     this.offlineBuffer = [];
-                    toFlush.forEach(msg => this._send(msg));
+                    toFlush.forEach(msg => {
+                        if (msg.type !== 'publish' || this.bufferPublish) {
+                            this._send(msg);
+                        }
+                    });
                 }
 
                 resolve();
             };
 
             this.socket.onclose = (event) => {
+                const connectionWasEstablished = this._connectionEstablished;
+                this._connectionEstablished = false;
+
                 this._log("Reachlo: Connection closed", event.code, event.reason);
                 this._stopHeartbeat();
 
@@ -153,6 +164,24 @@ class Reachlo {
                 }
 
                 if (this.shouldReconnect) {
+                    if (!connectionWasEstablished) {
+                        // Never connected — likely bad key, give up after maxInitialRetries
+                        if (this.maxInitialRetries > 0 && this._reconnectAttempt >= this.maxInitialRetries) {
+                            this._error("Reachlo: Could not establish connection. Check your API key.");
+                            this.shouldReconnect = false;
+                            this._emitLifecycle('error');
+                            return;
+                        }
+                    } else {
+                        // Was connected before — genuine network issue
+                        if (this.maxNetworkRetries > 0 && this._reconnectAttempt >= this.maxNetworkRetries) {
+                            this._error("Reachlo: Network retry limit reached, giving up.");
+                            this.shouldReconnect = false;
+                            this._emitLifecycle('error');
+                            return;
+                        }
+                    }
+
                     if (!this.reconnecting) {
                         this.reconnecting = true;
                         this._emitLifecycle('reconnecting');
@@ -240,7 +269,12 @@ class Reachlo {
 
 
         if (this.socket) {
-            this.socket.close();
+            // Close with code 1000 (Normal Closure) to prevent reconnect logic from misinterpreting
+            if (this.socket.readyState === 1) {
+                this.socket.close(1000, "Client disconnected explicitly");
+            } else {
+                this.socket.close();
+            }
             this.socket = null;
         }
         this.pendingSubs.clear();
@@ -275,7 +309,9 @@ class Reachlo {
             this.socket.send(JSON.stringify(payload));
             return true;
         } else {
-            if (this.bufferPublish && payload.type === 'publish') {
+            // Drop back to offline buffer to ensure sync requests or others make it when reconnecting!
+            // E.g. user calls sync() before connect() resolves.
+            if (this.bufferPublish || payload.type !== 'publish') {
                 this.offlineBuffer.push(payload);
                 return true; // Queued
             }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reachlo",
-    "version": "1.4.2",
+    "version": "1.4.5",
     "description": "Streaming-native real-time infrastructure. Ordered channels, durable replay, presence, backpressure, and ACK delivery.",
     "main": "index.js",
     "type": "module",