@umituz/web-cloudflare 1.0.1

package/src/domain/entities/image.entity.ts

@@ -0,0 +1,48 @@
+/**
+ * Image Entity
+ * @description Cloudflare Images configuration and types
+ */
+
+export interface ImageConfig {
+  readonly account: string;
+  readonly customDomain?: string;
+}
+
+export interface ImageVariant {
+  readonly variant: string;
+  readonly width?: number;
+  readonly height?: number;
+  readonly fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  readonly format?: "jpeg" | "png" | "gif" | "webp" | "avif";
+  readonly quality?: number;
+}
+
+export interface ImageUploadResult {
+  readonly id: string;
+  readonly filename: string;
+  readonly uploaded: Date;
+  readonly variants: readonly string[];
+  readonly requireSignedURLs: boolean;
+}
+
+export interface ImageUploadOptions {
+  readonly metadata?: Record<string, string>;
+  readonly requireSignedURLs?: boolean;
+  readonly variants?: readonly ImageVariant[];
+}
+
+export interface ImageTransformation {
+  readonly width?: number;
+  readonly height?: number;
+  readonly fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  readonly format?: "jpeg" | "png" | "gif" | "webp" | "avif";
+  readonly quality?: number;
+  readonly rotate?: number;
+  readonly flip?: boolean;
+  readonly flop?: boolean;
+}
+
+export interface SignedURL {
+  readonly url: string;
+  readonly expiresAt: Date;
+}

package/src/domain/entities/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Cloudflare Domain Entities
+ * Subpath: @umituz/web-cloudflare/domain
+ */
+
+export type { WorkerConfig, WorkerResponse, WorkerRequest } from "./worker.entity";
+export type { KVNamespaceConfig, KVEntry } from "./kv.entity";
+export type { R2BucketConfig, R2Object, R2UploadResult } from "./r2.entity";
+export type { D1DatabaseConfig, D1QueryResult } from "./d1.entity";
+export type { ImageConfig, ImageVariant } from "./image.entity";
+export type { AnalyticsConfig, AnalyticsEvent } from "./analytics.entity";

package/src/domain/entities/kv.entity.ts

@@ -0,0 +1,34 @@
+/**
+ * KV Entity
+ * @description Cloudflare KV configuration and types
+ */
+
+export interface KVNamespaceConfig {
+  readonly namespace: string;
+  readonly ttl?: number;
+}
+
+export interface KVEntry<T = unknown> {
+  readonly key: string;
+  readonly value: T;
+  readonly metadata?: Record<string, unknown>;
+  readonly expiration?: number;
+}
+
+export interface KVListOptions {
+  readonly limit?: number;
+  readonly cursor?: string;
+  readonly prefix?: string;
+}
+
+export interface KVListResult {
+  readonly keys: readonly KVKey[];
+  readonly list_complete: boolean;
+  readonly cursor?: string;
+}
+
+export interface KVKey {
+  readonly name: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly expiration?: number;
+}

package/src/domain/entities/r2.entity.ts

@@ -0,0 +1,55 @@
+/**
+ * R2 Entity
+ * @description Cloudflare R2 storage configuration and types
+ */
+
+export interface R2BucketConfig {
+  readonly bucket: string;
+  readonly customDomain?: string;
+}
+
+export interface R2Object {
+  readonly key: string;
+  readonly size: number;
+  readonly uploaded: Date;
+  readonly httpMetadata?: R2HTTPMetadata;
+  readonly customMetadata?: Record<string, string>;
+}
+
+export interface R2HTTPMetadata {
+  readonly contentType?: string;
+  readonly cacheControl?: string;
+  readonly contentEncoding?: string;
+  readonly contentLanguage?: string;
+  readonly cacheExpiry?: Date;
+}
+
+export interface R2UploadResult {
+  readonly key: string;
+  readonly size: number;
+  readonly etag?: string;
+  readonly version?: string;
+}
+
+export interface R2ListOptions {
+  readonly limit?: number;
+  readonly prefix?: string;
+  readonly cursor?: string;
+}
+
+export interface R2ListResult {
+  readonly objects: readonly R2Object[];
+  readonly truncated: boolean;
+  readonly cursor?: string;
+}
+
+export interface R2PutOptions {
+  readonly httpMetadata?: R2HTTPMetadata;
+  readonly customMetadata?: Record<string, string>;
+  readonly checksum?: string;
+}
+
+export interface R2PresignedURL {
+  readonly url: string;
+  readonly expiresAt: Date;
+}

