@application-kit/testing 0.0.0-stage → 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @application-kit/testing
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Тестовая инфраструктура NestJS-приложений: стабы шин CQRS, логгер-накопитель, фейковый microservice-транспорт,
+сборка web-приложения для e2e и Postgres в testcontainers. Для `devDependencies` приложения, в прод не попадает.
+
+## Установка
+
+```sh
+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`. Все обязательные: подпутей и опциональных peers нет.
+
+## Состав
+
+- `TestLogger` — наследует `PinoLogger`, складывает вызовы в `debugs` / `errors` / `infos` / `warns`.
+- `TestCommandBus` / `asCommandBus`, `TestQueryBus` / `asQueryBus` — стабы шин: фиксируют `executed`, отдают заданный результат.
+- `TestEventBus` — `EventBus`, который копит события в `events`.
+- `FakeMicroserviceStrategy` — транспорт microservice без сети.
+- `buildWebApplication(imports, overrides, options)` — Fastify-приложение из реальных модулей с подменой провайдеров;
+  `testQueryRunner` закрепляет `QueryRunner` (отключается `pinQueryRunner: false`).
+- `startPostgresContainer(image)`, `testDataSource({ image, migrations, entities, … })` — Postgres в контейнере и
+  инициализированный `DataSource`. Образ и стратегию имён передаёт приложение: версия БД и именование — его решение, у пакета их нет.
+
+```ts
+const { dataSource } = await testDataSource({
+  entities: [UserOrmEntity],
+  image: 'postgres:18.3-alpine3.23',
+  migrations: [UserMigration],
+  namingStrategy: new TypeormPluralNamingStrategy(),
+})
+```

package/dist/cjs/build-web-application.d.ts

@@ -0,0 +1,10 @@
+import type { InjectionToken, ModuleMetadata } from '@nestjs/common';
+import type { NestFastifyApplication } from '@nestjs/platform-fastify';
+export interface BuildWebApplicationOptionsInterface {
+    pinQueryRunner?: boolean;
+}
+export interface ProviderOverrideInterface {
+    provide: InjectionToken;
+    useValue: unknown;
+}
+export declare const buildWebApplication: (importModules: NonNullable<ModuleMetadata["imports"]>, overrides?: ProviderOverrideInterface[], options?: BuildWebApplicationOptionsInterface) => Promise<NestFastifyApplication>;

package/dist/cjs/build-web-application.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWebApplication = void 0;
+const platform_fastify_1 = require("@nestjs/platform-fastify");
+const testing_1 = require("@nestjs/testing");
+const nestjs_pino_1 = require("nestjs-pino");
+const test_query_runner_js_1 = require("./test-query-runner.js");
+const queryRunnerProviders = (options) => (options.pinQueryRunner === false ? [] : [test_query_runner_js_1.testQueryRunner]);
+const buildWebApplication = async (importModules, overrides = [], options = {}) => {
+    const builder = testing_1.Test.createTestingModule({
+        imports: importModules,
+        providers: queryRunnerProviders(options),
+    });
+    for (const override of overrides) {
+        builder.overrideProvider(override.provide).useValue(override.useValue);
+    }
+    const moduleFixture = await builder.compile();
+    const app = moduleFixture.createNestApplication(new platform_fastify_1.FastifyAdapter());
+    app.useLogger(app.get(nestjs_pino_1.Logger));
+    await app.init();
+    return app;
+};
+exports.buildWebApplication = buildWebApplication;

package/dist/cjs/fake-microservice/fake-microservice-strategy.d.ts

@@ -0,0 +1,12 @@
+import type { CustomTransportStrategy, ReadPacket, WritePacket } from '@nestjs/microservices';
+import { Server } from '@nestjs/microservices';
+import { Subject } from 'rxjs';
+export declare class FakeMicroserviceStrategy extends Server implements CustomTransportStrategy {
+    private readonly client;
+    private readonly server;
+    close(): void;
+    handleMessage(packet: ReadPacket): Promise<void>;
+    listen(listenCallback: () => void): void;
+    on(): void;
+    unwrap(): Subject<WritePacket<string>>;
+}

