env-runner 0.2.3 → 0.3.1

package/dist/_chunks/server.mjs

@@ -168,9 +168,16 @@ var RunnerManager = class {
 		await this._runner.reloadModule(timeout);
 		this._moduleInvalidated = false;
 	}
+	async updateVirtualModules(changes, timeout) {
+		const runner = await this._waitForRunner();
+		if (!runner?.updateVirtualModules) throw new Error("Active runner does not support updateVirtualModules()");
+		await runner.updateVirtualModules(changes, timeout);
+		this._moduleInvalidated = true;
+	}
 	async invalidateModule(specifier, timeout) {
-		if (!this._runner?.invalidateModule) throw new Error("Active runner does not support invalidateModule()");
-		await this._runner.invalidateModule(specifier, timeout);
+		const runner = await this._waitForRunner();
+		if (!runner?.invalidateModule) throw new Error("Active runner does not support invalidateModule()");
+		await runner.invalidateModule(specifier, timeout);
 		this._moduleInvalidated = true;
 	}
 	async close() {
@@ -208,11 +215,11 @@ var RunnerManager = class {
 		runner.onMessage(this._internalListener);
 		for (const listener of this._messageListeners) runner.onMessage(listener);
 		const originalClose = runner.close.bind(runner);
-		runner.close = async () => {
-			await originalClose();
+		runner.close = async (cause) => {
+			await originalClose(cause);
 			if (this._runner === runner) {
 				this._runner = void 0;
-				for (const fn of this._closeListeners) fn(this);
+				for (const fn of this._closeListeners) fn(this, cause);
 			}
 		};
 		if (runner.ready) this._flushQueue();
@@ -263,6 +270,7 @@ var EnvServer = class extends RunnerManager {
 	_reloadTimeout;
 	_reloadListeners = /* @__PURE__ */ new Set();
 	_startPromise;
+	_virtual;
 	runner = null;
 	onReload(listener) {
 		this._reloadListeners.add(listener);
@@ -285,6 +293,12 @@ var EnvServer = class extends RunnerManager {
 		this.runner = runner ?? await this._createRunner();
 		await super.reload(this.runner);
 	}
+	async updateVirtualModules(changes, timeout) {
+		const virtual = this._virtual ??= { ...this._opts.data?.virtual };
+		for (const [key, source] of Object.entries(changes)) if (source === null) delete virtual[key];
+		else if (source !== void 0) virtual[key] = source;
+		if (await this._waitForRunner()) await super.updateVirtualModules(changes, timeout);
+	}
 	async close() {
 		this._stopWatching();
 		await super.close();
@@ -303,8 +317,10 @@ var EnvServer = class extends RunnerManager {
 			...this._opts.runnerOptions,
 			name: this._opts.name || this._opts.entry,
 			hooks: this._opts.hooks,
+			plugins: this._opts.plugins,
 			data: {
 				...this._opts.data,
+				...this._virtual && { virtual: { ...this._virtual } },
 				entry: this._opts.entry
 			},
 			execArgv: this._opts.execArgv

package/dist/_chunks/types.d.mts

@@ -1,5 +1,35 @@
-import { IncomingMessage } from "node:http";
 import { Socket } from "node:net";
+import { IncomingMessage } from "node:http";
+/**
+ * How a virtual module is served. Code formats are Node's load formats, plus
+ * `jsx`/`tsx` (Bun only). Raw formats follow import attribute types: `text`
+ * default-exports a string, `bytes` a `Uint8Array`, and `wasm` a compiled
+ * `WebAssembly.Module` (like workerd's Wasm modules).
+ */
+export type VirtualModuleFormat = "module" | "commonjs" | "module-typescript" | "commonjs-typescript" | "jsx" | "tsx" | "json" | "text" | "bytes" | "wasm";
+/** A source with an explicit format. */
+export interface VirtualModule {
+  /** Code or text; a `Uint8Array` for the `bytes` and `wasm` formats. */
+  source: string | Uint8Array;
+  /**
+   * Default: by the key's extension (`.cjs`, `.json`, `.ts`, `.wasm`, ...),
+   * else `module` for a string and `bytes` for a `Uint8Array`.
+   */
+  format?: VirtualModuleFormat;
+}
+/** A source whose format follows its key (string or bytes), or a source with its format. */
+export type VirtualModuleContent = string | Uint8Array | VirtualModule;
+/** Factories run on the host: before the worker spawns, and on updates. */
+export type VirtualModuleSource = VirtualModuleContent | (() => VirtualModuleContent | Promise<VirtualModuleContent>);
+/** Virtual modules as a `specifier => source` map. */
+export type VirtualModules = Record<string, VirtualModuleSource>;
+/** Changes to apply to a running map: a source sets (adds or replaces) a key, `null` removes it. */
+export type VirtualModuleUpdates = Record<string, VirtualModuleSource | null>;
+/**
+ * A validated module, as workers receive it: a string follows its key's
+ * extension, any other source carries its format.
+ */
+export type ResolvedVirtualModule = string | Required<VirtualModule>;
 /** Proxy a request to the worker; relative inputs resolve against `http://localhost`. */
 export type FetchHandler = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 /** Callback for receiving messages from the worker. */
@@ -65,6 +95,12 @@ export interface EnvRunner extends RunnerRPCHooks, AsyncDisposable {
   rpc<T = unknown>(name: string, data?: unknown, opts?: RPCOptions): Promise<T>;
   /** Re-import the entry module without restarting the worker/process. */
   reloadModule?(timeout?: number): Promise<void>;
+  /**
+   * Set (add or replace) and remove (`null`) virtual modules in one round trip.
+   * Changed and removed modules, and their importers, evaluate fresh on the
+   * next `reloadModule()`; a removed key falls through to normal resolution.
+   */
+  updateVirtualModules?(changes: VirtualModuleUpdates, timeout?: number): Promise<void>;
   /**
    * Invalidate a virtual module so the next `reloadModule()` re-evaluates it.
    * A factory-valued source is re-run for fresh contents.

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

@@ -1,5 +1,5 @@
 import { WorkerHooks } from "./types.mjs";
-import { EnvRunnerData } from "./common-base-runner.mjs";
+import { EnvRunnerData, EnvRunnerPluginOption } from "./common-base-runner.mjs";
 import { NodeWorkerEnvRunner } from "./node-worker-runner.mjs";
 export declare class VercelEnvRunner extends NodeWorkerEnvRunner {
   constructor(opts: {
@@ -7,6 +7,8 @@ export declare class VercelEnvRunner extends NodeWorkerEnvRunner {
     workerEntry?: string;
     hooks?: WorkerHooks;
     data?: EnvRunnerData;
+    /** Host-side transform plugins (see `EnvRunnerPluginOption`). */
+    plugins?: EnvRunnerPluginOption[];
   });
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
   protected _runtimeType(): string;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { EnvRunner, FetchHandler, NodeUpgradeContext, RPCOptions, RunnerMessageListener, RunnerRPCHooks, UpgradeContext, UpgradeHandler, WorkerAddress, WorkerHooks } from "./_chunks/types.mjs";
-import { BaseEnvRunner, EnvRunnerData, VirtualModuleSource, VirtualModules } from "./_chunks/common-base-runner.mjs";
+import { EnvRunner, FetchHandler, NodeUpgradeContext, RPCOptions, RunnerMessageListener, RunnerRPCHooks, UpgradeContext, UpgradeHandler, VirtualModule, VirtualModuleContent, VirtualModuleFormat, VirtualModuleSource, VirtualModuleUpdates, VirtualModules, WorkerAddress, WorkerHooks } from "./_chunks/types.mjs";
+import { BaseEnvRunner, EnvRunnerData, EnvRunnerPlugin, EnvRunnerPluginOption, PluginContext, PluginContextResolveOptions, PluginFilterExpression, PluginHook, PluginHookFilter, PluginLoadHandler, PluginLoadResult, PluginLog, PluginLogPosition, PluginModuleType, PluginResolveIdHandler, PluginResolveIdHook, PluginResolveIdOptions, PluginResolveIdResult, PluginResolvedId, PluginStringFilter, PluginTopLevelFilterExpression, PluginTransformFilter, PluginTransformHandler, PluginTransformMeta, PluginTransformResult } from "./_chunks/common-base-runner.mjs";
 import { RuntimeDep, resolveRuntimeDep } from "./_chunks/common-runtime-deps.mjs";
 import { DenoProcessEnvRunner } from "./_chunks/deno-process-runner.mjs";
 import { MiniflareEnvRunner, MiniflareEnvRunnerOptions, MiniflareExportInfo, TransformResult } from "./_chunks/miniflare-runner.mjs";
@@ -45,6 +45,11 @@ export declare class RunnerManager implements EnvRunner, AsyncDisposable {
     timeout?: number;
   }): Promise<T>;
   reloadModule(timeout?: number): Promise<void>;
+  /**
+   * Set or remove (`null`) virtual modules of the active runner (waiting for it
+   * during a reload); the next `fetch()` reloads the entry automatically.
+   */
+  updateVirtualModules(changes: VirtualModuleUpdates, timeout?: number): Promise<void>;
   /** Invalidate a virtual module; the next `fetch()` reloads the entry automatically. */
   invalidateModule(specifier: string, timeout?: number): Promise<void>;
   close(): Promise<void>;
@@ -56,7 +61,8 @@ export declare class RunnerManager implements EnvRunner, AsyncDisposable {
   private _internalListener;
   private _attach;
   private _detach;
-  private _waitForRunner;
+  /** The active runner, waiting for one during a reload. */
+  protected _waitForRunner(timeout?: number): Promise<EnvRunner | undefined>;
   private _flushQueue;
 }
 type RunnerName = "node-worker" | "node-process" | "bun-process" | "deno-process" | "self" | "miniflare" | "vercel" | "netlify";
@@ -65,6 +71,8 @@ interface LoadRunnerOptions {
   workerEntry?: string;
   hooks?: WorkerHooks;
   data?: EnvRunnerData;
+  /** Host-side transform plugins (see `EnvRunnerPluginOption`). */
+  plugins?: EnvRunnerPluginOption[];
   execArgv?: string[];
   /** Runner-specific constructor options (e.g. `miniflare` for the `miniflare` runner). */
   [key: string]: unknown;
@@ -81,6 +89,8 @@ interface EnvServerOptions {
   hooks?: WorkerHooks;
   /** Additional data passed to the runner. */
   data?: Record<string, unknown>;
+  /** Host-side transform plugins, passed to every runner the server creates. */
+  plugins?: EnvRunnerPluginOption[];
   /** Custom exec arguments (e.g. `--inspect`). */
   execArgv?: string[];
   /** Enable watch mode to auto-reload on entry file changes. */
@@ -96,6 +106,7 @@ export declare class EnvServer extends RunnerManager {
   private _reloadTimeout;
   private _reloadListeners;
   private _startPromise;
+  private _virtual;
   runner: Awaited<ReturnType<typeof loadRunner>> | null;
   /** Register a listener called when the runner is reloaded due to a file change. */
   onReload(listener: () => void): void;
@@ -109,6 +120,12 @@ export declare class EnvServer extends RunnerManager {
   start(): Promise<this>;
   /** Replace the active runner; without an argument, create one from the server options. */
   reload(runner?: EnvRunner): Promise<void>;
+  /**
+   * Also kept in the server's own map, so runners it creates later (`reload()`,
+   * watch mode) start with the changes. Without an active runner (before the
+   * first start), the changes are only recorded.
+   */
+  updateVirtualModules(changes: VirtualModuleUpdates, timeout?: number): Promise<void>;
   close(): Promise<void>;
   /** Auto-start on first fetch so an explicit `start()` call is optional. */
   protected _fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
@@ -149,4 +166,4 @@ export declare const RESERVED_RUNTIME_OPTIONS: {
 };
 /** Callers add `fetch` (bound lazily so reloads swap it) and the crossws plugin. */
 export declare function toServerOptions(entry: AppEntry): Omit<ServerOptions, "fetch">;
-export { type AppEntry, type AppEntryIPC, type AppEntryIPCContext, BaseEnvRunner, DenoProcessEnvRunner, type EnvRunnerData as DenoProcessEnvRunnerData, type EnvRunner, type EnvRunnerData, type EnvServerOptions, type FetchHandler, type LoadRunnerOptions, MiniflareEnvRunner, type MiniflareEnvRunnerOptions, type MiniflareExportInfo, NetlifyEnvRunner, type NodeUpgradeContext, type RPCOptions, type RunnerMessageListener, type RunnerName, type RunnerRPCHooks, type RuntimeDep, type TransformResult, type UpgradeContext, type UpgradeHandler, VercelEnvRunner, type VirtualModuleSource, type VirtualModules, type WorkerAddress, type WorkerHooks, resolveRuntimeDep };
+export { type AppEntry, type AppEntryIPC, type AppEntryIPCContext, BaseEnvRunner, DenoProcessEnvRunner, type EnvRunnerData as DenoProcessEnvRunnerData, type EnvRunner, type EnvRunnerData, type EnvRunnerPlugin, type EnvRunnerPluginOption, type EnvServerOptions, type FetchHandler, type LoadRunnerOptions, MiniflareEnvRunner, type MiniflareEnvRunnerOptions, type MiniflareExportInfo, NetlifyEnvRunner, type NodeUpgradeContext, type PluginContext, type PluginContextResolveOptions, type PluginFilterExpression, type PluginHook, type PluginHookFilter, type PluginLoadHandler, type PluginLoadResult, type PluginLog, type PluginLogPosition, type PluginModuleType, type PluginResolveIdHandler, type PluginResolveIdHook, type PluginResolveIdOptions, type PluginResolveIdResult, type PluginResolvedId, type PluginStringFilter, type PluginTopLevelFilterExpression, type PluginTransformFilter, type PluginTransformHandler, type PluginTransformMeta, type PluginTransformResult, type RPCOptions, type RunnerMessageListener, type RunnerName, type RunnerRPCHooks, type RuntimeDep, type TransformResult, type UpgradeContext, type UpgradeHandler, VercelEnvRunner, type VirtualModule, type VirtualModuleContent, type VirtualModuleFormat, type VirtualModuleSource, type VirtualModuleUpdates, type VirtualModules, type WorkerAddress, type WorkerHooks, resolveRuntimeDep };

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

@@ -1,5 +1,5 @@
 import { WorkerHooks } from "../../_chunks/types.mjs";
-import { BaseEnvRunner, EnvRunnerData } from "../../_chunks/common-base-runner.mjs";
+import { BaseEnvRunner, EnvRunnerData, EnvRunnerPluginOption } from "../../_chunks/common-base-runner.mjs";
 export declare class BunProcessEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -7,11 +7,14 @@ export declare class BunProcessEnvRunner extends BaseEnvRunner {
     workerEntry?: string;
     hooks?: WorkerHooks;
     data?: EnvRunnerData;
+    /** Host-side transform plugins (see `EnvRunnerPluginOption`). */
+    plugins?: EnvRunnerPluginOption[];
     execArgv?: string[];
   });
   sendMessage(message: unknown): void;
   protected _hasRuntime(): boolean;
   protected _runtimeType(): string;
+  protected _resolveConditions(): string[];
   protected _closeRuntime(): Promise<void>;
 }
 export type { EnvRunnerData as BunProcessEnvRunnerData };

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

@@ -1,10 +1,9 @@
 import { BaseEnvRunner } from "../../_chunks/common-base-runner.mjs";
-import { hostEnv } from "../../_chunks/common-host-env.mjs";
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { execSync, spawn } from "node:child_process";
 import { homedir } from "node:os";
+import { execSync, spawn } from "node:child_process";
 let _defaultEntry;
 let _bunPath;
 const _isBun = typeof Bun !== "undefined";
@@ -44,6 +43,13 @@ var BunProcessEnvRunner = class extends BaseEnvRunner {
 	_runtimeType() {
 		return "process";
 	}
+	_resolveConditions() {
+		return [
+			"bun",
+			"node",
+			"import"
+		];
+	}
 	async _closeRuntime() {
 		if (!this.#process) return;
 		this.#process.removeAllListeners?.();
@@ -57,10 +63,7 @@ var BunProcessEnvRunner = class extends BaseEnvRunner {
 			this.close(`process entry not found in "${this._workerEntry}".`);
 			return;
 		}
-		const env = hostEnv({
-			ENV_RUNNER_NAME: this._name,
-			ENV_RUNNER_DATA: JSON.stringify(this._data || {})
-		});
+		const env = this._processEnv();
 		if (_isBun) this.#initBunProcess(execArgv, env);
 		else this.#initNodeProcess(execArgv, env);
 	}
@@ -78,7 +81,7 @@ var BunProcessEnvRunner = class extends BaseEnvRunner {
 				"pipe"
 			],
 			ipc: (message) => {
-				this._handleMessage(message);
+				this._handleProcessMessage(message);
 			}
 		});
 		const child = {
@@ -128,7 +131,7 @@ var BunProcessEnvRunner = class extends BaseEnvRunner {
 			}
 		});
 		child.on("message", (message) => {
-			this._handleMessage(message);
+			this._handleProcessMessage(message);
 		});
 		child.stdout?.pipe(process.stdout);
 		child.stderr?.pipe(process.stderr);

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

@@ -1,16 +1,17 @@
-import { handleInvalidateModule, isVirtualSpecifier, parseServerAddress, registerVirtualModules, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { handleUpdateVirtualModules } from "../../_chunks/plugin-hooks.mjs";
+import { formatInitError, isVirtualEntry, parseServerAddress, registerWorkerHooks, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { receiveProcessData } from "../../_chunks/common-process-data.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
 process.on("disconnect", () => process.exit(0));
-const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
+const data = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-const virtualEntry = isVirtualSpecifier(data.entry, data.virtual);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
-	entry = await resolveEntry(data.entry, virtualEntry);
+	unregisterHooks = await registerWorkerHooks(data);
+	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
 		fetch: (request) => entry.fetch(request),
@@ -18,7 +19,7 @@ try {
 	});
 	await server.ready();
 } catch (error) {
-	const message = error?.message || String(error);
+	const message = formatInitError(error);
 	sendMessage({
 		event: "init-error",
 		error: message
@@ -38,14 +39,14 @@ process.send({ address: parseServerAddress(server) });
 process.on("message", async (message) => {
 	if (message?.event === "shutdown") {
 		Promise.resolve(entry.ipc?.onClose?.()).then(() => server.close()).then(() => {
-			unregisterVirtualModules();
+			unregisterHooks();
 			process.send({ event: "exit" });
 		});
 		return;
 	}
 	if (message?.event === "reload-module") {
 		try {
-			entry = await reloadEntryModule(data.entry, entry, sendMessage, virtualEntry);
+			entry = await reloadEntryModule(data.entry, entry, sendMessage, isVirtualEntry(data.entry));
 			process.send({ event: "module-reloaded" });
 		} catch (error) {
 			process.send({
@@ -55,8 +56,8 @@ process.on("message", async (message) => {
 		}
 		return;
 	}
-	if (message?.event === "invalidate-module") {
-		handleInvalidateModule(message, sendMessage);
+	if (message?.event === "update-virtual-modules") {
+		handleUpdateVirtualModules(message, sendMessage);
 		return;
 	}
 	if (message?.type === "ping") {

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

@@ -1,16 +1,17 @@
-import { handleInvalidateModule, isVirtualSpecifier, parseServerAddress, registerVirtualModules, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { handleUpdateVirtualModules } from "../../_chunks/plugin-hooks.mjs";
+import { formatInitError, isVirtualEntry, parseServerAddress, registerWorkerHooks, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { receiveProcessData } from "../../_chunks/common-process-data.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
 process.on("disconnect", () => process.exit(0));
-const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
+const data = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-const virtualEntry = isVirtualSpecifier(data.entry, data.virtual);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
-	entry = await resolveEntry(data.entry, virtualEntry);
+	unregisterHooks = await registerWorkerHooks(data);
+	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
 		fetch: (request) => entry.fetch(request),
@@ -18,7 +19,7 @@ try {
 	});
 	await server.ready();
 } catch (error) {
-	const message = error?.message || String(error);
+	const message = formatInitError(error);
 	sendMessage({
 		event: "init-error",
 		error: message
@@ -38,14 +39,14 @@ process.send({ address: parseServerAddress(server) });
 process.on("message", async (message) => {
 	if (message?.event === "shutdown") {
 		Promise.resolve(entry.ipc?.onClose?.()).then(() => server.close()).then(() => {
-			unregisterVirtualModules();
+			unregisterHooks();
 			process.send({ event: "exit" });
 		});
 		return;
 	}
 	if (message?.event === "reload-module") {
 		try {
-			entry = await reloadEntryModule(data.entry, entry, sendMessage, virtualEntry);
+			entry = await reloadEntryModule(data.entry, entry, sendMessage, isVirtualEntry(data.entry));
 			process.send({ event: "module-reloaded" });
 		} catch (error) {
 			process.send({
@@ -55,8 +56,8 @@ process.on("message", async (message) => {
 		}
 		return;
 	}
-	if (message?.event === "invalidate-module") {
-		handleInvalidateModule(message, sendMessage);
+	if (message?.event === "update-virtual-modules") {
+		handleUpdateVirtualModules(message, sendMessage);
 		return;
 	}
 	if (message?.type === "ping") {

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

@@ -1,5 +1,5 @@
 import { WorkerHooks } from "../../_chunks/types.mjs";
-import { BaseEnvRunner, EnvRunnerData } from "../../_chunks/common-base-runner.mjs";
+import { BaseEnvRunner, EnvRunnerData, EnvRunnerPluginOption } from "../../_chunks/common-base-runner.mjs";
 export declare class NodeProcessEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
@@ -7,6 +7,8 @@ export declare class NodeProcessEnvRunner extends BaseEnvRunner {
     workerEntry?: string;
     hooks?: WorkerHooks;
     data?: EnvRunnerData;
+    /** Host-side transform plugins (see `EnvRunnerPluginOption`). */
+    plugins?: EnvRunnerPluginOption[];
     execArgv?: string[];
   });
   sendMessage(message: unknown): void;

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

@@ -1,5 +1,4 @@
 import { BaseEnvRunner } from "../../_chunks/common-base-runner.mjs";
-import { hostEnv } from "../../_chunks/common-host-env.mjs";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
 import { fork } from "node:child_process";
@@ -36,10 +35,7 @@ var NodeProcessEnvRunner = class extends BaseEnvRunner {
 			return;
 		}
 		const child = fork(this._workerEntry, [], {
-			env: hostEnv({
-				ENV_RUNNER_NAME: this._name,
-				ENV_RUNNER_DATA: JSON.stringify(this._data || {})
-			}),
+			env: this._processEnv(),
 			stdio: [
 				"pipe",
 				"pipe",
@@ -57,7 +53,7 @@ var NodeProcessEnvRunner = class extends BaseEnvRunner {
 			this.close(error);
 		});
 		child.on("message", (message) => {
-			this._handleMessage(message);
+			this._handleProcessMessage(message);
 		});
 		child.stdout?.pipe(process.stdout);
 		child.stderr?.pipe(process.stderr);

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

@@ -1,16 +1,17 @@
-import { handleInvalidateModule, isVirtualSpecifier, parseServerAddress, registerVirtualModules, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { handleUpdateVirtualModules } from "../../_chunks/plugin-hooks.mjs";
+import { formatInitError, isVirtualEntry, parseServerAddress, registerWorkerHooks, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { receiveProcessData } from "../../_chunks/common-process-data.mjs";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
 process.on("disconnect", () => process.exit(0));
-const data = JSON.parse(process.env.ENV_RUNNER_DATA || "{}");
+const data = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-const virtualEntry = isVirtualSpecifier(data.entry, data.virtual);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
-	entry = await resolveEntry(data.entry, virtualEntry);
+	unregisterHooks = await registerWorkerHooks(data);
+	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
 		fetch: (request) => entry.fetch(request),
@@ -18,7 +19,7 @@ try {
 	});
 	await server.ready();
 } catch (error) {
-	const message = error?.message || String(error);
+	const message = formatInitError(error);
 	sendMessage({
 		event: "init-error",
 		error: message
@@ -38,14 +39,14 @@ process.send({ address: parseServerAddress(server) });
 process.on("message", async (message) => {
 	if (message?.event === "shutdown") {
 		Promise.resolve(entry.ipc?.onClose?.()).then(() => server.close()).then(() => {
-			unregisterVirtualModules();
+			unregisterHooks();
 			process.send({ event: "exit" });
 		});
 		return;
 	}
 	if (message?.event === "reload-module") {
 		try {
-			entry = await reloadEntryModule(data.entry, entry, sendMessage, virtualEntry);
+			entry = await reloadEntryModule(data.entry, entry, sendMessage, isVirtualEntry(data.entry));
 			process.send({ event: "module-reloaded" });
 		} catch (error) {
 			process.send({
@@ -55,8 +56,8 @@ process.on("message", async (message) => {
 		}
 		return;
 	}
-	if (message?.event === "invalidate-module") {
-		handleInvalidateModule(message, sendMessage);
+	if (message?.event === "update-virtual-modules") {
+		handleUpdateVirtualModules(message, sendMessage);
 		return;
 	}
 	if (message?.type === "ping") {

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

@@ -1,16 +1,16 @@
-import { handleInvalidateModule, isVirtualSpecifier, parseServerAddress, registerVirtualModules, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
+import { handleUpdateVirtualModules } from "../../_chunks/plugin-hooks.mjs";
+import { formatInitError, isVirtualEntry, parseServerAddress, registerWorkerHooks, reloadEntryModule, resolveEntry, toServerOptions } from "../../_chunks/common-worker-utils.mjs";
 import { parentPort, workerData } from "node:worker_threads";
 import { serve } from "srvx";
 import { plugin } from "crossws/server";
 const data = workerData || {};
 const sendMessage = (message) => parentPort?.postMessage(message);
-const virtualEntry = isVirtualSpecifier(data.entry, data.virtual);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
-	entry = await resolveEntry(data.entry, virtualEntry);
+	unregisterHooks = await registerWorkerHooks(data);
+	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
 		fetch: (request) => entry.fetch(request),
@@ -18,7 +18,7 @@ try {
 	});
 	await server.ready();
 } catch (error) {
-	const message = error?.message || String(error);
+	const message = formatInitError(error);
 	sendMessage({
 		event: "init-error",
 		error: message
@@ -38,14 +38,14 @@ parentPort?.postMessage({ address: parseServerAddress(server) });
 parentPort?.on("message", async (message) => {
 	if (message?.event === "shutdown") {
 		Promise.resolve(entry.ipc?.onClose?.()).then(() => server.close()).then(() => {
-			unregisterVirtualModules();
+			unregisterHooks();
 			parentPort?.postMessage({ event: "exit" });
 		});
 		return;
 	}
 	if (message?.event === "reload-module") {
 		try {
-			entry = await reloadEntryModule(data.entry, entry, sendMessage, virtualEntry);
+			entry = await reloadEntryModule(data.entry, entry, sendMessage, isVirtualEntry(data.entry));
 			parentPort?.postMessage({ event: "module-reloaded" });
 		} catch (error) {
 			parentPort?.postMessage({
@@ -55,8 +55,8 @@ parentPort?.on("message", async (message) => {
 		}
 		return;
 	}
-	if (message?.event === "invalidate-module") {
-		handleInvalidateModule(message, sendMessage);
+	if (message?.event === "update-virtual-modules") {
+		handleUpdateVirtualModules(message, sendMessage);
 		return;
 	}
 	if (message?.type === "ping") {

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

@@ -1,11 +1,13 @@
-import { WorkerHooks } from "../../_chunks/types.mjs";
-import { BaseEnvRunner, EnvRunnerData } from "../../_chunks/common-base-runner.mjs";
+import { VirtualModuleUpdates, WorkerHooks } from "../../_chunks/types.mjs";
+import { BaseEnvRunner, EnvRunnerData, EnvRunnerPluginOption } from "../../_chunks/common-base-runner.mjs";
 export declare class SelfEnvRunner extends BaseEnvRunner {
   #private;
   constructor(opts: {
     name: string;
     hooks?: WorkerHooks;
     data?: EnvRunnerData;
+    /** Not supported: the runner closes with an error. */
+    plugins?: EnvRunnerPluginOption[];
   });
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
   upgrade(context: {
@@ -16,6 +18,7 @@ export declare class SelfEnvRunner extends BaseEnvRunner {
     };
   }): Promise<void>;
   sendMessage(message: unknown): void;
+  updateVirtualModules(_changes: VirtualModuleUpdates): Promise<void>;
   invalidateModule(specifier: string): Promise<void>;
   reloadModule(): Promise<void>;
   protected _hasRuntime(): boolean;

package/dist/runners/self/runner.mjs

@@ -39,6 +39,9 @@ var SelfEnvRunner = class extends BaseEnvRunner {
 		}
 		this.#entry?.ipc?.onMessage?.(message);
 	}
+	async updateVirtualModules(_changes) {
+		throw new Error("Cannot update virtual modules: the self runner does not support virtual modules");
+	}
 	async invalidateModule(specifier) {
 		throw new Error(`Cannot invalidate "${specifier}": the self runner does not support virtual modules`);
 	}
@@ -79,8 +82,17 @@ var SelfEnvRunner = class extends BaseEnvRunner {
 			this.close("self runner requires data.entry");
 			return;
 		}
+		if (Object.keys(this._data?.virtual ?? {}).length > 0) {
+			this.close(/* @__PURE__ */ new Error("Cannot use data.virtual: the self runner does not support virtual modules"));
+			return;
+		}
+		if (this._plugins) {
+			this.close(/* @__PURE__ */ new Error("Cannot use plugins: the self runner does not support them"));
+			return;
+		}
 		this.#active = true;
 		resolveEntry(entryPath).then(async (entry) => {
+			if (this.closed) return;
 			this.#entry = entry;
 			await entry.ipc?.onOpen?.({ sendMessage: (message) => {
 				queueMicrotask(() => this._handleMessage(message));