@liveblocks/react 1.3.6 → 1.4.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import { ReactElement, ReactNode } from 'react';
 import * as _liveblocks_core from '@liveblocks/core';
-import { CommentBody, BaseMetadata, ThreadData, Resolve, ToImmutable, CommentData, RoomInitializers } from '@liveblocks/core';
+import { CommentBody, BaseMetadata, ThreadData, Resolve, ToImmutable, RoomEventMessage, CommentData, RoomInitializers } from '@liveblocks/core';
 import { JsonObject, LsonObject, BaseUserMeta, LiveObject, User, Others, Json, Room, Status, BroadcastOptions, LostConnectionEvent, History, Client } from '@liveblocks/client';
 export { Json, JsonObject, shallow } from '@liveblocks/client';
 
@@ -57,19 +57,27 @@ declare type DeleteCommentOptions = {
     threadId: string;
     commentId: string;
 };
-declare type RoomThreads<TThreadMetadata extends BaseMetadata> = {
+declare type CommentReactionOptions = {
+    threadId: string;
+    commentId: string;
+    emoji: string;
+};
+declare type ThreadsStateLoading = {
     isLoading: true;
     threads?: never;
     error?: never;
-} | {
+};
+declare type ThreadsStateError = {
     isLoading: false;
     threads?: never;
     error: Error;
-} | {
+};
+declare type ThreadsStateSuccess<TThreadMetadata extends BaseMetadata> = {
     isLoading: false;
     threads: ThreadData<TThreadMetadata>[];
     error?: never;
 };
+declare type ThreadsState<TThreadMetadata extends BaseMetadata> = ThreadsStateLoading | ThreadsStateError | ThreadsStateSuccess<TThreadMetadata>;
 
 declare type ResolveUserOptions = {
     userId: string;
@@ -78,23 +86,22 @@ declare type ResolveMentionSuggestionsOptions = {
     roomId: string;
     text: string;
 };
-declare type UserState<T> = {
-    user?: never;
+declare type UserStateLoading = {
     isLoading: true;
+    user?: never;
     error?: never;
-} | {
-    user?: T;
+};
+declare type UserStateError = {
     isLoading: false;
-    error?: never;
-} | {
     user?: never;
-    isLoading: false;
     error: Error;
 };
-declare type UserStateSuspense<T> = Resolve<Extract<UserState<T>, {
+declare type UserStateSuccess<T> = {
     isLoading: false;
+    user: T;
     error?: never;
-}>>;
+};
+declare type UserState<T> = UserStateLoading | UserStateError | UserStateSuccess<T>;
 declare type RoomProviderProps<TPresence extends JsonObject, TStorage extends LsonObject> = Resolve<{
     /**
      * The id of the room you want to connect to
@@ -218,10 +225,7 @@ declare type RoomContextBundleShared<TPresence extends JsonObject, TStorage exte
      *   }
      * });
      */
-    useEventListener(callback: (eventData: {
-        connectionId: number;
-        event: TRoomEvent;
-    }) => void): void;
+    useEventListener(callback: (data: RoomEventMessage<TPresence, TUserMeta, TRoomEvent>) => void): void;
     /**
      * Returns the room.history
      */
@@ -534,7 +538,7 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
      * @example
      * const { threads, error, isLoading } = useThreads();
      */
-    useThreads(): RoomThreads<TThreadMetadata>;
+    useThreads(): ThreadsState<TThreadMetadata>;
     /**
      * @beta
      *
@@ -651,18 +655,18 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
          * Returns the threads within the current room.
          *
          * @example
-         * const threads = useThreads();
+         * const { threads } = useThreads();
          */
-        useThreads(): ThreadData<TThreadMetadata>[];
+        useThreads(): ThreadsStateSuccess<TThreadMetadata>;
         /**
          * @beta
          *
          * Returns user info from a given user ID.
          *
          * @example
-         * const { user, error, isLoading } = useUser("user-id");
+         * const { user } = useUser("user-id");
          */
-        useUser(userId: string): UserStateSuspense<TUserMeta["info"]>;
+        useUser(userId: string): UserStateSuccess<TUserMeta["info"]>;
         /**
          * Returns the LiveList associated with the provided key. The hook triggers
          * a re-render if the LiveList is updated, however it does not triggers
@@ -749,10 +753,7 @@ declare function useRoomContextBundle(): {
     useBroadcastEvent: () => (event: never, options?: BroadcastOptions | undefined) => void;
     useLostConnectionListener: (callback: (event: LostConnectionEvent) => void) => void;
     useErrorListener: (callback: (err: Error) => void) => void;
-    useEventListener: (callback: (eventData: {
-        connectionId: number;
-        event: never;
-    }) => void) => void;
+    useEventListener: (callback: (data: RoomEventMessage<JsonObject, BaseUserMeta, never>) => void) => void;
     useHistory: () => History;
     useUndo: () => () => void;
     useRedo: () => () => void;
@@ -784,6 +785,8 @@ declare function useRoomContextBundle(): {
     useCreateComment: () => (options: CreateCommentOptions) => CommentData;
     useEditComment: () => (options: EditCommentOptions) => void;
     useDeleteComment: () => (options: DeleteCommentOptions) => void;
+    useAddReaction: () => (options: CommentReactionOptions) => void;
+    useRemoveReaction: () => (options: CommentReactionOptions) => void;
     useStorage: <T_4>(selector: (root: {
         readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | any | {
             readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | undefined;
@@ -1079,7 +1082,7 @@ declare function useRoomContextBundle(): {
         (): User<JsonObject, BaseUserMeta> | null;
         <T_5>(selector: (me: User<JsonObject, BaseUserMeta>) => T_5, isEqual?: ((prev: T_5, curr: T_5) => boolean) | undefined): T_5 | null;
     };
-    useThreads: () => RoomThreads<BaseMetadata>;
+    useThreads: () => ThreadsState<BaseMetadata>;
     useUser: (userId: string) => UserState<{
         [key: string]: Json | undefined;
         name?: string | undefined;
@@ -1104,10 +1107,7 @@ declare function useRoomContextBundle(): {
         useBroadcastEvent: () => (event: never, options?: BroadcastOptions | undefined) => void;
         useLostConnectionListener: (callback: (event: LostConnectionEvent) => void) => void;
         useErrorListener: (callback: (err: Error) => void) => void;
-        useEventListener: (callback: (eventData: {
-            connectionId: number;
-            event: never;
-        }) => void) => void;
+        useEventListener: (callback: (data: RoomEventMessage<JsonObject, BaseUserMeta, never>) => void) => void;
         useHistory: () => History;
         useUndo: () => () => void;
         useRedo: () => () => void;
@@ -1139,6 +1139,8 @@ declare function useRoomContextBundle(): {
         useCreateComment: () => (options: CreateCommentOptions) => CommentData;
         useEditComment: () => (options: EditCommentOptions) => void;
         useDeleteComment: () => (options: DeleteCommentOptions) => void;
+        useAddReaction: () => (options: CommentReactionOptions) => void;
+        useRemoveReaction: () => (options: CommentReactionOptions) => void;
         useStorage: <T_6>(selector: (root: {
             readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | any | {
                 readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | undefined;
@@ -1434,16 +1436,12 @@ declare function useRoomContextBundle(): {
             (): User<JsonObject, BaseUserMeta>;
             <T_7>(selector: (me: User<JsonObject, BaseUserMeta>) => T_7, isEqual?: ((prev: T_7, curr: T_7) => boolean) | undefined): T_7;
         };
-        useThreads: () => _liveblocks_core.ThreadData<BaseMetadata>[];
-        useUser: (userId: string) => {
-            user?: {
-                [key: string]: Json | undefined;
-                name?: string | undefined;
-                avatar?: string | undefined;
-            } | undefined;
-            isLoading: false;
-            error?: undefined;
-        };
+        useThreads: () => ThreadsStateSuccess<BaseMetadata>;
+        useUser: (userId: string) => UserStateSuccess<{
+            [key: string]: Json | undefined;
+            name?: string | undefined;
+            avatar?: string | undefined;
+        } | undefined>;
         useList: <TKey_3 extends string>(key: TKey_3) => _liveblocks_core.Lson | undefined;
         useMap: <TKey_4 extends string>(key: TKey_4) => _liveblocks_core.Lson | undefined;
         useObject: <TKey_5 extends string>(key: TKey_5) => _liveblocks_core.Lson | undefined;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import { ReactElement, ReactNode } from 'react';
 import * as _liveblocks_core from '@liveblocks/core';
-import { CommentBody, BaseMetadata, ThreadData, Resolve, ToImmutable, CommentData, RoomInitializers } from '@liveblocks/core';
+import { CommentBody, BaseMetadata, ThreadData, Resolve, ToImmutable, RoomEventMessage, CommentData, RoomInitializers } from '@liveblocks/core';
 import { JsonObject, LsonObject, BaseUserMeta, LiveObject, User, Others, Json, Room, Status, BroadcastOptions, LostConnectionEvent, History, Client } from '@liveblocks/client';
 export { Json, JsonObject, shallow } from '@liveblocks/client';
 
@@ -57,19 +57,27 @@ declare type DeleteCommentOptions = {
     threadId: string;
     commentId: string;
 };
-declare type RoomThreads<TThreadMetadata extends BaseMetadata> = {
+declare type CommentReactionOptions = {
+    threadId: string;
+    commentId: string;
+    emoji: string;
+};
+declare type ThreadsStateLoading = {
     isLoading: true;
     threads?: never;
     error?: never;
-} | {
+};
+declare type ThreadsStateError = {
     isLoading: false;
     threads?: never;
     error: Error;
-} | {
+};
+declare type ThreadsStateSuccess<TThreadMetadata extends BaseMetadata> = {
     isLoading: false;
     threads: ThreadData<TThreadMetadata>[];
     error?: never;
 };
+declare type ThreadsState<TThreadMetadata extends BaseMetadata> = ThreadsStateLoading | ThreadsStateError | ThreadsStateSuccess<TThreadMetadata>;
 
 declare type ResolveUserOptions = {
     userId: string;
@@ -78,23 +86,22 @@ declare type ResolveMentionSuggestionsOptions = {
     roomId: string;
     text: string;
 };
-declare type UserState<T> = {
-    user?: never;
+declare type UserStateLoading = {
     isLoading: true;
+    user?: never;
     error?: never;
-} | {
-    user?: T;
+};
+declare type UserStateError = {
     isLoading: false;
-    error?: never;
-} | {
     user?: never;
-    isLoading: false;
     error: Error;
 };
-declare type UserStateSuspense<T> = Resolve<Extract<UserState<T>, {
+declare type UserStateSuccess<T> = {
     isLoading: false;
+    user: T;
     error?: never;
-}>>;
+};
+declare type UserState<T> = UserStateLoading | UserStateError | UserStateSuccess<T>;
 declare type RoomProviderProps<TPresence extends JsonObject, TStorage extends LsonObject> = Resolve<{
     /**
      * The id of the room you want to connect to
@@ -218,10 +225,7 @@ declare type RoomContextBundleShared<TPresence extends JsonObject, TStorage exte
      *   }
      * });
      */
-    useEventListener(callback: (eventData: {
-        connectionId: number;
-        event: TRoomEvent;
-    }) => void): void;
+    useEventListener(callback: (data: RoomEventMessage<TPresence, TUserMeta, TRoomEvent>) => void): void;
     /**
      * Returns the room.history
      */
@@ -534,7 +538,7 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
      * @example
      * const { threads, error, isLoading } = useThreads();
      */
-    useThreads(): RoomThreads<TThreadMetadata>;
+    useThreads(): ThreadsState<TThreadMetadata>;
     /**
      * @beta
      *
@@ -651,18 +655,18 @@ declare type RoomContextBundle<TPresence extends JsonObject, TStorage extends Ls
          * Returns the threads within the current room.
          *
          * @example
-         * const threads = useThreads();
+         * const { threads } = useThreads();
          */
-        useThreads(): ThreadData<TThreadMetadata>[];
+        useThreads(): ThreadsStateSuccess<TThreadMetadata>;
         /**
          * @beta
          *
          * Returns user info from a given user ID.
          *
          * @example
-         * const { user, error, isLoading } = useUser("user-id");
+         * const { user } = useUser("user-id");
          */
-        useUser(userId: string): UserStateSuspense<TUserMeta["info"]>;
+        useUser(userId: string): UserStateSuccess<TUserMeta["info"]>;
         /**
          * Returns the LiveList associated with the provided key. The hook triggers
          * a re-render if the LiveList is updated, however it does not triggers
@@ -749,10 +753,7 @@ declare function useRoomContextBundle(): {
     useBroadcastEvent: () => (event: never, options?: BroadcastOptions | undefined) => void;
     useLostConnectionListener: (callback: (event: LostConnectionEvent) => void) => void;
     useErrorListener: (callback: (err: Error) => void) => void;
-    useEventListener: (callback: (eventData: {
-        connectionId: number;
-        event: never;
-    }) => void) => void;
+    useEventListener: (callback: (data: RoomEventMessage<JsonObject, BaseUserMeta, never>) => void) => void;
     useHistory: () => History;
     useUndo: () => () => void;
     useRedo: () => () => void;
@@ -784,6 +785,8 @@ declare function useRoomContextBundle(): {
     useCreateComment: () => (options: CreateCommentOptions) => CommentData;
     useEditComment: () => (options: EditCommentOptions) => void;
     useDeleteComment: () => (options: DeleteCommentOptions) => void;
+    useAddReaction: () => (options: CommentReactionOptions) => void;
+    useRemoveReaction: () => (options: CommentReactionOptions) => void;
     useStorage: <T_4>(selector: (root: {
         readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | any | {
             readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | undefined;
@@ -1079,7 +1082,7 @@ declare function useRoomContextBundle(): {
         (): User<JsonObject, BaseUserMeta> | null;
         <T_5>(selector: (me: User<JsonObject, BaseUserMeta>) => T_5, isEqual?: ((prev: T_5, curr: T_5) => boolean) | undefined): T_5 | null;
     };
-    useThreads: () => RoomThreads<BaseMetadata>;
+    useThreads: () => ThreadsState<BaseMetadata>;
     useUser: (userId: string) => UserState<{
         [key: string]: Json | undefined;
         name?: string | undefined;
@@ -1104,10 +1107,7 @@ declare function useRoomContextBundle(): {
         useBroadcastEvent: () => (event: never, options?: BroadcastOptions | undefined) => void;
         useLostConnectionListener: (callback: (event: LostConnectionEvent) => void) => void;
         useErrorListener: (callback: (err: Error) => void) => void;
-        useEventListener: (callback: (eventData: {
-            connectionId: number;
-            event: never;
-        }) => void) => void;
+        useEventListener: (callback: (data: RoomEventMessage<JsonObject, BaseUserMeta, never>) => void) => void;
         useHistory: () => History;
         useUndo: () => () => void;
         useRedo: () => () => void;
@@ -1139,6 +1139,8 @@ declare function useRoomContextBundle(): {
         useCreateComment: () => (options: CreateCommentOptions) => CommentData;
         useEditComment: () => (options: EditCommentOptions) => void;
         useDeleteComment: () => (options: DeleteCommentOptions) => void;
+        useAddReaction: () => (options: CommentReactionOptions) => void;
+        useRemoveReaction: () => (options: CommentReactionOptions) => void;
         useStorage: <T_6>(selector: (root: {
             readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | ReadonlyMap<string, _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | readonly (_liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | any | any | {
                 readonly [x: string]: _liveblocks_core.JsonScalar | _liveblocks_core.JsonArray | any | undefined;
@@ -1434,16 +1436,12 @@ declare function useRoomContextBundle(): {
             (): User<JsonObject, BaseUserMeta>;
             <T_7>(selector: (me: User<JsonObject, BaseUserMeta>) => T_7, isEqual?: ((prev: T_7, curr: T_7) => boolean) | undefined): T_7;
         };
-        useThreads: () => _liveblocks_core.ThreadData<BaseMetadata>[];
-        useUser: (userId: string) => {
-            user?: {
-                [key: string]: Json | undefined;
-                name?: string | undefined;
-                avatar?: string | undefined;
-            } | undefined;
-            isLoading: false;
-            error?: undefined;
-        };
+        useThreads: () => ThreadsStateSuccess<BaseMetadata>;
+        useUser: (userId: string) => UserStateSuccess<{
+            [key: string]: Json | undefined;
+            name?: string | undefined;
+            avatar?: string | undefined;
+        } | undefined>;
         useList: <TKey_3 extends string>(key: TKey_3) => _liveblocks_core.Lson | undefined;
         useMap: <TKey_4 extends string>(key: TKey_4) => _liveblocks_core.Lson | undefined;
         useObject: <TKey_5 extends string>(key: TKey_5) => _liveblocks_core.Lson | undefined;

package/dist/index.js

@@ -5,7 +5,7 @@ var _core = require('@liveblocks/core');
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/react";
-var PKG_VERSION = "1.3.6";
+var PKG_VERSION = "1.4.0";
 var PKG_FORMAT = "cjs";
 
 // src/ClientSideSuspense.tsx
@@ -32,8 +32,6 @@ var _withselectorjs = require('use-sync-external-store/shim/with-selector.js');
 
 // src/comments/CommentsRoom.ts
 
-
-
 var _nanoid = require('nanoid');
 
 var _indexjs = require('use-sync-external-store/shim/index.js');
@@ -79,6 +77,22 @@ var DeleteCommentError = class extends Error {
     this.name = "DeleteCommentError";
   }
 };
+var AddReactionError = class extends Error {
+  constructor(cause, context) {
+    super("Add reaction failed.");
+    this.cause = cause;
+    this.context = context;
+    this.name = "AddReactionError";
+  }
+};
+var RemoveReactionError = class extends Error {
+  constructor(cause, context) {
+    super("Remove reaction failed.");
+    this.cause = cause;
+    this.context = context;
+    this.name = "RemoveReactionError";
+  }
+};
 
 // src/comments/CommentsRoom.ts
 var POLLING_INTERVAL_REALTIME = 3e4;
@@ -288,7 +302,8 @@ function createCommentsRoom(room, errorEventSource) {
       type: "comment",
       createdAt: now,
       userId: getCurrentUserId(),
-      body
+      body,
+      reactions: []
     };
     const optimisticData = threads.map(
       (thread) => thread.id === threadId ? {
@@ -461,12 +476,84 @@ function createCommentsRoom(room, errorEventSource) {
     if (cache.error) {
       throw cache.error;
     }
-    return cache.threads;
+    return {
+      threads: cache.threads,
+      isLoading: false
+    };
+  }
+  function addReaction({
+    threadId,
+    commentId,
+    emoji
+  }) {
+    const threads = getThreads();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const optimisticData = threads.map(
+      (thread) => thread.id === threadId ? {
+        ...thread,
+        comments: thread.comments.map(
+          (comment) => comment.id === commentId ? {
+            ...comment,
+            reactions: [
+              ...comment.reactions,
+              { emoji, userId: getCurrentUserId(), createdAt: now }
+            ]
+          } : comment
+        )
+      } : thread
+    );
+    mutate(room.addReaction({ threadId, commentId, emoji }), {
+      optimisticData
+    }).catch((err) => {
+      errorEventSource.notify(
+        new AddReactionError(err, {
+          roomId: room.id,
+          threadId,
+          commentId,
+          emoji
+        })
+      );
+    });
+  }
+  function removeReaction({
+    threadId,
+    commentId,
+    emoji
+  }) {
+    const threads = getThreads();
+    const optimisticData = threads.map(
+      (thread) => thread.id === threadId ? {
+        ...thread,
+        comments: thread.comments.map((comment) => {
+          const reactionIndex = comment.reactions.findIndex(
+            (reaction) => reaction.emoji === emoji && reaction.userId === getCurrentUserId()
+          );
+          return comment.id === commentId ? {
+            ...comment,
+            reactions: reactionIndex < 0 ? comment.reactions : comment.reactions.slice(0, reactionIndex).concat(comment.reactions.slice(reactionIndex + 1))
+          } : comment;
+        })
+      } : thread
+    );
+    mutate(room.removeReaction({ threadId, commentId, emoji }), {
+      optimisticData
+    }).catch((err) => {
+      errorEventSource.notify(
+        new RemoveReactionError(err, {
+          roomId: room.id,
+          threadId,
+          commentId,
+          emoji
+        })
+      );
+    });
   }
   return {
     useThreads,
     useThreadsSuspense,
     editThreadMetadata,
+    addReaction,
+    removeReaction,
     createThread,
     createComment,
     editComment,
@@ -561,6 +648,9 @@ function useAsyncCache(cache, key, options) {
   if (state.isLoading && _optionalChain([frozenOptions, 'optionalAccess', _10 => _10.keepPreviousDataWhileLoading]) && typeof state.data === "undefined" && _optionalChain([previousData, 'access', _11 => _11.current, 'optionalAccess', _12 => _12.key]) !== key && typeof _optionalChain([previousData, 'access', _13 => _13.current, 'optionalAccess', _14 => _14.data]) !== "undefined") {
     data = previousData.current.data;
   }
+  if (_optionalChain([frozenOptions, 'optionalAccess', _15 => _15.suspense]) && state.error) {
+    throw state.error;
+  }
   return {
     isLoading: state.isLoading,
     data,
@@ -935,7 +1025,7 @@ function createRoomContext(client, options) {
       function onRootChange() {
         const newValue = root.get(key);
         if (newValue !== curr) {
-          _optionalChain([unsubCurr, 'optionalCall', _15 => _15()]);
+          _optionalChain([unsubCurr, 'optionalCall', _16 => _16()]);
           curr = newValue;
           subscribeToCurr();
           rerender();
@@ -946,7 +1036,7 @@ function createRoomContext(client, options) {
       const unsubscribeRoot = room.subscribe(root, onRootChange);
       return () => {
         unsubscribeRoot();
-        _optionalChain([unsubCurr, 'optionalCall', _16 => _16()]);
+        _optionalChain([unsubCurr, 'optionalCall', _17 => _17()]);
       };
     }, [rootOrNull, room, key, rerender]);
     if (rootOrNull === null) {
@@ -1113,6 +1203,26 @@ function createRoomContext(client, options) {
       [room]
     );
   }
+  function useAddReaction() {
+    const room = useRoom();
+    React2.useEffect(() => {
+      warnIfBetaCommentsHook();
+    }, []);
+    return React2.useCallback(
+      (options2) => getCommentsRoom(room).addReaction(options2),
+      [room]
+    );
+  }
+  function useRemoveReaction() {
+    const room = useRoom();
+    React2.useEffect(() => {
+      warnIfBetaCommentsHook();
+    }, []);
+    return React2.useCallback(
+      (options2) => getCommentsRoom(room).removeReaction(options2),
+      [room]
+    );
+  }
   function useCreateComment() {
     const room = useRoom();
     React2.useEffect(() => {
@@ -1179,7 +1289,6 @@ function createRoomContext(client, options) {
     React2.useEffect(() => warnIfNoResolveUser(usersCache), []);
     return {
       user: state.data,
-      error: state.error,
       isLoading: false
     };
   }
@@ -1238,6 +1347,8 @@ function createRoomContext(client, options) {
     useCreateComment,
     useEditComment,
     useDeleteComment,
+    useAddReaction,
+    useRemoveReaction,
     suspense: {
       RoomContext,
       RoomProvider,
@@ -1273,7 +1384,9 @@ function createRoomContext(client, options) {
       useEditThreadMetadata,
       useCreateComment,
       useEditComment,
-      useDeleteComment
+      useDeleteComment,
+      useAddReaction,
+      useRemoveReaction
     }
   };
   const internalBundle = {