package/dist/cjs/fake-microservice/fake-microservice-strategy.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeMicroserviceStrategy = void 0;
+const microservices_1 = require("@nestjs/microservices");
+const rxjs_1 = require("rxjs");
+class FakeMicroserviceStrategy extends microservices_1.Server {
+    client = new rxjs_1.Subject();
+    server = new rxjs_1.Subject();
+    close() {
+    }
+    async handleMessage(packet) {
+        const pattern = typeof packet.pattern === 'string' ? packet.pattern : '';
+        if (pattern === '') {
+            return;
+        }
+        const handler = this.getHandlerByPattern(pattern);
+        if (handler === null) {
+            return;
+        }
+        const context = new microservices_1.BaseRpcContext([packet.pattern]);
+        const response = this.transformToObservable(await handler(packet.data, context));
+        this.send(response, (data) => {
+            if (data.err === undefined) {
+                this.server.next(data);
+            }
+            else {
+                this.server.error(data.err);
+            }
+        });
+    }
+    listen(listenCallback) {
+        this.client.subscribe({
+            next: (packet) => {
+                void this.handleMessage(packet);
+            },
+        });
+        listenCallback();
+    }
+    on() {
+    }
+    unwrap() {
+        return this.server;
+    }
+}
+exports.FakeMicroserviceStrategy = FakeMicroserviceStrategy;

package/dist/cjs/fake-microservice/index.d.ts

@@ -0,0 +1 @@
+export * from './fake-microservice-strategy.js';

package/dist/cjs/fake-microservice/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./fake-microservice-strategy.js"), exports);

package/dist/cjs/index.d.ts

@@ -0,0 +1,8 @@
+export * from './fake-microservice/index.js';
+export * from './postgres/index.js';
+export * from './build-web-application.js';
+export * from './test-command-bus.js';
+export * from './test-event-bus.js';
+export * from './test-logger.js';
+export * from './test-query-bus.js';
+export * from './test-query-runner.js';

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./fake-microservice/index.js"), exports);
+__exportStar(require("./postgres/index.js"), exports);
+__exportStar(require("./build-web-application.js"), exports);
+__exportStar(require("./test-command-bus.js"), exports);
+__exportStar(require("./test-event-bus.js"), exports);
+__exportStar(require("./test-logger.js"), exports);
+__exportStar(require("./test-query-bus.js"), exports);
+__exportStar(require("./test-query-runner.js"), exports);

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

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

@@ -0,0 +1 @@
+export * from './test-data-source.js';

package/dist/cjs/postgres/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./test-data-source.js"), exports);

package/dist/cjs/postgres/test-data-source.d.ts

@@ -0,0 +1,20 @@
+import type { StartedTestContainer } from 'testcontainers';
+import type { EntitySchema, MixedList, NamingStrategyInterface, QueryRunner } from 'typeorm';
+import { DataSource } from 'typeorm';
+export declare const TEST_DATABASE_NAME = "db";
+export declare const TEST_DATABASE_PORT = 5432;
+export declare const startPostgresContainer: (image: string) => Promise<StartedTestContainer>;
+export interface TestDataSourceOptionsInterface {
+    entities: MixedList<EntitySchema | Function | string>;
+    image: string;
+    isLogging?: boolean;
+    migrations: MixedList<Function | string>;
+    namingStrategy: NamingStrategyInterface;
+    shouldSynchronize?: boolean;
+}
+export interface TestDataSourceResultInterface {
+    container: StartedTestContainer;
+    dataSource: DataSource;
+    queryRunner: QueryRunner;
+}
+export declare const testDataSource: ({ entities, image, isLogging, migrations, namingStrategy, shouldSynchronize, }: TestDataSourceOptionsInterface) => Promise<TestDataSourceResultInterface>;

