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

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 E;((w)=>{w.DISCONNECTED="disconnected";w.CONNECTING="connecting";w.CONNECTED="connected";w.RECONNECTING="reconnecting"})(E||={});class F{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:10,pingTimeout:90000};constructor(f={}){this.options={...this.options,...f}}connect(){return new Promise((f,k)=>{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,f()},this.ws.onmessage=(w)=>{try{let z=JSON.parse(w.data);if(z.type==="ping"){this.lastPingTime=Date.now(),this.ws?.send(JSON.stringify({type:"pong",timestamp:Date.now(),respondingTo:z.timestamp}));return}if(z.type==="established"){this.clientId=z.clientId,this.serverVersion=z.version;let D=(()=>{let B=new URL(q);if(B.searchParams.has("token"))B.searchParams.set("token","***");return B.toString()})();if(console.log(`Welcome to LAPLACE Event Bridge ${`v${z.version}`||"(unknown version)"}: ${D} with client ID ${this.clientId||"unknown"}`),this.shouldMonitorPing())this.startPingMonitoring()}this.processEvent(z)}catch(z){console.error("Failed to parse event data:",z)}},this.ws.onerror=(w)=>{console.error("WebSocket error:",w),k(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"),k(q)}})}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(f,k){if(!this.eventHandlers.has(f))this.eventHandlers.set(f,[]);this.eventHandlers.get(f).push(k)}onAny(f){this.anyEventHandlers.push(f)}onConnectionStateChange(f){this.connectionStateHandlers.push(f),f(this.connectionState)}off(f,k){if(!this.eventHandlers.has(f))return;let q=this.eventHandlers.get(f),A=q.indexOf(k);if(A!==-1)q.splice(A,1);if(q.length===0)this.eventHandlers.delete(f)}offAny(f){let k=this.anyEventHandlers.indexOf(f);if(k!==-1)this.anyEventHandlers.splice(k,1)}offConnectionStateChange(f){let k=this.connectionStateHandlers.indexOf(f);if(k!==-1)this.connectionStateHandlers.splice(k,1)}isConnectedToBridge(){return this.connectionState==="connected"}getConnectionState(){return this.connectionState}getClientId(){return this.clientId}send(f){if(!this.ws||this.ws.readyState!==WebSocket.OPEN)throw new Error("Not connected to LAPLACE Event Bridge");this.ws.send(JSON.stringify(f))}setConnectionState(f){if(this.connectionState!==f){this.connectionState=f;for(let k of this.connectionStateHandlers)try{k(f)}catch(q){console.error("Error in connection state change handler:",q)}}}processEvent(f){if(this.eventHandlers.has(f.type))for(let k of this.eventHandlers.get(f.type))try{k(f)}catch(q){console.error(`Error in event handler for type ${f.type}:`,q)}for(let k of this.anyEventHandlers)try{k(f)}catch(q){console.error("Error in any event handler:",q)}}shouldMonitorPing(){if(!this.serverVersion)return!1;let f=this.serverVersion.split(".").map((w)=>parseInt(w,10));if(f.length<3||f.some(isNaN))return console.warn(`Invalid server version format: ${this.serverVersion}`),!1;let k=f[0],q=f[1],A=f[2];if(k>4)return!0;if(k===4){if(q>0)return!0;if(q===0&&A>=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 f=Date.now()-this.lastPingTime;if(f>this.options.pingTimeout){if(console.warn(`Ping timeout detected (${f}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{F as LaplaceEventBridgeClient,E as ConnectionState};

package/index.ts

@@ -45,6 +45,14 @@ export interface ConnectionOptions {
    * @default 10
    */
   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,10 +60,13 @@ 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',
@@ -63,6 +74,7 @@ export class LaplaceEventBridgeClient {
     reconnect: true,
     reconnectInterval: 3000,
     maxReconnectAttempts: 10,
+    pingTimeout: 90000, // 90 seconds
   }
 
   constructor(options: ConnectionOptions = {}) {
@@ -99,17 +111,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 +120,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 +135,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
@@ -159,7 +181,7 @@ export class LaplaceEventBridgeClient {
               this.connect().catch(err => {
                 console.error('Reconnection failed:', err)
               })
-            }, this.options.reconnectInterval) as unknown as number
+            }, this.options.reconnectInterval)
           } else {
             this.setConnectionState(ConnectionState.DISCONNECTED)
           }
@@ -180,6 +202,8 @@ export class LaplaceEventBridgeClient {
       this.reconnectTimer = null
     }
 
+    this.stopPingMonitoring()
+
     if (this.ws) {
       this.ws.close()
       this.ws = null
@@ -187,6 +211,8 @@ export class LaplaceEventBridgeClient {
 
     this.setConnectionState(ConnectionState.DISCONNECTED)
     this.clientId = null
+    this.serverVersion = null
+    this.lastPingTime = null
   }
 
   /**
@@ -332,4 +358,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.2",
   "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"
   }