@tamyla/clodo-framework 3.0.15 → 3.1.1

package/templates/static-site/public/styles.css

@@ -0,0 +1,123 @@
+/* Basic styles for {{SERVICE_DISPLAY_NAME}} */
+
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    line-height: 1.6;
+    color: #333;
+    max-width: 1200px;
+    margin: 0 auto;
+    padding: 0 20px;
+}
+
+header {
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    color: white;
+    padding: 2rem 0;
+    text-align: center;
+}
+
+header h1 {
+    margin-bottom: 1rem;
+    font-size: 2.5rem;
+}
+
+nav {
+    margin-top: 1rem;
+}
+
+nav a {
+    color: white;
+    text-decoration: none;
+    margin: 0 1rem;
+    padding: 0.5rem 1rem;
+    border-radius: 4px;
+    transition: background-color 0.3s;
+}
+
+nav a:hover {
+    background-color: rgba(255, 255, 255, 0.1);
+}
+
+main {
+    padding: 2rem 0;
+}
+
+#hero {
+    text-align: center;
+    margin-bottom: 3rem;
+}
+
+#hero h2 {
+    font-size: 2rem;
+    margin-bottom: 1rem;
+    color: #667eea;
+}
+
+#hero p {
+    font-size: 1.1rem;
+    margin-bottom: 1rem;
+}
+
+#features {
+    background: #f8f9fa;
+    padding: 2rem;
+    border-radius: 8px;
+    margin-bottom: 2rem;
+}
+
+#features h3 {
+    text-align: center;
+    margin-bottom: 1.5rem;
+    color: #667eea;
+}
+
+#features ul {
+    list-style: none;
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+    gap: 1rem;
+}
+
+#features li {
+    padding: 1rem;
+    background: white;
+    border-radius: 4px;
+    box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+}
+
+footer {
+    text-align: center;
+    padding: 2rem 0;
+    border-top: 1px solid #eee;
+    color: #666;
+}
+
+footer a {
+    color: #667eea;
+    text-decoration: none;
+}
+
+footer a:hover {
+    text-decoration: underline;
+}
+
+@media (max-width: 768px) {
+    header h1 {
+        font-size: 2rem;
+    }
+
+    nav a {
+        display: block;
+        margin: 0.5rem 0;
+    }
+
+    #features ul {
+        grid-template-columns: 1fr;
+    }
+}

package/templates/static-site/scripts/deploy.ps1

