env-runner 0.1.7 → 0.1.9

package/dist/_chunks/base-runner.d.mts

@@ -1,8 +1,6 @@
 import { a as RunnerMessageListener, l as WorkerAddress, t as EnvRunner, u as WorkerHooks } from "./types.mjs";
 import { IncomingMessage } from "node:http";
 import { Socket } from "node:net";
-
-//#region src/common/base-runner.d.ts
 interface EnvRunnerData {
   name?: string;
   [key: string]: unknown;
@@ -45,5 +43,4 @@ declare abstract class BaseEnvRunner implements EnvRunner {
   protected abstract _closeRuntime(): Promise<void>;
   protected abstract _runtimeType(): string;
 }
-//#endregion
 export { EnvRunnerData as n, BaseEnvRunner as t };

package/dist/_chunks/base-runner.mjs

@@ -1,6 +1,5 @@
 import { rm } from "node:fs/promises";
 import { proxyFetch, proxyUpgrade } from "httpxy";
-//#region src/common/base-runner.ts
 var BaseEnvRunner = class {
 	closed = false;
 	_name;
@@ -125,5 +124,4 @@ var BaseEnvRunner = class {
 		this._address = void 0;
 	}
 };
-//#endregion
 export { BaseEnvRunner as t };

package/dist/_chunks/libs/cjs-module-lexer.mjs

@@ -1,4 +1,3 @@
-//#region node_modules/.pnpm/cjs-module-lexer@2.2.0/node_modules/cjs-module-lexer/dist/lexer.mjs
 let A;
 const B = 1 === new Uint8Array(new Uint16Array([1]).buffer)[0];
 function parse(E, g = "@") {
@@ -143,5 +142,4 @@ function init() {
 		A = Q;
 	})());
 }
-//#endregion
 export { parse as n, init as t };

package/dist/_chunks/runner.d.mts

@@ -1,7 +1,5 @@
 import { u as WorkerHooks } from "./types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "./base-runner.mjs";
-
-//#region src/runners/deno-process/runner.d.ts
 declare class DenoProcessEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -16,5 +14,4 @@ declare class DenoProcessEnvRunner extends BaseEnvRunner {
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;
 }
-//#endregion
 export { DenoProcessEnvRunner as t };

package/dist/_chunks/runner.mjs

@@ -2,7 +2,6 @@ import { t as BaseEnvRunner } from "./base-runner.mjs";
 import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
-//#region src/runners/deno-process/runner.ts
 let _defaultEntry;
 var DenoProcessEnvRunner = class extends BaseEnvRunner {
 	#process;
@@ -95,5 +94,4 @@ var DenoProcessEnvRunner = class extends BaseEnvRunner {
 		this.#process = handle;
 	}
 };
-//#endregion
 export { DenoProcessEnvRunner as t };

package/dist/_chunks/runner2.d.mts

@@ -2,8 +2,6 @@ import { u as WorkerHooks } from "./types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "./base-runner.mjs";
 import { IncomingMessage } from "node:http";
 import { Socket } from "node:net";
-
-//#region src/runners/miniflare/runner.d.ts
 /** Result from a module transform (compatible with Vite's `TransformResult`). */
 interface TransformResult {
   code: string;
@@ -83,5 +81,4 @@ declare class MiniflareEnvRunner extends BaseEnvRunner {
     };
   }): Promise<void>;
 }
-//#endregion
 export { TransformResult as i, MiniflareEnvRunnerOptions as n, MiniflareExportInfo as r, MiniflareEnvRunner as t };

package/dist/_chunks/runner2.mjs

@@ -6,26 +6,8 @@ import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { basename, dirname, resolve } from "node:path";
 import { resolveModulePath } from "exsolve";
-//#region src/runners/miniflare/wrapper.ts
-const IPC_PATH$1 = "/__env_runner_ipc";
-/** Service binding name used for cross-request IPC (worker → runner). */
+const IPC_PATH = "/__env_runner_ipc";
 const IPC_BINDING = "__ENV_RUNNER_IPC";
