@liveblocks/react 0.17.9 → 0.17.10

package/.built-by-link-script

@@ -1 +1 @@
-3bd699c775fa77760553075bc966d290665174b7
+7a145c07616c7ce057d49178c31d7436fb2ab297

package/index.d.ts

@@ -183,7 +183,12 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
      * Storage.
      *
      * @example
-     * const [root] = useStorage();
+     * const [root] = useStorageRoot();
+     */
+    useStorageRoot(): [root: LiveObject<TStorage> | null];
+    /**
+     * @deprecated In the next major version, we're changing the meaning of `useStorage()`.
+     * Please use `useStorageRoot()` instead for the current behavior.
      */
     useStorage(): [root: LiveObject<TStorage> | null];
     /**
@@ -332,6 +337,14 @@ declare function useRoom<TPresence extends JsonObject, TStorage extends LsonObje
  * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
  */
 declare function useSelf<TPresence extends JsonObject, TUserMeta extends BaseUserMeta>(): User<TPresence, TUserMeta> | null;
+/**
+ * @deprecated Please use `createRoomContext()` instead of importing
+ * `useStorageRoot` from `@liveblocks/react` directly. See
+ * https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details.
+ */
+declare function useStorageRoot<TStorage extends LsonObject>(): [
+    root: LiveObject<TStorage> | null
+];
 /**
  * @deprecated Please use `createRoomContext()` instead of importing
  * `useStorage` from `@liveblocks/react` directly. See
@@ -391,4 +404,4 @@ declare function useObject<TData extends LsonObject>(key: string): LiveObject<TD
  */
 declare function useObject<TData extends LsonObject>(key: string, initialData: TData): LiveObject<TData> | null;
 
-export { LiveblocksProvider, RoomProvider, createRoomContext, useBatch, useBroadcastEvent, useClient, useErrorListener, useEventListener, useHistory, useList, useMap, useMyPresence, useObject, useOthers, useRedo, useRoom, useSelf, useStorage, useUndo, useUpdateMyPresence };
+export { LiveblocksProvider, RoomProvider, createRoomContext, useBatch, useBroadcastEvent, useClient, useErrorListener, useEventListener, useHistory, useList, useMap, useMyPresence, useObject, useOthers, useRedo, useRoom, useSelf, useStorage, useStorageRoot, useUndo, useUpdateMyPresence };

package/index.js

@@ -221,7 +221,7 @@ function createRoomContext(client) {
     }, [room, rerender]);
     return room.getSelf();
   }
