couchloop-eq-mcp 1.0.0

package/dist/utils/circuitBreaker.js

@@ -0,0 +1,234 @@
+import { logger } from './logger.js';
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half-open";
+})(CircuitState || (CircuitState = {}));
+export class CircuitBreaker {
+    failures = 0;
+    lastFailTime;
+    state = CircuitState.CLOSED;
+    successCount = 0;
+    halfOpenAttempts = 0;
+    // Statistics tracking
+    totalCalls = 0;
+    successfulCalls = 0;
+    failedCalls = 0;
+    rejectedCalls = 0;
+    consecutiveFailures = 0;
+    consecutiveSuccesses = 0;
+    // Configuration
+    failureThreshold;
+    resetTimeout;
+    halfOpenMaxAttempts;
+    callbacks;
+    constructor(options = {}) {
+        this.failureThreshold = options.failureThreshold || 5;
+        this.resetTimeout = options.resetTimeout || 30000;
+        this.halfOpenMaxAttempts = options.halfOpenMaxAttempts || 3;
+        this.callbacks = {
+            onOpen: options.onOpen,
+            onClose: options.onClose
+        };
+        logger.info(`Circuit breaker initialized: threshold=${this.failureThreshold}, resetTimeout=${this.resetTimeout}ms`);
+    }
+    async execute(_operation, fn) {
+        this.totalCalls++;
+        // Check state and transition if needed
+        this.checkStateTransition();
+        // Reject if circuit is open
+        if (this.state === CircuitState.OPEN) {
+            this.rejectedCalls++;
+            const timeSinceLastFailure = Date.now() - (this.lastFailTime?.getTime() || 0);
+            const remainingTime = Math.ceil((this.resetTimeout - timeSinceLastFailure) / 1000);
+            throw new Error(`Circuit breaker is open. Retry in ${remainingTime} seconds`);
+        }
+        // Check half-open attempts limit
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Increment for this attempt first
+            this.halfOpenAttempts++;
+            // Check if we've exceeded the max attempts
+            if (this.halfOpenAttempts > this.halfOpenMaxAttempts) {
+                this.rejectedCalls++;
+                throw new Error('Half-open state: max attempts reached');
+            }
+        }
+        try {
+            const result = await fn();
+            // Handle successful execution
+            this.successfulCalls++;
+            this.consecutiveSuccesses++;
+            this.consecutiveFailures = 0;
+            if (this.state === CircuitState.HALF_OPEN) {
+                this.successCount++;
+                logger.debug(`Circuit breaker half-open: success ${this.successCount}`);
+                // Only close if we've had a successful attempt
+                // The getState() method will handle the actual state transition
+                // by checking conditions, allowing tests to verify state properly
+                if (this.successCount >= 1) {
+                    this.state = CircuitState.CLOSED;
+                    this.failures = 0;
+                    this.successCount = 0;
+                    this.halfOpenAttempts = 0;
+                    logger.info('Circuit breaker closed after successful half-open test');
+                    this.callbacks?.onClose?.();
+                }
+            }
+            else if (this.state === CircuitState.CLOSED && this.failures > 0) {
+                // Reset failure count on success when closed
+                this.failures = 0;
+            }
+            return result;
+        }
+        catch (error) {
+            this.handleFailure(error);
+            throw error;
+        }
+    }
+    handleFailure(error) {
+        this.failures++;
+        this.failedCalls++;
+        this.consecutiveFailures++;
+        this.consecutiveSuccesses = 0;
+        this.lastFailTime = new Date();
+        logger.warn(`Circuit breaker failure ${this.failures}/${this.failureThreshold}: ${error}`);
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Immediately open on failure in half-open state
+            this.open();
+        }
+        else if (this.failures >= this.failureThreshold) {
+            this.open();
+        }
+    }
+    open() {
+        if (this.state !== CircuitState.OPEN) {
+            this.state = CircuitState.OPEN;
+            logger.error(`Circuit breaker opened after ${this.failures} failures`);
+            this.callbacks?.onOpen?.();
+        }
+    }
+    close() {
+        this.state = CircuitState.CLOSED;
+        this.failures = 0;
+        this.successCount = 0;
+        this.halfOpenAttempts = 0;
+        logger.info('Circuit breaker closed');
+        this.callbacks?.onClose?.();
+    }
+    /**
+     * Check and perform state transitions
+     */
+    checkStateTransition() {
+        if (this.state === CircuitState.OPEN) {
+            const timeSinceLastFailure = Date.now() - (this.lastFailTime?.getTime() || 0);
+            if (timeSinceLastFailure > this.resetTimeout) {
+                logger.info('Circuit breaker transitioning to half-open state');
+                this.state = CircuitState.HALF_OPEN;
+                this.successCount = 0;
+                this.halfOpenAttempts = 0;
+            }
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        // Check for state transition before returning
+        this.checkStateTransition();
+        return this.state;
+    }
+    /**
+     * Get statistics
+     */
+    getStatistics() {
+        const successRate = this.totalCalls > 0
+            ? (this.successfulCalls / this.totalCalls) * 100
+            : 0;
+        return {
+            state: this.state,
+            totalCalls: this.totalCalls,
+            successfulCalls: this.successfulCalls,
+            failedCalls: this.failedCalls,
+            rejectedCalls: this.rejectedCalls,
+            successRate: Math.round(successRate * 100) / 100, // Round to 2 decimal places
+            lastFailTime: this.lastFailTime,
+            consecutiveFailures: this.consecutiveFailures,
+            consecutiveSuccesses: this.consecutiveSuccesses,
+        };
+    }
+    /**
+     * Force circuit to open state
+     */
+    forceOpen() {
+        this.state = CircuitState.OPEN;
+        this.lastFailTime = new Date();
+        logger.info('Circuit breaker forced open');
+        this.callbacks?.onOpen?.();
+    }
+    /**
+     * Force circuit to closed state
+     */
+    forceClose() {
+        this.close();
+        logger.info('Circuit breaker forced closed');
+    }
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset() {
+        this.state = CircuitState.CLOSED;
+        this.failures = 0;
+        this.successCount = 0;
+        this.halfOpenAttempts = 0;
+        this.totalCalls = 0;
+        this.successfulCalls = 0;
+        this.failedCalls = 0;
+        this.consecutiveFailures = 0;
+        this.consecutiveSuccesses = 0;
+        this.lastFailTime = undefined;
+        logger.info('Circuit breaker manually reset');
+    }
+    /**
+     * Check if the circuit is currently available
+     */
+    isAvailable() {
+        if (this.state === CircuitState.CLOSED || this.state === CircuitState.HALF_OPEN) {
+            return true;
+        }
+        // Check if enough time has passed to try half-open
+        const timeSinceLastFailure = Date.now() - (this.lastFailTime?.getTime() || 0);
+        return timeSinceLastFailure > this.resetTimeout;
+    }
+    /**
+     * Health check
+     */
+    async healthCheck(fn) {
+        // If circuit is open, don't run the health check function
+        if (this.state === CircuitState.OPEN) {
+            return false;
+        }
+        // If a health check function is provided, run it
+        if (fn) {
+            try {
+                return await fn();
+            }
+            catch {
+                return false;
+            }
+        }
+        // Default: healthy if not open
+        return true;
+    }
+    /**
+     * Get current circuit breaker status (legacy)
+     */
+    getStatus() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            lastFailTime: this.lastFailTime,
+        };
+    }
+}
+//# sourceMappingURL=circuitBreaker.js.map

