canvu-react 0.4.56 → 0.4.57

package/dist/realtimeNative.js

@@ -823,6 +823,7 @@ var DRAFT_STORAGE_PREFIX = "canvu-realtime-draft:";
 var DOCUMENT_FLUSH_DEBOUNCE_MS = 120;
 var DRAFT_PERSIST_DEBOUNCE_MS = 420;
 var CONNECTION_MESSAGE_STATE_UPDATE_INTERVAL_MS = 1e3;
+var PRESENCE_UPDATE_THROTTLE_MS = 80;
 function requestRuntimeIdleCallback(callback, timeout) {
   const runtime = globalThis;
   if (typeof runtime.requestIdleCallback === "function") {
@@ -958,6 +959,10 @@ function nowMs() {
 function shouldUpdateRealtimeConnectionMessageState(input) {
   return input.lastStateUpdateAt == null || input.receivedAt - input.lastStateUpdateAt >= CONNECTION_MESSAGE_STATE_UPDATE_INTERVAL_MS;
 }
+function shouldSendRealtimePresenceUpdate(input) {
+  const minIntervalMs = input.minIntervalMs ?? PRESENCE_UPDATE_THROTTLE_MS;
+  return input.lastPresenceSentAt == null || input.requestedAt - input.lastPresenceSentAt >= minIntervalMs;
+}
 function hasDurableDocumentPersistence(snapshot) {
   return snapshot.persistedRevision == null || snapshot.persistedRevision >= snapshot.revision;
 }
@@ -1098,6 +1103,7 @@ function useRealtimeSession(options) {
   const documentFlushIdleRef = useRef(null);
   const draftPersistTimerRef = useRef(null);
   const draftPersistIdleRef = useRef(null);
+  const presenceUpdateTimerRef = useRef(null);
   const draftStorageRef = useRef(draftStorage);
   draftStorageRef.current = draftStorage;
   const manualDisconnectRef = useRef(false);
@@ -1122,6 +1128,7 @@ function useRealtimeSession(options) {
     enabled ? "connecting" : "offline"
   );
   const lastConnectionMessageStateUpdateAtRef = useRef(null);
+  const lastPresenceSentAtRef = useRef(null);
   const localDraftRef = useRef(null);
   const conflictRef = useRef(null);
   const onErrorRef = useRef(onError);
@@ -1186,6 +1193,12 @@ function useRealtimeSession(options) {
     cancelRuntimeIdleCallback(draftPersistIdleRef.current);
     draftPersistIdleRef.current = null;
   }, []);
+  const clearPresenceUpdateSchedule = useCallback(() => {
+    if (presenceUpdateTimerRef.current != null) {
+      globalThis.clearTimeout(presenceUpdateTimerRef.current);
+      presenceUpdateTimerRef.current = null;
+    }
+  }, []);
   const updateConnection = useCallback(
     (patch) => {
       setConnection((prev) => {
@@ -1544,7 +1557,8 @@ function useRealtimeSession(options) {
     },
     [applyDocument, roomId, scheduleDocumentFlush, setLocalDraft]
   );
-  const sendPresenceUpdate = useCallback(() => {
+  const sendPresenceUpdateNow = useCallback(() => {
+    lastPresenceSentAtRef.current = nowMs();
     sendRaw({
       type: "presence:update",
       roomId,
@@ -1557,6 +1571,24 @@ function useRealtimeSession(options) {
       }
     });
   }, [roomId, sendRaw]);
+  const sendPresenceUpdate = useCallback(() => {
+    const requestedAt = nowMs();
+    if (shouldSendRealtimePresenceUpdate({
+      lastPresenceSentAt: lastPresenceSentAtRef.current,
+      requestedAt
+    })) {
+      clearPresenceUpdateSchedule();
+      sendPresenceUpdateNow();
+      return;
+    }
+    if (presenceUpdateTimerRef.current != null) return;
+    const elapsedMs = requestedAt - (lastPresenceSentAtRef.current ?? requestedAt);
+    const delayMs = Math.max(0, PRESENCE_UPDATE_THROTTLE_MS - elapsedMs);
+    presenceUpdateTimerRef.current = globalThis.setTimeout(() => {
+      presenceUpdateTimerRef.current = null;
+      sendPresenceUpdateNow();
+    }, delayMs);
+  }, [clearPresenceUpdateSchedule, sendPresenceUpdateNow]);
   const scheduleReconnect = useCallback(() => {
     if (!reconnect || manualDisconnectRef.current) return;
     clearReconnectTimer();
@@ -1638,6 +1670,7 @@ function useRealtimeSession(options) {
     if (!roomId) {
       clearDocumentFlushSchedule();
       clearDraftPersistSchedule();
+      clearPresenceUpdateSchedule();
       localDraftRef.current = null;
       setHasLocalOfflineDraft(false);
       setHasPendingDocumentSync(false);
@@ -1680,6 +1713,7 @@ function useRealtimeSession(options) {
     applyDraftSnapshot,
     clearDocumentFlushSchedule,
     clearDraftPersistSchedule,
+    clearPresenceUpdateSchedule,
     roomId,
     setConflictState,
     setLocalDraft
@@ -1692,6 +1726,7 @@ function useRealtimeSession(options) {
       clearHeartbeatTimer();
       clearConnectTimeout();
       clearDocumentFlushSchedule();
+      clearPresenceUpdateSchedule();
       wsRef.current?.close();
       wsRef.current = null;
       queuedDirtyRef.current = localDraftRef.current != null;
@@ -1975,12 +2010,14 @@ function useRealtimeSession(options) {
       clearHeartbeatTimer();
       clearConnectTimeout();
       clearDocumentFlushSchedule();
+      clearPresenceUpdateSchedule();
       socket.close();
     };
   }, [
     clearConnectTimeout,
     clearDocumentFlushSchedule,
     clearHeartbeatTimer,
+    clearPresenceUpdateSchedule,
     clearReconnectTimer,
     connectSequence,
     connectTimeoutMs,
@@ -2008,12 +2045,17 @@ function useRealtimeSession(options) {
     () => () => {
       clearDocumentFlushSchedule();
       clearDraftPersistSchedule();
+      clearPresenceUpdateSchedule();
       if (boardRef.current) {
         boardRef.current.doc.destroy();
         boardRef.current = null;
       }
     },
-    [clearDocumentFlushSchedule, clearDraftPersistSchedule]
+    [
+      clearDocumentFlushSchedule,
+      clearDraftPersistSchedule,
+      clearPresenceUpdateSchedule
+    ]
   );
   const flushDocumentSync = useCallback(async () => {
     const board = boardRef.current;
@@ -2065,6 +2107,7 @@ function useRealtimeSession(options) {
     clearReconnectTimer();
     clearHeartbeatTimer();
     clearConnectTimeout();
+    clearPresenceUpdateSchedule();
     sendRaw({
       type: "session:leave",
       roomId,
@@ -2081,6 +2124,7 @@ function useRealtimeSession(options) {
   }, [
     clearConnectTimeout,
     clearHeartbeatTimer,
+    clearPresenceUpdateSchedule,
     clearReconnectTimer,
     collapsePeersToSelf,
     roomId,