fetchwire 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,172 @@
+declare class ApiError extends Error {
+    errorCode?: string;
+    statusCode?: number;
+    constructor(message: string, errorCode?: string, statusCode?: number);
+}
+
+/**
+ * Standard HTTP response shape used by fetchwire.
+ * @template T Type of the `data` payload.
+ */
+interface HttpResponse<T> {
+    /**
+     * Parsed response body returned by your API, if available.
+     */
+    data?: T;
+    message?: string;
+    status?: number;
+}
+/**
+ * Set of optional global interceptors that can react to HTTP errors.
+ *
+ * All handlers can be synchronous or async.
+ */
+interface WireInterceptors {
+    /**
+     * Called when a 401 Unauthorized response is returned.
+     */
+    onUnauthorized?: (error: ApiError) => void | Promise<void>;
+    /**
+     * Called when a 403 Forbidden response is returned.
+     */
+    onForbidden?: (error: ApiError) => void | Promise<void>;
+    /**
+     * Called for other non‑success errors, after more specific handlers (if any).
+     */
+    onError?: (error: ApiError) => void | Promise<void>;
+}
+/**
+ * Global configuration passed to `initWire`.
+ */
+interface WireConfig {
+    /**
+     * Base URL that all relative endpoints will be appended to,
+     * e.g. "https://api.example.com".
+     */
+    baseUrl: string;
+    /**
+     * Default headers applied to every request.
+     *
+     * These will be merged with:
+     * - the Authorization header built from `getToken`, and
+     * - any per‑request headers.
+     */
+    headers?: HeadersInit;
+    /**
+     * Async function that returns the current access token, or null if not logged in.
+     *
+     * When a non‑empty token is returned, fetchwire will send it as:
+     * `Authorization: Bearer <token>`.
+     */
+    getToken: () => Promise<string | null>;
+    /**
+     * Optional global interceptors to handle unauthorized/forbidden/other errors.
+     */
+    interceptors?: WireInterceptors;
+    /**
+     * HTTP status codes that should be treated as "unauthorized" for the purpose
+     * of calling `interceptors.onUnauthorized`. Defaults to `[401]` when omitted.
+     */
+    unauthorizedStatusCodes?: number[];
+    /**
+     * HTTP status codes that should be treated as "forbidden" for the purpose
+     * of calling `interceptors.onForbidden`. Defaults to `[403]` when omitted.
+     */
+    forbiddenStatusCodes?: number[];
+}
+/**
+ * Options for the `useFetchFn` hook.
+ */
+interface FetchOptions {
+    /**
+     * Tags that this fetch subscribes to.
+     *
+     * When a mutation invalidates any of these tags, the hook will automatically
+     * re‑run the last request via `refreshFetchFn`.
+     */
+    tags?: string[];
+}
+/**
+ * Options for the `useMutationFn` hook.
+ */
+interface MutationOptions {
+    /**
+     * Tags that should be invalidated after a successful mutation.
+     *
+     * All active `useFetchFn` hooks that subscribed to any of these tags
+     * will be notified and refreshed.
+     */
+    invalidatesTags?: string[];
+}
+/**
+ * Per‑execution callbacks for `useMutationFn`.
+ * @template T Type of the mutation result data.
+ */
+interface ExecuteMutationOptions<T> {
+    /**
+     * Called when the mutation succeeds.
+     *
+     * @param data Parsed response data from the server.
+     */
+    onSuccess?: (data: T) => void | Promise<void>;
+    /**
+     * Called when the mutation fails with an `ApiError`.
+     *
+     * @param error Normalized API error.
+     */
+    onError?: (error: ApiError) => void | Promise<void>;
+}
+
+/**
+ * Initializes the library with mandatory configurations.
+ * Must be executed at the application entry point before any API calls.
+ * @param config - The required configuration object including baseUrl and getToken.
+ */
+declare const initWire: (config: WireConfig) => void;
+/**
+ * Updates the existing configuration.
+ * Merges new headers with existing ones and overrides other provided fields.
+ * @param config - A partial configuration object to update.
+ */
+declare const updateWireConfig: (config: Partial<WireConfig>) => void;
+/**
+ * Retrieves the current global configuration state.
+ * @throws Error if the configuration state is null.
+ * @returns The validated WireConfig object.
+ */
+declare const getWireConfig: () => WireConfig;
+
+/**
+ * Sends an API request and returns the response.
+ * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.
+ * @param options - The request options is a RequestInit object.
+ */
+declare function wireApi<T>(endpoint: string, options?: RequestInit): Promise<HttpResponse<T>>;
+
+/**
+ * A hook for executing a fetch function and managing the state of the fetch.
+ * @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;
+    data: T | null;
+    isLoading: boolean;
+    isRefreshing: boolean;
+    error: ApiError | null;
+};
+
+/**
+ * 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.
+ */
+declare function useMutationFn<T>(options?: MutationOptions): {
+    executeMutationFn: (mutationFn: () => Promise<HttpResponse<T>>, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+    reset: () => void;
+    data: T | null;
+    isMutating: boolean;
+};
+
+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

@@ -0,0 +1,172 @@
+declare class ApiError extends Error {
+    errorCode?: string;
+    statusCode?: number;
+    constructor(message: string, errorCode?: string, statusCode?: number);
+}
+
+/**
+ * Standard HTTP response shape used by fetchwire.
+ * @template T Type of the `data` payload.
+ */
+interface HttpResponse<T> {
+    /**
+     * Parsed response body returned by your API, if available.
+     */
+    data?: T;
+    message?: string;
+    status?: number;
+}
+/**
+ * Set of optional global interceptors that can react to HTTP errors.
+ *
+ * All handlers can be synchronous or async.
+ */
+interface WireInterceptors {
+    /**
+     * Called when a 401 Unauthorized response is returned.
+     */
+    onUnauthorized?: (error: ApiError) => void | Promise<void>;
+    /**
+     * Called when a 403 Forbidden response is returned.
+     */
+    onForbidden?: (error: ApiError) => void | Promise<void>;
+    /**
+     * Called for other non‑success errors, after more specific handlers (if any).
+     */
+    onError?: (error: ApiError) => void | Promise<void>;
+}
+/**
+ * Global configuration passed to `initWire`.
+ */
+interface WireConfig {
+    /**
+     * Base URL that all relative endpoints will be appended to,
+     * e.g. "https://api.example.com".
+     */
+    baseUrl: string;
+    /**
+     * Default headers applied to every request.
+     *
+     * These will be merged with:
+     * - the Authorization header built from `getToken`, and
+     * - any per‑request headers.
+     */
+    headers?: HeadersInit;
+    /**
+     * Async function that returns the current access token, or null if not logged in.
+     *
+     * When a non‑empty token is returned, fetchwire will send it as:
+     * `Authorization: Bearer <token>`.
+     */
+    getToken: () => Promise<string | null>;
+    /**
+     * Optional global interceptors to handle unauthorized/forbidden/other errors.
+     */
+    interceptors?: WireInterceptors;
+    /**
+     * HTTP status codes that should be treated as "unauthorized" for the purpose
+     * of calling `interceptors.onUnauthorized`. Defaults to `[401]` when omitted.
+     */
+    unauthorizedStatusCodes?: number[];
+    /**
+     * HTTP status codes that should be treated as "forbidden" for the purpose
+     * of calling `interceptors.onForbidden`. Defaults to `[403]` when omitted.
+     */
+    forbiddenStatusCodes?: number[];
+}
+/**
+ * Options for the `useFetchFn` hook.
+ */
+interface FetchOptions {
+    /**
+     * Tags that this fetch subscribes to.
+     *
+     * When a mutation invalidates any of these tags, the hook will automatically
+     * re‑run the last request via `refreshFetchFn`.
+     */
+    tags?: string[];
+}
+/**
+ * Options for the `useMutationFn` hook.
+ */
+interface MutationOptions {
+    /**
+     * Tags that should be invalidated after a successful mutation.
+     *
+     * All active `useFetchFn` hooks that subscribed to any of these tags
+     * will be notified and refreshed.
+     */
+    invalidatesTags?: string[];
+}
+/**
+ * Per‑execution callbacks for `useMutationFn`.
+ * @template T Type of the mutation result data.
+ */
+interface ExecuteMutationOptions<T> {
+    /**
+     * Called when the mutation succeeds.
+     *
+     * @param data Parsed response data from the server.
+     */
+    onSuccess?: (data: T) => void | Promise<void>;
+    /**
+     * Called when the mutation fails with an `ApiError`.
+     *
+     * @param error Normalized API error.
+     */
+    onError?: (error: ApiError) => void | Promise<void>;
+}
+
+/**
+ * Initializes the library with mandatory configurations.
+ * Must be executed at the application entry point before any API calls.
+ * @param config - The required configuration object including baseUrl and getToken.
+ */
+declare const initWire: (config: WireConfig) => void;
+/**
+ * Updates the existing configuration.
+ * Merges new headers with existing ones and overrides other provided fields.
+ * @param config - A partial configuration object to update.
+ */
+declare const updateWireConfig: (config: Partial<WireConfig>) => void;
+/**
+ * Retrieves the current global configuration state.
+ * @throws Error if the configuration state is null.
+ * @returns The validated WireConfig object.
+ */
+declare const getWireConfig: () => WireConfig;
+
+/**
+ * Sends an API request and returns the response.
+ * @param endpoint - The API endpoint to call. Example: '/api/v1/users'.
+ * @param options - The request options is a RequestInit object.
+ */
+declare function wireApi<T>(endpoint: string, options?: RequestInit): Promise<HttpResponse<T>>;
+
+/**
+ * A hook for executing a fetch function and managing the state of the fetch.
+ * @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;
+    data: T | null;
+    isLoading: boolean;
+    isRefreshing: boolean;
+    error: ApiError | null;
+};
+
+/**
+ * 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.
+ */
+declare function useMutationFn<T>(options?: MutationOptions): {
+    executeMutationFn: (mutationFn: () => Promise<HttpResponse<T>>, executeOptions?: ExecuteMutationOptions<T>) => Promise<HttpResponse<T> | null>;
+    reset: () => void;
+    data: T | null;
+    isMutating: boolean;
+};
+
+export { ApiError, type ExecuteMutationOptions, type FetchOptions, type HttpResponse, type MutationOptions, type WireConfig, type WireInterceptors, getWireConfig, initWire, updateWireConfig, useFetchFn, useMutationFn, wireApi };

package/dist/index.js

@@ -0,0 +1,279 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiError: () => ApiError,
+  getWireConfig: () => getWireConfig,
+  initWire: () => initWire,
+  updateWireConfig: () => updateWireConfig,
+  useFetchFn: () => useFetchFn,
+  useMutationFn: () => useMutationFn,
+  wireApi: () => wireApi
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/util/api-error.ts
+var ApiError = class extends Error {
+  constructor(message, errorCode, statusCode) {
+    super(message);
+    this.name = "ApiError";
+    this.errorCode = errorCode;
+    this.statusCode = statusCode;
+  }
+};
+
+// src/core/config.ts
+var globalWireConfig = null;
+var initWire = (config) => {
+  globalWireConfig = {
+    ...config,
+    headers: config.headers || {}
+  };
+};
+var updateWireConfig = (config) => {
+  if (!globalWireConfig) {
+    throw new Error("Wire not initialized. Call initWire() first.");
+  }
+  globalWireConfig = {
+    ...globalWireConfig,
+    ...config,
+    headers: {
+      ...globalWireConfig.headers,
+      ...config.headers
+    }
+  };
+};
+var getWireConfig = () => {
+  if (!globalWireConfig) {
+    throw new Error("Wire not initialized. Call initWire() first.");
+  }
+  return globalWireConfig;
+};
+
+// src/core/wire.ts
+async function wireApi(endpoint, options = {}) {
+  const config = getWireConfig();
+  const url = `${config.baseUrl}${endpoint}`;
+  const accessToken = await config.getToken();
+  const headers = {
+    "Content-Type": "application/json",
+    ...accessToken ? { Authorization: `Bearer ${accessToken}` } : {},
+    ...config.headers,
+    ...options.headers
+  };
+  try {
+    const response = await fetch(url, { ...options, headers });
+    if (!response.ok) {
+      let errorData;
+      try {
+        errorData = await response.json();
+      } catch {
+        errorData = { message: "Unknown server error", error: "UNKNOWN" };
+      }
+      const apiError = new ApiError(
+        errorData.message,
+        errorData.error,
+        response.status
+      );
+      const unauthorizedStatusCodes = config.unauthorizedStatusCodes && config.unauthorizedStatusCodes.length > 0 ? config.unauthorizedStatusCodes : [401];
+      const forbiddenStatusCodes = config.forbiddenStatusCodes && config.forbiddenStatusCodes.length > 0 ? config.forbiddenStatusCodes : [403];
+      if (config.interceptors?.onUnauthorized && unauthorizedStatusCodes.includes(response.status)) {
+        config.interceptors.onUnauthorized(apiError);
+      } else if (config.interceptors?.onForbidden && forbiddenStatusCodes.includes(response.status)) {
+        config.interceptors.onForbidden(apiError);
+      } else if (config.interceptors?.onError) {
+        config.interceptors.onError(apiError);
+      }
+      throw apiError;
+    }
+    return await response.json();
+  } catch (error) {
+    if (error instanceof ApiError) throw error;
+    throw new ApiError(
+      error instanceof Error ? error.message : "Network error",
+      "NETWORK_ERROR",
+      520
+    );
+  }
+}
+
+// src/hook/use-fetch-fn.ts
+var import_react = require("react");
+
+// src/core/event-emitter.ts
+var EventEmitter = class {
+  constructor() {
+    this.events = {};
+  }
+  emit(event) {
+    if (!this.events[event]) return;
+    this.events[event].forEach((listener) => listener());
+  }
+  addListener(event, listener) {
+    if (!this.events[event]) {
+      this.events[event] = [];
+    }
+    this.events[event].push(listener);
+    return {
+      remove: () => {
+        this.events[event] = this.events[event].filter((l) => l !== listener);
+      }
+    };
+  }
+};
+var eventEmitter = new EventEmitter();
+
+// src/hook/use-fetch-fn.ts
+function useFetchFn(options) {
+  const [state, setState] = (0, import_react.useState)({
+    data: null,
+    isLoading: false,
+    isRefreshing: false,
+    error: null
+  });
+  const isMounted = (0, import_react.useRef)(true);
+  const lastFetchFn = (0, import_react.useRef)(null);
+  (0, import_react.useEffect)(() => {
+    isMounted.current = true;
+    return () => {
+      isMounted.current = false;
+    };
+  }, []);
+  const execute = (0, import_react.useCallback)(
+    async (fetchFn, execOptions) => {
+      lastFetchFn.current = fetchFn;
+      setState((prev) => ({
+        ...prev,
+        isLoading: !execOptions.isRefresh,
+        isRefreshing: !!execOptions.isRefresh,
+        error: null
+      }));
+      try {
+        const response = await fetchFn();
+        if (isMounted.current) {
+          setState({
+            data: response.data || null,
+            isLoading: false,
+            isRefreshing: false,
+            error: null
+          });
+        }
+        return response;
+      } catch (error) {
+        const apiError = error;
+        if (isMounted.current) {
+          setState({
+            data: null,
+            isLoading: false,
+            isRefreshing: false,
+            error: apiError
+          });
+        }
+        return null;
+      }
+    },
+    []
+  );
+  const executeFetchFn = (0, import_react.useCallback)(
+    (fetchFn) => {
+      return execute(fetchFn, { isRefresh: false });
+    },
+    [execute]
+  );
+  const refreshFetchFn = (0, import_react.useCallback)(() => {
+    if (lastFetchFn.current) {
+      return execute(lastFetchFn.current, { isRefresh: true });
+    }
+    return null;
+  }, [execute]);
+  (0, import_react.useEffect)(() => {
+    if (!options?.tags || options.tags.length === 0) return;
+    const subscriptions = options.tags.map(
+      (tag) => eventEmitter.addListener(tag, () => {
+        refreshFetchFn();
+      })
+    );
+    return () => subscriptions.forEach((sub) => sub.remove());
+  }, [options?.tags, refreshFetchFn]);
+  return { ...state, executeFetchFn, refreshFetchFn };
+}
+
+// src/hook/use-mutation-fn.ts
+var import_react2 = require("react");
+function useMutationFn(options) {
+  const [state, setState] = (0, import_react2.useState)({
+    data: null,
+    isMutating: false
+  });
+  const isMounted = (0, import_react2.useRef)(true);
+  (0, import_react2.useEffect)(() => {
+    isMounted.current = true;
+    return () => {
+      isMounted.current = false;
+    };
+  }, []);
+  const executeMutationFn = (0, import_react2.useCallback)(
+    async (mutationFn, executeOptions) => {
+      setState((prev) => ({ ...prev, isMutating: true }));
+      try {
+        const response = await mutationFn();
+        if (isMounted.current) {
+          setState({
+            data: response.data || null,
+            isMutating: false
+          });
+          options?.invalidatesTags?.forEach((tag) => {
+            eventEmitter.emit(tag);
+          });
+          if (response.data) executeOptions?.onSuccess?.(response.data);
+          else executeOptions?.onSuccess?.(null);
+        }
+        return response;
+      } catch (error) {
+        const apiError = error;
+        if (isMounted.current) {
+          setState({
+            data: null,
+            isMutating: false
+          });
+          if (apiError) executeOptions?.onError?.(apiError);
+        }
+        return null;
+      }
+    },
+    [options?.invalidatesTags]
+  );
+  const reset = (0, import_react2.useCallback)(() => {
+    setState({ data: null, isMutating: false });
+  }, []);
+  return { ...state, executeMutationFn, reset };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiError,
+  getWireConfig,
+  initWire,
+  updateWireConfig,
+  useFetchFn,
+  useMutationFn,
+  wireApi
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}