@application-kit/observability 0.8.3 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @application-kit/observability
 
+## 0.10.0
+
+### Minor Changes
+
+- 3a17e1a: Корень наблюдаемости одним вызовом: вход `/nest` — `ObservabilityRootModule.forRoot({ imports, resolveClientIp })` (pino, логгер приложения под `OBSERVABILITY_LOGGER`, ядро health-чека) и `ObservabilityWebModule.forRoot({ publicRoute })` (HTTP-носители `/health` и `/metrics`). Вход `/logging/nest` — класс `ApplicationLogger`.
+
+## 0.9.0
+
+### Minor Changes
+
+- 504f068: Вход `/http`: `resolveRequestFacts(request, { trustedHeaders })` отдаёт `{ ip, userAgent }`, не определившийся факт — `null`. `firstHeaderValue(value)` теперь в экспорте: первое значение повторяющегося заголовка без краевых пробелов, `null` у отсутствующего или пустого. `resolveClientIp` работает как раньше.
+
 ## 0.8.3
 
 ### Patch Changes

package/README.md

@@ -21,13 +21,37 @@ Peer-зависимости: `@nestjs/common`, `@prometheus-io/client`; оста
 | `@application-kit/observability/health` | состав чека, пробы `/health/live` и `/health/ready`, `GET /health` | `@nestjs/terminus`, `@nestjs/typeorm`, `typeorm`, `@application-kit/typeorm`, `class-validator`, `class-transformer` |
 | `@application-kit/observability/health/graphql` | `query { health { status } }` | `/health` + `@nestjs/graphql` |
 | `@application-kit/observability/health/cli` | CLI-команда `<группа> health` | `/health` + `nestjs-console` |
-| `@application-kit/observability/http` | `resolveClientIp` — IP клиента за прокси | ничего |
+| `@application-kit/observability/http` | `resolveClientIp`, `resolveRequestFacts`, `firstHeaderValue` — IP клиента за прокси и факты запроса | ничего |
 | `@application-kit/observability/logging` | опции nestjs-pino, request-id, support-id, служебные пути, токен логгера | `@opentelemetry/api`, `class-validator`, `class-transformer`; типы — `nestjs-pino`, `pino` |
+| `@application-kit/observability/logging/nest` | `ApplicationLogger` — `PinoLogger` с контекстом приложения | `@nestjs/common`, `nestjs-pino` |
 | `@application-kit/observability/metrics` | реестр, гистограммы HTTP и GraphQL, `GET /metrics`, хуки Fastify, сервер `/metrics` | `@nestjs/common`, `@prometheus-io/client`; типы — `fastify`, `@nestjs/platform-fastify` |
+| `@application-kit/observability/nest` | `ObservabilityRootModule`, `ObservabilityWebModule` — сборка логирования, health и метрик | `nestjs-pino`, `pino` + зависимости `/health`, `/logging`, `/metrics` |
 | `@application-kit/observability/tracing` | `startTracing` — OpenTelemetry NodeSDK для `node --import`, только ESM | `@opentelemetry/sdk-node`, `@opentelemetry/instrumentation`, `@opentelemetry/instrumentation-http`, `@opentelemetry/exporter-trace-otlp-grpc`, `@opentelemetry/semantic-conventions` |
 
 Корневого входа нет: каждый вход несёт свои peer-зависимости, и лишнего потребитель не ставит.
 
+## Сборка процесса (`/nest`)
+
+`ObservabilityRootModule.forRoot` — глобальный корень на процесс: `LoggerModule` nestjs-pino, `ApplicationLogger` под
+`OBSERVABILITY_LOGGER`, ядро health-чека с логгером pino в terminus. `ObservabilityWebModule.forRoot` — только в
+web-графе: HTTP-носители `/health` и `/metrics`. `HealthGraphqlModule` подключается отдельно: его вход требует `@nestjs/graphql`.
+
+```ts
+@Module({
+  imports: [
+    ObservabilityRootModule.forRoot({
+      imports: [healthConfigsModule, loggerConfigsModule],
+      resolveClientIp: resolveRequestClientIp,
+    }),
+    ObservabilityWebModule.forRoot({ publicRoute: Public() }),
+    HealthGraphqlModule.forRoot({ publicRoute: Public() }),
+  ],
+})
+export class WebModule {}
+```
+
+`resolveClientIp` необязателен: дефолт и доверенные заголовки — раздел «IP клиента за прокси».
+
 ## Метрики
 
 - `MetricsRegistry` — провайдер с собственным `Registry` (не глобальным: экземпляры независимы) и метриками процесса
