feat(cloudflare): isolate Workers Cache with staged entrypoints

[james-elicx]

Summary

• make the default Worker entrypoint an uncached gateway that always runs middleware and routing
• add a cache-enabled VinextCachedResponse Worker entrypoint for reusable render responses
• configure per-entrypoint Workers Cache settings in the generated Wrangler output
• use ctx.exports for shared dispatch while keeping bypass work uncached
• preserve custom Worker entrypoints, revalidation purges, static assets, and existing app configuration
• lazy-load request and response stages so cache hits do not evaluate application rendering code

Stack

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

Validation

• CI: all 68 checks passed
• 49 focused Cloudflare config, build, facade, and handler tests passed locally
• vp check and Knip
• vp run vinext#build
• vp run @vinext/cloudflare#build

The prior combined branch was split without changing this layer's runtime behavior.

[james-elicx]

/bigbonk review for issues

Please use an 8 minute time limit.

[pkg-pr-new]

Open in StackBlitz

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

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

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

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

commit: 379ae5b

[ask-bonk]

error: Your local changes to the following files would be overwritten by checkout:
pnpm-lock.yaml
Please commit your changes or stash them before you switch branches.
Aborting

github run

[ask-bonk]

@james-elicx Bonk workflow failed. Check the logs for details.

View workflow run · To retry, trigger Bonk again.

[github-actions]

Performance benchmarks

Compared 379ae5b against base eacb78d using alternating same-runner rounds. Next.js was unchanged and skipped.

0 improved · 0 regressed · 6 within ±1.5%

Scenario	Framework	Baseline	Current	Change
Client bundle size (gzip)	vinext	142.2 KB	142.2 KB	⚫ -0.0%
Client entry size (gzip)	vinext	129.5 KB	129.5 KB	⚫ -0.0%
Dev server cold start	vinext	3.31 s	3.34 s	⚫ +0.9%
Production build time	vinext	3.69 s	3.66 s	⚫ -0.9%
RSC entry closure size (gzip)	vinext	121.2 KB	121.1 KB	⚫ -0.0%
Server bundle size (gzip)	vinext	205.1 KB	205.0 KB	⚫ -0.0%

View detailed results and traces

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

[james-elicx]

/bigbonk review for issues

Please use an 8 minute time limit. Review exact head d9c8ac4.

[ask-bonk]

error: Your local changes to the following files would be overwritten by checkout:
pnpm-lock.yaml
Please commit your changes or stash them before you switch branches.
Aborting

github run

[james-elicx]

/bigbonk review for issues

Please limit this review to 8 minutes.

[ask-bonk]

error: Your local changes to the following files would be overwritten by checkout:
pnpm-lock.yaml
Please commit your changes or stash them before you switch branches.
Aborting

github run

[github-actions]

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
web	preview	production