@prsm/realtime 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prsm/realtime",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Distributed WebSocket framework with Redis-backed rooms, records, presence, channels, collections, and persistence",
   "type": "module",
   "license": "ISC",
@@ -20,6 +20,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@prsm/log": "^1.0.1",
     "eventemitter3": "^5.0.1",
     "fast-json-patch": "^3.1.1",
     "ioredis": "^5.6.1",

package/src/adapters/postgres.js

@@ -49,7 +49,7 @@ export function createPostgresAdapter(options = {}) {
         await createTables()
         initialized = true
       } catch (err) {
-        serverLogger.error("Error initializing PostgreSQL database:", err)
+        serverLogger.error("error initializing postgresql database", { err })
         throw err
       }
     },

package/src/client/client.js

@@ -1,6 +1,6 @@
 import { EventEmitter } from "eventemitter3"
 import { Connection } from "./connection.js"
-import { clientLogger, CodeError, LogLevel, Status } from "../shared/index.js"
+import { clientLogger, configureLogLevel, CodeError, LogLevel, Status } from "../shared/index.js"
 import { createRecordSubscriptions } from "./subscriptions/records.js"
 import { createChannelSubscriptions } from "./subscriptions/channels.js"
 import { createPresenceSubscriptions } from "./subscriptions/presence.js"
@@ -43,7 +43,7 @@ export class RealtimeClient extends EventEmitter {
       logLevel: opts.logLevel ?? LogLevel.ERROR,
     }
 
-    clientLogger.configure({ level: this.options.logLevel, styling: true })
+    configureLogLevel(this.options.logLevel)
 
     this.recordSubscriptions = new Map()
     this.collectionSubscriptions = new Map()
@@ -175,7 +175,7 @@ export class RealtimeClient extends EventEmitter {
       const result = await this.command("rt/get-my-connection-metadata")
       return result.metadata
     } catch (error) {
-      clientLogger.error(`Failed to get metadata for connection:`, error)
+      clientLogger.error("failed to get metadata for connection", { err: error })
       return null
     }
   }
@@ -190,7 +190,7 @@ export class RealtimeClient extends EventEmitter {
       const result = await this.command("rt/set-my-connection-metadata", { metadata, options })
       return result.success
     } catch (error) {
-      clientLogger.error(`Failed to set metadata for connection:`, error)
+      clientLogger.error("failed to set metadata for connection", { err: error })
       return false
     }
   }
@@ -239,8 +239,8 @@ export class RealtimeClient extends EventEmitter {
             if (eventName === "visibilitychange" && doc.visibilityState === "visible") {
               if (this._status === Status.OFFLINE) return
               this.command("rt/noop", {}, 5000)
-                .then(() => { clientLogger.info("Tab visible, connection ok"); this.emit("republish") })
-                .catch(() => { clientLogger.info("Tab visible, forcing reconnect"); this._forceReconnect() })
+                .then(() => { clientLogger.info("tab visible, connection ok"); this.emit("republish") })
+                .catch(() => { clientLogger.info("tab visible, forcing reconnect"); this._forceReconnect() })
             }
           })
         })
