@starci/jest-preset 2.3.1 → 2.3.2

package/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 2.3.2 - 2026-10-18
+- Added: shard mode `STARCI_COVERAGE_SHARD=1` (only the loaded files are measured, no per-file threshold, istanbul JSON) and `@starci/jest-preset/merge` (istanbul-lib-coverage merge by source location, lcov through the preset reporter): the coverage job of the sharded managed CI.
+
 ## 2.3.1 - 2026-10-18
 
 - Fixed: coverage excludes only compiler-emitted constructor `design:paramtypes` metadata guards injected by the preset transform; application source is never excluded, and the generated anchor is omitted from LCOV.

package/index.cjs

@@ -223,15 +223,21 @@ function starciJestConfig(options) {
       if (hasCoverageSubjects(root, `src/tests/${name}/**/*.${suffix}.ts`)) testProjects.push(suite(name, suffix))
     }
   }
+  // A shard of the managed CI (STARCI_COVERAGE_SHARD=1, one of npm test -- --shard=i/N) measures only the files its tests load, without the per-file threshold, and
+  // writes istanbul JSON: the coverage job merges the shards by source location (merge.cjs) and the coverage proof enforces 100 per file on the merged report. The
+  // all-files instrumentation of collectCoverageFrom is off there: it instruments an unloaded file with another transform (other functions and branches).
+  const shard = process.env.STARCI_COVERAGE_SHARD === "1"
   return {
     testTimeout: 120_000,
     coverageProvider: "v8",
-    collectCoverageFrom: collectCoverageFrom(coverage),
-    // A glob key is applied to every matching file on its own: each measured file must reach 100, not the average.
-    coverageThreshold: Object.fromEntries(coverage.roots.map((root) => rootGlob(root, coverage.roles)).filter((glob) => hasCoverageSubjects(process.cwd(), glob)).map((glob) => [`./${glob}`, { ...COVERAGE_THRESHOLD }])),
+    ...(shard ? {} : {
+      collectCoverageFrom: collectCoverageFrom(coverage),
+      // A glob key is applied to every matching file on its own: each measured file must reach 100, not the average.
+      coverageThreshold: Object.fromEntries(coverage.roots.map((root) => rootGlob(root, coverage.roles)).filter((glob) => hasCoverageSubjects(process.cwd(), glob)).map((glob) => [`./${glob}`, { ...COVERAGE_THRESHOLD }])),
+    }),
     coverageDirectory: "coverage",
-    // lcov is what Sonar imports (coverage/lcov.info); text-summary and text are what the developer reads.
-    coverageReporters: ["text-summary", "text", [require.resolve("./lcov.cjs"), {}]],
+    // lcov is what Sonar imports (coverage/lcov.info); text-summary and text are what the developer reads; a shard writes the json the merge reads.
+    coverageReporters: shard ? ["text-summary", "json"] : ["text-summary", "text", [require.resolve("./lcov.cjs"), {}]],
     projects: [
       {
         ...shared,

package/merge.cjs

@@ -0,0 +1,45 @@
+"use strict"
+
+// merge.cjs - the coverage of a sharded unit run merged into the one report the coverage proof, Codecov and Sonar read (`starci app coverage merge`).
+// Each shard runs with STARCI_COVERAGE_SHARD=1 (starciJestConfig): it measures ONLY the files its tests load (no collectCoverageFrom all-files
+// instrumentation, whose fallback transform gives an unloaded file another function and branch set) and writes istanbul JSON (coverage-final.json).
+// The maps of one file come from the same v8 transform in every shard; istanbul-lib-coverage merges them by source location (FileCoverage.merge), and the
+// merged map is written as lcov through this preset's own lcov reporter (lcov.cjs: stable function ids, the generated metadata source left out), exactly
+// as an unsharded run writes it. A measured file no shard loaded is absent from the merged map: the coverage proof refuses it (no lcov record, 0%).
+const fs = require("node:fs")
+const path = require("node:path")
+const { createRequire } = require("node:module")
+
+const fromJest = createRequire(require.resolve("jest"))
+const fromCore = createRequire(fromJest.resolve("@jest/core"))
+const fromReporters = createRequire(fromCore.resolve("@jest/reporters"))
+const libCoverage = fromReporters("istanbul-lib-coverage")
+const libReport = fromReporters("istanbul-lib-report")
+const StarciLcovReport = require("./lcov.cjs")
+
+/** Every coverage-final.json at or below `target` (a file or a directory), sorted. */
+function coverageFilesUnder(target) {
+  if (!fs.statSync(target).isDirectory()) return [target]
+  return fs.readdirSync(target, { recursive: true, withFileTypes: true })
+    .filter((entry) => entry.isFile() && entry.name === "coverage-final.json")
+    .map((entry) => path.join(entry.parentPath ?? entry.path, entry.name))
+    .sort()
+}
+
+/**
+ * Merge the shard reports `inputs` (coverage-final.json files or directories holding them) and write `<outDir>/lcov.info` and `<outDir>/coverage-final.json`.
+ * Returns { reports, files }; throws when no report is found (an empty merge would read as "nothing to measure").
+ */
+function mergeCoverage({ inputs, outDir }) {
+  const reports = inputs.flatMap((input) => coverageFilesUnder(input))
+  if (!reports.length) throw new Error(`no coverage-final.json under ${inputs.join(", ")}: the unit shards wrote none (run them with STARCI_COVERAGE_SHARD=1)`)
+  const map = libCoverage.createCoverageMap({})
+  for (const report of reports) map.merge(JSON.parse(fs.readFileSync(report, "utf8")))
+  fs.mkdirSync(outDir, { recursive: true })
+  fs.writeFileSync(path.join(outDir, "coverage-final.json"), JSON.stringify(map.toJSON()))
+  const context = libReport.createContext({ dir: outDir, coverageMap: map })
+  new StarciLcovReport({ file: "lcov.info", projectRoot: process.cwd() }).execute(context)
+  return { reports: reports.length, files: map.files().length }
+}
+
+module.exports = { mergeCoverage, coverageFilesUnder }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/jest-preset",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "The StarCi jest config for Nest repositories (unit, integration, e2e and contract projects, ts-jest with diagnostics off, per-file 100 coverage of *.service.ts only) and the one shared unit-test double kit: typed mock<T>(), mockEntityManager(), fakeTransaction(), fakeCache(), fakeLock(), recordingEventBus(), recordingQueueOutbox(), fakeInbox(), FakeClock, fakeIds(), builder() and the Outcome matchers toBeRefused/toSucceedWith.",
   "license": "MIT",
   "private": false,
@@ -54,6 +54,9 @@
     "./builders": {
       "types": "./builders.d.ts",
       "default": "./builders.cjs"
+    },
+    "./merge": {
+      "default": "./merge.cjs"
     }
   },
   "files": [