@adalo/metrics 0.1.131 → 0.1.133

package/lib/health/databaseChecker.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @param {string} url
+ * @returns {string} postgres | mysql
+ */
+export function getDatabaseType(url: string): string;
+/**
+ * @param {string} url
+ * @param {string} [type]
+ * @returns {{ host: string, port: number, user: string, password: string, database: string } | null}
+ */
+export function parseConnectionUrl(url: string, type?: string | undefined): {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+} | null;
+/**
+ * @param {string} env
+ * @param {string} url
+ * @param {number} connectionTimeoutMs
+ * @returns {{ pool: any, type: string }}
+ */
+export function createDatabasePool(env: string, url: string, connectionTimeoutMs: number): {
+    pool: any;
+    type: string;
+};
+/**
+ * @param {any} pool
+ * @param {string} type
+ * @returns {Promise<void>}
+ */
+export function runHealthCheck(pool: any, type: string): Promise<void>;
+/**
+ * @param {any} pool
+ * @returns {Promise<void>}
+ */
+export function closePool(pool: any): Promise<void>;
+export const DB_TYPE_POSTGRES: "postgres";
+export const DB_TYPE_MYSQL: "mysql";
+//# sourceMappingURL=databaseChecker.d.ts.map

package/lib/health/databaseChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseChecker.d.ts","sourceRoot":"","sources":["../../src/health/databaseChecker.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qCAHW,MAAM,GACJ,MAAM,CAYlB;AAED;;;;GAIG;AACH,wCAJW,MAAM,8BAEJ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBnG;AAED;;;;;GAKG;AACH,wCALW,MAAM,OACN,MAAM,uBACN,MAAM;UACI,GAAG;UAAQ,MAAM;EA+BrC;AAED;;;;GAIG;AACH,qCAJW,GAAG,QACH,MAAM,GACJ,QAAQ,IAAI,CAAC,CAQzB;AAED;;;GAGG;AACH,gCAHW,GAAG,GACD,QAAQ,IAAI,CAAC,CAQzB;AArGD,0CAAmC;AACnC,oCAA6B"}

package/lib/health/databaseChecker.js

