feat(build): add transport-neutral worker stages by james-elicx · Pull Request #3083 · cloudflare/vinext

james-elicx · 2026-08-25T23:13:04Z

Summary

split App and Pages Worker handling into transport-neutral request and response stages
keep middleware, config routing, and request-specific response composition in the uncached request stage
preserve reusable rendering and ISR beneath that boundary without changing legacy single-stage behavior
bypass shared stages for valid and stale Pages preview cookies; stale-cookie cleanup is deliberately private/no-store as an edge-cache safeguard
suppress middleware and conditional next.config cacheability vetoes only when the staged request boundary owns them
carry matched positive config policy, Vary identity, pregenerated paths, and authenticated readiness across stage transports
keep generated entries thin and lazy so adapters can choose RPC or independently deployed HTTP stages

This layer contains no Cloudflare RPC, Worker export, Wrangler, Workers Cache, or HTTP transport implementation.

Stack

tooling baseline (chore(deps): update Cloudflare Workers tooling #3082)
This PR: transport-neutral worker stages (feat(build): add transport-neutral worker stages #3083)
Cloudflare Workers Cache entrypoint isolation (feat(cloudflare): isolate Workers Cache with staged entrypoints #3079)
independently deployed HTTP stages (feat(build): support independently deployed worker stages #3084)
Workers Cache tag parity (fix(cloudflare): preserve Workers Cache tag parity #3085)

Validation

focused Pages stage/finalization tests: 83 passed
invalid preview-cookie deployed fixture regression: passed
guarded dynamic-request regression: passed
full vp check and Knip: passed
vinext build: passed

pkg-pr-new · 2026-08-25T23:13:59Z

Open in StackBlitz

npm i https://pkg.pr.new/@vinext/cloudflare@3083

npm i https://pkg.pr.new/create-vinext-app@3083

npm i https://pkg.pr.new/@vinext/types@3083

npm i https://pkg.pr.new/vinext@3083

commit: 9e5d0c2

github-actions · 2026-08-25T23:18:58Z

Example	Preview	Production	Original
app-router-cloudflare	preview	production
pages-router-cloudflare	preview	production
app-router-playground	preview	production	original
realworld-api-rest	preview	production
nextra-docs-template	preview	production
benchmarks	preview	production
hackernews	preview	production	original
workers-cache	preview	production
static-export	preview	production
web	preview	production

github-actions · 2026-08-25T23:24:47Z

Performance benchmarks

Compared 9e5d0c2 against base 1bd47c0 using alternating same-runner rounds. Next.js was unchanged and skipped.

0 improved · 4 regressed · 2 within ±1.5%

Scenario	Framework	Baseline	Current	Change
Client bundle size (gzip)	vinext	142.3 KB	142.4 KB	⚫ +0.0%
Client entry size (gzip)	vinext	129.6 KB	129.6 KB	⚫ +0.0%
Dev server cold start	vinext	3.24 s	3.39 s	🔴 +4.8%
Production build time	vinext	3.60 s	3.69 s	🔴 +2.5%
RSC entry closure size (gzip)	vinext	119.2 KB	125.7 KB	🔴 +5.5%
Server bundle size (gzip)	vinext	202.8 KB	216.4 KB	🔴 +6.7%

View detailed results and traces

_{🟢 improvement · 🔴 regression · ⚫ change below 1.5% · paired base/head}

ask-bonk · 2026-09-02T04:06:15Z

Posted 4 actionable inline findings on exact head 61b9b1b.

github run

james-elicx · 2026-09-02T04:06:47Z

/bigbonk review for issues

Please use an 8 minute time limit and review exact head ef41ed0. The preceding exact-head run was cancelled by workflow concurrency; this is the retry.

ask-bonk · 2026-09-02T04:15:46Z

Posted 4 actionable inline findings on exact head ef41ed0.

github run

james-elicx · 2026-09-02T04:15:49Z

/bigbonk review for issues

Please use an 8 minute time limit and review exact head 029e396. The earlier run targeted a superseded head and was cancelled.

james-elicx · 2026-09-02T04:25:56Z

/bigbonk review for issues

Please use an 8 minute time limit and review exact head e6b2271. This includes the ASCII-safe encoding fix for Unicode probe route metadata.

ask-bonk · 2026-09-02T04:32:50Z

Posted 1 actionable inline finding on exact head e6b227120. Unicode probe encoding tests pass.

github run

james-elicx · 2026-09-02T04:51:56Z

/bigbonk review for issues

Please review exact head 5b65155. Time limit: 8 minutes. Focus on correctness against current main prewarming behavior, Next.js routing/cache parity, and the staged transport fixes.

ask-bonk · 2026-09-02T04:57:14Z

Posted 2 actionable inline findings on exact head 5b651557.

github run

james-elicx · 2026-09-02T06:19:34Z

/bigbonk review for issues

Please review exact head 9e5d0c2. Time limit: 8 minutes. Focus on faithful integration with the merged pre-warming refactor, staged-only middleware and next.config cacheability behavior, draft/preview bypasses, and regressions to legacy single-stage behavior.

james-elicx · 2026-09-02T10:28:20Z

Superseded by the focused staged implementation in #3142 through #3156.

This was referenced Aug 25, 2026

feat(cloudflare): isolate Workers Cache with staged entrypoints #3079

Closed

feat(build): support independently deployed worker stages #3084

Closed

fix(cloudflare): preserve Workers Cache tag parity #3085

Closed

james-elicx force-pushed the codex/cdn-stack-core branch from e242325 to 2a1a9d5 Compare August 25, 2026 23:15

james-elicx force-pushed the codex/cdn-stack-core branch from 2a1a9d5 to eacb78d Compare August 25, 2026 23:19

james-elicx mentioned this pull request Aug 25, 2026

chore(deps): update Cloudflare Workers tooling #3082

Merged

james-elicx added 21 commits September 2, 2026 00:07

feat(build): add transport-neutral worker stages

79abe38

feat(cache): admit responses within cacheable stages

ad9fe26

fix(cache): preserve staged prewarming semantics

337115c

fix(cache): preserve staged routing parity

cfae9ec

fix(cache): shape completed staged responses

3b90c46

fix(cache): reconcile outer private policies

58f56d3

fix(cache): reconcile hybrid Pages outer policy

365e79d

fix(cache): isolate request-stage cacheability

d7b71bf

fix(build): keep client asset import beside server entry

7b089b9

fix(cache): preserve staged HEAD and probe semantics

e29ce05

fix(cache): purge Pages CDN entries after revalidation

cc60853

test(cache): preserve staged execution context coverage

871e85c

fix(cache): preserve staged request identity

b81aeaf

fix(cache): preserve regenerated response metadata

7f3c02b

style(cache): format staged cache helpers

9570212

fix(cache): bypass shared stages after middleware request overrides

26a8b2f

fix(cache): admit explicitly public Pages APIs

d8aef7d

fix(cache): preserve outer Pages cache policy

3c5abef

refactor(cache): extract app request stage dispatch

cb143c4

fix(build): classify both staged app graphs

f6fb6f3

fix(cache): preserve staged response policy precedence

2e6e873

ask-bonk Bot reviewed Sep 2, 2026

View reviewed changes

Comment thread packages/vinext/src/server/pages-router-entry.ts

Comment thread packages/vinext/src/server/pages-api-route.ts

Comment thread packages/vinext/src/server/pages-node-compat.ts

Comment thread packages/vinext/src/server/app-rsc-response-stage.ts

fix(cache): classify terminal request-stage probes

029e396

ask-bonk Bot reviewed Sep 2, 2026

View reviewed changes

fix(cache): encode probe route metadata

e6b2271

ask-bonk Bot reviewed Sep 2, 2026

View reviewed changes

Comment thread packages/vinext/src/server/multi-stage.ts Outdated

fix(cache): preserve staged request semantics

5b65155

fix(cache): authenticate Worker prerender state

7fa477e

ask-bonk Bot reviewed Sep 2, 2026

View reviewed changes

Comment thread packages/vinext/src/server/app-request-stage-independent-entry.ts

Comment thread packages/vinext/src/build/prerender-paths.ts

james-elicx added 11 commits September 2, 2026 06:14

fix(cache): isolate request-stage cache adapters

e219581

fix(cache): preserve staged Pages response boundaries

0ce5b6d

fix(cache): probe request-stage terminal routes

9665720

fix(cache): report resolved probe pathnames

34922be

fix(cache): bypass hybrid custom Documents

e46fe4d

fix(cache): preserve adapter policy probe coverage

1321ccb

fix(build): preserve prewarm state in response stages

86fb9d4

fix(cache): fail closed on wrapped Documents

5a9f4c6

fix(cache): bypass stale Pages previews

69029fd

fix(pages): keep invalid preview cleanup private

3520ecd

docs(pages): explain stale preview cache policy

9e5d0c2

james-elicx closed this Sep 2, 2026

Uh oh!

Conversation

james-elicx commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Stack

Validation

Uh oh!

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

Uh oh!

Uh oh!

github-actions Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance benchmarks

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ask-bonk Bot commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ask-bonk Bot commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

Uh oh!

ask-bonk Bot commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

Uh oh!

Uh oh!

ask-bonk Bot commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

james-elicx commented Sep 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

james-elicx commented Aug 25, 2026 •

edited

Loading

pkg-pr-new Bot commented Aug 25, 2026 •

edited

Loading

github-actions Bot commented Aug 25, 2026 •

edited

Loading

github-actions Bot commented Aug 25, 2026 •

edited

Loading