@hexaijs/core 0.2.0 → 0.3.0

package/README.md

@@ -190,6 +190,35 @@ Propagation.EXISTING  // Use existing transaction (error if none)
 Propagation.NESTED    // Nested transaction (savepoint)
 ```
 
+### QueryableUnitOfWork
+
+Extends `UnitOfWork` with a `query()` method for executing read operations without transaction overhead.
+
+```typescript
+import { QueryableUnitOfWork } from "@hexaijs/core";
+
+interface OrderApplicationContext {
+    getUnitOfWork(): QueryableUnitOfWork;
+    getOrderRepository(): OrderRepository;
+}
+
+// Execute a query without transaction overhead
+const user = await unitOfWork.query(async (client) => {
+    return await userRepo.findById(client, userId);
+});
+```
+
+**When to use `wrap()` vs `query()`:**
+
+| Method | Transaction | Use Case |
+|--------|-------------|----------|
+| `wrap()` | Yes (BEGIN/COMMIT) | Commands that modify state |
+| `query()` | No (autocommit) | Read-only queries |
+
+The `query()` method is context-aware:
+- **Outside transaction**: Acquires a new connection, executes, then releases
+- **Inside transaction**: Reuses the existing transaction's client
+
 ### EventStore
 
 Interface for event sourcing scenarios. Stores and retrieves events by position.
@@ -263,6 +292,7 @@ throw new DuplicateObjectError("Order with this ID already exists");
 | `Identifiable<T>` | Interface for entities with identity |
 | `Repository<T>` | Interface for aggregate persistence |
 | `UnitOfWork` | Interface for transaction management |
+| `QueryableUnitOfWork` | UnitOfWork with `query()` for non-transactional reads |
 | `Propagation` | Enum for transaction propagation modes |
 | `EventStore` | Interface for event store implementations |
 

package/dist/unit-of-work.d.ts

@@ -10,4 +10,7 @@ export interface UnitOfWork<Client = unknown, Options extends BaseUnitOfWorkOpti
     getClient(): Client;
     wrap<T>(fn: (client: Client) => Promise<T>, options?: Partial<Options>): Promise<T>;
 }
+export interface QueryableUnitOfWork<Client = unknown, Options extends BaseUnitOfWorkOptions = BaseUnitOfWorkOptions> extends UnitOfWork<Client, Options> {
+    query<T>(fn: (client: Client) => Promise<T>): Promise<T>;
+}
 //# sourceMappingURL=unit-of-work.d.ts.map

package/dist/unit-of-work.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unit-of-work.d.ts","sourceRoot":"","sources":["../src/unit-of-work.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU,CACvB,MAAM,GAAG,OAAO,EAChB,OAAO,SAAS,qBAAqB,GAAG,qBAAqB;IAE7D,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,CAAC,EACF,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB"}
+{"version":3,"file":"unit-of-work.d.ts","sourceRoot":"","sources":["../src/unit-of-work.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACnB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU,CACvB,MAAM,GAAG,OAAO,EAChB,OAAO,SAAS,qBAAqB,GAAG,qBAAqB;IAE7D,SAAS,IAAI,MAAM,CAAC;IACpB,IAAI,CAAC,CAAC,EACF,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAClC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB,CAChC,MAAM,GAAG,OAAO,EAChB,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,CAC/D,SAAQ,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;IACjC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5D"}

package/package.json

@@ -1,60 +1,52 @@
 {
-  "name": "@hexaijs/core",
-  "publishConfig": {
-    "access": "public"
-  },
-  "version": "0.2.0",
-  "description": "Core utilities/types/base classes for hexai projects",
-  "license": "MIT",
-  "author": "Sangwoo Hyun <wkdny.hyun@gmail.com>",
-  "contributors": [
-    "Seungcheol Baek <victoryiron.baek@gmail.com>",
-    "Donghyun Lee <edonghyun@naver.com>"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/workingdanny911/hexai.git",
-    "directory": "packages/core"
-  },
-  "homepage": "https://github.com/workingdanny911/hexai#readme",
-  "bugs": {
-    "url": "https://github.com/workingdanny911/hexai/issues"
-  },
-  "keywords": [
-    "hexai",
-    "hexagonal",
-    "clean-architecture",
-    "ddd",
-    "cqrs",
-    "typescript",
-    "event-sourcing"
-  ],
-  "files": [
-    "dist",
-    "LICENSE"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+    "name": "@hexaijs/core",
+    "publishConfig": {
+        "access": "public"
     },
-    "./test": {
-      "types": "./dist/test/index.d.ts",
-      "import": "./dist/test/index.js",
-      "require": "./dist/test/index.js"
+    "version": "0.3.0",
+    "description": "Core utilities/types/base classes for hexai projects",
+    "license": "MIT",
+    "author": "Sangwoo Hyun <wkdny.hyun@gmail.com>",
+    "contributors": [
+        "Seungcheol Baek <victoryiron.baek@gmail.com>",
+        "Donghyun Lee <edonghyun@naver.com>"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/workingdanny911/hexai.git",
+        "directory": "packages/core"
     },
-    "./package.json": "./package.json"
-  },
-  "dependencies": {
-    "lodash": "^4.17.21",
-    "uuid": "^9.0.1"
-  },
-  "devDependencies": {
-    "@types/uuid": "^9.0.8"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "build": "tsc -p ./tsconfig.build.json && tsc-alias"
-  }
-}
+    "homepage": "https://github.com/workingdanny911/hexai#readme",
+    "bugs": {
+        "url": "https://github.com/workingdanny911/hexai/issues"
+    },
+    "keywords": ["hexai", "hexagonal", "clean-architecture", "ddd", "cqrs", "typescript", "event-sourcing"],
+    "files": [
+        "dist",
+        "LICENSE"
+    ],
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js"
+        },
+        "./test": {
+            "types": "./dist/test/index.d.ts",
+            "import": "./dist/test/index.js",
+            "require": "./dist/test/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "scripts": {
+        "test": "vitest run",
+        "build": "tsc -p ./tsconfig.build.json && tsc-alias"
+    },
+    "dependencies": {
+        "lodash": "^4.17.21",
+        "uuid": "^9.0.1"
+    },
+    "devDependencies": {
+        "@types/uuid": "^9.0.8"
+    }
+}