TeqBench Angular HTTPAngular HTTP

Centralizes path resolution, default headers, and resilience patterns (timeout, exponential-backoff retry on transient errors).

Feature services extend this class, provide the base URL, and call its typed methods. Only GET requests include the retry operator; mutating methods (POST, PUT, PATCH, DELETE) intentionally skip retries.

Subclasses can override resilience values by redeclaring the class property.

Extend this class in feature services to inherit automatic timeout, retry, URL resolution, and default header behavior. Provide baseUrl and call the protected HTTP methods (get, post, put, patch, delete).

// UserService is a hypothetical consumer-defined subclass
@Injectable({ providedIn: 'root' })
export class UserService extends TbxNgxHttpService {
    protected override readonly baseUrl = environment.apiUrl;

    getUser(id: string) {
        return this.get<User>(`users/${id}`);
    }
}

// SlowApiService is a hypothetical consumer-defined subclass
export class SlowApiService extends TbxNgxHttpService {
    protected override readonly baseUrl = environment.apiUrl;
    protected override readonly DEFAULT_TIMEOUT = 30_000;
}

Passed as the optional third argument to post, put, and patch. When headers is provided, the service's default headers are replaced entirely (not merged).

Pass an instance of this interface to customize headers on POST, PUT, and PATCH requests made through TbxNgxHttpService.

import { HttpHeaders } from '@angular/common/http';
import { TbxNgxHttpBodyRequestOptions } from '@teqbench/tbx-ngx-http';

const options: TbxNgxHttpBodyRequestOptions = {
    headers: new HttpHeaders({ Authorization: 'Bearer token' }),
};

Passed as the optional second argument to get and delete. When headers is provided, the service's default headers are replaced entirely (not merged).

Pass an instance of this interface to customize query parameters or headers on GET and DELETE requests made through TbxNgxHttpService.

import { HttpParams } from '@angular/common/http';
import { TbxNgxHttpRequestOptions } from '@teqbench/tbx-ngx-http';

const options: TbxNgxHttpRequestOptions = {
    params: new HttpParams().set('page', '1'),
};

Applied to every HTTP request made through TbxNgxHttpService. Subclasses override by redeclaring the DEFAULT_TIMEOUT class property.

Import directly when building a custom retry or timeout strategy outside of TbxNgxHttpService.

import { TBX_NGX_HTTP_DEFAULT_TIMEOUT_MS } from '@teqbench/tbx-ngx-http';

Controls how many times a failed GET request is retried before the error propagates to the caller. Subclasses of TbxNgxHttpService override by redeclaring the RETRY_COUNT class property.

Import directly when building a custom retry strategy outside of TbxNgxHttpService.

import { TBX_NGX_HTTP_RETRY_COUNT } from '@teqbench/tbx-ngx-http';

The actual delay follows the formula RETRY_DELAY * 2^(attempt - 1). Subclasses of TbxNgxHttpService override by redeclaring the RETRY_DELAY class property.

Import directly when building a custom backoff strategy outside of TbxNgxHttpService.

import { TBX_NGX_HTTP_RETRY_DELAY_MS } from '@teqbench/tbx-ngx-http';

Only transient server errors and network failures are retried. 4xx client errors (except 408 and 429) indicate a malformed request that will not succeed on retry.

Included status codes:

• 0 — Network error (no response received; browser reports status 0)

• 408 — Request Timeout

• 429 — Too Many Requests (rate-limited; retry after backoff)

• 500 — Internal Server Error

• 502 — Bad Gateway

• 503 — Service Unavailable

• 504 — Gateway Timeout

Import directly when implementing a custom retry predicate that needs to reference the same set of retryable statuses used by TbxNgxHttpService.

import { TBX_NGX_HTTP_RETRYABLE_STATUSES } from '@teqbench/tbx-ngx-http';

if (TBX_NGX_HTTP_RETRYABLE_STATUSES.has(response.status)) {
    // retry logic
}

• This package provides services, constants, and type interfaces only. It has no direct UI surface, no rendered DOM, and no keyboard, focus, color, or motion considerations. Accessibility for any UI that surfaces HTTP errors, loading states, or retry progress is owned by the consuming application.