@liveblocks/client 0.16.8 → 0.16.11

package/index.d.ts

@@ -28,4 +28,16 @@ export { B as BroadcastOptions, a as Client, H as History, J as Json, d as JsonO
  */
 declare function createClient(options: ClientOptions): Client;
 
-export { createClient };
+/**
+ * Helper type to help users adopt to Lson types from interface definitions.
+ * You should only use this to wrap interfaces you don't control. For more
+ * information, see
+ * https://liveblocks.io/docs/guides/limits#lson-constraint-and-interfaces
+ */
+declare type EnsureJson<T> = [
+    unknown
+] extends [T] ? T : T extends (...args: any[]) => any ? T : {
+    [K in keyof T]: EnsureJson<T[K]>;
+};
+
+export { EnsureJson, createClient };

package/index.js

@@ -78,10 +78,10 @@ function makeStateMachine(state, context, mockedEffects) {
    })), notify(apply(LiveObject.getTreesDiffOperations(currentItems, new Map(items)), !1).updates);
   }(message.items) : state.root = (items = message.items, _buildRootAndParentTo = function(items) {
    for (var _step2, parentToChildren = new Map, root = null, _iterator2 = LiveObject._createForOfIteratorHelperLoose(items); !(_step2 = _iterator2()).done; ) {
-    var tuple = _step2.value, parentId = tuple[1].parentId;
-    if (null == parentId) root = tuple; else {
-     var children = parentToChildren.get(parentId);
-     null != children ? children.push(tuple) : parentToChildren.set(parentId, [ tuple ]);
+    var _step2$value = _step2.value, id = _step2$value[0], crdt = _step2$value[1];
+    if (LiveObject.isRootCrdt(crdt)) root = [ id, crdt ]; else {
+     var tuple = [ id, crdt ], children = parentToChildren.get(crdt.parentId);
+     null != children ? children.push(tuple) : parentToChildren.set(crdt.parentId, [ tuple ]);
     }
    }
    if (null == root) throw new Error("Root can't be null");
@@ -170,7 +170,7 @@ function makeStateMachine(state, context, mockedEffects) {
      var _applyOpResult$modifi, _result$reverse, parentId = null == (_applyOpResult$modifi = applyOpResult.modified.node._parent) ? void 0 : _applyOpResult$modifi._id;
      if (!createdNodeIds.has(parentId)) result.updates.storageUpdates.set(applyOpResult.modified.node._id, LiveObject.mergeStorageUpdates(result.updates.storageUpdates.get(applyOpResult.modified.node._id), applyOpResult.modified)), 
      (_result$reverse = result.reverse).unshift.apply(_result$reverse, applyOpResult.reverse);
-     op.type !== LiveObject.OpType.CreateList && op.type !== LiveObject.OpType.CreateMap && op.type !== LiveObject.OpType.CreateObject || createdNodeIds.add(applyOpResult.modified.node._id);
+     op.type !== LiveObject.OpCode.CREATE_LIST && op.type !== LiveObject.OpCode.CREATE_MAP && op.type !== LiveObject.OpCode.CREATE_OBJECT || createdNodeIds.add(applyOpResult.modified.node._id);
     }
    }
   }
@@ -178,15 +178,15 @@ function makeStateMachine(state, context, mockedEffects) {
  }
  function applyOp(op, isLocal) {
   switch (op.opId && state.offlineOperations.delete(op.opId), op.type) {
-  case LiveObject.OpType.DeleteObjectKey:
-  case LiveObject.OpType.UpdateObject:
-  case LiveObject.OpType.DeleteCrdt:
+  case LiveObject.OpCode.DELETE_OBJECT_KEY:
+  case LiveObject.OpCode.UPDATE_OBJECT:
+  case LiveObject.OpCode.DELETE_CRDT:
    var item = state.items.get(op.id);
    return null == item ? {
     modified: !1
    } : item._apply(op, isLocal);
 
-  case LiveObject.OpType.SetParentKey:
+  case LiveObject.OpCode.SET_PARENT_KEY:
    var _item = state.items.get(op.id);
    if (null == _item) return {
     modified: !1
@@ -201,10 +201,10 @@ function makeStateMachine(state, context, mockedEffects) {
     modified: !1
    };
 
-  case LiveObject.OpType.CreateObject:
-  case LiveObject.OpType.CreateList:
-  case LiveObject.OpType.CreateMap:
-  case LiveObject.OpType.CreateRegister:
+  case LiveObject.OpCode.CREATE_OBJECT:
+  case LiveObject.OpCode.CREATE_LIST:
+  case LiveObject.OpCode.CREATE_MAP:
+  case LiveObject.OpCode.CREATE_REGISTER:
    var parent = state.items.get(op.parentId);
    return null == parent ? {
     modified: !1
@@ -311,7 +311,7 @@ function makeStateMachine(state, context, mockedEffects) {
    id: message.id,
    _hasReceivedInitialPresence: !0
   }, state.me && (state.buffer.messages.push({
-   type: LiveObject.ClientMessageType.UpdatePresence,
+   type: LiveObject.ClientMsgCode.UPDATE_PRESENCE,
    data: state.me,
    targetActor: message.actor
   }), tryFlushing()), {
@@ -334,34 +334,34 @@ function makeStateMachine(state, context, mockedEffects) {
     }, _iterator9 = LiveObject._createForOfIteratorHelperLoose(messages); !(_step9 = _iterator9()).done; ) {
      var message = _step9.value;
      switch (message.type) {
-     case LiveObject.ServerMessageType.UserJoined:
+     case LiveObject.ServerMsgCode.USER_JOINED:
       updates.others.push(onUserJoinedMessage(message));
       break;
 
-     case LiveObject.ServerMessageType.UpdatePresence:
+     case LiveObject.ServerMsgCode.UPDATE_PRESENCE:
       var othersPresenceUpdate = onUpdatePresenceMessage(message);
       othersPresenceUpdate && updates.others.push(othersPresenceUpdate);
       break;
 
-     case LiveObject.ServerMessageType.Event:
+     case LiveObject.ServerMsgCode.BROADCASTED_EVENT:
       onEvent(message);
       break;
 
-     case LiveObject.ServerMessageType.UserLeft:
+     case LiveObject.ServerMsgCode.USER_LEFT:
       var _event2 = onUserLeftMessage(message);
       _event2 && updates.others.push(_event2);
       break;
 
-     case LiveObject.ServerMessageType.RoomState:
+     case LiveObject.ServerMsgCode.ROOM_STATE:
       updates.others.push(onRoomStateMessage(message));
       break;
 
-     case LiveObject.ServerMessageType.InitialStorageState:
+     case LiveObject.ServerMsgCode.INITIAL_STORAGE_STATE:
       var offlineOps = new Map(state.offlineOperations);
       createOrUpdateRootFromMessage(message), applyAndSendOfflineOps(offlineOps), null == _getInitialStateResolver || _getInitialStateResolver();
       break;
 
-     case LiveObject.ServerMessageType.UpdateStorage:
+     case LiveObject.ServerMsgCode.UPDATE_STORAGE:
       apply(message.ops, !1).updates.storageUpdates.forEach((function(value, key) {
        updates.storageUpdates.set(key, LiveObject.mergeStorageUpdates(updates.storageUpdates.get(key), value));
       }));
@@ -416,7 +416,7 @@ function makeStateMachine(state, context, mockedEffects) {
    state: "open"
   })), state.numberOfRetry = 0, void 0 !== state.lastConnectionId && (state.buffer.presence = state.me, 
   tryFlushing()), state.lastConnectionId = state.connection.id, state.root && state.buffer.messages.push({
-   type: LiveObject.ClientMessageType.FetchStorage
+   type: LiveObject.ClientMsgCode.FETCH_STORAGE
   }), tryFlushing());
  }
  function heartbeat() {
@@ -439,7 +439,7 @@ function makeStateMachine(state, context, mockedEffects) {
   if (0 !== offlineOps.size) {
    var messages = [], ops = Array.from(offlineOps.values()), result = apply(ops, !0);
    messages.push({
-    type: LiveObject.ClientMessageType.UpdateStorage,
+    type: LiveObject.ClientMsgCode.UPDATE_STORAGE,
     ops: ops
    }), notify(result.updates), effects.send(messages);
   }
@@ -454,7 +454,7 @@ function makeStateMachine(state, context, mockedEffects) {
     var _messages = function(state) {
      var messages = [];
      state.buffer.presence && messages.push({
-      type: LiveObject.ClientMessageType.UpdatePresence,
+      type: LiveObject.ClientMsgCode.UPDATE_PRESENCE,
       data: state.buffer.presence
      });
      for (var _step12, _iterator12 = LiveObject._createForOfIteratorHelperLoose(state.buffer.messages); !(_step12 = _iterator12()).done; ) {
@@ -462,7 +462,7 @@ function makeStateMachine(state, context, mockedEffects) {
       messages.push(_event3);
      }
      state.buffer.storageOperations.length > 0 && messages.push({
-      type: LiveObject.ClientMessageType.UpdateStorage,
+      type: LiveObject.ClientMsgCode.UPDATE_STORAGE,
       ops: state.buffer.storageOperations
      });
      return messages;
@@ -566,7 +566,7 @@ function makeStateMachine(state, context, mockedEffects) {
    void 0 === options && (options = {
     shouldQueueEventIfNotReady: !1
    }), null == state.socket && 0 == options.shouldQueueEventIfNotReady || (state.buffer.messages.push({
-    type: LiveObject.ClientMessageType.ClientEvent,
+    type: LiveObject.ClientMsgCode.BROADCAST_EVENT,
     event: event
    }), tryFlushing());
   },
@@ -630,7 +630,7 @@ function makeStateMachine(state, context, mockedEffects) {
      root: state.root
     });
    })) : (null == _getInitialStatePromise && (state.buffer.messages.push({
-    type: LiveObject.ClientMessageType.FetchStorage
+    type: LiveObject.ClientMsgCode.FETCH_STORAGE
    }), tryFlushing(), _getInitialStatePromise = new Promise((function(resolve) {
     return _getInitialStateResolver = resolve;
    }))), _getInitialStatePromise.then((function() {

package/index.mjs

@@ -1,6 +1,6 @@
-import { A as AbstractCrdt, r as remove, S as ServerMessageType, m as mergeStorageUpdates, W as WebsocketCloseCodes, C as ClientMessageType, i as isTokenValid, a as isSameNodeOrChildOf, L as LiveObject, g as getTreesDiffOperations, O as OpType, b as LiveList, p as parseJson, c as isJsonArray, d as compact, e as isJsonObject, f as deprecateIf } from "./shared.mjs";
+import { A as AbstractCrdt, r as remove, S as ServerMsgCode, m as mergeStorageUpdates, W as WebsocketCloseCodes, C as ClientMsgCode, i as isTokenValid, a as isSameNodeOrChildOf, L as LiveObject, g as getTreesDiffOperations, O as OpCode, b as LiveList, p as parseJson, c as isJsonArray, d as compact, e as isJsonObject, f as isRootCrdt, h as deprecateIf } from "./shared.mjs";
 
-export { b as LiveList, h as LiveMap, L as LiveObject } from "./shared.mjs";
+export { b as LiveList, j as LiveMap, L as LiveObject } from "./shared.mjs";
 
 const BACKOFF_RETRY_DELAYS = [ 250, 500, 1e3, 2e3, 4e3, 8e3, 1e4 ], BACKOFF_RETRY_DELAYS_SLOW = [ 2e3, 3e4, 6e4, 3e5 ];
 
@@ -69,12 +69,9 @@ function makeStateMachine(state, context, mockedEffects) {
    const [root, parentToChildren] = function(items) {
     const parentToChildren = new Map;
     let root = null;
-    for (const tuple of items) {
-     const parentId = tuple[1].parentId;
-     if (null == parentId) root = tuple; else {
-      const children = parentToChildren.get(parentId);
-      null != children ? children.push(tuple) : parentToChildren.set(parentId, [ tuple ]);
-     }
+    for (const [id, crdt] of items) if (isRootCrdt(crdt)) root = [ id, crdt ]; else {
+     const tuple = [ id, crdt ], children = parentToChildren.get(crdt.parentId);
+     null != children ? children.push(tuple) : parentToChildren.set(crdt.parentId, [ tuple ]);
     }
     if (null == root) throw new Error("Root can't be null");
     return [ root, parentToChildren ];
@@ -153,16 +150,16 @@ function makeStateMachine(state, context, mockedEffects) {
    if (applyOpResult.modified) {
     const parentId = null === (_a = applyOpResult.modified.node._parent) || void 0 === _a ? void 0 : _a._id;
     createdNodeIds.has(parentId) || (result.updates.storageUpdates.set(applyOpResult.modified.node._id, mergeStorageUpdates(result.updates.storageUpdates.get(applyOpResult.modified.node._id), applyOpResult.modified)), 
-    result.reverse.unshift(...applyOpResult.reverse)), op.type !== OpType.CreateList && op.type !== OpType.CreateMap && op.type !== OpType.CreateObject || createdNodeIds.add(applyOpResult.modified.node._id);
+    result.reverse.unshift(...applyOpResult.reverse)), op.type !== OpCode.CREATE_LIST && op.type !== OpCode.CREATE_MAP && op.type !== OpCode.CREATE_OBJECT || createdNodeIds.add(applyOpResult.modified.node._id);
    }
   }
   return result;
  }
  function applyOp(op, isLocal) {
   switch (op.opId && state.offlineOperations.delete(op.opId), op.type) {
-  case OpType.DeleteObjectKey:
-  case OpType.UpdateObject:
-  case OpType.DeleteCrdt:
+  case OpCode.DELETE_OBJECT_KEY:
+  case OpCode.UPDATE_OBJECT:
+  case OpCode.DELETE_CRDT:
    {
     const item = state.items.get(op.id);
     return null == item ? {
@@ -170,7 +167,7 @@ function makeStateMachine(state, context, mockedEffects) {
     } : item._apply(op, isLocal);
    }
 
-  case OpType.SetParentKey:
+  case OpCode.SET_PARENT_KEY:
    {
     const item = state.items.get(op.id);
     if (null == item) return {
@@ -187,10 +184,10 @@ function makeStateMachine(state, context, mockedEffects) {
     };
    }
 
-  case OpType.CreateObject:
-  case OpType.CreateList:
-  case OpType.CreateMap:
-  case OpType.CreateRegister:
+  case OpCode.CREATE_OBJECT:
+  case OpCode.CREATE_LIST:
+  case OpCode.CREATE_MAP:
+  case OpCode.CREATE_REGISTER:
    {
     const parent = state.items.get(op.parentId);
     return null == parent ? {
@@ -291,7 +288,7 @@ function makeStateMachine(state, context, mockedEffects) {
    id: message.id,
    _hasReceivedInitialPresence: !0
   }, state.me && (state.buffer.messages.push({
-   type: ClientMessageType.UpdatePresence,
+   type: ClientMsgCode.UPDATE_PRESENCE,
    data: state.me,
    targetActor: message.actor
   }), tryFlushing()), {
@@ -314,40 +311,40 @@ function makeStateMachine(state, context, mockedEffects) {
    others: []
   };
   for (const message of messages) switch (message.type) {
-  case ServerMessageType.UserJoined:
+  case ServerMsgCode.USER_JOINED:
    updates.others.push(onUserJoinedMessage(message));
    break;
 
-  case ServerMessageType.UpdatePresence:
+  case ServerMsgCode.UPDATE_PRESENCE:
    {
     const othersPresenceUpdate = onUpdatePresenceMessage(message);
     othersPresenceUpdate && updates.others.push(othersPresenceUpdate);
     break;
    }
 
-  case ServerMessageType.Event:
+  case ServerMsgCode.BROADCASTED_EVENT:
    onEvent(message);
    break;
 
-  case ServerMessageType.UserLeft:
+  case ServerMsgCode.USER_LEFT:
    {
     const event = onUserLeftMessage(message);
     event && updates.others.push(event);
     break;
    }
 
-  case ServerMessageType.RoomState:
+  case ServerMsgCode.ROOM_STATE:
    updates.others.push(onRoomStateMessage(message));
    break;
 
-  case ServerMessageType.InitialStorageState:
+  case ServerMsgCode.INITIAL_STORAGE_STATE:
    {
     const offlineOps = new Map(state.offlineOperations);
     createOrUpdateRootFromMessage(message), applyAndSendOfflineOps(offlineOps), null == _getInitialStateResolver || _getInitialStateResolver();
     break;
    }
 
-  case ServerMessageType.UpdateStorage:
+  case ServerMsgCode.UPDATE_STORAGE:
    apply(message.ops, !1).updates.storageUpdates.forEach(((value, key) => {
     updates.storageUpdates.set(key, mergeStorageUpdates(updates.storageUpdates.get(key), value));
    }));
@@ -397,7 +394,7 @@ function makeStateMachine(state, context, mockedEffects) {
    state: "open"
   })), state.numberOfRetry = 0, void 0 !== state.lastConnectionId && (state.buffer.presence = state.me, 
   tryFlushing()), state.lastConnectionId = state.connection.id, state.root && state.buffer.messages.push({
-   type: ClientMessageType.FetchStorage
+   type: ClientMsgCode.FETCH_STORAGE
   }), tryFlushing());
  }
  function heartbeat() {
@@ -420,7 +417,7 @@ function makeStateMachine(state, context, mockedEffects) {
   if (0 === offlineOps.size) return;
   const messages = [], ops = Array.from(offlineOps.values()), result = apply(ops, !0);
   messages.push({
-   type: ClientMessageType.UpdateStorage,
+   type: ClientMsgCode.UPDATE_STORAGE,
    ops: ops
   }), notify(result.updates), effects.send(messages);
  }
@@ -434,12 +431,12 @@ function makeStateMachine(state, context, mockedEffects) {
    const messages = function(state) {
     const messages = [];
     state.buffer.presence && messages.push({
-     type: ClientMessageType.UpdatePresence,
+     type: ClientMsgCode.UPDATE_PRESENCE,
      data: state.buffer.presence
     });
     for (const event of state.buffer.messages) messages.push(event);
     state.buffer.storageOperations.length > 0 && messages.push({
-     type: ClientMessageType.UpdateStorage,
+     type: ClientMsgCode.UPDATE_STORAGE,
      ops: state.buffer.storageOperations
     });
     return messages;
@@ -534,7 +531,7 @@ function makeStateMachine(state, context, mockedEffects) {
    shouldQueueEventIfNotReady: !1
   }) {
    null == state.socket && 0 == options.shouldQueueEventIfNotReady || (state.buffer.messages.push({
-    type: ClientMessageType.ClientEvent,
+    type: ClientMsgCode.BROADCAST_EVENT,
     event: event
    }), tryFlushing());
   },
@@ -588,7 +585,7 @@ function makeStateMachine(state, context, mockedEffects) {
    return state.root ? new Promise((resolve => resolve({
     root: state.root
    }))) : (null == _getInitialStatePromise && (state.buffer.messages.push({
-    type: ClientMessageType.FetchStorage
+    type: ClientMsgCode.FETCH_STORAGE
    }), tryFlushing(), _getInitialStatePromise = new Promise((resolve => _getInitialStateResolver = resolve))), 
    _getInitialStatePromise.then((() => ({
     root: state.root

package/internal.d.ts

@@ -1,26 +1,38 @@
-import { d as JsonObject, J as Json, e as Lson, A as AbstractCrdt, f as LsonObject, L as LiveObject, S as StorageUpdate } from './shared';
-export { g as Resolve, h as RoomInitializers } from './shared';
+import { d as JsonObject, J as Json, g as Resolve, e as Lson, A as AbstractCrdt, f as LsonObject, L as LiveObject, S as StorageUpdate } from './shared';
+export { g as Resolve, h as RoomInitializers, p as parseJson } from './shared';
 
+declare type IdTuple<T> = [id: string, value: T];
+/**
+ * Lookup table for nodes (= SerializedCrdt values) by their IDs.
+ */
+declare type NodeMap = Map<string, // Node ID
+SerializedCrdt>;
+/**
+ * Reverse lookup table for all child nodes (= list of SerializedCrdt values)
+ * by their parent node's IDs.
+ */
+declare type ParentToChildNodeMap = Map<string, // Parent's node ID
+IdTuple<SerializedChild>[]>;
 /**
  * Messages that can be sent from the server to the client.
  */
-declare type ServerMessage<TPresence extends JsonObject> = UpdatePresenceMessage<TPresence> | UserJoinMessage | UserLeftMessage | EventMessage | RoomStateMessage | InitialDocumentStateMessage | UpdateStorageMessage;
-declare enum ServerMessageType {
-    UpdatePresence = 100,
-    UserJoined = 101,
-    UserLeft = 102,
-    Event = 103,
-    RoomState = 104,
-    InitialStorageState = 200,
-    UpdateStorage = 201
+declare type ServerMsg<TPresence extends JsonObject> = UpdatePresenceServerMsg<TPresence> | UserJoinServerMsg | UserLeftServerMsg | BroadcastedEventServerMsg | RoomStateServerMsg | InitialDocumentStateServerMsg | UpdateStorageServerMsg;
+declare enum ServerMsgCode {
+    UPDATE_PRESENCE = 100,
+    USER_JOINED = 101,
+    USER_LEFT = 102,
+    BROADCASTED_EVENT = 103,
+    ROOM_STATE = 104,
+    INITIAL_STORAGE_STATE = 200,
+    UPDATE_STORAGE = 201
 }
 /**
  * Sent by the WebSocket server to a single client in response to the client
  * joining the Room, to provide the initial state of the Room. The payload
  * includes a list of all other Users that already are in the Room.
  */
-declare type RoomStateMessage = {
-    type: ServerMessageType.RoomState;
+declare type RoomStateServerMsg = {
+    type: ServerMsgCode.ROOM_STATE;
     users: {
         [actor: number]: {
             id?: string;
@@ -39,8 +51,8 @@ declare type RoomStateMessage = {
  * those cases, the `targetActor` field indicates the newly connected client,
  * so all other existing clients can ignore this broadcasted message.
  */
-declare type UpdatePresenceMessage<TPresence extends JsonObject> = {
-    type: ServerMessageType.UpdatePresence;
+declare type UpdatePresenceServerMsg<TPresence extends JsonObject> = {
+    type: ServerMsgCode.UPDATE_PRESENCE;
     /**
      * The User whose Presence has changed.
      */
@@ -62,8 +74,8 @@ declare type UpdatePresenceMessage<TPresence extends JsonObject> = {
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a new User has joined the Room.
  */
-declare type UserJoinMessage = {
-    type: ServerMessageType.UserJoined;
+declare type UserJoinServerMsg = {
+    type: ServerMsgCode.USER_JOINED;
     actor: number;
     /**
      * The id of the User that has been set in the authentication endpoint.
@@ -80,16 +92,16 @@ declare type UserJoinMessage = {
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a new User has left the Room.
  */
-declare type UserLeftMessage = {
-    type: ServerMessageType.UserLeft;
+declare type UserLeftServerMsg = {
+    type: ServerMsgCode.USER_LEFT;
     actor: number;
 };
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a User broadcasted an Event to everyone in the Room.
  */
-declare type EventMessage = {
-    type: ServerMessageType.Event;
+declare type BroadcastedEventServerMsg = {
+    type: ServerMsgCode.BROADCASTED_EVENT;
     /**
      * The User who broadcasted the Event.
      */
@@ -100,15 +112,14 @@ declare type EventMessage = {
      */
     event: Json;
 };
-declare type SerializedCrdtWithId = [id: string, crdt: SerializedCrdt];
 /**
  * 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.
  */
-declare type InitialDocumentStateMessage = {
-    type: ServerMessageType.InitialStorageState;
-    items: SerializedCrdtWithId[];
+declare type InitialDocumentStateServerMsg = {
+    type: ServerMsgCode.INITIAL_STORAGE_STATE;
+    items: IdTuple<SerializedCrdt>[];
 };
 /**
  * Sent by the WebSocket server and broadcasted to all clients to announce that
@@ -117,81 +128,99 @@ declare type InitialDocumentStateMessage = {
  * The payload of this message contains a list of Ops (aka incremental
  * mutations to make to the initially loaded document).
  */
-declare type UpdateStorageMessage = {
-    type: ServerMessageType.UpdateStorage;
+declare type UpdateStorageServerMsg = {
+    type: ServerMsgCode.UPDATE_STORAGE;
     ops: Op[];
 };
-declare enum ClientMessageType {
-    UpdatePresence = 100,
-    ClientEvent = 103,
-    FetchStorage = 200,
-    UpdateStorage = 201
+declare enum ClientMsgCode {
+    UPDATE_PRESENCE = 100,
+    BROADCAST_EVENT = 103,
+    FETCH_STORAGE = 200,
+    UPDATE_STORAGE = 201
 }
+declare type FetchStorageClientMsg = {
+    type: ClientMsgCode.FETCH_STORAGE;
+};
 declare enum CrdtType {
-    Object = 0,
-    List = 1,
-    Map = 2,
-    Register = 3
+    OBJECT = 0,
+    LIST = 1,
+    MAP = 2,
+    REGISTER = 3
 }
+declare type SerializedRootObject = {
+    type: CrdtType.OBJECT;
+    data: JsonObject;
+    parentId?: never;
+    parentKey?: never;
+};
 declare type SerializedObject = {
-    type: CrdtType.Object;
-    parentId?: string;
-    parentKey?: string;
+    type: CrdtType.OBJECT;
+    parentId: string;
+    parentKey: string;
     data: JsonObject;
 };
 declare type SerializedList = {
-    type: CrdtType.List;
+    type: CrdtType.LIST;
     parentId: string;
     parentKey: string;
 };
 declare type SerializedMap = {
-    type: CrdtType.Map;
+    type: CrdtType.MAP;
     parentId: string;
     parentKey: string;
 };
 declare type SerializedRegister = {
-    type: CrdtType.Register;
+    type: CrdtType.REGISTER;
     parentId: string;
     parentKey: string;
     data: Json;
 };
-declare type SerializedCrdt = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
-declare enum OpType {
-    Init = 0,
-    SetParentKey = 1,
-    CreateList = 2,
-    UpdateObject = 3,
-    CreateObject = 4,
-    DeleteCrdt = 5,
-    DeleteObjectKey = 6,
-    CreateMap = 7,
-    CreateRegister = 8
+declare type SerializedCrdt = SerializedRootObject | SerializedChild;
+declare type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
+declare function isRootCrdt(crdt: SerializedCrdt): crdt is SerializedRootObject;
+declare function isChildCrdt(crdt: SerializedCrdt): crdt is SerializedChild;
+declare enum OpCode {
+    INIT = 0,
+    SET_PARENT_KEY = 1,
+    CREATE_LIST = 2,
+    UPDATE_OBJECT = 3,
+    CREATE_OBJECT = 4,
+    DELETE_CRDT = 5,
+    DELETE_OBJECT_KEY = 6,
+    CREATE_MAP = 7,
+    CREATE_REGISTER = 8
 }
 /**
- * These operations are the payload for {@link UpdateStorageMessage} messages
+ * These operations are the payload for {@link UpdateStorageServerMsg} messages
  * only.
  */
-declare type Op = CreateObjectOp | UpdateObjectOp | DeleteCrdtOp | CreateListOp | SetParentKeyOp | DeleteObjectKeyOp | CreateMapOp | CreateRegisterOp;
+declare type Op = CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp;
+declare type CreateOp = CreateRootObjectOp | CreateChildOp;
+declare type CreateChildOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp;
 declare type UpdateObjectOp = {
     opId?: string;
     id: string;
-    type: OpType.UpdateObject;
+    type: OpCode.UPDATE_OBJECT;
     data: Partial<JsonObject>;
 };
 declare type CreateObjectOp = {
     opId?: string;
     id: string;
     intent?: "set";
-    type: OpType.CreateObject;
-    parentId?: string;
-    parentKey?: string;
+    type: OpCode.CREATE_OBJECT;
+    parentId: string;
+    parentKey: string;
     data: JsonObject;
 };
+declare type CreateRootObjectOp = Resolve<Omit<CreateObjectOp, "parentId" | "parentKey"> & {
+    parentId?: never;
+    parentKey?: never;
+}>;
 declare type CreateListOp = {
     opId?: string;
     id: string;
     intent?: "set";
-    type: OpType.CreateList;
+    type: OpCode.CREATE_LIST;
     parentId: string;
     parentKey: string;
 };
@@ -199,7 +228,7 @@ declare type CreateMapOp = {
     opId?: string;
     id: string;
     intent?: "set";
-    type: OpType.CreateMap;
+    type: OpCode.CREATE_MAP;
     parentId: string;
     parentKey: string;
 };
@@ -207,7 +236,7 @@ declare type CreateRegisterOp = {
     opId?: string;
     id: string;
     intent?: "set";
-    type: OpType.CreateRegister;
+    type: OpCode.CREATE_REGISTER;
     parentId: string;
     parentKey: string;
     data: Json;
@@ -215,18 +244,18 @@ declare type CreateRegisterOp = {
 declare type DeleteCrdtOp = {
     opId?: string;
     id: string;
-    type: OpType.DeleteCrdt;
+    type: OpCode.DELETE_CRDT;
 };
 declare type SetParentKeyOp = {
     opId?: string;
     id: string;
-    type: OpType.SetParentKey;
+    type: OpCode.SET_PARENT_KEY;
     parentKey: string;
 };
 declare type DeleteObjectKeyOp = {
     opId?: string;
     id: string;
-    type: OpType.DeleteObjectKey;
+    type: OpCode.DELETE_OBJECT_KEY;
     key: string;
 };
 declare enum WebsocketCloseCodes {
@@ -278,4 +307,25 @@ declare function patchImmutableObject<T>(state: T, updates: StorageUpdate[]): T;
 declare function makePosition(before?: string, after?: string): string;
 declare function comparePosition(posA: string, posB: string): number;
 
-export { ClientMessageType, CrdtType, CreateListOp, CreateMapOp, CreateObjectOp, CreateRegisterOp, DeleteCrdtOp, DeleteObjectKeyOp, Op, OpType, RoomStateMessage, SerializedCrdt, SerializedCrdtWithId, SerializedList, SerializedMap, SerializedObject, SerializedRegister, ServerMessage, ServerMessageType, SetParentKeyOp, UpdateObjectOp, UserJoinMessage, WebsocketCloseCodes, comparePosition, deprecate, deprecateIf, errorIf, lsonToJson, makePosition, patchImmutableObject, patchLiveObjectKey, throwUsageError };
+/**
+ * Helper function that can be used to implement exhaustive switch statements
+ * with TypeScript. Example usage:
+ *
+ *    type Fruit = "🍎" | "🍌";
+ *
+ *    switch (fruit) {
+ *      case "🍎":
+ *      case "🍌":
+ *        return doSomething();
+ *
+ *      default:
+ *        return assertNever(fruit, "Unknown fruit");
+ *    }
+ *
+ * If now the Fruit union is extended (i.e. add "🍒"), TypeScript will catch
+ * this *statically*, rather than at runtime, and force you to handle the
+ * 🍒 case.
+ */
+declare function assertNever(_value: never, errmsg: string): never;
+
+export { ClientMsgCode, CrdtType, CreateChildOp, CreateListOp, CreateMapOp, CreateObjectOp, CreateRegisterOp, CreateRootObjectOp, DeleteCrdtOp, DeleteObjectKeyOp, FetchStorageClientMsg, IdTuple, InitialDocumentStateServerMsg, NodeMap, Op, OpCode, ParentToChildNodeMap, RoomStateServerMsg, SerializedChild, SerializedCrdt, SerializedList, SerializedMap, SerializedObject, SerializedRegister, SerializedRootObject, ServerMsg, ServerMsgCode, SetParentKeyOp, UpdateObjectOp, UserJoinServerMsg, WebsocketCloseCodes, assertNever, comparePosition, deprecate, deprecateIf, errorIf, isChildCrdt, isRootCrdt, lsonToJson, makePosition, patchImmutableObject, patchLiveObjectKey, throwUsageError };