@liveblocks/core 3.21.0-rc1 → 3.22.0-file1

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.21.0-rc1";
+var PKG_VERSION = "3.22.0-file1";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -1309,6 +1309,7 @@ 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()}`;
@@ -1322,6 +1323,9 @@ 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);
 }
@@ -1567,6 +1571,120 @@ 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 (_optionalChain([signal, 'optionalAccess', _15 => _15.aborted])) {
+    throw abortError;
+  }
+  const handleRetryError = (err) => {
+    if (_optionalChain([signal, 'optionalAccess', _16 => _16.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 (_optionalChain([signal, 'optionalAccess', _17 => _17.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 (_optionalChain([signal, 'optionalAccess', _18 => _18.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 (e8) {
+      }
+    }
+    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";
@@ -1627,7 +1745,7 @@ function createApiClient({
         url`/v2/c/rooms/${options.roomId}/threads`,
         await authManager.getAuthValue({
           roomId: options.roomId,
-          resource: commentsResourceForVisibility(_optionalChain([options, 'access', _15 => _15.query, 'optionalAccess', _16 => _16.visibility])),
+          resource: commentsResourceForVisibility(_optionalChain([options, 'access', _19 => _19.query, 'optionalAccess', _20 => _20.visibility])),
           access: "read"
         }),
         {
@@ -1685,7 +1803,7 @@ function createApiClient({
           hasMentions: options.query.hasMentions
         })
       },
-      { signal: _optionalChain([requestOptions, 'optionalAccess', _17 => _17.signal]) }
+      { signal: _optionalChain([requestOptions, 'optionalAccess', _21 => _21.signal]) }
     );
     return result;
   }
@@ -1882,151 +2000,128 @@ function createApiClient({
   }
   async function uploadAttachment(options) {
     const roomId = options.roomId;
-    const abortSignal = options.signal;
     const attachment = options.attachment;
-    const abortError = abortSignal ? new DOMException(
-      `Upload of attachment ${options.attachment.id} was aborted.`,
-      "AbortError"
-    ) : void 0;
-    if (_optionalChain([abortSignal, 'optionalAccess', _18 => _18.aborted])) {
-      throw abortError;
-    }
-    const handleRetryError = (err) => {
-      if (_optionalChain([abortSignal, 'optionalAccess', _19 => _19.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/${encodeURIComponent(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/${encodeURIComponent(attachment.name)}`,
+    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}`,
           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 (_optionalChain([abortSignal, 'optionalAccess', _20 => _20.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 (_optionalChain([abortSignal, 'optionalAccess', _21 => _21.aborted])) {
-          throw abortError;
-        }
-        const sortedUploadedParts = uploadedParts.sort(
-          (a, b) => a.partNumber - b.partNumber
+          })
         );
-        return httpClient.post(
-          url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/complete`,
+      }
+    });
+  }
+  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}`,
           await authManager.getAuthValue({
             roomId,
-            resource: "comments",
+            resource: "storage",
             access: "write"
-          }),
-          { parts: sortedUploadedParts },
-          { signal: abortSignal }
+          })
         );
-      } catch (error3) {
-        if (uploadId && _optionalChain([error3, 'optionalAccess', _22 => _22.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 (e8) {
-          }
-        }
-        throw error3;
       }
-    }
+    });
   }
   const attachmentUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
     const batch2 = new Batch(
@@ -2056,6 +2151,34 @@ 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) => _nullishCoalesce(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`,
@@ -2132,9 +2255,9 @@ function createApiClient({
       })
     );
   }