@@ -109,7 +133,7 @@ export class AppModule {}
 
 ## Health-чек (`/health`)
 
-`HealthModule.forRoot({ imports, logger })` — глобальное ядро процесса: terminus и `HealthChecks` (ping БД, heap, RSS,
+`HealthModule.forRoot({ imports, terminus })` — глобальное ядро процесса: terminus и `HealthChecks` (ping БД, heap, RSS,
 диск по корню; пороги — `HealthConfig`/`HealthEnvironment`). Носители подключаются там, где нужны, и берут состав
 отсюда — вердикт не зависит от того, каким путём спросили:
 
@@ -125,7 +149,7 @@ export class AppModule {}
 ```ts
 @Module({
   imports: [
-    HealthModule.forRoot({ imports: [healthConfigsModule], logger: Logger }),
+    HealthModule.forRoot({ imports: [healthConfigsModule], terminus: { logger: Logger } }),
     HealthHttpModule.forRoot({ publicRoute: Public() }),
     HealthGraphqlModule.forRoot({ publicRoute: Public() }),
   ],
@@ -146,6 +170,18 @@ export class WebModule {}
 const clientIp = resolveClientIp(request, { trustedHeaders: ['cf-connecting-ip'] })
 ```
 
+## Факты запроса
+
+`resolveRequestFacts(request, { trustedHeaders })` — `{ ip, userAgent }` для строки сессии или журнала: адрес берётся из
+`resolveClientIp` с теми же опциями, не определившийся факт — `null`. `firstHeaderValue(value)` — значение заголовка одной
+строкой: первое у повторяющегося, без краевых пробелов, `null` у отсутствующего или пустого.
+
+Где лежит текущий запрос и что ещё считать фактами (актор, роль), функция не знает: это решает приложение.
+
+```ts
+const facts = resolveRequestFacts(request, { trustedHeaders: ['cf-connecting-ip'] })
+```
+
 ## Трейсинг (`/tracing`)
 
 `startTracing({ esmHookedModules, instrumentations, resolveClientIp })` поднимает OpenTelemetry NodeSDK: OTLP gRPC-экспортёр,

package/dist/cjs/http/first-header-value.d.ts

@@ -0,0 +1 @@
+export declare const firstHeaderValue: (value: string | string[] | undefined) => null | string;

package/dist/cjs/http/first-header-value.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firstHeaderValue = void 0;
+const firstHeaderValue = (value) => {
+    const single = Array.isArray(value) ? value[0] : value;
+    const trimmed = (single ?? '').trim();
+    return trimmed === '' ? null : trimmed;
+};
+exports.firstHeaderValue = firstHeaderValue;

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

@@ -1,2 +1,4 @@
 export * from './client-ip-options.interface.js';
+export * from './first-header-value.js';
 export * from './resolve-client-ip.js';
+export * from './resolve-request-facts.js';

package/dist/cjs/http/index.js

@@ -15,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client-ip-options.interface.js"), exports);
+__exportStar(require("./first-header-value.js"), exports);
 __exportStar(require("./resolve-client-ip.js"), exports);
+__exportStar(require("./resolve-request-facts.js"), exports);

package/dist/cjs/http/resolve-client-ip.js

@@ -1,13 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveClientIp = void 0;
-const firstHeaderValue = (value) => {
-    const single = Array.isArray(value) ? value[0] : value;
-    return (single ?? '').trim();
-};
+const first_header_value_js_1 = require("./first-header-value.js");
 const trustedHeaderIp = (request, trustedHeaders) => {
-    const values = trustedHeaders?.map((header) => firstHeaderValue(request.headers?.[header]));
-    return values?.find((value) => value !== '') ?? '';
+    const values = trustedHeaders?.map((header) => (0, first_header_value_js_1.firstHeaderValue)(request.headers?.[header]));
+    return values?.find((value) => value !== null) ?? '';
 };
 const rawSocketIp = (request) => request.raw?.socket?.remoteAddress ?? '';
 const socketIp = (request) => request.socket?.remoteAddress ?? rawSocketIp(request);

package/dist/cjs/http/resolve-request-facts.d.ts

@@ -0,0 +1,7 @@
+import type { ClientIpOptionsInterface } from './client-ip-options.interface.js';
+import type { ClientIpSourceInterface } from './resolve-client-ip.js';
+export interface RequestFactsInterface {
+    ip: null | string;
+    userAgent: null | string;
+}
+export declare const resolveRequestFacts: (request: ClientIpSourceInterface, options?: ClientIpOptionsInterface) => RequestFactsInterface;

package/dist/cjs/http/resolve-request-facts.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRequestFacts = void 0;
+const first_header_value_js_1 = require("./first-header-value.js");
+const resolve_client_ip_js_1 = require("./resolve-client-ip.js");
+const USER_AGENT_HEADER = 'user-agent';
+const resolveRequestFacts = (request, options = {}) => {
+    const ip = (0, resolve_client_ip_js_1.resolveClientIp)(request, options);
+    return {
+        ip: ip === '' ? null : ip,
+        userAgent: (0, first_header_value_js_1.firstHeaderValue)(request.headers?.[USER_AGENT_HEADER]),
+    };
+};
+exports.resolveRequestFacts = resolveRequestFacts;

package/dist/cjs/logging/nest/application-logger.d.ts

@@ -0,0 +1,5 @@
+import * as nestjsPino from 'nestjs-pino';
+import type { ObservabilityLoggerInterface } from '../observability-logger.interface.js';
+export declare class ApplicationLogger extends nestjsPino.PinoLogger implements ObservabilityLoggerInterface {
+    constructor(options: nestjsPino.Params);
+}

package/dist/cjs/logging/nest/application-logger.js

@@ -0,0 +1,59 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ApplicationLogger_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationLogger = void 0;
+const common_1 = require("@nestjs/common");
+const nestjsPino = __importStar(require("nestjs-pino"));
+let ApplicationLogger = ApplicationLogger_1 = class ApplicationLogger extends nestjsPino.PinoLogger {
+    constructor(options) {
+        super(options);
+        this.setContext(ApplicationLogger_1.name);
+    }
+};
+exports.ApplicationLogger = ApplicationLogger;
+exports.ApplicationLogger = ApplicationLogger = ApplicationLogger_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object])
+], ApplicationLogger);

