@application-kit/observability 0.7.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @application-kit/observability
 
+## 0.8.1
+
+### Patch Changes
+
+- fd54b47: Peer-зависимости принимают `@nestjs/typeorm` 12, у `@application-kit/observability` ещё и `@nestjs/terminus` 12. С `@nestjs/typeorm` 12 readiness-проверке observability нужен `@nestjs/terminus` 12: 11.x импортирует `@nestjs/typeorm/dist/*`, а карта `exports` typeorm 12 этот путь закрывает, и `/health/ready` отвечает 500.
+- Updated dependencies [fd54b47]
+  - @application-kit/typeorm@0.5.1
+
+## 0.8.0
+
+### Minor Changes
+
+- 49a8dd8: Вход `/tracing` ставит ESM-хук через `module.registerHooks()` (`import-in-the-middle/register-hooks.mjs`) вместо
+  устаревшего `module.register()`: Node 26 больше не печатает `DEP0205` на старте. Потребителю — добавить peer
+  `import-in-the-middle` `^3.3.3` (та же копия, что у `@opentelemetry/instrumentation`: две копии оставляют
+  `esmHookedModules` без спанов) и держать Node `^24.11.1 || >=25.1.0` — на более старых синхронный хук не работает.
+
 ## 0.7.0
 
 ### Minor Changes

package/README.md

