@liveblocks/core 3.20.0-rc1 → 3.21.0-exp1

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.20.0-rc1";
+var PKG_VERSION = "3.21.0-exp1";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -1570,7 +1570,6 @@ function isUrl(string) {
 function createApiClient({
   baseUrl,
   authManager,
-  currentUserId,
   fetchPolyfill
 }) {
   const httpClient = new HttpClient(baseUrl, fetchPolyfill);
@@ -1578,8 +1577,9 @@ function createApiClient({
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/threads/delta`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       }),
       {
         since: options.since.toISOString()
@@ -1617,8 +1617,9 @@ function createApiClient({
       const result = await httpClient.get(
         url`/v2/c/rooms/${options.roomId}/threads`,
         await authManager.getAuthValue({
-          requestedScope: "comments:read",
-          roomId: options.roomId
+          roomId: options.roomId,
+          resource: "comments",
+          access: "read"
         }),
         {
           cursor: options.cursor,
@@ -1662,8 +1663,9 @@ function createApiClient({
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/threads/comments/search`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       }),
       {
         text: options.query.text,
@@ -1684,8 +1686,9 @@ function createApiClient({
     const thread = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       {
         id: threadId,
@@ -1704,8 +1707,9 @@ function createApiClient({
     await httpClient.delete(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       })
     );
   }
@@ -1713,8 +1717,9 @@ function createApiClient({
     const response = await httpClient.rawGet(
       url`/v2/c/rooms/${options.roomId}/thread-with-notification/${options.threadId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       })
     );
     if (response.ok) {
@@ -1740,8 +1745,9 @@ function createApiClient({
     return await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/metadata`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       options.metadata
     );
@@ -1750,8 +1756,9 @@ function createApiClient({
     return await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments/${options.commentId}/metadata`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       options.metadata
     );
@@ -1761,8 +1768,9 @@ function createApiClient({
     const comment = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       {
         id: commentId,
@@ -1777,8 +1785,9 @@ function createApiClient({
     const comment = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments/${options.commentId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       {
         body: options.body,
@@ -1792,8 +1801,9 @@ function createApiClient({
     await httpClient.delete(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments/${options.commentId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       })
     );
   }
@@ -1801,8 +1811,9 @@ function createApiClient({
     const reaction = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments/${options.commentId}/reactions`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       }),
       { emoji: options.emoji }
     );
@@ -1812,8 +1823,9 @@ function createApiClient({
     await httpClient.delete(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/comments/${options.commentId}/reactions/${options.emoji}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       })
     );
   }
@@ -1821,8 +1833,9 @@ function createApiClient({
     await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/mark-as-resolved`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       })
     );
   }
@@ -1830,8 +1843,9 @@ function createApiClient({
     await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/mark-as-unresolved`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "write"
       })
     );
   }
@@ -1839,8 +1853,9 @@ function createApiClient({
     const subscription = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/subscribe`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       })
     );
     return convertToSubscriptionData(subscription);
@@ -1849,8 +1864,9 @@ function createApiClient({
     await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/threads/${options.threadId}/unsubscribe`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       })
     );
   }
@@ -1906,8 +1922,9 @@ function createApiClient({
         async () => httpClient.putBlob(
           url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/upload/${encodeURIComponent(attachment.name)}`,
           await authManager.getAuthValue({
-            requestedScope: "comments:read",
-            roomId
+            roomId,
+            resource: "comments",
+            access: "write"
           }),
           attachment.file,
           { fileSize: attachment.size },
@@ -1924,8 +1941,9 @@ function createApiClient({
         async () => httpClient.post(
           url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${encodeURIComponent(attachment.name)}`,
           await authManager.getAuthValue({
-            requestedScope: "comments:read",
-            roomId
+            roomId,
+            resource: "comments",
+            access: "write"
           }),
           void 0,
           { signal: abortSignal },
@@ -1950,8 +1968,9 @@ function createApiClient({
                 async () => httpClient.putBlob(
                   url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${createMultiPartUpload.uploadId}/${String(partNumber)}`,
                   await authManager.getAuthValue({
-                    requestedScope: "comments:read",
-                    roomId
+                    roomId,
+                    resource: "comments",
+                    access: "write"
                   }),
                   part,
                   void 0,
@@ -1974,8 +1993,9 @@ function createApiClient({
         return httpClient.post(
           url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}/complete`,
           await authManager.getAuthValue({
-            requestedScope: "comments:read",
-            roomId
+            roomId,
+            resource: "comments",
+            access: "write"
           }),
           { parts: sortedUploadedParts },
           { signal: abortSignal }
@@ -1986,8 +2006,9 @@ function createApiClient({
             await httpClient.rawDelete(
               url`/v2/c/rooms/${roomId}/attachments/${attachment.id}/multipart/${uploadId}`,
               await authManager.getAuthValue({
-                requestedScope: "comments:read",
-                roomId
+                roomId,
+                resource: "comments",
+                access: "write"
               })
             );
           } catch {
@@ -2004,8 +2025,9 @@ function createApiClient({
         const { urls } = await httpClient.post(
           url`/v2/c/rooms/${roomId}/attachments/presigned-urls`,
           await authManager.getAuthValue({
-            requestedScope: "comments:read",
-            roomId
+            roomId,
+            resource: "comments",
+            access: "read"
           }),
           { attachmentIds }
         );
@@ -2024,109 +2046,13 @@ function createApiClient({
     const batch2 = getOrCreateAttachmentUrlsStore(options.roomId).batch;
     return batch2.get(options.attachmentId);
   }
-  async function uploadChatAttachment(options) {
-    const { chatId, attachment, signal } = options;
-    const userId = currentUserId.get();
-    if (userId === void 0) {
-      throw new Error("Attachment upload requires an authenticated user.");
-    }
-    const ATTACHMENT_PART_SIZE = 5 * 1024 * 1024;
-    if (options.attachment.file.size <= ATTACHMENT_PART_SIZE) {
-      await httpClient.putBlob(
-        url`/v2/c/chats/${chatId}/attachments/${attachment.id}/upload/${encodeURIComponent(attachment.file.name)}`,
-        await authManager.getAuthValue({ requestedScope: "comments:read" }),
-        attachment.file,
-        { fileSize: attachment.file.size },
-        { signal }
-      );
-    } else {
-      const multipartUpload = await httpClient.post(
-        url`/v2/c/chats/${chatId}/attachments/${attachment.id}/multipart/${encodeURIComponent(attachment.file.name)}`,
-        await authManager.getAuthValue({ requestedScope: "comments:read" }),
-        void 0,
-        { signal },
-        { fileSize: attachment.file.size }
-      );
-      try {
-        const uploadedParts = [];
-        const parts = [];
-        let start = 0;
-        while (start < attachment.file.size) {
-          const end = Math.min(
-            start + ATTACHMENT_PART_SIZE,
-            attachment.file.size
-          );
-          parts.push({
-            number: parts.length + 1,
-            part: attachment.file.slice(start, end)
-          });
-          start = end;
-        }
-        uploadedParts.push(
-          ...await Promise.all(
-            parts.map(async ({ number, part }) => {
-              return await httpClient.putBlob(
-                url`/v2/c/chats/${chatId}/attachments/${attachment.id}/multipart/${multipartUpload.uploadId}/${String(number)}`,
-                await authManager.getAuthValue({
-                  requestedScope: "comments:read"
-                }),
-                part,
-                void 0,
-                { signal }
-              );
-            })
-          )
-        );
-        await httpClient.post(
-          url`/v2/c/chats/${chatId}/attachments/${attachment.id}/multipart/${multipartUpload.uploadId}/complete`,
-          await authManager.getAuthValue({ requestedScope: "comments:read" }),
-          { parts: uploadedParts.sort((a, b) => a.number - b.number) },
-          { signal }
-        );
-      } catch (err) {
-        try {
-          await httpClient.delete(
-            url`/v2/c/chats/${chatId}/attachments/${attachment.id}/multipart/${multipartUpload.uploadId}`,
-            await authManager.getAuthValue({ requestedScope: "comments:read" })
-          );
-        } catch {
-        }
-        throw err;
-      }
-    }
-  }
-  const attachmentUrlsBatchStoresByChat = new DefaultMap((chatId) => {
-    const batch2 = new Batch(
-      async (batchedAttachmentIds) => {
-        const attachmentIds = batchedAttachmentIds.flat();
-        const { urls } = await httpClient.post(
-          url`/v2/c/chats/${chatId}/attachments/presigned-urls`,
-          await authManager.getAuthValue({
-            requestedScope: "comments:read"
-          }),
-          { attachmentIds }
-        );
-        return urls.map(
-          (url2) => url2 ?? new Error("There was an error while getting this attachment's URL")
-        );
-      },
-      { delay: 50 }
-    );
-    return createBatchStore(batch2);
-  });
-  function getOrCreateChatAttachmentUrlsStore(chatId) {
-    return attachmentUrlsBatchStoresByChat.getOrCreate(chatId);
-  }
-  function getChatAttachmentUrl(options) {
-    const batch2 = getOrCreateChatAttachmentUrlsStore(options.chatId).batch;
-    return batch2.get(options.attachmentId);
-  }
   async function getSubscriptionSettings(options) {
     return httpClient.get(
       url`/v2/c/rooms/${options.roomId}/subscription-settings`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       }),
       void 0,
       {
@@ -2138,8 +2064,9 @@ function createApiClient({
     return httpClient.post(
       url`/v2/c/rooms/${options.roomId}/subscription-settings`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "comments",
+        access: "read"
       }),
       options.settings
     );
@@ -2151,8 +2078,9 @@ function createApiClient({
         await httpClient.post(
           url`/v2/c/rooms/${roomId}/inbox-notifications/read`,
           await authManager.getAuthValue({
-            requestedScope: "comments:read",
-            roomId
+            roomId,
+            resource: "comments",
+            access: "read"
           }),
           { inboxNotificationIds }
         );
@@ -2172,8 +2100,9 @@ function createApiClient({
     await httpClient.rawPost(
       url`/v2/c/rooms/${options.roomId}/text-mentions`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "write"
       }),
       {
         userId: options.mention.kind === "user" ? options.mention.id : void 0,
@@ -2187,8 +2116,9 @@ function createApiClient({
     await httpClient.rawDelete(
       url`/v2/c/rooms/${options.roomId}/text-mentions/${options.mentionId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "write"
       })
     );
   }
@@ -2196,8 +2126,9 @@ function createApiClient({
     return httpClient.rawGet(
       url`/v2/c/rooms/${options.roomId}/y-version/${options.versionId}`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       })
     );
   }
@@ -2205,8 +2136,9 @@ function createApiClient({
     await httpClient.rawPost(
       url`/v2/c/rooms/${options.roomId}/version`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "write"
       })
     );
   }
@@ -2214,8 +2146,9 @@ function createApiClient({
     await httpClient.rawPost(
       url`/v2/c/rooms/${options.roomId}/text-metadata`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       }),
       {
         type: options.type,
@@ -2227,8 +2160,9 @@ function createApiClient({
     const result = await httpClient.post(
       url`/v2/c/rooms/${options.roomId}/ai/contextual-prompt`,
       await authManager.getAuthValue({
-        requestedScope: "room:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       }),
       {
         prompt: options.prompt,
@@ -2250,8 +2184,9 @@ function createApiClient({
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/versions`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       })
     );
     return {
@@ -2268,8 +2203,9 @@ function createApiClient({
     const result = await httpClient.get(
       url`/v2/c/rooms/${options.roomId}/versions/delta`,
       await authManager.getAuthValue({
-        requestedScope: "comments:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       }),
       { since: options.since.toISOString() },
       { signal: options.signal }
@@ -2288,8 +2224,9 @@ function createApiClient({
     const result = await httpClient.rawGet(
       url`/v2/c/rooms/${options.roomId}/storage`,
       await authManager.getAuthValue({
-        requestedScope: "room:read",
-        roomId: options.roomId
+        roomId: options.roomId,
+        resource: "storage",
+        access: "read"
       })
     );
     return await result.json();
@@ -2302,7 +2239,7 @@ function createApiClient({
     }
     const json = await httpClient.get(
       url`/v2/c/inbox-notifications`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
         cursor: options?.cursor,
         limit: PAGE_SIZE,
@@ -2328,7 +2265,7 @@ function createApiClient({
     }
     const json = await httpClient.get(
       url`/v2/c/inbox-notifications/delta`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       { since: options.since.toISOString(), query },
       { signal: options.signal }
     );
@@ -2357,7 +2294,7 @@ function createApiClient({
     }
     const { count } = await httpClient.get(
       url`/v2/c/inbox-notifications/count`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       { query },
       { signal: options?.signal }
     );
@@ -2366,7 +2303,7 @@ function createApiClient({
   async function markAllInboxNotificationsAsRead() {
     await httpClient.post(
       url`/v2/c/inbox-notifications/read`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
         inboxNotificationIds: "all"
       }
@@ -2375,7 +2312,7 @@ function createApiClient({
   async function markInboxNotificationsAsRead(inboxNotificationIds) {
     await httpClient.post(
       url`/v2/c/inbox-notifications/read`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
         inboxNotificationIds
       }
@@ -2395,19 +2332,19 @@ function createApiClient({
   async function deleteAllInboxNotifications() {
     await httpClient.delete(
       url`/v2/c/inbox-notifications`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" })
+      await authManager.getAuthValue({ resource: "personal", access: "write" })
     );
   }
   async function deleteInboxNotification(inboxNotificationId) {
     await httpClient.delete(
       url`/v2/c/inbox-notifications/${inboxNotificationId}`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" })
+      await authManager.getAuthValue({ resource: "personal", access: "write" })
     );
   }
   async function getNotificationSettings(options) {
     return httpClient.get(
       url`/v2/c/notification-settings`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       void 0,
       { signal: options?.signal }
     );
@@ -2415,7 +2352,7 @@ function createApiClient({
   async function updateNotificationSettings(settings) {
     return httpClient.post(
       url`/v2/c/notification-settings`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       settings
     );
   }
@@ -2427,7 +2364,7 @@ function createApiClient({
     const PAGE_SIZE = 50;
     const json = await httpClient.get(
       url`/v2/c/threads`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       {
         cursor: options?.cursor,
         query,
@@ -2448,7 +2385,7 @@ function createApiClient({
   async function getUserThreadsSince_experimental(options) {
     const json = await httpClient.get(
       url`/v2/c/threads/delta`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       { since: options.since.toISOString() },
       { signal: options.signal }
     );
@@ -2477,7 +2414,8 @@ function createApiClient({
       const { groups: plainGroups } = await httpClient.post(
         url`/v2/c/groups/find`,
         await authManager.getAuthValue({
-          requestedScope: "comments:read"
+          resource: "personal",
+          access: "write"
         }),
         { groupIds }
       );
@@ -2496,7 +2434,7 @@ function createApiClient({
   async function getUrlMetadata(_url) {
     const { metadata } = await httpClient.get(
       url`/v2/c/urls/metadata`,
-      await authManager.getAuthValue({ requestedScope: "comments:read" }),
+      await authManager.getAuthValue({ resource: "personal", access: "write" }),
       { url: _url }
     );
     return metadata;
@@ -2536,10 +2474,6 @@ function createApiClient({
     getAttachmentUrl,
     uploadAttachment,
     getOrCreateAttachmentUrlsStore,
-    // User attachments
-    uploadChatAttachment,
-    getOrCreateChatAttachmentUrlsStore,
-    getChatAttachmentUrl,
     // Room storage
     streamStorage,
     // Notifications
@@ -3913,6 +3847,7 @@ var ManagedSocket = class {
 
 // src/internal.ts
 var kInternal = /* @__PURE__ */ Symbol();
+var kStorageUpdateSource = /* @__PURE__ */ Symbol();
 
 // src/lib/IncrementalJsonParser.ts
 var EMPTY_OBJECT = Object.freeze({});
@@ -5233,22 +5168,327 @@ function createReceivingToolInvocation(invocationId, name, partialArgsText = "")
   };
 }
 
-// src/protocol/AuthToken.ts
-var Permission = /* @__PURE__ */ ((Permission2) => {
-  Permission2["Read"] = "room:read";
-  Permission2["Write"] = "room:write";
-  Permission2["PresenceWrite"] = "room:presence:write";
-  Permission2["CommentsWrite"] = "comments:write";
-  Permission2["CommentsRead"] = "comments:read";
-  Permission2["FeedsWrite"] = "feeds:write";
-  return Permission2;
-})(Permission || {});
-function canWriteStorage(scopes) {
-  return scopes.includes("room:write" /* Write */);
-}
-function canComment(scopes) {
-  return scopes.includes("comments:write" /* CommentsWrite */) || scopes.includes("room:write" /* Write */);
+// src/permissions.ts
+var Permission = {
+  /**
+   * Default permission for a room.
+   */
+  Read: "*:read",
+  Write: "*:write",
+  /**
+   * Legacy aliases for default room permissions.
+   */
+  RoomWrite: "room:write",
+  RoomRead: "room:read",
+  /**
+   * Storage
+   */
+  StorageRead: "storage:read",
+  StorageWrite: "storage:write",
+  StorageNone: "storage:none",
+  /**
+   * Comments
+   */
+  CommentsWrite: "comments:write",
+  CommentsRead: "comments:read",
+  CommentsNone: "comments:none",
+  /**
+   * Feeds
+   */
+  FeedsRead: "feeds:read",
+  FeedsWrite: "feeds:write",
+  FeedsNone: "feeds:none",
+  /**
+   * Legacy
+   */
+  LegacyRoomPresenceWrite: "room:presence:write"
+};
+var ACCESS_LEVELS = ["none", "read", "write"];
+var basePermissionScopes = /* @__PURE__ */ new Set([
+  Permission.Read,
+  Permission.Write,
+  Permission.RoomRead,
+  Permission.RoomWrite
+]);
+var ACCESS_LEVEL_RANKS = {
+  none: 0,
+  read: 1,
+  write: 2
+};
+var PERMISSIONS_BY_RESOURCE = {
+  room: {
+    read: [Permission.Read, Permission.RoomRead],
+    write: [Permission.Write, Permission.RoomWrite]
+  },
+  personal: {
+    write: []
+  },
+  storage: {
+    write: [Permission.StorageWrite],
+    read: [Permission.StorageRead],
+    none: [Permission.StorageNone]
+  },
+  comments: {
+    write: [Permission.CommentsWrite],
+    read: [Permission.CommentsRead],
+    none: [Permission.CommentsNone]
+  },
+  feeds: {
+    write: [Permission.FeedsWrite],
+    read: [Permission.FeedsRead],
+    none: [Permission.FeedsNone]
+  }
+};
+var NO_PERMISSION_MATRIX = {
+  room: "none",
+  storage: "none",
+  comments: "none",
+  feeds: "none",
+  personal: "none"
+};
+var BASE_PERMISSION_RESOURCE = "room";
+var ROOM_PERMISSION_RESOURCES = [
+  "storage",
+  "comments",
+  "feeds"
+];
+var VALID_PERMISSIONS = new Set(Object.values(Permission));
+function isPermission(permission) {
+  return VALID_PERMISSIONS.has(permission);
+}
+function resolveResourceAccess(scopes, resource) {
+  const permissions = PERMISSIONS_BY_RESOURCE[resource];
+  let resourceAccess;
+  for (const access of ACCESS_LEVELS) {
+    const scopedPermissions = permissions[access];
+    if (scopedPermissions !== void 0 && scopedPermissions.some((permission) => scopes.includes(permission))) {
+      resourceAccess = access;
+    }
+  }
+  return resourceAccess;
+}
+function permissionMatrixFromResolvedScopes(resolved) {
+  if (!resolved.hasDefaultPermission) {
+    return { ...NO_PERMISSION_MATRIX };
+  }
+  const matrix = {
+    ...NO_PERMISSION_MATRIX,
+    [BASE_PERMISSION_RESOURCE]: resolved.baseAccess,
+    personal: "write"
+  };
+  for (const resource of ROOM_PERMISSION_RESOURCES) {
+    matrix[resource] = resolved.matrix[resource] ?? resolved.baseAccess;
+  }
+  return matrix;
+}
+function permissionMatrixFromScopes(scopes) {
+  return permissionMatrixFromResolvedScopes(resolvePermissionScopes(scopes));
+}
+function resolvePermissionScopes(scopes) {
+  const hasDefaultPermission = scopes.includes(Permission.Write) || scopes.includes(Permission.Read) || scopes.includes(Permission.RoomWrite) || scopes.includes(Permission.RoomRead);
+  const baseAccess = scopes.includes(Permission.Write) || scopes.includes(Permission.RoomWrite) ? "write" : scopes.includes(Permission.Read) || scopes.includes(Permission.RoomRead) ? "read" : "none";
+  const matrix = {};
+  for (const resource of ROOM_PERMISSION_RESOURCES) {
+    const access = resolveResourceAccess(scopes, resource);
+    if (access !== void 0) {
+      matrix[resource] = access;
+    }
+  }
+  return { hasDefaultPermission, baseAccess, matrix };
+}
+function hasPermissionAccess(matrix, resource, requiredAccess) {
+  const access = matrix[resource] ?? "none";
+  return ACCESS_LEVEL_RANKS[access] >= ACCESS_LEVEL_RANKS[requiredAccess];
+}
+function resolveRoomPermissionMatrix(permissions, roomId) {
+  const matchedPermissions = permissions.filter(
+    (entry) => roomPatternMatches(entry.pattern, roomId)
+  );
+  if (matchedPermissions.length === 0) {
+    return void 0;
+  }
+  let hasDefaultPermission = false;
+  let baseAccess = "none";
+  const explicitMatrix = {};
+  const explicitSpecificity = {};
+  for (const entry of matchedPermissions) {
+    const resolved = resolvePermissionScopes(entry.scopes);
+    const specificity = roomPatternSpecificity(entry.pattern);
+    if (resolved.hasDefaultPermission) {
+      hasDefaultPermission = true;
+      baseAccess = strongestAccess(baseAccess, resolved.baseAccess);
+    }
+    for (const resource of ROOM_PERMISSION_RESOURCES) {
+      const access = resolved.matrix[resource];
+      if (access !== void 0) {
+        const currentSpecificity = explicitSpecificity[resource] ?? -1;
+        if (specificity > currentSpecificity) {
+          explicitMatrix[resource] = access;
+          explicitSpecificity[resource] = specificity;
+        } else if (specificity === currentSpecificity) {
+          explicitMatrix[resource] = strongestAccess(
+            explicitMatrix[resource] ?? "none",
+            access
+          );
+        }
+      }
+    }
+  }
+  return permissionMatrixFromResolvedScopes({
+    hasDefaultPermission,
+    baseAccess,
+    matrix: explicitMatrix
+  });
+}
+function normalizeRoomPermissions(permissions) {
+  if (!Array.isArray(permissions)) {
+    throw new Error("Permission list must be an array");
+  }
+  const result = [];
+  for (const permission of permissions) {
+    if (!isPermission(permission)) {
+      throw new Error(`Not a valid permission: ${permission}`);
+    }
+    result.push(permission);
+  }
+  return result;
+}
+function normalizeRoomAccesses(accesses) {
+  if (accesses === void 0) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(accesses).map(([id, permissions]) => [
+      id,
+      normalizeRoomPermissions(permissions)
+    ])
+  );
+}
+function normalizeUpdateRoomAccesses(accesses) {
+  if (accesses === void 0) {
+    return void 0;
+  }
+  return Object.fromEntries(
+    Object.entries(accesses).map(([id, permissions]) => [
+      id,
+      permissions === null ? null : normalizeRoomPermissions(permissions)
+    ])
+  );
+}
+function permissionMatrixToScopes(matrix) {
+  const scopes = [];
+  const baseAccess = matrix.room;
+  if (baseAccess !== "none") {
+    scopes.push(permissionForAccessLevel(BASE_PERMISSION_RESOURCE, baseAccess));
+  }
+  for (const resource of ROOM_PERMISSION_RESOURCES) {
+    const access = matrix[resource];
+    if (access !== baseAccess) {
+      scopes.push(permissionForAccessLevel(resource, access));
+    }
+  }
+  return scopes;
+}
+function mergeRoomPermissionScopes({
+  defaultAccesses,
+  groupsAccesses,
+  userAccesses
+}) {
+  const sources = [
+    resolvePermissionScopes(defaultAccesses),
+    mergeResolvedScopesByHighestAccess(
+      groupsAccesses.map(resolvePermissionScopes)
+    ),
+    resolvePermissionScopes(userAccesses)
+  ];
+  const merged = {
+    hasDefaultPermission: false,
+    baseAccess: "none",
+    matrix: {}
+  };
+  for (const source of sources) {
+    if (source.hasDefaultPermission) {
+      merged.hasDefaultPermission = true;
+      merged.baseAccess = source.baseAccess;
+    }
+    for (const resource of ROOM_PERMISSION_RESOURCES) {
+      const access = source.matrix[resource];
+      if (access !== void 0) {
+        merged.matrix[resource] = access;
+      }
+    }
+  }
+  return permissionMatrixToScopes(permissionMatrixFromResolvedScopes(merged));
+}
+function mergeResolvedScopesByHighestAccess(sources) {
+  const merged = {
+    hasDefaultPermission: false,
+    baseAccess: "none",
+    matrix: {}
+  };
+  for (const source of sources) {
+    if (source.hasDefaultPermission) {
+      merged.hasDefaultPermission = true;
+      merged.baseAccess = strongestAccess(merged.baseAccess, source.baseAccess);
+    }
+    for (const resource of ROOM_PERMISSION_RESOURCES) {
+      const access = source.matrix[resource];
+      if (access !== void 0) {
+        merged.matrix[resource] = strongestAccess(
+          merged.matrix[resource] ?? "none",
+          access
+        );
+      }
+    }
+  }
+  return merged;
+}
+function permissionForAccessLevel(resource, access, field = resource) {
+  const levels = PERMISSIONS_BY_RESOURCE[resource];
+  const permissions = levels[access];
+  if (permissions === void 0 || permissions.length === 0) {
+    throw new Error(
+      `Invalid permission level for ${field}: ${JSON.stringify(access) ?? String(access)}`
+    );
+  }
+  return permissions[0];
+}
+function strongestAccess(left, right) {
+  return ACCESS_LEVEL_RANKS[right] > ACCESS_LEVEL_RANKS[left] ? right : left;
 }
+function roomPatternMatches(pattern, roomId) {
+  if (pattern.includes("*")) {
+    return roomId.startsWith(pattern.replace("*", ""));
+  }
+  return pattern === roomId;
+}
+function roomPatternSpecificity(pattern) {
+  return pattern.replace("*", "").length;
+}
+function validatePermissionsSet(scopes) {
+  const unknownScopes = scopes.filter((scope) => !VALID_PERMISSIONS.has(scope));
+  if (unknownScopes.length > 0) {
+    return `Unknown permission scope(s): ${unknownScopes.join(", ")}`;
+  }
+  const baseScopes = scopes.filter((scope) => basePermissionScopes.has(scope));
+  if (baseScopes.length !== 1) {
+    return `Permissions must include exactly one of ${Permission.Read}, ${Permission.Write} (or the legacy aliases ${Permission.RoomRead}, ${Permission.RoomWrite}), got ${baseScopes.length === 0 ? "none" : baseScopes.join(", ")}`;
+  }
+  const seenFeatures = /* @__PURE__ */ new Set();
+  for (const scope of scopes) {
+    if (basePermissionScopes.has(scope) || scope === Permission.LegacyRoomPresenceWrite) {
+      continue;
+    }
+    const feature = scope.slice(0, scope.indexOf(":"));
+    if (seenFeatures.has(feature)) {
+      return `Permissions can include at most one scope per feature, got multiple "${feature}" scopes`;
+    }
+    seenFeatures.add(feature);
+  }
+  return true;
+}
+
+// src/protocol/AuthToken.ts
 function isValidAuthTokenPayload(data) {
   return isPlainObject(data) && (data.k === "acc" /* ACCESS_TOKEN */ || data.k === "id" /* ID_TOKEN */);
 }
@@ -5287,47 +5527,22 @@ function createAuthManager(authOptions, onAuthenticate) {
   const authentication = prepareAuthentication(authOptions);
   const seenTokens = /* @__PURE__ */ new Set();
   const tokens = [];
-  const expiryTimes = [];
   const requestPromises = /* @__PURE__ */ new Map();
   function reset() {
     seenTokens.clear();
     tokens.length = 0;
-    expiryTimes.length = 0;
     requestPromises.clear();
   }
-  function hasCorrespondingScopes(requestedScope, scopes) {
-    if (requestedScope === "comments:read") {
-      return scopes.includes("comments:read" /* CommentsRead */) || scopes.includes("comments:write" /* CommentsWrite */) || scopes.includes("room:read" /* Read */) || scopes.includes("room:write" /* Write */);
-    } else if (requestedScope === "room:read") {
-      return scopes.includes("room:read" /* Read */) || scopes.includes("room:write" /* Write */);
-    }
-    return false;
-  }
   function getCachedToken(requestOptions) {
     const now2 = Math.ceil(Date.now() / 1e3);
     for (let i = tokens.length - 1; i >= 0; i--) {
-      const token = tokens[i];
-      const expiresAt = expiryTimes[i];
-      if (expiresAt <= now2) {
+      const cachedToken = tokens[i];
+      if (cachedToken.expiresAt <= now2) {
         tokens.splice(i, 1);
-        expiryTimes.splice(i, 1);
         continue;
       }
-      if (token.parsed.k === "id" /* ID_TOKEN */) {
-        return token;
-      } else if (token.parsed.k === "acc" /* ACCESS_TOKEN */) {
-        if (!requestOptions.roomId && Object.entries(token.parsed.perms).length === 0) {
-          return token;
-        }
-        for (const [resource, scopes] of Object.entries(token.parsed.perms)) {
-          if (!requestOptions.roomId) {
-            if (resource.includes("*") && hasCorrespondingScopes(requestOptions.requestedScope, scopes)) {
-              return token;
-            }
-          } else if (resource.includes("*") && requestOptions.roomId.startsWith(resource.replace("*", "")) || requestOptions.roomId === resource && hasCorrespondingScopes(requestOptions.requestedScope, scopes)) {
-            return token;
-          }
-        }
+      if (cachedTokenSatisfiesRequest(cachedToken, requestOptions)) {
+        return cachedToken.token;
       }
     }
     return void 0;
@@ -5345,6 +5560,10 @@ function createAuthManager(authOptions, onAuthenticate) {
       });
       const parsed = parseAuthToken(response.token);
       if (seenTokens.has(parsed.raw)) {
+        const cachedToken = getCachedToken(options);
+        if (cachedToken?.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."
         );
@@ -5385,11 +5604,12 @@ function createAuthManager(authOptions, onAuthenticate) {
       return { type: "secret", token: cachedToken };
     }
     let currentPromise;
-    if (requestOptions.roomId) {
-      currentPromise = requestPromises.get(requestOptions.roomId);
+    const requestKey = getAuthRequestKey(requestOptions);
+    if (requestKey !== void 0) {
+      currentPromise = requestPromises.get(requestKey);
       if (currentPromise === void 0) {
         currentPromise = makeAuthRequest(requestOptions);
-        requestPromises.set(requestOptions.roomId, currentPromise);
+        requestPromises.set(requestKey, currentPromise);
       }
     } else {
       currentPromise = requestPromises.get("liveblocks-user-token");
@@ -5403,12 +5623,12 @@ function createAuthManager(authOptions, onAuthenticate) {
       const BUFFER = 30;
       const expiresAt = Math.floor(Date.now() / 1e3) + (token.parsed.exp - token.parsed.iat) - BUFFER;
       seenTokens.add(token.raw);
-      tokens.push(token);
-      expiryTimes.push(expiresAt);
+      const cachedToken2 = makeCachedToken(token, expiresAt);
+      tokens.push(cachedToken2);
       return { type: "secret", token };
     } finally {
-      if (requestOptions.roomId) {
-        requestPromises.delete(requestOptions.roomId);
+      if (requestKey !== void 0) {
+        requestPromises.delete(requestKey);
       } else {
         requestPromises.delete("liveblocks-user-token");
       }
@@ -5419,6 +5639,43 @@ function createAuthManager(authOptions, onAuthenticate) {
     getAuthValue
   };
 }
+function getAuthRequestKey(request) {
+  if (request.roomId === void 0) {
+    return void 0;
+  }
+  return `${request.roomId}:${request.resource}:${request.access}`;
+}
+function makeCachedToken(token, expiresAt) {
+  if (token.parsed.k === "acc" /* ACCESS_TOKEN */) {
+    return {
+      token,
+      expiresAt,
+      permissions: Object.entries(token.parsed.perms).map(
+        ([pattern, scopes]) => ({
+          pattern,
+          scopes: normalizeRoomPermissions(scopes)
+        })
+      )
+    };
+  }
+  return { token, expiresAt };
+}
+function cachedTokenSatisfiesRequest(cachedToken, request) {
+  if (cachedToken.token.parsed.k === "id" /* ID_TOKEN */) {
+    return true;
+  }
+  if (request.resource === "personal") {
+    return true;
+  }
+  if (request.roomId === void 0) {
+    return false;
+  }
+  const matrix = resolveRoomPermissionMatrix(
+    cachedToken.permissions ?? [],
+    request.roomId
+  );
+  return matrix !== void 0 && hasPermissionAccess(matrix, request.resource, request.access);
+}
 function prepareAuthentication(authOptions) {
   const { publicApiKey, authEndpoint } = authOptions;
   if (authEndpoint !== void 0 && publicApiKey !== void 0) {
@@ -5511,13 +5768,15 @@ var OpCode = Object.freeze({
   DELETE_CRDT: 5,
   DELETE_OBJECT_KEY: 6,
   CREATE_MAP: 7,
-  CREATE_REGISTER: 8
+  CREATE_REGISTER: 8,
+  CREATE_TEXT: 9,
+  UPDATE_TEXT: 10
 });
 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_MAP || op.type === OpCode.CREATE_LIST || op.type === OpCode.CREATE_TEXT;
 }
 
 // src/protocol/StorageNode.ts
@@ -5525,7 +5784,8 @@ var CrdtType = Object.freeze({
   OBJECT: 0,
   LIST: 1,
   MAP: 2,
-  REGISTER: 3
+  REGISTER: 3,
+  TEXT: 4
 });
 function isRootStorageNode(node) {
   return node[0] === "root";
@@ -5542,6 +5802,9 @@ function isMapStorageNode(node) {
 function isRegisterStorageNode(node) {
   return node[1].type === CrdtType.REGISTER;
 }
+function isTextStorageNode(node) {
+  return node[1].type === CrdtType.TEXT;
+}
 function isCompactRootNode(node) {
   return node[0] === "root";
 }
@@ -5564,6 +5827,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.TEXT:
+        yield [cnode[0], { type: CrdtType.TEXT, parentId: cnode[2], parentKey: cnode[3], data: cnode[4], version: cnode[5] }];
+        break;
       default:
     }
   }
@@ -5592,6 +5858,17 @@ function* nodeStreamToCompactNodes(nodes) {
       const id = node[0];
       const crdt = node[1];
       yield [id, CrdtType.REGISTER, crdt.parentId, crdt.parentKey, crdt.data];
+    } else if (isTextStorageNode(node)) {
+      const id = node[0];
+      const crdt = node[1];
+      yield [
+        id,
+        CrdtType.TEXT,
+        crdt.parentId,
+        crdt.parentKey,
+        crdt.data,
+        crdt.version
+      ];
     } else {
     }
   }
@@ -5784,6 +6061,9 @@ var UnacknowledgedOps = class {
   #createOpsByPosition = /* @__PURE__ */ new Map();
   // parentId -> (opId -> Create op)
   #createOpsByParent = /* @__PURE__ */ new Map();
+  // opIds of pending ops that were in flight when a connection died, so the
+  // server may already have processed them. See isPossiblyStored().
+  #possiblyStoredOpIds = /* @__PURE__ */ new Set();
   #posKey(parentId, parentKey) {
     return `${parentId}
 ${parentKey}`;
@@ -5791,6 +6071,10 @@ ${parentKey}`;
   get size() {
     return this.#byOpId.size;
   }
+  /** The still-unacknowledged op with the given opId, if any. */
+  get(opId) {
+    return this.#byOpId.get(opId);
+  }
   /**
    * Mark the given Op as still unacknowledged.
    */
@@ -5823,6 +6107,7 @@ ${parentKey}`;
       return;
     }
     this.#byOpId.delete(opId);
+    this.#possiblyStoredOpIds.delete(opId);
     if (isCreateOp(op)) {
       const posKey = this.#posKey(op.parentId, op.parentKey);
       const atPosition = this.#createOpsByPosition.get(posKey);
@@ -5856,6 +6141,19 @@ ${parentKey}`;
   values() {
     return this.#byOpId.values();
   }
+  isPossiblyStored(opId) {
+    return this.#possiblyStoredOpIds.has(opId);
+  }
+  /**
+   * Mark every currently pending op as possibly stored on the server. Called
+   * when the connection dies: all of these ops were in flight, and their
+   * (possibly lost) acks would have been the only way to know their fate.
+   */
+  markAllAsPossiblyStored() {
+    for (const opId of this.#byOpId.keys()) {
+      this.#possiblyStoredOpIds.add(opId);
+    }
+  }
 };
 
 // src/crdts/AbstractCrdt.ts
@@ -5877,8 +6175,8 @@ function createManagedPool(roomId, options) {
     deleteNode: (id) => void nodes.delete(id),
     generateId: () => `${getCurrentConnectionId()}:${clock++}`,
     generateOpId: () => `${getCurrentConnectionId()}:${opClock++}`,
-    dispatch(ops, reverse, storageUpdates) {
-      onDispatch?.(ops, reverse, storageUpdates);
+    dispatch(ops, reverse, storageUpdates, options2) {
+      onDispatch?.(ops, reverse, storageUpdates, options2);
     },
     assertStorageIsWritable: () => {
       if (!isStorageWritable()) {
@@ -6452,7 +6750,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
     return result.modified.updates[0];
   }
-  #applyRemoteInsert(op, fromSnapshot) {
+  #applyRemoteInsert(op) {
     if (this._pool === void 0) {
       throw new Error("Can't attach child if managed pool is not present");
     }
@@ -6462,7 +6760,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       this.#shiftItemPosition(existingItemIndex, key);
     }
     const { newItem, newIndex } = this.#createAttachItemAndSort(op, key);
-    const bumpDeltas = fromSnapshot ? [] : this.#bumpUnackedPushesAbove(key);
+    const bumpDeltas = this.#bumpUnackedPushesAbove(key);
     return {
       modified: makeUpdate(this, [
         insertDelta(newIndex, newItem),
@@ -6477,6 +6775,13 @@ var LiveList = class _LiveList extends AbstractCrdt {
    * the single source of truth, so an item drops out the instant its op is
    * acked, with no per-instance membership to leak. Yielded in push order.
    *
+   * Excludes ops that may already be stored on the server (they were in
+   * flight when a connection died, so their fate is unknown): the bump
+   * prediction assumes the server has not processed the op yet, which is only
+   * guaranteed for ops sent on the current connection. For these excluded
+   * ops, the server's (re-)ack states the authoritative position; predicting
+   * locally could produce a wrong position that no ack would correct.
+   *
    * Restricted to items currently in `#items`: a pushed node whose op is still
    * pending may have been pulled out of the list (e.g. implicitly deleted by a
    * remote set, or removed by an undo) while still living in the pool, and such
@@ -6490,6 +6795,9 @@ var LiveList = class _LiveList extends AbstractCrdt {
       if (op.intent !== "push") {
         continue;
       }
+      if (this._pool.unacknowledgedOps.isPossiblyStored(op.opId)) {
+        continue;
+      }
       const node = this._pool.getNode(op.id);
       if (node !== void 0 && this.#items.includes(node)) {
         yield node;
@@ -6654,7 +6962,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
   }
   /** @internal */
-  _attachChild(op, source, fromSnapshot = false) {
+  _attachChild(op, source) {
     if (this._pool === void 0) {
       throw new Error("Can't attach child if managed pool is not present");
     }
@@ -6669,7 +6977,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
       }
     } else {
       if (source === 1 /* THEIRS */) {
-        result = this.#applyRemoteInsert(op, fromSnapshot);
+        result = this.#applyRemoteInsert(op);
       } else if (source === 2 /* OURS */) {
         result = this.#applyInsertAck(op);
       } else {
@@ -7928,6 +8236,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
       const id = nn(this._id);
       const parentKey = nn(child._parentKey);
       const reverse = child._toOps(id, parentKey);
+      const deletedItem = liveNodeToLson(child);
       for (const [key, value] of this.#synced) {
         if (value === child) {
           this.#synced.delete(key);
@@ -7939,7 +8248,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
         node: this,
         type: "LiveObject",
         updates: {
-          [parentKey]: { type: "delete" }
+          [parentKey]: { type: "delete", deletedItem }
         }
       };
       return { modified: storageUpdate, reverse };
@@ -8426,73 +8735,1181 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
   }
 };
 
-// src/crdts/liveblocks-helpers.ts
-function creationOpToLiveNode(op) {
-  return lsonToLiveNode(creationOpToLson(op));
-}
-function creationOpToLson(op) {
-  switch (op.type) {
-    case OpCode.CREATE_REGISTER:
-      return op.data;
-    case OpCode.CREATE_OBJECT:
-      return new LiveObject(op.data);
-    case OpCode.CREATE_MAP:
-      return new LiveMap();
-    case OpCode.CREATE_LIST:
-      return new LiveList([]);
-    default:
-      return assertNever(op, "Unknown creation Op");
-  }
-}
-function isSameNodeOrChildOf(node, parent) {
-  if (node === parent) {
+// src/crdts/liveTextOps.ts
+function attributesEqual(left, right) {
+  if (left === right) {
     return true;
   }
-  if (node.parent.type === "HasParent") {
-    return isSameNodeOrChildOf(node.parent.node, parent);
+  if (left === void 0 || right === void 0) {
+    return false;
   }
-  return false;
-}
-function deserialize(node, parentToChildren, pool) {
-  if (isObjectStorageNode(node)) {
-    return LiveObject._deserialize(node, parentToChildren, pool);
-  } else if (isListStorageNode(node)) {
-    return LiveList._deserialize(node, parentToChildren, pool);
-  } else if (isMapStorageNode(node)) {
-    return LiveMap._deserialize(node, parentToChildren, pool);
-  } else if (isRegisterStorageNode(node)) {
-    return LiveRegister._deserialize(node, parentToChildren, pool);
-  } else {
-    throw new Error("Unexpected CRDT type");
+  const leftKeys = Object.keys(left);
+  const rightKeys = Object.keys(right);
+  if (leftKeys.length !== rightKeys.length) {
+    return false;
+  }
+  for (const key of leftKeys) {
+    if (left[key] !== right[key]) {
+      return false;
+    }
   }
+  return true;
 }
-function deserializeToLson(node, parentToChildren, pool) {
-  if (isObjectStorageNode(node)) {
-    return LiveObject._deserialize(node, parentToChildren, pool);
-  } else if (isListStorageNode(node)) {
-    return LiveList._deserialize(node, parentToChildren, pool);
-  } else if (isMapStorageNode(node)) {
-    return LiveMap._deserialize(node, parentToChildren, pool);
-  } else if (isRegisterStorageNode(node)) {
-    return node[1].data;
-  } else {
-    throw new Error("Unexpected CRDT type");
+function cloneAttributes(attributes) {
+  return attributes === void 0 ? void 0 : freeze({ ...attributes });
+}
+function normalizeSegments(segments) {
+  const normalized = [];
+  for (const segment of segments) {
+    if (segment.text.length === 0) {
+      continue;
+    }
+    const last = normalized.at(-1);
+    const attributes = cloneAttributes(segment.attributes);
+    if (last !== void 0 && attributesEqual(last.attributes, attributes)) {
+      last.text += segment.text;
+    } else {
+      normalized.push({ text: segment.text, attributes });
+    }
   }
+  return normalized;
 }
-function isLiveStructure(value) {
-  return isLiveList(value) || isLiveMap(value) || isLiveObject(value);
+function dataToSegments(data) {
+  return normalizeSegments(
+    data.map(([text, attributes]) => ({
+      text,
+      attributes
+    }))
+  );
 }
-function isLiveNode(value) {
-  return isLiveStructure(value) || isLiveRegister(value);
+function segmentsToData(segments) {
+  return segments.map(
+    (segment) => segment.attributes === void 0 ? [segment.text] : [segment.text, { ...segment.attributes }]
+  );
 }
-function isLiveList(value) {
-  return value instanceof LiveList;
+function textLength(segments) {
+  return segments.reduce((sum, segment) => sum + segment.text.length, 0);
 }
-function isLiveMap(value) {
-  return value instanceof LiveMap;
+function splitSegmentsAt(segments, index) {
+  const result = [];
+  let offset = 0;
+  for (const segment of segments) {
+    const end = offset + segment.text.length;
+    if (index > offset && index < end) {
+      const before2 = segment.text.slice(0, index - offset);
+      const after2 = segment.text.slice(index - offset);
+      result.push({ text: before2, attributes: segment.attributes });
+      result.push({ text: after2, attributes: segment.attributes });
+    } else {
+      result.push({ text: segment.text, attributes: segment.attributes });
+    }
+    offset = end;
+  }
+  return result;
 }
-function isLiveObject(value) {
-  return value instanceof LiveObject;
+function clipRange(index, length, contentLength) {
+  const clippedIndex = Math.max(0, Math.min(index, contentLength));
+  const clippedEnd = Math.max(
+    clippedIndex,
+    Math.min(index + length, contentLength)
+  );
+  return { index: clippedIndex, length: clippedEnd - clippedIndex };
+}
+function applyInsert(segments, index, text, attributes) {
+  if (text.length === 0) {
+    return normalizeSegments(segments);
+  }
+  const split = splitSegmentsAt(segments, index);
+  const result = [];
+  let offset = 0;
+  let inserted = false;
+  for (const segment of split) {
+    if (!inserted && offset === index) {
+      result.push({ text, attributes });
+      inserted = true;
+    }
+    result.push(segment);
+    offset += segment.text.length;
+  }
+  if (!inserted) {
+    result.push({ text, attributes });
+  }
+  return normalizeSegments(result);
+}
+function extractDeletedSegments(segments, index, length) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const deleted = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      deleted.push({
+        text: segment.text,
+        attributes: segment.attributes
+      });
+    }
+    offset = end;
+  }
+  return normalizeSegments(deleted);
+}
+function applyDelete(segments, index, length) {
+  const deletedSegments = extractDeletedSegments(segments, index, length);
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  let deletedText = "";
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      deletedText += segment.text;
+    } else {
+      result.push(segment);
+    }
+    offset = end;
+  }
+  return {
+    segments: normalizeSegments(result),
+    deletedText,
+    deletedSegments
+  };
+}
+function applyFormat(segments, index, length, attributes) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      const nextAttributes = {
+        ...segment.attributes ?? {}
+      };
+      for (const [key, value] of Object.entries(attributes)) {
+        if (value === null) {
+          delete nextAttributes[key];
+        } else {
+          nextAttributes[key] = value;
+        }
+      }
+      result.push({
+        text: segment.text,
+        attributes: Object.keys(nextAttributes).length === 0 ? void 0 : freeze(nextAttributes)
+      });
+    } else {
+      result.push(segment);
+    }
+    offset = end;
+  }
+  return normalizeSegments(result);
+}
+function formatReverseOperations(segments, index, length, patch) {
+  const split = splitSegmentsAt(
+    splitSegmentsAt(segments, index),
+    index + length
+  );
+  const result = [];
+  let offset = 0;
+  for (const segment of split) {
+    const end = offset + segment.text.length;
+    if (offset >= index && end <= index + length) {
+      const attributes = {};
+      for (const key of Object.keys(patch)) {
+        attributes[key] = segment.attributes?.[key] ?? null;
+      }
+      result.push({
+        type: "format",
+        index: offset,
+        length: segment.text.length,
+        attributes
+      });
+    }
+    offset = end;
+  }
+  return result;
+}
+function mapIndexThroughOperation(index, op) {
+  if (op.type === "insert") {
+    return op.index <= index ? index + op.text.length : index;
+  } else if (op.type === "delete") {
+    if (op.index >= index) {
+      return index;
+    }
+    return Math.max(op.index, index - op.length);
+  } else {
+    return index;
+  }
+}
+function mapTextIndexThroughOperations(index, ops) {
+  let mapped = index;
+  for (const op of ops) {
+    mapped = mapIndexThroughOperation(mapped, op);
+  }
+  return mapped;
+}
+function inverseMapIndexThroughOperation(index, op) {
+  if (op.type === "insert") {
+    if (index <= op.index) {
+      return index;
+    }
+    return Math.max(op.index, index - op.text.length);
+  } else if (op.type === "delete") {
+    return op.index <= index ? index + op.length : index;
+  } else {
+    return index;
+  }
+}
+function inverseMapTextIndexThroughOperations(index, ops) {
+  let mapped = index;
+  for (let i = ops.length - 1; i >= 0; i--) {
+    mapped = inverseMapIndexThroughOperation(mapped, ops[i]);
+  }
+  return mapped;
+}
+function oppositeOrder(order) {
+  return order === "before" ? "after" : "before";
+}
+function mapIndexOverDelete(index, deleteIndex, deleteLength) {
+  if (deleteIndex >= index) {
+    return index;
+  }
+  return Math.max(deleteIndex, index - deleteLength);
+}
+function transformInsert(op, over, order) {
+  if (over.type === "insert") {
+    const shifts = over.index < op.index || over.index === op.index && order === "after";
+    return [shifts ? { ...op, index: op.index + over.text.length } : { ...op }];
+  } else if (over.type === "delete") {
+    return [
+      { ...op, index: mapIndexOverDelete(op.index, over.index, over.length) }
+    ];
+  } else {
+    return [{ ...op }];
+  }
+}
+function transformDelete(op, over) {
+  const start = op.index;
+  const end = op.index + op.length;
+  if (over.type === "insert") {
+    const at = over.index;
+    const len = over.text.length;
+    if (at <= start) {
+      return [{ ...op, index: start + len }];
+    }
+    if (at >= end) {
+      return [{ ...op }];
+    }
+    return [
+      { type: "delete", index: start, length: at - start },
+      { type: "delete", index: start + len, length: end - at }
+    ];
+  } else if (over.type === "delete") {
+    const newStart = mapIndexOverDelete(start, over.index, over.length);
+    const newEnd = mapIndexOverDelete(end, over.index, over.length);
+    return newEnd - newStart > 0 ? [{ type: "delete", index: newStart, length: newEnd - newStart }] : [];
+  } else {
+    return [{ ...op }];
+  }
+}
+function transformFormat(op, over, order) {
+  const start = op.index;
+  const end = op.index + op.length;
+  if (over.type === "insert") {
+    const at = over.index;
+    const len = over.text.length;
+    if (at <= start) {
+      return [{ ...op, index: start + len }];
+    }
+    if (at >= end) {
+      return [{ ...op }];
+    }
+    return [
+      {
+        type: "format",
+        index: start,
+        length: at - start,
+        attributes: op.attributes
+      },
+      {
+        type: "format",
+        index: at + len,
+        length: end - at,
+        attributes: op.attributes
+      }
+    ];
+  } else if (over.type === "delete") {
+    const newStart = mapIndexOverDelete(start, over.index, over.length);
+    const newEnd = mapIndexOverDelete(end, over.index, over.length);
+    return newEnd - newStart > 0 ? [
+      {
+        type: "format",
+        index: newStart,
+        length: newEnd - newStart,
+        attributes: op.attributes
+      }
+    ] : [];
+  } else {
+    if (order === "after") {
+      return [{ ...op }];
+    }
+    const overlapStart = Math.max(start, over.index);
+    const overlapEnd = Math.min(end, over.index + over.length);
+    if (overlapStart >= overlapEnd) {
+      return [{ ...op }];
+    }
+    const hasConflict = Object.keys(op.attributes).some(
+      (key) => key in over.attributes
+    );
+    if (!hasConflict) {
+      return [{ ...op }];
+    }
+    const reduced = {};
+    for (const [key, value] of Object.entries(op.attributes)) {
+      if (!(key in over.attributes)) {
+        reduced[key] = value;
+      }
+    }
+    const pieces = [];
+    if (start < overlapStart) {
+      pieces.push({
+        type: "format",
+        index: start,
+        length: overlapStart - start,
+        attributes: op.attributes
+      });
+    }
+    if (Object.keys(reduced).length > 0) {
+      pieces.push({
+        type: "format",
+        index: overlapStart,
+        length: overlapEnd - overlapStart,
+        attributes: reduced
+      });
+    }
+    if (overlapEnd < end) {
+      pieces.push({
+        type: "format",
+        index: overlapEnd,
+        length: end - overlapEnd,
+        attributes: op.attributes
+      });
+    }
+    return pieces;
+  }
+}
+function transformSingle(op, over, order) {
+  switch (op.type) {
+    case "insert":
+      return transformInsert(op, over, order);
+    case "delete":
+      return transformDelete(op, over);
+    case "format":
+      return transformFormat(op, over, order);
+  }
+}
+function transformTextOperationsX(a, b, order) {
+  if (a.length === 0 || b.length === 0) {
+    return [[...a], [...b]];
+  }
+  if (a.length === 1 && b.length === 1) {
+    return [
+      transformSingle(a[0], b[0], order),
+      transformSingle(b[0], a[0], oppositeOrder(order))
+    ];
+  }
+  if (a.length > 1) {
+    const [headA1, b1] = transformTextOperationsX([a[0]], b, order);
+    const [restA1, b2] = transformTextOperationsX(a.slice(1), b1, order);
+    return [[...headA1, ...restA1], b2];
+  }
+  const [a1, headB1] = transformTextOperationsX(a, [b[0]], order);
+  const [a2, restB1] = transformTextOperationsX(a1, b.slice(1), order);
+  return [a2, [...headB1, ...restB1]];
+}
+function transformTextOperations(ops, over, order) {
+  return transformTextOperationsX(ops, over, order)[0];
+}
+function textOperationsEqual(a, b) {
+  return a === b || stableStringify(a) === stableStringify(b);
+}
+function applyTextOperationsToSegments(segments, ops) {
+  let next = [...segments];
+  for (const op of ops) {
+    if (op.type === "insert") {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      next = applyInsert(next, index, op.text, op.attributes);
+    } else if (op.type === "delete") {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      const clipped = clipRange(index, op.length, textLength(next));
+      next = applyDelete(next, clipped.index, clipped.length).segments;
+    } else {
+      const index = Math.max(0, Math.min(op.index, textLength(next)));
+      const clipped = clipRange(index, op.length, textLength(next));
+      next = applyFormat(next, clipped.index, clipped.length, op.attributes);
+    }
+  }
+  return next;
+}
+function applyLiveTextOperations(data, ops) {
+  return segmentsToData(
+    applyTextOperationsToSegments(dataToSegments(data), ops)
+  );
+}
+function invertTextOperations(segments, ops) {
+  let shadow = [...segments];
+  const reverse = [];
+  for (const op of ops) {
+    if (op.type === "insert") {
+      shadow = applyInsert(shadow, op.index, op.text, op.attributes);
+      reverse.unshift({
+        type: "delete",
+        index: op.index,
+        length: op.text.length
+      });
+    } else if (op.type === "delete") {
+      const deletedSegments = extractDeletedSegments(
+        shadow,
+        op.index,
+        op.length
+      );
+      shadow = applyDelete(shadow, op.index, op.length).segments;
+      const inserts = [];
+      let insertIndex = op.index;
+      for (const segment of deletedSegments) {
+        inserts.push({
+          type: "insert",
+          index: insertIndex,
+          text: segment.text,
+          attributes: segment.attributes
+        });
+        insertIndex += segment.text.length;
+      }
+      for (let index = inserts.length - 1; index >= 0; index--) {
+        reverse.unshift(inserts[index]);
+      }
+    } else {
+      const inverse = formatReverseOperations(
+        shadow,
+        op.index,
+        op.length,
+        op.attributes
+      );
+      shadow = applyFormat(shadow, op.index, op.length, op.attributes);
+      reverse.unshift(...inverse.reverse());
+    }
+  }
+  return reverse;
+}
+
+// src/crdts/LiveText.ts
+var ACCEPTED_OPS_HISTORY_LIMIT = 1e3;
+var LiveText = class _LiveText extends AbstractCrdt {
+  /** The local document: #confirmed ⊕ #inFlightOps ⊕ #queuedOps. */
+  #segments;
+  /** The server-confirmed document (only authoritative ops applied). */
+  #confirmed;
+  #version;
+  /** The op currently awaiting server acknowledgement (at most one). */
+  #inFlightOpId;
+  /** Its ops, continuously re-expressed against current server state. */
+  #inFlightOps = [];
+  /** Local edits made while an op is in flight; sent after the ack. */
+  #queuedOps = [];
+  #acceptedOps = [];
+  /**
+   * Creates a new LiveText document.
+   *
+   * @param textOrData Initial plain text, or an array of `[text]` /
+   *   `[text, attributes]` segments. Defaults to an empty document.
+   *
+   * @example
+   * new LiveText();
+   * new LiveText("Hello world");
+   * new LiveText([["Hello ", { bold: true }], ["world"]]);
+   */
+  constructor(textOrData = "", version = 0) {
+    super();
+    this.#segments = typeof textOrData === "string" ? textOrData.length === 0 ? [] : [{ text: textOrData }] : dataToSegments(textOrData);
+    this.#confirmed = [...this.#segments];
+    this.#version = version;
+    Object.defineProperty(this, kInternal, {
+      value: {
+        encodeIndex: (localIndex) => this.#encodeIndex(localIndex),
+        decodeIndex: (index, fromVersion) => this.#decodeIndex(index, fromVersion)
+      },
+      enumerable: false
+    });
+  }
+  get version() {
+    return this.#version;
+  }
+  get length() {
+    return textLength(this.#segments);
+  }
+  /** @internal */
+  static _deserialize([id, item], _parentToChildren, pool) {
+    const text = new _LiveText(item.data, item.version);
+    text._attach(id, pool);
+    return text;
+  }
+  /** @internal */
+  _toOps(parentId, parentKey) {
+    if (this._id === void 0) {
+      throw new Error("Cannot serialize LiveText if it is not attached");
+    }
+    return [
+      {
+        type: OpCode.CREATE_TEXT,
+        id: this._id,
+        parentId,
+        parentKey,
+        data: this.toJSON(),
+        version: this.#version
+      }
+    ];
+  }
+  /** @internal */
+  _serialize() {
+    if (this.parent.type !== "HasParent") {
+      throw new Error("Cannot serialize LiveText if parent is missing");
+    }
+    return {
+      type: CrdtType.TEXT,
+      parentId: nn(this.parent.node._id, "Parent node expected to have ID"),
+      parentKey: this.parent.key,
+      data: this.toJSON(),
+      version: this.#version
+    };
+  }
+  /** @internal */
+  _attachChild(_op) {
+    throw new Error("LiveText cannot contain child nodes");
+  }
+  /** @internal */
+  _detachChild(_crdt) {
+    throw new Error("LiveText cannot contain child nodes");
+  }
+  /** @internal */
+  _apply(op, isLocal) {
+    if (op.type !== OpCode.UPDATE_TEXT) {
+      return super._apply(op, isLocal);
+    }
+    if (isLocal) {
+      return this.#applyLocal(op);
+    }
+    if (op.opId !== void 0 && op.opId === this.#inFlightOpId) {
+      return this.#applyAck(op);
+    }
+    if (op.opId !== void 0 && this.#acceptedOps.some((entry) => entry.opId === op.opId)) {
+      this.#version = Math.max(this.#version, op.version ?? op.baseVersion + 1);
+      return { modified: false };
+    }
+    return this.#applyRemote(op);
+  }
+  /**
+   * Inserts text at the given index.
+   *
+   * @param index Character index at which to insert. Values outside the
+   *   document range are clipped.
+   * @param text Text to insert.
+   * @param attributes Optional inline attributes for the inserted text.
+   *
+   * @example
+   * const text = new LiveText("Hello");
+   * text.insert(5, " world");
+   * text.insert(0, "Say: ", { italic: true });
+   */
+  insert(index, text, attributes) {
+    const clippedIndex = Math.max(0, Math.min(index, this.length));
+    this.#dispatch([{ type: "insert", index: clippedIndex, text, attributes }]);
+  }
+  /**
+   * Deletes `length` characters starting at `index`.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.delete(5, 6); // "Hello"
+   */
+  delete(index, length) {
+    const clipped = clipRange(index, length, this.length);
+    if (clipped.length === 0) {
+      return;
+    }
+    this.#dispatch([
+      { type: "delete", index: clipped.index, length: clipped.length }
+    ]);
+  }
+  /**
+   * Replaces a range of text with new text.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.replace(0, 5, "Hi"); // "Hi world"
+   */
+  replace(index, length, text, attributes) {
+    const clipped = clipRange(index, length, this.length);
+    const ops = [];
+    if (clipped.length > 0) {
+      ops.push({
+        type: "delete",
+        index: clipped.index,
+        length: clipped.length
+      });
+    }
+    if (text.length > 0) {
+      ops.push({ type: "insert", index: clipped.index, text, attributes });
+    }
+    this.#dispatch(ops);
+  }
+  /**
+   * Encode a local-document index (an offset into this LiveText's current
+   * #segments, which CodeMirror or any consumer mirrors as its document)
+   * into server-confirmed coordinates suitable for broadcasting to peers via
+   * presence or any other side channel.
+   *
+   * The returned index is in this LiveText's current #confirmed coordinates
+   * — that is, with this client's local pending ops inverse-mapped out.
+   * Pair it with the current {@link LiveText.version} when sending so the
+   * receiver can call {@link PrivateLiveTextApi.decodeIndex} to land the
+   * position in their own local document coordinates regardless of their
+   * private pending ops.
+   *
+   * Index ambiguity at boundaries is resolved by an inverse-of-forward
+   * convention: a position at or before a local insertion is reported as
+   * the position right before the insertion in #confirmed; a position past
+   * the insertion shifts left by the insertion's length. Positions inside
+   * an own-pending insertion collapse to the insertion point.
+   */
+  #encodeIndex(localIndex) {
+    let mapped = Math.max(0, Math.min(localIndex, this.length));
+    mapped = inverseMapTextIndexThroughOperations(mapped, this.#queuedOps);
+    mapped = inverseMapTextIndexThroughOperations(mapped, this.#inFlightOps);
+    return mapped;
+  }
+  /**
+   * Decode an `(index, fromVersion)` pair produced by
+   * {@link PrivateLiveTextApi.encodeIndex} — typically on a peer — into an
+   * offset in this LiveText's current local document (an index suitable for
+   * placing a CodeMirror marker, an annotation anchor, or anything else that
+   * lives over #segments).
+   *
+   * Composes the accepted ops applied since `fromVersion` (drawn from
+   * #acceptedOps in locally-applied form) with this client's own local
+   * pending ops, in that order. The result is in current #segments
+   * coordinates.
+   *
+   * Returns `null` when the position cannot be decoded against the current
+   * state:
+   *  - `fromVersion` is greater than this LiveText's current version: the
+   *    peer is ahead of us. The caller should park the message and retry
+   *    after more accepted ops arrive.
+   *  - `fromVersion` falls outside the retained accepted-ops history. This
+   *    only happens after very long-lived disconnections; the caller can
+   *    fall back to using the raw index and letting subsequent local
+   *    transactions map it (with bounded drift).
+   */
+  #decodeIndex(index, fromVersion) {
+    if (fromVersion > this.#version) {
+      return null;
+    }
+    if (fromVersion < this.#version) {
+      const oldest = this.#acceptedOps[0]?.version;
+      if (oldest === void 0 || oldest > fromVersion + 1) {
+        return null;
+      }
+    }
+    let mapped = index;
+    for (const entry of this.#acceptedOps) {
+      if (entry.version <= fromVersion) continue;
+      if (entry.version > this.#version) break;
+      if (entry.ops.length === 0) continue;
+      mapped = mapTextIndexThroughOperations(mapped, entry.ops);
+    }
+    mapped = mapTextIndexThroughOperations(mapped, this.#inFlightOps);
+    mapped = mapTextIndexThroughOperations(mapped, this.#queuedOps);
+    return Math.max(0, Math.min(mapped, this.length));
+  }
+  /**
+   * Applies or removes inline attributes on a range of text.
+   *
+   * Set an attribute to `null` to remove it from the range.
+   *
+   * @example
+   * const text = new LiveText("Hello world");
+   * text.format(0, 5, { bold: true });
+   * text.format(0, 5, { bold: null });
+   */
+  format(index, length, attributes) {
+    const clipped = clipRange(index, length, this.length);
+    if (clipped.length === 0) {
+      return;
+    }
+    this.#dispatch([
+      {
+        type: "format",
+        index: clipped.index,
+        length: clipped.length,
+        attributes
+      }
+    ]);
+  }
+  /** Local edits made through the public API. */
+  #dispatch(ops) {
+    if (ops.length === 0) {
+      return;
+    }
+    this._pool?.assertStorageIsWritable();
+    const attached = this._pool !== void 0 && this._id !== void 0;
+    const reverse = attached ? this.#invertOperations(ops) : [];
+    const changes = this.#applyOperationsLocally(ops);
+    if (!attached) {
+      return;
+    }
+    const pool = nn(this._pool);
+    const id = nn(this._id);
+    const updates = /* @__PURE__ */ new Map([
+      [
+        id,
+        {
+          type: "LiveText",
+          node: this,
+          version: this.#version,
+          updates: changes
+        }
+      ]
+    ]);
+    if (this.#inFlightOpId === void 0) {
+      const opId = pool.generateOpId();
+      this.#inFlightOpId = opId;
+      this.#inFlightOps = [...ops];
+      pool.dispatch(
+        [
+          {
+            type: OpCode.UPDATE_TEXT,
+            id,
+            opId,
+            baseVersion: this.#version,
+            ops: [...ops]
+          }
+        ],
+        reverse,
+        updates
+      );
+    } else {
+      this.#queuedOps.push(...ops);
+      pool.dispatch([], reverse, updates, { clearRedoStack: true });
+    }
+  }
+  /**
+   * A local replay of an existing wire op: an undo/redo frame, or an
+   * unacknowledged op re-sent after a reconnect.
+   */
+  #applyLocal(op) {
+    const mutableOp = op;
+    if (op.opId !== void 0 && op.opId === this.#inFlightOpId) {
+      this.#inFlightOps = [...this.#inFlightOps, ...this.#queuedOps];
+      this.#queuedOps = [];
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [...this.#inFlightOps];
+      return { modified: false };
+    }
+    let ops = op.ops;
+    for (const entry of this.#acceptedOps) {
+      if (entry.version > op.baseVersion && entry.ops.length > 0) {
+        ops = transformTextOperations(ops, entry.ops, "after");
+      }
+    }
+    const reverse = this.#invertOperations(ops);
+    const changes = this.#applyOperationsLocally(ops);
+    if (this.#inFlightOpId === void 0 && ops.length > 0) {
+      this.#inFlightOpId = nn(op.opId, "Local ops must have an opId");
+      this.#inFlightOps = [...ops];
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [...ops];
+    } else {
+      this.#queuedOps.push(...ops);
+      mutableOp.baseVersion = this.#version;
+      mutableOp.ops = [];
+    }
+    if (changes.length === 0) {
+      return { modified: false };
+    }
+    return {
+      reverse,
+      modified: {
+        type: "LiveText",
+        node: this,
+        version: this.#version,
+        updates: changes
+      }
+    };
+  }
+  /** Server acknowledgement of our in-flight op. */
+  #applyAck(op) {
+    const ackedVersion = op.version ?? Math.max(this.#version, op.baseVersion + 1);
+    const predicted = this.#inFlightOps;
+    const opId = this.#inFlightOpId;
+    this.#confirmed = applyTextOperationsToSegments(this.#confirmed, op.ops);
+    this.#inFlightOpId = void 0;
+    this.#inFlightOps = [];
+    let appliedOps = [];
+    let result = { modified: false };
+    if (!textOperationsEqual(op.ops, predicted)) {
+      error2(
+        "LiveText: acknowledgement did not match the local prediction; resynchronizing"
+      );
+      const rebuilt = this.#rebuildLocalFromConfirmed();
+      appliedOps = rebuilt.appliedOps;
+      if (rebuilt.changes.length > 0) {
+        result = {
+          reverse: [],
+          modified: {
+            type: "LiveText",
+            node: this,
+            version: ackedVersion,
+            updates: rebuilt.changes
+          }
+        };
+      }
+    }
+    this.#version = Math.max(this.#version, ackedVersion);
+    this.#recordAccepted(ackedVersion, appliedOps, opId);
+    this.#flushQueued();
+    return result;
+  }
+  /** An accepted op from another client (or a server-fabricated fix op). */
+  #applyRemote(op) {
+    const version = op.version ?? this.#version + 1;
+    this.#confirmed = applyTextOperationsToSegments(this.#confirmed, op.ops);
+    const [overInFlight, inFlight] = transformTextOperationsX(
+      op.ops,
+      this.#inFlightOps,
+      "before"
+    );
+    const [applied, queued] = transformTextOperationsX(
+      overInFlight,
+      this.#queuedOps,
+      "before"
+    );
+    this.#inFlightOps = inFlight;
+    this.#queuedOps = queued;
+    this.#recordAccepted(version, applied, op.opId);
+    if (applied.length === 0) {
+      this.#version = Math.max(this.#version, version);
+      return { modified: false };
+    }
+    const reverse = this.#invertOperations(applied);
+    const changes = this.#applyOperationsLocally(applied);
+    this.#version = Math.max(this.#version, version);
+    return {
+      reverse,
+      modified: {
+        type: "LiveText",
+        node: this,
+        version: this.#version,
+        updates: changes
+      }
+    };
+  }
+  /** Send the queued ops as the next in-flight op (after an ack). */
+  #flushQueued() {
+    if (this.#queuedOps.length === 0 || this._pool === void 0 || this._id === void 0) {
+      return;
+    }
+    const opId = this._pool.generateOpId();
+    this.#inFlightOpId = opId;
+    this.#inFlightOps = this.#queuedOps;
+    this.#queuedOps = [];
+    this._pool.dispatch(
+      [
+        {
+          type: OpCode.UPDATE_TEXT,
+          id: this._id,
+          opId,
+          baseVersion: this.#version,
+          ops: [...this.#inFlightOps]
+        }
+      ],
+      [],
+      /* @__PURE__ */ new Map(),
+      // The local content was already applied (and made undoable) when the
+      // edits happened; this is purely an outbound flush.
+      { clearRedoStack: false }
+    );
+  }
+  /**
+   * Rebuild the local document as confirmed ⊕ queued ops, returning the
+   * coarse delta that was applied. Only used by defensive recovery paths.
+   */
+  #rebuildLocalFromConfirmed() {
+    const before2 = this.#segments;
+    const after2 = applyTextOperationsToSegments(this.#confirmed, [
+      ...this.#inFlightOps,
+      ...this.#queuedOps
+    ]);
+    if (stableStringify(segmentsToData(before2)) === stableStringify(segmentsToData(after2))) {
+      this.#segments = after2;
+      return { appliedOps: [], changes: [] };
+    }
+    const beforeText = before2.map((segment) => segment.text).join("");
+    this.#segments = after2;
+    this.invalidate();
+    const appliedOps = [];
+    const changes = [];
+    if (beforeText.length > 0) {
+      appliedOps.push({ type: "delete", index: 0, length: beforeText.length });
+      changes.push({
+        type: "delete",
+        index: 0,
+        length: beforeText.length,
+        deletedText: beforeText
+      });
+    }
+    let index = 0;
+    for (const segment of after2) {
+      appliedOps.push({
+        type: "insert",
+        index,
+        text: segment.text,
+        attributes: segment.attributes
+      });
+      changes.push({
+        type: "insert",
+        index,
+        text: segment.text,
+        attributes: segment.attributes
+      });
+      index += segment.text.length;
+    }
+    return { appliedOps, changes };
+  }
+  /**
+   * Reconcile this node against an authoritative storage snapshot (e.g.
+   * after a reconnect). The confirmed state and version are replaced by the
+   * snapshot's; pending (in-flight + queued) ops are preserved on top and
+   * will be re-sent by the offline-ops replay.
+   *
+   * @internal
+   */
+  _resyncText(data, version) {
+    this.#confirmed = dataToSegments(data);
+    this.#version = version;
+    this.#acceptedOps = [];
+    const rebuilt = this.#rebuildLocalFromConfirmed();
+    if (rebuilt.changes.length === 0) {
+      return void 0;
+    }
+    return {
+      type: "LiveText",
+      node: this,
+      version: this.#version,
+      updates: rebuilt.changes
+    };
+  }
+  /**
+   * Called when the server rejected one of our ops. Drops all pending state
+   * for this node (edits queued behind a rejected op cannot be trusted
+   * either); the room follows up with a storage resync.
+   *
+   * @internal
+   */
+  _rejectPendingOp(opId) {
+    if (opId !== this.#inFlightOpId) {
+      return;
+    }
+    this.#inFlightOpId = void 0;
+    this.#inFlightOps = [];
+    this.#queuedOps = [];
+  }
+  #recordAccepted(version, ops, opId) {
+    if (this.#acceptedOps.some((entry) => entry.version === version)) {
+      return;
+    }
+    this.#acceptedOps.push({ version, opId, ops: [...ops] });
+    this.#acceptedOps.sort((left, right) => left.version - right.version);
+    if (this.#acceptedOps.length > ACCEPTED_OPS_HISTORY_LIMIT) {
+      this.#acceptedOps.splice(
+        0,
+        this.#acceptedOps.length - ACCEPTED_OPS_HISTORY_LIMIT
+      );
+    }
+  }
+  #applyOperationsLocally(ops) {
+    const changes = [];
+    for (const op of ops) {
+      if (op.type === "insert") {
+        this.#segments = applyInsert(
+          this.#segments,
+          op.index,
+          op.text,
+          op.attributes
+        );
+        changes.push({
+          type: "insert",
+          index: op.index,
+          text: op.text,
+          attributes: op.attributes
+        });
+      } else if (op.type === "delete") {
+        const result = applyDelete(this.#segments, op.index, op.length);
+        this.#segments = result.segments;
+        changes.push({
+          type: "delete",
+          index: op.index,
+          length: op.length,
+          deletedText: result.deletedText
+        });
+      } else {
+        this.#segments = applyFormat(
+          this.#segments,
+          op.index,
+          op.length,
+          op.attributes
+        );
+        changes.push({
+          type: "format",
+          index: op.index,
+          length: op.length,
+          attributes: op.attributes
+        });
+      }
+    }
+    this.invalidate();
+    return changes;
+  }
+  #invertOperations(ops) {
+    return [
+      {
+        type: OpCode.UPDATE_TEXT,
+        id: nn(this._id),
+        baseVersion: this.#version,
+        ops: invertTextOperations(this.#segments, ops)
+      }
+    ];
+  }
+  /** Returns the plain text content without attributes. Equivalent to joining the text from each segment in {@link LiveText.toJSON}. */
+  toString() {
+    return this.#segments.map((segment) => segment.text).join("");
+  }
+  /**
+   * Returns a JSON-compatible snapshot of the document as a {@link LiveTextData}
+   * array.
+   *
+   * @example
+   * new LiveText([["Hello ", { bold: true }], ["world"]]).toJSON();
+   * // [["Hello ", { bold: true }], ["world"]]
+   */
+  toJSON() {
+    return super.toJSON();
+  }
+  /** @internal */
+  _toJSON() {
+    return segmentsToData(this.#segments);
+  }
+  /** @internal */
+  _toTreeNode(key) {
+    return {
+      type: "LiveText",
+      id: this._id ?? nanoid(),
+      key,
+      payload: [
+        {
+          type: "Json",
+          id: `${this._id ?? nanoid()}:text`,
+          key: "text",
+          payload: this.toString()
+        }
+      ]
+    };
+  }
+  clone() {
+    return new _LiveText(this.toJSON(), this.#version);
+  }
+};
+
+// src/crdts/liveblocks-helpers.ts
+function creationOpToLiveNode(op) {
+  return lsonToLiveNode(creationOpToLson(op));
+}
+function creationOpToLson(op) {
+  switch (op.type) {
+    case OpCode.CREATE_REGISTER:
+      return op.data;
+    case OpCode.CREATE_OBJECT:
+      return new LiveObject(op.data);
+    case OpCode.CREATE_MAP:
+      return new LiveMap();
+    case OpCode.CREATE_LIST:
+      return new LiveList([]);
+    case OpCode.CREATE_TEXT:
+      return new LiveText(op.data, op.version);
+    default:
+      return assertNever(op, "Unknown creation Op");
+  }
+}
+function isSameNodeOrChildOf(node, parent) {
+  if (node === parent) {
+    return true;
+  }
+  if (node.parent.type === "HasParent") {
+    return isSameNodeOrChildOf(node.parent.node, parent);
+  }
+  return false;
+}
+function deserialize(node, parentToChildren, pool) {
+  if (isObjectStorageNode(node)) {
+    return LiveObject._deserialize(node, parentToChildren, pool);
+  } else if (isListStorageNode(node)) {
+    return LiveList._deserialize(node, parentToChildren, pool);
+  } else if (isMapStorageNode(node)) {
+    return LiveMap._deserialize(node, parentToChildren, pool);
+  } else if (isRegisterStorageNode(node)) {
+    return LiveRegister._deserialize(node, parentToChildren, pool);
+  } else if (isTextStorageNode(node)) {
+    return LiveText._deserialize(node, parentToChildren, pool);
+  } else {
+    throw new Error("Unexpected CRDT type");
+  }
+}
+function deserializeToLson(node, parentToChildren, pool) {
+  if (isObjectStorageNode(node)) {
+    return LiveObject._deserialize(node, parentToChildren, pool);
+  } else if (isListStorageNode(node)) {
+    return LiveList._deserialize(node, parentToChildren, pool);
+  } else if (isMapStorageNode(node)) {
+    return LiveMap._deserialize(node, parentToChildren, pool);
+  } else if (isRegisterStorageNode(node)) {
+    return node[1].data;
+  } else if (isTextStorageNode(node)) {
+    return LiveText._deserialize(node, parentToChildren, pool);
+  } else {
+    throw new Error("Unexpected CRDT type");
+  }
+}
+function isLiveStructure(value) {
+  return isLiveList(value) || isLiveMap(value) || isLiveObject(value) || isLiveText(value);
+}
+function isLiveNode(value) {
+  return isLiveStructure(value) || isLiveRegister(value);
+}
+function isLiveList(value) {
+  return value instanceof LiveList;
+}
+function isLiveMap(value) {
+  return value instanceof LiveMap;
+}
+function isLiveObject(value) {
+  return value instanceof LiveObject;
+}
+function isLiveText(value) {
+  return value instanceof LiveText;
 }
 function isLiveRegister(value) {
   return value instanceof LiveRegister;
@@ -8503,14 +9920,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 LiveText) {
     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 LiveText) {
     return value;
   } else {
     return new LiveRegister(value);
@@ -8541,23 +9958,68 @@ function dumpPool(pool) {
     (r) => `  ${r.id}  parent=${r.parentId}  key=${r.key || "\u2014"}  ${r.value}`
   ).join("\n");
 }
-function getTreesDiffOperations(currentItems, newItems) {
+function isJsonEq(a, b) {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) {
+    return false;
+  }
+  if (Array.isArray(a) || Array.isArray(b)) {
+    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {
+      return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+      if (!isJsonEq(a[i], b[i])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  const aKeys = Object.keys(a);
+  if (aKeys.length !== Object.keys(b).length) {
+    return false;
+  }
+  for (const key of aKeys) {
+    if (!isJsonEq(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+function diffNodeMap(prev, next) {
   const ops = [];
-  currentItems.forEach((_, id) => {
-    if (!newItems.get(id)) {
+  prev.forEach((_, id) => {
+    if (!next.get(id)) {
       ops.push({ type: OpCode.DELETE_CRDT, id });
     }
   });
-  newItems.forEach((crdt, id) => {
-    const currentCrdt = currentItems.get(id);
+  next.forEach((crdt, id) => {
+    const currentCrdt = prev.get(id);
     if (currentCrdt) {
       if (crdt.type === CrdtType.OBJECT) {
-        if (currentCrdt.type !== CrdtType.OBJECT || stringifyOrLog(crdt.data) !== stringifyOrLog(currentCrdt.data)) {
-          ops.push({
-            type: OpCode.UPDATE_OBJECT,
-            id,
-            data: crdt.data
-          });
+        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)
+            });
+          }
+          for (const key of Object.keys(currentCrdt.data)) {
+            if (!(key in crdt.data)) {
+              ops.push({ type: OpCode.DELETE_OBJECT_KEY, id, key });
+            }
+          }
         }
       }
       if (crdt.parentKey !== currentCrdt.parentKey) {
@@ -8608,6 +10070,16 @@ function getTreesDiffOperations(currentItems, newItems) {
             parentKey: crdt.parentKey
           });
           break;
+        case CrdtType.TEXT:
+          ops.push({
+            type: OpCode.CREATE_TEXT,
+            id,
+            parentId: crdt.parentId,
+            parentKey: crdt.parentKey,
+            data: crdt.data,
+            version: crdt.version
+          });
+          break;
       }
     }
   });
@@ -8640,19 +10112,43 @@ function mergeListStorageUpdates(first, second) {
     updates: updates.concat(second.updates)
   };
 }
+function mergeTextStorageUpdates(first, second) {
+  return {
+    ...second,
+    updates: first.updates.concat(second.updates)
+  };
+}
 function mergeStorageUpdates(first, second) {
   if (first === void 0) {
     return second;
   }
+  let merged;
   if (first.type === "LiveObject" && second.type === "LiveObject") {
-    return mergeObjectStorageUpdates(first, second);
+    merged = mergeObjectStorageUpdates(first, second);
   } else if (first.type === "LiveMap" && second.type === "LiveMap") {
-    return mergeMapStorageUpdates(first, second);
+    merged = mergeMapStorageUpdates(first, second);
   } else if (first.type === "LiveList" && second.type === "LiveList") {
-    return mergeListStorageUpdates(first, second);
+    merged = mergeListStorageUpdates(first, second);
+  } else if (first.type === "LiveText" && second.type === "LiveText") {
+    merged = mergeTextStorageUpdates(first, second);
   } else {
+    merged = second;
+  }
+  const sa = first[kStorageUpdateSource];
+  const sb = second[kStorageUpdateSource];
+  if (sa !== void 0 || sb !== void 0) {
+    if (sa?.origin === "remote" || sb?.origin === "remote") {
+      merged[kStorageUpdateSource] = { origin: "remote" };
+    } else if (sa?.via === "history" || sb?.via === "history") {
+      const historySource = sb?.via === "history" ? sb : sa?.via === "history" ? sa : void 0;
+      if (historySource?.via === "history") {
+        merged[kStorageUpdateSource] = historySource;
+      }
+    } else {
+      merged[kStorageUpdateSource] = { origin: "local", via: "mutation" };
+    }
   }
-  return second;
+  return merged;
 }
 
 // src/devtools/bridge.ts
@@ -8780,7 +10276,7 @@ function partialSyncConnection(room) {
   });
 }
 function partialSyncStorage(room) {
-  const root = room.getStorageSnapshot();
+  const root = room.getStorageOrNull();
   if (root) {
     sendToPanel({
       msg: "room::sync::partial",
@@ -8810,7 +10306,7 @@ function partialSyncOthers(room) {
   }
 }
 function fullSync(room) {
-  const root = room.getStorageSnapshot();
+  const root = room.getStorageOrNull();
   const me = room[kInternal].getSelf_forDevTools();
   const others = room[kInternal].getOthers_forDevTools();
   room.fetchYDoc("");
@@ -9235,15 +10731,15 @@ var ClientMsgCode = Object.freeze({
 
 // src/refs/ManagedOthers.ts
 function makeUser(conn, presence) {
-  const { connectionId, id, info } = conn;
-  const canWrite = canWriteStorage(conn.scopes);
+  const { connectionId, id, info, access } = conn;
+  const { canWrite, canComment } = access;
   return freeze(
     compactObject({
       connectionId,
       id,
       info,
       canWrite,
-      canComment: canComment(conn.scopes),
+      canComment,
       isReadOnly: !canWrite,
       // Deprecated, kept for backward-compatibility
       presence
@@ -9314,7 +10810,7 @@ var ManagedOthers = class {
    * Records a known connection. This records the connection ID and the
    * associated metadata.
    */
-  setConnection(connectionId, metaUserId, metaUserInfo, scopes) {
+  setConnection(connectionId, metaUserId, metaUserInfo, access) {
     this.#internal.mutate((state) => {
       state.connections.set(
         connectionId,
@@ -9322,7 +10818,7 @@ var ManagedOthers = class {
           connectionId,
           id: metaUserId,
           info: metaUserInfo,
-          scopes
+          access
         })
       );
       if (!state.presences.has(connectionId)) {
@@ -9475,6 +10971,14 @@ function defaultMessageFromContext(context) {
 
 // src/room.ts
 var FEEDS_TIMEOUT = 5e3;
+function connectionAccessFromScopes(scopes) {
+  const roomPermissions = normalizeRoomPermissions(scopes);
+  const matrix = permissionMatrixFromScopes(roomPermissions);
+  return {
+    canWrite: hasPermissionAccess(matrix, "storage", "write"),
+    canComment: hasPermissionAccess(matrix, "comments", "write")
+  };
+}
 function makeIdFactory(connectionId) {
   let count = 0;
   return () => `${connectionId}:${count++}`;
@@ -9588,6 +11092,8 @@ function createRoom(options, config) {
     activeBatch: null,
     unacknowledgedOps
   };
+  let nextHistoryItemId = 0;
+  let historyDisabled = 0;
   const nodeMapBuffer = makeNodeMapBuffer();
   const stopwatch = config.enableDebugLogging ? makeStopWatch() : void 0;
   let lastTokenKey;
@@ -9647,12 +11153,13 @@ function createRoom(options, config) {
       )
     };
     if (_getStorage$ !== null) {
-      refreshStorage({ flush: false });
+      refreshStorage();
     }
     flushNowOrSoon();
   }
   function onDidDisconnect() {
     clearTimeout(context.buffer.flushTimerID);
+    context.unacknowledgedOps.markAllAsPossiblyStored();
   }
   managedSocket.events.onMessage.subscribe(handleServerMessage);
   managedSocket.events.statusDidChange.subscribe(onStatusDidChange);
@@ -9671,7 +11178,10 @@ function createRoom(options, config) {
       }
     }
   });
-  function onDispatch(ops, reverse, storageUpdates) {
+  function onDispatch(ops, reverse, storageUpdates, options2) {
+    for (const value of storageUpdates.values()) {
+      value[kStorageUpdateSource] = { origin: "local", via: "mutation" };
+    }
     if (context.activeBatch) {
       for (const op of ops) {
         context.activeBatch.ops.push(op);
@@ -9690,16 +11200,18 @@ function createRoom(options, config) {
       if (reverse.length > 0) {
         addToUndoStack(reverse);
       }
+      if (options2?.clearRedoStack ?? ops.length > 0) {
+        clearRedoStack();
+      }
       if (ops.length > 0) {
-        context.redoStack.length = 0;
         dispatchOps(ops);
       }
       notify({ storageUpdates });
     }
   }
   function isStorageWritable() {
-    const scopes = context.dynamicSessionInfoSig.get()?.scopes;
-    return scopes !== void 0 ? canWriteStorage(scopes) : true;
+    const permissionMatrix = context.dynamicSessionInfoSig.get()?.permissionMatrix;
+    return permissionMatrix !== void 0 ? hasPermissionAccess(permissionMatrix, "storage", "write") : true;
   }
   const eventHub = {
     status: makeEventSource(),
@@ -9711,6 +11223,7 @@ function createRoom(options, config) {
     others: makeEventSource(),
     storageBatch: makeEventSource(),
     history: makeEventSource(),
+    privateHistory: makeEventSource(),
     storageDidLoad: makeEventSource(),
     storageStatus: makeEventSource(),
     ydoc: makeEventSource(),
@@ -9760,14 +11273,22 @@ function createRoom(options, config) {
       if (staticSession === null || dynamicSession === null) {
         return null;
       } else {
-        const canWrite = canWriteStorage(dynamicSession.scopes);
+        const canWrite = hasPermissionAccess(
+          dynamicSession.permissionMatrix,
+          "storage",
+          "write"
+        );
         return {
           connectionId: dynamicSession.actor,
           id: staticSession.userId,
           info: staticSession.userInfo,
           presence: myPresence,
           canWrite,
-          canComment: canComment(dynamicSession.scopes)
+          canComment: hasPermissionAccess(
+            dynamicSession.permissionMatrix,
+            "comments",
+            "write"
+          )
         };
       }
     }
@@ -9793,12 +11314,25 @@ function createRoom(options, config) {
       for (const [id, crdt] of context.pool.nodes) {
         currentItems.set(id, crdt._serialize());
       }
-      const ops = getTreesDiffOperations(currentItems, nodes);
-      const result = applyRemoteOps(
-        ops,
-        /* fromSnapshot */
-        true
-      );
+      const ops = diffNodeMap(currentItems, nodes);
+      const result = applyRemoteOps(ops);
+      for (const [id, crdt] of nodes) {
+        if (crdt.type === CrdtType.TEXT) {
+          const node = context.pool.nodes.get(id);
+          if (node !== void 0 && isLiveText(node)) {
+            const update = node._resyncText(crdt.data, crdt.version);
+            if (update !== void 0) {
+              result.updates.storageUpdates.set(
+                id,
+                mergeStorageUpdates(
+                  result.updates.storageUpdates.get(id),
+                  update
+                )
+              );
+            }
+          }
+        }
+      }
       notify(result.updates);
     } else {
       context.root = LiveObject._fromItems(
@@ -9822,11 +11356,26 @@ function createRoom(options, config) {
       }
     });
   }
+  function notifyPrivateHistory(event) {
+    if (historyDisabled > 0) return;
+    eventHub.privateHistory.notify(event);
+  }
+  function clearRedoStack() {
+    if (context.redoStack.length === 0) return;
+    const ids = context.redoStack.map((item) => item.id);
+    context.redoStack.length = 0;
+    notifyPrivateHistory({ action: "discard", ids });
+  }
   function _addToRealUndoStack(frames) {
     if (context.undoStack.length >= 50) {
-      context.undoStack.shift();
+      const evicted = context.undoStack.shift();
+      if (evicted !== void 0) {
+        notifyPrivateHistory({ action: "discard", ids: [evicted.id] });
+      }
     }
-    context.undoStack.push(frames);
+    const id = nextHistoryItemId++;
+    context.undoStack.push({ id, frames });
+    notifyPrivateHistory({ action: "push", id });
     onHistoryChange();
   }
   function addToUndoStack(frames) {
@@ -9864,7 +11413,7 @@ function createRoom(options, config) {
       "Internal. Tried to get connection id but connection was never open"
     );
   }
-  function applyLocalOps(frames) {
+  function applyLocalOps(frames, localStorageUpdateSource = { origin: "local", via: "mutation" }) {
     const [pframes, ops] = partition(
       frames,
       (f) => f.type === "presence"
@@ -9876,20 +11425,20 @@ function createRoom(options, config) {
       pframes,
       opsWithOpIds,
       /* isLocal */
-      true
+      true,
+      localStorageUpdateSource
     );
     return { opsToEmit: opsWithOpIds, reverse, updates };
   }
-  function applyRemoteOps(ops, fromSnapshot = false) {
+  function applyRemoteOps(ops) {
     return applyOps(
       [],
       ops,
       /* isLocal */
-      false,
-      fromSnapshot
+      false
     );
   }
-  function applyOps(pframes, ops, isLocal, fromSnapshot = false) {
+  function applyOps(pframes, ops, isLocal, localStorageUpdateSource = { origin: "local", via: "mutation" }) {
     const output = {
       reverse: new Deque(),
       storageUpdates: /* @__PURE__ */ new Map(),
@@ -9925,8 +11474,9 @@ function createRoom(options, config) {
       } else {
         source = 1 /* THEIRS */;
       }
-      const applyOpResult = applyOp(op, source, fromSnapshot);
+      const applyOpResult = applyOp(op, source);
       if (applyOpResult.modified) {
+        applyOpResult.modified[kStorageUpdateSource] = source === 1 /* THEIRS */ ? { origin: "remote" } : localStorageUpdateSource;
         const nodeId = applyOpResult.modified.node._id;
         if (!(nodeId && createdNodeIds.has(nodeId))) {
           output.storageUpdates.set(
@@ -9938,7 +11488,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_TEXT) {
           createdNodeIds.add(op.id);
         }
       }
@@ -9951,13 +11501,14 @@ function createRoom(options, config) {
       }
     };
   }
-  function applyOp(op, source, fromSnapshot = false) {
+  function applyOp(op, source) {
     if (isIgnoredOp(op)) {
       return { modified: false };
     }
     switch (op.type) {
       case OpCode.DELETE_OBJECT_KEY:
       case OpCode.UPDATE_OBJECT:
+      case OpCode.UPDATE_TEXT:
       case OpCode.DELETE_CRDT: {
         const node = context.pool.nodes.get(op.id);
         if (node === void 0) {
@@ -9982,6 +11533,7 @@ function createRoom(options, config) {
       case OpCode.CREATE_OBJECT:
       case OpCode.CREATE_LIST:
       case OpCode.CREATE_MAP:
+      case OpCode.CREATE_TEXT:
       case OpCode.CREATE_REGISTER: {
         if (op.parentId === void 0) {
           return { modified: false };
@@ -9990,7 +11542,7 @@ function createRoom(options, config) {
         if (parentNode === void 0) {
           return { modified: false };
         }
-        return parentNode._attachChild(op, source, fromSnapshot);
+        return parentNode._attachChild(op, source);
       }
     }
   }
@@ -10061,7 +11613,9 @@ function createRoom(options, config) {
     context.dynamicSessionInfoSig.set({
       actor: message.actor,
       nonce: message.nonce,
-      scopes: message.scopes,
+      permissionMatrix: permissionMatrixFromScopes(
+        normalizeRoomPermissions(message.scopes)
+      ),
       meta: message.meta
     });
     context.idFactory = makeIdFactory(message.actor);
@@ -10082,7 +11636,7 @@ function createRoom(options, config) {
         connectionId,
         user.id,
         user.info,
-        user.scopes
+        connectionAccessFromScopes(user.scopes)
       );
     }
     return { type: "reset" };
@@ -10102,7 +11656,7 @@ function createRoom(options, config) {
       message.actor,
       message.id,
       message.info,
-      message.scopes
+      connectionAccessFromScopes(message.scopes)
     );
     context.buffer.messages.push({
       type: ClientMsgCode.UPDATE_PRESENCE,
@@ -10229,16 +11783,37 @@ function createRoom(options, config) {
           }
           break;
         }
-        // Receiving a RejectedOps message in the client means that the server is no
-        // longer in sync with the client. Trying to synchronize the client again by
-        // rolling back particular Ops may be hard/impossible. It's fine to not try and
-        // accept the out-of-sync reality and throw an error.
+        // Receiving a RejectedOps message means the server refused some of
+        // our ops, so our optimistic local state is out of sync with the
+        // server. For LiveText ops this is a normal (if rare) situation —
+        // e.g. a client that was offline long enough to fall outside the
+        // server's retained history window — and we can recover: drop the
+        // rejected pending state and re-fetch the authoritative storage
+        // snapshot. For other ops (e.g. permission rejections), rolling back
+        // particular Ops is hard/impossible, so we keep the old behavior of
+        // accepting the out-of-sync reality and surfacing an error.
         case ServerMsgCode.REJECT_STORAGE_OP: {
           errorWithTitle(
             "Storage mutation rejection error",
             message.reason
           );
-          if (process.env.NODE_ENV !== "production") {
+          let needsStorageResync = false;
+          for (const opId of message.opIds) {
+            const rejectedOp = context.unacknowledgedOps.get(opId);
+            context.unacknowledgedOps.delete(opId);
+            context.buffer.storageOperations = context.buffer.storageOperations.filter((op) => op.opId !== opId);
+            if (rejectedOp !== void 0 && rejectedOp.type === OpCode.UPDATE_TEXT) {
+              const node = context.pool.nodes.get(rejectedOp.id);
+              if (node !== void 0 && isLiveText(node)) {
+                node._rejectPendingOp(opId);
+                needsStorageResync = true;
+              }
+            }
+          }
+          if (needsStorageResync) {
+            refreshStorage();
+            flushNowOrSoon();
+          } else if (process.env.NODE_ENV !== "production") {
             throw new Error(
               `Storage mutations rejected by server: ${message.reason}`
             );
@@ -10592,29 +12167,18 @@ function createRoom(options, config) {
     notifyStorageStatus();
     eventHub.storageDidLoad.notify();
   }
-  async function streamStorage() {
-    if (!managedSocket.authValue) return;
-    const nodes = new Map(
-      await httpClient.streamStorage({ roomId })
-    );
-    processInitialStorage(nodes);
-  }
-  function refreshStorage(options2) {
+  function refreshStorage() {
     const messages = context.buffer.messages;
-    if (config.unstable_streamData) {
-      void streamStorage();
-    } else if (!messages.some((msg) => msg.type === ClientMsgCode.FETCH_STORAGE)) {
+    if (!messages.some((msg) => msg.type === ClientMsgCode.FETCH_STORAGE)) {
       messages.push({ type: ClientMsgCode.FETCH_STORAGE });
       nodeMapBuffer.take();
       stopwatch?.start();
     }
-    if (options2.flush) {
-      flushNowOrSoon();
-    }
   }
   function startLoadingStorage() {
     if (_getStorage$ === null) {
-      refreshStorage({ flush: true });
+      refreshStorage();
+      flushNowOrSoon();
       _getStorage$ = new Promise((resolve) => {
         _resolveStoragePromise = resolve;
       });
@@ -10622,7 +12186,7 @@ function createRoom(options, config) {
     }
     return _getStorage$;
   }
-  function getStorageSnapshot() {
+  function getStorageOrNull() {
     const root = context.root;
     if (root !== void 0) {
       return root;
@@ -10791,14 +12355,19 @@ function createRoom(options, config) {
     if (context.activeBatch) {
       throw new Error("undo is not allowed during a batch");
     }
-    const frames = context.undoStack.pop();
-    if (frames === void 0) {
+    const item = context.undoStack.pop();
+    if (item === void 0) {
       return;
     }
     context.pausedHistory = null;
-    const result = applyLocalOps(frames);
+    const result = applyLocalOps(item.frames, {
+      origin: "local",
+      via: "history",
+      action: "undo"
+    });
+    context.redoStack.push({ id: item.id, frames: result.reverse });
+    notifyPrivateHistory({ action: "undo", id: item.id });
     notify(result.updates);
-    context.redoStack.push(result.reverse);
     onHistoryChange();
     for (const op of result.opsToEmit) {
       context.buffer.storageOperations.push(op);
@@ -10809,14 +12378,19 @@ function createRoom(options, config) {
     if (context.activeBatch) {
       throw new Error("redo is not allowed during a batch");
     }
-    const frames = context.redoStack.pop();
-    if (frames === void 0) {
+    const item = context.redoStack.pop();
+    if (item === void 0) {
       return;
     }
     context.pausedHistory = null;
-    const result = applyLocalOps(frames);
+    const result = applyLocalOps(item.frames, {
+      origin: "local",
+      via: "history",
+      action: "redo"
+    });
+    context.undoStack.push({ id: item.id, frames: result.reverse });
+    notifyPrivateHistory({ action: "redo", id: item.id });
     notify(result.updates);
-    context.undoStack.push(result.reverse);
     onHistoryChange();
     for (const op of result.opsToEmit) {
       context.buffer.storageOperations.push(op);
@@ -10826,6 +12400,8 @@ function createRoom(options, config) {
   function clear() {
     context.undoStack.length = 0;
     context.redoStack.length = 0;
+    notifyPrivateHistory({ action: "clear" });
+    onHistoryChange();
   }
   function batch2(callback) {
     if (context.activeBatch) {
@@ -10854,7 +12430,7 @@ function createRoom(options, config) {
         commitPausedHistoryToUndoStack();
       }
       if (currentBatch.ops.length > 0) {
-        context.redoStack.length = 0;
+        clearRedoStack();
       }
       if (currentBatch.ops.length > 0) {
         dispatchOps(currentBatch.ops);
@@ -10883,7 +12459,6 @@ function createRoom(options, config) {
     }
     commitPausedHistoryToUndoStack();
   }
-  let historyDisabled = 0;
   function disableHistory(fn) {
     const origUndo = context.undoStack;
     const origRedo = context.redoStack;
@@ -10936,7 +12511,7 @@ function createRoom(options, config) {
     }
   }
   function isStorageReady() {
-    return getStorageSnapshot() !== null;
+    return getStorageOrNull() !== null;
   }
   async function waitUntilStorageReady() {
     while (!isStorageReady()) {
@@ -11122,13 +12697,28 @@ function createRoom(options, config) {
         },
         // prettier-ignore
         get undoStack() {
-          return deepClone(context.undoStack);
+          return structuredClone(
+            context.undoStack.map((item) => ({
+              id: item.id,
+              frames: item.frames
+            }))
+          );
+        },
+        // prettier-ignore
+        get redoStack() {
+          return structuredClone(
+            context.redoStack.map((item) => ({
+              id: item.id,
+              frames: item.frames
+            }))
+          );
         },
         // prettier-ignore
         get nodeCount() {
           return context.pool.nodes.size;
         },
         // prettier-ignore
+        history: eventHub.privateHistory.observable,
         getYjsProvider() {
           return context.yjsProvider;
         },
@@ -11179,7 +12769,9 @@ function createRoom(options, config) {
       _dump: () => {
         const n = context.pool.nodes.size;
         return `Room "${roomId}" (${n} node${n === 1 ? "" : "s"}):
-${dumpPool(context.pool)}`;
+${dumpPool(
+          context.pool
+        )}`;
       },
       destroy: () => {
         pendingFeedsRequests.forEach(
@@ -11226,7 +12818,9 @@ ${dumpPool(context.pool)}`;
       updateFeedMessage,
       deleteFeedMessage,
       getStorage,
-      getStorageSnapshot,
+      getStorageOrNull,
+      getStorageSnapshot: getStorageOrNull,
+      // Deprecated alias, will be removed in the future
       getStorageStatus,
       isPresenceReady,
       isStorageReady,
@@ -11372,7 +12966,11 @@ function isRoomEventName(value) {
 }
 function makeAuthDelegateForRoom(roomId, authManager) {
   return async () => {
-    return authManager.getAuthValue({ requestedScope: "room:read", roomId });
+    return authManager.getAuthValue({
+      roomId,
+      resource: "room",
+      access: "read"
+    });
   };
 }
 function makeCreateSocketDelegateForRoom(roomId, baseUrl, WebSocketPolyfill) {
@@ -11444,7 +13042,6 @@ function createClient(options) {
   const httpClient = createApiClient({
     baseUrl,
     fetchPolyfill,
-    currentUserId,
     authManager
   });
   const roomsById = /* @__PURE__ */ new Map();
@@ -11462,7 +13059,8 @@ function createClient(options) {
       ),
       authenticate: async () => {
         const resp = await authManager.getAuthValue({
-          requestedScope: "room:read"
+          resource: "personal",
+          access: "write"
         });
         if (resp.type === "public") {
           throw new StopRetrying(
@@ -11535,7 +13133,6 @@ function createClient(options) {
         enableDebugLogging: clientOptions.enableDebugLogging,
         baseUrl,
         errorEventSource: liveblocksErrorSource,
-        unstable_streamData: !!clientOptions.unstable_streamData,
         roomHttpClient: httpClient,
         createSyncSource,
         badgeLocation: clientOptions.badgeLocation ?? "bottom-right"
@@ -12141,6 +13738,12 @@ function toPlainLson(lson) {
       liveblocksType: "LiveList",
       data: [...lson].map((item) => toPlainLson(item))
     };
+  } else if (lson instanceof LiveText) {
+    return {
+      liveblocksType: "LiveText",
+      data: lson.toJSON(),
+      version: lson.version
+    };
   } else {
     return lson;
   }
@@ -12322,6 +13925,7 @@ export {
   LiveList,
   LiveMap,
   LiveObject,
+  LiveText,
   LiveblocksError,
   MENTION_CHARACTER,
   MutableSignal,
@@ -12333,6 +13937,7 @@ export {
   SortedList,
   TextEditorType,
   WebsocketCloseCodes,
+  applyLiveTextOperations,
   asPos,
   assert,
   assertNever,
@@ -12359,6 +13964,7 @@ export {
   createManagedPool,
   createNotificationSettings,
   createThreadId,
+  deepLiveify,
   defineAiTool,
   deprecate,
   deprecateIf,
@@ -12370,6 +13976,7 @@ export {
   generateUrl,
   getMentionsFromCommentBody,
   getSubscriptionKey,
+  hasPermissionAccess,
   html,
   htmlSafe,
   isCommentBodyLink,
@@ -12388,8 +13995,10 @@ export {
   isRegisterStorageNode,
   isRootStorageNode,
   isStartsWithOperator,
+  isTextStorageNode,
   isUrl,
   kInternal,
+  kStorageUpdateSource,
   keys,
   makeAbortController,
   makeEventSource,
@@ -12397,11 +14006,16 @@ export {
   makePosition,
   mapValues,
   memoizeOnSuccess,
+  mergeRoomPermissionScopes,
   nanoid,
   nn,
   nodeStreamToCompactNodes,
+  normalizeRoomAccesses,
+  normalizeRoomPermissions,
+  normalizeUpdateRoomAccesses,
   objectToQuery,
   patchNotificationSettings,
+  permissionMatrixFromScopes,
   raise,
   resolveMentionsInCommentBody,
   sanitizeUrl,
@@ -12411,9 +14025,11 @@ export {
   stringifyCommentBody,
   throwUsageError,
   toPlainLson,
+  transformTextOperations,
   tryParseJson,
   url,
   urljoin,
+  validatePermissionsSet,
   wait,
   warnOnce,
   warnOnceIf,