@@ -254,7 +254,7 @@ export class RealtimeClient extends EventEmitter {
     const timeSinceActivity = now - this._lastActivityTime
     if (timeSinceActivity > this.options.pingTimeout && this._status === Status.ONLINE) {
       this.command("rt/noop", {}, 5000).catch(() => {
-        clientLogger.info(`No activity for ${timeSinceActivity}ms, forcing reconnect`)
+        clientLogger.info("no activity, forcing reconnect", { timeSinceActivity })
         this._forceReconnect()
       })
     }
@@ -325,7 +325,7 @@ export class RealtimeClient extends EventEmitter {
     this.missedPings++
     if (this.missedPings > this.options.maxMissedPings) {
       if (this.options.shouldReconnect) {
-        clientLogger.warn(`Missed ${this.missedPings} pings, reconnecting...`)
+        clientLogger.warn("missed pings, reconnecting", { missedPings: this.missedPings })
         this.reconnect()
       }
     } else {
@@ -418,7 +418,7 @@ export class RealtimeClient extends EventEmitter {
   }
 
   async _resubscribeAll() {
-    clientLogger.info("Resubscribing to all subscriptions after reconnect")
+    clientLogger.info("resubscribing to all subscriptions after reconnect")
     try {
       const successfulRooms = await this._rooms.resubscribe()
       await Promise.allSettled([
@@ -430,12 +430,12 @@ export class RealtimeClient extends EventEmitter {
       if (successfulRooms.length > 0) {
         for (const roomName of successfulRooms) {
           try { await this._presence.forceUpdate(roomName) }
-          catch (err) { clientLogger.error(`Error refreshing presence for room ${roomName}:`, err) }
+          catch (err) { clientLogger.error("error refreshing presence for room", { roomName, err }) }
           await new Promise((resolve) => setTimeout(resolve, 50))
         }
       }
     } catch (error) {
-      clientLogger.error("Error during resubscription:", error)
+      clientLogger.error("error during resubscription", { err: error })
     }
   }
 }

package/src/client/subscriptions/channels.js

@@ -10,7 +10,7 @@ export function createChannelSubscriptions(client) {
       try {
         await subscription.callback(message)
       } catch (error) {
-        clientLogger.error(`Error in channel callback for ${channel}:`, error)
+        clientLogger.error("error in channel callback", { channel, err: error })
       }
     }
   }
@@ -57,7 +57,7 @@ export function createChannelSubscriptions(client) {
       })
       return { success: result.success, history: result.history || [] }
     } catch (error) {
-      clientLogger.error(`Failed to get history for channel ${channel}:`, error)
+      clientLogger.error("failed to get history for channel", { channel, err: error })
       return { success: false, history: [] }
     }
   }
@@ -68,7 +68,7 @@ export function createChannelSubscriptions(client) {
         await subscribe(channel, callback, { historyLimit })
         return true
       } catch (error) {
-        clientLogger.error(`Failed to resubscribe to channel ${channel}:`, error)
+        clientLogger.error("failed to resubscribe to channel", { channel, err: error })
         return false
       }
     })

package/src/client/subscriptions/collections.js

@@ -9,9 +9,7 @@ export function createCollectionSubscriptions(client) {
     if (!subscription) return
 
     if (version !== subscription.version + 1) {
-      clientLogger.warn(
-        `Desync detected for collection ${collectionId}. Expected version ${subscription.version + 1}, got ${version}. Resubscribing.`
-      )
+      clientLogger.warn("desync detected for collection, resubscribing", { collectionId, expected: subscription.version + 1, got: version })
       await unsubscribe(collectionId)
       await subscribe(collectionId, { onDiff: subscription.onDiff })
       return
@@ -30,7 +28,7 @@ export function createCollectionSubscriptions(client) {
           version,
         })
       } catch (error) {
-        clientLogger.error(`Error in collection diff callback for ${collectionId}:`, error)
+        clientLogger.error("error in collection diff callback", { collectionId, err: error })
       }
     }
   }
@@ -53,13 +51,13 @@ export function createCollectionSubscriptions(client) {
           try {
             await options.onDiff({ added: result.records, removed: [], changed: [], version: result.version })
           } catch (error) {
-            clientLogger.error(`Error in initial collection diff callback for ${collectionId}:`, error)
+            clientLogger.error("error in initial collection diff callback", { collectionId, err: error })
           }
         }
       }
       return { success: result.success, ids: result.ids || [], records: result.records || [], version: result.version || 0 }
     } catch (error) {
-      clientLogger.error(`Failed to subscribe to collection ${collectionId}:`, error)
+      clientLogger.error("failed to subscribe to collection", { collectionId, err: error })
       return { success: false, ids: [], records: [], version: 0 }
     }
   }
@@ -74,7 +72,7 @@ export function createCollectionSubscriptions(client) {
       if (success) subscriptions.delete(collectionId)
       return success
     } catch (error) {
-      clientLogger.error(`Failed to unsubscribe from collection ${collectionId}:`, error)
+      clientLogger.error("failed to unsubscribe from collection", { collectionId, err: error })
       return false
     }
   }
