@keypro/cli 0.1.4 → 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 InstaSoft Informatikai Zrt. (https://keypro.hu)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,55 +1,142 @@
 # @keypro/cli
 
-Parancssori eszkoz a KeyPro.hu B2B szoftverlicenc webshophoz: rendeles
-leadas, rendelesek / szamlak / termékkulcsok lekerdezese, profil es KEP
-egyenleg kezeles. Regisztralt (jovahagyott) viszontelado fiok szukseges.
+Parancssori eszköz és MCP-szerver a [KeyPro.hu](https://keypro.hu) B2B
+szoftverlicenc-webshophoz: rendelés leadása, visszamondása, fizetési mód
+módosítása, rendelések / számlák / termékkulcsok lekérdezése, KEP-egyenleg és
+profil kezelése. Regisztrált (jóváhagyott) viszonteladó fiók szükséges.
 
-AI-ugynok barat: minden parancs tamogatja a `--json` kimenetet, es a
-`keypro mcp` beepitett MCP stdio szerverkent nativ tool-okat ad a Claude
-Code / Codex tipusu ugynokoknek. Reszletes agent-utmutato: `keypro
-agent-docs` vagy a csomagban levo AGENTS.md.
+AI-ügynök barát: minden parancs támogatja a `--json` kimenetet, és a
+`keypro mcp` beépített MCP stdio szerverként natív tool-okat ad a Claude Code /
+Claude Desktop / Codex típusú ügynököknek.
 
-## Telepites
+## Biztonság és átláthatóság
 
-```
+- **Nyílt forrás.** Ez a repó a teljes forráskód — ellenőrizhető, hogy a
+  csomag semmi rejtettet nem tartalmaz.
+- **Vékony kliens.** Csak a HTTP API-t hívja; nincs benne titok, nincs
+  telemetria, nem gyűjt és nem küld semmit rajtad kívül máshova.
+- **Csak az általad megadott szerverhez beszél** (alap: `https://keypro.hu`).
+- **A kulcs a tiéd.** `Authorization: Bearer` fejlécben megy, te hozod létre és
+  bármikor visszavonhatod a fiókod `/api-keys` oldalán.
+- **Provenance.** Az npm csomag GitHub Actions-ből, `--provenance` jelöléssel
+  publikálódik, így kriptográfiailag igazolható, hogy a közzétett csomag ebből a
+  forrásból, ebből a commitból épült.
+
+## Telepítés
+
+```bash
 npm install -g @keypro/cli
 ```
 
-## Gyors kezdes
+Node.js 20+ szükséges.
+
+## Gyors kezdés
 
+```bash
+keypro setup
 ```
-keypro login                # email + jelszo, API kulcsot ment
-keypro whoami               # ellenorzes
-keypro products search office
-keypro order preview --item OFF2021=2 --payment bacs
-keypro order create --item OFF2021=2 --payment bacs --yes
-keypro order list
-keypro keys list
-keypro invoices list
-keypro wallet transactions
-keypro profile set billing.city=Budapest
+
+A `setup` végigvezet: megkérdezi a szervert, majd a hitelesítést — **API kulcs**
+(ajánlott) vagy **email + jelszó**. Utána:
+
+```bash
+keypro whoami
+keypro products search windows --limit 5
 ```
 
-Fizetesi modok: `bacs` (banki atutalas / dijbekero), `cheque` (8 napos
-fizetesi hatarido, +5%), `cod` (utanvet), `wallet` (KEP egyenleg), `card`
-(mentett bankkartya; 3DS vagy hianyzo kartya eseten fizetesi linket kapsz).
+## Hitelesítés
+
+Négyféleképp adhatod meg a kulcsot (erősebb elöl):
 
-A rendeles ket lepeses: az elonezet (preview) megmutatja a vegosszegeket es
-megerosito tokent ad; a leadashoz `--yes` kell. Igy egy AI-ugynok sem tud
-eszrevetlenul rendelni.
+```bash
+keypro --api-key kp_live_... whoami        # per-parancs kapcsoló
+export KEYPRO_API_KEY=kp_live_...           # környezeti változó (agentnek jó)
+keypro config set api-key kp_live_...        # elmenti a configba
+keypro login                                 # email + jelszó -> új kulcsot ment
+```
 
-## Konfiguracio
+- Kulcsot a weben a fiók **API kulcsok** (`/api-keys`) oldalán készíthetsz,
+  scope-okkal (olvasás / rendelés / profil) és lejárattal.
+- A config a `~/.config/keypro/config.json` fájlban van (0600 jog).
 
-- `~/.config/keypro/config.json` (a `keypro login` irja, 0600 joggal)
-- Kornyezeti valtozok: `KEYPRO_API_KEY`, `KEYPRO_API_BASE`
-- Kapcsolok: `--api-key`, `--api-base`
-- Dev kornyezet: `keypro config set api-base https://dev.keypro.hu`
+## Szerver (API cím)
 
-## MCP mod (Claude Code)
+Alapértelmezés a production (`https://keypro.hu`). Váltás:
 
+```bash
+keypro config set api-base https://dev.keypro.hu
+# vagy: KEYPRO_API_BASE=https://dev.keypro.hu, vagy --api-base
 ```
-claude mcp add keypro -- keypro mcp
+
+## Parancsok
+
+| Parancs | Leírás |
+|---|---|
+| `keypro setup` | interaktív beállítás (szerver + hitelesítés) |
+| `keypro whoami` | a bejelentkezett fiók adatai |
+| `keypro rate` | aktuális EUR/HUF árfolyam (amit a shop használ) |
+| `keypro products search <szó>` / `products get <sku\|id>` | termékkeresés / részletek |
+| `keypro order preview --item <sku>=<db> --payment <mód>` | rendelés előnézete (összegek + confirmToken) |
+| `keypro order create --item ... --payment ... --yes` | rendelés leadása |
+| `keypro order list [--status ...]` / `order get <id>` | rendelések |
+| `keypro order cancel <id>` | fizetetlen rendelés visszamondása |
+| `keypro order change-payment <id> --payment <mód> [--yes]` | fizetési mód módosítása |
+| `keypro keys list [--order <id>]` | kézbesített termékkulcsok |
+| `keypro invoices list [--order <id>]` / `invoices get <id>` | számlák / díjbekérők (PDF link) |
+| `keypro wallet [transactions]` | KEP-egyenleg + tranzakciók |
+| `keypro profile get` / `profile set billing.city=... ` | profil |
+| `keypro cards list` | mentett bankkártyák |
+| `keypro parcelshops search <város\|irsz>` | GLS csomagpontok |
+| `keypro key list` / `config get` / `logout` | kulcsok, config, kijelentkezés |
+| `keypro agent-docs` | részletes AI-ügynök útmutató (stdout) |
+
+Fizetési módok: `bacs` (átutalás / díjbekérő), `cheque` (8 napos, +5%),
+`cod` (utánvét), `wallet` (KEP-egyenleg), `stripe` (bankkártya).
+
+Rendelés-biztonság: a `create` és a `change-payment` mindig előnézetet kér
+(összegekkel) és csak a preview-ból származó `confirmToken`-nel hajtódik végre,
+így véletlen rendelés nem történhet.
+
+## Gépi (JSON) kimenet
+
+Minden parancs támogatja a `--json`-t: a stdout-ra gépi adat, a hibák a
+stderr-re mennek stabil `error.code`-dal (snake_case, angol). Példa:
+
+```bash
+keypro --json whoami
 ```
 
-A kulcsot a fenti konfiguracios forrasokbol veszi; MCP-n keresztul
-bejelentkezni nem lehet (elobb `keypro login`).
+## MCP (AI ügynök) bekötés
+
+**Claude Desktop** — Settings → Developer → Edit Config:
+
+```json
+{
+  "mcpServers": {
+    "keypro": { "command": "npx", "args": ["-y", "@keypro/cli", "mcp"] }
+  }
+}
+```
+
+**Claude Code:**
+
+```bash
+claude mcp add keypro -- npx -y @keypro/cli mcp
+```
+
+Az MCP a beállított kulcsot (`keypro setup` / config / `KEYPRO_API_KEY`)
+használja. A webes claude.ai számára a shop külön **távoli MCP connectort** ad
+(OAuth-tal); azt a fiókod `/api-keys` oldala írja le.
+
+## Fejlesztés
+
+```bash
+pnpm install
+pnpm build        # tsup -> dist/
+pnpm typecheck
+pnpm test         # vitest
+```
+
+## Licenc
+
+MIT — lásd [LICENSE](./LICENSE).

package/dist/index.js

@@ -719,7 +719,7 @@ function registerKeyproTools(server, client) {
 
 // src/mcp.ts
 async function runMcpServer(client) {
-  const server = new McpServer({ name: "keypro", version: "0.1.4" });
+  const server = new McpServer({ name: "keypro", version: "0.1.5" });
   registerKeyproTools(server, client);
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -780,7 +780,7 @@ async function promptHidden(question) {
 var program = new Command();
 program.name("keypro").description(
   "KeyPro.hu B2B licencshop CLI - rendeles, szamlak, term\xE9kkulcsok, profil. AI-agent utmutato: keypro agent-docs"
-).version("0.1.4").option("--json", "gepi (JSON) kimenet a stdout-ra", false).option("--api-key <kulcs>", "API kulcs (felulirja az env/config erteket)").option("--api-base <url>", "API kiszolgalo cime (alap: eles bolt)").hook("preAction", (thisCommand) => {
+).version("0.1.5").option("--json", "gepi (JSON) kimenet a stdout-ra", false).option("--api-key <kulcs>", "API kulcs (felulirja az env/config erteket)").option("--api-base <url>", "API kiszolgalo cime (alap: eles bolt)").hook("preAction", (thisCommand) => {
   setJsonMode(Boolean(thisCommand.optsWithGlobals().json));
 });
 function resolved(cmd) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keypro/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "KeyPro.hu B2B szoftverlicenc webshop CLI: rendeles leadas, rendelesek/szamlak/termekkulcsok lekerdezese, profil kezeles. AI-ugynok (Claude Code, Codex) barat: --json kimenet es beepitett MCP szerver (keypro mcp).",
   "license": "MIT",
   "type": "module",
@@ -33,8 +33,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/InstaSoft-hu/keypro-ts.git",
-    "directory": "cli"
+    "url": "git+https://github.com/InstaSoft-hu/keypro-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/InstaSoft-hu/keypro-cli/issues"
   },
   "keywords": [
     "keypro",
@@ -56,5 +58,5 @@
     "vitest": "^4.1.10"
   },
   "author": "InstaSoft Informatikai Zrt. (https://keypro.hu)",
-  "homepage": "https://keypro.hu"
+  "homepage": "https://github.com/InstaSoft-hu/keypro-cli#readme"
 }