feat: server function inspector by lxsmnsyc · Pull Request #2049 · solidjs/solid-start

lxsmnsyc · 2026-01-14T06:42:57Z

PR Checklist

Server function inspector, keeps track of server function calls and allows you to inspect both Response and Request easier (than viewing the network tab).

Some TODOs:

renderer for seroval plugins
multipart/form-data inspector
Hex/base64/Text Viewer for ArrayBuffer and other content-types
more Request/Response info (e.g. timing, request options, etc.)

Also some UI cleanup to dedupe stuff from the current DevOverlay

Testing

~~The overlay isn't visually-accessible for now so if you want to open it, go to Console then enter __START_SERVER_FN__(true)~~

The inspector is now available in the reworked dev overlay. Design is still to be finalized.

Note

~~seroval branch doesn't depend on this one, I can rebase this to main when that happens~~

changeset-bot · 2026-01-14T06:43:01Z

🦋 Changeset detected

Latest commit: 204e0f7

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

This PR includes changesets to release 1 package

Name	Type
@solidjs/start	Minor

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

netlify · 2026-01-14T06:43:03Z

✅ Deploy Preview for solid-start-landing-page ready!

Name	Link
🔨 Latest commit	`204e0f7`
🔍 Latest deploy log	https://app.netlify.com/projects/solid-start-landing-page/deploys/6a5fb8c86706d900087afc98
😎 Deploy Preview	https://deploy-preview-2049--solid-start-landing-page.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

pkg-pr-new · 2026-01-14T06:43:45Z

Open in StackBlitz

npm i https://pkg.pr.new/@solidjs/start@2049

commit: 204e0f7

brenelz

Do we just go ahead with this. I feel its pretty isolated

lxsmnsyc · 2026-05-06T15:35:07Z

@brenelz yes exactly, it's supposed to be non-blocking. I'm planning on working on the new superfeature for the dev overlay on a separate branch.

brenelz · 2026-07-16T22:05:28Z

Failing tests... Can probably get this merged soon after

lxsmnsyc · 2026-07-17T02:40:17Z

@brenelz the PR isn't final so it's expected. I don't think I can finalize this before stable, but I'll still try.

brenelz · 2026-07-17T02:44:54Z

Can maybe target 3.0 then. Thats fine

lxsmnsyc · 2026-07-17T02:45:49Z

no not 3.0. This is going to ship in 2.0 perhaps in a minor release, just not the RC

birkskyum · 2026-07-20T19:51:03Z

Changeset missing.

birkskyum · 2026-07-21T18:35:27Z

Oh, @lxsmnsyc , sorry if this went in too early - I see your comment now above all the rebase lines that you didn't want this in 2.0, but i got confused about the title being "feat(2.0)". Should we revert ( #2226 )? How far is this towards completion?

lxsmnsyc · 2026-07-21T19:14:18Z

@birkskyum this is meant to be part of 2.0

birkskyum · 2026-07-21T22:17:05Z

Great, and regarding the main branch, how would you prefer we proceed? do we make a revert, or will you make a follow-up pr with the remaining changes, or is this feature already finished?

