claude-flow-novice 2.15.3 → 2.15.5

package/dist/lib/error-aggregator.js

@@ -0,0 +1,234 @@
+/**
+ * Error Aggregation System
+ *
+ * Provides error aggregation, correlation tracking, and circuit breaker patterns
+ * for multi-database operations.
+ *
+ * Features:
+ * - Aggregates errors from multiple database systems
+ * - Tracks error correlation across operations
+ * - Implements circuit breaker for repeated failures
+ * - Provides error analysis and reporting
+ *
+ * Part of: Critical Error Handling Fixes (Architecture Review)
+ */ import { DatabaseErrorCode } from './database-service/types.js';
+import { createLogger } from './logging.js';
+import { v4 as uuidv4 } from 'uuid';
+import { CircuitBreakerState, CircuitBreakerConfig, CircuitBreakerRegistry } from './circuit-breaker.js';
+// Re-export circuit breaker types for backward compatibility
+export { CircuitBreakerState, CircuitBreakerConfig };
+/**
+ * Error severity levels
+ */ export var ErrorSeverity = /*#__PURE__*/ function(ErrorSeverity) {
+    ErrorSeverity["LOW"] = "low";
+    ErrorSeverity["MEDIUM"] = "medium";
+    ErrorSeverity["HIGH"] = "high";
+    ErrorSeverity["CRITICAL"] = "critical";
+    return ErrorSeverity;
+}({});
+// Circuit breaker types now imported from ./circuit-breaker module
+/**
+ * Error aggregator class
+ */ export class ErrorAggregator {
+    logger;
+    errors = [];
+    correlationId;
+    circuitBreakerConfig;
+    constructor(correlationId, circuitBreakerConfig){
+        this.correlationId = correlationId || uuidv4();
+        this.logger = createLogger('error-aggregator');
+        // Store circuit breaker configuration for registry
+        this.circuitBreakerConfig = {
+            failureThreshold: circuitBreakerConfig?.failureThreshold ?? 5,
+            successThreshold: circuitBreakerConfig?.successThreshold ?? 2,
+            timeout: circuitBreakerConfig?.timeout ?? 60000,
+            windowSize: circuitBreakerConfig?.windowSize ?? 120000
+        };
+    }
+    /**
+   * Add error to aggregation
+   */ addError(system, error, operationContext) {
+        const aggregatedError = {
+            correlationId: uuidv4(),
+            timestamp: new Date(),
+            system,
+            error,
+            severity: this.determineSeverity(error),
+            operationContext,
+            stackTrace: error.originalError?.stack
+        };
+        this.errors.push(aggregatedError);
+        // Update circuit breaker
+        this.recordFailure(system);
+        // Log error with correlation ID
+        this.logger.error('Database operation failed', error.originalError, {
+            correlationId: this.correlationId,
+            errorCorrelationId: aggregatedError.correlationId,
+            system,
+            errorCode: error.code,
+            message: error.message,
+            severity: aggregatedError.severity
+        });
+        return aggregatedError;
+    }
+    /**
+   * Record successful operation (for circuit breaker)
+   */ recordSuccess(system) {
+        // Use circuit breaker registry - success is tracked automatically via execute()
+        // This method is kept for backward compatibility but delegates to registry
+        const breaker = CircuitBreakerRegistry.getOrCreate(system, this.circuitBreakerConfig);
+        // Success tracking is handled internally by CircuitBreaker.execute()
+        // This is just a manual success recording for compatibility
+        this.logger.debug('Manual success recorded', {
+            system,
+            correlationId: this.correlationId
+        });
+    }
+    /**
+   * Record failed operation (for circuit breaker)
+   */ recordFailure(system) {
+        // Failure tracking is handled by the circuit breaker registry
+        // This is called when addError is invoked
+        const breaker = CircuitBreakerRegistry.getOrCreate(system, this.circuitBreakerConfig);
+        this.logger.debug('Failure recorded via error aggregation', {
+            system,
+            state: breaker.getState(),
+            correlationId: this.correlationId
+        });
+    }
+    /**
+   * Check if circuit breaker allows operation
+   */ isCircuitOpen(system) {
+        const breaker = CircuitBreakerRegistry.get(system);
+        return breaker ? !breaker.isHealthy() : false;
+    }
+    /**
+   * Get aggregation result
+   */ getResult(expectedSystems) {
+        const errorsBySystem = {};
+        const errorsBySeverity = {
+            ["low"]: [],
+            ["medium"]: [],
+            ["high"]: [],
+            ["critical"]: []
+        };
+        // Group errors
+        for (const error of this.errors){
+            // By system
+            if (!errorsBySystem[error.system]) {
+                errorsBySystem[error.system] = [];
+            }
+            errorsBySystem[error.system].push(error);
+            // By severity
+            errorsBySeverity[error.severity].push(error);
+        }
+        // Check if all systems failed
+        const failedSystems = Object.keys(errorsBySystem);
+        const allSystemsFailed = expectedSystems.every((system)=>failedSystems.includes(system));
+        // Check for critical errors
+        const hasCriticalErrors = errorsBySeverity["critical"].length > 0;
+        return {
+            totalErrors: this.errors.length,
+            errorsBySystem,
+            errorsBySeverity,
+            allErrors: [
+                ...this.errors
+            ],
+            correlationId: this.correlationId,
+            allSystemsFailed,
+            hasCriticalErrors
+        };
+    }
+    /**
+   * Determine error severity
+   */ determineSeverity(error) {
+        switch(error.code){
+            case DatabaseErrorCode.CONNECTION_FAILED:
+            case DatabaseErrorCode.TRANSACTION_FAILED:
+                return "critical";
+            case DatabaseErrorCode.QUERY_FAILED:
+            case DatabaseErrorCode.TIMEOUT:
+                return "high";
+            case DatabaseErrorCode.VALIDATION_FAILED:
+            case DatabaseErrorCode.CONSTRAINT_VIOLATION:
+                return "medium";
+            case DatabaseErrorCode.NOT_FOUND:
+            case DatabaseErrorCode.DUPLICATE_KEY:
+                return "low";
+            default:
+                return "medium";
+        }
+    }
+    /**
+   * Check if errors should cause operation failure
+   */ shouldFailOperation(expectedSystems) {
+        const result = this.getResult(expectedSystems);
+        // Fail if all systems failed
+        if (result.allSystemsFailed) {
+            return true;
+        }
+        // Fail if any critical errors
+        if (result.hasCriticalErrors) {
+            return true;
+        }
+        return false;
+    }
+    /**
+   * Create error report
+   */ createReport() {
+        const result = this.getResult([]);
+        const lines = [
+            '=== Error Aggregation Report ===',
+            `Correlation ID: ${this.correlationId}`,
+            `Total Errors: ${result.totalErrors}`,
+            `All Systems Failed: ${result.allSystemsFailed}`,
+            `Critical Errors: ${result.hasCriticalErrors}`,
+            '',
+            '--- Errors by System ---'
+        ];
+        for (const [system, errors] of Object.entries(result.errorsBySystem)){
+            lines.push(`${system}: ${errors.length} error(s)`);
+            for (const error of errors){
+                lines.push(`  - [${error.severity}] ${error.error.message}`);
+            }
+        }
+        lines.push('');
+        lines.push('--- Errors by Severity ---');
+        for (const [severity, errors] of Object.entries(result.errorsBySeverity)){
+            if (errors.length > 0) {
+                lines.push(`${severity}: ${errors.length} error(s)`);
+            }
+        }
+        lines.push('');
+        lines.push('--- Circuit Breaker Status ---');
+        const allMetrics = CircuitBreakerRegistry.getAllMetrics();
+        for (const [system, metrics] of Object.entries(allMetrics)){
+            lines.push(`${system}: ${metrics.state} (failures: ${metrics.failures}, successes: ${metrics.successes})`);
+        }
+        return lines.join('\n');
+    }
+    /**
+   * Get correlation ID
+   */ getCorrelationId() {
+        return this.correlationId;
+    }
+    /**
+   * Reset aggregator (for reuse)
+   */ reset() {
+        this.errors = [];
+        this.correlationId = uuidv4();
+    }
+    /**
+   * Get circuit breaker state for system
+   */ getCircuitBreakerState(system) {
+        const breaker = CircuitBreakerRegistry.get(system);
+        return breaker?.getState() || CircuitBreakerState.CLOSED;
+    }
+}
+/**
+ * Create error aggregator
+ */ export function createErrorAggregator(correlationId, circuitBreakerConfig) {
+    return new ErrorAggregator(correlationId, circuitBreakerConfig);
+}
+
+//# sourceMappingURL=error-aggregator.js.map

