Changelog

@liveblocks/react

• Add support for custom notification kinds.
• Add new useInboxNotificationThread hook to createLiveblocksContext, which can be used to retrieve threads within thread notifications for more flexibility.
• Add support for startsWith operator to useThreads when filtering based on metadata.

@liveblocks/react-comments

• Add support for custom notification kinds to the InboxNotification component via the kinds prop and the InboxNotification.Custom component.
• Add destructive color tokens. (--lb-destructive, --lb-destructive-foreground, and --lb-destructive-contrast)

@liveblocks/node

• Add triggerInboxNotification method that lets you trigger custom notification kinds.
• Enable filtering rooms by room ID in the getRooms method. This works via query.roomId, metadata is deprecated and is now query.metadata.
• Add support for our query language when filtering with the getRooms and getThreads methods.
• Add support for an alternative object-based query notation to the getRooms and getThreads methods, which supports exact matches and the startsWith operator.

@liveblocks/client

• Fixes a potential RangeError: Maximum call stack size exceeded in applications that produce many operations

@liveblocks/node

• Add missing updatedAt property to YDocUpdatedEvent type. (@alexlande)

create-liveblocks-app

• Add support for the updated Starter Kit.

@liveblocks/react-comments

• Fix the composer’s placeholder to appear instantly instead of being initially invisible.
• Fix the default composer’s actions not being disabled when the composer is.

@liveblocks/node

• Fix "process is undefined" issue in Vite builds. This issue was already fixed for @liveblocks/core, but not for @liveblocks/node yet.

DevTools

• Improve tree view to visualize Y.js documents and inspect Y.js awareness.

@liveblocks/node

• Add updateRoomId method that lets you update the room ID of the specified room.
• Add an optional guid parameter to sendYjsBinaryUpdate and getYjsDocumentAsBinaryUpdate to point to a Yjs subdocument with the specified guid.

@liveblocks/react

• Add scrollOnLoad option to useThreads: enabled by default, this option controls whether to scroll to a comment on load based on the URL hash.
• useUser and useRoomInfo no longer support returning nothing. Returning undefined will now be treated as an error.
• Fix bug where useUser and useRoomInfo returned an extra data superfluous property.
• Fix bug where customizing types on createLiveblocksContext would conflict with the provided Client.

@liveblocks/react-comments

• Add actions to InboxNotification with a single action for now: marking as read.
• Improve actions hover behavior in Comment/Thread.
• Change Comment background color when it’s linked to or being edited.

• Fix bundling issue in Vite projects, where process is not defined could happen

@liveblocks/react-comments

• Add support for Emoji v15.1 in emoji picker, along two additional locales: Bengali (bn) and Hindi (hi).
• Fix bug where the showRoomName prop on InboxNotification.Thread wasn’t applied to notifications about mentions.

@liveblocks/react

• Fix bug where removing metadata via useEditThreadMetadata would result in a brief flash of the old metadata after the metadata was removed optimistically.

@liveblocks/client

• Fix bug where calling .clone() immediately after creating a new LiveObject could throw an error

@liveblocks/client

• Fix bug where the client’s backoff delay would not be respected correctly in a small edge case.

@liveblocks/react-comments

• Fix date localization in InboxNotification.
• Add vendor prefixes to more CSS properties within the default styles.

@liveblocks/react

• Added error retrying to useThreads, useRoomNotificationSettings, and useInboxNotifications during initial fetching.

This release introduces Notifications (and unread indicators) for Comments.

create-liveblocks-app

• Add createLiveblocksContext and Notifications to --init.
• Move resolver options from createRoomContext to createClient and add resolveRoomsInfo to the list of resolvers.

@liveblocks/client

• Add options to createClient: resolveUsers, resolveMentionSuggestions (both were previously defined on createRoomContext from @liveblocks/react), and the new resolveRoomsInfo.

@liveblocks/react

• Add new LiveblocksContext accessible with createLiveblocksContext, similarly to createRoomContext. This context is meant to live at the root since it handles things outside of rooms, like notifications. It contains LiveblocksProvider, useUser, useRoomInfo, useInboxNotifications, useUnreadInboxNotificationsCount, useMarkInboxNotificationAsRead, and useMarkAllInboxNotificationsAsRead.
• Add new hooks to createRoomContext: useMarkThreadAsRead, useThreadSubscription, useRoomInfo, useRoomNotificationSettings, and useUpdateRoomNotificationSettings.
• Make some hooks usable interchangeably between createLiveblocksContext and createRoomContext: useUser, and useRoomInfo.

@liveblocks/react-comments

• Add new default components: InboxNotification and InboxNotificationList.
• Add unread indicators to the default Thread component.
• Support "@" in mentions. (e.g. @user@email.com is now a valid mention and will trigger resolveMentionSuggestions with "user@email.com")

@liveblocks/node

• Add the Notifications REST APIs as fully typed methods. (includes getInboxNotification, getRoomNotificationSettings, updateRoomNotificationSettings, and deleteRoomNotificationSettings methods)
• Add notification webhook event: NotificationEvent.