Convex + Transloadit: uploads y procesamiento
Acabamos de publicar @transloadit/convex en npm, una nueva integración de Convex
para Transloadit que ofrece una experiencia nativa para uploads, procesamiento de archivos y webhooks. Incluye una
app de demo lista para ejecutar (galería de bodas), documentación sobre cómo combinarla con el uploader de archivos
Uppy, y helpers simples del lado del servidor para mantener los secretos fuera del cliente
y evitar la manipulación de solicitudes.
Qué obtienes
- Una configuración limpia de Uppy +
@uppy/transloaditpara uploads desde el navegador, enviados a Transloadit, con instrucciones opcionales de encoding. - Un módulo de Convex que puede aceptar, firmar, verificar payloads y guardar referencias a los resultados.
- Una galería de demo escrita en Next.js que muestra este flujo de principio a fin.
- Una testsuite de Playwright que asegura que todo siga funcionando.
En resumen, obtienes subida de archivos rápida y resumable (de hasta 200 GB), encoding de video, reconocimiento con IA y una interfaz de usuario que se actualiza en tiempo real.
Demo en vivo
¡Prueba la app de demo!
El código fuente y la documentación se pueden encontrar aquí.
Cómo funciona
- El usuario arrastra archivos a Uppy.
- Uppy crea un Assembly y envía archivos e Instructions a Transloadit; Convex firma esta solicitud con un secreto que tiene en el back-end para evitar manipulaciones.
- El usuario termina la subida y puede navegar a otra página.
- Transloadit procesa los archivos, almacena los resultados en CloudFlare R2 según las Instructions, y llama al webhook de Convex cuando los resultados están listos.
- Convex almacena referencias en su base de datos, y la galería se actualiza en tiempo real.
Inicio rápido
Instala el componente de Convex junto con nuestro uploader para navegadores web: Uppy.:
npm i @transloadit/convex @uppy/core @uppy/transloadit
Luego sigue el README para conectar las acciones de Convex, el webhook y la configuración de Uppy.
Si quieres una app de referencia ejecutable, clona el repo y ejecuta la demo localmente.
¿Por qué este enfoque?
Convex es excelente para datos en tiempo real y acciones seguras. Transloadit se encarga del trabajo pesado, como transcoding, operaciones de imagen y storage.
Al combinarlos, puedes:
- mantener secretos en las acciones de Convex,
- firmar solicitudes de forma segura,
- escalar uploads con la velocidad y confiabilidad impulsadas por tus,
- manejar webhooks sin servidores personalizados,
- guardar los resultados en tu base de datos de Convex y notificar a los consumidores, y
- ¡lanzar rápido!
¿Qué sigue?
La integración de Convex para Transloadit todavía no se encuentra en estado 1.0. Es posible que refinemos la superficie de la API y sigamos puliendo la DX, pero la integración ya está lista para apps reales hoy. Transloadit y Uppy son componentes confiables con una trayectoria comprobada y respaldados por grandes comunidades. Si estás construyendo sobre Convex y necesitas procesamiento, pruébala y cuéntanos qué te gustaría ver a continuación.