@kreiseck/kasseneck-api 0.6.9 → 0.6.45

package/dist/cjs/receipt/discount.js

@@ -49,6 +49,6 @@ function verteileRabatt(positionen, rabattCents, name = 'Rabatt') {
         }
     }
     return liste
-        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i] }))
+        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i], kind: 'discount' }))
         .filter((z) => z.priceCents < 0);
 }

package/dist/cjs/receipt/layout-escpos.js

@@ -50,11 +50,16 @@ function escPosLayoutBytes(layout, options = {}) {
             case 'qr':
                 (0, index_js_1.escPosQrCode)(doc, zeile.qr ?? '', qrOptionen);
                 break;
-            case 'banner':
-                // Belegart/Warnung: fett, doppelte Hoehe; Warnungen zusaetzlich invers.
-                // Der Text ist bereits zentriert aufgefuellt (Raster).
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2, reverse: zeile.ton === 'warnung' } });
+            case 'banner': {
+                // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
+                // Stil wie im Beleg-Viewer und im PDF (frueher druckte der Bon invers
+                // weiss-auf-schwarz und sah damit anders aus als jede Anzeige).
+                const rahmen = '='.repeat(grid_js_1.ZEICHEN_JE_PAPIER[paperSize]);
+                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
+                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2 } });
+                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
                 break;
+            }
             default:
                 (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: zeile.bold } });
                 break;

package/dist/cjs/receipt/layout.d.ts

