kassza 0.12.0 → 0.14.0

package/dist/get-CZEShCcj.js

@@ -0,0 +1,260 @@
+import { a as optionalEl, c as childNumber, d as findChildren, l as childText, n as buildXmlDocument, s as childBoolean, u as findChild } from "./serialize-B2eFh3D-.js";
+import { d as throwIfHeaderError, f as throwIfHttpError, h as unexpectedResponse, m as throwIfXmlFailure, p as throwIfTextError, s as parseResponseXml } from "./parse-Cr7yQ3_z.js";
+import { l as resolveInvoiceReference, r as decodeResponsePdf, s as referenceValue, t as AGENT_XSD_BASE_URL } from "./reference-B5TATqb5.js";
+//#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 buildXmlDocument({
+		root: "xmlszamlaxml",
+		namespace: "http://www.szamlazz.hu/xmlszamlaxml",
+		schemaLocation: `${AGENT_XSD_BASE_URL}agentxml/xmlszamlaxml.xsd`,
+		children: [
+			...credentials,
+			optionalEl("szamlaszam", referenceValue(resolved, "invoiceNumber")),
+			optionalEl("rendelesSzam", referenceValue(resolved, "orderNumber")),
+			optionalEl("pdf", query.includePdf),
+			optionalEl("szamlaKulsoAzon", referenceValue(resolved, "externalId"))
+		]
+	});
+}
+var InvoiceReader = class {
+	response;
+	constructor(response) {
+		this.response = response;
+	}
+	missing(path) {
+		return unexpectedResponse(this.response, `Hiányzik a(z) <${path}> elem a számla XML-ből.`);
+	}
+	element(parent, name, path) {
+		const child = findChild(parent, name);
+		if (!child) throw this.missing(path);
+		return child;
+	}
+	text(parent, name, path) {
+		const value = childText(parent, name);
+		if (value === void 0) throw this.missing(`${path}/${name}`);
+		return value;
+	}
+	number(parent, name, path) {
+		const value = childNumber(parent, name);
+		if (value === void 0) throw this.missing(`${path}/${name}`);
+		return value;
+	}
+};
+function readAddress(element) {
+	if (!element) return void 0;
+	return {
+		name: childText(element, "nev"),
+		country: childText(element, "orszag"),
+		zip: childText(element, "irsz"),
+		city: childText(element, "telepules"),
+		address: childText(element, "cim")
+	};
+}
+function readSeller(root, reader) {
+	const seller = reader.element(root, "szallito", "szallito");
+	const bank = findChild(seller, "bank");
+	return {
+		id: childNumber(seller, "id"),
+		name: reader.text(seller, "nev", "szallito"),
+		address: readAddress(findChild(seller, "cim")),
+		postalAddress: readAddress(findChild(seller, "postacim")),
+		taxNumber: childText(seller, "adoszam"),
+		groupTaxNumber: childText(seller, "csoportazonosito"),
+		euTaxNumber: childText(seller, "adoszameu"),
+		bank: bank && {
+			name: childText(bank, "nev"),
+			accountNumber: 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 = childNumber(header, "eszamla");
+	return {
+		id: childNumber(header, "id"),
+		number: reader.text(header, "szamlaszam", "alap"),
+		economicEventId: childNumber(header, "gazdEsemAzon"),
+		sourceSystem: childNumber(header, "forras"),
+		registrationNumber: childText(header, "iktatoszam"),
+		type: DOCUMENT_TYPES_BY_CODE.get(typeCode) ?? "unknown",
+		typeCode,
+		eInvoice: appearanceCode !== void 0 && E_INVOICE_CODES.has(appearanceCode),
+		appearanceCode,
+		referencedInvoiceNumber: childText(header, "hivszamlaszam"),
+		referencedProformaNumber: childText(header, "hivdijbekszam"),
+		issueDate: reader.text(header, "kelt", "alap"),
+		fulfillmentDate: childText(header, "telj"),
+		dueDate: childText(header, "fizh"),
+		paymentMethod: childText(header, "fizmod"),
+		unifiedPaymentMethod: childText(header, "fizmodunified"),
+		cash: childBoolean(header, "keszpenz"),
+		orderNumber: childText(header, "rendelesszam"),
+		language: childText(header, "nyelv"),
+		currency: childText(header, "devizanem"),
+		exchangeBank: childText(header, "devizabank"),
+		exchangeRate: childNumber(header, "devizaarf"),
+		comment: childText(header, "megjegyzes"),
+		vatType: childText(header, "afatipus"),
+		cashAccounting: childBoolean(header, "penzforg"),
+		kata: childBoolean(header, "kata"),
+		kataLedger: childBoolean(header, "katafokonyv"),
+		email: childText(header, "email"),
+		test: childBoolean(header, "teszt"),
+		reversed: childBoolean(header, "sztornozott")
+	};
+}
+function readBuyerLedger(element) {
+	if (!element) return void 0;
+	return {
+		ledgerAccount: childText(element, "vevo"),
+		buyerId: childText(element, "vevoazon"),
+		bookingDate: childText(element, "datum"),
+		continuousFulfillment: childBoolean(element, "folyamatostelj"),
+		settlementPeriodStart: childText(element, "elszDatTol") ?? childText(element, "elszdattol"),
+		settlementPeriodEnd: childText(element, "elszDatIg") ?? childText(element, "elszdatig")
+	};
+}
+function readBuyer(root, reader) {
+	const buyer = reader.element(root, "vevo", "vevo");
+	return {
+		id: childNumber(buyer, "id"),
+		name: reader.text(buyer, "nev", "vevo"),
+		identifier: childText(buyer, "azonosito"),
+		address: readAddress(findChild(buyer, "cim")),
+		postalAddress: readAddress(findChild(buyer, "postacim")),
+		email: childText(buyer, "email"),
+		taxNumber: childText(buyer, "adoszam"),
+		groupTaxNumber: childText(buyer, "csoportazonosito"),
+		euTaxNumber: childText(buyer, "adoszameu"),
+		location: childNumber(buyer, "lokacio"),
+		privatePerson: childBoolean(buyer, "privatePersonIndicator"),
+		ledger: readBuyerLedger(findChild(buyer, "fokonyv"))
+	};
+}
+function readItemLedger(element) {
+	if (!element) return void 0;
+	return {
+		revenueLedgerAccount: childText(element, "arbevetel"),
+		vatLedgerAccount: childText(element, "afa"),
+		economicEvent: childText(element, "gazdasagiesemeny"),
+		vatEconomicEvent: childText(element, "gazdasagiesemenyafa"),
+		settlementPeriodStart: childText(element, "elszdattol"),
+		settlementPeriodEnd: childText(element, "elszdatig")
+	};
+}
+function readItem(item, reader) {
+	const path = "tetelek/tetel";
+	return {
+		name: reader.text(item, "nev", path),
+		identifier: childText(item, "azonosito"),
+		quantity: reader.number(item, "mennyiseg", path),
+		unit: childText(item, "mennyisegiegyseg"),
+		netUnitPrice: reader.number(item, "nettoegysegar", path),
+		vat: reader.number(item, "afakulcs", path),
+		vatCode: childText(item, "afatipus"),
+		netAmount: reader.number(item, "netto", path),
+		marginVatBase: childNumber(item, "arresafaalap"),
+		vatAmount: reader.number(item, "afa", path),
+		grossAmount: reader.number(item, "brutto", path),
+		comment: childText(item, "megjegyzes"),
+		position: childNumber(item, "sztetordering"),
+		ledger: readItemLedger(findChild(item, "fokonyv"))
+	};
+}
+function readLabels(element) {
+	return 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: childText(item, "afatipus"),
+		netAmount: reader.number(item, "netto", path),
+		vatAmount: reader.number(item, "afa", path),
+		grossAmount: reader.number(item, "brutto", path),
+		settlementPeriodStart: childText(item, "elszdattol"),
+		settlementPeriodEnd: childText(item, "elszdatig"),
+		vatDeduction: childNumber(item, "afalevon"),
+		labels: readLabels(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: findChildren(totals, "afakulcsossz").map((entry) => ({
+			vat: reader.number(entry, "afakulcs", "osszegek/afakulcsossz"),
+			vatCode: 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: childText(payment, "megjegyzes"),
+		bankAccountNumber: childText(payment, "bankszamlaszam"),
+		bankTransactionId: childNumber(payment, "banktranzid"),
+		exchangeRate: 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: findChildren(findChild(root, "tetelek"), "tetel").map((item) => readItem(item, reader)),
+		financialItems: findChildren(findChild(root, "qutetek"), "qutet").map((item) => readFinancialItem(item, reader)),
+		labels: readLabels(findChild(root, "cimkek")),
+		totals: readTotals(root, reader),
+		payments: findChildren(findChild(root, "kifizetesek"), "kifizetes").map((payment) => readPayment(payment, reader)),
+		pdf: decodeResponsePdf(root, response)
+	};
+}
+function parseGetInvoiceResponse(response) {
+	throwIfHeaderError(response);
+	throwIfTextError(response);
+	throwIfHttpError(response);
+	const root = parseResponseXml(response);
+	throwIfXmlFailure(root, response);
+	if (root.name !== "szamla") throw 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);
+}
+//#endregion
+export { parseInvoiceDetailsXml as n, getInvoice as t };

package/dist/index-BhUPY_EH.d.cts

@@ -0,0 +1,109 @@
+import { n as KeyValueStore, r as StoreCapabilities } from "./store-C1rHd9DB.cjs";
+import { t as CookieStore } from "./session-YbChChx7.cjs";
+//#region src/cookie-stores/resilient.d.ts
+type CookieStoreOperation = "get" | "set" | "delete" | "setIfAbsent" | "increment" | "deleteIfEquals";
+interface CookieStoreErrorEvent {
+  readonly operation: CookieStoreOperation;
+  readonly key: string;
+  readonly error: unknown;
+}
+interface ResilientCookieStoreOptions {
+  readonly onError?: ((event: CookieStoreErrorEvent) => void) | undefined;
+  readonly timeoutMs?: number | undefined;
+}
+declare function resilientCookieStore(store: CookieStore, options?: ResilientCookieStoreOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/shared.d.ts
+interface CookieStoreAdapterOptions extends ResilientCookieStoreOptions {
+  readonly prefix?: string | undefined;
+  readonly resilient?: boolean | undefined;
+}
+//#endregion
+//#region src/cookie-stores/cloudflare-kv.d.ts
+declare const CLOUDFLARE_KV_MIN_TTL_SECONDS = 60;
+interface CloudflareKvNamespaceLike {
+  get(key: string): Promise<string | null>;
+  put(key: string, value: string, options: {
+    expirationTtl: number;
+  }): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+declare function cloudflareKvCookieStore(namespace: CloudflareKvNamespaceLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/custom.d.ts
+declare function customCookieStore(store: CookieStore, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/ioredis.d.ts
+interface IoRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, expiryMode: "EX", seconds: number): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, numKeys: number, ...args: string[]): Promise<unknown>;
+}
+declare function ioredisCookieStore(redis: IoRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/node-redis.d.ts
+interface NodeRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, options: {
+    EX: number;
+  }): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, options: {
+    keys: string[];
+    arguments: string[];
+  }): Promise<unknown>;
+}
+declare function nodeRedisCookieStore(client: NodeRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/upstash.d.ts
+interface UpstashRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, options: {
+    ex: number;
+  }): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, keys: string[], args: string[]): Promise<unknown>;
+}
+declare function upstashRedisCookieStore(redis: UpstashRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/stores/diagnose.d.ts
+interface StoreSuitability {
+  readonly session: boolean;
+  readonly attemptLedger: boolean;
+  readonly createOnceLock: boolean;
+  readonly journal: boolean;
+  readonly webhookDedupe: boolean;
+}
+interface StoreDiagnosis {
+  readonly ok: boolean;
+  readonly capabilities: StoreCapabilities;
+  readonly suitableFor: StoreSuitability;
+  readonly latencyMs: number;
+  readonly problems: readonly string[];
+}
+interface DiagnoseStoreOptions {
+  readonly keyPrefix?: string | undefined;
+  readonly now?: (() => number) | undefined;
+}
+declare function diagnoseStore(store: KeyValueStore, options?: DiagnoseStoreOptions): Promise<StoreDiagnosis>;
+//#endregion
+//#region src/stores/durable-object.d.ts
+interface DurableObjectStorageLike {
+  get(key: string): Promise<unknown>;
+  put(key: string, value: DurableObjectStoreEntry): Promise<void>;
+  delete(key: string): Promise<boolean>;
+}
+interface DurableObjectStubLike {
+  fetch(input: string, init: RequestInit): Promise<Response>;
+}
+interface DurableObjectStoreEntry {
+  readonly value: string;
+  readonly expiresAt: number;
+}
+type DurableObjectStoreOperation = "get" | "set" | "delete" | "setIfAbsent" | "increment" | "deleteIfEquals";
+declare const DURABLE_OBJECT_STORE_URL = "https://kassza-store.internal/";
+declare function handleDurableObjectStoreRequest(storage: DurableObjectStorageLike, request: Request): Promise<Response>;
+declare function durableObjectStore(stub: DurableObjectStubLike): KeyValueStore;
+//#endregion
+export { CookieStoreErrorEvent as C, resilientCookieStore as E, CookieStoreAdapterOptions as S, ResilientCookieStoreOptions as T, ioredisCookieStore as _, DurableObjectStubLike as a, CloudflareKvNamespaceLike as b, DiagnoseStoreOptions as c, diagnoseStore as d, UpstashRedisLike as f, IoRedisLike as g, nodeRedisCookieStore as h, DurableObjectStoreOperation as i, StoreDiagnosis as l, NodeRedisLike as m, DurableObjectStorageLike as n, durableObjectStore as o, upstashRedisCookieStore as p, DurableObjectStoreEntry as r, handleDurableObjectStoreRequest as s, DURABLE_OBJECT_STORE_URL as t, StoreSuitability as u, customCookieStore as v, CookieStoreOperation as w, cloudflareKvCookieStore as x, CLOUDFLARE_KV_MIN_TTL_SECONDS as y };

package/dist/index-BqGgQ4t3.d.ts

@@ -0,0 +1,109 @@
+import { n as KeyValueStore, r as StoreCapabilities } from "./store-C1rHd9DB.js";
+import { t as CookieStore } from "./session-Ckl5eJhV.js";
+//#region src/cookie-stores/resilient.d.ts
+type CookieStoreOperation = "get" | "set" | "delete" | "setIfAbsent" | "increment" | "deleteIfEquals";
+interface CookieStoreErrorEvent {
+  readonly operation: CookieStoreOperation;
+  readonly key: string;
+  readonly error: unknown;
+}
+interface ResilientCookieStoreOptions {
+  readonly onError?: ((event: CookieStoreErrorEvent) => void) | undefined;
+  readonly timeoutMs?: number | undefined;
+}
+declare function resilientCookieStore(store: CookieStore, options?: ResilientCookieStoreOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/shared.d.ts
+interface CookieStoreAdapterOptions extends ResilientCookieStoreOptions {
+  readonly prefix?: string | undefined;
+  readonly resilient?: boolean | undefined;
+}
+//#endregion
+//#region src/cookie-stores/cloudflare-kv.d.ts
+declare const CLOUDFLARE_KV_MIN_TTL_SECONDS = 60;
+interface CloudflareKvNamespaceLike {
+  get(key: string): Promise<string | null>;
+  put(key: string, value: string, options: {
+    expirationTtl: number;
+  }): Promise<void>;
+  delete(key: string): Promise<void>;
+}
+declare function cloudflareKvCookieStore(namespace: CloudflareKvNamespaceLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/custom.d.ts
+declare function customCookieStore(store: CookieStore, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/ioredis.d.ts
+interface IoRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, expiryMode: "EX", seconds: number): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, numKeys: number, ...args: string[]): Promise<unknown>;
+}
+declare function ioredisCookieStore(redis: IoRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/node-redis.d.ts
+interface NodeRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, options: {
+    EX: number;
+  }): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, options: {
+    keys: string[];
+    arguments: string[];
+  }): Promise<unknown>;
+}
+declare function nodeRedisCookieStore(client: NodeRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/cookie-stores/upstash.d.ts
+interface UpstashRedisLike {
+  get(key: string): Promise<unknown>;
+  set(key: string, value: string, options: {
+    ex: number;
+  }): Promise<unknown>;
+  del(key: string): Promise<unknown>;
+  eval?(script: string, keys: string[], args: string[]): Promise<unknown>;
+}
+declare function upstashRedisCookieStore(redis: UpstashRedisLike, options?: CookieStoreAdapterOptions): CookieStore;
+//#endregion
+//#region src/stores/diagnose.d.ts
+interface StoreSuitability {
+  readonly session: boolean;
+  readonly attemptLedger: boolean;
+  readonly createOnceLock: boolean;
+  readonly journal: boolean;
+  readonly webhookDedupe: boolean;
+}
+interface StoreDiagnosis {
+  readonly ok: boolean;
+  readonly capabilities: StoreCapabilities;
+  readonly suitableFor: StoreSuitability;
+  readonly latencyMs: number;
+  readonly problems: readonly string[];
+}
+interface DiagnoseStoreOptions {
+  readonly keyPrefix?: string | undefined;
+  readonly now?: (() => number) | undefined;
+}
+declare function diagnoseStore(store: KeyValueStore, options?: DiagnoseStoreOptions): Promise<StoreDiagnosis>;
+//#endregion
+//#region src/stores/durable-object.d.ts
+interface DurableObjectStorageLike {
+  get(key: string): Promise<unknown>;
+  put(key: string, value: DurableObjectStoreEntry): Promise<void>;
+  delete(key: string): Promise<boolean>;
+}
+interface DurableObjectStubLike {
+  fetch(input: string, init: RequestInit): Promise<Response>;
+}
+interface DurableObjectStoreEntry {
+  readonly value: string;
+  readonly expiresAt: number;
+}
+type DurableObjectStoreOperation = "get" | "set" | "delete" | "setIfAbsent" | "increment" | "deleteIfEquals";
+declare const DURABLE_OBJECT_STORE_URL = "https://kassza-store.internal/";
+declare function handleDurableObjectStoreRequest(storage: DurableObjectStorageLike, request: Request): Promise<Response>;
+declare function durableObjectStore(stub: DurableObjectStubLike): KeyValueStore;
+//#endregion
+export { CookieStoreErrorEvent as C, resilientCookieStore as E, CookieStoreAdapterOptions as S, ResilientCookieStoreOptions as T, ioredisCookieStore as _, DurableObjectStubLike as a, CloudflareKvNamespaceLike as b, DiagnoseStoreOptions as c, diagnoseStore as d, UpstashRedisLike as f, IoRedisLike as g, nodeRedisCookieStore as h, DurableObjectStoreOperation as i, StoreDiagnosis as l, NodeRedisLike as m, DurableObjectStorageLike as n, durableObjectStore as o, upstashRedisCookieStore as p, DurableObjectStoreEntry as r, handleDurableObjectStoreRequest as s, DURABLE_OBJECT_STORE_URL as t, StoreSuitability as u, customCookieStore as v, CookieStoreOperation as w, cloudflareKvCookieStore as x, CLOUDFLARE_KV_MIN_TTL_SECONDS as y };

package/dist/{index-CYAGCdKJ.d.cts → index-C-7yWV7L.d.cts}

@@ -48,9 +48,32 @@ interface DocumentTotals {
 }
 declare function summarizeItems(items: readonly ItemAmounts[]): DocumentTotals;
 //#endregion
+//#region src/money/refund.d.ts
+type RefundVat = string | number;
+interface RefundableItem<V extends RefundVat = VatRate> {
+  readonly name: string;
+  readonly vat: V;
+  readonly grossAmount: number;
+  readonly unit?: string | undefined;
+  readonly identifier?: string | undefined;
+}
+interface RefundAllocation<V extends RefundVat = VatRate> {
+  readonly index: number;
+  readonly name: string;
+  readonly vat: V;
+  readonly grossAmount: number;
+  readonly unit?: string | undefined;
+  readonly identifier?: string | undefined;
+}
+interface AllocateRefundOptions {
+  readonly decimals?: number | undefined;
+  readonly refundedBefore?: number | undefined;
+}
+declare function allocateRefund<V extends RefundVat = VatRate>(items: readonly RefundableItem<V>[], refundGross: number, options?: AllocateRefundOptions): RefundAllocation<V>[];
+//#endregion
 //#region src/money/rounding.d.ts
 declare function roundMoney(value: number, decimals?: number): number;
 declare function decimalPlaces(value: number): number;
 declare function addMoney(...values: number[]): number;
 //#endregion
-export { VatRate as _, DocumentTotals as a, isVatRate as b, VatBreakdown as c, calculateReceiptItem as d, summarizeItems as f, SpecialVatCode as g, SPECIAL_VAT_CODES as h, DocumentKind as i, calculateInvoiceItem as l, NumericVatRate as m, decimalPlaces as n, ItemAmounts as o, NUMERIC_VAT_RATES as p, roundMoney as r, ItemPriceInput as s, addMoney as t, calculateItemAmounts as u, formatVatRate as v, vatPercentage as x, isHuf as y };
+export { formatVatRate as C, vatPercentage as E, VatRate as S, isVatRate as T, summarizeItems as _, RefundAllocation as a, SPECIAL_VAT_CODES as b, allocateRefund as c, ItemAmounts as d, ItemPriceInput as f, calculateReceiptItem as g, calculateItemAmounts as h, AllocateRefundOptions as i, DocumentKind as l, calculateInvoiceItem as m, decimalPlaces as n, RefundVat as o, VatBreakdown as p, roundMoney as r, RefundableItem as s, addMoney as t, DocumentTotals as u, NUMERIC_VAT_RATES as v, isHuf as w, SpecialVatCode as x, NumericVatRate as y };

package/dist/{index-CYAGCdKJ.d.ts → index-C-7yWV7L.d.ts}

@@ -48,9 +48,32 @@ interface DocumentTotals {
 }
 declare function summarizeItems(items: readonly ItemAmounts[]): DocumentTotals;
 //#endregion
+//#region src/money/refund.d.ts
+type RefundVat = string | number;
+interface RefundableItem<V extends RefundVat = VatRate> {
+  readonly name: string;
+  readonly vat: V;
+  readonly grossAmount: number;
+  readonly unit?: string | undefined;
+  readonly identifier?: string | undefined;
+}
+interface RefundAllocation<V extends RefundVat = VatRate> {
+  readonly index: number;
+  readonly name: string;
+  readonly vat: V;
+  readonly grossAmount: number;
+  readonly unit?: string | undefined;
+  readonly identifier?: string | undefined;
+}
+interface AllocateRefundOptions {
+  readonly decimals?: number | undefined;
+  readonly refundedBefore?: number | undefined;
+}
+declare function allocateRefund<V extends RefundVat = VatRate>(items: readonly RefundableItem<V>[], refundGross: number, options?: AllocateRefundOptions): RefundAllocation<V>[];
+//#endregion
 //#region src/money/rounding.d.ts
 declare function roundMoney(value: number, decimals?: number): number;
 declare function decimalPlaces(value: number): number;
 declare function addMoney(...values: number[]): number;
 //#endregion
-export { VatRate as _, DocumentTotals as a, isVatRate as b, VatBreakdown as c, calculateReceiptItem as d, summarizeItems as f, SpecialVatCode as g, SPECIAL_VAT_CODES as h, DocumentKind as i, calculateInvoiceItem as l, NumericVatRate as m, decimalPlaces as n, ItemAmounts as o, NUMERIC_VAT_RATES as p, roundMoney as r, ItemPriceInput as s, addMoney as t, calculateItemAmounts as u, formatVatRate as v, vatPercentage as x, isHuf as y };
+export { formatVatRate as C, vatPercentage as E, VatRate as S, isVatRate as T, summarizeItems as _, RefundAllocation as a, SPECIAL_VAT_CODES as b, allocateRefund as c, ItemAmounts as d, ItemPriceInput as f, calculateReceiptItem as g, calculateItemAmounts as h, AllocateRefundOptions as i, DocumentKind as l, calculateInvoiceItem as m, decimalPlaces as n, RefundVat as o, VatBreakdown as p, roundMoney as r, RefundableItem as s, addMoney as t, DocumentTotals as u, NUMERIC_VAT_RATES as v, isHuf as w, SpecialVatCode as x, NumericVatRate as y };

package/dist/index.cjs

@@ -1,31 +1,45 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_once = require("./create-once-D0pwuenl.cjs");
-const require_errors = require("./errors-DxeuTslP.cjs");
-const require_client = require("./client-CsmGIFRS.cjs");
+const require_create_once = require("./create-once-9yxR_Er_.cjs");
+const require_errors = require("./errors-EE96_6D_.cjs");
+const require_client = require("./client-CLFvJCVW.cjs");
 const require_binary = require("./binary-B89HM03_.cjs");
-const require_issue = require("./issue-BsyYdrIG.cjs");
-const require_session = require("./session-CKOuE6Jc.cjs");
+const require_session = require("./session-DeM5vjvC.cjs");
+const require_issue = require("./issue-Bin4tKD_.cjs");
 const require_dates = require("./dates-CPgBodkP.cjs");
 exports.AGENT_ACTIONS = require_create_once.AGENT_ACTIONS;
 exports.AGENT_ERROR_CODES = require_errors.AGENT_ERROR_CODES;
 exports.ATTEMPT_LEDGER_KEY_PREFIX = require_client.ATTEMPT_LEDGER_KEY_PREFIX;
 exports.ATTEMPT_LEDGER_TTL_SECONDS = require_client.ATTEMPT_LEDGER_TTL_SECONDS;
+exports.DEFAULT_LOCK_TTL_SECONDS = require_issue.DEFAULT_LOCK_TTL_SECONDS;
+exports.DEFAULT_LOCK_WAIT_MS = require_issue.DEFAULT_LOCK_WAIT_MS;
+exports.DEFAULT_TAXPAYER_INVALID_TTL_SECONDS = require_client.DEFAULT_TAXPAYER_INVALID_TTL_SECONDS;
+exports.DEFAULT_TAXPAYER_TTL_SECONDS = require_client.DEFAULT_TAXPAYER_TTL_SECONDS;
+exports.DocumentHookError = require_create_once.DocumentHookError;
+exports.KASSZA_ERROR_DOCS_URL = require_errors.KASSZA_ERROR_DOCS_URL;
 exports.MAX_INVOICE_ATTACHMENTS = require_create_once.MAX_INVOICE_ATTACHMENTS;
+exports.ONCE_LOCK_KEY_PREFIX = require_issue.ONCE_LOCK_KEY_PREFIX;
 exports.RECEIPT_MAX_GROSS_HUF = require_issue.RECEIPT_MAX_GROSS_HUF;
 exports.SZAMLAZZ_AGENT_URL = require_create_once.SZAMLAZZ_AGENT_URL;
 exports.SzamlazzError = require_errors.SzamlazzError;
+exports.TAXPAYER_CACHE_KEY_PREFIX = require_client.TAXPAYER_CACHE_KEY_PREFIX;
 exports.addBudapestDays = require_dates.addBudapestDays;
 exports.attemptLedgerKey = require_client.attemptLedgerKey;
 exports.buyerFromCustomer = require_issue.buyerFromCustomer;
 exports.bytesToBase64 = require_binary.bytesToBase64;
 exports.chooseDocument = require_issue.chooseDocument;
 exports.conversionExternalId = require_issue.conversionExternalId;
+exports.correctionExternalId = require_issue.correctionExternalId;
 exports.createKassza = require_client.createKassza;
+exports.errorCodeDocsUrl = require_errors.errorCodeDocsUrl;
 exports.invoiceOnceExternalId = require_issue.invoiceOnceExternalId;
+exports.isDocumentHookError = require_create_once.isDocumentHookError;
 exports.isSzamlazzError = require_errors.isSzamlazzError;
 exports.issueForPayment = require_issue.issueForPayment;
 exports.memoryCookieStore = require_session.memoryCookieStore;
+exports.memoryStore = require_session.memoryStore;
+exports.paymentMarker = require_create_once.paymentMarker;
 exports.paymentOrderNumber = require_issue.paymentOrderNumber;
+exports.storeCapabilities = require_session.storeCapabilities;
 exports.suggestedPrefix = require_errors.suggestedPrefix;
 exports.toBudapestDate = require_dates.toBudapestDate;
 exports.toBudapestTimestamp = require_dates.toBudapestTimestamp;