@liveblocks/react 2.11.1 → 2.12.0

package/dist/_private.d.mts

@@ -1,6 +1,6 @@
-export { C as CreateThreadError, g as getUmbrellaStoreForClient } from './liveblocks-SAVcXwMX.mjs';
+export { C as CreateThreadError, g as getUmbrellaStoreForClient } from './liveblocks-1ujmr05d.mjs';
+import { SyncSource } from '@liveblocks/core';
 import '@liveblocks/client';
-import '@liveblocks/core';
 import 'react';
 
 /**
@@ -11,4 +11,9 @@ import 'react';
  */
 declare function useMentionSuggestions(search?: string): string[] | undefined;
 
-export { useMentionSuggestions };
+/**
+ * @private For internal use only. Do not rely on this hook.
+ */
+declare function useSyncSource(): SyncSource | undefined;
+
+export { useMentionSuggestions, useSyncSource };

package/dist/_private.d.ts

@@ -1,6 +1,6 @@
-export { C as CreateThreadError, g as getUmbrellaStoreForClient } from './liveblocks-SAVcXwMX.js';
+export { C as CreateThreadError, g as getUmbrellaStoreForClient } from './liveblocks-1ujmr05d.js';
+import { SyncSource } from '@liveblocks/core';
 import '@liveblocks/client';
-import '@liveblocks/core';
 import 'react';
 
 /**
@@ -11,4 +11,9 @@ import 'react';
  */
 declare function useMentionSuggestions(search?: string): string[] | undefined;
 
-export { useMentionSuggestions };
+/**
+ * @private For internal use only. Do not rely on this hook.
+ */
+declare function useSyncSource(): SyncSource | undefined;
+
+export { useMentionSuggestions, useSyncSource };

package/dist/_private.js

@@ -3,15 +3,15 @@
 
 
 
