@tamyla/clodo-framework 1.0.0

package/dist/shared/config/command-config-manager.js

@@ -0,0 +1,174 @@
+/**
+ * Command Configuration Manager
+ * Loads and manages configurable system commands from validation-config.json
+ * 
+ * Ensures all commands are configurable and platform-specific
+ * No hardcoded commands in the codebase
+ */
+
+import { readFileSync } from 'fs';
+import { join } from 'path';
+export class CommandConfigManager {
+  constructor(configPath = null) {
+    this.configPath = configPath || join(process.cwd(), 'validation-config.json');
+    this.config = null;
+    this.loadConfig();
+  }
+
+  /**
+   * Load configuration from JSON file
+   */
+  loadConfig() {
+    try {
+      const configData = readFileSync(this.configPath, 'utf-8');
+      this.config = JSON.parse(configData);
+      console.log('📋 Loaded command configuration from validation-config.json');
+    } catch (error) {
+      console.log('⚠️ Could not load command config, using defaults');
+      this.config = this.getDefaultConfig();
+    }
+  }
+
+  /**
+   * Get default configuration fallback
+   */
+  getDefaultConfig() {
+    return {
+      requiredCommands: {
+        npx: 'npx',
+        node: 'node',
+        npm: 'npm',
+        wrangler: 'npx wrangler'
+      },
+      cloudflareCommands: {
+        whoami: 'npx wrangler whoami',
+        auth_login: 'npx wrangler auth login',
+        deployments_list: 'npx wrangler deployments list',
+        list_workers: 'npx wrangler dev --help',
+        deploy: 'npx wrangler deploy',
+        list_zones: 'npx wrangler zone list',
+        worker_status: 'npx wrangler status'
+      },
+      systemCommands: {
+        powershell_web_request: 'powershell -Command "try { Invoke-WebRequest -Uri \'{url}\' -TimeoutSec 10 -UseBasicParsing | Out-Null } catch { exit 1 }"',
+        curl_test: 'curl -s --connect-timeout 10 {url} -o /dev/null'
+      }
+    };
+  }
+
+  /**
+   * Get a Cloudflare command
+   */
+  getCloudflareCommand(commandName, params = {}) {
+    const command = this.config?.cloudflareCommands?.[commandName];
+    if (!command) {
+      throw new Error(`Cloudflare command '${commandName}' not found in configuration`);
+    }
+    return this.interpolateParams(command, params);
+  }
+
+  /**
+   * Get a system command
+   */
+  getSystemCommand(commandName, params = {}) {
+    const command = this.config?.systemCommands?.[commandName];
+    if (!command) {
+      throw new Error(`System command '${commandName}' not found in configuration`);
+    }
+    return this.interpolateParams(command, params);
+  }
+
+  /**
+   * Get a required command
+   */
+  getRequiredCommand(commandName) {
+    const command = this.config?.requiredCommands?.[commandName];
+    if (!command) {
+      throw new Error(`Required command '${commandName}' not found in configuration`);
+    }
+    return command;
+  }
+
+  /**
+   * Get network test command for current platform
+   */
+  getNetworkTestCommand(url) {
+    const isWindows = process.platform === 'win32';
+    const commandName = isWindows ? 'powershell_web_request' : 'curl_test';
+    return this.getSystemCommand(commandName, {
+      url
+    });
+  }
+
+  /**
+   * Interpolate parameters in command strings
+   */
+  interpolateParams(command, params) {
+    let result = command;
+    for (const [key, value] of Object.entries(params)) {
+      const placeholder = `{${key}}`;
+      result = result.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'g'), value);
+    }
+    return result;
+  }
+
+  /**
+   * Get all available commands for debugging
+   */
+  getAllCommands() {
+    return {
+      requiredCommands: this.config?.requiredCommands || {},
+      cloudflareCommands: this.config?.cloudflareCommands || {},
+      systemCommands: this.config?.systemCommands || {}
+    };
+  }
+
+  /**
+   * Validate command configuration
+   */
+  validateConfig() {
+    const errors = [];
+
+    // Check required sections
+    const requiredSections = ['requiredCommands', 'cloudflareCommands', 'systemCommands'];
+    for (const section of requiredSections) {
+      if (!this.config[section] || typeof this.config[section] !== 'object') {
+        errors.push(`Missing or invalid section: ${section}`);
+      }
+    }
+
+    // Check essential Cloudflare commands
+    const essentialCfCommands = ['whoami', 'auth_login', 'deployments_list'];
+    for (const cmd of essentialCfCommands) {
+      if (!this.config?.cloudflareCommands?.[cmd]) {
+        errors.push(`Missing essential Cloudflare command: ${cmd}`);
+      }
+    }
+    if (errors.length > 0) {
+      throw new Error(`Command configuration validation failed:\\n${errors.join('\\n')}`);
+    }
+    return true;
+  }
+
+  /**
+   * Reload configuration
+   */
+  reload() {
+    this.loadConfig();
+    this.validateConfig();
+  }
+}
+
+// Singleton instance
+let commandConfigInstance = null;
+
+/**
+ * Get singleton instance of command config manager
+ */
+export function getCommandConfig(configPath = null) {
+  if (!commandConfigInstance || configPath) {
+    commandConfigInstance = new CommandConfigManager(configPath);
+  }
+  return commandConfigInstance;
+}
+export default CommandConfigManager;

package/dist/shared/config/customer-cli.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+
+/**
+ * Customer Configuration Management CLI
+ * Manages multi-environment, multi-customer configuration structure
+ * Integrates with Clodo Framework domain and feature flag systems
+ */
+import { CustomerConfigCLI } from '../../../src/config/CustomerConfigCLI.js';
+const command = process.argv[2];
+const args = process.argv.slice(3);
+async function main() {
+  const cli = new CustomerConfigCLI();
+  await cli.initialize();
+  try {
+    switch (command) {
+      case 'create-customer':
+        const [customerName, domain] = args;
+        const result = await cli.createCustomer(customerName, domain);
+        if (result.success) {
+          console.log(`\n🎉 Customer ${customerName} configuration created successfully!`);
+          console.log(`\n📋 Customer Details:`);
+          console.log(`   Name: ${result.customer.name}`);
+          console.log(`   Domain: ${result.customer.domain || 'Not specified'}`);
+          console.log(`   Config Path: ${result.customer.configPath}`);
+          console.log(`   Environments: ${result.customer.environments.join(', ')}`);
+          console.log(`\n📋 Next steps:`);
+          console.log(`1. Review generated configs in: config/customers/${customerName}/`);
+          console.log(`2. Update domain-specific URLs if needed`);
+          console.log(`3. Generate production secrets: npm run security:generate-key ${customerName}`);
+          console.log(`4. Set production secrets: wrangler secret put KEY_NAME --env production`);
+        } else {
+          console.error(`❌ Failed to create customer: ${result.error}`);
+          process.exit(1);
+        }
+        break;
+      case 'validate':
+        const validateResult = await cli.validateConfigurations();
+        if (validateResult.valid) {
+          console.log('✅ All customer configurations are valid');
+        } else {
+          console.log('❌ Configuration validation failed');
+          validateResult.errors.forEach(error => console.log(`   - ${error}`));
+          process.exit(1);
+        }
+        break;
+      case 'show':
+        const [customerNameShow, environment] = args;
+        const showResult = cli.showConfiguration(customerNameShow, environment);
+        if (showResult.success) {
+          console.log(`🔍 Effective configuration: ${customerNameShow}/${environment}\n`);
+          if (showResult.config.variables?.base) {
+            console.log('📋 Base variables:');
+            Object.entries(showResult.config.variables.base).slice(0, 10).forEach(([key, value]) => {
+              console.log(`   ${key}=${value}`);
+            });
+            if (Object.keys(showResult.config.variables.base).length > 10) {
+              console.log('   ...');
+            }
+            console.log('');
+          }
+          if (showResult.config.variables?.customer) {
+            console.log(`📋 Customer ${environment} variables:`);
+            Object.entries(showResult.config.variables.customer).slice(0, 15).forEach(([key, value]) => {
+              console.log(`   ${key}=${value}`);
+            });
+            if (Object.keys(showResult.config.variables.customer).length > 15) {
+              console.log('   ...');
+            }
+            console.log('');
+          }
+          if (showResult.config.features && Object.keys(showResult.config.features).length > 0) {
+            console.log('🚩 Customer features:');
+            Object.entries(showResult.config.features).forEach(([feature, enabled]) => {
+              console.log(`   ${feature}: ${enabled ? '✅' : '❌'}`);
+            });
+          }
+        } else {
+          console.error(`❌ Failed to show configuration: ${showResult.error}`);
+          process.exit(1);
+        }
+        break;
+      case 'deploy-command':
+        const [customerNameDeploy, environmentDeploy] = args;
+        const deployResult = cli.getDeployCommand(customerNameDeploy, environmentDeploy);
+        if (deployResult.success) {
+          console.log(`📋 Deploy command for ${customerNameDeploy}/${environmentDeploy}:`);
+          console.log(`   ${deployResult.command}`);
+          console.log(`\n💡 Ensure customer config is loaded: ${deployResult.configPath}`);
+        } else {
+          console.error(`❌ Failed to get deploy command: ${deployResult.error}`);
+          process.exit(1);
+        }
+        break;
+      case 'list':
+        const listResult = cli.listCustomers();
+        if (listResult.success && listResult.customers.length > 0) {
+          console.log('📋 Configured customers:\n');
+          listResult.customers.forEach(customer => {
+            console.log(`🏢 ${customer.name}`);
+            console.log(`   Domain: ${customer.domain || 'Not specified'}`);
+            console.log(`   Environments: ${customer.environments.join(', ')}`);
+            console.log(`   Created: ${customer.createdAt}`);
+            console.log(`   Config: config/customers/${customer.name}/`);
+            console.log('');
+          });
+        } else if (listResult.success) {
+          console.log('📋 No customers configured');
+        } else {
+          console.error(`❌ Failed to list customers: ${listResult.error}`);
+          process.exit(1);
+        }
+        break;
+      default:
+        console.log('Customer Configuration Management Tool\n');
+        console.log('Available commands:');
+        console.log('  create-customer <name> [domain]  - Create new customer config from template');
+        console.log('  validate                         - Validate configuration structure');
+        console.log('  show <customer> <environment>    - Show effective configuration');
+        console.log('  deploy-command <customer> <env>  - Get deployment command');
+        console.log('  list                             - List all configured customers');
+        console.log('\nExamples:');
+        console.log('  clodo-customer-config create-customer acmecorp acmecorp.com');
+        console.log('  clodo-customer-config validate');
+        console.log('  clodo-customer-config show acmecorp production');
+        console.log('  clodo-customer-config list');
+        console.log('\nIntegration:');
+        console.log('  This tool integrates with Clodo Framework domain and feature flag systems.');
+        console.log('  Customer configurations are automatically registered as domains.');
+        break;
+    }
+  } catch (error) {
+    console.error(`❌ Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+main().catch(error => {
+  console.error(`❌ Unexpected error: ${error.message}`);
+  process.exit(1);
+});
+async function handleCreateCustomer(args) {
+  const [customerName, domain] = args;
+  if (!customerName) {
+    console.error('Usage: customer-config create-customer <customer-name> [domain]');
+    process.exit(1);
+  }
+  console.log(`🏗️ Creating customer configuration: ${customerName}`);
+
+  // Pass framework mode flag to skip strict validation
+  const customerInfo = await customerManager.createCustomer(customerName, domain, {
+    skipValidation: true,
+    isFrameworkMode: true
+  });
+  console.log(`\n🎉 Customer ${customerName} configuration created successfully!`);
+  console.log(`\n📋 Customer Details:`);
+  console.log(`   Name: ${customerInfo.name}`);
+  console.log(`   Domain: ${customerInfo.domain || 'Not specified'}`);
+  console.log(`   Config Path: ${customerInfo.configPath}`);
+  console.log(`   Environments: ${customerInfo.environments.join(', ')}`);
+  console.log(`\n📋 Next steps:`);
+  console.log(`1. Review generated configs in: config/customers/${customerName}/`);
+  console.log(`2. Update domain-specific URLs if needed`);
+  console.log(`3. Generate production secrets: npm run security:generate-key ${customerName}`);
+  console.log(`4. Set production secrets: wrangler secret put KEY_NAME --env production`);
+}
+async function handleValidate() {
+  console.log('🔍 Validating customer configuration structure...\n');
+  const result = await customerManager.validateConfigs();
+  if (result.valid) {
+    console.log('✅ All customer configurations are valid');
+  } else {
+    console.log('❌ Configuration validation failed');
+    result.errors.forEach(error => console.log(`   - ${error}`));
+    process.exit(1);
+  }
+}
+async function handleShow(args) {
+  const [customerName, environment] = args;
+  if (!customerName || !environment) {
+    console.error('Usage: customer-config show <customer> <environment>');
+    process.exit(1);
+  }
+  const config = customerManager.showConfig(customerName, environment);
+  console.log(`🔍 Effective configuration: ${customerName}/${environment}\n`);
+  if (config.variables.base) {
+    console.log('📋 Base variables:');
+    Object.entries(config.variables.base).slice(0, 10).forEach(([key, value]) => {
+      console.log(`   ${key}=${value}`);
+    });
+    if (Object.keys(config.variables.base).length > 10) {
+      console.log('   ...');
+    }
+    console.log('');
+  }
+  if (config.variables.customer) {
+    console.log(`📋 Customer ${environment} variables:`);
+    Object.entries(config.variables.customer).slice(0, 15).forEach(([key, value]) => {
+      console.log(`   ${key}=${value}`);
+    });
+    if (Object.keys(config.variables.customer).length > 15) {
+      console.log('   ...');
+    }
+    console.log('');
+  }
+  if (config.features && Object.keys(config.features).length > 0) {
+    console.log('🚩 Customer features:');
+    Object.entries(config.features).forEach(([feature, enabled]) => {
+      console.log(`   ${feature}: ${enabled ? '✅' : '❌'}`);
+    });
+  }
+}
+async function handleDeployCommand(args) {
+  const [customerName, environment] = args;
+  if (!customerName || !environment) {
+    console.error('Usage: customer-config deploy-command <customer> <environment>');
+    process.exit(1);
+  }
+  const deployInfo = customerManager.getDeployCommand(customerName, environment);
+  console.log(`📋 Deploy command for ${customerName}/${environment}:`);
+  console.log(`   ${deployInfo.command}`);
+  console.log(`\n💡 Ensure customer config is loaded: ${deployInfo.configPath}`);
+}
+async function handleList() {
+  const customers = customerManager.listCustomers();
+  if (customers.length === 0) {
+    console.log('📋 No customers configured');
+    return;
+  }
+  console.log('📋 Configured customers:\n');
+  customers.forEach(customer => {
+    console.log(`🏢 ${customer.name}`);
+    console.log(`   Domain: ${customer.domain || 'Not specified'}`);
+    console.log(`   Environments: ${customer.environments.join(', ')}`);
+    console.log(`   Created: ${customer.createdAt}`);
+    console.log(`   Config: config/customers/${customer.name}/`);
+    console.log('');
+  });
+}
+function showHelp() {
+  console.log('Customer Configuration Management Tool\n');
+  console.log('Available commands:');
+  console.log('  create-customer <name> [domain]  - Create new customer config from template');
+  console.log('  validate                         - Validate configuration structure');
+  console.log('  show <customer> <environment>    - Show effective configuration');
+  console.log('  deploy-command <customer> <env>  - Get deployment command');
+  console.log('  list                             - List all configured customers');
+  console.log('\nExamples:');
+  console.log('  customer-config create-customer acmecorp acmecorp.com');
+  console.log('  customer-config validate');
+  console.log('  customer-config show acmecorp production');
+  console.log('  customer-config list');
+  console.log('\nIntegration:');
+  console.log('  This tool integrates with Clodo Framework domain and feature flag systems.');
+  console.log('  Customer configurations are automatically registered as domains.');
+}
+main().catch(error => {
+  console.error(`❌ Unexpected error: ${error.message}`);
+  process.exit(1);
+});

package/dist/shared/config/index.js

@@ -0,0 +1,9 @@
+/**
+ * Configuration Module
+ * Exports all configuration management utilities
+ */
+
+export { ConfigCache } from './cache.js';
+export { ConfigManager } from './manager.js';
+export { CommandConfigManager } from './command-config-manager.js';
+export { CustomerConfigurationManager } from '../../../src/config/customers.js';