@liveblocks/core 1.4.8 → 1.5.0-subdoc

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "1.4.8";
+var PKG_VERSION = "1.5.0-subdoc";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -585,8 +585,8 @@ function tryParseJson(rawMessage) {
     return void 0;
   }
 }
-function deepClone(items) {
-  return JSON.parse(JSON.stringify(items));
+function deepClone(value) {
+  return JSON.parse(JSON.stringify(value));
 }
 function b64decode(b64value) {
   try {
@@ -673,6 +673,9 @@ function shouldRetryWithoutReauth(code) {
 }
 
 // src/connection.ts
+function isIdle(status) {
+  return status === "initial" || status === "disconnected";
+}
 function newToLegacyStatus(status) {
   switch (status) {
     case "connecting":
@@ -701,6 +704,7 @@ function toNewConnectionStatus(machine) {
     case "@auth.backoff":
     case "@connecting.busy":
     case "@connecting.backoff":
+    case "@idle.zombie":
       return machine.context.successCount > 0 ? "reconnecting" : "connecting";
     case "@idle.failed":
       return "disconnected";
@@ -842,7 +846,7 @@ function createConnectionStateMachine(delegates, options) {
     socket: null,
     backoffDelay: RESET_DELAY
   };
-  const machine = new FSM(initialContext).addState("@idle.initial").addState("@idle.failed").addState("@auth.busy").addState("@auth.backoff").addState("@connecting.busy").addState("@connecting.backoff").addState("@ok.connected").addState("@ok.awaiting-pong");
+  const machine = new FSM(initialContext).addState("@idle.initial").addState("@idle.failed").addState("@idle.zombie").addState("@auth.busy").addState("@auth.backoff").addState("@connecting.busy").addState("@connecting.backoff").addState("@ok.connected").addState("@ok.awaiting-pong");
   machine.addTransitions("*", {
     RECONNECT: {
       target: "@auth.backoff",
@@ -1052,11 +1056,20 @@ function createConnectionStateMachine(delegates, options) {
       _optionalChain([ctx, 'access', _14 => _14.socket, 'optionalAccess', _15 => _15.send, 'call', _16 => _16("ping")]);
     }
   };
-  machine.addTimedTransition("@ok.connected", HEARTBEAT_INTERVAL, sendHeartbeat).addTransitions("@ok.connected", {
-    NAVIGATOR_OFFLINE: sendHeartbeat,
+  const maybeHeartbeat = () => {
+    const doc = typeof document !== "undefined" ? document : void 0;
+    const canZombie = _optionalChain([doc, 'optionalAccess', _17 => _17.visibilityState]) === "hidden" && delegates.canZombie();
+    return canZombie ? "@idle.zombie" : sendHeartbeat;
+  };
+  machine.addTimedTransition("@ok.connected", HEARTBEAT_INTERVAL, maybeHeartbeat).addTransitions("@ok.connected", {
+    NAVIGATOR_OFFLINE: maybeHeartbeat,
     // Don't take the browser's word for it when it says it's offline. Do a ping/pong to make sure.
     WINDOW_GOT_FOCUS: sendHeartbeat
   });
+  machine.addTransitions("@idle.zombie", {
+    WINDOW_GOT_FOCUS: "@connecting.backoff"
+    // When in zombie state, the client will try to wake up automatically when the window regains focus
+  });
   machine.onEnter("@ok.*", (ctx) => {
     ctx.patch({ successCount: ctx.successCount + 1 });
     const timerID = setTimeout(
@@ -1084,7 +1097,7 @@ function createConnectionStateMachine(delegates, options) {
     // socket, or not. So always check to see if the socket is still OPEN or
     // not. When still OPEN, don't transition.
     EXPLICIT_SOCKET_ERROR: (_, context) => {
-      if (_optionalChain([context, 'access', _17 => _17.socket, 'optionalAccess', _18 => _18.readyState]) === 1) {
+      if (_optionalChain([context, 'access', _18 => _18.socket, 'optionalAccess', _19 => _19.readyState]) === 1) {
         return null;
       }
       return {
@@ -1136,17 +1149,17 @@ function createConnectionStateMachine(delegates, options) {
         machine.send({ type: "NAVIGATOR_ONLINE" });
       }
       function onVisibilityChange() {
-        if (_optionalChain([doc, 'optionalAccess', _19 => _19.visibilityState]) === "visible") {
+        if (_optionalChain([doc, 'optionalAccess', _20 => _20.visibilityState]) === "visible") {
           machine.send({ type: "WINDOW_GOT_FOCUS" });
         }
       }
-      _optionalChain([win, 'optionalAccess', _20 => _20.addEventListener, 'call', _21 => _21("online", onNetworkBackOnline)]);
-      _optionalChain([win, 'optionalAccess', _22 => _22.addEventListener, 'call', _23 => _23("offline", onNetworkOffline)]);
-      _optionalChain([root, 'optionalAccess', _24 => _24.addEventListener, 'call', _25 => _25("visibilitychange", onVisibilityChange)]);
+      _optionalChain([win, 'optionalAccess', _21 => _21.addEventListener, 'call', _22 => _22("online", onNetworkBackOnline)]);
+      _optionalChain([win, 'optionalAccess', _23 => _23.addEventListener, 'call', _24 => _24("offline", onNetworkOffline)]);
+      _optionalChain([root, 'optionalAccess', _25 => _25.addEventListener, 'call', _26 => _26("visibilitychange", onVisibilityChange)]);
       return () => {
-        _optionalChain([root, 'optionalAccess', _26 => _26.removeEventListener, 'call', _27 => _27("visibilitychange", onVisibilityChange)]);
-        _optionalChain([win, 'optionalAccess', _28 => _28.removeEventListener, 'call', _29 => _29("online", onNetworkBackOnline)]);
-        _optionalChain([win, 'optionalAccess', _30 => _30.removeEventListener, 'call', _31 => _31("offline", onNetworkOffline)]);
+        _optionalChain([root, 'optionalAccess', _27 => _27.removeEventListener, 'call', _28 => _28("visibilitychange", onVisibilityChange)]);
+        _optionalChain([win, 'optionalAccess', _29 => _29.removeEventListener, 'call', _30 => _30("online", onNetworkBackOnline)]);
+        _optionalChain([win, 'optionalAccess', _31 => _31.removeEventListener, 'call', _32 => _32("offline", onNetworkOffline)]);
         teardownSocket(ctx.socket);
       };
     });
@@ -1235,7 +1248,7 @@ var ManagedSocket = class {
    * message if this is somehow impossible.
    */
   send(data) {
-    const socket = _optionalChain([this, 'access', _32 => _32.machine, 'access', _33 => _33.context, 'optionalAccess', _34 => _34.socket]);
+    const socket = _optionalChain([this, 'access', _33 => _33.machine, 'access', _34 => _34.context, 'optionalAccess', _35 => _35.socket]);
     if (socket === null) {
       warn("Cannot send: not connected yet", data);
     } else if (socket.readyState !== 1) {
@@ -1287,6 +1300,12 @@ function createAuthManager(authOptions) {
   const tokens = [];
   const expiryTimes = [];
   const requestPromises = /* @__PURE__ */ new Map();
+  function reset() {
+    seenTokens.clear();
+    tokens.length = 0;
+    expiryTimes.length = 0;
+    requestPromises.clear();
+  }
   function hasCorrespondingScopes(requestedScope, scopes) {
     if (requestedScope === "comments:read") {
       return scopes.includes("comments:read" /* CommentsRead */) || scopes.includes("comments:write" /* CommentsWrite */) || scopes.includes("room:read" /* Read */) || scopes.includes("room:write" /* Write */);
@@ -1318,11 +1337,11 @@ function createAuthManager(authOptions) {
     return void 0;
   }
   async function makeAuthRequest(roomId) {
-    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _35 => _35.polyfills, 'optionalAccess', _36 => _36.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
+    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _36 => _36.polyfills, 'optionalAccess', _37 => _37.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
     if (authentication.type === "private") {
       if (fetcher === void 0) {
         throw new StopRetrying(
-          "To use Liveblocks client in a non-dom environment with a url as auth endpoint, you need to provide a fetch polyfill."
+          "To use Liveblocks client in a non-DOM environment with a url as auth endpoint, you need to provide a fetch polyfill."
         );
       }
       const response = await fetchAuthEndpoint(fetcher, authentication.url, {
@@ -1386,6 +1405,7 @@ function createAuthManager(authOptions) {
     }
   }
   return {
+    reset,
     getAuthValue
   };
 }
@@ -1467,6 +1487,9 @@ async function fetchAuthEndpoint(fetch2, endpoint, body) {
   return { token };
 }
 
+// src/constants.ts
+var DEFAULT_BASE_URL = "https://api.liveblocks.io";
+
 // src/devtools/bridge.ts
 var _bridgeActive = false;
 function activateBridge(allowed) {
@@ -1480,7 +1503,7 @@ function sendToPanel(message, options) {
     ...message,
     source: "liveblocks-devtools-client"
   };
-  if (!(_optionalChain([options, 'optionalAccess', _37 => _37.force]) || _bridgeActive)) {
+  if (!(_optionalChain([options, 'optionalAccess', _38 => _38.force]) || _bridgeActive)) {
     return;
   }
   window.postMessage(fullMsg, "*");
@@ -1488,7 +1511,7 @@ function sendToPanel(message, options) {
 var eventSource = makeEventSource();
 if (process.env.NODE_ENV !== "production" && typeof window !== "undefined") {
   window.addEventListener("message", (event) => {
-    if (event.source === window && _optionalChain([event, 'access', _38 => _38.data, 'optionalAccess', _39 => _39.source]) === "liveblocks-devtools-panel") {
+    if (event.source === window && _optionalChain([event, 'access', _39 => _39.data, 'optionalAccess', _40 => _40.source]) === "liveblocks-devtools-panel") {
       eventSource.notify(event.data);
     } else {
     }
@@ -1624,7 +1647,7 @@ function fullSync(room) {
     msg: "room::sync::full",
     roomId: room.id,
     status: room.getStatus(),
-    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _40 => _40.toTreeNode, 'call', _41 => _41("root"), 'access', _42 => _42.payload]), () => ( null)),
+    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _41 => _41.toTreeNode, 'call', _42 => _42("root"), 'access', _43 => _43.payload]), () => ( null)),
     me,
     others
   });
@@ -1718,7 +1741,7 @@ function getAuthBearerHeaderFromAuthValue(authValue) {
     return authValue.token.raw;
   }
 }
-function createCommentsApi(roomId, getAuthValue, { serverEndpoint }) {
+function createCommentsApi(roomId, getAuthValue, config) {
   async function fetchJson(endpoint, options) {
     const response = await fetchApi(roomId, endpoint, options);
     if (!response.ok) {
@@ -1745,13 +1768,14 @@ function createCommentsApi(roomId, getAuthValue, { serverEndpoint }) {
   }
   async function fetchApi(roomId2, endpoint, options) {
     const authValue = await getAuthValue();
-    const url = `${serverEndpoint}/c/rooms/${encodeURIComponent(
-      roomId2
-    )}${endpoint}`;
+    const url = new URL(
+      `/v2/c/rooms/${encodeURIComponent(roomId2)}${endpoint}`,
+      config.baseUrl
+    ).toString();
     return await fetch(url, {
       ...options,
       headers: {
-        ..._optionalChain([options, 'optionalAccess', _43 => _43.headers]),
+        ..._optionalChain([options, 'optionalAccess', _44 => _44.headers]),
         Authorization: `Bearer ${getAuthBearerHeaderFromAuthValue(authValue)}`
       }
     });
@@ -2264,7 +2288,7 @@ var LiveRegister = class _LiveRegister extends AbstractCrdt {
     return [
       {
         type: 8 /* CREATE_REGISTER */,
-        opId: _optionalChain([pool, 'optionalAccess', _44 => _44.generateOpId, 'call', _45 => _45()]),
+        opId: _optionalChain([pool, 'optionalAccess', _45 => _45.generateOpId, 'call', _46 => _46()]),
         id: this._id,
         parentId,
         parentKey,
@@ -2309,6 +2333,9 @@ var LiveRegister = class _LiveRegister extends AbstractCrdt {
   _toImmutable() {
     return this._data;
   }
+  clone() {
+    return deepClone(this.data);
+  }
 };
 
 // src/crdts/LiveList.ts
@@ -2363,7 +2390,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const ops = [];
     const op = {
       id: this._id,
-      opId: _optionalChain([pool, 'optionalAccess', _46 => _46.generateOpId, 'call', _47 => _47()]),
+      opId: _optionalChain([pool, 'optionalAccess', _47 => _47.generateOpId, 'call', _48 => _48()]),
       type: 2 /* CREATE_LIST */,
       parentId,
       parentKey
@@ -2640,7 +2667,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   _applyInsertUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _48 => _48._pool, 'optionalAccess', _49 => _49.getNode, 'call', _50 => _50(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _49 => _49._pool, 'optionalAccess', _50 => _50.getNode, 'call', _51 => _51(id)]) !== void 0) {
       return { modified: false };
     }
     child._attach(id, nn(this._pool));
@@ -2648,8 +2675,8 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const existingItemIndex = this._indexOfPosition(key);
     let newKey = key;
     if (existingItemIndex !== -1) {
-      const before2 = _optionalChain([this, 'access', _51 => _51._items, 'access', _52 => _52[existingItemIndex], 'optionalAccess', _53 => _53._parentPos]);
-      const after2 = _optionalChain([this, 'access', _54 => _54._items, 'access', _55 => _55[existingItemIndex + 1], 'optionalAccess', _56 => _56._parentPos]);
+      const before2 = _optionalChain([this, 'access', _52 => _52._items, 'access', _53 => _53[existingItemIndex], 'optionalAccess', _54 => _54._parentPos]);
+      const after2 = _optionalChain([this, 'access', _55 => _55._items, 'access', _56 => _56[existingItemIndex + 1], 'optionalAccess', _57 => _57._parentPos]);
       newKey = makePosition(before2, after2);
       child._setParentLink(this, newKey);
     }
@@ -2664,7 +2691,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   _applySetUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _57 => _57._pool, 'optionalAccess', _58 => _58.getNode, 'call', _59 => _59(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _58 => _58._pool, 'optionalAccess', _59 => _59.getNode, 'call', _60 => _60(id)]) !== void 0) {
       return { modified: false };
     }
     this._unacknowledgedSets.set(key, nn(op.opId));
@@ -2786,7 +2813,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     } else {
       this._items[existingItemIndex]._setParentLink(
         this,
-        makePosition(newKey, _optionalChain([this, 'access', _60 => _60._items, 'access', _61 => _61[existingItemIndex + 1], 'optionalAccess', _62 => _62._parentPos]))
+        makePosition(newKey, _optionalChain([this, 'access', _61 => _61._items, 'access', _62 => _62[existingItemIndex + 1], 'optionalAccess', _63 => _63._parentPos]))
       );
       const previousIndex = this._items.indexOf(child);
       child._setParentLink(this, newKey);
@@ -2812,7 +2839,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       if (existingItemIndex !== -1) {
         this._items[existingItemIndex]._setParentLink(
           this,
-          makePosition(newKey, _optionalChain([this, 'access', _63 => _63._items, 'access', _64 => _64[existingItemIndex + 1], 'optionalAccess', _65 => _65._parentPos]))
+          makePosition(newKey, _optionalChain([this, 'access', _64 => _64._items, 'access', _65 => _65[existingItemIndex + 1], 'optionalAccess', _66 => _66._parentPos]))
         );
       }
       child._setParentLink(this, newKey);
@@ -2831,7 +2858,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       if (existingItemIndex !== -1) {
         this._items[existingItemIndex]._setParentLink(
           this,
-          makePosition(newKey, _optionalChain([this, 'access', _66 => _66._items, 'access', _67 => _67[existingItemIndex + 1], 'optionalAccess', _68 => _68._parentPos]))
+          makePosition(newKey, _optionalChain([this, 'access', _67 => _67._items, 'access', _68 => _68[existingItemIndex + 1], 'optionalAccess', _69 => _69._parentPos]))
         );
       }
       child._setParentLink(this, newKey);
@@ -2859,7 +2886,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     if (existingItemIndex !== -1) {
       this._items[existingItemIndex]._setParentLink(
         this,
-        makePosition(newKey, _optionalChain([this, 'access', _69 => _69._items, 'access', _70 => _70[existingItemIndex + 1], 'optionalAccess', _71 => _71._parentPos]))
+        makePosition(newKey, _optionalChain([this, 'access', _70 => _70._items, 'access', _71 => _71[existingItemIndex + 1], 'optionalAccess', _72 => _72._parentPos]))
       );
     }
     child._setParentLink(this, newKey);
@@ -2917,7 +2944,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param element The element to add to the end of the LiveList.
    */
   push(element) {
-    _optionalChain([this, 'access', _72 => _72._pool, 'optionalAccess', _73 => _73.assertStorageIsWritable, 'call', _74 => _74()]);
+    _optionalChain([this, 'access', _73 => _73._pool, 'optionalAccess', _74 => _74.assertStorageIsWritable, 'call', _75 => _75()]);
     return this.insert(element, this.length);
   }
   /**
@@ -2926,7 +2953,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index at which you want to insert the element.
    */
   insert(element, index) {
-    _optionalChain([this, 'access', _75 => _75._pool, 'optionalAccess', _76 => _76.assertStorageIsWritable, 'call', _77 => _77()]);
+    _optionalChain([this, 'access', _76 => _76._pool, 'optionalAccess', _77 => _77.assertStorageIsWritable, 'call', _78 => _78()]);
     if (index < 0 || index > this._items.length) {
       throw new Error(
         `Cannot insert list item at index "${index}". index should be between 0 and ${this._items.length}`
@@ -2956,7 +2983,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param targetIndex The index where the element should be after moving.
    */
   move(index, targetIndex) {
-    _optionalChain([this, 'access', _78 => _78._pool, 'optionalAccess', _79 => _79.assertStorageIsWritable, 'call', _80 => _80()]);
+    _optionalChain([this, 'access', _79 => _79._pool, 'optionalAccess', _80 => _80.assertStorageIsWritable, 'call', _81 => _81()]);
     if (targetIndex < 0) {
       throw new Error("targetIndex cannot be less than 0");
     }
@@ -3014,7 +3041,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index of the element to delete
    */
   delete(index) {
-    _optionalChain([this, 'access', _81 => _81._pool, 'optionalAccess', _82 => _82.assertStorageIsWritable, 'call', _83 => _83()]);
+    _optionalChain([this, 'access', _82 => _82._pool, 'optionalAccess', _83 => _83.assertStorageIsWritable, 'call', _84 => _84()]);
     if (index < 0 || index >= this._items.length) {
       throw new Error(
         `Cannot delete list item at index "${index}". index should be between 0 and ${this._items.length - 1}`
@@ -3047,7 +3074,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   clear() {
-    _optionalChain([this, 'access', _84 => _84._pool, 'optionalAccess', _85 => _85.assertStorageIsWritable, 'call', _86 => _86()]);
+    _optionalChain([this, 'access', _85 => _85._pool, 'optionalAccess', _86 => _86.assertStorageIsWritable, 'call', _87 => _87()]);
     if (this._pool) {
       const ops = [];
       const reverseOps = [];
@@ -3081,7 +3108,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   set(index, item) {
-    _optionalChain([this, 'access', _87 => _87._pool, 'optionalAccess', _88 => _88.assertStorageIsWritable, 'call', _89 => _89()]);
+    _optionalChain([this, 'access', _88 => _88._pool, 'optionalAccess', _89 => _89.assertStorageIsWritable, 'call', _90 => _90()]);
     if (index < 0 || index >= this._items.length) {
       throw new Error(
         `Cannot set list item at index "${index}". index should be between 0 and ${this._items.length - 1}`
@@ -3229,7 +3256,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   _shiftItemPosition(index, key) {
     const shiftedPosition = makePosition(
       key,
-      this._items.length > index + 1 ? _optionalChain([this, 'access', _90 => _90._items, 'access', _91 => _91[index + 1], 'optionalAccess', _92 => _92._parentPos]) : void 0
+      this._items.length > index + 1 ? _optionalChain([this, 'access', _91 => _91._items, 'access', _92 => _92[index + 1], 'optionalAccess', _93 => _93._parentPos]) : void 0
     );
     this._items[index]._setParentLink(this, shiftedPosition);
   }
@@ -3252,6 +3279,9 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const result = this._items.map((node) => node.toImmutable());
     return process.env.NODE_ENV === "production" ? result : Object.freeze(result);
   }
+  clone() {
+    return new _LiveList(this._items.map((item) => item.clone()));
+  }
 };
 var LiveListIterator = class {
   constructor(items) {
@@ -3335,10 +3365,10 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
     this.unacknowledgedSet = /* @__PURE__ */ new Map();
     if (entries2) {
       const mappedEntries = [];
-      for (const entry of entries2) {
-        const value = lsonToLiveNode(entry[1]);
-        value._setParentLink(this, entry[0]);
-        mappedEntries.push([entry[0], value]);
+      for (const [key, value] of entries2) {
+        const node = lsonToLiveNode(value);
+        node._setParentLink(this, key);
+        mappedEntries.push([key, node]);
       }
       this._map = new Map(mappedEntries);
     } else {
@@ -3355,7 +3385,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
     const ops = [];
     const op = {
       id: this._id,
-      opId: _optionalChain([pool, 'optionalAccess', _93 => _93.generateOpId, 'call', _94 => _94()]),
+      opId: _optionalChain([pool, 'optionalAccess', _94 => _94.generateOpId, 'call', _95 => _95()]),
       type: 7 /* CREATE_MAP */,
       parentId,
       parentKey
@@ -3502,7 +3532,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
    * @param value The value of the element to add. Should be serializable to JSON.
    */
   set(key, value) {
-    _optionalChain([this, 'access', _95 => _95._pool, 'optionalAccess', _96 => _96.assertStorageIsWritable, 'call', _97 => _97()]);
+    _optionalChain([this, 'access', _96 => _96._pool, 'optionalAccess', _97 => _97.assertStorageIsWritable, 'call', _98 => _98()]);
     const oldValue = this._map.get(key);
     if (oldValue) {
       oldValue._detach();
@@ -3548,7 +3578,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
    * @returns true if an element existed and has been removed, or false if the element does not exist.
    */
   delete(key) {
-    _optionalChain([this, 'access', _98 => _98._pool, 'optionalAccess', _99 => _99.assertStorageIsWritable, 'call', _100 => _100()]);
+    _optionalChain([this, 'access', _99 => _99._pool, 'optionalAccess', _100 => _100.assertStorageIsWritable, 'call', _101 => _101()]);
     const item = this._map.get(key);
     if (item === void 0) {
       return false;
@@ -3669,6 +3699,11 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
     }
     return freeze(result);
   }
+  clone() {
+    return new _LiveMap(
+      Array.from(this._map).map(([key, node]) => [key, node.clone()])
+    );
+  }
 };
 
 // src/crdts/LiveObject.ts
@@ -3722,7 +3757,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     if (this._id === void 0) {
       throw new Error("Cannot serialize item is not attached");
     }
-    const opId = _optionalChain([pool, 'optionalAccess', _101 => _101.generateOpId, 'call', _102 => _102()]);
+    const opId = _optionalChain([pool, 'optionalAccess', _102 => _102.generateOpId, 'call', _103 => _103()]);
     const ops = [];
     const op = parentId !== void 0 && parentKey !== void 0 ? {
       type: 4 /* CREATE_OBJECT */,
@@ -4003,7 +4038,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
    * @param value The value of the property to add
    */
   set(key, value) {
-    _optionalChain([this, 'access', _103 => _103._pool, 'optionalAccess', _104 => _104.assertStorageIsWritable, 'call', _105 => _105()]);
+    _optionalChain([this, 'access', _104 => _104._pool, 'optionalAccess', _105 => _105.assertStorageIsWritable, 'call', _106 => _106()]);
     this.update({ [key]: value });
   }
   /**
@@ -4018,7 +4053,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
    * @param key The key of the property to delete
    */
   delete(key) {
-    _optionalChain([this, 'access', _106 => _106._pool, 'optionalAccess', _107 => _107.assertStorageIsWritable, 'call', _108 => _108()]);
+    _optionalChain([this, 'access', _107 => _107._pool, 'optionalAccess', _108 => _108.assertStorageIsWritable, 'call', _109 => _109()]);
     const keyAsString = key;
     const oldValue = this._map.get(keyAsString);
     if (oldValue === void 0) {
@@ -4071,7 +4106,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
    * @param patch The object used to overrides properties
    */
   update(patch) {
-    _optionalChain([this, 'access', _109 => _109._pool, 'optionalAccess', _110 => _110.assertStorageIsWritable, 'call', _111 => _111()]);
+    _optionalChain([this, 'access', _110 => _110._pool, 'optionalAccess', _111 => _111.assertStorageIsWritable, 'call', _112 => _112()]);
     if (this._pool === void 0 || this._id === void 0) {
       for (const key in patch) {
         const newValue = patch[key];
@@ -4179,6 +4214,16 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     }
     return process.env.NODE_ENV === "production" ? result : Object.freeze(result);
   }
+  clone() {
+    return new _LiveObject(
+      Object.fromEntries(
+        Array.from(this._map).map(([key, value]) => [
+          key,
+          isLiveStructure(value) ? value.clone() : deepClone(value)
+        ])
+      )
+    );
+  }
 };
 
 // src/crdts/liveblocks-helpers.ts
@@ -4264,6 +4309,9 @@ function isLiveObject(value) {
 function isLiveRegister(value) {
   return value instanceof LiveRegister;
 }
+function cloneLson(value) {
+  return value === void 0 ? void 0 : isLiveStructure(value) ? value.clone() : deepClone(value);
+}
 function liveNodeToLson(obj) {
   if (obj instanceof LiveRegister) {
     return obj.data;
@@ -4698,10 +4746,40 @@ function userToTreeNode(key, user) {
     payload: user
   };
 }
+function installBackgroundTabSpy() {
+  const doc = typeof document !== "undefined" ? document : void 0;
+  const inBackgroundSince = { current: null };
+  function onVisibilityChange() {
+    if (_optionalChain([doc, 'optionalAccess', _113 => _113.visibilityState]) === "hidden") {
+      inBackgroundSince.current = _nullishCoalesce(inBackgroundSince.current, () => ( Date.now()));
+    } else {
+      inBackgroundSince.current = null;
+    }
+  }
+  _optionalChain([doc, 'optionalAccess', _114 => _114.addEventListener, 'call', _115 => _115("visibilitychange", onVisibilityChange)]);
+  const unsub = () => {
+    _optionalChain([doc, 'optionalAccess', _116 => _116.removeEventListener, 'call', _117 => _117("visibilitychange", onVisibilityChange)]);
+  };
+  return [inBackgroundSince, unsub];
+}
 function createRoom(options, config) {
   const initialPresence = typeof options.initialPresence === "function" ? options.initialPresence(config.roomId) : options.initialPresence;
   const initialStorage = typeof options.initialStorage === "function" ? options.initialStorage(config.roomId) : options.initialStorage;
-  const delegates = config.delegates;
+  const [inBackgroundSince, uninstallBgTabSpy] = installBackgroundTabSpy();
+  const delegates = {
+    ...config.delegates,
+    // A connection is allowed to go into "zombie state" only if all of the
+    // following conditions apply:
+    //
+    // - The `backgroundKeepAliveTimeout` client option is configured
+    // - The browser window has been in the background for at least
+    //   `backgroundKeepAliveTimeout` milliseconds
+    // - There are no pending changes
+    //
+    canZombie() {
+      return config.backgroundKeepAliveTimeout !== void 0 && inBackgroundSince.current !== null && Date.now() > inBackgroundSince.current + config.backgroundKeepAliveTimeout && getStorageStatus() !== "synchronizing";
+    }
+  };
   const managedSocket = new ManagedSocket(
     delegates,
     config.enableDebugLogging
@@ -4764,7 +4842,6 @@ function createRoom(options, config) {
     }
     batchUpdates(() => {
       eventHub.status.notify(newStatus);
-      eventHub.connection.notify(newToLegacyStatus(newStatus));
       notifySelfChanged(doNotBatchUpdates);
     });
   }
@@ -4870,7 +4947,7 @@ function createRoom(options, config) {
       }
     },
     assertStorageIsWritable: () => {
-      const scopes = _optionalChain([context, 'access', _112 => _112.dynamicSessionInfo, 'access', _113 => _113.current, 'optionalAccess', _114 => _114.scopes]);
+      const scopes = _optionalChain([context, 'access', _118 => _118.dynamicSessionInfo, 'access', _119 => _119.current, 'optionalAccess', _120 => _120.scopes]);
       if (scopes === void 0) {
         return;
       }
@@ -4901,15 +4978,13 @@ function createRoom(options, config) {
     comments: makeEventSource()
   };
   async function httpSend(authTokenOrPublicApiKey, roomId, nonce, messages) {
-    const baseUrl = new URL(config.liveblocksServer);
-    baseUrl.protocol = "https";
     const url = new URL(
       `/v2/c/rooms/${encodeURIComponent(roomId)}/send-message`,
-      baseUrl
-    );
-    const fetcher = _optionalChain([config, 'access', _115 => _115.polyfills, 'optionalAccess', _116 => _116.fetch]) || /* istanbul ignore next */
+      config.baseUrl
+    ).toString();
+    const fetcher = _optionalChain([config, 'access', _121 => _121.polyfills, 'optionalAccess', _122 => _122.fetch]) || /* istanbul ignore next */
     fetch;
-    return fetcher(url.toString(), {
+    return fetcher(url, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
@@ -4920,7 +4995,7 @@ function createRoom(options, config) {
   }
   function sendMessages(messages) {
     const serializedPayload = JSON.stringify(messages);
-    const nonce = _optionalChain([context, 'access', _117 => _117.dynamicSessionInfo, 'access', _118 => _118.current, 'optionalAccess', _119 => _119.nonce]);
+    const nonce = _optionalChain([context, 'access', _123 => _123.dynamicSessionInfo, 'access', _124 => _124.current, 'optionalAccess', _125 => _125.nonce]);
     if (config.unstable_fallbackToHTTP && managedSocket.authValue && nonce) {
       const size = new TextEncoder().encode(serializedPayload).length;
       if (size > MAX_SOCKET_MESSAGE_SIZE) {
@@ -4990,7 +5065,7 @@ function createRoom(options, config) {
     const stackSizeBefore = context.undoStack.length;
     for (const key in context.initialStorage) {
       if (context.root.get(key) === void 0) {
-        context.root.set(key, context.initialStorage[key]);
+        context.root.set(key, cloneLson(context.initialStorage[key]));
       }
     }
     context.undoStack.length = stackSizeBefore;
@@ -5021,25 +5096,23 @@ function createRoom(options, config) {
       _addToRealUndoStack(historyOps, batchedUpdatesWrapper);
     }
   }
-  function notify({
-    storageUpdates = /* @__PURE__ */ new Map(),
-    presence = false,
-    others: otherEvents = []
-  }, batchedUpdatesWrapper) {
+  function notify(updates, batchedUpdatesWrapper) {
+    const storageUpdates = updates.storageUpdates;
+    const othersUpdates = updates.others;
     batchedUpdatesWrapper(() => {
-      if (otherEvents.length > 0) {
+      if (othersUpdates !== void 0 && othersUpdates.length > 0) {
         const others = context.others.current;
-        for (const event of otherEvents) {
-          eventHub.others.notify({ others, event });
+        for (const event of othersUpdates) {
+          eventHub.others.notify({ ...event, others });
         }
       }
-      if (presence) {
+      if (_nullishCoalesce(updates.presence, () => ( false))) {
         notifySelfChanged(doNotBatchUpdates);
         eventHub.myPresence.notify(context.myPresence.current);
       }
-      if (storageUpdates.size > 0) {
-        const updates = Array.from(storageUpdates.values());
-        eventHub.storage.notify(updates);
+      if (storageUpdates !== void 0 && storageUpdates.size > 0) {
+        const updates2 = Array.from(storageUpdates.values());
+        eventHub.storage.notify(updates2);
       }
       notifyStorageStatus();
     });
@@ -5187,7 +5260,7 @@ function createRoom(options, config) {
     }
     context.myPresence.patch(patch);
     if (context.activeBatch) {
-      if (_optionalChain([options2, 'optionalAccess', _120 => _120.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _126 => _126.addToHistory])) {
         context.activeBatch.reverseOps.unshift({
           type: "presence",
           data: oldValues
@@ -5197,7 +5270,7 @@ function createRoom(options, config) {
     } else {
       flushNowOrSoon();
       batchUpdates(() => {
-        if (_optionalChain([options2, 'optionalAccess', _121 => _121.addToHistory])) {
+        if (_optionalChain([options2, 'optionalAccess', _127 => _127.addToHistory])) {
           addToUndoStack(
             [{ type: "presence", data: oldValues }],
             doNotBatchUpdates
@@ -5377,7 +5450,7 @@ function createRoom(options, config) {
             const unacknowledgedOps = new Map(context.unacknowledgedOps);
             createOrUpdateRootFromMessage(message, doNotBatchUpdates);
             applyAndSendOps(unacknowledgedOps, doNotBatchUpdates);
-            _optionalChain([_resolveStoragePromise, 'optionalCall', _122 => _122()]);
+            _optionalChain([_resolveStoragePromise, 'optionalCall', _128 => _128()]);
             notifyStorageStatus();
             eventHub.storageDidLoad.notify();
             break;
@@ -5400,7 +5473,7 @@ function createRoom(options, config) {
             if (process.env.NODE_ENV !== "production") {
               const traces = /* @__PURE__ */ new Set();
               for (const opId of message.opIds) {
-                const trace = _optionalChain([context, 'access', _123 => _123.opStackTraces, 'optionalAccess', _124 => _124.get, 'call', _125 => _125(opId)]);
+                const trace = _optionalChain([context, 'access', _129 => _129.opStackTraces, 'optionalAccess', _130 => _130.get, 'call', _131 => _131(opId)]);
                 if (trace) {
                   traces.add(trace);
                 }
@@ -5497,10 +5570,11 @@ ${Array.from(traces).join("\n\n")}`
     }
     return messages;
   }
-  function updateYDoc(update) {
+  function updateYDoc(update, guid) {
     const clientMsg = {
       type: 301 /* UPDATE_YDOC */,
-      update
+      update,
+      guid
     };
     context.buffer.messages.push(clientMsg);
     eventHub.ydoc.notify(clientMsg);
@@ -5563,13 +5637,14 @@ ${Array.from(traces).join("\n\n")}`
       root: nn(context.root)
     };
   }
-  function fetchYDoc(vector) {
+  function fetchYDoc(vector, guid) {
     if (!context.buffer.messages.find((m) => {
-      return m.type === 300 /* FETCH_YDOC */ && m.vector === vector;
+      return m.type === 300 /* FETCH_YDOC */ && m.vector === vector && m.guid === guid;
     })) {
       context.buffer.messages.push({
         type: 300 /* FETCH_YDOC */,
-        vector
+        vector,
+        guid
       });
     }
     flushNowOrSoon();
@@ -5687,10 +5762,7 @@ ${Array.from(traces).join("\n\n")}`
     (others) => others.map((other, index) => userToTreeNode(`Other ${index}`, other))
   );
   const events = {
-    connection: eventHub.connection.observable,
-    // Old/deprecated API
     status: eventHub.status.observable,
-    // New/recommended API
     lostConnection: eventHub.lostConnection.observable,
     customEvent: eventHub.customEvent.observable,
     others: eventHub.others.observable,
@@ -5705,14 +5777,14 @@ ${Array.from(traces).join("\n\n")}`
     comments: eventHub.comments.observable
   };
   const commentsApi = createCommentsApi(config.roomId, delegates.authenticate, {
-    serverEndpoint: "https://api.liveblocks.io/v2"
+    baseUrl: config.baseUrl
   });
   return Object.defineProperty(
     {
       /* NOTE: Exposing __internal here only to allow testing implementation details in unit tests */
       __internal: {
         get presenceBuffer() {
-          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _126 => _126.buffer, 'access', _127 => _127.presenceUpdates, 'optionalAccess', _128 => _128.data]), () => ( null)));
+          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _132 => _132.buffer, 'access', _133 => _133.presenceUpdates, 'optionalAccess', _134 => _134.data]), () => ( null)));
         },
         // prettier-ignore
         get undoStack() {
@@ -5738,7 +5810,10 @@ ${Array.from(traces).join("\n\n")}`
       connect: () => managedSocket.connect(),
       reconnect: () => managedSocket.reconnect(),
       disconnect: () => managedSocket.disconnect(),
-      destroy: () => managedSocket.destroy(),
+      destroy: () => {
+        uninstallBgTabSpy();
+        managedSocket.destroy();
+      },
       // Presence
       updatePresence,
       updateYDoc,
@@ -5809,16 +5884,19 @@ function makeClassicSubscribeFn(events) {
           return events.myPresence.subscribe(callback);
         case "others": {
           const cb = callback;
-          return events.others.subscribe(
-            ({ others, event }) => cb(others, event)
-          );
+          return events.others.subscribe((event) => {
+            const { others, ...internalEvent } = event;
+            return cb(others, internalEvent);
+          });
         }
         case "error":
           return events.error.subscribe(callback);
-        case "connection":
-          return events.connection.subscribe(
-            callback
+        case "connection": {
+          const cb = callback;
+          return events.status.subscribe(
+            (status) => cb(newToLegacyStatus(status))
           );
+        }
         case "status":
           return events.status.subscribe(callback);
         case "lost-connection":
@@ -5848,7 +5926,7 @@ function makeClassicSubscribeFn(events) {
     }
     if (isLiveNode(first)) {
       const node = first;
-      if (_optionalChain([options, 'optionalAccess', _129 => _129.isDeep])) {
+      if (_optionalChain([options, 'optionalAccess', _135 => _135.isDeep])) {
         const storageCallback = second;
         return subscribeToLiveStructureDeeply(node, storageCallback);
       } else {
@@ -5870,15 +5948,17 @@ function makeAuthDelegateForRoom(roomId, authManager) {
     return authManager.getAuthValue("room:read", roomId);
   };
 }
-function makeCreateSocketDelegateForRoom(roomId, liveblocksServer, WebSocketPolyfill) {
+function makeCreateSocketDelegateForRoom(roomId, baseUrl, WebSocketPolyfill) {
   return (authValue) => {
     const ws = _nullishCoalesce(WebSocketPolyfill, () => ( (typeof WebSocket === "undefined" ? void 0 : WebSocket)));
     if (ws === void 0) {
       throw new StopRetrying(
-        "To use Liveblocks client in a non-dom environment, you need to provide a WebSocket polyfill."
+        "To use Liveblocks client in a non-DOM environment, you need to provide a WebSocket polyfill."
       );
     }
-    const url = new URL(liveblocksServer);
+    const url = new URL(baseUrl);
+    url.protocol = url.protocol === "http:" ? "ws" : "wss";
+    url.pathname = "/v7";
     url.searchParams.set("roomId", roomId);
     if (authValue.type === "secret") {
       url.searchParams.set("tok", authValue.token.raw);
@@ -5896,13 +5976,20 @@ function makeCreateSocketDelegateForRoom(roomId, liveblocksServer, WebSocketPoly
 var MIN_THROTTLE = 16;
 var MAX_THROTTLE = 1e3;
 var DEFAULT_THROTTLE = 100;
+var MIN_BACKGROUND_KEEP_ALIVE_TIMEOUT = 6e4;
 var MIN_LOST_CONNECTION_TIMEOUT = 200;
 var RECOMMENDED_MIN_LOST_CONNECTION_TIMEOUT = 1e3;
 var MAX_LOST_CONNECTION_TIMEOUT = 3e4;
 var DEFAULT_LOST_CONNECTION_TIMEOUT = 5e3;
-function getServerFromClientOptions(clientOptions) {
-  const rawOptions = clientOptions;
-  return typeof rawOptions.liveblocksServer === "string" ? rawOptions.liveblocksServer : "wss://api.liveblocks.io/v7";
+function getBaseUrlFromClientOptions(clientOptions) {
+  if ("liveblocksServer" in clientOptions) {
+    throw new Error("Client option no longer supported");
+  }
+  if (typeof clientOptions.baseUrl === "string" && clientOptions.baseUrl.startsWith("http")) {
+    return clientOptions.baseUrl;
+  } else {
+    return DEFAULT_BASE_URL;
+  }
 }
 function createClient(options) {
   const clientOptions = options;
@@ -5910,21 +5997,45 @@ function createClient(options) {
   const lostConnectionTimeout = getLostConnectionTimeout(
     _nullishCoalesce(clientOptions.lostConnectionTimeout, () => ( DEFAULT_LOST_CONNECTION_TIMEOUT))
   );
+  const backgroundKeepAliveTimeout = getBackgroundKeepAliveTimeout(
+    clientOptions.backgroundKeepAliveTimeout
+  );
   const authManager = createAuthManager(options);
-  const rooms = /* @__PURE__ */ new Map();
-  function getRoom(roomId) {
-    const room = rooms.get(roomId);
-    return room ? room : null;
+  const roomsById = /* @__PURE__ */ new Map();
+  function teardownRoom(room) {
+    unlinkDevTools(room.id);
+    roomsById.delete(room.id);
+    room.destroy();
+  }
+  function leaseRoom(info) {
+    const leave = () => {
+      const self = leave;
+      if (!info.unsubs.delete(self)) {
+        warn(
+          "This leave function was already called. Calling it more than once has no effect."
+        );
+      } else {
+        if (info.unsubs.size === 0) {
+          teardownRoom(info.room);
+        }
+      }
+    };
+    info.unsubs.add(leave);
+    return {
+      room: info.room,
+      leave
+    };
   }
-  function enter(roomId, options2) {
-    const existingRoom = rooms.get(roomId);
-    if (existingRoom !== void 0) {
-      return existingRoom;
+  function enterRoom(roomId, options2) {
+    const existing = roomsById.get(roomId);
+    if (existing !== void 0) {
+      return leaseRoom(existing);
     }
     deprecateIf(
       options2.initialPresence === null || options2.initialPresence === void 0,
       "Please provide an initial presence value for the current user when entering the room."
     );
+    const baseUrl = getBaseUrlFromClientOptions(clientOptions);
     const newRoom = createRoom(
       {
         initialPresence: _nullishCoalesce(options2.initialPresence, () => ( {})),
@@ -5934,28 +6045,33 @@ function createClient(options) {
         roomId,
         throttleDelay,
         lostConnectionTimeout,
+        backgroundKeepAliveTimeout,
         polyfills: clientOptions.polyfills,
         delegates: _nullishCoalesce(clientOptions.mockedDelegates, () => ( {
           createSocket: makeCreateSocketDelegateForRoom(
             roomId,
-            getServerFromClientOptions(clientOptions),
-            _optionalChain([clientOptions, 'access', _130 => _130.polyfills, 'optionalAccess', _131 => _131.WebSocket])
+            baseUrl,
+            _optionalChain([clientOptions, 'access', _136 => _136.polyfills, 'optionalAccess', _137 => _137.WebSocket])
           ),
           authenticate: makeAuthDelegateForRoom(roomId, authManager)
         })),
         enableDebugLogging: clientOptions.enableDebugLogging,
-        unstable_batchedUpdates: _optionalChain([options2, 'optionalAccess', _132 => _132.unstable_batchedUpdates]),
-        liveblocksServer: getServerFromClientOptions(clientOptions),
+        unstable_batchedUpdates: _optionalChain([options2, 'optionalAccess', _138 => _138.unstable_batchedUpdates]),
+        baseUrl,
         unstable_fallbackToHTTP: !!clientOptions.unstable_fallbackToHTTP
       }
     );
-    rooms.set(roomId, newRoom);
-    setupDevTools(() => Array.from(rooms.keys()));
+    const newRoomInfo = {
+      room: newRoom,
+      unsubs: /* @__PURE__ */ new Set()
+    };
+    roomsById.set(roomId, newRoomInfo);
+    setupDevTools(() => Array.from(roomsById.keys()));
     linkDevTools(roomId, newRoom);
-    const shouldConnect = _nullishCoalesce(options2.shouldInitiallyConnect, () => ( true));
+    const shouldConnect = _nullishCoalesce(_nullishCoalesce(options2.autoConnect, () => ( options2.shouldInitiallyConnect)), () => ( true));
     if (shouldConnect) {
       if (typeof atob === "undefined") {
-        if (_optionalChain([clientOptions, 'access', _133 => _133.polyfills, 'optionalAccess', _134 => _134.atob]) === void 0) {
+        if (_optionalChain([clientOptions, 'access', _139 => _139.polyfills, 'optionalAccess', _140 => _140.atob]) === void 0) {
           throw new Error(
             "You need to polyfill atob to use the client in your environment. Please follow the instructions at https://liveblocks.io/docs/errors/liveblocks-client/atob-polyfill"
           );
@@ -5964,30 +6080,63 @@ function createClient(options) {
       }
       newRoom.connect();
     }
-    return newRoom;
+    return leaseRoom(newRoomInfo);
   }
-  function leave(roomId) {
-    unlinkDevTools(roomId);
-    const room = rooms.get(roomId);
-    if (room !== void 0) {
-      room.destroy();
-      rooms.delete(roomId);
+  function enter(roomId, options2) {
+    const { room, leave: _ } = enterRoom(roomId, options2);
+    return room;
+  }
+  function getRoom(roomId) {
+    const room = _optionalChain([roomsById, 'access', _141 => _141.get, 'call', _142 => _142(roomId), 'optionalAccess', _143 => _143.room]);
+    return room ? room : null;
+  }
+  function forceLeave(roomId) {
+    const unsubs = _nullishCoalesce(_optionalChain([roomsById, 'access', _144 => _144.get, 'call', _145 => _145(roomId), 'optionalAccess', _146 => _146.unsubs]), () => ( /* @__PURE__ */ new Set()));
+    for (const unsub of unsubs) {
+      unsub();
+    }
+  }
+  function logout() {
+    authManager.reset();
+    for (const { room } of roomsById.values()) {
+      if (!isIdle(room.getStatus())) {
+        room.reconnect();
+      }
     }
   }
   return {
-    getRoom,
+    logout,
+    // Old, deprecated APIs
     enter,
-    leave
+    getRoom,
+    leave: forceLeave,
+    // New, preferred API
+    enterRoom
   };
 }
 function checkBounds(option, value, min, max, recommendedMin) {
-  if (typeof value !== "number" || value < min || value > max) {
+  if (typeof value !== "number" || value < min || max === void 0 || value > max) {
     throw new Error(
-      `${option} should be a number between ${_nullishCoalesce(recommendedMin, () => ( min))} and ${max}.`
+      max !== void 0 ? `${option} should be between ${_nullishCoalesce(recommendedMin, () => ( min))} and ${max}.` : `${option} should be at least ${_nullishCoalesce(recommendedMin, () => ( min))}.`
     );
   }
   return value;
 }
+function getBackgroundKeepAliveTimeout(value) {
+  if (value === void 0)
+    return void 0;
+  if (typeof document === "undefined") {
+    warn(
+      "Setting backgroundKeepAliveTimeout won't have an effect in a non-DOM environment."
+    );
+    return void 0;
+  }
+  return checkBounds(
+    "backgroundKeepAliveTimeout",
+    value,
+    MIN_BACKGROUND_KEEP_ALIVE_TIMEOUT
+  );
+}
 function getThrottle(value) {
   return checkBounds("throttle", value, MIN_THROTTLE, MAX_THROTTLE);
 }
@@ -6230,12 +6379,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _135 => _135.updates, 'access', _136 => _136[key], 'optionalAccess', _137 => _137.type]) === "update") {
+          if (_optionalChain([update, 'access', _147 => _147.updates, 'access', _148 => _148[key], 'optionalAccess', _149 => _149.type]) === "update") {
             const val = update.node.get(key);
             if (val !== void 0) {
               newState[key] = lsonToJson(val);
             }
-          } else if (_optionalChain([update, 'access', _138 => _138.updates, 'access', _139 => _139[key], 'optionalAccess', _140 => _140.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _150 => _150.updates, 'access', _151 => _151[key], 'optionalAccess', _152 => _152.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -6296,12 +6445,12 @@ function legacy_patchImmutableNode(state, path, update) {
         }
         const newState = Object.assign({}, state);
         for (const key in update.updates) {
-          if (_optionalChain([update, 'access', _141 => _141.updates, 'access', _142 => _142[key], 'optionalAccess', _143 => _143.type]) === "update") {
+          if (_optionalChain([update, 'access', _153 => _153.updates, 'access', _154 => _154[key], 'optionalAccess', _155 => _155.type]) === "update") {
             const value = update.node.get(key);
             if (value !== void 0) {
               newState[key] = lsonToJson(value);
             }
-          } else if (_optionalChain([update, 'access', _144 => _144.updates, 'access', _145 => _145[key], 'optionalAccess', _146 => _146.type]) === "delete") {
+          } else if (_optionalChain([update, 'access', _156 => _156.updates, 'access', _157 => _157[key], 'optionalAccess', _158 => _158.type]) === "delete") {
             delete newState[key];
           }
         }
@@ -6391,7 +6540,7 @@ function createCacheItem(key, asyncFunction, options) {
   let previousState = { isLoading: false };
   const eventSource2 = makeEventSource();
   function notify() {
-    const isEqual = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _147 => _147.isStateEqual]), () => ( isShallowEqual));
+    const isEqual = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _159 => _159.isStateEqual]), () => ( isShallowEqual));
     if (!isEqual(previousState, state)) {
       previousState = state;
       eventSource2.notify(state);
@@ -6459,7 +6608,7 @@ function createAsyncCache(asyncFunction, options) {
     return create(key).get();
   }
   function getState(key) {
-    return _optionalChain([cache, 'access', _148 => _148.get, 'call', _149 => _149(key), 'optionalAccess', _150 => _150.getState, 'call', _151 => _151()]);
+    return _optionalChain([cache, 'access', _160 => _160.get, 'call', _161 => _161(key), 'optionalAccess', _162 => _162.getState, 'call', _163 => _163()]);
   }
   function revalidate(key) {
     return create(key).revalidate();
@@ -6636,5 +6785,6 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.OpCode = OpCode; exports.ServerMsgCode = ServerMsgCode; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.b64decode = b64decode; exports.console = fancy_console_exports; exports.createAsyncCache = createAsyncCache; exports.createClient = createClient; exports.createCommentsApi = createCommentsApi; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.errorIf = errorIf; exports.freeze = freeze; exports.isChildCrdt = isChildCrdt; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.nn = nn; exports.patchLiveObjectKey = patchLiveObjectKey; exports.shallow = shallow; exports.stringify = stringify; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.withTimeout = withTimeout;
+
+exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.OpCode = OpCode; exports.ServerMsgCode = ServerMsgCode; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.b64decode = b64decode; exports.cloneLson = cloneLson; exports.console = fancy_console_exports; exports.createAsyncCache = createAsyncCache; exports.createClient = createClient; exports.createCommentsApi = createCommentsApi; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.errorIf = errorIf; exports.freeze = freeze; exports.isChildCrdt = isChildCrdt; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.nn = nn; exports.patchLiveObjectKey = patchLiveObjectKey; exports.shallow = shallow; exports.stringify = stringify; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.js.map