-var _chunk3MM4G6XBjs = require('./chunk-3MM4G6XB.js');
+var _chunkIACZPXTYjs = require('./chunk-IACZPXTY.js');
 
 // src/use-mention-suggestions.ts
 var _core = require('@liveblocks/core');
 var _react = require('react'); var _react2 = _interopRequireDefault(_react);
 var MENTION_SUGGESTIONS_DEBOUNCE = 500;
 function useMentionSuggestions(search) {
-  const client = _chunk3MM4G6XBjs.useClient.call(void 0, );
-  const room = _chunk3MM4G6XBjs._useRoom.call(void 0, );
+  const client = _chunkIACZPXTYjs.useClient.call(void 0, );
+  const room = _chunkIACZPXTYjs._useRoom.call(void 0, );
   const [mentionSuggestions, setMentionSuggestions] = _react2.default.useState();
   const lastInvokedAt = _react2.default.useRef();
   _react2.default.useEffect(() => {
@@ -60,8 +60,24 @@ function useMentionSuggestions(search) {
   return mentionSuggestions;
 }
 
+// src/use-sync-source.ts
+
+
+function useSyncSource() {
+  const client = _chunkIACZPXTYjs.useClient.call(void 0, );
+  const createSyncSource = client[_core.kInternal].createSyncSource;
+  const [syncSource, setSyncSource] = _react2.default.useState();
+  _react2.default.useEffect(() => {
+    const newSyncSource = createSyncSource();
+    setSyncSource(newSyncSource);
+    return () => newSyncSource.destroy();
+  }, [createSyncSource]);
+  return syncSource;
+}
+
+
 
 
 
-exports.CreateThreadError = _chunk3MM4G6XBjs.CreateThreadError; exports.getUmbrellaStoreForClient = _chunk3MM4G6XBjs.getUmbrellaStoreForClient; exports.useMentionSuggestions = useMentionSuggestions;
+exports.CreateThreadError = _chunkIACZPXTYjs.CreateThreadError; exports.getUmbrellaStoreForClient = _chunkIACZPXTYjs.getUmbrellaStoreForClient; exports.useMentionSuggestions = useMentionSuggestions; exports.useSyncSource = useSyncSource;
 //# sourceMappingURL=_private.js.map

package/dist/_private.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/use-mention-suggestions.ts"],"names":["mentionSuggestions"],"mappings":";;;;;;;;AAAA,SAAS,WAAW,iBAAiB;AACrC,OAAO,WAAW;AAKlB,IAAM,+BAA+B;AAQ9B,SAAS,sBAAsB,QAAiB;AACrD,QAAM,SAAS,UAAU;AAEzB,QAAM,OAAO,SAAQ;AACrB,QAAM,CAAC,oBAAoB,qBAAqB,IAC9C,MAAM,SAAmB;AAC3B,QAAM,gBAAgB,MAAM,OAAe;AAE3C,QAAM,UAAU,MAAM;AACpB,UAAM,0BAA0B,OAAO,SAAS,EAAE;AAClD,UAAM,4BACJ,OAAO,SAAS,EAAE;AAEpB,QAAI,WAAW,UAAa,CAAC,2BAA2B;AACtD;AAAA,IACF;AAEA,UAAM,gCAAgC,EAAE,MAAM,QAAQ,QAAQ,KAAK,GAAG;AACtE,UAAM,6BAA6B,UAAU,6BAA6B;AAC1E,QAAI;AACJ,QAAI,aAAa;AAEjB,UAAM,wBAAwB,YAAY;AACxC,UAAI;AACF,sBAAc,UAAU,YAAY,IAAI;AACxC,cAAMA,sBAAqB,MAAM;AAAA,UAC/B;AAAA,QACF;AAEA,YAAI,CAAC,YAAY;AACf,gCAAsBA,mBAAkB;AACxC,kCAAwB;AAAA,YACtB;AAAA,YACAA;AAAA,UACF;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,MAAO,OAAiB,OAAO;AAAA,MACzC;AAAA,IACF;AAEA,QAAI,wBAAwB,IAAI,0BAA0B,GAAG;AAE3D;AAAA,QACE,wBAAwB,IAAI,0BAA0B;AAAA,MACxD;AAAA,IACF,WACE,CAAC,cAAc,WACf,KAAK,IAAI,YAAY,IAAI,IAAI,cAAc,OAAO,IAChD,8BACF;AAGA,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AAEL,wBAAkB,OAAO,WAAW,MAAM;AACxC,aAAK,sBAAsB;AAAA,MAC7B,GAAG,4BAA4B;AAAA,IACjC;AAEA,WAAO,MAAM;AACX,mBAAa;AACb,aAAO,aAAa,eAAe;AAAA,IACrC;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC;AAE5B,SAAO;AACT","sourcesContent":["import { kInternal, stringify } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\nimport { useRoom } from \"./room\";\n\nconst MENTION_SUGGESTIONS_DEBOUNCE = 500;\n\n/**\n * @private For internal use only. Do not rely on this hook.\n *\n * Simplistic debounced search, we don't need to worry too much about deduping\n * and race conditions as there can only be one search at a time.\n */\nexport function useMentionSuggestions(search?: string) {\n  const client = useClient();\n\n  const room = useRoom();\n  const [mentionSuggestions, setMentionSuggestions] =\n    React.useState<string[]>();\n  const lastInvokedAt = React.useRef<number>();\n\n  React.useEffect(() => {\n    const mentionSuggestionsCache = client[kInternal].mentionSuggestionsCache;\n    const resolveMentionSuggestions =\n      client[kInternal].resolveMentionSuggestions;\n\n    if (search === undefined || !resolveMentionSuggestions) {\n      return;\n    }\n\n    const resolveMentionSuggestionsArgs = { text: search, roomId: room.id };\n    const mentionSuggestionsCacheKey = stringify(resolveMentionSuggestionsArgs);\n    let debounceTimeout: number | undefined;\n    let isCanceled = false;\n\n    const getMentionSuggestions = async () => {\n      try {\n        lastInvokedAt.current = performance.now();\n        const mentionSuggestions = await resolveMentionSuggestions(\n          resolveMentionSuggestionsArgs\n        );\n\n        if (!isCanceled) {\n          setMentionSuggestions(mentionSuggestions);\n          mentionSuggestionsCache.set(\n            mentionSuggestionsCacheKey,\n            mentionSuggestions\n          );\n        }\n      } catch (error) {\n        console.error((error as Error)?.message);\n      }\n    };\n\n    if (mentionSuggestionsCache.has(mentionSuggestionsCacheKey)) {\n      // If there are already cached mention suggestions, use them immediately.\n      setMentionSuggestions(\n        mentionSuggestionsCache.get(mentionSuggestionsCacheKey)\n      );\n    } else if (\n      !lastInvokedAt.current ||\n      Math.abs(performance.now() - lastInvokedAt.current) >\n        MENTION_SUGGESTIONS_DEBOUNCE\n    ) {\n      // If on the debounce's leading edge (either because it's the first invokation or enough\n      // time has passed since the last debounce), get mention suggestions immediately.\n      void getMentionSuggestions();\n    } else {\n      // Otherwise, wait for the debounce delay.\n      debounceTimeout = window.setTimeout(() => {\n        void getMentionSuggestions();\n      }, MENTION_SUGGESTIONS_DEBOUNCE);\n    }\n\n    return () => {\n      isCanceled = true;\n      window.clearTimeout(debounceTimeout);\n    };\n  }, [client, room.id, search]);\n\n  return mentionSuggestions;\n}\n"]}
+{"version":3,"sources":["../src/use-mention-suggestions.ts","../src/use-sync-source.ts"],"names":["mentionSuggestions","kInternal","React"],"mappings":";;;;;;;;AAAA,SAAS,WAAW,iBAAiB;AACrC,OAAO,WAAW;AAKlB,IAAM,+BAA+B;AAQ9B,SAAS,sBAAsB,QAAiB;AACrD,QAAM,SAAS,UAAU;AAEzB,QAAM,OAAO,SAAQ;AACrB,QAAM,CAAC,oBAAoB,qBAAqB,IAC9C,MAAM,SAAmB;AAC3B,QAAM,gBAAgB,MAAM,OAAe;AAE3C,QAAM,UAAU,MAAM;AACpB,UAAM,0BAA0B,OAAO,SAAS,EAAE;AAClD,UAAM,4BACJ,OAAO,SAAS,EAAE;AAEpB,QAAI,WAAW,UAAa,CAAC,2BAA2B;AACtD;AAAA,IACF;AAEA,UAAM,gCAAgC,EAAE,MAAM,QAAQ,QAAQ,KAAK,GAAG;AACtE,UAAM,6BAA6B,UAAU,6BAA6B;AAC1E,QAAI;AACJ,QAAI,aAAa;AAEjB,UAAM,wBAAwB,YAAY;AACxC,UAAI;AACF,sBAAc,UAAU,YAAY,IAAI;AACxC,cAAMA,sBAAqB,MAAM;AAAA,UAC/B;AAAA,QACF;AAEA,YAAI,CAAC,YAAY;AACf,gCAAsBA,mBAAkB;AACxC,kCAAwB;AAAA,YACtB;AAAA,YACAA;AAAA,UACF;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,MAAO,OAAiB,OAAO;AAAA,MACzC;AAAA,IACF;AAEA,QAAI,wBAAwB,IAAI,0BAA0B,GAAG;AAE3D;AAAA,QACE,wBAAwB,IAAI,0BAA0B;AAAA,MACxD;AAAA,IACF,WACE,CAAC,cAAc,WACf,KAAK,IAAI,YAAY,IAAI,IAAI,cAAc,OAAO,IAChD,8BACF;AAGA,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AAEL,wBAAkB,OAAO,WAAW,MAAM;AACxC,aAAK,sBAAsB;AAAA,MAC7B,GAAG,4BAA4B;AAAA,IACjC;AAEA,WAAO,MAAM;AACX,mBAAa;AACb,aAAO,aAAa,eAAe;AAAA,IACrC;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC;AAE5B,SAAO;AACT;;;ACjFA,SAAS,aAAAC,kBAAiB;AAC1B,OAAOC,YAAW;AAOX,SAAS,gBAAwC;AACtD,QAAM,SAAS,UAAU;AACzB,QAAM,mBAAmB,OAAOD,UAAS,EAAE;AAC3C,QAAM,CAAC,YAAY,aAAa,IAAIC,OAAM,SAAiC;AAE3E,EAAAA,OAAM,UAAU,MAAM;AAEpB,UAAM,gBAAgB,iBAAiB;AACvC,kBAAc,aAAa;AAC3B,WAAO,MAAM,cAAc,QAAQ;AAAA,EACrC,GAAG,CAAC,gBAAgB,CAAC;AAErB,SAAO;AACT","sourcesContent":["import { kInternal, stringify } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\nimport { useRoom } from \"./room\";\n\nconst MENTION_SUGGESTIONS_DEBOUNCE = 500;\n\n/**\n * @private For internal use only. Do not rely on this hook.\n *\n * Simplistic debounced search, we don't need to worry too much about deduping\n * and race conditions as there can only be one search at a time.\n */\nexport function useMentionSuggestions(search?: string) {\n  const client = useClient();\n\n  const room = useRoom();\n  const [mentionSuggestions, setMentionSuggestions] =\n    React.useState<string[]>();\n  const lastInvokedAt = React.useRef<number>();\n\n  React.useEffect(() => {\n    const mentionSuggestionsCache = client[kInternal].mentionSuggestionsCache;\n    const resolveMentionSuggestions =\n      client[kInternal].resolveMentionSuggestions;\n\n    if (search === undefined || !resolveMentionSuggestions) {\n      return;\n    }\n\n    const resolveMentionSuggestionsArgs = { text: search, roomId: room.id };\n    const mentionSuggestionsCacheKey = stringify(resolveMentionSuggestionsArgs);\n    let debounceTimeout: number | undefined;\n    let isCanceled = false;\n\n    const getMentionSuggestions = async () => {\n      try {\n        lastInvokedAt.current = performance.now();\n        const mentionSuggestions = await resolveMentionSuggestions(\n          resolveMentionSuggestionsArgs\n        );\n\n        if (!isCanceled) {\n          setMentionSuggestions(mentionSuggestions);\n          mentionSuggestionsCache.set(\n            mentionSuggestionsCacheKey,\n            mentionSuggestions\n          );\n        }\n      } catch (error) {\n        console.error((error as Error)?.message);\n      }\n    };\n\n    if (mentionSuggestionsCache.has(mentionSuggestionsCacheKey)) {\n      // If there are already cached mention suggestions, use them immediately.\n      setMentionSuggestions(\n        mentionSuggestionsCache.get(mentionSuggestionsCacheKey)\n      );\n    } else if (\n      !lastInvokedAt.current ||\n      Math.abs(performance.now() - lastInvokedAt.current) >\n        MENTION_SUGGESTIONS_DEBOUNCE\n    ) {\n      // If on the debounce's leading edge (either because it's the first invokation or enough\n      // time has passed since the last debounce), get mention suggestions immediately.\n      void getMentionSuggestions();\n    } else {\n      // Otherwise, wait for the debounce delay.\n      debounceTimeout = window.setTimeout(() => {\n        void getMentionSuggestions();\n      }, MENTION_SUGGESTIONS_DEBOUNCE);\n    }\n\n    return () => {\n      isCanceled = true;\n      window.clearTimeout(debounceTimeout);\n    };\n  }, [client, room.id, search]);\n\n  return mentionSuggestions;\n}\n","import type { SyncSource } from \"@liveblocks/core\";\nimport { kInternal } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\n\n/**\n * @private For internal use only. Do not rely on this hook.\n */\nexport function useSyncSource(): SyncSource | undefined {\n  const client = useClient();\n  const createSyncSource = client[kInternal].createSyncSource;\n  const [syncSource, setSyncSource] = React.useState<SyncSource | undefined>();\n\n  React.useEffect(() => {\n    // Create new sync source on mount\n    const newSyncSource = createSyncSource();\n    setSyncSource(newSyncSource);\n    return () => newSyncSource.destroy();\n  }, [createSyncSource]);\n\n  return syncSource;\n}\n"]}

package/dist/_private.mjs

@@ -3,7 +3,7 @@ import {
   _useRoom,
   getUmbrellaStoreForClient,
   useClient
-} from "./chunk-A7GJNN4L.mjs";
+} from "./chunk-CX62YECU.mjs";
 
 // src/use-mention-suggestions.ts
 import { kInternal, stringify } from "@liveblocks/core";
