@liveblocks/core 3.22.0-file1 → 3.22.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.22.0-file1";
+var PKG_VERSION = "3.22.0";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -1309,7 +1309,6 @@ var nanoid = (t = 21) => crypto.getRandomValues(new Uint8Array(t)).reduce(
 var THREAD_ID_PREFIX = "th";
 var COMMENT_ID_PREFIX = "cm";
 var COMMENT_ATTACHMENT_ID_PREFIX = "at";
-var STORAGE_FILE_ID_PREFIX = "fl";
 var INBOX_NOTIFICATION_ID_PREFIX = "in";
 function createOptimisticId(prefix) {
   return `${prefix}_${nanoid()}`;
@@ -1323,9 +1322,6 @@ function createCommentId() {
 function createCommentAttachmentId() {
   return createOptimisticId(COMMENT_ATTACHMENT_ID_PREFIX);
 }
-function createStorageFileId() {
-  return createOptimisticId(STORAGE_FILE_ID_PREFIX);
-}
 function createInboxNotificationId() {
   return createOptimisticId(INBOX_NOTIFICATION_ID_PREFIX);
 }
@@ -1571,120 +1567,6 @@ function isUrl(string) {
 }
 
 // src/api-client.ts
-var ROOM_FILE_PART_SIZE = 5 * 1024 * 1024;
-var ROOM_FILE_RETRY_ATTEMPTS = 10;
-var ROOM_FILE_RETRY_DELAYS = [
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3,
-  2e3
-];
-async function uploadRoomFile({
-  file,
-  signal,
-  abortErrorMessage,
-  uploadSingle,
-  createMultipartUpload,
-  uploadMultipartPart,
-  completeMultipartUpload,
-  abortMultipartUpload
-}) {
-  const abortError = createAbortError(abortErrorMessage);
-  if (signal?.aborted) {
-    throw abortError;
-  }
-  const handleRetryError = (err) => {
-    if (signal?.aborted) {
-      throw abortError;
-    }
-    if (err instanceof HttpError && err.status === 413) {
-      throw err;
-    }
-    return false;
-  };
-  if (file.size <= ROOM_FILE_PART_SIZE) {
-    return autoRetry(
-      uploadSingle,
-      ROOM_FILE_RETRY_ATTEMPTS,
-      ROOM_FILE_RETRY_DELAYS,
-      handleRetryError
-    );
-  }
-  let uploadId;
-  const uploadedParts = [];
-  const multipartUpload = await autoRetry(
-    createMultipartUpload,
-    ROOM_FILE_RETRY_ATTEMPTS,
-    ROOM_FILE_RETRY_DELAYS,
-    handleRetryError
-  );
-  try {
-    uploadId = multipartUpload.uploadId;
-    if (signal?.aborted) {
-      throw abortError;
-    }
-    const batches = chunk(splitFileIntoParts(file), 5);
-    for (const parts of batches) {
-      const uploadedPartsPromises = [];
-      for (const { part, partNumber } of parts) {
-        uploadedPartsPromises.push(
-          autoRetry(
-            () => uploadMultipartPart(multipartUpload.uploadId, partNumber, part),
-            ROOM_FILE_RETRY_ATTEMPTS,
-            ROOM_FILE_RETRY_DELAYS,
-            handleRetryError
-          )
-        );
-      }
-      uploadedParts.push(...await Promise.all(uploadedPartsPromises));
-    }
-    if (signal?.aborted) {
-      throw abortError;
-    }
-    return completeMultipartUpload(
-      uploadId,
-      uploadedParts.sort((a, b) => a.partNumber - b.partNumber)
-    );
-  } catch (error3) {
-    if (uploadId && isAbortOrTimeoutError(error3)) {
-      try {
-        await abortMultipartUpload(uploadId);
-      } catch {
-      }
-    }
-    throw error3;
-  }
-}
-function splitFileIntoParts(file) {
-  const parts = [];
-  let start = 0;
-  while (start < file.size) {
-    const end = Math.min(start + ROOM_FILE_PART_SIZE, file.size);
-    parts.push({
-      partNumber: parts.length + 1,
-      part: file.slice(start, end)
-    });
-    start = end;
-  }
-  return parts;
-}
-function isAbortOrTimeoutError(error3) {
-  return error3 instanceof Error && (error3.name === "AbortError" || error3.name === "TimeoutError");
-}
-function createAbortError(message) {
-  if (typeof DOMException === "function") {
-    return new DOMException(message, "AbortError");
-  }
-  const error3 = new Error(message);
-  error3.name = "AbortError";
-  return error3;
-}
 function commentsResourceForVisibility(visibility) {
   if (visibility === "private") {
     return "comments:private";
@@ -2000,128 +1882,151 @@ function createApiClient({
   }
   async function uploadAttachment(options) {
     const roomId = options.roomId;
+    const abortSignal = options.signal;
     const attachment = options.attachment;
-    return uploadRoomFile({
-      file: attachment.file,
-      signal: options.signal,
-      abortErrorMessage: `Upload of attachment ${attachment.id} was aborted.`,
-      uploadSingle: async () => httpClient.putBlob(
-        url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/upload/${encodeURIComponent(attachment.name)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "comments",
-          access: "write"
-        }),
-        attachment.file,
-        { fileSize: attachment.size },
-        { signal: options.signal }
-      ),
-      createMultipartUpload: async () => httpClient.post(
-        url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${encodeURIComponent(attachment.name)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "comments",
-          access: "write"
-        }),
-        void 0,
-        { signal: options.signal },
-        { fileSize: attachment.size }
-      ),
-      uploadMultipartPart: async (uploadId, partNumber, part) => httpClient.putBlob(
-        url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/${String(partNumber)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "comments",
-          access: "write"
-        }),
-        part,
-        void 0,
-        { signal: options.signal }
-      ),
-      completeMultipartUpload: async (uploadId, parts) => httpClient.post(
-        url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/complete`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "comments",
-          access: "write"
-        }),
-        { parts },
-        { signal: options.signal }
-      ),
-      abortMultipartUpload: async (uploadId) => {
-        await httpClient.rawDelete(
-          url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}`,
+    const abortError = abortSignal ? new DOMException(
+      `Upload of attachment ${options.attachment.id} was aborted.`,
+      "AbortError"
+    ) : void 0;
+    if (abortSignal?.aborted) {
+      throw abortError;
+    }
+    const handleRetryError = (err) => {
+      if (abortSignal?.aborted) {
+        throw abortError;
+      }
+      if (err instanceof HttpError && err.status === 413) {
+        throw err;
+      }
+      return false;
+    };
+    const ATTACHMENT_PART_SIZE = 5 * 1024 * 1024;
+    const RETRY_ATTEMPTS = 10;
+    const RETRY_DELAYS = [
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3,
+      2e3
+    ];
+    function splitFileIntoParts(file) {
+      const parts = [];
+      let start = 0;
+      while (start < file.size) {
+        const end = Math.min(start + ATTACHMENT_PART_SIZE, file.size);
+        parts.push({
+          partNumber: parts.length + 1,
+          part: file.slice(start, end)
+        });
+        start = end;
+      }
+      return parts;
+    }
+    if (attachment.size <= ATTACHMENT_PART_SIZE) {
+      return autoRetry(
+        async () => httpClient.putBlob(
+          url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/upload/${attachment.name}`,
           await authManager.getAuthValue({
             roomId,
             resource: "comments",
             access: "write"
-          })
+          }),
+          attachment.file,
+          { fileSize: attachment.size },
+          { signal: abortSignal }
+        ),
+        RETRY_ATTEMPTS,
+        RETRY_DELAYS,
+        handleRetryError
+      );
+    } else {
+      let uploadId;
+      const uploadedParts = [];
+      const createMultiPartUpload = await autoRetry(
+        async () => httpClient.post(
+          url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${attachment.name}`,
+          await authManager.getAuthValue({
+            roomId,
+            resource: "comments",
+            access: "write"
+          }),
+          void 0,
+          { signal: abortSignal },
+          { fileSize: attachment.size }
+        ),
+        RETRY_ATTEMPTS,
+        RETRY_DELAYS,
+        handleRetryError
+      );
+      try {
+        uploadId = createMultiPartUpload.uploadId;
+        const parts = splitFileIntoParts(attachment.file);
+        if (abortSignal?.aborted) {
+          throw abortError;
+        }
+        const batches = chunk(parts, 5);
+        for (const parts2 of batches) {
+          const uploadedPartsPromises = [];
+          for (const { part, partNumber } of parts2) {
+            uploadedPartsPromises.push(
+              autoRetry(
+                async () => httpClient.putBlob(
+                  url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${createMultiPartUpload.uploadId}/${String(partNumber)}`,
+                  await authManager.getAuthValue({
+                    roomId,
+                    resource: "comments",
+                    access: "write"
+                  }),
+                  part,
+                  void 0,
+                  { signal: abortSignal }
+                ),
+                RETRY_ATTEMPTS,
+                RETRY_DELAYS,
+                handleRetryError
+              )
+            );
+          }
+          uploadedParts.push(...await Promise.all(uploadedPartsPromises));
+        }
+        if (abortSignal?.aborted) {
+          throw abortError;
+        }
+        const sortedUploadedParts = uploadedParts.sort(
+          (a, b) => a.partNumber - b.partNumber
         );
-      }
-    });
-  }
-  async function uploadFile(options) {
-    const roomId = options.roomId;
-    const file = options.file;
-    const fileId = createStorageFileId();
-    return uploadRoomFile({
-      file,
-      signal: options.signal,
-      abortErrorMessage: `Upload of file ${fileId} was aborted.`,
-      uploadSingle: async () => httpClient.putBlob(
-        url`/v2/c/rooms/${roomId}/storage-files/${fileId}/upload/${encodeURIComponent(file.name)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "storage",
-          access: "write"
-        }),
-        file,
-        { fileSize: file.size },
-        { signal: options.signal }
-      ),
-      createMultipartUpload: async () => httpClient.post(
-        url`/v2/c/rooms/${roomId}/storage-files/${fileId}/multipart/${encodeURIComponent(file.name)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "storage",
-          access: "write"
-        }),
-        void 0,
-        { signal: options.signal },
-        { fileSize: file.size }
-      ),
-      uploadMultipartPart: async (uploadId, partNumber, part) => httpClient.putBlob(
-        url`/v2/c/rooms/${roomId}/storage-files/${fileId}/multipart/${uploadId}/${String(partNumber)}`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "storage",
-          access: "write"
-        }),
-        part,
-        void 0,
-        { signal: options.signal }
-      ),
-      completeMultipartUpload: async (uploadId, parts) => httpClient.post(
-        url`/v2/c/rooms/${roomId}/storage-files/${fileId}/multipart/${uploadId}/complete`,
-        await authManager.getAuthValue({
-          roomId,
-          resource: "storage",
-          access: "write"
-        }),
-        { parts },
-        { signal: options.signal }
-      ),
-      abortMultipartUpload: async (uploadId) => {
-        await httpClient.rawDelete(
-          url`/v2/c/rooms/${roomId}/storage-files/${fileId}/multipart/${uploadId}`,
+        return httpClient.post(
+          url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/complete`,
           await authManager.getAuthValue({
             roomId,
-            resource: "storage",
+            resource: "comments",
             access: "write"
-          })
+          }),
+          { parts: sortedUploadedParts },
+          { signal: abortSignal }
         );
+      } catch (error3) {
+        if (uploadId && error3?.name && (error3.name === "AbortError" || error3.name === "TimeoutError")) {
+          try {
+            await httpClient.rawDelete(
+              url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}`,
+              await authManager.getAuthValue({
+                roomId,
+                resource: "comments",
+                access: "write"
+              })
+            );
+          } catch {
+          }
+        }
+        throw error3;
       }
-    });
+    }
   }
   const attachmentUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
     const batch2 = new Batch(
@@ -2151,34 +2056,6 @@ function createApiClient({
     const batch2 = getOrCreateAttachmentUrlsStore(options.roomId).batch;
     return batch2.get(options.attachmentId);
   }
-  const fileUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
-    const batch2 = new Batch(
-      async (batchedFileIds) => {
-        const fileIds = batchedFileIds.flat();
-        const { urls } = await httpClient.post(
-          url`/v2/c/rooms/${roomId}/storage-files/presigned-urls`,
-          await authManager.getAuthValue({
-            roomId,
-            resource: "storage",
-            access: "read"
-          }),
-          { fileIds }
-        );
-        return urls.map(
-          (url2) => url2 ?? new Error("There was an error while getting this file's URL")
-        );
-      },
-      { delay: 50 }
-    );
-    return createBatchStore(batch2);
-  });
-  function getOrCreateFileUrlsStore(roomId) {
-    return fileUrlsBatchStoresByRoom.getOrCreate(roomId);
-  }
-  function getFileUrl(options) {
-    const batch2 = getOrCreateFileUrlsStore(options.roomId).batch;
-    return batch2.get(options.fileId);
-  }
   async function getSubscriptionSettings(options) {
     return httpClient.get(
       url`/v2/c/rooms/${options.roomId}/subscription-settings`,
@@ -2255,7 +2132,17 @@ function createApiClient({
       })
     );
   }
-  async function getYjsHistoryVersion(options) {
+  async function fetchStorageHistoryVersion(options) {
+    return httpClient.rawGet(
+      url`/v2/c/rooms/${options.roomId}/versions/${options.versionId}/storage`,
+      await authManager.getAuthValue({
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
+      })
+    );
+  }
+  async function fetchYjsHistoryVersion(options) {
     return httpClient.rawGet(
       url`/v2/c/rooms/${options.roomId}/versions/${options.versionId}/yjs`,
       await authManager.getAuthValue({
@@ -2275,6 +2162,16 @@ function createApiClient({
       })
     );
   }
+  async function deleteHistoryVersion(options) {
+    await httpClient.delete(
+      url`/v2/c/rooms/${options.roomId}/versions/${options.versionId}`,
+      await authManager.getAuthValue({
+        roomId: options.roomId,
+        resource: "storage",
+        access: "write"
+      })
+    );
+  }
   async function reportTextEditor(options) {
     await httpClient.rawPost(
       url`/v2/c/rooms/${options.roomId}/text-metadata`,
@@ -2598,8 +2495,10 @@ function createApiClient({
     // Room text editor
     createTextMention,
     deleteTextMention,
-    getYjsHistoryVersion,
+    fetchStorageHistoryVersion,
+    fetchYjsHistoryVersion,
     createVersionHistorySnapshot,
+    deleteHistoryVersion,
     reportTextEditor,
     listHistoryVersions,
     listHistoryVersionsSince,
@@ -2607,10 +2506,6 @@ function createApiClient({
     getAttachmentUrl,
     uploadAttachment,
     getOrCreateAttachmentUrlsStore,
-    // Room storage files
-    getFileUrl,
-    uploadFile,
-    getOrCreateFileUrlsStore,
     // Room storage
     streamStorage,
     // Notifications
@@ -5942,15 +5837,13 @@ var OpCode = Object.freeze({
   DELETE_CRDT: 5,
   DELETE_OBJECT_KEY: 6,
   CREATE_MAP: 7,
-  CREATE_REGISTER: 8,
-  // 9 and 10 are reserved for the parallel LiveText work.
-  CREATE_FILE: 11
+  CREATE_REGISTER: 8
 });
 function isIgnoredOp(op) {
   return op.type === OpCode.DELETE_CRDT && op.id === "ACK";
 }
 function isCreateOp(op) {
-  return op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_REGISTER || op.type === OpCode.CREATE_FILE || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_LIST;
+  return op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_REGISTER || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_LIST;
 }
 
 // src/protocol/StorageNode.ts
@@ -5958,9 +5851,7 @@ var CrdtType = Object.freeze({
   OBJECT: 0,
   LIST: 1,
   MAP: 2,
-  REGISTER: 3,
-  // 4 is reserved for the parallel LiveText work.
-  FILE: 5
+  REGISTER: 3
 });
 function isRootStorageNode(node) {
   return node[0] === "root";
@@ -5977,9 +5868,6 @@ function isMapStorageNode(node) {
 function isRegisterStorageNode(node) {
   return node[1].type === CrdtType.REGISTER;
 }
-function isFileStorageNode(node) {
-  return node[1].type === CrdtType.FILE;
-}
 function isCompactRootNode(node) {
   return node[0] === "root";
 }
@@ -6002,9 +5890,6 @@ function* compactNodesToNodeStream(compactNodes) {
       case CrdtType.REGISTER:
         yield [cnode[0], { type: CrdtType.REGISTER, parentId: cnode[2], parentKey: cnode[3], data: cnode[4] }];
         break;
-      case CrdtType.FILE:
-        yield [cnode[0], { type: CrdtType.FILE, parentId: cnode[2], parentKey: cnode[3], data: cnode[4] }];
-        break;
       default:
     }
   }
@@ -6033,10 +5918,6 @@ function* nodeStreamToCompactNodes(nodes) {
       const id = node[0];
       const crdt = node[1];
       yield [id, CrdtType.REGISTER, crdt.parentId, crdt.parentKey, crdt.data];
-    } else if (isFileStorageNode(node)) {
-      const id = node[0];
-      const crdt = node[1];
-      yield [id, CrdtType.FILE, crdt.parentId, crdt.parentKey, crdt.data];
     } else {
     }
   }
@@ -6321,7 +6202,7 @@ ${parentKey}`;
 };
 
 // src/crdts/AbstractCrdt.ts
-function createManagedPool(roomId, options) {
+function createManagedPool(options) {
   const {
     getCurrentConnectionId,
     onDispatch,
@@ -6332,7 +6213,6 @@ function createManagedPool(roomId, options) {
   let opClock = 0;
   const nodes = /* @__PURE__ */ new Map();
   return {
-    roomId,
     nodes,
     getNode: (id) => nodes.get(id),
     addNode: (id, node) => void nodes.set(id, node),
@@ -6397,9 +6277,6 @@ var AbstractCrdt = class {
   get _pool() {
     return this.#pool;
   }
-  get roomId() {
-    return this.#pool ? this.#pool.roomId : null;
-  }
   /** @internal */
   get _id() {
     return this.#id;
@@ -6549,91 +6426,6 @@ var AbstractCrdt = class {
   }
 };
 
-// src/crdts/LiveFile.ts
-var LiveFile = class _LiveFile extends AbstractCrdt {
-  #data;
-  constructor(data) {
-    super();
-    this.#data = Object.freeze({ ...data });
-  }
-  get data() {
-    return this.#data;
-  }
-  get id() {
-    return this.#data.id;
-  }
-  get name() {
-    return this.#data.name;
-  }
-  get size() {
-    return this.#data.size;
-  }
-  get mimeType() {
-    return this.#data.mimeType;
-  }
-  /** @internal */
-  static _deserialize([id, item], _parentToChildren, pool) {
-    const file = new _LiveFile(item.data);
-    file._attach(id, pool);
-    return file;
-  }
-  /** @internal */
-  _toOps(parentId, parentKey) {
-    if (this._id === void 0) {
-      throw new Error("Cannot serialize LiveFile if parent is missing");
-    }
-    return [
-      {
-        type: OpCode.CREATE_FILE,
-        id: this._id,
-        parentId,
-        parentKey,
-        data: this.#data
-      }
-    ];
-  }
-  /** @internal */
-  _serialize() {
-    if (this.parent.type !== "HasParent") {
-      throw new Error("Cannot serialize LiveFile if parent is missing");
-    }
-    return {
-      type: CrdtType.FILE,
-      parentId: nn(this.parent.node._id, "Parent node expected to have ID"),
-      parentKey: this.parent.key,
-      data: this.#data
-    };
-  }
-  /** @internal */
-  _attachChild(_op) {
-    throw new Error("Method not implemented.");
-  }
-  /** @internal */
-  _detachChild(_crdt) {
-    throw new Error("Method not implemented.");
-  }
-  /** @internal */
-  _apply(op, isLocal) {
-    return super._apply(op, isLocal);
-  }
-  /** @internal */
-  _toTreeNode(key) {
-    return {
-      type: "Json",
-      id: this._id ?? nanoid(),
-      key,
-      payload: this.#data
-    };
-  }
-  /** @internal */
-  _toJSON() {
-    return this.#data;
-  }
-  clone() {
-    return new _LiveFile(this.#data);
-  }
-};
-
 // src/crdts/LiveRegister.ts
 var LiveRegister = class _LiveRegister extends AbstractCrdt {
   #data;
@@ -8990,8 +8782,6 @@ function creationOpToLiveNode(op) {
 }
 function creationOpToLson(op) {
   switch (op.type) {
-    case OpCode.CREATE_FILE:
-      return new LiveFile(op.data);
     case OpCode.CREATE_REGISTER:
       return op.data;
     case OpCode.CREATE_OBJECT:
@@ -9013,6 +8803,16 @@ function isSameNodeOrChildOf(node, parent) {
   }
   return false;
 }
+function liveObjectFromNodeStream(nodes) {
+  const pool = createManagedPool({
+    getCurrentConnectionId: () => {
+      throw new Error(
+        "Cannot mutate a historic storage version: it is a read-only snapshot"
+      );
+    }
+  });
+  return LiveObject._fromItems(nodes, pool);
+}
 function deserialize(node, parentToChildren, pool) {
   if (isObjectStorageNode(node)) {
     return LiveObject._deserialize(node, parentToChildren, pool);
@@ -9022,8 +8822,6 @@ function deserialize(node, parentToChildren, pool) {
     return LiveMap._deserialize(node, parentToChildren, pool);
   } else if (isRegisterStorageNode(node)) {
     return LiveRegister._deserialize(node, parentToChildren, pool);
-  } else if (isFileStorageNode(node)) {
-    return LiveFile._deserialize(node, parentToChildren, pool);
   } else {
     throw new Error("Unexpected CRDT type");
   }
@@ -9037,14 +8835,12 @@ function deserializeToLson(node, parentToChildren, pool) {
     return LiveMap._deserialize(node, parentToChildren, pool);
   } else if (isRegisterStorageNode(node)) {
     return node[1].data;
-  } else if (isFileStorageNode(node)) {
-    return LiveFile._deserialize(node, parentToChildren, pool);
   } else {
     throw new Error("Unexpected CRDT type");
   }
 }
 function isLiveStructure(value) {
-  return isLiveList(value) || isLiveMap(value) || isLiveObject(value) || isLiveFile(value);
+  return isLiveList(value) || isLiveMap(value) || isLiveObject(value);
 }
 function isLiveNode(value) {
   return isLiveStructure(value) || isLiveRegister(value);
@@ -9058,9 +8854,6 @@ function isLiveMap(value) {
 function isLiveObject(value) {
   return value instanceof LiveObject;
 }
-function isLiveFile(value) {
-  return value instanceof LiveFile;
-}
 function isLiveRegister(value) {
   return value instanceof LiveRegister;
 }
@@ -9070,14 +8863,14 @@ function cloneLson(value) {
 function liveNodeToLson(obj) {
   if (obj instanceof LiveRegister) {
     return obj.data;
-  } else if (obj instanceof LiveList || obj instanceof LiveMap || obj instanceof LiveObject || obj instanceof LiveFile) {
+  } else if (obj instanceof LiveList || obj instanceof LiveMap || obj instanceof LiveObject) {
     return obj;
   } else {
     return assertNever(obj, "Unknown AbstractCrdt");
   }
 }
 function lsonToLiveNode(value) {
-  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList || value instanceof LiveFile) {
+  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList) {
     return value;
   } else {
     return new LiveRegister(value);
@@ -9094,8 +8887,6 @@ function dumpPool(pool) {
       value = "<LiveList>";
     } else if (node instanceof LiveMap) {
       value = "<LiveMap>";
-    } else if (node instanceof LiveFile) {
-      value = stringifyOrLog(node.data);
     } else {
       value = "<LiveObject>";
     }
@@ -9146,6 +8937,61 @@ function diffNodeMap(prev, next) {
       ops.push({ type: OpCode.DELETE_CRDT, id });
     }
   });
+  const emitted = /* @__PURE__ */ new Set();
+  function emitCreate(id, crdt) {
+    if (emitted.has(id)) {
+      return;
+    }
+    emitted.add(id);
+    const parentId = crdt.parentId;
+    if (parentId !== void 0 && !prev.has(parentId)) {
+      const parentCrdt = next.get(parentId);
+      if (parentCrdt !== void 0) {
+        emitCreate(parentId, parentCrdt);
+      }
+    }
+    switch (crdt.type) {
+      case CrdtType.REGISTER:
+        ops.push({
+          type: OpCode.CREATE_REGISTER,
+          id,
+          parentId: crdt.parentId,
+          parentKey: crdt.parentKey,
+          data: crdt.data
+        });
+        break;
+      case CrdtType.LIST:
+        ops.push({
+          type: OpCode.CREATE_LIST,
+          id,
+          parentId: crdt.parentId,
+          parentKey: crdt.parentKey
+        });
+        break;
+      case CrdtType.OBJECT:
+        if (crdt.parentId === void 0 || crdt.parentKey === void 0) {
+          throw new Error(
+            "Internal error. Cannot serialize storage root into an operation"
+          );
+        }
+        ops.push({
+          type: OpCode.CREATE_OBJECT,
+          id,
+          parentId: crdt.parentId,
+          parentKey: crdt.parentKey,
+          data: crdt.data
+        });
+        break;
+      case CrdtType.MAP:
+        ops.push({
+          type: OpCode.CREATE_MAP,
+          id,
+          parentId: crdt.parentId,
+          parentKey: crdt.parentKey
+        });
+        break;
+    }
+  }
   next.forEach((crdt, id) => {
     const currentCrdt = prev.get(id);
     if (currentCrdt) {
@@ -9182,56 +9028,7 @@ function diffNodeMap(prev, next) {
         });
       }
     } else {
-      switch (crdt.type) {
-        case CrdtType.REGISTER:
-          ops.push({
-            type: OpCode.CREATE_REGISTER,
-            id,
-            parentId: crdt.parentId,
-            parentKey: crdt.parentKey,
-            data: crdt.data
-          });
-          break;
-        case CrdtType.FILE:
-          ops.push({
-            type: OpCode.CREATE_FILE,
-            id,
-            parentId: crdt.parentId,
-            parentKey: crdt.parentKey,
-            data: crdt.data
-          });
-          break;
-        case CrdtType.LIST:
-          ops.push({
-            type: OpCode.CREATE_LIST,
-            id,
-            parentId: crdt.parentId,
-            parentKey: crdt.parentKey
-          });
-          break;
-        case CrdtType.OBJECT:
-          if (crdt.parentId === void 0 || crdt.parentKey === void 0) {
-            throw new Error(
-              "Internal error. Cannot serialize storage root into an operation"
-            );
-          }
-          ops.push({
-            type: OpCode.CREATE_OBJECT,
-            id,
-            parentId: crdt.parentId,
-            parentKey: crdt.parentKey,
-            data: crdt.data
-          });
-          break;
-        case CrdtType.MAP:
-          ops.push({
-            type: OpCode.CREATE_MAP,
-            id,
-            parentId: crdt.parentId,
-            parentKey: crdt.parentKey
-          });
-          break;
-      }
+      emitCreate(id, crdt);
     }
   });
   return ops;
@@ -10098,9 +9895,6 @@ function defaultMessageFromContext(context) {
 
 // src/room.ts
 var FEEDS_TIMEOUT = 5e3;
-function getLiveFileId(file) {
-  return typeof file === "string" ? file : file.id;
-}
 function connectionAccessFromScopes(scopes) {
   const roomPermissions = normalizeRoomPermissions(scopes);
   const matrix = permissionMatrixFromScopes(roomPermissions);
@@ -10222,7 +10016,7 @@ function createRoom(options, config) {
     yjsProvider: void 0,
     yjsProviderDidChange: makeEventSource(),
     // Storage
-    pool: createManagedPool(roomId, {
+    pool: createManagedPool({
       getCurrentConnectionId,
       onDispatch,
       isStorageWritable,
@@ -10385,12 +10179,18 @@ function createRoom(options, config) {
       signal: options2.signal
     });
   }
-  async function getYjsHistoryVersion(versionId) {
-    return httpClient.getYjsHistoryVersion({ roomId, versionId });
+  async function fetchStorageHistoryVersion(versionId) {
+    return httpClient.fetchStorageHistoryVersion({ roomId, versionId });
+  }
+  async function fetchYjsHistoryVersion(versionId) {
+    return httpClient.fetchYjsHistoryVersion({ roomId, versionId });
   }
   async function createVersionHistorySnapshot() {
     return httpClient.createVersionHistorySnapshot({ roomId });
   }
+  async function deleteHistoryVersion(versionId) {
+    return httpClient.deleteHistoryVersion({ roomId, versionId });
+  }
   async function executeContextualPrompt(options2) {
     return httpClient.executeContextualPrompt({
       roomId,
@@ -10440,17 +10240,19 @@ function createRoom(options, config) {
     self,
     (me) => me !== null ? userToTreeNode("Me", me) : null
   );
+  function diffCurrentStorageAgainst(target) {
+    const current = /* @__PURE__ */ new Map();
+    for (const [id, crdt] of context.pool.nodes) {
+      current.set(id, crdt._serialize());
+    }
+    return diffNodeMap(current, target);
+  }
   function createOrUpdateRootFromMessage(nodes) {
     if (nodes.size === 0) {
       throw new Error("Internal error: cannot load storage without items");
     }
     if (context.root !== void 0) {
-      const currentItems = /* @__PURE__ */ new Map();
-      for (const [id, crdt] of context.pool.nodes) {
-        currentItems.set(id, crdt._serialize());
-      }
-      const ops = diffNodeMap(currentItems, nodes);
-      const result = applyRemoteOps(ops);
+      const result = applyRemoteOps(diffCurrentStorageAgainst(nodes));
       notify(result.updates);
     } else {
       context.root = LiveObject._fromItems(
@@ -10475,6 +10277,28 @@ function createRoom(options, config) {
       }
     });
   }
+  function reconcileStorageWithNodes(nodes) {
+    if (context.root === void 0) {
+      throw new Error("Cannot reconcile storage before it is loaded");
+    }
+    const ops = diffCurrentStorageAgainst(
+      new Map(nodes)
+    );
+    if (ops.length === 0) {
+      return;
+    }
+    const result = applyLocalOps(ops);
+    if (result.reverse.length > 0) {
+      addToUndoStack(result.reverse);
+    }
+    context.redoStack.length = 0;
+    for (const op of result.opsToEmit) {
+      context.buffer.storageOperations.push(op);
+    }
+    notify(result.updates);
+    onHistoryChange();
+    flushNowOrSoon();
+  }
   function _addToRealUndoStack(frames) {
     if (context.undoStack.length >= 50) {
       context.undoStack.shift();
@@ -10590,7 +10414,7 @@ function createRoom(options, config) {
           );
           output.reverse.pushLeft(applyOpResult.reverse);
         }
-        if (op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_FILE) {
+        if (op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_OBJECT) {
           createdNodeIds.add(op.id);
         }
       }
@@ -10634,7 +10458,6 @@ function createRoom(options, config) {
       case OpCode.CREATE_OBJECT:
       case OpCode.CREATE_LIST:
       case OpCode.CREATE_MAP:
-      case OpCode.CREATE_FILE:
       case OpCode.CREATE_REGISTER: {
         if (op.parentId === void 0) {
           return { modified: false };
@@ -10645,6 +10468,10 @@ function createRoom(options, config) {
         }
         return parentNode._attachChild(op, source);
       }
+      // Unknown op codes can be received when older and newer clients are
+      // both present in a same room. Older clients simply ignore them.
+      default:
+        return { modified: false };
     }
   }
   function updatePresence(patch, options2) {
@@ -11738,17 +11565,6 @@ function createRoom(options, config) {
   function getAttachmentUrl(attachmentId) {
     return httpClient.getAttachmentUrl({ roomId, attachmentId });
   }
-  async function uploadFile(file, options2 = {}) {
-    const data = await httpClient.uploadFile({
-      roomId,
-      file,
-      signal: options2.signal
-    });
-    return new LiveFile(data);
-  }
-  function getFileUrl(file) {
-    return httpClient.getFileUrl({ roomId, fileId: getLiveFileId(file) });
-  }
   function getSubscriptionSettings(options2) {
     return httpClient.getSubscriptionSettings({
       roomId,
@@ -11807,9 +11623,16 @@ function createRoom(options, config) {
         // List versions of the document since the specified date
         listHistoryVersionsSince,
         // get a specific version
-        getYjsHistoryVersion,
+        fetchStorageHistoryVersion,
+        fetchYjsHistoryVersion,
+        // reconstruct a storage version's nodes into a read-only LiveObject tree
+        liveObjectFromNodeStream,
+        // restore live storage to match a version's nodes
+        reconcileStorageWithNodes,
         // create a version
         createVersionHistorySnapshot,
+        // delete a version
+        deleteHistoryVersion,
         // execute a contextual prompt
         executeContextualPrompt,
         // Support for the Liveblocks browser extension
@@ -11822,8 +11645,7 @@ function createRoom(options, config) {
           rawSend: (data) => managedSocket.send(data),
           incomingMessage: (data) => handleServerMessage(new MessageEvent("message", { data }))
         },
-        attachmentUrlsStore: httpClient.getOrCreateAttachmentUrlsStore(roomId),
-        fileUrlsStore: httpClient.getOrCreateFileUrlsStore(roomId)
+        attachmentUrlsStore: httpClient.getOrCreateAttachmentUrlsStore(roomId)
       },
       id: roomId,
       subscribe: makeClassicSubscribeFn(
@@ -11921,8 +11743,6 @@ ${dumpPool(
       prepareAttachment,
       uploadAttachment,
       getAttachmentUrl,
-      uploadFile,
-      getFileUrl,
       // Notifications
       getNotificationSettings: getSubscriptionSettings,
       getSubscriptionSettings,
@@ -12808,11 +12628,6 @@ function toPlainLson(lson) {
       liveblocksType: "LiveList",
       data: [...lson].map((item) => toPlainLson(item))
     };
-  } else if (lson instanceof LiveFile) {
-    return {
-      liveblocksType: "LiveFile",
-      data: lson.data
-    };
   } else {
     return lson;
   }
@@ -12991,7 +12806,6 @@ export {
   DerivedSignal,
   FeedRequestErrorCode,
   HttpError,
-  LiveFile,
   LiveList,
   LiveMap,
   LiveObject,
@@ -13031,7 +12845,6 @@ export {
   createInboxNotificationId,
   createManagedPool,
   createNotificationSettings,
-  createStorageFileId,
   createThreadId,
   deepLiveify,
   defineAiTool,
@@ -13051,7 +12864,6 @@ export {
   isCommentBodyLink,
   isCommentBodyMention,
   isCommentBodyText,
-  isFileStorageNode,
   isJsonArray,
   isJsonObject,
   isJsonScalar,