@liveblocks/core 3.13.0-rc2 → 3.13.0-vincent2

package/dist/index.d.cts

@@ -342,7 +342,6 @@ declare const OpCode: Readonly<{
     DELETE_OBJECT_KEY: 6;
     CREATE_MAP: 7;
     CREATE_REGISTER: 8;
-    ACK: 9;
 }>;
 declare namespace OpCode {
     type INIT = typeof OpCode.INIT;
@@ -354,7 +353,6 @@ declare namespace OpCode {
     type DELETE_OBJECT_KEY = typeof OpCode.DELETE_OBJECT_KEY;
     type CREATE_MAP = typeof OpCode.CREATE_MAP;
     type CREATE_REGISTER = typeof OpCode.CREATE_REGISTER;
-    type ACK = typeof OpCode.ACK;
 }
 /**
  * These operations are the payload for {@link UpdateStorageServerMsg} messages
@@ -592,6 +590,7 @@ declare namespace CrdtType {
 }
 type SerializedCrdt = SerializedRootObject | SerializedChild;
 type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
+type NodeStream = Iterable<IdTuple<SerializedCrdt>>;
 type SerializedRootObject = {
     readonly type: CrdtType.OBJECT;
     readonly data: JsonObject;
@@ -620,6 +619,36 @@ type SerializedRegister = {
     readonly parentKey: string;
     readonly data: Json;
 };
+type CompactNode = CompactRootNode | CompactChildNode;
+type CompactChildNode = CompactObjectNode | CompactListNode | CompactMapNode | CompactRegisterNode;
+type CompactRootNode = readonly [id: "root", data: JsonObject];
+type CompactObjectNode = readonly [
+    id: string,
+    type: CrdtType.OBJECT,
+    parentId: string,
+    parentKey: string,
+    data: JsonObject
+];
+type CompactListNode = readonly [
+    id: string,
+    type: CrdtType.LIST,
+    parentId: string,
+    parentKey: string
+];
+type CompactMapNode = readonly [
+    id: string,
+    type: CrdtType.MAP,
+    parentId: string,
+    parentKey: string
+];
+type CompactRegisterNode = readonly [
+    id: string,
+    type: CrdtType.REGISTER,
+    parentId: string,
+    parentKey: string,
+    data: Json
+];
+declare function nodeStreamToCompactNodes(nodes: NodeStream): Iterable<CompactNode>;
 
 type LiveObjectUpdateDelta<O extends {
     [key: string]: unknown;
@@ -653,7 +682,7 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
      */
     static detectLargeObjects: boolean;
     /** @private Do not use this API directly */
-    static _fromItems<O extends LsonObject>(items: IdTuple<SerializedCrdt>[], pool: ManagedPool): LiveObject<O>;
+    static _fromItems<O extends LsonObject>(nodes: NodeStream, pool: ManagedPool): LiveObject<O>;
     constructor(obj?: O);
     /**
      * Transform the LiveObject into a javascript object
@@ -2492,7 +2521,8 @@ declare const ServerMsgCode: Readonly<{
     USER_LEFT: 102;
     BROADCASTED_EVENT: 103;
     ROOM_STATE: 104;
-    STORAGE_STATE: 200;
+    STORAGE_STATE_V7: 200;
+    STORAGE_CHUNK: 210;
     UPDATE_STORAGE: 201;
     UPDATE_YDOC: 300;
     THREAD_CREATED: 400;
@@ -2512,7 +2542,8 @@ declare namespace ServerMsgCode {
     type USER_LEFT = typeof ServerMsgCode.USER_LEFT;
     type BROADCASTED_EVENT = typeof ServerMsgCode.BROADCASTED_EVENT;
     type ROOM_STATE = typeof ServerMsgCode.ROOM_STATE;
-    type STORAGE_STATE = typeof ServerMsgCode.STORAGE_STATE;
+    type STORAGE_STATE_V7 = typeof ServerMsgCode.STORAGE_STATE_V7;
+    type STORAGE_CHUNK = typeof ServerMsgCode.STORAGE_CHUNK;
     type UPDATE_STORAGE = typeof ServerMsgCode.UPDATE_STORAGE;
     type UPDATE_YDOC = typeof ServerMsgCode.UPDATE_YDOC;
     type THREAD_CREATED = typeof ServerMsgCode.THREAD_CREATED;
@@ -2529,7 +2560,7 @@ declare namespace ServerMsgCode {
 /**
  * Messages that can be sent from the server to the client.
  */
-type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | InitialDocumentStateServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
+type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg_V7 | StorageChunkServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
 type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved;
 type ThreadCreatedEvent = {
     type: ServerMsgCode.THREAD_CREATED;
@@ -2693,40 +2724,47 @@ type BroadcastedEventServerMsg<E extends Json> = {
  */
 type RoomStateServerMsg<U extends BaseUserMeta> = {
     readonly type: ServerMsgCode.ROOM_STATE;
-    /**
-     * Informs the client what their actor ID is going to be.
-     * @since v1.2 (WS API v7)
-     */
+    /** Informs the client what their actor ID is going to be. */
     readonly actor: number;
-    /**
-     * Secure nonce for the current session.
-     * @since v1.2 (WS API v7)
-     */
+    /** Secure nonce for the current session. */
     readonly nonce: string;
-    /**
-     * Informs the client what permissions the current User (self) has.
-     * @since v1.2 (WS API v7)
-     */
+    /** Informs the client what permissions the current User (self) has. */
     readonly scopes: string[];
     readonly users: {
         readonly [otherActor: number]: U & {
             scopes: string[];
         };
     };
-    /**
-     * Metadata sent from the server to the client.
-     */
+    /** Metadata sent from the server to the client. */
     readonly meta: JsonObject;
 };
 /**
- * Sent by the WebSocket server to a single client in response to the client
- * joining the Room, to provide the initial Storage state of the Room. The
- * payload includes the entire Storage document.
+ * No longer used as of WS API v8.
  */
-type InitialDocumentStateServerMsg = {
-    readonly type: ServerMsgCode.STORAGE_STATE;
+type StorageStateServerMsg_V7 = {
+    readonly type: ServerMsgCode.STORAGE_STATE_V7;
     readonly items: IdTuple<SerializedCrdt>[];
 };
+/**
+ * Sent by the WebSocket server to a single client in response to the client
+ * sending a FetchStorageClientMsg message, to provide the initial Storage
+ * state of the Room.
+ *
+ * The server will respond with 0+ STORAGE_CHUNK messages with
+ * done=false, followed by exactly one STORAGE_CHUNK message with
+ * done=true.
+ *
+ * If the room is using the new storage engine that supports streaming, then
+ * potentially multiple chunks might get sent.
+ *
+ * If the room is using the old storage engine, then all nodes will be sent in
+ * a single/large chunk (non-streaming).
+ */
+type StorageChunkServerMsg = {
+    readonly type: ServerMsgCode.STORAGE_CHUNK;
+    readonly done: boolean;
+    readonly nodes: CompactNode[];
+};
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a change occurred in the Storage document.
@@ -5182,4 +5220,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type CompactChildNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageChunkServerMsg, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };

package/dist/index.d.ts

@@ -342,7 +342,6 @@ declare const OpCode: Readonly<{
     DELETE_OBJECT_KEY: 6;
     CREATE_MAP: 7;
     CREATE_REGISTER: 8;
-    ACK: 9;
 }>;
 declare namespace OpCode {
     type INIT = typeof OpCode.INIT;
@@ -354,7 +353,6 @@ declare namespace OpCode {
     type DELETE_OBJECT_KEY = typeof OpCode.DELETE_OBJECT_KEY;
     type CREATE_MAP = typeof OpCode.CREATE_MAP;
     type CREATE_REGISTER = typeof OpCode.CREATE_REGISTER;
-    type ACK = typeof OpCode.ACK;
 }
 /**
  * These operations are the payload for {@link UpdateStorageServerMsg} messages
@@ -592,6 +590,7 @@ declare namespace CrdtType {
 }
 type SerializedCrdt = SerializedRootObject | SerializedChild;
 type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
+type NodeStream = Iterable<IdTuple<SerializedCrdt>>;
 type SerializedRootObject = {
     readonly type: CrdtType.OBJECT;
     readonly data: JsonObject;
@@ -620,6 +619,36 @@ type SerializedRegister = {
     readonly parentKey: string;
     readonly data: Json;
 };
+type CompactNode = CompactRootNode | CompactChildNode;
+type CompactChildNode = CompactObjectNode | CompactListNode | CompactMapNode | CompactRegisterNode;
+type CompactRootNode = readonly [id: "root", data: JsonObject];
+type CompactObjectNode = readonly [
+    id: string,
+    type: CrdtType.OBJECT,
+    parentId: string,
+    parentKey: string,
+    data: JsonObject
+];
+type CompactListNode = readonly [
+    id: string,
+    type: CrdtType.LIST,
+    parentId: string,
+    parentKey: string
+];
+type CompactMapNode = readonly [
+    id: string,
+    type: CrdtType.MAP,
+    parentId: string,
+    parentKey: string
+];
+type CompactRegisterNode = readonly [
+    id: string,
+    type: CrdtType.REGISTER,
+    parentId: string,
+    parentKey: string,
+    data: Json
+];
+declare function nodeStreamToCompactNodes(nodes: NodeStream): Iterable<CompactNode>;
 
 type LiveObjectUpdateDelta<O extends {
     [key: string]: unknown;
@@ -653,7 +682,7 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
      */
     static detectLargeObjects: boolean;
     /** @private Do not use this API directly */
-    static _fromItems<O extends LsonObject>(items: IdTuple<SerializedCrdt>[], pool: ManagedPool): LiveObject<O>;
+    static _fromItems<O extends LsonObject>(nodes: NodeStream, pool: ManagedPool): LiveObject<O>;
     constructor(obj?: O);
     /**
      * Transform the LiveObject into a javascript object
@@ -2492,7 +2521,8 @@ declare const ServerMsgCode: Readonly<{
     USER_LEFT: 102;
     BROADCASTED_EVENT: 103;
     ROOM_STATE: 104;
-    STORAGE_STATE: 200;
+    STORAGE_STATE_V7: 200;
+    STORAGE_CHUNK: 210;
     UPDATE_STORAGE: 201;
     UPDATE_YDOC: 300;
     THREAD_CREATED: 400;
@@ -2512,7 +2542,8 @@ declare namespace ServerMsgCode {
     type USER_LEFT = typeof ServerMsgCode.USER_LEFT;
     type BROADCASTED_EVENT = typeof ServerMsgCode.BROADCASTED_EVENT;
     type ROOM_STATE = typeof ServerMsgCode.ROOM_STATE;
-    type STORAGE_STATE = typeof ServerMsgCode.STORAGE_STATE;
+    type STORAGE_STATE_V7 = typeof ServerMsgCode.STORAGE_STATE_V7;
+    type STORAGE_CHUNK = typeof ServerMsgCode.STORAGE_CHUNK;
     type UPDATE_STORAGE = typeof ServerMsgCode.UPDATE_STORAGE;
     type UPDATE_YDOC = typeof ServerMsgCode.UPDATE_YDOC;
     type THREAD_CREATED = typeof ServerMsgCode.THREAD_CREATED;
@@ -2529,7 +2560,7 @@ declare namespace ServerMsgCode {
 /**
  * Messages that can be sent from the server to the client.
  */
-type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | InitialDocumentStateServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
+type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | StorageStateServerMsg_V7 | StorageChunkServerMsg | UpdateStorageServerMsg | YDocUpdateServerMsg | RejectedStorageOpServerMsg | CommentsEventServerMsg;
 type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved;
 type ThreadCreatedEvent = {
     type: ServerMsgCode.THREAD_CREATED;
@@ -2693,40 +2724,47 @@ type BroadcastedEventServerMsg<E extends Json> = {
  */
 type RoomStateServerMsg<U extends BaseUserMeta> = {
     readonly type: ServerMsgCode.ROOM_STATE;
-    /**
-     * Informs the client what their actor ID is going to be.
-     * @since v1.2 (WS API v7)
-     */
+    /** Informs the client what their actor ID is going to be. */
     readonly actor: number;
-    /**
-     * Secure nonce for the current session.
-     * @since v1.2 (WS API v7)
-     */
+    /** Secure nonce for the current session. */
     readonly nonce: string;
-    /**
-     * Informs the client what permissions the current User (self) has.
-     * @since v1.2 (WS API v7)
-     */
+    /** Informs the client what permissions the current User (self) has. */
     readonly scopes: string[];
     readonly users: {
         readonly [otherActor: number]: U & {
             scopes: string[];
         };
     };
-    /**
-     * Metadata sent from the server to the client.
-     */
+    /** Metadata sent from the server to the client. */
     readonly meta: JsonObject;
 };
 /**
- * Sent by the WebSocket server to a single client in response to the client
- * joining the Room, to provide the initial Storage state of the Room. The
- * payload includes the entire Storage document.
+ * No longer used as of WS API v8.
  */
-type InitialDocumentStateServerMsg = {
-    readonly type: ServerMsgCode.STORAGE_STATE;
+type StorageStateServerMsg_V7 = {
+    readonly type: ServerMsgCode.STORAGE_STATE_V7;
     readonly items: IdTuple<SerializedCrdt>[];
 };
+/**
+ * Sent by the WebSocket server to a single client in response to the client
+ * sending a FetchStorageClientMsg message, to provide the initial Storage
+ * state of the Room.
+ *
+ * The server will respond with 0+ STORAGE_CHUNK messages with
+ * done=false, followed by exactly one STORAGE_CHUNK message with
+ * done=true.
+ *
+ * If the room is using the new storage engine that supports streaming, then
+ * potentially multiple chunks might get sent.
+ *
+ * If the room is using the old storage engine, then all nodes will be sent in
+ * a single/large chunk (non-streaming).
+ */
+type StorageChunkServerMsg = {
+    readonly type: ServerMsgCode.STORAGE_CHUNK;
+    readonly done: boolean;
+    readonly nodes: CompactNode[];
+};
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a change occurred in the Storage document.
@@ -5182,4 +5220,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeRetrievalPart, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiSourcesPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUrlSource, type AiUserMessage, type AiWebRetrievalPart, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type CompactChildNode, type CompactListNode, type CompactMapNode, type CompactNode, type CompactObjectNode, type CompactRegisterNode, type CompactRootNode, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISODateString, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, type LayerKey, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SearchCommentsResult, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageChunkServerMsg, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type UrlMetadata, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isNumberOperator, isPlainObject, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, nodeStreamToCompactNodes, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "3.13.0-rc2";
+var PKG_VERSION = "3.13.0-vincent2";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -3090,7 +3090,10 @@ var ServerMsgCode = Object.freeze({
   BROADCASTED_EVENT: 103,
   ROOM_STATE: 104,
   // For Storage
-  STORAGE_STATE: 200,
+  STORAGE_STATE_V7: 200,
+  // Only sent in V7
+  STORAGE_CHUNK: 210,
+  // Used in V8+
   UPDATE_STORAGE: 201,
   // For Yjs Docs
   UPDATE_YDOC: 300,
@@ -5922,9 +5925,7 @@ var OpCode = Object.freeze({
   DELETE_CRDT: 5,
   DELETE_OBJECT_KEY: 6,
   CREATE_MAP: 7,
-  CREATE_REGISTER: 8,
-  ACK: 9
-  // Will only appear in v8+
+  CREATE_REGISTER: 8
 });
 function isAckOp(op) {
   return op.type === OpCode.DELETE_CRDT && op.id === "ACK";
@@ -6142,6 +6143,57 @@ var CrdtType = Object.freeze({
   MAP: 2,
   REGISTER: 3
 });
+function isRootNode(node) {
+  return node[0] === "root";
+}
+function isRootCrdt(id, _) {
+  return id === "root";
+}
+function* compactNodesToNodeStream(nodes) {
+  for (const node of nodes) {
+    const id = node[0];
+    if (isRootNode(node)) {
+      yield [id, { type: CrdtType.OBJECT, data: node[1] }];
+      continue;
+    }
+    switch (node[1]) {
+      case CrdtType.OBJECT:
+        yield [id, { type: CrdtType.OBJECT, parentId: node[2], parentKey: node[3], data: node[4] }];
+        break;
+      case CrdtType.LIST:
+        yield [id, { type: CrdtType.LIST, parentId: node[2], parentKey: node[3] }];
+        break;
+      case CrdtType.MAP:
+        yield [id, { type: CrdtType.MAP, parentId: node[2], parentKey: node[3] }];
+        break;
+      case CrdtType.REGISTER:
+        yield [id, { type: CrdtType.REGISTER, parentId: node[2], parentKey: node[3], data: node[4] }];
+        break;
+    }
+  }
+}
+function* nodeStreamToCompactNodes(nodes) {
+  for (const [id, node] of nodes) {
+    switch (node.type) {
+      case CrdtType.OBJECT:
+        if (isRootCrdt(id, node)) {
+          yield [id, node.data];
+        } else {
+          yield [id, CrdtType.OBJECT, node.parentId, node.parentKey, node.data];
+        }
+        break;
+      case CrdtType.LIST:
+        yield [id, CrdtType.LIST, node.parentId, node.parentKey];
+        break;
+      case CrdtType.MAP:
+        yield [id, CrdtType.MAP, node.parentId, node.parentKey];
+        break;
+      case CrdtType.REGISTER:
+        yield [id, CrdtType.REGISTER, node.parentId, node.parentKey, node.data];
+        break;
+    }
+  }
+}
 
 // src/crdts/LiveRegister.ts
 var LiveRegister = class _LiveRegister extends AbstractCrdt {
@@ -7576,7 +7628,7 @@ var LiveMap = class _LiveMap extends AbstractCrdt {
 
 // src/crdts/LiveObject.ts
 var MAX_LIVE_OBJECT_SIZE = 128 * 1024;
-function isRootCrdt(id, _) {
+function isRootCrdt2(id, _) {
   return id === "root";
 }
 var LiveObject = class _LiveObject extends AbstractCrdt {
@@ -7596,7 +7648,7 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     const parentToChildren = /* @__PURE__ */ new Map();
     let root = null;
     for (const [id, crdt] of items) {
-      if (isRootCrdt(id, crdt)) {
+      if (isRootCrdt2(id, crdt)) {
         root = crdt;
       } else {
         const tuple = [id, crdt];
@@ -7614,8 +7666,8 @@ var LiveObject = class _LiveObject extends AbstractCrdt {
     return [root, parentToChildren];
   }
   /** @private Do not use this API directly */
-  static _fromItems(items, pool) {
-    const [root, parentToChildren] = _LiveObject.#buildRootAndParentToChildren(items);
+  static _fromItems(nodes, pool) {
+    const [root, parentToChildren] = _LiveObject.#buildRootAndParentToChildren(nodes);
     return _LiveObject._deserialize(
       ["root", root],
       parentToChildren,
@@ -8234,10 +8286,7 @@ function getTreesDiffOperations(currentItems, newItems) {
   const ops = [];
   currentItems.forEach((_, id) => {
     if (!newItems.get(id)) {
-      ops.push({
-        type: OpCode.DELETE_CRDT,
-        id
-      });
+      ops.push({ type: OpCode.DELETE_CRDT, id });
     }
   });
   newItems.forEach((crdt, id) => {
@@ -8735,6 +8784,21 @@ function installBackgroundTabSpy() {
   };
   return [inBackgroundSince, unsub];
 }
+function makePartialNodeMap() {
+  let map = /* @__PURE__ */ new Map();
+  return {
+    append(chunk2) {
+      for (const [id, node] of chunk2) {
+        map.set(id, node);
+      }
+    },
+    clear() {
+      const result = map;
+      map = /* @__PURE__ */ new Map();
+      return result;
+    }
+  };
+}
 function createRoom(options, config) {
   const roomId = config.roomId;
   const initialPresence = options.initialPresence;
@@ -8795,6 +8859,7 @@ function createRoom(options, config) {
     activeBatch: null,
     unacknowledgedOps: /* @__PURE__ */ new Map()
   };
+  const partialNodes = makePartialNodeMap();
   let lastTokenKey;
   function onStatusDidChange(newStatus) {
     const authValue = managedSocket.authValue;
@@ -9076,14 +9141,11 @@ function createRoom(options, config) {
     self,
     (me) => me !== null ? userToTreeNode("Me", me) : null
   );
-  function createOrUpdateRootFromMessage(message) {
-    if (message.items.length === 0) {
-      throw new Error("Internal error: cannot load storage without items");
-    }
+  function createOrUpdateRootFromMessage(nodes) {
     if (context.root !== void 0) {
-      updateRoot(message.items);
+      updateRoot(new Map(nodes));
     } else {
-      context.root = LiveObject._fromItems(message.items, context.pool);
+      context.root = LiveObject._fromItems(nodes, context.pool);
     }
     const canWrite = self.get()?.canWrite ?? true;
     const stackSizeBefore = context.undoStack.length;
@@ -9100,7 +9162,10 @@ function createRoom(options, config) {
     }
     context.undoStack.length = stackSizeBefore;
   }
-  function updateRoot(items) {
+  function updateRoot(nodes) {
+    if (nodes.size === 0) {
+      throw new Error("Internal error: cannot load storage without items");
+    }
     if (context.root === void 0) {
       return;
     }
@@ -9108,7 +9173,7 @@ function createRoom(options, config) {
     for (const [id, node] of context.pool.nodes) {
       currentItems.set(id, node._serialize());
     }
-    const ops = getTreesDiffOperations(currentItems, new Map(items));
+    const ops = getTreesDiffOperations(currentItems, nodes);
     const result = applyOps(
       ops,
       /* isLocal */
@@ -9475,8 +9540,11 @@ function createRoom(options, config) {
           updates.others.push(onRoomStateMessage(message));
           break;
         }
-        case ServerMsgCode.STORAGE_STATE: {
-          processInitialStorage(message);
+        case ServerMsgCode.STORAGE_CHUNK: {
+          partialNodes.append(compactNodesToNodeStream(message.nodes));
+          if (message.done) {
+            processInitialStorage(partialNodes.clear());
+          }
           break;
         }
         case ServerMsgCode.UPDATE_STORAGE: {
@@ -9521,6 +9589,8 @@ function createRoom(options, config) {
           eventHub.comments.notify(message);
           break;
         }
+        case ServerMsgCode.STORAGE_STATE_V7:
+        // No longer used in V8
         default:
           break;
       }
@@ -9622,9 +9692,9 @@ function createRoom(options, config) {
   }
   let _getStorage$ = null;
   let _resolveStoragePromise = null;
-  function processInitialStorage(message) {
+  function processInitialStorage(nodes) {
     const unacknowledgedOps = new Map(context.unacknowledgedOps);
-    createOrUpdateRootFromMessage(message);
+    createOrUpdateRootFromMessage(nodes);
     applyAndSendOps(unacknowledgedOps);
     _resolveStoragePromise?.();
     notifyStorageStatus();
@@ -9632,8 +9702,8 @@ function createRoom(options, config) {
   }
   async function streamStorage() {
     if (!managedSocket.authValue) return;
-    const items = await httpClient.streamStorage({ roomId });
-    processInitialStorage({ type: ServerMsgCode.STORAGE_STATE, items });
+    const nodes = new Map(await httpClient.streamStorage({ roomId }));
+    processInitialStorage(nodes);
   }
   function refreshStorage(options2) {
     const messages = context.buffer.messages;
@@ -9641,6 +9711,7 @@ function createRoom(options, config) {
       void streamStorage();
     } else if (!messages.some((msg) => msg.type === ClientMsgCode.FETCH_STORAGE)) {
       messages.push({ type: ClientMsgCode.FETCH_STORAGE });
+      partialNodes.clear();
     }
     if (options2.flush) {
       flushNowOrSoon();
@@ -10230,7 +10301,7 @@ function makeCreateSocketDelegateForRoom(roomId, baseUrl, WebSocketPolyfill, eng
     }
     const url2 = new URL(baseUrl);
     url2.protocol = url2.protocol === "http:" ? "ws" : "wss";
-    url2.pathname = "/v7";
+    url2.pathname = "/v8";
     url2.searchParams.set("roomId", roomId);
     if (authValue.type === "secret") {
       url2.searchParams.set("tok", authValue.token.raw);
@@ -11529,6 +11600,7 @@ export {
   memoizeOnSuccess,
   nanoid,
   nn,
+  nodeStreamToCompactNodes,
   objectToQuery,
   patchLiveObjectKey,
   patchNotificationSettings,