package/src/domain/entities/worker.entity.ts

@@ -0,0 +1,35 @@
+/**
+ * Worker Entity
+ * @description Cloudflare Worker configuration and types
+ */
+
+export interface WorkerRequest extends Request {
+  cf?: IncomingRequestCfProperties;
+}
+
+export interface WorkerResponse extends Response {
+  waitUntil?: (promise: Promise<unknown>) => void;
+}
+
+export interface WorkerConfig {
+  readonly name: string;
+  readonly routes?: string[];
+  readonly schedule?: string;
+  readonly bindings?: WorkerBindings;
+}
+
+export interface WorkerBindings {
+  readonly kv?: Record<string, KVNamespace>;
+  readonly r2?: Record<string, R2Bucket>;
+  readonly d1?: Record<string, D1Database>;
+  readonly env?: Record<string, string>;
+}
+
+export interface IncomingRequestCfProperties {
+  readonly colo?: string;
+  readonly country?: string;
+  readonly httpProtocol?: string;
+  readonly requestPriority?: string;
+  readonly tlsVersion?: string;
+  readonly tlsCipher?: string;
+}

package/src/domain/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Domain Layer
+ * Subpath: @umituz/web-cloudflare/domain
+ */
+
+export * from "./entities";
+export * from "./interfaces";

package/src/domain/interfaces/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Cloudflare Domain Interfaces
+ * Subpath: @umituz/web-cloudflare/domain
+ */
+
+export type { IWorkerService, IKVService, IR2Service, ID1Service, IImageService, IAnalyticsService } from "./services.interface";

package/src/domain/interfaces/services.interface.ts

@@ -0,0 +1,82 @@
+/**
+ * Service Interfaces
+ * @description Abstract interfaces for Cloudflare services
+ */
+
+import type { WorkerRequest, WorkerResponse } from "../entities/worker.entity";
+import type { KVEntry, KVListOptions, KVListResult } from "../entities/kv.entity";
+import type { R2Object, R2ListOptions, R2ListResult, R2PutOptions, R2PresignedURL } from "../entities/r2.entity";
+import type { D1QueryResult, D1BatchResult } from "../entities/d1.entity";
+import type { ImageUploadResult, ImageUploadOptions, ImageTransformation, SignedURL } from "../entities/image.entity";
+import type { AnalyticsEvent, AnalyticsData } from "../entities/analytics.entity";
+
+/**
+ * Worker Service Interface
+ */
+export interface IWorkerService {
+  fetch(request: WorkerRequest, env?: Env): Promise<WorkerResponse>;
+  scheduled(event: ScheduledEvent, env?: Env): Promise<void>;
+}
+
+/**
+ * KV Service Interface
+ */
+export interface IKVService {
+  get<T>(key: string): Promise<T | null>;
+  put<T>(key: string, value: T, options?: { ttl?: number }): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  list(options?: KVListOptions): Promise<KVListResult>;
+}
+
+/**
+ * R2 Service Interface
+ */
+export interface IR2Service {
+  get(key: string): Promise<R2Object | null>;
+  put(key: string, data: ReadableStream | ArrayBuffer | string, options?: R2PutOptions): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  list(options?: R2ListOptions): Promise<R2ListResult>;
+  getPresignedURL(key: string, expiresIn?: number): Promise<R2PresignedURL>;
+}
+
+/**
+ * D1 Service Interface
+ */
+export interface ID1Service {
+  query<T>(sql: string, params?: readonly unknown[]): Promise<D1QueryResult<T>>;
+  batch(statements: readonly { sql: string; params?: readonly unknown[] }[]): Promise<D1BatchResult>;
+  execute<T>(sql: string, params?: readonly unknown[]): Promise<D1QueryResult<T>>;
+}
+
+/**
+ * Image Service Interface
+ */
+export interface IImageService {
+  upload(file: File | Blob, options?: ImageUploadOptions): Promise<ImageUploadResult>;
+  getSignedURL(imageId: string, expiresIn?: number): Promise<SignedURL>;
+  getTransformedURL(imageId: string, transform: ImageTransformation): Promise<string>;
+  delete(imageId: string): Promise<boolean>;
+}
+
+/**
+ * Analytics Service Interface
+ */
+export interface IAnalyticsService {
+  trackEvent(event: AnalyticsEvent): Promise<void>;
+  trackPageview(url: string, title: string, referrer?: string): Promise<void>;
+  getAnalytics(): Promise<AnalyticsData>;
+}
+
+/**
+ * Environment types
+ */
+export interface Env {
+  readonly KV?: Record<string, KVNamespace>;
+  readonly R2?: Record<string, R2Bucket>;
+  readonly D1?: Record<string, D1Database>;
+}
+
+export interface ScheduledEvent {
+  readonly scheduledTime: number;
+  readonly cron: string;
+}

