@tamyla/clodo-framework 3.1.9 → 3.1.11

package/bin/shared/utils/error-recovery.js

@@ -1,245 +0,0 @@
-/**
- * Error Recovery Module - UNIFIED
- * Implements circuit breakers, retries, and graceful degradation
- * 
- * Consolidation: Oct 26, 2025 - Phase 3.2.3a
- * 
- * Merged from:
- * - src/utils/error-recovery.js (225 lines)
- * - bin/shared/utils/error-recovery.js (225 lines - DUPLICATE)
- * 
- * This is the canonical version. All imports should use this version.
- */
-
-export class ErrorRecoveryManager {
-  constructor(options = {}) {
-    this.options = options;
-    this.config = null;
-    this.circuitStates = new Map(); // service -> { failures, lastFailure, state }
-    this.retryStates = new Map(); // operation -> retry count
-  }
-
-  /**
-   * Initialize with framework configuration
-   */
-  async initialize() {
-    // Import framework config for consistent timing and retry settings
-    try {
-      const { frameworkConfig } = await import('./framework-config.js');
-      const timing = frameworkConfig.getTiming();
-      
-      this.config = {
-        maxRetries: this.options.maxRetries || timing.retryAttempts,
-        retryDelay: this.options.retryDelay || timing.retryDelay,
-        circuitBreakerThreshold: this.options.circuitBreakerThreshold || timing.circuitBreakerThreshold,
-        circuitBreakerTimeout: this.options.circuitBreakerTimeout || timing.circuitBreakerTimeout,
-        gracefulDegradation: this.options.gracefulDegradation !== false,
-        ...this.options
-      };
-    } catch (error) {
-      // Fallback to defaults if framework config not available
-      this.config = {
-        maxRetries: this.options.maxRetries || 3,
-        retryDelay: this.options.retryDelay || 1000,
-        circuitBreakerThreshold: this.options.circuitBreakerThreshold || 5,
-        circuitBreakerTimeout: this.options.circuitBreakerTimeout || 60000,
-        gracefulDegradation: this.options.gracefulDegradation !== false,
-        ...this.options
-      };
-    }
-  }
-
-  /**
-   * Execute operation with error recovery
-   */
-  async executeWithRecovery(operation, options = {}) {
-    const config = { ...this.config, ...options };
-    const operationId = this.getOperationId(operation);
-
-    // Check circuit breaker
-    if (this.isCircuitOpen(operationId)) {
-      if (config.gracefulDegradation) {
-        return this.executeGracefulFallback(operation, config);
-      }
-      throw new Error(`Circuit breaker open for operation: ${operationId}`);
-    }
-
-    let lastError;
-    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
-      try {
-        const result = await operation();
-        this.recordSuccess(operationId);
-        return result;
-      } catch (error) {
-        lastError = error;
-        this.recordFailure(operationId, error);
-
-        if (attempt < config.maxRetries) {
-          const delay = this.calculateRetryDelay(attempt, config.retryDelay);
-          await this.delay(delay);
-        }
-      }
-    }
-
-    // All retries exhausted
-    if (config.gracefulDegradation) {
-      return this.executeGracefulFallback(operation, config);
-    }
-
-    throw lastError;
-  }
-
-  /**
-   * Check if circuit breaker is open
-   */
-  isCircuitOpen(operationId) {
-    const state = this.circuitStates.get(operationId);
-    if (!state) return false;
-
-    if (state.state === 'open') {
-      // Check if timeout has passed
-      if (Date.now() - state.lastFailure > this.config.circuitBreakerTimeout) {
-        state.state = 'half-open';
-        state.failures = 0;
-        return false;
-      }
-      return true;
-    }
-
-    return false;
-  }
-
-  /**
-   * Record operation success
-   */
-  recordSuccess(operationId) {
-    const state = this.circuitStates.get(operationId);
-    if (state) {
-      if (state.state === 'half-open') {
-        state.state = 'closed';
-        state.failures = 0;
-      }
-    }
-  }
-
-  /**
-   * Record operation failure
-   */
-  recordFailure(operationId, error) {
-    let state = this.circuitStates.get(operationId);
-    if (!state) {
-      state = { failures: 0, lastFailure: 0, state: 'closed' };
-      this.circuitStates.set(operationId, state);
-    }
-
-    state.failures++;
-    state.lastFailure = Date.now();
-
-    if (state.failures >= this.config.circuitBreakerThreshold) {
-      state.state = 'open';
-    }
-  }
-
-  /**
-   * Calculate retry delay with exponential backoff
-   */
-  calculateRetryDelay(attempt, baseDelay) {
-    const exponentialDelay = baseDelay * Math.pow(2, attempt);
-    const jitter = Math.random() * 0.1 * exponentialDelay;
-    return Math.min(exponentialDelay + jitter, 30000); // Max 30 seconds
-  }
-
-  /**
-   * Execute graceful fallback
-   */
-  async executeGracefulFallback(operation, config) {
-    console.warn(`Executing graceful fallback for operation`);
-
-    // Try to execute with reduced functionality
-    try {
-      // For deployment operations, try a simplified version
-      if (operation.name && operation.name.includes('deploy')) {
-        return { success: false, degraded: true, message: 'Operation executed in degraded mode' };
-      }
-
-      // For data operations, return cached or default data
-      if (operation.name && operation.name.includes('fetch')) {
-        return { data: [], cached: true, degraded: true };
-      }
-
-      // Default fallback
-      return { success: false, degraded: true, fallback: true };
-
-    } catch (fallbackError) {
-      console.error('Graceful fallback also failed:', fallbackError);
-      throw fallbackError;
-    }
-  }
-
-  /**
-   * Get unique operation ID
-   */
-  getOperationId(operation) {
-    if (typeof operation === 'function' && operation.name) {
-      return operation.name;
-    }
-    return `operation_${Date.now()}_${Math.random()}`;
-  }
-
-  /**
-   * Utility delay function
-   */
-  delay(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-  }
-
-  /**
-   * Get circuit breaker status
-   */
-  getCircuitStatus(operationId) {
-    const state = this.circuitStates.get(operationId);
-    if (!state) {
-      return { state: 'closed', failures: 0 };
-    }
-    return {
-      state: state.state,
-      failures: state.failures,
-      lastFailure: state.lastFailure,
-      timeSinceLastFailure: Date.now() - state.lastFailure
-    };
-  }
-
-  /**
-   * Reset circuit breaker
-   */
-  resetCircuit(operationId) {
-    this.circuitStates.delete(operationId);
-  }
-
-  /**
-   * Get all circuit statuses
-   */
-  getAllCircuitStatuses() {
-    const statuses = {};
-    for (const [operationId, state] of this.circuitStates) {
-      statuses[operationId] = this.getCircuitStatus(operationId);
-    }
-    return statuses;
-  }
-}
-
-/**
- * Retry wrapper for functions
- */
-export function withRetry(fn, options = {}) {
-  const recovery = new ErrorRecoveryManager(options);
-  return (...args) => recovery.executeWithRecovery(() => fn(...args), options);
-}
-
-/**
- * Circuit breaker wrapper for functions
- */
-export function withCircuitBreaker(fn, options = {}) {
-  const recovery = new ErrorRecoveryManager(options);
-  return (...args) => recovery.executeWithRecovery(() => fn(...args), options);
-}

package/bin/shared/utils/file-manager.js

@@ -1,162 +0,0 @@
-/**
- * Centralized File Manager
- * Replaces: 12 scattered file operation implementations
- * Savings: 200+ lines
- */
-
-import { 
-  readFileSync, writeFileSync, appendFileSync,
-  existsSync, mkdirSync, statSync
-} from 'fs';
-import { dirname, basename } from 'path';
-
-export class FileManager {
-  constructor(options = {}) {
-    this.cache = new Map();
-    this.enableCache = options.enableCache !== false;
-    this.createBackups = options.createBackups !== false;
-    this.backupDir = options.backupDir || '.backups';
-  }
-
-  /**
-   * Read JSON configuration file
-   */
-  readConfig(path, defaultValue = null) {
-    try {
-      if (this.enableCache && this.cache.has(path)) {
-        return this.cache.get(path);
-      }
-      
-      if (!existsSync(path)) {
-        if (defaultValue !== null) return defaultValue;
-        throw new Error(`Configuration file not found: ${path}`);
-      }
-      
-      const content = readFileSync(path, 'utf8');
-      const data = JSON.parse(content);
-      
-      if (this.enableCache) {
-        this.cache.set(path, data);
-      }
-      
-      return data;
-    } catch (error) {
-      if (error.message.includes('JSON')) {
-        throw new Error(`Invalid JSON in configuration file: ${error.message}`);
-      }
-      throw error;
-    }
-  }
-
-  /**
-   * Write JSON configuration file with optional backup
-   */
-  writeConfig(path, data, options = {}) {
-    try {
-      // Create backup if needed
-      if (this.createBackups && existsSync(path)) {
-        this.createBackup(path);
-      }
-      
-      // Ensure directory exists
-      this.ensureDir(dirname(path));
-      
-      // Write file
-      const content = JSON.stringify(data, null, 2);
-      writeFileSync(path, content, 'utf8');
-      
-      // Clear cache
-      if (this.enableCache) {
-        this.cache.delete(path);
-      }
-      
-      return { success: true, path };
-    } catch (error) {
-      throw new Error(`Failed to write configuration: ${error.message}`);
-    }
-  }
-
-  /**
-   * Read text file
-   */
-  readFile(path) {
-    if (!existsSync(path)) {
-      throw new Error(`File not found: ${path}`);
-    }
-    return readFileSync(path, 'utf8');
-  }
-
-  /**
-   * Write text file
-   */
-  writeFile(path, content) {
-    this.ensureDir(dirname(path));
-    writeFileSync(path, content, 'utf8');
-  }
-
-  /**
-   * Append to file
-   */
-  appendFile(path, content) {
-    this.ensureDir(dirname(path));
-    appendFileSync(path, content, 'utf8');
-  }
-
-  /**
-   * Check if file exists
-   */
-  exists(path) {
-    return existsSync(path);
-  }
-
-  /**
-   * Ensure directory exists
-   */
-  ensureDir(dir) {
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-    }
-  }
-
-  /**
-   * Create backup of file
-   */
-  createBackup(path) {
-    this.ensureDir(this.backupDir);
-    
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const fileName = basename(path);
-    const backupPath = `${this.backupDir}/${fileName}.${timestamp}.bak`;
-    
-    const content = readFileSync(path, 'utf8');
-    writeFileSync(backupPath, content, 'utf8');
-    
-    return backupPath;
-  }
-
-  /**
-   * Get file stats
-   */
-  getStats(path) {
-    if (!existsSync(path)) {
-      return null;
-    }
-    return statSync(path);
-  }
-
-  /**
-   * Clear cache
-   */
-  clearCache(path = null) {
-    if (path) {
-      this.cache.delete(path);
-    } else {
-      this.cache.clear();
-    }
-  }
-}
-
-/**
- * Export singleton instance
- */
-export const fileManager = new FileManager();

package/bin/shared/utils/formatters.js

@@ -1,247 +0,0 @@
-/**
- * Data Formatters for Clodo Framework
- * Centralizes all data transformation logic
- * Replaces: 5 scattered formatting implementations
- * Savings: 150+ lines
- */
-
-/**
- * Name formatting utilities
- */
-export const NameFormatters = {
-  /**
-   * Convert kebab-case to Display Case
-   * Example: 'my-service' → 'My Service'
-   */
-  toDisplayName(kebabCase) {
-    if (!kebabCase) return '';
-    return kebabCase
-      .replace(/-/g, ' ')
-      .replace(/\b\w/g, l => l.toUpperCase());
-  },
-
-  /**
-   * Convert camelCase to kebab-case
-   * Example: 'myService' → 'my-service'
-   */
-  toKebabCase(camelCase) {
-    if (!camelCase) return '';
-    return camelCase
-      .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-      .replace(/^([A-Z])([A-Z])/g, '$1-$2')
-      .toLowerCase();
-  },
-
-  /**
-   * Convert kebab-case to camelCase
-   * Example: 'my-service' → 'myService'
-   */
-  toCamelCase(kebabCase) {
-    if (!kebabCase) return '';
-    return kebabCase
-      .split('-')
-      .map((part, i) => 
-        i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)
-      )
-      .join('');
-  },
-
-  /**
-   * Convert snake_case to camelCase
-   * Example: 'my_service' → 'myService'
-   */
-  snakeToCamel(snakeCase) {
-    if (!snakeCase) return '';
-    return snakeCase
-      .split('_')
-      .map((part, i) => 
-        i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)
-      )
-      .join('');
-  }
-};
-
-/**
- * URL formatting utilities
- */
-export const UrlFormatters = {
-  /**
-   * Build service URL
-   * Example: buildServiceUrl('api', 'example.com', 'production')
-   * → 'https://api.example.com'
-   */
-  buildServiceUrl(serviceName, domain, environment = 'production') {
-    if (!serviceName || !domain) return '';
-    
-    const prefix = environment === 'production' 
-      ? serviceName 
-      : `${serviceName}-${environment.substring(0, 3)}`;
-    
-    return `https://${prefix}.${domain}`;
-  },
-
-  /**
-   * Build production URL
-   */
-  buildProductionUrl(serviceName, domain) {
-    return this.buildServiceUrl(serviceName, domain, 'production');
-  },
-
-  /**
-   * Build staging URL
-   */
-  buildStagingUrl(serviceName, domain) {
-    return this.buildServiceUrl(serviceName, domain, 'staging');
-  },
-
-  /**
-   * Build development URL
-   */
-  buildDevUrl(serviceName, domain) {
-    return this.buildServiceUrl(serviceName, domain, 'development');
-  },
-
-  /**
-   * Build API endpoint URL
-   */
-  buildApiUrl(serviceName, domain, path = '') {
-    const baseUrl = this.buildProductionUrl(serviceName, domain);
-    return path ? `${baseUrl}${path}` : baseUrl;
-  }
-};
-
-/**
- * Resource name formatters
- */
-export const ResourceFormatters = {
-  /**
-   * Format database name
-   * Example: 'my-service' → 'my-service-db'
-   */
-  databaseName(serviceName) {
-    if (!serviceName) return '';
-    return `${serviceName}-db`;
-  },
-
-  /**
-   * Format worker name
-   * Example: 'my-service' → 'my-service-worker'
-   */
-  workerName(serviceName) {
-    if (!serviceName) return '';
-    return `${serviceName}-worker`;
-  },
-
-  /**
-   * Format service directory
-   * Example: 'my-service' → './services/my-service'
-   */
-  serviceDirectory(serviceName) {
-    if (!serviceName) return '';
-    return `./services/${serviceName}`;
-  },
-
-  /**
-   * Format configuration key
-   * Example: 'cloudflareApiToken' → 'cloudflare-api-token'
-   */
-  configKey(camelCase) {
-    return NameFormatters.toKebabCase(camelCase);
-  }
-};
-
-/**
- * Environment-related formatters
- */
-export const EnvironmentFormatters = {
-  /**
-   * Get environment variable prefix
-   * Example: 'production' → 'PROD_'
-   */
-  getEnvPrefix(environment) {
-    switch (environment) {
-      case 'production':
-        return 'PROD_';
-      case 'staging':
-        return 'STAGING_';
-      case 'development':
-        return 'DEV_';
-      default:
-        return 'APP_';
-    }
-  },
-
-  /**
-   * Get log level for environment
-   * Example: 'production' → 'warn'
-   */
-  getLogLevel(environment) {
-    switch (environment) {
-      case 'production':
-        return 'warn';
-      case 'staging':
-        return 'info';
-      case 'development':
-        return 'debug';
-      default:
-        return 'info';
-    }
-  },
-
-  /**
-   * Get CORS policy for environment
-   */
-  getCorsPolicy(domain, environment) {
-    switch (environment) {
-      case 'production':
-        return `https://${domain}`;
-      case 'staging':
-        return `https://${domain}`;
-      case 'development':
-        return '*'; // Allow all in development
-      default:
-        return '*';
-    }
-  }
-};
-
-/**
- * Version formatting
- */
-export const VersionFormatters = {
-  /**
-   * Normalize version string
-   */
-  normalize(version) {
-    const match = version.match(/(\d+\.\d+\.\d+)/);
-    return match ? match[1] : '1.0.0';
-  },
-
-  /**
-   * Bump version
-   */
-  bump(version, type = 'patch') {
-    const [major, minor, patch] = version.split('.').map(Number);
-    
-    switch (type) {
-      case 'major':
-        return `${major + 1}.0.0`;
-      case 'minor':
-        return `${major}.${minor + 1}.0`;
-      case 'patch':
-      default:
-        return `${major}.${minor}.${patch + 1}`;
-    }
-  }
-};
-
-/**
- * Convenience exports - combine all formatters
- */
-export const Formatters = {
-  ...NameFormatters,
-  ...UrlFormatters,
-  ...ResourceFormatters,
-  ...EnvironmentFormatters,
-  ...VersionFormatters
-};