package/dist/cjs/postgres/test-data-source.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testDataSource = exports.startPostgresContainer = exports.TEST_DATABASE_PORT = exports.TEST_DATABASE_NAME = void 0;
+const testcontainers_1 = require("testcontainers");
+const typeorm_1 = require("typeorm");
+exports.TEST_DATABASE_NAME = 'db';
+exports.TEST_DATABASE_PORT = 5432;
+const startPostgresContainer = async (image) => new testcontainers_1.GenericContainer(image)
+    .withStartupTimeout(120_000)
+    .withWaitStrategy(testcontainers_1.Wait.forLogMessage(/database system is ready to accept connections/u, 2))
+    .withEnvironment({
+    POSTGRES_DATABASE: exports.TEST_DATABASE_NAME,
+    POSTGRES_PASSWORD: exports.TEST_DATABASE_NAME,
+    POSTGRES_USER: exports.TEST_DATABASE_NAME,
+})
+    .withExposedPorts(exports.TEST_DATABASE_PORT)
+    .start();
+exports.startPostgresContainer = startPostgresContainer;
+const testDataSource = async ({ entities, image, isLogging = false, migrations, namingStrategy, shouldSynchronize = false, }) => {
+    const databaseName = exports.TEST_DATABASE_NAME;
+    const databasePort = exports.TEST_DATABASE_PORT;
+    const container = await (0, exports.startPostgresContainer)(image);
+    const databaseConfig = {
+        database: databaseName,
+        entities,
+        host: container.getHost(),
+        logging: isLogging,
+        maxQueryExecutionTime: 1000,
+        migrations,
+        migrationsRun: !shouldSynchronize,
+        namingStrategy,
+        password: databaseName,
+        port: container.getMappedPort(databasePort),
+        ssl: false,
+        subscribers: [],
+        synchronize: shouldSynchronize,
+        type: 'postgres',
+        username: databaseName,
+    };
+    const dataSource = new typeorm_1.DataSource(databaseConfig);
+    await dataSource.initialize();
+    const queryRunner = dataSource.createQueryRunner();
+    Object.assign(dataSource.manager, { queryRunner });
+    return { container, dataSource, queryRunner };
+};
+exports.testDataSource = testDataSource;

package/dist/cjs/test-command-bus.d.ts

@@ -0,0 +1,10 @@
+import type { CommandBus, ICommand } from '@nestjs/cqrs';
+export declare class TestCommandBus {
+    readonly executed: ICommand[];
+    private executeResult;
+    private readonly queuedResults;
+    execute<TResult = unknown>(command: ICommand): Promise<TResult>;
+    setExecuteResult(result: unknown): void;
+    setExecuteResults(results: unknown[]): void;
+}
+export declare const asCommandBus: (fake: TestCommandBus) => CommandBus;

package/dist/cjs/test-command-bus.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asCommandBus = exports.TestCommandBus = void 0;
+const oxide_ts_1 = require("oxide.ts");
+class TestCommandBus {
+    executed = [];
+    executeResult = (0, oxide_ts_1.Ok)('');
+    queuedResults = [];
+    async execute(command) {
+        await Promise.resolve();
+        this.executed.push(command);
+        const result = this.queuedResults.length > 0 ? this.queuedResults.shift() : this.executeResult;
+        return result;
+    }
+    setExecuteResult(result) {
+        this.executeResult = result;
+    }
+    setExecuteResults(results) {
+        this.queuedResults.splice(0, this.queuedResults.length, ...results);
+    }
+}
+exports.TestCommandBus = TestCommandBus;
+const asCommandBus = (fake) => fake;
+exports.asCommandBus = asCommandBus;

package/dist/cjs/test-event-bus.d.ts

@@ -0,0 +1,6 @@
+import { EventBus } from '@nestjs/cqrs';
+export declare class TestEventBus extends EventBus {
+    readonly events: Set<unknown>;
+    constructor();
+    cleanEvents(): void;
+}

