Changelog

@liveblocks/yjs

• Add support for subdocs.

@liveblocks/react

• Fix return type of resolveUsers.

• Fixes a bug in the bounds check of the backgroundKeepAliveTimeout option.

Support multiple RoomProviders, or mixing and matching our React package in the same app with a Redux and/or Zustand instance.

At the client level, there is a new API for entering/leaving rooms, which we’re now recommending over the old APIs. (The old APIs remain working exactly how they are today, however.)

// Old APIs we'll no longer be recommending (but that will remain working)const room = client.enter("my-room", options);client.getRoom("my-room");client.leave("my-room");

// New API we'll be recommending insteadconst { room, leave } = client.enterRoom("my-room", options);leave();

@liveblocks/client

• New client config option: backgroundKeepAliveTimeout (a numeric value in milliseconds). See docs.
• New APIs:
  • Client.enterRoom(roomId, options) – enters the room and return both the room and an "unsubscribe function" to leave that room again. This newer API supports entering/leaving the same room multiple times, making it possible to connect to the same room from different parts of your application. See docs.
  • Client.logout() – Call this on the Liveblocks client when you log out a user in your application. It will purge all auth tokens and force-leave any rooms, if any are still connected. See docs.
  • LiveList.clone() – see docs.
  • LiveMap.clone() – see docs.
  • LiveObject.clone() – see docs.
• Deprecated APIs:
  • client.enter(roomId, options)
  • client.leave(roomId)
• Renamed enter option: shouldInitiallyConnect → autoConnect. Its meaning or working did not change.
• Fixes a potential Cannot set parent: node already has a parent error when initializing storage with Live datastructures that are already tied to a Storage tree.

@liveblocks/react

• Support using multiple RoomProvider components in your component tree for the same room ID.
• Renamed RoomProvider prop: shouldInitiallyConnect → autoConnect. Its meaning or working did not change.
• New hook:
  • useOthersListener({ type, user, others }), see docs

@liveblocks/redux

• Breaking: The leaveRoom() function no longer accepts a roomId. It will always leave the currently joined room.

@liveblocks/zustand

• The enterRoom() function will now return a leave callback function.
• Breaking: The leaveRoom() function no longer accepts a roomId. It will always leave the currently joined room.

create-liveblocks-app

• Add Comments hooks and options to --init command.

@liveblocks/client

• Export all CommentBody-related types.

@liveblocks/react-comments

• Improve default styles:
  • Cap CSS selector specificity to improve overridability.
  • Set tokens on .lb-root instead of :root to improve cascading tokens (overriding --lb-accent on body for example, didn't create the expected results), and to work within shadow DOMs.
• Fix reactions and links styles on Safari.

@liveblocks/react

• Fix userIds type in ResolveUsersArgs.

@liveblocks/react

• Fix a race condition that could cause a Liveblocks client to hang during loading when using Suspense.
• Fix useStatus return value on SSR responses.
• Breaking (beta): The resolveUser option in createRoomContext is now called resolveUsers and it receives a list of user IDs (via the userIds property, replacing userId) instead of a single one. Instead of returning user info of a single user ID, this function will now expect a list of users' info matching the provided list of user IDs.
• Breaking (beta): The ResolveUserOptions and ResolveMentionSuggestionsOptions types were renamed to ResolveUsersArgs and ResolveMentionSuggestionsArgs respectively.
• resolveUsers and resolveMentionSuggestions now accept synchronous functions.
• resolveUsers now also provides the current room ID.
• editThreadMetadata now correctly allows null to be set on a property. Doing so deletes existing metadata properties.

@liveblocks/react-comments

• Export ComposerSubmitComment type from root too, in addition to /primitives.
• Add onThreadDelete to Thread.
• Add metadata to Composer to attach custom metadata to new threads.
• Add support for specifying a custom ThreadMetadata type on Thread and Composer.
• Breaking (beta): Comment’s onEdit and onDelete were renamed to onEditComment and onDeleteComment respectively.

@liveblocks/react

• Fix createThread not creating valid comment.

@liveblocks/node

• Fix URL encoding bug

@liveblocks/react

• Fix removeReaction not removing reactions which led to reactions displaying a count of 0.

@liveblocks/react-comments

• Fix reactions list (and its add button) showing on all comments.
• Improve emoji rendering on Windows.
• Hide country flag emojis when unsupported. (e.g. on Windows)

@liveblocks/react

• Add new Comments hooks to add/remove reactions.
• Fix a bug in useOthers() that could lead to the warning "The result of getServerSnapshot should be cached to avoid an infinite loop"

@liveblocks/react-comments

• Add support for reactions. (👍)
• Add keyboard navigation to emoji picker.