arcli 2.0.0 → 2.2.0

package/dist/modules/billing/billing.associated-period.js

@@ -13,28 +13,27 @@ export function resolveAssociatedPeriod(input, voucherKind, billingDate) {
     }
     const label = formatVoucherLabel(voucherKind);
     if (!voucherKind.requiresAssociatedVoucher) {
-        throw new InputValidationError(`La ${label} no usa periodo asociado: solo aplica a notas de credito o debito.`);
+        throw new InputValidationError(`La ${label} no usa período asociado: solo aplica a notas de crédito o débito.`);
     }
     if (voucherKind.isElectronicCredit) {
-        throw new InputValidationError(`La ${label} no admite periodo asociado: ARCA solo lo acepta en notas comunes. Use el comprobante asociado (--ac).`);
+        throw new InputValidationError(`La ${label} no admite período asociado: ARCA solo lo acepta en notas comunes. Usá el comprobante asociado (--ac).`);
     }
     if (input.associatedVoucher) {
-        throw new InputValidationError('Use un comprobante asociado (--ac/--at) o un periodo asociado (--periodo-desde/--periodo-hasta), pero no ambos.');
+        throw new InputValidationError('Usá un comprobante asociado (--ac/--at) o un período asociado (--periodo-desde/--periodo-hasta), pero no ambos.');
     }
     if (!period.desde || !period.hasta) {
-        throw new InputValidationError('El periodo asociado requiere ambas fechas: --periodo-desde y --periodo-hasta.');
+        throw new InputValidationError('El período asociado requiere ambas fechas: --periodo-desde y --periodo-hasta.');
     }
     const FchDesde = parseArgentineDateInputAsArcaDate(period.desde);
     const FchHasta = parseArgentineDateInputAsArcaDate(period.hasta);
     if (FchDesde < MINIMUM_PERIOD_DATE) {
-        throw new InputValidationError('El periodo asociado tiene que ser posterior al 01/01/2006.');
+        throw new InputValidationError('El período asociado tiene que ser posterior al 01/01/2006.');
     }
     if (FchDesde > FchHasta) {
-        throw new InputValidationError('En el periodo asociado, --periodo-desde no puede ser posterior a --periodo-hasta.');
+        throw new InputValidationError('En el período asociado, --periodo-desde no puede ser posterior a --periodo-hasta.');
     }
     if (FchHasta > billingDate) {
-        throw new InputValidationError(`El periodo asociado no puede terminar despues de la fecha de la ${label} (${formatArcaDateAsArgentineDate(billingDate)}).`);
+        throw new InputValidationError(`El período asociado no puede terminar después de la fecha de la ${label} (${formatArcaDateAsArgentineDate(billingDate)}).`);
     }
     return { FchDesde, FchHasta };
 }
-//# sourceMappingURL=billing.associated-period.js.map

package/dist/modules/billing/billing.associated-vouchers.js

