files-sdk

Files SDK is a TypeScript library that gives you one API across S3, R2, GCS, Azure Blob, Vercel Blob, Dropbox, and the local filesystem. The methods are predictable: upload, download, head, delete, copy, list, url, signedUploadUrl. MIT licensed, web-standards-friendly (Blob, File, ReadableStream, Uint8Array, ArrayBuffer, string).

`npm install files-sdk` plus the adapter you want, like `files-sdk/s3` or `files-sdk/r2`. Each adapter is tree-shakeable so you only ship what you use. There is an escape hatch (`files.raw`) when you need provider-specific behavior. Bundled tool wrappers exist for the Vercel AI SDK, OpenAI Responses, OpenAI Agents, and the Anthropic Claude Agent SDK, which makes it useful for letting agents upload and fetch files.

Solo developers and small teams building products that might switch storage providers should use this. It is the kind of abstraction you wish you had wired in before you shipped six S3-specific code paths across your codebase.

The catch is the project is young and small. Version 1.2 shipped in May 2026, with one primary maintainer (Hayden Bleasel). For internal projects and side work, that is fine. For mission-critical infrastructure where you cannot risk a stalled dependency, vendor it or wait until the project has more contributors.