Client

---

import { Client } from "@hyper-fetch/core"

Description

Client is a class that allows you to configure the connection with the server and then use it to create requests which, when called using the appropriate method, will cause the server to be queried for the endpoint and method specified in the request.

Defined in client/client.ts:40

Parameters

Name	Details
options Required	ClientOptionsType<Client<GlobalErrorType, Adapter>>

Properties

adapter

Description

Defined in client/client.ts:57

Type

Adapter

---

appManager

Description

Defined in client/client.ts:53

Type

AppManager

---

cache

Description

Defined in client/client.ts:58

Type

Cache<Client<GlobalErrorType, Adapter>>

---

debug

Description

Defined in client/client.ts:42

Type

boolean

---

defaultExtra

Description

Defined in client/client.ts:63

Type

ExtractAdapterExtraType<Adapter>

---

defaultMethod

Description

Defined in client/client.ts:62

Type

ExtractAdapterMethodType<Adapter>

---

effects

Description

Defined in client/client.ts:66

Type

RequestEffectInstance[]

---

fetchDispatcher

Description

Defined in client/client.ts:59

Type

Dispatcher

---

logger

Description

Defined in client/client.ts:96

Type

LoggerType

---

loggerManager

Description

Defined in client/client.ts:54

Type

LoggerManager

---

options

Description

Defined in client/client.ts:98

Type

ClientOptionsType<Client<GlobalErrorType, Adapter>>

---

queryParamsConfig

Description

Defined in client/client.ts:69

Type

QueryStringifyOptionsType

---

requestManager

Description

Defined in client/client.ts:52

Type

RequestManager

---

submitDispatcher

Description

Defined in client/client.ts:60

Type

Dispatcher

---

url

Description

Defined in client/client.ts:41

Type

string

---

__onAuthCallbacks

Description

Defined in client/client.ts:48

Type

RequestInterceptorType[]

---

__onErrorCallbacks

Description

Defined in client/client.ts:45

Type

ResponseInterceptorType<any, any, AdapterType<Partial<XMLHttpRequest>, HttpMethodsType, number, AdapterExtraType, string | QueryParamsType>>[]

---

__onRequestCallbacks

Description

Defined in client/client.ts:49

Type

RequestInterceptorType[]

---

__onResponseCallbacks

Description

Defined in client/client.ts:47

Type

ResponseInterceptorType<any, any, AdapterType<Partial<XMLHttpRequest>, HttpMethodsType, number, AdapterExtraType, string | QueryParamsType>>[]

---

__onSuccessCallbacks

Description

Defined in client/client.ts:46

Type

ResponseInterceptorType<any, any, AdapterType<Partial<XMLHttpRequest>, HttpMethodsType, number, AdapterExtraType, string | QueryParamsType>>[]

---

Methods

abortKeyMapper()

Description

Defined in client/client.ts:74

Return

(request: RequestInstance) => string

---

adapterDefaultOptions()

Description

Defined in client/client.ts:70

Return

(request: RequestInstance) => ExtractAdapterOptionsType<Adapter>

---

cacheKeyMapper()

Description

Defined in client/client.ts:75

Return

(request: RequestInstance) => string

---

effectKeyMapper()

Description

Defined in client/client.ts:77

Return

(request: RequestInstance) => string

---

headerMapper()

Description

Method to get default headers and to map them based on the data format exchange, by default it handles FormData / JSON formats.

Defined in client/client.ts:89

Return

(request: T) => HeadersInit

---

payloadMapper()

Description

Method to get request data and transform them to the required format. It handles FormData and JSON by default.

Defined in client/client.ts:93

Return

(data: unknown) => string | FormData

---

queueKeyMapper()

Description

Defined in client/client.ts:76

Return

(request: RequestInstance) => string

---

requestDefaultOptions()

Description

Defined in client/client.ts:71

Return

(options: RequestOptionsType<string, ExtractAdapterOptionsType<Adapter>, ExtractAdapterMethodType<Adapter>>) => Partial<RequestOptionsType<string, ExtractAdapterOptionsType<Adapter>, ExtractAdapterMethodType<Adapter>>>

---

stringifyQueryParams()

Description

Method to stringify query params from objects.

Defined in client/client.ts:84

Return

(queryParams: QueryParamsType | string | NegativeTypes) => string

---

addEffect()

Preview

addEffect(effect)

Description