@@ -0,0 +1,121 @@
+# Deployment script for {{SERVICE_NAME}}
+# Generated by Clodo Framework
+
+param(
+    [string]$Environment = "production",
+    [switch]$DryRun,
+    [switch]$Verbose
+)
+
+Write-Host "🚀 Deploying {{SERVICE_DISPLAY_NAME}} ($Environment)" -ForegroundColor Cyan
+Write-Host "Generated by Clodo Framework" -ForegroundColor Gray
+Write-Host ""
+
+# Load environment variables
+if (Test-Path ".env") {
+    Write-Host "📋 Loading environment configuration..." -ForegroundColor Yellow
+    Get-Content ".env" | ForEach-Object {
+        if ($_ -match "^([^#][^=]+)=(.*)$") {
+            $key = $matches[1].Trim()
+            $value = $matches[2].Trim()
+            [Environment]::SetEnvironmentVariable($key, $value)
+        }
+    }
+} else {
+    Write-Warning "⚠️  No .env file found. Using defaults."
+}
+
+# Validate required environment variables
+$requiredVars = @("CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID")
+$missingVars = @()
+
+foreach ($var in $requiredVars) {
+    if (-not [Environment]::GetEnvironmentVariable($var)) {
+        $missingVars += $var
+    }
+}
+
+if ($missingVars.Count -gt 0) {
+    Write-Error "❌ Missing required environment variables: $($missingVars -join ', ')"
+    Write-Host "Please set these in your .env file or environment." -ForegroundColor Red
+    exit 1
+}
+
+# Set deployment environment
+$env:CLOUDFLARE_API_TOKEN = [Environment]::GetEnvironmentVariable("CLOUDFLARE_API_TOKEN")
+$env:CLOUDFLARE_ACCOUNT_ID = [Environment]::GetEnvironmentVariable("CLOUDFLARE_ACCOUNT_ID")
+
+if ($Verbose) {
+    Write-Host "🔧 Environment: $Environment" -ForegroundColor Blue
+    Write-Host "📦 Service: {{SERVICE_NAME}}" -ForegroundColor Blue
+    Write-Host "🌐 Domain: {{DOMAIN_NAME}}" -ForegroundColor Blue
+}
+
+# Check if wrangler is available
+try {
+    $wranglerVersion = & wrangler --version 2>$null
+    Write-Host "✅ Wrangler version: $wranglerVersion" -ForegroundColor Green
+} catch {
+    Write-Error "❌ Wrangler CLI not found. Please install: npm install -g wrangler"
+    exit 1
+}
+
+# Validate static files exist
+if (-not (Test-Path "public")) {
+    Write-Error "❌ Public directory not found. Please ensure static files are in ./public/"
+    exit 1
+}
+
+$fileCount = (Get-ChildItem "public" -Recurse -File).Count
+Write-Host "📁 Found $fileCount static files in public directory" -ForegroundColor Blue
+
+# Dry run mode
+if ($DryRun) {
+    Write-Host "🏃 Dry run mode - would execute:" -ForegroundColor Yellow
+    Write-Host "   wrangler deploy --env $Environment" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "✅ Dry run complete - no changes made" -ForegroundColor Green
+    exit 0
+}
+
+# Deploy to Cloudflare
+Write-Host "🚀 Starting deployment..." -ForegroundColor Cyan
+
+try {
+    if ($Verbose) {
+        & wrangler deploy --env $Environment
+    } else {
+        & wrangler deploy --env $Environment 2>$null
+    }
+
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "" -ForegroundColor Green
+        Write-Host "✅ Deployment successful!" -ForegroundColor Green
+        Write-Host "🌐 Your site is now live at: https://{{DOMAIN_NAME}}" -ForegroundColor Cyan
+        Write-Host ""
+
+        # Health check
+        Write-Host "🔍 Running health check..." -ForegroundColor Yellow
+        try {
+            $healthResponse = Invoke-WebRequest -Uri "https://{{DOMAIN_NAME}}/health" -TimeoutSec 10 -UseBasicParsing
+            if ($healthResponse.StatusCode -eq 200) {
+                Write-Host "✅ Health check passed" -ForegroundColor Green
+            } else {
+                Write-Warning "⚠️  Health check returned status: $($healthResponse.StatusCode)"
+            }
+        } catch {
+            Write-Warning "⚠️  Health check failed: $($_.Exception.Message)"
+        }
+
+    } else {
+        Write-Error "❌ Deployment failed with exit code: $LASTEXITCODE"
+        exit $LASTEXITCODE
+    }
+
+} catch {
+    Write-Error "❌ Deployment error: $($_.Exception.Message)"
+    exit 1
+}
+
+Write-Host ""
+Write-Host "🎉 {{SERVICE_DISPLAY_NAME}} deployment complete!" -ForegroundColor Green

package/templates/static-site/scripts/setup.ps1

