axios-react-hook 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MUHAMMED RASHID
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# axios-react-hook
+
+A simple and customizable React hook for making HTTP requests using Axios.
+
+## Features
+
+- ✅ Supports GET, POST, PUT, DELETE, PATCH, etc.
+- ✅ Auto and manual fetching
+- ✅ Refetch support
+- ✅ Pass your own Axios instance
+
+## Installation
+
+```bash
+npm install axios-react-hook
+```
+
+## Usage
+
+```js
+import useAxios from 'axios-react-hook';
+import axiosInstance from './axiosInstance'; // Optional custom instance
+
+const { data, loading, error, refetch } = useAxios(
+  'https://jsonplaceholder.typicode.com/posts',
+  'get',
+  null,
+  true,
+  axiosInstance
+);
+```
+
+## API
+
+### Parameters
+
+| Param         | Type     | Default | Description                            |
+|---------------|----------|---------|----------------------------------------|
+| `url`         | `string` | —       | Request URL                            |
+| `method`      | `string` | `'get'` | HTTP method                            |
+| `data`        | `object` | `null`  | Request payload or query params        |
+| `auto`        | `boolean`| `true`  | Auto execute request on mount          |
+| `instance`    | `AxiosInstance` | `axios` | Custom Axios instance (optional) |
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "axios-react-hook",
+  "version": "1.0.0",
+  "description": "A lightweight React hook for Axios-based API calls with support for all HTTP methods.",
+  "main": "src/useAxios.js",
+  "keywords": ["axios", "react", "hook", "api", "http"],
+  "author": "Muhammed Rashid",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devmdrd/axios-react-hook"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  }
+}

package/src/useAxios.js

@@ -0,0 +1,33 @@
+import { useState, useEffect } from 'react';
+import axios from 'axios';
+
+export default function useAxios(
+  url,
+  method = 'get',
+  body = null,
+  auto = true,
+  instance = axios
+) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(auto);
+  const [error, setError] = useState(null);
+
+  const fetch = async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const res = await instance[method](url, body);
+      setData(res.data);
+    } catch (err) {
+      setError(err);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    if (auto) fetch();
+  }, [url]);
+
+  return { data, loading, error, refetch: fetch };
+}