clodds 1.1.0

package/dist/monitoring/health.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Health Check System
+ *
+ * Features:
+ * - Readiness checks: Is the service ready to accept traffic?
+ * - Liveness checks: Is the service alive and not stuck?
+ * - Component health: Individual subsystem status
+ * - Dependency health: External API/service checks
+ * - Configurable timeouts and thresholds
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
+export interface ComponentHealth {
+    name: string;
+    status: HealthStatus;
+    latencyMs?: number;
+    lastCheck?: number;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface HealthCheckResult {
+    status: HealthStatus;
+    timestamp: number;
+    uptime: number;
+    version: string;
+    components: ComponentHealth[];
+    summary: {
+        total: number;
+        healthy: number;
+        degraded: number;
+        unhealthy: number;
+        unknown: number;
+    };
+}
+export interface ReadinessResult {
+    ready: boolean;
+    timestamp: number;
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        error?: string;
+    }>;
+}
+export interface LivenessResult {
+    alive: boolean;
+    timestamp: number;
+    uptime: number;
+    memory: {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+        percent: number;
+    };
+    eventLoop: {
+        latencyMs: number;
+        healthy: boolean;
+    };
+}
+export interface HealthCheckOptions {
+    /** Timeout for individual checks in ms (default: 5000) */
+    timeout?: number;
+    /** Whether this check is critical for readiness (default: true) */
+    critical?: boolean;
+    /** Minimum interval between checks in ms (default: 0) */
+    cacheMs?: number;
+}
+export type HealthCheckFn = () => Promise<ComponentHealth>;
+export declare class HealthChecker {
+    private checks;
+    private readinessChecks;
+    private startTime;
+    private version;
+    constructor(version?: string);
+    /**
+     * Register a component health check
+     */
+    registerCheck(name: string, fn: HealthCheckFn, options?: HealthCheckOptions): void;
+    /**
+     * Register a readiness check
+     */
+    registerReadinessCheck(name: string, fn: () => Promise<boolean>, options?: HealthCheckOptions): void;
+    /**
+     * Unregister a check
+     */
+    unregisterCheck(name: string): void;
+    /**
+     * Unregister a readiness check
+     */
+    unregisterReadinessCheck(name: string): void;
+    /**
+     * Run all health checks and return overall status
+     */
+    checkHealth(): Promise<HealthCheckResult>;
+    /**
+     * Check if service is ready to accept traffic
+     */
+    checkReadiness(): Promise<ReadinessResult>;
+    /**
+     * Check if service is alive (not stuck)
+     */
+    checkLiveness(): Promise<LivenessResult>;
+    /**
+     * Measure event loop latency
+     */
+    private measureEventLoopLatency;
+    /**
+     * Get uptime in seconds
+     */
+    getUptime(): number;
+}
+/**
+ * Create a database health check
+ */
+export declare function createDatabaseHealthCheck(name: string, queryFn: () => Promise<boolean>, options?: HealthCheckOptions): HealthCheckFn;
+/**
+ * Create an HTTP dependency health check
+ */
+export declare function createHttpHealthCheck(name: string, url: string, options?: {
+    expectedStatus?: number;
+    timeout?: number;
+}): HealthCheckFn;
+/**
+ * Create a WebSocket connection health check
+ */
+export declare function createWebSocketHealthCheck(name: string, isConnectedFn: () => boolean, getStatsFn?: () => {
+    messagesPerSecond: number;
+    lastMessageAt: number;
+}): HealthCheckFn;
+/**
+ * Create a feed health check
+ */
+export declare function createFeedHealthCheck(name: string, platform: string, getStatusFn: () => {
+    connected: boolean;
+    subscriptions: number;
+    messagesPerSecond: number;
+    lastMessageAt: number;
+    errors: number;
+}): HealthCheckFn;
+/**
+ * Create a memory health check
+ */
+export declare function createMemoryHealthCheck(warnThresholdPct?: number, criticalThresholdPct?: number): HealthCheckFn;
+/**
+ * Create an external API health check with circuit breaker pattern
+ */
+export declare function createApiHealthCheck(name: string, checkFn: () => Promise<boolean>, options?: {
+    timeout?: number;
+    failureThreshold?: number;
+    recoveryTime?: number;
+}): HealthCheckFn;
+export declare const healthChecker: HealthChecker;
+export { HealthChecker as default, };

package/dist/monitoring/health.js