@@ -0,0 +1,179 @@
+# Setup script for {{SERVICE_NAME}}
+# Generated by Clodo Framework
+
+param(
+    [switch]$Force,
+    [switch]$Verbose
+)
+
+Write-Host "🔧 Setting up {{SERVICE_DISPLAY_NAME}}" -ForegroundColor Cyan
+Write-Host "Generated by Clodo Framework" -ForegroundColor Gray
+Write-Host ""
+
+# Check if already set up
+if ((Test-Path ".env") -and -not $Force) {
+    Write-Warning "⚠️  .env file already exists. Use -Force to overwrite."
+    Write-Host "Current configuration:" -ForegroundColor Yellow
+    Get-Content ".env" | Select-String "^[^#]" | ForEach-Object { Write-Host "  $_" -ForegroundColor Gray }
+    exit 0
+}
+
+# Create .env file from template
+Write-Host "📋 Creating .env configuration file..." -ForegroundColor Yellow
+
+$envContent = @"
+# Deployment Configuration for {{SERVICE_NAME}}
+# Generated by Clodo Framework on $(Get-Date -Format "yyyy-MM-dd")
+
+# ============================================
+# Core Customer Identity
+# ============================================
+CUSTOMER_ID={{SERVICE_NAME}}
+CUSTOMER_NAME={{SERVICE_NAME}}
+ENVIRONMENT=development
+
+# ============================================
+# Cloudflare Configuration
+# ============================================
+CLOUDFLARE_ACCOUNT_ID=your_account_id_here
+CLOUDFLARE_ZONE_ID=your_zone_id_here
+CLOUDFLARE_API_TOKEN=your_api_token_here
+
+# ============================================
+# Service Configuration
+# ============================================
+SERVICE_NAME={{SERVICE_NAME}}
+SERVICE_TYPE=static-site
+DISPLAY_NAME={{SERVICE_DISPLAY_NAME}}
+DESCRIPTION=A static site service powered by Clodo Framework
+
+# ============================================
+# Domain Configuration
+# ============================================
+DOMAIN={{DOMAIN_NAME}}
+CUSTOMER_DOMAIN={{DOMAIN_NAME}}
+DEPLOYMENT_URL=https://{{DOMAIN_NAME}}
+API_DOMAIN=https://{{DOMAIN_NAME}}
+
+# ============================================
+# Static-Site Configuration
+# ============================================
+PUBLIC_DIR=public
+INDEX_FILE=index.html
+ERROR_FILE=404.html
+CACHE_CONTROL=public, max-age=31536000, immutable
+SPA_FALLBACK=true
+CLEAN_URLS=true
+COMPRESS_TEXT=true
+CORS_ENABLED=true
+
+# ============================================
+# Additional Configuration
+# ============================================
+HEALTH_CHECK_PATH=/health
+API_BASE_PATH=/
+LOG_LEVEL=info
+NODE_COMPATIBILITY=v18
+
+# ============================================
+# Custom Environment Variables
+# ============================================
+# Add your custom environment variables here
+# CUSTOM_VAR=value
+"@
+
+if ($Force -or -not (Test-Path ".env")) {
+    $envContent | Out-File -FilePath ".env" -Encoding UTF8
+    Write-Host "✅ Created .env file" -ForegroundColor Green
+} else {
+    Write-Host "ℹ️  .env file already exists, skipping creation" -ForegroundColor Blue
+}
+
+# Check Node.js version
+Write-Host "🔍 Checking Node.js version..." -ForegroundColor Yellow
+try {
+    $nodeVersion = & node --version
+    Write-Host "✅ Node.js: $nodeVersion" -ForegroundColor Green
+
+    # Check if version is compatible
+    $versionNumber = $nodeVersion -replace '^v', ''
+    $majorVersion = [int]($versionNumber -split '\.')[0]
+
+    if ($majorVersion -lt 18) {
+        Write-Warning "⚠️  Node.js version $nodeVersion detected. Clodo Framework recommends Node.js 18+"
+    }
+} catch {
+    Write-Error "❌ Node.js not found. Please install Node.js 18+ from https://nodejs.org/"
+    exit 1
+}
+
+# Check npm
+try {
+    $npmVersion = & npm --version
+    Write-Host "✅ npm: $npmVersion" -ForegroundColor Green
+} catch {
+    Write-Warning "⚠️  npm not found. It should be included with Node.js."
+}
+
+# Install dependencies
+if (Test-Path "package.json") {
+    Write-Host "📦 Installing dependencies..." -ForegroundColor Yellow
+    try {
+        if ($Verbose) {
+            & npm install
+        } else {
+            & npm install 2>$null
+        }
+        Write-Host "✅ Dependencies installed" -ForegroundColor Green
+    } catch {
+        Write-Error "❌ Failed to install dependencies: $($_.Exception.Message)"
+        exit 1
+    }
+} else {
+    Write-Warning "⚠️  package.json not found. Dependencies not installed."
+}
+
+# Check Wrangler CLI
+Write-Host "🔧 Checking Wrangler CLI..." -ForegroundColor Yellow
+try {
+    $wranglerVersion = & npx wrangler --version 2>$null
+    Write-Host "✅ Wrangler: $wranglerVersion" -ForegroundColor Green
+} catch {
+    Write-Host "📥 Installing Wrangler CLI..." -ForegroundColor Yellow
+    try {
+        & npm install wrangler --save-dev
+        Write-Host "✅ Wrangler CLI installed" -ForegroundColor Green
+    } catch {
+        Write-Warning "⚠️  Failed to install Wrangler CLI. You may need to install it manually: npm install -g wrangler"
+    }
+}
+
+# Validate static files
+Write-Host "📁 Validating static files..." -ForegroundColor Yellow
+$requiredFiles = @("public/index.html", "public/styles.css", "public/app.js")
+$missingFiles = @()
+
+foreach ($file in $requiredFiles) {
+    if (-not (Test-Path $file)) {
+        $missingFiles += $file
+    }
+}
+
+if ($missingFiles.Count -eq 0) {
+    Write-Host "✅ All required static files present" -ForegroundColor Green
+} else {
+    Write-Warning "⚠️  Missing static files: $($missingFiles -join ', ')"
+    Write-Host "These will be created when you run the setup." -ForegroundColor Gray
+}
+
+# Setup complete
+Write-Host "" -ForegroundColor Green
+Write-Host "🎉 Setup complete for {{SERVICE_DISPLAY_NAME}}!" -ForegroundColor Green
+Write-Host "" -ForegroundColor Cyan
+Write-Host "Next steps:" -ForegroundColor White
+Write-Host "  1. Edit .env with your Cloudflare credentials" -ForegroundColor White
+Write-Host "  2. Customize static files in public/" -ForegroundColor White
+Write-Host "  3. Run 'npm run dev' to start development" -ForegroundColor White
+Write-Host "  4. Run 'npm run deploy' to deploy to production" -ForegroundColor White
+Write-Host ""
+Write-Host "📚 For help, see README.md or visit https://clodo.dev/docs" -ForegroundColor Gray

