reachlo 1.3.1 → 1.4.1

package/index.js

@@ -2,7 +2,7 @@
 class Reachlo {
     constructor(apiKey, options = {}) {
         this.apiKey = apiKey;
-        this.url = options.url || 'wss://friendly-octo-barnacle.fly.dev';
+        this.url = options.url || 'wss://edge.reachlo.space/';
         this.socket = null;
         this.channels = new Map();
         this.pendingSubs = new Set();
@@ -12,7 +12,13 @@ class Reachlo {
         this.debug = options.debug || false; // Default: false (silent)
         this.bufferPublish = options.bufferPublish ?? false; // Drop by default for AI
         this.heartbeatInterval = options.heartbeatInterval || 20000;
-        this.reconnectInterval = options.reconnectInterval || 3000;
+        this.reconnectBaseDelay = options.reconnectBaseDelay || 1000;
+        this.reconnectMaxDelay = options.reconnectMaxDelay || 30000;
+        this.batchInterval = options.batchInterval || 0; // 0 = disabled
+
+        // Batch state
+        this._batchQueue = [];
+        this._batchTimer = null;
 
         // State
         this.heartbeatTimer = null;
@@ -20,6 +26,7 @@ class Reachlo {
         this.shouldReconnect = true;
         this.lastPong = Date.now();
         this.reconnecting = false; // Prevent duplicate events
+        this._reconnectAttempt = 0;
 
         // Protocol v2 State
         this.msgId = 0;
@@ -90,6 +97,7 @@ class Reachlo {
             this.socket.onopen = () => {
                 this._log("Reachlo: Connected");
                 this.reconnecting = false;
+                this._reconnectAttempt = 0; // Reset backoff on successful connect
                 this.lastPong = Date.now();
                 this._startHeartbeat();
                 this._emitLifecycle('connect');
@@ -135,8 +143,16 @@ class Reachlo {
                         this.reconnecting = true;
                         this._emitLifecycle('reconnecting');
                     }
-                    console.log(`Reachlo: Retrying in ${this.reconnectInterval / 1000}s...`);
-                    this.reconnectTimer = setTimeout(() => this.connect(), this.reconnectInterval);
+                    // Exponential backoff + jitter to prevent reconnection storms
+                    const baseDelay = Math.min(
+                        this.reconnectBaseDelay * Math.pow(2, this._reconnectAttempt),
+                        this.reconnectMaxDelay
+                    );
+                    const jitter = Math.random() * 1000; // 0–1s random jitter
+                    const delay = baseDelay + jitter;
+                    this._reconnectAttempt++;
+                    this._log(`Reachlo: Retrying in ${(delay / 1000).toFixed(1)}s (attempt ${this._reconnectAttempt})...`);
+                    this.reconnectTimer = setTimeout(() => this.connect(), delay);
                 }
             };
 
@@ -204,6 +220,8 @@ class Reachlo {
     disconnect() {
         this.shouldReconnect = false;
         if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+        if (this._batchTimer) clearTimeout(this._batchTimer);
+        this._batchQueue = [];
         this._stopHeartbeat();
 
 
@@ -232,6 +250,14 @@ class Reachlo {
 
     _send(payload) {
         if (this.socket && this.socket.readyState === 1) {
+            // If batching is enabled, queue instead of sending immediately
+            if (this.batchInterval > 0 && payload.type === 'publish') {
+                this._batchQueue.push(payload);
+                if (!this._batchTimer) {
+                    this._batchTimer = setTimeout(() => this._flushBatch(), this.batchInterval);
+                }
+                return true;
+            }
             this.socket.send(JSON.stringify(payload));
             return true;
         } else {
@@ -242,6 +268,18 @@ class Reachlo {
             return false; // Dropped
         }
     }
+
+    _flushBatch() {
+        this._batchTimer = null;
+        if (this._batchQueue.length === 0) return;
+        if (this.socket && this.socket.readyState === 1) {
+            this.socket.send(JSON.stringify({
+                type: 'batch',
+                messages: this._batchQueue
+            }));
+        }
+        this._batchQueue = [];
+    }
 }
 
 class ReachloChannel {

package/package.json

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