canvu-react 0.4.55 → 0.4.57

package/dist/realtimeNative.cjs

@@ -845,6 +845,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") {
@@ -980,6 +981,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;
 }
@@ -1120,6 +1125,7 @@ function useRealtimeSession(options) {
   const documentFlushIdleRef = react.useRef(null);
   const draftPersistTimerRef = react.useRef(null);
   const draftPersistIdleRef = react.useRef(null);
+  const presenceUpdateTimerRef = react.useRef(null);
   const draftStorageRef = react.useRef(draftStorage);
   draftStorageRef.current = draftStorage;
   const manualDisconnectRef = react.useRef(false);
@@ -1144,6 +1150,7 @@ function useRealtimeSession(options) {
     enabled ? "connecting" : "offline"
   );
   const lastConnectionMessageStateUpdateAtRef = react.useRef(null);
+  const lastPresenceSentAtRef = react.useRef(null);
   const localDraftRef = react.useRef(null);
   const conflictRef = react.useRef(null);
   const onErrorRef = react.useRef(onError);
@@ -1208,6 +1215,12 @@ function useRealtimeSession(options) {
     cancelRuntimeIdleCallback(draftPersistIdleRef.current);
     draftPersistIdleRef.current = null;
   }, []);
+  const clearPresenceUpdateSchedule = react.useCallback(() => {
+    if (presenceUpdateTimerRef.current != null) {
+      globalThis.clearTimeout(presenceUpdateTimerRef.current);
+      presenceUpdateTimerRef.current = null;
+    }
+  }, []);
   const updateConnection = react.useCallback(
     (patch) => {
       setConnection((prev) => {
@@ -1566,7 +1579,8 @@ function useRealtimeSession(options) {
     },
     [applyDocument, roomId, scheduleDocumentFlush, setLocalDraft]
   );
-  const sendPresenceUpdate = react.useCallback(() => {
+  const sendPresenceUpdateNow = react.useCallback(() => {
+    lastPresenceSentAtRef.current = nowMs();
     sendRaw({
       type: "presence:update",
       roomId,
@@ -1579,6 +1593,24 @@ function useRealtimeSession(options) {
       }
     });
   }, [roomId, sendRaw]);
+  const sendPresenceUpdate = react.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 = react.useCallback(() => {
     if (!reconnect || manualDisconnectRef.current) return;
     clearReconnectTimer();
@@ -1660,6 +1692,7 @@ function useRealtimeSession(options) {
     if (!roomId) {
       clearDocumentFlushSchedule();
       clearDraftPersistSchedule();
+      clearPresenceUpdateSchedule();
       localDraftRef.current = null;
       setHasLocalOfflineDraft(false);
       setHasPendingDocumentSync(false);
@@ -1702,6 +1735,7 @@ function useRealtimeSession(options) {
     applyDraftSnapshot,
     clearDocumentFlushSchedule,
     clearDraftPersistSchedule,
+    clearPresenceUpdateSchedule,
     roomId,
     setConflictState,
     setLocalDraft
@@ -1714,6 +1748,7 @@ function useRealtimeSession(options) {
       clearHeartbeatTimer();
       clearConnectTimeout();
       clearDocumentFlushSchedule();
+      clearPresenceUpdateSchedule();
       wsRef.current?.close();
       wsRef.current = null;
       queuedDirtyRef.current = localDraftRef.current != null;
@@ -1997,12 +2032,14 @@ function useRealtimeSession(options) {
       clearHeartbeatTimer();
       clearConnectTimeout();
       clearDocumentFlushSchedule();
+      clearPresenceUpdateSchedule();
       socket.close();
     };
   }, [
     clearConnectTimeout,
     clearDocumentFlushSchedule,
     clearHeartbeatTimer,
+    clearPresenceUpdateSchedule,
     clearReconnectTimer,
     connectSequence,
     connectTimeoutMs,
@@ -2030,12 +2067,17 @@ function useRealtimeSession(options) {
     () => () => {
       clearDocumentFlushSchedule();
       clearDraftPersistSchedule();
+      clearPresenceUpdateSchedule();
       if (boardRef.current) {
         boardRef.current.doc.destroy();
         boardRef.current = null;
       }
     },
-    [clearDocumentFlushSchedule, clearDraftPersistSchedule]
+    [
+      clearDocumentFlushSchedule,
+      clearDraftPersistSchedule,
+      clearPresenceUpdateSchedule
+    ]
   );
   const flushDocumentSync = react.useCallback(async () => {
     const board = boardRef.current;
@@ -2087,6 +2129,7 @@ function useRealtimeSession(options) {
     clearReconnectTimer();
     clearHeartbeatTimer();
     clearConnectTimeout();
+    clearPresenceUpdateSchedule();
     sendRaw({
       type: "session:leave",
       roomId,
@@ -2103,6 +2146,7 @@ function useRealtimeSession(options) {
   }, [
     clearConnectTimeout,
     clearHeartbeatTimer,
+    clearPresenceUpdateSchedule,
     clearReconnectTimer,
     collapsePeersToSelf,
     roomId,