@korajs/sync 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   JsonMessageSerializer: () => JsonMessageSerializer,
   KeyDerivationError: () => KeyDerivationError,
   NegotiatedMessageSerializer: () => NegotiatedMessageSerializer,
+  OFFLINE_SYNC_STATUS: () => OFFLINE_SYNC_STATUS,
   OutboundQueue: () => OutboundQueue,
   ProtobufMessageSerializer: () => ProtobufMessageSerializer,
   ReconnectionManager: () => ReconnectionManager,
@@ -53,6 +54,7 @@ __export(index_exports, {
   SyncEngine: () => SyncEngine,
   WebSocketTransport: () => WebSocketTransport,
   createDeltaCursorFromBatch: () => createDeltaCursorFromBatch,
+  createSyncStatusController: () => createSyncStatusController,
   decodeDeltaCursor: () => decodeDeltaCursor,
   decodeYjsUpdate: () => decodeYjsUpdate,
   dedupeQuerySubsets: () => dedupeQuerySubsets,
@@ -62,6 +64,7 @@ __export(index_exports, {
   encodeYjsUpdate: () => encodeYjsUpdate,
   filterOperationsByScope: () => filterOperationsByScope,
   generateSalt: () => generateSalt,
+  getRemoteAwarenessStates: () => getRemoteAwarenessStates,
   isAcknowledgmentMessage: () => isAcknowledgmentMessage,
   isAwarenessUpdateMessage: () => isAwarenessUpdateMessage,
   isClientSchemaVersionSupported: () => isClientSchemaVersionSupported,
@@ -77,6 +80,7 @@ __export(index_exports, {
   operationMatchesScope: () => operationMatchesScope,
   richtextDocKey: () => richtextDocKey,
   sliceOperationsAfterCursor: () => sliceOperationsAfterCursor,
+  subscribeRemoteAwarenessStates: () => subscribeRemoteAwarenessStates,
   versionVectorToWire: () => versionVectorToWire,
   wireToVersionVector: () => wireToVersionVector
 });
@@ -3885,6 +3889,158 @@ function fromBase642(str) {
   }
   return bytes;
 }
+
+// src/reactivity/sync-status-controller.ts
+var OFFLINE_SYNC_STATUS = Object.freeze({
+  status: "offline",
+  pendingOperations: 0,
+  lastSyncedAt: null,
+  lastSuccessfulPush: null,
+  lastSuccessfulPull: null,
+  conflicts: 0
+});
+var SYNC_STATUS_EVENT_TYPES = [
+  "sync:connected",
+  "sync:disconnected",
+  "sync:schema-mismatch",
+  "sync:auth-failed",
+  "sync:sent",
+  "sync:received",
+  "sync:acknowledged",
+  "sync:apply-failed",
+  "sync:diagnostics",
+  "sync:initial-sync-progress"
+];
+function createSyncStatusController(options) {
+  const useLiveSnapshot = options.subscribeSyncStatus === null && options.events === null;
+  let snapshot = OFFLINE_SYNC_STATUS;
+  let serialized = JSON.stringify(OFFLINE_SYNC_STATUS);
+  const listeners = /* @__PURE__ */ new Set();
+  let cleanup = null;
+  const resolveEngine = () => {
+    return options.getSyncEngine?.() ?? options.syncEngine ?? null;
+  };
+  const notify = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const setSnapshot = (next) => {
+    const nextSerialized = JSON.stringify(next);
+    if (nextSerialized === serialized) {
+      return;
+    }
+    serialized = nextSerialized;
+    snapshot = next;
+    notify();
+  };
+  const refresh = () => {
+    const engine = resolveEngine();
+    const next = engine ? engine.getStatus() : OFFLINE_SYNC_STATUS;
+    setSnapshot(next);
+  };
+  const attach = () => {
+    cleanup?.();
+    if (options.subscribeSyncStatus) {
+      cleanup = options.subscribeSyncStatus(setSnapshot);
+      return;
+    }
+    if (!resolveEngine()) {
+      setSnapshot(OFFLINE_SYNC_STATUS);
+      cleanup = () => {
+      };
+      return;
+    }
+    if (options.events) {
+      const unsubs = SYNC_STATUS_EVENT_TYPES.map((type) => options.events?.on(type, refresh));
+      refresh();
+      cleanup = () => {
+        for (const unsub of unsubs) {
+          unsub?.();
+        }
+      };
+      return;
+    }
+    refresh();
+    cleanup = () => {
+    };
+  };
+  attach();
+  return {
+    getSnapshot() {
+      if (useLiveSnapshot) {
+        const engine = resolveEngine();
+        return engine ? engine.getStatus() : OFFLINE_SYNC_STATUS;
+      }
+      return snapshot;
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      listener();
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    refresh,
+    destroy() {
+      cleanup?.();
+      cleanup = null;
+      listeners.clear();
+    }
+  };
+}
+
+// src/reactivity/collaborators-snapshot.ts
+var EMPTY_COLLABORATORS = [];
+function awarenessStatesEqual(left, right) {
+  if (left.length !== right.length) {
+    return false;
+  }
+  for (let index = 0; index < left.length; index++) {
+    const a = left[index];
+    const b = right[index];
+    if (!a || !b) {
+      return false;
+    }
+    if (a.user.name !== b.user.name || a.user.color !== b.user.color) {
+      return false;
+    }
+    const aCursor = a.cursor;
+    const bCursor = b.cursor;
+    if (aCursor === void 0 && bCursor === void 0) {
+      continue;
+    }
+    if (!aCursor || !bCursor) {
+      return false;
+    }
+    if (aCursor.collection !== bCursor.collection || aCursor.recordId !== bCursor.recordId || aCursor.field !== bCursor.field || aCursor.anchor !== bCursor.anchor || aCursor.head !== bCursor.head) {
+      return false;
+    }
+  }
+  return true;
+}
+function getRemoteAwarenessStates(awareness) {
+  const localClientId = awareness.clientId;
+  const remoteStates = [];
+  for (const [clientId, state] of awareness.getStates()) {
+    if (clientId === localClientId) continue;
+    remoteStates.push(state);
+  }
+  return remoteStates;
+}
+function subscribeRemoteAwarenessStates(awareness, listener) {
+  let snapshot = EMPTY_COLLABORATORS;
+  const emitIfChanged = () => {
+    const next = getRemoteAwarenessStates(awareness);
+    if (awarenessStatesEqual(snapshot, next)) {
+      return;
+    }
+    snapshot = next;
+    listener(snapshot);
+  };
+  emitIfChanged();
+  return awareness.on("change", emitIfChanged);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AwarenessManager,
@@ -3898,6 +4054,7 @@ function fromBase642(str) {
   JsonMessageSerializer,
   KeyDerivationError,
   NegotiatedMessageSerializer,
+  OFFLINE_SYNC_STATUS,
   OutboundQueue,
   ProtobufMessageSerializer,
   ReconnectionManager,
@@ -3910,6 +4067,7 @@ function fromBase642(str) {
   SyncEngine,
   WebSocketTransport,
   createDeltaCursorFromBatch,
+  createSyncStatusController,
   decodeDeltaCursor,
   decodeYjsUpdate,
   dedupeQuerySubsets,
@@ -3919,6 +4077,7 @@ function fromBase642(str) {
   encodeYjsUpdate,
   filterOperationsByScope,
   generateSalt,
+  getRemoteAwarenessStates,
   isAcknowledgmentMessage,
   isAwarenessUpdateMessage,
   isClientSchemaVersionSupported,
@@ -3934,6 +4093,7 @@ function fromBase642(str) {
   operationMatchesScope,
   richtextDocKey,
   sliceOperationsAfterCursor,
+  subscribeRemoteAwarenessStates,
   versionVectorToWire,
   wireToVersionVector
 });