@starci/jest-preset 2.4.0 → 2.4.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.4.1 - 2026-10-28
+
+- Changed: `@starci/ai-router` joins the ESM-only dependencies jest compiles to CommonJS, so a spec that builds an AppModule registering the AI pool loads it.
+- Fixed: the built declarations name `.js` (`dist/index.d.ts` and `dist/entity-manager.d.ts` named `.ts` files a consumer tsc cannot read).
+- Fixed: the pair-mismatch message names state protocol 2 as test-world 1.1 and later write it, not "test-world 1.1.x"; release C pins this preset beside `@starci/test-world` 1.2.3, which speaks protocol 2.
+
 ## 2.4.0 - 2026-10-28
 
 - Changed: the source is TypeScript in `src/`, built to CommonJS JavaScript in `dist/` (`npm run build`; `prepack` builds), and the declarations are emitted from it instead of hand-written; `main`, `types` and every export (`.`, `./mock`, `./clock`, `./entity-manager`, `./ids`, `./matchers`, `./cache`, `./lock`, `./event-bus`, `./queue`, `./inbox`, `./builders`, `./merge`) point into `dist/`. No rule or behaviour changed; the specifiers are unchanged. The files jest loads by path are now `dist/world-runner.js`, `dist/unit-metadata.js`, `dist/unit-metadata.generated.js` (the coverage anchor, copied byte for byte from `assets/`) and `dist/lcov.js`; `@starci/jest-preset/merge` now has types.

package/dist/entity-manager.d.ts

@@ -17,7 +17,7 @@
  * rethrown) and which writes it made, so a spec can assert that a rolled-back transaction committed nothing.
  */
 import type { DeleteResult, EntityManager, InsertResult, UpdateResult } from "typeorm";
-import type { MockOf } from "./mock.ts";
+import type { MockOf } from "./mock.js";
 /** A typed double of `EntityManager`: assignable wherever an `EntityManager` is required, every method a jest mock. */
 export type MockEntityManager = MockOf<EntityManager>;
 /** An entity class. */

package/dist/index.d.ts

@@ -1,22 +1,22 @@
 import type { Config } from "jest";
-import { mock, createMock } from "./mock.ts";
-import { mockEntityManager, fakeTransaction } from "./entity-manager.ts";
-import { FakeClock } from "./clock.ts";
-import { fakeCache } from "./cache.ts";
-import { fakeLock } from "./lock.ts";
-import { recordingEventBus } from "./event-bus.ts";
-import { recordingQueueOutbox } from "./queue.ts";
-import { fakeInbox } from "./inbox.ts";
-import { builder } from "./builders.ts";
-import { fakeIds, FakeIds } from "./ids.ts";
-export type { MockOf } from "./mock.ts";
-export type { MockEntityManager, FakeTransaction, EntityClass } from "./entity-manager.ts";
-export type { FakeCache } from "./cache.ts";
-export type { FakeLock } from "./lock.ts";
-export type { RecordingEventBus } from "./event-bus.ts";
-export type { RecordingQueueOutbox } from "./queue.ts";
-export type { FakeInbox } from "./inbox.ts";
-export type { RefusalReason } from "./matchers.ts";
+import { mock, createMock } from "./mock.js";
+import { mockEntityManager, fakeTransaction } from "./entity-manager.js";
+import { FakeClock } from "./clock.js";
+import { fakeCache } from "./cache.js";
+import { fakeLock } from "./lock.js";
+import { recordingEventBus } from "./event-bus.js";
+import { recordingQueueOutbox } from "./queue.js";
+import { fakeInbox } from "./inbox.js";
+import { builder } from "./builders.js";
+import { fakeIds, FakeIds } from "./ids.js";
+export type { MockOf } from "./mock.js";
+export type { MockEntityManager, FakeTransaction, EntityClass } from "./entity-manager.js";
+export type { FakeCache } from "./cache.js";
+export type { FakeLock } from "./lock.js";
+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). */
 export interface StarciCoverageScope {
     readonly roots: readonly string[];

package/dist/index.js

@@ -87,9 +87,10 @@ function transform(tsconfig) {
  * 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.
+ * run (ruling:R212/case-1, amended by ruling:R212/case-4), so a spec that imports its guard must load it. `@starci/ai-router`
+ * is the AI pool module a back end registers in its AppModule, so a spec that builds the AppModule must load it.
  */
-const ESM_ONLY_DEPENDENCIES = Object.freeze(["jose"]);
+const ESM_ONLY_DEPENDENCIES = Object.freeze(["jose", String.raw `@starci[\\/]ai-router`]);
 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 }] };

package/dist/world-runner.js

@@ -30,7 +30,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 const node_module_1 = require("node:module");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
-/** The state-file protocol of `@starci/test-world` this runner speaks (test-world 1.1.x). */
+/** The state-file protocol of `@starci/test-world` this runner speaks (test-world 1.1 and later). */
 const WORLD_STATE_VERSION = 2;
 /** The variable that carries the path of the world's state file (set by its globalSetup in this process). */
 const STATE_FILE_ENV = "STARCI_TEST_WORLD_STATE";
@@ -53,7 +53,7 @@ const fieldOf = (value, name) => (typeof value === "object" && value !== null &&
 /** The slot count the world published; a missing or foreign state file is a pair mismatch. */
 function worldSlots(env = process.env) {
     const file = env[STATE_FILE_ENV];
-    const fix = `pin @starci/test-world and @starci/jest-preset together as knowledge/hfs/canon-pins.yaml pairs them (${PRESET} speaks state protocol ${WORLD_STATE_VERSION}, @starci/test-world 1.1.x)`;
+    const fix = `pin @starci/test-world and @starci/jest-preset together as knowledge/hfs/canon-pins.yaml pairs them (${PRESET} speaks state protocol ${WORLD_STATE_VERSION}, as @starci/test-world 1.1 and later write it)`;
     if (file === undefined || file === "") {
         throw runnerError(WORLD_PAIR_MISMATCH, `${STATE_FILE_ENV} is not set: the world's globalSetup published no state file for ${PRESET}; ${fix}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starci/jest-preset",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "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",
   "author": "starci183",
@@ -88,7 +88,7 @@
     "typeorm": ">=0.3"
   },
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', {recursive: true, force: true})\" && tsc -p tsconfig.build.json && node -e \"require('node:fs').copyFileSync('assets/unit-metadata.generated.js', 'dist/unit-metadata.generated.js')\"",
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive: true, force: true})\" && tsc -p tsconfig.build.json && node -e \"const fs = require('node:fs'); for (const f of fs.readdirSync('dist', {recursive: true}).filter((n) => n.endsWith('.d.ts'))) fs.writeFileSync('dist/' + f, fs.readFileSync('dist/' + f, 'utf8').replace(/((?:from |import\\()['\\x22]\\.\\.?\\/[^'\\x22]+)\\.ts(['\\x22])/g, (all, head, quote) => head + '.js' + quote))\" && node -e \"require('node:fs').copyFileSync('assets/unit-metadata.generated.js', 'dist/unit-metadata.generated.js')\"",
     "typecheck": "tsc -p tsconfig.json",
     "prepack": "npm run build",
     "test": "npm run build && npm run typecheck && node --test \"test/**/*.spec.ts\""