@keypro/cli 0.1.3 → 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

@@ -256,13 +256,15 @@ utmutato AI-agenteknek (Claude Code, Codex) szol.
 
 ## Setup
 
-1. The user needs a KeyPro account (approved reseller) and an API key.
-   Either run \`keypro login\` (interactive email + password, stores a fresh
-   key) or create a key on the website under "API kulcsok" and store it:
-   - env var: KEYPRO_API_KEY=kp_live_... (recommended for agents)
-   - or config file: ~/.config/keypro/config.json
-2. API base URL: production is the default. For the dev site use
-   KEYPRO_API_BASE=https://dev.keypro.hu or \`keypro config set api-base ...\`.
+1. The user needs a KeyPro account (approved reseller) and an API key. Easiest:
+   \`keypro setup\` - interactive wizard (asks the server, then API key [default]
+   or email+password). Alternatives:
+   - \`keypro login\` (email + password, mints + stores a fresh key)
+   - a key made on the website under "API kulcsok", stored via
+     \`keypro config set api-key kp_live_...\`, the KEYPRO_API_KEY env var
+     (recommended for agents), or ~/.config/keypro/config.json
+2. API base URL: production is the default. For the dev site use \`keypro setup\`,
+   KEYPRO_API_BASE=https://dev.keypro.hu, or \`keypro config set api-base ...\`.
 3. Verify with: \`keypro whoami --json\`
 
 ## Output contract
@@ -717,7 +719,7 @@ function registerKeyproTools(server, client) {
 
 // src/mcp.ts
 async function runMcpServer(client) {
-  const server = new McpServer({ name: "keypro", version: "0.1.3" });
+  const server = new McpServer({ name: "keypro", version: "0.1.5" });
   registerKeyproTools(server, client);
   const transport = new StdioServerTransport();
   await server.connect(transport);
@@ -778,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.3").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) {
@@ -858,6 +860,61 @@ program.command("whoami").description("a bejelentkezett fiok adatai").action(asy
     fail(err);
   }
 });
+program.command("setup").description("interaktiv beallitas: szerver + hitelesites (API kulcs vagy jelszo)").action(async (_opts, cmd) => {
+  try {
+    const current = resolveConfig({});
+    const baseInput = (await promptText(`API szerver [${current.apiBase}]: `)).trim();
+    const apiBase = (baseInput || current.apiBase).replace(/\/$/, "");
+    if (!/^https?:\/\//.test(apiBase)) {
+      usageError("Az API szerver http(s) URL kell legyen, pl. https://keypro.hu");
+    }
+    const method = (await promptText(
+      "Hiteles\xEDt\xE9s - [1] API kulcs (aj\xE1nlott)  [2] Email + jelsz\xF3  [1]: "
+    )).trim();
+    let apiKey;
+    if (method === "2") {
+      const email = await promptText("Email: ");
+      const password = await promptHidden("Jelsz\xF3: ");
+      const result = await createClient({ apiBase }).login(
+        email,
+        password,
+        "CLI setup"
+      );
+      apiKey = result.token;
+    } else {
+      const key2 = (await promptHidden("API kulcs (kp_live_...): ")).trim();
+      if (!key2.startsWith("kp_live_")) {
+        usageError(
+          "\xC9rv\xE9nytelen kulcs form\xE1tum (kp_live_...). Kulcsot a weben az /api-keys oldalon k\xE9sz\xEDthetsz."
+        );
+      }
+      apiKey = key2;
+    }
+    writeConfig({ apiBase, apiKey });
+    const me = await createClient({ apiBase, apiKey }).me();
+    output(
+      {
+        apiBase,
+        configPath: configPath(),
+        account: { id: me.id, email: me.email, role: me.role }
+      },
+      () => {
+        process.stdout.write(
+          `
+Be\xE1ll\xEDtva.
+  Szerver: ${apiBase}
+  Fi\xF3k:    ${me.email} (#${me.id}, ${me.role})
+  Config:  ${configPath()}
+
+Pr\xF3b\xE1ld ki: keypro whoami
+`
+        );
+      }
+    );
+  } catch (err) {
+    fail(err);
+  }
+});
 var config = program.command("config").description("CLI beallitasok");
 config.command("get").description("aktualis beallitasok").action((_opts, cmd) => {
   const cfg = resolved(cmd);
@@ -879,18 +936,29 @@ config.command("get").description("aktualis beallitasok").action((_opts, cmd) =>
     }
   );
 });
-config.command("set <kulcs> <ertek>").description("beallitas mentese (tamogatott kulcs: api-base)").action((key2, value) => {
-  if (key2 !== "api-base") {
-    usageError(`Ismeretlen be\xE1ll\xEDt\xE1s: ${key2}. T\xE1mogatott: api-base`);
+config.command("set <kulcs> <ertek>").description("beallitas mentese (tamogatott kulcs: api-base, api-key)").action((key2, value) => {
+  if (key2 === "api-base") {
+    if (!/^https?:\/\//.test(value)) {
+      usageError("Az api-base http(s) URL kell legyen, pl. https://keypro.hu");
+    }
+    const next = writeConfig({ apiBase: value.replace(/\/$/, "") });
+    output({ apiBase: next.apiBase }, () => {
+      process.stdout.write(`API c\xEDm be\xE1ll\xEDtva: ${next.apiBase}
+`);
+    });
+    return;
   }
-  if (!/^https?:\/\//.test(value)) {
-    usageError("Az api-base http(s) URL kell legyen, pl. https://keypro.hu");
+  if (key2 === "api-key") {
+    if (!value.startsWith("kp_live_")) {
+      usageError("\xC9rv\xE9nytelen kulcs form\xE1tum (kp_live_...).");
+    }
+    writeConfig({ apiKey: value });
+    output({ apiKeySet: true, configPath: configPath() }, () => {
+      process.stdout.write("API kulcs elmentve a configba.\n");
+    });
+    return;
   }
-  const next = writeConfig({ apiBase: value.replace(/\/$/, "") });
-  output({ apiBase: next.apiBase }, () => {
-    process.stdout.write(`API c\xEDm be\xE1ll\xEDtva: ${next.apiBase}
-`);
-  });
+  usageError(`Ismeretlen be\xE1ll\xEDt\xE1s: ${key2}. T\xE1mogatott: api-base, api-key`);
 });
 var key = program.command("key").description("API kulcsok kezelese");
 key.command("list").description("a fiok API kulcsai").action(async (_opts, cmd) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keypro/cli",
-  "version": "0.1.3",
+  "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"
 }