@nestjs/axios

@nestjs/axios is the official NestJS integration module for the Axios HTTP client. It wraps Axios inside NestJS’s dependency-injection system, exposing an injectable HttpService whose request methods (get, post, put, patch, delete, and their *Form variants) return RxJS Observables instead of Promises, matching the reactive style used throughout the Nest ecosystem.

The module supports both static (HttpModule.register()) and async (HttpModule.registerAsync()) configuration, so Axios instance options like base URL, headers, and timeouts can be sourced from NestJS’s ConfigService or other providers at bootstrap time. It also exposes the raw underlying Axios instance via axiosRef for cases needing direct Axios API access outside the Observable wrapper.

What You Get

• An injectable HttpService with Axios-equivalent methods that return RxJS Observable<AxiosResponse>
• HttpModule.register() and HttpModule.registerAsync() for static or dependency-driven Axios configuration
• Automatic request cancellation tied to Observable unsubscription via Axios cancel tokens
• Direct access to the underlying Axios instance through HttpService.axiosRef when the Observable wrapper isn’t needed
• A global module option to register HttpModule once and inject HttpService anywhere without repeated imports

Common Use Cases

• Calling third-party REST APIs from a NestJS service using the framework’s standard DI patterns instead of importing Axios directly
• Centralizing HTTP client configuration (base URL, auth headers, timeouts) via registerAsync sourced from ConfigService
• Composing outbound HTTP calls with RxJS operators (retry, timeout, catchError) alongside other reactive streams in a Nest app
• Building typed API client services that other NestJS providers inject and call

Under The Hood

Architecture The module is a small DI wrapper: HttpModule (in lib/http.module.ts) registers an AXIOS_INSTANCE_TOKEN provider backed by a plain Axios.create(config) instance, and HttpService (in lib/http.service.ts) injects that instance and exposes Axios’s request methods, each wrapped through a makeObservable helper that turns the underlying Axios Promise into an RxJS Observable with automatic CancelToken-based cancellation on unsubscribe.

Tech Stack TypeScript module built against @nestjs/common/@nestjs/core as peer dependencies, with axios and rxjs as required peers rather than bundled dependencies, keeping version resolution in the consuming app’s control. Tooling is oxlint for linting, release-it for releases, and Vitest configured (via vitest.config.mts) to run specs from a tests/ directory.

Code Quality The cloned repository does not contain a tracked tests/ directory despite package.json’s test:e2e script and vitest.config.mts pointing at one, so no test coverage is visible in the current default branch snapshot. The source itself is compact (two files under 150 lines total), consistently typed, and follows NestJS’s established module/service/token conventions used across all official @nestjs/* packages.

API Design The API deliberately mirrors Axios’s own method names and signatures (get, post, put, etc.) so anyone familiar with Axios can use HttpService with no new API to learn, while axiosRef provides an escape hatch to the raw Axios instance for anything the Observable wrapper doesn’t cover. Static vs. async module registration follows the exact same pattern used by every other official NestJS module (e.g. @nestjs/config, @nestjs/typeorm), so the learning curve is close to zero for existing Nest developers.