kassza 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -1,31 +1,45 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_once = require("./create-once-DgMtKKcG.cjs");
-const require_errors = require("./errors-DxeuTslP.cjs");
-const require_client = require("./client-C-PdfL_P.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_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");
-const require_issue = require("./issue-AGRohSm7.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;

package/dist/index.d.cts

@@ -1,25 +1,15 @@
-import { r as memoryCookieStore, t as CookieStore } from "./session-Dm_45x8K.cjs";
-import { $ as TransOFlexWaybill, A as BuyerLedger, B as InvoiceItemInput, D as SzamlazzErrorCategory, E as SzamlazzError, F as CreatedInvoiceItem, G as InvoiceTemplate, H as InvoicePostalAddress, I as Currency, J as MplWaybill, K as InvoiceType, L as FinalInvoiceInput, M as CourierService, N as CreateInvoiceInput, O as isSzamlazzError, P as CreatedInvoice, Q as TaxpayerType, R as InvoiceBuyer, T as AgentErrorCodeInfo, U as InvoicePreview, V as InvoiceLanguage, W as InvoiceSeller, X as SprinterWaybill, Y as PickPackPointWaybill, Z as StandardInvoiceInput, _ as ReversedInvoice, a as AgentResponseEvent, b as RegisterPaymentInput, c as SzamlazzOptions, d as InvoiceCreatedEvent, et as Waybill, f as InvoicePaymentEvent, g as ReverseInvoiceInput, h as ReceiptReversedEvent, i as AgentRequestEvent, it as SZAMLAZZ_AGENT_URL, j as CorrectiveInvoiceInput, k as suggestedPrefix, l as DocumentEvent, m as ReceiptCreatedEvent, nt as AgentAction, o as RequestOptions, p as InvoiceReversedEvent, q as ItemLedger, r as AgentErrorEvent, rt as MAX_INVOICE_ATTACHMENTS, s as SzamlazzHooks, t as AgentAttachment, tt as AGENT_ACTIONS, u as DocumentHook, v as ClearPaymentsInput, w as AGENT_ERROR_CODES, x as RegisteredPayment, y as PaymentEntry, z as InvoiceDefaults } from "./context-DXNbTPwz.cjs";
 import { a as todayInBudapest, i as toBudapestTimestamp, n as addBudapestDays, r as toBudapestDate, t as DateInput } from "./dates-9zvESP0i.cjs";
-import { _ as VatRate, o as ItemAmounts, s as ItemPriceInput } from "./index-CYAGCdKJ.cjs";
-import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-DH8QoNZK.cjs";
-import { A as RECEIPT_MAX_GROSS_HUF, C as buyerFromCustomer, D as ChooseDocumentInput, E as ChooseDocumentBuyer, F as invoiceOnceExternalId, I as CreateOnceOptions, L as InvoiceReference, M as ProformaReference, N as InvoicePdf, O as DocumentChoice, P as InvoiceOnceResult, S as SkippedPayment, T as paymentOrderNumber, _ as IssuedInvoice, a as ReceiptsApi, b as PaymentDocumentItem, c as TaxpayerInfo, d as ReceiptOnceResult, f as ConvertReceiptInput, g as IssuedDocument, h as IssueForPaymentOptions, i as KasszaOptions, j as chooseDocument, k as DocumentDecision, l as TaxpayerTaxNumber, m as conversionExternalId, n as Kassza, o as TaxpayerApi, p as ConvertedReceipt, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TaxpayerAddress, v as IssuedReceipt, w as issueForPayment, x as PaymentDocumentsApi, y as IssuedReversal } from "./client-B5FryKxJ.cjs";
+import { a as AgentAction, i as AGENT_ACTIONS, n as KasszaWarningKind, o as MAX_INVOICE_ATTACHMENTS, r as WarningHook, s as SZAMLAZZ_AGENT_URL, t as KasszaWarning } from "./warnings-B3DXnveC.cjs";
+import { $ as Waybill, A as CorrectiveInvoiceInput, B as InvoiceLanguage, C as ClearPaymentsInput, E as RegisteredPayment, F as Currency, G as InvoiceType, H as InvoicePreview, I as FinalInvoiceInput, J as PickPackPointWaybill, K as ItemLedger, L as InvoiceBuyer, M as CreateInvoiceInput, N as CreatedInvoice, P as CreatedInvoiceItem, Q as TransOFlexWaybill, R as InvoiceDefaults, S as ReversedInvoice, T as RegisterPaymentInput, U as InvoiceSeller, V as InvoicePostalAddress, W as InvoiceTemplate, X as StandardInvoiceInput, Y as SprinterWaybill, Z as TaxpayerType, _ as InvoiceReversedEvent, a as AgentRequestEvent, at as AgentErrorCodeInfo, b as isDocumentHookError, c as SzamlazzHooks, ct as SzamlazzErrorCategory, d as DocumentErrorMode, dt as suggestedPrefix, et as ATTEMPT_LEDGER_KEY_PREFIX, f as DocumentEvent, g as InvoicePaymentEvent, h as InvoiceCreatedEvent, i as AgentErrorEvent, it as AGENT_ERROR_CODES, j as CourierService, k as BuyerLedger, l as SzamlazzOptions, lt as errorCodeDocsUrl, m as DocumentHookError, n as AgentCompleteEvent, nt as AttemptLedgerMode, o as AgentResponseEvent, ot as KASSZA_ERROR_DOCS_URL, p as DocumentHook, q as MplWaybill, rt as attemptLedgerKey, s as RequestOptions, st as SzamlazzError, t as AgentAttachment, tt as ATTEMPT_LEDGER_TTL_SECONDS, u as DocumentErrorHandler, ut as isSzamlazzError, v as ReceiptCreatedEvent, w as PaymentEntry, x as ReverseInvoiceInput, y as ReceiptReversedEvent, z as InvoiceItemInput } from "./context-CFNKzStE.cjs";
+import { a as storeCapabilities, i as memoryStore, n as KeyValueStore, r as StoreCapabilities, t as Awaitable } from "./store-C1rHd9DB.cjs";
+import { S as VatRate, d as ItemAmounts, f as ItemPriceInput } from "./index-C-7yWV7L.cjs";
+import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-lnKkQdot.cjs";
+import { r as memoryCookieStore, t as CookieStore } from "./session-YbChChx7.cjs";
+import { $ as ONCE_LOCK_KEY_PREFIX, A as IssuedRefundCorrection, B as DocumentDecision, C as PaymentDocumentItem, D as issueForPayment, E as buyerFromCustomer, F as RefundProposalLine, G as RegisterPaymentOnceInput, H as chooseDocument, I as correctionExternalId, J as InvoiceReference, K as RegisteredPaymentOnce, L as ChooseDocumentBuyer, M as PartialRefundMode, N as RefundItemsContext, O as paymentOrderNumber, P as RefundItemsResolver, Q as LockFailureMode, R as ChooseDocumentInput, S as IssuedReversal, T as SkippedPayment, U as ProformaReference, V as RECEIPT_MAX_GROSS_HUF, W as InvoicePdf, X as DEFAULT_LOCK_TTL_SECONDS, Y as CreateOnceOptions, Z as DEFAULT_LOCK_WAIT_MS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as OnceLockOptions, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundProposal, k as IssuedCorrection, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as paymentMarker, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentsApi, x as IssuedReceipt, y as IssuedDocument, z as DocumentChoice } from "./client-SVZu25MB.cjs";
 import { a as InvoiceDetailsItem, c as InvoiceDetailsTotals, i as InvoiceDetailsHeader, l as InvoiceDocumentType, n as InvoiceDetails, o as InvoiceDetailsPayment, r as InvoiceDetailsBuyer, s as InvoiceDetailsSeller, t as GetInvoiceOptions } from "./get-Byc9T5WO.cjs";
-import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-BVeR7KyU.cjs";
-//#region src/core/attempt-ledger.d.ts
-export declare const ATTEMPT_LEDGER_TTL_SECONDS = 86400;
-export declare const ATTEMPT_LEDGER_KEY_PREFIX = "szamlazz:attempts:";
-interface AttemptLedgerRequest {
-  readonly action: AgentAction;
-  readonly xml: string;
-  readonly attachments?: readonly {
-    readonly filename: string;
-    readonly size: number;
-  }[];
-}
-export declare function attemptLedgerKey(request: AttemptLedgerRequest): Promise<string>;
-//#endregion
+import { n as InvoiceOnceResult, r as invoiceOnceExternalId, t as ReceiptOnceResult } from "./create-once-Bh6fOWkW.cjs";
+import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-B1A8mUIE.cjs";
 //#region src/core/binary.d.ts
 export declare function bytesToBase64(bytes: Uint8Array): string;
 //#endregion
-export { AGENT_ACTIONS, AGENT_ERROR_CODES, type AgentAction, type AgentAttachment, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentEvent, type DocumentHook, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, type Kassza, type KasszaDefaults, type KasszaOptions, MAX_INVOICE_ATTACHMENTS, type MplWaybill, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RegisterPaymentInput, type RegisteredPayment, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, type TaxpayerAddress, type TaxpayerApi, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type Waybill, addBudapestDays, buyerFromCustomer, chooseDocument, conversionExternalId, createKassza, invoiceOnceExternalId, isSzamlazzError, issueForPayment, memoryCookieStore, paymentOrderNumber, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };
+export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/index.d.ts

@@ -1,25 +1,15 @@
-import { r as memoryCookieStore, t as CookieStore } from "./session-Dm_45x8K.js";
-import { $ as TransOFlexWaybill, A as BuyerLedger, B as InvoiceItemInput, D as SzamlazzErrorCategory, E as SzamlazzError, F as CreatedInvoiceItem, G as InvoiceTemplate, H as InvoicePostalAddress, I as Currency, J as MplWaybill, K as InvoiceType, L as FinalInvoiceInput, M as CourierService, N as CreateInvoiceInput, O as isSzamlazzError, P as CreatedInvoice, Q as TaxpayerType, R as InvoiceBuyer, T as AgentErrorCodeInfo, U as InvoicePreview, V as InvoiceLanguage, W as InvoiceSeller, X as SprinterWaybill, Y as PickPackPointWaybill, Z as StandardInvoiceInput, _ as ReversedInvoice, a as AgentResponseEvent, b as RegisterPaymentInput, c as SzamlazzOptions, d as InvoiceCreatedEvent, et as Waybill, f as InvoicePaymentEvent, g as ReverseInvoiceInput, h as ReceiptReversedEvent, i as AgentRequestEvent, it as SZAMLAZZ_AGENT_URL, j as CorrectiveInvoiceInput, k as suggestedPrefix, l as DocumentEvent, m as ReceiptCreatedEvent, nt as AgentAction, o as RequestOptions, p as InvoiceReversedEvent, q as ItemLedger, r as AgentErrorEvent, rt as MAX_INVOICE_ATTACHMENTS, s as SzamlazzHooks, t as AgentAttachment, tt as AGENT_ACTIONS, u as DocumentHook, v as ClearPaymentsInput, w as AGENT_ERROR_CODES, x as RegisteredPayment, y as PaymentEntry, z as InvoiceDefaults } from "./context-BxQlIlug.js";
 import { a as todayInBudapest, i as toBudapestTimestamp, n as addBudapestDays, r as toBudapestDate, t as DateInput } from "./dates-9zvESP0i.js";
-import { _ as VatRate, o as ItemAmounts, s as ItemPriceInput } from "./index-CYAGCdKJ.js";
-import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-k--zHf4l.js";
-import { A as RECEIPT_MAX_GROSS_HUF, C as buyerFromCustomer, D as ChooseDocumentInput, E as ChooseDocumentBuyer, F as invoiceOnceExternalId, I as CreateOnceOptions, L as InvoiceReference, M as ProformaReference, N as InvoicePdf, O as DocumentChoice, P as InvoiceOnceResult, S as SkippedPayment, T as paymentOrderNumber, _ as IssuedInvoice, a as ReceiptsApi, b as PaymentDocumentItem, c as TaxpayerInfo, d as ReceiptOnceResult, f as ConvertReceiptInput, g as IssuedDocument, h as IssueForPaymentOptions, i as KasszaOptions, j as chooseDocument, k as DocumentDecision, l as TaxpayerTaxNumber, m as conversionExternalId, n as Kassza, o as TaxpayerApi, p as ConvertedReceipt, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TaxpayerAddress, v as IssuedReceipt, w as issueForPayment, x as PaymentDocumentsApi, y as IssuedReversal } from "./client-6MkeuFqD.js";
+import { a as AgentAction, i as AGENT_ACTIONS, n as KasszaWarningKind, o as MAX_INVOICE_ATTACHMENTS, r as WarningHook, s as SZAMLAZZ_AGENT_URL, t as KasszaWarning } from "./warnings-B3DXnveC.js";
+import { $ as Waybill, A as CorrectiveInvoiceInput, B as InvoiceLanguage, C as ClearPaymentsInput, E as RegisteredPayment, F as Currency, G as InvoiceType, H as InvoicePreview, I as FinalInvoiceInput, J as PickPackPointWaybill, K as ItemLedger, L as InvoiceBuyer, M as CreateInvoiceInput, N as CreatedInvoice, P as CreatedInvoiceItem, Q as TransOFlexWaybill, R as InvoiceDefaults, S as ReversedInvoice, T as RegisterPaymentInput, U as InvoiceSeller, V as InvoicePostalAddress, W as InvoiceTemplate, X as StandardInvoiceInput, Y as SprinterWaybill, Z as TaxpayerType, _ as InvoiceReversedEvent, a as AgentRequestEvent, at as AgentErrorCodeInfo, b as isDocumentHookError, c as SzamlazzHooks, ct as SzamlazzErrorCategory, d as DocumentErrorMode, dt as suggestedPrefix, et as ATTEMPT_LEDGER_KEY_PREFIX, f as DocumentEvent, g as InvoicePaymentEvent, h as InvoiceCreatedEvent, i as AgentErrorEvent, it as AGENT_ERROR_CODES, j as CourierService, k as BuyerLedger, l as SzamlazzOptions, lt as errorCodeDocsUrl, m as DocumentHookError, n as AgentCompleteEvent, nt as AttemptLedgerMode, o as AgentResponseEvent, ot as KASSZA_ERROR_DOCS_URL, p as DocumentHook, q as MplWaybill, rt as attemptLedgerKey, s as RequestOptions, st as SzamlazzError, t as AgentAttachment, tt as ATTEMPT_LEDGER_TTL_SECONDS, u as DocumentErrorHandler, ut as isSzamlazzError, v as ReceiptCreatedEvent, w as PaymentEntry, x as ReverseInvoiceInput, y as ReceiptReversedEvent, z as InvoiceItemInput } from "./context-kb33TgzE.js";
+import { a as storeCapabilities, i as memoryStore, n as KeyValueStore, r as StoreCapabilities, t as Awaitable } from "./store-C1rHd9DB.js";
+import { S as VatRate, d as ItemAmounts, f as ItemPriceInput } from "./index-C-7yWV7L.js";
+import { a as ReceiptItem, c as ReceiptPayment, d as ReceiptTotals, f as ReceiptType, h as SendReceiptInput, i as ReceiptDefaults, l as ReceiptPaymentInput, m as ReverseReceiptInput, n as GetReceiptInput, o as ReceiptItemInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput, u as ReceiptPdfTemplate } from "./types-D1zDOH_F.js";
+import { r as memoryCookieStore, t as CookieStore } from "./session-Ckl5eJhV.js";
+import { $ as ONCE_LOCK_KEY_PREFIX, A as IssuedRefundCorrection, B as DocumentDecision, C as PaymentDocumentItem, D as issueForPayment, E as buyerFromCustomer, F as RefundProposalLine, G as RegisterPaymentOnceInput, H as chooseDocument, I as correctionExternalId, J as InvoiceReference, K as RegisteredPaymentOnce, L as ChooseDocumentBuyer, M as PartialRefundMode, N as RefundItemsContext, O as paymentOrderNumber, P as RefundItemsResolver, Q as LockFailureMode, R as ChooseDocumentInput, S as IssuedReversal, T as SkippedPayment, U as ProformaReference, V as RECEIPT_MAX_GROSS_HUF, W as InvoicePdf, X as DEFAULT_LOCK_TTL_SECONDS, Y as CreateOnceOptions, Z as DEFAULT_LOCK_WAIT_MS, _ as conversionExternalId, a as ReceiptsApi, b as IssuedInvoice, c as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, d as TaxpayerCacheOptions, et as OnceLockOptions, f as TaxpayerInfo, g as ConvertedReceipt, h as ConvertReceiptInput, i as KasszaOptions, j as IssuedRefundProposal, k as IssuedCorrection, l as DEFAULT_TAXPAYER_TTL_SECONDS, m as TaxpayerAddress, n as Kassza, o as TaxpayerApi, p as TaxpayerTaxNumber, q as paymentMarker, r as KasszaDefaults, s as createKassza, t as InvoicesApi, u as TAXPAYER_CACHE_KEY_PREFIX, v as IssueForPaymentOptions, w as PaymentDocumentsApi, x as IssuedReceipt, y as IssuedDocument, z as DocumentChoice } from "./client-DeWWQ-RZ.js";
 import { a as InvoiceDetailsItem, c as InvoiceDetailsTotals, i as InvoiceDetailsHeader, l as InvoiceDocumentType, n as InvoiceDetails, o as InvoiceDetailsPayment, r as InvoiceDetailsBuyer, s as InvoiceDetailsSeller, t as GetInvoiceOptions } from "./get-Byc9T5WO.js";
-import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-BVeR7KyU.js";
-//#region src/core/attempt-ledger.d.ts
-export declare const ATTEMPT_LEDGER_TTL_SECONDS = 86400;
-export declare const ATTEMPT_LEDGER_KEY_PREFIX = "szamlazz:attempts:";
-interface AttemptLedgerRequest {
-  readonly action: AgentAction;
-  readonly xml: string;
-  readonly attachments?: readonly {
-    readonly filename: string;
-    readonly size: number;
-  }[];
-}
-export declare function attemptLedgerKey(request: AttemptLedgerRequest): Promise<string>;
-//#endregion
+import { n as InvoiceOnceResult, r as invoiceOnceExternalId, t as ReceiptOnceResult } from "./create-once-VKp0tVow.js";
+import { a as PaymentEventKind, c as PaymentProvider, i as PaymentEvent, l as PaymentRefund, n as PaymentAmount, r as PaymentCustomer, s as PaymentLineItem, t as PaymentAddress } from "./types-ByAEvGsZ.js";
 //#region src/core/binary.d.ts
 export declare function bytesToBase64(bytes: Uint8Array): string;
 //#endregion
-export { AGENT_ACTIONS, AGENT_ERROR_CODES, type AgentAction, type AgentAttachment, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentEvent, type DocumentHook, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, type Kassza, type KasszaDefaults, type KasszaOptions, MAX_INVOICE_ATTACHMENTS, type MplWaybill, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RegisterPaymentInput, type RegisteredPayment, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, type TaxpayerAddress, type TaxpayerApi, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type Waybill, addBudapestDays, buyerFromCustomer, chooseDocument, conversionExternalId, createKassza, invoiceOnceExternalId, isSzamlazzError, issueForPayment, memoryCookieStore, paymentOrderNumber, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };
+export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, type AgentAction, type AgentAttachment, type AgentCompleteEvent, type AgentErrorCodeInfo, type AgentErrorEvent, type AgentRequestEvent, type AgentResponseEvent, type AttemptLedgerMode, type Awaitable, type BuyerLedger, type ChooseDocumentBuyer, type ChooseDocumentInput, type ClearPaymentsInput, type ConvertReceiptInput, type ConvertedReceipt, type CookieStore, type CorrectiveInvoiceInput, type CourierService, type CreateInvoiceInput, type CreateOnceOptions, type CreateReceiptInput, type CreatedInvoice, type CreatedInvoiceItem, type Currency, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, type DateInput, type DocumentChoice, type DocumentDecision, type DocumentErrorHandler, type DocumentErrorMode, type DocumentEvent, type DocumentHook, DocumentHookError, type FinalInvoiceInput, type GetInvoiceOptions, type GetReceiptInput, type InvoiceBuyer, type InvoiceCreatedEvent, type InvoiceDefaults, type InvoiceDetails, type InvoiceDetailsBuyer, type InvoiceDetailsHeader, type InvoiceDetailsItem, type InvoiceDetailsPayment, type InvoiceDetailsSeller, type InvoiceDetailsTotals, type InvoiceDocumentType, type InvoiceItemInput, type InvoiceLanguage, type InvoiceOnceResult, type InvoicePaymentEvent, type InvoicePdf, type InvoicePostalAddress, type InvoicePreview, type InvoiceReference, type InvoiceReversedEvent, type InvoiceSeller, type InvoiceTemplate, type InvoiceType, type InvoicesApi, type IssueForPaymentOptions, type IssuedCorrection, type IssuedDocument, type IssuedInvoice, type IssuedReceipt, type IssuedRefundCorrection, type IssuedRefundProposal, type IssuedReversal, type ItemAmounts, type ItemLedger, type ItemPriceInput, KASSZA_ERROR_DOCS_URL, type Kassza, type KasszaDefaults, type KasszaOptions, type KasszaWarning, type KasszaWarningKind, type KeyValueStore, type LockFailureMode, MAX_INVOICE_ATTACHMENTS, type MplWaybill, ONCE_LOCK_KEY_PREFIX, type OnceLockOptions, type PartialRefundMode, type PaymentAddress, type PaymentAmount, type PaymentCustomer, type PaymentDocumentItem, type PaymentDocumentsApi, type PaymentEntry, type PaymentEvent, type PaymentEventKind, type PaymentLineItem, type PaymentProvider, type PaymentRefund, type PickPackPointWaybill, type ProformaReference, RECEIPT_MAX_GROSS_HUF, type Receipt, type ReceiptCreatedEvent, type ReceiptDefaults, type ReceiptItem, type ReceiptItemInput, type ReceiptOnceResult, type ReceiptOnlyVatCode, type ReceiptPayment, type ReceiptPaymentInput, type ReceiptPdfTemplate, type ReceiptReversedEvent, type ReceiptTotals, type ReceiptType, type ReceiptVatRate, type ReceiptsApi, type RefundItemsContext, type RefundItemsResolver, type RefundProposalLine, type RegisterPaymentInput, type RegisterPaymentOnceInput, type RegisteredPayment, type RegisteredPaymentOnce, type RequestOptions, type ReverseInvoiceInput, type ReverseReceiptInput, type ReversedInvoice, SZAMLAZZ_AGENT_URL, type SendReceiptInput, type SkippedPayment, type SprinterWaybill, type StandardInvoiceInput, type StoreCapabilities, SzamlazzError, type SzamlazzErrorCategory, type SzamlazzHooks, type SzamlazzOptions, TAXPAYER_CACHE_KEY_PREFIX, type TaxpayerAddress, type TaxpayerApi, type TaxpayerCacheOptions, type TaxpayerInfo, type TaxpayerTaxNumber, type TaxpayerType, type TransOFlexWaybill, type VatRate, type WarningHook, type Waybill, addBudapestDays, attemptLedgerKey, buyerFromCustomer, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/index.js

@@ -1,8 +1,8 @@
-import { d as SZAMLAZZ_AGENT_URL, l as AGENT_ACTIONS, u as MAX_INVOICE_ATTACHMENTS } from "./create-once-Cz621l8r.js";
-import { i as isSzamlazzError, n as SzamlazzError, o as suggestedPrefix, t as AGENT_ERROR_CODES } from "./errors-DLrb0g64.js";
-import { c as attemptLedgerKey, o as ATTEMPT_LEDGER_KEY_PREFIX, s as ATTEMPT_LEDGER_TTL_SECONDS, t as createKassza } from "./client-CfaS1-Jx.js";
+import { _ as SZAMLAZZ_AGENT_URL, f as DocumentHookError, g as MAX_INVOICE_ATTACHMENTS, h as AGENT_ACTIONS, m as isDocumentHookError, n as paymentMarker } from "./create-once-Ca2gMk1h.js";
+import { a as errorCodeDocsUrl, c as suggestedPrefix, n as KASSZA_ERROR_DOCS_URL, o as isSzamlazzError, r as SzamlazzError, t as AGENT_ERROR_CODES } from "./errors-DtN4g5Z9.js";
+import { d as attemptLedgerKey, i as TAXPAYER_CACHE_KEY_PREFIX, l as ATTEMPT_LEDGER_KEY_PREFIX, n as DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, r as DEFAULT_TAXPAYER_TTL_SECONDS, t as createKassza, u as ATTEMPT_LEDGER_TTL_SECONDS } from "./client-Cvf-hTz_.js";
 import { n as bytesToBase64 } from "./binary-D0M9U2MD.js";
-import { n as memoryCookieStore } from "./session-rMKaJcmq.js";
+import { a as memoryStore, n as memoryCookieStore, o as storeCapabilities } from "./session-SaEEXu2N.js";
+import { a as conversionExternalId, c as chooseDocument, d as DEFAULT_LOCK_TTL_SECONDS, f as DEFAULT_LOCK_WAIT_MS, i as correctionExternalId, n as issueForPayment, p as ONCE_LOCK_KEY_PREFIX, r as paymentOrderNumber, s as RECEIPT_MAX_GROSS_HUF, t as buyerFromCustomer, u as invoiceOnceExternalId } from "./issue-DMA1Nbr1.js";
 import { a as todayInBudapest, i as toBudapestTimestamp, r as toBudapestDate, t as addBudapestDays } from "./dates-CXyj7Azy.js";
-import { f as conversionExternalId, g as chooseDocument, h as RECEIPT_MAX_GROSS_HUF, n as issueForPayment, r as paymentOrderNumber, t as buyerFromCustomer, v as invoiceOnceExternalId } from "./issue-DtSLpVdJ.js";
-export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, MAX_INVOICE_ATTACHMENTS, RECEIPT_MAX_GROSS_HUF, SZAMLAZZ_AGENT_URL, SzamlazzError, addBudapestDays, attemptLedgerKey, buyerFromCustomer, bytesToBase64, chooseDocument, conversionExternalId, createKassza, invoiceOnceExternalId, isSzamlazzError, issueForPayment, memoryCookieStore, paymentOrderNumber, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };
+export { AGENT_ACTIONS, AGENT_ERROR_CODES, ATTEMPT_LEDGER_KEY_PREFIX, ATTEMPT_LEDGER_TTL_SECONDS, DEFAULT_LOCK_TTL_SECONDS, DEFAULT_LOCK_WAIT_MS, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS, DEFAULT_TAXPAYER_TTL_SECONDS, DocumentHookError, KASSZA_ERROR_DOCS_URL, MAX_INVOICE_ATTACHMENTS, ONCE_LOCK_KEY_PREFIX, RECEIPT_MAX_GROSS_HUF, SZAMLAZZ_AGENT_URL, SzamlazzError, TAXPAYER_CACHE_KEY_PREFIX, addBudapestDays, attemptLedgerKey, buyerFromCustomer, bytesToBase64, chooseDocument, conversionExternalId, correctionExternalId, createKassza, errorCodeDocsUrl, invoiceOnceExternalId, isDocumentHookError, isSzamlazzError, issueForPayment, memoryCookieStore, memoryStore, paymentMarker, paymentOrderNumber, storeCapabilities, suggestedPrefix, toBudapestDate, toBudapestTimestamp, todayInBudapest };

