arcli 2.0.0 → 2.2.0

package/dist/services/arca/arca-export.gateway.js

@@ -0,0 +1,146 @@
+import { formatArcaDateAsArgentineDate } from '../../lib/dates/arca-date.js';
+import { AppError } from '../../lib/errors/app-error.js';
+const NOT_AUTHORIZED_MESSAGE = 'El certificado no está autorizado para el servicio wsfex (factura de exportación). Autorizalo igual que wsfe: en testing desde WSASS ("Crear autorización a servicio") y en producción desde el Administrador de Relaciones.';
+/** El XML de ARCA a veces trae un solo elemento donde el WSDL promete un array. */
+function asArray(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function readText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * La fecha de la cotizacion viene como `dd/mm/yyyy`; el resto del modulo trabaja con fechas ARCA (`yyyymmdd`).
+ * Si ARCA no la informa se descarta: la cotizacion igual sirve.
+ */
+function parseWsfexQuotationDate(value) {
+    const match = /^(\d{1,2})\/(\d{1,2})\/(\d{4})$/.exec(value);
+    return match ? `${match[3]}${match[2].padStart(2, '0')}${match[1].padStart(2, '0')}` : undefined;
+}
+/** WSFEX no lanza: devuelve `FEXErr` con codigo 0 cuando salio todo bien. */
+function assertNoError(result, operation) {
+    const error = result?.FEXErr;
+    if (error?.ErrCode) {
+        throw new AppError(`ARCA devolvió un error al consultar ${operation}: ${readText(error.ErrMsg) || error.ErrCode}`, {
+            code: 'ARCA_EXPORT_ERROR',
+            details: { errores: [{ codigo: error.ErrCode, mensaje: readText(error.ErrMsg) }] },
+        });
+    }
+}
+export class ArcaExportGateway {
+    arca;
+    constructor(arca) {
+        this.arca = arca;
+    }
+    /** Todas las llamadas autentican en WSAA: si el certificado no esta autorizado a wsfex, el error lo dice. */
+    async call(request) {
+        try {
+            return await request(this.arca.wsfexService);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('notAuthorized')) {
+                throw new AppError(NOT_AUTHORIZED_MESSAGE, { code: 'WSFEX_SERVICE_NOT_AUTHORIZED' });
+            }
+            throw error;
+        }
+    }
+    /**
+     * La unica llamada que emite. Un rechazo viene en `FEXResultAuth`, no como excepcion.
+     *
+     * El WSDL tipa `Permisos` como obligatorio, pero ARCA lo rechaza cuando `Permiso_existente` es `N` (error
+     * 1720) y en los tipos de exportacion 2 y 4 pide ese campo vacio (error 1550): sin permisos el `Cmp` no trae la
+     * clave y el serializador de SOAP omite los campos ausentes.
+     */
+    async authorize(payload) {
+        return this.call((service) => service.authorize({ Cmp: payload }));
+    }
+    /**
+     * La tabla de actividades de WSFEX es propia: tiene menos codigos que la del padron y el `Cmp` solo acepta los
+     * suyos. El WSDL no la tipa (devuelve `ClsFEXResponse_ActividadTipo`), asi que se lee como array tolerante.
+     */
+    async getActivities() {
+        const data = (await this.call((service) => service.getParamActividades({}))).FEXGetPARAM_ActividadesResult;
+        assertNoError(data, 'las actividades');
+        const rows = data?.FEXResultGet
+            ?.ClsFEXResponse_ActividadTipo;
+        return asArray(rows).flatMap((row) => {
+            const id = Number(row?.Id);
+            const name = readText(row?.Desc);
+            return Number.isInteger(id) && id > 0 ? [{ id, name }] : [];
+        });
+    }
+    async getCurrencies() {
+        const data = (await this.call((service) => service.getParamMon({}))).FEXGetPARAM_MONResult;
+        assertNoError(data, 'las monedas');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_Mon).flatMap((row) => {
+            const code = readText(row.Mon_Id);
+            return code ? [{ code, name: readText(row.Mon_Ds) }] : [];
+        });
+    }
+    async getDestinationCountries() {
+        const data = (await this.call((service) => service.getParamDstPais({}))).FEXGetPARAM_DST_paisResult;
+        assertNoError(data, 'los países de destino');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_DST_pais).flatMap((row) => {
+            const code = Number(row.DST_Codigo);
+            const name = readText(row.DST_Ds);
+            return Number.isInteger(code) && name ? [{ code, name }] : [];
+        });
+    }
+    async getDestinationCountryCuits() {
+        const data = (await this.call((service) => service.getParamDstCuit({}))).FEXGetPARAM_DST_CUITResult;
+        assertNoError(data, 'los CUIT de países');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_DST_cuit).flatMap((row) => {
+            const cuit = Number(row.DST_CUIT);
+            const countryName = readText(row.DST_Ds);
+            return Number.isInteger(cuit) && countryName ? [{ countryName, cuit }] : [];
+        });
+    }
+    async getIncoterms() {
+        const data = (await this.call((service) => service.getParamIncoterms({}))).FEXGetPARAM_IncotermsResult;
+        assertNoError(data, 'los incoterms');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_Inc).flatMap((row) => {
+            const code = readText(row.Inc_Id);
+            return code ? [{ code, name: readText(row.Inc_Ds) }] : [];
+        });
+    }
+    async getLanguages() {
+        const data = (await this.call((service) => service.getParamIdiomas({}))).FEXGetPARAM_IdiomasResult;
+        assertNoError(data, 'los idiomas');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_Idi).flatMap((row) => {
+            const id = Number(row.Idi_Id);
+            return Number.isInteger(id) ? [{ id, name: readText(row.Idi_Ds) }] : [];
+        });
+    }
+    async getUnits() {
+        const data = (await this.call((service) => service.getParamUMed({}))).FEXGetPARAM_UMedResult;
+        assertNoError(data, 'las unidades de medida');
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_UMed).flatMap((row) => {
+            const id = Number(row.Umed_Id);
+            return Number.isInteger(id) ? [{ id, name: readText(row.Umed_Ds) }] : [];
+        });
+    }
+    async getLastRequestId() {
+        const data = (await this.call((service) => service.getLastId({}))).FEXGetLast_IDResult;
+        assertNoError(data, 'el último ID de solicitud');
+        return Number(data?.FEXResultGet?.Id) || 0;
+    }
+    /**
+     * La cotizacion de la `E` es la de aduana, que WSFEX publica una vez por dia: `FEXGetPARAM_MON_CON_COTIZACION`
+     * devuelve por moneda la ultima publicada hasta `arcaDate`, con el dia al que corresponde. `Fecha_CTZ` va en
+     * `yyyymmdd`: con guiones ARCA contesta el error 2054.
+     */
+    async getQuotations(arcaDate) {
+        const data = (await this.call((service) => service.getParamMonConCotizacion({ Fecha_CTZ: arcaDate })))
+            .FEXGetPARAM_MON_CON_COTIZACIONResult;
+        assertNoError(data, `las cotizaciones al ${formatArcaDateAsArgentineDate(arcaDate)}`);
+        return asArray(data?.FEXResultGet?.ClsFEXResponse_Mon_CON_Cotizacion).flatMap((row) => {
+            const code = readText(row.Mon_Id);
+            const rate = Number(row.Mon_ctz);
+            return code && Number.isFinite(rate) && rate > 0
+                ? [{ code, date: parseWsfexQuotationDate(readText(row.Fecha_ctz)), rate }]
+                : [];
+        });
+    }
+}

