@entwico/health-probes 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 entwico GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,320 @@
+# health-probes
+
+Health check probes for Node.js. Provides liveness, readiness, startup, and health status endpoints on a separate HTTP server. Framework-agnostic — works with any Node.js application.
+
+## Installation
+
+```bash
+npm install @entwico/health-probes
+```
+
+## Usage
+
+```ts
+import { checks, probes, server } from '@entwico/health-probes';
+
+// start health server on a separate port
+// default host is '127.0.0.1' for security reasons
+// use host: '0.0.0.0' in k8s containers so the kubelet can reach the probes
+server.start({ host: '0.0.0.0', port: 9090 });
+
+// enable liveness immediately
+probes.live.enable();
+
+// initialize your app...
+await connectToDatabase();
+
+// register health checks
+checks.register('database', () => db.ping());
+
+// enable startup probe (initialization complete)
+probes.startup.enable();
+
+// enable readiness probe (ready for traffic)
+probes.ready.enable();
+```
+
+### Graceful shutdown
+
+```ts
+// disable readiness first (stop receiving traffic)
+probes.ready.disable();
+
+await disconnectFromDatabase();
+
+// stop health server
+await server.stop();
+```
+
+## Probes
+
+### Liveness Probe
+
+Indicates if the process is running. If this fails, the orchestrator should restart the container.
+
+```ts
+probes.live.enable(); // returns 200 OK
+probes.live.disable(); // returns 503 Service Unavailable
+```
+
+### Startup Probe
+
+Indicates if the application has finished initializing.
+
+```ts
+probes.startup.enable();
+probes.startup.disable();
+```
+
+### Readiness Probe
+
+Indicates if the application is ready to receive traffic. When disabled or when required health checks fail, returns 503.
+
+```ts
+probes.ready.enable();
+probes.ready.disable();
+```
+
+The readiness probe automatically runs all non-optional health checks and returns 503 if any fail.
+
+### Health Status
+
+Returns detailed JSON status of all probes and health checks. Useful for debugging and dashboards.
+
+```json
+{
+  "status": "healthy",
+  "probes": {
+    "live": true,
+    "startup": true,
+    "ready": true
+  },
+  "checks": {
+    "database": {
+      "status": "healthy",
+      "latency": 12
+    },
+    "redis": {
+      "status": "unhealthy",
+      "latency": 5003,
+      "error": "check \"redis\" timed out after 5000ms"
+    }
+  }
+}
+```
+
+Status values:
+
+- `healthy` — all checks pass
+- `degraded` — optional checks failing, required checks pass
+- `unhealthy` — required checks failing
+
+## Health Checks
+
+Register health checks to verify dependencies are working:
+
+```ts
+import { checks } from '@entwico/health-probes';
+
+// return result (recommended for boolean checks)
+checks.register('database', () => ({
+  status: db.isConnected() ? 'healthy' : 'unhealthy',
+  error: db.isConnected() ? undefined : 'connection lost',
+}));
+
+// throw-based (classic pattern)
+checks.register('cache', async () => {
+  await redis.ping(); // throws if fails
+});
+
+// with options
+checks.register({
+  name: 'external-api',
+  check: () => fetch('https://api.example.com/health').then(() => {}),
+  optional: true, // doesn't affect readiness, only health status
+  timeout: 10000, // custom timeout (default: 5000ms)
+});
+```
+
+The check function can either:
+
+- Return `HealthCheckResult` with status and optional error
+- Return `void` (completing without error = healthy)
+- Throw an error (= unhealthy with error message)
+
+### Unregistering Checks
+
+`register()` returns an unregister function:
+
+```ts
+const unregister = checks.register({
+  name: 'database',
+  check: () => db.ping(),
+});
+
+// later...
+unregister();
+```
+
+## Server Options
+
+```ts
+server.start({
+  host: '0.0.0.0', // default: '127.0.0.1'
+  port: 9090, // default: 9090
+});
+```
+
+Resolution order: **explicit option > environment variable > default**.
+
+| Setting | Env Variable    | Default       |
+| ------- | --------------- | ------------- |
+| host    | `HEALTH_HOST`   | `127.0.0.1`   |
+| port    | `HEALTH_PORT`   | `9090`        |
+
+This means `server.start()` with no arguments will pick up `HEALTH_HOST` / `HEALTH_PORT` from the environment if set.
+
+### Custom Paths
+
+By default, endpoints use Kubernetes-style paths (`/livez`, `/readyz`, `/startupz`, `/healthz`). You can customize them:
+
+```ts
+import { SimplePaths } from '@entwico/health-probes';
+
+// use simple paths: /live, /ready, /startup, /health
+server.start({ paths: SimplePaths });
+
+// or mix and match
+server.start({
+  paths: {
+    live: '/healthcheck',
+    ready: '/ready',
+  },
+});
+```
+
+Built-in path presets:
+
+| Preset               | live     | startup     | ready     | health     |
+| -------------------- | -------- | ----------- | --------- | ---------- |
+| `K8sPaths` (default) | `/livez` | `/startupz` | `/readyz` | `/healthz` |
+| `SimplePaths`        | `/live`  | `/startup`  | `/ready`  | `/health`  |
+
+## Kubernetes Configuration
+
+```yaml
+apiVersion: v1
+kind: Pod
+spec:
+  containers:
+    - name: app
+      ports:
+        - containerPort: 3000 # app
+        - containerPort: 9090 # health
+      livenessProbe:
+        httpGet:
+          path: /livez
+          port: 9090
+        initialDelaySeconds: 0
+        periodSeconds: 10
+      startupProbe:
+        httpGet:
+          path: /startupz
+          port: 9090
+        failureThreshold: 30
+        periodSeconds: 2
+      readinessProbe:
+        httpGet:
+          path: /readyz
+          port: 9090
+        periodSeconds: 5
+```
+
+## API Reference
+
+### Server
+
+```ts
+import { server } from '@entwico/health-probes';
+
+server.start(options?: HealthServerOptions): void;
+server.stop(): Promise<void>;
+```
+
+### Probes
+
+```ts
+import { probes } from '@entwico/health-probes';
+
+probes.live.enable(): void;
+probes.live.disable(): void;
+probes.live.get(): Promise<HealthProbeResult>;
+probes.live.response(): Promise<Response>;
+
+// same for startup, ready
+
+probes.health.get(): Promise<HealthResult>;
+probes.health.response(): Promise<Response>;
+```
+
+### Checks
+
+```ts
+import { checks } from '@entwico/health-probes';
+
+checks.register(name: string, check: CheckFn): () => void;
+checks.register(check: HealthCheck): () => void;
+
+// CheckFn = () => Promise<HealthCheckResult | void> | HealthCheckResult | void
+checks.getChecks(): HealthCheck[];
+checks.runAll(): Promise<Record<string, HealthCheckResult>>;
+checks.runRequired(): Promise<boolean>;
+```
+
+## Types
+
+```ts
+interface ProbePaths {
+  live?: string;
+  startup?: string;
+  ready?: string;
+  health?: string;
+}
+
+interface HealthServerOptions {
+  host?: string; // env: HEALTH_HOST, default: '127.0.0.1'
+  port?: number; // env: HEALTH_PORT, default: 9090
+  paths?: ProbePaths; // default: K8sPaths
+}
+
+interface HealthCheck {
+  name: string;
+  check: () => Promise<HealthCheckResult | void> | HealthCheckResult | void;
+  optional?: boolean; // default: false
+  timeout?: number; // default: 5000
+}
+
+interface HealthCheckResult {
+  status: 'healthy' | 'unhealthy';
+  latency?: number;
+  error?: string;
+}
+
+interface HealthProbeResult {
+  passing: boolean;
+}
+
+interface HealthResult {
+  status: 'healthy' | 'degraded' | 'unhealthy';
+  probes: {
+    live: boolean;
+    startup: boolean;
+    ready: boolean;
+  };
+  checks: Record<string, HealthCheckResult>;
+}
+```
+
+## License
+
+MIT

