Class BaseClient`Abstract`

Abstract base HTTP client with retry logic and request/response transformation.

Hierarchy (View Summary)

BaseClient
- TelaSDK

Index

Constructors

Properties

baseURL fetch maxRetries timeout

Accessors

Methods

buildRequest buildURL createHeaders delete fetchWithTimeout get getAuthHeaders getUserAgent patch post put requestRaw stringifyQuery

Constructors

constructor

new BaseClient(__namedParameters: BaseClientOptions): BaseClient
Parameters
- __namedParameters: BaseClientOptions
Returns BaseClient

Properties

baseURL

baseURL: string

fetch

fetch: typeof fetch

maxRetries

maxRetries: number

timeout

timeout: number

Accessors

`Abstract`authToken

get authToken(): string
Returns string

Methods

`Protected`buildRequest

buildRequest<Req>(
options: RequestOptions<Req>,
): { req: RequestInit; timeout: number; url: string }
Type Parameters
- Req
Parameters
- options: RequestOptions<Req>
Returns { req: RequestInit; timeout: number; url: string }

`Protected`buildURL

buildURL<Req>(path: string, query: Req | null | undefined): string
Type Parameters
- Req
Parameters
- path: string
- query: Req | null | undefined
Returns string

`Protected`createHeaders

createHeaders(opts?: Record<string, string>): Headers
Parameters
- Optionalopts: Record<string, string>
Returns Headers

delete

delete<Req, Res>(path: string, opts?: RequestOptions<Req>): Promise<Res>
Type Parameters
- Req
- Res
Parameters
- path: string
- Optionalopts: RequestOptions<Req>
Returns Promise<Res>

fetchWithTimeout

fetchWithTimeout(
    url: string,
    _options: RequestInit,
    timeout: number,
    controller: AbortController,
): Promise<Response>
Parameters
- url: string
- _options: RequestInit
- timeout: number
- controller: AbortController
Returns Promise<Response>

get

get<Req, Res>(path: string, opts?: RequestOptions<Req>): Promise<Res>
Type Parameters
- Req
- Res
Parameters
- path: string
- Optionalopts: RequestOptions<Req>
Returns Promise<Res>

`Protected` `Abstract`getAuthHeaders

getAuthHeaders(): Record<string, string>
Returns Record<string, string>

`Protected`getUserAgent

getUserAgent(): string
Returns string

patch

patch<Req, Res>(path: string, opts?: RequestOptions<Req>): Promise<Res>
Type Parameters
- Req
- Res
Parameters
- path: string
- Optionalopts: RequestOptions<Req>
Returns Promise<Res>

post

post<Req, Res>(path: string, opts?: RequestOptions<Req>): Promise<Res>
Type Parameters
- Req
- Res
Parameters
- path: string
- Optionalopts: RequestOptions<Req>
Returns Promise<Res>

put

put<Req, Res>(path: string, opts?: RequestOptions<Req>): Promise<Res>
Type Parameters
- Req
- Res
Parameters
- path: string
- Optionalopts: RequestOptions<Req>
Returns Promise<Res>

requestRaw

requestRaw<Req>(
    method: HTTPMethods,
    path: string,
    opts?: RequestOptions<Req>,
): Promise<{ controller: AbortController; response: Response }>
Performs a request and returns the raw Response together with its AbortController, bypassing JSON parsing and case transformation.

Intended for consumers that parse the response body themselves — e.g. custom Server-Sent Events streams whose framing differs from the chat completion stream handled by Stream.fromSSEResponse. Reuses the client's retry, auth, timeout, and baseURL handling.
Type Parameters
- Req
Parameters
- method: HTTPMethods
  The HTTP method to use.
- path: string
  Request path (relative to baseURL/opts.baseURL, or absolute).
- Optionalopts: RequestOptions<Req>
  Request options (notably baseURL, query, and signal).
Returns Promise<{ controller: AbortController; response: Response }>
The live Response and the AbortController controlling it.

`Protected`stringifyQuery

stringifyQuery(query: Record<string, unknown>): string
Parameters
- query: Record<string, unknown>
Returns string