Add persistent effects which trigger on the request lifecycle

Defined in client/client.ts:261

Parameters

Name	Details
effect Required	RequestEffectInstance | RequestEffectInstance[]

Return

this

---

clear()

Preview

clear()

Description

Clears the Client instance and remove all listeners on it's dependencies

Defined in client/client.ts:329

Return

void

---

createRequest()

Preview

createRequest<Response, Payload, LocalError, QueryParams>()

Description

Create requests based on the Client setup

Defined in client/client.ts:351

Return

(params: RequestOptionsType<EndpointType, AdapterOptions, MethodType>) => Request<Response, Payload, QueryParams, GlobalErrorType, LocalError, EndpointType, ExtractUnionAdapter<Adapter, [object Object]>, false, false, false>

---

onAuth()

Preview

onAuth(callback)

Description

Method of manipulating requests before sending the request. We can for example add custom header with token to the request which request had the auth set to true.

Defined in client/client.ts:215

Parameters

Name	Details
callback Required	RequestInterceptorType

Return

Client<GlobalErrorType, Adapter>

---

onError()

Preview

onError<ErrorType>(callback)

Description

Method for intercepting error responses. It can be used for example to refresh tokens.

Defined in client/client.ts:223

Parameters

Name	Details
callback Required	ResponseInterceptorType<any, GlobalErrorType | ErrorType, Adapter>

Return

Client<GlobalErrorType, Adapter>

---

onRequest()

Preview

onRequest(callback)

Description

Method of manipulating requests before sending the request.

Defined in client/client.ts:243

Parameters

Name	Details
callback Required	RequestInterceptorType

Return

Client<GlobalErrorType, Adapter>

---

onResponse()

Preview

onResponse<ErrorType>(callback)

Description

Method for intercepting any responses.

Defined in client/client.ts:251

Parameters

Name	Details
callback Required	ResponseInterceptorType<any, GlobalErrorType | ErrorType, Adapter>

Return

Client<GlobalErrorType, Adapter>

---

onSuccess()

Preview

onSuccess<ErrorType>(callback)

Description

Method for intercepting success responses.

Defined in client/client.ts:233

Parameters

Name	Details
callback Required	ResponseInterceptorType<any, GlobalErrorType | ErrorType, Adapter>

Return

Client<GlobalErrorType, Adapter>

---

removeEffect()

Preview

removeEffect(effect)

Description

Remove effects from Client

Defined in client/client.ts:270

Parameters

Name	Details
effect Required	string | RequestEffectInstance

Return

this

---

setAbortKeyMapper()

Preview

setAbortKeyMapper(callback)

Description

Key setters

Defined in client/client.ts:281

Parameters

Name	Details
callback Required	(request: RequestInstance) => string

Return

void

---

setAdapter()

Preview

setAdapter<NewAdapter>(callback)

Description

Set custom http adapter to handle graphql, rest, firebase or others

Defined in client/client.ts:189

Parameters

Name	Details
callback Required	(Client: ClientInstance) => NewAdapter

Return

Client<GlobalErrorType, NewAdapter>

---

setAdapterDefaultOptions()

Preview

setAdapterDefaultOptions(callback)

Description

Defined in client/client.ts:122

Parameters

Name	Details
callback Required	(request: RequestInstance) => ExtractAdapterOptionsType<Adapter>

Return

Client<GlobalErrorType, Adapter>

---

setCacheKeyMapper()

Preview

setCacheKeyMapper(callback)

Description

Defined in client/client.ts:284

Parameters

Name	Details
callback Required	(request: RequestInstance) => string

Return

void

---

setDebug()

Preview

setDebug(debug)

Description

This method enables the logger usage and display the logs in console

Defined in client/client.ts:132

Parameters

Name	Details
debug Required	boolean

Return

Client<GlobalErrorType, Adapter>

---

setDefaultExtra()

Preview

setDefaultExtra(defaultExtra)

Description

Set default additional data for initial state.

Defined in client/client.ts:207

Parameters

Name	Details
defaultExtra Required	ExtractAdapterExtraType<Adapter>

Return

Client<any, AdapterType<any, any, any, any>>

---

setDefaultMethod()

Preview

setDefaultMethod(defaultMethod)

Description

Set default method for requests.

Defined in client/client.ts:199

Parameters

Name	Details
defaultMethod Required	ExtractAdapterMethodType<Adapter>

Return

