feat(cloudflare): prewarm canonical RSC navigation requests

.github/workflows/deploy-examples.yml

@@ -72,9 +72,17 @@ jobs:
         run: vp run build
 
       - name: Build example
+        if: github.event_name != 'pull_request' || matrix.example.name != 'workers-cache'
         run: vp build
         working-directory: ${{ matrix.example.working_directory }}
 
+      - name: Build Workers Cache preview with prewarmable routes
+        if: github.event_name == 'pull_request' && matrix.example.name == 'workers-cache'
+        run: vp exec vinext build
+        working-directory: ${{ matrix.example.working_directory }}
+        env:
+          VINEXT_PREPARE_RSC_WARM_PREVIEW: "1"
+
       - name: Apply D1 migrations (benchmarks only)
         if: matrix.example.name == 'benchmarks' && github.event_name == 'push' && github.ref == 'refs/heads/main'
         uses: cloudflare/wrangler-action@ebbaa1584979971c8614a24965b4405ff95890e0 # v4.0.0

apps/web/wrangler.jsonc

@@ -58,4 +58,7 @@
   "cache": {
     "enabled": true,
   },
+  "version_metadata": {
+    "binding": "VINEXT_VERSION_METADATA",
+  },
 }

examples/workers-cache/vite.config.ts

@@ -4,13 +4,16 @@ import { cdnAdapter } from "@vinext/cloudflare/cache/cdn-adapter";
 import { kvDataAdapter } from "@vinext/cloudflare/cache/kv-data-adapter";
 import { cloudflare } from "@cloudflare/vite-plugin";
 
+const prepareRscWarmPreview = process.env.VINEXT_PREPARE_RSC_WARM_PREVIEW === "1";
+
 export default defineConfig({
   plugins: [
     vinext({
       cache: {
         cdn: cdnAdapter(),
         data: kvDataAdapter(),
       },
+      prerender: prepareRscWarmPreview ? { routes: "*" } : undefined,
     }),
     cloudflare({
       viteEnvironment: {

examples/workers-cache/wrangler.jsonc

@@ -28,5 +28,8 @@
   "cache": {
     "enabled": true,
   },
+  "version_metadata": {
+    "binding": "VINEXT_VERSION_METADATA",
+  },
   "kv_namespaces": [{ "binding": "VINEXT_KV_CACHE", "id": "b38f84f642aa4bd4ba17a37bb516f0b5" }],
 }

knip.ts

@@ -58,6 +58,11 @@ export default {
         // Runtime helpers imported by generated virtual entries. The imports
         // are emitted as strings, so knip cannot trace them statically.
         "src/client/react-instance-bootstrap.ts",
+        // Capability-selected virtual modules import these implementation
+        // namespaces through generated strings, so Knip cannot see every
+        // registered method as a static consumer.
+        "src/client/rsc-prewarm-runtime.ts",
+        "src/server/rsc-prewarm-runtime.ts",
         "src/server/app-middleware.ts",
         "src/server/app-page-dispatch.ts",
         "src/server/app-page-head.ts",