feat(rsc): ability to register server function via plugins#1310

Merged

hi-ogawa merged 25 commits into

mainfrom

server-reference-claims

Jul 24, 2026

hi-ogawa commented Jul 24, 2026 •

edited

Loading

Contributor

Previously our builtin server function support owned manager.serverReferenceMetaMap lifecycle entirely i.e. only use server directive can participate in server function logic. This change is aimed to extend the serverReferenceMetaMap singleton concept so that user land plugins can manage server reference independently through own transform. The implementation is inspired by how Vinext keeps track of server references cloudflare/vinext#2156 with sandwitched plugins.

See packages/plugin-rsc/examples/custom-server-function/custom-server-function-plugin.ts for custom server function plugin example.

As explained in the design document above, this is independent from #1246 which is for improving standalone transform utilities and not about rsc plugin's builtin server references registration mechanism.

TODO

review
e2e
doc?


          refactor(rsc): track server reference claims

124f6ea

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa changed the title ~~refactor(rsc): track server reference claims~~ feat(rsc): ability to register server function via plugins

hi-ogawa and others added 2 commits

July 24, 2026 12:32


          test(rsc): cover custom server function claims

e459dd7

Co-authored-by: OpenCode <noreply@opencode.ai>


          docs(rsc): document custom server function example

0b27517

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa marked this pull request as draft

July 24, 2026 03:35

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/src/plugin.ts Outdated

packages/plugin-rsc/src/plugin.ts Outdated

packages/plugin-rsc/src/plugin.ts Outdated

packages/plugin-rsc/examples/custom-server-function/README.md Outdated

hi-ogawa and others added 3 commits

July 24, 2026 14:15


          refactor(rsc): extract server references manager

bc00015

Co-authored-by: OpenCode <noreply@opencode.ai>

nit

eabc0c8


          test(rsc): cover custom server function proxies

a93de80

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/src/plugin.ts Outdated

packages/plugin-rsc/examples/custom-server-function/custom-server-function-plugin.ts Outdated

packages/plugin-rsc/src/plugin.ts Outdated

hi-ogawa and others added 2 commits

July 24, 2026 14:56


          test(rsc): cover server reference claim hmr

a7c6815

Co-authored-by: OpenCode <noreply@opencode.ai>


          test(rsc): align custom example with starter

c74f1e3

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/examples/custom-server-function/src/env.d.ts Outdated


          test(rsc): cover progressive custom server forms

7ace06b

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/e2e/custom-server-function.test.ts Outdated

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/src/plugin.ts

Comment on lines +44 to +45

		ServerReferencesManager,
		type ServerReferenceMeta,

hi-ogawa Jul 24, 2026

Contributor Author

export type from top-level?

hi-ogawa Jul 24, 2026

Contributor Author

probably fine for later.

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/src/plugin.ts Outdated

hi-ogawa and others added 2 commits

July 24, 2026 15:20


          refactor(rsc): simplify server reference claims

a5ceee0

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): derive server reference metadata

c652ea1

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/examples/custom-server-function/custom-server-function-plugin.ts

hi-ogawa commented

View reviewed changes

packages/plugin-rsc/src/plugins/server-reference.ts

hi-ogawa and others added 9 commits

July 24, 2026 15:41


          refactor(rsc): normalize server reference import ids

f4ae4fa

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): expose server reference metadata map

b7fa005

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): add server reference lookup helper

44d73a3

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): separate server reference claim deletion

f36fe28

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): simplify server reference claim replacement

cfc6789

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): simplify server reference claim map

de91c9b

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): clarify server reference aggregation

0757c63

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): use plugin names as claim owners

2733cee

Co-authored-by: OpenCode <noreply@opencode.ai>


          refactor(rsc): expose plugin manager type

577c4a9

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa and others added 4 commits

July 24, 2026 16:24


          test(rsc): localize server-only type suppression

1bf72c2

Co-authored-by: OpenCode <noreply@opencode.ai>


          test(rsc): reset custom server function state

44cea03

Co-authored-by: OpenCode <noreply@opencode.ai>


          Merge origin/main into server-reference-claims

af9c022

Co-authored-by: OpenCode <noreply@opencode.ai>


          fix(rsc): preserve server reference claim ids

a963851

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa marked this pull request as ready for review

July 24, 2026 07:58


          test(rsc): clarify custom action ownership flow

Co-authored-by: OpenCode <noreply@opencode.ai>

hi-ogawa merged commit 31cdbb8 into main

22 checks passed

hi-ogawa deleted the server-reference-claims branch

July 24, 2026 09:38

hi-ogawa mentioned this pull request

refactor(use-cache): move server function directives to user land cloudflare/vinext#2156

Draft

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet