@prsm/realtime 1.0.0

package/src/server/utils/constants.js

@@ -0,0 +1,4 @@
+export const PUB_SUB_CHANNEL_PREFIX = "mesh:pubsub:"
+export const RECORD_PUB_SUB_CHANNEL = "mesh:record-updates"
+export const RECORD_KEY_PREFIX = "mesh:record:"
+export const RECORD_VERSION_KEY_PREFIX = "mesh:record-version:"

package/src/server/utils/ids.js

@@ -0,0 +1,5 @@
+import { randomUUID } from "node:crypto"
+
+export function generateConnectionId() {
+  return randomUUID()
+}

package/src/server/utils/pattern-conversion.js

@@ -0,0 +1,14 @@
+export function convertToSqlPattern(pattern) {
+  return pattern
+    .replace(/\^/g, "")
+    .replace(/\$/g, "")
+    .replace(/\./g, "_")
+    .replace(/\*/g, "%")
+    .replace(/\+/g, "%")
+    .replace(/\?/g, "_")
+    .replace(/\\\\/g, "\\")
+    .replace(/\\\./g, ".")
+    .replace(/\\\*/g, "*")
+    .replace(/\\\+/g, "+")
+    .replace(/\\\?/g, "?")
+}

package/src/shared/errors.js

@@ -0,0 +1,7 @@
+export class CodeError extends Error {
+  constructor(message, code, name) {
+    super(message)
+    if (typeof code === "string") this.code = code
+    this.name = typeof name === "string" ? name : "CodeError"
+  }
+}

package/src/shared/index.js

@@ -0,0 +1,5 @@
+export { CodeError } from "./errors.js"
+export { LogLevel, Logger, 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

@@ -0,0 +1,53 @@
+/** @enum {number} */
+export const LogLevel = {
+  NONE: 0,
+  ERROR: 1,
+  WARN: 2,
+  INFO: 3,
+  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 ?? "[mesh]",
+      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)
+  }
+
+  _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 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

package/src/shared/merge.js

@@ -0,0 +1,17 @@
+export function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value)
+}
+
+export function deepMerge(target, source) {
+  if (!isObject(target) || !isObject(source)) return source
+
+  const result = { ...target }
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      result[key] = isObject(source[key]) && isObject(target[key])
+        ? deepMerge(target[key], source[key])
+        : source[key]
+    }
+  }
+  return result
+}

package/src/shared/message.js

@@ -0,0 +1,17 @@
+/**
+ * @typedef {{ id?: number, command: string, payload: any }} Command
+ */
+
+/** @param {string} data */
+export function parseCommand(data) {
+  try {
+    return JSON.parse(data)
+  } catch {
+    return { command: "", payload: {} }
+  }
+}
+
+/** @param {Command} command */
+export function stringifyCommand(command) {
+  return JSON.stringify(command)
+}

package/src/shared/status.js

@@ -0,0 +1,7 @@
+/** @enum {number} */
+export const Status = {
+  ONLINE: 3,
+  CONNECTING: 2,
+  RECONNECTING: 1,
+  OFFLINE: 0,
+}