@ahoo-wang/fetcher-react 3.3.8 → 3.4.0

package/dist/wow/index.d.ts

@@ -1,9 +1,16 @@
-export * from './usePagedQuery';
-export * from './useSingleQuery';
+export * from './types';
 export * from './useCountQuery';
+export * from './useFetcherCountQuery';
+export * from './useFetcherListQuery';
+export * from './useFetcherListStreamQuery';
+export * from './useFetcherPagedQuery';
+export * from './useFetcherQuery';
+export * from './useFetcherSingleQuery';
 export * from './useListQuery';
 export * from './useListStreamQuery';
+export * from './usePagedQuery';
 export * from './useQuery';
+export * from './useQueryState';
+export * from './useSingleQuery';
 export * from './debounce';
-export * from './types';
 //# 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":"AAaA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wow/index.ts"],"names":[],"mappings":"AAaA,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/wow/useFetcherCountQuery.d.ts

@@ -0,0 +1,67 @@
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { UseQueryReturn } from './useQuery';
+import { UseFetcherQueryOptions } from './useFetcherQuery';
+import { Condition } from '@ahoo-wang/fetcher-wow';
+/**
+ * Options for configuring the useFetcherCountQuery hook.
+ *
+ * This interface extends UseFetcherQueryOptions and is specifically tailored for count queries
+ * that use a Condition object to filter results and return a numeric count.
+ *
+ * @template FIELDS - A string union type representing the fields that can be used in the condition.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherCountQueryOptions<FIELDS extends string = string, E = FetcherError> extends UseFetcherQueryOptions<Condition<FIELDS>, number, E> {
+}
+/**
+ * Return type for the useFetcherCountQuery hook.
+ *
+ * This interface extends UseQueryReturn and provides the structure for the hook's return value,
+ * including data (the count as a number), loading state, error state, and other query-related properties.
+ *
+ * @template FIELDS - A string union type representing the fields that can be used in the condition.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherCountQueryReturn<FIELDS extends string = string, E = FetcherError> extends UseQueryReturn<Condition<FIELDS>, number, E> {
+}
+/**
+ * A React hook for performing count queries using the Fetcher library.
+ *
+ * This hook is designed for scenarios where you need to retrieve the count of records
+ * that match a specific condition. It wraps the useFetcherQuery hook and specializes
+ * it for count operations, returning a number representing the count.
+ *
+ * @template FIELDS - A string union type representing the fields that can be used in the condition.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ *
+ * @param options - Configuration options for the count query, including the condition, fetcher instance, and other query settings.
+ * @returns An object containing the query result (count as a number), loading state, error state, and utility functions.
+ *
+ * @throws {E} Throws an error of type E if the query fails, which could be due to network issues, invalid conditions, or server errors.
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherCountQuery } from '@ahoo-wang/fetcher-react';
+ * import { all } from '@ahoo-wang/fetcher-wow';
+ *
+ * function UserCountComponent() {
+ *   const { data: count, loading, error, execute } = useFetcherCountQuery({
+ *     url: '/api/users/count',
+ *     initialQuery: all(),
+ *     autoExecute: true,
+ *   });
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <div>Total active users: {count}</div>
+ *       <button onClick={execute}>Refresh Count</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFetcherCountQuery<FIELDS extends string = string, E = FetcherError>(options: UseFetcherCountQueryOptions<FIELDS, E>): UseFetcherCountQueryReturn<FIELDS, E>;
+//# sourceMappingURL=useFetcherCountQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherCountQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherCountQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B,CAC1C,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;CAAG;AAEjE;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B,CACzC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;CAAG;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,EAEhB,OAAO,EAAE,2BAA2B,CAAC,MAAM,EAAE,CAAC,CAAC,GAC9C,0BAA0B,CAAC,MAAM,EAAE,CAAC,CAAC,CAEvC"}

package/dist/wow/useFetcherListQuery.d.ts

@@ -0,0 +1,100 @@
+import { ListQuery } from '@ahoo-wang/fetcher-wow';
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { UseQueryReturn } from './useQuery';
+import { UseFetcherQueryOptions } from './useFetcherQuery';
+/**
+ * Options for the useFetcherListQuery hook.
+ * Extends UseFetcherQueryOptions to provide configuration for list queries.
+ *
+ * @template R - The type of individual items in the result array.
+ * @template FIELDS - The fields available for filtering, sorting, and pagination in the list query.
+ * @template E - The error type, defaults to FetcherError.
+ */
+export interface UseFetcherListQueryOptions<R, FIELDS extends string = string, E = FetcherError> extends UseFetcherQueryOptions<ListQuery<FIELDS>, R[], E> {
+}
+/**
+ * Return type of the useFetcherListQuery hook.
+ * Extends UseQueryReturn to provide state and methods for list query operations.
+ *
+ * @template R - The type of individual items in the result array.
+ * @template FIELDS - The fields available for filtering, sorting, and pagination in the list query.
+ * @template E - The error type, defaults to FetcherError.
+ */
+export interface UseFetcherListQueryReturn<R, FIELDS extends string = string, E = FetcherError> extends UseQueryReturn<ListQuery<FIELDS>, R[], E> {
+}
+/**
+ * A React hook for executing list queries using the fetcher library within the wow framework.
+ *
+ * This hook is designed for fetching lists of items with support for filtering, sorting, and pagination
+ * through the ListQuery type. It returns an array of results and integrates seamlessly with the fetcher
+ * library for HTTP requests.
+ *
+ * @template R - The type of individual items in the result array (e.g., User, Product).
+ * @template FIELDS - The fields available for filtering, sorting, and pagination (e.g., 'name', 'createdAt').
+ * @template E - The error type, defaults to FetcherError.
+ * @param options - Configuration options including URL, initial list query parameters, and execution settings.
+ * @returns An object containing loading state, result array, error state, and query management functions.
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherListQuery } from '@ahoo-wang/fetcher-react';
+ * import { listQuery, contains, desc } from '@ahoo-wang/fetcher-wow';
+ *
+ * interface User {
+ *   id: string;
+ *   name: string;
+ *   email: string;
+ *   createdAt: string;
+ * }
+ *
+ * function UserListComponent() {
+ *   const {
+ *     loading,
+ *     result: users,
+ *     error,
+ *     execute,
+ *     setQuery,
+ *     getQuery,
+ *   } = useFetcherListQuery<User, keyof User>({
+ *     url: '/api/users/list',
+ *     initialQuery: listQuery({
+ *       condition: contains('name', 'John'),
+ *       sort: [desc('createdAt')],
+ *       limit: 10,
+ *     }),
+ *     autoExecute: true,
+ *   });
+ *
+ *   const loadMore = () => {
+ *     const currentQuery = getQuery();
+ *     setQuery({
+ *       ...currentQuery,
+ *       limit: (currentQuery.limit || 10) + 10,
+ *     });
+ *   };
+ *
+ *   if (loading) return <div>Loading users...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h2>Users ({users?.length || 0})</h2>
+ *       <ul>
+ *         {users?.map(user => (
+ *           <li key={user.id}>
+ *             {user.name} - {user.email}
+ *           </li>
+ *         ))}
+ *       </ul>
+ *       <button onClick={loadMore}>Load More</button>
+ *       <button onClick={execute}>Refresh list</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @throws {FetcherError} When the HTTP request fails due to network issues, invalid responses, or server errors.
+ * @throws {Error} When invalid options are provided, such as malformed URLs or unsupported query parameters.
+ */
+export declare function useFetcherListQuery<R, FIELDS extends string = string, E = FetcherError>(options: UseFetcherListQueryOptions<R, FIELDS, E>): UseFetcherListQueryReturn<R, FIELDS, E>;
+//# sourceMappingURL=useFetcherListQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherListQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherListQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B,CACzC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;CAAG;AAE9D;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB,CACxC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;CAAG;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,EAEhB,OAAO,EAAE,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAChD,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAEzC"}

