@application-kit/observability 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @application-kit/observability
+
+## 0.1.0
+
+### Minor Changes
+
+- 2f8c709: Первый выпуск: вход `/metrics` — `MetricsRegistry` (реестр Prometheus с метриками процесса Node), RED-гистограммы
+  `HttpMetrics` (ярлык маршрута — шаблон пути, `resolveRouteLabel`) и `GraphqlMetrics` (ярлык operation — корневые поля
+  документа, адаптер хуков `asMercuriusHook`), `startMetricsServer` — HTTP-сервер `/metrics` для процессов без веб-слоя.
+  Peer `graphql` — optional: из него берутся только типы, нужен лишь GraphQL-гистограмме.

package/LICENSE

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

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# @application-kit/observability
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Наблюдаемость NestJS-процесса. Первый вход — `/metrics`: реестр Prometheus с метриками процесса Node, RED-гистограммы
+HTTP и GraphQL и HTTP-сервер экспозиции для процессов без своего веб-слоя. Пакет не знает ни маршрутов, ни схемы,
+ни портов приложения: ярлыки и порт приходят параметрами, а хуки веб-сервера и контроллер скрейпа остаются у потребителя.
+
+## Установка
+
+```sh
+yarn add @application-kit/observability
+```
+
+Peer-зависимости: `@nestjs/common`, `@prometheus-io/client`; `graphql` — optional, нужен только GraphQL-гистограмме
+(из него берутся типы документа, сам вход грузится и без него).
+
+## Входы
+
+| Вход | Для чего | Тянет |
+|------|----------|-------|
+| `@application-kit/observability/metrics` | реестр, гистограммы HTTP и GraphQL, сервер `/metrics` | `@nestjs/common`, `@prometheus-io/client` |
+
+Корневого входа нет: каждый вход несёт свои peer-зависимости, и лишнего потребитель не ставит.
+
+## Метрики
+
+- `MetricsRegistry` — провайдер с собственным `Registry` (не глобальным: экземпляры независимы) и метриками процесса
+  из коробки клиента; `render()` отдаёт экспозицию, `contentType` — её заголовок.
+- `HttpMetrics` — гистограмма `http_request_duration_seconds{method,route,status}`. Ярлык `route` — ШАБЛОН маршрута
+  (`/users/:id`), не URL: `resolveRouteLabel(routeUrl)` подставляет `UNMATCHED_ROUTE` для запросов мимо маршрутов.
+- `GraphqlMetrics` — гистограмма `graphql_operation_duration_seconds{operation,outcome,type}`. Ярлык `operation` —
+  отсортированные корневые поля документа (`describeOperation`), не `operationName` клиента. Жизненный цикл —
+  `start(key)` → `describe(key, document)` → `finish(key, hasErrors)`, где `key` — объект контекста запроса;
+  `asMercuriusHook` оборачивает синхронный обработчик в async-хук Mercurius.
+- `DURATION_BUCKETS_SECONDS` — общие границы гистограмм, от 5 мс до 10 с.
+
+```ts
+app.register(async (instance) => {
+  instance.addHook('onResponse', (request, reply, done) => {
+    httpMetrics.observe({
+      durationSeconds: reply.elapsedTime / 1000,
+      method: request.method,
+      route: resolveRouteLabel(request.routeOptions.url),
+      status: reply.statusCode,
+    })
+    done()
+  })
+})
+```
+
+## Сервер `/metrics` без веб-слоя
+
+Процессу без HTTP (консьюмер очереди как Nest-микросервис) негде отдать экспозицию — `startMetricsServer` поднимает
+минимальный `node:http`-сервер на отдельном порту: `/metrics` отдаёт реестр, остальное — 404, ошибка рендера — 500
+и вызов `onError` вместо падения процесса.
+
+```ts
+const server = startMetricsServer({ onError: (error) => logger.error(error), port: 9464, registry })
+```