package/dist/lib/error-aggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/error-aggregator.ts"],"sourcesContent":["/**\r\n * Error Aggregation System\r\n *\r\n * Provides error aggregation, correlation tracking, and circuit breaker patterns\r\n * for multi-database operations.\r\n *\r\n * Features:\r\n * - Aggregates errors from multiple database systems\r\n * - Tracks error correlation across operations\r\n * - Implements circuit breaker for repeated failures\r\n * - Provides error analysis and reporting\r\n *\r\n * Part of: Critical Error Handling Fixes (Architecture Review)\r\n */\r\n\r\nimport { DatabaseError, DatabaseErrorCode } from './database-service/types.js';\r\nimport { createLogger, Logger } from './logging.js';\r\nimport { v4 as uuidv4 } from 'uuid';\r\nimport {\r\n  CircuitBreakerState,\r\n  CircuitBreakerConfig,\r\n  CircuitBreakerRegistry,\r\n} from './circuit-breaker.js';\r\n\r\n// Re-export circuit breaker types for backward compatibility\r\nexport { CircuitBreakerState, CircuitBreakerConfig };\r\n\r\n/**\r\n * Error severity levels\r\n */\r\nexport enum ErrorSeverity {\r\n  LOW = 'low',\r\n  MEDIUM = 'medium',\r\n  HIGH = 'high',\r\n  CRITICAL = 'critical',\r\n}\r\n\r\n/**\r\n * Aggregated error with context\r\n */\r\nexport interface AggregatedError {\r\n  /** Unique correlation ID for tracking */\r\n  correlationId: string;\r\n  /** Timestamp when error occurred */\r\n  timestamp: Date;\r\n  /** Database system that failed */\r\n  system: string;\r\n  /** Original database error */\r\n  error: DatabaseError;\r\n  /** Error severity */\r\n  severity: ErrorSeverity;\r\n  /** Operation context */\r\n  operationContext?: Record<string, any>;\r\n  /** Stack trace */\r\n  stackTrace?: string;\r\n}\r\n\r\n/**\r\n * Error aggregation result\r\n */\r\nexport interface ErrorAggregationResult {\r\n  /** Total number of errors */\r\n  totalErrors: number;\r\n  /** Errors by system */\r\n  errorsBySystem: Record<string, AggregatedError[]>;\r\n  /** Errors by severity */\r\n  errorsBySeverity: Record<ErrorSeverity, AggregatedError[]>;\r\n  /** All aggregated errors */\r\n  allErrors: AggregatedError[];\r\n  /** Correlation ID for this aggregation */\r\n  correlationId: string;\r\n  /** Whether all systems failed */\r\n  allSystemsFailed: boolean;\r\n  /** Whether any critical errors occurred */\r\n  hasCriticalErrors: boolean;\r\n}\r\n\r\n// Circuit breaker types now imported from ./circuit-breaker module\r\n\r\n/**\r\n * Error aggregator class\r\n */\r\nexport class ErrorAggregator {\r\n  private logger: Logger;\r\n  private errors: AggregatedError[] = [];\r\n  private correlationId: string;\r\n  private circuitBreakerConfig: Partial<CircuitBreakerConfig>;\r\n\r\n  constructor(\r\n    correlationId?: string,\r\n    circuitBreakerConfig?: Partial<CircuitBreakerConfig>\r\n  ) {\r\n    this.correlationId = correlationId || uuidv4();\r\n    this.logger = createLogger('error-aggregator');\r\n\r\n    // Store circuit breaker configuration for registry\r\n    this.circuitBreakerConfig = {\r\n      failureThreshold: circuitBreakerConfig?.failureThreshold ?? 5,\r\n      successThreshold: circuitBreakerConfig?.successThreshold ?? 2,\r\n      timeout: circuitBreakerConfig?.timeout ?? 60000,\r\n      windowSize: circuitBreakerConfig?.windowSize ?? 120000,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Add error to aggregation\r\n   */\r\n  addError(\r\n    system: string,\r\n    error: DatabaseError,\r\n    operationContext?: Record<string, any>\r\n  ): AggregatedError {\r\n    const aggregatedError: AggregatedError = {\r\n      correlationId: uuidv4(),\r\n      timestamp: new Date(),\r\n      system,\r\n      error,\r\n      severity: this.determineSeverity(error),\r\n      operationContext,\r\n      stackTrace: error.originalError?.stack,\r\n    };\r\n\r\n    this.errors.push(aggregatedError);\r\n\r\n    // Update circuit breaker\r\n    this.recordFailure(system);\r\n\r\n    // Log error with correlation ID\r\n    this.logger.error(\r\n      'Database operation failed',\r\n      error.originalError,\r\n      {\r\n        correlationId: this.correlationId,\r\n        errorCorrelationId: aggregatedError.correlationId,\r\n        system,\r\n        errorCode: error.code,\r\n        message: error.message,\r\n        severity: aggregatedError.severity,\r\n      }\r\n    );\r\n\r\n    return aggregatedError;\r\n  }\r\n\r\n  /**\r\n   * Record successful operation (for circuit breaker)\r\n   */\r\n  recordSuccess(system: string): void {\r\n    // Use circuit breaker registry - success is tracked automatically via execute()\r\n    // This method is kept for backward compatibility but delegates to registry\r\n    const breaker = CircuitBreakerRegistry.getOrCreate(system, this.circuitBreakerConfig);\r\n    // Success tracking is handled internally by CircuitBreaker.execute()\r\n    // This is just a manual success recording for compatibility\r\n    this.logger.debug('Manual success recorded', { system, correlationId: this.correlationId });\r\n  }\r\n\r\n  /**\r\n   * Record failed operation (for circuit breaker)\r\n   */\r\n  private recordFailure(system: string): void {\r\n    // Failure tracking is handled by the circuit breaker registry\r\n    // This is called when addError is invoked\r\n    const breaker = CircuitBreakerRegistry.getOrCreate(system, this.circuitBreakerConfig);\r\n    this.logger.debug('Failure recorded via error aggregation', {\r\n      system,\r\n      state: breaker.getState(),\r\n      correlationId: this.correlationId,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Check if circuit breaker allows operation\r\n   */\r\n  isCircuitOpen(system: string): boolean {\r\n    const breaker = CircuitBreakerRegistry.get(system);\r\n    return breaker ? !breaker.isHealthy() : false;\r\n  }\r\n\r\n  /**\r\n   * Get aggregation result\r\n   */\r\n  getResult(expectedSystems: string[]): ErrorAggregationResult {\r\n    const errorsBySystem: Record<string, AggregatedError[]> = {};\r\n    const errorsBySeverity: Record<ErrorSeverity, AggregatedError[]> = {\r\n      [ErrorSeverity.LOW]: [],\r\n      [ErrorSeverity.MEDIUM]: [],\r\n      [ErrorSeverity.HIGH]: [],\r\n      [ErrorSeverity.CRITICAL]: [],\r\n    };\r\n\r\n    // Group errors\r\n    for (const error of this.errors) {\r\n      // By system\r\n      if (!errorsBySystem[error.system]) {\r\n        errorsBySystem[error.system] = [];\r\n      }\r\n      errorsBySystem[error.system].push(error);\r\n\r\n      // By severity\r\n      errorsBySeverity[error.severity].push(error);\r\n    }\r\n\r\n    // Check if all systems failed\r\n    const failedSystems = Object.keys(errorsBySystem);\r\n    const allSystemsFailed = expectedSystems.every(system =>\r\n      failedSystems.includes(system)\r\n    );\r\n\r\n    // Check for critical errors\r\n    const hasCriticalErrors = errorsBySeverity[ErrorSeverity.CRITICAL].length > 0;\r\n\r\n    return {\r\n      totalErrors: this.errors.length,\r\n      errorsBySystem,\r\n      errorsBySeverity,\r\n      allErrors: [...this.errors],\r\n      correlationId: this.correlationId,\r\n      allSystemsFailed,\r\n      hasCriticalErrors,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Determine error severity\r\n   */\r\n  private determineSeverity(error: DatabaseError): ErrorSeverity {\r\n    switch (error.code) {\r\n      case DatabaseErrorCode.CONNECTION_FAILED:\r\n      case DatabaseErrorCode.TRANSACTION_FAILED:\r\n        return ErrorSeverity.CRITICAL;\r\n\r\n      case DatabaseErrorCode.QUERY_FAILED:\r\n      case DatabaseErrorCode.TIMEOUT:\r\n        return ErrorSeverity.HIGH;\r\n\r\n      case DatabaseErrorCode.VALIDATION_FAILED:\r\n      case DatabaseErrorCode.CONSTRAINT_VIOLATION:\r\n        return ErrorSeverity.MEDIUM;\r\n\r\n      case DatabaseErrorCode.NOT_FOUND:\r\n      case DatabaseErrorCode.DUPLICATE_KEY:\r\n        return ErrorSeverity.LOW;\r\n\r\n      default:\r\n        return ErrorSeverity.MEDIUM;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Check if errors should cause operation failure\r\n   */\r\n  shouldFailOperation(expectedSystems: string[]): boolean {\r\n    const result = this.getResult(expectedSystems);\r\n\r\n    // Fail if all systems failed\r\n    if (result.allSystemsFailed) {\r\n      return true;\r\n    }\r\n\r\n    // Fail if any critical errors\r\n    if (result.hasCriticalErrors) {\r\n      return true;\r\n    }\r\n\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Create error report\r\n   */\r\n  createReport(): string {\r\n    const result = this.getResult([]);\r\n    const lines: string[] = [\r\n      '=== Error Aggregation Report ===',\r\n      `Correlation ID: ${this.correlationId}`,\r\n      `Total Errors: ${result.totalErrors}`,\r\n      `All Systems Failed: ${result.allSystemsFailed}`,\r\n      `Critical Errors: ${result.hasCriticalErrors}`,\r\n      '',\r\n      '--- Errors by System ---',\r\n    ];\r\n\r\n    for (const [system, errors] of Object.entries(result.errorsBySystem)) {\r\n      lines.push(`${system}: ${errors.length} error(s)`);\r\n      for (const error of errors) {\r\n        lines.push(`  - [${error.severity}] ${error.error.message}`);\r\n      }\r\n    }\r\n\r\n    lines.push('');\r\n    lines.push('--- Errors by Severity ---');\r\n    for (const [severity, errors] of Object.entries(result.errorsBySeverity)) {\r\n      if (errors.length > 0) {\r\n        lines.push(`${severity}: ${errors.length} error(s)`);\r\n      }\r\n    }\r\n\r\n    lines.push('');\r\n    lines.push('--- Circuit Breaker Status ---');\r\n    const allMetrics = CircuitBreakerRegistry.getAllMetrics();\r\n    for (const [system, metrics] of Object.entries(allMetrics)) {\r\n      lines.push(\r\n        `${system}: ${metrics.state} (failures: ${metrics.failures}, successes: ${metrics.successes})`\r\n      );\r\n    }\r\n\r\n    return lines.join('\\n');\r\n  }\r\n\r\n  /**\r\n   * Get correlation ID\r\n   */\r\n  getCorrelationId(): string {\r\n    return this.correlationId;\r\n  }\r\n\r\n  /**\r\n   * Reset aggregator (for reuse)\r\n   */\r\n  reset(): void {\r\n    this.errors = [];\r\n    this.correlationId = uuidv4();\r\n  }\r\n\r\n  /**\r\n   * Get circuit breaker state for system\r\n   */\r\n  getCircuitBreakerState(system: string): CircuitBreakerState {\r\n    const breaker = CircuitBreakerRegistry.get(system);\r\n    return breaker?.getState() || CircuitBreakerState.CLOSED;\r\n  }\r\n}\r\n\r\n/**\r\n * Create error aggregator\r\n */\r\nexport function createErrorAggregator(\r\n  correlationId?: string,\r\n  circuitBreakerConfig?: Partial<CircuitBreakerConfig>\r\n): ErrorAggregator {\r\n  return new ErrorAggregator(correlationId, circuitBreakerConfig);\r\n}\r\n"],"names":["DatabaseErrorCode","createLogger","v4","uuidv4","CircuitBreakerState","CircuitBreakerConfig","CircuitBreakerRegistry","ErrorSeverity","ErrorAggregator","logger","errors","correlationId","circuitBreakerConfig","failureThreshold","successThreshold","timeout","windowSize","addError","system","error","operationContext","aggregatedError","timestamp","Date","severity","determineSeverity","stackTrace","originalError","stack","push","recordFailure","errorCorrelationId","errorCode","code","message","recordSuccess","breaker","getOrCreate","debug","state","getState","isCircuitOpen","get","isHealthy","getResult","expectedSystems","errorsBySystem","errorsBySeverity","failedSystems","Object","keys","allSystemsFailed","every","includes","hasCriticalErrors","length","totalErrors","allErrors","CONNECTION_FAILED","TRANSACTION_FAILED","QUERY_FAILED","TIMEOUT","VALIDATION_FAILED","CONSTRAINT_VIOLATION","NOT_FOUND","DUPLICATE_KEY","shouldFailOperation","result","createReport","lines","entries","allMetrics","getAllMetrics","metrics","failures","successes","join","getCorrelationId","reset","getCircuitBreakerState","CLOSED","createErrorAggregator"],"mappings":"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"}

