@syncular/core 0.0.6-126 → 0.0.6-136

package/dist/utils/index.d.ts

@@ -2,4 +2,5 @@ export * from './compression';
 export * from './crypto';
 export * from './id';
 export * from './object';
+export * from './realtime-connection-registry';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,gCAAgC,CAAC"}

package/dist/utils/index.js

@@ -2,4 +2,5 @@ export * from './compression.js';
 export * from './crypto.js';
 export * from './id.js';
 export * from './object.js';
+export * from './realtime-connection-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,gCAAgC,CAAC"}

package/dist/utils/realtime-connection-registry.d.ts

@@ -0,0 +1,34 @@
+export interface RealtimeConnection {
+    readonly clientId: string;
+    readonly isOpen: boolean;
+    sendHeartbeat(): void;
+    close(code?: number, reason?: string): void;
+}
+export declare class RealtimeConnectionRegistry<TConnection extends RealtimeConnection> {
+    private connectionsByClientId;
+    private scopeKeysByClientId;
+    private connectionsByScopeKey;
+    private readonly heartbeatIntervalMs;
+    private heartbeatTimer;
+    private readonly onClientDisconnected?;
+    constructor(options?: {
+        heartbeatIntervalMs?: number;
+        onClientDisconnected?: (clientId: string) => void;
+    });
+    register(connection: TConnection, initialScopeKeys?: string[]): () => void;
+    updateClientScopeKeys(clientId: string, scopeKeys: string[]): void;
+    isClientSubscribedToScopeKey(clientId: string, scopeKey: string): boolean;
+    getConnectionsForClient(clientId: string): ReadonlySet<TConnection> | undefined;
+    getConnectionCount(clientId: string): number;
+    getTotalConnections(): number;
+    forEachConnectionInScopeKeys(scopeKeys: Iterable<string>, visitor: (connection: TConnection) => void, options?: {
+        excludeClientIds?: readonly string[];
+    }): void;
+    forEachConnection(visitor: (connection: TConnection) => void): void;
+    closeClientConnections(clientId: string, code?: number, reason?: string): void;
+    closeAll(code?: number, reason?: string): void;
+    private ensureHeartbeat;
+    private sendHeartbeats;
+    private unregister;
+}
+//# sourceMappingURL=realtime-connection-registry.d.ts.map

package/dist/utils/realtime-connection-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-connection-registry.d.ts","sourceRoot":"","sources":["../../src/utils/realtime-connection-registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,aAAa,IAAI,IAAI,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,qBAAa,0BAA0B,CACrC,WAAW,SAAS,kBAAkB;IAEtC,OAAO,CAAC,qBAAqB,CAAuC;IACpE,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,qBAAqB,CAAuC;IAEpE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAA6B;IAEnE,YAAY,OAAO,CAAC,EAAE;QACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,oBAAoB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;KACnD,EAGA;IAED,QAAQ,CACN,UAAU,EAAE,WAAW,EACvB,gBAAgB,GAAE,MAAM,EAAO,GAC9B,MAAM,IAAI,CA8BZ;IAED,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAqCjE;IAED,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIxE;IAED,uBAAuB,CACrB,QAAQ,EAAE,MAAM,GACf,WAAW,CAAC,WAAW,CAAC,GAAG,SAAS,CAEtC;IAED,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3C;IAED,mBAAmB,IAAI,MAAM,CAM5B;IAED,4BAA4B,CAC1B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,EAC1C,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GACjD,IAAI,CAcN;IAED,iBAAiB,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAOlE;IAED,sBAAsB,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAqBN;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAW7C;IAED,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,UAAU;CAsBnB"}

package/dist/utils/realtime-connection-registry.js

