@laplace.live/event-bridge-sdk 1.0.1 → 1.0.3

package/README.md

@@ -78,7 +78,7 @@ interface ConnectionOptions {
   token?: string // Authentication token, default: ''
   reconnect?: boolean // Auto reconnect on disconnect, default: true
   reconnectInterval?: number // Milliseconds between reconnect attempts, default: 3000
-  maxReconnectAttempts?: number // Maximum reconnect attempts, default: 10
+  maxReconnectAttempts?: number // Maximum reconnect attempts, default: 1000
 }
 ```
 

package/dist/index.js

@@ -1 +1 @@
-var B;((w)=>{w.DISCONNECTED="disconnected";w.CONNECTING="connecting";w.CONNECTED="connected";w.RECONNECTING="reconnecting"})(B||={});class D{ws=null;eventHandlers=new Map;anyEventHandlers=[];connectionStateHandlers=[];reconnectTimer=null;reconnectAttempts=0;clientId=null;connectionState="disconnected";options={url:"ws://localhost:9696",token:"",reconnect:!0,reconnectInterval:3000,maxReconnectAttempts:10};constructor(k={}){this.options={...this.options,...k}}connect(){return new Promise((k,m)=>{try{if(this.ws)this.ws.close();this.setConnectionState("connecting");let q=this.options.url,A=[];if(this.options.token){A.push("laplace-event-bridge-role-client",this.options.token);let w=new URL(q);w.searchParams.set("token",this.options.token),q=w.toString()}this.ws=new WebSocket(q,A),this.ws.onopen=()=>{this.setConnectionState("connected"),this.reconnectAttempts=0;let w=(()=>{let z=new URL(q);if(z.searchParams.has("token"))z.searchParams.set("token","***");return z.toString()})();console.log(`Connected to LAPLACE Event Bridge: ${w}`),k()},this.ws.onmessage=(w)=>{try{let z=JSON.parse(w.data);if(z.type==="ping"){this.ws?.send(JSON.stringify({type:"pong",timestamp:Date.now(),respondingTo:z.timestamp}));return}if(z.type==="established"&&z.clientId)this.clientId=z.clientId,console.log(`Connection established with client ID: ${this.clientId}`);this.processEvent(z)}catch(z){console.error("Failed to parse event data:",z)}},this.ws.onerror=(w)=>{console.error("WebSocket error:",w),m(w)},this.ws.onclose=()=>{if(console.log("Disconnected from LAPLACE Event Bridge"),this.options.reconnect&&this.reconnectAttempts<this.options.maxReconnectAttempts)this.reconnectAttempts++,this.setConnectionState("reconnecting"),console.log(`Attempting to reconnect (${this.reconnectAttempts}/${this.options.maxReconnectAttempts})...`),this.reconnectTimer=setTimeout(()=>{this.connect().catch((w)=>{console.error("Reconnection failed:",w)})},this.options.reconnectInterval);else this.setConnectionState("disconnected")}}catch(q){this.setConnectionState("disconnected"),m(q)}})}disconnect(){if(this.reconnectTimer)clearTimeout(this.reconnectTimer),this.reconnectTimer=null;if(this.ws)this.ws.close(),this.ws=null;this.setConnectionState("disconnected"),this.clientId=null}on(k,m){if(!this.eventHandlers.has(k))this.eventHandlers.set(k,[]);this.eventHandlers.get(k).push(m)}onAny(k){this.anyEventHandlers.push(k)}onConnectionStateChange(k){this.connectionStateHandlers.push(k),k(this.connectionState)}off(k,m){if(!this.eventHandlers.has(k))return;let q=this.eventHandlers.get(k),A=q.indexOf(m);if(A!==-1)q.splice(A,1);if(q.length===0)this.eventHandlers.delete(k)}offAny(k){let m=this.anyEventHandlers.indexOf(k);if(m!==-1)this.anyEventHandlers.splice(m,1)}offConnectionStateChange(k){let m=this.connectionStateHandlers.indexOf(k);if(m!==-1)this.connectionStateHandlers.splice(m,1)}isConnectedToBridge(){return this.connectionState==="connected"}getConnectionState(){return this.connectionState}getClientId(){return this.clientId}send(k){if(!this.ws||this.ws.readyState!==WebSocket.OPEN)throw new Error("Not connected to LAPLACE Event Bridge");this.ws.send(JSON.stringify(k))}setConnectionState(k){if(this.connectionState!==k){this.connectionState=k;for(let m of this.connectionStateHandlers)try{m(k)}catch(q){console.error("Error in connection state change handler:",q)}}}processEvent(k){if(this.eventHandlers.has(k.type))for(let m of this.eventHandlers.get(k.type))try{m(k)}catch(q){console.error(`Error in event handler for type ${k.type}:`,q)}for(let m of this.anyEventHandlers)try{m(k)}catch(q){console.error("Error in any event handler:",q)}}}export{D as LaplaceEventBridgeClient,B as ConnectionState};
+var K;((A)=>{A.DISCONNECTED="disconnected";A.CONNECTING="connecting";A.CONNECTED="connected";A.RECONNECTING="reconnecting"})(K||={});class N{ws=null;eventHandlers=new Map;anyEventHandlers=[];connectionStateHandlers=[];reconnectTimer=null;reconnectAttempts=0;clientId=null;serverVersion=null;connectionState="disconnected";lastPingTime=null;pingMonitorTimer=null;options={url:"ws://localhost:9696",token:"",reconnect:!0,reconnectInterval:3000,maxReconnectAttempts:1000,pingTimeout:90000};constructor(q={}){this.options={...this.options,...q}}connect(){return new Promise((q,w)=>{try{if(this.ws)this.ws.close();this.setConnectionState("connecting");let z=this.options.url,E=[];if(this.options.token){E.push("laplace-event-bridge-role-client",this.options.token);let A=new URL(z);A.searchParams.set("token",this.options.token),z=A.toString()}this.ws=new WebSocket(z,E),this.ws.onopen=()=>{this.setConnectionState("connected"),this.reconnectAttempts=0,q()},this.ws.onmessage=(A)=>{try{let B=JSON.parse(A.data);if(B.type==="ping"){this.lastPingTime=Date.now(),this.ws?.send(JSON.stringify({type:"pong",timestamp:Date.now(),respondingTo:B.timestamp}));return}if(B.type==="established"){this.clientId=B.clientId,this.serverVersion=B.version;let G=(()=>{let F=new URL(z);if(F.searchParams.has("token"))F.searchParams.set("token","***");return F.toString()})();if(console.log(`Welcome to LAPLACE Event Bridge ${`v${B.version}`||"(unknown version)"}: ${G} with client ID ${this.clientId||"unknown"}`),this.shouldMonitorPing())this.startPingMonitoring()}this.processEvent(B)}catch(B){console.error("Failed to parse event data:",B)}},this.ws.onerror=(A)=>{console.error("WebSocket error:",A),w(A)},this.ws.onclose=()=>{if(console.log("Disconnected from LAPLACE Event Bridge"),this.stopPingMonitoring(),this.lastPingTime=null,this.options.reconnect&&this.reconnectAttempts<this.options.maxReconnectAttempts){this.reconnectAttempts++,this.setConnectionState("reconnecting");let A=this.options.reconnectInterval,B=1.5,G=60000,F=Math.min(A*Math.pow(B,this.reconnectAttempts-1),G),H=Math.round(F);console.log(`Attempting to reconnect (${this.reconnectAttempts}/${this.options.maxReconnectAttempts}) in ${H}ms...`),this.reconnectTimer=setTimeout(()=>{this.connect().catch((J)=>{console.error("Reconnection failed:",J)})},H)}else this.setConnectionState("disconnected")}}catch(z){this.setConnectionState("disconnected"),w(z)}})}disconnect(){if(this.reconnectTimer)clearTimeout(this.reconnectTimer),this.reconnectTimer=null;if(this.stopPingMonitoring(),this.ws)this.ws.close(),this.ws=null;this.setConnectionState("disconnected"),this.clientId=null,this.serverVersion=null,this.lastPingTime=null}on(q,w){if(!this.eventHandlers.has(q))this.eventHandlers.set(q,[]);this.eventHandlers.get(q).push(w)}onAny(q){this.anyEventHandlers.push(q)}onConnectionStateChange(q){this.connectionStateHandlers.push(q),q(this.connectionState)}off(q,w){if(!this.eventHandlers.has(q))return;let z=this.eventHandlers.get(q),E=z.indexOf(w);if(E!==-1)z.splice(E,1);if(z.length===0)this.eventHandlers.delete(q)}offAny(q){let w=this.anyEventHandlers.indexOf(q);if(w!==-1)this.anyEventHandlers.splice(w,1)}offConnectionStateChange(q){let w=this.connectionStateHandlers.indexOf(q);if(w!==-1)this.connectionStateHandlers.splice(w,1)}isConnectedToBridge(){return this.connectionState==="connected"}getConnectionState(){return this.connectionState}getClientId(){return this.clientId}send(q){if(!this.ws||this.ws.readyState!==WebSocket.OPEN)throw new Error("Not connected to LAPLACE Event Bridge");this.ws.send(JSON.stringify(q))}setConnectionState(q){if(this.connectionState!==q){this.connectionState=q;for(let w of this.connectionStateHandlers)try{w(q)}catch(z){console.error("Error in connection state change handler:",z)}}}processEvent(q){if(this.eventHandlers.has(q.type))for(let w of this.eventHandlers.get(q.type))try{w(q)}catch(z){console.error(`Error in event handler for type ${q.type}:`,z)}for(let w of this.anyEventHandlers)try{w(q)}catch(z){console.error("Error in any event handler:",z)}}shouldMonitorPing(){if(!this.serverVersion)return!1;let q=this.serverVersion.split(".").map((A)=>parseInt(A,10));if(q.length<3||q.some(isNaN))return console.warn(`Invalid server version format: ${this.serverVersion}`),!1;let w=q[0],z=q[1],E=q[2];if(w>4)return!0;if(w===4){if(z>0)return!0;if(z===0&&E>=3)return!0}return!1}startPingMonitoring(){this.stopPingMonitoring(),console.log(`Ping monitoring enabled (timeout: ${this.options.pingTimeout}ms)`),this.lastPingTime=Date.now(),this.pingMonitorTimer=setInterval(()=>{if(!this.lastPingTime)return;let q=Date.now()-this.lastPingTime;if(q>this.options.pingTimeout){if(console.warn(`Ping timeout detected (${q}ms since last ping). Reconnecting...`),this.stopPingMonitoring(),this.ws)this.ws.close()}},this.options.pingTimeout/3)}stopPingMonitoring(){if(this.pingMonitorTimer)clearInterval(this.pingMonitorTimer),this.pingMonitorTimer=null}}export{N as LaplaceEventBridgeClient,K as ConnectionState};

package/index.ts

@@ -34,17 +34,34 @@ export interface ConnectionOptions {
    */
   reconnect?: boolean
   /**
-   * The interval between reconnect attempts in milliseconds
+   * The base interval between reconnect attempts in milliseconds.
+   * With exponential backoff, each attempt multiplies this by 1.5^(attempt-1).
+   * The maximum interval is capped at 60 seconds.
    *
    * @default 3000
+   * @example
+   * // With base interval of 3000ms:
+   * // Attempt 1: 3000ms
+   * // Attempt 2: 4500ms
+   * // Attempt 3: 6750ms
+   * // ...
+   * // Capped at: 60000ms
    */
   reconnectInterval?: number
   /**
    * The maximum number of reconnect attempts
    *
-   * @default 10
+   * @default 1000
    */
   maxReconnectAttempts?: number
+  /**
+   * The timeout for ping heartbeat in milliseconds
+   * If no ping is received within this time, the connection is considered dead
+   * Only applies to server versions >= 4.0.2
+   *
+   * @default 90000 (90 seconds)
+   */
+  pingTimeout?: number
 }
 
 export class LaplaceEventBridgeClient {
@@ -52,17 +69,21 @@ export class LaplaceEventBridgeClient {
   private eventHandlers = new Map<string, EventHandler<any>[]>()
   private anyEventHandlers: AnyEventHandler[] = []
   private connectionStateHandlers: ConnectionStateChangeHandler[] = []
-  private reconnectTimer: number | null = null
+  private reconnectTimer: ReturnType<typeof setTimeout> | null = null
   private reconnectAttempts = 0
   private clientId: string | null = null
+  private serverVersion: string | null = null
   private connectionState: ConnectionState = ConnectionState.DISCONNECTED
+  private lastPingTime: number | null = null
+  private pingMonitorTimer: ReturnType<typeof setInterval> | null = null
 
   private options: Required<ConnectionOptions> = {
     url: 'ws://localhost:9696',
     token: '',
     reconnect: true,
     reconnectInterval: 3000,
-    maxReconnectAttempts: 10,
+    maxReconnectAttempts: 1000,
+    pingTimeout: 90000, // 90 seconds
   }
 
   constructor(options: ConnectionOptions = {}) {
@@ -99,17 +120,6 @@ export class LaplaceEventBridgeClient {
         this.ws.onopen = () => {
           this.setConnectionState(ConnectionState.CONNECTED)
           this.reconnectAttempts = 0
-
-          // Create a display URL that masks the token if present
-          const displayUrl = (() => {
-            const urlObj = new URL(url)
-            if (urlObj.searchParams.has('token')) {
-              urlObj.searchParams.set('token', '***')
-            }
-            return urlObj.toString()
-          })()
-
-          console.log(`Connected to LAPLACE Event Bridge: ${displayUrl}`)
           resolve()
         }
 
@@ -119,6 +129,9 @@ export class LaplaceEventBridgeClient {
 
             // Handle ping from server
             if (data.type === 'ping') {
+              // Track last ping time
+              this.lastPingTime = Date.now()
+
               // Respond with pong
               this.ws?.send(
                 JSON.stringify({
@@ -131,9 +144,27 @@ export class LaplaceEventBridgeClient {
             }
 
             // Store client ID from the established message
-            if (data.type === 'established' && data.clientId) {
+            if (data.type === 'established') {
               this.clientId = data.clientId
-              console.log(`Connection established with client ID: ${this.clientId}`)
+              this.serverVersion = data.version
+
+              // Create a display URL that masks the token if present
+              const displayUrl = (() => {
+                const urlObj = new URL(url)
+                if (urlObj.searchParams.has('token')) {
+                  urlObj.searchParams.set('token', '***')
+                }
+                return urlObj.toString()
+              })()
+
+              console.log(
+                `Welcome to LAPLACE Event Bridge ${`v${data.version}` || '(unknown version)'}: ${displayUrl} with client ID ${this.clientId || 'unknown'}`
+              )
+
+              // Start ping monitoring if server version supports it (>= 4.0.2)
+              if (this.shouldMonitorPing()) {
+                this.startPingMonitoring()
+              }
             }
 
             // Process the event
@@ -151,15 +182,36 @@ export class LaplaceEventBridgeClient {
         this.ws.onclose = () => {
           console.log('Disconnected from LAPLACE Event Bridge')
 
+          // Stop ping monitoring before attempting reconnection
+          this.stopPingMonitoring()
+
+          // Clear ping state
+          this.lastPingTime = null
+
           if (this.options.reconnect && this.reconnectAttempts < this.options.maxReconnectAttempts) {
             this.reconnectAttempts++
             this.setConnectionState(ConnectionState.RECONNECTING)
-            console.log(`Attempting to reconnect (${this.reconnectAttempts}/${this.options.maxReconnectAttempts})...`)
+
+            // Calculate exponential backoff with cap at 60 seconds
+            const baseInterval = this.options.reconnectInterval
+            const backoffMultiplier = 1.5 // Increase by 50% each time
+            const maxInterval = 60000 // 60 seconds cap
+
+            // Calculate delay: base * (multiplier ^ (attempt - 1))
+            const calculatedDelay = Math.min(
+              baseInterval * Math.pow(backoffMultiplier, this.reconnectAttempts - 1),
+              maxInterval
+            )
+            const delay = Math.round(calculatedDelay)
+
+            console.log(
+              `Attempting to reconnect (${this.reconnectAttempts}/${this.options.maxReconnectAttempts}) in ${delay}ms...`
+            )
             this.reconnectTimer = setTimeout(() => {
               this.connect().catch(err => {
                 console.error('Reconnection failed:', err)
               })
-            }, this.options.reconnectInterval) as unknown as number
+            }, delay)
           } else {
             this.setConnectionState(ConnectionState.DISCONNECTED)
           }
@@ -180,6 +232,8 @@ export class LaplaceEventBridgeClient {
       this.reconnectTimer = null
     }
 
+    this.stopPingMonitoring()
+
     if (this.ws) {
       this.ws.close()
       this.ws = null
@@ -187,6 +241,8 @@ export class LaplaceEventBridgeClient {
 
     this.setConnectionState(ConnectionState.DISCONNECTED)
     this.clientId = null
+    this.serverVersion = null
+    this.lastPingTime = null
   }
 
   /**
@@ -332,4 +388,79 @@ export class LaplaceEventBridgeClient {
       }
     }
   }
+
+  /**
+   * Check if ping monitoring should be enabled based on server version
+   */
+  private shouldMonitorPing(): boolean {
+    if (!this.serverVersion) {
+      return false
+    }
+
+    // Parse version (e.g., "4.0.2" -> [4, 0, 2])
+    const versionParts = this.serverVersion.split('.').map(part => parseInt(part, 10))
+
+    // Ensure we have at least 3 version parts
+    if (versionParts.length < 3 || versionParts.some(isNaN)) {
+      console.warn(`Invalid server version format: ${this.serverVersion}`)
+      return false
+    }
+
+    const major = versionParts[0]!
+    const minor = versionParts[1]!
+    const patch = versionParts[2]!
+
+    // Check if version is >= 4.0.3
+    if (major > 4) return true
+    if (major === 4) {
+      if (minor > 0) return true
+      if (minor === 0 && patch >= 3) return true
+    }
+
+    return false
+  }
+
+  /**
+   * Start monitoring ping messages from the server
+   */
+  private startPingMonitoring(): void {
+    // Stop any existing monitoring
+    this.stopPingMonitoring()
+
+    console.log(`Ping monitoring enabled (timeout: ${this.options.pingTimeout}ms)`)
+
+    // Set initial ping time
+    this.lastPingTime = Date.now()
+
+    // Start monitoring
+    this.pingMonitorTimer = setInterval(() => {
+      if (!this.lastPingTime) {
+        return
+      }
+
+      const timeSinceLastPing = Date.now() - this.lastPingTime
+
+      if (timeSinceLastPing > this.options.pingTimeout) {
+        console.warn(`Ping timeout detected (${timeSinceLastPing}ms since last ping). Reconnecting...`)
+
+        // Stop monitoring
+        this.stopPingMonitoring()
+
+        // Force reconnection
+        if (this.ws) {
+          this.ws.close()
+        }
+      }
+    }, this.options.pingTimeout / 3) // Check 3 times within the timeout period
+  }
+
+  /**
+   * Stop monitoring ping messages
+   */
+  private stopPingMonitoring(): void {
+    if (this.pingMonitorTimer) {
+      clearInterval(this.pingMonitorTimer)
+      this.pingMonitorTimer = null
+    }
+  }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@laplace.live/event-bridge-sdk",
   "description": "LAPLACE Event Bridge SDK",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "module": "index.ts",
   "types": "index.ts",
   "license": "MIT",
@@ -24,9 +24,6 @@
   "dependencies": {
     "@laplace.live/event-types": "^2.0.12"
   },
-  "peerDependencies": {
-    "@laplace.live/event-types": "^2.0.4"
-  },
   "devDependencies": {
     "bun-types": "latest"
   }