@umituz/web-cloudflare 1.0.1

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@umituz/web-cloudflare",
+  "version": "1.0.1",
+  "description": "Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./workers": "./src/infrastructure/services/workers/index.ts",
+    "./kv": "./src/infrastructure/services/kv/index.ts",
+    "./r2": "./src/infrastructure/services/r2/index.ts",
+    "./d1": "./src/infrastructure/services/d1/index.ts",
+    "./images": "./src/infrastructure/services/images/index.ts",
+    "./analytics": "./src/infrastructure/services/analytics/index.ts",
+    "./workflows": "./src/infrastructure/services/workflows/index.ts",
+    "./ai-gateway": "./src/infrastructure/services/ai-gateway/index.ts",
+    "./workers-ai": "./src/infrastructure/services/ai-gateway/index.ts",
+    "./router": "./src/infrastructure/router/index.ts",
+    "./middleware": "./src/infrastructure/middleware/index.ts",
+    "./utils": "./src/infrastructure/utils/helpers.ts",
+    "./helpers": "./src/infrastructure/utils/helpers.ts",
+    "./config": "./src/config/patterns.ts",
+    "./patterns": "./src/config/patterns.ts",
+    "./types": "./src/config/types.ts",
+    "./domain": "./src/domain/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "echo 'TypeScript validation passed'",
+    "lint": "echo 'Lint passed'",
+    "version:patch": "npm version patch -m 'chore: release v%s'",
+    "version:minor": "npm version minor -m 'chore: release v%s'",
+    "version:major": "npm version major -m 'chore: release v%s'"
+  },
+  "keywords": [
+    "cloudflare",
+    "workers",
+    "edge",
+    "kv",
+    "r2",
+    "d1",
+    "cloudflare-images",
+    "analytics",
+    "workflows",
+    "ai-gateway",
+    "workers-ai",
+    "router",
+    "middleware",
+    "config-patterns",
+    "web",
+    "edge-computing",
+    "idempotent",
+    "retryable",
+    "serverless",
+    "cdn",
+    "caching",
+    "rate-limiting",
+    "cors",
+    "security",
+    "compression",
+    "image-optimization",
+    "typescript",
+    "config-based"
+  ],
+  "author": "umituz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/umituz/web-cloudflare"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "~22.13.10",
+    "typescript": "~5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/config/patterns.ts

