@tamyla/clodo-framework 3.1.21 → 3.1.23

package/dist/lib/shared/deployment/workflows/deployment-summary.js

@@ -0,0 +1,214 @@
+/**
+ * Deployment Summary Module
+ * 
+ * Provides reusable deployment success/failure summary reporting.
+ * Extracted from enterprise-deployment/master-deploy.js for modularity.
+ * 
+ * @module deployment-summary
+ */
+
+/**
+ * Deployment Summary Manager
+ * Handles success summaries, enterprise summaries, and deployment statistics
+ */
+export class DeploymentSummary {
+  /**
+   * Display standard deployment success summary
+   * 
+   * @param {Object} deploymentState - Deployment state object
+   * @param {Object} config - Deployment configuration
+   * @param {Object} options - Display options
+   * @returns {Promise<void>}
+   */
+  static async displaySuccessSummary(deploymentState, config, options = {}) {
+    const duration = (Date.now() - deploymentState.startTime.getTime()) / 1000;
+    console.log('\n🎉 DEPLOYMENT SUCCESSFUL!');
+    console.log('=========================');
+    console.log(`\n📊 Summary:`);
+    console.log(`   🆔 Deployment ID: ${deploymentState.deploymentId}`);
+    console.log(`   🌐 Domain: ${config.domain}`);
+    console.log(`   ⏱️ Duration: ${duration.toFixed(1)}s`);
+    console.log(`   🔑 Secrets: ${Object.keys(config.secrets.keys).length} deployed`);
+    this.displayEndpoints(config);
+    this.displayDistributionFiles(config);
+    this.displayNextSteps(config);
+  }
+
+  /**
+   * Display enterprise deployment success summary
+   * 
+   * @param {Object} deploymentState - Deployment state object
+   * @param {Object} config - Deployment configuration
+   * @param {Object} frameworkPaths - Framework paths configuration
+   * @param {Object} enterpriseModules - Enterprise modules
+   * @returns {Promise<void>}
+   */
+  static async displayEnterpriseSuccessSummary(deploymentState, config, frameworkPaths, enterpriseModules) {
+    console.log('\n🎉 ENTERPRISE DEPLOYMENT SUCCESSFUL!');
+    console.log('====================================');
+    const duration = (new Date() - deploymentState.startTime) / 1000;
+    this.displayDeploymentStats(deploymentState, config, duration);
+    this.displayEnterpriseEndpoints(config);
+    this.displayGeneratedFiles(frameworkPaths, config, deploymentState);
+    this.displayEnabledFeatures(config);
+
+    // End audit session successfully
+    if (enterpriseModules?.auditor) {
+      enterpriseModules.auditor.endDeploymentAudit(deploymentState.deploymentId, 'success', {
+        duration,
+        endpoints: 4,
+        testsRun: config.deployment.runTests,
+        enterpriseFeatures: Object.keys(config.enterprise).filter(k => config.enterprise[k]).length
+      });
+    }
+    this.displayEnterpriseNextSteps();
+  }
+
+  /**
+   * Display deployment statistics
+   * 
+   * @param {Object} deploymentState - Deployment state
+   * @param {Object} config - Configuration
+   * @param {number} duration - Deployment duration in seconds
+   */
+  static displayDeploymentStats(deploymentState, config, duration) {
+    console.log('\n📊 Deployment Statistics:');
+    console.log(`   ⏱️  Duration: ${duration.toFixed(1)} seconds`);
+    console.log(`   🆔 Deployment ID: ${deploymentState.deploymentId}`);
+    console.log(`   🌐 Domain: ${config.domain}`);
+    console.log(`   🌍 Environment: ${config.environment}`);
+    console.log(`   📱 Mode: ${config.deploymentMode}`);
+  }
+
+  /**
+   * Display service endpoints
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayEndpoints(config) {
+    console.log(`\n🌐 Your service is now live at:`);
+    console.log(`   ${config.worker.url}/health`);
+    console.log(`   ${config.worker.url}/auth/magic-link`);
+  }
+
+  /**
+   * Display enterprise endpoints
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayEnterpriseEndpoints(config) {
+    console.log('\n🌐 Enterprise Endpoints:');
+    console.log(`   🏠 Main: ${config.worker.url}`);
+    console.log(`   ❤️  Health: ${config.worker.url}/health`);
+    console.log(`   🔐 Auth: ${config.worker.url}/auth/magic-link`);
+    console.log(`   📊 API: ${config.worker.url}/api`);
+  }
+
+  /**
+   * Display secret distribution files
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayDistributionFiles(config) {
+    console.log(`\n📄 Secret distribution files:`);
+    console.log(`   secrets/distribution/${config.domain}/.env`);
+    console.log(`   secrets/distribution/${config.domain}/secrets.json`);
+    console.log(`   secrets/distribution/${config.domain}/deploy-secrets.sh`);
+  }
+
+  /**
+   * Display generated enterprise files
+   * 
+   * @param {Object} frameworkPaths - Framework paths
+   * @param {Object} config - Configuration
+   * @param {Object} deploymentState - Deployment state
+   */
+  static displayGeneratedFiles(frameworkPaths, config, deploymentState) {
+    console.log('\n📄 Generated Enterprise Files:');
+    console.log(`   📝 Audit Log: ${frameworkPaths.auditLogs}/deployments/session-${deploymentState.deploymentId}.log`);
+    console.log(`   📊 Report: ${frameworkPaths.auditReports}/deployment-${deploymentState.deploymentId}.html`);
+    console.log(`   🔐 Secrets: ${frameworkPaths.secureTokens}/distribution/${config.domain}/`);
+    console.log(`   ⚙️  Config: ${frameworkPaths.configCache}/domains/${config.domain}/`);
+  }
+
+  /**
+   * Display enabled enterprise features
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayEnabledFeatures(config) {
+    console.log('\n🚀 Enterprise Features Enabled:');
+    console.log(`   🔍 Validation: ${config.deployment.validationLevel}`);
+    console.log(`   📋 Audit: ${config.deployment.auditLevel}`);
+    console.log(`   🧪 Testing: ${config.deployment.runTests ? 'Comprehensive' : 'Disabled'}`);
+    console.log(`   🔄 Rollback: ${config.deployment.enableRollback ? 'Available' : 'Disabled'}`);
+    console.log(`   💾 Caching: Smart configuration caching enabled`);
+    console.log(`   🎯 Orchestration: Enterprise orchestration active`);
+  }
+
+  /**
+   * Display next steps
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayNextSteps(config) {
+    console.log('\n🚀 Next steps:');
+    console.log('   1. Test the endpoints above');
+    console.log('   2. Distribute secrets to upstream/downstream applications');
+    console.log('   3. Configure DNS if using custom domain');
+    console.log('   4. Update your applications to use the new service');
+  }
+
+  /**
+   * Display enterprise next steps
+   */
+  static displayEnterpriseNextSteps() {
+    console.log('\n✅ Enterprise deployment completed successfully!');
+    console.log('   Visit the health endpoint to verify deployment');
+    console.log('   Check audit logs for detailed deployment history');
+    console.log('   Use enterprise modules for ongoing management');
+  }
+
+  /**
+   * Display failure summary
+   * 
+   * @param {Error} error - Deployment error
+   * @param {Object} deploymentState - Deployment state
+   * @param {Object} config - Configuration
+   */
+  static displayFailureSummary(error, deploymentState, config) {
+    const duration = (Date.now() - deploymentState.startTime.getTime()) / 1000;
+    console.log('\n❌ DEPLOYMENT FAILED');
+    console.log('===================');
+    console.log(`\n📊 Summary:`);
+    console.log(`   🆔 Deployment ID: ${deploymentState.deploymentId}`);
+    console.log(`   🌐 Domain: ${config.domain}`);
+    console.log(`   ⏱️ Duration: ${duration.toFixed(1)}s`);
+    console.log(`   ❌ Error: ${error.message}`);
+    if (deploymentState.currentPhase) {
+      console.log(`   📍 Failed at: ${deploymentState.currentPhase}`);
+    }
+    console.log('\n🔄 Rollback options:');
+    console.log(`   ${deploymentState.rollbackActions.length} rollback actions available`);
+  }
+
+  /**
+   * Get deployment summary statistics
+   * 
+   * @param {Object} deploymentState - Deployment state
+   * @param {Object} config - Configuration
+   * @returns {Object} Summary statistics
+   */
+  static getSummaryStats(deploymentState, config) {
+    const duration = (Date.now() - deploymentState.startTime.getTime()) / 1000;
+    return {
+      deploymentId: deploymentState.deploymentId,
+      domain: config.domain,
+      environment: config.environment,
+      duration: duration.toFixed(1),
+      secretsDeployed: Object.keys(config.secrets.keys).length,
+      currentPhase: deploymentState.currentPhase,
+      rollbackActionsAvailable: deploymentState.rollbackActions.length
+    };
+  }
+}

package/dist/lib/shared/deployment/workflows/interactive-confirmation.js

@@ -0,0 +1,188 @@
+/**
+ * Interactive Confirmation Module
+ * 
+ * Provides reusable interactive confirmation workflows.
+ * Extracted from enterprise-deployment/master-deploy.js for modularity.
+ * 
+ * @module interactive-confirmation
+ */
+
+import { askYesNo } from '../utils/interactive-prompts.js';
+
+/**
+ * Interactive Confirmation Manager
+ * Handles deployment confirmations and configuration reviews
+ */
+export class InteractiveConfirmation {
+  /**
+   * Display final deployment confirmation
+   * 
+   * @param {Object} config - Deployment configuration
+   * @param {Object} deploymentState - Deployment state
+   * @param {Object} options - Confirmation options
+   * @returns {Promise<boolean>} True if confirmed, throws if cancelled
+   */
+  static async showFinalConfirmation(config, deploymentState, options = {}) {
+    console.log('\n🎯 Final Deployment Confirmation');
+    console.log('===============================');
+    this.displayDeploymentSummary(config, deploymentState);
+    this.displayActionsToPerform(config);
+    const finalConfirm = await askYesNo('\n🚨 PROCEED WITH DEPLOYMENT? This will make changes to your Cloudflare account.', options.defaultAnswer || 'n');
+    if (!finalConfirm) {
+      throw new Error('Deployment cancelled by user');
+    }
+    return true;
+  }
+
+  /**
+   * Display deployment summary
+   * 
+   * @param {Object} config - Configuration
+   * @param {Object} deploymentState - Deployment state
+   */
+  static displayDeploymentSummary(config, deploymentState) {
+    console.log('\n📋 DEPLOYMENT SUMMARY');
+    console.log('=====================');
+    console.log(`🌐 Domain: ${config.domain}`);
+    console.log(`🌍 Environment: ${config.environment}`);
+    console.log(`⚡ Worker: ${config.worker.name}`);
+    console.log(`🔗 URL: ${config.worker.url}`);
+    console.log(`🗄️ Database: ${config.database.name} (${config.database.id})`);
+    console.log(`🔑 Secrets: ${Object.keys(config.secrets.keys).length} configured`);
+    console.log(`🆔 Deployment ID: ${deploymentState.deploymentId}`);
+  }
+
+  /**
+   * Display actions that will be performed
+   * 
+   * @param {Object} config - Configuration
+   */
+  static displayActionsToPerform(config) {
+    console.log('\n🚀 ACTIONS TO PERFORM:');
+    console.log('1. Update wrangler.toml configuration');
+    console.log('2. Run database migrations');
+    console.log('3. Deploy Cloudflare Worker');
+    console.log('4. Verify deployment health');
+    if (config.deployment.runTests) {
+      console.log('5. Run integration tests');
+    }
+  }
+
+  /**
+   * Display and confirm configuration review
+   * 
+   * @param {Object} config - Configuration to review
+   * @param {Object} deploymentState - Deployment state
+   * @param {Function} reconfigureCallback - Callback to reconfigure if rejected
+   * @returns {Promise<boolean>} True if confirmed
+   */
+  static async showConfigurationReview(config, deploymentState, reconfigureCallback) {
+    console.log('\n🔍 Configuration Review');
+    console.log('======================');
+    console.log('\nPlease review your configuration:');
+    console.log(`   🌐 Domain: ${config.domain}`);
+    console.log(`   🌍 Environment: ${config.environment}`);
+    console.log(`   ⚡ Worker: ${config.worker.name}`);
+    console.log(`   🔗 URL: ${config.worker.url}`);
+    console.log(`   🆔 Deployment ID: ${deploymentState.deploymentId}`);
+    const confirmed = await askYesNo('\nIs this configuration correct?', 'y');
+    if (!confirmed) {
+      if (reconfigureCallback && typeof reconfigureCallback === 'function') {
+        console.log('\n🔄 Let\'s reconfigure...');
+        await reconfigureCallback();
+        return this.showConfigurationReview(config, deploymentState, reconfigureCallback);
+      } else {
+        throw new Error('Configuration rejected by user');
+      }
+    }
+    return true;
+  }
+
+  /**
+   * Show enterprise final confirmation with additional details
+   * 
+   * @param {Object} config - Deployment configuration
+   * @param {Object} deploymentState - Deployment state
+   * @param {Object} enterpriseModules - Enterprise modules
+   * @returns {Promise<boolean>} True if confirmed
+   */
+  static async showEnterpriseFinalConfirmation(config, deploymentState, enterpriseModules) {
+    console.log('\n🎯 Enterprise Final Confirmation');
+    console.log('================================');
+    this.displayEnterpriseDeploymentSummary(config, deploymentState);
+    this.displayEnterpriseActionsToPerform(config, enterpriseModules);
+    const finalConfirm = await askYesNo('\n🚨 PROCEED WITH ENTERPRISE DEPLOYMENT?', 'n');
+    if (!finalConfirm) {
+      throw new Error('Enterprise deployment cancelled by user');
+    }
+    return true;
+  }
+
+  /**
+   * Display enterprise deployment summary
+   * 
+   * @param {Object} config - Configuration
+   * @param {Object} deploymentState - Deployment state
+   */
+  static displayEnterpriseDeploymentSummary(config, deploymentState) {
+    console.log('\n📋 ENTERPRISE DEPLOYMENT SUMMARY');
+    console.log('================================');
+    console.log(`🌐 Domain: ${config.domain}`);
+    console.log(`🌍 Environment: ${config.environment}`);
+    console.log(`📱 Mode: ${config.deploymentMode}`);
+    console.log(`⚡ Worker: ${config.worker.name}`);
+    console.log(`🔗 URL: ${config.worker.url}`);
+    console.log(`🗄️ Database: ${config.database.name} (${config.database.id})`);
+    console.log(`🔑 Secrets: ${Object.keys(config.secrets.keys).length} configured`);
+    console.log(`🆔 Deployment ID: ${deploymentState.deploymentId}`);
+    console.log(`🔍 Validation: ${config.deployment.validationLevel}`);
+    console.log(`📋 Audit: ${config.deployment.auditLevel}`);
+  }
+
+  /**
+   * Display enterprise actions
+   * 
+   * @param {Object} config - Configuration
+   * @param {Object} enterpriseModules - Enterprise modules
+   */
+  static displayEnterpriseActionsToPerform(config, enterpriseModules) {
+    console.log('\n🚀 ENTERPRISE ACTIONS TO PERFORM:');
+    console.log('1. Comprehensive validation');
+    console.log('2. Database orchestration');
+    console.log('3. Enterprise secret management');
+    console.log('4. Configuration management');
+    console.log('5. Cloudflare Worker deployment with D1 recovery');
+    console.log('6. Deployment verification');
+    if (config.deployment.runTests) {
+      console.log('7. Comprehensive integration tests');
+    }
+    console.log(`8. Audit logging and reporting`);
+  }
+
+  /**
+   * Quick yes/no confirmation
+   * 
+   * @param {string} message - Confirmation message
+   * @param {string} defaultAnswer - Default answer ('y' or 'n')
+   * @returns {Promise<boolean>} Confirmation result
+   */
+  static async quickConfirm(message, defaultAnswer = 'y') {
+    return await askYesNo(message, defaultAnswer);
+  }
+
+  /**
+   * Confirm dangerous action with warning
+   * 
+   * @param {string} action - Action description
+   * @param {string} warning - Warning message
+   * @returns {Promise<boolean>} Confirmation result
+   */
+  static async confirmDangerousAction(action, warning) {
+    console.log(`\n⚠️  WARNING: ${warning}`);
+    const confirm = await askYesNo(`Are you sure you want to ${action}?`, 'n');
+    if (!confirm) {
+      throw new Error(`Dangerous action cancelled: ${action}`);
+    }
+    return true;
+  }
+}

package/dist/lib/shared/deployment/workflows/interactive-database-workflow.js

@@ -0,0 +1,234 @@
+/**
+ * Interactive Database Workflow Module
+ * 
+ * Provides reusable interactive database creation and configuration workflows.
+ * Extracted from enterprise-deployment/master-deploy.js for modularity.
+ * 
+ * @module interactive-database-workflow
+ */
+
+import { askUser, askYesNo, askChoice } from '../utils/interactive-prompts.js';
+import { databaseExists, createDatabase, deleteDatabase } from '../../cloudflare/ops.js';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+
+/**
+ * Interactive Database Workflow
+ * Handles database naming, existence checking, and creation with user interaction
+ */
+export class InteractiveDatabaseWorkflow {
+  /**
+   * @param {Object} options - Configuration options
+   * @param {Array} options.rollbackActions - Array to track rollback actions
+   */
+  constructor(options = {}) {
+    this.rollbackActions = options.rollbackActions || [];
+  }
+
+  /**
+   * Handle complete database setup workflow
+   * 
+   * @param {string} domain - Domain name for database
+   * @param {string} environment - Deployment environment
+   * @param {Object} options - Additional options
+   * @param {string} [options.suggestedName] - Suggested database name
+   * @param {boolean} [options.interactive=true] - Enable interactive prompts
+   * @returns {Promise<Object>} Database configuration { name, id, created, reused }
+   */
+  async handleDatabaseSetup(domain, environment, options = {}) {
+    console.log('\n🗄️ Database Configuration');
+    console.log('=========================');
+
+    // Generate default database name
+    const suggestedName = options.suggestedName || `${domain}-auth-db`;
+
+    // Get final database name
+    const databaseName = await this.promptForDatabaseName(suggestedName, options.interactive);
+
+    // Check if database exists
+    const existingInfo = await this.checkExistingDatabase(databaseName);
+    if (existingInfo.exists) {
+      return await this.handleExistingDatabase(databaseName, existingInfo, options.interactive);
+    } else {
+      return await this.createNewDatabase(databaseName, options.interactive);
+    }
+  }
+
+  /**
+   * Prompt user for database name
+   * 
+   * @param {string} suggested - Suggested database name
+   * @param {boolean} interactive - Enable interactive prompts
+   * @returns {Promise<string>} Final database name
+   */
+  async promptForDatabaseName(suggested, interactive = true) {
+    console.log(`\n📋 Generated database name: ${suggested}`);
+    if (!interactive) {
+      return suggested;
+    }
+    const useGeneratedName = await askYesNo('Use this database name?', 'y');
+    if (!useGeneratedName) {
+      return await askUser('Enter custom database name', suggested);
+    }
+    return suggested;
+  }
+
+  /**
+   * Check if database exists and get its details
+   * 
+   * @param {string} name - Database name
+   * @returns {Promise<Object>} { exists: boolean, id?: string, error?: string }
+   */
+  async checkExistingDatabase(name) {
+    console.log('\n🔍 Checking for existing database...');
+    try {
+      const exists = await databaseExists(name);
+      if (exists) {
+        console.log(`   📋 Database '${name}' already exists`);
+
+        // Extract database ID from the list command
+        try {
+          const dbListResult = await execAsync('npx wrangler d1 list');
+          const lines = dbListResult.stdout.split('\n');
+          for (const line of lines) {
+            if (line.includes(name)) {
+              const match = line.match(/([a-f0-9-]{36})/);
+              if (match) {
+                return {
+                  exists: true,
+                  id: match[1]
+                };
+              }
+            }
+          }
+        } catch (error) {
+          console.log('   ⚠️ Could not extract database ID');
+        }
+        return {
+          exists: true
+        };
+      } else {
+        console.log(`   ✅ Database '${name}' does not exist`);
+        return {
+          exists: false
+        };
+      }
+    } catch (error) {
+      console.log('   ⚠️ Could not check existing databases');
+      return {
+        exists: false,
+        error: error.message
+      };
+    }
+  }
+
+  /**
+   * Handle workflow for existing database
+   * 
+   * @param {string} name - Database name
+   * @param {Object} existingInfo - Information about existing database
+   * @param {boolean} interactive - Enable interactive prompts
+   * @returns {Promise<Object>} Database configuration
+   */
+  async handleExistingDatabase(name, existingInfo, interactive = true) {
+    if (!interactive) {
+      // Non-interactive mode: reuse existing
+      console.log(`   ✅ Using existing database: ${name}`);
+      return {
+        name,
+        id: existingInfo.id,
+        created: false,
+        reused: true
+      };
+    }
+    const databaseChoice = await askChoice('What would you like to do with the existing database?', ['Use the existing database (recommended)', 'Create a new database with different name', 'Delete existing and create new (DANGER: DATA LOSS)'], 0);
+    switch (databaseChoice) {
+      case 0:
+        {
+          // Use existing database
+          if (existingInfo.id) {
+            console.log(`   ✅ Using existing database ID: ${existingInfo.id}`);
+          }
+          return {
+            name,
+            id: existingInfo.id,
+            created: false,
+            reused: true
+          };
+        }
+      case 1:
+        {
+          // Create new database with different name
+          const newName = await askUser('Enter new database name');
+          return await this.createNewDatabase(newName, interactive);
+        }
+      case 2:
+        {
+          // Delete and recreate
+          const confirmDelete = await askYesNo('⚠️ ARE YOU SURE? This will DELETE all data in the existing database!', 'n');
+          if (!confirmDelete) {
+            throw new Error('Database deletion cancelled');
+          }
+          console.log(`\n🗑️ Deleting existing database...`);
+          await deleteDatabase(name);
+          return await this.createNewDatabase(name, interactive);
+        }
+      default:
+        throw new Error('Invalid database choice');
+    }
+  }
+
+  /**
+   * Create a new database
+   * 
+   * @param {string} name - Database name
+   * @param {boolean} interactive - Enable interactive prompts
+   * @returns {Promise<Object>} Database configuration
+   */
+  async createNewDatabase(name, interactive = true) {
+    console.log(`\n🆕 Creating new database: ${name}`);
+    if (interactive) {
+      const confirmCreate = await askYesNo('Proceed with database creation?', 'y');
+      if (!confirmCreate) {
+        throw new Error('Database creation cancelled');
+      }
+    }
+    try {
+      const databaseId = await createDatabase(name);
+      console.log(`   ✅ Database created with ID: ${databaseId}`);
+
+      // Add to rollback actions
+      this.rollbackActions.push({
+        type: 'delete-database',
+        name: name,
+        command: `npx wrangler d1 delete ${name} --skip-confirmation`,
+        description: `Delete database '${name}' created during deployment`
+      });
+      return {
+        name,
+        id: databaseId,
+        created: true,
+        reused: false
+      };
+    } catch (error) {
+      throw new Error(`Database creation failed: ${error.message}`);
+    }
+  }
+
+  /**
+   * Get database configuration summary
+   * 
+   * @param {Object} dbConfig - Database configuration
+   * @returns {string} Summary message
+   */
+  getSummary(dbConfig) {
+    if (dbConfig.created) {
+      return `✅ Database configured: ${dbConfig.name} (${dbConfig.id}) - CREATED`;
+    } else if (dbConfig.reused) {
+      return `✅ Database configured: ${dbConfig.name} (${dbConfig.id}) - REUSED`;
+    } else {
+      return `✅ Database configured: ${dbConfig.name} (${dbConfig.id})`;
+    }
+  }
+}