@kreiseck/kasseneck-api 0.6.46 → 0.6.49

package/dist/cjs/register/pairing.js

@@ -5,6 +5,7 @@ exports.cancelScopeOf = cancelScopeOf;
 exports.receiptsScopeOf = receiptsScopeOf;
 exports.pairRegisterDevice = pairRegisterDevice;
 exports.unpairRegisterDevice = unpairRegisterDevice;
+exports.listRegisterSessionsForDevice = listRegisterSessionsForDevice;
 exports.listRegisterUsersForDevice = listRegisterUsersForDevice;
 exports.registerUserLogin = registerUserLogin;
 exports.registerPinLogin = registerPinLogin;
@@ -119,6 +120,48 @@ async function unpairRegisterDevice(options) {
     pflicht(name, 'deviceSecret', deviceSecret);
     await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
 }
+/**
+ * Welche Sitzungen haelt diese Kasse gerade?
+ *
+ * Fuer den Anmeldebildschirm: Sind alle Lizenzplaetze belegt, muss eine
+ * weichen -- und der Kassier soll sehen, WELCHE, statt dass das Backend still
+ * die aelteste nimmt. Die Wahl geht dann als
+ * [RegisterUserLoginOptions.takeoverSessionId] mit.
+ *
+ * Ausgewiesen wird sich ueber das Geraete-Geheimnis, wie bei
+ * [listRegisterUsersForDevice]: An diesem Punkt gibt es weder Sitzung noch
+ * Token. Die Kasse bestimmt das Backend aus dem Geraet, nicht aus dem Aufruf.
+ */
+async function listRegisterSessionsForDevice(options) {
+    const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
+    const name = 'listRegisterSessionsForDevice';
+    pflicht(name, 'ownerUid', ownerUid);
+    pflicht(name, 'deviceId', deviceId);
+    pflicht(name, 'deviceSecret', deviceSecret);
+    const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
+    const liste = daten?.sessions;
+    if (!Array.isArray(liste)) {
+        throw antwortfehler(name, 'Antwort enthaelt keine Sitzungsliste (data.sessions fehlt)');
+    }
+    const sessions = liste.map((eintrag) => {
+        const roh = (typeof eintrag === 'object' && eintrag !== null ? eintrag : {});
+        return {
+            // Ohne Kennung waere die Zeile nicht waehlbar -- eine Schaltflaeche, die
+            // nichts tun kann, ist schlimmer als keine.
+            id: pflichtfeld(name, roh, 'id'),
+            deviceId: typeof roh['deviceId'] === 'string' && roh['deviceId'] ? roh['deviceId'] : null,
+            deviceLabel: text(roh['deviceLabel']) || 'Kasse',
+            startedAt: typeof roh['startedAt'] === 'number' ? roh['startedAt'] : null,
+            expiresAt: typeof roh['expiresAt'] === 'number' ? roh['expiresAt'] : null,
+            selbst: roh['selbst'] === true,
+            // Nur uebernehmen, wenn wirklich einer kam: ein leerer String stuende
+            // in der Oberflaeche als namenlose Zeile, statt die Spalte wegzulassen.
+            ...(typeof roh['userName'] === 'string' && roh['userName'] ? { userName: roh['userName'] } : {}),
+        };
+    });
+    const licenses = typeof daten?.licenses === 'number' && daten.licenses > 0 ? daten.licenses : 1;
+    return { licenses, sessions };
+}
 async function listRegisterUsersForDevice(options) {
     const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
     const name = 'listRegisterUsersForDevice';
@@ -192,7 +235,7 @@ function regel(wert) {
  * sperren gestaffelt (ab dem fuenften 30 Sekunden, ab dem neunten 15 Minuten).
  */
 async function registerUserLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerUserLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -210,6 +253,9 @@ async function registerUserLogin(options) {
         // Nur die ausdrueckliche Uebernahme geht mit: das Backend prueft auf
         // `=== true`, und ein mitgesendetes `false` waere nur Rauschen.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);
@@ -221,7 +267,7 @@ async function registerUserLogin(options) {
  * zaehlen und sperren dort am **Geraet**, nicht an einem Benutzer.
  */
 async function registerPinLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerPinLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -236,6 +282,9 @@ async function registerPinLogin(options) {
         cashregisterId,
         // Nur die ausdrueckliche Uebernahme geht mit — wie bei registerUserLogin.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);

package/dist/esm/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["cancelReceipt", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getFirstReceiptDate", "getKasseSettings", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listRegisterUsersForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice"];
+export declare const AUFRUFE: readonly ["cancelReceipt", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getFirstReceiptDate", "getKasseSettings", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/esm/client/aufrufe.js

@@ -21,6 +21,7 @@ export const AUFRUFE = [
     'listMyReceipts',
     'listMyTipRecipients',
     'listRegisterUsersForDevice',
+    'listRegisterSessionsForDevice',
     'pairRegisterDevice',
     'registerPinLogin',
     'registerUserLogin',

package/dist/esm/client/errors.d.ts

@@ -76,7 +76,13 @@ export declare class KasseneckApiError extends Error {
     readonly functionName: string;
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     readonly serverMessage: string;
-    constructor(functionName: string, serverMessage: string);
+    /**
+     * Stabiler Fehlercode des Backends (`code` aus der Huelle), wenn der
+     * Endpunkt einen legt — heute `cancelReceipt` (siehe CANCELLATION_ERROR_CODES).
+     * Daran entscheiden, nie an [serverMessage]: der Text darf sich aendern.
+     */
+    readonly code: string | undefined;
+    constructor(functionName: string, serverMessage: string, code?: string);
 }
 /** Warum die Antwort keine verwertbare Huelle war. */
 export type HttpFailureReason = 'server-error' | 'empty-body' | 'not-json' | 'missing-status';

package/dist/esm/client/errors.js

@@ -92,10 +92,17 @@ export class KasseneckApiError extends Error {
     functionName;
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     serverMessage;
-    constructor(functionName, serverMessage) {
+    /**
+     * Stabiler Fehlercode des Backends (`code` aus der Huelle), wenn der
+     * Endpunkt einen legt — heute `cancelReceipt` (siehe CANCELLATION_ERROR_CODES).
+     * Daran entscheiden, nie an [serverMessage]: der Text darf sich aendern.
+     */
+    code;
+    constructor(functionName, serverMessage, code) {
         super(`${functionName} fehlgeschlagen: ${serverMessage}`);
         this.functionName = functionName;
         this.serverMessage = serverMessage;
+        this.code = code;
     }
 }
 const GRUND_TEXT = {

package/dist/esm/client/receipts.d.ts

@@ -54,6 +54,22 @@ export interface TipOptions {
     paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
     /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
     recipients?: TipRecipientShare[];
+    /**
+     * Hat der Empfaenger das Geld schon? `true` = ja (Bargeld mitgenommen,
+     * Kartentrinkgeld sofort aus der Lade ausgezahlt), `false` = der Betrieb
+     * behaelt es und schuldet es.
+     *
+     * Entscheidend ist NICHT die Zahlart, sondern der Besitz -- § 2j Abs 2 AVRAG
+     * kennt beide Faelle. Ohne Angabe gilt die Voreinstellung des Betriebs (bar:
+     * schon erhalten, bargeldlos: einbehalten); diese Angabe braucht es nur fuer
+     * die Ausnahme.
+     *
+     * NUR mit dem Recht `tipAssign` bei persoenlicher Anmeldung: das Merkmal
+     * entscheidet, ob der Betrieb Geld schuldet, und gewoehnliches Personal soll
+     * das nicht am Geraet umstellen koennen. Ueber einen Geraete-API-Schluessel
+     * (ohne angemeldeten Kassen-Benutzer) gilt die Einschraenkung nicht.
+     */
+    sofortErhalten?: boolean;
 }
 export interface TipRecipientShare {
     registerUserId: string;

package/dist/esm/client/receipts.js

@@ -385,6 +385,16 @@ function gepruefterTip(tip) {
     const nutzlast = { cents: tip.cents };
     if (tip.paymentMethod != null)
         nutzlast['paymentMethod'] = gepruefteZahlungsart(tip.paymentMethod);
+    // Nur mitschicken, wenn gesetzt: fehlt das Feld, entscheidet die
+    // Voreinstellung des Betriebs. Ein `false` waere dort eine Aussage, kein
+    // Weglassen. Der Wortlaut des Fehlers ist der des Backends
+    // (tip-core.normalizeTip) -- wer ihn hier sieht, sieht denselben Satz.
+    if (tip.sofortErhalten != null) {
+        if (typeof tip.sofortErhalten !== 'boolean') {
+            throw eingabefehler('Trinkgeld: sofortErhalten muss true oder false sein.');
+        }
+        nutzlast['sofortErhalten'] = tip.sofortErhalten;
+    }
     if (tip.recipients != null) {
         if (!Array.isArray(tip.recipients) || tip.recipients.length === 0) {
             throw eingabefehler('Trinkgeld: recipients darf nicht leer sein.');

package/dist/esm/client/transport.js

@@ -176,7 +176,7 @@ function jsonAuswerten(text, functionName, statusCode, inhaltstyp) {
     }
     // Alles, was nicht ausdruecklich Erfolg ist, gilt als fachlicher Fehler —
     // ein unbekannter Statuswert darf nie stillschweigend als Erfolg durchgehen.
-    throw fachfehler(functionName, huelle.message);
+    throw fachfehler(functionName, huelle.message, huelle.code);
 }
 /**
  * Auswertung des Binaerwegs. Der Kern der Zusage: **ein Aufrufer bekommt nie
@@ -222,7 +222,7 @@ function pdfAuswerten(bytes, functionName, statusCode, inhaltstyp) {
     }
     // Derselbe fachliche Fehler wie auf dem JSON-Weg — fuer den Aufrufer macht
     // es keinen Unterschied, ob er ein PDF oder eine Nutzlast erwartet hat.
-    throw fachfehler(functionName, huelle.message);
+    throw fachfehler(functionName, huelle.message, huelle.code);
 }
 /** `%PDF` am Anfang — die Kennung jeder PDF-Datei. */
 function istPdf(bytes) {
@@ -235,9 +235,10 @@ function alsHuelle(wert) {
     }
     return wert;
 }
-function fachfehler(functionName, message) {
+function fachfehler(functionName, message, code) {
     const meldung = typeof message === 'string' && message.trim() ? message : 'Unbekannter Fehler';
-    return new KasseneckApiError(functionName, meldung);
+    // Nur ein Text zaehlt als Code -- alles andere waere ein geratener Vertrag.
+    return new KasseneckApiError(functionName, meldung, typeof code === 'string' && code ? code : undefined);
 }
 /**
  * Nutzlast aus Auth- und Aufruferparametern. Auth-Parameter bilden die

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, AUFRUFE, type Aufruf, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 export { ReceiptType, VatRate, KeckPaymentMethod, CreditCardProvider, VoucherType, VoucherAction, StripeLinkMode, } from './enums/index.js';
-export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, AUFRUFE, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/esm/models/cancellation.d.ts

@@ -18,6 +18,19 @@ export declare const CANCELLATION_REASONS: Readonly<{
 }>;
 export type CancellationReason = keyof typeof CANCELLATION_REASONS;
 export declare function isCancellationReason(value: unknown): value is CancellationReason;
+/**
+ * Stabile Fehlercodes von `cancelReceipt` — Zwilling von
+ * `functions/storno-core.js` STORNO_FEHLERCODES. Das Backend legt sie bei
+ * jedem fachlichen Fehler als `code` neben die Meldung; das Paket reicht sie
+ * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** —
+ * die deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
+ * ohne Code; dort bleibt `code` undefined.
+ */
+export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen"];
+export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
+export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Bezug eines Storno-Belegs auf sein Original. */
 export interface CancellationOf {
     receiptId: string;
@@ -40,6 +53,15 @@ export interface Cancellation {
     by: string | null;
     note: string | null;
     items: CancellationItem[];
+    /**
+     * Rabattgutschein-Ausgleich, den DIESER Storno gewaehrt hat — Cent je
+     * Steuertopf des Backends (`amountRateStandard`, `amountRateReduced1`, …).
+     * Ein Rabattgutschein ist am Original schon in den Umsatz eingerechnet;
+     * jeder Storno nimmt ihn anteilig der stornierten Menge zurueck (bei 3 Stueck
+     * a 10 EUR mit 6 EUR Rabatt: 2,00 je Stueck). Fehlt das Feld, hat der Eintrag
+     * nichts gewaehrt (Altbestand vor dieser Regel) — der naechste Storno holt nach.
+     */
+    promoAdjustmentCents?: Record<string, number>;
 }
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 export declare const CANCELLATION_RESERVATION_MS = 120000;

package/dist/esm/models/cancellation.js

@@ -18,6 +18,35 @@ export const CANCELLATION_REASONS = Object.freeze({
 export function isCancellationReason(value) {
     return typeof value === 'string' && Object.prototype.hasOwnProperty.call(CANCELLATION_REASONS, value);
 }
+/**
+ * Stabile Fehlercodes von `cancelReceipt` — Zwilling von
+ * `functions/storno-core.js` STORNO_FEHLERCODES. Das Backend legt sie bei
+ * jedem fachlichen Fehler als `code` neben die Meldung; das Paket reicht sie
+ * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** —
+ * die deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
+ * ohne Code; dort bleibt `code` undefined.
+ */
+export const CANCELLATION_ERROR_CODES = [
+    'beleg_nicht_gefunden', // Original fehlt oder gehoert nicht zu dieser Kasse
+    'belegart_nicht_stornierbar', // Original ist selbst Storno-, Null- oder Startbeleg
+    'trainingsbeleg', // Trainingsbelege werden nicht storniert
+    'bereits_storniert', // keine Restmenge mehr (auch beim positionslosen Beleg)
+    'position_ungueltig', // Index unbekannt oder doppelt
+    'menge_ueber_rest', // Menge nicht ganzzahlig >= 1 oder groesser als der Rest
+    'grund_unbekannt', // reason fehlt oder nicht im Katalog
+    'anmerkung_zu_lang', // note laenger als 200 Zeichen
+    'items_ungueltig', // items ist keine Liste
+    'kasse_nicht_zugewiesen', // Register-Benutzer darf diese Kasse nicht
+    'keine_berechtigung', // Register-Benutzer ohne Storno-Recht
+    'nur_eigene_belege', // Recht "eigene", fremder Beleg
+    'kasse_unvollstaendig', // api_key/token fehlen am Konto bzw. an der Kasse
+    'storno_fehlgeschlagen', // der Storno-Beleg selbst wurde abgelehnt (z. B. Signatur)
+];
+export function isCancellationErrorCode(value) {
+    return typeof value === 'string' && CANCELLATION_ERROR_CODES.includes(value);
+}
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 export const CANCELLATION_RESERVATION_MS = 120_000;
 /**

package/dist/esm/models/hobex-receipt.js

@@ -1,5 +1,5 @@
 import { CreditCardProvider } from '../enums/index.js';
-import { centsToEuro } from '../money.js';
+import { centsToEuro, euroToCents } from '../money.js';
 export function toHobexReceiptPayload(beleg) {
     return {
         transactionId: beleg.transactionId,
@@ -38,8 +38,15 @@ export function fromHobexReceiptPayload(payload) {
         responseCode: payload.responseCode,
         transactionType: payload.transactionType,
         currency: payload.currency,
-        amountCents: Math.round((payload.amount ?? 0) * 100),
-        tipCents: Math.round((payload.tip ?? 0) * 100),
+        // Euro->Cent ueber die eine gehaertete Stelle im Paket ([euroToCents],
+        // money.ts) statt einer eigenen `Math.round(x * 100)` -- die Hobex-Antwort
+        // ist eine fremde Antwort und wird hier nur auf transactionId/
+        // transactionDate geprueft (siehe payments/hobex.ts, belegAusNutzlast);
+        // amount/tip bleiben ungeprueft. Ein nicht-numerischer oder
+        // nicht-endlicher Wert ergab bis zu dieser Fassung `NaN` -- lautlos, ohne
+        // dass irgendwo geworfen wurde. [euroToCents] liefert dafuer `0`.
+        amountCents: euroToCents(payload.amount),
+        tipCents: euroToCents(payload.tip),
         cvm: String(payload.cvm),
         // Die Cloud-API-Nutzlast traegt keinen eigenen Provider-Schluessel — der
         // Provider ergibt sich aus dem Transportweg (Cloud vs. HPS), nicht aus

package/dist/esm/models/index.d.ts

@@ -1,7 +1,7 @@
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';
+export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, } from './cashregister.js';
 export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

package/dist/esm/models/index.js

@@ -1,7 +1,7 @@
 export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';
+export { CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
 export { fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { fromCashregisterPayload, } from './cashregister.js';
 export { fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

package/dist/esm/models/receipt.js

@@ -84,6 +84,9 @@ function leseStorno(eintrag) {
         by: eintrag.by ?? null,
         note: eintrag.note ?? null,
         items: (eintrag.items ?? []).map((p) => ({ index: Number(p.index), quantity: Number(p.quantity) })),
+        ...(eintrag.promoAdjustmentCents && typeof eintrag.promoAdjustmentCents === 'object'
+            ? { promoAdjustmentCents: Object.fromEntries(Object.entries(eintrag.promoAdjustmentCents).map(([k, v]) => [k, Number(v)])) }
+            : {}),
     };
 }
 /**

package/dist/esm/models/voucher.js

@@ -1,4 +1,5 @@
 import { VoucherAction, VoucherType } from '../enums/index.js';
+import { euroToCents } from '../money.js';
 import { readEnumKey, requireEnumKey } from './enum-payload.js';
 export function toVoucherPayload(voucher) {
     return {
@@ -30,16 +31,31 @@ export function voucherIsValid(voucher) {
     if (voucher.type === VoucherType.promo && voucher.valueCents == null) {
         return false;
     }
-    if (voucher.valueCents != null && voucher.valueCents <= 0) {
+    // `!Number.isFinite` VOR den Vergleich, nicht dahinter: `NaN <= 0` und
+    // `Infinity <= 0` sind beide `false`, ein Vergleich mit einem
+    // nicht-endlichen Wert ist also IMMER falsch und liesse ihn hier
+    // durchrutschen. Gemessen (28.08.2026): ein Gutschein mit `valueCents: NaN`
+    // (aus einem kaputten `value` in der Nutzlast, siehe [fromVoucherPayload])
+    // oder `valueCents: Infinity` galt bis zu dieser Fassung als GUELTIG und
+    // waere still in die Belegsummen gewandert. Diese Pruefung greift
+    // unabhaengig davon, ob `valueCents` ueber [fromVoucherPayload] oder direkt
+    // gesetzt wurde -- die gehaertete Umrechnung dort allein reicht nicht.
+    if (voucher.valueCents != null && (!Number.isFinite(voucher.valueCents) || voucher.valueCents <= 0)) {
         return false;
     }
     return true;
 }
 export function fromVoucherPayload(payload) {
+    // Euro->Cent ueber die eine gehaertete Stelle im Paket ([euroToCents],
+    // money.ts) statt einer eigenen `Math.round(payload.value * 100)` --
+    // [euroToCents] prueft `Number.isFinite` und liefert fuer einen
+    // nicht-numerischen oder nicht-endlichen Wert `0` statt eines lautlosen
+    // `NaN`. Siehe auch [voucherIsValid]: `0` faellt dort ueber die
+    // "<= 0"-Pruefung, ein `NaN` waere durchgerutscht.
     const valueCents = payload.valueCents != null
         ? payload.valueCents
         : payload.value != null
-            ? Math.round(payload.value * 100)
+            ? euroToCents(payload.value)
             : undefined;
     return {
         name: payload.name ?? undefined,

package/dist/esm/payments/hobex-hps/connect-client.d.ts

@@ -0,0 +1,104 @@
+import { type HpsTransactionResponse } from './transaction-response.js';
+/**
+ * Client fuer die Terminal-Endpunkte von **Kasseneck Connect** — dem lokalen
+ * Geraete-Agenten, der ueber HTTP erreichbar ist und mit dem hobex-HPS
+ * spricht (`kasseneck-connect/lib/src/api/routes_terminal.dart`). Connect
+ * reicht die Antwort des Terminals ROH durch und ordnet nichts ein; die
+ * Einordnung passiert in `transaction-response.ts` und `payments.ts`.
+ *
+ * **Kein direkter Terminal-Kontakt.** Ein Browser hat keine rohen
+ * TCP-Sockets — das ist der Unterschied zum Dart-Zwilling `HpsClient`, der
+ * das HPS-Terminal direkt anspricht. Dieser Client spricht ausschliesslich
+ * mit Connect, niemals mit dem Terminal selbst.
+ *
+ * **`payment`/`status`/`abort`/`refund`/`cancel`.** Seit
+ * `kasseneck-connect` Commit `1c8a003` traegt Connect auch die Gutschrift
+ * (`POST /v1/terminal/refund`) und die Aufhebung (`POST /v1/terminal/cancel`)
+ * — beide erben denselben Fehlerpfad wie `payment` (`error.detail.terminalHttpStatus`,
+ * siehe `HpsConnectTerminalError.isTerminalBusy`).
+ */
+/** Adresse des Ziel-Terminals — bei jedem Aufruf mitgegeben, Connect selbst ist zustandslos. */
+export interface HpsConnectTarget {
+    /** IP oder Hostname des Terminals im Kassen-Netz. */
+    host: string;
+    /** Vorgabe: `8080` (hobex-HPS-Standardport), siehe Connect. */
+    port?: number;
+    /** Terminal-ID, wie am Geraet angezeigt (fuehrende Nullen werden toleriert). */
+    tid: string;
+}
+export interface HpsConnectPaymentOptions extends HpsConnectTarget {
+    /** Kennung dieser Zahlung — MUSS vor diesem Aufruf feststehen, siehe `transaction-id.ts`. */
+    transactionId: string;
+    /** Zu belastender Betrag in **Cent** (ohne Trinkgeld). */
+    amountCents: number;
+    /** Trinkgeld in **Cent**; das Terminal belastet Betrag + Trinkgeld in einem. */
+    tipCents?: number;
+    reference?: string;
+    currency?: string;
+    language?: string;
+}
+export interface HpsConnectTransactionOptions extends HpsConnectTarget {
+    transactionId: string;
+}
+export interface HpsConnectRefundOptions extends HpsConnectTarget {
+    /** Kennung der Gutschrift SELBST — eine NEUE, nicht die der erstatteten Zahlung. */
+    transactionId: string;
+    /** Kennung der erstatteten Zahlung. Verlangt Connect zwingend, siehe `_handleRefund`. */
+    originalTransactionId: string;
+    /** Zu erstattender Betrag in **Cent**. */
+    amountCents: number;
+    reference?: string;
+    currency?: string;
+    language?: string;
+}
+export interface HpsConnectCancelOptions extends HpsConnectTarget {
+    /** Kennung der URSPRUENGLICHEN Zahlung — keine neue. */
+    transactionId: string;
+    /** Pflicht: das Terminal weist einen Void ohne Betrag mit `400 Missing amount` ab. */
+    amountCents: number;
+    currency?: string;
+    language?: string;
+}
+/** Austauschbare `fetch`-Umsetzung, minimal genug fuer eine Attrappe im Test. */
+export interface HpsConnectFetchResponse {
+    status: number;
+    text(): Promise<string>;
+}
+export type HpsConnectFetch = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+    signal: AbortSignal;
+}) => Promise<HpsConnectFetchResponse>;
+export interface HpsConnectClientOptions {
+    /** Basisadresse des Agenten. Vorgabe `http://127.0.0.1:27182` (README `kasseneck-connect`). */
+    baseUrl?: string;
+    /** Kopplungstoken, geht als `Authorization: Bearer <token>` mit. */
+    token: string;
+    /**
+     * Zeitlimit fuer `status`/`abort`/`diagnosis` in ms. Vorgabe 30 s — deutlich
+     * ueber Connects eigenem `hpsKurzTimeout` (15 s), damit dieser Client nicht
+     * VOR Connect selbst aufgibt und dessen Fehlermeldung verschluckt.
+     */
+    shortTimeoutMs?: number;
+    /**
+     * Zeitlimit fuer `payment` in ms. Vorgabe 4,5 Minuten — ueber Connects
+     * eigenem `hpsZahlungTimeout` (4 Minuten): eine Zahlung blockiert, bis der
+     * Karteninhaber fertig ist, das darf nicht vorzeitig aufgegeben werden.
+     */
+    paymentTimeoutMs?: number;
+    /** Eigene `fetch`-Umsetzung (Tests). Vorgabe: globales `fetch`. */
+    fetch?: HpsConnectFetch;
+}
+export interface HpsConnectClient {
+    payment(options: HpsConnectPaymentOptions): Promise<HpsTransactionResponse>;
+    status(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
+    abort(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
+    /** Gutschrift — ein Kartenfluss wie [payment], deshalb dieselbe lange Frist. */
+    refund(options: HpsConnectRefundOptions): Promise<HpsTransactionResponse>;
+    /** Aufhebung (Storno/Void) — kurzer Aufruf, keine Karteninteraktion. */
+    cancel(options: HpsConnectCancelOptions): Promise<HpsTransactionResponse>;
+    /** Erreichbarkeits-/Firmware-Check, folgenlos. Rohe Nutzlast, Connect ordnet nichts ein. */
+    diagnosis(options: HpsConnectTarget): Promise<Record<string, unknown>>;
+}
+export declare function createHpsConnectClient(options: HpsConnectClientOptions): HpsConnectClient;