package/dist/cjs/test-event-bus.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestEventBus = void 0;
+const cqrs_1 = require("@nestjs/cqrs");
+class TestEventBus extends cqrs_1.EventBus {
+    events = new Set();
+    constructor() {
+        const moduleReference = {};
+        const commandBus = {};
+        const unhandledExceptionBus = {};
+        super(commandBus, moduleReference, unhandledExceptionBus);
+        this.publisher = {
+            publish: (event) => {
+                this.events.add(event);
+            },
+        };
+    }
+    cleanEvents() {
+        this.events.clear();
+    }
+}
+exports.TestEventBus = TestEventBus;

package/dist/cjs/test-logger.d.ts

@@ -0,0 +1,15 @@
+import { PinoLogger } from 'nestjs-pino';
+export interface TestLogEntryInterface {
+    readonly args: readonly unknown[];
+}
+export declare class TestLogger extends PinoLogger {
+    readonly debugs: TestLogEntryInterface[];
+    readonly errors: TestLogEntryInterface[];
+    readonly infos: TestLogEntryInterface[];
+    readonly warns: TestLogEntryInterface[];
+    constructor();
+    debug(...arguments_: unknown[]): void;
+    error(...arguments_: unknown[]): void;
+    info(...arguments_: unknown[]): void;
+    warn(...arguments_: unknown[]): void;
+}

package/dist/cjs/test-logger.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestLogger = void 0;
+const nestjs_pino_1 = require("nestjs-pino");
+class TestLogger extends nestjs_pino_1.PinoLogger {
+    debugs = [];
+    errors = [];
+    infos = [];
+    warns = [];
+    constructor() {
+        super({});
+    }
+    debug(...arguments_) {
+        this.debugs.push({ args: arguments_ });
+    }
+    error(...arguments_) {
+        this.errors.push({ args: arguments_ });
+    }
+    info(...arguments_) {
+        this.infos.push({ args: arguments_ });
+    }
+    warn(...arguments_) {
+        this.warns.push({ args: arguments_ });
+    }
+}
+exports.TestLogger = TestLogger;

package/dist/cjs/test-query-bus.d.ts

@@ -0,0 +1,12 @@
+import type { IQuery, QueryBus } from '@nestjs/cqrs';
+export declare class TestQueryBus {
+    readonly executed: IQuery[];
+    private executeResult;
+    private readonly executeResultsByQuery;
+    execute<TResult = unknown>(query: IQuery): Promise<TResult>;
+    setExecuteResult(result: unknown): void;
+    setExecuteResultFor(queryClass: {
+        name: string;
+    }, result: unknown): void;
+}
+export declare const asQueryBus: (fake: TestQueryBus) => QueryBus;

package/dist/cjs/test-query-bus.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asQueryBus = exports.TestQueryBus = void 0;
+class TestQueryBus {
+    executed = [];
+    executeResult = null;
+    executeResultsByQuery = new Map();
+    async execute(query) {
+        await Promise.resolve();
+        this.executed.push(query);
+        const queryName = query.constructor.name;
+        const result = this.executeResultsByQuery.has(queryName)
+            ? this.executeResultsByQuery.get(queryName)
+            : this.executeResult;
+        return result;
+    }
+    setExecuteResult(result) {
+        this.executeResult = result;
+    }
+    setExecuteResultFor(queryClass, result) {
+        this.executeResultsByQuery.set(queryClass.name, result);
+    }
+}
+exports.TestQueryBus = TestQueryBus;
+const asQueryBus = (fake) => fake;
+exports.asQueryBus = asQueryBus;

package/dist/cjs/test-query-runner.d.ts

@@ -0,0 +1,8 @@
+import type { QueryRunner } from 'typeorm';
+import { DataSource, EntityManager } from 'typeorm';
+export declare const TEST_QUERY_RUNNER: unique symbol;
+export declare const testQueryRunner: {
+    inject: (typeof DataSource | typeof EntityManager)[];
+    provide: symbol;
+    useFactory: (dataSource: DataSource, manager: EntityManager) => QueryRunner;
+};

