@oxth/nestjs-storageUnified Storage for NestJS

One API. Five storage drivers, plus any S3-compatible service. Optional SDKs stay optional.

5 Storage Drivers

Local filesystem, S3, Cloudflare R2, Google Cloud Storage, and Azure Blob Storage — plus any S3-compatible service (MinIO, B2, DigitalOcean Spaces, Wasabi) via a custom endpoint. Switch by changing config, not code.

Explore drivers

Optional, Lazily-Loaded SDKs

The S3/GCS/Azure driver modules are only dynamically imported when a disk of that type is actually configured. A local-only app never installs or loads @aws-sdk, @google-cloud/storage, or @azure/storage-blob.

Installation guide

Type-Safe & Fully Tested

Strict TypeScript throughout, and 100% statement/branch/function/line coverage enforced in CI — every driver, interceptor, and edge case has a test behind it.

NestJS Native

StorageModule.forRoot/forRootAsync, an @Global() StorageService for DI anywhere, four Multer-based upload interceptors, and a Guard/Middleware pair for signed local URLs.

Configuration guide

AI-Ready Documentation

Ships with llm.md and llm-full.md — condensed and exhaustive reference files purpose-built for feeding into Claude, Cursor, and other AI coding assistants.

View llm.md

Signed URLs & Testing Built In

HMAC-signed, expiring URLs for the local disk via a Guard or Middleware, and a real-filesystem-backed fake disk (assertExists/assertMissing/clear) so tests never touch production storage.

Testing guide