@systemfsoftware/stryker-js-vitest-runner 4.0.4 → 6.0.0

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @systemfsoftware/stryker-js-vitest-runner
 
+## 6.0.0
+
+### Major Changes
+
+- `testRunner`, `checkers`, and `ignorers` now carry the plugin and its options together.
+
+  - `testRunner` is `'command'`, `'vm'`, or `{ plugin, options?, nodeArgs? }`.
+  - `checkers` is `{ plugin, options?, nodeArgs? }[]`. Each checker is its own plugin.
+  - `ignorers` is plugin file URLs. Every ignorer those modules export runs. There is no separate name list.
+  - Put Vitest settings on `testRunner.options` (`configFile`, `dir`, `related`). There is no `vitest` block.
+  - Put TypeScript checker settings on that checker's `options` (`prioritizePerformanceOverAccuracy`). There is no `typescriptChecker` block.
+
+  Before:
+
+  ```ts
+  export default defineConfig({
+    testRunner: 'vitest',
+    checkers: ['typescript'],
+    plugins: [
+      import.meta.resolve('@systemfsoftware/stryker-js-vitest-runner'),
+      import.meta.resolve('@systemfsoftware/stryker-js-typescript-checker'),
+      import.meta.resolve('@systemfsoftware/stryker-ignorer-effect-schema-declarations'),
+    ],
+    vitest: { configFile: 'vitest.config.ts' },
+    typescriptChecker: { prioritizePerformanceOverAccuracy: true },
+    ignorers: ['effect-schema-declarations'],
+  })
+  ```
+
+  After:
+
+  ```ts
+  export default defineConfig({
+    testRunner: {
+      plugin: import.meta.resolve('@systemfsoftware/stryker-js-vitest-runner'),
+      options: { configFile: 'vitest.config.ts' },
+    },
+    checkers: [
+      {
+        plugin: import.meta.resolve('@systemfsoftware/stryker-js-typescript-checker'),
+        options: { prioritizePerformanceOverAccuracy: true },
+      },
+    ],
+    ignorers: [
+      import.meta.resolve('@systemfsoftware/stryker-ignorer-effect-schema-declarations'),
+    ],
+  })
+  ```
+
+## 5.0.0
+
+### Major Changes
+
+- Every module Stryker loads — config files, `extends` targets, plugins, and the vitest runner's own vitest — now resolves and imports through Node's native ECMAScript module system: `import.meta.resolve` resolves each bare specifier from the consuming module, and dynamic `import()` loads the resolved URL. The package's `exports` map (or a legacy `main`) selects the entry file, ESM-only plugin packages load, and no require-based loader ships in any package. An unresolvable bare specifier warns with a machine-readable reason; the run fails at prepare only when nothing provides the configured runner or checker. Node.js 22.18.0 or later is required.
+
+  To migrate, install Node.js 22.18.0 or later. Bare plugin specifiers keep working, but a plugin package must publish an ES module entry through `exports` or `main`, and the plugin must be resolvable from where Stryker itself is installed.
+
+- The plugin system now runs each configured TestRunner/Checker/Reporter plugin in its own spawned process over an @effect/rpc wire: plugins load from the project's config-declared specifiers (no glob discovery), boundary failures are typed errors, and plugin spans link into the host trace. Breaking: the in-process plugin Layer contract is removed.
+
+### Patch Changes
+
+- Maintenance release. Every published entry point, export, option, and behaviour is exactly as it was.
+
+- effect peer range widens to ^4.0.0-rc.112; repository metadata now points at stryker-js-effect
+
+- The worker environment now arrives on the spawn params instead of mid-init self-mutation, and the setup filename uses a uuid instead of the process id.
+
 ## 4.0.4
 
 ### Patch Changes

package/README.md

@@ -1,34 +1,77 @@
 # @systemfsoftware/stryker-js-vitest-runner
 
