kassza 0.13.0 → 0.15.0

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { i as isSzamlazzError, n as SzamlazzError } from "./errors-DLrb0g64.js";
-import { i as buildCreateInvoiceXml, t as createKassza } from "./client-CfaS1-Jx.js";
-import { r as el } from "./serialize-DSE_o9RK.js";
-import { i as buildCreateReceiptXml } from "./issue-DtSLpVdJ.js";
-import { i as navDailyReports, n as describeNavReport } from "./nav-CK1WgYo7.js";
-import { n as KASSZA_VERSION, t as createKasszaMcpServer } from "./server-Cd8HB661.js";
+import { o as isSzamlazzError, r as SzamlazzError } from "./errors-DtN4g5Z9.js";
+import { s as buildCreateInvoiceXml, t as createKassza } from "./client-Cvf-hTz_.js";
+import { r as el } from "./serialize-B2eFh3D-.js";
+import { t as buildCreateReceiptXml } from "./create-CflXrPip.js";
+import { i as navDailyReports, n as describeNavReport } from "./nav-BcCerwWS.js";
+import { n as KASSZA_VERSION, t as createKasszaMcpServer } from "./server-CqqECkMp.js";
 import { readFile } from "node:fs/promises";
 import { createInterface } from "node:readline";
 //#region src/cli/args.ts
@@ -222,6 +222,8 @@ async function navSummaryCommand(io, args) {
 }
 //#endregion
 //#region src/cli/doctor.ts
+const NPM_LATEST_URL = "https://registry.npmjs.org/kassza/latest";
+const USED_BY_URL = "https://github.com/futozs/kassza/issues/new?template=used-by.yml";
 const MINIMUM_NODE_MAJOR = 22;
 const CLOCK_OK_SECONDS = 2;
 const CLOCK_WARN_SECONDS = 30;
@@ -317,6 +319,57 @@ async function accountCheck(kassza, options) {
 	}
 	return check("account", "skip", "Fiók típusa: add meg egy meglévő bizonylat számát (--invoice vagy --receipt), abból kiderül, hogy teszt- vagy éles fiók.");
 }
