@ahoo-wang/fetcher-wow 3.15.2 → 3.15.4

package/README.md

@@ -171,11 +171,41 @@ import {
   ne,
   gt,
   lt,
+  gte,
+  lte,
   contains,
   isIn,
+  notIn,
   between,
+  allIn,
+  startsWith,
+  endsWith,
+  match,
+  elemMatch,
+  isNull,
+  notNull,
+  isTrue,
+  isFalse,
+  exists,
+  raw,
   today,
+  beforeToday,
+  tomorrow,
+  thisWeek,
+  nextWeek,
+  lastWeek,
+  thisMonth,
+  lastMonth,
+  recentDays,
+  earlierDays,
   active,
+  all,
+  id,
+  ids,
+  aggregateId,
+  aggregateIds,
+  tenantId,
+  ownerId,
 } from '@ahoo-wang/fetcher-wow';
 
 // Simple conditions
@@ -184,6 +214,47 @@ const simpleConditions = [
   ne('status', 'inactive'),
   gt('age', 18),
   lt('score', 100),
+  gte('rating', 4.0),
+  lte('price', 100),
+];
+
+// String conditions
+const stringConditions = [
+  contains('email', '@company.com'),
+  startsWith('username', 'j'),
+  endsWith('domain', '.com'),
+  isIn('status', 'active', 'pending'),
+  notIn('role', 'guest', 'banned'),
+  match('description', 'search keywords'),
+];
+
+// Null checks
+const nullConditions = [
+  isNull('deletedAt'),
+  notNull('email'),
+  isTrue('isActive'),
+  isFalse('isDeleted'),
+  exists('phoneNumber'),
+];
+
+// Array conditions
+const arrayConditions = [
+  allIn('tags', 'react', 'typescript'),
+  elemMatch('items', eq('quantity', 0)),
+];
+
+// Date conditions
+const dateConditions = [
+  today('createdAt'),
+  beforeToday('lastLogin', 7), // 7 days before today (i.e., within last 7 days)
+  tomorrow('scheduledDate'),
+  thisWeek('updatedAt'),
+  nextWeek('startDate'),
+  lastWeek('endDate'),
+  thisMonth('createdDate'),
+  lastMonth('expirationDate'),
+  recentDays('createdAt', 5), // Last 5 days including today
+  earlierDays('createdAt', 3), // More than 3 days ago
 ];
 
 // Complex conditions
@@ -198,15 +269,24 @@ const complexCondition = and(
   active(),
 );
 
