@tamyla/clodo-framework 3.0.15 → 3.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamyla/clodo-framework",
-  "version": "3.0.15",
+  "version": "3.1.1",
   "description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
   "type": "module",
   "sideEffects": [
@@ -77,6 +77,11 @@
     "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "test:cli-integration": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --config test/cli-integration/jest.config.js",
+    "test:cli-create": "cross-env NODE_OPTIONS=--experimental-vm-modules jest test/cli-integration/clodo-create-service.test.js",
+    "test:cli-init": "cross-env NODE_OPTIONS=--experimental-vm-modules jest test/cli-integration/clodo-init-service.test.js",
+    "test:cli-security": "cross-env NODE_OPTIONS=--experimental-vm-modules jest test/cli-integration/clodo-security.test.js",
+    "test:cli-e2e": "cross-env NODE_OPTIONS=--experimental-vm-modules jest test/cli-integration/e2e-workflows.test.js",
     "lint": "eslint --config ./eslint.config.js src",
     "lint:fix": "eslint --config ./eslint.config.js src --fix",
     "type-check": "tsc --noEmit",

package/templates/generic/clodo-service-manifest.json

@@ -0,0 +1,25 @@
+{
+  "version": "1.0.0",
+  "serviceName": "{{SERVICE_NAME}}",
+  "serviceType": "{{SERVICE_TYPE}}",
+  "framework": "@tamyla/clodo-framework",
+  "created": "{{CURRENT_DATE}}",
+  "description": "A Clodo Framework {{SERVICE_TYPE}} service",
+  "features": {
+    "authentication": false,
+    "database": false,
+    "cache": false,
+    "storage": false
+  },
+  "cloudflare": {
+    "workers": true,
+    "d1": false,
+    "r2": false,
+    "kv": false,
+    "durable-objects": false
+  },
+  "configuration": {
+    "domains": [],
+    "environment": "development"
+  }
+}

package/templates/static-site/.env.example

@@ -0,0 +1,61 @@
+# Deployment Configuration for {{SERVICE_NAME}}
+# Generated by Clodo Framework
+# Copy this file to create your environment-specific .env files
+
+# ============================================
+# 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
+# API_ENDPOINT=https://api.example.com
+# DATABASE_URL=your_database_url

package/templates/static-site/README.md

@@ -0,0 +1,176 @@
+# {{SERVICE_DISPLAY_NAME}}
+
+A static site service powered by **Clodo Framework** and Cloudflare Workers Sites.
+
+## 🚀 Features
+
+- **⚡ Fast Static File Serving** - Powered by Cloudflare's global CDN
+- **🔒 HTTPS by Default** - Automatic SSL certificate management
+- **📱 Mobile Responsive** - Ready for all devices
+- **🤖 SEO Optimized** - Proper meta tags and structured data
+- **🎨 Modern Design** - Clean, professional appearance
+- **🔧 Developer Friendly** - Easy to customize and extend
+
+## 🛠️ Technology Stack
+
+- **Framework**: Clodo Framework
+- **Hosting**: Cloudflare Workers Sites
+- **CDN**: Cloudflare Global Network
+- **Language**: JavaScript (ES Modules)
+- **Styling**: CSS3 with modern features
+
+## 📁 Project Structure
+
+```
+{{SERVICE_NAME}}/
+├── public/                 # Static files served by Workers Sites
+│   ├── index.html         # Home page
+│   ├── styles.css         # Main stylesheet
+│   ├── app.js            # Client-side JavaScript
+│   └── 404.html          # Error page
+├── src/
+│   ├── worker/
+│   │   └── index.js      # Cloudflare Worker (handles routing, CORS, etc.)
+│   └── config/
+│       └── domains.js    # Domain and routing configuration
+├── package.json           # Dependencies and scripts
+├── wrangler.toml         # Cloudflare Workers configuration
+└── clodo-service-manifest.json  # Service metadata
+```
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- Cloudflare account with Wrangler CLI
+- Domain configured in Cloudflare
+
+### Development
+
+1. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+2. **Start development server:**
+   ```bash
+   npm run dev
+   ```
+
+3. **Open your browser:**
+   - Local: `http://localhost:8787`
+   - Preview: The URL shown in your terminal
+
+### Deployment
+
+1. **Configure your environment:**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your Cloudflare credentials
+   ```
+
+2. **Deploy to production:**
+   ```bash
+   npm run deploy
+   ```
+
+## 🔧 Customization
+
+### Static Files
+
+Add your static files to the `public/` directory:
+- HTML pages
+- CSS stylesheets
+- JavaScript files
+- Images, fonts, and other assets
+
+### Styling
+
+Edit `public/styles.css` to customize the appearance. The design uses:
+- CSS Grid and Flexbox for layouts
+- Modern CSS features (variables, animations)
+- Mobile-first responsive design
+
+### Functionality
+
+Modify `public/app.js` to add interactive features:
+- Form handling
+- Dynamic content loading
+- Client-side routing
+- API integrations
+
+### Worker Logic
+
+Edit `src/worker/index.js` for server-side features:
+- Custom routing logic
+- Authentication middleware
+- API proxying
+- Response transformation
+
+## 📊 Service Endpoints
+
+- **`/`** - Home page
+- **`/health`** - Health check (JSON)
+- **`/info`** - Service information (JSON)
+- **`/*`** - Static file serving
+
+## 🌐 Domain Configuration
+
+This service is configured for:
+- **Primary Domain**: `{{DOMAIN_NAME}}`
+- **Environment**: `{{ENVIRONMENT}}`
+
+## 📈 Performance
+
+- **Global CDN** - Files served from 200+ data centers
+- **HTTP/2** - Automatic protocol optimization
+- **Compression** - Gzip compression for text files
+- **Caching** - Optimized cache headers
+- **Minification** - Automatic asset optimization
+
+## 🔒 Security
+
+- **HTTPS Only** - Automatic SSL/TLS
+- **CORS Support** - Configurable cross-origin policies
+- **Security Headers** - Automatic security headers
+- **DDoS Protection** - Cloudflare's edge protection
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+1. **"No such file or directory"**
+   - Ensure all files are in the `public/` directory
+   - Check file permissions
+
+2. **"Deployment failed"**
+   - Verify Cloudflare credentials in `.env`
+   - Check account limits and permissions
+
+3. **"CORS errors"**
+   - Configure CORS settings in `wrangler.toml`
+   - Check origin allowlist
+
+### Debug Mode
+
+Enable debug logging:
+```bash
+LOG_LEVEL=debug npm run dev
+```
+
+## 📚 Learn More
+
+- [Clodo Framework Documentation](https://clodo.dev/docs)
+- [Cloudflare Workers Sites](https://developers.cloudflare.com/pages/platform/direct-upload/)
+- [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/)
+
+## 📄 License
+
+Generated by Clodo Framework - MIT License
+
+---
+
+**Generated on**: {{CURRENT_DATE}}
+**Service Type**: static-site
+**Framework Version**: {{FRAMEWORK_VERSION}}

package/templates/static-site/clodo-service-manifest.json

@@ -0,0 +1,66 @@
+{
+  "name": "{{SERVICE_NAME}}",
+  "displayName": "{{SERVICE_DISPLAY_NAME}}",
+  "type": "static-site",
+  "version": "1.0.0",
+  "framework": "Clodo Framework",
+  "generated": "{{CURRENT_DATE}}",
+
+  "description": "A static site service that serves files from the public directory using Cloudflare Workers Sites",
+
+  "features": [
+    "static-file-serving",
+    "workers-sites-integration",
+    "mime-type-detection",
+    "cache-optimization",
+    "cors-support",
+    "compression",
+    "spa-fallback",
+    "health-checks"
+  ],
+
+  "configuration": {
+    "publicDir": "public",
+    "indexFile": "index.html",
+    "errorFile": "404.html",
+    "spaFallback": true,
+    "cleanUrls": true,
+    "compression": true,
+    "cors": true
+  },
+
+  "endpoints": {
+    "health": "/health",
+    "info": "/info",
+    "static": "/*"
+  },
+
+  "deployment": {
+    "platform": "cloudflare-workers",
+    "sites": true,
+    "routes": [
+      "{{DOMAIN_NAME}}/*"
+    ]
+  },
+
+  "dependencies": [
+    "@tamyla/clodo-framework",
+    "wrangler"
+  ],
+
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "test": "jest",
+    "lint": "eslint src/",
+    "format": "prettier --write src/"
+  },
+
+  "files": {
+    "worker": "src/worker/index.js",
+    "domains": "src/config/domains.js",
+    "static": "public/",
+    "package": "package.json",
+    "wrangler": "wrangler.toml"
+  }
+}

package/templates/static-site/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "{{SERVICE_NAME}}",
+  "version": "1.0.0",
+  "description": "A Clodo Framework static-site service",
+  "main": "src/worker/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "jest",
+    "dev": "wrangler dev",
+    "deploy": "powershell .\\scripts\\deploy.ps1",
+    "setup": "powershell .\\scripts\\setup.ps1",
+    "lint": "eslint src/",
+    "format": "prettier --write src/",
+    "build": "echo 'Static site - no build step required'"
+  },
+  "dependencies": {
+    "@tamyla/clodo-framework": "^1.0.0",
+    "wrangler": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "eslint": "^8.54.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.0"
+  },
+  "author": "Generated by Clodo Framework",
+  "license": "MIT"
+}

package/templates/static-site/public/404.html

@@ -0,0 +1,87 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Page Not Found - {{SERVICE_DISPLAY_NAME}}</title>
+    <link rel="stylesheet" href="/styles.css">
+    <style>
+        .error-page {
+            text-align: center;
+            padding: 4rem 2rem;
+            min-height: 60vh;
+            display: flex;
+            flex-direction: column;
+            justify-content: center;
+            align-items: center;
+        }
+
+        .error-code {
+            font-size: 6rem;
+            font-weight: bold;
+            color: #667eea;
+            margin-bottom: 1rem;
+            opacity: 0.8;
+        }
+
+        .error-message {
+            font-size: 1.5rem;
+            margin-bottom: 2rem;
+            color: #666;
+        }
+
+        .error-actions {
+            display: flex;
+            gap: 1rem;
+            flex-wrap: wrap;
+            justify-content: center;
+        }
+
+        .error-actions a {
+            display: inline-block;
+            padding: 0.75rem 1.5rem;
+            background: #667eea;
+            color: white;
+            text-decoration: none;
+            border-radius: 4px;
+            transition: background-color 0.3s;
+        }
+
+        .error-actions a:hover {
+            background: #5a67d8;
+        }
+
+        .error-actions a.secondary {
+            background: #e2e8f0;
+            color: #4a5568;
+        }
+
+        .error-actions a.secondary:hover {
+            background: #cbd5e0;
+        }
+    </style>
+</head>
+<body>
+    <div class="error-page">
+        <div class="error-code">404</div>
+        <h1 class="error-message">Page Not Found</h1>
+        <p>The page you're looking for doesn't exist on {{SERVICE_DISPLAY_NAME}}.</p>
+
+        <div class="error-actions">
+            <a href="/">Go Home</a>
+            <a href="javascript:history.back()" class="secondary">Go Back</a>
+            <a href="/contact" class="secondary">Contact Us</a>
+        </div>
+    </div>
+
+    <script>
+        // Log 404 errors for analytics
+        console.log('404 Error:', {
+            url: window.location.href,
+            referrer: document.referrer,
+            userAgent: navigator.userAgent,
+            timestamp: new Date().toISOString()
+        });
+    </script>
+</body>
+</html>

package/templates/static-site/public/app.js

@@ -0,0 +1,100 @@
+// App JavaScript for {{SERVICE_DISPLAY_NAME}}
+// Generated by Clodo Framework
+
+document.addEventListener('DOMContentLoaded', function() {
+    // Update environment info
+    fetch('/info')
+        .then(response => response.json())
+        .then(data => {
+            const envElement = document.getElementById('environment');
+            if (envElement) {
+                envElement.textContent = data.environment;
+            }
+
+            // Add some dynamic content based on service info
+            console.log('Service Info:', data);
+        })
+        .catch(error => {
+            console.error('Failed to load service info:', error);
+            const envElement = document.getElementById('environment');
+            if (envElement) {
+                envElement.textContent = 'unknown';
+            }
+        });
+
+    // Add click tracking to navigation
+    const navLinks = document.querySelectorAll('nav a');
+    navLinks.forEach(link => {
+        link.addEventListener('click', function(e) {
+            console.log('Navigation:', this.textContent, this.href);
+
+            // For SPA-like behavior, you could prevent default and handle routing here
+            // e.preventDefault();
+            // handleRoute(this.href);
+        });
+    });
+
+    // Add some interactive features
+    const hero = document.getElementById('hero');
+    if (hero) {
+        hero.addEventListener('click', function() {
+            this.style.transform = 'scale(1.02)';
+            setTimeout(() => {
+                this.style.transform = 'scale(1)';
+            }, 150);
+        });
+    }
+
+    // Service worker registration (if you add one later)
+    if ('serviceWorker' in navigator) {
+        // navigator.serviceWorker.register('/sw.js')
+        //     .then(registration => console.log('SW registered'))
+        //     .catch(error => console.log('SW registration failed'));
+    }
+});
+
+// Utility functions
+function handleRoute(url) {
+    // Implement client-side routing if needed
+    console.log('Routing to:', url);
+    // You could load content dynamically here
+}
+
+function showNotification(message, type = 'info') {
+    // Simple notification system
+    const notification = document.createElement('div');
+    notification.textContent = message;
+    notification.style.cssText = `
+        position: fixed;
+        top: 20px;
+        right: 20px;
+        padding: 1rem;
+        background: ${type === 'error' ? '#ff6b6b' : '#51cf66'};
+        color: white;
+        border-radius: 4px;
+        z-index: 1000;
+        animation: slideIn 0.3s ease-out;
+    `;
+
+    document.body.appendChild(notification);
+
+    setTimeout(() => {
+        notification.style.animation = 'slideOut 0.3s ease-out';
+        setTimeout(() => notification.remove(), 300);
+    }, 3000);
+}
+
+// Add some CSS animations
+const style = document.createElement('style');
+style.textContent = `
+    @keyframes slideIn {
+        from { transform: translateX(100%); opacity: 0; }
+        to { transform: translateX(0); opacity: 1; }
+    }
+
+    @keyframes slideOut {
+        from { transform: translateX(0); opacity: 1; }
+        to { transform: translateX(100%); opacity: 0; }
+    }
+`;
+document.head.appendChild(style);

package/templates/static-site/public/index.html

@@ -0,0 +1,48 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{SERVICE_DISPLAY_NAME}}</title>
+    <meta name="description" content="A static site powered by Clodo Framework">
+    <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+    <header>
+        <h1>Welcome to {{SERVICE_DISPLAY_NAME}}</h1>
+        <nav>
+            <a href="/">Home</a>
+            <a href="/about">About</a>
+            <a href="/contact">Contact</a>
+        </nav>
+    </header>
+
+    <main>
+        <section id="hero">
+            <h2>Your Static Site is Live!</h2>
+            <p>This site is powered by <strong>Clodo Framework</strong> and served via Cloudflare Workers Sites.</p>
+            <p>Service: {{SERVICE_NAME}}<br>
+            Environment: <span id="environment">loading...</span><br>
+            Domain: {{DOMAIN_NAME}}</p>
+        </section>
+
+        <section id="features">
+            <h3>Features</h3>
+            <ul>
+                <li>⚡ Fast static file serving</li>
+                <li>🌐 Global CDN distribution</li>
+                <li>🔒 HTTPS by default</li>
+                <li>📱 Mobile responsive</li>
+                <li>🤖 SEO optimized</li>
+            </ul>
+        </section>
+    </main>
+
+    <footer>
+        <p>&copy; {{CURRENT_YEAR}} {{SERVICE_DISPLAY_NAME}}. Powered by Clodo Framework.</p>
+        <p><a href="/health">Health Check</a> | <a href="/info">Service Info</a></p>
+    </footer>
+
+    <script src="/app.js"></script>
+</body>
+</html>