kassza 0.12.0 → 0.14.0

package/dist/data-link/index.js

@@ -0,0 +1,224 @@
+import { r as SzamlazzError } from "../errors-DtN4g5Z9.js";
+import { i as encodeUtf8 } from "../binary-D0M9U2MD.js";
+import { a as optionalEl, c as childNumber, d as findChildren, f as parseXml, l as childText, n as buildXmlDocument, o as XmlParseError, r as el, s as childBoolean, u as findChild } from "../serialize-B2eFh3D-.js";
+import { r as createAgentResponse, t as parseReceiptElement } from "../parse-Cr7yQ3_z.js";
+import { n as parseInvoiceDetailsXml } from "../get-CZEShCcj.js";
+import { a as timingSafeEqual } from "../crypto-usDg8L2K.js";
+import { t as readRequestText } from "../request-body-uZHMRlQr.js";
+//#region src/data-link/push.ts
+var DataLinkError = class extends Error {
+	name = "DataLinkError";
+	reason;
+	constructor(reason, message, cause) {
+		super(message, cause === void 0 ? void 0 : { cause });
+		this.reason = reason;
+	}
+};
+const ROOT_KINDS = /* @__PURE__ */ new Map([
+	["szamla", "invoice"],
+	["szamlabe", "incoming-invoice"],
+	["banktranz", "bank-transaction"],
+	["xmlnyugtaarchiv", "receipts"]
+]);
+function invalid(message, cause) {
+	return new DataLinkError("invalid_payload", message, cause);
+}
+function requiredText(element, name, path) {
+	const value = childText(element, name);
+	if (value === void 0) throw invalid(`Hiányzik a(z) <${path}/${name}> elem.`);
+	return value;
+}
+function requiredInteger(element, name, path) {
+	const value = Number(requiredText(element, name, path));
+	if (!Number.isInteger(value)) throw invalid(`A(z) <${path}/${name}> nem egész szám.`);
+	return value;
+}
+function wrapSzamlazzError(read) {
+	try {
+		return read();
+	} catch (error) {
+		if (error instanceof SzamlazzError) throw invalid(error.message, error);
+		throw error;
+	}
+}
+function invoicePush(kind, root, raw, key) {
+	const header = findChild(root, "alap");
+	const id = requiredInteger(header, "id", "alap");
+	const response = createAgentResponse("getInvoiceXml", 200, new Headers(), encodeUtf8(raw));
+	return {
+		kind,
+		key,
+		raw,
+		id,
+		invoice: wrapSzamlazzError(() => parseInvoiceDetailsXml(root, response)),
+		deleted: childBoolean(header, "dobdel") === true
+	};
+}
+function bankTransactionPush(root, raw, key) {
+	const direction = requiredText(root, "irany", "banktranz");
+	if (direction !== "BE" && direction !== "KI") throw invalid(`Ismeretlen banki tranzakció irány: ${direction}.`);
+	const amount = childNumber(root, "osszeg");
+	if (amount === void 0) throw invalid("Hiányzik a(z) <banktranz/osszeg> elem.");
+	const partner = findChild(root, "partner");
+	return {
+		kind: "bank-transaction",
+		key,
+		raw,
+		transaction: {
+			id: requiredInteger(root, "id", "banktranz"),
+			accountNumber: requiredText(root, "bankszamla", "banktranz"),
+			valueDate: requiredText(root, "erteknap", "banktranz"),
+			direction: direction === "BE" ? "in" : "out",
+			type: childText(root, "tipus"),
+			technical: childBoolean(root, "technikai") === true,
+			amount,
+			currency: requiredText(root, "devizanem", "banktranz"),
+			partner: partner && {
+				name: childText(partner, "nev"),
+				accountNumber: childText(partner, "bankszamla")
+			},
+			reference: childText(root, "kozlemeny")
+		}
+	};
+}
+function receiptsPush(root, raw, key) {
+	const response = createAgentResponse("getReceipt", 200, new Headers(), encodeUtf8(raw));
+	const receipts = findChildren(root, "nyugta").map((element) => ({
+		receipt: wrapSzamlazzError(() => parseReceiptElement(element, response)),
+		issuerTaxNumber: childText(findChild(element, "alap"), "adoszam")
+	}));
+	if (receipts.length === 0) throw invalid("A nyugtaarchívum nem tartalmaz <nyugta> elemet.");
+	return {
+		kind: "receipts",
+		key,
+		raw,
+		receipts
+	};
+}
+function parseDataLinkPush(xml, key) {
+	if (xml.trim() === "") throw invalid("Üres adatkapcsolati üzenet érkezett.");
+	let root;
+	try {
+		root = parseXml(xml);
+	} catch (error) {
+		if (error instanceof XmlParseError) throw invalid(`Az üzenet nem érvényes XML: ${error.message}`, error);
+		throw error;
+	}
+	const kind = ROOT_KINDS.get(root.name);
+	const normalizedKey = key?.trim() || void 0;
+	switch (kind) {
+		case "invoice":
+		case "incoming-invoice": return invoicePush(kind, root, xml, normalizedKey);
+		case "bank-transaction": return bankTransactionPush(root, xml, normalizedKey);
+		case "receipts": return receiptsPush(root, xml, normalizedKey);
+		default: throw new DataLinkError("unknown_document", `Ismeretlen adatkapcsolati bizonylattípus: <${root.name}>.`);
+	}
+}
+//#endregion
+//#region src/data-link/response.ts
+const DATA_LINK_RESPONSE_ROOTS = {
+	invoice: {
+		root: "szamlavalasz",
+		namespace: "http://www.szamlazz.hu/szamlavalasz"
+	},
+	"incoming-invoice": {
+		root: "szamlabevalasz",
+		namespace: "http://www.szamlazz.hu/szamlabevalasz"
+	},
+	"bank-transaction": {
+		root: "banktranzvalasz",
+		namespace: "http://www.szamlazz.hu/banktranzvalasz"
+	},
+	receipts: {
+		root: "nyugtavalasz",
+		namespace: "http://www.szamlazz.hu/nyugtavalasz"
+	}
+};
+function keyErrorOf(acknowledgement) {
+	const keyError = acknowledgement.keyError;
+	if (keyError === void 0 || keyError === "KEY_ERR" || keyError === "KEY_DEL") return keyError;
+	throw new TypeError(`Ismeretlen kulcshiba: ${String(keyError)}. Csak KEY_ERR vagy KEY_DEL adható.`);
+}
+function registrationNumberOf(push, value) {
+	if (value !== void 0 && typeof value !== "string") throw new TypeError("Az iktatószám (registrationNumber) szöveg legyen.");
+	const registrationNumber = value?.trim();
+	if (!registrationNumber) return void 0;
+	if (push.kind !== "invoice" && push.kind !== "incoming-invoice") throw new TypeError("Iktatószámot csak számla (kimenő vagy bejövő) válaszában lehet visszaadni.");
+	return registrationNumber;
+}
+function dataLinkResponseXml(push, acknowledgement = {}) {
+	const target = DATA_LINK_RESPONSE_ROOTS[push.kind];
+	const keyError = keyErrorOf(acknowledgement);
+	const registrationNumber = registrationNumberOf(push, acknowledgement.registrationNumber);
+	const children = [];
+	if (push.kind === "invoice" || push.kind === "incoming-invoice") children.push(el("alap", [el("id", push.id), optionalEl("iktatoszam", registrationNumber)]));
+	if (keyError !== void 0) children.push(el("hibakod", keyError));
+	return buildXmlDocument({
+		root: target.root,
+		namespace: target.namespace,
+		children
+	});
+}
+function dataLinkResponse(push, acknowledgement = {}) {
+	return new Response(dataLinkResponseXml(push, acknowledgement), {
+		status: 200,
+		headers: { "content-type": "application/xml; charset=UTF-8" }
+	});
+}
+//#endregion
+//#region src/data-link/handler.ts
+const DATA_LINK_KEY_HEADER = "x-szamlazzhu-key";
+const DEFAULT_DATA_LINK_MAX_BYTES = 67108864;
+function plain(status, body) {
+	return new Response(body, {
+		status,
+		headers: { "content-type": "text/plain; charset=utf-8" }
+	});
+}
+function reportError(onError, error) {
+	try {
+		if (onError) onError(error);
+		else console.error("[kassza] Az adatkapcsolati üzenet feldolgozása nem sikerült.", error);
+	} catch {
+		return;
+	}
+}
+function acknowledgementOf(value) {
+	if (value === void 0 || value === null) return {};
+	if (typeof value !== "object") throw new TypeError("Az onPush csak DataLinkAcknowledgement objektumot (registrationNumber, keyError) vagy semmit adhat vissza.");
+	return value;
+}
+function configuredKeys(keys) {
+	if (keys === void 0) return void 0;
+	const trimmed = keys.map((key) => typeof key === "string" ? key.trim() : "");
+	if (trimmed.length === 0 || trimmed.some((key) => key === "")) throw new TypeError("A keys lista nem lehet üres, és nem tartalmazhat üres kulcsot.");
+	return trimmed;
+}
+async function checkKey(options, keys, push) {
+	const key = push.key;
+	if (key === void 0) return "KEY_ERR";
+	if (keys !== void 0 && !keys.some((candidate) => timingSafeEqual(candidate, key))) return "KEY_ERR";
+	if (!options.verifyKey) return true;
+	const result = await options.verifyKey(key, push);
+	return result === false ? "KEY_ERR" : result;
+}
+function dataLinkHandler(options) {
+	if (typeof options.onPush !== "function") throw new TypeError("Add meg az onPush függvényt.");
+	const keys = configuredKeys(options.keys);
+	if (keys === void 0 && typeof options.verifyKey !== "function") throw new TypeError("Add meg az elfogadott azonosító kulcsokat (keys) vagy a verifyKey függvényt: az adatkapcsolati üzenetnek nincs aláírása, csak a kulcs azonosítja a küldőt.");
+	const maxBytes = options.maxBodyBytes ?? 67108864;
+	return async (request) => {
+		try {
+			const push = parseDataLinkPush(await readRequestText(request, maxBytes, () => new DataLinkError("payload_too_large", `Az adatkapcsolati üzenet nagyobb a megengedett ${maxBytes} bájtnál.`)), request.headers.get("x-szamlazzhu-key") ?? void 0);
+			const keyCheck = await checkKey(options, keys, push);
+			if (keyCheck !== true) return dataLinkResponse(push, { keyError: keyCheck });
+			return dataLinkResponse(push, acknowledgementOf(await options.onPush(push)));
+		} catch (error) {
+			if (error instanceof DataLinkError) return plain(400, error.message);
+			reportError(options.onError, error);
+			return plain(500, "Az adatkapcsolati üzenet feldolgozása nem sikerült.");
+		}
+	};
+}
+//#endregion
+export { DATA_LINK_KEY_HEADER, DATA_LINK_RESPONSE_ROOTS, DEFAULT_DATA_LINK_MAX_BYTES, DataLinkError, dataLinkHandler, dataLinkResponse, dataLinkResponseXml, parseDataLinkPush };

package/dist/delegation/index.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors = require("../errors-DxeuTslP.cjs");
-const require_client = require("../client-CsmGIFRS.cjs");
-const require_issue = require("../issue-BsyYdrIG.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_parse = require("../parse-DOA2XQ3e.cjs");
 const require_dates = require("../dates-CPgBodkP.cjs");
 const require_tax_number = require("../tax-number-BYFkBp4A.cjs");
 //#region src/delegation/connect.ts
@@ -107,52 +108,52 @@ function loginNodes(credentials) {
 		return node === void 0 ? void 0 : String(node.content);
 	};
 	const agentKey = value("szamlaagentkulcs");
-	if (agentKey !== void 0) return [require_issue.el("szamlaagentkulcs", agentKey)];
+	if (agentKey !== void 0) return [require_serialize.el("szamlaagentkulcs", agentKey)];
 	const username = value("felhasznalo");
 	const password = value("jelszo");
 	if (username === void 0 || password === void 0) throw new require_errors.SzamlazzError("A megbízotti fiók azonosításához Agent kulcs vagy felhasználónév és jelszó kell.", {
 		category: "configuration",
 		action: "connectPrincipal"
 	});
-	return [require_issue.el("loginname", username), require_issue.el("password", password)];
+	return [require_serialize.el("loginname", username), require_serialize.el("password", password)];
 }
 function principalNodes(input) {
 	const { principal } = input;
-	return require_issue.el("cegMb", [
-		require_issue.el("cegcompanyname", principal.name.trim()),
-		require_issue.el("cegtaxnumber", input.taxNumber),
-		require_issue.el("cegszamlaszamelotag", input.invoicePrefix),
-		require_issue.el("cegirsz", principal.zip.trim()),
-		require_issue.el("cegcity", principal.city.trim()),
-		require_issue.el("cegaddr", principal.address.trim()),
-		require_issue.optionalEl("cegpostirsz", optionalText(principal.postalAddress?.zip)),
-		require_issue.optionalEl("cegpostcity", optionalText(principal.postalAddress?.city)),
-		require_issue.optionalEl("cegpostaddr", optionalText(principal.postalAddress?.address)),
-		require_issue.el("cegbank", optionalText(principal.bankName) ?? ""),
-		require_issue.el("cegbankaccount", optionalText(principal.bankAccount) ?? ""),
-		require_issue.el("cegemail", principal.email.trim()),
-		require_issue.el("cegemailreplyto", optionalText(principal.replyToEmail) ?? ""),
-		require_issue.optionalEl("cegpenzforgdattol", input.cashAccountingFrom),
-		require_issue.optionalEl("cegpenzforgdatig", input.cashAccountingTo),
-		require_issue.optionalEl("cegkatadattol", input.kataFrom),
-		require_issue.optionalEl("cegkatadatig", input.kataTo)
+	return require_serialize.el("cegMb", [
+		require_serialize.el("cegcompanyname", principal.name.trim()),
+		require_serialize.el("cegtaxnumber", input.taxNumber),
+		require_serialize.el("cegszamlaszamelotag", input.invoicePrefix),
+		require_serialize.el("cegirsz", principal.zip.trim()),
+		require_serialize.el("cegcity", principal.city.trim()),
+		require_serialize.el("cegaddr", principal.address.trim()),
+		require_serialize.optionalEl("cegpostirsz", optionalText(principal.postalAddress?.zip)),
+		require_serialize.optionalEl("cegpostcity", optionalText(principal.postalAddress?.city)),
+		require_serialize.optionalEl("cegpostaddr", optionalText(principal.postalAddress?.address)),
+		require_serialize.el("cegbank", optionalText(principal.bankName) ?? ""),
+		require_serialize.el("cegbankaccount", optionalText(principal.bankAccount) ?? ""),
+		require_serialize.el("cegemail", principal.email.trim()),
+		require_serialize.el("cegemailreplyto", optionalText(principal.replyToEmail) ?? ""),
+		require_serialize.optionalEl("cegpenzforgdattol", input.cashAccountingFrom),
+		require_serialize.optionalEl("cegpenzforgdatig", input.cashAccountingTo),
+		require_serialize.optionalEl("cegkatadattol", input.kataFrom),
+		require_serialize.optionalEl("cegkatadatig", input.kataTo)
 	]);
 }
 function userNodes(input) {
-	return require_issue.el("usrMb", [
-		require_issue.el("usremail", input.userEmail),
-		require_issue.el("usrpassword", input.user.password),
-		require_issue.optionalEl("usrvezeteknev", optionalText(input.user.lastName)),
-		require_issue.el("usrkeresztnev", input.user.firstName.trim())
+	return require_serialize.el("usrMb", [
+		require_serialize.el("usremail", input.userEmail),
+		require_serialize.el("usrpassword", input.user.password),
+		require_serialize.optionalEl("usrvezeteknev", optionalText(input.user.lastName)),
+		require_serialize.el("usrkeresztnev", input.user.firstName.trim())
 	]);
 }
 function buildXml(credentials, input) {
-	return require_issue.buildXmlDocument({
+	return require_serialize.buildXmlDocument({
 		root: "XmlCegMb",
 		namespace: CONNECT_PRINCIPAL_NAMESPACE,
 		schemaLocation: CONNECT_PRINCIPAL_SCHEMA_LOCATION,
 		children: [
-			require_issue.el("login", loginNodes(credentials)),
+			require_serialize.el("login", loginNodes(credentials)),
 			principalNodes(input),
 			userNodes(input)
 		]
@@ -192,16 +193,16 @@ function repairMojibake(value) {
 	}
 }
 function agentResponseMessage(response) {
-	const header = require_issue.readHeader(response.headers, AGENT_RESPONSE_HEADER, true);
+	const header = require_parse.readHeader(response.headers, AGENT_RESPONSE_HEADER, true);
 	if (header !== void 0) return repairMojibake(header);
 	const match = AGENT_RESPONSE_TEXT.exec(response.text());
-	const body = match?.[1] ? require_issue.decodeHeaderValue(match[1]).trim() : void 0;
+	const body = match?.[1] ? require_parse.decodeHeaderValue(match[1]).trim() : void 0;
 	return body ? body : void 0;
 }
 function parseConnectPrincipalResponse(response) {
-	require_issue.throwIfAnyError(response);
+	require_parse.throwIfAnyError(response);
 	const message = agentResponseMessage(response);
-	if (message === void 0) throw require_issue.unexpectedResponse(response, "Hiányzik az XML_AGENT_RESPONSE válasz.");
+	if (message === void 0) throw require_parse.unexpectedResponse(response, "Hiányzik az XML_AGENT_RESPONSE válasz.");
 	return {
 		status: connectPrincipalStatus(message),
 		message

package/dist/delegation/index.d.cts

@@ -1,5 +1,6 @@
-import { J as AgentContext, Kt as suggestedPrefix, Q as RequestOptions, Ut as SzamlazzError, et as SzamlazzOptions, ht as AgentResponse, i as KasszaOptions, mt as XmlNode, n as Kassza, r as KasszaDefaults } from "../client-DvWZoX_E.cjs";
 import { t as DateInput } from "../dates-9zvESP0i.cjs";
+import { D as XmlNode, O as AgentResponse, dt as suggestedPrefix, l as SzamlazzOptions, r as AgentContext, s as RequestOptions, st as SzamlazzError } from "../context-CFNKzStE.cjs";
+import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-SVZu25MB.cjs";
 //#region src/delegation/connect.d.ts
 export declare const CONNECT_PRINCIPAL_NAMESPACE = "http://www.szamlazz.hu/xmlcegmb";
 export declare const CONNECT_PRINCIPAL_SCHEMA_LOCATION = "http://www.szamlazz.hu/docs/xsds/agentmb/xmlcegmb.xsd";

package/dist/delegation/index.d.ts

@@ -1,5 +1,6 @@
-import { J as AgentContext, Kt as suggestedPrefix, Q as RequestOptions, Ut as SzamlazzError, et as SzamlazzOptions, ht as AgentResponse, i as KasszaOptions, mt as XmlNode, n as Kassza, r as KasszaDefaults } from "../client-CickRRFr.js";
 import { t as DateInput } from "../dates-9zvESP0i.js";
+import { D as XmlNode, O as AgentResponse, dt as suggestedPrefix, l as SzamlazzOptions, r as AgentContext, s as RequestOptions, st as SzamlazzError } from "../context-kb33TgzE.js";
+import { i as KasszaOptions, n as Kassza, r as KasszaDefaults } from "../client-DeWWQ-RZ.js";
 //#region src/delegation/connect.d.ts
 export declare const CONNECT_PRINCIPAL_NAMESPACE = "http://www.szamlazz.hu/xmlcegmb";
 export declare const CONNECT_PRINCIPAL_SCHEMA_LOCATION = "http://www.szamlazz.hu/docs/xsds/agentmb/xmlcegmb.xsd";

package/dist/delegation/index.js

@@ -1,6 +1,7 @@
-import { i as isSzamlazzError, n as SzamlazzError, o as suggestedPrefix } from "../errors-DLrb0g64.js";
-import { i as createAgentContext, n as queryTaxpayer, r as getInvoicePdf, t as createKassza } from "../client-CL3fuH6A.js";
-import { C as buildXmlDocument, D as decodeHeaderValue, M as readHeader, N as throwIfAnyError, R as unexpectedResponse, T as optionalEl, w as el } from "../issue-C6Fcjvln.js";
+import { c as suggestedPrefix, o as isSzamlazzError, r as SzamlazzError } from "../errors-DtN4g5Z9.js";
+import { a as queryTaxpayer, c as createAgentContext, o as getInvoicePdf, t as createKassza } from "../client-Cvf-hTz_.js";
+import { a as optionalEl, n as buildXmlDocument, r as el } from "../serialize-B2eFh3D-.js";
+import { h as unexpectedResponse, i as decodeHeaderValue, l as readHeader, u as throwIfAnyError } from "../parse-Cr7yQ3_z.js";
 import { n as toAgentDate } from "../dates-CXyj7Azy.js";
 import { o as parseHungarianTaxNumber, s as isValidEmail } from "../tax-number-BdqKsxNR.js";
 //#region src/delegation/connect.ts

package/dist/{errors-DLrb0g64.js → errors-DtN4g5Z9.js}

@@ -327,6 +327,11 @@ const AGENT_ERROR_CODES = {
 		hint: SIMPLE_ITEMS_HINT
 	}
 };
+const KASSZA_ERROR_DOCS_URL = "https://kasszajs.hu/docs/hibakodok";
+function errorCodeDocsUrl(code) {
+	if (code === void 0 || AGENT_ERROR_CODES[code] === void 0) return void 0;
+	return `${KASSZA_ERROR_DOCS_URL}/${code}`;
+}
 const RETRYABLE_CATEGORIES = /* @__PURE__ */ new Set([
 	"maintenance",
 	"network",
@@ -353,6 +358,9 @@ var SzamlazzError = class extends Error {
 		this.rawResponse = options.rawResponse;
 		this.details = options.details;
 	}
+	get docsUrl() {
+		return errorCodeDocsUrl(this.code);
+	}
 	get isDuplicate() {
 		return this.category === "duplicate";
 	}
@@ -387,4 +395,4 @@ function parseErrorCode(value) {
 	return Number(trimmed);
 }
 //#endregion
-export { parseErrorCode as a, isSzamlazzError as i, SzamlazzError as n, suggestedPrefix as o, createAgentError as r, AGENT_ERROR_CODES as t };
+export { errorCodeDocsUrl as a, suggestedPrefix as c, createAgentError as i, KASSZA_ERROR_DOCS_URL as n, isSzamlazzError as o, SzamlazzError as r, parseErrorCode as s, AGENT_ERROR_CODES as t };

package/dist/{errors-DxeuTslP.cjs → errors-EE96_6D_.cjs}

@@ -327,6 +327,11 @@ const AGENT_ERROR_CODES = {
 		hint: SIMPLE_ITEMS_HINT
 	}
 };
+const KASSZA_ERROR_DOCS_URL = "https://kasszajs.hu/docs/hibakodok";
+function errorCodeDocsUrl(code) {
+	if (code === void 0 || AGENT_ERROR_CODES[code] === void 0) return void 0;
+	return `${KASSZA_ERROR_DOCS_URL}/${code}`;
+}
 const RETRYABLE_CATEGORIES = /* @__PURE__ */ new Set([
 	"maintenance",
 	"network",
@@ -353,6 +358,9 @@ var SzamlazzError = class extends Error {
 		this.rawResponse = options.rawResponse;
 		this.details = options.details;
 	}
+	get docsUrl() {
+		return errorCodeDocsUrl(this.code);
+	}
 	get isDuplicate() {
 		return this.category === "duplicate";
 	}
@@ -393,6 +401,12 @@ Object.defineProperty(exports, "AGENT_ERROR_CODES", {
 		return AGENT_ERROR_CODES;
 	}
 });
+Object.defineProperty(exports, "KASSZA_ERROR_DOCS_URL", {
+	enumerable: true,
+	get: function() {
+		return KASSZA_ERROR_DOCS_URL;
+	}
+});
 Object.defineProperty(exports, "SzamlazzError", {
 	enumerable: true,
 	get: function() {
@@ -405,6 +419,12 @@ Object.defineProperty(exports, "createAgentError", {
 		return createAgentError;
 	}
 });
+Object.defineProperty(exports, "errorCodeDocsUrl", {
+	enumerable: true,
+	get: function() {
+		return errorCodeDocsUrl;
+	}
+});
 Object.defineProperty(exports, "isSzamlazzError", {
 	enumerable: true,
 	get: function() {