package/dist/cjs/test-query-runner.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testQueryRunner = exports.TEST_QUERY_RUNNER = void 0;
+const typeorm_1 = require("typeorm");
+exports.TEST_QUERY_RUNNER = Symbol('TEST_QUERY_RUNNER');
+exports.testQueryRunner = {
+    inject: [typeorm_1.DataSource, typeorm_1.EntityManager],
+    provide: exports.TEST_QUERY_RUNNER,
+    useFactory: (dataSource, manager) => {
+        const queryRunner = dataSource.createQueryRunner();
+        Object.assign(manager, { queryRunner });
+        return queryRunner;
+    },
+};

package/dist/esm/build-web-application.d.ts

@@ -0,0 +1,10 @@
+import type { InjectionToken, ModuleMetadata } from '@nestjs/common';
+import type { NestFastifyApplication } from '@nestjs/platform-fastify';
+export interface BuildWebApplicationOptionsInterface {
+    pinQueryRunner?: boolean;
+}
+export interface ProviderOverrideInterface {
+    provide: InjectionToken;
+    useValue: unknown;
+}
+export declare const buildWebApplication: (importModules: NonNullable<ModuleMetadata["imports"]>, overrides?: ProviderOverrideInterface[], options?: BuildWebApplicationOptionsInterface) => Promise<NestFastifyApplication>;

package/dist/esm/build-web-application.js

@@ -0,0 +1,19 @@
+import { FastifyAdapter } from '@nestjs/platform-fastify';
+import { Test } from '@nestjs/testing';
+import { Logger } from 'nestjs-pino';
+import { testQueryRunner } from './test-query-runner.js';
+const queryRunnerProviders = (options) => (options.pinQueryRunner === false ? [] : [testQueryRunner]);
+export const buildWebApplication = async (importModules, overrides = [], options = {}) => {
+    const builder = Test.createTestingModule({
+        imports: importModules,
+        providers: queryRunnerProviders(options),
+    });
+    for (const override of overrides) {
+        builder.overrideProvider(override.provide).useValue(override.useValue);
+    }
+    const moduleFixture = await builder.compile();
+    const app = moduleFixture.createNestApplication(new FastifyAdapter());
+    app.useLogger(app.get(Logger));
+    await app.init();
+    return app;
+};

package/dist/esm/fake-microservice/fake-microservice-strategy.d.ts

@@ -0,0 +1,12 @@
+import type { CustomTransportStrategy, ReadPacket, WritePacket } from '@nestjs/microservices';
+import { Server } from '@nestjs/microservices';
+import { Subject } from 'rxjs';
+export declare class FakeMicroserviceStrategy extends Server implements CustomTransportStrategy {
+    private readonly client;
+    private readonly server;
+    close(): void;
+    handleMessage(packet: ReadPacket): Promise<void>;
+    listen(listenCallback: () => void): void;
+    on(): void;
+    unwrap(): Subject<WritePacket<string>>;
+}

package/dist/esm/fake-microservice/fake-microservice-strategy.js

@@ -0,0 +1,41 @@
+import { BaseRpcContext, Server, } from '@nestjs/microservices';
+import { Subject } from 'rxjs';
+export class FakeMicroserviceStrategy extends Server {
+    client = new Subject();
+    server = new Subject();
+    close() {
+    }
+    async handleMessage(packet) {
+        const pattern = typeof packet.pattern === 'string' ? packet.pattern : '';
+        if (pattern === '') {
+            return;
+        }
+        const handler = this.getHandlerByPattern(pattern);
+        if (handler === null) {
+            return;
+        }
+        const context = new BaseRpcContext([packet.pattern]);
+        const response = this.transformToObservable(await handler(packet.data, context));
+        this.send(response, (data) => {
+            if (data.err === undefined) {
+                this.server.next(data);
+            }
+            else {
+                this.server.error(data.err);
+            }
+        });
+    }
+    listen(listenCallback) {
+        this.client.subscribe({
+            next: (packet) => {
+                void this.handleMessage(packet);
+            },
+        });
+        listenCallback();
+    }
+    on() {
+    }
+    unwrap() {
+        return this.server;
+    }
+}