package/dist/cjs/metrics/graphql-metrics.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentNode } from 'graphql';
+import { MetricsRegistry } from './metrics.registry.js';
+declare const UNKNOWN_OPERATION = "unknown";
+interface OperationDescriptionInterface {
+    operation: string;
+    type: string;
+}
+declare const describeOperation: (document: DocumentNode) => OperationDescriptionInterface;
+type MercuriusHook<TArguments extends unknown[]> = (...arguments_: TArguments) => Promise<void>;
+declare class GraphqlMetrics {
+    private readonly metricsRegistry;
+    private readonly operationDuration;
+    private readonly pending;
+    constructor(metricsRegistry: MetricsRegistry);
+    describe(key: object, document: DocumentNode): void;
+    finish(key: object, hasErrors: boolean): void;
+    start(key: object): void;
+}
+declare const asMercuriusHook: <TArguments extends unknown[]>(handler: (...arguments_: TArguments) => void) => MercuriusHook<TArguments>;
+export { asMercuriusHook, describeOperation, GraphqlMetrics, UNKNOWN_OPERATION };

package/dist/cjs/metrics/graphql-metrics.js

@@ -0,0 +1,89 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_OPERATION = exports.GraphqlMetrics = exports.describeOperation = exports.asMercuriusHook = void 0;
+const common_1 = require("@nestjs/common");
+const client_1 = require("@prometheus-io/client");
+const node_perf_hooks_1 = require("node:perf_hooks");
+const http_metrics_js_1 = require("./http-metrics.js");
+const metrics_registry_js_1 = require("./metrics.registry.js");
+const UNKNOWN_OPERATION = 'unknown';
+exports.UNKNOWN_OPERATION = UNKNOWN_OPERATION;
+const OPERATION_LABEL_MAX_LENGTH = 60;
+const OPERATION_DEFINITION_KIND = 'OperationDefinition';
+const FIELD_KIND = 'Field';
+const kindOf = (node) => node.kind;
+const isOperationDefinition = (node) => kindOf(node) === OPERATION_DEFINITION_KIND;
+const isField = (selection) => kindOf(selection) === FIELD_KIND;
+const describeOperation = (document) => {
+    const definition = document.definitions.find(isOperationDefinition);
+    if (definition === undefined) {
+        return { operation: UNKNOWN_OPERATION, type: UNKNOWN_OPERATION };
+    }
+    const fields = definition.selectionSet.selections
+        .filter(isField)
+        .map((selection) => selection.name.value)
+        .toSorted((first, second) => first.localeCompare(second));
+    const operation = fields.length === 0
+        ? UNKNOWN_OPERATION
+        : fields.join('+').slice(0, OPERATION_LABEL_MAX_LENGTH);
+    return { operation, type: definition.operation };
+};
+exports.describeOperation = describeOperation;
+let GraphqlMetrics = class GraphqlMetrics {
+    metricsRegistry;
+    operationDuration;
+    pending = new WeakMap();
+    constructor(metricsRegistry) {
+        this.metricsRegistry = metricsRegistry;
+        this.operationDuration = new client_1.Histogram({
+            buckets: http_metrics_js_1.DURATION_BUCKETS_SECONDS,
+            help: 'Длительность GraphQL-операции, секунды',
+            labelNames: ['operation', 'outcome', 'type'],
+            name: 'graphql_operation_duration_seconds',
+            registers: [this.metricsRegistry.registry],
+        });
+    }
+    describe(key, document) {
+        const started = this.pending.get(key);
+        this.pending.set(key, {
+            ...describeOperation(document),
+            startedAt: started?.startedAt ?? node_perf_hooks_1.performance.now(),
+        });
+    }
+    finish(key, hasErrors) {
+        const started = this.pending.get(key);
+        if (started === undefined) {
+            return;
+        }
+        this.pending.delete(key);
+        this.operationDuration.observe({
+            operation: started.operation,
+            outcome: hasErrors ? 'error' : 'ok',
+            type: started.type,
+        }, (node_perf_hooks_1.performance.now() - started.startedAt) / 1000);
+    }
+    start(key) {
+        this.pending.set(key, { operation: UNKNOWN_OPERATION, startedAt: node_perf_hooks_1.performance.now(), type: UNKNOWN_OPERATION });
+    }
+};
+exports.GraphqlMetrics = GraphqlMetrics;
+exports.GraphqlMetrics = GraphqlMetrics = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [metrics_registry_js_1.MetricsRegistry])
+], GraphqlMetrics);
+const asMercuriusHook = (handler) => {
+    const hook = async (...arguments_) => {
+        handler(...arguments_);
+    };
+    return hook;
+};
+exports.asMercuriusHook = asMercuriusHook;

