@umituz/web-cloudflare 1.3.0 → 1.4.0

package/README.md

@@ -5,12 +5,14 @@ Comprehensive Cloudflare Workers integration with config-based patterns, middlew
 ## 🚀 Features
 
 - ✅ **Config-Based Patterns** - Pre-built configurations for different app types
+- ✅ **Domain-Driven Design** - DDD architecture for better modularity
 - ✅ **Wrangler CLI Integration** - TypeScript wrapper for Wrangler CLI commands
+- ✅ **Workers Service** - HTTP handler with routing and middleware
+- ✅ **AI Gateway** - Multi-provider AI routing with caching and fallback
+- ✅ **Workers AI Integration** - AI content generation with emotion control
 - ✅ **Express-like Router** - Simple, intuitive routing with middleware support
 - ✅ **Comprehensive Middleware** - CORS, caching, rate limiting, security, compression
-- ✅ **Workers AI Integration** - AI content generation with emotion control
 - ✅ **Workflows** - Idempotent, retryable long-running operations
-- ✅ **AI Gateway** - Multi-provider AI routing with caching and fallback
 - ✅ **Utility Functions** - 100+ helper functions for common tasks
 - ✅ **Type-Safe** - Full TypeScript support
 - ✅ **Tree-Shakeable** - Subpath exports for optimal bundle size
@@ -175,7 +177,7 @@ const versions = await wrangler.versionsList();
 await wrangler.versionsRollback(versions[0].id);
 ```
 
-**Note:** Wrangler CLI and Workers services now follow Domain-Driven Design (DDD) architecture with their own domain structures at `src/domains/wrangler/` and `src/domains/workers/`.
+**Note:** Wrangler CLI, Workers, and AI Gateway services now follow Domain-Driven Design (DDD) architecture with their own domain structures at `src/domains/wrangler/`, `src/domains/workers/`, and `src/domains/ai-gateway/`.
 
 ## 📚 Subpath Exports
 
@@ -210,10 +212,10 @@ import { WranglerService } from '@umituz/web-cloudflare/wrangler';
 // Workflows orchestration
 import { WorkflowService, WORKFLOW_TEMPLATES } from '@umituz/web-cloudflare/workflows';
 
-// AI Gateway
+// AI Gateway (now in domains/)
 import { AIGatewayService } from '@umituz/web-cloudflare/ai-gateway';
 
-// Workers AI
+// Workers AI (now in domains/)
 import { WorkersAIService } from '@umituz/web-cloudflare/workers-ai';
 ```
 
@@ -654,10 +656,14 @@ Contributions are welcome!
 │   │   │   ├── services/    # Domain services
 │   │   │   ├── types/       # Domain types
 │   │   │   └── index.ts     # Domain exports
-│   │   └── workers/         # Workers domain
+│   │   ├── workers/         # Workers domain
+│   │   │   ├── entities/    # Domain entities
+│   │   │   ├── services/    # Domain services
+│   │   │   ├── types/       # Domain types
+│   │   │   └── index.ts     # Domain exports
+│   │   └── ai-gateway/      # AI Gateway domain
 │   │       ├── entities/    # Domain entities
 │   │       ├── services/    # Domain services
-│   │       ├── types/       # Domain types
 │   │       └── index.ts     # Domain exports
 │   ├── infrastructure/
 │   │   ├── services/        # Services (kv, r2, d1, etc.)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-cloudflare",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -14,8 +14,8 @@
     "./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",
+    "./ai-gateway": "./src/domains/ai-gateway/index.ts",
+    "./workers-ai": "./src/domains/ai-gateway/index.ts",
     "./wrangler": "./src/domains/wrangler/index.ts",
     "./router": "./src/infrastructure/router/index.ts",
     "./middleware": "./src/infrastructure/middleware/index.ts",

package/src/domains/ai-gateway/index.ts

@@ -0,0 +1,10 @@
+/**
+ * AI Gateway Domain
+ * Complete AI Gateway integration with multi-provider routing, caching, and Workers AI
+ */
+
+// Entities
+export * from './entities';
+
+// Services
+export * from './services';