@@ -0,0 +1,218 @@
+export class RealtimeConnectionRegistry {
+    connectionsByClientId = new Map();
+    scopeKeysByClientId = new Map();
+    connectionsByScopeKey = new Map();
+    heartbeatIntervalMs;
+    heartbeatTimer = null;
+    onClientDisconnected;
+    constructor(options) {
+        this.heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 30_000;
+        this.onClientDisconnected = options?.onClientDisconnected;
+    }
+    register(connection, initialScopeKeys = []) {
+        const clientId = connection.clientId;
+        let clientConns = this.connectionsByClientId.get(clientId);
+        if (!clientConns) {
+            clientConns = new Set();
+            this.connectionsByClientId.set(clientId, clientConns);
+        }
+        clientConns.add(connection);
+        if (!this.scopeKeysByClientId.has(clientId)) {
+            this.scopeKeysByClientId.set(clientId, new Set(initialScopeKeys));
+        }
+        const scopeKeys = this.scopeKeysByClientId.get(clientId);
+        if (scopeKeys) {
+            for (const key of scopeKeys) {
+                let scopedConns = this.connectionsByScopeKey.get(key);
+                if (!scopedConns) {
+                    scopedConns = new Set();
+                    this.connectionsByScopeKey.set(key, scopedConns);
+                }
+                scopedConns.add(connection);
+            }
+        }
+        this.ensureHeartbeat();
+        return () => {
+            this.unregister(connection);
+            this.ensureHeartbeat();
+        };
+    }
+    updateClientScopeKeys(clientId, scopeKeys) {
+        const conns = this.connectionsByClientId.get(clientId);
+        if (!conns || conns.size === 0)
+            return;
+        const next = new Set(scopeKeys);
+        const prev = this.scopeKeysByClientId.get(clientId) ?? new Set();
+        if (prev.size === next.size) {
+            let unchanged = true;
+            for (const key of prev) {
+                if (!next.has(key)) {
+                    unchanged = false;
+                    break;
+                }
+            }
+            if (unchanged)
+                return;
+        }
+        this.scopeKeysByClientId.set(clientId, next);
+        for (const key of prev) {
+            if (next.has(key))
+                continue;
+            const scopedConns = this.connectionsByScopeKey.get(key);
+            if (!scopedConns)
+                continue;
+            for (const conn of conns)
+                scopedConns.delete(conn);
+            if (scopedConns.size === 0)
+                this.connectionsByScopeKey.delete(key);
+        }
+        for (const key of next) {
+            if (prev.has(key))
+                continue;
+            let scopedConns = this.connectionsByScopeKey.get(key);
+            if (!scopedConns) {
+                scopedConns = new Set();
+                this.connectionsByScopeKey.set(key, scopedConns);
+            }
+            for (const conn of conns)
+                scopedConns.add(conn);
+        }
+    }
+    isClientSubscribedToScopeKey(clientId, scopeKey) {
+        const scopeKeys = this.scopeKeysByClientId.get(clientId);
+        if (!scopeKeys || scopeKeys.size === 0)
+            return false;
+        return scopeKeys.has(scopeKey);
+    }
+    getConnectionsForClient(clientId) {
+        return this.connectionsByClientId.get(clientId);
+    }
+    getConnectionCount(clientId) {
+        return this.connectionsByClientId.get(clientId)?.size ?? 0;
+    }
+    getTotalConnections() {
+        let total = 0;
+        for (const conns of this.connectionsByClientId.values()) {
+            total += conns.size;
+        }
+        return total;
+    }
+    forEachConnectionInScopeKeys(scopeKeys, visitor, options) {
+        const targets = new Set();
+        for (const key of scopeKeys) {
+            const conns = this.connectionsByScopeKey.get(key);
+            if (!conns)
+                continue;
+            for (const conn of conns)
+                targets.add(conn);
+        }
+        const excludedClientIds = new Set(options?.excludeClientIds ?? []);
+        for (const conn of targets) {
+            if (!conn.isOpen)
+                continue;
+            if (excludedClientIds.has(conn.clientId))
+                continue;
+            visitor(conn);
+        }
+    }
+    forEachConnection(visitor) {
+        for (const conns of this.connectionsByClientId.values()) {
+            for (const conn of conns) {
+                if (!conn.isOpen)
+                    continue;
+                visitor(conn);
+            }
+        }
+    }
+    closeClientConnections(clientId, code, reason) {
+        const conns = this.connectionsByClientId.get(clientId);
+        if (!conns)
+            return;
+        const scopeKeys = this.scopeKeysByClientId.get(clientId);
+        if (scopeKeys) {
+            for (const key of scopeKeys) {
+                const scopedConns = this.connectionsByScopeKey.get(key);
+                if (!scopedConns)
+                    continue;
+                for (const conn of conns)
+                    scopedConns.delete(conn);
+                if (scopedConns.size === 0)
+                    this.connectionsByScopeKey.delete(key);
+            }
+        }
+        for (const conn of conns) {
+            conn.close(code, reason);
+        }
+        this.connectionsByClientId.delete(clientId);
+        this.scopeKeysByClientId.delete(clientId);
+        this.ensureHeartbeat();
+    }
+    closeAll(code, reason) {
+        for (const conns of this.connectionsByClientId.values()) {
+            for (const conn of conns) {
+                conn.close(code, reason);
+            }
+        }
+        this.connectionsByClientId.clear();
+        this.scopeKeysByClientId.clear();
+        this.connectionsByScopeKey.clear();
+        this.ensureHeartbeat();
+    }
+    ensureHeartbeat() {
+        if (this.heartbeatIntervalMs <= 0)
+            return;
+        const total = this.getTotalConnections();
+        if (total === 0) {
+            if (this.heartbeatTimer) {
+                clearInterval(this.heartbeatTimer);
+                this.heartbeatTimer = null;
+            }
+            return;
+        }
+        if (this.heartbeatTimer)
+            return;
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHeartbeats();
+        }, this.heartbeatIntervalMs);
+    }
+    sendHeartbeats() {
+        const closedConnections = [];
+        for (const conns of this.connectionsByClientId.values()) {
+            for (const conn of conns) {
+                if (!conn.isOpen) {
+                    closedConnections.push(conn);
+                    continue;
+                }
+                conn.sendHeartbeat();
+            }
+        }
+        for (const conn of closedConnections) {
+            this.unregister(conn);
+        }
+        this.ensureHeartbeat();
+    }
+    unregister(connection) {
+        const clientId = connection.clientId;
+        const scopeKeys = this.scopeKeysByClientId.get(clientId);
+        if (scopeKeys) {
+            for (const key of scopeKeys) {
+                const scopedConns = this.connectionsByScopeKey.get(key);
+                if (!scopedConns)
+                    continue;
+                scopedConns.delete(connection);
+                if (scopedConns.size === 0)
+                    this.connectionsByScopeKey.delete(key);
+            }
+        }
+        const conns = this.connectionsByClientId.get(clientId);
+        if (!conns)
+            return;
+        conns.delete(connection);
+        if (conns.size > 0)
+            return;
+        this.connectionsByClientId.delete(clientId);
+        this.scopeKeysByClientId.delete(clientId);
+        this.onClientDisconnected?.(clientId);
+    }
+}
+//# sourceMappingURL=realtime-connection-registry.js.map