package/dist/esm/fake-microservice/index.d.ts

@@ -0,0 +1 @@
+export * from './fake-microservice-strategy.js';

package/dist/esm/fake-microservice/index.js

@@ -0,0 +1 @@
+export * from './fake-microservice-strategy.js';

package/dist/esm/index.d.ts

@@ -0,0 +1,8 @@
+export * from './fake-microservice/index.js';
+export * from './postgres/index.js';
+export * from './build-web-application.js';
+export * from './test-command-bus.js';
+export * from './test-event-bus.js';
+export * from './test-logger.js';
+export * from './test-query-bus.js';
+export * from './test-query-runner.js';

package/dist/esm/index.js

@@ -0,0 +1,8 @@
+export * from './fake-microservice/index.js';
+export * from './postgres/index.js';
+export * from './build-web-application.js';
+export * from './test-command-bus.js';
+export * from './test-event-bus.js';
+export * from './test-logger.js';
+export * from './test-query-bus.js';
+export * from './test-query-runner.js';

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

@@ -0,0 +1 @@
+export * from './test-data-source.js';

package/dist/esm/postgres/index.js

@@ -0,0 +1 @@
+export * from './test-data-source.js';

package/dist/esm/postgres/test-data-source.d.ts

@@ -0,0 +1,20 @@
+import type { StartedTestContainer } from 'testcontainers';
+import type { EntitySchema, MixedList, NamingStrategyInterface, QueryRunner } from 'typeorm';
+import { DataSource } from 'typeorm';
+export declare const TEST_DATABASE_NAME = "db";
+export declare const TEST_DATABASE_PORT = 5432;
+export declare const startPostgresContainer: (image: string) => Promise<StartedTestContainer>;
+export interface TestDataSourceOptionsInterface {
+    entities: MixedList<EntitySchema | Function | string>;
+    image: string;
+    isLogging?: boolean;
+    migrations: MixedList<Function | string>;
+    namingStrategy: NamingStrategyInterface;
+    shouldSynchronize?: boolean;
+}
+export interface TestDataSourceResultInterface {
+    container: StartedTestContainer;
+    dataSource: DataSource;
+    queryRunner: QueryRunner;
+}
+export declare const testDataSource: ({ entities, image, isLogging, migrations, namingStrategy, shouldSynchronize, }: TestDataSourceOptionsInterface) => Promise<TestDataSourceResultInterface>;

package/dist/esm/postgres/test-data-source.js

@@ -0,0 +1,41 @@
+import { GenericContainer, Wait } from 'testcontainers';
+import { DataSource } from 'typeorm';
+export const TEST_DATABASE_NAME = 'db';
+export const TEST_DATABASE_PORT = 5432;
+export const startPostgresContainer = async (image) => new GenericContainer(image)
+    .withStartupTimeout(120_000)
+    .withWaitStrategy(Wait.forLogMessage(/database system is ready to accept connections/u, 2))
+    .withEnvironment({
+    POSTGRES_DATABASE: TEST_DATABASE_NAME,
+    POSTGRES_PASSWORD: TEST_DATABASE_NAME,
+    POSTGRES_USER: TEST_DATABASE_NAME,
+})
+    .withExposedPorts(TEST_DATABASE_PORT)
+    .start();
+export const testDataSource = async ({ entities, image, isLogging = false, migrations, namingStrategy, shouldSynchronize = false, }) => {
+    const databaseName = TEST_DATABASE_NAME;
+    const databasePort = TEST_DATABASE_PORT;
+    const container = await startPostgresContainer(image);
+    const databaseConfig = {
+        database: databaseName,
+        entities,
+        host: container.getHost(),
+        logging: isLogging,
+        maxQueryExecutionTime: 1000,
+        migrations,
+        migrationsRun: !shouldSynchronize,
+        namingStrategy,
+        password: databaseName,
+        port: container.getMappedPort(databasePort),
+        ssl: false,
+        subscribers: [],
+        synchronize: shouldSynchronize,
+        type: 'postgres',
+        username: databaseName,
+    };
+    const dataSource = new DataSource(databaseConfig);
+    await dataSource.initialize();
+    const queryRunner = dataSource.createQueryRunner();
+    Object.assign(dataSource.manager, { queryRunner });
+    return { container, dataSource, queryRunner };
+};