-Vitest test-runner plugin for Stryker
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](../../LICENSE)
+[![npm version](https://img.shields.io/npm/v/@systemfsoftware/stryker-js-vitest-runner.svg)](https://www.npmjs.com/package/@systemfsoftware/stryker-js-vitest-runner)
+
+Vitest test-runner plugin for Stryker mutation testing. Provides fast in-process sandboxing, per-test coverage tracking, and native TypeScript support.
+
+## Prerequisites
+
+- Node.js `>=22.18.0`
+- Vitest `>=2.0.0`
+- `@systemfsoftware/stryker-js` `>=5.0.0`
 
 ## Install
 
-```sh
-pnpm add @systemfsoftware/stryker-js-vitest-runner 'vitest@>=2.0.0'
+```bash
+pnpm add -D @systemfsoftware/stryker-js-vitest-runner vitest
 ```
 
-Those are peer dependencies: this package declares them but does not install them, so one copy is shared with the rest of your project.
+## Setup in `stryker.config.ts`
 
-## Entry points
+Plugins in Stryker 5.0 are resolved as `file:` URLs via `import.meta.resolve()`:
 
-- `@systemfsoftware/stryker-js-vitest-runner`
-- `@systemfsoftware/stryker-js-vitest-runner/stryker-setup`
+```ts
+import { defineConfig } from '@systemfsoftware/stryker-js/config'
+
+export default defineConfig({
+  testRunner: 'vitest',
+  plugins: [
+    import.meta.resolve('@systemfsoftware/stryker-js-vitest-runner'),
+  ],
+  mutate: [
+    'src/**/*.ts',
+    '!src/**/*.test.ts',
+    '!src/**/*.d.ts',
+  ],
+})
+```
 
-## Use
+## How It Works
 
-Name the plugin in your Stryker configuration:
+1. **Dry-run phase**: The Vitest runner executes your existing test suite, collecting per-test execution profiles and code coverage data.
+2. **Mutant sandbox**: During the mutation test phase, worker processes run only the subset of tests that cover each mutant, terminating early on test failure to maximize speed.
+3. **Vitest Config**: By default, Stryker automatically discovers your `vitest.config.ts` or `vite.config.ts`. If your configuration is located elsewhere, specify it in your config:
 
-```json
-{
-  "plugins": ["@systemfsoftware/stryker-js-vitest-runner"]
-}
+```ts
+export default defineConfig({
+  testRunner: 'vitest',
+  plugins: [import.meta.resolve('@systemfsoftware/stryker-js-vitest-runner')],
+  vitest: {
+    configFile: 'vitest.unit.config.ts',
+  },
+})
 ```
 
-## API
+## In-Source Tests (`import.meta.vitest`)
 
-The public surface is generated from the source and versioned with the package: [`etc/stryker-js-vitest-runner.api.md`](./etc/stryker-js-vitest-runner.api.md).
+If your project uses in-source testing with `if (import.meta.vitest)` blocks, add the companion ignorer plugin so unreachable test mutants are excluded from your score:
+
+```bash
+pnpm add -D @systemfsoftware/stryker-ignorer-in-source-vitest-block
+```
+
+```ts
+export default defineConfig({
+  testRunner: {
+    plugin: import.meta.resolve('@systemfsoftware/stryker-js-vitest-runner'),
+  },
+  ignorers: [
+    import.meta.resolve('@systemfsoftware/stryker-ignorer-in-source-vitest-block'),
+  ],
+})
+```
 
 ## License
 
-Apache-2.0. Part of [systemfsoftware](https://github.com/systemfsoftware/systemfsoftware/tree/main/packages/stryker-js/vitest-runner#readme).
+[Apache-2.0](../../LICENSE)

package/dist/execAsync-CUNMu62l.mjs

@@ -0,0 +1,10 @@
+import { i as __require, r as __commonJSMin } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/execAsync.js
+var require_execAsync = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.execAsync = void 0;
+	const child_process = __require("child_process");
+	exports.execAsync = __require("util").promisify(child_process.exec);
+}));
+//#endregion
+export { require_execAsync as t };

package/dist/execAsync-zBkwnfr9.mjs

@@ -0,0 +1,10 @@
+import { i as __require, r as __commonJSMin } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/execAsync.js
+var require_execAsync = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.execAsync = void 0;
+	const child_process = __require("child_process");
+	exports.execAsync = __require("util").promisify(child_process.exec);
+}));
+//#endregion
+export { require_execAsync as t };

package/dist/getMachineId-bsd-Ci7jvBhd.mjs

