@liveblocks/core 2.9.3-experimental1 → 2.10.0

package/dist/index.d.mts

@@ -936,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;
 };
 
 /**
@@ -2371,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>;
@@ -2520,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
      *

package/dist/index.d.ts

@@ -936,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;
 };
 
 /**
@@ -2371,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>;
@@ -2520,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
      *

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-experimental1";
+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
   };
 }
 
@@ -7330,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,
@@ -7345,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,