@liveblocks/react 2.9.3-experimental1 → 2.10.1-react19

package/dist/{chunk-SNEUTGU4.mjs → chunk-A7GJNN4L.mjs}

@@ -1,41 +1,133 @@
-// src/version.ts
-var PKG_NAME = "@liveblocks/react";
-var PKG_VERSION = "2.9.3-experimental1";
-var PKG_FORMAT = "esm";
-
-// src/ClientSideSuspense.tsx
-import * as React from "react";
-function ClientSideSuspense(props) {
-  const [mounted, setMounted] = React.useState(false);
-  React.useEffect(() => {
-    setMounted(true);
-  }, []);
-  return /* @__PURE__ */ React.createElement(React.Suspense, { fallback: props.fallback }, mounted ? typeof props.children === "function" ? props.children() : props.children : props.fallback);
-}
-
 // src/contexts.ts
-import * as React2 from "react";
-var RoomContext = React2.createContext(null);
+import * as React from "react";
+var RoomContext = React.createContext(null);
 function useRoomOrNull() {
-  return React2.useContext(RoomContext);
+  return React.useContext(RoomContext);
 }
 function useIsInsideRoom() {
   const room = useRoomOrNull();
   return room !== null;
 }
 
+// src/liveblocks.tsx
+import {
+  assert,
+  createClient,
+  kInternal as kInternal2,
+  makePoller,
+  raise,
+  shallow as shallow3
+} from "@liveblocks/core";
+import React2, {
+  createContext as createContext2,
+  useCallback as useCallback2,
+  useContext as useContext2,
+  useEffect as useEffect2,
+  useMemo
+} from "react";
+import { useSyncExternalStore } from "use-sync-external-store/shim/index.js";
+import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/with-selector.js";
+
+// src/config.ts
+var SECONDS = 1e3;
+var MINUTES = 60 * SECONDS;
+var config = {
+  NOTIFICATIONS_POLL_INTERVAL: 1 * MINUTES,
+  NOTIFICATIONS_MAX_STALE_TIME: 5 * SECONDS,
+  ROOM_THREADS_POLL_INTERVAL: 5 * MINUTES,
+  ROOM_THREADS_MAX_STALE_TIME: 5 * SECONDS,
+  USER_THREADS_POLL_INTERVAL: 1 * MINUTES,
+  USER_THREADS_MAX_STALE_TIME: 5 * SECONDS,
+  HISTORY_VERSIONS_POLL_INTERVAL: 1 * MINUTES,
+  HISTORY_VERSIONS_MAX_STALE_TIME: 5 * SECONDS,
+  NOTIFICATION_SETTINGS_POLL_INTERVAL: 1 * MINUTES,
+  NOTIFICATION_SETTINGS_MAX_STALE_TIME: 5 * SECONDS
+};
+
+// src/lib/shallow2.ts
+import { isPlainObject, shallow } from "@liveblocks/core";
+function shallow2(a, b) {
+  if (!isPlainObject(a) || !isPlainObject(b)) {
+    return shallow(a, b);
+  }
+  const keysA = Object.keys(a);
+  if (keysA.length !== Object.keys(b).length) {
+    return false;
+  }
+  return keysA.every(
+    (key) => Object.prototype.hasOwnProperty.call(b, key) && shallow(a[key], b[key])
+  );
+}
+
+// src/lib/use-initial.ts
+import { useCallback, useReducer } from "react";
+
+// src/lib/use-latest.ts
+import { useEffect, useRef } from "react";
+function useLatest(value) {
+  const ref = useRef(value);
+  useEffect(() => {
+    ref.current = value;
+  }, [value]);
+  return ref;
+}
+
+// src/lib/use-initial.ts
+var noop = (state) => state;
+function useInitial(value) {
+  return useReducer(noop, value)[0];
+}
+function useInitialUnlessFunction(latestValue) {
+  const frozenValue = useInitial(latestValue);
+  if (typeof frozenValue === "function") {
+    const ref = useLatest(latestValue);
+    return useCallback((...args) => ref.current(...args), [
+      ref
+    ]);
+  } else {
+    return frozenValue;
+  }
+}
+
+// src/lib/use-polyfill.ts
+var use = (
+  // React.use ||
+  (promise) => {
+    if (promise.status === "pending") {
+      throw promise;
+    } else if (promise.status === "fulfilled") {
+      return promise.value;
+    } else if (promise.status === "rejected") {
+      throw promise.reason;
+    } else {
+      promise.status = "pending";
+      promise.then(
+        (v) => {
+          promise.status = "fulfilled";
+          promise.value = v;
+        },
+        (e) => {
+          promise.status = "rejected";
+          promise.reason = e;
+        }
+      );
+      throw promise;
+    }
+  }
+);
+
 // src/umbrella-store.ts
 import {
   autoRetry,
   compactObject,
   console as console2,
   createStore,
+  HttpError,
   kInternal,
   makeEventSource,
   mapValues,
   nanoid,
   nn,
-  StopRetrying,
   stringify
 } from "@liveblocks/core";
 
@@ -56,21 +148,13 @@ function autobind(self) {
   } while ((obj = Reflect.getPrototypeOf(obj)) && obj !== Object.prototype);
 }
 
-// src/lib/compare.ts
-function byFirstCreated(a, b) {
-  return a.createdAt.getTime() - b.createdAt.getTime();
-}
-function isMoreRecentlyUpdated(a, b) {
-  return byMostRecentlyUpdated(a, b) < 0;
-}
-function byMostRecentlyUpdated(a, b) {
-  return b.updatedAt.getTime() - a.updatedAt.getTime();
-}
+// src/ThreadDB.ts
+import { SortedList } from "@liveblocks/core";
 
 // src/lib/guards.ts
-import { isPlainObject } from "@liveblocks/core";
+import { isPlainObject as isPlainObject2 } from "@liveblocks/core";
 function isStartsWith(blob) {
-  return isPlainObject(blob) && isString(blob.startsWith);
+  return isPlainObject2(blob) && isString(blob.startsWith);
 }
 function isString(value) {
   return typeof value === "string";
@@ -103,8 +187,124 @@ function matchesOperator(value, op) {
   }
 }
 
+// src/ThreadDB.ts
+function sanitizeThread(thread) {
+  if (thread.deletedAt) {
+    if (thread.comments.length > 0) {
+      return { ...thread, comments: [] };
+    }
+  }
+  const hasComment = thread.comments.some((c) => !c.deletedAt);
+  if (!hasComment) {
+    return { ...thread, deletedAt: /* @__PURE__ */ new Date(), comments: [] };
+  }
+  return thread;
+}
+var ThreadDB = class _ThreadDB {
+  // The version is auto-incremented on every mutation and can be used as a reliable indicator to tell if the contents of the thread pool has changed
+  constructor() {
+    this._asc = SortedList.from([], (t1, t2) => {
+      const d1 = t1.createdAt;
+      const d2 = t2.createdAt;
+      return d1 < d2 ? true : d1 === d2 ? t1.id < t2.id : false;
+    });
+    this._desc = SortedList.from([], (t1, t2) => {
+      const d2 = t2.updatedAt;
+      const d1 = t1.updatedAt;
+      return d2 < d1 ? true : d2 === d1 ? t2.id < t1.id : false;
+    });
+    this._byId = /* @__PURE__ */ new Map();
+    this._version = 0;
+  }
+  //
+  // Public APIs
+  //
+  clone() {
+    const newPool = new _ThreadDB();
+    newPool._byId = new Map(this._byId);
+    newPool._asc = this._asc.clone();
+    newPool._desc = this._desc.clone();
+    newPool._version = this._version;
+    return newPool;
+  }
+  /** Gets the transaction count for this DB. Increments any time the DB is modified. */
+  get version() {
+    return this._version;
+  }
+  /** Returns an existing thread by ID. Will never return a deleted thread. */
+  get(threadId) {
+    const thread = this.getEvenIfDeleted(threadId);
+    return thread?.deletedAt ? void 0 : thread;
+  }
+  /** Returns the (possibly deleted) thread by ID. */
+  getEvenIfDeleted(threadId) {
+    return this._byId.get(threadId);
+  }
+  /** Adds or updates a thread in the DB. If the newly given thread is a deleted one, it will get deleted. */
+  upsert(thread) {
+    thread = sanitizeThread(thread);
+    const id = thread.id;
+    const toRemove = this._byId.get(id);
+    if (toRemove) {
+      if (toRemove.deletedAt) return;
+      this._asc.remove(toRemove);
+      this._desc.remove(toRemove);
+    }
+    if (!thread.deletedAt) {
+      this._asc.add(thread);
+      this._desc.add(thread);
+    }
+    this._byId.set(id, thread);
+    this.touch();
+  }
+  /** Like .upsert(), except it won't update if a thread by this ID already exists. */
+  // TODO Consider renaming this to just .upsert(). I'm not sure if we really
+  // TODO need the raw .upsert(). Would be nice if this behavior was the default.
+  upsertIfNewer(thread) {
+    const existing = this.get(thread.id);
+    if (!existing || thread.updatedAt >= existing.updatedAt) {
+      this.upsert(thread);
+    }
+  }
+  /**
+   * Marks a thread as deleted. It will no longer pop up in .findMany()
+   * queries, but it can still be accessed via `.getEvenIfDeleted()`.
+   */
+  delete(threadId, deletedAt) {
+    const existing = this._byId.get(threadId);
+    if (existing && !existing.deletedAt) {
+      this.upsert({ ...existing, deletedAt, updatedAt: deletedAt });
+    }
+  }
+  /**
+   * Returns all threads matching a given roomId and query. If roomId is not
+   * specified, it will return all threads matching the query, across all
+   * rooms.
+   *
+   * Returns the results in the requested order. Please note:
+   *   'asc'  means by createdAt ASC
+   *   'desc' means by updatedAt DESC
+   *
+   * Will never return deleted threads in the result.
+   */
+  findMany(roomId, query, direction) {
+    const index = direction === "desc" ? this._desc : this._asc;
+    const crit = [];
+    if (roomId !== void 0) {
+      crit.push((t) => t.roomId === roomId);
+    }
+    crit.push(makeThreadsFilter(query));
+    return Array.from(index.filter((t) => crit.every((pred) => pred(t))));
+  }
+  //
+  // Private APIs
+  //
+  touch() {
+    ++this._version;
+  }
+};
+
 // src/umbrella-store.ts
-var ASYNC_OK = Object.freeze({ isLoading: false, data: void 0 });
 function makeRoomThreadsQueryKey(roomId, query) {
   return `${roomId}-${stringify(query ?? {})}`;
 }
