api-core-lib 4.3.3 → 4.4.4

package/dist/index.d.mts

@@ -191,6 +191,7 @@ interface ActionOptions {
      * update('123', { status: 'active' }, { endpoint: '/items/123/activate' })
      */
     endpoint?: string;
+    refetch?: boolean;
 }
 /**
  * واجهة لتهيئة الهوك `useApi`.
@@ -204,6 +205,11 @@ interface UseApiConfig<T> {
     refetchAfterChange?: boolean;
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
+    /**
+     * إعدادات Axios/Request افتراضية يتم تطبيقها على جميع طلبات الجلب (GET).
+     * مفيدة لتمرير إعدادات مثل isPublic.
+     */
+    requestConfig?: RequestConfig;
 }
 
 /**
@@ -217,12 +223,19 @@ interface UseApiConfig<T> {
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 type CrudRequestConfig = RequestConfig & ActionOptions;
+/**
+ * دالة مصنع (Factory Function) لإنشاء مجموعة خدمات API قابلة لإعادة الاستخدام لنقطة نهاية (endpoint) محددة.
+ * توفر عمليات CRUD كاملة بالإضافة إلى ميزات متقدمة مثل الحذف الجماعي ورفع الملفات.
+ */
 declare function createApiServices<T>(axiosInstance: AxiosInstance, endpoint: string): {
     get: (id?: string, config?: RequestConfig) => Promise<StandardResponse<T | T[]>>;
     getWithQuery: (query: string, config?: RequestConfig) => Promise<StandardResponse<T[]>>;
     post: (data: Partial<T>, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
+    put: (id: string, data: T, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
     patch: (id: string, data: Partial<T>, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
     remove: (id: string, config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
+    bulkDelete: (ids: string[], config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
+    upload: (file: File, additionalData?: Record<string, any>, config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
 };
 
 /**
@@ -303,8 +316,11 @@ declare function useApi<T extends {
     actions: {
         fetch: (options?: QueryOptions) => Promise<void>;
         create: (newItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
+        put: (id: string, item: T, options?: ActionOptions) => Promise<StandardResponse<T>>;
         update: (id: string, updatedItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
         remove: (id: string, options?: ActionOptions) => Promise<StandardResponse<any>>;
+        bulkRemove: (ids: string[], options?: ActionOptions) => Promise<StandardResponse<any>>;
+        upload: (file: File, additionalData?: Record<string, any>, options?: ActionOptions) => Promise<StandardResponse<any>>;
     };
     query: {
         options: QueryOptions;

package/dist/index.d.ts

@@ -191,6 +191,7 @@ interface ActionOptions {
      * update('123', { status: 'active' }, { endpoint: '/items/123/activate' })
      */
     endpoint?: string;
+    refetch?: boolean;
 }
 /**
  * واجهة لتهيئة الهوك `useApi`.
@@ -204,6 +205,11 @@ interface UseApiConfig<T> {
     refetchAfterChange?: boolean;
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
+    /**
+     * إعدادات Axios/Request افتراضية يتم تطبيقها على جميع طلبات الجلب (GET).
+     * مفيدة لتمرير إعدادات مثل isPublic.
+     */
+    requestConfig?: RequestConfig;
 }
 
 /**
@@ -217,12 +223,19 @@ interface UseApiConfig<T> {
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;
 
 type CrudRequestConfig = RequestConfig & ActionOptions;
+/**
+ * دالة مصنع (Factory Function) لإنشاء مجموعة خدمات API قابلة لإعادة الاستخدام لنقطة نهاية (endpoint) محددة.
+ * توفر عمليات CRUD كاملة بالإضافة إلى ميزات متقدمة مثل الحذف الجماعي ورفع الملفات.
+ */
 declare function createApiServices<T>(axiosInstance: AxiosInstance, endpoint: string): {
     get: (id?: string, config?: RequestConfig) => Promise<StandardResponse<T | T[]>>;
     getWithQuery: (query: string, config?: RequestConfig) => Promise<StandardResponse<T[]>>;
     post: (data: Partial<T>, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
+    put: (id: string, data: T, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
     patch: (id: string, data: Partial<T>, config?: CrudRequestConfig) => Promise<StandardResponse<T>>;
     remove: (id: string, config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
+    bulkDelete: (ids: string[], config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
+    upload: (file: File, additionalData?: Record<string, any>, config?: CrudRequestConfig) => Promise<StandardResponse<any>>;
 };
 
 /**
@@ -303,8 +316,11 @@ declare function useApi<T extends {
     actions: {
         fetch: (options?: QueryOptions) => Promise<void>;
         create: (newItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
+        put: (id: string, item: T, options?: ActionOptions) => Promise<StandardResponse<T>>;
         update: (id: string, updatedItem: Partial<T>, options?: ActionOptions) => Promise<StandardResponse<T>>;
         remove: (id: string, options?: ActionOptions) => Promise<StandardResponse<any>>;
+        bulkRemove: (ids: string[], options?: ActionOptions) => Promise<StandardResponse<any>>;
+        upload: (file: File, additionalData?: Record<string, any>, options?: ActionOptions) => Promise<StandardResponse<any>>;
     };
     query: {
         options: QueryOptions;

package/dist/index.js

@@ -103,34 +103,40 @@ function createApiClient(config) {
     headers: { "Content-Type": "application/json", ...headers },
     withCredentials
   });
-  let tokenRefreshPromise = null;
+  let isRefreshing = false;
+  let failedQueue = [];
+  const processQueue = (error, token = null) => {
+    failedQueue.forEach((prom) => {
+      if (error) {
+        prom.reject(error);
+      } else {
+        prom.resolve(token);
+      }
+    });
+    failedQueue = [];
+  };
   axiosInstance.interceptors.request.use(async (req) => {
     req.headers["X-Request-ID"] = (0, import_uuid.v4)();
     if (req.isPublic) {
-      console.log(`[API Core] Skipping token for public request: ${req.url}`);
       return req;
     }
-    if (tokenRefreshPromise) {
-      await tokenRefreshPromise;
-    }
     let tokens = await tokenManager.getTokens();
     const now = Date.now();
     const tokenBuffer = 60 * 1e3;
-    if (tokens.accessToken && tokens.expiresAt && tokens.expiresAt - now < tokenBuffer) {
-      if (!tokenRefreshPromise && config.refreshTokenConfig) {
+    if (tokens.accessToken && tokens.expiresAt && tokens.expiresAt - now < tokenBuffer && !isRefreshing) {
+      if (config.refreshTokenConfig) {
         console.log("[API Core] Proactive token refresh initiated.");
-        tokenRefreshPromise = refreshToken(config, tokenManager);
+        isRefreshing = true;
+        try {
+          const newTokens = await refreshToken(config, tokenManager);
+          if (newTokens) tokens = newTokens;
+        } finally {
+          isRefreshing = false;
+        }
       }
-      const newTokens = await tokenRefreshPromise;
-      tokenRefreshPromise = null;
-      if (newTokens) tokens = newTokens;
     }
     if (tokens.accessToken && !tokenManager.isHttpOnly()) {
-      const tokenType = tokens.tokenType || "Bearer";
-      req.headers.Authorization = `${tokenType} ${tokens.accessToken}`;
-      console.log(`[API Core] Token attached to request: ${req.url}`);
-    } else {
-      console.warn(`[API Core] No token attached for request: ${req.url}`);
+      req.headers.Authorization = `${tokens.tokenType || "Bearer"} ${tokens.accessToken}`;
     }
     return req;
   }, (error) => Promise.reject(error));
@@ -138,19 +144,34 @@ function createApiClient(config) {
     (response) => response,
     async (error) => {
       const originalRequest = error.config;
-      if (error.response?.status === 401 && !originalRequest._retry) {
-        originalRequest._retry = true;
-        if (!tokenRefreshPromise && config.refreshTokenConfig) {
-          console.log("[API Core] Reactive token refresh initiated due to 401.");
-          tokenRefreshPromise = refreshToken(config, tokenManager);
+      if (error.response?.status === 401 && !originalRequest._retry && config.refreshTokenConfig) {
+        if (isRefreshing) {
+          return new Promise((resolve, reject) => {
+            failedQueue.push({ resolve, reject });
+          }).then((token) => {
+            if (token && !tokenManager.isHttpOnly()) {
+              originalRequest.headers["Authorization"] = `Bearer ${token}`;
+            }
+            return axiosInstance(originalRequest);
+          });
         }
-        const newTokens = await tokenRefreshPromise;
-        tokenRefreshPromise = null;
-        if (newTokens) {
-          if (newTokens.accessToken && !tokenManager.isHttpOnly()) {
-            originalRequest.headers.Authorization = `${newTokens.tokenType || "Bearer"} ${newTokens.accessToken}`;
+        originalRequest._retry = true;
+        isRefreshing = true;
+        try {
+          const newTokens = await refreshToken(config, tokenManager);
+          if (!newTokens || !newTokens.accessToken) {
+            throw new Error("Token refresh failed to produce a new access token.");
+          }
+          processQueue(null, newTokens.accessToken);
+          if (!tokenManager.isHttpOnly()) {
+            originalRequest.headers["Authorization"] = `${newTokens.tokenType || "Bearer"} ${newTokens.accessToken}`;
           }
           return axiosInstance(originalRequest);
+        } catch (refreshError) {
+          processQueue(refreshError, null);
+          return Promise.reject(refreshError);
+        } finally {
+          isRefreshing = false;
         }
       }
       const enhancedError = {
@@ -267,6 +288,15 @@ function createApiServices(axiosInstance, endpoint) {
       return processResponse(error);
     }
   };
+  const put = async (id, data, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}/${id}`;
+    try {
+      const response = await axiosInstance.put(finalUrl, data, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
   const patch = async (id, data, config) => {
     const finalUrl = config?.endpoint || `${endpoint}/${id}`;
     try {
@@ -285,7 +315,38 @@ function createApiServices(axiosInstance, endpoint) {
       return processResponse(error);
     }
   };
-  return { get, getWithQuery, post, patch, remove };
+  const bulkDelete = async (ids, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}`;
+    try {
+      const response = await axiosInstance.delete(finalUrl, { data: { ids }, ...config });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const upload = async (file, additionalData, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}`;
+    const formData = new FormData();
+    formData.append("file", file);
+    if (additionalData) {
+      Object.keys(additionalData).forEach((key) => {
+        formData.append(key, additionalData[key]);
+      });
+    }
+    try {
+      const response = await axiosInstance.post(finalUrl, formData, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          "Content-Type": "multipart/form-data"
+        }
+      });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  return { get, getWithQuery, post, put, patch, remove, bulkDelete, upload };
 }
 
 // src/services/actions.ts
@@ -356,7 +417,7 @@ function useApi(axiosInstance, config) {
     initialQuery = { limit: 10 },
     enabled = true,
     refetchAfterChange = true,
-    // تم تعديل القيمة الافتراضية لتكون أكثر شيوعًا
+    requestConfig,
     onSuccess,
     onError
   } = config;
@@ -373,12 +434,15 @@ function useApi(axiosInstance, config) {
     const currentQuery = options || queryOptions;
     setState((prev) => ({ ...prev, data: null, loading: true, error: null }));
     const queryString = buildPaginateQuery(currentQuery);
-    const result = await apiServices.getWithQuery(queryString, { cancelTokenKey: endpoint });
+    const result = await apiServices.getWithQuery(queryString, {
+      cancelTokenKey: endpoint,
+      ...requestConfig
+    });
     setState(result);
     if (!result.success && onError) {
       onError(result.message || "Fetch failed", result.error || void 0);
     }
-  }, [apiServices, queryOptions, endpoint, onError]);
+  }, [apiServices, queryOptions, endpoint, onError, requestConfig]);
   (0, import_react.useEffect)(() => {
     if (enabled) {
       fetchData();
@@ -397,6 +461,19 @@ function useApi(axiosInstance, config) {
     }
     return result;
   };
+  const putItem = async (id, item, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.put(id, item, options);
+    if (result.success) {
+      if (refetchAfterChange) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "Item replaced successfully!", result.data);
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Replace failed", result.error || void 0);
+    }
+    return result;
+  };
   const updateItem = async (id, updatedItem, options) => {
     setState((prev) => ({ ...prev, loading: true }));
     const result = await apiServices.patch(id, updatedItem, options);
@@ -423,19 +500,39 @@ function useApi(axiosInstance, config) {
     }
     return result;
   };
+  const bulkDeleteItem = async (ids, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.bulkDelete(ids, options);
+    if (result.success) {
+      if (refetchAfterChange) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "Items deleted successfully!");
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Bulk delete failed", result.error || void 0);
+    }
+    return result;
+  };
+  const uploadFile = async (file, additionalData, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.upload(file, additionalData, options);
+    if (result.success) {
+      if (refetchAfterChange && options?.refetch !== false) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "File uploaded successfully!", result.data);
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Upload failed", result.error || void 0);
+    }
+    return result;
+  };
   const setPage = (page) => setQueryOptions((prev) => ({ ...prev, page }));
   const setLimit = (limit) => setQueryOptions((prev) => ({ ...prev, limit, page: 1 }));
   const setSearchTerm = (search) => setQueryOptions((prev) => ({ ...prev, search, page: 1 }));
   const setSorting = (sortBy) => setQueryOptions((prev) => ({ ...prev, sortBy }));
   const setFilters = (filter) => setQueryOptions((prev) => ({ ...prev, filter, page: 1 }));
   const setQueryParam = (key, value) => {
-    setQueryOptions((prev) => {
-      const newQuery = { ...prev, [key]: value };
-      if (key !== "page") {
-        newQuery.page = 1;
-      }
-      return newQuery;
-    });
+    setQueryOptions((prev) => ({ ...prev, [key]: value, page: key !== "page" ? 1 : prev.page }));
   };
   const resetQuery = () => setQueryOptions(initialQuery);
   return {
@@ -444,8 +541,14 @@ function useApi(axiosInstance, config) {
     actions: {
       fetch: fetchData,
       create: createItem,
+      put: putItem,
+      // <-- NEW
       update: updateItem,
-      remove: deleteItem
+      remove: deleteItem,
+      bulkRemove: bulkDeleteItem,
+      // <-- NEW
+      upload: uploadFile
+      // <-- NEW
     },
     query: {
       options: queryOptions,
@@ -456,7 +559,6 @@ function useApi(axiosInstance, config) {
       setSorting,
       setFilters,
       setQueryParam,
-      // <-- NEW
       reset: resetQuery
     }
   };

package/dist/index.mjs

@@ -61,34 +61,40 @@ function createApiClient(config) {
     headers: { "Content-Type": "application/json", ...headers },
     withCredentials
   });
-  let tokenRefreshPromise = null;
+  let isRefreshing = false;
+  let failedQueue = [];
+  const processQueue = (error, token = null) => {
+    failedQueue.forEach((prom) => {
+      if (error) {
+        prom.reject(error);
+      } else {
+        prom.resolve(token);
+      }
+    });
+    failedQueue = [];
+  };
   axiosInstance.interceptors.request.use(async (req) => {
     req.headers["X-Request-ID"] = uuidv4();
     if (req.isPublic) {
-      console.log(`[API Core] Skipping token for public request: ${req.url}`);
       return req;
     }
-    if (tokenRefreshPromise) {
-      await tokenRefreshPromise;
-    }
     let tokens = await tokenManager.getTokens();
     const now = Date.now();
     const tokenBuffer = 60 * 1e3;
-    if (tokens.accessToken && tokens.expiresAt && tokens.expiresAt - now < tokenBuffer) {
-      if (!tokenRefreshPromise && config.refreshTokenConfig) {
+    if (tokens.accessToken && tokens.expiresAt && tokens.expiresAt - now < tokenBuffer && !isRefreshing) {
+      if (config.refreshTokenConfig) {
         console.log("[API Core] Proactive token refresh initiated.");
-        tokenRefreshPromise = refreshToken(config, tokenManager);
+        isRefreshing = true;
+        try {
+          const newTokens = await refreshToken(config, tokenManager);
+          if (newTokens) tokens = newTokens;
+        } finally {
+          isRefreshing = false;
+        }
       }
-      const newTokens = await tokenRefreshPromise;
-      tokenRefreshPromise = null;
-      if (newTokens) tokens = newTokens;
     }
     if (tokens.accessToken && !tokenManager.isHttpOnly()) {
-      const tokenType = tokens.tokenType || "Bearer";
-      req.headers.Authorization = `${tokenType} ${tokens.accessToken}`;
-      console.log(`[API Core] Token attached to request: ${req.url}`);
-    } else {
-      console.warn(`[API Core] No token attached for request: ${req.url}`);
+      req.headers.Authorization = `${tokens.tokenType || "Bearer"} ${tokens.accessToken}`;
     }
     return req;
   }, (error) => Promise.reject(error));
@@ -96,19 +102,34 @@ function createApiClient(config) {
     (response) => response,
     async (error) => {
       const originalRequest = error.config;
-      if (error.response?.status === 401 && !originalRequest._retry) {
-        originalRequest._retry = true;
-        if (!tokenRefreshPromise && config.refreshTokenConfig) {
-          console.log("[API Core] Reactive token refresh initiated due to 401.");
-          tokenRefreshPromise = refreshToken(config, tokenManager);
+      if (error.response?.status === 401 && !originalRequest._retry && config.refreshTokenConfig) {
+        if (isRefreshing) {
+          return new Promise((resolve, reject) => {
+            failedQueue.push({ resolve, reject });
+          }).then((token) => {
+            if (token && !tokenManager.isHttpOnly()) {
+              originalRequest.headers["Authorization"] = `Bearer ${token}`;
+            }
+            return axiosInstance(originalRequest);
+          });
         }
-        const newTokens = await tokenRefreshPromise;
-        tokenRefreshPromise = null;
-        if (newTokens) {
-          if (newTokens.accessToken && !tokenManager.isHttpOnly()) {
-            originalRequest.headers.Authorization = `${newTokens.tokenType || "Bearer"} ${newTokens.accessToken}`;
+        originalRequest._retry = true;
+        isRefreshing = true;
+        try {
+          const newTokens = await refreshToken(config, tokenManager);
+          if (!newTokens || !newTokens.accessToken) {
+            throw new Error("Token refresh failed to produce a new access token.");
+          }
+          processQueue(null, newTokens.accessToken);
+          if (!tokenManager.isHttpOnly()) {
+            originalRequest.headers["Authorization"] = `${newTokens.tokenType || "Bearer"} ${newTokens.accessToken}`;
           }
           return axiosInstance(originalRequest);
+        } catch (refreshError) {
+          processQueue(refreshError, null);
+          return Promise.reject(refreshError);
+        } finally {
+          isRefreshing = false;
         }
       }
       const enhancedError = {
@@ -225,6 +246,15 @@ function createApiServices(axiosInstance, endpoint) {
       return processResponse(error);
     }
   };
+  const put = async (id, data, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}/${id}`;
+    try {
+      const response = await axiosInstance.put(finalUrl, data, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
   const patch = async (id, data, config) => {
     const finalUrl = config?.endpoint || `${endpoint}/${id}`;
     try {
@@ -243,7 +273,38 @@ function createApiServices(axiosInstance, endpoint) {
       return processResponse(error);
     }
   };
-  return { get, getWithQuery, post, patch, remove };
+  const bulkDelete = async (ids, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}`;
+    try {
+      const response = await axiosInstance.delete(finalUrl, { data: { ids }, ...config });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const upload = async (file, additionalData, config) => {
+    const finalUrl = config?.endpoint || `${endpoint}`;
+    const formData = new FormData();
+    formData.append("file", file);
+    if (additionalData) {
+      Object.keys(additionalData).forEach((key) => {
+        formData.append(key, additionalData[key]);
+      });
+    }
+    try {
+      const response = await axiosInstance.post(finalUrl, formData, {
+        ...config,
+        headers: {
+          ...config?.headers,
+          "Content-Type": "multipart/form-data"
+        }
+      });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  return { get, getWithQuery, post, put, patch, remove, bulkDelete, upload };
 }
 
 // src/services/actions.ts
@@ -314,7 +375,7 @@ function useApi(axiosInstance, config) {
     initialQuery = { limit: 10 },
     enabled = true,
     refetchAfterChange = true,
-    // تم تعديل القيمة الافتراضية لتكون أكثر شيوعًا
+    requestConfig,
     onSuccess,
     onError
   } = config;
@@ -331,12 +392,15 @@ function useApi(axiosInstance, config) {
     const currentQuery = options || queryOptions;
     setState((prev) => ({ ...prev, data: null, loading: true, error: null }));
     const queryString = buildPaginateQuery(currentQuery);
-    const result = await apiServices.getWithQuery(queryString, { cancelTokenKey: endpoint });
+    const result = await apiServices.getWithQuery(queryString, {
+      cancelTokenKey: endpoint,
+      ...requestConfig
+    });
     setState(result);
     if (!result.success && onError) {
       onError(result.message || "Fetch failed", result.error || void 0);
     }
-  }, [apiServices, queryOptions, endpoint, onError]);
+  }, [apiServices, queryOptions, endpoint, onError, requestConfig]);
   useEffect(() => {
     if (enabled) {
       fetchData();
@@ -355,6 +419,19 @@ function useApi(axiosInstance, config) {
     }
     return result;
   };
+  const putItem = async (id, item, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.put(id, item, options);
+    if (result.success) {
+      if (refetchAfterChange) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "Item replaced successfully!", result.data);
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Replace failed", result.error || void 0);
+    }
+    return result;
+  };
   const updateItem = async (id, updatedItem, options) => {
     setState((prev) => ({ ...prev, loading: true }));
     const result = await apiServices.patch(id, updatedItem, options);
@@ -381,19 +458,39 @@ function useApi(axiosInstance, config) {
     }
     return result;
   };
+  const bulkDeleteItem = async (ids, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.bulkDelete(ids, options);
+    if (result.success) {
+      if (refetchAfterChange) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "Items deleted successfully!");
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Bulk delete failed", result.error || void 0);
+    }
+    return result;
+  };
+  const uploadFile = async (file, additionalData, options) => {
+    setState((prev) => ({ ...prev, loading: true }));
+    const result = await apiServices.upload(file, additionalData, options);
+    if (result.success) {
+      if (refetchAfterChange && options?.refetch !== false) await fetchData();
+      else setState((prev) => ({ ...prev, loading: false }));
+      if (onSuccess) onSuccess(result.message || "File uploaded successfully!", result.data);
+    } else {
+      setState((prev) => ({ ...prev, loading: false, error: result.error }));
+      if (onError) onError(result.message || "Upload failed", result.error || void 0);
+    }
+    return result;
+  };
   const setPage = (page) => setQueryOptions((prev) => ({ ...prev, page }));
   const setLimit = (limit) => setQueryOptions((prev) => ({ ...prev, limit, page: 1 }));
   const setSearchTerm = (search) => setQueryOptions((prev) => ({ ...prev, search, page: 1 }));
   const setSorting = (sortBy) => setQueryOptions((prev) => ({ ...prev, sortBy }));
   const setFilters = (filter) => setQueryOptions((prev) => ({ ...prev, filter, page: 1 }));
   const setQueryParam = (key, value) => {
-    setQueryOptions((prev) => {
-      const newQuery = { ...prev, [key]: value };
-      if (key !== "page") {
-        newQuery.page = 1;
-      }
-      return newQuery;
-    });
+    setQueryOptions((prev) => ({ ...prev, [key]: value, page: key !== "page" ? 1 : prev.page }));
   };
   const resetQuery = () => setQueryOptions(initialQuery);
   return {
@@ -402,8 +499,14 @@ function useApi(axiosInstance, config) {
     actions: {
       fetch: fetchData,
       create: createItem,
+      put: putItem,
+      // <-- NEW
       update: updateItem,
-      remove: deleteItem
+      remove: deleteItem,
+      bulkRemove: bulkDeleteItem,
+      // <-- NEW
+      upload: uploadFile
+      // <-- NEW
     },
     query: {
       options: queryOptions,
@@ -414,7 +517,6 @@ function useApi(axiosInstance, config) {
       setSorting,
       setFilters,
       setQueryParam,
-      // <-- NEW
       reset: resetQuery
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-core-lib",
-  "version": "4.3.3",
+  "version": "4.4.4",
   "description": "A flexible and powerful API client library for modern web applications.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",