nest-healthkit 0.1.0

package/README.md

@@ -0,0 +1,177 @@
+# nest-healthkit
+
+## Why nest-healthkit
+`nest-healthkit` removes the manual controller and indicator wiring that teams usually build around NestJS health endpoints. It keeps the flexibility of custom checks while shipping a batteries-included readiness and liveness setup. It complements `@nestjs/terminus` instead of replacing it.
+
+## Installation
+```bash
+npm install nest-healthkit
+```
+
+## Quick Start
+```ts
+import { Module } from '@nestjs/common';
+import { HealthkitModule } from 'nest-healthkit';
+
+import { PrismaService } from './prisma.service';
+
+@Module({
+  imports: [
+    HealthkitModule.forRoot({
+      ui: true,
+      cacheTtl: 5000,
+      indicators: {
+        prisma: { prismaToken: PrismaService, name: 'postgres' },
+        redis: { redisToken: 'REDIS_CLIENT' },
+        memory: { heapThreshold: 400 * 1024 * 1024 },
+      },
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Configuration Reference
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `path` | `string` | `'health'` | Route prefix used for all health endpoints. |
+| `ui` | `boolean` | `false` | Enables the HTML dashboard at `/{path}/ui`. |
+| `authHeaders` | `Record<string, string>` | `undefined` | Required request headers for all health endpoints. |
+| `timeout` | `number` | `5000` | Per-check timeout in milliseconds. |
+| `cacheTtl` | `number` | `0` | Result cache TTL in milliseconds. |
+| `indicators.prisma` | `PrismaIndicatorOptions` | `undefined` | Enables the Prisma indicator. |
+| `indicators.typeorm` | `TypeOrmIndicatorOptions` | `undefined` | Enables the TypeORM indicator. |
+| `indicators.redis` | `RedisIndicatorOptions` | `undefined` | Enables the Redis indicator. |
+| `indicators.http` | `HttpIndicatorOptions \| HttpIndicatorOptions[]` | `undefined` | Enables one or more HTTP checks. |
+| `indicators.memory` | `MemoryIndicatorOptions` | `undefined` | Enables the memory indicator. |
+| `indicators.disk` | `DiskIndicatorOptions` | `undefined` | Enables the disk indicator. |
+
+## Built-in Indicators
+### Prisma
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    prisma: { prismaToken: PrismaService, name: 'postgres' },
+  },
+});
+```
+
+### TypeORM
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    typeorm: { connectionName: 'default', name: 'typeorm' },
+  },
+});
+```
+
+### Redis
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    redis: { redisToken: 'REDIS_CLIENT', name: 'redis' },
+  },
+});
+```
+
+### HTTP
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    http: [
+      { url: 'https://api.example.com/health', name: 'public-api' },
+      { url: 'https://internal.example.com/status', name: 'internal-api', expectedStatus: 204 },
+    ],
+  },
+});
+```
+
+### Memory
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    memory: {
+      heapThreshold: 300 * 1024 * 1024,
+      heapCritical: 500 * 1024 * 1024,
+    },
+  },
+});
+```
+
+### Disk
+```ts
+HealthkitModule.forRoot({
+  indicators: {
+    disk: {
+      path: '/',
+      thresholdPercent: 0.8,
+      criticalPercent: 0.95,
+    },
+  },
+});
+```
+
+## Custom Checks with `@RegisterHealthCheck()`
+```ts
+import { Injectable } from '@nestjs/common';
+import {
+  HealthIndicatorResult,
+  RegisterHealthCheck,
+} from 'nest-healthkit';
+
+@Injectable()
+export class PaymentHealthIndicator {
+  @RegisterHealthCheck('stripe')
+  async checkStripe(): Promise<HealthIndicatorResult> {
+    return {
+      name: 'stripe',
+      status: 'up',
+      durationMs: 0,
+    };
+  }
+}
+```
+
+Prototype methods are discovered automatically. Arrow-function class properties are not scanned because Nest's metadata scanner only walks the prototype.
+
+## Endpoints
+| Method | Route | Description | Response |
+|---|---|---|---|
+| `GET` | `/{path}/live` | Process liveness check | `{ status, timestamp, uptime, checks }` |
+| `GET` | `/{path}/ready` | Readiness check for all registered indicators | `{ status, timestamp, uptime, checks }` |
+| `GET` | `/{path}` | Alias for readiness | `{ status, timestamp, uptime, checks }` |
+| `GET` | `/{path}/ui` | Optional HTML dashboard | HTML when enabled, `{ error: 'Not found' }` when disabled |
+
+`status: 'up'` and `status: 'degraded'` return HTTP `200`. `status: 'down'` returns HTTP `503`.
+
+## Dashboard UI
+Enable the dashboard with `ui: true` to serve a lightweight dark-mode HTML view at `/{path}/ui`. The page shows overall status, uptime, timestamp, and a per-check table, and it auto-refreshes every 30 seconds. Think of it as an operator-friendly snapshot rather than a full monitoring frontend.
+
+## Compatibility
+| Concern | Requirement |
+|---|---|
+| NestJS version | `^9.0.0` and `^10.0.0` |
+| HTTP adapter | Express and Fastify |
+| TypeScript | `^5.0.0` |
+| Node.js | `^18.0.0` |
+| Prisma version | `^4.x` and `^5.x` |
+| TypeORM version | `^0.2.x` and `^0.3.x` |
+| ioredis version | `^4.x` and `^5.x` |
+| ESM/CJS | CJS output only |
+
+## Custom Indicators (advanced)
+```ts
+import { BaseIndicator, HealthCheckFn } from 'nest-healthkit';
+
+class StripeIndicator extends BaseIndicator {
+  getCheck(): HealthCheckFn {
+    return async () =>
+      this.measure('stripe', async () => {
+        await Promise.resolve();
+        return { region: 'us-east-1' };
+      });
+  }
+}
+```
+
+Extend `BaseIndicator` when you want a reusable indicator with consistent duration measurement and error handling, then register the returned `HealthCheckFn` inside your own provider.

