kassza 0.13.0 → 0.14.0

package/dist/batch/index.js

@@ -0,0 +1,339 @@
+import { o as isSzamlazzError, r as SzamlazzError } from "../errors-DtN4g5Z9.js";
+import { n as toAgentDate, t as addBudapestDays } from "../dates-CXyj7Azy.js";
+import { n as calculateReceiptItems } from "../create-CflXrPip.js";
+//#region src/batch/recurring.ts
+const INTERVALS = /* @__PURE__ */ new Set([
+	"week",
+	"month",
+	"quarter",
+	"year"
+]);
+const MONTHS = {
+	month: 1,
+	quarter: 3,
+	year: 12
+};
+function invalid$1(message) {
+	return new SzamlazzError(message, { category: "validation" });
+}
+function parts(day) {
+	const [year, month, date] = day.split("-").map(Number);
+	return [
+		year,
+		month,
+		date
+	];
+}
+function format(year, month, day) {
+	return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
+}
+function daysInMonth(year, month) {
+	return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function addDays(day, days) {
+	const [year, month, date] = parts(day);
+	return new Date(Date.UTC(year, month - 1, date + days)).toISOString().slice(0, 10);
+}
+function shift(anchor, interval, count) {
+	if (interval === "week") return addDays(anchor, count * 7);
+	const [year, month, day] = parts(anchor);
+	const total = year * 12 + (month - 1) + count * MONTHS[interval];
+	const targetYear = Math.floor(total / 12);
+	const targetMonth = total % 12 + 1;
+	return format(targetYear, targetMonth, Math.min(day, daysInMonth(targetYear, targetMonth)));
+}
+function resolve(options) {
+	if (!INTERVALS.has(options.interval)) throw invalid$1(`Ismeretlen számlázási időszak: ${String(options.interval)}`);
+	let anchor;
+	try {
+		anchor = toAgentDate(options.anchor);
+	} catch (error) {
+		throw invalid$1(error instanceof Error ? error.message : String(error));
+	}
+	const due = options.paymentDueInDays;
+	if (due !== void 0 && (!Number.isInteger(due) || due < 0)) throw invalid$1(`A paymentDueInDays nemnegatív egész legyen, kapott: ${due}`);
+	return {
+		anchor,
+		interval: options.interval
+	};
+}
+function billingPeriod(options, index) {
+	if (!Number.isInteger(index) || index < 0) throw invalid$1(`Az időszak sorszáma nemnegatív egész legyen, kapott: ${index}`);
+	const { anchor, interval } = resolve(options);
+	const start = shift(anchor, interval, index);
+	const end = addDays(shift(anchor, interval, index + 1), -1);
+	const due = options.paymentDueInDays;
+	return {
+		index,
+		interval,
+		start,
+		end,
+		...due === void 0 ? {} : { dueDate: addDays(start, due) },
+		key: `${interval}:${start}`
+	};
+}
+function billingPeriodAt(options, date) {
+	const { anchor, interval } = resolve(options);
+	let day;
+	try {
+		day = toAgentDate(date);
+	} catch (error) {
+		throw invalid$1(error instanceof Error ? error.message : String(error));
+	}
+	if (day < anchor) throw invalid$1(`A(z) ${day} dátum korábbi, mint az első időszak kezdete (${anchor}).`);
+	const [anchorYear, anchorMonth] = parts(anchor);
+	const [year, month] = parts(day);
+	let index = interval === "week" ? Math.floor((Date.parse(`${day}T00:00:00Z`) - Date.parse(`${anchor}T00:00:00Z`)) / 6048e5) : Math.floor(((year - anchorYear) * 12 + (month - anchorMonth)) / MONTHS[interval]);
+	while (index > 0 && shift(anchor, interval, index) > day) index -= 1;
+	while (shift(anchor, interval, index + 1) <= day) index += 1;
+	return billingPeriod(options, index);
+}
+function billingPeriodsBetween(options, from, to) {
+	const first = billingPeriodAt(options, from);
+	const last = billingPeriodAt(options, to);
+	const periods = [];
+	for (let index = first.index; index <= last.index; index++) periods.push(billingPeriod(options, index));
+	return periods;
+}
+function todayPeriod(options, now = /* @__PURE__ */ new Date()) {
+	return billingPeriodAt(options, addBudapestDays(now, 0));
+}
+//#endregion
+//#region src/batch/run.ts
+const MAX_BATCH_CONCURRENCY = 4;
+const DEFAULT_BATCH_RATE_PER_MINUTE = 30;
+const STOPPING_CATEGORIES = /* @__PURE__ */ new Set([
+	"rate_limit",
+	"auth",
+	"account",
+	"configuration",
+	"maintenance",
+	"attempt_limit",
+	"store_unavailable"
+]);
+function invalid(message) {
+	return new SzamlazzError(message, { category: "validation" });
+}
+function resolveConcurrency(value) {
+	if (value === void 0) return 1;
+	if (!Number.isInteger(value) || value < 1 || value > 4) throw new SzamlazzError(`A concurrency 1 és 4 közötti egész legyen, kapott: ${value}. A Számlázz.hu a párhuzamos kérések kerülését kéri.`, { category: "configuration" });
+	return value;
+}
+function resolveRate(value) {
+	if (value === void 0) return 30;
+	if (!Number.isFinite(value) || value <= 0) throw new SzamlazzError(`A ratePerMinute pozitív szám legyen, kapott: ${value}`, { category: "configuration" });
+	return value;
+}
+function assertKeys(items) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const item of items) {
+		const key = item.key?.trim();
+		if (!key) throw invalid("Minden tételhez adj meg kulcsot (key), ez lesz a rendelésszám.");
+		if (seen.has(key)) throw invalid(`A(z) ${key} kulcs kétszer szerepel a listában.`);
+		seen.add(key);
+	}
+}
+function withOrderNumber(input, key) {
+	const own = input.orderNumber?.trim();
+	if (own && own !== key) throw invalid(`A(z) ${key} tétel rendelésszáma (${own}) eltér a kulcstól. A batch a kulcsot használja rendelésszámként, hogy az újrafuttatás ne állítson ki duplát.`);
+	return {
+		...input,
+		orderNumber: key
+	};
+}
+function wait(ms, signal) {
+	if (ms <= 0) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(signal.reason);
+			return;
+		}
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(timer);
+			reject(signal?.reason);
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+function invoiceGross(result) {
+	return result.invoice?.grossTotal ?? result.details?.totals.grossAmount;
+}
+async function previewDocument(api, document, key, signal) {
+	if (document.kind === "invoice") return {
+		key,
+		status: "previewed",
+		kind: "invoice",
+		grossTotal: (await api.invoices.preview(withOrderNumber(document.input, key), { signal })).grossTotal
+	};
+	const input = withOrderNumber(document.input, key);
+	if (input.items.length === 0) throw invalid(`A(z) ${key} nyugtán nincs tétel.`);
+	const gross = calculateReceiptItems(input.items, input.currency ?? "HUF").reduce((sum, item) => sum + item.amounts.grossAmount, 0);
+	return {
+		key,
+		status: "previewed",
+		kind: "receipt",
+		grossTotal: Math.round(gross * 100) / 100
+	};
+}
+async function issueDocument(api, document, key, options) {
+	const onceOptions = {
+		signal: options.signal,
+		recoveryDelayMs: options.recoveryDelayMs
+	};
+	if (document.kind === "invoice") {
+		const input = withOrderNumber(document.input, key);
+		const run = () => api.invoices.createOnce(input, onceOptions);
+		const result = options.journal ? await options.journal.trackInvoice(key, run) : await run();
+		return {
+			key,
+			status: result.created ? "created" : "existing",
+			kind: "invoice",
+			number: result.number,
+			grossTotal: invoiceGross(result)
+		};
+	}
+	const input = withOrderNumber(document.input, key);
+	const run = () => api.receipts.createOnce(input, onceOptions);
+	const result = options.journal ? await options.journal.trackReceipt(key, run) : await run();
+	return {
+		key,
+		status: result.created ? "created" : "existing",
+		kind: "receipt",
+		number: result.receipt.number,
+		grossTotal: result.receipt.totals.grossAmount
+	};
+}
+function stopReason(error) {
+	if (!isSzamlazzError(error) || !STOPPING_CATEGORIES.has(error.category)) return void 0;
+	return `A(z) ${error.category} hiba miatt a batch leállt, a hátralévő tételek nem futottak le: ${error.message}`;
+}
+async function runBatch(api, options) {
+	const concurrency = resolveConcurrency(options.concurrency);
+	const intervalMs = 6e4 / resolveRate(options.ratePerMinute);
+	assertKeys(options.items);
+	const dryRun = options.dryRun === true;
+	const results = new Array(options.items.length);
+	const counts = {
+		created: 0,
+		existing: 0,
+		previewed: 0,
+		failed: 0,
+		skipped: 0
+	};
+	let done = 0;
+	let cursor = 0;
+	let nextStart = Date.now();
+	const control = { stopped: void 0 };
+	const currentStop = () => control.stopped;
+	const record = (index, result) => {
+		results[index] = result;
+		counts[result.status] += 1;
+		done += 1;
+		try {
+			options.onProgress?.({
+				total: options.items.length,
+				done,
+				...counts,
+				key: result.key,
+				status: result.status
+			});
+		} catch {
+			return;
+		}
+	};
+	const processItem = async (index, item) => {
+		const key = item.key.trim();
+		try {
+			const document = await item.document();
+			const result = dryRun ? await previewDocument(api, document, key, options.signal) : await issueDocument(api, document, key, options);
+			record(index, result);
+		} catch (error) {
+			if (options.signal?.aborted && error === options.signal.reason) {
+				control.stopped ??= {
+					reason: "A batch futását megszakították.",
+					error
+				};
+				record(index, {
+					key,
+					status: "skipped",
+					reason: "Megszakítva."
+				});
+				return;
+			}
+			const reason = stopReason(error);
+			if (reason) control.stopped ??= {
+				reason,
+				error
+			};
+			record(index, {
+				key,
+				status: "failed",
+				error
+			});
+		}
+	};
+	const worker = async () => {
+		for (;;) {
+			if (control.stopped || options.signal?.aborted) return;
+			const index = cursor;
+			cursor += 1;
+			const item = options.items[index];
+			if (!item) return;
+			const delay = nextStart - Date.now();
+			nextStart = Math.max(nextStart, Date.now()) + intervalMs;
+			try {
+				await wait(delay, options.signal);
+			} catch (error) {
+				control.stopped ??= {
+					reason: "A batch futását megszakították.",
+					error
+				};
+				record(index, {
+					key: item.key.trim(),
+					status: "skipped",
+					reason: "Megszakítva."
+				});
+				return;
+			}
+			const stop = currentStop();
+			if (stop) {
+				record(index, {
+					key: item.key.trim(),
+					status: "skipped",
+					reason: stop.reason
+				});
+				return;
+			}
+			await processItem(index, item);
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(concurrency, options.items.length) }, worker));
+	if (options.signal?.aborted) control.stopped ??= { reason: "A batch futását megszakították." };
+	options.items.forEach((item, index) => {
+		if (results[index]) return;
+		record(index, {
+			key: item.key.trim(),
+			status: "skipped",
+			reason: control.stopped?.reason ?? "Nem futott le."
+		});
+	});
+	const by = (status) => results.filter((result) => result.status === status);
+	const grossTotal = results.filter((result) => result.status !== "failed" && result.status !== "skipped").reduce((sum, result) => sum + (result.grossTotal ?? 0), 0);
+	return {
+		dryRun,
+		items: results,
+		created: by("created"),
+		existing: by("existing"),
+		previewed: by("previewed"),
+		failed: by("failed"),
+		skipped: by("skipped"),
+		stopped: control.stopped,
+		grossTotal: Math.round(grossTotal * 100) / 100
+	};
+}
+//#endregion
+export { DEFAULT_BATCH_RATE_PER_MINUTE, MAX_BATCH_CONCURRENCY, billingPeriod, billingPeriodAt, billingPeriodsBetween, runBatch, todayPeriod };

