@getpeppr/cli 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `@getpeppr/cli` are documented here.
 
 The CLI bundles `@getpeppr/sdk` into its published artifact (tsup `noExternal`), so `validate`, `convert` and `init` run the SDK's validators, country rules and UBL builder locally — an SDK release only reaches CLI users once the CLI is rebundled. Rebundle-only releases are listed with the SDK version they ship.
 
+## [0.8.0] — 2026-08-19
+
+**`getpeppr whoami`** — show the Peppol identity of the account behind your
+API key (GPR-1094). Environment, company, country, and every registered
+identifier with its status. Works with any key; `--prod`, `--local`, `--key`
+and `--json` behave as on `send` and `lookup`. No identity yet is an answer,
+not an error — the command points you at the console page where you set one up.
+
+Bundles SDK 4.3.0 (`peppol.identity.get()` — the API this command consumes).
+
 ## [0.7.1] — 2026-08-18
 
 Rebundle SDK 4.1.1. This release matters for `getpeppr validate`, which runs the

package/README.md

@@ -159,6 +159,30 @@ getpeppr send invoice.json --prod
 
 When sending through the API, getpeppr determines the seller from the API key. A `from` party can still be present for local validation and UBL conversion, but the gateway ignores it for delivery.
 
+### `getpeppr whoami` — Show your Peppol identity
+
+Read the Peppol identity of the account behind your API key: the environment the key operates in, your legal entity as the gateway holds it, and every Peppol identifier registered for it with its status. Works with **any** key — standard keys included. This is the fastest way to check "is my identifier registered and verified?" without opening the console.
+
+```bash
+# Sandbox identity (default)
+getpeppr whoami
+
+# Production identity (uses your live key)
+getpeppr whoami --prod
+
+# Machine-readable
+getpeppr whoami --json
+```
+
+| Flag | Description |
+|------|-------------|
+| `--prod` | Use the live API key (default: sandbox) |
+| `--local` | Target `http://localhost:3001` (dev server) |
+| `--key <key>` | Override API key. CI use only — visible in `ps`/shell history. Prefer `GETPEPPR_API_KEY`. |
+| `--json` | Output the identity as JSON |
+
+If no legal entity exists in the environment yet, `whoami` says so and points to the console page where you create one.
+
 ### `getpeppr logout` — Remove stored credentials
 
 ```bash
@@ -213,7 +237,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)
 
-Scaffolding (`init`), validation, and conversion run fully offline — no API key or network connection required. Only `lookup` and `send` need a network connection.
+Scaffolding (`init`), validation, and conversion run fully offline — no API key or network connection required. Only `lookup`, `send`, and `whoami` need a network connection.
 
 ## Invoice format
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpeppr/cli",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "CLI tool for Peppol e-invoice validation and development",
   "type": "module",
   "bin": {
@@ -44,7 +44,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@getpeppr/sdk": "^4.1.1",
+    "@getpeppr/sdk": "^4.3.0",
     "commander": "^13.1.0",
     "picocolors": "^1.1.1"
   },