vesper-memory 0.3.0

package/dist/monitoring/health.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Health Monitoring Module
+ *
+ * Provides health checks for system components including:
+ * - Certificate expiration monitoring
+ * - Service health checks
+ * - Resource utilization monitoring
+ *
+ * @module src/monitoring/health
+ */
+/**
+ * Certificate status levels
+ */
+export type CertificateStatusLevel = 'valid' | 'warning' | 'critical' | 'expired' | 'error';
+/**
+ * Certificate expiration check result
+ */
+export interface CertificateStatus {
+    status: CertificateStatusLevel;
+    daysUntilExpiration: number;
+    expirationDate: Date | null;
+    shouldAlert: boolean;
+    error?: string;
+}
+/**
+ * Health check result interface
+ */
+export interface HealthCheckResult {
+    name: string;
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    message?: string;
+    details?: Record<string, unknown>;
+    timestamp: Date;
+}
+/**
+ * Options for certificate expiration check
+ */
+export interface CertificateCheckOptions {
+    /** Path to the certificate file */
+    certPath: string;
+    /** Warning threshold in days (default: 14) */
+    warningThresholdDays?: number;
+    /** Critical threshold in days (default: 7) */
+    criticalThresholdDays?: number;
+    /** Mock expiration date for testing */
+    mockExpirationDate?: Date;
+}
+/**
+ * Options for remote certificate check
+ */
+export interface RemoteCertificateCheckOptions {
+    /** Hostname to check */
+    host: string;
+    /** Port (default: 443) */
+    port?: number;
+    /** Warning threshold in days (default: 14) */
+    warningThresholdDays?: number;
+    /** Critical threshold in days (default: 7) */
+    criticalThresholdDays?: number;
+    /** Timeout in milliseconds (default: 5000) */
+    timeoutMs?: number;
+}
+/**
+ * Check certificate expiration from file
+ *
+ * @param options - Check options including cert path and thresholds
+ * @returns Certificate status with expiration information
+ */
+export declare function checkCertificateExpiration(options: CertificateCheckOptions): Promise<CertificateStatus>;
+/**
+ * Check certificate expiration from remote host
+ *
+ * @param options - Check options including host and thresholds
+ * @returns Certificate status with expiration information
+ */
+export declare function checkRemoteCertificateExpiration(options: RemoteCertificateCheckOptions): Promise<CertificateStatus>;
+/**
+ * Comprehensive health check for all services
+ */
+export declare function runHealthChecks(): Promise<HealthCheckResult[]>;
+/**
+ * Alert configuration for certificate monitoring
+ */
+export interface AlertConfig {
+    /** Slack webhook URL for alerts */
+    slackWebhook?: string;
+    /** Email recipients for alerts */
+    emailRecipients?: string[];
+    /** PagerDuty service key for critical alerts */
+    pagerDutyKey?: string;
+}
+/**
+ * Send alert for certificate expiration
+ */
+export declare function sendCertificateAlert(status: CertificateStatus, config: AlertConfig): Promise<void>;
+/**
+ * Start periodic certificate monitoring
+ */
+export declare function startCertificateMonitoring(options: CertificateCheckOptions & {
+    intervalMs?: number;
+    alertConfig?: AlertConfig;
+}): NodeJS.Timeout;
+/**
+ * Component health status
+ */
+export type ComponentStatus = "healthy" | "unhealthy" | "degraded";
+/**
+ * Certificate status for health endpoint
+ */
+export type CertStatus = "healthy" | "warning" | "critical";
+/**
+ * Overall system health status
+ */
+export type SystemStatus = "healthy" | "degraded" | "unhealthy";
+/**
+ * Health check result for a single component
+ */
+export interface ComponentHealth {
+    status: ComponentStatus;
+    latency_ms: number;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Certificate health information for health endpoint
+ */
+export interface CertificateHealthInfo {
+    expiry_days: number;
+    status: CertStatus;
+}
+/**
+ * Complete health check result (new format for monitoring endpoint)
+ */
+export interface FullHealthCheckResult {
+    status: SystemStatus;
+    timestamp: string;
+    components: Record<string, ComponentHealth>;
+    certificates: CertificateHealthInfo;
+}
+/**
+ * Configuration for individual service connections
+ */
+export interface RedisConfig {
+    host: string;
+    port: number;
+    password?: string;
+}
+export interface PostgresConfig {
+    host: string;
+    port: number;
+    database?: string;
+    user?: string;
+    password?: string;
+}
+export interface SqliteConfig {
+    path: string;
+}
+export interface QdrantConfig {
+    url: string;
+    apiKey?: string;
+}
+export interface EmbeddingConfig {
+    url: string;
+}
+/**
+ * Health checker configuration
+ */
+export interface HealthCheckerConfig {
+    redis?: RedisConfig;
+    postgres?: PostgresConfig;
+    sqlite?: SqliteConfig;
+    qdrant?: QdrantConfig;
+    embedding?: EmbeddingConfig;
+}
+/**
+ * Health checker options
+ */
+export interface HealthCheckerOptions {
+    /** Timeout for health checks in milliseconds (default: 5000) */
+    timeout?: number;
+}
+/**
+ * HealthChecker class for comprehensive system health monitoring
+ */
+export declare class HealthChecker {
+    private config;
+    private options;
+    private certExpiryDays;
+    private redisClient?;
+    private sqliteDb?;
+    constructor(config: HealthCheckerConfig, options?: HealthCheckerOptions);
+    /**
+     * Set certificate expiry days (for testing or manual updates)
+     */
+    setCertExpiryDays(days: number): void;
+    /**
+     * Perform comprehensive health check
+     */
+    check(): Promise<FullHealthCheckResult>;
+    /**
+     * Check Redis connectivity
+     */
+    checkRedis(): Promise<ComponentHealth>;
+    /**
+     * Check PostgreSQL connectivity
+     */
+    checkPostgres(): Promise<ComponentHealth>;
+    /**
+     * Check SQLite connectivity
+     */
+    checkSqlite(): Promise<ComponentHealth>;
+    /**
+     * Check Qdrant connectivity
+     */
+    checkQdrant(): Promise<ComponentHealth>;
+    /**
+     * Check Embedding service connectivity
+     */
+    checkEmbedding(): Promise<ComponentHealth>;
+    /**
+     * Get certificate health status for health endpoint
+     */
+    private getCertificateHealthInfo;
+    /**
+     * Determine overall system status based on component health
+     */
+    private determineOverallStatus;
+    /**
+     * Close any open connections
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a new HealthChecker instance
+ */
+export declare function createHealthChecker(config: HealthCheckerConfig, options?: HealthCheckerOptions): HealthChecker;
+/**
+ * Create health checker from environment variables
+ */
+export declare function createHealthCheckerFromEnv(options?: HealthCheckerOptions): HealthChecker;
+//# sourceMappingURL=health.d.ts.map

package/dist/monitoring/health.d.ts.map

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