@@ -0,0 +1,423 @@
+"use strict";
+/**
+ * Health Check System
+ *
+ * Features:
+ * - Readiness checks: Is the service ready to accept traffic?
+ * - Liveness checks: Is the service alive and not stuck?
+ * - Component health: Individual subsystem status
+ * - Dependency health: External API/service checks
+ * - Configurable timeouts and thresholds
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.healthChecker = exports.HealthChecker = void 0;
+exports.createDatabaseHealthCheck = createDatabaseHealthCheck;
+exports.createHttpHealthCheck = createHttpHealthCheck;
+exports.createWebSocketHealthCheck = createWebSocketHealthCheck;
+exports.createFeedHealthCheck = createFeedHealthCheck;
+exports.createMemoryHealthCheck = createMemoryHealthCheck;
+exports.createApiHealthCheck = createApiHealthCheck;
+// =============================================================================
+// HEALTH CHECKER
+// =============================================================================
+class HealthChecker {
+    checks = new Map();
+    readinessChecks = new Map();
+    startTime = Date.now();
+    version;
+    constructor(version = '1.0.0') {
+        this.version = version;
+    }
+    /**
+     * Register a component health check
+     */
+    registerCheck(name, fn, options = {}) {
+        this.checks.set(name, { fn, options: { timeout: 5000, critical: true, cacheMs: 0, ...options } });
+    }
+    /**
+     * Register a readiness check
+     */
+    registerReadinessCheck(name, fn, options = {}) {
+        this.readinessChecks.set(name, { fn, options: { timeout: 5000, critical: true, ...options } });
+    }
+    /**
+     * Unregister a check
+     */
+    unregisterCheck(name) {
+        this.checks.delete(name);
+    }
+    /**
+     * Unregister a readiness check
+     */
+    unregisterReadinessCheck(name) {
+        this.readinessChecks.delete(name);
+    }
+    /**
+     * Run all health checks and return overall status
+     */
+    async checkHealth() {
+        const components = [];
+        const now = Date.now();
+        for (const [name, check] of this.checks) {
+            try {
+                // Check cache
+                if (check.lastResult && check.options.cacheMs && check.lastResult.lastCheck) {
+                    if (now - check.lastResult.lastCheck < check.options.cacheMs) {
+                        components.push(check.lastResult);
+                        continue;
+                    }
+                }
+                const start = Date.now();
+                const result = await Promise.race([
+                    check.fn(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Health check timeout')), check.options.timeout)),
+                ]);
+                result.latencyMs = Date.now() - start;
+                result.lastCheck = now;
+                // Cache result
+                check.lastResult = result;
+                components.push(result);
+            }
+            catch (error) {
+                const result = {
+                    name,
+                    status: 'unhealthy',
+                    error: error instanceof Error ? error.message : String(error),
+                    lastCheck: now,
+                };
+                check.lastResult = result;
+                components.push(result);
+            }
+        }
+        // Calculate summary
+        const summary = {
+            total: components.length,
+            healthy: components.filter(c => c.status === 'healthy').length,
+            degraded: components.filter(c => c.status === 'degraded').length,
+            unhealthy: components.filter(c => c.status === 'unhealthy').length,
+            unknown: components.filter(c => c.status === 'unknown').length,
+        };
+        // Determine overall status
+        let status = 'healthy';
+        if (summary.unhealthy > 0) {
+            status = 'unhealthy';
+        }
+        else if (summary.degraded > 0 || summary.unknown > 0) {
+            status = 'degraded';
+        }
+        return {
+            status,
+            timestamp: now,
+            uptime: Math.floor((now - this.startTime) / 1000),
+            version: this.version,
+            components,
+            summary,
+        };
+    }
+    /**
+     * Check if service is ready to accept traffic
+     */
+    async checkReadiness() {
+        const checks = [];
+        for (const [name, check] of this.readinessChecks) {
+            try {
+                const passed = await Promise.race([
+                    check.fn(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error('Readiness check timeout')), check.options.timeout)),
+                ]);
+                checks.push({ name, passed });
+            }
+            catch (error) {
+                checks.push({
+                    name,
+                    passed: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        // Also check critical health checks
+        for (const [name, check] of this.checks) {
+            if (check.options.critical && check.lastResult) {
+                checks.push({
+                    name: `health:${name}`,
+                    passed: check.lastResult.status !== 'unhealthy',
+                    error: check.lastResult.error,
+                });
+            }
+        }
+        const allPassed = checks.every(c => c.passed);
+        return {
+            ready: allPassed,
+            timestamp: Date.now(),
+            checks,
+        };
+    }
+    /**
+     * Check if service is alive (not stuck)
+     */
+    async checkLiveness() {
+        const memUsage = process.memoryUsage();
+        const heapPercent = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+        // Check event loop latency
+        const eventLoopLatency = await this.measureEventLoopLatency();
+        return {
+            alive: true,
+            timestamp: Date.now(),
+            uptime: Math.floor((Date.now() - this.startTime) / 1000),
+            memory: {
+                heapUsed: memUsage.heapUsed,
+                heapTotal: memUsage.heapTotal,
+                rss: memUsage.rss,
+                percent: heapPercent,
+            },
+            eventLoop: {
+                latencyMs: eventLoopLatency,
+                healthy: eventLoopLatency < 100, // 100ms threshold
+            },
+        };
+    }
+    /**
+     * Measure event loop latency
+     */
+    measureEventLoopLatency() {
+        return new Promise(resolve => {
+            const start = Date.now();
+            setImmediate(() => {
+                resolve(Date.now() - start);
+            });
+        });
+    }
+    /**
+     * Get uptime in seconds
+     */
+    getUptime() {
+        return Math.floor((Date.now() - this.startTime) / 1000);
+    }
+}
+exports.HealthChecker = HealthChecker;
+exports.default = HealthChecker;
+// =============================================================================
+// BUILT-IN HEALTH CHECKS
+// =============================================================================
+/**
+ * Create a database health check
+ */
+function createDatabaseHealthCheck(name, queryFn, options = {}) {
+    return async () => {
+        try {
+            const start = Date.now();
+            const ok = await queryFn();
+            const latencyMs = Date.now() - start;
+            return {
+                name,
+                status: ok ? 'healthy' : 'unhealthy',
+                latencyMs,
+                details: { type: 'database' },
+            };
+        }
+        catch (error) {
+            return {
+                name,
+                status: 'unhealthy',
+                error: error instanceof Error ? error.message : String(error),
+                details: { type: 'database' },
+            };
+        }
+    };
+}
+/**
+ * Create an HTTP dependency health check
+ */
+function createHttpHealthCheck(name, url, options = {}) {
+    const { expectedStatus = 200, timeout = 5000 } = options;
+    return async () => {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            const start = Date.now();
+            const response = await fetch(url, { signal: controller.signal });
+            clearTimeout(timeoutId);
+            const latencyMs = Date.now() - start;
+            const status = response.status === expectedStatus ? 'healthy' : 'degraded';
+            return {
+                name,
+                status,
+                latencyMs,
+                details: {
+                    type: 'http',
+                    url,
+                    responseStatus: response.status,
+                    expectedStatus,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                name,
+                status: 'unhealthy',
+                error: error instanceof Error ? error.message : String(error),
+                details: { type: 'http', url },
+            };
+        }
+    };
+}
+/**
+ * Create a WebSocket connection health check
+ */
+function createWebSocketHealthCheck(name, isConnectedFn, getStatsFn) {
+    return async () => {
+        const connected = isConnectedFn();
+        const stats = getStatsFn?.();
+        let status = connected ? 'healthy' : 'unhealthy';
+        // Check if connection is stale (no messages in last 60 seconds)
+        if (connected && stats) {
+            const staleSince = Date.now() - stats.lastMessageAt;
+            if (staleSince > 60000) {
+                status = 'degraded';
+            }
+        }
+        return {
+            name,
+            status,
+            details: {
+                type: 'websocket',
+                connected,
+                ...(stats && {
+                    messagesPerSecond: stats.messagesPerSecond,
+                    lastMessageAt: stats.lastMessageAt,
+                    staleSinceMs: Date.now() - stats.lastMessageAt,
+                }),
+            },
+        };
+    };
+}
+/**
+ * Create a feed health check
+ */
+function createFeedHealthCheck(name, platform, getStatusFn) {
+    return async () => {
+        const status = getStatusFn();
+        let health = 'healthy';
+        if (!status.connected) {
+            health = 'unhealthy';
+        }
+        else if (status.errors > 0 || Date.now() - status.lastMessageAt > 30000) {
+            health = 'degraded';
+        }
+        return {
+            name,
+            status: health,
+            details: {
+                type: 'feed',
+                platform,
+                connected: status.connected,
+                subscriptions: status.subscriptions,
+                messagesPerSecond: status.messagesPerSecond,
+                lastMessageAt: status.lastMessageAt,
+                recentErrors: status.errors,
+            },
+        };
+    };
+}
+/**
+ * Create a memory health check
+ */
+function createMemoryHealthCheck(warnThresholdPct = 80, criticalThresholdPct = 95) {
+    return async () => {
+        const memUsage = process.memoryUsage();
+        const heapPercent = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+        let status = 'healthy';
+        if (heapPercent >= criticalThresholdPct) {
+            status = 'unhealthy';
+        }
+        else if (heapPercent >= warnThresholdPct) {
+            status = 'degraded';
+        }
+        return {
+            name: 'memory',
+            status,
+            details: {
+                type: 'memory',
+                heapUsedMB: Math.round(memUsage.heapUsed / 1024 / 1024),
+                heapTotalMB: Math.round(memUsage.heapTotal / 1024 / 1024),
+                rssMB: Math.round(memUsage.rss / 1024 / 1024),
+                heapPercent: Math.round(heapPercent * 100) / 100,
+                warnThresholdPct,
+                criticalThresholdPct,
+            },
+        };
+    };
+}
+/**
+ * Create an external API health check with circuit breaker pattern
+ */
+function createApiHealthCheck(name, checkFn, options = {}) {
+    const { timeout = 5000, failureThreshold = 3, recoveryTime = 30000 } = options;
+    let consecutiveFailures = 0;
+    let circuitOpenedAt = null;
+    return async () => {
+        // Check if circuit is open
+        if (circuitOpenedAt) {
+            if (Date.now() - circuitOpenedAt < recoveryTime) {
+                return {
+                    name,
+                    status: 'unhealthy',
+                    error: 'Circuit breaker open',
+                    details: {
+                        type: 'api',
+                        circuitOpen: true,
+                        recoversIn: Math.ceil((recoveryTime - (Date.now() - circuitOpenedAt)) / 1000),
+                    },
+                };
+            }
+            // Try to recover
+            circuitOpenedAt = null;
+        }
+        try {
+            const start = Date.now();
+            const ok = await Promise.race([
+                checkFn(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('API check timeout')), timeout)),
+            ]);
+            const latencyMs = Date.now() - start;
+            if (ok) {
+                consecutiveFailures = 0;
+                return {
+                    name,
+                    status: 'healthy',
+                    latencyMs,
+                    details: { type: 'api', consecutiveFailures: 0 },
+                };
+            }
+            consecutiveFailures++;
+            if (consecutiveFailures >= failureThreshold) {
+                circuitOpenedAt = Date.now();
+            }
+            return {
+                name,
+                status: 'degraded',
+                latencyMs,
+                details: { type: 'api', consecutiveFailures },
+            };
+        }
+        catch (error) {
+            consecutiveFailures++;
+            if (consecutiveFailures >= failureThreshold) {
+                circuitOpenedAt = Date.now();
+            }
+            return {
+                name,
+                status: consecutiveFailures >= failureThreshold ? 'unhealthy' : 'degraded',
+                error: error instanceof Error ? error.message : String(error),
+                details: { type: 'api', consecutiveFailures, circuitOpen: !!circuitOpenedAt },
+            };
+        }
+    };
+}
+// =============================================================================
+// DEFAULT INSTANCE
+// =============================================================================
+exports.healthChecker = new HealthChecker();
+// Register built-in memory check
+exports.healthChecker.registerCheck('memory', createMemoryHealthCheck(), { cacheMs: 5000, critical: false });
+//# sourceMappingURL=health.js.map

package/dist/monitoring/health.js.map

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

package/dist/monitoring/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Monitoring & Alerting - health checks + error notifications.
+ *
+ * This module provides:
+ * - Prometheus-compatible metrics (metrics.ts)
+ * - Health check endpoints (health.ts)
+ * - Alert thresholds and webhooks (alerts.ts)
+ * - Legacy monitoring service (below)
+ */
+import type { OutgoingMessage, Config, MonitoringTarget } from '../types';
+import type { ProviderHealthMonitor } from '../providers';
+export * from './metrics';
+export * from './health';
+export * from './alerts';
+export interface MonitoringService {
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+}
+export declare function createMonitoringService(options: {
+    config?: Config['monitoring'];
+    providerHealth?: ProviderHealthMonitor | null;
+    sendMessage: (message: OutgoingMessage) => Promise<string | null>;
+    resolveAccountId?: (target: MonitoringTarget) => Promise<string | undefined> | string | undefined;
+}): MonitoringService;