@ahoo-wang/fetcher-react 2.6.6 → 2.6.9

package/dist/wow/index.d.ts

@@ -1 +1,6 @@
+export * from './usePagedQuery';
+export * from './useSingleQuery';
+export * from './useCountQuery';
+export * from './useListQuery';
+export * from './useListStreamQuery';
 //# sourceMappingURL=index.d.ts.map

package/dist/wow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wow/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wow/index.ts"],"names":[],"mappings":"AAaA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/wow/useCountQuery.d.ts

@@ -0,0 +1,57 @@
+import { Condition } from '@ahoo-wang/fetcher-wow';
+import { UsePromiseStateOptions, UseExecutePromiseReturn } from '../core';
+/**
+ * Options for the useCountQuery hook.
+ * @template FIELDS - The type of the fields used in conditions.
+ * @template E - The type of the error.
+ */
+export interface UseCountQueryOptions<FIELDS extends string = string, E = unknown> extends UsePromiseStateOptions<number, E> {
+    /**
+     * The initial condition for the count query.
+     */
+    initialCondition: Condition<FIELDS>;
+    /**
+     * The function to execute the count query.
+     * @param condition - The condition to filter resources.
+     * @param attributes - Optional additional attributes.
+     * @returns A promise that resolves to the count of matching resources.
+     */
+    count: (condition: Condition<FIELDS>, attributes?: Record<string, any>) => Promise<number>;
+    /**
+     * Optional additional attributes to pass to the count function.
+     */
+    attributes?: Record<string, any>;
+}
+/**
+ * Return type for the useCountQuery hook.
+ * @template FIELDS - The type of the fields used in conditions.
+ * @template E - The type of the error.
+ */
+export interface UseCountQueryReturn<FIELDS extends string = string, E = unknown> extends UseExecutePromiseReturn<number, E> {
+    /**
+     * Executes the count query.
+     * @returns A promise that resolves to the count or an error.
+     */
+    execute: () => Promise<E | number>;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+}
+/**
+ * A React hook for managing count queries with state management for conditions.
+ * @template FIELDS - The type of the fields used in conditions.
+ * @template E - The type of the error.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute, setCondition } = useCountQuery({
+ *   initialCondition: {},
+ *   count: async (condition) => fetchCount(condition),
+ * });
+ * ```
+ */
+export declare function useCountQuery<FIELDS extends string = string, E = unknown>(options: UseCountQueryOptions<FIELDS, E>): UseCountQueryReturn<FIELDS>;
+//# sourceMappingURL=useCountQuery.d.ts.map

package/dist/wow/useCountQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCountQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useCountQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAEL,sBAAsB,EAEtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAGjB;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CACnC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC;;;;;OAKG;IACH,KAAK,EAAE,CACL,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC7B,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAClC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,uBAAuB,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CACtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EACvE,OAAO,EAAE,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,GACvC,mBAAmB,CAAC,MAAM,CAAC,CAwB7B"}

package/dist/wow/useListQuery.d.ts

