Repository navigation
Adapter 0.9.0: pages stream, as on a Worker, with a /stream page that proves it - #61
Merged
Merged
Conversation
…wait The same page in both examples. Its loader returns a promise that resolves two seconds later, and the page renders it with Await behind a fallback. On a host that streams, the document goes out at once with the fallback and the value follows in a later chunk, with React's swap script; on a host that sends the document whole, everything arrives after two seconds. The Workers twin under wrangler dev, fetched with a browser user agent: 4.2 kB at 0 ms, the rest 2.0 s later. With curl's own user agent TanStack treats the client as a bot and waits for the whole document first. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
Preview of examples/tanstack-ssr: https://greedy-orca-541.convex.site |
|
Preview of examples/tanstack-spa: https://wooden-jaguar-615.convex.site |
commit: |
…ate 2026-08-04 Cloudflare turns nodejs_compat on by default for Workers whose compatibility date is 2026-08-04 or later (changelog 2026-08-04-nodejs-compat-default); the twin's date is 2026-10-01. Checked by building and running the twin without the flag under wrangler dev: the server bundle still imports node:stream and node:async_hooks, and the Worker serves the pages. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Codex: a navigation inside the app runs the page's loader in the browser, so the timer ran there on both hosts and the demo never reached the server. The header link now reloads the document. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
nicu-chiciuc
force-pushed
the
nicu-stream-page
branch
from
October 16, 2026 19:28
9d41bb0 to
1fa77a9
Compare
The server entry is TanStack's own stream handler: React's Web Stream renderer, the document sent as it renders, each Suspense boundary and deferred loader value in a later chunk, status and redirects decided before the first byte, the whole document for a client TanStack takes for a bot. The whole-render wait and the progressiveChunkSize override of 0.6.0 are gone with it. The one obstacle was bundling: TanStack's stream renderer and router-core's stream transformer import Node's stream classes at the top of their files for a branch that runs only where React has no Web Stream renderer. Convex has that renderer, so the branch never runs, and Convex's bundler had no node:stream to resolve. convexSsr() now resolves node:stream to a stub whose classes throw if anything calls them. node:async_hooks already bundled, Convex provides AsyncLocalStorage. Measured on the SSR example's dev deployment, /stream with a browser user agent: first byte at 0.5 s with the fallback, last byte at 2.5 s with the value; with curl's user agent, the whole document at 2.2 s. The Workers twin: 0.1 s and 2.1 s. Closes #49. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
nicu-chiciuc
force-pushed
the
nicu-stream-page
branch
from
October 16, 2026 19:38
1fa77a9 to
4bb8c22
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes issue 49.
Adapter 0.9.0: pages stream
The adapter's server entry is now TanStack's own stream handler,
createStartHandler(defaultStreamHandler), plus theURLSearchParams.sizegetter Convex lacks. The whole-render wait, therenderSsrHtmlResponsedetour, the doctype trimming, and theprogressiveChunkSizeoverride are gone.The one obstacle was bundling, not the runtime. TanStack's stream renderer and router-core's stream transformer import Node's stream classes at the top of their files, for a branch that runs only where React has no Web Stream renderer. Convex has that renderer, so the branch never runs, and Convex's bundler had no
node:streamto resolve.convexSsr()now resolvesnode:streamto a stub module shipped with the adapter, whose classes throw if anything calls them.node:async_hooksalready bundled, Convex providesAsyncLocalStorage. The example's server bundle after the change importsnode:async_hooksand nothing else from Node.Every host TanStack documents has Node's stream module: Node, Bun, Deno, Netlify's functions, Vercel through Nitro, and Cloudflare Workers through
nodejs_compat, on by default since compatibility date 2026-08-04. Convex's runtime is the one without it, so nobody upstream has needed the split; the one related PR, TanStack/router#8094 for Solid, has waited since August without review and does not touch the React file. The stub is independent of upstream./stream: the proof, in both examplesThe loader returns a promise that resolves two seconds later, without awaiting it, and the page renders it with
<Await>behind a fallback. The header link requests the document, because a navigation inside the app would run the loader in the browser. Fetched with a browser user agent:With curl's own user agent TanStack takes the client for a bot and sends the whole document at 2.2 s, on both hosts.
/,/about/,/todos(307 to/signin),/signin, and a 404 answer as before.Also
The twin's
nodejs_compatflag line is gone: Cloudflare turns it on by default from compatibility date 2026-08-04, the twin's is 2026-10-01, and the twin builds and runs without it.Adapter 0.9.0 breaks nothing in apps:
src/server.tskeeps re-exporting the entry; the three apps need only the dependency bump. The header fix is PR 63.🤖 Generated with Claude Code