package/src/{infrastructure/services/ai-gateway → domains/ai-gateway/services}/index.ts

@@ -9,7 +9,7 @@ import type {
   AIResponse,
   AIProvider,
   AIAnalytics,
-} from '../../domain/ai-gateway.entity';
+} from '../entities';
 
 export class AIGatewayService {
   private config: AIGatewayConfig;
@@ -211,7 +211,7 @@ import type {
   WorkersAIInputs,
   ScriptGenerationRequest,
   EmotionControl,
-} from '../../domain/ai-gateway.entity';
+} from '../entities';
 
 export class WorkersAIService {
   private env: {

package/src/index.ts

@@ -28,13 +28,13 @@
 // Domains
 export * from "./domains/wrangler";
 export * from "./domains/workers";
+export * from "./domains/ai-gateway";
 export * from "./infrastructure/services/kv";
 export * from "./infrastructure/services/r2";
 export * from "./infrastructure/services/d1";
 export * from "./infrastructure/services/images";
 export * from "./infrastructure/services/analytics";
 export * from "./infrastructure/services/workflows";
-export * from "./infrastructure/services/ai-gateway";
 
 // Infrastructure - Router, Middleware, Utils
 export * from "./infrastructure/router";

package/src/infrastructure/domain/workflows.entity.ts

@@ -1,108 +0,0 @@
-/**
- * Cloudflare Workflows Domain Entity
- * @description Workflow types for long-running, retryable operations
- */
-
-export interface WorkflowDefinition {
-  id: string;
-  name: string;
-  description: string;
-  version: string;
-  steps: WorkflowStep[];
-  retryConfig?: RetryConfig;
-  timeout?: number; // seconds
-}
-
-export interface WorkflowStep {
-  id: string;
-  name: string;
-  handler: string; // Function name to execute
-  inputs?: Record<string, unknown>;
-  outputs?: Record<string, unknown>;
-  retryPolicy?: StepRetryPolicy;
-  timeout?: number; // seconds
-  dependencies?: string[]; // Step IDs that must complete first
-}
-
-export interface StepRetryPolicy {
-  maxAttempts: number;
-  backoffMultiplier: number;
-  initialDelay: number; // milliseconds
-  maxDelay: number; // milliseconds
-}
-
-export interface RetryConfig {
-  maxRetries: number;
-  backoffMultiplier: number;
-  initialDelay: number;
-  maxDelay: number;
-}
-
-export interface WorkflowExecution {
-  id: string;
-  workflowId: string;
-  status: 'pending' | 'running' | 'completed' | 'failed' | 'retrying';
-  currentStep?: string;
-  completedSteps: string[];
-  failedSteps: string[];
-  inputs: Record<string, unknown>;
-  outputs?: Record<string, unknown>;
-  error?: string;
-  startedAt: number;
-  completedAt?: number;
-  retryCount: number;
-}
-
-export interface WorkflowInstanceState {
-  executionId: string;
-  stepId: string;
-  data: Record<string, unknown>;
-  timestamp: number;
-}
-
-// Predefined workflow templates
-export interface WorkflowTemplate {
-  type: 'media-processing' | 'batch-operations' | 'ai-generation' | 'scheduled-tasks';
-  definition: Partial<WorkflowDefinition>;
-}
-
-export interface MediaProcessingWorkflow {
-  inputs: {
-    mediaUrl: string;
-    operations: Array<{
-      type: 'transcode' | 'optimize' | 'thumbnail' | 'analyze';
-      params?: Record<string, unknown>;
-    }>;
-  };
-  outputs: {
-    processedUrls: string[];
-    metadata?: Record<string, unknown>;
-  };
-}
-
-export interface AIGenerationWorkflow {
-  inputs: {
-    prompt: string;
-    model: string;
-    parameters?: Record<string, unknown>;
-  };
-  outputs: {
-    result: string;
-    tokens: number;
-    model: string;
-  };
-}
-
-export interface BatchOperationWorkflow {
-  inputs: {
-    operation: string;
-    items: unknown[];
-    batchSize?: number;
-    parallelism?: number;
-  };
-  outputs: {
-    successful: number;
-    failed: number;
-    results: unknown[];
-  };
-}