fetchwire 1.0.1 → 2.1.0

package/README.md

@@ -7,35 +7,38 @@ A lightweight, focused API fetching library for **React and React Native** appli
 - Handle errors consistently.
 
 ### When to use fetchwire
+
 - **React / React Native apps** that:
-  - Want a **simple**, centralized way to call HTTP APIs.
+  - Want a **simple**, centralized way for API fetching setup.
   - Prefer plain hooks over a heavier state management or query library.
   - Need basic tag-based invalidation without a full cache layer.
 
 ### When not to use fetchwire
+
 - Consider a more full-featured solution (e.g. TanStack Query / React Query, SWR, RTK Query) if:
   - You need advanced, automatic caching strategies.
   - You need built-in pagination helpers, infinite queries.
   - You need a more powerful data-fetching library and you want to avoid overlap.
 
 ## Support
+
 If you find **fetchwire** helpful and want to support its development, you can buy me a coffee via:
 
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/doanvinhphu)
 [![PayPal](https://img.shields.io/badge/PayPal-004595?style=for-the-badge&logo=paypal&logoColor=white)](https://paypal.me/doanvinhphu)
 
-Your support helps maintain the library and keep it up to date!
-
 ## Features
+
 - **Global API fetching configuration `initWire`**
   - Configure `baseUrl`, default headers, and how to read the auth token.
   - Optionally register global interceptors for 401/403/other errors.
   - Converts server/network errors into a typed `ApiError`.
 
-- **React hooks for data fetching and mutation with Tag-based invalidation**
-  - **`useFetchFn<T>`** for data fetching
-  - **`useMutationFn<T>`** for mutations
+- **React hooks for data fetching and mutation with tag-based invalidation**
+  - **`useFetchFn`** for data fetching
+  - **`useMutationFn`** for mutations
   - With a simple, explicit way to refetch related data through tags
+
 ---
 
 ## Installation
@@ -49,6 +52,7 @@ pnpm add fetchwire
 ```
 
 ### Peer expectations
+
 - TypeScript is recommended but not required.
 - For React Native / Expo, make sure the global `fetch` is available (default in modern RN/Expo).
 
@@ -73,6 +77,7 @@ export function setupWire() {
       'x-client': 'web',
     },
     getToken: async () => {
+      // Called on each request — return the current access token or null.
       // Read token from localStorage (or any storage you prefer)
       return localStorage.getItem('access_token');
     },
@@ -106,7 +111,7 @@ setupWire();
 ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
   <React.StrictMode>
     <App />
-  </React.StrictMode>,
+  </React.StrictMode>
 );
 ```
 
@@ -160,18 +165,17 @@ You can organize similar helpers for users, invoices, organizations, uploads, et
 
 ### 2. Fetch data with `useFetchFn`
 
-`useFetchFn<T>` is a generic hook that manages state for running an async function returning `{ data: T }`.
+`useFetchFn` is a generic hook that manages state for running an async function returning `HttpResponse<T>`, where `T` is **inferred** from your API helper.
 
 **Key ideas:**
 
-- You **do not** pass the async function into the hook directly.
-- Instead, the hook returns `executeFetchFn`, which you call with a function that performs your API request.
+- You pass a **pre-typed API helper** (e.g. `getTodosApi`) into the hook once.
 - The hook tracks:
   - `data: T | null`
   - `isLoading: boolean`
   - `isRefreshing: boolean`
   - `error: ApiError | null`
-  - `executeFetchFn(fetchFn)`
+  - `executeFetchFn()`
   - `refreshFetchFn()`
 
 Example: loading and refreshing a todo list in a React component:
@@ -190,12 +194,12 @@ export function TodoList() {
     error,
     executeFetchFn: fetchTodos,
     refreshFetchFn: refreshTodos,
-  } = useFetchFn<Todo[]>({
+  } = useFetchFn(getTodosApi, {
     tags: ['todos'],
   });
 
   useEffect(() => {
-    fetchTodos(() => getTodosApi());
+    fetchTodos();
   }, [fetchTodos]);
 
   if (isLoading) return <div>Loading...</div>;
@@ -223,7 +227,7 @@ export function TodoList() {
 
 ### 3. Mutate data with `useMutationFn`
 
-`useMutationFn<T>` is a hook for mutations (create/update/delete). It:
+`useMutationFn` is a hook for mutations (create/update/delete). It:
 
 - Tracks `data` and `isMutating`.
 - Lets you invalidate **tags** after a successful mutation.
@@ -237,9 +241,12 @@ const {
   isMutating,
   executeMutationFn,
   reset,
-} = useMutationFn<T>({ invalidatesTags?: string[] });
+} = useMutationFn(mutationFn, { invalidatesTags?: string[] });
 ```
 
+- If `mutationFn` has **no parameters**, call `executeMutationFn({ onSuccess, onError })`.
+- If `mutationFn` has **one parameter** (e.g. update payload), call `executeMutationFn(variables, { onSuccess, onError })`.
+
 Example: creating and toggling todos with `useMutationFn`:
 
 ```tsx
@@ -259,36 +266,38 @@ export function TodoActions() {
   const {
     isMutating: isCreating,
     executeMutationFn: createTodo,
-  } = useMutationFn<Todo>({
+  } = useMutationFn(() => createTodoApi({ title }), {
     invalidatesTags: ['todos'],
   });
 
   const {
     isMutating: isToggling,
     executeMutationFn: toggleTodo,
-  } = useMutationFn<Todo>({
-    invalidatesTags: ['todos'],
-  });
+  } = useMutationFn(
+    (id: string) => toggleTodoApi(id),
+    { invalidatesTags: ['todos'] }
+  );
 
   const {
     isMutating: isDeleting,
     executeMutationFn: deleteTodo,
-  } = useMutationFn<null>({
-    invalidatesTags: ['todos'],
-  });
+  } = useMutationFn(
+    (id: string) => deleteTodoApi(id),
+    { invalidatesTags: ['todos'] }
+  );
 
   const handleCreate = (e: FormEvent) => {
     e.preventDefault();
     if (!title.trim()) return;
 
-    createTodo(() => createTodoApi({ title }), {
+    createTodo({
       onSuccess: () => setTitle(''),
     });
   };
 
-  // Example usage of toggleTodo and deleteTodo in your UI:
-  // toggleTodo(() => toggleTodoApi(todoId))
-  // deleteTodo(() => deleteTodoApi(todoId))
+  // With variables, pass payload first then options:
+  // toggleTodo(todoId, { onSuccess: () => ..., onError: (error) => ... });
+  // deleteTodo(todoId, { onSuccess: () => ..., onError: (error) => ... });
 
   return (
     <form onSubmit={handleCreate}>
@@ -311,8 +320,8 @@ export function TodoActions() {
 
 Tags provide a simple way to coordinate refetches across your app:
 
-- `useFetchFn({ tags: [...] })` subscribes the hook to one or more **tags**.
-- `useMutationFn({ invalidatesTags: [...] })` emits those tags after a **successful** mutation.
+- `useFetchFn(fetchFn, { tags: [...] })` subscribes the hook to one or more **tags**.
+- `useMutationFn(mutationFn, { invalidatesTags: [...] })` emits those tags after a **successful** mutation.
 - When a tag is emitted, all subscribed fetch hooks will automatically **call `refreshFetchFn`**.
 
 This pattern keeps your code explicit and small, without introducing a full query cache library.
@@ -376,14 +385,19 @@ With `useMutationFn`, you commonly handle errors with `onError`:
 ```tsx
 import { ApiError } from 'fetchwire';
 
-executeMutationFn(() => someMutationApi(), {
-  onSuccess: () => {
-    // success logic
-  },
+// No variables: pass only options
+executeMutationFn({
+  onSuccess: () => { /* success logic */ },
   onError: (error: ApiError) => {
     Alert.alert('Login failed', error.message || 'Unexpected error');
   },
 });
+
+// With variables: pass variables first, then options
+executeMutationFn(payload, {
+  onSuccess: (data) => { /* ... */ },
+  onError: (error: ApiError) => { /* ... */ },
+});
 ```
 
 You can also read `error` directly from `useFetchFn` state if you want to render error messages in your UI.
@@ -415,7 +429,7 @@ function initWire(config: WireConfig): void;
 
 - **`baseUrl`**: Base API URL (e.g. `'https://api.example.com'`).
 - **`headers`**: Global headers to apply to every request.
-- **`getToken`**: Async function that returns a bearer token or `null`. If present, fetchwire adds `Authorization: Bearer <token>`.
+- **`getToken`**: Async function called on each request; return the current access token or `null`. If a non-empty string is returned, fetchwire sends it as `Authorization: Bearer <token>`.
 - **`interceptors`** (optional):
   - `onUnauthorized(error)`: Called when a 401 is returned.
   - `onForbidden(error)`: Called when a 403 is returned.
@@ -452,7 +466,7 @@ function getWireConfig(): WireConfig;
 ```ts
 async function wireApi<T>(
   endpoint: string,
-  options?: RequestInit & { headers?: Record<string, string> },
+  options?: RequestInit & { headers?: Record<string, string> }
 ): Promise<HttpResponse<T>>;
 ```
 
@@ -471,71 +485,76 @@ const result = await wireApi<UserResponse>('/user/me', { method: 'GET' });
 
 ---
 
-### `useFetchFn<T>(options?)`
+### `useFetchFn<T>(fetchFn, options?)`
 
 ```ts
 type FetchOptions = {
   tags?: string[];
 };
 
-function useFetchFn<T>(options?: FetchOptions): {
+function useFetchFn<T>(
+  fetchFn: () => Promise<HttpResponse<T>>,
+  options?: FetchOptions
+): {
   data: T | null;
   isLoading: boolean;
   isRefreshing: boolean;
   error: ApiError | null;
-  executeFetchFn: (fetchFn: () => Promise<{ data: T }>) => Promise<{ data: T } | null>;
-  refreshFetchFn: () => Promise<{ data: T } | null> | null;
+  executeFetchFn: () => Promise<HttpResponse<T> | null>;
+  refreshFetchFn: () => Promise<HttpResponse<T> | null> | null;
 };
 ```
 
+- **`fetchFn`**: Async function (e.g. an API helper using `wireApi<T>`). Type `T` is inferred from its return type.
 - **`options.tags`**: Optional array of tag strings to subscribe to. When a mutation invalidates these tags, `refreshFetchFn` is called automatically.
-- **`executeFetchFn`**:
-  - Executes the provided async function.
-  - Updates `data`, `isLoading`, `error`.
-  - Stores the last function so it can be used by `refreshFetchFn`.
-- **`refreshFetchFn`**:
-  - Re-runs the last `executeFetchFn` call, setting `isRefreshing` during the call.
+- **`executeFetchFn()`**: Runs `fetchFn` (no arguments). Updates `data`, `isLoading`, `error`.
+- **`refreshFetchFn()`**: Re-runs the same `fetchFn`, setting `isRefreshing` during the call.
 
 ---
 
-### `useMutationFn<T>(options?)`
+### `useMutationFn<T>(mutationFn, options?)` (no variables)  
+### `useMutationFn<T, TVariables>(mutationFn, options?)` (with variables)
 
 ```ts
 type MutationOptions = {
   invalidatesTags?: string[];
 };
 
-type ExecuteOptions<T> = {
-  onSuccess?: (data: T | null) => void;
+type ExecuteMutationOptions<T> = {
+  onSuccess?: (data: T) => void;
   onError?: (error: ApiError) => void;
 };
 
-function useMutationFn<T>(options?: MutationOptions): {
+// No variables: mutationFn has no parameters
+function useMutationFn<T>(
+  mutationFn: () => Promise<HttpResponse<T>>,
+  options?: MutationOptions
+): {
   data: T | null;
   isMutating: boolean;
-  executeMutationFn: (
-    mutationFn: () => Promise<{ data: T }>,
-    executeOptions?: ExecuteOptions<T>,
-  ) => Promise<{ data: T } | null>;
+  executeMutationFn: (executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+  reset: () => void;
+};
+
+// With variables: mutationFn accepts one argument (e.g. update payload)
+function useMutationFn<T, TVariables>(
+  mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>,
+  options?: MutationOptions
+): {
+  data: T | null;
+  isMutating: boolean;
+  executeMutationFn: (variables: TVariables, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
   reset: () => void;
 };
 ```
 
-- **`options.invalidatesTags`**:
-  - List of tags to emit after a **successful** mutation.
-  - All `useFetchFn` hooks that subscribed to any of these tags will be refreshed.
+- **`mutationFn`**: Async function that returns `Promise<HttpResponse<T>>`. If it takes one parameter, `executeMutationFn` will require that variable as the first argument.
+- **`options.invalidatesTags`**: Tags to emit after a **successful** mutation; subscribed `useFetchFn` hooks refresh.
 - **`executeMutationFn`**:
-  - Executes the provided `mutationFn`.
-  - Sets `isMutating` while running.
-  - On success:
-    - Updates `data`.
-    - Emits all `invalidatesTags`.
-    - Calls `onSuccess` with `response.data` (or `null`).
-  - On error:
-    - Resets `isMutating`.
-    - Calls `onError` with an `ApiError` instance.
-- **`reset`**:
-  - Resets `data` and `isMutating` to initial values.
+  - **No variables:** `executeMutationFn({ onSuccess, onError })`.
+  - **With variables:** `executeMutationFn(variables, { onSuccess, onError })`.
+  - Sets `isMutating` while running; on success updates `data`, emits tags, calls `onSuccess`; on error calls `onError`.
+- **`reset()`**: Resets `data` and `isMutating` to initial values.
 
 ---
 
@@ -546,4 +565,3 @@ function useMutationFn<T>(options?: MutationOptions): {
 Copyright (c) Doanvinhphu
 
 See the `LICENSE` file for details (or include the standard MIT text directly in your repository).
-

package/dist/index.d.mts

@@ -148,9 +148,9 @@ declare function wireApi<T>(endpoint: string, options?: RequestInit): Promise<Ht
  * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.
  * @returns The state of the fetch and the fetch function.
  */
-declare function useFetchFn<T>(options?: FetchOptions): {
-    executeFetchFn: (fetchFn: () => Promise<HttpResponse<T>>) => Promise<HttpResponse<T> | null>;
-    refreshFetchFn: () => Promise<HttpResponse<T> | null> | null;
+declare function useFetchFn<T>(fetchFn: () => Promise<HttpResponse<T>>, options?: FetchOptions): {
+    executeFetchFn: () => Promise<HttpResponse<T> | null>;
+    refreshFetchFn: () => Promise<HttpResponse<T> | null>;
     data: T | null;
     isLoading: boolean;
     isRefreshing: boolean;
@@ -158,15 +158,30 @@ declare function useFetchFn<T>(options?: FetchOptions): {
 };
 
 /**
- * A hook for executing a mutation function and managing the state of the mutation.
- * @param options - Has invalidatesTags property that will trigger refetching of the useFetchFn with the given tags.
- * @returns The state of the mutation and the mutation function.
+ * Mutation without variables. Use when the payload is fixed (e.g. from closure/state).
+ *
+ * @param mutationFn - Function that returns a promise (e.g. `() => createApi()`).
+ * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.
+ * @returns executeMutationFn(options?) — call with no args or only options: `executeMutationFn()` or `executeMutationFn({ onSuccess, onError })`.
  */
-declare function useMutationFn<T>(options?: MutationOptions): {
-    executeMutationFn: (mutationFn: () => Promise<HttpResponse<T>>, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+declare function useMutationFn<T>(mutationFn: (variables: void) => Promise<HttpResponse<T>>, options?: MutationOptions): {
+    data: T | null;
+    isMutating: boolean;
+    executeMutationFn: (executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
     reset: () => void;
+};
+/**
+ * Mutation with variables. Use when the payload is passed at call time (e.g. update forms, PATCH body).
+ *
+ * @param mutationFn - Function that receives variables and returns a promise (e.g. `(data) => updateApi(id, data)`).
+ * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.
+ * @returns executeMutationFn(variables, options?) — you must pass variables first, then optional callbacks.
+ */
+declare function useMutationFn<T, TVariables>(mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>, options?: MutationOptions): {
     data: T | null;
     isMutating: boolean;
+    executeMutationFn: (variables: TVariables, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+    reset: () => void;
 };
 
 export { ApiError, type ExecuteMutationOptions, type FetchOptions, type HttpResponse, type MutationOptions, type WireConfig, type WireInterceptors, getWireConfig, initWire, updateWireConfig, useFetchFn, useMutationFn, wireApi };

package/dist/index.d.ts

@@ -148,9 +148,9 @@ declare function wireApi<T>(endpoint: string, options?: RequestInit): Promise<Ht
  * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.
  * @returns The state of the fetch and the fetch function.
  */
-declare function useFetchFn<T>(options?: FetchOptions): {
-    executeFetchFn: (fetchFn: () => Promise<HttpResponse<T>>) => Promise<HttpResponse<T> | null>;
-    refreshFetchFn: () => Promise<HttpResponse<T> | null> | null;
+declare function useFetchFn<T>(fetchFn: () => Promise<HttpResponse<T>>, options?: FetchOptions): {
+    executeFetchFn: () => Promise<HttpResponse<T> | null>;
+    refreshFetchFn: () => Promise<HttpResponse<T> | null>;
     data: T | null;
     isLoading: boolean;
     isRefreshing: boolean;
@@ -158,15 +158,30 @@ declare function useFetchFn<T>(options?: FetchOptions): {
 };
 
 /**
- * A hook for executing a mutation function and managing the state of the mutation.
- * @param options - Has invalidatesTags property that will trigger refetching of the useFetchFn with the given tags.
- * @returns The state of the mutation and the mutation function.
+ * Mutation without variables. Use when the payload is fixed (e.g. from closure/state).
+ *
+ * @param mutationFn - Function that returns a promise (e.g. `() => createApi()`).
+ * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.
+ * @returns executeMutationFn(options?) — call with no args or only options: `executeMutationFn()` or `executeMutationFn({ onSuccess, onError })`.
  */
-declare function useMutationFn<T>(options?: MutationOptions): {
-    executeMutationFn: (mutationFn: () => Promise<HttpResponse<T>>, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+declare function useMutationFn<T>(mutationFn: (variables: void) => Promise<HttpResponse<T>>, options?: MutationOptions): {
+    data: T | null;
+    isMutating: boolean;
+    executeMutationFn: (executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
     reset: () => void;
+};
+/**
+ * Mutation with variables. Use when the payload is passed at call time (e.g. update forms, PATCH body).
+ *
+ * @param mutationFn - Function that receives variables and returns a promise (e.g. `(data) => updateApi(id, data)`).
+ * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.
+ * @returns executeMutationFn(variables, options?) — you must pass variables first, then optional callbacks.
+ */
+declare function useMutationFn<T, TVariables>(mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>, options?: MutationOptions): {
     data: T | null;
     isMutating: boolean;
+    executeMutationFn: (variables: TVariables, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+    reset: () => void;
 };
 
 export { ApiError, type ExecuteMutationOptions, type FetchOptions, type HttpResponse, type MutationOptions, type WireConfig, type WireInterceptors, getWireConfig, initWire, updateWireConfig, useFetchFn, useMutationFn, wireApi };

package/dist/index.js

@@ -142,7 +142,7 @@ var EventEmitter = class {
 var eventEmitter = new EventEmitter();
 
 // src/hook/use-fetch-fn.ts
-function useFetchFn(options) {
+function useFetchFn(fetchFn, options) {
   const [state, setState] = (0, import_react.useState)({
     data: null,
     isLoading: false,
@@ -158,7 +158,7 @@ function useFetchFn(options) {
     };
   }, []);
   const execute = (0, import_react.useCallback)(
-    async (fetchFn, execOptions) => {
+    async (execOptions) => {
       lastFetchFn.current = fetchFn;
       setState((prev) => ({
         ...prev,
@@ -193,17 +193,10 @@ function useFetchFn(options) {
     []
   );
   const executeFetchFn = (0, import_react.useCallback)(
-    (fetchFn) => {
-      return execute(fetchFn, { isRefresh: false });
-    },
+    () => execute({ isRefresh: false }),
     [execute]
   );
-  const refreshFetchFn = (0, import_react.useCallback)(() => {
-    if (lastFetchFn.current) {
-      return execute(lastFetchFn.current, { isRefresh: true });
-    }
-    return null;
-  }, [execute]);
+  const refreshFetchFn = (0, import_react.useCallback)(() => execute({ isRefresh: true }), [execute]);
   (0, import_react.useEffect)(() => {
     if (!options?.tags || options.tags.length === 0) return;
     const subscriptions = options.tags.map(
@@ -218,7 +211,7 @@ function useFetchFn(options) {
 
 // src/hook/use-mutation-fn.ts
 var import_react2 = require("react");
-function useMutationFn(options) {
+function useMutationFn(mutationFn, options) {
   const [state, setState] = (0, import_react2.useState)({
     data: null,
     isMutating: false
@@ -231,19 +224,22 @@ function useMutationFn(options) {
     };
   }, []);
   const executeMutationFn = (0, import_react2.useCallback)(
-    async (mutationFn, executeOptions) => {
+    async (firstArg, secondArg) => {
+      const hasTwoArgs = secondArg !== void 0;
+      const variables = hasTwoArgs ? firstArg : void 0;
+      const executeOptions = hasTwoArgs ? secondArg : firstArg;
       setState((prev) => ({ ...prev, isMutating: true }));
       try {
-        const response = await mutationFn();
+        const response = await mutationFn(variables);
         if (isMounted.current) {
           setState({
-            data: response.data || null,
+            data: response.data ?? null,
             isMutating: false
           });
           options?.invalidatesTags?.forEach((tag) => {
             eventEmitter.emit(tag);
           });
-          if (response.data) executeOptions?.onSuccess?.(response.data);
+          if (response.data != null) executeOptions?.onSuccess?.(response.data);
           else executeOptions?.onSuccess?.(null);
         }
         return response;
@@ -254,12 +250,12 @@ function useMutationFn(options) {
             data: null,
             isMutating: false
           });
-          if (apiError) executeOptions?.onError?.(apiError);
+          executeOptions?.onError?.(apiError);
         }
         return null;
       }
     },
-    [options?.invalidatesTags]
+    [mutationFn, options?.invalidatesTags]
   );
   const reset = (0, import_react2.useCallback)(() => {
     setState({ data: null, isMutating: false });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/util/api-error.ts","../src/core/config.ts","../src/core/wire.ts","../src/hook/use-fetch-fn.ts","../src/core/event-emitter.ts","../src/hook/use-mutation-fn.ts"],"sourcesContent":["export * from './interface';\nexport * from './util/api-error';\nexport * from './core/config';\nexport * from './core/wire';\nexport * from './hook/use-fetch-fn';\nexport * from './hook/use-mutation-fn';\n","export class ApiError extends Error {\n  public errorCode?: string;\n  public statusCode?: number;\n\n  constructor(message: string, errorCode?: string, statusCode?: number) {\n    super(message);\n    this.name = 'ApiError';\n    this.errorCode = errorCode;\n    this.statusCode = statusCode;\n  }\n}","import { WireConfig } from '../interface';\n\nlet globalWireConfig: WireConfig | null = null;\n\n/**\n * Initializes the library with mandatory configurations.\n * Must be executed at the application entry point before any API calls.\n * @param config - The required configuration object including baseUrl and getToken.\n */\nexport const initWire = (config: WireConfig): void => {\n  globalWireConfig = {\n    ...config,\n    headers: config.headers || {},\n  };\n};\n\n/**\n * Updates the existing configuration.\n * Merges new headers with existing ones and overrides other provided fields.\n * @param config - A partial configuration object to update.\n */\nexport const updateWireConfig = (config: Partial<WireConfig>): void => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n\n  globalWireConfig = {\n    ...globalWireConfig,\n    ...config,\n    headers: {\n      ...globalWireConfig.headers,\n      ...config.headers,\n    },\n  };\n};\n\n/**\n * Retrieves the current global configuration state.\n * @throws Error if the configuration state is null.\n * @returns The validated WireConfig object.\n */\nexport const getWireConfig = (): WireConfig => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n  return globalWireConfig;\n};","import { HttpResponse } from '../interface';\nimport { ApiError } from '../util/api-error';\nimport { getWireConfig } from './config';\n\n/**\n * Sends an API request and returns the response.\n * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.\n * @param options - The request options is a RequestInit object.\n */\nexport async function wireApi<T>(\n  endpoint: string,\n  options: RequestInit = {}\n): Promise<HttpResponse<T>> {\n  const config = getWireConfig();\n  const url = `${config.baseUrl}${endpoint}`;\n  const accessToken = await config.getToken();\n\n  const headers: HeadersInit = {\n    'Content-Type': 'application/json',\n    ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {}),\n    ...config.headers,\n    ...options.headers,\n  };\n\n  try {\n    const response = await fetch(url, { ...options, headers });\n\n    if (!response.ok) {\n      let errorData;\n      try {\n        errorData = await response.json();\n      } catch {\n        errorData = { message: 'Unknown server error', error: 'UNKNOWN' };\n      }\n\n      const apiError = new ApiError(\n        errorData.message,\n        errorData.error,\n        response.status\n      );\n\n      // Resolve effective status-code mappings with default values\n      const unauthorizedStatusCodes =\n        config.unauthorizedStatusCodes && config.unauthorizedStatusCodes.length > 0\n          ? config.unauthorizedStatusCodes\n          : [401];\n\n      const forbiddenStatusCodes =\n        config.forbiddenStatusCodes && config.forbiddenStatusCodes.length > 0\n          ? config.forbiddenStatusCodes\n          : [403];\n\n      // Trigger interceptors based on configured status codes\n      if (\n        config.interceptors?.onUnauthorized &&\n        unauthorizedStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onUnauthorized(apiError);\n      } else if (\n        config.interceptors?.onForbidden &&\n        forbiddenStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onForbidden(apiError);\n      } else if (config.interceptors?.onError) {\n        config.interceptors.onError(apiError);\n      }\n\n      throw apiError;\n    }\n\n    return await response.json();\n  } catch (error) {\n    if (error instanceof ApiError) throw error;\n    throw new ApiError(\n      error instanceof Error ? error.message : 'Network error',\n      'NETWORK_ERROR',\n      520\n    );\n  }\n}\n","import { useState, useRef, useEffect, useCallback } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, FetchOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface FetchState<T> {\n  data: T | null;\n  isLoading: boolean;\n  isRefreshing: boolean;\n  error: ApiError | null;\n}\n\n/**\n * A hook for executing a fetch function and managing the state of the fetch.\n * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the fetch and the fetch function.\n */\nexport function useFetchFn<T>(options?: FetchOptions) {\n  const [state, setState] = useState<FetchState<T>>({\n    data: null,\n    isLoading: false,\n    isRefreshing: false,\n    error: null,\n  });\n\n  const isMounted = useRef<boolean>(true);\n  const lastFetchFn = useRef<(() => Promise<HttpResponse<T>>) | null>(null);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(\n    async (\n      fetchFn: () => Promise<HttpResponse<T>>,\n      execOptions: { isRefresh: boolean }\n    ): Promise<HttpResponse<T> | null> => {\n      lastFetchFn.current = fetchFn;\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: !execOptions.isRefresh,\n        isRefreshing: !!execOptions.isRefresh,\n        error: null,\n      }));\n\n      try {\n        const response = await fetchFn();\n\n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isLoading: false,\n            isRefreshing: false,\n            error: null,\n          });\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isLoading: false,\n            isRefreshing: false,\n            error: apiError,\n          });\n        }\n        return null;\n      }\n    },\n    []\n  );\n\n  const executeFetchFn = useCallback(\n    (fetchFn: () => Promise<HttpResponse<T>>) => {\n      return execute(fetchFn, { isRefresh: false });\n    },\n    [execute]\n  );\n\n  const refreshFetchFn = useCallback(() => {\n    if (lastFetchFn.current) {\n      return execute(lastFetchFn.current, { isRefresh: true });\n    }\n    return null;\n  }, [execute]);\n\n  useEffect(() => {\n    if (!options?.tags || options.tags.length === 0) return;\n\n    const subscriptions = options.tags.map((tag) =>\n      eventEmitter.addListener(tag, () => {\n        refreshFetchFn();\n      })\n    );\n    return () => subscriptions.forEach((sub) => sub.remove());\n  }, [options?.tags, refreshFetchFn]);\n\n  return { ...state, executeFetchFn, refreshFetchFn };\n}\n","type Listener = () => void;\n\nclass EventEmitter {\n  private events: Record<string, Listener[]> = {};\n\n  emit(event: string) {\n    if (!this.events[event]) return;\n    this.events[event].forEach((listener) => listener());\n  }\n\n  addListener(event: string, listener: Listener) {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n    this.events[event].push(listener);\n    \n    return {\n      remove: () => {\n        this.events[event] = this.events[event].filter((l) => l !== listener);\n      },\n    };\n  }\n}\n\nexport const eventEmitter = new EventEmitter();","import { useState, useCallback, useRef, useEffect } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, MutationOptions, ExecuteMutationOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface MutationState<T> {\n  data: T | null;\n  isMutating: boolean;\n}\n\n/**\n * A hook for executing a mutation function and managing the state of the mutation.\n * @param options - Has invalidatesTags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the mutation and the mutation function.\n */\nexport function useMutationFn<T>(options?: MutationOptions) {\n  const [state, setState] = useState<MutationState<T>>({\n    data: null,\n    isMutating: false,\n  });\n  const isMounted = useRef<boolean>(true);\n  \n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const executeMutationFn = useCallback(\n    async (\n      mutationFn: () => Promise<HttpResponse<T>>,\n      executeOptions?: ExecuteMutationOptions<T>\n    ): Promise<HttpResponse<T> | null> => {\n      setState((prev) => ({ ...prev, isMutating: true }));\n\n      try {\n        const response = await mutationFn();\n        \n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isMutating: false,\n          });\n          \n          options?.invalidatesTags?.forEach((tag) => {\n            eventEmitter.emit(tag);\n          });\n          \n          if (response.data) executeOptions?.onSuccess?.(response.data);\n          else executeOptions?.onSuccess?.(null as unknown as T);\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isMutating: false,\n          });\n          if (apiError) executeOptions?.onError?.(apiError);\n        }\n        return null;\n      }\n    },\n    [options?.invalidatesTags]\n  );\n\n  const reset = useCallback(() => {\n    setState({ data: null, isMutating: false });\n  }, []);\n\n  return { ...state, executeMutationFn, reset };\n}"],"mappings":"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","names":["import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/util/api-error.ts","../src/core/config.ts","../src/core/wire.ts","../src/hook/use-fetch-fn.ts","../src/core/event-emitter.ts","../src/hook/use-mutation-fn.ts"],"sourcesContent":["export * from './interface';\nexport * from './util/api-error';\nexport * from './core/config';\nexport * from './core/wire';\nexport * from './hook/use-fetch-fn';\nexport * from './hook/use-mutation-fn';\n","export class ApiError extends Error {\n  public errorCode?: string;\n  public statusCode?: number;\n\n  constructor(message: string, errorCode?: string, statusCode?: number) {\n    super(message);\n    this.name = 'ApiError';\n    this.errorCode = errorCode;\n    this.statusCode = statusCode;\n  }\n}","import { WireConfig } from '../interface';\n\nlet globalWireConfig: WireConfig | null = null;\n\n/**\n * Initializes the library with mandatory configurations.\n * Must be executed at the application entry point before any API calls.\n * @param config - The required configuration object including baseUrl and getToken.\n */\nexport const initWire = (config: WireConfig): void => {\n  globalWireConfig = {\n    ...config,\n    headers: config.headers || {},\n  };\n};\n\n/**\n * Updates the existing configuration.\n * Merges new headers with existing ones and overrides other provided fields.\n * @param config - A partial configuration object to update.\n */\nexport const updateWireConfig = (config: Partial<WireConfig>): void => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n\n  globalWireConfig = {\n    ...globalWireConfig,\n    ...config,\n    headers: {\n      ...globalWireConfig.headers,\n      ...config.headers,\n    },\n  };\n};\n\n/**\n * Retrieves the current global configuration state.\n * @throws Error if the configuration state is null.\n * @returns The validated WireConfig object.\n */\nexport const getWireConfig = (): WireConfig => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n  return globalWireConfig;\n};","import { HttpResponse } from '../interface';\nimport { ApiError } from '../util/api-error';\nimport { getWireConfig } from './config';\n\n/**\n * Sends an API request and returns the response.\n * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.\n * @param options - The request options is a RequestInit object.\n */\nexport async function wireApi<T>(\n  endpoint: string,\n  options: RequestInit = {}\n): Promise<HttpResponse<T>> {\n  const config = getWireConfig();\n  const url = `${config.baseUrl}${endpoint}`;\n  const accessToken = await config.getToken();\n\n  const headers: HeadersInit = {\n    'Content-Type': 'application/json',\n    ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {}),\n    ...config.headers,\n    ...options.headers,\n  };\n\n  try {\n    const response = await fetch(url, { ...options, headers });\n\n    if (!response.ok) {\n      let errorData;\n      try {\n        errorData = await response.json();\n      } catch {\n        errorData = { message: 'Unknown server error', error: 'UNKNOWN' };\n      }\n\n      const apiError = new ApiError(\n        errorData.message,\n        errorData.error,\n        response.status\n      );\n\n      // Resolve effective status-code mappings with default values\n      const unauthorizedStatusCodes =\n        config.unauthorizedStatusCodes && config.unauthorizedStatusCodes.length > 0\n          ? config.unauthorizedStatusCodes\n          : [401];\n\n      const forbiddenStatusCodes =\n        config.forbiddenStatusCodes && config.forbiddenStatusCodes.length > 0\n          ? config.forbiddenStatusCodes\n          : [403];\n\n      // Trigger interceptors based on configured status codes\n      if (\n        config.interceptors?.onUnauthorized &&\n        unauthorizedStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onUnauthorized(apiError);\n      } else if (\n        config.interceptors?.onForbidden &&\n        forbiddenStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onForbidden(apiError);\n      } else if (config.interceptors?.onError) {\n        config.interceptors.onError(apiError);\n      }\n\n      throw apiError;\n    }\n\n    return await response.json();\n  } catch (error) {\n    if (error instanceof ApiError) throw error;\n    throw new ApiError(\n      error instanceof Error ? error.message : 'Network error',\n      'NETWORK_ERROR',\n      520\n    );\n  }\n}\n","import { useState, useRef, useEffect, useCallback } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, FetchOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface FetchState<T> {\n  data: T | null;\n  isLoading: boolean;\n  isRefreshing: boolean;\n  error: ApiError | null;\n}\n\n/**\n * A hook for executing a fetch function and managing the state of the fetch.\n * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the fetch and the fetch function.\n */\nexport function useFetchFn<T>(\n  fetchFn: () => Promise<HttpResponse<T>>,\n  options?: FetchOptions\n) {\n  const [state, setState] = useState<FetchState<T>>({\n    data: null,\n    isLoading: false,\n    isRefreshing: false,\n    error: null,\n  });\n\n  const isMounted = useRef<boolean>(true);\n  const lastFetchFn = useRef<(() => Promise<HttpResponse<T>>) | null>(null);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(\n    async (execOptions: {\n      isRefresh: boolean;\n    }): Promise<HttpResponse<T> | null> => {\n      lastFetchFn.current = fetchFn;\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: !execOptions.isRefresh,\n        isRefreshing: !!execOptions.isRefresh,\n        error: null,\n      }));\n\n      try {\n        const response = await fetchFn();\n\n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isLoading: false,\n            isRefreshing: false,\n            error: null,\n          });\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isLoading: false,\n            isRefreshing: false,\n            error: apiError,\n          });\n        }\n        return null;\n      }\n    },\n    []\n  );\n\n  const executeFetchFn = useCallback(\n    () => execute({ isRefresh: false }),\n    [execute]\n  );\n  const refreshFetchFn = useCallback(() => execute({ isRefresh: true }), [execute]);\n\n  useEffect(() => {\n    if (!options?.tags || options.tags.length === 0) return;\n\n    const subscriptions = options.tags.map((tag) =>\n      eventEmitter.addListener(tag, () => {\n        refreshFetchFn();\n      })\n    );\n    return () => subscriptions.forEach((sub) => sub.remove());\n  }, [options?.tags, refreshFetchFn]);\n\n  return { ...state, executeFetchFn, refreshFetchFn };\n}\n","type Listener = () => void;\n\nclass EventEmitter {\n  private events: Record<string, Listener[]> = {};\n\n  emit(event: string) {\n    if (!this.events[event]) return;\n    this.events[event].forEach((listener) => listener());\n  }\n\n  addListener(event: string, listener: Listener) {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n    this.events[event].push(listener);\n    \n    return {\n      remove: () => {\n        this.events[event] = this.events[event].filter((l) => l !== listener);\n      },\n    };\n  }\n}\n\nexport const eventEmitter = new EventEmitter();","import { useState, useCallback, useRef, useEffect } from 'react';\nimport { ApiError } from '../util/api-error';\nimport {\n  HttpResponse,\n  MutationOptions,\n  ExecuteMutationOptions,\n} from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface MutationState<T> {\n  data: T | null;\n  isMutating: boolean;\n}\n\n/**\n * Mutation without variables. Use when the payload is fixed (e.g. from closure/state).\n *\n * @param mutationFn - Function that returns a promise (e.g. `() => createApi()`).\n * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.\n * @returns executeMutationFn(options?) — call with no args or only options: `executeMutationFn()` or `executeMutationFn({ onSuccess, onError })`.\n */\nexport function useMutationFn<T>(\n  mutationFn: (variables: void) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n): {\n  data: T | null;\n  isMutating: boolean;\n  executeMutationFn: (\n    executeOptions?: ExecuteMutationOptions<T>\n  ) => Promise<HttpResponse<T> | null>;\n  reset: () => void;\n};\n\n/**\n * Mutation with variables. Use when the payload is passed at call time (e.g. update forms, PATCH body).\n *\n * @param mutationFn - Function that receives variables and returns a promise (e.g. `(data) => updateApi(id, data)`).\n * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.\n * @returns executeMutationFn(variables, options?) — you must pass variables first, then optional callbacks.\n */\nexport function useMutationFn<T, TVariables>(\n  mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n): {\n  data: T | null;\n  isMutating: boolean;\n  executeMutationFn: (\n    variables: TVariables,\n    executeOptions?: ExecuteMutationOptions<T>\n  ) => Promise<HttpResponse<T> | null>;\n  reset: () => void;\n};\n\nexport function useMutationFn<T, TVariables = void>(\n  mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n) {\n  const [state, setState] = useState<MutationState<T>>({\n    data: null,\n    isMutating: false,\n  });\n  const isMounted = useRef<boolean>(true);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const executeMutationFn = useCallback(\n    async (\n      firstArg?: TVariables | ExecuteMutationOptions<T>,\n      secondArg?: ExecuteMutationOptions<T>\n    ): Promise<HttpResponse<T> | null> => {\n      const hasTwoArgs = secondArg !== undefined;\n      const variables = (hasTwoArgs ? firstArg : undefined) as TVariables;\n      const executeOptions = hasTwoArgs ? secondArg : firstArg as ExecuteMutationOptions<T>;\n\n      setState((prev) => ({ ...prev, isMutating: true }));\n\n      try {\n        const response = await mutationFn(variables);\n\n        if (isMounted.current) {\n          setState({\n            data: response.data ?? null,\n            isMutating: false,\n          });\n\n          options?.invalidatesTags?.forEach((tag) => {\n            eventEmitter.emit(tag);\n          });\n\n          if (response.data != null) executeOptions?.onSuccess?.(response.data);\n          else executeOptions?.onSuccess?.(null as unknown as T);\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isMutating: false,\n          });\n          executeOptions?.onError?.(apiError);\n        }\n        return null;\n      }\n    },\n    [mutationFn, options?.invalidatesTags]\n  );\n\n  const reset = useCallback(() => {\n    setState({ data: null, isMutating: false });\n  }, []);\n\n  return { ...state, executeMutationFn, reset };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,WAAN,cAAuB,MAAM;AAAA,EAIlC,YAAY,SAAiB,WAAoB,YAAqB;AACpE,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,SAAK,aAAa;AAAA,EACpB;AACF;;;ACRA,IAAI,mBAAsC;AAOnC,IAAM,WAAW,CAAC,WAA6B;AACpD,qBAAmB;AAAA,IACjB,GAAG;AAAA,IACH,SAAS,OAAO,WAAW,CAAC;AAAA,EAC9B;AACF;AAOO,IAAM,mBAAmB,CAAC,WAAsC;AACrE,MAAI,CAAC,kBAAkB;AACrB,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,qBAAmB;AAAA,IACjB,GAAG;AAAA,IACH,GAAG;AAAA,IACH,SAAS;AAAA,MACP,GAAG,iBAAiB;AAAA,MACpB,GAAG,OAAO;AAAA,IACZ;AAAA,EACF;AACF;AAOO,IAAM,gBAAgB,MAAkB;AAC7C,MAAI,CAAC,kBAAkB;AACrB,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,SAAO;AACT;;;ACrCA,eAAsB,QACpB,UACA,UAAuB,CAAC,GACE;AAC1B,QAAM,SAAS,cAAc;AAC7B,QAAM,MAAM,GAAG,OAAO,OAAO,GAAG,QAAQ;AACxC,QAAM,cAAc,MAAM,OAAO,SAAS;AAE1C,QAAM,UAAuB;AAAA,IAC3B,gBAAgB;AAAA,IAChB,GAAI,cAAc,EAAE,eAAe,UAAU,WAAW,GAAG,IAAI,CAAC;AAAA,IAChE,GAAG,OAAO;AAAA,IACV,GAAG,QAAQ;AAAA,EACb;AAEA,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,KAAK,EAAE,GAAG,SAAS,QAAQ,CAAC;AAEzD,QAAI,CAAC,SAAS,IAAI;AAChB,UAAI;AACJ,UAAI;AACF,oBAAY,MAAM,SAAS,KAAK;AAAA,MAClC,QAAQ;AACN,oBAAY,EAAE,SAAS,wBAAwB,OAAO,UAAU;AAAA,MAClE;AAEA,YAAM,WAAW,IAAI;AAAA,QACnB,UAAU;AAAA,QACV,UAAU;AAAA,QACV,SAAS;AAAA,MACX;AAGA,YAAM,0BACJ,OAAO,2BAA2B,OAAO,wBAAwB,SAAS,IACtE,OAAO,0BACP,CAAC,GAAG;AAEV,YAAM,uBACJ,OAAO,wBAAwB,OAAO,qBAAqB,SAAS,IAChE,OAAO,uBACP,CAAC,GAAG;AAGV,UACE,OAAO,cAAc,kBACrB,wBAAwB,SAAS,SAAS,MAAM,GAChD;AACA,eAAO,aAAa,eAAe,QAAQ;AAAA,MAC7C,WACE,OAAO,cAAc,eACrB,qBAAqB,SAAS,SAAS,MAAM,GAC7C;AACA,eAAO,aAAa,YAAY,QAAQ;AAAA,MAC1C,WAAW,OAAO,cAAc,SAAS;AACvC,eAAO,aAAa,QAAQ,QAAQ;AAAA,MACtC;AAEA,YAAM;AAAA,IACR;AAEA,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,SAAS,OAAO;AACd,QAAI,iBAAiB,SAAU,OAAM;AACrC,UAAM,IAAI;AAAA,MACR,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACzC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;AC/EA,mBAAyD;;;ACEzD,IAAM,eAAN,MAAmB;AAAA,EAAnB;AACE,SAAQ,SAAqC,CAAC;AAAA;AAAA,EAE9C,KAAK,OAAe;AAClB,QAAI,CAAC,KAAK,OAAO,KAAK,EAAG;AACzB,SAAK,OAAO,KAAK,EAAE,QAAQ,CAAC,aAAa,SAAS,CAAC;AAAA,EACrD;AAAA,EAEA,YAAY,OAAe,UAAoB;AAC7C,QAAI,CAAC,KAAK,OAAO,KAAK,GAAG;AACvB,WAAK,OAAO,KAAK,IAAI,CAAC;AAAA,IACxB;AACA,SAAK,OAAO,KAAK,EAAE,KAAK,QAAQ;AAEhC,WAAO;AAAA,MACL,QAAQ,MAAM;AACZ,aAAK,OAAO,KAAK,IAAI,KAAK,OAAO,KAAK,EAAE,OAAO,CAAC,MAAM,MAAM,QAAQ;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,eAAe,IAAI,aAAa;;;ADPtC,SAAS,WACd,SACA,SACA;AACA,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAwB;AAAA,IAChD,MAAM;AAAA,IACN,WAAW;AAAA,IACX,cAAc;AAAA,IACd,OAAO;AAAA,EACT,CAAC;AAED,QAAM,gBAAY,qBAAgB,IAAI;AACtC,QAAM,kBAAc,qBAAgD,IAAI;AAExE,8BAAU,MAAM;AACd,cAAU,UAAU;AACpB,WAAO,MAAM;AACX,gBAAU,UAAU;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,cAAU;AAAA,IACd,OAAO,gBAEgC;AACrC,kBAAY,UAAU;AAEtB,eAAS,CAAC,UAAU;AAAA,QAClB,GAAG;AAAA,QACH,WAAW,CAAC,YAAY;AAAA,QACxB,cAAc,CAAC,CAAC,YAAY;AAAA,QAC5B,OAAO;AAAA,MACT,EAAE;AAEF,UAAI;AACF,cAAM,WAAW,MAAM,QAAQ;AAE/B,YAAI,UAAU,SAAS;AACrB,mBAAS;AAAA,YACP,MAAM,SAAS,QAAQ;AAAA,YACvB,WAAW;AAAA,YACX,cAAc;AAAA,YACd,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AACA,eAAO;AAAA,MACT,SAAS,OAAO;AACd,cAAM,WAAW;AACjB,YAAI,UAAU,SAAS;AACrB,mBAAS;AAAA,YACP,MAAM;AAAA,YACN,WAAW;AAAA,YACX,cAAc;AAAA,YACd,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AACA,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC;AAAA,EACH;AAEA,QAAM,qBAAiB;AAAA,IACrB,MAAM,QAAQ,EAAE,WAAW,MAAM,CAAC;AAAA,IAClC,CAAC,OAAO;AAAA,EACV;AACA,QAAM,qBAAiB,0BAAY,MAAM,QAAQ,EAAE,WAAW,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;AAEhF,8BAAU,MAAM;AACd,QAAI,CAAC,SAAS,QAAQ,QAAQ,KAAK,WAAW,EAAG;AAEjD,UAAM,gBAAgB,QAAQ,KAAK;AAAA,MAAI,CAAC,QACtC,aAAa,YAAY,KAAK,MAAM;AAClC,uBAAe;AAAA,MACjB,CAAC;AAAA,IACH;AACA,WAAO,MAAM,cAAc,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC;AAAA,EAC1D,GAAG,CAAC,SAAS,MAAM,cAAc,CAAC;AAElC,SAAO,EAAE,GAAG,OAAO,gBAAgB,eAAe;AACpD;;;AEjGA,IAAAA,gBAAyD;AAqDlD,SAAS,cACd,YACA,SACA;AACA,QAAM,CAAC,OAAO,QAAQ,QAAI,wBAA2B;AAAA,IACnD,MAAM;AAAA,IACN,YAAY;AAAA,EACd,CAAC;AACD,QAAM,gBAAY,sBAAgB,IAAI;AAEtC,+BAAU,MAAM;AACd,cAAU,UAAU;AACpB,WAAO,MAAM;AACX,gBAAU,UAAU;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,wBAAoB;AAAA,IACxB,OACE,UACA,cACoC;AACpC,YAAM,aAAa,cAAc;AACjC,YAAM,YAAa,aAAa,WAAW;AAC3C,YAAM,iBAAiB,aAAa,YAAY;AAEhD,eAAS,CAAC,UAAU,EAAE,GAAG,MAAM,YAAY,KAAK,EAAE;AAElD,UAAI;AACF,cAAM,WAAW,MAAM,WAAW,SAAS;AAE3C,YAAI,UAAU,SAAS;AACrB,mBAAS;AAAA,YACP,MAAM,SAAS,QAAQ;AAAA,YACvB,YAAY;AAAA,UACd,CAAC;AAED,mBAAS,iBAAiB,QAAQ,CAAC,QAAQ;AACzC,yBAAa,KAAK,GAAG;AAAA,UACvB,CAAC;AAED,cAAI,SAAS,QAAQ,KAAM,iBAAgB,YAAY,SAAS,IAAI;AAAA,cAC/D,iBAAgB,YAAY,IAAoB;AAAA,QACvD;AACA,eAAO;AAAA,MACT,SAAS,OAAO;AACd,cAAM,WAAW;AACjB,YAAI,UAAU,SAAS;AACrB,mBAAS;AAAA,YACP,MAAM;AAAA,YACN,YAAY;AAAA,UACd,CAAC;AACD,0BAAgB,UAAU,QAAQ;AAAA,QACpC;AACA,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,YAAY,SAAS,eAAe;AAAA,EACvC;AAEA,QAAM,YAAQ,2BAAY,MAAM;AAC9B,aAAS,EAAE,MAAM,MAAM,YAAY,MAAM,CAAC;AAAA,EAC5C,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,GAAG,OAAO,mBAAmB,MAAM;AAC9C;","names":["import_react"]}

package/dist/index.mjs

@@ -110,7 +110,7 @@ var EventEmitter = class {
 var eventEmitter = new EventEmitter();
 
 // src/hook/use-fetch-fn.ts
-function useFetchFn(options) {
+function useFetchFn(fetchFn, options) {
   const [state, setState] = useState({
     data: null,
     isLoading: false,
@@ -126,7 +126,7 @@ function useFetchFn(options) {
     };
   }, []);
   const execute = useCallback(
-    async (fetchFn, execOptions) => {
+    async (execOptions) => {
       lastFetchFn.current = fetchFn;
       setState((prev) => ({
         ...prev,
@@ -161,17 +161,10 @@ function useFetchFn(options) {
     []
   );
   const executeFetchFn = useCallback(
-    (fetchFn) => {
-      return execute(fetchFn, { isRefresh: false });
-    },
+    () => execute({ isRefresh: false }),
     [execute]
   );
-  const refreshFetchFn = useCallback(() => {
-    if (lastFetchFn.current) {
-      return execute(lastFetchFn.current, { isRefresh: true });
-    }
-    return null;
-  }, [execute]);
+  const refreshFetchFn = useCallback(() => execute({ isRefresh: true }), [execute]);
   useEffect(() => {
     if (!options?.tags || options.tags.length === 0) return;
     const subscriptions = options.tags.map(
@@ -186,7 +179,7 @@ function useFetchFn(options) {
 
 // src/hook/use-mutation-fn.ts
 import { useState as useState2, useCallback as useCallback2, useRef as useRef2, useEffect as useEffect2 } from "react";
-function useMutationFn(options) {
+function useMutationFn(mutationFn, options) {
   const [state, setState] = useState2({
     data: null,
     isMutating: false
@@ -199,19 +192,22 @@ function useMutationFn(options) {
     };
   }, []);
   const executeMutationFn = useCallback2(
-    async (mutationFn, executeOptions) => {
+    async (firstArg, secondArg) => {
+      const hasTwoArgs = secondArg !== void 0;
+      const variables = hasTwoArgs ? firstArg : void 0;
+      const executeOptions = hasTwoArgs ? secondArg : firstArg;
       setState((prev) => ({ ...prev, isMutating: true }));
       try {
-        const response = await mutationFn();
+        const response = await mutationFn(variables);
         if (isMounted.current) {
           setState({
-            data: response.data || null,
+            data: response.data ?? null,
             isMutating: false
           });
           options?.invalidatesTags?.forEach((tag) => {
             eventEmitter.emit(tag);
           });
-          if (response.data) executeOptions?.onSuccess?.(response.data);
+          if (response.data != null) executeOptions?.onSuccess?.(response.data);
           else executeOptions?.onSuccess?.(null);
         }
         return response;
@@ -222,12 +218,12 @@ function useMutationFn(options) {
             data: null,
             isMutating: false
           });
-          if (apiError) executeOptions?.onError?.(apiError);
+          executeOptions?.onError?.(apiError);
         }
         return null;
       }
     },
-    [options?.invalidatesTags]
+    [mutationFn, options?.invalidatesTags]
   );
   const reset = useCallback2(() => {
     setState({ data: null, isMutating: false });

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/util/api-error.ts","../src/core/config.ts","../src/core/wire.ts","../src/hook/use-fetch-fn.ts","../src/core/event-emitter.ts","../src/hook/use-mutation-fn.ts"],"sourcesContent":["export class ApiError extends Error {\n  public errorCode?: string;\n  public statusCode?: number;\n\n  constructor(message: string, errorCode?: string, statusCode?: number) {\n    super(message);\n    this.name = 'ApiError';\n    this.errorCode = errorCode;\n    this.statusCode = statusCode;\n  }\n}","import { WireConfig } from '../interface';\n\nlet globalWireConfig: WireConfig | null = null;\n\n/**\n * Initializes the library with mandatory configurations.\n * Must be executed at the application entry point before any API calls.\n * @param config - The required configuration object including baseUrl and getToken.\n */\nexport const initWire = (config: WireConfig): void => {\n  globalWireConfig = {\n    ...config,\n    headers: config.headers || {},\n  };\n};\n\n/**\n * Updates the existing configuration.\n * Merges new headers with existing ones and overrides other provided fields.\n * @param config - A partial configuration object to update.\n */\nexport const updateWireConfig = (config: Partial<WireConfig>): void => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n\n  globalWireConfig = {\n    ...globalWireConfig,\n    ...config,\n    headers: {\n      ...globalWireConfig.headers,\n      ...config.headers,\n    },\n  };\n};\n\n/**\n * Retrieves the current global configuration state.\n * @throws Error if the configuration state is null.\n * @returns The validated WireConfig object.\n */\nexport const getWireConfig = (): WireConfig => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n  return globalWireConfig;\n};","import { HttpResponse } from '../interface';\nimport { ApiError } from '../util/api-error';\nimport { getWireConfig } from './config';\n\n/**\n * Sends an API request and returns the response.\n * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.\n * @param options - The request options is a RequestInit object.\n */\nexport async function wireApi<T>(\n  endpoint: string,\n  options: RequestInit = {}\n): Promise<HttpResponse<T>> {\n  const config = getWireConfig();\n  const url = `${config.baseUrl}${endpoint}`;\n  const accessToken = await config.getToken();\n\n  const headers: HeadersInit = {\n    'Content-Type': 'application/json',\n    ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {}),\n    ...config.headers,\n    ...options.headers,\n  };\n\n  try {\n    const response = await fetch(url, { ...options, headers });\n\n    if (!response.ok) {\n      let errorData;\n      try {\n        errorData = await response.json();\n      } catch {\n        errorData = { message: 'Unknown server error', error: 'UNKNOWN' };\n      }\n\n      const apiError = new ApiError(\n        errorData.message,\n        errorData.error,\n        response.status\n      );\n\n      // Resolve effective status-code mappings with default values\n      const unauthorizedStatusCodes =\n        config.unauthorizedStatusCodes && config.unauthorizedStatusCodes.length > 0\n          ? config.unauthorizedStatusCodes\n          : [401];\n\n      const forbiddenStatusCodes =\n        config.forbiddenStatusCodes && config.forbiddenStatusCodes.length > 0\n          ? config.forbiddenStatusCodes\n          : [403];\n\n      // Trigger interceptors based on configured status codes\n      if (\n        config.interceptors?.onUnauthorized &&\n        unauthorizedStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onUnauthorized(apiError);\n      } else if (\n        config.interceptors?.onForbidden &&\n        forbiddenStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onForbidden(apiError);\n      } else if (config.interceptors?.onError) {\n        config.interceptors.onError(apiError);\n      }\n\n      throw apiError;\n    }\n\n    return await response.json();\n  } catch (error) {\n    if (error instanceof ApiError) throw error;\n    throw new ApiError(\n      error instanceof Error ? error.message : 'Network error',\n      'NETWORK_ERROR',\n      520\n    );\n  }\n}\n","import { useState, useRef, useEffect, useCallback } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, FetchOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface FetchState<T> {\n  data: T | null;\n  isLoading: boolean;\n  isRefreshing: boolean;\n  error: ApiError | null;\n}\n\n/**\n * A hook for executing a fetch function and managing the state of the fetch.\n * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the fetch and the fetch function.\n */\nexport function useFetchFn<T>(options?: FetchOptions) {\n  const [state, setState] = useState<FetchState<T>>({\n    data: null,\n    isLoading: false,\n    isRefreshing: false,\n    error: null,\n  });\n\n  const isMounted = useRef<boolean>(true);\n  const lastFetchFn = useRef<(() => Promise<HttpResponse<T>>) | null>(null);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(\n    async (\n      fetchFn: () => Promise<HttpResponse<T>>,\n      execOptions: { isRefresh: boolean }\n    ): Promise<HttpResponse<T> | null> => {\n      lastFetchFn.current = fetchFn;\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: !execOptions.isRefresh,\n        isRefreshing: !!execOptions.isRefresh,\n        error: null,\n      }));\n\n      try {\n        const response = await fetchFn();\n\n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isLoading: false,\n            isRefreshing: false,\n            error: null,\n          });\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isLoading: false,\n            isRefreshing: false,\n            error: apiError,\n          });\n        }\n        return null;\n      }\n    },\n    []\n  );\n\n  const executeFetchFn = useCallback(\n    (fetchFn: () => Promise<HttpResponse<T>>) => {\n      return execute(fetchFn, { isRefresh: false });\n    },\n    [execute]\n  );\n\n  const refreshFetchFn = useCallback(() => {\n    if (lastFetchFn.current) {\n      return execute(lastFetchFn.current, { isRefresh: true });\n    }\n    return null;\n  }, [execute]);\n\n  useEffect(() => {\n    if (!options?.tags || options.tags.length === 0) return;\n\n    const subscriptions = options.tags.map((tag) =>\n      eventEmitter.addListener(tag, () => {\n        refreshFetchFn();\n      })\n    );\n    return () => subscriptions.forEach((sub) => sub.remove());\n  }, [options?.tags, refreshFetchFn]);\n\n  return { ...state, executeFetchFn, refreshFetchFn };\n}\n","type Listener = () => void;\n\nclass EventEmitter {\n  private events: Record<string, Listener[]> = {};\n\n  emit(event: string) {\n    if (!this.events[event]) return;\n    this.events[event].forEach((listener) => listener());\n  }\n\n  addListener(event: string, listener: Listener) {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n    this.events[event].push(listener);\n    \n    return {\n      remove: () => {\n        this.events[event] = this.events[event].filter((l) => l !== listener);\n      },\n    };\n  }\n}\n\nexport const eventEmitter = new EventEmitter();","import { useState, useCallback, useRef, useEffect } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, MutationOptions, ExecuteMutationOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface MutationState<T> {\n  data: T | null;\n  isMutating: boolean;\n}\n\n/**\n * A hook for executing a mutation function and managing the state of the mutation.\n * @param options - Has invalidatesTags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the mutation and the mutation function.\n */\nexport function useMutationFn<T>(options?: MutationOptions) {\n  const [state, setState] = useState<MutationState<T>>({\n    data: null,\n    isMutating: false,\n  });\n  const isMounted = useRef<boolean>(true);\n  \n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const executeMutationFn = useCallback(\n    async (\n      mutationFn: () => Promise<HttpResponse<T>>,\n      executeOptions?: ExecuteMutationOptions<T>\n    ): Promise<HttpResponse<T> | null> => {\n      setState((prev) => ({ ...prev, isMutating: true }));\n\n      try {\n        const response = await mutationFn();\n        \n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isMutating: false,\n          });\n          \n          options?.invalidatesTags?.forEach((tag) => {\n            eventEmitter.emit(tag);\n          });\n          \n          if (response.data) executeOptions?.onSuccess?.(response.data);\n          else executeOptions?.onSuccess?.(null as unknown as T);\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isMutating: false,\n          });\n          if (apiError) executeOptions?.onError?.(apiError);\n        }\n        return null;\n      }\n    },\n    [options?.invalidatesTags]\n  );\n\n  const reset = useCallback(() => {\n    setState({ data: null, isMutating: false });\n  }, []);\n\n  return { ...state, executeMutationFn, reset };\n}"],"mappings":"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","names":["useState","useCallback","useRef","useEffect","useState","useRef","useEffect","useCallback"]}
+{"version":3,"sources":["../src/util/api-error.ts","../src/core/config.ts","../src/core/wire.ts","../src/hook/use-fetch-fn.ts","../src/core/event-emitter.ts","../src/hook/use-mutation-fn.ts"],"sourcesContent":["export class ApiError extends Error {\n  public errorCode?: string;\n  public statusCode?: number;\n\n  constructor(message: string, errorCode?: string, statusCode?: number) {\n    super(message);\n    this.name = 'ApiError';\n    this.errorCode = errorCode;\n    this.statusCode = statusCode;\n  }\n}","import { WireConfig } from '../interface';\n\nlet globalWireConfig: WireConfig | null = null;\n\n/**\n * Initializes the library with mandatory configurations.\n * Must be executed at the application entry point before any API calls.\n * @param config - The required configuration object including baseUrl and getToken.\n */\nexport const initWire = (config: WireConfig): void => {\n  globalWireConfig = {\n    ...config,\n    headers: config.headers || {},\n  };\n};\n\n/**\n * Updates the existing configuration.\n * Merges new headers with existing ones and overrides other provided fields.\n * @param config - A partial configuration object to update.\n */\nexport const updateWireConfig = (config: Partial<WireConfig>): void => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n\n  globalWireConfig = {\n    ...globalWireConfig,\n    ...config,\n    headers: {\n      ...globalWireConfig.headers,\n      ...config.headers,\n    },\n  };\n};\n\n/**\n * Retrieves the current global configuration state.\n * @throws Error if the configuration state is null.\n * @returns The validated WireConfig object.\n */\nexport const getWireConfig = (): WireConfig => {\n  if (!globalWireConfig) {\n    throw new Error('Wire not initialized. Call initWire() first.');\n  }\n  return globalWireConfig;\n};","import { HttpResponse } from '../interface';\nimport { ApiError } from '../util/api-error';\nimport { getWireConfig } from './config';\n\n/**\n * Sends an API request and returns the response.\n * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.\n * @param options - The request options is a RequestInit object.\n */\nexport async function wireApi<T>(\n  endpoint: string,\n  options: RequestInit = {}\n): Promise<HttpResponse<T>> {\n  const config = getWireConfig();\n  const url = `${config.baseUrl}${endpoint}`;\n  const accessToken = await config.getToken();\n\n  const headers: HeadersInit = {\n    'Content-Type': 'application/json',\n    ...(accessToken ? { Authorization: `Bearer ${accessToken}` } : {}),\n    ...config.headers,\n    ...options.headers,\n  };\n\n  try {\n    const response = await fetch(url, { ...options, headers });\n\n    if (!response.ok) {\n      let errorData;\n      try {\n        errorData = await response.json();\n      } catch {\n        errorData = { message: 'Unknown server error', error: 'UNKNOWN' };\n      }\n\n      const apiError = new ApiError(\n        errorData.message,\n        errorData.error,\n        response.status\n      );\n\n      // Resolve effective status-code mappings with default values\n      const unauthorizedStatusCodes =\n        config.unauthorizedStatusCodes && config.unauthorizedStatusCodes.length > 0\n          ? config.unauthorizedStatusCodes\n          : [401];\n\n      const forbiddenStatusCodes =\n        config.forbiddenStatusCodes && config.forbiddenStatusCodes.length > 0\n          ? config.forbiddenStatusCodes\n          : [403];\n\n      // Trigger interceptors based on configured status codes\n      if (\n        config.interceptors?.onUnauthorized &&\n        unauthorizedStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onUnauthorized(apiError);\n      } else if (\n        config.interceptors?.onForbidden &&\n        forbiddenStatusCodes.includes(response.status)\n      ) {\n        config.interceptors.onForbidden(apiError);\n      } else if (config.interceptors?.onError) {\n        config.interceptors.onError(apiError);\n      }\n\n      throw apiError;\n    }\n\n    return await response.json();\n  } catch (error) {\n    if (error instanceof ApiError) throw error;\n    throw new ApiError(\n      error instanceof Error ? error.message : 'Network error',\n      'NETWORK_ERROR',\n      520\n    );\n  }\n}\n","import { useState, useRef, useEffect, useCallback } from 'react';\nimport { ApiError } from '../util/api-error';\nimport { HttpResponse, FetchOptions } from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface FetchState<T> {\n  data: T | null;\n  isLoading: boolean;\n  isRefreshing: boolean;\n  error: ApiError | null;\n}\n\n/**\n * A hook for executing a fetch function and managing the state of the fetch.\n * @param options - Has tags property that will trigger refetching of the useFetchFn with the given tags.\n * @returns The state of the fetch and the fetch function.\n */\nexport function useFetchFn<T>(\n  fetchFn: () => Promise<HttpResponse<T>>,\n  options?: FetchOptions\n) {\n  const [state, setState] = useState<FetchState<T>>({\n    data: null,\n    isLoading: false,\n    isRefreshing: false,\n    error: null,\n  });\n\n  const isMounted = useRef<boolean>(true);\n  const lastFetchFn = useRef<(() => Promise<HttpResponse<T>>) | null>(null);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const execute = useCallback(\n    async (execOptions: {\n      isRefresh: boolean;\n    }): Promise<HttpResponse<T> | null> => {\n      lastFetchFn.current = fetchFn;\n\n      setState((prev) => ({\n        ...prev,\n        isLoading: !execOptions.isRefresh,\n        isRefreshing: !!execOptions.isRefresh,\n        error: null,\n      }));\n\n      try {\n        const response = await fetchFn();\n\n        if (isMounted.current) {\n          setState({\n            data: response.data || null,\n            isLoading: false,\n            isRefreshing: false,\n            error: null,\n          });\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isLoading: false,\n            isRefreshing: false,\n            error: apiError,\n          });\n        }\n        return null;\n      }\n    },\n    []\n  );\n\n  const executeFetchFn = useCallback(\n    () => execute({ isRefresh: false }),\n    [execute]\n  );\n  const refreshFetchFn = useCallback(() => execute({ isRefresh: true }), [execute]);\n\n  useEffect(() => {\n    if (!options?.tags || options.tags.length === 0) return;\n\n    const subscriptions = options.tags.map((tag) =>\n      eventEmitter.addListener(tag, () => {\n        refreshFetchFn();\n      })\n    );\n    return () => subscriptions.forEach((sub) => sub.remove());\n  }, [options?.tags, refreshFetchFn]);\n\n  return { ...state, executeFetchFn, refreshFetchFn };\n}\n","type Listener = () => void;\n\nclass EventEmitter {\n  private events: Record<string, Listener[]> = {};\n\n  emit(event: string) {\n    if (!this.events[event]) return;\n    this.events[event].forEach((listener) => listener());\n  }\n\n  addListener(event: string, listener: Listener) {\n    if (!this.events[event]) {\n      this.events[event] = [];\n    }\n    this.events[event].push(listener);\n    \n    return {\n      remove: () => {\n        this.events[event] = this.events[event].filter((l) => l !== listener);\n      },\n    };\n  }\n}\n\nexport const eventEmitter = new EventEmitter();","import { useState, useCallback, useRef, useEffect } from 'react';\nimport { ApiError } from '../util/api-error';\nimport {\n  HttpResponse,\n  MutationOptions,\n  ExecuteMutationOptions,\n} from '../interface';\nimport { eventEmitter } from '../core/event-emitter';\n\ninterface MutationState<T> {\n  data: T | null;\n  isMutating: boolean;\n}\n\n/**\n * Mutation without variables. Use when the payload is fixed (e.g. from closure/state).\n *\n * @param mutationFn - Function that returns a promise (e.g. `() => createApi()`).\n * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.\n * @returns executeMutationFn(options?) — call with no args or only options: `executeMutationFn()` or `executeMutationFn({ onSuccess, onError })`.\n */\nexport function useMutationFn<T>(\n  mutationFn: (variables: void) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n): {\n  data: T | null;\n  isMutating: boolean;\n  executeMutationFn: (\n    executeOptions?: ExecuteMutationOptions<T>\n  ) => Promise<HttpResponse<T> | null>;\n  reset: () => void;\n};\n\n/**\n * Mutation with variables. Use when the payload is passed at call time (e.g. update forms, PATCH body).\n *\n * @param mutationFn - Function that receives variables and returns a promise (e.g. `(data) => updateApi(id, data)`).\n * @param options - Optional `invalidatesTags` to refetch useFetchFn with those tags after success.\n * @returns executeMutationFn(variables, options?) — you must pass variables first, then optional callbacks.\n */\nexport function useMutationFn<T, TVariables>(\n  mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n): {\n  data: T | null;\n  isMutating: boolean;\n  executeMutationFn: (\n    variables: TVariables,\n    executeOptions?: ExecuteMutationOptions<T>\n  ) => Promise<HttpResponse<T> | null>;\n  reset: () => void;\n};\n\nexport function useMutationFn<T, TVariables = void>(\n  mutationFn: (variables: TVariables) => Promise<HttpResponse<T>>,\n  options?: MutationOptions\n) {\n  const [state, setState] = useState<MutationState<T>>({\n    data: null,\n    isMutating: false,\n  });\n  const isMounted = useRef<boolean>(true);\n\n  useEffect(() => {\n    isMounted.current = true;\n    return () => {\n      isMounted.current = false;\n    };\n  }, []);\n\n  const executeMutationFn = useCallback(\n    async (\n      firstArg?: TVariables | ExecuteMutationOptions<T>,\n      secondArg?: ExecuteMutationOptions<T>\n    ): Promise<HttpResponse<T> | null> => {\n      const hasTwoArgs = secondArg !== undefined;\n      const variables = (hasTwoArgs ? firstArg : undefined) as TVariables;\n      const executeOptions = hasTwoArgs ? secondArg : firstArg as ExecuteMutationOptions<T>;\n\n      setState((prev) => ({ ...prev, isMutating: true }));\n\n      try {\n        const response = await mutationFn(variables);\n\n        if (isMounted.current) {\n          setState({\n            data: response.data ?? null,\n            isMutating: false,\n          });\n\n          options?.invalidatesTags?.forEach((tag) => {\n            eventEmitter.emit(tag);\n          });\n\n          if (response.data != null) executeOptions?.onSuccess?.(response.data);\n          else executeOptions?.onSuccess?.(null as unknown as T);\n        }\n        return response;\n      } catch (error) {\n        const apiError = error as ApiError;\n        if (isMounted.current) {\n          setState({\n            data: null,\n            isMutating: false,\n          });\n          executeOptions?.onError?.(apiError);\n        }\n        return null;\n      }\n    },\n    [mutationFn, options?.invalidatesTags]\n  );\n\n  const reset = useCallback(() => {\n    setState({ data: null, isMutating: false });\n  }, []);\n\n  return { ...state, executeMutationFn, reset };\n}\n"],"mappings":"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","names":["useState","useCallback","useRef","useEffect","useState","useRef","useEffect","useCallback"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fetchwire",
-  "version": "1.0.1",
+  "version": "2.1.0",
   "description": "A lightweight, focused API fetching library for React and React Native applications.",
   "repository": {
     "type": "git",