@liveblocks/react 0.16.4-beta1 → 0.16.5

package/index.js

@@ -1,362 +1,272 @@
-'use strict';
+"use strict";
 
-Object.defineProperty(exports, '__esModule', { value: true });
+Object.defineProperty(exports, "__esModule", {
+ value: !0
+});
 
-var React = require('react');
-var client = require('@liveblocks/client');
+var React = require("react"), client = require("@liveblocks/client"), internal = require("@liveblocks/client/internal");
 
 function _interopNamespace(e) {
-  if (e && e.__esModule) return e;
-  var n = Object.create(null);
-  if (e) {
-    Object.keys(e).forEach(function (k) {
-      if (k !== 'default') {
-        var d = Object.getOwnPropertyDescriptor(e, k);
-        Object.defineProperty(n, k, d.get ? d : {
-          enumerable: true,
-          get: function () { return e[k]; }
-        });
-      }
-    });
+ if (e && e.__esModule) return e;
+ var n = Object.create(null);
+ return e && Object.keys(e).forEach((function(k) {
+  if ("default" !== k) {
+   var d = Object.getOwnPropertyDescriptor(e, k);
+   Object.defineProperty(n, k, d.get ? d : {
+    enumerable: !0,
+    get: function() {
+     return e[k];
+    }
+   });
   }
-  n["default"] = e;
-  return Object.freeze(n);
+ })), n.default = e, Object.freeze(n);
 }
 
-var React__namespace = /*#__PURE__*/_interopNamespace(React);
+var React__namespace = _interopNamespace(React), ClientContext = React__namespace.createContext(null);
 
-var ClientContext = React__namespace.createContext(null);
-function LiveblocksProvider(props) {
-  return React__namespace.createElement(ClientContext.Provider, {
-    value: props.client
-  }, props.children);
-}
 function useClient() {
-  var client = React__namespace.useContext(ClientContext);
-
-  if (client == null) {
-    throw new Error("LiveblocksProvider is missing from the react tree");
-  }
-
-  return client;
+ var client = React__namespace.useContext(ClientContext);
+ if (null == client) throw new Error("LiveblocksProvider is missing from the react tree");
+ return client;
 }
 
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
-  try {
-    var info = gen[key](arg);
-    var value = info.value;
-  } catch (error) {
-    reject(error);
-    return;
-  }
-
-  if (info.done) {
-    resolve(value);
-  } else {
-    Promise.resolve(value).then(_next, _throw);
-  }
+ try {
+  var info = gen[key](arg), value = info.value;
+ } catch (error) {
+  return void reject(error);
+ }
+ info.done ? resolve(value) : Promise.resolve(value).then(_next, _throw);
 }
 
 function _asyncToGenerator(fn) {
-  return function () {
-    var self = this,
-        args = arguments;
-    return new Promise(function (resolve, reject) {
-      var gen = fn.apply(self, args);
-
-      function _next(value) {
-        asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
-      }
-
-      function _throw(err) {
-        asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
-      }
-
-      _next(undefined);
-    });
-  };
+ return function() {
+  var self = this, args = arguments;
+  return new Promise((function(resolve, reject) {
+   var gen = fn.apply(self, args);
+   function _next(value) {
+    asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+   }
+   function _throw(err) {
+    asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+   }
+   _next(void 0);
+  }));
+ };
 }
 
 function useRerender() {
-  var _useReducer = React.useReducer(function (x) {
-    return x + 1;
-  }, 0),
-      update = _useReducer[1];
-
-  return update;
+ return React.useReducer((function(x) {
+  return x + 1;
+ }), 0)[1];
 }
 
