[해피CGI][cgimall] Files SDK - 다양한 클라우드 스토리지를 하나의 API로 연결하는 오픈소스 파일 SDK

Files SDK는 여러 종류의 오브젝트 스토리지와 파일 저장 서비스를
하나의 통일된 인터페이스로 사용할 수 있도록 해주는 오픈소스 SDK입니다.
https://files-sdk.dev/

Amazon S3, Cloudflare R2, Google Cloud Storage, Azure Blob Storage, MinIO, Vercel Blob, Supabase, Google Drive, OneDrive, Dropbox, Box 등을 포함해 40개 이상의 스토리지 어댑터를 지원합니다.
저장소를 변경하더라도 애플리케이션의 파일 처리 코드를 대부분 그대로 유지할 수 있는 것이 특징입니다.
 

 

파일 업로드, 다운로드, 목록 조회, 존재 여부 확인, 복사, 이동, 삭제 등의 기본 기능을 동일한 API로 사용할 수 있으며
대용량 파일을 위한 Multipart Upload, 업로드 진행률 확인, Byte-range 다운로드, 파일 검색 등의 기능도 제공합니다.

 

또한 서로 다른 스토리지 간 파일을 동기화하거나 백업할 수 있는 sync() 기능을 제공해
S3에서 R2로 이전하거나 운영 스토리지와 백업 스토리지를 동기화하는 용도로도 활용할 수 있습니다.

 

AI 개발을 위한 기능도 제공됩니다.
Vercel AI SDK, OpenAI Agents, Claude, MCP에서 사용할 수 있는 파일 관련 도구를 생성할 수 있어
AI 에이전트가 파일 목록 조회, 다운로드, 업로드, 삭제 등의 작업을 수행하도록 구성할 수 있습니다.
삭제와 같은 작업에 사용자 승인 절차를 적용하는 기능도 지원합니다.

 

Node.js 기반 프로젝트에서 NPM으로 간단하게 설치할 수 있으며
MIT 라이선스로 공개되어 있어 상용 프로젝트에서도 활용하기 용이합니다.