@liveblocks/client 0.16.15 → 0.17.0-test1

package/shared.d.ts

@@ -1,3 +1,251 @@
+declare type ApplyResult =
+  | {
+      reverse: Op[];
+      modified: StorageUpdate;
+    }
+  | {
+      modified: false;
+    };
+interface Doc {
+  roomId: string;
+  generateId: () => string;
+  generateOpId: () => string;
+  getItem: (id: string) => LiveNode | undefined;
+  addItem: (id: string, liveItem: LiveNode) => void;
+  deleteItem: (id: string) => void;
+  /**
+   * Dispatching has three responsibilities:
+   * - Sends serialized ops to the WebSocket servers
+   * - Add reverse operations to the undo/redo stack
+   * - Notify room subscribers with updates (in-client, no networking)
+   */
+  dispatch: (
+    ops: Op[],
+    reverseOps: Op[],
+    storageUpdates: Map<string, StorageUpdate>
+  ) => void;
+}
+declare abstract class AbstractCrdt {
+  private __doc?;
+  private __id?;
+  private _parent;
+  get roomId(): string | null;
+}
+
+/**
+ * The LiveList class represents an ordered collection of items that is synchronized across clients.
+ */
+declare class LiveList<TItem extends Lson> extends AbstractCrdt {
+  private _items;
+  private _implicitlyDeletedItems;
+  private _unacknowledgedSets;
+  constructor(items?: TItem[]);
+  /**
+   * Returns the number of elements.
+   */
+  get length(): number;
+  /**
+   * Adds one element to the end of the LiveList.
+   * @param element The element to add to the end of the LiveList.
+   */
+  push(element: TItem): void;
+  /**
+   * Inserts one element at a specified index.
+   * @param element The element to insert.
+   * @param index The index at which you want to insert the element.
+   */
+  insert(element: TItem, index: number): void;
+  /**
+   * Move one element from one index to another.
+   * @param index The index of the element to move
+   * @param targetIndex The index where the element should be after moving.
+   */
+  move(index: number, targetIndex: number): void;
+  /**
+   * Deletes an element at the specified index
+   * @param index The index of the element to delete
+   */
+  delete(index: number): void;
+  clear(): void;
+  set(index: number, item: TItem): void;
+  /**
+   * Returns an Array of all the elements in the LiveList.
+   */
+  toArray(): TItem[];
+  /**
+   * Tests whether all elements pass the test implemented by the provided function.
+   * @param predicate Function to test for each element, taking two arguments (the element and its index).
+   * @returns true if the predicate function returns a truthy value for every element. Otherwise, false.
+   */
+  every(predicate: (value: TItem, index: number) => unknown): boolean;
+  /**
+   * Creates an array with all elements that pass the test implemented by the provided function.
+   * @param predicate Function to test each element of the LiveList. Return a value that coerces to true to keep the element, or to false otherwise.
+   * @returns An array with the elements that pass the test.
+   */
+  filter(predicate: (value: TItem, index: number) => unknown): TItem[];
+  /**
+   * Returns the first element that satisfies the provided testing function.
+   * @param predicate Function to execute on each value.
+   * @returns The value of the first element in the LiveList that satisfies the provided testing function. Otherwise, undefined is returned.
+   */
+  find(predicate: (value: TItem, index: number) => unknown): TItem | undefined;
+  /**
+   * Returns the index of the first element in the LiveList that satisfies the provided testing function.
+   * @param predicate Function to execute on each value until the function returns true, indicating that the satisfying element was found.
+   * @returns The index of the first element in the LiveList that passes the test. Otherwise, -1.
+   */
+  findIndex(predicate: (value: TItem, index: number) => unknown): number;
+  /**
+   * Executes a provided function once for each element.
+   * @param callbackfn Function to execute on each element.
+   */
+  forEach(callbackfn: (value: TItem, index: number) => void): void;
+  /**
+   * Get the element at the specified index.
+   * @param index The index on the element to get.
+   * @returns The element at the specified index or undefined.
+   */
+  get(index: number): TItem | undefined;
+  /**
+   * Returns the first index at which a given element can be found in the LiveList, or -1 if it is not present.
+   * @param searchElement Element to locate.
+   * @param fromIndex The index to start the search at.
+   * @returns The first index of the element in the LiveList; -1 if not found.
+   */
+  indexOf(searchElement: TItem, fromIndex?: number): number;
+  /**
+   * Returns the last index at which a given element can be found in the LiveList, or -1 if it is not present. The LiveLsit is searched backwards, starting at fromIndex.
+   * @param searchElement Element to locate.
+   * @param fromIndex The index at which to start searching backwards.
+   * @returns
+   */
+  lastIndexOf(searchElement: TItem, fromIndex?: number): number;
+  /**
+   * Creates an array populated with the results of calling a provided function on every element.
+   * @param callback Function that is called for every element.
+   * @returns An array with each element being the result of the callback function.
+   */
+  map<U>(callback: (value: TItem, index: number) => U): U[];
+  /**
+   * Tests whether at least one element in the LiveList passes the test implemented by the provided function.
+   * @param predicate Function to test for each element.
+   * @returns true if the callback function returns a truthy value for at least one element. Otherwise, false.
+   */
+  some(predicate: (value: TItem, index: number) => unknown): boolean;
+  [Symbol.iterator](): IterableIterator<TItem>;
+}
+
+/**
+ * The LiveMap class is similar to a JavaScript Map that is synchronized on all clients.
+ * Keys should be a string, and values should be serializable to JSON.
+ * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
+ */
+declare class LiveMap<
+  TKey extends string,
+  TValue extends Lson
+> extends AbstractCrdt {
+  private _map;
+  constructor(entries?: readonly (readonly [TKey, TValue])[] | undefined);
+  /**
+   * @deprecated Please call as `new LiveMap()` or `new LiveMap([])` instead.
+   */
+  constructor(entries: null);
+  /**
+   * Returns a specified element from the LiveMap.
+   * @param key The key of the element to return.
+   * @returns The element associated with the specified key, or undefined if the key can't be found in the LiveMap.
+   */
+  get(key: TKey): TValue | undefined;
+  /**
+   * Adds or updates an element with a specified key and a value.
+   * @param key The key of the element to add. Should be a string.
+   * @param value The value of the element to add. Should be serializable to JSON.
+   */
+  set(key: TKey, value: TValue): void;
+  /**
+   * Returns the number of elements in the LiveMap.
+   */
+  get size(): number;
+  /**
+   * Returns a boolean indicating whether an element with the specified key exists or not.
+   * @param key The key of the element to test for presence.
+   */
+  has(key: TKey): boolean;
+  /**
+   * Removes the specified element by key.
+   * @param key The key of the element to remove.
+   * @returns true if an element existed and has been removed, or false if the element does not exist.
+   */
+  delete(key: TKey): boolean;
+  /**
+   * Returns a new Iterator object that contains the [key, value] pairs for each element.
+   */
+  entries(): IterableIterator<[TKey, TValue]>;
+  /**
+   * Same function object as the initial value of the entries method.
+   */
+  [Symbol.iterator](): IterableIterator<[TKey, TValue]>;
+  /**
+   * Returns a new Iterator object that contains the keys for each element.
+   */
+  keys(): IterableIterator<TKey>;
+  /**
+   * Returns a new Iterator object that contains the values for each element.
+   */
+  values(): IterableIterator<TValue>;
+  /**
+   * Executes a provided function once per each key/value pair in the Map object, in insertion order.
+   * @param callback Function to execute for each entry in the map.
+   */
+  forEach(
+    callback: (value: TValue, key: TKey, map: LiveMap<TKey, TValue>) => void
+  ): void;
+}
+
+/**
+ * The LiveObject class is similar to a JavaScript object that is synchronized on all clients.
+ * Keys should be a string, and values should be serializable to JSON.
+ * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
+ */
+declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
+  private _map;
+  private _propToLastUpdate;
+  constructor(obj?: O);
+  _serialize(
+    parentId?: undefined,
+    parentKey?: undefined,
+    doc?: Doc
+  ): CreateOp[];
+  private _applyUpdate;
+  private _applyDeleteObjectKey;
+  /**
+   * Transform the LiveObject into a javascript object
+   */
+  toObject(): O;
+  /**
+   * Adds or updates a property with a specified key and a value.
+   * @param key The key of the property to add
+   * @param value The value of the property to add
+   */
+  set<TKey extends keyof O>(key: TKey, value: O[TKey]): void;
+  /**
+   * Returns a specified property from the LiveObject.
+   * @param key The key of the property to get
+   */
+  get<TKey extends keyof O>(key: TKey): O[TKey];
+  /**
+   * Deletes a key from the LiveObject
+   * @param key The key of the property to delete
+   */
+  delete(key: keyof O): void;
+  /**
+   * Adds or updates multiple properties at once with an object.
+   * @param overrides The object used to overrides properties
+   */
+  update(overrides: Partial<O>): void;
+}
+
 /**
  * Represents an indefinitely deep arbitrary JSON data structure. There are
  * four types that make up the Json family:
@@ -12,188 +260,223 @@ declare type Json = JsonScalar | JsonArray | JsonObject;
 declare type JsonScalar = string | number | boolean | null;
 declare type JsonArray = Json[];
 declare type JsonObject = {
-    [key: string]: Json | undefined;
+  [key: string]: Json | undefined;
 };
 declare function isJsonScalar(data: Json): data is JsonScalar;
 declare function isJsonArray(data: Json): data is JsonArray;
 declare function isJsonObject(data: Json): data is JsonObject;
 
 /**
- * The LiveMap class is similar to a JavaScript Map that is synchronized on all clients.
- * Keys should be a string, and values should be serializable to JSON.
- * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
+ * INTERNAL
  */