package/dist/cjs/metrics/http-metrics.d.ts

@@ -0,0 +1,17 @@
+import { MetricsRegistry } from './metrics.registry.js';
+declare const UNMATCHED_ROUTE = "unmatched";
+declare const DURATION_BUCKETS_SECONDS: number[];
+interface HttpSampleInterface {
+    durationSeconds: number;
+    method: string;
+    route: string;
+    status: number;
+}
+declare const resolveRouteLabel: (routeUrl?: string) => string;
+declare class HttpMetrics {
+    private readonly metricsRegistry;
+    private readonly requestDuration;
+    constructor(metricsRegistry: MetricsRegistry);
+    observe({ durationSeconds, method, route, status }: HttpSampleInterface): void;
+}
+export { DURATION_BUCKETS_SECONDS, HttpMetrics, resolveRouteLabel, UNMATCHED_ROUTE };

package/dist/cjs/metrics/http-metrics.js

@@ -0,0 +1,43 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNMATCHED_ROUTE = exports.resolveRouteLabel = exports.HttpMetrics = exports.DURATION_BUCKETS_SECONDS = void 0;
+const common_1 = require("@nestjs/common");
+const client_1 = require("@prometheus-io/client");
+const metrics_registry_js_1 = require("./metrics.registry.js");
+const UNMATCHED_ROUTE = 'unmatched';
+exports.UNMATCHED_ROUTE = UNMATCHED_ROUTE;
+const DURATION_BUCKETS_SECONDS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+exports.DURATION_BUCKETS_SECONDS = DURATION_BUCKETS_SECONDS;
+const resolveRouteLabel = (routeUrl) => (routeUrl === undefined || routeUrl === '' ? UNMATCHED_ROUTE : routeUrl);
+exports.resolveRouteLabel = resolveRouteLabel;
+let HttpMetrics = class HttpMetrics {
+    metricsRegistry;
+    requestDuration;
+    constructor(metricsRegistry) {
+        this.metricsRegistry = metricsRegistry;
+        this.requestDuration = new client_1.Histogram({
+            buckets: DURATION_BUCKETS_SECONDS,
+            help: 'Длительность обработки HTTP-запроса, секунды',
+            labelNames: ['method', 'route', 'status'],
+            name: 'http_request_duration_seconds',
+            registers: [this.metricsRegistry.registry],
+        });
+    }
+    observe({ durationSeconds, method, route, status }) {
+        this.requestDuration.observe({ method, route, status }, durationSeconds);
+    }
+};
+exports.HttpMetrics = HttpMetrics;
+exports.HttpMetrics = HttpMetrics = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [metrics_registry_js_1.MetricsRegistry])
+], HttpMetrics);

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

@@ -0,0 +1,4 @@
+export * from './graphql-metrics.js';
+export * from './http-metrics.js';
+export * from './metrics-http-server.js';
+export * from './metrics.registry.js';

package/dist/cjs/metrics/index.js

@@ -0,0 +1,20 @@
+"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("./graphql-metrics.js"), exports);
+__exportStar(require("./http-metrics.js"), exports);
+__exportStar(require("./metrics-http-server.js"), exports);
+__exportStar(require("./metrics.registry.js"), exports);

package/dist/cjs/metrics/metrics-http-server.d.ts

@@ -0,0 +1,10 @@
+import type { Server } from 'node:http';
+import type { MetricsRegistry } from './metrics.registry.js';
+type MetricsServerErrorHandler = (error: unknown) => void;
+interface MetricsServerOptionsInterface {
+    onError?: MetricsServerErrorHandler | undefined;
+    port: number;
+    registry: MetricsRegistry;
+}
+declare const startMetricsServer: ({ onError, port, registry }: MetricsServerOptionsInterface) => Server;
+export { startMetricsServer };

