@systemfsoftware/stryker-js 7.0.0 → 9.0.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @systemfsoftware/stryker-js
 
+## 9.0.0
+
+### Major Changes
+
+- The incremental file now carries `incrementalVersion` (the Stryker package version). Stryker writes it on every incremental run and discards an incremental file it cannot parse or whose `incrementalVersion` differs from the running version, falling back to a full mutation testing run instead of failing. `IncrementalReportSchema` requires `incrementalVersion`, and `decodeIncrementalReport` and `IncrementalReportError` are no longer exported.
+
+## 8.0.0
+
+### Major Changes
+
+- The checker request carries a plain data record, not the instrumenter's `Mutant` class. `CheckerRequest.mutants` and `CheckerService.check`/`group` now speak `CheckerMutantWire` - `id`, `fileName`, `mutatorName`, `replacement`, and `location`. A mutant that cannot be described to a checker is skipped instead of reaching it.
+
+  With `OTEL_ENABLED=true` the CLI now exports its OpenTelemetry metrics to `OTEL_EXPORTER_OTLP_ENDPOINT`, and `OTEL_METRIC_EXPORT_INTERVAL` sets the export interval in milliseconds. Checker timings, mutant counts, and worker crashes now reach a metrics backend.
+
+  `ConfigEnv` and `resolveExtends` are no longer exported. Import `ConfigEnv` from the config entry point of the package, and read merged options with `loadConfigCell` or `readConfig` from the package root - either performs the `extends` walk, validation and merge in order.
+
 ## 7.0.0
 
 ### Major Changes

package/dist/config.d.mts

@@ -1,5 +1,15 @@
-import { U as StrykerOptions, j as PartialStrykerOptions } from "./output-mode-C5DpB11I.mjs";
-import { i as StrykerConfigFn, n as StrykerConfig, r as StrykerConfigExport, t as ConfigEnv } from "./stryker-config-CTcO2hiS.mjs";
+import { L as PartialStrykerOptions, Y as StrykerOptions, n as OutputMode } from "./output-mode-CE6VNHfH.mjs";
+//#region src/config/stryker-config.d.ts
+interface ConfigEnv {
+  readonly command: 'run' | 'merge-reports';
+  readonly isDryRun: boolean;
+  readonly mode: OutputMode;
+  readonly isCi: boolean;
+}
+type StrykerConfig = PartialStrykerOptions;
+type StrykerConfigFn = (env: ConfigEnv) => StrykerConfig | Promise<StrykerConfig>;
+type StrykerConfigExport = StrykerConfig | Promise<StrykerConfig> | StrykerConfigFn;
+//#endregion
 //#region src/config/define-config.d.ts
 export declare function defineConfig(config: StrykerConfig): StrykerConfig;
 export declare function defineConfig(config: Promise<StrykerConfig>): Promise<StrykerConfig>;

package/dist/index.d.mts

@@ -10,6 +10,7 @@ import * as Exit from 'effect/Exit';
 import * as FileSystem from 'effect/FileSystem';
 import * as HashMap from 'effect/HashMap';
 import * as Layer from 'effect/Layer';
+import * as Metric from 'effect/Metric';
 import * as MutableHashMap from 'effect/MutableHashMap';
 import * as MutableHashSet from 'effect/MutableHashSet';
 import * as Option from 'effect/Option';
@@ -294,10 +295,76 @@ declare const CheckerAnsweredUnrequested_base: S.Class<CheckerAnsweredUnrequeste
     readonly requestedIds: S.$Array<S.String>;
 }>, YieldableError>;
 
+export declare const CheckerCheckResult: S.$Record<S.String, S.Union<readonly [S.Struct<{
+    readonly status: S.Literal<"passed">;
+}>, S.Struct<{
+    readonly status: S.Literal<"compileError">;
+    readonly reason: S.String;
+}>]>>;
+
 export declare type CheckerContractBroken = CheckerAnsweredUnrequested | CheckerSkippedRequested;
 
 export declare type CheckerCrash = ChildProcessCrashedError | OutOfMemoryError;
 
