jira-invoice 1.0.0

package/README.es.md

@@ -0,0 +1,142 @@
+# Invoice Generator
+
+> **[English version](README.md)**
+
+CLI interactivo para generar invoices PDF desde reportes de Jira Logged Time.
+
+## Requisitos
+
+- Node.js >= 18
+
+## Instalacion
+
+```bash
+cd ~/workspace/invoice-generator
+npm install
+npm run build
+npm link
+```
+
+## Configuracion inicial
+
+La primera vez que ejecutes `invoice`, un wizard te pedira:
+1. Tus datos personales (nombre, email, direccion)
+2. Los datos de tu primera empresa (nombre, direccion, moneda, tarifa, limite de horas)
+
+La configuracion se guarda en `~/.invoice/config.json`.
+
+## Uso
+
+### Modo interactivo (recomendado)
+```bash
+invoice
+```
+Flujo completo:
+1. Selecciona empresa (con opciones de agregar/editar empresa o editar tus datos)
+2. Selecciona el CSV de Jira (navegacion de directorios con filtro por texto)
+3. Confirma tarifa por hora
+4. Vista previa con opcion de editar filas
+5. Fecha del invoice (enter = hoy)
+6. Numero de invoice
+7. Si la empresa tiene limite de horas: opcion de incluir columna "horas trabajadas" en el PDF
+8. Ruta del PDF de salida
+9. Resumen y confirmacion
+10. Genera el PDF
+
+### Modo directo
+```bash
+invoice generate reporte.csv
+invoice generate reporte.csv --company acme-corp --rate 30.20
+invoice generate reporte.csv --date "April 14, 2026" --output ~/facturas/inv.pdf
+```
+
+### Opciones del modo directo
+
+| Opcion | Descripcion |
+|--------|-------------|
+| `--rate <number>` | Tarifa por hora (default: tarifa de la empresa) |
+| `--date <string>` | Fecha del invoice (default: hoy) |
+| `--number <string>` | Numero de invoice |
+| `--output <string>` | Ruta del PDF de salida |
+| `--company <id>` | ID de la empresa (requerido si hay mas de una) |
+
+### Ayuda
+```bash
+invoice --help
+invoice generate --help
+```
+
+## Multi-empresa
+
+Puedes tener multiples empresas configuradas, cada una con su propia moneda, tarifa y limite de horas.
+
+Al ejecutar `invoice` en modo interactivo, el selector te permite:
+- Seleccionar una empresa existente
+- Agregar una nueva empresa
+- Editar una empresa existente
+- Editar tus datos personales (emisor)
+
+En modo directo, usa `--company <id>` para especificar la empresa.
+
+## Moneda
+
+Cada empresa tiene su propia moneda (ej: USD, EUR, CRC). Se configura al crear o editar la empresa y se usa en toda la CLI y en el PDF generado.
+
+## Limite de horas
+
+Cada empresa puede tener un limite de horas diario (ej: 8h). Si lo tiene:
+- Las horas del CSV se limitan al maximo diario (se escalan proporcionalmente si el total del dia lo excede)
+- La vista previa muestra columnas "Trabajadas" y "Horas"
+- Opcionalmente puedes incluir ambas columnas en el PDF
+
+Si no tiene limite, las horas del CSV se usan tal cual.
+
+## Edicion de filas
+
+En la vista previa puedes editar cualquier fila antes de generar el PDF:
+- Ingresa el numero de fila
+- Modifica fecha, ticket, descripcion o horas
+- La tabla se actualiza al instante
+- Presiona enter sin numero para continuar
+
+## Formatos de CSV soportados
+
+| Formato | Descripcion |
+|---------|-------------|
+| `pivot` | Una columna por fecha (exportado con vista de calendario en Jira) |
+| `date_col` | Columna `Date` con fechas o rangos (`19/Jan/26 to 30/Jan/26`) |
+
+El formato se detecta automaticamente.
+
+## Nombre del PDF
+
+El archivo se genera con el formato: `invoice_DDMonYY_to_DDMonYY.pdf`
+
+Ejemplo: `invoice_05Jan26_to_16Jan26.pdf`
+
+## Desarrollo
+
+```bash
+npm run dev    # Ejecutar sin compilar (usa tsx)
+npm run build  # Compilar a JavaScript
+npm start      # Ejecutar la version compilada
+```
+
+## Estructura del proyecto
+
+```
+invoice-generator/
+├── src/
+│   ├── index.ts      ← Entry point (shebang + main())
+│   ├── cli.ts        ← Interfaz CLI (interactivo + directo)
+│   ├── parser.ts     ← Parseo de CSV (formatos pivot y date_col)
+│   ├── renderer.ts   ← Generacion del PDF con pdfmake
+│   ├── store.ts      ← Persistencia de config en ~/.invoice/
+│   ├── setup.ts      ← Wizard de configuracion, gestion de empresas y datos del usuario
+│   └── types.ts      ← Interfaces TypeScript
+├── dist/             ← Output compilado
+├── CLAUDE.md         ← Guia de desarrollo (arquitectura, flujos, como extender)
+├── package.json
+├── tsconfig.json
+└── README.md
+```