package/dist/services/arca/arca-fce-obligation.gateway.js

@@ -1,5 +1,5 @@
 import { AppError } from '../../lib/errors/app-error.js';
-const NOT_AUTHORIZED_MESSAGE = 'El certificado no esta autorizado para el servicio wsfecred (Factura de Credito Electronica). Autoricelo igual que wsfe: en testing desde WSASS ("Crear autorizacion a servicio") y en produccion desde el Administrador de Relaciones.';
+const NOT_AUTHORIZED_MESSAGE = 'El certificado no está autorizado para el servicio wsfecred (Factura de Crédito Electrónica). Autorizalo igual que wsfe: en testing desde WSASS ("Crear autorizacion a servicio") y en producción desde el Administrador de Relaciones.';
 function toIsoDate(arcaDate) {
     return `${arcaDate.slice(0, 4)}-${arcaDate.slice(4, 6)}-${arcaDate.slice(6, 8)}`;
 }
@@ -25,7 +25,7 @@ export class ArcaFceObligationGateway {
         const result = output.consultarMontoObligadoRecepcionReturn;
         const errors = result.arrayErrores?.codigoDescripcion ?? [];
         if (errors.length > 0) {
-            throw new AppError(`ARCA no pudo informar si el receptor esta obligado a FCE: ${errors.map((item) => `${item.codigo} ${item.descripcion}`).join('; ')}`, { code: 'FCE_OBLIGATION_ERROR', details: { errors } });
+            throw new AppError(`ARCA no pudo informar si el receptor está obligado a FCE: ${errors.map((item) => `${item.codigo} ${item.descripcion}`).join('; ')}`, { code: 'FCE_OBLIGATION_ERROR', details: { errors } });
         }
         return {
             minimumAmount: Number(result.montoDesde ?? 0),
@@ -33,4 +33,3 @@ export class ArcaFceObligationGateway {
         };
     }
 }
