liveblocks releases

@liveblocks/node

• Add new markdownToCommentBody helper to convert Markdown strings into
  CommentBody objects.

@liveblocks/client

• room.history.disable(fn) is now officially supported and no longer
  experimental. It allows running storage mutations without them appearing on
  the undo/redo stacks and it’s intended for background/async writes (e.g.
  writing back AI generation results) that should not be undoable.

@liveblocks/react-tiptap

• Fix keyboard shortcut in strikethrough tooltip. (Thanks @HellBoy-OP for the
  contribution!)
• Fix Yjs undo/redo silently breaking after editor.registerPlugin /
  unregisterPlugin is called (e.g. when Tiptap's BubbleMenu, DragHandle,
  or SlashCommand mount). The reattach restore() is now installed
  unconditionally on view destroy, matching upstream
  @tiptap/extension-collaboration. (Thanks @lucasmotta for the contribution!)

@liveblocks/react-tiptap

• Support overlapping comment marks, they now all appear in the
  AnchoredThreads and FloatingThreads components.

@liveblocks/emails

• Mark yjs and y-prosemirror as required peer dependencies.

@liveblocks/*

• Third-party libraries like yjs, @tiptap/*, and @blocknote/* are now declared as peer dependencies instead of bundled dependencies across all packages that use them.

@liveblocks/client

• New experimental room.history.disable(fn) API that allows running storage mutations without them appearing on the undo/redo stacks. Intended for background/async writes (e.g. writing back AI generation results) that should not be undoable.
• Fix ToJson type losing specific value types for Record<string, T> fields in Storage

@liveblocks/react-ui

• Mentions suggestions now appear in more cases after typing @:
  • After punctuation like !, ., (, etc. (e.g. Hello!@,
    cc: the other team (@)
  • After emojis (e.g. Hello 👋@)

@liveblocks/react-flow

• Introduce the package. Install with npm install @liveblocks/react-flow.
  Provides hooks and components that add collaboration to any React Flow diagram
  using Liveblocks Storage:
  • Use the useLiveblocksFlow hook to make React Flow synced and
    collaborative.
  • Use the Cursors component to show other users' cursors inside React Flow.

@liveblocks/react-ui

• Allow customizing cursors in the Cursors component by passing a
  components={{ Cursor: MyCursor }} prop.

@liveblocks/chat-sdk-adapter

• Introduce the package. Install with
  npm install @liveblocks/chat-sdk-adapter. Provides a
  chat-sdk-compatible backend adapter
  backed by Liveblocks Comments: webhooks, posting and editing messages,
  reactions, paginated fetches, thread and channel helpers, and optional
  resolveUsers / resolveGroupsInfo hooks.

@liveblocks/react

• Add Feeds hooks: useFeeds, useFeedMessages, useCreateFeed,
  useDeleteFeed, useUpdateFeedMetadata, useCreateFeedMessage,
  useDeleteFeedMessage, and useUpdateFeedMessage.

@liveblocks/node

• Add REST client methods for Feeds: getFeeds, getFeed, createFeed,
  updateFeed, deleteFeed, getFeedMessages, createFeedMessage,
  updateFeedMessage, and deleteFeedMessage.

Python SDK

• Add Feeds REST API support on the sync and async clients (get_feeds,
  get_feed, create_feed, update_feed, delete_feed, get_feed_messages,
  create_feed_message, update_feed_message, delete_feed_message) with
  matching request/response models.

@liveblocks/client

• Add Feeds: room-scoped feeds with metadata and messages and APIs to list,
  create, update, and delete feeds and messages (fetchFeeds,
  fetchFeedMessages, addFeed, updateFeed, deleteFeed, addFeedMessage,
  updateFeedMessage, deleteFeedMessage).

@liveblocks/react-ui

• Add body prop to Comment to allow overriding only the default rich-text
  comment body while still keeping attachments, reactions, and
  additionalContent as is, unlike when using the children prop.
• Fix AvatarStack negative margin breaking alignment.

@liveblocks/node

• Add Liveblocks.getAttachment() method to get an attachment's metadata and a
  presigned download URL.

Python SDK

• Add get_attachment() method to get an attachment's metadata and a presigned
  download URL.

Python SDK

• Introduce the Python package. Install with pip install liveblocks. Provides
  sync and async clients for the full Liveblocks API (rooms, storage, threads,
  comments, etc.) for backend use.

@liveblocks/react-ui

• Add showSubscription prop to Thread to control whether to show the
  thread’s subscription status.

@liveblocks/react-ui

• Add various new ways to customize Thread and Comment:
  • Comments in Thread can now be overridden or customized via the
    components prop.
  • New parts of Comment (content, avatar, author, and date) can now be
    overridden or customized via the children, additionalContent, avatar,
    author, and date props.
• Fix commentDropdownItems prop on Thread not working as expected in some
  cases.

@liveblocks/react

• Each createRoomContext() invocation now creates its own isolated context to
  allow nesting independent room contexts and their RoomProvider components.

@liveblocks/react-blocknote

• Support newer BlockNote versions and bump the minimum required version to
  v0.43.0. (Thanks @nperez0111 for the contribution!)

@liveblocks/react-ui, @liveblocks/react-tiptap, and @liveblocks/react-lexical

• Improve how inline components passed to components={{ ... }} props are
  handled by keeping them stable instead of re-mounting them on every render.
• Move @radix-ui/* dependencies to the radix-ui mono package.

This release adds support for opting-in to the new storage engine on a per-room basis. The new storage engine can support larger documents, is more performant, is considered more stable, and will eventually become our default engine for all new rooms in the future.

As of this release, the default storage engine still remains engine version 1.

To give it a try, simply pass engine: 2 when entering a new room. After a room is created, you cannot change the engine it was created with anymore.

For example:

// Vanilla JS
client.enterRoom("my-new-room", { engine: 2 });

or:

// In React
<RoomProvider id="my-new-room" engine={2}>
  ...
</RoomProvider>

@liveblocks/client

• Support for selecting the preferred engine when entering new rooms: client.enterRoom("my-new-room", { engine: 2 })
• Internal protocol optimizations to support larger storage documents
• Add new config option createClient({ baseUrl: "https://..." }) to allow connecting to the Liveblocks dev server
• Improve LiveList performance when processing large batches of operations
• Improve LiveList.push() efficiency to prevent unbounded position string growth over time
• Fix crash when clearing documents with a large number of keys
• Remove the largeMessageStrategy client option. The WebSocket message limit has been increased from 1 MB to 32 MB, making this setting obsolete.

@liveblocks/react

• Support for selecting the preferred engine when entering new rooms: <RoomProvider id="my-new-room" engine={2}>...</RoomProvider>
• Add new config option <LiveblocksProvider baseUrl="https://..." /> to allow connecting to the Liveblocks dev server
• Exclude marking a thread or inbox notification as read from blocking navigation when preventUnsavedChanges is enabled.

@liveblocks/react-tiptap and @liveblocks/react-lexical

• Portaled elements now respect the portalContainer option from @liveblocks/react-ui’s LiveblocksUiConfig instead of always using document.body.

@liveblocks/zustand and @liveblocks/redux

• Support for selecting the preferred engine when entering new rooms: enterRoom("my-new-room", { engine: 2 })

@liveblocks/node

• Add new .setPresence() method to set ephemeral presence for a user in a room via the REST API, without requiring a WebSocket connection
• Deprecated tenantId parameter in client methods, use organizationId instead.

This release adds support for comment metadata, allowing you to attach custom
metadata to individual comments in the same way as thread metadata.

All packages

• Support typing comment metadata globally via the Liveblocks interface.
• Improve CommentBody types.
• Internal refactorings to prepare for upcoming protocol updates.

@liveblocks/client

• Add new parameters to createThread, createComment, and editComment to
  attach and update comment metadata.
• Add editCommentMetadata method to update only a commentʼs metadata.

@liveblocks/react

• Add new parameters to useCreateThread, useCreateComment, and
  useEditComment to attach and update comment metadata.
• Add useEditCommentMetadata hook to update only a commentʼs metadata.

@liveblocks/react-ui

• Add commentMetadata prop to Composer to attach and update comment
  metadata.

@liveblocks/react-lexical and @liveblocks/react-tiptap

• Add commentMetadata prop to FloatingComposer to attach and update comment
  metadata.

@liveblocks/react-tiptap

• Fix Toolbar not reflecting the editorʼs current state.

@liveblocks/node

• Add new parameters to createThread, createComment, and editComment to
  attach and update comment metadata.
• Add editCommentMetadata method to update only a commentʼs metadata.
• Add commentMetadataUpdated webhook event.