arcli 0.1.1 → 1.1.0

package/dist/modules/config/config.schemas.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export declare const arcliEnvironmentSchema: z.ZodEnum<{
+    produccion: "produccion";
+    testing: "testing";
+}>;
+export declare const arcliDefaultConceptSchema: z.ZodEnum<{
+    productos: "productos";
+    "productos-servicios": "productos-servicios";
+    servicios: "servicios";
+}>;
+export declare const arcliDefaultIvaConditionSchema: z.ZodEnum<{
+    "cliente-del-exterior": "cliente-del-exterior";
+    "consumidor-final": "consumidor-final";
+    "iva-liberado": "iva-liberado";
+    "iva-no-alcanzado": "iva-no-alcanzado";
+    "monotributista-social": "monotributista-social";
+    "monotributo-trabajador-independiente-promovido": "monotributo-trabajador-independiente-promovido";
+    "proveedor-del-exterior": "proveedor-del-exterior";
+    "responsable-inscripto": "responsable-inscripto";
+    "responsable-monotributo": "responsable-monotributo";
+    "sujeto-exento": "sujeto-exento";
+    "sujeto-no-categorizado": "sujeto-no-categorizado";
+}>;
+export declare const arcliDefaultCurrencySchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const arcliConfigSchema: z.ZodObject<{
+    cert: z.ZodDefault<z.ZodObject<{
+        produccion: z.ZodOptional<z.ZodString>;
+        testing: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cuit: z.ZodOptional<z.ZodString>;
+    conceptoPorDefecto: z.ZodOptional<z.ZodEnum<{
+        productos: "productos";
+        "productos-servicios": "productos-servicios";
+        servicios: "servicios";
+    }>>;
+    ivaReceptorPorDefecto: z.ZodOptional<z.ZodEnum<{
+        "cliente-del-exterior": "cliente-del-exterior";
+        "consumidor-final": "consumidor-final";
+        "iva-liberado": "iva-liberado";
+        "iva-no-alcanzado": "iva-no-alcanzado";
+        "monotributista-social": "monotributista-social";
+        "monotributo-trabajador-independiente-promovido": "monotributo-trabajador-independiente-promovido";
+        "proveedor-del-exterior": "proveedor-del-exterior";
+        "responsable-inscripto": "responsable-inscripto";
+        "responsable-monotributo": "responsable-monotributo";
+        "sujeto-exento": "sujeto-exento";
+        "sujeto-no-categorizado": "sujeto-no-categorizado";
+    }>>;
+    monedaPorDefecto: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    cotizacionPorDefecto: z.ZodOptional<z.ZodNumber>;
+    entornoPorDefecto: z.ZodDefault<z.ZodEnum<{
+        produccion: "produccion";
+        testing: "testing";
+    }>>;
+    key: z.ZodDefault<z.ZodObject<{
+        produccion: z.ZodOptional<z.ZodString>;
+        testing: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    output: z.ZodDefault<z.ZodObject<{
+        emitirPorDefecto: z.ZodDefault<z.ZodBoolean>;
+        jsonPorDefecto: z.ZodDefault<z.ZodBoolean>;
+        brutoPorDefecto: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    puntoVentaPorDefecto: z.ZodOptional<z.ZodNumber>;
+    ticketPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ArcliConfig = z.infer<typeof arcliConfigSchema>;
+export type ArcliEnvironment = z.infer<typeof arcliEnvironmentSchema>;
+export declare const CONFIG_DEFAULTS: ArcliConfig;
+export declare const configPublicKeySchema: z.ZodEnum<{
+    cuit: "cuit";
+    ticketPath: "ticketPath";
+    "cert.produccion": "cert.produccion";
+    "cert.testing": "cert.testing";
+    concepto: "concepto";
+    cotizacion: "cotizacion";
+    entorno: "entorno";
+    emitir: "emitir";
+    ivaReceptor: "ivaReceptor";
+    json: "json";
+    "key.produccion": "key.produccion";
+    "key.testing": "key.testing";
+    moneda: "moneda";
+    bruto: "bruto";
+    puntoVenta: "puntoVenta";
+}>;
+export type ConfigPublicKey = z.infer<typeof configPublicKeySchema>;

package/dist/modules/config/config.schemas.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+export const arcliEnvironmentSchema = z.enum(['testing', 'produccion']);
+export const arcliDefaultConceptSchema = z.enum(['productos', 'productos-servicios', 'servicios']);
+export const arcliDefaultIvaConditionSchema = z.enum([
+    'cliente-del-exterior',
+    'consumidor-final',
+    'iva-liberado',
+    'iva-no-alcanzado',
+    'monotributista-social',
+    'monotributo-trabajador-independiente-promovido',
+    'proveedor-del-exterior',
+    'responsable-inscripto',
+    'responsable-monotributo',
+    'sujeto-exento',
+    'sujeto-no-categorizado',
+]);
+export const arcliDefaultCurrencySchema = z
+    .string()
+    .trim()
+    .length(3)
+    .transform((value) => value.toUpperCase());
+export const arcliConfigSchema = z.object({
+    cert: z
+        .object({
+        produccion: z.string().trim().min(1).optional(),
+        testing: z.string().trim().min(1).optional(),
+    })
+        .default({}),
+    cuit: z
+        .string()
+        .trim()
+        .regex(/^\d{11}$/, 'El CUIT debe tener 11 digitos')
+        .optional(),
+    conceptoPorDefecto: arcliDefaultConceptSchema.optional(),
+    ivaReceptorPorDefecto: arcliDefaultIvaConditionSchema.optional(),
+    monedaPorDefecto: arcliDefaultCurrencySchema.optional(),
+    cotizacionPorDefecto: z.number().positive().optional(),
+    entornoPorDefecto: arcliEnvironmentSchema.default('testing'),
+    key: z
+        .object({
+        produccion: z.string().trim().min(1).optional(),
+        testing: z.string().trim().min(1).optional(),
+    })
+        .default({}),
+    output: z
+        .object({
+        emitirPorDefecto: z.boolean().default(false),
+        jsonPorDefecto: z.boolean().default(false),
+        brutoPorDefecto: z.boolean().default(false),
+    })
+        .default({ emitirPorDefecto: false, jsonPorDefecto: false, brutoPorDefecto: false }),
+    puntoVentaPorDefecto: z.number().int().positive().optional(),
+    ticketPath: z.string().trim().min(1).optional(),
+});
+export const CONFIG_DEFAULTS = {
+    cert: {},
+    entornoPorDefecto: 'testing',
+    key: {},
+    monedaPorDefecto: 'PES',
+    cotizacionPorDefecto: 1,
+    output: {
+        emitirPorDefecto: false,
+        jsonPorDefecto: false,
+        brutoPorDefecto: false,
+    },
+};
+export const configPublicKeySchema = z.enum([
+    'cert.produccion',
+    'cert.testing',
+    'concepto',
+    'cuit',
+    'cotizacion',
+    'entorno',
+    'emitir',
+    'ivaReceptor',
+    'json',
+    'key.produccion',
+    'key.testing',
+    'moneda',
+    'bruto',
+    'puntoVenta',
+    'ticketPath',
+]);
+//# sourceMappingURL=config.schemas.js.map

package/dist/modules/config/config.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.schemas.js","sourceRoot":"","sources":["../../../src/modules/config/config.schemas.ts"],"names":[],"mappings":"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"}

package/dist/modules/config/config.service.d.ts

@@ -0,0 +1,20 @@
+import { ArcliConfig } from './config.schemas';
+export interface ConfigServiceOptions {
+    readonly configName?: string;
+    readonly cwd?: string;
+    readonly projectName?: string;
+}
+export declare class ConfigService {
+    private readonly store;
+    constructor(options?: ConfigServiceOptions);
+    close(): void;
+    getConfig(): ArcliConfig;
+    getPath(): string;
+    getDefaultTicketPath(): string;
+    resolveTicketPath(config: ArcliConfig): string;
+    initialize(): ArcliConfig;
+    ensureInitialized(): ArcliConfig;
+    setValue(rawKey: string, rawValue: string): ArcliConfig;
+    unsetValue(rawKey: string): ArcliConfig;
+    private resolveKey;
+}

package/dist/modules/config/config.service.js

@@ -0,0 +1,78 @@
+import Conf from 'conf';
+import { dirname, join } from 'node:path';
+import { arcliConfigSchema, CONFIG_DEFAULTS, configPublicKeySchema, } from './config.schemas.js';
+import { parseConfigValue } from './config-value-parser.js';
+const CONFIG_KEY_ALIASES = {
+    'cert.produccion': 'cert.produccion',
+    'cert.testing': 'cert.testing',
+    concepto: 'conceptoPorDefecto',
+    cotizacion: 'cotizacionPorDefecto',
+    cuit: 'cuit',
+    entorno: 'entornoPorDefecto',
+    emitir: 'output.emitirPorDefecto',
+    ivaReceptor: 'ivaReceptorPorDefecto',
+    json: 'output.jsonPorDefecto',
+    'key.produccion': 'key.produccion',
+    'key.testing': 'key.testing',
+    moneda: 'monedaPorDefecto',
+    bruto: 'output.brutoPorDefecto',
+    puntoVenta: 'puntoVentaPorDefecto',
+    ticketPath: 'ticketPath',
+};
+export class ConfigService {
+    store;
+    constructor(options = {}) {
+        this.store = new Conf({
+            clearInvalidConfig: false,
+            configName: options.configName ?? 'config',
+            cwd: options.cwd,
+            defaults: CONFIG_DEFAULTS,
+            projectName: options.projectName ?? 'arcli',
+            projectSuffix: '',
+        });
+    }
+    close() {
+        this.store._closeWatcher();
+    }
+    getConfig() {
+        return arcliConfigSchema.parse(this.store.store);
+    }
+    getPath() {
+        return this.store.path;
+    }
+    getDefaultTicketPath() {
+        return join(dirname(this.store.path), 'tickets');
+    }
+    resolveTicketPath(config) {
+        return config.ticketPath ?? this.getDefaultTicketPath();
+    }
+    initialize() {
+        const config = this.getConfig();
+        this.store.store = config;
+        return config;
+    }
+    ensureInitialized() {
+        return this.initialize();
+    }
+    setValue(rawKey, rawValue) {
+        const key = this.resolveKey(rawKey);
+        const canonicalKey = CONFIG_KEY_ALIASES[key];
+        const parsedValue = parseConfigValue(canonicalKey, rawValue);
+        this.store.set(canonicalKey, parsedValue);
+        const config = this.getConfig();
+        this.store.store = config;
+        return config;
+    }
+    unsetValue(rawKey) {
+        const key = this.resolveKey(rawKey);
+        const canonicalKey = CONFIG_KEY_ALIASES[key];
+        this.store.delete(canonicalKey);
+        const config = this.getConfig();
+        this.store.store = config;
+        return config;
+    }
+    resolveKey(rawKey) {
+        return configPublicKeySchema.parse(rawKey.trim());
+    }
+}
+//# sourceMappingURL=config.service.js.map

package/dist/modules/config/config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../../../src/modules/config/config.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/examples/examples.d.ts

@@ -0,0 +1 @@
+export declare function renderExamples(): string;

package/dist/modules/examples/examples.js

@@ -0,0 +1,156 @@
+import { badge, bold, renderLogo, renderPanel, toneText } from '../../ui/index.js';
+import { VOUCHER_FAMILIES, VOUCHER_KIND_MAP, VOUCHER_SHORTCUTS } from '../billing/voucher-kind-map.js';
+const ISSUER_HINT = 'Estos ejemplos asumen que ya resolviste cuit emisor, credenciales y, en la version minima, tambien punto de venta por config.';
+function resolveAmount(definition) {
+    if (definition.letter === 'a') {
+        return 1;
+    }
+    if (definition.letter === 'b') {
+        return 15000;
+    }
+    return 300000;
+}
+function resolveIdentityLong(definition) {
+    if (definition.letter === 'a') {
+        return ['--cuit 20168598204', '--iva-receptor responsable-inscripto'];
+    }
+    return ['--consumidor-final', '--iva-receptor consumidor-final'];
+}
+function resolveIdentityShort(definition) {
+    if (definition.letter === 'a') {
+        return ['--cuit 20168598204', '--ir-ri'];
+    }
+    return ['--cfinal', '--ir-cf'];
+}
+function resolveAssociatedShortcut(definition) {
+    if (!definition.requiresAssociatedVoucher) {
+        return '';
+    }
+    if (definition.family === 'nota-credito') {
+        return `f${definition.letter}`;
+    }
+    if (definition.family === 'nota-debito') {
+        return `f${definition.letter}`;
+    }
+    if (definition.family === 'nota-credito-electronica') {
+        return `fce${definition.letter}`;
+    }
+    return `fce${definition.letter}`;
+}
+function buildMinimalLong(definition) {
+    const command = [
+        `arcli ${definition.family} ${definition.letter}`,
+        `--monto ${resolveAmount(definition)}`,
+        '--concepto servicios',
+    ];
+    command.push(...resolveIdentityLong(definition));
+    if (definition.requiresAssociatedVoucher) {
+        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--asociado-punto-venta 3', '--ar 120', '--acuit 20409509763');
+    }
+    command.push('--previsualizar');
+    return command.join(' ');
+}
+function buildMinimalShort(definition) {
+    const command = [`arcli ${definition.shortcut}`, `-m ${resolveAmount(definition)}`, '--cs'];
+    command.push(...resolveIdentityShort(definition));
+    if (definition.requiresAssociatedVoucher) {
+        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--apv 3', '--ar 120', '--acuit 20409509763');
+    }
+    command.push('--previsualizar');
+    return command.join(' ');
+}
+function buildFullLong(definition) {
+    const command = [
+        `arcli ${definition.family} ${definition.letter}`,
+        `--monto ${resolveAmount(definition)}`,
+        '--concepto servicios',
+        '--punto-venta 3',
+        '--fecha 31-03-2026',
+        '--moneda PES',
+        '--cotizacion-moneda 1',
+        '--dia 31',
+        '--servicio-desde 01-03-2026',
+        '--servicio-hasta 31-03-2026',
+    ];
+    command.push(...resolveIdentityLong(definition));
+    if (definition.requiresAssociatedVoucher) {
+        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--asociado-punto-venta 3', '--ar 120', '--acuit 20409509763');
+    }
+    command.push('--previsualizar');
+    return command.join(' ');
+}
+function buildFullShort(definition) {
+    const command = [
+        `arcli ${definition.shortcut}`,
+        `-m ${resolveAmount(definition)}`,
+        '--cs',
+        '--pv 3',
+        '-f 31-03-2026',
+        '--mda PES',
+        '--cm 1',
+        '-d 31',
+        '--sd 01-03-2026',
+        '--sh 31-03-2026',
+    ];
+    command.push(...resolveIdentityShort(definition));
+    if (definition.requiresAssociatedVoucher) {
+        command.push(`--ac ${resolveAssociatedShortcut(definition)}`, '--apv 3', '--ar 120', '--acuit 20409509763');
+    }
+    command.push('--previsualizar');
+    return command.join(' ');
+}
+function formatVoucherExample(definition) {
+    return [
+        renderPanel({
+            borderType: 'note',
+            content: bold(definition.displayName.toUpperCase()),
+            contentAlign: 'left',
+            padding: {
+                top: 0,
+                bottom: 0,
+                left: 0,
+                right: 0,
+            },
+            width: 'standard',
+        }),
+        '',
+        `${badge('MINIMA LARGA', 'info')}`,
+        `${buildMinimalLong(definition)}`,
+        '',
+        `${badge('MINIMA CORTA', 'success')}`,
+        `${buildMinimalShort(definition)}`,
+        '',
+        `${badge('FULL LARGA', 'warning')}`,
+        `${buildFullLong(definition)}`,
+        '',
+        `${badge('FULL CORTA', 'debug')}`,
+        `${buildFullShort(definition)}`,
+    ].join('\n');
+}
+function renderFamilyExamples(family) {
+    return VOUCHER_SHORTCUTS.map((shortcut) => VOUCHER_KIND_MAP[shortcut])
+        .filter((definition) => definition.family === family)
+        .map(formatVoucherExample)
+        .join('\n\n\n');
+}
+export function renderExamples() {
+    return [
+        renderLogo().trim(),
+        '',
+        `${badge('MINIMA', 'info')} datos esenciales`,
+        `${badge('FULL', 'warning')} mas campos explicitados`,
+        `${badge('LARGA', 'success')} comando largo`,
+        `${badge('CORTA', 'debug')} shortcut y aliases`,
+        '',
+        toneText('SEGURIDAD', 'warning'),
+        'Todos usan --previsualizar para evitar emisiones reales por error.',
+        'Si queres emitir de verdad, reemplaza --previsualizar por --emitir.',
+        'Para emitir en produccion necesitas --produccion junto con --emitir.',
+        '',
+        ISSUER_HINT,
+        '',
+        ...VOUCHER_FAMILIES.flatMap((family) => [renderFamilyExamples(family), '']),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=examples.js.map

package/dist/modules/examples/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../src/modules/examples/examples.ts"],"names":[],"mappings":"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"}

package/dist/modules/storybook/showcase-theme.d.ts

@@ -0,0 +1,7 @@
+import type { UiWidthPreset } from '../../ui';
+export interface StorybookShowcaseTheme {
+    readonly borderColor: string;
+    readonly indexPanelWidth: UiWidthPreset;
+    readonly sceneWidth: UiWidthPreset;
+}
+export declare const STORYBOOK_SHOWCASE_THEME: StorybookShowcaseTheme;

package/dist/modules/storybook/showcase-theme.js

@@ -0,0 +1,6 @@
+export const STORYBOOK_SHOWCASE_THEME = {
+    borderColor: 'magenta',
+    indexPanelWidth: 'wide',
+    sceneWidth: 'wide',
+};
+//# sourceMappingURL=showcase-theme.js.map

package/dist/modules/storybook/showcase-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-theme.js","sourceRoot":"","sources":["../../../src/modules/storybook/showcase-theme.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,MAAM;IACvB,UAAU,EAAE,MAAM;CACnB,CAAC"}

package/dist/modules/storybook/showcase.d.ts

@@ -0,0 +1,2 @@
+export type StorybookScene = 'colores' | 'componentes' | 'comprobantes' | 'configuracion' | 'errores' | 'json';
+export declare function renderStorybookShowcase(scene?: StorybookScene): string;