@starci/jest-preset 2.2.6 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2.3.0 - 2026-10-16
+
+- Added: a declared lite app (the edition of the `hfs.json` above its `be/`) runs its existing integration and contract specs without a test world: those projects exist only when their spec files do, and neither the world runner nor the world global setup and teardown is attached to a lite run.
+- Changed: a full app without a test world keeps only the unit project (an unfinished full scaffold), as before; the cited ruling is now ruling:R212/case-1 amended by ruling:R212/case-4.
+
+## 2.2.7 - 2026-10-13
+
+- Fixed: the ESM-only runtime dependency `jose` (the Supabase access-token verifier of every lite back end) is compiled to CommonJS by ts-jest instead of being skipped with node_modules, so a lite app's unit run can load its guard (owner ruling 2026-10-12: lite keeps full's unit run).
+
 ## 2.2.6 - 2026-10-08
 
 - Fixed: the `integration`, `e2e` and `contract` projects match `**/src/tests/<layer>/**/*.<layer>-spec.ts` instead of a pattern prefixed with the root path. On Windows a root that holds a dot-named folder (a checkout under `.claude`) turned the path separator before it into a glob escape, so the contract run found 0 spec files ("No tests found") although they exist.

package/index.cjs

@@ -53,9 +53,25 @@ const TS_TRANSFORM = String.raw`^.+\.ts$`
  * does not type-check.
  */
 function transform(tsconfig) {
-  return { [TS_TRANSFORM]: ["ts-jest", { tsconfig, diagnostics: false }] }
+  return { [TS_TRANSFORM]: ["ts-jest", { tsconfig, diagnostics: false }], ...esmDependencyTransform() }
 }
 
