@liveblocks/core 2.9.3-emails1 → 2.10.0

package/dist/index.d.mts

@@ -381,6 +381,7 @@ declare type LiveListUpdateDelta = {
 } | {
     type: "delete";
     index: number;
+    deletedItem: Lson;
 } | {
     type: "move";
     index: number;
@@ -935,6 +936,7 @@ declare function makeEventSource<T>(): EventSource<T>;
 declare type BatchStore<O, I> = Observable<void> & {
     get: (input: I) => Promise<void>;
     getState: (input: I) => AsyncResult<O> | undefined;
+    invalidate: (inputs?: I[]) => void;
 };
 
 /**
@@ -2370,6 +2372,7 @@ declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS>
  */
 declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly currentUserIdStore: Store<string | null>;
+    readonly mentionSuggestionsCache: Map<string, string[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
@@ -2519,6 +2522,43 @@ declare type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> =
      * Call this whenever you log out a user in your application.
      */
     logout(): void;
+    /**
+     * Advanced APIs related to the resolvers.
+     */
+    resolvers: {
+        /**
+         * Invalidate some or all users that were previously cached by `resolveUsers`.
+         *
+         * @example
+         * // Invalidate all users
+         * client.resolvers.invalidateUsers();
+         *
+         * @example
+         * // Invalidate specific users
+         * client.resolvers.invalidateUsers(["user-1", "user-2"]);
+         */
+        invalidateUsers(userIds?: string[]): void;
+        /**
+         * Invalidate some or all rooms info that were previously cached by `resolveRoomsInfo`.
+         *
+         * @example
+         * // Invalidate all rooms
+         * client.resolvers.invalidateRoomsInfo();
+         *
+         * @example
+         * // Invalidate specific rooms
+         * client.resolvers.invalidateRoomsInfo(["room-1", "room-2"]);
+         */
+        invalidateRoomsInfo(roomIds?: string[]): void;
+        /**
+         * Invalidate all mention suggestions cached by `resolveMentionSuggestions`.
+         *
+         * @example
+         * // Invalidate all mention suggestions
+         * client.resolvers.invalidateMentionSuggestions();
+         */
+        invalidateMentionSuggestions(): void;
+    };
     /**
      * @private
      *
@@ -2665,44 +2705,16 @@ declare type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      */
     resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
 };
-declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
-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`.
  */
 declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
-declare function htmlSafe(value: string): HtmlSafeString;
-declare class HtmlSafeString {
-    private _strings;
-    private _values;
-    constructor(strings: readonly string[], values: readonly (string | string[] | HtmlSafeString | HtmlSafeString[])[]);
-    toString(): string;
-}
-/**
- * Build an HTML string from a template literal where the values are escaped.
- * Nested calls are supported and won't be escaped.
- */
-declare function html(strings: TemplateStringsArray, ...values: (string | string[] | HtmlSafeString | HtmlSafeString[])[]): string;
-/**
- * Helper function to convert a URL (relative or absolute) to an absolute URL.
- *
- * @param url The URL to convert to an absolute URL (relative or absolute).
- * @returns The absolute URL or undefined if the URL is invalid.
- */
-declare function toAbsoluteUrl(url: string): string | undefined;
 /**
  * Convert a `CommentBody` into either a plain string,
  * Markdown, HTML, or a custom format.
  */
 declare function stringifyCommentBody(body: CommentBody, options?: StringifyCommentBodyOptions<BaseUserMeta>): Promise<string>;
 
-declare function generateCommentUrl({ roomUrl, commentId, }: {
-    roomUrl: string;
-    commentId: string;
-}): string;
-
 /**
  * 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.
@@ -2815,15 +2827,6 @@ declare class StopRetrying extends Error {
 
 declare function chunk<T>(array: T[], size: number): T[][];
 
-/**
- * Drop-in replacement for the ES2024 Promise.withResolvers() API.
- */
-declare function Promise_withResolvers<T>(): {
-    promise: Promise<T>;
-    resolve: (value: T) => void;
-    reject: (reason: unknown) => void;
-};
-
 declare function createThreadId(): string;
 declare function createCommentId(): string;
 declare function createInboxNotificationId(): string;
@@ -3213,4 +3216,4 @@ declare type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (En
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, StopRetrying, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, StopRetrying, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, shallow, stringify, stringifyCommentBody, throwUsageError, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };

package/dist/index.d.ts

@@ -381,6 +381,7 @@ declare type LiveListUpdateDelta = {
 } | {
     type: "delete";
     index: number;
+    deletedItem: Lson;
 } | {
     type: "move";
     index: number;
@@ -935,6 +936,7 @@ declare function makeEventSource<T>(): EventSource<T>;
 declare type BatchStore<O, I> = Observable<void> & {
     get: (input: I) => Promise<void>;
     getState: (input: I) => AsyncResult<O> | undefined;
+    invalidate: (inputs?: I[]) => void;
 };
 
 /**
@@ -2370,6 +2372,7 @@ declare type EnterOptions<P extends JsonObject = DP, S extends LsonObject = DS>
  */
 declare type PrivateClientApi<U extends BaseUserMeta, M extends BaseMetadata> = {
     readonly currentUserIdStore: Store<string | null>;
+    readonly mentionSuggestionsCache: Map<string, string[]>;
     readonly resolveMentionSuggestions: ClientOptions<U>["resolveMentionSuggestions"];
     readonly usersStore: BatchStore<U["info"] | undefined, string>;
     readonly roomsInfoStore: BatchStore<DRI | undefined, string>;
@@ -2519,6 +2522,43 @@ declare type Client<U extends BaseUserMeta = DU, M extends BaseMetadata = DM> =
      * Call this whenever you log out a user in your application.
      */
     logout(): void;
+    /**
+     * Advanced APIs related to the resolvers.
+     */
+    resolvers: {
+        /**
+         * Invalidate some or all users that were previously cached by `resolveUsers`.
+         *
+         * @example
+         * // Invalidate all users
+         * client.resolvers.invalidateUsers();
+         *
+         * @example
+         * // Invalidate specific users
+         * client.resolvers.invalidateUsers(["user-1", "user-2"]);
+         */
+        invalidateUsers(userIds?: string[]): void;
+        /**
+         * Invalidate some or all rooms info that were previously cached by `resolveRoomsInfo`.
+         *
+         * @example
+         * // Invalidate all rooms
+         * client.resolvers.invalidateRoomsInfo();
+         *
+         * @example
+         * // Invalidate specific rooms
+         * client.resolvers.invalidateRoomsInfo(["room-1", "room-2"]);
+         */
+        invalidateRoomsInfo(roomIds?: string[]): void;
+        /**
+         * Invalidate all mention suggestions cached by `resolveMentionSuggestions`.
+         *
+         * @example
+         * // Invalidate all mention suggestions
+         * client.resolvers.invalidateMentionSuggestions();
+         */
+        invalidateMentionSuggestions(): void;
+    };
     /**
      * @private
      *
@@ -2665,44 +2705,16 @@ declare type StringifyCommentBodyOptions<U extends BaseUserMeta = DU> = {
      */
     resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>;
 };
-declare function isCommentBodyText(element: CommentBodyElement): element is CommentBodyText;
-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`.
  */
 declare function getMentionedIdsFromCommentBody(body: CommentBody): string[];
-declare function resolveUsersInCommentBody<U extends BaseUserMeta>(body: CommentBody, resolveUsers?: (args: ResolveUsersArgs) => OptionalPromise<(U["info"] | undefined)[] | undefined>): Promise<Map<string, U["info"]>>;
-declare function htmlSafe(value: string): HtmlSafeString;
-declare class HtmlSafeString {
-    private _strings;
-    private _values;
-    constructor(strings: readonly string[], values: readonly (string | string[] | HtmlSafeString | HtmlSafeString[])[]);
-    toString(): string;
-}
-/**
- * Build an HTML string from a template literal where the values are escaped.
- * Nested calls are supported and won't be escaped.
- */
-declare function html(strings: TemplateStringsArray, ...values: (string | string[] | HtmlSafeString | HtmlSafeString[])[]): string;
-/**
- * Helper function to convert a URL (relative or absolute) to an absolute URL.
- *
- * @param url The URL to convert to an absolute URL (relative or absolute).
- * @returns The absolute URL or undefined if the URL is invalid.
- */
-declare function toAbsoluteUrl(url: string): string | undefined;
 /**
  * Convert a `CommentBody` into either a plain string,
  * Markdown, HTML, or a custom format.
  */
 declare function stringifyCommentBody(body: CommentBody, options?: StringifyCommentBodyOptions<BaseUserMeta>): Promise<string>;
 
-declare function generateCommentUrl({ roomUrl, commentId, }: {
-    roomUrl: string;
-    commentId: string;
-}): string;
-
 /**
  * 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.
@@ -2815,15 +2827,6 @@ declare class StopRetrying extends Error {
 
 declare function chunk<T>(array: T[], size: number): T[][];
 
-/**
- * Drop-in replacement for the ES2024 Promise.withResolvers() API.
- */
-declare function Promise_withResolvers<T>(): {
-    promise: Promise<T>;
-    resolve: (value: T) => void;
-    reject: (reason: unknown) => void;
-};
-
 declare function createThreadId(): string;
 declare function createCommentId(): string;
 declare function createInboxNotificationId(): string;
@@ -3213,4 +3216,4 @@ declare type EnsureJson<T> = T extends Json ? T : T extends Array<infer I> ? (En
     [K in keyof T as EnsureJson<T[K]> extends never ? never : K]: EnsureJson<T[K]>;
 };
 
-export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, Promise_withResolvers, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, StopRetrying, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, generateCommentUrl, getMentionedIdsFromCommentBody, html, htmlSafe, isChildCrdt, isCommentBodyLink, isCommentBodyMention, isCommentBodyText, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, resolveUsersInCommentBody, shallow, stringify, stringifyCommentBody, throwUsageError, toAbsoluteUrl, toPlainLson, tryParseJson, url, urljoin, wait, withTimeout };
+export { type AckOp, type ActivityData, type AsyncError, type AsyncLoading, type AsyncResult, type AsyncSuccess, type BaseActivitiesData, type BaseAuthResult, type BaseMetadata, type BaseRoomInfo, type BaseUserMeta, type Brand, type BroadcastEventClientMsg, type BroadcastOptions, type BroadcastedEventServerMsg, type Client, type ClientMsg, ClientMsgCode, type ClientOptions, type CommentAttachment, type CommentBody, type CommentBodyBlockElement, type CommentBodyElement, type CommentBodyInlineElement, type CommentBodyLink, type CommentBodyLinkElementArgs, type CommentBodyMention, type CommentBodyMentionElementArgs, type CommentBodyParagraph, type CommentBodyParagraphElementArgs, type CommentBodyText, type CommentBodyTextElementArgs, type CommentData, type CommentDataPlain, type CommentLocalAttachment, type CommentMixedAttachment, type CommentReaction, type CommentUserReaction, type CommentUserReactionPlain, CommentsApiError, type CommentsEventServerMsg, CrdtType, type CreateListOp, type CreateMapOp, type CreateObjectOp, type CreateOp, type CreateRegisterOp, type CustomAuthenticationResult, type DAD, type DE, type DM, type DP, type DRI, type DS, type DU, type Delegates, type DeleteCrdtOp, type DeleteObjectKeyOp, DevToolsTreeNode as DevTools, protocol as DevToolsMsg, type DistributiveOmit, type EnsureJson, type EnterOptions, type EventSource, type FetchStorageClientMsg, type FetchYDocClientMsg, type GetThreadsOptions, type History, type HistoryVersion, type IUserInfo, type IWebSocket, type IWebSocketCloseEvent, type IWebSocketEvent, type IWebSocketInstance, type IWebSocketMessageEvent, type IdTuple, type Immutable, type InboxNotificationCustomData, type InboxNotificationCustomDataPlain, type InboxNotificationData, type InboxNotificationDataPlain, type InboxNotificationDeleteInfo, type InboxNotificationTextMentionData, type InboxNotificationTextMentionDataPlain, type InboxNotificationThreadData, type InboxNotificationThreadDataPlain, type InitialDocumentStateServerMsg, type Json, type JsonArray, type JsonObject, type JsonScalar, type KDAD, LiveList, type LiveListUpdate, LiveMap, type LiveMapUpdate, type LiveNode, LiveObject, type LiveObjectUpdate, type LiveStructure, LiveblocksError, type LostConnectionEvent, type Lson, type LsonObject, type NoInfr, type NodeMap, NotificationsApiError, type Observable, type Op, OpCode, type OpaqueClient, type OpaqueRoom, type OptionalPromise, type OptionalTupleUnless, type OthersEvent, type ParentToChildNodeMap, type PartialUnless, type Patchable, type PlainLson, type PlainLsonFields, type PlainLsonList, type PlainLsonMap, type PlainLsonObject, type PrivateClientApi, type PrivateRoomApi, type QueryMetadata, type QueryParams, type RejectedStorageOpServerMsg, type Resolve, type ResolveMentionSuggestionsArgs, type ResolveRoomsInfoArgs, type ResolveUsersArgs, type Room, type RoomEventMessage, type RoomNotificationSettings, type RoomStateServerMsg, type SerializedChild, type SerializedCrdt, type SerializedList, type SerializedMap, type SerializedObject, type SerializedRegister, type SerializedRootObject, type ServerMsg, ServerMsgCode, type SetParentKeyOp, type Status, StopRetrying, type StorageStatus, type StorageUpdate, type Store, type StringifyCommentBodyElements, type StringifyCommentBodyOptions, type ThreadData, type ThreadDataPlain, type ThreadDataWithDeleteInfo, type ThreadDeleteInfo, type ToImmutable, type ToJson, type URLSafeString, type UnsubscribeCallback, type UpdateObjectOp, type UpdatePresenceClientMsg, type UpdatePresenceServerMsg, type UpdateStorageClientMsg, type UpdateStorageServerMsg, type UpdateYDocClientMsg, type UploadAttachmentOptions, type User, type UserJoinServerMsg, type UserLeftServerMsg, WebsocketCloseCodes, type YDocUpdateServerMsg, ackOp, asPos, assert, assertNever, autoRetry, b64decode, chunk, cloneLson, compactObject, fancyConsole as console, convertToCommentData, convertToCommentUserReaction, convertToInboxNotificationData, convertToThreadData, createClient, createCommentId, createInboxNotificationId, createStore, createThreadId, deprecate, deprecateIf, detectDupes, errorIf, freeze, getMentionedIdsFromCommentBody, isChildCrdt, isJsonArray, isJsonObject, isJsonScalar, isLiveNode, isPlainObject, isRootCrdt, kInternal, legacy_patchImmutableObject, lsonToJson, makeEventSource, makePoller, makePosition, mapValues, memoizeOnSuccess, nanoid, nn, objectToQuery, patchLiveObjectKey, raise, shallow, stringify, stringifyCommentBody, throwUsageError, 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.9.3-emails1";
+var PKG_VERSION = "2.10.0";
 var PKG_FORMAT = "cjs";
 
 // src/dupe-detection.ts
@@ -1881,6 +1881,16 @@ function createBatchStore(batch) {
     cache.set(cacheKey, state);
     eventSource2.notify();
   }
+  function invalidate(inputs) {
+    if (Array.isArray(inputs)) {
+      for (const input of inputs) {
+        cache.delete(getCacheKey(input));
+      }
+    } else {
+      cache.clear();
+    }
+    eventSource2.notify();
+  }
   async function get(input) {
     const cacheKey = getCacheKey(input);
     if (cache.has(cacheKey)) {
@@ -1901,10 +1911,15 @@ function createBatchStore(batch) {
     const cacheKey = getCacheKey(input);
     return cache.get(cacheKey);
   }
+  function _cacheKeys() {
+    return [...cache.keys()];
+  }
   return {
     ...eventSource2.observable,
     get,
-    getState
+    getState,
+    invalidate,
+    _cacheKeys
   };
 }
 
@@ -2868,15 +2883,15 @@ var LiveList = class _LiveList extends AbstractCrdt {
         this._implicitlyDeletedItems.add(
           this._items[indexOfItemWithSamePosition]
         );
-        this._items.splice(indexOfItemWithSamePosition, 1);
-        delta.push(deleteDelta(indexOfItemWithSamePosition));
+        const [prevNode] = this._items.splice(indexOfItemWithSamePosition, 1);
+        delta.push(deleteDelta(indexOfItemWithSamePosition, prevNode));
       }
-      const previousIndex = this._items.indexOf(existingItem);
+      const prevIndex = this._items.indexOf(existingItem);
       existingItem._setParentLink(this, op.parentKey);
       this._sortItems();
       const newIndex = this._items.indexOf(existingItem);
-      if (newIndex !== previousIndex) {
-        delta.push(moveDelta(previousIndex, newIndex, existingItem));
+      if (newIndex !== prevIndex) {
+        delta.push(moveDelta(prevIndex, newIndex, existingItem));
       }
       return {
         modified: delta.length > 0 ? makeUpdate(this, delta) : false,
@@ -3105,11 +3120,11 @@ var LiveList = class _LiveList extends AbstractCrdt {
           modified: false
         };
       }
-      this._items.splice(indexToDelete, 1);
+      const [previousNode] = this._items.splice(indexToDelete, 1);
       this.invalidate();
       child._detach();
       return {
-        modified: makeUpdate(this, [deleteDelta(indexToDelete)]),
+        modified: makeUpdate(this, [deleteDelta(indexToDelete, previousNode)]),
         reverse
       };
     }
@@ -3387,7 +3402,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
     }
     const item = this._items[index];
     item._detach();
-    this._items.splice(index, 1);
+    const [prev] = this._items.splice(index, 1);
     this.invalidate();
     if (this._pool) {
       const childRecordId = item._id;
@@ -3395,7 +3410,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
         const storageUpdates = /* @__PURE__ */ new Map();
         storageUpdates.set(
           nn(this._id),
-          makeUpdate(this, [deleteDelta(index)])
+          makeUpdate(this, [deleteDelta(index, prev)])
         );
         this._pool.dispatch(
           [
@@ -3429,7 +3444,7 @@ var LiveList = class _LiveList extends AbstractCrdt {
           reverseOps.push(
             ...item._toOps(nn(this._id), item._getParentKeyOrThrow())
           );
-          updateDelta.push(deleteDelta(0));
+          updateDelta.push(deleteDelta(0, item));
         }
       }
       this._items = [];
@@ -3654,10 +3669,11 @@ function setDelta(index, item) {
     item: item instanceof LiveRegister ? item.data : item
   };
 }
-function deleteDelta(index) {
+function deleteDelta(index, deletedNode) {
   return {
+    type: "delete",
     index,
-    type: "delete"
+    deletedItem: deletedNode instanceof LiveRegister ? deletedNode.data : deletedNode
   };
 }
 function insertDelta(index, item) {
@@ -3669,10 +3685,10 @@ function insertDelta(index, item) {
 }
 function moveDelta(previousIndex, index, item) {
   return {
-    index,
     type: "move",
-    previousIndex,
-    item: item instanceof LiveRegister ? item.data : item
+    index,
+    item: item instanceof LiveRegister ? item.data : item,
+    previousIndex
   };
 }
 function HACK_addIntentAndDeletedIdToOperation(ops, deletedId) {
@@ -7329,6 +7345,9 @@ function createClient(options) {
     { delay: RESOLVE_USERS_BATCH_DELAY }
   );
   const usersStore = createBatchStore(batchedResolveUsers);
+  function invalidateResolvedUsers(userIds) {
+    usersStore.invalidate(userIds);
+  }
   const resolveRoomsInfo = clientOptions.resolveRoomsInfo;
   const warnIfNoResolveRoomsInfo = createDevelopmentWarning(
     () => !resolveRoomsInfo,
@@ -7344,15 +7363,29 @@ function createClient(options) {
     { delay: RESOLVE_ROOMS_INFO_BATCH_DELAY }
   );
   const roomsInfoStore = createBatchStore(batchedResolveRoomsInfo);
+  function invalidateResolvedRoomsInfo(roomIds) {
+    roomsInfoStore.invalidate(roomIds);
+  }
+  const mentionSuggestionsCache = /* @__PURE__ */ new Map();
+  function invalidateResolvedMentionSuggestions() {
+    mentionSuggestionsCache.clear();
+  }
   return Object.defineProperty(
     {
       enterRoom,
       getRoom,
       logout,
       ...httpClientLike,
+      // Advanced resolvers APIs
+      resolvers: {
+        invalidateUsers: invalidateResolvedUsers,
+        invalidateRoomsInfo: invalidateResolvedRoomsInfo,
+        invalidateMentionSuggestions: invalidateResolvedMentionSuggestions
+      },
       // Internal
       [kInternal]: {
         currentUserIdStore,
+        mentionSuggestionsCache,
         resolveMentionSuggestions: clientOptions.resolveMentionSuggestions,
         usersStore,
         roomsInfoStore,
@@ -7730,22 +7763,6 @@ async function stringifyCommentBody(body, options) {
   return blocks.join(separator);
 }
 
-// src/comments/comment-url.ts
-var PLACEHOLDER_BASE_URL = "https://localhost:9999";
-var ABSOLUTE_URL_REGEX = /^[a-zA-Z][a-zA-Z\d+\-.]*?:/;
-function generateCommentUrl({
-  roomUrl,
-  commentId
-}) {
-  const isAbsolute = ABSOLUTE_URL_REGEX.test(roomUrl);
-  const urlObject = new URL(
-    roomUrl,
-    isAbsolute ? void 0 : PLACEHOLDER_BASE_URL
-  );
-  urlObject.hash = `#${commentId}`;
-  return isAbsolute ? urlObject.href : urlObject.href.replace(PLACEHOLDER_BASE_URL, "");
-}
-
 // src/crdts/utils.ts
 function toPlainLson(lson) {
   if (lson instanceof LiveObject) {
@@ -8261,14 +8278,5 @@ detectDupes(PKG_NAME, PKG_VERSION, PKG_FORMAT);
 
 
 
-
-
-
-
-
-
-
-
-
-exports.ClientMsgCode = ClientMsgCode; exports.CommentsApiError = CommentsApiError; exports.CrdtType = CrdtType; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.NotificationsApiError = NotificationsApiError; exports.OpCode = OpCode; exports.Promise_withResolvers = Promise_withResolvers; exports.ServerMsgCode = ServerMsgCode; exports.StopRetrying = StopRetrying2; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.ackOp = ackOp; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToThreadData = convertToThreadData; exports.createClient = createClient; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createStore = createStore; exports.createThreadId = createThreadId; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.errorIf = errorIf; exports.freeze = freeze; exports.generateCommentUrl = generateCommentUrl; exports.getMentionedIdsFromCommentBody = getMentionedIdsFromCommentBody; exports.html = html; exports.htmlSafe = htmlSafe; exports.isChildCrdt = isChildCrdt; exports.isCommentBodyLink = isCommentBodyLink; exports.isCommentBodyMention = isCommentBodyMention; exports.isCommentBodyText = isCommentBodyText; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.kInternal = kInternal; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.raise = raise; exports.resolveUsersInCommentBody = resolveUsersInCommentBody; exports.shallow = shallow; exports.stringify = stringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toAbsoluteUrl = toAbsoluteUrl; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.withTimeout = withTimeout;
+exports.ClientMsgCode = ClientMsgCode; exports.CommentsApiError = CommentsApiError; exports.CrdtType = CrdtType; exports.LiveList = LiveList; exports.LiveMap = LiveMap; exports.LiveObject = LiveObject; exports.NotificationsApiError = NotificationsApiError; exports.OpCode = OpCode; exports.ServerMsgCode = ServerMsgCode; exports.StopRetrying = StopRetrying2; exports.WebsocketCloseCodes = WebsocketCloseCodes; exports.ackOp = ackOp; exports.asPos = asPos; exports.assert = assert; exports.assertNever = assertNever; exports.autoRetry = autoRetry; exports.b64decode = b64decode; exports.chunk = chunk; exports.cloneLson = cloneLson; exports.compactObject = compactObject; exports.console = fancy_console_exports; exports.convertToCommentData = convertToCommentData; exports.convertToCommentUserReaction = convertToCommentUserReaction; exports.convertToInboxNotificationData = convertToInboxNotificationData; exports.convertToThreadData = convertToThreadData; exports.createClient = createClient; exports.createCommentId = createCommentId; exports.createInboxNotificationId = createInboxNotificationId; exports.createStore = createStore; exports.createThreadId = createThreadId; exports.deprecate = deprecate; exports.deprecateIf = deprecateIf; exports.detectDupes = detectDupes; exports.errorIf = errorIf; exports.freeze = freeze; exports.getMentionedIdsFromCommentBody = getMentionedIdsFromCommentBody; exports.isChildCrdt = isChildCrdt; exports.isJsonArray = isJsonArray; exports.isJsonObject = isJsonObject; exports.isJsonScalar = isJsonScalar; exports.isLiveNode = isLiveNode; exports.isPlainObject = isPlainObject; exports.isRootCrdt = isRootCrdt; exports.kInternal = kInternal; exports.legacy_patchImmutableObject = legacy_patchImmutableObject; exports.lsonToJson = lsonToJson; exports.makeEventSource = makeEventSource; exports.makePoller = makePoller; exports.makePosition = makePosition; exports.mapValues = mapValues; exports.memoizeOnSuccess = memoizeOnSuccess; exports.nanoid = nanoid; exports.nn = nn; exports.objectToQuery = objectToQuery; exports.patchLiveObjectKey = patchLiveObjectKey; exports.raise = raise; exports.shallow = shallow; exports.stringify = stringify; exports.stringifyCommentBody = stringifyCommentBody; exports.throwUsageError = throwUsageError; exports.toPlainLson = toPlainLson; exports.tryParseJson = tryParseJson; exports.url = url; exports.urljoin = urljoin; exports.wait = wait; exports.withTimeout = withTimeout;
 //# sourceMappingURL=index.js.map