@@ -0,0 +1,75 @@
+import { ListQuery, Condition, Projection, FieldSort } from '@ahoo-wang/fetcher-wow';
+import { UsePromiseStateOptions, UseExecutePromiseReturn } from '../core';
+/**
+ * Options for the useListQuery hook.
+ * @template R - The type of the result items in the list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseListQueryOptions<R, FIELDS extends string = string, E = unknown> extends UsePromiseStateOptions<R[], E> {
+    /**
+     * The initial list query configuration.
+     */
+    initialQuery: ListQuery<FIELDS>;
+    /**
+     * The function to execute the list query.
+     * @param listQuery - The list query object.
+     * @param attributes - Optional additional attributes.
+     * @returns A promise that resolves to an array of results.
+     */
+    list: (listQuery: ListQuery<FIELDS>, attributes?: Record<string, any>) => Promise<R[]>;
+    /**
+     * Optional additional attributes to pass to the list function.
+     */
+    attributes?: Record<string, any>;
+}
+/**
+ * Return type for the useListQuery hook.
+ * @template R - The type of the result items in the list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseListQueryReturn<R, FIELDS extends string = string, E = unknown> extends UseExecutePromiseReturn<R[], E> {
+    /**
+     * Executes the list query.
+     * @returns A promise that resolves to the result array or an error.
+     */
+    execute: () => Promise<E | R[]>;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+    /**
+     * Sets the projection for the query.
+     * @param projection - The new projection.
+     */
+    setProjection: (projection: Projection<FIELDS>) => void;
+    /**
+     * Sets the sort order for the query.
+     * @param sort - The new sort array.
+     */
+    setSort: (sort: FieldSort<FIELDS>[]) => void;
+    /**
+     * Sets the limit for the query.
+     * @param limit - The new limit.
+     */
+    setLimit: (limit: number) => void;
+}
+/**
+ * A React hook for managing list queries with state management for conditions, projections, sorting, and limits.
+ * @template R - The type of the result items in the list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute, setCondition, setLimit } = useListQuery({
+ *   initialQuery: { condition: {}, projection: {}, sort: [], limit: 10 },
+ *   list: async (listQuery) => fetchList(listQuery),
+ * });
+ * ```
+ */
+export declare function useListQuery<R, FIELDS extends string = string, E = unknown>(options: UseListQueryOptions<R, FIELDS, E>): UseListQueryReturn<R, FIELDS>;
+//# sourceMappingURL=useListQuery.d.ts.map

package/dist/wow/useListQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useListQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,UAAU,EACf,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,sBAAsB,EAEtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAClC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,sBAAsB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC;;;;;OAKG;IACH,IAAI,EAAE,CACJ,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC7B,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,uBAAuB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EACzE,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GACzC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAkC/B"}

package/dist/wow/useListQueryState.d.ts

@@ -0,0 +1,66 @@
+import { ListQuery, Condition, Projection, FieldSort } from '@ahoo-wang/fetcher-wow';
+/**
+ * Options for the useListQueryState hook.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ */
+export interface UseListQueryStateOptions<FIELDS extends string = string> {
+    /**
+     * The initial list query configuration.
+     */
+    initialQuery: ListQuery<FIELDS>;
+}
+/**
+ * Return type for the useListQueryState hook.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ */
+export interface UseListQueryStateReturn<FIELDS extends string = string> {
+    /**
+     * The current condition.
+     */
+    condition: Condition<FIELDS>;
+    /**
+     * The current projection.
+     */
+    projection?: Projection<FIELDS>;
+    /**
+     * The current sort order.
+     */
+    sort?: FieldSort<FIELDS>[];
+    /**
+     * The current limit.
+     */
+    limit?: number;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+    /**
+     * Sets the projection for the query.
+     * @param projection - The new projection.
+     */
+    setProjection: (projection: Projection<FIELDS>) => void;
+    /**
+     * Sets the sort order for the query.
+     * @param sort - The new sort array.
+     */
+    setSort: (sort: FieldSort<FIELDS>[]) => void;
+    /**
+     * Sets the limit for the query.
+     * @param limit - The new limit.
+     */
+    setLimit: (limit: number) => void;
+    /**
+     * Builds the list query object from current state.
+     * @returns The list query object.
+     */
+    buildQuery: () => ListQuery<FIELDS>;
+}
+/**
+ * A React hook for managing query state (condition, projection, sort, limit).
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ */
+export declare function useListQueryState<FIELDS extends string = string>(options: UseListQueryStateOptions<FIELDS>): UseListQueryStateReturn<FIELDS>;
+//# sourceMappingURL=useListQueryState.d.ts.map

