kassza 0.10.0 → 0.12.0

package/dist/client-CsmGIFRS.cjs

@@ -0,0 +1,1637 @@
+const require_create_once = require("./create-once-D0pwuenl.cjs");
+const require_errors = require("./errors-DxeuTslP.cjs");
+const require_binary = require("./binary-B89HM03_.cjs");
+const require_issue = require("./issue-BsyYdrIG.cjs");
+const require_session = require("./session-CKOuE6Jc.cjs");
+const require_dates = require("./dates-CPgBodkP.cjs");
+const require_vat = require("./vat-g35srbNG.cjs");
+const require_money = require("./money-DrhGkWHW.cjs");
+//#region src/core/attempt-ledger.ts
+const ATTEMPT_LEDGER_TTL_SECONDS = 86400;
+const ATTEMPT_LEDGER_KEY_PREFIX = "szamlazz:attempts:";
+const COUNTED_CATEGORIES = /* @__PURE__ */ new Set([
+	"auth",
+	"account",
+	"validation",
+	"maintenance",
+	"rate_limit",
+	"network",
+	"timeout",
+	"unexpected_response",
+	"unknown"
+]);
+function countsAsFailedAttempt(error) {
+	return COUNTED_CATEGORIES.has(error.category);
+}
+const encoder = new TextEncoder();
+async function attemptLedgerKey(request) {
+	const attachments = (request.attachments ?? []).map((attachment) => `${attachment.filename}:${attachment.size}`).join("|");
+	const digest = await crypto.subtle.digest("SHA-256", encoder.encode(`${request.action}\n${request.xml}\n${attachments}`));
+	const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0"));
+	return `${ATTEMPT_LEDGER_KEY_PREFIX}${hex.join("")}`;
+}
+function parseCount(value) {
+	if (value === void 0 || value === null) return 0;
+	const parsed = Number.parseInt(value, 10);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : 0;
+}
+function createAttemptLedger(store) {
+	return {
+		async failures(key) {
+			return parseCount(await store.get(key));
+		},
+		async recordFailure(key, previous) {
+			const next = previous + 1;
+			await store.set(key, String(next), ATTEMPT_LEDGER_TTL_SECONDS);
+			return next;
+		},
+		async reset(key) {
+			await store.delete(key);
+		}
+	};
+}
+function attemptLimitError(action, key, failures) {
+	return new require_errors.SzamlazzError(`Ezt a kérést már ${failures} alkalommal sikertelenül küldtük el, ezért a kassza nem küldi el újra.`, {
+		category: "attempt_limit",
+		action,
+		details: { attemptKey: key },
+		hint: "A Számlázz.hu szabályai szerint öt sikertelen próbálkozás után emberi beavatkozás kell, különben kitiltás jöhet. Javítsd a hibát, majd a kassza.resetAttempts(error) hívással töröld a számlálót."
+	});
+}
+const DEFAULT_SAFE_ATTEMPTS = 3;
+const DEFAULT_RETRY_DELAY_MS = 1e3;
+function readEnv(name) {
+	const value = (globalThis.process?.env)?.[name]?.trim();
+	return value ? value : void 0;
+}
+function configurationError(message) {
+	return new require_errors.SzamlazzError(message, { category: "configuration" });
+}
+function resolveCredentials(options) {
+	const agentKey = options.agentKey?.trim() || (options.username ? void 0 : readEnv("SZAMLAZZ_AGENT_KEY"));
+	if (agentKey) {
+		if (agentKey !== agentKey.toLowerCase()) throw configurationError("Az Agent kulcs nagybetűt tartalmaz. A Számlázz.hu csak kisbetűs kulcsot fogad el, másold ki újra a kulcsot.");
+		return [require_issue.el("szamlaagentkulcs", agentKey)];
+	}
+	if (options.username && options.password) return [require_issue.el("felhasznalo", options.username), require_issue.el("jelszo", options.password)];
+	throw configurationError("Hiányzik az Agent kulcs. Add meg az agentKey opciót, vagy állítsd be a SZAMLAZZ_AGENT_KEY környezeti változót.");
+}
+function toBlob(attachment) {
+	const type = attachment.contentType ?? "application/octet-stream";
+	if (attachment.content instanceof Blob) return attachment.content;
+	return new Blob([attachment.content], { type });
+}
+function buildFormData(request) {
+	const form = new FormData();
+	form.append(require_create_once.AGENT_ACTIONS[request.action], new Blob([request.xml], { type: "text/xml; charset=UTF-8" }), "request.xml");
+	request.attachments?.forEach((attachment, index) => {
+		form.append(`attachfile${index + 1}`, toBlob(attachment), attachment.filename);
+	});
+	return form;
+}
+function isAbortError(error) {
+	return error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError");
+}
+function sleep(ms, signal) {
+	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 });
+	});
+}
+async function ignoreStoreFailure(operation) {
+	try {
+		return await operation();
+	} catch {
+		return;
+	}
+}
+function callHook(hook, event) {
+	if (!hook) return;
+	try {
+		const result = hook(event);
+		if (result instanceof Promise) result.catch(() => void 0);
+	} catch {
+		return;
+	}
+}
+function clampAttempts(value) {
+	if (value === void 0) return DEFAULT_SAFE_ATTEMPTS;
+	if (!Number.isInteger(value) || value < 1) throw configurationError(`A maxAttempts értéke legalább 1 egész szám legyen, kapott: ${value}`);
+	return Math.min(value, 5);
+}
+function resolveCooldown(value) {
+	if (value === void 0) return 0;
+	if (!Number.isFinite(value) || value < 0) throw configurationError(`A maintenanceCooldownMs értéke nemnegatív szám legyen, kapott: ${value}`);
+	return value;
+}
+function attachmentSize(attachment) {
+	const { content } = attachment;
+	if (typeof content === "string") return new TextEncoder().encode(content).byteLength;
+	if (content instanceof Blob) return content.size;
+	return content.byteLength;
+}
+function maintenanceCooldownError(action, remainingMs) {
+	return new require_errors.SzamlazzError(`A Számlázz.hu karbantartás miatt nem érhető el, a kassza még ${Math.ceil(remainingMs / 1e3)} másodpercig nem küld kérést.`, {
+		category: "maintenance",
+		action,
+		hint: "A maintenanceCooldownMs beállítás miatt a kérés el sem indult. Válts tartalék folyamatra (például kézi nyugtatömbre), vagy próbáld később."
+	});
+}
+function createAgentContext(options = {}) {
+	const credentials = resolveCredentials(options);
+	const endpoint = options.endpoint ?? "https://www.szamlazz.hu/szamla/";
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	if (typeof fetchImpl !== "function") throw configurationError("Nem található fetch implementáció. Add meg a fetch opciót.");
+	const timeoutMs = options.timeoutMs ?? 6e4;
+	const safeAttempts = clampAttempts(options.maxAttempts);
+	const retryDelayMs = options.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+	const cookieStore = options.cookieStore === false ? void 0 : options.cookieStore ?? require_session.memoryCookieStore();
+	const sessionSecret = credentials.map((node) => String(node.content)).join("|");
+	let sessionKeyPromise;
+	const resolveSessionKey = () => {
+		sessionKeyPromise ??= require_session.sessionKeyFor(sessionSecret);
+		return sessionKeyPromise;
+	};
+	const hooks = options.hooks ?? {};
+	const ledger = options.attemptLedger ? createAttemptLedger(options.attemptLedger) : void 0;
+	const cooldownMs = resolveCooldown(options.maintenanceCooldownMs);
+	let blockedUntil = 0;
+	async function send(request) {
+		const cookie = cookieStore ? await ignoreStoreFailure(async () => cookieStore.get(await resolveSessionKey())) : void 0;
+		request.signal?.throwIfAborted();
+		const headers = new Headers({ Accept: "application/xml, application/pdf, text/plain, */*" });
+		if (cookie) headers.set("Cookie", cookie);
+		const timeoutSignal = AbortSignal.timeout(timeoutMs);
+		const signal = request.signal ? AbortSignal.any([request.signal, timeoutSignal]) : timeoutSignal;
+		let response;
+		let body;
+		try {
+			response = await fetchImpl(endpoint, {
+				method: "POST",
+				headers,
+				body: buildFormData(request),
+				signal
+			});
+			body = new Uint8Array(await response.arrayBuffer());
+		} catch (error) {
+			if (request.signal?.aborted) throw request.signal.reason;
+			if (timeoutSignal.aborted || isAbortError(error)) throw new require_errors.SzamlazzError(`A Számlázz.hu nem válaszolt ${timeoutMs} ms alatt.`, {
+				category: "timeout",
+				action: request.action,
+				cause: error
+			});
+			throw new require_errors.SzamlazzError("Hálózati hiba a Számlázz.hu elérésekor.", {
+				category: "network",
+				action: request.action,
+				cause: error
+			});
+		}
+		if (cookieStore) {
+			const merged = require_session.mergeSetCookies(cookie, response.headers);
+			if (merged) await ignoreStoreFailure(async () => cookieStore.set(await resolveSessionKey(), merged, require_session.SESSION_TTL_SECONDS));
+		}
+		return require_issue.createAgentResponse(request.action, response.status, response.headers, body);
+	}
+	async function resetSession() {
+		if (cookieStore) await ignoreStoreFailure(async () => cookieStore.delete(await resolveSessionKey()));
+	}
+	async function resetAttempts(key) {
+		if (ledger) await ledger.reset(key);
+	}
+	async function ledgerKeyFor(request) {
+		if (!ledger) return void 0;
+		return attemptLedgerKey({
+			action: request.action,
+			xml: request.xml,
+			attachments: (request.attachments ?? []).map((attachment) => ({
+				filename: attachment.filename,
+				size: attachmentSize(attachment)
+			}))
+		});
+	}
+	function assertNoCooldown(action) {
+		const remainingMs = blockedUntil - Date.now();
+		if (remainingMs > 0) throw maintenanceCooldownError(action, remainingMs);
+	}
+	async function execute(request, parse) {
+		const maxAttempts = request.safeToRetry ? safeAttempts : 1;
+		const ledgerKey = await ledgerKeyFor(request);
+		for (let attempt = 1;; attempt++) {
+			assertNoCooldown(request.action);
+			const failures = ledger && ledgerKey !== void 0 ? await ignoreStoreFailure(() => ledger.failures(ledgerKey)) ?? 0 : 0;
+			if (ledgerKey !== void 0 && failures >= 5) throw attemptLimitError(request.action, ledgerKey, failures);
+			const startedAt = Date.now();
+			callHook(hooks.onRequest, {
+				action: request.action,
+				attempt
+			});
+			try {
+				const response = await send(request);
+				callHook(hooks.onResponse, {
+					action: request.action,
+					attempt,
+					status: response.status,
+					durationMs: Date.now() - startedAt
+				});
+				const result = await parse(response);
+				if (ledger && ledgerKey !== void 0 && failures > 0) await ignoreStoreFailure(() => ledger.reset(ledgerKey));
+				return result;
+			} catch (error) {
+				if (!(error instanceof require_errors.SzamlazzError)) throw error;
+				if (ledger && ledgerKey !== void 0 && countsAsFailedAttempt(error)) await ignoreStoreFailure(() => ledger.recordFailure(ledgerKey, failures));
+				if (error.category === "maintenance" && cooldownMs > 0) blockedUntil = Date.now() + cooldownMs;
+				const willRetry = error.retryable && attempt < maxAttempts && !(error.category === "maintenance" && cooldownMs > 0);
+				callHook(hooks.onError, {
+					action: request.action,
+					attempt,
+					error,
+					willRetry
+				});
+				if (error.category === "auth") await resetSession();
+				if (!willRetry) throw error;
+				await sleep(retryDelayMs * 2 ** (attempt - 1), request.signal);
+			}
+		}
+	}
+	return {
+		credentials,
+		execute,
+		resetSession,
+		resetAttempts
+	};
+}
+//#endregion
+//#region src/invoices/create-response.ts
+function readRawResponse(response) {
+	require_issue.throwIfAnyError(response);
+	const headers = require_issue.readDocumentHeaders(response.headers);
+	const fromHeaders = {
+		number: headers.number,
+		netTotal: headers.netTotal,
+		grossTotal: headers.grossTotal,
+		outstanding: void 0,
+		buyerAccountUrl: headers.buyerAccountUrl,
+		pdf: void 0
+	};
+	if (response.isPdf) return {
+		...fromHeaders,
+		pdf: response.body
+	};
+	if (require_issue.looksLikeXml(response)) {
+		const root = require_issue.parseResponseXml(response);
+		require_issue.throwIfXmlFailure(root, response);
+		const pdfBase64 = require_issue.childText(root, "pdf");
+		return {
+			number: require_issue.childText(root, "szamlaszam") ?? headers.number,
+			netTotal: require_issue.childNumber(root, "szamlanetto") ?? headers.netTotal,
+			grossTotal: require_issue.childNumber(root, "szamlabrutto") ?? headers.grossTotal,
+			outstanding: require_issue.childNumber(root, "kintlevoseg"),
+			buyerAccountUrl: require_issue.childText(root, "vevoifiokurl") ?? headers.buyerAccountUrl,
+			pdf: pdfBase64 === void 0 ? void 0 : require_binary.base64ToBytes(pdfBase64)
+		};
+	}
+	const done = require_issue.parseDoneText(response.text());
+	if (done) return {
+		...fromHeaders,
+		number: done.number ?? headers.number
+	};
+	if (headers.number !== void 0) return fromHeaders;
+	throw require_issue.unexpectedResponse(response, "Számlaszámot vagy PDF-et vártunk.");
+}
+function totalsFor(raw, items) {
+	if (raw.netTotal !== void 0 && raw.grossTotal !== void 0) return {
+		netTotal: raw.netTotal,
+		grossTotal: raw.grossTotal
+	};
+	const computed = require_money.summarizeItems(items);
+	return {
+		netTotal: raw.netTotal ?? computed.netAmount,
+		grossTotal: raw.grossTotal ?? computed.grossAmount
+	};
+}
+function parseCreateInvoiceResponse(response, items = []) {
+	const raw = readRawResponse(response);
+	if (raw.number === void 0) throw require_issue.unexpectedResponse(response, "A sikeres válaszból hiányzik a számlaszám.");
+	return {
+		number: raw.number,
+		...totalsFor(raw, items),
+		outstanding: raw.outstanding,
+		buyerAccountUrl: raw.buyerAccountUrl,
+		pdf: raw.pdf,
+		items
+	};
+}
+function parseInvoicePreviewResponse(response, items = []) {
+	const raw = readRawResponse(response);
+	if (raw.pdf === void 0) throw require_issue.unexpectedResponse(response, "Az előnézeti válaszból hiányzik a PDF.");
+	return {
+		pdf: raw.pdf,
+		...totalsFor(raw, items),
+		items
+	};
+}
+//#endregion
+//#region src/invoices/create-xml.ts
+const INVOICE_XML_NAMESPACE = "http://www.szamlazz.hu/xmlszamla";
+const INVOICE_XML_SCHEMA_LOCATION = "https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd";
+const RESPONSE_VERSION_XML = 2;
+function textEl(name, value) {
+	return require_issue.optionalEl(name, require_create_once.presentText(value));
+}
+function settingsNode(credentials, invoice, preview) {
+	return require_issue.el("beallitasok", [
+		...credentials,
+		require_issue.el("eszamla", invoice.eInvoice),
+		require_issue.el("szamlaLetoltes", preview || invoice.downloadPdf),
+		require_issue.el("valaszVerzio", RESPONSE_VERSION_XML),
+		textEl("aggregator", invoice.aggregator),
+		require_issue.optionalEl("guardian", invoice.guardian),
+		require_issue.optionalEl("cikkazoninvoice", invoice.articleIdentifierInvoice),
+		textEl("szamlaKulsoAzon", invoice.input.externalId)
+	]);
+}
+function documentTypeNodes(invoice) {
+	const { input, type } = invoice;
+	return [
+		type === "advance" && require_issue.el("elolegszamla", true),
+		type === "final" && require_issue.el("vegszamla", true),
+		input.type === "final" && textEl("elolegSzamlaszam", input.advanceInvoiceNumber),
+		type === "corrective" && require_issue.el("helyesbitoszamla", true),
+		input.type === "corrective" && textEl("helyesbitettSzamlaszam", input.correctedInvoiceNumber),
+		type === "proforma" && require_issue.el("dijbekero", true),
+		type === "deliveryNote" && require_issue.el("szallitolevel", true)
+	];
+}
+function headerNode(invoice, preview) {
+	const { input } = invoice;
+	return require_issue.el("fejlec", [
+		require_issue.el("keltDatum", invoice.issueDate),
+		require_issue.el("teljesitesDatum", invoice.fulfillmentDate),
+		require_issue.el("fizetesiHataridoDatum", invoice.dueDate),
+		require_issue.el("fizmod", invoice.paymentMethod),
+		require_issue.el("penznem", invoice.currency),
+		require_issue.el("szamlaNyelve", invoice.language),
+		textEl("megjegyzes", input.comment),
+		textEl("arfolyamBank", invoice.exchangeBank),
+		require_issue.optionalEl("arfolyam", invoice.exchangeRate),
+		textEl("rendelesSzam", input.orderNumber),
+		textEl("dijbekeroSzamlaszam", input.proformaNumber),
+		...documentTypeNodes(invoice),
+		textEl("logoExtra", invoice.logoExtra),
+		textEl("szamlaszamElotag", invoice.prefix),
+		require_issue.optionalEl("fizetendoKorrekcio", input.paymentCorrection),
+		require_issue.optionalEl("fizetve", input.paid),
+		require_issue.optionalEl("arresAfa", input.marginVat),
+		require_issue.optionalEl("eusAfa", invoice.euVat),
+		require_issue.optionalEl("szamlaSablon", invoice.template),
+		preview && require_issue.el("elonezetpdf", true),
+		require_issue.optionalEl("simpleItems", invoice.simpleItems)
+	]);
+}
+function sellerNode(seller) {
+	return require_issue.el("elado", [
+		textEl("bank", seller.bank),
+		textEl("bankszamlaszam", seller.bankAccount),
+		textEl("emailReplyto", seller.emailReplyTo),
+		textEl("emailTargy", seller.emailSubject),
+		textEl("emailSzoveg", seller.emailText),
+		textEl("alairoNeve", seller.signatoryName)
+	]);
+}
+function buyerLedgerNode(ledger) {
+	if (!ledger) return void 0;
+	return require_issue.optionalEl("vevoFokonyv", [
+		require_issue.optionalEl("konyvelesDatum", require_create_once.optionalAgentDate(ledger.bookingDate, "buyer.ledger.bookingDate")),
+		textEl("vevoAzonosito", ledger.buyerId),
+		textEl("vevoFokonyviSzam", ledger.ledgerAccount),
+		require_issue.optionalEl("folyamatosTelj", ledger.continuousFulfillment),
+		require_issue.optionalEl("elszDatumTol", require_create_once.optionalAgentDate(ledger.settlementPeriodStart, "buyer.ledger.settlementPeriodStart")),
+		require_issue.optionalEl("elszDatumIg", require_create_once.optionalAgentDate(ledger.settlementPeriodEnd, "buyer.ledger.settlementPeriodEnd"))
+	]);
+}
+function buyerNode(buyer, sendEmail) {
+	const taxpayerType = buyer.taxpayerType;
+	return require_issue.el("vevo", [
+		require_issue.el("nev", buyer.name),
+		textEl("orszag", buyer.country),
+		require_issue.el("irsz", buyer.zip),
+		require_issue.el("telepules", buyer.city),
+		require_issue.el("cim", buyer.address),
+		textEl("email", buyer.email),
+		require_issue.el("sendEmail", sendEmail),
+		require_issue.optionalEl("adoalany", taxpayerType === void 0 ? void 0 : require_create_once.TAXPAYER_TYPE_CODES[taxpayerType]),
+		textEl("adoszam", buyer.taxNumber),
+		textEl("csoportazonosito", buyer.groupTaxNumber),
+		textEl("adoszamEU", buyer.euTaxNumber),
+		textEl("postazasiNev", buyer.postal?.name),
+		textEl("postazasiOrszag", buyer.postal?.country),
+		textEl("postazasiIrsz", buyer.postal?.zip),
+		textEl("postazasiTelepules", buyer.postal?.city),
+		textEl("postazasiCim", buyer.postal?.address),
+		buyerLedgerNode(buyer.ledger),
+		textEl("azonosito", buyer.identifier),
+		textEl("alairoNeve", buyer.signatoryName),
+		textEl("telefonszam", buyer.phone),
+		textEl("megjegyzes", buyer.comment)
+	]);
+}
+function waybillNode(waybill) {
+	if (!waybill) return void 0;
+	const { transOFlex: tof, pickPackPoint: ppp, sprinter, mpl } = waybill;
+	return require_issue.el("fuvarlevel", [
+		textEl("futarSzolgalat", waybill.courier),
+		textEl("vonalkod", waybill.barcode),
+		textEl("megjegyzes", waybill.comment),
+		tof && require_issue.el("tof", [
+			textEl("azonosito", tof.id),
+			textEl("shipmentID", tof.shipmentId),
+			require_issue.optionalEl("csomagszam", tof.packageCount),
+			textEl("countryCode", tof.countryCode),
+			textEl("zip", tof.zip),
+			textEl("service", tof.service)
+		]),
+		ppp && require_issue.el("ppp", [textEl("vonalkodPrefix", ppp.barcodePrefix), textEl("vonalkodPostfix", ppp.barcodePostfix)]),
+		sprinter && require_issue.el("sprinter", [
+			textEl("azonosito", sprinter.id),
+			textEl("feladokod", sprinter.senderCode),
+			textEl("iranykod", sprinter.directionCode),
+			require_issue.optionalEl("csomagszam", sprinter.packageCount),
+			textEl("vonalkodPostfix", sprinter.barcodePostfix),
+			textEl("szallitasiIdo", sprinter.deliveryTime)
+		]),
+		mpl && require_issue.el("mpl", [
+			require_issue.el("vevokod", mpl.customerCode),
+			require_issue.el("vonalkod", mpl.barcode),
+			require_issue.el("tomeg", String(mpl.weight)),
+			textEl("kulonszolgaltatasok", mpl.services),
+			require_issue.optionalEl("erteknyilvanitas", mpl.declaredValue)
+		])
+	]);
+}
+function itemLedgerNode(ledger, label) {
+	if (!ledger) return void 0;
+	return require_issue.optionalEl("tetelFokonyv", [
+		textEl("gazdasagiEsem", ledger.economicEvent),
+		textEl("gazdasagiEsemAfa", ledger.vatEconomicEvent),
+		textEl("arbevetelFokonyviSzam", ledger.revenueLedgerAccount),
+		textEl("afaFokonyviSzam", ledger.vatLedgerAccount),
+		require_issue.optionalEl("elszDatumTol", require_create_once.optionalAgentDate(ledger.settlementPeriodStart, `${label} settlementPeriodStart`)),
+		require_issue.optionalEl("elszDatumIg", require_create_once.optionalAgentDate(ledger.settlementPeriodEnd, `${label} settlementPeriodEnd`))
+	]);
+}
+function itemNode(item, index) {
+	const { input, amounts } = item;
+	return require_issue.el("tetel", [
+		require_issue.el("megnevezes", input.name),
+		textEl("azonosito", input.identifier),
+		require_issue.el("mennyiseg", amounts.quantity),
+		require_issue.el("mennyisegiEgyseg", item.unit),
+		require_issue.el("nettoEgysegar", amounts.netUnitPrice),
+		require_issue.el("afakulcs", require_vat.formatVatRate(amounts.vat)),
+		require_issue.optionalEl("arresAfaAlap", input.marginVatBase),
+		require_issue.el("nettoErtek", amounts.netAmount),
+		require_issue.el("afaErtek", amounts.vatAmount),
+		require_issue.el("bruttoErtek", amounts.grossAmount),
+		textEl("megjegyzes", input.comment),
+		itemLedgerNode(input.ledger, `${index + 1}. tétel ledger`),
+		require_issue.optionalEl("torloKod", input.dataDeletionCode)
+	]);
+}
+function renderInvoiceXml(credentials, invoice, options = {}) {
+	const preview = options.preview === true;
+	return require_issue.buildXmlDocument({
+		root: "xmlszamla",
+		namespace: INVOICE_XML_NAMESPACE,
+		schemaLocation: INVOICE_XML_SCHEMA_LOCATION,
+		children: [
+			settingsNode(credentials, invoice, preview),
+			headerNode(invoice, preview),
+			sellerNode(invoice.seller),
+			buyerNode(invoice.input.buyer, invoice.sendEmail),
+			waybillNode(invoice.input.waybill),
+			require_issue.el("tetelek", invoice.items.map(itemNode))
+		]
+	});
+}
+//#endregion
+//#region src/invoices/create.ts
+function buildRequest(ctx, invoice, preview, options) {
+	const xml = renderInvoiceXml(ctx.credentials, invoice, { preview });
+	const attachments = preview ? [] : invoice.attachments;
+	return {
+		action: "createInvoice",
+		xml,
+		signal: options.signal,
+		...attachments.length > 0 ? { attachments } : {}
+	};
+}
+function itemsOf(invoice) {
+	return invoice.items.map((item) => item.amounts);
+}
+async function createInvoice(ctx, defaults, input, options = {}) {
+	const invoice = require_create_once.resolveInvoice(defaults, input, /* @__PURE__ */ new Date());
+	const items = itemsOf(invoice);
+	return ctx.execute(buildRequest(ctx, invoice, false, options), (response) => parseCreateInvoiceResponse(response, items));
+}
+async function previewInvoice(ctx, defaults, input, options = {}) {
+	const invoice = require_create_once.resolveInvoice(defaults, input, /* @__PURE__ */ new Date());
+	const items = itemsOf(invoice);
+	return ctx.execute(buildRequest(ctx, invoice, true, options), (response) => parseInvoicePreviewResponse(response, items));
+}
+//#endregion
+//#region src/invoices/reference.ts
+const AGENT_XSD_BASE_URL = "https://www.szamlazz.hu/szamla/docs/xsds/";
+function validationError(message) {
+	return new require_errors.SzamlazzError(message, { category: "validation" });
+}
+function requireText(value, message) {
+	const trimmed = typeof value === "string" ? value.trim() : "";
+	if (trimmed === "") throw validationError(message);
+	return trimmed;
+}
+function optionalText(value) {
+	const trimmed = value?.trim();
+	return trimmed ? trimmed : void 0;
+}
+function agentDate(input, field) {
+	try {
+		return require_dates.toAgentDate(input);
+	} catch (error) {
+		const detail = error instanceof Error ? error.message : String(error);
+		throw new require_errors.SzamlazzError(`Érvénytelen dátum (${field}): ${detail}`, {
+			category: "validation",
+			cause: error
+		});
+	}
+}
+function optionalAgentDate(input, field) {
+	return input === void 0 ? void 0 : agentDate(input, field);
+}
+const REFERENCE_KEYS = [
+	"invoiceNumber",
+	"orderNumber",
+	"externalId"
+];
+const REFERENCE_HINT$1 = "Add meg a számlaszámot szövegként, vagy pontosan egyet ezek közül: { invoiceNumber }, { orderNumber }, { externalId }.";
+function resolveInvoiceReference(reference) {
+	if (typeof reference === "string") return {
+		kind: "invoiceNumber",
+		value: requireText(reference, `Üres számlaszám. ${REFERENCE_HINT$1}`)
+	};
+	if (typeof reference !== "object" || reference === null) throw validationError(`Érvénytelen bizonylat-hivatkozás. ${REFERENCE_HINT$1}`);
+	const record = reference;
+	const present = REFERENCE_KEYS.filter((key) => record[key] !== void 0);
+	const [kind] = present;
+	if (kind === void 0 || present.length > 1) throw validationError(`Érvénytelen bizonylat-hivatkozás. ${REFERENCE_HINT$1}`);
+	return {
+		kind,
+		value: requireText(record[kind], `Üres ${kind} érték. ${REFERENCE_HINT$1}`)
+	};
+}
+function referenceValue(reference, kind) {
+	return reference.kind === kind ? reference.value : void 0;
+}
+function readNumericHeader(headers, name) {
+	const value = require_issue.readHeader(headers, name);
+	if (value === void 0) return void 0;
+	const parsed = Number(value.replace(",", "."));
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function headerSummary(response) {
+	const headers = require_issue.readDocumentHeaders(response.headers);
+	return {
+		number: headers.number,
+		netTotal: headers.netTotal,
+		grossTotal: headers.grossTotal,
+		outstanding: readNumericHeader(response.headers, "szlahu_kintlevoseg"),
+		buyerAccountUrl: headers.buyerAccountUrl
+	};
+}
+function decodeResponsePdf(root, response) {
+	const encoded = require_issue.childText(root, "pdf");
+	if (encoded === void 0) return void 0;
+	try {
+		return require_binary.base64ToBytes(encoded);
+	} catch (error) {
+		throw new require_errors.SzamlazzError("A válaszban kapott PDF nem érvényes base64.", {
+			category: "unexpected_response",
+			action: response.action,
+			httpStatus: response.status,
+			cause: error
+		});
+	}
+}
+function readInvoiceResultXml(root, response) {
+	const headers = headerSummary(response);
+	return {
+		number: require_issue.childText(root, "szamlaszam") ?? headers.number,
+		netTotal: require_issue.childNumber(root, "szamlanetto") ?? headers.netTotal,
+		grossTotal: require_issue.childNumber(root, "szamlabrutto") ?? headers.grossTotal,
+		outstanding: require_issue.childNumber(root, "kintlevoseg") ?? headers.outstanding,
+		buyerAccountUrl: require_issue.childText(root, "vevoifiokurl") ?? headers.buyerAccountUrl,
+		pdf: decodeResponsePdf(root, response)
+	};
+}
+const INVOICE_RESULT_ROOT = "xmlszamlavalasz";
+function parseInvoiceResult(response) {
+	require_issue.throwIfHeaderError(response);
+	if (response.isPdf) return {
+		...headerSummary(response),
+		pdf: response.body
+	};
+	require_issue.throwIfTextError(response);
+	require_issue.throwIfHttpError(response);
+	if (require_issue.looksLikeXml(response)) {
+		const root = require_issue.parseResponseXml(response);
+		require_issue.throwIfXmlFailure(root, response);
+		if (root.name !== INVOICE_RESULT_ROOT || require_issue.childText(root, "sikeres")?.toLowerCase() !== "true") throw require_issue.unexpectedResponse(response, `${INVOICE_RESULT_ROOT} XML választ vártunk.`);
+		return readInvoiceResultXml(root, response);
+	}
+	const headers = headerSummary(response);
+	const done = require_issue.parseDoneText(response.text());
+	if (done) return {
+		...headers,
+		number: done.number ?? headers.number
+	};
+	if (headers.number !== void 0) return headers;
+	throw require_issue.unexpectedResponse(response);
+}
+//#endregion
+//#region src/invoices/get.ts
+const INVOICE_DOCUMENT_TYPE_CODES = {
+	invoice: "SZ",
+	proforma: "D",
+	advance: "ES",
+	final: "VS",
+	corrective: "HS",
+	reversal: "SS",
+	deliveryNote: "SL"
+};
+function buildGetInvoiceXml(credentials, reference, query = {}) {
+	const resolved = resolveInvoiceReference(reference);
+	return require_issue.buildXmlDocument({
+		root: "xmlszamlaxml",
+		namespace: "http://www.szamlazz.hu/xmlszamlaxml",
+		schemaLocation: `${AGENT_XSD_BASE_URL}agentxml/xmlszamlaxml.xsd`,
+		children: [
+			...credentials,
+			require_issue.optionalEl("szamlaszam", referenceValue(resolved, "invoiceNumber")),
+			require_issue.optionalEl("rendelesSzam", referenceValue(resolved, "orderNumber")),
+			require_issue.optionalEl("pdf", query.includePdf),
+			require_issue.optionalEl("szamlaKulsoAzon", referenceValue(resolved, "externalId"))
+		]
+	});
+}
+var InvoiceReader = class {
+	response;
+	constructor(response) {
+		this.response = response;
+	}
+	missing(path) {
+		return require_issue.unexpectedResponse(this.response, `Hiányzik a(z) <${path}> elem a számla XML-ből.`);
+	}
+	element(parent, name, path) {
+		const child = require_issue.findChild(parent, name);
+		if (!child) throw this.missing(path);
+		return child;
+	}
+	text(parent, name, path) {
+		const value = require_issue.childText(parent, name);
+		if (value === void 0) throw this.missing(`${path}/${name}`);
+		return value;
+	}
+	number(parent, name, path) {
+		const value = require_issue.childNumber(parent, name);
+		if (value === void 0) throw this.missing(`${path}/${name}`);
+		return value;
+	}
+};
+function readAddress(element) {
+	if (!element) return void 0;
+	return {
+		name: require_issue.childText(element, "nev"),
+		country: require_issue.childText(element, "orszag"),
+		zip: require_issue.childText(element, "irsz"),
+		city: require_issue.childText(element, "telepules"),
+		address: require_issue.childText(element, "cim")
+	};
+}
+function readSeller(root, reader) {
+	const seller = reader.element(root, "szallito", "szallito");
+	const bank = require_issue.findChild(seller, "bank");
+	return {
+		id: require_issue.childNumber(seller, "id"),
+		name: reader.text(seller, "nev", "szallito"),
+		address: readAddress(require_issue.findChild(seller, "cim")),
+		postalAddress: readAddress(require_issue.findChild(seller, "postacim")),
+		taxNumber: require_issue.childText(seller, "adoszam"),
+		groupTaxNumber: require_issue.childText(seller, "csoportazonosito"),
+		euTaxNumber: require_issue.childText(seller, "adoszameu"),
+		bank: bank && {
+			name: require_issue.childText(bank, "nev"),
+			accountNumber: require_issue.childText(bank, "bankszamla")
+		}
+	};
+}
+const DOCUMENT_TYPES_BY_CODE = new Map(Object.entries(INVOICE_DOCUMENT_TYPE_CODES).map(([type, code]) => [code, type]));
+const E_INVOICE_CODES = /* @__PURE__ */ new Set([2, 3]);
+function readHeader(root, reader) {
+	const header = reader.element(root, "alap", "alap");
+	const typeCode = reader.text(header, "tipus", "alap");
+	const appearanceCode = require_issue.childNumber(header, "eszamla");
+	return {
+		id: require_issue.childNumber(header, "id"),
+		number: reader.text(header, "szamlaszam", "alap"),
+		economicEventId: require_issue.childNumber(header, "gazdEsemAzon"),
+		sourceSystem: require_issue.childNumber(header, "forras"),
+		registrationNumber: require_issue.childText(header, "iktatoszam"),
+		type: DOCUMENT_TYPES_BY_CODE.get(typeCode) ?? "unknown",
+		typeCode,
+		eInvoice: appearanceCode !== void 0 && E_INVOICE_CODES.has(appearanceCode),
+		appearanceCode,
+		referencedInvoiceNumber: require_issue.childText(header, "hivszamlaszam"),
+		referencedProformaNumber: require_issue.childText(header, "hivdijbekszam"),
+		issueDate: reader.text(header, "kelt", "alap"),
+		fulfillmentDate: require_issue.childText(header, "telj"),
+		dueDate: require_issue.childText(header, "fizh"),
+		paymentMethod: require_issue.childText(header, "fizmod"),
+		unifiedPaymentMethod: require_issue.childText(header, "fizmodunified"),
+		cash: require_issue.childBoolean(header, "keszpenz"),
+		orderNumber: require_issue.childText(header, "rendelesszam"),
+		language: require_issue.childText(header, "nyelv"),
+		currency: require_issue.childText(header, "devizanem"),
+		exchangeBank: require_issue.childText(header, "devizabank"),
+		exchangeRate: require_issue.childNumber(header, "devizaarf"),
+		comment: require_issue.childText(header, "megjegyzes"),
+		vatType: require_issue.childText(header, "afatipus"),
+		cashAccounting: require_issue.childBoolean(header, "penzforg"),
+		kata: require_issue.childBoolean(header, "kata"),
+		kataLedger: require_issue.childBoolean(header, "katafokonyv"),
+		email: require_issue.childText(header, "email"),
+		test: require_issue.childBoolean(header, "teszt"),
+		reversed: require_issue.childBoolean(header, "sztornozott")
+	};
+}
+function readBuyerLedger(element) {
+	if (!element) return void 0;
+	return {
+		ledgerAccount: require_issue.childText(element, "vevo"),
+		buyerId: require_issue.childText(element, "vevoazon"),
+		bookingDate: require_issue.childText(element, "datum"),
+		continuousFulfillment: require_issue.childBoolean(element, "folyamatostelj"),
+		settlementPeriodStart: require_issue.childText(element, "elszDatTol") ?? require_issue.childText(element, "elszdattol"),
+		settlementPeriodEnd: require_issue.childText(element, "elszDatIg") ?? require_issue.childText(element, "elszdatig")
+	};
+}
+function readBuyer(root, reader) {
+	const buyer = reader.element(root, "vevo", "vevo");
+	return {
+		id: require_issue.childNumber(buyer, "id"),
+		name: reader.text(buyer, "nev", "vevo"),
+		identifier: require_issue.childText(buyer, "azonosito"),
+		address: readAddress(require_issue.findChild(buyer, "cim")),
+		postalAddress: readAddress(require_issue.findChild(buyer, "postacim")),
+		email: require_issue.childText(buyer, "email"),
+		taxNumber: require_issue.childText(buyer, "adoszam"),
+		groupTaxNumber: require_issue.childText(buyer, "csoportazonosito"),
+		euTaxNumber: require_issue.childText(buyer, "adoszameu"),
+		location: require_issue.childNumber(buyer, "lokacio"),
+		privatePerson: require_issue.childBoolean(buyer, "privatePersonIndicator"),
+		ledger: readBuyerLedger(require_issue.findChild(buyer, "fokonyv"))
+	};
+}
+function readItemLedger(element) {
+	if (!element) return void 0;
+	return {
+		revenueLedgerAccount: require_issue.childText(element, "arbevetel"),
+		vatLedgerAccount: require_issue.childText(element, "afa"),
+		economicEvent: require_issue.childText(element, "gazdasagiesemeny"),
+		vatEconomicEvent: require_issue.childText(element, "gazdasagiesemenyafa"),
+		settlementPeriodStart: require_issue.childText(element, "elszdattol"),
+		settlementPeriodEnd: require_issue.childText(element, "elszdatig")
+	};
+}
+function readItem(item, reader) {
+	const path = "tetelek/tetel";
+	return {
+		name: reader.text(item, "nev", path),
+		identifier: require_issue.childText(item, "azonosito"),
+		quantity: reader.number(item, "mennyiseg", path),
+		unit: require_issue.childText(item, "mennyisegiegyseg"),
+		netUnitPrice: reader.number(item, "nettoegysegar", path),
+		vat: reader.number(item, "afakulcs", path),
+		vatCode: require_issue.childText(item, "afatipus"),
+		netAmount: reader.number(item, "netto", path),
+		marginVatBase: require_issue.childNumber(item, "arresafaalap"),
+		vatAmount: reader.number(item, "afa", path),
+		grossAmount: reader.number(item, "brutto", path),
+		comment: require_issue.childText(item, "megjegyzes"),
+		position: require_issue.childNumber(item, "sztetordering"),
+		ledger: readItemLedger(require_issue.findChild(item, "fokonyv"))
+	};
+}
+function readLabels(element) {
+	return require_issue.findChildren(element, "cimke").flatMap((label) => {
+		const value = label.text.trim();
+		return value === "" ? [] : [value];
+	});
+}
+function readFinancialItem(item, reader) {
+	const path = "qutetek/qutet";
+	return {
+		name: reader.text(item, "nev", path),
+		vat: reader.number(item, "afakulcs", path),
+		vatCode: require_issue.childText(item, "afatipus"),
+		netAmount: reader.number(item, "netto", path),
+		vatAmount: reader.number(item, "afa", path),
+		grossAmount: reader.number(item, "brutto", path),
+		settlementPeriodStart: require_issue.childText(item, "elszdattol"),
+		settlementPeriodEnd: require_issue.childText(item, "elszdatig"),
+		vatDeduction: require_issue.childNumber(item, "afalevon"),
+		labels: readLabels(require_issue.findChild(item, "cimkek"))
+	};
+}
+function readTotals(root, reader) {
+	const totals = reader.element(root, "osszegek", "osszegek");
+	const total = reader.element(totals, "totalossz", "osszegek/totalossz");
+	const path = "osszegek/totalossz";
+	return {
+		netAmount: reader.number(total, "netto", path),
+		vatAmount: reader.number(total, "afa", path),
+		grossAmount: reader.number(total, "brutto", path),
+		byVat: require_issue.findChildren(totals, "afakulcsossz").map((entry) => ({
+			vat: reader.number(entry, "afakulcs", "osszegek/afakulcsossz"),
+			vatCode: require_issue.childText(entry, "afatipus"),
+			netAmount: reader.number(entry, "netto", "osszegek/afakulcsossz"),
+			vatAmount: reader.number(entry, "afa", "osszegek/afakulcsossz"),
+			grossAmount: reader.number(entry, "brutto", "osszegek/afakulcsossz")
+		}))
+	};
+}
+function readPayment(payment, reader) {
+	const path = "kifizetesek/kifizetes";
+	return {
+		date: reader.text(payment, "datum", path),
+		method: reader.text(payment, "jogcim", path),
+		amount: reader.number(payment, "osszeg", path),
+		comment: require_issue.childText(payment, "megjegyzes"),
+		bankAccountNumber: require_issue.childText(payment, "bankszamlaszam"),
+		bankTransactionId: require_issue.childNumber(payment, "banktranzid"),
+		exchangeRate: require_issue.childNumber(payment, "devizaarf")
+	};
+}
+function parseInvoiceDetailsXml(root, response) {
+	const reader = new InvoiceReader(response);
+	return {
+		seller: readSeller(root, reader),
+		header: readHeader(root, reader),
+		buyer: readBuyer(root, reader),
+		items: require_issue.findChildren(require_issue.findChild(root, "tetelek"), "tetel").map((item) => readItem(item, reader)),
+		financialItems: require_issue.findChildren(require_issue.findChild(root, "qutetek"), "qutet").map((item) => readFinancialItem(item, reader)),
+		labels: readLabels(require_issue.findChild(root, "cimkek")),
+		totals: readTotals(root, reader),
+		payments: require_issue.findChildren(require_issue.findChild(root, "kifizetesek"), "kifizetes").map((payment) => readPayment(payment, reader)),
+		pdf: decodeResponsePdf(root, response)
+	};
+}
+function parseGetInvoiceResponse(response) {
+	require_issue.throwIfHeaderError(response);
+	require_issue.throwIfTextError(response);
+	require_issue.throwIfHttpError(response);
+	const root = require_issue.parseResponseXml(response);
+	require_issue.throwIfXmlFailure(root, response);
+	if (root.name !== "szamla") throw require_issue.unexpectedResponse(response, "A számla XML (<szamla>) helyett más válasz érkezett.");
+	return parseInvoiceDetailsXml(root, response);
+}
+async function getInvoice(ctx, reference, query = {}, options = {}) {
+	const xml = buildGetInvoiceXml(ctx.credentials, reference, query);
+	return ctx.execute({
+		action: "getInvoiceXml",
+		xml,
+		signal: options.signal,
+		safeToRetry: true
+	}, parseGetInvoiceResponse);
+}
+function normalizeRegisterInput(input) {
+	const payments = "payments" in input ? input.payments : [{
+		amount: input.amount,
+		method: input.method ?? "átutalás",
+		date: input.date,
+		description: input.description
+	}];
+	if (!Array.isArray(payments) || payments.length === 0) throw validationError("Adj meg legalább egy befizetést (payments). A korábbi befizetések törléséhez a clearPayments függvényt használd.");
+	if (payments.length > 5) throw validationError(`Egy kérésben legfeljebb 5 befizetés rögzíthető, kapott: ${payments.length}.`);
+	return {
+		invoiceNumber: input.invoiceNumber,
+		taxNumber: input.taxNumber,
+		additive: input.additive ?? true,
+		payments
+	};
+}
+function normalizeClearInput(input) {
+	const target = typeof input === "string" ? { invoiceNumber: input } : input;
+	return {
+		invoiceNumber: target.invoiceNumber,
+		taxNumber: target.taxNumber,
+		additive: false,
+		payments: []
+	};
+}
+function paymentNode(payment, index) {
+	const position = index + 1;
+	if (typeof payment.amount !== "number" || !Number.isFinite(payment.amount)) throw validationError(`A(z) ${position}. befizetés összege (amount) nem véges szám.`);
+	return require_issue.el("kifizetes", [
+		require_issue.el("datum", payment.date === void 0 ? require_dates.todayInBudapest() : agentDate(payment.date, "date")),
+		require_issue.el("jogcim", requireText(payment.method, `Add meg a(z) ${position}. befizetés módját (method).`)),
+		require_issue.el("osszeg", payment.amount),
+		require_issue.optionalEl("leiras", optionalText(payment.description))
+	]);
+}
+function buildPaymentXml(credentials, request) {
+	const invoiceNumber = requireText(request.invoiceNumber, "Add meg a számla számát (invoiceNumber), amelyhez a befizetés tartozik.");
+	return require_issue.buildXmlDocument({
+		root: "xmlszamlakifiz",
+		namespace: "http://www.szamlazz.hu/xmlszamlakifiz",
+		schemaLocation: `${AGENT_XSD_BASE_URL}agentkifiz/xmlszamlakifiz.xsd`,
+		children: [require_issue.el("beallitasok", [
+			...credentials,
+			require_issue.el("szamlaszam", invoiceNumber),
+			require_issue.optionalEl("adoszam", optionalText(request.taxNumber)),
+			require_issue.el("additiv", request.additive),
+			require_issue.el("valaszVerzio", 2)
+		]), ...request.payments.map(paymentNode)]
+	});
+}
+function parseRegisterPaymentResponse(response, invoiceNumber) {
+	const result = parseInvoiceResult(response);
+	return {
+		invoiceNumber: result.number ?? invoiceNumber.trim(),
+		netTotal: result.netTotal,
+		grossTotal: result.grossTotal,
+		outstanding: result.outstanding,
+		buyerAccountUrl: result.buyerAccountUrl
+	};
+}
+function sendPaymentRequest(ctx, request, options) {
+	const xml = buildPaymentXml(ctx.credentials, request);
+	return ctx.execute({
+		action: "registerPayment",
+		xml,
+		signal: options.signal,
+		safeToRetry: !request.additive
+	}, (response) => parseRegisterPaymentResponse(response, request.invoiceNumber));
+}
+async function registerPayment(ctx, input, options = {}) {
+	return sendPaymentRequest(ctx, normalizeRegisterInput(input), options);
+}
+async function clearPayments(ctx, input, options = {}) {
+	return sendPaymentRequest(ctx, normalizeClearInput(input), options);
+}
+//#endregion
+//#region src/invoices/pdf.ts
+function buildInvoicePdfXml(credentials, reference) {
+	const resolved = resolveInvoiceReference(reference);
+	return require_issue.buildXmlDocument({
+		root: "xmlszamlapdf",
+		namespace: "http://www.szamlazz.hu/xmlszamlapdf",
+		schemaLocation: `${AGENT_XSD_BASE_URL}agentpdf/xmlszamlapdf.xsd`,
+		children: [
+			...credentials,
+			require_issue.optionalEl("szamlaszam", referenceValue(resolved, "invoiceNumber")),
+			require_issue.optionalEl("rendelesSzam", referenceValue(resolved, "orderNumber")),
+			require_issue.el("valaszVerzio", 2),
+			require_issue.optionalEl("szamlaKulsoAzon", referenceValue(resolved, "externalId"))
+		]
+	});
+}
+function parseInvoicePdfResponse(response) {
+	const { pdf, ...rest } = parseInvoiceResult(response);
+	if (pdf === void 0 || pdf.length === 0) throw require_issue.unexpectedResponse(response, "A válasz nem tartalmaz PDF-et.");
+	return {
+		...rest,
+		pdf
+	};
+}
+async function getInvoicePdf(ctx, reference, options = {}) {
+	const xml = buildInvoicePdfXml(ctx.credentials, reference);
+	return ctx.execute({
+		action: "getInvoicePdf",
+		xml,
+		signal: options.signal,
+		safeToRetry: true
+	}, parseInvoicePdfResponse);
+}
+const RESPONSE_ROOTS = /* @__PURE__ */ new Set(["xmlszamladbkdelvalasz", "xmlszamlavalasz"]);
+const REFERENCE_HINT = "Add meg a díjbekérő számát szövegként, vagy pontosan egyet ezek közül: { proformaNumber }, { orderNumber }.";
+function resolveProformaReference(reference) {
+	if (typeof reference === "string") return { proformaNumber: requireText(reference, `Üres díjbekérőszám. ${REFERENCE_HINT}`) };
+	if (typeof reference !== "object" || reference === null) throw validationError(`Érvénytelen díjbekérő-hivatkozás. ${REFERENCE_HINT}`);
+	const record = reference;
+	const hasNumber = record.proformaNumber !== void 0;
+	if (hasNumber === (record.orderNumber !== void 0)) throw validationError(`Érvénytelen díjbekérő-hivatkozás. ${REFERENCE_HINT}`);
+	return hasNumber ? { proformaNumber: requireText(record.proformaNumber, `Üres proformaNumber. ${REFERENCE_HINT}`) } : { orderNumber: requireText(record.orderNumber, `Üres orderNumber. ${REFERENCE_HINT}`) };
+}
+function buildDeleteProformaXml(credentials, reference) {
+	const resolved = resolveProformaReference(reference);
+	return require_issue.buildXmlDocument({
+		root: "xmlszamladbkdel",
+		namespace: "http://www.szamlazz.hu/xmlszamladbkdel",
+		schemaLocation: "http://www.szamlazz.hu/docs/xsds/szamladbkdel/xmlszamladbkdel.xsd",
+		children: [require_issue.el("beallitasok", [...credentials]), require_issue.el("fejlec", [require_issue.optionalEl("szamlaszam", resolved.proformaNumber), require_issue.optionalEl("rendelesszam", resolved.orderNumber)])]
+	});
+}
+function withProformaCategory(error) {
+	if (!(error instanceof require_errors.SzamlazzError) || error.code !== 335) return error;
+	return new require_errors.SzamlazzError(error.message, {
+		category: "not_found",
+		code: error.code,
+		hint: "A díjbekérő nem létezik, vagy már törölték.",
+		action: error.action,
+		httpStatus: error.httpStatus,
+		rawResponse: error.rawResponse,
+		cause: error
+	});
+}
+function parseDeleteProformaResponse(response) {
+	try {
+		require_issue.throwIfHeaderError(response);
+		require_issue.throwIfTextError(response);
+		require_issue.throwIfHttpError(response);
+		const root = require_issue.parseResponseXml(response);
+		require_issue.throwIfXmlFailure(root, response);
+		if (!RESPONSE_ROOTS.has(root.name) || require_issue.childText(root, "sikeres")?.toLowerCase() !== "true") throw require_issue.unexpectedResponse(response, "xmlszamladbkdelvalasz XML választ vártunk.");
+	} catch (error) {
+		throw withProformaCategory(error);
+	}
+}
+async function deleteProforma(ctx, reference, options = {}) {
+	const xml = buildDeleteProformaXml(ctx.credentials, reference);
+	await ctx.execute({
+		action: "deleteProforma",
+		xml,
+		signal: options.signal
+	}, parseDeleteProformaResponse);
+}
+const templates = new Set(require_create_once.INVOICE_TEMPLATES);
+function normalizeInput$2(input) {
+	return typeof input === "string" ? { invoiceNumber: input } : input;
+}
+function validateTemplate(template) {
+	if (template === void 0 || templates.has(template)) return template;
+	throw validationError(`Ismeretlen számlasablon: ${String(template)}. Lehetséges értékek: ${require_create_once.INVOICE_TEMPLATES.join(", ")}.`);
+}
+function buildReverseInvoiceXml(credentials, input) {
+	const options = normalizeInput$2(input);
+	const invoiceNumber = requireText(options.invoiceNumber, "Add meg a sztornózandó számla számát (invoiceNumber).");
+	const email = options.email;
+	const buyer = options.buyer;
+	return require_issue.buildXmlDocument({
+		root: "xmlszamlast",
+		namespace: "http://www.szamlazz.hu/xmlszamlast",
+		schemaLocation: `${AGENT_XSD_BASE_URL}agentst/xmlszamlast.xsd`,
+		children: [
+			require_issue.el("beallitasok", [
+				...credentials,
+				require_issue.el("eszamla", options.eInvoice ?? false),
+				require_issue.el("szamlaLetoltes", options.downloadPdf ?? true),
+				require_issue.el("valaszVerzio", 2),
+				require_issue.optionalEl("szamlaKulsoAzon", optionalText(options.externalId))
+			]),
+			require_issue.el("fejlec", [
+				require_issue.el("szamlaszam", invoiceNumber),
+				require_issue.optionalEl("keltDatum", optionalAgentDate(options.issueDate, "issueDate")),
+				require_issue.optionalEl("teljesitesDatum", optionalAgentDate(options.fulfillmentDate, "fulfillmentDate")),
+				require_issue.optionalEl("megjegyzes", optionalText(options.comment)),
+				require_issue.el("tipus", "SS"),
+				require_issue.optionalEl("szamlaSablon", validateTemplate(options.template))
+			]),
+			require_issue.optionalEl("elado", [
+				require_issue.optionalEl("emailReplyto", optionalText(email?.replyTo)),
+				require_issue.optionalEl("emailTargy", optionalText(email?.subject)),
+				require_issue.optionalEl("emailSzoveg", optionalText(email?.text))
+			]),
+			require_issue.optionalEl("vevo", [
+				require_issue.optionalEl("email", optionalText(buyer?.email)),
+				require_issue.optionalEl("adoszam", optionalText(buyer?.taxNumber)),
+				require_issue.optionalEl("adoszamEU", optionalText(buyer?.euTaxNumber))
+			])
+		]
+	});
+}
+function parseReverseInvoiceResponse(response, originalInvoiceNumber) {
+	const result = parseInvoiceResult(response);
+	if (result.number === void 0) throw require_issue.unexpectedResponse(response, "A válaszban nincs sztornó számlaszám.");
+	if (originalInvoiceNumber !== void 0 && result.number === originalInvoiceNumber.trim()) throw new require_errors.SzamlazzError(`A(z) ${result.number} bizonylat nem lett sztornózva: a Számlázz.hu az eredeti bizonylatot adta vissza.`, {
+		category: "validation",
+		action: response.action,
+		httpStatus: response.status,
+		hint: "Díjbekérő és szállítólevél nem sztornózható. Díjbekérőt a deleteProforma függvénnyel törölhetsz."
+	});
+	return {
+		...result,
+		number: result.number
+	};
+}
+async function reverseInvoice(ctx, input, options = {}) {
+	const invoiceNumber = normalizeInput$2(input).invoiceNumber;
+	const xml = buildReverseInvoiceXml(ctx.credentials, input);
+	return ctx.execute({
+		action: "reverseInvoice",
+		xml,
+		signal: options.signal
+	}, (response) => parseReverseInvoiceResponse(response, invoiceNumber));
+}
+//#endregion
+//#region src/receipts/get.ts
+const GET_RECEIPT_NAMESPACE = "http://www.szamlazz.hu/xmlnyugtaget";
+function normalizeInput$1(input) {
+	return typeof input === "string" ? { receiptNumber: input } : input;
+}
+function resolveIdentifier(input) {
+	const receiptNumber = require_issue.optionalText(input.receiptNumber);
+	const orderNumber = require_issue.optionalText(input.orderNumber);
+	if (receiptNumber === void 0 && orderNumber === void 0) throw require_issue.receiptValidationError("A nyugta lekérdezéséhez add meg a nyugtaszámot (receiptNumber) vagy a rendelésszámot (orderNumber).");
+	if (receiptNumber !== void 0 && orderNumber !== void 0) throw require_issue.receiptValidationError("A nyugta lekérdezéséhez a nyugtaszám (receiptNumber) és a rendelésszám (orderNumber) közül csak az egyiket add meg.");
+	return {
+		receiptNumber,
+		orderNumber
+	};
+}
+function buildGetReceiptXml(credentials, input) {
+	const normalized = normalizeInput$1(input);
+	const { receiptNumber, orderNumber } = resolveIdentifier(normalized);
+	return require_issue.buildXmlDocument({
+		root: "xmlnyugtaget",
+		namespace: GET_RECEIPT_NAMESPACE,
+		schemaLocation: `${require_issue.RECEIPT_XSD_BASE_URL}nyugtaget/xmlnyugtaget.xsd`,
+		children: [require_issue.el("beallitasok", [...credentials, require_issue.el("pdfLetoltes", normalized.downloadPdf ?? true)]), require_issue.el("fejlec", [
+			require_issue.optionalEl("nyugtaszam", receiptNumber),
+			require_issue.optionalEl("rendelesSzam", orderNumber),
+			require_issue.optionalEl("hivasAzonosito", require_issue.optionalText(normalized.callId)),
+			require_issue.optionalEl("pdfSablon", require_issue.validateTemplate(normalized.template))
+		])]
+	});
+}
+function getReceipt(ctx, input, options = {}) {
+	const xml = buildGetReceiptXml(ctx.credentials, input);
+	return ctx.execute({
+		action: "getReceipt",
+		xml,
+		signal: options.signal,
+		safeToRetry: true
+	}, require_issue.parseReceiptResponse);
+}
+//#endregion
+//#region src/receipts/reverse.ts
+const REVERSE_RECEIPT_NAMESPACE = "http://www.szamlazz.hu/xmlnyugtast";
+function normalizeInput(input) {
+	return typeof input === "string" ? { receiptNumber: input } : input;
+}
+function buildReverseReceiptXml(credentials, input) {
+	const normalized = normalizeInput(input);
+	return require_issue.buildXmlDocument({
+		root: "xmlnyugtast",
+		namespace: REVERSE_RECEIPT_NAMESPACE,
+		schemaLocation: `${require_issue.RECEIPT_XSD_BASE_URL}nyugtast/xmlnyugtast.xsd`,
+		children: [require_issue.el("beallitasok", [...credentials, require_issue.el("pdfLetoltes", normalized.downloadPdf ?? true)]), require_issue.el("fejlec", [
+			require_issue.el("nyugtaszam", require_issue.requireReceiptNumber(normalized.receiptNumber)),
+			require_issue.optionalEl("pdfSablon", require_issue.validateTemplate(normalized.template)),
+			require_issue.optionalEl("hivasAzonosito", require_issue.optionalText(normalized.callId))
+		])]
+	});
+}
+function reverseReceipt(ctx, input, options = {}) {
+	const normalized = normalizeInput(input);
+	const xml = buildReverseReceiptXml(ctx.credentials, normalized);
+	return ctx.execute({
+		action: "reverseReceipt",
+		xml,
+		signal: options.signal,
+		safeToRetry: require_issue.optionalText(normalized.callId) !== void 0
+	}, require_issue.parseReceiptResponse);
+}
+//#endregion
+//#region src/receipts/send.ts
+const SEND_RECEIPT_NAMESPACE = "http://www.szamlazz.hu/xmlnyugtasend";
+const EMAIL_PATTERN = /^[^\s@,;<>]+@[^\s@,;<>]+\.[^\s@,;<>]+$/;
+function isValidEmail(value) {
+	return EMAIL_PATTERN.test(value);
+}
+function assertEmail(value, field) {
+	if (!isValidEmail(value)) throw require_issue.receiptValidationError(`Érvénytelen e-mail cím a(z) ${field} mezőben: ${value}`);
+	return value;
+}
+function normalizeEmails(emails) {
+	const list = (typeof emails === "string" ? [emails] : [...emails]).flatMap((entry) => entry.split(/[,;]/)).map((entry) => entry.trim()).filter((entry) => entry !== "");
+	if (list.length === 0) throw require_issue.receiptValidationError("Adj meg legalább egy címzett e-mail címet (emails).");
+	return list.map((email) => assertEmail(email, "emails"));
+}
+function buildSendReceiptXml(credentials, input) {
+	const receiptNumber = require_issue.requireReceiptNumber(input.receiptNumber);
+	const emails = normalizeEmails(input.emails);
+	const replyTo = require_issue.optionalText(input.replyTo);
+	if (replyTo !== void 0) assertEmail(replyTo, "replyTo");
+	return require_issue.buildXmlDocument({
+		root: "xmlnyugtasend",
+		namespace: SEND_RECEIPT_NAMESPACE,
+		schemaLocation: `${require_issue.RECEIPT_XSD_BASE_URL}nyugtasend/xmlnyugtasend.xsd`,
+		children: [
+			require_issue.el("beallitasok", credentials),
+			require_issue.el("fejlec", [require_issue.el("nyugtaszam", receiptNumber)]),
+			require_issue.el("emailKuldes", [
+				require_issue.el("email", emails.join(",")),
+				require_issue.optionalEl("emailReplyto", replyTo),
+				require_issue.el("emailTargy", require_issue.optionalText(input.subject) ?? `Nyugta ${receiptNumber}`),
+				require_issue.optionalEl("emailSzoveg", input.text?.trim() ? input.text : void 0)
+			])
+		]
+	});
+}
+function parseSendReceiptResponse(response) {
+	require_issue.throwIfHeaderError(response);
+	require_issue.throwIfTextError(response);
+	if (!require_issue.looksLikeXml(response)) {
+		require_issue.throwIfHttpError(response);
+		if (require_issue.parseDoneText(response.text())) return;
+		throw require_issue.unexpectedResponse(response, "XML választ vártunk a nyugta kiküldésére.");
+	}
+	const root = require_issue.parseResponseXml(response);
+	require_issue.throwIfXmlFailure(root, response);
+	if (require_issue.childBoolean(root, "sikeres") !== true) {
+		require_issue.throwIfHttpError(response);
+		throw require_issue.unexpectedResponse(response, "A válasz nem jelez sikeres kiküldést.");
+	}
+}
+function sendReceipt(ctx, input, options = {}) {
+	const xml = buildSendReceiptXml(ctx.credentials, input);
+	return ctx.execute({
+		action: "sendReceipt",
+		xml,
+		signal: options.signal
+	}, parseSendReceiptResponse);
+}
+//#endregion
+//#region src/taxpayer/address.ts
+const ROMAN_NUMERAL = /^[IVX]{1,5}\.?$/;
+function isShouting(value) {
+	return value === value.toUpperCase() && value !== value.toLowerCase();
+}
+function capitalizeWord(word) {
+	if (ROMAN_NUMERAL.test(word)) return word;
+	return word.split("-").map((part) => part.toLowerCase().replace(/\p{L}/u, (letter) => letter.toUpperCase())).join("-");
+}
+function toReadableName(value) {
+	if (value === void 0 || !isShouting(value)) return value;
+	return value.split(" ").map(capitalizeWord).join(" ");
+}
+function toLowerIfShouting(value) {
+	return value !== void 0 && isShouting(value) ? value.toLowerCase() : value;
+}
+function withOrdinalDot(value) {
+	if (value === void 0) return void 0;
+	return /^\d+$/.test(value) ? `${value}.` : value;
+}
+function joinParts(parts) {
+	return parts.filter((part) => part !== void 0 && part !== "").join(" ");
+}
+function formatAddress(address) {
+	return [
+		joinParts([address.postalCode, address.city]),
+		joinParts([
+			address.street,
+			address.publicPlaceCategory,
+			withOrdinalDot(address.number),
+			address.building === void 0 ? void 0 : `${address.building} ép.`,
+			address.staircase === void 0 ? void 0 : `${withOrdinalDot(address.staircase)} lh.`,
+			address.floor === void 0 ? void 0 : `${withOrdinalDot(address.floor)} em.`,
+			address.door === void 0 ? void 0 : `${withOrdinalDot(address.door)} ajtó`
+		]),
+		address.lotNumber === void 0 ? void 0 : `hrsz. ${address.lotNumber}`,
+		address.countryCode === "" || address.countryCode === "HU" ? void 0 : address.countryCode
+	].filter((part) => part !== void 0 && part !== "").join(", ");
+}
+function readDetailedAddress(element) {
+	return {
+		countryCode: require_issue.childText(element, "countryCode"),
+		region: require_issue.childText(element, "region"),
+		postalCode: require_issue.childText(element, "postalCode"),
+		city: require_issue.childText(element, "city"),
+		streetName: require_issue.childText(element, "streetName"),
+		publicPlaceCategory: require_issue.childText(element, "publicPlaceCategory"),
+		number: require_issue.childText(element, "number"),
+		building: require_issue.childText(element, "building"),
+		staircase: require_issue.childText(element, "staircase"),
+		floor: require_issue.childText(element, "floor"),
+		door: require_issue.childText(element, "door"),
+		lotNumber: require_issue.childText(element, "lotNumber")
+	};
+}
+function parseTaxpayerAddress(item) {
+	const raw = readDetailedAddress(require_issue.findChild(item, "taxpayerAddress"));
+	const address = {
+		type: require_issue.childText(item, "taxpayerAddressType")?.toUpperCase() ?? "",
+		countryCode: raw.countryCode?.toUpperCase() ?? "",
+		region: toReadableName(raw.region),
+		postalCode: raw.postalCode ?? "",
+		city: toReadableName(raw.city) ?? "",
+		street: toReadableName(raw.streetName),
+		publicPlaceCategory: toLowerIfShouting(raw.publicPlaceCategory),
+		number: raw.number,
+		building: raw.building,
+		staircase: raw.staircase,
+		floor: raw.floor,
+		door: raw.door,
+		lotNumber: raw.lotNumber
+	};
+	return {
+		...address,
+		formatted: formatAddress(address),
+		raw
+	};
+}
+//#endregion
+//#region src/taxpayer/query-taxpayer.ts
+const TAXPAYER_NAMESPACE = "http://www.szamlazz.hu/xmltaxpayer";
+const TAXPAYER_SCHEMA_LOCATION = "http://www.szamlazz.hu/docs/xsds/agent/xmltaxpayer.xsd";
+function toTaxpayerId(taxNumber) {
+	const digits = typeof taxNumber === "string" ? taxNumber.replace(/[\s-]+/g, "").replace(/^HU/i, "") : "";
+	if (!/^(?:\d{8}|\d{11})$/.test(digits)) throw new require_errors.SzamlazzError(`Érvénytelen adószám: "${String(taxNumber)}". Add meg a 8 jegyű törzsszámot vagy a 11 jegyű adószámot (pl. 12345678-2-42).`, {
+		category: "validation",
+		action: "queryTaxpayer"
+	});
+	return digits.slice(0, 8);
+}
+function buildQueryTaxpayerXml(credentials, taxNumber) {
+	return require_issue.buildXmlDocument({
+		root: "xmltaxpayer",
+		namespace: TAXPAYER_NAMESPACE,
+		schemaLocation: TAXPAYER_SCHEMA_LOCATION,
+		children: [require_issue.el("beallitasok", credentials), require_issue.el("torzsszam", toTaxpayerId(taxNumber))]
+	});
+}
+function throwIfNavError(root, response) {
+	const result = require_issue.findChild(root, "result");
+	if (require_issue.childText(result, "funcCode")?.toUpperCase() !== "ERROR") return;
+	const errorCode = require_issue.childText(result, "errorCode");
+	const code = require_errors.parseErrorCode(errorCode);
+	const message = require_issue.childText(result, "message");
+	const textCode = code === void 0 ? errorCode : void 0;
+	throw require_errors.createAgentError({
+		code,
+		message: textCode === void 0 ? message : [textCode, message].filter(Boolean).join(": "),
+		action: response.action,
+		httpStatus: response.status,
+		rawResponse: response.text().slice(0, 2e3)
+	});
+}
+function readTaxNumber(data) {
+	const detail = require_issue.findChild(data, "taxNumberDetail");
+	const taxpayerId = require_issue.childText(detail, "taxpayerId");
+	if (taxpayerId === void 0) return void 0;
+	const vatCode = require_issue.childText(detail, "vatCode");
+	const countyCode = require_issue.childText(detail, "countyCode");
+	return {
+		taxpayerId,
+		vatCode,
+		countyCode,
+		formatted: vatCode !== void 0 && countyCode !== void 0 ? `${taxpayerId}-${vatCode}-${countyCode}` : void 0
+	};
+}
+function readAddresses(data) {
+	return require_issue.findChildren(require_issue.findChild(data, "taxpayerAddressList"), "taxpayerAddressItem").map(parseTaxpayerAddress);
+}
+function readRequestId(root) {
+	const requestId = require_issue.childText(require_issue.findChild(root, "header"), "requestId");
+	return requestId === "-" ? void 0 : requestId;
+}
+function parseQueryTaxpayerResponse(response) {
+	require_issue.throwIfAnyError(response);
+	const root = require_issue.parseResponseXml(response);
+	require_issue.throwIfXmlFailure(root, response);
+	if (root.name !== "QueryTaxpayerResponse") throw require_issue.unexpectedResponse(response, "QueryTaxpayerResponse XML választ vártunk.");
+	throwIfNavError(root, response);
+	const requestId = readRequestId(root);
+	const infoDate = require_issue.childText(root, "infoDate");
+	const data = require_issue.findChild(root, "taxpayerData");
+	const validity = require_issue.childBoolean(root, "taxpayerValidity");
+	if (validity === false || data === void 0) return {
+		valid: validity === true,
+		addresses: [],
+		infoDate,
+		requestId
+	};
+	const addresses = readAddresses(data);
+	return {
+		valid: true,
+		name: require_issue.childText(data, "taxpayerName"),
+		shortName: require_issue.childText(data, "taxpayerShortName"),
+		taxNumber: readTaxNumber(data),
+		address: addresses.find((address) => address.type === "HQ") ?? addresses[0],
+		addresses,
+		incorporation: require_issue.childText(data, "incorporation"),
+		vatGroupMembership: require_issue.childText(data, "vatGroupMembership"),
+		infoDate,
+		requestId
+	};
+}
+async function queryTaxpayer(ctx, taxNumber, options = {}) {
+	const xml = buildQueryTaxpayerXml(ctx.credentials, taxNumber);
+	return ctx.execute({
+		action: "queryTaxpayer",
+		xml,
+		signal: options.signal,
+		safeToRetry: true
+	}, parseQueryTaxpayerResponse);
+}
+//#endregion
+//#region src/client.ts
+const CREDENTIAL_PROBE_INVOICE_NUMBER = "KASSZA-CREDENTIAL-PROBE-0";
+async function nullIfNotFound(promise) {
+	try {
+		return await promise;
+	} catch (error) {
+		if (require_errors.isSzamlazzError(error) && (error.isNotFound || error.code === 7)) return null;
+		throw error;
+	}
+}
+function attemptKeyOf(target) {
+	if (typeof target === "string") return target;
+	const key = target.details?.attemptKey;
+	if (key === void 0) throw new TypeError("A resetAttempts egy attempt_limit hibát vagy annak details.attemptKey kulcsát várja.");
+	return key;
+}
+function invoiceNumberOf(input) {
+	return typeof input === "string" ? input : input.invoiceNumber;
+}
+function receiptNumberOf(input) {
+	return typeof input === "string" ? input : input.receiptNumber;
+}
+function createInvoicesApi(ctx, defaults, onDocument) {
+	const api = {
+		async create(input, options) {
+			const document = await createInvoice(ctx, defaults, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "invoice",
+				action: "created",
+				number: document.number,
+				document,
+				input
+			});
+			return document;
+		},
+		createOnce: (input, options) => require_issue.createInvoiceOnce(api, input, options),
+		preview: (input, options) => previewInvoice(ctx, defaults, input, options),
+		async reverse(input, options) {
+			const document = await reverseInvoice(ctx, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "invoice",
+				action: "reversed",
+				number: document.number,
+				reversedNumber: invoiceNumberOf(input),
+				document
+			});
+			return document;
+		},
+		async registerPayment(input, options) {
+			const document = await registerPayment(ctx, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "invoice",
+				action: "payment",
+				number: document.invoiceNumber,
+				document
+			});
+			return document;
+		},
+		async clearPayments(input, options) {
+			const document = await clearPayments(ctx, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "invoice",
+				action: "payment",
+				number: document.invoiceNumber,
+				document
+			});
+			return document;
+		},
+		getPdf: (reference, options) => getInvoicePdf(ctx, reference, options),
+		get: (reference, query, options) => getInvoice(ctx, reference, query, options),
+		find: (reference, query, options) => nullIfNotFound(getInvoice(ctx, reference, query, options)),
+		deleteProforma: (reference, options) => deleteProforma(ctx, reference, options)
+	};
+	return api;
+}
+function createReceiptsApi(ctx, defaults, invoices, onDocument) {
+	const api = {
+		async create(input, options) {
+			const document = await require_issue.createReceipt(ctx, defaults, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "receipt",
+				action: "created",
+				number: document.number,
+				document
+			});
+			return document;
+		},
+		createOnce: (input, options) => require_create_once.createReceiptOnce(api, input, options),
+		async reverse(input, options) {
+			const document = await reverseReceipt(ctx, input, options);
+			await require_create_once.emitDocumentEvent(onDocument, {
+				kind: "receipt",
+				action: "reversed",
+				number: document.number,
+				reversedNumber: receiptNumberOf(input),
+				document
+			});
+			return document;
+		},
+		get: (input, options) => getReceipt(ctx, input, options),
+		find: (input, options) => nullIfNotFound(getReceipt(ctx, input, options)),
+		send: (input, options) => sendReceipt(ctx, input, options),
+		convertToInvoice: (input, options) => require_issue.convertReceiptToInvoice({
+			receipts: api,
+			invoices
+		}, input, options)
+	};
+	return api;
+}
+function createKassza(options = {}) {
+	const ctx = createAgentContext(options);
+	const onDocument = options.hooks?.onDocument;
+	const invoices = createInvoicesApi(ctx, options.defaults?.invoice ?? {}, onDocument);
+	const receipts = createReceiptsApi(ctx, options.defaults?.receipt ?? {}, invoices, onDocument);
+	return {
+		invoices,
+		receipts,
+		taxpayer: { query: (taxNumber, requestOptions) => queryTaxpayer(ctx, taxNumber, requestOptions) },
+		async verifyCredentials(requestOptions) {
+			try {
+				await getInvoicePdf(ctx, CREDENTIAL_PROBE_INVOICE_NUMBER, requestOptions);
+				return true;
+			} catch (error) {
+				if (!require_errors.isSzamlazzError(error)) throw error;
+				if (error.category === "auth") return false;
+				if (error.isNotFound || error.code === 7) return true;
+				throw error;
+			}
+		},
+		resetSession: () => ctx.resetSession(),
+		resetAttempts: (target) => ctx.resetAttempts(attemptKeyOf(target)),
+		issueForPayment: (payment, issueOptions) => require_issue.issueForPayment({
+			invoices,
+			receipts
+		}, payment, issueOptions)
+	};
+}
+//#endregion
+Object.defineProperty(exports, "ATTEMPT_LEDGER_KEY_PREFIX", {
+	enumerable: true,
+	get: function() {
+		return ATTEMPT_LEDGER_KEY_PREFIX;
+	}
+});
+Object.defineProperty(exports, "ATTEMPT_LEDGER_TTL_SECONDS", {
+	enumerable: true,
+	get: function() {
+		return ATTEMPT_LEDGER_TTL_SECONDS;
+	}
+});
+Object.defineProperty(exports, "attemptLedgerKey", {
+	enumerable: true,
+	get: function() {
+		return attemptLedgerKey;
+	}
+});
+Object.defineProperty(exports, "createAgentContext", {
+	enumerable: true,
+	get: function() {
+		return createAgentContext;
+	}
+});
+Object.defineProperty(exports, "createKassza", {
+	enumerable: true,
+	get: function() {
+		return createKassza;
+	}
+});
+Object.defineProperty(exports, "getInvoicePdf", {
+	enumerable: true,
+	get: function() {
+		return getInvoicePdf;
+	}
+});
+Object.defineProperty(exports, "queryTaxpayer", {
+	enumerable: true,
+	get: function() {
+		return queryTaxpayer;
+	}
+});