arca-siradig 1.0.0

package/dist/src/cli/options.d.ts

@@ -0,0 +1,120 @@
+export type OutputFormat = "text" | "json";
+export type HelpCommand = {
+    kind: "help";
+    headless: boolean;
+    topic: "root" | "login" | "logout" | "persons" | "personal-data" | "employees" | "deductions" | "form";
+};
+export type InteractiveCommand = {
+    kind: "interactive";
+    headless: boolean;
+};
+export type LogoutCommand = {
+    kind: "logout";
+};
+export type LoginCommand = {
+    kind: "login";
+    headless: boolean;
+    cuit?: string;
+    password?: string;
+    hasExplicitCredentials: boolean;
+};
+export type PersonsListCommand = {
+    kind: "persons-list";
+    headless: boolean;
+    format: OutputFormat;
+};
+export type PersonsSelectCommand = {
+    kind: "persons-select";
+    headless: boolean;
+    person: string;
+};
+export type PersonsPersonalDataShowCommand = {
+    kind: "persons-personal-data-show";
+    headless: boolean;
+    person?: string;
+    format: OutputFormat;
+};
+export type PersonsEmployeesListCommand = {
+    kind: "persons-employees-list";
+    headless: boolean;
+    person?: string;
+    format: OutputFormat;
+};
+export type PersonsEmployeesShowCommand = {
+    kind: "persons-employees-show";
+    headless: boolean;
+    person?: string;
+    employeeCuit: string;
+    format: OutputFormat;
+};
+export type FormDeductionsListCommand = {
+    period?: number;
+    kind: "form-deductions-list";
+    headless: boolean;
+    person?: string;
+    format: OutputFormat;
+};
+export type FormDeductionsListReceiptTypesCommand = {
+    kind: "form-deductions-list-receipt-types";
+    headless: boolean;
+    format: OutputFormat;
+};
+export type FormDeductionsShowCommand = {
+    period?: number;
+    kind: "form-deductions-show";
+    headless: boolean;
+    person?: string;
+    deductionId: string;
+    format: OutputFormat;
+};
+export type FormDeductionsAddItemCommand = {
+    period: number;
+    person?: string;
+    kind: "form-deductions-add-item";
+    headless: boolean;
+    deductionType: string;
+    cuit: string;
+    month: number;
+    amount: string;
+};
+export type FormDeductionsAddItemReceiptCommand = {
+    period: number;
+    person?: string;
+    kind: "form-deductions-add-item-receipt";
+    headless: boolean;
+    deductionType: string;
+    cuit: string;
+    month: number;
+    date: string;
+    receiptType: string;
+    number: string;
+    amount: string;
+    reimbursedAmount?: string;
+};
+export type FormDeductionsRemoveItemReceiptCommand = {
+    period: number;
+    person?: string;
+    kind: "form-deductions-remove-item-receipt";
+    headless: boolean;
+    deductionType: string;
+    cuit: string;
+    number: string;
+};
+export type FormPreviewCommand = {
+    kind: "form-summary" | "form-show" | "form-print";
+    headless: boolean;
+    person?: string;
+    period?: number;
+    format: OutputFormat;
+    path?: string;
+};
+export type FormSubmitCommand = {
+    kind: "form-submit";
+    headless: boolean;
+    person?: string;
+    period: number;
+    accept: boolean;
+    format: OutputFormat;
+};
+export type CliCommand = FormSubmitCommand | FormPreviewCommand | HelpCommand | InteractiveCommand | LogoutCommand | LoginCommand | PersonsListCommand | PersonsSelectCommand | PersonsPersonalDataShowCommand | PersonsEmployeesListCommand | PersonsEmployeesShowCommand | FormDeductionsListCommand | FormDeductionsListReceiptTypesCommand | FormDeductionsShowCommand | FormDeductionsAddItemCommand | FormDeductionsAddItemReceiptCommand | FormDeductionsRemoveItemReceiptCommand;
+export declare function parseCliOptions(args: string[]): CliCommand;

package/dist/src/cli/options.js

@@ -0,0 +1,419 @@
+export function parseCliOptions(args) {
+    let accept = false;
+    let headless = true;
+    let interactive = false;
+    let help = false;
+    let cuit;
+    let password;
+    let person;
+    let employeeCuit;
+    let deductionType;
+    let month;
+    let date;
+    let receiptType;
+    let number;
+    let amount;
+    let reimbursedAmount;
+    let period;
+    let path;
+    let format = "text";
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+            continue;
+        }
+        if (arg === "--interactive" || arg === "-i") {
+            interactive = true;
+            continue;
+        }
+        if (arg === "--headless") {
+            headless = parseBooleanFlagValue(readFlagValue(args, index, "--headless"), "--headless");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--headless=")) {
+            headless = parseBooleanFlagValue(arg.slice("--headless=".length), "--headless");
+            continue;
+        }
+        if (arg === "--cuit") {
+            cuit = readFlagValue(args, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--cuit=")) {
+            cuit = arg.slice("--cuit=".length);
+            continue;
+        }
+        if (arg === "--password") {
+            password = readFlagValue(args, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--password=")) {
+            password = arg.slice("--password=".length);
+            continue;
+        }
+        if (arg === "--person") {
+            person = readFlagValue(args, index, "--person");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--person=")) {
+            person = arg.slice("--person=".length);
+            continue;
+        }
+        if (arg === "--employee-cuit") {
+            employeeCuit = readFlagValue(args, index, "--employee-cuit");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--employee-cuit=")) {
+            employeeCuit = arg.slice("--employee-cuit=".length);
+            continue;
+        }
+        if (arg === "--type") {
+            deductionType = readFlagValue(args, index, "--type");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--type=")) {
+            deductionType = arg.slice("--type=".length);
+            continue;
+        }
+        if (arg === "--month") {
+            month = readFlagValue(args, index, "--month");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--month=")) {
+            month = arg.slice("--month=".length);
+            continue;
+        }
+        if (arg === "--date") {
+            date = readFlagValue(args, index, "--date");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--date=")) {
+            date = arg.slice("--date=".length);
+            continue;
+        }
+        if (arg === "--receipt-type") {
+            receiptType = readFlagValue(args, index, "--receipt-type");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--receipt-type=")) {
+            receiptType = arg.slice("--receipt-type=".length);
+            continue;
+        }
+        if (arg === "--number") {
+            number = readFlagValue(args, index, "--number");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--number=")) {
+            number = arg.slice("--number=".length);
+            continue;
+        }
+        if (arg === "--amount") {
+            amount = readFlagValue(args, index, "--amount");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--amount=")) {
+            amount = arg.slice("--amount=".length);
+            continue;
+        }
+        if (arg === "--reimbursed-amount") {
+            reimbursedAmount = readFlagValue(args, index, "--reimbursed-amount");
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--reimbursed-amount=")) {
+            reimbursedAmount = arg.slice("--reimbursed-amount=".length);
+            continue;
+        }
+        if (arg === "--period" || arg.startsWith("--period=")) {
+            const value = arg === "--period" ? readFlagValue(args, index++, "--period") : arg.slice(9);
+            if (!/^[12]\d{3}$/.test(value))
+                throw new Error("--period expects a four-digit fiscal year.");
+            period = Number(value);
+            continue;
+        }
+        if (arg === "--path" || arg.startsWith("--path=")) {
+            path = arg === "--path" ? readFlagValue(args, index++, "--path") : arg.slice(7);
+            continue;
+        }
+        if (arg === "--aceptar") {
+            accept = true;
+            continue;
+        }
+        if (arg === "--format") {
+            format = parseOutputFormat(readFlagValue(args, index, "--format"));
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--format=")) {
+            format = parseOutputFormat(arg.slice("--format=".length));
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown option: ${arg.split("=", 1)[0]}`);
+        }
+        positionals.push(arg);
+    }
+    if (positionals[0] === "deductions") {
+        throw new Error("Unknown command: deductions. Use arca-siradig form deductions <command>.");
+    }
+    if (help || args.length === 0) {
+        return { kind: "help", headless, topic: inferHelpTopic(positionals) };
+    }
+    if (accept && !(positionals[0] === "form" && positionals[1] === "submit")) {
+        throw new Error("--aceptar is only supported for form submit.");
+    }
+    if (period !== undefined && positionals[0] !== "form") {
+        throw new Error("--period is only supported for form commands.");
+    }
+    if (path !== undefined && !(positionals[0] === "form" && positionals[1] === "print")) {
+        throw new Error("--path is only supported for form print.");
+    }
+    if (positionals[0] === "form" && positionals[1] === "submit" && positionals.length === 2) {
+        return { kind: "form-submit", headless, person, period: requirePeriod(period), accept, format };
+    }
+    if (positionals[0] === "form" &&
+        positionals.length === 2 &&
+        ["show", "summary", "print"].includes(positionals[1])) {
+        return {
+            kind: positionals[1] === "show"
+                ? "form-show"
+                : positionals[1] === "summary"
+                    ? "form-summary"
+                    : "form-print",
+            headless,
+            person,
+            period,
+            format,
+            ...(positionals[1] === "print" ? { path: readRequiredFlag(path, "--path") } : {}),
+        };
+    }
+    const formContext = period === undefined ? {} : { period };
+    const deductionPositionals = positionals[0] === "form" && positionals[1] === "deductions" ? positionals.slice(2) : [];
+    if (interactive) {
+        return { kind: "interactive", headless };
+    }
+    if (positionals[0] === "login" && positionals.length === 1) {
+        return {
+            kind: "login",
+            headless,
+            cuit,
+            password,
+            hasExplicitCredentials: Boolean(cuit || password),
+        };
+    }
+    if (positionals[0] === "logout" && positionals.length === 1) {
+        return { kind: "logout" };
+    }
+    if (positionals[0] === "persons" && positionals[1] === "list" && positionals.length === 2) {
+        return { kind: "persons-list", headless, format };
+    }
+    if (positionals[0] === "persons" && positionals[1] === "select" && positionals.length === 3) {
+        return {
+            kind: "persons-select",
+            headless,
+            person: positionals[2],
+        };
+    }
+    if (positionals[0] === "personal-data" &&
+        positionals[1] === "show" &&
+        (positionals.length === 2 || positionals.length === 3)) {
+        return {
+            kind: "persons-personal-data-show",
+            headless,
+            person: person ?? positionals[2],
+            format,
+        };
+    }
+    if (positionals[0] === "employees" &&
+        positionals[1] === "list" &&
+        (positionals.length === 2 || positionals.length === 3)) {
+        return {
+            kind: "persons-employees-list",
+            headless,
+            person: person ?? positionals[2],
+            format,
+        };
+    }
+    if (positionals[0] === "employees" &&
+        positionals[1] === "show" &&
+        (positionals.length === 2 || positionals.length === 3)) {
+        return {
+            kind: "persons-employees-show",
+            headless,
+            person: person ?? positionals[2],
+            employeeCuit: readRequiredFlag(employeeCuit, "--employee-cuit"),
+            format,
+        };
+    }
+    if (deductionPositionals[0] === "list-receipt-types" && deductionPositionals.length === 1) {
+        if (period !== undefined)
+            throw new Error("The receipt type catalog does not have a fiscal period.");
+        return {
+            kind: "form-deductions-list-receipt-types",
+            headless,
+            format,
+        };
+    }
+    if (deductionPositionals[0] === "list" && deductionPositionals.length === 1) {
+        return {
+            kind: "form-deductions-list",
+            ...formContext,
+            headless,
+            person,
+            format,
+        };
+    }
+    if (deductionPositionals[0] === "show" && deductionPositionals.length === 2) {
+        return {
+            kind: "form-deductions-show",
+            ...formContext,
+            headless,
+            deductionId: readRequiredPositional(deductionPositionals[1], "deduction id"),
+            person,
+            format,
+        };
+    }
+    if (deductionPositionals[0] === "add-item" && deductionPositionals.length === 1) {
+        return {
+            kind: "form-deductions-add-item",
+            period: requirePeriod(period),
+            ...(person === undefined ? {} : { person }),
+            headless,
+            deductionType: readRequiredFlag(deductionType, "--type"),
+            cuit: readRequiredFlag(cuit, "--cuit"),
+            month: parseRequiredMonth(month, "--month"),
+            amount: readRequiredFlag(amount, "--amount"),
+        };
+    }
+    if (deductionPositionals[0] === "add-item-receipt" && deductionPositionals.length === 1) {
+        const normalizedDeductionType = readRequiredFlag(deductionType, "--type");
+        const isMedicalExpenses = normalizedDeductionType === "gastos-medicos";
+        if (date && period !== undefined && Number(date.slice(0, 4)) !== period) {
+            throw new Error("--date must belong to the fiscal year specified by --period.");
+        }
+        return {
+            kind: "form-deductions-add-item-receipt",
+            period: requirePeriod(period),
+            ...(person === undefined ? {} : { person }),
+            headless,
+            deductionType: normalizedDeductionType,
+            cuit: readRequiredFlag(cuit, "--cuit"),
+            month: parseRequiredMonth(month, "--month"),
+            date: readRequiredFlag(date, "--date"),
+            receiptType: readRequiredFlag(receiptType, "--receipt-type"),
+            number: readRequiredFlag(number, "--number"),
+            amount: readRequiredFlag(amount, "--amount"),
+            reimbursedAmount: isMedicalExpenses
+                ? readRequiredFlag(reimbursedAmount, "--reimbursed-amount")
+                : reimbursedAmount,
+        };
+    }
+    if (deductionPositionals[0] === "remove-item-receipt" && deductionPositionals.length === 1) {
+        return {
+            kind: "form-deductions-remove-item-receipt",
+            period: requirePeriod(period),
+            ...(person === undefined ? {} : { person }),
+            headless,
+            deductionType: deductionType?.trim() || "gastos-medicos",
+            cuit: readRequiredFlag(cuit, "--cuit"),
+            number: readRequiredFlag(number, "--number"),
+        };
+    }
+    if (positionals.length === 1) {
+        const [command] = positionals;
+        if (command === "login" ||
+            command === "persons" ||
+            command === "personal-data" ||
+            command === "employees" ||
+            command === "form" ||
+            command === "logout") {
+            return { kind: "help", headless, topic: command };
+        }
+    }
+    if (positionals[0] === "form" && positionals[1] === "deductions" && positionals.length === 2) {
+        return { kind: "help", headless, topic: "deductions" };
+    }
+    if (positionals[0] === "persons" && positionals[1] === "select" && positionals.length === 2) {
+        return { kind: "help", headless, topic: "persons" };
+    }
+    throw new Error(`Unknown command: ${positionals[0] ?? "(missing)"}`);
+}
+function requirePeriod(period) {
+    if (period === undefined)
+        throw new Error("--period is required for changes to a form.");
+    return period;
+}
+function readFlagValue(args, index, flagName) {
+    const value = args[index + 1];
+    if (!value || value.startsWith("-")) {
+        throw new Error(`${flagName} expects a value.`);
+    }
+    return value;
+}
+function parseBooleanFlagValue(value, flagName) {
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    throw new Error(`${flagName} expects "true" or "false".`);
+}
+function parseOutputFormat(value) {
+    if (value === "text" || value === "json") {
+        return value;
+    }
+    throw new Error('--format expects "text" or "json".');
+}
+function readRequiredFlag(value, flagName) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${flagName} is required.`);
+    }
+    return value.trim();
+}
+function readRequiredPositional(value, label) {
+    if (!value || value.trim().length === 0) {
+        throw new Error(`${label} is required.`);
+    }
+    return value.trim();
+}
+function parseRequiredMonth(value, flagName) {
+    const rawValue = readRequiredFlag(value, flagName);
+    const month = Number.parseInt(rawValue, 10);
+    if (!/^\d{1,2}$/.test(rawValue) || !Number.isInteger(month) || month < 1 || month > 12) {
+        throw new Error(`${flagName} expects an integer from 1 to 12.`);
+    }
+    return month;
+}
+function inferHelpTopic(positionals) {
+    if (positionals[0] === "persons") {
+        return "persons";
+    }
+    if (positionals[0] === "personal-data") {
+        return "personal-data";
+    }
+    if (positionals[0] === "employees") {
+        return "employees";
+    }
+    if (positionals[0] === "login") {
+        return "login";
+    }
+    if (positionals[0] === "form")
+        return positionals[1] === "deductions" ? "deductions" : "form";
+    if (positionals[0] === "logout") {
+        return "logout";
+    }
+    return "root";
+}

package/dist/src/cli/prompts.d.ts

@@ -0,0 +1,9 @@
+import type { ArcaCredentials, MenuItem, Person } from "../types.js";
+export declare function promptFormSubmission(): Promise<boolean>;
+export declare function promptCredentials(defaults: Partial<ArcaCredentials>, options?: {
+    usePasswordDefault?: boolean;
+}): Promise<ArcaCredentials>;
+export declare function promptMissingCredentials(values: Partial<ArcaCredentials>, defaults: Partial<ArcaCredentials>): Promise<ArcaCredentials>;
+export declare function promptPerson(persons: Person[]): Promise<Person>;
+export declare function promptMenuItem(items: MenuItem[]): Promise<MenuItem>;
+export declare function promptPersonalDataAction(): Promise<"main-menu">;

package/dist/src/cli/prompts.js

@@ -0,0 +1,99 @@
+import { input, password, select } from "@inquirer/prompts";
+const MAIN_MENU_ACTION = "main-menu";
+export async function promptFormSubmission() {
+    try {
+        return await select({
+            message: "¿Querés generar la presentación y enviarla al empleador?",
+            default: false,
+            choices: [
+                { name: "Cancelar", value: false },
+                { name: "Aceptar — Generar Presentación", value: true },
+            ],
+        }, { output: process.stderr });
+    }
+    catch (error) {
+        if (error instanceof Error && ["ExitPromptError", "AbortPromptError"].includes(error.name)) {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function promptCredentials(defaults, options = {}) {
+    const usePasswordDefault = options.usePasswordDefault ?? true;
+    const cuit = await input({
+        message: "CUIT/CUIL:",
+        default: defaults.cuit,
+        validate: (value) => (value.trim().length > 0 ? true : "Ingresá un CUIT/CUIL."),
+    });
+    const normalizedCuit = cuit.trim();
+    const normalizedDefaultCuit = defaults.cuit?.trim();
+    const passwordDefault = usePasswordDefault && normalizedCuit === normalizedDefaultCuit ? defaults.password : undefined;
+    const passwordMessage = passwordDefault
+        ? `Clave fiscal (${maskSecret(passwordDefault)}; presioná enter para usarla):`
+        : "Clave fiscal:";
+    const passwordValue = await password({
+        message: passwordMessage,
+        mask: "*",
+        validate: (value) => (value.length > 0 || passwordDefault ? true : "Ingresá la clave fiscal."),
+    });
+    return {
+        cuit: normalizedCuit,
+        password: passwordValue.length > 0 ? passwordValue : (passwordDefault ?? ""),
+    };
+}
+export async function promptMissingCredentials(values, defaults) {
+    const cuit = values.cuit ??
+        (await input({
+            message: "CUIT/CUIL:",
+            default: defaults.cuit,
+            validate: (value) => (value.trim().length > 0 ? true : "Ingresá un CUIT/CUIL."),
+        })).trim();
+    const passwordDefault = cuit === defaults.cuit?.trim() ? defaults.password : undefined;
+    const resolvedPassword = values.password ??
+        (await promptPassword({
+            defaultPassword: passwordDefault,
+            defaultLabel: passwordDefault
+                ? `Clave fiscal (${maskSecret(passwordDefault)}; presioná enter para usarla):`
+                : "Clave fiscal:",
+        }));
+    return { cuit, password: resolvedPassword };
+}
+export async function promptPerson(persons) {
+    const person = await select({
+        message: "Seleccione la persona a representar:",
+        choices: persons.map((item) => ({
+            name: item.id ? `${item.id}: ${item.name}` : item.name,
+            value: item,
+        })),
+    });
+    return person;
+}
+export async function promptMenuItem(items) {
+    const item = await select({
+        message: "Seleccione una acción:",
+        choices: items.map((menuItem) => ({
+            name: menuItem.label,
+            value: menuItem,
+            disabled: menuItem.enabled ? false : "No disponible en esta versión",
+        })),
+    });
+    return item;
+}
+export async function promptPersonalDataAction() {
+    console.log();
+    return select({
+        message: "Seleccione una opción:",
+        choices: [{ name: "Menú Principal", value: MAIN_MENU_ACTION }],
+    });
+}
+function maskSecret(secret) {
+    return "*".repeat(Math.max(secret.length, 4));
+}
+async function promptPassword(options) {
+    const passwordValue = await password({
+        message: options.defaultLabel,
+        mask: "*",
+        validate: (value) => value.length > 0 || options.defaultPassword ? true : "Ingresá la clave fiscal.",
+    });
+    return passwordValue.length > 0 ? passwordValue : (options.defaultPassword ?? "");
+}

package/dist/src/cli/render.d.ts

@@ -0,0 +1,13 @@
+import type { FormSummary } from "../arca/form.js";
+import type { DataGroup, DeductionDetailView, DeductionSummary, EmployeeSummary, PersonalDataGroup, ReceiptType } from "../types.js";
+export declare function printFormSummary(summary: FormSummary): void;
+export declare function renderFormSummary(summary: FormSummary, options?: {
+    color?: boolean;
+    width?: number;
+}): string;
+export declare function printPersonalData(groups: PersonalDataGroup[]): void;
+export declare function printEmployees(employees: EmployeeSummary[]): void;
+export declare function printEmployeeData(groups: DataGroup[]): void;
+export declare function printDeductions(deductions: DeductionSummary[]): void;
+export declare function printReceiptTypes(receiptTypes: ReceiptType[]): void;
+export declare function printDeductionDetail(detail: DeductionDetailView): void;