@liveblocks/core 2.25.0-aiprivatebeta14 → 2.25.0-aiprivatebeta15

package/dist/index.d.cts

@@ -1191,8 +1191,10 @@ type CommentBodyParagraph = {
     type: "paragraph";
     children: CommentBodyInlineElement[];
 };
-type CommentBodyMention = {
+type CommentBodyMention = Relax<CommentBodyUserMention>;
+type CommentBodyUserMention = {
     type: "mention";
+    kind: "user";
     id: string;
 };
 type CommentBodyLink = {
@@ -1289,13 +1291,6 @@ type NotificationChannelSettings = {
 type NotificationSettingsPlain = {
     [C in NotificationChannel]?: NotificationChannelSettings;
 };
-/**
- * @deprecated Renamed to `NotificationSettings`
- *
- * Notification settings.
- * One channel for one set of settings.
- */
-type UserNotificationSettings = NotificationSettings;
 /**
  * Notification settings.
  * One channel for one set of settings.
@@ -1362,10 +1357,6 @@ type RoomSubscriptionSettings = {
 type UserRoomSubscriptionSettings = {
     roomId: string;
 } & RoomSubscriptionSettings;
-/**
- * @deprecated Renamed to `RoomSubscriptionSettings`
- */
-type RoomNotificationSettings = RoomSubscriptionSettings;
 
 type SubscriptionData<K extends keyof DAD = keyof DAD> = {
     kind: NotificationKind<K>;
@@ -1818,14 +1809,11 @@ type CommentsOrNotificationsErrorContext = {
     inboxNotificationId: string;
 } | {
     type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" | "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR";
-} | {
-    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
-    roomId: string;
 } | {
     type: "UPDATE_ROOM_SUBSCRIPTION_SETTINGS_ERROR";
     roomId: string;
 } | {
-    type: "UPDATE_USER_NOTIFICATION_SETTINGS_ERROR";
+    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
 };
 type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext | AiConnectionErrorContext>;
 declare class LiveblocksError extends Error {
@@ -1833,8 +1821,6 @@ declare class LiveblocksError extends Error {
     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.
@@ -1842,6 +1828,12 @@ 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.
@@ -1903,7 +1895,7 @@ type InternalSyncStatus = SyncStatus | "has-local-changes";
  */
 type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly currentUserId: Signal<string | undefined>;
-    readonly mentionSuggestionsCache: Map<string, string[]>;
+    readonly mentionSuggestionsCache: Map<string, MentionData[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
@@ -2154,13 +2146,11 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
     backgroundKeepAliveTimeout?: number;
     polyfills?: Polyfills;
     largeMessageStrategy?: LargeMessageStrategy;
-    /** @deprecated Use `largeMessageStrategy="experimental-fallback-to-http"` instead. */
-    unstable_fallbackToHTTP?: boolean;
     unstable_streamData?: boolean;
     /**
-     * A function that returns a list of user IDs matching a string.
+     * A function that returns a list of mention suggestions matching a string.
      */
-    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[]>;
+    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[] | MentionData[]>;
     /**
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
@@ -3012,11 +3002,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly self: Observable<User<P, U>>;
         readonly myPresence: Observable<P>;
         readonly others: Observable<OthersEvent<P, U>>;
-        /**
-         * @deprecated Renamed to `storageBatch`. The `storage` event source will
-         * soon be replaced by another/incompatible API.
-         */
-        readonly storage: Observable<StorageUpdate[]>;
         readonly storageBatch: Observable<StorageUpdate[]>;
         readonly history: Observable<HistoryEvent>;
         /**
@@ -3313,12 +3298,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * await room.getAttachmentUrl("at_xxx");
      */
     getAttachmentUrl(attachmentId: string): Promise<string>;
-    /**
-     * @deprecated Renamed to `getSubscriptionSettings`
-     *
-     * Gets the user's subscription settings for the current room.
-     */
-    getNotificationSettings(options?: GetSubscriptionSettingsOptions): Promise<RoomSubscriptionSettings>;
     /**
      * Gets the user's subscription settings for the current room.
      *
@@ -3326,12 +3305,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * const settings = await room.getSubscriptionSettings();
      */
     getSubscriptionSettings(options?: GetSubscriptionSettingsOptions): Promise<RoomSubscriptionSettings>;
-    /**
-     * @deprecated Renamed to `updateSubscriptionSettings`
-     *
-     * Updates the user's subscription settings for the current room.
-     */
-    updateNotificationSettings(settings: Partial<RoomSubscriptionSettings>): Promise<RoomSubscriptionSettings>;
     /**
      * Updates the user's subscription settings for the current room.
      *
@@ -3630,14 +3603,14 @@ type AbortAiPair = DefineCmd<"abort-ai", {
     ok: true;
 }>;
 type ToolResultData = JsonObject;
-type ToolResultResponse<R extends ToolResultData> = {
+type ToolResultResponse<R extends ToolResultData = ToolResultData> = {
     data: R;
 };
 type SetToolResultPair = DefineCmd<"set-tool-result", {
     chatId: ChatId;
     messageId: MessageId;
     invocationId: string;
-    result: ToolResultData;
+    result: JsonObject;
     generationOptions: AiGenerationOptions;
 }, {
     ok: true;
@@ -4115,9 +4088,12 @@ declare function isCommentBodyText(element: CommentBodyElement): element is Comm
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
 declare function isCommentBodyLink(element: CommentBodyElement): element is CommentBodyLink;
 /**
- * Get an array of each user's ID that has been mentioned in a `CommentBody`.
+ * Get an array of all mentions in a `CommentBody`.
+ *
+ * Narrow results with an optional predicate, e.g.
+ * `(mention) => mention.kind === "user"` to only get user mentions.
  */
-declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
+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 htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
@@ -4820,9 +4796,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]>;
 };
 
-/** @deprecated Use HttpError instead. */
-declare const CommentsApiError: typeof HttpError;
-/** @deprecated Use HttpError instead. */
-declare const NotificationsApiError: typeof HttpError;
-
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, 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, CommentsApiError, 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 MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, NotificationsApiError, 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 Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, 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 ToolResultData, 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 UserNotificationSettings, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, 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, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, 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 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 ToolResultData, 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 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, freeze, generateCommentUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.d.ts

@@ -1191,8 +1191,10 @@ type CommentBodyParagraph = {
     type: "paragraph";
     children: CommentBodyInlineElement[];
 };
-type CommentBodyMention = {
+type CommentBodyMention = Relax<CommentBodyUserMention>;
+type CommentBodyUserMention = {
     type: "mention";
+    kind: "user";
     id: string;
 };
 type CommentBodyLink = {
@@ -1289,13 +1291,6 @@ type NotificationChannelSettings = {
 type NotificationSettingsPlain = {
     [C in NotificationChannel]?: NotificationChannelSettings;
 };
-/**
- * @deprecated Renamed to `NotificationSettings`
- *
- * Notification settings.
- * One channel for one set of settings.
- */
-type UserNotificationSettings = NotificationSettings;
 /**
  * Notification settings.
  * One channel for one set of settings.
@@ -1362,10 +1357,6 @@ type RoomSubscriptionSettings = {
 type UserRoomSubscriptionSettings = {
     roomId: string;
 } & RoomSubscriptionSettings;
-/**
- * @deprecated Renamed to `RoomSubscriptionSettings`
- */
-type RoomNotificationSettings = RoomSubscriptionSettings;
 
 type SubscriptionData<K extends keyof DAD = keyof DAD> = {
     kind: NotificationKind<K>;
@@ -1818,14 +1809,11 @@ type CommentsOrNotificationsErrorContext = {
     inboxNotificationId: string;
 } | {
     type: "MARK_ALL_INBOX_NOTIFICATIONS_AS_READ_ERROR" | "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR";
-} | {
-    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
-    roomId: string;
 } | {
     type: "UPDATE_ROOM_SUBSCRIPTION_SETTINGS_ERROR";
     roomId: string;
 } | {
-    type: "UPDATE_USER_NOTIFICATION_SETTINGS_ERROR";
+    type: "UPDATE_NOTIFICATION_SETTINGS_ERROR";
 };
 type LiveblocksErrorContext = Relax<RoomConnectionErrorContext | CommentsOrNotificationsErrorContext | AiConnectionErrorContext>;
 declare class LiveblocksError extends Error {
@@ -1833,8 +1821,6 @@ declare class LiveblocksError extends Error {
     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.
@@ -1842,6 +1828,12 @@ 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.
@@ -1903,7 +1895,7 @@ type InternalSyncStatus = SyncStatus | "has-local-changes";
  */
 type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly currentUserId: Signal<string | undefined>;
-    readonly mentionSuggestionsCache: Map<string, string[]>;
+    readonly mentionSuggestionsCache: Map<string, MentionData[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
@@ -2154,13 +2146,11 @@ type ClientOptions<U extends BaseUserMeta = DU> = {
     backgroundKeepAliveTimeout?: number;
     polyfills?: Polyfills;
     largeMessageStrategy?: LargeMessageStrategy;
-    /** @deprecated Use `largeMessageStrategy="experimental-fallback-to-http"` instead. */
-    unstable_fallbackToHTTP?: boolean;
     unstable_streamData?: boolean;
     /**
-     * A function that returns a list of user IDs matching a string.
+     * A function that returns a list of mention suggestions matching a string.
      */
-    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[]>;
+    resolveMentionSuggestions?: (args: ResolveMentionSuggestionsArgs) => Awaitable<string[] | MentionData[]>;
     /**
      * A function that returns user info from user IDs.
      * You should return a list of user objects of the same size, in the same order.
@@ -3012,11 +3002,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
         readonly self: Observable<User<P, U>>;
         readonly myPresence: Observable<P>;
         readonly others: Observable<OthersEvent<P, U>>;
-        /**
-         * @deprecated Renamed to `storageBatch`. The `storage` event source will
-         * soon be replaced by another/incompatible API.
-         */
-        readonly storage: Observable<StorageUpdate[]>;
         readonly storageBatch: Observable<StorageUpdate[]>;
         readonly history: Observable<HistoryEvent>;
         /**
@@ -3313,12 +3298,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * await room.getAttachmentUrl("at_xxx");
      */
     getAttachmentUrl(attachmentId: string): Promise<string>;
-    /**
-     * @deprecated Renamed to `getSubscriptionSettings`
-     *
-     * Gets the user's subscription settings for the current room.
-     */
-    getNotificationSettings(options?: GetSubscriptionSettingsOptions): Promise<RoomSubscriptionSettings>;
     /**
      * Gets the user's subscription settings for the current room.
      *
@@ -3326,12 +3305,6 @@ type Room<P extends JsonObject = DP, S extends LsonObject = DS, U extends BaseUs
      * const settings = await room.getSubscriptionSettings();
      */
     getSubscriptionSettings(options?: GetSubscriptionSettingsOptions): Promise<RoomSubscriptionSettings>;
-    /**
-     * @deprecated Renamed to `updateSubscriptionSettings`
-     *
-     * Updates the user's subscription settings for the current room.
-     */
-    updateNotificationSettings(settings: Partial<RoomSubscriptionSettings>): Promise<RoomSubscriptionSettings>;
     /**
      * Updates the user's subscription settings for the current room.
      *
@@ -3630,14 +3603,14 @@ type AbortAiPair = DefineCmd<"abort-ai", {
     ok: true;
 }>;
 type ToolResultData = JsonObject;
-type ToolResultResponse<R extends ToolResultData> = {
+type ToolResultResponse<R extends ToolResultData = ToolResultData> = {
     data: R;
 };
 type SetToolResultPair = DefineCmd<"set-tool-result", {
     chatId: ChatId;
     messageId: MessageId;
     invocationId: string;
-    result: ToolResultData;
+    result: JsonObject;
     generationOptions: AiGenerationOptions;
 }, {
     ok: true;
@@ -4115,9 +4088,12 @@ declare function isCommentBodyText(element: CommentBodyElement): element is Comm
 declare function isCommentBodyMention(element: CommentBodyElement): element is CommentBodyMention;
 declare function isCommentBodyLink(element: CommentBodyElement): element is CommentBodyLink;
 /**
- * Get an array of each user's ID that has been mentioned in a `CommentBody`.
+ * Get an array of all mentions in a `CommentBody`.
+ *
+ * Narrow results with an optional predicate, e.g.
+ * `(mention) => mention.kind === "user"` to only get user mentions.
  */
-declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
+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 htmlSafe(value: string): HtmlSafeString;
 declare class HtmlSafeString {
@@ -4820,9 +4796,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]>;
 };
 
-/** @deprecated Use HttpError instead. */
-declare const CommentsApiError: typeof HttpError;
-/** @deprecated Use HttpError instead. */
-declare const NotificationsApiError: typeof HttpError;
-
-export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, 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, CommentsApiError, 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 MessageId, MutableSignal, type NoInfr, type NodeMap, type NotificationChannel, type NotificationChannelSettings, type NotificationKind, type NotificationSettings, type NotificationSettingsPlain, NotificationsApiError, 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 Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, 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 ToolResultData, 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 UserNotificationSettings, type UserRoomSubscriptionSettings, type UserSubscriptionData, type UserSubscriptionDataPlain, WebsocketCloseCodes, type WithNavigation, 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, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AiAssistantContentPart, type AiAssistantMessage, type AiChat, type AiChatMessage, type AiKnowledgeSource, type AiOpaqueToolDefinition, type AiOpaqueToolInvocationProps, type AiReasoningPart, 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 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 ToolResultData, 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 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, freeze, generateCommentUrl, getMentionsFromCommentBody, getSubscriptionKey, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isNotificationChannelEnabled, isPlainObject, isRootCrdt, isStartsWithOperator, kInternal, keys, legacy_patchImmutableObject, lsonToJson, makeAbortController, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, patchNotificationSettings, raise, resolveUsersInCommentBody, shallow, shallow2, stableStringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/core";
-var PKG_VERSION = "2.25.0-aiprivatebeta14";
+var PKG_VERSION = "2.25.0-aiprivatebeta15";
 var PKG_FORMAT = "esm";
 
 // src/dupe-detection.ts
@@ -7776,7 +7776,7 @@ var LiveblocksError = class _LiveblocksError extends Error {
   get roomId() {
     return this.context.roomId;
   }
-  /** @deprecated Prefer using `context.code` instead, to enable type narrowing */
+  /** @internal Use `context.code` instead, to enable type narrowing */
   get code() {
     return this.context.code;
   }
@@ -7846,11 +7846,9 @@ function defaultMessageFromContext(context) {
       return "Could not mark all inbox notifications as read";
     case "DELETE_ALL_INBOX_NOTIFICATIONS_ERROR":
       return "Could not delete all inbox notifications";
-    case "UPDATE_NOTIFICATION_SETTINGS_ERROR":
-      return "Could not update notification settings";
     case "UPDATE_ROOM_SUBSCRIPTION_SETTINGS_ERROR":
       return "Could not update room subscription settings";
-    case "UPDATE_USER_NOTIFICATION_SETTINGS_ERROR":
+    case "UPDATE_NOTIFICATION_SETTINGS_ERROR":
       return "Could not update notification settings";
     default:
       return assertNever(context, "Unhandled case");
@@ -8983,8 +8981,6 @@ ${Array.from(traces).join("\n\n")}`
     others: eventHub.others.observable,
     self: eventHub.self.observable,
     myPresence: eventHub.myPresence.observable,
-    /** @deprecated */
-    storage: eventHub.storageBatch.observable,
     storageBatch: eventHub.storageBatch.observable,
     history: eventHub.history.observable,
     storageDidLoad: eventHub.storageDidLoad.observable,
@@ -9501,7 +9497,7 @@ function createClient(options) {
         enableDebugLogging: clientOptions.enableDebugLogging,
         baseUrl,
         errorEventSource: liveblocksErrorSource,
-        largeMessageStrategy: clientOptions.largeMessageStrategy ?? (clientOptions.unstable_fallbackToHTTP ? "experimental-fallback-to-http" : void 0),
+        largeMessageStrategy: clientOptions.largeMessageStrategy,
         unstable_streamData: !!clientOptions.unstable_streamData,
         roomHttpClient: httpClient,
         createSyncSource
@@ -9781,21 +9777,30 @@ function traverseCommentBody(body, elementOrVisitor, possiblyVisitor) {
     }
   }
 }
-function getMentionedIdsFromCommentBody(body) {
-  const mentionedIds = /* @__PURE__ */ new Set();
-  traverseCommentBody(
-    body,
-    "mention",
-    (mention) => mentionedIds.add(mention.id)
-  );
-  return Array.from(mentionedIds);
+function getMentionsFromCommentBody(body, predicate) {
+  const mentionIds = /* @__PURE__ */ new Set();
+  const mentions = [];
+  traverseCommentBody(body, "mention", (mention) => {
+    if (
+      // If this mention isn't already in the list
+      !mentionIds.has(mention.id) && // And the provided predicate is true
+      (predicate ? predicate(mention) : true)
+    ) {
+      mentionIds.add(mention.id);
+      mentions.push(mention);
+    }
+  });
+  return mentions;
 }
 async function resolveUsersInCommentBody(body, resolveUsers) {
   const resolvedUsers = /* @__PURE__ */ new Map();
   if (!resolveUsers) {
     return resolvedUsers;
   }
-  const userIds = getMentionedIdsFromCommentBody(body);
+  const userIds = getMentionsFromCommentBody(
+    body,
+    (mention) => mention.kind === "user"
+  ).map((mention) => mention.id);
   const users = await resolveUsers({
     userIds
   });
@@ -10558,11 +10563,8 @@ var TextEditorType = /* @__PURE__ */ ((TextEditorType2) => {
 
 // src/index.ts
 detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
-var CommentsApiError = HttpError;
-var NotificationsApiError = HttpError;
 export {
   ClientMsgCode,
-  CommentsApiError,
   CrdtType,
   DefaultMap,
   Deque,
@@ -10573,7 +10575,6 @@ export {
   LiveObject,
   LiveblocksError,
   MutableSignal,
-  NotificationsApiError,
   OpCode,
   Permission,
   Promise_withResolvers,
@@ -10615,7 +10616,7 @@ export {
   errorIf,
   freeze,
   generateCommentUrl,
-  getMentionedIdsFromCommentBody,
+  getMentionsFromCommentBody,
   getSubscriptionKey,
   html,
   htmlSafe,