-declare class LiveMap<TKey extends string = string, TValue extends Lson = Lson> extends AbstractCrdt {
-    private _map;
-    constructor(entries?: readonly (readonly [TKey, TValue])[] | undefined);
-    /**
-     * @deprecated Please call as `new LiveMap()` or `new LiveMap([])` instead.
-     */
-    constructor(entries: null);
-    /**
-     * Returns a specified element from the LiveMap.
-     * @param key The key of the element to return.
-     * @returns The element associated with the specified key, or undefined if the key can't be found in the LiveMap.
-     */
-    get(key: TKey): TValue | undefined;
-    /**
-     * Adds or updates an element with a specified key and a value.
-     * @param key The key of the element to add. Should be a string.
-     * @param value The value of the element to add. Should be serializable to JSON.
-     */
-    set(key: TKey, value: TValue): void;
-    /**
-     * Returns the number of elements in the LiveMap.
-     */
-    get size(): number;
-    /**
-     * Returns a boolean indicating whether an element with the specified key exists or not.
-     * @param key The key of the element to test for presence.
-     */
-    has(key: TKey): boolean;
-    /**
-     * Removes the specified element by key.
-     * @param key The key of the element to remove.
-     * @returns true if an element existed and has been removed, or false if the element does not exist.
-     */
-    delete(key: TKey): boolean;
-    /**
-     * Returns a new Iterator object that contains the [key, value] pairs for each element.
-     */
-    entries(): IterableIterator<[TKey, TValue]>;
-    /**
-     * Same function object as the initial value of the entries method.
-     */
-    [Symbol.iterator](): IterableIterator<[TKey, TValue]>;
-    /**
-     * Returns a new Iterator object that contains the keys for each element.
-     */
-    keys(): IterableIterator<TKey>;
-    /**
-     * Returns a new Iterator object that contains the values for each element.
-     */
-    values(): IterableIterator<TValue>;
-    /**
-     * Executes a provided function once per each key/value pair in the Map object, in insertion order.
-     * @param callback Function to execute for each entry in the map.
-     */
-    forEach(callback: (value: TValue, key: TKey, map: LiveMap<TKey, TValue>) => void): void;
+declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
+  _data: TValue;
+  constructor(data: TValue);
+  get data(): TValue;
+  /**
+   * INTERNAL
+   */
+  static _deserialize(
+    [id, item]: IdTuple<SerializedRegister>,
+    _parentToChildren: ParentToChildNodeMap,
+    doc: Doc
+  ): LiveRegister<Json>;
+  /**
+   * INTERNAL
+   */
+  _serialize(
+    parentId: string,
+    parentKey: string,
+    doc?: Doc
+  ): CreateRegisterOp[];
+  /**
+   * INTERNAL
+   */
+  _toSerializedCrdt(): SerializedRegister;
+  _attachChild(_op: CreateChildOp): ApplyResult;
+  _detachChild(_crdt: LiveNode): ApplyResult;
+  _apply(op: Op, isLocal: boolean): ApplyResult;
 }
 
+declare type LiveStructure =
+  | LiveObject<LsonObject>
+  | LiveList<Lson>
+  | LiveMap<string, Lson>;
 /**
  * Think of Lson as a sibling of the Json data tree, except that the nested
  * data structure can contain a mix of Json values and LiveStructure instances.
  */
-declare type Lson = Json | LiveObject<LsonObject> | LiveList<Lson> | LiveMap<string, Lson>;
+declare type Lson = Json | LiveStructure;
+/**
+ * LiveNode is the internal tree for managing Live data structures. The key
+ * difference with Lson is that all the Json values get represented in
+ * a LiveRegister node.
+ */
+declare type LiveNode = LiveStructure | LiveRegister<Json>;
 /**
  * A mapping of keys to Lson values. A Lson value is any valid JSON
  * value or a Live storage data structure (LiveMap, LiveList, etc.)
  */
 declare type LsonObject = {
-    [key: string]: Lson | undefined;
+  [key: string]: Lson | undefined;
 };
 
+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,
+}
 /**
- * The LiveList class represents an ordered collection of items that is synchronized across clients.
+ * These operations are the payload for {@link UpdateStorageServerMsg} messages
+ * only.
  */