@@ -85,7 +83,7 @@ export function createCollectionSubscriptions(client) {
         await subscribe(collectionId, { onDiff: subscription.onDiff })
         return true
       } catch (error) {
-        clientLogger.error(`Failed to resubscribe to collection ${collectionId}:`, error)
+        clientLogger.error("failed to resubscribe to collection", { collectionId, err: error })
         return false
       }
     })

package/src/client/subscriptions/presence.js

@@ -23,7 +23,7 @@ export function createPresenceSubscriptions(client) {
       }
       return { success: result.success, present: result.present || [], states: result.states || {} }
     } catch (error) {
-      clientLogger.error(`Failed to subscribe to presence for room ${roomName}:`, error)
+      clientLogger.error("failed to subscribe to presence for room", { roomName, err: error })
       return { success: false, present: [] }
     }
   }
@@ -38,7 +38,7 @@ export function createPresenceSubscriptions(client) {
       if (success) subscriptions.delete(roomName)
       return success
     } catch (error) {
-      clientLogger.error(`Failed to unsubscribe from presence for room ${roomName}:`, error)
+      clientLogger.error("failed to unsubscribe from presence for room", { roomName, err: error })
       return false
     }
   }
@@ -57,7 +57,7 @@ export function createPresenceSubscriptions(client) {
         silent: options.silent,
       })
     } catch (error) {
-      clientLogger.error(`Failed to publish presence state for room ${roomName}:`, error)
+      clientLogger.error("failed to publish presence state for room", { roomName, err: error })
       return false
     }
   }
@@ -70,7 +70,7 @@ export function createPresenceSubscriptions(client) {
     try {
       return await client.command("rt/clear-presence-state", { roomName })
     } catch (error) {
-      clientLogger.error(`Failed to clear presence state for room ${roomName}:`, error)
+      clientLogger.error("failed to clear presence state for room", { roomName, err: error })
       return false
     }
   }
@@ -80,7 +80,7 @@ export function createPresenceSubscriptions(client) {
       const handler = subscriptions.get(roomName)
       if (!handler) return false
       const result = await client.command("rt/get-presence-state", { roomName }, 5000).catch((err) => {
-        clientLogger.error(`Failed to get presence state for room ${roomName}:`, err)
+        clientLogger.error("failed to get presence state for room", { roomName, err })
         return { success: false }
       })
       if (!result.success) return false
@@ -89,7 +89,7 @@ export function createPresenceSubscriptions(client) {
       }
       return true
     } catch (error) {
-      clientLogger.error(`Failed to force presence update for room ${roomName}:`, error)
+      clientLogger.error("failed to force presence update for room", { roomName, err: error })
       return false
     }
   }

package/src/client/subscriptions/records.js

@@ -16,7 +16,7 @@ export function createRecordSubscriptions(client) {
             version,
           })
         } catch (error) {
-          clientLogger.error(`Error in collection record update callback for ${collectionId}:`, error)
+          clientLogger.error("error in collection record update callback", { collectionId, err: error })
         }
       }
     }
@@ -26,9 +26,7 @@ export function createRecordSubscriptions(client) {
 
     if (patch) {
       if (version !== subscription.localVersion + 1) {
-        clientLogger.warn(
-          `Desync detected for record ${recordId}. Expected version ${subscription.localVersion + 1}, got ${version}. Resubscribing to request full record.`
-        )
+        clientLogger.warn("desync detected for record, resubscribing", { recordId, expected: subscription.localVersion + 1, got: version })
         await unsubscribe(recordId)
         await subscribe(recordId, subscription.callback, { mode: subscription.mode })
         return
@@ -48,7 +46,7 @@ export function createRecordSubscriptions(client) {
       try {
         await subscription.callback({ recordId, deleted: true, version })
       } catch (error) {
-        clientLogger.error(`Error in record deletion callback for ${recordId}:`, error)
+        clientLogger.error("error in record deletion callback", { recordId, err: error })
       }
     }
     subscriptions.delete(recordId)
@@ -70,7 +68,7 @@ export function createRecordSubscriptions(client) {
       }
       return { success: result.success, record: result.record ?? null, version: result.version ?? 0 }
     } catch (error) {
-      clientLogger.error(`Failed to subscribe to record ${recordId}:`, error)
+      clientLogger.error("failed to subscribe to record", { recordId, err: error })
       return { success: false, record: null, version: 0 }
     }
   }
@@ -85,7 +83,7 @@ export function createRecordSubscriptions(client) {
       if (success) subscriptions.delete(recordId)
       return success
     } catch (error) {
-      clientLogger.error(`Failed to unsubscribe from record ${recordId}:`, error)
+      clientLogger.error("failed to unsubscribe from record", { recordId, err: error })
       return false
     }
   }
