Add new useRpc hook prototype

[1egoman]

Overview

A prototype of a new useRpc hook aiming to simplify both sending and responding to rpc messages.

A snapshot build was published on npm, run the below to give it a shot locally:

$ npm install --save @livekit/components-react@rpc-prototype

Example usage:

Here's the server end:

// "Server" end of RPC assumes json encoded rpc requests / responses
useRpc(session, "getUserLocation", async (payload: { highAccuracy: boolean }, data) => {
  const position = await new Promise<GeolocationPosition>((resolve, reject) => {
    navigator.geolocation.getCurrentPosition(resolve, reject, {
      enableHighAccuracy: payload.highAccuracy,
      timeout: data.responseTimeout * 1000,
    });
  });
  return {
    latitude: position.coords.latitude,
    longitude: position.coords.longitude,
  };
});

// Alternative: custom request / response serialization:
useRpc(
  session,
  "getUserLocation",
  async (payload, data) => {
    return "raw text";
  },
  // To go back to raw serialization, pass serializers.raw() explicitly here:
  { serializer: serializers.raw() },
);

// Alternative: custom request / response serialization:
useRpc(
  session,
  "getUserLocation",
  async (payload /* <= decoded from base64 */, data) => {
    return "text to base64 encode";
  },
  {
    // Fully custom serializer example (base64):
    serializer: serializers.custom({
      parse: (raw) => window.atob(raw),
      serialize: (base64) => window.btoa(base64),
    })
  }
);

And the client end:

const { performRpc } = useRpc();

// The "Client" end of RPC also defaults to json:
const result = await performRpc({
  destinationIdentity: participantIdentity,
  method: 'getUserLocation',
  payload: { highAccuracy: true },
});

// Example of using a serializer in the client end as well:
const result = await performRpc({
  destinationIdentity: participantIdentity,
  method: 'getUserLocation',
  payload: "raw text",
}, serializers.raw());

Todo

• Add missing changeset
• I can't get the api-extractor check to pass in ci (it passed locally) and can't figure out why... Debug this.
• Update livekit-client dependency to be a version which contains the changes in Move over serializer implementation from components-js client-sdk-js#1885 to get the ci build to pass

[github-actions]

size-limit report 📦

Path	Size
LiveKitRoom only	6.01 KB (0%)
LiveKitRoom with VideoConference	32.24 KB (0%)
All exports	43.45 KB (+0.88% 🔺)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
components-js-storybook-5kld	Ready	Preview, Comment	Apr 15, 2026 4:26pm

[changeset-bot]

🦋 Changeset detected

Latest commit: f5acb22

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 6 packages

Name	Type
@livekit/components-react	Patch
@agents-ui	Patch
@livekit/component-example-next	Patch
@livekit/components-js-docs	Patch
@livekit/component-docs-storybook	Patch
@livekit/components-docs-gen	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[1egoman]

Ok, I think this is finally in a good state to get some review eyes on. Lukas and I have talked about it fairly extensively though so I'm hoping it's fairly straightforward 🤞

[1egoman]

(rebased on top of latest main)

[1egoman]

@lukasIO I believe all the comments we had both left should be addressed - any concerns with merging this as is? If not, can you give me a ✅ ?