@backendkit-labs/http-client 0.1.0

package/README.md

@@ -0,0 +1,328 @@
+# @backendkit-labs/http-client
+
+[![npm version](https://img.shields.io/npm/v/@backendkit-labs/http-client?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@backendkit-labs/http-client)
+[![CI](https://img.shields.io/github/actions/workflow/status/backendkit-dev/backendkit-monorepo/ci.yml?style=flat-square&label=CI)](https://github.com/backendkit-dev/backendkit-monorepo/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@backendkit-labs/http-client?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/node/v/@backendkit-labs/http-client?style=flat-square)](package.json)
+
+> Production-grade HTTP client for Node.js — built on axios with circuit breaker, retry with exponential backoff, typed `Result<T, E>` responses, request cancellation, pre-request pipeline middleware, and optional NestJS DI integration.
+
+Every method returns `Result<HttpResponse<T>, HttpClientError>` — no try/catch needed, no unhandled rejections, always typed.
+
+---
+
+## Installation
+
+```bash
+npm install @backendkit-labs/http-client axios
+```
+
+NestJS peer dependencies (only for the `/nestjs` subpath):
+
+```bash
+npm install @nestjs/common @nestjs/core rxjs
+```
+
+---
+
+## TypeScript Configuration
+
+### Subpath exports (`/nestjs`)
+
+This package uses the `exports` field in `package.json` to expose the `/nestjs` subpath. TypeScript's ability to resolve it depends on the `moduleResolution` setting in your `tsconfig.json`.
+
+**Modern resolution (recommended) — no extra config needed:**
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+`"bundler"`, `"node16"`, and `"nodenext"` all understand the `exports` field natively.
+
+**Legacy resolution (`"node"`) — add `paths` aliases:**
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "paths": {
+      "@backendkit-labs/http-client/nestjs": [
+        "./node_modules/@backendkit-labs/http-client/dist/nestjs/index.d.ts"
+      ]
+    }
+  }
+}
+```
+
+**NestJS decorator support:**
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+And in your `main.ts`, before anything else:
+
+```typescript
+import 'reflect-metadata';
+```
+
+---
+
+## Quick Start
+
+```typescript
+import { HttpClient } from '@backendkit-labs/http-client';
+
+const client = new HttpClient({
+  baseURL: 'https://api.example.com',
+  timeout: 5_000,
+});
+
+// All methods return Result<HttpResponse<T>, HttpClientError>
+const result = await client.get<User[]>('/users');
+
+if (result.ok) {
+  console.log(result.value.data);   // User[]
+  console.log(result.value.status); // 200
+} else {
+  console.error(result.error.type);   // 'http' | 'network' | 'timeout' | 'cancelled' | 'circuit-open'
+  console.error(result.error.status); // 404, 500, etc. (for 'http' type)
+}
+```
+
+---
+
+## Configuration
+
+```typescript
+const client = new HttpClient({
+  baseURL:  'https://api.example.com',
+  timeout:  10_000,          // default: 10 000 ms
+  headers:  { 'X-API-Key': 'secret' },
+
+  // Retry with exponential backoff + jitter
+  retry: {
+    attempts:    3,           // retries after first failure
+    delayMs:     100,
+    maxDelayMs:  5_000,
+    jitter:      true,
+    shouldRetry: (err) => err.type === 'network' || err.type === 'timeout',
+  },
+
+  // Circuit breaker
+  circuitBreaker: {
+    failureThreshold:  50,    // % of calls that must fail to open the circuit
+    minimumCalls:      5,     // minimum calls before evaluating thresholds
+    slidingWindowSize: 10,
+    openTimeoutMs:     30_000,
+  },
+
+  // Pre-request middleware steps
+  steps: [authStep, correlationIdStep],
+});
+```
+
+---
+
+## HTTP Methods
+
+All methods accept an optional `RequestConfig`:
+
+```typescript
+interface RequestConfig {
+  headers?:       Record<string, string>;
+  params?:        Record<string, unknown>;   // query string parameters
+  timeout?:       number;                    // per-request override
+  cancelKey?:     string;                    // key to cancel this request
+  correlationId?: string;
+}
+```
+
+```typescript
+client.get<T>(url, config?)
+client.post<T>(url, data?, config?)
+client.put<T>(url, data?, config?)
+client.patch<T>(url, data?, config?)
+client.delete<T>(url, config?)
+```
+
+---
+
+## Error Types
+
+```typescript
+type HttpErrorType = 'http' | 'network' | 'timeout' | 'cancelled' | 'circuit-open';
+
+interface HttpClientError {
+  type:     HttpErrorType;
+  message:  string;
+  status?:  number;   // only for 'http'
+  data?:    unknown;  // response body, only for 'http'
+  cause?:   unknown;  // original axios error
+}
+```
+
+---
+
+## Request Cancellation
+
+Register a `cancelKey` on the request and cancel by key at any time:
+
+```typescript
+const promise = client.get('/long-poll', { cancelKey: 'my-poll' });
+
+// Cancel a specific request
+client.cancelRequest('my-poll');
+
+// Cancel all in-flight requests
+client.cancelAll();
+
+const result = await promise;
+if (!result.ok && result.error.type === 'cancelled') {
+  // handle cancellation
+}
+```
+
+---
+
+## Pipeline Middleware
+
+Pre-request middleware steps transform the `HttpCtx` before each request. Steps are powered by `@backendkit-labs/pipeline`.
+
+```typescript
+import type { PipelineStep, StepResult } from '@backendkit-labs/pipeline';
+import { Ok } from '@backendkit-labs/pipeline';
+import type { HttpCtx, HttpClientError } from '@backendkit-labs/http-client';
+
+const authStep: PipelineStep<HttpCtx, HttpClientError> = {
+  stepName: 'auth',
+  async handle(ctx): Promise<StepResult<HttpCtx, HttpClientError>> {
+    const token = await tokenStore.get();
+    return Ok({ ...ctx, headers: { ...ctx.headers, Authorization: `Bearer ${token}` } });
+  },
+};
+
+const client = new HttpClient({ steps: [authStep] });
+```
+
+A step can abort the request by returning `Err(...)`:
+
+```typescript
+import { Err } from '@backendkit-labs/pipeline';
+
+const rateLimitStep: PipelineStep<HttpCtx, HttpClientError> = {
+  stepName: 'rate-limit',
+  async handle(ctx): Promise<StepResult<HttpCtx, HttpClientError>> {
+    if (await rateLimiter.isExceeded()) {
+      return Err({ type: 'network', message: 'Rate limit exceeded' });
+    }
+    return Ok(ctx);
+  },
+};
+```
+
+---
+
+## Observability
+
+```typescript
+// Snapshot of lifetime counters
+client.getMetrics();
+// → { requests, success, failed, cancelled, circuitOpen, retried }
+
+// Circuit breaker state and counters
+client.getCircuitBreakerState();   // 'closed' | 'open' | 'half_open' | undefined
+client.getCircuitBreakerMetrics(); // detailed metrics or undefined
+```
+
+---
+
+## NestJS Integration
+
+### Module registration
+
+```typescript
+// Define typed injection tokens
+export const PRIMARY_API   = defineHttpClient('primary-api');
+export const PAYMENTS_API  = defineHttpClient('payments-api');
+```
+
+```typescript
+import { HttpClientModule } from '@backendkit-labs/http-client/nestjs';
+import { PRIMARY_API, PAYMENTS_API } from './tokens';
+
+@Module({
+  imports: [
+    HttpClientModule.forRoot({
+      clients: [
+        { token: PRIMARY_API,  config: { baseURL: 'https://api.example.com',     retry: { attempts: 3, delayMs: 100 } } },
+        { token: PAYMENTS_API, config: { baseURL: 'https://payments.example.com', circuitBreaker: { failureThreshold: 40, minimumCalls: 3 } } },
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### Injection
+
+```typescript
+import { InjectHttpClient } from '@backendkit-labs/http-client/nestjs';
+import { PRIMARY_API } from './tokens';
+
+@Injectable()
+export class UserService {
+  constructor(
+    @InjectHttpClient(PRIMARY_API) private readonly http: HttpClient,
+  ) {}
+
+  async getUsers(): Promise<User[]> {
+    const result = await this.http.get<User[]>('/users');
+    if (!result.ok) throw new Error(result.error.message);
+    return result.value.data;
+  }
+}
+```
+
+### Async module registration
+
+```typescript
+HttpClientModule.forRootAsync({
+  imports: [ConfigModule],
+  inject:  [ConfigService],
+  useFactory: (config: ConfigService) => ({
+    clients: [{
+      token:  PRIMARY_API,
+      config: { baseURL: config.get('API_URL'), timeout: config.get('API_TIMEOUT') },
+    }],
+  }),
+}),
+```
+
+---
+
+## Named Clients
+
+```typescript
+import { defineHttpClient, HttpClientToken } from '@backendkit-labs/http-client';
+
+export const GITHUB_API: HttpClientToken = defineHttpClient('github-api');
+
+// Provides the token's symbol as the NestJS DI token:
+// Inject with @InjectHttpClient(GITHUB_API)
+```
+
+---
+
+## License
+
+MIT

package/dist/chunk-5RHNUUOY.js

@@ -0,0 +1,245 @@
+import axios2 from 'axios';
+import { fail, ok } from '@backendkit-labs/result';
+import { CircuitBreaker, isHttpServerError, DEFAULT_CIRCUIT_BREAKER_CONFIG, CircuitBreakerOpenError } from '@backendkit-labs/circuit-breaker';
+import { Pipeline } from '@backendkit-labs/pipeline';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var CancelManager = class {
+  tokens = /* @__PURE__ */ new Map();
+  getOrCreate(key) {
+    const existing = this.tokens.get(key);
+    if (existing) return existing;
+    const source = axios2.CancelToken.source();
+    this.tokens.set(key, source);
+    return source;
+  }
+  cancel(key, reason) {
+    const source = this.tokens.get(key);
+    if (source) {
+      source.cancel(reason ?? `Request ${key} cancelled`);
+      this.tokens.delete(key);
+    }
+  }
+  cancelAll() {
+    for (const [key, source] of this.tokens) {
+      source.cancel(`Request ${key} cancelled`);
+    }
+    this.tokens.clear();
+  }
+  delete(key) {
+    this.tokens.delete(key);
+  }
+  has(key) {
+    return this.tokens.has(key);
+  }
+  get size() {
+    return this.tokens.size;
+  }
+};
+var DEFAULT_RETRY = {
+  attempts: 0,
+  delayMs: 100,
+  maxDelayMs: 5e3,
+  jitter: true,
+  shouldRetry: (e) => e.type === "network" || e.type === "timeout" || e.type === "http" && (e.status ?? 0) >= 500
+};
+var HttpClient = class {
+  axiosInstance;
+  cb;
+  pipeline;
+  retry;
+  cancelMgr = new CancelManager();
+  _metrics = {
+    requests: 0,
+    success: 0,
+    failed: 0,
+    cancelled: 0,
+    circuitOpen: 0,
+    retried: 0
+  };
+  constructor(config = {}) {
+    this.axiosInstance = axios2.create({
+      baseURL: config.baseURL,
+      timeout: config.timeout ?? 1e4,
+      headers: config.headers
+    });
+    if (config.circuitBreaker) {
+      const { name: cbName, ...cbRest } = config.circuitBreaker;
+      this.cb = new CircuitBreaker({
+        name: cbName ?? "http-client",
+        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,
+        isFailure: isHttpServerError,
+        ...cbRest
+      });
+    }
+    const p = new Pipeline();
+    for (const step of config.steps ?? []) p.pipe(step);
+    this.pipeline = p;
+    this.retry = config.retry ? { ...DEFAULT_RETRY, ...config.retry } : DEFAULT_RETRY;
+  }
+  // ── HTTP methods ──────────────────────────────────────────────────────────
+  get(url, config) {
+    return this.execute("GET", url, void 0, config);
+  }
+  post(url, data, config) {
+    return this.execute("POST", url, data, config);
+  }
+  put(url, data, config) {
+    return this.execute("PUT", url, data, config);
+  }
+  patch(url, data, config) {
+    return this.execute("PATCH", url, data, config);
+  }
+  delete(url, config) {
+    return this.execute("DELETE", url, void 0, config);
+  }
+  // ── Cancellation ──────────────────────────────────────────────────────────
+  cancelRequest(key) {
+    this.cancelMgr.cancel(key);
+    this._metrics.cancelled++;
+  }
+  cancelAll() {
+    const count = this.cancelMgr.size;
+    this.cancelMgr.cancelAll();
+    this._metrics.cancelled += count;
+  }
+  // ── Observability ─────────────────────────────────────────────────────────
+  getMetrics() {
+    return { ...this._metrics };
+  }
+  getCircuitBreakerState() {
+    return this.cb?.getState();
+  }
+  getCircuitBreakerMetrics() {
+    return this.cb?.getMetrics();
+  }
+  // ── Internal ──────────────────────────────────────────────────────────────
+  async execute(method, url, data, config = {}) {
+    this._metrics.requests++;
+    const initialCtx = {
+      url,
+      method,
+      data,
+      headers: config.headers ?? {},
+      params: config.params,
+      timeout: config.timeout,
+      cancelKey: config.cancelKey,
+      correlationId: config.correlationId
+    };
+    if (initialCtx.cancelKey) {
+      this.cancelMgr.getOrCreate(initialCtx.cancelKey);
+    }
+    const pipelineResult = await this.pipeline.run(initialCtx);
+    if (!pipelineResult.ok) {
+      this._metrics.failed++;
+      return fail(pipelineResult.error.cause);
+    }
+    const ctx = pipelineResult.value;
+    if (ctx.cancelKey && !this.cancelMgr.has(ctx.cancelKey)) {
+      this._metrics.failed++;
+      return fail({ type: "cancelled", message: `Request ${ctx.cancelKey} cancelled` });
+    }
+    const cancelToken = ctx.cancelKey ? this.cancelMgr.getOrCreate(ctx.cancelKey).token : void 0;
+    const rawCall = () => this.callAxios(ctx, cancelToken);
+    const cbCall = async () => {
+      if (!this.cb) return rawCall();
+      try {
+        return await this.cb.execute(rawCall);
+      } catch (e) {
+        if (e instanceof CircuitBreakerOpenError) {
+          this._metrics.circuitOpen++;
+          const err = { type: "circuit-open", message: e.message };
+          throw err;
+        }
+        throw e;
+      }
+    };
+    try {
+      const response = this.retry.attempts > 0 ? await this.withRetry(cbCall, this.retry) : await cbCall();
+      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);
+      this._metrics.success++;
+      return ok(response);
+    } catch (e) {
+      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);
+      const error = this.isHttpClientError(e) ? e : this.normalizeError(e);
+      if (error.type !== "circuit-open") this._metrics.failed++;
+      return fail(error);
+    }
+  }
+  async callAxios(ctx, cancelToken) {
+    const response = await this.axiosInstance.request({
+      url: ctx.url,
+      method: ctx.method,
+      data: ctx.data,
+      headers: ctx.headers,
+      params: ctx.params,
+      timeout: ctx.timeout,
+      cancelToken
+    });
+    return {
+      data: response.data,
+      status: response.status,
+      headers: response.headers
+    };
+  }
+  async withRetry(fn, config) {
+    let lastError;
+    for (let attempt = 0; attempt <= config.attempts; attempt++) {
+      try {
+        return await fn();
+      } catch (e) {
+        lastError = e;
+        if (attempt === config.attempts) break;
+        const error = this.isHttpClientError(e) ? e : this.normalizeError(e);
+        if (!config.shouldRetry(error, attempt)) break;
+        this._metrics.retried++;
+        const baseDelay = config.delayMs * Math.pow(2, attempt);
+        const jitter = config.jitter ? Math.random() * config.delayMs : 0;
+        const delay = Math.min(baseDelay + jitter, config.maxDelayMs);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+    throw lastError;
+  }
+  normalizeError(error) {
+    if (axios2.isCancel(error)) {
+      return {
+        type: "cancelled",
+        message: error.message ?? "Request cancelled"
+      };
+    }
+    if (axios2.isAxiosError(error)) {
+      const code = error.code;
+      if (code === "ECONNABORTED" || code === "ETIMEDOUT") {
+        return { type: "timeout", message: error.message, cause: error };
+      }
+      if (!error.response) {
+        return { type: "network", message: error.message, cause: error };
+      }
+      return {
+        type: "http",
+        message: error.message,
+        status: error.response.status,
+        data: error.response.data,
+        cause: error
+      };
+    }
+    return { type: "network", message: "Unexpected error", cause: error };
+  }
+  isHttpClientError(e) {
+    return typeof e === "object" && e !== null && "type" in e && "message" in e && typeof e.type === "string";
+  }
+};
+
+export { CancelManager, HttpClient, __decorateClass };
+//# sourceMappingURL=chunk-5RHNUUOY.js.map
+//# sourceMappingURL=chunk-5RHNUUOY.js.map

package/dist/chunk-5RHNUUOY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/cancel-manager.ts","../src/core/http-client.ts"],"names":["axios"],"mappings":"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","file":"chunk-5RHNUUOY.js","sourcesContent":["import axios from 'axios';\nimport type { CancelTokenSource } from 'axios';\n\nexport class CancelManager {\n  private readonly tokens = new Map<string, CancelTokenSource>();\n\n  getOrCreate(key: string): CancelTokenSource {\n    const existing = this.tokens.get(key);\n    if (existing) return existing;\n    const source = axios.CancelToken.source();\n    this.tokens.set(key, source);\n    return source;\n  }\n\n  cancel(key: string, reason?: string): void {\n    const source = this.tokens.get(key);\n    if (source) {\n      source.cancel(reason ?? `Request ${key} cancelled`);\n      this.tokens.delete(key);\n    }\n  }\n\n  cancelAll(): void {\n    for (const [key, source] of this.tokens) {\n      source.cancel(`Request ${key} cancelled`);\n    }\n    this.tokens.clear();\n  }\n\n  delete(key: string): void {\n    this.tokens.delete(key);\n  }\n\n  has(key: string): boolean {\n    return this.tokens.has(key);\n  }\n\n  get size(): number {\n    return this.tokens.size;\n  }\n}\n","import axios from 'axios';\nimport type { AxiosInstance, CancelToken } from 'axios';\nimport { ok, fail } from '@backendkit-labs/result';\nimport type { Result } from '@backendkit-labs/result';\nimport { CircuitBreaker, CircuitBreakerOpenError, DEFAULT_CIRCUIT_BREAKER_CONFIG, isHttpServerError } from '@backendkit-labs/circuit-breaker';\nimport type { CircuitBreakerConfig } from '@backendkit-labs/circuit-breaker';\nimport { Pipeline } from '@backendkit-labs/pipeline';\nimport { CancelManager } from './cancel-manager.js';\nimport type {\n  HttpClientConfig,\n  HttpClientError,\n  HttpCtx,\n  HttpMetrics,\n  HttpResponse,\n  RequestConfig,\n  RetryConfig,\n} from './types.js';\n\nconst DEFAULT_RETRY: Required<RetryConfig> = {\n  attempts:    0,\n  delayMs:     100,\n  maxDelayMs:  5_000,\n  jitter:      true,\n  shouldRetry: (e) =>\n    e.type === 'network' || e.type === 'timeout' || (e.type === 'http' && (e.status ?? 0) >= 500),\n};\n\nexport class HttpClient {\n  private readonly axiosInstance: AxiosInstance;\n  private readonly cb:            CircuitBreaker | undefined;\n  private readonly pipeline:      Pipeline<HttpCtx, HttpClientError>;\n  private readonly retry:         Required<RetryConfig>;\n  private readonly cancelMgr      = new CancelManager();\n  private readonly _metrics: HttpMetrics = {\n    requests: 0, success: 0, failed: 0, cancelled: 0, circuitOpen: 0, retried: 0,\n  };\n\n  constructor(config: HttpClientConfig = {}) {\n    this.axiosInstance = axios.create({\n      baseURL: config.baseURL,\n      timeout: config.timeout ?? 10_000,\n      headers: config.headers,\n    });\n\n    if (config.circuitBreaker) {\n      const { name: cbName, ...cbRest } = config.circuitBreaker;\n      this.cb = new CircuitBreaker({\n        name:      cbName ?? 'http-client',\n        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,\n        isFailure: isHttpServerError,\n        ...cbRest,\n      } as CircuitBreakerConfig);\n    }\n\n    const p = new Pipeline<HttpCtx, HttpClientError>();\n    for (const step of config.steps ?? []) p.pipe(step);\n    this.pipeline = p;\n\n    this.retry = config.retry\n      ? { ...DEFAULT_RETRY, ...config.retry }\n      : DEFAULT_RETRY;\n  }\n\n  // ── HTTP methods ──────────────────────────────────────────────────────────\n\n  get<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('GET', url, undefined, config);\n  }\n\n  post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('POST', url, data, config);\n  }\n\n  put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('PUT', url, data, config);\n  }\n\n  patch<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('PATCH', url, data, config);\n  }\n\n  delete<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('DELETE', url, undefined, config);\n  }\n\n  // ── Cancellation ──────────────────────────────────────────────────────────\n\n  cancelRequest(key: string): void {\n    this.cancelMgr.cancel(key);\n    this._metrics.cancelled++;\n  }\n\n  cancelAll(): void {\n    const count = this.cancelMgr.size;\n    this.cancelMgr.cancelAll();\n    this._metrics.cancelled += count;\n  }\n\n  // ── Observability ─────────────────────────────────────────────────────────\n\n  getMetrics(): Readonly<HttpMetrics> {\n    return { ...this._metrics };\n  }\n\n  getCircuitBreakerState() {\n    return this.cb?.getState();\n  }\n\n  getCircuitBreakerMetrics() {\n    return this.cb?.getMetrics();\n  }\n\n  // ── Internal ──────────────────────────────────────────────────────────────\n\n  private async execute<T>(\n    method:  string,\n    url:     string,\n    data:    unknown,\n    config:  RequestConfig = {},\n  ): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    this._metrics.requests++;\n\n    const initialCtx: HttpCtx = {\n      url,\n      method,\n      data,\n      headers:       config.headers ?? {},\n      params:        config.params,\n      timeout:       config.timeout,\n      cancelKey:     config.cancelKey,\n      correlationId: config.correlationId,\n    };\n\n    // Pre-register cancel token synchronously so callers can cancel before the request fires\n    if (initialCtx.cancelKey) {\n      this.cancelMgr.getOrCreate(initialCtx.cancelKey);\n    }\n\n    // Pre-request middleware pipeline\n    const pipelineResult = await this.pipeline.run(initialCtx);\n    if (!pipelineResult.ok) {\n      this._metrics.failed++;\n      return fail(pipelineResult.error.cause);\n    }\n\n    const ctx = pipelineResult.value;\n\n    // If the cancel key was cancelled during the pipeline, bail out immediately\n    if (ctx.cancelKey && !this.cancelMgr.has(ctx.cancelKey)) {\n      this._metrics.failed++;\n      return fail({ type: 'cancelled', message: `Request ${ctx.cancelKey} cancelled` });\n    }\n\n    const cancelToken = ctx.cancelKey\n      ? this.cancelMgr.getOrCreate(ctx.cancelKey).token\n      : undefined;\n\n    // Raw axios call — throws on any error\n    const rawCall = () => this.callAxios<T>(ctx, cancelToken);\n\n    // Circuit breaker wraps the raw call — throws CircuitBreakerOpenError when open\n    const cbCall = async (): Promise<HttpResponse<T>> => {\n      if (!this.cb) return rawCall();\n      try {\n        return await this.cb.execute(rawCall);\n      } catch (e) {\n        if (e instanceof CircuitBreakerOpenError) {\n          this._metrics.circuitOpen++;\n          const err: HttpClientError = { type: 'circuit-open', message: e.message };\n          throw err;\n        }\n        throw e;\n      }\n    };\n\n    try {\n      const response = this.retry.attempts > 0\n        ? await this.withRetry(cbCall, this.retry)\n        : await cbCall();\n\n      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);\n      this._metrics.success++;\n      return ok(response);\n    } catch (e) {\n      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);\n      const error = this.isHttpClientError(e) ? e : this.normalizeError(e);\n      if (error.type !== 'circuit-open') this._metrics.failed++;\n      return fail(error);\n    }\n  }\n\n  private async callAxios<T>(ctx: HttpCtx, cancelToken?: CancelToken): Promise<HttpResponse<T>> {\n    const response = await this.axiosInstance.request<T>({\n      url:         ctx.url,\n      method:      ctx.method,\n      data:        ctx.data,\n      headers:     ctx.headers,\n      params:      ctx.params,\n      timeout:     ctx.timeout,\n      cancelToken,\n    });\n\n    return {\n      data:    response.data,\n      status:  response.status,\n      headers: response.headers as Record<string, string>,\n    };\n  }\n\n  private async withRetry<T>(\n    fn:     () => Promise<T>,\n    config: Required<RetryConfig>,\n  ): Promise<T> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= config.attempts; attempt++) {\n      try {\n        return await fn();\n      } catch (e) {\n        lastError = e;\n\n        if (attempt === config.attempts) break;\n\n        const error = this.isHttpClientError(e) ? e : this.normalizeError(e);\n        if (!config.shouldRetry(error, attempt)) break;\n\n        this._metrics.retried++;\n\n        const baseDelay = config.delayMs * Math.pow(2, attempt);\n        const jitter    = config.jitter ? Math.random() * config.delayMs : 0;\n        const delay     = Math.min(baseDelay + jitter, config.maxDelayMs);\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n      }\n    }\n\n    throw lastError;\n  }\n\n  private normalizeError(error: unknown): HttpClientError {\n    if (axios.isCancel(error)) {\n      return {\n        type:    'cancelled',\n        message: (error as { message?: string }).message ?? 'Request cancelled',\n      };\n    }\n\n    if (axios.isAxiosError(error)) {\n      const code = error.code;\n      if (code === 'ECONNABORTED' || code === 'ETIMEDOUT') {\n        return { type: 'timeout', message: error.message, cause: error };\n      }\n      if (!error.response) {\n        return { type: 'network', message: error.message, cause: error };\n      }\n      return {\n        type:    'http',\n        message: error.message,\n        status:  error.response.status,\n        data:    error.response.data,\n        cause:   error,\n      };\n    }\n\n    return { type: 'network', message: 'Unexpected error', cause: error };\n  }\n\n  private isHttpClientError(e: unknown): e is HttpClientError {\n    return (\n      typeof e === 'object' &&\n      e !== null &&\n      'type' in e &&\n      'message' in e &&\n      typeof (e as HttpClientError).type === 'string'\n    );\n  }\n}\n"]}