@umituz/web-cloudflare 1.4.0 → 1.4.2

package/README.md

@@ -177,7 +177,7 @@ const versions = await wrangler.versionsList();
 await wrangler.versionsRollback(versions[0].id);
 ```
 
-**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/`.
+**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/`.
 
 ## 📚 Subpath Exports
 
@@ -190,8 +190,8 @@ import { WorkersService, workersService } from '@umituz/web-cloudflare/workers';
 // KV cache
 import { KVService } from '@umituz/web-cloudflare/kv';
 
-// R2 storage
-import { R2Service } from '@umituz/web-cloudflare/r2';
+// R2 storage (now in domains/)
+import { R2Service, r2Service } from '@umituz/web-cloudflare/r2';
 
 // D1 database
 import { D1Service } from '@umituz/web-cloudflare/d1';
@@ -636,6 +636,15 @@ const result = await retry(
 await sleep(1000); // 1 second
 ```
 
+## 📋 Version Strategy
+
+**Important:** This package follows a **patch-only versioning strategy**. Only the patch version will increment (e.g., 1.4.0 → 1.4.1 → 1.4.2). Major version bumps (2.0.0) will never occur. This ensures stability and prevents breaking changes from version updates.
+
+## 📁 Example Files
+
+Example files are located within their respective domains:
+- **Worker Example**: `src/domains/workers/examples/worker.example.ts`
+
 ## 📝 License
 
 MIT
@@ -660,13 +669,19 @@ Contributions are welcome!
 │   │   │   ├── 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
-│   │   └── ai-gateway/      # AI Gateway domain
+│   │   └── r2/              # R2 storage domain
 │   │       ├── entities/    # Domain entities
 │   │       ├── services/    # Domain services
+│   │       ├── types/       # Domain types
 │   │       └── index.ts     # Domain exports
 │   ├── infrastructure/
-│   │   ├── services/        # Services (kv, r2, d1, etc.)
+│   │   ├── services/        # Services (kv, d1, etc.)
 │   │   ├── router/          # Express-like router
 │   │   ├── middleware/      # Middleware collection
 │   │   └── utils/           # Helper functions

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@umituz/web-cloudflare",
-  "version": "1.4.0",
-  "description": "Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI",
+  "version": "1.4.2",
+  "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",
   "sideEffects": false,
@@ -9,7 +9,7 @@
     ".": "./src/index.ts",
     "./workers": "./src/domains/workers/index.ts",
     "./kv": "./src/infrastructure/services/kv/index.ts",
-    "./r2": "./src/infrastructure/services/r2/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",

package/src/domains/r2/index.ts

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

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

@@ -5,3 +5,4 @@
 
 export { R2Service, r2Service } from "./r2.service";
 export type { R2UploadOptions, R2CacheOptions } from "./r2.service";
+export type { IR2Service } from '../types';

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

@@ -3,9 +3,9 @@
  * @description Cloudflare R2 object storage operations
  */
 
-import type { R2Object, R2ListOptions, R2ListResult, R2PutOptions, R2PresignedURL } from "../../../domain/entities/r2.entity";
+import type { R2Object, R2ListOptions, R2ListResult, R2PutOptions, R2PresignedURL } from "../entities";
 import type { IR2Service } from "../../../domain/interfaces/services.interface";
-import { validationUtils } from "../../utils";
+import { validationUtils } from "../../../infrastructure/utils";
 
 export interface R2UploadOptions extends R2PutOptions {
   readonly binding?: string;

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * R2 Service Interface
+ * @description Abstract interface for R2 storage operations
+ */
+
+import type { R2Object, R2ListOptions, R2ListResult, R2PutOptions, R2PresignedURL } from '../entities';
+
+export interface IR2Service {
+  get(key: string, binding?: string): Promise<R2Object | null>;
+  put(key: string, data: ReadableStream | ArrayBuffer | string, options?: R2PutOptions): Promise<void>;
+  delete(key: string, binding?: string): Promise<boolean>;
+  list(options?: R2ListOptions): Promise<R2ListResult>;
+  getPresignedURL(key: string, expiresIn?: number): Promise<R2PresignedURL>;
+}

package/src/index.ts

@@ -29,8 +29,8 @@
 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/r2";
 export * from "./infrastructure/services/d1";
 export * from "./infrastructure/services/images";
 export * from "./infrastructure/services/analytics";