package/dist/cjs/logging/nest/index.d.ts

@@ -0,0 +1 @@
+export * from './application-logger.js';

package/dist/cjs/logging/nest/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("./application-logger.js"), exports);

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

@@ -0,0 +1,3 @@
+export * from './observability-root-module-options.interface.js';
+export * from './observability-root.module.js';
+export * from './observability-web.module.js';

package/dist/cjs/nest/index.js

@@ -0,0 +1,19 @@
+"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("./observability-root-module-options.interface.js"), exports);
+__exportStar(require("./observability-root.module.js"), exports);
+__exportStar(require("./observability-web.module.js"), exports);

package/dist/cjs/nest/observability-root-module-options.interface.d.ts

@@ -0,0 +1,5 @@
+import type { ModuleMetadata } from '@nestjs/common';
+import type { PinoLoggerOptionsInterface } from '../logging/pino-logger-options.interface.js';
+export interface ObservabilityRootModuleOptionsInterface extends PinoLoggerOptionsInterface {
+    readonly imports: NonNullable<ModuleMetadata['imports']>;
+}

package/dist/cjs/nest/observability-root-module-options.interface.js

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

package/dist/cjs/nest/observability-root.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { ObservabilityRootModuleOptionsInterface } from './observability-root-module-options.interface.js';
+export declare class ObservabilityRootModule {
+    static forRoot({ imports, ...loggerOptions }: ObservabilityRootModuleOptionsInterface): DynamicModule;
+}