@@ -59,9 +59,25 @@ function useMentionSuggestions(search) {
   }, [client, room.id, search]);
   return mentionSuggestions;
 }
+
+// src/use-sync-source.ts
+import { kInternal as kInternal2 } from "@liveblocks/core";
+import React2 from "react";
+function useSyncSource() {
+  const client = useClient();
+  const createSyncSource = client[kInternal2].createSyncSource;
+  const [syncSource, setSyncSource] = React2.useState();
+  React2.useEffect(() => {
+    const newSyncSource = createSyncSource();
+    setSyncSource(newSyncSource);
+    return () => newSyncSource.destroy();
+  }, [createSyncSource]);
+  return syncSource;
+}
 export {
   CreateThreadError,
   getUmbrellaStoreForClient,
-  useMentionSuggestions
+  useMentionSuggestions,
+  useSyncSource
 };
 //# sourceMappingURL=_private.mjs.map

package/dist/_private.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/use-mention-suggestions.ts"],"sourcesContent":["import { kInternal, stringify } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\nimport { useRoom } from \"./room\";\n\nconst MENTION_SUGGESTIONS_DEBOUNCE = 500;\n\n/**\n * @private For internal use only. Do not rely on this hook.\n *\n * Simplistic debounced search, we don't need to worry too much about deduping\n * and race conditions as there can only be one search at a time.\n */\nexport function useMentionSuggestions(search?: string) {\n  const client = useClient();\n\n  const room = useRoom();\n  const [mentionSuggestions, setMentionSuggestions] =\n    React.useState<string[]>();\n  const lastInvokedAt = React.useRef<number>();\n\n  React.useEffect(() => {\n    const mentionSuggestionsCache = client[kInternal].mentionSuggestionsCache;\n    const resolveMentionSuggestions =\n      client[kInternal].resolveMentionSuggestions;\n\n    if (search === undefined || !resolveMentionSuggestions) {\n      return;\n    }\n\n    const resolveMentionSuggestionsArgs = { text: search, roomId: room.id };\n    const mentionSuggestionsCacheKey = stringify(resolveMentionSuggestionsArgs);\n    let debounceTimeout: number | undefined;\n    let isCanceled = false;\n\n    const getMentionSuggestions = async () => {\n      try {\n        lastInvokedAt.current = performance.now();\n        const mentionSuggestions = await resolveMentionSuggestions(\n          resolveMentionSuggestionsArgs\n        );\n\n        if (!isCanceled) {\n          setMentionSuggestions(mentionSuggestions);\n          mentionSuggestionsCache.set(\n            mentionSuggestionsCacheKey,\n            mentionSuggestions\n          );\n        }\n      } catch (error) {\n        console.error((error as Error)?.message);\n      }\n    };\n\n    if (mentionSuggestionsCache.has(mentionSuggestionsCacheKey)) {\n      // If there are already cached mention suggestions, use them immediately.\n      setMentionSuggestions(\n        mentionSuggestionsCache.get(mentionSuggestionsCacheKey)\n      );\n    } else if (\n      !lastInvokedAt.current ||\n      Math.abs(performance.now() - lastInvokedAt.current) >\n        MENTION_SUGGESTIONS_DEBOUNCE\n    ) {\n      // If on the debounce's leading edge (either because it's the first invokation or enough\n      // time has passed since the last debounce), get mention suggestions immediately.\n      void getMentionSuggestions();\n    } else {\n      // Otherwise, wait for the debounce delay.\n      debounceTimeout = window.setTimeout(() => {\n        void getMentionSuggestions();\n      }, MENTION_SUGGESTIONS_DEBOUNCE);\n    }\n\n    return () => {\n      isCanceled = true;\n      window.clearTimeout(debounceTimeout);\n    };\n  }, [client, room.id, search]);\n\n  return mentionSuggestions;\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,WAAW,iBAAiB;AACrC,OAAO,WAAW;AAKlB,IAAM,+BAA+B;AAQ9B,SAAS,sBAAsB,QAAiB;AACrD,QAAM,SAAS,UAAU;AAEzB,QAAM,OAAO,SAAQ;AACrB,QAAM,CAAC,oBAAoB,qBAAqB,IAC9C,MAAM,SAAmB;AAC3B,QAAM,gBAAgB,MAAM,OAAe;AAE3C,QAAM,UAAU,MAAM;AACpB,UAAM,0BAA0B,OAAO,SAAS,EAAE;AAClD,UAAM,4BACJ,OAAO,SAAS,EAAE;AAEpB,QAAI,WAAW,UAAa,CAAC,2BAA2B;AACtD;AAAA,IACF;AAEA,UAAM,gCAAgC,EAAE,MAAM,QAAQ,QAAQ,KAAK,GAAG;AACtE,UAAM,6BAA6B,UAAU,6BAA6B;AAC1E,QAAI;AACJ,QAAI,aAAa;AAEjB,UAAM,wBAAwB,YAAY;AACxC,UAAI;AACF,sBAAc,UAAU,YAAY,IAAI;AACxC,cAAMA,sBAAqB,MAAM;AAAA,UAC/B;AAAA,QACF;AAEA,YAAI,CAAC,YAAY;AACf,gCAAsBA,mBAAkB;AACxC,kCAAwB;AAAA,YACtB;AAAA,YACAA;AAAA,UACF;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,MAAO,OAAiB,OAAO;AAAA,MACzC;AAAA,IACF;AAEA,QAAI,wBAAwB,IAAI,0BAA0B,GAAG;AAE3D;AAAA,QACE,wBAAwB,IAAI,0BAA0B;AAAA,MACxD;AAAA,IACF,WACE,CAAC,cAAc,WACf,KAAK,IAAI,YAAY,IAAI,IAAI,cAAc,OAAO,IAChD,8BACF;AAGA,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AAEL,wBAAkB,OAAO,WAAW,MAAM;AACxC,aAAK,sBAAsB;AAAA,MAC7B,GAAG,4BAA4B;AAAA,IACjC;AAEA,WAAO,MAAM;AACX,mBAAa;AACb,aAAO,aAAa,eAAe;AAAA,IACrC;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC;AAE5B,SAAO;AACT;","names":["mentionSuggestions"]}
+{"version":3,"sources":["../src/use-mention-suggestions.ts","../src/use-sync-source.ts"],"sourcesContent":["import { kInternal, stringify } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\nimport { useRoom } from \"./room\";\n\nconst MENTION_SUGGESTIONS_DEBOUNCE = 500;\n\n/**\n * @private For internal use only. Do not rely on this hook.\n *\n * Simplistic debounced search, we don't need to worry too much about deduping\n * and race conditions as there can only be one search at a time.\n */\nexport function useMentionSuggestions(search?: string) {\n  const client = useClient();\n\n  const room = useRoom();\n  const [mentionSuggestions, setMentionSuggestions] =\n    React.useState<string[]>();\n  const lastInvokedAt = React.useRef<number>();\n\n  React.useEffect(() => {\n    const mentionSuggestionsCache = client[kInternal].mentionSuggestionsCache;\n    const resolveMentionSuggestions =\n      client[kInternal].resolveMentionSuggestions;\n\n    if (search === undefined || !resolveMentionSuggestions) {\n      return;\n    }\n\n    const resolveMentionSuggestionsArgs = { text: search, roomId: room.id };\n    const mentionSuggestionsCacheKey = stringify(resolveMentionSuggestionsArgs);\n    let debounceTimeout: number | undefined;\n    let isCanceled = false;\n\n    const getMentionSuggestions = async () => {\n      try {\n        lastInvokedAt.current = performance.now();\n        const mentionSuggestions = await resolveMentionSuggestions(\n          resolveMentionSuggestionsArgs\n        );\n\n        if (!isCanceled) {\n          setMentionSuggestions(mentionSuggestions);\n          mentionSuggestionsCache.set(\n            mentionSuggestionsCacheKey,\n            mentionSuggestions\n          );\n        }\n      } catch (error) {\n        console.error((error as Error)?.message);\n      }\n    };\n\n    if (mentionSuggestionsCache.has(mentionSuggestionsCacheKey)) {\n      // If there are already cached mention suggestions, use them immediately.\n      setMentionSuggestions(\n        mentionSuggestionsCache.get(mentionSuggestionsCacheKey)\n      );\n    } else if (\n      !lastInvokedAt.current ||\n      Math.abs(performance.now() - lastInvokedAt.current) >\n        MENTION_SUGGESTIONS_DEBOUNCE\n    ) {\n      // If on the debounce's leading edge (either because it's the first invokation or enough\n      // time has passed since the last debounce), get mention suggestions immediately.\n      void getMentionSuggestions();\n    } else {\n      // Otherwise, wait for the debounce delay.\n      debounceTimeout = window.setTimeout(() => {\n        void getMentionSuggestions();\n      }, MENTION_SUGGESTIONS_DEBOUNCE);\n    }\n\n    return () => {\n      isCanceled = true;\n      window.clearTimeout(debounceTimeout);\n    };\n  }, [client, room.id, search]);\n\n  return mentionSuggestions;\n}\n","import type { SyncSource } from \"@liveblocks/core\";\nimport { kInternal } from \"@liveblocks/core\";\nimport React from \"react\";\n\nimport { useClient } from \"./liveblocks\";\n\n/**\n * @private For internal use only. Do not rely on this hook.\n */\nexport function useSyncSource(): SyncSource | undefined {\n  const client = useClient();\n  const createSyncSource = client[kInternal].createSyncSource;\n  const [syncSource, setSyncSource] = React.useState<SyncSource | undefined>();\n\n  React.useEffect(() => {\n    // Create new sync source on mount\n    const newSyncSource = createSyncSource();\n    setSyncSource(newSyncSource);\n    return () => newSyncSource.destroy();\n  }, [createSyncSource]);\n\n  return syncSource;\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,WAAW,iBAAiB;AACrC,OAAO,WAAW;AAKlB,IAAM,+BAA+B;AAQ9B,SAAS,sBAAsB,QAAiB;AACrD,QAAM,SAAS,UAAU;AAEzB,QAAM,OAAO,SAAQ;AACrB,QAAM,CAAC,oBAAoB,qBAAqB,IAC9C,MAAM,SAAmB;AAC3B,QAAM,gBAAgB,MAAM,OAAe;AAE3C,QAAM,UAAU,MAAM;AACpB,UAAM,0BAA0B,OAAO,SAAS,EAAE;AAClD,UAAM,4BACJ,OAAO,SAAS,EAAE;AAEpB,QAAI,WAAW,UAAa,CAAC,2BAA2B;AACtD;AAAA,IACF;AAEA,UAAM,gCAAgC,EAAE,MAAM,QAAQ,QAAQ,KAAK,GAAG;AACtE,UAAM,6BAA6B,UAAU,6BAA6B;AAC1E,QAAI;AACJ,QAAI,aAAa;AAEjB,UAAM,wBAAwB,YAAY;AACxC,UAAI;AACF,sBAAc,UAAU,YAAY,IAAI;AACxC,cAAMA,sBAAqB,MAAM;AAAA,UAC/B;AAAA,QACF;AAEA,YAAI,CAAC,YAAY;AACf,gCAAsBA,mBAAkB;AACxC,kCAAwB;AAAA,YACtB;AAAA,YACAA;AAAA,UACF;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,MAAO,OAAiB,OAAO;AAAA,MACzC;AAAA,IACF;AAEA,QAAI,wBAAwB,IAAI,0BAA0B,GAAG;AAE3D;AAAA,QACE,wBAAwB,IAAI,0BAA0B;AAAA,MACxD;AAAA,IACF,WACE,CAAC,cAAc,WACf,KAAK,IAAI,YAAY,IAAI,IAAI,cAAc,OAAO,IAChD,8BACF;AAGA,WAAK,sBAAsB;AAAA,IAC7B,OAAO;AAEL,wBAAkB,OAAO,WAAW,MAAM;AACxC,aAAK,sBAAsB;AAAA,MAC7B,GAAG,4BAA4B;AAAA,IACjC;AAEA,WAAO,MAAM;AACX,mBAAa;AACb,aAAO,aAAa,eAAe;AAAA,IACrC;AAAA,EACF,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,CAAC;AAE5B,SAAO;AACT;;;ACjFA,SAAS,aAAAC,kBAAiB;AAC1B,OAAOC,YAAW;AAOX,SAAS,gBAAwC;AACtD,QAAM,SAAS,UAAU;AACzB,QAAM,mBAAmB,OAAOC,UAAS,EAAE;AAC3C,QAAM,CAAC,YAAY,aAAa,IAAIC,OAAM,SAAiC;AAE3E,EAAAA,OAAM,UAAU,MAAM;AAEpB,UAAM,gBAAgB,iBAAiB;AACvC,kBAAc,aAAa;AAC3B,WAAO,MAAM,cAAc,QAAQ;AAAA,EACrC,GAAG,CAAC,gBAAgB,CAAC;AAErB,SAAO;AACT;","names":["mentionSuggestions","kInternal","React","kInternal","React"]}

package/dist/{chunk-OVU4MAZA.js → chunk-6WXPZPS2.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }// src/version.ts
 var PKG_NAME = "@liveblocks/react";
-var PKG_VERSION = "2.11.1";
+var PKG_VERSION = "2.12.0";
 var PKG_FORMAT = "cjs";
 
 // src/ClientSideSuspense.tsx
@@ -19,4 +19,4 @@ function ClientSideSuspense(props) {
 
 
 exports.PKG_NAME = PKG_NAME; exports.PKG_VERSION = PKG_VERSION; exports.PKG_FORMAT = PKG_FORMAT; exports.ClientSideSuspense = ClientSideSuspense;
-//# sourceMappingURL=chunk-OVU4MAZA.js.map
+//# sourceMappingURL=chunk-6WXPZPS2.js.map

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

@@ -32,6 +32,7 @@ import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/w
 var SECONDS = 1e3;
 var MINUTES = 60 * SECONDS;
 var config = {
+  SMOOTH_DELAY: 1 * SECONDS,
   NOTIFICATIONS_POLL_INTERVAL: 1 * MINUTES,
   NOTIFICATIONS_MAX_STALE_TIME: 5 * SECONDS,
   ROOM_THREADS_POLL_INTERVAL: 5 * MINUTES,
@@ -503,6 +504,7 @@ var UmbrellaStore = class {
     // Room notification settings
     this._roomNotificationSettings = /* @__PURE__ */ new Map();
     this._client = client[kInternal].as();
+    this._syncSource = this._client[kInternal].createSyncSource();
     const inboxFetcher = async (cursor) => {
       const result = await this._client.getInboxNotifications({ cursor });
       this.updateThreadsAndNotifications(
@@ -651,12 +653,6 @@ var UmbrellaStore = class {
       versions: Object.values(this.get().versionsByRoomId[roomId] ?? {})
     };
   }
-  /**
-   * @private Only used by the E2E test suite.
-   */
-  _hasOptimisticUpdates() {
-    return this._store.get().optimisticUpdates.length > 0;
-  }
   subscribe(callback) {
     return this._store.subscribe(callback);
   }
@@ -703,10 +699,13 @@ var UmbrellaStore = class {
     });
   }
   updateOptimisticUpdatesCache(mapFn) {
-    this._store.set((state) => ({
-      ...state,
-      optimisticUpdates: mapFn(state.optimisticUpdates)
-    }));
+    this._store.set((state) => {
+      const optimisticUpdates = mapFn(state.optimisticUpdates);
+      this._syncSource.setSyncStatus(
+        optimisticUpdates.length > 0 ? "synchronizing" : "synchronized"
+      );
+      return { ...state, optimisticUpdates };
+    });
   }
   // ---------------------------------------------------------------------------------- }}}
   /** @internal - Only call this method from unit tests. */
@@ -1952,18 +1951,23 @@ function useRoomInfoSuspense_withClient(client, roomId) {
 }
 function createSharedContext(client) {
   const useClient2 = () => client;
+  function useSyncStatus2(options) {
+    return useSyncStatus_withClient(client, options);
+  }
   return {
     classic: {
       useClient: useClient2,
       useUser: (userId) => useUser_withClient(client, userId),
       useRoomInfo: (roomId) => useRoomInfo_withClient(client, roomId),
-      useIsInsideRoom
+      useIsInsideRoom,
+      useSyncStatus: useSyncStatus2
     },
     suspense: {
       useClient: useClient2,
       useUser: (userId) => useUserSuspense_withClient(client, userId),
       useRoomInfo: (roomId) => useRoomInfoSuspense_withClient(client, roomId),
-      useIsInsideRoom
+      useIsInsideRoom,
+      useSyncStatus: useSyncStatus2
     }
   };
 }
@@ -1995,6 +1999,7 @@ function LiveblocksProvider(props) {
     polyfills: useInitial(o.polyfills),
     unstable_fallbackToHTTP: useInitial(o.unstable_fallbackToHTTP),
     unstable_streamData: useInitial(o.unstable_streamData),
+    preventUnsavedChanges: useInitial(o.preventUnsavedChanges),
     authEndpoint: useInitialUnlessFunction(o.authEndpoint),
     resolveMentionSuggestions: useInitialUnlessFunction(
       o.resolveMentionSuggestions
@@ -2118,6 +2123,46 @@ var _useUser = useUser;
 var _useUserSuspense = useUserSuspense;
 var _useUserThreads_experimental = useUserThreads_experimental;
 var _useUserThreadsSuspense_experimental = useUserThreadsSuspense_experimental;
+function useSyncStatus_withClient(client, options) {
+  const smooth = useInitial(options?.smooth ?? false);
+  if (smooth) {
+    return useSyncStatusSmooth_withClient(client);
+  } else {
+    return useSyncStatusImmediate_withClient(client);
+  }
+}
+function useSyncStatusImmediate_withClient(client) {
+  return useSyncExternalStore(
+    client.events.syncStatus.subscribe,
+    client.getSyncStatus,
+    client.getSyncStatus
+  );
+}
+function useSyncStatusSmooth_withClient(client) {
+  const getter = client.getSyncStatus;
+  const [status, setStatus] = React2.useState(getter);
+  const oldStatus = useLatest(getter());
+  React2.useEffect(() => {
+    let timeoutId;
+    const unsub = client.events.syncStatus.subscribe(() => {
+      const newStatus = getter();
+      if (oldStatus.current === "synchronizing" && newStatus === "synchronized") {
+        timeoutId = setTimeout(() => setStatus(newStatus), config.SMOOTH_DELAY);
+      } else {
+        clearTimeout(timeoutId);
+        setStatus(newStatus);
+      }
+    });
+    return () => {
+      clearTimeout(timeoutId);
+      unsub();
+    };
+  }, [client, getter, oldStatus]);
+  return status;
+}
+function useSyncStatus(options) {
+  return useSyncStatus_withClient(useClient(), options);
+}
 
 // src/types/errors.ts
 var CreateThreadError = class extends Error {
@@ -2265,7 +2310,6 @@ function useScrollToCommentOnLoadEffect(shouldScrollOnLoad, state) {
 }
 
 // src/room.tsx
-var SMOOTH_DELAY = 1e3;
 var noop3 = () => {
 };
 var identity2 = (x) => x;
@@ -2695,7 +2739,7 @@ function useStorageStatusSmooth() {
     let timeoutId;
     const unsub = room.events.storageStatus.subscribe((newStatus) => {
       if (oldStatus.current === "synchronizing" && newStatus === "synchronized") {
-        timeoutId = setTimeout(() => setStatus(newStatus), SMOOTH_DELAY);
+        timeoutId = setTimeout(() => setStatus(newStatus), config.SMOOTH_DELAY);
       } else {
         clearTimeout(timeoutId);
         setStatus(newStatus);
@@ -3809,6 +3853,7 @@ export {
   _useUserSuspense,
   _useUserThreads_experimental,
   _useUserThreadsSuspense_experimental,
+  useSyncStatus,
   CreateThreadError,
   useStatus,
   useStorageStatus,
@@ -3868,4 +3913,4 @@ export {
   _useStorageRoot,
   _useUpdateMyPresence
 };
-//# sourceMappingURL=chunk-A7GJNN4L.mjs.map
+//# sourceMappingURL=chunk-CX62YECU.mjs.map