@umituz/web-cloudflare 1.4.2 → 1.4.4

package/README.md

@@ -177,7 +177,16 @@ const versions = await wrangler.versionsList();
 await wrangler.versionsRollback(versions[0].id);
 ```
 
-**Note:** Wrangler CLI, Workers, AI Gateway, and R2 services now follow Domain-Driven Design (DDD) architecture with their own domain structures at `src/domains/wrangler/`, `src/domains/workers/`, `src/domains/ai-gateway/`, and `src/domains/r2/`.
+**Note:** All services now follow Domain-Driven Design (DDD) architecture with their own domain structures:
+- Wrangler CLI: `src/domains/wrangler/`
+- Workers: `src/domains/workers/`
+- AI Gateway: `src/domains/ai-gateway/`
+- R2: `src/domains/r2/`
+- D1: `src/domains/d1/`
+- KV: `src/domains/kv/`
+- Images: `src/domains/images/`
+- Analytics: `src/domains/analytics/`
+- Workflows: `src/domains/workflows/`
 
 ## 📚 Subpath Exports
 
@@ -187,20 +196,23 @@ await wrangler.versionsRollback(versions[0].id);
 // Workers service (now in domains/)
 import { WorkersService, workersService } from '@umituz/web-cloudflare/workers';
 
-// KV cache
-import { KVService } from '@umituz/web-cloudflare/kv';
+// KV cache (now in domains/)
+import { KVService, kvService } from '@umituz/web-cloudflare/kv';
 
 // R2 storage (now in domains/)
 import { R2Service, r2Service } from '@umituz/web-cloudflare/r2';
 
-// D1 database
-import { D1Service } from '@umituz/web-cloudflare/d1';
+// D1 database (now in domains/)
+import { D1Service, d1Service } from '@umituz/web-cloudflare/d1';
 
-// Images optimization
-import { ImagesService } from '@umituz/web-cloudflare/images';
+// Images optimization (now in domains/)
+import { ImagesService, imagesService } from '@umituz/web-cloudflare/images';
 
-// Analytics
-import { AnalyticsService } from '@umituz/web-cloudflare/analytics';
+// Analytics (now in domains/)
+import { AnalyticsService, analyticsService } from '@umituz/web-cloudflare/analytics';
+
+// Workflows (now in domains/)
+import { WorkflowService } from '@umituz/web-cloudflare/workflows';
 
 // Wrangler CLI
 import { WranglerService } from '@umituz/web-cloudflare/wrangler';
@@ -661,27 +673,15 @@ Contributions are welcome!
 │   ├── config/              # Config patterns and types
 │   ├── domains/             # Domain-driven design structure
 │   │   ├── wrangler/        # Wrangler CLI domain
-│   │   │   ├── entities/    # Domain entities
-│   │   │   ├── services/    # Domain services
-│   │   │   ├── types/       # Domain types
-│   │   │   └── index.ts     # Domain exports
 │   │   ├── workers/         # Workers domain
-│   │   │   ├── entities/    # Domain entities
-│   │   │   ├── services/    # Domain services
-│   │   │   ├── types/       # Domain types
-│   │   │   ├── examples/    # Example files
-│   │   │   └── index.ts     # Domain exports
 │   │   ├── ai-gateway/      # AI Gateway domain
-│   │   │   ├── entities/    # Domain entities
-│   │   │   ├── services/    # Domain services
-│   │   │   └── index.ts     # Domain exports
-│   │   └── r2/              # R2 storage domain
-│   │       ├── entities/    # Domain entities
-│   │       ├── services/    # Domain services
-│   │       ├── types/       # Domain types
-│   │       └── index.ts     # Domain exports
+│   │   ├── r2/              # R2 storage domain
+│   │   ├── d1/              # D1 database domain
+│   │   ├── kv/              # KV storage domain
+│   │   ├── images/          # Images optimization domain
+│   │   ├── analytics/       # Analytics domain
+│   │   └── workflows/       # Workflows domain
 │   ├── infrastructure/
-│   │   ├── services/        # Services (kv, d1, etc.)
 │   │   ├── router/          # Express-like router
 │   │   ├── middleware/      # Middleware collection
 │   │   └── utils/           # Helper functions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/web-cloudflare",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI (Patch-only versioning: only z in x.y.z increments)",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -8,12 +8,12 @@
   "exports": {
     ".": "./src/index.ts",
     "./workers": "./src/domains/workers/index.ts",
-    "./kv": "./src/infrastructure/services/kv/index.ts",
+    "./kv": "./src/domains/kv/index.ts",
     "./r2": "./src/domains/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",
+    "./d1": "./src/domains/d1/index.ts",
+    "./images": "./src/domains/images/index.ts",
+    "./analytics": "./src/domains/analytics/index.ts",
+    "./workflows": "./src/domains/workflows/index.ts",
     "./ai-gateway": "./src/domains/ai-gateway/index.ts",
     "./workers-ai": "./src/domains/ai-gateway/index.ts",
     "./wrangler": "./src/domains/wrangler/index.ts",

package/src/domains/analytics/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Analytics Domain
+ * Complete Cloudflare Analytics integration
+ */
+
+// Entities
+export * from './entities';
+
+// Types
+export * from './types';
+
+// Services
+export * from './services';

package/src/{infrastructure/services/analytics → domains/analytics/services}/analytics.service.ts

@@ -3,7 +3,7 @@
  * @description Cloudflare Web Analytics operations
  */
 
-import type { AnalyticsEvent, AnalyticsPageviewEvent, AnalyticsCustomEvent, AnalyticsData } from "../../../domain/entities/analytics.entity";
+import type { AnalyticsEvent, AnalyticsPageviewEvent, AnalyticsCustomEvent, AnalyticsData } from "../entities";
 import type { IAnalyticsService } from "../../../domain/interfaces/services.interface";
 
 export interface AnalyticsClientOptions {

package/src/{infrastructure/services/analytics → domains/analytics/services}/index.ts

@@ -5,3 +5,4 @@
 
 export { AnalyticsService, analyticsService } from "./analytics.service";
 export type { AnalyticsClientOptions } from "./analytics.service";
+export type { IAnalyticsService } from '../types';

package/src/domains/analytics/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Analytics Domain Types
+ */
+
+export * from './service.interface';

package/src/domains/analytics/types/service.interface.ts

@@ -0,0 +1,12 @@
+/**
+ * Analytics Service Interface
+ * @description Abstract interface for Analytics operations
+ */
+
+import type { AnalyticsEvent, AnalyticsData } from '../entities';
+
+export interface IAnalyticsService {
+  trackEvent(event: AnalyticsEvent): Promise<void>;
+  trackPageview(url: string, title: string, referrer?: string): Promise<void>;
+  getAnalytics(): Promise<AnalyticsData>;
+}

package/src/domains/d1/index.ts

@@ -0,0 +1,13 @@
+/**
+ * D1 Domain
+ * Complete Cloudflare D1 database integration
+ */
+
+// Entities
+export * from './entities';
+
+// Types
+export * from './types';
+
+// Services
+export * from './services';

package/src/{infrastructure/services/d1 → domains/d1/services}/d1.service.ts

@@ -3,7 +3,7 @@
  * @description Cloudflare D1 database operations
  */
 
-import type { D1QueryResult, D1BatchResult } from "../../../domain/entities/d1.entity";
+import type { D1QueryResult, D1BatchResult } from "../entities";
 import type { ID1Service } from "../../../domain/interfaces/services.interface";
 
 export interface D1ExecOptions {

package/src/{infrastructure/services/d1 → domains/d1/services}/index.ts

@@ -5,3 +5,4 @@
 
 export { D1Service, d1Service } from "./d1.service";
 export type { D1ExecOptions } from "./d1.service";
+export type { ID1Service } from '../types';

package/src/domains/d1/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * D1 Domain Types
+ */
+
+export * from './service.interface';

package/src/domains/d1/types/service.interface.ts

@@ -0,0 +1,12 @@
+/**
+ * D1 Service Interface
+ * @description Abstract interface for D1 database operations
+ */
+
+import type { D1QueryResult, D1BatchResult } from '../entities';
+
+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>>;
+}

package/src/domains/images/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Images Domain
+ * Complete Cloudflare Images integration
+ */
+
+// Entities
+export * from './entities';
+
+// Types
+export * from './types';
+
+// Services
+export * from './services';

package/src/{infrastructure/services/images → domains/images/services}/images.service.ts

@@ -3,10 +3,10 @@
  * @description Cloudflare Images operations
  */
 
-import type { ImageUploadResult, ImageUploadOptions, ImageTransformation, SignedURL } from "../../../domain/entities/image.entity";
+import type { ImageUploadResult, ImageUploadOptions, ImageTransformation, SignedURL } from "../entities";
 import type { IImageService } from "../../../domain/interfaces/services.interface";
-import { validationUtils, transformUtils } from "../../utils";
-import { MAX_IMAGE_SIZE, ALLOWED_IMAGE_TYPES } from "../../constants";
+import { validationUtils, transformUtils } from "../../../infrastructure/utils";
+import { MAX_IMAGE_SIZE, ALLOWED_IMAGE_TYPES } from "../../../infrastructure/constants";
 
 export interface ImagesClientOptions {
   readonly accountId: string;

package/src/{infrastructure/services/images → domains/images/services}/index.ts

@@ -5,3 +5,4 @@
 
 export { ImagesService, imagesService } from "./images.service";
 export type { ImagesClientOptions } from "./images.service";
+export type { IImageService } from '../types';

package/src/domains/images/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Images Domain Types
+ */
+
+export * from './service.interface';

package/src/domains/images/types/service.interface.ts

@@ -0,0 +1,13 @@
+/**
+ * Images Service Interface
+ * @description Abstract interface for Images operations
+ */
+
+import type { ImageUploadResult, ImageUploadOptions, SignedURL, ImageTransformation } from '../entities';
+
+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>;
+}

package/src/domains/kv/index.ts

@@ -0,0 +1,13 @@
+/**
+ * KV Domain
+ * Complete Cloudflare KV key-value storage integration
+ */
+
+// Entities
+export * from './entities';
+
+// Types
+export * from './types';
+
+// Services
+export * from './services';

package/src/{infrastructure/services/kv → domains/kv/services}/index.ts

@@ -5,3 +5,4 @@
 
 export { KVService, kvService } from "./kv.service";
 export type { KVCacheOptions } from "./kv.service";
+export type { IKVService } from '../types';

package/src/{infrastructure/services/kv → domains/kv/services}/kv.service.ts

@@ -3,9 +3,9 @@
  * @description Cloudflare KV key-value storage operations
  */
 
-import type { KVEntry, KVListOptions, KVListResult } from "../../../domain/entities/kv.entity";
+import type { KVEntry, KVListOptions, KVListResult } from "../entities";
 import type { IKVService } from "../../../domain/interfaces/services.interface";
-import { validationUtils, cacheUtils } from "../../utils";
+import { validationUtils, cacheUtils } from "../../../infrastructure/utils";
 
 export interface KVCacheOptions {
   readonly namespace: string;

package/src/domains/kv/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * KV Domain Types
+ */
+
+export * from './service.interface';

package/src/domains/kv/types/service.interface.ts

@@ -0,0 +1,13 @@
+/**
+ * KV Service Interface
+ * @description Abstract interface for KV storage operations
+ */
+
+import type { KVListOptions, KVListResult } from '../entities';
+
+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>;
+}

package/src/domains/workflows/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Workflows Domain
+ * Complete workflow orchestration integration
+ */
+
+// Entities
+export * from './entities';
+
+// Services
+export * from './services';

package/src/domains/workflows/services/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Workflows Service
+ * Subpath: @umituz/web-cloudflare/workflows
+ */
+
+export * from './workflows.service';

package/src/{infrastructure/services/workflows/index.ts → domains/workflows/services/workflows.service.ts}

@@ -11,7 +11,7 @@ import type {
   MediaProcessingWorkflow,
   AIGenerationWorkflow,
   BatchOperationWorkflow,
-} from '../../domain/workflows.entity';
+} from '../entities';
 
 export interface WorkflowServiceConfig {
   KV?: KVNamespace;

package/src/index.ts

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