package/dist/cjs/nest/observability-root.module.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityRootModule = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_pino_1 = require("nestjs-pino");
+const health_module_js_1 = require("../health/health.module.js");
+const constants_js_1 = require("../logging/constants.js");
+const application_logger_js_1 = require("../logging/nest/application-logger.js");
+const pino_logger_config_js_1 = require("../logging/pino-logger.config.js");
+let ObservabilityRootModule = class ObservabilityRootModule {
+    static forRoot({ imports, ...loggerOptions }) {
+        return {
+            exports: [application_logger_js_1.ApplicationLogger, constants_js_1.OBSERVABILITY_LOGGER],
+            global: true,
+            imports: [
+                nestjs_pino_1.LoggerModule.forRootAsync({
+                    imports,
+                    inject: [pino_logger_config_js_1.PinoLoggerConfig],
+                    useFactory: (config) => config.createOptions(loggerOptions),
+                }),
+                health_module_js_1.HealthModule.forRoot({ imports, terminus: { logger: nestjs_pino_1.Logger } }),
+            ],
+            module: this,
+            providers: [application_logger_js_1.ApplicationLogger, { provide: constants_js_1.OBSERVABILITY_LOGGER, useExisting: application_logger_js_1.ApplicationLogger }],
+        };
+    }
+};
+exports.ObservabilityRootModule = ObservabilityRootModule;
+exports.ObservabilityRootModule = ObservabilityRootModule = __decorate([
+    (0, common_1.Module)({})
+], ObservabilityRootModule);

package/dist/cjs/nest/observability-web.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { HealthCarrierOptionsInterface } from '../health/health-module-options.interface.js';
+export declare class ObservabilityWebModule {
+    static forRoot(options?: HealthCarrierOptionsInterface): DynamicModule;
+}

package/dist/cjs/nest/observability-web.module.js

@@ -0,0 +1,24 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservabilityWebModule = void 0;
+const common_1 = require("@nestjs/common");
+const health_http_module_js_1 = require("../health/health-http.module.js");
+const metrics_http_module_js_1 = require("../metrics/metrics-http.module.js");
+let ObservabilityWebModule = class ObservabilityWebModule {
+    static forRoot(options = {}) {
+        return {
+            imports: [health_http_module_js_1.HealthHttpModule.forRoot(options), metrics_http_module_js_1.MetricsHttpModule.forRoot(options)],
+            module: this,
+        };
+    }
+};
+exports.ObservabilityWebModule = ObservabilityWebModule;
+exports.ObservabilityWebModule = ObservabilityWebModule = __decorate([
+    (0, common_1.Module)({})
+], ObservabilityWebModule);

package/dist/esm/http/first-header-value.d.ts

@@ -0,0 +1 @@
+export declare const firstHeaderValue: (value: string | string[] | undefined) => null | string;

package/dist/esm/http/first-header-value.js

@@ -0,0 +1,5 @@
+export const firstHeaderValue = (value) => {
+    const single = Array.isArray(value) ? value[0] : value;
+    const trimmed = (single ?? '').trim();
+    return trimmed === '' ? null : trimmed;
+};

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

@@ -1,2 +1,4 @@
 export * from './client-ip-options.interface.js';
+export * from './first-header-value.js';
 export * from './resolve-client-ip.js';
+export * from './resolve-request-facts.js';

package/dist/esm/http/index.js

@@ -1,2 +1,4 @@
 export * from './client-ip-options.interface.js';
+export * from './first-header-value.js';
 export * from './resolve-client-ip.js';
+export * from './resolve-request-facts.js';

package/dist/esm/http/resolve-client-ip.js

@@ -1,10 +1,7 @@
-const firstHeaderValue = (value) => {
-    const single = Array.isArray(value) ? value[0] : value;
-    return (single ?? '').trim();
-};
+import { firstHeaderValue } from './first-header-value.js';
 const trustedHeaderIp = (request, trustedHeaders) => {
     const values = trustedHeaders?.map((header) => firstHeaderValue(request.headers?.[header]));
-    return values?.find((value) => value !== '') ?? '';
+    return values?.find((value) => value !== null) ?? '';
 };
 const rawSocketIp = (request) => request.raw?.socket?.remoteAddress ?? '';
 const socketIp = (request) => request.socket?.remoteAddress ?? rawSocketIp(request);

