@autofleet/nitur 2.2.0-1 → 2.2.0-beta.1

package/lib/alive-endpoint/middleware.cjs

@@ -1,2 +1,2 @@
-const e=require(`./base.cjs`),t=require(`../logger.cjs`);function n(n){let r=n.logger??t.logger;return async(t,i)=>{try{let t=await e.systemAliveCheck(n);return i.json(t),!0}catch(e){return i.status(500).json({err:e}),r.error(`Error on alive endpoint`,{err:e}),!1}}}exports.aliveEndpointMiddleware=n;
+const e=require(`../logger.cjs`),t=require(`./base.cjs`);function n(n){let r=n.logger??e.logger;return async(e,i)=>{try{let e=await t.systemAliveCheck(n);return i.json(e),!0}catch(e){return i.status(500).json({err:e}),r.error(`Error on alive endpoint`,{err:e}),!1}}}exports.aliveEndpointMiddleware=n;
 //# sourceMappingURL=middleware.cjs.map

package/lib/alive-endpoint/middleware.js

@@ -1,2 +1,2 @@
-import{systemAliveCheck as e}from"./base.js";import{logger as t}from"../logger.js";function n(n){let r=n.logger??t;return async(t,i)=>{try{let t=await e(n);return i.json(t),!0}catch(e){return i.status(500).json({err:e}),r.error(`Error on alive endpoint`,{err:e}),!1}}}export{n as aliveEndpointMiddleware};
+import{logger as e}from"../logger.js";import{systemAliveCheck as t}from"./base.js";function n(n){let r=n.logger??e;return async(e,i)=>{try{let e=await t(n);return i.json(e),!0}catch(e){return i.status(500).json({err:e}),r.error(`Error on alive endpoint`,{err:e}),!1}}}export{n as aliveEndpointMiddleware};
 //# sourceMappingURL=middleware.js.map

package/lib/fastify.cjs

@@ -1 +1 @@
-const e=require(`./alive-endpoint/base.cjs`),t=require(`./health-check/checkers.cjs`),n=require(`./health-check/manager.cjs`),r=require(`./health-check/setup.cjs`),i=require(`./health-check/fastify-adapter.cjs`);require(`./health-check/index.cjs`),exports.HealthCheckManager=n.HealthCheckManager,exports.createBasicHealthCheck=t.createBasicHealthCheck,exports.createElasticsearchHealthCheck=t.createElasticsearchHealthCheck,exports.createRabbitMQHealthCheck=t.createRabbitMQHealthCheck,exports.createRedisHealthChecks=t.createRedisHealthChecks,exports.createSequelizeHealthCheck=t.createSequelizeHealthCheck,exports.setupFastifyHealthCheck=i.setupFastifyHealthCheck,exports.setupHealthCheck=r.setupHealthCheck,exports.systemAliveCheck=e.systemAliveCheck,exports.withTimeout=t.withTimeout;
+const e=require(`./alive-endpoint/base.cjs`);exports.systemAliveCheck=e.systemAliveCheck;

package/lib/fastify.d.cts

@@ -1,7 +1,2 @@
 import { systemAliveCheck } from "./alive-endpoint/base.cjs";
-import { ElasticsearchClient, GracefulShutdownConfig, HealthCheck, HealthCheckResult, HealthStatus, LivenessConfig, NamedHealthCheck, NamedShutdownHook, RabbitMQClient, ReadinessConfig, RedisClient, ResourceCheckConfig, SequelizeClient, ShutdownHook } from "./health-check/types.cjs";
-import { HealthCheckManager } from "./health-check/manager.cjs";
-import { HealthCheckSetup, HealthCheckSetupConfig, setupHealthCheck } from "./health-check/setup.cjs";
-import { FastifyHealthCheckConfig, setupFastifyHealthCheck } from "./health-check/fastify-adapter.cjs";
-import { createBasicHealthCheck, createElasticsearchHealthCheck, createRabbitMQHealthCheck, createRedisHealthChecks, createSequelizeHealthCheck, withTimeout } from "./health-check/checkers.cjs";
-export { type ElasticsearchClient, type FastifyHealthCheckConfig, type GracefulShutdownConfig, type HealthCheck, HealthCheckManager, type HealthCheckResult, type HealthCheckSetup, type HealthCheckSetupConfig, type HealthStatus, type LivenessConfig, type NamedHealthCheck, type NamedShutdownHook, type RabbitMQClient, type ReadinessConfig, type RedisClient, type ResourceCheckConfig, type SequelizeClient, type ShutdownHook, createBasicHealthCheck, createElasticsearchHealthCheck, createRabbitMQHealthCheck, createRedisHealthChecks, createSequelizeHealthCheck, setupFastifyHealthCheck, setupHealthCheck, systemAliveCheck, withTimeout };
+export { systemAliveCheck };

package/lib/fastify.d.ts

@@ -1,7 +1,2 @@
 import { systemAliveCheck } from "./alive-endpoint/base.js";
-import { ElasticsearchClient, GracefulShutdownConfig, HealthCheck, HealthCheckResult, HealthStatus, LivenessConfig, NamedHealthCheck, NamedShutdownHook, RabbitMQClient, ReadinessConfig, RedisClient, ResourceCheckConfig, SequelizeClient, ShutdownHook } from "./health-check/types.js";
-import { HealthCheckManager } from "./health-check/manager.js";
-import { HealthCheckSetup, HealthCheckSetupConfig, setupHealthCheck } from "./health-check/setup.js";
-import { FastifyHealthCheckConfig, setupFastifyHealthCheck } from "./health-check/fastify-adapter.js";
-import { createBasicHealthCheck, createElasticsearchHealthCheck, createRabbitMQHealthCheck, createRedisHealthChecks, createSequelizeHealthCheck, withTimeout } from "./health-check/checkers.js";
-export { type ElasticsearchClient, type FastifyHealthCheckConfig, type GracefulShutdownConfig, type HealthCheck, HealthCheckManager, type HealthCheckResult, type HealthCheckSetup, type HealthCheckSetupConfig, type HealthStatus, type LivenessConfig, type NamedHealthCheck, type NamedShutdownHook, type RabbitMQClient, type ReadinessConfig, type RedisClient, type ResourceCheckConfig, type SequelizeClient, type ShutdownHook, createBasicHealthCheck, createElasticsearchHealthCheck, createRabbitMQHealthCheck, createRedisHealthChecks, createSequelizeHealthCheck, setupFastifyHealthCheck, setupHealthCheck, systemAliveCheck, withTimeout };
+export { systemAliveCheck };

package/lib/fastify.js

@@ -1 +1 @@
-import{systemAliveCheck as e}from"./alive-endpoint/base.js";import{createBasicHealthCheck as t,createElasticsearchHealthCheck as n,createRabbitMQHealthCheck as r,createRedisHealthChecks as i,createSequelizeHealthCheck as a,withTimeout as o}from"./health-check/checkers.js";import{HealthCheckManager as s}from"./health-check/manager.js";import{setupHealthCheck as c}from"./health-check/setup.js";import{setupFastifyHealthCheck as l}from"./health-check/fastify-adapter.js";import"./health-check/index.js";export{s as HealthCheckManager,t as createBasicHealthCheck,n as createElasticsearchHealthCheck,r as createRabbitMQHealthCheck,i as createRedisHealthChecks,a as createSequelizeHealthCheck,l as setupFastifyHealthCheck,c as setupHealthCheck,e as systemAliveCheck,o as withTimeout};
+import{systemAliveCheck as e}from"./alive-endpoint/base.js";export{e as systemAliveCheck};

package/lib/health-manager/health-check-handlers.cjs