@@ -101,7 +99,7 @@ export function createRecordSubscriptions(client) {
       const result = await client.command("rt/publish-record-update", { recordId, newValue, options })
       return result.success === true
     } catch (error) {
-      clientLogger.error(`Failed to publish update for record ${recordId}:`, error)
+      clientLogger.error("failed to publish update for record", { recordId, err: error })
       return false
     }
   }
@@ -112,7 +110,7 @@ export function createRecordSubscriptions(client) {
         await subscribe(recordId, callback, { mode })
         return true
       } catch (error) {
-        clientLogger.error(`Failed to resubscribe to record ${recordId}:`, error)
+        clientLogger.error("failed to resubscribe to record", { recordId, err: error })
         return false
       }
     })

package/src/client/subscriptions/rooms.js

@@ -44,7 +44,7 @@ export function createRoomSubscriptions(client, presence) {
       const result = await client.command("rt/get-room-metadata", { roomName })
       return result.metadata
     } catch (error) {
-      clientLogger.error(`Failed to get metadata for room ${roomName}:`, error)
+      clientLogger.error("failed to get metadata for room", { roomName, err: error })
       return null
     }
   }
@@ -55,7 +55,7 @@ export function createRoomSubscriptions(client, presence) {
         await join(roomName, presenceCallback)
         return { roomName, success: true }
       } catch (error) {
-        clientLogger.error(`Failed to rejoin room ${roomName}:`, error)
+        clientLogger.error("failed to rejoin room", { roomName, err: error })
         return { roomName, success: false }
       }
     })

package/src/server/connection.js

@@ -39,7 +39,7 @@ export class Connection extends EventEmitter {
         this.missedPongs++
         const maxMissedPongs = this.connectionOptions.maxMissedPongs ?? 1
         if (this.missedPongs > maxMissedPongs) {
-          serverLogger.info(`Closing connection (${this.id}) due to missed pongs`)
+          serverLogger.info("closing connection due to missed pongs", { connectionId: this.id })
           this.close()
           this.server.cleanupConnection(this)
           return
@@ -59,7 +59,7 @@ export class Connection extends EventEmitter {
 
   _applyListeners() {
     this.socket.on("close", () => {
-      serverLogger.info("Client's socket closed:", this.id)
+      serverLogger.info("client socket closed", { connectionId: this.id })
       this.status = Status.OFFLINE
       this.emit("close")
     })

package/src/server/managers/instance.js

@@ -61,12 +61,12 @@ export class InstanceManager {
         if (instanceId === this.instanceId) continue
         const heartbeat = await this.redis.get(`rt:instance:${instanceId}:heartbeat`)
         if (!heartbeat) {
-          serverLogger.info(`Found dead instance: ${instanceId}`)
+          serverLogger.info("found dead instance", { instanceId })
           await this._cleanupDeadInstance(instanceId)
         }
       }
     } catch (error) {
-      serverLogger.error("Error during cleanup:", error)
+      serverLogger.error("error during cleanup", { err: error })
     } finally {
       await this._releaseCleanupLock()
     }
@@ -85,9 +85,9 @@ export class InstanceManager {
       }
       await this.redis.srem("rt:instances", instanceId)
       await this.redis.del(connectionsKey)
-      serverLogger.info(`Cleaned up dead instance: ${instanceId}`)
+      serverLogger.info("cleaned up dead instance", { instanceId })
     } catch (error) {
-      serverLogger.error(`Error cleaning up instance ${instanceId}:`, error)
+      serverLogger.error("error cleaning up instance", { instanceId, err: error })
     }
   }
 
@@ -117,9 +117,9 @@ export class InstanceManager {
       pipeline.hdel("rt:connection-meta", connectionId)
       await this._deleteMatchingKeys(`rt:collection:*:${connectionId}`)
       await pipeline.exec()
-      serverLogger.debug(`Cleaned up stale connection: ${connectionId}`)
+      serverLogger.debug("cleaned up stale connection", { connectionId })
     } catch (error) {
-      serverLogger.error(`Error cleaning up connection ${connectionId}:`, error)
+      serverLogger.error("error cleaning up connection", { connectionId, err: error })
     }
   }
 }

