@getpeppr/cli 0.2.2 → 0.3.1

package/README.md

@@ -1,6 +1,6 @@
 # @getpeppr/cli
 
-Developer toolkit for Peppol e-invoicing. Scaffold invoices, validate against Peppol BIS 3.0, convert to UBL XML, and look up participants in the Peppol Directory — all from the command line.
+Developer toolkit for Peppol e-invoicing. Scaffold invoices, validate against Peppol BIS 3.0, convert to UBL XML, look up participants in the Peppol Directory, and send invoices to the Peppol network — all from the command line.
 
 ## Installation
 
@@ -101,6 +101,70 @@ getpeppr lookup 0208:BE0685660237 --json
 | `--json` | Output results as JSON |
 | `--limit <n>` | Max results for search (default: 10) |
 
+### `getpeppr login` — Save your API key
+
+Store a getpeppr API key in `~/.config/getpeppr/credentials.json` (mode `0600`). Sandbox and live keys can coexist.
+
+```bash
+# Interactive (recommended) — prompts for the key with masked input
+getpeppr login
+
+# Explicit env (required in CI / non-TTY)
+getpeppr login --key sk_sandbox_... --sandbox
+getpeppr login --key sk_live_...    --live
+```
+
+| Flag | Description |
+|------|-------------|
+| `--key <key>` | API key. CI use only — visible in `ps`/shell history. Prefer the prompt or `GETPEPPR_API_KEY`. |
+| `--sandbox` | Store as sandbox key (default) |
+| `--live` | Store as live (production) key |
+
+API key resolution order: `--key` flag → `GETPEPPR_API_KEY` env var → stored credentials.
+
+### `getpeppr send` — Send an invoice to Peppol
+
+Send an invoice through the getpeppr API to the Peppol network. Targets sandbox by default; pass `--prod` for production.
+
+```bash
+# Send a JSON file
+getpeppr send invoice.json
+
+# Quick test — synthesize an invoice from flags (no file needed)
+getpeppr send --to 0208:BE0314595348 --amount 100 --desc "Test invoice"
+
+# Watch delivery status until terminal (60s timeout)
+getpeppr send invoice.json --watch
+
+# Production send — requires confirmation (skip with -y)
+getpeppr send invoice.json --prod
+```
+
+| Flag | Description |
+|------|-------------|
+| `[file]` | Path to invoice JSON (mutex with `--to`/`--amount`/...) |
+| `--prod` | Target production (uses live key + confirmation prompt) |
+| `--local` | Target `http://localhost:3001` (dev server) |
+| `--key <key>` | Override stored API key |
+| `--to <peppol-id>` | Recipient Peppol ID (when no file) |
+| `--amount <number>` | Line amount in major currency units |
+| `--currency <iso>` | ISO 4217 code (default `EUR`) |
+| `--desc <text>` | Line description |
+| `--attachment` | Attach the bundled test PDF |
+| `--watch` | Poll status until terminal (60s timeout) |
+| `-y, --yes` | Skip the `--prod` confirmation prompt |
+| `--no-validate` | Skip local pre-validation |
+| `--json` | Machine-readable JSON output |
+| `--quiet` | Exit code only, no output |
+
+### `getpeppr logout` — Remove stored credentials
+
+```bash
+getpeppr logout
+```
+
+Removes `~/.config/getpeppr/credentials.json`. No-op if the file doesn't exist.
+
 ## Exit codes
 
 | Code | Meaning |
@@ -117,6 +181,9 @@ getpeppr validate invoice.json --quiet || exit 1
 
 # Validate + convert in one step
 getpeppr convert invoice.json --validate -o output.xml
+
+# Send via API key in env (no login state needed)
+GETPEPPR_API_KEY=$SANDBOX_KEY getpeppr send invoice.json --json
 ```
 
 ## What it validates
@@ -127,7 +194,7 @@ The CLI runs three validation engines from the [@getpeppr/sdk](https://www.npmjs
 2. **Business Rules** — Peppol BIS 3.0 / EN 16931 compliance (BR-xx, BR-CO-xx, PEPPOL-xx rules)
 3. **Country Rules** — Belgium (BE), France (FR), Italy (IT), Netherlands (NL), Germany (DE)
 
-Validation runs offline — no API key or network connection required. Only `lookup` needs an internet connection.
+Scaffolding (`init`), validation, and conversion run fully offline — no API key or network connection required. Only `lookup` and `send` need a network connection.
 
 ## Invoice format
 
@@ -180,7 +247,14 @@ This is the exact template generated by `getpeppr init`. See the [full type refe
 
 ## Ready to send?
 
-Once your invoice validates, send it to the Peppol network with the getpeppr SDK:
+Once your invoice validates, send it to the Peppol network — straight from the CLI:
+
+```bash
+getpeppr login                       # store your sandbox key once
+getpeppr send invoice.json --watch   # send + poll delivery status
+```
+
+Or, for programmatic use inside an app, install the SDK:
 
 ```bash
 npm install @getpeppr/sdk