https://github.com/josemucv2/fetchify
Fetchify is a lightweight and flexible library for making HTTP requests in JavaScript/TypeScript applications. It allows managing custom configurations, token authentication, and supports request and response interceptors. Compatible on both client and server.
https://github.com/josemucv2/fetchify
angular api https library nodejs react svelte typescript vue
Last synced: 10 months ago
JSON representation
Fetchify is a lightweight and flexible library for making HTTP requests in JavaScript/TypeScript applications. It allows managing custom configurations, token authentication, and supports request and response interceptors. Compatible on both client and server.
- Host: GitHub
- URL: https://github.com/josemucv2/fetchify
- Owner: josemucv2
- License: mit
- Created: 2024-12-22T19:49:47.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-08T20:35:43.000Z (about 1 year ago)
- Last Synced: 2025-01-24T20:27:08.717Z (12 months ago)
- Topics: angular, api, https, library, nodejs, react, svelte, typescript, vue
- Language: TypeScript
- Homepage:
- Size: 157 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# @jmfetchify/fetchify
**@jmfetchify/fetchify** is a lightweight and flexible HTTP request library for JavaScript/TypeScript applications. It provides simple configuration management, token-based authentication, and supports request and response interceptors. It works seamlessly on both client and server sides.
## Features
- Customizable HTTP request methods (GET, POST, PUT, PATCH, DELETE).
- Token management for authentication.
- Request and response interceptors.
- Supports both client-side (browser) and server-side (Node.js) usage.
## Installation
To install the library, run:
```bash
npm install @jmfetchify/fetchify
```
or
```bash
pnpm install @jmfetchify/fetchify
```
## USAGE
```typescript
import { Fetchify } from "@jmfetchify/fetchify";
const fetchifyInstance = Fetchify.create({
baseURL: 'https://your-api-url.com',
headers: {}
});
fetchifyInstance.setToken({ token: 'your-auth-token' });
fetchifyInstance.setRequestInterceptor(async (config) => {
const token = localStorage.getItem("accessToken");
if (token) {
config.headers.set("Authorization", `Bearer ${token}`);
}
console.log("Request Interceptor:", config);
return config;
});
// Example GET request
fetchifyInstance.GET({ endpoint: 'users' }).then(response => {
console.log('Users:', response);
}).catch(error => {
console.error('Error fetching users:', error);
});
```
## API Methods
### setToken
Sets the authentication token for the requests.
```typescript
setToken({ token: string })
```
### `setRequestInterceptor`
Sets a request interceptor to modify the request before it is sent.
```typescript
setRequestInterceptor(interceptor: (config: Request) => Promise)
```
### setResponseInterceptor
Sets a response interceptor to modify the response before it is returned to the caller.
```typescript
setResponseInterceptor(interceptor: (response: T) => Promise)
```
### GET
Sends a GET request to the specified endpoint.
```typescript
GET({ endpoint: string, options?: RequestInit, timeOut?: number })
```
### POST
Sends a POST request to the specified endpoint with the given body.
```typescript
POST({ endpoint: string, body?: unknown, options?: RequestInit, timeOut?: number })
```
### PUT
Sends a PUT request to the specified endpoint with the given body.
```typescript
PUT({ endpoint: string, body?: unknown, options?: RequestInit, timeOut?: number })
```
### PATCH
Sends a PATCH request to the specified endpoint with the given body.
```typescript
PATCH({ endpoint: string, body?: unknown, options?: RequestInit, timeOut?: number })
```
### DELETE
Sends a DELETE request to the specified endpoint.
```typescript
DELETE({ endpoint: string, options?: RequestInit, timeOut?: number })
```
## License
This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.