-//# sourceMappingURL=arca-fce-obligation.gateway.js.map

package/dist/services/arca/arca-padron.gateway.js

@@ -0,0 +1,103 @@
+import { AppError } from '../../lib/errors/app-error.js';
+import { deriveIvaCondition, } from '../../modules/padron/padron.js';
+const NOT_AUTHORIZED_MESSAGE = 'El certificado no está autorizado para el servicio ws_sr_constancia_inscripcion (padrón). Autorizalo igual que wsfe: en testing desde WSASS ("Crear autorizacion a servicio") y en producción desde el Administrador de Relaciones.';
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function asArray(value) {
+    if (Array.isArray(value))
+        return value;
+    return value === undefined || value === null ? [] : [value];
+}
+function asText(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+function readName(general) {
+    const businessName = asText(general?.razonSocial);
+    if (businessName)
+        return businessName;
+    const fullName = [asText(general?.apellido), asText(general?.nombre)].filter(Boolean).join(' ');
+    return fullName || null;
+}
+function readAddress(general) {
+    const address = asRecord(general?.domicilioFiscal);
+    const parts = [
+        asText(address?.direccion),
+        asText(address?.localidad),
+        asText(address?.codPostal) ? `CP ${asText(address?.codPostal)}` : null,
+        asText(address?.descripcionProvincia),
+    ].filter(Boolean);
+    return parts.length > 0 ? parts.join(', ') : null;
+}
+function readTaxes(...sources) {
+    return sources.flatMap((source) => asArray(source?.impuesto).flatMap((item) => {
+        const tax = asRecord(item);
+        const id = Number(tax?.idImpuesto);
+        return Number.isInteger(id)
+            ? [
+                {
+                    active: (asText(tax?.estadoImpuesto) ?? 'AC') === 'AC',
+                    description: asText(tax?.descripcionImpuesto) ?? '',
+                    id,
+                },
+            ]
+            : [];
+    }));
+}
+function readActivities(...sources) {
+    return sources.flatMap((source) => asArray(source?.actividad ?? source?.actividadMonotributista).flatMap((item) => {
+        const activity = asRecord(item);
+        const id = Number(activity?.idActividad);
+        return Number.isInteger(id) ? [{ description: asText(activity?.descripcionActividad) ?? '', id }] : [];
+    }));
+}
+function readMonotributoCategory(monotributo) {
+    const category = monotributo?.categoriaMonotributo;
+    return asText(category) ?? asText(asRecord(category)?.descripcionCategoria);
+}
+function readNotices(details) {
+    return asArray(asRecord(details.errorConstancia)?.error).flatMap((item) => asText(item) ?? []);
+}
+function readPersonType(value) {
+    const type = asText(value)?.toUpperCase();
+    return type === 'FISICA' ? 'fisica' : type === 'JURIDICA' ? 'juridica' : null;
+}
+/** Arma un `Taxpayer` con la respuesta de `getTaxpayerDetails`. */
+export function mapTaxpayerDetails(cuit, raw) {
+    const details = asRecord(raw) ?? {};
+    const general = asRecord(details.datosGenerales);
+    const monotributo = asRecord(details.datosMonotributo);
+    const generalRegime = asRecord(details.datosRegimenGeneral);
+    const taxes = readTaxes(generalRegime, monotributo);
+    return {
+        activities: readActivities(generalRegime, monotributo),
+        address: readAddress(general),
+        cuit,
+        ivaCondition: deriveIvaCondition({ monotributo: Boolean(monotributo), taxes }),
+        keyStatus: asText(details.estadoClave) ?? asText(general?.estadoClave),
+        monotributoCategory: readMonotributoCategory(monotributo),
+        name: readName(general),
+        notices: readNotices(details),
+        personType: readPersonType(details.tipoPersona ?? general?.tipoPersona),
+        taxes,
+    };
+}
+export class ArcaPadronGateway {
+    arca;
+    constructor(arca) {
+        this.arca = arca;
+    }
+    async getTaxpayer(cuit) {
+        let details;
+        try {
+            details = await this.arca.registerInscriptionProofService.getTaxpayerDetails(cuit);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('notAuthorized')) {
+                throw new AppError(NOT_AUTHORIZED_MESSAGE, { code: 'PADRON_SERVICE_NOT_AUTHORIZED' });
+            }
+            throw error;
+        }
+        return details ? mapTaxpayerDetails(cuit, details) : null;
+    }
+}