+const PROBE_BUYER = {
+	name: "Kassza doctor próba",
+	zip: "1111",
+	city: "Budapest",
+	address: "Próba utca 1."
+};
+async function eInvoiceCheck(kassza) {
+	try {
+		await kassza.invoices.preview({
+			buyer: PROBE_BUYER,
+			items: [{
+				name: "Próba",
+				netUnitPrice: 1,
+				vat: 27
+			}],
+			eInvoice: true
+		});
+		return check("e-invoice", "ok", "E-számla: engedélyezve (előnézettel ellenőrizve, bizonylat nem készült).");
+	} catch (error) {
+		if (isSzamlazzError(error) && (error.code === 54 || error.code === 55 || error.code === 49)) return check("e-invoice", "warn", `E-számla: nem használható (${error.message}).`);
+		return check("e-invoice", "warn", `E-számla: az előnézet nem sikerült. ${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+function receiptCapabilityCheck() {
+	return check("receipt", "skip", "Nyugta: a nyugtaelőtagot és a jogosultságot csak valódi kiállítás ellenőrzi (524, 8). Próbáld tesztfiókon.");
+}
+function environmentCheck(account, nodeEnv) {
+	if (account.status !== "ok" || !account.message.includes("éles fiók")) return void 0;
+	if (nodeEnv === "test" || nodeEnv === "development") return check("environment", "warn", `Környezet: NODE_ENV=${nodeEnv}, de az Agent kulcs éles fiókhoz tartozik. A tesztek valódi bizonylatot állíthatnak ki.`);
+}
+function compareVersions(a, b) {
+	const parse = (value) => value.replace(/^v/, "").split(/[.-]/).slice(0, 3).map((part) => Number.parseInt(part, 10) || 0);
+	const left = parse(a);
+	const right = parse(b);
+	for (let index = 0; index < 3; index++) {
+		const difference = (left[index] ?? 0) - (right[index] ?? 0);
+		if (difference !== 0) return difference;
+	}
+	return 0;
+}
+async function updateCheck(fetchImpl) {
+	try {
+		const response = await fetchImpl(NPM_LATEST_URL, { headers: { accept: "application/json" } });
+		if (!response.ok) throw new Error(`HTTP ${response.status}`);
+		const latest = String((await response.json()).version ?? "");
+		if (!/^\d+\.\d+\.\d+/.test(latest)) throw new Error("nincs verziószám a válaszban");
+		return compareVersions(latest, KASSZA_VERSION) > 0 ? check("update", "warn", `Frissítés: elérhető a kassza ${latest} (most: ${KASSZA_VERSION}).`) : check("update", "ok", `Frissítés: a kassza ${KASSZA_VERSION} a legfrissebb.`);
+	} catch (error) {
+		return check("update", "skip", `Frissítés: az npm nem volt elérhető (${error instanceof Error ? error.message : String(error)}).`);
+	}
+}
 function accountOf(test) {
 	if (test === true) return check("account", "ok", "Fiók típusa: tesztfiók.");
 	if (test === false) return check("account", "ok", "Fiók típusa: éles fiók, a kiállított bizonylatok valódiak.");
@@ -339,12 +392,18 @@ async function runDoctor(io, options = {}) {
 	});
 	const auth = await authCheck(kassza);
 	const account = auth.status === "ok" ? await accountCheck(kassza, options) : check("account", "skip", "Fiók típusa: sikertelen hitelesítés miatt kimaradt.");
+	const extra = [];
+	const environment = environmentCheck(account, io.env.NODE_ENV);
+	if (environment) extra.push(environment);
+	if (options.capabilities === true && auth.status === "ok") extra.push(await eInvoiceCheck(kassza), receiptCapabilityCheck());
+	if (options.checkUpdate === true) extra.push(await updateCheck(io.fetch ?? globalThis.fetch));
 	return [
 		...checks,
 		auth,
 		clockCheck(samples),
 		sessionCheck(samples),
-		account
+		account,
+		...extra
 	];
 }
 const SYMBOLS = {
@@ -353,13 +412,34 @@ const SYMBOLS = {
 	fail: "✗",
 	skip: "-"
 };
+function summary(checks) {
+	return `Összegzés: ${checks.filter((entry) => entry.status === "fail").length} hiba, ${checks.filter((entry) => entry.status === "warn").length} figyelmeztetés.`;
+}
 function formatDoctor(checks) {
-	const failures = checks.filter((entry) => entry.status === "fail").length;
-	const warnings = checks.filter((entry) => entry.status === "warn").length;
+	const healthy = !checks.some((entry) => entry.status === "fail");
 	return [
 		...checks.map((entry) => `${SYMBOLS[entry.status]} ${entry.message}`),
 		"",
-		`Összegzés: ${failures} hiba, ${warnings} figyelmeztetés.`,
+		summary(checks),
+		...healthy ? ["", `Használod a kasszát? Két perc, és sokat segít: ${USED_BY_URL}`] : [],
+		""
+	].join("\n");
+}
+function formatDoctorReport(checks, meta) {
+	return [
+		"## kassza doctor jelentés",
+		"",
+		`- kassza: ${KASSZA_VERSION}`,
+		`- Node.js: ${meta.nodeVersion}`,
+		...meta.platform ? [`- platform: ${meta.platform}`] : [],
+		"",
+		"| Ellenőrzés | Állapot | Eredmény |",
+		"| --- | --- | --- |",
+		...checks.map((entry) => `| ${entry.id} | ${entry.status} | ${entry.message.replace(/\|/g, "\\|")} |`),
+		"",
+		summary(checks),
+		"",
+		"A jelentés nem tartalmaz Agent kulcsot, vevői adatot vagy bizonylattartalmat. Átadás előtt nézd át.",
 		""
 	].join("\n");
 }
@@ -401,8 +481,11 @@ const CLI_USAGE = `kassza ${KASSZA_VERSION}: Számlázz.hu Számla Agent parancs
 Használat: kassza <parancs> [kapcsolók]
 
 Parancsok:
-  doctor [--invoice <szám> | --receipt <szám>] [--json]
+  doctor [--invoice <szám> | --receipt <szám>] [--capabilities] [--check-update] [--json | --report]
       A környezet, az Agent kulcs, az óra és a Számlázz.hu kapcsolat ellenőrzése.
+      --capabilities: e-számla engedély előnézettel (bizonylat nem készül)
+      --check-update: az npm legfrissebb verziójának lekérdezése (hálózati hívás)
+      --report: titokmentes Markdown jelentés hibajegyhez
   verify
       Az Agent kulcs ellenőrzése a Számlázz.hu-n.
   xml preview <fájl.json|-> [--type invoice|receipt] [--defaults <fájl.json>]
@@ -422,7 +505,12 @@ Környezeti változók:
 `;
 const SPECS = {
 	doctor: {
-		booleans: ["json"],
+		booleans: [
+			"json",
+			"report",
+			"capabilities",
+			"check-update"
+		],
 		values: ["invoice", "receipt"]
 	},
 	verify: {},
@@ -452,9 +540,12 @@ function commandOf(argv) {
 async function doctorCommand(io, args) {
 	const checks = await runDoctor(io, {
 		invoiceNumber: flagValue(args, "invoice"),
-		receiptNumber: flagValue(args, "receipt")
+		receiptNumber: flagValue(args, "receipt"),
+		capabilities: hasFlag(args, "capabilities"),
+		checkUpdate: hasFlag(args, "check-update")
 	});
 	if (hasFlag(args, "json")) printJson(io, { checks });
+	else if (hasFlag(args, "report")) io.stdout(formatDoctorReport(checks, { nodeVersion: io.nodeVersion }));
 	else io.stdout(`kassza doctor ${KASSZA_VERSION}\n${formatDoctor(checks)}`);
 	return checks.some((check) => check.status === "fail") ? 1 : 0;
 }