package/README.md

@@ -0,0 +1,142 @@
+# Invoice Generator
+
+> **[Version en espanol](README.es.md)**
+
+Interactive CLI to generate PDF invoices from Jira Logged Time reports.
+
+## Requirements
+
+- Node.js >= 18
+
+## Installation
+
+```bash
+cd ~/workspace/invoice-generator
+npm install
+npm run build
+npm link
+```
+
+## Initial setup
+
+The first time you run `invoice`, a wizard will ask for:
+1. Your personal details (name, email, address)
+2. Your first company's details (name, address, currency, rate, hour limit)
+
+Configuration is saved to `~/.invoice/config.json`.
+
+## Usage
+
+### Interactive mode (recommended)
+```bash
+invoice
+```
+Full flow:
+1. Select company (with options to add/edit company or edit your personal data)
+2. Select the Jira CSV file (directory navigation with text filtering)
+3. Confirm hourly rate
+4. Preview with option to edit rows
+5. Invoice date (enter = today)
+6. Invoice number
+7. If the company has an hour limit: option to include "worked hours" column in the PDF
+8. Output PDF path
+9. Summary and confirmation
+10. Generate PDF
+
+### Direct mode
+```bash
+invoice generate report.csv
+invoice generate report.csv --company acme-corp --rate 30.20
+invoice generate report.csv --date "April 14, 2026" --output ~/invoices/inv.pdf
+```
+
+### Direct mode options
+
+| Option | Description |
+|--------|-------------|
+| `--rate <number>` | Hourly rate (default: company's rate) |
+| `--date <string>` | Invoice date (default: today) |
+| `--number <string>` | Invoice number |
+| `--output <string>` | Output PDF path |
+| `--company <id>` | Company ID (required if more than one) |
+
+### Help
+```bash
+invoice --help
+invoice generate --help
+```
+
+## Multi-company
+
+You can have multiple companies configured, each with its own currency, rate, and hour limit.
+
+When running `invoice` in interactive mode, the selector lets you:
+- Select an existing company
+- Add a new company
+- Edit an existing company
+- Edit your personal data (issuer)
+
+In direct mode, use `--company <id>` to specify the company.
+
+## Currency
+
+Each company has its own currency (e.g., USD, EUR, CRC). It's configured when creating or editing the company and is used throughout the CLI and in the generated PDF.
+
+## Hour limit
+
+Each company can have a daily hour limit (e.g., 8h). If set:
+- CSV hours are limited to the daily maximum (scaled proportionally if the day's total exceeds it)
+- The preview shows "Worked" and "Hours" columns
+- You can optionally include both columns in the PDF
+
+If no limit is set, CSV hours are used as-is.
+
+## Row editing
+
+In the preview you can edit any row before generating the PDF:
+- Enter the row number
+- Modify date, ticket, description, or hours
+- The table updates instantly
+- Press enter without a number to continue
+
+## Supported CSV formats
+
+| Format | Description |
+|--------|-------------|
+| `pivot` | One column per date (exported with calendar view in Jira) |
+| `date_col` | `Date` column with dates or ranges (`19/Jan/26 to 30/Jan/26`) |
+
+Format is detected automatically.
+
+## PDF filename
+
+The file is generated with the format: `invoice_DDMonYY_to_DDMonYY.pdf`
+
+Example: `invoice_05Jan26_to_16Jan26.pdf`
+
+## Development
+
+```bash
+npm run dev    # Run without compiling (uses tsx)
+npm run build  # Compile to JavaScript
+npm start      # Run the compiled version
+```
+
+## Project structure
+
+```
+invoice-generator/
+├── src/
+│   ├── index.ts      ← Entry point (shebang + main())
+│   ├── cli.ts        ← CLI interface (interactive + direct)
+│   ├── parser.ts     ← CSV parsing (pivot and date_col formats)
+│   ├── renderer.ts   ← PDF generation with pdfmake
+│   ├── store.ts      ← Config persistence in ~/.invoice/
+│   ├── setup.ts      ← Setup wizard, company and user data management
+│   └── types.ts      ← TypeScript interfaces
+├── dist/             ← Compiled output
+├── CLAUDE.md         ← Development guide (architecture, flows, how to extend)
+├── package.json
+├── tsconfig.json
+└── README.md
+```

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+/**
+ * CLI interactivo para generar invoices PDF desde CSV de Jira.
+ */
+export declare function main(): void;