arcli 1.4.0 → 1.5.0

package/dist/ui/presenters/pdf.presenter.js

@@ -0,0 +1,46 @@
+import { maskPath } from '../../lib/paths/mask-path.js';
+import { errorPanel } from '../components/errorPanel.js';
+import { keyValuePanel } from '../components/keyValuePanel.js';
+import { noticePanel } from '../components/noticePanel.js';
+import { renderKeyValueRows, resolveKeyValueLabelWidth } from '../primitives/renderKeyValue.js';
+/** Texto que sigue al comprobante emitido: la ruta del PDF o por que no se genero. */
+export function formatPdfOutcomeAsText(outcome, label) {
+    const prefix = label ? `${label}: ` : '';
+    if ('path' in outcome) {
+        return noticePanel(`${prefix}PDF guardado en ${outcome.path}`, 'success');
+    }
+    const hint = ['El comprobante ya esta emitido: solo falto el PDF.', outcome.error.suggestion]
+        .filter(Boolean)
+        .join('\n');
+    return errorPanel(`${prefix}PDF no generado`, outcome.error.message, [], hint);
+}
+const BROWSER_SOURCE_LABELS = {
+    config: 'pdfNavegador (config)',
+    descargado: 'descargado por arcli',
+    entorno: 'PUPPETEER_EXECUTABLE_PATH',
+    sistema: 'instalado en el sistema',
+};
+export function formatPdfPluginStatusAsJson(status) {
+    return JSON.stringify({
+        instalado: status.installed,
+        navegador: status.browser ?? null,
+        origenNavegador: status.browserSource ?? null,
+        ruta: status.path,
+        version: status.version,
+        versionInstalada: status.installedVersion ?? null,
+    }, null, 2);
+}
+export function formatPdfPluginStatusAsText(status, title = 'Plugin de PDF') {
+    const rows = [
+        ['Estado', status.installed ? 'instalado' : 'no instalado'],
+        ['Version', status.installedVersion ?? `no instalada (arcli usa la ${status.version})`],
+        [
+            'Navegador',
+            status.browser ? `${status.browser} (${BROWSER_SOURCE_LABELS[status.browserSource ?? 'sistema']})` : 'ninguno',
+        ],
+        ['Carpeta', maskPath(status.path)],
+    ];
+    const footer = status.installed ? 'Listo para generar PDFs' : 'Instalelo con `arcli pdf instalar`';
+    return keyValuePanel(title, renderKeyValueRows(rows, { labelWidth: resolveKeyValueLabelWidth('standard', rows, [25, 75]) }), footer, 'standard', status.installed ? 'success' : 'warning', 'sheet');
+}
+//# sourceMappingURL=pdf.presenter.js.map

package/dist/ui/presenters/pdf.presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.presenter.js","sourceRoot":"","sources":["../../../src/ui/presenters/pdf.presenter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE7F,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,OAAmB,EAAE,KAAc;IACxE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzC,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,MAAM,mBAAmB,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,oDAAoD,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;SAC1F,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,UAAU,CAAC,GAAG,MAAM,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AACjF,CAAC;AAWD,MAAM,qBAAqB,GAAsE;IAC/F,MAAM,EAAE,uBAAuB;IAC/B,UAAU,EAAE,sBAAsB;IAClC,OAAO,EAAE,2BAA2B;IACpC,OAAO,EAAE,yBAAyB;CACnC,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,MAA2B;IACrE,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QACjC,eAAe,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;KAClD,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAA2B,EAAE,KAAK,GAAG,eAAe;IAC9F,MAAM,IAAI,GAAqC;QAC7C,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;QAC3D,CAAC,SAAS,EAAE,MAAM,CAAC,gBAAgB,IAAI,8BAA8B,MAAM,CAAC,OAAO,GAAG,CAAC;QACvF;YACE,WAAW;YACX,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,KAAK,qBAAqB,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SAC/G;QACD,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACnC,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,oCAAoC,CAAC;IAEnG,OAAO,aAAa,CAClB,KAAK,EACL,kBAAkB,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,yBAAyB,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAC/F,MAAM,EACN,UAAU,EACV,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EACxC,OAAO,CACR,CAAC;AACJ,CAAC"}

package/llms.txt

@@ -66,6 +66,7 @@ Shortcuts (`family` = comando alternativo `arcli <family> <letra>`, ej. `arcli f
 - Ejecución: `--previsualizar` (default si no se especifica nada) vs `--emitir` (real contra ARCA) — son mutuamente excluyentes. En producción hace falta `--produccion --emitir` juntos — no hay un flag de confirmación adicional, así que esa combinación emite de verdad.
 - Salida: `--json` (estructurada, para scripts/agentes — desactiva el aviso de nueva versión), `--bruto` (incluye la respuesta cruda de ARCA).
 - `--cargar <path.json>`: carga uno o un array de comprobantes desde un JSON en vez de flags (ver forma abajo). Los flags pisan lo que venga del archivo.
+- PDF: `--exportar-pdf` (alias `--pdf`) genera el PDF con QR después de emitir; `--sin-pdf` no lo genera; sin flag decide `config pdf` (`preguntar` por defecto, que sin TTY o con `--json` no genera). Datos que solo van en el PDF (ARCA no los recibe): `--descripcion <texto>`, `--receptor-nombre <texto>`, `--receptor-domicilio <texto>`. Requiere el plugin (`arcli pdf instalar`, ~160 MB; desde un agente instalarlo antes, porque sin TTY nunca se descarga solo) y `emisor.razonSocial`, `emisor.domicilio`, `emisor.inicioActividades` en la config. Detalle: `docs/pdf.md`.
 
 ## Modo no interactivo
 
@@ -94,7 +95,11 @@ agentes, CI), nunca pregunta** — se comporta como si fuera dry-run salvo que s
   "emitir": false,
   "previsualizar": true,
   "confirmarProduccion": false,
-  "comprobanteAsociado": { "atajo": "fc", "cuit": "20123456789", "numero": 10, "puntoVenta": 3 }
+  "comprobanteAsociado": { "atajo": "fc", "cuit": "20123456789", "numero": 10, "puntoVenta": 3 },
+  "pdf": true,
+  "descripcion": "Servicios de marzo",
+  "receptorNombre": "Cliente SA",
+  "receptorDomicilio": "Calle 1"
 }
 ```
 
@@ -115,10 +120,15 @@ agentes, CI), nunca pregunta** — se comporta como si fuera dry-run salvo que s
   "observacion": "string | null",
   "solicitud": { "...": "payload enviado a ARCA" },
   "previsualizacion": true,
-  "sugerencias": ["texto en español sugiriendo como resolver errores comunes de ARCA"]
+  "sugerencias": ["texto en español sugiriendo como resolver errores comunes de ARCA"],
+  "pdf": { "ruta": "/ruta/al/archivo.pdf" }
 }
 ```
 
+`pdf` aparece solo si se intentó generar el PDF. Si falló es `{ "error": { "codigo", "mensaje", "sugerencia" } }`
+(`PDF_PLUGIN_MISSING`, `PDF_PLUGIN_INSTALL_ERROR`, `PDF_ISSUER_INCOMPLETE`, `PDF_GENERATION_ERROR`) y el exit code
+sigue siendo `0`: el comprobante ya está emitido, **no reemitir para obtener el PDF**.
+
 Con múltiples comprobantes (batch o `--cargar` con array) la salida es un array de estos
 objetos. Con `--bruto` se agrega `respuesta` con la respuesta cruda del SDK.
 
@@ -153,6 +163,9 @@ Claves válidas: `cuit`, `cbu`, `aliasCbu` (solo facturas FCE), `verificarFce`,
 `si/no`, `1/0`), `cert.testing`, `cert.produccion`, `key.testing`, `key.produccion`
 (rutas a archivos PEM, se validan al guardar), `ticketPath` (carpeta donde se cachea el
 ticket WSAA; por defecto una carpeta junto al archivo de config).
+Para el PDF: `pdf` (`siempre`/`preguntar`/`nunca`), `pdfCarpeta` (por defecto `~/arcli/comprobantes`; los de
+testing van a `testing/`), `pdfNavegador` (ruta a Chrome/Chromium/Edge), `emisor.razonSocial`, `emisor.domicilio`,
+`emisor.inicioActividades` (fecha con año), `emisor.iibb`, `emisor.condicionIva`, `emisor.logo` (PNG o JPG).
 
 `config revisar` también avisa si un certificado ya venció o vence en menos de 30 días.
 
@@ -160,6 +173,7 @@ ticket WSAA; por defecto una carpeta junto al archivo de config).
 
 - `arcli ultimos <tipo> [--cantidad N] [--pv N] [--json]`: últimos comprobantes emitidos (de 1 a 50, por defecto 10), del más nuevo al más viejo. `tipo` es el atajo (`fb`, `nca`…).
 - `arcli consultar <tipo> <numero> [--pv N] [--json]`: detalle de un comprobante emitido (CAE, vencimiento, importes, receptor). Si no existe, el error es `VOUCHER_NOT_FOUND`. Sirve para verificar después de emitir.
+- `arcli pdf [estado|instalar|desinstalar] [--json]`: plugin que genera los PDFs. `arcli pdf instalar` lo descarga sin preguntar (sirve en scripts).
 - `arcli ejemplos`: comandos listos para copiar por cada tipo de comprobante.
 - `arcli storybook [escena]`: demos visuales de la UI (sin llamar a ARCA).
 - `arcli <cualquier comando> ayuda` o `--ayuda`: ayuda contextual con ejemplos (nota: el flag
@@ -171,4 +185,5 @@ ticket WSAA; por defecto una carpeta junto al archivo de config).
 - `docs/configuration.md`: config persistente, claves soportadas, ticketPath.
 - `docs/validation-rules.md` y `docs/input-output.md`: reglas de validación y formatos de entrada/salida.
 - `docs/troubleshooting.md`: errores comunes de ARCA y como resolverlos.
+- `docs/pdf.md`: PDF de comprobantes, plugin, carpeta y nombre del archivo.
 - `AGENTS.md`: para agentes que van a modificar el código de este repo (no para usar el CLI).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "CLI para previsualizar y emitir comprobantes ARCA desde terminal, con validaciones claras y salida lista para automatizar",
   "keywords": [
     "arca",