@@ -156,8 +156,14 @@ const clientIp = resolveClientIp(request, { trustedHeaders: ['cf-connecting-ip']
 
 Вызов — в отдельном файле, который бандлер собирает в свой выход и который процесс грузит флагом рантайма
 `node --import ./tracing.mjs`: инструментации патчат модули в момент загрузки, а ESM выполняет все `import` бандла до
-его первой строки, поэтому импорт из кода приложения опоздал бы. Вход только ESM — `module.register` есть лишь у
-ESM-загрузчика.
+его первой строки, поэтому импорт из кода приложения опоздал бы. Вход только ESM: его грузит `--import`, и хук
+`import-in-the-middle/register-hooks.mjs` — тоже ESM.
+
+ESM-хук ставится синхронным `module.registerHooks()` в потоке приложения. Такие хуки есть в Node с 24.11.1 и 25.1.0,
+отсюда `engines` пакета. `import-in-the-middle` — peer: загрузчик и `Hook()` инструментаций делят состояние модуля, поэтому
+у приложения он должен быть одной копией с `@opentelemetry/instrumentation`. Со второй копией модули из `esmHookedModules`
+молча остаются без спанов. Проверка — `grep -c '^"import-in-the-middle@' yarn.lock` → `1`; иначе
+`yarn dedupe import-in-the-middle`.
 
 - `esmHookedModules` — пакеты, которые бандл импортирует как ESM (например `kafkajs`): до них не дотягивается
   require-in-the-middle. Хук без списка обернул бы и чанки самого бандла и порвал бы им live-binding.
@@ -179,4 +185,4 @@ startTracing({
 ```
 
 Версии `@opentelemetry/*` с номером `0.x` выходят одним релизом и между собой совместимы только в пределах одного минора:
-`sdk-node`, `instrumentation`, `instrumentation-http` и `exporter-trace-otlp-grpc` ставятся одной версией `0.221.x`.
+`sdk-node`, `instrumentation`, `instrumentation-http` и `exporter-trace-otlp-grpc` ставятся одной версией `0.300.x`.

package/dist/cjs/health/health-checks.d.ts

@@ -1,4 +1,5 @@
-import { DiskHealthIndicator, HealthIndicatorFunction, MemoryHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
+import type { HealthIndicatorResult } from '@nestjs/terminus';
+import { DiskHealthIndicator, MemoryHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
 import { HealthConfig } from './health.config.js';
 export declare class HealthChecks {
     private readonly database;
@@ -6,5 +7,5 @@ export declare class HealthChecks {
     private readonly disk;
     private readonly config;
     constructor(database: TypeOrmHealthIndicator, memory: MemoryHealthIndicator, disk: DiskHealthIndicator, config: HealthConfig);
-    build(): HealthIndicatorFunction[];
+    build(): (() => Promise<HealthIndicatorResult>)[];
 }

package/dist/esm/health/health-checks.d.ts

@@ -1,4 +1,5 @@
-import { DiskHealthIndicator, HealthIndicatorFunction, MemoryHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
+import type { HealthIndicatorResult } from '@nestjs/terminus';
+import { DiskHealthIndicator, MemoryHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
 import { HealthConfig } from './health.config.js';
 export declare class HealthChecks {
     private readonly database;
@@ -6,5 +7,5 @@ export declare class HealthChecks {
     private readonly disk;
     private readonly config;
     constructor(database: TypeOrmHealthIndicator, memory: MemoryHealthIndicator, disk: DiskHealthIndicator, config: HealthConfig);
-    build(): HealthIndicatorFunction[];
+    build(): (() => Promise<HealthIndicatorResult>)[];
 }

package/dist/esm/health/health-checks.js

@@ -11,7 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { Inject, Injectable } from '@nestjs/common';
-import { DiskHealthIndicator, MemoryHealthIndicator, TypeOrmHealthIndicator, } from '@nestjs/terminus';
+import { DiskHealthIndicator, MemoryHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
 import { HealthConfig } from './health.config.js';
 let HealthChecks = class HealthChecks {
     database;

package/dist/esm/tracing/start-tracing.js

@@ -2,7 +2,7 @@ import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
 import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
 import { NodeSDK } from '@opentelemetry/sdk-node';
 import { ATTR_CLIENT_ADDRESS } from '@opentelemetry/semantic-conventions';
-import { register } from 'node:module';
+import { register as registerEsmHook } from 'import-in-the-middle/register-hooks.mjs';
 import nodeProcess from 'node:process';
 import { resolveClientIp } from '../http/resolve-client-ip.js';
 import { isInfrastructurePath } from '../logging/infrastructure-paths.js';
@@ -37,9 +37,7 @@ export const startTracing = (options) => {
     if (tracesEndpoint() === '') {
         return undefined;
     }
-    register('@opentelemetry/instrumentation/hook.mjs', import.meta.url, {
-        data: { include: options.esmHookedModules },
-    });
+    registerEsmHook({ include: options.esmHookedModules });
     const sdk = new NodeSDK({
         instrumentations: [
             createHttpInstrumentation(options.resolveClientIp),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/observability",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "Наблюдаемость NestJS-процесса: метрики Prometheus и RED-гистограммы, health-чеки и пробы, опции pino с request-id и trace-контекстом, логирование CQRS-шин, реальный IP клиента за прокси, трейсинг OpenTelemetry",
   "keywords": [
     "cqrs",
@@ -122,7 +122,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@application-kit/typeorm": "^0.5.0"
+    "@application-kit/typeorm": "^0.5.1"
   },
   "devDependencies": {
     "@nestjs/common": "^11.2.7",
@@ -130,9 +130,9 @@
     "@nestjs/cqrs": "^11.0.3",
     "@nestjs/graphql": "^13.4.5",
     "@nestjs/platform-fastify": "^11.2.7",
-    "@nestjs/terminus": "^11.1.1",
+    "@nestjs/terminus": "^12.1.0",
     "@nestjs/testing": "^11.2.7",
-    "@nestjs/typeorm": "^11.0.3",
+    "@nestjs/typeorm": "^12.0.2",
     "@opentelemetry/api": "^1.10.0",
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.300.0",
     "@opentelemetry/instrumentation": "^0.300.0",
@@ -147,6 +147,7 @@
     "class-validator": "^0.15.1",
     "fastify": "^5.12.5",
     "graphql": "^16.14.2",
+    "import-in-the-middle": "^3.5.2",
     "nestjs-console": "^10.0.0",
     "nestjs-pino": "^4.6.1",
     "pino": "^10.3.1",
@@ -161,8 +162,8 @@
     "@nestjs/cqrs": "^11.0.0",
     "@nestjs/graphql": "^13.0.0",
     "@nestjs/platform-fastify": "^11.0.0",
-    "@nestjs/terminus": "^11.0.0",
-    "@nestjs/typeorm": "^11.0.0",
+    "@nestjs/terminus": "^11.0.0 || ^12.0.0",
+    "@nestjs/typeorm": "^11.0.0 || ^12.0.0",
     "@opentelemetry/api": "^1.10.0",
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.300.0",
     "@opentelemetry/instrumentation": "^0.300.0",
@@ -174,6 +175,7 @@
     "class-validator": "^0.15.1",
     "fastify": "^5.0.0",
     "graphql": "^16.0.0",
+    "import-in-the-middle": "^3.3.3",
     "nestjs-console": "^10.0.0",
     "nestjs-pino": "^4.6.1",
     "pino": "^10.0.0",
@@ -225,6 +227,9 @@
     "graphql": {
       "optional": true
     },
+    "import-in-the-middle": {
+      "optional": true
+    },
     "nestjs-console": {
       "optional": true
     },
@@ -239,7 +244,7 @@
     }
   },
   "engines": {
-    "node": ">=24"
+    "node": "^24.11.1 || >=25.1.0"
   },
   "publishConfig": {
     "access": "public"