@supabase/realtime-js 2.72.1-canary.9 → 2.80.1-canary.1

package/src/RealtimeClient.ts

@@ -69,6 +69,7 @@ export type RealtimeClientOptions = {
   transport?: WebSocketLikeConstructor
   timeout?: number
   heartbeatIntervalMs?: number
+  heartbeatCallback?: (status: HeartbeatStatus) => void
   logger?: Function
   encode?: Function
   decode?: Function
@@ -146,6 +147,7 @@ export default class RealtimeClient {
    * @param options.params The optional params to pass when connecting.
    * @param options.headers Deprecated: headers cannot be set on websocket connections and this option will be removed in the future.
    * @param options.heartbeatIntervalMs The millisec interval to send a heartbeat message.
+   * @param options.heartbeatCallback The optional function to handle heartbeat status.
    * @param options.logger The optional function for specialized logging, ie: logger: (kind, msg, data) => { console.log(`${kind}: ${msg}`, data) }
    * @param options.logLevel Sets the log level for Realtime
    * @param options.encode The function to encode outgoing messages. Defaults to JSON: (payload, callback) => callback(JSON.stringify(payload))
@@ -397,7 +399,11 @@ export default class RealtimeClient {
    */
   async sendHeartbeat() {
     if (!this.isConnected()) {
-      this.heartbeatCallback('disconnected')
+      try {
+        this.heartbeatCallback('disconnected')
+      } catch (e) {
+        this.log('error', 'error in heartbeat callback', e)
+      }
       return
     }
 
@@ -405,7 +411,11 @@ export default class RealtimeClient {
     if (this.pendingHeartbeatRef) {
       this.pendingHeartbeatRef = null
       this.log('transport', 'heartbeat timeout. Attempting to re-establish connection')
-      this.heartbeatCallback('timeout')
+      try {
+        this.heartbeatCallback('timeout')
+      } catch (e) {
+        this.log('error', 'error in heartbeat callback', e)
+      }
 
       // Force reconnection after heartbeat timeout
       this._wasManualDisconnect = false
@@ -427,7 +437,11 @@ export default class RealtimeClient {
       payload: {},
       ref: this.pendingHeartbeatRef,
     })
-    this.heartbeatCallback('sent')
+    try {
+      this.heartbeatCallback('sent')
+    } catch (e) {
+      this.log('error', 'error in heartbeat callback', e)
+    }
 
     this._setAuthSafely('heartbeat')
   }
@@ -518,7 +532,11 @@ export default class RealtimeClient {
     this.decode(rawMessage.data, (msg: RealtimeMessage) => {
       // Handle heartbeat responses
       if (msg.topic === 'phoenix' && msg.event === 'phx_reply') {
-        this.heartbeatCallback(msg.payload.status === 'ok' ? 'ok' : 'error')
+        try {
+          this.heartbeatCallback(msg.payload.status === 'ok' ? 'ok' : 'error')
+        } catch (e) {
+          this.log('error', 'error in heartbeat callback', e)
+        }
       }
 
       // Handle pending heartbeat reference cleanup
@@ -806,7 +824,7 @@ export default class RealtimeClient {
       options?.heartbeatIntervalMs ?? CONNECTION_TIMEOUTS.HEARTBEAT_INTERVAL
     this.worker = options?.worker ?? false
     this.accessToken = options?.accessToken ?? null
-
+    this.heartbeatCallback = options?.heartbeatCallback ?? noop
     // Handle special cases
     if (options?.params) this.params = options.params
     if (options?.logger) this.logger = options.logger

package/src/lib/transformers.ts

@@ -60,11 +60,15 @@ type Record = {
  */
 export const convertChangeData = (
   columns: Columns,
-  record: Record,
+  record: Record | null,
   options: { skipTypes?: string[] } = {}
 ): Record => {
   const skipTypes = options.skipTypes ?? []
 
+  if (!record) {
+    return {}
+  }
+
   return Object.keys(record).reduce((acc, rec_key) => {
     acc[rec_key] = convertColumn(rec_key, columns, record, skipTypes)
     return acc

package/src/lib/version.ts

@@ -4,4 +4,4 @@
 // - Debugging and support (identifying which version is running)
 // - Telemetry and logging (version reporting in errors/analytics)
 // - Ensuring build artifacts match the published package version
-export const version = '2.72.1-canary.9'
+export const version = '2.80.1-canary.1'

package/src/lib/websocket-factory.ts

@@ -73,32 +73,38 @@ export class WebSocketFactory {
       }
     }
 
-    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
-      const nodeVersion = parseInt(process.versions.node.split('.')[0])
-
-      // Node.js 22+ should have native WebSocket
-      if (nodeVersion >= 22) {
-        // Check if native WebSocket is available (should be in Node.js 22+)
-        if (typeof globalThis.WebSocket !== 'undefined') {
-          return { type: 'native', constructor: globalThis.WebSocket }
+    if (typeof process !== 'undefined') {
+      // Use dynamic property access to avoid Next.js Edge Runtime static analysis warnings
+      const processVersions = (process as any)['versions']
+      if (processVersions && processVersions['node']) {
+        // Remove 'v' prefix if present and parse the major version
+        const versionString = processVersions['node']
+        const nodeVersion = parseInt(versionString.replace(/^v/, '').split('.')[0])
+
+        // Node.js 22+ should have native WebSocket
+        if (nodeVersion >= 22) {
+          // Check if native WebSocket is available (should be in Node.js 22+)
+          if (typeof globalThis.WebSocket !== 'undefined') {
+            return { type: 'native', constructor: globalThis.WebSocket }
+          }
+          // If not available, user needs to provide it
+          return {
+            type: 'unsupported',
+            error: `Node.js ${nodeVersion} detected but native WebSocket not found.`,
+            workaround: 'Provide a WebSocket implementation via the transport option.',
+          }
         }
-        // If not available, user needs to provide it
+
+        // Node.js < 22 doesn't have native WebSocket
         return {
           type: 'unsupported',
-          error: `Node.js ${nodeVersion} detected but native WebSocket not found.`,
-          workaround: 'Provide a WebSocket implementation via the transport option.',
+          error: `Node.js ${nodeVersion} detected without native WebSocket support.`,
+          workaround:
+            'For Node.js < 22, install "ws" package and provide it via the transport option:\n' +
+            'import ws from "ws"\n' +
+            'new RealtimeClient(url, { transport: ws })',
         }
       }
-
-      // Node.js < 22 doesn't have native WebSocket
-      return {
-        type: 'unsupported',
-        error: `Node.js ${nodeVersion} detected without native WebSocket support.`,
-        workaround:
-          'For Node.js < 22, install "ws" package and provide it via the transport option:\n' +
-          'import ws from "ws"\n' +
-          'new RealtimeClient(url, { transport: ws })',
-      }
     }
 
     return {