@ahoo-wang/fetcher-react 3.9.3 → 3.9.5

package/README.md

@@ -131,30 +131,26 @@ The `createExecuteApiHooks` function automatically discovers all function method
 
 ```typescript jsx
 import { createExecuteApiHooks } from '@ahoo-wang/fetcher-react';
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
 
-// Define your API object (can be a class instance or plain object)
+// Define your API service using decorators
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
+
+@api('/users')
 class UserApi {
-  async getUser(id: string): Promise<User> {
-    const response = await fetch(`/api/users/${id}`);
-    return response.json();
+  @get('/{id}')
+  getUser(@path('id') id: string): Promise<User> {
+    throw autoGeneratedError(id);
   }
 
-  async createUser(data: { name: string; email: string }): Promise<User> {
-    const response = await fetch('/api/users', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(data),
-    });
-    return response.json();
+  @post('')
+  createUser(@body() data: { name: string; email: string }): Promise<User> {
+    throw autoGeneratedError(data);
   }
 
-  async updateUser(id: string, updates: Partial<User>): Promise<User> {
-    const response = await fetch(`/api/users/${id}`, {
-      method: 'PATCH',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(updates),
-    });
-    return response.json();
+  @patch('/{id}')
+  updateUser(@path('id') id: string, @body() updates: Partial<User>): Promise<User> {
+    throw autoGeneratedError(id, updates);
   }
 }
 
@@ -223,11 +219,19 @@ class ApiError extends Error {
 }
 
 // Generate hooks with custom error type
+@api('/data')
+class DataApi {
+  @get('/{id}')
+  getData(@path('id') id: string): Promise<Data> {
+    throw autoGeneratedError(id);
+  }
+}
+
 const apiHooks = createExecuteApiHooks<
   { getData: (id: string) => Promise<Data> },
   ApiError
 >({
-  api: { getData },
+  api: new DataApi(),
   errorType: ApiError,
 });
 
@@ -295,6 +299,183 @@ function ApiComponent() {
 }
 ```
 