package/dist/decorators/health-check.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const HEALTH_CHECK_METADATA = "__healthkit_check__";
+export declare function RegisterHealthCheck(name: string): MethodDecorator;

package/dist/decorators/health-check.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_CHECK_METADATA = void 0;
+exports.RegisterHealthCheck = RegisterHealthCheck;
+const common_1 = require("@nestjs/common");
+exports.HEALTH_CHECK_METADATA = '__healthkit_check__';
+function RegisterHealthCheck(name) {
+    return (0, common_1.SetMetadata)(exports.HEALTH_CHECK_METADATA, name);
+}
+//# sourceMappingURL=health-check.decorator.js.map

package/dist/decorators/health-check.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.decorator.js","sourceRoot":"","sources":["../../src/decorators/health-check.decorator.ts"],"names":[],"mappings":";;;AAIA,kDAEC;AAND,2CAA6C;AAEhC,QAAA,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAA,oBAAW,EAAC,6BAAqB,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/healthkit.constants.d.ts

@@ -0,0 +1,2 @@
+export declare const HEALTHKIT_OPTIONS = "HEALTHKIT_OPTIONS";
+export declare const HEALTHKIT_CHECKS_REGISTRY = "HEALTHKIT_CHECKS_REGISTRY";

package/dist/healthkit.constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTHKIT_CHECKS_REGISTRY = exports.HEALTHKIT_OPTIONS = void 0;
+exports.HEALTHKIT_OPTIONS = 'HEALTHKIT_OPTIONS';
+exports.HEALTHKIT_CHECKS_REGISTRY = 'HEALTHKIT_CHECKS_REGISTRY';
+//# sourceMappingURL=healthkit.constants.js.map

package/dist/healthkit.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthkit.constants.js","sourceRoot":"","sources":["../src/healthkit.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACxC,QAAA,yBAAyB,GAAG,2BAA2B,CAAC"}

package/dist/healthkit.controller.d.ts

@@ -0,0 +1,30 @@
+import { CanActivate } from '@nestjs/common';
+import type { ExecutionContext } from '@nestjs/common';
+import { type HealthCheckResult, type HealthkitModuleOptions } from './healthkit.interfaces';
+import { HealthkitService } from './healthkit.service';
+export declare const HEALTHKIT_CONTROLLER_PATH_READY: unique symbol;
+interface HttpResponseLike {
+    code?: (statusCode: number) => unknown;
+    header?: (name: string, value: string) => unknown;
+    setHeader?: (name: string, value: string) => unknown;
+    status?: (statusCode: number) => unknown;
+    statusCode?: number;
+}
+export declare class HealthkitAuthGuard implements CanActivate {
+    private readonly options;
+    constructor(options: HealthkitModuleOptions);
+    canActivate(context: ExecutionContext): boolean;
+}
+export declare class HealthkitController {
+    private readonly controllerPathReady;
+    private readonly healthkitService;
+    private readonly options;
+    constructor(controllerPathReady: boolean, healthkitService: HealthkitService, options: HealthkitModuleOptions);
+    live(response: HttpResponseLike): Promise<HealthCheckResult | Record<string, string>>;
+    ready(response: HttpResponseLike): Promise<HealthCheckResult | Record<string, string>>;
+    root(response: HttpResponseLike): Promise<HealthCheckResult | Record<string, string>>;
+    ui(response: HttpResponseLike): Promise<string | Record<string, string>>;
+    private runJsonCheck;
+    private handleFailure;
+}
+export {};

