@liveblocks/core 3.23.0-file2 → 3.23.0-file4

package/dist/index.cjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.23.0-file2";
+var PKG_VERSION = "3.23.0-file4";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -1919,8 +1919,10 @@ var Batch = (_class = class {
     this.#clearDelayTimeout();
   }
 }, _class);
-function createBatchStore(batch2) {
+function createBatchStore(batch2, options) {
   const signal = new MutableSignal(/* @__PURE__ */ new Map());
+  const cacheExpiryTimeouts = /* @__PURE__ */ new Map();
+  const pendingEnqueues = /* @__PURE__ */ new Map();
   function getCacheKey(args) {
     return stableStringify(args);
   }
@@ -1935,7 +1937,42 @@ function createBatchStore(batch2) {
       }
     });
   }
+  function clearCacheExpiry(cacheKey) {
+    const timeoutId = cacheExpiryTimeouts.get(cacheKey);
+    if (timeoutId !== void 0) {
+      clearTimeout(timeoutId);
+      cacheExpiryTimeouts.delete(cacheKey);
+    }
+  }
+  function scheduleCacheExpiry(input, expiresAt) {
+    const cacheKey = getCacheKey(input);
+    clearCacheExpiry(cacheKey);
+    if (expiresAt === void 0 || !Number.isFinite(expiresAt)) {
+      return;
+    }
+    const timeoutId = setTimeout(
+      () => {
+        cacheExpiryTimeouts.delete(cacheKey);
+        invalidate([input]);
+      },
+      Math.max(0, expiresAt - Date.now())
+    );
+    cacheExpiryTimeouts.set(cacheKey, timeoutId);
+  }
   function invalidate(inputs) {
+    if (Array.isArray(inputs)) {
+      for (const input of inputs) {
+        const cacheKey = getCacheKey(input);
+        clearCacheExpiry(cacheKey);
+        pendingEnqueues.delete(cacheKey);
+      }
+    } else {
+      for (const timeoutId of cacheExpiryTimeouts.values()) {
+        clearTimeout(timeoutId);
+      }
+      cacheExpiryTimeouts.clear();
+      pendingEnqueues.clear();
+    }
     signal.mutate((cache) => {
       if (Array.isArray(inputs)) {
         for (const input of inputs) {
@@ -1946,23 +1983,54 @@ function createBatchStore(batch2) {
       }
     });
   }
-  async function enqueue(input) {
-    const cacheKey = getCacheKey(input);
-    const cache = signal.get();
-    if (cache.has(cacheKey)) {
-      return;
-    }
+  async function processEnqueue(input, cacheKey, batchResult$, pendingEnqueueId) {
     try {
-      update({ key: cacheKey, state: { isLoading: true } });
-      const result = await batch2.get(input);
+      const result = await batchResult$;
+      if (_optionalChain([pendingEnqueues, 'access', _27 => _27.get, 'call', _28 => _28(cacheKey), 'optionalAccess', _29 => _29.id]) !== pendingEnqueueId) {
+        return;
+      }
       update({ key: cacheKey, state: { isLoading: false, data: result } });
+      scheduleCacheExpiry(input, _optionalChain([options, 'optionalAccess', _30 => _30.getCacheExpiry, 'optionalCall', _31 => _31(result)]));
     } catch (error3) {
+      if (_optionalChain([pendingEnqueues, 'access', _32 => _32.get, 'call', _33 => _33(cacheKey), 'optionalAccess', _34 => _34.id]) !== pendingEnqueueId) {
+        return;
+      }
+      scheduleCacheExpiry(input, _optionalChain([options, 'optionalAccess', _35 => _35.getErrorCacheExpiry, 'optionalCall', _36 => _36(error3)]));
       update({
         key: cacheKey,
         state: { isLoading: false, error: error3 }
       });
+    } finally {
+      if (_optionalChain([pendingEnqueues, 'access', _37 => _37.get, 'call', _38 => _38(cacheKey), 'optionalAccess', _39 => _39.id]) === pendingEnqueueId) {
+        pendingEnqueues.delete(cacheKey);
+      }
     }
   }
+  function enqueue(input) {
+    const cacheKey = getCacheKey(input);
+    const existingEnqueue = pendingEnqueues.get(cacheKey);
+    if (existingEnqueue !== void 0) {
+      return existingEnqueue.promise;
+    }
+    const cache = signal.get();
+    if (cache.has(cacheKey)) {
+      return Promise.resolve();
+    }
+    const batchResult$ = batch2.get(input);
+    const pendingEnqueueId = /* @__PURE__ */ Symbol();
+    const pendingEnqueue$ = processEnqueue(
+      input,
+      cacheKey,
+      batchResult$,
+      pendingEnqueueId
+    );
+    pendingEnqueues.set(cacheKey, {
+      id: pendingEnqueueId,
+      promise: pendingEnqueue$
+    });
+    update({ key: cacheKey, state: { isLoading: true } });
+    return pendingEnqueue$;
+  }
   function setData(entries2) {
     update(
       entries2.map((entry) => ({
@@ -1970,6 +2038,9 @@ function createBatchStore(batch2) {
         state: { isLoading: false, data: entry[1] }
       }))
     );
+    for (const [input, output] of entries2) {
+      scheduleCacheExpiry(input, _optionalChain([options, 'optionalAccess', _40 => _40.getCacheExpiry, 'optionalCall', _41 => _41(output)]));
+    }
   }
   function getItemState(input) {
     const cacheKey = getCacheKey(input);
@@ -1979,7 +2050,22 @@ function createBatchStore(batch2) {
   function getData(input) {
     const cacheKey = getCacheKey(input);
     const cache = signal.get();
-    return _optionalChain([cache, 'access', _27 => _27.get, 'call', _28 => _28(cacheKey), 'optionalAccess', _29 => _29.data]);
+    return _optionalChain([cache, 'access', _42 => _42.get, 'call', _43 => _43(cacheKey), 'optionalAccess', _44 => _44.data]);
+  }
+  function waitUntilItemCacheExpires(input) {
+    const cacheKey = getCacheKey(input);
+    if (!cacheExpiryTimeouts.has(cacheKey)) {
+      return void 0;
+    }
+    const initialState = signal.get().get(cacheKey);
+    return new Promise((resolve) => {
+      const unsubscribe = signal.subscribe(() => {
+        if (signal.get().get(cacheKey) !== initialState) {
+          unsubscribe();
+          resolve();
+        }
+      });
+    });
   }
   function _cacheKeys() {
     const cache = signal.get();
@@ -1991,6 +2077,7 @@ function createBatchStore(batch2) {
     setData,
     getItemState,
     getData,
+    waitUntilItemCacheExpires,
     invalidate,
     batch: batch2,
     _cacheKeys
@@ -2274,6 +2361,10 @@ function isUrl(string) {
 // src/api-client.ts
 var ROOM_FILE_PART_SIZE = 5 * 1024 * 1024;
 var ROOM_FILE_RETRY_ATTEMPTS = 10;
+var FILE_URL_EXPIRY_BUFFER = 3e4;
+var FILE_URL_ERROR_CACHE_TTL = 1e3;
+var FILE_URL_ERROR_MAX_ATTEMPTS = 3;
+var FILE_URL_ERROR_ATTEMPTS_EXPIRY = 3e4;
 var ROOM_FILE_RETRY_DELAYS = [
   2e3,
   2e3,
@@ -2286,10 +2377,13 @@ var ROOM_FILE_RETRY_DELAYS = [
   2e3,
   2e3
 ];
+var FileUrlUnavailableError = class extends Error {
+};
 async function uploadRoomFile({
   file,
   signal,
   abortErrorMessage,
+  retryMultipartCompletion,
   uploadSingle,
   createMultipartUpload,
   uploadMultipartPart,
@@ -2297,17 +2391,14 @@ async function uploadRoomFile({
   abortMultipartUpload
 }) {
   const abortError = createAbortError(abortErrorMessage);
-  if (_optionalChain([signal, 'optionalAccess', _30 => _30.aborted])) {
+  if (_optionalChain([signal, 'optionalAccess', _45 => _45.aborted])) {
     throw abortError;
   }
   const handleRetryError = (err) => {
-    if (_optionalChain([signal, 'optionalAccess', _31 => _31.aborted])) {
+    if (_optionalChain([signal, 'optionalAccess', _46 => _46.aborted])) {
       throw abortError;
     }
-    if (err instanceof HttpError && err.status === 413) {
-      throw err;
-    }
-    return false;
+    return err instanceof HttpError && err.status >= 400 && err.status < 500;
   };
   if (file.size <= ROOM_FILE_PART_SIZE) {
     return autoRetry(
@@ -2325,41 +2416,84 @@ async function uploadRoomFile({
     ROOM_FILE_RETRY_DELAYS,
     handleRetryError
   );
+  const partUploadController = new AbortController();
+  const partUploadSignal = partUploadController.signal;
+  const abortPartUploads = (reason) => {
+    partUploadController.abort(reason);
+  };
+  const handleExternalAbort = () => abortPartUploads();
+  if (_optionalChain([signal, 'optionalAccess', _47 => _47.aborted])) {
+    handleExternalAbort();
+  } else {
+    _optionalChain([signal, 'optionalAccess', _48 => _48.addEventListener, 'call', _49 => _49("abort", handleExternalAbort, { once: true })]);
+  }
   try {
     uploadId = multipartUpload.uploadId;
-    if (_optionalChain([signal, 'optionalAccess', _32 => _32.aborted])) {
+    if (_optionalChain([signal, 'optionalAccess', _50 => _50.aborted])) {
       throw abortError;
     }
     const batches = chunk(splitFileIntoParts(file), 5);
     for (const parts of batches) {
-      const uploadedPartsPromises = [];
+      const firstPartUploadFailure = {};
+      const partUploads$ = [];
       for (const { part, partNumber } of parts) {
-        uploadedPartsPromises.push(
+        partUploads$.push(
           autoRetry(
-            () => uploadMultipartPart(multipartUpload.uploadId, partNumber, part),
+            () => uploadMultipartPart(
+              multipartUpload.uploadId,
+              partNumber,
+              part,
+              partUploadSignal
+            ),
             ROOM_FILE_RETRY_ATTEMPTS,
             ROOM_FILE_RETRY_DELAYS,
-            handleRetryError
-          )
+            (error3) => {
+              if (_optionalChain([signal, 'optionalAccess', _51 => _51.aborted])) {
+                throw abortError;
+              }
+              return partUploadSignal.aborted || handleRetryError(error3);
+            }
+          ).catch((error3) => {
+            if (firstPartUploadFailure.value === void 0) {
+              firstPartUploadFailure.value = { error: error3 };
+              abortPartUploads(error3);
+            }
+            throw error3;
+          })
         );
       }
-      uploadedParts.push(...await Promise.all(uploadedPartsPromises));
+      const settledPartUploads = await Promise.allSettled(partUploads$);
+      if (firstPartUploadFailure.value !== void 0) {
+        throw firstPartUploadFailure.value.error;
+      }
+      for (const settledPartUpload of settledPartUploads) {
+        if (settledPartUpload.status === "fulfilled") {
+          uploadedParts.push(settledPartUpload.value);
+        }
+      }
     }
-    if (_optionalChain([signal, 'optionalAccess', _33 => _33.aborted])) {
+    if (_optionalChain([signal, 'optionalAccess', _52 => _52.aborted])) {
       throw abortError;
     }
-    return completeMultipartUpload(
-      uploadId,
-      uploadedParts.sort((a, b) => a.partNumber - b.partNumber)
+    const sortedParts = uploadedParts.sort(
+      (a, b) => a.partNumber - b.partNumber
     );
+    return retryMultipartCompletion ? autoRetry(
+      () => completeMultipartUpload(multipartUpload.uploadId, sortedParts),
+      ROOM_FILE_RETRY_ATTEMPTS,
+      ROOM_FILE_RETRY_DELAYS,
+      handleRetryError
+    ) : completeMultipartUpload(uploadId, sortedParts);
   } catch (error3) {
-    if (uploadId && isAbortOrTimeoutError(error3)) {
+    if (uploadId) {
       try {
         await abortMultipartUpload(uploadId);
       } catch (e8) {
       }
     }
     throw error3;
+  } finally {
+    _optionalChain([signal, 'optionalAccess', _53 => _53.removeEventListener, 'call', _54 => _54("abort", handleExternalAbort)]);
   }
 }
 function splitFileIntoParts(file) {
@@ -2375,9 +2509,6 @@ function splitFileIntoParts(file) {
   }
   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");
@@ -2446,7 +2577,7 @@ function createApiClient({
         url`/v2/c/rooms/${options.roomId}/threads`,
         await authManager.getAuthValue({
           roomId: options.roomId,
-          resource: commentsResourceForVisibility(_optionalChain([options, 'access', _34 => _34.query, 'optionalAccess', _35 => _35.visibility])),
+          resource: commentsResourceForVisibility(_optionalChain([options, 'access', _55 => _55.query, 'optionalAccess', _56 => _56.visibility])),
           access: "read"
         }),
         {
@@ -2504,7 +2635,7 @@ function createApiClient({
           hasMentions: options.query.hasMentions
         })
       },
-      { signal: _optionalChain([requestOptions, 'optionalAccess', _36 => _36.signal]) }
+      { signal: _optionalChain([requestOptions, 'optionalAccess', _57 => _57.signal]) }
     );
     return result;
   }
@@ -2706,6 +2837,7 @@ function createApiClient({
       file: attachment.file,
       signal: options.signal,
       abortErrorMessage: `Upload of attachment ${attachment.id} was aborted.`,
+      retryMultipartCompletion: false,
       uploadSingle: async () => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/upload/${attachment.name}`,
         await authManager.getAuthValue({
@@ -2728,7 +2860,7 @@ function createApiClient({
         { signal: options.signal },
         { fileSize: attachment.size }
       ),
-      uploadMultipartPart: async (uploadId, partNumber, part) => httpClient.putBlob(
+      uploadMultipartPart: async (uploadId, partNumber, part, signal) => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/${String(partNumber)}`,
         await authManager.getAuthValue({
           roomId,
@@ -2737,7 +2869,7 @@ function createApiClient({
         }),
         part,
         void 0,
-        { signal: options.signal }
+        { signal }
       ),
       completeMultipartUpload: async (uploadId, parts) => httpClient.post(
         url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/complete`,
@@ -2769,6 +2901,7 @@ function createApiClient({
       file,
       signal: options.signal,
       abortErrorMessage: `Upload of file ${fileId} was aborted.`,
+      retryMultipartCompletion: true,
       uploadSingle: async () => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/storage/files/${fileId}/upload/${file.name}`,
         await authManager.getAuthValue({
@@ -2791,7 +2924,7 @@ function createApiClient({
         { signal: options.signal },
         { fileSize: file.size }
       ),
-      uploadMultipartPart: async (uploadId, partNumber, part) => httpClient.putBlob(
+      uploadMultipartPart: async (uploadId, partNumber, part, signal) => httpClient.putBlob(
         url`/v2/c/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}/${String(partNumber)}`,
         await authManager.getAuthValue({
           roomId,
@@ -2800,7 +2933,7 @@ function createApiClient({
         }),
         part,
         void 0,
-        { signal: options.signal }
+        { signal }
       ),
       completeMultipartUpload: async (uploadId, parts) => httpClient.post(
         url`/v2/c/rooms/${roomId}/storage/files/${fileId}/multipart/${uploadId}/complete`,
@@ -2854,10 +2987,37 @@ function createApiClient({
     return batch2.get(options.attachmentId);
   }
   const fileUrlsBatchStoresByRoom = new DefaultMap((roomId) => {
+    const pendingFileUrlAttempts = /* @__PURE__ */ new Map();
+    const clearPendingFileUrlAttempts = (fileId) => {
+      const attempts = pendingFileUrlAttempts.get(fileId);
+      if (attempts !== void 0) {
+        clearTimeout(attempts.cleanupTimeoutId);
+        pendingFileUrlAttempts.delete(fileId);
+      }
+    };
+    const shouldRetryPendingFileUrl = (fileId) => {
+      const previousAttempts = pendingFileUrlAttempts.get(fileId);
+      if (previousAttempts !== void 0) {
+        clearTimeout(previousAttempts.cleanupTimeoutId);
+      }
+      const count = (_nullishCoalesce(_optionalChain([previousAttempts, 'optionalAccess', _58 => _58.count]), () => ( 0))) + 1;
+      if (count >= FILE_URL_ERROR_MAX_ATTEMPTS) {
+        pendingFileUrlAttempts.delete(fileId);
+        return false;
+      }
+      pendingFileUrlAttempts.set(fileId, {
+        count,
+        cleanupTimeoutId: setTimeout(
+          () => pendingFileUrlAttempts.delete(fileId),
+          FILE_URL_ERROR_ATTEMPTS_EXPIRY
+        )
+      });
+      return true;
+    };
     const batch2 = new Batch(
       async (batchedFileIds) => {
         const fileIds = batchedFileIds.flat();
-        const { urls } = await httpClient.post(
+        const { urls, expiresAt } = await httpClient.post(
           url`/v2/c/rooms/${roomId}/storage/files/presigned-urls`,
           await authManager.getAuthValue({
             roomId,
@@ -2866,20 +3026,31 @@ function createApiClient({
           }),
           { fileIds }
         );
-        return urls.map(
-          (url2) => _nullishCoalesce(url2, () => ( new Error("There was an error while getting this file's URL")))
-        );
+        const expiresAtTimestamp = Date.parse(expiresAt);
+        return urls.map((url2, index) => {
+          const fileId = fileIds[index];
+          if (url2 === false) {
+            return shouldRetryPendingFileUrl(fileId) ? new FileUrlUnavailableError(
+              "There was an error while getting this file's URL"
+            ) : new Error("There was an error while getting this file's URL");
+          }
+          clearPendingFileUrlAttempts(fileId);
+          return url2 !== null ? { url: url2, expiresAt: expiresAtTimestamp } : new Error("There was an error while getting this file's URL");
+        });
       },
       { delay: 50 }
     );
-    return createBatchStore(batch2);
+    return createBatchStore(batch2, {
+      getCacheExpiry: ({ expiresAt }) => expiresAt - FILE_URL_EXPIRY_BUFFER,
+      getErrorCacheExpiry: (error3) => error3 instanceof FileUrlUnavailableError ? Date.now() + FILE_URL_ERROR_CACHE_TTL : void 0
+    });
   });
   function getOrCreateFileUrlsStore(roomId) {
     return fileUrlsBatchStoresByRoom.getOrCreate(roomId);
   }
-  function getFileUrl(options) {
+  async function getFileUrl(options) {
     const batch2 = getOrCreateFileUrlsStore(options.roomId).batch;
-    return batch2.get(options.fileId);
+    return (await batch2.get(options.fileId)).url;
   }
   async function getSubscriptionSettings(options) {
     return httpClient.get(
@@ -3089,14 +3260,14 @@ function createApiClient({
   async function getInboxNotifications(options) {
     const PAGE_SIZE = 50;
     let query;
-    if (_optionalChain([options, 'optionalAccess', _37 => _37.query])) {
+    if (_optionalChain([options, 'optionalAccess', _59 => _59.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', _38 => _38.cursor]),
+        cursor: _optionalChain([options, 'optionalAccess', _60 => _60.cursor]),
         limit: PAGE_SIZE,
         query
       }
@@ -3115,7 +3286,7 @@ function createApiClient({
   }
   async function getInboxNotificationsSince(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _39 => _39.query])) {
+    if (_optionalChain([options, 'optionalAccess', _61 => _61.query])) {
       query = objectToQuery(options.query);
     }
     const json = await httpClient.get(
@@ -3144,14 +3315,14 @@ function createApiClient({
   }
   async function getUnreadInboxNotificationsCount(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _40 => _40.query])) {
+    if (_optionalChain([options, 'optionalAccess', _62 => _62.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', _41 => _41.signal]) }
+      { signal: _optionalChain([options, 'optionalAccess', _63 => _63.signal]) }
     );
     return count;
   }
@@ -3201,7 +3372,7 @@ function createApiClient({
       url`/v2/c/notification-settings`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       void 0,
-      { signal: _optionalChain([options, 'optionalAccess', _42 => _42.signal]) }
+      { signal: _optionalChain([options, 'optionalAccess', _64 => _64.signal]) }
     );
   }
   async function updateNotificationSettings(settings) {
@@ -3213,7 +3384,7 @@ function createApiClient({
   }
   async function getUserThreads_experimental(options) {
     let query;
-    if (_optionalChain([options, 'optionalAccess', _43 => _43.query])) {
+    if (_optionalChain([options, 'optionalAccess', _65 => _65.query])) {
       query = objectToQuery(options.query);
     }
     const PAGE_SIZE = 50;
@@ -3221,7 +3392,7 @@ function createApiClient({
       url`/v2/c/threads`,
       await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
-        cursor: _optionalChain([options, 'optionalAccess', _44 => _44.cursor]),
+        cursor: _optionalChain([options, 'optionalAccess', _66 => _66.cursor]),
         query,
         limit: PAGE_SIZE
       }
@@ -3400,7 +3571,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', _45 => _45.headers]),
+        ..._optionalChain([options, 'optionalAccess', _67 => _67.headers]),
         // Cannot be overriden by custom headers
         Authorization: `Bearer ${getBearerTokenFromAuthValue(authValue)}`,
         "X-LB-Client": PKG_VERSION || "dev"
@@ -3408,7 +3579,7 @@ var HttpClient = class {
     });
     const xwarn = response.headers.get("X-LB-Warn");
     if (xwarn) {
-      const method = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _46 => _46.method, 'optionalAccess', _47 => _47.toUpperCase, 'call', _48 => _48()]), () => ( "GET"));
+      const method = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _68 => _68.method, 'optionalAccess', _69 => _69.toUpperCase, 'call', _70 => _70()]), () => ( "GET"));
       const msg = `${xwarn} (${method} ${endpoint})`;
       if (response.ok) {
         warn(msg);
@@ -3890,7 +4061,7 @@ var FSM = class {
     });
   }
   #getTargetFn(eventName) {
-    return _optionalChain([this, 'access', _49 => _49.#allowedTransitions, 'access', _50 => _50.get, 'call', _51 => _51(this.currentState), 'optionalAccess', _52 => _52.get, 'call', _53 => _53(eventName)]);
+    return _optionalChain([this, 'access', _71 => _71.#allowedTransitions, 'access', _72 => _72.get, 'call', _73 => _73(this.currentState), 'optionalAccess', _74 => _74.get, 'call', _75 => _75(eventName)]);
   }
   /**
    * Exits the current state, and executes any necessary cleanup functions.
@@ -3909,7 +4080,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       levels = _nullishCoalesce(levels, () => ( this.#cleanupStack.length));
       for (let i = 0; i < levels; i++) {
-        _optionalChain([this, 'access', _54 => _54.#cleanupStack, 'access', _55 => _55.pop, 'call', _56 => _56(), 'optionalCall', _57 => _57(patchableContext)]);
+        _optionalChain([this, 'access', _76 => _76.#cleanupStack, 'access', _77 => _77.pop, 'call', _78 => _78(), 'optionalCall', _79 => _79(patchableContext)]);
         const entryTime = this.#entryTimesStack.pop();
         if (entryTime !== void 0 && // ...but avoid computing state names if nobody is listening
         this.#eventHub.didExitState.count() > 0) {
@@ -3937,7 +4108,7 @@ var FSM = class {
     this.#currentContext.allowPatching((patchableContext) => {
       for (const pattern of enterPatterns) {
         const enterFn = this.#enterFns.get(pattern);
-        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _58 => _58(patchableContext)]);
+        const cleanupFn = _optionalChain([enterFn, 'optionalCall', _80 => _80(patchableContext)]);
         if (typeof cleanupFn === "function") {
           this.#cleanupStack.push(cleanupFn);
         } else {
@@ -4364,7 +4535,7 @@ function createConnectionStateMachine(delegates, options) {
           }
           function waitForActorId(event) {
             const serverMsg = tryParseJson(event.data);
-            if (_optionalChain([serverMsg, 'optionalAccess', _59 => _59.type]) === ServerMsgCode.ROOM_STATE) {
+            if (_optionalChain([serverMsg, 'optionalAccess', _81 => _81.type]) === ServerMsgCode.ROOM_STATE) {
               if (options.enableDebugLogging && socketOpenAt !== null) {
                 const elapsed = performance.now() - socketOpenAt;
                 warn(
@@ -4492,12 +4663,12 @@ function createConnectionStateMachine(delegates, options) {
   const sendHeartbeat = {
     target: "@ok.awaiting-pong",
     effect: (ctx) => {
-      _optionalChain([ctx, 'access', _60 => _60.socket, 'optionalAccess', _61 => _61.send, 'call', _62 => _62("ping")]);
+      _optionalChain([ctx, 'access', _82 => _82.socket, 'optionalAccess', _83 => _83.send, 'call', _84 => _84("ping")]);
     }
   };
   const maybeHeartbeat = () => {
     const doc = typeof document !== "undefined" ? document : void 0;
-    const canZombie = _optionalChain([doc, 'optionalAccess', _63 => _63.visibilityState]) === "hidden" && delegates.canZombie();
+    const canZombie = _optionalChain([doc, 'optionalAccess', _85 => _85.visibilityState]) === "hidden" && delegates.canZombie();
     return canZombie ? "@idle.zombie" : sendHeartbeat;
   };
   machine.addTimedTransition("@ok.connected", HEARTBEAT_INTERVAL, maybeHeartbeat).addTransitions("@ok.connected", {
@@ -4537,7 +4708,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', _64 => _64.socket, 'optionalAccess', _65 => _65.readyState]) === 1) {
+      if (_optionalChain([context, 'access', _86 => _86.socket, 'optionalAccess', _87 => _87.readyState]) === 1) {
         return IGNORE;
       }
       return {
@@ -4589,17 +4760,17 @@ function createConnectionStateMachine(delegates, options) {
         machine.send({ type: "NAVIGATOR_ONLINE" });
       }
       function onVisibilityChange() {
-        if (_optionalChain([doc, 'optionalAccess', _66 => _66.visibilityState]) === "visible") {
+        if (_optionalChain([doc, 'optionalAccess', _88 => _88.visibilityState]) === "visible") {
           machine.send({ type: "WINDOW_GOT_FOCUS" });
         }
       }
-      _optionalChain([win, 'optionalAccess', _67 => _67.addEventListener, 'call', _68 => _68("online", onNetworkBackOnline)]);
-      _optionalChain([win, 'optionalAccess', _69 => _69.addEventListener, 'call', _70 => _70("offline", onNetworkOffline)]);
-      _optionalChain([root, 'optionalAccess', _71 => _71.addEventListener, 'call', _72 => _72("visibilitychange", onVisibilityChange)]);
+      _optionalChain([win, 'optionalAccess', _89 => _89.addEventListener, 'call', _90 => _90("online", onNetworkBackOnline)]);
+      _optionalChain([win, 'optionalAccess', _91 => _91.addEventListener, 'call', _92 => _92("offline", onNetworkOffline)]);
+      _optionalChain([root, 'optionalAccess', _93 => _93.addEventListener, 'call', _94 => _94("visibilitychange", onVisibilityChange)]);
       return () => {
-        _optionalChain([root, 'optionalAccess', _73 => _73.removeEventListener, 'call', _74 => _74("visibilitychange", onVisibilityChange)]);
-        _optionalChain([win, 'optionalAccess', _75 => _75.removeEventListener, 'call', _76 => _76("online", onNetworkBackOnline)]);
-        _optionalChain([win, 'optionalAccess', _77 => _77.removeEventListener, 'call', _78 => _78("offline", onNetworkOffline)]);
+        _optionalChain([root, 'optionalAccess', _95 => _95.removeEventListener, 'call', _96 => _96("visibilitychange", onVisibilityChange)]);
+        _optionalChain([win, 'optionalAccess', _97 => _97.removeEventListener, 'call', _98 => _98("online", onNetworkBackOnline)]);
+        _optionalChain([win, 'optionalAccess', _99 => _99.removeEventListener, 'call', _100 => _100("offline", onNetworkOffline)]);
         teardownSocket(ctx.socket);
       };
     });
@@ -4688,7 +4859,7 @@ var ManagedSocket = class {
    * message if this is somehow impossible.
    */
   send(data) {
-    const socket = _optionalChain([this, 'access', _79 => _79.#machine, 'access', _80 => _80.context, 'optionalAccess', _81 => _81.socket]);
+    const socket = _optionalChain([this, 'access', _101 => _101.#machine, 'access', _102 => _102.context, 'optionalAccess', _103 => _103.socket]);
     if (socket === null) {
       warn("Cannot send: not connected yet", data);
     } else if (socket.readyState !== 1) {
@@ -5150,7 +5321,7 @@ function createStore_forKnowledge() {
   }
   function getKnowledgeForChat(chatId) {
     const globalKnowledge = knowledgeByChatId.getOrCreate(kWILDCARD).get();
-    const scopedKnowledge = _nullishCoalesce(_optionalChain([knowledgeByChatId, 'access', _82 => _82.get, 'call', _83 => _83(chatId), 'optionalAccess', _84 => _84.get, 'call', _85 => _85()]), () => ( []));
+    const scopedKnowledge = _nullishCoalesce(_optionalChain([knowledgeByChatId, 'access', _104 => _104.get, 'call', _105 => _105(chatId), 'optionalAccess', _106 => _106.get, 'call', _107 => _107()]), () => ( []));
     return [...globalKnowledge, ...scopedKnowledge];
   }
   return {
@@ -5175,7 +5346,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', _86 => _86.get, 'call', _87 => _87()]), () => ( // ...or a globally registered tool
+        _nullishCoalesce(_optionalChain([(chatId !== void 0 ? toolsByChatId\u03A3.getOrCreate(chatId).getOrCreate(name) : void 0), 'optionalAccess', _108 => _108.get, 'call', _109 => _109()]), () => ( // ...or a globally registered tool
         toolsByChatId\u03A3.getOrCreate(kWILDCARD).getOrCreate(name).get()))
       );
     });
@@ -5205,8 +5376,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', _88 => _88.entries, 'call', _89 => _89()]), () => ( [])),
-      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _90 => _90.entries, 'call', _91 => _91()]), () => ( []))
+      ..._nullishCoalesce(_optionalChain([globalTools\u03A3, 'optionalAccess', _110 => _110.entries, 'call', _111 => _111()]), () => ( [])),
+      ..._nullishCoalesce(_optionalChain([scopedTools\u03A3, 'optionalAccess', _112 => _112.entries, 'call', _113 => _113()]), () => ( []))
     ]).flatMap(([name, tool\u03A3]) => {
       const tool = tool\u03A3.get();
       return tool && (_nullishCoalesce(tool.enabled, () => ( true))) ? [{ name, description: tool.description, parameters: tool.parameters }] : [];
@@ -5309,7 +5480,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
             } else {
               continue;
             }
-            const executeFn = _optionalChain([toolsStore, 'access', _92 => _92.getTool\u03A3, 'call', _93 => _93(toolInvocation.name, message.chatId), 'access', _94 => _94.get, 'call', _95 => _95(), 'optionalAccess', _96 => _96.execute]);
+            const executeFn = _optionalChain([toolsStore, 'access', _114 => _114.getTool\u03A3, 'call', _115 => _115(toolInvocation.name, message.chatId), 'access', _116 => _116.get, 'call', _117 => _117(), 'optionalAccess', _118 => _118.execute]);
             if (executeFn) {
               (async () => {
                 const result = await executeFn(toolInvocation.args, {
@@ -5408,8 +5579,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', _97 => _97(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _98 => _98.id]), () => ( null));
-        const next = _nullishCoalesce(_optionalChain([first, 'call', _99 => _99(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _100 => _100.id]), () => ( null));
+        const prev = _nullishCoalesce(_optionalChain([first, 'call', _119 => _119(pool.walkLeft(message2.id, isAlive)), 'optionalAccess', _120 => _120.id]), () => ( null));
+        const next = _nullishCoalesce(_optionalChain([first, 'call', _121 => _121(pool.walkRight(message2.id, isAlive)), 'optionalAccess', _122 => _122.id]), () => ( null));
         if (!message2.deletedAt || prev || next) {
           const node = {
             ...message2,
@@ -5475,7 +5646,7 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     const latest = pool.sorted.findRight(
       (m) => m.role === "assistant" && !m.deletedAt
     );
-    return _optionalChain([latest, 'optionalAccess', _101 => _101.copilotId]);
+    return _optionalChain([latest, 'optionalAccess', _123 => _123.copilotId]);
   }
   return {
     // Readers
@@ -5506,11 +5677,11 @@ function createStore_forChatMessages(toolsStore, setToolResultFn) {
     *getAutoExecutingMessageIds() {
       for (const messageId of myMessages) {
         const message = getMessageById(messageId);
-        if (_optionalChain([message, 'optionalAccess', _102 => _102.role]) === "assistant" && message.status === "awaiting-tool") {
+        if (_optionalChain([message, 'optionalAccess', _124 => _124.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', _103 => _103.execute]) === "function";
+              return typeof _optionalChain([tool, 'optionalAccess', _125 => _125.execute]) === "function";
             }
             return false;
           });
@@ -5658,7 +5829,7 @@ function createAi(config) {
           flushPendingDeltas();
           switch (msg.event) {
             case "cmd-failed":
-              _optionalChain([pendingCmd, 'optionalAccess', _104 => _104.reject, 'call', _105 => _105(new Error(msg.error))]);
+              _optionalChain([pendingCmd, 'optionalAccess', _126 => _126.reject, 'call', _127 => _127(new Error(msg.error))]);
               break;
             case "settle": {
               context.messagesStore.upsert(msg.message);
@@ -5735,7 +5906,7 @@ function createAi(config) {
           return assertNever(msg, "Unhandled case");
       }
     }
-    _optionalChain([pendingCmd, 'optionalAccess', _106 => _106.resolve, 'call', _107 => _107(msg)]);
+    _optionalChain([pendingCmd, 'optionalAccess', _128 => _128.resolve, 'call', _129 => _129(msg)]);
   }
   managedSocket.events.onMessage.subscribe(handleServerMessage);
   managedSocket.events.statusDidChange.subscribe(onStatusDidChange);
@@ -5811,9 +5982,9 @@ function createAi(config) {
       invocationId,
       result,
       generationOptions: {
-        copilotId: _optionalChain([options, 'optionalAccess', _108 => _108.copilotId]),
-        stream: _optionalChain([options, 'optionalAccess', _109 => _109.stream]),
-        timeout: _optionalChain([options, 'optionalAccess', _110 => _110.timeout]),
+        copilotId: _optionalChain([options, 'optionalAccess', _130 => _130.copilotId]),
+        stream: _optionalChain([options, 'optionalAccess', _131 => _131.stream]),
+        timeout: _optionalChain([options, 'optionalAccess', _132 => _132.timeout]),
         // Knowledge and tools aren't coming from the options, but retrieved
         // from the global context
         knowledge: knowledge.length > 0 ? knowledge : void 0,
@@ -5831,7 +6002,7 @@ function createAi(config) {
     }
   }
   const win = typeof window !== "undefined" ? window : void 0;
-  _optionalChain([win, 'optionalAccess', _111 => _111.addEventListener, 'call', _112 => _112("beforeunload", handleBeforeUnload, { once: true })]);
+  _optionalChain([win, 'optionalAccess', _133 => _133.addEventListener, 'call', _134 => _134("beforeunload", handleBeforeUnload, { once: true })]);
   return Object.defineProperty(
     {
       [kInternal]: {
@@ -5850,7 +6021,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', _113 => _113.knowledge]) || [];
+        const requestKnowledge = _optionalChain([options, 'optionalAccess', _135 => _135.knowledge]) || [];
         const combinedKnowledge = [...knowledge, ...requestKnowledge];
         const tools = context.toolsStore.getToolDescriptions(chatId);
         messagesStore.markMine(targetMessageId);
@@ -5860,9 +6031,9 @@ function createAi(config) {
           sourceMessage: userMessage,
           targetMessageId,
           generationOptions: {
-            copilotId: _optionalChain([options, 'optionalAccess', _114 => _114.copilotId]),
-            stream: _optionalChain([options, 'optionalAccess', _115 => _115.stream]),
-            timeout: _optionalChain([options, 'optionalAccess', _116 => _116.timeout]),
+            copilotId: _optionalChain([options, 'optionalAccess', _136 => _136.copilotId]),
+            stream: _optionalChain([options, 'optionalAccess', _137 => _137.stream]),
+            timeout: _optionalChain([options, 'optionalAccess', _138 => _138.timeout]),
             // Combine global knowledge with request-specific knowledge
             knowledge: combinedKnowledge.length > 0 ? combinedKnowledge : void 0,
             tools: tools.length > 0 ? tools : void 0
@@ -5934,7 +6105,7 @@ function replaceOrAppend(content, newItem, keyFn, now2) {
   }
 }
 function closePart(prevPart, endedAt) {
-  if (_optionalChain([prevPart, 'optionalAccess', _117 => _117.type]) === "reasoning") {
+  if (_optionalChain([prevPart, 'optionalAccess', _139 => _139.type]) === "reasoning") {
     prevPart.endedAt ??= endedAt;
   }
 }
@@ -5949,7 +6120,7 @@ function patchContentWithDelta(content, delta) {
   const lastPart = parts[parts.length - 1];
   switch (delta.type) {
     case "text-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _118 => _118.type]) === "text") {
+      if (_optionalChain([lastPart, 'optionalAccess', _140 => _140.type]) === "text") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
@@ -5957,7 +6128,7 @@ function patchContentWithDelta(content, delta) {
       }
       break;
     case "reasoning-delta":
-      if (_optionalChain([lastPart, 'optionalAccess', _119 => _119.type]) === "reasoning") {
+      if (_optionalChain([lastPart, 'optionalAccess', _141 => _141.type]) === "reasoning") {
         lastPart.text += delta.textDelta;
       } else {
         closePart(lastPart, now2);
@@ -5977,8 +6148,8 @@ function patchContentWithDelta(content, delta) {
       break;
     }
     case "tool-delta": {
-      if (_optionalChain([lastPart, 'optionalAccess', _120 => _120.type]) === "tool-invocation" && lastPart.stage === "receiving") {
-        _optionalChain([lastPart, 'access', _121 => _121.__appendDelta, 'optionalCall', _122 => _122(delta.delta)]);
+      if (_optionalChain([lastPart, 'optionalAccess', _142 => _142.type]) === "tool-invocation" && lastPart.stage === "receiving") {
+        _optionalChain([lastPart, 'access', _143 => _143.__appendDelta, 'optionalCall', _144 => _144(delta.delta)]);
       }
       break;
     }
@@ -6333,7 +6504,7 @@ function explicitAccessForResource(source, resource) {
 }
 function permissionForAccessLevel(resource, access, field = resource) {
   const permissions = PERMISSIONS_BY_RESOURCE[resource][access];
-  const permission = _optionalChain([permissions, 'optionalAccess', _123 => _123[0]]);
+  const permission = _optionalChain([permissions, 'optionalAccess', _145 => _145[0]]);
   if (permission !== void 0) {
     return permission;
   }
@@ -6443,7 +6614,7 @@ function createAuthManager(authOptions, onAuthenticate) {
     return void 0;
   }
   async function makeAuthRequest(options) {
-    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _124 => _124.polyfills, 'optionalAccess', _125 => _125.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
+    const fetcher = _nullishCoalesce(_optionalChain([authOptions, 'access', _146 => _146.polyfills, 'optionalAccess', _147 => _147.fetch]), () => ( (typeof window === "undefined" ? void 0 : window.fetch)));
     if (authentication.type === "private") {
       if (fetcher === void 0) {
         throw new StopRetrying(
@@ -6456,14 +6627,14 @@ function createAuthManager(authOptions, onAuthenticate) {
       const parsed = parseAuthToken(response.token);
       if (seenTokens.has(parsed.raw)) {
         const cachedToken = getCachedToken(options);
-        if (_optionalChain([cachedToken, 'optionalAccess', _126 => _126.raw]) === parsed.raw) {
+        if (_optionalChain([cachedToken, 'optionalAccess', _148 => _148.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', _127 => _127(parsed.parsed)]);
+      _optionalChain([onAuthenticate, 'optionalCall', _149 => _149(parsed.parsed)]);
       return parsed;
     }
     if (authentication.type === "custom") {
@@ -6471,7 +6642,7 @@ function createAuthManager(authOptions, onAuthenticate) {
       if (response && typeof response === "object") {
         if (typeof response.token === "string") {
           const parsed = parseAuthToken(response.token);
-          _optionalChain([onAuthenticate, 'optionalCall', _128 => _128(parsed.parsed)]);
+          _optionalChain([onAuthenticate, 'optionalCall', _150 => _150(parsed.parsed)]);
           return parsed;
         } else if (typeof response.error === "string") {
           const reason = `Authentication failed: ${"reason" in response && typeof response.reason === "string" ? response.reason : "Forbidden"}`;
@@ -7171,7 +7342,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applyInsertUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _129 => _129._pool, 'optionalAccess', _130 => _130.getNode, 'call', _131 => _131(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _151 => _151._pool, 'optionalAccess', _152 => _152.getNode, 'call', _153 => _153(id)]) !== void 0) {
       return { modified: false };
     }
     child._attach(id, nn(this._pool));
@@ -7179,8 +7350,8 @@ var LiveList = class _LiveList extends AbstractCrdt {
     const existingItemIndex = this._indexOfPosition(key);
     let newKey = key;
     if (existingItemIndex !== -1) {
-      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]);
+      const before2 = _optionalChain([this, 'access', _154 => _154.#items, 'access', _155 => _155.at, 'call', _156 => _156(existingItemIndex), 'optionalAccess', _157 => _157._parentPos]);
+      const after2 = _optionalChain([this, 'access', _158 => _158.#items, 'access', _159 => _159.at, 'call', _160 => _160(existingItemIndex + 1), 'optionalAccess', _161 => _161._parentPos]);
       newKey = makePosition(before2, after2);
       child._setParentLink(this, newKey);
     }
@@ -7194,7 +7365,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #applySetUndoRedo(op) {
     const { id, parentKey: key } = op;
     const child = creationOpToLiveNode(op);
-    if (_optionalChain([this, 'access', _140 => _140._pool, 'optionalAccess', _141 => _141.getNode, 'call', _142 => _142(id)]) !== void 0) {
+    if (_optionalChain([this, 'access', _162 => _162._pool, 'optionalAccess', _163 => _163.getNode, 'call', _164 => _164(id)]) !== void 0) {
       return { modified: false };
     }
     const indexOfItemWithSameKey = this._indexOfPosition(key);
@@ -7315,7 +7486,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     } else {
       this.#updateItemPositionAt(
         existingItemIndex,
-        makePosition(newKey, _optionalChain([this, 'access', _143 => _143.#items, 'access', _144 => _144.at, 'call', _145 => _145(existingItemIndex + 1), 'optionalAccess', _146 => _146._parentPos]))
+        makePosition(newKey, _optionalChain([this, 'access', _165 => _165.#items, 'access', _166 => _166.at, 'call', _167 => _167(existingItemIndex + 1), 'optionalAccess', _168 => _168._parentPos]))
       );
       const previousIndex = this.#items.findIndex((item) => item === child);
       this.#updateItemPosition(child, newKey);
@@ -7342,7 +7513,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
           this,
           makePosition(
             newKey,
-            _optionalChain([this, 'access', _147 => _147.#items, 'access', _148 => _148.at, 'call', _149 => _149(existingItemIndex + 1), 'optionalAccess', _150 => _150._parentPos])
+            _optionalChain([this, 'access', _169 => _169.#items, 'access', _170 => _170.at, 'call', _171 => _171(existingItemIndex + 1), 'optionalAccess', _172 => _172._parentPos])
           )
         );
         this.#items.reposition(existingItem);
@@ -7366,7 +7537,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
           existingItemIndex,
           makePosition(
             newKey,
-            _optionalChain([this, 'access', _151 => _151.#items, 'access', _152 => _152.at, 'call', _153 => _153(existingItemIndex + 1), 'optionalAccess', _154 => _154._parentPos])
+            _optionalChain([this, 'access', _173 => _173.#items, 'access', _174 => _174.at, 'call', _175 => _175(existingItemIndex + 1), 'optionalAccess', _176 => _176._parentPos])
           )
         );
       }
@@ -7394,7 +7565,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     if (existingItemIndex !== -1) {
       actualNewKey = makePosition(
         newKey,
-        _optionalChain([this, 'access', _155 => _155.#items, 'access', _156 => _156.at, 'call', _157 => _157(existingItemIndex + 1), 'optionalAccess', _158 => _158._parentPos])
+        _optionalChain([this, 'access', _177 => _177.#items, 'access', _178 => _178.at, 'call', _179 => _179(existingItemIndex + 1), 'optionalAccess', _180 => _180._parentPos])
       );
     }
     this.#updateItemPosition(child, actualNewKey);
@@ -7468,14 +7639,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', _159 => _159._pool, 'optionalAccess', _160 => _160.assertStorageIsWritable, 'call', _161 => _161()]);
+    _optionalChain([this, 'access', _181 => _181._pool, 'optionalAccess', _182 => _182.assertStorageIsWritable, 'call', _183 => _183()]);
     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', _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 before2 = _optionalChain([this, 'access', _184 => _184.#items, 'access', _185 => _185.at, 'call', _186 => _186(index - 1), 'optionalAccess', _187 => _187._parentPos]);
+    const after2 = _optionalChain([this, 'access', _188 => _188.#items, 'access', _189 => _189.at, 'call', _190 => _190(index), 'optionalAccess', _191 => _191._parentPos]);
     const position = makePosition(before2, after2);
     const value = lsonToLiveNode(element);
     value._setParentLink(this, position);
@@ -7499,7 +7670,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param targetIndex The index where the element should be after moving.
    */
   move(index, targetIndex) {
-    _optionalChain([this, 'access', _170 => _170._pool, 'optionalAccess', _171 => _171.assertStorageIsWritable, 'call', _172 => _172()]);
+    _optionalChain([this, 'access', _192 => _192._pool, 'optionalAccess', _193 => _193.assertStorageIsWritable, 'call', _194 => _194()]);
     if (targetIndex < 0) {
       throw new Error("targetIndex cannot be less than 0");
     }
@@ -7517,11 +7688,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', _173 => _173.#items, 'access', _174 => _174.at, 'call', _175 => _175(targetIndex + 1), 'optionalAccess', _176 => _176._parentPos]);
+      afterPosition = targetIndex === this.#items.length - 1 ? void 0 : _optionalChain([this, 'access', _195 => _195.#items, 'access', _196 => _196.at, 'call', _197 => _197(targetIndex + 1), 'optionalAccess', _198 => _198._parentPos]);
       beforePosition = this.#items.at(targetIndex)._parentPos;
     } else {
       afterPosition = this.#items.at(targetIndex)._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]);
+      beforePosition = targetIndex === 0 ? void 0 : _optionalChain([this, 'access', _199 => _199.#items, 'access', _200 => _200.at, 'call', _201 => _201(targetIndex - 1), 'optionalAccess', _202 => _202._parentPos]);
     }
     const position = makePosition(beforePosition, afterPosition);
     const item = this.#items.at(index);
@@ -7556,7 +7727,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * @param index The index of the element to delete
    */
   delete(index) {
-    _optionalChain([this, 'access', _181 => _181._pool, 'optionalAccess', _182 => _182.assertStorageIsWritable, 'call', _183 => _183()]);
+    _optionalChain([this, 'access', _203 => _203._pool, 'optionalAccess', _204 => _204.assertStorageIsWritable, 'call', _205 => _205()]);
     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}`
@@ -7589,7 +7760,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   clear() {
-    _optionalChain([this, 'access', _184 => _184._pool, 'optionalAccess', _185 => _185.assertStorageIsWritable, 'call', _186 => _186()]);
+    _optionalChain([this, 'access', _206 => _206._pool, 'optionalAccess', _207 => _207.assertStorageIsWritable, 'call', _208 => _208()]);
     if (this._pool) {
       const ops = [];
       const reverseOps = [];
@@ -7623,7 +7794,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   set(index, item) {
-    _optionalChain([this, 'access', _187 => _187._pool, 'optionalAccess', _188 => _188.assertStorageIsWritable, 'call', _189 => _189()]);
+    _optionalChain([this, 'access', _209 => _209._pool, 'optionalAccess', _210 => _210.assertStorageIsWritable, 'call', _211 => _211()]);
     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}`
@@ -7782,7 +7953,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
   #shiftItemPosition(index, key) {
     const shiftedPosition = makePosition(
       key,
-      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.#items.length > index + 1 ? _optionalChain([this, 'access', _212 => _212.#items, 'access', _213 => _213.at, 'call', _214 => _214(index + 1), 'optionalAccess', _215 => _215._parentPos]) : void 0
     );
     this.#updateItemPositionAt(index, shiftedPosition);
   }
@@ -8031,7 +8202,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', _194 => _194._pool, 'optionalAccess', _195 => _195.assertStorageIsWritable, 'call', _196 => _196()]);
+    _optionalChain([this, 'access', _216 => _216._pool, 'optionalAccess', _217 => _217.assertStorageIsWritable, 'call', _218 => _218()]);
     const oldValue = this.#map.get(key);
     if (oldValue) {
       oldValue._detach();
@@ -8077,7 +8248,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', _197 => _197._pool, 'optionalAccess', _198 => _198.assertStorageIsWritable, 'call', _199 => _199()]);
+    _optionalChain([this, 'access', _219 => _219._pool, 'optionalAccess', _220 => _220.assertStorageIsWritable, 'call', _221 => _221()]);
     const item = this.#map.get(key);
     if (item === void 0) {
       return false;
@@ -8247,6 +8418,8 @@ function reconcile(live, json, config) {
     return reconcileLiveList(live, json, config);
   } else if (isLiveMap(live) && isPlainObject(json)) {
     return reconcileLiveMap(live, config);
+  } else if (isLiveFile(live) && shallow(live.data, json)) {
+    return live;
   } else {
     return deepLiveify(json, config);
   }
@@ -8689,20 +8862,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', _200 => _200._pool, 'optionalAccess', _201 => _201.assertStorageIsWritable, 'call', _202 => _202()]);
+    _optionalChain([this, 'access', _222 => _222._pool, 'optionalAccess', _223 => _223.assertStorageIsWritable, 'call', _224 => _224()]);
     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', _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 ops = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _225 => _225[0]]), () => ( []));
+      const reverse = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _226 => _226[1]]), () => ( []));
+      const storageUpdates = _nullishCoalesce(_optionalChain([deleteResult, 'optionalAccess', _227 => _227[2]]), () => ( /* @__PURE__ */ new Map()));
       const existing = storageUpdates.get(this._id);
       storageUpdates.set(this._id, {
         node: this,
         type: "LiveObject",
         updates: {
-          ..._optionalChain([existing, 'optionalAccess', _206 => _206.updates]),
+          ..._optionalChain([existing, 'optionalAccess', _228 => _228.updates]),
           [key]: { type: "update" }
         }
       });
@@ -8722,7 +8895,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * #synced or pool/id are unavailable. Does NOT dispatch.
    */
   #prepareDelete(key) {
-    _optionalChain([this, 'access', _207 => _207._pool, 'optionalAccess', _208 => _208.assertStorageIsWritable, 'call', _209 => _209()]);
+    _optionalChain([this, 'access', _229 => _229._pool, 'optionalAccess', _230 => _230.assertStorageIsWritable, 'call', _231 => _231()]);
     const k = key;
     if (this.#local.has(k) && !this.#synced.has(k)) {
       const oldValue2 = this.#local.get(k);
@@ -8798,7 +8971,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
     const result = this.#prepareDelete(key);
     if (result) {
       const [ops, reverse, storageUpdates] = result;
-      _optionalChain([this, 'access', _210 => _210._pool, 'optionalAccess', _211 => _211.dispatch, 'call', _212 => _212(ops, reverse, storageUpdates)]);
+      _optionalChain([this, 'access', _232 => _232._pool, 'optionalAccess', _233 => _233.dispatch, 'call', _234 => _234(ops, reverse, storageUpdates)]);
     }
   }
   /**
@@ -8806,7 +8979,7 @@ var LiveObject = (_class2 = class _LiveObject extends AbstractCrdt {
    * @param patch The object used to overrides properties
    */
   update(patch) {
-    _optionalChain([this, 'access', _213 => _213._pool, 'optionalAccess', _214 => _214.assertStorageIsWritable, 'call', _215 => _215()]);
+    _optionalChain([this, 'access', _235 => _235._pool, 'optionalAccess', _236 => _236.assertStorageIsWritable, 'call', _237 => _237()]);
     if (_LiveObject.detectLargeObjects) {
       const data = {};
       for (const [key, value] of this.#synced) {
@@ -9173,8 +9346,31 @@ function isJsonEq(a, b) {
 }
 function diffNodeMap(prev, next) {
   const ops = [];
-  prev.forEach((_, id) => {
-    if (!next.get(id)) {
+  const idsToRecreate = /* @__PURE__ */ new Set();
+  next.forEach((nextCrdt, id) => {
+    const currentCrdt = prev.get(id);
+    if (currentCrdt === void 0) {
+      return;
+    }
+    if (currentCrdt.type !== nextCrdt.type || currentCrdt.type === CrdtType.FILE && nextCrdt.type === CrdtType.FILE && (currentCrdt.data.id !== nextCrdt.data.id || currentCrdt.data.name !== nextCrdt.data.name || currentCrdt.data.size !== nextCrdt.data.size || currentCrdt.data.mimeType !== nextCrdt.data.mimeType)) {
+      idsToRecreate.add(id);
+    }
+  });
+  let foundDescendant = true;
+  while (foundDescendant) {
+    foundDescendant = false;
+    for (const nodes of [prev, next]) {
+      nodes.forEach((crdt, id) => {
+        if (!idsToRecreate.has(id) && crdt.parentId !== void 0 && idsToRecreate.has(crdt.parentId)) {
+          idsToRecreate.add(id);
+          foundDescendant = true;
+        }
+      });
+    }
+  }
+  prev.forEach((crdt, id) => {
+    const parentWillBeRecreated = crdt.parentId !== void 0 && idsToRecreate.has(crdt.parentId);
+    if ((!next.has(id) || idsToRecreate.has(id)) && !parentWillBeRecreated) {
       ops.push({ type: OpCode.DELETE_CRDT, id });
     }
   });
@@ -9185,7 +9381,7 @@ function diffNodeMap(prev, next) {
     }
     emitted.add(id);
     const parentId = crdt.parentId;
-    if (parentId !== void 0 && !prev.has(parentId)) {
+    if (parentId !== void 0 && (!prev.has(parentId) || idsToRecreate.has(parentId))) {
       const parentCrdt = next.get(parentId);
       if (parentCrdt !== void 0) {
         emitCreate(parentId, parentCrdt);
@@ -9244,29 +9440,25 @@ function diffNodeMap(prev, next) {
   }
   next.forEach((crdt, id) => {
     const currentCrdt = prev.get(id);
-    if (currentCrdt) {
-      if (crdt.type === CrdtType.OBJECT) {
-        if (currentCrdt.type !== CrdtType.OBJECT) {
-          ops.push({ type: OpCode.UPDATE_OBJECT, id, data: crdt.data });
-        } else {
-          const changed = /* @__PURE__ */ new Map();
-          for (const key of Object.keys(crdt.data)) {
-            const value = crdt.data[key];
-            if (value !== void 0 && !isJsonEq(value, currentCrdt.data[key])) {
-              changed.set(key, value);
-            }
-          }
-          if (changed.size > 0) {
-            ops.push({
-              type: OpCode.UPDATE_OBJECT,
-              id,
-              data: Object.fromEntries(changed)
-            });
+    if (currentCrdt && !idsToRecreate.has(id)) {
+      if (crdt.type === CrdtType.OBJECT && currentCrdt.type === CrdtType.OBJECT) {
+        const changed = /* @__PURE__ */ new Map();
+        for (const key of Object.keys(crdt.data)) {
+          const value = crdt.data[key];
+          if (value !== void 0 && !isJsonEq(value, currentCrdt.data[key])) {
+            changed.set(key, value);
           }
-          for (const key of Object.keys(currentCrdt.data)) {
-            if (!(key in crdt.data)) {
-              ops.push({ type: OpCode.DELETE_OBJECT_KEY, id, key });
-            }
+        }
+        if (changed.size > 0) {
+          ops.push({
+            type: OpCode.UPDATE_OBJECT,
+            id,
+            data: Object.fromEntries(changed)
+          });
+        }
+        for (const key of Object.keys(currentCrdt.data)) {
+          if (!(key in crdt.data)) {
+            ops.push({ type: OpCode.DELETE_OBJECT_KEY, id, key });
           }
         }
       }
@@ -9338,7 +9530,7 @@ function sendToPanel(message, options) {
     ...message,
     source: "liveblocks-devtools-client"
   };
-  if (!(_optionalChain([options, 'optionalAccess', _216 => _216.force]) || _bridgeActive)) {
+  if (!(_optionalChain([options, 'optionalAccess', _238 => _238.force]) || _bridgeActive)) {
     return;
   }
   window.postMessage(fullMsg, "*");
@@ -9346,7 +9538,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', _217 => _217.data, 'optionalAccess', _218 => _218.source]) === "liveblocks-devtools-panel") {
+    if (event.source === window && _optionalChain([event, 'access', _239 => _239.data, 'optionalAccess', _240 => _240.source]) === "liveblocks-devtools-panel") {
       eventSource.notify(event.data);
     } else {
     }
@@ -9488,7 +9680,7 @@ function fullSync(room) {
     msg: "room::sync::full",
     roomId: room.id,
     status: room.getStatus(),
-    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _219 => _219.toTreeNode, 'call', _220 => _220("root"), 'access', _221 => _221.payload]), () => ( null)),
+    storage: _nullishCoalesce(_optionalChain([root, 'optionalAccess', _241 => _241.toTreeNode, 'call', _242 => _242("root"), 'access', _243 => _243.payload]), () => ( null)),
     me,
     others
   });
@@ -10175,15 +10367,15 @@ function installBackgroundTabSpy() {
   const doc = typeof document !== "undefined" ? document : void 0;
   const inBackgroundSince = { current: null };
   function onVisibilityChange() {
-    if (_optionalChain([doc, 'optionalAccess', _222 => _222.visibilityState]) === "hidden") {
+    if (_optionalChain([doc, 'optionalAccess', _244 => _244.visibilityState]) === "hidden") {
       inBackgroundSince.current = _nullishCoalesce(inBackgroundSince.current, () => ( Date.now()));
     } else {
       inBackgroundSince.current = null;
     }
   }
-  _optionalChain([doc, 'optionalAccess', _223 => _223.addEventListener, 'call', _224 => _224("visibilitychange", onVisibilityChange)]);
+  _optionalChain([doc, 'optionalAccess', _245 => _245.addEventListener, 'call', _246 => _246("visibilitychange", onVisibilityChange)]);
   const unsub = () => {
-    _optionalChain([doc, 'optionalAccess', _225 => _225.removeEventListener, 'call', _226 => _226("visibilitychange", onVisibilityChange)]);
+    _optionalChain([doc, 'optionalAccess', _247 => _247.removeEventListener, 'call', _248 => _248("visibilitychange", onVisibilityChange)]);
   };
   return [inBackgroundSince, unsub];
 }
@@ -10207,7 +10399,7 @@ 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])) {
+  for (const key in _optionalChain([root, 'optionalAccess', _249 => _249.data])) {
     keys2.add(key);
   }
   for (const node of nodes.values()) {
@@ -10390,7 +10582,7 @@ function createRoom(options, config) {
     }
   }
   function isStorageWritable() {
-    const permissionMatrix = _optionalChain([context, 'access', _228 => _228.dynamicSessionInfoSig, 'access', _229 => _229.get, 'call', _230 => _230(), 'optionalAccess', _231 => _231.permissionMatrix]);
+    const permissionMatrix = _optionalChain([context, 'access', _250 => _250.dynamicSessionInfoSig, 'access', _251 => _251.get, 'call', _252 => _252(), 'optionalAccess', _253 => _253.permissionMatrix]);
     return permissionMatrix !== void 0 ? hasPermissionAccess(permissionMatrix, "storage", "write") : true;
   }
   const eventHub = {
@@ -10510,7 +10702,7 @@ function createRoom(options, config) {
         context.pool
       );
     }
-    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _232 => _232.get, 'call', _233 => _233(), 'optionalAccess', _234 => _234.canWrite]), () => ( true));
+    const canWrite = _nullishCoalesce(_optionalChain([self, 'access', _254 => _254.get, 'call', _255 => _255(), 'optionalAccess', _256 => _256.canWrite]), () => ( true));
     const serverTopLevelKeys = topLevelKeysOf(nodes);
     const root = context.root;
     disableHistory(() => {
@@ -10743,7 +10935,7 @@ function createRoom(options, config) {
     }
     context.myPresence.patch(patch);
     if (context.activeBatch) {
-      if (_optionalChain([options2, 'optionalAccess', _235 => _235.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _257 => _257.addToHistory])) {
         context.activeBatch.reverseOps.pushLeft({
           type: "presence",
           data: oldValues
@@ -10752,7 +10944,7 @@ function createRoom(options, config) {
       context.activeBatch.updates.presence = true;
     } else {
       flushNowOrSoon();
-      if (_optionalChain([options2, 'optionalAccess', _236 => _236.addToHistory])) {
+      if (_optionalChain([options2, 'optionalAccess', _258 => _258.addToHistory])) {
         addToUndoStack([{ type: "presence", data: oldValues }]);
       }
       notify({ presence: true });
@@ -10931,11 +11123,11 @@ function createRoom(options, config) {
           break;
         }
         case ServerMsgCode.STORAGE_CHUNK:
-          _optionalChain([stopwatch, 'optionalAccess', _237 => _237.lap, 'call', _238 => _238()]);
+          _optionalChain([stopwatch, 'optionalAccess', _259 => _259.lap, 'call', _260 => _260()]);
           nodeMapBuffer.append(compactNodesToNodeStream(message.nodes));
           break;
         case ServerMsgCode.STORAGE_STREAM_END: {
-          const timing = _optionalChain([stopwatch, 'optionalAccess', _239 => _239.stop, 'call', _240 => _240()]);
+          const timing = _optionalChain([stopwatch, 'optionalAccess', _261 => _261.stop, 'call', _262 => _262()]);
           if (timing) {
             const ms = (v) => `${v.toFixed(1)}ms`;
             const rest = timing.laps.slice(1);
@@ -11070,11 +11262,11 @@ function createRoom(options, config) {
           } else if (pendingFeedsRequests.has(requestId)) {
             const pending = pendingFeedsRequests.get(requestId);
             pendingFeedsRequests.delete(requestId);
-            _optionalChain([pending, 'optionalAccess', _241 => _241.reject, 'call', _242 => _242(err)]);
+            _optionalChain([pending, 'optionalAccess', _263 => _263.reject, 'call', _264 => _264(err)]);
           } else if (pendingFeedMessagesRequests.has(requestId)) {
             const pending = pendingFeedMessagesRequests.get(requestId);
             pendingFeedMessagesRequests.delete(requestId);
-            _optionalChain([pending, 'optionalAccess', _243 => _243.reject, 'call', _244 => _244(err)]);
+            _optionalChain([pending, 'optionalAccess', _265 => _265.reject, 'call', _266 => _266(err)]);
           }
           eventHub.feeds.notify(message);
           break;
@@ -11228,10 +11420,10 @@ function createRoom(options, config) {
       timeoutId,
       kind,
       feedId,
-      messageId: _optionalChain([options2, 'optionalAccess', _245 => _245.messageId]),
-      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _246 => _246.expectedClientMessageId])
+      messageId: _optionalChain([options2, 'optionalAccess', _267 => _267.messageId]),
+      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _268 => _268.expectedClientMessageId])
     });
-    if (kind === "add-message" && _optionalChain([options2, 'optionalAccess', _247 => _247.expectedClientMessageId]) === void 0) {
+    if (kind === "add-message" && _optionalChain([options2, 'optionalAccess', _269 => _269.expectedClientMessageId]) === void 0) {
       const q = _nullishCoalesce(pendingAddMessageFifoByFeed.get(feedId), () => ( []));
       q.push(requestId);
       pendingAddMessageFifoByFeed.set(feedId, q);
@@ -11282,10 +11474,10 @@ function createRoom(options, config) {
           }
           if (!matched) {
             const q = pendingAddMessageFifoByFeed.get(message.feedId);
-            const headId = _optionalChain([q, 'optionalAccess', _248 => _248[0]]);
+            const headId = _optionalChain([q, 'optionalAccess', _270 => _270[0]]);
             if (headId !== void 0) {
               const pending = pendingFeedMutations.get(headId);
-              if (_optionalChain([pending, 'optionalAccess', _249 => _249.kind]) === "add-message" && pending.expectedClientMessageId === void 0) {
+              if (_optionalChain([pending, 'optionalAccess', _271 => _271.kind]) === "add-message" && pending.expectedClientMessageId === void 0) {
                 settleFeedMutation(headId, "ok");
               }
             }
@@ -11321,7 +11513,7 @@ function createRoom(options, config) {
     const unacknowledgedOps2 = [...context.unacknowledgedOps.values()];
     createOrUpdateRootFromMessage(nodes);
     applyAndSendOfflineOps(unacknowledgedOps2);
-    _optionalChain([_resolveStoragePromise, 'optionalCall', _250 => _250()]);
+    _optionalChain([_resolveStoragePromise, 'optionalCall', _272 => _272()]);
     notifyStorageStatus();
     eventHub.storageDidLoad.notify();
   }
@@ -11330,7 +11522,7 @@ function createRoom(options, config) {
     if (!messages.some((msg) => msg.type === ClientMsgCode.FETCH_STORAGE)) {
       messages.push({ type: ClientMsgCode.FETCH_STORAGE });
       nodeMapBuffer.take();
-      _optionalChain([stopwatch, 'optionalAccess', _251 => _251.start, 'call', _252 => _252()]);
+      _optionalChain([stopwatch, 'optionalAccess', _273 => _273.start, 'call', _274 => _274()]);
     }
   }
   function startLoadingStorage() {
@@ -11384,10 +11576,10 @@ function createRoom(options, config) {
     const message = {
       type: ClientMsgCode.FETCH_FEEDS,
       requestId,
-      cursor: _optionalChain([options2, 'optionalAccess', _253 => _253.cursor]),
-      since: _optionalChain([options2, 'optionalAccess', _254 => _254.since]),
-      limit: _optionalChain([options2, 'optionalAccess', _255 => _255.limit]),
-      metadata: _optionalChain([options2, 'optionalAccess', _256 => _256.metadata])
+      cursor: _optionalChain([options2, 'optionalAccess', _275 => _275.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _276 => _276.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _277 => _277.limit]),
+      metadata: _optionalChain([options2, 'optionalAccess', _278 => _278.metadata])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11407,9 +11599,9 @@ function createRoom(options, config) {
       type: ClientMsgCode.FETCH_FEED_MESSAGES,
       requestId,
       feedId,
-      cursor: _optionalChain([options2, 'optionalAccess', _257 => _257.cursor]),
-      since: _optionalChain([options2, 'optionalAccess', _258 => _258.since]),
-      limit: _optionalChain([options2, 'optionalAccess', _259 => _259.limit])
+      cursor: _optionalChain([options2, 'optionalAccess', _279 => _279.cursor]),
+      since: _optionalChain([options2, 'optionalAccess', _280 => _280.since]),
+      limit: _optionalChain([options2, 'optionalAccess', _281 => _281.limit])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11428,8 +11620,8 @@ function createRoom(options, config) {
       type: ClientMsgCode.ADD_FEED,
       requestId,
       feedId,
-      metadata: _optionalChain([options2, 'optionalAccess', _260 => _260.metadata]),
-      createdAt: _optionalChain([options2, 'optionalAccess', _261 => _261.createdAt])
+      metadata: _optionalChain([options2, 'optionalAccess', _282 => _282.metadata]),
+      createdAt: _optionalChain([options2, 'optionalAccess', _283 => _283.createdAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11463,15 +11655,15 @@ function createRoom(options, config) {
   function addFeedMessage(feedId, data, options2) {
     const requestId = nanoid();
     const promise = registerFeedMutation(requestId, "add-message", feedId, {
-      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _262 => _262.id])
+      expectedClientMessageId: _optionalChain([options2, 'optionalAccess', _284 => _284.id])
     });
     const message = {
       type: ClientMsgCode.ADD_FEED_MESSAGE,
       requestId,
       feedId,
       data,
-      id: _optionalChain([options2, 'optionalAccess', _263 => _263.id]),
-      createdAt: _optionalChain([options2, 'optionalAccess', _264 => _264.createdAt])
+      id: _optionalChain([options2, 'optionalAccess', _285 => _285.id]),
+      createdAt: _optionalChain([options2, 'optionalAccess', _286 => _286.createdAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11488,7 +11680,7 @@ function createRoom(options, config) {
       feedId,
       messageId,
       data,
-      updatedAt: _optionalChain([options2, 'optionalAccess', _265 => _265.updatedAt])
+      updatedAt: _optionalChain([options2, 'optionalAccess', _287 => _287.updatedAt])
     };
     context.buffer.messages.push(message);
     flushNowOrSoon();
@@ -11695,8 +11887,8 @@ function createRoom(options, config) {
   async function getThreads(options2) {
     return httpClient.getThreads({
       roomId,
-      query: _optionalChain([options2, 'optionalAccess', _266 => _266.query]),
-      cursor: _optionalChain([options2, 'optionalAccess', _267 => _267.cursor])
+      query: _optionalChain([options2, 'optionalAccess', _288 => _288.query]),
+      cursor: _optionalChain([options2, 'optionalAccess', _289 => _289.cursor])
     });
   }
   async function getThread(threadId) {
@@ -11829,7 +12021,7 @@ function createRoom(options, config) {
   function getSubscriptionSettings(options2) {
     return httpClient.getSubscriptionSettings({
       roomId,
-      signal: _optionalChain([options2, 'optionalAccess', _268 => _268.signal])
+      signal: _optionalChain([options2, 'optionalAccess', _290 => _290.signal])
     });
   }
   function updateSubscriptionSettings(settings) {
@@ -11851,7 +12043,7 @@ function createRoom(options, config) {
     {
       [kInternal]: {
         get presenceBuffer() {
-          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _269 => _269.buffer, 'access', _270 => _270.presenceUpdates, 'optionalAccess', _271 => _271.data]), () => ( null)));
+          return deepClone(_nullishCoalesce(_optionalChain([context, 'access', _291 => _291.buffer, 'access', _292 => _292.presenceUpdates, 'optionalAccess', _293 => _293.data]), () => ( null)));
         },
         // prettier-ignore
         get undoStack() {
@@ -11866,15 +12058,15 @@ function createRoom(options, config) {
           return context.yjsProvider;
         },
         setYjsProvider(newProvider) {
-          _optionalChain([context, 'access', _272 => _272.yjsProvider, 'optionalAccess', _273 => _273.off, 'call', _274 => _274("status", yjsStatusDidChange)]);
+          _optionalChain([context, 'access', _294 => _294.yjsProvider, 'optionalAccess', _295 => _295.off, 'call', _296 => _296("status", yjsStatusDidChange)]);
           context.yjsProvider = newProvider;
-          _optionalChain([newProvider, 'optionalAccess', _275 => _275.on, 'call', _276 => _276("status", yjsStatusDidChange)]);
+          _optionalChain([newProvider, 'optionalAccess', _297 => _297.on, 'call', _298 => _298("status", yjsStatusDidChange)]);
           context.yjsProviderDidChange.notify();
         },
         yjsProviderDidChange: context.yjsProviderDidChange.observable,
         // send metadata when using a text editor
         reportTextEditor,
-        getPermissionMatrix: () => _optionalChain([context, 'access', _277 => _277.dynamicSessionInfoSig, 'access', _278 => _278.get, 'call', _279 => _279(), 'optionalAccess', _280 => _280.permissionMatrix]),
+        getPermissionMatrix: () => _optionalChain([context, 'access', _299 => _299.dynamicSessionInfoSig, 'access', _300 => _300.get, 'call', _301 => _301(), 'optionalAccess', _302 => _302.permissionMatrix]),
         // create a text mention when using a text editor
         createTextMention,
         // delete a text mention when using a text editor
@@ -11937,7 +12129,7 @@ ${dumpPool(
           source.dispose();
         }
         eventHub.roomWillDestroy.notify();
-        _optionalChain([context, 'access', _281 => _281.yjsProvider, 'optionalAccess', _282 => _282.off, 'call', _283 => _283("status", yjsStatusDidChange)]);
+        _optionalChain([context, 'access', _303 => _303.yjsProvider, 'optionalAccess', _304 => _304.off, 'call', _305 => _305("status", yjsStatusDidChange)]);
         syncSourceForStorage.destroy();
         syncSourceForYjs.destroy();
         uninstallBgTabSpy();
@@ -12101,7 +12293,7 @@ function makeClassicSubscribeFn(roomId, events, errorEvents) {
     }
     if (isLiveNode(first)) {
       const node = first;
-      if (_optionalChain([options, 'optionalAccess', _284 => _284.isDeep])) {
+      if (_optionalChain([options, 'optionalAccess', _306 => _306.isDeep])) {
         const storageCallback = second;
         return subscribeToLiveStructureDeeply(node, storageCallback);
       } else {
@@ -12191,8 +12383,8 @@ function createClient(options) {
   const authManager = createAuthManager(options, (token) => {
     currentUserId.set(() => token.uid);
   });
-  const fetchPolyfill = _optionalChain([clientOptions, 'access', _285 => _285.polyfills, 'optionalAccess', _286 => _286.fetch]) || /* istanbul ignore next */
-  _optionalChain([globalThis, 'access', _287 => _287.fetch, 'optionalAccess', _288 => _288.bind, 'call', _289 => _289(globalThis)]);
+  const fetchPolyfill = _optionalChain([clientOptions, 'access', _307 => _307.polyfills, 'optionalAccess', _308 => _308.fetch]) || /* istanbul ignore next */
+  _optionalChain([globalThis, 'access', _309 => _309.fetch, 'optionalAccess', _310 => _310.bind, 'call', _311 => _311(globalThis)]);
   const httpClient = createApiClient({
     baseUrl,
     fetchPolyfill,
@@ -12209,7 +12401,7 @@ function createClient(options) {
     delegates: {
       createSocket: makeCreateSocketDelegateForAi(
         baseUrl,
-        _optionalChain([clientOptions, 'access', _290 => _290.polyfills, 'optionalAccess', _291 => _291.WebSocket])
+        _optionalChain([clientOptions, 'access', _312 => _312.polyfills, 'optionalAccess', _313 => _313.WebSocket])
       ),
       authenticate: async () => {
         const resp = await authManager.getAuthValue({
@@ -12280,7 +12472,7 @@ function createClient(options) {
           createSocket: makeCreateSocketDelegateForRoom(
             roomId,
             baseUrl,
-            _optionalChain([clientOptions, 'access', _292 => _292.polyfills, 'optionalAccess', _293 => _293.WebSocket])
+            _optionalChain([clientOptions, 'access', _314 => _314.polyfills, 'optionalAccess', _315 => _315.WebSocket])
           ),
           authenticate: makeAuthDelegateForRoom(roomId, authManager)
         })),
@@ -12302,7 +12494,7 @@ function createClient(options) {
     const shouldConnect = _nullishCoalesce(options2.autoConnect, () => ( true));
     if (shouldConnect) {
       if (typeof atob === "undefined") {
-        if (_optionalChain([clientOptions, 'access', _294 => _294.polyfills, 'optionalAccess', _295 => _295.atob]) === void 0) {
+        if (_optionalChain([clientOptions, 'access', _316 => _316.polyfills, 'optionalAccess', _317 => _317.atob]) === void 0) {
           throw new Error(
             "You need to polyfill atob to use the client in your environment. Please follow the instructions at https://liveblocks.io/docs/errors/liveblocks-client/atob-polyfill"
           );
@@ -12314,7 +12506,7 @@ function createClient(options) {
     return leaseRoom(newRoomDetails);
   }
   function getRoom(roomId) {
-    const room = _optionalChain([roomsById, 'access', _296 => _296.get, 'call', _297 => _297(roomId), 'optionalAccess', _298 => _298.room]);
+    const room = _optionalChain([roomsById, 'access', _318 => _318.get, 'call', _319 => _319(roomId), 'optionalAccess', _320 => _320.room]);
     return room ? room : null;
   }
   function logout() {
@@ -12330,7 +12522,7 @@ function createClient(options) {
   const batchedResolveUsers = new Batch(
     async (batchedUserIds) => {
       const userIds = batchedUserIds.flat();
-      const users = await _optionalChain([resolveUsers, 'optionalCall', _299 => _299({ userIds })]);
+      const users = await _optionalChain([resolveUsers, 'optionalCall', _321 => _321({ userIds })]);
       warnOnceIf(
         !resolveUsers,
         "Set the resolveUsers option in createClient to specify user info."
@@ -12347,7 +12539,7 @@ function createClient(options) {
   const batchedResolveRoomsInfo = new Batch(
     async (batchedRoomIds) => {
       const roomIds = batchedRoomIds.flat();
-      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _300 => _300({ roomIds })]);
+      const roomsInfo = await _optionalChain([resolveRoomsInfo, 'optionalCall', _322 => _322({ roomIds })]);
       warnOnceIf(
         !resolveRoomsInfo,
         "Set the resolveRoomsInfo option in createClient to specify room info."
@@ -12364,7 +12556,7 @@ function createClient(options) {
   const batchedResolveGroupsInfo = new Batch(
     async (batchedGroupIds) => {
       const groupIds = batchedGroupIds.flat();
-      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _301 => _301({ groupIds })]);
+      const groupsInfo = await _optionalChain([resolveGroupsInfo, 'optionalCall', _323 => _323({ groupIds })]);
       warnOnceIf(
         !resolveGroupsInfo,
         "Set the resolveGroupsInfo option in createClient to specify group info."
@@ -12423,7 +12615,7 @@ function createClient(options) {
       }
     };
     const win = typeof window !== "undefined" ? window : void 0;
-    _optionalChain([win, 'optionalAccess', _302 => _302.addEventListener, 'call', _303 => _303("beforeunload", maybePreventClose)]);
+    _optionalChain([win, 'optionalAccess', _324 => _324.addEventListener, 'call', _325 => _325("beforeunload", maybePreventClose)]);
   }
   async function getNotificationSettings(options2) {
     const plainSettings = await httpClient.getNotificationSettings(options2);
@@ -12551,7 +12743,7 @@ var commentBodyElementsTypes = {
   mention: "inline"
 };
 function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
-  if (!body || !_optionalChain([body, 'optionalAccess', _304 => _304.content])) {
+  if (!body || !_optionalChain([body, 'optionalAccess', _326 => _326.content])) {
     return;
   }
   const element = typeof elementOrVisitor === "string" ? elementOrVisitor : void 0;
@@ -12561,13 +12753,13 @@ function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
   for (const block of body.content) {
     if (type === "all" || type === "block") {
       if (guard(block)) {
-        _optionalChain([visitor, 'optionalCall', _305 => _305(block)]);
+        _optionalChain([visitor, 'optionalCall', _327 => _327(block)]);
       }
     }
     if (type === "all" || type === "inline") {
       for (const inline of block.children) {
         if (guard(inline)) {
-          _optionalChain([visitor, 'optionalCall', _306 => _306(inline)]);
+          _optionalChain([visitor, 'optionalCall', _328 => _328(inline)]);
         }
       }
     }
@@ -12737,7 +12929,7 @@ var stringifyCommentBodyPlainElements = {
   text: ({ element }) => element.text,
   link: ({ element }) => _nullishCoalesce(element.text, () => ( element.url)),
   mention: ({ element, user, group }) => {
-    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _307 => _307.name]), () => ( _optionalChain([group, 'optionalAccess', _308 => _308.name]))), () => ( element.id))}`;
+    return `@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _329 => _329.name]), () => ( _optionalChain([group, 'optionalAccess', _330 => _330.name]))), () => ( element.id))}`;
   }
 };
 var stringifyCommentBodyHtmlElements = {
@@ -12767,7 +12959,7 @@ var stringifyCommentBodyHtmlElements = {
     return html`<a href="${href}" target="_blank" rel="noopener noreferrer">${element.text ? html`${element.text}` : element.url}</a>`;
   },
   mention: ({ element, user, group }) => {
-    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _309 => _309.name]) ? html`${_optionalChain([user, 'optionalAccess', _310 => _310.name])}` : _optionalChain([group, 'optionalAccess', _311 => _311.name]) ? html`${_optionalChain([group, 'optionalAccess', _312 => _312.name])}` : element.id}</span>`;
+    return html`<span data-mention>@${_optionalChain([user, 'optionalAccess', _331 => _331.name]) ? html`${_optionalChain([user, 'optionalAccess', _332 => _332.name])}` : _optionalChain([group, 'optionalAccess', _333 => _333.name]) ? html`${_optionalChain([group, 'optionalAccess', _334 => _334.name])}` : element.id}</span>`;
   }
 };
 var stringifyCommentBodyMarkdownElements = {
@@ -12797,20 +12989,20 @@ var stringifyCommentBodyMarkdownElements = {
     return markdown`[${_nullishCoalesce(element.text, () => ( element.url))}](${href})`;
   },
   mention: ({ element, user, group }) => {
-    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _313 => _313.name]), () => ( _optionalChain([group, 'optionalAccess', _314 => _314.name]))), () => ( element.id))}`;
+    return markdown`@${_nullishCoalesce(_nullishCoalesce(_optionalChain([user, 'optionalAccess', _335 => _335.name]), () => ( _optionalChain([group, 'optionalAccess', _336 => _336.name]))), () => ( element.id))}`;
   }
 };
 async function stringifyCommentBody(body, options) {
-  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _315 => _315.format]), () => ( "plain"));
-  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _316 => _316.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
+  const format = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _337 => _337.format]), () => ( "plain"));
+  const separator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _338 => _338.separator]), () => ( (format === "markdown" ? "\n\n" : "\n")));
   const elements = {
     ...format === "html" ? stringifyCommentBodyHtmlElements : format === "markdown" ? stringifyCommentBodyMarkdownElements : stringifyCommentBodyPlainElements,
-    ..._optionalChain([options, 'optionalAccess', _317 => _317.elements])
+    ..._optionalChain([options, 'optionalAccess', _339 => _339.elements])
   };
   const { users: resolvedUsers, groups: resolvedGroupsInfo } = await resolveMentionsInCommentBody(
     body,
-    _optionalChain([options, 'optionalAccess', _318 => _318.resolveUsers]),
-    _optionalChain([options, 'optionalAccess', _319 => _319.resolveGroupsInfo])
+    _optionalChain([options, 'optionalAccess', _340 => _340.resolveUsers]),
+    _optionalChain([options, 'optionalAccess', _341 => _341.resolveGroupsInfo])
   );
   const blocks = body.content.flatMap((block, blockIndex) => {
     switch (block.type) {
@@ -12950,9 +13142,9 @@ function makePoller(callback, intervalMs, options) {
   const startTime = performance.now();
   const doc = typeof document !== "undefined" ? document : void 0;
   const win = typeof window !== "undefined" ? window : void 0;
-  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _320 => _320.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
+  const maxStaleTimeMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _342 => _342.maxStaleTimeMs]), () => ( Number.POSITIVE_INFINITY));
   const context = {
-    inForeground: _optionalChain([doc, 'optionalAccess', _321 => _321.visibilityState]) !== "hidden",
+    inForeground: _optionalChain([doc, 'optionalAccess', _343 => _343.visibilityState]) !== "hidden",
     lastSuccessfulPollAt: startTime,
     count: 0,
     backoff: 0
@@ -13033,11 +13225,11 @@ function makePoller(callback, intervalMs, options) {
     pollNowIfStale();
   }
   function onVisibilityChange() {
-    setInForeground(_optionalChain([doc, 'optionalAccess', _322 => _322.visibilityState]) !== "hidden");
+    setInForeground(_optionalChain([doc, 'optionalAccess', _344 => _344.visibilityState]) !== "hidden");
   }
-  _optionalChain([doc, 'optionalAccess', _323 => _323.addEventListener, 'call', _324 => _324("visibilitychange", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _325 => _325.addEventListener, 'call', _326 => _326("online", onVisibilityChange)]);
-  _optionalChain([win, 'optionalAccess', _327 => _327.addEventListener, 'call', _328 => _328("focus", pollNowIfStale)]);
+  _optionalChain([doc, 'optionalAccess', _345 => _345.addEventListener, 'call', _346 => _346("visibilitychange", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _347 => _347.addEventListener, 'call', _348 => _348("online", onVisibilityChange)]);
+  _optionalChain([win, 'optionalAccess', _349 => _349.addEventListener, 'call', _350 => _350("focus", pollNowIfStale)]);
   fsm.start();
   return {
     inc,