package/src/server/managers/persistence.js

@@ -34,7 +34,7 @@ export class PersistenceManager extends EventEmitter {
 
   async _processPendingRecordUpdates() {
     if (this.pendingRecordUpdates.length === 0) return
-    serverLogger.info(`Processing ${this.pendingRecordUpdates.length} pending record updates`)
+    serverLogger.info("processing pending record updates", { count: this.pendingRecordUpdates.length })
     const updates = [...this.pendingRecordUpdates]
     this.pendingRecordUpdates = []
     for (const { recordId, value, version } of updates) {
@@ -54,25 +54,25 @@ export class PersistenceManager extends EventEmitter {
       await this._processPendingRecordUpdates()
       this.emit("initialized")
     } catch (err) {
-      serverLogger.error("Failed to initialize persistence manager:", err)
+      serverLogger.error("failed to initialize persistence manager", { err })
       throw err
     }
   }
 
   async restorePersistedRecords() {
     if (!this.recordManager) {
-      serverLogger.warn("Cannot restore persisted records: record manager not available")
+      serverLogger.warn("cannot restore persisted records: record manager not available")
       return
     }
     const redis = this.recordManager.getRedis()
     if (!redis) {
-      serverLogger.warn("Cannot restore records: Redis not available")
+      serverLogger.warn("cannot restore records: redis not available")
       return
     }
     try {
-      serverLogger.info("Restoring persisted records...")
+      serverLogger.info("restoring persisted records")
       if (this.recordPatterns.length === 0) {
-        serverLogger.info("No record patterns to restore")
+        serverLogger.info("no record patterns to restore")
         return
       }
       for (const config of this.recordPatterns) {
@@ -93,7 +93,7 @@ export class PersistenceManager extends EventEmitter {
             }))
           }
           if (records.length > 0) {
-            serverLogger.info(`Restoring ${records.length} records for pattern ${patternLabel}`)
+            serverLogger.info("restoring records for pattern", { count: records.length, pattern: patternLabel })
             for (const record of records) {
               try {
                 const { recordId, value, version } = record
@@ -104,17 +104,17 @@ export class PersistenceManager extends EventEmitter {
                 pipeline.set(versionKey, version.toString())
                 await pipeline.exec()
               } catch (parseErr) {
-                serverLogger.error(`Failed to restore record ${record.recordId}: ${parseErr}`)
+                serverLogger.error("failed to restore record", { recordId: record.recordId, err: parseErr })
               }
             }
           }
         } catch (patternErr) {
-          serverLogger.error(`Error restoring records for pattern ${patternLabel}: ${patternErr}`)
+          serverLogger.error("error restoring records for pattern", { pattern: patternLabel, err: patternErr })
         }
       }
-      serverLogger.info("Finished restoring persisted records")
+      serverLogger.info("finished restoring persisted records")
     } catch (err) {
-      serverLogger.error("Failed to restore persisted records:", err)
+      serverLogger.error("failed to restore persisted records", { err })
     }
   }
 
@@ -133,7 +133,7 @@ export class PersistenceManager extends EventEmitter {
     }
     if (fullOptions.adapter !== this.defaultAdapter && !this.isShuttingDown) {
       fullOptions.adapter.initialize().catch((err) => {
-        serverLogger.error(`Failed to initialize adapter for pattern ${pattern}:`, err)
+        serverLogger.error("failed to initialize adapter for pattern", { pattern, err })
       })
     }
     this.channelPatterns.push({ pattern, options: fullOptions })
@@ -148,7 +148,7 @@ export class PersistenceManager extends EventEmitter {
       resolvedAdapter = { adapter: adapterInstance, restorePattern: adapter.restorePattern }
       if (adapterInstance !== this.defaultAdapter && !this.isShuttingDown) {
         adapterInstance.initialize().catch((err) => {
-          serverLogger.error(`Failed to initialize adapter for record pattern ${pattern}:`, err)
+          serverLogger.error("failed to initialize adapter for record pattern", { pattern, err })
         })
       }
     }