package/src/index.ts

@@ -0,0 +1,53 @@
+/**
+ * @umituz/web-cloudflare
+ * Comprehensive Cloudflare Workers integration with config-based patterns
+ *
+ * ONEMLI: App'ler bu root barrel'i kullanMAMALI.
+ * Subpath import kullanin: "@umituz/web-cloudflare/workers"
+ *
+ * Available subpath exports:
+ * - ./workers - Workers service
+ * - ./kv - KV cache service
+ * - ./r2 - R2 storage service
+ * - ./d1 - D1 database service
+ * - ./images - Images optimization service
+ * - ./analytics - Analytics service
+ * - ./workflows - Workflows orchestration service
+ * - ./ai-gateway - AI Gateway service
+ * - ./workers-ai - Workers AI service
+ * - ./router - Express-like router
+ * - ./middleware - Middleware collection
+ * - ./utils - Utility helpers
+ * - ./helpers - Helper functions (alias for ./utils)
+ * - ./config - Configuration patterns
+ * - ./patterns - Configuration patterns (alias for ./config)
+ * - ./types - TypeScript types
+ * - ./domain - Domain entities
+ */
+
+// Domain entities
+export * from "./domain/entities";
+export * from "./domain/interfaces";
+
+// Infrastructure services
+export * from "./infrastructure/services/workers";
+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";
+export * from "./infrastructure/middleware";
+export * from "./infrastructure/utils/helpers";
+export * from "./infrastructure/constants";
+
+// Config - Patterns and Types
+export * from "./config/patterns";
+export * from "./config/types";
+
+// Presentation hooks
+export * from "./presentation/hooks";

package/src/infrastructure/constants/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Cloudflare Constants
+ * Subpath: @umituz/web-cloudflare/infrastructure
+ */
+
+export const DEFAULT_TTL = 3600; // 1 hour in seconds
+export const MAX_CACHE_AGE = 5184000; // 60 days in seconds
+export const DEFAULT_KV_LIMIT = 1000;
+export const DEFAULT_R2_UPLOAD_TIMEOUT = 30000; // 30 seconds
+export const DEFAULT_SIGNED_URL_EXPIRATION = 3600; // 1 hour
+export const MAX_IMAGE_SIZE = 10 * 1024 * 1024; // 10MB
+export const ALLOWED_IMAGE_TYPES = ["image/jpeg", "image/png", "image/gif", "image/webp", "image/avif"] as const;
+export const CLOUDFLARE_API_ENDPOINT = "https://api.cloudflare.com/client/v4";

package/src/infrastructure/domain/ai-gateway.entity.ts