+#### createQueryApiHooks
+
+🚀 **Automatic Type-Safe Query API Hooks Generation** - Generate fully typed React query hooks from API objects with automatic query state management, auto-execution, and advanced execution control.
+
+The `createQueryApiHooks` function automatically discovers query methods from an API object and creates corresponding React hooks that extend `useQuery`. Each generated hook provides automatic query parameter management, state management, and supports custom execution callbacks with type-safe query access.
+
+**Key Features:**
+
+- **Automatic Method Discovery**: Traverses object properties and prototype chains
+- **Type-Safe Query Hooks**: Full TypeScript inference for query parameters and return types
+- **Query State Management**: Built-in `setQuery` and `getQuery` for parameter management
+- **Auto-Execution**: Optional automatic execution when query parameters change
+- **Execution Control**: `onBeforeExecute` callback for query inspection/modification and abort controller access
+- **Custom Error Types**: Support for specifying error types beyond the default `FetcherError`
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
+
+// Define your API service using decorators
+@api('/users')
+class UserApi {
+  @get('')
+  getUsers(query: UserListQuery, attributes?: Record<string, any>): Promise<User[]> {
+    throw autoGeneratedError(query, attributes);
+  }
+
+  @get('/{id}')
+  getUser(query: { id: string }, attributes?: Record<string, any>): Promise<User> {
+    throw autoGeneratedError(query, attributes);
+  }
+
+  @post('')
+  createUser(query: { name: string; email: string }, attributes?: Record<string, any>): Promise<User> {
+    throw autoGeneratedError(query, attributes);
+  }
+}
+
+const apiHooks = createQueryApiHooks({ api: new UserApi() });
+
+function UserListComponent() {
+  const { loading, result, error, execute, setQuery, getQuery } = apiHooks.useGetUsers({
+    initialQuery: { page: 1, limit: 10 },
+    autoExecute: true,
+    onBeforeExecute: (abortController, query) => {
+      // query is fully typed as UserListQuery
+      console.log('Executing query:', query);
+      // Modify query parameters in place if needed
+      query.page = Math.max(1, query.page);
+    },
+  });
+
+  const handlePageChange = (page: number) => {
+    // Automatically updates query and triggers execution (if autoExecute: true)
+    setQuery({ ...getQuery(), page });
+  };
+
+  if (loading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      <button onClick={() => handlePageChange(2)}>Go to page 2</button>
+      {result?.map(user => (
+        <div key={user.id}>{user.name}</div>
+      ))}
+    </div>
+  );
+}
+
+function UserDetailComponent() {
+  const { result: user, execute } = apiHooks.useGetUser({
+    initialQuery: { id: '123' },
+  });
+
+  return (
+    <div>
+      <button onClick={execute}>Load User</button>
+      {user && <div>User: {user.name}</div>}
+    </div>
+  );
+}
+```
+
+**Custom Error Types:**
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+
+// Define custom error type
+class ApiError extends Error {
+  constructor(
+    public statusCode: number,
+    message: string,
+  ) {
+    super(message);
+  }
+}
+
+// Generate query hooks with custom error type
+@api('/data')
+class DataApi {
+  @get('/{id}')
+  getData(
+    query: { id: string },
+    attributes?: Record<string, any>,
+  ): Promise<Data> {
+    throw autoGeneratedError(query, attributes);
+  }
+}
+
+const apiHooks = createQueryApiHooks<
+  {
+    getData: (
+      query: { id: string },
+      attributes?: Record<string, any>,
+    ) => Promise<Data>;
+  },
+  ApiError
+>({
+  api: new DataApi(),
+  errorType: ApiError,
+});
+
+function MyComponent() {
+  const { error, execute } = apiHooks.useGetData();
+
+  // error is now typed as ApiError | undefined
+  if (error) {
+    console.log('Status code:', error.statusCode); // TypeScript knows about statusCode
+  }
+}
+```
+
+**Advanced Usage with Manual Query Management:**
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+
+const apiHooks = createQueryApiHooks({ api: userApi });
+
+function SearchComponent() {
+  const { loading, result, setQuery, getQuery } = apiHooks.useGetUsers({
+    initialQuery: { search: '', page: 1 },
+    autoExecute: false, // Manual execution control
+  });
+
+  const handleSearch = (searchTerm: string) => {
+    // Update query without automatic execution
+    setQuery({ search: searchTerm, page: 1 });
+  };
+
+  const handleSearchSubmit = () => {
+    // Manually execute with current query
+    apiHooks.useGetUsers().execute();
+  };
+
+  const currentQuery = getQuery(); // Access current query parameters
+
+  return (
+    <div>
+      <input
+        value={currentQuery.search}
+        onChange={(e) => handleSearch(e.target.value)}
+        placeholder="Search users..."
+      />
+      <button onClick={handleSearchSubmit} disabled={loading}>
+        {loading ? 'Searching...' : 'Search'}
+      </button>
+      {result?.map(user => (
+        <div key={user.id}>{user.name}</div>
+      ))}
+    </div>
+  );
+}
+```
+
 ### Core Hooks
 
 #### useExecutePromise Hook

package/README.zh-CN.md

@@ -129,30 +129,26 @@ function App() {
 
 ```typescript jsx
 import { createExecuteApiHooks } from '@ahoo-wang/fetcher-react';
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
 
