@liveblocks/core 3.16.0 → 3.17.0

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.16.0";
+var PKG_VERSION = "3.17.0";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -6319,7 +6319,6 @@ var AbstractCrdt = class {
   }
   /**
    * @internal
-   *
    * Return an snapshot of this Live tree for use in DevTools.
    */
   toTreeNode(key) {
@@ -6329,6 +6328,14 @@ var AbstractCrdt = class {
     }
     return this.#cachedTreeNode;
   }
+  /**
+   * @private
+   * Returns true if the cached immutable snapshot exists and is
+   * reference-equal to the given value. Does not trigger a recompute.
+   */
+  immutableIs(value) {
+    return this.#cachedImmutable !== void 0 && this.#cachedImmutable === value;
+  }
   /**
    * Return an immutable snapshot of this Live node and its children.
    */
@@ -6728,7 +6735,10 @@ var LiveList = class _LiveList extends AbstractCrdt {
         };
       } else {
         if (indexOfItemWithSamePosition !== -1) {
-          nn(this.#items.removeAt(indexOfItemWithSamePosition));
+          const displaced = nn(
+            this.#items.removeAt(indexOfItemWithSamePosition)
+          );
+          this.#implicitlyDeletedItems.add(displaced);
         }
         const { newItem, newIndex } = this.#createAttachItemAndSort(
           op,
@@ -7876,10 +7886,115 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
   }
 };
 