package/dist/wow/useFetcherListStreamQuery.d.ts

@@ -0,0 +1,107 @@
+import { ListQuery } from '@ahoo-wang/fetcher-wow';
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { UseQueryReturn } from './useQuery';
+import { UseFetcherQueryOptions } from './useFetcherQuery';
+import { JsonServerSentEvent } from '@ahoo-wang/fetcher-eventstream';
+/**
+ * Options for configuring the useFetcherListStreamQuery hook.
+ *
+ * This interface extends UseFetcherQueryOptions and is specifically tailored for list stream queries
+ * that use a ListQuery to filter results and return a ReadableStream of JSON server-sent events.
+ *
+ * @template R - The type of the resource or entity contained in each event in the stream.
+ * @template FIELDS - A string union type representing the fields that can be used in the list query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherListStreamQueryOptions<R, FIELDS extends string = string, E = FetcherError> extends UseFetcherQueryOptions<ListQuery<FIELDS>, ReadableStream<JsonServerSentEvent<R>>, E> {
+}
+/**
+ * Return type for the useFetcherListStreamQuery hook.
+ *
+ * This interface extends UseQueryReturn and provides the structure for the hook's return value,
+ * including data (a ReadableStream of JSON server-sent events), loading state, error state, and other query-related properties.
+ *
+ * @template R - The type of the resource or entity contained in each event in the stream.
+ * @template FIELDS - A string union type representing the fields that can be used in the list query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherListStreamQueryReturn<R, FIELDS extends string = string, E = FetcherError> extends UseQueryReturn<ListQuery<FIELDS>, ReadableStream<JsonServerSentEvent<R>>, E> {
+}
+/**
+ * A React hook for performing list stream queries using the Fetcher library with server-sent events.
+ *
+ * This hook is designed for scenarios where you need to retrieve a stream of data that matches a list query condition.
+ * It returns a ReadableStream of JSON server-sent events, allowing for real-time data streaming.
+ * The hook automatically configures the JsonEventStreamResultExtractor for proper stream handling.
+ *
+ * @template R - The type of the resource or entity contained in each event in the stream.
+ * @template FIELDS - A string union type representing the fields that can be used in the list query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ *
+ * @param options - Configuration options for the list stream query, including the list query, fetcher instance, and other query settings.
+ * @returns An object containing the query result (a ReadableStream of JSON server-sent events), loading state, error state, and utility functions.
+ *
+ * @throws {E} Throws an error of type E if the query fails, which could be due to network issues, invalid queries, or server errors.
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherListStreamQuery } from '@ahoo-wang/fetcher-react';
+ * import { listQuery, contains } from '@ahoo-wang/fetcher-wow';
+ * import { JsonServerSentEvent } from '@ahoo-wang/fetcher-eventstream';
+ * import { useEffect, useRef } from 'react';
+ *
+ * interface User {
+ *   id: number;
+ *   name: string;
+ * }
+ *
+ * function UserStreamComponent() {
+ *   const { data: stream, loading, error, execute } = useFetcherListStreamQuery<User, 'id' | 'name'>({
+ *     url: '/api/users/stream',
+ *     initialQuery: listQuery({
+ *       condition: contains('name', 'John'),
+ *       limit: 10,
+ *     }),
+ *     autoExecute: true,
+ *   });
+ *
+ *   const messagesRef = useRef<HTMLDivElement>(null);
+ *
+ *   useEffect(() => {
+ *     if (stream) {
+ *       const reader = stream.getReader();
+ *       const readStream = async () => {
+ *         try {
+ *           while (true) {
+ *             const { done, value } = await reader.read();
+ *             if (done) break;
+ *             // Process the JsonServerSentEvent<User>
+ *             const newUser = value.data;
+ *             if (messagesRef.current) {
+ *               const div = document.createElement('div');
+ *               div.textContent = `New user: ${newUser.name}`;
+ *               messagesRef.current.appendChild(div);
+ *             }
+ *           }
+ *         } catch (err) {
+ *           console.error('Stream error:', err);
+ *         }
+ *       };
+ *       readStream();
+ *     }
+ *   }, [stream]);
+ *
+ *   if (loading) return <div>Loading stream...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <div ref={messagesRef}></div>
+ *       <button onClick={execute}>Restart Stream</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFetcherListStreamQuery<R, FIELDS extends string = string, E = FetcherError>(options: UseFetcherListStreamQueryOptions<R, FIELDS, E>): UseFetcherListStreamQueryReturn<R, FIELDS, E>;
+//# sourceMappingURL=useFetcherListStreamQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherListStreamQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherListStreamQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAEL,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,WAAW,gCAAgC,CAC/C,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,sBAAsB,CAC9B,SAAS,CAAC,MAAM,CAAC,EACjB,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EACtC,CAAC,CACF;CAAG;AAEJ;;;;;;;;;GASG;AACH,MAAM,WAAW,+BAA+B,CAC9C,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,cAAc,CACtB,SAAS,CAAC,MAAM,CAAC,EACjB,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EACtC,CAAC,CACF;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,wBAAgB,yBAAyB,CACvC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,EAEhB,OAAO,EAAE,gCAAgC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GACtD,+BAA+B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAU/C"}

package/dist/wow/useFetcherPagedQuery.d.ts

@@ -0,0 +1,111 @@
+import { PagedList, PagedQuery } from '@ahoo-wang/fetcher-wow';
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { UseQueryReturn } from './useQuery';
+import { UseFetcherQueryOptions } from './useFetcherQuery';
+/**
+ * Options for configuring the useFetcherPagedQuery hook.
+ *
+ * This interface extends UseFetcherQueryOptions and is specifically tailored for paged queries
+ * that use a PagedQuery to filter and paginate results, returning a PagedList of items.
+ *
+ * @template R - The type of the resource or entity contained in each item of the paged list.
+ * @template FIELDS - A string union type representing the fields that can be used in the paged query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherPagedQueryOptions<R, FIELDS extends string = string, E = FetcherError> extends UseFetcherQueryOptions<PagedQuery<FIELDS>, PagedList<R>, E> {
+}
+/**
+ * Return type for the useFetcherPagedQuery hook.
+ *
+ * This interface extends UseQueryReturn and provides the structure for the hook's return value,
+ * including data (a PagedList containing items and pagination metadata), loading state, error state, and other query-related properties.
+ *
+ * @template R - The type of the resource or entity contained in each item of the paged list.
+ * @template FIELDS - A string union type representing the fields that can be used in the paged query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ */
+export interface UseFetcherPagedQueryReturn<R, FIELDS extends string = string, E = FetcherError> extends UseQueryReturn<PagedQuery<FIELDS>, PagedList<R>, E> {
+}
+/**
+ * A React hook for performing paged queries using the Fetcher library.
+ *
+ * This hook is designed for scenarios where you need to retrieve paginated data that matches a query condition.
+ * It returns a PagedList containing the items for the current page along with pagination metadata such as total count and page information.
+ *
+ * @template R - The type of the resource or entity contained in each item of the paged list.
+ * @template FIELDS - A string union type representing the fields that can be used in the paged query.
+ * @template E - The type of error that may be thrown, defaults to FetcherError.
+ *
+ * @param options - Configuration options for the paged query, including the paged query parameters, fetcher instance, and other query settings.
+ * @returns An object containing the query result (a PagedList with items and pagination info), loading state, error state, and utility functions.
+ *
+ * @throws {E} Throws an error of type E if the query fails, which could be due to network issues, invalid queries, or server errors.
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherPagedQuery } from '@ahoo-wang/fetcher-react';
+ * import { pagedQuery, contains, pagination, desc } from '@ahoo-wang/fetcher-wow';
+ *
+ * interface User {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * function UserListComponent() {
+ *   const {
+ *     data: pagedList,
+ *     loading,
+ *     error,
+ *     execute,
+ *     setQuery,
+ *     getQuery
+ *   } = useFetcherPagedQuery<User, keyof User>({
+ *     url: '/api/users/paged',
+ *     initialQuery: pagedQuery({
+ *       condition: contains('name', 'John'),
+ *       sort: [desc('createdAt')],
+ *       pagination: pagination({ index: 1, size: 10 })
+ *     }),
+ *     autoExecute: true,
+ *   });
+ *
+ *   const goToPage = (page: number) => {
+ *     const currentQuery = getQuery();
+ *     setQuery({
+ *       ...currentQuery,
+ *       pagination: { ...currentQuery.pagination, index: page }
+ *     });
+ *   };
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h2>Users</h2>
+ *       <ul>
+ *         {pagedList.list.map(user => (
+ *           <li key={user.id}>{user.name} - {user.email}</li>
+ *         ))}
+ *       </ul>
+ *       <div>
+ *         <span>Total: {pagedList.total} users</span>
+ *         <button onClick={() => goToPage(1)} disabled={pagedList.pagination.index === 1}>
+ *           First
+ *         </button>
+ *         <button onClick={() => goToPage(pagedList.pagination.index - 1)} disabled={pagedList.pagination.index === 1}>
+ *           Previous
+ *         </button>
+ *         <span>Page {pagedList.pagination.index}</span>
+ *         <button onClick={() => goToPage(pagedList.pagination.index + 1)}>
+ *           Next
+ *         </button>
+ *       </div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFetcherPagedQuery<R, FIELDS extends string = string, E = FetcherError>(options: UseFetcherPagedQueryOptions<R, FIELDS, E>): UseFetcherPagedQueryReturn<R, FIELDS, E>;
+//# sourceMappingURL=useFetcherPagedQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherPagedQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherPagedQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,WAAW,2BAA2B,CAC1C,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAAG;AAExE;;;;;;;;;GASG;AACH,MAAM,WAAW,0BAA0B,CACzC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CAAG;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,EAEhB,OAAO,EAAE,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GACjD,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAE1C"}

package/dist/wow/useFetcherQuery.d.ts

@@ -0,0 +1,106 @@
+import { UseFetcherOptions, UseFetcherReturn } from '../fetcher';
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { AutoExecuteCapable } from './types';
+import { UseQueryStateReturn } from './useQueryState';
+/**
+ * Configuration options for the useFetcherQuery hook
+ * @template Q - The type of the query parameters
+ * @template R - The type of the result value
+ * @template E - The type of the error value
+ */
+export interface UseFetcherQueryOptions<Q, R, E = FetcherError> extends UseFetcherOptions<R, E>, AutoExecuteCapable {
+    /** The URL endpoint to send the POST request to */
+    url: string;
+    /** The initial query parameters to be sent as the request body */
+    initialQuery: Q;
+}
+/**
+ * Return type of the useFetcherQuery hook
+ * @template Q - The type of the query parameters
+ * @template R - The type of the result value
+ * @template E - The type of the error value
+ */
+export interface UseFetcherQueryReturn<Q, R, E = FetcherError> extends UseFetcherReturn<R, E>, UseQueryStateReturn<Q> {
+    /** Function to execute the query with current parameters */
+    execute: () => Promise<void>;
+}
+/**
+ * A React hook for managing query-based HTTP requests with automatic execution
+ *
+ * This hook combines the fetcher functionality with query state management to provide
+ * a convenient way to make POST requests where query parameters are sent as the request body.
+ * It supports automatic execution on mount and when query parameters change.
+ *
+ * @template Q - The type of the query parameters
+ * @template R - The type of the result value
+ * @template E - The type of the error value (defaults to FetcherError)
+ * @param options - Configuration options for the hook
+ * @returns An object containing fetcher state, query management functions, and execution controls
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherQuery } from '@ahoo-wang/fetcher-react';
+ *
+ * interface SearchQuery {
+ *   keyword: string;
+ *   limit: number;
+ *   filters?: { category?: string };
+ * }
+ *
+ * interface SearchResult {
+ *   items: Array<{ id: string; title: string }>;
+ *   total: number;
+ * }
+ *
+ * function SearchComponent() {
+ *   const {
+ *     loading,
+ *     result,
+ *     error,
+ *     execute,
+ *     setQuery,
+ *     getQuery,
+ *   } = useFetcherQuery<SearchQuery, SearchResult>({
+ *     url: '/api/search',
+ *     initialQuery: { keyword: '', limit: 10 },
+ *     autoExecute: false, // Don't execute on mount
+ *   });
+ *
+ *   const handleSearch = (keyword: string) => {
+ *     setQuery({ keyword, limit: 10 }); // This will auto-execute if autoExecute was true
+ *   };
+ *
+ *   const handleManualSearch = () => {
+ *     execute(); // Manual execution with current query
+ *   };
+ *
+ *   if (loading) return <div>Searching...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="text"
+ *         onChange={(e) => handleSearch(e.target.value)}
+ *         placeholder="Search..."
+ *       />
+ *       <button onClick={handleManualSearch}>Search</button>
+ *       {result && (
+ *         <div>
+ *           Found {result.total} items:
+ *           {result.items.map(item => (
+ *             <div key={item.id}>{item.title}</div>
+ *           ))}
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @throws This hook may throw exceptions related to network requests, which should be
+ * handled by the caller. The execute function may throw FetcherError or other network-related errors.
+ * Invalid URL or malformed request options may also cause exceptions.
+ */
+export declare function useFetcherQuery<Q, R, E = FetcherError>(options: UseFetcherQueryOptions<Q, R, E>): UseFetcherQueryReturn<Q, R, E>;
+//# sourceMappingURL=useFetcherQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAc,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAiB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC5D,SAAQ,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,kBAAkB;IACnD,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAC3D,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACtD,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EACpD,OAAO,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACvC,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAyDhC"}

package/dist/wow/useFetcherSingleQuery.d.ts

@@ -0,0 +1,85 @@
+import { SingleQuery } from '@ahoo-wang/fetcher-wow';
+import { FetcherError } from '@ahoo-wang/fetcher';
+import { UseQueryReturn } from './useQuery';
+import { UseFetcherQueryOptions } from './useFetcherQuery';
+/**
+ * Configuration options for the useFetcherSingleQuery hook.
+ *
+ * Extends UseFetcherQueryOptions to provide configuration for single item queries.
+ *
+ * @template R - The type of the result item.
+ * @template FIELDS - The fields available for filtering and sorting in the single query.
+ * @template E - The error type, defaults to FetcherError.
+ */
+export interface UseFetcherSingleQueryOptions<R, FIELDS extends string = string, E = FetcherError> extends UseFetcherQueryOptions<SingleQuery<FIELDS>, R, E> {
+}
+/**
+ * Return type of the useFetcherSingleQuery hook.
+ *
+ * Extends UseQueryReturn to provide state and methods for single item query operations.
+ *
+ * @template R - The type of the result item.
+ * @template FIELDS - The fields available for filtering and sorting in the single query.
+ * @template E - The error type, defaults to FetcherError.
+ */
+export interface UseFetcherSingleQueryReturn<R, FIELDS extends string = string, E = FetcherError> extends UseQueryReturn<SingleQuery<FIELDS>, R, E> {
+}
+/**
+ * A React hook for executing single item queries using the fetcher library within the wow framework.
+ *
+ * This hook is designed for fetching a single item with support for filtering and sorting
+ * through the SingleQuery type. It returns a single result item and integrates seamlessly
+ * with the fetcher library for HTTP requests.
+ *
+ * @template R - The type of the result item (e.g., User, Product).
+ * @template FIELDS - The fields available for filtering and sorting (e.g., 'id', 'name', 'createdAt').
+ * @template E - The error type, defaults to FetcherError.
+ * @param options - Configuration options including URL, initial single query parameters, and execution settings.
+ * @returns An object containing loading state, result item, error state, and query management functions.
+ *
+ * @example
+ * ```typescript
+ * import { useFetcherSingleQuery } from '@ahoo-wang/fetcher-react';
+ * import { singleQuery, eq } from '@ahoo-wang/fetcher-wow';
+ *
+ * interface User {
+ *   id: string;
+ *   name: string;
+ *   email: string;
+ *   createdAt: string;
+ * }
+ *
+ * function UserProfileComponent({ userId }: { userId: string }) {
+ *   const {
+ *     loading,
+ *     result: user,
+ *     error,
+ *     execute,
+ *   } = useFetcherSingleQuery<User, keyof User>({
+ *     url: `/api/users/${userId}`,
+ *     initialQuery: singleQuery({
+ *       condition: eq('id', userId),
+ *     }),
+ *     autoExecute: true,
+ *   });
+ *
+ *   if (loading) return <div>Loading user...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!user) return <div>User not found</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h2>{user.name}</h2>
+ *       <p>Email: {user.email}</p>
+ *       <p>Created: {user.createdAt}</p>
+ *       <button onClick={execute}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @throws {FetcherError} When the HTTP request fails due to network issues, invalid responses, or server errors.
+ * @throws {Error} When invalid options are provided, such as malformed URLs or unsupported query parameters.
+ */
+export declare function useFetcherSingleQuery<R, FIELDS extends string = string, E = FetcherError>(options: UseFetcherSingleQueryOptions<R, FIELDS, E>): UseFetcherSingleQueryReturn<R, FIELDS, E>;
+//# sourceMappingURL=useFetcherSingleQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcherSingleQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useFetcherSingleQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,WAAW,4BAA4B,CAC3C,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,sBAAsB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CAAG;AAE9D;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B,CAC1C,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,CAChB,SAAQ,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CAAG;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EACD,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,CAAC,GAAG,YAAY,EAEhB,OAAO,EAAE,4BAA4B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAClD,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAE3C"}

package/dist/wow/useQuery.d.ts

@@ -1,6 +1,7 @@
 import { UseExecutePromiseReturn, UseExecutePromiseOptions } from '../core';
 import { AttributesCapable, FetcherError } from '@ahoo-wang/fetcher';
 import { AutoExecuteCapable } from './types';
+import { UseQueryStateReturn } from './useQueryState';
 /**
  * Configuration options for the useQuery hook
  * @template Q - The type of the query parameters
@@ -19,13 +20,7 @@ export interface UseQueryOptions<Q, R, E = FetcherError> extends UseExecutePromi
  * @template R - The type of the result value
  * @template E - The type of the error value
  */
-export interface UseQueryReturn<Q, R, E = FetcherError> extends UseExecutePromiseReturn<R, E> {
-    /**
-     * Get the current query parameters
-     */
-    getQuery: () => Q;
-    /** Function to update the query parameters */
-    setQuery: (query: Q) => void;
+export interface UseQueryReturn<Q, R, E = FetcherError> extends UseExecutePromiseReturn<R, E>, UseQueryStateReturn<Q> {
     /** Function to execute the query with current parameters */
     execute: () => Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACrD,SAAQ,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,iBAAiB,EACjB,kBAAkB;IACpB,mCAAmC;IACnC,YAAY,EAAE,CAAC,CAAC;IAEhB,kFAAkF;IAClF,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,eAAe,CAAC,EAAE,eAAe,KAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACpD,SAAQ,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;IACrC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAC7C,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAChC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA4DzB"}
+{"version":3,"file":"useQuery.d.ts","sourceRoot":"","sources":["../../src/wow/useQuery.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAiB,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CACrD,SAAQ,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,iBAAiB,EACjB,kBAAkB;IACpB,mCAAmC;IACnC,YAAY,EAAE,CAAC,CAAC;IAEhB,kFAAkF;IAClF,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,eAAe,CAAC,EAAE,eAAe,KAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,CAAC,EACD,CAAC,EACD,CAAC,GAAG,YAAY,CAChB,SAAQ,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC7D,4DAA4D;IAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAC7C,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAChC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CA8DzB"}