-/**
-* Generates a wrapper module that imports the user entry and adds IPC glue.
-*
-* The user module is expected to export `fetch` and optionally `ipc`.
-* The wrapper uses a persistent WebSocket pair for bidirectional IPC:
-* - Init: `fetch` with `upgrade: websocket` creates a WebSocketPair
-* - Messages: JSON over the WebSocket (no per-message `dispatchFetch`)
-* - Reload: `{ type: "reload" }` triggers cache-busted re-import
-* - Shutdown: `{ type: "shutdown" }` calls `ipc.onClose()`
-*
-* For outgoing messages during fetch request handling, uses a service binding
-* (`__ENV_RUNNER_IPC`) to avoid workerd's cross-request I/O restriction on
-* the WebSocket object.
-*
-* Passed as an in-memory `script` to Miniflare (no temp files needed).
-*/
 function generateWrapper(entryPath, opts) {
 	const staticReExport = opts?.dynamicOnly ? "" : `export * from ${JSON.stringify(entryPath)};`;
 	const explicitExports = opts?.dynamicOnly && opts.exports?.length ? opts.exports.map((name) => `export { ${name} } from ${JSON.stringify(entryPath)};`).join("\n") : "";
@@ -48,7 +30,7 @@ if (!globalThis.process) { globalThis.process = __process; }
 ${staticReExport}
 ${explicitExports}
 
-const __IPC_PATH = "${IPC_PATH$1}";
+const __IPC_PATH = "${IPC_PATH}";
 const __IPC_BINDING = "${IPC_BINDING}";
 const __entryPath = ${JSON.stringify(entryPath)};
 let __userEntry;
@@ -194,9 +176,6 @@ export default {
 };
 `;
 }
-//#endregion
-//#region src/runners/miniflare/runner.ts
-const IPC_PATH = "/__env_runner_ipc";
 const _miniflareCache = /* @__PURE__ */ new Map();
 var MiniflareEnvRunner = class extends BaseEnvRunner {
 	#miniflare;
@@ -222,13 +201,11 @@ var MiniflareEnvRunner = class extends BaseEnvRunner {
 		this.#exportConditions = opts.exportConditions ?? ["workerd", "worker"];
 		this.#init();
 	}
-	/** Dispose all persistent Miniflare instances from the cache. */
 	static async disposeAll() {
 		const entries = [..._miniflareCache.values()];
 		_miniflareCache.clear();
 		for (const entry of entries) await entry.mf.dispose().catch(() => {});
 	}
-	/** Fully dispose the Miniflare instance (even if persistent). */
 	async dispose() {
 		if (this.#miniflare) {
 			if (this.#ws) {
@@ -267,13 +244,6 @@ var MiniflareEnvRunner = class extends BaseEnvRunner {
 			data: message
 		}));
 	}
-	/**
-	* Hot-reload the user entry module without recreating the Miniflare instance.
-	*
-	* Sends `reload-module` event over the WebSocket. The worker wrapper uses
-	* `unsafeEvalBinding` to re-import the entry with a cache-busting query string
-	* and responds with `module-reloaded` when done.
-	*/
 	async reloadModule(timeout = 5e3) {
 		if (!this.#ws) throw new Error("Miniflare env runner should be initialized before reloading.");
 		if (!this._data?.entry) return;
@@ -513,7 +483,7 @@ var MiniflareEnvRunner = class extends BaseEnvRunner {
 				refCount: 1
 			});
 		}
-		const initRes = await this.#miniflare.dispatchFetch("http://localhost" + IPC_PATH, { headers: { upgrade: "websocket" } });
+		const initRes = await this.#miniflare.dispatchFetch("http://localhost/__env_runner_ipc", { headers: { upgrade: "websocket" } });
 		const ws = initRes.webSocket;
 		if (!ws) {
 			const body = await initRes.text().catch(() => "");
@@ -533,10 +503,6 @@ var MiniflareEnvRunner = class extends BaseEnvRunner {
 		} });
 	}
 };
-/**
-* Detect `export class` declarations in the entry file.
-* Merges with explicitly declared exports from options.
-*/
 function detectExportedClasses(entryPath, explicit) {
 	const names = new Set(Object.keys(explicit));
 	try {
@@ -547,11 +513,9 @@ function detectExportedClasses(entryPath, explicit) {
 	} catch {}
 	return [...names];
 }
-/** Convert PascalCase/camelCase to SCREAMING_SNAKE_CASE (e.g. `Counter` → `COUNTER`, `MyDurableObject` → `MY_DURABLE_OBJECT`). */
 function toScreamingSnakeCase(name) {
 	return name.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase();
 }
-/** Compute a stable cache key for persistent Miniflare instances. */
 function computeCacheKey(entryPath, opts) {
 	const serializableOpts = {};
 	for (const [k, v] of Object.entries(opts)) if (typeof v !== "function") serializableOpts[k] = v;
@@ -572,5 +536,4 @@ function createCjsEsmShim(cjsSpecifier, contents) {
 	for (const name of namedExports) shim += `export var ${name} = __cjs_mod__["${name}"];\n`;
 	return shim;
 }
-//#endregion
 export { MiniflareEnvRunner as t };

package/dist/_chunks/runner3.d.mts

@@ -1,7 +1,5 @@
 import { u as WorkerHooks } from "./types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "./base-runner.mjs";
-
-//#region src/runners/node-worker/runner.d.ts
 declare class NodeWorkerEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -15,5 +13,4 @@ declare class NodeWorkerEnvRunner extends BaseEnvRunner {
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;
 }
-//#endregion
 export { NodeWorkerEnvRunner as t };

package/dist/_chunks/runner3.mjs

@@ -2,7 +2,6 @@ import { t as BaseEnvRunner } from "./base-runner.mjs";
 import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { Worker } from "node:worker_threads";
-//#region src/runners/node-worker/runner.ts
 let _defaultEntry;
 var NodeWorkerEnvRunner = class extends BaseEnvRunner {
 	#worker;
@@ -58,5 +57,4 @@ var NodeWorkerEnvRunner = class extends BaseEnvRunner {
 		this.#worker = worker;
 	}
 };
-//#endregion
 export { NodeWorkerEnvRunner as t };

package/dist/_chunks/runner4.d.mts

@@ -1,8 +1,6 @@
 import { u as WorkerHooks } from "./types.mjs";
 import { n as EnvRunnerData } from "./base-runner.mjs";
 import { t as NodeWorkerEnvRunner } from "./runner3.mjs";
-
-//#region src/runners/vercel/runner.d.ts
 declare class VercelEnvRunner extends NodeWorkerEnvRunner {
   constructor(opts: {
     name: string;
@@ -13,5 +11,4 @@ declare class VercelEnvRunner extends NodeWorkerEnvRunner {
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
   protected _runtimeType(): string;
 }
-//#endregion
 export { VercelEnvRunner as t };

package/dist/_chunks/runner4.mjs

@@ -1,7 +1,51 @@
 import { t as NodeWorkerEnvRunner } from "./runner3.mjs";
 import { fileURLToPath } from "node:url";
-//#region src/runners/vercel/runner.ts
+import { randomBytes } from "node:crypto";
+let _warned = false;
+function warnIfVercelOidcTokenInvalid(token) {
+	const result = _checkVercelOidcToken(token);
+	if (_warned) return result;
+	if (result.status === "missing") {
+		_warned = true;
+		console.warn(`\x1B[90m[env-runner]\x1B[39m \x1B[33mVERCEL_OIDC_TOKEN\x1B[39m is not set. Run \x1B[36mvercel env pull\x1B[39m to pull the latest environment variables.`);
+	} else if (result.status === "expired") {
+		_warned = true;
+		console.warn(`\x1B[90m[env-runner]\x1B[39m \x1B[33mVERCEL_OIDC_TOKEN\x1B[39m expired at ${result.expiresAt.toISOString()}. Run \x1B[36mvercel env pull\x1B[39m to pull a fresh OIDC token.`);
+	} else if (result.status === "invalid") {
+		_warned = true;
+		console.warn(`\x1B[90m[env-runner]\x1B[39m \x1B[33mVERCEL_OIDC_TOKEN\x1B[39m is malformed (not a valid JWT). Run \x1B[36mvercel env pull\x1B[39m to pull a valid OIDC token.`);
+	}
+	return result;
+}
+function _checkVercelOidcToken(token = process.env.VERCEL_OIDC_TOKEN) {
+	if (!token) return { status: "missing" };
+	const parts = token.split(".");
+	if (parts.length !== 3) return { status: "invalid" };
+	let payload;
+	try {
+		const json = Buffer.from(parts[1], "base64url").toString("utf8");
+		payload = JSON.parse(json);
+	} catch {
+		return { status: "invalid" };
+	}
+	if (!payload || typeof payload !== "object") return { status: "invalid" };
+	const exp = payload.exp;
+	if (typeof exp !== "number" || !Number.isFinite(exp)) return { status: "invalid" };
+	const expiresAt = /* @__PURE__ */ new Date(exp * 1e3);
+	if (expiresAt.getTime() <= Date.now()) return {
+		status: "expired",
+		expiresAt
+	};
+	return {
+		status: "valid",
+		expiresAt
+	};
+}
 let _defaultEntry;
+const _podId = Math.random().toString(32).slice(-5);
+function generateVercelId() {
+	return `dev1::${_podId}-${Date.now().toString(36)}-${randomBytes(6).toString("hex")}`;
+}
 var VercelEnvRunner = class extends NodeWorkerEnvRunner {
 	constructor(opts) {
 		_defaultEntry ||= fileURLToPath(import.meta.resolve("env-runner/runners/vercel/worker"));
@@ -9,13 +53,16 @@ var VercelEnvRunner = class extends NodeWorkerEnvRunner {
 			...opts,
 			workerEntry: opts.workerEntry || _defaultEntry
 		});
+		warnIfVercelOidcTokenInvalid();
 	}
 	async fetch(input, init) {
 		const headers = new Headers(input instanceof Request ? input.headers : init?.headers);
+		const requestId = generateVercelId();
 		if (this._address && this._address.port != null && !headers.has("x-vercel-deployment-url")) {
 			const host = this._address.host || "127.0.0.1";
 			headers.set("x-vercel-deployment-url", `http://${host}:${this._address.port}`);
 		}
+		if (!headers.has("x-vercel-id")) headers.set("x-vercel-id", requestId);
 		const clientIp = headers.get("x-forwarded-for")?.split(",")[0]?.trim() || headers.get("x-real-ip") || "127.0.0.1";
 		if (!headers.has("x-vercel-forwarded-for")) headers.set("x-vercel-forwarded-for", clientIp);
 		if (!headers.has("x-forwarded-for")) headers.set("x-forwarded-for", clientIp);
@@ -25,18 +72,22 @@ var VercelEnvRunner = class extends NodeWorkerEnvRunner {
 			if (!headers.has("x-forwarded-proto")) headers.set("x-forwarded-proto", url.protocol.replace(":", ""));
 			if (!headers.has("x-forwarded-host")) headers.set("x-forwarded-host", headers.get("host") || url.host);
 		} catch {}
-		if (input instanceof Request) return super.fetch(new Request(input, {
-			...init,
-			headers
-		}));
-		return super.fetch(input, {
+		const res = await super.fetch(input, {
 			...init,
 			headers
 		});
+		const resHeaders = new Headers(res.headers);
+		if (!resHeaders.has("server")) resHeaders.set("server", "Vercel");
+		if (!resHeaders.has("x-vercel-id")) resHeaders.set("x-vercel-id", requestId);
+		if (!resHeaders.has("x-vercel-cache")) resHeaders.set("x-vercel-cache", "MISS");
+		return new Response(res.body, {
+			status: res.status,
+			statusText: res.statusText,
+			headers: resHeaders
+		});
 	}
 	_runtimeType() {
 		return "vercel";
 	}
 };
-//#endregion
 export { VercelEnvRunner as t };

package/dist/_chunks/runner5.d.mts

@@ -1,8 +1,6 @@
 import { u as WorkerHooks } from "./types.mjs";
 import { n as EnvRunnerData } from "./base-runner.mjs";
 import { t as NodeWorkerEnvRunner } from "./runner3.mjs";
-
-//#region src/runners/netlify/runner.d.ts
 declare class NetlifyEnvRunner extends NodeWorkerEnvRunner {
   constructor(opts: {
     name: string;
@@ -13,5 +11,4 @@ declare class NetlifyEnvRunner extends NodeWorkerEnvRunner {
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
   protected _runtimeType(): string;
 }
-//#endregion
 export { NetlifyEnvRunner as t };

package/dist/_chunks/runner5.mjs

@@ -1,6 +1,5 @@
 import { t as NodeWorkerEnvRunner } from "./runner3.mjs";
 import { fileURLToPath } from "node:url";
-//#region src/runners/netlify/runner.ts
 let _defaultEntry;
 var NetlifyEnvRunner = class extends NodeWorkerEnvRunner {
 	constructor(opts) {
@@ -43,5 +42,4 @@ var NetlifyEnvRunner = class extends NodeWorkerEnvRunner {
 		return "netlify";
 	}
 };
-//#endregion
 export { NetlifyEnvRunner as t };

package/dist/_chunks/server.mjs

@@ -1,9 +1,4 @@
 import { watch } from "node:fs";
-//#region src/manager.ts
-/**
-* Manages an active `EnvRunner` instance, proxying all calls to it.
-* Supports hot-reload, auto-restart on unexpected exit, and message queueing.
-*/
 var RunnerManager = class {
 	_runner;
 	_messageQueue = [];
@@ -21,7 +16,6 @@ var RunnerManager = class {
 	get closed() {
 		return this._closed;
 	}
-	/** Replace the active runner with a new one. Closes the previous runner. */
 	async reload(runner) {
 		this._reloading = true;
 		const prev = this._runner;
@@ -167,8 +161,6 @@ var RunnerManager = class {
 		for (const msg of queue) this._runner.sendMessage(msg);
 	}
 };
-//#endregion
-//#region src/loader.ts
 const loaders = {
 	"node-worker": () => import("env-runner/runners/node-worker").then((m) => m.NodeWorkerEnvRunner),
 	"node-process": () => import("env-runner/runners/node-process").then((m) => m.NodeProcessEnvRunner),
@@ -182,19 +174,15 @@ const loaders = {
 async function loadRunner(runner, opts) {
 	return new (await (loaders[runner]()))(opts);
 }
-//#endregion
-//#region src/server.ts
 var EnvServer = class extends RunnerManager {
 	_opts;
 	_watchers = [];
 	_reloadTimeout;
 	_reloadListeners = /* @__PURE__ */ new Set();
 	runner = null;
-	/** Register a listener called when the runner is reloaded due to a file change. */
 	onReload(listener) {
 		this._reloadListeners.add(listener);
 	}
-	/** Remove a previously registered reload listener. */
 	offReload(listener) {
 		this._reloadListeners.delete(listener);
 	}
@@ -202,7 +190,6 @@ var EnvServer = class extends RunnerManager {
 		super();
 		this._opts = opts;
 	}
-	/** Start the server by loading and attaching the runner. */
 	async start() {
 		this.runner = await this._createRunner();
 		await this.reload(this.runner);
@@ -251,5 +238,4 @@ var EnvServer = class extends RunnerManager {
 		}, 100);
 	}
 };
-//#endregion
 export { loadRunner as n, RunnerManager as r, EnvServer as t };

package/dist/_chunks/types.d.mts

@@ -1,7 +1,5 @@
 import { IncomingMessage } from "node:http";
 import { Socket } from "node:net";
-
-//#region src/types.d.ts
 /** Handler for proxying HTTP requests to the worker. */
 type FetchHandler = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 /** Callback for receiving messages from the worker. */
@@ -72,5 +70,4 @@ interface EnvRunner extends RunnerRPCHooks {
   /** Gracefully shut down the worker. */
   close(): Promise<void>;
 }
-//#endregion
 export { RunnerMessageListener as a, UpgradeHandler as c, RPCOptions as i, WorkerAddress as l, FetchHandler as n, RunnerRPCHooks as o, NodeUpgradeContext as r, UpgradeContext as s, EnvRunner as t, WorkerHooks as u };

package/dist/_chunks/worker-utils.mjs

@@ -1,7 +1,6 @@
 import { readFileSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 import { isAbsolute } from "node:path";
-//#region src/common/worker-utils.ts
 async function resolveEntry(entryPath) {
 	const mod = await import(_toImportPath(entryPath));
 	const entry = mod.default || mod;
@@ -15,10 +14,6 @@ function parseServerAddress(server) {
 		port: Number(url.port)
 	};
 }
-/**
-* Re-import the user entry module with cache busting.
-* Tears down old IPC hooks and re-initializes new ones.
-*/
 async function reloadEntryModule(entryPath, currentEntry, sendMessage) {
 	await currentEntry.ipc?.onClose?.();
 	const newEntry = await _importFresh(entryPath);
@@ -39,5 +34,4 @@ async function _importFresh(entryPath) {
 	if (typeof entry.fetch !== "function") throw new Error(`[env-runner] Entry module "${entryPath}" must export a \`fetch\` handler (export default { fetch(req) { ... } }).`);
 	return entry;
 }
-//#endregion
 export { reloadEntryModule as n, resolveEntry as r, parseServerAddress as t };

package/dist/cli.mjs

@@ -2,7 +2,6 @@ import { t as EnvServer } from "./_chunks/server.mjs";
 import { resolve } from "node:path";
 import { serve } from "srvx";
 import { parseArgs } from "node:util";
-//#region src/cli.ts
 const { values, positionals } = parseArgs({
 	allowPositionals: true,
 	options: {
@@ -67,5 +66,4 @@ for (const signal of ["SIGINT", "SIGTERM"]) process.once(signal, async () => {
 	await server.close();
 	process.exit(0);
 });
-//#endregion
 export {};

package/dist/index.d.mts

@@ -6,8 +6,6 @@ import { t as VercelEnvRunner } from "./_chunks/runner4.mjs";
 import { t as NetlifyEnvRunner } from "./_chunks/runner5.mjs";
 import { ServerOptions } from "srvx";
 import { Hooks } from "crossws";
-
-//#region src/manager.d.ts
 /**
  * Manages an active `EnvRunner` instance, proxying all calls to it.
  * Supports hot-reload, auto-restart on unexpected exit, and message queueing.
@@ -46,8 +44,6 @@ declare class RunnerManager implements EnvRunner {
   private _waitForRunner;
   private _flushQueue;
 }
-//#endregion
-//#region src/loader.d.ts
 type RunnerName = "node-worker" | "node-process" | "bun-process" | "deno-process" | "self" | "miniflare" | "vercel" | "netlify";
 interface LoadRunnerOptions {
   name: string;
@@ -59,8 +55,6 @@ interface LoadRunnerOptions {
   [key: string]: unknown;
 }
 declare function loadRunner(runner: RunnerName, opts: LoadRunnerOptions): Promise<EnvRunner>;
-//#endregion
-//#region src/server.d.ts
 interface EnvServerOptions {
   /** Runner implementation to use. */
   runner: RunnerName;
@@ -98,8 +92,6 @@ declare class EnvServer extends RunnerManager {
   private _stopWatching;
   private _scheduleReload;
 }
-//#endregion
-//#region src/common/worker-utils.d.ts
 interface AppEntryIPCContext {
   sendMessage: (message: unknown) => void;
 }
@@ -116,5 +108,4 @@ interface AppEntry {
   plugins?: ServerOptions["plugins"];
   ipc?: AppEntryIPC;
 }
-//#endregion
 export { type AppEntry, type AppEntryIPC, type AppEntryIPCContext, BaseEnvRunner, DenoProcessEnvRunner, type EnvRunnerData as DenoProcessEnvRunnerData, type EnvRunnerData, type EnvRunner, EnvServer, type EnvServerOptions, type FetchHandler, type LoadRunnerOptions, MiniflareEnvRunner, type MiniflareEnvRunnerOptions, type MiniflareExportInfo, NetlifyEnvRunner, type NodeUpgradeContext, type RPCOptions, RunnerManager, type RunnerMessageListener, type RunnerName, type RunnerRPCHooks, type TransformResult, type UpgradeContext, type UpgradeHandler, VercelEnvRunner, type WorkerAddress, type WorkerHooks, loadRunner };

package/dist/runners/bun-process/runner.d.mts

@@ -1,7 +1,5 @@
 import { u as WorkerHooks } from "../../_chunks/types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "../../_chunks/base-runner.mjs";
-
-//#region src/runners/bun-process/runner.d.ts
 declare class BunProcessEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -16,5 +14,4 @@ declare class BunProcessEnvRunner extends BaseEnvRunner {
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;
 }
-//#endregion
 export { BunProcessEnvRunner, type EnvRunnerData as BunProcessEnvRunnerData };

package/dist/runners/bun-process/runner.mjs

@@ -4,7 +4,6 @@ import { execSync, spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
 import { homedir } from "node:os";
-//#region src/runners/bun-process/runner.ts
 let _defaultEntry;
 let _bunPath;
 const _isBun = typeof Bun !== "undefined";
@@ -126,5 +125,4 @@ var BunProcessEnvRunner = class extends BaseEnvRunner {
 		this.#process = handle;
 	}
 };
-//#endregion
 export { BunProcessEnvRunner };

package/dist/runners/bun-process/worker.mjs

@@ -1,7 +1,6 @@
 import { n as reloadEntryModule, r as resolveEntry, t as parseServerAddress } from "../../_chunks/worker-utils.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
-//#region src/runners/bun-process/worker.ts
 const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
 let entry = await resolveEntry(data.entry);
 const sendMessage = (message) => process.send(message);
@@ -52,5 +51,4 @@ process.on("message", async (message) => {
 	}
 	entry.ipc?.onMessage?.(message);
 });
-//#endregion
 export {};

package/dist/runners/deno-process/runner.d.mts

@@ -1,3 +1,3 @@
 import { n as EnvRunnerData } from "../../_chunks/base-runner.mjs";
 import { t as DenoProcessEnvRunner } from "../../_chunks/runner.mjs";
-export { DenoProcessEnvRunner, EnvRunnerData as DenoProcessEnvRunnerData };
+export { DenoProcessEnvRunner, type EnvRunnerData as DenoProcessEnvRunnerData };

package/dist/runners/deno-process/worker.mjs

@@ -1,7 +1,6 @@
 import { n as reloadEntryModule, r as resolveEntry, t as parseServerAddress } from "../../_chunks/worker-utils.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
-//#region src/runners/deno-process/worker.ts
 const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
 let entry = await resolveEntry(data.entry);
 const _stdout = globalThis.Deno?.stdout ? { write: (s) => globalThis.Deno.stdout.writeSync(new TextEncoder().encode(s)) } : process.stdout;
@@ -75,5 +74,4 @@ async function handleMessage(message) {
 	entry.ipc?.onMessage?.(message);
 }
 readMessages().catch(() => {});
-//#endregion
 export {};

package/dist/runners/miniflare/runner.d.mts

@@ -1,3 +1,3 @@
 import { n as EnvRunnerData } from "../../_chunks/base-runner.mjs";
 import { i as TransformResult, n as MiniflareEnvRunnerOptions, r as MiniflareExportInfo, t as MiniflareEnvRunner } from "../../_chunks/runner2.mjs";
-export { MiniflareEnvRunner, EnvRunnerData as MiniflareEnvRunnerData, MiniflareEnvRunnerOptions, MiniflareExportInfo, TransformResult };
+export { MiniflareEnvRunner, type EnvRunnerData as MiniflareEnvRunnerData, MiniflareEnvRunnerOptions, MiniflareExportInfo, TransformResult };

package/dist/runners/netlify/runner.d.mts

@@ -1,3 +1,3 @@
 import { n as EnvRunnerData } from "../../_chunks/base-runner.mjs";
 import { t as NetlifyEnvRunner } from "../../_chunks/runner5.mjs";
-export { EnvRunnerData, NetlifyEnvRunner };
+export { type EnvRunnerData, NetlifyEnvRunner };

package/dist/runners/netlify/worker.mjs

@@ -1,4 +1,3 @@
-//#region src/runners/netlify/worker.ts
 try {
 	const { startRuntime } = await import("@netlify/runtime");
 	startRuntime({
@@ -39,5 +38,4 @@ try {
 	};
 }
 await import("../node-worker/worker.mjs");
-//#endregion
 export {};

package/dist/runners/node-process/runner.d.mts

@@ -1,7 +1,5 @@
 import { u as WorkerHooks } from "../../_chunks/types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "../../_chunks/base-runner.mjs";
-
-//#region src/runners/node-process/runner.d.ts
 declare class NodeProcessEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -16,5 +14,4 @@ declare class NodeProcessEnvRunner extends BaseEnvRunner {
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;
 }
-//#endregion
 export { NodeProcessEnvRunner, type EnvRunnerData as ProcessEnvRunnerData };

package/dist/runners/node-process/runner.mjs

@@ -2,7 +2,6 @@ import { t as BaseEnvRunner } from "../../_chunks/base-runner.mjs";
 import { existsSync } from "node:fs";
 import { fork } from "node:child_process";
 import { fileURLToPath } from "node:url";
-//#region src/runners/node-process/runner.ts
 let _defaultEntry;
 var NodeProcessEnvRunner = class extends BaseEnvRunner {
 	#process;
@@ -63,5 +62,4 @@ var NodeProcessEnvRunner = class extends BaseEnvRunner {
 		this.#process = child;
 	}
 };
-//#endregion
 export { NodeProcessEnvRunner };

package/dist/runners/node-process/worker.mjs

@@ -1,7 +1,6 @@
 import { n as reloadEntryModule, r as resolveEntry, t as parseServerAddress } from "../../_chunks/worker-utils.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server/node";
-//#region src/runners/node-process/worker.ts
 const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
 let entry = await resolveEntry(data.entry);
 const sendMessage = (message) => process.send(message);
@@ -52,5 +51,4 @@ process.on("message", async (message) => {
 	}
 	entry.ipc?.onMessage?.(message);
 });
-//#endregion
 export {};

package/dist/runners/node-worker/runner.d.mts

@@ -1,3 +1,3 @@
 import { n as EnvRunnerData } from "../../_chunks/base-runner.mjs";
 import { t as NodeWorkerEnvRunner } from "../../_chunks/runner3.mjs";
-export { EnvRunnerData, NodeWorkerEnvRunner };
+export { type EnvRunnerData, NodeWorkerEnvRunner };

package/dist/runners/node-worker/worker.mjs

@@ -2,7 +2,6 @@ import { n as reloadEntryModule, r as resolveEntry, t as parseServerAddress } fr
 import { parentPort, workerData } from "node:worker_threads";
 import { serve } from "srvx";
 import { plugin } from "crossws/server/node";
-//#region src/runners/node-worker/worker.ts
 const data = workerData || {};
 let entry = await resolveEntry(data.entry);
 const sendMessage = (message) => parentPort?.postMessage(message);
@@ -53,5 +52,4 @@ parentPort?.on("message", async (message) => {
 	}
 	entry.ipc?.onMessage?.(message);
 });
-//#endregion
 export {};

package/dist/runners/self/runner.d.mts

@@ -1,9 +1,5 @@
 import { u as WorkerHooks } from "../../_chunks/types.mjs";
 import { n as EnvRunnerData, t as BaseEnvRunner } from "../../_chunks/base-runner.mjs";
-import * as node_http0 from "node:http";
-import * as node_net0 from "node:net";
-
-//#region src/runners/self/runner.d.ts
 declare class SelfEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -14,8 +10,8 @@ declare class SelfEnvRunner extends BaseEnvRunner {
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
   upgrade(context: {
     node: {
-      req: node_http0.IncomingMessage;
-      socket: node_net0.Socket;
+      req: import("node:http").IncomingMessage;
+      socket: import("node:net").Socket;
       head: any;
     };
   }): Promise<void>;
@@ -25,5 +21,4 @@ declare class SelfEnvRunner extends BaseEnvRunner {
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;
 }
-//#endregion
 export { SelfEnvRunner, type EnvRunnerData as SelfEnvRunnerData };

package/dist/runners/self/runner.mjs

@@ -1,6 +1,5 @@
 import { t as BaseEnvRunner } from "../../_chunks/base-runner.mjs";
 import { n as reloadEntryModule, r as resolveEntry } from "../../_chunks/worker-utils.mjs";
-//#region src/runners/self/runner.ts
 var SelfEnvRunner = class extends BaseEnvRunner {
 	#active = false;
 	#entry;
@@ -89,5 +88,4 @@ var SelfEnvRunner = class extends BaseEnvRunner {
 		});
 	}
 };
-//#endregion
 export { SelfEnvRunner };

package/dist/runners/vercel/queue-dev.d.mts

@@ -0,0 +1,44 @@
+import { MessageHandler, RetryHandler } from "@vercel/queue";
+interface VercelQueueDevConsumer {
+  /** Topic name. Wildcard patterns (e.g. `"user-*"`) are supported. */
+  topic: string;
+  /** Function invoked with each delivered message. */
+  handler: MessageHandler;
+  /**
+   * Logical consumer identifier. Re-registering with the same group on the same
+   * topic replaces the previous handler (HMR-safe). Use distinct groups to fan
+   * a topic out to multiple coexisting handlers.
+   *
+   * @default "env-runner-vercel-dev"
+   */
+  consumerGroup?: string;
+  /**
+   * Lock duration for in-flight messages. Forwarded to the SDK's
+   * `coreHandleCallback`.
+   */
+  visibilityTimeoutSeconds?: number;
+  /**
+   * Convenience: rescheduled re-delivery delay applied when the handler throws.
+   * Equivalent to `retry: () => ({ afterSeconds })`. Ignored if `retry` is set.
+   */
+  retryAfterSeconds?: number;
+  /**
+   * Full retry handler. Receives the thrown error and message metadata; return
+   * `{ afterSeconds }` to reschedule, `{ acknowledge: true }` to drop, or
+   * `undefined` to let the error propagate.
+   */
+  retry?: RetryHandler;
+}
+/**
+ * Bind a handler to a topic. Resolves to an unregister function.
+ *
+ * The first call across the worker process lazily loads `@vercel/queue` and
+ * constructs a shared `QueueClient`. Re-registering with the same topic
+ * replaces the handler (HMR-safe; the SDK keys consumers by `consumerGroup`,
+ * so calling unregister on a replaced registration is a no-op).
+ *
+ * If `@vercel/queue` is not installed or does not expose `registerDevConsumer`,
+ * resolves to a no-op unregister and logs a one-time warning.
+ */
+declare function registerVercelQueueConsumer(consumer: VercelQueueDevConsumer): Promise<() => void>;
+export { VercelQueueDevConsumer, registerVercelQueueConsumer };

package/dist/runners/vercel/queue-dev.mjs

@@ -0,0 +1,36 @@
+const DEFAULT_CONSUMER_GROUP = "env-runner-vercel-dev";
+let sdkPromise;
+let client;
+const noop = () => {};
+async function registerVercelQueueConsumer(consumer) {
+	const sdk = await ensureSdk();
+	if (!sdk || !client) return noop;
+	return sdk.registerDevConsumer({
+		topic: consumer.topic,
+		client,
+		handler: consumer.handler,
+		consumerGroup: consumer.consumerGroup ?? DEFAULT_CONSUMER_GROUP,
+		visibilityTimeoutSeconds: consumer.visibilityTimeoutSeconds,
+		retry: consumer.retry ?? (consumer.retryAfterSeconds === void 0 ? void 0 : () => ({ afterSeconds: consumer.retryAfterSeconds }))
+	});
+}
+function ensureSdk() {
+	if (sdkPromise) return sdkPromise;
+	sdkPromise = (async () => {
+		let mod;
+		try {
+			mod = await import("@vercel/queue");
+		} catch {
+			console.warn("[env-runner:vercel-queue] `@vercel/queue` is not installed. Local queue delivery is disabled.");
+			return null;
+		}
+		if (typeof mod.registerDevConsumer !== "function") {
+			console.warn("[env-runner:vercel-queue] Installed `@vercel/queue` does not export `registerDevConsumer`. Upgrade @vercel/queue@^0.2.0 to enable local queue delivery.");
+			return null;
+		}
+		client = new mod.QueueClient();
+		return mod;
+	})();
+	return sdkPromise;
+}
+export { registerVercelQueueConsumer };

package/dist/runners/vercel/runner.d.mts

@@ -1,3 +1,3 @@
 import { n as EnvRunnerData } from "../../_chunks/base-runner.mjs";
 import { t as VercelEnvRunner } from "../../_chunks/runner4.mjs";
-export { EnvRunnerData, VercelEnvRunner };
+export { type EnvRunnerData, VercelEnvRunner };

package/dist/runners/vercel/worker.mjs

@@ -1,4 +1,6 @@
-//#region src/runners/vercel/worker.ts
+process.env.VERCEL = process.env.VERCEL || "1";
+process.env.VERCEL_ENV = process.env.VERCEL_ENV || "development";
+process.env.NODE_ENV = process.env.NODE_ENV || "development";
 const SYMBOL_FOR_REQ_CONTEXT = Symbol.for("@vercel/request-context");
 const waitUntilPromises = /* @__PURE__ */ new Set();
 const cacheStore = /* @__PURE__ */ new Map();
@@ -46,5 +48,4 @@ globalThis[SYMBOL_FOR_REQ_CONTEXT] = { get: () => ({
 	}
 }) };
 await import("../node-worker/worker.mjs");
-//#endregion
 export {};

package/dist/vite.d.mts

@@ -1,6 +1,4 @@
 import { o as RunnerRPCHooks } from "./_chunks/types.mjs";
-
-//#region src/vite.d.ts
 /** Vite HotChannel-compatible interface (avoids hard dependency on vite types). */
 interface ViteHotChannel {
   send: (data: any) => void;
@@ -28,5 +26,4 @@ declare function createViteHotChannel(hooks: RunnerRPCHooks, envName: string): V
  * Filters messages by `envName` so multiple Vite environments can share one IPC channel.
  */
 declare function createViteTransport(sendMessage: (data: any) => void, onMessage: (listener: (value: any) => void) => void, envName: string): ViteTransport;
-//#endregion
 export { ViteHotChannel, ViteTransport, createViteHotChannel, createViteTransport };

package/dist/vite.mjs

@@ -1,10 +1,3 @@
-//#region src/vite.ts
-/**
-* Create a Vite `HotChannel` from an env-runner's RPC hooks.
-*
-* Use on the **host side** to bridge env-runner IPC → Vite's DevEnvironment transport.
-* Messages are namespaced by `envName` so multiple Vite environments can share one runner.
-*/
 function createViteHotChannel(hooks, envName) {
 	const listeners = /* @__PURE__ */ new WeakMap();
 	return {
@@ -33,12 +26,6 @@ function createViteHotChannel(hooks, envName) {
 		}
 	};
 }
-/**
-* Create a Vite `ModuleRunner` transport from worker-side IPC primitives.
-*
-* Use on the **worker side** to bridge worker IPC → Vite's `ModuleRunner` transport.
-* Filters messages by `envName` so multiple Vite environments can share one IPC channel.
-*/
 function createViteTransport(sendMessage, onMessage, envName) {
 	return {
 		connect({ onMessage: onRunnerMessage }) {
@@ -54,5 +41,4 @@ function createViteTransport(sendMessage, onMessage, envName) {
 		}
 	};
 }
-//#endregion
 export { createViteHotChannel, createViteTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "env-runner",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Generic environment runner for JavaScript runtimes.",
   "license": "MIT",
   "repository": "unjs/env-runner",
@@ -26,6 +26,7 @@
     "./runners/miniflare": "./dist/runners/miniflare/runner.mjs",
     "./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/netlify": "./dist/runners/netlify/runner.mjs",
     "./runners/netlify/worker": "./dist/runners/netlify/worker.mjs",
     "./vite": "./dist/vite.mjs"
@@ -42,30 +43,32 @@
     "typecheck": "tsgo --noEmit --skipLibCheck"
   },
   "dependencies": {
-    "crossws": "^0.4.4",
+    "crossws": "^0.4.5",
     "exsolve": "^1.0.8",
-    "httpxy": "^0.5.0",
-    "srvx": "^0.11.13"
+    "httpxy": "^0.5.3",
+    "srvx": "^0.11.15"
   },
   "devDependencies": {
-    "@netlify/runtime": "^4.1.20",
-    "@types/node": "^25.5.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260327.2",
-    "@vitest/coverage-v8": "^4.1.2",
+    "@netlify/runtime": "^4.1.24",
+    "@types/node": "^25.9.1",
+    "@typescript/native-preview": "7.0.0-dev.20260521.1",
+    "@vercel/queue": "^0.2.0",
+    "@vitest/coverage-v8": "^4.1.7",
     "automd": "^0.4.3",
     "changelogen": "^0.6.2",
     "cjs-module-lexer": "^2.2.0",
     "env-runner-fixture": "link:",
-    "miniflare": "^4.20260317.3",
-    "obuild": "^0.4.32",
-    "oxfmt": "^0.42.0",
-    "oxlint": "^1.57.0",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.2"
+    "miniflare": "^4.20260520.0",
+    "obuild": "^0.4.35",
+    "oxfmt": "^0.51.0",
+    "oxlint": "^1.66.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
   },
   "peerDependencies": {
-    "@netlify/runtime": "^4",
-    "miniflare": "^4.20260317.3"
+    "@netlify/runtime": "^4.1.23",
+    "@vercel/queue": "^0.2.0",
+    "miniflare": "^4.20260515.0"
   },
   "peerDependenciesMeta": {
     "miniflare": {
@@ -73,7 +76,10 @@
     },
     "@netlify/runtime": {
       "optional": true
+    },
+    "@vercel/queue": {
+      "optional": true
     }
   },
-  "packageManager": "pnpm@10.33.0"
+  "packageManager": "pnpm@11.2.2"
 }