package/dist/esm/http/resolve-request-facts.d.ts

@@ -0,0 +1,7 @@
+import type { ClientIpOptionsInterface } from './client-ip-options.interface.js';
+import type { ClientIpSourceInterface } from './resolve-client-ip.js';
+export interface RequestFactsInterface {
+    ip: null | string;
+    userAgent: null | string;
+}
+export declare const resolveRequestFacts: (request: ClientIpSourceInterface, options?: ClientIpOptionsInterface) => RequestFactsInterface;

package/dist/esm/http/resolve-request-facts.js

@@ -0,0 +1,10 @@
+import { firstHeaderValue } from './first-header-value.js';
+import { resolveClientIp } from './resolve-client-ip.js';
+const USER_AGENT_HEADER = 'user-agent';
+export const resolveRequestFacts = (request, options = {}) => {
+    const ip = resolveClientIp(request, options);
+    return {
+        ip: ip === '' ? null : ip,
+        userAgent: firstHeaderValue(request.headers?.[USER_AGENT_HEADER]),
+    };
+};

package/dist/esm/logging/nest/application-logger.d.ts

@@ -0,0 +1,5 @@
+import * as nestjsPino from 'nestjs-pino';
+import type { ObservabilityLoggerInterface } from '../observability-logger.interface.js';
+export declare class ApplicationLogger extends nestjsPino.PinoLogger implements ObservabilityLoggerInterface {
+    constructor(options: nestjsPino.Params);
+}

package/dist/esm/logging/nest/application-logger.js

@@ -0,0 +1,23 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var ApplicationLogger_1;
+import { Injectable } from '@nestjs/common';
+import * as nestjsPino from 'nestjs-pino';
+let ApplicationLogger = ApplicationLogger_1 = class ApplicationLogger extends nestjsPino.PinoLogger {
+    constructor(options) {
+        super(options);
+        this.setContext(ApplicationLogger_1.name);
+    }
+};
+ApplicationLogger = ApplicationLogger_1 = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Object])
+], ApplicationLogger);
+export { ApplicationLogger };

package/dist/esm/logging/nest/index.d.ts

@@ -0,0 +1 @@
+export * from './application-logger.js';

package/dist/esm/logging/nest/index.js

@@ -0,0 +1 @@
+export * from './application-logger.js';

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

@@ -0,0 +1,3 @@
+export * from './observability-root-module-options.interface.js';
+export * from './observability-root.module.js';
+export * from './observability-web.module.js';

package/dist/esm/nest/index.js

@@ -0,0 +1,3 @@
+export * from './observability-root-module-options.interface.js';
+export * from './observability-root.module.js';
+export * from './observability-web.module.js';

package/dist/esm/nest/observability-root-module-options.interface.d.ts

@@ -0,0 +1,5 @@
+import type { ModuleMetadata } from '@nestjs/common';
+import type { PinoLoggerOptionsInterface } from '../logging/pino-logger-options.interface.js';
+export interface ObservabilityRootModuleOptionsInterface extends PinoLoggerOptionsInterface {
+    readonly imports: NonNullable<ModuleMetadata['imports']>;
+}

package/dist/esm/nest/observability-root-module-options.interface.js

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

package/dist/esm/nest/observability-root.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { ObservabilityRootModuleOptionsInterface } from './observability-root-module-options.interface.js';
+export declare class ObservabilityRootModule {
+    static forRoot({ imports, ...loggerOptions }: ObservabilityRootModuleOptionsInterface): DynamicModule;
+}

package/dist/esm/nest/observability-root.module.js