package/dist/wow/useListQueryState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListQueryState.d.ts","sourceRoot":"","sources":["../../src/wow/useListQueryState.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,UAAU,EAEf,SAAS,EACV,MAAM,wBAAwB,CAAC;AAGhC;;;GAGG;AACH,MAAM,WAAW,wBAAwB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACtE;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACrE;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,UAAU,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9D,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,GACxC,uBAAuB,CAAC,MAAM,CAAC,CAwCjC"}

package/dist/wow/useListStreamQuery.d.ts

@@ -0,0 +1,83 @@
+import { ListQuery, Condition, Projection, FieldSort } from '@ahoo-wang/fetcher-wow';
+import { JsonServerSentEvent } from '@ahoo-wang/fetcher-eventstream';
+import { UsePromiseStateOptions, UseExecutePromiseReturn } from '../core';
+/**
+ * Options for the useListStreamQuery hook.
+ * @template R - The type of the result items in the stream events.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseListStreamQueryOptions<R, FIELDS extends string = string, E = unknown> extends UsePromiseStateOptions<ReadableStream<JsonServerSentEvent<R>>, E> {
+    /**
+     * The initial list query configuration.
+     */
+    initialQuery: ListQuery<FIELDS>;
+    /**
+     * The function to execute the list stream query.
+     * @param listQuery - The list query object.
+     * @param attributes - Optional additional attributes.
+     * @returns A promise that resolves to a readable stream of JSON server-sent events.
+     */
+    listStream: (listQuery: ListQuery<FIELDS>, attributes?: Record<string, any>) => Promise<ReadableStream<JsonServerSentEvent<R>>>;
+    /**
+     * Optional additional attributes to pass to the listStream function.
+     */
+    attributes?: Record<string, any>;
+}
+/**
+ * Return type for the useListStreamQuery hook.
+ * @template R - The type of the result items in the stream events.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseListStreamQueryReturn<R, FIELDS extends string = string, E = unknown> extends UseExecutePromiseReturn<ReadableStream<JsonServerSentEvent<R>>, E> {
+    /**
+     * Executes the list stream query.
+     * @returns A promise that resolves to a readable stream of JSON server-sent events or an error.
+     */
+    execute: () => Promise<E | ReadableStream<JsonServerSentEvent<R>>>;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+    /**
+     * Sets the projection for the query.
+     * @param projection - The new projection.
+     */
+    setProjection: (projection: Projection<FIELDS>) => void;
+    /**
+     * Sets the sort order for the query.
+     * @param sort - The new sort array.
+     */
+    setSort: (sort: FieldSort<FIELDS>[]) => void;
+    /**
+     * Sets the limit for the query.
+     * @param limit - The new limit.
+     */
+    setLimit: (limit: number) => void;
+}
+/**
+ * A React hook for managing list stream queries with state management for conditions, projections, sorting, and limits.
+ * Returns a readable stream of JSON server-sent events.
+ * @template R - The type of the result items in the stream events.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute, setCondition, setLimit } = useListStreamQuery({
+ *   initialQuery: { condition: {}, projection: {}, sort: [], limit: 10 },
+ *   listStream: async (listQuery) => fetchListStream(listQuery),
+ * });
+ *
+ * // Use the stream
+ * if (data) {
+ *   const reader = data.getReader();
+ *   // Process stream events
+ * }
+ * ```
+ */
+export declare function useListStreamQuery<R, FIELDS extends string = string, E = unknown>(options: UseListStreamQueryOptions<R, FIELDS, E>): UseListStreamQueryReturn<R, FIELDS>;
+//# sourceMappingURL=useListStreamQuery.d.ts.map

package/dist/wow/useListStreamQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListStreamQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useListStreamQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,SAAS,EACT,KAAK,UAAU,EACf,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAEL,sBAAsB,EAEtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAIjB;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB,CACxC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,sBAAsB,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC;;;;;OAKG;IACH,UAAU,EAAE,CACV,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC7B,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CACvC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,uBAAuB,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,EAEX,OAAO,EAAE,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAC/C,wBAAwB,CAAC,CAAC,EAAE,MAAM,CAAC,CAuCrC"}

