env-runner 0.3.0 → 0.3.1

package/dist/_chunks/server.mjs

@@ -317,6 +317,7 @@ 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 } },

package/dist/_chunks/types.d.mts

@@ -1,5 +1,5 @@
-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`

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, VirtualModule, VirtualModuleContent, VirtualModuleFormat, VirtualModuleSource, VirtualModuleUpdates, VirtualModules, WorkerAddress, WorkerHooks } from "./_chunks/types.mjs";
-import { BaseEnvRunner, EnvRunnerData } from "./_chunks/common-base-runner.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";
@@ -71,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;
@@ -87,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. */
@@ -162,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 VirtualModule, type VirtualModuleContent, type VirtualModuleFormat, type VirtualModuleSource, type VirtualModuleUpdates, 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

@@ -2,8 +2,8 @@ import { BaseEnvRunner } from "../../_chunks/common-base-runner.mjs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
-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";
@@ -43,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?.();

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

@@ -1,15 +1,16 @@
-import { formatInitError, handleUpdateVirtualModules, isVirtualEntry, 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 = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
+	unregisterHooks = await registerWorkerHooks(data);
 	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
@@ -38,7 +39,7 @@ 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;

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

@@ -1,15 +1,16 @@
-import { formatInitError, handleUpdateVirtualModules, isVirtualEntry, 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 = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
+	unregisterHooks = await registerWorkerHooks(data);
 	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
@@ -38,7 +39,7 @@ 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;

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/worker.mjs

@@ -1,15 +1,16 @@
-import { formatInitError, handleUpdateVirtualModules, isVirtualEntry, 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 = await receiveProcessData();
 const sendMessage = (message) => process.send(message);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
+	unregisterHooks = await registerWorkerHooks(data);
 	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
@@ -38,7 +39,7 @@ 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;

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

@@ -1,14 +1,15 @@
-import { formatInitError, handleUpdateVirtualModules, isVirtualEntry, 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);
-let unregisterVirtualModules;
+let unregisterHooks;
 let entry;
 let server;
 try {
-	unregisterVirtualModules = await registerVirtualModules(data.virtual);
+	unregisterHooks = await registerWorkerHooks(data);
 	entry = await resolveEntry(data.entry, isVirtualEntry(data.entry));
 	server = serve({
 		...toServerOptions(entry),
@@ -37,7 +38,7 @@ 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;

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

@@ -1,11 +1,13 @@
 import { VirtualModuleUpdates, 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 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: {

package/dist/runners/self/runner.mjs

@@ -86,6 +86,10 @@ var SelfEnvRunner = class extends BaseEnvRunner {
 			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;

package/package.json

@@ -1,12 +1,9 @@
 {
   "name": "env-runner",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Generic environment runner for JavaScript runtimes.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "unjs/env-runner"
-  },
+  "repository": "unjs/env-runner",
   "bin": {
     "env-runner": "./dist/cli.mjs"
   },
@@ -34,6 +31,17 @@
     "./runners/netlify/worker": "./dist/runners/netlify/worker.mjs",
     "./vite": "./dist/vite.mjs"
   },
+  "scripts": {
+    "build": "obuild",
+    "dev": "vitest dev",
+    "fmt": "automd && oxlint . --fix && oxfmt .",
+    "lint": "oxlint . && oxfmt --check .",
+    "prepack": "pnpm build",
+    "env-runner": "node ./src/cli.ts",
+    "release": "pnpm test && pnpm build && changelogen --release && pnpm publish && git push --follow-tags",
+    "test": "pnpm lint && pnpm typecheck && vitest run --coverage",
+    "typecheck": "tsc --noEmit --skipLibCheck"
+  },
   "dependencies": {
     "crossws": "^0.4.12",
     "exsolve": "^1.1.1",
@@ -43,7 +51,7 @@
   "devDependencies": {
     "@netlify/runtime": "^5.0.5",
     "@types/node": "^26.6.2",
-    "@vercel/queue": "^0.6.0",
+    "@vercel/queue": "^0.7.0",
     "@vitest/coverage-v8": "^5.0.1",
     "automd": "^0.4.3",
     "changelogen": "^0.6.2",
@@ -52,20 +60,12 @@
     "es-module-lexer": "^3.0.2",
     "miniflare": "^5.20260921.1-alpha",
     "obuild": "^0.4.40",
+    "oxc-transform": "^0.151.0",
     "oxfmt": ">=0.70.0",
     "oxlint": "^1.85.0",
     "typescript": "^7.0.2",
     "vitest": "^5.0.1",
-    "wrangler": "^4.138.0"
+    "wrangler": "^4.140.0"
   },
-  "scripts": {
-    "build": "obuild",
-    "dev": "vitest dev",
-    "fmt": "automd && oxlint . --fix && oxfmt .",
-    "lint": "oxlint . && oxfmt --check .",
-    "env-runner": "node ./src/cli.ts",
-    "release": "pnpm test && pnpm build && changelogen --release && pnpm publish && git push --follow-tags",
-    "test": "pnpm lint && pnpm typecheck && vitest run --coverage",
-    "typecheck": "tsc --noEmit --skipLibCheck"
-  }
-}
+  "packageManager": "pnpm@12.6.0"
+}