@veterancrowd/wrapped-api

0.0.11 • Public • Published

WrappedApi

This package wraps an Axios instance to provide consistent logging and other services.

API Documentation

WrappedApi

WrappedApi.WrappedApi

Wraps an Axios instance to provide standard logging & services.

Kind: static class of WrappedApi

new exports.WrappedApi([options])

WrappedApi constructor.

Param Type Description
[options] object Options.
[options.logger] object Logger instance (default is global console object). Must have info, error & debug methods

wrappedApi.logger ⇒ object

Get logger instance.

Kind: instance property of WrappedApi
Returns: object - Logger instance.

wrappedApi.init([config]) ⇒ WrappedApi

Initialize Axios instance.

Kind: instance method of WrappedApi
Returns: WrappedApi - WrappedApi instance for chaining.

Param Type Description
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.request([config]) ⇒ Promise.<WrappedApiResponse>

Send a generic request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.get([url], [config]) ⇒ Promise.<WrappedApiResponse>

Send a GET request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.delete([url], [config]) ⇒ Promise.<WrappedApiResponse>

Send a DELETE request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.head([url], [config]) ⇒ Promise.<WrappedApiResponse>

Send a HEAD request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.options([url], [config]) ⇒ Promise.<WrappedApiResponse>

Send a OPTIONS request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.post([url], [data], [config]) ⇒ Promise.<WrappedApiResponse>

Send a POST request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[data] object Request body.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.put([url], [data], [config]) ⇒ Promise.<WrappedApiResponse>

Send a PUT request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[data] object Request body.
[config] axios.AxiosRequestConfig Axios config object.

wrappedApi.patch([url], [data], [config]) ⇒ Promise.<WrappedApiResponse>

Send a PATCH request using the Axios instance.

Kind: instance method of WrappedApi
Returns: Promise.<WrappedApiResponse> - WrappedApiResponse object.

Param Type Description
[url] string Request URL.
[data] object Request body.
[config] axios.AxiosRequestConfig Axios config object.

WrappedApi.composeError(e) ⇒ WrappedApiError

Compose Axios error.

Kind: static method of WrappedApi
Returns: WrappedApiError - WrappedApiError object.

Param Type Description
e axios.AxiosError Axios error object.

WrappedApi.composeResponse(response) ⇒ WrappedApiResponse

Compose Axios response.

Kind: static method of WrappedApi
Returns: WrappedApiResponse - WrappedApiResponse object.

Param Type Description
response axios.AxiosResponse Axios response object.

WrappedApi~WrappedApiError : object

WrappedApi error object.

Kind: inner typedef of WrappedApi
Properties

Name Type Description
[error] string Axios error message.
[response] object Received HTTP response.
[response.status] number Response status code.
[response.headers] object Selected response headers.
[response.data] object Response body.
[request] object HTTP request body.

WrappedApi~WrappedApiResponse : object

WrappedApi response object.

Kind: inner typedef of WrappedApi
Properties

Name Type Description
[response] object Received HTTP response.
[response.status] number Response status code.
[response.statusText] string Response status text.
[response.headers] object Selected response headers.
[response.data] object Response body.

See more great templates and other tools on my GitHub Profile!

Readme

Keywords

none

Package Sidebar

Install

npm i @veterancrowd/wrapped-api

Weekly Downloads

54

Version

0.0.11

License

none

Unpacked Size

35.4 kB

Total Files

10

Last publish

Collaborators

  • karmaniverous