@starci/jest-preset 2.5.1 → 2.5.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 2.5.3 - 2026-10-30
+
+- Changed: the message that names the managed sync command says `starci app sync --execute`.
+
+## 2.5.2 - 2026-10-30
+
+- Added: `coverage.files` of the rendered be/jest.config.js: the files a slot declares as logic (hfs 4.11.20 `logic`) are collected and held to 100 per file like the logic roles; a config rendered without `files` loads as before. Specs: `test/coverage-scoped.spec.ts`, `test/preset.spec.ts`.
+
 ## 2.5.1 - 2026-10-29
 
 - Fixed: `fakeTransaction` records a `query` that calls a migration's database function the way `callDbFunction` writes it (`SELECT * FROM "<schema>"."<fn>"(...)`, any schema but `pg_catalog`) as a write, so a rolled-back inbox claim or event send appears in `rolledBackWrites`; any other `SELECT` stays a read.

package/README.md

@@ -5,13 +5,13 @@ The jest config of a Nest repository and the one shared unit-test double kit (`m
 ```js
 // jest.config.js (a managed file: `starci app sync` renders it, `starci app check` compares it; do not edit)
 module.exports = require("@starci/jest-preset").starciJestConfig({
-  coverage: { roots, roles, excludes },
+  coverage: { roots, roles, files, excludes },
 })
 ```
 
 The only option is `coverage`: the measured scope `starci app sync` derives once from the slot manifest
-(`scripts/hfs/coverage-scope.mjs`, R204 `HFS_COVERAGE_SCOPE_DRIFT`) — the measured roots, the roles a measured file carries
-and the exclusions. A repository has no other jest setting to tune.
+(`scripts/hfs/coverage-scope.mjs`, R204 `HFS_COVERAGE_SCOPE_DRIFT`) — the measured roots, the roles a measured file carries,
+the logic files a slot declares (`logic`) and the exclusions. A repository has no other jest setting to tune.
 
 ## What it sets
 
@@ -32,9 +32,9 @@ and the exclusions. A repository has no other jest setting to tune.
   (`src/tests/tsconfig.json`), and `test:integration`/`test:e2e`/`test:contract` run `typecheck:tests` first, so no world spec
   runs on code that does not type-check.
 - **Coverage of the measured logic, per-file 100.** `collectCoverageFrom` is one glob per `coverage.roots` entry covering `<root>/**/*.{<roles>}.ts`
-  (the `ruleParams.be.logicRoles` of the rendered scope), minus its `excludes`, `dist` and `coverage`, and `coverageThreshold` holds
-  `{ lines: 100, branches: 100, functions: 100, statements: 100 }` on one union glob of those roots. Jest applies a glob threshold to each file on its own, so every file of a
-  `ruleParams.be.logicRoles` role inside a measured slot must reach 100 on every metric (an average never passes). The
+  (the `ruleParams.be.logicRoles` of the rendered scope) plus each `coverage.files` entry (a logic file its slot declares), minus its `excludes`, `dist` and `coverage`, and `coverageThreshold` holds
+  `{ lines: 100, branches: 100, functions: 100, statements: 100 }` on one union glob of those roots and files. Jest applies a glob threshold to each file on its own, so every file of a
+  `ruleParams.be.logicRoles` role inside a measured slot, and every declared logic file, must reach 100 on every metric (an average never passes). The
   managed `test` script runs the unit project with `--coverage` and fails below it. Coverage is measured by v8, which counts the
   real source. The unit project overlays `isolatedModules: true`, `importHelpers: true` and `sourceMap: true` on the repository tsconfig, so ts-jest
   transpiles each file without building a type program. `unit-metadata.js`, a ts-jest wrapper and after-transformer, maps

package/dist/index.d.ts

@@ -19,10 +19,15 @@ export type { RecordingEventBus } from "./event-bus.js";
 export type { RecordingQueueOutbox } from "./queue.js";
 export type { FakeInbox } from "./inbox.js";
 export type { RefusalReason } from "./matchers.js";
-/** The coverage scope `starci app sync` renders from the slot manifest: the measured roots (a directory pattern per measured slot, a placeholder folder written as a star), the logic roles measured in them and the directories inside a root that are never measured (each ending in a double star). */
+/**
+ * The coverage scope `starci app sync` renders from the slot manifest: the measured roots (a directory pattern per measured slot, a placeholder
+ * folder written as a star), the logic roles measured in them, the logic files a slot declares (`logic`: a file that carries logic without a
+ * logic-role suffix, measured like one) and the directories inside a root that are never measured (each ending in a double star).
+ */
 export interface StarciCoverageScope {
     readonly roots: readonly string[];
     readonly roles: readonly string[];
+    readonly files?: readonly string[];
     readonly excludes: readonly string[];
 }
 export interface StarciJestOptions {
@@ -46,10 +51,11 @@ export type StarciJestConfig = Omit<Config, "projects" | "coverageReporters" | "
 };
 /**
  * Coverage is measured where logic runs: every file `<name>.<role>.ts` of a LOGIC role (service, policy, projection, guard, mapper, client, ...)
- * inside the roots the slot manifest marks `coverage: required` (the modules of the back end: domain, integrations, platform, projections).
+ * inside the roots the slot manifest marks `coverage: required` (the modules of the back end: domain, integrations, platform, projections), and
+ * every logic file such a slot declares (`logic`: a file that carries logic without a logic-role suffix).
  * The features (handlers, resolvers, controllers, consumers, processors, steps, sagas, cli commands) are thin by rule (BE_FEATURE_THIN) and are
  * never measured. The scope is NOT written here: `starci app sync` renders it from the manifest (scripts/hfs/coverage-scope.mjs) into the repository's
- * jest.config.js as `starciJestConfig({ coverage: { roots, roles, excludes } })`, and the same derivation renders Sonar's
+ * jest.config.js as `starciJestConfig({ coverage: { roots, roles, files, excludes } })`, and the same derivation renders Sonar's
  * `sonar.coverage.exclusions` and the Codecov paths and components, so the three can never disagree. Every measured file must reach 100 on every metric.
  * The unit run also writes `coverage/lcov.info`: Sonar and Codecov import it.
  */
@@ -64,8 +70,8 @@ declare const COVERAGE_THRESHOLD: Readonly<{
 /** The glob one measured root stands for: every file of a logic role below it. */
 declare function rootGlob(root: string, roles: readonly string[]): string;
 /**
- * jest's `collectCoverageFrom` of a coverage scope `{ roots, roles, excludes }`: the glob of every root, then the none directories inside a
- * root (`excludes`, each a glob that ends in `**`) and the generated folders as negations.
+ * jest's `collectCoverageFrom` of a coverage scope `{ roots, roles, files, excludes }`: the glob of every root, every declared logic file, then
+ * the none directories inside a root (`excludes`, each a glob that ends in `**`) and the generated folders as negations.
  */
 declare function collectCoverageFrom(coverage: StarciCoverageScope): string[];
 /**

package/dist/index.js

@@ -37,10 +37,11 @@ Object.defineProperty(exports, "FakeIds", { enumerable: true, get: function () {
 const SONAR_EXCLUSIONS = require("./sonar-exclusions.js");
 /**
  * Coverage is measured where logic runs: every file `<name>.<role>.ts` of a LOGIC role (service, policy, projection, guard, mapper, client, ...)
- * inside the roots the slot manifest marks `coverage: required` (the modules of the back end: domain, integrations, platform, projections).
+ * inside the roots the slot manifest marks `coverage: required` (the modules of the back end: domain, integrations, platform, projections), and
+ * every logic file such a slot declares (`logic`: a file that carries logic without a logic-role suffix).
  * The features (handlers, resolvers, controllers, consumers, processors, steps, sagas, cli commands) are thin by rule (BE_FEATURE_THIN) and are
  * never measured. The scope is NOT written here: `starci app sync` renders it from the manifest (scripts/hfs/coverage-scope.mjs) into the repository's
- * jest.config.js as `starciJestConfig({ coverage: { roots, roles, excludes } })`, and the same derivation renders Sonar's
+ * jest.config.js as `starciJestConfig({ coverage: { roots, roles, files, excludes } })`, and the same derivation renders Sonar's
  * `sonar.coverage.exclusions` and the Codecov paths and components, so the three can never disagree. Every measured file must reach 100 on every metric.
  * The unit run also writes `coverage/lcov.info`: Sonar and Codecov import it.
  */
@@ -54,15 +55,19 @@ function rootGlob(root, roles) {
     return `${root}**/*.${roles.length === 1 ? roles[0] : `{${roles.join(",")}}`}.ts`;
 }
 /**
- * jest's `collectCoverageFrom` of a coverage scope `{ roots, roles, excludes }`: the glob of every root, then the none directories inside a
- * root (`excludes`, each a glob that ends in `**`) and the generated folders as negations.
+ * jest's `collectCoverageFrom` of a coverage scope `{ roots, roles, files, excludes }`: the glob of every root, every declared logic file, then
+ * the none directories inside a root (`excludes`, each a glob that ends in `**`) and the generated folders as negations.
  */
 function collectCoverageFrom(coverage) {
-    return [...coverage.roots.map((root) => rootGlob(root, coverage.roles)), ...[...coverage.excludes, ...COVERAGE_EXCLUDES].map((glob) => `!${glob}`)];
+    return [
+        ...coverage.roots.map((root) => rootGlob(root, coverage.roles)),
+        ...(coverage.files ?? []),
+        ...[...coverage.excludes, ...COVERAGE_EXCLUDES].map((glob) => `!${glob}`),
+    ];
 }
-/** One union glob keeps Jest's per-file checks while a scoped map may contain files from only one measured root. */
+/** One union glob keeps Jest's per-file checks while a scoped map may contain files from only one measured root or declared logic file. */
 function coverageThresholdOf(coverage, root) {
-    const rootGlobs = coverage.roots.map((entry) => rootGlob(entry, coverage.roles)).filter((glob) => hasCoverageSubjects(root, glob));
+    const rootGlobs = [...coverage.roots.map((entry) => rootGlob(entry, coverage.roles)), ...(coverage.files ?? [])].filter((glob) => hasCoverageSubjects(root, glob));
     if (rootGlobs.length === 0)
         return {};
     const glob = rootGlobs.length === 1 ? rootGlobs[0] : `{${rootGlobs.join(",")}}`;
@@ -215,16 +220,20 @@ function hasCoverageSubjects(root, glob) {
 const isList = (value) => Array.isArray(value) && value.every((item) => typeof item === "string" && item.length > 0);
 /** A property of an unknown value, `undefined` when the value is not an object that has it. */
 const fieldOf = (value, name) => (typeof value === "object" && value !== null && name in value ? Reflect.get(value, name) : undefined);
-/** The scope `{ roots, roles, excludes }` of an options object, or a refusal: the scope is rendered by `starci app sync`, never defaulted. */
+/**
+ * The scope `{ roots, roles, files, excludes }` of an options object, or a refusal: the scope is rendered by `starci app sync`, never defaulted.
+ * `files` (the declared logic files) is absent from a config rendered before slots could declare them, and is then empty.
+ */
 function coverageOf(options) {
     const coverage = fieldOf(options, "coverage");
     const roots = fieldOf(coverage, "roots");
     const roles = fieldOf(coverage, "roles");
+    const files = fieldOf(coverage, "files") ?? [];
     const excludes = fieldOf(coverage, "excludes");
-    if (!coverage || !isList(roots) || !isList(roles) || !roles.length || !isList(excludes)) {
-        throw new Error("starciJestConfig({ coverage: { roots, roles, excludes } }) needs the coverage scope starci app sync renders from the slot manifest; run \"npx starci app sync --write\"");
+    if (!coverage || !isList(roots) || !isList(roles) || !roles.length || !isList(files) || !isList(excludes)) {
+        throw new Error("starciJestConfig({ coverage: { roots, roles, files, excludes } }) needs the coverage scope starci app sync renders from the slot manifest; run \"npx starci app sync --execute\"");
     }
-    return { roots, roles, excludes };
+    return { roots, roles, files, excludes };
 }
 /** The whole jest config: projects `unit`, `integration`, `e2e` and `contract`. It takes the coverage scope the managed repository config renders; without it it refuses. */
 function starciJestConfig(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/jest-preset",
-  "version": "2.5.1",
+  "version": "2.5.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(), fakeQueryBuilder(), queueQueryBuilders(), fakeCache(), fakeLock(), recordingEventBus(), recordingQueueOutbox(), fakeInbox(), FakeClock, fakeIds(), builder() and the Outcome matchers toBeRefused/toSucceedWith.",
   "license": "MIT",
   "author": "starci183",