package/dist/cli.cjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-const require_errors = require("./errors-DxeuTslP.cjs");
-const require_client = require("./client-C-PdfL_P.cjs");
-const require_serialize = require("./serialize-BXOww1Uq.cjs");
-const require_issue = require("./issue-AGRohSm7.cjs");
-const require_nav = require("./nav-BEwcX7-N.cjs");
-const require_server = require("./server-C6PoNkdD.cjs");
+const require_errors = require("./errors-EE96_6D_.cjs");
+const require_client = require("./client-CLFvJCVW.cjs");
+const require_serialize = require("./serialize-CquIsxA-.cjs");
+const require_create = require("./create-CvUvLUaT.cjs");
+const require_nav = require("./nav-BNbc8U0R.cjs");
+const require_server = require("./server-Dw9j8Mnd.cjs");
 let node_fs_promises = require("node:fs/promises");
 let node_readline = require("node:readline");
 //#region src/cli/args.ts
@@ -147,7 +147,7 @@ async function xmlPreviewCommand(io, args) {
 	const defaultsPath = flagValue(args, "defaults");
 	const source = previewSource(await readJson(io, path), defaultsPath === void 0 ? void 0 : await readDefaults(io, defaultsPath));
 	assertDocumentShape(source.input, type);
-	const xml = type === "invoice" ? require_client.buildCreateInvoiceXml(MASKED_CREDENTIALS, source.defaults.invoice ?? {}, source.input, io.now?.() ?? /* @__PURE__ */ new Date()) : require_issue.buildCreateReceiptXml(MASKED_CREDENTIALS, source.defaults.receipt ?? {}, source.input);
+	const xml = type === "invoice" ? require_client.buildCreateInvoiceXml(MASKED_CREDENTIALS, source.defaults.invoice ?? {}, source.input, io.now?.() ?? /* @__PURE__ */ new Date()) : require_create.buildCreateReceiptXml(MASKED_CREDENTIALS, source.defaults.receipt ?? {}, source.input);
 	io.stdout(xml);
 	return 0;
 }
@@ -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 (require_errors.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, require_server.KASSZA_VERSION) > 0 ? check("update", "warn", `Frissítés: elérhető a kassza ${latest} (most: ${require_server.KASSZA_VERSION}).`) : check("update", "ok", `Frissítés: a kassza ${require_server.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: ${require_server.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 ${require_server.KASSZA_VERSION}: Számlázz.hu Száml
 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 ${require_server.KASSZA_VERSION}\n${formatDoctor(checks)}`);
 	return checks.some((check) => check.status === "fail") ? 1 : 0;
 }