kassza 0.13.0 → 0.14.0

package/dist/{client-6MkeuFqD.d.ts → client-DeWWQ-RZ.d.ts}

@@ -1,8 +1,31 @@
-import { E as SzamlazzError, G as InvoiceTemplate, K as InvoiceType, N as CreateInvoiceInput, P as CreatedInvoice, R as InvoiceBuyer, U as InvoicePreview, V as InvoiceLanguage, W as InvoiceSeller, Z as StandardInvoiceInput, _ as ReversedInvoice, b as RegisterPaymentInput, c as SzamlazzOptions, g as ReverseInvoiceInput, o as RequestOptions, v as ClearPaymentsInput, x as RegisteredPayment, z as InvoiceDefaults } from "./context-BxQlIlug.js";
-import { _ as VatRate } from "./index-CYAGCdKJ.js";
-import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-k--zHf4l.js";
-import { n as InvoiceDetails, t as GetInvoiceOptions } from "./get-Byc9T5WO.js";
-import { i as PaymentEvent, r as PaymentCustomer, s as PaymentLineItem } from "./types-BVeR7KyU.js";
+import { t as DateInput } from "./dates-9zvESP0i.js";
+import { B as InvoiceLanguage, C as ClearPaymentsInput, E as RegisteredPayment, H as InvoicePreview, L as InvoiceBuyer, M as CreateInvoiceInput, N as CreatedInvoice, R as InvoiceDefaults, S as ReversedInvoice, T as RegisterPaymentInput, U as InvoiceSeller, W as InvoiceTemplate, X as StandardInvoiceInput, l as SzamlazzOptions, s as RequestOptions, st as SzamlazzError, x as ReverseInvoiceInput } from "./context-kb33TgzE.js";
+import { n as KeyValueStore } from "./store-C1rHd9DB.js";
+import { S as VatRate, a as RefundAllocation, s as RefundableItem } from "./index-C-7yWV7L.js";
+import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-D1zDOH_F.js";
+import { n as InvoiceDetails, o as InvoiceDetailsPayment, t as GetInvoiceOptions } from "./get-Byc9T5WO.js";
+import { n as InvoiceOnceResult, t as ReceiptOnceResult } from "./create-once-VKp0tVow.js";
+import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-ByAEvGsZ.js";
+//#region src/core/once-guard.d.ts
+declare const ONCE_LOCK_KEY_PREFIX = "szamlazz:once:";
+declare const DEFAULT_LOCK_TTL_SECONDS = 600;
+declare const DEFAULT_LOCK_WAIT_MS = 1e4;
+type LockFailureMode = "throw" | "proceed";
+interface OnceLockOptions {
+  readonly lock?: KeyValueStore | false | undefined;
+  readonly lockTtlSeconds?: number | undefined;
+  readonly lockWaitMs?: number | undefined;
+  readonly lockFailure?: LockFailureMode | undefined;
+  readonly signal?: AbortSignal | undefined;
+}
+//#endregion
+//#region src/core/once.d.ts
+interface CreateOnceOptions extends RequestOptions, OnceLockOptions {
+  readonly lookupFirst?: boolean | undefined;
+  readonly matchOrderNumber?: boolean | undefined;
+  readonly recoveryDelayMs?: number | undefined;
+}
+//#endregion
 //#region src/invoices/reference.d.ts
 type InvoiceReference = string | {
   readonly invoiceNumber: string;
@@ -12,22 +35,25 @@ type InvoiceReference = string | {
   readonly externalId: string;
 };
 //#endregion
-//#region src/core/once.d.ts
-interface CreateOnceOptions extends RequestOptions {
-  readonly lookupFirst?: boolean | undefined;
-  readonly matchOrderNumber?: boolean | undefined;
-  readonly recoveryDelayMs?: number | undefined;
+//#region src/invoices/payment-once.d.ts
+interface RegisterPaymentOnceInput {
+  readonly invoiceNumber: string;
+  readonly key: string;
+  readonly amount: number;
+  readonly method?: string | undefined;
+  readonly date?: DateInput | undefined;
+  readonly description?: string | undefined;
+  readonly taxNumber?: string | undefined;
 }
-//#endregion
-//#region src/invoices/create-once.d.ts
-interface InvoiceOnceResult {
-  readonly number: string;
+interface RegisteredPaymentOnce {
+  readonly invoiceNumber: string;
+  readonly key: string;
+  readonly marker: string;
   readonly created: boolean;
-  readonly externalId: string;
-  readonly invoice?: CreatedInvoice | undefined;
-  readonly details?: InvoiceDetails | undefined;
+  readonly payment?: RegisteredPayment | undefined;
+  readonly existing?: InvoiceDetailsPayment | undefined;
 }
-declare function invoiceOnceExternalId(type: InvoiceType, orderNumber: string): string;
+declare function paymentMarker(key: string): string;
 //#endregion
 //#region src/invoices/pdf.d.ts
 interface InvoicePdf {
@@ -70,6 +96,44 @@ interface DocumentDecision {
 }
 declare function chooseDocument(input: ChooseDocumentInput): DocumentDecision;
 //#endregion
+//#region src/payments/partial-refund.d.ts
+type PartialRefundMode = "auto" | "proportional" | "skip";
+interface RefundItemsContext {
+  readonly refund: PaymentRefund;
+  readonly invoiceNumber: string;
+  readonly items: readonly RefundableItem[];
+}
+type RefundItemsResolver = (context: RefundItemsContext) => readonly PaymentDocumentItem[] | undefined | Promise<readonly PaymentDocumentItem[] | undefined>;
+interface IssuedRefundCorrection {
+  readonly refundId: string;
+  readonly externalId: string;
+  readonly number: string;
+  readonly created: boolean;
+  readonly grossTotal: number;
+  readonly invoice: InvoiceOnceResult;
+}
+interface IssuedCorrection {
+  readonly kind: "correction";
+  readonly orderNumber: string;
+  readonly correctedNumber: string;
+  readonly created: boolean;
+  readonly corrections: readonly IssuedRefundCorrection[];
+}
+interface RefundProposalLine {
+  readonly refundId: string;
+  readonly grossTotal: number;
+  readonly items: readonly RefundAllocation<ReceiptVatRate>[];
+}
+interface IssuedRefundProposal {
+  readonly kind: "refund-proposal";
+  readonly orderNumber: string;
+  readonly document: "receipt" | "invoice";
+  readonly documentNumber: string;
+  readonly refunds: readonly RefundProposalLine[];
+  readonly reason: string;
+}
+declare function correctionExternalId(orderNumber: string, refundId: string): Promise<string>;
+//#endregion
 //#region src/payments/issue.d.ts
 interface PaymentDocumentItem {
   readonly name: string;
@@ -96,6 +160,8 @@ interface IssueForPaymentOptions {
   readonly exchangeRate?: number | undefined;
   readonly exchangeBank?: string | undefined;
   readonly allowAmountMismatch?: boolean | undefined;
+  readonly partialRefund?: PartialRefundMode | undefined;
+  readonly refundItems?: RefundItemsResolver | undefined;
   readonly receipt?: Partial<Omit<CreateReceiptInput, "items" | "orderNumber" | "callId" | "currency" | "exchangeRate" | "exchangeBank">> | undefined;
   readonly invoice?: Partial<Omit<StandardInvoiceInput, "items" | "buyer" | "type" | "orderNumber" | "paid" | "currency" | "exchangeRate" | "exchangeBank" | "externalId">> | undefined;
   readonly recoveryDelayMs?: number | undefined;
@@ -130,7 +196,7 @@ interface SkippedPayment {
   readonly orderNumber: string;
   readonly reason: string;
 }
-type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | SkippedPayment;
+type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | SkippedPayment;
 interface PaymentDocumentsApi {
   readonly invoices: Pick<InvoicesApi, "createOnce" | "find" | "reverse">;
   readonly receipts: Pick<ReceiptsApi, "createOnce" | "find" | "reverse">;
@@ -161,12 +227,6 @@ interface ConvertedReceipt {
 }
 declare function conversionExternalId(receiptNumber: string): string;
 //#endregion
-//#region src/receipts/create-once.d.ts
-interface ReceiptOnceResult {
-  readonly receipt: Receipt;
-  readonly created: boolean;
-}
-//#endregion
 //#region src/taxpayer/address.d.ts
 type TaxpayerAddressType = "HQ" | "SITE" | "BRANCH" | (string & {});
 interface NavDetailedAddress {
@@ -222,6 +282,16 @@ interface TaxpayerInfo {
   readonly requestId?: string | undefined;
 }
 //#endregion
+//#region src/taxpayer/cache.d.ts
+declare const TAXPAYER_CACHE_KEY_PREFIX = "szamlazz:taxpayer:";
+declare const DEFAULT_TAXPAYER_TTL_SECONDS = 86400;
+declare const DEFAULT_TAXPAYER_INVALID_TTL_SECONDS = 600;
+interface TaxpayerCacheOptions {
+  readonly store: KeyValueStore;
+  readonly ttlSeconds?: number | undefined;
+  readonly invalidTtlSeconds?: number | undefined;
+}
+//#endregion
 //#region src/client.d.ts
 interface KasszaDefaults {
   readonly invoice?: InvoiceDefaults;
@@ -229,6 +299,8 @@ interface KasszaDefaults {
 }
 interface KasszaOptions extends SzamlazzOptions {
   readonly defaults?: KasszaDefaults;
+  readonly createOnceLock?: KeyValueStore | undefined;
+  readonly taxpayerCache?: TaxpayerCacheOptions | undefined;
 }
 interface InvoicesApi {
   create(input: CreateInvoiceInput, options?: RequestOptions): Promise<CreatedInvoice>;
@@ -236,6 +308,7 @@ interface InvoicesApi {
   preview(input: CreateInvoiceInput, options?: RequestOptions): Promise<InvoicePreview>;
   reverse(input: ReverseInvoiceInput, options?: RequestOptions): Promise<ReversedInvoice>;
   registerPayment(input: RegisterPaymentInput, options?: RequestOptions): Promise<RegisteredPayment>;
+  registerPaymentOnce(input: RegisterPaymentOnceInput, options?: CreateOnceOptions): Promise<RegisteredPaymentOnce>;
   clearPayments(input: ClearPaymentsInput, options?: RequestOptions): Promise<RegisteredPayment>;
   getPdf(reference: InvoiceReference, options?: RequestOptions): Promise<InvoicePdf>;
   get(reference: InvoiceReference, query?: GetInvoiceOptions, options?: RequestOptions): Promise<InvoiceDetails>;
@@ -265,4 +338,4 @@ interface Kassza {
 }
 declare function createKassza(options?: KasszaOptions): Kassza;
 //#endregion
-export { RECEIPT_MAX_GROSS_HUF as A, buyerFromCustomer as C, ChooseDocumentInput as D, ChooseDocumentBuyer as E, invoiceOnceExternalId as F, CreateOnceOptions as I, InvoiceReference as L, ProformaReference as M, InvoicePdf as N, DocumentChoice as O, InvoiceOnceResult as P, SkippedPayment as S, paymentOrderNumber as T, IssuedInvoice as _, ReceiptsApi as a, PaymentDocumentItem as b, TaxpayerInfo as c, ReceiptOnceResult as d, ConvertReceiptInput as f, IssuedDocument as g, IssueForPaymentOptions as h, KasszaOptions as i, chooseDocument as j, DocumentDecision as k, TaxpayerTaxNumber as l, conversionExternalId as m, Kassza as n, TaxpayerApi as o, ConvertedReceipt as p, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TaxpayerAddress as u, IssuedReceipt as v, issueForPayment as w, PaymentDocumentsApi as x, IssuedReversal as y };
+export { ONCE_LOCK_KEY_PREFIX as $, IssuedRefundCorrection as A, DocumentDecision as B, PaymentDocumentItem as C, issueForPayment as D, buyerFromCustomer as E, RefundProposalLine as F, RegisterPaymentOnceInput as G, chooseDocument as H, correctionExternalId as I, InvoiceReference as J, RegisteredPaymentOnce as K, ChooseDocumentBuyer as L, PartialRefundMode as M, RefundItemsContext as N, paymentOrderNumber as O, RefundItemsResolver as P, LockFailureMode as Q, ChooseDocumentInput as R, IssuedReversal as S, SkippedPayment as T, ProformaReference as U, RECEIPT_MAX_GROSS_HUF as V, InvoicePdf as W, DEFAULT_LOCK_TTL_SECONDS as X, CreateOnceOptions as Y, DEFAULT_LOCK_WAIT_MS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, OnceLockOptions as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundProposal as j, IssuedCorrection as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, paymentMarker as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentsApi as w, IssuedReceipt as x, IssuedDocument as y, DocumentChoice as z };

package/dist/{client-B5FryKxJ.d.cts → client-SVZu25MB.d.cts}

@@ -1,8 +1,31 @@
-import { E as SzamlazzError, G as InvoiceTemplate, K as InvoiceType, N as CreateInvoiceInput, P as CreatedInvoice, R as InvoiceBuyer, U as InvoicePreview, V as InvoiceLanguage, W as InvoiceSeller, Z as StandardInvoiceInput, _ as ReversedInvoice, b as RegisterPaymentInput, c as SzamlazzOptions, g as ReverseInvoiceInput, o as RequestOptions, v as ClearPaymentsInput, x as RegisteredPayment, z as InvoiceDefaults } from "./context-DXNbTPwz.cjs";
-import { _ as VatRate } from "./index-CYAGCdKJ.cjs";
-import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-DH8QoNZK.cjs";
-import { n as InvoiceDetails, t as GetInvoiceOptions } from "./get-Byc9T5WO.cjs";
-import { i as PaymentEvent, r as PaymentCustomer, s as PaymentLineItem } from "./types-BVeR7KyU.cjs";
+import { t as DateInput } from "./dates-9zvESP0i.cjs";
+import { B as InvoiceLanguage, C as ClearPaymentsInput, E as RegisteredPayment, H as InvoicePreview, L as InvoiceBuyer, M as CreateInvoiceInput, N as CreatedInvoice, R as InvoiceDefaults, S as ReversedInvoice, T as RegisterPaymentInput, U as InvoiceSeller, W as InvoiceTemplate, X as StandardInvoiceInput, l as SzamlazzOptions, s as RequestOptions, st as SzamlazzError, x as ReverseInvoiceInput } from "./context-CFNKzStE.cjs";
+import { n as KeyValueStore } from "./store-C1rHd9DB.cjs";
+import { S as VatRate, a as RefundAllocation, s as RefundableItem } from "./index-C-7yWV7L.cjs";
+import { h as SendReceiptInput, i as ReceiptDefaults, m as ReverseReceiptInput, n as GetReceiptInput, p as ReceiptVatRate, r as Receipt, s as ReceiptOnlyVatCode, t as CreateReceiptInput } from "./types-lnKkQdot.cjs";
+import { n as InvoiceDetails, o as InvoiceDetailsPayment, t as GetInvoiceOptions } from "./get-Byc9T5WO.cjs";
+import { n as InvoiceOnceResult, t as ReceiptOnceResult } from "./create-once-Bh6fOWkW.cjs";
+import { i as PaymentEvent, l as PaymentRefund, r as PaymentCustomer, s as PaymentLineItem } from "./types-B1A8mUIE.cjs";
+//#region src/core/once-guard.d.ts
+declare const ONCE_LOCK_KEY_PREFIX = "szamlazz:once:";
+declare const DEFAULT_LOCK_TTL_SECONDS = 600;
+declare const DEFAULT_LOCK_WAIT_MS = 1e4;
+type LockFailureMode = "throw" | "proceed";
+interface OnceLockOptions {
+  readonly lock?: KeyValueStore | false | undefined;
+  readonly lockTtlSeconds?: number | undefined;
+  readonly lockWaitMs?: number | undefined;
+  readonly lockFailure?: LockFailureMode | undefined;
+  readonly signal?: AbortSignal | undefined;
+}
+//#endregion
+//#region src/core/once.d.ts
+interface CreateOnceOptions extends RequestOptions, OnceLockOptions {
+  readonly lookupFirst?: boolean | undefined;
+  readonly matchOrderNumber?: boolean | undefined;
+  readonly recoveryDelayMs?: number | undefined;
+}
+//#endregion
 //#region src/invoices/reference.d.ts
 type InvoiceReference = string | {
   readonly invoiceNumber: string;
@@ -12,22 +35,25 @@ type InvoiceReference = string | {
   readonly externalId: string;
 };
 //#endregion
-//#region src/core/once.d.ts
-interface CreateOnceOptions extends RequestOptions {
-  readonly lookupFirst?: boolean | undefined;
-  readonly matchOrderNumber?: boolean | undefined;
-  readonly recoveryDelayMs?: number | undefined;
+//#region src/invoices/payment-once.d.ts
+interface RegisterPaymentOnceInput {
+  readonly invoiceNumber: string;
+  readonly key: string;
+  readonly amount: number;
+  readonly method?: string | undefined;
+  readonly date?: DateInput | undefined;
+  readonly description?: string | undefined;
+  readonly taxNumber?: string | undefined;
 }
-//#endregion
-//#region src/invoices/create-once.d.ts
-interface InvoiceOnceResult {
-  readonly number: string;
+interface RegisteredPaymentOnce {
+  readonly invoiceNumber: string;
+  readonly key: string;
+  readonly marker: string;
   readonly created: boolean;
-  readonly externalId: string;
-  readonly invoice?: CreatedInvoice | undefined;
-  readonly details?: InvoiceDetails | undefined;
+  readonly payment?: RegisteredPayment | undefined;
+  readonly existing?: InvoiceDetailsPayment | undefined;
 }
-declare function invoiceOnceExternalId(type: InvoiceType, orderNumber: string): string;
+declare function paymentMarker(key: string): string;
 //#endregion
 //#region src/invoices/pdf.d.ts
 interface InvoicePdf {
@@ -70,6 +96,44 @@ interface DocumentDecision {
 }
 declare function chooseDocument(input: ChooseDocumentInput): DocumentDecision;
 //#endregion
+//#region src/payments/partial-refund.d.ts
+type PartialRefundMode = "auto" | "proportional" | "skip";
+interface RefundItemsContext {
+  readonly refund: PaymentRefund;
+  readonly invoiceNumber: string;
+  readonly items: readonly RefundableItem[];
+}
+type RefundItemsResolver = (context: RefundItemsContext) => readonly PaymentDocumentItem[] | undefined | Promise<readonly PaymentDocumentItem[] | undefined>;
+interface IssuedRefundCorrection {
+  readonly refundId: string;
+  readonly externalId: string;
+  readonly number: string;
+  readonly created: boolean;
+  readonly grossTotal: number;
+  readonly invoice: InvoiceOnceResult;
+}
+interface IssuedCorrection {
+  readonly kind: "correction";
+  readonly orderNumber: string;
+  readonly correctedNumber: string;
+  readonly created: boolean;
+  readonly corrections: readonly IssuedRefundCorrection[];
+}
+interface RefundProposalLine {
+  readonly refundId: string;
+  readonly grossTotal: number;
+  readonly items: readonly RefundAllocation<ReceiptVatRate>[];
+}
+interface IssuedRefundProposal {
+  readonly kind: "refund-proposal";
+  readonly orderNumber: string;
+  readonly document: "receipt" | "invoice";
+  readonly documentNumber: string;
+  readonly refunds: readonly RefundProposalLine[];
+  readonly reason: string;
+}
+declare function correctionExternalId(orderNumber: string, refundId: string): Promise<string>;
+//#endregion
 //#region src/payments/issue.d.ts
 interface PaymentDocumentItem {
   readonly name: string;
@@ -96,6 +160,8 @@ interface IssueForPaymentOptions {
   readonly exchangeRate?: number | undefined;
   readonly exchangeBank?: string | undefined;
   readonly allowAmountMismatch?: boolean | undefined;
+  readonly partialRefund?: PartialRefundMode | undefined;
+  readonly refundItems?: RefundItemsResolver | undefined;
   readonly receipt?: Partial<Omit<CreateReceiptInput, "items" | "orderNumber" | "callId" | "currency" | "exchangeRate" | "exchangeBank">> | undefined;
   readonly invoice?: Partial<Omit<StandardInvoiceInput, "items" | "buyer" | "type" | "orderNumber" | "paid" | "currency" | "exchangeRate" | "exchangeBank" | "externalId">> | undefined;
   readonly recoveryDelayMs?: number | undefined;
@@ -130,7 +196,7 @@ interface SkippedPayment {
   readonly orderNumber: string;
   readonly reason: string;
 }
-type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | SkippedPayment;
+type IssuedDocument = IssuedReceipt | IssuedInvoice | IssuedReversal | IssuedCorrection | IssuedRefundProposal | SkippedPayment;
 interface PaymentDocumentsApi {
   readonly invoices: Pick<InvoicesApi, "createOnce" | "find" | "reverse">;
   readonly receipts: Pick<ReceiptsApi, "createOnce" | "find" | "reverse">;
@@ -161,12 +227,6 @@ interface ConvertedReceipt {
 }
 declare function conversionExternalId(receiptNumber: string): string;
 //#endregion
-//#region src/receipts/create-once.d.ts
-interface ReceiptOnceResult {
-  readonly receipt: Receipt;
-  readonly created: boolean;
-}
-//#endregion
 //#region src/taxpayer/address.d.ts
 type TaxpayerAddressType = "HQ" | "SITE" | "BRANCH" | (string & {});
 interface NavDetailedAddress {
@@ -222,6 +282,16 @@ interface TaxpayerInfo {
   readonly requestId?: string | undefined;
 }
 //#endregion
+//#region src/taxpayer/cache.d.ts
+declare const TAXPAYER_CACHE_KEY_PREFIX = "szamlazz:taxpayer:";
+declare const DEFAULT_TAXPAYER_TTL_SECONDS = 86400;
+declare const DEFAULT_TAXPAYER_INVALID_TTL_SECONDS = 600;
+interface TaxpayerCacheOptions {
+  readonly store: KeyValueStore;
+  readonly ttlSeconds?: number | undefined;
+  readonly invalidTtlSeconds?: number | undefined;
+}
+//#endregion
 //#region src/client.d.ts
 interface KasszaDefaults {
   readonly invoice?: InvoiceDefaults;
@@ -229,6 +299,8 @@ interface KasszaDefaults {
 }
 interface KasszaOptions extends SzamlazzOptions {
   readonly defaults?: KasszaDefaults;
+  readonly createOnceLock?: KeyValueStore | undefined;
+  readonly taxpayerCache?: TaxpayerCacheOptions | undefined;
 }
 interface InvoicesApi {
   create(input: CreateInvoiceInput, options?: RequestOptions): Promise<CreatedInvoice>;
@@ -236,6 +308,7 @@ interface InvoicesApi {
   preview(input: CreateInvoiceInput, options?: RequestOptions): Promise<InvoicePreview>;
   reverse(input: ReverseInvoiceInput, options?: RequestOptions): Promise<ReversedInvoice>;
   registerPayment(input: RegisterPaymentInput, options?: RequestOptions): Promise<RegisteredPayment>;
+  registerPaymentOnce(input: RegisterPaymentOnceInput, options?: CreateOnceOptions): Promise<RegisteredPaymentOnce>;
   clearPayments(input: ClearPaymentsInput, options?: RequestOptions): Promise<RegisteredPayment>;
   getPdf(reference: InvoiceReference, options?: RequestOptions): Promise<InvoicePdf>;
   get(reference: InvoiceReference, query?: GetInvoiceOptions, options?: RequestOptions): Promise<InvoiceDetails>;
@@ -265,4 +338,4 @@ interface Kassza {
 }
 declare function createKassza(options?: KasszaOptions): Kassza;
 //#endregion
-export { RECEIPT_MAX_GROSS_HUF as A, buyerFromCustomer as C, ChooseDocumentInput as D, ChooseDocumentBuyer as E, invoiceOnceExternalId as F, CreateOnceOptions as I, InvoiceReference as L, ProformaReference as M, InvoicePdf as N, DocumentChoice as O, InvoiceOnceResult as P, SkippedPayment as S, paymentOrderNumber as T, IssuedInvoice as _, ReceiptsApi as a, PaymentDocumentItem as b, TaxpayerInfo as c, ReceiptOnceResult as d, ConvertReceiptInput as f, IssuedDocument as g, IssueForPaymentOptions as h, KasszaOptions as i, chooseDocument as j, DocumentDecision as k, TaxpayerTaxNumber as l, conversionExternalId as m, Kassza as n, TaxpayerApi as o, ConvertedReceipt as p, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TaxpayerAddress as u, IssuedReceipt as v, issueForPayment as w, PaymentDocumentsApi as x, IssuedReversal as y };
+export { ONCE_LOCK_KEY_PREFIX as $, IssuedRefundCorrection as A, DocumentDecision as B, PaymentDocumentItem as C, issueForPayment as D, buyerFromCustomer as E, RefundProposalLine as F, RegisterPaymentOnceInput as G, chooseDocument as H, correctionExternalId as I, InvoiceReference as J, RegisteredPaymentOnce as K, ChooseDocumentBuyer as L, PartialRefundMode as M, RefundItemsContext as N, paymentOrderNumber as O, RefundItemsResolver as P, LockFailureMode as Q, ChooseDocumentInput as R, IssuedReversal as S, SkippedPayment as T, ProformaReference as U, RECEIPT_MAX_GROSS_HUF as V, InvoicePdf as W, DEFAULT_LOCK_TTL_SECONDS as X, CreateOnceOptions as Y, DEFAULT_LOCK_WAIT_MS as Z, conversionExternalId as _, ReceiptsApi as a, IssuedInvoice as b, DEFAULT_TAXPAYER_INVALID_TTL_SECONDS as c, TaxpayerCacheOptions as d, OnceLockOptions as et, TaxpayerInfo as f, ConvertedReceipt as g, ConvertReceiptInput as h, KasszaOptions as i, IssuedRefundProposal as j, IssuedCorrection as k, DEFAULT_TAXPAYER_TTL_SECONDS as l, TaxpayerAddress as m, Kassza as n, TaxpayerApi as o, TaxpayerTaxNumber as p, paymentMarker as q, KasszaDefaults as r, createKassza as s, InvoicesApi as t, TAXPAYER_CACHE_KEY_PREFIX as u, IssueForPaymentOptions as v, PaymentDocumentsApi as w, IssuedReceipt as x, IssuedDocument as y, DocumentChoice as z };

package/dist/{context-DXNbTPwz.d.cts → context-CFNKzStE.d.cts}

@@ -1,25 +1,60 @@
-import { t as CookieStore } from "./session-Dm_45x8K.cjs";
 import { t as DateInput } from "./dates-9zvESP0i.cjs";
-import { o as ItemAmounts, s as ItemPriceInput } from "./index-CYAGCdKJ.cjs";
-import { r as Receipt } from "./types-DH8QoNZK.cjs";
-//#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;
+import { a as AgentAction, r as WarningHook, t as KasszaWarning } from "./warnings-B3DXnveC.cjs";
+import { n as KeyValueStore } from "./store-C1rHd9DB.cjs";
+import { d as ItemAmounts, f as ItemPriceInput } from "./index-C-7yWV7L.cjs";
+import { r as Receipt } from "./types-lnKkQdot.cjs";
+import { t as CookieStore } from "./session-YbChChx7.cjs";
+//#region src/core/errors.d.ts
+type SzamlazzErrorCategory = "auth" | "account" | "validation" | "duplicate" | "partial_success" | "not_found" | "maintenance" | "rate_limit" | "attempt_limit" | "in_progress" | "store_unavailable" | "network" | "timeout" | "configuration" | "unexpected_response" | "unknown";
+interface AgentErrorCodeInfo {
+  readonly message: string;
+  readonly category: SzamlazzErrorCategory;
+  readonly hint?: string;
+}
+declare const AGENT_ERROR_CODES: Readonly<Record<number, AgentErrorCodeInfo>>;
+declare const KASSZA_ERROR_DOCS_URL = "https://kasszajs.hu/docs/hibakodok";
+declare function errorCodeDocsUrl(code: number | undefined): string | undefined;
+interface SzamlazzErrorOptions {
+  readonly category: SzamlazzErrorCategory;
+  readonly code?: number | undefined;
+  readonly hint?: string | undefined;
+  readonly action?: AgentAction | undefined;
+  readonly httpStatus?: number | undefined;
+  readonly rawResponse?: string | undefined;
+  readonly details?: Readonly<Record<string, string>> | undefined;
+  readonly cause?: unknown;
+}
+declare class SzamlazzError extends Error {
+  override readonly name: string;
+  readonly code: number | undefined;
+  readonly category: SzamlazzErrorCategory;
+  readonly retryable: boolean;
+  readonly hint: string | undefined;
+  readonly action: AgentAction | undefined;
+  readonly httpStatus: number | undefined;
+  readonly rawResponse: string | undefined;
+  readonly details: Readonly<Record<string, string>> | undefined;
+  constructor(message: string, options: SzamlazzErrorOptions);
+  get docsUrl(): string | undefined;
+  get isDuplicate(): boolean;
+  get isNotFound(): boolean;
+}
+declare function isSzamlazzError(error: unknown): error is SzamlazzError;
+declare function suggestedPrefix(error: unknown): string | undefined;
+//#endregion
+//#region src/core/attempt-ledger.d.ts
+declare const ATTEMPT_LEDGER_TTL_SECONDS = 86400;
+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;
+  }[];
+}
+declare function attemptLedgerKey(request: AttemptLedgerRequest): Promise<string>;
+type AttemptLedgerMode = "fail-open" | "fail-closed";
 //#endregion
 //#region src/invoices/create-types.d.ts
 type InvoiceType = "invoice" | "proforma" | "advance" | "final" | "corrective" | "deliveryNote";
@@ -209,41 +244,6 @@ interface InvoicePreview {
   readonly items: readonly CreatedInvoiceItem[];
 }
 //#endregion
-//#region src/core/errors.d.ts
-type SzamlazzErrorCategory = "auth" | "account" | "validation" | "duplicate" | "partial_success" | "not_found" | "maintenance" | "rate_limit" | "attempt_limit" | "network" | "timeout" | "configuration" | "unexpected_response" | "unknown";
-interface AgentErrorCodeInfo {
-  readonly message: string;
-  readonly category: SzamlazzErrorCategory;
-  readonly hint?: string;
-}
-declare const AGENT_ERROR_CODES: Readonly<Record<number, AgentErrorCodeInfo>>;
-interface SzamlazzErrorOptions {
-  readonly category: SzamlazzErrorCategory;
-  readonly code?: number | undefined;
-  readonly hint?: string | undefined;
-  readonly action?: AgentAction | undefined;
-  readonly httpStatus?: number | undefined;
-  readonly rawResponse?: string | undefined;
-  readonly details?: Readonly<Record<string, string>> | undefined;
-  readonly cause?: unknown;
-}
-declare class SzamlazzError extends Error {
-  override readonly name: string;
-  readonly code: number | undefined;
-  readonly category: SzamlazzErrorCategory;
-  readonly retryable: boolean;
-  readonly hint: string | undefined;
-  readonly action: AgentAction | undefined;
-  readonly httpStatus: number | undefined;
-  readonly rawResponse: string | undefined;
-  readonly details: Readonly<Record<string, string>> | undefined;
-  constructor(message: string, options: SzamlazzErrorOptions);
-  get isDuplicate(): boolean;
-  get isNotFound(): boolean;
-}
-declare function isSzamlazzError(error: unknown): error is SzamlazzError;
-declare function suggestedPrefix(error: unknown): string | undefined;
-//#endregion
 //#region src/core/response.d.ts
 interface AgentResponse {
   readonly action: AgentAction;
@@ -366,6 +366,16 @@ interface ReceiptReversedEvent {
 }
 type DocumentEvent = InvoiceCreatedEvent | InvoiceReversedEvent | InvoicePaymentEvent | ReceiptCreatedEvent | ReceiptReversedEvent;
 type DocumentHook = (event: DocumentEvent) => void | Promise<void>;
+type DocumentErrorHandler = (error: unknown, event: DocumentEvent) => void | Promise<void>;
+type DocumentErrorMode = "warn" | "throw" | DocumentErrorHandler;
+declare class DocumentHookError extends Error {
+  override readonly name: string;
+  readonly event: DocumentEvent;
+  constructor(event: DocumentEvent, cause: unknown);
+  get number(): string;
+  get document(): DocumentEvent["document"];
+}
+declare function isDocumentHookError(error: unknown): error is DocumentHookError;
 //#endregion
 //#region src/core/context.d.ts
 interface AgentAttachment {
@@ -376,20 +386,32 @@ interface AgentAttachment {
 interface AgentRequestEvent {
   readonly action: AgentAction;
   readonly attempt: number;
+  readonly requestId: string;
 }
 interface AgentResponseEvent extends AgentRequestEvent {
   readonly status: number;
   readonly durationMs: number;
+  readonly responseBytes: number;
+  readonly sessionReused: boolean;
 }
 interface AgentErrorEvent extends AgentRequestEvent {
   readonly error: SzamlazzError;
   readonly willRetry: boolean;
 }
+interface AgentCompleteEvent extends AgentRequestEvent {
+  readonly outcome: "success" | "error";
+  readonly durationMs: number;
+  readonly error?: SzamlazzError | undefined;
+  readonly willRetry: boolean;
+}
 interface SzamlazzHooks {
   readonly onRequest?: (event: AgentRequestEvent) => void;
   readonly onResponse?: (event: AgentResponseEvent) => void;
   readonly onError?: (event: AgentErrorEvent) => void;
+  readonly onComplete?: (event: AgentCompleteEvent) => void;
   readonly onDocument?: DocumentHook;
+  readonly onDocumentError?: DocumentErrorMode;
+  readonly onWarning?: (warning: KasszaWarning) => void;
 }
 interface SzamlazzOptions {
   readonly agentKey?: string;
@@ -401,7 +423,8 @@ interface SzamlazzOptions {
   readonly maxAttempts?: number;
   readonly retryDelayMs?: number;
   readonly cookieStore?: CookieStore | false;
-  readonly attemptLedger?: CookieStore | undefined;
+  readonly attemptLedger?: KeyValueStore | undefined;
+  readonly attemptLedgerMode?: AttemptLedgerMode | undefined;
   readonly maintenanceCooldownMs?: number | undefined;
   readonly hooks?: SzamlazzHooks;
 }
@@ -417,9 +440,10 @@ interface AgentRequest {
 }
 interface AgentContext {
   readonly credentials: readonly XmlNode[];
+  readonly warn?: WarningHook | undefined;
   execute<T>(request: AgentRequest, parse: (response: AgentResponse) => T | Promise<T>): Promise<T>;
   resetSession(): Promise<void>;
   resetAttempts(key: string): Promise<void>;
 }
 //#endregion
-export { TransOFlexWaybill as $, BuyerLedger as A, InvoiceItemInput as B, AgentResponse as C, SzamlazzErrorCategory as D, SzamlazzError as E, CreatedInvoiceItem as F, InvoiceTemplate as G, InvoicePostalAddress as H, Currency as I, MplWaybill as J, InvoiceType as K, FinalInvoiceInput as L, CourierService as M, CreateInvoiceInput as N, isSzamlazzError as O, CreatedInvoice as P, TaxpayerType as Q, InvoiceBuyer as R, XmlNode as S, AgentErrorCodeInfo as T, InvoicePreview as U, InvoiceLanguage as V, InvoiceSeller as W, SprinterWaybill as X, PickPackPointWaybill as Y, StandardInvoiceInput as Z, ReversedInvoice as _, AgentResponseEvent as a, RegisterPaymentInput as b, SzamlazzOptions as c, InvoiceCreatedEvent as d, Waybill as et, InvoicePaymentEvent as f, ReverseInvoiceInput as g, ReceiptReversedEvent as h, AgentRequestEvent as i, SZAMLAZZ_AGENT_URL as it, CorrectiveInvoiceInput as j, suggestedPrefix as k, DocumentEvent as l, ReceiptCreatedEvent as m, AgentContext as n, AgentAction as nt, RequestOptions as o, InvoiceReversedEvent as p, ItemLedger as q, AgentErrorEvent as r, MAX_INVOICE_ATTACHMENTS as rt, SzamlazzHooks as s, AgentAttachment as t, AGENT_ACTIONS as tt, DocumentHook as u, ClearPaymentsInput as v, AGENT_ERROR_CODES as w, RegisteredPayment as x, PaymentEntry as y, InvoiceDefaults as z };
+export { Waybill as $, CorrectiveInvoiceInput as A, InvoiceLanguage as B, ClearPaymentsInput as C, XmlNode as D, RegisteredPayment as E, Currency as F, InvoiceType as G, InvoicePreview as H, FinalInvoiceInput as I, PickPackPointWaybill as J, ItemLedger as K, InvoiceBuyer as L, CreateInvoiceInput as M, CreatedInvoice as N, AgentResponse as O, CreatedInvoiceItem as P, TransOFlexWaybill as Q, InvoiceDefaults as R, ReversedInvoice as S, RegisterPaymentInput as T, InvoiceSeller as U, InvoicePostalAddress as V, InvoiceTemplate as W, StandardInvoiceInput as X, SprinterWaybill as Y, TaxpayerType as Z, InvoiceReversedEvent as _, AgentRequestEvent as a, AgentErrorCodeInfo as at, isDocumentHookError as b, SzamlazzHooks as c, SzamlazzErrorCategory as ct, DocumentErrorMode as d, suggestedPrefix as dt, ATTEMPT_LEDGER_KEY_PREFIX as et, DocumentEvent as f, InvoicePaymentEvent as g, InvoiceCreatedEvent as h, AgentErrorEvent as i, AGENT_ERROR_CODES as it, CourierService as j, BuyerLedger as k, SzamlazzOptions as l, errorCodeDocsUrl as lt, DocumentHookError as m, AgentCompleteEvent as n, AttemptLedgerMode as nt, AgentResponseEvent as o, KASSZA_ERROR_DOCS_URL as ot, DocumentHook as p, MplWaybill as q, AgentContext as r, attemptLedgerKey as rt, RequestOptions as s, SzamlazzError as st, AgentAttachment as t, ATTEMPT_LEDGER_TTL_SECONDS as tt, DocumentErrorHandler as u, isSzamlazzError as ut, ReceiptCreatedEvent as v, PaymentEntry as w, ReverseInvoiceInput as x, ReceiptReversedEvent as y, InvoiceItemInput as z };