@adalo/metrics 0.1.118 → 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/baseMetricsClient.js

@@ -153,7 +153,8 @@ class BaseMetricsClient {
         }
       }
       await this.gatewayPush();
-      this.clearAllCounters();
+      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)
+
       if (this.logValues) {
         const metrics = await this._registry.getMetricsAsJSON();
         console.log(`${this.prefixLogs} Metrics:\n`, JSON.stringify(metrics, null, 2));

package/lib/baseMetricsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","prefixLogs","_registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","gateway","Pushgateway","headers","Authorization","agent","Agent","keepAlive","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","removeOldMetrics","_setCleanupHandlers","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","setInterval","pushMetrics","catch","startPush","cleanup","gatewayDelete","exit","url","res","fetch","Accept","ok","status","text","metricRegex","labelRegex","uniqueLabelSets","Set","match","exec","rawLabels","lr","labels","job","add","size","oldLabelSets","map","s","parse","filter","instance","length","jobName","groupings","params","delete","push","withDefaultLabels","getDefaultLabels","on","metricsEnabled","registry","module","exports"],"sources":["../src/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, pushgateway, default labels, and common operations.\n */\nclass BaseMetricsClient {\n  /**\n   * @param {Object} config\n   * @param {string} [config.appName] Name of the application\n   * @param {string} [config.dynoId] Dyno/instance ID\n   * @param {string} [config.processType] Process type (web, worker, etc.)\n   * @param {boolean} [config.enabled] Enable metrics collection\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] PushGateway URL\n   * @param {string} [config.pushgatewaySecret] PushGateway secret token\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   */\n  constructor(config = {}) {\n    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    client.collectDefaultMetrics({ register: this._registry })\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    this.gateway = new client.Pushgateway(\n      this.pushgatewayUrl,\n      {\n        headers: { Authorization: `Basic ${this.authToken}` },\n        agent: new https.Agent({ keepAlive: true }),\n      },\n      this._registry\n    )\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...this.defaultLabels, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            return\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      await this.gatewayPush()\n      this.clearAllCounters()\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      return\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      setInterval(() => customPushMetics(), interval * 1000)\n    } else {\n      setInterval(() => {\n        this.pushMetrics().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s)`\n    )\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and exit process.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    process.exit(0)\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    if (!removeOldMetrics) return\n\n    try {\n      const url = `${this.pushgatewayUrl}/metrics`\n      const res = await fetch(url, {\n        headers: {\n          Authorization: `Basic ${this.authToken}`,\n          Accept: 'text/plain',\n        },\n      })\n\n      if (!res.ok) {\n        console.error(\n          `${this.prefixLogs} Failed to fetch metrics: ${res.status}`\n        )\n        return\n      }\n\n      const text = await res.text()\n\n      const metricRegex = /([a-zA-Z_:][a-zA-Z0-9_:]*)\\{([^}]*)\\}/gm\n      const labelRegex = /(\\w+)=\"([^\"]*)\"/g\n\n      const uniqueLabelSets = new Set()\n\n      let match\n      // eslint-disable-next-line no-cond-assign\n      while ((match = metricRegex.exec(text)) !== null) {\n        const rawLabels = match[2]\n        let lr\n        const labels = {}\n\n        // eslint-disable-next-line no-cond-assign\n        while ((lr = labelRegex.exec(rawLabels)) !== null) {\n          // eslint-disable-next-line prefer-destructuring\n          labels[lr[1]] = lr[2]\n        }\n\n        if (\n          labels.job === this.appName &&\n          labels.process_type === this.processType\n        ) {\n          uniqueLabelSets.add(JSON.stringify(labels))\n        }\n      }\n\n      if (uniqueLabelSets.size === 0) {\n        console.log(\n          `${this.prefixLogs} No metrics found for job ${this.appName}`\n        )\n        return\n      }\n\n      const oldLabelSets = [...uniqueLabelSets]\n        .map(s => JSON.parse(s))\n        .filter(\n          labels =>\n            labels.instance &&\n            labels.instance !== this.dynoId &&\n            labels.process_type === this.processType\n        )\n\n      if (oldLabelSets.length === 0) {\n        console.log(`${this.prefixLogs} No old dynos to delete.`)\n        return\n      }\n\n      for (const labels of oldLabelSets) {\n        try {\n          await this.gatewayDelete({ jobName: this.appName, groupings: labels })\n          console.log(\n            `${this.prefixLogs} Deleted metrics for dyno: ${\n              labels.instance\n            }, labels: ${Object.keys(labels)} `\n          )\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to delete metrics for ${labels.instance}:`,\n            err\n          )\n        }\n      }\n\n      console.log(\n        `${this.prefixLogs} Cleared all old instances for job ${this.appName}`\n      )\n    } catch (err) {\n      console.error(`${this.prefixLogs} Error deleting old metrics:`, err)\n    }\n  }\n\n  /**\n   * Delete metrics for this job/instance from PushGateway.\n   *\n   * @param {Object} [params]\n   * @param {string} [params.jobName] Job name (defaults to appName)\n   * @param {Object} [params.groupings] Grouping labels\n   * @param {string} [params.groupings.process_type] Process type label\n   * @param {string} [params.groupings.instance] Instance/dyno ID\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async (params = {}) => {\n    return this.gateway.delete({\n      jobName: params.jobName || this.appName,\n      groupings: params.groupings || {\n        process_type: this.processType,\n        instance: this.dynoId,\n      },\n    })\n  }\n\n  /**\n   * Push metrics to PushGateway.\n   *\n   * @param {object} [params]\n   * @param {string} [params.jobName]\n   * @param {object} [params.groupings]\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    const groupings = {\n      process_type: this.processType,\n      instance: this.dynoId,\n      ...(params.groupings || {}),\n    }\n    return this.gateway.push({\n      jobName: params.jobName || this.appName,\n      groupings,\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"baseMetricsClient.js","names":["client","require","https","BaseMetricsClient","constructor","config","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","enabled","METRICS_ENABLED","logValues","METRICS_LOG_VALUES","pushgatewayUrl","METRICS_PUSHGATEWAY_URL","authToken","pushgatewaySecret","METRICS_PUSHGATEWAY_SECRET","intervalSec","parseInt","METRICS_INTERVAL_SEC","startupValidation","prefixLogs","_registry","Registry","collectDefaultMetrics","register","defaultLabels","app","dyno_id","process_type","gateway","Pushgateway","headers","Authorization","agent","Agent","keepAlive","gauges","counters","countersFunctions","gaugeUpdaters","_clearOldWorkers","removeOldMetrics","_setCleanupHandlers","createGauge","name","help","updateFn","labelNames","Object","keys","g","Gauge","registers","createCounter","c","Counter","data","value","inc","clearAllCounters","metricsLogValues","console","log","values","forEach","counter","reset","_pushMetrics","entries","result","val","Promise","undefined","set","err","error","gatewayPush","metrics","getMetricsAsJSON","JSON","stringify","_startPush","interval","customPushMetics","warn","setInterval","pushMetrics","catch","startPush","cleanup","gatewayDelete","exit","url","res","fetch","Accept","ok","status","text","metricRegex","labelRegex","uniqueLabelSets","Set","match","exec","rawLabels","lr","labels","job","add","size","oldLabelSets","map","s","parse","filter","instance","length","jobName","groupings","params","delete","push","withDefaultLabels","getDefaultLabels","on","metricsEnabled","registry","module","exports"],"sources":["../src/baseMetricsClient.js"],"sourcesContent":["const client = require('prom-client')\nconst https = require('https')\n\n/**\n * BaseMetricsClient provides common functionality for all metrics clients.\n * Handles registry setup, pushgateway, default labels, and common operations.\n */\nclass BaseMetricsClient {\n  /**\n   * @param {Object} config\n   * @param {string} [config.appName] Name of the application\n   * @param {string} [config.dynoId] Dyno/instance ID\n   * @param {string} [config.processType] Process type (web, worker, etc.)\n   * @param {boolean} [config.enabled] Enable metrics collection\n   * @param {boolean} [config.logValues] Log metrics values to console\n   * @param {string} [config.pushgatewayUrl] PushGateway URL\n   * @param {string} [config.pushgatewaySecret] PushGateway secret token\n   * @param {number} [config.intervalSec] Interval in seconds for pushing metrics\n   * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name\n   * @param {function} [config.startupValidation] Add to validate on start push.\n   */\n  constructor(config = {}) {\n    this.appName = config.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.dynoId = config.dynoId || process.env.HOSTNAME || 'unknown-dyno'\n    this.processType =\n      config.processType ||\n      process.env.BUILD_DYNO_PROCESS_TYPE ||\n      'undefined_build_dyno_type'\n    this.enabled = config.enabled ?? process.env.METRICS_ENABLED === 'true'\n    this.logValues =\n      config.logValues ?? process.env.METRICS_LOG_VALUES === 'true'\n    this.pushgatewayUrl =\n      config.pushgatewayUrl || process.env.METRICS_PUSHGATEWAY_URL || ''\n    this.authToken =\n      config.pushgatewaySecret || process.env.METRICS_PUSHGATEWAY_SECRET || ''\n    this.intervalSec =\n      config.intervalSec ||\n      parseInt(process.env.METRICS_INTERVAL_SEC || '', 10) ||\n      15\n    this.startupValidation = config.startupValidation\n\n    this.prefixLogs = `[${this.processType}] [${this.appName}] [${this.dynoId}] [Monitoring]`\n\n    this._registry = new client.Registry()\n    client.collectDefaultMetrics({ register: this._registry })\n\n    this.defaultLabels = {\n      app: this.appName,\n      dyno_id: this.dynoId,\n      process_type: this.processType,\n    }\n\n    this.gateway = new client.Pushgateway(\n      this.pushgatewayUrl,\n      {\n        headers: { Authorization: `Basic ${this.authToken}` },\n        agent: new https.Agent({ keepAlive: true }),\n      },\n      this._registry\n    )\n    this.gauges = {}\n    this.counters = {}\n    this.countersFunctions = {}\n\n    /** @type {Object<string, function(): number | Promise<number>>} */\n    this.gaugeUpdaters = {}\n\n    this._clearOldWorkers(config.removeOldMetrics)\n    this._setCleanupHandlers()\n  }\n\n  /**\n   * Create a gauge metric.\n   * @param {Object} options - Gauge configuration\n   * @param {string} options.name - Name of the gauge\n   * @param {string} options.help - Help text describing the gauge\n   * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value\n   * @param {string[]} [options.labelNames] - Optional custom label names\n   * @returns {import('prom-client').Gauge} The created Prometheus gauge\n   */\n  createGauge = ({\n    name,\n    help,\n    updateFn,\n    labelNames = Object.keys(this.defaultLabels),\n  }) => {\n    if (this.gauges[name]) return this.gauges[name]\n\n    const g = new client.Gauge({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.gauges[name] = g\n\n    if (updateFn && typeof updateFn === 'function') {\n      this.gaugeUpdaters[name] = updateFn\n    }\n\n    return g\n  }\n\n  /**\n   * Create a Prometheus Counter metric.\n   *\n   * @param {Object} params - Counter configuration\n   * @param {string} params.name - Metric name\n   * @param {string} params.help - Metric description\n   * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.\n   *\n   * @returns {(labels?: Object, incrementValue?: number) => void}\n   *          A function to increment the counter.\n   *          Usage: (labels?, incrementValue?)\n   */\n  createCounter({ name, help, labelNames = Object.keys(this.defaultLabels) }) {\n    if (this.counters[name]) return this.countersFunctions[name]\n\n    const c = new client.Counter({\n      name,\n      help,\n      labelNames,\n      registers: [this._registry],\n    })\n    this.counters[name] = c\n\n    this.countersFunctions = {\n      ...this.countersFunctions,\n      [name]: (data = {}, value = 1) => {\n        c.inc({ ...this.defaultLabels, ...data }, value)\n      },\n    }\n\n    return this.countersFunctions[name]\n  }\n\n  /**\n   * Clear all collected counters\n   */\n  clearAllCounters = () => {\n    if (this.metricsLogValues) {\n      console.log('Counters to clear: ', Object.keys(this.counters))\n    }\n    Object.values(this.counters).forEach(counter => counter.reset())\n  }\n\n  /**\n   * Push all gauges and counters to PushGateway and optionally log.\n   */\n  _pushMetrics = async () => {\n    try {\n      for (const [name, updateFn] of Object.entries(this.gaugeUpdaters)) {\n        try {\n          if (!updateFn) {\n            return\n          }\n          const result = updateFn()\n          const val = result instanceof Promise ? await result : result\n          if (val !== undefined) this.gauges[name].set(this.defaultLabels, val)\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to update gauge ${name}:`,\n            err\n          )\n        }\n      }\n\n      await this.gatewayPush()\n      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)\n\n      if (this.logValues) {\n        const metrics = await this._registry.getMetricsAsJSON()\n        console.log(\n          `${this.prefixLogs} Metrics:\\n`,\n          JSON.stringify(metrics, null, 2)\n        )\n      }\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n    }\n  }\n\n  _startPush = (interval = this.intervalSec, customPushMetics = undefined) => {\n    if (!this.enabled) {\n      console.warn(`${this.prefixLogs} Metrics disabled`)\n      return\n    }\n\n    if (this.startupValidation && !this.startupValidation()) {\n      return\n    }\n\n    if (customPushMetics && typeof customPushMetics === 'function') {\n      setInterval(() => customPushMetics(), interval * 1000)\n    } else {\n      setInterval(() => {\n        this.pushMetrics().catch(err => {\n          console.error(`${this.prefixLogs} Failed to push metrics:`, err)\n        })\n      }, interval * 1000)\n    }\n\n    console.warn(\n      `${this.prefixLogs} Metrics collection started. (interval: ${this.intervalSec}s)`\n    )\n  }\n\n  pushMetrics = async () => {\n    return this._pushMetrics()\n  }\n\n  /**\n   * Start periodic metrics collection and push.\n   *\n   * This method wraps the internal `_startPush` method.\n   * If a `customPushMetrics` function is provided, it will be executed\n   * at the given interval instead of the default `pushMetrics` behavior.\n   *\n   * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.\n   * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.\n   */\n  startPush = (interval, customPushMetics = undefined) => {\n    this._startPush(interval, customPushMetics)\n  }\n\n  /**\n   * Cleanup metrics and exit process.\n   * @returns {Promise<void>}\n   */\n  cleanup = async () => {\n    if (this.enabled) {\n      await this.gatewayDelete()\n    }\n    process.exit(0)\n  }\n\n  /**\n   * Remove old/stale dyno/instance metrics from PushGateway.\n   *\n   * Compares existing PushGateway metrics for this job and deletes any instances\n   * that do not match the current dynoId.\n   *\n   * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing\n   * @returns {Promise<void>}\n   * @private\n   */\n  _clearOldWorkers = async removeOldMetrics => {\n    if (!removeOldMetrics) return\n\n    try {\n      const url = `${this.pushgatewayUrl}/metrics`\n      const res = await fetch(url, {\n        headers: {\n          Authorization: `Basic ${this.authToken}`,\n          Accept: 'text/plain',\n        },\n      })\n\n      if (!res.ok) {\n        console.error(\n          `${this.prefixLogs} Failed to fetch metrics: ${res.status}`\n        )\n        return\n      }\n\n      const text = await res.text()\n\n      const metricRegex = /([a-zA-Z_:][a-zA-Z0-9_:]*)\\{([^}]*)\\}/gm\n      const labelRegex = /(\\w+)=\"([^\"]*)\"/g\n\n      const uniqueLabelSets = new Set()\n\n      let match\n      // eslint-disable-next-line no-cond-assign\n      while ((match = metricRegex.exec(text)) !== null) {\n        const rawLabels = match[2]\n        let lr\n        const labels = {}\n\n        // eslint-disable-next-line no-cond-assign\n        while ((lr = labelRegex.exec(rawLabels)) !== null) {\n          // eslint-disable-next-line prefer-destructuring\n          labels[lr[1]] = lr[2]\n        }\n\n        if (\n          labels.job === this.appName &&\n          labels.process_type === this.processType\n        ) {\n          uniqueLabelSets.add(JSON.stringify(labels))\n        }\n      }\n\n      if (uniqueLabelSets.size === 0) {\n        console.log(\n          `${this.prefixLogs} No metrics found for job ${this.appName}`\n        )\n        return\n      }\n\n      const oldLabelSets = [...uniqueLabelSets]\n        .map(s => JSON.parse(s))\n        .filter(\n          labels =>\n            labels.instance &&\n            labels.instance !== this.dynoId &&\n            labels.process_type === this.processType\n        )\n\n      if (oldLabelSets.length === 0) {\n        console.log(`${this.prefixLogs} No old dynos to delete.`)\n        return\n      }\n\n      for (const labels of oldLabelSets) {\n        try {\n          await this.gatewayDelete({ jobName: this.appName, groupings: labels })\n          console.log(\n            `${this.prefixLogs} Deleted metrics for dyno: ${\n              labels.instance\n            }, labels: ${Object.keys(labels)} `\n          )\n        } catch (err) {\n          console.error(\n            `${this.prefixLogs} Failed to delete metrics for ${labels.instance}:`,\n            err\n          )\n        }\n      }\n\n      console.log(\n        `${this.prefixLogs} Cleared all old instances for job ${this.appName}`\n      )\n    } catch (err) {\n      console.error(`${this.prefixLogs} Error deleting old metrics:`, err)\n    }\n  }\n\n  /**\n   * Delete metrics for this job/instance from PushGateway.\n   *\n   * @param {Object} [params]\n   * @param {string} [params.jobName] Job name (defaults to appName)\n   * @param {Object} [params.groupings] Grouping labels\n   * @param {string} [params.groupings.process_type] Process type label\n   * @param {string} [params.groupings.instance] Instance/dyno ID\n   * @returns {Promise<void>}\n   */\n  gatewayDelete = async (params = {}) => {\n    return this.gateway.delete({\n      jobName: params.jobName || this.appName,\n      groupings: params.groupings || {\n        process_type: this.processType,\n        instance: this.dynoId,\n      },\n    })\n  }\n\n  /**\n   * Push metrics to PushGateway.\n   *\n   * @param {object} [params]\n   * @param {string} [params.jobName]\n   * @param {object} [params.groupings]\n   * @returns {Promise<void>}\n   */\n  gatewayPush = async (params = {}) => {\n    const groupings = {\n      process_type: this.processType,\n      instance: this.dynoId,\n      ...(params.groupings || {}),\n    }\n    return this.gateway.push({\n      jobName: params.jobName || this.appName,\n      groupings,\n    })\n  }\n\n  /**\n   * Merge the default metric labels (`app`, `dyno_id`, `process_type`)\n   * with custom label names.\n   *\n   * @param {string[]} labels Additional label names\n   * @returns {string[]} Combined label names\n   */\n  withDefaultLabels = (labels = []) => {\n    return [...Object.keys(this.defaultLabels), ...labels]\n  }\n\n  getDefaultLabels = (labels = []) => {\n    return this.defaultLabels\n  }\n\n  _setCleanupHandlers = () => {\n    process.on('SIGINT', this.cleanup)\n    process.on('SIGTERM', this.cleanup)\n  }\n\n  // GETTERS\n\n  get metricsEnabled() {\n    return this.enabled\n  }\n\n  get metricsLogValues() {\n    return this.logValues\n  }\n\n  get registry() {\n    return this._registry\n  }\n}\n\nmodule.exports = { BaseMetricsClient }\n"],"mappings":"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","ignoreList":[]}

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.118",
+  "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/baseMetricsClient.js

@@ -166,7 +166,7 @@ class BaseMetricsClient {
       }
 
       await this.gatewayPush()
-      this.clearAllCounters()
+      // this.clearAllCounters() //TODO: or uncommit or delete (based on grafana expectation)
 
       if (this.logValues) {
         const metrics = await this._registry.getMetricsAsJSON()

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'