Files SDK
Files SDK — это унифицированный SDK для хранения данных, который устраняет сложность работы с несколькими провайдерами объектного хранилища. С помощью одного небольшого и честного API вы можете бесшовно интегрировать S3, Cloudflare R2, Google Cloud Storage, Azure Blob и более 25 других бэкендов без переписывания кода при смене провайдера.
Ключевые особенности продукта
- Один API для 25+ провайдеров: Переключайтесь между S3, R2, GCS, Azure, Vercel Blob и другими без изменения кода
- I/O на веб-стандартах: Нативная поддержка File, Blob, ReadableStream, ArrayBuffer и строк—работает на Node.js, Bun, Workers и Vercel
- Люк для выхода через files.raw: Мгновенный доступ к нативному клиенту для специфических функций провайдера: версионирование, ACL, многокомпонентная загрузка
- Предсказуемая обработка ошибок: Единый FilesError с нормализованными кодами для всех провайдеров, исходная ошибка сохранена как cause
- Нулевая нагрузка на конфигурацию: Фиксированный адаптер при создании делает точки вызова плоскими и предсказуемыми
Сценарии использования
- Мультиоблачная стратегия: Создавайте приложения, избегающие привязки к вендору, абстрагируя операции хранения
- Приложения на периферии: Используйте I/O на веб-стандартах для бесшовной работы в serverless и edge-средах
- Миграция хранилищ: Переходите между провайдерами или внедряйте стратегии отказоустойчивости без переписывания кодовой базы
- Инструменты для разработчиков: Создавайте внутренние платформы, стандартизирующие файловые операции в разнообразной инфраструктуре
Целевая аудитория
Files SDK создан для бэкенд-инженеров, платформенных команд и разработчиков, создающих мультитенантные или мультиоблачные приложения, которым нужна надёжная и переносимая абстракция хранения без потери доступа к нативным функциям.