kassza 0.12.0 → 0.13.0

package/dist/context-BxQlIlug.d.ts

@@ -0,0 +1,425 @@
+import { t as CookieStore } from "./session-Dm_45x8K.js";
+import { t as DateInput } from "./dates-9zvESP0i.js";
+import { o as ItemAmounts, s as ItemPriceInput } from "./index-CYAGCdKJ.js";
+import { r as Receipt } from "./types-k--zHf4l.js";
+//#region src/core/actions.d.ts
+declare const SZAMLAZZ_AGENT_URL = "https://www.szamlazz.hu/szamla/";
+declare const AGENT_ACTIONS: {
+  readonly createInvoice: "action-xmlagentxmlfile";
+  readonly reverseInvoice: "action-szamla_agent_st";
+  readonly registerPayment: "action-szamla_agent_kifiz";
+  readonly getInvoicePdf: "action-szamla_agent_pdf";
+  readonly getInvoiceXml: "action-szamla_agent_xml";
+  readonly deleteProforma: "action-szamla_agent_dijbekero_torlese";
+  readonly createReceipt: "action-szamla_agent_nyugta_create";
+  readonly reverseReceipt: "action-szamla_agent_nyugta_storno";
+  readonly getReceipt: "action-szamla_agent_nyugta_get";
+  readonly sendReceipt: "action-szamla_agent_nyugta_send";
+  readonly queryTaxpayer: "action-szamla_agent_taxpayer";
+  readonly connectPrincipal: "action-agent_ceg_mb";
+};
+type AgentAction = keyof typeof AGENT_ACTIONS;
+declare const MAX_INVOICE_ATTACHMENTS = 5;
+//#endregion
+//#region src/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/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;
+  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>;
+//#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;
+}
+interface AgentResponseEvent extends AgentRequestEvent {
+  readonly status: number;
+  readonly durationMs: number;
+}
+interface AgentErrorEvent extends AgentRequestEvent {
+  readonly error: SzamlazzError;
+  readonly willRetry: boolean;
+}
+interface SzamlazzHooks {
+  readonly onRequest?: (event: AgentRequestEvent) => void;
+  readonly onResponse?: (event: AgentResponseEvent) => void;
+  readonly onError?: (event: AgentErrorEvent) => void;
+  readonly onDocument?: DocumentHook;
+}
+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?: CookieStore | 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[];
+  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 };