+// src/crdts/reconcile.ts
+function deepLiveify(value, config) {
+  if (Array.isArray(value)) {
+    return new LiveList(value.map((v) => deepLiveify(v, config)));
+  } else if (isPlainObject(value)) {
+    const init = {};
+    const locals = {};
+    for (const key in value) {
+      const val = value[key];
+      if (val === void 0) {
+        continue;
+      }
+      const subConfig = isPlainObject(config) ? config[key] : config;
+      if (subConfig === false) {
+        locals[key] = val;
+      } else if (subConfig === "atomic") {
+        init[key] = val;
+      } else {
+        init[key] = deepLiveify(val, subConfig);
+      }
+    }
+    const lo = new LiveObject(init);
+    for (const key in locals) {
+      lo.setLocal(key, locals[key]);
+    }
+    return lo;
+  } else {
+    return value;
+  }
+}
+function reconcile(live, json, config) {
+  if (isLiveObject(live) && isPlainObject(json)) {
+    return reconcileLiveObject(live, json, config);
+  } else if (isLiveList(live) && Array.isArray(json)) {
+    return reconcileLiveList(live, json, config);
+  } else if (isLiveMap(live) && isPlainObject(json)) {
+    return reconcileLiveMap(live, config);
+  } else {
+    return deepLiveify(json, config);
+  }
+}
+function reconcileLiveMap(_liveMap, _config) {
+  throw new Error("Reconciling a LiveMap is not supported yet");
+}
+function reconcileLiveObject(liveObj, jsonObj, config) {
+  const currentKeys = liveObj.keys();
+  for (const key in jsonObj) {
+    currentKeys.delete(key);
+    const newVal = jsonObj[key];
+    if (newVal === void 0) {
+      liveObj.delete(key);
+      continue;
+    }
+    const subConfig = isPlainObject(config) ? config[key] : config;
+    if (subConfig === false) {
+      liveObj.setLocal(key, newVal);
+    } else if (subConfig === "atomic") {
+      const curVal = liveObj.get(key);
+      if (curVal !== newVal) {
+        liveObj.set(key, newVal);
+      }
+    } else {
+      const curVal = liveObj.get(key);
+      if (curVal === void 0) {
+        liveObj.set(key, deepLiveify(newVal, subConfig));
+      } else if (isLiveStructure(curVal)) {
+        const next = reconcile(curVal, newVal, subConfig);
+        if (next !== curVal) {
+          liveObj.set(key, next);
+        }
+      } else if (curVal !== newVal) {
+        liveObj.set(key, deepLiveify(newVal, subConfig));
+      }
+    }
+  }
+  for (const key of currentKeys) {
+    liveObj.delete(key);
+  }
+  return liveObj;
+}
+function reconcileLiveList(liveList, jsonArr, config) {
+  const curLen = liveList.length;
+  const newLen = jsonArr.length;
+  for (let i = 0; i < Math.min(curLen, newLen); i++) {
+    const curVal = liveList.get(i);
+    const newVal = jsonArr[i];
+    if (isLiveStructure(curVal)) {
+      const next = reconcile(curVal, newVal, config);
+      if (next !== curVal) {
+        liveList.set(i, next);
+      }
+    } else if (curVal !== newVal) {
+      liveList.set(i, deepLiveify(newVal, config));
+    }
+  }
+  for (let i = curLen; i < newLen; i++) {
+    liveList.push(deepLiveify(jsonArr[i], config));
+  }
+  for (let i = curLen - 1; i >= newLen; i--) {
+    liveList.delete(i);
+  }
+  return liveList;
+}
+
 // src/crdts/LiveObject.ts
 var MAX_LIVE_OBJECT_SIZE = 128 * 1024;
 var LiveObject = class _LiveObject extends AbstractCrdt {
-  #map;
+  #synced;
+  #local = /* @__PURE__ */ new Map();
   /**
    * Tracks unacknowledged local changes per property to preserve optimistic
    * updates. Maps property keys to their pending operation IDs.
@@ -7944,7 +8059,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         value._setParentLink(this, key);
       }
     }
-    this.#map = new Map(Object.entries(o));
+    this.#synced = new Map(Object.entries(o));
   }
   /** @internal */
   _toOps(parentId, parentKey) {
@@ -7960,7 +8075,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       data: {}
     };
     ops.push(op);
-    for (const [key, value] of this.#map) {
+    for (const [key, value] of this.#synced) {
       if (isLiveNode(value)) {
         for (const childOp of value._toOps(this._id, key)) {
           ops.push(childOp);
@@ -7989,7 +8104,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       if (isLiveStructure(child)) {
         child._setParentLink(liveObj, crdt.parentKey);
       }
-      liveObj.#map.set(crdt.parentKey, child);
+      liveObj.#synced.set(crdt.parentKey, child);
       liveObj.invalidate();
     }
     return liveObj;
@@ -7997,7 +8112,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   /** @internal */
   _attach(id, pool) {
     super._attach(id, pool);
-    for (const [_key, value] of this.#map) {
+    for (const [_key, value] of this.#synced) {
       if (isLiveNode(value)) {
         value._attach(pool.generateId(), pool);
       }
@@ -8026,7 +8141,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       return { modified: false };
     }
     const thisId = nn(this._id);
-    const previousValue = this.#map.get(key);
+    const previousValue = this.#synced.get(key);
     let reverse;
     if (isLiveNode(previousValue)) {
       reverse = previousValue._toOps(thisId, key);
@@ -8042,7 +8157,8 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         }
       ];
     }
-    this.#map.set(key, child);
+    this.#local.delete(key);
+    this.#synced.set(key, child);
     this.invalidate();
     if (isLiveStructure(child)) {
       child._setParentLink(this, key);
@@ -8063,9 +8179,9 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       const id = nn(this._id);
       const parentKey = nn(child._parentKey);
       const reverse = child._toOps(id, parentKey);
-      for (const [key, value] of this.#map) {
+      for (const [key, value] of this.#synced) {
         if (value === child) {
-          this.#map.delete(key);
+          this.#synced.delete(key);
           this.invalidate();
         }
       }
@@ -8084,7 +8200,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   /** @internal */
   _detach() {
     super._detach();
-    for (const value of this.#map.values()) {
+    for (const value of this.#synced.values()) {
       if (isLiveNode(value)) {
         value._detach();
       }
@@ -8102,7 +8218,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   /** @internal */
   _serialize() {
     const data = {};
-    for (const [key, value] of this.#map) {
+    for (const [key, value] of this.#synced) {
       if (!isLiveNode(value)) {
         data[key] = value;
       }
@@ -8131,7 +8247,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       data: {}
     };
     for (const key in op.data) {
-      const oldValue = this.#map.get(key);
+      const oldValue = this.#synced.get(key);
       if (isLiveNode(oldValue)) {
         for (const childOp of oldValue._toOps(id, key)) {
           reverse.push(childOp);
@@ -8159,13 +8275,14 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       } else {
         continue;
       }
-      const oldValue = this.#map.get(key);
+      const oldValue = this.#synced.get(key);
       if (isLiveNode(oldValue)) {
         oldValue._detach();
       }
       isModified = true;
       updateDelta[key] = { type: "update" };
-      this.#map.set(key, value);
+      this.#local.delete(key);
+      this.#synced.set(key, value);
       this.invalidate();
     }
     if (Object.keys(reverseUpdate.data).length !== 0) {
@@ -8182,7 +8299,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   }
   #applyDeleteObjectKey(op, isLocal) {
     const key = op.key;
-    const oldValue = this.#map.get(key);
+    const oldValue = this.#synced.get(key);
     if (oldValue === void 0) {
       return { modified: false };
     }
@@ -8203,7 +8320,8 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         }
       ];
     }
-    this.#map.delete(key);
+    this.#local.delete(key);
+    this.#synced.delete(key);
     this.invalidate();
     return {
       modified: {
@@ -8216,11 +8334,23 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       reverse
     };
   }
+  /** @private */
+  keys() {
+    const result = new Set(this.#synced.keys());
+    for (const key of this.#local.keys()) {
+      result.add(key);
+    }
+    return result;
+  }
   /**
    * Transform the LiveObject into a javascript object
    */
   toObject() {
-    return Object.fromEntries(this.#map);
+    const result = Object.fromEntries(this.#synced);
+    for (const [key, value] of this.#local) {
+      result[key] = value;
+    }
+    return result;
   }
   /**
    * Adds or updates a property with a specified key and a value.
@@ -8228,49 +8358,109 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
    * @param value The value of the property to add
    */
   set(key, value) {
-    this._pool?.assertStorageIsWritable();
     this.update({ [key]: value });
   }
+  /**
+   * @experimental
+   *
+   * Sets a local-only property that is not synchronized over the wire.
+   * The value will be visible via get(), toObject(), and toImmutable() on
+   * this client only. Other clients and the server will see `undefined`
+   * for this key.
+   *
+   * Caveat: this method will not add changes to the undo/redo stack.
+   */
+  setLocal(key, value) {
+    this._pool?.assertStorageIsWritable();
+    const deleteResult = this.#prepareDelete(key);
+    this.#local.set(key, value);
+    this.invalidate();
+    if (this._pool !== void 0 && this._id !== void 0) {
+      const ops = deleteResult?.[0] ?? [];
+      const reverse = deleteResult?.[1] ?? [];
+      const storageUpdates = deleteResult?.[2] ?? /* @__PURE__ */ new Map();
+      const existing = storageUpdates.get(this._id);
+      storageUpdates.set(this._id, {
+        node: this,
+        type: "LiveObject",
+        updates: {
+          ...existing?.updates,
+          [key]: { type: "update" }
+        }
+      });
+      this._pool.dispatch(ops, reverse, storageUpdates);
+    }
+  }
   /**
    * Returns a specified property from the LiveObject.
    * @param key The key of the property to get
    */
   get(key) {
-    return this.#map.get(key);
+    return this.#local.has(key) ? this.#local.get(key) : this.#synced.get(key);
   }
   /**
-   * Deletes a key from the LiveObject
-   * @param key The key of the property to delete
+   * Removes a synced key, returning the ops, reverse ops, and storage updates
+   * needed to notify the pool. Returns null if the key doesn't exist in
+   * #synced or pool/id are unavailable. Does NOT dispatch.
    */
-  delete(key) {
+  #prepareDelete(key) {
     this._pool?.assertStorageIsWritable();
-    const keyAsString = key;
-    const oldValue = this.#map.get(keyAsString);
+    const k = key;
+    if (this.#local.has(k) && !this.#synced.has(k)) {
+      const oldValue2 = this.#local.get(k);
+      this.#local.delete(k);
+      this.invalidate();
+      if (this._pool !== void 0 && this._id !== void 0) {
+        const storageUpdates2 = /* @__PURE__ */ new Map();
+        storageUpdates2.set(this._id, {
+          node: this,
+          type: "LiveObject",
+          updates: {
+            [k]: {
+              type: "delete",
+              deletedItem: oldValue2
+            }
+          }
+        });
+        return [[], [], storageUpdates2];
+      }
+      return null;
+    }
+    this.#local.delete(k);
+    const oldValue = this.#synced.get(k);
     if (oldValue === void 0) {
-      return;
+      return null;
     }
     if (this._pool === void 0 || this._id === void 0) {
       if (isLiveNode(oldValue)) {
         oldValue._detach();
       }
-      this.#map.delete(keyAsString);
+      this.#synced.delete(k);
       this.invalidate();
-      return;
+      return null;
     }
+    const ops = [
+      {
+        type: OpCode.DELETE_OBJECT_KEY,
+        key: k,
+        id: this._id,
+        opId: this._pool.generateOpId()
+      }
+    ];
     let reverse;
     if (isLiveNode(oldValue)) {
       oldValue._detach();
-      reverse = oldValue._toOps(this._id, keyAsString);
+      reverse = oldValue._toOps(this._id, k);
     } else {
       reverse = [
         {
           type: OpCode.UPDATE_OBJECT,
-          data: { [keyAsString]: oldValue },
+          data: { [k]: oldValue },
           id: this._id
         }
       ];
     }
-    this.#map.delete(keyAsString);
+    this.#synced.delete(k);
     this.invalidate();
     const storageUpdates = /* @__PURE__ */ new Map();
     storageUpdates.set(this._id, {
@@ -8280,18 +8470,18 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         [key]: { type: "delete", deletedItem: oldValue }
       }
     });
-    this._pool.dispatch(
-      [
-        {
-          type: OpCode.DELETE_OBJECT_KEY,
-          key: keyAsString,
-          id: this._id,
-          opId: this._pool.generateOpId()
-        }
-      ],
-      reverse,
-      storageUpdates
-    );
+    return [ops, reverse, storageUpdates];
+  }
+  /**
+   * Deletes a key from the LiveObject
+   * @param key The key of the property to delete
+   */
+  delete(key) {
+    const result = this.#prepareDelete(key);
+    if (result) {
+      const [ops, reverse, storageUpdates] = result;
+      this._pool?.dispatch(ops, reverse, storageUpdates);
+    }
   }
   /**
    * Adds or updates multiple properties at once with an object.
@@ -8301,7 +8491,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     this._pool?.assertStorageIsWritable();
     if (_LiveObject.detectLargeObjects) {
       const data = {};
-      for (const [key, value] of this.#map) {
+      for (const [key, value] of this.#synced) {
         if (!isLiveNode(value)) {
           data[key] = value;
         }
@@ -8330,14 +8520,15 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         if (newValue === void 0) {
           continue;
         }
-        const oldValue = this.#map.get(key);
+        const oldValue = this.#synced.get(key);
         if (isLiveNode(oldValue)) {
           oldValue._detach();
         }
         if (isLiveNode(newValue)) {
           newValue._setParentLink(this, key);
         }
-        this.#map.set(key, newValue);
+        this.#local.delete(key);
+        this.#synced.set(key, newValue);
         this.invalidate();
       }
       return;
@@ -8357,7 +8548,10 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       if (newValue === void 0) {
         continue;
       }
-      const oldValue = this.#map.get(key);
+      const oldValue = this.#synced.get(key);
+      if (oldValue === newValue) {
+        continue;
+      }
       if (isLiveNode(oldValue)) {
         for (const childOp of oldValue._toOps(this._id, key)) {
           reverseOps.push(childOp);
@@ -8389,7 +8583,8 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         updatedProps[key] = newValue;
         this.#unackedOpsByKey.set(key, opId);
       }
-      this.#map.set(key, newValue);
+      this.#local.delete(key);
+      this.#synced.set(key, newValue);
       this.invalidate();
       updateDelta[key] = { type: "update" };
     }
@@ -8404,6 +8599,9 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         data: updatedProps
       });
     }
+    if (ops.length === 0 && reverseOps.length === 0 && Object.keys(updateDelta).length === 0) {
+      return;
+    }
     const storageUpdates = /* @__PURE__ */ new Map();
     storageUpdates.set(this._id, {
       node: this,
@@ -8412,6 +8610,34 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     });
     this._pool.dispatch(ops, reverseOps, storageUpdates);
   }
+  /**
+   * Creates a new LiveObject from a plain JSON object, recursively converting
+   * nested objects to LiveObjects and arrays to LiveLists. An optional
+   * SyncConfig controls per-key behavior (local-only, atomic, or deep).
+   *
+   * @private
+   */
+  static from(obj, config) {
+    if (!isPlainObject(obj)) throw new Error("Expected a JSON object");
+    const liveObj = new _LiveObject({});
+    liveObj.reconcile(obj, config);
+    return liveObj;
+  }
+  /**
+   * Reconciles a LiveObject tree to match the given JSON object and sync
+   * config. Only mutates keys that actually changed. Recursively reconciles
+   * the entire Live tree below it.
+   *
+   * @private
+   */
+  reconcile(jsonObj, config) {
+    if (this.immutableIs(jsonObj)) return;
+    if (!isPlainObject(jsonObj))
+      throw new Error(
+        "Reconciling the document root expects a plain object value"
+      );
+    reconcileLiveObject(this, jsonObj, config);
+  }
   toImmutable() {
     return super.toImmutable();
   }
@@ -8426,7 +8652,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       type: "LiveObject",
       id: nodeId,
       key,
-      payload: Array.from(this.#map.entries()).map(
+      payload: Array.from(this.#synced.entries()).map(
         ([key2, value]) => isLiveNode(value) ? value.toTreeNode(key2) : { type: "Json", id: `${nodeId}:${key2}`, key: key2, payload: value }
       )
     };
@@ -8434,20 +8660,27 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   /** @internal */
   _toImmutable() {
     const result = {};
-    for (const [key, val] of this.#map) {
+    for (const [key, val] of this.#synced) {
       result[key] = isLiveStructure(val) ? val.toImmutable() : val;
     }
+    for (const [key, val] of this.#local) {
+      result[key] = val;
+    }
     return process.env.NODE_ENV === "production" ? result : Object.freeze(result);
   }
   clone() {
-    return new _LiveObject(
+    const cloned = new _LiveObject(
       Object.fromEntries(
-        Array.from(this.#map).map(([key, value]) => [
+        Array.from(this.#synced).map(([key, value]) => [
           key,
           isLiveStructure(value) ? value.clone() : deepClone(value)
         ])
       )
     );
+    for (const [key, value] of this.#local) {
+      cloned.#local.set(key, deepClone(value));
+    }
+    return cloned;
   }
 };
 
@@ -9255,9 +9488,13 @@ function createRoom(options, config) {
       }
       context.activeBatch.reverseOps.pushLeft(reverse);
     } else {
-      addToUndoStack(reverse);
-      context.redoStack.length = 0;
-      dispatchOps(ops);
+      if (reverse.length > 0) {
+        addToUndoStack(reverse);
+      }
+      if (ops.length > 0) {
+        context.redoStack.length = 0;
+        dispatchOps(ops);
+      }
       notify({ storageUpdates });
     }
   }
@@ -9367,19 +9604,20 @@ function createRoom(options, config) {
       );
     }
     const canWrite = self.get()?.canWrite ?? true;
-    const stackSizeBefore = context.undoStack.length;
-    for (const key in context.initialStorage) {
-      if (context.root.get(key) === void 0) {
-        if (canWrite) {
-          context.root.set(key, cloneLson(context.initialStorage[key]));
-        } else {
-          warn(
-            `Attempted to populate missing storage key '${key}', but current user has no write access`
-          );
+    const root = context.root;
+    withoutHistory(() => {
+      for (const key in context.initialStorage) {
+        if (root.get(key) === void 0) {
+          if (canWrite) {
+            root.set(key, cloneLson(context.initialStorage[key]));
+          } else {
+            warn(
+              `Attempted to populate missing storage key '${key}', but current user has no write access`
+            );
+          }
         }
       }
-    }
-    context.undoStack.length = stackSizeBefore;
+    });
   }
   function _addToRealUndoStack(frames) {
     if (context.undoStack.length >= 50) {
@@ -10397,7 +10635,8 @@ function createRoom(options, config) {
         presence: false,
         others: []
       },
-      reverseOps: new Deque()
+      reverseOps: new Deque(),
+      scheduleHistoryResume: false
     };
     try {
       returnValue = callback();
@@ -10407,6 +10646,9 @@ function createRoom(options, config) {
       if (currentBatch.reverseOps.length > 0) {
         addToUndoStack(Array.from(currentBatch.reverseOps));
       }
+      if (currentBatch.scheduleHistoryResume) {
+        commitPausedHistoryToUndoStack();
+      }
       if (currentBatch.ops.length > 0) {
         context.redoStack.length = 0;
       }
@@ -10423,13 +10665,30 @@ function createRoom(options, config) {
       context.pausedHistory = new Deque();
     }
   }
-  function resumeHistory() {
+  function commitPausedHistoryToUndoStack() {
     const frames = context.pausedHistory;
     context.pausedHistory = null;
     if (frames !== null && frames.length > 0) {
       _addToRealUndoStack(Array.from(frames));
     }
   }
+  function resumeHistory() {
+    if (context.activeBatch !== null) {
+      context.activeBatch.scheduleHistoryResume = true;
+      return;
+    }
+    commitPausedHistoryToUndoStack();
+  }
+  function withoutHistory(fn) {
+    const undoBefore = context.undoStack.length;
+    const redoBefore = context.redoStack.length;
+    try {
+      return fn();
+    } finally {
+      context.undoStack.length = undoBefore;
+      context.redoStack.length = redoBefore;
+    }
+  }
   const syncSourceForStorage = config.createSyncSource();
   function getStorageStatus() {
     if (context.root === void 0) {
@@ -10735,7 +10994,10 @@ function createRoom(options, config) {
         canRedo,
         clear,
         pause: pauseHistory,
-        resume: resumeHistory
+        resume: resumeHistory,
+        [kInternal]: {
+          withoutHistory
+        }
       },
       fetchYDoc,
       fetchFeeds,
@@ -11697,24 +11959,7 @@ function lsonToJson(value) {
   }
   return value;
 }
-function deepLiveify(value) {
-  if (Array.isArray(value)) {
-    return new LiveList(value.map(deepLiveify));
-  } else if (isPlainObject(value)) {
-    const init = {};
-    for (const key in value) {
-      const val = value[key];
-      if (val === void 0) {
-        continue;
-      }
-      init[key] = deepLiveify(val);
-    }
-    return new LiveObject(init);
-  } else {
-    return value;
-  }
-}
-function patchLiveList(liveList, prev, next) {
+function legacy_patchLiveList(liveList, prev, next) {
   let i = 0;
   let prevEnd = prev.length - 1;
   let nextEnd = next.length - 1;
@@ -11760,7 +12005,7 @@ function patchLiveList(liveList, prev, next) {
       nextNode = next[i];
       const liveListNode = liveList.get(i);
       if (isLiveObject(liveListNode) && isPlainObject(prevNode) && isPlainObject(nextNode)) {
-        patchLiveObject(liveListNode, prevNode, nextNode);
+        legacy_patchLiveObject(liveListNode, prevNode, nextNode);
       } else {
         liveList.set(i, deepLiveify(nextNode));
       }
@@ -11777,7 +12022,7 @@ function patchLiveList(liveList, prev, next) {
     }
   }
 }
-function patchLiveObjectKey(liveObject, key, prev, next) {
+function legacy_patchLiveObjectKey(liveObject, key, prev, next) {
   if (process.env.NODE_ENV !== "production") {
     const nonSerializableValue = findNonSerializableValue(next);
     if (nonSerializableValue) {
@@ -11798,17 +12043,17 @@ Only serializable value can be synced with Liveblocks.`
   } else if (prev === next) {
     return;
   } else if (isLiveList(value) && Array.isArray(prev) && Array.isArray(next)) {
-    patchLiveList(value, prev, next);
+    legacy_patchLiveList(value, prev, next);
   } else if (isLiveObject(value) && isPlainObject(prev) && isPlainObject(next)) {
-    patchLiveObject(value, prev, next);
+    legacy_patchLiveObject(value, prev, next);
   } else {
     liveObject.set(key, deepLiveify(next));
   }
 }
-function patchLiveObject(root, prev, next) {
+function legacy_patchLiveObject(root, prev, next) {
   const updates = {};
   for (const key in next) {
-    patchLiveObjectKey(root, key, prev[key], next[key]);
+    legacy_patchLiveObjectKey(root, key, prev[key], next[key]);
   }
   for (const key in prev) {
     if (next[key] === void 0) {
@@ -12202,6 +12447,7 @@ export {
   kInternal,
   keys,
   legacy_patchImmutableObject,
+  legacy_patchLiveObjectKey,
   lsonToJson,
   makeAbortController,
   makeEventSource,
@@ -12213,7 +12459,6 @@ export {
   nn,
   nodeStreamToCompactNodes,
   objectToQuery,
-  patchLiveObjectKey,
   patchNotificationSettings,
   raise,
   resolveMentionsInCommentBody,