@@ -21,9 +21,12 @@ import type { PosPaperSize } from '../printing/escpos.js';
  * stuende auch auf dem Bildschirm „EUR".
  *
  * Bewusst **nicht** enthalten: Firmenlogo und Rasterbilder (brauchen
- * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung,
- * Druckeransteuerung und die anbieterspezifischen Kartenzahlungsbloecke des
- * Vorbilds (GP Tom, Hobex, SumUp, myPOS, Stripe).
+ * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung
+ * und Druckeransteuerung. Von den anbieterspezifischen Kartenzahlungsbloecken
+ * des Vorbilds (GP Tom, SumUp, myPOS, Stripe) ist nur der **Hobex-Block**
+ * enthalten: die Browser-Kasse bedient das HPS-Terminal selbst (via Kasseneck
+ * Connect) und druckt den Bon aus genau diesem Modell — die uebrigen Anbieter
+ * drucken in ihren eigenen Apps.
  */
 /** Ausrichtung einer Zeile bzw. einer Spalte. */
 export type LayoutAlign = 'left' | 'center' | 'right';

package/dist/cjs/receipt/layout.js

@@ -56,6 +56,50 @@ function belegZeit(timeStamp) {
  * `typeof null === 'object'` ist, ergab das beim Lesen von `.label` einen
  * nackten TypeError.
  */
+/**
+ * Kartenzahlungsblock fuer Hobex (HPS am Geraet wie Cloud-API): die Felder
+ * kommen aus `cardPaymentData` in der Form von [hobexReceiptToCardPaymentData]
+ * (models/hobex-receipt.ts) — Datum, TID, Genehmigungsnummer, Karte, PAN,
+ * Antwortcode. Bei CVM "1" verlangt die Karte eine Unterschrift; dafuer
+ * bekommt der Bon eine Linie. Der PAN haengt beim HPS das Ablaufdatum mit
+ * Unterstrich an ("…4720_2810") — gedruckt wird nur die maskierte Nummer.
+ *
+ * Andere Anbieter (GP Tom, SumUp, myPOS, Stripe) drucken in ihren eigenen
+ * Apps; ihre Bloecke bleiben bewusst draussen (siehe Kopfkommentar).
+ */
+function hobexKartenblock(receipt) {
+    const provider = receipt.creditCardProvider;
+    const daten = receipt.cardPaymentData;
+    if ((provider !== 'hobexHps' && provider !== 'hobexCloudApi') || daten == null) {
+        return [];
+    }
+    const feld = (k) => {
+        const v = daten[k];
+        return v == null ? '' : String(v);
+    };
+    const paar = (teile) => teile.filter(Boolean).join(' · ');
+    const pan = feld('cardNumber').split('_')[0] ?? '';
+    const rc = feld('responseCode');
+    const zeilen = [textZeile('Hobex Beleg', 'center', true)];
+    const inhalt = [
+        feld('date'),
+        paar([feld('tid') && `TID ${feld('tid')}`, feld('no') && `Nr. ${feld('no')}`]),
+        paar([feld('type'), feld('cardBrand')]),
+        pan,
+        rc && `RC ${rc}`,
+    ];
+    for (const zeile of inhalt) {
+        if (zeile)
+            zeilen.push(textZeile(zeile, 'center'));
+    }
+    if (feld('cvm') === '1') {
+        zeilen.push({ kind: 'space', lines: 2 });
+        zeilen.push(textZeile('------------------', 'center'));
+        zeilen.push(textZeile('Unterschrift', 'center'));
+    }
+    zeilen.push({ kind: 'space', lines: 1 });
+    return zeilen;
+}
 function zahlungsartText(wert) {
     if (wert != null && typeof wert === 'object') {
         return wert.label;
@@ -154,21 +198,19 @@ function gutscheinText(voucher) {
     if (name != null && name.toLowerCase().includes(text.toLowerCase())) {
         return name;
     }
-    if (voucher.valueCents != null) {
-        text += ` ${gutscheinBetrag(voucher.valueCents)} €`;
+    // Der Betrag steht in derselben Zeile rechts in der Betragsspalte — ihn
+    // auch ins Label zu schreiben war doppelt und brach auf 58 mm haesslich
+    // um ("Wertgutschein 3 €" + Folgezeile "€"). Statt dessen der Code: er
+    // identifiziert den Gutschein (Mehrzweck: der Kunde will wissen, WELCHER
+    // eingeloest wurde).
+    if (voucher.code != null && voucher.code !== '') {
+        text += ` ${voucher.code}`;
     }
     if (name != null && name.length > 0) {
         text += ` - ${name}`;
     }
     return text;
 }
-/**
- * Ganze Betraege kurz (`"10"`), krumme mit zwei Nachkommastellen (`"1,50"`) —
- * Zwilling von `KeckVoucher.formatVoucherAmount`.
- */
-function gutscheinBetrag(cents) {
-    return cents % 100 === 0 ? String(cents / 100) : formatCents(cents);
-}
 // ----------------------------------------------------------------- Bauteile
 function textZeile(text, align = 'left', bold = false) {
     return { kind: 'text', text, align, bold };
@@ -196,6 +238,46 @@ function tabellenZeile(werte, paperSize) {
         })),
     };
 }
+/**
+ * Trinkgeld auf dem Bon: keine Menge, kein Einzelpreis — Bezeichnung und
+ * Summe. Eine Steuer-Kategorie steht hinter dem Betrag (D = Durchlaeufer,
+ * sonst Inhaber-Trinkgeld als Umsatz); bei mehreren steht die Aufteilung in
+ * einer zweiten, eingerueckten Zeile. Breite 8:4: „Trinkgeld Personal“ (18
+ * Zeichen) muss auf 58 mm in die Zeile passen, rechts reichen zehn Zeichen
+ * auch fuer „-123,45 D“.
+ */
+function trinkgeldZeilen(name, teile) {
+    const summe = teile.reduce((s, t) => s + t.cents, 0);
+    if (teile.length === 1) {
+        return [{
+                kind: 'columns',
+                columns: [
+                    { text: name, width: 8, align: 'left' },
+                    { text: `${formatCents(summe)} ${teile[0].satz.category}`, width: 4, align: 'right' },
+                ],
+            }];
+    }
+    const sortiert = [...teile].sort((a, b) => a.satz.category.localeCompare(b.satz.category));
+    return [
+        {
+            kind: 'columns',
+            columns: [
+                { text: name, width: 8, align: 'left' },
+                // Stern statt Kategorie-Buchstabe: fluchtet mit den Warenbetraegen
+                // (" B" ist zwei Zeichen, " *" auch) und verweist auf die
+                // Aufteilungszeile darunter — klassische Fussnote.
+                { text: `${formatCents(summe)} *`, width: 4, align: 'right' },
+            ],
+        },
+        { kind: 'text', text: `* davon ${sortiert.map((t) => `${formatCents(t.cents)} ${t.satz.category}`).join(', ')}`, align: 'left', bold: false },
+    ];
+}
+/**
+ * Rabatt auf dem Bon: dieselbe Form wie Trinkgeld — Summenzeile, bei einem
+ * Steuersatz mit Kategorie-Buchstaben, im Mischfall mit Stern und der
+ * Aufteilung als Fussnote darunter (siehe trinkgeldZeilen).
+ */
+const rabattZeilen = trinkgeldZeilen;
 /** Positionszeile: Menge, Bezeichnung, ab Menge 2 der Einzelpreis. */
 function positionsZeile(item, satz) {
     const menge = String(item.quantity);
@@ -454,10 +536,58 @@ function buildReceiptLayout(receipt, company, options = {}) {
         gruppen.set(satz.rate, neu);
         return neu;
     };
-    for (const item of receipt.items) {
-        const satz = steuersatz(item.vat);
-        gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
-        lines.push(positionsZeile(item, satz));
+    // Trinkgeld-Positionen gleichen Namens werden auf dem Bon zu EINER Zeile
+    // mit der Summe zusammengefasst (die Aufteilung des Inhaber-Trinkgelds auf
+    // mehrere Steuersaetze bzw. mehrere Empfaenger ist fiskalisch notwendig,
+    // fuer den Gast aber nur Rauschen); bei mehr als einer Steuer-Kategorie
+    // steht die Aufteilung darunter. USt-Tabelle und DEP bleiben positionsgenau.
+    // Rabatt-Positionen gleichen Namens werden wie Trinkgeld zu EINER Zeile mit
+    // der Summe zusammengefasst (die Aufteilung je Steuersatz ist fiskalisch
+    // notwendig, fuer den Gast aber Rauschen); vor dem ERSTEN Rabatt-Block steht
+    // einmalig die Zwischensumme der Waren — der Gast sieht vorher/nachher.
+    // USt-Tabelle und DEP bleiben positionsgenau.
+    const warenSummeCents = receipt.items
+        .filter((it) => !(0, index_js_2.isTipItem)(it) && !(0, index_js_2.isDiscountItem)(it))
+        .reduce((summe, it) => summe + (0, index_js_2.receiptItemTotalCents)(it), 0);
+    let zwischensummeGezeigt = false;
+    let i = 0;
+    while (i < receipt.items.length) {
+        const item = receipt.items[i];
+        if (!(0, index_js_2.isTipItem)(item) && !(0, index_js_2.isDiscountItem)(item)) {
+            const satz = steuersatz(item.vat);
+            gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
+            lines.push(positionsZeile(item, satz));
+            i += 1;
+            continue;
+        }
+        const artVon = (it) => ((0, index_js_2.isTipItem)(it) ? 'tip' : 'discount');
+        const art = artVon(item);
+        const gruppe = [];
+        while (i < receipt.items.length && artVon(receipt.items[i]) === art && !(!(0, index_js_2.isTipItem)(receipt.items[i]) && !(0, index_js_2.isDiscountItem)(receipt.items[i])) && receipt.items[i].name === item.name) {
+            gruppe.push(receipt.items[i]);
+            i += 1;
+        }
+        const teile = [];
+        for (const teil of gruppe) {
+            const satz = steuersatz(teil.vat);
+            gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(teil);
+            const vorhanden = teile.find((t) => t.satz.category === satz.category);
+            if (vorhanden)
+                vorhanden.cents += (0, index_js_2.receiptItemTotalCents)(teil);
+            else
+                teile.push({ satz, cents: (0, index_js_2.receiptItemTotalCents)(teil) });
+        }
+        if (art === 'discount' && !zwischensummeGezeigt) {
+            // Trennlinie vor dem Rabatt-Block: die Warenzeilen enden sichtbar,
+            // darunter beginnt die Verrechnung (Zwischensumme, Rabatt).
+            lines.push({ kind: 'rule', char: '-' });
+            // Zwei Fuellzeichen, wo bei den Warenzeilen " B" steht — so fluchten
+            // ALLE Betraege (Waren, Zwischensumme, Rabatt, Trinkgeld) in einer
+            // Spalte; die letzten zwei Zeichen sind die Kategorie-/Stern-Spalte.
+            lines.push(paarZeile('Zwischensumme', `${formatCents(warenSummeCents)}  `, 8, 4));
+            zwischensummeGezeigt = true;
+        }
+        lines.push(...(art === 'discount' ? rabattZeilen(item.name, teile) : trinkgeldZeilen(item.name, teile)));
     }
     // --- Gutscheine: verkaufte Wertgutscheine sind Umsatz zu 0 %, eingeloeste
     //     Promotionsgutscheine mindern die Steuergruppen anteilig.
@@ -505,6 +635,24 @@ function buildReceiptLayout(receipt, company, options = {}) {
             formatCents(bruttoCents),
         ], paperSize));
     }
+    // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
+    // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
+    // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
+    // Umsatz aussieht. Inhaber-Trinkgeld ist Umsatz und bekommt keine Zeile.
+    const durchlaufendesTrinkgeldCents = receipt.items
+        .filter((it) => (0, index_js_2.isTipItem)(it) && it.recipient?.owner !== true)
+        .reduce((summe, it) => summe + (0, index_js_2.receiptItemTotalCents)(it), 0);
+    // Nur wenn die 0-%-Gruppe MEHR enthaelt als das Trinkgeld (Wertgutschein-
+    // Verkauf ist ebenfalls Kategorie D, beim Kleinunternehmer ist alles 0 %):
+    // dann trennt diese Zeile den Durchlaeufer vom uebrigen Null-Prozent-Betrag.
+    // Besteht die 0-%-Gruppe ohnehin nur aus dem Trinkgeld, sagt die Position
+    // "Trinkgeld Personal" schon alles — die Wiederholung waere Rauschen.
+    const nullGruppeCents = gruppen.get(index_js_1.VatRate.vat0.rate)?.bruttoCents ?? 0;
+    if (durchlaufendesTrinkgeldCents !== 0 && nullGruppeCents !== durchlaufendesTrinkgeldCents) {
+        // Breite 9:3 — auf 58 mm (32 Zeichen) passt die Beschriftung so in eine
+        // Zeile; der Betrag braucht rechts hoechstens acht Zeichen.
+        lines.push(paarZeile('Trinkgeld, kein Umsatz:', formatCents(durchlaufendesTrinkgeldCents), 9, 3));
+    }
     lines.push({ kind: 'rule', char: '-' });
     // --- Summen
     const summeCents = (0, index_js_2.receiptSumCents)(receipt);
@@ -513,7 +661,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
         lines.push(paarZeile('Zwischensumme', `${formatCents(zwischensummeCents)} €`));
         for (const voucher of receipt.vouchers) {
             if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.VoucherType.value) {
-                lines.push(paarZeile(gutscheinText(voucher), `-${formatCents(voucher.valueCents ?? 0)} €`));
+                // Breite 8:4 — "Wertgutschein GS-1" (Label + Code) passt so auf 58 mm
+                // in die Zeile, statt den Code in eine Folgezeile fliessen zu lassen.
+                lines.push(paarZeile(gutscheinText(voucher), `-${formatCents(voucher.valueCents ?? 0)} €`, 8, 4));
             }
         }
         lines.push({ kind: 'rule', char: '-' });
