@zola_do/health 0.2.5

package/README.md

@@ -0,0 +1,61 @@
+# @zola_do/health
+
+NestJS readiness/liveness helpers built on [`@nestjs/terminus`](https://docs.nestjs.com/recipes/terminus), aligned with `@zola_do` env conventions (TypeORM, RabbitMQ audit, MinIO, Seaweed/S3).
+
+## Install
+
+```bash
+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
+
+```typescript
+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

package/dist/health.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { ZolaHealthModuleOptions } from './zola-health-options';
+export declare class ZolaHealthModule {
+    static forRoot(options?: ZolaHealthModuleOptions): DynamicModule;
+}
+export { ZolaHealthModule as HealthModule };

package/dist/health.module.js

@@ -0,0 +1,65 @@
+"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 ZolaHealthModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthModule = exports.ZolaHealthModule = void 0;
+const common_1 = require("@nestjs/common");
+const zola_health_fallback_controller_1 = require("./zola-health-fallback.controller");
+const zola_health_constants_1 = require("./zola-health.constants");
+const zola_health_options_1 = require("./zola-health-options");
+function isTerminusAvailable() {
+    try {
+        require.resolve('@nestjs/terminus');
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+let ZolaHealthModule = ZolaHealthModule_1 = class ZolaHealthModule {
+    static forRoot(options = {}) {
+        const merged = (0, zola_health_options_1.normalizeZolaHealthOptions)(options);
+        const path = merged.path;
+        if (!isTerminusAvailable()) {
+            return {
+                module: ZolaHealthModule_1,
+                controllers: [(0, zola_health_fallback_controller_1.createZolaHealthFallbackController)(path)],
+            };
+        }
+        const { TerminusModule } = require('@nestjs/terminus');
+        const { createZolaTerminusHealthController } = require('./zola-terminus-health.controller');
+        const ControllerClass = createZolaTerminusHealthController(path);
+        if (merged.rabbitmq &&
+            process.env.NODE_ENV !== 'production') {
+            let rmqOk = false;
+            try {
+                require.resolve('@nestjs/microservices');
+                require.resolve('amqplib');
+                rmqOk = Boolean(process.env.RMQ_URL);
+            }
+            catch (_a) {
+                rmqOk = false;
+            }
+            if (!rmqOk) {
+                console.warn('ZolaHealthModule: rabbitmq check enabled but RMQ_URL and/or @nestjs/microservices+amqplib are missing; RabbitMQ ping will be skipped.');
+            }
+        }
+        return {
+            module: ZolaHealthModule_1,
+            imports: [TerminusModule],
+            controllers: [ControllerClass],
+            providers: [{ provide: zola_health_constants_1.ZOLA_HEALTH_OPTIONS, useValue: merged }],
+        };
+    }
+};
+exports.ZolaHealthModule = ZolaHealthModule;
+exports.HealthModule = ZolaHealthModule;
+exports.HealthModule = exports.ZolaHealthModule = ZolaHealthModule = ZolaHealthModule_1 = __decorate([
+    (0, common_1.Module)({})
+], ZolaHealthModule);
+//# sourceMappingURL=health.module.js.map

package/dist/health.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.module.js","sourceRoot":"","sources":["../src/health.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,uFAAuF;AACvF,mEAA8D;AAC9D,+DAG+B;AAE/B,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAGM,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B,MAAM,CAAC,OAAO,CAAC,UAAmC,EAAE;QAClD,MAAM,MAAM,GAAG,IAAA,gDAA0B,EAAC,OAAO,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAEzB,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC3B,OAAO;gBACL,MAAM,EAAE,kBAAgB;gBACxB,WAAW,EAAE,CAAC,IAAA,oEAAkC,EAAC,IAAI,CAAC,CAAC;aACxD,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,EAAE,kCAAkC,EAAE,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC5F,MAAM,eAAe,GAAG,kCAAkC,CAAC,IAAI,CAAC,CAAC;QAEjE,IACE,MAAM,CAAC,QAAQ;YACf,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EACrC,CAAC;YACD,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;gBACzC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC3B,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YAAC,WAAM,CAAC;gBACP,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CACV,uIAAuI,CACxI,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,OAAO,EAAE,CAAC,cAAc,CAAC;YACzB,WAAW,EAAE,CAAC,eAAe,CAAC;YAC9B,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,2CAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;SAChE,CAAC;IACJ,CAAC;CACF,CAAA;AA1CY,4CAAgB;AA6CA,wCAAY;kDA7C5B,gBAAgB;IAD5B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,gBAAgB,CA0C5B"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './health.module';
+export * from './zola-health.constants';
+export * from './zola-health-options';
+export * from './zola-health-public.decorator';

package/dist/index.js

@@ -0,0 +1,21 @@
+"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("./health.module"), exports);
+__exportStar(require("./zola-health.constants"), exports);
+__exportStar(require("./zola-health-options"), exports);
+__exportStar(require("./zola-health-public.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,0DAAwC;AACxC,wDAAsC;AACtC,iEAA+C"}

package/dist/zola-health-fallback.controller.d.ts

@@ -0,0 +1,10 @@
+export declare function createZolaHealthFallbackController(routePath: string): {
+    new (): {
+        health(): {
+            status: string;
+            mode: string;
+            hint: string;
+            timestamp: string;
+        };
+    };
+};

package/dist/zola-health-fallback.controller.js

@@ -0,0 +1,38 @@
+"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.createZolaHealthFallbackController = createZolaHealthFallbackController;
+const common_1 = require("@nestjs/common");
+const zola_health_public_decorator_1 = require("./zola-health-public.decorator");
+function createZolaHealthFallbackController(routePath) {
+    let ZolaHealthFallbackController = class ZolaHealthFallbackController {
+        health() {
+            return {
+                status: 'ok',
+                mode: 'minimal',
+                hint: 'Install @nestjs/terminus for database and integration health checks.',
+                timestamp: new Date().toISOString(),
+            };
+        }
+    };
+    __decorate([
+        (0, common_1.Get)(),
+        (0, zola_health_public_decorator_1.ZolaHealthPublic)(),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", void 0)
+    ], ZolaHealthFallbackController.prototype, "health", null);
+    ZolaHealthFallbackController = __decorate([
+        (0, common_1.Controller)(routePath)
+    ], ZolaHealthFallbackController);
+    return ZolaHealthFallbackController;
+}
+//# sourceMappingURL=zola-health-fallback.controller.js.map

package/dist/zola-health-fallback.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-health-fallback.controller.js","sourceRoot":"","sources":["../src/zola-health-fallback.controller.ts"],"names":[],"mappings":";;;;;;;;;;;AAGA,gFAeC;AAlBD,2CAAiD;AACjD,iFAAkE;AAElE,SAAgB,kCAAkC,CAAC,SAAiB;IAElE,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;QAGhC,MAAM;YACJ,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,sEAAsE;gBAC5E,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;KACF,CAAA;IARC;QAFC,IAAA,YAAG,GAAE;QACL,IAAA,+CAAgB,GAAE;;;;8DAQlB;IAVG,4BAA4B;QADjC,IAAA,mBAAU,EAAC,SAAS,CAAC;OAChB,4BAA4B,CAWjC;IACD,OAAO,4BAA4B,CAAC;AACtC,CAAC"}

package/dist/zola-health-options.d.ts

@@ -0,0 +1,23 @@
+export interface ZolaHealthModuleOptions {
+    path?: string;
+    typeorm?: boolean | string;
+    rabbitmq?: boolean;
+    minio?: boolean;
+    seaweed?: boolean;
+    http?: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+export interface NormalizedZolaHealthModuleOptions {
+    path: string;
+    typeorm: boolean | string;
+    rabbitmq: boolean;
+    minio: boolean;
+    seaweed: boolean;
+    http: Array<{
+        name: string;
+        url: string;
+    }>;
+}
+export declare function normalizeZolaHealthOptions(options?: ZolaHealthModuleOptions): NormalizedZolaHealthModuleOptions;

package/dist/zola-health-options.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeZolaHealthOptions = normalizeZolaHealthOptions;
+function normalizeZolaHealthOptions(options = {}) {
+    var _a, _b;
+    return {
+        path: (_a = options.path) !== null && _a !== void 0 ? _a : 'health',
+        typeorm: options.typeorm !== undefined ? options.typeorm : true,
+        rabbitmq: options.rabbitmq === true,
+        minio: options.minio === true,
+        seaweed: options.seaweed === true,
+        http: (_b = options.http) !== null && _b !== void 0 ? _b : [],
+    };
+}
+//# sourceMappingURL=zola-health-options.js.map

package/dist/zola-health-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-health-options.js","sourceRoot":"","sources":["../src/zola-health-options.ts"],"names":[],"mappings":";;AA4BA,gEAWC;AAXD,SAAgB,0BAA0B,CACxC,UAAmC,EAAE;;IAErC,OAAO;QACL,IAAI,EAAE,MAAA,OAAO,CAAC,IAAI,mCAAI,QAAQ;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC/D,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;QACjC,IAAI,EAAE,MAAA,OAAO,CAAC,IAAI,mCAAI,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/zola-health-public.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const ZOLA_HEALTH_ALLOW_ANONYMOUS_KEY = "allowAnonymous";
+export declare const ZolaHealthPublic: () => import("@nestjs/common").CustomDecorator<string>;

package/dist/zola-health-public.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZolaHealthPublic = exports.ZOLA_HEALTH_ALLOW_ANONYMOUS_KEY = void 0;
+const common_1 = require("@nestjs/common");
+exports.ZOLA_HEALTH_ALLOW_ANONYMOUS_KEY = 'allowAnonymous';
+const ZolaHealthPublic = () => (0, common_1.SetMetadata)(exports.ZOLA_HEALTH_ALLOW_ANONYMOUS_KEY, true);
+exports.ZolaHealthPublic = ZolaHealthPublic;
+//# sourceMappingURL=zola-health-public.decorator.js.map

package/dist/zola-health-public.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-health-public.decorator.js","sourceRoot":"","sources":["../src/zola-health-public.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAGhC,QAAA,+BAA+B,GAAG,gBAAgB,CAAC;AAEzD,MAAM,gBAAgB,GAAG,GAAG,EAAE,CACnC,IAAA,oBAAW,EAAC,uCAA+B,EAAE,IAAI,CAAC,CAAC;AADxC,QAAA,gBAAgB,oBACwB"}

package/dist/zola-health.constants.d.ts

@@ -0,0 +1 @@
+export declare const ZOLA_HEALTH_OPTIONS: unique symbol;

package/dist/zola-health.constants.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZOLA_HEALTH_OPTIONS = void 0;
+exports.ZOLA_HEALTH_OPTIONS = Symbol('ZOLA_HEALTH_OPTIONS');
+//# sourceMappingURL=zola-health.constants.js.map

package/dist/zola-health.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zola-health.constants.js","sourceRoot":"","sources":["../src/zola-health.constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/zola-terminus-health.controller.d.ts

@@ -0,0 +1,12 @@
+import { HealthCheckService, MemoryHealthIndicator, MicroserviceHealthIndicator, TypeOrmHealthIndicator } from '@nestjs/terminus';
+import type { NormalizedZolaHealthModuleOptions } from './zola-health-options';
+export declare function createZolaTerminusHealthController(routePath: string): {
+    new (health: HealthCheckService, memory: MemoryHealthIndicator, opts: NormalizedZolaHealthModuleOptions, typeOrm?: TypeOrmHealthIndicator, microservice?: MicroserviceHealthIndicator): {
+        readonly health: HealthCheckService;
+        readonly memory: MemoryHealthIndicator;
+        readonly opts: NormalizedZolaHealthModuleOptions;
+        readonly typeOrm?: TypeOrmHealthIndicator;
+        readonly microservice?: MicroserviceHealthIndicator;
+        check(): Promise<import("@nestjs/terminus").HealthCheckResult<import("@nestjs/terminus").HealthIndicatorResult<string, import("@nestjs/terminus").HealthIndicatorStatus, Record<string, any>>, Partial<import("@nestjs/terminus").HealthIndicatorResult<string, import("@nestjs/terminus").HealthIndicatorStatus, Record<string, any>>>, Partial<import("@nestjs/terminus").HealthIndicatorResult<string, import("@nestjs/terminus").HealthIndicatorStatus, Record<string, any>>>>>;
+    };
+};

package/dist/zola-terminus-health.controller.js

@@ -0,0 +1,141 @@
+"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.createZolaTerminusHealthController = createZolaTerminusHealthController;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const microservices_1 = require("@nestjs/microservices");
+const zola_health_constants_1 = require("./zola-health.constants");
+const zola_health_public_decorator_1 = require("./zola-health-public.decorator");
+function buildMinioHealthUrl() {
+    var _a, _b;
+    const host = process.env.MINIO_ENDPOINT;
+    if (!host) {
+        return null;
+    }
+    const port = (_a = process.env.MINIO_PORT) !== null && _a !== void 0 ? _a : '9000';
+    const ssl = String((_b = process.env.MINIO_USESSL) !== null && _b !== void 0 ? _b : '').toLowerCase() === 'true';
+    const proto = ssl ? 'https' : 'http';
+    return `${proto}://${host}:${port}/minio/health/live`;
+}
+function buildSeaweedHealthUrl() {
+    let base = process.env.AWS_ENDPOINT;
+    if (!base) {
+        return null;
+    }
+    if (!/^https?:\/\//i.test(base)) {
+        base = `https://${base}`;
+    }
+    return base.replace(/\/$/, '') + '/';
+}
+async function zolaHttpPing(key, url, timeoutMs = 3000) {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, {
+            signal: ac.signal,
+            method: 'GET',
+            redirect: 'follow',
+        });
+        if (res.status >= 500) {
+            throw new terminus_1.HealthCheckError(`${key} responded with ${res.status}`, { [key]: { status: 'down', message: `HTTP ${res.status}` } });
+        }
+        return { [key]: { status: 'up' } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new terminus_1.HealthCheckError(`${key} is not available`, {
+            [key]: { status: 'down', message },
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function isRabbitMqPingAvailable() {
+    try {
+        require.resolve('@nestjs/microservices');
+        require.resolve('amqplib');
+        return Boolean(process.env.RMQ_URL);
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function createZolaTerminusHealthController(routePath) {
+    let ZolaTerminusHealthController = class ZolaTerminusHealthController {
+        constructor(health, memory, opts, typeOrm, microservice) {
+            this.health = health;
+            this.memory = memory;
+            this.opts = opts;
+            this.typeOrm = typeOrm;
+            this.microservice = microservice;
+        }
+        check() {
+            const checks = [];
+            const typeormOpt = this.opts.typeorm;
+            if (typeormOpt !== false && this.typeOrm) {
+                const key = typeof typeormOpt === 'string' ? typeormOpt : 'database';
+                checks.push(() => this.typeOrm.pingCheck(key, { timeout: 2000 }));
+            }
+            if (this.opts.rabbitmq && this.microservice && isRabbitMqPingAvailable()) {
+                checks.push(() => this.microservice.pingCheck('rabbitmq', {
+                    transport: microservices_1.Transport.RMQ,
+                    timeout: 3000,
+                    options: {
+                        urls: [process.env.RMQ_URL],
+                    },
+                }));
+            }
+            if (this.opts.minio) {
+                const minioUrl = buildMinioHealthUrl();
+                if (minioUrl) {
+                    checks.push(() => zolaHttpPing('minio', minioUrl));
+                }
+            }
+            if (this.opts.seaweed) {
+                const seaweedUrl = buildSeaweedHealthUrl();
+                if (seaweedUrl) {
+                    checks.push(() => zolaHttpPing('seaweed', seaweedUrl));
+                }
+            }
+            for (const h of this.opts.http) {
+                checks.push(() => zolaHttpPing(h.name, h.url));
+            }
+            if (checks.length === 0) {
+                checks.push(() => this.memory.checkHeap('memory', 64 * 1024 * 1024 * 1024));
+            }
+            return this.health.check(checks);
+        }
+    };
+    __decorate([
+        (0, common_1.Get)(),
+        (0, terminus_1.HealthCheck)(),
+        (0, zola_health_public_decorator_1.ZolaHealthPublic)(),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", void 0)
+    ], ZolaTerminusHealthController.prototype, "check", null);
+    ZolaTerminusHealthController = __decorate([
+        (0, common_1.Controller)(routePath),
+        __param(2, (0, common_1.Inject)(zola_health_constants_1.ZOLA_HEALTH_OPTIONS)),
+        __param(3, (0, common_1.Optional)()),
+        __param(4, (0, common_1.Optional)()),
+        __metadata("design:paramtypes", [terminus_1.HealthCheckService,
+            terminus_1.MemoryHealthIndicator, Object, terminus_1.TypeOrmHealthIndicator,
+            terminus_1.MicroserviceHealthIndicator])
+    ], ZolaTerminusHealthController);
+    return ZolaTerminusHealthController;
+}
+//# sourceMappingURL=zola-terminus-health.controller.js.map

package/dist/zola-terminus-health.controller.js.map

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

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@zola_do/health",
+  "version": "0.2.5",
+  "description": "NestJS health checks (Terminus) aligned with @zola_do TypeORM, RabbitMQ, and storage env patterns",
+  "author": "zolaDO",
+  "license": "ISC",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "build": "npm run clean && tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "@nestjs/core": "^10.0.0 || ^11.0.0",
+    "@nestjs/microservices": "^10.0.0 || ^11.0.0",
+    "@nestjs/terminus": "^10.0.0 || ^11.0.0",
+    "@nestjs/typeorm": "^10.0.0 || ^11.0.0",
+    "amqplib": "^0.10.0",
+    "reflect-metadata": "^0.1.0 || ^0.2.0",
+    "rxjs": "^7.0.0 || ^8.0.0",
+    "typeorm": "^0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/terminus": {
+      "optional": true
+    },
+    "@nestjs/microservices": {
+      "optional": true
+    },
+    "@nestjs/typeorm": {
+      "optional": true
+    },
+    "amqplib": {
+      "optional": true
+    },
+    "typeorm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "rimraf": "^6.1.3",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "directory": "packages/health",
+    "type": "git",
+    "url": "https://github.com/zola0031/zola-nestjs-shared.git"
+  },
+  "homepage": "https://github.com/zola0031/zola-nestjs-shared#readme",
+  "bugs": {
+    "url": "https://github.com/zola0031/zola-nestjs-shared/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/zola0031"
+  },
+  "keywords": [
+    "nestjs",
+    "typescript",
+    "health",
+    "terminus",
+    "readiness",
+    "liveness",
+    "zola_do",
+    "nestjs-shared"
+  ]
+}