Initial commit
CI / Сборка (push) Canceled after 0s
CI / Деплой на стейджинг (push) Canceled after 0s
CI / Проверка кода (push) Canceled after 0s
CI / Сборка (pull_request) Successful in 1m33s
Стенд master
CI / Деплой на стейджинг (pull_request) Successful in 8s
CI / Проверка кода (pull_request) Successful in 1m32s
CI / Сборка (push) Canceled after 0s
CI / Деплой на стейджинг (push) Canceled after 0s
CI / Проверка кода (push) Canceled after 0s
CI / Сборка (pull_request) Successful in 1m33s
Стенд master
CI / Деплой на стейджинг (pull_request) Successful in 8s
CI / Проверка кода (pull_request) Successful in 1m32s
This commit is contained in:
commit
1420aad1ae
92 files changed
+19114
No files matched your search
@@ -0,0 +1,28 @@
|
||||
FROM git.jt4d.ru/jt4d/node:24-alpine AS deps
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
COPY ./package.json ./yarn.lock ./
|
||||
|
||||
RUN yarn install --production --frozen-lockfile && yarn cache clean
|
||||
|
||||
FROM git.jt4d.ru/jt4d/node:24-alpine
|
||||
|
||||
RUN apk add --no-cache tini curl
|
||||
|
||||
COPY --from=deps /app/node_modules /app/node_modules
|
||||
|
||||
COPY ./dist /app
|
||||
|
||||
EXPOSE 5000
|
||||
# Прод-режим по умолчанию: JSON-логи pino и никаких pino-pretty из devDependencies,
|
||||
# которые в образ не попадают. Переопределяется через docker-compose при необходимости.
|
||||
ENV PORT=5000
|
||||
ENV NODE_ENV=production
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
HEALTHCHECK --interval=30s --timeout=5s --retries=3 --start-period=15s \
|
||||
CMD curl -f http://localhost:5000/api/health || exit 1
|
||||
|
||||
ENTRYPOINT ["/sbin/tini", "--", "node", "main.js"]
|
||||
@@ -0,0 +1,96 @@
|
||||
const path = require('path');
|
||||
|
||||
const colorette = require('colorette');
|
||||
const nodeExternals = require('webpack-node-externals');
|
||||
|
||||
/**
|
||||
* Обертка на webpack-node-externals с логированием внешних пакетов.
|
||||
*
|
||||
* Потребовалась, чтобы переписать то, что настроил NxAppWebpackPlugin.
|
||||
*
|
||||
* Заставляет webpack БАНДЛИТЬ пакеты с указанными префиксами (не делать их external).
|
||||
* Для всех остальных пакетов из node_modules — применяется стандартный nodeExternals.
|
||||
*
|
||||
* Использовать совместно с externalDependencies: 'none' в NxAppWebpackPlugin,
|
||||
* чтобы NxAppWebpackPlugin не добавлял собственный nodeExternals без allowlist.
|
||||
*/
|
||||
module.exports.DenyExternalsPlugin = class DenyExternalsPlugin {
|
||||
constructor(skipExternalPackages) {
|
||||
// Массив строк-префиксов, например ['@it-smi/']
|
||||
this.skipExternalPackages = skipExternalPackages;
|
||||
}
|
||||
|
||||
apply(compiler) {
|
||||
const NAME = 'DenyExternalsPlugin';
|
||||
|
||||
// Преобразуем строковые префиксы в RegExp для allowlist nodeExternals.
|
||||
// containsPattern в webpack-node-externals проверяет: regexp.test(request)
|
||||
const allowlistPatterns = this.skipExternalPackages.map(
|
||||
(prefix) => new RegExp('^' + prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')),
|
||||
);
|
||||
|
||||
// compiler.context устанавливается в NxAppWebpackPlugin.apply() (раньше нас),
|
||||
// поэтому здесь уже доступно корректное значение (<workspace>/apps/api).
|
||||
// Идём два уровня вверх до корня воркспейса, где лежит node_modules.
|
||||
const modulesDir = path.join(compiler.context, '../../node_modules');
|
||||
// Локальный node_modules приложения (apps/api/node_modules/) — пакеты,
|
||||
// которые не удалось hoisted в корень (например, из-за конфликтов версий).
|
||||
const localModulesDir = path.join(compiler.context, 'node_modules');
|
||||
|
||||
// Заменяем externals (NxAppWebpackPlugin с externalDependencies: 'none'
|
||||
// оставляет compiler.options.externals = []).
|
||||
// Ставим nodeExternals с нашим allowlist — пакеты из allowlist будут бандлиться.
|
||||
compiler.options.externals = [
|
||||
nodeExternals({
|
||||
modulesDir,
|
||||
additionalModuleDirs: [localModulesDir],
|
||||
allowlist: allowlistPatterns,
|
||||
}),
|
||||
];
|
||||
|
||||
// Печатаем ФАКТИЧЕСКИЕ external-модули после сборки графа модулей.
|
||||
compiler.hooks.compilation.tap(NAME, (compilation) => {
|
||||
compilation.hooks.finishModules.tap(NAME, (modules) => {
|
||||
const out = [];
|
||||
|
||||
for (const m of modules) {
|
||||
const isExternal =
|
||||
m?.constructor?.name === 'ExternalModule' ||
|
||||
m?.external === true ||
|
||||
typeof m?.externalType === 'string';
|
||||
|
||||
if (!isExternal) {
|
||||
continue;
|
||||
}
|
||||
|
||||
const request = m.userRequest || m.request || m._request || '<<unknown>>';
|
||||
const type = m.externalType || '';
|
||||
|
||||
out.push({ request, type });
|
||||
}
|
||||
|
||||
if (out.length) {
|
||||
const unique = new Map();
|
||||
|
||||
for (const { request, type } of out) {
|
||||
if (!unique.has(request)) {
|
||||
unique.set(request, type || '');
|
||||
}
|
||||
}
|
||||
|
||||
console.log(`\n── used externals: ${unique.size}`);
|
||||
|
||||
const list = Array.from(unique.entries())
|
||||
.map(([req, t]) => ` • ${req} ${colorette.gray(`[${t}]`)}`)
|
||||
.toSorted();
|
||||
|
||||
console.log(list.join('\n'));
|
||||
|
||||
console.log('');
|
||||
} else {
|
||||
console.log('\n── used externals (none)\n');
|
||||
}
|
||||
});
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -0,0 +1,3 @@
|
||||
import baseConfig from '../../eslint.config.mjs';
|
||||
|
||||
export default [...baseConfig];
|
||||
@@ -0,0 +1,29 @@
|
||||
{
|
||||
"name": "@it-smi/api",
|
||||
"version": "0.0.1",
|
||||
"private": true,
|
||||
"dependencies": {
|
||||
"@nestjs/common": "^11.0.0",
|
||||
"@nestjs/core": "^11.0.0",
|
||||
"@nestjs/platform-express": "^11.0.0",
|
||||
"@nestjs/swagger": "^11.4.7",
|
||||
"@nestjs/terminus": "^11.1.1",
|
||||
"@nestjs/typeorm": "^11.0.0",
|
||||
"axios": "^1.6.0",
|
||||
"colorette": "^2.0.20",
|
||||
"dotenv": "^16.4.7",
|
||||
"nestjs-pino": "^4.4.1",
|
||||
"pg": "^8.20.0",
|
||||
"pino": "^9.11.0",
|
||||
"pino-http": "^10.5.0",
|
||||
"reflect-metadata": "^0.1.13",
|
||||
"rxjs": "^7.8.0",
|
||||
"typeorm": "^0.3.31"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@nestjs/schematics": "^11.0.0",
|
||||
"@nestjs/testing": "^11.0.0",
|
||||
"pino-pretty": "^13.1.1",
|
||||
"webpack-cli": "^5.1.4"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,202 @@
|
||||
{
|
||||
"name": "api",
|
||||
"$schema": "../../node_modules/nx/schemas/project-schema.json",
|
||||
"sourceRoot": "apps/api/src",
|
||||
"projectType": "application",
|
||||
"tags": [],
|
||||
"targets": {
|
||||
"build": {
|
||||
"executor": "nx:run-commands",
|
||||
"dependsOn": [
|
||||
"db-migrations-list"
|
||||
],
|
||||
"outputs": [
|
||||
"{projectRoot}/dist"
|
||||
],
|
||||
"options": {
|
||||
"commands": [
|
||||
"webpack-cli build",
|
||||
"webpack-cli build --config webpack.data-source.config.js"
|
||||
],
|
||||
"parallel": false,
|
||||
"args": [
|
||||
"--node-env=production"
|
||||
],
|
||||
"cwd": "apps/api"
|
||||
},
|
||||
"configurations": {
|
||||
"development": {
|
||||
"args": [
|
||||
"--node-env=development"
|
||||
]
|
||||
}
|
||||
}
|
||||
},
|
||||
"typecheck": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "tsc --noEmit -p tsconfig.spec.json",
|
||||
"cwd": "apps/api"
|
||||
}
|
||||
},
|
||||
"lint": {
|
||||
"executor": "@nx/eslint:lint",
|
||||
"options": {
|
||||
"lintFilePatterns": [
|
||||
"{projectRoot}/**/*.ts"
|
||||
],
|
||||
"eslintConfig": "{projectRoot}/eslint.config.mjs",
|
||||
"fix": true
|
||||
}
|
||||
},
|
||||
"lint-check": {
|
||||
"executor": "@nx/eslint:lint",
|
||||
"options": {
|
||||
"lintFilePatterns": [
|
||||
"{projectRoot}/**/*.ts"
|
||||
],
|
||||
"eslintConfig": "{projectRoot}/eslint.config.mjs"
|
||||
}
|
||||
},
|
||||
"format": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "prettier --write {projectRoot}"
|
||||
}
|
||||
},
|
||||
"format-check": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "prettier --check {projectRoot}"
|
||||
}
|
||||
},
|
||||
"serve": {
|
||||
"continuous": true,
|
||||
"executor": "@nx/js:node",
|
||||
"defaultConfiguration": "development",
|
||||
"dependsOn": [
|
||||
"build"
|
||||
],
|
||||
"options": {
|
||||
"buildTarget": "api:build",
|
||||
"runBuildTargetDependencies": false
|
||||
},
|
||||
"configurations": {
|
||||
"development": {
|
||||
"buildTarget": "api:build:development"
|
||||
},
|
||||
"production": {
|
||||
"buildTarget": "api:build:production"
|
||||
}
|
||||
}
|
||||
},
|
||||
"prune-lockfile": {
|
||||
"dependsOn": [
|
||||
"build"
|
||||
],
|
||||
"cache": true,
|
||||
"executor": "@nx/js:prune-lockfile",
|
||||
"outputs": [
|
||||
"{workspaceRoot}/apps/api/dist/package.json",
|
||||
"{workspaceRoot}/apps/api/dist/yarn.lock"
|
||||
],
|
||||
"options": {
|
||||
"buildTarget": "build"
|
||||
}
|
||||
},
|
||||
"copy-workspace-modules": {
|
||||
"dependsOn": [
|
||||
"build"
|
||||
],
|
||||
"cache": true,
|
||||
"outputs": [
|
||||
"{workspaceRoot}/apps/api/dist/workspace_modules"
|
||||
],
|
||||
"executor": "@nx/js:copy-workspace-modules",
|
||||
"options": {
|
||||
"buildTarget": "build"
|
||||
}
|
||||
},
|
||||
"prune": {
|
||||
"dependsOn": [
|
||||
"prune-lockfile",
|
||||
"copy-workspace-modules"
|
||||
],
|
||||
"executor": "nx:noop"
|
||||
},
|
||||
"db-migrations-list": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "ts-node",
|
||||
"args": [
|
||||
"--transpile-only",
|
||||
"tools/buildDataSource.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-show": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "typeorm-ts-node-commonjs",
|
||||
"args": [
|
||||
"migration:show",
|
||||
"--dataSource=apps/api/src/config/typeorm.config.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-migrate": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "typeorm-ts-node-commonjs",
|
||||
"args": [
|
||||
"migration:run",
|
||||
"--dataSource=apps/api/src/config/typeorm.config.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-revert": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "typeorm-ts-node-commonjs",
|
||||
"args": [
|
||||
"migration:revert",
|
||||
"--dataSource=apps/api/src/config/typeorm.config.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-drop": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "typeorm-ts-node-commonjs",
|
||||
"args": [
|
||||
"schema:drop",
|
||||
"--dataSource=apps/api/src/config/typeorm.config.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-snapshot": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "ts-node",
|
||||
"args": [
|
||||
"tools/dbSnapshot.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"db-restore": {
|
||||
"executor": "nx:run-commands",
|
||||
"options": {
|
||||
"command": "ts-node",
|
||||
"args": [
|
||||
"tools/dbRestore.ts"
|
||||
]
|
||||
}
|
||||
},
|
||||
"test": {
|
||||
"executor": "@nx/vitest:test",
|
||||
"options": {
|
||||
"configFile": "apps/api/vitest.config.ts"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,13 @@
|
||||
import { Controller, Get } from '@nestjs/common';
|
||||
|
||||
import { AppService } from './app.service';
|
||||
|
||||
@Controller()
|
||||
export class AppController {
|
||||
constructor(private readonly appService: AppService) {}
|
||||
|
||||
@Get()
|
||||
getData() {
|
||||
return this.appService.getData();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,19 @@
|
||||
import { Module, OnModuleDestroy } from '@nestjs/common';
|
||||
|
||||
import { DatabaseModule } from '../database/database.module';
|
||||
import { HealthModule } from '../health/health.module';
|
||||
import { LocalLoggerModule, Logger } from '../logger';
|
||||
|
||||
import { AppController } from './app.controller';
|
||||
import { AppService } from './app.service';
|
||||
|
||||
@Module({
|
||||
imports: [LocalLoggerModule.forRoot(), DatabaseModule, HealthModule],
|
||||
controllers: [AppController],
|
||||
providers: [AppService],
|
||||
})
|
||||
export class AppModule implements OnModuleDestroy {
|
||||
onModuleDestroy() {
|
||||
new Logger('AppModule').warn('Backend is shutting down');
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
import { Injectable } from '@nestjs/common';
|
||||
|
||||
@Injectable()
|
||||
export class AppService {
|
||||
getData(): { message: string } {
|
||||
return { message: 'Hello API' };
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
import * as path from 'path';
|
||||
|
||||
import { config } from 'dotenv';
|
||||
import { DataSource } from 'typeorm';
|
||||
|
||||
import { migrations } from '../migrations';
|
||||
|
||||
// Загружаем env файлы в правильном порядке.
|
||||
// Внутри контейнера файлов нет — dotenv молча пропустит их, значения берутся из окружения.
|
||||
const nodeEnv = process.env.NODE_ENV || 'production';
|
||||
config({ path: path.resolve(process.cwd(), `.env.${nodeEnv}`) });
|
||||
config({ path: path.resolve(process.cwd(), '.env') });
|
||||
|
||||
// entities нужны только CLI и только при запуске из TS-исходников
|
||||
// (migration:generate, schema:drop). Путь привязан к самому файлу, а не к
|
||||
// process.cwd(): cwd-относительный glob при запуске из другой директории молча
|
||||
// резолвится в пустой список, и migration:generate тогда генерирует миграцию,
|
||||
// удаляющую все таблицы, а schema:drop превращается в no-op.
|
||||
// В собранном бандле (__dirname === /app) тот же glob ушёл бы сканировать корень
|
||||
// файловой системы, поэтому там список пустой — на migration:run он не влияет.
|
||||
const isTypeScriptRuntime = __filename.endsWith('.ts');
|
||||
const entities = isTypeScriptRuntime ? [path.join(__dirname, '..', '**', '*.entity.ts')] : [];
|
||||
|
||||
const AppDataSource = new DataSource({
|
||||
type: 'postgres',
|
||||
username: process.env.POSTGRES_USER,
|
||||
password: process.env.POSTGRES_PASSWORD,
|
||||
database: process.env.POSTGRES_DB,
|
||||
host: process.env.POSTGRES_HOST,
|
||||
port: +(process.env.POSTGRES_PORT || 5432),
|
||||
synchronize: false,
|
||||
entities,
|
||||
// Статический список — webpack не умеет runtime-glob (tools/buildDataSource.ts).
|
||||
migrations,
|
||||
migrationsRun: false,
|
||||
logging: true,
|
||||
});
|
||||
|
||||
export default AppDataSource;
|
||||
@@ -0,0 +1,28 @@
|
||||
import { Module } from '@nestjs/common';
|
||||
import { TypeOrmModule } from '@nestjs/typeorm';
|
||||
|
||||
import AppDataSource from '../config/typeorm.config';
|
||||
|
||||
/**
|
||||
* Подключение приложения к БД.
|
||||
*
|
||||
* Настройки берутся из того же `typeorm.config.ts`, что использует CLI миграций:
|
||||
* там же загружаются env-файлы, поэтому приложению не нужен второй набор
|
||||
* переменных окружения. Сущности модулей подключаются через
|
||||
* `TypeOrmModule.forFeature` (autoLoadEntities), статический список `entities`
|
||||
* остаётся нужен только CLI.
|
||||
*
|
||||
* Собственный логгер TypeORM выключен: логи приложения идут через pino
|
||||
* (docs/55-logging), иначе SQL-запросы печатаются мимо него.
|
||||
*/
|
||||
@Module({
|
||||
imports: [
|
||||
TypeOrmModule.forRoot({
|
||||
...AppDataSource.options,
|
||||
autoLoadEntities: true,
|
||||
logging: false,
|
||||
migrationsRun: false,
|
||||
}),
|
||||
],
|
||||
})
|
||||
export class DatabaseModule {}
|
||||
Whitespace-only changes.
@@ -0,0 +1,47 @@
|
||||
import { Controller, Get } from '@nestjs/common';
|
||||
import { ApiOperation, ApiResponse, ApiTags } from '@nestjs/swagger';
|
||||
import { HealthCheck, HealthCheckService, TypeOrmHealthIndicator } from '@nestjs/terminus';
|
||||
|
||||
declare const __APP_VERSION__: string;
|
||||
|
||||
@ApiTags('Health Check')
|
||||
@Controller('health')
|
||||
export class HealthController {
|
||||
constructor(
|
||||
private health: HealthCheckService,
|
||||
private db: TypeOrmHealthIndicator,
|
||||
) {}
|
||||
|
||||
@Get()
|
||||
@HealthCheck()
|
||||
@ApiOperation({ summary: 'Проверка состояния приложения' })
|
||||
@ApiResponse({
|
||||
status: 200,
|
||||
description: 'Приложение работает нормально',
|
||||
schema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
status: { type: 'string', example: 'ok' },
|
||||
version: { type: 'string', example: 'v1.2.3' },
|
||||
info: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
database: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
status: { type: 'string', example: 'up' },
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
})
|
||||
async check() {
|
||||
const result = await this.health.check([() => this.db.pingCheck('database')]);
|
||||
return {
|
||||
...result,
|
||||
version: __APP_VERSION__,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
import { Module } from '@nestjs/common';
|
||||
import { TerminusModule } from '@nestjs/terminus';
|
||||
|
||||
import { HealthController } from './health.controller';
|
||||
|
||||
@Module({
|
||||
imports: [TerminusModule],
|
||||
controllers: [HealthController],
|
||||
})
|
||||
export class HealthModule {}
|
||||
@@ -0,0 +1,36 @@
|
||||
import pino, { Logger as PinoLogger } from 'pino';
|
||||
import type { PrettyOptions } from 'pino-pretty';
|
||||
|
||||
/**
|
||||
* В продакшене пишем машиночитаемый JSON, в остальных окружениях — человекочитаемый вывод.
|
||||
* LOG_PRETTY явно перекрывает определение по NODE_ENV (нужно, когда образ собран под прод,
|
||||
* а контейнер поднят локально).
|
||||
*/
|
||||
const isProduction = process.env.NODE_ENV === 'production' || process.env.LOG_PRETTY === 'false';
|
||||
|
||||
const baseLogger = pino({
|
||||
level: process.env.LOG_LEVEL ?? (isProduction ? 'info' : 'debug'),
|
||||
transport: isProduction
|
||||
? undefined
|
||||
: {
|
||||
target: 'pino-pretty',
|
||||
options: {
|
||||
colorize: true,
|
||||
translateTime: 'HH:MM:ss.l',
|
||||
ignore: 'pid,hostname,context,reqId,res,url,statusCode,responseTime',
|
||||
messageFormat: [
|
||||
'\x1b[36m{reqId}\x1b[0m',
|
||||
'\x1b[33m{context}\x1b[0m',
|
||||
'\x1b[34m{msg}\x1b[0m',
|
||||
].join(' '),
|
||||
} as PrettyOptions,
|
||||
},
|
||||
});
|
||||
|
||||
/**
|
||||
* Единственный экземпляр pino на процесс: и корневой логгер приложения, и pino-http
|
||||
* пишут через него, поэтому транспорт (воркер pino-pretty) создаётся один раз.
|
||||
*/
|
||||
export function getBaseLogger(): PinoLogger {
|
||||
return baseLogger;
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
export * from './base';
|
||||
export * from './logger.class';
|
||||
export * from './logger.module';
|
||||
@@ -0,0 +1,167 @@
|
||||
import { Inject, Injectable, LoggerService, Scope } from '@nestjs/common';
|
||||
import { PinoLogger } from 'nestjs-pino';
|
||||
import { Bindings } from 'pino';
|
||||
|
||||
import { getBaseLogger } from './base';
|
||||
|
||||
export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
|
||||
|
||||
@Injectable({ scope: Scope.TRANSIENT })
|
||||
export class Logger implements LoggerService {
|
||||
private readonly logger: PinoLogger;
|
||||
|
||||
constructor();
|
||||
constructor(context: string);
|
||||
constructor(
|
||||
@Inject(PinoLogger)
|
||||
context?: string | PinoLogger,
|
||||
) {
|
||||
if (context && context instanceof PinoLogger) {
|
||||
this.logger = context;
|
||||
} else {
|
||||
const bindings: Bindings = context ? { context } : {};
|
||||
|
||||
this.logger = getBaseLogger().child(bindings) as unknown as PinoLogger;
|
||||
}
|
||||
}
|
||||
|
||||
setContext(context: string) {
|
||||
if (this.logger instanceof PinoLogger) {
|
||||
this.logger.setContext(context);
|
||||
} else {
|
||||
throw new Error('Cannot set context on child logger');
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Трассировка, максимальная детализация
|
||||
*
|
||||
* Log level: 10
|
||||
*
|
||||
* Самый подробный уровень. Используется для сложных расследований и поиска причин ошибок.
|
||||
*
|
||||
* Примеры:
|
||||
* - пошаговое логирование алгоритма
|
||||
* - шаги в обработке запроса
|
||||
* - переходы между этапами обработки
|
||||
* - детали бизнес-логики
|
||||
*/
|
||||
trace(message: string, details?: object) {
|
||||
this.logInner('trace', message, details);
|
||||
}
|
||||
|
||||
/**
|
||||
* Отладка, подробности бизнес-логики
|
||||
*
|
||||
* Log level: 20
|
||||
*
|
||||
* Сообщения для разработчиков, полезные при разборе логики работы.
|
||||
*
|
||||
* Примеры:
|
||||
* - запрос разрешений
|
||||
* - ключевые шаги алгоритма
|
||||
* - получение данных из внешних сервисов
|
||||
* - события жизненного цикла приложения
|
||||
* - ответы от внешних сервисов
|
||||
*/
|
||||
debug(message: string, details?: object) {
|
||||
this.logInner('debug', message, details);
|
||||
}
|
||||
|
||||
/**
|
||||
* Ключевые события приложения
|
||||
*
|
||||
* Log level: 30
|
||||
*
|
||||
* Информационные сообщения о нормальной работе приложения.
|
||||
*
|
||||
* Примеры:
|
||||
* - запрос к API
|
||||
* - пользователь успешно вошёл в систему
|
||||
* - заявка создана
|
||||
* - бизнес-операция успешно выполнена
|
||||
*/
|
||||
log(message: string, details?: object) {
|
||||
this.logInner('info', message, details);
|
||||
}
|
||||
|
||||
/**
|
||||
* Потенциальная проблема, нестандартное поведение
|
||||
*
|
||||
* Log level: 40
|
||||
*
|
||||
* Предупреждения о нежелательных или подозрительных ситуациях, которые не приводят к немедленной поломке.
|
||||
*
|
||||
* Примеры:
|
||||
* - потенциально опасное поведение пользователя
|
||||
* - использование устаревшего API
|
||||
* - медленный запрос
|
||||
*/
|
||||
warn(message: string, details?: object) {
|
||||
this.logInner('warn', message, details);
|
||||
}
|
||||
|
||||
/**
|
||||
* Ошибка, требующая реакции
|
||||
*
|
||||
* Log level: 50
|
||||
*
|
||||
* Серьёзные ошибки в работе приложения, которые нужно обрабатывать.
|
||||
*
|
||||
* Примеры:
|
||||
* - API отдало 500
|
||||
* - не удалось выполнить бизнес-операцию.
|
||||
*/
|
||||
error(message: string, details?: object): void;
|
||||
/**
|
||||
* Ошибка, требующая реакции
|
||||
*
|
||||
* Log level: 50
|
||||
*
|
||||
* Серьёзные ошибки в работе приложения, которые нужно обрабатывать.
|
||||
*
|
||||
* Примеры:
|
||||
* - API отдало 500
|
||||
* - не удалось выполнить бизнес-операцию.
|
||||
*/
|
||||
error(message: string, trace?: string, details?: object): void;
|
||||
error(message: string, traceOrDetails?: string | object, details?: object | string) {
|
||||
if (typeof details === 'string') {
|
||||
details = { context: details };
|
||||
}
|
||||
|
||||
if (typeof traceOrDetails === 'string') {
|
||||
details = { ...details, trace: traceOrDetails };
|
||||
}
|
||||
|
||||
this.logInner('error', message, details);
|
||||
}
|
||||
|
||||
/**
|
||||
* Критическая ошибка, завершение работы
|
||||
*
|
||||
* Log level: 60
|
||||
*
|
||||
* Используется для ситуаций, после которых приложение не может продолжать работу.
|
||||
*
|
||||
* Примеры:
|
||||
* - падение основного процесса
|
||||
* - невозможность поднять сервер на указанном порту
|
||||
* - не корректная конфигурация
|
||||
* - не удалось подключиться к базе данных
|
||||
*/
|
||||
fatal(message: string, details?: object) {
|
||||
this.logInner('fatal', message, details);
|
||||
}
|
||||
|
||||
protected logInner(level: LogLevel, message: string, details?: object | string) {
|
||||
if (typeof details === 'object' && details !== null) {
|
||||
this.logger[level](details, message);
|
||||
} else if (typeof details === 'string') {
|
||||
// Для совместимости с логгером по умолчанию в NestJS
|
||||
this.logger[level]({ context: details }, message);
|
||||
} else {
|
||||
this.logger[level](message);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,113 @@
|
||||
import { IncomingMessage, ServerResponse } from 'http';
|
||||
|
||||
import { DynamicModule, INestApplication, Module } from '@nestjs/common';
|
||||
import { LoggerModule, PinoLogger } from 'nestjs-pino';
|
||||
|
||||
import { getBaseLogger } from './base';
|
||||
import { Logger } from './logger.class';
|
||||
import { MockLogger, TestingLogger } from './testing';
|
||||
|
||||
@Module({})
|
||||
export class LocalLoggerModule {
|
||||
/**
|
||||
* Рабочая конфигурация: наш pino (base.ts) + автоматические HTTP-логи через pino-http.
|
||||
*/
|
||||
public static forRoot(): DynamicModule {
|
||||
return {
|
||||
global: true,
|
||||
module: LocalLoggerModule,
|
||||
imports: [
|
||||
LoggerModule.forRoot({
|
||||
pinoHttp: {
|
||||
// важное место: используем наш СУЩЕСТВУЮЩИЙ pino, а не создаём новый
|
||||
logger: getBaseLogger(),
|
||||
|
||||
autoLogging: true,
|
||||
|
||||
customProps: (req: IncomingMessage) => ({
|
||||
url: req.method + ' ' + req.url,
|
||||
context: 'HTTP',
|
||||
}),
|
||||
quietReqLogger: true,
|
||||
quietResLogger: true,
|
||||
|
||||
customLogLevel: function (
|
||||
_req: IncomingMessage,
|
||||
res: ServerResponse,
|
||||
err?: Error,
|
||||
) {
|
||||
if (res.statusCode >= 500 || err) {
|
||||
return 'error';
|
||||
} else if (res.statusCode >= 300 && res.statusCode < 400) {
|
||||
return 'silent';
|
||||
}
|
||||
|
||||
return 'info';
|
||||
},
|
||||
customSuccessMessage(req: IncomingMessage, res: ServerResponse) {
|
||||
return `Request completed: ${res.statusCode} ${req.method} ${req.url}`;
|
||||
},
|
||||
customSuccessObject(
|
||||
_req: IncomingMessage,
|
||||
res: ServerResponse,
|
||||
val: { responseTime: number },
|
||||
) {
|
||||
return {
|
||||
statusCode: res.statusCode,
|
||||
responseTime: val.responseTime,
|
||||
};
|
||||
},
|
||||
customErrorMessage(req: IncomingMessage, res: ServerResponse, err: Error) {
|
||||
return `Request error: ${res.statusCode} ${req.method} ${req.url} ${err.message}`;
|
||||
},
|
||||
customErrorObject(
|
||||
req: IncomingMessage,
|
||||
res: ServerResponse,
|
||||
_err: Error,
|
||||
val: { responseTime: number },
|
||||
) {
|
||||
return {
|
||||
url: req.method + ' ' + req.url,
|
||||
statusCode: res.statusCode,
|
||||
responseTime: val.responseTime,
|
||||
};
|
||||
},
|
||||
},
|
||||
}),
|
||||
],
|
||||
providers: [Logger],
|
||||
exports: [Logger],
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Конфигурация для тестов: логи складываются в память и проверяются через TestingLogger.
|
||||
*/
|
||||
public static forTesting(): DynamicModule {
|
||||
return {
|
||||
global: true,
|
||||
module: LocalLoggerModule,
|
||||
providers: [
|
||||
TestingLogger,
|
||||
{
|
||||
provide: Logger,
|
||||
useFactory: (testingLogger: TestingLogger) => new MockLogger(testingLogger),
|
||||
inject: [TestingLogger],
|
||||
},
|
||||
{
|
||||
provide: PinoLogger,
|
||||
useValue: {},
|
||||
},
|
||||
],
|
||||
exports: [Logger, TestingLogger],
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Подмена логгера Nest нашим. Вызывать после NestFactory.create с bufferLogs: true —
|
||||
* useLogger сбрасывает буфер в наш логгер.
|
||||
*/
|
||||
public static setup(app: INestApplication) {
|
||||
app.useLogger(new Logger());
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,2 @@
|
||||
export * from './logger.class';
|
||||
export * from './testing-logger.class';
|
||||
@@ -0,0 +1,19 @@
|
||||
import { Logger, LogLevel } from '../logger.class';
|
||||
|
||||
import { TestingLogger } from './testing-logger.class';
|
||||
|
||||
export class MockLogger extends Logger {
|
||||
private context: string;
|
||||
|
||||
constructor(private readonly testingLogger: TestingLogger) {
|
||||
super();
|
||||
}
|
||||
|
||||
override setContext(context: string) {
|
||||
this.context = context;
|
||||
}
|
||||
|
||||
protected override logInner(level: LogLevel, message: string, details?: object) {
|
||||
this.testingLogger.log(level, message, this.context, details);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,265 @@
|
||||
import * as colorette from 'colorette';
|
||||
|
||||
import { LogLevel } from '../logger.class';
|
||||
|
||||
import { fail, LogEntry, PrettifyStackTrace, showLogDetails, showLogObject } from './utils';
|
||||
|
||||
export type { LogEntry };
|
||||
|
||||
export class TestingLogger {
|
||||
private readonly entries: LogEntry[] = [];
|
||||
|
||||
/**
|
||||
* Добавление записи лога
|
||||
*/
|
||||
log(level: LogLevel, message: string, context: string, details?: object) {
|
||||
this.entries.push({
|
||||
level,
|
||||
message,
|
||||
context,
|
||||
...details,
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Очистка всех записей логов
|
||||
*/
|
||||
clear() {
|
||||
this.entries.length = 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* Любые логи (старт без фильтра)
|
||||
*/
|
||||
any(): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, {});
|
||||
}
|
||||
|
||||
/**
|
||||
* Старт от фильтра по сообщению
|
||||
*/
|
||||
withMessage(message: string): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { message });
|
||||
}
|
||||
|
||||
/**
|
||||
* Старт от фильтра по уровню
|
||||
*/
|
||||
withLevel(level: LogLevel): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { level });
|
||||
}
|
||||
|
||||
/**
|
||||
* Старт от фильтра по контексту
|
||||
*/
|
||||
withContext(context: string): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { context });
|
||||
}
|
||||
}
|
||||
|
||||
const BASE_FIELDS: (keyof LogEntry)[] = ['level', 'message', 'context'];
|
||||
|
||||
export class TestingLoggerMatcher {
|
||||
constructor(
|
||||
private readonly entries: LogEntry[],
|
||||
private readonly filter: Partial<LogEntry>,
|
||||
private readonly strict = false,
|
||||
) {}
|
||||
|
||||
get logs() {
|
||||
// В режиме strict мы хотим строгое совпадение деталей: все ключи деталей должны совпадать
|
||||
// и не должно быть лишних ключей деталей у записи.
|
||||
if (this.strict) {
|
||||
return this.entries.filter((log) => {
|
||||
// проверяем базовые поля, если они заданы в фильтре
|
||||
for (const field of BASE_FIELDS) {
|
||||
if (this.filter[field] !== undefined && log[field] !== this.filter[field]) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// ключи деталей в фильтре и в самой записи
|
||||
const detailFilterKeys = Object.keys(this.filter).filter((k) => {
|
||||
return !BASE_FIELDS.includes(k as keyof LogEntry);
|
||||
});
|
||||
const entryDetailKeys = Object.keys(log).filter((k) => {
|
||||
return !BASE_FIELDS.includes(k as keyof LogEntry);
|
||||
});
|
||||
|
||||
// размеры наборов деталей должны совпадать
|
||||
if (detailFilterKeys.length !== entryDetailKeys.length) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// все ключи из фильтра должны присутствовать и иметь одинаковые значения
|
||||
return detailFilterKeys.every((key) => {
|
||||
return log[key] === this.filter[key];
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
return this.entries.filter((log) => {
|
||||
for (const key in this.filter) {
|
||||
if (log[key] !== this.filter[key]) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
});
|
||||
}
|
||||
|
||||
showLogs(options: { hideFilter?: boolean; logs?: LogEntry[] } = {}): this {
|
||||
const { hideFilter = false, logs = this.logs } = options;
|
||||
|
||||
process.stdout.write(colorette.bold(colorette.white('--- Logs ---')) + '\n');
|
||||
|
||||
if (!hideFilter) {
|
||||
process.stdout.write(colorette.bold(colorette.cyan('Filter:')) + '\n');
|
||||
|
||||
if (Object.keys(this.filter).length === 0) {
|
||||
process.stdout.write(' (no filter, showing all logs)\n');
|
||||
} else {
|
||||
showLogDetails({
|
||||
level: this.filter.level,
|
||||
context: this.filter.context,
|
||||
message: this.filter.message,
|
||||
...this.filter,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
process.stdout.write(colorette.bold(colorette.white('Found logs:')) + '\n');
|
||||
|
||||
logs.forEach((log) => {
|
||||
showLogObject(log);
|
||||
process.stdout.write('\n'); // пустая строка между логами
|
||||
});
|
||||
|
||||
process.stdout.write(` Found ${logs.length} log(s) total\n\n`);
|
||||
|
||||
return this;
|
||||
}
|
||||
|
||||
/**
|
||||
* Фильтр по сообщению
|
||||
*/
|
||||
withMessage(message: string): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { ...this.filter, message }, this.strict);
|
||||
}
|
||||
|
||||
/**
|
||||
* Фильтр по уровню
|
||||
*/
|
||||
withLevel(level: LogLevel): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { ...this.filter, level }, this.strict);
|
||||
}
|
||||
|
||||
/**
|
||||
* Фильтр по контексту
|
||||
*/
|
||||
withContext(context: string): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { ...this.filter, context }, this.strict);
|
||||
}
|
||||
|
||||
/**
|
||||
* Фильтр по дополнительным деталям
|
||||
*/
|
||||
withDetails(obj: Record<string, boolean | number | string>): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { ...this.filter, ...obj }, this.strict);
|
||||
}
|
||||
|
||||
/**
|
||||
* Фильтр по дополнительным деталям - строгий (все детали должны совпадать, лишних быть не должно)
|
||||
*/
|
||||
strictDetails(): TestingLoggerMatcher {
|
||||
return new TestingLoggerMatcher(this.entries, { ...this.filter }, true);
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверка наличия логов
|
||||
*/
|
||||
@PrettifyStackTrace()
|
||||
toBeLogged(): void {
|
||||
if (this.logs.length === 0) {
|
||||
if (this.entries.length) {
|
||||
this.toBeLoggedTimes(1);
|
||||
} else {
|
||||
return fail('No logs recorded');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверка отсутствия логов
|
||||
*/
|
||||
@PrettifyStackTrace()
|
||||
toBeNotLogged(): void {
|
||||
this.toBeLoggedTimes(0);
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверка, что лог был записан ровно один раз
|
||||
*/
|
||||
@PrettifyStackTrace()
|
||||
toBeLoggedOnce(): void {
|
||||
this.toBeLoggedTimes(1);
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверка, что лог был записан ровно n раз
|
||||
*/
|
||||
@PrettifyStackTrace()
|
||||
toBeLoggedTimes(n: number): void {
|
||||
if (this.logs.length === n) {
|
||||
return;
|
||||
}
|
||||
|
||||
this.throwDiff(n);
|
||||
}
|
||||
|
||||
private throwDiff(n: number) {
|
||||
if (!this.entries.length) {
|
||||
return fail('No logs recorded');
|
||||
}
|
||||
|
||||
throw new Error(
|
||||
[
|
||||
`Expected ${n} log(s)` + describedFilter(this.filter),
|
||||
this.logs.length ? '\nFound:' : '',
|
||||
...this.logs.map((entry) => ` ${logEntryToString(this.filter)(entry)}`),
|
||||
this.logs.length ? '' : ' (none)',
|
||||
].join('\n'),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
function describedFilter(filter: Partial<LogEntry>): string {
|
||||
const keys = Object.keys(filter);
|
||||
|
||||
if (!keys.length) {
|
||||
return '';
|
||||
}
|
||||
|
||||
return ` matching ${keys.map((key) => `${key}=${String(filter[key])}`).join(', ')}`;
|
||||
}
|
||||
|
||||
function logEntryToString(filter: Partial<LogEntry>) {
|
||||
return (entry: LogEntry): string => {
|
||||
let result = '';
|
||||
|
||||
if (filter.context) {
|
||||
result += `${entry.context} `;
|
||||
}
|
||||
|
||||
if (filter.level) {
|
||||
result += `[${entry.level}] `;
|
||||
}
|
||||
|
||||
if (filter.message) {
|
||||
result += `${entry.message}`;
|
||||
}
|
||||
|
||||
return result;
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,567 @@
|
||||
import { Test } from '@nestjs/testing';
|
||||
import { beforeEach, describe, expect, it } from 'vitest';
|
||||
|
||||
import { Logger } from '../logger.class';
|
||||
import { LocalLoggerModule } from '../logger.module';
|
||||
|
||||
import { TestingLogger } from './testing-logger.class';
|
||||
|
||||
describe('TestingLogger', () => {
|
||||
let mockLogger: Logger;
|
||||
let logger: TestingLogger;
|
||||
|
||||
beforeEach(async () => {
|
||||
const module = await Test.createTestingModule({
|
||||
imports: [LocalLoggerModule.forTesting()],
|
||||
}).compile();
|
||||
|
||||
mockLogger = await module.resolve(Logger);
|
||||
logger = module.get(TestingLogger);
|
||||
});
|
||||
|
||||
it('complex test', () => {
|
||||
// Arrange
|
||||
mockLogger.setContext('RBAC');
|
||||
|
||||
// Act
|
||||
mockLogger.debug('Access granted', { user: 1, permissions: ['read'] });
|
||||
mockLogger.log('Access granted', { user: 2, permissions: ['read', 'write'] });
|
||||
mockLogger.warn('Access denied', { user: 1 });
|
||||
mockLogger.log('User logged in', { user: 1 });
|
||||
mockLogger.error('Unexpected error', { error: new Error('Test error') });
|
||||
|
||||
// Assert
|
||||
const rbacLogger = logger.withContext('RBAC');
|
||||
|
||||
rbacLogger.withMessage('Access denied').toBeLogged();
|
||||
|
||||
rbacLogger.withMessage('Access granted').withLevel('debug').toBeLogged();
|
||||
rbacLogger.withMessage('Access granted').withLevel('info').toBeLogged();
|
||||
rbacLogger.withMessage('User logged in').withLevel('info').toBeLogged();
|
||||
rbacLogger.withMessage('Unexpected error').withLevel('error').toBeLogged();
|
||||
|
||||
rbacLogger.toBeLoggedTimes(5);
|
||||
|
||||
rbacLogger.withMessage('Access granted').toBeLoggedTimes(2);
|
||||
rbacLogger.withMessage('Access denied').toBeLoggedOnce();
|
||||
rbacLogger.withMessage('User logged in').toBeLoggedOnce();
|
||||
rbacLogger.withMessage('Unexpected error').toBeLoggedOnce();
|
||||
|
||||
rbacLogger.withMessage('Access granted').withDetails({ user: 1 }).toBeLoggedOnce();
|
||||
});
|
||||
|
||||
describe('TestingLogger — базовые операции', () => {
|
||||
it('сохраняет запись через log() (все поля + details)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'msg', 'CTX', { a: 1 });
|
||||
|
||||
// Act
|
||||
const matcher = logger.any();
|
||||
|
||||
// Assert
|
||||
matcher.toBeLoggedOnce();
|
||||
// Проверяем точное соответствие
|
||||
const entries = matcher.logs;
|
||||
|
||||
expect(entries[0]).toEqual({
|
||||
level: 'info',
|
||||
message: 'msg',
|
||||
context: 'CTX',
|
||||
a: 1,
|
||||
});
|
||||
});
|
||||
|
||||
it('log() без details не добавляет лишних ключей', () => {
|
||||
// Arrange
|
||||
logger.log('warn', 'msg', 'CTX');
|
||||
|
||||
// Act
|
||||
const matcher = logger.any();
|
||||
|
||||
matcher.toBeLoggedOnce();
|
||||
const entry = matcher.logs[0];
|
||||
|
||||
// Assert
|
||||
expect(entry).toEqual({
|
||||
level: 'warn',
|
||||
message: 'msg',
|
||||
context: 'CTX',
|
||||
});
|
||||
// Проверяем отсутствие произвольных ключей
|
||||
expect(entry.a).toBeUndefined();
|
||||
expect(entry.b).toBeUndefined();
|
||||
});
|
||||
|
||||
it('поля из details перекрывают базовые при совпадении ключей', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'base', 'CTX', {
|
||||
message: 'override',
|
||||
level: 'error',
|
||||
context: 'OVR',
|
||||
});
|
||||
|
||||
// Act
|
||||
const matcher = logger.any();
|
||||
|
||||
matcher.toBeLoggedOnce();
|
||||
const entry = matcher.logs[0];
|
||||
|
||||
// Assert
|
||||
expect(entry).toEqual({
|
||||
level: 'error',
|
||||
message: 'override',
|
||||
context: 'OVR',
|
||||
});
|
||||
});
|
||||
|
||||
it('clear() очищает все записи', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
logger.log('warn', 'B', 'CTX');
|
||||
|
||||
// Act
|
||||
logger.clear();
|
||||
const matcher = logger.any();
|
||||
|
||||
// Assert
|
||||
matcher.toBeNotLogged();
|
||||
});
|
||||
});
|
||||
|
||||
describe('TestingLogger — входные точки фильтрации', () => {
|
||||
it('any() возвращает матчёр со всеми текущими записями', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX1');
|
||||
logger.log('warn', 'B', 'CTX2');
|
||||
logger.log('error', 'C', 'CTX3');
|
||||
|
||||
// Act & Assert
|
||||
logger.any().toBeLoggedTimes(3);
|
||||
});
|
||||
|
||||
it('withMessage("X") создаёт стартовый матчёр с фильтром по message', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'CTX1');
|
||||
logger.log('warn', 'Y', 'CTX2');
|
||||
logger.log('error', 'X', 'CTX3');
|
||||
|
||||
// Act & Assert
|
||||
logger.withMessage('X').toBeLoggedTimes(2);
|
||||
logger.withMessage('Y').toBeLoggedTimes(1);
|
||||
logger.withMessage('Z').toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('withLevel(L) создаёт стартовый матчёр с фильтром по level', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX1');
|
||||
logger.log('error', 'B', 'CTX2');
|
||||
logger.log('error', 'C', 'CTX3');
|
||||
|
||||
// Act & Assert
|
||||
logger.withLevel('info').toBeLoggedTimes(1);
|
||||
logger.withLevel('error').toBeLoggedTimes(2);
|
||||
logger.withLevel('warn').toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('withContext("C") создаёт стартовый матчёр с фильтром по context', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'C');
|
||||
logger.log('warn', 'B', 'CTX2');
|
||||
logger.log('error', 'C', 'C');
|
||||
|
||||
// Act & Assert
|
||||
logger.withContext('C').toBeLoggedTimes(2);
|
||||
logger.withContext('CTX2').toBeLoggedTimes(1);
|
||||
logger.withContext('CTX3').toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('повторные вызовы стартовых фильтров независимы (каждый — новый матчёр)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
logger.log('info', 'B', 'CTX');
|
||||
|
||||
// Act
|
||||
const mA = logger.withMessage('A');
|
||||
const mB = logger.withMessage('B');
|
||||
|
||||
// Assert
|
||||
mA.toBeLoggedTimes(1);
|
||||
mB.toBeLoggedTimes(1);
|
||||
// Проверяем, что фильтры независимы
|
||||
expect(mA.logs[0].message).toBe('A');
|
||||
expect(mB.logs[0].message).toBe('B');
|
||||
});
|
||||
});
|
||||
|
||||
describe('TestingLoggerMatcher — фильтры (локальные)', () => {
|
||||
it('withMessage("X") фильтрует текущий набор по message', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'CTX1');
|
||||
logger.log('warn', 'Y', 'CTX2');
|
||||
logger.log('error', 'X', 'CTX3');
|
||||
logger.log('debug', 'Z', 'CTX4');
|
||||
|
||||
// Act
|
||||
const filtered = logger.any().withMessage('X');
|
||||
|
||||
// Assert
|
||||
filtered.toBeLoggedTimes(2); // Должно остаться только 2 записи с message === 'X'
|
||||
});
|
||||
|
||||
it('withLevel(L) фильтрует текущий набор по level', () => {
|
||||
// Arrange
|
||||
logger.log('warn', 'A', 'CTX1');
|
||||
logger.log('info', 'B', 'CTX2');
|
||||
logger.log('warn', 'C', 'CTX3');
|
||||
logger.log('error', 'D', 'CTX4');
|
||||
|
||||
// Act
|
||||
const filtered = logger.any().withLevel('warn');
|
||||
|
||||
// Assert
|
||||
filtered.toBeLoggedTimes(2); // Должно остаться только 2 записи с level === 'warn'
|
||||
});
|
||||
|
||||
it('withContext("C") фильтрует текущий набор по context', () => {
|
||||
// Arrange
|
||||
logger.log('warn', 'A', 'C');
|
||||
logger.log('info', 'B', 'CTX2');
|
||||
logger.log('warn', 'C', 'C');
|
||||
logger.log('error', 'D', 'CTX4');
|
||||
|
||||
// Act
|
||||
const filtered = logger.any().withContext('C');
|
||||
|
||||
// Assert
|
||||
filtered.toBeLoggedTimes(2); // Должно остаться только 2 записи с context === 'C'
|
||||
});
|
||||
|
||||
it('withDetails({k:v}) оставляет записи, где все пары совпали (логическое И)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1, b: 'x' });
|
||||
logger.log('info', 'B', 'CTX', { a: 1 });
|
||||
logger.log('info', 'C', 'CTX', { b: 'x' });
|
||||
logger.log('info', 'D', 'CTX', { a: 1, b: 'x', c: true });
|
||||
|
||||
// Act
|
||||
const filtered = logger.any().withDetails({ a: 1, b: 'x' });
|
||||
|
||||
// Assert
|
||||
filtered.toBeLoggedTimes(2); // Должны остаться только записи, где одновременно a=1 и b='x'
|
||||
});
|
||||
|
||||
it('комбинация фильтров даёт пересечение условий', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'C', { a: 1 }); // подходит
|
||||
logger.log('info', 'X', 'C', { a: 2 }); // не подходит
|
||||
logger.log('info', 'Y', 'C', { a: 1 }); // не подходит
|
||||
logger.log('warn', 'X', 'C', { a: 1 }); // не подходит
|
||||
|
||||
// Act
|
||||
const filtered = logger
|
||||
.any()
|
||||
.withMessage('X')
|
||||
.withLevel('info')
|
||||
.withContext('C')
|
||||
.withDetails({ a: 1 });
|
||||
|
||||
// Assert
|
||||
filtered.toBeLoggedTimes(1); // Только одна запись удовлетворяет всем условиям
|
||||
});
|
||||
|
||||
it('порядок применения with* не влияет на результат (коммутативность)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'C', { a: 1 }); // подходит
|
||||
logger.log('info', 'X', 'C', { a: 2 }); // не подходит
|
||||
logger.log('info', 'Y', 'C', { a: 1 }); // не подходит
|
||||
logger.log('warn', 'X', 'C', { a: 1 }); // не подходит
|
||||
|
||||
// Act
|
||||
const filtered1 = logger
|
||||
.any()
|
||||
.withMessage('X')
|
||||
.withLevel('info')
|
||||
.withContext('C')
|
||||
.withDetails({ a: 1 });
|
||||
const filtered2 = logger
|
||||
.any()
|
||||
.withDetails({ a: 1 })
|
||||
.withContext('C')
|
||||
.withLevel('info')
|
||||
.withMessage('X');
|
||||
|
||||
// Assert
|
||||
filtered1.toBeLoggedTimes(1);
|
||||
filtered2.toBeLoggedTimes(1);
|
||||
});
|
||||
|
||||
it('фильтры не мутируют исходный матчёр (иммутабельность)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'CTX');
|
||||
logger.log('info', 'Y', 'CTX');
|
||||
|
||||
// Act
|
||||
const m0 = logger.any();
|
||||
const m1 = m0.withMessage('X');
|
||||
|
||||
// Assert
|
||||
m0.toBeLoggedTimes(2); // исходный набор
|
||||
m1.toBeLoggedTimes(1); // отфильтрованный
|
||||
m0.toBeLoggedTimes(2); // повторно исходный набор
|
||||
});
|
||||
|
||||
it('фильтр на пустом наборе остаётся пустым', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
logger
|
||||
.any()
|
||||
.withMessage('non-existent')
|
||||
.withLevel('warn')
|
||||
.withContext('none')
|
||||
.toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('через withDetails можно проверять и другие поля', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
logger
|
||||
.any()
|
||||
.withMessage('A')
|
||||
.withDetails({ level: 'info', context: 'CTX' })
|
||||
.toBeLoggedOnce();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Паритет фильтров в обоих классах', () => {
|
||||
it('старт с TestingLogger.withX(...).withY(...).withZ(...) == any().withX(...).withY(...).withZ(...)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'C', { a: 1 }); // подходит
|
||||
logger.log('info', 'X', 'C', { a: 2 }); // не подходит
|
||||
logger.log('info', 'Y', 'C', { a: 1 }); // не подходит
|
||||
logger.log('warn', 'X', 'C', { a: 1 }); // не подходит
|
||||
|
||||
// Act
|
||||
const fromStart = logger
|
||||
.withMessage('X')
|
||||
.withLevel('info')
|
||||
.withContext('C')
|
||||
.withDetails({ a: 1 });
|
||||
const fromAny = logger
|
||||
.any()
|
||||
.withMessage('X')
|
||||
.withLevel('info')
|
||||
.withContext('C')
|
||||
.withDetails({ a: 1 });
|
||||
|
||||
// Assert
|
||||
fromStart.toBeLoggedTimes(1);
|
||||
fromAny.toBeLoggedTimes(1);
|
||||
// Проверяем, что состав совпадает
|
||||
expect(JSON.stringify(fromStart.logs)).toBe(JSON.stringify(fromAny.logs));
|
||||
});
|
||||
});
|
||||
|
||||
describe('Матчеры наличия/отсутствия', () => {
|
||||
it('toBeLogged() проходит при >= 1 записи', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLogged()).not.toThrow();
|
||||
});
|
||||
|
||||
it('toBeLogged() падает на пустом наборе', () => {
|
||||
// Arrange: ничего не добавляем
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLogged()).toThrowError('No logs recorded');
|
||||
});
|
||||
|
||||
it('toBeNotLogged() проходит при 0 записях', () => {
|
||||
// Arrange: ничего не добавляем
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeNotLogged()).not.toThrow();
|
||||
});
|
||||
|
||||
it('toBeNotLogged() падает при >= 1 записи', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
logger.log('warn', 'B', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeNotLogged()).toThrow();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Матчеры количества', () => {
|
||||
it('toBeLoggedOnce() проходит при ровно 1 записи', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLoggedOnce()).not.toThrow();
|
||||
});
|
||||
|
||||
it('toBeLoggedOnce() падает при 0', () => {
|
||||
// Сценарий A: 0 записей
|
||||
expect(() => logger.any().toBeLoggedOnce()).toThrow();
|
||||
});
|
||||
|
||||
it('toBeLoggedOnce() падает при >1, сообщение содержит count и JSON', () => {
|
||||
// Сценарий B: >1 записей
|
||||
logger.log('info', 'A', 'CTX');
|
||||
logger.log('info', 'B', 'CTX');
|
||||
|
||||
expect(() => logger.any().toBeLoggedOnce()).toThrow();
|
||||
});
|
||||
|
||||
it('toBeLoggedTimes(n) проходит при точном совпадении количества', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
logger.log('info', 'B', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLoggedTimes(2)).not.toThrow();
|
||||
});
|
||||
|
||||
it('toBeLoggedTimes(n) падает при несовпадении (сообщение: ожидаемое и фактическое)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX');
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLoggedTimes(2)).toThrow();
|
||||
});
|
||||
|
||||
it('toBeLoggedTimes(0) проходит на пустом наборе', () => {
|
||||
// Arrange: ничего не добавляем
|
||||
|
||||
// Act & Assert
|
||||
expect(() => logger.any().toBeLoggedTimes(0)).not.toThrow();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Детали и типы значений (withDetails / details)', () => {
|
||||
it('совпадение по string/number/boolean', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 'x' });
|
||||
logger.log('info', 'B', 'CTX', { b: 1 });
|
||||
logger.log('info', 'C', 'CTX', { c: true });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 'x' }).toBeLoggedOnce();
|
||||
logger.any().withDetails({ b: 1 }).toBeLoggedOnce();
|
||||
logger.any().withDetails({ c: true }).toBeLoggedOnce();
|
||||
});
|
||||
|
||||
it('несуществующий ключ в фильтре исключает запись', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ d: 42 }).toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('частичное несоответствие по одному из ключей исключает запись', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1, b: 2 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 1, b: 999 }).toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('различие по типу (число vs строка) не считается совпадением', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
|
||||
// Act & Assert
|
||||
logger
|
||||
.any()
|
||||
.withDetails({ a: '1' as unknown as number })
|
||||
.toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('дополнительные поля в записи не мешают совпадению (подмножество)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1, b: 2, c: 3 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 1 }).toBeLoggedOnce();
|
||||
});
|
||||
|
||||
it('strictDetails требует точного совпадения ключей деталей (не допускает лишних полей)', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'X', 'CTX', { a: 1, b: 2 });
|
||||
|
||||
// Act & Assert
|
||||
// Обычный withDetails допускает совпадение по подмножеству
|
||||
logger.any().withDetails({ a: 1 }).toBeLoggedOnce();
|
||||
|
||||
// strictDetails требует точного совпадения — запись с лишним полем не должна подходить
|
||||
logger.any().withDetails({ a: 1 }).strictDetails().toBeLoggedTimes(0);
|
||||
});
|
||||
|
||||
it('strictDetails проходит при полном совпадении деталей', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'Y', 'CTX', { a: 1 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 1 }).strictDetails().toBeLoggedOnce();
|
||||
});
|
||||
});
|
||||
|
||||
describe('Граничные случаи', () => {
|
||||
it('дубликаты идентичных логов учитываются поштучно в подсчёте', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 1 }).toBeLoggedTimes(3);
|
||||
});
|
||||
|
||||
it('одинаковые level/message/context, но разные details различаются withDetails', () => {
|
||||
// Arrange
|
||||
logger.log('info', 'A', 'CTX', { a: 1 });
|
||||
logger.log('info', 'A', 'CTX', { a: 2 });
|
||||
|
||||
// Act & Assert
|
||||
logger.any().withDetails({ a: 1 }).toBeLoggedOnce();
|
||||
logger.any().withDetails({ a: 2 }).toBeLoggedOnce();
|
||||
});
|
||||
|
||||
it('пустые строки корректно фильтруются: withMessage("") / withContext("")', () => {
|
||||
// Arrange
|
||||
logger.log('info', '', 'CTX', { a: 1 });
|
||||
logger.log('info', 'A', '', { a: 2 });
|
||||
logger.log('info', '', '', { a: 3 });
|
||||
|
||||
// Act & Assert
|
||||
logger.withMessage('').toBeLoggedTimes(2); // две записи с пустым message
|
||||
logger.withContext('').toBeLoggedTimes(2); // две записи с пустым context
|
||||
});
|
||||
|
||||
it('smoke: большое количество записей не ломает фильтры', () => {
|
||||
// Arrange
|
||||
const N = 1000;
|
||||
|
||||
for (let i = 0; i < N; i++) {
|
||||
logger.log('info', `msg${i % 10}`, `CTX${i % 5}`, { a: i % 3, b: i });
|
||||
}
|
||||
|
||||
// Act & Assert
|
||||
logger.withMessage('msg1').toBeLoggedTimes(100);
|
||||
logger.withContext('CTX2').toBeLoggedTimes(200);
|
||||
logger
|
||||
.any()
|
||||
.withDetails({ a: 0 })
|
||||
.toBeLoggedTimes(Math.floor(N / 3) + (N % 3 > 0 ? 1 : 0));
|
||||
logger.any().withDetails({ b: 42 }).toBeLoggedOnce();
|
||||
});
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,65 @@
|
||||
import * as colorette from 'colorette';
|
||||
|
||||
import { LogLevel } from '../logger.class';
|
||||
|
||||
export interface LogEntry {
|
||||
level: LogLevel;
|
||||
message: string;
|
||||
context: string;
|
||||
[extra: string]: unknown;
|
||||
}
|
||||
|
||||
export function fail(message: string): void {
|
||||
throw new Error(message);
|
||||
}
|
||||
|
||||
type ErrorConstructorWithCapture = ErrorConstructor & {
|
||||
captureStackTrace?: (targetObject: object, constructorOpt?: unknown) => void;
|
||||
};
|
||||
|
||||
/**
|
||||
* Декоратор для методов матчеров:
|
||||
* Если метод бросил ошибку — стек "подрезается" так,
|
||||
* чтобы указать на строку вызова матчера в тесте (а не внутрь реализации).
|
||||
*/
|
||||
export function PrettifyStackTrace(): MethodDecorator {
|
||||
return (_target, _key, descriptor: PropertyDescriptor) => {
|
||||
const original = descriptor.value as (...args: unknown[]) => unknown;
|
||||
|
||||
function wrap(this: unknown, ...args: unknown[]) {
|
||||
try {
|
||||
return original.apply(this, args);
|
||||
} catch (err) {
|
||||
(Error as ErrorConstructorWithCapture).captureStackTrace?.(err as object, wrap);
|
||||
|
||||
throw err;
|
||||
}
|
||||
}
|
||||
|
||||
descriptor.value = wrap;
|
||||
|
||||
return descriptor;
|
||||
};
|
||||
}
|
||||
|
||||
export function showLogObject({ level, context, message, ...details }: LogEntry) {
|
||||
const l = colorette.blue(level);
|
||||
const c = colorette.bold(colorette.magenta(context));
|
||||
const m = colorette.underline(colorette.white(message));
|
||||
|
||||
process.stdout.write(` ${l} ${c} ${m}\n`);
|
||||
|
||||
showLogDetails(details);
|
||||
}
|
||||
|
||||
export function showLogDetails(details: Record<string, unknown>) {
|
||||
Object.keys(details).forEach((key) => {
|
||||
if (details[key] === undefined) {
|
||||
return;
|
||||
}
|
||||
|
||||
process.stdout.write(
|
||||
` ${colorette.blue(key)}: ${colorette.yellow(String(details[key]))}\n`,
|
||||
);
|
||||
});
|
||||
}
|
||||
@@ -0,0 +1,62 @@
|
||||
import { NestFactory } from '@nestjs/core';
|
||||
import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
|
||||
|
||||
import { AppModule } from './app/app.module';
|
||||
import { getBaseLogger, LocalLoggerModule, Logger } from './logger';
|
||||
|
||||
async function start() {
|
||||
const PORT = process.env.PORT || 5000;
|
||||
|
||||
const app = await NestFactory.create(AppModule, {
|
||||
bufferLogs: true,
|
||||
});
|
||||
|
||||
// Подменяем логгер Nest на pino; накопленный в буфере вывод сбрасывается в него же
|
||||
LocalLoggerModule.setup(app);
|
||||
|
||||
const logger = new Logger('Bootstrap');
|
||||
|
||||
logger.log('Logging started', {
|
||||
level: getBaseLogger().level,
|
||||
pretty: process.env.NODE_ENV !== 'production' && process.env.LOG_PRETTY !== 'false',
|
||||
});
|
||||
|
||||
// настройка swaggera
|
||||
const config = new DocumentBuilder()
|
||||
.setTitle('GEO Helm Backend')
|
||||
.setDescription('Documentation for the GEO Helm Backend')
|
||||
.setVersion('1.0.0')
|
||||
.addBearerAuth(
|
||||
{
|
||||
type: 'http',
|
||||
scheme: 'bearer',
|
||||
bearerFormat: 'JWT',
|
||||
name: 'JWT',
|
||||
description: 'Enter JWT token',
|
||||
in: 'header',
|
||||
},
|
||||
'JWT-auth',
|
||||
)
|
||||
.build();
|
||||
app.enableShutdownHooks();
|
||||
app.setGlobalPrefix('api');
|
||||
const server = app.getHttpServer();
|
||||
server.setTimeout(20 * 60 * 1000); // 20-minute window for heavy calculations
|
||||
// подключаем swagger к приложению и указываем путь к документации
|
||||
const document = SwaggerModule.createDocument(app, config);
|
||||
SwaggerModule.setup('/api/docs', app, document);
|
||||
app.enableCors({
|
||||
origin:
|
||||
process.env.NODE_ENV === 'development'
|
||||
? ['http://localhost:5173']
|
||||
: ['https://app.igeo.pro'],
|
||||
methods: 'GET,HEAD,PUT,PATCH,POST,DELETE',
|
||||
allowedHeaders: 'Content-Type, Authorization',
|
||||
credentials: true,
|
||||
});
|
||||
|
||||
await app.listen(PORT);
|
||||
|
||||
logger.log('Server started', { port: PORT });
|
||||
}
|
||||
start();
|
||||
@@ -0,0 +1,3 @@
|
||||
// Файл сгенерирован автоматически (tools/buildDataSource.ts). Не редактировать вручную.
|
||||
|
||||
export const migrations = [];
|
||||
@@ -0,0 +1 @@
|
||||
import 'reflect-metadata';
|
||||
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"extends": "../../tsconfig.base.json",
|
||||
"compilerOptions": {
|
||||
"outDir": "dist",
|
||||
"types": [
|
||||
"node",
|
||||
"multer"
|
||||
],
|
||||
"rootDir": "src",
|
||||
"tsBuildInfoFile": "dist/tsconfig.app.tsbuildinfo",
|
||||
"experimentalDecorators": true,
|
||||
"emitDecoratorMetadata": true,
|
||||
"target": "es2024"
|
||||
},
|
||||
"include": [
|
||||
"src/**/*.ts"
|
||||
],
|
||||
"exclude": [
|
||||
"eslint.config.js",
|
||||
"eslint.config.cjs",
|
||||
"eslint.config.mjs",
|
||||
"src/**/*.spec.ts"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,13 @@
|
||||
{
|
||||
"extends": "../../tsconfig.base.json",
|
||||
"files": [],
|
||||
"include": [],
|
||||
"references": [
|
||||
{
|
||||
"path": "./tsconfig.app.json"
|
||||
},
|
||||
{
|
||||
"path": "./tsconfig.spec.json"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"extends": "../../tsconfig.base.json",
|
||||
"compilerOptions": {
|
||||
"outDir": "./out-tsc/vitest",
|
||||
"types": [
|
||||
"node",
|
||||
"multer"
|
||||
],
|
||||
"experimentalDecorators": true,
|
||||
"emitDecoratorMetadata": true,
|
||||
"target": "es2024"
|
||||
},
|
||||
"include": [
|
||||
"src/**/*.ts"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,35 @@
|
||||
/// <reference types='vitest' />
|
||||
import { resolve } from 'path';
|
||||
|
||||
import swc from 'unplugin-swc';
|
||||
import { defineConfig } from 'vite';
|
||||
|
||||
export default defineConfig({
|
||||
root: import.meta.dirname,
|
||||
// unplugin-swc emits decorator metadata that esbuild cannot produce; TypeORM relies on it.
|
||||
plugins: [
|
||||
swc.vite({
|
||||
jsc: {
|
||||
parser: { syntax: 'typescript', decorators: true },
|
||||
transform: { decoratorMetadata: true, legacyDecorator: true },
|
||||
target: 'es2022',
|
||||
},
|
||||
}),
|
||||
],
|
||||
resolve: {
|
||||
alias: {
|
||||
'@it-smi/api': resolve(import.meta.dirname, 'src'),
|
||||
},
|
||||
},
|
||||
test: {
|
||||
name: '@it-smi/api',
|
||||
globals: true,
|
||||
environment: 'node',
|
||||
include: ['src/**/*.{test,spec}.ts'],
|
||||
setupFiles: ['src/test-setup.ts'],
|
||||
coverage: {
|
||||
reportsDirectory: './test-output/vitest/coverage',
|
||||
provider: 'v8',
|
||||
},
|
||||
},
|
||||
});
|
||||
@@ -0,0 +1,51 @@
|
||||
const { join } = require('path');
|
||||
|
||||
const { NxAppWebpackPlugin } = require('@nx/webpack/app-plugin');
|
||||
|
||||
const { DenyExternalsPlugin } = require('./deny-external-plugin');
|
||||
|
||||
/**
|
||||
* Общая база для двух бандлов api: main.js и data-source.js.
|
||||
*
|
||||
* Вынесена, чтобы alias, tsConfig и связка externalDependencies: 'none' +
|
||||
* DenyExternalsPlugin задавались один раз: если они разойдутся, data-source.js
|
||||
* получит второй экземпляр typeorm и это всплывёт только на реальном деплое,
|
||||
* в `docker exec … migration:run`.
|
||||
*
|
||||
* @param {object} params
|
||||
* @param {object} params.output — поверх output базы (filename, clean, library, …)
|
||||
* @param {object} params.nxPlugin — поверх опций NxAppWebpackPlugin (main, sourceMap, …)
|
||||
* @param {Array} [params.plugins] — дополнительные плагины после DenyExternalsPlugin
|
||||
*/
|
||||
function createApiWebpackConfig({ output, nxPlugin, plugins = [] }) {
|
||||
return {
|
||||
output: {
|
||||
path: join(__dirname, 'dist'),
|
||||
...output,
|
||||
},
|
||||
resolve: {
|
||||
alias: {
|
||||
'@it-smi/api': join(__dirname, 'src'),
|
||||
},
|
||||
extensions: ['.ts', '.tsx', '.js', '.jsx', '.json'],
|
||||
},
|
||||
plugins: [
|
||||
new NxAppWebpackPlugin({
|
||||
target: 'node',
|
||||
compiler: 'tsc',
|
||||
tsConfig: './tsconfig.app.json',
|
||||
optimization: false,
|
||||
outputHashing: 'none',
|
||||
externalDependencies: 'none',
|
||||
...nxPlugin,
|
||||
}),
|
||||
// Обязательно в паре с externalDependencies: 'none'. Без плагина webpack
|
||||
// вкомпилирует второй экземпляр typeorm, и он перестанет быть тем же
|
||||
// модулем, что грузит CLI.
|
||||
new DenyExternalsPlugin(['@it-smi/']),
|
||||
...plugins,
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { createApiWebpackConfig };
|
||||
@@ -0,0 +1,22 @@
|
||||
const webpack = require('webpack');
|
||||
|
||||
const { createApiWebpackConfig } = require('./webpack.base');
|
||||
|
||||
module.exports = createApiWebpackConfig({
|
||||
output: {
|
||||
clean: true,
|
||||
...(process.env.NODE_ENV !== 'production' && {
|
||||
devtoolModuleFilenameTemplate: '[absolute-resource-path]',
|
||||
}),
|
||||
},
|
||||
nxPlugin: {
|
||||
main: './src/main.ts',
|
||||
generatePackageJson: true,
|
||||
sourceMap: true,
|
||||
},
|
||||
plugins: [
|
||||
new webpack.DefinePlugin({
|
||||
__APP_VERSION__: JSON.stringify(process.env.APP_VERSION || 'unknown'),
|
||||
}),
|
||||
],
|
||||
});
|
||||
@@ -0,0 +1,28 @@
|
||||
const { createApiWebpackConfig } = require('./webpack.base');
|
||||
|
||||
/**
|
||||
* Отдельный бандл DataSource для typeorm CLI внутри контейнера.
|
||||
*
|
||||
* Собирается в тот же dist, что и main.js, поэтому clean: false —
|
||||
* иначе сборка затрёт основной бандл.
|
||||
*
|
||||
* Запускать после основного webpack.config.js (см. таргет api:build,
|
||||
* там же parallel: false).
|
||||
*/
|
||||
module.exports = createApiWebpackConfig({
|
||||
output: {
|
||||
filename: 'data-source.js',
|
||||
// Не чистим dist: рядом лежит main.js от основной сборки.
|
||||
clean: false,
|
||||
library: {
|
||||
type: 'commonjs2',
|
||||
export: 'default',
|
||||
},
|
||||
},
|
||||
nxPlugin: {
|
||||
main: './src/config/typeorm.config.ts',
|
||||
generatePackageJson: false,
|
||||
// Бандл запускается только руками через docker exec — .map в образе не нужен.
|
||||
sourceMap: false,
|
||||
},
|
||||
});
|
||||
Reference in new issue
Block a user