@application-kit/testing 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @application-kit/testing
 
+## 0.3.0
+
+### Minor Changes
+
+- 2e91985: Вход `/vitest`: фабрики `defineApplicationUnitConfig` и `defineApplicationEndToEndConfig` — `vitest.config` и
+  `vitest.config.e2e` приложения поверх экспорта его `vite.config`. Unit — проекты `server` и `client`, ячейка шарда CI по
+  `--shard` и `ProjectShardSequencer`, покрытие v8; e2e — окружение `node` и алиас `graphql` на CJS-вход против двух realm
+  у mercurius. Оба профиля — кеш `.vitest-module-cache`, `testTimeout` 20 с, inline `@application-kit/graphql`. Спеки,
+  исходники клиента, покрытие, `setupFiles` и дополнительные пакеты для inline — параметры. Новый optional peer входа —
+  `vite`.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -1,7 +1,8 @@
 # @application-kit/testing
 
 Тестовая инфраструктура NestJS-приложений: стабы шин CQRS, логгер-накопитель, фейковый microservice-транспорт,
-сборка web-приложения для e2e, Postgres в testcontainers и раскладка ячеек CI по проектам vitest (вход `/vitest`).
+сборка web-приложения для e2e, Postgres в testcontainers, конфиги vitest приложения и раскладка ячеек CI по проектам
+vitest (вход `/vitest`).
 Для `devDependencies` приложения, в прод не попадает.
 
 ## Установка
@@ -12,7 +13,8 @@ yarn add --dev @application-kit/testing
 
 Peer-зависимости: `@nestjs/common`, `@nestjs/core`, `@nestjs/cqrs`,
 `@nestjs/microservices`, `@nestjs/platform-fastify`, `@nestjs/testing`, `nestjs-pino`, `oxide.ts`, `rxjs`,
-`testcontainers`, `typeorm` — обязательные для корневого входа. Вход `/vitest` несёт свой optional peer `vitest`.
+`testcontainers`, `typeorm` — обязательные для корневого входа. Вход `/vitest` несёт свои optional peers `vitest` и
+`vite` (`mergeConfig` фабрик конфигов).
 
 ## Состав
 