@@ -220,7 +220,7 @@ export class PersistenceManager extends EventEmitter {
       await options.adapter.storeMessages(messages)
       this.emit("flushed", { channel, count: messages.length })
     } catch (err) {
-      serverLogger.error(`Failed to flush messages for channel ${channel}:`, err)
+      serverLogger.error("failed to flush messages for channel", { channel, err })
       if (!this.isShuttingDown) {
         const currentMessages = this.messageBuffer.get(channel) || []
         this.messageBuffer.set(channel, [...messages, ...currentMessages])
@@ -295,7 +295,7 @@ export class PersistenceManager extends EventEmitter {
       }
     }
     const handleFlushError = (failedRecords, err) => {
-      serverLogger.error("Failed to flush records:", err)
+      serverLogger.error("failed to flush records", { err })
       if (!this.isShuttingDown) {
         for (const record of failedRecords) this.recordBuffer.set(record.recordId, record)
         if (!this.recordFlushTimer) {
@@ -337,7 +337,7 @@ export class PersistenceManager extends EventEmitter {
         return await this.defaultAdapter.getRecords(pattern)
       }
     } catch (err) {
-      serverLogger.error(`Failed to get persisted records for pattern ${pattern}:`, err)
+      serverLogger.error("failed to get persisted records for pattern", { pattern, err })
     }
     return []
   }
@@ -364,7 +364,7 @@ export class PersistenceManager extends EventEmitter {
     }
     for (const adapter of adapters) {
       try { await adapter.close() }
-      catch (err) { serverLogger.error("Error closing persistence adapter:", err) }
+      catch (err) { serverLogger.error("error closing persistence adapter", { err }) }
     }
     this.initialized = false
   }

package/src/server/managers/presence.js

@@ -47,7 +47,7 @@ export class PresenceManager {
         await this._publishPresenceStateUpdate(match[1], match[2], null)
       }
     } catch (err) {
-      serverLogger.error("[PresenceManager] Failed to handle expired key:", err)
+      serverLogger.error("failed to handle expired key", { key, err })
     }
   }
 
@@ -167,7 +167,7 @@ export class PresenceManager {
     const value = await this.redis.get(key)
     if (!value) return null
     try { return JSON.parse(value) }
-    catch (e) { serverLogger.error(`[PresenceManager] Failed to parse presence state: ${e}`); return null }
+    catch (e) { serverLogger.error("failed to parse presence state", { err: e }); return null }
   }
 
   async getAllPresenceStates(roomName) {
@@ -186,7 +186,7 @@ export class PresenceManager {
       const [err, value] = responses[i] || []
       if (err || !value) continue
       try { result.set(connectionId, JSON.parse(value)) }
-      catch (e) { serverLogger.error(`[PresenceManager] Failed to parse presence state: ${e}`) }
+      catch (e) { serverLogger.error("failed to parse presence state", { err: e }) }
     }
     return result
   }

package/src/server/managers/pubsub.js

@@ -212,7 +212,7 @@ export class PubSubManager {
                 connection.send({ command: "rt/record-update", payload: { recordId, version, full: record } })
               }
             } catch (recordError) {
-              serverLogger.info(`Record ${recordId} not found during collection update (likely deleted).`)
+              serverLogger.info("record not found during collection update, likely deleted", { recordId })
             }
           }
         }

package/src/server/managers/records.js

@@ -65,10 +65,10 @@ export class RecordManager {
       Promise.all(
         this.recordUpdateCallbacks.map(async (callback) => {
           try { await callback({ recordId, value: finalValue }) }
-          catch (error) { serverLogger.error(`Error in record update callback for ${recordId}:`, error) }
+          catch (error) { serverLogger.error("error in record update callback", { recordId, err: error }) }
         })
       ).catch((error) => {
-        serverLogger.error(`Error in record update callbacks for ${recordId}:`, error)
+        serverLogger.error("error in record update callbacks", { recordId, err: error })
       })
     }
 
