feat(devtools): client-side onDevtoolsReady + expose Vite DevTools client; fix client RPC registration

[antfubot]

What & why

Follow-up to #1021, bringing the client-side RPC surface to parity with the server.

Client-side onDevtoolsReady()

Mirror of the server's onDevtoolsReady, exported from @nuxt/devtools-kit/iframe-client. Runs once the Vite DevTools client connects and hands back the DevToolsRpcClient — the recommended entry point for client-side integration:

import { onDevtoolsReady } from '@nuxt/devtools-kit/iframe-client'

onDevtoolsReady((kit) => {
  kit.client.register({ name: 'my-module:on-update', type: 'event', handler })
})

Expose the Vite DevTools client (symmetry with the server)

client.devtools.devtoolsKit is now the connected DevToolsRpcClient, mirroring nuxt.devtools.devtoolsKit on the server — full devframe-native access (register client RPC, call server functions, shared state, streaming, scoping) with no @vitejs/devtools-kit/client import needed.

Deprecate extendClientRpc

Deprecated in favour of onDevtoolsReady((kit) => kit.client.register(...)) (or the exposed devtoolsKit). Now also overrides by default via the forced upsert below.

Fix the DF0022 client RPC errors

The legacy client RPC proxy registered its event functions (refresh, callHook, onTerminalData, onTerminalExit, navigateTo) via a has() ? update() : register() dance that could throw DF0022: RPC function "…" is not registered. upsertClientFunction now force-registers (register(def, true)) — an idempotent override that never trips DF0021/DF0022 across (re)connect or overrides.

Notes

• Client-only change.
• pnpm lint, pnpm build, pnpm typecheck, and unit tests all pass.

This PR was created with the help of an agent.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3ebd59ef-24d4-4e79-8b2f-ef1510308e4a

📥 Commits

Reviewing files that changed from the base of the PR and between e6cf4bb and 3c41be3.

📒 Files selected for processing (1)

• packages/devtools/client/composables/rpc.ts

🚧 Files skipped from review as they are similar to previous changes (1)

• packages/devtools/client/composables/rpc.ts

---

📝 Walkthrough

Walkthrough

The change exposes a connected devtoolsKit RPC client, documents it as the replacement for extendClientRpc, and adds deprecation documentation and a one-time runtime warning. Client RPC handler upserts now always use forced registration instead of conditional update-or-register logic.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 33.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: client-side onDevtoolsReady, exposing the DevTools client, and client RPC registration fixes.
Description check	✅ Passed	The description is directly about the client-side RPC API, deprecation, and registration fixes introduced by the PR.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

packages/devtools/client/composables/rpc.ts

ESLint skipped: missing config or dependency (missing-dependency). The ESLint configuration references a package that is not available in the sandbox.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}