@tamyla/clodo-framework 3.1.21 → 3.1.23

package/dist/config/domain-examples/multi-domain.json

@@ -0,0 +1,144 @@
+{
+  "domains": {
+    "api.example.com": {
+      "environment": "production",
+      "serviceName": "api-service",
+      "serviceType": "data-service",
+      "cloudflareToken": "CLOUDFLARE_API_TOKEN_PLACEHOLDER",
+      "cloudflareAccountId": "1234567890abcdef1234567890abcdef",
+      "cloudflareZoneId": "0987654321fedcba0987654321fedcba",
+      "displayName": "Production API Service",
+      "description": "Production API service with high availability",
+      "deploymentStrategy": "blue-green",
+      "healthCheck": {
+        "enabled": true,
+        "path": "/health",
+        "interval": 30,
+        "timeout": 10
+      },
+      "routing": {
+        "rules": [
+          {
+            "pattern": "/api/v1/*",
+            "target": "api-v1-worker",
+            "methods": ["GET", "POST", "PUT", "DELETE"]
+          },
+          {
+            "pattern": "/api/v2/*",
+            "target": "api-v2-worker",
+            "methods": ["GET", "POST", "PUT", "DELETE"]
+          }
+        ]
+      },
+      "security": {
+        "cors": {
+          "enabled": true,
+          "origins": ["https://app.example.com", "https://admin.example.com"],
+          "methods": ["GET", "POST", "PUT", "DELETE"],
+          "headers": ["Content-Type", "Authorization", "X-API-Key"]
+        },
+        "rateLimit": {
+          "enabled": true,
+          "requests": 5000,
+          "window": 60
+        }
+      }
+    },
+    "admin.example.com": {
+      "environment": "production",
+      "serviceName": "admin-service",
+      "serviceType": "web-service",
+      "cloudflareToken": "CLOUDFLARE_API_TOKEN_PLACEHOLDER",
+      "cloudflareAccountId": "1234567890abcdef1234567890abcdef",
+      "cloudflareZoneId": "0987654321fedcba0987654321fedcba",
+      "displayName": "Admin Dashboard Service",
+      "description": "Administrative dashboard with restricted access",
+      "deploymentStrategy": "rolling",
+      "healthCheck": {
+        "enabled": true,
+        "path": "/admin/health",
+        "interval": 60,
+        "timeout": 15
+      },
+      "routing": {
+        "rules": [
+          {
+            "pattern": "/admin/*",
+            "target": "admin-worker",
+            "methods": ["GET", "POST", "PUT", "DELETE"],
+            "auth": {
+              "required": true,
+              "type": "jwt"
+            }
+          }
+        ]
+      },
+      "security": {
+        "cors": {
+          "enabled": false
+        },
+        "rateLimit": {
+          "enabled": true,
+          "requests": 100,
+          "window": 60
+        },
+        "waf": {
+          "enabled": true,
+          "rules": ["sql-injection", "xss", "csrf"]
+        }
+      }
+    },
+    "cdn.example.com": {
+      "environment": "production",
+      "serviceName": "cdn-service",
+      "serviceType": "static-site",
+      "cloudflareToken": "CLOUDFLARE_API_TOKEN_PLACEHOLDER",
+      "cloudflareAccountId": "1234567890abcdef1234567890abcdef",
+      "cloudflareZoneId": "0987654321fedcba0987654321fedcba",
+      "displayName": "CDN Static Assets",
+      "description": "Content delivery network for static assets",
+      "deploymentStrategy": "instant",
+      "healthCheck": {
+        "enabled": false
+      },
+      "routing": {
+        "rules": [
+          {
+            "pattern": "/*",
+            "target": "cdn-worker",
+            "methods": ["GET", "HEAD"],
+            "cache": {
+              "enabled": true,
+              "ttl": 3600,
+              "purgeOnDeploy": true
+            }
+          }
+        ]
+      },
+      "security": {
+        "cors": {
+          "enabled": true,
+          "origins": ["*"],
+          "methods": ["GET", "HEAD"],
+          "headers": ["Cache-Control", "ETag"]
+        },
+        "rateLimit": {
+          "enabled": false
+        }
+      }
+    }
+  },
+  "global": {
+    "customer": "example-company",
+    "organization": "Example Corp",
+    "contact": "devops@example.com",
+    "version": "1.0.0",
+    "lastUpdated": "2025-10-28",
+    "multiDomain": {
+      "enabled": true,
+      "parallelDeployments": 2,
+      "rollbackOnFailure": true,
+      "healthCheckTimeout": 300
+    }
+  }
+}