-  async function getTextVersion(options) {
+  async function getYjsHistoryVersion(options) {
     return httpClient.rawGet(
-      url`/v2/c/rooms/${options.roomId}/y-version/${options.versionId}`,
+      url`/v2/c/rooms/${options.roomId}/versions/${options.versionId}/yjs`,
       await authManager.getAuthValue({
         roomId: options.roomId,
         resource: "storage",
@@ -2142,9 +2265,9 @@ function createApiClient({
       })
     );
   }
-  async function createTextVersion(options) {
+  async function createVersionHistorySnapshot(options) {
     await httpClient.rawPost(
-      url`/v2/c/rooms/${options.roomId}/version`,
+      url`/v2/c/rooms/${options.roomId}/versions`,
       await authManager.getAuthValue({
         roomId: options.roomId,
         resource: "storage",
@@ -2190,7 +2313,7 @@ function createApiClient({
     }
     return result.content[0].text;
   }
-  async function listTextVersions(options) {
+  async function listHistoryVersions(options) {
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/versions`,
       await authManager.getAuthValue({
@@ -2209,7 +2332,7 @@ function createApiClient({
       requestedAt: new Date(result.meta.requestedAt)
     };
   }
-  async function listTextVersionsSince(options) {
+  async function listHistoryVersionsSince(options) {
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/versions/delta`,
       await authManager.getAuthValue({
@@ -2244,14 +2367,14 @@ function createApiClient({
   async function getInboxNotifications(options) {
     const PAGE_SIZE = 50;
     let query;
-    if (_optionalChain([options, 'optionalAccess', _23 => _23.query])) {
+    if (_optionalChain([options, 'optionalAccess', _22 => _22.query])) {
       query = objectToQuery(options.query);
     }
     const json = await httpClient.get(
       url`/v2/c/inbox-notifications`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
-        cursor: _optionalChain([options, 'optionalAccess', _24 => _24.cursor]),
+        cursor: _optionalChain([options, 'optionalAccess', _23 => _23.cursor]),
         limit: PAGE_SIZE,
         query
       }
@@ -2270,7 +2393,7 @@ function createApiClient({
   }
   async function getInboxNotificationsSince(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _25 => _25.query])) {
+    if (_optionalChain([options, 'optionalAccess', _24 => _24.query])) {
       query = objectToQuery(options.query);
     }
     const json = await httpClient.get(
@@ -2299,14 +2422,14 @@ function createApiClient({
   }
   async function getUnreadInboxNotificationsCount(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _26 => _26.query])) {
+    if (_optionalChain([options, 'optionalAccess', _25 => _25.query])) {
       query = objectToQuery(options.query);
     }
     const { count } = await httpClient.get(
       url`/v2/c/inbox-notifications/count`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       { query },
-      { signal: _optionalChain([options, 'optionalAccess', _27 => _27.signal]) }
+      { signal: _optionalChain([options, 'optionalAccess', _26 => _26.signal]) }
     );
     return count;
   }
@@ -2356,7 +2479,7 @@ function createApiClient({
       url`/v2/c/notification-settings`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       void 0,
-      { signal: _optionalChain([options, 'optionalAccess', _28 => _28.signal]) }
+      { signal: _optionalChain([options, 'optionalAccess', _27 => _27.signal]) }
     );
   }
   async function updateNotificationSettings(settings) {
@@ -2368,7 +2491,7 @@ function createApiClient({
   }
   async function getUserThreads_experimental(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _29 => _29.query])) {
+    if (_optionalChain([options, 'optionalAccess', _28 => _28.query])) {
       query = objectToQuery(options.query);
     }
     const PAGE_SIZE = 50;
@@ -2376,7 +2499,7 @@ function createApiClient({
       url`/v2/c/threads`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
-        cursor: _optionalChain([options, 'optionalAccess', _30 => _30.cursor]),
+        cursor: _optionalChain([options, 'optionalAccess', _29 => _29.cursor]),
         query,
         limit: PAGE_SIZE
       }
@@ -2475,15 +2598,19 @@ function createApiClient({
     // Room text editor
     createTextMention,
     deleteTextMention,
-    getTextVersion,
-    createTextVersion,
+    getYjsHistoryVersion,
+    createVersionHistorySnapshot,
     reportTextEditor,
-    listTextVersions,
-    listTextVersionsSince,
+    listHistoryVersions,
+    listHistoryVersionsSince,
     // Room attachments
     getAttachmentUrl,
     uploadAttachment,
     getOrCreateAttachmentUrlsStore,
+    // Room storage files
+    getFileUrl,
+    uploadFile,
+    getOrCreateFileUrlsStore,
     // Room storage
     streamStorage,
     // Notifications
@@ -2549,7 +2676,7 @@ var HttpClient = class {
         // These headers are default, but can be overriden by custom headers
         "Content-Type": "application/json; charset=utf-8",
         // Possible header overrides
-        ..._optionalChain([options, 'optionalAccess', _31 => _31.headers]),
+        ..._optionalChain([options, 'optionalAccess', _30 => _30.headers]),
         // Cannot be overriden by custom headers
         Authorization: `Bearer ${getBearerTokenFromAuthValue(authValue)}`,
         "X-LB-Client": PKG_VERSION || "dev"
@@ -2557,7 +2684,7 @@ var HttpClient = class {
     });
     const xwarn = response.headers.get("X-LB-Warn");
     if (xwarn) {
-      const method = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _32 => _32.method, 'optionalAccess', _33 => _33.toUpperCase, 'call', _34 => _34()]), () => ( "GET"));
+      const method = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _31 => _31.method, 'optionalAccess', _32 => _32.toUpperCase, 'call', _33 => _33()]), () => ( "GET"));
       const msg = `${xwarn} (${method} ${endpoint})`;
       if (response.ok) {
         warn(msg);
@@ -3039,7 +3166,7 @@ var FSM = class {
     });
   }
   #getTargetFn(eventName) {
-    return _optionalChain([this, 'access', _35 => _35.#allowedTransitions, 'access', _36 => _36.get, 'call', _37 => _37(this.currentState), 'optionalAccess', _38 => _38.get, 'call', _39 => _39(eventName)]);
+    return _optionalChain([this, 'access', _34 => _34.#allowedTransitions, 'access', _35 => _35.get, 'call', _36 => _36(this.currentState), 'optionalAccess', _37 => _37.get, 'call', _38 => _38(eventName)]);
   }
   /**
    * Exits the current state, and executes any necessary cleanup functions.
@@ -3058,7 +3185,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       levels = _nullishCoalesce(levels, () => ( this.#cleanupStack.length));
       for (let i = 0; i < levels; i++) {
-        _optionalChain([this, 'access', _40 => _40.#cleanupStack, 'access', _41 => _41.pop, 'call', _42 => _42(), 'optionalCall', _43 => _43(patchableContext)]);
+        _optionalChain([this, 'access', _39 => _39.#cleanupStack, 'access', _40 => _40.pop, 'call', _41 => _41(), 'optionalCall', _42 => _42(patchableContext)]);
         const entryTime = this.#entryTimesStack.pop();
         if (entryTime !== void 0 && // ...but avoid computing state names if nobody is listening
         this.#eventHub.didExitState.count() > 0) {
@@ -3086,7 +3213,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       for (const pattern of enterPatterns) {
         const enterFn = this.#enterFns.get(pattern);
-        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _44 => _44(patchableContext)]);
+        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _43 => _43(patchableContext)]);
         if (typeof cleanupFn === "function") {
           this.#cleanupStack.push(cleanupFn);
         } else {
@@ -3513,7 +3640,7 @@ function createConnectionStateMachine(delegates, options) {
           }
           function waitForActorId(event) {
             const serverMsg = tryParseJson(event.data);
-            if (_optionalChain([serverMsg, 'optionalAccess', _45 => _45.type]) === ServerMsgCode.ROOM_STATE) {
+            if (_optionalChain([serverMsg, 'optionalAccess', _44 => _44.type]) === ServerMsgCode.ROOM_STATE) {
               if (options.enableDebugLogging && socketOpenAt !== null) {
                 const elapsed = performance.now() - socketOpenAt;
                 warn(
@@ -3641,12 +3768,12 @@ function createConnectionStateMachine(delegates, options) {
   const sendHeartbeat = {
     target: "@ok.awaiting-pong",
     effect: (ctx) => {
-      _optionalChain([ctx, 'access', _46 => _46.socket, 'optionalAccess', _47 => _47.send, 'call', _48 => _48("ping")]);
+      _optionalChain([ctx, 'access', _45 => _45.socket, 'optionalAccess', _46 => _46.send, 'call', _47 => _47("ping")]);
     }
   };
   const maybeHeartbeat = () => {
     const doc = typeof document !== "undefined" ? document : void 0;
-    const canZombie = _optionalChain([doc, 'optionalAccess', _49 => _49.visibilityState]) === "hidden" && delegates.canZombie();
+    const canZombie = _optionalChain([doc, 'optionalAccess', _48 => _48.visibilityState]) === "hidden" && delegates.canZombie();
     return canZombie ? "@idle.zombie" : sendHeartbeat;
   };
   machine.addTimedTransition("@ok.connected", HEARTBEAT_INTERVAL, maybeHeartbeat).addTransitions("@ok.connected", {
@@ -3686,7 +3813,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', _50 => _50.socket, 'optionalAccess', _51 => _51.readyState]) === 1) {
+      if (_optionalChain([context, 'access', _49 => _49.socket, 'optionalAccess', _50 => _50.readyState]) === 1) {
         return IGNORE;
       }
       return {
@@ -3738,17 +3865,17 @@ function createConnectionStateMachine(delegates, options) {
         machine.send({ type: "NAVIGATOR_ONLINE" });
       }
       function onVisibilityChange() {
-        if (_optionalChain([doc, 'optionalAccess', _52 => _52.visibilityState]) === "visible") {
+        if (_optionalChain([doc, 'optionalAccess', _51 => _51.visibilityState]) === "visible") {
           machine.send({ type: "WINDOW_GOT_FOCUS" });
         }
       }
-      _optionalChain([win, 'optionalAccess', _53 => _53.addEventListener, 'call', _54 => _54("online", onNetworkBackOnline)]);
-      _optionalChain([win, 'optionalAccess', _55 => _55.addEventListener, 'call', _56 => _56("offline", onNetworkOffline)]);
-      _optionalChain([root, 'optionalAccess', _57 => _57.addEventListener, 'call', _58 => _58("visibilitychange", onVisibilityChange)]);
+      _optionalChain([win, 'optionalAccess', _52 => _52.addEventListener, 'call', _53 => _53("online", onNetworkBackOnline)]);
+      _optionalChain([win, 'optionalAccess', _54 => _54.addEventListener, 'call', _55 => _55("offline", onNetworkOffline)]);
+      _optionalChain([root, 'optionalAccess', _56 => _56.addEventListener, 'call', _57 => _57("visibilitychange", onVisibilityChange)]);
       return () => {
-        _optionalChain([root, 'optionalAccess', _59 => _59.removeEventListener, 'call', _60 => _60("visibilitychange", onVisibilityChange)]);
-        _optionalChain([win, 'optionalAccess', _61 => _61.removeEventListener, 'call', _62 => _62("online", onNetworkBackOnline)]);
-        _optionalChain([win, 'optionalAccess', _63 => _63.removeEventListener, 'call', _64 => _64("offline", onNetworkOffline)]);
+        _optionalChain([root, 'optionalAccess', _58 => _58.removeEventListener, 'call', _59 => _59("visibilitychange", onVisibilityChange)]);
+        _optionalChain([win, 'optionalAccess', _60 => _60.removeEventListener, 'call', _61 => _61("online", onNetworkBackOnline)]);
+        _optionalChain([win, 'optionalAccess', _62 => _62.removeEventListener, 'call', _63 => _63("offline", onNetworkOffline)]);
         teardownSocket(ctx.socket);
       };
     });
@@ -3837,7 +3964,7 @@ var ManagedSocket = class {
    * message if this is somehow impossible.
    */
   send(data) {
-    const socket = _optionalChain([this, 'access', _65 => _65.#machine, 'access', _66 => _66.context, 'optionalAccess', _67 => _67.socket]);
+    const socket = _optionalChain([this, 'access', _64 => _64.#machine, 'access', _65 => _65.context, 'optionalAccess', _66 => _66.socket]);
     if (socket === null) {
       warn("Cannot send: not connected yet", data);
     } else if (socket.readyState !== 1) {
@@ -4299,7 +4426,7 @@ function createStore_forKnowledge() {
   }
   function getKnowledgeForChat(chatId) {
     const globalKnowledge = knowledgeByChatId.getOrCreate(kWILDCARD).get();
-    const scopedKnowledge = _nullishCoalesce(_optionalChain([knowledgeByChatId, 'access', _68 => _68.get, 'call', _69 => _69(chatId), 'optionalAccess', _70 => _70.get, 'call', _71 => _71()]), () => ( []));
+    const scopedKnowledge = _nullishCoalesce(_optionalChain([knowledgeByChatId, 'access', _67 => _67.get, 'call', _68 => _68(chatId), 'optionalAccess', _69 => _69.get, 'call', _70 => _70()]), () => ( []));
     return [...globalKnowledge, ...scopedKnowledge];
   }
   return {
@@ -4324,7 +4451,7 @@ function createStore_forTools() {
     return DerivedSignal.from(() => {
       return (
         // A tool that's registered and scoped to a specific chat ID...
-        _nullishCoalesce(_optionalChain([(chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0), 'optionalAccess', _72 => _72.get, 'call', _73 => _73()]), () => ( // ...or a globally registered tool
+        _nullishCoalesce(_optionalChain([(chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0), 'optionalAccess', _71 => _71.get, 'call', _72 => _72()]), () => ( // ...or a globally registered tool
         toolsByChatId\u03A3.getOrCreate(kWILDCARD).getOrCreate(name).get()))
       );
     });
@@ -4354,8 +4481,8 @@ function createStore_forTools() {
     const globalTools\u03A3 = toolsByChatId\u03A3.get(kWILDCARD);
     const scopedTools\u03A3 = toolsByChatId\u03A3.get(chatId);
     return Array.from([
-      ..._nullishCoalesce(_optionalChain([globalTools\u03A3, 'optionalAccess', _74 => _74.entries, 'call', _75 => _75()]), () => ( [])),
-      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _76 => _76.entries, 'call', _77 => _77()]), () => ( []))
+      ..._nullishCoalesce(_optionalChain([globalTools\u03A3, 'optionalAccess', _73 => _73.entries, 'call', _74 => _74()]), () => ( [])),
+      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _75 => _75.entries, 'call', _76 => _76()]), () => ( []))
     ]).flatMap(([name, tool\u03A3]) => {
       const tool = tool\u03A3.get();
       return tool && (_nullishCoalesce(tool.enabled, () => ( true))) ? [{ name, description: tool.description, parameters: tool.parameters }] : [];
@@ -4458,7 +4585,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
             } else {
               continue;
             }
-            const executeFn = _optionalChain([toolsStore, 'access', _78 => _78.getTool\u03A3, 'call', _79 => _79(toolInvocation.name, message.chatId), 'access', _80 => _80.get, 'call', _81 => _81(), 'optionalAccess', _82 => _82.execute]);
+            const executeFn = _optionalChain([toolsStore, 'access', _77 => _77.getTool\u03A3, 'call', _78 => _78(toolInvocation.name, message.chatId), 'access', _79 => _79.get, 'call', _80 => _80(), 'optionalAccess', _81 => _81.execute]);
             if (executeFn) {
               (async () => {
                 const result = await executeFn(toolInvocation.args, {
@@ -4557,8 +4684,8 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
       const spine = [];
       let lastVisitedMessage = null;
       for (const message2 of pool.walkUp(leaf.id)) {
-        const prev = _nullishCoalesce(_optionalChain([first, 'call', _83 => _83(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _84 => _84.id]), () => ( null));
-        const next = _nullishCoalesce(_optionalChain([first, 'call', _85 => _85(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _86 => _86.id]), () => ( null));
+        const prev = _nullishCoalesce(_optionalChain([first, 'call', _82 => _82(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _83 => _83.id]), () => ( null));
+        const next = _nullishCoalesce(_optionalChain([first, 'call', _84 => _84(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _85 => _85.id]), () => ( null));
         if (!message2.deletedAt || prev || next) {
           const node = {
             ...message2,
@@ -4624,7 +4751,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     const latest = pool.sorted.findRight(
       (m) => m.role === "assistant" && !m.deletedAt
     );
-    return _optionalChain([latest, 'optionalAccess', _87 => _87.copilotId]);
+    return _optionalChain([latest, 'optionalAccess', _86 => _86.copilotId]);
   }
   return {
     // Readers
@@ -4655,11 +4782,11 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     *getAutoExecutingMessageIds() {
       for (const messageId of myMessages) {
         const message = getMessageById(messageId);
-        if (_optionalChain([message, 'optionalAccess', _88 => _88.role]) === "assistant" && message.status === "awaiting-tool") {
+        if (_optionalChain([message, 'optionalAccess', _87 => _87.role]) === "assistant" && message.status === "awaiting-tool") {
           const isAutoExecuting = message.contentSoFar.some((part) => {
             if (part.type === "tool-invocation" && part.stage === "executing") {
               const tool = toolsStore.getTool\u03A3(part.name, message.chatId).get();
-              return typeof _optionalChain([tool, 'optionalAccess', _89 => _89.execute]) === "function";
+              return typeof _optionalChain([tool, 'optionalAccess', _88 => _88.execute]) === "function";
             }
             return false;
           });
@@ -4807,7 +4934,7 @@ function createAi(config) {
           flushPendingDeltas();
           switch (msg.event) {
             case "cmd-failed":
-              _optionalChain([pendingCmd, 'optionalAccess', _90 => _90.reject, 'call', _91 => _91(new Error(msg.error))]);
+              _optionalChain([pendingCmd, 'optionalAccess', _89 => _89.reject, 'call', _90 => _90(new Error(msg.error))]);
               break;
             case "settle": {
               context.messagesStore.upsert(msg.message);
@@ -4884,7 +5011,7 @@ function createAi(config) {
           return assertNever(msg, "Unhandled case");
       }
     }
-    _optionalChain([pendingCmd, 'optionalAccess', _92 => _92.resolve, 'call', _93 => _93(msg)]);
+    _optionalChain([pendingCmd, 'optionalAccess', _91 => _91.resolve, 'call', _92 => _92(msg)]);
   }
   managedSocket.events.onMessage.subscribe(handleServerMessage);
   managedSocket.events.statusDidChange.subscribe(onStatusDidChange);
@@ -4960,9 +5087,9 @@ function createAi(config) {
       invocationId,
       result,
       generationOptions: {
-        copilotId: _optionalChain([options, 'optionalAccess', _94 => _94.copilotId]),
-        stream: _optionalChain([options, 'optionalAccess', _95 => _95.stream]),
-        timeout: _optionalChain([options, 'optionalAccess', _96 => _96.timeout]),
+        copilotId: _optionalChain([options, 'optionalAccess', _93 => _93.copilotId]),
+        stream: _optionalChain([options, 'optionalAccess', _94 => _94.stream]),
+        timeout: _optionalChain([options, 'optionalAccess', _95 => _95.timeout]),
         // Knowledge and tools aren't coming from the options, but retrieved
         // from the global context
         knowledge: knowledge.length > 0 ? knowledge : void 0,
@@ -4980,7 +5107,7 @@ function createAi(config) {
     }
   }
   const win = typeof window !== "undefined" ? window : void 0;
-  _optionalChain([win, 'optionalAccess', _97 => _97.addEventListener, 'call', _98 => _98("beforeunload", handleBeforeUnload, { once: true })]);
+  _optionalChain([win, 'optionalAccess', _96 => _96.addEventListener, 'call', _97 => _97("beforeunload", handleBeforeUnload, { once: true })]);
   return Object.defineProperty(
     {
       [kInternal]: {
@@ -4999,7 +5126,7 @@ function createAi(config) {
       clearChat: (chatId) => sendClientMsgWithResponse({ cmd: "clear-chat", chatId }),
       askUserMessageInChat: async (chatId, userMessage, targetMessageId, options) => {
         const knowledge = context.knowledgeStore.getKnowledgeForChat(chatId);
-        const requestKnowledge = _optionalChain([options, 'optionalAccess', _99 => _99.knowledge]) || [];
+        const requestKnowledge = _optionalChain([options, 'optionalAccess', _98 => _98.knowledge]) || [];
         const combinedKnowledge = [...knowledge, ...requestKnowledge];
         const tools = context.toolsStore.getToolDescriptions(chatId);
         messagesStore.markMine(targetMessageId);
@@ -5009,9 +5136,9 @@ function createAi(config) {
           sourceMessage: userMessage,
           targetMessageId,
           generationOptions: {
-            copilotId: _optionalChain([options, 'optionalAccess', _100 => _100.copilotId]),
-            stream: _optionalChain([options, 'optionalAccess', _101 => _101.stream]),
-            timeout: _optionalChain([options, 'optionalAccess', _102 => _102.timeout]),
+            copilotId: _optionalChain([options, 'optionalAccess', _99 => _99.copilotId]),
+            stream: _optionalChain([options, 'optionalAccess', _100 => _100.stream]),
+            timeout: _optionalChain([options, 'optionalAccess', _101 => _101.timeout]),
             // Combine global knowledge with request-specific knowledge
             knowledge: combinedKnowledge.length > 0 ? combinedKnowledge : void 0,
             tools: tools.length > 0 ? tools : void 0
@@ -5083,7 +5210,7 @@ function replaceOrAppend(content, newItem, keyFn, now2) {
   }
 }
 function closePart(prevPart, endedAt) {
-  if (_optionalChain([prevPart, 'optionalAccess', _103 => _103.type]) === "reasoning") {
+  if (_optionalChain([prevPart, 'optionalAccess', _102 => _102.type]) === "reasoning") {
     prevPart.endedAt ??= endedAt;
   }
 }
@@ -5098,7 +5225,7 @@ function patchContentWithDelta(content, delta) {
   const lastPart = parts[parts.length - 1];
   switch (delta.type) {
     case "text-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _104 => _104.type]) === "text") {
+      if (_optionalChain([lastPart, 'optionalAccess', _103 => _103.type]) === "text") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
@@ -5106,7 +5233,7 @@ function patchContentWithDelta(content, delta) {
       }
       break;
     case "reasoning-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _105 => _105.type]) === "reasoning") {
+      if (_optionalChain([lastPart, 'optionalAccess', _104 => _104.type]) === "reasoning") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
@@ -5126,8 +5253,8 @@ function patchContentWithDelta(content, delta) {
       break;
     }
     case "tool-delta": {
-      if (_optionalChain([lastPart, 'optionalAccess', _106 => _106.type]) === "tool-invocation" && lastPart.stage === "receiving") {
-        _optionalChain([lastPart, 'access', _107 => _107.__appendDelta, 'optionalCall', _108 => _108(delta.delta)]);
+      if (_optionalChain([lastPart, 'optionalAccess', _105 => _105.type]) === "tool-invocation" && lastPart.stage === "receiving") {
+        _optionalChain([lastPart, 'access', _106 => _106.__appendDelta, 'optionalCall', _107 => _107(delta.delta)]);
       }
       break;
     }
@@ -5482,7 +5609,7 @@ function explicitAccessForResource(source, resource) {
 }
 function permissionForAccessLevel(resource, access, field = resource) {
   const permissions = PERMISSIONS_BY_RESOURCE[resource][access];
-  const permission = _optionalChain([permissions, 'optionalAccess', _109 => _109[0]]);
+  const permission = _optionalChain([permissions, 'optionalAccess', _108 => _108[0]]);
   if (permission !== void 0) {
     return permission;
   }
@@ -5592,7 +5719,7 @@ function createAuthManager(authOptions, onAuthenticate) {
     return void 0;
   }
   async function makeAuthRequest(options) {
-    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _110 => _110.polyfills, 'optionalAccess', _111 => _111.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
+    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _109 => _109.polyfills, 'optionalAccess', _110 => _110.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
     if (authentication.type === "private") {
       if (fetcher === void 0) {
         throw new StopRetrying(
@@ -5605,14 +5732,14 @@ function createAuthManager(authOptions, onAuthenticate) {
       const parsed = parseAuthToken(response.token);
       if (seenTokens.has(parsed.raw)) {
         const cachedToken = getCachedToken(options);
-        if (_optionalChain([cachedToken, 'optionalAccess', _112 => _112.raw]) === parsed.raw) {
+        if (_optionalChain([cachedToken, 'optionalAccess', _111 => _111.raw]) === parsed.raw) {
           return cachedToken;
         }
         throw new StopRetrying(
           "The same Liveblocks auth token was issued from the backend before. Caching Liveblocks tokens is not supported."
         );
       }
-      _optionalChain([onAuthenticate, 'optionalCall', _113 => _113(parsed.parsed)]);
+      _optionalChain([onAuthenticate, 'optionalCall', _112 => _112(parsed.parsed)]);
       return parsed;
     }
     if (authentication.type === "custom") {
@@ -5620,7 +5747,7 @@ function createAuthManager(authOptions, onAuthenticate) {
       if (response && typeof response === "object") {
         if (typeof response.token === "string") {
           const parsed = parseAuthToken(response.token);
-          _optionalChain([onAuthenticate, 'optionalCall', _114 => _114(parsed.parsed)]);
+          _optionalChain([onAuthenticate, 'optionalCall', _113 => _113(parsed.parsed)]);
           return parsed;
         } else if (typeof response.error === "string") {
           const reason = `Authentication failed: ${"reason" in response && typeof response.reason === "string" ? response.reason : "Forbidden"}`;
@@ -5815,13 +5942,15 @@ var OpCode = Object.freeze({
   DELETE_CRDT: 5,
   DELETE_OBJECT_KEY: 6,
   CREATE_MAP: 7,
-  CREATE_REGISTER: 8
+  CREATE_REGISTER: 8,
+  // 9 and 10 are reserved for the parallel LiveText work.
+  CREATE_FILE: 11
 });
 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_MAP || op.type === OpCode.CREATE_LIST;
+  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;
 }
 
 // src/protocol/StorageNode.ts
@@ -5829,7 +5958,9 @@ var CrdtType = Object.freeze({
   OBJECT: 0,
   LIST: 1,
   MAP: 2,
-  REGISTER: 3
+  REGISTER: 3,
+  // 4 is reserved for the parallel LiveText work.
+  FILE: 5
 });
 function isRootStorageNode(node) {
   return node[0] === "root";
@@ -5846,6 +5977,9 @@ 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";
 }
@@ -5868,6 +6002,9 @@ 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:
     }
   }
@@ -5896,6 +6033,10 @@ 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 {
     }
   }
@@ -6134,12 +6275,12 @@ ${parentKey}`;
     if (isCreateOp(op)) {
       const posKey = this.#posKey(op.parentId, op.parentKey);
       const atPosition = this.#createOpsByPosition.get(posKey);
-      _optionalChain([atPosition, 'optionalAccess', _115 => _115.delete, 'call', _116 => _116(opId)]);
+      _optionalChain([atPosition, 'optionalAccess', _114 => _114.delete, 'call', _115 => _115(opId)]);
       if (atPosition !== void 0 && atPosition.size === 0) {
         this.#createOpsByPosition.delete(posKey);
       }
       const inParent = this.#createOpsByParent.get(op.parentId);
-      _optionalChain([inParent, 'optionalAccess', _117 => _117.delete, 'call', _118 => _118(opId)]);
+      _optionalChain([inParent, 'optionalAccess', _116 => _116.delete, 'call', _117 => _117(opId)]);
       if (inParent !== void 0 && inParent.size === 0) {
         this.#createOpsByParent.delete(op.parentId);
       }
@@ -6151,14 +6292,14 @@ ${parentKey}`;
    * Empty if none.
    */
   getByParentIdAndKey(parentId, parentKey) {
-    return _nullishCoalesce(_optionalChain([this, 'access', _119 => _119.#createOpsByPosition, 'access', _120 => _120.get, 'call', _121 => _121(this.#posKey(parentId, parentKey)), 'optionalAccess', _122 => _122.values, 'call', _123 => _123()]), () => ( []));
+    return _nullishCoalesce(_optionalChain([this, 'access', _118 => _118.#createOpsByPosition, 'access', _119 => _119.get, 'call', _120 => _120(this.#posKey(parentId, parentKey)), 'optionalAccess', _121 => _121.values, 'call', _122 => _122()]), () => ( []));
   }
   /**
    * The still-unacknowledged Create ops with the given `parentId` (across all
    * positions), in dispatch order. O(1) lookup. Empty if none.
    */
   getByParentId(parentId) {
-    return _nullishCoalesce(_optionalChain([this, 'access', _124 => _124.#createOpsByParent, 'access', _125 => _125.get, 'call', _126 => _126(parentId), 'optionalAccess', _127 => _127.values, 'call', _128 => _128()]), () => ( []));
+    return _nullishCoalesce(_optionalChain([this, 'access', _123 => _123.#createOpsByParent, 'access', _124 => _124.get, 'call', _125 => _125(parentId), 'optionalAccess', _126 => _126.values, 'call', _127 => _127()]), () => ( []));
   }
   /** All still-unacknowledged ops, in dispatch order. */
   values() {
@@ -6199,7 +6340,7 @@ function createManagedPool(roomId, options) {
     generateId: () => `${getCurrentConnectionId()}:${clock++}`,
     generateOpId: () => `${getCurrentConnectionId()}:${opClock++}`,
     dispatch(ops, reverse, storageUpdates) {
-      _optionalChain([onDispatch, 'optionalCall', _129 => _129(ops, reverse, storageUpdates)]);
+      _optionalChain([onDispatch, 'optionalCall', _128 => _128(ops, reverse, storageUpdates)]);
     },
     assertStorageIsWritable: () => {
       if (!isStorageWritable()) {
@@ -6408,6 +6549,91 @@ 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: _nullishCoalesce(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;
@@ -6923,7 +7149,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applyInsertUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _130 => _130._pool, 'optionalAccess', _131 => _131.getNode, 'call', _132 => _132(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _129 => _129._pool, 'optionalAccess', _130 => _130.getNode, 'call', _131 => _131(id)]) !== void 0) {
       return { modified: false };
     }
     child._attach(id, nn(this._pool));
@@ -6931,8 +7157,8 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const existingItemIndex = this._indexOfPosition(key);
     let newKey = key;
     if (existingItemIndex !== -1) {
-      const before2 = _optionalChain([this, 'access', _133 => _133.#items, 'access', _134 => _134.at, 'call', _135 => _135(existingItemIndex), 'optionalAccess', _136 => _136._parentPos]);
-      const after2 = _optionalChain([this, 'access', _137 => _137.#items, 'access', _138 => _138.at, 'call', _139 => _139(existingItemIndex + 1), 'optionalAccess', _140 => _140._parentPos]);
+      const before2 = _optionalChain([this, 'access', _132 => _132.#items, 'access', _133 => _133.at, 'call', _134 => _134(existingItemIndex), 'optionalAccess', _135 => _135._parentPos]);
+      const after2 = _optionalChain([this, 'access', _136 => _136.#items, 'access', _137 => _137.at, 'call', _138 => _138(existingItemIndex + 1), 'optionalAccess', _139 => _139._parentPos]);
       newKey = makePosition(before2, after2);
       child._setParentLink(this, newKey);
     }
@@ -6946,7 +7172,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applySetUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _141 => _141._pool, 'optionalAccess', _142 => _142.getNode, 'call', _143 => _143(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _140 => _140._pool, 'optionalAccess', _141 => _141.getNode, 'call', _142 => _142(id)]) !== void 0) {
       return { modified: false };
     }
     const indexOfItemWithSameKey = this._indexOfPosition(key);
@@ -7067,7 +7293,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     } else {
       this.#updateItemPositionAt(
         existingItemIndex,
-        makePosition(newKey, _optionalChain([this, 'access', _144 => _144.#items, 'access', _145 => _145.at, 'call', _146 => _146(existingItemIndex + 1), 'optionalAccess', _147 => _147._parentPos]))
+        makePosition(newKey, _optionalChain([this, 'access', _143 => _143.#items, 'access', _144 => _144.at, 'call', _145 => _145(existingItemIndex + 1), 'optionalAccess', _146 => _146._parentPos]))
       );
       const previousIndex = this.#items.findIndex((item) => item === child);
       this.#updateItemPosition(child, newKey);
@@ -7094,7 +7320,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
           this,
           makePosition(
             newKey,
-            _optionalChain([this, 'access', _148 => _148.#items, 'access', _149 => _149.at, 'call', _150 => _150(existingItemIndex + 1), 'optionalAccess', _151 => _151._parentPos])
+            _optionalChain([this, 'access', _147 => _147.#items, 'access', _148 => _148.at, 'call', _149 => _149(existingItemIndex + 1), 'optionalAccess', _150 => _150._parentPos])
           )
         );
         this.#items.reposition(existingItem);
@@ -7118,7 +7344,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
           existingItemIndex,
           makePosition(
             newKey,
-            _optionalChain([this, 'access', _152 => _152.#items, 'access', _153 => _153.at, 'call', _154 => _154(existingItemIndex + 1), 'optionalAccess', _155 => _155._parentPos])
+            _optionalChain([this, 'access', _151 => _151.#items, 'access', _152 => _152.at, 'call', _153 => _153(existingItemIndex + 1), 'optionalAccess', _154 => _154._parentPos])
           )
         );
       }
@@ -7146,7 +7372,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     if (existingItemIndex !== -1) {
       actualNewKey = makePosition(
         newKey,
-        _optionalChain([this, 'access', _156 => _156.#items, 'access', _157 => _157.at, 'call', _158 => _158(existingItemIndex + 1), 'optionalAccess', _159 => _159._parentPos])
+        _optionalChain([this, 'access', _155 => _155.#items, 'access', _156 => _156.at, 'call', _157 => _157(existingItemIndex + 1), 'optionalAccess', _158 => _158._parentPos])
       );
     }
     this.#updateItemPosition(child, actualNewKey);
@@ -7220,14 +7446,14 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * instead of resolving its position against the client's stale view.
    */
   #injectAt(element, index, intent) {
-    _optionalChain([this, 'access', _160 => _160._pool, 'optionalAccess', _161 => _161.assertStorageIsWritable, 'call', _162 => _162()]);
+    _optionalChain([this, 'access', _159 => _159._pool, 'optionalAccess', _160 => _160.assertStorageIsWritable, 'call', _161 => _161()]);
     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}`
       );
     }
-    const before2 = _optionalChain([this, 'access', _163 => _163.#items, 'access', _164 => _164.at, 'call', _165 => _165(index - 1), 'optionalAccess', _166 => _166._parentPos]);
-    const after2 = _optionalChain([this, 'access', _167 => _167.#items, 'access', _168 => _168.at, 'call', _169 => _169(index), 'optionalAccess', _170 => _170._parentPos]);
+    const before2 = _optionalChain([this, 'access', _162 => _162.#items, 'access', _163 => _163.at, 'call', _164 => _164(index - 1), 'optionalAccess', _165 => _165._parentPos]);
+    const after2 = _optionalChain([this, 'access', _166 => _166.#items, 'access', _167 => _167.at, 'call', _168 => _168(index), 'optionalAccess', _169 => _169._parentPos]);
     const position = makePosition(before2, after2);
     const value = lsonToLiveNode(element);
     value._setParentLink(this, position);
@@ -7251,7 +7477,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param targetIndex The index where the element should be after moving.
    */
   move(index, targetIndex) {
-    _optionalChain([this, 'access', _171 => _171._pool, 'optionalAccess', _172 => _172.assertStorageIsWritable, 'call', _173 => _173()]);
+    _optionalChain([this, 'access', _170 => _170._pool, 'optionalAccess', _171 => _171.assertStorageIsWritable, 'call', _172 => _172()]);
     if (targetIndex < 0) {
       throw new Error("targetIndex cannot be less than 0");
     }
@@ -7269,11 +7495,11 @@ var LiveList = class _LiveList extends AbstractCrdt {
     let beforePosition = null;
     let afterPosition = null;
     if (index < targetIndex) {
-      afterPosition = targetIndex === this.#items.length - 1 ? void 0 : _optionalChain([this, 'access', _174 => _174.#items, 'access', _175 => _175.at, 'call', _176 => _176(targetIndex + 1), 'optionalAccess', _177 => _177._parentPos]);
+      afterPosition = targetIndex === this.#items.length - 1 ? void 0 : _optionalChain([this, 'access', _173 => _173.#items, 'access', _174 => _174.at, 'call', _175 => _175(targetIndex + 1), 'optionalAccess', _176 => _176._parentPos]);
       beforePosition = this.#items.at(targetIndex)._parentPos;
     } else {
       afterPosition = this.#items.at(targetIndex)._parentPos;
-      beforePosition = targetIndex === 0 ? void 0 : _optionalChain([this, 'access', _178 => _178.#items, 'access', _179 => _179.at, 'call', _180 => _180(targetIndex - 1), 'optionalAccess', _181 => _181._parentPos]);
+      beforePosition = targetIndex === 0 ? void 0 : _optionalChain([this, 'access', _177 => _177.#items, 'access', _178 => _178.at, 'call', _179 => _179(targetIndex - 1), 'optionalAccess', _180 => _180._parentPos]);
     }
     const position = makePosition(beforePosition, afterPosition);
     const item = this.#items.at(index);
@@ -7308,7 +7534,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index of the element to delete
    */
   delete(index) {
-    _optionalChain([this, 'access', _182 => _182._pool, 'optionalAccess', _183 => _183.assertStorageIsWritable, 'call', _184 => _184()]);
+    _optionalChain([this, 'access', _181 => _181._pool, 'optionalAccess', _182 => _182.assertStorageIsWritable, 'call', _183 => _183()]);
     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}`
@@ -7341,7 +7567,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   clear() {
-    _optionalChain([this, 'access', _185 => _185._pool, 'optionalAccess', _186 => _186.assertStorageIsWritable, 'call', _187 => _187()]);
+    _optionalChain([this, 'access', _184 => _184._pool, 'optionalAccess', _185 => _185.assertStorageIsWritable, 'call', _186 => _186()]);
     if (this._pool) {
       const ops = [];
       const reverseOps = [];
@@ -7375,7 +7601,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   set(index, item) {
-    _optionalChain([this, 'access', _188 => _188._pool, 'optionalAccess', _189 => _189.assertStorageIsWritable, 'call', _190 => _190()]);
+    _optionalChain([this, 'access', _187 => _187._pool, 'optionalAccess', _188 => _188.assertStorageIsWritable, 'call', _189 => _189()]);
     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}`
@@ -7534,7 +7760,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #shiftItemPosition(index, key) {
     const shiftedPosition = makePosition(
       key,
-      this.#items.length > index + 1 ? _optionalChain([this, 'access', _191 => _191.#items, 'access', _192 => _192.at, 'call', _193 => _193(index + 1), 'optionalAccess', _194 => _194._parentPos]) : void 0
+      this.#items.length > index + 1 ? _optionalChain([this, 'access', _190 => _190.#items, 'access', _191 => _191.at, 'call', _192 => _192(index + 1), 'optionalAccess', _193 => _193._parentPos]) : void 0
     );
     this.#updateItemPositionAt(index, shiftedPosition);
   }
@@ -7783,7 +8009,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', _195 => _195._pool, 'optionalAccess', _196 => _196.assertStorageIsWritable, 'call', _197 => _197()]);
+    _optionalChain([this, 'access', _194 => _194._pool, 'optionalAccess', _195 => _195.assertStorageIsWritable, 'call', _196 => _196()]);
     const oldValue = this.#map.get(key);
     if (oldValue) {
       oldValue._detach();
@@ -7829,7 +8055,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', _198 => _198._pool, 'optionalAccess', _199 => _199.assertStorageIsWritable, 'call', _200 => _200()]);
+    _optionalChain([this, 'access', _197 => _197._pool, 'optionalAccess', _198 => _198.assertStorageIsWritable, 'call', _199 => _199()]);
     const item = this.#map.get(key);
     if (item === void 0) {
       return false;
@@ -8441,20 +8667,20 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * Caveat: this method will not add changes to the undo/redo stack.
    */
   setLocal(key, value) {
-    _optionalChain([this, 'access', _201 => _201._pool, 'optionalAccess', _202 => _202.assertStorageIsWritable, 'call', _203 => _203()]);
+    _optionalChain([this, 'access', _200 => _200._pool, 'optionalAccess', _201 => _201.assertStorageIsWritable, 'call', _202 => _202()]);
     const deleteResult = this.#prepareDelete(key);
     this.#local.set(key, value);
     this.invalidate();
     if (this._pool !== void 0 && this._id !== void 0) {
-      const ops = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _204 => _204[0]]), () => ( []));
-      const reverse = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _205 => _205[1]]), () => ( []));
-      const storageUpdates = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _206 => _206[2]]), () => ( /* @__PURE__ */ new Map()));
+      const ops = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _203 => _203[0]]), () => ( []));
+      const reverse = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _204 => _204[1]]), () => ( []));
+      const storageUpdates = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _205 => _205[2]]), () => ( /* @__PURE__ */ new Map()));
       const existing = storageUpdates.get(this._id);
       storageUpdates.set(this._id, {
         node: this,
         type: "LiveObject",
         updates: {
-          ..._optionalChain([existing, 'optionalAccess', _207 => _207.updates]),
+          ..._optionalChain([existing, 'optionalAccess', _206 => _206.updates]),
           [key]: { type: "update" }
         }
       });
@@ -8474,7 +8700,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * #synced or pool/id are unavailable. Does NOT dispatch.
    */
   #prepareDelete(key) {
-    _optionalChain([this, 'access', _208 => _208._pool, 'optionalAccess', _209 => _209.assertStorageIsWritable, 'call', _210 => _210()]);
+    _optionalChain([this, 'access', _207 => _207._pool, 'optionalAccess', _208 => _208.assertStorageIsWritable, 'call', _209 => _209()]);
     const k = key;
     if (this.#local.has(k) && !this.#synced.has(k)) {
       const oldValue2 = this.#local.get(k);
@@ -8550,7 +8776,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
     const result = this.#prepareDelete(key);
     if (result) {
       const [ops, reverse, storageUpdates] = result;
-      _optionalChain([this, 'access', _211 => _211._pool, 'optionalAccess', _212 => _212.dispatch, 'call', _213 => _213(ops, reverse, storageUpdates)]);
+      _optionalChain([this, 'access', _210 => _210._pool, 'optionalAccess', _211 => _211.dispatch, 'call', _212 => _212(ops, reverse, storageUpdates)]);
     }
   }
   /**
@@ -8558,7 +8784,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * @param patch The object used to overrides properties
    */
   update(patch) {
-    _optionalChain([this, 'access', _214 => _214._pool, 'optionalAccess', _215 => _215.assertStorageIsWritable, 'call', _216 => _216()]);
+    _optionalChain([this, 'access', _213 => _213._pool, 'optionalAccess', _214 => _214.assertStorageIsWritable, 'call', _215 => _215()]);
     if (_LiveObject.detectLargeObjects) {
       const data = {};
       for (const [key, value] of this.#synced) {
@@ -8764,6 +8990,8 @@ 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:
@@ -8794,6 +9022,8 @@ 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");
   }
@@ -8807,12 +9037,14 @@ 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);
+  return isLiveList(value) || isLiveMap(value) || isLiveObject(value) || isLiveFile(value);
 }
 function isLiveNode(value) {
   return isLiveStructure(value) || isLiveRegister(value);
@@ -8826,6 +9058,9 @@ function isLiveMap(value) {
 function isLiveObject(value) {
   return value instanceof LiveObject;
 }
+function isLiveFile(value) {
+  return value instanceof LiveFile;
+}
 function isLiveRegister(value) {
   return value instanceof LiveRegister;
 }
@@ -8835,14 +9070,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) {
+  } else if (obj instanceof LiveList || obj instanceof LiveMap || obj instanceof LiveObject || obj instanceof LiveFile) {
     return obj;
   } else {
     return assertNever(obj, "Unknown AbstractCrdt");
   }
 }
 function lsonToLiveNode(value) {
-  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList) {
+  if (value instanceof LiveObject || value instanceof LiveMap || value instanceof LiveList || value instanceof LiveFile) {
     return value;
   } else {
     return new LiveRegister(value);
@@ -8859,6 +9094,8 @@ function dumpPool(pool) {
       value = "<LiveList>";
     } else if (node instanceof LiveMap) {
       value = "<LiveMap>";
+    } else if (node instanceof LiveFile) {
+      value = stringifyOrLog(node.data);
     } else {
       value = "<LiveObject>";
     }
@@ -8955,6 +9192,15 @@ function diffNodeMap(prev, next) {
             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,
@@ -9045,7 +9291,7 @@ function sendToPanel(message, options) {
     ...message,
     source: "liveblocks-devtools-client"
   };
-  if (!(_optionalChain([options, 'optionalAccess', _217 => _217.force]) || _bridgeActive)) {
+  if (!(_optionalChain([options, 'optionalAccess', _216 => _216.force]) || _bridgeActive)) {
     return;
   }
   window.postMessage(fullMsg, "*");
@@ -9053,7 +9299,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', _218 => _218.data, 'optionalAccess', _219 => _219.source]) === "liveblocks-devtools-panel") {
+    if (event.source === window && _optionalChain([event, 'access', _217 => _217.data, 'optionalAccess', _218 => _218.source]) === "liveblocks-devtools-panel") {
       eventSource.notify(event.data);
     } else {
     }
@@ -9195,7 +9441,7 @@ function fullSync(room) {
     msg: "room::sync::full",
     roomId: room.id,
     status: room.getStatus(),
-    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _220 => _220.toTreeNode, 'call', _221 => _221("root"), 'access', _222 => _222.payload]), () => ( null)),
+    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _219 => _219.toTreeNode, 'call', _220 => _220("root"), 'access', _221 => _221.payload]), () => ( null)),
     me,
     others
   });
@@ -9852,6 +10098,9 @@ 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);
@@ -9882,15 +10131,15 @@ function installBackgroundTabSpy() {
   const doc = typeof document !== "undefined" ? document : void 0;
   const inBackgroundSince = { current: null };
   function onVisibilityChange() {
-    if (_optionalChain([doc, 'optionalAccess', _223 => _223.visibilityState]) === "hidden") {
+    if (_optionalChain([doc, 'optionalAccess', _222 => _222.visibilityState]) === "hidden") {
       inBackgroundSince.current = _nullishCoalesce(inBackgroundSince.current, () => ( Date.now()));
     } else {
       inBackgroundSince.current = null;
     }
   }
-  _optionalChain([doc, 'optionalAccess', _224 => _224.addEventListener, 'call', _225 => _225("visibilitychange", onVisibilityChange)]);
+  _optionalChain([doc, 'optionalAccess', _223 => _223.addEventListener, 'call', _224 => _224("visibilitychange", onVisibilityChange)]);
   const unsub = () => {
-    _optionalChain([doc, 'optionalAccess', _226 => _226.removeEventListener, 'call', _227 => _227("visibilitychange", onVisibilityChange)]);
+    _optionalChain([doc, 'optionalAccess', _225 => _225.removeEventListener, 'call', _226 => _226("visibilitychange", onVisibilityChange)]);
   };
   return [inBackgroundSince, unsub];
 }
@@ -9911,6 +10160,19 @@ function makeNodeMapBuffer() {
     }
   };
 }
+function topLevelKeysOf(nodes) {
+  const keys2 = /* @__PURE__ */ new Set();
+  const root = nodes.get("root");
+  for (const key in _optionalChain([root, 'optionalAccess', _227 => _227.data])) {
+    keys2.add(key);
+  }
+  for (const node of nodes.values()) {
+    if (node.parentId === "root") {
+      keys2.add(node.parentKey);
+    }
+  }
+  return keys2;
+}
 function createRoom(options, config) {
   const roomId = config.roomId;
   const initialPresence = options.initialPresence;
@@ -10113,21 +10375,21 @@ function createRoom(options, config) {
   async function reportTextEditor(type, rootKey) {
     await httpClient.reportTextEditor({ roomId, type, rootKey });
   }
-  async function listTextVersions() {
-    return httpClient.listTextVersions({ roomId });
+  async function listHistoryVersions() {
+    return httpClient.listHistoryVersions({ roomId });
   }
-  async function listTextVersionsSince(options2) {
-    return httpClient.listTextVersionsSince({
+  async function listHistoryVersionsSince(options2) {
+    return httpClient.listHistoryVersionsSince({
       roomId,
       since: options2.since,
       signal: options2.signal
     });
   }
-  async function getTextVersion(versionId) {
-    return httpClient.getTextVersion({ roomId, versionId });
+  async function getYjsHistoryVersion(versionId) {
+    return httpClient.getYjsHistoryVersion({ roomId, versionId });
   }
-  async function createTextVersion() {
-    return httpClient.createTextVersion({ roomId });
+  async function createVersionHistorySnapshot() {
+    return httpClient.createVersionHistorySnapshot({ roomId });
   }
   async function executeContextualPrompt(options2) {
     return httpClient.executeContextualPrompt({
@@ -10197,10 +10459,11 @@ function createRoom(options, config) {
       );
     }
     const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _232 => _232.get, 'call', _233 => _233(), 'optionalAccess', _234 => _234.canWrite]), () => ( true));
+    const serverTopLevelKeys = topLevelKeysOf(nodes);
     const root = context.root;
     disableHistory(() => {
       for (const key in context.initialStorage) {
-        if (root.get(key) === void 0) {
+        if (!serverTopLevelKeys.has(key)) {
           if (canWrite) {
             root.set(key, cloneLson(context.initialStorage[key]));
           } else {
@@ -10327,7 +10590,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) {
+        if (op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_MAP || op.type === OpCode.CREATE_OBJECT || op.type === OpCode.CREATE_FILE) {
           createdNodeIds.add(op.id);
         }
       }
@@ -10371,6 +10634,7 @@ 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 };
@@ -11474,6 +11738,17 @@ 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,
@@ -11528,13 +11803,13 @@ function createRoom(options, config) {
         // delete a text mention when using a text editor
         deleteTextMention,
         // list versions of the document
-        listTextVersions,
+        listHistoryVersions,
         // List versions of the document since the specified date
-        listTextVersionsSince,
+        listHistoryVersionsSince,
         // get a specific version
-        getTextVersion,
+        getYjsHistoryVersion,
         // create a version
-        createTextVersion,
+        createVersionHistorySnapshot,
         // execute a contextual prompt
         executeContextualPrompt,
         // Support for the Liveblocks browser extension
@@ -11547,7 +11822,8 @@ function createRoom(options, config) {
           rawSend: (data) => managedSocket.send(data),
           incomingMessage: (data) => handleServerMessage(new MessageEvent("message", { data }))
         },
-        attachmentUrlsStore: httpClient.getOrCreateAttachmentUrlsStore(roomId)
+        attachmentUrlsStore: httpClient.getOrCreateAttachmentUrlsStore(roomId),
+        fileUrlsStore: httpClient.getOrCreateFileUrlsStore(roomId)
       },
       id: roomId,
       subscribe: makeClassicSubscribeFn(
@@ -11645,6 +11921,8 @@ ${dumpPool(
       prepareAttachment,
       uploadAttachment,
       getAttachmentUrl,
+      uploadFile,
+      getFileUrl,
       // Notifications
       getNotificationSettings: getSubscriptionSettings,
       getSubscriptionSettings,
@@ -12530,6 +12808,11 @@ 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;
   }
@@ -12815,5 +13098,8 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.FeedRequestErrorCode = FeedRequestErrorCode; exports.HttpError = HttpError; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactNodesToNodeStream = compactNodesToNodeStream; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createThreadId = createThreadId; exports.deepLiveify = deepLiveify; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.hasPermissionAccess = hasPermissionAccess; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isListStorageNode = isListStorageNode; exports.isLiveNode = isLiveNode; exports.isMapStorageNode = isMapStorageNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isObjectStorageNode = isObjectStorageNode; exports.isPlainObject = isPlainObject; exports.isRegisterStorageNode = isRegisterStorageNode; exports.isRootStorageNode = isRootStorageNode; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.mergeRoomPermissionScopes = mergeRoomPermissionScopes; exports.nanoid = nanoid; exports.nn = nn; exports.nodeStreamToCompactNodes = nodeStreamToCompactNodes; exports.normalizeRoomAccesses = normalizeRoomAccesses; exports.normalizeRoomPermissions = normalizeRoomPermissions; exports.normalizeUpdateRoomAccesses = normalizeUpdateRoomAccesses; exports.objectToQuery = objectToQuery; exports.patchNotificationSettings = patchNotificationSettings; exports.permissionMatrixFromScopes = permissionMatrixFromScopes; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.validatePermissionsSet = validatePermissionsSet; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
+
+
+
+exports.ClientMsgCode = ClientMsgCode; exports.CrdtType = CrdtType; exports.DefaultMap = DefaultMap; exports.Deque = Deque; exports.DerivedSignal = DerivedSignal; exports.FeedRequestErrorCode = FeedRequestErrorCode; exports.HttpError = HttpError; exports.LiveFile = LiveFile; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.LiveblocksError = LiveblocksError; exports.MENTION_CHARACTER = MENTION_CHARACTER; exports.MutableSignal = MutableSignal; exports.OpCode = OpCode; exports.Permission = Permission; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.Signal = Signal; exports.SortedList = SortedList; exports.TextEditorType = TextEditorType; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.batch = batch; exports.checkBounds = checkBounds; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactNodesToNodeStream = compactNodesToNodeStream; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToGroupData = convertToGroupData; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToSubscriptionData = convertToSubscriptionData; exports.convertToThreadData = convertToThreadData; exports.convertToUserSubscriptionData = convertToUserSubscriptionData; exports.createClient = createClient; exports.createCommentAttachmentId = createCommentAttachmentId; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createManagedPool = createManagedPool; exports.createNotificationSettings = createNotificationSettings; exports.createStorageFileId = createStorageFileId; exports.createThreadId = createThreadId; exports.deepLiveify = deepLiveify; exports.defineAiTool = defineAiTool; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.entries = entries; exports.errorIf = errorIf; exports.findLastIndex = findLastIndex; exports.freeze = freeze; exports.generateUrl = generateUrl; exports.getMentionsFromCommentBody = getMentionsFromCommentBody; exports.getSubscriptionKey = getSubscriptionKey; exports.hasPermissionAccess = hasPermissionAccess; exports.html = html; exports.htmlSafe = htmlSafe; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isFileStorageNode = isFileStorageNode; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isListStorageNode = isListStorageNode; exports.isLiveNode = isLiveNode; exports.isMapStorageNode = isMapStorageNode; exports.isNotificationChannelEnabled = isNotificationChannelEnabled; exports.isNumberOperator = isNumberOperator; exports.isObjectStorageNode = isObjectStorageNode; exports.isPlainObject = isPlainObject; exports.isRegisterStorageNode = isRegisterStorageNode; exports.isRootStorageNode = isRootStorageNode; exports.isStartsWithOperator = isStartsWithOperator; exports.isUrl = isUrl; exports.kInternal = kInternal; exports.keys = keys; exports.makeAbortController = makeAbortController; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.mergeRoomPermissionScopes = mergeRoomPermissionScopes; exports.nanoid = nanoid; exports.nn = nn; exports.nodeStreamToCompactNodes = nodeStreamToCompactNodes; exports.normalizeRoomAccesses = normalizeRoomAccesses; exports.normalizeRoomPermissions = normalizeRoomPermissions; exports.normalizeUpdateRoomAccesses = normalizeUpdateRoomAccesses; exports.objectToQuery = objectToQuery; exports.patchNotificationSettings = patchNotificationSettings; exports.permissionMatrixFromScopes = permissionMatrixFromScopes; exports.raise = raise; exports.resolveMentionsInCommentBody = resolveMentionsInCommentBody; exports.sanitizeUrl = sanitizeUrl; exports.shallow = shallow; exports.shallow2 = shallow2; exports.stableStringify = stableStringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.validatePermissionsSet = validatePermissionsSet; exports.wait = wait; exports.warnOnce = warnOnce; exports.warnOnceIf = warnOnceIf; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.cjs.map