-declare class LiveList<TItem extends Lson = Lson> extends AbstractCrdt {
-    private _items;
-    constructor(items?: TItem[]);
-    /**
-     * Returns the number of elements.
-     */
-    get length(): number;
-    /**
-     * Adds one element to the end of the LiveList.
-     * @param element The element to add to the end of the LiveList.
-     */
-    push(element: TItem): void;
-    /**
-     * Inserts one element at a specified index.
-     * @param element The element to insert.
-     * @param index The index at which you want to insert the element.
-     */
-    insert(element: TItem, index: number): void;
-    /**
-     * Move one element from one index to another.
-     * @param index The index of the element to move
-     * @param targetIndex The index where the element should be after moving.
-     */
-    move(index: number, targetIndex: number): void;
-    /**
-     * Deletes an element at the specified index
-     * @param index The index of the element to delete
-     */
-    delete(index: number): void;
-    clear(): void;
-    set(index: number, item: TItem): void;
-    /**
-     * Returns an Array of all the elements in the LiveList.
-     */
-    toArray(): TItem[];
-    /**
-     * Tests whether all elements pass the test implemented by the provided function.
-     * @param predicate Function to test for each element, taking two arguments (the element and its index).
-     * @returns true if the predicate function returns a truthy value for every element. Otherwise, false.
-     */
-    every(predicate: (value: TItem, index: number) => unknown): boolean;
-    /**
-     * Creates an array with all elements that pass the test implemented by the provided function.
-     * @param predicate Function to test each element of the LiveList. Return a value that coerces to true to keep the element, or to false otherwise.
-     * @returns An array with the elements that pass the test.
-     */
-    filter(predicate: (value: TItem, index: number) => unknown): TItem[];
-    /**
-     * Returns the first element that satisfies the provided testing function.
-     * @param predicate Function to execute on each value.
-     * @returns The value of the first element in the LiveList that satisfies the provided testing function. Otherwise, undefined is returned.
-     */
-    find(predicate: (value: TItem, index: number) => unknown): TItem | undefined;
-    /**
-     * Returns the index of the first element in the LiveList that satisfies the provided testing function.
-     * @param predicate Function to execute on each value until the function returns true, indicating that the satisfying element was found.
-     * @returns The index of the first element in the LiveList that passes the test. Otherwise, -1.
-     */
-    findIndex(predicate: (value: TItem, index: number) => unknown): number;
-    /**
-     * Executes a provided function once for each element.
-     * @param callbackfn Function to execute on each element.
-     */
-    forEach(callbackfn: (value: TItem, index: number) => void): void;
-    /**
-     * Get the element at the specified index.
-     * @param index The index on the element to get.
-     * @returns The element at the specified index or undefined.
-     */
-    get(index: number): TItem | undefined;
-    /**
-     * Returns the first index at which a given element can be found in the LiveList, or -1 if it is not present.
-     * @param searchElement Element to locate.
-     * @param fromIndex The index to start the search at.
-     * @returns The first index of the element in the LiveList; -1 if not found.
-     */
-    indexOf(searchElement: TItem, fromIndex?: number): number;
-    /**
-     * Returns the last index at which a given element can be found in the LiveList, or -1 if it is not present. The LiveLsit is searched backwards, starting at fromIndex.
-     * @param searchElement Element to locate.
-     * @param fromIndex The index at which to start searching backwards.
-     * @returns
-     */
-    lastIndexOf(searchElement: TItem, fromIndex?: number): number;
-    /**
-     * Creates an array populated with the results of calling a provided function on every element.
-     * @param callback Function that is called for every element.
-     * @returns An array with each element being the result of the callback function.
-     */
-    map<U>(callback: (value: TItem, index: number) => U): U[];
-    /**
-     * Tests whether at least one element in the LiveList passes the test implemented by the provided function.
-     * @param predicate Function to test for each element.
-     * @returns true if the callback function returns a truthy value for at least one element. Otherwise, false.
-     */
-    some(predicate: (value: TItem, index: number) => unknown): boolean;
-    [Symbol.iterator](): IterableIterator<TItem>;
+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: OpCode.UPDATE_OBJECT;
+  data: Partial<JsonObject>;
+};
+declare type CreateObjectOp = {
+  opId?: string;
+  id: string;
+  intent?: "set";
+  deletedId?: string;
+  type: OpCode.CREATE_OBJECT;
+  parentId: string;
+  parentKey: string;
+  data: JsonObject;
+};
+declare type CreateRootObjectOp = {
+  opId?: string;
+  id: string;
+  type: OpCode.CREATE_OBJECT;
+  data: JsonObject;
+  parentId?: never;
+  parentKey?: never;
+};
+declare type CreateListOp = {
+  opId?: string;
+  id: string;
+  intent?: "set";
+  deletedId?: string;
+  type: OpCode.CREATE_LIST;
+  parentId: string;
+  parentKey: string;
+};
+declare type CreateMapOp = {
+  opId?: string;
+  id: string;
+  intent?: "set";
+  deletedId?: string;
+  type: OpCode.CREATE_MAP;
+  parentId: string;
+  parentKey: string;
+};
+declare type CreateRegisterOp = {
+  opId?: string;
+  id: string;
+  intent?: "set";
+  deletedId?: string;
+  type: OpCode.CREATE_REGISTER;
+  parentId: string;
+  parentKey: string;
+  data: Json;
+};
+declare type DeleteCrdtOp = {
+  opId?: string;
+  id: string;
+  type: OpCode.DELETE_CRDT;
+};
+declare type SetParentKeyOp = {
+  opId?: string;
+  id: string;
+  type: OpCode.SET_PARENT_KEY;
+  parentKey: string;
+};
+declare type DeleteObjectKeyOp = {
+  opId?: string;
+  id: string;
+  type: OpCode.DELETE_OBJECT_KEY;
+  key: string;
+};
+
+declare type IdTuple<T> = [id: string, value: T];
+declare enum CrdtType {
+  OBJECT = 0,
+  LIST = 1,
+  MAP = 2,
+  REGISTER = 3,
 }
+declare type SerializedCrdt = SerializedRootObject | SerializedChild;
+declare type SerializedChild =
+  | SerializedObject
+  | SerializedList
+  | SerializedMap
+  | SerializedRegister;
+declare type SerializedRootObject = {
+  type: CrdtType.OBJECT;
+  data: JsonObject;
+  parentId?: never;
+  parentKey?: never;
+};
+declare type SerializedObject = {
+  type: CrdtType.OBJECT;
+  parentId: string;
+  parentKey: string;
+  data: JsonObject;
+};
+declare type SerializedList = {
+  type: CrdtType.LIST;
+  parentId: string;
+  parentKey: string;
+};
+declare type SerializedMap = {
+  type: CrdtType.MAP;
+  parentId: string;
+  parentKey: string;
+};
+declare type SerializedRegister = {
+  type: CrdtType.REGISTER;
+  parentId: string;
+  parentKey: string;
+  data: Json;
+};
+declare function isRootCrdt(crdt: SerializedCrdt): crdt is SerializedRootObject;
+declare function isChildCrdt(crdt: SerializedCrdt): crdt is SerializedChild;
+
+/**
+ * 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>[]
+>;
 
 /**
  * This helper type is effectively a no-op, but will force TypeScript to
@@ -217,173 +500,217 @@ declare class LiveList<TItem extends Lson = Lson> extends AbstractCrdt {
  * This trick comes from:
  * https://effectivetypescript.com/2022/02/25/gentips-4-display/
  */