@@ -538,6 +688,8 @@ function buildReceiptLayout(receipt, company, options = {}) {
     // --- RKSV-QR-Code
     lines.push({ kind: 'qr', data: receipt.qr });
     lines.push({ kind: 'space', lines: 1 });
+    // --- Kartenzahlungsblock (Hobex) — wie im Vorbild UNTER dem QR-Code.
+    lines.push(...hobexKartenblock(receipt));
     // --- Dankestext und Fusszeilen
     if (company.thanksMessage.length > 0) {
         lines.push({ kind: 'space', lines: 1 });

package/dist/cjs/register/index.d.ts

@@ -47,5 +47,5 @@
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
-export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterGeraeteAngaben, pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
+export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterGeraeteAngaben, pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
 export { renewRegisterSession, endRegisterSession } from './session.js';

package/dist/cjs/register/index.js

@@ -49,8 +49,9 @@
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.endRegisterSession = exports.renewRegisterSession = exports.registerPinLogin = exports.registerUserLogin = exports.unpairRegisterDevice = exports.listRegisterUsersForDevice = exports.pairRegisterDevice = void 0;
+exports.endRegisterSession = exports.renewRegisterSession = exports.registerPinLogin = exports.registerUserLogin = exports.unpairRegisterDevice = exports.listRegisterUsersForDevice = exports.pairRegisterDevice = exports.REGISTER_PERMS = void 0;
 var pairing_js_1 = require("./pairing.js");
+Object.defineProperty(exports, "REGISTER_PERMS", { enumerable: true, get: function () { return pairing_js_1.REGISTER_PERMS; } });
 Object.defineProperty(exports, "pairRegisterDevice", { enumerable: true, get: function () { return pairing_js_1.pairRegisterDevice; } });
 Object.defineProperty(exports, "listRegisterUsersForDevice", { enumerable: true, get: function () { return pairing_js_1.listRegisterUsersForDevice; } });
 Object.defineProperty(exports, "unpairRegisterDevice", { enumerable: true, get: function () { return pairing_js_1.unpairRegisterDevice; } });

package/dist/cjs/register/pairing.d.ts

@@ -41,6 +41,11 @@ export interface RegisterGeraeteAngaben {
     geo?: RegisterGeo | null;
 }
 export interface PairRegisterDeviceOptions extends RegisterDeviceConnection, RegisterGeraeteAngaben {
+    /**
+     * Die Kasse ist schon auf einem anderen Geraet geoeffnet (BELEGT-Rueckfrage):
+     * `true` uebernimmt sie hierher und widerruft das alte Geraet.
+     */
+    takeover?: boolean;
     /**
      * Achtstelliger Kopplungs-Code aus dem Panel. Er ist 15 Minuten gueltig,
      * genau **einmal** verwendbar und gilt fuer eine bestimmte Kasse.
@@ -107,6 +112,16 @@ export interface RegisterDeviceUsers {
     loginMode: RegisterLoginMode;
     /** Der Betrieb verlangt die Ortung beim Login (Standortsperre an). */
     standortsperre: boolean;
+    /**
+     * Darf die gebundene Kasse ueberhaupt Belege erstellen? `bereit: false`
+     * nennt den Grund (ausser Betrieb, Schlussbeleg erstellt) — die Kasse
+     * sperrt das Kassieren VOR dem ersten Beleg statt an createReceipt zu
+     * scheitern. Fehlt das Feld (aelteres Backend), gilt bereit.
+     */
+    kasse?: {
+        bereit: boolean;
+        grund?: string | null;
+    } | null;
 }
 /**
  * Rechte eines Kassen-Benutzers (Backend: `perms`, Vorlagen `PERMS_KASSIER`
@@ -144,6 +159,8 @@ export interface RegisterUserPerms {
     tipAssign?: boolean;
     [weiteresRecht: string]: boolean | RegisterScope | undefined;
 }
+/** Alle Rechte-Schluessel, die dieses Paket kennt — die Zwillinge pruefen dagegen. */
+export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign"];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
 export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;

package/dist/cjs/register/pairing.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.REGISTER_PERMS = void 0;
 exports.cancelScopeOf = cancelScopeOf;
 exports.receiptsScopeOf = receiptsScopeOf;
 exports.pairRegisterDevice = pairRegisterDevice;
@@ -47,6 +48,11 @@ const settings_js_1 = require("../kasse/settings.js");
  * es auch halten.
  */
 const ohneAnmeldung = () => ({ headers: {}, params: {} });
+/** Alle Rechte-Schluessel, die dieses Paket kennt — die Zwillinge pruefen dagegen. */
+exports.REGISTER_PERMS = [
+    'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
+    'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
+];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 function cancelScopeOf(perms) {
     if (!perms)
@@ -71,10 +77,10 @@ function receiptsScopeOf(perms) {
  * [PairedRegisterDevice]).
  */
 async function pairRegisterDevice(options) {
-    const { code, label, client, geo, ...verbindung } = options;
+    const { code, label, client, geo, takeover, ...verbindung } = options;
     pflicht('pairRegisterDevice', 'code', code);
     // Der Code ist das Geheimnis dieses Aufrufs — siehe Modulkommentar.
-    const daten = await transportFuer(verbindung)('pairRegisterDevice', { code, label, client, geo: geo ?? undefined }, undefined, [code]);
+    const daten = await transportFuer(verbindung)('pairRegisterDevice', { code, label, client, geo: geo ?? undefined, takeover: takeover === true ? true : undefined }, undefined, [code]);
     return {
         deviceId: pflichtfeld('pairRegisterDevice', daten, 'deviceId'),
         deviceSecret: pflichtfeld('pairRegisterDevice', daten, 'deviceSecret'),
@@ -135,7 +141,26 @@ async function listRegisterUsersForDevice(options) {
     };
     const bd = daten?.betriebsdaten;
     const betriebsdaten = bd && typeof bd === 'object' ? (0, receipt_company_js_1.fromReceiptCompanyPayload)(bd) : null;
-    return { users, policy: regel(daten?.policy), loginMode: daten?.loginMode === 'pin' ? 'pin' : 'auswahl', settings, betriebsdaten, standortsperre: daten?.standortsperre === true };
+    return {
+        users,
+        policy: regel(daten?.policy),
+        loginMode: daten?.loginMode === 'pin' ? 'pin' : 'auswahl',
+        settings,
+        betriebsdaten,
+        standortsperre: daten?.standortsperre === true,
+        // 0.6.27 ergaenzte nur den TYP — hier fiel das Feld beim Zusammenbau
+        // stumm weg, und die Kasse sah nie eine Sperre. Fehlt es (aelteres
+        // Backend), bleibt es undefined: dann gilt bereit.
+        kasse: kasseBereit(daten?.kasse),
+    };
+}
+function kasseBereit(wert) {
+    if (typeof wert !== 'object' || wert === null || Array.isArray(wert))
+        return undefined;
+    const roh = wert;
+    if (typeof roh['bereit'] !== 'boolean')
+        return undefined;
+    return { bereit: roh['bereit'], grund: typeof roh['grund'] === 'string' ? roh['grund'] : null };
 }
 /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
 function regel(wert) {

package/dist/cjs/register/session.d.ts

@@ -1,4 +1,4 @@
-import type { KasseneckTransport } from '../client/transport.js';
+import type { InternerTransport } from '../client/aufrufe.js';
 /**
  * Die beiden Aufrufe der **laufenden** Kassen-Sitzung. Anders als die drei in
  * pairing.ts haben sie eine Identitaet: sie laufen ueber `registerUserAuth`
@@ -23,7 +23,7 @@ import type { KasseneckTransport } from '../client/transport.js';
  * beendet — bitte neu anmelden.") — dann hilft nur eine neue Anmeldung ueber
  * `registerUserLogin`.
  */
-export declare function renewRegisterSession(rufen: KasseneckTransport): Promise<number>;
+export declare function renewRegisterSession(rufen: InternerTransport): Promise<number>;
 /**
  * Sitzung beenden und den Lizenzplatz sofort freigeben — der regulaere Weg des
  * Abmeldens.
@@ -34,4 +34,4 @@ export declare function renewRegisterSession(rufen: KasseneckTransport): Promise
  * einer harmlosen Vertragsaenderung — ausgerechnet beim Abmelden, dem Aufruf,
  * der auch dann durchgehen soll, wenn sonst nichts mehr geht.
  */
-export declare function endRegisterSession(rufen: KasseneckTransport): Promise<void>;
+export declare function endRegisterSession(rufen: InternerTransport): Promise<void>;

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

@@ -0,0 +1,21 @@
+/**
+ * Die Namen der Backend-Functions, die dieses Paket aufruft — als Daten, nicht
+ * als Zeichenketten im Code verstreut. Zwei Gruende:
+ *
+ * 1. Der Vertrag (`fixtures/oberflaeche.json`) gibt die Liste aus, damit die
+ *    Zwillinge pruefen koennen, ob sie denselben Aufruf kennen.
+ * 2. Die paketinternen Module nehmen [InternerTransport] statt
+ *    [KasseneckTransport] entgegen; ein Tippfehler im Aufrufnamen ist damit ein
+ *    Compilerfehler statt eines 404 beim Kunden.
+ *
+ * **Die oeffentliche Schnittstelle bleibt offen.** `KasseneckTransport` nimmt
+ * weiterhin jeden `string`: wer einen Aufruf braucht, den dieses Paket nicht
+ * 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", "listRegisterUsersForDevice", "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>;
+/** Wie [KasseneckBinaryTransport], nur mit bekanntem Aufrufnamen. */
+export type InternerBinaerTransport = (functionName: Aufruf, params?: Record<string, unknown>) => Promise<Uint8Array>;

package/dist/esm/client/aufrufe.js

@@ -0,0 +1,31 @@
+export const AUFRUFE = [
+    'cancelReceipt',
+    'createPaymentLinkStripe',
+    'createPrintJob',
+    'createReceipt',
+    'downloadDailyReport',
+    'downloadReport',
+    'endRegisterSession',
+    'financeWebService',
+    'generateFullReceiptId',
+    'getFirstReceiptDate',
+    'getKasseSettings',
+    'getPrintJob',
+    'getReceipt',
+    'hobexPayApi',
+    'hobexRefundApi',
+    'listMyArticleGroups',
+    'listMyArticles',
+    'listMyCashregisters',
+    'listMyPrinters',
+    'listMyReceipts',
+    'listRegisterUsersForDevice',
+    'pairRegisterDevice',
+    'registerPinLogin',
+    'registerUserLogin',
+    'renewRegisterSession',
+    'setMyKasseSettings',
+    'setMyRegisterDeviceSettings',
+    'stripeCaptureIntent',
+    'unpairRegisterDevice',
+];

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

@@ -1,5 +1,5 @@
 import { type Cashregister } from '../models/index.js';
-import type { KasseneckTransport } from './transport.js';
+import type { InternerTransport } from './aufrufe.js';
 /**
  * Kassen-Endpunkte.
  *
@@ -18,4 +18,4 @@ import type { KasseneckTransport } from './transport.js';
  *
  * Ohne diesen Aufruf kann eine Browser-Kasse ihre Kasse nicht auswaehlen.
  */
-export declare function listMyCashregisters(rufen: KasseneckTransport): Promise<Cashregister[]>;
+export declare function listMyCashregisters(rufen: InternerTransport): Promise<Cashregister[]>;

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

@@ -1,7 +1,8 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
+export { AUFRUFE, type Aufruf, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/esm/client/index.js

@@ -1,5 +1,6 @@
 export { apiKeyAuth, registerUserAuth, } from './auth.js';
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, } from './transport.js';
+export { AUFRUFE, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
 export { sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, checkVoucherCombinationError, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';

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

@@ -1,6 +1,6 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider } from '../enums/index.js';
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
-import type { KasseneckTransport } from './transport.js';
+import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
@@ -39,6 +39,25 @@ export interface ReceiptCommonOptions {
     customProjectId?: string;
     /** Rohdaten der Kartenzahlung (Terminal-/Anbieterantwort). */
     cardPaymentData?: Record<string, unknown>;
+    /**
+     * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
+     * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte
+     * Positionen `kind:'tip'` (Mitarbeiter 0 % als Durchlaeufer, Inhaber
+     * anteilig je Steuersatz). Nur auf `standard` und `training`.
+     */
+    tip?: number | TipOptions;
+}
+/** Trinkgeld mit eigener Zahlart und/oder Empfaengern (Kassen-Benutzer-IDs, Summe = cents). */
+export interface TipOptions {
+    cents: number;
+    /** Zahlart des Trinkgelds; ohne Angabe gilt die des Belegs. */
+    paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
+    /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
+    recipients?: TipRecipientShare[];
+}
+export interface TipRecipientShare {
+    registerUserId: string;
+    cents: number;
 }
 /** Belegtyp und Inhalt — die vollstaendige Eingabe von [createReceipt]. */
 export interface CreateReceiptOptions extends ReceiptCommonOptions {
@@ -131,29 +150,29 @@ export interface ReceiptWithCompany {
  * Bewusst **nicht** Teil der Paketoberflaeche: der Belegtyp gehoert nicht in
  * die Hand des Aufrufers, sondern zu einem der benannten Aufrufe darunter.
  */
-export declare function createReceipt(rufen: KasseneckTransport, options: CreateReceiptOptions): Promise<Receipt>;
+export declare function createReceipt(rufen: InternerTransport, options: CreateReceiptOptions): Promise<Receipt>;
 /** Normalbeleg (Verkauf) nach RKSV. */
-export declare function sellReceipt(rufen: KasseneckTransport, options: SellReceiptOptions): Promise<Receipt>;
+export declare function sellReceipt(rufen: InternerTransport, options: SellReceiptOptions): Promise<Receipt>;
 /**
  * Normalbeleg wie [sellReceipt], liefert zusaetzlich die Firmen-/Druckdaten
  * aus derselben Antwort — alles, was ein Belegdruck braucht, in einem Aufruf.
  */
-export declare function sellReceiptWithCompany(rufen: KasseneckTransport, options: SellReceiptOptions): Promise<ReceiptWithCompany>;
+export declare function sellReceiptWithCompany(rufen: InternerTransport, options: SellReceiptOptions): Promise<ReceiptWithCompany>;
 /**
  * Storno-Beleg zu einem bestehenden Beleg — voll oder in Teilen. Prueft die
  * Eingabe, bevor etwas hinausgeht; der Server haelt die Restmengen und die
  * Reichweite des Rechts (eigene/alle) und antwortet mit dem fertigen,
  * signierten Storno-Beleg. Gutscheine des Originals wandern nicht mit.
  */
-export declare function cancelReceipt(rufen: KasseneckTransport, options: CancelReceiptOptions): Promise<CancelReceiptResult>;
+export declare function cancelReceipt(rufen: InternerTransport, options: CancelReceiptOptions): Promise<CancelReceiptResult>;
 /**
  * Stornobeleg aus frei uebergebenen Positionen — fuer den Fall, dass der
  * Originalbeleg nicht als Objekt vorliegt. Die Positionen gehen **unveraendert**
  * hinaus; das Vorzeichen setzt der Aufrufer.
  */
-export declare function createCancelReceipt(rufen: KasseneckTransport, options: CreateCancelReceiptOptions): Promise<Receipt>;
+export declare function createCancelReceipt(rufen: InternerTransport, options: CreateCancelReceiptOptions): Promise<Receipt>;
 /** Nullbeleg (RKSV-Pruefbeleg) — ohne Positionen und ohne Zahlungsart. */
-export declare function zeroReceipt(rufen: KasseneckTransport): Promise<Receipt>;
+export declare function zeroReceipt(rufen: InternerTransport): Promise<Receipt>;
 /** Belegliste einer Kasse samt der Kennzahlen, die dieselbe Antwort mitliefert. */
 export interface ReceiptList {
     /** Letzte Belege, neueste zuerst (Backend: nach `counter` absteigend). */
@@ -212,21 +231,21 @@ export interface ListMyReceiptsOptions {
  * (der Endpunkt laeuft mit `checkCashRegister: false`), ein Kassen-Benutzer
  * bekommt also nur die ihm zugewiesenen Kassen.
  */
-export declare function listMyReceipts(rufen: KasseneckTransport, options: ListMyReceiptsOptions): Promise<ReceiptList>;
+export declare function listMyReceipts(rufen: InternerTransport, options: ListMyReceiptsOptions): Promise<ReceiptList>;
 /** Einzelnen Beleg der angemeldeten Kasse holen. */
-export declare function getReceipt(rufen: KasseneckTransport, receiptId: string): Promise<Receipt>;
+export declare function getReceipt(rufen: InternerTransport, receiptId: string): Promise<Receipt>;
 /**
  * Wie [getReceipt], liefert zusaetzlich die Firmen-/Druckdaten aus derselben
  * Antwort (Firma, Anschrift, Steuernummer, UID, Fusszeilen, Logo-Adresse,
  * Kleinunternehmer-Kennzeichen) — die Angaben, die ein Beleg im Kopf und Fuss
  * traegt (siehe models/receipt-company.ts).
  */
-export declare function getReceiptWithCompany(rufen: KasseneckTransport, receiptId: string): Promise<ReceiptWithCompany>;
+export declare function getReceiptWithCompany(rufen: InternerTransport, receiptId: string): Promise<ReceiptWithCompany>;
 /**
  * Verschluesselte Volltext-Belegnummer erzeugen — der Bezeichner, unter dem der
  * Beleg oeffentlich abrufbar ist (Beleg-Download, Pruefportal).
  */
-export declare function generateFullReceiptId(rufen: KasseneckTransport, receiptId: string): Promise<string>;
+export declare function generateFullReceiptId(rufen: InternerTransport, receiptId: string): Promise<string>;
 /**
  * Berichtsmonat des allerersten Belegs dieser Kasse — die untere Grenze aller
  * Monatsberichte.
@@ -235,7 +254,7 @@ export declare function generateFullReceiptId(rufen: KasseneckTransport, receipt
  * fuehrt kein `allowRegisterUser`, das Backend weist die Browser-Kasse hier ab
  * (siehe Modulkommentar oben). Mit `apiKeyAuth` ist er offen.
  */
-export declare function getFirstReceiptDate(rufen: KasseneckTransport): Promise<ReportMonth>;
+export declare function getFirstReceiptDate(rufen: InternerTransport): Promise<ReportMonth>;
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von