-// Date conditions
-const dateConditions = [
-  today('createdAt'),
-  beforeToday('lastLogin', 7), // Within last 7 days
-  thisWeek('updatedAt'),
-  lastMonth('createdDate'),
-];
+// Raw condition for advanced use cases
+const rawCondition = raw({ $text: { $search: 'keywords' } });
 ```
 
+**Operator Reference:**
+
+| Category | Operators |
+|----------|-----------|
+| Logical | `and`, `or`, `nor` |
+| Comparison | `eq`, `ne`, `gt`, `lt`, `gte`, `lte` |
+| String | `contains`, `startsWith`, `endsWith`, `match` |
+| Collection | `isIn`, `notIn`, `allIn`, `elemMatch` |
+| Null/Boolean | `isNull`, `notNull`, `isTrue`, `isFalse`, `exists` |
+| Date | `today`, `beforeToday(days)`, `tomorrow`, `thisWeek`, `nextWeek`, `lastWeek`, `thisMonth`, `lastMonth`, `recentDays(days)`, `earlierDays(days)` |
+| ID | `id`, `ids`, `aggregateId`, `aggregateIds`, `tenantId`, `ownerId` |
+| State | `active`, `all`, `deleted` |
+| Special | `raw` (for advanced database-specific queries) |
+
 #### SnapshotQueryClient
 
 Client for querying materialized snapshots with comprehensive query operations:
@@ -327,6 +407,52 @@ const singleState = await cartSnapshotQueryClient.singleState(singleQuery);
   snapshot.
 - `singleState(singleQuery: SingleQuery): Promise<Partial<S>>` - Retrieves a single snapshot state.
 
+#### QueryClientFactory
+
+Factory for creating pre-configured query clients. Useful when you need multiple clients with shared configuration.
+
+```typescript
+import {
+  QueryClientFactory,
+  ResourceAttributionPathSpec,
+  all,
+} from '@ahoo-wang/fetcher-wow';
+import { idGenerator } from '@ahoo-wang/fetcher-cosec';
+
+// Create a factory with default options
+const factory = new QueryClientFactory({
+  contextAlias: 'example',
+  aggregateName: 'cart',
+  resourceAttribution: ResourceAttributionPathSpec.OWNER,
+  fetcher: exampleFetcher,
+});
+
+// Create a snapshot query client
+const snapshotClient = factory.createSnapshotQueryClient({
+  aggregateName: 'cart',
+});
+const carts = await snapshotClient.listState({ condition: all() });
+
+// Create a state aggregate client
+const stateClient = factory.createLoadStateAggregateClient({
+  aggregateName: 'cart',
+});
+const cart = await stateClient.load('cart-123');
+
+// Create an event stream query client
+const eventClient = factory.createEventStreamQueryClient({
+  aggregateName: 'cart',
+});
+const events = await eventClient.list({ condition: all() });
+```
+
+**Methods:**
+
+- `createSnapshotQueryClient(options?: QueryClientOptions): SnapshotQueryClient` - Creates a client for querying snapshots.
+- `createLoadStateAggregateClient(options?: QueryClientOptions): LoadStateAggregateClient` - Creates a client for loading aggregate state by ID.
+- `createOwnerLoadStateAggregateClient(options?: QueryClientOptions): LoadOwnerStateAggregateClient` - Creates a client for loading the current owner's aggregate state.
+- `createEventStreamQueryClient(options?: QueryClientOptions): EventStreamQueryClient` - Creates a client for querying event streams.
+
 #### EventStreamQueryClient
 
 Client for querying domain event streams with comprehensive query operations:

package/README.zh-CN.md

@@ -163,11 +163,41 @@ import {
   ne,
   gt,
   lt,
+  gte,
+  lte,
   contains,
   isIn,
+  notIn,
   between,
+  allIn,
+  startsWith,
+  endsWith,
+  match,
+  elemMatch,
+  isNull,
+  notNull,
+  isTrue,
+  isFalse,
+  exists,
+  raw,
   today,
+  beforeToday,
+  tomorrow,
+  thisWeek,
+  nextWeek,
+  lastWeek,
+  thisMonth,
+  lastMonth,
+  recentDays,
+  earlierDays,
   active,
+  all,
+  id,
+  ids,
+  aggregateId,
+  aggregateIds,
+  tenantId,
+  ownerId,
 } from '@ahoo-wang/fetcher-wow';
 
 // 简单条件
@@ -176,6 +206,47 @@ const simpleConditions = [
   ne('status', 'inactive'),
   gt('age', 18),
   lt('score', 100),
+  gte('rating', 4.0),
+  lte('price', 100),
+];
+
+// 字符串条件
+const stringConditions = [
+  contains('email', '@company.com'),
+  startsWith('username', 'j'),
+  endsWith('domain', '.com'),
+  isIn('status', 'active', 'pending'),
+  notIn('role', 'guest', 'banned'),
+  match('description', 'search keywords'),
+];
+
+// 空值检查
+const nullConditions = [
+  isNull('deletedAt'),
+  notNull('email'),
+  isTrue('isActive'),
+  isFalse('isDeleted'),
+  exists('phoneNumber'),
+];
+
+// 数组条件
+const arrayConditions = [
+  allIn('tags', 'react', 'typescript'),
+  elemMatch('items', eq('quantity', 0)),
+];
+
+// 日期条件
+const dateConditions = [
+  today('createdAt'),
+  beforeToday('lastLogin', 7), // 7天前（即过去7天内）
+  tomorrow('scheduledDate'),
+  thisWeek('updatedAt'),
+  nextWeek('startDate'),
+  lastWeek('endDate'),
+  thisMonth('createdDate'),
+  lastMonth('expirationDate'),
+  recentDays('createdAt', 5), // 最近5天，包括今天
+  earlierDays('createdAt', 3), // 3天之前
 ];
 
 // 复杂条件
@@ -190,15 +261,24 @@ const complexCondition = and(
   active(),
 );
 
-// 日期条件
-const dateConditions = [
-  today('createdAt'),
-  beforeToday('lastLogin', 7), // 最近7天内
-  thisWeek('updatedAt'),
-  lastMonth('createdDate'),
-];
+// 高级用法的原始条件
+const rawCondition = raw({ $text: { $search: 'keywords' } });
 ```
 
