Files SDK

Qu'est-ce que Files SDK ?

Files SDK est un SDK de stockage unifié qui fournit une API unique et cohérente pour interagir avec les backends de stockage d'objets et de blobs. Au lieu d'apprendre un SDK différent pour chaque fournisseur cloud, vous obtenez une interface simple et honnête qui fonctionne avec S3, Cloudflare R2, Google Cloud Storage, Azure Blob et plus de 30 autres fournisseurs. Il utilise les E/S basées sur les standards du web — acceptant File, Blob, ReadableStream, ArrayBuffer et string — et fonctionne partout où fetch fonctionne, y compris Node, Bun, Workers et Vercel.

À qui s'adresse-t-il ?

• Les développeurs full-stack qui ont besoin de changer de fournisseur de stockage sans réécrire chaque appel de téléchargement et de téléchargement dans leur application.
• Les ingénieurs de plateforme qui construisent des systèmes multi-locataires ou multi-régions devant abstraire les particularités propres à chaque fournisseur derrière une seule classe.
• Les indépendants et les équipes de startup qui souhaitent commencer avec un adaptateur de système de fichiers simple et migrer plus tard vers S3 ou R2 sans modifier leur code applicatif.

Fonctionnalités clés

Une seule petite API pour tous les fournisseurs

Télécharger, télécharger, lister, supprimer, head, existe, copier et générer des URL — les mêmes dix méthodes fonctionnent de manière identique, que vous utilisiez S3, GCS, Azure ou un système de fichiers local. Changez votre adaptateur, et vos appels restent les mêmes.

E/S basées sur les standards du web

Le SDK accepte les types web natifs comme File, Blob et ReadableStream, et les renvoie également. Pas de wrappers de flux propriétaires ni de conversions de tampons. Il fonctionne sur tout environnement d'exécution prenant en charge l'API fetch — Node, Bun, Cloudflare Workers, Vercel Edge, et plus encore.

Échappatoire via files.raw

Lorsque vous avez besoin de fonctionnalités spécifiques au fournisseur comme le versioning, les politiques de cycle de vie, les ACL ou les téléchargements multipart, le client natif est toujours à une propriété de distance. files.raw est typé par adaptateur, vous bénéficiez donc d'une auto-complétion complète pour le SDK sous-jacent sans quitter votre code.

Erreurs prévisibles

Chaque erreur de fournisseur est normalisée en une seule FilesError avec une propriété code cohérente. L'erreur d'origine est attachée en tant que cause, vous pouvez donc gérer les échecs de manière uniforme tout en conservant le contexte complet pour le débogage.

Ce qui se démarque

"Une seule petite API pour tous les fournisseurs. Changez votre fournisseur de stockage sans réécrire les appels."

C'est la promesse centrale, et Files SDK la tient sans compromis. Alors que d'autres couches d'abstraction divulguent des détails spécifiques au fournisseur ou vous forcent à utiliser une API au plus petit dénominateur commun, Files SDK vous offre une surface propre de dix méthodes qui couvre 95 % des cas d'utilisation — puis vous donne accès au client natif pour les 5 % restants. La matrice de compatibilité montre exactement quelles méthodes fonctionnent avec quel fournisseur, avec des mises en garde claires lorsque le comportement diffère.

À considérer si…

Vous en avez assez de maintenir du code d'adaptateur pour chaque fournisseur de stockage que votre application utilise, ou vous prévoyez de migrer d'un backend à un autre et souhaitez éviter une réécriture fastidieuse. Files SDK est également un bon choix si vous construisez une bibliothèque ou un framework qui doit accepter un stockage fourni par l'utilisateur sans imposer de fournisseur.