arcli 2.1.0 → 2.2.1

package/dist/cli/commands/export.command.parser.js

@@ -0,0 +1,84 @@
+import { InputValidationError } from '../../lib/errors/app-error.js';
+import { readJsonFile } from '../../lib/files/read-json-file.js';
+import { mapExportJsonItems, readExportJsonInput } from '../../modules/export/export.json-input.js';
+function pickString(...values) {
+    return values.find((value) => typeof value === 'string');
+}
+function pickNumber(...values) {
+    return values.find((value) => typeof value === 'number');
+}
+function pickBoolean(...values) {
+    return values.find((value) => typeof value === 'boolean');
+}
+function pickItems(flagsValue, fileItems) {
+    return Array.isArray(flagsValue) && flagsValue.length > 0 ? flagsValue : fileItems;
+}
+function pickList(flagsValue, fileValue) {
+    return Array.isArray(flagsValue) && flagsValue.length > 0 ? flagsValue : fileValue?.slice();
+}
+/** `--emitir` y `--previsualizar` deciden juntos, y el archivo de `--cargar` puede traer `emitir`. */
+function resolveEmitDecision(flags, file, defaults) {
+    if (flags.emitir && flags.previsualizar) {
+        throw new InputValidationError('Usá --emitir o --previsualizar, no los dos.');
+    }
+    if (flags.emitir !== undefined) {
+        return { emit: flags.emitir, modeSource: 'flags' };
+    }
+    if (flags.previsualizar !== undefined) {
+        return { emit: !flags.previsualizar, modeSource: 'flags' };
+    }
+    if (file?.emitir !== undefined) {
+        return { emit: file.emitir, modeSource: 'file' };
+    }
+    if (file?.previsualizar !== undefined) {
+        return { emit: !file.previsualizar, modeSource: 'file' };
+    }
+    return { emit: defaults.defaultEmit ?? false, modeSource: 'default' };
+}
+/** Los flags ganan sobre el JSON de `--cargar`, igual que en facturacion. */
+export function parseExportCommandPlan(command, defaults = {}) {
+    const options = command.optsWithGlobals();
+    const filePath = typeof options.cargar === 'string' ? options.cargar : undefined;
+    const file = filePath ? readExportJsonInput(readJsonFile(filePath)) : undefined;
+    const { emit, modeSource } = resolveEmitDecision({ emitir: pickBoolean(options.emitir), previsualizar: pickBoolean(options.previsualizar) }, file, defaults);
+    const destination = pickString(options.paisDestino, file?.paisDestino) ?? pickNumber(options.paisDestino, file?.paisDestino);
+    const currency = pickString(options.moneda, options.mda, file?.codigoMoneda);
+    const pdf = pickBoolean(options.exportarPdf, options.pdf) ?? (pickBoolean(options.sinPdf) === true ? false : undefined);
+    return {
+        input: {
+            activity: pickNumber(options.actividad, file?.actividad),
+            amount: pickNumber(options.monto, file?.monto),
+            clientAddress: pickString(options.domicilioCliente, file?.domicilioCliente),
+            clientCountryCuit: pickNumber(options.cuitPais, file?.cuitPais),
+            clientName: pickString(options.cliente, file?.cliente),
+            clientTaxId: pickString(options.idImpositivo, file?.idImpositivo),
+            commercialObservations: pickString(options.obsComerciales, file?.observacionesComerciales),
+            currencyCode: currency,
+            description: pickString(options.descripcion, file?.descripcion),
+            destinationCountry: destination === undefined ? undefined : String(destination),
+            emit,
+            exchangeRate: pickNumber(options.cotizacionMoneda, options.cm, file?.cotizacionMoneda),
+            exportType: pickNumber(options.tipoExpo, file?.tipoExpo),
+            incoterm: pickString(options.incoterm, file?.incoterm),
+            incotermDescription: pickString(options.incotermsDesc, file?.descripcionIncoterm),
+            items: pickItems(options.item, mapExportJsonItems(file?.items)),
+            language: pickNumber(options.idioma, file?.idioma),
+            modeSource,
+            observations: pickString(options.observaciones, file?.observaciones),
+            paymentDate: pickString(options.fechaPago, file?.fechaPago),
+            paymentTerms: pickString(options.formaPago, file?.formaPago),
+            pdf,
+            permits: pickList(options.permiso, file?.permisos),
+            permitsExisting: pickBoolean(options.permisoExistente, file?.permisoExistente),
+            pointOfSale: pickNumber(options.puntoVenta, options.pv, file?.puntoVenta),
+            requestId: pickNumber(options.idSolicitud, file?.idSolicitud),
+            sameCurrency: pickBoolean(options.mismaMoneda, file?.mismaMoneda),
+            voucherDate: pickString(options.fecha, file?.fechaComprobante),
+            voucherNumber: pickNumber(options.numero, file?.numero),
+        },
+        modeSource,
+    };
+}
+export function parseExportCommandInput(command, defaults = {}) {
+    return parseExportCommandPlan(command, defaults).input;
+}

package/dist/cli/commands/export.command.pdf.js

@@ -0,0 +1,61 @@
+import { resolvePdfDecision } from '../../modules/pdf/pdf-decision.js';
+import { resolvePdfIssuer } from '../../modules/pdf/pdf-issuer.js';
+import { exportExportacionPdf, toPdfFailure } from '../../services/pdf/pdf-exporter.js';
+import { isPromptCancellation } from '../interactive/prompts.js';
+import { startSpinner } from '../spinner.js';
+import { defaultPdfStepDependencies, loadPdfRenderer } from './billing.command.pdf.js';
+/** Sin CAE no hay PDF: ni en vista previa ni en rechazados. */
+function canHavePdf(result) {
+    return !result.dryRun && result.response.status !== 'rechazado' && Boolean(result.response.cae);
+}
+async function ask(deps, message, yesLabel) {
+    try {
+        return await deps.confirm(message, yesLabel, 'No');
+    }
+    catch (error) {
+        // El comprobante ya se emitio: Ctrl+C en la pregunta del PDF es "No", no un error del comando.
+        if (isPromptCancellation(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+/**
+ * Genera el PDF del comprobante emitido. Nunca lanza: el comprobante ya esta emitido, asi que un error del PDF
+ * se devuelve en `pdf.error` y no cambia el codigo de salida.
+ */
+export async function attachExportPdf(result, options, deps = defaultPdfStepDependencies) {
+    if (!canHavePdf(result)) {
+        return result;
+    }
+    const decision = resolvePdfDecision({
+        flag: options.input.pdf,
+        interactive: options.interactive,
+        mode: options.config.pdf,
+    });
+    if (decision === 'omitir') {
+        return result;
+    }
+    if (decision === 'preguntar' && !(await ask(deps, '¿Generamos el PDF del comprobante?', 'Si, generar el PDF'))) {
+        return result;
+    }
+    const spinner = startSpinner('Generando PDF...');
+    try {
+        // Antes de descargar nada: sin los datos del emisor no se puede armar el PDF.
+        resolvePdfIssuer(options.config, result.voucherKind.letter);
+        const renderer = await loadPdfRenderer(deps.createPlugin(options.config), options.interactive, deps);
+        const path = await exportExportacionPdf({
+            config: options.config,
+            folder: deps.resolveFolder(options.config),
+            renderer,
+            result,
+        });
+        return { ...result, pdf: { path } };
+    }
+    catch (error) {
+        return { ...result, pdf: toPdfFailure(error) };
+    }
+    finally {
+        spinner?.stop();
+    }
+}

package/dist/cli/commands/fce-obligation.command.js

@@ -12,8 +12,8 @@ export function registerFceObligationCommand(program) {
     const command = program
         .command('fce-obligado')
         .argument('<cuit>', 'CUIT del receptor a consultar')
-        .description('consultar si un receptor esta obligado a recibir Factura de Credito Electronica (FCE)')
-        .option('-f, --fecha <fecha>', 'fecha de emision a consultar; por defecto hoy')
+        .description('consultar si un receptor está obligado a recibir Factura de Crédito Electrónica (FCE)')
+        .option('-f, --fecha <fecha>', 'fecha de emisión a consultar; por defecto hoy')
         .addHelpText('after', createFceObligationHelp());
     registerQueryOptions(command);
     configureSpanishHelp(command);
@@ -41,4 +41,3 @@ export function registerFceObligationCommand(program) {
         }
     });
 }
-//# sourceMappingURL=fce-obligation.command.js.map

package/dist/cli/commands/interactive.command.js

@@ -8,17 +8,16 @@ export function isInteractiveTerminal() {
 export function registerInteractiveCommand(program) {
     const command = program
         .command('interactivo')
-        .description('asistente paso a paso para emitir comprobantes; tambien se abre con "arcli" sin argumentos');
+        .description('asistente paso a paso para emitir comprobantes; también se abre con "arcli" sin argumentos');
     // Solo el entorno: el asistente no tiene salida JSON ni respuesta bruta.
     registerEnvironmentOptions(command);
     configureSpanishHelp(command);
     command.action(async (_options, self) => {
         if (!isInteractiveTerminal()) {
-            throw new InputValidationError('El modo interactivo necesita una terminal interactiva. Use los comandos con flags.');
+            throw new InputValidationError('El modo interactivo necesita una terminal interactiva. Usá los comandos con flags.');
         }
         // `--json` y `--bruto` se ignoran con un aviso: al asistente le llega solo el entorno.
         const { produccion, testing } = getGlobalOptions(self);
         await runInteractiveMode({ produccion, testing });
     });
 }
-//# sourceMappingURL=interactive.command.js.map

package/dist/cli/commands/padron.command.js

@@ -12,23 +12,23 @@ export function registerPadronCommand(program) {
     const command = program
         .command('padron')
         .argument('<cuit>', 'CUIT a consultar')
-        .description('consultar en el padron de ARCA el nombre, domicilio y condicion IVA de un CUIT')
+        .description('consultar en el padrón de ARCA el nombre, domicilio y condición IVA de un CUIT')
         .addHelpText('after', createPadronHelp());
     registerQueryOptions(command);
     configureSpanishHelp(command);
     command.action(async (rawCuit, _options, self) => {
         const cuit = parseCuitArgument(rawCuit);
         const runtime = resolveArcaRuntime(getGlobalOptions(self));
-        const spinner = runtime.outputJson ? null : startSpinner('Consultando el padron...');
+        const spinner = runtime.outputJson ? null : startSpinner('Consultando el padrón...');
         try {
             const taxpayer = await new ArcaPadronGateway(new ArcaClientFactory().create(runtime)).getTaxpayer(cuit);
             spinner?.stop();
             if (!taxpayer) {
-                throw new AppError(`El CUIT ${cuit} no figura en el padron de ARCA (${runtime.environment}).`, {
+                throw new AppError(`El CUIT ${cuit} no figura en el padrón de ARCA (${runtime.environment}).`, {
                     code: 'TAXPAYER_NOT_FOUND',
                     suggestion: runtime.environment === 'testing'
-                        ? 'El padron de testing tiene datos ficticios: pruebe con 20201797064.'
-                        : 'Revise el numero.',
+                        ? 'El padrón de testing tiene datos ficticios: probá con 20201797064.'
+                        : 'Revisá el número.',
                 });
             }
             const report = { environment: runtime.environment, taxpayer };
@@ -44,4 +44,3 @@ export function registerPadronCommand(program) {
         }
     });
 }
-//# sourceMappingURL=padron.command.js.map

package/dist/cli/commands/parameters.command.js

@@ -34,8 +34,8 @@ export function registerParametersCommands(program) {
     const parameters = program
         .command('parametros')
         .argument('[tabla]', 'tabla a consultar; sin tabla lista las disponibles')
-        .argument('[moneda]', 'solo para "cotizacion": codigo de moneda, por ejemplo USD')
-        .description('consultar tablas de ARCA: puntos de venta, tipos, alicuotas, monedas y cotizacion');
+        .argument('[moneda]', 'solo para "cotizacion": código de moneda, por ejemplo USD')
+        .description('consultar tablas de ARCA: puntos de venta, tipos, alícuotas, monedas y cotización');
     registerQueryOptions(parameters);
     configureSpanishHelp(parameters);
     parameters.action(async (rawTable, currency, _options, self) => {
@@ -52,7 +52,7 @@ export function registerParametersCommands(program) {
         }
         if (rawTable.trim().toLowerCase() === 'cotizacion') {
             if (!currency) {
-                throw new InputValidationError('Indique la moneda, por ejemplo: arcli parametros cotizacion USD.');
+                throw new InputValidationError('Indicá la moneda, por ejemplo: arcli parametros cotizacion USD.');
             }
             const { gateway, runtime } = createContext(self);
             const quotation = await withSpinner(runtime, () => gateway.getQuotation(currency));
@@ -68,7 +68,7 @@ export function registerParametersCommands(program) {
     });
     const status = program
         .command('estado')
-        .description('ver si ARCA responde y si el punto de venta configurado esta habilitado');
+        .description('ver si ARCA responde y si el punto de venta configurado está habilitado');
     registerQueryOptions(status);
     configureSpanishHelp(status);
     status.action(async (_options, self) => {
@@ -78,7 +78,7 @@ export function registerParametersCommands(program) {
                 return await buildStatusReport({ environment: runtime.environment, gateway, pointOfSale: runtime.pointOfSale });
             }
             catch (error) {
-                throw new AppError(`ARCA no respondio: ${error instanceof Error ? error.message : String(error)}`, {
+                throw new AppError(`ARCA no respondió: ${error instanceof Error ? error.message : String(error)}`, {
                     code: 'ARCA_UNAVAILABLE',
                 });
             }
@@ -86,4 +86,3 @@ export function registerParametersCommands(program) {
         write(runtime, formatStatusAsText(report), formatStatusAsJson(report));
     });
 }
-//# sourceMappingURL=parameters.command.js.map

package/dist/cli/commands/pdf.command.js

@@ -29,7 +29,7 @@ function printStatus({ json, plugin }, title) {
 export function registerPdfCommand(program) {
     const pdfCommand = registerJsonOption(program.command('pdf').description('instalar o revisar el plugin que genera los PDFs de los comprobantes')).action((_options, command) => printStatus(createContext(command)));
     configureSpanishHelp(pdfCommand);
-    const estadoCommand = registerJsonOption(pdfCommand.command('estado').description('mostrar si el plugin esta instalado, su version y el navegador que usa')).action((_options, command) => printStatus(createContext(command)));
+    const estadoCommand = registerJsonOption(pdfCommand.command('estado').description('mostrar si el plugin está instalado, su versión y el navegador que usa')).action((_options, command) => printStatus(createContext(command)));
     configureSpanishHelp(estadoCommand);
     // Pedir el comando ya es la confirmacion: no se vuelve a preguntar, asi tambien sirve en scripts.
     const instalarCommand = registerJsonOption(pdfCommand
@@ -62,4 +62,3 @@ export function registerPdfCommand(program) {
     });
     configureSpanishHelp(desinstalarCommand);
 }
-//# sourceMappingURL=pdf.command.js.map

package/dist/cli/commands/storybook.command.js

@@ -12,16 +12,16 @@ const STORYBOOK_SCENES = [
 ];
 export function registerStorybookCommand(program) {
     const command = program
-        .command('storybook')
+        // Herramienta de desarrollo: funciona, pero no se lista en la ayuda.
+        .command('storybook', { hidden: true })
         .description('ver escenas visuales del CLI con datos de ejemplo')
-        .argument('[escena]', 'bordes, comprobantes, colores, componentes, configuracion, errores o json')
+        .argument('[escena]', 'bordes, comprobantes, colores, componentes, configuración, errores o json')
         .action((scene) => {
         if (scene && !STORYBOOK_SCENES.includes(scene)) {
-            throw new InputValidationError(`La escena "${scene}" no es valida. Use bordes, comprobantes, colores, componentes, configuracion, errores o json.`);
+            throw new InputValidationError(`La escena "${scene}" no es válida. Usá bordes, comprobantes, colores, componentes, configuración, errores o json.`);
         }
         writeTerminalOutput(renderStorybookShowcase(scene));
     })
         .addHelpText('after', createStorybookHelp());
     configureSpanishHelp(command);
 }
-//# sourceMappingURL=storybook.command.js.map

package/dist/cli/commands/vouchers.command.js

@@ -1,4 +1,5 @@
 import { AppError, InputValidationError } from '../../lib/errors/app-error.js';
+import { parseStrictInteger } from '../../lib/numbers/strict-integer.js';
 import { getVoucherKindByShortcut, VOUCHER_SHORTCUTS } from '../../modules/billing/voucher-kind-map.js';
 import { listRecentVouchers, MAX_RECENT_VOUCHERS, RECENT_VOUCHERS_LIMIT } from '../../modules/vouchers/voucher-history.js';
 import { formatVoucherDetailAsJson, formatVoucherDetailAsText, formatVoucherListAsJson, formatVoucherListAsText, formatVoucherNumber, } from '../../modules/vouchers/voucher-history.presenter.js';
@@ -13,14 +14,14 @@ import { startSpinner } from '../spinner.js';
 function requireVoucherKind(shortcut) {
     const voucherKind = getVoucherKindByShortcut(shortcut.trim().toLowerCase());
     if (!voucherKind) {
-        throw new InputValidationError(`El tipo "${shortcut}" no es valido. Use un atajo: ${VOUCHER_SHORTCUTS.join(', ')}.`);
+        throw new InputValidationError(`El tipo "${shortcut}" no es válido. Usá un atajo: ${VOUCHER_SHORTCUTS.join(', ')}.`);
     }
     return voucherKind;
 }
 function requirePointOfSale(options, runtime) {
     const pointOfSale = options.pv ?? options.puntoVenta ?? runtime.pointOfSale;
     if (!pointOfSale || !Number.isInteger(pointOfSale) || pointOfSale <= 0) {
-        throw new InputValidationError('Falta el punto de venta. Use --pv <numero> o configurelo con "arcli config establecer puntoVenta <numero>".');
+        throw new InputValidationError('Falta el punto de venta. Usá --pv <numero> o configuralo con "arcli config establecer puntoVenta <numero>".');
     }
     return pointOfSale;
 }
@@ -46,7 +47,7 @@ export function registerVoucherQueryCommands(program) {
     const recent = addPointOfSaleOptions(program
         .command('ultimos')
         .argument('<tipo>', 'atajo del comprobante, por ejemplo fb, fc o nca')
-        .description('listar los ultimos comprobantes emitidos en ARCA')
+        .description('listar los últimos comprobantes emitidos en ARCA')
         .option('--cantidad <numero>', `cuantos comprobantes mostrar (1 a ${MAX_RECENT_VOUCHERS}; por defecto config.comprobantesPorLista o ${RECENT_VOUCHERS_LIMIT})`, integerOption('--cantidad'))).addHelpText('after', createVoucherQueryHelp());
     registerQueryOptions(recent);
     configureSpanishHelp(recent);
@@ -54,7 +55,7 @@ export function registerVoucherQueryCommands(program) {
         const voucherKind = requireVoucherKind(shortcut);
         const { cantidad } = options;
         if (cantidad !== undefined && (!Number.isInteger(cantidad) || cantidad < 1 || cantidad > MAX_RECENT_VOUCHERS)) {
-            throw new InputValidationError(`--cantidad tiene que ser un numero entre 1 y ${MAX_RECENT_VOUCHERS}.`);
+            throw new InputValidationError(`--cantidad tiene que ser un número entre 1 y ${MAX_RECENT_VOUCHERS}.`);
         }
         const { gateway, runtime } = createContext(self);
         const limit = cantidad ?? runtime.config.comprobantesPorLista ?? RECENT_VOUCHERS_LIMIT;
@@ -70,15 +71,15 @@ export function registerVoucherQueryCommands(program) {
     const detail = addPointOfSaleOptions(program
         .command('consultar')
         .argument('<tipo>', 'atajo del comprobante, por ejemplo fb, fc o nca')
-        .argument('<numero>', 'numero del comprobante')
+        .argument('<numero>', 'número del comprobante')
         .description('ver el detalle de un comprobante emitido en ARCA')).addHelpText('after', createVoucherQueryHelp());
     registerQueryOptions(detail);
     configureSpanishHelp(detail);
     detail.action(async (shortcut, rawNumber, options, self) => {
         const voucherKind = requireVoucherKind(shortcut);
-        const number = Number(rawNumber);
-        if (!Number.isInteger(number) || number <= 0) {
-            throw new InputValidationError(`El numero "${rawNumber}" no es valido: tiene que ser un entero positivo.`);
+        const number = parseStrictInteger(rawNumber);
+        if (number === undefined || number <= 0) {
+            throw new InputValidationError(`El número "${rawNumber}" no es válido: tiene que ser un entero positivo.`);
         }
         const { gateway, runtime } = createContext(self);
         const pointOfSale = requirePointOfSale(options, runtime);
@@ -94,4 +95,3 @@ export function registerVoucherQueryCommands(program) {
         writeTerminalOutput(formatVoucherDetailAsText(report));
     });
 }
-//# sourceMappingURL=vouchers.command.js.map

package/dist/cli/error-output.js

@@ -27,10 +27,29 @@ export function isCommanderExit(error) {
 export function isCommanderUsageError(error) {
     return error instanceof CommanderError && !COMMANDER_NON_ERROR_CODES.has(error.code);
 }
+/** Los mensajes de error de uso de commander (15.x), que vienen en ingles. */
+const COMMANDER_MESSAGES = [
+    [/unknown option '([^']+)'/, "opción desconocida '$1'"],
+    [/unknown command '([^']+)'/, "comando desconocido '$1'"],
+    [/missing required argument '([^']+)'/, "falta el argumento obligatorio '$1'"],
+    [/option '([^']+)' argument missing/, "falta el valor de la opción '$1'"],
+    [/required option '([^']+)' not specified/, "falta la opción obligatoria '$1'"],
+    [/option '([^']+)' argument '([^']*)' is invalid\./, "el valor '$2' de la opción '$1' no es válido."],
+    [
+        /too many arguments(?: for '([^']+)')?\. Expected (\d+) arguments? but got (\d+): (.*)\./,
+        'sobran argumentos: espera $2 y recibió $3 ($4).',
+    ],
+    [/ cannot be used with /, ' no se puede usar junto con '],
+    [/\(Did you mean one of ([^?]+)\?\)/, '(¿quisiste decir alguno de $1?)'],
+    [/\(Did you mean ([^?]+)\?\)/, '(¿quisiste decir $1?)'],
+];
+export function translateCommanderMessage(message) {
+    return COMMANDER_MESSAGES.reduce((result, [pattern, replacement]) => result.replace(pattern, replacement), message);
+}
 /** El error de uso de commander como `INPUT_VALIDATION_ERROR`, en el mismo formato que el resto. */
 export function toUsageError(error) {
     // Commander arma el mensaje con "error: " adelante y, a veces, una segunda linea "(Did you mean --monto?)".
-    const message = error.message
+    const message = translateCommanderMessage(error.message)
         .replace(/^error:\s*/i, '')
         .replace(/\s*\n\s*/g, ' ')
         .trim();
@@ -50,7 +69,7 @@ export function configureUsageErrors(program, errorsAsJson) {
         outputError: (message, write) => {
             failing = true;
             if (!errorsAsJson()) {
-                write(message);
+                write(translateCommanderMessage(message));
             }
         },
         writeErr: (text) => {
@@ -83,4 +102,3 @@ export function reportCliError(error, errorsAsJson) {
     }
     return 1;
 }
-//# sourceMappingURL=error-output.js.map

package/dist/cli/global-options.js

@@ -6,8 +6,8 @@ import { ConfigService } from '../modules/config/config.service.js';
  */
 export function registerEnvironmentOptions(command) {
     return command
-        .option('--testing', 'usar entorno de testing en esta ejecucion')
-        .option('--produccion', 'usar entorno de produccion en esta ejecucion');
+        .option('--testing', 'usar entorno de testing en esta ejecución')
+        .option('--produccion', 'usar entorno de producción en esta ejecución');
 }
 export function registerJsonOption(command) {
     return command.option('--json', 'imprimir salida JSON');
@@ -53,4 +53,3 @@ export function resolveOutputJson(command, config) {
     }
     return config ? config.output.jsonPorDefecto : readJsonDefault();
 }
-//# sourceMappingURL=global-options.js.map

package/dist/cli/help-argv.js

@@ -18,4 +18,3 @@ export function normalizeHelpArgv(argv, interactive) {
     }
     return argv;
 }
-//# sourceMappingURL=help-argv.js.map