PURISTA API

---

PURISTA API / @purista/core / HttpClient

Class: HttpClient<CustomConfig>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:43

A HTTP client which will provide simple methods for GET, POST, PATCH, PUT and DELETE. Body payload will be handled as JSON requests It includes timeout and error handling and simple json response body parsing

Example

const client = new HttpClient({baseUrl: 'http://localhost/api})

// GET http://localhost/api/v1/orders
const result = await client.get('v1/orders')

Extended by

• DaprClient
• InfisicalClient

Type Parameters

CustomConfig

CustomConfig extends Record<string, unknown> = EmptyObject

Implements

• RestClient

Constructors

Constructor

new HttpClient<CustomConfig>(config): HttpClient<CustomConfig>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:56

Parameters

config

{ [K in string | number | symbol]: ({ baseUrl?: string; basicAuth?: { password: string; username: string }; bearerToken?: string; defaultHeaders?: Record<string, string>; defaultTimeout?: number; enableOpentelemetry?: boolean; isKeepAlive?: boolean; logger?: Logger; logLevel?: LogLevelName; name?: string; spanProcessor?: SpanProcessor; traceId?: string } & CustomConfig)[K] }

Returns

HttpClient<CustomConfig>

Properties

auth

protected auth: AuthCredentials

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:55

---

baseUrl

baseUrl: undefined | URL = undefined

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:50

---

config

config: { [K in string | number | symbol]: ({ baseUrl?: string; basicAuth?: { password: string; username: string }; bearerToken?: string; defaultHeaders?: Record<string, string>; defaultTimeout?: number; enableOpentelemetry?: boolean; isKeepAlive?: boolean; logger?: Logger; logLevel?: LogLevelName; name?: string; spanProcessor?: SpanProcessor; traceId?: string } & CustomConfig)[K] }

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:46

---

logger

logger: Logger

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:45

---

name

name: string = 'HttpClient'

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:44

---

spanProcessor

spanProcessor: undefined | SpanProcessor

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:52

---

timeout

timeout: number

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:48

---

traceProvider

traceProvider: NodeTracerProvider

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:53

Methods

delete()

delete<T>(path, options?, payload?): Promise<T>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:333

DELETE request

Type Parameters

T

T

Parameters

path

string

options?

HttpClientRequestOptions

payload?

unknown

Returns

Promise<T>

Implementation of

RestClient.delete

---

execute()

protected execute(method, path, options?, payload?): Promise<any>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:197

Helper method

Parameters

method

string

path

string

options?

HttpClientRequestOptions

payload?

unknown

Returns

Promise<any>

Throws

UnhandledError

---

get()

get<T>(path, options?): Promise<T>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:293

GET request

Type Parameters

T

T

Parameters

path

string

options?

HttpClientRequestOptions

Returns

Promise<T>

Implementation of

RestClient.get

---

getTracer()

getTracer(): Tracer

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:98

Returns open telemetry tracer of this service

Returns

Tracer

Tracer

---

getUrlAndHeader()

protected getUrlAndHeader(path, options?): object

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:145

Parameters

path

string

options?

HttpClientRequestOptions

Returns

object

headers

headers: Record<string, string>

url

url: URL

---

patch()

patch<T>(path, payload, options?): Promise<T>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:323

PATCH request

Type Parameters

T

T

Parameters

path

string

payload

unknown

options?

HttpClientRequestOptions

Returns

Promise<T>

Implementation of

RestClient.patch

---

post()

post<T>(path, payload, options?): Promise<T>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:303

POST request

Type Parameters

T

T

Parameters

path

string

payload

unknown

options?

HttpClientRequestOptions

Returns

Promise<T>

Implementation of

RestClient.post

---

put()

put<T>(path, payload, options?): Promise<T>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:313

PUT request

Type Parameters

T

T

Parameters

path

string

payload

unknown

options?

HttpClientRequestOptions

Returns

Promise<T>

Implementation of

RestClient.put

---

setBearerToken()

setBearerToken(token): void

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:184

Set the bearer token for all following requests.

Parameters

token

the bearer token

undefined | string

Returns

void

Implementation of

RestClient.setBearerToken

---

startActiveSpan()

startActiveSpan<F>(name, opts, context, fn): Promise<F>

Defined in: packages/core/src/HttpClient/HttpClient.impl.ts:110

Start a child span for opentelemetry tracking

Type Parameters

F

F

Parameters

name

string

name of span

opts

SpanOptions

span options

context

optional context

undefined | Context

fn

(span) => Promise<F>

function to be executed within the span

Returns

Promise<F>

return value of fn