Brings the v2 rc line (through 2.0.0-rc.6) into the Solid 2 branch. Ported main features onto the Solid 2 architecture: - Server-function error handler (#2262): wired through handleServerFunctionRequest's transformResult hook and the solid-start:server-fn-error-handler virtual module. - Custom seroval plugins (#2250): serialization.plugins now feeds the @solidjs/web codec on both the client transport and the server handler. - ~ alias fix for workspace packages (#2239): adopted appRootAlias in place of the global resolve.alias entry. - Dev toolbar (#2049, replaces the dev overlay): ported to Solid 2 (Errored/Loading, onSettled, two-arg createEffect, draft-mutation stores, terracotta 2 subpath imports, @solidjs/web Portal/Dynamic/JSX, createMemo(async) instead of createResource). Protocol-specific pieces (SerovalChunkReader, body-format markers) moved local to the toolbar. - Deferred stream response via h3 iterable() (#2231), StartHandler type (#2234), routerLoad restore (#2228), nonce on streaming redirect script (#2252), ResizeObserver-loop filter (#2240) all kept. Kept deleted (superseded by vite-plugin-solid / @solidjs/web / @solidjs/router server-function integration): fs-routes tree-shake, manifest.ts, directives, fns serialization/registration/shared and their specs. Fixes main landed in those files (#2249, #2238, #2243, #2245, #2241, #2261) live upstream now and are tracked for porting there. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

The inspector came over from #2049 built against Start's old fetch transport; on this branch the transport lives in @solidjs/web, so the toolbar's tracker never received a call and its viewers decoded a wire format that no longer exists. - fns/client.ts: in dev, hook the transport's prepareRequest to push each outgoing call (function id + the transport's per-call instance header) and responseHandler.handle to push each response, passing both through untouched. - fns/handler.ts: in dev, echo X-Server-Function-Instance onto the response — the transport doesn't, and it is what lets the inspector pair a response with its request. - body-format.ts: track @solidjs/web's markers (X-Server-Function-Format, the Json format, the new file form key) instead of the old X-Start-Type protocol; the Serialized chunk framing is unchanged, so SerovalViewer keeps working as-is. - functions/index.tsx: add a JsonViewer for plain-JSON bodies (JSON-safe argument lists go over the wire as raw JSON). - dev-toolbar/index.tsx: keep captured instances in a signal-backed plain record instead of a store — Request/Response methods throw "Illegal invocation" when reached through Solid 2's store proxy. Calls made during SSR/hydration are served from the SSR payload without a client fetch, so only real client-initiated calls appear — which is what the inspector is for. Verified against the tests app dev server: onclick and onSettled calls both appear in the panel, request tab shows URL/headers/FormData body, response tab decodes the Serialized stream with status and timing. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

lxsmnsyc marked this pull request as draft January 14, 2026 06:43

lxsmnsyc changed the base branch from main to feat-seroval-json January 14, 2026 06:44

lxsmnsyc commented Jan 14, 2026

View reviewed changes

Comment thread apps/tests/src/routes/server-function-ping.tsx

lxsmnsyc force-pushed the feat-seroval-json branch from 7932c2f to 25b3f44 Compare January 15, 2026 03:13

lxsmnsyc force-pushed the feat-server-function-inspector branch 4 times, most recently from 4bf69fa to 830f1ce Compare January 18, 2026 15:44

lxsmnsyc force-pushed the feat-server-function-inspector branch from be34d27 to 25b0ce5 Compare January 23, 2026 07:03

lxsmnsyc force-pushed the feat-seroval-json branch from 820baec to db436df Compare February 9, 2026 11:29

atilafassina force-pushed the feat-seroval-json branch from db436df to 0defa47 Compare February 19, 2026 19:45

Base automatically changed from feat-seroval-json to main February 25, 2026 16:48

lxsmnsyc force-pushed the feat-server-function-inspector branch from 860f37b to 8ea8a8b Compare February 26, 2026 01:28

lxsmnsyc marked this pull request as ready for review February 27, 2026 11:48

lxsmnsyc requested a review from atilafassina February 27, 2026 11:48

lxsmnsyc force-pushed the feat-server-function-inspector branch from c84c5ea to 78c44de Compare April 3, 2026 17:55

brenelz approved these changes May 6, 2026

View reviewed changes

lxsmnsyc force-pushed the feat-server-function-inspector branch from fc77b8b to ab72e93 Compare July 6, 2026 17:09

lxsmnsyc force-pushed the feat-server-function-inspector branch from b2926bb to 518af61 Compare July 16, 2026 20:17

lxsmnsyc force-pushed the feat-server-function-inspector branch 2 times, most recently from ca69989 to fca0400 Compare July 17, 2026 16:59

lxsmnsyc added 12 commits July 21, 2026 11:37

Fix paths

579a9ca

move dev overlay

5ac93e1

Update icons.tsx

2f6c9dd

Update terracotta

99ff9a4

Move server-function-inspector

05762e2

Update tracker.ts

b72d59e

initial rework for the dev toolbar

a28a9e7

Update (no-side-effects).tsx

e2e2fcd

fix build

a60ca5f

fix styles

fb23081

fix border colors

91dfda4

fix styling

0d55980

lxsmnsyc force-pushed the feat-server-function-inspector branch from 640ad60 to 0d55980 Compare July 21, 2026 03:37

lxsmnsyc and others added 2 commits July 21, 2026 11:39

Create chilly-rabbits-lie.md

5ead42d

Merge branch 'main' into feat-server-function-inspector

64a64c4

birkskyum mentioned this pull request Jul 21, 2026

chore: stabilize flaky ci tests #2225

Merged

Merge branch 'main' into feat-server-function-inspector

204e0f7

birkskyum merged commit eeff49a into main Jul 21, 2026
10 checks passed

birkskyum deleted the feat-server-function-inspector branch July 21, 2026 18:25

birkskyum changed the title ~~feat(2.0): server function inspector~~ feat: server function inspector Jul 21, 2026

birkskyum restored the feat-server-function-inspector branch July 21, 2026 18:41

birkskyum mentioned this pull request Jul 21, 2026

Revert "feat: server function inspector" #2226

Closed

birkskyum changed the title ~~feat: server function inspector~~ feat(2.1): server function inspector Jul 21, 2026

birkskyum changed the title ~~feat(2.1): server function inspector~~ feat: server function inspector Jul 21, 2026

birkskyum mentioned this pull request Jul 27, 2026

fix: remove noisy logs from server fns #2258

Merged

Uh oh!

Conversation

lxsmnsyc commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Checklist

Testing

Uh oh!

changeset-bot Bot commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

netlify Bot commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for solid-start-landing-page ready!

Uh oh!

pkg-pr-new Bot commented Jan 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

brenelz left a comment

Choose a reason for hiding this comment

Uh oh!

lxsmnsyc commented May 6, 2026

Uh oh!

brenelz commented Jul 16, 2026

Uh oh!

lxsmnsyc commented Jul 17, 2026

Uh oh!

brenelz commented Jul 17, 2026

Uh oh!

lxsmnsyc commented Jul 17, 2026

Uh oh!

birkskyum commented Jul 20, 2026

Uh oh!

Uh oh!

birkskyum commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lxsmnsyc commented Jul 21, 2026

Uh oh!

birkskyum commented Jul 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lxsmnsyc commented Jan 14, 2026 •

edited

Loading

changeset-bot Bot commented Jan 14, 2026 •

edited

Loading

netlify Bot commented Jan 14, 2026 •

edited

Loading

pkg-pr-new Bot commented Jan 14, 2026 •

edited

Loading

birkskyum commented Jul 21, 2026 •

edited

Loading