kassza 0.11.0 → 0.13.0

package/dist/vat-g35srbNG.cjs

@@ -0,0 +1,116 @@
+//#region src/money/vat.ts
+const NUMERIC_VAT_RATES = [
+	0,
+	1,
+	2,
+	2.1,
+	3,
+	4,
+	4.8,
+	5,
+	5.5,
+	6,
+	7,
+	7.7,
+	8,
+	8.1,
+	9,
+	9.5,
+	10,
+	11,
+	12,
+	13,
+	13.5,
+	14,
+	15,
+	16,
+	17,
+	18,
+	19,
+	20,
+	21,
+	22,
+	23,
+	24,
+	25,
+	25.5,
+	26,
+	27
+];
+const SPECIAL_VAT_CODES = [
+	"TAHK",
+	"TAM",
+	"AAM",
+	"EUT",
+	"EUKT",
+	"F.AFA",
+	"K.AFA",
+	"HO",
+	"EUE",
+	"EUFADE",
+	"EUFAD37",
+	"ATK",
+	"NAM",
+	"EAM",
+	"KBAUK",
+	"KBAET"
+];
+const numericRates = new Set(NUMERIC_VAT_RATES);
+const specialCodes = new Set(SPECIAL_VAT_CODES);
+function isVatRate(value) {
+	if (typeof value === "number") return numericRates.has(value);
+	return typeof value === "string" && specialCodes.has(value);
+}
+function vatPercentage(rate) {
+	return typeof rate === "number" ? rate : 0;
+}
+function formatVatRate(rate) {
+	return String(rate);
+}
+const HUF_CURRENCIES = /* @__PURE__ */ new Set([
+	"HUF",
+	"Ft",
+	"FT",
+	"huf",
+	"ft"
+]);
+function isHuf(currency) {
+	return currency === void 0 || HUF_CURRENCIES.has(currency.trim());
+}
+//#endregion
+Object.defineProperty(exports, "NUMERIC_VAT_RATES", {
+	enumerable: true,
+	get: function() {
+		return NUMERIC_VAT_RATES;
+	}
+});
+Object.defineProperty(exports, "SPECIAL_VAT_CODES", {
+	enumerable: true,
+	get: function() {
+		return SPECIAL_VAT_CODES;
+	}
+});
+Object.defineProperty(exports, "formatVatRate", {
+	enumerable: true,
+	get: function() {
+		return formatVatRate;
+	}
+});
+Object.defineProperty(exports, "isHuf", {
+	enumerable: true,
+	get: function() {
+		return isHuf;
+	}
+});
+Object.defineProperty(exports, "isVatRate", {
+	enumerable: true,
+	get: function() {
+		return isVatRate;
+	}
+});
+Object.defineProperty(exports, "vatPercentage", {
+	enumerable: true,
+	get: function() {
+		return vatPercentage;
+	}
+});

package/dist/vat-v_dcWCto.js

@@ -0,0 +1,81 @@
+//#region src/money/vat.ts
+const NUMERIC_VAT_RATES = [
+	0,
+	1,
+	2,
+	2.1,
+	3,
+	4,
+	4.8,
+	5,
+	5.5,
+	6,
+	7,
+	7.7,
+	8,
+	8.1,
+	9,
+	9.5,
+	10,
+	11,
+	12,
+	13,
+	13.5,
+	14,
+	15,
+	16,
+	17,
+	18,
+	19,
+	20,
+	21,
+	22,
+	23,
+	24,
+	25,
+	25.5,
+	26,
+	27
+];
+const SPECIAL_VAT_CODES = [
+	"TAHK",
+	"TAM",
+	"AAM",
+	"EUT",
+	"EUKT",
+	"F.AFA",
+	"K.AFA",
+	"HO",
+	"EUE",
+	"EUFADE",
+	"EUFAD37",
+	"ATK",
+	"NAM",
+	"EAM",
+	"KBAUK",
+	"KBAET"
+];
+const numericRates = new Set(NUMERIC_VAT_RATES);
+const specialCodes = new Set(SPECIAL_VAT_CODES);
+function isVatRate(value) {
+	if (typeof value === "number") return numericRates.has(value);
+	return typeof value === "string" && specialCodes.has(value);
+}
+function vatPercentage(rate) {
+	return typeof rate === "number" ? rate : 0;
+}
+function formatVatRate(rate) {
+	return String(rate);
+}
+const HUF_CURRENCIES = /* @__PURE__ */ new Set([
+	"HUF",
+	"Ft",
+	"FT",
+	"huf",
+	"ft"
+]);
+function isHuf(currency) {
+	return currency === void 0 || HUF_CURRENCIES.has(currency.trim());
+}
+//#endregion
+export { isVatRate as a, isHuf as i, SPECIAL_VAT_CODES as n, vatPercentage as o, formatVatRate as r, NUMERIC_VAT_RATES as t };