package/dist/esm/test-command-bus.d.ts

@@ -0,0 +1,10 @@
+import type { CommandBus, ICommand } from '@nestjs/cqrs';
+export declare class TestCommandBus {
+    readonly executed: ICommand[];
+    private executeResult;
+    private readonly queuedResults;
+    execute<TResult = unknown>(command: ICommand): Promise<TResult>;
+    setExecuteResult(result: unknown): void;
+    setExecuteResults(results: unknown[]): void;
+}
+export declare const asCommandBus: (fake: TestCommandBus) => CommandBus;

package/dist/esm/test-command-bus.js

@@ -0,0 +1,19 @@
+import { Ok } from 'oxide.ts';
+export class TestCommandBus {
+    executed = [];
+    executeResult = Ok('');
+    queuedResults = [];
+    async execute(command) {
+        await Promise.resolve();
+        this.executed.push(command);
+        const result = this.queuedResults.length > 0 ? this.queuedResults.shift() : this.executeResult;
+        return result;
+    }
+    setExecuteResult(result) {
+        this.executeResult = result;
+    }
+    setExecuteResults(results) {
+        this.queuedResults.splice(0, this.queuedResults.length, ...results);
+    }
+}
+export const asCommandBus = (fake) => fake;

package/dist/esm/test-event-bus.d.ts

@@ -0,0 +1,6 @@
+import { EventBus } from '@nestjs/cqrs';
+export declare class TestEventBus extends EventBus {
+    readonly events: Set<unknown>;
+    constructor();
+    cleanEvents(): void;
+}

package/dist/esm/test-event-bus.js

@@ -0,0 +1,18 @@
+import { EventBus } from '@nestjs/cqrs';
+export class TestEventBus extends EventBus {
+    events = new Set();
+    constructor() {
+        const moduleReference = {};
+        const commandBus = {};
+        const unhandledExceptionBus = {};
+        super(commandBus, moduleReference, unhandledExceptionBus);
+        this.publisher = {
+            publish: (event) => {
+                this.events.add(event);
+            },
+        };
+    }
+    cleanEvents() {
+        this.events.clear();
+    }
+}

package/dist/esm/test-logger.d.ts

@@ -0,0 +1,15 @@
+import { PinoLogger } from 'nestjs-pino';
+export interface TestLogEntryInterface {
+    readonly args: readonly unknown[];
+}
+export declare class TestLogger extends PinoLogger {
+    readonly debugs: TestLogEntryInterface[];
+    readonly errors: TestLogEntryInterface[];
+    readonly infos: TestLogEntryInterface[];
+    readonly warns: TestLogEntryInterface[];
+    constructor();
+    debug(...arguments_: unknown[]): void;
+    error(...arguments_: unknown[]): void;
+    info(...arguments_: unknown[]): void;
+    warn(...arguments_: unknown[]): void;
+}

package/dist/esm/test-logger.js

@@ -0,0 +1,22 @@
+import { PinoLogger } from 'nestjs-pino';
+export class TestLogger extends PinoLogger {
+    debugs = [];
+    errors = [];
+    infos = [];
+    warns = [];
+    constructor() {
+        super({});
+    }
+    debug(...arguments_) {
+        this.debugs.push({ args: arguments_ });
+    }
+    error(...arguments_) {
+        this.errors.push({ args: arguments_ });
+    }
+    info(...arguments_) {
+        this.infos.push({ args: arguments_ });
+    }
+    warn(...arguments_) {
+        this.warns.push({ args: arguments_ });
+    }
+}