package/dist/services/arca/arca-parameters.gateway.js

@@ -5,7 +5,7 @@ const NO_RESULTS_CODE = 602;
 function readRows(result, key, operation) {
     const errors = result.errors?.err ?? [];
     if (errors.some((error) => error.code !== NO_RESULTS_CODE)) {
-        throw new AppError(`ARCA devolvio un error al consultar ${operation}: ${errors.map((e) => e.msg).join('; ')}`, {
+        throw new AppError(`ARCA devolvió un error al consultar ${operation}: ${errors.map((e) => e.msg).join('; ')}`, {
             code: 'ARCA_PARAMETERS_ERROR',
             details: { errores: errors },
         });
@@ -45,7 +45,7 @@ export class ArcaParametersGateway {
         const result = await this.arca.electronicBillingService.getQuotation(code);
         const rate = result.resultGet?.monCotiz;
         if (typeof rate !== 'number' || rate <= 0) {
-            throw new AppError(`ARCA no devolvio una cotizacion para ${currency}.`, {
+            throw new AppError(`ARCA no devolvió una cotización para ${currency}.`, {
                 code: 'ARCA_QUOTATION_ERROR',
                 details: { errors: result.errors },
             });
@@ -68,4 +68,3 @@ export class ArcaParametersGateway {
         return readRows(result, key, table).map(toEntry);
     }
 }
-//# sourceMappingURL=arca-parameters.gateway.js.map

package/dist/services/arca/arca-voucher-history.gateway.js

@@ -1,11 +1,11 @@
+import { getLastAuthorizedNumber } from './last-voucher.js';
 export class ArcaVoucherHistoryGateway {
     arca;
     constructor(arca) {
         this.arca = arca;
     }
     async getLastNumber(pointOfSale, voucherType) {
-        const result = await this.arca.electronicBillingService.getLastVoucher(pointOfSale, voucherType);
-        return result.cbteNro ?? 0;
+        return getLastAuthorizedNumber(this.arca, pointOfSale, voucherType);
     }
     async getVoucher(number, pointOfSale, voucherType) {
         const info = await this.arca.electronicBillingService.getVoucherInfo(number, pointOfSale, voucherType);
@@ -33,4 +33,3 @@ export class ArcaVoucherHistoryGateway {
         };
     }
 }
-//# sourceMappingURL=arca-voucher-history.gateway.js.map

package/dist/services/arca/last-voucher.js

@@ -0,0 +1,26 @@
+import { AppError } from '../../lib/errors/app-error.js';
+import { POINT_OF_SALE_GUIDE_URL } from '../../lib/links.js';
+/**
+ * WSFEv1 11002: el punto de venta no esta habilitado para el web service.
+ * 10005 es el mismo problema cuando ARCA lo informa al emitir.
+ */
+const POINT_OF_SALE_ERROR_CODES = new Set([10005, 11002]);
+/**
+ * Pide el ultimo numero autorizado y corta si ARCA devolvio errores.
+ * El SDK los deja en `errors` y no lanza: sin este chequeo, un punto de venta invalido parece no tener comprobantes.
+ */
+export async function getLastAuthorizedNumber(arca, pointOfSale, voucherType) {
+    const result = await arca.electronicBillingService.getLastVoucher(pointOfSale, voucherType);
+    const errors = result.errors?.err ?? [];
+    if (errors.length > 0) {
+        const pointOfSaleProblem = errors.some((error) => POINT_OF_SALE_ERROR_CODES.has(error.code));
+        throw new AppError(`ARCA devolvió un error al pedir el último comprobante del punto de venta ${pointOfSale}: ${errors.map((error) => `${error.code} ${error.msg}`).join('; ')}`, {
+            code: 'ARCA_LAST_VOUCHER_ERROR',
+            details: { errores: errors },
+            suggestion: pointOfSaleProblem
+                ? `El punto de venta no está habilitado para web service (los de "Factura en línea" no sirven). Revisá los habilitados con arcli parametros puntos-venta o creá uno para web service: ${POINT_OF_SALE_GUIDE_URL}`
+                : 'No se emitió nada. Revisá el mensaje de ARCA y reintentá.',
+        });
+    }
+    return result.cbteNro ?? 0;
+}

package/dist/services/clipboard/clipboard.js

@@ -14,4 +14,3 @@ export function copyToClipboard(text, platform = process.platform) {
         return !result.error && result.status === 0;
     });
 }
-//# sourceMappingURL=clipboard.js.map

package/dist/services/pdf/escape-html.js

@@ -22,4 +22,3 @@ export function escapeHtmlStrings(value) {
     }
     return value;
 }
-//# sourceMappingURL=escape-html.js.map

package/dist/services/pdf/pdf-browser.js

@@ -51,4 +51,3 @@ export function findDownloadedBrowser(cacheDir) {
     }
     return undefined;
 }
-//# sourceMappingURL=pdf-browser.js.map

package/dist/services/pdf/pdf-exporter.js

@@ -1,8 +1,9 @@
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { mkdirSync, readFileSync } from 'node:fs';
 import { extname, join } from 'node:path';
 import { AppError } from '../../lib/errors/app-error.js';
+import { writeNewFile } from '../../lib/files/write-new-file.js';
 import { PdfError } from '../../modules/pdf/pdf.errors.js';
-import { mapBillingResultToPdfData } from '../../modules/pdf/pdf-data.mapper.js';
+import { mapBillingResultToPdfData, mapExportResultToPdfData } from '../../modules/pdf/pdf-data.mapper.js';
 import { buildPdfFileName } from '../../modules/pdf/pdf-file-name.js';
 import { resolvePdfIssuer } from '../../modules/pdf/pdf-issuer.js';
 import { escapeHtmlStrings } from './escape-html.js';
@@ -25,11 +26,14 @@ function readLogoAsDataUrl(path) {
     const mime = extname(path).toLowerCase() === '.png' ? 'image/png' : 'image/jpeg';
     return `data:${mime};base64,${readFileSync(path).toString('base64')}`;
 }
-/** Los de testing van a una subcarpeta y con un pie que avisa que no valen, para no mezclarlos con los reales. */
-export function resolvePdfTargetFolder(folder, environment) {
-    return environment === 'testing' ? join(folder, 'testing') : folder;
+/**
+ * Una subcarpeta por CUIT emisor, para que dos emisores con el mismo punto de venta y numero no se pisen. Los de
+ * testing van ademas a `testing/` y con un pie que avisa que no valen, para no mezclarlos con los reales.
+ */
+export function resolvePdfTargetFolder(folder, environment, cuit) {
+    return environment === 'testing' ? join(folder, 'testing', cuit) : join(folder, cuit);
 }
-/** Genera y guarda el PDF de un comprobante emitido. Devuelve la ruta del archivo. */
+/** Genera y guarda el PDF de un comprobante emitido, sin pisar uno existente. Devuelve la ruta del archivo. */
 export async function exportBillingPdf(input) {
     const { result } = input;
     const issuer = resolvePdfIssuer(input.config, result.voucherKind.letter);
@@ -39,10 +43,21 @@ export async function exportBillingPdf(input) {
         logo: readLogoAsDataUrl(input.config.emisor.logo),
     };
     const bytes = await input.renderer.render(escapeHtmlStrings(data), options);
-    const folder = resolvePdfTargetFolder(input.folder, result.environment);
-    const path = join(folder, buildPdfFileName(result.voucherKind, data.puntoVenta, data.cbteDesde));
+    const folder = resolvePdfTargetFolder(input.folder, result.environment, issuer.cuit);
     mkdirSync(folder, { recursive: true });
-    writeFileSync(path, bytes);
-    return path;
+    return writeNewFile(join(folder, buildPdfFileName(result.voucherKind, data.puntoVenta, data.cbteDesde)), bytes);
+}
+/** Igual que `exportBillingPdf`, con el detalle real de WSFEX y el CUIT del pais del cliente. */
+export async function exportExportacionPdf(input) {
+    const { result } = input;
+    const issuer = resolvePdfIssuer(input.config, result.voucherKind.letter);
+    const data = mapExportResultToPdfData(result, issuer, input.extras);
+    const options = {
+        footerText: result.environment === 'testing' ? TESTING_FOOTER : undefined,
+        logo: readLogoAsDataUrl(input.config.emisor.logo),
+    };
+    const bytes = await input.renderer.render(escapeHtmlStrings(data), options);
+    const folder = resolvePdfTargetFolder(input.folder, result.environment, issuer.cuit);
+    mkdirSync(folder, { recursive: true });
+    return writeNewFile(join(folder, buildPdfFileName(result.voucherKind, data.puntoVenta, data.cbteDesde)), bytes);
 }
-//# sourceMappingURL=pdf-exporter.js.map

package/dist/services/pdf/pdf-plugin.js

@@ -7,15 +7,33 @@ import { findDownloadedBrowser, findSystemBrowser } from './pdf-browser.js';
 export const PDF_PLUGIN_PACKAGE = '@arcasdk/pdf';
 /** Version probada con arcli. Se sube a mano despues de revisar los PDFs que genera. */
 export const PDF_PLUGIN_VERSION = '0.2.1';
-const runProcessWithSpawn = (command, args, options) => new Promise((resolve) => {
+/** Limites de la instalacion: con un proxy colgado, npm o la descarga no terminan nunca. */
+export const NPM_INSTALL_TIMEOUT_MS = 5 * 60_000;
+export const BROWSER_DOWNLOAD_TIMEOUT_MS = 15 * 60_000;
+export const runProcessWithSpawn = (command, args, options) => new Promise((resolve) => {
     // En Windows npm es un .cmd y necesita shell.
     const child = spawn(command, args, { cwd: options.cwd, env: options.env, shell: process.platform === 'win32' });
     let output = '';
+    const timer = setTimeout(() => {
+        child.kill();
+        // Con shell, el kill no llega a los nietos y sus pipes mantendrian vivo el proceso: se sueltan.
+        child.stdout.destroy();
+        child.stderr.destroy();
+        child.unref();
+        resolve({ code: null, output, timedOut: true });
+    }, options.timeoutMs);
+    const finish = (result) => {
+        clearTimeout(timer);
+        resolve(result);
+    };
     child.stdout.on('data', (chunk) => (output += chunk.toString()));
     child.stderr.on('data', (chunk) => (output += chunk.toString()));
-    child.on('error', (error) => resolve({ code: 1, output: `${output}${error.message}` }));
-    child.on('close', (code) => resolve({ code, output }));
+    child.on('error', (error) => finish({ code: 1, output: `${output}${error.message}` }));
+    child.on('close', (code) => finish({ code, output }));
 });
+function describeTimeout(timeoutMs) {
+    return `no termino en ${timeoutMs / 60_000} minutos y se corto`;
+}
 function lastLines(output, count = 5) {
     return output.trim().split('\n').slice(-count).join('\n');
 }
@@ -86,11 +104,14 @@ export class PdfPlugin {
                 '--no-audit',
                 '--no-fund',
                 '--save-exact',
-            ], { cwd: this.options.path, env: this.env });
+            ], { cwd: this.options.path, env: this.env, timeoutMs: NPM_INSTALL_TIMEOUT_MS });
             if (result.code !== 0) {
-                throw new PdfError('PDF_PLUGIN_INSTALL_ERROR', `npm no pudo instalar ${PDF_PLUGIN_PACKAGE}.`, {
+                const message = result.timedOut
+                    ? `La instalación de ${PDF_PLUGIN_PACKAGE} ${describeTimeout(NPM_INSTALL_TIMEOUT_MS)}.`
+                    : `npm no pudo instalar ${PDF_PLUGIN_PACKAGE}.`;
+                throw new PdfError('PDF_PLUGIN_INSTALL_ERROR', message, {
                     details: { salida: lastLines(result.output) },
-                    suggestion: 'Revise la conexion a internet o el proxy de npm y vuelva a correr `arcli pdf instalar`.',
+                    suggestion: 'Revisá la conexión a internet o el proxy de npm y volvé a correr `arcli pdf instalar`.',
                 });
             }
         }
@@ -98,11 +119,18 @@ export class PdfPlugin {
             onStep('Descargando el navegador para generar PDFs (unos 200 MB)...');
             const require = createRequire(join(this.options.path, 'package.json'));
             const puppeteerCli = join(require.resolve('puppeteer/package.json'), '..', 'lib', 'puppeteer', 'node', 'cli.js');
-            const result = await this.runProcess(process.execPath, [puppeteerCli, 'browsers', 'install', 'chrome-headless-shell'], { cwd: this.options.path, env: { ...this.env, PUPPETEER_CACHE_DIR: this.browsersPath } });
+            const result = await this.runProcess(process.execPath, [puppeteerCli, 'browsers', 'install', 'chrome-headless-shell'], {
+                cwd: this.options.path,
+                env: { ...this.env, PUPPETEER_CACHE_DIR: this.browsersPath },
+                timeoutMs: BROWSER_DOWNLOAD_TIMEOUT_MS,
+            });
             if (result.code !== 0 || !findDownloadedBrowser(this.browsersPath)) {
-                throw new PdfError('PDF_PLUGIN_INSTALL_ERROR', 'No se pudo descargar el navegador para generar PDFs.', {
+                const message = result.timedOut
+                    ? `La descarga del navegador para generar PDFs ${describeTimeout(BROWSER_DOWNLOAD_TIMEOUT_MS)}.`
+                    : 'No se pudo descargar el navegador para generar PDFs.';
+                throw new PdfError('PDF_PLUGIN_INSTALL_ERROR', message, {
                     details: { salida: lastLines(result.output) },
-                    suggestion: 'Si ya tiene Chrome, Chromium o Edge, indique su ruta con `arcli config establecer pdfNavegador <ruta>`.',
+                    suggestion: 'Si ya tiene Chrome, Chromium o Edge, indicá su ruta con `arcli config establecer pdfNavegador <ruta>`.',
                 });
             }
         }
@@ -115,13 +143,13 @@ export class PdfPlugin {
         const installedVersion = this.readInstalledVersion();
         if (installedVersion !== PDF_PLUGIN_VERSION) {
             throw new PdfError('PDF_PLUGIN_MISSING', installedVersion
-                ? `El plugin de PDF esta en la version ${installedVersion} y arcli usa la ${PDF_PLUGIN_VERSION}.`
+                ? `El plugin de PDF está en la versión ${installedVersion} y arcli usa la ${PDF_PLUGIN_VERSION}.`
                 : 'Para generar PDFs falta instalar el plugin de PDF.', { suggestion: PDF_INSTALL_SUGGESTION });
         }
         const browser = this.resolveBrowser();
         if (!browser) {
-            throw new PdfError('PDF_PLUGIN_MISSING', 'No se encontro un navegador para generar PDFs.', {
-                suggestion: `${PDF_INSTALL_SUGGESTION} Descarga uno, o indique Chrome con \`arcli config establecer pdfNavegador <ruta>\`.`,
+            throw new PdfError('PDF_PLUGIN_MISSING', 'No se encontró un navegador para generar PDFs.', {
+                suggestion: `${PDF_INSTALL_SUGGESTION} Descarga uno, o indicá Chrome con \`arcli config establecer pdfNavegador <ruta>\`.`,
             });
         }
         // El SDK no deja elegir el ejecutable; Puppeteer lo toma de esta variable.
@@ -134,10 +162,9 @@ export class PdfPlugin {
                     return await new sdk.InvoicePdfGenerator(options).generate(data);
                 }
                 catch (error) {
-                    throw new PdfError('PDF_GENERATION_ERROR', `No se pudo generar el PDF: ${error instanceof Error ? error.message : String(error)}`, { suggestion: 'Si el navegador falla, pruebe con otro: `arcli config establecer pdfNavegador <ruta>`.' });
+                    throw new PdfError('PDF_GENERATION_ERROR', `No se pudo generar el PDF: ${error instanceof Error ? error.message : String(error)}`, { suggestion: 'Si el navegador falla, probá con otro: `arcli config establecer pdfNavegador <ruta>`.' });
                 }
             },
         };
     }
 }
-//# sourceMappingURL=pdf-plugin.js.map

package/dist/ui/components/certificateBanner.js

@@ -0,0 +1,8 @@
+import { noticePanel } from './noticePanel.js';
+/**
+ * Aviso del certificado por vencer (amarillo) o vencido (rojo), con el link en su propia linea para que no se
+ * corte. Unico lugar que lo arma: lo usan los comandos, el modo interactivo y el storybook.
+ */
+export function certificateBanner({ expired, guideUrl, summary }) {
+    return noticePanel(`${summary}\nRenovalo: ${guideUrl}`, expired ? 'danger' : 'warning', 'warning');
+}

package/dist/ui/components/contentPanel.js

@@ -9,4 +9,3 @@ export function contentPanel(title, content, width = 'wide', titleColor, content
         width,
     });
 }
-//# sourceMappingURL=contentPanel.js.map

package/dist/ui/components/errorPanel.js

@@ -10,4 +10,3 @@ export function errorPanel(title, message, details = [], hint) {
     }
     return contentPanel(title, lines.join('\n'), 'standard', 'danger', 'left', 'error');
 }
-//# sourceMappingURL=errorPanel.js.map

package/dist/ui/components/index.js

@@ -1,3 +1,4 @@
+export * from './certificateBanner.js';
 export * from './contentPanel.js';
 export * from './errorPanel.js';
 export * from './keyValuePanel.js';
@@ -7,4 +8,3 @@ export * from './sectionHeading.js';
 export * from './statusBar.js';
 export * from './statusPanel.js';
 export * from './testingBanner.js';
-//# sourceMappingURL=index.js.map

package/dist/ui/components/keyValuePanel.js

@@ -12,4 +12,3 @@ export function keyValuePanel(title, rows, footer, width = 'standard', titleColo
         width,
     });
 }
