@starci/jest-preset 2.2.1 → 2.2.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2.2.2 - 2026-10-01
+
+- Changed: the coverage reporters are `text-summary`, `text` and `lcov`. The unit run writes `coverage/lcov.info`, which Sonar (`sonar.javascript.lcov.reportPaths`) and Codecov import with the scope `hfs sync` renders from `COVERAGE_SOURCES` (services only). Coverage is still collected from `src/**/*.service.ts` only, with the per-file threshold of 100. Contract change `sonar-services-coverage`.
+
 ## 2.2.1 - 2026-10-01
 
 - Changed: declares its test toolchain as devDependencies and @jest/globals as an optional peer, with a lockfile (lane PKGT clean proof); no preset change. The published package.json differs from 2.2.0, so the version moves.

package/README.md

@@ -32,10 +32,12 @@ module.exports = require("@starci/jest-preset").starciJestConfig()
   real source. The unit project overlays `isolatedModules: false` and `importHelpers: true` on the repository tsconfig (ts-jest merges an
   inline `tsconfig` object over the `tsconfig.json` it finds): with `isolatedModules` on, TypeScript emits an unreachable
   `typeof Dep !== "undefined" ? Dep : Object` guard per class-typed constructor parameter, and inlined decorator helpers carry branches
-  of their own, so 100 would be unreachable. The repository lists `tslib` in its devDependencies (`UNIT_COMPILER_OPTIONS`). Reporters are `text-summary` and
-  `text`; there is no `lcov`.
-- **Sonar does not read coverage.** `sonarCoverageExclusions()` and the lcov report are removed. `sonarExclusions()` still renders
-  `sonar.exclusions` (`**/*.spec.ts,**/*.e2e-spec.ts,**/dist/**,**/coverage/**`); the quality gate fails on imported issues only.
+  of their own, so 100 would be unreachable. The repository lists `tslib` in its devDependencies (`UNIT_COMPILER_OPTIONS`). Reporters are `text-summary`,
+  `text` and `lcov`: the run writes `coverage/lcov.info` under the repository (be/) root.
+- **Sonar and Codecov import that lcov, scoped to the services.** `hfs sync` renders `sonar.coverage.exclusions` (the complement of the services: SonarQube has no coverage inclusions) and the `codecov.yml`
+  status paths from `COVERAGE_SOURCES` on the be side (`be/src/**/*.service.ts`), so jest, Sonar and Codecov measure the same files;
+  the Sonar gate holds coverage at 100 overall, on new code and per file. `sonarExclusions()` still renders `sonar.exclusions`
+  (`**/*.spec.ts,**/*.e2e-spec.ts,**/dist/**,**/coverage/**`). There is no coverage exclusion list.
 
 ## The unit standard in one page
 

package/index.cjs

@@ -13,7 +13,8 @@ const { fakeIds, FakeIds } = require("./ids.cjs")
  * Coverage is measured on services only: the one place business logic lives (owner-locked unit standard). Handlers,
  * resolvers, controllers and consumers are thin, and helpers called by a service are covered through the service's own
  * spec, so every `*.service.ts` under `src` is the whole denominator and every file in it must reach 100 on every metric.
- * Sonar does not read coverage at all (the gate fails on imported issues only), so there is no second list to keep in step.
+ * The unit run also writes `coverage/lcov.info`: Sonar imports it (`sonar.javascript.lcov.reportPaths`) with the same scope
+ * (`sonar.coverage.exclusions` holds every other file, rendered by hfs sync) and its quality gate holds coverage at 100 on those files.
  */
 const COVERAGE_SOURCES = ["src/**/*.service.ts"]
 const COVERAGE_EXCLUDES = ["src/tests/**", "**/dist/**", "**/coverage/**"]
@@ -87,7 +88,7 @@ const underTests = (folder) => String.raw`[\\/]src[\\/]tests[\\/]` + folder + St
  * run their spec files one at a time, each in a worker process of its own (`world-runner.cjs`; every file shares the
  * run's data, so the runner never runs two at once); the unit project alone has a `setupFilesAfterEnv` (the Outcome matchers).
  * Coverage is collected from every `*.service.ts` only, with a per-file threshold of 100 on lines, branches, functions and
- * statements: the `test` script runs the unit project with `--coverage` and fails below it. It uses v8: istanbul instruments the helpers TypeScript emits (`__decorate`, `__param`, `__awaiter`, interop wrappers)
+ * statements: the `test` script runs the unit project with `--coverage`, fails below it and writes `coverage/lcov.info` for Sonar. It uses v8: istanbul instruments the helpers TypeScript emits (`__decorate`, `__param`, `__awaiter`, interop wrappers)
  * as thousands of branches no spec can cover, while v8 measures the real source.
  */
 /** The runner of the integration, e2e and contract projects: one fresh worker process per spec file. */
@@ -125,7 +126,8 @@ function starciJestConfig() {
     // A glob key is applied to every matching file on its own: each service file must reach 100, not the average.
     coverageThreshold: { "./src/**/*.service.ts": { ...COVERAGE_THRESHOLD } },
     coverageDirectory: "coverage",
-    coverageReporters: ["text-summary", "text"],
+    // lcov is what Sonar imports (coverage/lcov.info); text-summary and text are what the developer reads.
+    coverageReporters: ["text-summary", "text", "lcov"],
     projects: [
       {
         ...shared,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/jest-preset",
-  "version": "2.2.1",
+  "version": "2.2.3",
   "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(), recordingOutbox(), FakeClock, fakeIds(), builder() and the Outcome matchers toBeRefused/toSucceedWith.",
   "license": "UNLICENSED",
   "private": false,
@@ -51,7 +51,7 @@
   "files": [
     "*.cjs",
     "*.d.ts",
-    "!*.test.*",
+    "!*.spec.*",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -66,7 +66,7 @@
     "@jest/globals": ">=29"
   },
   "scripts": {
-    "test": "node --test \"*.test.mjs\""
+    "test": "node --test \"*.spec.mjs\""
   },
   "peerDependenciesMeta": {
     "typeorm": {