Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 55 additions & 2 deletions .agents/VERCEL.md

Large diffs are not rendered by default.

7 changes: 5 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,8 @@ src/
│ │ ├── runner.ts # VercelEnvRunner (extends NodeWorkerEnvRunner)
│ │ ├── worker.ts # Sets Vercel request context symbol, delegates to node-worker
│ │ ├── oidc.ts # VERCEL_OIDC_TOKEN check + dev-time warning
│ │ └── queue-dev.ts # Local Vercel Queues delivery bridge (registerDevConsumer)
│ │ ├── queue-dev.ts # Local Vercel Queues delivery bridge (registerDevConsumer)
│ │ └── image.ts # /_vercel/image optimization handler (IPX-based)
│ └── netlify/
│ ├── runner.ts # NetlifyEnvRunner (extends NodeWorkerEnvRunner)
│ └── worker.ts # Sets global Netlify context, delegates to node-worker
Expand Down Expand Up @@ -150,6 +151,7 @@ const runner2 = new NodeProcessEnvRunner({
- `env-runner/runners/miniflare` (`./runners/miniflare`) — Direct import of `MiniflareEnvRunner`
- `env-runner/runners/vercel` (`./runners/vercel`) — Direct import of `VercelEnvRunner`
- `env-runner/runners/vercel/worker` (`./runners/vercel/worker`) — Vercel worker (sets request context, delegates to node-worker)
- `env-runner/runners/vercel/image` (`./runners/vercel/image`) — `createVercelImageHandler()` + `VercelImageConfig`, mountable without a `VercelEnvRunner` (also re-exported from `env-runner`)
- `env-runner/runners/netlify` (`./runners/netlify`) — Direct import of `NetlifyEnvRunner`
- `env-runner/runners/netlify/worker` (`./runners/netlify/worker`) — Netlify worker (sets global Netlify context, delegates to node-worker)
- `env-runner/vite` (`./vite`) — Vite Environment API helpers (`createViteHotChannel`, `createViteTransport`)
Expand Down Expand Up @@ -183,6 +185,7 @@ Generic test infrastructure, cross-runner suites (`runners.test.ts`, `manager.te
- `cjs-module-lexer` / `es-module-lexer` — CJS named-export detection and ESM import-specifier parsing in the miniflare module fallback service (devDependencies inlined into `dist` by obuild)
- `@netlify/runtime` — Netlify compute runtime (optional peer dependency, used by `NetlifyEnvRunner` worker for full `globalThis.Netlify` + `globalThis.caches` setup)
- `wrangler` — Cloudflare Wrangler (optional peer dependency, used by `MiniflareEnvRunner`'s `wrangler` option to load a `wrangler.{json,jsonc,toml}` config via `unstable_readConfig` + `unstable_getMiniflareWorkerOptions`; a built-in minimal plain-JSON reader is used when it's absent)
- `ipx` — Image optimization (optional peer dependency, used by `VercelEnvRunner` for `/_vercel/image` endpoint)

## Reference docs (`.agents/`)

Expand All @@ -191,7 +194,7 @@ Runner-specific and deep-dive notes, split out of this file:
- [`.agents/ARCHITECTURE.md`](.agents/ARCHITECTURE.md) — detailed core source-file notes, the shared `BaseEnvRunner` lifecycle, `RunnerManager`/`EnvServer`
- [`.agents/NODE-RUNNERS.md`](.agents/NODE-RUNNERS.md) — node-worker, node-process, bun-process, deno-process, and self runners (+ orphan tests)
- [`.agents/MINIFLARE.md`](.agents/MINIFLARE.md) — Miniflare internals (`unsafeEvalBinding`, `unsafeModuleFallbackService`, service bindings) **and** the `MiniflareEnvRunner` + wrangler config + tests
- [`.agents/VERCEL.md`](.agents/VERCEL.md) — `VercelEnvRunner` (env vars, header injection, OIDC, Vercel Queues) + tests
- [`.agents/VERCEL.md`](.agents/VERCEL.md) — `VercelEnvRunner` (env vars, header injection, OIDC, Vercel Queues, image optimization) + tests
- [`.agents/NETLIFY.md`](.agents/NETLIFY.md) — `NetlifyEnvRunner` (header injection) + tests
- [`.agents/VIRTUAL-MODULES.md`](.agents/VIRTUAL-MODULES.md) — virtual modules across Node/Bun/Deno/Miniflare + tests
- [`.agents/TESTS.md`](.agents/TESTS.md) — generic test infrastructure, cross-runner suites, shared fixtures
Expand Down
6 changes: 6 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@
"./runners/vercel": "./dist/runners/vercel/runner.mjs",
"./runners/vercel/worker": "./dist/runners/vercel/worker.mjs",
"./runners/vercel/queue-dev": "./dist/runners/vercel/queue-dev.mjs",
"./runners/vercel/image": "./dist/runners/vercel/image.mjs",
"./runners/netlify": "./dist/runners/netlify/runner.mjs",
"./runners/netlify/worker": "./dist/runners/netlify/worker.mjs",
"./vite": "./dist/vite.mjs"
Expand Down Expand Up @@ -59,6 +60,7 @@
"cjs-module-lexer": "^2.2.0",
"env-runner-fixture": "link:",
"es-module-lexer": "^2.2.0",
"ipx": "^4.0.0-beta.1",
"miniflare": "^4.20260625.0",
"obuild": "^0.4.37",
"oxfmt": "^0.56.0",
Expand All @@ -70,6 +72,7 @@
"peerDependencies": {
"@netlify/runtime": "^4.1.23",
"@vercel/queue": ">=0.2.0",
"ipx": "^4.0.0-beta.1",
"miniflare": "^4.20260515.0",
"wrangler": "^4.0.0"
},
Expand All @@ -83,6 +86,9 @@
"@vercel/queue": {
"optional": true
},
"ipx": {
"optional": true
},
"wrangler": {
"optional": true
}
Expand Down
Loading
Loading