@liveblocks/core 2.0.0-alpha1 → 2.0.0-alpha3

package/dist/index.d.mts

@@ -575,7 +575,7 @@ declare type LiveListUpdates<TItem extends Lson> = {
  * The LiveList class represents an ordered collection of items that is synchronized across clients.
  */
 declare class LiveList<TItem extends Lson> extends AbstractCrdt {
-    constructor(items?: TItem[]);
+    constructor(items: TItem[]);
     /**
      * Returns the number of elements.
      */
@@ -774,6 +774,60 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     clone(): LiveObject<O>;
 }
 
+declare 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 = {
+    kind: "thread";
+    id: string;
+    roomId: string;
+    threadId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+};
+declare type InboxNotificationTextMentionData = {
+    kind: "textMention";
+    id: string;
+    roomId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+    createdBy: string;
+    mentionId: string;
+};
+declare type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
+declare type ActivityData = Record<string, string | boolean | number | undefined>;
+declare type InboxNotificationActivity<K extends `$${string}` = `$${string}`> = {
+    id: string;
+    createdAt: Date;
+    data: K extends keyof DAD ? DAD[K] : ActivityData;
+};
+declare type InboxNotificationCustomData<K extends `$${string}` = `$${string}`> = {
+    kind: `$${string}`;
+    id: string;
+    roomId?: string;
+    subjectId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+    activities: InboxNotificationActivity<K>[];
+};
+declare type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData | InboxNotificationTextMentionData;
+declare type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
+declare type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
+    activities: DateToString<InboxNotificationActivity>[];
+};
+declare type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain | InboxNotificationTextMentionDataPlain;
+declare type InboxNotificationDeleteInfo = {
+    type: "deletedInboxNotification";
+    id: string;
+    roomId: string;
+    deletedAt: Date;
+};
+
+declare type BaseActivitiesData = {
+    [key: `$${string}`]: ActivityData;
+};
+
 declare type BaseRoomInfo = {
     [key: string]: Json | undefined;
     /**
@@ -786,10 +840,6 @@ declare type BaseRoomInfo = {
     url?: string;
 };
 
-declare 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 BaseMetadata = Record<string, string | boolean | number | undefined>;
 declare type CommentReaction = {
     emoji: string;
@@ -883,7 +933,7 @@ declare type ThreadDeleteInfo = {
     roomId: string;
     deletedAt: Date;
 };
-declare type QueryMetadataStringValue<T extends string> = T | {
+declare type StringOperators<T> = T | {
     startsWith: string;
 };
 /**
@@ -895,7 +945,7 @@ declare type QueryMetadataStringValue<T extends string> = T | {
  *  - `startsWith` (`^` in query string)
  */
 declare type QueryMetadata<M extends BaseMetadata> = {
-    [K in keyof M]: M[K] extends string ? QueryMetadataStringValue<M[K]> : M[K];
+    [K in keyof M]: string extends M[K] ? StringOperators<M[K]> : M[K];
 };
 
 declare global {
@@ -906,14 +956,15 @@ declare global {
         [key: string]: unknown;
     }
 }
-declare type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo";
-declare type ExtendedType<K extends ExtendableTypes, B> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : `The type you provided for '${K}' does not match its requirements. To learn how to fix this, see https://liveblocks.io/errors/${K}`;
-declare type DP = ExtendedType<"Presence", JsonObject>;
-declare type DS = ExtendedType<"Storage", LsonObject>;
+declare type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
+declare type ExtendedType<K extends ExtendableTypes, B, ErrorReason extends string = "does not match its requirements"> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : `The type you provided for '${K}' ${ErrorReason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
+declare type DP = ExtendedType<"Presence", JsonObject, "is not a valid JSON object">;
+declare type DS = ExtendedType<"Storage", LsonObject, "is not a valid LSON value">;
 declare type DU = ExtendedType<"UserMeta", BaseUserMeta>;
-declare type DE = ExtendedType<"RoomEvent", Json>;
+declare type DE = ExtendedType<"RoomEvent", Json, "is not a valid JSON value">;
 declare type DM = ExtendedType<"ThreadMetadata", BaseMetadata>;
 declare type DRI = ExtendedType<"RoomInfo", BaseRoomInfo>;
+declare type DAD = ExtendedType<"ActivitiesData", BaseActivitiesData>;
 
 /**
  * Use this symbol to brand an object property as internal.
@@ -1020,42 +1071,6 @@ declare type UpdateYDocClientMsg = {
     readonly guid?: string;
 };
 
-declare type InboxNotificationThreadData = {
-    kind: "thread";
-    id: string;
-    roomId: string;
-    threadId: string;
-    notifiedAt: Date;
-    readAt: Date | null;
-};
-declare type ActivityData = Record<string, string | boolean | number | undefined>;
-declare type InboxNotificationActivity = {
-    id: string;
-    createdAt: Date;
-    data: ActivityData;
-};
-declare type InboxNotificationCustomData = {
-    kind: `$${string}`;
-    id: string;
-    roomId?: string;
-    subjectId: string;
-    notifiedAt: Date;
-    readAt: Date | null;
-    activities: InboxNotificationActivity[];
-};
-declare type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData;
-declare type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
-declare type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
-    activities: DateToString<InboxNotificationActivity>[];
-};
-declare type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain;
-declare type InboxNotificationDeleteInfo = {
-    type: "deletedInboxNotification";
-    id: string;
-    roomId: string;
-    deletedAt: Date;
-};
-
 declare type IdTuple<T> = [id: string, value: T];
 declare enum CrdtType {
     OBJECT = 0,
@@ -1417,9 +1432,13 @@ declare type OthersEvent<P extends JsonObject = DP, U extends BaseUserMeta = DU>
     others: readonly User<P, U>[];
 }>;
 
-declare type PartialNullable<T> = {
-    [P in keyof T]?: T[P] | null;
+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 = {
@@ -1707,7 +1726,7 @@ declare type CommentsApi<M extends BaseMetadata> = {
         body: CommentBody;
     }): Promise<ThreadData<M>>;
     editThreadMetadata(options: {
-        metadata: PartialNullable<M>;
+        metadata: Patchable<M>;
         threadId: string;
     }): Promise<M>;
     createComment(options: {
@@ -1929,6 +1948,9 @@ declare type PrivateRoomApi<M extends BaseMetadata> = {
     nodeCount: number;
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
+    reportTextEditor(editor: "lexical", rootKey: string): void;
+    createTextMention(userId: string, mentionId: string): Promise<Response>;
+    deleteTextMention(mentionId: string): Promise<Response>;
     simulate: {
         explicitClose(event: IWebSocketCloseEvent): void;
         rawSend(data: string): void;
@@ -2002,6 +2024,12 @@ declare type Store<T> = {
     subscribe: (callback: (state: T) => void) => () => void;
 };
 
+/**
+ * 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];
+
 declare type GetInboxNotificationsOptions = {
     limit?: number;
     since?: Date;
@@ -2011,13 +2039,14 @@ declare type OptimisticUpdate<M extends BaseMetadata> = CreateThreadOptimisticUp
 declare type CreateThreadOptimisticUpdate<M extends BaseMetadata> = {
     type: "create-thread";
     id: string;
+    roomId: string;
     thread: ThreadData<M>;
 };
 declare type EditThreadMetadataOptimisticUpdate<M extends BaseMetadata> = {
     type: "edit-thread-metadata";
     id: string;
     threadId: string;
-    metadata: Resolve<PartialNullable<M>>;
+    metadata: Resolve<Patchable<M>>;
     updatedAt: Date;
 };
 declare type CreateCommentOptimisticUpdate = {
@@ -2033,6 +2062,7 @@ declare type EditCommentOptimisticUpdate = {
 declare type DeleteCommentOptimisticUpdate = {
     type: "delete-comment";
     id: string;
+    roomId: string;
     threadId: string;
     deletedAt: Date;
     commentId: string;
@@ -2107,6 +2137,7 @@ interface CacheStore<M extends BaseMetadata> extends Store<CacheState<M>> {
     updateRoomInboxNotificationSettings(roomId: string, settings: RoomNotificationSettings, queryKey: string): void;
     pushOptimisticUpdate(optimisticUpdate: OptimisticUpdate<M>): void;
     setQueryState(queryKey: string, queryState: QueryState): void;
+    optimisticUpdatesEventSource: ReturnType<typeof makeEventSource<OptimisticUpdate<M>>>;
 }
 declare function applyOptimisticUpdates<M extends BaseMetadata>(state: CacheState<M>): Pick<CacheState<M>, "threads" | "inboxNotifications" | "notificationSettings">;
 declare function upsertComment<M extends BaseMetadata>(thread: ThreadDataWithDeleteInfo<M>, comment: CommentData): ThreadDataWithDeleteInfo<M>;
@@ -2199,7 +2230,7 @@ declare type Client<U extends BaseUserMeta = DU> = {
      * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
      * @returns The room and a leave function. Call the returned leave() function when you no longer need the room.
      */
-    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M extends BaseMetadata = DM>(roomId: string, options: EnterOptions<P, S>): {
+    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M extends BaseMetadata = DM>(roomId: string, options: EnterOptions<NoInfr<P>, NoInfr<S>>): {
         room: Room<P, S, U, E, M>;
         leave: () => void;
     };
@@ -2776,10 +2807,10 @@ declare namespace protocol {
  * information, see
  * https://liveblocks.io/docs/guides/limits#lson-constraint-and-interfaces
  */
-declare type EnsureJson<T> = [
+declare type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson<I>)[] : [
     unknown
-] extends [T] ? T : T extends (...args: unknown[]) => unknown ? T : {
-    [K in keyof T]: EnsureJson<T[K]>;
+] 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]>;
 };
 
-export { type AckOp, type ActivityData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type CacheState, type CacheStore, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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 CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NodeMap, NotificationsApiError, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OthersEvent, type ParentToChildNodeMap, type PartialNullable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomInitializers, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDeleteInfo, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, addReaction, applyOptimisticUpdates, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, deleteComment, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, objectToQuery, patchLiveObjectKey, raise, removeReaction, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, upsertComment, withTimeout };
+export { type AckOp, type ActivityData, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type CacheState, type CacheStore, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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 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, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, 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, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OthersEvent, type ParentToChildNodeMap, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomInitializers, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDeleteInfo, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, addReaction, applyOptimisticUpdates, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, deleteComment, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, objectToQuery, patchLiveObjectKey, raise, removeReaction, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, upsertComment, withTimeout };

package/dist/index.d.ts

@@ -575,7 +575,7 @@ declare type LiveListUpdates<TItem extends Lson> = {
  * The LiveList class represents an ordered collection of items that is synchronized across clients.
  */
 declare class LiveList<TItem extends Lson> extends AbstractCrdt {
-    constructor(items?: TItem[]);
+    constructor(items: TItem[]);
     /**
      * Returns the number of elements.
      */
@@ -774,6 +774,60 @@ declare class LiveObject<O extends LsonObject> extends AbstractCrdt {
     clone(): LiveObject<O>;
 }
 
+declare 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 = {
+    kind: "thread";
+    id: string;
+    roomId: string;
+    threadId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+};
+declare type InboxNotificationTextMentionData = {
+    kind: "textMention";
+    id: string;
+    roomId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+    createdBy: string;
+    mentionId: string;
+};
+declare type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
+declare type ActivityData = Record<string, string | boolean | number | undefined>;
+declare type InboxNotificationActivity<K extends `$${string}` = `$${string}`> = {
+    id: string;
+    createdAt: Date;
+    data: K extends keyof DAD ? DAD[K] : ActivityData;
+};
+declare type InboxNotificationCustomData<K extends `$${string}` = `$${string}`> = {
+    kind: `$${string}`;
+    id: string;
+    roomId?: string;
+    subjectId: string;
+    notifiedAt: Date;
+    readAt: Date | null;
+    activities: InboxNotificationActivity<K>[];
+};
+declare type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData | InboxNotificationTextMentionData;
+declare type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
+declare type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
+    activities: DateToString<InboxNotificationActivity>[];
+};
+declare type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain | InboxNotificationTextMentionDataPlain;
+declare type InboxNotificationDeleteInfo = {
+    type: "deletedInboxNotification";
+    id: string;
+    roomId: string;
+    deletedAt: Date;
+};
+
+declare type BaseActivitiesData = {
+    [key: `$${string}`]: ActivityData;
+};
+
 declare type BaseRoomInfo = {
     [key: string]: Json | undefined;
     /**
@@ -786,10 +840,6 @@ declare type BaseRoomInfo = {
     url?: string;
 };
 
-declare 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 BaseMetadata = Record<string, string | boolean | number | undefined>;
 declare type CommentReaction = {
     emoji: string;
@@ -883,7 +933,7 @@ declare type ThreadDeleteInfo = {
     roomId: string;
     deletedAt: Date;
 };
-declare type QueryMetadataStringValue<T extends string> = T | {
+declare type StringOperators<T> = T | {
     startsWith: string;
 };
 /**
@@ -895,7 +945,7 @@ declare type QueryMetadataStringValue<T extends string> = T | {
  *  - `startsWith` (`^` in query string)
  */
 declare type QueryMetadata<M extends BaseMetadata> = {
-    [K in keyof M]: M[K] extends string ? QueryMetadataStringValue<M[K]> : M[K];
+    [K in keyof M]: string extends M[K] ? StringOperators<M[K]> : M[K];
 };
 
 declare global {
@@ -906,14 +956,15 @@ declare global {
         [key: string]: unknown;
     }
 }
-declare type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo";
-declare type ExtendedType<K extends ExtendableTypes, B> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : `The type you provided for '${K}' does not match its requirements. To learn how to fix this, see https://liveblocks.io/errors/${K}`;
-declare type DP = ExtendedType<"Presence", JsonObject>;
-declare type DS = ExtendedType<"Storage", LsonObject>;
+declare type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
+declare type ExtendedType<K extends ExtendableTypes, B, ErrorReason extends string = "does not match its requirements"> = unknown extends Liveblocks[K] ? B : Liveblocks[K] extends B ? Liveblocks[K] : `The type you provided for '${K}' ${ErrorReason}. To learn how to fix this, see https://liveblocks.io/docs/errors/${K}`;
+declare type DP = ExtendedType<"Presence", JsonObject, "is not a valid JSON object">;
+declare type DS = ExtendedType<"Storage", LsonObject, "is not a valid LSON value">;
 declare type DU = ExtendedType<"UserMeta", BaseUserMeta>;
-declare type DE = ExtendedType<"RoomEvent", Json>;
+declare type DE = ExtendedType<"RoomEvent", Json, "is not a valid JSON value">;
 declare type DM = ExtendedType<"ThreadMetadata", BaseMetadata>;
 declare type DRI = ExtendedType<"RoomInfo", BaseRoomInfo>;
+declare type DAD = ExtendedType<"ActivitiesData", BaseActivitiesData>;
 
 /**
  * Use this symbol to brand an object property as internal.
@@ -1020,42 +1071,6 @@ declare type UpdateYDocClientMsg = {
     readonly guid?: string;
 };
 
-declare type InboxNotificationThreadData = {
-    kind: "thread";
-    id: string;
-    roomId: string;
-    threadId: string;
-    notifiedAt: Date;
-    readAt: Date | null;
-};
-declare type ActivityData = Record<string, string | boolean | number | undefined>;
-declare type InboxNotificationActivity = {
-    id: string;
-    createdAt: Date;
-    data: ActivityData;
-};
-declare type InboxNotificationCustomData = {
-    kind: `$${string}`;
-    id: string;
-    roomId?: string;
-    subjectId: string;
-    notifiedAt: Date;
-    readAt: Date | null;
-    activities: InboxNotificationActivity[];
-};
-declare type InboxNotificationData = InboxNotificationThreadData | InboxNotificationCustomData;
-declare type InboxNotificationThreadDataPlain = DateToString<InboxNotificationThreadData>;
-declare type InboxNotificationCustomDataPlain = Omit<DateToString<InboxNotificationCustomData>, "activities"> & {
-    activities: DateToString<InboxNotificationActivity>[];
-};
-declare type InboxNotificationDataPlain = InboxNotificationThreadDataPlain | InboxNotificationCustomDataPlain;
-declare type InboxNotificationDeleteInfo = {
-    type: "deletedInboxNotification";
-    id: string;
-    roomId: string;
-    deletedAt: Date;
-};
-
 declare type IdTuple<T> = [id: string, value: T];
 declare enum CrdtType {
     OBJECT = 0,
@@ -1417,9 +1432,13 @@ declare type OthersEvent<P extends JsonObject = DP, U extends BaseUserMeta = DU>
     others: readonly User<P, U>[];
 }>;
 
-declare type PartialNullable<T> = {
-    [P in keyof T]?: T[P] | null;
+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 = {
@@ -1707,7 +1726,7 @@ declare type CommentsApi<M extends BaseMetadata> = {
         body: CommentBody;
     }): Promise<ThreadData<M>>;
     editThreadMetadata(options: {
-        metadata: PartialNullable<M>;
+        metadata: Patchable<M>;
         threadId: string;
     }): Promise<M>;
     createComment(options: {
@@ -1929,6 +1948,9 @@ declare type PrivateRoomApi<M extends BaseMetadata> = {
     nodeCount: number;
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
+    reportTextEditor(editor: "lexical", rootKey: string): void;
+    createTextMention(userId: string, mentionId: string): Promise<Response>;
+    deleteTextMention(mentionId: string): Promise<Response>;
     simulate: {
         explicitClose(event: IWebSocketCloseEvent): void;
         rawSend(data: string): void;
@@ -2002,6 +2024,12 @@ declare type Store<T> = {
     subscribe: (callback: (state: T) => void) => () => void;
 };
 
+/**
+ * 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];
+
 declare type GetInboxNotificationsOptions = {
     limit?: number;
     since?: Date;
@@ -2011,13 +2039,14 @@ declare type OptimisticUpdate<M extends BaseMetadata> = CreateThreadOptimisticUp
 declare type CreateThreadOptimisticUpdate<M extends BaseMetadata> = {
     type: "create-thread";
     id: string;
+    roomId: string;
     thread: ThreadData<M>;
 };
 declare type EditThreadMetadataOptimisticUpdate<M extends BaseMetadata> = {
     type: "edit-thread-metadata";
     id: string;
     threadId: string;
-    metadata: Resolve<PartialNullable<M>>;
+    metadata: Resolve<Patchable<M>>;
     updatedAt: Date;
 };
 declare type CreateCommentOptimisticUpdate = {
@@ -2033,6 +2062,7 @@ declare type EditCommentOptimisticUpdate = {
 declare type DeleteCommentOptimisticUpdate = {
     type: "delete-comment";
     id: string;
+    roomId: string;
     threadId: string;
     deletedAt: Date;
     commentId: string;
@@ -2107,6 +2137,7 @@ interface CacheStore<M extends BaseMetadata> extends Store<CacheState<M>> {
     updateRoomInboxNotificationSettings(roomId: string, settings: RoomNotificationSettings, queryKey: string): void;
     pushOptimisticUpdate(optimisticUpdate: OptimisticUpdate<M>): void;
     setQueryState(queryKey: string, queryState: QueryState): void;
+    optimisticUpdatesEventSource: ReturnType<typeof makeEventSource<OptimisticUpdate<M>>>;
 }
 declare function applyOptimisticUpdates<M extends BaseMetadata>(state: CacheState<M>): Pick<CacheState<M>, "threads" | "inboxNotifications" | "notificationSettings">;
 declare function upsertComment<M extends BaseMetadata>(thread: ThreadDataWithDeleteInfo<M>, comment: CommentData): ThreadDataWithDeleteInfo<M>;
@@ -2199,7 +2230,7 @@ declare type Client<U extends BaseUserMeta = DU> = {
      * @param options Optional. You can provide initializers for the Presence or Storage when entering the Room.
      * @returns The room and a leave function. Call the returned leave() function when you no longer need the room.
      */
-    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M extends BaseMetadata = DM>(roomId: string, options: EnterOptions<P, S>): {
+    enterRoom<P extends JsonObject = DP, S extends LsonObject = DS, E extends Json = DE, M extends BaseMetadata = DM>(roomId: string, options: EnterOptions<NoInfr<P>, NoInfr<S>>): {
         room: Room<P, S, U, E, M>;
         leave: () => void;
     };
@@ -2776,10 +2807,10 @@ declare namespace protocol {
  * information, see
  * https://liveblocks.io/docs/guides/limits#lson-constraint-and-interfaces
  */
-declare type EnsureJson<T> = [
+declare type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson<I>)[] : [
     unknown
-] extends [T] ? T : T extends (...args: unknown[]) => unknown ? T : {
-    [K in keyof T]: EnsureJson<T[K]>;
+] 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]>;
 };
 
-export { type AckOp, type ActivityData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type CacheState, type CacheStore, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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 CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NodeMap, NotificationsApiError, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OthersEvent, type ParentToChildNodeMap, type PartialNullable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomInitializers, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDeleteInfo, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, addReaction, applyOptimisticUpdates, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, deleteComment, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, objectToQuery, patchLiveObjectKey, raise, removeReaction, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, upsertComment, withTimeout };
+export { type AckOp, type ActivityData, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type CacheState, type CacheStore, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, 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 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, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, 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, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OthersEvent, type ParentToChildNodeMap, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomInitializers, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDeleteInfo, type ToImmutable, type ToJson, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, addReaction, applyOptimisticUpdates, asPos, assert, assertNever, b64decode, cloneLson, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, deleteComment, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, nn, objectToQuery, patchLiveObjectKey, raise, removeReaction, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, upsertComment, withTimeout };