+export declare const checkerDuration: Metric.Histogram<Duration>;
+
+export declare class CheckerFailed extends CheckerFailed_base {}
+
+declare const CheckerFailed_base: S.Class<CheckerFailed, S.TaggedStruct<"CheckerFailed", {
+    readonly cause: S.String;
+    readonly checkerName: S.String;
+    readonly mutantIds: S.$Array<S.String>;
+}>, YieldableError>;
+
+export declare const CheckerGroupResult: S.$Array<S.$Array<S.String>>;
+
+export declare const checkerMutantsChecked: Metric.Counter<number>;
+
+export declare const checkerMutantsSkipped: Metric.Counter<number>;
+
+export declare const CheckerMutantWire: S.Struct<{
+    readonly id: S.NonEmptyString;
+    readonly fileName: S.NonEmptyString;
+    readonly mutatorName: S.NonEmptyString;
+    readonly replacement: S.String;
+    readonly location: S.Struct<{
+        readonly start: S.Struct<{
+            readonly line: S.Finite;
+            readonly column: S.Finite;
+        }>;
+        readonly end: S.Struct<{
+            readonly line: S.Finite;
+            readonly column: S.Finite;
+        }>;
+    }>;
+}>;
+
+export declare type CheckerMutantWire = typeof CheckerMutantWire.Type;
+
+export declare const checkerProcessCrashes: Metric.Counter<number>;
+
+export declare const CheckerRequest: S.Struct<{
+    readonly checkerName: S.String;
+    readonly mutants: S.$Array<S.Struct<{
+        readonly id: S.NonEmptyString;
+        readonly fileName: S.NonEmptyString;
+        readonly mutatorName: S.NonEmptyString;
+        readonly replacement: S.String;
+        readonly location: S.Struct<{
+            readonly start: S.Struct<{
+                readonly line: S.Finite;
+                readonly column: S.Finite;
+            }>;
+            readonly end: S.Struct<{
+                readonly line: S.Finite;
+                readonly column: S.Finite;
+            }>;
+        }>;
+    }>>;
+}>;
+
+export declare type CheckerRequest = typeof CheckerRequest.Type;
+
 /**
  * A checker held by the pool.
  *
@@ -307,17 +374,14 @@ export declare type CheckerCrash = ChildProcessCrashedError | OutOfMemoryError;
  * which lets the retry combinator prove it handles every one of them.
  */
 export declare interface CheckerResourceService {
-    readonly check: (checkerName: string, mutants: readonly Mutant[]) => Effect.Effect<Record<string, CheckResult>, CheckerCrash>;
-    /**
-     * Partition mutants into groups that can be checked together.
-     *
-     * A checker with no grouping opinion returns one group per mutant — the
-     * identity partition — rather than leaving the member off, which is what
-     * every call site used to synthesise for itself.
-     */
-    readonly group: (checkerName: string, mutants: readonly Mutant[]) => Effect.Effect<readonly (readonly string[])[], CheckerCrash>;
+    readonly check: (checkerName: string, mutants: readonly CheckerMutantWire[]) => Effect.Effect<Record<string, CheckResult>, CheckerCrash>;
+    readonly group: (checkerName: string, mutants: readonly CheckerMutantWire[]) => Effect.Effect<readonly (readonly string[])[], CheckerCrash>;
 }
 
+export declare const checkerRpcFailures: Metric.Counter<number>;
+
+export declare const CheckerRpcs: RpcGroup.RpcGroup<TracedRpc<'check', typeof CheckerRequest, typeof CheckerCheckResult, typeof CheckerFailed> | TracedRpc<'group', typeof CheckerRequest, typeof CheckerGroupResult, typeof CheckerFailed>>;
+
 export declare class CheckerSkippedRequested extends CheckerSkippedRequested_base {}
 
 declare const CheckerSkippedRequested_base: S.Class<CheckerSkippedRequested, S.TaggedStruct<"CheckerSkippedRequested", {
@@ -409,13 +473,6 @@ export declare const CONFIG_SYNTAX_HELP: string;
 
 export declare const ConfigDocumentSchema: S.$Record<S.String, S.Unknown>;
 
-export declare interface ConfigEnv {
-    readonly command: 'run' | 'merge-reports';
-    readonly isDryRun: boolean;
-    readonly mode: OutputMode;
-    readonly isCi: boolean;
-}
-
 export declare class ConfigError extends ConfigError_base {
     readonly exitClass: 'ConfigError';
 }
@@ -1053,6 +1110,7 @@ declare interface ImportSpecifier extends Span$1 {
 }
 
 export declare const IncrementalReportSchema: S.StructWithRest<S.Struct<{
+    readonly incrementalVersion: S.String;
     readonly schemaVersion: S.String;
     readonly thresholds: S.Struct<{
         readonly high: S.Finite;
@@ -1999,8 +2057,6 @@ export declare interface ResolvedMode {
 
 export declare function resolveExitCode(pending: Iterable<ExitClass>, signal: number | null): number;
 
-export declare function resolveExtends(configFile: string, document: PartialStrykerOptions, configEnv: ConfigEnv): Effect.Effect<PartialStrykerOptions, ConfigFileUnreadableError | ConfigFileInvalidError | ConfigFileUnsupportedError, Path.Path>;
-
 declare interface ReturnStatement$1 extends Span$1 {
     type: "ReturnStatement";
     argument: Expression$1 | null;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { $ as ConfigFileNotFoundError, $t as ReporterInitOptions, A as mergeConfigs, At as resolveExitCode, B as classifyWorkerExit, Bt as optionsPath, C as spawnReporterWorker, Ct as RunFailed, D as importModule, Dt as VerdictReached, E as forkCoreSchema, Et as RunStarted, F as isCommandRunner, Ft as deepFreeze, G as isVmRunner, Gt as MutantResultSchema, H as OutOfMemoryError, Ht as ExitClass, I as WorkerLauncher, It as defaultOptions, J as vmTestRunner, Jt as MutationTestResultSchema, K as vmRunnerCapabilities, Kt as MutantTested, L as connectRetry, Lt as findUnserializables, M as resolveExtends, Mt as CONFIG_SYNTAX_HELP, N as validateOptions, Nt as SUPPORTED_CONFIG_FILE_NAMES, O as initialExtendsStepState, Ot as EXIT_CODE, P as buildTestRunner, Pt as createDefaultOptions, Q as ConfigFileInvalidError, Qt as ReporterEventBatch, R as makeWorkerClient, Rt as isModuleSpecifier, S as reporterWorkerFactory, St as PlanKnown, T as describeErrors, Tt as RunPhase, U as WorkerBootTimeoutError, Ut as FileResultSchema, V as ChildProcessCrashedError, Vt as DryRunCompleted, W as VmRunner, Wt as MetricsSchema, X as ConfigDocumentSchema, Xt as ReporterAck, Y as StrykerError, Yt as MutationTestingPlanReady, Z as ConfigError, Zt as ReporterDrained, _ as createFileMatcher, _t as RunEvents, a as shouldKeepTempDir, an as LocationSchema, at as ExtendsStepRefused, b as RunEnvironment, bt as HelpRendered, c as buildVerdictEnvelope, cn as PositionSchema, ct as ImportedModuleSchema, d as strykerVersion, dt as ReadConfigCommand, en as ReporterRpcs, et as ConfigFileUnreadableError, f as calculateMetrics, ft as extendsPropertySchema, g as CheckerSkippedRequested, gt as StageError, h as CheckerAnsweredUnrequested, ht as toRelativeNormalizedFileName, i as mutationTestCell, in as WorkerPluginKind, it as ExtendsStepRead, j as readConfig, jt as verdictExitClass, k as loadConfigCell, kt as highestExitClass, l as generateRunId, lt as MergeCommand, m as checkGroupedPlans, mt as survivorsPriorReport, n as RUN_EVENTS_QUEUE_BOUND, nn as TestRunnerConfigSchema, nt as ExtendsStepDocumentSchema, o as ACTIONABLE_STATUSES, on as MutantActivationSchema, ot as ExtendsStepResolve, p as countMutants, pt as forkOptionsSchema, q as vmRunnerName, qt as MutationTestReportReady, r as makeRunLayer, rn as TraceContextMiddleware, rt as ExtendsStepDone, s as VERDICT_ENVELOPE_SCHEMA_VERSION, sn as MutantStatusSchema, st as ExtendsStepStateSchema, t as strykerCell, tn as StrykerOptionsSchema, tt as ConfigFileUnsupportedError, u as isActionableStatus, ut as MergeResult, v as matchesFile, vt as RunIdentity, w as decideExtendsStep, wt as RunMutantTested, x as REPORTER_EVENT_BATCH_BOUND, xt as PhaseEntered, y as IncrementalReportSchema, yt as Heartbeat, z as IdGenerator, zt as isWarningEnabled } from "./src-BY5pFAY5.mjs";
-export { ACTIONABLE_STATUSES, CONFIG_SYNTAX_HELP, CheckerAnsweredUnrequested, CheckerSkippedRequested, ChildProcessCrashedError, ConfigDocumentSchema, ConfigError, ConfigFileInvalidError, ConfigFileNotFoundError, ConfigFileUnreadableError, ConfigFileUnsupportedError, DryRunCompleted, EXIT_CODE, ExitClass, ExtendsStepDocumentSchema, ExtendsStepDone, ExtendsStepRead, ExtendsStepRefused, ExtendsStepResolve, ExtendsStepStateSchema, FileResultSchema, Heartbeat, HelpRendered, IdGenerator, ImportedModuleSchema, IncrementalReportSchema, LocationSchema, MergeCommand, MergeResult, MetricsSchema, MutantActivationSchema, MutantResultSchema, MutantStatusSchema, MutantTested, MutationTestReportReady, MutationTestResultSchema, MutationTestingPlanReady, OutOfMemoryError, PhaseEntered, PlanKnown, PositionSchema, REPORTER_EVENT_BATCH_BOUND, RUN_EVENTS_QUEUE_BOUND, ReadConfigCommand, ReporterAck, ReporterDrained, ReporterEventBatch, ReporterInitOptions, ReporterRpcs, RunEnvironment, RunEvents, RunFailed, RunIdentity, RunMutantTested, RunPhase, RunStarted, SUPPORTED_CONFIG_FILE_NAMES, StageError, StrykerError, StrykerOptionsSchema, TestRunnerConfigSchema, TraceContextMiddleware, VERDICT_ENVELOPE_SCHEMA_VERSION, VerdictReached, VmRunner, WorkerBootTimeoutError, WorkerLauncher, WorkerPluginKind, buildTestRunner, buildVerdictEnvelope, calculateMetrics, checkGroupedPlans, classifyWorkerExit, connectRetry, countMutants, createDefaultOptions, createFileMatcher, decideExtendsStep, deepFreeze, defaultOptions, describeErrors, extendsPropertySchema, findUnserializables, forkCoreSchema, forkOptionsSchema, generateRunId, highestExitClass, importModule, initialExtendsStepState, isActionableStatus, isCommandRunner, isModuleSpecifier, isVmRunner, isWarningEnabled, loadConfigCell, makeRunLayer, makeWorkerClient, matchesFile, mergeConfigs, mutationTestCell, optionsPath, readConfig, reporterWorkerFactory, resolveExitCode, resolveExtends, shouldKeepTempDir, spawnReporterWorker, strykerCell, strykerVersion, survivorsPriorReport, toRelativeNormalizedFileName, validateOptions, verdictExitClass, vmRunnerCapabilities, vmRunnerName, vmTestRunner };
+import { $ as StrykerError, $t as FileResultSchema, A as describeErrors, At as RunStarted, B as WorkerLauncher, Bt as defaultOptions, C as strykerVersion, Ct as Heartbeat, D as reporterWorkerFactory, Dt as RunFailed, E as REPORTER_EVENT_BATCH_BOUND, Et as PlanKnown, F as mergeConfigs, Ft as verdictExitClass, G as ChildProcessCrashedError, Gt as CheckerCheckResult, H as makeWorkerClient, Ht as isModuleSpecifier, I as readConfig, It as CONFIG_SYNTAX_HELP, J as VmRunner, Jt as CheckerMutantWire, K as OutOfMemoryError, Kt as CheckerFailed, L as validateOptions, Lt as SUPPORTED_CONFIG_FILE_NAMES, M as importModule, Mt as EXIT_CODE, N as initialExtendsStepState, Nt as highestExitClass, O as spawnReporterWorker, Ot as RunMutantTested, P as loadConfigCell, Pt as resolveExitCode, Q as vmTestRunner, Qt as ExitClass, R as buildTestRunner, Rt as createDefaultOptions, S as matchesFile, St as RunIdentity, T as RunEnvironment, Tt as PhaseEntered, U as IdGenerator, Ut as isWarningEnabled, V as connectRetry, Vt as findUnserializables, W as classifyWorkerExit, Wt as optionsPath, X as vmRunnerCapabilities, Xt as CheckerRpcs, Y as isVmRunner, Yt as CheckerRequest, Z as vmRunnerName, Zt as DryRunCompleted, _ as checkerProcessCrashes, _n as MutantStatusSchema, _t as forkOptionsSchema, a as shouldKeepTempDir, an as MutationTestingPlanReady, at as ConfigFileUnsupportedError, b as CheckerSkippedRequested, bt as StageError, c as buildVerdictEnvelope, cn as ReporterEventBatch, ct as ExtendsStepRead, d as calculateMetrics, dn as StrykerOptionsSchema, dt as ExtendsStepStateSchema, en as MetricsSchema, et as ConfigDocumentSchema, f as countMutants, fn as TestRunnerConfigSchema, ft as ImportedModuleSchema, g as checkerMutantsSkipped, gn as MutantActivationSchema, gt as extendsPropertySchema, h as checkerMutantsChecked, hn as LocationSchema, ht as ReadConfigCommand, i as mutationTestCell, in as MutationTestResultSchema, it as ConfigFileUnreadableError, j as forkCoreSchema, jt as VerdictReached, k as decideExtendsStep, kt as RunPhase, l as generateRunId, ln as ReporterInitOptions, lt as ExtendsStepRefused, m as checkerDuration, mn as WorkerPluginKind, mt as MergeResult, n as RUN_EVENTS_QUEUE_BOUND, nn as MutantTested, nt as ConfigFileInvalidError, o as ACTIONABLE_STATUSES, on as ReporterAck, ot as ExtendsStepDocumentSchema, p as checkGroupedPlans, pn as TraceContextMiddleware, pt as MergeCommand, q as WorkerBootTimeoutError, qt as CheckerGroupResult, r as makeRunLayer, rn as MutationTestReportReady, rt as ConfigFileNotFoundError, s as VERDICT_ENVELOPE_SCHEMA_VERSION, sn as ReporterDrained, st as ExtendsStepDone, t as strykerCell, tn as MutantResultSchema, tt as ConfigError, u as isActionableStatus, un as ReporterRpcs, ut as ExtendsStepResolve, v as checkerRpcFailures, vn as PositionSchema, vt as survivorsPriorReport, w as IncrementalReportSchema, wt as HelpRendered, x as createFileMatcher, xt as RunEvents, y as CheckerAnsweredUnrequested, yt as toRelativeNormalizedFileName, z as isCommandRunner, zt as deepFreeze } from "./src-BQuaL-fB.mjs";
+export { ACTIONABLE_STATUSES, CONFIG_SYNTAX_HELP, CheckerAnsweredUnrequested, CheckerCheckResult, CheckerFailed, CheckerGroupResult, CheckerMutantWire, CheckerRequest, CheckerRpcs, CheckerSkippedRequested, ChildProcessCrashedError, ConfigDocumentSchema, ConfigError, ConfigFileInvalidError, ConfigFileNotFoundError, ConfigFileUnreadableError, ConfigFileUnsupportedError, DryRunCompleted, EXIT_CODE, ExitClass, ExtendsStepDocumentSchema, ExtendsStepDone, ExtendsStepRead, ExtendsStepRefused, ExtendsStepResolve, ExtendsStepStateSchema, FileResultSchema, Heartbeat, HelpRendered, IdGenerator, ImportedModuleSchema, IncrementalReportSchema, LocationSchema, MergeCommand, MergeResult, MetricsSchema, MutantActivationSchema, MutantResultSchema, MutantStatusSchema, MutantTested, MutationTestReportReady, MutationTestResultSchema, MutationTestingPlanReady, OutOfMemoryError, PhaseEntered, PlanKnown, PositionSchema, REPORTER_EVENT_BATCH_BOUND, RUN_EVENTS_QUEUE_BOUND, ReadConfigCommand, ReporterAck, ReporterDrained, ReporterEventBatch, ReporterInitOptions, ReporterRpcs, RunEnvironment, RunEvents, RunFailed, RunIdentity, RunMutantTested, RunPhase, RunStarted, SUPPORTED_CONFIG_FILE_NAMES, StageError, StrykerError, StrykerOptionsSchema, TestRunnerConfigSchema, TraceContextMiddleware, VERDICT_ENVELOPE_SCHEMA_VERSION, VerdictReached, VmRunner, WorkerBootTimeoutError, WorkerLauncher, WorkerPluginKind, buildTestRunner, buildVerdictEnvelope, calculateMetrics, checkGroupedPlans, checkerDuration, checkerMutantsChecked, checkerMutantsSkipped, checkerProcessCrashes, checkerRpcFailures, classifyWorkerExit, connectRetry, countMutants, createDefaultOptions, createFileMatcher, decideExtendsStep, deepFreeze, defaultOptions, describeErrors, extendsPropertySchema, findUnserializables, forkCoreSchema, forkOptionsSchema, generateRunId, highestExitClass, importModule, initialExtendsStepState, isActionableStatus, isCommandRunner, isModuleSpecifier, isVmRunner, isWarningEnabled, loadConfigCell, makeRunLayer, makeWorkerClient, matchesFile, mergeConfigs, mutationTestCell, optionsPath, readConfig, reporterWorkerFactory, resolveExitCode, shouldKeepTempDir, spawnReporterWorker, strykerCell, strykerVersion, survivorsPriorReport, toRelativeNormalizedFileName, validateOptions, verdictExitClass, vmRunnerCapabilities, vmRunnerName, vmTestRunner };