@liveblocks/core 3.19.3 → 3.20.0-pre1

package/dist/index.d.cts

@@ -454,40 +454,40 @@ type UpdateObjectOp = {
 type CreateObjectOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_OBJECT;
     readonly parentId: string;
     readonly parentKey: string;
     readonly data: JsonObject;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateListOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_LIST;
     readonly parentId: string;
     readonly parentKey: string;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateMapOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_MAP;
     readonly parentId: string;
     readonly parentKey: string;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateRegisterOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_REGISTER;
     readonly parentId: string;
     readonly parentKey: string;
     readonly data: Json;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type DeleteCrdtOp = {
     readonly opId?: string;

package/dist/index.d.ts

@@ -454,40 +454,40 @@ type UpdateObjectOp = {
 type CreateObjectOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_OBJECT;
     readonly parentId: string;
     readonly parentKey: string;
     readonly data: JsonObject;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateListOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_LIST;
     readonly parentId: string;
     readonly parentKey: string;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateMapOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_MAP;
     readonly parentId: string;
     readonly parentKey: string;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type CreateRegisterOp = {
     readonly opId?: string;
     readonly id: string;
-    readonly intent?: "set";
-    readonly deletedId?: string;
     readonly type: OpCode.CREATE_REGISTER;
     readonly parentId: string;
     readonly parentKey: string;
     readonly data: Json;
+    readonly intent?: "set" | "push";
+    readonly deletedId?: string;
 };
 type DeleteCrdtOp = {
     readonly opId?: string;

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.19.3";
+var PKG_VERSION = "3.20.0-pre1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -6123,9 +6123,9 @@ var LiveList = class _LiveList extends AbstractCrdt {
     ops.push(op);
     for (const item of this.#items) {
       const parentKey2 = item._getParentKeyOrThrow();
-      const childOps = HACK_addIntentAndDeletedIdToOperation(
+      const childOps = addIntentToOpTree(
         item._toOps(this._id, parentKey2),
-        void 0
+        "set"
       );
       for (const childOp of childOps) {
         ops.push(childOp);
@@ -6439,8 +6439,9 @@ var LiveList = class _LiveList extends AbstractCrdt {
       existingItem._detach();
       this.#items.remove(existingItem);
       this.#items.add(child);
-      const reverse = HACK_addIntentAndDeletedIdToOperation(
+      const reverse = addIntentToOpTree(
         existingItem._toOps(nn(this._id), key),
+        "set",
         op.id
       );
       const delta = [setDelta(indexOfItemWithSameKey, child)];
@@ -6683,8 +6684,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param element The element to add to the end of the LiveList.
    */
   push(element) {
-    this._pool?.assertStorageIsWritable();
-    return this.insert(element, this.length);
+    return this.#injectAt(element, this.length, "push");
   }
   /**
    * Inserts one element at a specified index.
@@ -6692,6 +6692,15 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index at which you want to insert the element.
    */
   insert(element, index) {
+    return this.#injectAt(element, index, "insert");
+  }
+  /**
+   * Shared implementation of `insert` and `push`. A `"push"` intent leaves the
+   * client-computed position untouched (so optimistic rendering is unchanged),
+   * but tags the Op so the server appends it to the true end of the list
+   * instead of resolving its position against the client's stale view.
+   */
+  #injectAt(element, index, intent) {
     this._pool?.assertStorageIsWritable();
     if (index < 0 || index > this.#items.length) {
       throw new Error(
@@ -6707,8 +6716,9 @@ var LiveList = class _LiveList extends AbstractCrdt {
     if (this._pool && this._id) {
       const id = this._pool.generateId();
       value._attach(id, this._pool);
+      const ops = value._toOpsWithOpId(this._id, position, this._pool);
       this._pool.dispatch(
-        value._toOpsWithOpId(this._id, position, this._pool),
+        intent === "push" ? addIntentToOpTree(ops, "push") : ops,
         [{ type: OpCode.DELETE_CRDT, id }],
         /* @__PURE__ */ new Map([
           [this._id, makeUpdate(this, [insertDelta(index, value)])]
@@ -6866,13 +6876,15 @@ var LiveList = class _LiveList extends AbstractCrdt {
       value._attach(id, this._pool);
       const storageUpdates = /* @__PURE__ */ new Map();
       storageUpdates.set(this._id, makeUpdate(this, [setDelta(index, value)]));
-      const ops = HACK_addIntentAndDeletedIdToOperation(
+      const ops = addIntentToOpTree(
         value._toOpsWithOpId(this._id, position, this._pool),
+        "set",
         existingId
       );
       this.#unacknowledgedSets.set(position, nn(ops[0].opId));
-      const reverseOps = HACK_addIntentAndDeletedIdToOperation(
+      const reverseOps = addIntentToOpTree(
         existingItem._toOps(this._id, position),
+        "set",
         id
       );
       this._pool.dispatch(ops, reverseOps, storageUpdates);
@@ -7073,15 +7085,11 @@ function moveDelta(previousIndex, index, item) {
     previousIndex
   };
 }
-function HACK_addIntentAndDeletedIdToOperation(ops, deletedId) {
+function addIntentToOpTree(ops, intent, deletedId) {
   return ops.map((op, index) => {
     if (index === 0) {
       const firstOp = op;
-      return {
-        ...firstOp,
-        intent: "set",
-        deletedId
-      };
+      return { ...firstOp, intent, deletedId };
     } else {
       return op;
     }