-//# sourceMappingURL=keyValuePanel.js.map

package/dist/ui/components/noticePanel.js

@@ -8,4 +8,3 @@ export function noticePanel(message, color = 'info', borderType = 'note') {
         width: 'compact',
     });
 }
-//# sourceMappingURL=noticePanel.js.map

package/dist/ui/components/rawPanel.js

@@ -2,4 +2,3 @@ import { contentPanel } from './contentPanel.js';
 export function rawPanel(title, content) {
     return contentPanel(title, content, 'wide', 'subtle', 'left', 'data');
 }
-//# sourceMappingURL=rawPanel.js.map

package/dist/ui/components/sectionHeading.js

@@ -10,4 +10,3 @@ export function sectionHeading(title, color) {
     const rest = Math.max(2, width - 2 - stripAnsi(label).length);
     return `${colorize(fill.repeat(2), 'muted')}${label}${colorize(fill.repeat(rest), 'muted')}`;
 }
-//# sourceMappingURL=sectionHeading.js.map

package/dist/ui/components/statusBar.js

@@ -30,4 +30,3 @@ export function statusBar(left, right = [], options = {}) {
         colorize(fill.repeat(2), 'muted'),
     ].join('');
 }
-//# sourceMappingURL=statusBar.js.map

package/dist/ui/components/statusPanel.js