+**操作符参考：**
+
+| 类别 | 操作符 |
+|----------|-----------|
+| 逻辑 | `and`, `or`, `nor` |
+| 比较 | `eq`, `ne`, `gt`, `lt`, `gte`, `lte` |
+| 字符串 | `contains`, `startsWith`, `endsWith`, `match` |
+| 集合 | `isIn`, `notIn`, `allIn`, `elemMatch` |
+| 空值/布尔 | `isNull`, `notNull`, `isTrue`, `isFalse`, `exists` |
+| 日期 | `today`, `beforeToday(days)`, `tomorrow`, `thisWeek`, `nextWeek`, `lastWeek`, `thisMonth`, `lastMonth`, `recentDays(days)`, `earlierDays(days)` |
+| ID | `id`, `ids`, `aggregateId`, `aggregateIds`, `tenantId`, `ownerId` |
+| 状态 | `active`, `all`, `deleted` |
+| 特殊 | `raw`（用于高级数据库特定查询）
+
 #### SnapshotQueryClient
 
 用于查询物化快照的客户端，支持全面的查询操作：
@@ -316,6 +396,52 @@ const singleState = await cartSnapshotQueryClient.singleState(singleQuery);
 - `single(singleQuery: SingleQuery): Promise<Partial<MaterializedSnapshot<S>>>` - 检索单个物化快照。
 - `singleState(singleQuery: SingleQuery): Promise<Partial<S>>` - 检索单个快照状态。
 
+#### QueryClientFactory
+
+用于创建预配置查询客户端的工厂。当您需要具有共享配置的多个客户端时，这非常有用。
+
+```typescript
+import {
+  QueryClientFactory,
+  ResourceAttributionPathSpec,
+  all,
+} from '@ahoo-wang/fetcher-wow';
+import { idGenerator } from '@ahoo-wang/fetcher-cosec';
+
+// 使用默认选项创建工厂
+const factory = new QueryClientFactory({
+  contextAlias: 'example',
+  aggregateName: 'cart',
+  resourceAttribution: ResourceAttributionPathSpec.OWNER,
+  fetcher: exampleFetcher,
+});
+
+// 创建快照查询客户端
+const snapshotClient = factory.createSnapshotQueryClient({
+  aggregateName: 'cart',
+});
+const carts = await snapshotClient.listState({ condition: all() });
+
+// 创建状态聚合客户端
+const stateClient = factory.createLoadStateAggregateClient({
+  aggregateName: 'cart',
+});
+const cart = await stateClient.load('cart-123');
+
+// 创建事件流查询客户端
+const eventClient = factory.createEventStreamQueryClient({
+  aggregateName: 'cart',
+});
+const events = await eventClient.list({ condition: all() });
+```
+
+**方法：**
+
+- `createSnapshotQueryClient(options?: QueryClientOptions): SnapshotQueryClient` - 创建用于查询快照的客户端。
+- `createLoadStateAggregateClient(options?: QueryClientOptions): LoadStateAggregateClient` - 创建用于按 ID 加载聚合状态的客户端。
+- `createOwnerLoadStateAggregateClient(options?: QueryClientOptions): LoadOwnerStateAggregateClient` - 创建用于加载当前所有者聚合状态的客户端。
+- `createEventStreamQueryClient(options?: QueryClientOptions): EventStreamQueryClient` - 创建用于查询事件流的客户端。
+
 #### EventStreamQueryClient
 
 用于查询领域事件流的客户端，支持全面的查询操作：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-wow",
-  "version": "3.15.2",
+  "version": "3.15.4",
   "description": "Support for Wow(https://github.com/Ahoo-Wang/Wow) in Fetcher",
   "keywords": [
     "fetch",
@@ -57,10 +57,10 @@
     "@vitest/coverage-v8": "^4.1.4",
     "@vitest/ui": "^4.1.4",
     "eslint": "^9.39.4",
-    "globals": "^17.4.0",
+    "globals": "^17.5.0",
     "prettier": "^3.8.1",
     "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.1",
+    "typescript-eslint": "^8.58.2",
     "unplugin-dts": "1.0.0-beta.6",
     "vite": "^8.0.8",
     "vite-bundle-analyzer": "^1.3.7",