package/dist/cjs/metrics/metrics-http-server.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMetricsServer = void 0;
+const node_http_1 = require("node:http");
+const METRICS_PATH = '/metrics';
+const NOT_FOUND = 404;
+const OK = 200;
+const SERVER_ERROR = 500;
+const renderMetrics = async (registry, response, onError) => {
+    try {
+        const exposition = await registry.render();
+        response.writeHead(OK, { 'Content-Type': registry.contentType });
+        response.end(exposition);
+    }
+    catch (error) {
+        response.writeHead(SERVER_ERROR);
+        response.end();
+        onError?.(error);
+    }
+};
+const respond = async (registry, request, response, onError) => {
+    if (request.url !== METRICS_PATH) {
+        response.writeHead(NOT_FOUND);
+        response.end();
+        return;
+    }
+    await renderMetrics(registry, response, onError);
+};
+const startMetricsServer = ({ onError, port, registry }) => {
+    const server = (0, node_http_1.createServer)((request, response) => {
+        void respond(registry, request, response, onError);
+    });
+    server.listen(port, '0.0.0.0');
+    return server;
+};
+exports.startMetricsServer = startMetricsServer;

package/dist/cjs/metrics/metrics.registry.d.ts

@@ -0,0 +1,8 @@
+import { Registry } from '@prometheus-io/client';
+declare class MetricsRegistry {
+    readonly registry: Registry<import("@prometheus-io/client").RegistryContentType>;
+    get contentType(): string;
+    constructor();
+    render(): Promise<string>;
+}
+export { MetricsRegistry };

package/dist/cjs/metrics/metrics.registry.js

@@ -0,0 +1,31 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const client_1 = require("@prometheus-io/client");
+let MetricsRegistry = class MetricsRegistry {
+    registry = new client_1.Registry();
+    get contentType() {
+        return this.registry.contentType;
+    }
+    constructor() {
+        (0, client_1.collectDefaultMetrics)({ register: this.registry });
+    }
+    async render() {
+        return this.registry.metrics();
+    }
+};
+exports.MetricsRegistry = MetricsRegistry;
+exports.MetricsRegistry = MetricsRegistry = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], MetricsRegistry);

package/dist/cjs/package.json

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

package/dist/esm/metrics/graphql-metrics.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentNode } from 'graphql';
+import { MetricsRegistry } from './metrics.registry.js';
+declare const UNKNOWN_OPERATION = "unknown";
+interface OperationDescriptionInterface {
+    operation: string;
+    type: string;
+}
+declare const describeOperation: (document: DocumentNode) => OperationDescriptionInterface;
+type MercuriusHook<TArguments extends unknown[]> = (...arguments_: TArguments) => Promise<void>;
+declare class GraphqlMetrics {
+    private readonly metricsRegistry;
+    private readonly operationDuration;
+    private readonly pending;
+    constructor(metricsRegistry: MetricsRegistry);
+    describe(key: object, document: DocumentNode): void;
+    finish(key: object, hasErrors: boolean): void;
+    start(key: object): void;
+}
+declare const asMercuriusHook: <TArguments extends unknown[]>(handler: (...arguments_: TArguments) => void) => MercuriusHook<TArguments>;
+export { asMercuriusHook, describeOperation, GraphqlMetrics, UNKNOWN_OPERATION };

package/dist/esm/metrics/graphql-metrics.js

