@liveblocks/react 1.6.0 → 1.7.0

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { detectDupes } from "@liveblocks/core";
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/react";
-var PKG_VERSION = "1.6.0";
+var PKG_VERSION = "1.7.0";
 var PKG_FORMAT = "esm";
 
 // src/ClientSideSuspense.tsx
@@ -32,7 +32,7 @@ import * as React2 from "react";
 import { useSyncExternalStoreWithSelector } from "use-sync-external-store/shim/with-selector.js";
 
 // src/comments/CommentsRoom.ts
-import { makeEventSource } from "@liveblocks/core";
+import { CommentsApiError, console as console2, makeEventSource } from "@liveblocks/core";
 import { nanoid } from "nanoid";
 import { useEffect as useEffect2 } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim/index.js";
@@ -136,6 +136,14 @@ function createThreadsManager() {
     }
   };
 }
+function handleCommentsApiError(err) {
+  const message = `Request failed with status ${err.status}: ${err.message}`;
+  if (err.details?.error === "FORBIDDEN") {
+    const detailedMessage = [message, err.details.suggestion, err.details.docs].filter(Boolean).join("\n");
+    console2.error(detailedMessage);
+  }
+  return new Error(message);
+}
 function createCommentsRoom(room, errorEventSource) {
   const manager = createThreadsManager();
   let timestamp = 0;
@@ -242,8 +250,12 @@ function createCommentsRoom(room, errorEventSource) {
     mutate(room.editThreadMetadata({ metadata, threadId }), {
       optimisticData
     }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
       errorEventSource.notify(
-        new EditThreadMetadataError(err, {
+        new EditThreadMetadataError(error, {
           roomId: room.id,
           threadId,
           metadata
@@ -278,17 +290,21 @@ function createCommentsRoom(room, errorEventSource) {
     };
     mutate(room.createThread({ threadId, commentId, body, metadata }), {
       optimisticData: [...threads, newThread]
-    }).catch(
-      (er) => errorEventSource.notify(
-        new CreateThreadError(er, {
+    }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
+      errorEventSource.notify(
+        new CreateThreadError(error, {
           roomId: room.id,
           threadId,
           commentId,
           body,
           metadata
         })
-      )
-    );
+      );
+    });
     return newThread;
   }
   function createComment({
@@ -316,16 +332,20 @@ function createCommentsRoom(room, errorEventSource) {
     );
     mutate(room.createComment({ threadId, commentId, body }), {
       optimisticData
-    }).catch(
-      (er) => errorEventSource.notify(
-        new CreateCommentError(er, {
+    }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
+      errorEventSource.notify(
+        new CreateCommentError(error, {
           roomId: room.id,
           threadId,
           commentId,
           body
         })
-      )
-    );
+      );
+    });
     return comment;
   }
   function editComment({ threadId, commentId, body }) {
@@ -345,16 +365,20 @@ function createCommentsRoom(room, errorEventSource) {
     );
     mutate(room.editComment({ threadId, commentId, body }), {
       optimisticData
-    }).catch(
-      (er) => errorEventSource.notify(
-        new EditCommentError(er, {
+    }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
+      errorEventSource.notify(
+        new EditCommentError(error, {
           roomId: room.id,
           threadId,
           commentId,
           body
         })
-      )
-    );
+      );
+    });
   }
   function deleteComment({ threadId, commentId }) {
     const threads = getThreads();
@@ -381,15 +405,19 @@ function createCommentsRoom(room, errorEventSource) {
     }
     mutate(room.deleteComment({ threadId, commentId }), {
       optimisticData: newThreads
-    }).catch(
-      (er) => errorEventSource.notify(
-        new DeleteCommentError(er, {
+    }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
+      errorEventSource.notify(
+        new DeleteCommentError(error, {
           roomId: room.id,
           threadId,
           commentId
         })
-      )
-    );
+      );
+    });
   }
   function getCurrentUserId() {
     const self = room.getSelf();
@@ -527,8 +555,12 @@ function createCommentsRoom(room, errorEventSource) {
     mutate(room.addReaction({ threadId, commentId, emoji }), {
       optimisticData
     }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
       errorEventSource.notify(
-        new AddReactionError(err, {
+        new AddReactionError(error, {
           roomId: room.id,
           threadId,
           commentId,
@@ -580,8 +612,12 @@ function createCommentsRoom(room, errorEventSource) {
     mutate(room.removeReaction({ threadId, commentId, emoji }), {
       optimisticData
     }).catch((err) => {
+      if (!(err instanceof CommentsApiError)) {
+        throw err;
+      }
+      const error = handleCommentsApiError(err);
       errorEventSource.notify(
-        new RemoveReactionError(err, {
+        new RemoveReactionError(error, {
           roomId: room.id,
           threadId,
           commentId,
@@ -790,15 +826,6 @@ function warnIfNoResolveUsers(usersCache) {
     hasWarnedIfNoResolveUsers = true;
   }
 }
-var hasWarnedAboutCommentsBeta = false;
-function warnIfBetaCommentsHook() {
-  if (!hasWarnedAboutCommentsBeta && process.env.NODE_ENV !== "production") {
-    console.warn(
-      "Comments is currently in private beta. Learn more at https://liveblocks.io/docs/products/comments."
-    );
-    hasWarnedAboutCommentsBeta = true;
-  }
-}
 var ContextBundle = React2.createContext(null);
 function useRoomContextBundle() {
   const bundle = React2.useContext(ContextBundle);
@@ -1245,23 +1272,14 @@ function createRoomContext(client, options) {
   }
   function useThreads() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return getCommentsRoom(room).useThreads();
   }
   function useThreadsSuspense() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return getCommentsRoom(room).useThreadsSuspense();
   }
   function useCreateThread() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).createThread(options2),
       [room]
@@ -1269,9 +1287,6 @@ function createRoomContext(client, options) {
   }
   function useEditThreadMetadata() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).editThreadMetadata(options2),
       [room]
@@ -1279,9 +1294,6 @@ function createRoomContext(client, options) {
   }
   function useAddReaction() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).addReaction(options2),
       [room]
@@ -1289,9 +1301,6 @@ function createRoomContext(client, options) {
   }
   function useRemoveReaction() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).removeReaction(options2),
       [room]
@@ -1299,9 +1308,6 @@ function createRoomContext(client, options) {
   }
   function useCreateComment() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).createComment(options2),
       [room]
@@ -1309,9 +1315,6 @@ function createRoomContext(client, options) {
   }
   function useEditComment() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).editComment(options2),
       [room]
@@ -1319,9 +1322,6 @@ function createRoomContext(client, options) {
   }
   function useDeleteComment() {
     const room = useRoom();
-    React2.useEffect(() => {
-      warnIfBetaCommentsHook();
-    }, []);
     return React2.useCallback(
       (options2) => getCommentsRoom(room).deleteComment(options2),
       [room]