utn-cli 2.0.87 → 2.0.89

package/templates/backend/servicios/Nucleo/ReportePDF.js

@@ -0,0 +1,797 @@
+const path = require("path");
+const PDFDocument = require('pdfkit');
+const crypto = require('crypto');
+const { ejecutarConsultaSIGU } = require('./db.js');
+const Miscelaneas = require('./Miscelaneas.js');
+
+class ReportePDF {
+  constructor() {
+    this.config = {
+      margin: 50,
+      colorPrimario: "#1F2A63",
+      colorSecundario: "#666666",
+      colorFondoAlterno: "#F9F9F9",
+      colorLinea: "#DDD",
+      fuenteBase: "Helvetica",
+      fuenteNegrita: "Helvetica-Bold",
+      fuenteCursiva: "Helvetica-Oblique",
+      fuenteNegritaCursiva: "Helvetica-BoldOblique",
+      fontSizeTitulo: 14,
+      fontSizeSubtitulo: 10,
+      fontSizeCuerpo: 9,
+      fontSizePequeño: 8,
+      fontSizeMuyPequeño: 7
+    };
+  }
+
+  // const datosUsuario = await Miscelaneo.obtenerDatosDelUsuario(solicitud.headers.authorization);
+  // const Fecha = solicitud.params.Fecha || solicitud.query.Fecha;
+  // const titulos = {
+  //   Principal: "Histórico de asignación de periodos",
+  //   Subtitulo1: `Fecha de proceso: ${Fecha}`,
+  //   Subtitulo2: "Reporte generado por el Área de Administración de Servicios",
+  //   Direccion: "Dirección de Gestión de Desarrollo Humano",
+  //   Area: "Área de Administración de Servicios AAS",
+  //   Usuario: datosUsuario?.Identificacion || "Sistema",
+  //   pieDePagina: "Copia digital del documento original.\nPara fines informáticos únicamente.",
+  //   Acceso: "Privado",
+  //   Uso: "Interno"
+  // };
+  // const metadatos = [
+  //   { llave: 'Identificacion', titulo: 'Cédula', ancho: 80 },
+  //   { llave: 'Nombre', titulo: 'Nombre Completo', ancho: 180 },
+  //   { llave: 'Periodo', titulo: 'Período', ancho: 70 },
+  //   { llave: 'Estamento', titulo: 'Estamento', ancho: 80 },
+  //   { llave: 'DiasOtorgados', titulo: 'Días', ancho: 40 },
+  //   { llave: 'Salario', titulo: 'Salario', ancho: 45 }
+  // ];
+  // const doc = ReportePDF.generarEncabezado(titulos, respuesta);
+  // const parrafo = 'Para más información, visite el <a href="https://www.utn.ac.cr">sitio web de la UTN</a>.';
+  // ReportePDF.generarParrafoHTML(doc, parrafo);
+  // ReportePDF.generarTituloDePagina(doc, titulos.Principal, titulos.Subtitulo1, titulos.Subtitulo2);
+  // ReportePDF.generarTabla(doc, datos, metadatos);
+  // let firmas = [
+  //   {
+  //     Nombre: "DAVID VILLALOBOS CAMBRONERO",
+  //     Identificacion: "111050570",
+  //     Instancia: "Dirección de TI",
+  //     Fecha: "17-04-2026 14:30",
+  //     Motivo: "Aprobación de vacaciones"
+  //   },
+  //   {
+  //     Nombre: "JUAN PEREZ",
+  //     Identificacion: "123456789",
+  //     Instancia: "Recursos Humanos",
+  //     Fecha: "17-04-2026 14:35",
+  //     Motivo: "Validación de saldos"
+  //   },
+  //   {
+  //     Nombre: "JUAN PEREZ",
+  //     Identificacion: "123456789",
+  //     Instancia: "Recursos Humanos",
+  //     Fecha: "17-04-2026 14:35",
+  //     Motivo: "Revisión técnica"
+  //   },
+  //   {
+  //     Nombre: "JUAN PEREZ",
+  //     Identificacion: "123456789",
+  //     Instancia: "Recursos Humanos",
+  //     Fecha: "17-04-2026 14:35",
+  //     Motivo: "Revisión técnica"
+  //   },
+  //   {
+  //     Nombre: "JUAN PEREZ",
+  //     Identificacion: "123456789",
+  //     Instancia: "Recursos Humanos",
+  //     Fecha: "17-04-2026 14:35",
+  //     Motivo: "Revisión técnica"
+  //   },
+  //   {
+  //     Nombre: "JUAN PEREZ",
+  //     Identificacion: "123456789",
+  //     Instancia: "Recursos Humanos",
+  //     Fecha: "17-04-2026 14:35",
+  //     Motivo: "Revisión técnica"
+  //   }
+  // ];
+  // ReportePDF.generarFirmas(doc, firmas);
+  // firmas = [
+  //   {
+  //     Nombre: "DAVID VILLALOBOS CAMBRONERO",
+  //     Identificacion: "111050570",
+  //     Instancia: "Dirección de TI",
+  //     Fecha: "17-04-2026 14:30",
+  //     Motivo: "Aprobación de vacaciones"
+  //   }
+  // ]
+  // ReportePDF.generarFirmas(doc, firmas);
+  // firmas = [
+  //   {
+  //     Nombre: "DAVID VILLALOBOS CAMBRONERO",
+  //     Identificacion: "111050570",
+  //     Instancia: "Dirección de TI",
+  //     Fecha: "17-04-2026 14:30",
+  //     Motivo: "Aprobación de vacaciones"
+  //   },
+  //   {
+  //     Nombre: "DAVID VILLALOBOS CAMBRONERO",
+  //     Identificacion: "111050570",
+  //     Instancia: "Dirección de TI",
+  //     Fecha: "17-04-2026 14:30",
+  //     Motivo: "Aprobación de vacaciones"
+  //   }
+  // ]
+  // ReportePDF.generarFirmas(doc, firmas);
+  // ReportePDF.generarTituloDePagina(doc, titulos.Principal, titulos.Subtitulo1, titulos.Subtitulo2);
+  // ReportePDF.generarTituloDePagina(doc, titulos.Principal, titulos.Subtitulo1, titulos.Subtitulo2);
+  // ReportePDF.generarTabla(doc, datos, metadatos);
+  // ReportePDF.generarTabla(doc, datos, metadatos);
+  // const parrafoIntroductorio = `Este <b>reporte</b> detalla la asignación <u>automática</u> de periodos de vacaciones realizada en la fecha seleccionada. <i>Los datos mostrados</i> corresponden al estado final de cada registro tras el proceso de cálculo.`;
+  // ReportePDF.generarParrafoHTML(doc, parrafoIntroductorio);
+  // ReportePDF.generarTabla(doc, datos, metadatos);
+  // ReportePDF.generarSaltoDePagina(doc);
+  // ReportePDF.generarTabla(doc, datos, metadatos);
+  // ReportePDF.generarParrafoHTML(doc, parrafo);
+  // ReportePDF.generarMarcaDeAgua(doc, "TEXTO DEL SELLO", "#FF0000");
+  // ReportePDF.generarFoliado(doc, 100);
+  // ReportePDF.generarPie(doc, "Copia digital del documento original.\nPara fines informáticos únicamente.");
+  // const MetaDatos = {
+  //   Titulo: "UTN-1-2025-10841",
+  //   Identificador: 12,
+  //   Autor: "VALLADARES BONILLA TONNY MAURICIO 603230047",
+  //   Asunto: "Boleta de Vacaciones"
+  // };
+  // await ReportePDF.generarMetadatosReporte(doc, MetaDatos);
+  // ReportePDF.finalizarReporte(doc);
+
+  async verificarSiReporteYaExiste(Modulo, Titulo, Identificador) {
+    try {
+      const query = `SELECT COUNT(*) AS total FROM SIGU.SIGU_ReportesGenerados WHERE Modulo = ? AND Titulo = ? AND Identificador = ?`;
+      const resultado = await ejecutarConsultaSIGU(query, [Modulo, Titulo, Identificador]);
+      return resultado[0].total > 0;
+    } catch (error) {
+      console.error("Error al verificar existencia del reporte:", error);
+      return false;
+    }
+  }
+
+  async generarMetadatosReporte(doc, opciones) {
+    try {
+      const {
+        Modulo = Miscelaneas.getNombreDelRepositorioDelBackend(),
+        Titulo = 'Sin Título',
+        Identificador = 0,
+        Autor = 'Sistema',
+        Asunto = 'Reporte'
+      } = opciones;
+
+      const yaExiste = await this.verificarSiReporteYaExiste(Modulo, Titulo, Identificador);
+      if (yaExiste) {
+        return true;
+      }
+
+      // Generar UUID
+      const UUIDResult = await ejecutarConsultaSIGU("SELECT UUID() AS Dato");
+      const uuid = UUIDResult[0].Dato;
+
+      // Generar fecha y hora actual en formato MySQL
+      const now = new Date();
+      // Formatear al huso horario local de Costa Rica o general YYYY-MM-DD HH:mm:ss
+      // Una forma segura y simple en Node para obtener local sin T ni Z
+      const offsetMs = now.getTimezoneOffset() * 60 * 1000;
+      const localTime = new Date(now.getTime() - offsetMs);
+      const fechaYHora = localTime.toISOString().replace('T', ' ').substring(0, 19);
+
+      // Preparar Metadatos según estructura solicitada
+      const metadatos = {
+        "Título": Titulo,
+        "Autor": Autor,
+        "Asunto": Asunto,
+        "Palabras clave": {
+          "Módulo": Modulo,
+          "UUID": uuid
+        },
+        "Fecha de creación": fechaYHora
+      };
+
+      // Calcular cantidad de páginas
+      let totalPaginas = 1;
+      // Primero intentamos con bufferedPageRange si se inicializó con { bufferPages: true }
+      if (typeof doc.bufferedPageRange === 'function') {
+        try {
+          const range = doc.bufferedPageRange();
+          if (range && range.count > 0) {
+            totalPaginas = range.count;
+          }
+        } catch (e) {
+          // Si bufferPages no está activo, PDFKit a veces lanza un error al llamar a la función
+        }
+      }
+
+      // Si falló el buffer, intentamos recuperar el número de la página en la que quedó el cursor.
+      if (totalPaginas === 1 && doc._pageBuffer && doc._pageBuffer.length > 0) {
+        totalPaginas = doc._pageBuffer.length;
+      }
+
+      // Suma de comprobación usando crypto sha256
+      const hashStr = `${uuid}-${Modulo}-${fechaYHora}`;
+      const sumaDeComprobacion = crypto.createHash('sha256').update(hashStr).digest('hex');
+
+      // Preparar MetadatosExtra
+      const metadatosExtra = {
+        "CantidadDePáginas": totalPaginas,
+        "ValidaFechaDeModificación": "TRUE",
+        "SumaDeComprobacion": sumaDeComprobacion
+      };
+
+      // Adjuntar metadatos al documento PDF
+      doc.info['Title'] = metadatos['Título'];
+      doc.info['Author'] = metadatos['Autor'];
+      doc.info['Subject'] = metadatos['Asunto'];
+      doc.info['Keywords'] = JSON.stringify(metadatos['Palabras clave']);
+      // Añadir la cadena JSON explícitamente en el PDF si se requiere para validaciones futuras
+      doc.info['Metadatos'] = JSON.stringify(metadatos);
+      doc.info['MetadatosExtra'] = JSON.stringify(metadatosExtra);
+
+      // Insertar el registro en la base de datos
+      await ejecutarConsultaSIGU(
+        `INSERT INTO SIGU.SIGU_ReportesGenerados 
+          (IdentificadorDelReporte, Modulo, Titulo, Identificador, Metadatos, MetadatosExtra, FechaYHora) 
+         VALUES (?, ?, ?, ?, ?, ?, ?)`,
+        [
+          uuid,
+          Modulo,
+          Titulo,
+          Identificador,
+          JSON.stringify(metadatos),
+          JSON.stringify(metadatosExtra),
+          fechaYHora
+        ]
+      );
+
+      return true;
+    } catch (error) {
+      console.error("Error al generar metadatos del reporte PDF:", error);
+      return false;
+    }
+  }
+
+  finalizarReporte(doc) {
+    doc.end();
+  }
+
+  generarEncabezado(Titulos, respuesta) {
+    respuesta.setHeader("Content-Type", "application/pdf");
+    respuesta.setHeader("Content-Disposition", `inline; filename=Reporte.pdf`);
+    const doc = new PDFDocument({
+      size: 'Letter',
+      margins: { top: 105, left: this.config.margin, right: this.config.margin, bottom: this.config.margin },
+      bufferPages: true
+    });
+    doc.pipe(respuesta);
+
+    // Función interna para dibujar el encabezado
+    const dibujarEncabezado = () => {
+      const margin = this.config.margin;
+      const logoWidth = 70;
+      const pageWidth = doc.page.width;
+
+      // Logo UTN
+      try {
+        const rutaLogo = path.join(__dirname, "./LogoUTN.png");
+        // Subimos el logo ligeramente (Y=35 en vez de 40)
+        doc.image(rutaLogo, margin, 35, { width: logoWidth });
+      } catch (e) { console.error("Logo no encontrado", e); }
+
+      doc.fillColor(this.config.colorPrimario).fontSize(11).font(this.config.fuenteNegrita);
+      doc.text("Universidad Técnica Nacional", margin + logoWidth + 15, 45);
+      doc.fontSize(9).font(this.config.fuenteBase);
+      doc.text(Titulos.Direccion, margin + logoWidth + 15, 58);
+      doc.text(Titulos.Area, margin + logoWidth + 15, 70);
+
+      // Bloque derecho con información del documento
+      const now = new Date();
+      const fechaActual = now.toLocaleDateString('es-CR');
+      const horaActual = now.toLocaleTimeString('es-CR', { hour: '2-digit', minute: '2-digit', hour12: false });
+      doc.fontSize(this.config.fontSizePequeño).fillColor(this.config.colorPrimario);
+      doc.text(`Fecha: ${fechaActual}`, pageWidth - margin - 200, 45, { align: 'right', width: 200 });
+      doc.text(`Hora: ${horaActual}`, pageWidth - margin - 200, 55, { align: 'right', width: 200 });
+      doc.text(`Usuario: ${Titulos.Usuario}`, pageWidth - margin - 200, 65, { align: 'right', width: 200 });
+
+      const acceso = Titulos.Acceso || 'Interno';
+      const uso = Titulos.Uso || 'Público';
+      doc.text(`Acceso: ${acceso}, Uso: ${uso}`, pageWidth - margin - 200, 75, { align: 'right', width: 200 });
+
+      // Línea separadora
+      doc.moveTo(margin, 90).lineTo(pageWidth - margin, 90).strokeColor(this.config.colorPrimario).lineWidth(2).stroke();
+
+      // Asegurar que el cursor quede posicionado debajo del encabezado
+      doc.x = margin;
+      doc.y = 105;
+    };
+    // Evento para añadir el encabezado institucional automáticamente en CADA NUEVA PÁGINA
+    doc.on('pageAdded', dibujarEncabezado);
+    // Dibujar el encabezado en la PRIMERA PÁGINA (que ya fue creada al instanciar PDFDocument)
+    dibujarEncabezado();
+    return doc;
+  }
+
+  generarTituloDePagina(doc, Titulo, Subtitulo1 = undefined, Subtitulo2 = undefined) {
+    const margin = this.config.margin;
+    const pageWidth = doc.page.width;
+
+    // Alinear el cursor al margen izquierdo antes de imprimir
+    doc.x = margin;
+
+    // Título y subtítulos
+    doc.fillColor("black").fontSize(this.config.fontSizeTitulo).font(this.config.fuenteNegrita);
+
+    // Al no pasar coordenadas X e Y fijas, PDFKit renderiza el texto en la 
+    // posición actual de doc.y fluyendo naturalmente hacia abajo.
+    doc.text(Titulo, { align: 'center', width: pageWidth - 2 * margin });
+
+    doc.fontSize(this.config.fontSizeSubtitulo).font(this.config.fuenteBase);
+
+    if (Subtitulo1) {
+      doc.moveDown(0.5);
+      doc.text(Subtitulo1, { align: 'center', width: pageWidth - 2 * margin });
+    }
+
+    if (Subtitulo2) {
+      doc.moveDown(0.5);
+      doc.text(Subtitulo2, { align: 'center', width: pageWidth - 2 * margin });
+    }
+
+    // Mover el cursor un poco hacia abajo para el siguiente contenido
+    doc.moveDown(2);
+  }
+
+  generarPie(doc, PieDePagina = undefined) {
+    const range = doc.bufferedPageRange();
+    const textoPieDePagina = PieDePagina || '';
+    for (let i = range.start; i < range.start + range.count; i++) {
+      doc.switchToPage(i);
+      const indexPagina = i + 1;
+      const totalPaginas = range.count;
+      const margin = this.config.margin;
+      const pageWidth = doc.page.width;
+      const footerY = doc.page.height - 50;
+
+      // Desactivar temporalmente el margen inferior para evitar saltos de página accidentales
+      const bottomMargin = doc.page.margins.bottom;
+      doc.page.margins.bottom = 0;
+
+      // Raya horizontal superior del pie
+      doc.moveTo(margin, footerY).lineTo(pageWidth - margin, footerY).strokeColor(this.config.colorPrimario).lineWidth(1).stroke();
+
+      // Raya vertical en el centro como separador
+      const centerX = pageWidth / 2;
+
+      doc.fillColor(this.config.colorPrimario).fontSize(this.config.fontSizeMuyPequeño).font(this.config.fuenteBase);
+
+      // Texto a la izquierda
+      doc.text(textoPieDePagina || "", margin, footerY + 10, { width: (pageWidth / 2) - margin - 15, align: 'left' });
+
+      // Paginación a la derecha (X de Y)
+      const paginacion = `Página ${indexPagina} de ${totalPaginas}`;
+      // Como el texto de la izquierda tiene 2 líneas, alineamos la paginación un poco más abajo para que quede centrado
+      doc.text(paginacion, centerX + 15, footerY + 14, { width: (pageWidth / 2) - margin - 15, align: 'right' });
+
+      // Restaurar el margen inferior original
+      doc.page.margins.bottom = bottomMargin;
+    }
+    // doc.end();
+  }
+
+  generarFoliado(doc, folioInicial) {
+    if (!doc || folioInicial === undefined) return;
+
+    const range = doc.bufferedPageRange();
+    let folioActual = parseInt(folioInicial);
+
+    for (let i = range.start; i < range.start + range.count; i++) {
+      doc.switchToPage(i);
+
+      const margin = this.config.margin;
+      const pageWidth = doc.page.width;
+      const yPos = 30; // Posición en la parte superior, fuera del área del encabezado principal
+
+      doc.save();
+      doc.fillColor("black")
+        .fontSize(this.config.fontSizeSubtitulo)
+        .font(this.config.fuenteNegrita);
+
+      doc.text(String(folioActual), pageWidth - margin - 100, yPos, {
+        width: 100,
+        align: 'right'
+      });
+
+      doc.restore();
+      folioActual++;
+    }
+  }
+
+  generarMarcaDeAgua(doc, texto, color = "#CCCCCC") {
+    if (!doc || !texto) return;
+
+    const range = doc.bufferedPageRange();
+    for (let i = range.start; i < range.start + range.count; i++) {
+      doc.switchToPage(i);
+
+      const pageWidth = doc.page.width;
+      const pageHeight = doc.page.height;
+
+      doc.save();
+
+      // Configuración de la marca de agua
+      doc.fillColor(color);
+      doc.fillOpacity(0.15); // Transparencia para que no tape el contenido
+      doc.fontSize(60);
+      doc.font(this.config.fuenteNegrita);
+
+      // Posicionamiento central con rotación
+      doc.translate(pageWidth / 2, pageHeight / 2);
+      doc.rotate(-45);
+
+      // Dibujar el texto centrado en el eje rotado
+      doc.text(texto, -pageWidth / 2, -30, {
+        width: pageWidth,
+        align: 'center'
+      });
+
+      doc.restore();
+    }
+  }
+
+  generarTabla(doc, datos, metadatos) {
+    if (!datos || datos.length === 0) return;
+
+    const margin = this.config.margin;
+    const pageWidth = doc.page.width;
+    const availableWidth = pageWidth - 2 * margin;
+
+    // Dibujar encabezado de la tabla
+    const dibujarHeaderTabla = (y) => {
+      doc.rect(margin, y, availableWidth, 22).fill(this.config.colorPrimario);
+      doc.fillColor("white").font(this.config.fuenteNegrita).fontSize(this.config.fontSizeCuerpo);
+      let cx = margin;
+      metadatos.forEach(col => {
+        doc.text(col.titulo, cx + 5, y + 7, { width: col.ancho - 10, align: 'left' });
+        cx += col.ancho;
+      });
+      return y + 22;
+    };
+
+    let currentY = doc.y;
+
+    // Si estamos muy cerca del final, empezamos en página nueva
+    if (currentY > doc.page.height - 100) {
+      doc.addPage();
+      currentY = doc.y; // doc.y ya viene ajustado por el encabezado institucional
+    }
+
+    currentY = dibujarHeaderTabla(currentY);
+    doc.font(this.config.fuenteBase).fontSize(this.config.fontSizePequeño).fillColor("black");
+
+    datos.forEach((fila, index) => {
+      const rowHeight = 20;
+
+      // Salto de página automático (dejando margen para el pie)
+      if (currentY + rowHeight > doc.page.height - 80) {
+        doc.addPage();
+        currentY = dibujarHeaderTabla(doc.y);
+        doc.font(this.config.fuenteBase).fontSize(this.config.fontSizePequeño).fillColor("black");
+      }
+
+      // Fondo alterno para las filas
+      if (index % 2 === 0) {
+        doc.rect(margin, currentY, availableWidth, rowHeight).fill(this.config.colorFondoAlterno);
+      }
+
+      doc.fillColor("black");
+      let cx = margin;
+      metadatos.forEach(col => {
+        let valor = fila[col.llave];
+        // Formatear si es salario o número de días
+        if (col.llave === 'Salario' && valor) {
+          valor = Number(valor).toLocaleString('es-CR', { style: 'currency', currency: 'CRC' });
+        } else if (col.llave === 'DiasOtorgados' && valor) {
+          valor = Number(valor).toFixed(1);
+        }
+
+        doc.text(String(valor || ""), cx + 5, currentY + 6, { width: col.ancho - 10, align: 'left' });
+        cx += col.ancho;
+      });
+
+      // Línea de separación de fila
+      doc.moveTo(margin, currentY + rowHeight).lineTo(pageWidth - margin, currentY + rowHeight).strokeColor(this.config.colorLinea).lineWidth(0.5).stroke();
+
+      currentY += rowHeight;
+      // Actualizar la posición global del cursor Y del documento
+      doc.y = currentY;
+    });
+
+    doc.moveDown(1);
+  }
+
+  generarSaltoDePagina(doc) {
+    // PDFKit generará automáticamente el encabezado de la nueva página debido
+    // al evento doc.on('pageAdded') que configuramos en crearPDFDinamico.
+    doc.addPage();
+  }
+
+  generarParrafoHTML(doc, html, opciones = {}) {
+    const margin = this.config.margin;
+    const pageWidth = doc.page.width;
+    const availableWidth = opciones.ancho || (pageWidth - 2 * margin);
+
+    // Mejorar la expresión regular para que mantenga los espacios en blanco
+    // y capture los tags sin romper las palabras
+    const tokens = String(html || "")
+      .replace(/\n/g, ' ') // Eliminar saltos de línea para que fluya como un párrafo
+      .split(/(<[a-z0-9/]+[^>]*>)/gi);
+
+    let isBold = false;
+    let isItalic = false;
+    let isUnderline = false;
+    let currentLink = null;
+
+    const fontSize = opciones.fontSize || this.config.fontSizeSubtitulo;
+    const align = opciones.align || 'justify';
+
+    // Determinar el último token de texto que no está vacío
+    let lastTextIndex = -1;
+    for (let i = tokens.length - 1; i >= 0; i--) {
+      const token = tokens[i];
+      if (!token.match(/^<.*>$/) && token.trim() !== "") {
+        lastTextIndex = i;
+        break;
+      }
+    }
+
+    doc.fillColor('black');
+
+    // Comprobamos si hay espacio suficiente en la página antes de empezar a dibujar
+    // Estimamos un alto de línea basado en el tamaño de fuente
+    const estimatedHeight = fontSize * 1.5;
+    if (doc.y + estimatedHeight > doc.page.height - doc.page.margins.bottom - 40) {
+      doc.addPage();
+    }
+
+    // Como pdfkit podría venir de un texto dibujado con coordenadas X y Y absolutas (que rompe el flujo interno de texto),
+    // definimos la posición X al margen izquierdo para iniciar el párrafo, manteniendo la coordenada Y actual.
+    doc.x = margin;
+
+    // Función auxiliar para aplicar el formato y escribir el buffer
+    const flushText = (token, isLast) => {
+      if (token === "") return;
+
+      let fontName = this.config.fuenteBase;
+      if (isBold && isItalic) fontName = this.config.fuenteNegritaCursiva;
+      else if (isBold) fontName = this.config.fuenteNegrita;
+      else if (isItalic) fontName = this.config.fuenteCursiva;
+
+      doc.font(fontName).fontSize(fontSize);
+
+      // Decidimos si usar 'continued'
+      // Es 'continued' a menos que sea el último fragmento de texto
+      const isContinued = !isLast;
+
+      // Para evitar que las palabras con diferente formato se peguen,
+      // añadimos explícitamente un espacio en blanco al final de cada fragmento
+      // si este no es el último y si el token en sí no termina ya en un espacio.
+      let textoParaImprimir = token;
+      if (isContinued && !textoParaImprimir.endsWith(' ')) {
+        textoParaImprimir += ' ';
+      }
+
+      // Comprobar espacio por cada fragmento para prevenir que `continued` desborde mal
+      if (doc.y + fontSize > doc.page.height - doc.page.margins.bottom - 20) {
+        // En PDFKit, hacer addPage() mientras hay 'continued' true a veces falla, pero ayuda forzarlo antes.
+        doc.text(' ', { continued: false }); // forzar fin de linea
+        doc.addPage();
+        doc.x = margin; // reposicionar en nueva pagina
+      }
+
+      // Si hay un link activo, usamos color azul y subrayado por defecto si no se especificó lo contrario
+      if (currentLink) {
+        doc.fillColor('blue');
+      } else {
+        doc.fillColor('black');
+      }
+
+      doc.text(textoParaImprimir, {
+        width: availableWidth,
+        continued: isContinued,
+        underline: isUnderline || (currentLink ? true : false),
+        link: currentLink,
+        align: align
+      });
+    };
+
+    for (let index = 0; index < tokens.length; index++) {
+      let token = tokens[index];
+
+      if (!token) continue;
+
+      const lowerToken = token.toLowerCase().trim();
+
+      // Tags admitidos
+      if (lowerToken === '<b>' || lowerToken === '<strong>') {
+        isBold = true;
+        continue;
+      }
+      if (lowerToken === '</b>' || lowerToken === '</strong>') {
+        isBold = false;
+        continue;
+      }
+      if (lowerToken === '<i>' || lowerToken === '<em>') {
+        isItalic = true;
+        continue;
+      }
+      if (lowerToken === '</i>' || lowerToken === '</em>') {
+        isItalic = false;
+        continue;
+      }
+      if (lowerToken === '<u>') {
+        isUnderline = true;
+        continue;
+      }
+      if (lowerToken === '</u>') {
+        isUnderline = false;
+        continue;
+      }
+      if (lowerToken.startsWith('<a')) {
+        const hrefMatch = token.match(/href=["']([^"']*)["']/i);
+        if (hrefMatch) {
+          currentLink = hrefMatch[1];
+        }
+        continue;
+      }
+      if (lowerToken === '</a>') {
+        currentLink = null;
+        continue;
+      }
+      if (lowerToken === '<br>' || lowerToken === '<br/>' || lowerToken === '<br />') {
+        // Si hay un salto de línea, rompemos el continued escribiendo un espacio final
+        doc.text(' ', { continued: false });
+        doc.moveDown(1);
+        continue;
+      }
+
+      // Si no es un tag, entonces es texto. Lo mandamos a imprimir.
+      if (!token.match(/^<.*>$/)) {
+        // En PDFKit el continued es complicado con espacios en los bordes de los tags
+        // Decodificamos entidades HTML comunes
+        token = token
+          .replace(/&nbsp;/g, ' ')
+          .replace(/&lt;/g, '<')
+          .replace(/&gt;/g, '>')
+          .replace(/&amp;/g, '&')
+          .replace(/&quot;/g, '"')
+          .replace(/&#39;/g, "'");
+
+        const isLast = index === lastTextIndex || index > lastTextIndex;
+        flushText(token, isLast);
+      }
+    }
+
+    doc.moveDown(1);
+  }
+
+  generarFirmas(doc, firmas) {
+    if (!firmas || !Array.isArray(firmas) || firmas.length === 0) return;
+
+    const margin = this.config.margin;
+    const pageWidth = doc.page.width;
+    const availableWidth = pageWidth - 2 * margin;
+    const signatureHeight = 75;
+    const gap = 10;
+    const logoWidth = 35;
+    const padding = 6;
+
+    // Dividimos las firmas en grupos de 3 (máximo por fila)
+    for (let i = 0; i < firmas.length; i += 3) {
+      const filaDeFirmas = firmas.slice(i, i + 3);
+      const cantidadEnFila = filaDeFirmas.length;
+
+      // Ancho total por bloque de firma según la cantidad en esta fila
+      const blockWidth = availableWidth / cantidadEnFila;
+
+      // Verificar si hay espacio en la página actual para esta fila
+      if (doc.y + signatureHeight > doc.page.height - 80) {
+        doc.addPage();
+      }
+
+      const startY = doc.y + 10;
+
+      filaDeFirmas.forEach((firma, index) => {
+        const blockX = margin + (index * blockWidth);
+
+        let innerWidth = blockWidth - gap;
+        let innerX = blockX + (gap / 2);
+
+        // Ajustar márgenes para los extremos
+        if (index === 0) {
+          innerX = blockX;
+          innerWidth = blockWidth - (gap / 2);
+        }
+        if (index === cantidadEnFila - 1) {
+          innerWidth = blockWidth - (gap / 2);
+        }
+        if (cantidadEnFila === 1) {
+          innerWidth = 240;
+          innerX = margin + (availableWidth / 2) - (innerWidth / 2);
+        }
+
+        // Dibujar fondo y borde
+        doc.save();
+        doc.fillColor("#FCFCFC").strokeColor("#EEEEEE").lineWidth(1);
+        doc.rect(innerX, startY, innerWidth, signatureHeight).fillAndStroke();
+        doc.restore();
+
+        let currentX = innerX + padding;
+
+        // Dibujar logo
+        try {
+          const rutaLogo = path.join(__dirname, "./LogoUTN.png");
+          // Centrar verticalmente el logo dentro del recuadro
+          const logoY = startY + (signatureHeight / 2) - 13;
+          doc.image(rutaLogo, currentX, logoY, { width: logoWidth });
+
+          // Línea vertical separadora
+          doc.save();
+          doc.moveTo(currentX + logoWidth + padding, startY + padding)
+            .lineTo(currentX + logoWidth + padding, startY + signatureHeight - padding)
+            .strokeColor("#CCCCCC")
+            .lineWidth(0.5)
+            .stroke();
+          doc.restore();
+
+          currentX += logoWidth + (padding * 2);
+        } catch (e) {
+          // Si falla el logo, currentX se mantiene igual para el texto
+        }
+
+        // Área para el texto
+        const textWidth = innerWidth - (currentX - innerX) - padding;
+        let textY = startY + padding + 1;
+
+        doc.fillColor("black");
+
+        // 1. Título
+        doc.fontSize(6).font(this.config.fuenteNegrita);
+        doc.text("Firma electrónica por:", currentX, textY, { width: textWidth, align: 'left' });
+        textY = doc.y + 1;
+
+        // 2. Nombre
+        doc.fontSize(6).font(this.config.fuenteBase);
+        doc.text(firma.Nombre || 'N/A', currentX, textY, { width: textWidth, align: 'left' });
+        textY = doc.y + 1;
+
+        // 3. Cédula
+        doc.text(`Cédula: ${firma.Identificacion || 'N/A'}`, currentX, textY, { width: textWidth, align: 'left' });
+        textY = doc.y + 1;
+
+        // 4. Instancia
+        doc.text(`Instancia: ${firma.Instancia || 'N/A'}`, currentX, textY, { width: textWidth, align: 'left' });
+        textY = doc.y + 1;
+
+        // 5. Fecha
+        doc.text(`Fecha: ${firma.Fecha || 'N/A'}`, currentX, textY, { width: textWidth, align: 'left' });
+        textY = doc.y + 1;
+
+        // 6. Motivo
+        doc.text(`Motivo: ${firma.Motivo || 'N/A'}`, currentX, textY, { width: textWidth, align: 'left' });
+      });
+
+      // Mover el cursor para la siguiente fila
+      doc.y = startY + signatureHeight + 10;
+    }
+
+    // Agregar un poco de margen después de todas las firmas
+    doc.y += 10;
+  }
+}
+
+module.exports = new ReportePDF();