Files SDK

¿Qué es Files SDK?

Files SDK es un SDK de almacenamiento unificado que proporciona una API única y consistente para interactuar con backends de almacenamiento de objetos y blobs. En lugar de aprender un SDK diferente para cada proveedor de la nube, obtienes una interfaz pequeña y honesta que funciona con S3, Cloudflare R2, Google Cloud Storage, Azure Blob y más de 30 proveedores. Utiliza E/S basada en estándares web, aceptando File, Blob, ReadableStream, ArrayBuffer y string, y funciona en cualquier lugar donde funcione fetch, incluyendo Node, Bun, Workers y Vercel.

Para quién es

• Desarrolladores full-stack que necesitan cambiar de proveedor de almacenamiento sin reescribir cada llamada de carga y descarga en su aplicación.
• Ingenieros de plataforma que construyen sistemas multiinquilino o multirregión que deben abstraer las peculiaridades específicas de cada proveedor detrás de una única clase.
• Indie hackers y equipos de startups que quieren comenzar con un adaptador simple de sistema de archivos y luego migrar a S3 o R2 sin cambiar el código de su aplicación.

Características clave

Una API pequeña para todos los proveedores

Cargar, descargar, listar, eliminar, head, exists, copiar y generar URL: los mismos diez métodos funcionan de manera idéntica ya sea que uses S3, GCS, Azure o un sistema de archivos local. Cambia tu adaptador y tus llamadas seguirán siendo las mismas.

E/S basada en estándares web

El SDK acepta tipos web nativos como File, Blob y ReadableStream, y también los devuelve. Sin envoltorios de stream propietarios ni conversiones de buffer. Funciona en cualquier runtime que admita la API fetch: Node, Bun, Cloudflare Workers, Vercel Edge y más.

Vía de escape mediante files.raw

Cuando necesitas funciones específicas del proveedor como versionado, políticas de ciclo de vida, ACL o cargas multiparte, el cliente nativo siempre está a una propiedad de distancia. files.raw está tipado por adaptador, por lo que obtienes autocompletado completo para el SDK subyacente sin salir de tu código.

Errores predecibles

Cada error del proveedor se normaliza en un único FilesError con una propiedad code consistente. El error original se adjunta como cause, para que puedas manejar los fallos de manera uniforme mientras depuras con todo el contexto.

Lo que destaca

"Una API pequeña para todos los proveedores. Cambia tu proveedor de almacenamiento sin reescribir llamadas."

Esa es la promesa principal, y Files SDK la cumple sin concesiones. Mientras que otras capas de abstracción filtran detalles específicos del proveedor o te obligan a usar una API de mínimo común denominador, Files SDK te ofrece una superficie limpia de diez métodos que cubre el 95% de los casos de uso, y luego te entrega el cliente nativo para el 5% restante. La matriz de compatibilidad muestra exactamente qué métodos funcionan con cada proveedor, con advertencias claras donde el comportamiento difiere.

Vale la pena echarle un vistazo si…

Estás cansado de mantener código de adaptador para cada proveedor de almacenamiento que toca tu aplicación, o planeas migrar de un backend a otro y quieres evitar una reescritura dolorosa. Files SDK también es una opción sólida si estás construyendo una biblioteca o framework que necesita aceptar almacenamiento proporcionado por el usuario sin dictar el proveedor.