package/dist/wow/usePagedQuery.d.ts

@@ -0,0 +1,75 @@
+import { PagedList, PagedQuery, Condition, Pagination, Projection, FieldSort } from '@ahoo-wang/fetcher-wow';
+import { UsePromiseStateOptions, UseExecutePromiseReturn } from '../core';
+/**
+ * Options for the usePagedQuery hook.
+ * @template R - The type of the result items in the paged list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UsePagedQueryOptions<R, FIELDS extends string = string, E = unknown> extends UsePromiseStateOptions<PagedList<R>, E> {
+    /**
+     * The initial paged query configuration.
+     */
+    initialQuery: PagedQuery<FIELDS>;
+    /**
+     * The function to execute the paged query.
+     * @param pagedQuery - The paged query object.
+     * @param attributes - Optional additional attributes.
+     * @returns A promise that resolves to a paged list of results.
+     */
+    query: (pagedQuery: PagedQuery<FIELDS>, attributes?: Record<string, any>) => Promise<PagedList<R>>;
+    /**
+     * Optional additional attributes to pass to the query function.
+     */
+    attributes?: Record<string, any>;
+}
+/**
+ * Return type for the usePagedQuery hook.
+ * @template R - The type of the result items in the paged list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UsePagedQueryReturn<R, FIELDS extends string = string, E = unknown> extends UseExecutePromiseReturn<PagedList<R>, E> {
+    /**
+     * Executes the paged query.
+     * @returns A promise that resolves to the paged list or an error.
+     */
+    execute: () => Promise<E | PagedList<R>>;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+    /**
+     * Sets the projection for the query.
+     * @param projection - The new projection.
+     */
+    setProjection: (projection: Projection<FIELDS>) => void;
+    /**
+     * Sets the pagination for the query.
+     * @param pagination - The new pagination.
+     */
+    setPagination: (pagination: Pagination) => void;
+    /**
+     * Sets the sort order for the query.
+     * @param sort - The new sort array.
+     */
+    setSort: (sort: FieldSort<FIELDS>[]) => void;
+}
+/**
+ * A React hook for managing paged queries with state management for conditions, projections, pagination, and sorting.
+ * @template R - The type of the result items in the paged list.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute, setCondition, setPagination } = usePagedQuery({
+ *   initialQuery: { condition: {}, pagination: { index: 1, size: 10 }, projection: {}, sort: [] },
+ *   query: async (pagedQuery) => fetchPagedData(pagedQuery),
+ * });
+ * ```
+ */
+export declare function usePagedQuery<R, FIELDS extends string = string, E = unknown>(options: UsePagedQueryOptions<R, FIELDS, E>): UsePagedQueryReturn<R, FIELDS>;
+//# sourceMappingURL=usePagedQuery.d.ts.map

package/dist/wow/usePagedQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePagedQuery.d.ts","sourceRoot":"","sources":["../../src/wow/usePagedQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,KAAK,UAAU,EAEf,UAAU,EACV,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,sBAAsB,EACX,uBAAuB,EACnC,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CACnC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C;;OAEG;IACH,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC;;;;;OAKG;IACH,KAAK,EAAE,CACL,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,EAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAClC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EAC1E,OAAO,EAAE,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAC1C,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,CAsChC"}

package/dist/wow/useSingleQuery.d.ts

