@supabase/realtime-js 2.71.2-canary.7 → 2.72.1-canary.0

package/dist/module/lib/websocket-factory.js

@@ -27,29 +27,35 @@ export class WebSocketFactory {
                 workaround: 'Use serverless functions or a different deployment target for WebSocket functionality.',
             };
         }
-        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['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 {
             type: 'unsupported',

package/dist/module/lib/websocket-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket-factory.js","sourceRoot":"","sources":["../../../src/lib/websocket-factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"websocket-factory.js","sourceRoot":"","sources":["../../../src/lib/websocket-factory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supabase/realtime-js",
-  "version": "2.71.2-canary.7",
+  "version": "2.72.1-canary.0",
   "description": "Listen to realtime updates to your PostgreSQL database",
   "keywords": [
     "realtime",
@@ -11,8 +11,8 @@
     "firebase",
     "supabase"
   ],
-  "homepage": "https://github.com/supabase/supabase-js-libs/tree/main/packages/core/realtime-js",
-  "bugs": "https://github.com/supabase/supabase-js-libs/issues",
+  "homepage": "https://github.com/supabase/js-client-libs/tree/main/packages/core/realtime-js",
+  "bugs": "https://github.com/supabase/js-client-libs/issues",
   "files": [
     "dist",
     "src"
@@ -22,7 +22,7 @@
   "types": "dist/module/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "https://github.com/supabase/supabase-js-libs.git",
+    "url": "https://github.com/supabase/js-client-libs.git",
     "directory": "packages/core/realtime-js"
   },
   "author": "Supabase",
@@ -35,13 +35,11 @@
     "build:module": "tsc -p tsconfig.module.json",
     "test": "vitest run",
     "test:watch": "vitest",
-    "coverage": "vitest run --coverage",
-    "coverage:text": "vitest run --coverage.enabled true --coverage.reporter=text",
+    "test:coverage": "vitest run --coverage.enabled true --coverage.reporter=text",
     "docs": "typedoc src/index.ts --out docs/v2",
     "docs:json": "typedoc --json docs/v2/spec.json --excludeExternals src/index.ts",
     "check-exports": "attw --pack .",
-    "ci": "npm run test && npm run coverage",
-    "test:ci": "npm run test && npm run coverage"
+    "test:ci": "vitest run --coverage"
   },
   "dependencies": {
     "@types/phoenix": "^1.6.6",

package/src/RealtimeChannel.ts

@@ -221,8 +221,9 @@ export default class RealtimeChannel {
       const postgres_changes = this.bindings.postgres_changes?.map((r) => r.filter) ?? []
 
       const presence_enabled =
-        !!this.bindings[REALTIME_LISTEN_TYPES.PRESENCE] &&
-        this.bindings[REALTIME_LISTEN_TYPES.PRESENCE].length > 0
+        (!!this.bindings[REALTIME_LISTEN_TYPES.PRESENCE] &&
+          this.bindings[REALTIME_LISTEN_TYPES.PRESENCE].length > 0) ||
+        this.params.config.presence?.enabled === true
       const accessTokenPayload: { access_token?: string } = {}
       const config = {
         broadcast,

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

@@ -1 +1,7 @@
-export const version = '0.0.0-automated'
+// Generated automatically during releases by scripts/update-version-files.ts
+// This file provides runtime access to the package version for:
+// - HTTP request headers (e.g., X-Client-Info header for API requests)
+// - 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.0'

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 {