@@ -0,0 +1,26 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-zBkwnfr9.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-bsd.js
+var require_getMachineId_bsd = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const fs_1 = __require("fs");
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		try {
+			return (await fs_1.promises.readFile("/etc/hostid", { encoding: "utf8" })).trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+		try {
+			return (await (0, execAsync_1.execAsync)("kenv -q smbios.system.uuid")).stdout.trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_bsd();
+export {};

package/dist/getMachineId-bsd-DEwG9Ywj.mjs

@@ -0,0 +1,26 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-CUNMu62l.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-bsd.js
+var require_getMachineId_bsd = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const fs_1 = __require("fs");
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		try {
+			return (await fs_1.promises.readFile("/etc/hostid", { encoding: "utf8" })).trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+		try {
+			return (await (0, execAsync_1.execAsync)("kenv -q smbios.system.uuid")).stdout.trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_bsd();
+export {};

package/dist/getMachineId-darwin-K9sCO4zL.mjs

@@ -0,0 +1,23 @@
+import { a as __toCommonJS, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-CUNMu62l.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-darwin.js
+var require_getMachineId_darwin = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		try {
+			const idLine = (await (0, execAsync_1.execAsync)("ioreg -rd1 -c \"IOPlatformExpertDevice\"")).stdout.split("\n").find((line) => line.includes("IOPlatformUUID"));
+			if (!idLine) return;
+			const parts = idLine.split("\" = \"");
+			if (parts.length === 2) return parts[1].slice(0, -1);
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_darwin();
+export {};

package/dist/getMachineId-darwin-s7YULPyU.mjs

@@ -0,0 +1,23 @@
+import { a as __toCommonJS, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-zBkwnfr9.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-darwin.js
+var require_getMachineId_darwin = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		try {
+			const idLine = (await (0, execAsync_1.execAsync)("ioreg -rd1 -c \"IOPlatformExpertDevice\"")).stdout.split("\n").find((line) => line.includes("IOPlatformUUID"));
+			if (!idLine) return;
+			const parts = idLine.split("\" = \"");
+			if (parts.length === 2) return parts[1].slice(0, -1);
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_darwin();
+export {};

package/dist/getMachineId-linux-B4KmiJGj.mjs

@@ -0,0 +1,19 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-linux.js
+var require_getMachineId_linux = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const fs_1 = __require("fs");
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		for (const path of ["/etc/machine-id", "/var/lib/dbus/machine-id"]) try {
+			return (await fs_1.promises.readFile(path, { encoding: "utf8" })).trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_linux();
+export {};

package/dist/getMachineId-linux-NPalN4Yq.mjs

@@ -0,0 +1,19 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-linux.js
+var require_getMachineId_linux = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const fs_1 = __require("fs");
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		for (const path of ["/etc/machine-id", "/var/lib/dbus/machine-id"]) try {
+			return (await fs_1.promises.readFile(path, { encoding: "utf8" })).trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_linux();
+export {};

package/dist/getMachineId-unsupported-DpGC7koj.mjs

@@ -0,0 +1,14 @@
+import { a as __toCommonJS, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-unsupported.js
+var require_getMachineId_unsupported = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		api_1.diag.debug("could not read machine-id: unsupported platform");
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_unsupported();
+export {};

package/dist/getMachineId-unsupported-Dqj1BWmV.mjs

@@ -0,0 +1,14 @@
+import { a as __toCommonJS, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-unsupported.js
+var require_getMachineId_unsupported = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		api_1.diag.debug("could not read machine-id: unsupported platform");
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_unsupported();
+export {};

package/dist/getMachineId-win-B9REJgj2.mjs

@@ -0,0 +1,25 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-zBkwnfr9.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.11.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-win.js
+var require_getMachineId_win = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const process = __require("process");
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		const args = "QUERY HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography /v MachineGuid";
+		let command = "%windir%\\System32\\REG.exe";
+		if (process.arch === "ia32" && "PROCESSOR_ARCHITEW6432" in process.env) command = "%windir%\\sysnative\\cmd.exe /c " + command;
+		try {
+			const parts = (await (0, execAsync_1.execAsync)(`${command} ${args}`)).stdout.split("REG_SZ");
+			if (parts.length === 2) return parts[1].trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_win();
+export {};

package/dist/getMachineId-win-tvSIkbRI.mjs

@@ -0,0 +1,25 @@
+import { a as __toCommonJS, i as __require, n as init_esm, r as __commonJSMin, t as esm_exports } from "./main.mjs";
+import { t as require_execAsync } from "./execAsync-CUNMu62l.mjs";
+//#region ../../node_modules/.pnpm/@opentelemetry+resources@2.2.0_@opentelemetry+api@1.9.1/node_modules/@opentelemetry/resources/build/src/detectors/platform/node/machine-id/getMachineId-win.js
+var require_getMachineId_win = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.getMachineId = void 0;
+	const process = __require("process");
+	const execAsync_1 = require_execAsync();
+	const api_1 = (init_esm(), __toCommonJS(esm_exports));
+	async function getMachineId() {
+		const args = "QUERY HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography /v MachineGuid";
+		let command = "%windir%\\System32\\REG.exe";
+		if (process.arch === "ia32" && "PROCESSOR_ARCHITEW6432" in process.env) command = "%windir%\\sysnative\\cmd.exe /c " + command;
+		try {
+			const parts = (await (0, execAsync_1.execAsync)(`${command} ${args}`)).stdout.split("REG_SZ");
+			if (parts.length === 2) return parts[1].trim();
+		} catch (e) {
+			api_1.diag.debug(`error reading machine id: ${e}`);
+		}
+	}
+	exports.getMachineId = getMachineId;
+}));
+//#endregion
+export default require_getMachineId_win();
+export {};

package/dist/index.d.mts

@@ -1,20 +1,7 @@
-import { PluginLayerContribution } from '@systemfsoftware/stryker-js';
-
-/**
- * The `vitest` test runner, as the plugin the engine loads.
- *
- * The declared layer asks for the run's resolved options and the sandbox it runs
- * in, so the requirement is visible in the type and an engine that does not
- * provide it fails to compile.
- */
-export declare const strykerPlugins: PluginLayerContribution<"TestRunner">[];
-
-/**
- * The `vitest` option section as a JSON Schema document, for Stryker's option
- * validation — derived from the declaration, never read from a file. It is built
- * here, at the entry that contributes it, because a document is a *use* of a
- * schema and the schema module exports only declarations.
- */
-export declare const strykerValidationSchema: Record<string, unknown>;
+export declare const strykerPlugins: readonly {
+    readonly kind: 'TestRunner';
+    readonly name: string;
+    readonly workerEntry: string;
+}[];
 
 export { }