-  function useStorage2() {
+  function useStorageRoot2() {
     const room = useRoom2();
     const [root, setState] = React2.useState(null);
     React2.useEffect(() => {
@@ -241,6 +241,12 @@ function createRoomContext(client) {
     }, [room]);
     return [root];
   }
+  function useStorage2() {
+    _internal.deprecate.call(void 0, 
+      "In the upcoming 0.18 version, the name `useStorage()` is going to be repurposed for a new hook. Please use `useStorageRoot()` instead to keep the current behavior."
+    );
+    return useStorageRoot2();
+  }
   function useMap_deprecated(key, entries) {
     _internal.errorIf.call(void 0, 
       entries,
@@ -434,7 +440,7 @@ Please see https://bit.ly/3Niy5aP for details.`
   }
   function useStorageValue(key, initialValue) {
     const room = useRoom2();
-    const [root] = useStorage2();
+    const [root] = useStorageRoot2();
     const rerender = useRerender();
     const frozenInitialValue = useInitial(initialValue);
     React2.useEffect(() => {
@@ -500,6 +506,7 @@ Please see https://bit.ly/3Niy5aP for details.`
     useRedo: useRedo2,
     useRoom: useRoom2,
     useSelf: useSelf2,
+    useStorageRoot: useStorageRoot2,
     useStorage: useStorage2,
     useUndo: useUndo2,
     useUpdateMyPresence: useUpdateMyPresence2,
@@ -579,6 +586,12 @@ function useSelf() {
   );
   return _hooks.useSelf();
 }
+function useStorageRoot() {
+  _internal.deprecate.call(void 0, 
+    "Please use `createRoomContext()` instead of importing `useStorageRoot` from `@liveblocks/react` directly. See https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details."
+  );
+  return _hooks.useStorageRoot();
+}
 function useStorage() {
   _internal.deprecate.call(void 0, 
     "Please use `createRoomContext()` instead of importing `useStorage` from `@liveblocks/react` directly. See https://liveblocks.io/docs/guides/upgrading#upgrading-from-0-16-to-0-17 for details."
@@ -636,4 +649,5 @@ function useObject(key, initialData) {
 
 
 
-exports.LiveblocksProvider = LiveblocksProvider; exports.RoomProvider = RoomProvider; exports.createRoomContext = createRoomContext; exports.useBatch = useBatch; exports.useBroadcastEvent = useBroadcastEvent; exports.useClient = useClient; exports.useErrorListener = useErrorListener; exports.useEventListener = useEventListener; exports.useHistory = useHistory; exports.useList = useList; exports.useMap = useMap; exports.useMyPresence = useMyPresence; exports.useObject = useObject; exports.useOthers = useOthers; exports.useRedo = useRedo; exports.useRoom = useRoom; exports.useSelf = useSelf; exports.useStorage = useStorage; exports.useUndo = useUndo; exports.useUpdateMyPresence = useUpdateMyPresence;
+
+exports.LiveblocksProvider = LiveblocksProvider; exports.RoomProvider = RoomProvider; exports.createRoomContext = createRoomContext; exports.useBatch = useBatch; exports.useBroadcastEvent = useBroadcastEvent; exports.useClient = useClient; exports.useErrorListener = useErrorListener; exports.useEventListener = useEventListener; exports.useHistory = useHistory; exports.useList = useList; exports.useMap = useMap; exports.useMyPresence = useMyPresence; exports.useObject = useObject; exports.useOthers = useOthers; exports.useRedo = useRedo; exports.useRoom = useRoom; exports.useSelf = useSelf; exports.useStorage = useStorage; exports.useStorageRoot = useStorageRoot; exports.useUndo = useUndo; exports.useUpdateMyPresence = useUpdateMyPresence;

package/index.mjs

@@ -1,23 +1,23 @@
-import mod from "./index.js";
-
-export default mod;
-export const LiveblocksProvider = mod.LiveblocksProvider;
-export const RoomProvider = mod.RoomProvider;
-export const createRoomContext = mod.createRoomContext;
-export const useBatch = mod.useBatch;
-export const useBroadcastEvent = mod.useBroadcastEvent;
-export const useClient = mod.useClient;
-export const useErrorListener = mod.useErrorListener;
-export const useEventListener = mod.useEventListener;
-export const useHistory = mod.useHistory;
-export const useList = mod.useList;
-export const useMap = mod.useMap;
-export const useMyPresence = mod.useMyPresence;
-export const useObject = mod.useObject;
-export const useOthers = mod.useOthers;
-export const useRedo = mod.useRedo;
-export const useRoom = mod.useRoom;
-export const useSelf = mod.useSelf;
-export const useStorage = mod.useStorage;
-export const useUndo = mod.useUndo;
-export const useUpdateMyPresence = mod.useUpdateMyPresence;
+export {
+  LiveblocksProvider,
+  RoomProvider,
+  createRoomContext,
+  useBatch,
+  useBroadcastEvent,
+  useClient,
+  useErrorListener,
+  useEventListener,
+  useHistory,
+  useList,
+  useMap,
+  useMyPresence,
+  useObject,
+  useOthers,
+  useRedo,
+  useRoom,
+  useSelf,
+  useStorage,
+  useStorageRoot,
+  useUndo,
+  useUpdateMyPresence,
+} from "./index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liveblocks/react",
-  "version": "0.17.9",
+  "version": "0.17.10",
   "description": "A set of React hooks and providers to use Liveblocks declaratively.",
   "main": "./index.js",
   "module": "./index.mjs",
@@ -17,7 +17,7 @@
   },
   "license": "Apache-2.0",
   "peerDependencies": {
-    "@liveblocks/client": "0.17.9",
+    "@liveblocks/client": "0.17.10",
     "react": "^16.14.0 || ^17 || ^18"
   },
   "repository": {