reachlo 1.4.2 → 1.4.4

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
@@ -126,6 +130,9 @@ class Reachlo {
             };
 
             this.socket.onclose = (event) => {
+                const connectionWasEstablished = this._connectionEstablished;
+                this._connectionEstablished = false;
+
                 this._log("Reachlo: Connection closed", event.code, event.reason);
                 this._stopHeartbeat();
 
@@ -153,6 +160,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');

package/package.json

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