Referencia
Exports por subpath y los mensajes de error por niveles que uploaderkit muestra a desarrolladores frente a usuarios.
Feedback para el desarrollador
Dos niveles, para que una config rota aparezca donde todavía se puede arreglar:
ScopeError— lanzado, de inmediato. Configs que nunca pueden funcionar: un scope malformado, un nombre de scope inexistente, ids de slot duplicados, un scope privado sobre un provider que no firma, un scope cifrado sinCryptoHooks. Fallan al importar o al arrancar, nunca frente a un usuario. Los adaptadores de framework lo relanzan en vez de serializarlo al cliente.- Avisos de desarrollo — una vez por caso. Configs que corren pero
probablemente no son lo que querías: llamar
upload()sin estrategia, soltar varios archivos en modo single, un slot que acepta extensiones que su scope rechaza. Van con el prefijo[uploaderkit], callan en producción, y nunca condicionan el comportamiento.
Las fallas a nivel petición son una tercera familia aparte:
StorageRequestError carga un status HTTP y un mensaje en español seguro de
mostrar, que los adaptadores de framework convierten a JSON.
Subpath exports
| Ruta de importación | Contenido |
|---|---|
uploaderkit | defineScopes, validateForScope, resolveKey, toAcceptAttribute, formatFileSize, KB/MB/GB, ScopeError, DEFAULT_LABELS/ES_LABELS, tipos |
uploaderkit/react | useUploader, useSlottedUploader, createXhrUploadStrategy, compressImage, matchers de slot, tipos |
uploaderkit/ui | Uploader, SlottedUploader, Dropzone, FileItem, FileViewer, ConfirmDialog, cn |
uploaderkit/server | createStorage, createAesGcmCrypto, StorageRequestError, tipos |
uploaderkit/server/express | createExpressStorageHandlers — handlers estructurales para una app de Express que es dueña de multer |
uploaderkit/server/next | createNextStorageHandlers — handlers de App Router sobre la Fetch API |
uploaderkit/adapters/gcs | createGcsProvider — Google Cloud Storage de dos buckets (peer opcional) |
uploaderkit/adapters/s3 | createS3Provider — AWS, R2, B2, MinIO, Wasabi (peers opcionales) |
uploaderkit/adapters/memory | createMemoryProvider — pruebas y desarrollo local |
uploaderkit/tailwind.css | Registro de fuente Tailwind v4 para las clases de /ui |
Licencia
MIT © Ricardo Tapia