package/dist/config/domain-examples/single-domain.json

@@ -0,0 +1,50 @@
+{
+  "domains": {
+    "api.example.com": {
+      "environment": "production",
+      "serviceName": "api-service",
+      "serviceType": "data-service",
+      "cloudflareToken": "CLOUDFLARE_API_TOKEN_PLACEHOLDER",
+      "cloudflareAccountId": "1234567890abcdef1234567890abcdef",
+      "cloudflareZoneId": "0987654321fedcba0987654321fedcba",
+      "displayName": "Example API Service",
+      "description": "Single domain configuration for production API service",
+      "deploymentStrategy": "rolling",
+      "healthCheck": {
+        "enabled": true,
+        "path": "/health",
+        "interval": 30,
+        "timeout": 10
+      },
+      "routing": {
+        "rules": [
+          {
+            "pattern": "/api/*",
+            "target": "api-worker",
+            "methods": ["GET", "POST", "PUT", "DELETE"]
+          }
+        ]
+      },
+      "security": {
+        "cors": {
+          "enabled": true,
+          "origins": ["https://app.example.com"],
+          "methods": ["GET", "POST", "PUT", "DELETE"],
+          "headers": ["Content-Type", "Authorization"]
+        },
+        "rateLimit": {
+          "enabled": true,
+          "requests": 1000,
+          "window": 60
+        }
+      }
+    }
+  },
+  "global": {
+    "customer": "example-company",
+    "organization": "Example Corp",
+    "contact": "devops@example.com",
+    "version": "1.0.0",
+    "lastUpdated": "2025-10-28"
+  }
+}

package/dist/config/examples

@@ -0,0 +1,12 @@
+{
+  "customer": "mycompany",
+  "environment": "production",
+  "serviceName": "my-api-service",
+  "serviceType": "data-service",
+  "domainName": "api.mycompany.com",
+  "cloudflareToken": "CLOUDFLARE_API_TOKEN_PLACEHOLDER",
+  "cloudflareAccountId": "1234567890abcdef1234567890abcdef",
+  "cloudflareZoneId": "0987654321fedcba0987654321fedcba",
+  "displayName": "My Company API Service",
+  "description": "Production API service for customer data management"
+}

package/dist/config/features.js

@@ -0,0 +1,61 @@
+/**
+ * Feature Flag Manager
+ * Simple stub for missing features.js
+ */
+
+export class FeatureFlagManager {
+  constructor() {
+    this.features = new Map();
+  }
+  isEnabled(feature) {
+    return this.features.get(feature) || false;
+  }
+  enable(feature) {
+    this.features.set(feature, true);
+  }
+  disable(feature) {
+    this.features.set(feature, false);
+  }
+  withFeature(feature, enhancedFn, legacyFn = null) {
+    if (this.isEnabled(feature)) {
+      return enhancedFn();
+    } else if (legacyFn) {
+      return legacyFn();
+    } else {
+      // If no legacy function provided, just call enhanced anyway
+      return enhancedFn();
+    }
+  }
+  getAllFeatures() {
+    const result = {};
+    for (const [key, value] of this.features) {
+      result[key] = {
+        enabled: value
+      };
+    }
+    return result;
+  }
+}
+
+// Default instance
+export const featureManager = new FeatureFlagManager();
+
+// Feature constants
+export const FEATURES = {
+  ENHANCED_SCHEMA: 'enhanced_schema',
+  ENHANCED_VALIDATION: 'enhanced_validation',
+  ENABLE_COMPREHENSIVE_VALIDATION: 'enhanced_validation',
+  ENABLE_SQL_CACHING: 'sql_caching',
+  ENABLE_SCHEMA_CACHING: 'schema_caching',
+  ENABLE_ADVANCED_QUERIES: 'advanced_queries',
+  ENABLE_SECURITY_CONTROLS: 'security_controls',
+  ENABLE_QUERY_CACHING: 'query_caching',
+  ENABLE_ADVANCED_PAGINATION: 'advanced_pagination',
+  ENABLE_CACHE_METRICS: 'cache_metrics',
+  ENABLE_DEBUG_LOGGING: 'debug_logging',
+  ENABLE_ENHANCED_SCHEMA: 'enhanced_schema',
+  ENABLE_HOOK_METRICS: 'hook_metrics',
+  ENABLE_HOOK_TIMEOUT: 'hook_timeout',
+  ENABLE_ENHANCED_HOOKS: 'enhanced_hooks',
+  ENABLE_PARALLEL_EXECUTION: 'parallel_execution'
+};

package/dist/config/staging-deployment.json

