kassza 0.12.0 → 0.14.0

package/dist/context-CFNKzStE.d.cts

@@ -0,0 +1,449 @@
+import { t as DateInput } from "./dates-9zvESP0i.cjs";
+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";
+declare const INVOICE_LANGUAGES: readonly ["hu", "en", "de", "it", "ro", "sk", "hr", "fr", "es", "cz", "pl", "bg", "nl", "ru", "si"];
+type InvoiceLanguage = (typeof INVOICE_LANGUAGES)[number];
+declare const INVOICE_TEMPLATES: readonly ["SzlaMost", "SzlaAlap", "SzlaNoEnv", "Szla8cm", "SzlaTomb", "SzlaFuvarlevelesAlap"];
+type InvoiceTemplate = (typeof INVOICE_TEMPLATES)[number];
+declare const CURRENCIES: readonly ["HUF", "Ft", "EUR", "CHF", "USD", "AED", "ALL", "AUD", "BAM", "BGN", "BRL", "CAD", "CNY", "CZK", "DKK", "EEK", "GBP", "HKD", "HRK", "IDR", "ILS", "INR", "ISK", "JPY", "KRW", "KWD", "KSH", "KZT", "LTL", "LVL", "MXN", "MYR", "NOK", "NZD", "PHP", "PLN", "RON", "RSD", "RUB", "SEK", "SGD", "THB", "TRY", "TWD", "UAH", "VND", "ZAR"];
+type Currency = (typeof CURRENCIES)[number] | (string & {});
+type TaxpayerType = "nonEuBusiness" | "euBusiness" | "hungarianTaxNumber" | "unknown" | "noTaxNumber";
+type CourierService = "TOF" | "PPP" | "SPRINTER" | "FOXPOST" | "MPL" | "GLS" | "EMPTY" | (string & {});
+interface InvoiceSeller {
+  readonly bank?: string | undefined;
+  readonly bankAccount?: string | undefined;
+  readonly emailReplyTo?: string | undefined;
+  readonly emailSubject?: string | undefined;
+  readonly emailText?: string | undefined;
+  readonly signatoryName?: string | undefined;
+}
+interface InvoicePostalAddress {
+  readonly name?: string | undefined;
+  readonly country?: string | undefined;
+  readonly zip?: string | undefined;
+  readonly city?: string | undefined;
+  readonly address?: string | undefined;
+}
+interface BuyerLedger {
+  readonly bookingDate?: DateInput | undefined;
+  readonly buyerId?: string | undefined;
+  readonly ledgerAccount?: string | undefined;
+  readonly continuousFulfillment?: boolean | undefined;
+  readonly settlementPeriodStart?: DateInput | undefined;
+  readonly settlementPeriodEnd?: DateInput | undefined;
+}
+interface InvoiceBuyer {
+  readonly name: string;
+  readonly country?: string | undefined;
+  readonly zip: string;
+  readonly city: string;
+  readonly address: string;
+  readonly email?: string | undefined;
+  readonly sendEmail?: boolean | undefined;
+  readonly taxpayerType?: TaxpayerType | undefined;
+  readonly taxNumber?: string | undefined;
+  readonly groupTaxNumber?: string | undefined;
+  readonly euTaxNumber?: string | undefined;
+  readonly postal?: InvoicePostalAddress | undefined;
+  readonly ledger?: BuyerLedger | undefined;
+  readonly identifier?: string | undefined;
+  readonly signatoryName?: string | undefined;
+  readonly phone?: string | undefined;
+  readonly comment?: string | undefined;
+}
+interface ItemLedger {
+  readonly economicEvent?: string | undefined;
+  readonly vatEconomicEvent?: string | undefined;
+  readonly revenueLedgerAccount?: string | undefined;
+  readonly vatLedgerAccount?: string | undefined;
+  readonly settlementPeriodStart?: DateInput | undefined;
+  readonly settlementPeriodEnd?: DateInput | undefined;
+}
+type InvoiceItemInput = ItemPriceInput & {
+  readonly name: string;
+  readonly identifier?: string | undefined;
+  readonly unit?: string | undefined;
+  readonly comment?: string | undefined;
+  readonly ledger?: ItemLedger | undefined;
+  readonly dataDeletionCode?: number | undefined;
+  readonly marginVatBase?: number | undefined;
+};
+interface TransOFlexWaybill {
+  readonly id?: string | undefined;
+  readonly shipmentId?: string | undefined;
+  readonly packageCount?: number | undefined;
+  readonly countryCode?: string | undefined;
+  readonly zip?: string | undefined;
+  readonly service?: string | undefined;
+}
+interface PickPackPointWaybill {
+  readonly barcodePrefix?: string | undefined;
+  readonly barcodePostfix?: string | undefined;
+}
+interface SprinterWaybill {
+  readonly id?: string | undefined;
+  readonly senderCode?: string | undefined;
+  readonly directionCode?: string | undefined;
+  readonly packageCount?: number | undefined;
+  readonly barcodePostfix?: string | undefined;
+  readonly deliveryTime?: string | undefined;
+}
+interface MplWaybill {
+  readonly customerCode: string;
+  readonly barcode: string;
+  readonly weight: string | number;
+  readonly services?: string | undefined;
+  readonly declaredValue?: number | undefined;
+}
+interface Waybill {
+  readonly courier?: CourierService | undefined;
+  readonly barcode?: string | undefined;
+  readonly comment?: string | undefined;
+  readonly transOFlex?: TransOFlexWaybill | undefined;
+  readonly pickPackPoint?: PickPackPointWaybill | undefined;
+  readonly sprinter?: SprinterWaybill | undefined;
+  readonly mpl?: MplWaybill | undefined;
+}
+interface InvoiceDefaults {
+  readonly seller?: InvoiceSeller | undefined;
+  readonly prefix?: string | undefined;
+  readonly language?: InvoiceLanguage | undefined;
+  readonly currency?: Currency | undefined;
+  readonly exchangeBank?: string | undefined;
+  readonly paymentMethod?: string | undefined;
+  readonly paymentDueInDays?: number | undefined;
+  readonly eInvoice?: boolean | undefined;
+  readonly downloadPdf?: boolean | undefined;
+  readonly template?: InvoiceTemplate | undefined;
+  readonly sendEmail?: boolean | undefined;
+  readonly logoExtra?: string | undefined;
+  readonly simpleItems?: boolean | undefined;
+  readonly euVat?: boolean | undefined;
+  readonly aggregator?: string | undefined;
+  readonly guardian?: boolean | undefined;
+  readonly articleIdentifierInvoice?: boolean | undefined;
+}
+interface CreateInvoiceBase {
+  readonly buyer: InvoiceBuyer;
+  readonly items: readonly InvoiceItemInput[];
+  readonly seller?: InvoiceSeller | undefined;
+  readonly issueDate?: DateInput | undefined;
+  readonly fulfillmentDate?: DateInput | undefined;
+  readonly dueDate?: DateInput | undefined;
+  readonly paymentDueInDays?: number | undefined;
+  readonly paymentMethod?: string | undefined;
+  readonly currency?: Currency | undefined;
+  readonly exchangeRate?: number | undefined;
+  readonly exchangeBank?: string | undefined;
+  readonly language?: InvoiceLanguage | undefined;
+  readonly comment?: string | undefined;
+  readonly orderNumber?: string | undefined;
+  readonly proformaNumber?: string | undefined;
+  readonly prefix?: string | undefined;
+  readonly paid?: boolean | undefined;
+  readonly eInvoice?: boolean | undefined;
+  readonly downloadPdf?: boolean | undefined;
+  readonly externalId?: string | undefined;
+  readonly template?: InvoiceTemplate | undefined;
+  readonly simpleItems?: boolean | undefined;
+  readonly logoExtra?: string | undefined;
+  readonly paymentCorrection?: number | undefined;
+  readonly marginVat?: boolean | undefined;
+  readonly euVat?: boolean | undefined;
+  readonly aggregator?: string | undefined;
+  readonly guardian?: boolean | undefined;
+  readonly articleIdentifierInvoice?: boolean | undefined;
+  readonly waybill?: Waybill | undefined;
+  readonly attachments?: readonly AgentAttachment[] | undefined;
+}
+interface StandardInvoiceInput extends CreateInvoiceBase {
+  readonly type?: "invoice" | "proforma" | "advance" | "deliveryNote" | undefined;
+}
+interface FinalInvoiceInput extends CreateInvoiceBase {
+  readonly type: "final";
+  readonly advanceInvoiceNumber?: string | undefined;
+}
+interface CorrectiveInvoiceInput extends CreateInvoiceBase {
+  readonly type: "corrective";
+  readonly correctedInvoiceNumber: string;
+}
+type CreateInvoiceInput = StandardInvoiceInput | FinalInvoiceInput | CorrectiveInvoiceInput;
+type CreatedInvoiceItem = ItemAmounts & {
+  readonly name: string;
+};
+interface CreatedInvoice {
+  readonly number: string;
+  readonly netTotal: number;
+  readonly grossTotal: number;
+  readonly outstanding?: number | undefined;
+  readonly buyerAccountUrl?: string | undefined;
+  readonly pdf?: Uint8Array | undefined;
+  readonly items: readonly CreatedInvoiceItem[];
+}
+interface InvoicePreview {
+  readonly pdf: Uint8Array;
+  readonly netTotal: number;
+  readonly grossTotal: number;
+  readonly items: readonly CreatedInvoiceItem[];
+}
+//#endregion
+//#region src/core/response.d.ts
+interface AgentResponse {
+  readonly action: AgentAction;
+  readonly status: number;
+  readonly headers: Headers;
+  readonly body: Uint8Array;
+  readonly isPdf: boolean;
+  text(): string;
+}
+//#endregion
+//#region src/core/xml/serialize.d.ts
+type XmlScalar = string | number | boolean;
+type XmlContent = XmlScalar | null | undefined | readonly XmlChild[];
+type XmlChild = XmlNode | false | null | undefined;
+type XmlAttributes = Readonly<Record<string, string>>;
+interface XmlNode {
+  readonly name: string;
+  readonly content: XmlContent;
+  readonly attributes?: XmlAttributes | undefined;
+}
+//#endregion
+//#region src/invoices/payment.d.ts
+interface PaymentEntry {
+  readonly date?: DateInput | undefined;
+  readonly method: string;
+  readonly amount: number;
+  readonly description?: string | undefined;
+}
+interface PaymentTarget {
+  readonly invoiceNumber: string;
+  readonly taxNumber?: string | undefined;
+}
+interface RegisterPaymentsInput extends PaymentTarget {
+  readonly additive?: boolean | undefined;
+  readonly payments: readonly PaymentEntry[];
+}
+interface RegisterSinglePaymentInput extends PaymentTarget {
+  readonly additive?: boolean | undefined;
+  readonly amount: number;
+  readonly method?: string | undefined;
+  readonly date?: DateInput | undefined;
+  readonly description?: string | undefined;
+}
+type RegisterPaymentInput = RegisterPaymentsInput | RegisterSinglePaymentInput;
+type ClearPaymentsInput = string | PaymentTarget;
+interface RegisteredPayment {
+  readonly invoiceNumber: string;
+  readonly netTotal?: number | undefined;
+  readonly grossTotal?: number | undefined;
+  readonly outstanding?: number | undefined;
+  readonly buyerAccountUrl?: string | undefined;
+}
+//#endregion
+//#region src/invoices/reverse.d.ts
+interface ReverseInvoiceEmail {
+  readonly replyTo?: string | undefined;
+  readonly subject?: string | undefined;
+  readonly text?: string | undefined;
+}
+interface ReverseInvoiceBuyer {
+  readonly email?: string | undefined;
+  readonly taxNumber?: string | undefined;
+  readonly euTaxNumber?: string | undefined;
+}
+interface ReverseInvoiceOptions {
+  readonly invoiceNumber: string;
+  readonly issueDate?: DateInput | undefined;
+  readonly fulfillmentDate?: DateInput | undefined;
+  readonly comment?: string | undefined;
+  readonly template?: InvoiceTemplate | undefined;
+  readonly eInvoice?: boolean | undefined;
+  readonly downloadPdf?: boolean | undefined;
+  readonly externalId?: string | undefined;
+  readonly email?: ReverseInvoiceEmail | undefined;
+  readonly buyer?: ReverseInvoiceBuyer | undefined;
+}
+type ReverseInvoiceInput = string | ReverseInvoiceOptions;
+interface ReversedInvoice {
+  readonly number: string;
+  readonly netTotal?: number | undefined;
+  readonly grossTotal?: number | undefined;
+  readonly outstanding?: number | undefined;
+  readonly buyerAccountUrl?: string | undefined;
+  readonly pdf?: Uint8Array | undefined;
+}
+//#endregion
+//#region src/core/document-events.d.ts
+interface InvoiceCreatedEvent {
+  readonly kind: "invoice";
+  readonly action: "created";
+  readonly number: string;
+  readonly document: CreatedInvoice;
+  readonly input: CreateInvoiceInput;
+}
+interface InvoiceReversedEvent {
+  readonly kind: "invoice";
+  readonly action: "reversed";
+  readonly number: string;
+  readonly reversedNumber: string;
+  readonly document: ReversedInvoice;
+}
+interface InvoicePaymentEvent {
+  readonly kind: "invoice";
+  readonly action: "payment";
+  readonly number: string;
+  readonly document: RegisteredPayment;
+}
+interface ReceiptCreatedEvent {
+  readonly kind: "receipt";
+  readonly action: "created";
+  readonly number: string;
+  readonly document: Receipt;
+}
+interface ReceiptReversedEvent {
+  readonly kind: "receipt";
+  readonly action: "reversed";
+  readonly number: string;
+  readonly reversedNumber: string;
+  readonly document: Receipt;
+}
+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 {
+  readonly filename: string;
+  readonly content: Uint8Array | ArrayBuffer | Blob | string;
+  readonly contentType?: string;
+}
+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;
+  readonly username?: string;
+  readonly password?: string;
+  readonly endpoint?: string;
+  readonly fetch?: typeof globalThis.fetch;
+  readonly timeoutMs?: number;
+  readonly maxAttempts?: number;
+  readonly retryDelayMs?: number;
+  readonly cookieStore?: CookieStore | false;
+  readonly attemptLedger?: KeyValueStore | undefined;
+  readonly attemptLedgerMode?: AttemptLedgerMode | undefined;
+  readonly maintenanceCooldownMs?: number | undefined;
+  readonly hooks?: SzamlazzHooks;
+}
+interface RequestOptions {
+  readonly signal?: AbortSignal | undefined;
+}
+interface AgentRequest {
+  readonly action: AgentAction;
+  readonly xml: string;
+  readonly attachments?: readonly AgentAttachment[];
+  readonly signal?: AbortSignal | undefined;
+  readonly safeToRetry?: boolean;
+}
+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 { 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 };