Configuration

Zlient is highly configurable at both the client level and the request level.

Client Options

Pass these to new HttpClient(options).

Option	Type	Description
baseUrls	BaseUrlMap	Required. Map of service names to URLs. Must include default.
headers	Record<string, string>	Default headers applied to every request.
auth	AuthProvider	Authentication strategy (see Auth Guide).
retry	RetryStrategy	Global retry configuration (see Error Handling).
timeout	{ requestTimeoutMs: number }	Global timeout for all requests.
interceptors	Interceptors	Hooks for request/response lifecycle.
logger	Logger	Logger implementation.
metrics	MetricsCollector	Metrics collector implementation.

BaseUrlMap

Zlient supports multiple services in one client instance.

const client = new HttpClient({
  baseUrls: {
    default: 'https://api.example.com',
    auth: 'https://auth.example.com',
    cdn: 'https://cdn.example.com'
  }
});

Using a specific service:

await getProfile({ baseUrlKey: 'auth' });

Request Options

Pass these as part of the argument object.

await endpoint({
  ...params,
  
  // Advanced options
  advanced: {
    // Override base URL (if supported by schema)
    baseUrlKey: 'cdn',
    // Skip authentication for this request
    skipAuth: true
  },
  
  // Merge these headers with default headers
  headers: { 'Cache-Control': 'no-cache' },
  
  // AbortSignal for cancellation
  signal: controller.signal,
  
  // Append query params dynamically
  query: { debug: 'true' }
});