Client<any, AdapterType<any, any, any, any>>

---

setEffectKeyMapper()

Preview

setEffectKeyMapper(callback)

Description

Defined in client/client.ts:290

Parameters

Name	Details
callback Required	(request: RequestInstance) => string

Return

void

---

setHeaderMapper()

Preview

setHeaderMapper(headerMapper)

Description

Set the custom header mapping function

Defined in client/client.ts:173

Parameters

Name	Details
headerMapper Required	HeaderMappingType

Return

Client<GlobalErrorType, Adapter>

---

setLogger()

Preview

setLogger(callback)

Description

Set the new logger instance to the Client

Defined in client/client.ts:148

Parameters

Name	Details
callback Required	(Client: ClientInstance) => LoggerManager

Return

Client<GlobalErrorType, Adapter>

---

setLoggerSeverity()

Preview

setLoggerSeverity(severity)

Description

Set the logger severity of the messages displayed to the console

Defined in client/client.ts:140

Parameters

Name	Details
severity Required	SeverityType

Return

Client<GlobalErrorType, Adapter>

---

setPayloadMapper()

Preview

setPayloadMapper(payloadMapper)

Description

Set the request payload mapping function which get triggered before request get send

Defined in client/client.ts:181

Parameters

Name	Details
payloadMapper Required	AdapterPayloadMappingType

Return

Client<GlobalErrorType, Adapter>

---

setQueryParamsConfig()

Preview

setQueryParamsConfig(queryParamsConfig)

Description

Set config for the query params stringify method, we can set here, among others, arrayFormat, skipNull, encode, skipEmptyString and more

Defined in client/client.ts:156

Parameters

Name	Details
queryParamsConfig Required	QueryStringifyOptionsType

Return

Client<GlobalErrorType, Adapter>

---

setQueueKeyMapper()

Preview

setQueueKeyMapper(callback)

Description

Defined in client/client.ts:287

Parameters

Name	Details
callback Required	(request: RequestInstance) => string

Return

void

---

setRequestDefaultOptions()

Preview

setRequestDefaultOptions(callback)

Description

This method allows to configure global defaults for the request configuration like method, auth, deduplication etc.

Defined in client/client.ts:113

Parameters

Name	Details
callback Required	(request: RequestInstance) => Partial<RequestOptionsType<string, ExtractAdapterOptionsType<Adapter>, ExtractAdapterMethodType<Adapter>>>

Return

Client<GlobalErrorType, Adapter>

---

setStringifyQueryParams()

Preview

setStringifyQueryParams(stringifyFn)

Description

Set the custom query params stringify method to the Client

Defined in client/client.ts:165

Parameters

Name	Details
stringifyFn Required	Custom callback handling query params stringify StringifyCallbackType

Return

Client<GlobalErrorType, Adapter>

---

__modifyAuth()

Preview

__modifyAuth(request)

Description

Helper used by http adapter to apply the modifications on response error

Defined in client/client.ts:297

Parameters

Name	Details
request Required	RequestInstance

Return

Promise<RequestInstance>

---

__modifyErrorResponse()

Preview

__modifyErrorResponse(response, request)

Description

Private helper to run async on-error response processing

Defined in client/client.ts:307

Parameters

Name	Details
response Required	ResponseReturnType<any, GlobalErrorType, Adapter>
request Required	RequestInstance

Return

Promise<ResponseReturnType<any, GlobalErrorType, Adapter>>

---

__modifyRequest()

Preview

__modifyRequest(request)

Description

Private helper to run async pre-request processing

Defined in client/client.ts:302

Parameters

Name	Details
request Required	RequestInstance

Return

Promise<RequestInstance>

---

__modifyResponse()

Preview

__modifyResponse(response, request)

Description

Private helper to run async response processing

Defined in client/client.ts:323

Parameters

Name	Details
response Required	ResponseReturnType<any, GlobalErrorType, Adapter>
request Required	RequestInstance

Return

Promise<ResponseReturnType<any, GlobalErrorType, Adapter>>

---

__modifySuccessResponse()

Preview

__modifySuccessResponse(response, request)

Description

Private helper to run async on-success response processing

Defined in client/client.ts:315

Parameters

Name	Details
response Required	ResponseReturnType<any, GlobalErrorType, Adapter>
request Required	RequestInstance

Return

Promise<ResponseReturnType<any, GlobalErrorType, Adapter>>

---