@@ -0,0 +1,34 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from '@nestjs/common';
+import { Logger, LoggerModule } from 'nestjs-pino';
+import { HealthModule } from '../health/health.module.js';
+import { OBSERVABILITY_LOGGER } from '../logging/constants.js';
+import { ApplicationLogger } from '../logging/nest/application-logger.js';
+import { PinoLoggerConfig } from '../logging/pino-logger.config.js';
+let ObservabilityRootModule = class ObservabilityRootModule {
+    static forRoot({ imports, ...loggerOptions }) {
+        return {
+            exports: [ApplicationLogger, OBSERVABILITY_LOGGER],
+            global: true,
+            imports: [
+                LoggerModule.forRootAsync({
+                    imports,
+                    inject: [PinoLoggerConfig],
+                    useFactory: (config) => config.createOptions(loggerOptions),
+                }),
+                HealthModule.forRoot({ imports, terminus: { logger: Logger } }),
+            ],
+            module: this,
+            providers: [ApplicationLogger, { provide: OBSERVABILITY_LOGGER, useExisting: ApplicationLogger }],
+        };
+    }
+};
+ObservabilityRootModule = __decorate([
+    Module({})
+], ObservabilityRootModule);
+export { ObservabilityRootModule };

package/dist/esm/nest/observability-web.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { HealthCarrierOptionsInterface } from '../health/health-module-options.interface.js';
+export declare class ObservabilityWebModule {
+    static forRoot(options?: HealthCarrierOptionsInterface): DynamicModule;
+}

package/dist/esm/nest/observability-web.module.js

@@ -0,0 +1,21 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from '@nestjs/common';
+import { HealthHttpModule } from '../health/health-http.module.js';
+import { MetricsHttpModule } from '../metrics/metrics-http.module.js';
+let ObservabilityWebModule = class ObservabilityWebModule {
+    static forRoot(options = {}) {
+        return {
+            imports: [HealthHttpModule.forRoot(options), MetricsHttpModule.forRoot(options)],
+            module: this,
+        };
+    }
+};
+ObservabilityWebModule = __decorate([
+    Module({})
+], ObservabilityWebModule);
+export { ObservabilityWebModule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/observability",
-  "version": "0.8.3",
+  "version": "0.10.0",
   "description": "Наблюдаемость NestJS-процесса: метрики Prometheus и RED-гистограммы, health-чеки и пробы, опции pino с request-id и trace-контекстом, логирование CQRS-шин, реальный IP клиента за прокси, трейсинг OpenTelemetry",
   "keywords": [
     "cqrs",
@@ -89,6 +89,16 @@
         "default": "./dist/cjs/logging/index.js"
       }
     },
+    "./logging/nest": {
+      "import": {
+        "types": "./dist/esm/logging/nest/index.d.ts",
+        "default": "./dist/esm/logging/nest/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/logging/nest/index.d.ts",
+        "default": "./dist/cjs/logging/nest/index.js"
+      }
+    },
     "./metric-names.json": "./metric-names.json",
     "./metrics": {
       "import": {
@@ -100,6 +110,16 @@
         "default": "./dist/cjs/metrics/index.js"
       }
     },
+    "./nest": {
+      "import": {
+        "types": "./dist/esm/nest/index.d.ts",
+        "default": "./dist/esm/nest/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/nest/index.d.ts",
+        "default": "./dist/cjs/nest/index.js"
+      }
+    },
     "./package.json": "./package.json",
     "./tracing": {
       "import": {
@@ -116,7 +136,7 @@
     "metric-names.json"
   ],
   "scripts": {
-    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/cqrs && node ../../scripts/barrels.mjs create ./src/health --entry-only=cli,graphql && node ../../scripts/barrels.mjs create ./src/http && node ../../scripts/barrels.mjs create ./src/logging && node ../../scripts/barrels.mjs create ./src/metrics && node ../../scripts/barrels.mjs create ./src/tracing && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/cqrs && node ../../scripts/barrels.mjs create ./src/health --entry-only=cli,graphql && node ../../scripts/barrels.mjs create ./src/http && node ../../scripts/barrels.mjs create ./src/logging --entry-only=nest && node ../../scripts/barrels.mjs create ./src/metrics && node ../../scripts/barrels.mjs create ./src/nest && node ../../scripts/barrels.mjs create ./src/tracing && 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"