+/**
+ * The runtime dependencies of a back end that ship ECMAScript modules only: jest's CommonJS runtime cannot load them, so their
+ * files are compiled to CommonJS like the repository's own (ts-jest with `allowJs`) instead of being skipped as node_modules.
+ * `jose` is the Supabase access-token verifier of every lite back end (be.integrations.supabase); a lite app keeps full's unit
+ * run (ruling:R212/case-1, amended by ruling:R212/case-4), so a spec that imports its guard must load it.
+ */
+const ESM_ONLY_DEPENDENCIES = Object.freeze(["jose"])
+const ESM_DEPENDENCY_TRANSFORM = String.raw`^.+[\\/]node_modules[\\/](?:${ESM_ONLY_DEPENDENCIES.join("|")})[\\/].+\.js$`
+
+function esmDependencyTransform() {
+  return { [ESM_DEPENDENCY_TRANSFORM]: ["ts-jest", { tsconfig: { allowJs: true, module: "commonjs", target: "es2022", esModuleInterop: true }, diagnostics: false }] }
+}
+
+/** node_modules stay untransformed except the ESM-only dependencies above. */
+const TRANSFORM_IGNORE_PATTERNS = Object.freeze([String.raw`[\\/]node_modules[\\/](?!(?:${ESM_ONLY_DEPENDENCIES.join("|")})[\\/])`])
+
 /**
  * The compiler options the UNIT project overlays on the repository tsconfig (ts-jest merges an inline `tsconfig` object over the
  * `tsconfig.json` it finds under `rootDir`). They exist so that per-file 100 coverage is reachable for a decorated service:
@@ -98,7 +114,7 @@ const underTests = (folder) => String.raw`[\\/]src[\\/]tests[\\/]` + folder + St
  * test tree compiles against `src/tests/tsconfig.json`, the nearest config of every file under `src/tests/`. The
  * integration, e2e and contract projects share the world's `global-setup.ts`/`global-teardown.ts` (`src/tests/world/`) and
  * run their spec files up to `min(--maxWorkers, slots)` at once, each in a worker process of its own bound to one data slot
- * of the test world (`world-runner.cjs`; a slot's data is reset when a file boots, so no two files ever share a slot); the unit project alone has a `setupFilesAfterEnv` (the Outcome matchers).
+ * of the test world (`world-runner.cjs`; a slot's data is reset when a file boots, so no two files ever share a slot). A declared lite app instead runs its existing integration and contract specs without a world, on jest's stock runner. The unit project alone has a `setupFilesAfterEnv` (the Outcome matchers).
  * Coverage is collected from the logic roles of the measured roots only (`coverage` option), with a per-file threshold of 100 on lines, branches, functions and
  * 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.
@@ -111,6 +127,16 @@ function hasTestWorld(root) {
   return require("node:fs").existsSync(require("node:path").join(root, "src", "tests", "world", "global-setup.ts"))
 }
 
+/** The managed config runs in `be/`, one level below the app's edition declaration. */
+function isLiteApp(root) {
+  try {
+    const file = require("node:path").join(root, "..", "hfs.json")
+    return JSON.parse(require("node:fs").readFileSync(file, "utf8")).edition === "lite"
+  } catch {
+    return false
+  }
+}
+
 /** Every alternative a `{a,b}` pattern spells, braces expanded left to right. */
 function braceVariants(value) {
   const match = /{([^{}]+)}/.exec(value)
@@ -173,26 +199,36 @@ function coverageOf(options) {
 
 function starciJestConfig(options) {
   const coverage = coverageOf(options)
+  const root = process.cwd()
+  const world = hasTestWorld(root)
   const shared = {
     preset: "ts-jest",
     testEnvironment: "node",
     rootDir: ".",
     roots: ["<rootDir>/src", "<rootDir>/apps"],
     moduleNameMapper: { ...MODULE_NAME_MAPPER },
+    transformIgnorePatterns: [...TRANSFORM_IGNORE_PATTERNS],
   }
   const suite = (displayName, suffix) => ({
     ...shared,
     transform: transform("src/tests/tsconfig.json"),
     displayName,
-    // Every spec file in a process of its own (never in band): nothing one file or the globalSetup put on a process global
-    // (a framework registry such as @nestjs/graphql's type metadata) reaches another file. See world-runner.cjs.
-    runner: WORLD_RUNNER,
     // A glob without the root's absolute path: jest's roots (src, apps) already bound the search, and a root path that holds a dot-named folder (a checkout under `.claude`) turns its backslash separator into a glob escape on Windows, so a path-prefixed pattern would match no file.
     testMatch: [`**/src/tests/${displayName}/**/*.${suffix}.ts`],
-    // The one test world: started once per run of a project that has a test to run, torn down after it.
-    globalSetup: "<rootDir>/src/tests/world/global-setup.ts",
-    globalTeardown: "<rootDir>/src/tests/world/global-teardown.ts",
+    // Full's world gives every spec file its own process and data slot; lite needs neither its runner nor its hooks.
+    ...(world ? {
+      runner: WORLD_RUNNER,
+      globalSetup: "<rootDir>/src/tests/world/global-setup.ts",
+      globalTeardown: "<rootDir>/src/tests/world/global-teardown.ts",
+    } : {}),
   })
+  const testProjects = world ? [suite("integration", "integration-spec"), suite("e2e", "e2e-spec"), suite("contract", "contract-spec")] : []
+  if (!world && isLiteApp(root)) {
+    for (const name of ["integration", "contract"]) {
+      const suffix = `${name}-spec`
+      if (hasCoverageSubjects(root, `src/tests/${name}/**/*.${suffix}.ts`)) testProjects.push(suite(name, suffix))
+    }
+  }
   return {
     testTimeout: 120_000,
     coverageProvider: "v8",
@@ -213,10 +249,9 @@ function starciJestConfig(options) {
         testMatch: ["**/*.spec.ts"],
         testPathIgnorePatterns: ["/node_modules/", ...TEST_KIND_FOLDERS.map(underTests)],
       },
-      // The integration, e2e and contract projects exist only where the repository has its test world: jest validates
-      // every project's globalSetup even under --selectProjects unit, so a repository whose world is not written yet
-      // would otherwise fail to run its unit specs with the managed config.
-      ...(hasTestWorld(process.cwd()) ? [suite("integration", "integration-spec"), suite("e2e", "e2e-spec"), suite("contract", "contract-spec")] : []),
+      // Jest validates every project's world hooks even under --selectProjects unit. An unfinished full scaffold
+      // keeps only unit; a lite app's present integration/contract lanes need no test world.
+      ...testProjects,
     ],
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/jest-preset",
-  "version": "2.2.6",
+  "version": "2.3.0",
   "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,