@@ -0,0 +1,83 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { Histogram } from '@prometheus-io/client';
+import { performance } from 'node:perf_hooks';
+import { DURATION_BUCKETS_SECONDS } from './http-metrics.js';
+import { MetricsRegistry } from './metrics.registry.js';
+const UNKNOWN_OPERATION = 'unknown';
+const OPERATION_LABEL_MAX_LENGTH = 60;
+const OPERATION_DEFINITION_KIND = 'OperationDefinition';
+const FIELD_KIND = 'Field';
+const kindOf = (node) => node.kind;
+const isOperationDefinition = (node) => kindOf(node) === OPERATION_DEFINITION_KIND;
+const isField = (selection) => kindOf(selection) === FIELD_KIND;
+const describeOperation = (document) => {
+    const definition = document.definitions.find(isOperationDefinition);
+    if (definition === undefined) {
+        return { operation: UNKNOWN_OPERATION, type: UNKNOWN_OPERATION };
+    }
+    const fields = definition.selectionSet.selections
+        .filter(isField)
+        .map((selection) => selection.name.value)
+        .toSorted((first, second) => first.localeCompare(second));
+    const operation = fields.length === 0
+        ? UNKNOWN_OPERATION
+        : fields.join('+').slice(0, OPERATION_LABEL_MAX_LENGTH);
+    return { operation, type: definition.operation };
+};
+let GraphqlMetrics = class GraphqlMetrics {
+    metricsRegistry;
+    operationDuration;
+    pending = new WeakMap();
+    constructor(metricsRegistry) {
+        this.metricsRegistry = metricsRegistry;
+        this.operationDuration = new Histogram({
+            buckets: DURATION_BUCKETS_SECONDS,
+            help: 'Длительность GraphQL-операции, секунды',
+            labelNames: ['operation', 'outcome', 'type'],
+            name: 'graphql_operation_duration_seconds',
+            registers: [this.metricsRegistry.registry],
+        });
+    }
+    describe(key, document) {
+        const started = this.pending.get(key);
+        this.pending.set(key, {
+            ...describeOperation(document),
+            startedAt: started?.startedAt ?? performance.now(),
+        });
+    }
+    finish(key, hasErrors) {
+        const started = this.pending.get(key);
+        if (started === undefined) {
+            return;
+        }
+        this.pending.delete(key);
+        this.operationDuration.observe({
+            operation: started.operation,
+            outcome: hasErrors ? 'error' : 'ok',
+            type: started.type,
+        }, (performance.now() - started.startedAt) / 1000);
+    }
+    start(key) {
+        this.pending.set(key, { operation: UNKNOWN_OPERATION, startedAt: performance.now(), type: UNKNOWN_OPERATION });
+    }
+};
+GraphqlMetrics = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [MetricsRegistry])
+], GraphqlMetrics);
+const asMercuriusHook = (handler) => {
+    const hook = async (...arguments_) => {
+        handler(...arguments_);
+    };
+    return hook;
+};
+export { asMercuriusHook, describeOperation, GraphqlMetrics, UNKNOWN_OPERATION };

package/dist/esm/metrics/http-metrics.d.ts

@@ -0,0 +1,17 @@
+import { MetricsRegistry } from './metrics.registry.js';
+declare const UNMATCHED_ROUTE = "unmatched";
+declare const DURATION_BUCKETS_SECONDS: number[];
+interface HttpSampleInterface {
+    durationSeconds: number;
+    method: string;
+    route: string;
+    status: number;
+}
+declare const resolveRouteLabel: (routeUrl?: string) => string;
+declare class HttpMetrics {
+    private readonly metricsRegistry;
+    private readonly requestDuration;
+    constructor(metricsRegistry: MetricsRegistry);
+    observe({ durationSeconds, method, route, status }: HttpSampleInterface): void;
+}
+export { DURATION_BUCKETS_SECONDS, HttpMetrics, resolveRouteLabel, UNMATCHED_ROUTE };

package/dist/esm/metrics/http-metrics.js

@@ -0,0 +1,37 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { Histogram } from '@prometheus-io/client';
+import { MetricsRegistry } from './metrics.registry.js';
+const UNMATCHED_ROUTE = 'unmatched';
+const DURATION_BUCKETS_SECONDS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+const resolveRouteLabel = (routeUrl) => (routeUrl === undefined || routeUrl === '' ? UNMATCHED_ROUTE : routeUrl);
+let HttpMetrics = class HttpMetrics {
+    metricsRegistry;
+    requestDuration;
+    constructor(metricsRegistry) {
+        this.metricsRegistry = metricsRegistry;
+        this.requestDuration = new Histogram({
+            buckets: DURATION_BUCKETS_SECONDS,
+            help: 'Длительность обработки HTTP-запроса, секунды',
+            labelNames: ['method', 'route', 'status'],
+            name: 'http_request_duration_seconds',
+            registers: [this.metricsRegistry.registry],
+        });
+    }
+    observe({ durationSeconds, method, route, status }) {
+        this.requestDuration.observe({ method, route, status }, durationSeconds);
+    }
+};
+HttpMetrics = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [MetricsRegistry])
+], HttpMetrics);
+export { DURATION_BUCKETS_SECONDS, HttpMetrics, resolveRouteLabel, UNMATCHED_ROUTE };

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