-declare type Resolve<T> = T extends Function ? T : {
-    [K in keyof T]: T[K];
-};
-declare type MyPresenceCallback<T extends Presence = Presence> = (me: T) => void;
-declare type OthersEventCallback<T extends Presence = Presence> = (others: Others<T>, event: OthersEvent<T>) => void;
-declare type EventCallback = ({ connectionId, event, }: {
-    connectionId: number;
-    event: Json;
+declare type Resolve<T> = T extends (...args: unknown[]) => unknown
+  ? T
+  : {
+      [K in keyof T]: T[K];
+    };
+declare type MyPresenceCallback<TPresence extends JsonObject> = (
+  me: TPresence
+) => void;
+declare type OthersEventCallback<TPresence extends JsonObject> = (
+  others: Others<TPresence>,
+  event: OthersEvent<TPresence>
+) => void;
+declare type EventCallback = ({
+  connectionId,
+  event,
+}: {
+  connectionId: number;
+  event: Json;
 }) => void;
 declare type ErrorCallback = (error: Error) => void;
 declare type ConnectionCallback = (state: ConnectionState) => void;
-declare type UpdateDelta = {
-    type: "update";
-} | {
-    type: "delete";
-};
+declare type UpdateDelta =
+  | {
+      type: "update";
+    }
+  | {
+      type: "delete";
+    };
 /**
  * A LiveMap notification that is sent in-client to any subscribers whenever
  * one or more of the values inside the LiveMap instance have changed.
  */
 declare type LiveMapUpdates<TKey extends string, TValue extends Lson> = {
-    type: "LiveMap";
-    node: LiveMap<TKey, TValue>;
-    updates: {
-        [key: string]: UpdateDelta;
-    };
+  type: "LiveMap";
+  node: LiveMap<TKey, TValue>;
+  updates: {
+    [key: string]: UpdateDelta;
+  };
 };
-declare type LiveObjectUpdateDelta<O extends {
+declare type LiveObjectUpdateDelta<
+  O extends {
     [key: string]: unknown;
-}> = {
-    [K in keyof O]?: UpdateDelta | undefined;
+  }
+> = {
+  [K in keyof O]?: UpdateDelta | undefined;
 };
 /**
  * A LiveObject notification that is sent in-client to any subscribers whenever
  * one or more of the entries inside the LiveObject instance have changed.
  */
 declare type LiveObjectUpdates<TData extends LsonObject> = {
-    type: "LiveObject";
-    node: LiveObject<TData>;
-    updates: LiveObjectUpdateDelta<TData>;
-};
-declare type LiveListUpdateDelta = {
-    index: number;
-    item: any;
-    type: "insert";
-} | {
-    index: number;
-    type: "delete";
-} | {
-    index: number;
-    previousIndex: number;
-    item: any;
-    type: "move";
-} | {
-    index: number;
-    item: any;
-    type: "set";
+  type: "LiveObject";
+  node: LiveObject<TData>;
+  updates: LiveObjectUpdateDelta<TData>;
 };
+declare type LiveListUpdateDelta =
+  | {
+      index: number;
+      item: Lson;
+      type: "insert";
+    }
+  | {
+      index: number;
+      type: "delete";
+    }
+  | {
+      index: number;
+      previousIndex: number;
+      item: Lson;
+      type: "move";
+    }
+  | {
+      index: number;
+      item: Lson;
+      type: "set";
+    };
 /**
  * A LiveList notification that is sent in-client to any subscribers whenever
  * one or more of the items inside the LiveList instance have changed.
  */
 declare type LiveListUpdates<TItem extends Lson> = {
-    type: "LiveList";
-    node: LiveList<TItem>;
-    updates: LiveListUpdateDelta[];
+  type: "LiveList";
+  node: LiveList<TItem>;
+  updates: LiveListUpdateDelta[];
 };
 declare type BroadcastOptions = {
-    /**
-     * Whether or not event is queued if the connection is currently closed.
-     *
-     * ❗ We are not sure if we want to support this option in the future so it might be deprecated to be replaced by something else
-     */
-    shouldQueueEventIfNotReady: boolean;
+  /**
+   * Whether or not event is queued if the connection is currently closed.
+   *
+   * ❗ We are not sure if we want to support this option in the future so it might be deprecated to be replaced by something else
+   */
+  shouldQueueEventIfNotReady: boolean;
 };
 /**
  * The payload of notifications sent (in-client) when LiveStructures change.
  * Messages of this kind are not originating from the network, but are 100%
  * in-client.
  */
-declare type StorageUpdate = LiveMapUpdates<string, Lson> | LiveObjectUpdates<LsonObject> | LiveListUpdates<Lson>;
-declare type RoomInitializers<TPresence, TStorage> = Resolve<{
-    /**
-     * The initial Presence to use and announce when you enter the Room. The
-     * Presence is available on all users in the Room (me & others).
-     */
-    initialPresence?: TPresence | ((roomId: string) => TPresence);
-    /**
-     * The initial Storage to use when entering a new Room.
-     */
-    initialStorage?: TStorage | ((roomId: string) => TStorage);
-    /**
-     * @deprecated Please use `initialPresence` instead. This property is
-     * scheduled for removal in 0.18.
-     */
-    defaultPresence?: () => TPresence;
-    /**
-     * @deprecated Please use `initialStorage` instead. This property is
-     * scheduled for removal in 0.18.
-     */
-    defaultStorageRoot?: TStorage;
+declare type StorageUpdate =
+  | LiveMapUpdates<string, Lson>
+  | LiveObjectUpdates<LsonObject>
+  | LiveListUpdates<Lson>;
+declare type RoomInitializers<
+  TPresence extends JsonObject,
+  TStorage extends LsonObject
+> = Resolve<{
+  /**
+   * The initial Presence to use and announce when you enter the Room. The
+   * Presence is available on all users in the Room (me & others).
+   */
+  initialPresence?: TPresence | ((roomId: string) => TPresence);
+  /**
+   * The initial Storage to use when entering a new Room.
+   */
+  initialStorage?: TStorage | ((roomId: string) => TStorage);
+  /**
+   * @deprecated Please use `initialPresence` instead. This property is
+   * scheduled for removal in 0.18.
+   */
+  defaultPresence?: () => TPresence;
+  /**
+   * @deprecated Please use `initialStorage` instead. This property is
+   * scheduled for removal in 0.18.
+   */
+  defaultStorageRoot?: TStorage;
 }>;
 declare type Client = {
-    /**
-     * Gets a room. Returns null if {@link Client.enter} has not been called previously.
-     *
-     * @param roomId The id of the room
-     */
-    getRoom(roomId: string): Room | null;
-    /**
-     * Enters a room and returns it.
-     * @param roomId The id of the room
-     * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
-     */
-    enter<TStorage extends Record<string, any> = Record<string, any>>(roomId: string, options?: RoomInitializers<Presence, TStorage>): Room;
-    /**
-     * Leaves a room.
-     * @param roomId The id of the room
-     */
-    leave(roomId: string): void;
+  /**
+   * Gets a room. Returns null if {@link Client.enter} has not been called previously.
+   *
+   * @param roomId The id of the room
+   */
+  getRoom<TPresence extends JsonObject, TStorage extends LsonObject>(
+    roomId: string
+  ): Room<TPresence, TStorage> | null;
+  /**
+   * Enters a room and returns it.
+   * @param roomId The id of the room
+   * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
+   */
+  enter<TPresence extends JsonObject, TStorage extends LsonObject>(
+    roomId: string,
+    options?: RoomInitializers<TPresence, TStorage>
+  ): Room<TPresence, TStorage>;
+  /**
+   * Leaves a room.
+   * @param roomId The id of the room
+   */
+  leave(roomId: string): void;
 };
 /**
  * Represents all the other users connected in the room. Treated as immutable.
  */
-interface Others<TPresence extends Presence = Presence> {
-    /**
-     * Number of other users in the room.
-     */
-    readonly count: number;
-    /**
-     * Returns a new Iterator object that contains the users.
-     */
-    [Symbol.iterator](): IterableIterator<User<TPresence>>;
-    /**
-     * Returns the array of connected users in room.
-     */
-    toArray(): User<TPresence>[];
-    /**
-     * This function let you map over the connected users in the room.
-     */
-    map<U>(callback: (user: User<TPresence>) => U): U[];
+interface Others<TPresence extends JsonObject> {
+  /**
+   * Number of other users in the room.
+   */
+  readonly count: number;
+  /**
+   * Returns a new Iterator object that contains the users.
+   */
+  [Symbol.iterator](): IterableIterator<User<TPresence>>;
+  /**
+   * Returns the array of connected users in room.
+   */
+  toArray(): User<TPresence>[];
+  /**
+   * This function let you map over the connected users in the room.
+   */
+  map<U>(callback: (user: User<TPresence>) => U): U[];
 }
 /**
  * Represents a user connected in a room. Treated as immutable.
  */
-declare type User<TPresence extends Presence = Presence> = {
-    /**
-     * The connection id of the user. It is unique and increment at every new connection.
-     */
-    readonly connectionId: number;
-    /**
-     * The id of the user that has been set in the authentication endpoint.
-     * Useful to get additional information about the connected user.
-     */
-    readonly id?: string;
-    /**
-     * Additional user information that has been set in the authentication endpoint.
-     */
-    readonly info?: any;
-    /**
-     * The user presence.
-     */
-    readonly presence?: TPresence;
+declare type User<TPresence extends JsonObject> = {
+  /**
+   * The connection id of the user. It is unique and increment at every new connection.
+   */
+  readonly connectionId: number;
+  /**
+   * The id of the user that has been set in the authentication endpoint.
+   * Useful to get additional information about the connected user.
+   */
+  readonly id?: string;
+  /**
+   * Additional user information that has been set in the authentication endpoint.
+   */
+  readonly info?: any;
+  /**
+   * The user presence.
+   */
+  readonly presence?: TPresence;
 };
-declare type Presence = Record<string, unknown>;
+/**
+ * @deprecated Whatever you want to store as presence is app-specific. Please
+ * define your own Presence type instead of importing it from
+ * `@liveblocks/client`, for example:
+ *
+ *    type Presence = {
+ *      name: string,
+ *      cursor: {
+ *        x: number,
+ *        y: number,
+ *      } | null,
+ *    }
+ *
+ * As long as it only contains JSON-serializable values, you're good!
+ */
+declare type Presence = JsonObject;
 declare type AuthEndpointCallback = (room: string) => Promise<{
-    token: string;
+  token: string;
 }>;
 declare type AuthEndpoint = string | AuthEndpointCallback;
 /**
@@ -391,396 +718,414 @@ declare type AuthEndpoint = string | AuthEndpointCallback;
  * Can be an url or a callback if you need to add additional headers.
  */
 declare type ClientOptions = {
-    throttle?: number;
-    fetchPolyfill?: any;
-    WebSocketPolyfill?: any;
-} & ({
-    publicApiKey: string;
-    authEndpoint?: never;
-} | {
-    publicApiKey?: never;
-    authEndpoint: AuthEndpoint;
-});
-declare type Connection = {
-    state: "closed" | "authenticating" | "unavailable" | "failed";
-} | {
-    state: "open" | "connecting";
-    id: number;
-    userId?: string;
-    userInfo?: any;
-};
+  throttle?: number;
+  fetchPolyfill?: typeof fetch;
+  WebSocketPolyfill?: any;
+  atobPolyfill?: (data: string) => string;
+} & (
+  | {
+      publicApiKey: string;
+      authEndpoint?: never;
+    }
+  | {
+      publicApiKey?: never;
+      authEndpoint: AuthEndpoint;
+    }
+);
+declare type Connection =
+  | {
+      state: "closed" | "authenticating" | "unavailable" | "failed";
+    }
+  | {
+      state: "open" | "connecting";
+      id: number;
+      userId?: string;
+      userInfo?: Json;
+    };
 declare type ConnectionState = Connection["state"];
-declare type OthersEvent<T extends Presence = Presence> = {
-    type: "leave";
-    user: User<T>;
-} | {
-    type: "enter";
-    user: User<T>;
-} | {
-    type: "update";
-    user: User<T>;
-    updates: Partial<T>;
-} | {
-    type: "reset";
-};
+declare type OthersEvent<TPresence extends JsonObject> =
+  | {
+      type: "leave";
+      user: User<TPresence>;
+    }
+  | {
+      type: "enter";
+      user: User<TPresence>;
+    }
+  | {
+      type: "update";
+      user: User<TPresence>;
+      updates: Partial<TPresence>;
+    }
+  | {
+      type: "reset";
+    };
 interface History {
+  /**
+   * Undoes the last operation executed by the current client.
+   * It does not impact operations made by other clients.
+   *
+   * @example
+   * room.updatePresence({ selectedId: "xx" }, { addToHistory: true });
+   * room.updatePresence({ selectedId: "yy" }, { addToHistory: true });
+   * room.history.undo();
+   * // room.getPresence() equals { selectedId: "xx" }
+   */
+  undo: () => void;
+  /**
+   * Redoes the last operation executed by the current client.
+   * It does not impact operations made by other clients.
+   *
+   * @example
+   * room.updatePresence({ selectedId: "xx" }, { addToHistory: true });
+   * room.updatePresence({ selectedId: "yy" }, { addToHistory: true });
+   * room.history.undo();
+   * // room.getPresence() equals { selectedId: "xx" }
+   * room.history.redo();
+   * // room.getPresence() equals { selectedId: "yy" }
+   */
+  redo: () => void;
+  /**
+   * All future modifications made on the Room will be merged together to create a single history item until resume is called.
+   *
+   * @example
+   * room.updatePresence({ cursor: { x: 0, y: 0 } }, { addToHistory: true });
+   * room.history.pause();
+   * room.updatePresence({ cursor: { x: 1, y: 1 } }, { addToHistory: true });
+   * room.updatePresence({ cursor: { x: 2, y: 2 } }, { addToHistory: true });
+   * room.history.resume();
+   * room.history.undo();
+   * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
+   */
+  pause: () => void;
+  /**
+   * Resumes history. Modifications made on the Room are not merged into a single history item anymore.
+   *
+   * @example
+   * room.updatePresence({ cursor: { x: 0, y: 0 } }, { addToHistory: true });
+   * room.history.pause();
+   * room.updatePresence({ cursor: { x: 1, y: 1 } }, { addToHistory: true });
+   * room.updatePresence({ cursor: { x: 2, y: 2 } }, { addToHistory: true });
+   * room.history.resume();
+   * room.history.undo();
+   * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
+   */
+  resume: () => void;
+}
+declare type Room<TPresence extends JsonObject, TStorage extends LsonObject> = {
+  /**
+   * The id of the room.
+   */
+  readonly id: string;
+  getConnectionState(): ConnectionState;
+  subscribe: {
     /**
-     * Undoes the last operation executed by the current client.
-     * It does not impact operations made by other clients.
+     * Subscribe to the current user presence updates.
      *
-     * @example
-     * room.updatePresence({ selectedId: "xxx" }, { addToHistory: true });
-     * room.updatePresence({ selectedId: "yyy" }, { addToHistory: true });
-     * room.history.undo();
-     * // room.getPresence() equals { selectedId: "xxx" }
-     */
-    undo: () => void;
-    /**
-     * Redoes the last operation executed by the current client.
-     * It does not impact operations made by other clients.
+     * @param listener the callback that is called every time the current user presence is updated with {@link Room.updatePresence}.
      *
      * @example
-     * room.updatePresence({ selectedId: "xxx" }, { addToHistory: true });
-     * room.updatePresence({ selectedId: "yyy" }, { addToHistory: true });
-     * room.history.undo();
-     * // room.getPresence() equals { selectedId: "xxx" }
-     * room.history.redo();
-     * // room.getPresence() equals { selectedId: "yyy" }
+     * room.subscribe("my-presence", (presence) => {
+     *   // Do something
+     * });
      */
-    redo: () => void;
+    (type: "my-presence", listener: MyPresenceCallback<TPresence>): () => void;
     /**
-     * All future modifications made on the Room will be merged together to create a single history item until resume is called.
+     * Subscribe to the other users updates.
+     *
+     * @param listener the callback that is called when a user enters or leaves the room or when a user update its presence.
      *
      * @example
-     * room.updatePresence({ cursor: { x: 0, y: 0 } }, { addToHistory: true });
-     * room.history.pause();
-     * room.updatePresence({ cursor: { x: 1, y: 1 } }, { addToHistory: true });
-     * room.updatePresence({ cursor: { x: 2, y: 2 } }, { addToHistory: true });
-     * room.history.resume();
-     * room.history.undo();
-     * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
+     * room.subscribe("others", (others) => {
+     *   // Do something
+     * });
      */
-    pause: () => void;
+    (type: "others", listener: OthersEventCallback<TPresence>): () => void;
     /**
-     * Resumes history. Modifications made on the Room are not merged into a single history item anymore.
+     * Subscribe to events broadcasted by {@link Room.broadcastEvent}
+     *
+     * @param listener the callback that is called when a user calls {@link Room.broadcastEvent}
      *
      * @example
-     * room.updatePresence({ cursor: { x: 0, y: 0 } }, { addToHistory: true });
-     * room.history.pause();
-     * room.updatePresence({ cursor: { x: 1, y: 1 } }, { addToHistory: true });
-     * room.updatePresence({ cursor: { x: 2, y: 2 } }, { addToHistory: true });
-     * room.history.resume();
-     * room.history.undo();
-     * // room.getPresence() equals { cursor: { x: 0, y: 0 } }
-     */
-    resume: () => void;
-}
-declare type Room = {
-    /**
-     * The id of the room.
+     * room.subscribe("event", ({ event, connectionId }) => {
+     *   // Do something
+     * });
      */
-    readonly id: string;
-    getConnectionState(): ConnectionState;
-    subscribe: {
-        /**
-         * Subscribe to the current user presence updates.
-         *
-         * @param listener the callback that is called every time the current user presence is updated with {@link Room.updatePresence}.
-         *
-         * @example
-         * room.subscribe("my-presence", (presence) => {
-         *   // Do something
-         * });
-         */
-        <T extends Presence>(type: "my-presence", listener: MyPresenceCallback<T>): () => void;
-        /**
-         * Subscribe to the other users updates.
-         *
-         * @param listener the callback that is called when a user enters or leaves the room or when a user update its presence.
-         *
-         * @example
-         * room.subscribe("others", (others) => {
-         *   // Do something
-         * });
-         */
-        <T extends Presence>(type: "others", listener: OthersEventCallback<T>): () => void;
-        /**
-         * Subscribe to events broadcasted by {@link Room.broadcastEvent}
-         *
-         * @param listener the callback that is called when a user calls {@link Room.broadcastEvent}
-         *
-         * @example
-         * room.subscribe("event", ({ event, connectionId }) => {
-         *   // Do something
-         * });
-         */
-        (type: "event", listener: EventCallback): () => void;
-        /**
-         * Subscribe to errors thrown in the room.
-         */
-        (type: "error", listener: ErrorCallback): () => void;
-        /**
-         * Subscribe to connection state updates.
-         */
-        (type: "connection", listener: ConnectionCallback): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveMap}. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveMap}.
-         *
-         * @param listener the callback this called when the {@link LiveMap} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveMap = new LiveMap();
-         * const unsubscribe = room.subscribe(liveMap, (liveMap) => { });
-         * unsubscribe();
-         */
-        <TKey extends string, TValue extends Lson>(liveMap: LiveMap<TKey, TValue>, listener: (liveMap: LiveMap<TKey, TValue>) => void): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveObject}. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveObject}.
-         *
-         * @param listener the callback this called when the {@link LiveObject} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveObject = new LiveObject();
-         * const unsubscribe = room.subscribe(liveObject, (liveObject) => { });
-         * unsubscribe();
-         */
-        <TData extends JsonObject>(liveObject: LiveObject<TData>, callback: (liveObject: LiveObject<TData>) => void): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveList}. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveList}.
-         *
-         * @param listener the callback this called when the {@link LiveList} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveList = new LiveList();
-         * const unsubscribe = room.subscribe(liveList, (liveList) => { });
-         * unsubscribe();
-         */
-        <TItem extends Lson>(liveList: LiveList<TItem>, callback: (liveList: LiveList<TItem>) => void): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveMap} and all the nested data structures. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveMap}.
-         *
-         * @param listener the callback this called when the {@link LiveMap} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveMap = new LiveMap();
-         * const unsubscribe = room.subscribe(liveMap, (liveMap) => { }, { isDeep: true });
-         * unsubscribe();
-         */
-        <TKey extends string, TValue extends Lson>(liveMap: LiveMap<TKey, TValue>, callback: (updates: LiveMapUpdates<TKey, TValue>[]) => void, options: {
-            isDeep: true;
-        }): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveObject} and all the nested data structures. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveObject}.
-         *
-         * @param listener the callback this called when the {@link LiveObject} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveObject = new LiveObject();
-         * const unsubscribe = room.subscribe(liveObject, (liveObject) => { }, { isDeep: true });
-         * unsubscribe();
-         */
-        <TData extends LsonObject>(liveObject: LiveObject<TData>, callback: (updates: LiveObjectUpdates<TData>[]) => void, options: {
-            isDeep: true;
-        }): () => void;
-        /**
-         * Subscribes to changes made on a {@link LiveList} and all the nested data structures. Returns an unsubscribe function.
-         * In a future version, we will also expose what exactly changed in the {@link LiveList}.
-         *
-         * @param listener the callback this called when the {@link LiveList} changes.
-         *
-         * @returns Unsubscribe function.
-         *
-         * @example
-         * const liveList = new LiveList();
-         * const unsubscribe = room.subscribe(liveList, (liveList) => { }, { isDeep: true });
-         * unsubscribe();
-         */
-        <TItem extends Lson>(liveList: LiveList<TItem>, callback: (updates: LiveListUpdates<TItem>[]) => void, options: {
-            isDeep: true;
-        }): () => void;
-    };
+    (type: "event", listener: EventCallback): () => void;
     /**
-     * Room's history contains functions that let you undo and redo operation made on by the current client on the presence and storage.
+     * Subscribe to errors thrown in the room.
      */
