npm - @sebspark/health-check - Versions diffs - 2.0.3 → 2.1.0 - Mend

@sebspark/health-check 2.0.3 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/index.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/dependency-monitor.ts","../src/health-monitor.ts"],"mappings":"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~~EEiJO~~,IAAA,CAAA,~~GAnFyD~~,MAAA;EF1DhE;;;~~EEoJO~~,IAAA,CAAA,GAPI,QAAA;~~EFzIT~~;;;;;AAMJ;;;;;;;;;;;;AAOA;;;;;;;;;;;;~~EEoKe~~,KAAA,CAAA,GAAS,OAAA,CAAQ,gBAAA;EAuGjB,MAAA,CAAA,GAAM,OAAA,CAAA,aAAA;~~EFxQH~~;;AAGlB;EAHkB,~~IEyRL~~,MAAA,CAAA,GAAM,MAAA;;;;GAOT,MAAA,CAAO,OAAA;~~EFxRG~~;;;;AAKpB;~~EE4RS~~,OAAA,CAAA;AAAA"}
1	+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/dependency-monitor.ts","../src/health-monitor.ts"],"mappings":"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"}

package/dist/index.mjs CHANGED Viewed

@@ -2,7 +2,6 @@ import { performance } from "node:perf_hooks";
 import { toEntity } from "@sebspark/hyper-media";
 import { Router } from "express";
 import os from "node:os";
 //#region src/types.ts
 var TimeoutError = class extends Error {
 	constructor() {
@@ -16,7 +15,6 @@ var UnknownError = class extends Error {
 		this.name = "UnknownError";
 	}
 };
 //#endregion
 //#region src/timing.ts
 const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -64,7 +62,6 @@ const throttle = (fn, ms) => {
 * Essentially just throttled with timeout 0
 */
 const singleFlight = (fn) => throttle(fn, 0);
 //#endregion
 //#region src/dependency-monitor.ts
 /**
@@ -251,7 +248,6 @@ var DependencyMonitor = class {
 		if (this.timeout) clearTimeout(this.timeout);
 	}
 };
 //#endregion
 //#region src/static-checks.ts
 const ping = () => ({ status: "ok" });
@@ -286,7 +282,6 @@ const liveness = () => {
 		}
 	};
 };
 //#endregion
 //#region src/health-monitor.ts
 /**
@@ -387,7 +382,8 @@ var HealthMonitor = class {
 		router.get("/health/ready", async (req, res, next) => {
 			try {
 				const readiness = await this.ready();
-				res.status(200).json(toEntity(req, readiness, { health: "/health" }));
+				const status = readiness.summary.critical.failing > 0 ? 503 : 200;
+				res.status(status).json(toEntity(req, readiness, { health: "/health" }));
 			} catch (err) {
 				next?.(err);
 			}
@@ -549,7 +545,7 @@ var HealthMonitor = class {
 		for (const dependency of this.dependencies.values()) dependency.dispose();
 	}
 };
 //#endregion
 export { DependencyMonitor, HealthMonitor, TimeoutError, UnknownError };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","names":[],"sources":["../src/types.ts","../src/timing.ts","../src/dependency-monitor.ts","../src/static-checks.ts","../src/health-monitor.ts"],"sourcesContent":["export type DependencyStatusValue = 'ok' \| 'degraded' \| 'error'\nexport type StatusValue = DependencyStatusValue \| 'unknown' \| 'draining'\nexport type Impact = 'critical' \| 'non_critical'\nexport type Mode = 'inline' \| 'polled' \| 'async'\n\nexport type Verb = 'GET' \| 'POST' \| 'PUT' \| 'PATCH' \| 'DELETE'\n\nexport type Link = {\n method: Verb\n href: string\n}\n\nexport interface Entity<T> {\n data: T\n links: Record<string, Link>\n}\n\nexport type Status = {\n status: StatusValue\n}\n\nexport type System = {\n hostname: string\n platform: NodeJS.Platform\n release: string\n arch: string\n uptime: number\n loadavg: [number, number, number] // 1, 5, 15 min\n totalmem: number\n freemem: number\n memUsedRatio: number // 0..1\n cpus: {\n count: number\n model?: string\n speedMHz?: number\n }\n}\n\nexport type Process = {\n pid: number\n node: string\n uptime: number\n memory: NodeJS.MemoryUsage\n}\n\nexport type Liveness = Status & {\n timestamp: string\n system: System\n process: Process\n}\n\nexport type Freshness = {\n lastChecked: string\n lastSuccess: string \| null\n}\n\nexport type Observed = {\n latencyMs: number \| null\n [k: string]: unknown\n}\n\nexport type CheckError = {\n code: string\n message: string\n}\n\nexport type DependencyCheck = Status & {\n impact: Impact\n mode: Mode\n freshness: Freshness\n observed?: Observed\n details?: Record<string, unknown>\n error?: CheckError \| null\n since?: string \| null\n}\n\nexport type ReadinessSummary = {\n critical: { ok: number; failing: number }\n nonCritical: { ok: number; degraded: number; failing: number }\n degradedReasons: string[]\n}\n\nexport type ReadinessPayload = Status & {\n timestamp: string\n service?: { name?: string; version?: string; instanceId?: string }\n summary: ReadinessSummary\n checks: Record<string, DependencyCheck>\n}\n\nexport type HealthSummary = Status &\n Pick<ReadinessPayload, 'summary' \| 'checks'> &\n Pick<Liveness, 'system' \| 'process'> & { timestamp: string }\n\nexport class TimeoutError extends Error {\n constructor() {\n super('timeout')\n this.name = 'TimeoutError'\n }\n}\n\nexport class UnknownError extends Error {\n constructor() {\n super('unknown')\n this.name = 'UnknownError'\n }\n}\n","import { TimeoutError } from './types'\n\nexport const wait = (ms: number) =>\n new Promise<void>((resolve) => setTimeout(resolve, ms))\n\nexport const runTimeoutTimer = async (ms: number) => {\n await wait(ms)\n throw new TimeoutError()\n}\n\nexport const runAgainstTimeout = <T>(\n promise: Promise<T>,\n ms?: number \| undefined\n): Promise<T> => {\n if ((ms as number) > 0) {\n return Promise.race([promise, runTimeoutTimer(ms as number)])\n }\n\n return promise\n}\n\n/*\n Throttles an async function:\n * - coalesces concurrent calls into a single in-flight Promise,\n * - after it settles, reuses that settled Promise for `ms` ms,\n * - then clears so the next call invokes `fn` again.\n \n Fully preserves the original function signature.\n /\nexport const throttle = <F extends (...args: unknown[]) => Promise<unknown>>(\n fn: F,\n ms: number\n) => {\n type R = ReturnType<F> // a Promise<T>\n\n let current: R \| null = null\n let clearHandle: NodeJS.Timeout \| null = null\n\n const wrapped = (...args: Parameters<F>): R => {\n if (!current) {\n current = fn(...args) as R\n\n if (clearHandle) {\n clearTimeout(clearHandle)\n clearHandle = null\n }\n\n current.finally(() => {\n if (ms > 0) {\n clearHandle = setTimeout(() => {\n current = null\n clearHandle = null\n }, ms)\n } else {\n current = null\n }\n })\n }\n\n return current\n }\n\n // Cast to F so the returned function has the identical* callable type\n return wrapped as unknown as F\n}\n\n/*\n Wraps an async function so that concurrent invocations share the same in-flight Promise.\n * After the Promise settles (resolve or reject), the next call will invoke the function again.\n * Essentially just throttled with timeout 0\n /\nexport const singleFlight = <\n F extends (...args: unknown[]) => Promise<unknown>,\n>(\n fn: F\n) => throttle<F>(fn, 0)\n","import { performance } from 'node:perf_hooks'\nimport { runAgainstTimeout, singleFlight } from './timing'\nimport {\n type CheckError,\n type DependencyCheck,\n type DependencyStatusValue,\n type Freshness,\n type Impact,\n type Mode,\n type Observed,\n type StatusValue,\n TimeoutError,\n UnknownError,\n} from './types'\n\n/\n Base configuration shared by all dependency monitor modes.\n /\ntype BaseConfig = {\n /\n Importance of the dependency:\n * - `'critical'` → service cannot run without it\n * - `'non_critical'` → service is degraded but still functional if it fails\n /\n impact: Impact\n\n /\n Polling interval in milliseconds.\n * - Required for polled and async modes\n * - Must not be set for inline mode\n /\n pollRate?: number\n\n /\n Polling interval in milliseconds for failed calls.\n * - Defaults to pollRate for polled and async modes\n * - Must not be set for inline mode\n /\n retryRate?: number\n\n /\n Maximum response time in milliseconds considered healthy.\n * - A call resolving within this time window and returning `\"ok\"` → status `\"ok\"`\n * - A call resolving after this but before `timeoutLimitMs` → status `\"degraded\"`\n /\n healthyLimitMs: number\n\n /\n Absolute upper bound in milliseconds; beyond this a call is considered `\"error\"`.\n * - Inline: the awaited call is raced with a timeout and rejected past this limit\n * - Polled/Async: escalate `unknown` → `degraded` at `healthyLimitMs`, then `\"error\"` at `timeoutLimitMs`\n * - Any late `\"ok\"` result after this limit is ignored\n /\n timeoutLimitMs: number\n}\n\n/\n Inline mode configuration (no polling).\n * `syncCall` runs only when {@link DependencyMonitor.check} is invoked.\n /\nexport type SyncInlineConfig = BaseConfig & {\n /* Performs the check immediately when {@link DependencyMonitor.check} is called. /\n syncCall: () => Promise<DependencyStatusValue \| Error>\n asyncCall?: never\n pollRate?: undefined\n retryRate?: undefined\n}\n\n/\n Polled mode configuration.\n * `syncCall` runs on an interval (`pollRate`) and results are cached.\n /\nexport type SyncPolledConfig = BaseConfig & {\n /* Performs the check at each poll interval. /\n syncCall: () => Promise<DependencyStatusValue \| Error>\n /* Polling interval in milliseconds. /\n pollRate: number\n asyncCall?: never\n}\n\n/\n Async mode configuration.\n * `asyncCall` starts a check and must report via the provided callback.\n /\nexport type AsyncConfig = BaseConfig & {\n /\n Starts an asynchronous check. Must call `reportResponse` once a result is available.\n * The callback may be invoked with a `DependencyStatusValue` or an `Error`.\n /\n asyncCall: (\n reportResponse: (\n status: DependencyStatusValue \| Error\n ) => void \| Promise<void>\n ) => void \| Promise<void>\n /* Polling interval in milliseconds. /\n pollRate: number\n syncCall?: never\n}\n\n/\n Discriminated configuration for a dependency monitor.\n * - {@link SyncInlineConfig} → inline checks on demand\n * - {@link SyncPolledConfig} → synchronous checks on a fixed interval\n * - {@link AsyncConfig} → asynchronous checks that report back via callback\n /\nexport type DependencyMonitorConfig =\n \| SyncInlineConfig\n \| SyncPolledConfig\n \| AsyncConfig\n\n/\n Tracks the health of a single dependency in one of three modes:\n \n - inline: `syncCall` executed only when {@link check} is called\n * - polled: `syncCall` executed on `pollRate`; latest result cached\n * - async: `asyncCall` executed on `pollRate`, result returned via callback\n \n The monitor:\n * - classifies results using `healthyLimitMs` and `timeoutLimitMs`\n * - records freshness (`lastChecked`, `lastSuccess`)\n * - records observed latency (ms) when applicable\n \n Status interpretation:\n * - `\"ok\"` only if returned `\"ok\"` and latency ≤ `healthyLimitMs`\n * - `\"degraded\"` if returned `\"degraded\"` or latency > `healthyLimitMs` but ≤ `timeoutLimitMs`\n * - `\"error\"` if returned `\"error\"`, an `Error`, or exceeded `timeoutLimitMs`\n * - `\"unknown\"` is the initial state before first successful/failed result (polled/async)\n /\nexport class DependencyMonitor {\n /* Immutable configuration for this monitor. /\n private readonly config: DependencyMonitorConfig\n /* Operational mode determined from the configuration. /\n private readonly mode: Mode\n\n /* Last computed status (starts as `\"unknown\"` until first result). /\n private status: StatusValue\n /* Optional error details from the last failure. /\n private error?: CheckError\n /* Last observed metrics (e.g., latency). /\n private observed?: Observed\n /* Freshness timestamps for last check/success. /\n private freshness?: Freshness\n\n /* Indicates whether this monitor has been disposed. /\n private isDisposed = false\n /* Internal timer handle for polling/retry. /\n private timeout?: NodeJS.Timeout\n\n /\n Create a new {@link DependencyMonitor}.\n * @param config Monitor configuration (inline, polled, or async).\n /\n constructor(config: DependencyMonitorConfig) {\n this.config = config\n\n this.mode = config.asyncCall\n ? 'async'\n : config.pollRate\n ? 'polled'\n : 'inline'\n\n this.status = 'unknown'\n\n // Deduplicate concurrent inline checks (single-flight).\n if (this.mode === 'inline') {\n this.check = singleFlight(this.check.bind(this))\n }\n\n // Kick off the first cycle for polled/async.\n if (this.mode !== 'inline') {\n this.doCheck()\n }\n }\n\n /* Impact of this dependency (critical/non_critical). /\n public get impact() {\n return this.config.impact\n }\n\n /\n Run one check cycle depending on the configured mode.\n * - Inline: no-op here (runs in {@link check})\n * - Polled/Async: invoked automatically and re-scheduled as needed\n /\n private async doCheck() {\n if (this.timeout) {\n clearTimeout(this.timeout)\n }\n if (this.isDisposed) {\n return\n }\n\n if (this.config.syncCall) {\n await this.doSyncCheck()\n } else {\n this.doAsyncCheck()\n }\n }\n\n /\n Execute a synchronous (inline/polled) check and update internal state.\n * Classification:\n * - OK if `\"ok\"` and latency ≤ `healthyLimitMs`\n * - Degraded if `\"degraded\"` or latency between `(healthyLimitMs, timeoutLimitMs]`\n * - Error if `\"error\"`, `Error`, or timeout exceeded\n /\n private async doSyncCheck() {\n const start = performance.now()\n\n const { syncCall, timeoutLimitMs } = this.config as SyncInlineConfig\n\n try {\n const response = await runAgainstTimeout(syncCall(), timeoutLimitMs)\n const duration = performance.now() - start\n\n this.handleDependencyResponse(response, duration)\n } catch (err) {\n this.handleDependencyError(err as Error)\n }\n }\n\n /\n Execute an asynchronous check (async mode).\n * - Initializes timers to escalate `unknown` → `degraded` → `error`\n * if no callback result arrives within the thresholds.\n * - On callback, clears timers and classifies the result with latency.\n /\n private async doAsyncCheck() {\n const { asyncCall, healthyLimitMs, timeoutLimitMs } = this\n .config as AsyncConfig\n\n const start = performance.now()\n let callActive = true\n let healthTimeout: NodeJS.Timeout \| undefined\n let serviceTimeout: NodeJS.Timeout \| undefined\n\n asyncCall((response) => {\n if (!callActive) return\n callActive = false\n clearTimeout(healthTimeout)\n clearTimeout(serviceTimeout)\n\n const duration = performance.now() - start\n this.handleDependencyResponse(response, duration)\n })\n\n // Escalate to degraded after healthy limit if still waiting.\n healthTimeout = setTimeout(() => {\n if (callActive) this.status = 'degraded'\n }, healthyLimitMs)\n\n // Escalate to error after timeout limit if still waiting.\n serviceTimeout = setTimeout(() => {\n if (!callActive) return\n callActive = false\n clearTimeout(healthTimeout)\n this.handleDependencyError(new TimeoutError())\n }, timeoutLimitMs)\n }\n\n /\n Normalize a successful dependency response into status + metadata.\n * @param response Returned status value or Error from the dependency\n * @param duration Measured latency in milliseconds\n /\n private handleDependencyResponse(\n response: DependencyStatusValue \| Error,\n duration: number\n ) {\n if (response instanceof Error) {\n return this.handleDependencyError(response)\n }\n if (response === 'error') {\n return this.handleDependencyError(new UnknownError())\n }\n\n this.error = undefined\n this.status =\n response === 'ok' && duration <= this.config.healthyLimitMs\n ? 'ok'\n : 'degraded'\n\n const end = new Date()\n this.freshness = {\n lastChecked: end.toISOString(),\n lastSuccess: end.toISOString(),\n }\n\n this.observed = { latencyMs: duration }\n\n // Schedule next poll if applicable.\n if (this.config.pollRate && !this.isDisposed) {\n const delay = this.config.pollRate\n this.timeout = setTimeout(() => this.doCheck(), delay)\n }\n }\n\n /\n Normalize a failed dependency result into `\"error\"` and update metadata.\n * @param error Error thrown/returned or synthesized (e.g., timeout)\n /\n private handleDependencyError(error: Error & { code?: string }) {\n this.status = 'error'\n this.observed = undefined\n this.error = {\n code: error.code \|\| 'UNKNOWN',\n message: error.message,\n }\n\n const end = new Date()\n if (this.freshness) {\n this.freshness.lastChecked = end.toISOString()\n } else {\n this.freshness = { lastChecked: end.toISOString(), lastSuccess: null }\n }\n\n // Schedule retry/poll if configured.\n if ((this.config.retryRate \|\| this.config.pollRate) && !this.isDisposed) {\n const delay = this.config.retryRate \|\| this.config.pollRate\n this.timeout = setTimeout(() => this.doCheck(), delay)\n }\n }\n\n /\n Get a snapshot of the dependency’s current health.\n * - Inline mode: executes the `syncCall` (single-flight guarded)\n * - Polled/Async: returns the cached result\n * @throws if the monitor has been disposed\n /\n public async check(): Promise<DependencyCheck> {\n if (this.isDisposed) {\n throw new Error('DependencyMonitor has been disposed')\n }\n\n if (this.mode === 'inline') {\n await this.doCheck()\n }\n\n const result: DependencyCheck = {\n status: this.status as StatusValue,\n impact: this.config.impact,\n mode: this.mode,\n freshness: this.freshness as Freshness,\n observed: this.observed,\n error: this.error,\n }\n\n return result\n }\n\n /* Symbol-based disposer for use with `using`. /\n public [Symbol.dispose]() {\n this.dispose()\n }\n\n /\n Dispose the monitor:\n * - Clears any scheduled timers\n * - Prevents further checks from running\n /\n public dispose() {\n this.isDisposed = true\n if (this.timeout) {\n clearTimeout(this.timeout)\n }\n }\n}\n","import os from 'node:os'\nimport type { Liveness, Status } from './types'\n\nexport const ping = (): Status => ({ status: 'ok' })\nexport const liveness = (): Liveness => {\n const cpus = os.cpus()\n const total = os.totalmem()\n const free = os.freemem()\n\n return {\n status: 'ok',\n timestamp: new Date().toISOString(),\n system: {\n hostname: os.hostname(),\n platform: os.platform(),\n release: os.release(),\n arch: os.arch(),\n uptime: os.uptime(),\n loadavg: os.loadavg() as [number, number, number],\n totalmem: total,\n freemem: free,\n memUsedRatio: total > 0 ? (total - free) / total : 0,\n cpus: {\n count: cpus.length,\n model: cpus[0]?.model,\n speedMHz: cpus[0]?.speed,\n },\n },\n process: {\n pid: process.pid,\n node: process.versions.node,\n uptime: process.uptime(),\n memory: process.memoryUsage(), // rss, heapTotal, heapUsed, external, arrayBuffers\n },\n }\n}\n","import { toEntity } from '@sebspark/hyper-media'\nimport { type ErrorRequestHandler, Router } from 'express'\nimport type {\n DependencyMonitor,\n DependencyMonitorConfig,\n} from './dependency-monitor'\nimport { liveness, ping } from './static-checks'\nimport { throttle } from './timing'\nimport type {\n DependencyCheck,\n HealthSummary,\n Impact,\n ReadinessPayload,\n ReadinessSummary,\n} from './types'\n\nexport interface HealthMonitorConfig {\n throttle: number\n}\n\n/\n HealthMonitor wires up standard health check endpoints for an Express app.\n \n It provides three endpoints under `/health`:\n * - /ping → lightweight always-OK response (`{ status: \"ok\" }`)\n * - /live → liveness probe (`{ status, uptime, timestamp }`)\n * - /ready → readiness probe with dependency checks (`{ status, checks }`)\n \n Dependencies can be added via {@link addDependency} with a {@link DependencyMonitorConfig}.\n * Each dependency is wrapped in a {@link DependencyMonitor} and tracked for readiness.\n \n ### Example\n \n ```ts\n * import express from 'express'\n * import { HealthMonitor } from './health-monitor'\n \n const app = express()\n * const monitor = new HealthMonitor()\n \n monitor.addDependency('db', {\n * impact: 'critical',\n * syncCall: async () => {\n * await db.ping()\n * return 'ok'\n * }\n * })\n \n app.use(monitor.router)\n * app.listen(3000)\n * ```\n /\nexport class HealthMonitor {\n private readonly _router: Router\n private readonly dependencies: Map<string, DependencyMonitor>\n // private isDisposed = false\n\n /\n Create a new HealthMonitor instance with its own router and dependency map.\n /\n constructor(config?: HealthMonitorConfig) {\n this._router = this.createRouter()\n this.dependencies = new Map()\n\n const thr = config ? config.throttle : 10\n if (thr > 0) {\n this.ready = throttle(this.ready.bind(this), thr)\n }\n }\n\n /\n Register a named dependency to be checked as part of readiness.\n \n @param name - Identifier for the dependency (e.g. \"postgres\", \"redis\").\n * @param dependency - DependencyMonitor\n * @returns this for chaining\n \n @example\n * ```ts\n * monitor.addDependency('redis', new DependencyMonitor({\n * impact: 'critical',\n * pollRate: 5000,\n * syncCall: async () => redis.ping() ? 'ok' : 'error'\n * }))\n * ```\n /\n public addDependency(name: string, dependency: DependencyMonitor) {\n this.dependencies.set(name, dependency)\n return this\n }\n\n /\n Internal: create the Express router with /health routes.\n /\n private createRouter() {\n const router = Router()\n\n // Health\n router.get('/health', async (req, res, next) => {\n try {\n const health = await this.health()\n res.status(200).json(\n toEntity(req, health, {\n ping: '/health/ping',\n live: '/health/live',\n ready: '/health/ready',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Ping\n router.get('/health/ping', (req, res, next) => {\n try {\n res.status(200).json(\n toEntity(req, this.ping(), {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Liveness\n router.get('/health/live', (req, res, next) => {\n try {\n res.status(200).json(\n toEntity(req, this.live(), {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Readiness\n router.get('/health/ready', async (req, res, next) => {\n try {\n const readiness = await this.ready()\n res.status(200).json(\n toEntity(req, readiness, {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Error handler\n const errorHandler: ErrorRequestHandler = (err, _req, res, _next) => {\n const message = err instanceof Error ? err.message : String(err)\n res.status(500).json({\n status: 'error',\n error: { message },\n })\n }\n router.use(errorHandler)\n\n return router\n }\n\n /\n Static ping check — always returns `{ status: \"ok\" }`.\n /\n public ping() {\n return ping()\n }\n\n /\n Liveness probe: reports uptime and current timestamp.\n /\n public live() {\n return liveness()\n }\n\n /\n Readiness probe: runs all registered dependencies in parallel\n * and aggregates their results into an overall status.\n \n - Any critical error → `\"error\"`\n * - Else any critical degraded or any non-critical degraded/error → `\"degraded\"`\n * - Else → `\"ok\"`\n \n @returns Object with overall `status` and per-dependency `checks`\n \n @example\n * ```json\n * {\n * \"status\": \"ok\",\n * \"checks\": {\n * \"postgres\": {\n * \"status\": \"ok\",\n * \"impact\": \"critical\",\n * \"mode\": \"inline\",\n * \"freshness\": {\n * \"lastChecked\": \"2025-08-19T12:00:00Z\",\n * \"lastSuccess\": \"2025-08-19T12:00:00Z\"\n * },\n * \"observed\": { \"latencyMs\": 12 }\n * }\n * }\n * }\n * ```\n /\n public async ready(): Promise<ReadinessPayload> {\n const entries = Array.from(this.dependencies.entries())\n\n const settled = await Promise.allSettled(\n entries.map(async ([name, monitor]) => {\n const check = await monitor.check()\n return [name, check] as const\n })\n )\n\n const checks: Record<string, DependencyCheck> = {}\n\n for (let i = 0; i < settled.length; i++) {\n const s = settled[i]\n const [name] = entries[i]\n\n if (s.status === 'fulfilled') {\n const [, check] = s.value\n checks[name] = check\n } else {\n checks[name] = {\n status: 'error',\n impact: this.dependencies.get(name)?.impact as Impact,\n mode: 'polled',\n freshness: {\n lastChecked: new Date().toISOString(),\n lastSuccess: null,\n },\n observed: undefined,\n error: {\n code: 'CHECK_FAILED',\n message: String(s.reason ?? 'unknown error'),\n },\n }\n }\n }\n\n // ----- summary -------------------------------------------------------------\n let criticalOk = 0\n let criticalFailing = 0 // counts any non-ok critical (degraded OR error)\n\n let nonCritOk = 0\n let nonCritDegraded = 0\n let nonCritFailing = 0 // non-critical with status === 'error'\n\n const degradedReasons: string[] = []\n\n for (const [name, c] of Object.entries(checks)) {\n const isCritical = c.impact === 'critical'\n if (c.status === 'ok') {\n if (isCritical) criticalOk++\n else nonCritOk++\n } else if (c.status === 'degraded') {\n if (isCritical)\n criticalFailing++ // critical degraded counts as failing\n else nonCritDegraded++\n degradedReasons.push(`${name}:degraded`)\n } else {\n // 'error'\n if (isCritical) criticalFailing++\n else nonCritFailing++\n degradedReasons.push(`${name}:${c.error?.code ?? 'error'}`)\n }\n }\n\n const summary: ReadinessSummary = {\n critical: { ok: criticalOk, failing: criticalFailing },\n nonCritical: {\n ok: nonCritOk,\n degraded: nonCritDegraded,\n failing: nonCritFailing,\n },\n degradedReasons,\n }\n\n // ----- overall status (same rules as before) -------------------------------\n let status: import('./types').StatusValue = 'ok'\n const values = Object.values(checks)\n const anyCriticalError = values.some(\n (c) => c.impact === 'critical' && c.status === 'error'\n )\n const anyDegradedOrError = values.some(\n (c) => c.status === 'degraded' \|\| c.status === 'error'\n )\n const anyCriticalDegraded = values.some(\n (c) => c.impact === 'critical' && c.status === 'degraded'\n )\n\n if (anyCriticalError) status = 'error'\n else if (anyCriticalDegraded \|\| anyDegradedOrError) status = 'degraded'\n\n // ----- payload -------------------------------------------------------------\n const payload: ReadinessPayload = {\n status,\n timestamp: new Date().toISOString(),\n // service: { name, version, instanceId } // (optional; if you add config later)\n summary,\n checks,\n }\n\n return payload\n }\n\n public async health() {\n const { status, checks, summary } = await this.ready()\n const { timestamp, system, process } = this.live()\n\n return {\n status,\n timestamp,\n system,\n process,\n checks,\n summary,\n } as HealthSummary\n }\n\n /\n Accessor for the Express router that exposes /health endpoints.\n /\n public get router() {\n return this._router\n }\n\n /\n Symbol-based disposer for use with `using`.\n /\n public [Symbol.dispose]() {\n this.dispose()\n }\n\n /\n Dispose of the monitor:\n * - marks as disposed\n * - (future: could also stop all dependency monitors)\n */\n public dispose() {\n // this.isDisposed = true\n for (const dependency of this.dependencies.values()) {\n dependency.dispose()\n }\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/types.ts","../src/timing.ts","../src/dependency-monitor.ts","../src/static-checks.ts","../src/health-monitor.ts"],"sourcesContent":["export type DependencyStatusValue = 'ok' \| 'degraded' \| 'error'\nexport type StatusValue = DependencyStatusValue \| 'unknown' \| 'draining'\nexport type Impact = 'critical' \| 'non_critical'\nexport type Mode = 'inline' \| 'polled' \| 'async'\n\nexport type Verb = 'GET' \| 'POST' \| 'PUT' \| 'PATCH' \| 'DELETE'\n\nexport type Link = {\n method: Verb\n href: string\n}\n\nexport interface Entity<T> {\n data: T\n links: Record<string, Link>\n}\n\nexport type Status = {\n status: StatusValue\n}\n\nexport type System = {\n hostname: string\n platform: NodeJS.Platform\n release: string\n arch: string\n uptime: number\n loadavg: [number, number, number] // 1, 5, 15 min\n totalmem: number\n freemem: number\n memUsedRatio: number // 0..1\n cpus: {\n count: number\n model?: string\n speedMHz?: number\n }\n}\n\nexport type Process = {\n pid: number\n node: string\n uptime: number\n memory: NodeJS.MemoryUsage\n}\n\nexport type Liveness = Status & {\n timestamp: string\n system: System\n process: Process\n}\n\nexport type Freshness = {\n lastChecked: string\n lastSuccess: string \| null\n}\n\nexport type Observed = {\n latencyMs: number \| null\n [k: string]: unknown\n}\n\nexport type CheckError = {\n code: string\n message: string\n}\n\nexport type DependencyCheck = Status & {\n impact: Impact\n mode: Mode\n freshness: Freshness\n observed?: Observed\n details?: Record<string, unknown>\n error?: CheckError \| null\n since?: string \| null\n}\n\nexport type ReadinessSummary = {\n critical: { ok: number; failing: number }\n nonCritical: { ok: number; degraded: number; failing: number }\n degradedReasons: string[]\n}\n\nexport type ReadinessPayload = Status & {\n timestamp: string\n service?: { name?: string; version?: string; instanceId?: string }\n summary: ReadinessSummary\n checks: Record<string, DependencyCheck>\n}\n\nexport type HealthSummary = Status &\n Pick<ReadinessPayload, 'summary' \| 'checks'> &\n Pick<Liveness, 'system' \| 'process'> & { timestamp: string }\n\nexport class TimeoutError extends Error {\n constructor() {\n super('timeout')\n this.name = 'TimeoutError'\n }\n}\n\nexport class UnknownError extends Error {\n constructor() {\n super('unknown')\n this.name = 'UnknownError'\n }\n}\n","import { TimeoutError } from './types'\n\nexport const wait = (ms: number) =>\n new Promise<void>((resolve) => setTimeout(resolve, ms))\n\nexport const runTimeoutTimer = async (ms: number) => {\n await wait(ms)\n throw new TimeoutError()\n}\n\nexport const runAgainstTimeout = <T>(\n promise: Promise<T>,\n ms?: number \| undefined\n): Promise<T> => {\n if ((ms as number) > 0) {\n return Promise.race([promise, runTimeoutTimer(ms as number)])\n }\n\n return promise\n}\n\n/*\n Throttles an async function:\n * - coalesces concurrent calls into a single in-flight Promise,\n * - after it settles, reuses that settled Promise for `ms` ms,\n * - then clears so the next call invokes `fn` again.\n \n Fully preserves the original function signature.\n /\nexport const throttle = <F extends (...args: unknown[]) => Promise<unknown>>(\n fn: F,\n ms: number\n) => {\n type R = ReturnType<F> // a Promise<T>\n\n let current: R \| null = null\n let clearHandle: NodeJS.Timeout \| null = null\n\n const wrapped = (...args: Parameters<F>): R => {\n if (!current) {\n current = fn(...args) as R\n\n if (clearHandle) {\n clearTimeout(clearHandle)\n clearHandle = null\n }\n\n current.finally(() => {\n if (ms > 0) {\n clearHandle = setTimeout(() => {\n current = null\n clearHandle = null\n }, ms)\n } else {\n current = null\n }\n })\n }\n\n return current\n }\n\n // Cast to F so the returned function has the identical* callable type\n return wrapped as unknown as F\n}\n\n/*\n Wraps an async function so that concurrent invocations share the same in-flight Promise.\n * After the Promise settles (resolve or reject), the next call will invoke the function again.\n * Essentially just throttled with timeout 0\n /\nexport const singleFlight = <\n F extends (...args: unknown[]) => Promise<unknown>,\n>(\n fn: F\n) => throttle<F>(fn, 0)\n","import { performance } from 'node:perf_hooks'\nimport { runAgainstTimeout, singleFlight } from './timing'\nimport {\n type CheckError,\n type DependencyCheck,\n type DependencyStatusValue,\n type Freshness,\n type Impact,\n type Mode,\n type Observed,\n type StatusValue,\n TimeoutError,\n UnknownError,\n} from './types'\n\n/\n Base configuration shared by all dependency monitor modes.\n /\ntype BaseConfig = {\n /\n Importance of the dependency:\n * - `'critical'` → service cannot run without it\n * - `'non_critical'` → service is degraded but still functional if it fails\n /\n impact: Impact\n\n /\n Polling interval in milliseconds.\n * - Required for polled and async modes\n * - Must not be set for inline mode\n /\n pollRate?: number\n\n /\n Polling interval in milliseconds for failed calls.\n * - Defaults to pollRate for polled and async modes\n * - Must not be set for inline mode\n /\n retryRate?: number\n\n /\n Maximum response time in milliseconds considered healthy.\n * - A call resolving within this time window and returning `\"ok\"` → status `\"ok\"`\n * - A call resolving after this but before `timeoutLimitMs` → status `\"degraded\"`\n /\n healthyLimitMs: number\n\n /\n Absolute upper bound in milliseconds; beyond this a call is considered `\"error\"`.\n * - Inline: the awaited call is raced with a timeout and rejected past this limit\n * - Polled/Async: escalate `unknown` → `degraded` at `healthyLimitMs`, then `\"error\"` at `timeoutLimitMs`\n * - Any late `\"ok\"` result after this limit is ignored\n /\n timeoutLimitMs: number\n}\n\n/\n Inline mode configuration (no polling).\n * `syncCall` runs only when {@link DependencyMonitor.check} is invoked.\n /\nexport type SyncInlineConfig = BaseConfig & {\n /* Performs the check immediately when {@link DependencyMonitor.check} is called. /\n syncCall: () => Promise<DependencyStatusValue \| Error>\n asyncCall?: never\n pollRate?: undefined\n retryRate?: undefined\n}\n\n/\n Polled mode configuration.\n * `syncCall` runs on an interval (`pollRate`) and results are cached.\n /\nexport type SyncPolledConfig = BaseConfig & {\n /* Performs the check at each poll interval. /\n syncCall: () => Promise<DependencyStatusValue \| Error>\n /* Polling interval in milliseconds. /\n pollRate: number\n asyncCall?: never\n}\n\n/\n Async mode configuration.\n * `asyncCall` starts a check and must report via the provided callback.\n /\nexport type AsyncConfig = BaseConfig & {\n /\n Starts an asynchronous check. Must call `reportResponse` once a result is available.\n * The callback may be invoked with a `DependencyStatusValue` or an `Error`.\n /\n asyncCall: (\n reportResponse: (\n status: DependencyStatusValue \| Error\n ) => void \| Promise<void>\n ) => void \| Promise<void>\n /* Polling interval in milliseconds. /\n pollRate: number\n syncCall?: never\n}\n\n/\n Discriminated configuration for a dependency monitor.\n * - {@link SyncInlineConfig} → inline checks on demand\n * - {@link SyncPolledConfig} → synchronous checks on a fixed interval\n * - {@link AsyncConfig} → asynchronous checks that report back via callback\n /\nexport type DependencyMonitorConfig =\n \| SyncInlineConfig\n \| SyncPolledConfig\n \| AsyncConfig\n\n/\n Tracks the health of a single dependency in one of three modes:\n \n - inline: `syncCall` executed only when {@link check} is called\n * - polled: `syncCall` executed on `pollRate`; latest result cached\n * - async: `asyncCall` executed on `pollRate`, result returned via callback\n \n The monitor:\n * - classifies results using `healthyLimitMs` and `timeoutLimitMs`\n * - records freshness (`lastChecked`, `lastSuccess`)\n * - records observed latency (ms) when applicable\n \n Status interpretation:\n * - `\"ok\"` only if returned `\"ok\"` and latency ≤ `healthyLimitMs`\n * - `\"degraded\"` if returned `\"degraded\"` or latency > `healthyLimitMs` but ≤ `timeoutLimitMs`\n * - `\"error\"` if returned `\"error\"`, an `Error`, or exceeded `timeoutLimitMs`\n * - `\"unknown\"` is the initial state before first successful/failed result (polled/async)\n /\nexport class DependencyMonitor {\n /* Immutable configuration for this monitor. /\n private readonly config: DependencyMonitorConfig\n /* Operational mode determined from the configuration. /\n private readonly mode: Mode\n\n /* Last computed status (starts as `\"unknown\"` until first result). /\n private status: StatusValue\n /* Optional error details from the last failure. /\n private error?: CheckError\n /* Last observed metrics (e.g., latency). /\n private observed?: Observed\n /* Freshness timestamps for last check/success. /\n private freshness?: Freshness\n\n /* Indicates whether this monitor has been disposed. /\n private isDisposed = false\n /* Internal timer handle for polling/retry. /\n private timeout?: NodeJS.Timeout\n\n /\n Create a new {@link DependencyMonitor}.\n * @param config Monitor configuration (inline, polled, or async).\n /\n constructor(config: DependencyMonitorConfig) {\n this.config = config\n\n this.mode = config.asyncCall\n ? 'async'\n : config.pollRate\n ? 'polled'\n : 'inline'\n\n this.status = 'unknown'\n\n // Deduplicate concurrent inline checks (single-flight).\n if (this.mode === 'inline') {\n this.check = singleFlight(this.check.bind(this))\n }\n\n // Kick off the first cycle for polled/async.\n if (this.mode !== 'inline') {\n this.doCheck()\n }\n }\n\n /* Impact of this dependency (critical/non_critical). /\n public get impact() {\n return this.config.impact\n }\n\n /\n Run one check cycle depending on the configured mode.\n * - Inline: no-op here (runs in {@link check})\n * - Polled/Async: invoked automatically and re-scheduled as needed\n /\n private async doCheck() {\n if (this.timeout) {\n clearTimeout(this.timeout)\n }\n if (this.isDisposed) {\n return\n }\n\n if (this.config.syncCall) {\n await this.doSyncCheck()\n } else {\n this.doAsyncCheck()\n }\n }\n\n /\n Execute a synchronous (inline/polled) check and update internal state.\n * Classification:\n * - OK if `\"ok\"` and latency ≤ `healthyLimitMs`\n * - Degraded if `\"degraded\"` or latency between `(healthyLimitMs, timeoutLimitMs]`\n * - Error if `\"error\"`, `Error`, or timeout exceeded\n /\n private async doSyncCheck() {\n const start = performance.now()\n\n const { syncCall, timeoutLimitMs } = this.config as SyncInlineConfig\n\n try {\n const response = await runAgainstTimeout(syncCall(), timeoutLimitMs)\n const duration = performance.now() - start\n\n this.handleDependencyResponse(response, duration)\n } catch (err) {\n this.handleDependencyError(err as Error)\n }\n }\n\n /\n Execute an asynchronous check (async mode).\n * - Initializes timers to escalate `unknown` → `degraded` → `error`\n * if no callback result arrives within the thresholds.\n * - On callback, clears timers and classifies the result with latency.\n /\n private async doAsyncCheck() {\n const { asyncCall, healthyLimitMs, timeoutLimitMs } = this\n .config as AsyncConfig\n\n const start = performance.now()\n let callActive = true\n let healthTimeout: NodeJS.Timeout \| undefined\n let serviceTimeout: NodeJS.Timeout \| undefined\n\n asyncCall((response) => {\n if (!callActive) return\n callActive = false\n clearTimeout(healthTimeout)\n clearTimeout(serviceTimeout)\n\n const duration = performance.now() - start\n this.handleDependencyResponse(response, duration)\n })\n\n // Escalate to degraded after healthy limit if still waiting.\n healthTimeout = setTimeout(() => {\n if (callActive) this.status = 'degraded'\n }, healthyLimitMs)\n\n // Escalate to error after timeout limit if still waiting.\n serviceTimeout = setTimeout(() => {\n if (!callActive) return\n callActive = false\n clearTimeout(healthTimeout)\n this.handleDependencyError(new TimeoutError())\n }, timeoutLimitMs)\n }\n\n /\n Normalize a successful dependency response into status + metadata.\n * @param response Returned status value or Error from the dependency\n * @param duration Measured latency in milliseconds\n /\n private handleDependencyResponse(\n response: DependencyStatusValue \| Error,\n duration: number\n ) {\n if (response instanceof Error) {\n return this.handleDependencyError(response)\n }\n if (response === 'error') {\n return this.handleDependencyError(new UnknownError())\n }\n\n this.error = undefined\n this.status =\n response === 'ok' && duration <= this.config.healthyLimitMs\n ? 'ok'\n : 'degraded'\n\n const end = new Date()\n this.freshness = {\n lastChecked: end.toISOString(),\n lastSuccess: end.toISOString(),\n }\n\n this.observed = { latencyMs: duration }\n\n // Schedule next poll if applicable.\n if (this.config.pollRate && !this.isDisposed) {\n const delay = this.config.pollRate\n this.timeout = setTimeout(() => this.doCheck(), delay)\n }\n }\n\n /\n Normalize a failed dependency result into `\"error\"` and update metadata.\n * @param error Error thrown/returned or synthesized (e.g., timeout)\n /\n private handleDependencyError(error: Error & { code?: string }) {\n this.status = 'error'\n this.observed = undefined\n this.error = {\n code: error.code \|\| 'UNKNOWN',\n message: error.message,\n }\n\n const end = new Date()\n if (this.freshness) {\n this.freshness.lastChecked = end.toISOString()\n } else {\n this.freshness = { lastChecked: end.toISOString(), lastSuccess: null }\n }\n\n // Schedule retry/poll if configured.\n if ((this.config.retryRate \|\| this.config.pollRate) && !this.isDisposed) {\n const delay = this.config.retryRate \|\| this.config.pollRate\n this.timeout = setTimeout(() => this.doCheck(), delay)\n }\n }\n\n /\n Get a snapshot of the dependency’s current health.\n * - Inline mode: executes the `syncCall` (single-flight guarded)\n * - Polled/Async: returns the cached result\n * @throws if the monitor has been disposed\n /\n public async check(): Promise<DependencyCheck> {\n if (this.isDisposed) {\n throw new Error('DependencyMonitor has been disposed')\n }\n\n if (this.mode === 'inline') {\n await this.doCheck()\n }\n\n const result: DependencyCheck = {\n status: this.status as StatusValue,\n impact: this.config.impact,\n mode: this.mode,\n freshness: this.freshness as Freshness,\n observed: this.observed,\n error: this.error,\n }\n\n return result\n }\n\n /* Symbol-based disposer for use with `using`. /\n public [Symbol.dispose]() {\n this.dispose()\n }\n\n /\n Dispose the monitor:\n * - Clears any scheduled timers\n * - Prevents further checks from running\n /\n public dispose() {\n this.isDisposed = true\n if (this.timeout) {\n clearTimeout(this.timeout)\n }\n }\n}\n","import os from 'node:os'\nimport type { Liveness, Status } from './types'\n\nexport const ping = (): Status => ({ status: 'ok' })\nexport const liveness = (): Liveness => {\n const cpus = os.cpus()\n const total = os.totalmem()\n const free = os.freemem()\n\n return {\n status: 'ok',\n timestamp: new Date().toISOString(),\n system: {\n hostname: os.hostname(),\n platform: os.platform(),\n release: os.release(),\n arch: os.arch(),\n uptime: os.uptime(),\n loadavg: os.loadavg() as [number, number, number],\n totalmem: total,\n freemem: free,\n memUsedRatio: total > 0 ? (total - free) / total : 0,\n cpus: {\n count: cpus.length,\n model: cpus[0]?.model,\n speedMHz: cpus[0]?.speed,\n },\n },\n process: {\n pid: process.pid,\n node: process.versions.node,\n uptime: process.uptime(),\n memory: process.memoryUsage(), // rss, heapTotal, heapUsed, external, arrayBuffers\n },\n }\n}\n","import { toEntity } from '@sebspark/hyper-media'\nimport { type ErrorRequestHandler, Router } from 'express'\nimport type {\n DependencyMonitor,\n DependencyMonitorConfig,\n} from './dependency-monitor'\nimport { liveness, ping } from './static-checks'\nimport { throttle } from './timing'\nimport type {\n DependencyCheck,\n HealthSummary,\n Impact,\n ReadinessPayload,\n ReadinessSummary,\n} from './types'\n\nexport interface HealthMonitorConfig {\n throttle: number\n}\n\n/\n HealthMonitor wires up standard health check endpoints for an Express app.\n \n It provides three endpoints under `/health`:\n * - /ping → lightweight always-OK response (`{ status: \"ok\" }`)\n * - /live → liveness probe (`{ status, uptime, timestamp }`)\n * - /ready → readiness probe with dependency checks (`{ status, checks }`)\n \n Dependencies can be added via {@link addDependency} with a {@link DependencyMonitorConfig}.\n * Each dependency is wrapped in a {@link DependencyMonitor} and tracked for readiness.\n \n ### Example\n \n ```ts\n * import express from 'express'\n * import { HealthMonitor } from './health-monitor'\n \n const app = express()\n * const monitor = new HealthMonitor()\n \n monitor.addDependency('db', {\n * impact: 'critical',\n * syncCall: async () => {\n * await db.ping()\n * return 'ok'\n * }\n * })\n \n app.use(monitor.router)\n * app.listen(3000)\n * ```\n /\nexport class HealthMonitor {\n private readonly _router: Router\n private readonly dependencies: Map<string, DependencyMonitor>\n // private isDisposed = false\n\n /\n Create a new HealthMonitor instance with its own router and dependency map.\n /\n constructor(config?: HealthMonitorConfig) {\n this._router = this.createRouter()\n this.dependencies = new Map()\n\n const thr = config ? config.throttle : 10\n if (thr > 0) {\n this.ready = throttle(this.ready.bind(this), thr)\n }\n }\n\n /\n Register a named dependency to be checked as part of readiness.\n \n @param name - Identifier for the dependency (e.g. \"postgres\", \"redis\").\n * @param dependency - DependencyMonitor\n * @returns this for chaining\n \n @example\n * ```ts\n * monitor.addDependency('redis', new DependencyMonitor({\n * impact: 'critical',\n * pollRate: 5000,\n * syncCall: async () => redis.ping() ? 'ok' : 'error'\n * }))\n * ```\n /\n public addDependency(name: string, dependency: DependencyMonitor) {\n this.dependencies.set(name, dependency)\n return this\n }\n\n /\n Internal: create the Express router with /health routes.\n /\n private createRouter() {\n const router = Router()\n\n // Health\n router.get('/health', async (req, res, next) => {\n try {\n const health = await this.health()\n res.status(200).json(\n toEntity(req, health, {\n ping: '/health/ping',\n live: '/health/live',\n ready: '/health/ready',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Ping\n router.get('/health/ping', (req, res, next) => {\n try {\n res.status(200).json(\n toEntity(req, this.ping(), {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Liveness\n router.get('/health/live', (req, res, next) => {\n try {\n res.status(200).json(\n toEntity(req, this.live(), {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Readiness\n router.get('/health/ready', async (req, res, next) => {\n try {\n const readiness = await this.ready()\n const status = readiness.summary.critical.failing > 0 ? 503 : 200\n res.status(status).json(\n toEntity(req, readiness, {\n health: '/health',\n })\n )\n } catch (err) {\n next?.(err)\n }\n })\n\n // Error handler\n const errorHandler: ErrorRequestHandler = (err, _req, res, _next) => {\n const message = err instanceof Error ? err.message : String(err)\n res.status(500).json({\n status: 'error',\n error: { message },\n })\n }\n router.use(errorHandler)\n\n return router\n }\n\n /\n Static ping check — always returns `{ status: \"ok\" }`.\n /\n public ping() {\n return ping()\n }\n\n /\n Liveness probe: reports uptime and current timestamp.\n /\n public live() {\n return liveness()\n }\n\n /\n Readiness probe: runs all registered dependencies in parallel\n * and aggregates their results into an overall status.\n \n - Any critical error → `\"error\"`\n * - Else any critical degraded or any non-critical degraded/error → `\"degraded\"`\n * - Else → `\"ok\"`\n \n @returns Object with overall `status` and per-dependency `checks`\n \n @example\n * ```json\n * {\n * \"status\": \"ok\",\n * \"checks\": {\n * \"postgres\": {\n * \"status\": \"ok\",\n * \"impact\": \"critical\",\n * \"mode\": \"inline\",\n * \"freshness\": {\n * \"lastChecked\": \"2025-08-19T12:00:00Z\",\n * \"lastSuccess\": \"2025-08-19T12:00:00Z\"\n * },\n * \"observed\": { \"latencyMs\": 12 }\n * }\n * }\n * }\n * ```\n /\n public async ready(): Promise<ReadinessPayload> {\n const entries = Array.from(this.dependencies.entries())\n\n const settled = await Promise.allSettled(\n entries.map(async ([name, monitor]) => {\n const check = await monitor.check()\n return [name, check] as const\n })\n )\n\n const checks: Record<string, DependencyCheck> = {}\n\n for (let i = 0; i < settled.length; i++) {\n const s = settled[i]\n const [name] = entries[i]\n\n if (s.status === 'fulfilled') {\n const [, check] = s.value\n checks[name] = check\n } else {\n checks[name] = {\n status: 'error',\n impact: this.dependencies.get(name)?.impact as Impact,\n mode: 'polled',\n freshness: {\n lastChecked: new Date().toISOString(),\n lastSuccess: null,\n },\n observed: undefined,\n error: {\n code: 'CHECK_FAILED',\n message: String(s.reason ?? 'unknown error'),\n },\n }\n }\n }\n\n // ----- summary -------------------------------------------------------------\n let criticalOk = 0\n let criticalFailing = 0 // counts any non-ok critical (degraded OR error)\n\n let nonCritOk = 0\n let nonCritDegraded = 0\n let nonCritFailing = 0 // non-critical with status === 'error'\n\n const degradedReasons: string[] = []\n\n for (const [name, c] of Object.entries(checks)) {\n const isCritical = c.impact === 'critical'\n if (c.status === 'ok') {\n if (isCritical) criticalOk++\n else nonCritOk++\n } else if (c.status === 'degraded') {\n if (isCritical)\n criticalFailing++ // critical degraded counts as failing\n else nonCritDegraded++\n degradedReasons.push(`${name}:degraded`)\n } else {\n // 'error'\n if (isCritical) criticalFailing++\n else nonCritFailing++\n degradedReasons.push(`${name}:${c.error?.code ?? 'error'}`)\n }\n }\n\n const summary: ReadinessSummary = {\n critical: { ok: criticalOk, failing: criticalFailing },\n nonCritical: {\n ok: nonCritOk,\n degraded: nonCritDegraded,\n failing: nonCritFailing,\n },\n degradedReasons,\n }\n\n // ----- overall status (same rules as before) -------------------------------\n let status: import('./types').StatusValue = 'ok'\n const values = Object.values(checks)\n const anyCriticalError = values.some(\n (c) => c.impact === 'critical' && c.status === 'error'\n )\n const anyDegradedOrError = values.some(\n (c) => c.status === 'degraded' \|\| c.status === 'error'\n )\n const anyCriticalDegraded = values.some(\n (c) => c.impact === 'critical' && c.status === 'degraded'\n )\n\n if (anyCriticalError) status = 'error'\n else if (anyCriticalDegraded \|\| anyDegradedOrError) status = 'degraded'\n\n // ----- payload -------------------------------------------------------------\n const payload: ReadinessPayload = {\n status,\n timestamp: new Date().toISOString(),\n // service: { name, version, instanceId } // (optional; if you add config later)\n summary,\n checks,\n }\n\n return payload\n }\n\n public async health() {\n const { status, checks, summary } = await this.ready()\n const { timestamp, system, process } = this.live()\n\n return {\n status,\n timestamp,\n system,\n process,\n checks,\n summary,\n } as HealthSummary\n }\n\n /\n Accessor for the Express router that exposes /health endpoints.\n /\n public get router() {\n return this._router\n }\n\n /\n Symbol-based disposer for use with `using`.\n /\n public [Symbol.dispose]() {\n this.dispose()\n }\n\n /\n Dispose of the monitor:\n * - marks as disposed\n * - (future: could also stop all dependency monitors)\n */\n public dispose() {\n // this.isDisposed = true\n for (const dependency of this.dependencies.values()) {\n dependency.dispose()\n }\n }\n}\n"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sebspark/health-check",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.mjs",