package/templates/static-site/src/config/domains.js

@@ -0,0 +1,35 @@
+/**
+ * Domain configuration for {{SERVICE_DISPLAY_NAME}}
+ * Generated by Clodo Framework
+ */
+
+export const domains = {
+  // Primary domain for this service
+  primary: '{{DOMAIN_NAME}}',
+
+  // Alternative domains (add as needed)
+  alternatives: [
+    // 'www.{{DOMAIN_NAME}}',
+    // 'staging.{{DOMAIN_NAME}}'
+  ],
+
+  // Environment-specific domain mappings
+  environments: {
+    development: '{{SERVICE_NAME}}-dev.{{WORKERS_DEV_DOMAIN}}',
+    staging: 'staging.{{DOMAIN_NAME}}',
+    production: '{{DOMAIN_NAME}}'
+  },
+
+  // Routing configuration
+  routing: {
+    // SPA fallback - serve index.html for client-side routing
+    spaFallback: true,
+    spaFallbackPath: '/index.html',
+
+    // Clean URLs - serve .html files without extension
+    cleanUrls: true,
+
+    // Trailing slash handling
+    trailingSlash: false
+  }
+};

package/templates/static-site/src/worker/index.js

@@ -0,0 +1,153 @@
+import { initializeService, createFeatureGuard, COMMON_FEATURES } from '@tamyla/clodo-framework';
+import { domains } from './config/domains.js';
+
+/**
+ * {{SERVICE_DISPLAY_NAME}} - Clodo Framework Static Site Service
+ *
+ * Generated on: {{CURRENT_DATE}}
+ * Service Type: static-site
+ *
+ * Features:
+ * - Static file serving with Workers Sites
+ * - MIME type detection
+ * - Cache headers for optimal performance
+ * - SPA fallback support
+ * - CORS support
+ * - Compression
+ */
+
+export default {
+  async fetch(request, env, ctx) {
+    try {
+      // Initialize service with Clodo Framework
+      const service = initializeService(env, domains);
+
+      // Log request (if logging is enabled)
+      if (service.features.includes(COMMON_FEATURES.LOGGING)) {
+        console.log(`${request.method} ${request.url} - ${service.domain} (${service.environment})`);
+      }
+
+      const url = new URL(request.url);
+
+      // Health check endpoint
+      if (url.pathname === '/health') {
+        return new Response(JSON.stringify({
+          status: 'healthy',
+          service: '{{SERVICE_NAME}}',
+          version: '1.0.0',
+          type: 'static-site',
+          features: service.features,
+          domain: service.domain,
+          environment: service.environment,
+          timestamp: new Date().toISOString()
+        }), {
+          headers: {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-cache'
+          }
+        });
+      }
+
+      // Service information endpoint
+      if (url.pathname === '/info') {
+        return new Response(JSON.stringify({
+          name: '{{SERVICE_NAME}}',
+          displayName: '{{SERVICE_DISPLAY_NAME}}',
+          type: 'static-site',
+          version: '1.0.0',
+          framework: 'Clodo Framework',
+          staticConfig: {
+            publicDir: env.PUBLIC_DIR || 'public',
+            indexFile: env.INDEX_FILE || 'index.html',
+            errorFile: env.ERROR_FILE || '404.html',
+            spaFallback: env.SPA_FALLBACK !== 'false',
+            cleanUrls: env.CLEAN_URLS !== 'false',
+            compressText: env.COMPRESS_TEXT !== 'false',
+            corsEnabled: env.CORS_ENABLED !== 'false'
+          },
+          domain: service.domain,
+          environment: service.environment
+        }), {
+          headers: {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-cache'
+          }
+        });
+      }
+
+      // Handle CORS preflight requests
+      if (request.method === 'OPTIONS' && env.CORS_ENABLED !== 'false') {
+        return new Response(null, {
+          status: 204,
+          headers: {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+            'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+            'Access-Control-Max-Age': '86400'
+          }
+        });
+      }
+
+      // For static sites, let Workers Sites handle the file serving
+      // This worker mainly adds custom logic and health checks
+      // The [site] configuration in wrangler.toml handles the actual file serving
+
+      // Add CORS headers to all responses if enabled
+      const corsHeaders = env.CORS_ENABLED !== 'false' ? {
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type, Authorization'
+      } : {};
+
+      // Let Workers Sites handle the request
+      // This will serve static files from the public directory
+      const page = await env.ASSETS.fetch(request);
+
+      // Clone the response to add custom headers
+      const response = new Response(page.body, page);
+
+      // Add CORS headers if enabled
+      if (env.CORS_ENABLED !== 'false') {
+        Object.entries(corsHeaders).forEach(([key, value]) => {
+          response.headers.set(key, value);
+        });
+      }
+
+      // Add compression if enabled and response is text-based
+      if (env.COMPRESS_TEXT !== 'false' && shouldCompress(response)) {
+        response.headers.set('Content-Encoding', 'gzip');
+      }
+
+      return response;
+
+    } catch (error) {
+      console.error('Static site worker error:', error);
+
+      // Return a basic error response
+      return new Response(JSON.stringify({
+        error: 'Internal Server Error',
+        message: error.message,
+        timestamp: new Date().toISOString()
+      }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          'Cache-Control': 'no-cache'
+        }
+      });
+    }
+  }
+};
+
+/**
+ * Determine if a response should be compressed
+ * @param {Response} response - The response to check
+ * @returns {boolean} - Whether to compress
+ */
+function 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');
+}