@@ -117,19 +317,6 @@ function makeNotificationSettingsQueryKey(roomId) {
 function makeVersionsQueryKey(roomId) {
   return `${roomId}-VERSIONS`;
 }
-function selectThreads(state, options) {
-  let threads = state.threads;
-  if (options.roomId !== null) {
-    threads = threads.filter((thread) => thread.roomId === options.roomId);
-  }
-  const query = options.query;
-  if (query) {
-    threads = threads.filter(makeThreadsFilter(query));
-  }
-  return threads.sort(
-    options.orderBy === "last-update" ? byMostRecentlyUpdated : byFirstCreated
-  );
-}
 function usify(promise) {
   if ("status" in promise) {
     return promise;
@@ -148,7 +335,7 @@ function usify(promise) {
   );
   return usable;
 }
-var noop = Promise.resolve();
+var noop2 = Promise.resolve();
 var ASYNC_LOADING = Object.freeze({ isLoading: true });
 var PaginatedResource = class {
   constructor(fetchPage) {
@@ -189,7 +376,7 @@ var PaginatedResource = class {
   fetchMore() {
     const state = this._paginationState;
     if (state?.cursor === null) {
-      return noop;
+      return noop2;
     }
     if (!this._pendingFetchMore) {
       this._pendingFetchMore = this._fetchMore().finally(() => {
@@ -252,8 +439,54 @@ var PaginatedResource = class {
     return promise;
   }
 };
+var SinglePageResource = class {
+  constructor(fetchPage) {
+    this._cachedPromise = null;
+    this._fetchPage = fetchPage;
+    this._eventSource = makeEventSource();
+    this.observable = this._eventSource.observable;
+    autobind(this);
+  }
+  get() {
+    const usable = this._cachedPromise;
+    if (usable === null || usable.status === "pending") {
+      return ASYNC_LOADING;
+    }
+    if (usable.status === "rejected") {
+      return { isLoading: false, error: usable.reason };
+    }
+    return {
+      isLoading: false,
+      data: void 0
+    };
+  }
+  waitUntilLoaded() {
+    if (this._cachedPromise) {
+      return this._cachedPromise;
+    }
+    const initialFetcher = autoRetry(
+      () => this._fetchPage(),
+      5,
+      [5e3, 5e3, 1e4, 15e3]
+    );
+    const promise = usify(initialFetcher);
+    promise.then(
+      () => this._eventSource.notify(),
+      () => {
+        this._eventSource.notify();
+        setTimeout(() => {
+          this._cachedPromise = null;
+          this._eventSource.notify();
+        }, 5e3);
+      }
+    );
+    this._cachedPromise = promise;
+    return promise;
+  }
+};
 var UmbrellaStore = class {
   constructor(client) {
+    this._prevVersion = -1;
     this._prevState = null;
     this._stateCached = null;
     // Notifications
@@ -264,16 +497,16 @@ var UmbrellaStore = class {
     // User Threads
     this._userThreadsLastRequestedAt = null;
     this._userThreads = /* @__PURE__ */ new Map();
+    // Room versions
+    this._roomVersions = /* @__PURE__ */ new Map();
+    this._roomVersionsLastRequestedAtByRoom = /* @__PURE__ */ new Map();
+    // Room notification settings
+    this._roomNotificationSettings = /* @__PURE__ */ new Map();
+    this._client = client[kInternal].as();
     const inboxFetcher = async (cursor) => {
-      if (client === void 0) {
-        throw new StopRetrying(
-          "Client is required in order to load threads for the room"
-        );
-      }
-      const result = await client.getInboxNotifications({ cursor });
+      const result = await this._client.getInboxNotifications({ cursor });
       this.updateThreadsAndNotifications(
         result.threads,
-        // TODO: Figure out how to remove this casting
         result.inboxNotifications
       );
       if (this._notificationsLastRequestedAt === null) {
@@ -282,7 +515,6 @@ var UmbrellaStore = class {
       const nextCursor = result.nextCursor;
       return nextCursor;
     };
-    this._client = client;
     this._notifications = new PaginatedResource(inboxFetcher);
     this._notifications.observable.subscribe(
       () => (
@@ -291,10 +523,8 @@ var UmbrellaStore = class {
         this._store.set((store) => ({ ...store }))
       )
     );
+    this._rawThreadsDB = new ThreadDB();
     this._store = createStore({
-      rawThreadsById: {},
-      queries3: {},
-      queries4: {},
       optimisticUpdates: [],
       notificationsById: {},
       settingsByRoomId: {},
@@ -304,9 +534,11 @@ var UmbrellaStore = class {
   }
   get() {
     const rawState = this._store.get();
-    if (this._prevState !== rawState || this._stateCached === null) {
+    if (this._prevVersion !== this._rawThreadsDB.version || // Note: Version check is only needed temporarily, until we can get rid of the Zustand-like update model
+    this._prevState !== rawState || this._stateCached === null) {
+      this._stateCached = internalToExternalState(rawState, this._rawThreadsDB);
       this._prevState = rawState;
-      this._stateCached = internalToExternalState(rawState);
+      this._prevVersion = this._rawThreadsDB.version;
     }
     return this._stateCached;
   }
@@ -321,8 +553,7 @@ var UmbrellaStore = class {
    * then it will return the threads that match that provided query and room id.
    *
    */
-  // XXXX Find a better name for that doesn't associate to 'async'
-  getRoomThreadsAsync(roomId, query) {
+  getRoomThreadsLoadingState(roomId, query) {
     const queryKey = makeRoomThreadsQueryKey(roomId, query);
     const paginatedResource = this._roomThreads.get(queryKey);
     if (paginatedResource === void 0) {
@@ -332,11 +563,11 @@ var UmbrellaStore = class {
     if (asyncResult.isLoading || asyncResult.error) {
       return asyncResult;
     }
-    const threads = selectThreads(this.getFullState(), {
+    const threads = this.getFullState().threadsDB.findMany(
       roomId,
-      query,
-      orderBy: "age"
-    });
+      query ?? {},
+      "asc"
+    );
     const page = asyncResult.data;
     return {
       isLoading: false,
@@ -347,8 +578,7 @@ var UmbrellaStore = class {
       fetchMore: page.fetchMore
     };
   }
-  // XXXX - Find a better name for that doesn't associate to 'async'
-  getUserThreadsAsync(query) {
+  getUserThreadsLoadingState(query) {
     const queryKey = makeUserThreadsQueryKey(query);
     const paginatedResource = this._userThreads.get(queryKey);
     if (paginatedResource === void 0) {
@@ -358,12 +588,12 @@ var UmbrellaStore = class {
     if (asyncResult.isLoading || asyncResult.error) {
       return asyncResult;
     }
-    const threads = selectThreads(this.getFullState(), {
-      roomId: null,
+    const threads = this.getFullState().threadsDB.findMany(
+      void 0,
       // Do _not_ filter by roomId
-      query,
-      orderBy: "last-update"
-    });
+      query ?? {},
+      "desc"
+    );
     const page = asyncResult.data;
     return {
       isLoading: false,
@@ -375,8 +605,7 @@ var UmbrellaStore = class {
     };
   }
   // NOTE: This will read the async result, but WILL NOT start loading at the moment!
-  // XXXX - Find a better name for that doesn't associate to 'async'
-  getInboxNotificationsAsync() {
+  getInboxNotificationsLoadingState() {
     const asyncResult = this._notifications.get();
     if (asyncResult.isLoading || asyncResult.error) {
       return asyncResult;
@@ -384,7 +613,7 @@ var UmbrellaStore = class {
     const page = asyncResult.data;
     return {
       isLoading: false,
-      inboxNotifications: this.getFullState().notifications,
+      inboxNotifications: this.getFullState().cleanedNotifications,
       hasFetchedAll: page.hasFetchedAll,
       isFetchingMore: page.isFetchingMore,
       fetchMoreError: page.fetchMoreError,
@@ -392,32 +621,34 @@ var UmbrellaStore = class {
     };
   }
   // NOTE: This will read the async result, but WILL NOT start loading at the moment!
-  getNotificationSettingsAsync(roomId) {
-    const state = this.get();
-    const query = state.queries3[makeNotificationSettingsQueryKey(roomId)];
-    if (query === void 0 || query.isLoading) {
+  getNotificationSettingsLoadingState(roomId) {
+    const queryKey = makeNotificationSettingsQueryKey(roomId);
+    const resource = this._roomNotificationSettings.get(queryKey);
+    if (resource === void 0) {
       return ASYNC_LOADING;
     }
-    if (query.error !== void 0) {
-      return query;
+    const asyncResult = resource.get();
+    if (asyncResult.isLoading || asyncResult.error) {
+      return asyncResult;
     }
     return {
       isLoading: false,
-      settings: nn(state.settingsByRoomId[roomId])
+      settings: nn(this.get().settingsByRoomId[roomId])
     };
   }
-  getVersionsAsync(roomId) {
-    const state = this.get();
-    const query = state.queries4[makeVersionsQueryKey(roomId)];
-    if (query === void 0 || query.isLoading) {
+  getRoomVersionsLoadingState(roomId) {
+    const queryKey = makeVersionsQueryKey(roomId);
+    const resource = this._roomVersions.get(queryKey);
+    if (resource === void 0) {
       return ASYNC_LOADING;
     }
-    if (query.error !== void 0) {
-      return query;
+    const asyncResult = resource.get();
+    if (asyncResult.isLoading || asyncResult.error) {
+      return asyncResult;
     }
     return {
       isLoading: false,
-      versions: nn(state.versionsByRoomId[roomId])
+      versions: Object.values(this.get().versionsByRoomId[roomId] ?? {})
     };
   }
   /**
@@ -429,33 +660,14 @@ var UmbrellaStore = class {
   subscribe(callback) {
     return this._store.subscribe(callback);
   }
-  /**
-   * @private Only used by the E2E test suite.
-   */
-  _subscribeOptimisticUpdates(callback) {
-    return this.subscribe(callback);
-  }
-  subscribeThreads(callback) {
-    return this.subscribe(callback);
-  }
-  subscribeUserThreads(callback) {
-    return this.subscribe(callback);
-  }
-  subscribeThreadsOrInboxNotifications(callback) {
-    return this.subscribe(callback);
-  }
-  subscribeNotificationSettings(callback) {
-    return this.subscribe(callback);
-  }
-  subscribeVersions(callback) {
-    return this.subscribe(callback);
-  }
   // Direct low-level cache mutations ------------------------------------------------- {{{
-  updateThreadsCache(mapFn) {
-    this._store.set((state) => {
-      const threads = mapFn(state.rawThreadsById);
-      return threads !== state.rawThreadsById ? { ...state, rawThreadsById: threads } : state;
-    });
+  mutateThreadsDB(mutate) {
+    const db = this._rawThreadsDB;
+    const old = db.version;
+    mutate(db);
+    if (old !== db.version) {
+      this._store.set((state) => ({ ...state }));
+    }
   }
   updateInboxNotificationsCache(mapFn) {
     this._store.set((state) => {
@@ -472,32 +684,23 @@ var UmbrellaStore = class {
       }
     }));
   }
-  setVersions(roomId, versions) {
-    this._store.set((state) => ({
-      ...state,
-      versionsByRoomId: {
-        ...state.versionsByRoomId,
-        [roomId]: versions
-      }
-    }));
-  }
-  setQuery3State(queryKey, queryState) {
-    this._store.set((state) => ({
-      ...state,
-      queries3: {
-        ...state.queries3,
-        [queryKey]: queryState
-      }
-    }));
-  }
-  setQuery4State(queryKey, queryState) {
-    this._store.set((state) => ({
-      ...state,
-      queries4: {
-        ...state.queries4,
-        [queryKey]: queryState
-      }
-    }));
+  updateRoomVersions(roomId, versions) {
+    this._store.set((state) => {
+      const versionsById = Object.fromEntries(
+        versions.map((version2) => [version2.id, version2])
+      );
+      return {
+        ...state,
+        versionsByRoomId: {
+          ...state.versionsByRoomId,
+          [roomId]: {
+            // Merge with existing versions for the room, or start with an empty object
+            ...state.versionsByRoomId[roomId] ?? {},
+            ...versionsById
+          }
+        }
+      };
+    });
   }
   updateOptimisticUpdatesCache(mapFn) {
     this._store.set((state) => ({
@@ -572,7 +775,7 @@ var UmbrellaStore = class {
   createThread(optimisticUpdateId, thread) {
     this._store.batch(() => {
       this.removeOptimisticUpdate(optimisticUpdateId);
-      this.updateThreadsCache((cache) => ({ ...cache, [thread.id]: thread }));
+      this.mutateThreadsDB((db) => db.upsert(thread));
     });
   }
   /**
@@ -590,18 +793,11 @@ var UmbrellaStore = class {
       if (optimisticUpdateId !== null) {
         this.removeOptimisticUpdate(optimisticUpdateId);
       }
-      this.updateThreadsCache((cache) => {
-        const existing = cache[threadId];
-        if (!existing) {
-          return cache;
-        }
-        if (existing.deletedAt !== void 0) {
-          return cache;
-        }
-        if (!!updatedAt && existing.updatedAt > updatedAt) {
-          return cache;
-        }
-        return { ...cache, [threadId]: callback(existing) };
+      this.mutateThreadsDB((db) => {
+        const existing = db.get(threadId);
+        if (!existing) return;
+        if (!!updatedAt && existing.updatedAt > updatedAt) return;
+        db.upsert(callback(existing));
       });
     });
   }
@@ -652,14 +848,13 @@ var UmbrellaStore = class {
   createComment(newComment, optimisticUpdateId) {
     this._store.batch(() => {
       this.removeOptimisticUpdate(optimisticUpdateId);
-      const existingThread = this._store.get().rawThreadsById[newComment.threadId];
+      const existingThread = this._rawThreadsDB.get(newComment.threadId);
       if (!existingThread) {
         return;
       }
-      this.updateThreadsCache((cache) => ({
-        ...cache,
-        [newComment.threadId]: applyUpsertComment(existingThread, newComment)
-      }));
+      this.mutateThreadsDB(
+        (db) => db.upsert(applyUpsertComment(existingThread, newComment))
+      );
       this.updateInboxNotificationsCache((cache) => {
         const existingNotification = Object.values(cache).find(
           (notification) => notification.kind === "thread" && notification.threadId === newComment.threadId
@@ -695,10 +890,7 @@ var UmbrellaStore = class {
   }
   updateThreadAndNotification(thread, inboxNotification) {
     this._store.batch(() => {
-      this.updateThreadsCache((cache) => {
-        const existingThread = cache[thread.id];
-        return existingThread === void 0 || isMoreRecentlyUpdated(thread, existingThread) ? { ...cache, [thread.id]: thread } : cache;
-      });
+      this.mutateThreadsDB((db) => db.upsertIfNewer(thread));
       if (inboxNotification !== void 0) {
         this.updateInboxNotificationsCache((cache) => ({
           ...cache,
@@ -709,11 +901,8 @@ var UmbrellaStore = class {
   }
   updateThreadsAndNotifications(threads, inboxNotifications, deletedThreads = [], deletedInboxNotifications = []) {
     this._store.batch(() => {
-      this.updateThreadsCache(
-        (cache) => applyThreadUpdates(cache, {
-          newThreads: threads,
-          deletedThreads
-        })
+      this.mutateThreadsDB(
+        (db) => applyThreadDeltaUpdates(db, { newThreads: threads, deletedThreads })
       );
       this.updateInboxNotificationsCache(
         (cache) => applyNotificationsUpdates(cache, {
@@ -727,28 +916,12 @@ var UmbrellaStore = class {
    * Updates existing notification setting for a room with a new value,
    * replacing the corresponding optimistic update.
    */
-  // XXXX Rename this helper method
-  updateRoomInboxNotificationSettings2(roomId, optimisticUpdateId, settings) {
+  updateRoomNotificationSettings_confirmOptimisticUpdate(roomId, optimisticUpdateId, settings) {
     this._store.batch(() => {
       this.removeOptimisticUpdate(optimisticUpdateId);
       this.setNotificationSettings(roomId, settings);
     });
   }
-  // XXXX Rename this helper method
-  updateRoomInboxNotificationSettings(roomId, settings, queryKey) {
-    this._store.batch(() => {
-      this.setQuery3OK(queryKey);
-      this.setNotificationSettings(roomId, settings);
-    });
-  }
-  updateRoomVersions(roomId, versions, queryKey) {
-    this._store.batch(() => {
-      this.setVersions(roomId, versions);
-      if (queryKey !== void 0) {
-        this.setQuery4OK(queryKey);
-      }
-    });
-  }
   addOptimisticUpdate(optimisticUpdate) {
     const id = nanoid();
     const newUpdate = { ...optimisticUpdate, id };
@@ -760,36 +933,15 @@ var UmbrellaStore = class {
       (cache) => cache.filter((ou) => ou.id !== optimisticUpdateId)
     );
   }
-  // Query 3
-  setQuery3Loading(queryKey) {
-    this.setQuery3State(queryKey, ASYNC_LOADING);
-  }
-  setQuery3OK(queryKey) {
-    this.setQuery3State(queryKey, ASYNC_OK);
-  }
-  setQuery3Error(queryKey, error) {
-    this.setQuery3State(queryKey, { isLoading: false, error });
-  }
-  // Query 4
-  setQuery4Loading(queryKey) {
-    this.setQuery4State(queryKey, ASYNC_LOADING);
-  }
-  setQuery4OK(queryKey) {
-    this.setQuery4State(queryKey, ASYNC_OK);
-  }
-  setQuery4Error(queryKey, error) {
-    this.setQuery4State(queryKey, { isLoading: false, error });
-  }
-  async fetchNotificationsDeltaUpdate() {
+  async fetchNotificationsDeltaUpdate(signal) {
     const lastRequestedAt = this._notificationsLastRequestedAt;
     if (lastRequestedAt === null) {
       return;
     }
-    const client = nn(
-      this._client,
-      "Client is required in order to load notifications for the room"
-    );
-    const result = await client.getInboxNotificationsSince(lastRequestedAt);
+    const result = await this._client.getInboxNotificationsSince({
+      since: lastRequestedAt,
+      signal
+    });
     if (lastRequestedAt < result.requestedAt) {
       this._notificationsLastRequestedAt = result.requestedAt;
     }
@@ -805,21 +957,13 @@ var UmbrellaStore = class {
   }
   waitUntilRoomThreadsLoaded(roomId, query) {
     const threadsFetcher = async (cursor) => {
-      if (this._client === void 0) {
-        throw new StopRetrying(
-          "Client is required in order to load threads for the room"
-        );
-      }
       const room = this._client.getRoom(roomId);
       if (room === null) {
-        throw new StopRetrying(
-          `Room with id ${roomId} is not available on client`
-        );
+        throw new HttpError(`Room '${roomId}' is not available on client`, 479);
       }
       const result = await room.getThreads({ cursor, query });
       this.updateThreadsAndNotifications(
         result.threads,
-        // TODO: Figure out how to remove this casting
         result.inboxNotifications
       );
       const lastRequestedAt = this._roomThreadsLastRequestedAtByRoom.get(roomId);
@@ -843,21 +987,18 @@ var UmbrellaStore = class {
     this._roomThreads.set(queryKey, paginatedResource);
     return paginatedResource.waitUntilLoaded();
   }
-  async fetchRoomThreadsDeltaUpdate(roomId) {
+  async fetchRoomThreadsDeltaUpdate(roomId, signal) {
     const lastRequestedAt = this._roomThreadsLastRequestedAtByRoom.get(roomId);
     if (lastRequestedAt === void 0) {
       return;
     }
-    const client = nn(
-      this._client,
-      "Client is required in order to load notifications for the room"
-    );
     const room = nn(
-      client.getRoom(roomId),
+      this._client.getRoom(roomId),
       `Room with id ${roomId} is not available on client`
     );
     const updates = await room.getThreadsSince({
-      since: lastRequestedAt
+      since: lastRequestedAt,
+      signal
     });
     this.updateThreadsAndNotifications(
       updates.threads.updated,
@@ -872,18 +1013,12 @@ var UmbrellaStore = class {
   waitUntilUserThreadsLoaded(query) {
     const queryKey = makeUserThreadsQueryKey(query);
     const threadsFetcher = async (cursor) => {
-      if (this._client === void 0) {
-        throw new StopRetrying(
-          "Client is required in order to load threads for the room"
-        );
-      }
       const result = await this._client[kInternal].getUserThreads_experimental({
         cursor,
         query
       });
       this.updateThreadsAndNotifications(
         result.threads,
-        // TODO: Figure out how to remove this casting
         result.inboxNotifications
       );
       if (this._userThreadsLastRequestedAt === null) {
@@ -905,17 +1040,14 @@ var UmbrellaStore = class {
     this._userThreads.set(queryKey, paginatedResource);
     return paginatedResource.waitUntilLoaded();
   }
-  async fetchUserThreadsDeltaUpdate() {
+  async fetchUserThreadsDeltaUpdate(signal) {
     const lastRequestedAt = this._userThreadsLastRequestedAt;
     if (lastRequestedAt === null) {
       return;
     }
-    const client = nn(
-      this._client,
-      "Client is required in order to load threads for the user"
-    );
-    const result = await client[kInternal].getUserThreadsSince_experimental({
-      since: lastRequestedAt
+    const result = await this._client[kInternal].getUserThreadsSince_experimental({
+      since: lastRequestedAt,
+      signal
     });
     if (lastRequestedAt < result.requestedAt) {
       this._notificationsLastRequestedAt = result.requestedAt;
@@ -927,77 +1059,138 @@ var UmbrellaStore = class {
       result.inboxNotifications.deleted
     );
   }
+  waitUntilRoomVersionsLoaded(roomId) {
+    const queryKey = makeVersionsQueryKey(roomId);
+    let resource = this._roomVersions.get(queryKey);
+    if (resource === void 0) {
+      const versionsFetcher = async () => {
+        const room = this._client.getRoom(roomId);
+        if (room === null) {
+          throw new HttpError(
+            `Room '${roomId}' is not available on client`,
+            479
+          );
+        }
+        const result = await room[kInternal].listTextVersions();
+        this.updateRoomVersions(roomId, result.versions);
+        const lastRequestedAt = this._roomVersionsLastRequestedAtByRoom.get(roomId);
+        if (lastRequestedAt === void 0 || lastRequestedAt > result.requestedAt) {
+          this._roomVersionsLastRequestedAtByRoom.set(
+            roomId,
+            result.requestedAt
+          );
+        }
+      };
+      resource = new SinglePageResource(versionsFetcher);
+    }
+    resource.observable.subscribe(
+      () => (
+        // Note that the store itself does not change, but it's only vehicle at
+        // the moment to trigger a re-render, so we'll do a no-op update here.
+        this._store.set((store) => ({ ...store }))
+      )
+    );
+    this._roomVersions.set(queryKey, resource);
+    return resource.waitUntilLoaded();
+  }
+  async fetchRoomVersionsDeltaUpdate(roomId, signal) {
+    const lastRequestedAt = this._roomVersionsLastRequestedAtByRoom.get(roomId);
+    if (lastRequestedAt === void 0) {
+      return;
+    }
+    const room = nn(
+      this._client.getRoom(roomId),
+      `Room with id ${roomId} is not available on client`
+    );
+    const updates = await room[kInternal].listTextVersionsSince({
+      since: lastRequestedAt,
+      signal
+    });
+    this.updateRoomVersions(roomId, updates.versions);
+    if (lastRequestedAt < updates.requestedAt) {
+      this._roomVersionsLastRequestedAtByRoom.set(roomId, updates.requestedAt);
+    }
+  }
+  waitUntilRoomNotificationSettingsLoaded(roomId) {
+    const queryKey = makeNotificationSettingsQueryKey(roomId);
+    let resource = this._roomNotificationSettings.get(queryKey);
+    if (resource === void 0) {
+      const notificationSettingsFetcher = async () => {
+        const room = this._client.getRoom(roomId);
+        if (room === null) {
+          throw new HttpError(
+            `Room '${roomId}' is not available on client`,
+            479
+          );
+        }
+        const result = await room.getNotificationSettings();
+        this.setNotificationSettings(roomId, result);
+      };
+      resource = new SinglePageResource(notificationSettingsFetcher);
+    }
+    resource.observable.subscribe(
+      () => (
+        // Note that the store itself does not change, but it's only vehicle at
+        // the moment to trigger a re-render, so we'll do a no-op update here.
+        this._store.set((store) => ({ ...store }))
+      )
+    );
+    this._roomNotificationSettings.set(queryKey, resource);
+    return resource.waitUntilLoaded();
+  }
+  async refreshRoomNotificationSettings(roomId, signal) {
+    const room = nn(
+      this._client.getRoom(roomId),
+      `Room with id ${roomId} is not available on client`
+    );
+    const result = await room.getNotificationSettings({ signal });
+    this.setNotificationSettings(roomId, result);
+  }
 };
-function internalToExternalState(state) {
+function internalToExternalState(state, rawThreadsDB) {
+  const threadsDB = rawThreadsDB.clone();
   const computed = {
-    threadsById: { ...state.rawThreadsById },
     notificationsById: { ...state.notificationsById },
     settingsByRoomId: { ...state.settingsByRoomId }
   };
   for (const optimisticUpdate of state.optimisticUpdates) {
     switch (optimisticUpdate.type) {
       case "create-thread": {
-        computed.threadsById[optimisticUpdate.thread.id] = optimisticUpdate.thread;
+        threadsDB.upsert(optimisticUpdate.thread);
         break;
       }
       case "edit-thread-metadata": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        if (thread.deletedAt !== void 0) {
-          break;
-        }
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
         if (thread.updatedAt > optimisticUpdate.updatedAt) {
           break;
         }
-        computed.threadsById[thread.id] = {
+        threadsDB.upsert({
           ...thread,
           updatedAt: optimisticUpdate.updatedAt,
           metadata: {
             ...thread.metadata,
             ...optimisticUpdate.metadata
           }
-        };
+        });
         break;
       }
       case "mark-thread-as-resolved": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        if (thread.deletedAt !== void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = {
-          ...thread,
-          resolved: true
-        };
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert({ ...thread, resolved: true });
         break;
       }
       case "mark-thread-as-unresolved": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        if (thread.deletedAt !== void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = {
-          ...thread,
-          resolved: false
-        };
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert({ ...thread, resolved: false });
         break;
       }
       case "create-comment": {
-        const thread = computed.threadsById[optimisticUpdate.comment.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = applyUpsertComment(
-          thread,
-          optimisticUpdate.comment
-        );
+        const thread = threadsDB.get(optimisticUpdate.comment.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert(applyUpsertComment(thread, optimisticUpdate.comment));
         const inboxNotification = Object.values(
           computed.notificationsById
         ).find(
@@ -1012,66 +1205,59 @@ function internalToExternalState(state) {
           readAt: optimisticUpdate.comment.createdAt
         };
         break;
-      }
-      case "edit-comment": {
-        const thread = computed.threadsById[optimisticUpdate.comment.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = applyUpsertComment(
-          thread,
-          optimisticUpdate.comment
-        );
+      }
+      case "edit-comment": {
+        const thread = threadsDB.get(optimisticUpdate.comment.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert(applyUpsertComment(thread, optimisticUpdate.comment));
         break;
       }
       case "delete-comment": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = applyDeleteComment(
-          thread,
-          optimisticUpdate.commentId,
-          optimisticUpdate.deletedAt
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert(
+          applyDeleteComment(
+            thread,
+            optimisticUpdate.commentId,
+            optimisticUpdate.deletedAt
+          )
         );
         break;
       }
       case "delete-thread": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[optimisticUpdate.threadId] = {
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert({
           ...thread,
           deletedAt: optimisticUpdate.deletedAt,
           updatedAt: optimisticUpdate.deletedAt,
           comments: []
-        };
+        });
         break;
       }
       case "add-reaction": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = applyAddReaction(
-          thread,
-          optimisticUpdate.commentId,
-          optimisticUpdate.reaction
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert(
+          applyAddReaction(
+            thread,
+            optimisticUpdate.commentId,
+            optimisticUpdate.reaction
+          )
         );
         break;
       }
       case "remove-reaction": {
-        const thread = computed.threadsById[optimisticUpdate.threadId];
-        if (thread === void 0) {
-          break;
-        }
-        computed.threadsById[thread.id] = applyRemoveReaction(
-          thread,
-          optimisticUpdate.commentId,
-          optimisticUpdate.emoji,
-          optimisticUpdate.userId,
-          optimisticUpdate.removedAt
+        const thread = threadsDB.get(optimisticUpdate.threadId);
+        if (thread === void 0) break;
+        threadsDB.upsert(
+          applyRemoveReaction(
+            thread,
+            optimisticUpdate.commentId,
+            optimisticUpdate.emoji,
+            optimisticUpdate.userId,
+            optimisticUpdate.removedAt
+          )
         );
         break;
       }
@@ -1119,51 +1305,27 @@ function internalToExternalState(state) {
       }
     }
   }
-  const cleanedThreads = (
-    // Don't expose any soft-deleted threads
-    Object.values(computed.threadsById).filter((thread) => !thread.deletedAt).filter(
-      (thread) => (
-        // Only keep a thread if there is at least one non-deleted comment
-        thread.comments.some((c) => c.deletedAt === void 0)
-      )
-    )
-  );
   const cleanedNotifications = (
     // Sort so that the most recent notifications are first
     Object.values(computed.notificationsById).filter(
-      (ibn) => ibn.kind === "thread" ? computed.threadsById[ibn.threadId] && computed.threadsById[ibn.threadId]?.deletedAt === void 0 : true
+      (ibn) => ibn.kind === "thread" ? threadsDB.get(ibn.threadId) !== void 0 : true
     ).sort((a, b) => b.notifiedAt.getTime() - a.notifiedAt.getTime())
   );
   return {
-    notifications: cleanedNotifications,
+    cleanedNotifications,
     notificationsById: computed.notificationsById,
     settingsByRoomId: computed.settingsByRoomId,
-    queries3: state.queries3,
-    queries4: state.queries4,
-    threads: cleanedThreads,
-    threadsById: computed.threadsById,
+    threadsDB,
     versionsByRoomId: state.versionsByRoomId
   };
 }
-function applyThreadUpdates(existingThreads, updates) {
-  const updatedThreads = { ...existingThreads };
-  updates.newThreads.forEach((thread) => {
-    const existingThread = updatedThreads[thread.id];
-    if (existingThread) {
-      if (isMoreRecentlyUpdated(existingThread, thread)) {
-        return;
-      }
-    }
-    updatedThreads[thread.id] = thread;
-  });
+function applyThreadDeltaUpdates(db, updates) {
+  updates.newThreads.forEach((thread) => db.upsertIfNewer(thread));
   updates.deletedThreads.forEach(({ id, deletedAt }) => {
-    const existingThread = updatedThreads[id];
-    if (existingThread === void 0) return;
-    existingThread.deletedAt = deletedAt;
-    existingThread.updatedAt = deletedAt;
-    existingThread.comments = [];
+    const existing = db.getEvenIfDeleted(id);
+    if (!existing) return;
+    db.delete(id, deletedAt);
   });
-  return updatedThreads;
 }
 function applyNotificationsUpdates(existingInboxNotifications, updates) {
   const updatedInboxNotifications = { ...existingInboxNotifications };
@@ -1361,97 +1523,6 @@ function upsertReaction(reactions, reaction) {
   return reactions;
 }
 
-// src/liveblocks.tsx
-import {
-  assert,
-  createClient,
-  kInternal as kInternal2,
-  makePoller,
-  raise,
-  shallow as shallow3
-} from "@liveblocks/core";
-import React3, {
-  createContext as createContext2,
-  useCallback as useCallback2,
-  useContext as useContext2,
-  useEffect as useEffect3,
-  useMemo
-} from "react";
-import { useSyncExternalStore } from "use-sync-external-store/shim/index.js";
-import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/with-selector.js";
-
-// src/lib/shallow2.ts
-import { isPlainObject as isPlainObject2, shallow } from "@liveblocks/core";
-function shallow2(a, b) {
-  if (!isPlainObject2(a) || !isPlainObject2(b)) {
-    return shallow(a, b);
-  }
-  const keysA = Object.keys(a);
-  if (keysA.length !== Object.keys(b).length) {
-    return false;
-  }
-  return keysA.every(
-    (key) => Object.prototype.hasOwnProperty.call(b, key) && shallow(a[key], b[key])
-  );
-}
-
-// src/lib/use-initial.ts
-import { useCallback, useReducer } from "react";
-
-// src/lib/use-latest.ts
-import { useEffect as useEffect2, useRef } from "react";
-function useLatest(value) {
-  const ref = useRef(value);
-  useEffect2(() => {
-    ref.current = value;
-  }, [value]);
-  return ref;
-}
-
-// src/lib/use-initial.ts
-var noop2 = (state) => state;
-function useInitial(value) {
-  return useReducer(noop2, value)[0];
-}
-function useInitialUnlessFunction(latestValue) {
-  const frozenValue = useInitial(latestValue);
-  if (typeof frozenValue === "function") {
-    const ref = useLatest(latestValue);
-    return useCallback((...args) => ref.current(...args), [
-      ref
-    ]);
-  } else {
-    return frozenValue;
-  }
-}
-
-// src/lib/use-polyfill.ts
-var use = (
-  // React.use ||
-  (promise) => {
-    if (promise.status === "pending") {
-      throw promise;
-    } else if (promise.status === "fulfilled") {
-      return promise.value;
-    } else if (promise.status === "rejected") {
-      throw promise.reason;
-    } else {
-      promise.status = "pending";
-      promise.then(
-        (v) => {
-          promise.status = "fulfilled";
-          promise.value = v;
-        },
-        (e) => {
-          promise.status = "rejected";
-          promise.reason = e;
-        }
-      );
-      throw promise;
-    }
-  }
-);
-
 // src/liveblocks.tsx
 var ClientContext = createContext2(null);
 function missingUserError(userId) {
@@ -1468,7 +1539,6 @@ function identity(x) {
 var _umbrellaStores = /* @__PURE__ */ new WeakMap();
 var _extras = /* @__PURE__ */ new WeakMap();
 var _bundles = /* @__PURE__ */ new WeakMap();
-var POLLING_INTERVAL = 60 * 1e3;
 function selectUnreadInboxNotificationsCount(inboxNotifications) {
   let count = 0;
   for (const notification of inboxNotifications) {
@@ -1547,61 +1617,36 @@ function getLiveblocksExtrasForClient(client) {
   }
   return extras;
 }
-function makeDeltaPoller_Notifications(store) {
-  const poller = makePoller(async () => {
-    try {
-      await store.waitUntilNotificationsLoaded();
-      await store.fetchNotificationsDeltaUpdate();
-    } catch (err) {
-      console.warn(`Polling new inbox notifications failed: ${String(err)}`);
-    }
-  }, POLLING_INTERVAL);
-  let pollerSubscribers = 0;
-  return () => {
-    pollerSubscribers++;
-    poller.enable(pollerSubscribers > 0);
-    return () => {
-      pollerSubscribers--;
-      poller.enable(pollerSubscribers > 0);
-    };
-  };
-}
-function makeDeltaPoller_UserThreads(store) {
-  const poller = makePoller(async () => {
-    try {
-      await store.fetchUserThreadsDeltaUpdate();
-    } catch (err) {
-      console.warn(`Polling new user threads failed: ${String(err)}`);
-    }
-  }, POLLING_INTERVAL);
-  let pollerSubscribers = 0;
-  return () => {
-    pollerSubscribers++;
-    poller.enable(pollerSubscribers > 0);
-    return () => {
-      pollerSubscribers--;
-      poller.enable(pollerSubscribers > 0);
-    };
-  };
-}
 function makeLiveblocksExtrasForClient(client) {
   const store = getUmbrellaStoreForClient(client);
+  const notificationsPoller = makePoller(
+    async (signal) => {
+      try {
+        return await store.fetchNotificationsDeltaUpdate(signal);
+      } catch (err) {
+        console.warn(`Polling new inbox notifications failed: ${String(err)}`);
+        throw err;
+      }
+    },
+    config.NOTIFICATIONS_POLL_INTERVAL,
+    { maxStaleTimeMs: config.NOTIFICATIONS_MAX_STALE_TIME }
+  );
+  const userThreadsPoller = makePoller(
+    async (signal) => {
+      try {
+        return await store.fetchUserThreadsDeltaUpdate(signal);
+      } catch (err) {
+        console.warn(`Polling new user threads failed: ${String(err)}`);
+        throw err;
+      }
+    },
+    config.USER_THREADS_POLL_INTERVAL,
+    { maxStaleTimeMs: config.USER_THREADS_MAX_STALE_TIME }
+  );
   return {
     store,
-    /**
-     * Sub/unsub pair to start the process of watching for new incoming inbox
-     * notifications through a stream of delta updates. Call the unsub function
-     * returned to stop this subscription when unmounting. Currently
-     * implemented by a periodic poller.
-     */
-    subscribeToNotificationsDeltaUpdates: makeDeltaPoller_Notifications(store),
-    /**
-     * Sub/unsub pair to start the process of watching for new user threads
-     * through a stream of delta updates. Call the unsub function returned to
-     * stop this subscription when unmounting. Currently implemented by
-     * a periodic poller.
-     */
-    subscribeToUserThreadsDeltaUpdates: makeDeltaPoller_UserThreads(store)
+    notificationsPoller,
+    userThreadsPoller
   };
 }
 function makeLiveblocksContextBundle(client) {
@@ -1612,7 +1657,7 @@ function makeLiveblocksContextBundle(client) {
   const useDeleteAllInboxNotifications2 = () => useDeleteAllInboxNotifications_withClient(client);
   function LiveblocksProvider2(props) {
     useEnsureNoLiveblocksProvider();
-    return /* @__PURE__ */ React3.createElement(ClientContext.Provider, { value: client }, props.children);
+    return /* @__PURE__ */ React2.createElement(ClientContext.Provider, { value: client }, props.children);
   }
   const shared = createSharedContext(client);
   const bundle = {
@@ -1642,19 +1687,21 @@ function makeLiveblocksContextBundle(client) {
   return bundle;
 }
 function useInboxNotifications_withClient(client, selector, isEqual) {
-  const {
-    store,
-    subscribeToNotificationsDeltaUpdates: subscribeToDeltaUpdates
-  } = getLiveblocksExtrasForClient(client);
-  useEffect3(() => {
-    void store.waitUntilNotificationsLoaded().catch(() => {
-    });
+  const { store, notificationsPoller: poller } = getLiveblocksExtrasForClient(client);
+  useEffect2(() => {
+    void store.waitUntilNotificationsLoaded();
   });
-  useEffect3(subscribeToDeltaUpdates, [subscribeToDeltaUpdates]);
+  useEffect2(() => {
+    poller.inc();
+    poller.pollNowIfStale();
+    return () => {
+      poller.dec();
+    };
+  }, [poller]);
   return useSyncExternalStoreWithSelector(
-    store.subscribeThreadsOrInboxNotifications,
-    store.getInboxNotificationsAsync,
-    store.getInboxNotificationsAsync,
+    store.subscribe,
+    store.getInboxNotificationsLoadingState,
+    store.getInboxNotificationsLoadingState,
     selector,
     isEqual
   );
@@ -1783,7 +1830,7 @@ function useInboxNotificationThread_withClient(client, inboxNotificationId) {
           `Inbox notification with ID "${inboxNotificationId}" is not of kind "thread"`
         );
       }
-      const thread = state.threadsById[inboxNotification.threadId] ?? raise(
+      const thread = state.threadsDB.get(inboxNotification.threadId) ?? raise(
         `Thread with ID "${inboxNotification.threadId}" not found, this inbox notification might not be of kind "thread"`
       );
       return thread;
@@ -1791,7 +1838,7 @@ function useInboxNotificationThread_withClient(client, inboxNotificationId) {
     [inboxNotificationId]
   );
   return useSyncExternalStoreWithSelector(
-    store.subscribeThreadsOrInboxNotifications,
+    store.subscribe,
     // Re-evaluate if we need to update any time the notification changes over time
     getter,
     getter,
@@ -1804,20 +1851,21 @@ function useUser_withClient(client, userId) {
     () => usersStore.getState(userId),
     [usersStore, userId]
   );
-  useEffect3(() => {
-    void usersStore.get(userId);
-  }, [usersStore, userId]);
   const selector = useCallback2(
     (state) => selectorFor_useUser(state, userId),
     [userId]
   );
-  return useSyncExternalStoreWithSelector(
+  const result = useSyncExternalStoreWithSelector(
     usersStore.subscribe,
     getUserState,
     getUserState,
     selector,
     shallow3
   );
+  useEffect2(() => {
+    void usersStore.get(userId);
+  }, [usersStore, userId, result]);
+  return result;
 }
 function useUserSuspense_withClient(client, userId) {
   const usersStore = client[kInternal2].usersStore;
@@ -1859,16 +1907,17 @@ function useRoomInfo_withClient(client, roomId) {
     (state) => selectorFor_useRoomInfo(state, roomId),
     [roomId]
   );
-  useEffect3(() => {
-    void roomsInfoStore.get(roomId);
-  }, [roomsInfoStore, roomId]);
-  return useSyncExternalStoreWithSelector(
+  const result = useSyncExternalStoreWithSelector(
     roomsInfoStore.subscribe,
     getRoomInfoState,
     getRoomInfoState,
     selector,
     shallow3
   );
+  useEffect2(() => {
+    void roomsInfoStore.get(roomId);
+  }, [roomsInfoStore, roomId, result]);
+  return result;
 }
 function useRoomInfoSuspense_withClient(client, roomId) {
   const roomsInfoStore = client[kInternal2].roomsInfoStore;
@@ -1934,7 +1983,7 @@ function useClient() {
 }
 function LiveblocksProviderWithClient(props) {
   useEnsureNoLiveblocksProvider(props);
-  return /* @__PURE__ */ React3.createElement(ClientContext.Provider, { value: props.client }, props.children);
+  return /* @__PURE__ */ React2.createElement(ClientContext.Provider, { value: props.client }, props.children);
 }
 function LiveblocksProvider(props) {
   const { children, ...o } = props;
@@ -1962,7 +2011,7 @@ function LiveblocksProvider(props) {
     )
   };
   const client = useMemo(() => createClient(options), []);
-  return /* @__PURE__ */ React3.createElement(LiveblocksProviderWithClient, { client }, children);
+  return /* @__PURE__ */ React2.createElement(LiveblocksProviderWithClient, { client }, children);
 }
 function createLiveblocksContext(client) {
   return getOrCreateContextBundle(client);
@@ -1973,11 +2022,10 @@ function useUserThreads_experimental(options = {
   }
 }) {
   const client = useClient();
-  const { store, subscribeToUserThreadsDeltaUpdates: subscribeToDeltaUpdates } = getLiveblocksExtrasForClient(client);
-  useEffect3(
+  const { store, userThreadsPoller: poller } = getLiveblocksExtrasForClient(client);
+  useEffect2(
     () => {
-      void store.waitUntilUserThreadsLoaded(options.query).catch(() => {
-      });
+      void store.waitUntilUserThreadsLoaded(options.query);
     }
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -1988,13 +2036,19 @@ function useUserThreads_experimental(options = {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  useEffect3(subscribeToDeltaUpdates, [subscribeToDeltaUpdates]);
+  useEffect2(() => {
+    poller.inc();
+    poller.pollNowIfStale();
+    return () => {
+      poller.dec();
+    };
+  }, [poller]);
   const getter = useCallback2(
-    () => store.getUserThreadsAsync(options.query),
+    () => store.getUserThreadsLoadingState(options.query),
     [store, options.query]
   );
   return useSyncExternalStoreWithSelector(
-    store.subscribeUserThreads,
+    store.subscribe,
     getter,
     getter,
     identity,
@@ -2167,34 +2221,22 @@ var UpdateNotificationSettingsError = class extends Error {
 import { shallow as shallow4 } from "@liveblocks/client";
 import {
   assert as assert2,
-  CommentsApiError,
   console as console3,
   createCommentId,
   createThreadId,
   deprecateIf,
   errorIf,
+  HttpError as HttpError2,
   kInternal as kInternal3,
   makeEventSource as makeEventSource2,
   makePoller as makePoller2,
-  NotificationsApiError,
   ServerMsgCode
 } from "@liveblocks/core";
-import * as React5 from "react";
+import * as React4 from "react";
 import { useSyncExternalStoreWithSelector as useSyncExternalStoreWithSelector2 } from "use-sync-external-store/shim/with-selector.js";
 
-// src/lib/retry-error.ts
-var MAX_ERROR_RETRY_COUNT = 5;
-var ERROR_RETRY_INTERVAL = 5e3;
-function retryError(action, retryCount) {
-  if (retryCount >= MAX_ERROR_RETRY_COUNT) return;
-  const timeout = Math.pow(2, retryCount) * ERROR_RETRY_INTERVAL;
-  setTimeout(() => {
-    void action();
-  }, timeout);
-}
-
 // src/use-scroll-to-comment-on-load-effect.ts
-import * as React4 from "react";
+import * as React3 from "react";
 function handleScrollToCommentOnLoad(shouldScrollOnLoad, state) {
   if (shouldScrollOnLoad === false) return;
   if (!state.threads) return;
@@ -2213,7 +2255,7 @@ function handleScrollToCommentOnLoad(shouldScrollOnLoad, state) {
   comment.scrollIntoView();
 }
 function useScrollToCommentOnLoadEffect(shouldScrollOnLoad, state) {
-  React4.useEffect(
+  React3.useEffect(
     () => {
       handleScrollToCommentOnLoad(shouldScrollOnLoad, state);
     },
@@ -2243,7 +2285,6 @@ function useSyncExternalStore2(s, gs, gss) {
   return useSyncExternalStoreWithSelector2(s, gs, gss, identity2);
 }
 var STABLE_EMPTY_LIST = Object.freeze([]);
-var POLLING_INTERVAL2 = 5 * 60 * 1e3;
 function alwaysEmptyList() {
   return STABLE_EMPTY_LIST;
 }
@@ -2298,28 +2339,6 @@ function handleApiError(err) {
   }
   return new Error(message);
 }
-function makeDeltaPoller_RoomThreads(client) {
-  const store = getUmbrellaStoreForClient(client);
-  const poller = makePoller2(async () => {
-    const roomIds = client[kInternal3].getRoomIds();
-    await Promise.allSettled(
-      roomIds.map((roomId) => {
-        const room = client.getRoom(roomId);
-        if (room === null) return;
-        return store.fetchRoomThreadsDeltaUpdate(room.id);
-      })
-    );
-  }, POLLING_INTERVAL2);
-  let pollerSubscribers = 0;
-  return () => {
-    pollerSubscribers++;
-    poller.enable(pollerSubscribers > 0);
-    return () => {
-      pollerSubscribers--;
-      poller.enable(pollerSubscribers > 0);
-    };
-  };
-}
 var _extras2 = /* @__PURE__ */ new WeakMap();
 var _bundles2 = /* @__PURE__ */ new WeakMap();
 function getOrCreateRoomContextBundle(client) {
@@ -2340,83 +2359,92 @@ function getRoomExtrasForClient(client) {
 }
 function makeRoomExtrasForClient(client) {
   const store = getUmbrellaStoreForClient(client);
-  const requestsByQuery = /* @__PURE__ */ new Map();
-  async function getRoomVersions(room, { retryCount } = { retryCount: 0 }) {
-    const queryKey = makeVersionsQueryKey(room.id);
-    const existingRequest = requestsByQuery.get(queryKey);
-    if (existingRequest !== void 0) return existingRequest;
-    const request = room[kInternal3].listTextVersions();
-    requestsByQuery.set(queryKey, request);
-    store.setQuery4Loading(queryKey);
-    try {
-      const result = await request;
-      const data = await result.json();
-      const versions = data.versions.map(({ createdAt, ...version2 }) => {
-        return {
-          createdAt: new Date(createdAt),
-          ...version2
-        };
-      });
-      store.updateRoomVersions(room.id, versions, queryKey);
-      requestsByQuery.delete(queryKey);
-    } catch (err) {
-      requestsByQuery.delete(queryKey);
-      retryError(() => {
-        void getRoomVersions(room, {
-          retryCount: retryCount + 1
-        });
-      }, retryCount);
-      store.setQuery4Error(queryKey, err);
-    }
-    return;
-  }
-  async function getInboxNotificationSettings(room, { retryCount } = { retryCount: 0 }) {
-    const queryKey = makeNotificationSettingsQueryKey(room.id);
-    const existingRequest = requestsByQuery.get(queryKey);
-    if (existingRequest !== void 0) return existingRequest;
-    try {
-      const request = room.getNotificationSettings();
-      requestsByQuery.set(queryKey, request);
-      store.setQuery3Loading(queryKey);
-      const settings = await request;
-      store.updateRoomInboxNotificationSettings(room.id, settings, queryKey);
-    } catch (err) {
-      requestsByQuery.delete(queryKey);
-      retryError(() => {
-        void getInboxNotificationSettings(room, {
-          retryCount: retryCount + 1
-        });
-      }, retryCount);
-      store.setQuery3Error(queryKey, err);
-    }
-    return;
-  }
   const commentsErrorEventSource = makeEventSource2();
   function onMutationFailure(innerError, optimisticUpdateId, createPublicError) {
     store.removeOptimisticUpdate(optimisticUpdateId);
-    if (innerError instanceof CommentsApiError) {
+    if (innerError instanceof HttpError2) {
       const error = handleApiError(innerError);
       commentsErrorEventSource.notify(createPublicError(error));
       return;
     }
-    if (innerError instanceof NotificationsApiError) {
+    if (innerError instanceof HttpError2) {
       handleApiError(innerError);
       return;
     }
     throw innerError;
   }
+  const threadsPollersByRoomId = /* @__PURE__ */ new Map();
+  const versionsPollersByRoomId = /* @__PURE__ */ new Map();
+  const roomNotificationSettingsPollersByRoomId = /* @__PURE__ */ new Map();
+  function getOrCreateThreadsPollerForRoomId(roomId) {
+    let poller = threadsPollersByRoomId.get(roomId);
+    if (!poller) {
+      poller = makePoller2(
+        async (signal) => {
+          try {
+            return await store.fetchRoomThreadsDeltaUpdate(roomId, signal);
+          } catch (err) {
+            console3.warn(`Polling new threads for '${roomId}' failed: ${String(err)}`);
+            throw err;
+          }
+        },
+        config.ROOM_THREADS_POLL_INTERVAL,
+        { maxStaleTimeMs: config.ROOM_THREADS_MAX_STALE_TIME }
+      );
+      threadsPollersByRoomId.set(roomId, poller);
+    }
+    return poller;
+  }
+  function getOrCreateVersionsPollerForRoomId(roomId) {
+    let poller = versionsPollersByRoomId.get(roomId);
+    if (!poller) {
+      poller = makePoller2(
+        async (signal) => {
+          try {
+            return await store.fetchRoomVersionsDeltaUpdate(roomId, signal);
+          } catch (err) {
+            console3.warn(`Polling new history versions for '${roomId}' failed: ${String(err)}`);
+            throw err;
+          }
+        },
+        config.HISTORY_VERSIONS_POLL_INTERVAL,
+        { maxStaleTimeMs: config.HISTORY_VERSIONS_MAX_STALE_TIME }
+      );
+      versionsPollersByRoomId.set(roomId, poller);
+    }
+    return poller;
+  }
+  function getOrCreateNotificationsSettingsPollerForRoomId(roomId) {
+    let poller = roomNotificationSettingsPollersByRoomId.get(roomId);
+    if (!poller) {
+      poller = makePoller2(
+        async (signal) => {
+          try {
+            return await store.refreshRoomNotificationSettings(roomId, signal);
+          } catch (err) {
+            console3.warn(`Polling notification settings for '${roomId}' failed: ${String(err)}`);
+            throw err;
+          }
+        },
+        config.NOTIFICATION_SETTINGS_POLL_INTERVAL,
+        { maxStaleTimeMs: config.NOTIFICATION_SETTINGS_MAX_STALE_TIME }
+      );
+      roomNotificationSettingsPollersByRoomId.set(roomId, poller);
+    }
+    return poller;
+  }
   return {
     store,
-    subscribeToRoomThreadsDeltaUpdates: makeDeltaPoller_RoomThreads(client),
-    commentsErrorEventSource,
-    getInboxNotificationSettings,
-    getRoomVersions,
-    onMutationFailure
+    commentsErrorEventSource: commentsErrorEventSource.observable,
+    onMutationFailure,
+    getOrCreateThreadsPollerForRoomId,
+    getOrCreateVersionsPollerForRoomId,
+    getOrCreateNotificationsSettingsPollerForRoomId
   };
 }
 function makeRoomContextBundle(client) {
   function RoomProvider_withImplicitLiveblocksProvider(props) {
-    return /* @__PURE__ */ React5.createElement(LiveblocksProviderWithClient, { client, allowNesting: true }, /* @__PURE__ */ React5.createElement(RoomProvider, { ...props }));
+    return /* @__PURE__ */ React4.createElement(LiveblocksProviderWithClient, { client, allowNesting: true }, /* @__PURE__ */ React4.createElement(RoomProvider, { ...props }));
   }
   const shared = createSharedContext(client);
   const bundle = {
@@ -2520,10 +2548,10 @@ function makeRoomContextBundle(client) {
 }
 function RoomProvider(props) {
   const client = useClient();
-  const [cache] = React5.useState(
+  const [cache] = React4.useState(
     () => /* @__PURE__ */ new Map()
   );
-  const stableEnterRoom = React5.useCallback(
+  const stableEnterRoom = React4.useCallback(
     (roomId, options) => {
       const cached = cache.get(roomId);
       if (cached) return cached;
@@ -2538,7 +2566,7 @@ function RoomProvider(props) {
     },
     [client, cache]
   );
-  return /* @__PURE__ */ React5.createElement(
+  return /* @__PURE__ */ React4.createElement(
     RoomProviderInner,
     {
       ...props,
@@ -2558,7 +2586,7 @@ function RoomProviderInner(props) {
     if (!isString(roomId)) {
       throw new Error("RoomProvider id property should be a string.");
     }
-    const majorReactVersion = parseInt(React5.version) || 1;
+    const majorReactVersion = parseInt(React4.version) || 1;
     const oldReactVersion = majorReactVersion < 18;
     errorIf(
       oldReactVersion && props.unstable_batchedUpdates === void 0,
@@ -2575,14 +2603,14 @@ function RoomProviderInner(props) {
     unstable_batchedUpdates: props.unstable_batchedUpdates,
     autoConnect: props.autoConnect ?? typeof window !== "undefined"
   });
-  const [{ room }, setRoomLeavePair] = React5.useState(
+  const [{ room }, setRoomLeavePair] = React4.useState(
     () => stableEnterRoom(roomId, {
       ...frozenProps,
       autoConnect: false
       // Deliberately using false here on the first render, see below
     })
   );
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     const { store } = getRoomExtrasForClient(client);
     async function handleCommentEvent(message) {
       if (message.type === ServerMsgCode.THREAD_DELETED) {
@@ -2595,7 +2623,7 @@ function RoomProviderInner(props) {
         return;
       }
       const { thread, inboxNotification } = info;
-      const existingThread = store.getFullState().threadsById[message.threadId];
+      const existingThread = store.getFullState().threadsDB.getEvenIfDeleted(message.threadId);
       switch (message.type) {
         case ServerMsgCode.COMMENT_EDITED:
         case ServerMsgCode.THREAD_METADATA_UPDATED:
@@ -2617,23 +2645,7 @@ function RoomProviderInner(props) {
       (message) => void handleCommentEvent(message)
     );
   }, [client, room]);
-  React5.useEffect(() => {
-    const store = getRoomExtrasForClient(client).store;
-    void store.fetchRoomThreadsDeltaUpdate(room.id).catch(() => {
-    });
-  }, [client, room.id]);
-  React5.useEffect(() => {
-    function handleIsOnline() {
-      const store = getRoomExtrasForClient(client).store;
-      void store.fetchRoomThreadsDeltaUpdate(room.id).catch(() => {
-      });
-    }
-    window.addEventListener("online", handleIsOnline);
-    return () => {
-      window.removeEventListener("online", handleIsOnline);
-    };
-  }, [client, room.id]);
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     const pair = stableEnterRoom(roomId, frozenProps);
     setRoomLeavePair(pair);
     const { room: room2, leave } = pair;
@@ -2644,7 +2656,7 @@ function RoomProviderInner(props) {
       leave();
     };
   }, [roomId, frozenProps, stableEnterRoom]);
-  return /* @__PURE__ */ React5.createElement(RoomContext.Provider, { value: room }, props.children);
+  return /* @__PURE__ */ React4.createElement(RoomContext.Provider, { value: room }, props.children);
 }
 function useRoom() {
   const room = useRoomOrNull();
@@ -2677,9 +2689,9 @@ function useStorageStatusImmediate() {
 }
 function useStorageStatusSmooth() {
   const room = useRoom();
-  const [status, setStatus] = React5.useState(room.getStorageStatus);
+  const [status, setStatus] = React4.useState(room.getStorageStatus);
   const oldStatus = useLatest(room.getStorageStatus());
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     let timeoutId;
     const unsub = room.events.storageStatus.subscribe((newStatus) => {
       if (oldStatus.current === "synchronizing" && newStatus === "synchronized") {
@@ -2701,7 +2713,7 @@ function useBatch() {
 }
 function useBroadcastEvent() {
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (event, options = { shouldQueueEventIfNotReady: false }) => {
       room.broadcastEvent(event, options);
     },
@@ -2711,7 +2723,7 @@ function useBroadcastEvent() {
 function useOthersListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  React5.useEffect(
+  React4.useEffect(
     () => room.events.others.subscribe((event) => savedCallback.current(event)),
     [room, savedCallback]
   );
@@ -2719,7 +2731,7 @@ function useOthersListener(callback) {
 function useLostConnectionListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  React5.useEffect(
+  React4.useEffect(
     () => room.events.lostConnection.subscribe(
       (event) => savedCallback.current(event)
     ),
@@ -2729,7 +2741,7 @@ function useLostConnectionListener(callback) {
 function useErrorListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  React5.useEffect(
+  React4.useEffect(
     () => room.events.error.subscribe((e) => savedCallback.current(e)),
     [room, savedCallback]
   );
@@ -2737,7 +2749,7 @@ function useErrorListener(callback) {
 function useEventListener(callback) {
   const room = useRoom();
   const savedCallback = useLatest(callback);
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     const listener = (eventData) => {
       savedCallback.current(eventData);
     };
@@ -2770,7 +2782,7 @@ function useSelf(maybeSelector, isEqual) {
   const subscribe = room.events.self.subscribe;
   const getSnapshot = room.getSelf;
   const selector = maybeSelector ?? identity2;
-  const wrappedSelector = React5.useCallback(
+  const wrappedSelector = React4.useCallback(
     (me) => me !== null ? selector(me) : null,
     [selector]
   );
@@ -2808,11 +2820,11 @@ function useOthers(selector, isEqual) {
   );
 }
 function useOthersMapped(itemSelector, itemIsEqual) {
-  const wrappedSelector = React5.useCallback(
+  const wrappedSelector = React4.useCallback(
     (others) => others.map((other) => [other.connectionId, itemSelector(other)]),
     [itemSelector]
   );
-  const wrappedIsEqual = React5.useCallback(
+  const wrappedIsEqual = React4.useCallback(
     (a, b) => {
       const eq = itemIsEqual ?? Object.is;
       return a.length === b.length && a.every((atuple, index) => {
@@ -2829,14 +2841,14 @@ function useOthersConnectionIds() {
 }
 var NOT_FOUND = Symbol();
 function useOther(connectionId, selector, isEqual) {
-  const wrappedSelector = React5.useCallback(
+  const wrappedSelector = React4.useCallback(
     (others) => {
       const other2 = others.find((other3) => other3.connectionId === connectionId);
       return other2 !== void 0 ? selector(other2) : NOT_FOUND;
     },
     [connectionId, selector]
   );
-  const wrappedIsEqual = React5.useCallback(
+  const wrappedIsEqual = React4.useCallback(
     (prev, curr) => {
       if (prev === NOT_FOUND || curr === NOT_FOUND) {
         return prev === curr;
@@ -2867,15 +2879,15 @@ function useStorageRoot() {
 function useStorage(selector, isEqual) {
   const room = useRoom();
   const rootOrNull = useMutableStorageRoot();
-  const wrappedSelector = React5.useCallback(
+  const wrappedSelector = React4.useCallback(
     (rootOrNull2) => rootOrNull2 !== null ? selector(rootOrNull2) : null,
     [selector]
   );
-  const subscribe = React5.useCallback(
+  const subscribe = React4.useCallback(
     (onStoreChange) => rootOrNull !== null ? room.subscribe(rootOrNull, onStoreChange, { isDeep: true }) : noop3,
     [room, rootOrNull]
   );
-  const getSnapshot = React5.useCallback(() => {
+  const getSnapshot = React4.useCallback(() => {
     if (rootOrNull === null) {
       return null;
     } else {
@@ -2895,7 +2907,7 @@ function useStorage(selector, isEqual) {
 }
 function useMutation(callback, deps) {
   const room = useRoom();
-  return React5.useMemo(
+  return React4.useMemo(
     () => {
       return (...args) => (
         // eslint-disable-next-line @typescript-eslint/no-unsafe-return
@@ -2920,11 +2932,11 @@ function useThreads(options = {
   const { scrollOnLoad = true } = options;
   const client = useClient();
   const room = useRoom();
-  const { store, subscribeToRoomThreadsDeltaUpdates: subscribeToDeltaUpdates } = getRoomExtrasForClient(client);
-  React5.useEffect(
+  const { store, getOrCreateThreadsPollerForRoomId } = getRoomExtrasForClient(client);
+  const poller = getOrCreateThreadsPollerForRoomId(room.id);
+  React4.useEffect(
     () => {
-      void store.waitUntilRoomThreadsLoaded(room.id, options.query).catch(() => {
-      });
+      void store.waitUntilRoomThreadsLoaded(room.id, options.query);
     }
     // NOTE: Deliberately *not* using a dependency array here!
     //
@@ -2935,13 +2947,17 @@ function useThreads(options = {
     // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
     //    *next* render after that, a *new* fetch/promise will get created.
   );
-  React5.useEffect(subscribeToDeltaUpdates, [subscribeToDeltaUpdates]);
-  const getter = React5.useCallback(
-    () => store.getRoomThreadsAsync(room.id, options.query),
+  React4.useEffect(() => {
+    poller.inc();
+    poller.pollNowIfStale();
+    return () => poller.dec();
+  }, [poller]);
+  const getter = React4.useCallback(
+    () => store.getRoomThreadsLoadingState(room.id, options.query),
     [store, room.id, options.query]
   );
   const state = useSyncExternalStoreWithSelector2(
-    store.subscribeThreads,
+    store.subscribe,
     getter,
     getter,
     identity2,
@@ -2955,14 +2971,14 @@ function useCommentsErrorListener(callback) {
   const client = useClient();
   const savedCallback = useLatest(callback);
   const { commentsErrorEventSource } = getRoomExtrasForClient(client);
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     return commentsErrorEventSource.subscribe(savedCallback.current);
   }, [savedCallback, commentsErrorEventSource]);
 }
 function useCreateThread() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (options) => {
       const body = options.body;
       const metadata = options.metadata ?? {};
@@ -3022,12 +3038,12 @@ function useCreateThread() {
 function useDeleteThread() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (threadId) => {
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
-      const thread = store.getFullState().threadsById[threadId];
       const userId = getCurrentUserId(room);
-      if (thread?.comments?.[0]?.userId !== userId) {
+      const existing = store.getFullState().threadsDB.get(threadId);
+      if (existing?.comments?.[0]?.userId !== userId) {
         throw new Error("Only the thread creator can delete the thread");
       }
       const optimisticUpdateId = store.addOptimisticUpdate({
@@ -3053,7 +3069,7 @@ function useDeleteThread() {
 function useEditThreadMetadata() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (options) => {
       if (!options.metadata) {
         return;
@@ -3095,7 +3111,7 @@ function useEditThreadMetadata() {
 function useCreateComment() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     ({ threadId, body, attachments }) => {
       const commentId = createCommentId();
       const createdAt = /* @__PURE__ */ new Date();
@@ -3139,18 +3155,18 @@ function useCreateComment() {
 function useEditComment() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     ({ threadId, commentId, body, attachments }) => {
       const editedAt = /* @__PURE__ */ new Date();
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
-      const thread = store.getFullState().threadsById[threadId];
-      if (thread === void 0) {
+      const existing = store.getFullState().threadsDB.getEvenIfDeleted(threadId);
+      if (existing === void 0) {
         console3.warn(
           `Internal unexpected behavior. Cannot edit comment in thread "${threadId}" because the thread does not exist in the cache.`
         );
         return;
       }
-      const comment = thread.comments.find(
+      const comment = existing.comments.find(
         (comment2) => comment2.id === commentId
       );
       if (comment === void 0 || comment.deletedAt !== void 0) {
@@ -3191,7 +3207,7 @@ function useEditComment() {
 function useDeleteComment() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     ({ threadId, commentId }) => {
       const deletedAt = /* @__PURE__ */ new Date();
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
@@ -3228,7 +3244,7 @@ function useDeleteComment() {
 function useAddReaction() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     ({ threadId, commentId, emoji }) => {
       const createdAt = /* @__PURE__ */ new Date();
       const userId = getCurrentUserId(room);
@@ -3271,7 +3287,7 @@ function useAddReaction() {
 function useRemoveReaction() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     ({ threadId, commentId, emoji }) => {
       const userId = getCurrentUserId(room);
       const removedAt = /* @__PURE__ */ new Date();
@@ -3313,7 +3329,7 @@ function useRemoveReaction() {
 function useMarkThreadAsRead() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (threadId) => {
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
       const inboxNotification = Object.values(
@@ -3354,7 +3370,7 @@ function useMarkThreadAsRead() {
 function useMarkThreadAsResolved() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (threadId) => {
       const updatedAt = /* @__PURE__ */ new Date();
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
@@ -3388,7 +3404,7 @@ function useMarkThreadAsResolved() {
 function useMarkThreadAsUnresolved() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (threadId) => {
       const updatedAt = /* @__PURE__ */ new Date();
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
@@ -3422,26 +3438,24 @@ function useMarkThreadAsUnresolved() {
 function useThreadSubscription(threadId) {
   const client = useClient();
   const { store } = getRoomExtrasForClient(client);
-  const selector = React5.useCallback(
+  const selector = React4.useCallback(
     (state) => {
-      const inboxNotification = state.notifications.find(
-        (inboxNotification2) => inboxNotification2.kind === "thread" && inboxNotification2.threadId === threadId
+      const notification = state.cleanedNotifications.find(
+        (inboxNotification) => inboxNotification.kind === "thread" && inboxNotification.threadId === threadId
       );
-      const thread = state.threadsById[threadId];
-      if (inboxNotification === void 0 || thread === void 0) {
-        return {
-          status: "not-subscribed"
-        };
+      const thread = state.threadsDB.get(threadId);
+      if (notification === void 0 || thread === void 0) {
+        return { status: "not-subscribed" };
       }
       return {
         status: "subscribed",
-        unreadSince: inboxNotification.readAt
+        unreadSince: notification.readAt
       };
     },
     [threadId]
   );
   return useSyncExternalStoreWithSelector2(
-    store.subscribeThreads,
+    store.subscribe,
     store.getFullState,
     store.getFullState,
     selector
@@ -3451,58 +3465,61 @@ function useRoomNotificationSettings() {
   const updateRoomNotificationSettings = useUpdateRoomNotificationSettings();
   const client = useClient();
   const room = useRoom();
-  const { store } = getRoomExtrasForClient(client);
-  const getter = React5.useCallback(
-    () => store.getNotificationSettingsAsync(room.id),
+  const { store, getOrCreateNotificationsSettingsPollerForRoomId } = getRoomExtrasForClient(client);
+  const poller = getOrCreateNotificationsSettingsPollerForRoomId(room.id);
+  React4.useEffect(
+    () => {
+      void store.waitUntilRoomNotificationSettingsLoaded(room.id);
+    }
+    // NOTE: Deliberately *not* using a dependency array here!
+    //
+    // It is important to call waitUntil on *every* render.
+    // This is harmless though, on most renders, except:
+    // 1. The very first render, in which case we'll want to trigger the initial page fetch.
+    // 2. All other subsequent renders now "just" return the same promise (a quick operation).
+    // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
+    //    *next* render after that, a *new* fetch/promise will get created.
+  );
+  React4.useEffect(() => {
+    poller.inc();
+    poller.pollNowIfStale();
+    return () => {
+      poller.dec();
+    };
+  }, [poller]);
+  const getter = React4.useCallback(
+    () => store.getNotificationSettingsLoadingState(room.id),
     [store, room.id]
   );
-  React5.useEffect(() => {
-    const { getInboxNotificationSettings } = getRoomExtrasForClient(client);
-    void getInboxNotificationSettings(room);
-  }, [client, room]);
   const settings = useSyncExternalStoreWithSelector2(
-    store.subscribeNotificationSettings,
+    store.subscribe,
     getter,
     getter,
     identity2,
-    shallow4
+    shallow2
   );
-  return React5.useMemo(() => {
+  return React4.useMemo(() => {
     return [settings, updateRoomNotificationSettings];
   }, [settings, updateRoomNotificationSettings]);
 }
 function useRoomNotificationSettingsSuspense() {
-  const updateRoomNotificationSettings = useUpdateRoomNotificationSettings();
   const client = useClient();
+  const store = getRoomExtrasForClient(client).store;
   const room = useRoom();
-  const { store } = getRoomExtrasForClient(client);
-  const getter = React5.useCallback(
-    () => store.getNotificationSettingsAsync(room.id),
-    [store, room.id]
-  );
-  const settings = useSyncExternalStoreWithSelector2(
-    store.subscribeNotificationSettings,
-    getter,
-    getter,
-    identity2,
-    shallow4
-  );
-  if (settings.isLoading) {
-    const { getInboxNotificationSettings } = getRoomExtrasForClient(client);
-    throw getInboxNotificationSettings(room);
-  } else if (settings.error) {
-    throw settings.error;
-  }
-  return React5.useMemo(() => {
+  use(store.waitUntilRoomNotificationSettingsLoaded(room.id));
+  const [settings, updateRoomNotificationSettings] = useRoomNotificationSettings();
+  assert2(!settings.error, "Did not expect error");
+  assert2(!settings.isLoading, "Did not expect loading");
+  return React4.useMemo(() => {
     return [settings, updateRoomNotificationSettings];
   }, [settings, updateRoomNotificationSettings]);
 }
 function useHistoryVersionData(versionId) {
-  const [state, setState] = React5.useState({
+  const [state, setState] = React4.useState({
     isLoading: true
   });
   const room = useRoom();
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     setState({ isLoading: true });
     const load = async () => {
       try {
@@ -3529,50 +3546,53 @@ function useHistoryVersionData(versionId) {
 function useHistoryVersions() {
   const client = useClient();
   const room = useRoom();
-  const { store, getRoomVersions } = getRoomExtrasForClient(client);
-  const getter = React5.useCallback(
-    () => store.getVersionsAsync(room.id),
+  const { store, getOrCreateVersionsPollerForRoomId } = getRoomExtrasForClient(client);
+  const poller = getOrCreateVersionsPollerForRoomId(room.id);
+  React4.useEffect(() => {
+    poller.inc();
+    poller.pollNowIfStale();
+    return () => poller.dec();
+  }, [poller]);
+  const getter = React4.useCallback(
+    () => store.getRoomVersionsLoadingState(room.id),
     [store, room.id]
   );
-  React5.useEffect(() => {
-    void getRoomVersions(room);
-  }, [room]);
+  React4.useEffect(
+    () => {
+      void store.waitUntilRoomVersionsLoaded(room.id);
+    }
+    // NOTE: Deliberately *not* using a dependency array here!
+    //
+    // It is important to call waitUntil on *every* render.
+    // This is harmless though, on most renders, except:
+    // 1. The very first render, in which case we'll want to trigger the initial page fetch.
+    // 2. All other subsequent renders now "just" return the same promise (a quick operation).
+    // 3. If ever the promise would fail, then after 5 seconds it would reset, and on the very
+    //    *next* render after that, a *new* fetch/promise will get created.
+  );
   const state = useSyncExternalStoreWithSelector2(
-    store.subscribeVersions,
+    store.subscribe,
     getter,
     getter,
     identity2,
-    shallow4
+    shallow2
   );
   return state;
 }
 function useHistoryVersionsSuspense() {
   const client = useClient();
   const room = useRoom();
-  const { store } = getRoomExtrasForClient(client);
-  const getter = React5.useCallback(
-    () => store.getVersionsAsync(room.id),
-    [store, room.id]
-  );
-  const state = useSyncExternalStoreWithSelector2(
-    store.subscribeVersions,
-    getter,
-    getter,
-    identity2,
-    shallow4
-  );
-  if (state.isLoading) {
-    const { getRoomVersions } = getRoomExtrasForClient(client);
-    throw getRoomVersions(room);
-  } else if (state.error) {
-    throw state.error;
-  }
-  return state;
+  const store = getRoomExtrasForClient(client).store;
+  use(store.waitUntilRoomVersionsLoaded(room.id));
+  const result = useHistoryVersions();
+  assert2(!result.error, "Did not expect error");
+  assert2(!result.isLoading, "Did not expect loading");
+  return result;
 }
 function useUpdateRoomNotificationSettings() {
   const client = useClient();
   const room = useRoom();
-  return React5.useCallback(
+  return React4.useCallback(
     (settings) => {
       const { store, onMutationFailure } = getRoomExtrasForClient(client);
       const optimisticUpdateId = store.addOptimisticUpdate({
@@ -3582,7 +3602,7 @@ function useUpdateRoomNotificationSettings() {
       });
       room.updateNotificationSettings(settings).then(
         (settings2) => {
-          store.updateRoomInboxNotificationSettings2(
+          store.updateRoomNotificationSettings_confirmOptimisticUpdate(
             room.id,
             optimisticUpdateId,
             settings2
@@ -3682,11 +3702,11 @@ function selectorFor_useAttachmentUrl(state) {
 function useAttachmentUrl(attachmentId) {
   const room = useRoom();
   const { attachmentUrlsStore } = room[kInternal3];
-  const getAttachmentUrlState = React5.useCallback(
+  const getAttachmentUrlState = React4.useCallback(
     () => attachmentUrlsStore.getState(attachmentId),
     [attachmentUrlsStore, attachmentId]
   );
-  React5.useEffect(() => {
+  React4.useEffect(() => {
     void attachmentUrlsStore.get(attachmentId);
   }, [attachmentUrlsStore, attachmentId]);
   return useSyncExternalStoreWithSelector2(
@@ -3700,7 +3720,7 @@ function useAttachmentUrl(attachmentId) {
 function useAttachmentUrlSuspense(attachmentId) {
   const room = useRoom();
   const { attachmentUrlsStore } = room[kInternal3];
-  const getAttachmentUrlState = React5.useCallback(
+  const getAttachmentUrlState = React4.useCallback(
     () => attachmentUrlsStore.getState(attachmentId),
     [attachmentUrlsStore, attachmentId]
   );
@@ -3744,6 +3764,8 @@ var _useOthersMapped = useOthersMapped;
 var _useOthersMappedSuspense = useOthersMappedSuspense;
 var _useThreads = useThreads;
 var _useThreadsSuspense = useThreadsSuspense;
+var _useRoomNotificationSettings = useRoomNotificationSettings;
+var _useRoomNotificationSettingsSuspense = useRoomNotificationSettingsSuspense;
 var _useHistoryVersions = useHistoryVersions;
 var _useHistoryVersionsSuspense = useHistoryVersionsSuspense;
 var _useOther = useOther;
@@ -3766,12 +3788,7 @@ var _useStorageRoot = useStorageRoot;
 var _useUpdateMyPresence = useUpdateMyPresence;
 
 export {
-  PKG_NAME,
-  PKG_VERSION,
-  PKG_FORMAT,
-  ClientSideSuspense,
   RoomContext,
-  selectThreads,
   ClientContext,
   getUmbrellaStoreForClient,
   useClient,
@@ -3813,7 +3830,6 @@ export {
   useMarkThreadAsResolved,
   useMarkThreadAsUnresolved,
   useThreadSubscription,
-  useRoomNotificationSettings,
   useHistoryVersionData,
   useUpdateRoomNotificationSettings,
   useOthersConnectionIdsSuspense,
@@ -3837,6 +3853,8 @@ export {
   _useOthersMappedSuspense,
   _useThreads,
   _useThreadsSuspense,
+  _useRoomNotificationSettings,
+  _useRoomNotificationSettingsSuspense,
   _useHistoryVersions,
   _useHistoryVersionsSuspense,
   _useOther,
@@ -3850,4 +3868,4 @@ export {
   _useStorageRoot,
   _useUpdateMyPresence
 };
-//# sourceMappingURL=chunk-SNEUTGU4.mjs.map
+//# sourceMappingURL=chunk-A7GJNN4L.mjs.map