@adalo/metrics 0.0.0-staging.1

package/lib/health/healthCheckClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckClient.js","names":["createDatabasePool","runHealthCheck","closePool","require","getRedisClientType","REDIS_V4","IOREDIS","REDIS_V3","HealthCheckCache","readNumberEnv","name","raw","process","env","undefined","num","Number","isFinite","DEFAULT_HEALTH_CONFIG","checkIntervalMs","staleThresholdMs","checkTimeoutMs","maxDbConnectLatencyMs","SENSITIVE_PATTERNS","pattern","replacement","maskSensitiveData","text","masked","replace","HealthCheckClient","constructor","options","healthConfig","config","appName","BUILD_APP_NAME","prefixLogs","_refreshPromise","_databasePools","Map","_resources","resources","redisClient","_getRedisClientForCache","_redisClientType","_cache","cacheKey","_getEnv","resource","redisResource","find","r","client","_getPool","url","has","pool","type","set","get","_checkDatabase","status","error","timings","maxConnect","connectMs","err","healthCheckTimings","message","_checkRedis","pong","Promise","resolve","reject","ping","result","_performHealthCheckInternal","sortedResources","Object","keys","sort","reduce","acc","key","hasError","values","some","lastCheckAt","Date","now","isStale","_formatResult","cached","performHealthCheck","then","catch","getCachedResult","console","refreshCache","clearCache","healthHandler","req","res","json","statusCode","cleanup","clear","module","exports"],"sources":["../../src/health/healthCheckClient.js"],"sourcesContent":["const {\n  createDatabasePool,\n  runHealthCheck,\n  closePool,\n} = require('./databaseChecker')\nconst {\n  getRedisClientType,\n  REDIS_V4,\n  IOREDIS,\n  REDIS_V3,\n} = require('../redisUtils')\nconst { HealthCheckCache } = require('./healthCheckCache')\n\n/**\n * @param {string} name\n * @returns {number | undefined}\n */\nfunction readNumberEnv(name) {\n  const raw = process.env[name]\n  if (raw == null || raw === '') return undefined\n  const num = Number(raw)\n  return Number.isFinite(num) ? num : undefined\n}\n\n/** @type {{ checkIntervalMs: number, staleThresholdMs: number, checkTimeoutMs: number, maxDbConnectLatencyMs: number }} */\nconst DEFAULT_HEALTH_CONFIG = {\n  checkIntervalMs: 30_000,\n  staleThresholdMs: 180_000,\n  checkTimeoutMs: 15_000,\n  maxDbConnectLatencyMs:\n    readNumberEnv('HEALTH_DB_MAX_CONNECT_LATENCY_MS') ?? 1000,\n}\n\nconst SENSITIVE_PATTERNS = [\n  {\n    pattern:\n      /(postgres(?:ql)?|mysql|mongodb|redis|amqp):\\/\\/([^:]+):([^@]+)@([^:/]+)(:\\d+)?\\/([^\\s?]+)/gi,\n    replacement: '$1://***:***@***$5/***',\n  },\n  {\n    pattern: /(\\w+):\\/\\/([^:]+):([^@]+)@([^\\s/]+)/gi,\n    replacement: '$1://***:***@***',\n  },\n  {\n    pattern:\n      /(password|passwd|pwd|secret|token|api[_-]?key|auth[_-]?token)[\"\\s]*[:=][\"\\s]*([^\\s,}\"]+)/gi,\n    replacement: '$1=***',\n  },\n  {\n    pattern:\n      /(database|table|schema|role|user|relation|column|index)\\s*[\"']([^\"']+)[\"']/gi,\n    replacement: '$1 \"***\"',\n  },\n  {\n    pattern: /\\b(\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})(:\\d+)?\\b/g,\n    replacement: '***$2',\n  },\n  {\n    pattern: /\\b(host|hostname|server)[\"\\s]*[:=][\"\\s]*([^\\s,}\"]+)/gi,\n    replacement: '$1=***',\n  },\n]\n\n/**\n * @param {string} text\n * @returns {string}\n */\nfunction maskSensitiveData(text) {\n  if (!text || typeof text !== 'string') return text\n  let masked = text\n  for (const { pattern, replacement } of SENSITIVE_PATTERNS) {\n    masked = masked.replace(pattern, replacement)\n  }\n  return masked\n}\n\n/**\n * @typedef {{ env: string, url?: string } | { env: string, client?: any }} HealthResource\n */\nclass HealthCheckClient {\n  /**\n   * @param {Object} options\n   * @param {HealthResource[]} options.resources - Must include Redis resource with client\n   * @param {Object} [options.config]\n   * @param {string} [options.appName] - For cache key: healthcheck:${appName}\n   * @param {string} [options.cacheKey] - Redis key (overrides appName)\n   */\n  constructor(options = {}) {\n    this.healthConfig = { ...DEFAULT_HEALTH_CONFIG, ...options.config }\n    this.appName =\n      options.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n\n    this.prefixLogs = `[${this.appName}] [HealthCheck]`\n\n    this._refreshPromise = null\n    /** @type {Map<string, { pool: any, type: string }>} */\n    this._databasePools = new Map()\n\n    /** @type {HealthResource[]} */\n    this._resources = options.resources || []\n\n    const redisClient = this._getRedisClientForCache()\n    if (redisClient) {\n      this._redisClientType = getRedisClientType(redisClient)\n    }\n\n    this._cache = new HealthCheckCache({\n      redisClient: redisClient || null,\n      cacheKey: options.cacheKey,\n      appName: this.appName,\n      staleThresholdMs: this.healthConfig.staleThresholdMs,\n    })\n  }\n\n  _getEnv(resource) {\n    return resource.env ?? resource.name\n  }\n\n  _getRedisClientForCache() {\n    const redisResource = this._resources.find(r => 'client' in r && r.client)\n    return redisResource?.client || null\n  }\n\n  _getPool(env, url) {\n    if (!this._databasePools.has(env)) {\n      const { pool, type } = createDatabasePool(\n        env,\n        url,\n        this.healthConfig.checkTimeoutMs\n      )\n      this._databasePools.set(env, { pool, type })\n    }\n    return this._databasePools.get(env)\n  }\n\n  async _checkDatabase(resource) {\n    const env = this._getEnv(resource)\n    const url = 'url' in resource ? resource.url : process.env[env]\n    if (!url) {\n      return { status: 'error', error: `Env ${env} not set` }\n    }\n\n    try {\n      const { pool, type } = this._getPool(env, url)\n      const timings = await runHealthCheck(pool, type)\n\n      const maxConnect = this.healthConfig.maxDbConnectLatencyMs\n      if (\n        typeof maxConnect === 'number' &&\n        Number.isFinite(maxConnect) &&\n        timings?.connectMs != null &&\n        timings.connectMs > maxConnect\n      ) {\n        return {\n          status: 'error',\n          error: `DB connect latency ${timings.connectMs}ms exceeds ${maxConnect}ms`,\n          connectMs: timings.connectMs,\n        }\n      }\n\n      return { status: 'ok', connectMs: timings.connectMs }\n    } catch (err) {\n      const timings = err?.healthCheckTimings\n      return {\n        status: 'error',\n        error: maskSensitiveData(err.message),\n        ...(timings && typeof timings === 'object'\n          ? { connectMs: timings.connectMs }\n          : {}),\n      }\n    }\n  }\n\n  async _checkRedis(resource) {\n    const { client } = resource\n    if (!client) return { status: 'ok' }\n\n    try {\n      let pong\n      if (this._redisClientType === REDIS_V3) {\n        pong = await new Promise((resolve, reject) => {\n          client.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 client.ping()\n      } else {\n        return { status: 'error', error: 'Unknown Redis client type' }\n      }\n\n      return pong === 'PONG'\n        ? { status: 'ok' }\n        : { status: 'error', error: `Unexpected: ${pong}` }\n    } catch (err) {\n      return { status: 'error', error: maskSensitiveData(err.message) }\n    }\n  }\n\n  async _performHealthCheckInternal() {\n    const resources = {}\n\n    for (const resource of this._resources) {\n      const env = this._getEnv(resource)\n\n      if ('client' in resource && resource.client) {\n        resources[env] = await this._checkRedis(resource)\n      } else {\n        resources[env] = await this._checkDatabase(resource)\n      }\n    }\n\n    const sortedResources = Object.keys(resources)\n      .sort()\n      .reduce((acc, key) => {\n        acc[key] = resources[key]\n        return acc\n      }, {})\n\n    const hasError = Object.values(resources).some(r => r.status === 'error')\n    const lastCheckAt = Date.now()\n\n    return {\n      status: hasError ? 'error' : 'ok',\n      lastCheckAt,\n      resources: sortedResources,\n      isStale: false,\n      config: this.healthConfig,\n    }\n  }\n\n  _formatResult(result, cached = false) {\n    const isStale =\n      !result.lastCheckAt ||\n      Date.now() - result.lastCheckAt > this.healthConfig.staleThresholdMs\n\n    return {\n      ...result,\n      isStale,\n      status: isStale ? 'stale' : result.status,\n      ...(isStale && {\n        error:\n          'Health check data is stale, health-check worker may not be running. Resource statuses are unknown.',\n      }),\n      ...(cached && { cached: true }),\n    }\n  }\n\n  async performHealthCheck() {\n    if (this._refreshPromise) {\n      return this._refreshPromise\n    }\n\n    this._refreshPromise = this._performHealthCheckInternal()\n      .then(result => {\n        this._refreshPromise = null\n        return this._formatResult(result)\n      })\n      .catch(err => {\n        this._refreshPromise = null\n        throw err\n      })\n\n    return this._refreshPromise\n  }\n\n  async getCachedResult() {\n    try {\n      const cached = await this._cache.get()\n      if (cached) return this._formatResult(cached)\n      return null\n    } catch (err) {\n      console.error(`${this.prefixLogs} Failed to read from cache:`, err)\n      return {\n        status: 'error',\n        lastCheckAt: null,\n        resources: {},\n        isStale: true,\n        error:\n          'Redis unavailable, unable to read health status of other resources',\n        config: this.healthConfig,\n      }\n    }\n  }\n\n  async refreshCache() {\n    const result = await this._performHealthCheckInternal()\n    await this._cache.set(result)\n    return result\n  }\n\n  clearCache() {\n    this._refreshPromise = null\n  }\n\n  healthHandler() {\n    return async (req, res) => {\n      try {\n        const result = await this.getCachedResult()\n\n        if (!result) {\n          res.status(503).json({\n            status: 'error',\n            lastCheckAt: null,\n            resources: {},\n            isStale: true,\n            error:\n              'No health check data yet, health-check worker may not be running',\n            config: this.healthConfig,\n          })\n          return\n        }\n\n        const statusCode = result.status === 'ok' ? 200 : 503\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: 'error',\n          lastCheckAt: null,\n          resources: {},\n          isStale: true,\n          error:\n            'Redis unavailable, unable to read health status of other resources',\n          config: this.healthConfig,\n        })\n      }\n    }\n  }\n\n  async cleanup() {\n    for (const [, { pool }] of this._databasePools) {\n      try {\n        await closePool(pool)\n      } catch (err) {\n        console.error(`${this.prefixLogs} Error closing database pool:`, err)\n      }\n    }\n    this._databasePools.clear()\n  }\n}\n\nmodule.exports = { HealthCheckClient, DEFAULT_HEALTH_CONFIG }\n"],"mappings":"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","ignoreList":[]}

package/lib/health/healthCheckUtils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @param {Object} options
+ * @param {{ env: string } | { env: string, url?: string } | { env: string, client?: any }}[] options.resources
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {string} [options.cacheKey] - Redis key (overrides appName)
+ * @param {Object} [options.config]
+ * @param {string} [options.databaseUrl]
+ * @param {string} [options.databaseName]
+ * @param {Object<string, string>} [options.additionalDatabaseUrls]
+ * @returns {HealthCheckClient}
+ */
+export function createHealthCheckWorkerClient(options: Object): HealthCheckClient;
+/**
+ * @param {Object} options
+ * @param {any} options.redisClient
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+ * @param {Object} [options.config]
+ * @returns {HealthCheckClient}
+ */
+export function createHealthCheckEndpointClient(options: {
+    redisClient: any;
+    appName?: string | undefined;
+    cacheKey?: string | undefined;
+    config?: Object | undefined;
+}): HealthCheckClient;
+/**
+ * @param {Object} options
+ * @param {any} options.redisClient
+ * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {Object} [options.config]
+ * @returns {(req: any, res: any) => Promise<void>}
+ */
+export function getHealthCheckStatus(options: {
+    redisClient: any;
+    cacheKey?: string | undefined;
+    appName?: string | undefined;
+    config?: Object | undefined;
+}): (req: any, res: any) => Promise<void>;
+/**
+ * @param {Object<string, string>} urls
+ * @returns {{ env: string, url: string }[]}
+ */
+export function additionalDatabaseUrlsToResources(urls: {
+    [x: string]: string;
+}): {
+    env: string;
+    url: string;
+}[];
+import { HealthCheckClient } from "./healthCheckClient";
+//# sourceMappingURL=healthCheckUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckUtils.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckUtils.js"],"names":[],"mappings":"AAaA;;;;;;;;;;GAUG;AACH,uDAVW,MAAM,GAQJ,iBAAiB,CA6C7B;AAED;;;;;;;GAOG;AACH;IANwB,WAAW,EAAxB,GAAG;IACc,OAAO;IACP,QAAQ;IACR,MAAM;IACrB,iBAAiB,CAiB7B;AAED;;;;;;;GAOG;AACH;IANwB,WAAW,EAAxB,GAAG;IACc,QAAQ;IACR,OAAO;IACP,MAAM;UACf,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAiBjD;AAnHD;;;GAGG;AACH;QAHkB,MAAM,GAAE,MAAM;IACnB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAO1C"}

package/lib/health/healthCheckUtils.js

@@ -0,0 +1,129 @@
+"use strict";
+
+const {
+  HealthCheckClient
+} = require('./healthCheckClient');
+
+/**
+ * @param {Object<string, string>} urls
+ * @returns {{ env: string, url: string }[]}
+ */
+function additionalDatabaseUrlsToResources(urls) {
+  if (!urls || typeof urls !== 'object') return [];
+  return Object.entries(urls).filter(([, url]) => url).map(([env, url]) => ({
+    env,
+    url
+  }));
+}
+
+/**
+ * @param {Object} options
+ * @param {{ env: string } | { env: string, url?: string } | { env: string, client?: any }}[] options.resources
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {string} [options.cacheKey] - Redis key (overrides appName)
+ * @param {Object} [options.config]
+ * @param {string} [options.databaseUrl]
+ * @param {string} [options.databaseName]
+ * @param {Object<string, string>} [options.additionalDatabaseUrls]
+ * @returns {HealthCheckClient}
+ */
+function createHealthCheckWorkerClient(options) {
+  const {
+    resources,
+    appName,
+    cacheKey,
+    config,
+    databaseUrl,
+    databaseName,
+    additionalDatabaseUrls
+  } = options;
+  let resourcesArray = Array.isArray(resources) ? resources : [];
+  if (resourcesArray.length === 0) {
+    resourcesArray = [];
+    if (databaseUrl) {
+      const url = databaseUrl || process.env.DATABASE_URL;
+      if (url) {
+        const env = databaseName || 'DATABASE_URL';
+        resourcesArray.push({
+          env,
+          url
+        });
+      }
+    }
+    const clusterResources = additionalDatabaseUrlsToResources(additionalDatabaseUrls || {});
+    resourcesArray.push(...clusterResources);
+  }
+  const redisResource = resourcesArray.find(r => 'client' in r && r.client);
+  if (!redisResource) {
+    throw new Error('resources must include Redis resource with client (e.g. { env: "REDIS_URL", client })');
+  }
+  return new HealthCheckClient({
+    resources: resourcesArray,
+    appName: appName || process.env.BUILD_APP_NAME || 'unknown-app',
+    cacheKey,
+    config
+  });
+}
+
+/**
+ * @param {Object} options
+ * @param {any} options.redisClient
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+ * @param {Object} [options.config]
+ * @returns {HealthCheckClient}
+ */
+function createHealthCheckEndpointClient(options) {
+  const {
+    redisClient,
+    appName,
+    cacheKey,
+    config
+  } = options;
+  if (!redisClient) {
+    throw new Error('redisClient is required for createHealthCheckEndpointClient');
+  }
+  return new HealthCheckClient({
+    resources: [{
+      env: 'REDIS_URL',
+      client: redisClient
+    }],
+    appName: appName || process.env.BUILD_APP_NAME || 'unknown-app',
+    cacheKey,
+    config
+  });
+}
+
+/**
+ * @param {Object} options
+ * @param {any} options.redisClient
+ * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')
+ * @param {string} [options.appName] - For cache key: healthcheck:${appName}
+ * @param {Object} [options.config]
+ * @returns {(req: any, res: any) => Promise<void>}
+ */
+function getHealthCheckStatus(options) {
+  const {
+    redisClient,
+    cacheKey,
+    appName,
+    config
+  } = options;
+  if (!redisClient) {
+    throw new Error('redisClient is required for getHealthCheckStatus');
+  }
+  const client = createHealthCheckEndpointClient({
+    redisClient,
+    cacheKey,
+    appName,
+    config
+  });
+  return client.healthHandler();
+}
+module.exports = {
+  createHealthCheckWorkerClient,
+  createHealthCheckEndpointClient,
+  getHealthCheckStatus,
+  additionalDatabaseUrlsToResources
+};
+//# sourceMappingURL=healthCheckUtils.js.map

package/lib/health/healthCheckUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckUtils.js","names":["HealthCheckClient","require","additionalDatabaseUrlsToResources","urls","Object","entries","filter","url","map","env","createHealthCheckWorkerClient","options","resources","appName","cacheKey","config","databaseUrl","databaseName","additionalDatabaseUrls","resourcesArray","Array","isArray","length","process","DATABASE_URL","push","clusterResources","redisResource","find","r","client","Error","BUILD_APP_NAME","createHealthCheckEndpointClient","redisClient","getHealthCheckStatus","healthHandler","module","exports"],"sources":["../../src/health/healthCheckUtils.js"],"sourcesContent":["const { HealthCheckClient } = require('./healthCheckClient')\n\n/**\n * @param {Object<string, string>} urls\n * @returns {{ env: string, url: string }[]}\n */\nfunction additionalDatabaseUrlsToResources(urls) {\n  if (!urls || typeof urls !== 'object') return []\n  return Object.entries(urls)\n    .filter(([, url]) => url)\n    .map(([env, url]) => ({ env, url }))\n}\n\n/**\n * @param {Object} options\n * @param {{ env: string } | { env: string, url?: string } | { env: string, client?: any }}[] options.resources\n * @param {string} [options.appName] - For cache key: healthcheck:${appName}\n * @param {string} [options.cacheKey] - Redis key (overrides appName)\n * @param {Object} [options.config]\n * @param {string} [options.databaseUrl]\n * @param {string} [options.databaseName]\n * @param {Object<string, string>} [options.additionalDatabaseUrls]\n * @returns {HealthCheckClient}\n */\nfunction createHealthCheckWorkerClient(options) {\n  const {\n    resources,\n    appName,\n    cacheKey,\n    config,\n    databaseUrl,\n    databaseName,\n    additionalDatabaseUrls,\n  } = options\n\n  let resourcesArray = Array.isArray(resources) ? resources : []\n\n  if (resourcesArray.length === 0) {\n    resourcesArray = []\n\n    if (databaseUrl) {\n      const url = databaseUrl || process.env.DATABASE_URL\n      if (url) {\n        const env = databaseName || 'DATABASE_URL'\n        resourcesArray.push({ env, url })\n      }\n    }\n\n    const clusterResources = additionalDatabaseUrlsToResources(\n      additionalDatabaseUrls || {}\n    )\n    resourcesArray.push(...clusterResources)\n  }\n\n  const redisResource = resourcesArray.find(r => 'client' in r && r.client)\n  if (!redisResource) {\n    throw new Error(\n      'resources must include Redis resource with client (e.g. { env: \"REDIS_URL\", client })'\n    )\n  }\n\n  return new HealthCheckClient({\n    resources: resourcesArray,\n    appName: appName || process.env.BUILD_APP_NAME || 'unknown-app',\n    cacheKey,\n    config,\n  })\n}\n\n/**\n * @param {Object} options\n * @param {any} options.redisClient\n * @param {string} [options.appName] - For cache key: healthcheck:${appName}\n * @param {string} [options.cacheKey] - Redis key (e.g. 'health:database:status')\n * @param {Object} [options.config]\n * @returns {HealthCheckClient}\n */\nfunction createHealthCheckEndpointClient(options) {\n  const { redisClient, appName, cacheKey, config } = options\n\n  if (!redisClient) {\n    throw new Error(\n      'redisClient is required for createHealthCheckEndpointClient'\n    )\n  }\n\n  return new HealthCheckClient({\n    resources: [{ env: 'REDIS_URL', client: redisClient }],\n    appName: appName || process.env.BUILD_APP_NAME || 'unknown-app',\n    cacheKey,\n    config,\n  })\n}\n\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] - For cache key: healthcheck:${appName}\n * @param {Object} [options.config]\n * @returns {(req: any, res: any) => Promise<void>}\n */\nfunction getHealthCheckStatus(options) {\n  const { redisClient, cacheKey, appName, config } = options\n\n  if (!redisClient) {\n    throw new Error('redisClient is required for getHealthCheckStatus')\n  }\n\n  const client = createHealthCheckEndpointClient({\n    redisClient,\n    cacheKey,\n    appName,\n    config,\n  })\n\n  return client.healthHandler()\n}\n\nmodule.exports = {\n  createHealthCheckWorkerClient,\n  createHealthCheckEndpointClient,\n  getHealthCheckStatus,\n  additionalDatabaseUrlsToResources,\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/health/healthCheckWorker.d.ts

@@ -0,0 +1,2 @@
+export function createHealthCheckWorker(options: any): () => Promise<void>;
+//# sourceMappingURL=healthCheckWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckWorker.d.ts","sourceRoot":"","sources":["../../src/health/healthCheckWorker.js"],"names":[],"mappings":"AAYA,2EA0DC"}

package/lib/health/healthCheckWorker.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createHealthCheckWorker = createHealthCheckWorker;
+/**
+ * @param {Object} options
+ * @param {{ name: string } | { name: string, url?: string } | { name: string, client: any }}[] options.resources - Must include Redis resource with client
+ * @param {string} [options.appName]
+ * @param {number} [options.refreshIntervalMs]
+ * @param {string} [options.databaseUrl]
+ * @param {string} [options.databaseName]
+ * @param {Object<string, string>} [options.additionalDatabaseUrls]
+ */
+const {
+  createHealthCheckWorkerClient
+} = require('./healthCheckUtils');
+const {
+  DEFAULT_HEALTH_CONFIG
+} = require('./healthCheckClient');
+function createHealthCheckWorker(options) {
+  const {
+    refreshIntervalMs = DEFAULT_HEALTH_CONFIG.checkIntervalMs,
+    ...workerClientOptions
+  } = options;
+  const appName = workerClientOptions.appName || process.env.BUILD_APP_NAME || 'unknown-app';
+  const dynoId = process.env.HOSTNAME || 'unknown-dyno';
+  const processType = process.env.BUILD_DYNO_PROCESS_TYPE || 'health-check-worker';
+  const logValues = process.env.HEALTH_LOG_VALUES === 'true';
+  const prefixLogs = `[${processType}] [${appName}] [${dynoId}] [HealthCheck]`;
+  const healthCheckClient = createHealthCheckWorkerClient(workerClientOptions);
+  return async function runHealthCheckWorker() {
+    console.log(`${prefixLogs} Starting health check worker...`);
+    console.log(`${prefixLogs} Refresh interval: ${refreshIntervalMs}ms`);
+    try {
+      await healthCheckClient.refreshCache();
+      if (logValues) {
+        console.log(`${prefixLogs} Initial health check completed`);
+      }
+    } catch (err) {
+      console.error(`${prefixLogs} Initial health check failed:`, err);
+    }
+    const interval = setInterval(async () => {
+      try {
+        const result = await healthCheckClient.refreshCache();
+        if (logValues) {
+          console.log(`${prefixLogs} Health check refreshed at ${result.lastCheckAt}, status: ${result.status}`);
+        }
+      } catch (err) {
+        console.error(`${prefixLogs} Health check refresh failed:`, err);
+      }
+    }, refreshIntervalMs);
+    process.on('SIGTERM', () => {
+      console.log(`${prefixLogs} Received SIGTERM, shutting down...`);
+      clearInterval(interval);
+      healthCheckClient.cleanup().finally(() => {
+        process.exit(0);
+      });
+    });
+    process.on('SIGINT', () => {
+      console.log(`${prefixLogs} Received SIGINT, shutting down...`);
+      clearInterval(interval);
+      healthCheckClient.cleanup().finally(() => {
+        process.exit(0);
+      });
+    });
+  };
+}
+//# sourceMappingURL=healthCheckWorker.js.map

package/lib/health/healthCheckWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthCheckWorker.js","names":["createHealthCheckWorkerClient","require","DEFAULT_HEALTH_CONFIG","createHealthCheckWorker","options","refreshIntervalMs","checkIntervalMs","workerClientOptions","appName","process","env","BUILD_APP_NAME","dynoId","HOSTNAME","processType","BUILD_DYNO_PROCESS_TYPE","logValues","HEALTH_LOG_VALUES","prefixLogs","healthCheckClient","runHealthCheckWorker","console","log","refreshCache","err","error","interval","setInterval","result","lastCheckAt","status","on","clearInterval","cleanup","finally","exit"],"sources":["../../src/health/healthCheckWorker.js"],"sourcesContent":["/**\n * @param {Object} options\n * @param {{ name: string } | { name: string, url?: string } | { name: string, client: any }}[] options.resources - Must include Redis resource with client\n * @param {string} [options.appName]\n * @param {number} [options.refreshIntervalMs]\n * @param {string} [options.databaseUrl]\n * @param {string} [options.databaseName]\n * @param {Object<string, string>} [options.additionalDatabaseUrls]\n */\nconst { createHealthCheckWorkerClient } = require('./healthCheckUtils')\nconst { DEFAULT_HEALTH_CONFIG } = require('./healthCheckClient')\n\nexport function createHealthCheckWorker(options) {\n  const {\n    refreshIntervalMs = DEFAULT_HEALTH_CONFIG.checkIntervalMs,\n    ...workerClientOptions\n  } = options\n\n  const appName =\n    workerClientOptions.appName || process.env.BUILD_APP_NAME || 'unknown-app'\n  const dynoId = process.env.HOSTNAME || 'unknown-dyno'\n  const processType =\n    process.env.BUILD_DYNO_PROCESS_TYPE || 'health-check-worker'\n  const logValues = process.env.HEALTH_LOG_VALUES === 'true'\n  const prefixLogs = `[${processType}] [${appName}] [${dynoId}] [HealthCheck]`\n\n  const healthCheckClient = createHealthCheckWorkerClient(workerClientOptions)\n\n  return async function runHealthCheckWorker() {\n    console.log(`${prefixLogs} Starting health check worker...`)\n    console.log(`${prefixLogs} Refresh interval: ${refreshIntervalMs}ms`)\n\n    try {\n      await healthCheckClient.refreshCache()\n      if (logValues) {\n        console.log(`${prefixLogs} Initial health check completed`)\n      }\n    } catch (err) {\n      console.error(`${prefixLogs} Initial health check failed:`, err)\n    }\n\n    const interval = setInterval(async () => {\n      try {\n        const result = await healthCheckClient.refreshCache()\n        if (logValues) {\n          console.log(\n            `${prefixLogs} Health check refreshed at ${result.lastCheckAt}, status: ${result.status}`\n          )\n        }\n      } catch (err) {\n        console.error(`${prefixLogs} Health check refresh failed:`, err)\n      }\n    }, refreshIntervalMs)\n\n    process.on('SIGTERM', () => {\n      console.log(`${prefixLogs} Received SIGTERM, shutting down...`)\n      clearInterval(interval)\n      healthCheckClient.cleanup().finally(() => {\n        process.exit(0)\n      })\n    })\n\n    process.on('SIGINT', () => {\n      console.log(`${prefixLogs} Received SIGINT, shutting down...`)\n      clearInterval(interval)\n      healthCheckClient.cleanup().finally(() => {\n        process.exit(0)\n      })\n    })\n  }\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM;EAAEA;AAA8B,CAAC,GAAGC,OAAO,CAAC,oBAAoB,CAAC;AACvE,MAAM;EAAEC;AAAsB,CAAC,GAAGD,OAAO,CAAC,qBAAqB,CAAC;AAEzD,SAASE,uBAAuBA,CAACC,OAAO,EAAE;EAC/C,MAAM;IACJC,iBAAiB,GAAGH,qBAAqB,CAACI,eAAe;IACzD,GAAGC;EACL,CAAC,GAAGH,OAAO;EAEX,MAAMI,OAAO,GACXD,mBAAmB,CAACC,OAAO,IAAIC,OAAO,CAACC,GAAG,CAACC,cAAc,IAAI,aAAa;EAC5E,MAAMC,MAAM,GAAGH,OAAO,CAACC,GAAG,CAACG,QAAQ,IAAI,cAAc;EACrD,MAAMC,WAAW,GACfL,OAAO,CAACC,GAAG,CAACK,uBAAuB,IAAI,qBAAqB;EAC9D,MAAMC,SAAS,GAAGP,OAAO,CAACC,GAAG,CAACO,iBAAiB,KAAK,MAAM;EAC1D,MAAMC,UAAU,GAAG,IAAIJ,WAAW,MAAMN,OAAO,MAAMI,MAAM,iBAAiB;EAE5E,MAAMO,iBAAiB,GAAGnB,6BAA6B,CAACO,mBAAmB,CAAC;EAE5E,OAAO,eAAea,oBAAoBA,CAAA,EAAG;IAC3CC,OAAO,CAACC,GAAG,CAAC,GAAGJ,UAAU,kCAAkC,CAAC;IAC5DG,OAAO,CAACC,GAAG,CAAC,GAAGJ,UAAU,sBAAsBb,iBAAiB,IAAI,CAAC;IAErE,IAAI;MACF,MAAMc,iBAAiB,CAACI,YAAY,CAAC,CAAC;MACtC,IAAIP,SAAS,EAAE;QACbK,OAAO,CAACC,GAAG,CAAC,GAAGJ,UAAU,iCAAiC,CAAC;MAC7D;IACF,CAAC,CAAC,OAAOM,GAAG,EAAE;MACZH,OAAO,CAACI,KAAK,CAAC,GAAGP,UAAU,+BAA+B,EAAEM,GAAG,CAAC;IAClE;IAEA,MAAME,QAAQ,GAAGC,WAAW,CAAC,YAAY;MACvC,IAAI;QACF,MAAMC,MAAM,GAAG,MAAMT,iBAAiB,CAACI,YAAY,CAAC,CAAC;QACrD,IAAIP,SAAS,EAAE;UACbK,OAAO,CAACC,GAAG,CACT,GAAGJ,UAAU,8BAA8BU,MAAM,CAACC,WAAW,aAAaD,MAAM,CAACE,MAAM,EACzF,CAAC;QACH;MACF,CAAC,CAAC,OAAON,GAAG,EAAE;QACZH,OAAO,CAACI,KAAK,CAAC,GAAGP,UAAU,+BAA+B,EAAEM,GAAG,CAAC;MAClE;IACF,CAAC,EAAEnB,iBAAiB,CAAC;IAErBI,OAAO,CAACsB,EAAE,CAAC,SAAS,EAAE,MAAM;MAC1BV,OAAO,CAACC,GAAG,CAAC,GAAGJ,UAAU,qCAAqC,CAAC;MAC/Dc,aAAa,CAACN,QAAQ,CAAC;MACvBP,iBAAiB,CAACc,OAAO,CAAC,CAAC,CAACC,OAAO,CAAC,MAAM;QACxCzB,OAAO,CAAC0B,IAAI,CAAC,CAAC,CAAC;MACjB,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF1B,OAAO,CAACsB,EAAE,CAAC,QAAQ,EAAE,MAAM;MACzBV,OAAO,CAACC,GAAG,CAAC,GAAGJ,UAAU,oCAAoC,CAAC;MAC9Dc,aAAa,CAACN,QAAQ,CAAC;MACvBP,iBAAiB,CAACc,OAAO,CAAC,CAAC,CAACC,OAAO,CAAC,MAAM;QACxCzB,OAAO,CAAC0B,IAAI,CAAC,CAAC,CAAC;MACjB,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ,CAAC;AACH","ignoreList":[]}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export * from './metrics/baseMetricsClient';
+export * from './metrics/metricsClient';
+export * from './metrics/metricsRedisClient';
+export * from './metrics/metricsQueueRedisClient';
+export * from './metrics/metricsDatabaseClient';
+export * from './health/healthCheckClient';
+export * from './health/healthCheckUtils';
+export * from './health/healthCheckWorker';
+export * from './redisUtils';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,mCAAmC,CAAA;AACjD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,cAAc,CAAA"}

package/lib/index.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _baseMetricsClient = require("./metrics/baseMetricsClient");
+Object.keys(_baseMetricsClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _baseMetricsClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _baseMetricsClient[key];
+    }
+  });
+});
+var _metricsClient = require("./metrics/metricsClient");
+Object.keys(_metricsClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _metricsClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _metricsClient[key];
+    }
+  });
+});
+var _metricsRedisClient = require("./metrics/metricsRedisClient");
+Object.keys(_metricsRedisClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _metricsRedisClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _metricsRedisClient[key];
+    }
+  });
+});
+var _metricsQueueRedisClient = require("./metrics/metricsQueueRedisClient");
+Object.keys(_metricsQueueRedisClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _metricsQueueRedisClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _metricsQueueRedisClient[key];
+    }
+  });
+});
+var _metricsDatabaseClient = require("./metrics/metricsDatabaseClient");
+Object.keys(_metricsDatabaseClient).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _metricsDatabaseClient[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _metricsDatabaseClient[key];
+    }
+  });
+});
+var _healthCheckClient = require("./health/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 _healthCheckUtils = require("./health/healthCheckUtils");
+Object.keys(_healthCheckUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _healthCheckUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _healthCheckUtils[key];
+    }
+  });
+});
+var _healthCheckWorker = require("./health/healthCheckWorker");
+Object.keys(_healthCheckWorker).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _healthCheckWorker[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _healthCheckWorker[key];
+    }
+  });
+});
+var _redisUtils = require("./redisUtils");
+Object.keys(_redisUtils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _redisUtils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _redisUtils[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_baseMetricsClient","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_metricsClient","_metricsRedisClient","_metricsQueueRedisClient","_metricsDatabaseClient","_healthCheckClient","_healthCheckUtils","_healthCheckWorker","_redisUtils"],"sources":["../src/index.ts"],"sourcesContent":["export * from './metrics/baseMetricsClient'\nexport * from './metrics/metricsClient'\nexport * from './metrics/metricsRedisClient'\nexport * from './metrics/metricsQueueRedisClient'\nexport * from './metrics/metricsDatabaseClient'\nexport * from './health/healthCheckClient'\nexport * from './health/healthCheckUtils'\nexport * from './health/healthCheckWorker'\nexport * from './redisUtils'\n"],"mappings":"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","ignoreList":[]}

package/lib/metrics/baseMetricsClient.d.ts

@@ -0,0 +1,174 @@
+/**
+ * BaseMetricsClient provides common functionality for all metrics clients.
+ * Handles registry setup, push to remote (VM-agent), default labels, and common operations.
+ * Always pushes registry to the configured URL (POST Prometheus text format + Basic auth). No Pushgateway.
+ */
+export class BaseMetricsClient {
+    /**
+     * @param {Object} config
+     * @param {string} [config.appName] Name of the application
+     * @param {string} [config.dynoId] Dyno/instance ID
+     * @param {string} [config.processType] Process type (web, worker, etc.)
+     * @param {boolean} [config.enabled] Enable metrics collection
+     * @param {boolean} [config.logValues] Log metrics values to console
+     * @param {string} [config.pushgatewayUrl] Push URL (VM-agent import endpoint, e.g. .../api/v1/import/prometheus). /metrics is for GET (scrape), not POST (push).
+     * @param {string} [config.pushgatewaySecret] Basic auth secret (Base64 of user:password)
+     * @param {number} [config.intervalSec] Interval in seconds for pushing metrics
+     * @param {boolean} [config.removeOldMetrics] Enable to clear metrics by service name
+     * @param {function} [config.startupValidation] Add to validate on start push.
+     * @param {boolean} [config.disablePushgateway] Disable pushing to Pushgateway (use HTTP scraping instead)
+     */
+    constructor(config?: {
+        appName?: string | undefined;
+        dynoId?: string | undefined;
+        processType?: string | undefined;
+        enabled?: boolean | undefined;
+        logValues?: boolean | undefined;
+        pushgatewayUrl?: string | undefined;
+        pushgatewaySecret?: string | undefined;
+        intervalSec?: number | undefined;
+        removeOldMetrics?: boolean | undefined;
+        startupValidation?: Function | undefined;
+        disablePushgateway?: boolean | undefined;
+    });
+    appName: string;
+    dynoId: string;
+    processType: string;
+    enabled: boolean;
+    logValues: boolean;
+    pushgatewayUrl: string;
+    authToken: string;
+    intervalSec: number;
+    startupValidation: Function | undefined;
+    disablePushgateway: boolean;
+    removeOldMetrics: boolean;
+    prefixLogs: string;
+    _registry: client.Registry<"text/plain; version=0.0.4; charset=utf-8">;
+    defaultLabels: {
+        app: string;
+        dyno_id: string;
+        process_type: string;
+    };
+    gateway: any;
+    gauges: {};
+    counters: {};
+    countersFunctions: {};
+    /** @type {Object<string, function(): number | Promise<number>>} */
+    gaugeUpdaters: {
+        [x: string]: () => number | Promise<number>;
+    };
+    keepProcessAliveWhenDisabled: boolean;
+    /**
+     * Create a gauge metric.
+     * @param {Object} options - Gauge configuration
+     * @param {string} options.name - Name of the gauge
+     * @param {string} options.help - Help text describing the gauge
+     * @param {function(): number|Promise<number>} [options.updateFn] - Optional function returning the gauge value
+     * @param {string[]} [options.labelNames] - Optional custom label names
+     * @returns {import('prom-client').Gauge} The created Prometheus gauge
+     */
+    createGauge: ({ name, help, updateFn, labelNames, }: {
+        name: string;
+        help: string;
+        updateFn?: (() => number | Promise<number>) | undefined;
+        labelNames?: string[] | undefined;
+    }) => import('prom-client').Gauge;
+    /**
+     * Create a Prometheus Counter metric.
+     *
+     * @param {Object} params - Counter configuration
+     * @param {string} params.name - Metric name
+     * @param {string} params.help - Metric description
+     * @param {string[]} [params.labelNames] - Optional list of label names. Defaults to this.defaultLabels keys.
+     *
+     * @returns {(labels?: Object, incrementValue?: number) => void}
+     *          A function to increment the counter.
+     *          Usage: (labels?, incrementValue?)
+     */
+    createCounter({ name, help, labelNames }: {
+        name: string;
+        help: string;
+        labelNames?: string[] | undefined;
+    }): (labels?: Object, incrementValue?: number) => void;
+    /**
+     * Clear all collected counters
+     */
+    clearAllCounters: () => void;
+    /**
+     * Push all gauges and counters to PushGateway and optionally log.
+     */
+    _pushMetrics: () => Promise<void>;
+    _startPush: (interval?: number, customPushMetics?: undefined) => void;
+    _idleInterval: NodeJS.Timer | null | undefined;
+    pushMetrics: () => Promise<void>;
+    /**
+     * Start periodic metrics collection and push.
+     *
+     * This method wraps the internal `_startPush` method.
+     * If a `customPushMetrics` function is provided, it will be executed
+     * at the given interval instead of the default `pushMetrics` behavior.
+     *
+     * @param {number} [interval=this.intervalSec] - Interval in seconds between pushes.
+     * @param {() => void | Promise<void>} [customPushMetrics] - Optional custom push function. If provided, Prometheus push is skipped.
+     */
+    startPush: (interval?: number | undefined, customPushMetics?: undefined) => void;
+    /**
+     * Cleanup metrics and exit process.
+     * @returns {Promise<void>}
+     */
+    cleanup: () => Promise<void>;
+    /**
+     * Remove old/stale dyno/instance metrics from PushGateway.
+     *
+     * Compares existing PushGateway metrics for this job and deletes any instances
+     * that do not match the current dynoId.
+     *
+     * @param {boolean} removeOldMetrics If true, performs cleanup; otherwise does nothing
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _clearOldWorkers;
+    /**
+     * On shutdown: optionally delete this instance's metrics from VictoriaMetrics (by app, dyno_id, process_type).
+     * @returns {Promise<void>}
+     */
+    gatewayDelete: () => Promise<void>;
+    /**
+     * Call VictoriaMetrics delete_series API to remove all series matching this instance's labels (app, dyno_id, process_type).
+     * @private
+     */
+    private _deleteFromVMByLabels;
+    /**
+     * Push registry to configured URL (VM-agent). POST Prometheus text format + Basic auth.
+     *
+     * @param {object} [params] Unused; kept for API compatibility.
+     * @returns {Promise<void>}
+     */
+    gatewayPush: (params?: object | undefined) => Promise<void>;
+    /**
+     * POST registry (Prometheus text format) to VM-agent. VM-agent accepts push at /api/v1/import/prometheus; /metrics is GET (scrape) only.
+     * @private
+     */
+    private _pushToVMAgent;
+    /**
+     * Merge the default metric labels (`app`, `dyno_id`, `process_type`)
+     * with custom label names.
+     *
+     * @param {string[]} labels Additional label names
+     * @returns {string[]} Combined label names
+     */
+    withDefaultLabels: (labels?: string[]) => string[];
+    getDefaultLabels: (labels?: any[]) => {
+        app: string;
+        dyno_id: string;
+        process_type: string;
+    };
+    _setCleanupHandlers: () => void;
+    get metricsEnabled(): boolean;
+    get metricsLogValues(): boolean;
+    get registry(): client.Registry<"text/plain; version=0.0.4; charset=utf-8">;
+    getMetricsAsString(): Promise<string>;
+    metricsMiddleware(): (req: any, res: any) => Promise<void>;
+}
+import client = require("prom-client");
+//# sourceMappingURL=baseMetricsClient.d.ts.map

package/lib/metrics/baseMetricsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseMetricsClient.d.ts","sourceRoot":"","sources":["../../src/metrics/baseMetricsClient.js"],"names":[],"mappings":"AAKA;;;;GAIG;AACH;IACE;;;;;;;;;;;;;OAaG;IACH;QAZ2B,OAAO;QACP,MAAM;QACN,WAAW;QACV,OAAO;QACP,SAAS;QACV,cAAc;QACd,iBAAiB;QACjB,WAAW;QACV,gBAAgB;QACf,iBAAiB;QAClB,kBAAkB;OAoD7C;IAjDC,gBAA4E;IAC5E,eAAqE;IACrE,oBAG6B;IAC7B,iBAAuE;IACvE,mBAC+D;IAC/D,uBACoE;IACpE,kBAC0E;IAC1E,oBAGI;IACJ,wCAAiD;IACjD,4BAEoD;IACpD,0BAEmD;IAEnD,mBAAyF;IAEzF,uEAAsC;IAGtC;;;;MAIC;IAGD,aAAmB;IACnB,WAAgB;IAChB,aAAkB;IAClB,sBAA2B;IAE3B,mEAAmE;IACnE;YADkB,MAAM,SAAc,MAAM,GAAG,QAAQ,MAAM,CAAC;MACvC;IAKvB,sCAAwC;IAG1C;;;;;;;;OAQG;IACH;QAN2B,IAAI,EAApB,MAAM;QACU,IAAI,EAApB,MAAM;QACuC,QAAQ,UAAzC,MAAM,GAAC,QAAQ,MAAM,CAAC;QACf,UAAU;UAC3B,OAAO,aAAa,EAAE,KAAK,CAuBvC;IAED;;;;;;;;;;;OAWG;IACH;QAR0B,IAAI,EAAnB,MAAM;QACS,IAAI,EAAnB,MAAM;QACY,UAAU;kBAEhB,MAAM,mBAAmB,MAAM,KAAK,IAAI,CAuB9D;IAED;;OAEG;IACH,6BAKC;IAED;;OAEG;IACH,kCAiCC;IAED,sEAmDC;IA/CK,+CAA0D;IAiDhE,iCAEC;IAED;;;;;;;;;OASG;IACH,iFAEC;IAED;;;OAGG;IACH,eAFa,QAAQ,IAAI,CAAC,CAOzB;IAED;;;;;;;;;OASG;IACH,yBAEC;IAED;;;OAGG;IACH,qBAFa,QAAQ,IAAI,CAAC,CAezB;IAED;;;OAGG;IACH,8BAkDC;IAED;;;;;OAKG;IACH,8CAFa,QAAQ,IAAI,CAAC,CAgBzB;IAED;;;OAGG;IACH,uBAoDC;IAED;;;;;;OAMG;IACH,6BAHW,MAAM,EAAE,KACN,MAAM,EAAE,CAIpB;IAED;;;;MAEC;IAED,gCAGC;IAID,8BAEC;IAED,gCAEC;IAED,4EAEC;IAED,sCAEC;IAED,2DAWC;CACF"}