@@ -0,0 +1,121 @@
+"use strict";
+
+const {
+  Pool
+} = require('pg');
+const DB_TYPE_POSTGRES = 'postgres';
+const DB_TYPE_MYSQL = 'mysql';
+
+/**
+ * @param {string} url
+ * @returns {string} postgres | mysql
+ */
+function getDatabaseType(url) {
+  if (!url || typeof url !== 'string') return DB_TYPE_POSTGRES;
+  const lower = url.toLowerCase();
+  if (lower.startsWith('mysql://') || lower.startsWith('mysql2://')) {
+    return DB_TYPE_MYSQL;
+  }
+  if (lower.startsWith('mariadb://')) {
+    return DB_TYPE_MYSQL;
+  }
+  return DB_TYPE_POSTGRES;
+}
+
+/**
+ * @param {string} url
+ * @param {string} [type]
+ * @returns {{ host: string, port: number, user: string, password: string, database: string } | null}
+ */
+function parseConnectionUrl(url, type) {
+  try {
+    const parsed = new URL(url);
+    const defaultPort = type === DB_TYPE_MYSQL ? 3306 : 5432;
+    const defaultDb = type === DB_TYPE_MYSQL ? 'mysql' : 'postgres';
+    return {
+      host: parsed.hostname || 'localhost',
+      port: parseInt(parsed.port || String(defaultPort), 10),
+      user: parsed.username || '',
+      password: parsed.password || '',
+      database: (parsed.pathname || '/').replace(/^\//, '') || defaultDb
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {string} env
+ * @param {string} url
+ * @param {number} connectionTimeoutMs
+ * @returns {{ pool: any, type: string }}
+ */
+function createDatabasePool(env, url, connectionTimeoutMs) {
+  const type = getDatabaseType(url);
+  if (type === DB_TYPE_MYSQL) {
+    const mysql = require('mysql2/promise');
+    const config = parseConnectionUrl(url, DB_TYPE_MYSQL);
+    if (!config) {
+      throw new Error(`Invalid MySQL URL for ${env}`);
+    }
+    const pool = mysql.createPool({
+      host: config.host,
+      port: config.port,
+      user: config.user,
+      password: config.password,
+      database: config.database,
+      connectionLimit: 1,
+      connectTimeout: connectionTimeoutMs,
+      waitForConnections: false
+    });
+    return {
+      pool,
+      type: DB_TYPE_MYSQL
+    };
+  }
+  const pool = new Pool({
+    connectionString: url,
+    max: 1,
+    idleTimeoutMillis: 30000,
+    connectionTimeoutMillis: connectionTimeoutMs
+  });
+  return {
+    pool,
+    type: DB_TYPE_POSTGRES
+  };
+}
+
+/**
+ * @param {any} pool
+ * @param {string} type
+ * @returns {Promise<void>}
+ */
+async function runHealthCheck(pool, type) {
+  if (type === DB_TYPE_MYSQL) {
+    const [rows] = await pool.execute('SELECT 1');
+    return;
+  }
+  await pool.query('SELECT 1');
+}
+
+/**
+ * @param {any} pool
+ * @returns {Promise<void>}
+ */
+async function closePool(pool) {
+  try {
+    await pool.end();
+  } catch {
+    // ignore
+  }
+}
+module.exports = {
+  getDatabaseType,
+  parseConnectionUrl,
+  createDatabasePool,
+  runHealthCheck,
+  closePool,
+  DB_TYPE_POSTGRES,
+  DB_TYPE_MYSQL
+};
+//# sourceMappingURL=databaseChecker.js.map

package/lib/health/databaseChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"databaseChecker.js","names":["Pool","require","DB_TYPE_POSTGRES","DB_TYPE_MYSQL","getDatabaseType","url","lower","toLowerCase","startsWith","parseConnectionUrl","type","parsed","URL","defaultPort","defaultDb","host","hostname","port","parseInt","String","user","username","password","database","pathname","replace","createDatabasePool","env","connectionTimeoutMs","mysql","config","Error","pool","createPool","connectionLimit","connectTimeout","waitForConnections","connectionString","max","idleTimeoutMillis","connectionTimeoutMillis","runHealthCheck","rows","execute","query","closePool","end","module","exports"],"sources":["../../src/health/databaseChecker.js"],"sourcesContent":["const { Pool } = require('pg')\n\nconst DB_TYPE_POSTGRES = 'postgres'\nconst DB_TYPE_MYSQL = 'mysql'\n\n/**\n * @param {string} url\n * @returns {string} postgres | mysql\n */\nfunction getDatabaseType(url) {\n  if (!url || typeof url !== 'string') return DB_TYPE_POSTGRES\n  const lower = url.toLowerCase()\n  if (lower.startsWith('mysql://') || lower.startsWith('mysql2://')) {\n    return DB_TYPE_MYSQL\n  }\n  if (lower.startsWith('mariadb://')) {\n    return DB_TYPE_MYSQL\n  }\n  return DB_TYPE_POSTGRES\n}\n\n/**\n * @param {string} url\n * @param {string} [type]\n * @returns {{ host: string, port: number, user: string, password: string, database: string } | null}\n */\nfunction parseConnectionUrl(url, type) {\n  try {\n    const parsed = new URL(url)\n    const defaultPort = type === DB_TYPE_MYSQL ? 3306 : 5432\n    const defaultDb = type === DB_TYPE_MYSQL ? 'mysql' : 'postgres'\n    return {\n      host: parsed.hostname || 'localhost',\n      port: parseInt(parsed.port || String(defaultPort), 10),\n      user: parsed.username || '',\n      password: parsed.password || '',\n      database: (parsed.pathname || '/').replace(/^\\//, '') || defaultDb,\n    }\n  } catch {\n    return null\n  }\n}\n\n/**\n * @param {string} env\n * @param {string} url\n * @param {number} connectionTimeoutMs\n * @returns {{ pool: any, type: string }}\n */\nfunction createDatabasePool(env, url, connectionTimeoutMs) {\n  const type = getDatabaseType(url)\n\n  if (type === DB_TYPE_MYSQL) {\n    const mysql = require('mysql2/promise')\n    const config = parseConnectionUrl(url, DB_TYPE_MYSQL)\n    if (!config) {\n      throw new Error(`Invalid MySQL URL for ${env}`)\n    }\n    const pool = mysql.createPool({\n      host: config.host,\n      port: config.port,\n      user: config.user,\n      password: config.password,\n      database: config.database,\n      connectionLimit: 1,\n      connectTimeout: connectionTimeoutMs,\n      waitForConnections: false,\n    })\n    return { pool, type: DB_TYPE_MYSQL }\n  }\n\n  const pool = new Pool({\n    connectionString: url,\n    max: 1,\n    idleTimeoutMillis: 30000,\n    connectionTimeoutMillis: connectionTimeoutMs,\n  })\n  return { pool, type: DB_TYPE_POSTGRES }\n}\n\n/**\n * @param {any} pool\n * @param {string} type\n * @returns {Promise<void>}\n */\nasync function runHealthCheck(pool, type) {\n  if (type === DB_TYPE_MYSQL) {\n    const [rows] = await pool.execute('SELECT 1')\n    return\n  }\n  await pool.query('SELECT 1')\n}\n\n/**\n * @param {any} pool\n * @returns {Promise<void>}\n */\nasync function closePool(pool) {\n  try {\n    await pool.end()\n  } catch {\n    // ignore\n  }\n}\n\nmodule.exports = {\n  getDatabaseType,\n  parseConnectionUrl,\n  createDatabasePool,\n  runHealthCheck,\n  closePool,\n  DB_TYPE_POSTGRES,\n  DB_TYPE_MYSQL,\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/health/healthCheckCache.d.ts

@@ -6,18 +6,20 @@
 export class HealthCheckCache {
     /**
      * @param {Object} options
-     * @param {any} [options.redisClient] - Redis client instance (optional)
-     * @param {string} [options.appName] - Application name for cache key
-     * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds
+     * @param {any} [options.redisClient]
+     * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+     * @param {string} [options.appName] - Used when cacheKey not set: healthcheck:${appName}
+     * @param {number} [options.staleThresholdMs]
      */
     constructor(options?: {
         redisClient?: any;
+        cacheKey?: string | undefined;
         appName?: string | undefined;
-        cacheTtlMs?: number | undefined;
+        staleThresholdMs?: number | undefined;
     });
     redisClient: any;
     appName: string;
-    cacheTtlMs: number;
+    staleThresholdMs: number;
     cacheKey: string;
     /** In-memory fallback cache */
     _memoryCache: any;

package/lib/health/healthCheckCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"healthCheckCache.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckCache.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH;IACE;;;;;OAKG;IACH;QAJyB,WAAW,GAAzB,GAAG;QACc,OAAO;QACP,UAAU;OAsBrC;IAnBC,iBAA8C;IAC9C,gBACgE;IAChE,mBAA8C;IAC9C,iBAA6C;IAE7C,+BAA+B;IAC/B,kBAAwB;IACxB,2BAAiC;IAG/B,qCAA4D;IAC5D,yBAA2B;IAS/B;;;;OAIG;IACH,6BAgCC;IAED;;;;;OAKG;IACH,OAHa,QAAQ,MAAM,GAAG,IAAI,CAAC,CAsDlC;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,QAAQ,IAAI,CAAC,CAqCzB;IAED;;;OAGG;IACH,SAFa,QAAQ,IAAI,CAAC,CAyBzB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;CACF"}
+{"version":3,"file":"healthCheckCache.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckCache.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH;IACE;;;;;;OAMG;IACH;QALyB,WAAW,GAAzB,GAAG;QACc,QAAQ;QACR,OAAO;QACP,gBAAgB;OAuB3C;IApBC,iBAA8C;IAC9C,gBACgE;IAChE,yBAA2D;IAC3D,iBACmD;IAEnD,+BAA+B;IAC/B,kBAAwB;IACxB,2BAAiC;IAG/B,qCAA4D;IAC5D,yBAA2B;IAS/B;;;;OAIG;IACH,6BAgCC;IAED;;;;;OAKG;IACH,OAHa,QAAQ,MAAM,GAAG,IAAI,CAAC,CAgDlC;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,QAAQ,IAAI,CAAC,CAqCzB;IAED;;;OAGG;IACH,SAFa,QAAQ,IAAI,CAAC,CAyBzB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;CACF"}

package/lib/health/healthCheckCache.js

@@ -15,15 +15,16 @@ const {
 class HealthCheckCache {
   /**
    * @param {Object} options
-   * @param {any} [options.redisClient] - Redis client instance (optional)
-   * @param {string} [options.appName] - Application name for cache key
-   * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds
+   * @param {any} [options.redisClient]
+   * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+   * @param {string} [options.appName] - Used when cacheKey not set: healthcheck:${appName}
+   * @param {number} [options.staleThresholdMs]
    */
   constructor(options = {}) {
     this.redisClient = options.redisClient || null;
     this.appName = options.appName || process.env.BUILD_APP_NAME || 'unknown-app';
-    this.cacheTtlMs = options.cacheTtlMs ?? 60_000;
-    this.cacheKey = `healthcheck:${this.appName}`;
+    this.staleThresholdMs = options.staleThresholdMs ?? 180_000;
+    this.cacheKey = options.cacheKey || `healthcheck:${this.appName}`;
 
     /** In-memory fallback cache */
     this._memoryCache = null;
@@ -92,12 +93,9 @@ class HealthCheckCache {
           try {
             const cached = JSON.parse(cachedStr);
             if (cached.result && cached.timestamp) {
-              const age = Date.now() - cached.timestamp;
-              if (age < this.cacheTtlMs) {
-                this._memoryCache = cached.result;
-                this._memoryCacheTimestamp = cached.timestamp;
-                return cached.result;
-              }
+              this._memoryCache = cached.result;
+              this._memoryCacheTimestamp = cached.timestamp;
+              return cached.result;
             }
           } catch (parseErr) {
             console.warn(`[HealthCheckCache] Failed to parse Redis cache:`, parseErr.message);
@@ -110,10 +108,7 @@ class HealthCheckCache {
       }
     }
     if (this._memoryCache && this._memoryCacheTimestamp) {
-      const age = Date.now() - this._memoryCacheTimestamp;
-      if (age < this.cacheTtlMs) {
-        return this._memoryCache;
-      }
+      return this._memoryCache;
     }
     return null;
   }
@@ -133,7 +128,7 @@ class HealthCheckCache {
     if (await this._checkRedisAvailable()) {
       try {
         const cacheStr = JSON.stringify(cacheData);
-        const ttlSeconds = Math.ceil(this.cacheTtlMs / 1000) + 10;
+        const ttlSeconds = Math.ceil(this.staleThresholdMs / 1000) + 60;
         if (this._redisClientType === REDIS_V3) {
           await new Promise((resolve, reject) => {
             this.redisClient.setex(this.cacheKey, ttlSeconds, cacheStr, err => {

package/lib/health/healthCheckCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"healthCheckCache.js","names":["getRedisClientType","REDIS_V4","IOREDIS","REDIS_V3","require","HealthCheckCache","constructor","options","redisClient","appName","process","env","BUILD_APP_NAME","cacheTtlMs","cacheKey","_memoryCache","_memoryCacheTimestamp","_redisClientType","_redisAvailable","console","warn","_checkRedisAvailable","pong","Promise","resolve","reject","ping","err","result","message","get","cachedStr","cached","JSON","parse","timestamp","age","Date","now","parseErr","redisErr","Error","set","cacheData","cacheStr","stringify","ttlSeconds","Math","ceil","setex","clear","del","isRedisAvailable","module","exports"],"sources":["../../src/health/healthCheckCache.js"],"sourcesContent":["const {\n  getRedisClientType,\n  REDIS_V4,\n  IOREDIS,\n  REDIS_V3,\n} = require('../redisUtils')\n\n/**\n * HealthCheckCache provides a shared cache layer for health check results.\n * It uses Redis if available for cross-process sharing, with graceful fallback\n * to in-memory cache if Redis is not configured or unavailable.\n */\nclass HealthCheckCache {\n  /**\n   * @param {Object} options\n   * @param {any} [options.redisClient] - Redis client instance (optional)\n   * @param {string} [options.appName] - Application name for cache key\n   * @param {number} [options.cacheTtlMs=60000] - Cache TTL in milliseconds\n   */\n  constructor(options = {}) {\n    this.redisClient = options.redisClient || null\n    this.appName =\n      options.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.cacheTtlMs = options.cacheTtlMs ?? 60_000\n    this.cacheKey = `healthcheck:${this.appName}`\n\n    /** In-memory fallback cache */\n    this._memoryCache = null\n    this._memoryCacheTimestamp = null\n\n    if (this.redisClient) {\n      this._redisClientType = getRedisClientType(this.redisClient)\n      this._redisAvailable = true\n    } else {\n      this._redisAvailable = false\n      console.warn(\n        `[HealthCheckCache] Redis not configured for ${this.appName}, using in-memory cache only (not shared across processes)`\n      )\n    }\n  }\n\n  /**\n   * Checks if Redis is available and working.\n   * @returns {Promise<boolean>}\n   * @private\n   */\n  async _checkRedisAvailable() {\n    if (!this.redisClient || !this._redisAvailable) {\n      return false\n    }\n\n    try {\n      let pong\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 false\n      }\n      return pong === 'PONG'\n    } catch (err) {\n      if (this._redisAvailable) {\n        console.warn(\n          `[HealthCheckCache] Redis became unavailable: ${err.message}`\n        )\n        this._redisAvailable = false\n      }\n      return false\n    }\n  }\n\n  /**\n   * Gets cached health check result from Redis (if available) or in-memory cache.\n   * Throws error if Redis is configured but read fails (so caller can return proper error format).\n   * @returns {Promise<Object | null>} Cached result or null\n   * @throws {Error} If Redis is configured but read fails\n   */\n  async get() {\n    if (this.redisClient) {\n      try {\n        let cachedStr\n        if (this._redisClientType === REDIS_V3) {\n          cachedStr = await new Promise((resolve, reject) => {\n            this.redisClient.get(this.cacheKey, (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          cachedStr = await this.redisClient.get(this.cacheKey)\n        }\n\n        if (cachedStr) {\n          try {\n            const cached = JSON.parse(cachedStr)\n            if (cached.result && cached.timestamp) {\n              const age = Date.now() - cached.timestamp\n              if (age < this.cacheTtlMs) {\n                this._memoryCache = cached.result\n                this._memoryCacheTimestamp = cached.timestamp\n                return cached.result\n              }\n            }\n          } catch (parseErr) {\n            console.warn(\n              `[HealthCheckCache] Failed to parse Redis cache:`,\n              parseErr.message\n            )\n          }\n        }\n        return null\n      } catch (redisErr) {\n        this._redisAvailable = false\n        throw new Error(`Redis cache read failed: ${redisErr.message}`)\n      }\n    }\n\n    if (this._memoryCache && this._memoryCacheTimestamp) {\n      const age = Date.now() - this._memoryCacheTimestamp\n      if (age < this.cacheTtlMs) {\n        return this._memoryCache\n      }\n    }\n\n    return null\n  }\n\n  /**\n   * Sets cached health check result in Redis (if available) and in-memory.\n   * @param {Object} result - Health check result to cache\n   * @returns {Promise<void>}\n   */\n  async set(result) {\n    const cacheData = {\n      result,\n      timestamp: Date.now(),\n    }\n\n    this._memoryCache = result\n    this._memoryCacheTimestamp = cacheData.timestamp\n\n    if (await this._checkRedisAvailable()) {\n      try {\n        const cacheStr = JSON.stringify(cacheData)\n        const ttlSeconds = Math.ceil(this.cacheTtlMs / 1000) + 10\n\n        if (this._redisClientType === REDIS_V3) {\n          await new Promise((resolve, reject) => {\n            this.redisClient.setex(this.cacheKey, ttlSeconds, cacheStr, err => {\n              if (err) reject(err)\n              else resolve()\n            })\n          })\n        } else if (\n          this._redisClientType === REDIS_V4 ||\n          this._redisClientType === IOREDIS\n        ) {\n          await this.redisClient.setex(this.cacheKey, ttlSeconds, cacheStr)\n        }\n      } catch (redisErr) {\n        console.warn(\n          `[HealthCheckCache] Redis write failed (in-memory cache updated):`,\n          redisErr.message\n        )\n        this._redisAvailable = false\n      }\n    }\n  }\n\n  /**\n   * Clears the cache (both Redis and in-memory).\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this._memoryCache = null\n    this._memoryCacheTimestamp = null\n\n    if (await this._checkRedisAvailable()) {\n      try {\n        if (this._redisClientType === REDIS_V3) {\n          await new Promise((resolve, reject) => {\n            this.redisClient.del(this.cacheKey, err => {\n              if (err) reject(err)\n              else resolve()\n            })\n          })\n        } else if (\n          this._redisClientType === REDIS_V4 ||\n          this._redisClientType === IOREDIS\n        ) {\n          await this.redisClient.del(this.cacheKey)\n        }\n      } catch (redisErr) {\n        console.warn(`[HealthCheckCache] Redis clear failed:`, redisErr.message)\n      }\n    }\n  }\n\n  /**\n   * Checks if Redis is configured and available.\n   * @returns {boolean}\n   */\n  isRedisAvailable() {\n    return this._redisAvailable && this.redisClient !== null\n  }\n}\n\nmodule.exports = { HealthCheckCache }\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"healthCheckCache.js","names":["getRedisClientType","REDIS_V4","IOREDIS","REDIS_V3","require","HealthCheckCache","constructor","options","redisClient","appName","process","env","BUILD_APP_NAME","staleThresholdMs","cacheKey","_memoryCache","_memoryCacheTimestamp","_redisClientType","_redisAvailable","console","warn","_checkRedisAvailable","pong","Promise","resolve","reject","ping","err","result","message","get","cachedStr","cached","JSON","parse","timestamp","parseErr","redisErr","Error","set","cacheData","Date","now","cacheStr","stringify","ttlSeconds","Math","ceil","setex","clear","del","isRedisAvailable","module","exports"],"sources":["../../src/health/healthCheckCache.js"],"sourcesContent":["const {\n  getRedisClientType,\n  REDIS_V4,\n  IOREDIS,\n  REDIS_V3,\n} = require('../redisUtils')\n\n/**\n * HealthCheckCache provides a shared cache layer for health check results.\n * It uses Redis if available for cross-process sharing, with graceful fallback\n * to in-memory cache if Redis is not configured or unavailable.\n */\nclass HealthCheckCache {\n  /**\n   * @param {Object} options\n   * @param {any} [options.redisClient]\n   * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')\n   * @param {string} [options.appName] - Used when cacheKey not set: healthcheck:${appName}\n   * @param {number} [options.staleThresholdMs]\n   */\n  constructor(options = {}) {\n    this.redisClient = options.redisClient || null\n    this.appName =\n      options.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n    this.staleThresholdMs = options.staleThresholdMs ?? 180_000\n    this.cacheKey =\n      options.cacheKey || `healthcheck:${this.appName}`\n\n    /** In-memory fallback cache */\n    this._memoryCache = null\n    this._memoryCacheTimestamp = null\n\n    if (this.redisClient) {\n      this._redisClientType = getRedisClientType(this.redisClient)\n      this._redisAvailable = true\n    } else {\n      this._redisAvailable = false\n      console.warn(\n        `[HealthCheckCache] Redis not configured for ${this.appName}, using in-memory cache only (not shared across processes)`\n      )\n    }\n  }\n\n  /**\n   * Checks if Redis is available and working.\n   * @returns {Promise<boolean>}\n   * @private\n   */\n  async _checkRedisAvailable() {\n    if (!this.redisClient || !this._redisAvailable) {\n      return false\n    }\n\n    try {\n      let pong\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 false\n      }\n      return pong === 'PONG'\n    } catch (err) {\n      if (this._redisAvailable) {\n        console.warn(\n          `[HealthCheckCache] Redis became unavailable: ${err.message}`\n        )\n        this._redisAvailable = false\n      }\n      return false\n    }\n  }\n\n  /**\n   * Gets cached health check result from Redis (if available) or in-memory cache.\n   * Throws error if Redis is configured but read fails (so caller can return proper error format).\n   * @returns {Promise<Object | null>} Cached result or null\n   * @throws {Error} If Redis is configured but read fails\n   */\n  async get() {\n    if (this.redisClient) {\n      try {\n        let cachedStr\n        if (this._redisClientType === REDIS_V3) {\n          cachedStr = await new Promise((resolve, reject) => {\n            this.redisClient.get(this.cacheKey, (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          cachedStr = await this.redisClient.get(this.cacheKey)\n        }\n\n        if (cachedStr) {\n          try {\n            const cached = JSON.parse(cachedStr)\n            if (cached.result && cached.timestamp) {\n              this._memoryCache = cached.result\n              this._memoryCacheTimestamp = cached.timestamp\n              return cached.result\n            }\n          } catch (parseErr) {\n            console.warn(\n              `[HealthCheckCache] Failed to parse Redis cache:`,\n              parseErr.message\n            )\n          }\n        }\n        return null\n      } catch (redisErr) {\n        this._redisAvailable = false\n        throw new Error(`Redis cache read failed: ${redisErr.message}`)\n      }\n    }\n\n    if (this._memoryCache && this._memoryCacheTimestamp) {\n      return this._memoryCache\n    }\n\n    return null\n  }\n\n  /**\n   * Sets cached health check result in Redis (if available) and in-memory.\n   * @param {Object} result - Health check result to cache\n   * @returns {Promise<void>}\n   */\n  async set(result) {\n    const cacheData = {\n      result,\n      timestamp: Date.now(),\n    }\n\n    this._memoryCache = result\n    this._memoryCacheTimestamp = cacheData.timestamp\n\n    if (await this._checkRedisAvailable()) {\n      try {\n        const cacheStr = JSON.stringify(cacheData)\n        const ttlSeconds = Math.ceil(this.staleThresholdMs / 1000) + 60\n\n        if (this._redisClientType === REDIS_V3) {\n          await new Promise((resolve, reject) => {\n            this.redisClient.setex(this.cacheKey, ttlSeconds, cacheStr, err => {\n              if (err) reject(err)\n              else resolve()\n            })\n          })\n        } else if (\n          this._redisClientType === REDIS_V4 ||\n          this._redisClientType === IOREDIS\n        ) {\n          await this.redisClient.setex(this.cacheKey, ttlSeconds, cacheStr)\n        }\n      } catch (redisErr) {\n        console.warn(\n          `[HealthCheckCache] Redis write failed (in-memory cache updated):`,\n          redisErr.message\n        )\n        this._redisAvailable = false\n      }\n    }\n  }\n\n  /**\n   * Clears the cache (both Redis and in-memory).\n   * @returns {Promise<void>}\n   */\n  async clear() {\n    this._memoryCache = null\n    this._memoryCacheTimestamp = null\n\n    if (await this._checkRedisAvailable()) {\n      try {\n        if (this._redisClientType === REDIS_V3) {\n          await new Promise((resolve, reject) => {\n            this.redisClient.del(this.cacheKey, err => {\n              if (err) reject(err)\n              else resolve()\n            })\n          })\n        } else if (\n          this._redisClientType === REDIS_V4 ||\n          this._redisClientType === IOREDIS\n        ) {\n          await this.redisClient.del(this.cacheKey)\n        }\n      } catch (redisErr) {\n        console.warn(`[HealthCheckCache] Redis clear failed:`, redisErr.message)\n      }\n    }\n  }\n\n  /**\n   * Checks if Redis is configured and available.\n   * @returns {boolean}\n   */\n  isRedisAvailable() {\n    return this._redisAvailable && this.redisClient !== null\n  }\n}\n\nmodule.exports = { HealthCheckCache }\n"],"mappings":"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","ignoreList":[]}

package/lib/health/healthCheckClient.d.ts

@@ -1,12 +1,12 @@
 export type HealthResource = {
-    name: string;
+    env: string;
     url?: string;
 } | {
-    name: string;
-    client: any;
+    env: string;
+    client?: any;
 };
 /**
- * @typedef {{ name: string, url?: string } | { name: string, client: any }} HealthResource
+ * @typedef {{ env: string, url?: string } | { env: string, client?: any }} HealthResource
  */
 export class HealthCheckClient {
     /**
@@ -14,13 +14,15 @@ export class HealthCheckClient {
      * @param {HealthResource[]} options.resources - Must include Redis resource with client
      * @param {number} [options.cacheTtlMs]
      * @param {Object} [options.config]
-     * @param {string} [options.appName]
+     * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+     * @param {string} [options.cacheKey] - Redis key (overrides appName)
      */
     constructor(options?: {
         resources: HealthResource[];
         cacheTtlMs?: number | undefined;
         config?: Object | undefined;
         appName?: string | undefined;
+        cacheKey?: string | undefined;
     });
     healthConfig: {
         constructor?: Function | undefined;
@@ -61,13 +63,21 @@ export class HealthCheckClient {
         timestamp: number;
     } | null;
     _refreshPromise: any;
-    _databasePools: Map<any, any>;
+    /** @type {Map<string, { pool: any, type: string }>} */
+    _databasePools: Map<string, {
+        pool: any;
+        type: string;
+    }>;
     /** @type {HealthResource[]} */
     _resources: HealthResource[];
     _redisClientType: string | undefined;
     _cache: HealthCheckCache;
+    _getEnv(resource: any): any;
     _getRedisClientForCache(): any;
-    _getPool(name: any, url: any): any;
+    _getPool(env: any, url: any): {
+        pool: any;
+        type: string;
+    } | undefined;
     _isCacheValid(): boolean;
     _checkDatabase(resource: any): Promise<{
         status: string;
@@ -126,7 +136,6 @@ export class HealthCheckClient {
     }>;
     clearCache(): void;
     healthHandler(): (req: any, res: any) => Promise<void>;
-    registerHealthEndpoint(app: any, path?: string): void;
     cleanup(): Promise<void>;
 }
 /** @type {{ cacheTtlMs: number, checkIntervalMs: number, staleThresholdMs: number, checkTimeoutMs: number }} */

package/lib/health/healthCheckClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"healthCheckClient.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckClient.js"],"names":[],"mappings":"6BA6Da;IAAE,MAAM,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE;AAD3E;;GAEG;AACH;IACE;;;;;;OAMG;IACH;QALqC,SAAS,EAAnC,cAAc,EAAE;QACC,UAAU;QACV,MAAM;QACN,OAAO;OA8BlC;IA3BC;;;;;;;;;;;;MAAmE;IAInE,mBAA8C;IAC9C,gBACgE;IAEhE,mBAAmD;IAEnD;;;;;;;;;;;;;;;;;;;;;aAAyB;IACzB,qBAA2B;IAC3B,8BAA+B;IAE/B,+BAA+B;IAC/B,YADW,cAAc,EAAE,CACc;IAIvC,qCAAuD;IAGzD,yBAIE;IAGJ,+BAGC;IAED,mCAaC;IAED,yBAGC;IAED;;;;;;OAiBC;IAED;;;;;;OA0BC;IAED;;;;;;;;;;;;;;;;;;OAiCC;IAED,kDAWC;IAED,mCA2BC;IAED,gCAkBC;IAED;;;;;;;;;;;;;;;;;;OAIC;IAED,mBAGC;IAED,uDA0CC;IAED,sDAGC;IAED,yBASC;CACF;AA3UD,gHAAgH;AAChH,oCADW;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAM3G"}
+{"version":3,"file":"healthCheckClient.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckClient.js"],"names":[],"mappings":"6BAiEa;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE;AAD1E;;GAEG;AACH;IACE;;;;;;;OAOG;IACH;QANqC,SAAS,EAAnC,cAAc,EAAE;QACC,UAAU;QACV,MAAM;QACN,OAAO;QACP,QAAQ;OAgCnC;IA7BC;;;;;;;;;;;;MAAmE;IAInE,mBAA8C;IAC9C,gBACgE;IAEhE,mBAAmD;IAEnD;;;;;;;;;;;;;;;;;;;;;aAAyB;IACzB,qBAA2B;IAC3B,uDAAuD;IACvD;cAD+B,GAAG;cAAQ,MAAM;OACjB;IAE/B,+BAA+B;IAC/B,YADW,cAAc,EAAE,CACc;IAIvC,qCAAuD;IAGzD,yBAKE;IAGJ,4BAEC;IAED,+BAGC;IAED;cA5BiC,GAAG;cAAQ,MAAM;kBAsCjD;IAED,yBAGC;IAED;;;;;;OAiBC;IAED;;;;;;OA0BC;IAED;;;;;;;;;;;;;;;;;;OAiCC;IAED,kDAeC;IAED,mCA2BC;IAED,gCAiBC;IAED;;;;;;;;;;;;;;;;;;OAIC;IAED,mBAGC;IAED,uDAiCC;IAED,yBASC;CACF;AApUD,gHAAgH;AAChH,oCADW;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAM3G"}

package/lib/health/healthCheckClient.js

@@ -1,8 +1,10 @@
 "use strict";
 
 const {
-  Pool
-} = require('pg');
+  createDatabasePool,
+  runHealthCheck,
+  closePool
+} = require('./databaseChecker');
 const {
   getRedisClientType,
   REDIS_V4,
@@ -57,7 +59,7 @@ function maskSensitiveData(text) {
 }
 
 /**
- * @typedef {{ name: string, url?: string } | { name: string, client: any }} HealthResource
+ * @typedef {{ env: string, url?: string } | { env: string, client?: any }} HealthResource
  */
 class HealthCheckClient {
   /**
@@ -65,7 +67,8 @@ class HealthCheckClient {
    * @param {HealthResource[]} options.resources - Must include Redis resource with client
    * @param {number} [options.cacheTtlMs]
    * @param {Object} [options.config]
-   * @param {string} [options.appName]
+   * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+   * @param {string} [options.cacheKey] - Redis key (overrides appName)
    */
   constructor(options = {}) {
     this.healthConfig = {
@@ -80,6 +83,7 @@ class HealthCheckClient {
     this.prefixLogs = `[${this.appName}] [HealthCheck]`;
     this._cachedResult = null;
     this._refreshPromise = null;
+    /** @type {Map<string, { pool: any, type: string }>} */
     this._databasePools = new Map();
 
     /** @type {HealthResource[]} */
@@ -90,43 +94,50 @@ class HealthCheckClient {
     }
     this._cache = new HealthCheckCache({
       redisClient: redisClient || null,
+      cacheKey: options.cacheKey,
       appName: this.appName,
-      cacheTtlMs: this.cacheTtlMs
+      staleThresholdMs: this.healthConfig.staleThresholdMs
     });
   }
+  _getEnv(resource) {
+    return resource.env ?? resource.name;
+  }
   _getRedisClientForCache() {
     const redisResource = this._resources.find(r => 'client' in r && r.client);
     return redisResource?.client || null;
   }
-  _getPool(name, url) {
-    if (!this._databasePools.has(name)) {
-      this._databasePools.set(name, new Pool({
-        connectionString: url,
-        max: 1,
-        idleTimeoutMillis: 30000,
-        connectionTimeoutMillis: this.healthConfig.checkTimeoutMs
-      }));
+  _getPool(env, url) {
+    if (!this._databasePools.has(env)) {
+      const {
+        pool,
+        type
+      } = createDatabasePool(env, url, this.healthConfig.checkTimeoutMs);
+      this._databasePools.set(env, {
+        pool,
+        type
+      });
     }
-    return this._databasePools.get(name);
+    return this._databasePools.get(env);
   }
   _isCacheValid() {
     if (!this._cachedResult) return false;
     return Date.now() - this._cachedResult.timestamp < this.cacheTtlMs;
   }
   async _checkDatabase(resource) {
-    const {
-      name
-    } = resource;
-    const url = 'url' in resource ? resource.url : process.env[name];
+    const env = this._getEnv(resource);
+    const url = 'url' in resource ? resource.url : process.env[env];
     if (!url) {
       return {
         status: 'error',
-        error: `Env ${name} not set`
+        error: `Env ${env} not set`
       };
     }
     try {
-      const pool = this._getPool(name, url);
-      await pool.query('SELECT 1');
+      const {
+        pool,
+        type
+      } = this._getPool(env, url);
+      await runHealthCheck(pool, type);
       return {
         status: 'ok'
       };
@@ -176,13 +187,11 @@ class HealthCheckClient {
   async _performHealthCheckInternal() {
     const resources = {};
     for (const resource of this._resources) {
-      const {
-        name
-      } = resource;
+      const env = this._getEnv(resource);
       if ('client' in resource && resource.client) {
-        resources[name] = await this._checkRedis(resource);
+        resources[env] = await this._checkRedis(resource);
       } else {
-        resources[name] = await this._checkDatabase(resource);
+        resources[env] = await this._checkDatabase(resource);
       }
     }
     const sortedResources = Object.keys(resources).sort().reduce((acc, key) => {
@@ -210,6 +219,9 @@ class HealthCheckClient {
       ...result,
       isStale,
       status: isStale ? 'stale' : result.status,
+      ...(isStale && {
+        error: 'Health check data is stale, health-check worker may not be running. Resource statuses are unknown.'
+      }),
       ...(cached && {
         cached: true
       })
@@ -244,19 +256,12 @@ class HealthCheckClient {
       return null;
     } catch (err) {
       console.error(`${this.prefixLogs} Failed to read from cache:`, err);
-      const errorMessage = maskSensitiveData(err.message || 'Cache read failed');
-      const redisResource = this._resources.find(r => 'client' in r);
-      const redisName = redisResource?.name || 'REDIS_URL';
       return {
         status: 'error',
-        lastCheckAt: Date.now(),
-        resources: {
-          [redisName]: {
-            status: 'error',
-            error: errorMessage
-          }
-        },
+        lastCheckAt: null,
+        resources: {},
         isStale: true,
+        error: 'Redis unavailable, unable to read health status of other resources',
         config: this.healthConfig
       };
     }
@@ -275,50 +280,38 @@ class HealthCheckClient {
       try {
         const result = await this.getCachedResult();
         if (!result) {
-          const redisResource = this._resources.find(r => 'client' in r);
-          const redisName = redisResource?.name || 'REDIS_URL';
           res.status(503).json({
             status: 'error',
             lastCheckAt: null,
-            resources: {
-              [redisName]: {
-                status: 'error',
-                error: 'Health check cache not available. Worker may not be running.'
-              }
-            },
+            resources: {},
             isStale: true,
+            error: 'No health check data yet, health-check worker may not be running',
             config: this.healthConfig
           });
           return;
         }
-        res.status(result.status === 'ok' ? 200 : 503).json(result);
+        const statusCode = result.status === 'ok' ? 200 : 503;
+        res.status(statusCode).json(result);
       } catch (err) {
         console.error(`${this.prefixLogs} Health check failed:`, err);
-        const redisResource = this._resources.find(r => 'client' in r);
-        const redisName = redisResource?.name || 'REDIS_URL';
         res.status(503).json({
           status: 'error',
           lastCheckAt: null,
-          resources: {
-            [redisName]: {
-              status: 'error',
-              error: maskSensitiveData(err.message)
-            }
-          },
+          resources: {},
           isStale: true,
+          error: 'Redis unavailable, unable to read health status of other resources',
           config: this.healthConfig
         });
       }
     };
   }
-  registerHealthEndpoint(app, path = '/health') {
-    app.get(path, this.healthHandler());
-    console.info(`${this.prefixLogs} Registered health endpoint at ${path}`);
-  }
   async cleanup() {
-    for (const [, pool] of this._databasePools) {
+    for (const [, {
+      pool,
+      type
+    }] of this._databasePools) {
       try {
-        await pool.end();
+        await closePool(pool);
       } catch (err) {
         console.error(`${this.prefixLogs} Error closing database pool:`, err);
       }