Skip to content
Source
Sign inSign up
TanStack/router
Open History to see the last commit

serialization.client.ts

54 lines1.6 KB

1import { createSerializationAdapter } from '@tanstack/react-router'
2// RSC HMR setup (dev-only, provided by the active Start bundler adapter).
3import { setupRscHmr } from 'virtual:tanstack-rsc-hmr'
4import {
5 createCompositeFromStream,
6 createRenderableFromStream,
7} from './createServerComponentFromStream'
8import type {
9 AnyCompositeComponent,
10 RscSlotUsageEvent,
11} from './ServerComponentTypes'
12​
13if (process.env.NODE_ENV === 'development') {
14 setupRscHmr()
16​
17/**
18 * Client-side serialization adapter for RSC (renderable + composite).
19 */
20type SerializedRsc = {
21 kind: 'renderable' | 'composite'
22 stream: ReadableStream<Uint8Array>
23 slotUsagesStream?: ReadableStream<RscSlotUsageEvent>
24 cssHrefs?: Array<string>
25 jsPreloads?: Array<string>
27​
28const adapter = createSerializationAdapter({
29 key: '$RSC',
30 test: (_value: unknown): _value is never => false,
31 toSerializable: (): never => {
32 throw new Error('RSC cannot be serialized on client')
33 },
34 fromSerializable: (value: SerializedRsc): AnyCompositeComponent => {
35 // Rsbuild SSR sends asset deps with each serialized RSC so the client can
36 // preload only if that specific stream is rendered. When absent, decode
37 // starts eagerly and discovers assets from the Flight payload as before.
38 const options = {
39 cssHrefs: value.cssHrefs,
40 jsPreloads: value.jsPreloads,
41 }
42​
43 if (value.kind === 'renderable') {
44 return createRenderableFromStream(value.stream, options)
45 }
46​
47 return createCompositeFromStream(value.stream, {
48 slotUsagesStream: value.slotUsagesStream,
49 ...options,
50 })
51 },
52})
53​
54export const rscSerializationAdapter = () => [adapter]