@@ -0,0 +1,60 @@
+{
+  "// Comment": "Staging deployment configuration for clodo-framework",
+  "// Instructions": "This config deploys to staging environment using environment-mapped domain configuration",
+  "// Domain": "Uses staging.example.com domain from environment-mapped.json",
+  "// Environment": "Staging environment with moderate security and monitoring",
+
+  "domain": "staging.example.com",
+  "environment": "staging",
+  "cloudflareToken": "${CLOUDFLARE_API_TOKEN}",
+  "cloudflareAccountId": "${CLOUDFLARE_ACCOUNT_ID}",
+  "cloudflareZoneId": "${CLOUDFLARE_ZONE_ID}",
+
+  "deployment": {
+    "strategy": "rolling",
+    "replicas": 2,
+    "maxConcurrency": 50,
+    "timeout": 60000,
+    "healthCheckInterval": 10000,
+    "rollbackOnFailure": true
+  },
+
+  "routing": {
+    "enableLoadBalancing": true,
+    "loadBalancingPolicy": "round-robin",
+    "corsEnabled": true,
+    "corsOrigins": ["https://staging.example.com", "https://app-staging.example.com"]
+  },
+
+  "monitoring": {
+    "enableMetrics": true,
+    "metricsEndpoint": "https://metrics-staging.example.com",
+    "alertOnFailure": true,
+    "alertEmail": "staging-alerts@example.com"
+  },
+
+  "security": {
+    "enableSSL": true,
+    "minTLSVersion": "1.2",
+    "enableWAF": true,
+    "rateLimit": 500,
+    "rateLimitWindow": 60,
+    "wafRules": ["sql-injection", "xss"]
+  },
+
+  "healthCheck": {
+    "enabled": true,
+    "endpoint": "/health",
+    "interval": 30000,
+    "timeout": 10000,
+    "healthyThreshold": 2,
+    "unhealthyThreshold": 3
+  },
+
+  "logging": {
+    "level": "info",
+    "includeRequestId": true,
+    "includeTimestamp": true,
+    "maskSensitiveData": true
+  }
+}

package/dist/config/validation-config.json

