@hasna/invoices 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# @hasna/invoices
+
+Invoice management for AI agents — CLI + MCP server with SQLite storage.
+
+Supports multi-country tax rules, EU reverse charge, business profiles, client management, line items, and payment tracking.
+
+## Install
+
+```bash
+bun install -g @hasna/invoices
+# or
+npm install -g @hasna/invoices
+```
+
+Data is stored at `~/.hasna/invoices/invoices.db`.
+
+Override with `HASNA_INVOICES_DIR` or `INVOICES_DIR` env variables.
+
+## CLI
+
+```bash
+# Create an invoice
+invoices create --client <id> --due 2026-04-30 --currency EUR
+
+# Add line items
+invoices add-item --invoice <id> --description "Consulting" --price 150 --quantity 8
+
+# Mark as sent / paid
+invoices mark <id> sent
+invoices mark <id> paid
+
+# Record a payment
+invoices pay --invoice <id> --amount 1200 --method bank_transfer
+
+# Summary
+invoices summary
+
+# Clients
+invoices client add --name "Acme Corp" --email billing@acme.com --country US
+invoices client list
+
+# Business profiles
+invoices business add --name "My Company SRL" --country RO --vat RO12345678 --default
+invoices business list
+
+# Tax rules
+invoices tax list --country RO
+invoices tax determine --issuer RO --client DE --vat DE123456789
+```
+
+## MCP Server
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "invoices": {
+      "command": "invoices-mcp"
+    }
+  }
+}
+```
+
+### MCP Tools
+
+**Invoices:** `create_invoice`, `get_invoice`, `list_invoices`, `update_invoice_status`, `delete_invoice`
+
+**Line Items:** `add_line_item`, `remove_line_item`
+
+**Payments:** `record_payment`, `invoice_summary`
+
+**Clients:** `create_client`, `list_clients`, `update_client`, `delete_client`
+
+**Business Profiles:** `create_business_profile`, `get_business_profile`, `get_default_business_profile`, `list_business_profiles`, `update_business_profile`, `delete_business_profile`
+
+**Tax:** `list_tax_rules`, `get_default_tax_rule`, `create_tax_rule`, `delete_tax_rule`, `determine_tax`
+
+## Features
+
+- Auto-incrementing invoice numbers (`INV-00001`, `INV-00002`, ...)
+- Automatic total recalculation when line items change
+- Auto-marks invoice as paid when payments cover the total
+- 27 pre-seeded tax rules for EU, US, UK
+- EU B2B reverse charge detection
+- Business profiles with bank details (IBAN, SWIFT)
+- SQLite in WAL mode for concurrent access
+- No server required — embedded database
+
+## Storage
+
+```
+~/.hasna/invoices/
+└── invoices.db    # SQLite database (WAL mode)
+```
+
+## License
+
+Apache-2.0

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}