@@ -0,0 +1,70 @@
+import { SingleQuery, Condition, Projection, FieldSort } from '@ahoo-wang/fetcher-wow';
+import { UsePromiseStateOptions, UseExecutePromiseReturn } from '../core';
+/**
+ * Options for the useSingleQuery hook.
+ * @template R - The type of the result.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseSingleQueryOptions<R, FIELDS extends string = string, E = unknown> extends UsePromiseStateOptions<R, E> {
+    /**
+     * The initial single query configuration.
+     */
+    initialQuery: SingleQuery<FIELDS>;
+    /**
+     * The function to execute the single query.
+     * @param singleQuery - The single query object.
+     * @param attributes - Optional additional attributes.
+     * @returns A promise that resolves to the result.
+     */
+    query: (singleQuery: SingleQuery<FIELDS>, attributes?: Record<string, any>) => Promise<R>;
+    /**
+     * Optional additional attributes to pass to the query function.
+     */
+    attributes?: Record<string, any>;
+}
+/**
+ * Return type for the useSingleQuery hook.
+ * @template R - The type of the result.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ */
+export interface UseSingleQueryReturn<R, FIELDS extends string = string, E = unknown> extends UseExecutePromiseReturn<R, E> {
+    /**
+     * Executes the single query.
+     * @returns A promise that resolves to the result or an error.
+     */
+    execute: () => Promise<E | R>;
+    /**
+     * Sets the condition for the query.
+     * @param condition - The new condition.
+     */
+    setCondition: (condition: Condition<FIELDS>) => void;
+    /**
+     * Sets the projection for the query.
+     * @param projection - The new projection.
+     */
+    setProjection: (projection: Projection<FIELDS>) => void;
+    /**
+     * Sets the sort order for the query.
+     * @param sort - The new sort array.
+     */
+    setSort: (sort: FieldSort<FIELDS>[]) => void;
+}
+/**
+ * A React hook for managing single queries with state management for conditions, projections, and sorting.
+ * @template R - The type of the result.
+ * @template FIELDS - The type of the fields used in conditions and projections.
+ * @template E - The type of the error.
+ * @param options - The options for the hook.
+ * @returns An object containing the query state and methods to update it.
+ * @example
+ * ```typescript
+ * const { data, loading, error, execute, setCondition, setProjection } = useSingleQuery({
+ *   initialQuery: { condition: {}, projection: {}, sort: [] },
+ *   query: async (singleQuery) => fetchSingleData(singleQuery),
+ * });
+ * ```
+ */
+export declare function useSingleQuery<R, FIELDS extends string = string, E = unknown>(options: UseSingleQueryOptions<R, FIELDS, E>): UseSingleQueryReturn<R, FIELDS>;
+//# sourceMappingURL=useSingleQuery.d.ts.map

package/dist/wow/useSingleQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSingleQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useSingleQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,WAAW,EACX,SAAS,EACT,KAAK,UAAU,EAEf,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,sBAAsB,EACX,uBAAuB,EACnC,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CACpC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC;;;;;OAKG;IACH,KAAK,EAAE,CACL,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC7B,OAAO,CAAC,CAAC,CAAC,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CACnC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,OAAO,CACX,SAAQ,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD;;;OAGG;IACH,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EAC3E,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAC3C,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,CA6BjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-react",
-  "version": "2.6.6",
+  "version": "2.6.9",
   "description": "React integration for Fetcher HTTP client. Provides React Hooks and components for seamless data fetching with automatic re-rendering and loading states.",
   "keywords": [
     "fetch",
@@ -41,23 +41,24 @@
   "dependencies": {},
   "peerDependencies": {
     "@ahoo-wang/fetcher": "^2.3.4",
+    "@ahoo-wang/fetcher-eventstream": "^2.3.4",
     "@ahoo-wang/fetcher-storage": "^2.3.4",
     "@ahoo-wang/fetcher-wow": "^2.3.4",
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.36.0",
+    "@eslint/js": "^9.37.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
-    "eslint": "^9.36.0",
+    "eslint": "^9.37.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.45.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "unplugin-dts": "1.0.0-beta.6",
-    "vite": "^7.1.7",
+    "vite": "^7.1.9",
     "vite-bundle-analyzer": "^1.2.3",
     "vitest": "^3.2.4",
     "@testing-library/react": "^16.0.0",