package/dist/lib/errors.js

@@ -0,0 +1,287 @@
+/**
+ * Standard Error Utilities
+ *
+ * Provides standardized error handling with typed error codes and context.
+ * Part of Task 0.5: Implementation Tooling & Utilities (Foundation)
+ *
+ * Usage:
+ *   throw createError(ErrorCode.VALIDATION_FAILED, 'Invalid input', { field: 'email' });
+ *   if (isErrorCode(error, ErrorCode.RETRY_EXHAUSTED)) { ... }
+ */ /**
+ * Generic error codes (extends DatabaseErrorCode)
+ */ export var ErrorCode = /*#__PURE__*/ function(ErrorCode) {
+    // Database error codes (re-exported for convenience)
+    ErrorCode["DB_CONNECTION_FAILED"] = "DB_CONNECTION_FAILED";
+    ErrorCode["DB_QUERY_FAILED"] = "DB_QUERY_FAILED";
+    ErrorCode["DB_TRANSACTION_FAILED"] = "DB_TRANSACTION_FAILED";
+    ErrorCode["DB_VALIDATION_FAILED"] = "DB_VALIDATION_FAILED";
+    ErrorCode["DB_NOT_FOUND"] = "DB_NOT_FOUND";
+    ErrorCode["DB_DUPLICATE_KEY"] = "DB_DUPLICATE_KEY";
+    ErrorCode["DB_TIMEOUT"] = "DB_TIMEOUT";
+    ErrorCode["DB_CONSTRAINT_VIOLATION"] = "DB_CONSTRAINT_VIOLATION";
+    ErrorCode["DB_UNKNOWN_ERROR"] = "DB_UNKNOWN_ERROR";
+    // Generic error codes (new in Task 0.5)
+    ErrorCode["RETRY_EXHAUSTED"] = "RETRY_EXHAUSTED";
+    ErrorCode["LOCK_TIMEOUT"] = "LOCK_TIMEOUT";
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["FILE_WRITE_FAILED"] = "FILE_WRITE_FAILED";
+    ErrorCode["OPERATION_TIMEOUT"] = "OPERATION_TIMEOUT";
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    ErrorCode["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    return ErrorCode;
+}({});
+/**
+ * Standard error class with typed error codes and context
+ */ export class StandardError extends Error {
+    /**
+   * Error code for programmatic error handling
+   */ code;
+    /**
+   * Additional context about the error
+   */ context;
+    /**
+   * Timestamp when error was created
+   */ timestamp;
+    /**
+   * Original error that caused this error (if any)
+   */ cause;
+    /**
+   * Whether this error is retryable (for retry logic)
+   */ isRetryable;
+    /**
+   * Create a new StandardError
+   *
+   * @param code - Error code
+   * @param message - Human-readable error message
+   * @param context - Additional context about the error
+   * @param cause - Original error that caused this error
+   * @param isRetryable - Whether this error is retryable (auto-detected if not provided)
+   */ constructor(code, message, context, cause, isRetryable){
+        super(message);
+        this.name = 'StandardError';
+        this.code = code;
+        this.context = context;
+        this.timestamp = new Date();
+        this.cause = cause;
+        // Auto-detect retryable status if not explicitly provided
+        if (isRetryable !== undefined) {
+            this.isRetryable = isRetryable;
+        } else {
+            this.isRetryable = this.detectRetryable(code);
+        }
+        // Maintain proper stack trace for where our error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, StandardError);
+        }
+        // Append original error stack if available
+        if (cause && cause.stack) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+    /**
+   * Auto-detect if error code indicates retryable condition
+   */ detectRetryable(code) {
+        const retryableCodes = [
+            "DB_TIMEOUT",
+            "DB_CONNECTION_FAILED",
+            "OPERATION_TIMEOUT",
+            "NETWORK_ERROR",
+            "LOCK_TIMEOUT"
+        ];
+        return retryableCodes.includes(code);
+    }
+    /**
+   * Convert error to JSON representation
+   */ toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            context: this.context,
+            timestamp: this.timestamp.toISOString(),
+            isRetryable: this.isRetryable,
+            stack: this.stack,
+            cause: this.cause ? {
+                name: this.cause.name,
+                message: this.cause.message,
+                stack: this.cause.stack
+            } : undefined
+        };
+    }
+    /**
+   * Convert error to string representation
+   */ toString() {
+        let str = `${this.name} [${this.code}]: ${this.message}`;
+        if (this.context && Object.keys(this.context).length > 0) {
+            str += `\nContext: ${JSON.stringify(this.context, null, 2)}`;
+        }
+        if (this.cause) {
+            str += `\nCaused by: ${this.cause.message}`;
+        }
+        return str;
+    }
+}
+/**
+ * Create a StandardError instance
+ *
+ * @param code - Error code
+ * @param message - Human-readable error message
+ * @param context - Additional context about the error
+ * @param cause - Original error that caused this error
+ * @returns StandardError instance
+ */ export function createError(code, message, context, cause) {
+    return new StandardError(code, message, context, cause);
+}
+/**
+ * Check if an error has a specific error code
+ *
+ * @param error - Error to check
+ * @param code - Error code to match
+ * @returns True if error has the specified code
+ */ export function isErrorCode(error, code) {
+    if (!error) {
+        return false;
+    }
+    // Check StandardError
+    if (error instanceof StandardError) {
+        return error.code === code;
+    }
+    // Check DatabaseError pattern (object with code property)
+    if (typeof error === 'object' && 'code' in error) {
+        return error.code === code;
+    }
+    return false;
+}
+/**
+ * Check if error is a StandardError instance
+ *
+ * @param error - Error to check
+ * @returns True if error is a StandardError
+ */ export function isStandardError(error) {
+    return error instanceof StandardError;
+}
+/**
+ * Wrap an unknown error into a StandardError
+ *
+ * @param error - Unknown error to wrap
+ * @param code - Error code to use (default: UNKNOWN_ERROR)
+ * @param context - Additional context
+ * @returns StandardError instance
+ */ export function wrapError(error, code = "UNKNOWN_ERROR", context) {
+    if (error instanceof StandardError) {
+        // Already a StandardError, return as-is or with additional context
+        if (context) {
+            return new StandardError(error.code, error.message, {
+                ...error.context,
+                ...context
+            }, error.cause);
+        }
+        return error;
+    }
+    if (error instanceof Error) {
+        return new StandardError(code, error.message, context, error);
+    }
+    // Handle non-Error objects
+    const message = typeof error === 'string' ? error : String(error);
+    return new StandardError(code, message, context);
+}
+/**
+ * Extract error message from unknown error
+ *
+ * @param error - Unknown error
+ * @returns Error message string
+ */ export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return String(error);
+}
+/**
+ * Extract error code from unknown error
+ *
+ * @param error - Unknown error
+ * @returns Error code or undefined
+ */ export function getErrorCode(error) {
+    if (error instanceof StandardError) {
+        return error.code;
+    }
+    if (error && typeof error === 'object' && 'code' in error) {
+        return String(error.code);
+    }
+    return undefined;
+}
+/**
+ * Check if error indicates a retryable condition
+ *
+ * @param error - Error to check
+ * @returns True if error is retryable
+ */ export function isRetryableError(error) {
+    // Check StandardError with isRetryable flag
+    if (error instanceof StandardError) {
+        return error.isRetryable;
+    }
+    // Fallback: check error code for retryable codes
+    const retryableCodes = [
+        "DB_TIMEOUT",
+        "DB_CONNECTION_FAILED",
+        "OPERATION_TIMEOUT",
+        "NETWORK_ERROR",
+        "LOCK_TIMEOUT"
+    ];
+    if (typeof error === 'object' && 'code' in error) {
+        return retryableCodes.includes(error.code);
+    }
+    return false;
+}
+/**
+ * Create a validation error
+ *
+ * @param message - Validation error message
+ * @param field - Field that failed validation
+ * @param value - Invalid value (optional)
+ * @returns StandardError instance
+ */ export function createValidationError(message, field, value) {
+    const context = {};
+    if (field) {
+        context.field = field;
+    }
+    if (value !== undefined) {
+        context.value = value;
+    }
+    return new StandardError("VALIDATION_FAILED", message, context);
+}
+/**
+ * Create a retry exhausted error
+ *
+ * @param attempts - Number of retry attempts made
+ * @param lastError - Last error encountered
+ * @returns StandardError instance
+ */ export function createRetryExhaustedError(attempts, lastError) {
+    return new StandardError("RETRY_EXHAUSTED", `Operation failed after ${attempts} retry attempts`, {
+        attempts
+    }, lastError);
+}
+/**
+ * Create a timeout error
+ *
+ * @param operation - Operation that timed out
+ * @param timeoutMs - Timeout duration in milliseconds
+ * @returns StandardError instance
+ */ export function createTimeoutError(operation, timeoutMs) {
+    return new StandardError("OPERATION_TIMEOUT", `Operation '${operation}' timed out after ${timeoutMs}ms`, {
+        operation,
+        timeoutMs
+    });
+}
+
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/errors.ts"],"sourcesContent":["/**\r\n * Standard Error Utilities\r\n *\r\n * Provides standardized error handling with typed error codes and context.\r\n * Part of Task 0.5: Implementation Tooling & Utilities (Foundation)\r\n *\r\n * Usage:\r\n *   throw createError(ErrorCode.VALIDATION_FAILED, 'Invalid input', { field: 'email' });\r\n *   if (isErrorCode(error, ErrorCode.RETRY_EXHAUSTED)) { ... }\r\n */\r\n\r\nimport { DatabaseErrorCode } from './database-service/errors.js';\r\n\r\n/**\r\n * Generic error codes (extends DatabaseErrorCode)\r\n */\r\nexport enum ErrorCode {\r\n  // Database error codes (re-exported for convenience)\r\n  DB_CONNECTION_FAILED = 'DB_CONNECTION_FAILED',\r\n  DB_QUERY_FAILED = 'DB_QUERY_FAILED',\r\n  DB_TRANSACTION_FAILED = 'DB_TRANSACTION_FAILED',\r\n  DB_VALIDATION_FAILED = 'DB_VALIDATION_FAILED',\r\n  DB_NOT_FOUND = 'DB_NOT_FOUND',\r\n  DB_DUPLICATE_KEY = 'DB_DUPLICATE_KEY',\r\n  DB_TIMEOUT = 'DB_TIMEOUT',\r\n  DB_CONSTRAINT_VIOLATION = 'DB_CONSTRAINT_VIOLATION',\r\n  DB_UNKNOWN_ERROR = 'DB_UNKNOWN_ERROR',\r\n\r\n  // Generic error codes (new in Task 0.5)\r\n  RETRY_EXHAUSTED = 'RETRY_EXHAUSTED',\r\n  LOCK_TIMEOUT = 'LOCK_TIMEOUT',\r\n  VALIDATION_FAILED = 'VALIDATION_FAILED',\r\n  INVALID_INPUT = 'INVALID_INPUT',\r\n  FILE_NOT_FOUND = 'FILE_NOT_FOUND',\r\n  FILE_WRITE_FAILED = 'FILE_WRITE_FAILED',\r\n  OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\r\n  NETWORK_ERROR = 'NETWORK_ERROR',\r\n  PARSE_ERROR = 'PARSE_ERROR',\r\n  CONFIGURATION_ERROR = 'CONFIGURATION_ERROR',\r\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\r\n}\r\n\r\n/**\r\n * Standard error class with typed error codes and context\r\n */\r\nexport class StandardError extends Error {\r\n  /**\r\n   * Error code for programmatic error handling\r\n   */\r\n  public readonly code: ErrorCode | string;\r\n\r\n  /**\r\n   * Additional context about the error\r\n   */\r\n  public readonly context?: Record<string, any>;\r\n\r\n  /**\r\n   * Timestamp when error was created\r\n   */\r\n  public readonly timestamp: Date;\r\n\r\n  /**\r\n   * Original error that caused this error (if any)\r\n   */\r\n  public readonly cause?: Error;\r\n\r\n  /**\r\n   * Whether this error is retryable (for retry logic)\r\n   */\r\n  public readonly isRetryable: boolean;\r\n\r\n  /**\r\n   * Create a new StandardError\r\n   *\r\n   * @param code - Error code\r\n   * @param message - Human-readable error message\r\n   * @param context - Additional context about the error\r\n   * @param cause - Original error that caused this error\r\n   * @param isRetryable - Whether this error is retryable (auto-detected if not provided)\r\n   */\r\n  constructor(\r\n    code: ErrorCode | string,\r\n    message: string,\r\n    context?: Record<string, any>,\r\n    cause?: Error,\r\n    isRetryable?: boolean\r\n  ) {\r\n    super(message);\r\n    this.name = 'StandardError';\r\n    this.code = code;\r\n    this.context = context;\r\n    this.timestamp = new Date();\r\n    this.cause = cause;\r\n\r\n    // Auto-detect retryable status if not explicitly provided\r\n    if (isRetryable !== undefined) {\r\n      this.isRetryable = isRetryable;\r\n    } else {\r\n      this.isRetryable = this.detectRetryable(code);\r\n    }\r\n\r\n    // Maintain proper stack trace for where our error was thrown (V8 only)\r\n    if (Error.captureStackTrace) {\r\n      Error.captureStackTrace(this, StandardError);\r\n    }\r\n\r\n    // Append original error stack if available\r\n    if (cause && cause.stack) {\r\n      this.stack = `${this.stack}\\nCaused by: ${cause.stack}`;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Auto-detect if error code indicates retryable condition\r\n   */\r\n  private detectRetryable(code: ErrorCode | string): boolean {\r\n    const retryableCodes = [\r\n      ErrorCode.DB_TIMEOUT,\r\n      ErrorCode.DB_CONNECTION_FAILED,\r\n      ErrorCode.OPERATION_TIMEOUT,\r\n      ErrorCode.NETWORK_ERROR,\r\n      ErrorCode.LOCK_TIMEOUT,\r\n    ];\r\n    return retryableCodes.includes(code as ErrorCode);\r\n  }\r\n\r\n  /**\r\n   * Convert error to JSON representation\r\n   */\r\n  toJSON(): Record<string, any> {\r\n    return {\r\n      name: this.name,\r\n      code: this.code,\r\n      message: this.message,\r\n      context: this.context,\r\n      timestamp: this.timestamp.toISOString(),\r\n      isRetryable: this.isRetryable,\r\n      stack: this.stack,\r\n      cause: this.cause\r\n        ? {\r\n            name: this.cause.name,\r\n            message: this.cause.message,\r\n            stack: this.cause.stack,\r\n          }\r\n        : undefined,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Convert error to string representation\r\n   */\r\n  toString(): string {\r\n    let str = `${this.name} [${this.code}]: ${this.message}`;\r\n\r\n    if (this.context && Object.keys(this.context).length > 0) {\r\n      str += `\\nContext: ${JSON.stringify(this.context, null, 2)}`;\r\n    }\r\n\r\n    if (this.cause) {\r\n      str += `\\nCaused by: ${this.cause.message}`;\r\n    }\r\n\r\n    return str;\r\n  }\r\n}\r\n\r\n/**\r\n * Create a StandardError instance\r\n *\r\n * @param code - Error code\r\n * @param message - Human-readable error message\r\n * @param context - Additional context about the error\r\n * @param cause - Original error that caused this error\r\n * @returns StandardError instance\r\n */\r\nexport function createError(\r\n  code: ErrorCode | string,\r\n  message: string,\r\n  context?: Record<string, any>,\r\n  cause?: Error\r\n): StandardError {\r\n  return new StandardError(code, message, context, cause);\r\n}\r\n\r\n/**\r\n * Check if an error has a specific error code\r\n *\r\n * @param error - Error to check\r\n * @param code - Error code to match\r\n * @returns True if error has the specified code\r\n */\r\nexport function isErrorCode(error: any, code: ErrorCode | string): boolean {\r\n  if (!error) {\r\n    return false;\r\n  }\r\n\r\n  // Check StandardError\r\n  if (error instanceof StandardError) {\r\n    return error.code === code;\r\n  }\r\n\r\n  // Check DatabaseError pattern (object with code property)\r\n  if (typeof error === 'object' && 'code' in error) {\r\n    return error.code === code;\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Check if error is a StandardError instance\r\n *\r\n * @param error - Error to check\r\n * @returns True if error is a StandardError\r\n */\r\nexport function isStandardError(error: any): error is StandardError {\r\n  return error instanceof StandardError;\r\n}\r\n\r\n/**\r\n * Wrap an unknown error into a StandardError\r\n *\r\n * @param error - Unknown error to wrap\r\n * @param code - Error code to use (default: UNKNOWN_ERROR)\r\n * @param context - Additional context\r\n * @returns StandardError instance\r\n */\r\nexport function wrapError(\r\n  error: unknown,\r\n  code: ErrorCode | string = ErrorCode.UNKNOWN_ERROR,\r\n  context?: Record<string, any>\r\n): StandardError {\r\n  if (error instanceof StandardError) {\r\n    // Already a StandardError, return as-is or with additional context\r\n    if (context) {\r\n      return new StandardError(\r\n        error.code,\r\n        error.message,\r\n        { ...error.context, ...context },\r\n        error.cause\r\n      );\r\n    }\r\n    return error;\r\n  }\r\n\r\n  if (error instanceof Error) {\r\n    return new StandardError(code, error.message, context, error);\r\n  }\r\n\r\n  // Handle non-Error objects\r\n  const message = typeof error === 'string' ? error : String(error);\r\n  return new StandardError(code, message, context);\r\n}\r\n\r\n/**\r\n * Extract error message from unknown error\r\n *\r\n * @param error - Unknown error\r\n * @returns Error message string\r\n */\r\nexport function getErrorMessage(error: unknown): string {\r\n  if (error instanceof Error) {\r\n    return error.message;\r\n  }\r\n\r\n  if (typeof error === 'string') {\r\n    return error;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'message' in error) {\r\n    return String(error.message);\r\n  }\r\n\r\n  return String(error);\r\n}\r\n\r\n/**\r\n * Extract error code from unknown error\r\n *\r\n * @param error - Unknown error\r\n * @returns Error code or undefined\r\n */\r\nexport function getErrorCode(error: unknown): string | undefined {\r\n  if (error instanceof StandardError) {\r\n    return error.code;\r\n  }\r\n\r\n  if (error && typeof error === 'object' && 'code' in error) {\r\n    return String(error.code);\r\n  }\r\n\r\n  return undefined;\r\n}\r\n\r\n/**\r\n * Check if error indicates a retryable condition\r\n *\r\n * @param error - Error to check\r\n * @returns True if error is retryable\r\n */\r\nexport function isRetryableError(error: any): boolean {\r\n  // Check StandardError with isRetryable flag\r\n  if (error instanceof StandardError) {\r\n    return error.isRetryable;\r\n  }\r\n\r\n  // Fallback: check error code for retryable codes\r\n  const retryableCodes = [\r\n    ErrorCode.DB_TIMEOUT,\r\n    ErrorCode.DB_CONNECTION_FAILED,\r\n    ErrorCode.OPERATION_TIMEOUT,\r\n    ErrorCode.NETWORK_ERROR,\r\n    ErrorCode.LOCK_TIMEOUT,\r\n  ];\r\n\r\n  if (typeof error === 'object' && 'code' in error) {\r\n    return retryableCodes.includes(error.code);\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\n/**\r\n * Create a validation error\r\n *\r\n * @param message - Validation error message\r\n * @param field - Field that failed validation\r\n * @param value - Invalid value (optional)\r\n * @returns StandardError instance\r\n */\r\nexport function createValidationError(\r\n  message: string,\r\n  field?: string,\r\n  value?: any\r\n): StandardError {\r\n  const context: Record<string, any> = {};\r\n\r\n  if (field) {\r\n    context.field = field;\r\n  }\r\n\r\n  if (value !== undefined) {\r\n    context.value = value;\r\n  }\r\n\r\n  return new StandardError(ErrorCode.VALIDATION_FAILED, message, context);\r\n}\r\n\r\n/**\r\n * Create a retry exhausted error\r\n *\r\n * @param attempts - Number of retry attempts made\r\n * @param lastError - Last error encountered\r\n * @returns StandardError instance\r\n */\r\nexport function createRetryExhaustedError(\r\n  attempts: number,\r\n  lastError?: Error\r\n): StandardError {\r\n  return new StandardError(\r\n    ErrorCode.RETRY_EXHAUSTED,\r\n    `Operation failed after ${attempts} retry attempts`,\r\n    { attempts },\r\n    lastError\r\n  );\r\n}\r\n\r\n/**\r\n * Create a timeout error\r\n *\r\n * @param operation - Operation that timed out\r\n * @param timeoutMs - Timeout duration in milliseconds\r\n * @returns StandardError instance\r\n */\r\nexport function createTimeoutError(operation: string, timeoutMs: number): StandardError {\r\n  return new StandardError(\r\n    ErrorCode.OPERATION_TIMEOUT,\r\n    `Operation '${operation}' timed out after ${timeoutMs}ms`,\r\n    { operation, timeoutMs }\r\n  );\r\n}\r\n"],"names":["ErrorCode","StandardError","Error","code","context","timestamp","cause","isRetryable","message","name","Date","undefined","detectRetryable","captureStackTrace","stack","retryableCodes","includes","toJSON","toISOString","toString","str","Object","keys","length","JSON","stringify","createError","isErrorCode","error","isStandardError","wrapError","String","getErrorMessage","getErrorCode","isRetryableError","createValidationError","field","value","createRetryExhaustedError","attempts","lastError","createTimeoutError","operation","timeoutMs"],"mappings":"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"}