feat!: serve requests through the official Next.js adapter runtime

.claude/settings.json

@@ -0,0 +1,29 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "EnterWorktree",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "D=$(pwd); case \"$D\" in */.claude/worktrees/*) ;; *) exit 0 ;; esac; if [ ! -f \"$D/package.json\" ] || [ -d \"$D/node_modules\" ]; then exit 0; fi; LOG=/tmp/claude-worktree-setup.log; if pnpm install > \"$LOG\" 2>&1; then echo '{\"systemMessage\": \"Worktree deps installed: pnpm install\"}'; else echo \"{\\\"systemMessage\\\": \\\"Worktree dependency install failed - see $LOG\\\"}\"; fi",
+            "timeout": 600,
+            "statusMessage": "Installing worktree dependencies (pnpm install)..."
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "D=$(pwd); case \"$D\" in */.claude/worktrees/*) ;; *) exit 0 ;; esac; if [ ! -f \"$D/package.json\" ] || [ -d \"$D/node_modules\" ]; then exit 0; fi; LOG=/tmp/claude-worktree-setup.log; if pnpm install > \"$LOG\" 2>&1; then echo '{\"systemMessage\": \"Worktree deps installed: pnpm install\"}'; else echo \"{\\\"systemMessage\\\": \\\"Worktree dependency install failed - see $LOG\\\"}\"; fi",
+            "timeout": 600,
+            "statusMessage": "Installing worktree dependencies (pnpm install)..."
+          }
+        ]
+      }
+    ]
+  }
+}

.github/actions/build-nextjs/action.yml

@@ -0,0 +1,48 @@
+name: "Build next.js for the harness"
+description: >
+  Checks out vercel/next.js at a ref and builds it, plus the Playwright browser
+  its e2e suite drives. This is the slow thing the harness workflow caches, so it
+  runs on the cache-miss path only - from the `nextjs` job that populates the
+  cache, and from a shard as a fallback if the entry went away mid-run.
+
+inputs:
+  ref:
+    description: "vercel/next.js ref to check out"
+    required: true
+  path:
+    description: "Directory to check out into, relative to the workspace. Must match the cached path."
+    required: false
+    default: nextjs
+
+runs:
+  using: composite
+  steps:
+    - name: Checkout vercel/next.js
+      uses: actions/checkout@v4
+      with:
+        repository: vercel/next.js
+        ref: ${{ inputs.ref }}
+        path: ${{ inputs.path }}
+        fetch-depth: 1
+
+    - name: Install and build next.js
+      working-directory: ${{ inputs.path }}
+      shell: bash
+      # The harness runs out of a next.js checkout: `run-tests.js` and the
+      # `test/lib` helpers are repo files, not published ones. The second
+      # `pnpm install` relinks the workspace against what `pnpm build` just
+      # produced.
+      run: |
+        corepack enable
+        pnpm install
+        pnpm build
+        pnpm install
+
+    - name: Install the Playwright browser
+      working-directory: ${{ inputs.path }}
+      shell: bash
+      # Downloads into ~/.cache/ms-playwright, which the workflow caches
+      # alongside the checkout. Deliberately without `--with-deps`: the system
+      # libraries that installs are apt packages outside any cacheable path, so
+      # the job that actually drives the browser installs those itself.
+      run: pnpm playwright install chromium

.github/actions/run-e2e-tests-on-example/action.yml

@@ -27,6 +27,13 @@ runs:
       run: cd examples/e2e-tests && pnpm install-browser
     - name: Deploy and Run Tests
       shell: bash
+      # Several behaviours are answered by different infrastructure per deployment
+      # type - a top-level `public/` file with a space in its name is a 404 on API
+      # Gateway by design, a repeated slash is collapsed by a CloudFront function
+      # only when the compute is a Lambda - and the tests assert the divergence
+      # rather than skipping it. The example directory *is* the type.
+      env:
+        E2E_NEXTJS_TYPE: ${{ inputs.example_directory }}
       run: |
         cd examples/${{ inputs.example_directory }}
         pnpm run deploy:ci