package/dist/utils/circuitBreaker.js.map

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

package/dist/utils/errorHandler.d.ts

@@ -0,0 +1,101 @@
+export declare enum ErrorType {
+    NETWORK = "NETWORK_ERROR",
+    TIMEOUT = "TIMEOUT_ERROR",
+    VALIDATION = "VALIDATION_ERROR",
+    AUTHENTICATION = "AUTHENTICATION_ERROR",
+    RATE_LIMIT = "RATE_LIMIT_ERROR",
+    SERVER = "SERVER_ERROR",
+    CRISIS = "CRISIS_HANDLING_ERROR",
+    DATABASE = "DATABASE_ERROR",
+    UNKNOWN = "UNKNOWN_ERROR"
+}
+export declare enum ErrorSeverity {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    CRITICAL = "critical"
+}
+export interface ErrorContext {
+    type: ErrorType;
+    severity: ErrorSeverity;
+    message: string;
+    originalError?: Error;
+    metadata?: Record<string, any>;
+    timestamp: Date;
+    recoverable: boolean;
+    userMessage?: string;
+}
+export declare class ApplicationError extends Error {
+    readonly context: ErrorContext;
+    constructor(context: Partial<ErrorContext> & {
+        message: string;
+    });
+    toJSON(): {
+        name: string;
+        message: string;
+        context: ErrorContext;
+        stack: string | undefined;
+    };
+}
+/**
+ * Error handler with recovery strategies
+ */
+export declare class ErrorHandler {
+    private errorCount;
+    private lastError;
+    /**
+     * Classify error based on message and characteristics
+     */
+    classifyError(error: Error): ErrorType;
+    /**
+     * Determine error severity
+     */
+    determineSeverity(type: ErrorType, _error: Error): ErrorSeverity;
+    /**
+     * Handle error with appropriate recovery strategy
+     */
+    handle(error: Error, context?: Record<string, any>): Promise<ErrorContext>;
+    /**
+     * Track error frequency for monitoring
+     */
+    private trackError;
+    /**
+     * Determine if error is recoverable
+     */
+    private isRecoverable;
+    /**
+     * Get user-friendly error message
+     */
+    private getUserMessage;
+    /**
+     * Log error based on severity
+     */
+    private logError;
+    /**
+     * Apply recovery strategy based on error type
+     */
+    private applyRecoveryStrategy;
+    /**
+     * Calculate backoff time based on error frequency
+     */
+    private calculateBackoff;
+    /**
+     * Simple delay helper
+     */
+    private delay;
+    /**
+     * Get emergency resources for crisis situations
+     */
+    private getEmergencyResources;
+    /**
+     * Get error statistics
+     */
+    getStats(): Record<string, any>;
+    /**
+     * Reset error tracking
+     */
+    reset(): void;
+}
+export declare const errorHandler: ErrorHandler;
+export declare function handleError(error: Error, context?: Record<string, any>): Promise<ErrorContext>;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utils/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.ts"],"names":[],"mappings":"AAEA,oBAAY,SAAS;IACnB,OAAO,kBAAkB;IACzB,OAAO,kBAAkB;IACzB,UAAU,qBAAqB;IAC/B,cAAc,yBAAyB;IACvC,UAAU,qBAAqB;IAC/B,MAAM,iBAAiB;IACvB,MAAM,0BAA0B;IAChC,QAAQ,mBAAmB;IAC3B,OAAO,kBAAkB;CAC1B;AAED,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAgBhE,MAAM;;;;;;CAQP;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,SAAS,CAA8B;IAE/C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;IA8DtC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,GAAG,aAAa;IA2BhE;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IA4BhF;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA0BhB;;OAEG;YACW,qBAAqB;IAqDnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,QAAQ;IAcR;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAG/C,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,YAAY,CAAC,CAEvB"}