@@ -34,32 +36,61 @@ const { dataSource } = await testDataSource({
 })
 ```
 
-## Вход `/vitest`: ячейки CI по проектам
+## Вход `/vitest`: конфиги vitest приложения
+
+`defineApplicationUnitConfig(options)` и `defineApplicationEndToEndConfig(options)` собирают `vitest.config` и
+`vitest.config.e2e` поверх экспорта `vite.config` приложения (`viteConfig` — объект, `mergeConfig` из `vite`):
+
+```ts
+import { defineApplicationEndToEndConfig, defineApplicationUnitConfig } from '@application-kit/testing/vitest'
+
+import viteConfig from './vite.config.mjs'
+
+const E2E_SPECS = ['src/modules/*/tests/*.spec.ts']
+
+// vitest.config.mts
+export default defineApplicationUnitConfig({
+  clientSources: ['src/modules/*/user-interface/client/**'],
+  clientSpecs: ['src/modules/*/user-interface/client/**/*.spec.ts'],
+  coverage: { exclude: ['**/*.module.ts'], include: ['src'], thresholds: { lines: 95 } },
+  excludeSpecs: E2E_SPECS,
+  root: import.meta.dirname,
+  setupFiles: ['./src/testing/fast-hashing.ts'],
+  specs: ['src/**/*.spec.ts'],
+  viteConfig,
+})
+
+// vitest.config.e2e.mts
+export default defineApplicationEndToEndConfig({
+  coverage: { include: E2E_SPECS, thresholds: { 100: true } },
+  root: import.meta.dirname,
+  setupFiles: ['./src/testing/e2e-environment.ts'],
+  specs: E2E_SPECS,
+  viteConfig,
+})
+```
+
+Спеки, исходники клиента, покрытие (глобы, исключения, пороги), `setupFiles` и дополнительные пакеты для
+`server.deps.inline` (`inlineDependencies`) — у приложения. Фабрики решают сами:
+
+- оба профиля — `globals`, `isolate: false`, `testTimeout` 20 с (таймаут ловит зависший промис, а не медленный раннер),
+  кеш трансформов `.vitest-module-cache` (путь — контракт кеша джоб `ts:test:*` шаблона CI), покрытие v8 с отчётом
+  `text` и `skipFull`; `@application-kit/graphql` идёт через Vite, а не нативно через Node — иначе ошибка из пакета и код
+  приложения видят разные копии `graphql`, и `instanceof GraphQLError` ложен;
+- unit — проекты `server` (`node`, спеки `specs` без `excludeSpecs` и `clientSpecs`) и `client` (`jsdom`, `clientSpecs`),
+  ячейки шарда CI и `ProjectShardSequencer` (ниже);
+- e2e — окружение `node` и алиас `graphql` на CJS-вход `node_modules/graphql/index.js` под `root`: Vite для SSR берёт
+  ESM-сборку `graphql`, внешний `mercurius` — CJS, и без алиаса схема и валидация запроса живут в разных realm.
+
+## Ячейки CI по проектам
 
 `vitest --shard=i/n` сам режет спеки хешем, и при двух проектах разных трансформов (`server` в `node`, `client` в
 `jsdom`) объединение blob-отчётов покрытия неточное: непокрытые файлы одна ячейка синтезирует ssr-картой, а другая даёт
 web-карту того же файла, и statements/functions задваиваются. `ProjectShardSequencer` отдаёт первой ячейке проект
 `client` целиком, остальным — проект `server` по размеру спек (LPT, одна и та же раскладка в каждой ячейке без обмена
 данными). `parseShard(process.argv)` читает `--shard=i/n` и `--shard i/n`; без флага, с одной ячейкой или с мусором в
-значении — `undefined`, то есть обычный прогон (и `--merge-reports`, и Stryker). Каталоги проекта `client` и выбор
-ячейки — у приложения:
+значении — `undefined`, то есть обычный прогон (и `--merge-reports`, и Stryker).
 
-```ts
-import { parseShard, ProjectShardSequencer } from '@application-kit/testing/vitest'
-
-// Исходники, которые загружает только проект client: в ячейках server они не считаются вовсе.
-const CLIENT_SOURCES = ['src/modules/*/user-interface/client/**']
-const shard = parseShard(process.argv)
-const cell = shard === undefined ? 'all' : shard.index === 1 ? 'client' : 'server'
-
-export default defineConfig({
-  test: {
-    coverage: {
-      exclude: cell === 'server' ? CLIENT_SOURCES : [],
-      include: cell === 'client' ? CLIENT_SOURCES : ['src'],
-    },
-    projects: [serverProject, clientProject].filter((project) => cell === 'all' || project.test.name === cell),
-    sequence: { sequencer: ProjectShardSequencer },
-  },
-})
-```
+`defineApplicationUnitConfig` выбирает ячейку по `process.argv` в момент вызова: 1 — только проект `client` и покрытие
+по `clientSources`, 2..n — только проект `server` и покрытие без `clientSources`, без флага — оба проекта. Свой конфиг
+без фабрики собирается из `parseShard` и `ProjectShardSequencer` напрямую.

package/dist/cjs/vitest/application-vitest-config-options.interface.d.ts

@@ -0,0 +1,20 @@
+import type { UserConfig } from 'vite';
+import type { CoverageOptions } from 'vitest/node';
+export interface ApplicationTestConfigOptionsInterface {
+    coverage: CoverageScopeInterface;
+    inlineDependencies?: readonly string[];
+    root: string;
+    setupFiles: readonly string[];
+    specs: readonly string[];
+    viteConfig: UserConfig;
+}
+export interface ApplicationUnitConfigOptionsInterface extends ApplicationTestConfigOptionsInterface {
+    clientSources: readonly string[];
+    clientSpecs: readonly string[];
+    excludeSpecs: readonly string[];
+}
+export interface CoverageScopeInterface {
+    exclude?: readonly string[];
+    include: readonly string[];
+    thresholds: NonNullable<CoverageOptions['thresholds']>;
+}

package/dist/cjs/vitest/application-vitest-config-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/vitest/application-vitest-config.d.ts

@@ -0,0 +1,4 @@
+import type { ViteUserConfig } from 'vitest/config';
+import type { ApplicationTestConfigOptionsInterface, ApplicationUnitConfigOptionsInterface } from './application-vitest-config-options.interface.js';
+export declare const defineApplicationUnitConfig: (options: ApplicationUnitConfigOptionsInterface) => ViteUserConfig;
+export declare const defineApplicationEndToEndConfig: (options: ApplicationTestConfigOptionsInterface) => ViteUserConfig;

package/dist/cjs/vitest/application-vitest-config.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineApplicationEndToEndConfig = exports.defineApplicationUnitConfig = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const vite_1 = require("vite");
+const project_shard_sequencer_js_1 = require("./project-shard-sequencer.js");
+const PACKAGES_THROUGH_VITE = ['@application-kit/graphql'];
+const TEST_TIMEOUT = 20_000;
+const cellOf = (argv) => {
+    const shard = (0, project_shard_sequencer_js_1.parseShard)(argv);
+    if (shard === undefined) {
+        return 'all';
+    }
+    return shard.index === 1 ? 'client' : 'server';
+};
+const coverageOf = (scope) => ({
+    clean: true,
+    cleanOnRerun: true,
+    exclude: [...(scope.exclude ?? [])],
+    include: [...scope.include],
+    provider: 'v8',
+    reporter: ['text'],
+    skipFull: true,
+    thresholds: scope.thresholds,
+});
+const sharedTestOptions = (options) => ({
+    experimental: { fsModuleCache: true, fsModuleCachePath: '.vitest-module-cache' },
+    globals: true,
+    isolate: false,
+    server: { deps: { inline: [...PACKAGES_THROUGH_VITE, ...(options.inlineDependencies ?? [])] } },
+    setupFiles: [...options.setupFiles],
+    testTimeout: TEST_TIMEOUT,
+});
+const serverProject = (options) => ({
+    extends: true,
+    test: {
+        environment: 'node',
+        exclude: [...options.excludeSpecs, ...options.clientSpecs],
+        include: [...options.specs],
+        name: 'server',
+    },
+});
+const clientProject = (options) => ({
+    extends: true,
+    test: { environment: 'jsdom', include: [...options.clientSpecs], name: 'client' },
+});
+const PROJECTS_OF_CELL = {
+    all: [serverProject, clientProject],
+    client: [clientProject],
+    server: [serverProject],
+};
+const unitCoverageScope = (cell, options) => ({
+    exclude: [...(cell === 'server' ? options.clientSources : []), ...(options.coverage.exclude ?? [])],
+    include: cell === 'client' ? options.clientSources : options.coverage.include,
+    thresholds: options.coverage.thresholds,
+});
+const defineApplicationUnitConfig = (options) => {
+    const cell = cellOf(node_process_1.default.argv);
+    return (0, vite_1.mergeConfig)(options.viteConfig, {
+        root: options.root,
+        test: {
+            ...sharedTestOptions(options),
+            coverage: coverageOf(unitCoverageScope(cell, options)),
+            projects: PROJECTS_OF_CELL[cell].map((project) => project(options)),
+            sequence: { sequencer: project_shard_sequencer_js_1.ProjectShardSequencer },
+        },
+    });
+};
+exports.defineApplicationUnitConfig = defineApplicationUnitConfig;
+const defineApplicationEndToEndConfig = (options) => {
+    const graphql = node_path_1.default.resolve(options.root, 'node_modules/graphql/index.js');
+    return (0, vite_1.mergeConfig)(options.viteConfig, {
+        resolve: { alias: { graphql } },
+        root: options.root,
+        test: {
+            ...sharedTestOptions(options),
+            coverage: coverageOf(options.coverage),
+            environment: 'node',
+            include: [...options.specs],
+        },
+    });
+};
+exports.defineApplicationEndToEndConfig = defineApplicationEndToEndConfig;

package/dist/cjs/vitest/index.d.ts

@@ -1 +1,3 @@
+export * from './application-vitest-config.js';
+export * from './application-vitest-config-options.interface.js';
 export * from './project-shard-sequencer.js';

package/dist/cjs/vitest/index.js

@@ -14,4 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./application-vitest-config.js"), exports);
+__exportStar(require("./application-vitest-config-options.interface.js"), exports);
 __exportStar(require("./project-shard-sequencer.js"), exports);

package/dist/esm/vitest/application-vitest-config-options.interface.d.ts

@@ -0,0 +1,20 @@
+import type { UserConfig } from 'vite';
+import type { CoverageOptions } from 'vitest/node';
+export interface ApplicationTestConfigOptionsInterface {
+    coverage: CoverageScopeInterface;
+    inlineDependencies?: readonly string[];
+    root: string;
+    setupFiles: readonly string[];
+    specs: readonly string[];
+    viteConfig: UserConfig;
+}
+export interface ApplicationUnitConfigOptionsInterface extends ApplicationTestConfigOptionsInterface {
+    clientSources: readonly string[];
+    clientSpecs: readonly string[];
+    excludeSpecs: readonly string[];
+}
+export interface CoverageScopeInterface {
+    exclude?: readonly string[];
+    include: readonly string[];
+    thresholds: NonNullable<CoverageOptions['thresholds']>;
+}

package/dist/esm/vitest/application-vitest-config-options.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/vitest/application-vitest-config.d.ts

@@ -0,0 +1,4 @@
+import type { ViteUserConfig } from 'vitest/config';
+import type { ApplicationTestConfigOptionsInterface, ApplicationUnitConfigOptionsInterface } from './application-vitest-config-options.interface.js';
+export declare const defineApplicationUnitConfig: (options: ApplicationUnitConfigOptionsInterface) => ViteUserConfig;
+export declare const defineApplicationEndToEndConfig: (options: ApplicationTestConfigOptionsInterface) => ViteUserConfig;

package/dist/esm/vitest/application-vitest-config.js

@@ -0,0 +1,79 @@
+import path from 'node:path';
+import process from 'node:process';
+import { mergeConfig } from 'vite';
+import { parseShard, ProjectShardSequencer } from './project-shard-sequencer.js';
+const PACKAGES_THROUGH_VITE = ['@application-kit/graphql'];
+const TEST_TIMEOUT = 20_000;
+const cellOf = (argv) => {
+    const shard = parseShard(argv);
+    if (shard === undefined) {
+        return 'all';
+    }
+    return shard.index === 1 ? 'client' : 'server';
+};
+const coverageOf = (scope) => ({
+    clean: true,
+    cleanOnRerun: true,
+    exclude: [...(scope.exclude ?? [])],
+    include: [...scope.include],
+    provider: 'v8',
+    reporter: ['text'],
+    skipFull: true,
+    thresholds: scope.thresholds,
+});
+const sharedTestOptions = (options) => ({
+    experimental: { fsModuleCache: true, fsModuleCachePath: '.vitest-module-cache' },
+    globals: true,
+    isolate: false,
+    server: { deps: { inline: [...PACKAGES_THROUGH_VITE, ...(options.inlineDependencies ?? [])] } },
+    setupFiles: [...options.setupFiles],
+    testTimeout: TEST_TIMEOUT,
+});
+const serverProject = (options) => ({
+    extends: true,
+    test: {
+        environment: 'node',
+        exclude: [...options.excludeSpecs, ...options.clientSpecs],
+        include: [...options.specs],
+        name: 'server',
+    },
+});
+const clientProject = (options) => ({
+    extends: true,
+    test: { environment: 'jsdom', include: [...options.clientSpecs], name: 'client' },
+});
+const PROJECTS_OF_CELL = {
+    all: [serverProject, clientProject],
+    client: [clientProject],
+    server: [serverProject],
+};
+const unitCoverageScope = (cell, options) => ({
+    exclude: [...(cell === 'server' ? options.clientSources : []), ...(options.coverage.exclude ?? [])],
+    include: cell === 'client' ? options.clientSources : options.coverage.include,
+    thresholds: options.coverage.thresholds,
+});
+export const defineApplicationUnitConfig = (options) => {
+    const cell = cellOf(process.argv);
+    return mergeConfig(options.viteConfig, {
+        root: options.root,
+        test: {
+            ...sharedTestOptions(options),
+            coverage: coverageOf(unitCoverageScope(cell, options)),
+            projects: PROJECTS_OF_CELL[cell].map((project) => project(options)),
+            sequence: { sequencer: ProjectShardSequencer },
+        },
+    });
+};
+export const defineApplicationEndToEndConfig = (options) => {
+    const graphql = path.resolve(options.root, 'node_modules/graphql/index.js');
+    return mergeConfig(options.viteConfig, {
+        resolve: { alias: { graphql } },
+        root: options.root,
+        test: {
+            ...sharedTestOptions(options),
+            coverage: coverageOf(options.coverage),
+            environment: 'node',
+            include: [...options.specs],
+        },
+    });
+};

package/dist/esm/vitest/index.d.ts

@@ -1 +1,3 @@
+export * from './application-vitest-config.js';
+export * from './application-vitest-config-options.interface.js';
 export * from './project-shard-sequencer.js';

package/dist/esm/vitest/index.js

@@ -1 +1,3 @@
+export * from './application-vitest-config.js';
+export * from './application-vitest-config-options.interface.js';
 export * from './project-shard-sequencer.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@application-kit/testing",
-  "version": "0.2.0",
-  "description": "Тестовая инфраструктура NestJS-приложений: шины CQRS, логгер, фейковый microservice, сборка web-приложения, Postgres в testcontainers и раскладка ячеек CI по проектам vitest",
+  "version": "0.3.0",
+  "description": "Тестовая инфраструктура NestJS-приложений: шины CQRS, логгер, фейковый microservice, сборка web-приложения, Postgres в testcontainers, раскладка ячеек CI по проектам vitest и фабрики конфигов vitest",
   "keywords": [
     "cqrs",
     "nestjs",
@@ -76,6 +76,7 @@
     "testcontainers": "12.1.0",
     "typeorm": "^1.1.0",
     "typescript": "^6.0.3",
+    "vite": "^8.2.1",
     "vitest": "^4.1.11"
   },
   "peerDependencies": {
@@ -90,9 +91,13 @@
     "rxjs": "^7.8.2",
     "testcontainers": "^12.1.0",
     "typeorm": "^1.0.0",
+    "vite": "^8.0.0",
     "vitest": "^4.1.0"
   },
   "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
     "vitest": {
       "optional": true
     }