@@ -0,0 +1,2 @@
+const e=require(`./types.cjs`),t={[e.CLIENT_TYPES.REDIS]:async({client:e,name:t})=>{try{await e.ping()}catch(e){throw Error(`Redis instance '${t}' ping failed: ${e instanceof Error?e.message:String(e)}`)}},[e.CLIENT_TYPES.SEQUELIZE]:async({client:e,name:t})=>{try{let[[t]]=await e.query(`SELECT 1 as status`);if(!t||t.status!==1)throw Error(`Unexpected query result`)}catch(e){throw Error(`Sequelize instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}},[e.CLIENT_TYPES.ELASTIC_SEARCH]:async({client:e,name:t})=>{try{if(!await e.ping())throw Error(`Elasticsearch ping returned false`)}catch(e){throw Error(`Elasticsearch instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}},[e.CLIENT_TYPES.RABBIT]:async({client:e,name:t})=>{try{if(!await e.isConnected())throw Error(`RabbitMQ is not connected`)}catch(e){throw Error(`RabbitMQ instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}}};exports.DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP=t;
+//# sourceMappingURL=health-check-handlers.cjs.map

package/lib/health-manager/health-check-handlers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-handlers.cjs","names":["DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP: Partial<Record<ClientType, (options: { client: any, name: string }) => any>>","CLIENT_TYPES"],"sources":["../../src/health-manager/health-check-handlers.ts"],"sourcesContent":["import type {\n  RedisClient,\n  SequelizeClient,\n  ElasticsearchClient,\n  RabbitMQClient,\n  ClientType,\n} from './types';\nimport { CLIENT_TYPES } from './types';\n\nexport const DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP: Partial<Record<ClientType, (options: { client: any, name: string }) => any>> = {\n  [CLIENT_TYPES.REDIS]: async ({ client, name }: { client: RedisClient, name: string }) => {\n    try {\n      await client.ping();\n    } catch (error) {\n      throw new Error(`Redis instance '${name}' ping failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.SEQUELIZE]: async ({ client, name }: { client: SequelizeClient, name: string }) => {\n    try {\n      const [[result]] = await client.query('SELECT 1 as status');\n      if (!result || (result).status !== 1) {\n        throw new Error('Unexpected query result');\n      }\n    } catch (error) {\n      throw new Error(`Sequelize instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.ELASTIC_SEARCH]: async ({ client, name }: { client: ElasticsearchClient, name: string }) => {\n    try {\n      const isAlive = await client.ping();\n      if (!isAlive) {\n        throw new Error('Elasticsearch ping returned false');\n      }\n    } catch (error) {\n      throw new Error(`Elasticsearch instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.RABBIT]: async ({ client, name }: { client: RabbitMQClient, name: string }) => {\n    try {\n      const isConnected = await client.isConnected();\n      if (!isConnected) {\n        throw new Error('RabbitMQ is not connected');\n      }\n    } catch (error) {\n      throw new Error(`RabbitMQ instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n};"],"mappings":"+BASaA,EAAoH,EAC9HC,EAAAA,aAAa,OAAQ,MAAO,CAAE,SAAQ,UAAkD,CACvF,GAAI,CACF,MAAM,EAAO,MAAM,OACZ,EAAO,CACd,MAAU,MAAM,mBAAmB,EAAK,iBAAiB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGrHA,EAAAA,aAAa,WAAY,MAAO,CAAE,SAAQ,UAAsD,CAC/F,GAAI,CACF,GAAM,CAAC,CAAC,IAAW,MAAM,EAAO,MAAM,qBAAqB,CAC3D,GAAI,CAAC,GAAW,EAAQ,SAAW,EACjC,MAAU,MAAM,0BAA0B,OAErC,EAAO,CACd,MAAU,MAAM,uBAAuB,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGjIA,EAAAA,aAAa,gBAAiB,MAAO,CAAE,SAAQ,UAA0D,CACxG,GAAI,CAEF,GAAI,CADY,MAAM,EAAO,MAAM,CAEjC,MAAU,MAAM,oCAAoC,OAE/C,EAAO,CACd,MAAU,MAAM,2BAA2B,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGrIA,EAAAA,aAAa,QAAS,MAAO,CAAE,SAAQ,UAAqD,CAC3F,GAAI,CAEF,GAAI,CADgB,MAAM,EAAO,aAAa,CAE5C,MAAU,MAAM,4BAA4B,OAEvC,EAAO,CACd,MAAU,MAAM,sBAAsB,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,GAGlI"}

package/lib/health-manager/health-check-handlers.js

@@ -0,0 +1,2 @@
+import{CLIENT_TYPES as e}from"./types.js";const t={[e.REDIS]:async({client:e,name:t})=>{try{await e.ping()}catch(e){throw Error(`Redis instance '${t}' ping failed: ${e instanceof Error?e.message:String(e)}`)}},[e.SEQUELIZE]:async({client:e,name:t})=>{try{let[[t]]=await e.query(`SELECT 1 as status`);if(!t||t.status!==1)throw Error(`Unexpected query result`)}catch(e){throw Error(`Sequelize instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}},[e.ELASTIC_SEARCH]:async({client:e,name:t})=>{try{if(!await e.ping())throw Error(`Elasticsearch ping returned false`)}catch(e){throw Error(`Elasticsearch instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}},[e.RABBIT]:async({client:e,name:t})=>{try{if(!await e.isConnected())throw Error(`RabbitMQ is not connected`)}catch(e){throw Error(`RabbitMQ instance '${t}' health check failed: ${e instanceof Error?e.message:String(e)}`)}}};export{t as DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP};
+//# sourceMappingURL=health-check-handlers.js.map

package/lib/health-manager/health-check-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-handlers.js","names":["DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP: Partial<Record<ClientType, (options: { client: any, name: string }) => any>>"],"sources":["../../src/health-manager/health-check-handlers.ts"],"sourcesContent":["import type {\n  RedisClient,\n  SequelizeClient,\n  ElasticsearchClient,\n  RabbitMQClient,\n  ClientType,\n} from './types';\nimport { CLIENT_TYPES } from './types';\n\nexport const DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP: Partial<Record<ClientType, (options: { client: any, name: string }) => any>> = {\n  [CLIENT_TYPES.REDIS]: async ({ client, name }: { client: RedisClient, name: string }) => {\n    try {\n      await client.ping();\n    } catch (error) {\n      throw new Error(`Redis instance '${name}' ping failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.SEQUELIZE]: async ({ client, name }: { client: SequelizeClient, name: string }) => {\n    try {\n      const [[result]] = await client.query('SELECT 1 as status');\n      if (!result || (result).status !== 1) {\n        throw new Error('Unexpected query result');\n      }\n    } catch (error) {\n      throw new Error(`Sequelize instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.ELASTIC_SEARCH]: async ({ client, name }: { client: ElasticsearchClient, name: string }) => {\n    try {\n      const isAlive = await client.ping();\n      if (!isAlive) {\n        throw new Error('Elasticsearch ping returned false');\n      }\n    } catch (error) {\n      throw new Error(`Elasticsearch instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n  [CLIENT_TYPES.RABBIT]: async ({ client, name }: { client: RabbitMQClient, name: string }) => {\n    try {\n      const isConnected = await client.isConnected();\n      if (!isConnected) {\n        throw new Error('RabbitMQ is not connected');\n      }\n    } catch (error) {\n      throw new Error(`RabbitMQ instance '${name}' health check failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  },\n};"],"mappings":"0CASA,MAAaA,EAAoH,EAC9H,EAAa,OAAQ,MAAO,CAAE,SAAQ,UAAkD,CACvF,GAAI,CACF,MAAM,EAAO,MAAM,OACZ,EAAO,CACd,MAAU,MAAM,mBAAmB,EAAK,iBAAiB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGrH,EAAa,WAAY,MAAO,CAAE,SAAQ,UAAsD,CAC/F,GAAI,CACF,GAAM,CAAC,CAAC,IAAW,MAAM,EAAO,MAAM,qBAAqB,CAC3D,GAAI,CAAC,GAAW,EAAQ,SAAW,EACjC,MAAU,MAAM,0BAA0B,OAErC,EAAO,CACd,MAAU,MAAM,uBAAuB,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGjI,EAAa,gBAAiB,MAAO,CAAE,SAAQ,UAA0D,CACxG,GAAI,CAEF,GAAI,CADY,MAAM,EAAO,MAAM,CAEjC,MAAU,MAAM,oCAAoC,OAE/C,EAAO,CACd,MAAU,MAAM,2BAA2B,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,IAGrI,EAAa,QAAS,MAAO,CAAE,SAAQ,UAAqD,CAC3F,GAAI,CAEF,GAAI,CADgB,MAAM,EAAO,aAAa,CAE5C,MAAU,MAAM,4BAA4B,OAEvC,EAAO,CACd,MAAU,MAAM,sBAAsB,EAAK,yBAAyB,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,GAGlI"}

package/lib/health-manager/health-manager.cjs

@@ -0,0 +1,2 @@
+const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`./health-check-handlers.cjs`),n=require(`./shutdown-handlers.cjs`),r=require(`../utils.cjs`);let i=require(`node:timers/promises`),a=require(`@autofleet/errors`);var o=class{constructor(e){this.DEFAULT_CLIENT_OPTIONS={includeInLivenessCheck:!0,includeInReadinessCheck:!0},this.DEFAULT_SERVER_OPTIONS={runDefaultShutdownHandler:!0,name:`server`},this.DEFAULT_CONFIG={shutdownDelayMs:5e3,useExit0:!0,shouldSetupSignalHandlers:!0,livenessPeriodMs:1e4,readinessPeriodMs:5e3,enableLivenessOptimization:!0},this.isShuttingDown=!1,this.isReady=!1,this.livenessOptimizationEnabled=!1,this.clientsMap=new Map,this.livenessChecks=[],this.readinessChecks=[],this.config={...this.DEFAULT_CONFIG,...e.config??{}},this.logger=e.logger,e.server&&this.attachServer(e.server),this.storeClientsWithDefaults(e),this.initializeHealthChecks(),this.config.shouldSetupSignalHandlers&&this.setupSignalHandlers()}storeClientsWithDefaults(e){let r=e.clients;r&&Object.entries(r).forEach(([e,r])=>{if(!r)return;let i=(Array.isArray(r)?r:[r]).map(r=>{let i={...this.DEFAULT_CLIENT_OPTIONS,name:e,...r.options},a=t.DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP[e],o=r.healthCheck??(a?()=>a({client:r.connection,name:i.name}):void 0),s=n.DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP[e],c=r.shutdown??(s?e=>s({client:r.connection,signal:e,name:i.name}):void 0);return{connection:r.connection,healthCheck:o,shutdown:c,options:i}});this.clientsMap.set(e,i)})}setupSignalHandlers(){this.logger.info(`Setting up global signal listeners for graceful shutdown`),process.on(`SIGTERM`,async()=>{await this.shutdown(`SIGTERM`)}),process.on(`SIGINT`,async()=>{await this.shutdown(`SIGINT`)})}initializeHealthChecks(){let e=!0;this.clientsMap.forEach(t=>{t.forEach(t=>{if(!t.healthCheck)return;let n=t.options?.includeInLivenessCheck??!0,r=t.options?.includeInReadinessCheck??!0;(!n||!r)&&(e=!1),n&&this.livenessChecks.push(t.healthCheck),r&&this.readinessChecks.push(t.healthCheck)})}),this.livenessOptimizationEnabled=(this.config.enableLivenessOptimization??!0)&&e,this.livenessOptimizationEnabled&&this.logger.info(`Liveness check optimization enabled - liveness checks will be skipped when pod is ready`)}attachServer(e){this.server={server:e.server,shutdown:e.shutdown??(async()=>n.defaultServerShutdownHandler(e.server)),options:{...this.DEFAULT_SERVER_OPTIONS,...e.options??{}}}}async aliveCheck(){if(this.isShuttingDown||this.livenessOptimizationEnabled&&this.isReady)return{statusCode:200,status:`ok`};try{let e=Promise.all(this.livenessChecks.map(e=>e()));return await Promise.race([e,r.timeoutPromise(this.config.livenessPeriodMs??1e4,`Liveness check timed out`)]),{statusCode:200,status:`ok`}}catch(e){throw new a.ServiceUnavailableError(e instanceof Error?e.message:String(e))}}async readyCheck(){if(this.isShuttingDown)throw this.isReady=!1,new a.ServiceUnavailableError(`Application is shutting down`);try{let e=Promise.all(this.readinessChecks.map(e=>e()));return await Promise.race([e,r.timeoutPromise(this.config.readinessPeriodMs??5e3,`Readiness check timed out`)]),this.isReady=!0,{statusCode:200,status:`ok`}}catch(e){throw this.isReady=!1,new a.ServiceUnavailableError(e instanceof Error?e.message:String(e))}}async shutdown(e=`MANUAL`){if(this.isShuttingDown){this.logger.warn(`Shutdown already in progress`);return}let{shutdownDelayMs:t,useExit0:n,onShutdown:r,beforeShutdown:a}=this.config;this.isShuttingDown=!0,this.isReady=!1,this.logger.info(`${e} received: setting readiness state to false`),await a?.(),this.logger.info(`Waiting ${t}ms before shutdown...`),await(0,i.setTimeout)(t),this.logger.info(`Executing shutdown hooks...`);let o=[];this.clientsMap.forEach(e=>{e.forEach(e=>{e.shutdown&&o.push(e.shutdown())})}),await Promise.allSettled(o),await r?.(),this.server?.options?.runDefaultShutdownHandler&&(this.logger.info(`Shutting down server...`),await this.server?.shutdown?.()),this.logger.info(`Shutdown process completed`),n&&(this.logger.info(`Exiting process after ${e}`),process.exit(0))}};exports.HealthManager=o;
+//# sourceMappingURL=health-manager.cjs.map

package/lib/health-manager/health-manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-manager.cjs","names":["client","DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP","DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP","defaultServerShutdownHandler","timeoutPromise","ServiceUnavailableError","shutdownPromises: Promise<any>[]"],"sources":["../../src/health-manager/health-manager.ts"],"sourcesContent":["import { setTimeout } from 'node:timers/promises';\nimport { ServiceUnavailableError } from '@autofleet/errors';\nimport type {\n  ClientConfig,\n  HealthManagerConfig,\n  HealthManagerOptions,\n  ClientType,\n  ServerConfig,\n} from './types';\nimport { DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP } from './health-check-handlers';\nimport { DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP, defaultServerShutdownHandler } from './shutdown-handlers';\nimport { timeoutPromise } from '../utils';\n\n/**\n * Manages application health state and graceful shutdown for Kubernetes liveness/readiness probes\n *\n * Features:\n * - Provides /alive (liveness) and /ready (readiness) endpoint handlers\n * - Auto-registers SIGTERM/SIGINT handlers for graceful shutdown\n * - Manages ready state during shutdown to fail readiness probes\n */\nexport class HealthManager {\n  private readonly DEFAULT_CLIENT_OPTIONS = {\n    includeInLivenessCheck: true,\n    includeInReadinessCheck: true,\n  };\n\n  private readonly DEFAULT_SERVER_OPTIONS = {\n    runDefaultShutdownHandler: true,\n    name: 'server',\n  };\n\n  private readonly DEFAULT_CONFIG: HealthManagerConfig = {\n    shutdownDelayMs: 5_000,\n    useExit0: true,\n    shouldSetupSignalHandlers: true,\n    livenessPeriodMs: 10_000,\n    readinessPeriodMs: 5_000,\n    enableLivenessOptimization: true,\n  };\n\n  private isShuttingDown: boolean = false;\n  private isReady: boolean = false;\n  private livenessOptimizationEnabled: boolean = false;\n\n  private config: HealthManagerConfig;\n\n  private clientsMap: Map<string, ClientConfig<any>[]> = new Map();\n  private server: Required<ServerConfig> | undefined;\n\n  private livenessChecks: Array<() => Promise<void>> = [];\n  private readinessChecks: Array<() => Promise<void>> = [];\n\n  private logger: any;\n\n  /**\n   * Creates a new HealthManager instance\n   *\n   * @param params Configuration options for health checks and shutdown behavior\n   */\n  constructor(params: HealthManagerOptions) {\n    this.config = {\n      ...this.DEFAULT_CONFIG,\n      ...(params.config ?? {}),\n    };\n\n    this.logger = params.logger;\n    if (params.server) {\n      this.attachServer(params.server);\n    }\n\n    this.storeClientsWithDefaults(params);\n\n    this.initializeHealthChecks();\n\n    if (this.config.shouldSetupSignalHandlers) {\n      this.setupSignalHandlers();\n    }\n  }\n\n  /**\n   * Store clients with default health check and shutdown functions\n   * @private\n   */\n  private storeClientsWithDefaults(params: HealthManagerOptions): void {\n    const clients = params.clients;\n    if (!clients) {\n      return;\n    }\n\n    Object.entries(clients).forEach(([type, client]) => {\n      if (!client) {\n        return;\n      }\n\n      const clientsArray = Array.isArray(client) ? client : [client];\n\n      // Apply default values to each client config\n      const clientsWithDefaults = clientsArray.map((client) => {\n        const options = {\n          ...this.DEFAULT_CLIENT_OPTIONS,\n          name: type,\n          ...client.options,\n        };\n\n        const defaultHealthCheck = DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP[type as ClientType];\n        const healthCheck = client.healthCheck ?? (defaultHealthCheck ? () => defaultHealthCheck({ client: client.connection, name: options.name }) : undefined);\n\n        const defaultShutdown = DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP[type as ClientType];\n        const shutdown = client.shutdown ?? (defaultShutdown ? (signal?: string) => defaultShutdown({ client: client.connection, signal, name: options.name }) : undefined);\n\n        return {\n          connection: client.connection,\n          healthCheck,\n          shutdown,\n          options,\n        };\n      });\n\n      this.clientsMap.set(type, clientsWithDefaults);\n    });\n  }\n\n  /**\n   * Register SIGTERM and SIGINT listeners handlers\n   * @private\n   */\n  private setupSignalHandlers(): void {\n    this.logger.info('Setting up global signal listeners for graceful shutdown');\n\n    process.on('SIGTERM', async () => {\n      await this.shutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.shutdown('SIGINT');\n    });\n  }\n\n  /**\n   * Initialize health check arrays based on configured clients\n   * @private\n   */\n  private initializeHealthChecks(): void {\n    let allClientsInBothChecks = true;\n\n    this.clientsMap.forEach((clients) => {\n      clients.forEach((client) => {\n        if (!client.healthCheck) {\n          return;\n        }\n\n        const includeInLiveness = client.options?.includeInLivenessCheck ?? true;\n        const includeInReadiness = client.options?.includeInReadinessCheck ?? true;\n\n        // Check if all clients are included in both checks\n        if (!includeInLiveness || !includeInReadiness) {\n          allClientsInBothChecks = false;\n        }\n\n        if (includeInLiveness) {\n          this.livenessChecks.push(client.healthCheck);\n        }\n\n        if (includeInReadiness) {\n          this.readinessChecks.push(client.healthCheck);\n        }\n      });\n    });\n\n    // Enable optimization if configured and all clients are in both checks\n    this.livenessOptimizationEnabled =\n      (this.config.enableLivenessOptimization ?? true) &&\n      allClientsInBothChecks;\n\n    if (this.livenessOptimizationEnabled) {\n      this.logger.info('Liveness check optimization enabled - liveness checks will be skipped when pod is ready');\n    }\n  }\n\n  /**\n   * Attach an HTTP or HTTPS server to be managed during shutdown\n   * @param serverConfig \n   */\n  attachServer(serverConfig: ServerConfig): void {\n    this.server = {\n      server: serverConfig.server,\n      shutdown: serverConfig.shutdown ?? (async () => defaultServerShutdownHandler(serverConfig.server)),\n      options: {\n        ...this.DEFAULT_SERVER_OPTIONS,\n        ...(serverConfig.options ?? {}),\n      },\n    };\n  }\n\n  /**\n   * Performs health checks for all configured clients\n   *\n   * @returns Promise that resolves to { status: 'ok' } on success\n   * @throws Error with statusCode 503 if any health check fails\n   */\n  async aliveCheck(): Promise<{ status: string, statusCode: number }> {\n    if (this.isShuttingDown) {\n      return { statusCode: 200, status: 'ok' };\n    }\n\n    // Skip liveness check if optimization is enabled and pod is already ready\n    if (this.livenessOptimizationEnabled && this.isReady) {\n      return { statusCode: 200, status: 'ok' };\n    }\n\n    try {\n      const livenessPromises = Promise.all(this.livenessChecks.map(check => check()));\n\n      await Promise.race([\n        livenessPromises,\n        timeoutPromise(this.config.livenessPeriodMs ?? 10_000, 'Liveness check timed out'),\n      ]);\n\n      return { statusCode: 200, status: 'ok' };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ServiceUnavailableError(message);\n    }\n  }\n\n  /**\n   * Performs readiness check\n   *\n   * @returns Promise that resolves to { status: 'ok' } if ready\n   * @throws Error with statusCode 503 if not ready or health check fails\n   */\n  async readyCheck(): Promise<{ status: string, statusCode: number }> {\n    if (this.isShuttingDown) {\n      this.isReady = false;\n      throw new ServiceUnavailableError('Application is shutting down');\n    }\n\n    try {\n      const readinessPromises = Promise.all(this.readinessChecks.map(check => check()));\n\n      await Promise.race([\n        readinessPromises,\n        timeoutPromise(this.config.readinessPeriodMs ?? 5_000, 'Readiness check timed out'),\n      ]);\n      this.isReady = true;\n\n      return { statusCode: 200, status: 'ok' };\n    } catch (error) {\n      this.isReady = false;\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ServiceUnavailableError(message);\n    }\n  }\n\n  /**\n   * Manually trigger graceful shutdown\n   * Can be called manually or via signal handlers\n   *\n   * @param signal - Signal name (e.g., 'SIGTERM', 'SIGINT', 'MANUAL')\n   */\n  async shutdown(signal: string = 'MANUAL'): Promise<void> {\n    if (this.isShuttingDown) {\n      this.logger.warn('Shutdown already in progress');\n      return;\n    }\n\n    const { shutdownDelayMs, useExit0, onShutdown, beforeShutdown } = this.config;\n\n    this.isShuttingDown = true;\n    this.isReady = false;\n\n    this.logger.info(`${signal} received: setting readiness state to false`);\n\n    await beforeShutdown?.();\n\n    this.logger.info(`Waiting ${shutdownDelayMs}ms before shutdown...`);\n    await setTimeout(shutdownDelayMs)\n\n    this.logger.info('Executing shutdown hooks...');\n\n    const shutdownPromises: Promise<any>[] = [];\n    this.clientsMap.forEach((clients) => {\n      clients.forEach((client) => {\n        if (client.shutdown) {\n          shutdownPromises.push(client.shutdown());\n        }\n      });\n    });\n\n    await Promise.allSettled(shutdownPromises);\n\n    await onShutdown?.();\n\n    if (this.server?.options?.runDefaultShutdownHandler) {\n      this.logger.info('Shutting down server...');\n      await this.server?.shutdown?.();\n    }\n\n    this.logger.info('Shutdown process completed');\n\n    if (useExit0) {\n      this.logger.info(`Exiting process after ${signal}`);\n      process.exit(0);\n    }\n  }\n}"],"mappings":"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"}

package/lib/health-manager/health-manager.d.cts

@@ -0,0 +1,82 @@
+import { HealthManagerOptions, ServerConfig } from "./types.cjs";
+
+//#region src/health-manager/health-manager.d.ts
+
+/**
+* Manages application health state and graceful shutdown for Kubernetes liveness/readiness probes
+*
+* Features:
+* - Provides /alive (liveness) and /ready (readiness) endpoint handlers
+* - Auto-registers SIGTERM/SIGINT handlers for graceful shutdown
+* - Manages ready state during shutdown to fail readiness probes
+*/
+declare class HealthManager {
+  private readonly DEFAULT_CLIENT_OPTIONS;
+  private readonly DEFAULT_SERVER_OPTIONS;
+  private readonly DEFAULT_CONFIG;
+  private isShuttingDown;
+  private isReady;
+  private livenessOptimizationEnabled;
+  private config;
+  private clientsMap;
+  private server;
+  private livenessChecks;
+  private readinessChecks;
+  private logger;
+  /**
+  * Creates a new HealthManager instance
+  *
+  * @param params Configuration options for health checks and shutdown behavior
+  */
+  constructor(params: HealthManagerOptions);
+  /**
+  * Store clients with default health check and shutdown functions
+  * @private
+  */
+  private storeClientsWithDefaults;
+  /**
+  * Register SIGTERM and SIGINT listeners handlers
+  * @private
+  */
+  private setupSignalHandlers;
+  /**
+  * Initialize health check arrays based on configured clients
+  * @private
+  */
+  private initializeHealthChecks;
+  /**
+  * Attach an HTTP or HTTPS server to be managed during shutdown
+  * @param serverConfig 
+  */
+  attachServer(serverConfig: ServerConfig): void;
+  /**
+  * Performs health checks for all configured clients
+  *
+  * @returns Promise that resolves to { status: 'ok' } on success
+  * @throws Error with statusCode 503 if any health check fails
+  */
+  aliveCheck(): Promise<{
+    status: string;
+    statusCode: number;
+  }>;
+  /**
+  * Performs readiness check
+  *
+  * @returns Promise that resolves to { status: 'ok' } if ready
+  * @throws Error with statusCode 503 if not ready or health check fails
+  */
+  readyCheck(): Promise<{
+    status: string;
+    statusCode: number;
+  }>;
+  /**
+  * Manually trigger graceful shutdown
+  * Can be called manually or via signal handlers
+  *
+  * @param signal - Signal name (e.g., 'SIGTERM', 'SIGINT', 'MANUAL')
+  */
+  shutdown(signal?: string): Promise<void>;
+}
+//#endregion
+export { HealthManager };
+//# sourceMappingURL=health-manager.d.cts.map

package/lib/health-manager/health-manager.d.ts

@@ -0,0 +1,82 @@
+import { HealthManagerOptions, ServerConfig } from "./types.js";
+
+//#region src/health-manager/health-manager.d.ts
+
+/**
+* Manages application health state and graceful shutdown for Kubernetes liveness/readiness probes
+*
+* Features:
+* - Provides /alive (liveness) and /ready (readiness) endpoint handlers
+* - Auto-registers SIGTERM/SIGINT handlers for graceful shutdown
+* - Manages ready state during shutdown to fail readiness probes
+*/
+declare class HealthManager {
+  private readonly DEFAULT_CLIENT_OPTIONS;
+  private readonly DEFAULT_SERVER_OPTIONS;
+  private readonly DEFAULT_CONFIG;
+  private isShuttingDown;
+  private isReady;
+  private livenessOptimizationEnabled;
+  private config;
+  private clientsMap;
+  private server;
+  private livenessChecks;
+  private readinessChecks;
+  private logger;
+  /**
+  * Creates a new HealthManager instance
+  *
+  * @param params Configuration options for health checks and shutdown behavior
+  */
+  constructor(params: HealthManagerOptions);
+  /**
+  * Store clients with default health check and shutdown functions
+  * @private
+  */
+  private storeClientsWithDefaults;
+  /**
+  * Register SIGTERM and SIGINT listeners handlers
+  * @private
+  */
+  private setupSignalHandlers;
+  /**
+  * Initialize health check arrays based on configured clients
+  * @private
+  */
+  private initializeHealthChecks;
+  /**
+  * Attach an HTTP or HTTPS server to be managed during shutdown
+  * @param serverConfig 
+  */
+  attachServer(serverConfig: ServerConfig): void;
+  /**
+  * Performs health checks for all configured clients
+  *
+  * @returns Promise that resolves to { status: 'ok' } on success
+  * @throws Error with statusCode 503 if any health check fails
+  */
+  aliveCheck(): Promise<{
+    status: string;
+    statusCode: number;
+  }>;
+  /**
+  * Performs readiness check
+  *
+  * @returns Promise that resolves to { status: 'ok' } if ready
+  * @throws Error with statusCode 503 if not ready or health check fails
+  */
+  readyCheck(): Promise<{
+    status: string;
+    statusCode: number;
+  }>;
+  /**
+  * Manually trigger graceful shutdown
+  * Can be called manually or via signal handlers
+  *
+  * @param signal - Signal name (e.g., 'SIGTERM', 'SIGINT', 'MANUAL')
+  */
+  shutdown(signal?: string): Promise<void>;
+}
+//#endregion
+export { HealthManager };
+//# sourceMappingURL=health-manager.d.ts.map

package/lib/health-manager/health-manager.js

@@ -0,0 +1,2 @@
+import{DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP as e}from"./health-check-handlers.js";import{DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP as t,defaultServerShutdownHandler as n}from"./shutdown-handlers.js";import{timeoutPromise as r}from"../utils.js";import{setTimeout as i}from"node:timers/promises";import{ServiceUnavailableError as a}from"@autofleet/errors";var o=class{constructor(e){this.DEFAULT_CLIENT_OPTIONS={includeInLivenessCheck:!0,includeInReadinessCheck:!0},this.DEFAULT_SERVER_OPTIONS={runDefaultShutdownHandler:!0,name:`server`},this.DEFAULT_CONFIG={shutdownDelayMs:5e3,useExit0:!0,shouldSetupSignalHandlers:!0,livenessPeriodMs:1e4,readinessPeriodMs:5e3,enableLivenessOptimization:!0},this.isShuttingDown=!1,this.isReady=!1,this.livenessOptimizationEnabled=!1,this.clientsMap=new Map,this.livenessChecks=[],this.readinessChecks=[],this.config={...this.DEFAULT_CONFIG,...e.config??{}},this.logger=e.logger,e.server&&this.attachServer(e.server),this.storeClientsWithDefaults(e),this.initializeHealthChecks(),this.config.shouldSetupSignalHandlers&&this.setupSignalHandlers()}storeClientsWithDefaults(n){let r=n.clients;r&&Object.entries(r).forEach(([n,r])=>{if(!r)return;let i=(Array.isArray(r)?r:[r]).map(r=>{let i={...this.DEFAULT_CLIENT_OPTIONS,name:n,...r.options},a=e[n],o=r.healthCheck??(a?()=>a({client:r.connection,name:i.name}):void 0),s=t[n],c=r.shutdown??(s?e=>s({client:r.connection,signal:e,name:i.name}):void 0);return{connection:r.connection,healthCheck:o,shutdown:c,options:i}});this.clientsMap.set(n,i)})}setupSignalHandlers(){this.logger.info(`Setting up global signal listeners for graceful shutdown`),process.on(`SIGTERM`,async()=>{await this.shutdown(`SIGTERM`)}),process.on(`SIGINT`,async()=>{await this.shutdown(`SIGINT`)})}initializeHealthChecks(){let e=!0;this.clientsMap.forEach(t=>{t.forEach(t=>{if(!t.healthCheck)return;let n=t.options?.includeInLivenessCheck??!0,r=t.options?.includeInReadinessCheck??!0;(!n||!r)&&(e=!1),n&&this.livenessChecks.push(t.healthCheck),r&&this.readinessChecks.push(t.healthCheck)})}),this.livenessOptimizationEnabled=(this.config.enableLivenessOptimization??!0)&&e,this.livenessOptimizationEnabled&&this.logger.info(`Liveness check optimization enabled - liveness checks will be skipped when pod is ready`)}attachServer(e){this.server={server:e.server,shutdown:e.shutdown??(async()=>n(e.server)),options:{...this.DEFAULT_SERVER_OPTIONS,...e.options??{}}}}async aliveCheck(){if(this.isShuttingDown||this.livenessOptimizationEnabled&&this.isReady)return{statusCode:200,status:`ok`};try{let e=Promise.all(this.livenessChecks.map(e=>e()));return await Promise.race([e,r(this.config.livenessPeriodMs??1e4,`Liveness check timed out`)]),{statusCode:200,status:`ok`}}catch(e){throw new a(e instanceof Error?e.message:String(e))}}async readyCheck(){if(this.isShuttingDown)throw this.isReady=!1,new a(`Application is shutting down`);try{let e=Promise.all(this.readinessChecks.map(e=>e()));return await Promise.race([e,r(this.config.readinessPeriodMs??5e3,`Readiness check timed out`)]),this.isReady=!0,{statusCode:200,status:`ok`}}catch(e){throw this.isReady=!1,new a(e instanceof Error?e.message:String(e))}}async shutdown(e=`MANUAL`){if(this.isShuttingDown){this.logger.warn(`Shutdown already in progress`);return}let{shutdownDelayMs:t,useExit0:n,onShutdown:r,beforeShutdown:a}=this.config;this.isShuttingDown=!0,this.isReady=!1,this.logger.info(`${e} received: setting readiness state to false`),await a?.(),this.logger.info(`Waiting ${t}ms before shutdown...`),await i(t),this.logger.info(`Executing shutdown hooks...`);let o=[];this.clientsMap.forEach(e=>{e.forEach(e=>{e.shutdown&&o.push(e.shutdown())})}),await Promise.allSettled(o),await r?.(),this.server?.options?.runDefaultShutdownHandler&&(this.logger.info(`Shutting down server...`),await this.server?.shutdown?.()),this.logger.info(`Shutdown process completed`),n&&(this.logger.info(`Exiting process after ${e}`),process.exit(0))}};export{o as HealthManager};
+//# sourceMappingURL=health-manager.js.map

package/lib/health-manager/health-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-manager.js","names":["client","shutdownPromises: Promise<any>[]"],"sources":["../../src/health-manager/health-manager.ts"],"sourcesContent":["import { setTimeout } from 'node:timers/promises';\nimport { ServiceUnavailableError } from '@autofleet/errors';\nimport type {\n  ClientConfig,\n  HealthManagerConfig,\n  HealthManagerOptions,\n  ClientType,\n  ServerConfig,\n} from './types';\nimport { DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP } from './health-check-handlers';\nimport { DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP, defaultServerShutdownHandler } from './shutdown-handlers';\nimport { timeoutPromise } from '../utils';\n\n/**\n * Manages application health state and graceful shutdown for Kubernetes liveness/readiness probes\n *\n * Features:\n * - Provides /alive (liveness) and /ready (readiness) endpoint handlers\n * - Auto-registers SIGTERM/SIGINT handlers for graceful shutdown\n * - Manages ready state during shutdown to fail readiness probes\n */\nexport class HealthManager {\n  private readonly DEFAULT_CLIENT_OPTIONS = {\n    includeInLivenessCheck: true,\n    includeInReadinessCheck: true,\n  };\n\n  private readonly DEFAULT_SERVER_OPTIONS = {\n    runDefaultShutdownHandler: true,\n    name: 'server',\n  };\n\n  private readonly DEFAULT_CONFIG: HealthManagerConfig = {\n    shutdownDelayMs: 5_000,\n    useExit0: true,\n    shouldSetupSignalHandlers: true,\n    livenessPeriodMs: 10_000,\n    readinessPeriodMs: 5_000,\n    enableLivenessOptimization: true,\n  };\n\n  private isShuttingDown: boolean = false;\n  private isReady: boolean = false;\n  private livenessOptimizationEnabled: boolean = false;\n\n  private config: HealthManagerConfig;\n\n  private clientsMap: Map<string, ClientConfig<any>[]> = new Map();\n  private server: Required<ServerConfig> | undefined;\n\n  private livenessChecks: Array<() => Promise<void>> = [];\n  private readinessChecks: Array<() => Promise<void>> = [];\n\n  private logger: any;\n\n  /**\n   * Creates a new HealthManager instance\n   *\n   * @param params Configuration options for health checks and shutdown behavior\n   */\n  constructor(params: HealthManagerOptions) {\n    this.config = {\n      ...this.DEFAULT_CONFIG,\n      ...(params.config ?? {}),\n    };\n\n    this.logger = params.logger;\n    if (params.server) {\n      this.attachServer(params.server);\n    }\n\n    this.storeClientsWithDefaults(params);\n\n    this.initializeHealthChecks();\n\n    if (this.config.shouldSetupSignalHandlers) {\n      this.setupSignalHandlers();\n    }\n  }\n\n  /**\n   * Store clients with default health check and shutdown functions\n   * @private\n   */\n  private storeClientsWithDefaults(params: HealthManagerOptions): void {\n    const clients = params.clients;\n    if (!clients) {\n      return;\n    }\n\n    Object.entries(clients).forEach(([type, client]) => {\n      if (!client) {\n        return;\n      }\n\n      const clientsArray = Array.isArray(client) ? client : [client];\n\n      // Apply default values to each client config\n      const clientsWithDefaults = clientsArray.map((client) => {\n        const options = {\n          ...this.DEFAULT_CLIENT_OPTIONS,\n          name: type,\n          ...client.options,\n        };\n\n        const defaultHealthCheck = DEFAULT_CLIENT_HEALTHCHECK_FUNC_MAP[type as ClientType];\n        const healthCheck = client.healthCheck ?? (defaultHealthCheck ? () => defaultHealthCheck({ client: client.connection, name: options.name }) : undefined);\n\n        const defaultShutdown = DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP[type as ClientType];\n        const shutdown = client.shutdown ?? (defaultShutdown ? (signal?: string) => defaultShutdown({ client: client.connection, signal, name: options.name }) : undefined);\n\n        return {\n          connection: client.connection,\n          healthCheck,\n          shutdown,\n          options,\n        };\n      });\n\n      this.clientsMap.set(type, clientsWithDefaults);\n    });\n  }\n\n  /**\n   * Register SIGTERM and SIGINT listeners handlers\n   * @private\n   */\n  private setupSignalHandlers(): void {\n    this.logger.info('Setting up global signal listeners for graceful shutdown');\n\n    process.on('SIGTERM', async () => {\n      await this.shutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.shutdown('SIGINT');\n    });\n  }\n\n  /**\n   * Initialize health check arrays based on configured clients\n   * @private\n   */\n  private initializeHealthChecks(): void {\n    let allClientsInBothChecks = true;\n\n    this.clientsMap.forEach((clients) => {\n      clients.forEach((client) => {\n        if (!client.healthCheck) {\n          return;\n        }\n\n        const includeInLiveness = client.options?.includeInLivenessCheck ?? true;\n        const includeInReadiness = client.options?.includeInReadinessCheck ?? true;\n\n        // Check if all clients are included in both checks\n        if (!includeInLiveness || !includeInReadiness) {\n          allClientsInBothChecks = false;\n        }\n\n        if (includeInLiveness) {\n          this.livenessChecks.push(client.healthCheck);\n        }\n\n        if (includeInReadiness) {\n          this.readinessChecks.push(client.healthCheck);\n        }\n      });\n    });\n\n    // Enable optimization if configured and all clients are in both checks\n    this.livenessOptimizationEnabled =\n      (this.config.enableLivenessOptimization ?? true) &&\n      allClientsInBothChecks;\n\n    if (this.livenessOptimizationEnabled) {\n      this.logger.info('Liveness check optimization enabled - liveness checks will be skipped when pod is ready');\n    }\n  }\n\n  /**\n   * Attach an HTTP or HTTPS server to be managed during shutdown\n   * @param serverConfig \n   */\n  attachServer(serverConfig: ServerConfig): void {\n    this.server = {\n      server: serverConfig.server,\n      shutdown: serverConfig.shutdown ?? (async () => defaultServerShutdownHandler(serverConfig.server)),\n      options: {\n        ...this.DEFAULT_SERVER_OPTIONS,\n        ...(serverConfig.options ?? {}),\n      },\n    };\n  }\n\n  /**\n   * Performs health checks for all configured clients\n   *\n   * @returns Promise that resolves to { status: 'ok' } on success\n   * @throws Error with statusCode 503 if any health check fails\n   */\n  async aliveCheck(): Promise<{ status: string, statusCode: number }> {\n    if (this.isShuttingDown) {\n      return { statusCode: 200, status: 'ok' };\n    }\n\n    // Skip liveness check if optimization is enabled and pod is already ready\n    if (this.livenessOptimizationEnabled && this.isReady) {\n      return { statusCode: 200, status: 'ok' };\n    }\n\n    try {\n      const livenessPromises = Promise.all(this.livenessChecks.map(check => check()));\n\n      await Promise.race([\n        livenessPromises,\n        timeoutPromise(this.config.livenessPeriodMs ?? 10_000, 'Liveness check timed out'),\n      ]);\n\n      return { statusCode: 200, status: 'ok' };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ServiceUnavailableError(message);\n    }\n  }\n\n  /**\n   * Performs readiness check\n   *\n   * @returns Promise that resolves to { status: 'ok' } if ready\n   * @throws Error with statusCode 503 if not ready or health check fails\n   */\n  async readyCheck(): Promise<{ status: string, statusCode: number }> {\n    if (this.isShuttingDown) {\n      this.isReady = false;\n      throw new ServiceUnavailableError('Application is shutting down');\n    }\n\n    try {\n      const readinessPromises = Promise.all(this.readinessChecks.map(check => check()));\n\n      await Promise.race([\n        readinessPromises,\n        timeoutPromise(this.config.readinessPeriodMs ?? 5_000, 'Readiness check timed out'),\n      ]);\n      this.isReady = true;\n\n      return { statusCode: 200, status: 'ok' };\n    } catch (error) {\n      this.isReady = false;\n      const message = error instanceof Error ? error.message : String(error);\n      throw new ServiceUnavailableError(message);\n    }\n  }\n\n  /**\n   * Manually trigger graceful shutdown\n   * Can be called manually or via signal handlers\n   *\n   * @param signal - Signal name (e.g., 'SIGTERM', 'SIGINT', 'MANUAL')\n   */\n  async shutdown(signal: string = 'MANUAL'): Promise<void> {\n    if (this.isShuttingDown) {\n      this.logger.warn('Shutdown already in progress');\n      return;\n    }\n\n    const { shutdownDelayMs, useExit0, onShutdown, beforeShutdown } = this.config;\n\n    this.isShuttingDown = true;\n    this.isReady = false;\n\n    this.logger.info(`${signal} received: setting readiness state to false`);\n\n    await beforeShutdown?.();\n\n    this.logger.info(`Waiting ${shutdownDelayMs}ms before shutdown...`);\n    await setTimeout(shutdownDelayMs)\n\n    this.logger.info('Executing shutdown hooks...');\n\n    const shutdownPromises: Promise<any>[] = [];\n    this.clientsMap.forEach((clients) => {\n      clients.forEach((client) => {\n        if (client.shutdown) {\n          shutdownPromises.push(client.shutdown());\n        }\n      });\n    });\n\n    await Promise.allSettled(shutdownPromises);\n\n    await onShutdown?.();\n\n    if (this.server?.options?.runDefaultShutdownHandler) {\n      this.logger.info('Shutting down server...');\n      await this.server?.shutdown?.();\n    }\n\n    this.logger.info('Shutdown process completed');\n\n    if (useExit0) {\n      this.logger.info(`Exiting process after ${signal}`);\n      process.exit(0);\n    }\n  }\n}"],"mappings":"4VAqBA,IAAa,EAAb,KAA2B,CAuCzB,YAAY,EAA8B,6BAtCA,CACxC,uBAAwB,GACxB,wBAAyB,GAC1B,6BAEyC,CACxC,0BAA2B,GAC3B,KAAM,SACP,qBAEsD,CACrD,gBAAiB,IACjB,SAAU,GACV,0BAA2B,GAC3B,iBAAkB,IAClB,kBAAmB,IACnB,2BAA4B,GAC7B,qBAEiC,gBACP,oCACoB,mBAIQ,IAAI,wBAGN,EAAE,sBACD,EAAE,CAUtD,KAAK,OAAS,CACZ,GAAG,KAAK,eACR,GAAI,EAAO,QAAU,EAAE,CACxB,CAED,KAAK,OAAS,EAAO,OACjB,EAAO,QACT,KAAK,aAAa,EAAO,OAAO,CAGlC,KAAK,yBAAyB,EAAO,CAErC,KAAK,wBAAwB,CAEzB,KAAK,OAAO,2BACd,KAAK,qBAAqB,CAQ9B,yBAAiC,EAAoC,CACnE,IAAM,EAAU,EAAO,QAClB,GAIL,OAAO,QAAQ,EAAQ,CAAC,SAAS,CAAC,EAAM,KAAY,CAClD,GAAI,CAAC,EACH,OAMF,IAAM,GAHe,MAAM,QAAQ,EAAO,CAAG,EAAS,CAAC,EAAO,EAGrB,IAAK,GAAW,CACvD,IAAM,EAAU,CACd,GAAG,KAAK,uBACR,KAAM,EACN,GAAGA,EAAO,QACX,CAEK,EAAqB,EAAoC,GACzD,EAAcA,EAAO,cAAgB,MAA2B,EAAmB,CAAE,OAAQA,EAAO,WAAY,KAAM,EAAQ,KAAM,CAAC,CAAG,IAAA,IAExI,EAAkB,EAAqC,GACvD,EAAWA,EAAO,WAAa,EAAmB,GAAoB,EAAgB,CAAE,OAAQA,EAAO,WAAY,SAAQ,KAAM,EAAQ,KAAM,CAAC,CAAG,IAAA,IAEzJ,MAAO,CACL,WAAYA,EAAO,WACnB,cACA,WACA,UACD,EACD,CAEF,KAAK,WAAW,IAAI,EAAM,EAAoB,EAC9C,CAOJ,qBAAoC,CAClC,KAAK,OAAO,KAAK,2DAA2D,CAE5E,QAAQ,GAAG,UAAW,SAAY,CAChC,MAAM,KAAK,SAAS,UAAU,EAC9B,CAEF,QAAQ,GAAG,SAAU,SAAY,CAC/B,MAAM,KAAK,SAAS,SAAS,EAC7B,CAOJ,wBAAuC,CACrC,IAAI,EAAyB,GAE7B,KAAK,WAAW,QAAS,GAAY,CACnC,EAAQ,QAAS,GAAW,CAC1B,GAAI,CAAC,EAAO,YACV,OAGF,IAAM,EAAoB,EAAO,SAAS,wBAA0B,GAC9D,EAAqB,EAAO,SAAS,yBAA2B,IAGlE,CAAC,GAAqB,CAAC,KACzB,EAAyB,IAGvB,GACF,KAAK,eAAe,KAAK,EAAO,YAAY,CAG1C,GACF,KAAK,gBAAgB,KAAK,EAAO,YAAY,EAE/C,EACF,CAGF,KAAK,6BACF,KAAK,OAAO,4BAA8B,KAC3C,EAEE,KAAK,6BACP,KAAK,OAAO,KAAK,0FAA0F,CAQ/G,aAAa,EAAkC,CAC7C,KAAK,OAAS,CACZ,OAAQ,EAAa,OACrB,SAAU,EAAa,WAAa,SAAY,EAA6B,EAAa,OAAO,EACjG,QAAS,CACP,GAAG,KAAK,uBACR,GAAI,EAAa,SAAW,EAAE,CAC/B,CACF,CASH,MAAM,YAA8D,CAMlE,GALI,KAAK,gBAKL,KAAK,6BAA+B,KAAK,QAC3C,MAAO,CAAE,WAAY,IAAK,OAAQ,KAAM,CAG1C,GAAI,CACF,IAAM,EAAmB,QAAQ,IAAI,KAAK,eAAe,IAAI,GAAS,GAAO,CAAC,CAAC,CAO/E,OALA,MAAM,QAAQ,KAAK,CACjB,EACA,EAAe,KAAK,OAAO,kBAAoB,IAAQ,2BAA2B,CACnF,CAAC,CAEK,CAAE,WAAY,IAAK,OAAQ,KAAM,OACjC,EAAO,CAEd,MAAM,IAAI,EADM,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAC5B,EAU9C,MAAM,YAA8D,CAClE,GAAI,KAAK,eAEP,KADA,MAAK,QAAU,GACT,IAAI,EAAwB,+BAA+B,CAGnE,GAAI,CACF,IAAM,EAAoB,QAAQ,IAAI,KAAK,gBAAgB,IAAI,GAAS,GAAO,CAAC,CAAC,CAQjF,OANA,MAAM,QAAQ,KAAK,CACjB,EACA,EAAe,KAAK,OAAO,mBAAqB,IAAO,4BAA4B,CACpF,CAAC,CACF,KAAK,QAAU,GAER,CAAE,WAAY,IAAK,OAAQ,KAAM,OACjC,EAAO,CAGd,KAFA,MAAK,QAAU,GAET,IAAI,EADM,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAC5B,EAU9C,MAAM,SAAS,EAAiB,SAAyB,CACvD,GAAI,KAAK,eAAgB,CACvB,KAAK,OAAO,KAAK,+BAA+B,CAChD,OAGF,GAAM,CAAE,kBAAiB,WAAU,aAAY,kBAAmB,KAAK,OAEvE,KAAK,eAAiB,GACtB,KAAK,QAAU,GAEf,KAAK,OAAO,KAAK,GAAG,EAAO,6CAA6C,CAExE,MAAM,KAAkB,CAExB,KAAK,OAAO,KAAK,WAAW,EAAgB,uBAAuB,CACnE,MAAM,EAAW,EAAgB,CAEjC,KAAK,OAAO,KAAK,8BAA8B,CAE/C,IAAMC,EAAmC,EAAE,CAC3C,KAAK,WAAW,QAAS,GAAY,CACnC,EAAQ,QAAS,GAAW,CACtB,EAAO,UACT,EAAiB,KAAK,EAAO,UAAU,CAAC,EAE1C,EACF,CAEF,MAAM,QAAQ,WAAW,EAAiB,CAE1C,MAAM,KAAc,CAEhB,KAAK,QAAQ,SAAS,4BACxB,KAAK,OAAO,KAAK,0BAA0B,CAC3C,MAAM,KAAK,QAAQ,YAAY,EAGjC,KAAK,OAAO,KAAK,6BAA6B,CAE1C,IACF,KAAK,OAAO,KAAK,yBAAyB,IAAS,CACnD,QAAQ,KAAK,EAAE"}

package/lib/health-manager/shutdown-handlers.cjs

@@ -0,0 +1,2 @@
+const e=require(`../_virtual/rolldown_runtime.cjs`),t=require(`../logger.cjs`),n=require(`./types.cjs`);let r=require(`http-terminator`);const i={[n.CLIENT_TYPES.REDIS]:async e=>{try{await e.client.quit?.()}catch(n){throw t.logger.error(`Failed to shutdown redis client '${e.name}': ${n instanceof Error?n.message:String(n)}`),n}},[n.CLIENT_TYPES.SEQUELIZE]:async e=>{try{await e.client.close?.()}catch(n){throw t.logger.error(`Failed to shutdown sequelize client '${e.name}': ${n instanceof Error?n.message:String(n)}`),n}},[n.CLIENT_TYPES.ELASTIC_SEARCH]:async e=>{try{await e.client.close?.()}catch(n){throw t.logger.error(`Failed to shutdown elasticsearch client '${e.name}': ${n instanceof Error?n.message:String(n)}`),n}},[n.CLIENT_TYPES.RABBIT]:async e=>{try{await e.client.gracefulShutdown?.(e.signal)}catch(n){throw t.logger.error(`Failed to shutdown rabbit client '${e.name}': ${n instanceof Error?n.message:String(n)}`),n}},[n.CLIENT_TYPES.EVENTS]:async e=>{try{await e.client.exitHandler?.()}catch(n){throw t.logger.error(`Failed to shutdown events client '${e.name}': ${n instanceof Error?n.message:String(n)}`),n}}},a=async e=>{try{await(0,r.createHttpTerminator)({server:e}).terminate()}catch(e){throw t.logger.error(`Failed to shutdown server: ${e instanceof Error?e.message:String(e)}`),e}};exports.DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP=i,exports.defaultServerShutdownHandler=a;
+//# sourceMappingURL=shutdown-handlers.cjs.map

package/lib/health-manager/shutdown-handlers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-handlers.cjs","names":["DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP: Record<ClientType, (client: any, signal?: string) => Promise<void>>","CLIENT_TYPES"],"sources":["../../src/health-manager/shutdown-handlers.ts"],"sourcesContent":["import {\n  createHttpTerminator,\n} from 'http-terminator';\nimport type { Server as HttpServer } from 'node:http';\nimport type { Server as HttpsServer } from 'node:https';\nimport type { ClientType } from './types';\nimport { CLIENT_TYPES } from './types';\nimport { logger } from '../logger';\nimport { P } from 'vitest/dist/chunks/worker.d.DadbA89M';\n\nexport const DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP: Record<ClientType, (client: any, signal?: string) => Promise<void>> = {\n  [CLIENT_TYPES.REDIS]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.quit?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown redis client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.SEQUELIZE]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.close?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown sequelize client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.ELASTIC_SEARCH]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.close?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown elasticsearch client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.RABBIT]: async (options: { client: any, signal?: string, name: string }) => {\n    try {\n      await options.client.gracefulShutdown?.(options.signal);\n    } catch (error) {\n      logger.error(`Failed to shutdown rabbit client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.EVENTS]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.exitHandler?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown events client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n};\n\nexport const defaultServerShutdownHandler = async (server: HttpServer | HttpsServer): Promise<void> => {\n  try {\n    const httpTerminator = createHttpTerminator({\n      server,\n    });\n    await httpTerminator.terminate();\n  } catch (error) {\n    logger.error(`Failed to shutdown server: ${error instanceof Error ? error.message : String(error)}`);\n    throw error;\n  }\n};"],"mappings":"yIAUA,MAAaA,EAA4G,EACtHC,EAAAA,aAAa,OAAQ,KAAO,IAA2C,CACtE,GAAI,CACF,MAAM,EAAQ,OAAO,QAAQ,OACtB,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,oCAAoC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACtH,KAGTA,EAAAA,aAAa,WAAY,KAAO,IAA2C,CAC1E,GAAI,CACF,MAAM,EAAQ,OAAO,SAAS,OACvB,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,wCAAwC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC1H,KAGTA,EAAAA,aAAa,gBAAiB,KAAO,IAA2C,CAC/E,GAAI,CACF,MAAM,EAAQ,OAAO,SAAS,OACvB,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,4CAA4C,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC9H,KAGTA,EAAAA,aAAa,QAAS,KAAO,IAA4D,CACxF,GAAI,CACF,MAAM,EAAQ,OAAO,mBAAmB,EAAQ,OAAO,OAChD,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,qCAAqC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACvH,KAGTA,EAAAA,aAAa,QAAS,KAAO,IAA2C,CACvE,GAAI,CACF,MAAM,EAAQ,OAAO,eAAe,OAC7B,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,qCAAqC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACvH,IAGX,CAEY,EAA+B,KAAO,IAAoD,CACrG,GAAI,CAIF,MAAA,EAAA,EAAA,sBAH4C,CAC1C,SACD,CAAC,CACmB,WAAW,OACzB,EAAO,CAEd,MADA,EAAA,OAAO,MAAM,8BAA8B,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC9F"}

package/lib/health-manager/shutdown-handlers.js

@@ -0,0 +1,2 @@
+import{logger as e}from"../logger.js";import{CLIENT_TYPES as t}from"./types.js";import{createHttpTerminator as n}from"http-terminator";const r={[t.REDIS]:async t=>{try{await t.client.quit?.()}catch(n){throw e.error(`Failed to shutdown redis client '${t.name}': ${n instanceof Error?n.message:String(n)}`),n}},[t.SEQUELIZE]:async t=>{try{await t.client.close?.()}catch(n){throw e.error(`Failed to shutdown sequelize client '${t.name}': ${n instanceof Error?n.message:String(n)}`),n}},[t.ELASTIC_SEARCH]:async t=>{try{await t.client.close?.()}catch(n){throw e.error(`Failed to shutdown elasticsearch client '${t.name}': ${n instanceof Error?n.message:String(n)}`),n}},[t.RABBIT]:async t=>{try{await t.client.gracefulShutdown?.(t.signal)}catch(n){throw e.error(`Failed to shutdown rabbit client '${t.name}': ${n instanceof Error?n.message:String(n)}`),n}},[t.EVENTS]:async t=>{try{await t.client.exitHandler?.()}catch(n){throw e.error(`Failed to shutdown events client '${t.name}': ${n instanceof Error?n.message:String(n)}`),n}}},i=async t=>{try{await n({server:t}).terminate()}catch(t){throw e.error(`Failed to shutdown server: ${t instanceof Error?t.message:String(t)}`),t}};export{r as DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP,i as defaultServerShutdownHandler};
+//# sourceMappingURL=shutdown-handlers.js.map

package/lib/health-manager/shutdown-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-handlers.js","names":["DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP: Record<ClientType, (client: any, signal?: string) => Promise<void>>"],"sources":["../../src/health-manager/shutdown-handlers.ts"],"sourcesContent":["import {\n  createHttpTerminator,\n} from 'http-terminator';\nimport type { Server as HttpServer } from 'node:http';\nimport type { Server as HttpsServer } from 'node:https';\nimport type { ClientType } from './types';\nimport { CLIENT_TYPES } from './types';\nimport { logger } from '../logger';\nimport { P } from 'vitest/dist/chunks/worker.d.DadbA89M';\n\nexport const DEFAULT_CLIENT_SHUTDOWN_HANDLERS_MAP: Record<ClientType, (client: any, signal?: string) => Promise<void>> = {\n  [CLIENT_TYPES.REDIS]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.quit?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown redis client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.SEQUELIZE]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.close?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown sequelize client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.ELASTIC_SEARCH]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.close?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown elasticsearch client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.RABBIT]: async (options: { client: any, signal?: string, name: string }) => {\n    try {\n      await options.client.gracefulShutdown?.(options.signal);\n    } catch (error) {\n      logger.error(`Failed to shutdown rabbit client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n  [CLIENT_TYPES.EVENTS]: async (options: { client: any, name: string }) => {\n    try {\n      await options.client.exitHandler?.();\n    } catch (error) {\n      logger.error(`Failed to shutdown events client '${options.name}': ${error instanceof Error ? error.message : String(error)}`);\n      throw error;\n    }\n  },\n};\n\nexport const defaultServerShutdownHandler = async (server: HttpServer | HttpsServer): Promise<void> => {\n  try {\n    const httpTerminator = createHttpTerminator({\n      server,\n    });\n    await httpTerminator.terminate();\n  } catch (error) {\n    logger.error(`Failed to shutdown server: ${error instanceof Error ? error.message : String(error)}`);\n    throw error;\n  }\n};"],"mappings":"uIAUA,MAAaA,EAA4G,EACtH,EAAa,OAAQ,KAAO,IAA2C,CACtE,GAAI,CACF,MAAM,EAAQ,OAAO,QAAQ,OACtB,EAAO,CAEd,MADA,EAAO,MAAM,oCAAoC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACtH,KAGT,EAAa,WAAY,KAAO,IAA2C,CAC1E,GAAI,CACF,MAAM,EAAQ,OAAO,SAAS,OACvB,EAAO,CAEd,MADA,EAAO,MAAM,wCAAwC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC1H,KAGT,EAAa,gBAAiB,KAAO,IAA2C,CAC/E,GAAI,CACF,MAAM,EAAQ,OAAO,SAAS,OACvB,EAAO,CAEd,MADA,EAAO,MAAM,4CAA4C,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC9H,KAGT,EAAa,QAAS,KAAO,IAA4D,CACxF,GAAI,CACF,MAAM,EAAQ,OAAO,mBAAmB,EAAQ,OAAO,OAChD,EAAO,CAEd,MADA,EAAO,MAAM,qCAAqC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACvH,KAGT,EAAa,QAAS,KAAO,IAA2C,CACvE,GAAI,CACF,MAAM,EAAQ,OAAO,eAAe,OAC7B,EAAO,CAEd,MADA,EAAO,MAAM,qCAAqC,EAAQ,KAAK,KAAK,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CACvH,IAGX,CAEY,EAA+B,KAAO,IAAoD,CACrG,GAAI,CAIF,MAHuB,EAAqB,CAC1C,SACD,CAAC,CACmB,WAAW,OACzB,EAAO,CAEd,MADA,EAAO,MAAM,8BAA8B,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,GAAG,CAC9F"}

package/lib/health-manager/types.cjs

@@ -0,0 +1,2 @@
+const e={RABBIT:`rabbit`,SEQUELIZE:`sequelize`,REDIS:`redis`,ELASTIC_SEARCH:`elasticsearch`,EVENTS:`events`};exports.CLIENT_TYPES=e;
+//# sourceMappingURL=types.cjs.map

package/lib/health-manager/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/health-manager/types.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\nimport type { Server as HttpServer } from 'node:http';\nimport type { Server as HttpsServer } from 'node:https';\n\n\n/**\n * Configuration for a single client (e.g., rabbit, sequelize, redis, elasticsearch)\n * Allows custom health checks and shutdown logic\n */\nexport interface ClientConfig<T = any> {\n  /** The actual connection instance */\n  connection: T;\n\n  /** Custom health check function (optional) - will be called during alive/ready checks */\n  healthCheck?: () => Promise<void>;\n\n  /** Custom shutdown function (optional) - will be called during graceful shutdown */\n  shutdown?: () => Promise<void>;\n\n  /** Additional options specific to the client (optional) */\n  options?: {\n    /** Whether to include this client in liveness checks (default: true) */\n    includeInLivenessCheck?: boolean;\n\n    /** Whether to include this client in readiness checks (default: true) */\n    includeInReadinessCheck?: boolean;\n\n    /** Custom name for this client (used in logging) */\n    name?: string;\n  };\n}\n\n/** Configuration for an HTTP or HTTPS server managed by HealthManager */\nexport interface ServerConfig {\n  /** The HTTP or HTTPS server instance */\n  server: HttpServer | HttpsServer;\n\n  /** Custom shutdown function for the server (optional) */\n  shutdown?: () => Promise<void>;\n\n  /** Additional options specific to the server (optional) */\n  options?: {\n    /** Custom name for this server (used in logging) */\n    name?: string;\n\n    /** Whether to skip the default shutdown handler for this server */\n    runDefaultShutdownHandler?: boolean;\n\n  }\n}\n\n/**\n * General configuration options for the HealthManager\n */\nexport interface HealthManagerConfig {\n  /**\n   * Delay in milliseconds before shutting down after SIGTERM/SIGINT\n   * This gives time for load balancers to stop routing traffic. Should be equal to or greater than readiness probe interval.\n   * @default 5000\n   */\n  shutdownDelayMs?: number;\n\n  /**\n   * Whether to call process.exit(0) after shutdown sequence completes\n   * @default true\n   */\n  useExit0?: boolean;\n\n  /** Whether to auto-setup SIGTERM/SIGINT handlers for graceful shutdown\n   * @default true\n   */\n  shouldSetupSignalHandlers?: boolean;\n\n  /**\n   * Global shutdown hook called before all clients are shut down\n   * @default undefined\n   */\n  beforeShutdown?: (() => Promise<void>) | undefined;\n\n  /**\n   * Global shutdown hook called after all clients are shut down\n   * @default undefined\n   */\n  onShutdown?: (() => Promise<void>) | undefined;\n\n  /** The interval in milliseconds at which the liveness checks are repeated (optional)\n   * * @default 10_000 \n   */\n  livenessPeriodMs?: number;\n\n  /** The interval in milliseconds at which the readiness checks are repeated (optional)\n   * * @default 5_000\n   */\n  readinessPeriodMs?: number;\n\n  /**\n   * Enable liveness check optimization - if true and all clients are in both liveness and readiness checks,\n   * liveness checks will be skipped when pod is already ready (readiness check passed)\n   * @default true\n   */\n  enableLivenessOptimization?: boolean;\n}\n\n/**\n * List of clients and general configuration for HealthManager\n */\nexport interface HealthManagerOptions {\n  /** Client configurations */\n  clients?: {\n    /** RabbitMQ client configuration - can be a single config or array of configs */\n    rabbit?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Sequelize instance configuration - can be a single config or array of configs */\n    sequelize?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Redis client configuration - can be a single config or array of configs */\n    redis?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Elasticsearch client configuration - can be a single config or array of configs */\n    elasticsearch?: ClientConfig<any> | ClientConfig<any>[];\n  };\n\n  /** General configuration options */\n  config?: HealthManagerConfig;\n\n  /** Logger instance for logging messages */\n  logger: LoggerInstanceManager;\n\n  /** Optional HTTP or HTTPS server instance to manage during shutdown */\n  server?: ServerConfig\n}\n\nexport interface RedisClient {\n  ping: () => Promise<string | void>;\n}\n\n/**\n * Sequelize database interface\n */\nexport interface SequelizeClient {\n  query(sql: string | { query: string; values: unknown[]; }): Promise<any>;\n}\n\n/**\n * Elasticsearch client interface\n */\nexport interface ElasticsearchClient {\n  ping: () => Promise<boolean>;\n}\n\nexport interface EventsClient {\n  exitHandler: () => Promise<void>;\n}\n\n/**\n * RabbitMQ client interface\n */\nexport interface RabbitMQClient {\n  isConnected: () => Promise<boolean> | boolean;\n}\n\nexport const CLIENT_TYPES = {\n  RABBIT: 'rabbit',\n  SEQUELIZE: 'sequelize',\n  REDIS: 'redis',\n  ELASTIC_SEARCH: 'elasticsearch',\n  EVENTS: 'events',\n} as const;\n\nexport type ClientType = typeof CLIENT_TYPES[keyof typeof CLIENT_TYPES];\n"],"mappings":"AAiKA,MAAa,EAAe,CAC1B,OAAQ,SACR,UAAW,YACX,MAAO,QACP,eAAgB,gBAChB,OAAQ,SACT"}

package/lib/health-manager/types.d.cts

@@ -0,0 +1,110 @@
+import { LoggerInstanceManager } from "@autofleet/logger";
+import { Server } from "node:http";
+import { Server as Server$1 } from "node:https";
+
+//#region src/health-manager/types.d.ts
+
+/**
+* Configuration for a single client (e.g., rabbit, sequelize, redis, elasticsearch)
+* Allows custom health checks and shutdown logic
+*/
+interface ClientConfig<T = any> {
+  /** The actual connection instance */
+  connection: T;
+  /** Custom health check function (optional) - will be called during alive/ready checks */
+  healthCheck?: () => Promise<void>;
+  /** Custom shutdown function (optional) - will be called during graceful shutdown */
+  shutdown?: () => Promise<void>;
+  /** Additional options specific to the client (optional) */
+  options?: {
+    /** Whether to include this client in liveness checks (default: true) */
+    includeInLivenessCheck?: boolean;
+    /** Whether to include this client in readiness checks (default: true) */
+    includeInReadinessCheck?: boolean;
+    /** Custom name for this client (used in logging) */
+    name?: string;
+  };
+}
+/** Configuration for an HTTP or HTTPS server managed by HealthManager */
+interface ServerConfig {
+  /** The HTTP or HTTPS server instance */
+  server: Server | Server$1;
+  /** Custom shutdown function for the server (optional) */
+  shutdown?: () => Promise<void>;
+  /** Additional options specific to the server (optional) */
+  options?: {
+    /** Custom name for this server (used in logging) */
+    name?: string;
+    /** Whether to skip the default shutdown handler for this server */
+    runDefaultShutdownHandler?: boolean;
+  };
+}
+/**
+* General configuration options for the HealthManager
+*/
+interface HealthManagerConfig {
+  /**
+  * Delay in milliseconds before shutting down after SIGTERM/SIGINT
+  * This gives time for load balancers to stop routing traffic. Should be equal to or greater than readiness probe interval.
+  * @default 5000
+  */
+  shutdownDelayMs?: number;
+  /**
+  * Whether to call process.exit(0) after shutdown sequence completes
+  * @default true
+  */
+  useExit0?: boolean;
+  /** Whether to auto-setup SIGTERM/SIGINT handlers for graceful shutdown
+  * @default true
+  */
+  shouldSetupSignalHandlers?: boolean;
+  /**
+  * Global shutdown hook called before all clients are shut down
+  * @default undefined
+  */
+  beforeShutdown?: (() => Promise<void>) | undefined;
+  /**
+  * Global shutdown hook called after all clients are shut down
+  * @default undefined
+  */
+  onShutdown?: (() => Promise<void>) | undefined;
+  /** The interval in milliseconds at which the liveness checks are repeated (optional)
+  * * @default 10_000 
+  */
+  livenessPeriodMs?: number;
+  /** The interval in milliseconds at which the readiness checks are repeated (optional)
+  * * @default 5_000
+  */
+  readinessPeriodMs?: number;
+  /**
+  * Enable liveness check optimization - if true and all clients are in both liveness and readiness checks,
+  * liveness checks will be skipped when pod is already ready (readiness check passed)
+  * @default true
+  */
+  enableLivenessOptimization?: boolean;
+}
+/**
+* List of clients and general configuration for HealthManager
+*/
+interface HealthManagerOptions {
+  /** Client configurations */
+  clients?: {
+    /** RabbitMQ client configuration - can be a single config or array of configs */
+    rabbit?: ClientConfig<any> | ClientConfig<any>[];
+    /** Sequelize instance configuration - can be a single config or array of configs */
+    sequelize?: ClientConfig<any> | ClientConfig<any>[];
+    /** Redis client configuration - can be a single config or array of configs */
+    redis?: ClientConfig<any> | ClientConfig<any>[];
+    /** Elasticsearch client configuration - can be a single config or array of configs */
+    elasticsearch?: ClientConfig<any> | ClientConfig<any>[];
+  };
+  /** General configuration options */
+  config?: HealthManagerConfig;
+  /** Logger instance for logging messages */
+  logger: LoggerInstanceManager;
+  /** Optional HTTP or HTTPS server instance to manage during shutdown */
+  server?: ServerConfig;
+}
+//#endregion
+export { HealthManagerOptions, ServerConfig };
+//# sourceMappingURL=types.d.cts.map

package/lib/health-manager/types.d.ts

@@ -0,0 +1,110 @@
+import { LoggerInstanceManager } from "@autofleet/logger";
+import { Server } from "node:http";
+import { Server as Server$1 } from "node:https";
+
+//#region src/health-manager/types.d.ts
+
+/**
+* Configuration for a single client (e.g., rabbit, sequelize, redis, elasticsearch)
+* Allows custom health checks and shutdown logic
+*/
+interface ClientConfig<T = any> {
+  /** The actual connection instance */
+  connection: T;
+  /** Custom health check function (optional) - will be called during alive/ready checks */
+  healthCheck?: () => Promise<void>;
+  /** Custom shutdown function (optional) - will be called during graceful shutdown */
+  shutdown?: () => Promise<void>;
+  /** Additional options specific to the client (optional) */
+  options?: {
+    /** Whether to include this client in liveness checks (default: true) */
+    includeInLivenessCheck?: boolean;
+    /** Whether to include this client in readiness checks (default: true) */
+    includeInReadinessCheck?: boolean;
+    /** Custom name for this client (used in logging) */
+    name?: string;
+  };
+}
+/** Configuration for an HTTP or HTTPS server managed by HealthManager */
+interface ServerConfig {
+  /** The HTTP or HTTPS server instance */
+  server: Server | Server$1;
+  /** Custom shutdown function for the server (optional) */
+  shutdown?: () => Promise<void>;
+  /** Additional options specific to the server (optional) */
+  options?: {
+    /** Custom name for this server (used in logging) */
+    name?: string;
+    /** Whether to skip the default shutdown handler for this server */
+    runDefaultShutdownHandler?: boolean;
+  };
+}
+/**
+* General configuration options for the HealthManager
+*/
+interface HealthManagerConfig {
+  /**
+  * Delay in milliseconds before shutting down after SIGTERM/SIGINT
+  * This gives time for load balancers to stop routing traffic. Should be equal to or greater than readiness probe interval.
+  * @default 5000
+  */
+  shutdownDelayMs?: number;
+  /**
+  * Whether to call process.exit(0) after shutdown sequence completes
+  * @default true
+  */
+  useExit0?: boolean;
+  /** Whether to auto-setup SIGTERM/SIGINT handlers for graceful shutdown
+  * @default true
+  */
+  shouldSetupSignalHandlers?: boolean;
+  /**
+  * Global shutdown hook called before all clients are shut down
+  * @default undefined
+  */
+  beforeShutdown?: (() => Promise<void>) | undefined;
+  /**
+  * Global shutdown hook called after all clients are shut down
+  * @default undefined
+  */
+  onShutdown?: (() => Promise<void>) | undefined;
+  /** The interval in milliseconds at which the liveness checks are repeated (optional)
+  * * @default 10_000 
+  */
+  livenessPeriodMs?: number;
+  /** The interval in milliseconds at which the readiness checks are repeated (optional)
+  * * @default 5_000
+  */
+  readinessPeriodMs?: number;
+  /**
+  * Enable liveness check optimization - if true and all clients are in both liveness and readiness checks,
+  * liveness checks will be skipped when pod is already ready (readiness check passed)
+  * @default true
+  */
+  enableLivenessOptimization?: boolean;
+}
+/**
+* List of clients and general configuration for HealthManager
+*/
+interface HealthManagerOptions {
+  /** Client configurations */
+  clients?: {
+    /** RabbitMQ client configuration - can be a single config or array of configs */
+    rabbit?: ClientConfig<any> | ClientConfig<any>[];
+    /** Sequelize instance configuration - can be a single config or array of configs */
+    sequelize?: ClientConfig<any> | ClientConfig<any>[];
+    /** Redis client configuration - can be a single config or array of configs */
+    redis?: ClientConfig<any> | ClientConfig<any>[];
+    /** Elasticsearch client configuration - can be a single config or array of configs */
+    elasticsearch?: ClientConfig<any> | ClientConfig<any>[];
+  };
+  /** General configuration options */
+  config?: HealthManagerConfig;
+  /** Logger instance for logging messages */
+  logger: LoggerInstanceManager;
+  /** Optional HTTP or HTTPS server instance to manage during shutdown */
+  server?: ServerConfig;
+}
+//#endregion
+export { HealthManagerOptions, ServerConfig };
+//# sourceMappingURL=types.d.ts.map

package/lib/health-manager/types.js

@@ -0,0 +1,2 @@
+const e={RABBIT:`rabbit`,SEQUELIZE:`sequelize`,REDIS:`redis`,ELASTIC_SEARCH:`elasticsearch`,EVENTS:`events`};export{e as CLIENT_TYPES};
+//# sourceMappingURL=types.js.map

package/lib/health-manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/health-manager/types.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\nimport type { Server as HttpServer } from 'node:http';\nimport type { Server as HttpsServer } from 'node:https';\n\n\n/**\n * Configuration for a single client (e.g., rabbit, sequelize, redis, elasticsearch)\n * Allows custom health checks and shutdown logic\n */\nexport interface ClientConfig<T = any> {\n  /** The actual connection instance */\n  connection: T;\n\n  /** Custom health check function (optional) - will be called during alive/ready checks */\n  healthCheck?: () => Promise<void>;\n\n  /** Custom shutdown function (optional) - will be called during graceful shutdown */\n  shutdown?: () => Promise<void>;\n\n  /** Additional options specific to the client (optional) */\n  options?: {\n    /** Whether to include this client in liveness checks (default: true) */\n    includeInLivenessCheck?: boolean;\n\n    /** Whether to include this client in readiness checks (default: true) */\n    includeInReadinessCheck?: boolean;\n\n    /** Custom name for this client (used in logging) */\n    name?: string;\n  };\n}\n\n/** Configuration for an HTTP or HTTPS server managed by HealthManager */\nexport interface ServerConfig {\n  /** The HTTP or HTTPS server instance */\n  server: HttpServer | HttpsServer;\n\n  /** Custom shutdown function for the server (optional) */\n  shutdown?: () => Promise<void>;\n\n  /** Additional options specific to the server (optional) */\n  options?: {\n    /** Custom name for this server (used in logging) */\n    name?: string;\n\n    /** Whether to skip the default shutdown handler for this server */\n    runDefaultShutdownHandler?: boolean;\n\n  }\n}\n\n/**\n * General configuration options for the HealthManager\n */\nexport interface HealthManagerConfig {\n  /**\n   * Delay in milliseconds before shutting down after SIGTERM/SIGINT\n   * This gives time for load balancers to stop routing traffic. Should be equal to or greater than readiness probe interval.\n   * @default 5000\n   */\n  shutdownDelayMs?: number;\n\n  /**\n   * Whether to call process.exit(0) after shutdown sequence completes\n   * @default true\n   */\n  useExit0?: boolean;\n\n  /** Whether to auto-setup SIGTERM/SIGINT handlers for graceful shutdown\n   * @default true\n   */\n  shouldSetupSignalHandlers?: boolean;\n\n  /**\n   * Global shutdown hook called before all clients are shut down\n   * @default undefined\n   */\n  beforeShutdown?: (() => Promise<void>) | undefined;\n\n  /**\n   * Global shutdown hook called after all clients are shut down\n   * @default undefined\n   */\n  onShutdown?: (() => Promise<void>) | undefined;\n\n  /** The interval in milliseconds at which the liveness checks are repeated (optional)\n   * * @default 10_000 \n   */\n  livenessPeriodMs?: number;\n\n  /** The interval in milliseconds at which the readiness checks are repeated (optional)\n   * * @default 5_000\n   */\n  readinessPeriodMs?: number;\n\n  /**\n   * Enable liveness check optimization - if true and all clients are in both liveness and readiness checks,\n   * liveness checks will be skipped when pod is already ready (readiness check passed)\n   * @default true\n   */\n  enableLivenessOptimization?: boolean;\n}\n\n/**\n * List of clients and general configuration for HealthManager\n */\nexport interface HealthManagerOptions {\n  /** Client configurations */\n  clients?: {\n    /** RabbitMQ client configuration - can be a single config or array of configs */\n    rabbit?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Sequelize instance configuration - can be a single config or array of configs */\n    sequelize?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Redis client configuration - can be a single config or array of configs */\n    redis?: ClientConfig<any> | ClientConfig<any>[];\n\n    /** Elasticsearch client configuration - can be a single config or array of configs */\n    elasticsearch?: ClientConfig<any> | ClientConfig<any>[];\n  };\n\n  /** General configuration options */\n  config?: HealthManagerConfig;\n\n  /** Logger instance for logging messages */\n  logger: LoggerInstanceManager;\n\n  /** Optional HTTP or HTTPS server instance to manage during shutdown */\n  server?: ServerConfig\n}\n\nexport interface RedisClient {\n  ping: () => Promise<string | void>;\n}\n\n/**\n * Sequelize database interface\n */\nexport interface SequelizeClient {\n  query(sql: string | { query: string; values: unknown[]; }): Promise<any>;\n}\n\n/**\n * Elasticsearch client interface\n */\nexport interface ElasticsearchClient {\n  ping: () => Promise<boolean>;\n}\n\nexport interface EventsClient {\n  exitHandler: () => Promise<void>;\n}\n\n/**\n * RabbitMQ client interface\n */\nexport interface RabbitMQClient {\n  isConnected: () => Promise<boolean> | boolean;\n}\n\nexport const CLIENT_TYPES = {\n  RABBIT: 'rabbit',\n  SEQUELIZE: 'sequelize',\n  REDIS: 'redis',\n  ELASTIC_SEARCH: 'elasticsearch',\n  EVENTS: 'events',\n} as const;\n\nexport type ClientType = typeof CLIENT_TYPES[keyof typeof CLIENT_TYPES];\n"],"mappings":"AAiKA,MAAa,EAAe,CAC1B,OAAQ,SACR,UAAW,YACX,MAAO,QACP,eAAgB,gBAChB,OAAQ,SACT"}