@@ -18,4 +18,3 @@ export function statusPanel(title, rows, footer, width = 'standard', titleColor,
         width,
     });
 }
-//# sourceMappingURL=statusPanel.js.map

package/dist/ui/components/testingBanner.js

@@ -3,4 +3,3 @@ import { noticePanel } from './noticePanel.js';
 export function testingBanner() {
     return noticePanel('Estas utilizando el entorno de TESTING', 'warning', 'warning');
 }
-//# sourceMappingURL=testingBanner.js.map

package/dist/ui/index.js

@@ -3,4 +3,3 @@ export * from './presenters/index.js';
 export * from './primitives/index.js';
 export * from './stream/index.js';
 export * from './theme/index.js';
-//# sourceMappingURL=index.js.map

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

@@ -1,2 +1 @@
 export { formatBillingResultAsJson, formatBillingResultAsText } from '../../modules/billing/billing.presenter.js';
-//# sourceMappingURL=billing.presenter.js.map

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

@@ -1,2 +1 @@
-export { formatConfig, formatConfigAsText, formatConfigDoctor, formatConfigDoctorAsText, formatConfigPath, } from '../../modules/config/config.presenter.js';
-//# sourceMappingURL=config.presenter.js.map
+export { formatConfig, formatConfigAsText, formatConfigDoctor, formatConfigDoctorAsText, formatConfigPath, formatConfigPathAsJson, } from '../../modules/config/config.presenter.js';