@ahoo-wang/fetcher-wow 3.16.10 → 3.17.1

package/README.md

@@ -23,7 +23,7 @@ working with the Wow CQRS/DDD framework.
   updates
 - **🚀 Command Client**: High-level client for sending commands to Wow services with both synchronous and streaming
   responses
-- **🔍 Powerful Query DSL**: Rich query condition builder with comprehensive operator support for complex querying
+- **🔍 Powerful Query DSL**: Typed `FilterExpression` builders with comprehensive operator support
 - **🔍 Query Clients**: Specialized clients for querying snapshot and event stream data with comprehensive query
   operations:
   - Counting resources
@@ -68,6 +68,7 @@ either synchronously or as a stream of events.
 import {
   Fetcher,
   FetchExchange,
+  HttpMethod,
   RequestInterceptor,
   URL_RESOLVE_INTERCEPTOR_ORDER,
 } from '@ahoo-wang/fetcher';
@@ -75,8 +76,7 @@ import '@ahoo-wang/fetcher-eventstream';
 import {
   CommandClient,
   CommandRequest,
-  HttpMethod,
-  CommandHttpHeaders,
+  CommandHeaders,
   CommandStage,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
@@ -126,7 +126,7 @@ type AddCartItemCommand = CommandRequest<AddCartItem>;
 const addCartItemCommand: AddCartItemCommand = {
   method: HttpMethod.POST,
   headers: {
-    [CommandHttpHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
+    [CommandHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
   },
   body: {
     productId: 'productId',
@@ -159,9 +159,29 @@ for await (const commandResultEvent of commandResultStream) {
 
 ### Query Module
 
-#### Condition Builder
+#### Filter Expression Builder
+
+Wow 8.11+ queries use `FilterExpression`:
+
+```typescript
+import { DeletionState, filter } from '@ahoo-wang/fetcher-wow';
+
+const expression = filter.and(
+  filter.deletion(DeletionState.ACTIVE),
+  filter.eq('state.status', 'PAID'),
+  filter.elementMatch('state.items', filter.gt('quantity', 0)),
+  filter.search('wow', 'state.name'),
+);
+```
+
+Builders are grouped under `filter`: `matchAll`, `matchNone`, `and`, `or`,
+`nor`, comparisons, string/collection predicates, presence checks,
+`elementMatch`, `search`, deletion scope, and relative-time filters.
+
+#### Condition Builder (Deprecated)
 
-Comprehensive query condition builder with operator support:
+The legacy Condition API remains available for compatibility with older Wow
+servers. New code should use `FilterExpression` and `filter.*`.
 
 ```typescript
 import {
@@ -246,7 +266,7 @@ const arrayConditions = [
 // Date conditions
 const dateConditions = [
   today('createdAt'),
-  beforeToday('lastLogin', 7), // 7 days before today (i.e., within last 7 days)
+  beforeToday('lastLogin', '09:30'),
   tomorrow('scheduledDate'),
   thisWeek('updatedAt'),
   nextWeek('startDate'),
@@ -282,7 +302,7 @@ const rawCondition = raw({ $text: { $search: 'keywords' } });
 | 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)` |
+| Date         | `today`, `beforeToday(time)`, `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)                                                                                                  |
@@ -301,10 +321,10 @@ import {
 import '@ahoo-wang/fetcher-eventstream';
 import {
   SnapshotQueryClient,
-  all,
-  ListQuery,
-  PagedQuery,
-  SingleQuery,
+  filter,
+  FilterListQuery,
+  FilterPagedQuery,
+  FilterSingleQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -346,11 +366,11 @@ const cartSnapshotQueryClient = new SnapshotQueryClient<CartState>({
 });
 
 // Count snapshots
-const count = await cartSnapshotQueryClient.count(all());
+const count = await cartSnapshotQueryClient.count(filter.matchAll());
 
 // List snapshots
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const list = await cartSnapshotQueryClient.list(listQuery);
 
@@ -372,8 +392,8 @@ for await (const event of stateStream) {
 }
 
 // Paged snapshots
-const pagedQuery: PagedQuery = {
-  condition: all(),
+const pagedQuery: FilterPagedQuery = {
+  filter: filter.matchAll(),
 };
 const paged = await cartSnapshotQueryClient.paged(pagedQuery);
 
@@ -381,8 +401,8 @@ const paged = await cartSnapshotQueryClient.paged(pagedQuery);
 const pagedState = await cartSnapshotQueryClient.pagedState(pagedQuery);
 
 // Single snapshot
-const singleQuery: SingleQuery = {
-  condition: all(),
+const singleQuery: FilterSingleQuery = {
+  filter: filter.matchAll(),
 };
 const single = await cartSnapshotQueryClient.single(singleQuery);
 
@@ -392,20 +412,20 @@ const singleState = await cartSnapshotQueryClient.singleState(singleQuery);
 
 ##### Methods
 
-- `count(condition: Condition): Promise<number>` - Counts the number of snapshots that match the given condition.
-- `list(listQuery: ListQuery): Promise<Partial<MaterializedSnapshot<S>>[]>` - Retrieves a list of materialized
+- `count(filter: FilterExpression): Promise<number>` - Counts snapshots matching the filter expression.
+- `list(listQuery: FilterListQuery): Promise<Partial<MaterializedSnapshot<S>>[]>` - Retrieves a list of materialized
   snapshots.
-- `listStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<MaterializedSnapshot<S>>>>>` -
+- `listStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<MaterializedSnapshot<S>>>>>` -
   Retrieves a stream of materialized snapshots as Server-Sent Events.
-- `listState(listQuery: ListQuery): Promise<Partial<S>[]>` - Retrieves a list of snapshot states.
-- `listStateStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<S>>>>` - Retrieves a stream
+- `listState(listQuery: FilterListQuery): Promise<Partial<S>[]>` - Retrieves a list of snapshot states.
+- `listStateStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<S>>>>` - Retrieves a stream
   of snapshot states as Server-Sent Events.
-- `paged(pagedQuery: PagedQuery): Promise<PagedList<Partial<MaterializedSnapshot<S>>>>` - Retrieves a paged list of
+- `paged(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<MaterializedSnapshot<S>>>>` - Retrieves a paged list of
   materialized snapshots.
-- `pagedState(pagedQuery: PagedQuery): Promise<PagedList<Partial<S>>>` - Retrieves a paged list of snapshot states.
-- `single(singleQuery: SingleQuery): Promise<Partial<MaterializedSnapshot<S>>>` - Retrieves a single materialized
+- `pagedState(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<S>>>` - Retrieves a paged list of snapshot states.
+- `single(singleQuery: FilterSingleQuery): Promise<Partial<MaterializedSnapshot<S>>>` - Retrieves a single materialized
   snapshot.
-- `singleState(singleQuery: SingleQuery): Promise<Partial<S>>` - Retrieves a single snapshot state.
+- `singleState(singleQuery: FilterSingleQuery): Promise<Partial<S>>` - Retrieves a single snapshot state.
 
 #### QueryClientFactory
 
@@ -413,9 +433,9 @@ Factory for creating pre-configured query clients. Useful when you need multiple
 
 ```typescript
 import {
+  filter,
   QueryClientFactory,
   ResourceAttributionPathSpec,
-  all,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -431,7 +451,7 @@ const factory = new QueryClientFactory({
 const snapshotClient = factory.createSnapshotQueryClient({
   aggregateName: 'cart',
 });
-const carts = await snapshotClient.listState({ condition: all() });
+const carts = await snapshotClient.listState({ filter: filter.matchAll() });
 
 // Create a state aggregate client
 const stateClient = factory.createLoadStateAggregateClient({
@@ -443,7 +463,7 @@ const cart = await stateClient.load('cart-123');
 const eventClient = factory.createEventStreamQueryClient({
   aggregateName: 'cart',
 });
-const events = await eventClient.list({ condition: all() });
+const events = await eventClient.list({ filter: filter.matchAll() });
 ```
 
 **Methods:**
@@ -467,9 +487,9 @@ import {
 import '@ahoo-wang/fetcher-eventstream';
 import {
   EventStreamQueryClient,
-  all,
-  ListQuery,
-  PagedQuery,
+  filter,
+  FilterListQuery,
+  FilterPagedQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -502,11 +522,11 @@ const cartEventStreamQueryClient = new EventStreamQueryClient({
 });
 
 // Count event streams
-const count = await cartEventStreamQueryClient.count(all());
+const count = await cartEventStreamQueryClient.count(filter.matchAll());
 
 // List event streams
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const list = await cartEventStreamQueryClient.list(listQuery);
 
@@ -518,20 +538,19 @@ for await (const event of listStream) {
 }
 
 // Paged event streams
-const pagedQuery: PagedQuery = {
-  condition: all(),
+const pagedQuery: FilterPagedQuery = {
+  filter: filter.matchAll(),
 };
 const paged = await cartEventStreamQueryClient.paged(pagedQuery);
 ```
 
 ##### Methods
 
-- `count(condition: Condition): Promise<number>` - Counts the number of domain event streams that match the given
-  condition.
-- `list(listQuery: ListQuery): Promise<Partial<DomainEventStream>[]>` - Retrieves a list of domain event streams.
-- `listStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<DomainEventStream>>>>` -
+- `count(filter: FilterExpression): Promise<number>` - Counts domain event streams matching the filter expression.
+- `list(listQuery: FilterListQuery): Promise<Partial<DomainEventStream>[]>` - Retrieves a list of domain event streams.
+- `listStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<DomainEventStream>>>>` -
   Retrieves a stream of domain event streams as Server-Sent Events.
-- `paged(pagedQuery: PagedQuery): Promise<PagedList<Partial<DomainEventStream>>>` - Retrieves a paged list of domain
+- `paged(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<DomainEventStream>>>` - Retrieves a paged list of domain
   event streams.
 
 ## 🚀 Advanced Usage Examples
@@ -673,8 +692,9 @@ Create complex queries with reactive real-time updates:
 
 ```typescript
 import {
-  SnapshotQueryClient,
   EventStreamQueryClient,
+  filter,
+  SnapshotQueryClient,
 } from '@ahoo-wang/fetcher-wow';
 
 // Advanced query manager with reactive updates
@@ -725,17 +745,16 @@ class ReactiveQueryManager {
   async getUserDashboardStats(userId: string) {
     const [userProfile, recentActivity, stats] = await Promise.all([
       this.snapshotClient.single({
-        condition: { id: userId },
-        projection: { name: 1, email: 1, createdAt: 1 },
+        filter: filter.eq('aggregateId', userId),
       }),
       this.snapshotClient.list({
-        condition: { userId, type: 'activity' },
-        sort: [{ field: 'timestamp', order: 'desc' }],
+        filter: filter.and(
+          filter.eq('state.userId', userId),
+          filter.eq('state.type', 'activity'),
+        ),
         limit: 10,
       }),
-      this.snapshotClient.count({
-        condition: { userId },
-      }),
+      this.snapshotClient.count(filter.eq('state.userId', userId)),
     ]);
 
     return {
@@ -758,8 +777,10 @@ console.log('Dashboard:', dashboard);
 queryManager.subscribeToQuery(
   'user-activity',
   {
-    condition: { userId: 'user-123', type: 'activity' },
-    sort: [{ field: 'timestamp', order: 'desc' }],
+    filter: filter.and(
+      filter.eq('state.userId', 'user-123'),
+      filter.eq('state.type', 'activity'),
+    ),
   },
   update => {
     console.log('New activity:', update);
@@ -774,6 +795,7 @@ queryManager.subscribeToQuery(
 import {
   Fetcher,
   FetchExchange,
+  HttpMethod,
   RequestInterceptor,
   URL_RESOLVE_INTERCEPTOR_ORDER,
 } from '@ahoo-wang/fetcher';
@@ -781,12 +803,11 @@ import '@ahoo-wang/fetcher-eventstream';
 import {
   CommandClient,
   CommandRequest,
-  CommandHttpHeaders,
+  CommandHeaders,
   CommandStage,
-  HttpMethod,
   SnapshotQueryClient,
-  all,
-  ListQuery,
+  filter,
+  FilterListQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -850,7 +871,7 @@ type AddCartItemCommand = CommandRequest<AddCartItem>;
 const addItemCommand: AddCartItemCommand = {
   method: HttpMethod.POST,
   headers: {
-    [CommandHttpHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
+    [CommandHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
   },
   body: {
     productId: 'product-123',
@@ -865,8 +886,8 @@ const commandResult = await cartCommandClient.send(
 console.log('Command executed:', commandResult);
 
 // 2. Query the updated cart
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const carts = await cartSnapshotQueryClient.list(listQuery);
 
@@ -895,7 +916,7 @@ pnpm test --coverage
 ## 🤝 Contributing
 
 Contributions are welcome! Please see
-the [contributing guide](https://github.com/Ahoo-Wang/fetcher/blob/main/CONTRIBUTING.md) for more details.
+the [contributing guide](https://github.com/Ahoo-Wang/fetcher/blob/main/wiki/guide/contributing.md) for more details.
 
 ## 📄 License
 

package/README.zh-CN.md

@@ -15,7 +15,7 @@
 
 - **📦 完整的 TypeScript 支持**：为所有 Wow 框架实体提供完整的类型定义，包括命令、事件和查询
 - **🚀 命令客户端**：用于向 Wow 服务发送命令的高级客户端，支持同步和流式响应
-- **🔍 强大的查询 DSL**：丰富的查询条件构建器，支持全面的操作符用于复杂查询
+- **🔍 强大的查询 DSL**：类型安全的 `FilterExpression` 构建器，支持完整的查询操作符
 - **📡 实时事件流**：内置对服务器发送事件的支持，用于接收实时命令结果和数据更新
 - **🔄 CQRS 模式实现**：对命令查询责任分离架构模式的一流支持
 - **🧱 DDD 基础构件**：基本的领域驱动设计构建块，包括聚合、事件和值对象
@@ -61,6 +61,7 @@ import { CommandResult, CommandStage } from '@ahoo-wang/fetcher-wow';
 import {
   Fetcher,
   FetchExchange,
+  HttpMethod,
   RequestInterceptor,
   URL_RESOLVE_INTERCEPTOR_ORDER,
 } from '@ahoo-wang/fetcher';
@@ -68,8 +69,7 @@ import '@ahoo-wang/fetcher-eventstream';
 import {
   CommandClient,
   CommandRequest,
-  HttpMethod,
-  CommandHttpHeaders,
+  CommandHeaders,
   CommandStage,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
@@ -119,7 +119,7 @@ type AddCartItemCommand = CommandRequest<AddCartItem>;
 const addCartItemCommand: AddCartItemCommand = {
   method: HttpMethod.POST,
   headers: {
-    [CommandHttpHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
+    [CommandHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
   },
   body: {
     productId: 'productId',
@@ -151,9 +151,28 @@ for await (const commandResultEvent of commandResultStream) {
 
 ### 查询模块
 
-#### 条件构建器
+#### FilterExpression 构建器
+
+Wow 8.11+ 查询使用 `FilterExpression`：
+
+```typescript
+import { DeletionState, filter } from '@ahoo-wang/fetcher-wow';
+
+const expression = filter.and(
+  filter.deletion(DeletionState.ACTIVE),
+  filter.eq('state.status', 'PAID'),
+  filter.elementMatch('state.items', filter.gt('quantity', 0)),
+  filter.search('wow', 'state.name'),
+);
+```
+
+所有构建器集中在 `filter`：`matchAll`、`matchNone`、`and`、`or`、`nor`、
+比较、字符串/集合谓词、存在性检查、`elementMatch`、`search`、删除范围和相对时间过滤器。
+
+#### 条件构建器（已弃用）
 
-支持操作符的综合查询条件构建器：
+旧 Condition API 仅为兼容旧版 Wow 服务保留。新代码应使用
+`FilterExpression` 和 `filter.*`。
 
 ```typescript
 import {
@@ -238,7 +257,7 @@ const arrayConditions = [
 // 日期条件
 const dateConditions = [
   today('createdAt'),
-  beforeToday('lastLogin', 7), // 7天前（即过去7天内）
+  beforeToday('lastLogin', '09:30'),
   tomorrow('scheduledDate'),
   thisWeek('updatedAt'),
   nextWeek('startDate'),
@@ -274,7 +293,7 @@ const rawCondition = raw({ $text: { $search: 'keywords' } });
 | 字符串    | `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)` |
+| 日期      | `today`, `beforeToday(time)`, `tomorrow`, `thisWeek`, `nextWeek`, `lastWeek`, `thisMonth`, `lastMonth`, `recentDays(days)`, `earlierDays(days)` |
 | ID        | `id`, `ids`, `aggregateId`, `aggregateIds`, `tenantId`, `ownerId`                                                                               |
 | 状态      | `active`, `all`, `deleted`                                                                                                                      |
 | 特殊      | `raw`（用于高级数据库特定查询）                                                                                                                 |
@@ -293,10 +312,10 @@ import {
 import '@ahoo-wang/fetcher-eventstream';
 import {
   SnapshotQueryClient,
-  all,
-  ListQuery,
-  PagedQuery,
-  SingleQuery,
+  filter,
+  FilterListQuery,
+  FilterPagedQuery,
+  FilterSingleQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -338,11 +357,11 @@ const cartSnapshotQueryClient = new SnapshotQueryClient<CartState>({
 });
 
 // 统计快照数量
-const count = await cartSnapshotQueryClient.count(all());
+const count = await cartSnapshotQueryClient.count(filter.matchAll());
 
 // 列出快照
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const list = await cartSnapshotQueryClient.list(listQuery);
 
@@ -364,8 +383,8 @@ for await (const event of stateStream) {
 }
 
 // 分页查询快照
-const pagedQuery: PagedQuery = {
-  condition: all(),
+const pagedQuery: FilterPagedQuery = {
+  filter: filter.matchAll(),
 };
 const paged = await cartSnapshotQueryClient.paged(pagedQuery);
 
@@ -373,8 +392,8 @@ const paged = await cartSnapshotQueryClient.paged(pagedQuery);
 const pagedState = await cartSnapshotQueryClient.pagedState(pagedQuery);
 
 // 查询单个快照
-const singleQuery: SingleQuery = {
-  condition: all(),
+const singleQuery: FilterSingleQuery = {
+  filter: filter.matchAll(),
 };
 const single = await cartSnapshotQueryClient.single(singleQuery);
 
@@ -384,17 +403,17 @@ const singleState = await cartSnapshotQueryClient.singleState(singleQuery);
 
 ##### 方法
 
-- `count(condition: Condition): Promise<number>` - 统计匹配给定条件的快照数量。
-- `list(listQuery: ListQuery): Promise<Partial<MaterializedSnapshot<S>>[]>` - 检索物化快照列表。
-- `listStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<MaterializedSnapshot<S>>>>>` -
+- `count(filter: FilterExpression): Promise<number>` - 统计匹配过滤表达式的快照数量。
+- `list(listQuery: FilterListQuery): Promise<Partial<MaterializedSnapshot<S>>[]>` - 检索物化快照列表。
+- `listStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<MaterializedSnapshot<S>>>>>` -
   以服务器发送事件的形式检索物化快照流。
-- `listState(listQuery: ListQuery): Promise<Partial<S>[]>` - 检索快照状态列表。
-- `listStateStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<S>>>>` -
+- `listState(listQuery: FilterListQuery): Promise<Partial<S>[]>` - 检索快照状态列表。
+- `listStateStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<S>>>>` -
   以服务器发送事件的形式检索快照状态流。
-- `paged(pagedQuery: PagedQuery): Promise<PagedList<Partial<MaterializedSnapshot<S>>>>` - 检索物化快照的分页列表。
-- `pagedState(pagedQuery: PagedQuery): Promise<PagedList<Partial<S>>>` - 检索快照状态的分页列表。
-- `single(singleQuery: SingleQuery): Promise<Partial<MaterializedSnapshot<S>>>` - 检索单个物化快照。
-- `singleState(singleQuery: SingleQuery): Promise<Partial<S>>` - 检索单个快照状态。
+- `paged(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<MaterializedSnapshot<S>>>>` - 检索物化快照的分页列表。
+- `pagedState(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<S>>>` - 检索快照状态的分页列表。
+- `single(singleQuery: FilterSingleQuery): Promise<Partial<MaterializedSnapshot<S>>>` - 检索单个物化快照。
+- `singleState(singleQuery: FilterSingleQuery): Promise<Partial<S>>` - 检索单个快照状态。
 
 #### QueryClientFactory
 
@@ -402,9 +421,9 @@ const singleState = await cartSnapshotQueryClient.singleState(singleQuery);
 
 ```typescript
 import {
+  filter,
   QueryClientFactory,
   ResourceAttributionPathSpec,
-  all,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -420,7 +439,7 @@ const factory = new QueryClientFactory({
 const snapshotClient = factory.createSnapshotQueryClient({
   aggregateName: 'cart',
 });
-const carts = await snapshotClient.listState({ condition: all() });
+const carts = await snapshotClient.listState({ filter: filter.matchAll() });
 
 // 创建状态聚合客户端
 const stateClient = factory.createLoadStateAggregateClient({
@@ -432,7 +451,7 @@ const cart = await stateClient.load('cart-123');
 const eventClient = factory.createEventStreamQueryClient({
   aggregateName: 'cart',
 });
-const events = await eventClient.list({ condition: all() });
+const events = await eventClient.list({ filter: filter.matchAll() });
 ```
 
 **方法：**
@@ -456,9 +475,9 @@ import {
 import '@ahoo-wang/fetcher-eventstream';
 import {
   EventStreamQueryClient,
-  all,
-  ListQuery,
-  PagedQuery,
+  filter,
+  FilterListQuery,
+  FilterPagedQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -491,11 +510,11 @@ const cartEventStreamQueryClient = new EventStreamQueryClient({
 });
 
 // 统计事件流数量
-const count = await cartEventStreamQueryClient.count(all());
+const count = await cartEventStreamQueryClient.count(filter.matchAll());
 
 // 列出事件流
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const list = await cartEventStreamQueryClient.list(listQuery);
 
@@ -507,19 +526,19 @@ for await (const event of listStream) {
 }
 
 // 分页查询事件流
-const pagedQuery: PagedQuery = {
-  condition: all(),
+const pagedQuery: FilterPagedQuery = {
+  filter: filter.matchAll(),
 };
 const paged = await cartEventStreamQueryClient.paged(pagedQuery);
 ```
 
 ##### 方法
 
-- `count(condition: Condition): Promise<number>` - 统计匹配给定条件的领域事件流数量。
-- `list(listQuery: ListQuery): Promise<Partial<DomainEventStream>[]>` - 检索领域事件流列表。
-- `listStream(listQuery: ListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<DomainEventStream>>>>` -
+- `count(filter: FilterExpression): Promise<number>` - 统计匹配过滤表达式的领域事件流数量。
+- `list(listQuery: FilterListQuery): Promise<Partial<DomainEventStream>[]>` - 检索领域事件流列表。
+- `listStream(listQuery: FilterListQuery): Promise<ReadableStream<JsonServerSentEvent<Partial<DomainEventStream>>>>` -
   以服务器发送事件的形式检索领域事件流。
-- `paged(pagedQuery: PagedQuery): Promise<PagedList<Partial<DomainEventStream>>>` - 检索领域事件流的分页列表。
+- `paged(pagedQuery: FilterPagedQuery): Promise<PagedList<Partial<DomainEventStream>>>` - 检索领域事件流的分页列表。
 
 ## 🛠️ 高级用法
 
@@ -529,6 +548,7 @@ const paged = await cartEventStreamQueryClient.paged(pagedQuery);
 import {
   Fetcher,
   FetchExchange,
+  HttpMethod,
   RequestInterceptor,
   URL_RESOLVE_INTERCEPTOR_ORDER,
 } from '@ahoo-wang/fetcher';
@@ -536,12 +556,11 @@ import '@ahoo-wang/fetcher-eventstream';
 import {
   CommandClient,
   CommandRequest,
-  CommandHttpHeaders,
+  CommandHeaders,
   CommandStage,
-  HttpMethod,
   SnapshotQueryClient,
-  all,
-  ListQuery,
+  filter,
+  FilterListQuery,
 } from '@ahoo-wang/fetcher-wow';
 import { idGenerator } from '@ahoo-wang/fetcher-cosec';
 
@@ -605,7 +624,7 @@ type AddCartItemCommand = CommandRequest<AddCartItem>;
 const addItemCommand: AddCartItemCommand = {
   method: HttpMethod.POST,
   headers: {
-    [CommandHttpHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
+    [CommandHeaders.WAIT_STAGE]: CommandStage.SNAPSHOT,
   },
   body: {
     productId: 'product-123',
@@ -620,8 +639,8 @@ const commandResult = await cartCommandClient.send(
 console.log('命令执行完成:', commandResult);
 
 // 2. 查询更新后的购物车
-const listQuery: ListQuery = {
-  condition: all(),
+const listQuery: FilterListQuery = {
+  filter: filter.matchAll(),
 };
 const carts = await cartSnapshotQueryClient.list(listQuery);
 
@@ -650,7 +669,7 @@ pnpm test --coverage
 ## 🤝 贡献
 
 欢迎贡献！请查看
-[贡献指南](https://github.com/Ahoo-Wang/fetcher/blob/main/CONTRIBUTING.md) 获取更多详情。
+[贡献指南](https://github.com/Ahoo-Wang/fetcher/blob/main/wiki/guide/contributing.md) 获取更多详情。
 
 ## 📄 许可证