@devlas/dte-sii 2.6.0 → 2.8.0

package/cert/MuestrasImpresas.js

@@ -20,7 +20,7 @@ const fs = require('fs');
 const path = require('path');
 const { XMLParser, XMLBuilder } = require('fast-xml-parser');
 const bwipjs = require('bwip-js');
-const puppeteer = require('puppeteer');
+const { launchBrowser } = require('../utils/browser');
 
 // Usar constantes del core
 const {
@@ -485,7 +485,7 @@ class MuestrasImpresas {
   }
 
   /**
-   * Genera PDF desde HTML
+   * Genera PDF desde HTML y lo escribe a disco.
    * @private
    */
   async _generarPdf({ html, outputPath, browser }) {
@@ -501,6 +501,34 @@ class MuestrasImpresas {
     await page.close();
   }
 
+  /**
+   * Genera un PDF desde HTML y devuelve el contenido como Buffer (sin escribir a disco).
+   * Útil para servir el PDF directamente desde una respuesta HTTP.
+   *
+   * @param {string} html - HTML a convertir a PDF
+   * @param {object} [opts]
+   * @param {string} [opts.width='215mm']
+   * @param {string} [opts.height='280mm']
+   * @returns {Promise<Buffer>}
+   */
+  async generarPdfBuffer(html, opts = {}) {
+    const browser = await launchBrowser();
+    try {
+      const page = await browser.newPage();
+      await page.setContent(html, { waitUntil: 'networkidle0' });
+      const pdfBuffer = await page.pdf({
+        printBackground: true,
+        width: opts.width ?? '215mm',
+        height: opts.height ?? '280mm',
+        margin: { top: '10mm', right: '10mm', bottom: '10mm', left: '10mm' },
+      });
+      await page.close();
+      return Buffer.from(pdfBuffer);
+    } finally {
+      await browser.close();
+    }
+  }
+
   /**
    * Genera muestras impresas desde archivos XML
    * @param {Object} options
@@ -524,7 +552,7 @@ class MuestrasImpresas {
     console.log(` SET-PRUEBAS: ${pruebasDir}`);
     console.log(` SET-SIMULACION: ${simulacionDir}`);
 
-    const browser = await puppeteer.launch({ headless: true });
+    const browser = await launchBrowser();
     const resultado = {
       success: true,
       totalDocs: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Facturación y boletas electrónicas para el SII de Chile. Genera, timbra, firma y envía DTEs, libros electrónicos y automatiza la certificación.",
   "main": "index.js",
   "types": "dte-sii.d.ts",
@@ -40,6 +40,9 @@
     "xml-c14n": "^0.0.6",
     "xml-crypto": "^6.1.2"
   },
+  "optionalDependencies": {
+    "@sparticuz/chromium": "^133.0.0"
+  },
   "files": [
     "index.js",
     "dte-sii.d.ts",

package/utils/browser.js

@@ -0,0 +1,73 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * utils/browser.js
+ *
+ * Helper para lanzar Puppeteer con el Chromium correcto según el entorno:
+ *  - Producción / serverless (Railway, Lambda, etc.): usa @sparticuz/chromium
+ *  - Desarrollo local: usa el Chrome del sistema si @sparticuz/chromium no está disponible
+ *
+ * Uso:
+ *   const { launchBrowser } = require('./utils/browser')
+ *   const browser = await launchBrowser()
+ */
+
+'use strict';
+
+const puppeteer = require('puppeteer');
+
+/**
+ * Devuelve las opciones de lanzamiento para puppeteer.launch() según el entorno.
+ * @returns {Promise<import('puppeteer').LaunchOptions>}
+ */
+async function getLaunchOptions() {
+  // 1. Intentar @sparticuz/chromium (viene en el paquete, funciona en serverless)
+  try {
+    const chromium = require('@sparticuz/chromium');
+    return {
+      args: chromium.args,
+      defaultViewport: chromium.defaultViewport,
+      executablePath: await chromium.executablePath(),
+      headless: chromium.headless ?? true,
+    };
+  } catch {
+    // No está disponible, continuar con fallback
+  }
+
+  // 2. Ruta explícita por variable de entorno
+  if (process.env.PUPPETEER_EXECUTABLE_PATH) {
+    return {
+      headless: true,
+      args: ['--no-sandbox', '--disable-setuid-sandbox'],
+      executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
+    };
+  }
+
+  // 3. Chrome del sistema (rutas comunes Linux / Windows)
+  const fs = require('fs');
+  const SYSTEM_PATHS = [
+    '/usr/bin/google-chrome-stable',
+    '/usr/bin/google-chrome',
+    '/usr/bin/chromium-browser',
+    '/usr/bin/chromium',
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+  ];
+  const executablePath = SYSTEM_PATHS.find(p => { try { return fs.existsSync(p) } catch { return false } });
+  return {
+    headless: true,
+    args: ['--no-sandbox', '--disable-setuid-sandbox'],
+    ...(executablePath ? { executablePath } : {}),
+  };
+}
+
+/**
+ * Lanza un browser Puppeteer con el Chromium correcto para el entorno actual.
+ * @returns {Promise<import('puppeteer').Browser>}
+ */
+async function launchBrowser() {
+  const opts = await getLaunchOptions();
+  return puppeteer.launch(opts);
+}
+
+module.exports = { launchBrowser, getLaunchOptions };