@@ -0,0 +1,347 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Clodo Framework Enhanced Configuration",
+  "description": "Comprehensive configuration for flexible service deployment and validation",
+  
+  "commands": {
+    "required": {
+      "npx": "npx",
+      "node": "node", 
+      "npm": "npm",
+      "wrangler": "npx wrangler"
+    },
+    "cloudflare": {
+      "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": "echo 'Zone listing not available via wrangler CLI'",
+      "worker_status": "npx wrangler status"
+    },
+    "system": {
+      "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"
+    }
+  },
+
+  "timing": {
+    "deploymentTimeout": 300000,
+    "discoveryTimeout": 30000,
+    "healthCheckTimeout": 10000,
+    "productionTestTimeout": 30000,
+    "shutdownTimeout": 30000,
+    "forceShutdownTimeout": 5000,
+    "retryDelay": 1000,
+    "retryAttempts": 3,
+    "cacheTTL": 3600000,
+    "maxAge": 86400000,
+    "rateLimitWindow": 60000,
+    "circuitBreakerTimeout": 60000,
+    "circuitBreakerThreshold": 5,
+    "deploymentInterval": 5000,
+    "endpointValidationTimeout": 5000,
+    "maxConcurrentDeployments": 3
+  },
+
+  "networking": {
+    "endpoints": {
+      "cloudflare": "https://api.cloudflare.com",
+      "npm": "https://registry.npmjs.org",
+      "healthCheck": "https://httpbin.org/status/200"
+    },
+    "development": {
+      "defaultPorts": {
+        "frontend": 3000,
+        "api": 8787,
+        "worker": 8787,
+        "preview": 8788
+      },
+      "allowedOrigins": ["http://localhost:3000", "http://localhost:8787"],
+      "corsDefaults": ["*"]
+    },
+    "rateLimiting": {
+      "defaultRequests": 100,
+      "defaultWindow": 60000,
+      "burstLimit": 200,
+      "strictMode": false
+    }
+  },
+
+  "caching": {
+    "maxCacheSize": 52428800,
+    "compressionThreshold": 1024,
+    "cleanupInterval": 3600000,
+    "enableCompression": true,
+    "maxEntries": 1000
+  },
+
+  "environments": {
+    "development": {
+      "domainTemplate": "dev-{service}.{domain}",
+      "workerSuffix": "-dev",
+      "databaseSuffix": "-dev",
+      "logLevel": "debug",
+      "enableMetrics": true,
+      "strictValidation": false,
+      "routing": {
+        "_comment": "Development routing configuration - typically uses workers.dev subdomain",
+        "defaultPathPrefix": "/dev-api",
+        "wildcardPattern": "/*",
+        "generateFallbackRoute": true
+      }
+    },
+    "staging": {
+      "domainTemplate": "staging-{service}.{domain}",
+      "workerSuffix": "-staging", 
+      "databaseSuffix": "-staging",
+      "logLevel": "info",
+      "enableMetrics": true,
+      "strictValidation": true,
+      "routing": {
+        "_comment": "Staging routing configuration - nested under [env.staging] in wrangler.toml",
+        "defaultPathPrefix": "/staging-api",
+        "wildcardPattern": "/*",
+        "generateFallbackRoute": true
+      }
+    },
+    "production": {
+      "domainTemplate": "{service}.{domain}",
+      "workerSuffix": "",
+      "databaseSuffix": "",
+      "logLevel": "warn",
+      "enableMetrics": true,
+      "strictValidation": true,
+      "routing": {
+        "_comment": "Production routing configuration - top-level [[routes]] in wrangler.toml",
+        "defaultPathPrefix": "/api",
+        "wildcardPattern": "/*",
+        "generateFallbackRoute": true,
+        "nestedInToml": false
+      }
+    }
+  },
+
+  "serviceDefaults": {
+    "compatibility_date": "2024-01-01",
+    "node_compat": true,
+    "minify": true,
+    "sourcemap": false
+  },
+
+  "staticSite": {
+    "defaults": {
+      "publicDir": "public",
+      "indexFile": "index.html",
+      "errorFile": "404.html",
+      "cacheControl": "public, max-age=31536000, immutable",
+      "textTypes": ["html", "css", "js", "json", "xml", "txt"],
+      "binaryTypes": ["png", "jpg", "jpeg", "gif", "svg", "ico", "webp", "woff", "woff2"]
+    },
+    "siteConfig": {
+      "bucket": "./public",
+      "include": ["**/*"],
+      "exclude": [
+        "node_modules/**",
+        ".git/**",
+        ".DS_Store",
+        "*.log",
+        "wrangler.toml",
+        "package.json",
+        "package-lock.json"
+      ]
+    },
+    "routing": {
+      "spaFallback": true,
+      "spaFallbackPath": "/index.html",
+      "cleanUrls": true,
+      "trailingSlash": false
+    },
+    "optimization": {
+      "compressText": true,
+      "etagGeneration": true,
+      "corsEnabled": true,
+      "corsOrigins": ["*"]
+    }
+  },
+
+  "validation": {
+    "requiredFiles": [
+      "package.json",
+      "wrangler.toml"
+    ],
+    "optionalFiles": [
+      "README.md",
+      "LICENSE",
+      ".gitignore"
+    ],
+    "requiredFields": {
+      "package.json": ["name", "version", "type", "main"],
+      "wrangler.toml": ["name", "main", "compatibility_date"]
+    },
+    "serviceTypes": [
+      "data-service",
+      "auth-service", 
+      "content-service",
+      "api-gateway",
+      "static-site",
+      "generic"
+    ]
+  },
+
+  "security": {
+    "requiredEnvironmentVars": [
+      "CLOUDFLARE_API_TOKEN"
+    ],
+    "optionalEnvironmentVars": [
+      "CLOUDFLARE_ACCOUNT_ID",
+      "CLOUDFLARE_ZONE_ID",
+      "ENVIRONMENT",
+      "LOG_LEVEL",
+      "CORS_ORIGINS",
+      "RATE_LIMIT_REQUESTS",
+      "RATE_LIMIT_WINDOW_MS",
+      "ENABLE_METRICS",
+      "METRICS_ENDPOINT"
+    ],
+    "secretsConfig": {
+      "encryptionEnabled": true,
+      "rotationInterval": 7776000000,
+      "backupCount": 5,
+      "distributionDelay": 5000
+    }
+  },
+
+  "monitoring": {
+    "healthCheck": {
+      "endpoints": ["/health", "/ping"],
+      "expectedStatus": [200, 204],
+      "timeout": 5000,
+      "interval": 30000
+    },
+    "metrics": {
+      "enabledByDefault": true,
+      "collectionInterval": 60000,
+      "retentionPeriod": 2592000000,
+      "aggregationWindow": 300000
+    },
+    "logging": {
+      "levels": ["debug", "info", "warn", "error"],
+      "defaultLevel": "info",
+      "enableConsole": true,
+      "enableFile": false,
+      "maxFileSize": 10485760
+    }
+  },
+
+  "deployment": {
+    "strategies": ["blue-green", "rolling", "canary"],
+    "defaultStrategy": "blue-green",
+    "validation": {
+      "runTests": true,
+      "requireHealthCheck": true,
+      "allowSkipValidation": false
+    },
+    "rollback": {
+      "enableAutoRollback": true,
+      "healthCheckThreshold": 3,
+      "timeoutThreshold": 30000
+    }
+  },
+
+  "testing": {
+    "production": {
+      "enabled": true,
+      "lightweight": true,
+      "skipHeavyTests": true,
+      "generateReports": false,
+      "testTimeout": 30000
+    },
+    "integration": {
+      "enabled": false,
+      "requiresRealEnvironment": true,
+      "cleanupAfterTests": true
+    }
+  },
+
+  "database": {
+    "namingConvention": {
+      "development": "{service}-dev",
+      "staging": "{service}-staging", 
+      "production": "{service}"
+    },
+    "migration": {
+      "autoRun": false,
+      "backupBeforeMigration": true,
+      "rollbackOnFailure": true
+    },
+    "connection": {
+      "timeout": 30000,
+      "retryAttempts": 3,
+      "poolSize": 10
+    }
+  },
+
+  "templates": {
+    "directory": "templates",
+    "defaultType": "generic",
+    "variablePrefix": "{{",
+    "variableSuffix": "}}",
+    "commonVariables": {
+      "CURRENT_DATE": "auto-generated",
+      "CURRENT_YEAR": "auto-generated", 
+      "FRAMEWORK_VERSION": "auto-generated"
+    },
+    "defaults": {
+      "DOMAIN_NAME": "example.com",
+      "WORKERS_DEV_DOMAIN": "workers.dev",
+      "DEFAULT_REGION": "auto",
+      "DEFAULT_TIMEZONE": "UTC"
+    },
+    "companyDefaults": {
+      "NOTE": "Override these in customer-specific config files",
+      "COMPANY_DOMAIN": "example.com",
+      "WORKERS_SUBDOMAIN": "company-name"
+    }
+  },
+
+  "routing": {
+    "_comment": "Routing configuration for automatic route generation from domain config",
+    "defaults": {
+      "_comment": "Default options for route generation - applied to all environments unless overridden",
+      "includeComments": true,
+      "includeZoneId": true,
+      "targetEnvironment": "all",
+      "orderStrategy": "most-specific-first"
+    },
+    "domains": {
+      "_comment": "Domain-specific routing rules and patterns",
+      "skipPatterns": [],
+      "_skipPatternsNote": "Add domain patterns to skip route generation (e.g., ['internal.example.com'])",
+      "complexTLDs": [".co.uk", ".com.au", ".org.uk", ".gov.uk", ".co.nz", ".com.br"],
+      "_complexTLDsNote": "Multi-part TLDs that should be treated as single domain extension",
+      "subdomainMinParts": 3,
+      "_subdomainMinPartsNote": "Minimum parts to consider a domain as subdomain (e.g., api.example.com = 3 parts)",
+      "ignoreSubdomains": ["www"],
+      "_ignoreSubdomainsNote": "Subdomain prefixes to ignore when generating routes"
+    },
+    "validation": {
+      "_comment": "Validation patterns for route generation",
+      "zoneIdPattern": "^[a-f0-9]{32}$",
+      "_zoneIdNote": "Cloudflare Zone ID must be 32 hexadecimal characters",
+      "domainPattern": "^[a-z0-9.-]+$",
+      "_domainNote": "Valid domain characters: lowercase letters, numbers, dots, hyphens",
+      "strictMode": true,
+      "_strictModeNote": "When true, reject invalid domains; when false, log warnings only"
+    },
+    "comments": {
+      "_comment": "TOML comment templates - use {{placeholder}} for dynamic values",
+      "enabled": true,
+      "templates": {
+        "production": "# Production environment routes\n# Domain: {{domain}}",
+        "staging": "# Staging environment routes\n# Domain: {{domain}}",
+        "development": "# Development environment\n# Uses {{WORKERS_DEV_DOMAIN}} subdomain"
+      }
+    }
+  }
+}

package/dist/deployment/wrangler-deployer.js

@@ -2,7 +2,7 @@ import { spawn } from 'child_process';
 import { execSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
-import { WranglerD1Manager } from "../../dist/bin/database/wrangler-d1-manager.js";
+import { WranglerD1Manager } from '../lib/database/wrangler-d1-manager.js';
 
 /**
  * WranglerDeployer - Executes actual Cloudflare Workers deployments using wrangler CLI