package/dist/utils/realtime-connection-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-connection-registry.js","sourceRoot":"","sources":["../../src/utils/realtime-connection-registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/core",
-  "version": "0.0.6-126",
+  "version": "0.0.6-136",
   "description": "Core protocol types and shared utilities for the Syncular sync framework",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",

package/src/utils/index.ts

@@ -2,3 +2,4 @@ export * from './compression';
 export * from './crypto';
 export * from './id';
 export * from './object';
+export * from './realtime-connection-registry';

package/src/utils/realtime-connection-registry.ts

@@ -0,0 +1,253 @@
+export interface RealtimeConnection {
+  readonly clientId: string;
+  readonly isOpen: boolean;
+  sendHeartbeat(): void;
+  close(code?: number, reason?: string): void;
+}
+
+export class RealtimeConnectionRegistry<
+  TConnection extends RealtimeConnection,
+> {
+  private connectionsByClientId = new Map<string, Set<TConnection>>();
+  private scopeKeysByClientId = new Map<string, Set<string>>();
+  private connectionsByScopeKey = new Map<string, Set<TConnection>>();
+
+  private readonly heartbeatIntervalMs: number;
+  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
+  private readonly onClientDisconnected?: (clientId: string) => void;
+
+  constructor(options?: {
+    heartbeatIntervalMs?: number;
+    onClientDisconnected?: (clientId: string) => void;
+  }) {
+    this.heartbeatIntervalMs = options?.heartbeatIntervalMs ?? 30_000;
+    this.onClientDisconnected = options?.onClientDisconnected;
+  }
+
+  register(
+    connection: TConnection,
+    initialScopeKeys: string[] = []
+  ): () => void {
+    const clientId = connection.clientId;
+    let clientConns = this.connectionsByClientId.get(clientId);
+    if (!clientConns) {
+      clientConns = new Set();
+      this.connectionsByClientId.set(clientId, clientConns);
+    }
+    clientConns.add(connection);
+
+    if (!this.scopeKeysByClientId.has(clientId)) {
+      this.scopeKeysByClientId.set(clientId, new Set(initialScopeKeys));
+    }
+
+    const scopeKeys = this.scopeKeysByClientId.get(clientId);
+    if (scopeKeys) {
+      for (const key of scopeKeys) {
+        let scopedConns = this.connectionsByScopeKey.get(key);
+        if (!scopedConns) {
+          scopedConns = new Set();
+          this.connectionsByScopeKey.set(key, scopedConns);
+        }
+        scopedConns.add(connection);
+      }
+    }
+
+    this.ensureHeartbeat();
+    return () => {
+      this.unregister(connection);
+      this.ensureHeartbeat();
+    };
+  }
+
+  updateClientScopeKeys(clientId: string, scopeKeys: string[]): void {
+    const conns = this.connectionsByClientId.get(clientId);
+    if (!conns || conns.size === 0) return;
+
+    const next = new Set(scopeKeys);
+    const prev = this.scopeKeysByClientId.get(clientId) ?? new Set<string>();
+
+    if (prev.size === next.size) {
+      let unchanged = true;
+      for (const key of prev) {
+        if (!next.has(key)) {
+          unchanged = false;
+          break;
+        }
+      }
+      if (unchanged) return;
+    }
+
+    this.scopeKeysByClientId.set(clientId, next);
+
+    for (const key of prev) {
+      if (next.has(key)) continue;
+      const scopedConns = this.connectionsByScopeKey.get(key);
+      if (!scopedConns) continue;
+      for (const conn of conns) scopedConns.delete(conn);
+      if (scopedConns.size === 0) this.connectionsByScopeKey.delete(key);
+    }
+
+    for (const key of next) {
+      if (prev.has(key)) continue;
+      let scopedConns = this.connectionsByScopeKey.get(key);
+      if (!scopedConns) {
+        scopedConns = new Set();
+        this.connectionsByScopeKey.set(key, scopedConns);
+      }
+      for (const conn of conns) scopedConns.add(conn);
+    }
+  }
+
+  isClientSubscribedToScopeKey(clientId: string, scopeKey: string): boolean {
+    const scopeKeys = this.scopeKeysByClientId.get(clientId);
+    if (!scopeKeys || scopeKeys.size === 0) return false;
+    return scopeKeys.has(scopeKey);
+  }
+
+  getConnectionsForClient(
+    clientId: string
+  ): ReadonlySet<TConnection> | undefined {
+    return this.connectionsByClientId.get(clientId);
+  }
+
+  getConnectionCount(clientId: string): number {
+    return this.connectionsByClientId.get(clientId)?.size ?? 0;
+  }
+
+  getTotalConnections(): number {
+    let total = 0;
+    for (const conns of this.connectionsByClientId.values()) {
+      total += conns.size;
+    }
+    return total;
+  }
+
+  forEachConnectionInScopeKeys(
+    scopeKeys: Iterable<string>,
+    visitor: (connection: TConnection) => void,
+    options?: { excludeClientIds?: readonly string[] }
+  ): void {
+    const targets = new Set<TConnection>();
+    for (const key of scopeKeys) {
+      const conns = this.connectionsByScopeKey.get(key);
+      if (!conns) continue;
+      for (const conn of conns) targets.add(conn);
+    }
+
+    const excludedClientIds = new Set(options?.excludeClientIds ?? []);
+    for (const conn of targets) {
+      if (!conn.isOpen) continue;
+      if (excludedClientIds.has(conn.clientId)) continue;
+      visitor(conn);
+    }
+  }
+
+  forEachConnection(visitor: (connection: TConnection) => void): void {
+    for (const conns of this.connectionsByClientId.values()) {
+      for (const conn of conns) {
+        if (!conn.isOpen) continue;
+        visitor(conn);
+      }
+    }
+  }
+
+  closeClientConnections(
+    clientId: string,
+    code?: number,
+    reason?: string
+  ): void {
+    const conns = this.connectionsByClientId.get(clientId);
+    if (!conns) return;
+
+    const scopeKeys = this.scopeKeysByClientId.get(clientId);
+    if (scopeKeys) {
+      for (const key of scopeKeys) {
+        const scopedConns = this.connectionsByScopeKey.get(key);
+        if (!scopedConns) continue;
+        for (const conn of conns) scopedConns.delete(conn);
+        if (scopedConns.size === 0) this.connectionsByScopeKey.delete(key);
+      }
+    }
+
+    for (const conn of conns) {
+      conn.close(code, reason);
+    }
+
+    this.connectionsByClientId.delete(clientId);
+    this.scopeKeysByClientId.delete(clientId);
+    this.ensureHeartbeat();
+  }
+
+  closeAll(code?: number, reason?: string): void {
+    for (const conns of this.connectionsByClientId.values()) {
+      for (const conn of conns) {
+        conn.close(code, reason);
+      }
+    }
+
+    this.connectionsByClientId.clear();
+    this.scopeKeysByClientId.clear();
+    this.connectionsByScopeKey.clear();
+    this.ensureHeartbeat();
+  }
+
+  private ensureHeartbeat(): void {
+    if (this.heartbeatIntervalMs <= 0) return;
+
+    const total = this.getTotalConnections();
+    if (total === 0) {
+      if (this.heartbeatTimer) {
+        clearInterval(this.heartbeatTimer);
+        this.heartbeatTimer = null;
+      }
+      return;
+    }
+
+    if (this.heartbeatTimer) return;
+    this.heartbeatTimer = setInterval(() => {
+      this.sendHeartbeats();
+    }, this.heartbeatIntervalMs);
+  }
+
+  private sendHeartbeats(): void {
+    const closedConnections: TConnection[] = [];
+    for (const conns of this.connectionsByClientId.values()) {
+      for (const conn of conns) {
+        if (!conn.isOpen) {
+          closedConnections.push(conn);
+          continue;
+        }
+        conn.sendHeartbeat();
+      }
+    }
+
+    for (const conn of closedConnections) {
+      this.unregister(conn);
+    }
+
+    this.ensureHeartbeat();
+  }
+
+  private unregister(connection: TConnection): void {
+    const clientId = connection.clientId;
+
+    const scopeKeys = this.scopeKeysByClientId.get(clientId);
+    if (scopeKeys) {
+      for (const key of scopeKeys) {
+        const scopedConns = this.connectionsByScopeKey.get(key);
+        if (!scopedConns) continue;
+        scopedConns.delete(connection);
+        if (scopedConns.size === 0) this.connectionsByScopeKey.delete(key);
+      }
+    }
+
+    const conns = this.connectionsByClientId.get(clientId);
+    if (!conns) return;
+    conns.delete(connection);
+    if (conns.size > 0) return;
+
+    this.connectionsByClientId.delete(clientId);
+    this.scopeKeysByClientId.delete(clientId);
+    this.onClientDisconnected?.(clientId);
+  }
+}