package/dist/ipn/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors = require("../errors-DxeuTslP.cjs");
+const require_errors = require("../errors-EE96_6D_.cjs");
 const require_binary = require("../binary-B89HM03_.cjs");
 //#region src/ipn/ip.ts
 const SZAMLAZZ_OUTBOUND_IPS = [
@@ -24,12 +24,32 @@ function clientAddress(header, trustedProxies) {
 	const entries = header.split(",").map((entry) => entry.trim()).filter((entry) => entry !== "");
 	return entries[entries.length - 1 - trustedProxies];
 }
-function isSzamlazzIp(ip, options = {}) {
+function rejection(reason, message, client) {
+	return client === void 0 ? {
+		allowed: false,
+		reason,
+		message
+	} : {
+		allowed: false,
+		reason,
+		client,
+		message
+	};
+}
+function checkSzamlazzIp(ip, options = {}) {
 	const trustedProxies = resolveTrustedProxies(options.trustedProxies);
-	if (typeof ip !== "string") return false;
+	if (typeof ip !== "string" || ip.trim() === "") return rejection("missing_header", "Nincs forrás IP-cím: a proxy nem adta át az x-forwarded-for fejlécet.");
 	const client = clientAddress(ip, trustedProxies);
-	if (client === void 0) return false;
-	return new Set((options.allowedIps ?? SZAMLAZZ_OUTBOUND_IPS).map(normalizeIp)).has(normalizeIp(client));
+	if (client === void 0) return rejection("no_client_entry", `Az x-forwarded-for fejlécben kevesebb cím van, mint a trustedProxies (${trustedProxies}) + 1.`);
+	const normalized = normalizeIp(client);
+	if (new Set((options.allowedIps ?? SZAMLAZZ_OUTBOUND_IPS).map(normalizeIp)).has(normalized)) return {
+		allowed: true,
+		client: normalized
+	};
+	return rejection("not_allowed", `A(z) ${normalized} cím nem szerepel a Számlázz.hu kimenő IP-címei között. Ha a Számlázz.hu új címet kapott, add meg az allowedIps opcióban, és jelezd a kassza hibajegyében.`, normalized);
+}
+function isSzamlazzIp(ip, options = {}) {
+	return checkSzamlazzIp(ip, options).allowed;
 }
 //#endregion
 //#region src/ipn/notification.ts
@@ -148,6 +168,7 @@ function ipnOkResponse() {
 exports.IPN_FIELDS = IPN_FIELDS;
 exports.MAX_IPN_BODY_BYTES = MAX_IPN_BODY_BYTES;
 exports.SZAMLAZZ_OUTBOUND_IPS = SZAMLAZZ_OUTBOUND_IPS;
+exports.checkSzamlazzIp = checkSzamlazzIp;
 exports.ipnOkResponse = ipnOkResponse;
 exports.isSzamlazzIp = isSzamlazzIp;
 exports.parseIpnAmount = parseIpnAmount;

package/dist/ipn/index.d.cts

@@ -4,6 +4,17 @@ interface SzamlazzIpOptions {
   readonly trustedProxies?: number | undefined;
   readonly allowedIps?: readonly string[] | undefined;
 }
+type SzamlazzIpRejection = "missing_header" | "no_client_entry" | "not_allowed";
+type SzamlazzIpCheck = {
+  readonly allowed: true;
+  readonly client: string;
+} | {
+  readonly allowed: false;
+  readonly reason: SzamlazzIpRejection;
+  readonly client?: string | undefined;
+  readonly message: string;
+};
+export declare function checkSzamlazzIp(ip: string | null | undefined, options?: SzamlazzIpOptions): SzamlazzIpCheck;
 export declare function isSzamlazzIp(ip: string | null | undefined, options?: SzamlazzIpOptions): boolean;
 //#endregion
 //#region src/ipn/notification.d.ts
@@ -34,4 +45,4 @@ export declare function parseIpnNotification(input: IpnInput): IpnNotification;
 export declare function readIpnNotification(request: Request): Promise<IpnNotification>;
 export declare function ipnOkResponse(): Response;
 //#endregion
-export type { IpnInput, IpnNotification, SzamlazzIpOptions };
+export type { IpnInput, IpnNotification, SzamlazzIpCheck, SzamlazzIpOptions, SzamlazzIpRejection };

package/dist/ipn/index.d.ts

@@ -4,6 +4,17 @@ interface SzamlazzIpOptions {
   readonly trustedProxies?: number | undefined;
   readonly allowedIps?: readonly string[] | undefined;
 }
+type SzamlazzIpRejection = "missing_header" | "no_client_entry" | "not_allowed";
+type SzamlazzIpCheck = {
+  readonly allowed: true;
+  readonly client: string;
+} | {
+  readonly allowed: false;
+  readonly reason: SzamlazzIpRejection;
+  readonly client?: string | undefined;
+  readonly message: string;
+};
+export declare function checkSzamlazzIp(ip: string | null | undefined, options?: SzamlazzIpOptions): SzamlazzIpCheck;
 export declare function isSzamlazzIp(ip: string | null | undefined, options?: SzamlazzIpOptions): boolean;
 //#endregion
 //#region src/ipn/notification.d.ts
@@ -34,4 +45,4 @@ export declare function parseIpnNotification(input: IpnInput): IpnNotification;
 export declare function readIpnNotification(request: Request): Promise<IpnNotification>;
 export declare function ipnOkResponse(): Response;
 //#endregion
-export type { IpnInput, IpnNotification, SzamlazzIpOptions };
+export type { IpnInput, IpnNotification, SzamlazzIpCheck, SzamlazzIpOptions, SzamlazzIpRejection };

package/dist/ipn/index.js

@@ -1,4 +1,4 @@
-import { n as SzamlazzError } from "../errors-DLrb0g64.js";
+import { r as SzamlazzError } from "../errors-DtN4g5Z9.js";
 import { r as decodeUtf8 } from "../binary-D0M9U2MD.js";
 //#region src/ipn/ip.ts
 const SZAMLAZZ_OUTBOUND_IPS = [
@@ -23,12 +23,32 @@ function clientAddress(header, trustedProxies) {
 	const entries = header.split(",").map((entry) => entry.trim()).filter((entry) => entry !== "");
 	return entries[entries.length - 1 - trustedProxies];
 }
-function isSzamlazzIp(ip, options = {}) {
+function rejection(reason, message, client) {
+	return client === void 0 ? {
+		allowed: false,
+		reason,
+		message
+	} : {
+		allowed: false,
+		reason,
+		client,
+		message
+	};
+}
+function checkSzamlazzIp(ip, options = {}) {
 	const trustedProxies = resolveTrustedProxies(options.trustedProxies);
-	if (typeof ip !== "string") return false;
+	if (typeof ip !== "string" || ip.trim() === "") return rejection("missing_header", "Nincs forrás IP-cím: a proxy nem adta át az x-forwarded-for fejlécet.");
 	const client = clientAddress(ip, trustedProxies);
-	if (client === void 0) return false;
-	return new Set((options.allowedIps ?? SZAMLAZZ_OUTBOUND_IPS).map(normalizeIp)).has(normalizeIp(client));
+	if (client === void 0) return rejection("no_client_entry", `Az x-forwarded-for fejlécben kevesebb cím van, mint a trustedProxies (${trustedProxies}) + 1.`);
+	const normalized = normalizeIp(client);
+	if (new Set((options.allowedIps ?? SZAMLAZZ_OUTBOUND_IPS).map(normalizeIp)).has(normalized)) return {
+		allowed: true,
+		client: normalized
+	};
+	return rejection("not_allowed", `A(z) ${normalized} cím nem szerepel a Számlázz.hu kimenő IP-címei között. Ha a Számlázz.hu új címet kapott, add meg az allowedIps opcióban, és jelezd a kassza hibajegyében.`, normalized);
+}
+function isSzamlazzIp(ip, options = {}) {
+	return checkSzamlazzIp(ip, options).allowed;
 }
 //#endregion
 //#region src/ipn/notification.ts
@@ -144,4 +164,4 @@ function ipnOkResponse() {
 	});
 }
 //#endregion
-export { IPN_FIELDS, MAX_IPN_BODY_BYTES, SZAMLAZZ_OUTBOUND_IPS, ipnOkResponse, isSzamlazzIp, parseIpnAmount, parseIpnNotification, readIpnNotification };
+export { IPN_FIELDS, MAX_IPN_BODY_BYTES, SZAMLAZZ_OUTBOUND_IPS, checkSzamlazzIp, ipnOkResponse, isSzamlazzIp, parseIpnAmount, parseIpnNotification, readIpnNotification };