-// 定义您的 API 对象（可以是类实例或普通对象）
+// 使用装饰器定义您的 API 服务
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
+
+@api('/users')
 class UserApi {
-  async getUser(id: string): Promise<User> {
-    const response = await fetch(`/api/users/${id}`);
-    return response.json();
+  @get('/{id}')
+  getUser(@path('id') id: string): Promise<User> {
+    throw autoGeneratedError(id);
   }
 
-  async createUser(data: { name: string; email: string }): Promise<User> {
-    const response = await fetch('/api/users', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(data),
-    });
-    return response.json();
+  @post('')
+  createUser(@body() data: { name: string; email: string }): Promise<User> {
+    throw autoGeneratedError(data);
   }
 
-  async updateUser(id: string, updates: Partial<User>): Promise<User> {
-    const response = await fetch(`/api/users/${id}`, {
-      method: 'PATCH',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(updates),
-    });
-    return response.json();
+  @patch('/{id}')
+  updateUser(@path('id') id: string, @body() updates: Partial<User>): Promise<User> {
+    throw autoGeneratedError(id, updates);
   }
 }
 
@@ -221,11 +217,19 @@ class ApiError extends Error {
 }
 
 // 使用自定义错误类型生成 hooks
+@api('/data')
+class DataApi {
+  @get('/{id}')
+  getData(@path('id') id: string): Promise<Data> {
+    throw autoGeneratedError(id);
+  }
+}
+
 const apiHooks = createExecuteApiHooks<
   { getData: (id: string) => Promise<Data> },
   ApiError
 >({
-  api: { getData },
+  api: new DataApi(),
   errorType: ApiError,
 });
 
@@ -293,6 +297,183 @@ function ApiComponent() {
 }
 ```
 
+#### createQueryApiHooks
+
+🚀 **自动类型安全查询 API Hooks 生成** - 从 API 对象自动生成完全类型化的 React 查询 hooks，具有自动查询状态管理、自动执行和高级执行控制。
+
+`createQueryApiHooks` 函数自动发现 API 对象中的查询方法，并创建相应的扩展 `useQuery` 的 React hooks。每个生成的 hook 都提供自动查询参数管理、状态管理和对具有类型安全查询访问的自定义执行回调的支持。
+
+**主要特性：**
+
+- **自动方法发现**：遍历对象属性和原型链
+- **类型安全查询 Hooks**：查询参数和返回类型的完整 TypeScript 推断
+- **查询状态管理**：内置 `setQuery` 和 `getQuery` 进行参数管理
+- **自动执行**：查询参数更改时可选的自动执行
+- **执行控制**：`onBeforeExecute` 回调用于查询检查/修改和中止控制器访问
+- **自定义错误类型**：支持指定超出默认 `FetcherError` 的错误类型
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+import { api, get, post, patch, path, body, autoGeneratedError } from '@ahoo-wang/fetcher-decorator';
+
+// 使用装饰器定义您的 API 服务
+@api('/users')
+class UserApi {
+  @get('')
+  getUsers(query: UserListQuery, attributes?: Record<string, any>): Promise<User[]> {
+    throw autoGeneratedError(query, attributes);
+  }
+
+  @get('/{id}')
+  getUser(query: { id: string }, attributes?: Record<string, any>): Promise<User> {
+    throw autoGeneratedError(query, attributes);
+  }
+
+  @post('')
+  createUser(query: { name: string; email: string }, attributes?: Record<string, any>): Promise<User> {
+    throw autoGeneratedError(query, attributes);
+  }
+}
+
+const apiHooks = createQueryApiHooks({ api: new UserApi() });
+
+function UserListComponent() {
+  const { loading, result, error, execute, setQuery, getQuery } = apiHooks.useGetUsers({
+    initialQuery: { page: 1, limit: 10 },
+    autoExecute: true,
+    onBeforeExecute: (abortController, query) => {
+      // query 是完全类型化的 UserListQuery
+      console.log('正在执行查询:', query);
+      // 如果需要，可以就地修改查询参数
+      query.page = Math.max(1, query.page);
+    },
+  });
+
+  const handlePageChange = (page: number) => {
+    // 自动更新查询并触发执行（如果 autoExecute: true）
+    setQuery({ ...getQuery(), page });
+  };
+
+  if (loading) return <div>正在加载...</div>;
+  if (error) return <div>错误: {error.message}</div>;
+
+  return (
+    <div>
+      <button onClick={() => handlePageChange(2)}>转到第2页</button>
+      {result?.map(user => (
+        <div key={user.id}>{user.name}</div>
+      ))}
+    </div>
+  );
+}
+
+function UserDetailComponent() {
+  const { result: user, execute } = apiHooks.useGetUser({
+    initialQuery: { id: '123' },
+  });
+
+  return (
+    <div>
+      <button onClick={execute}>加载用户</button>
+      {user && <div>用户: {user.name}</div>}
+    </div>
+  );
+}
+```
+
+**自定义错误类型：**
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+
+// 定义自定义错误类型
+class ApiError extends Error {
+  constructor(
+    public statusCode: number,
+    message: string,
+  ) {
+    super(message);
+  }
+}
+
+// 使用自定义错误类型生成查询 hooks
+@api('/data')
+class DataApi {
+  @get('/{id}')
+  getData(
+    query: { id: string },
+    attributes?: Record<string, any>,
+  ): Promise<Data> {
+    throw autoGeneratedError(query, attributes);
+  }
+}
+
+const apiHooks = createQueryApiHooks<
+  {
+    getData: (
+      query: { id: string },
+      attributes?: Record<string, any>,
+    ) => Promise<Data>;
+  },
+  ApiError
+>({
+  api: new DataApi(),
+  errorType: ApiError,
+});
+
+function MyComponent() {
+  const { error, execute } = apiHooks.useGetData();
+
+  // error 现在类型化为 ApiError | undefined
+  if (error) {
+    console.log('状态码:', error.statusCode); // TypeScript 知道 statusCode
+  }
+}
+```
+
+**高级用法与手动查询管理：**
+
+```typescript jsx
+import { createQueryApiHooks } from '@ahoo-wang/fetcher-react';
+
+const apiHooks = createQueryApiHooks({ api: userApi });
+
+function SearchComponent() {
+  const { loading, result, setQuery, getQuery } = apiHooks.useGetUsers({
+    initialQuery: { search: '', page: 1 },
+    autoExecute: false, // 手动执行控制
+  });
+
+  const handleSearch = (searchTerm: string) => {
+    // 更新查询而不自动执行
+    setQuery({ search: searchTerm, page: 1 });
+  };
+
+  const handleSearchSubmit = () => {
+    // 使用当前查询手动执行
+    apiHooks.useGetUsers().execute();
+  };
+
+  const currentQuery = getQuery(); // 访问当前查询参数
+
+  return (
+    <div>
+      <input
+        value={currentQuery.search}
+        onChange={(e) => handleSearch(e.target.value)}
+        placeholder="搜索用户..."
+      />
+      <button onClick={handleSearchSubmit} disabled={loading}>
+        {loading ? '搜索中...' : '搜索'}
+      </button>
+      {result?.map(user => (
+        <div key={user.id}>{user.name}</div>
+      ))}
+    </div>
+  );
+}
+```
+
 ### 核心 Hooks
 
 #### useExecutePromise

package/dist/api/apiHooks.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Shared utilities and types for API hooks generation.
+ */
+/**
+ * Converts a method name to a React hook name by prefixing with 'use' and capitalizing the first letter.
+ * @param methodName - The method name to convert.
+ * @returns The converted hook name.
+ * @throws {Error} If methodName is empty or null.
+ * @example
+ * methodNameToHookName('getUser') // 'useGetUser'
+ * methodNameToHookName('createPost') // 'useCreatePost'
+ * methodNameToHookName('APIGetData') // 'useAPIGetData'
+ */
+export declare function methodNameToHookName(methodName: string): string;
+/**
+ * Collects all function methods from an object and its prototype chain.
+ * @param obj - The object to collect methods from.
+ * @returns A map of method names to bound methods.
+ */
+export declare function collectMethods<T extends (...args: any[]) => Promise<any>>(obj: Record<string, any>): Map<string, T>;
+/**
+ * Common configuration options for API hooks creation functions.
+ * @template API - The API object type.
+ */
+export interface CreateApiHooksOptions<API extends Record<string, any>> {
+    /**
+     * The API object containing methods to be wrapped into hooks.
+     */
+    api: API;
+}
+/**
+ * Utility type to extract the hook name from a method name.
+ * @template K - The method name key.
+ */
+export type HookName<K extends string> = `use${Capitalize<K>}`;
+/**
+ * Utility type to check if a value is a function that returns a Promise.
+ * @template T - The value to check.
+ */
+export type IsPromiseFunction<T> = T extends (...args: any[]) => Promise<any> ? true : false;
+/**
+ * Utility type to extract the parameters of a promise-returning function.
+ * @template T - The function type.
+ */
+export type FunctionParameters<T> = T extends (...args: infer P) => Promise<any> ? P : never;
+/**
+ * Utility type to extract the resolved return type of a promise-returning function.
+ * @template T - The function type.
+ */
+export type FunctionReturnType<T> = T extends (...args: any[]) => Promise<infer R> ? Awaited<R> : never;
+/**
+ * Utility type for API method signatures.
+ * @template TArgs - Parameter types.
+ * @template TReturn - Return type.
+ */
+export type ApiMethod<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => Promise<TReturn>;
+/**
+ * Utility type for query method signatures (with query, attributes, abortController).
+ * @template Q - Query type.
+ * @template TReturn - Return type.
+ */
+export type QueryMethod<Q = any, TReturn = any> = (query: Q, attributes?: Record<string, any>, abortController?: AbortController) => Promise<TReturn>;
+/**
+ * Common callback type for pre-execution hooks.
+ * @template TParams - The parameters type passed to the callback.
+ */
+export type OnBeforeExecuteCallback<TParams> = (abortController: AbortController | undefined, params: TParams) => void;
+/**
+ * Utility type to create API hooks mapping.
+ * @template API - The API object type.
+ * @template MethodType - The method signature type.
+ * @template HookType - The hook function type.
+ * @template E - Error type.
+ */
+export type ApiHooksMapping<API extends Record<string, any>, MethodType extends (...args: any[]) => Promise<any>, HookType> = {
+    [K in keyof API as API[K] extends MethodType ? HookName<string & K> : never]: API[K] extends MethodType ? HookType : never;
+};
+//# sourceMappingURL=apiHooks.d.ts.map

package/dist/api/apiHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHooks.d.ts","sourceRoot":"","sources":["../../src/api/apiHooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACvE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACvB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CA6BhB;AAMD;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACpE;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;AAE/D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GACzE,IAAI,GACJ,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAC5E,CAAC,GACD,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,CAC5C,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,OAAO,CAAC,CAAC,CAAC,GACV,KAAK,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,IAAI,CAClE,GAAG,IAAI,EAAE,KAAK,KACX,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAChD,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,eAAe,CAAC,EAAE,eAAe,KAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;GAGG;AACH,MAAM,MAAM,uBAAuB,CAAC,OAAO,IAAI,CAC7C,eAAe,EAAE,eAAe,GAAG,SAAS,EAC5C,MAAM,EAAE,OAAO,KACZ,IAAI,CAAC;AAEV;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CACzB,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,UAAU,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACnD,QAAQ,IACN;KACD,CAAC,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,UAAU,GACxC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GACpB,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,UAAU,GAAG,QAAQ,GAAG,KAAK;CACzD,CAAC"}

package/dist/api/createExecuteApiHooks.d.ts

@@ -1,14 +1,17 @@
 import { UseExecutePromiseReturn, UseExecutePromiseOptions } from '../core';
 import { FetcherError } from '@ahoo-wang/fetcher';
+import { CreateApiHooksOptions, HookName, ApiMethod, FunctionParameters, FunctionReturnType, OnBeforeExecuteCallback } from './apiHooks';
 /**
  * Configuration options for createExecuteApiHooks.
  * @template API - The API object type containing methods that return promises.
  */
-export interface CreateExecuteApiHooksOptions<API extends Record<string, any>> {
-    /**
-     * The API object containing methods to be wrapped into hooks.
-     */
-    api: API;
+export interface CreateExecuteApiHooksOptions<API extends Record<string, any>> extends CreateApiHooksOptions<API> {
+}
+/**
+ * Configuration options for createQueryApiHooks.
+ * @template API - The API object type containing query methods.
+ */
+export interface CreateQueryApiHooksOptions<API extends Record<string, any>> extends CreateApiHooksOptions<API> {
 }
 /**
  * Options for useApiMethodExecute hook.
@@ -34,7 +37,7 @@ export interface UseApiMethodExecuteOptions<TArgs = any[], TData = any, E = Fetc
      *   }
      * }
      */
-    onBeforeExecute?: (abortController: AbortController, args: TArgs) => void;
+    onBeforeExecute?: OnBeforeExecuteCallback<TArgs>;
 }
 /**
  * The return type of createExecuteApiHooks.
@@ -45,8 +48,8 @@ export interface UseApiMethodExecuteOptions<TArgs = any[], TData = any, E = Fetc
  * @template E - The error type for all hooks (defaults to FetcherError).
  */
 export type APIHooks<API extends Record<string, any>, E = FetcherError> = {
-    [K in keyof API as API[K] extends (...args: any[]) => Promise<any> ? `use${Capitalize<string & K>}` : never]: API[K] extends (...args: any[]) => Promise<any> ? (options?: UseApiMethodExecuteOptions<Parameters<API[K]>, Awaited<ReturnType<API[K]>>, E>) => UseExecutePromiseReturn<Awaited<ReturnType<API[K]>>, E> & {
-        execute: (...params: Parameters<API[K]>) => Promise<void>;
+    [K in keyof API as API[K] extends ApiMethod ? HookName<string & K> : never]: API[K] extends ApiMethod ? (options?: UseApiMethodExecuteOptions<FunctionParameters<API[K]>, FunctionReturnType<API[K]>, E>) => UseExecutePromiseReturn<FunctionReturnType<API[K]>, E> & {
+        execute: (...params: FunctionParameters<API[K]>) => Promise<void>;
     } : never;
 };
 /**

package/dist/api/createExecuteApiHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createExecuteApiHooks.d.ts","sourceRoot":"","sources":["../../src/api/createExecuteApiHooks.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,4BAA4B,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3E;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;CACV;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B,CACzC,KAAK,GAAG,GAAG,EAAE,EACb,KAAK,GAAG,GAAG,EACX,CAAC,GAAG,YAAY,CAChB,SAAQ,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;CAC3E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,IAAI;KACvE,CAAC,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAC9D,MAAM,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAC9B,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GACvD,CACA,OAAO,CAAC,EAAE,0BAA0B,CAClC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAClB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAC3B,CAAC,CACF,KACE,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;QAC7D,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,GACC,KAAK;CACV,CAAC;AAkGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,CAAC,GAAG,YAAY,EAChB,OAAO,EAAE,4BAA4B,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAa9D"}
+{"version":3,"file":"createExecuteApiHooks.d.ts","sourceRoot":"","sources":["../../src/api/createExecuteApiHooks.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAGL,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,4BAA4B,CAC3C,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC/B,SAAQ,qBAAqB,CAAC,GAAG,CAAC;CAAG;AAEvC;;;GAGG;AACH,MAAM,WAAW,0BAA0B,CACzC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC/B,SAAQ,qBAAqB,CAAC,GAAG,CAAC;CAAG;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B,CACzC,KAAK,GAAG,GAAG,EAAE,EACb,KAAK,GAAG,GAAG,EACX,CAAC,GAAG,YAAY,CAChB,SAAQ,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAC,KAAK,CAAC,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,IAAI;KACvE,CAAC,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,SAAS,GACvC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,GACpB,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,SAAS,GAChC,CACE,OAAO,CAAC,EAAE,0BAA0B,CAClC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAC1B,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAC1B,CAAC,CACF,KACE,uBAAuB,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;QAC5D,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACnE,GACD,KAAK;CACV,CAAC;AA4DF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,CAAC,GAAG,YAAY,EAChB,OAAO,EAAE,4BAA4B,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAa9D"}