package/dist/webhook-81giRMdQ.cjs

@@ -0,0 +1,223 @@
+const require_rounding = require("./rounding-TxoWy2ww.cjs");
+const require_request_body = require("./request-body-CH6ZGOrq.cjs");
+//#region src/payments/amounts.ts
+const ISO_ZERO_DECIMAL = /* @__PURE__ */ new Set([
+	"BIF",
+	"CLP",
+	"DJF",
+	"GNF",
+	"ISK",
+	"JPY",
+	"KMF",
+	"KRW",
+	"PYG",
+	"RWF",
+	"UGX",
+	"UYI",
+	"VND",
+	"VUV",
+	"XAF",
+	"XOF",
+	"XPF"
+]);
+const ISO_THREE_DECIMAL = /* @__PURE__ */ new Set([
+	"BHD",
+	"IQD",
+	"JOD",
+	"KWD",
+	"LYD",
+	"OMR",
+	"TND"
+]);
+const ISO_FOUR_DECIMAL = /* @__PURE__ */ new Set(["CLF", "UYW"]);
+const STRIPE_ZERO_DECIMAL = /* @__PURE__ */ new Set([
+	"BIF",
+	"CLP",
+	"DJF",
+	"GNF",
+	"JPY",
+	"KMF",
+	"KRW",
+	"MGA",
+	"PYG",
+	"RWF",
+	"VND",
+	"VUV",
+	"XAF",
+	"XOF",
+	"XPF"
+]);
+const STRIPE_THREE_DECIMAL = /* @__PURE__ */ new Set([
+	"BHD",
+	"JOD",
+	"KWD",
+	"OMR",
+	"TND"
+]);
+function currencyExponent(currency, convention) {
+	const code = currency.trim().toUpperCase();
+	if (convention === "stripe") {
+		if (STRIPE_ZERO_DECIMAL.has(code)) return 0;
+		if (STRIPE_THREE_DECIMAL.has(code)) return 3;
+		return 2;
+	}
+	if (ISO_ZERO_DECIMAL.has(code)) return 0;
+	if (ISO_THREE_DECIMAL.has(code)) return 3;
+	if (ISO_FOUR_DECIMAL.has(code)) return 4;
+	return 2;
+}
+function fromMinorUnits(amount, currency, convention) {
+	if (!Number.isFinite(amount)) throw new RangeError(`Érvénytelen összeg (minor unit): ${amount}`);
+	const exponent = currencyExponent(currency, convention);
+	return require_rounding.roundMoney(amount / 10 ** exponent, exponent);
+}
+function parseDecimalAmount(value) {
+	const trimmed = value.trim();
+	if (!/^-?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed)) throw new RangeError(`Érvénytelen decimális összeg: "${value}"`);
+	return Number(trimmed);
+}
+function normalizeCurrency(currency) {
+	return currency.trim().toUpperCase();
+}
+//#endregion
+//#region src/payments/errors.ts
+var WebhookVerificationError = class extends Error {
+	name = "WebhookVerificationError";
+	provider;
+	reason;
+	constructor(provider, reason, message) {
+		super(message);
+		this.provider = provider;
+		this.reason = reason;
+	}
+};
+var PaymentProviderError = class extends Error {
+	name = "PaymentProviderError";
+	provider;
+	status;
+	constructor(provider, message, status, cause) {
+		super(message, cause === void 0 ? void 0 : { cause });
+		this.provider = provider;
+		this.status = status;
+	}
+};
+function isWebhookVerificationError(error) {
+	return error instanceof WebhookVerificationError;
+}
+//#endregion
+//#region src/payments/body.ts
+const DEFAULT_MAX_WEBHOOK_BYTES = 1048576;
+function tooLarge(provider, maxBytes) {
+	return new WebhookVerificationError(provider, "payload_too_large", `A webhook törzse nagyobb a megengedett ${maxBytes} bájtnál.`);
+}
+function readRawBody(request, provider, maxBytes = DEFAULT_MAX_WEBHOOK_BYTES) {
+	return require_request_body.readRequestText(request, maxBytes, () => tooLarge(provider, maxBytes));
+}
+function parseJsonObject(provider, payload) {
+	let parsed;
+	try {
+		parsed = JSON.parse(payload);
+	} catch (error) {
+		throw new WebhookVerificationError(provider, "invalid_payload", `A webhook törzse nem érvényes JSON: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new WebhookVerificationError(provider, "invalid_payload", "A webhook törzse nem JSON objektum.");
+	return parsed;
+}
+function plainResponse(status, body) {
+	return new Response(body, {
+		status,
+		headers: { "content-type": "text/plain; charset=utf-8" }
+	});
+}
+//#endregion
+//#region src/payments/webhook.ts
+function reportError(onError, error) {
+	try {
+		if (onError) onError(error);
+		else console.error("[kassza] A fizetési webhook feldolgozása nem sikerült.", error);
+	} catch {
+		return;
+	}
+}
+async function respondToWebhook(options, run) {
+	try {
+		return await run();
+	} catch (error) {
+		if (error instanceof WebhookVerificationError) return plainResponse(400, error.message);
+		reportError(options.onError, error);
+		return plainResponse(500, "A webhook feldolgozása nem sikerült.");
+	}
+}
+//#endregion
+Object.defineProperty(exports, "DEFAULT_MAX_WEBHOOK_BYTES", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_MAX_WEBHOOK_BYTES;
+	}
+});
+Object.defineProperty(exports, "PaymentProviderError", {
+	enumerable: true,
+	get: function() {
+		return PaymentProviderError;
+	}
+});
+Object.defineProperty(exports, "WebhookVerificationError", {
+	enumerable: true,
+	get: function() {
+		return WebhookVerificationError;
+	}
+});
+Object.defineProperty(exports, "currencyExponent", {
+	enumerable: true,
+	get: function() {
+		return currencyExponent;
+	}
+});
+Object.defineProperty(exports, "fromMinorUnits", {
+	enumerable: true,
+	get: function() {
+		return fromMinorUnits;
+	}
+});
+Object.defineProperty(exports, "isWebhookVerificationError", {
+	enumerable: true,
+	get: function() {
+		return isWebhookVerificationError;
+	}
+});
+Object.defineProperty(exports, "normalizeCurrency", {
+	enumerable: true,
+	get: function() {
+		return normalizeCurrency;
+	}
+});
+Object.defineProperty(exports, "parseDecimalAmount", {
+	enumerable: true,
+	get: function() {
+		return parseDecimalAmount;
+	}
+});
+Object.defineProperty(exports, "parseJsonObject", {
+	enumerable: true,
+	get: function() {
+		return parseJsonObject;
+	}
+});
+Object.defineProperty(exports, "plainResponse", {
+	enumerable: true,
+	get: function() {
+		return plainResponse;
+	}
+});
+Object.defineProperty(exports, "readRawBody", {
+	enumerable: true,
+	get: function() {
+		return readRawBody;
+	}
+});
+Object.defineProperty(exports, "respondToWebhook", {
+	enumerable: true,
+	get: function() {
+		return respondToWebhook;
+	}
+});

package/dist/webhook-CpCMHhn2.d.ts

@@ -0,0 +1,6 @@
+import { l as PaymentWebhookBaseOptions } from "./types-BVeR7KyU.js";
+//#region src/payments/webhook.d.ts
+type WebhookHandler = (request: Request) => Promise<Response>;
+declare function respondToWebhook(options: Pick<PaymentWebhookBaseOptions, "onError">, run: () => Promise<Response>): Promise<Response>;
+//#endregion
+export { respondToWebhook as n, WebhookHandler as t };

package/dist/webhook-CpMJuP6c.d.cts

@@ -0,0 +1,6 @@
+import { l as PaymentWebhookBaseOptions } from "./types-BVeR7KyU.cjs";
+//#region src/payments/webhook.d.ts
+type WebhookHandler = (request: Request) => Promise<Response>;
+declare function respondToWebhook(options: Pick<PaymentWebhookBaseOptions, "onError">, run: () => Promise<Response>): Promise<Response>;
+//#endregion
+export { respondToWebhook as n, WebhookHandler as t };

package/dist/webhook-CrEGohbg.js

@@ -0,0 +1,152 @@
+import { r as roundMoney } from "./rounding-BLyHjjI5.js";
+import { t as readRequestText } from "./request-body-uZHMRlQr.js";
+//#region src/payments/amounts.ts
+const ISO_ZERO_DECIMAL = /* @__PURE__ */ new Set([
+	"BIF",
+	"CLP",
+	"DJF",
+	"GNF",
+	"ISK",
+	"JPY",
+	"KMF",
+	"KRW",
+	"PYG",
+	"RWF",
+	"UGX",
+	"UYI",
+	"VND",
+	"VUV",
+	"XAF",
+	"XOF",
+	"XPF"
+]);
+const ISO_THREE_DECIMAL = /* @__PURE__ */ new Set([
+	"BHD",
+	"IQD",
+	"JOD",
+	"KWD",
+	"LYD",
+	"OMR",
+	"TND"
+]);
+const ISO_FOUR_DECIMAL = /* @__PURE__ */ new Set(["CLF", "UYW"]);
+const STRIPE_ZERO_DECIMAL = /* @__PURE__ */ new Set([
+	"BIF",
+	"CLP",
+	"DJF",
+	"GNF",
+	"JPY",
+	"KMF",
+	"KRW",
+	"MGA",
+	"PYG",
+	"RWF",
+	"VND",
+	"VUV",
+	"XAF",
+	"XOF",
+	"XPF"
+]);
+const STRIPE_THREE_DECIMAL = /* @__PURE__ */ new Set([
+	"BHD",
+	"JOD",
+	"KWD",
+	"OMR",
+	"TND"
+]);
+function currencyExponent(currency, convention) {
+	const code = currency.trim().toUpperCase();
+	if (convention === "stripe") {
+		if (STRIPE_ZERO_DECIMAL.has(code)) return 0;
+		if (STRIPE_THREE_DECIMAL.has(code)) return 3;
+		return 2;
+	}
+	if (ISO_ZERO_DECIMAL.has(code)) return 0;
+	if (ISO_THREE_DECIMAL.has(code)) return 3;
+	if (ISO_FOUR_DECIMAL.has(code)) return 4;
+	return 2;
+}
+function fromMinorUnits(amount, currency, convention) {
+	if (!Number.isFinite(amount)) throw new RangeError(`Érvénytelen összeg (minor unit): ${amount}`);
+	const exponent = currencyExponent(currency, convention);
+	return roundMoney(amount / 10 ** exponent, exponent);
+}
+function parseDecimalAmount(value) {
+	const trimmed = value.trim();
+	if (!/^-?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed)) throw new RangeError(`Érvénytelen decimális összeg: "${value}"`);
+	return Number(trimmed);
+}
+function normalizeCurrency(currency) {
+	return currency.trim().toUpperCase();
+}
+//#endregion
+//#region src/payments/errors.ts
+var WebhookVerificationError = class extends Error {
+	name = "WebhookVerificationError";
+	provider;
+	reason;
+	constructor(provider, reason, message) {
+		super(message);
+		this.provider = provider;
+		this.reason = reason;
+	}
+};
+var PaymentProviderError = class extends Error {
+	name = "PaymentProviderError";
+	provider;
+	status;
+	constructor(provider, message, status, cause) {
+		super(message, cause === void 0 ? void 0 : { cause });
+		this.provider = provider;
+		this.status = status;
+	}
+};
+function isWebhookVerificationError(error) {
+	return error instanceof WebhookVerificationError;
+}
+//#endregion
+//#region src/payments/body.ts
+const DEFAULT_MAX_WEBHOOK_BYTES = 1048576;
+function tooLarge(provider, maxBytes) {
+	return new WebhookVerificationError(provider, "payload_too_large", `A webhook törzse nagyobb a megengedett ${maxBytes} bájtnál.`);
+}
+function readRawBody(request, provider, maxBytes = DEFAULT_MAX_WEBHOOK_BYTES) {
+	return readRequestText(request, maxBytes, () => tooLarge(provider, maxBytes));
+}
+function parseJsonObject(provider, payload) {
+	let parsed;
+	try {
+		parsed = JSON.parse(payload);
+	} catch (error) {
+		throw new WebhookVerificationError(provider, "invalid_payload", `A webhook törzse nem érvényes JSON: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new WebhookVerificationError(provider, "invalid_payload", "A webhook törzse nem JSON objektum.");
+	return parsed;
+}
+function plainResponse(status, body) {
+	return new Response(body, {
+		status,
+		headers: { "content-type": "text/plain; charset=utf-8" }
+	});
+}
+//#endregion
+//#region src/payments/webhook.ts
+function reportError(onError, error) {
+	try {
+		if (onError) onError(error);
+		else console.error("[kassza] A fizetési webhook feldolgozása nem sikerült.", error);
+	} catch {
+		return;
+	}
+}
+async function respondToWebhook(options, run) {
+	try {
+		return await run();
+	} catch (error) {
+		if (error instanceof WebhookVerificationError) return plainResponse(400, error.message);
+		reportError(options.onError, error);
+		return plainResponse(500, "A webhook feldolgozása nem sikerült.");
+	}
+}
+//#endregion
+export { readRawBody as a, isWebhookVerificationError as c, normalizeCurrency as d, parseDecimalAmount as f, plainResponse as i, currencyExponent as l, DEFAULT_MAX_WEBHOOK_BYTES as n, PaymentProviderError as o, parseJsonObject as r, WebhookVerificationError as s, respondToWebhook as t, fromMinorUnits as u };

package/llms.txt

@@ -1,13 +1,13 @@
 # kassza
 
-> Zero-dependency TypeScript client for the Számlázz.hu Számla Agent API (Hungarian invoicing): invoices, proformas, receipts, reversals, payments, PDFs, NAV taxpayer lookup, IPN webhooks. Unofficial.
+> Zero-dependency TypeScript client for the Számlázz.hu Számla Agent API (Hungarian invoicing): invoices, proformas, receipts, reversals, payments, PDFs, NAV taxpayer lookup, IPN webhooks. Also: exactly-once documents from Stripe, SimplePay, Barion, Revolut and PayPal payments, NAV daily receipt reports, delegated invoicing, the Számlázz.hu data link, a fake Számla Agent for tests, a CLI and an MCP server. Unofficial.
 
 ## Docs for coding agents
 
 - [Start here](agents/README.md): overview, the five rules, vocabulary
-- [Pitfalls](agents/pitfalls.md): hard rules and error categories
-- [API reference](agents/api.md): every method, input and output
-- [Recipes](agents/recipes.md): webhooks, idempotency, receipts, IPN, storage, serverless, tests
+- [Pitfalls](agents/pitfalls.md): hard rules, legal rules for receipts, error categories
+- [API reference](agents/api.md): every method, input and output, all subpath modules
+- [Recipes](agents/recipes.md): webhooks, exactly-once invoicing, receipts, IPN, storage, serverless, tests, payment providers, NAV reports, delegated invoicing, data link, MCP
 - [Claude Code skill](agents/skills/kassza/SKILL.md)
 
 ## Human docs