-    history: History;
+    (type: "error", listener: ErrorCallback): () => void;
     /**
-     * @deprecated use the callback returned by subscribe instead.
-     * See v0.13 release notes for more information.
-     * Will be removed in a future version.
+     * Subscribe to connection state updates.
      */
-    unsubscribe: {
-        /**
-         * @deprecated use the callback returned by subscribe instead.
-         * See v0.13 release notes for more information.
-         * Will be removed in a future version.
-         */
-        <T extends Presence>(type: "my-presence", listener: MyPresenceCallback<T>): void;
-        /**
-         * @deprecated use the callback returned by subscribe instead.
-         * See v0.13 release notes for more information.
-         * Will be removed in a future version.
-         */
-        <T extends Presence>(type: "others", listener: OthersEventCallback<T>): void;
-        /**
-         * @deprecated use the callback returned by subscribe instead.
-         * See v0.13 release notes for more information.
-         * Will be removed in a future version.
-         */
-        (type: "event", listener: EventCallback): void;
-        /**
-         * @deprecated use the callback returned by subscribe instead.
-         * See v0.13 release notes for more information.
-         * Will be removed in a future version.
-         */
-        (type: "error", listener: ErrorCallback): void;
-        /**
-         * @deprecated use the callback returned by subscribe instead.
-         * See v0.13 release notes for more information.
-         * Will be removed in a future version.
-         */
-        (type: "connection", listener: ConnectionCallback): void;
-    };
+    (type: "connection", listener: ConnectionCallback): () => void;
     /**
-     * Gets the current user.
-     * Returns null if not it is not yet connected to the room.
+     * Subscribes to changes made on a {@link LiveMap}. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveMap}.
+     *
+     * @param listener the callback this called when the {@link LiveMap} changes.
+     *
+     * @returns Unsubscribe function.
      *
      * @example
-     * const user = room.getSelf();
+     * const liveMap = new LiveMap();
+     * const unsubscribe = room.subscribe(liveMap, (liveMap) => { });
+     * unsubscribe();
      */