package/dist/esm/test-query-bus.d.ts

@@ -0,0 +1,12 @@
+import type { IQuery, QueryBus } from '@nestjs/cqrs';
+export declare class TestQueryBus {
+    readonly executed: IQuery[];
+    private executeResult;
+    private readonly executeResultsByQuery;
+    execute<TResult = unknown>(query: IQuery): Promise<TResult>;
+    setExecuteResult(result: unknown): void;
+    setExecuteResultFor(queryClass: {
+        name: string;
+    }, result: unknown): void;
+}
+export declare const asQueryBus: (fake: TestQueryBus) => QueryBus;

package/dist/esm/test-query-bus.js

@@ -0,0 +1,21 @@
+export class TestQueryBus {
+    executed = [];
+    executeResult = null;
+    executeResultsByQuery = new Map();
+    async execute(query) {
+        await Promise.resolve();
+        this.executed.push(query);
+        const queryName = query.constructor.name;
+        const result = this.executeResultsByQuery.has(queryName)
+            ? this.executeResultsByQuery.get(queryName)
+            : this.executeResult;
+        return result;
+    }
+    setExecuteResult(result) {
+        this.executeResult = result;
+    }
+    setExecuteResultFor(queryClass, result) {
+        this.executeResultsByQuery.set(queryClass.name, result);
+    }
+}
+export const asQueryBus = (fake) => fake;

package/dist/esm/test-query-runner.d.ts

@@ -0,0 +1,8 @@
+import type { QueryRunner } from 'typeorm';
+import { DataSource, EntityManager } from 'typeorm';
+export declare const TEST_QUERY_RUNNER: unique symbol;
+export declare const testQueryRunner: {
+    inject: (typeof DataSource | typeof EntityManager)[];
+    provide: symbol;
+    useFactory: (dataSource: DataSource, manager: EntityManager) => QueryRunner;
+};

package/dist/esm/test-query-runner.js

@@ -0,0 +1,11 @@
+import { DataSource, EntityManager } from 'typeorm';
+export const TEST_QUERY_RUNNER = Symbol('TEST_QUERY_RUNNER');
+export const testQueryRunner = {
+    inject: [DataSource, EntityManager],
+    provide: TEST_QUERY_RUNNER,
+    useFactory: (dataSource, manager) => {
+        const queryRunner = dataSource.createQueryRunner();
+        Object.assign(manager, { queryRunner });
+        return queryRunner;
+    },
+};

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "@application-kit/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.0",
+  "description": "Тестовая инфраструктура NestJS-приложений: шины CQRS, логгер, фейковый microservice, сборка web-приложения и Postgres в testcontainers",
+  "keywords": [
+    "cqrs",
+    "nestjs",
+    "testcontainers",
+    "testing"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/testing",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/testing"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "lint:tsc": "tsc --noEmit --pretty --project .",
+    "test:mutation": "stryker run",
+    "test:unit": "vitest run"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.2.7",
+    "@nestjs/core": "^11.2.7",
+    "@nestjs/cqrs": "^11.0.3",
+    "@nestjs/microservices": "^11.2.7",
+    "@nestjs/platform-fastify": "^11.2.7",
+    "@nestjs/testing": "^11.2.7",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^26.2.0",
+    "nestjs-pino": "^4.6.1",
+    "oxide.ts": "^1.1.0",
+    "pino": "^10.3.1",
+    "pino-http": "^11.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "testcontainers": "12.1.0",
+    "typeorm": "^1.1.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/cqrs": "^11.0.3",
+    "@nestjs/microservices": "^11.0.0",
+    "@nestjs/platform-fastify": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "nestjs-pino": "^4.6.1",
+    "oxide.ts": "^1.1.0",
+    "rxjs": "^7.8.2",
+    "testcontainers": "^12.1.0",
+    "typeorm": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }