@adalo/metrics 0.1.119 → 0.1.120

package/.env.example

@@ -1,8 +1,11 @@
-BUILD_APP_NAME=
-HOSTNAME=
-BUILD_DYNO_PROCESS_TYPE=
-METRICS_ENABLED=
-METRICS_LOG_VALUES=
-METRICS_PUSHGATEWAY_URL=
-METRICS_PUSHGATEWAY_SECRET=
-METRICS_INTERVAL_SEC=
+BUILD_APP_NAME="staging"
+HOSTNAME="staging-queue-metricus"
+BUILD_DYNO_PROCESS_TYPE="web"
+METRICS_ENABLED=true
+METRICS_LOG_VALUES=true
+METRICS_PUSHGATEWAY_URL=https://pushgateway.infradalogs.adalo.com
+METRICS_PUSHGATEWAY_SECRET="METRICS_PUSHGATEWAY_SECRET"
+METRICS_INTERVAL_SEC=60
+
+
+

package/README.md

@@ -48,6 +48,60 @@ metricsClient.gatewayPush({ groupings: { process_type: 'web' } })
 metricsClient.startPush(15) // interval in seconds
 ```
 
+## HealthCheckClient
+
+Provides a health check endpoint for external monitoring services like BetterStack.
+Validates database and Redis connections with rate limiting to prevent excessive load.
+
+```typescript
+import { HealthCheckClient } from '@adalo/metrics'
+import Redis from 'ioredis'
+
+const redisClient = new Redis()
+const healthCheck = new HealthCheckClient({
+  databaseUrl: process.env.DATABASE_URL,
+  databaseName: 'main',
+  additionalDatabaseUrls: {
+    cluster_1: process.env.CLUSTER_1_URL,
+    cluster_2: process.env.CLUSTER_2_URL,
+  },
+  redisClient,
+  cacheTtlMs: 60000, // Cache results for 60 seconds (default)
+})
+
+// Register on Express app
+healthCheck.registerHealthEndpoint(app, '/betterstack-health')
+```
+
+Response format (BetterStack compatible):
+```json
+{
+  "status": "healthy",
+  "timestamp": "2026-01-20T12:00:00.000Z",
+  "cached": false,
+  "components": {
+    "database": {
+      "status": "healthy",
+      "clusters": {
+        "main": { "status": "healthy", "latencyMs": 5 },
+        "cluster_1": { "status": "healthy", "latencyMs": 8 },
+        "cluster_2": { "status": "healthy", "latencyMs": 6 }
+      }
+    },
+    "redis": { "status": "healthy", "latencyMs": 2 }
+  }
+}
+```
+
+Status codes:
+- `200` - healthy or degraded
+- `503` - unhealthy (at least one component failed)
+
+Environment variables:
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `DATABASE_URL` | Main PostgreSQL connection URL | - |
+
 ## Tips
 secret env was created as 
 ```js

package/lib/healthCheckClient.d.ts

@@ -0,0 +1,212 @@
+export type HealthStatus = 'healthy' | 'unhealthy' | 'degraded';
+export type ComponentHealth = {
+    /**
+     * - Component health status
+     */
+    status: HealthStatus;
+    /**
+     * - Optional status message
+     */
+    message?: string | undefined;
+    /**
+     * - Connection latency in milliseconds
+     */
+    latencyMs?: number | undefined;
+};
+export type DatabaseClusterHealth = {
+    /**
+     * - Overall databases status
+     */
+    status: HealthStatus;
+    /**
+     * - Individual cluster health
+     */
+    clusters: {
+        [x: string]: ComponentHealth;
+    };
+};
+export type HealthCheckResult = {
+    /**
+     * - Overall health status
+     */
+    status: HealthStatus;
+    /**
+     * - ISO timestamp of the check
+     */
+    timestamp: string;
+    /**
+     * - Whether this result is from cache
+     */
+    cached: boolean;
+    /**
+     * - Individual component health
+     */
+    components: {
+        [x: string]: ComponentHealth | DatabaseClusterHealth;
+    };
+};
+export type CachedHealthResult = {
+    /**
+     * - The cached health check result
+     */
+    result: HealthCheckResult;
+    /**
+     * - Unix timestamp when cached
+     */
+    timestamp: number;
+};
+export type DatabaseConfig = {
+    /**
+     * - Database/cluster name
+     */
+    name: string;
+    /**
+     * - Connection URL
+     */
+    url: string;
+};
+/**
+ * @typedef {'healthy' | 'unhealthy' | 'degraded'} HealthStatus
+ */
+/**
+ * @typedef {Object} ComponentHealth
+ * @property {HealthStatus} status - Component health status
+ * @property {string} [message] - Optional status message
+ * @property {number} [latencyMs] - Connection latency in milliseconds
+ */
+/**
+ * @typedef {Object} DatabaseClusterHealth
+ * @property {HealthStatus} status - Overall databases status
+ * @property {Object<string, ComponentHealth>} clusters - Individual cluster health
+ */
+/**
+ * @typedef {Object} HealthCheckResult
+ * @property {HealthStatus} status - Overall health status
+ * @property {string} timestamp - ISO timestamp of the check
+ * @property {boolean} cached - Whether this result is from cache
+ * @property {Object<string, ComponentHealth | DatabaseClusterHealth>} components - Individual component health
+ */
+/**
+ * @typedef {Object} CachedHealthResult
+ * @property {HealthCheckResult} result - The cached health check result
+ * @property {number} timestamp - Unix timestamp when cached
+ */
+/**
+ * @typedef {Object} DatabaseConfig
+ * @property {string} name - Database/cluster name
+ * @property {string} url - Connection URL
+ */
+/**
+ * HealthCheckClient provides a health check middleware for external monitoring services
+ * like BetterStack. It validates database and Redis connections with rate limiting
+ * to prevent excessive load on backend services.
+ *
+ * Features:
+ * - Multi-cluster DB validation (PostgreSQL)
+ * - Redis connection validation (supports ioredis, node-redis v3/v4)
+ * - Result caching (default: 60 seconds) to prevent overloading services
+ * - Express middleware support
+ * - BetterStack-compatible JSON response format
+ */
+export class HealthCheckClient {
+    /**
+     * @param {Object} options
+     * @param {string} [options.databaseUrl] - Main PostgreSQL connection URL
+     * @param {string} [options.databaseName='main'] - Name for the main database
+     * @param {Object<string, string>} [options.additionalDatabaseUrls] - Additional DB clusters (name -> URL)
+     * @param {any} [options.redisClient] - Redis client instance (ioredis or node-redis)
+     * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds (default: 60s)
+     * @param {string} [options.appName] - Application name for logging
+     */
+    constructor(options?: {
+        databaseUrl?: string | undefined;
+        databaseName?: string | undefined;
+        additionalDatabaseUrls?: {
+            [x: string]: string;
+        } | undefined;
+        redisClient?: any;
+        cacheTtlMs?: number | undefined;
+        appName?: string | undefined;
+    });
+    redisClient: any;
+    cacheTtlMs: number;
+    appName: string;
+    prefixLogs: string;
+    /** @type {CachedHealthResult | null} */
+    _cachedResult: CachedHealthResult | null;
+    /** @type {Map<string, Pool>} */
+    _databasePools: Map<string, Pool>;
+    /** @type {DatabaseConfig[]} */
+    _databaseConfigs: DatabaseConfig[];
+    _redisClientType: string | undefined;
+    /**
+     * Initialize database configurations from options.
+     * @param {Object} options - Constructor options
+     * @private
+     */
+    private _initDatabases;
+    /**
+     * Get or create a database pool for a given config.
+     * @param {DatabaseConfig} config - Database configuration
+     * @returns {Pool}
+     * @private
+     */
+    private _getPool;
+    /**
+     * Checks if cached result is still valid based on TTL.
+     * @returns {boolean}
+     * @private
+     */
+    private _isCacheValid;
+    /**
+     * Tests a single database cluster connectivity.
+     * @param {DatabaseConfig} config - Database configuration
+     * @returns {Promise<ComponentHealth>}
+     * @private
+     */
+    private _checkSingleDatabase;
+    /**
+     * Tests all PostgreSQL database clusters in parallel.
+     * @returns {Promise<DatabaseClusterHealth | null>}
+     * @private
+     */
+    private _checkAllDatabases;
+    /**
+     * Tests Redis connectivity using PING command.
+     * @returns {Promise<ComponentHealth>}
+     * @private
+     */
+    private _checkRedis;
+    /**
+     * Performs a full health check on all configured components.
+     * Results are cached for the configured TTL to prevent excessive load.
+     *
+     * @returns {Promise<HealthCheckResult>}
+     */
+    performHealthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Clears the cached health check result, forcing the next check to be fresh.
+     */
+    clearCache(): void;
+    /**
+     * Express middleware handler for health check endpoint.
+     * Returns 200 for healthy/degraded, 503 for unhealthy.
+     *
+     * @returns {(req: any, res: any) => Promise<void>} Express request handler
+     */
+    healthHandler(): (req: any, res: any) => Promise<void>;
+    /**
+     * Register health check endpoint on an Express app.
+     *
+     * @param {import('express').Application} app - Express application
+     * @param {string} [path='/health'] - Path for the health endpoint
+     */
+    registerHealthEndpoint(app: any, path?: string | undefined): void;
+    /**
+     * Cleanup resources (database pools).
+     * @returns {Promise<void>}
+     */
+    cleanup(): Promise<void>;
+}
+import { Pool } from "pg";
+//# sourceMappingURL=healthCheckClient.d.ts.map

package/lib/healthCheckClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckClient.d.ts","sourceRoot":"","sources":["../src/healthCheckClient.js"],"names":[],"mappings":"2BAWa,SAAS,GAAG,WAAW,GAAG,UAAU;;;;;YAKnC,YAAY;;;;;;;;;;;;;;YAOZ,YAAY;;;;;YACL,MAAM,GAAE,eAAe;;;;;;;YAK9B,YAAY;;;;eACZ,MAAM;;;;YACN,OAAO;;;;;YACA,MAAM,GAAE,eAAe,GAAG,qBAAqB;;;;;;;YAKtD,iBAAiB;;;;eACjB,MAAM;;;;;;UAKN,MAAM;;;;SACN,MAAM;;AAlCpB;;GAEG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH;IACE;;;;;;;;OAQG;IACH;QAP4B,WAAW;QACX,YAAY;QACI,sBAAsB;;;QACzC,WAAW,GAAzB,GAAG;QACc,UAAU;QACV,OAAO;OAwBlC;IArBC,iBAA8C;IAC9C,mBAAiE;IACjE,gBACgE;IAEhE,mBAAmD;IAEnD,wCAAwC;IACxC,eADW,kBAAkB,GAAG,IAAI,CACX;IAEzB,gCAAgC;IAChC,gBADW,IAAI,MAAM,EAAE,IAAI,CAAC,CACG;IAE/B,+BAA+B;IAC/B,kBADW,cAAc,EAAE,CACD;IAKxB,qCAA4D;IAIhE;;;;OAIG;IACH,uBAcC;IAED;;;;;OAKG;IACH,iBAaC;IAED;;;;OAIG;IACH,sBAGC;IAED;;;;;OAKG;IACH,6BAiBC;IAED;;;;OAIG;IACH,2BA0BC;IAED;;;;OAIG;IACH,oBA6CC;IAED;;;;;OAKG;IACH,sBAFa,QAAQ,iBAAiB,CAAC,CAuCtC;IAED;;OAEG;IACH,mBAEC;IAED;;;;;OAKG;IACH,uBAFmB,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAmBjD;IAED;;;;;OAKG;IACH,kEAGC;IAED;;;OAGG;IACH,WAFa,QAAQ,IAAI,CAAC,CAWzB;CACF"}

package/lib/healthCheckClient.js

@@ -0,0 +1,351 @@
+"use strict";
+
+const {
+  Pool
+} = require('pg');
+const {
+  getRedisClientType,
+  REDIS_V4,
+  IOREDIS,
+  REDIS_V3
+} = require('./redisUtils');
+const HEALTH_CHECK_CACHE_TTL_MS = 60 * 1000;
+
+/**
+ * @typedef {'healthy' | 'unhealthy' | 'degraded'} HealthStatus
+ */
+
+/**
+ * @typedef {Object} ComponentHealth
+ * @property {HealthStatus} status - Component health status
+ * @property {string} [message] - Optional status message
+ * @property {number} [latencyMs] - Connection latency in milliseconds
+ */
+
+/**
+ * @typedef {Object} DatabaseClusterHealth
+ * @property {HealthStatus} status - Overall databases status
+ * @property {Object<string, ComponentHealth>} clusters - Individual cluster health
+ */
+
+/**
+ * @typedef {Object} HealthCheckResult
+ * @property {HealthStatus} status - Overall health status
+ * @property {string} timestamp - ISO timestamp of the check
+ * @property {boolean} cached - Whether this result is from cache
+ * @property {Object<string, ComponentHealth | DatabaseClusterHealth>} components - Individual component health
+ */
+
+/**
+ * @typedef {Object} CachedHealthResult
+ * @property {HealthCheckResult} result - The cached health check result
+ * @property {number} timestamp - Unix timestamp when cached
+ */
+
+/**
+ * @typedef {Object} DatabaseConfig
+ * @property {string} name - Database/cluster name
+ * @property {string} url - Connection URL
+ */
+
+/**
+ * HealthCheckClient provides a health check middleware for external monitoring services
+ * like BetterStack. It validates database and Redis connections with rate limiting
+ * to prevent excessive load on backend services.
+ *
+ * Features:
+ * - Multi-cluster DB validation (PostgreSQL)
+ * - Redis connection validation (supports ioredis, node-redis v3/v4)
+ * - Result caching (default: 60 seconds) to prevent overloading services
+ * - Express middleware support
+ * - BetterStack-compatible JSON response format
+ */
+class HealthCheckClient {
+  /**
+   * @param {Object} options
+   * @param {string} [options.databaseUrl] - Main PostgreSQL connection URL
+   * @param {string} [options.databaseName='main'] - Name for the main database
+   * @param {Object<string, string>} [options.additionalDatabaseUrls] - Additional DB clusters (name -> URL)
+   * @param {any} [options.redisClient] - Redis client instance (ioredis or node-redis)
+   * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds (default: 60s)
+   * @param {string} [options.appName] - Application name for logging
+   */
+  constructor(options = {}) {
+    this.redisClient = options.redisClient || null;
+    this.cacheTtlMs = options.cacheTtlMs ?? HEALTH_CHECK_CACHE_TTL_MS;
+    this.appName = options.appName || process.env.BUILD_APP_NAME || 'unknown-app';
+    this.prefixLogs = `[${this.appName}] [HealthCheck]`;
+
+    /** @type {CachedHealthResult | null} */
+    this._cachedResult = null;
+
+    /** @type {Map<string, Pool>} */
+    this._databasePools = new Map();
+
+    /** @type {DatabaseConfig[]} */
+    this._databaseConfigs = [];
+    this._initDatabases(options);
+    if (this.redisClient) {
+      this._redisClientType = getRedisClientType(this.redisClient);
+    }
+  }
+
+  /**
+   * Initialize database configurations from options.
+   * @param {Object} options - Constructor options
+   * @private
+   */
+  _initDatabases(options) {
+    const mainUrl = options.databaseUrl || process.env.DATABASE_URL || '';
+    const mainName = options.databaseName || 'main';
+    if (mainUrl) {
+      this._databaseConfigs.push({
+        name: mainName,
+        url: mainUrl
+      });
+    }
+    const additionalUrls = options.additionalDatabaseUrls || {};
+    for (const [name, url] of Object.entries(additionalUrls)) {
+      if (url) {
+        this._databaseConfigs.push({
+          name,
+          url
+        });
+      }
+    }
+  }
+
+  /**
+   * Get or create a database pool for a given config.
+   * @param {DatabaseConfig} config - Database configuration
+   * @returns {Pool}
+   * @private
+   */
+  _getPool(config) {
+    if (!this._databasePools.has(config.name)) {
+      this._databasePools.set(config.name, new Pool({
+        connectionString: config.url,
+        max: 1,
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 5000
+      }));
+    }
+    return this._databasePools.get(config.name);
+  }
+
+  /**
+   * Checks if cached result is still valid based on TTL.
+   * @returns {boolean}
+   * @private
+   */
+  _isCacheValid() {
+    if (!this._cachedResult) return false;
+    return Date.now() - this._cachedResult.timestamp < this.cacheTtlMs;
+  }
+
+  /**
+   * Tests a single database cluster connectivity.
+   * @param {DatabaseConfig} config - Database configuration
+   * @returns {Promise<ComponentHealth>}
+   * @private
+   */
+  async _checkSingleDatabase(config) {
+    const start = Date.now();
+    try {
+      const pool = this._getPool(config);
+      await pool.query('SELECT 1');
+      return {
+        status: 'healthy',
+        latencyMs: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        status: 'unhealthy',
+        message: err.message,
+        latencyMs: Date.now() - start
+      };
+    }
+  }
+
+  /**
+   * Tests all PostgreSQL database clusters in parallel.
+   * @returns {Promise<DatabaseClusterHealth | null>}
+   * @private
+   */
+  async _checkAllDatabases() {
+    if (this._databaseConfigs.length === 0) {
+      return null;
+    }
+    const results = await Promise.all(this._databaseConfigs.map(async config => ({
+      name: config.name,
+      health: await this._checkSingleDatabase(config)
+    })));
+    const clusters = {};
+    for (const {
+      name,
+      health
+    } of results) {
+      clusters[name] = health;
+    }
+    const statuses = Object.values(clusters).map(c => c.status);
+    let overallStatus = 'healthy';
+    if (statuses.some(s => s === 'unhealthy')) {
+      overallStatus = 'unhealthy';
+    } else if (statuses.some(s => s === 'degraded')) {
+      overallStatus = 'degraded';
+    }
+    return {
+      status: overallStatus,
+      clusters
+    };
+  }
+
+  /**
+   * Tests Redis connectivity using PING command.
+   * @returns {Promise<ComponentHealth>}
+   * @private
+   */
+  async _checkRedis() {
+    if (!this.redisClient) {
+      return {
+        status: 'healthy',
+        message: 'Not configured'
+      };
+    }
+    const start = Date.now();
+    try {
+      let pong;
+      if (this._redisClientType === REDIS_V3) {
+        pong = await new Promise((resolve, reject) => {
+          this.redisClient.ping((err, result) => {
+            if (err) reject(err);else resolve(result);
+          });
+        });
+      } else if (this._redisClientType === REDIS_V4 || this._redisClientType === IOREDIS) {
+        pong = await this.redisClient.ping();
+      } else {
+        return {
+          status: 'unhealthy',
+          message: 'Unknown Redis client type'
+        };
+      }
+      if (pong === 'PONG') {
+        return {
+          status: 'healthy',
+          latencyMs: Date.now() - start
+        };
+      }
+      return {
+        status: 'unhealthy',
+        message: `Unexpected PING response: ${pong}`,
+        latencyMs: Date.now() - start
+      };
+    } catch (err) {
+      return {
+        status: 'unhealthy',
+        message: err.message,
+        latencyMs: Date.now() - start
+      };
+    }
+  }
+
+  /**
+   * Performs a full health check on all configured components.
+   * Results are cached for the configured TTL to prevent excessive load.
+   *
+   * @returns {Promise<HealthCheckResult>}
+   */
+  async performHealthCheck() {
+    if (this._isCacheValid()) {
+      return {
+        ...this._cachedResult.result,
+        cached: true
+      };
+    }
+    const [dbHealth, redisHealth] = await Promise.all([this._checkAllDatabases(), this._checkRedis()]);
+    const components = {};
+    if (dbHealth) components.database = dbHealth;
+    if (this.redisClient) components.redis = redisHealth;
+    const statuses = Object.values(components).map(c => c.status);
+    let overallStatus = 'healthy';
+    if (statuses.some(s => s === 'unhealthy')) {
+      overallStatus = 'unhealthy';
+    } else if (statuses.some(s => s === 'degraded')) {
+      overallStatus = 'degraded';
+    }
+
+    /** @type {HealthCheckResult} */
+    const result = {
+      status: overallStatus,
+      timestamp: new Date().toISOString(),
+      cached: false,
+      components
+    };
+    this._cachedResult = {
+      result,
+      timestamp: Date.now()
+    };
+    return result;
+  }
+
+  /**
+   * Clears the cached health check result, forcing the next check to be fresh.
+   */
+  clearCache() {
+    this._cachedResult = null;
+  }
+
+  /**
+   * Express middleware handler for health check endpoint.
+   * Returns 200 for healthy/degraded, 503 for unhealthy.
+   *
+   * @returns {(req: any, res: any) => Promise<void>} Express request handler
+   */
+  healthHandler() {
+    return async (req, res) => {
+      try {
+        const result = await this.performHealthCheck();
+        const statusCode = result.status === 'unhealthy' ? 503 : 200;
+        res.status(statusCode).json(result);
+      } catch (err) {
+        console.error(`${this.prefixLogs} Health check failed:`, err);
+        res.status(503).json({
+          status: 'unhealthy',
+          timestamp: new Date().toISOString(),
+          cached: false,
+          error: err.message
+        });
+      }
+    };
+  }
+
+  /**
+   * Register health check endpoint on an Express app.
+   *
+   * @param {import('express').Application} app - Express application
+   * @param {string} [path='/health'] - Path for the health endpoint
+   */
+  registerHealthEndpoint(app, path = '/health') {
+    app.get(path, this.healthHandler());
+    console.info(`${this.prefixLogs} Registered health endpoint at ${path}`);
+  }
+
+  /**
+   * Cleanup resources (database pools).
+   * @returns {Promise<void>}
+   */
+  async cleanup() {
+    for (const [name, pool] of this._databasePools) {
+      try {
+        await pool.end();
+      } catch (err) {
+        console.error(`${this.prefixLogs} Error closing database pool ${name}:`, err);
+      }
+    }
+    this._databasePools.clear();
+  }
+}
+module.exports = {
+  HealthCheckClient
+};
+//# sourceMappingURL=healthCheckClient.js.map

