kassza 0.12.0 → 0.14.0

package/dist/{types-COf1LAD-.d.ts → types-B1A8mUIE.d.cts}

@@ -1,5 +1,7 @@
+import { t as KasszaWarning } from "./warnings-B3DXnveC.cjs";
+import { n as KeyValueStore } from "./store-C1rHd9DB.cjs";
 //#region src/payments/types.d.ts
-type PaymentProvider = "stripe" | "simplepay" | "barion" | "revolut" | "paypal";
+type PaymentProvider = "stripe" | "simplepay" | "barion" | "revolut" | "paypal" | (string & {});
 type PaymentEventKind = "paid" | "refunded" | "partially-refunded" | "failed" | "other";
 interface PaymentAmount {
   readonly value: number;
@@ -29,6 +31,12 @@ interface PaymentLineItem {
   readonly sku?: string | undefined;
   readonly vatPercent?: number | undefined;
 }
+interface PaymentRefund {
+  readonly id: string;
+  readonly amount: PaymentAmount;
+  readonly refundedBefore?: number | undefined;
+  readonly createdAt?: string | undefined;
+}
 interface PaymentEvent {
   readonly provider: PaymentProvider;
   readonly kind: PaymentEventKind;
@@ -38,6 +46,7 @@ interface PaymentEvent {
   readonly orderRef?: string | undefined;
   readonly amount?: PaymentAmount | undefined;
   readonly refundedAmount?: PaymentAmount | undefined;
+  readonly refunds?: readonly PaymentRefund[] | undefined;
   readonly paidAt?: string | undefined;
   readonly method: string;
   readonly customer?: PaymentCustomer | undefined;
@@ -48,9 +57,12 @@ type PaymentHandler = (payment: PaymentEvent) => unknown;
 interface PaymentWebhookBaseOptions {
   readonly onPayment: PaymentHandler;
   readonly onError?: ((error: unknown) => void) | undefined;
+  readonly onWarning?: ((warning: KasszaWarning) => void) | undefined;
+  readonly dedupe?: KeyValueStore | undefined;
+  readonly dedupeTtlSeconds?: number | undefined;
   readonly maxBodyBytes?: number | undefined;
   readonly method?: string | undefined;
   readonly fetch?: typeof globalThis.fetch | undefined;
 }
 //#endregion
-export { PaymentEventKind as a, PaymentProvider as c, PaymentEvent as i, PaymentWebhookBaseOptions as l, PaymentAmount as n, PaymentHandler as o, PaymentCustomer as r, PaymentLineItem as s, PaymentAddress as t };
+export { PaymentEventKind as a, PaymentProvider as c, PaymentEvent as i, PaymentRefund as l, PaymentAmount as n, PaymentHandler as o, PaymentCustomer as r, PaymentLineItem as s, PaymentAddress as t, PaymentWebhookBaseOptions as u };

package/dist/{types-COf1LAD-.d.cts → types-ByAEvGsZ.d.ts}

@@ -1,5 +1,7 @@
+import { t as KasszaWarning } from "./warnings-B3DXnveC.js";
+import { n as KeyValueStore } from "./store-C1rHd9DB.js";
 //#region src/payments/types.d.ts
-type PaymentProvider = "stripe" | "simplepay" | "barion" | "revolut" | "paypal";
+type PaymentProvider = "stripe" | "simplepay" | "barion" | "revolut" | "paypal" | (string & {});
 type PaymentEventKind = "paid" | "refunded" | "partially-refunded" | "failed" | "other";
 interface PaymentAmount {
   readonly value: number;
@@ -29,6 +31,12 @@ interface PaymentLineItem {
   readonly sku?: string | undefined;
   readonly vatPercent?: number | undefined;
 }
+interface PaymentRefund {
+  readonly id: string;
+  readonly amount: PaymentAmount;
+  readonly refundedBefore?: number | undefined;
+  readonly createdAt?: string | undefined;
+}
 interface PaymentEvent {
   readonly provider: PaymentProvider;
   readonly kind: PaymentEventKind;
@@ -38,6 +46,7 @@ interface PaymentEvent {
   readonly orderRef?: string | undefined;
   readonly amount?: PaymentAmount | undefined;
   readonly refundedAmount?: PaymentAmount | undefined;
+  readonly refunds?: readonly PaymentRefund[] | undefined;
   readonly paidAt?: string | undefined;
   readonly method: string;
   readonly customer?: PaymentCustomer | undefined;
@@ -48,9 +57,12 @@ type PaymentHandler = (payment: PaymentEvent) => unknown;
 interface PaymentWebhookBaseOptions {
   readonly onPayment: PaymentHandler;
   readonly onError?: ((error: unknown) => void) | undefined;
+  readonly onWarning?: ((warning: KasszaWarning) => void) | undefined;
+  readonly dedupe?: KeyValueStore | undefined;
+  readonly dedupeTtlSeconds?: number | undefined;
   readonly maxBodyBytes?: number | undefined;
   readonly method?: string | undefined;
   readonly fetch?: typeof globalThis.fetch | undefined;
 }
 //#endregion
-export { PaymentEventKind as a, PaymentProvider as c, PaymentEvent as i, PaymentWebhookBaseOptions as l, PaymentAmount as n, PaymentHandler as o, PaymentCustomer as r, PaymentLineItem as s, PaymentAddress as t };
+export { PaymentEventKind as a, PaymentProvider as c, PaymentEvent as i, PaymentRefund as l, PaymentAmount as n, PaymentHandler as o, PaymentCustomer as r, PaymentLineItem as s, PaymentAddress as t, PaymentWebhookBaseOptions as u };

package/dist/{types-k--zHf4l.d.ts → types-D1zDOH_F.d.ts}

@@ -1,4 +1,4 @@
-import { _ as VatRate, s as ItemPriceInput } from "./index-CYAGCdKJ.js";
+import { S as VatRate, f as ItemPriceInput } from "./index-C-7yWV7L.js";
 //#region src/receipts/types.d.ts
 declare const RECEIPT_ONLY_VAT_CODES: readonly ["ÁKK", "MAA", "EU", "EUK"];
 type ReceiptOnlyVatCode = (typeof RECEIPT_ONLY_VAT_CODES)[number];

package/dist/{types-DH8QoNZK.d.cts → types-lnKkQdot.d.cts}

@@ -1,4 +1,4 @@
-import { _ as VatRate, s as ItemPriceInput } from "./index-CYAGCdKJ.cjs";
+import { S as VatRate, f as ItemPriceInput } from "./index-C-7yWV7L.cjs";
 //#region src/receipts/types.d.ts
 declare const RECEIPT_ONLY_VAT_CODES: readonly ["ÁKK", "MAA", "EU", "EUK"];
 type ReceiptOnlyVatCode = (typeof RECEIPT_ONLY_VAT_CODES)[number];

package/dist/warnings-B3DXnveC.d.cts

@@ -0,0 +1,31 @@
+//#region src/core/actions.d.ts
+declare const SZAMLAZZ_AGENT_URL = "https://www.szamlazz.hu/szamla/";
+declare const AGENT_ACTIONS: {
+  readonly createInvoice: "action-xmlagentxmlfile";
+  readonly reverseInvoice: "action-szamla_agent_st";
+  readonly registerPayment: "action-szamla_agent_kifiz";
+  readonly getInvoicePdf: "action-szamla_agent_pdf";
+  readonly getInvoiceXml: "action-szamla_agent_xml";
+  readonly deleteProforma: "action-szamla_agent_dijbekero_torlese";
+  readonly createReceipt: "action-szamla_agent_nyugta_create";
+  readonly reverseReceipt: "action-szamla_agent_nyugta_storno";
+  readonly getReceipt: "action-szamla_agent_nyugta_get";
+  readonly sendReceipt: "action-szamla_agent_nyugta_send";
+  readonly queryTaxpayer: "action-szamla_agent_taxpayer";
+  readonly connectPrincipal: "action-agent_ceg_mb";
+};
+type AgentAction = keyof typeof AGENT_ACTIONS;
+declare const MAX_INVOICE_ATTACHMENTS = 5;
+//#endregion
+//#region src/core/warnings.d.ts
+type KasszaWarningKind = "session" | "ledger" | "hook" | "document" | "lock" | "dedupe" | "cache";
+interface KasszaWarning {
+  readonly kind: KasszaWarningKind;
+  readonly message: string;
+  readonly error: unknown;
+  readonly action?: AgentAction | undefined;
+  readonly operation?: string | undefined;
+}
+type WarningHook = (warning: KasszaWarning) => void;
+//#endregion
+export { AgentAction as a, AGENT_ACTIONS as i, KasszaWarningKind as n, MAX_INVOICE_ATTACHMENTS as o, WarningHook as r, SZAMLAZZ_AGENT_URL as s, KasszaWarning as t };

package/dist/warnings-B3DXnveC.d.ts

@@ -0,0 +1,31 @@
+//#region src/core/actions.d.ts
+declare const SZAMLAZZ_AGENT_URL = "https://www.szamlazz.hu/szamla/";
+declare const AGENT_ACTIONS: {
+  readonly createInvoice: "action-xmlagentxmlfile";
+  readonly reverseInvoice: "action-szamla_agent_st";
+  readonly registerPayment: "action-szamla_agent_kifiz";
+  readonly getInvoicePdf: "action-szamla_agent_pdf";
+  readonly getInvoiceXml: "action-szamla_agent_xml";
+  readonly deleteProforma: "action-szamla_agent_dijbekero_torlese";
+  readonly createReceipt: "action-szamla_agent_nyugta_create";
+  readonly reverseReceipt: "action-szamla_agent_nyugta_storno";
+  readonly getReceipt: "action-szamla_agent_nyugta_get";
+  readonly sendReceipt: "action-szamla_agent_nyugta_send";
+  readonly queryTaxpayer: "action-szamla_agent_taxpayer";
+  readonly connectPrincipal: "action-agent_ceg_mb";
+};
+type AgentAction = keyof typeof AGENT_ACTIONS;
+declare const MAX_INVOICE_ATTACHMENTS = 5;
+//#endregion
+//#region src/core/warnings.d.ts
+type KasszaWarningKind = "session" | "ledger" | "hook" | "document" | "lock" | "dedupe" | "cache";
+interface KasszaWarning {
+  readonly kind: KasszaWarningKind;
+  readonly message: string;
+  readonly error: unknown;
+  readonly action?: AgentAction | undefined;
+  readonly operation?: string | undefined;
+}
+type WarningHook = (warning: KasszaWarning) => void;
+//#endregion
+export { AgentAction as a, AGENT_ACTIONS as i, KasszaWarningKind as n, MAX_INVOICE_ATTACHMENTS as o, WarningHook as r, SZAMLAZZ_AGENT_URL as s, KasszaWarning as t };

package/dist/warnings-DeIw5RFj.cjs

@@ -0,0 +1,20 @@
+//#region src/core/warnings.ts
+function emitWarning(hook, warning, fallback = "silent") {
+	if (!hook) {
+		if (fallback === "console") console.warn(`[szamlazz] ${warning.message}`, warning.error);
+		return;
+	}
+	try {
+		const result = hook(warning);
+		if (result instanceof Promise) result.catch(() => void 0);
+	} catch {
+		return;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "emitWarning", {
+	enumerable: true,
+	get: function() {
+		return emitWarning;
+	}
+});

package/dist/warnings-DwTl5J-2.js

@@ -0,0 +1,15 @@
+//#region src/core/warnings.ts
+function emitWarning(hook, warning, fallback = "silent") {
+	if (!hook) {
+		if (fallback === "console") console.warn(`[szamlazz] ${warning.message}`, warning.error);
+		return;
+	}
+	try {
+		const result = hook(warning);
+		if (result instanceof Promise) result.catch(() => void 0);
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { emitWarning as t };

package/dist/{webhook-D4lvtex1.js → webhook-CQVShAfI.js}

@@ -1,5 +1,6 @@
-import { r as decodeUtf8 } from "./binary-D0M9U2MD.js";
+import { t as emitWarning } from "./warnings-DwTl5J-2.js";
 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",
@@ -110,30 +111,8 @@ 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.`);
 }
-async function readRawBody(request, provider, maxBytes = DEFAULT_MAX_WEBHOOK_BYTES) {
-	const declared = Number(request.headers.get("content-length"));
-	if (Number.isFinite(declared) && declared > maxBytes) throw tooLarge(provider, maxBytes);
-	if (!request.body) return "";
-	const reader = request.body.getReader();
-	const chunks = [];
-	let total = 0;
-	for (;;) {
-		const chunk = await reader.read();
-		if (chunk.done) break;
-		total += chunk.value.byteLength;
-		if (total > maxBytes) {
-			await reader.cancel().catch(() => void 0);
-			throw tooLarge(provider, maxBytes);
-		}
-		chunks.push(chunk.value);
-	}
-	const bytes = new Uint8Array(total);
-	let offset = 0;
-	for (const chunk of chunks) {
-		bytes.set(chunk, offset);
-		offset += chunk.byteLength;
-	}
-	return decodeUtf8(bytes);
+function readRawBody(request, provider, maxBytes = DEFAULT_MAX_WEBHOOK_BYTES) {
+	return readRequestText(request, maxBytes, () => tooLarge(provider, maxBytes));
 }
 function parseJsonObject(provider, payload) {
 	let parsed;
@@ -153,6 +132,8 @@ function plainResponse(status, body) {
 }
 //#endregion
 //#region src/payments/webhook.ts
+const WEBHOOK_DEDUPE_KEY_PREFIX = "szamlazz:evt:";
+const DEFAULT_DEDUPE_TTL_SECONDS = 604800;
 function reportError(onError, error) {
 	try {
 		if (onError) onError(error);
@@ -170,5 +151,45 @@ async function respondToWebhook(options, run) {
 		return plainResponse(500, "A webhook feldolgozása nem sikerült.");
 	}
 }
+function webhookDedupeKey(payment) {
+	return `${WEBHOOK_DEDUPE_KEY_PREFIX}${payment.provider}:${payment.eventId ?? ""}`;
+}
+function resolveDedupeTtl(value) {
+	if (value === void 0) return DEFAULT_DEDUPE_TTL_SECONDS;
+	if (!Number.isFinite(value) || value < 1) throw new TypeError(`A dedupeTtlSeconds legalább 1 másodperc legyen, kapott: ${String(value)}`);
+	return Math.ceil(value);
+}
+function dedupeWarning(options, operation, key, error) {
+	const message = operation === "get" ? `A webhook ismétlés-szűrő tárolója nem olvasható (${key}), a kassza feldolgozza az eseményt; a createOnce így is megakadályozza a dupla bizonylatot.` : `A webhook ismétlés-szűrő nem tudta megjelölni a feldolgozott eseményt (${key}); egy újraküldés ismét feldolgozásra kerül, de a createOnce nem állít ki duplát.`;
+	emitWarning(options.onWarning, {
+		kind: "dedupe",
+		message,
+		error,
+		operation
+	}, "console");
+}
+async function deliverPayment(options, payment, prepare = (value) => value) {
+	const store = options.dedupe;
+	if (!store || !payment.eventId) {
+		await options.onPayment(await prepare(payment));
+		return true;
+	}
+	const ttlSeconds = resolveDedupeTtl(options.dedupeTtlSeconds);
+	const key = webhookDedupeKey(payment);
+	let seen = false;
+	try {
+		seen = Boolean(await store.get(key));
+	} catch (error) {
+		dedupeWarning(options, "get", key, error);
+	}
+	if (seen) return false;
+	await options.onPayment(await prepare(payment));
+	try {
+		await store.set(key, "1", ttlSeconds);
+	} catch (error) {
+		dedupeWarning(options, "set", key, error);
+	}
+	return true;
+}
 //#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 };
+export { webhookDedupeKey as a, plainResponse as c, WebhookVerificationError as d, isWebhookVerificationError as f, parseDecimalAmount as g, normalizeCurrency as h, respondToWebhook as i, readRawBody as l, fromMinorUnits as m, WEBHOOK_DEDUPE_KEY_PREFIX as n, DEFAULT_MAX_WEBHOOK_BYTES as o, currencyExponent as p, deliverPayment as r, parseJsonObject as s, DEFAULT_DEDUPE_TTL_SECONDS as t, PaymentProviderError as u };

package/dist/{webhook-C76bV-4R.cjs → webhook-Ckj-_hPD.cjs}

@@ -1,5 +1,6 @@
-const require_binary = require("./binary-B89HM03_.cjs");
+const require_warnings = require("./warnings-DeIw5RFj.cjs");
 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",
@@ -110,30 +111,8 @@ 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.`);
 }
-async function readRawBody(request, provider, maxBytes = DEFAULT_MAX_WEBHOOK_BYTES) {
-	const declared = Number(request.headers.get("content-length"));
-	if (Number.isFinite(declared) && declared > maxBytes) throw tooLarge(provider, maxBytes);
-	if (!request.body) return "";
-	const reader = request.body.getReader();
-	const chunks = [];
-	let total = 0;
-	for (;;) {
-		const chunk = await reader.read();
-		if (chunk.done) break;
-		total += chunk.value.byteLength;
-		if (total > maxBytes) {
-			await reader.cancel().catch(() => void 0);
-			throw tooLarge(provider, maxBytes);
-		}
-		chunks.push(chunk.value);
-	}
-	const bytes = new Uint8Array(total);
-	let offset = 0;
-	for (const chunk of chunks) {
-		bytes.set(chunk, offset);
-		offset += chunk.byteLength;
-	}
-	return require_binary.decodeUtf8(bytes);
+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;
@@ -153,6 +132,8 @@ function plainResponse(status, body) {
 }
 //#endregion
 //#region src/payments/webhook.ts
+const WEBHOOK_DEDUPE_KEY_PREFIX = "szamlazz:evt:";
+const DEFAULT_DEDUPE_TTL_SECONDS = 604800;
 function reportError(onError, error) {
 	try {
 		if (onError) onError(error);
@@ -170,7 +151,53 @@ async function respondToWebhook(options, run) {
 		return plainResponse(500, "A webhook feldolgozása nem sikerült.");
 	}
 }
+function webhookDedupeKey(payment) {
+	return `${WEBHOOK_DEDUPE_KEY_PREFIX}${payment.provider}:${payment.eventId ?? ""}`;
+}
+function resolveDedupeTtl(value) {
+	if (value === void 0) return DEFAULT_DEDUPE_TTL_SECONDS;
+	if (!Number.isFinite(value) || value < 1) throw new TypeError(`A dedupeTtlSeconds legalább 1 másodperc legyen, kapott: ${String(value)}`);
+	return Math.ceil(value);
+}
+function dedupeWarning(options, operation, key, error) {
+	const message = operation === "get" ? `A webhook ismétlés-szűrő tárolója nem olvasható (${key}), a kassza feldolgozza az eseményt; a createOnce így is megakadályozza a dupla bizonylatot.` : `A webhook ismétlés-szűrő nem tudta megjelölni a feldolgozott eseményt (${key}); egy újraküldés ismét feldolgozásra kerül, de a createOnce nem állít ki duplát.`;
+	require_warnings.emitWarning(options.onWarning, {
+		kind: "dedupe",
+		message,
+		error,
+		operation
+	}, "console");
+}
+async function deliverPayment(options, payment, prepare = (value) => value) {
+	const store = options.dedupe;
+	if (!store || !payment.eventId) {
+		await options.onPayment(await prepare(payment));
+		return true;
+	}
+	const ttlSeconds = resolveDedupeTtl(options.dedupeTtlSeconds);
+	const key = webhookDedupeKey(payment);
+	let seen = false;
+	try {
+		seen = Boolean(await store.get(key));
+	} catch (error) {
+		dedupeWarning(options, "get", key, error);
+	}
+	if (seen) return false;
+	await options.onPayment(await prepare(payment));
+	try {
+		await store.set(key, "1", ttlSeconds);
+	} catch (error) {
+		dedupeWarning(options, "set", key, error);
+	}
+	return true;
+}
 //#endregion
+Object.defineProperty(exports, "DEFAULT_DEDUPE_TTL_SECONDS", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_DEDUPE_TTL_SECONDS;
+	}
+});
 Object.defineProperty(exports, "DEFAULT_MAX_WEBHOOK_BYTES", {
 	enumerable: true,
 	get: function() {
@@ -183,6 +210,12 @@ Object.defineProperty(exports, "PaymentProviderError", {
 		return PaymentProviderError;
 	}
 });
+Object.defineProperty(exports, "WEBHOOK_DEDUPE_KEY_PREFIX", {
+	enumerable: true,
+	get: function() {
+		return WEBHOOK_DEDUPE_KEY_PREFIX;
+	}
+});
 Object.defineProperty(exports, "WebhookVerificationError", {
 	enumerable: true,
 	get: function() {
@@ -195,6 +228,12 @@ Object.defineProperty(exports, "currencyExponent", {
 		return currencyExponent;
 	}
 });
+Object.defineProperty(exports, "deliverPayment", {
+	enumerable: true,
+	get: function() {
+		return deliverPayment;
+	}
+});
 Object.defineProperty(exports, "fromMinorUnits", {
 	enumerable: true,
 	get: function() {
@@ -243,3 +282,9 @@ Object.defineProperty(exports, "respondToWebhook", {
 		return respondToWebhook;
 	}
 });
+Object.defineProperty(exports, "webhookDedupeKey", {
+	enumerable: true,
+	get: function() {
+		return webhookDedupeKey;
+	}
+});

package/dist/webhook-CmdhGiH5.d.cts

@@ -0,0 +1,11 @@
+import { i as PaymentEvent, u as PaymentWebhookBaseOptions } from "./types-B1A8mUIE.cjs";
+//#region src/payments/webhook.d.ts
+declare const WEBHOOK_DEDUPE_KEY_PREFIX = "szamlazz:evt:";
+declare const DEFAULT_DEDUPE_TTL_SECONDS: number;
+type WebhookHandler = (request: Request) => Promise<Response>;
+declare function respondToWebhook(options: Pick<PaymentWebhookBaseOptions, "onError">, run: () => Promise<Response>): Promise<Response>;
+type DedupeOptions = Pick<PaymentWebhookBaseOptions, "onPayment" | "onWarning" | "dedupe" | "dedupeTtlSeconds">;
+declare function webhookDedupeKey(payment: Pick<PaymentEvent, "provider" | "eventId">): string;
+declare function deliverPayment(options: DedupeOptions, payment: PaymentEvent, prepare?: (payment: PaymentEvent) => PaymentEvent | Promise<PaymentEvent>): Promise<boolean>;
+//#endregion
+export { respondToWebhook as a, deliverPayment as i, WEBHOOK_DEDUPE_KEY_PREFIX as n, webhookDedupeKey as o, WebhookHandler as r, DEFAULT_DEDUPE_TTL_SECONDS as t };

package/dist/webhook-D6lEejob.d.ts

@@ -0,0 +1,11 @@
+import { i as PaymentEvent, u as PaymentWebhookBaseOptions } from "./types-ByAEvGsZ.js";
+//#region src/payments/webhook.d.ts
+declare const WEBHOOK_DEDUPE_KEY_PREFIX = "szamlazz:evt:";
+declare const DEFAULT_DEDUPE_TTL_SECONDS: number;
+type WebhookHandler = (request: Request) => Promise<Response>;
+declare function respondToWebhook(options: Pick<PaymentWebhookBaseOptions, "onError">, run: () => Promise<Response>): Promise<Response>;
+type DedupeOptions = Pick<PaymentWebhookBaseOptions, "onPayment" | "onWarning" | "dedupe" | "dedupeTtlSeconds">;
+declare function webhookDedupeKey(payment: Pick<PaymentEvent, "provider" | "eventId">): string;
+declare function deliverPayment(options: DedupeOptions, payment: PaymentEvent, prepare?: (payment: PaymentEvent) => PaymentEvent | Promise<PaymentEvent>): Promise<boolean>;
+//#endregion
+export { respondToWebhook as a, deliverPayment as i, WEBHOOK_DEDUPE_KEY_PREFIX as n, webhookDedupeKey as o, WebhookHandler as r, DEFAULT_DEDUPE_TTL_SECONDS as t };

package/llms.txt

@@ -1,16 +1,17 @@
 # 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. Also: cross-process exactly-once locks, a receipt journal for NAV reports, partial refunds as corrective invoices, bulk/recurring invoicing, Express adapter, observability without telemetry. 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, receipt journal, monthly invoicing, observability
 - [Claude Code skill](agents/skills/kassza/SKILL.md)
+- [Migration skill from szamlazz.js](agents/skills/migrate-from-szamlazz-js/SKILL.md)
 
 ## Human docs
 
 - [README](README.md): short Hungarian quick start
-- [Official Számlázz.hu Agent docs](https://docs.szamlazz.hu/hu/agent/)
+- [Official Számlázz.hu Agent docs](https://docs.szamlazz.hu/hu/agent/)