@keypro/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,1473 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createInterface } from "readline/promises";
+import { writeFileSync as writeFileSync2 } from "fs";
+import { randomUUID } from "crypto";
+import { Command } from "commander";
+
+// src/client.ts
+var KeyproApiError = class extends Error {
+  constructor(status, code, message, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "KeyproApiError";
+  }
+  status;
+  code;
+  details;
+};
+var KeyproClient = class {
+  constructor(opts) {
+    this.opts = opts;
+  }
+  opts;
+  async request(method, path, body, extraHeaders) {
+    const headers = {
+      accept: "application/json",
+      ...extraHeaders
+    };
+    if (this.opts.apiKey) headers.authorization = `Bearer ${this.opts.apiKey}`;
+    if (body !== void 0) headers["content-type"] = "application/json";
+    let response;
+    try {
+      response = await fetch(`${this.opts.apiBase}${path}`, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+    } catch (err) {
+      throw new KeyproApiError(
+        0,
+        "network_error",
+        `Nem siker\xFClt el\xE9rni a szervert (${this.opts.apiBase}): ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    let payload;
+    try {
+      payload = await response.json();
+    } catch {
+      throw new KeyproApiError(
+        response.status,
+        "invalid_response",
+        `A szerver nem JSON v\xE1laszt adott (HTTP ${response.status}). J\xF3 az api-base be\xE1ll\xEDt\xE1s?`
+      );
+    }
+    const envelope = payload;
+    if (envelope.ok === true && envelope.data !== void 0) {
+      return envelope.data;
+    }
+    const error = envelope.error ?? {};
+    throw new KeyproApiError(
+      response.status,
+      error.code ?? "unknown_error",
+      error.message ?? `Ismeretlen hiba (HTTP ${response.status}).`,
+      error.details
+    );
+  }
+  // --- Auth / kulcsok ---
+  login(email, password, name) {
+    return this.request("POST", "/api/v1/auth/login", { email, password, name });
+  }
+  me() {
+    return this.request("GET", "/api/v1/me");
+  }
+  keysList() {
+    return this.request(
+      "GET",
+      "/api/v1/keys"
+    );
+  }
+  keyRevoke(keyId) {
+    return this.request(
+      "DELETE",
+      `/api/v1/keys/${keyId}`
+    );
+  }
+  // --- Termekek ---
+  productsSearch(params) {
+    const qs = new URLSearchParams();
+    if (params.q) qs.set("q", params.q);
+    if (params.category) qs.set("category", params.category);
+    if (params.onSale) qs.set("on_sale", "true");
+    if (params.sort) qs.set("sort", params.sort);
+    if (params.limit) qs.set("limit", String(params.limit));
+    if (params.offset) qs.set("offset", String(params.offset));
+    const suffix = qs.size > 0 ? `?${qs}` : "";
+    return this.request("GET", `/api/v1/products${suffix}`);
+  }
+  productGet(key2) {
+    return this.request(
+      "GET",
+      `/api/v1/products/${encodeURIComponent(key2)}`
+    );
+  }
+  // --- Rendelesek ---
+  orderPreview(req) {
+    return this.request("POST", "/api/v1/orders/preview", req);
+  }
+  orderCreate(req, idempotencyKey) {
+    return this.request(
+      "POST",
+      "/api/v1/orders",
+      req,
+      idempotencyKey ? { "idempotency-key": idempotencyKey } : void 0
+    );
+  }
+  ordersList(params) {
+    const qs = new URLSearchParams();
+    if (params.status) qs.set("status", params.status);
+    if (params.limit) qs.set("limit", String(params.limit));
+    if (params.offset) qs.set("offset", String(params.offset));
+    const suffix = qs.size > 0 ? `?${qs}` : "";
+    return this.request(
+      "GET",
+      `/api/v1/orders${suffix}`
+    );
+  }
+  orderGet(id) {
+    return this.request("GET", `/api/v1/orders/${id}`);
+  }
+  orderKeys(id) {
+    return this.request("GET", `/api/v1/orders/${id}/keys`);
+  }
+  licenseKeys() {
+    return this.request("GET", "/api/v1/license-keys");
+  }
+  // --- Szamlak ---
+  invoicesList(params) {
+    const qs = new URLSearchParams();
+    if (params.orderId) qs.set("order_id", String(params.orderId));
+    if (params.limit) qs.set("limit", String(params.limit));
+    if (params.offset) qs.set("offset", String(params.offset));
+    const suffix = qs.size > 0 ? `?${qs}` : "";
+    return this.request(
+      "GET",
+      `/api/v1/invoices${suffix}`
+    );
+  }
+  invoiceGet(id) {
+    return this.request(
+      "GET",
+      `/api/v1/invoices/${id}`
+    );
+  }
+  // --- Profil / wallet / kartyak / csomagpontok ---
+  profileGet() {
+    return this.request(
+      "GET",
+      "/api/v1/profile"
+    );
+  }
+  profileUpdate(patch) {
+    return this.request("PATCH", "/api/v1/profile", patch);
+  }
+  wallet(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.limit) qs.set("limit", String(params.limit));
+    if (params.offset) qs.set("offset", String(params.offset));
+    const suffix = qs.size > 0 ? `?${qs}` : "";
+    return this.request("GET", `/api/v1/wallet${suffix}`);
+  }
+  cardsList() {
+    return this.request("GET", "/api/v1/cards");
+  }
+  parcelshopsSearch(q, type) {
+    const qs = new URLSearchParams({ q });
+    if (type) qs.set("type", type);
+    return this.request("GET", `/api/v1/shipping/parcelshops?${qs}`);
+  }
+};
+function createClient(opts) {
+  return new KeyproClient(opts);
+}
+
+// src/config.ts
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var DEFAULT_API_BASE = "https://keypro.hu";
+function configDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  return join(xdg && xdg.length > 0 ? xdg : join(homedir(), ".config"), "keypro");
+}
+function configPath() {
+  return join(configDir(), "config.json");
+}
+function readConfig() {
+  try {
+    if (!existsSync(configPath())) return {};
+    const raw = JSON.parse(readFileSync(configPath(), "utf8"));
+    if (typeof raw !== "object" || raw === null) return {};
+    const obj = raw;
+    return {
+      apiKey: typeof obj.apiKey === "string" ? obj.apiKey : void 0,
+      apiBase: typeof obj.apiBase === "string" ? obj.apiBase : void 0
+    };
+  } catch {
+    return {};
+  }
+}
+function writeConfig(patch) {
+  const next = { ...readConfig(), ...patch };
+  const clean = Object.fromEntries(
+    Object.entries(next).filter(([, v]) => v !== void 0)
+  );
+  mkdirSync(configDir(), { recursive: true });
+  writeFileSync(configPath(), JSON.stringify(clean, null, 2) + "\n", {
+    mode: 384
+  });
+  try {
+    chmodSync(configPath(), 384);
+  } catch {
+  }
+  return clean;
+}
+function resolveConfig(flags) {
+  const file = readConfig();
+  const apiBase = (flags.apiBase ?? process.env.KEYPRO_API_BASE ?? file.apiBase ?? DEFAULT_API_BASE).replace(/\/$/, "");
+  if (flags.apiKey) return { apiBase, apiKey: flags.apiKey, keySource: "flag" };
+  if (process.env.KEYPRO_API_KEY) {
+    return { apiBase, apiKey: process.env.KEYPRO_API_KEY, keySource: "env" };
+  }
+  if (file.apiKey) return { apiBase, apiKey: file.apiKey, keySource: "config" };
+  return { apiBase, apiKey: null, keySource: "none" };
+}
+
+// src/agent-docs.ts
+var AGENT_DOCS = `# KeyPro CLI - AI agent guide
+
+Magyar: ez a KeyPro.hu B2B licencshop parancssori eszkoze; az alabbi angol
+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 ...\`.
+3. Verify with: \`keypro whoami --json\`
+
+## Output contract
+
+- Every command supports \`--json\`: machine-readable data on stdout.
+- Errors go to stderr; in --json mode they are JSON with a stable
+  \`error.code\` (snake_case English). Key on \`code\`, not on the Hungarian
+  \`message\`.
+- Exit codes: 0 success, 1 API/business error, 2 usage error, 3 auth error.
+
+## Ordering flow (IMPORTANT)
+
+Ordering is a two-step preview + confirm flow to prevent accidental orders:
+
+1. \`keypro order preview --item SKU=QTY --payment bacs --json\`
+   Returns priced lines, fees, shipping, totals and a \`confirmToken\`
+   (valid 15 minutes, bound to items + payment method + gross total).
+   ALWAYS show the totals to the user before ordering.
+2. \`keypro order create --item SKU=QTY --payment bacs --yes --json\`
+   Without \`--yes\` the command only prints the preview and exits with
+   code 1. With \`--yes\` it re-runs the preview and submits with the fresh
+   confirmToken. If prices changed between preview and create, the server
+   rejects with \`confirm_token_invalid\` and returns the new totals in
+   \`error.details\` - re-run preview and show the user the new total.
+3. Retries: pass \`--idempotency-key <any-unique-string>\` - the same key
+   never creates a second order (the response has \`idempotentReplay: true\`).
+
+Payment methods (\`--payment\`):
+- \`bacs\`   bank transfer: order goes on-hold, a proforma invoice
+  (dijbekero) is issued; keys are delivered after payment arrives.
+- \`cheque\` 8-day payment terms (+5% fee on net product total).
+- \`cod\`    cash on delivery (physical shipments only, +1.5 EUR fee).
+- \`wallet\` KEP balance (net total deducted immediately).
+- \`card\`   saved bank card (Stripe, off-session). If the bank requires
+  3DS or there is no saved card, the response contains \`payment.paymentUrl\`
+  - give this link to the user to open in a browser (valid ~1 hour).
+  Select a specific card with \`--card pm_...\` (see \`keypro cards list\`).
+
+Physical products need \`--shipping gls_hd|gls_parcelshop|combine_free\`;
+for gls_parcelshop also \`--parcelshop <ID>\`
+(search: \`keypro parcelshops search <city|zip>\`).
+
+## Queries
+
+- \`keypro products search <query>\` / \`keypro products get <sku|id>\`
+- \`keypro order list [--status <status>]\` / \`keypro order get <id>\`
+- \`keypro keys list [--order <id>]\` - delivered license keys
+- \`keypro invoices list [--order <id>]\` / \`keypro invoices get <id>\`
+  (each invoice has a public \`downloadUrl\` PDF link)
+- \`keypro wallet\` / \`keypro wallet transactions\` - KEP balance + history
+- \`keypro profile get\` / \`keypro profile set billing.city=Budapest ...\`
+  (sections: contact.*, billing.*, shipping.*)
+- \`keypro cards list\` - saved cards (add new cards on the website only)
+
+## MCP server mode
+
+Register the CLI as a native MCP toolset (recommended for Claude Code):
+
+    claude mcp add keypro -- keypro mcp
+
+Auth comes from KEYPRO_API_KEY / config; there is no login tool over MCP.
+The keypro_order_create tool requires the confirmToken from
+keypro_order_preview - same safety flow as the CLI.
+
+## Error codes
+
+unauthorized, forbidden_scope, rate_limited, validation_failed, not_found,
+unknown_product, coupon_invalid, shipping_required, invalid_parcelshop,
+insufficient_wallet_balance, confirm_required, confirm_token_invalid,
+invalid_card, stripe_unavailable, account_pending, account_inactive,
+invalid_credentials, network_error, internal
+`;
+
+// src/items.ts
+function parseItemSpec(spec) {
+  const raw = spec.trim();
+  if (!raw) throw new Error("\xDCres t\xE9tel-megad\xE1s.");
+  const eq = raw.lastIndexOf("=");
+  const idPart = eq === -1 ? raw : raw.slice(0, eq);
+  const qtyPart = eq === -1 ? "" : raw.slice(eq + 1);
+  let qty = 1;
+  if (qtyPart !== "") {
+    qty = Number(qtyPart);
+    if (!Number.isInteger(qty) || qty < 1 || qty > 999) {
+      throw new Error(
+        `\xC9rv\xE9nytelen darabsz\xE1m: "${qtyPart}" (1-999 k\xF6z\xF6tti eg\xE9sz sz\xE1m kell).`
+      );
+    }
+  }
+  if (idPart.toLowerCase().startsWith("id:")) {
+    const productId = Number(idPart.slice(3));
+    if (!Number.isInteger(productId) || productId < 1) {
+      throw new Error(`\xC9rv\xE9nytelen term\xE9k-azonos\xEDt\xF3: "${idPart}".`);
+    }
+    return { productId, qty };
+  }
+  if (idPart.length === 0) {
+    throw new Error(`Hi\xE1nyz\xF3 cikksz\xE1m a t\xE9telben: "${spec}".`);
+  }
+  return { sku: idPart, qty };
+}
+
+// src/output.ts
+var jsonMode = false;
+function setJsonMode(on) {
+  jsonMode = on;
+}
+function output(data, human) {
+  if (jsonMode) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+  } else {
+    human();
+  }
+}
+function fail(err) {
+  if (err instanceof KeyproApiError) {
+    if (jsonMode) {
+      process.stderr.write(
+        JSON.stringify(
+          {
+            ok: false,
+            error: { code: err.code, message: err.message, details: err.details }
+          },
+          null,
+          2
+        ) + "\n"
+      );
+    } else {
+      process.stderr.write(`Hiba (${err.code}): ${err.message}
+`);
+      if (err.details !== void 0) {
+        process.stderr.write(`R\xE9szletek: ${JSON.stringify(err.details)}
+`);
+      }
+    }
+    process.exit(err.status === 401 || err.status === 403 ? 3 : 1);
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (jsonMode) {
+    process.stderr.write(
+      JSON.stringify({ ok: false, error: { code: "cli_error", message } }) + "\n"
+    );
+  } else {
+    process.stderr.write(`Hiba: ${message}
+`);
+  }
+  process.exit(1);
+}
+function usageError(message) {
+  process.stderr.write(`${message}
+`);
+  process.exit(2);
+}
+function printKV(rows) {
+  const width = Math.max(...rows.map(([k]) => k.length));
+  for (const [key2, value] of rows) {
+    if (value === null || value === void 0 || value === "") continue;
+    process.stdout.write(`${key2.padEnd(width)}  ${value}
+`);
+  }
+}
+function printTable(headers, rows) {
+  const cells = rows.map(
+    (row) => row.map((cell) => cell === null || cell === void 0 ? "-" : String(cell))
+  );
+  const widths = headers.map(
+    (h, i) => Math.max(h.length, ...cells.map((row) => (row[i] ?? "").length))
+  );
+  const line = (row) => row.map((cell, i) => cell.padEnd(widths[i])).join("  ") + "\n";
+  process.stdout.write(line(headers));
+  process.stdout.write(line(widths.map((w) => "-".repeat(w))));
+  for (const row of cells) process.stdout.write(line(row));
+}
+function eurFmt(value) {
+  return `${value.toFixed(2)} EUR`;
+}
+
+// src/mcp.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var addressShape = z.object({
+  firstName: z.string().optional(),
+  lastName: z.string().optional(),
+  company: z.string().optional(),
+  address1: z.string().optional(),
+  address2: z.string().optional(),
+  city: z.string().optional(),
+  postcode: z.string().optional(),
+  state: z.string().optional(),
+  country: z.string().optional(),
+  email: z.string().optional(),
+  phone: z.string().optional()
+}).optional();
+var orderRequestShape = {
+  items: z.array(
+    z.object({
+      sku: z.string().optional().describe("Product SKU (either sku or productId)"),
+      productId: z.number().int().positive().optional(),
+      qty: z.number().int().min(1).max(999).default(1)
+    })
+  ).min(1).describe("Order lines"),
+  paymentMethod: z.enum(["bacs", "cheque", "cod", "wallet", "stripe"]).describe(
+    "bacs=bank transfer (proforma first), cheque=8-day terms (+5%), cod=cash on delivery, wallet=KEP balance, stripe=saved card"
+  ),
+  shippingMethodId: z.enum(["gls_hd", "gls_parcelshop", "combine_free"]).optional().describe("Required when the cart contains physical products"),
+  parcelshopId: z.string().optional().describe("GLS pickup point id (required for gls_parcelshop)"),
+  couponCode: z.string().optional(),
+  currency: z.enum(["EUR", "HUF"]).default("EUR"),
+  billing: addressShape.describe(
+    "Per-field billing address overrides (defaults come from the user profile)"
+  ),
+  shipping: addressShape.describe(
+    "Separate shipping address (omit to ship to the billing address)"
+  ),
+  taxNumber: z.string().optional(),
+  cardId: z.string().optional().describe("Saved card id (pm_...) for stripe payments; omit for default card")
+};
+function jsonResult(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function errorResult(err) {
+  const payload = err instanceof KeyproApiError ? { code: err.code, message: err.message, details: err.details } : { code: "cli_error", message: err instanceof Error ? err.message : String(err) };
+  return {
+    content: [{ type: "text", text: JSON.stringify({ error: payload }) }],
+    isError: true
+  };
+}
+async function run(fn) {
+  try {
+    return jsonResult(await fn());
+  } catch (err) {
+    return errorResult(err);
+  }
+}
+async function runMcpServer(client) {
+  const server = new McpServer({ name: "keypro", version: "0.1.0" });
+  server.registerTool(
+    "keypro_whoami",
+    {
+      description: "The authenticated KeyPro account (email, company, role, KEP wallet balance, API key scopes).",
+      inputSchema: {}
+    },
+    () => run(() => client.me())
+  );
+  server.registerTool(
+    "keypro_products_search",
+    {
+      description: "Search the KeyPro product catalog by name or SKU. Returns id, sku, name, net EUR price.",
+      inputSchema: {
+        q: z.string().optional().describe("Search text (name or SKU)"),
+        category: z.string().optional().describe("Category slug filter"),
+        onSale: z.boolean().optional().describe("Only discounted products"),
+        limit: z.number().int().min(1).max(100).optional()
+      }
+    },
+    (args) => run(
+      () => client.productsSearch({
+        q: args.q,
+        category: args.category,
+        onSale: args.onSale,
+        limit: args.limit
+      })
+    )
+  );
+  server.registerTool(
+    "keypro_product_get",
+    {
+      description: "Product details by id, slug or SKU, including the caller's effective unit price with discounts.",
+      inputSchema: { key: z.string().describe("Product id, slug or SKU") }
+    },
+    (args) => run(() => client.productGet(args.key))
+  );
+  server.registerTool(
+    "keypro_order_preview",
+    {
+      description: "Preview an order WITHOUT placing it: priced lines, fees, shipping, totals, and a confirmToken (valid 15 minutes). ALWAYS show the returned totals to the user and get their approval before calling keypro_order_create.",
+      inputSchema: orderRequestShape
+    },
+    (args) => run(() => client.orderPreview(args))
+  );
+  server.registerTool(
+    "keypro_order_create",
+    {
+      description: "Place an order. Requires the confirmToken from keypro_order_preview (same items, payment method and total). If the response contains payment.paymentUrl, give that link to the user to finish paying in a browser. Pass idempotencyKey to make retries safe.",
+      inputSchema: {
+        ...orderRequestShape,
+        confirmToken: z.string().describe("Token from keypro_order_preview"),
+        idempotencyKey: z.string().optional().describe("Unique retry-dedup key; the same key never creates a second order")
+      }
+    },
+    (args) => run(() => {
+      const { idempotencyKey, ...request } = args;
+      return client.orderCreate(request, idempotencyKey);
+    })
+  );
+  server.registerTool(
+    "keypro_orders_list",
+    {
+      description: "List the user's orders (newest first), optional status filter.",
+      inputSchema: {
+        status: z.string().optional().describe("e.g. pending, processing, completed"),
+        limit: z.number().int().min(1).max(100).optional()
+      }
+    },
+    (args) => run(() => client.ordersList({ status: args.status, limit: args.limit }))
+  );
+  server.registerTool(
+    "keypro_order_get",
+    {
+      description: "Order details: items, totals, status, invoices, and a payment link if the order is awaiting card payment.",
+      inputSchema: { orderId: z.number().int().positive() }
+    },
+    (args) => run(() => client.orderGet(args.orderId))
+  );
+  server.registerTool(
+    "keypro_order_keys",
+    {
+      description: "License keys delivered for one order. COD orders release keys only after completion.",
+      inputSchema: { orderId: z.number().int().positive() }
+    },
+    (args) => run(() => client.orderKeys(args.orderId))
+  );
+  server.registerTool(
+    "keypro_license_keys",
+    {
+      description: "All delivered license keys of the user, grouped by product.",
+      inputSchema: {}
+    },
+    () => run(() => client.licenseKeys())
+  );
+  server.registerTool(
+    "keypro_invoices_list",
+    {
+      description: "List invoices/proformas (each has a public downloadUrl PDF link). Optional order filter.",
+      inputSchema: {
+        orderId: z.number().int().positive().optional(),
+        limit: z.number().int().min(1).max(100).optional()
+      }
+    },
+    (args) => run(() => client.invoicesList({ orderId: args.orderId, limit: args.limit }))
+  );
+  server.registerTool(
+    "keypro_invoice_get",
+    {
+      description: "One invoice with totals and public downloadUrl.",
+      inputSchema: { invoiceId: z.number().int().positive() }
+    },
+    (args) => run(() => client.invoiceGet(args.invoiceId))
+  );
+  server.registerTool(
+    "keypro_profile_get",
+    {
+      description: "The account profile: contact data, billing and shipping address.",
+      inputSchema: {}
+    },
+    () => run(() => client.profileGet())
+  );
+  server.registerTool(
+    "keypro_profile_update",
+    {
+      description: "Update profile fields (partial). Allowed keys: firstName, phone, website, companyName, taxNumber, billingFirstName, billingLastName, billingCompany, billingAddress1, billingAddress2, billingCity, billingPostcode, billingState, billingCountry, billingEmail, billingPhone, and the same shipping* fields (no shippingEmail). Empty string clears a field.",
+      inputSchema: {
+        fields: z.record(z.string(), z.string()).describe("Field name -> new value map (flat API field names)")
+      }
+    },
+    (args) => run(() => client.profileUpdate(args.fields))
+  );
+  server.registerTool(
+    "keypro_wallet",
+    {
+      description: "KEP wallet balance (net EUR) and transaction history (topup/payment/refund/bonus with running balance).",
+      inputSchema: {
+        limit: z.number().int().min(1).max(100).optional().describe("History length")
+      }
+    },
+    (args) => run(() => client.wallet({ limit: args.limit }))
+  );
+  server.registerTool(
+    "keypro_cards_list",
+    {
+      description: "Saved bank cards (brand, last4, default flag). New cards can only be added on the website.",
+      inputSchema: {}
+    },
+    () => run(() => client.cardsList())
+  );
+  server.registerTool(
+    "keypro_parcelshops_search",
+    {
+      description: "Search GLS pickup points (city, zip prefix or name). Use the returned id as parcelshopId for gls_parcelshop shipping.",
+      inputSchema: {
+        q: z.string().describe("City, zip prefix or name"),
+        type: z.enum(["parcel-shop", "parcel-locker", "all"]).optional()
+      }
+    },
+    (args) => run(() => client.parcelshopsSearch(args.q, args.type))
+  );
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+// src/index.ts
+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.0").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) {
+  const opts = cmd.optsWithGlobals();
+  return resolveConfig({ apiKey: opts.apiKey, apiBase: opts.apiBase });
+}
+function clientFor(cmd, requireKey = true) {
+  const cfg = resolved(cmd);
+  if (requireKey && !cfg.apiKey) {
+    process.stderr.write(
+      "Nincs API kulcs be\xE1ll\xEDtva. Futtasd: keypro login, vagy add meg a KEYPRO_API_KEY k\xF6rnyezeti v\xE1ltoz\xF3t / a --api-key kapcsol\xF3t.\n"
+    );
+    process.exit(3);
+  }
+  return createClient({ apiBase: cfg.apiBase, apiKey: cfg.apiKey });
+}
+async function promptHidden(question) {
+  process.stdout.write(question);
+  return new Promise((resolve, reject) => {
+    const stdin = process.stdin;
+    let value = "";
+    const wasRaw = stdin.isRaw;
+    if (stdin.isTTY) stdin.setRawMode(true);
+    stdin.resume();
+    const onData = (chunk) => {
+      const ch = chunk.toString("utf8");
+      if (ch === "\n" || ch === "\r" || ch === "") {
+        stdin.off("data", onData);
+        if (stdin.isTTY) stdin.setRawMode(wasRaw ?? false);
+        stdin.pause();
+        process.stdout.write("\n");
+        resolve(value);
+      } else if (ch === "") {
+        stdin.off("data", onData);
+        if (stdin.isTTY) stdin.setRawMode(wasRaw ?? false);
+        process.stdout.write("\n");
+        reject(new Error("Megszak\xEDtva."));
+      } else if (ch === "\x7F" || ch === "\b") {
+        value = value.slice(0, -1);
+      } else {
+        value += ch;
+      }
+    };
+    stdin.on("data", onData);
+  });
+}
+async function promptText(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return (await rl.question(question)).trim();
+  } finally {
+    rl.close();
+  }
+}
+program.command("login").description("bejelentkezes email + jelszoval; uj API kulcsot ment a configba").option("--email <email>").option("--password <jelszo>", "jelszo (ha nincs megadva, rejtve keri be)").option("--name <nev>", "a letrejovo API kulcs cimkeje", "CLI login").action(async (opts, cmd) => {
+  try {
+    const cfg = resolved(cmd);
+    const email = opts.email ?? await promptText("Email: ");
+    const password = opts.password ?? await promptHidden("Jelsz\xF3: ");
+    const client = createClient({ apiBase: cfg.apiBase });
+    const result = await client.login(email, password, opts.name);
+    writeConfig({ apiKey: result.token, apiBase: cfg.apiBase });
+    output(
+      { prefix: result.prefix, keyId: result.keyId, scopes: result.scopes, apiBase: cfg.apiBase, configPath: configPath() },
+      () => {
+        process.stdout.write(
+          `Sikeres bejelentkez\xE9s. \xDAj API kulcs mentve (${result.prefix}...) ide: ${configPath()}
+`
+        );
+      }
+    );
+  } catch (err) {
+    fail(err);
+  }
+});
+program.command("logout").description("a mentett API kulcs torlese a configbol").option("--revoke", "a kulcs visszavonasa a szerveren is", false).action(async (opts, cmd) => {
+  try {
+    if (opts.revoke) {
+      const client = clientFor(cmd);
+      const me = await client.me();
+      await client.keyRevoke(me.key.id);
+    }
+    writeConfig({ apiKey: void 0 });
+    output({ loggedOut: true, revoked: opts.revoke }, () => {
+      process.stdout.write(
+        opts.revoke ? "Kijelentkezve, a kulcs a szerveren is visszavonva.\n" : "Kijelentkezve (a kulcs t\xF6r\xF6lve a configb\xF3l).\n"
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+program.command("whoami").description("a bejelentkezett fiok adatai").action(async (_opts, cmd) => {
+  try {
+    const me = await clientFor(cmd).me();
+    output(me, () => {
+      printKV([
+        ["Fi\xF3k", `${me.email} (#${me.id})`],
+        ["C\xE9g", me.companyName],
+        ["Szerep", me.role],
+        ["KEP egyenleg", eurFmt(me.walletBalanceEurNet)],
+        ["API kulcs", `${me.key.prefix}... (${me.key.name})`],
+        ["Jogosults\xE1gok", me.key.scopes.join(", ")]
+      ]);
+    });
+  } 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);
+  const file = readConfig();
+  output(
+    {
+      apiBase: cfg.apiBase,
+      apiKeySet: cfg.apiKey !== null,
+      keySource: cfg.keySource,
+      configPath: configPath(),
+      configFile: { apiBase: file.apiBase, apiKeySet: Boolean(file.apiKey) }
+    },
+    () => {
+      printKV([
+        ["API c\xEDm", cfg.apiBase],
+        ["API kulcs", cfg.apiKey ? `be\xE1ll\xEDtva (forr\xE1s: ${cfg.keySource})` : "nincs"],
+        ["Config f\xE1jl", configPath()]
+      ]);
+    }
+  );
+});
+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`);
+  }
+  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}
+`);
+  });
+});
+var key = program.command("key").description("API kulcsok kezelese");
+key.command("list").description("a fiok API kulcsai").action(async (_opts, cmd) => {
+  try {
+    const { keys } = await clientFor(cmd).keysList();
+    output({ keys }, () => {
+      printTable(
+        ["ID", "Prefix", "N\xE9v", "Jogok", "Utolj\xE1ra haszn\xE1lva", "\xC1llapot"],
+        keys.map((k) => [
+          String(k.id),
+          `${k.prefix}...`,
+          String(k.name),
+          k.scopes.join(","),
+          k.lastUsedAt ? String(k.lastUsedAt).slice(0, 10) : "-",
+          k.revokedAt ? "visszavonva" : "akt\xEDv"
+        ])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+key.command("revoke <id>").description("API kulcs visszavonasa").action(async (id, _opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).keyRevoke(Number(id));
+    output(result, () => {
+      process.stdout.write(`A(z) ${id} kulcs visszavonva.
+`);
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var products = program.command("products").description("termek-katalogus");
+products.command("search [query]").description("termekkereses nev vagy cikkszam alapjan").option("--category <slug>", "kategoria-szures").option("--on-sale", "csak akcios termekek", false).option("--sort <mod>", "rendezes: name|price_asc|price_desc|newest").option("--limit <n>", "talalatok szama (max 100)", "25").action(
+  async (query, opts, cmd) => {
+    try {
+      const result = await clientFor(cmd).productsSearch({
+        q: query,
+        category: opts.category,
+        onSale: opts.onSale,
+        sort: opts.sort,
+        limit: Number(opts.limit)
+      });
+      output(result, () => {
+        printTable(
+          ["ID", "SKU", "N\xE9v", "Nett\xF3 EUR", "Akci\xF3s"],
+          result.products.map((p) => [
+            String(p.id),
+            p.sku ? String(p.sku) : "-",
+            String(p.name),
+            Number(p.netPriceEur).toFixed(2),
+            p.onSale ? "igen" : ""
+          ])
+        );
+        process.stdout.write(`
+\xD6sszesen: ${result.total} tal\xE1lat
+`);
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+);
+products.command("get <skuVagyId>").description("termek reszletei (id, slug vagy cikkszam)").action(async (keyArg, _opts, cmd) => {
+  try {
+    const p = await clientFor(cmd).productGet(keyArg);
+    output(p, () => {
+      printKV([
+        ["Term\xE9k", `${p.name} (#${p.id})`],
+        ["SKU", p.sku],
+        ["Lista nett\xF3 \xE1r", `${Number(p.listNetPriceEur).toFixed(2)} EUR`],
+        ["Akci\xF3s", p.onSale ? "igen" : "nem"],
+        ["A te nett\xF3 egys\xE9g\xE1rad", `${Number(p.yourUnitNetEur).toFixed(2)} EUR`],
+        [
+          "Kedvezm\xE9nyed",
+          Number(p.yourDiscountPercent) > 0 ? `${p.yourDiscountPercent}%` : null
+        ],
+        ["Sz\xE1ll\xEDt\xE1st ig\xE9nyel", p.isVirtual ? "nem (digit\xE1lis)" : "igen (fizikai)"]
+      ]);
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var ADDRESS_FLAG_FIELDS = [
+  ["first-name", "firstName"],
+  ["last-name", "lastName"],
+  ["company", "company"],
+  ["address1", "address1"],
+  ["address2", "address2"],
+  ["city", "city"],
+  ["postcode", "postcode"],
+  ["state", "state"],
+  ["country", "country"],
+  ["email", "email"],
+  ["phone", "phone"]
+];
+function collect(value, prev) {
+  return [...prev, value];
+}
+function addOrderOptions(cmd) {
+  cmd.option(
+    "--item <tetel>",
+    "tetel: SKU=DB vagy id:SZAM=DB (tobbszor is megadhato)",
+    collect,
+    []
+  ).option(
+    "--payment <mod>",
+    "fizetesi mod: bacs|cheque|cod|wallet|card"
+  ).option("--shipping <mod>", "szallitasi mod: gls_hd|gls_parcelshop|combine_free").option("--parcelshop <id>", "GLS atveteli pont azonosito (gls_parcelshop eseten)").option("--coupon <kod>", "kuponkod").option("--currency <penznem>", "EUR vagy HUF", "EUR").option("--tax-number <adoszam>", "adoszam (ceges szamlahoz)").option("--card <pm_id>", "mentett kartya azonosito (card fizetesnel)");
+  for (const [flag] of ADDRESS_FLAG_FIELDS) {
+    cmd.option(`--billing-${flag} <ertek>`);
+    cmd.option(`--shipping-${flag} <ertek>`);
+  }
+  return cmd;
+}
+function camel(prefix, flag) {
+  return prefix + flag.split("-").map((part) => part[0].toUpperCase() + part.slice(1)).join("");
+}
+function buildOrderRequest(opts) {
+  const itemSpecs = opts.item ?? [];
+  if (itemSpecs.length === 0) {
+    usageError("Legal\xE1bb egy --item kell (pl. --item OFF2021=2). Keres\xE9s: keypro products search");
+  }
+  const payment = String(opts.payment ?? "");
+  const methodMap = {
+    bacs: "bacs",
+    cheque: "cheque",
+    cod: "cod",
+    wallet: "wallet",
+    card: "stripe",
+    stripe: "stripe"
+  };
+  const paymentMethod = methodMap[payment];
+  if (!paymentMethod) {
+    usageError("Adj meg fizet\xE9si m\xF3dot: --payment bacs|cheque|cod|wallet|card");
+  }
+  let items;
+  try {
+    items = itemSpecs.map(parseItemSpec);
+  } catch (err) {
+    usageError(err instanceof Error ? err.message : String(err));
+  }
+  const address = (prefix) => {
+    const out = {};
+    let any = false;
+    for (const [flag, field] of ADDRESS_FLAG_FIELDS) {
+      const value = opts[camel(prefix, flag)];
+      if (typeof value === "string") {
+        out[field] = value;
+        any = true;
+      }
+    }
+    return any ? out : void 0;
+  };
+  const currency = String(opts.currency ?? "EUR").toUpperCase();
+  if (currency !== "EUR" && currency !== "HUF") {
+    usageError("A --currency EUR vagy HUF lehet.");
+  }
+  return {
+    items,
+    paymentMethod,
+    shippingMethodId: opts.shipping,
+    parcelshopId: opts.parcelshop,
+    couponCode: opts.coupon,
+    currency,
+    billing: address("billing"),
+    shipping: address("shipping"),
+    taxNumber: opts.taxNumber,
+    cardId: opts.card
+  };
+}
+function printPreview(preview) {
+  printTable(
+    ["Term\xE9k", "Db", "Nett\xF3 egys\xE9g\xE1r", "Nett\xF3 \xF6sszesen"],
+    preview.lines.map((line) => [
+      String(line.name),
+      String(line.qty),
+      Number(line.unitNetEur).toFixed(2),
+      Number(line.lineNetEur).toFixed(2)
+    ])
+  );
+  process.stdout.write("\n");
+  const rows = [
+    ["Fizet\xE9si m\xF3d", String(preview.payment.label ?? "")]
+  ];
+  for (const fee of preview.payment.fees ?? []) {
+    rows.push([fee.label, eurFmt(fee.netEur)]);
+  }
+  if (preview.shipping) {
+    rows.push([
+      `Sz\xE1ll\xEDt\xE1s (${preview.shipping.label})`,
+      eurFmt(Number(preview.shipping.netEur ?? 0))
+    ]);
+  }
+  if (preview.coupon) {
+    rows.push([
+      `Kupon (${preview.coupon.code})`,
+      `-${eurFmt(Number(preview.coupon.discountNetEur ?? 0))}`
+    ]);
+  }
+  rows.push(["Nett\xF3 v\xE9g\xF6sszeg", eurFmt(preview.totals.netTotalEur)]);
+  rows.push(["\xC1FA (27%)", eurFmt(preview.totals.taxTotalEur)]);
+  rows.push(["Brutt\xF3 v\xE9g\xF6sszeg", eurFmt(preview.totals.grossTotalEur)]);
+  if (preview.currency === "HUF") {
+    rows.push(["Fizetend\u0151", `${preview.displayGrossTotal} HUF`]);
+  }
+  if (preview.wallet) {
+    rows.push([
+      "KEP egyenleg",
+      `${eurFmt(preview.wallet.balanceEurNet)} (${preview.wallet.sufficient ? "fedezi" : "NEM fedezi"})`
+    ]);
+  }
+  printKV(rows);
+}
+var order = program.command("order").description("rendelesek");
+addOrderOptions(
+  order.command("preview").description("rendeles-elonezet: vegosszegek iras nelkul + confirmToken")
+).action(async (opts, cmd) => {
+  try {
+    const request = buildOrderRequest(opts);
+    const preview = await clientFor(cmd).orderPreview(request);
+    output(preview, () => {
+      printPreview(preview);
+      process.stdout.write(
+        "\nMegrendel\xE9s: ugyanezekkel a kapcsol\xF3kkal futtasd az order create --yes parancsot.\n"
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+addOrderOptions(
+  order.command("create").description("rendeles leadasa (elobb elonezet; --yes nelkul nem rendel)")
+).option("--yes", "a rendeles tenyleges leadasa", false).option(
+  "--idempotency-key <kulcs>",
+  "retry-dedup kulcs: ugyanazzal a kulccsal nem jon letre masodik rendeles"
+).action(async (opts, cmd) => {
+  try {
+    const request = buildOrderRequest(opts);
+    const client = clientFor(cmd);
+    const preview = await client.orderPreview(request);
+    if (!opts.yes) {
+      output({ preview, hint: "Add hozz\xE1 a --yes kapcsol\xF3t a megrendel\xE9shez." }, () => {
+        printPreview(preview);
+        process.stdout.write(
+          "\nEz csak el\u0151n\xE9zet volt. Add hozz\xE1 a --yes kapcsol\xF3t a megrendel\xE9shez.\n"
+        );
+      });
+      process.exit(1);
+    }
+    const idempotencyKey = opts.idempotencyKey ?? `cli-${randomUUID()}`;
+    const result = await client.orderCreate(
+      { ...request, confirmToken: preview.confirmToken },
+      idempotencyKey
+    );
+    output(result, () => {
+      const orderData = result.order;
+      printKV([
+        ["Rendel\xE9s", `#${orderData.number} (id: ${orderData.id})`],
+        ["\xC1llapot", orderData.statusLabel ?? ""],
+        ["Fizet\xE9s", result.payment.note],
+        [
+          "Fizet\xE9si link",
+          result.payment.paymentUrl ? result.payment.paymentUrl : null
+        ],
+        [
+          "KEP egyenleg",
+          result.payment.walletBalanceAfterEur !== void 0 ? eurFmt(result.payment.walletBalanceAfterEur) : null
+        ],
+        [
+          "K\xE9zbes\xEDtett kulcsok",
+          result.deliveredKeyCount > 0 ? `${result.deliveredKeyCount} db (keypro keys list --order ${orderData.id})` : null
+        ],
+        [
+          "Sz\xE1ml\xE1k",
+          result.invoices.length > 0 ? result.invoices.map((inv) => `${inv.typeLabel}: ${inv.downloadUrl ?? "k\xE9sz\xFCl"}`).join("; ") : null
+        ]
+      ]);
+      if (result.payment.paymentUrl) {
+        process.stdout.write(
+          "\nFONTOS: a fizet\xE9shez nyisd meg a fenti fizet\xE9si linket a b\xF6ng\xE9sz\u0151ben (kb. 1 \xF3r\xE1ig \xE9rv\xE9nyes).\n"
+        );
+      }
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+order.command("list").description("rendelesek listaja").option("--status <statusz>", "szures statuszra (pl. processing, completed)").option("--limit <n>", "darabszam", "25").action(async (opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).ordersList({
+      status: opts.status,
+      limit: Number(opts.limit)
+    });
+    output(result, () => {
+      printTable(
+        ["ID", "Sz\xE1m", "D\xE1tum", "\xC1llapot", "Fizet\xE9s", "Brutt\xF3 EUR", "T\xE9telek"],
+        result.orders.map((o) => [
+          String(o.id),
+          `#${o.number}`,
+          String(o.createdAt).slice(0, 10),
+          String(o.statusLabel),
+          String(o.paymentMethodLabel),
+          Number(o.grossTotalEur).toFixed(2),
+          o.itemNames.join(", ").slice(0, 60)
+        ])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+order.command("get <id>").description("rendeles reszletei").action(async (id, _opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).orderGet(Number(id));
+    output(result, () => {
+      const o = result.order;
+      printKV([
+        ["Rendel\xE9s", `#${o.number} (id: ${o.id})`],
+        ["\xC1llapot", String(o.statusLabel)],
+        ["Fizet\xE9si m\xF3d", String(o.paymentMethodLabel)],
+        ["D\xE1tum", String(o.createdAt).slice(0, 10)],
+        ["Nett\xF3", eurFmt(Number(o.netTotalEur))],
+        ["Brutt\xF3", eurFmt(Number(o.grossTotalEur))],
+        ["Fizet\xE9si link", result.paymentUrl]
+      ]);
+      process.stdout.write("\n");
+      printTable(
+        ["T\xE9tel", "Db", "Nett\xF3 \xF6sszesen"],
+        o.items.map((item) => [
+          String(item.name),
+          String(item.qty),
+          Number(item.lineNetEur).toFixed(2)
+        ])
+      );
+      if (result.invoices.length > 0) {
+        process.stdout.write("\nSz\xE1ml\xE1k:\n");
+        printTable(
+          ["ID", "T\xEDpus", "Sz\xE1m", "\xC1llapot", "Let\xF6lt\xE9s"],
+          result.invoices.map((inv) => [
+            String(inv.id),
+            String(inv.typeLabel),
+            inv.number ? String(inv.number) : "-",
+            String(inv.statusLabel),
+            inv.downloadUrl ? String(inv.downloadUrl) : "-"
+          ])
+        );
+      }
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var keysCmd = program.command("keys").description("term\xE9kkulcsok");
+keysCmd.command("list").description("kezbesitett term\xE9kkulcsok (osszes vagy egy rendelese)").option("--order <id>", "csak az adott rendeles kulcsai").action(async (opts, cmd) => {
+  try {
+    const client = clientFor(cmd);
+    if (opts.order) {
+      const result = await client.orderKeys(Number(opts.order));
+      output(result, () => {
+        if (result.keys.length === 0 && result.licenses.length === 0) {
+          process.stdout.write(
+            "Ehhez a rendel\xE9shez m\xE9g nincs k\xE9zbes\xEDtett kulcs (fizet\xE9sre vagy feldolgoz\xE1sra v\xE1r).\n"
+          );
+          return;
+        }
+        printTable(
+          ["Term\xE9k", "Kulcs", "K\xE9zbes\xEDtve"],
+          [
+            ...result.keys.map((k) => [
+              k.productName,
+              k.keyValue,
+              k.deliveredAt ? String(k.deliveredAt).slice(0, 10) : "-"
+            ]),
+            ...result.licenses.map((lic) => [
+              String(lic.productName ?? "-"),
+              lic.keyValue ? String(lic.keyValue) : "(kulcs a weben: /view-license-keys)",
+              String(lic.statusLabel)
+            ])
+          ]
+        );
+      });
+    } else {
+      const result = await client.licenseKeys();
+      output(result, () => {
+        for (const group of result.products) {
+          process.stdout.write(`
+${group.productName}
+`);
+          printTable(
+            ["Kulcs", "Rendel\xE9s", "K\xE9zbes\xEDtve"],
+            group.keys.map((k) => [
+              String(k.keyValue),
+              k.orderNumber ? `#${k.orderNumber}` : "-",
+              k.deliveredAt ? String(k.deliveredAt).slice(0, 10) : "-"
+            ])
+          );
+        }
+        if (result.products.length === 0) {
+          process.stdout.write("M\xE9g nincs k\xE9zbes\xEDtett term\xE9kkulcsod.\n");
+        }
+      });
+    }
+  } catch (err) {
+    fail(err);
+  }
+});
+var invoicesCmd = program.command("invoices").description("szamlak, dijbekerok");
+invoicesCmd.command("list").description("bizonylatok listaja").option("--order <id>", "csak az adott rendeles bizonylatai").option("--limit <n>", "darabszam", "25").action(async (opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).invoicesList({
+      orderId: opts.order ? Number(opts.order) : void 0,
+      limit: Number(opts.limit)
+    });
+    output(result, () => {
+      printTable(
+        ["ID", "T\xEDpus", "Sz\xE1m", "Rendel\xE9s", "\xC1llapot", "Brutt\xF3 EUR", "Let\xF6lt\xE9s"],
+        result.invoices.map((inv) => [
+          String(inv.id),
+          String(inv.typeLabel),
+          inv.number ? String(inv.number) : "-",
+          inv.orderNumber ? `#${inv.orderNumber}` : "-",
+          String(inv.statusLabel),
+          Number(inv.grossTotalEur).toFixed(2),
+          inv.downloadUrl ? String(inv.downloadUrl) : "-"
+        ])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+invoicesCmd.command("get <id>").description("bizonylat reszletei; --download: mentes fajlba").option("--download <fajl>", "a bizonylat letoltese a megadott fajlba").action(async (id, opts, cmd) => {
+  try {
+    const { invoice } = await clientFor(cmd).invoiceGet(Number(id));
+    if (opts.download) {
+      const url = invoice.downloadUrl;
+      if (!url) {
+        fail(new Error("Ehhez a bizonylathoz nincs let\xF6lthet\u0151 dokumentum."));
+      }
+      const response = await fetch(url);
+      if (!response.ok) {
+        fail(new Error(`A let\xF6lt\xE9s nem siker\xFClt (HTTP ${response.status}).`));
+      }
+      const buffer = Buffer.from(await response.arrayBuffer());
+      writeFileSync2(opts.download, buffer);
+      output({ invoice, savedTo: opts.download, bytes: buffer.length }, () => {
+        process.stdout.write(`Mentve: ${opts.download} (${buffer.length} b\xE1jt)
+`);
+      });
+      return;
+    }
+    output({ invoice }, () => {
+      printKV([
+        ["Bizonylat", `${invoice.typeLabel} ${invoice.number ?? "(m\xE9g sz\xE1mozatlan)"}`],
+        ["Rendel\xE9s", invoice.orderNumber ? `#${invoice.orderNumber}` : null],
+        ["\xC1llapot", String(invoice.statusLabel)],
+        ["Nett\xF3", eurFmt(Number(invoice.netTotalEur))],
+        ["\xC1FA", eurFmt(Number(invoice.vatEur))],
+        ["Brutt\xF3", eurFmt(Number(invoice.grossTotalEur))],
+        ["Let\xF6lt\xE9s", invoice.downloadUrl]
+      ]);
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var profile = program.command("profile").description("fiok torzsadatok");
+profile.command("get").description("kontakt + szamlazasi + szallitasi adatok").action(async (_opts, cmd) => {
+  try {
+    const { profile: p } = await clientFor(cmd).profileGet();
+    output({ profile: p }, () => {
+      const billing = p.billing;
+      const shipping = p.shipping;
+      printKV([
+        ["Email", String(p.email)],
+        ["C\xE9g", p.companyName],
+        ["Ad\xF3sz\xE1m", p.taxNumber],
+        ["N\xE9v", p.firstName],
+        ["Telefon", p.phone],
+        ["Weboldal", p.website]
+      ]);
+      process.stdout.write("\nSz\xE1ml\xE1z\xE1si c\xEDm:\n");
+      printKV(
+        Object.entries(billing).map(([k, v]) => [`  billing.${k}`, v])
+      );
+      process.stdout.write("\nSz\xE1ll\xEDt\xE1si c\xEDm:\n");
+      printKV(
+        Object.entries(shipping).map(([k, v]) => [`  shipping.${k}`, v])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var CONTACT_FIELD_MAP = {
+  firstName: "firstName",
+  phone: "phone",
+  website: "website",
+  company: "companyName",
+  taxNumber: "taxNumber"
+};
+var ADDRESS_FIELD_NAMES = [
+  "firstName",
+  "lastName",
+  "company",
+  "address1",
+  "address2",
+  "city",
+  "postcode",
+  "state",
+  "country",
+  "email",
+  "phone"
+];
+profile.command("set <mezo=ertek...>").description(
+  "adatmodositas, pl.: keypro profile set billing.city=Budapest contact.phone=+36201234567 (ures ertek torol)"
+).action(async (pairs, _opts, cmd) => {
+  try {
+    const patch = {};
+    for (const pair of pairs) {
+      const eq = pair.indexOf("=");
+      if (eq === -1) {
+        usageError(`Hib\xE1s megad\xE1s: "${pair}" (mezo=ertek form\xE1t v\xE1runk).`);
+      }
+      const keyName = pair.slice(0, eq).trim();
+      const value = pair.slice(eq + 1);
+      const [section, field] = keyName.split(".", 2);
+      if (!field) {
+        usageError(
+          `Hib\xE1s mez\u0151: "${keyName}". Form\xE1tum: contact.*, billing.*, shipping.* (pl. billing.city)`
+        );
+      }
+      if (section === "contact") {
+        const mapped = CONTACT_FIELD_MAP[field];
+        if (!mapped) {
+          usageError(
+            `Ismeretlen contact mez\u0151: ${field}. Lehets\xE9ges: ${Object.keys(CONTACT_FIELD_MAP).join(", ")}`
+          );
+        }
+        patch[mapped] = value;
+      } else if (section === "billing" || section === "shipping") {
+        if (!ADDRESS_FIELD_NAMES.includes(field)) {
+          usageError(
+            `Ismeretlen ${section} mez\u0151: ${field}. Lehets\xE9ges: ${ADDRESS_FIELD_NAMES.join(", ")}`
+          );
+        }
+        if (section === "shipping" && field === "email") {
+          usageError("A sz\xE1ll\xEDt\xE1si c\xEDmhez nincs email mez\u0151.");
+        }
+        patch[section + field[0].toUpperCase() + field.slice(1)] = value;
+      } else {
+        usageError(
+          `Ismeretlen szekci\xF3: ${section}. Lehets\xE9ges: contact, billing, shipping`
+        );
+      }
+    }
+    const result = await clientFor(cmd).profileUpdate(patch);
+    output(result, () => {
+      process.stdout.write(
+        `Friss\xEDtve: ${result.updated.join(", ")}
+`
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var wallet = program.command("wallet").description("KEP egyenleg");
+wallet.action(async (_opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).wallet({ limit: 1 });
+    output({ balanceEurNet: result.balanceEurNet }, () => {
+      printKV([["KEP egyenleg (nett\xF3)", eurFmt(result.balanceEurNet)]]);
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+wallet.command("transactions").description("KEP tranzakcio-tortenet").option("--limit <n>", "darabszam", "25").action(async (opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).wallet({ limit: Number(opts.limit) });
+    output(result, () => {
+      printKV([["KEP egyenleg (nett\xF3)", eurFmt(result.balanceEurNet)]]);
+      process.stdout.write("\n");
+      printTable(
+        ["D\xE1tum", "T\xEDpus", "\xD6sszeg EUR", "Egyenleg ut\xE1na", "Rendel\xE9s", "Megjegyz\xE9s"],
+        result.transactions.map((tx) => [
+          String(tx.createdAt).slice(0, 10),
+          String(tx.typeLabel),
+          Number(tx.amountEur).toFixed(2),
+          Number(tx.balanceAfterEur).toFixed(2),
+          tx.orderNumber ? `#${tx.orderNumber}` : "-",
+          tx.description ? String(tx.description) : "-"
+        ])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var cards = program.command("cards").description("mentett bankkartyak");
+cards.command("list").description("mentett kartyak (kartyat felvenni a weben lehet)").action(async (_opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).cardsList();
+    output(result, () => {
+      if (!result.stripeEnabled) {
+        process.stdout.write(
+          "A k\xE1rty\xE1s fizet\xE9s ezen a k\xF6rnyezeten nincs bek\xF6tve.\n"
+        );
+        return;
+      }
+      if (result.cards.length === 0) {
+        process.stdout.write(
+          "Nincs mentett k\xE1rtya. K\xE1rty\xE1t a weben tudsz menteni: /payment-methods\n"
+        );
+        return;
+      }
+      printTable(
+        ["ID", "K\xE1rtya", "Lej\xE1rat", "Alap\xE9rtelmezett"],
+        result.cards.map((card) => [
+          card.id,
+          `${card.brand} **** ${card.last4}`,
+          `${card.expMonth}/${card.expYear}`,
+          card.isDefault ? "igen" : ""
+        ])
+      );
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+var parcelshops = program.command("parcelshops").description("GLS atveteli pontok");
+parcelshops.command("search <keresoszo>").description("csomagpont/automata kereses (varos, iranyitoszam vagy nev)").option("--type <tipus>", "parcel-shop | parcel-locker | all", "all").action(async (query, opts, cmd) => {
+  try {
+    const result = await clientFor(cmd).parcelshopsSearch(query, opts.type);
+    output(result, () => {
+      printTable(
+        ["ID", "N\xE9v", "T\xEDpus", "C\xEDm"],
+        result.parcelshops.map((p) => [
+          String(p.id),
+          String(p.name),
+          p.type === "parcel-locker" ? "automata" : "csomagpont",
+          `${p.postcode} ${p.city}, ${p.address}`
+        ])
+      );
+      if (result.truncated) {
+        process.stdout.write("\n(a lista csonkolva - pontos\xEDtsd a keres\xE9st)\n");
+      }
+    });
+  } catch (err) {
+    fail(err);
+  }
+});
+program.command("agent-docs").description("beepitett utmutato AI-agenteknek (angol)").action(() => {
+  process.stdout.write(AGENT_DOCS);
+});
+program.command("mcp").description("MCP stdio szerver mod (Claude Code: claude mcp add keypro -- keypro mcp)").action(async (_opts, cmd) => {
+  const cfg = resolved(cmd);
+  if (!cfg.apiKey) {
+    process.stderr.write(
+      "Nincs API kulcs. Futtasd elobb: keypro login (vagy KEYPRO_API_KEY env).\n"
+    );
+    process.exit(3);
+  }
+  await runMcpServer(createClient({ apiBase: cfg.apiBase, apiKey: cfg.apiKey }));
+});
+program.parseAsync(process.argv).catch((err) => {
+  fail(err);
+});