package/templates/static-site/wrangler.toml

@@ -0,0 +1,43 @@
+name = "{{SERVICE_NAME}}-dev"
+main = "src/worker/index.js"
+compatibility_date = "{{CURRENT_DATE}}"
+
+# Workers Sites configuration for static file serving
+[site]
+bucket = "./public"
+include = ["**/*"]
+exclude = [
+  "node_modules/**",
+  ".git/**",
+  ".DS_Store",
+  "*.log",
+  "wrangler.toml",
+  "package.json",
+  "package-lock.json"
+]
+
+[env.development]
+name = "{{SERVICE_NAME}}-dev"
+
+[env.staging]
+name = "{{SERVICE_NAME}}-staging"
+
+[env.production]
+name = "{{SERVICE_NAME}}"
+
+# Environment variables
+[vars]
+DOMAIN_NAME = "{{SERVICE_NAME}}.{{DOMAIN_NAME}}"
+ENVIRONMENT = "development"
+SERVICE_NAME = "{{SERVICE_NAME}}"
+SERVICE_TYPE = "static-site"
+PUBLIC_DIR = "public"
+INDEX_FILE = "index.html"
+ERROR_FILE = "404.html"
+SPA_FALLBACK = "true"
+CLEAN_URLS = "true"
+COMPRESS_TEXT = "true"
+CORS_ENABLED = "true"
+
+# Add your custom environment variables here
+# CUSTOM_VAR = "value"