package/lib/healthCheckClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckClient.js","names":["Pool","require","getRedisClientType","REDIS_V4","IOREDIS","REDIS_V3","HEALTH_CHECK_CACHE_TTL_MS","HealthCheckClient","constructor","options","redisClient","cacheTtlMs","appName","process","env","BUILD_APP_NAME","prefixLogs","_cachedResult","_databasePools","Map","_databaseConfigs","_initDatabases","_redisClientType","mainUrl","databaseUrl","DATABASE_URL","mainName","databaseName","push","name","url","additionalUrls","additionalDatabaseUrls","Object","entries","_getPool","config","has","set","connectionString","max","idleTimeoutMillis","connectionTimeoutMillis","get","_isCacheValid","Date","now","timestamp","_checkSingleDatabase","start","pool","query","status","latencyMs","err","message","_checkAllDatabases","length","results","Promise","all","map","health","clusters","statuses","values","c","overallStatus","some","s","_checkRedis","pong","resolve","reject","ping","result","performHealthCheck","cached","dbHealth","redisHealth","components","database","redis","toISOString","clearCache","healthHandler","req","res","statusCode","json","console","error","registerHealthEndpoint","app","path","info","cleanup","end","clear","module","exports"],"sources":["../src/healthCheckClient.js"],"sourcesContent":["const { Pool } = require('pg')\nconst {\n  getRedisClientType,\n  REDIS_V4,\n  IOREDIS,\n  REDIS_V3,\n} = require('./redisUtils')\n\nconst HEALTH_CHECK_CACHE_TTL_MS = 60 * 1000\n\n/**\n * @typedef {'healthy' | 'unhealthy' | 'degraded'} HealthStatus\n */\n\n/**\n * @typedef {Object} ComponentHealth\n * @property {HealthStatus} status - Component health status\n * @property {string} [message] - Optional status message\n * @property {number} [latencyMs] - Connection latency in milliseconds\n */\n\n/**\n * @typedef {Object} DatabaseClusterHealth\n * @property {HealthStatus} status - Overall databases status\n * @property {Object<string, ComponentHealth>} clusters - Individual cluster health\n */\n\n/**\n * @typedef {Object} HealthCheckResult\n * @property {HealthStatus} status - Overall health status\n * @property {string} timestamp - ISO timestamp of the check\n * @property {boolean} cached - Whether this result is from cache\n * @property {Object<string, ComponentHealth | DatabaseClusterHealth>} components - Individual component health\n */\n\n/**\n * @typedef {Object} CachedHealthResult\n * @property {HealthCheckResult} result - The cached health check result\n * @property {number} timestamp - Unix timestamp when cached\n */\n\n/**\n * @typedef {Object} DatabaseConfig\n * @property {string} name - Database/cluster name\n * @property {string} url - Connection URL\n */\n\n/**\n * HealthCheckClient provides a health check middleware for external monitoring services\n * like BetterStack. It validates database and Redis connections with rate limiting\n * to prevent excessive load on backend services.\n *\n * Features:\n * - Multi-cluster DB validation (PostgreSQL)\n * - Redis connection validation (supports ioredis, node-redis v3/v4)\n * - Result caching (default: 60 seconds) to prevent overloading services\n * - Express middleware support\n * - BetterStack-compatible JSON response format\n */\nclass HealthCheckClient {\n  /**\n   * @param {Object} options\n   * @param {string} [options.databaseUrl] - Main PostgreSQL connection URL\n   * @param {string} [options.databaseName='main'] - Name for the main database\n   * @param {Object<string, string>} [options.additionalDatabaseUrls] - Additional DB clusters (name -> URL)\n   * @param {any} [options.redisClient] - Redis client instance (ioredis or node-redis)\n   * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds (default: 60s)\n   * @param {string} [options.appName] - Application name for logging\n   */\n  constructor(options = {}) {\n    this.redisClient = options.redisClient || null\n    this.cacheTtlMs = options.cacheTtlMs ?? HEALTH_CHECK_CACHE_TTL_MS\n    this.appName =\n      options.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n\n    this.prefixLogs = `[${this.appName}] [HealthCheck]`\n\n    /** @type {CachedHealthResult | null} */\n    this._cachedResult = null\n\n    /** @type {Map<string, Pool>} */\n    this._databasePools = new Map()\n\n    /** @type {DatabaseConfig[]} */\n    this._databaseConfigs = []\n\n    this._initDatabases(options)\n\n    if (this.redisClient) {\n      this._redisClientType = getRedisClientType(this.redisClient)\n    }\n  }\n\n  /**\n   * Initialize database configurations from options.\n   * @param {Object} options - Constructor options\n   * @private\n   */\n  _initDatabases(options) {\n    const mainUrl = options.databaseUrl || process.env.DATABASE_URL || ''\n    const mainName = options.databaseName || 'main'\n\n    if (mainUrl) {\n      this._databaseConfigs.push({ name: mainName, url: mainUrl })\n    }\n\n    const additionalUrls = options.additionalDatabaseUrls || {}\n    for (const [name, url] of Object.entries(additionalUrls)) {\n      if (url) {\n        this._databaseConfigs.push({ name, url })\n      }\n    }\n  }\n\n  /**\n   * Get or create a database pool for a given config.\n   * @param {DatabaseConfig} config - Database configuration\n   * @returns {Pool}\n   * @private\n   */\n  _getPool(config) {\n    if (!this._databasePools.has(config.name)) {\n      this._databasePools.set(\n        config.name,\n        new Pool({\n          connectionString: config.url,\n          max: 1,\n          idleTimeoutMillis: 30000,\n          connectionTimeoutMillis: 5000,\n        })\n      )\n    }\n    return this._databasePools.get(config.name)\n  }\n\n  /**\n   * Checks if cached result is still valid based on TTL.\n   * @returns {boolean}\n   * @private\n   */\n  _isCacheValid() {\n    if (!this._cachedResult) return false\n    return Date.now() - this._cachedResult.timestamp < this.cacheTtlMs\n  }\n\n  /**\n   * Tests a single database cluster connectivity.\n   * @param {DatabaseConfig} config - Database configuration\n   * @returns {Promise<ComponentHealth>}\n   * @private\n   */\n  async _checkSingleDatabase(config) {\n    const start = Date.now()\n\n    try {\n      const pool = this._getPool(config)\n      await pool.query('SELECT 1')\n      return {\n        status: 'healthy',\n        latencyMs: Date.now() - start,\n      }\n    } catch (err) {\n      return {\n        status: 'unhealthy',\n        message: err.message,\n        latencyMs: Date.now() - start,\n      }\n    }\n  }\n\n  /**\n   * Tests all PostgreSQL database clusters in parallel.\n   * @returns {Promise<DatabaseClusterHealth | null>}\n   * @private\n   */\n  async _checkAllDatabases() {\n    if (this._databaseConfigs.length === 0) {\n      return null\n    }\n\n    const results = await Promise.all(\n      this._databaseConfigs.map(async config => ({\n        name: config.name,\n        health: await this._checkSingleDatabase(config),\n      }))\n    )\n\n    const clusters = {}\n    for (const { name, health } of results) {\n      clusters[name] = health\n    }\n\n    const statuses = Object.values(clusters).map(c => c.status)\n    let overallStatus = 'healthy'\n    if (statuses.some(s => s === 'unhealthy')) {\n      overallStatus = 'unhealthy'\n    } else if (statuses.some(s => s === 'degraded')) {\n      overallStatus = 'degraded'\n    }\n\n    return { status: overallStatus, clusters }\n  }\n\n  /**\n   * Tests Redis connectivity using PING command.\n   * @returns {Promise<ComponentHealth>}\n   * @private\n   */\n  async _checkRedis() {\n    if (!this.redisClient) {\n      return { status: 'healthy', message: 'Not configured' }\n    }\n\n    const start = Date.now()\n\n    try {\n      let pong\n\n      if (this._redisClientType === REDIS_V3) {\n        pong = await new Promise((resolve, reject) => {\n          this.redisClient.ping((err, result) => {\n            if (err) reject(err)\n            else resolve(result)\n          })\n        })\n      } else if (\n        this._redisClientType === REDIS_V4 ||\n        this._redisClientType === IOREDIS\n      ) {\n        pong = await this.redisClient.ping()\n      } else {\n        return { status: 'unhealthy', message: 'Unknown Redis client type' }\n      }\n\n      if (pong === 'PONG') {\n        return {\n          status: 'healthy',\n          latencyMs: Date.now() - start,\n        }\n      }\n\n      return {\n        status: 'unhealthy',\n        message: `Unexpected PING response: ${pong}`,\n        latencyMs: Date.now() - start,\n      }\n    } catch (err) {\n      return {\n        status: 'unhealthy',\n        message: err.message,\n        latencyMs: Date.now() - start,\n      }\n    }\n  }\n\n  /**\n   * Performs a full health check on all configured components.\n   * Results are cached for the configured TTL to prevent excessive load.\n   *\n   * @returns {Promise<HealthCheckResult>}\n   */\n  async performHealthCheck() {\n    if (this._isCacheValid()) {\n      return { ...this._cachedResult.result, cached: true }\n    }\n\n    const [dbHealth, redisHealth] = await Promise.all([\n      this._checkAllDatabases(),\n      this._checkRedis(),\n    ])\n\n    const components = {}\n    if (dbHealth) components.database = dbHealth\n    if (this.redisClient) components.redis = redisHealth\n\n    const statuses = Object.values(components).map(c => c.status)\n    let overallStatus = 'healthy'\n\n    if (statuses.some(s => s === 'unhealthy')) {\n      overallStatus = 'unhealthy'\n    } else if (statuses.some(s => s === 'degraded')) {\n      overallStatus = 'degraded'\n    }\n\n    /** @type {HealthCheckResult} */\n    const result = {\n      status: overallStatus,\n      timestamp: new Date().toISOString(),\n      cached: false,\n      components,\n    }\n\n    this._cachedResult = {\n      result,\n      timestamp: Date.now(),\n    }\n\n    return result\n  }\n\n  /**\n   * Clears the cached health check result, forcing the next check to be fresh.\n   */\n  clearCache() {\n    this._cachedResult = null\n  }\n\n  /**\n   * Express middleware handler for health check endpoint.\n   * Returns 200 for healthy/degraded, 503 for unhealthy.\n   *\n   * @returns {(req: any, res: any) => Promise<void>} Express request handler\n   */\n  healthHandler() {\n    return async (req, res) => {\n      try {\n        const result = await this.performHealthCheck()\n        const statusCode = result.status === 'unhealthy' ? 503 : 200\n\n        res.status(statusCode).json(result)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Health check failed:`, err)\n        res.status(503).json({\n          status: 'unhealthy',\n          timestamp: new Date().toISOString(),\n          cached: false,\n          error: err.message,\n        })\n      }\n    }\n  }\n\n  /**\n   * Register health check endpoint on an Express app.\n   *\n   * @param {import('express').Application} app - Express application\n   * @param {string} [path='/health'] - Path for the health endpoint\n   */\n  registerHealthEndpoint(app, path = '/health') {\n    app.get(path, this.healthHandler())\n    console.info(`${this.prefixLogs} Registered health endpoint at ${path}`)\n  }\n\n  /**\n   * Cleanup resources (database pools).\n   * @returns {Promise<void>}\n   */\n  async cleanup() {\n    for (const [name, pool] of this._databasePools) {\n      try {\n        await pool.end()\n      } catch (err) {\n        console.error(`${this.prefixLogs} Error closing database pool ${name}:`, err)\n      }\n    }\n    this._databasePools.clear()\n  }\n}\n\nmodule.exports = { HealthCheckClient }\n"],"mappings":"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","ignoreList":[]}

package/lib/index.d.ts

@@ -3,5 +3,6 @@ export * from './metricsClient';
 export * from './metricsRedisClient';
 export * from './metricsQueueRedisClient';
 export * from './metricsDatabaseClient';
+export * from './healthCheckClient';
 export * from './redisUtils';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA"}

package/lib/index.js

@@ -58,6 +58,17 @@ Object.keys(_metricsDatabaseClient).forEach(function (key) {
     }
   });
 });
+var _healthCheckClient = require("./healthCheckClient");
+Object.keys(_healthCheckClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _healthCheckClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _healthCheckClient[key];
+    }
+  });
+});
 var _redisUtils = require("./redisUtils");
 Object.keys(_redisUtils).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_baseMetricsClient","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_metricsClient","_metricsRedisClient","_metricsQueueRedisClient","_metricsDatabaseClient","_redisUtils"],"sources":["../src/index.ts"],"sourcesContent":["export * from './baseMetricsClient'\nexport * from './metricsClient'\nexport * from './metricsRedisClient'\nexport * from './metricsQueueRedisClient'\nexport * from './metricsDatabaseClient'\nexport * from './redisUtils'\n"],"mappings":";;;;;AAAA,IAAAA,kBAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,kBAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,kBAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,kBAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,cAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,cAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,cAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,cAAA,CAAAL,GAAA;IAAA;EAAA;AAAA;AACA,IAAAM,mBAAA,GAAAV,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAQ,mBAAA,EAAAP,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAM,mBAAA,CAAAN,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAE,mBAAA,CAAAN,GAAA;IAAA;EAAA;AAAA;AACA,IAAAO,wBAAA,GAAAX,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAS,wBAAA,EAAAR,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAO,wBAAA,CAAAP,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAG,wBAAA,CAAAP,GAAA;IAAA;EAAA;AAAA;AACA,IAAAQ,sBAAA,GAAAZ,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAU,sBAAA,EAAAT,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAQ,sBAAA,CAAAR,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAI,sBAAA,CAAAR,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,WAAA,GAAAb,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAW,WAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAS,WAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAK,WAAA,CAAAT,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_baseMetricsClient","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_metricsClient","_metricsRedisClient","_metricsQueueRedisClient","_metricsDatabaseClient","_healthCheckClient","_redisUtils"],"sources":["../src/index.ts"],"sourcesContent":["export * from './baseMetricsClient'\nexport * from './metricsClient'\nexport * from './metricsRedisClient'\nexport * from './metricsQueueRedisClient'\nexport * from './metricsDatabaseClient'\nexport * from './healthCheckClient'\nexport * from './redisUtils'\n"],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adalo/metrics",
-  "version": "0.1.119",
+  "version": "0.1.120",
   "description": "Reusable metrics utilities for Node.js and Laravel apps",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/healthCheckClient.js

@@ -0,0 +1,360 @@
+const { Pool } = require('pg')
+const {
+  getRedisClientType,
+  REDIS_V4,
+  IOREDIS,
+  REDIS_V3,
+} = require('./redisUtils')
+
+const HEALTH_CHECK_CACHE_TTL_MS = 60 * 1000
+
+/**
+ * @typedef {'healthy' | 'unhealthy' | 'degraded'} HealthStatus
+ */
+
+/**
+ * @typedef {Object} ComponentHealth
+ * @property {HealthStatus} status - Component health status
+ * @property {string} [message] - Optional status message
+ * @property {number} [latencyMs] - Connection latency in milliseconds
+ */
+
+/**
+ * @typedef {Object} DatabaseClusterHealth
+ * @property {HealthStatus} status - Overall databases status
+ * @property {Object<string, ComponentHealth>} clusters - Individual cluster health
+ */
+
+/**
+ * @typedef {Object} HealthCheckResult
+ * @property {HealthStatus} status - Overall health status
+ * @property {string} timestamp - ISO timestamp of the check
+ * @property {boolean} cached - Whether this result is from cache
+ * @property {Object<string, ComponentHealth | DatabaseClusterHealth>} components - Individual component health
+ */
+
+/**
+ * @typedef {Object} CachedHealthResult
+ * @property {HealthCheckResult} result - The cached health check result
+ * @property {number} timestamp - Unix timestamp when cached
+ */
+
+/**
+ * @typedef {Object} DatabaseConfig
+ * @property {string} name - Database/cluster name
+ * @property {string} url - Connection URL
+ */
+
+/**
+ * HealthCheckClient provides a health check middleware for external monitoring services
+ * like BetterStack. It validates database and Redis connections with rate limiting
+ * to prevent excessive load on backend services.
+ *
+ * Features:
+ * - Multi-cluster DB validation (PostgreSQL)
+ * - Redis connection validation (supports ioredis, node-redis v3/v4)
+ * - Result caching (default: 60 seconds) to prevent overloading services
+ * - Express middleware support
+ * - BetterStack-compatible JSON response format
+ */
+class HealthCheckClient {
+  /**
+   * @param {Object} options
+   * @param {string} [options.databaseUrl] - Main PostgreSQL connection URL
+   * @param {string} [options.databaseName='main'] - Name for the main database
+   * @param {Object<string, string>} [options.additionalDatabaseUrls] - Additional DB clusters (name -> URL)
+   * @param {any} [options.redisClient] - Redis client instance (ioredis or node-redis)
+   * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds (default: 60s)
+   * @param {string} [options.appName] - Application name for logging
+   */
+  constructor(options = {}) {
+    this.redisClient = options.redisClient || null
+    this.cacheTtlMs = options.cacheTtlMs ?? HEALTH_CHECK_CACHE_TTL_MS
+    this.appName =
+      options.appName || process.env.BUILD_APP_NAME || 'unknown-app'
+
+    this.prefixLogs = `[${this.appName}] [HealthCheck]`
+
+    /** @type {CachedHealthResult | null} */
+    this._cachedResult = null
+
+    /** @type {Map<string, Pool>} */
+    this._databasePools = new Map()
+
+    /** @type {DatabaseConfig[]} */
+    this._databaseConfigs = []
+
+    this._initDatabases(options)
+
+    if (this.redisClient) {
+      this._redisClientType = getRedisClientType(this.redisClient)
+    }
+  }
+
+  /**
+   * Initialize database configurations from options.
+   * @param {Object} options - Constructor options
+   * @private
+   */
+  _initDatabases(options) {
+    const mainUrl = options.databaseUrl || process.env.DATABASE_URL || ''
+    const mainName = options.databaseName || 'main'
+
+    if (mainUrl) {
+      this._databaseConfigs.push({ name: mainName, url: mainUrl })
+    }
+
+    const additionalUrls = options.additionalDatabaseUrls || {}
+    for (const [name, url] of Object.entries(additionalUrls)) {
+      if (url) {
+        this._databaseConfigs.push({ name, url })
+      }
+    }
+  }
+
+  /**
+   * Get or create a database pool for a given config.
+   * @param {DatabaseConfig} config - Database configuration
+   * @returns {Pool}
+   * @private
+   */
+  _getPool(config) {
+    if (!this._databasePools.has(config.name)) {
+      this._databasePools.set(
+        config.name,
+        new Pool({
+          connectionString: config.url,
+          max: 1,
+          idleTimeoutMillis: 30000,
+          connectionTimeoutMillis: 5000,
+        })
+      )
+    }
+    return this._databasePools.get(config.name)
+  }
+
+  /**
+   * Checks if cached result is still valid based on TTL.
+   * @returns {boolean}
+   * @private
+   */
+  _isCacheValid() {
+    if (!this._cachedResult) return false
+    return Date.now() - this._cachedResult.timestamp < this.cacheTtlMs
+  }
+
+  /**
+   * Tests a single database cluster connectivity.
+   * @param {DatabaseConfig} config - Database configuration
+   * @returns {Promise<ComponentHealth>}
+   * @private
+   */
+  async _checkSingleDatabase(config) {
+    const start = Date.now()
+
+    try {
+      const pool = this._getPool(config)
+      await pool.query('SELECT 1')
+      return {
+        status: 'healthy',
+        latencyMs: Date.now() - start,
+      }
+    } catch (err) {
+      return {
+        status: 'unhealthy',
+        message: err.message,
+        latencyMs: Date.now() - start,
+      }
+    }
+  }
+
+  /**
+   * Tests all PostgreSQL database clusters in parallel.
+   * @returns {Promise<DatabaseClusterHealth | null>}
+   * @private
+   */
+  async _checkAllDatabases() {
+    if (this._databaseConfigs.length === 0) {
+      return null
+    }
+
+    const results = await Promise.all(
+      this._databaseConfigs.map(async config => ({
+        name: config.name,
+        health: await this._checkSingleDatabase(config),
+      }))
+    )
+
+    const clusters = {}
+    for (const { name, health } of results) {
+      clusters[name] = health
+    }
+
+    const statuses = Object.values(clusters).map(c => c.status)
+    let overallStatus = 'healthy'
+    if (statuses.some(s => s === 'unhealthy')) {
+      overallStatus = 'unhealthy'
+    } else if (statuses.some(s => s === 'degraded')) {
+      overallStatus = 'degraded'
+    }
+
+    return { status: overallStatus, clusters }
+  }
+
+  /**
+   * Tests Redis connectivity using PING command.
+   * @returns {Promise<ComponentHealth>}
+   * @private
+   */
+  async _checkRedis() {
+    if (!this.redisClient) {
+      return { status: 'healthy', message: 'Not configured' }
+    }
+
+    const start = Date.now()
+
+    try {
+      let pong
+
+      if (this._redisClientType === REDIS_V3) {
+        pong = await new Promise((resolve, reject) => {
+          this.redisClient.ping((err, result) => {
+            if (err) reject(err)
+            else resolve(result)
+          })
+        })
+      } else if (
+        this._redisClientType === REDIS_V4 ||
+        this._redisClientType === IOREDIS
+      ) {
+        pong = await this.redisClient.ping()
+      } else {
+        return { status: 'unhealthy', message: 'Unknown Redis client type' }
+      }
+
+      if (pong === 'PONG') {
+        return {
+          status: 'healthy',
+          latencyMs: Date.now() - start,
+        }
+      }
+
+      return {
+        status: 'unhealthy',
+        message: `Unexpected PING response: ${pong}`,
+        latencyMs: Date.now() - start,
+      }
+    } catch (err) {
+      return {
+        status: 'unhealthy',
+        message: err.message,
+        latencyMs: Date.now() - start,
+      }
+    }
+  }
+
+  /**
+   * Performs a full health check on all configured components.
+   * Results are cached for the configured TTL to prevent excessive load.
+   *
+   * @returns {Promise<HealthCheckResult>}
+   */
+  async performHealthCheck() {
+    if (this._isCacheValid()) {
+      return { ...this._cachedResult.result, cached: true }
+    }
+
+    const [dbHealth, redisHealth] = await Promise.all([
+      this._checkAllDatabases(),
+      this._checkRedis(),
+    ])
+
+    const components = {}
+    if (dbHealth) components.database = dbHealth
+    if (this.redisClient) components.redis = redisHealth
+
+    const statuses = Object.values(components).map(c => c.status)
+    let overallStatus = 'healthy'
+
+    if (statuses.some(s => s === 'unhealthy')) {
+      overallStatus = 'unhealthy'
+    } else if (statuses.some(s => s === 'degraded')) {
+      overallStatus = 'degraded'
+    }
+
+    /** @type {HealthCheckResult} */
+    const result = {
+      status: overallStatus,
+      timestamp: new Date().toISOString(),
+      cached: false,
+      components,
+    }
+
+    this._cachedResult = {
+      result,
+      timestamp: Date.now(),
+    }
+
+    return result
+  }
+
+  /**
+   * Clears the cached health check result, forcing the next check to be fresh.
+   */
+  clearCache() {
+    this._cachedResult = null
+  }
+
+  /**
+   * Express middleware handler for health check endpoint.
+   * Returns 200 for healthy/degraded, 503 for unhealthy.
+   *
+   * @returns {(req: any, res: any) => Promise<void>} Express request handler
+   */
+  healthHandler() {
+    return async (req, res) => {
+      try {
+        const result = await this.performHealthCheck()
+        const statusCode = result.status === 'unhealthy' ? 503 : 200
+
+        res.status(statusCode).json(result)
+      } catch (err) {
+        console.error(`${this.prefixLogs} Health check failed:`, err)
+        res.status(503).json({
+          status: 'unhealthy',
+          timestamp: new Date().toISOString(),
+          cached: false,
+          error: err.message,
+        })
+      }
+    }
+  }
+
+  /**
+   * Register health check endpoint on an Express app.
+   *
+   * @param {import('express').Application} app - Express application
+   * @param {string} [path='/health'] - Path for the health endpoint
+   */
+  registerHealthEndpoint(app, path = '/health') {
+    app.get(path, this.healthHandler())
+    console.info(`${this.prefixLogs} Registered health endpoint at ${path}`)
+  }
+
+  /**
+   * Cleanup resources (database pools).
+   * @returns {Promise<void>}
+   */
+  async cleanup() {
+    for (const [name, pool] of this._databasePools) {
+      try {
+        await pool.end()
+      } catch (err) {
+        console.error(`${this.prefixLogs} Error closing database pool ${name}:`, err)
+      }
+    }
+    this._databasePools.clear()
+  }
+}
+
+module.exports = { HealthCheckClient }

package/src/index.ts

@@ -3,4 +3,5 @@ export * from './metricsClient'
 export * from './metricsRedisClient'
 export * from './metricsQueueRedisClient'
 export * from './metricsDatabaseClient'
+export * from './healthCheckClient'
 export * from './redisUtils'