package/dist/checks.d.ts

@@ -0,0 +1,12 @@
+import type { HealthCheck, HealthCheckResult } from './types.js';
+export declare class HealthChecks {
+    private readonly registered;
+    register(name: string, check: () => Promise<HealthCheckResult | void> | HealthCheckResult | void): () => void;
+    register(check: HealthCheck): () => void;
+    private run;
+    runAll(): Promise<Record<string, HealthCheckResult>>;
+    runRequired(): Promise<boolean>;
+    getChecks(): HealthCheck[];
+}
+export declare const checks: HealthChecks;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOjE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAM7D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,iBAAiB,GAAG,IAAI,GAAG,MAAM,IAAI;IAC7G,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,IAAI;YAqB1B,GAAG;IA8BX,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAkBpD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC,SAAS,IAAI,WAAW,EAAE;CAG3B;AAED,eAAO,MAAM,MAAM,cAAqB,CAAC"}

package/dist/checks.js

@@ -0,0 +1,63 @@
+const DEFAULT_TIMEOUT = 5000;
+export class HealthChecks {
+    registered = new Map();
+    register(nameOrCheck, checkFn) {
+        const check = typeof nameOrCheck === 'string' ? { name: nameOrCheck, check: checkFn } : nameOrCheck;
+        if (this.registered.has(check.name)) {
+            console.warn(`[health] overwriting existing check "${check.name}"`);
+        }
+        this.registered.set(check.name, check);
+        return () => {
+            this.registered.delete(check.name);
+        };
+    }
+    async run(check) {
+        const timeout = check.timeout ?? DEFAULT_TIMEOUT;
+        const start = performance.now();
+        try {
+            const result = await Promise.race([
+                Promise.resolve(check.check()),
+                new Promise((_, reject) => {
+                    setTimeout(() => reject(new Error(`check "${check.name}" timed out after ${timeout}ms`)), timeout);
+                }),
+            ]);
+            const latency = Math.round(performance.now() - start);
+            if (result) {
+                return { ...result, latency };
+            }
+            return { status: 'healthy', latency };
+        }
+        catch (error) {
+            const latency = Math.round(performance.now() - start);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { status: 'unhealthy', latency, error: errorMessage };
+        }
+    }
+    async runAll() {
+        const results = {};
+        const checks = [...this.registered.values()];
+        const checkPromises = checks.map(async (check) => {
+            const result = await this.run(check);
+            results[check.name] = result;
+        });
+        await Promise.all(checkPromises);
+        return results;
+    }
+    async runRequired() {
+        const requiredChecks = [...this.registered.values()].filter((check) => !check.optional);
+        if (requiredChecks.length === 0) {
+            return true;
+        }
+        const checkPromises = requiredChecks.map(async (check) => {
+            const result = await this.run(check);
+            return result.status === 'healthy';
+        });
+        const results = await Promise.all(checkPromises);
+        return results.every(Boolean);
+    }
+    getChecks() {
+        return [...this.registered.values()];
+    }
+}
+export const checks = new HealthChecks();
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { server } from './server.js';
+export { probes } from './probes.js';
+export { checks } from './checks.js';
+export { HealthServer } from './server.js';
+export { HealthProbes } from './probes.js';
+export { HealthChecks } from './checks.js';
+export { K8sPaths, SimplePaths } from './paths.js';
+export type { HealthCheck, HealthCheckResult, HealthProbe, HealthProbeResult, HealthResult, HealthServerOptions, HealthStatusProbe, ProbePaths, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGnD,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { server } from './server.js';
+export { probes } from './probes.js';
+export { checks } from './checks.js';
+export { HealthServer } from './server.js';
+export { HealthProbes } from './probes.js';
+export { HealthChecks } from './checks.js';
+export { K8sPaths, SimplePaths } from './paths.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,4 @@
+import type { ProbePaths } from './types.js';
+export declare const K8sPaths: Required<ProbePaths>;
+export declare const SimplePaths: Required<ProbePaths>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAKzC,CAAC;AAKF,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,UAAU,CAK5C,CAAC"}

package/dist/paths.js

@@ -0,0 +1,13 @@
+export const K8sPaths = {
+    live: '/livez',
+    startup: '/startupz',
+    ready: '/readyz',
+    health: '/healthz',
+};
+export const SimplePaths = {
+    live: '/live',
+    startup: '/startup',
+    ready: '/ready',
+    health: '/health',
+};
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,QAAQ,GAAyB;IAC5C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;CACnB,CAAC;AAKF,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;CAClB,CAAC"}

package/dist/probes.d.ts

@@ -0,0 +1,11 @@
+import type { HealthProbe, HealthStatusProbe } from './types.js';
+export declare class HealthProbes {
+    private state;
+    private createProbeResponse;
+    readonly live: HealthProbe;
+    readonly startup: HealthProbe;
+    readonly ready: HealthProbe;
+    readonly health: HealthStatusProbe;
+}
+export declare const probes: HealthProbes;
+//# sourceMappingURL=probes.d.ts.map

package/dist/probes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../src/probes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAmC,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKlG,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAIX;IAEF,OAAO,CAAC,mBAAmB;IAO3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAaxB;IAEF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAa3B;IAEF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAazB;IAEF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAiChC;CACH;AAED,eAAO,MAAM,MAAM,cAAqB,CAAC"}

package/dist/probes.js

@@ -0,0 +1,87 @@
+import { checks } from './checks.js';
+export class HealthProbes {
+    state = {
+        live: false,
+        startup: false,
+        ready: false,
+    };
+    createProbeResponse(result) {
+        return new Response(result.passing ? 'OK' : 'Service Unavailable', {
+            status: result.passing ? 200 : 503,
+            headers: { 'Content-Type': 'text/plain' },
+        });
+    }
+    live = {
+        enable: () => {
+            this.state.live = true;
+        },
+        disable: () => {
+            this.state.live = false;
+        },
+        get: async () => {
+            return { passing: this.state.live };
+        },
+        response: async () => {
+            return this.createProbeResponse(await this.live.get());
+        },
+    };
+    startup = {
+        enable: () => {
+            this.state.startup = true;
+        },
+        disable: () => {
+            this.state.startup = false;
+        },
+        get: async () => {
+            return { passing: this.state.startup };
+        },
+        response: async () => {
+            return this.createProbeResponse(await this.startup.get());
+        },
+    };
+    ready = {
+        enable: () => {
+            this.state.ready = true;
+        },
+        disable: () => {
+            this.state.ready = false;
+        },
+        get: async () => {
+            return { passing: this.state.ready ? await checks.runRequired() : false };
+        },
+        response: async () => {
+            return this.createProbeResponse(await this.ready.get());
+        },
+    };
+    health = {
+        get: async () => {
+            const checkResults = await checks.runAll();
+            const registered = checks.getChecks();
+            const hasUnhealthy = Object.values(checkResults).some((c) => c.status === 'unhealthy');
+            const hasRequiredUnhealthy = registered
+                .filter((check) => !check.optional)
+                .some((check) => checkResults[check.name]?.status !== 'healthy');
+            let status = 'healthy';
+            if (hasRequiredUnhealthy) {
+                status = 'unhealthy';
+            }
+            else if (hasUnhealthy) {
+                status = 'degraded';
+            }
+            return {
+                status,
+                probes: { live: this.state.live, startup: this.state.startup, ready: this.state.ready },
+                checks: checkResults,
+            };
+        },
+        response: async () => {
+            const result = await this.health.get();
+            return new Response(JSON.stringify(result, null, 2), {
+                status: 200,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        },
+    };
+}
+export const probes = new HealthProbes();
+//# sourceMappingURL=probes.js.map

package/dist/probes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.js","sourceRoot":"","sources":["../src/probes.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import type { HealthServerOptions } from './types.js';
+export declare class HealthServer {
+    private instance;
+    start(options?: HealthServerOptions): void;
+    stop(): Promise<void>;
+    private handleRequest;
+}
+export declare const server: HealthServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,YAAY,CAAC;AAKlE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAuB;IAKvC,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,IAAI;IAqC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBP,aAAa;CAc5B;AAED,eAAO,MAAM,MAAM,cAAqB,CAAC"}

package/dist/server.js

@@ -0,0 +1,66 @@
+import { createServer } from 'node:http';
+import { K8sPaths } from './paths.js';
+import { probes } from './probes.js';
+export class HealthServer {
+    instance = null;
+    start(options = {}) {
+        if (this.instance) {
+            return;
+        }
+        const host = options.host ?? process.env['HEALTH_HOST'] ?? '127.0.0.1';
+        const port = options.port ?? (process.env['HEALTH_PORT'] ? Number(process.env['HEALTH_PORT']) : 9090);
+        const paths = { ...K8sPaths, ...options.paths };
+        const instance = createServer(async (req, res) => {
+            try {
+                const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+                const response = await this.handleRequest(url.pathname, paths);
+                res.statusCode = response.status;
+                for (const [key, value] of response.headers.entries()) {
+                    res.setHeader(key, value);
+                }
+                const body = await response.text();
+                res.end(body);
+            }
+            catch {
+                res.statusCode = 500;
+                res.setHeader('Content-Type', 'text/plain');
+                res.end('Internal Server Error');
+            }
+        });
+        instance.listen(port, host);
+        this.instance = instance;
+    }
+    stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.instance) {
+                resolve();
+                return;
+            }
+            this.instance.close((err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.instance = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    async handleRequest(pathname, paths) {
+        switch (pathname) {
+            case paths.live:
+                return probes.live.response();
+            case paths.startup:
+                return probes.startup.response();
+            case paths.ready:
+                return probes.ready.response();
+            case paths.health:
+                return probes.health.response();
+            default:
+                return new Response('Not Found', { status: 404 });
+        }
+    }
+}
+export const server = new HealthServer();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+export interface ProbePaths {
+    live?: string | undefined;
+    startup?: string | undefined;
+    ready?: string | undefined;
+    health?: string | undefined;
+}
+export interface HealthServerOptions {
+    host?: string | undefined;
+    port?: number | undefined;
+    paths?: ProbePaths | undefined;
+}
+export interface HealthCheck {
+    name: string;
+    check: () => Promise<HealthCheckResult | void> | HealthCheckResult | void;
+    optional?: boolean | undefined;
+    timeout?: number | undefined;
+}
+export interface HealthCheckResult {
+    status: 'healthy' | 'unhealthy';
+    latency?: number | undefined;
+    error?: string | undefined;
+}
+export interface HealthProbeResult {
+    passing: boolean;
+}
+export interface HealthResult {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    probes: {
+        live: boolean;
+        startup: boolean;
+        ready: boolean;
+    };
+    checks: Record<string, HealthCheckResult>;
+}
+export interface HealthProbe {
+    enable(): void;
+    disable(): void;
+    get(): Promise<HealthProbeResult>;
+    response(): Promise<Response>;
+}
+export interface HealthStatusProbe {
+    get(): Promise<HealthResult>;
+    response(): Promise<Response>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAKD,MAAM,WAAW,mBAAmB;IAMlC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAO1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAM1B,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAChC;AAKD,MAAM,WAAW,WAAW;IAI1B,IAAI,EAAE,MAAM,CAAC;IAOb,KAAK,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAAC;IAO1E,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAM/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAKD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAKD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE;QACN,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC3C;AAKD,MAAM,WAAW,WAAW;IAI1B,MAAM,IAAI,IAAI,CAAC;IAKf,OAAO,IAAI,IAAI,CAAC;IAKhB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAKlC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/B;AAKD,MAAM,WAAW,iBAAiB;IAIhC,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAK7B,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@entwico/health-probes",
+  "version": "1.1.0",
+  "description": "Kubernetes-style health check probes for Node.js — framework-agnostic /livez, /readyz, /startupz, and /healthz endpoints",
+  "license": "MIT",
+  "author": "admin@entwico.com",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "health",
+    "healthcheck",
+    "probes",
+    "kubernetes",
+    "k8s",
+    "livez",
+    "readyz",
+    "startupz",
+    "healthz",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/entwico/health-probes"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "prepublishOnly": "npm run build && npm run test && npm run lint",
+    "validate": "run-s lint typecheck test",
+    "lint": "eslint . --report-unused-disable-directives --max-warnings 0",
+    "typecheck": "tsc",
+    "test": "npx tsx --test --experimental-test-coverage src/index.test.ts",
+    "prepare": "husky",
+    "semantic-release": "semantic-release"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^25.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "husky": "^9.1.7",
+    "npm-run-all": "^4.1.5",
+    "semantic-release": "^25.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  }
+}