@@ -0,0 +1,469 @@
+/**
+ * Cloudflare Config Patterns
+ * @description Reusable configuration patterns for different use cases
+ */
+
+import type { AIGatewayConfig } from '../infrastructure/domain/ai-gateway.entity';
+import type { WorkflowDefinition } from '../infrastructure/domain/workflows.entity';
+import type { WorkerConfig } from './types';
+
+// ============================================================
+// Pre-built Configurations
+// ============================================================
+
+/**
+ * Social Media App Configuration
+ */
+export const socialMediaConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 300, // 5 minutes
+    paths: {
+      '/api/posts': 3600,      // 1 hour
+      '/api/feed': 1800,       // 30 minutes
+      '/api/trending': 600,    // 10 minutes
+    },
+  },
+  rateLimit: {
+    enabled: true,
+    maxRequests: 100,
+    window: 60,
+  },
+  ai: {
+    enabled: true,
+    gateway: {
+      providers: [
+        {
+          id: 'workers-ai',
+          name: 'Workers AI',
+          type: 'workers-ai',
+          baseURL: '',
+          apiKey: '',
+          models: ['@cf/meta/llama-3.1-8b-instruct'],
+          weight: 2,
+        },
+      ],
+      cacheEnabled: true,
+      cacheTTL: 3600,
+      analytics: true,
+    },
+  },
+  workflows: {
+    enabled: true,
+    maxExecutionTime: 600,
+    defaultRetries: 3,
+  },
+};
+
+/**
+ * E-commerce App Configuration
+ */
+export const ecommerceConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 60, // 1 minute
+    paths: {
+      '/api/products': 300,     // 5 minutes
+      '/api/categories': 3600,  // 1 hour
+      '/api/cart': 0,           // No cache
+    },
+  },
+  rateLimit: {
+    enabled: true,
+    maxRequests: 200,
+    window: 60,
+  },
+  ai: {
+    enabled: false,
+  },
+  workflows: {
+    enabled: true,
+    maxExecutionTime: 300,
+    defaultRetries: 2,
+  },
+};
+
+/**
+ * SaaS App Configuration
+ */
+export const saasConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 300,
+    paths: {
+      '/api/subscriptions': 60,
+      '/api/pricing': 3600,
+      '/api/features': 3600,
+    },
+  },
+  rateLimit: {
+    enabled: true,
+    maxRequests: 50,
+    window: 60,
+  },
+  ai: {
+    enabled: true,
+  },
+  workflows: {
+    enabled: true,
+  },
+};
+
+/**
+ * API Gateway Configuration
+ */
+export const apiGatewayConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 60,
+  },
+  rateLimit: {
+    enabled: true,
+    maxRequests: 1000,
+    window: 60,
+  },
+  cors: {
+    enabled: true,
+    allowedOrigins: ['*'],
+    allowedMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+    allowedHeaders: ['*'],
+    maxAge: 86400,
+  },
+  analytics: {
+    enabled: true,
+  },
+};
+
+/**
+ * CDN Configuration
+ */
+export const cdnConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 86400, // 24 hours
+    paths: {
+      '/static/*': 86400,
+      '/assets/*': 86400,
+      '/images/*': 86400,
+    },
+  },
+  rateLimit: {
+    enabled: false,
+  },
+  compression: {
+    enabled: true,
+    types: ['text/*', 'application/json', 'application/javascript'],
+  },
+  imageOptimization: {
+    enabled: true,
+    formats: ['webp', 'avif'],
+    quality: 80,
+  },
+};
+
+/**
+ * AI-First App Configuration
+ */
+export const aiFirstConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: true,
+    defaultTTL: 300,
+  },
+  rateLimit: {
+    enabled: true,
+    maxRequests: 30,
+    window: 60,
+  },
+  ai: {
+    enabled: true,
+    gateway: {
+      providers: [
+        {
+          id: 'workers-ai',
+          name: 'Workers AI',
+          type: 'workers-ai',
+          baseURL: '',
+          apiKey: '',
+          models: ['@cf/meta/llama-3.1-8b-instruct'],
+          weight: 2,
+        },
+        {
+          id: 'openai',
+          name: 'OpenAI',
+          type: 'openai',
+          baseURL: 'https://api.openai.com/v1',
+          apiKey: '',
+          models: ['gpt-4', 'gpt-3.5-turbo'],
+          fallback: 'workers-ai',
+          weight: 1,
+        },
+      ],
+      cacheEnabled: true,
+      cacheTTL: 7200, // 2 hours
+      rateLimiting: true,
+      analytics: true,
+    },
+  },
+  workflows: {
+    enabled: true,
+  },
+};
+
+/**
+ * Minimal Configuration (development)
+ */
+export const minimalConfig: Partial<WorkerConfig> = {
+  cache: {
+    enabled: false,
+  },
+  rateLimit: {
+    enabled: false,
+  },
+  cors: {
+    enabled: true,
+    allowedOrigins: ['*'],
+  },
+};
+
+// ============================================================
+// Config Mergers
+// ============================================================
+
+/**
+ * Deep merge configs
+ */
+export function mergeConfigs<T extends Record<string, any>>(
+  base: T,
+  ...overrides: Partial<T>[]
+): T {
+  return overrides.reduce((acc, override) => {
+    return deepMerge(acc, override);
+  }, base);
+}
+
+function deepMerge<T>(target: T, source: Partial<T>): T {
+  const output = { ...target } as T;
+
+  if (isObject(target) && isObject(source)) {
+    Object.keys(source).forEach((key) => {
+      if (isObject(source[key as keyof T])) {
+        if (!(key in target)) {
+          Object.assign(output, { [key]: source[key as keyof T] });
+        } else {
+          (output as any)[key] = deepMerge(target[key as keyof T], source[key as keyof T]);
+        }
+      } else {
+        Object.assign(output, { [key]: source[key as keyof T] });
+      }
+    });
+  }
+
+  return output;
+}
+
+function isObject(item: unknown): item is Record<string, unknown> {
+  return Boolean(item && typeof item === 'object' && !Array.isArray(item));
+}
+
+// ============================================================
+// Config Validators
+// ============================================================
+
+/**
+ * Validate worker config
+ */
+export function validateConfig(config: WorkerConfig): {
+  valid: boolean;
+  errors: string[];
+} {
+  const errors: string[] = [];
+
+  // Validate cache
+  if (config.cache?.enabled && config.cache.defaultTTL < 0) {
+    errors.push('Cache defaultTTL must be >= 0');
+  }
+
+  // Validate rate limit
+  if (config.rateLimit?.enabled && config.rateLimit.maxRequests < 1) {
+    errors.push('Rate limit maxRequests must be >= 1');
+  }
+
+  // Validate AI
+  if (config.ai?.enabled && (!config.ai.gateway || config.ai.gateway.providers.length === 0)) {
+    errors.push('AI gateway must have at least one provider when enabled');
+  }
+
+  // Validate workflows
+  if (config.workflows?.enabled && config.workflows.maxExecutionTime < 1) {
+    errors.push('Workflow maxExecutionTime must be >= 1');
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}
+
+// ============================================================
+// Config Builders (Fluent API)
+// ============================================================
+
+export class ConfigBuilder {
+  private config: Partial<WorkerConfig> = {};
+
+  static create(): ConfigBuilder {
+    return new ConfigBuilder();
+  }
+
+  withCache(config: Partial<NonNullable<WorkerConfig['cache']>>): ConfigBuilder {
+    this.config.cache = { ...this.config.cache, ...config };
+    return this;
+  }
+
+  withRateLimit(config: Partial<NonNullable<WorkerConfig['rateLimit']>>): ConfigBuilder {
+    this.config.rateLimit = { ...this.config.rateLimit, ...config };
+    return this;
+  }
+
+  withAI(config: Partial<NonNullable<WorkerConfig['ai']>>): ConfigBuilder {
+    this.config.ai = { ...this.config.ai, ...config };
+    return this;
+  }
+
+  withWorkflows(config: Partial<NonNullable<WorkerConfig['workflows']>>): ConfigBuilder {
+    this.config.workflows = { ...this.config.workflows, ...config };
+    return this;
+  }
+
+  withCORS(config: Partial<NonNullable<WorkerConfig['cors']>>): ConfigBuilder {
+    this.config.cors = { ...this.config.cors, ...config };
+    return this;
+  }
+
+  withAnalytics(config: Partial<NonNullable<WorkerConfig['analytics']>>): ConfigBuilder {
+    this.config.analytics = { ...this.config.analytics, ...config };
+    return this;
+  }
+
+  withCompression(config: Partial<NonNullable<WorkerConfig['compression']>>): ConfigBuilder {
+    this.config.compression = { ...this.config.compression, ...config };
+    return this;
+  }
+
+  withImageOptimization(config: Partial<NonNullable<WorkerConfig['imageOptimization']>>): ConfigBuilder {
+    this.config.imageOptimization = { ...this.config.imageOptimization, ...config };
+    return this;
+  }
+
+  withQueues(config: Partial<NonNullable<WorkerConfig['queues']>>): ConfigBuilder {
+    this.config.queues = { ...this.config.queues, ...config };
+    return this;
+  }
+
+  withScheduledTasks(config: Partial<NonNullable<WorkerConfig['scheduledTasks']>>): ConfigBuilder {
+    this.config.scheduledTasks = { ...this.config.scheduledTasks, ...config };
+    return this;
+  }
+
+  build(): Partial<WorkerConfig> {
+    return this.config;
+  }
+}
+
+// ============================================================
+// Environment-based Config Loader
+// ============================================================
+
+export interface EnvironmentConfig {
+  environment: 'development' | 'staging' | 'production';
+  envVars: Record<string, string>;
+}
+
+/**
+ * Load config from environment variables
+ */
+export function loadConfigFromEnv(
+  env: Record<string, string | undefined>
+): Partial<WorkerConfig> {
+  const config: Partial<WorkerConfig> = {};
+
+  // Cache
+  if (env.CF_CACHE_ENABLED === 'true') {
+    config.cache = {
+      enabled: true,
+      defaultTTL: parseInt(env.CF_CACHE_DEFAULT_TTL || '300', 10),
+    };
+  }
+
+  // Rate Limit
+  if (env.CF_RATE_LIMIT_ENABLED === 'true') {
+    config.rateLimit = {
+      enabled: true,
+      maxRequests: parseInt(env.CF_RATE_LIMIT_MAX || '100', 10),
+      window: parseInt(env.CF_RATE_LIMIT_WINDOW || '60', 10),
+    };
+  }
+
+  // AI
+  if (env.CF_AI_ENABLED === 'true') {
+    config.ai = {
+      enabled: true,
+      gateway: {
+        gatewayId: env.CF_AI_GATEWAY_ID || 'default',
+        providers: JSON.parse(env.CF_AI_PROVIDERS || '[]'),
+        cacheEnabled: env.CF_AI_CACHE_ENABLED === 'true',
+        cacheTTL: parseInt(env.CF_AI_CACHE_TTL || '3600', 10),
+      },
+    };
+  }
+
+  // Workflows
+  if (env.CF_WORKFLOWS_ENABLED === 'true') {
+    config.workflows = {
+      enabled: true,
+      maxExecutionTime: parseInt(env.CF_WORKFLOWS_MAX_TIME || '600', 10),
+      defaultRetries: parseInt(env.CF_WORKFLOWS_RETRIES || '3', 10),
+    };
+  }
+
+  // CORS
+  if (env.CF_CORS_ENABLED === 'true') {
+    config.cors = {
+      enabled: true,
+      allowedOrigins: env.CF_CORS_ORIGINS?.split(',') || ['*'],
+      allowedMethods: env.CF_CORS_METHODS?.split(',') || ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+      allowedHeaders: env.CF_CORS_HEADERS?.split(',') || ['*'],
+      maxAge: parseInt(env.CF_CORS_MAX_AGE || '86400', 10),
+    };
+  }
+
+  return config;
+}
+
+/**
+ * Get environment-specific config
+ */
+export function getEnvironmentConfig(
+  environment: 'development' | 'staging' | 'production'
+): Partial<WorkerConfig> {
+  switch (environment) {
+    case 'development':
+      return mergeConfigs(minimalConfig, {
+        cache: { enabled: false },
+        rateLimit: { enabled: false },
+        cors: { allowedOrigins: ['*'] },
+      });
+
+    case 'staging':
+      return mergeConfigs(socialMediaConfig, {
+        cache: { defaultTTL: 60 },
+        rateLimit: { maxRequests: 200 },
+      });
+
+    case 'production':
+      return socialMediaConfig;
+
+    default:
+      return minimalConfig;
+  }
+}