Changelog

@liveblocks/client

• Improve configuration error messages to be more user friendly.
• Fix bug where entering a new room could potentially initialize the undo stack incorrectly.

create-liveblocks-app

• Fix Suspense option when specifying a framework.
• Add helpful comments by default.

@liveblocks/node

• Add Yjs document change event (YDocUpdatedEvent) to WebhookHandler.
• Allow Header object to be passed to headers in WebhookHandler.verifyRequest()

@liveblocks/node

• Fix session.allow to support path up to 128 characters to meet room id length requirement.

@liveblocks/*

• Support the new and improved Liveblocks authorization.
• Change client logic to stop retrying if room is full. Instead, the client will now disconnect. To retry, call room.reconnect() explicitly.

@liveblocks/node

• Add new APIs for authorization. See our migration guide for tips on how to adopt the new style of authorizing your Liveblocks clients.

• Fix a small TypeScript issue introduced in 1.1.7.

@liveblocks/client

• When initializing the client with a custom auth callback, you can now return { error: "forbidden", reason: ... } as the response, which the client will treat as a sign to stop retrying. The client will then disconnect from the room, instead of remaining in "connecting" status indefinitely.

@liveblocks/react

• Fix a bug with useSelf() where it would not correctly re-render after entering an empty room. It’s now consistent again with useMyPresence().

DevTools

• Fix a bug in the Liveblocks DevTools panel where the "me" view would incorrectly stay empty after entering an empty room.

@liveblocks/*

• Loosen duplicate import detection so it won't throw when used in test runners that deliberately run multiple instances of a module (like Jest or Playwright can do).

@liveblocks/*

• Ship all of our packages as both ESM and CJS modules again (restore the changes that 1.1.3 originally introduced).
• Auto-detect if multiple copies of Liveblocks are included in your production bundle. If so, a help page is presented that will help you resolve this issue.
• Fix a bug where the room internals could become non-functional when used in combination with Immer due to Immer’s excessive auto-freezing, which would break the room’s internals. (This became an issue since Liveblocks 1.1 was released.)

• Undo the changes made in 1.1.3. We’ve got some bug reports where Liveblocks could still be doubly-included in production bundles (in some bundler setups only), with storage data corruptions as a possible result. We’re investigating.

Ship all of our packages as both ESM and CJS modules. By upgrading, your project’s bundler can now perform (better) tree-shaking on the Liveblocks code.

You can expect (at least) the following bundle size reductions:

• @liveblocks/client from 80kB → 70kB
• @liveblocks/react from 129kB → 80kB
• @liveblocks/redux from 84kB → 38kB
• @liveblocks/zustand from 83kB → 37kB
• @liveblocks/yjs from 129kB → 74kB