@@ -20,13 +20,13 @@ export function resolveAssociatedVouchers(options) {
     const associatedVoucherType = associatedVoucher?.tipo ?? resolveAssociatedVoucherType(associatedVoucher?.shortcut, requireVoucherKind);
     const associatedVoucherKind = resolveAssociatedVoucherKind(associatedVoucher, requireVoucherKind);
     if (!associatedVoucher?.numero || !associatedVoucher.puntoVenta || !associatedVoucherType || !associatedCuit) {
-        throw new InputValidationError(`El comprobante ${formatVoucherLabel(voucherKind)} requiere comprobante asociado. Use --ac o --at, junto con --apv o --asociado-punto-venta, --ar y --acuit${voucherKind.isElectronicCredit ? '' : ', o un periodo con --periodo-desde y --periodo-hasta'}.`);
+        throw new InputValidationError(`El comprobante ${formatVoucherLabel(voucherKind)} requiere comprobante asociado. Usá --ac o --at, junto con --apv o --asociado-punto-venta, --ar y --acuit${voucherKind.isElectronicCredit ? '' : ', o un período con --periodo-desde y --periodo-hasta'}.`);
     }
     if (associatedVoucherKind) {
         validateAssociatedVoucherKind(associatedVoucherKind, voucherKind);
     }
     if (voucherKind.isElectronicCredit && associatedCuit !== String(emitterCuit)) {
-        throw new InputValidationError(`En la ${formatVoucherLabel(voucherKind)} el comprobante asociado tiene que ser del CUIT emisor (${emitterCuit}). Quite --acuit o use ese CUIT.`);
+        throw new InputValidationError(`En la ${formatVoucherLabel(voucherKind)} el comprobante asociado tiene que ser del CUIT emisor (${emitterCuit}). Sacá --acuit o usá ese CUIT.`);
     }
     const associatedDate = resolveAssociatedVoucherDate(associatedVoucher.fecha, billingDate, voucherKind);
     return [
@@ -47,14 +47,14 @@ function resolveAssociatedVoucherKind(associatedVoucher, requireVoucherKind) {
     const byShortcut = associatedVoucher?.shortcut ? requireVoucherKind(associatedVoucher.shortcut) : undefined;
     const byType = associatedVoucher?.tipo ? (getVoucherKindByArcaType(associatedVoucher.tipo) ?? undefined) : undefined;
     if (byShortcut && associatedVoucher?.tipo && byShortcut.arcaType !== associatedVoucher.tipo) {
-        throw new InputValidationError(`El atajo "${associatedVoucher.shortcut}" es el tipo ${byShortcut.arcaType}, no el ${associatedVoucher.tipo}. Use uno solo para el comprobante asociado.`);
+        throw new InputValidationError(`El atajo "${associatedVoucher.shortcut}" es el tipo ${byShortcut.arcaType}, no el ${associatedVoucher.tipo}. Usá uno solo para el comprobante asociado.`);
     }
     return byShortcut ?? byType;
 }
 function resolveAssociatedVoucherDate(rawDate, billingDate, voucherKind) {
     if (!rawDate) {
         if (voucherKind.isElectronicCredit) {
-            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} requiere la fecha del comprobante asociado. Use --afecha <fecha>.`);
+            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} requiere la fecha del comprobante asociado. Usá --afecha <fecha>.`);
         }
         return undefined;
     }
@@ -78,7 +78,6 @@ function validateAssociatedVoucherKind(associatedVoucherKind, voucherKind) {
         throw new InputValidationError(`El comprobante asociado debe usar la misma letra que ${formatVoucherLabel(voucherKind)}.`);
     }
     if (associatedVoucherKind.isElectronicCredit !== voucherKind.isElectronicCredit) {
-        throw new InputValidationError(`El comprobante asociado debe pertenecer a la misma categoria electronica que ${formatVoucherLabel(voucherKind)}.`);
+        throw new InputValidationError(`El comprobante asociado debe pertenecer a la misma categoría electrónica que ${formatVoucherLabel(voucherKind)}.`);
     }
 }
-//# sourceMappingURL=billing.associated-vouchers.js.map

package/dist/modules/billing/billing.batch.js