package/dist/healthkit.controller.js

@@ -0,0 +1,154 @@
+"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.HealthkitController = exports.HealthkitAuthGuard = exports.HEALTHKIT_CONTROLLER_PATH_READY = void 0;
+const common_1 = require("@nestjs/common");
+const healthkit_constants_1 = require("./healthkit.constants");
+const healthkit_service_1 = require("./healthkit.service");
+const dashboard_html_1 = require("./ui/dashboard.html");
+exports.HEALTHKIT_CONTROLLER_PATH_READY = Symbol('HEALTHKIT_CONTROLLER_PATH_READY');
+let HealthkitAuthGuard = class HealthkitAuthGuard {
+    constructor(options) {
+        this.options = options;
+    }
+    canActivate(context) {
+        const authHeaders = this.options.authHeaders;
+        if (!authHeaders || Object.keys(authHeaders).length === 0) {
+            return true;
+        }
+        const request = context.switchToHttp().getRequest();
+        const headers = request?.headers ?? {};
+        for (const [headerName, expectedValue] of Object.entries(authHeaders)) {
+            const actualValue = headers[headerName.toLowerCase()] ?? headers[headerName];
+            const actual = Array.isArray(actualValue) ? actualValue[0] : actualValue;
+            if (actual !== expectedValue) {
+                throw new common_1.UnauthorizedException({ error: 'Unauthorized' });
+            }
+        }
+        return true;
+    }
+};
+exports.HealthkitAuthGuard = HealthkitAuthGuard;
+exports.HealthkitAuthGuard = HealthkitAuthGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(healthkit_constants_1.HEALTHKIT_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], HealthkitAuthGuard);
+let HealthkitController = class HealthkitController {
+    constructor(controllerPathReady, healthkitService, options) {
+        this.controllerPathReady = controllerPathReady;
+        this.healthkitService = healthkitService;
+        this.options = options;
+        void this.controllerPathReady;
+    }
+    async live(response) {
+        return this.runJsonCheck(response, () => this.healthkitService.runLiveness());
+    }
+    async ready(response) {
+        return this.runJsonCheck(response, () => this.healthkitService.runReadiness());
+    }
+    async root(response) {
+        return this.runJsonCheck(response, () => this.healthkitService.runAll());
+    }
+    async ui(response) {
+        if (!this.options.ui) {
+            setHttpStatus(response, 404);
+            return { error: 'Not found' };
+        }
+        try {
+            const result = await this.healthkitService.runAll();
+            setHttpStatus(response, result.status === 'down' ? 503 : 200);
+            setHeader(response, 'content-type', 'text/html; charset=utf-8');
+            return (0, dashboard_html_1.renderDashboard)(result);
+        }
+        catch (error) {
+            return this.handleFailure(response, error);
+        }
+    }
+    async runJsonCheck(response, fn) {
+        try {
+            const result = await fn();
+            setHttpStatus(response, result.status === 'down' ? 503 : 200);
+            return result;
+        }
+        catch (error) {
+            return this.handleFailure(response, error);
+        }
+    }
+    handleFailure(response, error) {
+        setHttpStatus(response, 503);
+        return {
+            status: 'down',
+            error: 'Health check execution failed',
+            message: error?.message ?? 'Unknown error',
+        };
+    }
+};
+exports.HealthkitController = HealthkitController;
+__decorate([
+    (0, common_1.Get)('live'),
+    __param(0, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthkitController.prototype, "live", null);
+__decorate([
+    (0, common_1.Get)('ready'),
+    __param(0, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthkitController.prototype, "ready", null);
+__decorate([
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthkitController.prototype, "root", null);
+__decorate([
+    (0, common_1.Get)('ui'),
+    __param(0, (0, common_1.Res)({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HealthkitController.prototype, "ui", null);
+exports.HealthkitController = HealthkitController = __decorate([
+    (0, common_1.Controller)('health'),
+    (0, common_1.UseGuards)(HealthkitAuthGuard),
+    __param(0, (0, common_1.Inject)(exports.HEALTHKIT_CONTROLLER_PATH_READY)),
+    __param(2, (0, common_1.Inject)(healthkit_constants_1.HEALTHKIT_OPTIONS)),
+    __metadata("design:paramtypes", [Boolean, healthkit_service_1.HealthkitService, Object])
+], HealthkitController);
+function setHttpStatus(response, statusCode) {
+    if (typeof response.status === 'function') {
+        response.status(statusCode);
+        return;
+    }
+    if (typeof response.code === 'function') {
+        response.code(statusCode);
+        return;
+    }
+    response.statusCode = statusCode;
+}
+function setHeader(response, name, value) {
+    if (typeof response.header === 'function') {
+        response.header(name, value);
+        return;
+    }
+    if (typeof response.setHeader === 'function') {
+        response.setHeader(name, value);
+    }
+}
+//# sourceMappingURL=healthkit.controller.js.map

package/dist/healthkit.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthkit.controller.js","sourceRoot":"","sources":["../src/healthkit.controller.ts"],"names":[],"mappings":"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"}

package/dist/healthkit.interfaces.d.ts

@@ -0,0 +1,69 @@
+import type { FactoryProvider, ModuleMetadata, Type } from '@nestjs/common';
+export type HealthStatus = 'up' | 'down' | 'degraded';
+export interface HealthIndicatorResult {
+    name: string;
+    status: HealthStatus;
+    message?: string;
+    details?: Record<string, unknown>;
+    durationMs: number;
+}
+export interface HealthCheckResult {
+    status: HealthStatus;
+    timestamp: string;
+    uptime: number;
+    checks: HealthIndicatorResult[];
+}
+export type HealthCheckFn = () => Promise<HealthIndicatorResult>;
+export interface HealthkitModuleOptions {
+    path?: string;
+    ui?: boolean;
+    authHeaders?: Record<string, string>;
+    timeout?: number;
+    cacheTtl?: number;
+    indicators?: {
+        prisma?: PrismaIndicatorOptions;
+        typeorm?: TypeOrmIndicatorOptions;
+        redis?: RedisIndicatorOptions;
+        http?: HttpIndicatorOptions | HttpIndicatorOptions[];
+        memory?: MemoryIndicatorOptions;
+        disk?: DiskIndicatorOptions;
+    };
+}
+export interface PrismaIndicatorOptions {
+    prismaToken?: string | symbol | Type<unknown>;
+    name?: string;
+}
+export interface TypeOrmIndicatorOptions {
+    connectionName?: string;
+    name?: string;
+}
+export interface RedisIndicatorOptions {
+    redisToken?: string | symbol | Type<unknown>;
+    name?: string;
+}
+export interface HttpIndicatorOptions {
+    url: string;
+    name?: string;
+    timeout?: number;
+    expectedStatus?: number;
+}
+export interface MemoryIndicatorOptions {
+    heapThreshold?: number;
+    heapCritical?: number;
+    name?: string;
+}
+export interface DiskIndicatorOptions {
+    path?: string;
+    thresholdPercent?: number;
+    criticalPercent?: number;
+    name?: string;
+}
+export interface HealthkitOptionsFactory {
+    createHealthkitOptions(): Promise<HealthkitModuleOptions> | HealthkitModuleOptions;
+}
+export interface HealthkitModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useExisting?: Type<HealthkitOptionsFactory>;
+    useClass?: Type<HealthkitOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<HealthkitModuleOptions> | HealthkitModuleOptions;
+    inject?: FactoryProvider['inject'];
+}

package/dist/healthkit.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=healthkit.interfaces.js.map

package/dist/healthkit.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthkit.interfaces.js","sourceRoot":"","sources":["../src/healthkit.interfaces.ts"],"names":[],"mappings":""}

package/dist/healthkit.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import type { HealthkitModuleAsyncOptions, HealthkitModuleOptions } from './healthkit.interfaces';
+type SyncOptions = HealthkitModuleOptions;
+declare const BaseHealthkitModule: import("@nestjs/common").ConfigurableModuleCls<HealthkitModuleOptions, "forRoot", "createHealthkitOptions", {}>;
+export declare class HealthkitModule extends BaseHealthkitModule {
+    static forRoot(options?: SyncOptions): DynamicModule;
+    static forRootAsync(options: HealthkitModuleAsyncOptions): DynamicModule;
+    private static buildDynamicModule;
+    private static createProviders;
+}
+export {};