-    getSelf<TPresence extends Presence = Presence>(): User<TPresence> | null;
+    <TKey extends string, TValue extends Lson>(
+      liveMap: LiveMap<TKey, TValue>,
+      listener: (liveMap: LiveMap<TKey, TValue>) => void
+    ): () => void;
     /**
-     * Gets the presence of the current user.
+     * Subscribes to changes made on a {@link LiveObject}. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveObject}.
+     *
+     * @param callback the callback this called when the {@link LiveObject} changes.
+     *
+     * @returns Unsubscribe function.
      *
      * @example
-     * const presence = room.getPresence();
+     * const liveObject = new LiveObject();
+     * const unsubscribe = room.subscribe(liveObject, (liveObject) => { });
+     * unsubscribe();
      */
-    getPresence: <T extends Presence>() => T;
+    <TData extends JsonObject>(
+      liveObject: LiveObject<TData>,
+      callback: (liveObject: LiveObject<TData>) => void
+    ): () => void;
     /**
-     * Gets all the other users in the room.
+     * Subscribes to changes made on a {@link LiveList}. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveList}.
+     *
+     * @param callback the callback this called when the {@link LiveList} changes.
+     *
+     * @returns Unsubscribe function.
      *
      * @example
-     * const others = room.getOthers();
+     * const liveList = new LiveList();
+     * const unsubscribe = room.subscribe(liveList, (liveList) => { });
+     * unsubscribe();
      */
