Descarga Masiva de Archivos

Descripción

Funcionalidad que permite a los usuarios descargar múltiples documentos PDF de forma rápida. Esta herramienta ofrece dos opciones de descarga:

1. PDF Unificado: Todos los archivos PDF seleccionados en EURUS se combinan en un único documento PDF.
2. Archivo ZIP: Los archivos PDF seleccionados se descargan individualmente dentro de un archivo ZIP comprimido.

Objetivo

Facilitar a los usuarios la obtención de varios documentos PDF, agilizando el proceso de descarga para los fines necesarios.

Repositorio

• Nombre del Repositorio: ‘euruspro-fn-pdf-fusion’
• URL: https://github.com/euruspro/euruspro-fn-pdf-fusion

Componentes Principales

1. HTTP Endpoint: Recibe solicitudes de fusión de archivos
   • Validaciones de data request
   • Creación de directorio tmp en caso de no existir
   • Validación de URLs de cada PDF. Debe ser una URL válida con protocolo HTTPS y extensión .pdf
   • Fusión o compresión de archivos con la función ‘pdfMerger’
   • Envío de notificación al usuario que realizó la petición de descarga con el PDF o ZIP descargable.



---



2. Función ‘pdfMerger’: Función principal que gestiona la descarga, fusión y compresión de archivos PDF según lo especificado en la solicitud (PDF/ZIP).
   • Descarga los PDF individualmente con la función ‘downloadPDF’
   • Si el tipo de archivo solicitado es PDF, los archivos se fusionan con la función ‘mergePDF’
   • Si el tipo de archivo solicitado es un ZIP, los archivos se comprimen con la función ‘createZip’
   • Finalmente, los archivos generados se suben a Cloud Storage.



---



3. Función ‘downloadPDF’: Descarga archivos PDF individualmente, dividiendo la descarga en fragmentos o tandas de 1MB para manejar archivos grandes.
   • Limita el tamaño del archivo a 50MB como máximo.



---



4. Función ‘mergePDF’: Fusiona varios archivos PDF en un único documento PDF.
   • Copia las páginas de cada PDF en un nuevo documento PDF, donde estarán todos los PDF unificados.
   • Guarda el PDF final como un Uint8Array



---



5. Función ‘createZip’: Comprime múltiples archivos PDF en un archivo ZIP.
   • Crea un stream de escritura hacia el archivo ZIP de salida.
   • Añade cada archivo PDF al archivo ZIP final.
   • Finaliza y cierra el archivo ZIP.

Librerías Utilizadas

• fs: Para operaciones de sistema de archivos, como crear directorios, leer y escribir archivos.
• pdf-lib: Para manipulación de archivos PDF, como fusionar múltiples PDFs en uno solo.
• axios: Para realizar peticiones HTTP y descargar archivos PDF desde URLs.
• archiver: Para crear y comprimir archivos ZIP.
• stream: Utilizado en la creación de streams para manejar la escritura en archivos ZIP.