@@ -0,0 +1,169 @@
+/**
+ * Cloudflare AI Gateway Domain Entity
+ * @description AI Gateway for routing, caching, and analytics
+ */
+
+export interface AIGatewayConfig {
+  gatewayId: string;
+  providers: AIProvider[];
+  cacheEnabled?: boolean;
+  cacheTTL?: number; // seconds
+  rateLimiting?: boolean;
+  analytics?: boolean;
+}
+
+export interface AIProvider {
+  id: string;
+  name: string;
+  type: 'workers-ai' | 'openai' | 'anthropic' | 'cohere' | 'custom';
+  baseURL: string;
+  apiKey: string;
+  models: string[];
+  fallbackProvider?: string;
+  weight?: number; // For load balancing
+}
+
+export interface AIRequest {
+  provider: string;
+  model: string;
+  prompt: string;
+  parameters?: AIParameters;
+  stream?: boolean;
+  cacheKey?: string;
+}
+
+export interface AIParameters {
+  temperature?: number;
+  maxTokens?: number;
+  topP?: number;
+  topK?: number;
+  stopSequences?: string[];
+  responseFormat?: 'text' | 'json' | 'json_object';
+  metadata?: Record<string, unknown>;
+}
+
+export interface AIResponse {
+  id: string;
+  provider: string;
+  model: string;
+  content: string;
+  usage: {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+  };
+  cached: boolean;
+  timestamp: number;
+}
+
+export interface AIAnalytics {
+  totalRequests: number;
+  totalTokens: number;
+  cacheHitRate: number;
+  averageResponseTime: number;
+  providerUsage: Record<string, number>;
+  errorRate: number;
+}
+
+// Workers AI specific models
+export interface WorkersAIModel {
+  id: string;
+  name: string;
+  type: 'text-generation' | 'image-generation' | 'embedding' | 'translation' | 'classification';
+  contextWindow?: number;
+  pricing?: {
+    inputPrice: number; // per 1M tokens
+    outputPrice: number; // per 1M tokens
+  };
+}
+
+export interface WorkersAIRequest {
+  model: string;
+  inputs: WorkersAIInputs;
+}
+
+export interface WorkersAIInputs {
+  text_generation?: {
+    prompt: string;
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    stop_sequences?: string[];
+  };
+  image_generation?: {
+    prompt: string;
+    width?: number;
+    height?: number;
+    steps?: number;
+    seed?: number;
+  };
+  embedding?: {
+    text: string;
+    model?: string;
+  };
+  translation?: {
+    text: string;
+    source_lang: string;
+    target_lang: string;
+  };
+}
+
+export interface WorkersAIResponse {
+  success: boolean;
+  data?: {
+    output?: string | string[];
+    embedding?: number[];
+    image?: string; // base64
+  };
+  error?: string;
+  model: string;
+}
+
+// Available Workers AI models
+export const WORKERS_AI_MODELS: Record<string, WorkersAIModel> = {
+  '@cf/meta/llama-3.1-8b-instruct': {
+    id: '@cf/meta/llama-3.1-8b-instruct',
+    name: 'Llama 3.1 8B Instruct',
+    type: 'text-generation',
+    contextWindow: 128000,
+  },
+  '@cf/mistral/mistral-7b-instruct': {
+    id: '@cf/mistral/mistral-7b-instruct',
+    name: 'Mistral 7B Instruct',
+    type: 'text-generation',
+    contextWindow: 8192,
+  },
+  '@cf/qwen/qwen2-7b-instruct': {
+    id: '@cf/qwen/qwen2-7b-instruct',
+    name: 'Qwen2 7B Instruct',
+    type: 'text-generation',
+    contextWindow: 32768,
+  },
+  '@cf/google/deeplab-v3-plus': {
+    id: '@cf/google/deeplab-v3-plus',
+    name: 'DeepLab V3+',
+    type: 'classification',
+  },
+  '@cf/openai/clip-vit-base-patch32': {
+    id: '@cf/openai/clip-vit-base-patch32',
+    name: 'CLIP ViT Base',
+    type: 'embedding',
+  },
+};
+
+// Emotion control for script generation (from voice cloning app)
+export interface EmotionControl {
+  emotion: 'neutral' | 'happy' | 'sad' | 'angry' | 'excited' | 'calm' | 'surprised';
+  intensity: number; // 0-1
+}
+
+export interface ScriptGenerationRequest {
+  topic: string;
+  emotion: EmotionControl;
+  duration: number; // seconds
+  style?: 'formal' | 'casual' | 'enthusiastic' | 'professional';
+  keywords?: string[];
+}

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

@@ -0,0 +1,108 @@
+/**
+ * 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[];
+  };
+}