-var RoomContext = React__namespace.createContext(null);
-function RoomProvider(props) {
-  var roomId = props.id,
-      defaultPresence = props.defaultPresence,
-      defaultStorageRoot = props.defaultStorageRoot;
-
-  if (process.env.NODE_ENV !== "production") {
-    if (roomId == null) {
-      throw new Error("RoomProvider id property is required. For more information: https://liveblocks.io/docs/errors/liveblocks-react/RoomProvider-id-property-is-required");
-    }
-
-    if (typeof roomId !== "string") {
-      throw new Error("RoomProvider id property should be a string.");
-    }
-  }
-
-  var client = useClient();
-
-  var _React$useState = React__namespace.useState(function () {
-    return client.enter(roomId, {
-      defaultPresence: defaultPresence ? defaultPresence() : undefined,
-      defaultStorageRoot: defaultStorageRoot,
-      DO_NOT_USE_withoutConnecting: typeof window === "undefined"
-    });
-  }),
-      room = _React$useState[0],
-      setRoom = _React$useState[1];
-
-  React__namespace.useEffect(function () {
-    setRoom(client.enter(roomId, {
-      defaultPresence: defaultPresence ? defaultPresence() : undefined,
-      defaultStorageRoot: defaultStorageRoot,
-      DO_NOT_USE_withoutConnecting: typeof window === "undefined"
-    }));
-    return function () {
-      client.leave(roomId);
-    };
-  }, [client, roomId]);
-  return React__namespace.createElement(RoomContext.Provider, {
-    value: room
-  }, props.children);
-}
-function useRoom() {
+var _create = function() {
+ var RoomContext = React__namespace.createContext(null);
+ function useRoom() {
   var room = React__namespace.useContext(RoomContext);
-
-  if (room == null) {
-    throw new Error("RoomProvider is missing from the react tree");
-  }
-
+  if (null == room) throw new Error("RoomProvider is missing from the react tree");
   return room;
-}
-function useMyPresence() {
-  var room = useRoom();
-  var presence = room.getPresence();
-  var rerender = useRerender();
-  React__namespace.useEffect(function () {
-    var unsubscribe = room.subscribe("my-presence", rerender);
-    return function () {
-      unsubscribe();
+ }
+ function useStorage() {
+  var room = useRoom(), _React$useState2 = React__namespace.useState(null), root = _React$useState2[0], setState = _React$useState2[1];
+  return React__namespace.useEffect((function() {
+   var didCancel = !1;
+   function _fetchStorage() {
+    return (_fetchStorage = _asyncToGenerator(regeneratorRuntime.mark((function _callee() {
+     var storage;
+     return regeneratorRuntime.wrap((function(_context) {
+      for (;;) switch (_context.prev = _context.next) {
+      case 0:
+       return _context.next = 2, room.getStorage();
+
+      case 2:
+       storage = _context.sent, didCancel || setState(storage.root);
+
+      case 4:
+      case "end":
+       return _context.stop();
+      }
+     }), _callee);
+    })))).apply(this, arguments);
+   }
+   return function() {
+    _fetchStorage.apply(this, arguments);
+   }(), function() {
+    didCancel = !0;
+   };
+  }), [ room ]), [ root ];
+ }
+ function useHistory() {
+  return useRoom().history;
+ }
+ function useStorageValue(key, initialValue) {
+  var room = useRoom(), root = useStorage()[0], rerender = useRerender();
+  if (React__namespace.useEffect((function() {
+   if (null != root) {
+    var liveValue = root.get(key);
+    null == liveValue && (liveValue = initialValue, root.set(key, liveValue));
+    var unsubscribeCrdt = room.subscribe(liveValue, rerender), unsubscribeRoot = room.subscribe(root, (function() {
+     var newCrdt = root.get(key);
+     newCrdt !== liveValue && (unsubscribeCrdt(), liveValue = newCrdt, unsubscribeCrdt = room.subscribe(liveValue, rerender), 
+     rerender());
+    }));
+    return rerender(), function() {
+     unsubscribeRoot(), unsubscribeCrdt();
     };
-  }, [room]);
-  var setPresence = React__namespace.useCallback(function (overrides, options) {
-    return room.updatePresence(overrides, options);
-  }, [room]);
-  return [presence, setPresence];
-}
-function useUpdateMyPresence() {
-  var room = useRoom();
-  return React__namespace.useCallback(function (overrides, options) {
-    room.updatePresence(overrides, options);
-  }, [room]);
-}
-function useOthers() {
-  var room = useRoom();
-  var rerender = useRerender();
-  React__namespace.useEffect(function () {
-    var unsubscribe = room.subscribe("others", rerender);
-    return function () {
-      unsubscribe();
+   }
+  }), [ root, room ]), null == root) return {
+   status: "loading"
+  };
+  var value = root.get(key);
+  return null == value ? {
+   status: "notfound"
+  } : {
+   status: "ok",
+   value: value
+  };
+ }
+ return {
+  RoomProvider: function(props) {
+   var roomId = props.id, initialPresence = props.initialPresence, initialStorage = props.initialStorage, defaultPresence = props.defaultPresence, defaultStorageRoot = props.defaultStorageRoot;
+   if ("production" !== process.env.NODE_ENV) {
+    if (null == roomId) throw new Error("RoomProvider id property is required. For more information: https://liveblocks.io/docs/errors/liveblocks-react/RoomProvider-id-property-is-required");
+    if ("string" != typeof roomId) throw new Error("RoomProvider id property should be a string.");
+   }
+   internal.deprecateIf(defaultPresence, "RoomProvider's `defaultPresence` prop will be removed in @liveblocks/react 0.18. Please use `initialPresence` instead. For more info, see https://bit.ly/3Niy5aP", "defaultPresence"), 
+   internal.deprecateIf(defaultStorageRoot, "RoomProvider's `defaultStorageRoot` prop will be removed in @liveblocks/react 0.18. Please use `initialStorage` instead. For more info, see https://bit.ly/3Niy5aP", "defaultStorageRoot");
+   var client = useClient(), _React$useState = React__namespace.useState((function() {
+    return client.enter(roomId, {
+     initialPresence: initialPresence,
+     initialStorage: initialStorage,
+     defaultPresence: defaultPresence,
+     defaultStorageRoot: defaultStorageRoot,
+     DO_NOT_USE_withoutConnecting: "undefined" == typeof window
+    });
+   })), room = _React$useState[0], setRoom = _React$useState[1];
+   return React__namespace.useEffect((function() {
+    return setRoom(client.enter(roomId, {
+     initialPresence: initialPresence,
+     initialStorage: initialStorage,
+     defaultPresence: defaultPresence,
+     defaultStorageRoot: defaultStorageRoot,
+     DO_NOT_USE_withoutConnecting: "undefined" == typeof window
+    })), function() {
+     client.leave(roomId);
     };
-  }, [room]);
-  return room.getOthers();
-}
-function useBroadcastEvent() {
-  var room = useRoom();
-  return React__namespace.useCallback(function (event, options) {
-    if (options === void 0) {
-      options = {
-        shouldQueueEventIfNotReady: false
-      };
-    }
-
-    room.broadcastEvent(event, options);
-  }, [room]);
-}
-function useErrorListener(callback) {
-  var room = useRoom();
-  var savedCallback = React__namespace.useRef(callback);
-  React__namespace.useEffect(function () {
+   }), [ client, roomId ]), React__namespace.createElement(RoomContext.Provider, {
+    value: room
+   }, props.children);
+  },
+  useBatch: function() {
+   return useRoom().batch;
+  },
+  useBroadcastEvent: function() {
+   var room = useRoom();
+   return React__namespace.useCallback((function(event, options) {
+    void 0 === options && (options = {
+     shouldQueueEventIfNotReady: !1
+    }), room.broadcastEvent(event, options);
+   }), [ room ]);
+  },
+  useErrorListener: function(callback) {
+   var room = useRoom(), savedCallback = React__namespace.useRef(callback);
+   React__namespace.useEffect((function() {
     savedCallback.current = callback;
-  });
-  React__namespace.useEffect(function () {
-    var listener = function listener(e) {
-      return savedCallback.current(e);
-    };
-
-    var unsubscribe = room.subscribe("error", listener);
-    return function () {
-      unsubscribe();
+   })), React__namespace.useEffect((function() {
+    var unsubscribe = room.subscribe("error", (function(e) {
+     return savedCallback.current(e);
+    }));
+    return function() {
+     unsubscribe();
     };
-  }, [room]);
-}
-function useEventListener(callback) {
-  var room = useRoom();
-  var savedCallback = React__namespace.useRef(callback);
-  React__namespace.useEffect(function () {
+   }), [ room ]);
+  },
+  useEventListener: function(callback) {
+   var room = useRoom(), savedCallback = React__namespace.useRef(callback);
+   React__namespace.useEffect((function() {
     savedCallback.current = callback;
-  });
-  React__namespace.useEffect(function () {
-    var listener = function listener(e) {
-      return savedCallback.current(e);
+   })), React__namespace.useEffect((function() {
+    var unsubscribe = room.subscribe("event", (function(e) {
+     return savedCallback.current(e);
+    }));
+    return function() {
+     unsubscribe();
     };
-
-    var unsubscribe = room.subscribe("event", listener);
-    return function () {
-      unsubscribe();
+   }), [ room ]);
+  },
+  useHistory: useHistory,
+  useList: function(key, items) {
+   internal.deprecateIf(items, 'Support for initializing items in useList() directly will be removed in @liveblocks/react 0.18.\n\nInstead, please initialize this data where you set up your RoomProvider:\n\n    import { LiveList } from "@liveblocks/client";\n\n    const initialStorage = () => {\n      ' + JSON.stringify(key) + ": new LiveList(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details.");
+   var value = useStorageValue(key, new client.LiveList(items));
+   return "ok" === value.status ? value.value : (internal.deprecateIf("notfound" === value.status, "Key " + JSON.stringify(key) + ' was not found in Storage. Starting with 0.18, useList() will no longer automatically create this key.\n\nInstead, please initialize your storage where you set up your RoomProvider:\n\n    import { LiveList } from "@liveblocks/client";\n\n    const initialStorage = () => {\n      ' + JSON.stringify(key) + ": new LiveList(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details."), 
+   null);
+  },
+  useMap: function(key, entries) {
+   internal.deprecateIf(entries, "Support for initializing entries in useMap() directly will be removed in @liveblocks/react 0.18.\n\nInstead, please initialize this data where you set up your RoomProvider:\n\n    const initialStorage = () => {\n      " + JSON.stringify(key) + ": new LiveMap(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details.");
+   var value = useStorageValue(key, new client.LiveMap(null != entries ? entries : void 0));
+   return "ok" === value.status ? value.value : (internal.deprecateIf("notfound" === value.status, "Key " + JSON.stringify(key) + ' was not found in Storage. Starting with 0.18, useMap() will no longer automatically create this key.\n\nInstead, please initialize your storage where you set up your RoomProvider:\n\n    import { LiveMap } from "@liveblocks/client";\n\n    const initialStorage = () => {\n      ' + JSON.stringify(key) + ": new LiveMap(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details."), 
+   null);
+  },
+  useMyPresence: function() {
+   var room = useRoom(), presence = room.getPresence(), rerender = useRerender();
+   return React__namespace.useEffect((function() {
+    var unsubscribe = room.subscribe("my-presence", rerender);
+    return function() {
+     unsubscribe();
     };
-  }, [room]);
-}
-function useSelf() {
-  var room = useRoom();
-  var rerender = useRerender();
-  React__namespace.useEffect(function () {
-    var unsubscribePresence = room.subscribe("my-presence", rerender);
-    var unsubscribeConnection = room.subscribe("connection", rerender);
-    return function () {
-      unsubscribePresence();
-      unsubscribeConnection();
+   }), [ room ]), [ presence, React__namespace.useCallback((function(overrides, options) {
+    return room.updatePresence(overrides, options);
+   }), [ room ]) ];
+  },
+  useObject: function(key, initialData) {
+   internal.deprecateIf(initialData, 'Support for initializing data in useObject() directly will be removed in @liveblocks/react 0.18.\n\nInstead, please initialize this data where you set up your RoomProvider:\n\n    import { LiveObject } from "@liveblocks/client";\n\n    const initialStorage = () => {\n      ' + JSON.stringify(key) + ": new LiveObject(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details.");
+   var value = useStorageValue(key, new client.LiveObject(initialData));
+   return "ok" === value.status ? value.value : (internal.deprecateIf("notfound" === value.status, "Key " + JSON.stringify(key) + ' was not found in Storage. Starting with 0.18, useObject() will no longer automatically create this key.\n\nInstead, please initialize your storage where you set up your RoomProvider:\n\n    import { LiveObject } from "@liveblocks/client";\n\n    const initialStorage = () => {\n      ' + JSON.stringify(key) + ": new LiveObject(...),\n      ...\n    };\n\n    <RoomProvider initialStorage={initialStorage}>\n      ...\n    </RoomProvider>\n\nPlease see https://bit.ly/3Niy5aP for details."), 
+   null);
+  },
+  useOthers: function() {
+   var room = useRoom(), rerender = useRerender();
+   return React__namespace.useEffect((function() {
+    var unsubscribe = room.subscribe("others", rerender);
+    return function() {
+     unsubscribe();
     };
-  }, [room]);
-  return room.getSelf();
-}
-function useStorage() {
-  var room = useRoom();
-
-  var _React$useState2 = React__namespace.useState(null),
-      root = _React$useState2[0],
-      setState = _React$useState2[1];
-
-  React__namespace.useEffect(function () {
-    var didCancel = false;
-
-    function fetchStorage() {
-      return _fetchStorage.apply(this, arguments);
-    }
-
-    function _fetchStorage() {
-      _fetchStorage = _asyncToGenerator(regeneratorRuntime.mark(function _callee() {
-        var storage;
-        return regeneratorRuntime.wrap(function _callee$(_context) {
-          while (1) {
-            switch (_context.prev = _context.next) {
-              case 0:
-                _context.next = 2;
-                return room.getStorage();
-
-              case 2:
-                storage = _context.sent;
-
-                if (!didCancel) {
-                  setState(storage.root);
-                }
-
-              case 4:
-              case "end":
-                return _context.stop();
-            }
-          }
-        }, _callee);
-      }));
-      return _fetchStorage.apply(this, arguments);
-    }
-
-    fetchStorage();
-    return function () {
-      didCancel = true;
+   }), [ room ]), room.getOthers();
+  },
+  useRedo: function() {
+   return useHistory().redo;
+  },
+  useRoom: useRoom,
+  useSelf: function() {
+   var room = useRoom(), rerender = useRerender();
+   return React__namespace.useEffect((function() {
+    var unsubscribePresence = room.subscribe("my-presence", rerender), unsubscribeConnection = room.subscribe("connection", rerender);
+    return function() {
+     unsubscribePresence(), unsubscribeConnection();
     };
-  }, [room]);
-  return [root];
-}
-function useMap(key, entries) {
-  return useCrdt(key, new client.LiveMap(entries));
-}
-function useList(key, items) {
-  return useCrdt(key, new client.LiveList(items));
-}
-function useObject(key, initialData) {
-  return useCrdt(key, new client.LiveObject(initialData));
-}
-function useUndo() {
-  return useRoom().history.undo;
-}
-function useRedo() {
-  return useRoom().history.redo;
-}
-function useBatch() {
-  return useRoom().batch;
-}
-function useHistory() {
-  return useRoom().history;
-}
-
-function useCrdt(key, initialCrdt) {
-  var _root$get;
-
-  var room = useRoom();
-
-  var _useStorage = useStorage(),
-      root = _useStorage[0];
-
-  var rerender = useRerender();
-  React__namespace.useEffect(function () {
-    if (root == null) {
-      return;
-    }
-
-    var crdt = root.get(key);
-
-    if (crdt == null) {
-      crdt = initialCrdt;
-      root.set(key, crdt);
-    }
-
-    function onRootChange() {
-      var newCrdt = root.get(key);
-
-      if (newCrdt !== crdt) {
-        unsubscribeCrdt();
-        crdt = newCrdt;
-        unsubscribeCrdt = room.subscribe(crdt, rerender);
-        rerender();
-      }
-    }
-
-    var unsubscribeCrdt = room.subscribe(crdt, rerender);
-    var unsubscribeRoot = room.subscribe(root, onRootChange);
-    rerender();
-    return function () {
-      unsubscribeRoot();
-      unsubscribeCrdt();
-    };
-  }, [root, room]);
-  return (_root$get = root == null ? void 0 : root.get(key)) != null ? _root$get : null;
-}
-
-exports.LiveblocksProvider = LiveblocksProvider;
-exports.RoomProvider = RoomProvider;
-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;
+   }), [ room ]), room.getSelf();
+  },
+  useStorage: useStorage,
+  useUndo: function() {
+   return useHistory().undo;
+  },
+  useUpdateMyPresence: function() {
+   var room = useRoom();
+   return React__namespace.useCallback((function(overrides, options) {
+    room.updatePresence(overrides, options);
+   }), [ room ]);
+  }
+ };
+}(), RoomProvider = _create.RoomProvider, useRoom = _create.useRoom, useMyPresence = _create.useMyPresence, useUpdateMyPresence = _create.useUpdateMyPresence, useOthers = _create.useOthers, useBroadcastEvent = _create.useBroadcastEvent, useErrorListener = _create.useErrorListener, useEventListener = _create.useEventListener, useSelf = _create.useSelf, useStorage = _create.useStorage, useMap = _create.useMap, useList = _create.useList, useObject = _create.useObject, useUndo = _create.useUndo, useRedo = _create.useRedo, useBatch = _create.useBatch, useHistory = _create.useHistory;
+
+exports.LiveblocksProvider = function(props) {
+ return React__namespace.createElement(ClientContext.Provider, {
+  value: props.client
+ }, props.children);
+}, exports.RoomProvider = RoomProvider, 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;