-    getOthers: <T extends Presence>() => Others<T>;
+    <TItem extends Lson>(
+      liveList: LiveList<TItem>,
+      callback: (liveList: LiveList<TItem>) => void
+    ): () => void;
     /**
-     * Updates the presence of the current user. Only pass the properties you want to update. No need to send the full presence.
-     * @param overrides A partial object that contains the properties you want to update.
-     * @param overrides Optional object to configure the behavior of updatePresence.
+     * Subscribes to changes made on a {@link LiveMap} and all the nested data structures. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveMap}.
      *
-     * @example
-     * room.updatePresence({ x: 0 });
-     * room.updatePresence({ y: 0 });
+     * @param callback the callback this called when the {@link LiveMap} changes.
      *
-     * const presence = room.getPresence();
-     * // presence is equivalent to { x: 0, y: 0 }
-     */
-    updatePresence: <T extends Presence>(overrides: Partial<T>, options?: {
-        /**
-         * Whether or not the presence should have an impact on the undo/redo history.
-         */
-        addToHistory: boolean;
-    }) => void;
-    /**
-     * Broadcasts an event to other users in the room. Event broadcasted to the room can be listened with {@link Room.subscribe}("event").
-     * @param {any} event the event to broadcast. Should be serializable to JSON
+     * @returns Unsubscribe function.
      *
      * @example
-     * // On client A
-     * room.broadcastEvent({ type: "EMOJI", emoji: "🔥" });
-     *
-     * // On client B
-     * room.subscribe("event", ({ event }) => {
-     *   if(event.type === "EMOJI") {
-     *     // Do something
-     *   }
-     * });
+     * const liveMap = new LiveMap();
+     * const unsubscribe = room.subscribe(liveMap, (liveMap) => { }, { isDeep: true });
+     * unsubscribe();
      */
-    broadcastEvent: (event: JsonObject, options?: BroadcastOptions) => void;
+    <TKey extends string, TValue extends Lson>(
+      liveMap: LiveMap<TKey, TValue>,
+      callback: (updates: LiveMapUpdates<TKey, TValue>[]) => void,
+      options: {
+        isDeep: true;
+      }
+    ): () => void;
     /**
-     * Get the room's storage asynchronously.
-     * The storage's root is a {@link LiveObject}.
+     * Subscribes to changes made on a {@link LiveObject} and all the nested data structures. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveObject}.
+     *
+     * @param callback the callback this called when the {@link LiveObject} changes.
+     *
+     * @returns Unsubscribe function.
      *
      * @example
-     * const { root } = await room.getStorage();
+     * const liveObject = new LiveObject();
+     * const unsubscribe = room.subscribe(liveObject, (liveObject) => { }, { isDeep: true });
+     * unsubscribe();
      */
-    getStorage: <TStorage extends LsonObject>() => Promise<{
-        root: LiveObject<TStorage>;
-    }>;
+    <TData extends LsonObject>(
+      liveObject: LiveObject<TData>,
+      callback: (updates: LiveObjectUpdates<TData>[]) => void,
+      options: {
+        isDeep: true;
+      }
+    ): () => void;
     /**
-     * Batches modifications made during the given function.
-     * All the modifications are sent to other clients in a single message.
-     * All the subscribers are called only after the batch is over.
-     * All the modifications are merged in a single history item (undo/redo).
+     * Subscribes to changes made on a {@link LiveList} and all the nested data structures. Returns an unsubscribe function.
+     * In a future version, we will also expose what exactly changed in the {@link LiveList}.
+     *
+     * @param callback the callback this called when the {@link LiveList} changes.
+     *
+     * @returns Unsubscribe function.
      *
      * @example
-     * const { root } = await room.getStorage();
-     * room.batch(() => {
-     *   root.set("x", 0);
-     *   room.updatePresence({ cursor: { x: 100, y: 100 }});
-     * });
+     * const liveList = new LiveList();
+     * const unsubscribe = room.subscribe(liveList, (liveList) => { }, { isDeep: true });
+     * unsubscribe();
      */
-    batch: (fn: () => void) => void;
-};
-
-declare abstract class AbstractCrdt {
-    private __parent?;
-    private __doc?;
-    private __id?;
-    private __parentKey?;
-    get roomId(): string | null;
-}
-
-/**
- * The LiveObject class is similar to a JavaScript object that is synchronized on all clients.
- * Keys should be a string, and values should be serializable to JSON.
- * If multiple clients update the same property simultaneously, the last modification received by the Liveblocks servers is the winner.
- */
-declare class LiveObject<O extends LsonObject = LsonObject> extends AbstractCrdt {
-    private _map;
-    private _propToLastUpdate;
-    constructor(obj?: O);
-    private _applyUpdate;
-    private _applyDeleteObjectKey;
-    /**
-     * Transform the LiveObject into a javascript object
-     */
-    toObject(): O;
-    /**
-     * Adds or updates a property with a specified key and a value.
-     * @param key The key of the property to add
-     * @param value The value of the property to add
-     */
-    set<TKey extends keyof O>(key: TKey, value: O[TKey]): void;
+    <TItem extends Lson>(
+      liveList: LiveList<TItem>,
+      callback: (updates: LiveListUpdates<TItem>[]) => void,
+      options: {
+        isDeep: true;
+      }
+    ): () => void;
+  };
+  /**
+   * Room's history contains functions that let you undo and redo operation made on by the current client on the presence and storage.
+   */
+  history: History;
+  /**
+   * Gets the current user.
+   * Returns null if not it is not yet connected to the room.
+   *
+   * @example
+   * const user = room.getSelf();
+   */
+  getSelf(): User<TPresence> | null;
+  /**
+   * Gets the presence of the current user.
+   *
+   * @example
+   * const presence = room.getPresence();
+   */
+  getPresence: () => TPresence;
+  /**
+   * Gets all the other users in the room.
+   *
+   * @example
+   * const others = room.getOthers();
+   */
+  getOthers: () => Others<TPresence>;
+  /**
+   * Updates the presence of the current user. Only pass the properties you want to update. No need to send the full presence.
+   * @param overrides A partial object that contains the properties you want to update.
+   * @param overrides Optional object to configure the behavior of updatePresence.
+   *
+   * @example
+   * room.updatePresence({ x: 0 });
+   * room.updatePresence({ y: 0 });
+   *
+   * const presence = room.getPresence();
+   * // presence is equivalent to { x: 0, y: 0 }
+   */
+  updatePresence: (
+    overrides: Partial<TPresence>,
+    options?: {
+      /**
+       * Whether or not the presence should have an impact on the undo/redo history.
+       */
+      addToHistory: boolean;
+    }
+  ) => void;
+  /**
+   * Broadcasts an event to other users in the room. Event broadcasted to the room can be listened with {@link Room.subscribe}("event").
+   * @param {any} event the event to broadcast. Should be serializable to JSON
+   *
+   * @example
+   * // On client A
+   * room.broadcastEvent({ type: "EMOJI", emoji: "🔥" });
+   *
+   * // On client B
+   * room.subscribe("event", ({ event }) => {
+   *   if(event.type === "EMOJI") {
+   *     // Do something
+   *   }
+   * });
+   */
+  broadcastEvent: (event: Json, options?: BroadcastOptions) => void;
+  /**
+   * Get the room's storage asynchronously.
+   * The storage's root is a {@link LiveObject}.
+   *
+   * @example
+   * const { root } = await room.getStorage();
+   */
+  getStorage: <
     /**
-     * Returns a specified property from the LiveObject.
-     * @param key The key of the property to get
+     * @deprecated This type argument is ignored. If you want to annotate this
+     * type manually, please annotate the Room instance instead.
      */
-    get<TKey extends keyof O>(key: TKey): O[TKey];
-    /**
-     * Deletes a key from the LiveObject
-     * @param key The key of the property to delete
-     */
-    delete(key: keyof O): void;
-    /**
-     * Adds or updates multiple properties at once with an object.
-     * @param overrides The object used to overrides properties
-     */
-    update(overrides: Partial<O>): void;
+    _ = unknown
+  >() => Promise<{
+    root: LiveObject<TStorage>;
+  }>;
+  /**
+   * Batches modifications made during the given function.
+   * All the modifications are sent to other clients in a single message.
+   * All the subscribers are called only after the batch is over.
+   * All the modifications are merged in a single history item (undo/redo).
+   *
+   * @example
+   * const { root } = await room.getStorage();
+   * room.batch(() => {
+   *   root.set("x", 0);
+   *   room.updatePresence({ cursor: { x: 100, y: 100 }});
+   * });
+   */
+  batch: (fn: () => void) => void;
+};
+declare enum WebsocketCloseCodes {
+  CLOSE_ABNORMAL = 1006,
+  INVALID_MESSAGE_FORMAT = 4000,
+  NOT_ALLOWED = 4001,
+  MAX_NUMBER_OF_MESSAGES_PER_SECONDS = 4002,
+  MAX_NUMBER_OF_CONCURRENT_CONNECTIONS = 4003,
+  MAX_NUMBER_OF_MESSAGES_PER_DAY_PER_APP = 4004,
+  MAX_NUMBER_OF_CONCURRENT_CONNECTIONS_PER_ROOM = 4005,
+  CLOSE_WITHOUT_RETRY = 4999,
 }
 
-export { AbstractCrdt as A, BroadcastOptions as B, ClientOptions as C, History as H, Json as J, LiveObject as L, Others as O, Presence as P, Room as R, StorageUpdate as S, User as U, Client as a, LiveMap as b, LiveList as c, JsonObject as d, Lson as e, LsonObject as f, Resolve as g, RoomInitializers as h, isJsonArray as i, isJsonObject as j, isJsonScalar as k };
+export {
+  SerializedRootObject as A,
+  BroadcastOptions as B,
+  ClientOptions as C,
+  DeleteCrdtOp as D,
+  SetParentKeyOp as E,
+  UpdateObjectOp as F,
+  CrdtType as G,
+  History as H,
+  IdTuple as I,
+  Json as J,
+  OpCode as K,
+  LiveList as L,
+  isJsonArray as M,
+  NodeMap as N,
+  Others as O,
+  Presence as P,
+  isJsonObject as Q,
+  Room as R,
+  StorageUpdate as S,
+  isJsonScalar as T,
+  User as U,
+  isChildCrdt as V,
+  WebsocketCloseCodes as W,
+  isRootCrdt as X,
+  Client as a,
+  LiveMap as b,
+  LiveObject as c,
+  JsonObject as d,
+  LiveStructure as e,
+  Lson as f,
+  LsonObject as g,
+  Op as h,
+  SerializedCrdt as i,
+  CreateChildOp as j,
+  CreateListOp as k,
+  CreateMapOp as l,
+  CreateObjectOp as m,
+  CreateOp as n,
+  CreateRegisterOp as o,
+  CreateRootObjectOp as p,
+  DeleteObjectKeyOp as q,
+  LiveNode as r,
+  ParentToChildNodeMap as s,
+  Resolve as t,
+  RoomInitializers as u,
+  SerializedChild as v,
+  SerializedList as w,
+  SerializedMap as x,
+  SerializedObject as y,
+  SerializedRegister as z,
+};