@liveblocks/core 3.6.0 → 3.7.0-preview1

package/dist/index.d.cts

@@ -225,7 +225,9 @@ declare function makeEventSource<T>(): EventSource<T>;
 type BatchStore<O, I> = {
     subscribe: (callback: Callback<void>) => UnsubscribeCallback;
     enqueue: (input: I) => Promise<void>;
+    fill: (input: I, data: O) => void;
     getItemState: (input: I) => AsyncResult<O> | undefined;
+    getData: (input: I) => O | undefined;
     invalidate: (inputs?: I[]) => void;
 };
 
@@ -1030,6 +1032,17 @@ 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];
 };
 
+type MentionData = Relax<UserMentionData | GroupMentionData>;
+type UserMentionData = {
+    kind: "user";
+    id: string;
+};
+type GroupMentionData = {
+    kind: "group";
+    id: string;
+    userIds?: string[];
+};
+
 type InboxNotificationThreadData = {
     kind: "thread";
     id: string;
@@ -1046,6 +1059,7 @@ type InboxNotificationTextMentionData = {
     readAt: Date | null;
     createdBy: string;
     mentionId: string;
+    mention: MentionData;
 };
 type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
 type ActivityData = Record<string, string | boolean | number | undefined>;
@@ -1080,6 +1094,22 @@ type BaseActivitiesData = {
     [key: `$${string}`]: ActivityData;
 };
 
+type BaseGroupInfo = {
+    [key: string]: Json | undefined;
+    /**
+     * The name of the group.
+     */
+    name?: string;
+    /**
+     * The avatar of the group.
+     */
+    avatar?: string;
+    /**
+     * The description of the group.
+     */
+    description?: string;
+};
+
 type BaseRoomInfo = {
     [key: string]: Json | undefined;
     /**
@@ -1100,7 +1130,7 @@ declare global {
         [key: string]: unknown;
     }
 }
-type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
+type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "GroupInfo" | "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;
@@ -1110,6 +1140,7 @@ type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info"
 type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
 type DM = GetOverride<"ThreadMetadata", BaseMetadata>;
 type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
+type DGI = GetOverride<"GroupInfo", BaseGroupInfo>;
 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";
 }>;
@@ -1201,12 +1232,18 @@ type CommentBodyParagraph = {
     type: "paragraph";
     children: CommentBodyInlineElement[];
 };
-type CommentBodyMention = Relax<CommentBodyUserMention>;
+type CommentBodyMention = Relax<CommentBodyUserMention | CommentBodyGroupMention>;
 type CommentBodyUserMention = {
     type: "mention";
     kind: "user";
     id: string;
 };
+type CommentBodyGroupMention = {
+    type: "mention";
+    kind: "group";
+    id: string;
+    userIds?: string[];
+};
 type CommentBodyLink = {
     type: "link";
     url: string;
@@ -1270,6 +1307,26 @@ type QueryMetadata<M extends BaseMetadata> = {
     [K in keyof M]: (string extends M[K] ? StringOperators<M[K]> : M[K]) | null;
 };
 
+type GroupMemberData = {
+    id: string;
+    addedAt: Date;
+};
+type GroupScopes = Partial<{
+    mention: true;
+}>;
+type GroupData = {
+    type: "group";
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    scopes: GroupScopes;
+    members: GroupMemberData[];
+};
+type GroupDataPlain = Omit<DateToString<GroupData>, "members"> & {
+    members: DateToString<GroupMemberData>[];
+};
+
 /**
  * Pre-defined notification channels support list.
  */
@@ -1593,10 +1650,10 @@ interface RoomHttpApi<M extends BaseMetadata> {
     getChatAttachmentUrl(options: {
         attachmentId: string;
     }): Promise<string>;
-    createTextMention({ roomId, userId, mentionId, }: {
+    createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
-        userId: string;
         mentionId: string;
+        mention: MentionData;
     }): Promise<void>;
     deleteTextMention({ roomId, mentionId, }: {
         roomId: string;
@@ -1735,6 +1792,8 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
         requestedAt: Date;
         permissionHints: Record<string, Permission[]>;
     }>;
+    groupsStore: BatchStore<GroupData | undefined, string>;
+    getGroup(groupId: string): Promise<GroupData | undefined>;
 }
 
 /**
@@ -1841,12 +1900,6 @@ declare class LiveblocksError extends Error {
     static from(context: LiveblocksErrorContext, cause?: Error): LiveblocksError;
 }
 
-type MentionData = Relax<UserMentionData>;
-type UserMentionData = {
-    kind: "user";
-    id: string;
-};
-
 type ResolveMentionSuggestionsArgs = {
     /**
      * The ID of the current room.
@@ -1869,6 +1922,12 @@ type ResolveRoomsInfoArgs = {
      */
     roomIds: string[];
 };
+type ResolveGroupsInfoArgs = {
+    /**
+     * The IDs of the groups to resolve.
+     */
+    groupIds: string[];
+};
 type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS> = Resolve<{
     /**
      * Whether or not the room automatically connects to Liveblock servers.
@@ -1912,6 +1971,7 @@ type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
+    readonly groupsInfoStore: BatchStore<DGI | undefined, string>;
     readonly getRoomIds: () => string[];
     readonly httpClient: LiveblocksHttpApi<M>;
     as<M2 extends BaseMetadata>(): Client<U, M2>;
@@ -2107,6 +2167,18 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
          * client.resolvers.invalidateRoomsInfo(["room-1", "room-2"]);
          */
         invalidateRoomsInfo(roomIds?: string[]): void;
+        /**
+         * Invalidate some or all groups info that were previously cached by `resolveGroupsInfo`.
+         *
+         * @example
+         * // Invalidate all groups
+         * client.resolvers.invalidateGroupsInfo();
+         *
+         * @example
+         * // Invalidate specific groups
+         * client.resolvers.invalidateGroupsInfo(["group-1", "group-2"]);
+         */
+        invalidateGroupsInfo(groupIds?: string[]): void;
         /**
          * Invalidate all mention suggestions cached by `resolveMentionSuggestions`.
          *
@@ -2174,6 +2246,11 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
      * You should return a list of room info objects of the same size, in the same order.
      */
     resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => Awaitable<(DRI | undefined)[] | undefined>;
+    /**
+     * A function that returns group info from group IDs.
+     * You should return a list of group info objects of the same size, in the same order.
+     */
+    resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>;
     /**
      * Prevent the current browser tab from being closed if there are any locally
      * pending Liveblocks changes that haven't been submitted to or confirmed by
@@ -3376,7 +3453,7 @@ type PrivateRoomApi = {
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
     reportTextEditor(editor: TextEditorType, rootKey: string): Promise<void>;
-    createTextMention(userId: string, mentionId: string): Promise<void>;
+    createTextMention(mentionId: string, mention: MentionData): Promise<void>;
     deleteTextMention(mentionId: string): Promise<void>;
     listTextVersions(): Promise<{
         versions: HistoryVersion[];
@@ -4154,9 +4231,13 @@ type CommentBodyMentionElementArgs<U extends BaseUserMeta = DU> = {
      */
     element: CommentBodyMention;
     /**
-     * The mention's user info, if the `resolvedUsers` option was provided.
+     * The mention's user info, if the mention is a user mention and the `resolveUsers` option was provided.
      */
     user?: U["info"];
+    /**
+     * The mention's group info, if the mention is a group mention and the `resolveGroupsInfo` option was provided.
+     */
+    group?: DGI;
 };
 type StringifyCommentBodyElements<U extends BaseUserMeta = DU> = {
     /**
@@ -4195,6 +4276,11 @@ type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      * You should return a list of user objects of the same size, in the same order.
      */
     resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+    /**
+     * A function that returns group info from group IDs.
+     * You should return a list of group info objects of the same size, in the same order.
+     */
+    resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>;
 };
 declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
@@ -4206,7 +4292,10 @@ declare function isCommentBodyLink(element: CommentBodyElement): element is Comm
  * `(mention) => mention.kind === "user"` to only get user mentions.
  */
 declare function getMentionsFromCommentBody(body: CommentBody, predicate?: (mention: CommentBodyMention) => boolean): CommentBodyMention[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
+declare function resolveMentionsInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>, resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>): Promise<{
+    users: Map<string, U["info"]>;
+    groups: Map<string, DGI>;
+}>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
     #private;
@@ -4224,6 +4313,8 @@ declare function html(strings: TemplateStringsArray, ...values: (string | string
  */
 declare function stringifyCommentBody(body: CommentBody, options?: StringifyCommentBodyOptions<BaseUserMeta>): Promise<string>;
 
+declare const MENTION_CHARACTER = "@";
+
 /**
  * Converts a plain comment data object (usually returned by the API) to a comment data object that can be used by the client.
  * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
@@ -4266,6 +4357,7 @@ declare function convertToSubscriptionData(data: SubscriptionDataPlain): Subscri
  * @returns The rich user subscription data object that can be used by the client.
  */
 declare function convertToUserSubscriptionData(data: UserSubscriptionDataPlain): UserSubscriptionData;
+declare function convertToGroupData(data: GroupDataPlain): GroupData;
 
 /**
  * Lookup table for nodes (= SerializedCrdt values) by their IDs.
@@ -4782,6 +4874,19 @@ declare function sanitizeUrl(url: string): string | null;
 declare function generateUrl(url: string, params?: Record<string, string | number | undefined>, hash?: string): string;
 declare function isUrl(string: string): boolean;
 
+/**
+ * Emit a warning only once.
+ *
+ * Only has effect in dev mode. In production, this is a no-op.
+ */
+declare function warnOnce(message: string, key?: string): void;
+/**
+ * Emit a warning only once if a condition is met.
+ *
+ * Only has effect in dev mode. In production, this is a no-op.
+ */
+declare function warnOnceIf(condition: boolean | (() => boolean), message: string, key?: string): void;
+
 /**
  * Definition of all messages the Panel can send to the Client.
  */
@@ -4914,4 +5019,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUserMessage, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, 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, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type 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 InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUserMessage, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };

package/dist/index.d.ts

@@ -225,7 +225,9 @@ declare function makeEventSource<T>(): EventSource<T>;
 type BatchStore<O, I> = {
     subscribe: (callback: Callback<void>) => UnsubscribeCallback;
     enqueue: (input: I) => Promise<void>;
+    fill: (input: I, data: O) => void;
     getItemState: (input: I) => AsyncResult<O> | undefined;
+    getData: (input: I) => O | undefined;
     invalidate: (inputs?: I[]) => void;
 };
 
@@ -1030,6 +1032,17 @@ 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];
 };
 
+type MentionData = Relax<UserMentionData | GroupMentionData>;
+type UserMentionData = {
+    kind: "user";
+    id: string;
+};
+type GroupMentionData = {
+    kind: "group";
+    id: string;
+    userIds?: string[];
+};
+
 type InboxNotificationThreadData = {
     kind: "thread";
     id: string;
@@ -1046,6 +1059,7 @@ type InboxNotificationTextMentionData = {
     readAt: Date | null;
     createdBy: string;
     mentionId: string;
+    mention: MentionData;
 };
 type InboxNotificationTextMentionDataPlain = DateToString<InboxNotificationTextMentionData>;
 type ActivityData = Record<string, string | boolean | number | undefined>;
@@ -1080,6 +1094,22 @@ type BaseActivitiesData = {
     [key: `$${string}`]: ActivityData;
 };
 
+type BaseGroupInfo = {
+    [key: string]: Json | undefined;
+    /**
+     * The name of the group.
+     */
+    name?: string;
+    /**
+     * The avatar of the group.
+     */
+    avatar?: string;
+    /**
+     * The description of the group.
+     */
+    description?: string;
+};
+
 type BaseRoomInfo = {
     [key: string]: Json | undefined;
     /**
@@ -1100,7 +1130,7 @@ declare global {
         [key: string]: unknown;
     }
 }
-type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "ActivitiesData";
+type ExtendableTypes = "Presence" | "Storage" | "UserMeta" | "RoomEvent" | "ThreadMetadata" | "RoomInfo" | "GroupInfo" | "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;
@@ -1110,6 +1140,7 @@ type DU = GetOverrideOrErrorValue<"UserMeta", BaseUserMeta, Record<"id" | "info"
 type DE = GetOverride<"RoomEvent", Json, "is not a valid JSON value">;
 type DM = GetOverride<"ThreadMetadata", BaseMetadata>;
 type DRI = GetOverride<"RoomInfo", BaseRoomInfo>;
+type DGI = GetOverride<"GroupInfo", BaseGroupInfo>;
 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";
 }>;
@@ -1201,12 +1232,18 @@ type CommentBodyParagraph = {
     type: "paragraph";
     children: CommentBodyInlineElement[];
 };
-type CommentBodyMention = Relax<CommentBodyUserMention>;
+type CommentBodyMention = Relax<CommentBodyUserMention | CommentBodyGroupMention>;
 type CommentBodyUserMention = {
     type: "mention";
     kind: "user";
     id: string;
 };
+type CommentBodyGroupMention = {
+    type: "mention";
+    kind: "group";
+    id: string;
+    userIds?: string[];
+};
 type CommentBodyLink = {
     type: "link";
     url: string;
@@ -1270,6 +1307,26 @@ type QueryMetadata<M extends BaseMetadata> = {
     [K in keyof M]: (string extends M[K] ? StringOperators<M[K]> : M[K]) | null;
 };
 
+type GroupMemberData = {
+    id: string;
+    addedAt: Date;
+};
+type GroupScopes = Partial<{
+    mention: true;
+}>;
+type GroupData = {
+    type: "group";
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    scopes: GroupScopes;
+    members: GroupMemberData[];
+};
+type GroupDataPlain = Omit<DateToString<GroupData>, "members"> & {
+    members: DateToString<GroupMemberData>[];
+};
+
 /**
  * Pre-defined notification channels support list.
  */
@@ -1593,10 +1650,10 @@ interface RoomHttpApi<M extends BaseMetadata> {
     getChatAttachmentUrl(options: {
         attachmentId: string;
     }): Promise<string>;
-    createTextMention({ roomId, userId, mentionId, }: {
+    createTextMention({ roomId, mentionId, mention, }: {
         roomId: string;
-        userId: string;
         mentionId: string;
+        mention: MentionData;
     }): Promise<void>;
     deleteTextMention({ roomId, mentionId, }: {
         roomId: string;
@@ -1735,6 +1792,8 @@ interface LiveblocksHttpApi<M extends BaseMetadata> extends RoomHttpApi<M>, Noti
         requestedAt: Date;
         permissionHints: Record<string, Permission[]>;
     }>;
+    groupsStore: BatchStore<GroupData | undefined, string>;
+    getGroup(groupId: string): Promise<GroupData | undefined>;
 }
 
 /**
@@ -1841,12 +1900,6 @@ declare class LiveblocksError extends Error {
     static from(context: LiveblocksErrorContext, cause?: Error): LiveblocksError;
 }
 
-type MentionData = Relax<UserMentionData>;
-type UserMentionData = {
-    kind: "user";
-    id: string;
-};
-
 type ResolveMentionSuggestionsArgs = {
     /**
      * The ID of the current room.
@@ -1869,6 +1922,12 @@ type ResolveRoomsInfoArgs = {
      */
     roomIds: string[];
 };
+type ResolveGroupsInfoArgs = {
+    /**
+     * The IDs of the groups to resolve.
+     */
+    groupIds: string[];
+};
 type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS> = Resolve<{
     /**
      * Whether or not the room automatically connects to Liveblock servers.
@@ -1912,6 +1971,7 @@ type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
+    readonly groupsInfoStore: BatchStore<DGI | undefined, string>;
     readonly getRoomIds: () => string[];
     readonly httpClient: LiveblocksHttpApi<M>;
     as<M2 extends BaseMetadata>(): Client<U, M2>;
@@ -2107,6 +2167,18 @@ type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> = {
          * client.resolvers.invalidateRoomsInfo(["room-1", "room-2"]);
          */
         invalidateRoomsInfo(roomIds?: string[]): void;
+        /**
+         * Invalidate some or all groups info that were previously cached by `resolveGroupsInfo`.
+         *
+         * @example
+         * // Invalidate all groups
+         * client.resolvers.invalidateGroupsInfo();
+         *
+         * @example
+         * // Invalidate specific groups
+         * client.resolvers.invalidateGroupsInfo(["group-1", "group-2"]);
+         */
+        invalidateGroupsInfo(groupIds?: string[]): void;
         /**
          * Invalidate all mention suggestions cached by `resolveMentionSuggestions`.
          *
@@ -2174,6 +2246,11 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
      * You should return a list of room info objects of the same size, in the same order.
      */
     resolveRoomsInfo?: (args: ResolveRoomsInfoArgs) => Awaitable<(DRI | undefined)[] | undefined>;
+    /**
+     * A function that returns group info from group IDs.
+     * You should return a list of group info objects of the same size, in the same order.
+     */
+    resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>;
     /**
      * Prevent the current browser tab from being closed if there are any locally
      * pending Liveblocks changes that haven't been submitted to or confirmed by
@@ -3376,7 +3453,7 @@ type PrivateRoomApi = {
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
     reportTextEditor(editor: TextEditorType, rootKey: string): Promise<void>;
-    createTextMention(userId: string, mentionId: string): Promise<void>;
+    createTextMention(mentionId: string, mention: MentionData): Promise<void>;
     deleteTextMention(mentionId: string): Promise<void>;
     listTextVersions(): Promise<{
         versions: HistoryVersion[];
@@ -4154,9 +4231,13 @@ type CommentBodyMentionElementArgs<U extends BaseUserMeta = DU> = {
      */
     element: CommentBodyMention;
     /**
-     * The mention's user info, if the `resolvedUsers` option was provided.
+     * The mention's user info, if the mention is a user mention and the `resolveUsers` option was provided.
      */
     user?: U["info"];
+    /**
+     * The mention's group info, if the mention is a group mention and the `resolveGroupsInfo` option was provided.
+     */
+    group?: DGI;
 };
 type StringifyCommentBodyElements<U extends BaseUserMeta = DU> = {
     /**
@@ -4195,6 +4276,11 @@ type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      * You should return a list of user objects of the same size, in the same order.
      */
     resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>;
+    /**
+     * A function that returns group info from group IDs.
+     * You should return a list of group info objects of the same size, in the same order.
+     */
+    resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>;
 };
 declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
@@ -4206,7 +4292,10 @@ declare function isCommentBodyLink(element: CommentBodyElement): element is Comm
  * `(mention) => mention.kind === "user"` to only get user mentions.
  */
 declare function getMentionsFromCommentBody(body: CommentBody, predicate?: (mention: CommentBodyMention) => boolean): CommentBodyMention[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
+declare function resolveMentionsInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => Awaitable<(U["info"] | undefined)[] | undefined>, resolveGroupsInfo?: (args: ResolveGroupsInfoArgs) => Awaitable<(DGI | undefined)[] | undefined>): Promise<{
+    users: Map<string, U["info"]>;
+    groups: Map<string, DGI>;
+}>;
 declare function htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
     #private;
@@ -4224,6 +4313,8 @@ declare function html(strings: TemplateStringsArray, ...values: (string | string
  */
 declare function stringifyCommentBody(body: CommentBody, options?: StringifyCommentBodyOptions<BaseUserMeta>): Promise<string>;
 
+declare const MENTION_CHARACTER = "@";
+
 /**
  * Converts a plain comment data object (usually returned by the API) to a comment data object that can be used by the client.
  * This is necessary because the plain data object stores dates as ISO strings, but the client expects them as Date objects.
@@ -4266,6 +4357,7 @@ declare function convertToSubscriptionData(data: SubscriptionDataPlain): Subscri
  * @returns The rich user subscription data object that can be used by the client.
  */
 declare function convertToUserSubscriptionData(data: UserSubscriptionDataPlain): UserSubscriptionData;
+declare function convertToGroupData(data: GroupDataPlain): GroupData;
 
 /**
  * Lookup table for nodes (= SerializedCrdt values) by their IDs.
@@ -4782,6 +4874,19 @@ declare function sanitizeUrl(url: string): string | null;
 declare function generateUrl(url: string, params?: Record<string, string | number | undefined>, hash?: string): string;
 declare function isUrl(string: string): boolean;
 
+/**
+ * Emit a warning only once.
+ *
+ * Only has effect in dev mode. In production, this is a no-op.
+ */
+declare function warnOnce(message: string, key?: string): void;
+/**
+ * Emit a warning only once if a condition is met.
+ *
+ * Only has effect in dev mode. In production, this is a no-op.
+ */
+declare function warnOnceIf(condition: boolean | (() => boolean), message: string, key?: string): void;
+
 /**
  * Definition of all messages the Panel can send to the Client.
  */
@@ -4914,4 +5019,4 @@ type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (EnsureJson
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUserMessage, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, 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, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type 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 InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiChatsQuery, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, type AiRetrievalPart, type AiTextPart, type AiToolDefinition, type AiToolExecuteCallback, type AiToolExecuteContext, type AiToolInvocationPart, type AiToolInvocationProps, type AiToolTypePack, type AiUserMessage, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type Awaitable, type BaseActivitiesData, type BaseAuthResult, type BaseGroupInfo, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, type CommentsEventServerMsg, type ContextualPromptContext, type ContextualPromptResponse, type CopilotId, CrdtType, type CreateListOp, type CreateManagedPoolOptions, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type Cursor, type CustomAuthenticationResult, type DAD, type DE, type DGI, type DM, type DP, type DRI, type DS, type DU, DefaultMap, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, Deque, DerivedSignal, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type GroupData, type GroupDataPlain, type GroupMemberData, type GroupMentionData, type GroupScopes, type History, type HistoryVersion, HttpError, type ISignal, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IYjsProvider, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InferFromSchema, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, type LargeMessageStrategy, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LiveblocksErrorContext, type LostConnectionEvent, type Lson, type LsonObject, MENTION_CHARACTER, type ManagedPool, type MentionData, type MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialNotificationSettings, type PartialUnless, type Patchable, Permission, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type Poller, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Relax, type RenderableToolResultResponse, type Resolve, type ResolveGroupsInfoArgs, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomStateServerMsg, type RoomSubscriptionSettings, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, Signal, type SignalType, SortedList, type Status, type StorageStatus, type StorageUpdate, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type SubscriptionData, type SubscriptionDataPlain, type SubscriptionDeleteInfo, type SubscriptionDeleteInfoPlain, type SubscriptionKey, type SyncSource, type SyncStatus, TextEditorType, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type ToolResultResponse, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, type UserMentionData, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, type WithOptional, type WithRequired, type YDocUpdateServerMsg, type YjsSyncStatus, ackOp, asPos, assert, assertNever, autoRetry, b64decode, batch, checkBounds, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToGroupData, convertToInboxNotificationData, convertToSubscriptionData, convertToThreadData, convertToUserSubscriptionData, createClient, createCommentAttachmentId, createCommentId, createInboxNotificationId, createManagedPool, createNotificationSettings, createThreadId, defineAiTool, deprecate, deprecateIf, detectDupes, entries, errorIf, findLastIndex, freeze, generateUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, isUrl, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveMentionsInCommentBody, sanitizeUrl, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, warnOnce, warnOnceIf, withTimeout };