@seta-labs/nestjs-health 0.1.0

package/README.md

@@ -0,0 +1,90 @@
+# @seta-labs/nestjs-health
+
+Health endpoints for NestJS APIs, as `BLUEPRINT.md` → Health requires: a liveness probe that checks nothing, a readiness probe on memory pressure and the app's critical dependencies, a diagnostic status report, and readiness failing as soon as shutdown starts.
+
+## Install
+
+```bash
+pnpm add @seta-labs/nestjs-health
+```
+
+Peer dependencies: `@nestjs/common`, `@nestjs/core`, `@nestjs/swagger` (the DTOs are part of the app's OpenAPI contract).
+
+## Wire it
+
+```ts
+// src/prisma/database.indicator.ts: the probe lives with the dependency
+import { Injectable } from '@nestjs/common';
+import type { HealthIndicator } from '@seta-labs/nestjs-health';
+
+import { PrismaService } from './prisma.service';
+
+@Injectable()
+export class DatabaseHealthIndicator implements HealthIndicator {
+    readonly name = 'database';
+
+    constructor(private readonly prisma: PrismaService) {}
+
+    async check(): Promise<void> {
+        await this.prisma.$queryRaw`SELECT 1`;
+    }
+}
+```
+
+```ts
+// app.module.ts
+import { HealthModule } from '@seta-labs/nestjs-health';
+
+@Module({
+    imports: [
+        HealthModule.forRoot({
+            service: 'my-api',
+            version: process.env.APP_VERSION,
+            imports: [PrismaModule], // exports DatabaseHealthIndicator
+            indicators: [DatabaseHealthIndicator],
+            probeDecorators: [Public()], // only with a global guard
+        }),
+    ],
+})
+export class AppModule {}
+```
+
+```ts
+// main.ts
+app.enableShutdownHooks();
+```
+
+```yaml
+# k8s: probes
+startupProbe:
+    httpGet: { path: /api/health/ready, port: http }
+    periodSeconds: 5
+    failureThreshold: 24
+readinessProbe:
+    httpGet: { path: /api/health/ready, port: http }
+    periodSeconds: 5
+    timeoutSeconds: 2
+livenessProbe:
+    httpGet: { path: /api/health, port: http }
+    periodSeconds: 10
+```
+
+## Endpoints
+
+| Route                | For       | Behaviour                                                                                                                                                                                                         |
+| -------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET /health`        | liveness  | `{ status: 'ok', service, timestamp }`, no check: a failing dependency must not make the kubelet restart every pod.                                                                                               |
+| `GET /health/ready`  | readiness | Runs the memory check and every indicator in parallel. `down` (503) when a critical check fails or shutdown started; `degraded` (200) when only a non-critical one fails. No error messages: the probe is public. |
+| `GET /health/status` | people    | Always 200: status, version, Node version, uptime, memory in MiB with both limits and ratios, event loop delay p50/p99/max since the previous report, every check with its error.                                 |
+
+All three answer `Cache-Control: no-store`. `@seta-labs/nestjs-logging` keeps the two probes out of the request log; `/health/status` stays logged.
+
+## Options
+
+- `service` (required), `version`: echoed in the responses.
+- `imports`, `indicators`: modules exporting the indicators, and the indicator classes. An indicator is `{ name, critical?, check(): Promise<void> }`; `critical` defaults to `true`.
+- `memory`: `{ heapRatio, rssRatio }`, both `0.9` by default; `false` drops the check. The heap is measured against V8's `heap_size_limit`, which Node sizes from the container limit (about half of it on small pods); the RSS against the cgroup limit (`process.constrainedMemory()`), skipped when the process is not constrained. The two are distinct ways to die: "heap out of memory" versus OOMKill, the latter driven by buffers and native memory outside the heap.
+- `checkTimeoutMs`: per check, `750` by default; keep the probe `timeoutSeconds` above it.
+- `probeDecorators`: decorators applied to `/health` and `/health/ready` only, typically the app's `Public()`.
+
+Readiness logs one line per change, not per probe: a `warn` for each failing check (with `err`) when it leaves `ok`, an `info` when it recovers. `HealthService` is exported for apps that need the report elsewhere.

package/dist/check.util.d.ts

@@ -0,0 +1,6 @@
+import { HealthStatus } from './enums/health-status.enum';
+import type { CheckResult, HealthIndicator } from './types/health-indicator.type';
+/** Runs one indicator under a timeout; never throws. */
+export declare function runCheck(indicator: HealthIndicator, timeoutMs: number): Promise<CheckResult>;
+/** `down` when a critical check fails, `degraded` when only non-critical ones do. */
+export declare function overallStatus(results: CheckResult[]): HealthStatus;

package/dist/check.util.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCheck = runCheck;
+exports.overallStatus = overallStatus;
+const node_perf_hooks_1 = require("node:perf_hooks");
+const health_status_enum_1 = require("./enums/health-status.enum");
+/** Runs one indicator under a timeout; never throws. */
+async function runCheck(indicator, timeoutMs) {
+    const started = node_perf_hooks_1.performance.now();
+    const base = { name: indicator.name, critical: indicator.critical ?? true };
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`timed out after ${timeoutMs} ms`)), timeoutMs);
+    });
+    try {
+        await Promise.race([indicator.check(), timeout]);
+        return { ...base, ok: true, durationMs: elapsed(started) };
+    }
+    catch (err) {
+        return { ...base, ok: false, durationMs: elapsed(started), err };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** `down` when a critical check fails, `degraded` when only non-critical ones do. */
+function overallStatus(results) {
+    const failed = results.filter((result) => !result.ok);
+    if (failed.some((result) => result.critical))
+        return health_status_enum_1.HealthStatus.Down;
+    return failed.length > 0 ? health_status_enum_1.HealthStatus.Degraded : health_status_enum_1.HealthStatus.Ok;
+}
+function elapsed(started) {
+    return Math.round((node_perf_hooks_1.performance.now() - started) * 10) / 10;
+}
+//# sourceMappingURL=check.util.js.map

package/dist/check.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.util.js","sourceRoot":"","sources":["../src/check.util.ts"],"names":[],"mappings":";;AAMA,4BAkBC;AAGD,sCAIC;AA/BD,qDAA8C;AAE9C,mEAA0D;AAG1D,wDAAwD;AACjD,KAAK,UAAU,QAAQ,CAC1B,SAA0B,EAC1B,SAAiB;IAEjB,MAAM,OAAO,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC5E,IAAI,KAAiC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC7C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,SAAS,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IACrE,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACL,CAAC;AAED,qFAAqF;AACrF,SAAgB,aAAa,CAAC,OAAsB;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,iCAAY,CAAC,IAAI,CAAC;IACvE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iCAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,iCAAY,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,6BAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC/D,CAAC"}

package/dist/dto/event-loop-delay.dto.d.ts

@@ -0,0 +1,6 @@
+export declare class EventLoopDelayDto {
+    p50Ms: number;
+    p99Ms: number;
+    maxMs: number;
+    windowSec: number;
+}

package/dist/dto/event-loop-delay.dto.js

@@ -0,0 +1,41 @@
+"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.EventLoopDelayDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class EventLoopDelayDto {
+    p50Ms;
+    p99Ms;
+    maxMs;
+    windowSec;
+}
+exports.EventLoopDelayDto = EventLoopDelayDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 10.1, type: Number }),
+    __metadata("design:type", Number)
+], EventLoopDelayDto.prototype, "p50Ms", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 21.4, type: Number }),
+    __metadata("design:type", Number)
+], EventLoopDelayDto.prototype, "p99Ms", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 48.7, type: Number }),
+    __metadata("design:type", Number)
+], EventLoopDelayDto.prototype, "maxMs", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Seconds covered: since the previous status report, or since startup.',
+        example: 60,
+        type: Number,
+    }),
+    __metadata("design:type", Number)
+], EventLoopDelayDto.prototype, "windowSec", void 0);
+//# sourceMappingURL=event-loop-delay.dto.js.map

package/dist/dto/event-loop-delay.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-loop-delay.dto.js","sourceRoot":"","sources":["../../src/dto/event-loop-delay.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAE9C,MAAa,iBAAiB;IAE1B,KAAK,CAAU;IAGf,KAAK,CAAU;IAGf,KAAK,CAAU;IAOf,SAAS,CAAU;CACtB;AAhBD,8CAgBC;AAdG;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDAC9B;AAGf;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDAC9B;AAGf;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDAC9B;AAOf;IALC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,sEAAsE;QACnF,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,MAAM;KACf,CAAC;;oDACiB"}

package/dist/dto/health-check-response.dto.d.ts

@@ -0,0 +1,8 @@
+import { HealthStatus } from '../enums/health-status.enum';
+import { HealthCheckResultDto } from './health-check-result.dto';
+export declare class HealthCheckResponseDto {
+    status: HealthStatus;
+    service: string;
+    timestamp: string;
+    checks?: HealthCheckResultDto[];
+}

package/dist/dto/health-check-response.dto.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.HealthCheckResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const health_status_enum_1 = require("../enums/health-status.enum");
+const health_check_result_dto_1 = require("./health-check-result.dto");
+class HealthCheckResponseDto {
+    status;
+    service;
+    timestamp;
+    checks;
+}
+exports.HealthCheckResponseDto = HealthCheckResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: health_status_enum_1.HealthStatus, enumName: 'HealthStatus', example: health_status_enum_1.HealthStatus.Ok }),
+    __metadata("design:type", String)
+], HealthCheckResponseDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'api', type: String }),
+    __metadata("design:type", String)
+], HealthCheckResponseDto.prototype, "service", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-07-03T10:00:00.000Z', format: 'date-time', type: String }),
+    __metadata("design:type", String)
+], HealthCheckResponseDto.prototype, "timestamp", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Readiness checks; absent on liveness.',
+        isArray: true,
+        type: health_check_result_dto_1.HealthCheckResultDto,
+    }),
+    __metadata("design:type", Array)
+], HealthCheckResponseDto.prototype, "checks", void 0);
+//# sourceMappingURL=health-check-response.dto.js.map

package/dist/dto/health-check-response.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-response.dto.js","sourceRoot":"","sources":["../../src/dto/health-check-response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAEnE,oEAA2D;AAC3D,uEAAiE;AAEjE,MAAa,sBAAsB;IAE/B,MAAM,CAAgB;IAGtB,OAAO,CAAU;IAGjB,SAAS,CAAU;IAOnB,MAAM,CAA0B;CACnC;AAhBD,wDAgBC;AAdG;IADC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,iCAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,iCAAY,CAAC,EAAE,EAAE,CAAC;;sDAClE;AAGtB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDAC7B;AAGjB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;yDACrE;AAOnB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,uCAAuC;QACpD,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,8CAAoB;KAC7B,CAAC;;sDAC8B"}

package/dist/dto/health-check-result.dto.d.ts

@@ -0,0 +1,8 @@
+import { HealthStatus } from '../enums/health-status.enum';
+export declare class HealthCheckResultDto {
+    name: string;
+    status: HealthStatus;
+    critical: boolean;
+    durationMs: number;
+    error?: string;
+}

package/dist/dto/health-check-result.dto.js

@@ -0,0 +1,52 @@
+"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.HealthCheckResultDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const health_status_enum_1 = require("../enums/health-status.enum");
+class HealthCheckResultDto {
+    name;
+    status;
+    critical;
+    durationMs;
+    error;
+}
+exports.HealthCheckResultDto = HealthCheckResultDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'database', type: String }),
+    __metadata("design:type", String)
+], HealthCheckResultDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'A check is `ok` or `down`.',
+        enum: health_status_enum_1.HealthStatus,
+        enumName: 'HealthStatus',
+        example: health_status_enum_1.HealthStatus.Ok,
+    }),
+    __metadata("design:type", String)
+], HealthCheckResultDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'A failing critical check fails readiness.', type: Boolean }),
+    __metadata("design:type", Boolean)
+], HealthCheckResultDto.prototype, "critical", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 3.2, type: Number }),
+    __metadata("design:type", Number)
+], HealthCheckResultDto.prototype, "durationMs", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Failure reason, only in `/health/status`: probes are public.',
+        example: 'timed out after 750 ms',
+        type: String,
+    }),
+    __metadata("design:type", String)
+], HealthCheckResultDto.prototype, "error", void 0);
+//# sourceMappingURL=health-check-result.dto.js.map

package/dist/dto/health-check-result.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-result.dto.js","sourceRoot":"","sources":["../../src/dto/health-check-result.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAEnE,oEAA2D;AAE3D,MAAa,oBAAoB;IAE7B,IAAI,CAAU;IAQd,MAAM,CAAgB;IAGtB,QAAQ,CAAW;IAGnB,UAAU,CAAU;IAOpB,KAAK,CAAU;CAClB;AAxBD,oDAwBC;AAtBG;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;kDACrC;AAQd;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,4BAA4B;QACzC,IAAI,EAAE,iCAAY;QAClB,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,iCAAY,CAAC,EAAE;KAC3B,CAAC;;oDACoB;AAGtB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;;sDACtE;AAGnB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;wDACxB;AAOpB;IALC,IAAA,6BAAmB,EAAC;QACjB,WAAW,EAAE,8DAA8D;QAC3E,OAAO,EAAE,wBAAwB;QACjC,IAAI,EAAE,MAAM;KACf,CAAC;;mDACa"}

package/dist/dto/health-report-response.dto.d.ts

@@ -0,0 +1,15 @@
+import { HealthStatus } from '../enums/health-status.enum';
+import { EventLoopDelayDto } from './event-loop-delay.dto';
+import { HealthCheckResultDto } from './health-check-result.dto';
+import { MemoryUsageDto } from './memory-usage.dto';
+export declare class HealthReportResponseDto {
+    status: HealthStatus;
+    service: string;
+    version?: string;
+    node: string;
+    uptimeSec: number;
+    timestamp: string;
+    memory: MemoryUsageDto;
+    eventLoop: EventLoopDelayDto;
+    checks: HealthCheckResultDto[];
+}

package/dist/dto/health-report-response.dto.js

@@ -0,0 +1,66 @@
+"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.HealthReportResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const health_status_enum_1 = require("../enums/health-status.enum");
+const event_loop_delay_dto_1 = require("./event-loop-delay.dto");
+const health_check_result_dto_1 = require("./health-check-result.dto");
+const memory_usage_dto_1 = require("./memory-usage.dto");
+class HealthReportResponseDto {
+    status;
+    service;
+    version;
+    node;
+    uptimeSec;
+    timestamp;
+    memory;
+    eventLoop;
+    checks;
+}
+exports.HealthReportResponseDto = HealthReportResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: health_status_enum_1.HealthStatus, enumName: 'HealthStatus', example: health_status_enum_1.HealthStatus.Ok }),
+    __metadata("design:type", String)
+], HealthReportResponseDto.prototype, "status", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'api', type: String }),
+    __metadata("design:type", String)
+], HealthReportResponseDto.prototype, "service", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ example: 'v0.4.2', type: String }),
+    __metadata("design:type", String)
+], HealthReportResponseDto.prototype, "version", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'v22.23.2', type: String }),
+    __metadata("design:type", String)
+], HealthReportResponseDto.prototype, "node", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 3600, type: Number }),
+    __metadata("design:type", Number)
+], HealthReportResponseDto.prototype, "uptimeSec", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: '2026-07-03T10:00:00.000Z', format: 'date-time', type: String }),
+    __metadata("design:type", String)
+], HealthReportResponseDto.prototype, "timestamp", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: memory_usage_dto_1.MemoryUsageDto }),
+    __metadata("design:type", memory_usage_dto_1.MemoryUsageDto)
+], HealthReportResponseDto.prototype, "memory", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: event_loop_delay_dto_1.EventLoopDelayDto }),
+    __metadata("design:type", event_loop_delay_dto_1.EventLoopDelayDto)
+], HealthReportResponseDto.prototype, "eventLoop", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ isArray: true, type: health_check_result_dto_1.HealthCheckResultDto }),
+    __metadata("design:type", Array)
+], HealthReportResponseDto.prototype, "checks", void 0);
+//# sourceMappingURL=health-report-response.dto.js.map

package/dist/dto/health-report-response.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-report-response.dto.js","sourceRoot":"","sources":["../../src/dto/health-report-response.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AAEnE,oEAA2D;AAC3D,iEAA2D;AAC3D,uEAAiE;AACjE,yDAAoD;AAEpD,MAAa,uBAAuB;IAEhC,MAAM,CAAgB;IAGtB,OAAO,CAAU;IAGjB,OAAO,CAAU;IAGjB,IAAI,CAAU;IAGd,SAAS,CAAU;IAGnB,SAAS,CAAU;IAGnB,MAAM,CAAkB;IAGxB,SAAS,CAAqB;IAG9B,MAAM,CAA0B;CACnC;AA3BD,0DA2BC;AAzBG;IADC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,iCAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,iCAAY,CAAC,EAAE,EAAE,CAAC;;uDAClE;AAGtB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;wDAC7B;AAGjB;IADC,IAAA,6BAAmB,EAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;wDACxC;AAGjB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;qDACrC;AAGd;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;0DAC1B;AAGnB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;0DACrE;AAGnB;IADC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,iCAAc,EAAE,CAAC;8BAC7B,iCAAc;uDAAC;AAGxB;IADC,IAAA,qBAAW,EAAC,EAAE,IAAI,EAAE,wCAAiB,EAAE,CAAC;8BAC7B,wCAAiB;0DAAC;AAG9B;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,8CAAoB,EAAE,CAAC;;uDAC3B"}

package/dist/dto/memory-usage.dto.d.ts

@@ -0,0 +1,11 @@
+export declare class MemoryUsageDto {
+    rssMiB: number;
+    heapUsedMiB: number;
+    heapTotalMiB: number;
+    externalMiB: number;
+    arrayBuffersMiB: number;
+    heapLimitMiB: number;
+    containerLimitMiB: number | null;
+    heapRatio: number;
+    rssRatio: number | null;
+}

package/dist/dto/memory-usage.dto.js

@@ -0,0 +1,72 @@
+"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.MemoryUsageDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class MemoryUsageDto {
+    rssMiB;
+    heapUsedMiB;
+    heapTotalMiB;
+    externalMiB;
+    arrayBuffersMiB;
+    heapLimitMiB;
+    containerLimitMiB;
+    heapRatio;
+    rssRatio;
+}
+exports.MemoryUsageDto = MemoryUsageDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 182.4, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "rssMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 96.1, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "heapUsedMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 120.5, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "heapTotalMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 4.2, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "externalMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 1.3, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "arrayBuffersMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'V8 `heap_size_limit`.', example: 259, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "heapLimitMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'cgroup memory limit, `null` when unconstrained.',
+        example: 512,
+        nullable: true,
+        type: Number,
+    }),
+    __metadata("design:type", Object)
+], MemoryUsageDto.prototype, "containerLimitMiB", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: '`heapUsed / heapLimit`.', example: 0.371, type: Number }),
+    __metadata("design:type", Number)
+], MemoryUsageDto.prototype, "heapRatio", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: '`rss / containerLimit`, `null` when unconstrained.',
+        example: 0.356,
+        nullable: true,
+        type: Number,
+    }),
+    __metadata("design:type", Object)
+], MemoryUsageDto.prototype, "rssRatio", void 0);
+//# sourceMappingURL=memory-usage.dto.js.map

package/dist/dto/memory-usage.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-usage.dto.js","sourceRoot":"","sources":["../../src/dto/memory-usage.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA8C;AAE9C,MAAa,cAAc;IAEvB,MAAM,CAAU;IAGhB,WAAW,CAAU;IAGrB,YAAY,CAAU;IAGtB,WAAW,CAAU;IAGrB,eAAe,CAAU;IAGzB,YAAY,CAAU;IAQtB,iBAAiB,CAAiB;IAGlC,SAAS,CAAU;IAQnB,QAAQ,CAAiB;CAC5B;AArCD,wCAqCC;AAnCG;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;8CAC9B;AAGhB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;mDACxB;AAGrB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;oDACxB;AAGtB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;mDACvB;AAGrB;IADC,IAAA,qBAAW,EAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;uDACnB;AAGzB;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;oDAC5D;AAQtB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,iDAAiD;QAC9D,OAAO,EAAE,GAAG;QACZ,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM;KACf,CAAC;;yDACgC;AAGlC;IADC,IAAA,qBAAW,EAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;iDACnE;AAQnB;IANC,IAAA,qBAAW,EAAC;QACT,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,MAAM;KACf,CAAC;;gDACuB"}

package/dist/enums/health-status.enum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Wire values of the health contract. `degraded`: a non-critical check fails,
+ * the pod keeps serving. `down`: a critical check fails or the app is shutting
+ * down, readiness answers 503.
+ */
+export declare enum HealthStatus {
+    Ok = "ok",
+    Degraded = "degraded",
+    Down = "down"
+}

package/dist/enums/health-status.enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthStatus = void 0;
+/**
+ * Wire values of the health contract. `degraded`: a non-critical check fails,
+ * the pod keeps serving. `down`: a critical check fails or the app is shutting
+ * down, readiness answers 503.
+ */
+var HealthStatus;
+(function (HealthStatus) {
+    HealthStatus["Ok"] = "ok";
+    HealthStatus["Degraded"] = "degraded";
+    HealthStatus["Down"] = "down";
+})(HealthStatus || (exports.HealthStatus = HealthStatus = {}));
+//# sourceMappingURL=health-status.enum.js.map

package/dist/enums/health-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-status.enum.js","sourceRoot":"","sources":["../../src/enums/health-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACpB,yBAAS,CAAA;IACT,qCAAqB,CAAA;IACrB,6BAAa,CAAA;AACjB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB"}

package/dist/health.constants.d.ts

@@ -0,0 +1,4 @@
+export declare const HEALTH_OPTIONS: unique symbol;
+export declare const HEALTH_INDICATORS: unique symbol;
+export declare const DEFAULT_CHECK_TIMEOUT_MS = 750;
+export declare const DEFAULT_MEMORY_RATIO = 0.9;

package/dist/health.constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEMORY_RATIO = exports.DEFAULT_CHECK_TIMEOUT_MS = exports.HEALTH_INDICATORS = exports.HEALTH_OPTIONS = void 0;
+exports.HEALTH_OPTIONS = Symbol('HEALTH_OPTIONS');
+exports.HEALTH_INDICATORS = Symbol('HEALTH_INDICATORS');
+exports.DEFAULT_CHECK_TIMEOUT_MS = 750;
+exports.DEFAULT_MEMORY_RATIO = 0.9;
+//# sourceMappingURL=health.constants.js.map

package/dist/health.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.constants.js","sourceRoot":"","sources":["../src/health.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC1C,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAEhD,QAAA,wBAAwB,GAAG,GAAG,CAAC;AAC/B,QAAA,oBAAoB,GAAG,GAAG,CAAC"}

package/dist/health.controller.d.ts

@@ -0,0 +1,6 @@
+import { type Type } from '@nestjs/common';
+/**
+ * Built per `forRoot` so the app's probe decorators (`Public()`) land on this
+ * app's controller only, without mutating a shared class.
+ */
+export declare function createHealthController(probeDecorators?: MethodDecorator[]): Type<unknown>;

package/dist/health.controller.js

@@ -0,0 +1,87 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHealthController = createHealthController;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const health_check_response_dto_1 = require("./dto/health-check-response.dto");
+const health_report_response_dto_1 = require("./dto/health-report-response.dto");
+const health_status_enum_1 = require("./enums/health-status.enum");
+const health_service_1 = require("./health.service");
+/**
+ * Built per `forRoot` so the app's probe decorators (`Public()`) land on this
+ * app's controller only, without mutating a shared class.
+ */
+function createHealthController(probeDecorators = []) {
+    const probe = (0, common_1.applyDecorators)(...probeDecorators);
+    let HealthController = class HealthController {
+        health;
+        constructor(health) {
+            this.health = health;
+        }
+        live() {
+            return this.health.live();
+        }
+        async ready(res) {
+            const body = await this.health.ready();
+            if (body.status === health_status_enum_1.HealthStatus.Down)
+                res.status(common_1.HttpStatus.SERVICE_UNAVAILABLE);
+            return body;
+        }
+        status() {
+            return this.health.report();
+        }
+    };
+    __decorate([
+        (0, common_1.Get)(),
+        probe,
+        (0, common_1.Header)('Cache-Control', 'no-store'),
+        (0, swagger_1.ApiOperation)({ summary: 'Liveness: the process answers; no dependency is checked' }),
+        (0, swagger_1.ApiOkResponse)({ type: health_check_response_dto_1.HealthCheckResponseDto }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", health_check_response_dto_1.HealthCheckResponseDto)
+    ], HealthController.prototype, "live", null);
+    __decorate([
+        (0, common_1.Get)('ready'),
+        probe,
+        (0, common_1.Header)('Cache-Control', 'no-store'),
+        (0, swagger_1.ApiOperation)({ summary: 'Readiness: memory pressure and critical dependencies' }),
+        (0, swagger_1.ApiOkResponse)({ type: health_check_response_dto_1.HealthCheckResponseDto }),
+        (0, swagger_1.ApiServiceUnavailableResponse)({ type: health_check_response_dto_1.HealthCheckResponseDto }),
+        __param(0, (0, common_1.Res)({ passthrough: true })),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [Object]),
+        __metadata("design:returntype", Promise)
+    ], HealthController.prototype, "ready", null);
+    __decorate([
+        (0, common_1.Get)('status'),
+        (0, common_1.Header)('Cache-Control', 'no-store'),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Diagnostics: memory, event loop delay, every check with its error',
+        }),
+        (0, swagger_1.ApiOkResponse)({ type: health_report_response_dto_1.HealthReportResponseDto }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Promise)
+    ], HealthController.prototype, "status", null);
+    HealthController = __decorate([
+        (0, swagger_1.ApiTags)('health'),
+        (0, common_1.Controller)('health'),
+        __param(0, (0, common_1.Inject)(health_service_1.HealthService)),
+        __metadata("design:paramtypes", [health_service_1.HealthService])
+    ], HealthController);
+    return HealthController;
+}
+//# sourceMappingURL=health.controller.js.map