hermes-http

Another wrap over fetch

Features

• Make http requests for browser and node (using node-fetch)
• Avoid duplicate requests
• Intercept request, success response and error response
• Abort requests
• Retry requests
• Automatic conversion of request/response data
• Typescript out of the box

Install

Using npm

npm i hermes-http

Using npm

yarn add hermes-http

Using pnpm

pnpm add hermes-http

Using hermes

Hermes work with instances of http clients

import Hermes from "http-client"

export const hermes = Hermes({
    /*
        if the same URL is called when the previous request
        is not finished, hermes will resolve the new promise
        with the previous promise and not performe a new 
        request
    */
    avoidDuplicateRequests: false,
    // Base Url for concat with all instance url requests
    baseUrl: "",
    /*
        Timeout value default for all requests.
        You can configure the timeout per request
    */
    globalTimeout: 0,
    /*
        Default headers for all requests
    */
    headers: {},
    /*
        When response throws an error, hermes catch the 
        status code to perform a new request based on this
        array with status code:

        default value: [408, 429, 451, 500, 502, 503, 504]
    */
	retryStatusCode: number[];
});

Now you can use hermes instance to perform http requests.

1. Get with query parameters

The second arg of hermes.get accept a query key for convert an object in query string and concat with URL.

URL = "https://swapi.co/api/people" query = { search: "r2" } URL + query = "https://swapi.co/api/people?search=r2"

// old school style
hermes.get("https://swapi.co/api/people", {
		query: {
			search: "r2"
		}
	})
	.then((response) => console.info(response))
	.catch((e: HttpResponseError<unknown>) => {
		if (e.httpError !== null) {
			console.log({ ...e });
		}
	});
// async/await
try {
    const response = hermes.get("https://swapi.co/api/people", {
		query: {
			search: "r2"
		}
    });
} catch (e){
    if (e.httpError !== null) {
        console.log({ ...e });
    }
}

For post request, you just drop the object as second parameter and hermes will make all job for you.

/*
    Hermes apply JSON.stringify on this object to perform request
*/
const response = await hermes.post("/user", { name: "Peter Parker", hero: "Spider Man" });

Http Methods

type RequestParameters = Partial<{
	query: QueryString<any>;
	encodeQueryString: boolean;
	headers: Headers;
	redirect?: RedirectMode;
	cors?: CorsMode;
	credentials?: CorsMode;
	controller: AbortController;
	retries: number;
	retryAfter: number;
	retryCodes: number[];
	timeout: number;
	omitHeaders: string[];
}>;

• hermes.get(url, RequestParams)
• hermes.delete(url, RequestParams)
• hermes.post(url, body, RequestParams)
• hermes.put(url, body, RequestParams)
• hermes.patch(url, body, RequestParams)