couchloop-eq-mcp 1.0.0

package/dist/utils/errorHandler.js

@@ -0,0 +1,348 @@
+import { logger } from './logger.js';
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["NETWORK"] = "NETWORK_ERROR";
+    ErrorType["TIMEOUT"] = "TIMEOUT_ERROR";
+    ErrorType["VALIDATION"] = "VALIDATION_ERROR";
+    ErrorType["AUTHENTICATION"] = "AUTHENTICATION_ERROR";
+    ErrorType["RATE_LIMIT"] = "RATE_LIMIT_ERROR";
+    ErrorType["SERVER"] = "SERVER_ERROR";
+    ErrorType["CRISIS"] = "CRISIS_HANDLING_ERROR";
+    ErrorType["DATABASE"] = "DATABASE_ERROR";
+    ErrorType["UNKNOWN"] = "UNKNOWN_ERROR";
+})(ErrorType || (ErrorType = {}));
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["LOW"] = "low";
+    ErrorSeverity["MEDIUM"] = "medium";
+    ErrorSeverity["HIGH"] = "high";
+    ErrorSeverity["CRITICAL"] = "critical";
+})(ErrorSeverity || (ErrorSeverity = {}));
+export class ApplicationError extends Error {
+    context;
+    constructor(context) {
+        super(context.message);
+        this.name = 'ApplicationError';
+        this.context = {
+            type: context.type || ErrorType.UNKNOWN,
+            severity: context.severity || ErrorSeverity.MEDIUM,
+            message: context.message,
+            originalError: context.originalError,
+            metadata: context.metadata || {},
+            timestamp: context.timestamp || new Date(),
+            recoverable: context.recoverable ?? true,
+            userMessage: context.userMessage,
+        };
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Error handler with recovery strategies
+ */
+export class ErrorHandler {
+    errorCount = new Map();
+    lastError = new Map();
+    /**
+     * Classify error based on message and characteristics
+     */
+    classifyError(error) {
+        const message = error.message.toLowerCase();
+        // Network errors
+        if (message.includes('network') ||
+            message.includes('econnrefused') ||
+            message.includes('econnreset') ||
+            message.includes('fetch failed')) {
+            return ErrorType.NETWORK;
+        }
+        // Timeout errors
+        if (message.includes('timeout') ||
+            message.includes('timed out')) {
+            return ErrorType.TIMEOUT;
+        }
+        // Authentication errors
+        if (message.includes('401') ||
+            message.includes('unauthorized') ||
+            message.includes('authentication')) {
+            return ErrorType.AUTHENTICATION;
+        }
+        // Rate limiting
+        if (message.includes('429') ||
+            message.includes('rate limit') ||
+            message.includes('too many requests')) {
+            return ErrorType.RATE_LIMIT;
+        }
+        // Validation errors
+        if (message.includes('validation') ||
+            message.includes('invalid') ||
+            message.includes('expected')) {
+            return ErrorType.VALIDATION;
+        }
+        // Server errors
+        if (message.includes('500') ||
+            message.includes('502') ||
+            message.includes('503') ||
+            message.includes('server error')) {
+            return ErrorType.SERVER;
+        }
+        // Database errors
+        if (message.includes('database') ||
+            message.includes('connection pool') ||
+            message.includes('query failed')) {
+            return ErrorType.DATABASE;
+        }
+        // Crisis handling errors
+        if (message.includes('crisis') ||
+            message.includes('emergency')) {
+            return ErrorType.CRISIS;
+        }
+        return ErrorType.UNKNOWN;
+    }
+    /**
+     * Determine error severity
+     */
+    determineSeverity(type, _error) {
+        // Critical errors that need immediate attention
+        if (type === ErrorType.CRISIS) {
+            return ErrorSeverity.CRITICAL;
+        }
+        // High severity for authentication and database issues
+        if (type === ErrorType.AUTHENTICATION ||
+            type === ErrorType.DATABASE) {
+            return ErrorSeverity.HIGH;
+        }
+        // Medium for server and timeout errors
+        if (type === ErrorType.SERVER ||
+            type === ErrorType.TIMEOUT) {
+            return ErrorSeverity.MEDIUM;
+        }
+        // Low for network and rate limit (usually transient)
+        if (type === ErrorType.NETWORK ||
+            type === ErrorType.RATE_LIMIT) {
+            return ErrorSeverity.LOW;
+        }
+        return ErrorSeverity.MEDIUM;
+    }
+    /**
+     * Handle error with appropriate recovery strategy
+     */
+    async handle(error, context) {
+        const type = this.classifyError(error);
+        const severity = this.determineSeverity(type, error);
+        // Track error frequency
+        this.trackError(type);
+        // Create error context
+        const errorContext = {
+            type,
+            severity,
+            message: error.message,
+            originalError: error,
+            metadata: context,
+            timestamp: new Date(),
+            recoverable: this.isRecoverable(type),
+            userMessage: this.getUserMessage(type, error),
+        };
+        // Log based on severity
+        this.logError(errorContext);
+        // Apply recovery strategy
+        await this.applyRecoveryStrategy(errorContext);
+        return errorContext;
+    }
+    /**
+     * Track error frequency for monitoring
+     */
+    trackError(type) {
+        const count = this.errorCount.get(type) || 0;
+        this.errorCount.set(type, count + 1);
+        this.lastError.set(type, new Date());
+        // Alert if error frequency is too high
+        if (count > 10) {
+            logger.error(`High frequency of ${type} errors: ${count} occurrences`);
+        }
+    }
+    /**
+     * Determine if error is recoverable
+     */
+    isRecoverable(type) {
+        switch (type) {
+            case ErrorType.NETWORK:
+            case ErrorType.TIMEOUT:
+            case ErrorType.RATE_LIMIT:
+            case ErrorType.SERVER:
+                return true;
+            case ErrorType.AUTHENTICATION:
+            case ErrorType.VALIDATION:
+                return false;
+            case ErrorType.CRISIS:
+                return true; // Always try to recover from crisis handling errors
+            default:
+                return true;
+        }
+    }
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage(type, _error) {
+        switch (type) {
+            case ErrorType.NETWORK:
+                return 'Connection issue. Please check your internet and try again.';
+            case ErrorType.TIMEOUT:
+                return 'The request is taking longer than expected. Please try again.';
+            case ErrorType.AUTHENTICATION:
+                return 'Authentication failed. Please check your credentials.';
+            case ErrorType.RATE_LIMIT:
+                return 'Too many requests. Please wait a moment and try again.';
+            case ErrorType.VALIDATION:
+                return 'Invalid input provided. Please check your data and try again.';
+            case ErrorType.SERVER:
+                return 'Server error occurred. Our team has been notified.';
+            case ErrorType.DATABASE:
+                return 'Database issue encountered. Please try again later.';
+            case ErrorType.CRISIS:
+                return 'We\'re having trouble processing your message. If this is an emergency, please call 988 (Suicide & Crisis Lifeline).';
+            default:
+                return 'An unexpected error occurred. Please try again.';
+        }
+    }
+    /**
+     * Log error based on severity
+     */
+    logError(context) {
+        const logData = {
+            type: context.type,
+            severity: context.severity,
+            message: context.message,
+            metadata: context.metadata,
+            timestamp: context.timestamp,
+        };
+        switch (context.severity) {
+            case ErrorSeverity.CRITICAL:
+                logger.error('[CRITICAL]', logData);
+                // Could trigger alerts here
+                break;
+            case ErrorSeverity.HIGH:
+                logger.error('[HIGH]', logData);
+                break;
+            case ErrorSeverity.MEDIUM:
+                logger.warn('[MEDIUM]', logData);
+                break;
+            case ErrorSeverity.LOW:
+                logger.debug('[LOW]', logData);
+                break;
+        }
+    }
+    /**
+     * Apply recovery strategy based on error type
+     */
+    async applyRecoveryStrategy(context) {
+        switch (context.type) {
+            case ErrorType.NETWORK:
+                // Network errors: wait and retry
+                await this.delay(2000);
+                break;
+            case ErrorType.TIMEOUT:
+                // Timeout: increase timeout for next attempt
+                context.metadata = {
+                    ...context.metadata,
+                    suggestedTimeout: 60000,
+                };
+                break;
+            case ErrorType.RATE_LIMIT:
+                // Rate limit: exponential backoff
+                const waitTime = this.calculateBackoff(context.type);
+                await this.delay(waitTime);
+                break;
+            case ErrorType.SERVER:
+                // Server error: circuit breaker pattern
+                context.metadata = {
+                    ...context.metadata,
+                    useCircuitBreaker: true,
+                };
+                break;
+            case ErrorType.CRISIS:
+                // Crisis error: fallback to emergency response
+                context.metadata = {
+                    ...context.metadata,
+                    fallbackToEmergencyResponse: true,
+                    emergencyResources: this.getEmergencyResources(),
+                };
+                break;
+            case ErrorType.DATABASE:
+                // Database error: use cache or fallback
+                context.metadata = {
+                    ...context.metadata,
+                    useCache: true,
+                    fallbackToLocal: true,
+                };
+                break;
+            default:
+                // Unknown errors: log and continue
+                logger.warn('No specific recovery strategy for error type:', context.type);
+        }
+    }
+    /**
+     * Calculate backoff time based on error frequency
+     */
+    calculateBackoff(type) {
+        const count = this.errorCount.get(type) || 1;
+        return Math.min(1000 * Math.pow(2, count - 1), 30000); // Max 30 seconds
+    }
+    /**
+     * Simple delay helper
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Get emergency resources for crisis situations
+     */
+    getEmergencyResources() {
+        return [
+            {
+                name: '988 Suicide & Crisis Lifeline',
+                phone: '988',
+                text: 'Text "HELLO" to 741741',
+                available: '24/7',
+            },
+            {
+                name: 'Emergency Services',
+                phone: '911',
+                available: '24/7',
+            },
+        ];
+    }
+    /**
+     * Get error statistics
+     */
+    getStats() {
+        const stats = {};
+        for (const [type, count] of this.errorCount.entries()) {
+            const lastOccurrence = this.lastError.get(type);
+            stats[type] = {
+                count,
+                lastOccurrence: lastOccurrence?.toISOString(),
+            };
+        }
+        return stats;
+    }
+    /**
+     * Reset error tracking
+     */
+    reset() {
+        this.errorCount.clear();
+        this.lastError.clear();
+    }
+}
+// Export singleton instance
+export const errorHandler = new ErrorHandler();
+// Convenience function
+export async function handleError(error, context) {
+    return errorHandler.handle(error, context);
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/utils/errorHandler.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+export declare class CouchLoopError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: any | undefined;
+    constructor(message: string, code: string, statusCode?: number, details?: any | undefined);
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        statusCode: number;
+        details: any;
+    };
+}
+export declare class ValidationError extends CouchLoopError {
+    constructor(message: string, details?: any);
+}
+export declare class AuthenticationError extends CouchLoopError {
+    constructor(message?: string);
+}
+export declare class AuthorizationError extends CouchLoopError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends CouchLoopError {
+    constructor(resource: string, identifier?: string);
+}
+export declare class ConflictError extends CouchLoopError {
+    constructor(message: string, details?: any);
+}
+export declare class DatabaseError extends CouchLoopError {
+    constructor(message: string, originalError?: any);
+}
+export declare function handleError(error: any): {
+    error: string;
+    details?: any;
+};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,UAAU,EAAE,MAAM;aAClB,OAAO,CAAC,EAAE,GAAG;gBAH7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,CAAC,EAAE,GAAG,YAAA;IAO/B,MAAM;;;;;;;CASP;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAAkC;CAIxD;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,GAAE,MAAmC;CAIzD;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAOlD;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG;CAIjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,CAexE"}

package/dist/utils/errors.js

@@ -0,0 +1,77 @@
+import { logger } from './logger.js';
+export class CouchLoopError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(message, code, statusCode = 500, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'CouchLoopError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            details: this.details,
+        };
+    }
+}
+export class ValidationError extends CouchLoopError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', 400, details);
+        this.name = 'ValidationError';
+    }
+}
+export class AuthenticationError extends CouchLoopError {
+    constructor(message = 'Authentication required') {
+        super(message, 'AUTHENTICATION_ERROR', 401);
+        this.name = 'AuthenticationError';
+    }
+}
+export class AuthorizationError extends CouchLoopError {
+    constructor(message = 'Insufficient permissions') {
+        super(message, 'AUTHORIZATION_ERROR', 403);
+        this.name = 'AuthorizationError';
+    }
+}
+export class NotFoundError extends CouchLoopError {
+    constructor(resource, identifier) {
+        const message = identifier
+            ? `${resource} with id ${identifier} not found`
+            : `${resource} not found`;
+        super(message, 'NOT_FOUND', 404);
+        this.name = 'NotFoundError';
+    }
+}
+export class ConflictError extends CouchLoopError {
+    constructor(message, details) {
+        super(message, 'CONFLICT', 409, details);
+        this.name = 'ConflictError';
+    }
+}
+export class DatabaseError extends CouchLoopError {
+    constructor(message, originalError) {
+        super(message, 'DATABASE_ERROR', 500, { originalError });
+        this.name = 'DatabaseError';
+    }
+}
+export function handleError(error) {
+    if (error instanceof CouchLoopError) {
+        return {
+            error: error.message,
+            details: error.details,
+        };
+    }
+    // Log unexpected errors
+    logger.error('Unexpected error:', error);
+    return {
+        error: 'An unexpected error occurred',
+        details: process.env.NODE_ENV === 'development' ? error.message : undefined,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+declare class Logger {
+    private level;
+    private isMCP;
+    constructor();
+    private log;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AASA,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAU;;IASvB,OAAO,CAAC,GAAG;IAoBX,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAGrB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,49 @@
+const LOG_LEVELS = {
+    ERROR: 0,
+    WARN: 1,
+    INFO: 2,
+    DEBUG: 3,
+};
+class Logger {
+    level;
+    isMCP;
+    constructor() {
+        const envLevel = (process.env.LOG_LEVEL?.toUpperCase() || 'INFO');
+        this.level = LOG_LEVELS[envLevel] ?? LOG_LEVELS.INFO;
+        // Disable console logging when running as MCP server
+        this.isMCP = process.env.MCP_MODE === 'true' || process.argv.includes('--mcp');
+    }
+    log(level, ...args) {
+        // Skip all console output when running as MCP server
+        if (this.isMCP) {
+            return;
+        }
+        if (LOG_LEVELS[level] <= this.level) {
+            const timestamp = new Date().toISOString();
+            const prefix = `[${timestamp}] [${level}]`;
+            if (level === 'ERROR') {
+                console.error(prefix, ...args);
+            }
+            else if (level === 'WARN') {
+                console.warn(prefix, ...args);
+            }
+            else {
+                console.log(prefix, ...args);
+            }
+        }
+    }
+    error(...args) {
+        this.log('ERROR', ...args);
+    }
+    warn(...args) {
+        this.log('WARN', ...args);
+    }
+    info(...args) {
+        this.log('INFO', ...args);
+    }
+    debug(...args) {
+        this.log('DEBUG', ...args);
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG;IACjB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACA,CAAC;AAIX,MAAM,MAAM;IACF,KAAK,CAAS;IACd,KAAK,CAAU;IAEvB;QACE,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,MAAM,CAAa,CAAC;QAC9E,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;QACrD,qDAAqD;QACrD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,GAAG,IAAW;QACzC,qDAAqD;QACrD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,GAAG,CAAC;YAE3C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/performanceMonitor.d.ts

@@ -0,0 +1,106 @@
+import { EventEmitter } from 'events';
+export interface PerformanceMetric {
+    operation: string;
+    duration: number;
+    success: boolean;
+    timestamp: Date;
+    metadata?: Record<string, any>;
+}
+export interface PerformanceStats {
+    count: number;
+    successCount: number;
+    errorCount: number;
+    totalTime: number;
+    avgTime: number;
+    minTime: number;
+    maxTime: number;
+    p50: number;
+    p95: number;
+    p99: number;
+    errorRate: number;
+    throughput: number;
+}
+export interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    checks: {
+        responseTime: boolean;
+        errorRate: boolean;
+        throughput: boolean;
+    };
+    metrics: {
+        avgResponseTime: number;
+        errorRate: number;
+        requestsPerMinute: number;
+    };
+}
+/**
+ * Performance monitoring with real-time metrics and alerting
+ */
+export declare class PerformanceMonitor extends EventEmitter {
+    private metrics;
+    private readonly maxMetricsPerOperation;
+    private readonly metricsWindow;
+    private startTime;
+    private readonly thresholds;
+    constructor();
+    /**
+     * Measure operation performance
+     */
+    measure<T>(operation: string, fn: () => Promise<T>, metadata?: Record<string, any>): Promise<T>;
+    /**
+     * Measure sync operation performance
+     */
+    measureSync<T>(operation: string, fn: () => T, metadata?: Record<string, any>): T;
+    /**
+     * Record a metric
+     */
+    record(operation: string, duration: number, success?: boolean, metadata?: Record<string, any>): void;
+    /**
+     * Get statistics for an operation
+     */
+    getStats(operation: string): PerformanceStats | null;
+    /**
+     * Get all statistics
+     */
+    getAllStats(): Record<string, PerformanceStats>;
+    /**
+     * Get health status
+     */
+    getHealthStatus(): HealthStatus;
+    /**
+     * Get recent metrics for an operation
+     */
+    private getRecentMetrics;
+    /**
+     * Calculate percentile
+     */
+    private percentile;
+    /**
+     * Check for performance issues
+     */
+    private checkPerformance;
+    /**
+     * Start periodic cleanup of old metrics
+     */
+    private startPeriodicCleanup;
+    /**
+     * Start periodic logging of metrics
+     */
+    private startPeriodicLogging;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get uptime
+     */
+    getUptime(): number;
+    /**
+     * Export metrics for external monitoring
+     */
+    export(): any;
+}
+export declare const performanceMonitor: PerformanceMonitor;
+export declare function measure<T>(operation: string, fn: () => Promise<T>, metadata?: Record<string, any>): Promise<T>;
+export declare function recordMetric(operation: string, duration: number, success?: boolean, metadata?: Record<string, any>): void;
+//# sourceMappingURL=performanceMonitor.d.ts.map

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

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