@zola_do/health

NestJS readiness/liveness helpers built on @nestjs/terminus, aligned with @zola_do env conventions (TypeORM, RabbitMQ audit, MinIO, Seaweed/S3).

Install

pnpm add @zola_do/health @nestjs/terminus

Optional peers (enable related checks only when installed and configured):

• @nestjs/typeorm, typeorm — database ping
• @nestjs/microservices, amqplib — RabbitMQ ping when RMQ_URL is set

Usage

import { ZolaHealthModule } from '@zola_do/health';

@Module({
  imports: [
    TypeOrmModule.forRoot(/* ... */),
    ZolaHealthModule.forRoot({
      path: 'health',
      typeorm: true,
      rabbitmq: true,
      minio: true,
      seaweed: true,
      http: [{ name: 'docs', url: 'https://example.com/status' }],
    }),
  ],
})
export class AppModule {}

• path: controller route (default health → GET /health).
• typeorm: true (key database), a custom string key, or false to skip.
• rabbitmq: uses RMQ_URL and Terminus microservice ping (requires optional peers above).
• minio: GET http(s)://MINIO_ENDPOINT:MINIO_PORT/minio/health/live from MINIO_* env vars.
• seaweed: GET AWS_ENDPOINT (prefixes https:// if missing); treats HTTP ≥ 500 as down.
• http: extra { name, url } GET checks via fetch.

If @nestjs/terminus is not installed, the module registers a minimal GET /health JSON body (mode: 'minimal') so imports stay safe.

Global JWT guard

Use @ZolaHealthPublic() on custom health routes, or rely on the built-in controller: it sets the same allowAnonymous metadata key as @AllowAnonymous() from @zola_do/authorization.

Environment variables

| Check | Variables | |----------|-----------| | TypeORM | Same as your app / @zola_do/typeorm (DATABASE_*) | | RabbitMQ | RMQ_URL | | MinIO | MINIO_ENDPOINT, MINIO_PORT, MINIO_USESSL | | Seaweed | AWS_ENDPOINT |

License

ISC