@@ -12,7 +12,13 @@ export function describeBatchItemError(error) {
 export class BatchValidationError extends AppError {
     constructor(errors, total) {
         const lines = errors.map((item) => `#${item.index}: ${item.message}`);
-        super([`${errors.length} de ${total} comprobantes del lote tienen errores. No se emitio ninguno.`, '', ...lines].join('\n'), {
+        super([
+            errors.length === 1
+                ? `1 de ${total} ${total === 1 ? 'comprobante' : 'comprobantes'} del lote tiene errores. No se emitió ninguno.`
+                : `${errors.length} de ${total} comprobantes del lote tienen errores. No se emitió ninguno.`,
+            '',
+            ...lines,
+        ].join('\n'), {
             code: 'BATCH_VALIDATION_ERROR',
             details: { comprobantes: errors.map((item) => ({ error: item.message, indice: item.index })) },
         });
@@ -25,13 +31,15 @@ export class BatchValidationError extends AppError {
  */
 export class BatchEmissionError extends AppError {
     constructor(options) {
-        const pending = Array.from({ length: options.total - options.failedIndex }, (_, offset) => options.failedIndex + 1 + offset);
         const uncertain = options.cause instanceof EmissionUncertainError;
+        // Si el fallo fue antes de la llamada que emite (login, ultimo numero), ese comprobante tampoco se proceso.
+        const firstPending = uncertain ? options.failedIndex + 1 : options.failedIndex;
+        const pending = Array.from({ length: options.total - firstPending + 1 }, (_, offset) => firstPending + offset);
         super([
-            `El lote se interrumpio en el comprobante #${options.failedIndex}: ${describeBatchItemError(options.cause)}`,
+            `El lote se interrumpió en el comprobante #${options.failedIndex}: ${describeBatchItemError(options.cause)}`,
             `Procesados: ${options.emitted} de ${options.total}.${pending.length > 0 ? ` Sin procesar: ${pending.map((index) => `#${index}`).join(', ')}.` : ''}`,
             ...(uncertain
-                ? [`El #${options.failedIndex} puede haberse emitido: verifiquelo con "arcli ultimos" antes de reintentarlo.`]
+                ? [`El #${options.failedIndex} puede haberse emitido: verificalo con "arcli ultimos" antes de reintentarlo.`]
                 : []),
         ].join('\n'), {
             code: 'BATCH_EMISSION_ERROR',
@@ -46,4 +54,3 @@ export class BatchEmissionError extends AppError {
         this.name = 'BatchEmissionError';
     }
 }
-//# sourceMappingURL=billing.batch.js.map

package/dist/modules/billing/billing.constants.js

@@ -1,3 +1,2 @@
 export const DEFAULT_CURRENCY_CODE = 'ARS';
 export const DEFAULT_EXCHANGE_RATE = 1;
-//# sourceMappingURL=billing.constants.js.map

package/dist/modules/billing/billing.currency.js

@@ -20,7 +20,7 @@ export function resolveBillingCurrencyFields(input, billingDate, today) {
             throw new InputValidationError('--misma-moneda solo aplica a comprobantes en moneda extranjera.');
         }
         if (typeof input.exchangeRate === 'number' && input.exchangeRate !== DEFAULT_EXCHANGE_RATE) {
-            throw new InputValidationError('En pesos la cotizacion debe ser 1. Quite --cotizacion-moneda o use --cm 1.');
+            throw new InputValidationError('En pesos la cotización debe ser 1. Sacá --cotizacion-moneda o usá --cm 1.');
         }
         // ARCA rechaza CanMisMonExt cuando MonId = PES (error 10241).
         return {
@@ -30,10 +30,10 @@ export function resolveBillingCurrencyFields(input, billingDate, today) {
     }
     if (input.sameCurrency) {
         if (billingDate < today) {
-            throw new InputValidationError('Con --misma-moneda la fecha del comprobante no puede ser anterior a hoy: ARCA exige la cotizacion oficial de ese dia y solo se puede consultar la vigente.');
+            throw new InputValidationError('Con --misma-moneda la fecha del comprobante no puede ser anterior a hoy: ARCA exige la cotización oficial de ese día y solo se puede consultar la vigente.');
         }
         if (typeof input.exchangeRate !== 'number') {
-            throw new InputValidationError(`No se pudo obtener la cotizacion oficial de ${inputCurrencyCode} desde ARCA.`);
+            throw new InputValidationError(`No se pudo obtener la cotización oficial de ${inputCurrencyCode} desde ARCA.`);
         }
         return {
             CanMisMonExt: 'S',
@@ -42,7 +42,7 @@ export function resolveBillingCurrencyFields(input, billingDate, today) {
         };
     }
     if (typeof input.exchangeRate !== 'number' || input.exchangeRate === DEFAULT_EXCHANGE_RATE) {
-        throw new InputValidationError(`Falta la cotizacion de ${inputCurrencyCode}. Use --cotizacion-moneda o --cm, o --misma-moneda si el pago se hace en ${inputCurrencyCode}.`);
+        throw new InputValidationError(`Falta la cotización de ${inputCurrencyCode}. Usá --cotizacion-moneda o --cm, o --misma-moneda si el pago se hace en ${inputCurrencyCode}.`);
     }
     return {
         CanMisMonExt: 'N',
@@ -50,4 +50,3 @@ export function resolveBillingCurrencyFields(input, billingDate, today) {
         MonId: currencyCode,
     };
 }
-//# sourceMappingURL=billing.currency.js.map

package/dist/modules/billing/billing.date-range.js

@@ -1,19 +1,36 @@
 import { calendarDateToArcaDate, formatDateAsArcaDate, maxArcaDate, parseArgentineDateInputAsArcaDate, toArgentineCalendarDate, } from '../../lib/dates/arca-date.js';
+import { InputValidationError } from '../../lib/errors/app-error.js';
 import { isElectronicCreditInvoice } from './billing.fce.js';
 import { ensureDateOrder, validateBillingDateWindow, validateConceptDateInputs, validatePaymentDueDate, } from './billing.validation.js';
-/** Fecha ARCA del proximo `dueDay`, contando desde hoy en Argentina. La cuenta va en UTC para no cruzar zonas. */
+const MONTH_NAMES = [
+    'enero',
+    'febrero',
+    'marzo',
+    'abril',
+    'mayo',
+    'junio',
+    'julio',
+    'agosto',
+    'septiembre',
+    'octubre',
+    'noviembre',
+    'diciembre',
+];
+/**
+ * Fecha ARCA del proximo `dueDay`, contando desde hoy en Argentina. La cuenta va en UTC para no cruzar zonas y
+ * arranca del dia 1: sumar un mes al 31/03 daria el 1/05. Si el dia no existe en ese mes (31 en abril), es un error.
+ */
 function resolvePaymentDateFromDueDay(dueDay, now = new Date()) {
     const today = toArgentineCalendarDate(now);
-    const paymentDate = new Date(Date.UTC(today.year, today.month - 1, today.day));
-    if (dueDay < today.day) {
-        paymentDate.setUTCMonth(paymentDate.getUTCMonth() + 1);
+    const monthOffset = dueDay < today.day ? 1 : 0;
+    const firstOfMonth = new Date(Date.UTC(today.year, today.month - 1 + monthOffset, 1));
+    const year = firstOfMonth.getUTCFullYear();
+    const monthIndex = firstOfMonth.getUTCMonth();
+    const daysInMonth = new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();
+    if (dueDay > daysInMonth) {
+        throw new InputValidationError(`--dia ${dueDay} no existe en ${MONTH_NAMES[monthIndex]} de ${year}. Indicá la fecha exacta con --servicio-hasta.`);
     }
-    paymentDate.setUTCDate(dueDay);
-    return calendarDateToArcaDate({
-        day: paymentDate.getUTCDate(),
-        month: paymentDate.getUTCMonth() + 1,
-        year: paymentDate.getUTCFullYear(),
-    });
+    return calendarDateToArcaDate({ day: dueDay, month: monthIndex + 1, year });
 }
 /**
  * Que fechas lleva el comprobante:
@@ -54,4 +71,3 @@ export function resolveBillingDateRange(input, voucherKind, today = formatDateAs
     validatePaymentDueDate(paymentDueDate, minimumPaymentDueDate);
     return { billingDate, paymentDueDate, ...serviceDates };
 }
-//# sourceMappingURL=billing.date-range.js.map

package/dist/modules/billing/billing.display.js

@@ -1,4 +1,5 @@
 import { keyValuePanel, renderKeyValueRows, renderTable, resolveKeyValueLabelWidth, statusPanel, testingBanner, toneText, } from '../../ui/index.js';
+import { formatVoucherNumber } from '../vouchers/voucher-history.presenter.js';
 import { resolveIvaRateLabel } from './billing.amounts.js';
 import { formatConceptLabel, formatCurrencyLabel, formatDateLabel, formatDecimalLabel, formatDocumentTypeLabel, formatIvaConditionLabel, formatMoneyLabel, formatNumericLabel, formatTaxIdLabel, } from './billing.labels.js';
 import { getVoucherKindByArcaType } from './voucher-kind-map.js';
@@ -47,7 +48,7 @@ function formatIvaRows(iva) {
     }
     const label = (aliquotId) => resolveIvaRateLabel(aliquotId) ?? String(aliquotId);
     if (iva.length === 1 && iva[0]) {
-        return [['Alicuota IVA', label(iva[0].Id)]];
+        return [['Alícuota IVA', label(iva[0].Id)]];
     }
     return iva.map((item) => [`IVA ${label(item.Id)}`, `${formatMoneyLabel(item.Importe)} sobre ${formatMoneyLabel(item.BaseImp)}`]);
 }
@@ -59,7 +60,7 @@ function formatFriendlyPayloadRows(result) {
         ['Fecha del comprobante', formatDateLabel(payload.CbteFch)],
         ['Tipo de documento', formatDocumentTypeLabel(payload.DocTipo)],
         [
-            'Numero de documento',
+            'Número de documento',
             typeof payload.DocNro === 'number'
                 ? payload.DocNro === 0
                     ? 'Sin especificar'
@@ -68,9 +69,13 @@ function formatFriendlyPayloadRows(result) {
                         : formatNumericLabel(payload.DocNro)
                 : 'No informado',
         ],
-        ['IVA receptor', formatIvaConditionLabel(payload.CondicionIVAReceptorId)],
+        ...(result.receiver?.name ? [['Receptor', result.receiver.name]] : []),
+        [
+            'IVA receptor',
+            `${formatIvaConditionLabel(payload.CondicionIVAReceptorId)}${result.receiver?.ivaConditionFromPadron ? ' (padrón)' : ''}`,
+        ],
         ['Moneda', formatCurrencyLabel(payload.MonId)],
-        ['Cotizacion', formatDecimalLabel(payload.MonCotiz)],
+        ['Cotización', formatDecimalLabel(payload.MonCotiz)],
         ['Importe neto', formatMoneyLabel(payload.ImpNeto)],
         ['Importe IVA', formatMoneyLabel(payload.ImpIVA)],
         ...formatIvaRows(payload.Iva ?? []),
@@ -93,7 +98,7 @@ function formatFriendlyPayloadRows(result) {
         const associatedKind = getVoucherKindByArcaType(associatedVoucher.Tipo);
         rows.push(['Comprobante asociado', associatedKind ? associatedKind.displayName : String(associatedVoucher.Tipo)]);
         rows.push(['Punto de venta asociado', formatNumericLabel(associatedVoucher.PtoVta)]);
-        rows.push(['Numero asociado', formatNumericLabel(associatedVoucher.Nro)]);
+        rows.push(['Número asociado', formatNumericLabel(associatedVoucher.Nro)]);
         rows.push(['CUIT asociado', formatTaxIdLabel(associatedVoucher.Cuit)]);
         if (associatedVoucher.CbteFch) {
             rows.push(['Fecha asociado', formatDateLabel(associatedVoucher.CbteFch)]);
@@ -101,7 +106,7 @@ function formatFriendlyPayloadRows(result) {
     }
     if (payload.PeriodoAsoc) {
         rows.push([
-            'Periodo asociado',
+            'Período asociado',
             `${formatDateLabel(payload.PeriodoAsoc.FchDesde)} al ${formatDateLabel(payload.PeriodoAsoc.FchHasta)}`,
         ]);
     }
@@ -126,7 +131,9 @@ export function formatResultPanel(result, status) {
     const summaryRows = [
         ['CAE', result.response.cae ?? 'N/D'],
         ['Vencimiento CAE', formatDateLabel(result.response.caeVencimiento ?? undefined)],
-        ['Punto de venta', result.payload.PtoVta],
+        result.voucherNumber === undefined
+            ? ['Punto de venta', result.payload.PtoVta]
+            : ['Número', formatVoucherNumber(result.payload.PtoVta, result.voucherNumber)],
         ['Importe total', formatMoneyLabel(result.payload.ImpTotal)],
     ];
     const countRows = [
@@ -143,4 +150,3 @@ export function formatResultPanel(result, status) {
     const footer = toneText(status.label, status.tone);
     return statusPanel(result.voucherKind.displayName, rows, footer, 'ticket', status.tone, 'ticket');
 }
-//# sourceMappingURL=billing.display.js.map

package/dist/modules/billing/billing.errors.js

@@ -6,13 +6,12 @@ import { AppError } from '../../lib/errors/app-error.js';
 export class EmissionUncertainError extends AppError {
     constructor(options) {
         const reason = options.cause instanceof Error ? options.cause.message : String(options.cause);
-        super(`No se pudo confirmar la emision: ${reason}`, {
+        super(`No se pudo confirmar la emisión: ${reason}`, {
             code: 'EMISSION_UNCERTAIN',
             details: { causa: reason },
-            suggestion: `Puede haberse emitido igual. Antes de reintentar, verifique con "arcli ultimos ${options.shortcut} --pv ${options.pointOfSale}": si figura, ya esta emitido y no hay que repetirlo.`,
+            suggestion: `Puede haberse emitido igual. Antes de reintentar, verificá con "arcli ultimos ${options.shortcut} --pv ${options.pointOfSale}": si figura, ya esta emitido y no hay que repetirlo.`,
         });
         this.name = 'EmissionUncertainError';
         this.cause = options.cause;
     }
 }
-//# sourceMappingURL=billing.errors.js.map

package/dist/modules/billing/billing.fce.js

@@ -30,7 +30,7 @@ export function resolveElectronicCreditOptionals(input, voucherKind) {
     if (!voucherKind.isElectronicCredit) {
         const flags = input.cancellation ? [...invoiceOnlyFlags, '--anulacion'] : invoiceOnlyFlags;
         if (flags.length > 0) {
-            throw new InputValidationError(`${flags.join(', ')} solo aplica a comprobantes de credito electronica (FCE).`);
+            throw new InputValidationError(`${flags.join(', ')} solo aplica a comprobantes de crédito electrónica (FCE).`);
         }
         return undefined;
     }
@@ -41,10 +41,10 @@ export function resolveElectronicCreditOptionals(input, voucherKind) {
         return [{ Id: FCE_OPTIONAL_IDS.cancellation, Valor: input.cancellation ? 'S' : 'N' }];
     }
     if (input.cancellation) {
-        throw new InputValidationError(`La ${label} no usa --anulacion: solo aplica a notas de credito o debito FCE.`);
+        throw new InputValidationError(`La ${label} no usa --anulacion: solo aplica a notas de crédito o débito FCE.`);
     }
     if (!input.cbu) {
-        throw new InputValidationError(`La ${label} requiere el CBU del emisor. Use --cbu o configurelo con "arcli config establecer cbu <22 digitos>".`);
+        throw new InputValidationError(`La ${label} requiere el CBU del emisor. Usá --cbu o configuralo con "arcli config establecer cbu <22 digitos>".`);
     }
     const optionals = [{ Id: FCE_OPTIONAL_IDS.cbu, Valor: input.cbu }];
     if (input.cbuAlias) {
@@ -56,4 +56,3 @@ export function resolveElectronicCreditOptionals(input, voucherKind) {
     });
     return optionals;
 }
-//# sourceMappingURL=billing.fce.js.map

package/dist/modules/billing/billing.iva-receptor.js

@@ -47,7 +47,7 @@ export function validateIvaConditionForVoucher(ivaCondition, voucherKind) {
         return;
     }
     const suggestedLetter = ['a', 'b'].find((letter) => isIvaConditionAllowed(letter, ivaCondition));
-    const suggestion = suggestedLetter ? ` Use un comprobante letra ${suggestedLetter.toUpperCase()}.` : '';
+    const suggestion = suggestedLetter ? ` Usá un comprobante letra ${suggestedLetter.toUpperCase()}.` : '';
     throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} no admite IVA receptor "${ivaCondition}".${suggestion}`);
 }
 export function validateConsumerIdentification(input, exchangeRate, voucherKind) {
@@ -55,7 +55,6 @@ export function validateConsumerIdentification(input, exchangeRate, voucherKind)
         return;
     }
     if (input.totalAmount * exchangeRate >= CONSUMER_IDENTIFICATION_THRESHOLD) {
-        throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} de $10.000.000 o mas requiere identificar al consumidor final. Use --dni, --cuit o --cuil.`);
+        throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} de $10.000.000 o más requiere identificar al consumidor final. Usá --dni, --cuit o --cuil.`);
     }
 }
-//# sourceMappingURL=billing.iva-receptor.js.map

package/dist/modules/billing/billing.json-format.js

@@ -2,4 +2,3 @@ import { serializeBillingResult } from './billing.serialize.js';
 export function formatBillingResultAsJson(result, options = {}) {
     return JSON.stringify(serializeBillingResult(result, { raw: options.raw }), null, 2);
 }
-//# sourceMappingURL=billing.json-format.js.map

package/dist/modules/billing/billing.json-input.js

@@ -0,0 +1,278 @@
+import { z } from 'zod';
+import { InputValidationError } from '../../lib/errors/app-error.js';
+/**
+ * Forma del JSON de `--cargar`, campo por campo. Solo valida tipos y claves: los valores (montos positivos,
+ * alicuotas, conceptos...) los revisa despues `billingCommandSchema`, igual que si vinieran por flags.
+ * Es `.strict()`: una clave que no esta aca es un error, para que un typo no se ignore en silencio.
+ */
+const ivaRateJsonSchema = z.union([z.string(), z.number()], {
+    error: 'tiene que ser un texto ("general", "10.5") o un número (10.5)',
+});
+const associatedVoucherJsonSchema = z
+    .object({
+    atajo: z.string().optional(),
+    cuit: z.string().optional(),
+    fecha: z.string().optional(),
+    numero: z.number().optional(),
+    puntoVenta: z.number().optional(),
+    tipo: z.number().optional(),
+})
+    .strict();
+const associatedPeriodJsonSchema = z
+    .object({
+    desde: z.string().optional(),
+    hasta: z.string().optional(),
+})
+    .strict();
+const ivaRateAmountJsonSchema = z
+    .object({
+    monto: z.number(),
+    tasa: ivaRateJsonSchema,
+})
+    .strict();
+export const billingJsonInputSchema = z
+    .object({
+    aliasCbu: z.string().optional(),
+    alicuotaIva: ivaRateJsonSchema.optional(),
+    alicuotas: z.array(ivaRateAmountJsonSchema).optional(),
+    anulacion: z.boolean().optional(),
+    cbu: z.string().optional(),
+    codigoMoneda: z.string().optional(),
+    comprobanteAsociado: associatedVoucherJsonSchema.optional(),
+    concepto: z.string().optional(),
+    cotizacionMoneda: z.number().optional(),
+    descripcion: z.string().optional(),
+    dia: z.number().optional(),
+    emitir: z.boolean().optional(),
+    fechaComprobante: z.string().optional(),
+    importeExento: z.number().optional(),
+    importeNoGravado: z.number().optional(),
+    ivaReceptor: z.string().optional(),
+    mismaMoneda: z.boolean().optional(),
+    montoTotal: z.number().optional(),
+    numeroDocumento: z.number().optional(),
+    pdf: z.boolean().optional(),
+    periodoAsociado: associatedPeriodJsonSchema.optional(),
+    previsualizar: z.boolean().optional(),
+    puntoVenta: z.number().optional(),
+    receptorDomicilio: z.string().optional(),
+    receptorNombre: z.string().optional(),
+    servicioDesde: z.string().optional(),
+    servicioHasta: z.string().optional(),
+    tipoDocumento: z.string().optional(),
+    transferencia: z.string().optional(),
+    vencimientoPago: z.string().optional(),
+})
+    .strict();
+/**
+ * Campo de `BillingCommandInput` que alimenta cada clave del JSON; `null` si no tiene uno solo
+ * (`emitir` y `previsualizar` deciden juntos `emit` y `dryRun`). El tipo obliga a cubrir todas las claves.
+ */
+const BILLING_JSON_INTERNAL_KEYS = {
+    aliasCbu: 'cbuAlias',
+    alicuotaIva: 'ivaRate',
+    alicuotas: 'ivaRateAmounts',
+    anulacion: 'cancellation',
+    cbu: 'cbu',
+    codigoMoneda: 'currencyCode',
+    comprobanteAsociado: 'associatedVoucher',
+    concepto: 'concept',
+    cotizacionMoneda: 'exchangeRate',
+    descripcion: 'pdfDescription',
+    dia: 'dueDay',
+    emitir: null,
+    fechaComprobante: 'billingDate',
+    importeExento: 'exemptAmount',
+    importeNoGravado: 'untaxedAmount',
+    ivaReceptor: 'ivaCondition',
+    mismaMoneda: 'sameCurrency',
+    montoTotal: 'totalAmount',
+    numeroDocumento: 'documentNumber',
+    pdf: 'pdf',
+    periodoAsociado: 'associatedPeriod',
+    previsualizar: null,
+    puntoVenta: 'pointOfSale',
+    receptorDomicilio: 'receiverAddress',
+    receptorNombre: 'receiverName',
+    servicioDesde: 'serviceStartDate',
+    servicioHasta: 'serviceEndDate',
+    tipoDocumento: 'documentType',
+    transferencia: 'transferMode',
+    vencimientoPago: 'paymentDueDate',
+};
+/** Clave publica del JSON para cada campo interno; sirve para traducir las rutas de los errores de zod. */
+export const BILLING_JSON_KEY_BY_INTERNAL_KEY = Object.fromEntries(Object.entries(BILLING_JSON_INTERNAL_KEYS)
+    .filter(([, internalKey]) => internalKey !== null)
+    .map(([jsonKey, internalKey]) => [internalKey, jsonKey]));
+/** Claves validas en cada objeto del JSON; las de un array (`alicuotas`) van sin indice. */
+const KEYS_BY_PARENT = {
+    '': Object.keys(billingJsonInputSchema.shape),
+    alicuotas: Object.keys(ivaRateAmountJsonSchema.shape),
+    comprobanteAsociado: Object.keys(associatedVoucherJsonSchema.shape),
+    periodoAsociado: Object.keys(associatedPeriodJsonSchema.shape),
+};
+/**
+ * Nombres de flags (sin guiones) que alguien puede escribir en el JSON pensando que valen igual.
+ * Solo los que no se parecen a su clave: el resto lo encuentra la comparacion por parecido.
+ */
+const FLAG_NAME_HINTS = {
+    ac: 'comprobanteAsociado.atajo',
+    acuit: 'comprobanteAsociado.cuit',
+    afecha: 'comprobanteAsociado.fecha',
+    alias: 'aliasCbu',
+    alicuota: 'alicuotaIva',
+    apv: 'comprobanteAsociado.puntoVenta',
+    ar: 'comprobanteAsociado.numero',
+    at: 'comprobanteAsociado.tipo',
+    cm: 'cotizacionMoneda',
+    cuil: 'tipoDocumento": "cuil" con "numeroDocumento',
+    cuit: 'tipoDocumento": "cuit" con "numeroDocumento',
+    dni: 'tipoDocumento": "dni" con "numeroDocumento',
+    exento: 'importeExento',
+    exportarpdf: 'pdf',
+    fecha: 'fechaComprobante',
+    ir: 'ivaReceptor',
+    mda: 'codigoMoneda',
+    moneda: 'codigoMoneda',
+    monto: 'montoTotal',
+    nogravado: 'importeNoGravado',
+    pd: 'periodoAsociado.desde',
+    periododesde: 'periodoAsociado.desde',
+    periodohasta: 'periodoAsociado.hasta',
+    ph: 'periodoAsociado.hasta',
+    pv: 'puntoVenta',
+    sd: 'servicioDesde',
+    sh: 'servicioHasta',
+    sinpdf: 'pdf',
+    vencimiento: 'vencimientoPago',
+    vto: 'vencimientoPago',
+};
+function normalizeKey(key) {
+    return key.toLowerCase().replace(/[-_\s]/g, '');
+}
+function editDistance(a, b) {
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j += 1) {
+            current[j] = Math.min((previous[j] ?? 0) + 1, (current[j - 1] ?? 0) + 1, (previous[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1));
+        }
+        previous = current;
+    }
+    return previous[b.length] ?? 0;
+}
+/** La clave valida mas parecida, o el nombre de flag conocido; `undefined` si ninguna se parece. */
+function suggestKey(unknownKey, parent) {
+    const normalized = normalizeKey(unknownKey);
+    const validKeys = KEYS_BY_PARENT[parent] ?? [];
+    if (parent === '' && FLAG_NAME_HINTS[normalized]) {
+        return FLAG_NAME_HINTS[normalized];
+    }
+    const ranked = validKeys
+        .map((key) => ({ distance: editDistance(normalized, normalizeKey(key)), key }))
+        .sort((left, right) => left.distance - right.distance);
+    const best = ranked[0];
+    return best && best.distance <= Math.max(1, Math.floor(normalized.length / 4)) ? best.key : undefined;
+}
+function formatPath(path) {
+    return path
+        .map((segment, index) => typeof segment === 'number' ? `[${segment}]` : `${index === 0 ? '' : '.'}${String(segment)}`)
+        .join('');
+}
+function describeExpected(expected) {
+    switch (expected) {
+        case 'number':
+            return 'un número';
+        case 'string':
+            return 'un texto';
+        case 'boolean':
+            return 'true o false';
+        case 'array':
+            return 'un array';
+        case 'object':
+            return 'un objeto';
+        default:
+            return expected;
+    }
+}
+function describeReceived(input) {
+    if (input === null) {
+        return 'null';
+    }
+    if (Array.isArray(input)) {
+        return 'un array';
+    }
+    switch (typeof input) {
+        case 'string':
+            return `el texto ${JSON.stringify(input)}`;
+        case 'number':
+        case 'boolean':
+            return String(input);
+        case 'object':
+            return 'un objeto';
+        default:
+            return typeof input;
+    }
+}
+function describeIssue(issue) {
+    const path = issue.path.map((segment) => (typeof segment === 'number' ? segment : String(segment)));
+    const pathLabel = formatPath(path);
+    if (issue.code === 'unrecognized_keys') {
+        const parent = path.filter((segment) => typeof segment === 'string').join('.');
+        return issue.keys.map((key) => {
+            const fullKey = formatPath([...path, key]);
+            const suggestion = suggestKey(key, parent);
+            return {
+                mensaje: `La clave "${fullKey}" no existe${suggestion ? `: ¿quisiste decir "${suggestion}"?` : '.'}`,
+                ruta: [...path.map(String), key],
+            };
+        });
+    }
+    if (issue.code === 'invalid_type') {
+        if (issue.input === undefined) {
+            return [{ mensaje: `Falta "${pathLabel}".`, ruta: path.map(String) }];
+        }
+        if (path.length === 0) {
+            return [
+                { mensaje: `Cada comprobante tiene que ser un objeto y llegó ${describeReceived(issue.input)}.`, ruta: [] },
+            ];
+        }
+        const unquote = issue.expected === 'number' && typeof issue.input === 'string' && issue.input.trim() !== ''
+            ? ' Escribilo sin comillas.'
+            : '';
+        return [
+            {
+                mensaje: `"${pathLabel}" tiene que ser ${describeExpected(issue.expected)} y llegó ${describeReceived(issue.input)}.${unquote}`,
+                ruta: path.map(String),
+            },
+        ];
+    }
+    return [{ mensaje: `"${pathLabel}" ${issue.message}.`, ruta: path.map(String) }];
+}
+/**
+ * Valida un comprobante del JSON de `--cargar`. Un tipo incorrecto o una clave desconocida es un error de
+ * entrada que nombra la clave; antes se descartaban sin aviso y se usaba la config.
+ */
+export function parseBillingJsonInput(value) {
+    const result = billingJsonInputSchema.safeParse(value, { reportInput: true });
+    if (result.success) {
+        return result.data;
+    }
+    const issues = result.error.issues.flatMap((issue) => describeIssue(issue));
+    throw new InputValidationError(`En el JSON de --cargar: ${issues.map((issue) => issue.mensaje).join(' ')}`, {
+        campos: issues,
+    });
+}
+/** El JSON de `--cargar` es un comprobante (objeto) o un lote (array no vacio). Devuelve los items sin validar. */
+export function readBillingJsonItems(source) {
+    if (Array.isArray(source)) {
+        if (source.length === 0) {
+            throw new InputValidationError('El JSON de --cargar es un lote vacío: no hay comprobantes para procesar.');
+        }
+        return source;
+    }
+    if (typeof source !== 'object' || source === null) {
+        throw new InputValidationError(`El JSON de --cargar tiene que ser un objeto o un array de objetos y es ${describeReceived(source)}.`);
+    }
+    return [source];
+}

package/dist/modules/billing/billing.labels.js

@@ -76,7 +76,7 @@ export function formatCurrencyLabel(value) {
         case 'PES':
             return 'Pesos argentinos (ARS)';
         case 'DOL':
-            return 'Dolares estadounidenses (USD)';
+            return 'Dólares estadounidenses (USD)';
         default:
             return value ?? 'N/D';
     }
@@ -105,4 +105,3 @@ export function formatDecimalLabel(value) {
         maximumFractionDigits: 6,
     }).format(value);
 }
-//# sourceMappingURL=billing.labels.js.map

package/dist/modules/billing/billing.mappers.js

@@ -57,4 +57,3 @@ export function formatDocumentFlag(documentType) {
             return '--consumidor-final';
     }
 }
-//# sourceMappingURL=billing.mappers.js.map