@liveblocks/core 2.15.1 → 2.16.0-rc1

package/dist/index.d.mts

@@ -5,18 +5,72 @@
 declare function detectDupes(pkgName: string, pkgVersion: string | false, // false if not built yet
 pkgFormat: string | false): void;
 
-declare type CustomAuthenticationResult = {
+/**
+ * This helper type is effectively a no-op, but will force TypeScript to
+ * "evaluate" any named helper types in its definition. This can sometimes make
+ * API signatures clearer in IDEs.
+ *
+ * For example, in:
+ *
+ *   type Payload<T> = { data: T };
+ *
+ *   let r1: Payload<string>;
+ *   let r2: Resolve<Payload<string>>;
+ *
+ * The inferred type of `r1` is going to be `Payload<string>` which shows up in
+ * editor hints, and it may be unclear what's inside if you don't know the
+ * definition of `Payload`.
+ *
+ * The inferred type of `r2` is going to be `{ data: string }`, which may be
+ * more helpful.
+ *
+ * This trick comes from:
+ * https://effectivetypescript.com/2022/02/25/gentips-4-display/
+ */
+type Resolve<T> = T extends (...args: unknown[]) => unknown ? T : {
+    [K in keyof T]: T[K];
+};
+
+/**
+ * Relaxes a discriminated union type definition, by explicitly adding
+ * properties defined in any other member as 'never'.
+ *
+ * This makes accessing the members much more relaxed in TypeScript.
+ *
+ * For example:
+ *   type MyUnion = Relax<
+ *     | { foo: string }
+ *     | { foo: number; bar: string; }
+ *     | { qux: boolean }
+ *   >;
+ *
+ *   // With Relax, accessing is much easier:
+ *   union.foo;       // string | number | undefined
+ *   union.bar;       // string | undefined
+ *   union.qux;       // boolean
+ *   union.whatever;  // Error: Property 'whatever' does not exist on type 'MyUnion'
+ *
+ *   // Without Relax, these would all be type errors:
+ *   union.foo; // Error: Property 'foo' does not exist on type 'MyUnion'
+ *   union.bar; // Error: Property 'bar' does not exist on type 'MyUnion'
+ *   union.qux; // Error: Property 'qux' does not exist on type 'MyUnion'
+ */
+type Relax<T> = DistributiveRelax<T, T extends any ? keyof T : never>;
+type DistributiveRelax<T, Ks extends string | number | symbol> = T extends any ? Resolve<{
+    [K in keyof T]: T[K];
+} & {
+    [K in Exclude<Ks, keyof T>]?: never;
+}> : never;
+
+type CustomAuthenticationResult = Relax<{
     token: string;
-    error?: never;
 } | {
-    token?: never;
     error: "forbidden";
     reason: string;
 } | {
-    token?: never;
     error: string;
     reason: string;
-};
+}>;
 
 /**
  * Represents an indefinitely deep arbitrary JSON data structure. There are
@@ -28,13 +82,13 @@ declare type CustomAuthenticationResult = {
  * - JsonObject   a JSON value whose outer type is an object
  *
  */
-declare type Json = JsonScalar | JsonArray | JsonObject;
-declare type JsonScalar = string | number | boolean | null;
-declare type JsonArray = Json[];
+type Json = JsonScalar | JsonArray | JsonObject;
+type JsonScalar = string | number | boolean | null;
+type JsonArray = Json[];
 /**
  * Any valid JSON object.
  */