@@ -88,10 +88,10 @@ export class RecordManager {
       Promise.all(
         this.recordRemovedCallbacks.map(async (callback) => {
           try { await callback({ recordId, value: record }) }
-          catch (error) { serverLogger.error(`Error in record removed callback for ${recordId}:`, error) }
+          catch (error) { serverLogger.error("error in record removed callback", { recordId, err: error }) }
         })
       ).catch((error) => {
-        serverLogger.error(`Error in record removed callbacks for ${recordId}:`, error)
+        serverLogger.error("error in record removed callbacks", { recordId, err: error })
       })
     }
 

package/src/server/managers/rooms.js

@@ -121,7 +121,7 @@ export class RoomManager {
       const data = results?.[index]?.[1]
       if (data) {
         try { result.push({ id: roomName, metadata: JSON.parse(data) }) }
-        catch (e) { serverLogger.error(`Failed to parse metadata for room ${roomName}:`, e) }
+        catch (e) { serverLogger.error("failed to parse metadata for room", { roomName, err: e }) }
       }
     })
     return result

package/src/server/server.js

@@ -1,7 +1,7 @@
 import { createServer as createHttpServer } from "node:http"
 import { randomUUID } from "node:crypto"
 import { WebSocketServer } from "ws"
-import { LogLevel, Status, serverLogger, parseCommand } from "../shared/index.js"
+import { LogLevel, configureLogLevel, Status, serverLogger, parseCommand } from "../shared/index.js"
 import { Connection } from "./connection.js"
 import { PUB_SUB_CHANNEL_PREFIX } from "./utils/constants.js"
 import { ConnectionManager } from "./managers/connections.js"
@@ -54,7 +54,7 @@ export class RealtimeServer {
       enablePresenceExpirationEvents: opts.enablePresenceExpirationEvents ?? true,
     }
 
-    serverLogger.configure({ level: this.serverOptions.logLevel, styling: false })
+    configureLogLevel(this.serverOptions.logLevel)
 
     this.redisManager = new RedisManager()
     this.redisManager.initialize(opts.redis, (err) => this._emitError(err))
@@ -159,7 +159,7 @@ export class RealtimeServer {
 
   enableGracefulShutdown() {
     const handler = () => {
-      serverLogger.info("Received shutdown signal, closing...")
+      serverLogger.info("received shutdown signal, closing")
       this.close().then(() => process.exit(0))
     }
     process.on("SIGTERM", handler)
@@ -177,7 +177,7 @@ export class RealtimeServer {
   }
 
   _emitError(err) {
-    serverLogger.error(`Error: ${err}`)
+    serverLogger.error("error", { err })
     for (const handler of this._errorHandlers) handler(err)
   }
 
@@ -702,7 +702,7 @@ export class RealtimeServer {
         this.recordSubscriptionManager.addSubscription(recordId, connectionId, mode)
         return { success: true, record, version }
       } catch (e) {
-        serverLogger.error(`Failed to subscribe to record ${recordId}:`, e)
+        serverLogger.error("failed to subscribe to record", { recordId, err: e })
         return { success: false }
       }
     })
@@ -742,7 +742,7 @@ export class RealtimeServer {
         statesMap.forEach((state, connectionId) => { states[connectionId] = state })
         return { success: true, present, states }
       } catch (e) {
-        serverLogger.error(`Failed to subscribe to presence for room ${roomName}:`, e)
+        serverLogger.error("failed to subscribe to presence for room", { roomName, err: e })
         return { success: false, present: [] }
       }
     })
@@ -764,7 +764,7 @@ export class RealtimeServer {
         await this.presenceManager.publishPresenceState(connectionId, roomName, state, expireAfter, silent)
         return true
       } catch (e) {
-        serverLogger.error(`Failed to publish presence state for room ${roomName}:`, e)
+        serverLogger.error("failed to publish presence state for room", { roomName, err: e })
         return false
       }
     })
@@ -779,7 +779,7 @@ export class RealtimeServer {
         await this.presenceManager.clearPresenceState(connectionId, roomName)
         return true
       } catch (e) {
-        serverLogger.error(`Failed to clear presence state for room ${roomName}:`, e)
+        serverLogger.error("failed to clear presence state for room", { roomName, err: e })
         return false
       }
     })
@@ -796,7 +796,7 @@ export class RealtimeServer {
         statesMap.forEach((state, connectionId) => { states[connectionId] = state })
         return { success: true, present, states }
       } catch (e) {
-        serverLogger.error(`Failed to get presence state for room ${roomName}:`, e)
+        serverLogger.error("failed to get presence state for room", { roomName, err: e })
         return { success: false, present: [] }
       }
     })
@@ -812,7 +812,7 @@ export class RealtimeServer {
         const recordsWithId = records.map((record) => ({ id: record.id, record }))
         return { success: true, ids, records: recordsWithId, version }
       } catch (e) {
-        serverLogger.error(`Failed to subscribe to collection ${collectionId}:`, e)
+        serverLogger.error("failed to subscribe to collection", { collectionId, err: e })
         return { success: false, ids: [], records: [], version: 0 }
       }
     })
@@ -824,7 +824,7 @@ export class RealtimeServer {
   }
 
   async cleanupConnection(connection) {
-    serverLogger.info("Cleaning up connection:", connection.id)
+    serverLogger.info("cleaning up connection", { connectionId: connection.id })
     connection.stopIntervals()
     try {
       await this.presenceManager.cleanupConnection(connection)
@@ -858,7 +858,7 @@ export class RealtimeServer {
 
     if (this.persistenceManager) {
       try { await this.persistenceManager.shutdown() }
-      catch (err) { serverLogger.error("Error shutting down persistence manager:", err) }
+      catch (err) { serverLogger.error("error shutting down persistence manager", { err }) }
     }
 
     await this.channelManager.cleanupAllSubscriptions()

package/src/shared/index.js

@@ -1,5 +1,5 @@
 export { CodeError } from "./errors.js"
-export { LogLevel, Logger, clientLogger, serverLogger, logger } from "./logger.js"
+export { LogLevel, configureLogLevel, clientLogger, serverLogger, logger } from "./logger.js"
 export { deepMerge, isObject } from "./merge.js"
 export { parseCommand, stringifyCommand } from "./message.js"
 export { Status } from "./status.js"

package/src/shared/logger.js

@@ -1,4 +1,5 @@
-/** @enum {number} */
+import log from "@prsm/log"
+
 export const LogLevel = {
   NONE: 0,
   ERROR: 1,
@@ -7,47 +8,13 @@ export const LogLevel = {
   DEBUG: 4,
 }
 
-const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined"
-
-export class Logger {
-  constructor(config) {
-    this.config = {
-      level: config?.level ?? LogLevel.INFO,
-      prefix: config?.prefix ?? "[realtime]",
-      styling: config?.styling ?? isBrowser,
-    }
-  }
-
-  configure(config) {
-    this.config = { ...this.config, ...config }
-  }
-
-  info(...args) {
-    if (this.config.level >= LogLevel.INFO) this._log("log", ...args)
-  }
-
-  warn(...args) {
-    if (this.config.level >= LogLevel.WARN) this._log("warn", ...args)
-  }
-
-  error(...args) {
-    if (this.config.level >= LogLevel.ERROR) this._log("error", ...args)
-  }
-
-  debug(...args) {
-    if (this.config.level >= LogLevel.DEBUG) this._log("debug", ...args)
-  }
+const levelMap = { 0: "none", 1: "error", 2: "warn", 3: "info", 4: "debug" }
 
-  _log(method, ...args) {
-    if (this.config.styling && isBrowser) {
-      const style = "background: #000; color: #FFA07A; padding: 2px 4px; border-radius: 2px;"
-      console[method](`%c${this.config.prefix}%c`, style, "", ...args)
-    } else {
-      console[method](this.config.prefix, ...args)
-    }
-  }
+export function configureLogLevel(level) {
+  const str = typeof level === "number" ? levelMap[level] ?? "info" : level
+  log.configure({ level: str })
 }
 
-export const clientLogger = new Logger({ level: LogLevel.ERROR, styling: true })
-export const serverLogger = new Logger({ level: LogLevel.ERROR, styling: false })
-export const logger = isBrowser ? clientLogger : serverLogger
+export const serverLogger = log.child({ sys: "server" })
+export const clientLogger = log.child({ sys: "client" })
+export const logger = log