Files SDK - une API unique pour tous les stockages blob

• "Write Once, Store Anywhere"
• Gère 29 types de stockages objet/blob, dont S3, R2, GCS et Azure, avec un SDK unifié
• Place plus de 40 adaptateurs derrière une interface unique, ce qui permet de ne remplacer que l’adaptateur tout en conservant intacts tous les points d’appel
• upload, download, head, exists, copy, move, list, delete sont gérés avec les mêmes appels sur tous les adaptateurs
  • Fournit une escape hatch pour sortir vers le client natif quand c’est nécessaire
• En passant un tableau, le traitement par lots se fait avec une concurrence limitée, et les listings sont parcourus via un async iterable
• Outils de fichiers pour agents IA : fournit des capacités à Vercel AI SDK, OpenAI Agents, Claude et MCP
• Fournit aussi une CLI permettant d’utiliser toutes les méthodes comme commandes
• Prend en charge le multipart parallèle pour envoyer de gros body ou des flux illimités découpés en plusieurs parties
• Un seul callback permet d’afficher en temps réel la progression de l’upload au niveau des octets
• La lecture par plage est mappée sur HTTP 206, ce qui permet le seek vidéo, la reprise de téléchargement et la lecture des en-têtes de fichiers
• Les hooks de cycle de vie onAction·onRetry·onError peuvent être branchés une seule fois dans le constructeur, puis s’appliquent à toutes les opérations de tous les adaptateurs
• Avec sync(), il est possible de mettre un backend en miroir vers un autre, de n’envoyer que les éléments modifiés, d’ignorer ceux qui sont identiques et de nettoyer ceux qui ont disparu, avec prise en charge du dry-run
• Les SDK natifs de chaque adaptateur sont des peer dependencies optionnelles, donc seuls ceux réellement utilisés sont installés
• Repo - haydenbleasel/files-sdk
• Licence MIT

[sftblw]

Il existe un projet similaire : Apache OpenDAL.

[goathead]

Merci pour cette bonne information.

[linusjeh]

C’est bien.