-declare type JsonObject = {
+type JsonObject = {
     [key: string]: Json | undefined;
 };
 declare function isJsonScalar(data: Json): data is JsonScalar;
@@ -46,7 +100,7 @@ declare function isJsonObject(data: Json): data is JsonObject;
  * object is fine, but _if_ it has a name field, it _must_ be a string."
  * (Ditto for avatar.)
  */
-declare type IUserInfo = {
+type IUserInfo = {
     [key: string]: Json | undefined;
     name?: string;
     avatar?: string;
@@ -54,7 +108,7 @@ declare type IUserInfo = {
 /**
  * This type is used by clients to define the metadata for a user.
  */
-declare type BaseUserMeta = {
+type BaseUserMeta = {
     /**
      * The id of the user that has been set in the authentication endpoint.
      * Useful to get additional information about the connected user.
@@ -74,9 +128,9 @@ declare enum Permission {
     CommentsRead = "comments:read"
 }
 
-declare type Callback<T> = (event: T) => void;
-declare type UnsubscribeCallback = () => void;
-declare type Observable<T> = {
+type Callback<T> = (event: T) => void;
+type UnsubscribeCallback = () => void;
+type Observable<T> = {
     /**
      * Register a callback function to be called whenever the event source emits
      * an event.
@@ -95,11 +149,13 @@ declare type Observable<T> = {
      */
     waitUntil(predicate?: (event: T) => boolean): Promise<T>;
 };
-declare type EventSource<T> = Observable<T> & {
+type EventSource<T> = Observable<T> & {
     /**
-     * Notify all subscribers about the event.
+     * Notify all subscribers about the event. Will return `false` if there
+     * weren't any subscribers at the time the .notify() was called, or `true` if
+     * there was at least one subscriber.
      */
-    notify(event: T): void;
+    notify(event: T): boolean;
     /**
      * Returns the number of active subscribers.
      */
@@ -227,7 +283,7 @@ declare enum WebsocketCloseCodes {
  * a Room, as returned by `room.getStatus()`. Can be used to implement
  * a connection status badge.
  */
-declare type Status = "initial" | "connecting" | "connected" | "reconnecting" | "disconnected";
+type Status = "initial" | "connecting" | "connected" | "reconnecting" | "disconnected";
 /**
  * Used to report about app-level reconnection issues.
  *
@@ -237,7 +293,7 @@ declare type Status = "initial" | "connecting" | "connected" | "reconnecting" |
  * to inform your users about, for example, by throwing a toast message on
  * screen, or show a "trying to reconnect" banner.
  */
-declare type LostConnectionEvent = "lost" | "restored" | "failed";
+type LostConnectionEvent = "lost" | "restored" | "failed";
 /**
  * Arbitrary record that will be used as the authentication "authValue". It's the
  * value that is returned by calling the authentication delegate, and will get
@@ -245,11 +301,8 @@ declare type LostConnectionEvent = "lost" | "restored" | "failed";
  * the connection manager, but its value will not be interpreted, so it can be
  * any value (except null).
  */
-declare type BaseAuthResult = NonNullable<Json>;
-declare class LiveblocksError extends Error {
-    code: number;
-}
-declare type Delegates<T extends BaseAuthResult> = {
+type BaseAuthResult = NonNullable<Json>;
+type Delegates<T extends BaseAuthResult> = {
     authenticate: () => Promise<T>;
     createSocket: (authValue: T) => IWebSocketInstance;
     canZombie: () => boolean;
@@ -270,15 +323,15 @@ declare enum OpCode {
  * These operations are the payload for {@link UpdateStorageServerMsg} messages
  * only.
  */
-declare type Op = AckOp | CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp;
-declare type CreateOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp;
-declare type UpdateObjectOp = {
+type Op = AckOp | CreateOp | UpdateObjectOp | DeleteCrdtOp | SetParentKeyOp | DeleteObjectKeyOp;
+type CreateOp = CreateObjectOp | CreateRegisterOp | CreateMapOp | CreateListOp;
+type UpdateObjectOp = {
     readonly opId?: string;
     readonly id: string;
     readonly type: OpCode.UPDATE_OBJECT;
     readonly data: Partial<JsonObject>;
 };
-declare type CreateObjectOp = {
+type CreateObjectOp = {
     readonly opId?: string;
     readonly id: string;
     readonly intent?: "set";
@@ -288,7 +341,7 @@ declare type CreateObjectOp = {
     readonly parentKey: string;
     readonly data: JsonObject;
 };
-declare type CreateListOp = {
+type CreateListOp = {
     readonly opId?: string;
     readonly id: string;
     readonly intent?: "set";
@@ -297,7 +350,7 @@ declare type CreateListOp = {
     readonly parentId: string;
     readonly parentKey: string;
 };
-declare type CreateMapOp = {
+type CreateMapOp = {
     readonly opId?: string;
     readonly id: string;
     readonly intent?: "set";
@@ -306,7 +359,7 @@ declare type CreateMapOp = {
     readonly parentId: string;
     readonly parentKey: string;
 };
-declare type CreateRegisterOp = {
+type CreateRegisterOp = {
     readonly opId?: string;
     readonly id: string;
     readonly intent?: "set";
@@ -316,12 +369,12 @@ declare type CreateRegisterOp = {
     readonly parentKey: string;
     readonly data: Json;
 };
-declare type DeleteCrdtOp = {
+type DeleteCrdtOp = {
     readonly opId?: string;
     readonly id: string;
     readonly type: OpCode.DELETE_CRDT;
 };
-declare type AckOp = {
+type AckOp = {
     readonly type: OpCode.DELETE_CRDT;
     readonly id: "ACK";
     readonly opId: string;
@@ -345,13 +398,13 @@ declare type AckOp = {
  * node does not exist, but as a side-effect the Op will get acknowledged.
  */
 declare function ackOp(opId: string): AckOp;
-declare type SetParentKeyOp = {
+type SetParentKeyOp = {
     readonly opId?: string;
     readonly id: string;
     readonly type: OpCode.SET_PARENT_KEY;
     readonly parentKey: string;
 };
-declare type DeleteObjectKeyOp = {
+type DeleteObjectKeyOp = {
     readonly opId?: string;
     readonly id: string;
     readonly type: OpCode.DELETE_OBJECT_KEY;
@@ -362,15 +415,15 @@ declare type DeleteObjectKeyOp = {
  * Represents an indefinitely deep arbitrary immutable data
  * structure, as returned by the .toImmutable().
  */
-declare type Immutable = Scalar | ImmutableList | ImmutableObject | ImmutableMap;
-declare type Scalar = string | number | boolean | null;
-declare type ImmutableList = readonly Immutable[];
-declare type ImmutableObject = {
+type Immutable = Scalar | ImmutableList | ImmutableObject | ImmutableMap;
+type Scalar = string | number | boolean | null;
+type ImmutableList = readonly Immutable[];
+type ImmutableObject = {
     readonly [key: string]: Immutable | undefined;
 };
-declare type ImmutableMap = ReadonlyMap<string, Immutable>;
+type ImmutableMap = ReadonlyMap<string, Immutable>;
 
-declare type UpdateDelta = {
+type UpdateDelta = {
     type: "update";
 } | {
     type: "delete";
@@ -418,20 +471,20 @@ declare type UpdateDelta = {
  *
  */
 
-declare type PlainLsonFields = Record<string, PlainLson>;
-declare type PlainLsonObject = {
+type PlainLsonFields = Record<string, PlainLson>;
+type PlainLsonObject = {
     liveblocksType: "LiveObject";
     data: PlainLsonFields;
 };
-declare type PlainLsonMap = {
+type PlainLsonMap = {
     liveblocksType: "LiveMap";
     data: PlainLsonFields;
 };
-declare type PlainLsonList = {
+type PlainLsonList = {
     liveblocksType: "LiveList";
     data: PlainLson[];
 };
-declare type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | Json;
+type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | Json;
 
 /**
  * Helper type to convert any valid Lson type to the equivalent Json type.
@@ -449,7 +502,7 @@ declare type PlainLson = PlainLsonObject | PlainLsonMap | PlainLsonList | Json;
  *                                           // { readonly a: null, readonly b: readonly string[], readonly c?: number }
  *
  */
-declare type ToImmutable<L extends Lson | LsonObject> = L extends LiveList<infer I> ? readonly ToImmutable<I>[] : L extends LiveObject<infer O> ? ToImmutable<O> : L extends LiveMap<infer K, infer V> ? ReadonlyMap<K, ToImmutable<V>> : L extends LsonObject ? {
+type ToImmutable<L extends Lson | LsonObject> = L extends LiveList<infer I> ? readonly ToImmutable<I>[] : L extends LiveObject<infer O> ? ToImmutable<O> : L extends LiveMap<infer K, infer V> ? ReadonlyMap<K, ToImmutable<V>> : L extends LsonObject ? {
     readonly [K in keyof L]: ToImmutable<Exclude<L[K], undefined>> | (undefined extends L[K] ? undefined : never);
 } : L extends Json ? L : never;
 /**
@@ -461,7 +514,7 @@ declare function toPlainLson(lson: Lson): PlainLson;
  * 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 LiveMapUpdates<TKey extends string, TValue extends Lson> = {
     type: "LiveMap";
     node: LiveMap<TKey, TValue>;
     updates: {
@@ -528,16 +581,16 @@ declare class LiveMap<TKey extends string, TValue extends Lson> extends Abstract
     clone(): LiveMap<TKey, TValue>;
 }
 
-declare type StorageCallback = (updates: StorageUpdate[]) => void;
-declare type LiveMapUpdate = LiveMapUpdates<string, Lson>;
-declare type LiveObjectUpdate = LiveObjectUpdates<LsonObject>;
-declare type LiveListUpdate = LiveListUpdates<Lson>;
+type StorageCallback = (updates: StorageUpdate[]) => void;
+type LiveMapUpdate = LiveMapUpdates<string, Lson>;
+type LiveObjectUpdate = LiveObjectUpdates<LsonObject>;
+type LiveListUpdate = LiveListUpdates<Lson>;
 /**
  * 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 = LiveMapUpdate | LiveObjectUpdate | LiveListUpdate;
+type StorageUpdate = LiveMapUpdate | LiveObjectUpdate | LiveListUpdate;
 
 declare abstract class AbstractCrdt {
     #private;
@@ -553,7 +606,7 @@ declare abstract class AbstractCrdt {
     abstract clone(): Lson;
 }
 
-declare type LiveListUpdateDelta = {
+type LiveListUpdateDelta = {
     type: "insert";
     index: number;
     item: Lson;
@@ -575,7 +628,7 @@ declare type LiveListUpdateDelta = {
  * 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 LiveListUpdates<TItem extends Lson> = {
     type: "LiveList";
     node: LiveList<TItem>;
     updates: LiveListUpdateDelta[];
@@ -694,23 +747,23 @@ declare class LiveRegister<TValue extends Json> extends AbstractCrdt {
     clone(): TValue;
 }
 
-declare type LiveStructure = LiveObject<LsonObject> | LiveList<Lson> | LiveMap<string, Lson>;
+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 | LiveStructure;
+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>;
+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 = {
+type LsonObject = {
     [key: string]: Lson | undefined;
 };
 /**
@@ -729,13 +782,13 @@ declare type LsonObject = {
  *                                      // { a: null, b: string[], c?: number }
  *
  */
-declare type ToJson<T extends Lson | LsonObject> = T extends Json ? T : T extends LsonObject ? {
+type ToJson<T extends Lson | LsonObject> = T extends Json ? T : T extends LsonObject ? {
     [K in keyof T]: ToJson<Exclude<T[K], undefined>> | (undefined extends T[K] ? undefined : never);
 } : T extends LiveList<infer I> ? ToJson<I>[] : T extends LiveObject<infer O> ? ToJson<O> : T extends LiveMap<infer KS, infer V> ? {
     [K in KS]: ToJson<V>;
 } : never;
 
-declare type LiveObjectUpdateDelta<O extends {
+type LiveObjectUpdateDelta<O extends {
     [key: string]: unknown;
 }> = {
     [K in keyof O]?: UpdateDelta | undefined;
@@ -744,7 +797,7 @@ declare type LiveObjectUpdateDelta<O extends {
  * 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 LiveObjectUpdates<TData extends LsonObject> = {
     type: "LiveObject";
     node: LiveObject<TData>;
     updates: LiveObjectUpdateDelta<TData>;
@@ -786,11 +839,11 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     clone(): LiveObject<O>;
 }
 
-declare type DateToString<T> = {
+type DateToString<T> = {
     [P in keyof T]: T[P] extends Date ? string : T[P] extends Date | null ? string | null : T[P] extends Date | undefined ? string | undefined : T[P];
 };
 
-declare type InboxNotificationThreadData = {
+type InboxNotificationThreadData = {
     kind: "thread";
     id: string;
     roomId: string;
@@ -798,7 +851,7 @@ declare type InboxNotificationThreadData = {
     notifiedAt: Date;
     readAt: Date | null;
 };
-declare type InboxNotificationTextMentionData = {
+type InboxNotificationTextMentionData = {
     kind: "textMention";
     id: string;
     roomId: string;
@@ -807,14 +860,14 @@ declare type InboxNotificationTextMentionData = {
     createdBy: string;
     mentionId: string;
 };
-declare type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
-declare type ActivityData = Record<string, string | boolean | number | undefined>;
-declare type InboxNotificationActivity<K extends keyof DAD = keyof DAD> = {
+type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
+type ActivityData = Record<string, string | boolean | number | undefined>;
+type InboxNotificationActivity<K extends keyof DAD = keyof DAD> = {
     id: string;
     createdAt: Date;
     data: DAD[K];
 };
-declare type InboxNotificationCustomData<K extends keyof DAD = keyof DAD> = {
+type InboxNotificationCustomData<K extends keyof DAD = keyof DAD> = {
     kind: K;
     id: string;
     roomId?: string;
@@ -823,24 +876,24 @@ declare type InboxNotificationCustomData<K extends keyof DAD = keyof DAD> = {
     readAt: Date | null;
     activities: InboxNotificationActivity<K>[];
 };
-declare type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData | InboxNotificationTextMentionData;
-declare type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
-declare type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
+type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData | InboxNotificationTextMentionData;
+type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
+type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
     activities: DateToString<InboxNotificationActivity>[];
 };
-declare type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain | InboxNotificationTextMentionDataPlain;
-declare type InboxNotificationDeleteInfo = {
+type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain | InboxNotificationTextMentionDataPlain;
+type InboxNotificationDeleteInfo = {
     type: "deletedInboxNotification";
     id: string;
     roomId: string;
     deletedAt: Date;
 };
 
-declare type BaseActivitiesData = {
+type BaseActivitiesData = {
     [key: `$${string}`]: ActivityData;
 };
 
-declare type BaseRoomInfo = {
+type BaseRoomInfo = {
     [key: string]: Json | undefined;
     /**
      * The name of the room.
@@ -852,22 +905,22 @@ declare type BaseRoomInfo = {
     url?: string;
 };
 
-declare type BaseMetadata = Record<string, string | boolean | number | undefined>;
-declare type CommentReaction = {
+type BaseMetadata = Record<string, string | boolean | number | undefined>;
+type CommentReaction = {
     emoji: string;
     createdAt: Date;
     users: {
         id: string;
     }[];
 };
-declare type CommentAttachment = {
+type CommentAttachment = {
     type: "attachment";
     id: string;
     name: string;
     size: number;
     mimeType: string;
 };
-declare type CommentLocalAttachmentIdle = {
+type CommentLocalAttachmentIdle = {
     type: "localAttachment";
     status: "idle";
     id: string;
@@ -876,7 +929,7 @@ declare type CommentLocalAttachmentIdle = {
     mimeType: string;
     file: File;
 };
-declare type CommentLocalAttachmentUploading = {
+type CommentLocalAttachmentUploading = {
     type: "localAttachment";
     status: "uploading";
     id: string;
@@ -885,7 +938,7 @@ declare type CommentLocalAttachmentUploading = {
     mimeType: string;
     file: File;
 };
-declare type CommentLocalAttachmentUploaded = {
+type CommentLocalAttachmentUploaded = {
     type: "localAttachment";
     status: "uploaded";
     id: string;
@@ -894,7 +947,7 @@ declare type CommentLocalAttachmentUploaded = {
     mimeType: string;
     file: File;
 };
-declare type CommentLocalAttachmentError = {
+type CommentLocalAttachmentError = {
     type: "localAttachment";
     status: "error";
     id: string;
@@ -904,12 +957,12 @@ declare type CommentLocalAttachmentError = {
     file: File;
     error: Error;
 };
-declare type CommentLocalAttachment = CommentLocalAttachmentIdle | CommentLocalAttachmentUploading | CommentLocalAttachmentUploaded | CommentLocalAttachmentError;
-declare type CommentMixedAttachment = CommentAttachment | CommentLocalAttachment;
+type CommentLocalAttachment = CommentLocalAttachmentIdle | CommentLocalAttachmentUploading | CommentLocalAttachmentUploaded | CommentLocalAttachmentError;
+type CommentMixedAttachment = CommentAttachment | CommentLocalAttachment;
 /**
  * Represents a comment.
  */
-declare type CommentData = {
+type CommentData = {
     type: "comment";
     id: string;
     threadId: string;
@@ -919,59 +972,55 @@ declare type CommentData = {
     editedAt?: Date;
     reactions: CommentReaction[];
     attachments: CommentAttachment[];
-} & ({
+} & Relax<{
     body: CommentBody;
-    deletedAt?: never;
 } | {
-    body?: never;
     deletedAt: Date;
-});
-declare type CommentDataPlain = Omit<DateToString<CommentData>, "reactions" | "body"> & {
+}>;
+type CommentDataPlain = Omit<DateToString<CommentData>, "reactions" | "body"> & {
     reactions: DateToString<CommentReaction>[];
-} & ({
+} & Relax<{
     body: CommentBody;
-    deletedAt?: never;
 } | {
-    body?: never;
     deletedAt: string;
-});
-declare type CommentBodyBlockElement = CommentBodyParagraph;
-declare type CommentBodyInlineElement = CommentBodyText | CommentBodyMention | CommentBodyLink;
-declare type CommentBodyElement = CommentBodyBlockElement | CommentBodyInlineElement;
-declare type CommentBodyParagraph = {
+}>;
+type CommentBodyBlockElement = CommentBodyParagraph;
+type CommentBodyInlineElement = CommentBodyText | CommentBodyMention | CommentBodyLink;
+type CommentBodyElement = CommentBodyBlockElement | CommentBodyInlineElement;
+type CommentBodyParagraph = {
     type: "paragraph";
     children: CommentBodyInlineElement[];
 };
-declare type CommentBodyMention = {
+type CommentBodyMention = {
     type: "mention";
     id: string;
 };
-declare type CommentBodyLink = {
+type CommentBodyLink = {
     type: "link";
     url: string;
     text?: string;
 };
-declare type CommentBodyText = {
+type CommentBodyText = {
     bold?: boolean;
     italic?: boolean;
     strikethrough?: boolean;
     code?: boolean;
     text: string;
 };
-declare type CommentBody = {
+type CommentBody = {
     version: 1;
     content: CommentBodyBlockElement[];
 };
-declare type CommentUserReaction = {
+type CommentUserReaction = {
     emoji: string;
     createdAt: Date;
     userId: string;
 };
-declare type CommentUserReactionPlain = DateToString<CommentUserReaction>;
+type CommentUserReactionPlain = DateToString<CommentUserReaction>;
 /**
  * Represents a thread of comments.
  */
-declare type ThreadData<M extends BaseMetadata = DM> = {
+type ThreadData<M extends BaseMetadata = DM> = {
     type: "thread";
     id: string;
     roomId: string;
@@ -984,17 +1033,17 @@ declare type ThreadData<M extends BaseMetadata = DM> = {
 interface ThreadDataWithDeleteInfo<M extends BaseMetadata = DM> extends ThreadData<M> {
     deletedAt?: Date;
 }
-declare type ThreadDataPlain<M extends BaseMetadata> = Omit<DateToString<ThreadData<M>>, "comments" | "metadata"> & {
+type ThreadDataPlain<M extends BaseMetadata> = Omit<DateToString<ThreadData<M>>, "comments" | "metadata"> & {
     comments: CommentDataPlain[];
     metadata: M;
 };
-declare type ThreadDeleteInfo = {
+type ThreadDeleteInfo = {
     type: "deletedThread";
     id: string;
     roomId: string;
     deletedAt: Date;
 };
-declare type StringOperators<T> = T | {
+type StringOperators<T> = T | {
     startsWith: string;
 };
 /**
@@ -1005,8 +1054,8 @@ declare type StringOperators<T> = T | {
  * - to strings:
  *  - `startsWith` (`^` in query string)
  */
-declare type QueryMetadata<M extends BaseMetadata> = {
-    [K in keyof M]: string extends M[K] ? StringOperators<M[K]> : M[K];
+type QueryMetadata<M extends BaseMetadata> = {
+    [K in keyof M]: (string extends M[K] ? StringOperators<M[K]> : M[K]) | null;
 };
 
 declare global {
@@ -1017,20 +1066,20 @@ declare global {
         [key: string]: unknown;
     }
 }
-declare type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
-declare type MakeErrorString<K extends ExtendableTypes, Reason extends string = "does not match its requirements"> = `The type you provided for '${K}' ${Reason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
-declare type GetOverride<K extends ExtendableTypes, B, Reason extends string = "does not match its requirements"> = GetOverrideOrErrorValue<K, B, MakeErrorString<K, Reason>>;
-declare type GetOverrideOrErrorValue<K extends ExtendableTypes, B, ErrorType> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : ErrorType;
-declare type DP = GetOverride<"Presence", JsonObject, "is not a valid JSON object">;
-declare type DS = GetOverride<"Storage", LsonObject, "is not a valid LSON value">;
-declare type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info", MakeErrorString<"UserMeta">>>;
-declare type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
-declare type DM = GetOverride<"ThreadMetadata", BaseMetadata>;
-declare type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
-declare type DAD = GetOverrideOrErrorValue<"ActivitiesData", BaseActivitiesData, {
+type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
+type MakeErrorString<K extends ExtendableTypes, Reason extends string = "does not match its requirements"> = `The type you provided for '${K}' ${Reason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
+type GetOverride<K extends ExtendableTypes, B, Reason extends string = "does not match its requirements"> = GetOverrideOrErrorValue<K, B, MakeErrorString<K, Reason>>;
+type GetOverrideOrErrorValue<K extends ExtendableTypes, B, ErrorType> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : ErrorType;
+type DP = GetOverride<"Presence", JsonObject, "is not a valid JSON object">;
+type DS = GetOverride<"Storage", LsonObject, "is not a valid LSON value">;
+type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info", MakeErrorString<"UserMeta">>>;
+type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
+type DM = GetOverride<"ThreadMetadata", BaseMetadata>;
+type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
+type DAD = GetOverrideOrErrorValue<"ActivitiesData", BaseActivitiesData, {
     [K in keyof Liveblocks["ActivitiesData"]]: "At least one of the custom notification kinds you provided for 'ActivitiesData' does not match its requirements. To learn how to fix this, see https://liveblocks.io/docs/errors/ActivitiesData";
 }>;
-declare type KDAD = keyof DAD extends `$${string}` ? keyof DAD : "Custom notification kinds must start with '$' but your custom 'ActivitiesData' type contains at least one kind which doesn't. To learn how to fix this, see https://liveblocks.io/docs/errors/ActivitiesData";
+type KDAD = keyof DAD extends `$${string}` ? keyof DAD : "Custom notification kinds must start with '$' but your custom 'ActivitiesData' type contains at least one kind which doesn't. To learn how to fix this, see https://liveblocks.io/docs/errors/ActivitiesData";
 
 /**
  * Use this symbol to brand an object property as internal.
@@ -1051,29 +1100,30 @@ declare type KDAD = keyof DAD extends `$${string}` ? keyof DAD : "Custom notific
  */
 declare const kInternal: unique symbol;
 
-declare type RenameDataField<T, TFieldName extends string> = T extends any ? {
+type RenameDataField<T, TFieldName extends string> = T extends any ? {
     [K in keyof T as K extends "data" ? TFieldName : K]: T[K];
 } : never;
-declare type AsyncLoading<F extends string = "data"> = RenameDataField<{
+type AsyncLoading<F extends string = "data"> = RenameDataField<{
     readonly isLoading: true;
     readonly data?: never;
     readonly error?: never;
 }, F>;
-declare type AsyncSuccess<T, F extends string = "data"> = RenameDataField<{
+type AsyncSuccess<T, F extends string = "data"> = RenameDataField<{
     readonly isLoading: false;
     readonly data: T;
     readonly error?: never;
 }, F>;
-declare type AsyncError<F extends string = "data"> = RenameDataField<{
+type AsyncError<F extends string = "data"> = RenameDataField<{
     readonly isLoading: false;
     readonly data?: never;
     readonly error: Error;
 }, F>;
-declare type AsyncResult<T, F extends string = "data"> = AsyncLoading<F> | AsyncSuccess<T, F> | AsyncError<F>;
+type AsyncResult<T, F extends string = "data"> = AsyncLoading<F> | AsyncSuccess<T, F> | AsyncError<F>;
 
-declare type BatchStore<O, I> = Observable<void> & {
-    get: (input: I) => Promise<void>;
-    getState: (input: I) => AsyncResult<O> | undefined;
+type BatchStore<O, I> = {
+    subscribe: (callback: Callback<void>) => UnsubscribeCallback;
+    enqueue: (input: I) => Promise<void>;
+    getItemState: (input: I) => AsyncResult<O> | undefined;
     invalidate: (inputs?: I[]) => void;
 };
 
@@ -1088,12 +1138,12 @@ declare enum ClientMsgCode {
 /**
  * Messages that can be sent from the client to the server.
  */
-declare type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg;
-declare type BroadcastEventClientMsg<E extends Json> = {
+type ClientMsg<P extends JsonObject, E extends Json> = BroadcastEventClientMsg<E> | UpdatePresenceClientMsg<P> | UpdateStorageClientMsg | FetchStorageClientMsg | FetchYDocClientMsg | UpdateYDocClientMsg;
+type BroadcastEventClientMsg<E extends Json> = {
     type: ClientMsgCode.BROADCAST_EVENT;
     event: E;
 };
-declare type UpdatePresenceClientMsg<P extends JsonObject> = {
+type UpdatePresenceClientMsg<P extends JsonObject> = {
     readonly type: ClientMsgCode.UPDATE_PRESENCE;
     /**
      * Set this to any number to signify that this is a Full Presence™
@@ -1119,56 +1169,56 @@ declare type UpdatePresenceClientMsg<P extends JsonObject> = {
     readonly targetActor?: undefined;
     readonly data: Partial<P>;
 };
-declare type UpdateStorageClientMsg = {
+type UpdateStorageClientMsg = {
     readonly type: ClientMsgCode.UPDATE_STORAGE;
     readonly ops: Op[];
 };
-declare type FetchStorageClientMsg = {
+type FetchStorageClientMsg = {
     readonly type: ClientMsgCode.FETCH_STORAGE;
 };
-declare type FetchYDocClientMsg = {
+type FetchYDocClientMsg = {
     readonly type: ClientMsgCode.FETCH_YDOC;
     readonly vector: string;
     readonly guid?: string;
 };
-declare type UpdateYDocClientMsg = {
+type UpdateYDocClientMsg = {
     readonly type: ClientMsgCode.UPDATE_YDOC;
     readonly update: string;
     readonly guid?: string;
 };
 
-declare type IdTuple<T> = [id: string, value: T];
+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 SerializedCrdt = SerializedRootObject | SerializedChild;
+type SerializedChild = SerializedObject | SerializedList | SerializedMap | SerializedRegister;
+type SerializedRootObject = {
     readonly type: CrdtType.OBJECT;
     readonly data: JsonObject;
     readonly parentId?: never;
     readonly parentKey?: never;
 };
-declare type SerializedObject = {
+type SerializedObject = {
     readonly type: CrdtType.OBJECT;
     readonly parentId: string;
     readonly parentKey: string;
     readonly data: JsonObject;
 };
-declare type SerializedList = {
+type SerializedList = {
     readonly type: CrdtType.LIST;
     readonly parentId: string;
     readonly parentKey: string;
 };
-declare type SerializedMap = {
+type SerializedMap = {
     readonly type: CrdtType.MAP;
     readonly parentId: string;
     readonly parentKey: string;
 };
-declare type SerializedRegister = {
+type SerializedRegister = {
     readonly type: CrdtType.REGISTER;
     readonly parentId: string;
     readonly parentKey: string;
@@ -1200,46 +1250,46 @@ declare enum ServerMsgCode {
 /**
  * Messages that can be sent from the server to the client.
  */
-declare type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | InitialDocumentStateServerMsg | UpdateStorageServerMsg | RejectedStorageOpServerMsg | YDocUpdateServerMsg | CommentsEventServerMsg;
-declare type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved;
-declare type ThreadCreatedEvent = {
+type ServerMsg<P extends JsonObject, U extends BaseUserMeta, E extends Json> = UpdatePresenceServerMsg<P> | UserJoinServerMsg<U> | UserLeftServerMsg | BroadcastedEventServerMsg<E> | RoomStateServerMsg<U> | InitialDocumentStateServerMsg | UpdateStorageServerMsg | RejectedStorageOpServerMsg | YDocUpdateServerMsg | CommentsEventServerMsg;
+type CommentsEventServerMsg = ThreadCreatedEvent | ThreadDeletedEvent | ThreadMetadataUpdatedEvent | ThreadUpdatedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved;
+type ThreadCreatedEvent = {
     type: ServerMsgCode.THREAD_CREATED;
     threadId: string;
 };
-declare type ThreadDeletedEvent = {
+type ThreadDeletedEvent = {
     type: ServerMsgCode.THREAD_DELETED;
     threadId: string;
 };
-declare type ThreadMetadataUpdatedEvent = {
+type ThreadMetadataUpdatedEvent = {
     type: ServerMsgCode.THREAD_METADATA_UPDATED;
     threadId: string;
 };
-declare type ThreadUpdatedEvent = {
+type ThreadUpdatedEvent = {
     type: ServerMsgCode.THREAD_UPDATED;
     threadId: string;
 };
-declare type CommentCreatedEvent = {
+type CommentCreatedEvent = {
     type: ServerMsgCode.COMMENT_CREATED;
     threadId: string;
     commentId: string;
 };
-declare type CommentEditedEvent = {
+type CommentEditedEvent = {
     type: ServerMsgCode.COMMENT_EDITED;
     threadId: string;
     commentId: string;
 };
-declare type CommentDeletedEvent = {
+type CommentDeletedEvent = {
     type: ServerMsgCode.COMMENT_DELETED;
     threadId: string;
     commentId: string;
 };
-declare type CommentReactionAdded = {
+type CommentReactionAdded = {
     type: ServerMsgCode.COMMENT_REACTION_ADDED;
     threadId: string;
     commentId: string;
     emoji: string;
 };
-declare type CommentReactionRemoved = {
+type CommentReactionRemoved = {
     type: ServerMsgCode.COMMENT_REACTION_REMOVED;
     threadId: string;
     commentId: string;
@@ -1256,7 +1306,7 @@ declare type CommentReactionRemoved = {
  * those cases, the `targetActor` field indicates the newly connected client,
  * so all other existing clients can ignore this broadcasted message.
  */
-declare type UpdatePresenceServerMsg<P extends JsonObject> = {
+type UpdatePresenceServerMsg<P extends JsonObject> = {
     readonly type: ServerMsgCode.UPDATE_PRESENCE;
     /**
      * The User whose Presence has changed.
@@ -1301,7 +1351,7 @@ declare type UpdatePresenceServerMsg<P extends JsonObject> = {
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a new User has joined the Room.
  */
-declare type UserJoinServerMsg<U extends BaseUserMeta> = {
+type UserJoinServerMsg<U extends BaseUserMeta> = {
     readonly type: ServerMsgCode.USER_JOINED;
     readonly actor: number;
     /**
@@ -1323,7 +1373,7 @@ declare type UserJoinServerMsg<U extends BaseUserMeta> = {
  * Sent by the WebSocket server and broadcasted to all clients to announce that
  * a new User has left the Room.
  */
-declare type UserLeftServerMsg = {
+type UserLeftServerMsg = {
     readonly type: ServerMsgCode.USER_LEFT;
     readonly actor: number;
 };
@@ -1331,7 +1381,7 @@ declare type UserLeftServerMsg = {
  * Sent by the WebSocket server when the ydoc is updated or when requested based on stateVector passed.
  * Contains a base64 encoded update
  */
-declare type YDocUpdateServerMsg = {
+type YDocUpdateServerMsg = {
     readonly type: ServerMsgCode.UPDATE_YDOC;
     readonly update: string;
     readonly isSync: boolean;
@@ -1342,7 +1392,7 @@ declare type YDocUpdateServerMsg = {
  * 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 BroadcastedEventServerMsg<E extends Json> = {
+type BroadcastedEventServerMsg<E extends Json> = {
     readonly type: ServerMsgCode.BROADCASTED_EVENT;
     /**
      * The User who broadcast the Event. Absent when this event is broadcast from
@@ -1360,7 +1410,7 @@ declare type BroadcastedEventServerMsg<E extends Json> = {
  * 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 RoomStateServerMsg<U extends BaseUserMeta> = {
+type RoomStateServerMsg<U extends BaseUserMeta> = {
     readonly type: ServerMsgCode.ROOM_STATE;
     /**
      * Informs the client what their actor ID is going to be.
@@ -1388,7 +1438,7 @@ declare type RoomStateServerMsg<U extends BaseUserMeta> = {
  * joining the Room, to provide the initial Storage state of the Room. The
  * payload includes the entire Storage document.
  */
-declare type InitialDocumentStateServerMsg = {
+type InitialDocumentStateServerMsg = {
     readonly type: ServerMsgCode.INITIAL_STORAGE_STATE;
     readonly items: IdTuple<SerializedCrdt>[];
 };
@@ -1399,7 +1449,7 @@ declare type InitialDocumentStateServerMsg = {
  * The payload of this message contains a list of Ops (aka incremental
  * mutations to make to the initially loaded document).
  */
-declare type UpdateStorageServerMsg = {
+type UpdateStorageServerMsg = {
     readonly type: ServerMsgCode.UPDATE_STORAGE;
     readonly ops: Op[];
 };
@@ -1408,13 +1458,13 @@ declare type UpdateStorageServerMsg = {
  * have been received but were rejected because they caused mutations that are
  * incompatible with the Room's schema.
  */
-declare type RejectedStorageOpServerMsg = {
+type RejectedStorageOpServerMsg = {
     readonly type: ServerMsgCode.REJECT_STORAGE_OP;
     readonly opIds: string[];
     readonly reason: string;
 };
 
-declare type HistoryVersion = {
+type HistoryVersion = {
     type: "historyVersion";
     kind: "yjs";
     createdAt: Date;
@@ -1424,20 +1474,20 @@ declare type HistoryVersion = {
     }[];
 };
 
-declare type JsonTreeNode = {
+type JsonTreeNode = {
     readonly type: "Json";
     readonly id: string;
     readonly key: string;
     readonly payload: Json;
 };
-declare type LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = {
+type LiveTreeNode<TName extends `Live${string}` = `Live${string}`> = {
     readonly type: TName;
     readonly id: string;
     readonly key: string;
     readonly payload: LsonTreeNode[];
 };
-declare type LsonTreeNode = LiveTreeNode | JsonTreeNode;
-declare type UserTreeNode = {
+type LsonTreeNode = LiveTreeNode | JsonTreeNode;
+type UserTreeNode = {
     readonly type: "User";
     readonly id: string;
     readonly key: string;
@@ -1449,14 +1499,14 @@ declare type UserTreeNode = {
         readonly isReadOnly: boolean;
     };
 };
-declare type CustomEventTreeNode = {
+type CustomEventTreeNode = {
     readonly type: "CustomEvent";
     readonly id: string;
     readonly key: string;
     readonly connectionId: number;
     readonly payload: Json;
 };
-declare type TreeNode = LsonTreeNode | UserTreeNode | CustomEventTreeNode;
+type TreeNode = LsonTreeNode | UserTreeNode | CustomEventTreeNode;
 
 type DevToolsTreeNode_CustomEventTreeNode = CustomEventTreeNode;
 type DevToolsTreeNode_JsonTreeNode = JsonTreeNode;
@@ -1468,36 +1518,88 @@ declare namespace DevToolsTreeNode {
   export type { DevToolsTreeNode_CustomEventTreeNode as CustomEventTreeNode, DevToolsTreeNode_JsonTreeNode as JsonTreeNode, DevToolsTreeNode_LiveTreeNode as LiveTreeNode, DevToolsTreeNode_LsonTreeNode as LsonTreeNode, DevToolsTreeNode_TreeNode as TreeNode, DevToolsTreeNode_UserTreeNode as UserTreeNode };
 }
 
-/**
- * This helper type is effectively a no-op, but will force TypeScript to
- * "evaluate" any named helper types in its definition. This can sometimes make
- * API signatures clearer in IDEs.
- *
- * For example, in:
- *
- *   type Payload<T> = { data: T };
- *
- *   let r1: Payload<string>;
- *   let r2: Resolve<Payload<string>>;
- *
- * The inferred type of `r1` is going to be `Payload<string>` which shows up in
- * editor hints, and it may be unclear what's inside if you don't know the
- * definition of `Payload`.
- *
- * The inferred type of `r2` is going to be `{ data: string }`, which may be
- * more helpful.
- *
- * This trick comes from:
- * https://effectivetypescript.com/2022/02/25/gentips-4-display/
- */
-declare type Resolve<T> = T extends (...args: unknown[]) => unknown ? T : {
-    [K in keyof T]: T[K];
+type OptionalKeys<T> = {
+    [K in keyof T]-?: undefined extends T[K] ? K : never;
+}[keyof T];
+type MakeOptionalFieldsNullable<T> = {
+    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
 };
+type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
+
+type RoomConnectionErrorContext = {
+    type: "ROOM_CONNECTION_ERROR";
+    code: -1 | 4001 | 4005 | 4006 | (number & {});
+    roomId: string;
+};
+type CommentsOrNotificationsErrorContext = {
+    type: "CREATE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+    metadata: BaseMetadata;
+} | {
+    type: "DELETE_THREAD_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "EDIT_THREAD_METADATA_ERROR";
+    roomId: string;
+    threadId: string;
+    metadata: Patchable<BaseMetadata>;
+} | {
+    type: "MARK_THREAD_AS_RESOLVED_ERROR" | "MARK_THREAD_AS_UNRESOLVED_ERROR";
+    roomId: string;
+    threadId: string;
+} | {
+    type: "CREATE_COMMENT_ERROR" | "EDIT_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    body: CommentBody;
+} | {
+    type: "DELETE_COMMENT_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+} | {
+    type: "ADD_REACTION_ERROR" | "REMOVE_REACTION_ERROR";
+    roomId: string;
+    threadId: string;
+    commentId: string;
+    emoji: string;
+} | {
+    type: "MARK_INBOX_NOTIFICATION_AS_READ_ERROR";
+    inboxNotificationId: string;
+    roomId?: string;
+} | {
+    type: "DELETE_INBOX_NOTIFICATION_ERROR";
+    inboxNotificationId: string;
+} | {
+    type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" | "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR";
+} | {
+    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
+    roomId: string;
+};
+type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext>;
+declare class LiveblocksError extends Error {
+    readonly context: LiveblocksErrorContext;
+    constructor(message: string, context: LiveblocksErrorContext, cause?: Error);
+    /** Convenience accessor for error.context.roomId (if available) */
+    get roomId(): LiveblocksErrorContext["roomId"];
+    /** @deprecated Prefer using `context.code` instead, to enable type narrowing */
+    get code(): LiveblocksErrorContext["code"];
+    /**
+     * Creates a LiveblocksError from a generic error, by attaching Liveblocks
+     * contextual information like room ID, thread ID, etc.
+     */
+    static from(context: LiveblocksErrorContext, cause?: Error): LiveblocksError;
+}
 
 /**
  * Represents a user connected in a room. Treated as immutable.
  */
-declare type User<P extends JsonObject = DP, U extends BaseUserMeta = DU> = {
+type User<P extends JsonObject = DP, U extends BaseUserMeta = DU> = {
     /**
      * The connection ID of the User. It is unique and increment at every new connection.
      */
@@ -1526,7 +1628,7 @@ declare type User<P extends JsonObject = DP, U extends BaseUserMeta = DU> = {
     readonly canComment: boolean;
 };
 
-declare type InternalOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
+type InternalOthersEvent<P extends JsonObject, U extends BaseUserMeta> = Relax<{
     type: "leave";
     user: User<P, U>;
 } | {
@@ -1538,9 +1640,8 @@ declare type InternalOthersEvent<P extends JsonObject, U extends BaseUserMeta> =
     updates: Partial<P>;
 } | {
     type: "reset";
-    user?: never;
-};
-declare type OthersEvent<P extends JsonObject = DP, U extends BaseUserMeta = DU> = Resolve<InternalOthersEvent<P, U> & {
+}>;
+type OthersEvent<P extends JsonObject = DP, U extends BaseUserMeta = DU> = Resolve<InternalOthersEvent<P, U> & {
     others: readonly User<P, U>[];
 }>;
 declare enum TextEditorType {
@@ -1548,20 +1649,12 @@ declare enum TextEditorType {
     TipTap = "tiptap"
 }
 
-declare type OptionalKeys<T> = {
-    [K in keyof T]-?: undefined extends T[K] ? K : never;
-}[keyof T];
-declare type MakeOptionalFieldsNullable<T> = {
-    [K in keyof T]: K extends OptionalKeys<T> ? T[K] | null : T[K];
-};
-declare type Patchable<T> = Partial<MakeOptionalFieldsNullable<T>>;
-
-declare type RoomThreadsNotificationSettings = "all" | "replies_and_mentions" | "none";
-declare type RoomNotificationSettings = {
+type RoomThreadsNotificationSettings = "all" | "replies_and_mentions" | "none";
+type RoomNotificationSettings = {
     threads: RoomThreadsNotificationSettings;
 };
 
-declare type LegacyOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
+type LegacyOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
     type: "leave";
     user: User<P, U>;
 } | {
@@ -1574,8 +1667,8 @@ declare type LegacyOthersEvent<P extends JsonObject, U extends BaseUserMeta> = {
 } | {
     type: "reset";
 };
-declare type LegacyOthersEventCallback<P extends JsonObject, U extends BaseUserMeta> = (others: readonly User<P, U>[], event: LegacyOthersEvent<P, U>) => void;
-declare type RoomEventMessage<P extends JsonObject, U extends BaseUserMeta, E extends Json> = {
+type LegacyOthersEventCallback<P extends JsonObject, U extends BaseUserMeta> = (others: readonly User<P, U>[], event: LegacyOthersEvent<P, U>) => void;
+type RoomEventMessage<P extends JsonObject, U extends BaseUserMeta, E extends Json> = {
     /**
      * The connection ID of the client that sent the event.
      * If this message was broadcast from the server (via the REST API), then
@@ -1590,7 +1683,7 @@ declare type RoomEventMessage<P extends JsonObject, U extends BaseUserMeta, E ex
     user: User<P, U> | null;
     event: E;
 };
-declare type StorageStatus = "not-loaded" | "loading" | "synchronizing" | "synchronized";
+type StorageStatus = "not-loaded" | "loading" | "synchronizing" | "synchronized";
 interface History {
     /**
      * Undoes the last operation executed by the current client.
@@ -1668,11 +1761,11 @@ interface History {
      */
     resume: () => void;
 }
-declare type HistoryEvent = {
+type HistoryEvent = {
     canUndo: boolean;
     canRedo: boolean;
 };
-declare type BroadcastOptions = {
+type BroadcastOptions = {
     /**
      * Whether or not event is queued if the connection is currently closed.
      *
@@ -1680,7 +1773,7 @@ declare type BroadcastOptions = {
      */
     shouldQueueEventIfNotReady: boolean;
 };
-declare type SubscribeFn<P extends JsonObject, _TStorage extends LsonObject, U extends BaseUserMeta, E extends Json> = {
+type SubscribeFn<P extends JsonObject, _TStorage extends LsonObject, U extends BaseUserMeta, E extends Json> = {
     /**
      * Subscribe to the current user presence updates.
      *
@@ -1813,25 +1906,25 @@ declare type SubscribeFn<P extends JsonObject, _TStorage extends LsonObject, U e
     (type: "storage-status", listener: Callback<StorageStatus>): () => void;
     (type: "comments", listener: Callback<CommentsEventServerMsg>): () => void;
 };
-declare type GetThreadsOptions<M extends BaseMetadata> = {
+type GetThreadsOptions<M extends BaseMetadata> = {
     cursor?: string;
     query?: {
         resolved?: boolean;
         metadata?: Partial<QueryMetadata<M>>;
     };
 };
-declare type GetThreadsSinceOptions = {
+type GetThreadsSinceOptions = {
     since: Date;
     signal?: AbortSignal;
 };
-declare type UploadAttachmentOptions = {
+type UploadAttachmentOptions = {
     signal?: AbortSignal;
 };
-declare type ListTextVersionsSinceOptions = {
+type ListTextVersionsSinceOptions = {
     since: Date;
     signal?: AbortSignal;
 };
-declare type GetNotificationSettingsOptions = {
+type GetNotificationSettingsOptions = {
     signal?: AbortSignal;
 };
 /**
@@ -1839,8 +1932,8 @@ declare type GetNotificationSettingsOptions = {
  * this type is different from `Room`-without-type-arguments. That represents
  * a Room instance using globally augmented types only, which is narrower.
  */
-declare type OpaqueRoom = Room<JsonObject, LsonObject, BaseUserMeta, Json, BaseMetadata>;
-declare type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, M extends BaseMetadata = DM> = {
+type OpaqueRoom = Room<JsonObject, LsonObject, BaseUserMeta, Json, BaseMetadata>;
+type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUserMeta = DU, E extends Json = DE, M extends BaseMetadata = DM> = {
     /**
      * @private
      *
@@ -1960,7 +2053,6 @@ declare type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extend
         readonly self: Observable<User<P, U>>;
         readonly myPresence: Observable<P>;
         readonly others: Observable<OthersEvent<P, U>>;
-        readonly error: Observable<LiveblocksError>;
         /**
          * @deprecated Renamed to `storageBatch`. The `storage` event source will
          * soon be replaced by another/incompatible API.
@@ -2254,7 +2346,7 @@ declare type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extend
      */
     markInboxNotificationAsRead(notificationId: string): Promise<void>;
 };
-declare type YjsSyncStatus = "loading" | "synchronizing" | "synchronized";
+type YjsSyncStatus = "loading" | "synchronizing" | "synchronized";
 /**
  * Interface that @liveblocks/yjs must respect.
  * This interface type is declare in @liveblocks/core, so we don't have to
@@ -2287,7 +2379,7 @@ interface SyncSource {
  * Liveblocks, NEVER USE ANY OF THESE METHODS DIRECTLY, because bad things
  * will probably happen if you do.
  */
-declare type PrivateRoomApi = {
+type PrivateRoomApi = {
     presenceBuffer: Json | undefined;
     undoStack: readonly (readonly Readonly<HistoryOp<JsonObject>>[])[];
     nodeCount: number;
@@ -2315,11 +2407,11 @@ declare type PrivateRoomApi = {
     };
     attachmentUrlsStore: BatchStore<string, string>;
 };
-declare type HistoryOp<P extends JsonObject> = Op | {
+type HistoryOp<P extends JsonObject> = Op | {
     readonly type: "presence";
     readonly data: P;
 };
-declare type Polyfills = {
+type Polyfills = {
     atob?: (data: string) => string;
     fetch?: typeof fetch;
     WebSocket?: IWebSocket;
@@ -2331,19 +2423,19 @@ declare type Polyfills = {
  * into:
  *   [foo?: string; bar?: number]
  */
-declare type OptionalTuple<T extends any[]> = {
+type OptionalTuple<T extends any[]> = {
     [K in keyof T]?: T[K];
 };
 /**
  * Returns Partial<T> if all fields on C are optional, T otherwise.
  */
-declare type PartialUnless<C, T> = Record<string, never> extends C ? Partial<T> : [
+type PartialUnless<C, T> = Record<string, never> extends C ? Partial<T> : [
     C
 ] extends [never] ? Partial<T> : T;
 /**
  * Returns OptionalTupleUnless<T> if all fields on C are optional, T otherwise.
  */
-declare type OptionalTupleUnless<C, T extends any[]> = Record<string, never> extends C ? OptionalTuple<T> : [
+type OptionalTupleUnless<C, T extends any[]> = Record<string, never> extends C ? OptionalTuple<T> : [
     C
 ] extends [never] ? OptionalTuple<T> : T;
 
@@ -2587,7 +2679,7 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
  * Back-port of TypeScript 5.4's built-in NoInfer utility type.
  * See https://stackoverflow.com/a/56688073/148872
  */
-declare type NoInfr<A> = [A][A extends any ? 0 : never];
+type NoInfr<A> = [A][A extends any ? 0 : never];
 
 declare const kTrigger: unique symbol;
 /**
@@ -2597,7 +2689,7 @@ declare const kTrigger: unique symbol;
  * Nesting batches is supported.
  */
 declare function batch(callback: Callback<void>): void;
-declare type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
+type SignalType<S extends ISignal<any>> = S extends ISignal<infer T> ? T : never;
 interface ISignal<T> {
     get(): T;
     subscribe(callback: Callback<void>): UnsubscribeCallback;
@@ -2631,10 +2723,10 @@ declare class Signal<T> extends AbstractSignal<T> {
 }
 declare class DerivedSignal<T> extends AbstractSignal<T> {
     #private;
-    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+    static from<Ts extends unknown[], V>(...args: [...signals: {
         [K in keyof Ts]: ISignal<Ts[K]>;
     }, transform: (...values: Ts) => V]): DerivedSignal<V>;
-    static from<Ts extends [unknown, ...unknown[]], V>(...args: [...signals: {
+    static from<Ts extends unknown[], V>(...args: [...signals: {
         [K in keyof Ts]: ISignal<Ts[K]>;
     }, transform: (...values: Ts) => V, equals: (a: V, b: V) => boolean]): DerivedSignal<V>;
     private constructor();
@@ -2673,9 +2765,9 @@ declare class MutableSignal<T extends object> extends AbstractSignal<T> {
     mutate(callback?: (state: T) => void | boolean): void;
 }
 
-declare type OptionalPromise<T> = T | Promise<T>;
+type OptionalPromise<T> = T | Promise<T>;
 
-declare type ResolveMentionSuggestionsArgs = {
+type ResolveMentionSuggestionsArgs = {
     /**
      * The ID of the current room.
      */
@@ -2685,19 +2777,19 @@ declare type ResolveMentionSuggestionsArgs = {
      */
     text: string;
 };
-declare type ResolveUsersArgs = {
+type ResolveUsersArgs = {
     /**
      * The IDs of the users to resolve.
      */
     userIds: string[];
 };
-declare type ResolveRoomsInfoArgs = {
+type ResolveRoomsInfoArgs = {
     /**
      * The IDs of the rooms to resolve.
      */
     roomIds: string[];
 };
-declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS> = Resolve<{
+type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS> = Resolve<{
     /**
      * Whether or not the room automatically connects to Liveblock servers.
      * Default is true.
@@ -2718,7 +2810,7 @@ declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS>
      */
     initialStorage: S | ((roomId: string) => S);
 }>>;
-declare type SyncStatus = "synchronizing" | "synchronized";
+type SyncStatus = "synchronizing" | "synchronized";
 /**
  * "synchronizing"     - Liveblocks is in the process of writing changes
  * "synchronized"      - Liveblocks has persisted all pending changes
@@ -2726,7 +2818,7 @@ declare type SyncStatus = "synchronizing" | "synchronized";
  *                       we're not yet "synchronizing" it until a user
  *                       interaction, like the draft text in a comment box.
  */
-declare type InternalSyncStatus = SyncStatus | "has-local-changes";
+type InternalSyncStatus = SyncStatus | "has-local-changes";
 /**
  * @private
  *
@@ -2734,7 +2826,7 @@ declare type InternalSyncStatus = SyncStatus | "has-local-changes";
  * of Liveblocks, NEVER USE ANY OF THESE DIRECTLY, because bad things
  * will probably happen if you do.
  */
-declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
+type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly currentUserId: Signal<string | undefined>;
     readonly mentionSuggestionsCache: Map<string, string[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
@@ -2744,8 +2836,9 @@ declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> =
     readonly httpClient: LiveblocksHttpApi<M>;
     as<M2 extends BaseMetadata>(): Client<U, M2>;
     createSyncSource(): SyncSource;
+    emitError(context: LiveblocksErrorContext, cause?: Error): void;
 };
-declare type NotificationsApi<M extends BaseMetadata> = {
+type NotificationsApi<M extends BaseMetadata> = {
     /**
      * Gets a page (or the initial page) for user inbox notifications and their
      * associated threads.
@@ -2846,8 +2939,8 @@ declare type NotificationsApi<M extends BaseMetadata> = {
  * represents a Client instance using globally augmented types only, which is
  * narrower.
  */
-declare type OpaqueClient = Client<BaseUserMeta>;
-declare type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
+type OpaqueClient = Client<BaseUserMeta>;
+type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
     /**
      * Gets a room. Returns null if {@link Client.enter} has not been called previously.
      *
@@ -2936,20 +3029,18 @@ declare type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> =
     getSyncStatus(): SyncStatus;
     /**
      * All possible client events, subscribable from a single place.
-     *
-     * @private These event sources are private for now, but will become public
-     * once they're stable.
      */
     readonly events: {
+        readonly error: Observable<LiveblocksError>;
         readonly syncStatus: Observable<void>;
     };
 } & NotificationsApi<M>;
-declare type AuthEndpoint = string | ((room?: string) => Promise<CustomAuthenticationResult>);
+type AuthEndpoint = string | ((room?: string) => Promise<CustomAuthenticationResult>);
 /**
  * The authentication endpoint that is called to ensure that the current user has access to a room.
  * Can be an url or a callback if you need to add additional headers.
  */
-declare type ClientOptions<U extends BaseUserMeta = DU> = {
+type ClientOptions<U extends BaseUserMeta = DU> = {
     throttle?: number;
     lostConnectionTimeout?: number;
     backgroundKeepAliveTimeout?: number;
@@ -2976,13 +3067,11 @@ declare type ClientOptions<U extends BaseUserMeta = DU> = {
      * the server yet.
      */
     preventUnsavedChanges?: boolean;
-} & ({
+} & Relax<{
     publicApiKey: string;
-    authEndpoint?: never;
 } | {
-    publicApiKey?: never;
     authEndpoint: AuthEndpoint;
-});
+}>;
 /**
  * Create a client that will be responsible to communicate with liveblocks servers.
  *
@@ -3010,7 +3099,7 @@ declare type ClientOptions<U extends BaseUserMeta = DU> = {
  */
 declare function createClient<U extends BaseUserMeta = DU>(options: ClientOptions<U>): Client<U>;
 
-declare type CommentBodyParagraphElementArgs = {
+type CommentBodyParagraphElementArgs = {
     /**
      * The paragraph element.
      */
@@ -3020,13 +3109,13 @@ declare type CommentBodyParagraphElementArgs = {
      */
     children: string;
 };
-declare type CommentBodyTextElementArgs = {
+type CommentBodyTextElementArgs = {
     /**
      * The text element.
      */
     element: CommentBodyText;
 };
-declare type CommentBodyLinkElementArgs = {
+type CommentBodyLinkElementArgs = {
     /**
      * The link element.
      */
@@ -3036,7 +3125,7 @@ declare type CommentBodyLinkElementArgs = {
      */
     href: string;
 };
-declare type CommentBodyMentionElementArgs<U extends BaseUserMeta = DU> = {
+type CommentBodyMentionElementArgs<U extends BaseUserMeta = DU> = {
     /**
      * The mention element.
      */
@@ -3046,7 +3135,7 @@ declare type CommentBodyMentionElementArgs<U extends BaseUserMeta = DU> = {
      */
     user?: U["info"];
 };
-declare type StringifyCommentBodyElements<U extends BaseUserMeta = DU> = {
+type StringifyCommentBodyElements<U extends BaseUserMeta = DU> = {
     /**
      * The element used to display paragraphs.
      */
@@ -3064,7 +3153,7 @@ declare type StringifyCommentBodyElements<U extends BaseUserMeta = DU> = {
      */
     mention: (args: CommentBodyMentionElementArgs<U>, index: number) => string;
 };
-declare type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
+type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
     /**
      * Which format to convert the comment to.
      */
@@ -3153,13 +3242,13 @@ declare function convertToInboxNotificationData(data: InboxNotificationDataPlain
 /**
  * Lookup table for nodes (= SerializedCrdt values) by their IDs.
  */
-declare type NodeMap = Map<string, // Node ID
+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
+type ParentToChildNodeMap = Map<string, // Parent's node ID
 IdTuple<SerializedChild>[]>;
 
 declare function isLiveNode(value: unknown): value is LiveNode;
@@ -3213,10 +3302,14 @@ declare function assert(condition: boolean, errmsg: string): asserts condition;
 declare function nn<T>(value: T, errmsg?: string): NonNullable<T>;
 
 declare class HttpError extends Error {
-    message: string;
-    status: number;
-    details?: JsonObject | undefined;
-    constructor(message: string, status: number, details?: JsonObject | undefined);
+    response: Response;
+    details?: JsonObject;
+    private constructor();
+    static fromResponse(response: Response): Promise<HttpError>;
+    /**
+     * Convenience accessor for response.status.
+     */
+    get status(): number;
 }
 /**
  * Wraps a promise factory. Will create promises until one succeeds. If
@@ -3250,6 +3343,36 @@ declare function createCommentId(): string;
 declare function createCommentAttachmentId(): string;
 declare function createInboxNotificationId(): string;
 
+/**
+ * Like ES6 map, but takes a default (factory) function which will be used
+ * to create entries for missing keys on the fly.
+ *
+ * Useful for code like:
+ *
+ *   const map = new DefaultMap(() => []);
+ *   map.getOrCreate('foo').push('hello');
+ *   map.getOrCreate('foo').push('world');
+ *   map.getOrCreate('foo')
+ *   // ['hello', 'world']
+ *
+ */
+declare class DefaultMap<K, V> extends Map<K, V> {
+    #private;
+    /**
+     * If the default function is not provided to the constructor, it has to be
+     * provided in each .getOrCreate() call individually.
+     */
+    constructor(defaultFn?: (key: K) => V, entries?: readonly (readonly [K, V])[] | null);
+    /**
+     * Gets the value at the given key, or creates it.
+     *
+     * Difference from normal Map: if the key does not exist, it will be created
+     * on the fly using the factory function, and that value will get returned
+     * instead of `undefined`.
+     */
+    getOrCreate(key: K, defaultFn?: (key: K) => V): V;
+}
+
 /**
  * Displays a deprecation warning in the dev console. Only in dev mode, and
  * only once per message/key. In production, this is a no-op.
@@ -3295,6 +3418,16 @@ declare namespace fancyConsole {
  */
 declare const freeze: typeof Object.freeze;
 
+declare function isPlainObject(blob: unknown): blob is {
+    [key: string]: unknown;
+};
+/**
+ * Check if value is of shape { startsWith: string }
+ */
+declare function isStartsWithOperator(blob: unknown): blob is {
+    startsWith: string;
+};
+
 declare const nanoid: (t?: number) => string;
 
 /**
@@ -3302,35 +3435,32 @@ declare const nanoid: (t?: number) => string;
  * Example:
  * ```ts
  * const query = objectToQuery({
-      resolved: true,
-      metadata: {
-        status: "open",
-        priority: 3,
-        org: {
-          startsWith: "liveblocks:",
-        },
-      },
-});
-
-console.log(query);
-// resolved:true AND metadata["status"]:open AND metadata["priority"]:3 AND metadata["org"]^"liveblocks:"
-
- * ```
- *
+ *   resolved: true,
+ *   metadata: {
+ *     status: "open",
+ *     priority: 3,
+ *     org: {
+ *       startsWith: "liveblocks:",
+ *     },
+ *   },
+ * });
  *
+ * console.log(query);
+ * // resolved:true AND metadata["status"]:open AND metadata["priority"]:3 AND metadata["org"]^"liveblocks:"
+ * ```
  */
-declare type SimpleFilterValue = string | number | boolean;
-declare type OperatorFilterValue = {
+type SimpleFilterValue = string | number | boolean | null;
+type OperatorFilterValue = {
     startsWith: string;
 };
-declare type FilterValue = SimpleFilterValue | OperatorFilterValue;
+type FilterValue = SimpleFilterValue | OperatorFilterValue;
 declare function objectToQuery(obj: {
     [key: string]: FilterValue | {
         [key: string]: FilterValue | undefined;
     } | undefined;
 }): string;
 
-declare type Poller = {
+type Poller = {
     /**
      * Increments the subscriber count for this poller. If it becomes > 0, the
      * poller will be enabled.
@@ -3383,17 +3513,14 @@ declare function makePoller(callback: (signal: AbortSignal) => Promise<void> | v
 }): Poller;
 
 declare const brand: unique symbol;
-declare type Brand<T, TBrand extends string> = T & {
+type Brand<T, TBrand extends string> = T & {
     [brand]: TBrand;
 };
-declare type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : never;
+type DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : never;
 /**
  * Throw an error, but as an expression instead of a statement.
  */
 declare function raise(msg: string): never;
-declare function isPlainObject(blob: unknown): blob is {
-    [key: string]: unknown;
-};
 /**
  * Creates a new object by mapping a function over all values. Keys remain the
  * same. Think Array.prototype.map(), but for values in an object.
@@ -3410,7 +3537,7 @@ declare function tryParseJson(rawMessage: string): Json | undefined;
  * Decode base64 string.
  */
 declare function b64decode(b64value: string): string;
-declare type RemoveUndefinedValues<T> = {
+type RemoveUndefinedValues<T> = {
     [K in keyof T]-?: Exclude<T[K], undefined>;
 };
 /**
@@ -3487,7 +3614,7 @@ declare function memoizeOnSuccess<T>(factoryFn: () => Promise<T>): () => Promise
  * A valid/verified "position" string. These values are used as "parentKey"s by
  * LiveList children, and define their relative ordering.
  */
-declare type Pos = Brand<string, "Pos">;
+type Pos = Brand<string, "Pos">;
 /**
  * Given two positions, returns the position value that lies in the middle.
  * When given only a high bound, computes the canonical position "before" it.
@@ -3552,14 +3679,13 @@ declare class SortedList<T> {
     [Symbol.iterator](): IterableIterator<T>;
 }
 
-declare type OmitFirstTupleElement<T extends any[]> = T extends [any, ...infer R] ? R : never;
 /**
- * Like JSON.stringify(), but returns the same value no matter how the keys in
- * objects are ordered.
+ * Like JSON.stringify(), but returns the same value no matter how keys in any
+ * nested objects are ordered.
  */
-declare function stringify(object: Parameters<typeof JSON.stringify>[0], ...args: OmitFirstTupleElement<Parameters<typeof JSON.stringify>>): string;
+declare function stringify(value: unknown): string;
 
-declare type QueryParams = Record<string, string | number | null | undefined> | URLSearchParams;
+type QueryParams = Record<string, string | number | null | undefined> | URLSearchParams;
 /**
  * Concatenates a path to an existing URL.
  */
@@ -3568,7 +3694,7 @@ declare function urljoin(baseUrl: string | URL, path: string, params?: QueryPara
  * A string that is guaranteed to be URL safe (where all arguments are properly
  * encoded), only obtainable as the result of using `url` template strings.
  */
-declare type URLSafeString = Brand<string, "URLSafeString">;
+type URLSafeString = Brand<string, "URLSafeString">;
 /**
  * Builds a URL where each "hole" in the template string will automatically be
  * encodeURIComponent()-escaped, so it's impossible to build invalid URLs.
@@ -3578,7 +3704,7 @@ declare function url(strings: TemplateStringsArray, ...values: string[]): URLSaf
 /**
  * Definition of all messages the Panel can send to the Client.
  */
-declare type PanelToClientMessage = 
+type PanelToClientMessage = 
 /**
  * Initial message from the panel to the client, used for two purposes.
  * 1. First, it’s eavesdropped by the background script, which uses this
@@ -3612,7 +3738,7 @@ declare type PanelToClientMessage =
 /**
  * Definition of all messages the Client can send to the Panel.
  */
-declare type ClientToPanelMessage = 
+type ClientToPanelMessage = 
 /**
  * Initial message sent by the client to test if a dev panel is listening.
  * This is necessary in cases where the dev panel is already opened and
@@ -3679,11 +3805,11 @@ declare type ClientToPanelMessage =
     roomId: string;
     update: YDocUpdateServerMsg | UpdateYDocClientMsg;
 };
-declare type FullPanelToClientMessage = PanelToClientMessage & {
+type FullPanelToClientMessage = PanelToClientMessage & {
     source: "liveblocks-devtools-panel";
     tabId: number;
 };
-declare type FullClientToPanelMessage = ClientToPanelMessage & {
+type FullClientToPanelMessage = ClientToPanelMessage & {
     source: "liveblocks-devtools-client";
 };
 
@@ -3701,7 +3827,7 @@ declare namespace protocol {
  * information, see
  * https://liveblocks.io/docs/guides/limits#lson-constraint-and-interfaces
  */
-declare type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson<I>)[] : [
+type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson<I>)[] : [
     unknown
 ] extends [T] ? Json | undefined : T extends Date ? string : T extends (...args: any[]) => any ? never : {
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
@@ -3712,4 +3838,4 @@ declare const CommentsApiError: typeof HttpError;
 /** @deprecated Use HttpError instead. */
 declare const NotificationsApiError: typeof HttpError;
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, 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 InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, 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 SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, 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, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, HttpError, 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 InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MutableSignal, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, 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 Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, 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 SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };