@tamyla/clodo-framework 3.1.21 → 3.1.22

package/dist/service-management/generators/scripts/DeployScriptGenerator.js

@@ -1,123 +0,0 @@
-import { BaseGenerator } from '../BaseGenerator.js';
-import { join } from 'path';
-
-/**
- * DeployScriptGenerator
- * 
- * Generates scripts/deploy.ps1 PowerShell deployment script.
- */
-export class DeployScriptGenerator extends BaseGenerator {
-  constructor(options = {}) {
-    super({
-      name: 'DeployScriptGenerator',
-      description: 'Generates PowerShell deployment script',
-      outputPath: 'scripts/deploy.ps1',
-      ...options
-    });
-  }
-  shouldGenerate(context) {
-    return true;
-  }
-  async generate(context) {
-    const coreInputs = context.coreInputs || context;
-    const confirmedValues = context.confirmedValues || context;
-    const servicePath = context.servicePath || context.outputDir;
-    this.setContext({
-      coreInputs,
-      confirmedValues,
-      servicePath
-    });
-    const content = `#!/usr/bin/env pwsh
-
-<#
-.SYNOPSIS
-    Deploy ${confirmedValues.displayName} to Cloudflare
-
-.DESCRIPTION
-    Automated deployment script for ${confirmedValues.displayName}
-    Handles database setup, worker deployment, and environment configuration
-
-.PARAMETER Environment
-    Target environment (development, staging, production)
-
-.PARAMETER SkipTests
-    Skip running tests before deployment
-
-.EXAMPLE
-    .\\scripts\\deploy.ps1 -Environment production
-
-.EXAMPLE
-    .\\scripts\\deploy.ps1 -Environment staging -SkipTests
-#>
-
-param(
-    [Parameter(Mandatory = $false)]
-    [ValidateSet('development', 'staging', 'production')]
-    [string]$Environment = 'development',
-
-    [Parameter(Mandatory = $false)]
-    [switch]$SkipTests
-)
-
-Write-Host "🚀 Deploying ${confirmedValues.displayName} to $Environment" -ForegroundColor Cyan
-
-# Load environment variables
-if (Test-Path ".env") {
-    Write-Host "📄 Loading environment variables from .env" -ForegroundColor Gray
-    Get-Content ".env" | ForEach-Object {
-        if ($_ -match '^([^=]+)=(.*)$') {
-            $key = $matches[1]
-            $value = $matches[2]
-            [Environment]::SetEnvironmentVariable($key, $value)
-        }
-    }
-}
-
-try {
-    # Run tests unless skipped
-    if (-not $SkipTests) {
-        Write-Host "🧪 Running tests..." -ForegroundColor Yellow
-        npm test
-        if ($LASTEXITCODE -ne 0) {
-            throw "Tests failed. Aborting deployment."
-        }
-    }
-
-    # Lint code
-    Write-Host "🔍 Running linter..." -ForegroundColor Yellow
-    npm run lint
-    if ($LASTEXITCODE -ne 0) {
-        throw "Linting failed. Aborting deployment."
-    }
-
-    # Deploy to Cloudflare
-    Write-Host "☁️  Deploying to Cloudflare Workers..." -ForegroundColor Yellow
-    npx wrangler deploy --env $Environment
-
-    if ($LASTEXITCODE -ne 0) {
-        throw "Cloudflare deployment failed."
-    }
-
-    # Run health check
-    Write-Host "🏥 Running health check..." -ForegroundColor Yellow
-    .\\scripts\\health-check.ps1 -Environment $Environment
-
-    Write-Host "✅ Deployment completed successfully!" -ForegroundColor Green
-    Write-Host "🌐 Service URL: ${confirmedValues.productionUrl}" -ForegroundColor Cyan
-
-} catch {
-    Write-Host "❌ Deployment failed: $_" -ForegroundColor Red
-    exit 1
-}
-`;
-    await this.writeFile(join('scripts', 'deploy.ps1'), content);
-    return join(servicePath, 'scripts', 'deploy.ps1');
-  }
-  validateContext(context) {
-    const confirmedValues = context.confirmedValues || context;
-    if (!confirmedValues.displayName || !confirmedValues.productionUrl) {
-      throw new Error('DeployScriptGenerator: Missing required fields');
-    }
-    return true;
-  }
-}

package/dist/service-management/generators/scripts/HealthCheckScriptGenerator.js

@@ -1,101 +0,0 @@
-import { BaseGenerator } from '../BaseGenerator.js';
-import { join } from 'path';
-export class HealthCheckScriptGenerator extends BaseGenerator {
-  constructor(options = {}) {
-    super({
-      name: 'HealthCheckScriptGenerator',
-      description: 'Generates PowerShell health check script',
-      outputPath: 'scripts/health-check.ps1',
-      ...options
-    });
-  }
-  shouldGenerate(context) {
-    return true;
-  }
-  async generate(context) {
-    const coreInputs = context.coreInputs || context;
-    const confirmedValues = context.confirmedValues || context;
-    const servicePath = context.servicePath || context.outputDir;
-    this.setContext({
-      coreInputs,
-      confirmedValues,
-      servicePath
-    });
-    const content = `#!/usr/bin/env pwsh
-
-<#
-.SYNOPSIS
-    Health check for ${confirmedValues.displayName}
-
-.DESCRIPTION
-    Performs health checks on ${confirmedValues.displayName} service
-    Tests endpoints, database connectivity, and overall service health
-
-.PARAMETER Environment
-    Target environment to check (development, staging, production)
-
-.EXAMPLE
-    .\\scripts\\health-check.ps1 -Environment production
-#>
-
-param(
-    [Parameter(Mandatory = $false)]
-    [ValidateSet('development', 'staging', 'production')]
-    [string]$Environment = 'development'
-)
-
-Write-Host "🏥 Running health checks for ${confirmedValues.displayName} ($Environment)" -ForegroundColor Cyan
-
-# Determine service URL based on environment
-$serviceUrl = switch ($Environment) {
-    'production' { "${confirmedValues.productionUrl}" }
-    'staging' { "${confirmedValues.stagingUrl}" }
-    'development' { "${confirmedValues.developmentUrl}" }
-}
-
-Write-Host "🌐 Checking service at: $serviceUrl" -ForegroundColor Gray
-
-try {
-    # Health check endpoint
-    $healthUrl = "$serviceUrl${confirmedValues.healthCheckPath}"
-    Write-Host "🔍 Testing health endpoint: $healthUrl" -ForegroundColor Yellow
-
-    $response = Invoke-RestMethod -Uri $healthUrl -Method GET -TimeoutSec 30
-    if ($response.status -eq 'healthy') {
-        Write-Host "✅ Health check passed" -ForegroundColor Green
-    } else {
-        Write-Host "❌ Health check failed: $($response | ConvertTo-Json)" -ForegroundColor Red
-        exit 1
-    }
-
-    # API endpoint check
-    $apiUrl = "$serviceUrl${confirmedValues.apiBasePath}"
-    Write-Host "🔍 Testing API endpoint: $apiUrl" -ForegroundColor Yellow
-
-    try {
-        $apiResponse = Invoke-WebRequest -Uri $apiUrl -Method GET -TimeoutSec 30
-        Write-Host "✅ API endpoint accessible (Status: $($apiResponse.StatusCode))" -ForegroundColor Green
-    } catch {
-        Write-Host "⚠️  API endpoint returned error (may be expected): $($_.Exception.Message)" -ForegroundColor Yellow
-    }
-
-    Write-Host "✅ All health checks completed successfully!" -ForegroundColor Green
-
-} catch {
-    Write-Host "❌ Health check failed: $_" -ForegroundColor Red
-    exit 1
-}
-`;
-    await this.writeFile(join('scripts', 'health-check.ps1'), content);
-    return join(servicePath, 'scripts', 'health-check.ps1');
-  }
-  validateContext(context) {
-    const confirmedValues = context.confirmedValues || context;
-    const required = ['displayName', 'productionUrl', 'stagingUrl', 'developmentUrl', 'healthCheckPath', 'apiBasePath'];
-    const missing = required.filter(field => !confirmedValues[field]);
-    if (missing.length > 0) {
-      throw new Error(`HealthCheckScriptGenerator: Missing fields: ${missing.join(', ')}`);
-    }
-    return true;
-  }
-}

package/dist/service-management/generators/scripts/SetupScriptGenerator.js

@@ -1,88 +0,0 @@
-import { BaseGenerator } from '../BaseGenerator.js';
-import { join } from 'path';
-export class SetupScriptGenerator extends BaseGenerator {
-  constructor(options = {}) {
-    super({
-      name: 'SetupScriptGenerator',
-      description: 'Generates PowerShell setup script',
-      outputPath: 'scripts/setup.ps1',
-      ...options
-    });
-  }
-  shouldGenerate(context) {
-    return true;
-  }
-  async generate(context) {
-    const coreInputs = context.coreInputs || context;
-    const confirmedValues = context.confirmedValues || context;
-    const servicePath = context.servicePath || context.outputDir;
-    this.setContext({
-      coreInputs,
-      confirmedValues,
-      servicePath
-    });
-    const databaseSetup = confirmedValues.features && confirmedValues.features.database ? `
-    Write-Host "🗄️  Setting up database..." -ForegroundColor Yellow
-    # Database setup would go here
-    Write-Host "⚠️  Database setup requires manual configuration" -ForegroundColor Yellow
-    ` : `
-    Write-Host "ℹ️  Database not required for this service type" -ForegroundColor Gray
-    `;
-    const content = `#!/usr/bin/env pwsh
-
-<#
-.SYNOPSIS
-    Setup ${confirmedValues.displayName} environment
-
-.DESCRIPTION
-    Initializes the development environment for ${confirmedValues.displayName}
-    Sets up database, configures environment variables, and prepares for development
-
-.EXAMPLE
-    .\\scripts\\setup.ps1
-#>
-
-Write-Host "🔧 Setting up ${confirmedValues.displayName} development environment" -ForegroundColor Cyan
-
-try {
-    # Check if .env exists
-    if (-not (Test-Path ".env")) {
-        Write-Host "📄 Creating .env file from template..." -ForegroundColor Yellow
-        Copy-Item ".env.example" ".env" -Force
-        Write-Host "⚠️  Please edit .env file with your actual values" -ForegroundColor Yellow
-    }
-
-    # Install dependencies
-    Write-Host "📦 Installing dependencies..." -ForegroundColor Yellow
-    npm install
-
-    # Create database (if configured)
-${databaseSetup}
-
-    # Run initial build
-    Write-Host "🔨 Running initial build..." -ForegroundColor Yellow
-    npm run build
-
-    # Run tests
-    Write-Host "🧪 Running tests..." -ForegroundColor Yellow
-    npm test
-
-    Write-Host "✅ Setup completed successfully!" -ForegroundColor Green
-    Write-Host "🚀 You can now run 'npm run dev' to start development" -ForegroundColor Cyan
-
-} catch {
-    Write-Host "❌ Setup failed: $_" -ForegroundColor Red
-    exit 1
-}
-`;
-    await this.writeFile(join('scripts', 'setup.ps1'), content);
-    return join(servicePath, 'scripts', 'setup.ps1');
-  }
-  validateContext(context) {
-    const confirmedValues = context.confirmedValues || context;
-    if (!confirmedValues.displayName) {
-      throw new Error('SetupScriptGenerator: Missing displayName');
-    }
-    return true;
-  }
-}

package/dist/service-management/generators/service-types/StaticSiteGenerator.js

@@ -1,342 +0,0 @@
-/**
- * StaticSiteGenerator - Service-type generator for static-site services
- *
- * Generates static-site specific files and configurations:
- * - Static file serving handlers
- * - Site configuration schemas
- * - Asset optimization middleware
- * - SPA fallback routing
- *
- * Extends BaseServiceTypeGenerator to provide static-site specific generation logic.
- */
-import { BaseGenerator } from '../BaseGenerator.js';
-export class StaticSiteGenerator extends BaseGenerator {
-  /**
-   * Create a new StaticSiteGenerator instance
-   * @param {Object} options - Generator options
-   */
-  constructor(options = {}) {
-    super({
-      name: 'StaticSiteGenerator',
-      ...options
-    });
-    this.serviceType = 'static-site';
-  }
-
-  /**
-   * Main generation method for static-site services
-   * Generates all static-site specific files and configurations
-   *
-   * @param {Object} context - Generation context
-   * @param {Object} context.coreInputs - Core service inputs
-   * @param {Object} context.confirmedValues - Confirmed configuration values
-   * @param {string} context.servicePath - Path to generate service in
-   * @returns {Promise<void>}
-   */
-  async generate(context) {
-    this.setContext(context);
-    const {
-      coreInputs,
-      confirmedValues,
-      servicePath
-    } = this.extractContext(context);
-
-    // Validate service type
-    if (coreInputs.serviceType !== 'static-site') {
-      this.log('Skipping static-site generation - service type is not static-site');
-      return;
-    }
-    this.log('Generating static-site service files...');
-
-    // Generate static-site specific handlers
-    await this.generateHandlers(context);
-
-    // Generate configuration schemas
-    await this.generateSchemas(context);
-
-    // Generate middleware
-    await this.generateMiddleware(context);
-
-    // Generate documentation
-    await this.generateDocs(context);
-    this.log('Static-site service generation complete');
-  }
-
-  /**
-   * Generate static-site specific request handlers
-   * Creates handlers for static file serving, SPA routing, and health checks
-   *
-   * @param {Object} context - Generation context
-   * @returns {Promise<void>}
-   */
-  async generateHandlers(context) {
-    const {
-      coreInputs,
-      confirmedValues
-    } = this.extractContext(context);
-
-    // Load the base worker template
-    const workerTemplate = await this.loadTemplate('src/worker/index.js');
-
-    // Prepare template variables
-    const templateVars = {
-      SERVICE_NAME: coreInputs.serviceName || 'static-site',
-      SERVICE_DISPLAY_NAME: confirmedValues.displayName || coreInputs.serviceName || 'Static Site',
-      SERVICE_TYPE: 'static-site',
-      DOMAIN_NAME: coreInputs.domainName || 'example.com',
-      CURRENT_DATE: new Date().toISOString().split('T')[0],
-      ENVIRONMENT: context.environment || 'development'
-    };
-
-    // Render the worker
-    const workerContent = this.renderTemplate(workerTemplate, templateVars);
-    await this.writeFile('src/worker/index.js', workerContent);
-
-    // Generate domain configuration
-    const domainTemplate = await this.loadTemplate('src/config/domains.js');
-    const domainContent = this.renderTemplate(domainTemplate, templateVars);
-    await this.writeFile('src/config/domains.js', domainContent);
-    this.log('Generated static-site handlers and configuration');
-  }
-
-  /**
-   * Generate static-site specific configuration schemas
-   * Creates validation schemas for static-site configuration
-   *
-   * @param {Object} context - Generation context
-   * @returns {Promise<void>}
-   */
-  async generateSchemas(context) {
-    const {
-      coreInputs
-    } = this.extractContext(context);
-
-    // Create a basic schema for static-site configuration validation
-    const schemaContent = {
-      $schema: "https://json-schema.org/draft/2020-12/schema",
-      title: "Static Site Configuration Schema",
-      description: "Configuration schema for static-site services",
-      type: "object",
-      properties: {
-        serviceType: {
-          type: "string",
-          enum: ["static-site"],
-          description: "Must be 'static-site' for this schema"
-        },
-        publicDir: {
-          type: "string",
-          default: "public",
-          description: "Directory containing static files"
-        },
-        indexFile: {
-          type: "string",
-          default: "index.html",
-          description: "Default index file for directory requests"
-        },
-        errorFile: {
-          type: "string",
-          default: "404.html",
-          description: "Error page for 404 responses"
-        },
-        spaFallback: {
-          type: "boolean",
-          default: true,
-          description: "Enable SPA fallback to index.html for client-side routing"
-        },
-        cleanUrls: {
-          type: "boolean",
-          default: true,
-          description: "Serve .html files without extension"
-        },
-        compressText: {
-          type: "boolean",
-          default: true,
-          description: "Enable gzip compression for text files"
-        },
-        corsEnabled: {
-          type: "boolean",
-          default: true,
-          description: "Enable CORS headers"
-        }
-      },
-      required: ["serviceType"]
-    };
-    await this.writeFile('static-site-schema.json', JSON.stringify(schemaContent, null, 2));
-    this.log('Generated static-site configuration schema');
-  }
-
-  /**
-   * Generate static-site specific middleware
-   * Creates middleware for asset optimization, caching, and security
-   *
-   * @param {Object} context - Generation context
-   * @returns {Promise<void>}
-   */
-  async generateMiddleware(context) {
-    const middlewareContent = `/**
- * Static Site Middleware
- * Generated by Clodo Framework for ${context.coreInputs?.serviceName || 'static-site'}
- *
- * Provides middleware for:
- * - Asset optimization
- * - Cache headers
- * - Security headers
- * - Compression
- */
-
-export class StaticSiteMiddleware {
-  constructor(options = {}) {
-    this.options = {
-      cacheControl: options.cacheControl || 'public, max-age=31536000, immutable',
-      compressText: options.compressText !== false,
-      corsEnabled: options.corsEnabled !== false,
-      ...options
-    };
-  }
-
-  /**
-   * Apply static site middleware to a response
-   * @param {Response} response - The response to modify
-   * @param {Request} request - The original request
-   * @returns {Response} - Modified response
-   */
-  apply(response, request) {
-    const newResponse = new Response(response.body, response);
-
-    // Add cache control for static assets
-    if (this.isStaticAsset(request.url)) {
-      newResponse.headers.set('Cache-Control', this.options.cacheControl);
-    }
-
-    // Add CORS headers if enabled
-    if (this.options.corsEnabled) {
-      newResponse.headers.set('Access-Control-Allow-Origin', '*');
-      newResponse.headers.set('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
-      newResponse.headers.set('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-    }
-
-    // Add compression if enabled and response is text-based
-    if (this.options.compressText && this.shouldCompress(newResponse)) {
-      newResponse.headers.set('Content-Encoding', 'gzip');
-    }
-
-    // Add security headers
-    newResponse.headers.set('X-Content-Type-Options', 'nosniff');
-    newResponse.headers.set('X-Frame-Options', 'DENY');
-    newResponse.headers.set('Referrer-Policy', 'strict-origin-when-cross-origin');
-
-    return newResponse;
-  }
-
-  /**
-   * Check if URL is a static asset
-   * @param {string} url - Request URL
-   * @returns {boolean} - True if static asset
-   */
-  isStaticAsset(url) {
-    const pathname = new URL(url).pathname;
-    const staticExtensions = ['.css', '.js', '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.woff', '.woff2', '.webp'];
-
-    return staticExtensions.some(ext => pathname.endsWith(ext));
-  }
-
-  /**
-   * Check if response should be compressed
-   * @param {Response} response - Response to check
-   * @returns {boolean} - True if should compress
-   */
-  shouldCompress(response) {
-    const contentType = response.headers.get('Content-Type') || '';
-    return contentType.includes('text/') ||
-           contentType.includes('application/json') ||
-           contentType.includes('application/javascript') ||
-           contentType.includes('application/xml');
-  }
-}
-
-export default StaticSiteMiddleware;`;
-    await this.writeFile('src/middleware/StaticSiteMiddleware.js', middlewareContent);
-    this.log('Generated static-site middleware');
-  }
-
-  /**
-   * Generate static-site specific documentation
-   * Creates README and configuration guides
-   *
-   * @param {Object} context - Generation context
-   * @returns {Promise<void>}
-   */
-  async generateDocs(context) {
-    const {
-      coreInputs,
-      confirmedValues
-    } = this.extractContext(context);
-
-    // Load the README template
-    const readmeTemplate = await this.loadTemplate('README.md');
-
-    // Prepare template variables
-    const templateVars = {
-      SERVICE_NAME: coreInputs.serviceName || 'static-site',
-      SERVICE_DISPLAY_NAME: confirmedValues.displayName || coreInputs.serviceName || 'Static Site',
-      SERVICE_TYPE: 'static-site',
-      DOMAIN_NAME: coreInputs.domainName || 'example.com',
-      CURRENT_DATE: new Date().toISOString().split('T')[0],
-      CURRENT_YEAR: new Date().getFullYear(),
-      FRAMEWORK_VERSION: '1.0.0',
-      ENVIRONMENT: context.environment || 'development'
-    };
-
-    // Render and write README
-    const readmeContent = this.renderTemplate(readmeTemplate, templateVars);
-    await this.writeFile('README.md', readmeContent);
-    this.log('Generated static-site documentation');
-  }
-
-  /**
-   * Determine if this generator should run
-   * Only runs for static-site service type
-   *
-   * @param {Object} context - Generation context
-   * @returns {boolean} - True if service type is static-site
-   */
-  shouldGenerate(context) {
-    const serviceType = context?.coreInputs?.serviceType || context?.serviceType;
-    return serviceType === 'static-site';
-  }
-
-  /**
-   * Validate static-site specific configuration
-   * @param {Object} config - Configuration to validate
-   * @returns {Object} - Validation result { valid: boolean, errors: string[] }
-   */
-  validateConfig(config) {
-    const errors = [];
-    if (config.serviceType !== 'static-site') {
-      errors.push('Service type must be "static-site"');
-    }
-    if (config.publicDir && typeof config.publicDir !== 'string') {
-      errors.push('publicDir must be a string path');
-    }
-    if (config.indexFile && typeof config.indexFile !== 'string') {
-      errors.push('indexFile must be a string filename');
-    }
-    if (config.spaFallback !== undefined && typeof config.spaFallback !== 'boolean') {
-      errors.push('spaFallback must be a boolean');
-    }
-    if (config.buildCommand !== undefined && (typeof config.buildCommand !== 'string' || !config.buildCommand.trim())) {
-      errors.push('buildCommand must be a non-empty string');
-    }
-    if (config.buildOutputDir !== undefined && (typeof config.buildOutputDir !== 'string' || !config.buildOutputDir.trim())) {
-      errors.push('buildOutputDir must be a non-empty string');
-    }
-    if (errors.length > 0) {
-      throw new Error(`Invalid static-site configuration: ${errors.join(', ')}`);
-    }
-    return {
-      valid: true,
-      errors: []
-    };
-  }
-}
-export default StaticSiteGenerator;