@@ -0,0 +1,4 @@
+export * from './graphql-metrics.js';
+export * from './http-metrics.js';
+export * from './metrics-http-server.js';
+export * from './metrics.registry.js';

package/dist/esm/metrics/index.js

@@ -0,0 +1,4 @@
+export * from './graphql-metrics.js';
+export * from './http-metrics.js';
+export * from './metrics-http-server.js';
+export * from './metrics.registry.js';

package/dist/esm/metrics/metrics-http-server.d.ts

@@ -0,0 +1,10 @@
+import type { Server } from 'node:http';
+import type { MetricsRegistry } from './metrics.registry.js';
+type MetricsServerErrorHandler = (error: unknown) => void;
+interface MetricsServerOptionsInterface {
+    onError?: MetricsServerErrorHandler | undefined;
+    port: number;
+    registry: MetricsRegistry;
+}
+declare const startMetricsServer: ({ onError, port, registry }: MetricsServerOptionsInterface) => Server;
+export { startMetricsServer };

package/dist/esm/metrics/metrics-http-server.js

@@ -0,0 +1,33 @@
+import { createServer } from 'node:http';
+const METRICS_PATH = '/metrics';
+const NOT_FOUND = 404;
+const OK = 200;
+const SERVER_ERROR = 500;
+const renderMetrics = async (registry, response, onError) => {
+    try {
+        const exposition = await registry.render();
+        response.writeHead(OK, { 'Content-Type': registry.contentType });
+        response.end(exposition);
+    }
+    catch (error) {
+        response.writeHead(SERVER_ERROR);
+        response.end();
+        onError?.(error);
+    }
+};
+const respond = async (registry, request, response, onError) => {
+    if (request.url !== METRICS_PATH) {
+        response.writeHead(NOT_FOUND);
+        response.end();
+        return;
+    }
+    await renderMetrics(registry, response, onError);
+};
+const startMetricsServer = ({ onError, port, registry }) => {
+    const server = createServer((request, response) => {
+        void respond(registry, request, response, onError);
+    });
+    server.listen(port, '0.0.0.0');
+    return server;
+};
+export { startMetricsServer };

package/dist/esm/metrics/metrics.registry.d.ts

@@ -0,0 +1,8 @@
+import { Registry } from '@prometheus-io/client';
+declare class MetricsRegistry {
+    readonly registry: Registry<import("@prometheus-io/client").RegistryContentType>;
+    get contentType(): string;
+    constructor();
+    render(): Promise<string>;
+}
+export { MetricsRegistry };

package/dist/esm/metrics/metrics.registry.js

@@ -0,0 +1,28 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { collectDefaultMetrics, Registry } from '@prometheus-io/client';
+let MetricsRegistry = class MetricsRegistry {
+    registry = new Registry();
+    get contentType() {
+        return this.registry.contentType;
+    }
+    constructor() {
+        collectDefaultMetrics({ register: this.registry });
+    }
+    async render() {
+        return this.registry.metrics();
+    }
+};
+MetricsRegistry = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [])
+], MetricsRegistry);
+export { MetricsRegistry };

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@application-kit/observability",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Наблюдаемость NestJS-процесса: реестр метрик Prometheus, RED-гистограммы HTTP и GraphQL, HTTP-сервер /metrics для процессов без веб-слоя",
+  "keywords": [
+    "metrics",
+    "nestjs",
+    "observability",
+    "prometheus"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/observability",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/observability"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "./metrics": {
+      "import": {
+        "types": "./dist/esm/metrics/index.d.ts",
+        "default": "./dist/esm/metrics/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/metrics/index.d.ts",
+        "default": "./dist/cjs/metrics/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/cjs/metrics/index.js",
+  "module": "./dist/esm/metrics/index.js",
+  "types": "./dist/cjs/metrics/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/metrics && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "lint:tsc": "tsc --noEmit --pretty --project .",
+    "test:mutation": "stryker run",
+    "test:unit": "vitest run"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.2.7",
+    "@prometheus-io/client": "^0.16.0",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^26.2.0",
+    "graphql": "^16.14.2",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@prometheus-io/client": "^0.16.0",
+    "graphql": "^16.0.0"
+  },
+  "peerDependenciesMeta": {
+    "graphql": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }