@kreiseck/kasseneck-api 1.0.0-rc.4 → 1.0.0

package/dist/cjs/receipt/due.js

@@ -1,8 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = void 0;
+exports.isReceiptDueError = isReceiptDueError;
 exports.receiptDueCents = receiptDueCents;
 exports.receiptDueBreakdown = receiptDueBreakdown;
 const index_js_1 = require("../enums/index.js");
+/**
+ * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
+ * dieselbe Liste im Dart-Zwilling und in `fixtures/receipt-due-errors.json`.
+ */
+exports.RECEIPT_DUE_ERROR_REASONS = Object.freeze([
+    'unknown_receipt_type',
+    'tip_not_allowed',
+    'invalid_item',
+    'invalid_voucher',
+    'invalid_tip',
+    'unknown_payment_method',
+    'tip_conflict',
+    'tip_recipient_missing',
+    'tip_without_goods',
+]);
+/**
+ * Der Zahlbetrag laesst sich aus dieser Eingabe nicht rechnen, etwa
+ * Trinkgeld mit Betrag ohne Ware (`reason: 'tip_without_goods'`).
+ *
+ * Eindeutig **nicht gesendet**: die Rechnung laeuft ganz im Paket, vor jedem
+ * Aufruf. `outcome` ist darum immer `'rejected'`; nichts ist geschehen, keine
+ * Belegnummer verbraucht, keine Karte belastet. Die Kasse sagt das dem
+ * Kassier, bevor sie ein Terminal anspricht. Entscheiden am `code` bzw.
+ * `reason`, nie an `message` (die ist fuers Protokoll).
+ *
+ * Bis 1.0.0-rc.4 warf die Rechnung hier einen `RangeError` ohne Code.
+ */
+class ReceiptDueError extends Error {
+    name = 'ReceiptDueError';
+    /** Stabiler Code fuer jede Ursache. */
+    code = 'receipt_due_unavailable';
+    /** Die Ursache im Einzelnen. */
+    reason;
+    /** Immer `'rejected'`: es ging nichts hinaus. */
+    outcome = 'rejected';
+    constructor(reason, message) {
+        super(`Zahlbetrag: ${message}`);
+        this.reason = reason;
+    }
+}
+exports.ReceiptDueError = ReceiptDueError;
+function isReceiptDueError(error) {
+    return error instanceof ReceiptDueError;
+}
 const UMSATZ = new Set(['standard', 'cancellation', 'training']);
 const TRINKGELD_ERLAUBT = new Set(['standard', 'training']);
 const ZAHLARTEN = new Set(['cash', 'creditCard', 'online', 'uberApp', 'uberCard', 'uberCash', 'boltApp', 'boltCard', 'boltCash']);
@@ -15,7 +61,7 @@ function receiptDueBreakdown(items, vouchers, receiptType, options = {}) {
     const art = belegArt(receiptType);
     const trinkgelder = trinkgeldAuftraege(options);
     if (trinkgelder.length > 0 && !TRINKGELD_ERLAUBT.has(art)) {
-        throw new RangeError(`Zahlbetrag: Trinkgeld gibt es nur bei standard und training, nicht bei "${art}".`);
+        throw new ReceiptDueError('tip_not_allowed', `Trinkgeld gibt es nur bei standard und training, nicht bei "${art}".`);
     }
     if (!UMSATZ.has(art)) {
         return { dueCents: 0, counterDeltaCents: 0, valueVoucherFlowCents: 0, bucketsCents: null };
@@ -45,7 +91,7 @@ function receiptDueBreakdown(items, vouchers, receiptType, options = {}) {
 function belegArt(wert) {
     const text = typeof wert === 'object' && wert !== null ? wert.value : wert;
     if (typeof text !== 'string' || !Object.prototype.hasOwnProperty.call(index_js_1.ReceiptType, text)) {
-        throw new RangeError(`Zahlbetrag: unbekannter Belegtyp "${String(text)}".`);
+        throw new ReceiptDueError('unknown_receipt_type', `unbekannter Belegtyp "${String(text)}".`);
     }
     return text;
 }
@@ -57,17 +103,17 @@ function euroToCent(euro) {
 function innen(item, i) {
     const satz = typeof item.vat === 'number' ? item.vat : item.vat?.rate;
     if (typeof satz !== 'number' || !Number.isFinite(satz))
-        throw new RangeError(`Zahlbetrag: Position ${i + 1} ohne Steuersatz.`);
+        throw new ReceiptDueError('invalid_item', `Position ${i + 1} ohne Steuersatz.`);
     if (!Number.isSafeInteger(item.priceCents))
-        throw new RangeError(`Zahlbetrag: Position ${i + 1} hat keinen ganzen Cent-Preis.`);
+        throw new ReceiptDueError('invalid_item', `Position ${i + 1} hat keinen ganzen Cent-Preis.`);
     if (typeof item.quantity !== 'number' || !Number.isFinite(item.quantity))
-        throw new RangeError(`Zahlbetrag: Position ${i + 1} hat keine gueltige Menge.`);
+        throw new ReceiptDueError('invalid_item', `Position ${i + 1} hat keine gueltige Menge.`);
     const tip = item.kind === 'tip' ? (item.recipient?.owner === true ? 'owner' : 'staff') : null;
     return { amount: item.quantity, priceOne: Math.round(item.priceCents) / 100, vat: satz, tip };
 }
 function gutscheinInnen(v, i) {
     if (!Number.isSafeInteger(v.valueCents))
-        throw new RangeError(`Zahlbetrag: Gutschein ${i + 1} hat keinen ganzen Cent-Wert.`);
+        throw new ReceiptDueError('invalid_voucher', `Gutschein ${i + 1} hat keinen ganzen Cent-Wert.`);
     return { action: String(v.action), type: String(v.type), value: Math.round(v.valueCents) / 100 };
 }
 /** Trinkgeld-Auftraege in der Reihenfolge des Servers: `tip`, dann je Zahlart die Summe der `tipCents`. */
@@ -75,7 +121,7 @@ function trinkgeldAuftraege(options) {
     const raus = [];
     const tipCents = (options.payments ?? []).some((z) => z != null && z.tipCents !== undefined);
     if (options.tip != null && tipCents) {
-        throw new RangeError('Zahlbetrag: tip und payments[].tipCents gehen nicht zugleich (tip_conflict).');
+        throw new ReceiptDueError('tip_conflict', 'tip und payments[].tipCents gehen nicht zugleich (tip_conflict).');
     }
     if (options.tip != null) {
         const tip = options.tip;
@@ -84,14 +130,14 @@ function trinkgeldAuftraege(options) {
         const recipients = typeof tip === 'number' ? undefined : tip.recipients;
         if (recipients != null) {
             if (recipients.length === 0)
-                throw new RangeError('Zahlbetrag: recipients darf nicht leer sein.');
+                throw new ReceiptDueError('invalid_tip', 'recipients darf nicht leer sein.');
             for (const r of recipients) {
                 pruefeCent(r.cents, 'Trinkgeld-Anteil');
                 if (typeof r.owner !== 'boolean')
-                    throw new RangeError('Zahlbetrag: recipients[].owner muss true oder false sein.');
+                    throw new ReceiptDueError('invalid_tip', 'recipients[].owner muss true oder false sein.');
             }
             if (recipients.reduce((s, r) => s + r.cents, 0) !== cents) {
-                throw new RangeError('Zahlbetrag: die Anteile des Trinkgelds ergeben nicht den Betrag.');
+                throw new ReceiptDueError('invalid_tip', 'die Anteile des Trinkgelds ergeben nicht den Betrag.');
             }
             raus.push({ empfaenger: recipients.map((r) => ({ cents: r.cents, owner: r.owner })) });
         }
@@ -107,7 +153,7 @@ function trinkgeldAuftraege(options) {
         pruefeCent(z.tipCents, 'tipCents');
         const methode = typeof z.method === 'object' && z.method !== null ? z.method.value : z.method;
         if (typeof methode !== 'string' || !ZAHLARTEN.has(methode))
-            throw new RangeError(`Zahlbetrag: unbekannte Zahlart "${String(methode)}".`);
+            throw new ReceiptDueError('unknown_payment_method', `unbekannte Zahlart "${String(methode)}".`);
         je.set(methode, (je.get(methode) ?? 0) + z.tipCents);
     }
     for (const cents of je.values())
@@ -116,7 +162,7 @@ function trinkgeldAuftraege(options) {
 }
 function pruefeCent(wert, was) {
     if (typeof wert !== 'number' || !Number.isInteger(wert) || wert <= 0) {
-        throw new RangeError(`Zahlbetrag: ${was} muss eine ganze Zahl in Cent > 0 sein.`);
+        throw new ReceiptDueError('invalid_tip', `${was} muss eine ganze Zahl in Cent > 0 sein.`);
     }
 }
 /** `tip-core.buildTipItems`: Personal in den Null-%-Satz, Inhaber anteilig auf die Saetze der Ware. */
@@ -124,13 +170,13 @@ function trinkgeldPositionen(auftrag, positionen, standard) {
     const basis = warenCentsJeSatz(positionen);
     const summe = Object.values(basis).reduce((s, c) => s + c, 0);
     if (summe <= 0)
-        throw new RangeError('Zahlbetrag: Trinkgeld braucht mindestens eine Position mit Betrag.');
+        throw new ReceiptDueError('tip_without_goods', 'Trinkgeld braucht mindestens eine Position mit Betrag.');
     const raus = [];
     for (const e of auftrag.empfaenger) {
         let owner = e.owner;
         if (owner == null) {
             if (standard !== 'owner' && standard !== 'staff') {
-                throw new RangeError("Zahlbetrag: tipRecipient fehlt ('owner' oder 'staff', wie der angemeldete Kassen-Benutzer).");
+                throw new ReceiptDueError('tip_recipient_missing', "tipRecipient fehlt ('owner' oder 'staff', wie der angemeldete Kassen-Benutzer).");
             }
             owner = standard === 'owner';
         }
@@ -140,7 +186,7 @@ function trinkgeldPositionen(auftrag, positionen, standard) {
         }
         const teile = splitOwnerTip(e.cents, basis);
         if (teile.length === 0)
-            throw new RangeError('Zahlbetrag: Inhaber-Trinkgeld braucht mindestens eine Position mit Betrag.');
+            throw new ReceiptDueError('tip_without_goods', 'Inhaber-Trinkgeld braucht mindestens eine Position mit Betrag.');
         for (const teil of teile) {
             if (teil.cents !== 0)
                 raus.push({ amount: 1, priceOne: teil.cents / 100, vat: teil.vat, tip: 'owner' });

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

@@ -6,4 +6,4 @@ export { type SheetLogoSize, type SheetLogo, type LogoDimensions, type SheetBloc
 export { rasterizeLogo } from './bild.js';
 export { type BrandMarkRaster, BRAND_MARK_RASTERS, BRAND_MARK_PATHS } from './marke-daten.js';
 export { brandMarkImage } from './marke.js';
-export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, receiptDueCents, receiptDueBreakdown, } from './due.js';
+export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './due.js';

package/dist/cjs/receipt/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.receiptDueBreakdown = exports.receiptDueCents = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -53,3 +53,6 @@ Object.defineProperty(exports, "brandMarkImage", { enumerable: true, get: functi
 var due_js_1 = require("./due.js");
 Object.defineProperty(exports, "receiptDueCents", { enumerable: true, get: function () { return due_js_1.receiptDueCents; } });
 Object.defineProperty(exports, "receiptDueBreakdown", { enumerable: true, get: function () { return due_js_1.receiptDueBreakdown; } });
+Object.defineProperty(exports, "ReceiptDueError", { enumerable: true, get: function () { return due_js_1.ReceiptDueError; } });
+Object.defineProperty(exports, "RECEIPT_DUE_ERROR_REASONS", { enumerable: true, get: function () { return due_js_1.RECEIPT_DUE_ERROR_REASONS; } });
+Object.defineProperty(exports, "isReceiptDueError", { enumerable: true, get: function () { return due_js_1.isReceiptDueError; } });

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

@@ -107,3 +107,4 @@ export declare function invalidStoredPosSettings(stored: {
  * weg.
  */
 export declare function fromStoredArticle(id: string, stored: unknown): PosArticle;
+export { fromStoredLayout, toStoredLayout, fromStoredPrintLogo, toStoredPrintLogo } from './layout.js';

package/dist/cjs/stored/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.toStoredPrintLogo = exports.fromStoredPrintLogo = exports.toStoredLayout = exports.fromStoredLayout = void 0;
 exports.fromStoredReceipt = fromStoredReceipt;
 exports.fromStoredReceiptWithCompany = fromStoredReceiptWithCompany;
 exports.fromStoredCompany = fromStoredCompany;
@@ -223,3 +224,9 @@ function invalidStoredPosSettings(stored) {
 function fromStoredArticle(id, stored) {
     return (0, artikel_js_1.fromPosArticlePayload)((0, draht_js_1._storedArticleToWire)(id, stored));
 }
+// ---- Zeilenmodell und Drucklogo ----------------------------------------------
+var layout_js_2 = require("./layout.js");
+Object.defineProperty(exports, "fromStoredLayout", { enumerable: true, get: function () { return layout_js_2.fromStoredLayout; } });
+Object.defineProperty(exports, "toStoredLayout", { enumerable: true, get: function () { return layout_js_2.toStoredLayout; } });
+Object.defineProperty(exports, "fromStoredPrintLogo", { enumerable: true, get: function () { return layout_js_2.fromStoredPrintLogo; } });
+Object.defineProperty(exports, "toStoredPrintLogo", { enumerable: true, get: function () { return layout_js_2.toStoredPrintLogo; } });

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

@@ -0,0 +1,55 @@
+/**
+ * Zeilenmodell und Drucklogo in der inneren Form (deutsch) <-> Form 1.0.
+ *
+ * Die innere Form ist die, die das Backend speichert und am Draht `/api`
+ * (Kanal intern) spricht, und die, in der 0.x das Zeilenmodell im Browser
+ * zwischengespeichert hat:
+ *
+ * - Zeilenmodell: `regelwerk` statt `ruleset`, Bannerzeilen mit `ton`
+ *   (`belegart`, `warnung`) statt `tone` (`receipt_type`, `warning`);
+ * - Drucklogo (`createPrintJob`, Parameter `logo`): `stufe`, `pxBreite`,
+ *   `pxHoehe`, `breite`, `hoehe`, `zeilen` (Base64, MSB zuerst) statt
+ *   [PrintLogo] (`size`, `pixelWidth`, `pixelHeight`, `raster`).
+ *
+ * Dieselben Namen wie der Rand des Backends unter `/v3` (Vokabular
+ * `createPrintJob`/`getReceiptWithCompany`: `layout.ruleset` <-> `regelwerk`,
+ * `lines[].tone` <-> `ton`, Katalog `LAYOUT_TON`, `logo.scale` <-> `stufe` ...).
+ * Ein unbekannter Ton geht woertlich durch, wie ihn auch der Rand durchreicht.
+ */
+import type { ReceiptLayout } from '../receipt/layout.js';
+import type { PrintLogo } from '../receipt/layout-escpos.js';
+/**
+ * Ein Zeilenmodell in der inneren Form (0.x-Zwischenspeicher, Antwort unter
+ * `/api`) als [ReceiptLayout]. Nimmt auch die Form 1.0 an und laesst sie
+ * unveraendert; so liest eine Funktion alte und neue Eintraege. Die
+ * Reihenfolge der Schluessel bleibt.
+ *
+ * `null`, wenn es kein ganzes Zeilenmodell ist: fehlt, kein Objekt, keine
+ * oder leere `lines`, eine Zeile, die kein Objekt ist, oder kein `paperSize`.
+ * Dann baut der Aufrufer neu (`receiptLayoutFromResult` aus Beleg, Firma und
+ * `testCashregister`/`testSignature`), und TESTKASSE und die Warnzeilen
+ * stehen wieder da. Ein halb lesbares Zeilenmodell gewaenne sonst immer.
+ */
+export declare function fromStoredLayout(stored: unknown): ReceiptLayout | null;
+/**
+ * Ein [ReceiptLayout] in der inneren Form, fuer einen Aufruf unter `/api`
+ * (`createPrintJob`, `renderBelegPdfAdmin`) oder einen Leser der 0.x-Form,
+ * in der Reihenfolge der Schluessel wie 0.31 (`lines`, `paperSize`,
+ * `regelwerk`, sofern die Eingabe sie so hat). Ohne diese Uebersetzung liest
+ * das Backend den Ton nicht, und der Rahmen der Warnzeilen (TESTKASSE,
+ * Sicherheitseinrichtung ausgefallen) und des Belegart-Aufdrucks fiele am
+ * Bon und im PDF weg.
+ */
+export declare function toStoredLayout(layout: ReceiptLayout): Record<string, unknown>;
+/**
+ * Ein [PrintLogo] in der inneren Form des Druckjobs (`createPrintJob` unter
+ * `/api`): dieselben Punkte, die das Paket unter `/v3` als `logo` schickt.
+ */
+export declare function toStoredPrintLogo(logo: PrintLogo): Record<string, unknown>;
+/**
+ * Ein Drucklogo in der inneren Form als [PrintLogo]. Die Zeilen sind die
+ * Rasterzeilen als Base64 (MSB zuerst, jede Zeile auf volle Bytes
+ * aufgefuellt). Wirft `KasseneckValidationError`, wenn Stufe, Masse oder
+ * Zeilen nicht zusammenpassen.
+ */
+export declare function fromStoredPrintLogo(stored: unknown): PrintLogo;

package/dist/cjs/stored/layout.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromStoredLayout = fromStoredLayout;
+exports.toStoredLayout = toStoredLayout;
+exports.toStoredPrintLogo = toStoredPrintLogo;
+exports.fromStoredPrintLogo = fromStoredPrintLogo;
+const escpos_js_1 = require("../printing/escpos.js");
+const errors_js_1 = require("../client/errors.js");
+const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
+const TON_NACH_1_0 = { belegart: 'receipt_type', warnung: 'warning' };
+const TON_NACH_INNEN = { receipt_type: 'belegart', warning: 'warnung' };
+/**
+ * Ein Objekt mit umbenannten Schluesseln, an derselben Stelle: die
+ * Reihenfolge bleibt, damit ein gespeicherter Eintrag byte-gleich
+ * zurueckkommt (Hash- und Cache-Vergleiche). `werte` ersetzt den Wert eines
+ * (alten) Schluessels.
+ */
+function umbenannt(o, namen, werte = {}) {
+    const raus = {};
+    for (const [k, w] of Object.entries(o)) {
+        const neu = namen[k] ?? k;
+        // Traegt die Eingabe beide Namen, gewinnt der schon neue.
+        if (neu !== k && Object.prototype.hasOwnProperty.call(o, neu))
+            continue;
+        raus[neu] = werte[k] ? werte[k](w) : w;
+    }
+    return raus;
+}
+const tonNach = (tabelle) => (w) => (typeof w === 'string' ? tabelle[w] ?? w : w);
+/**
+ * Ein Zeilenmodell in der inneren Form (0.x-Zwischenspeicher, Antwort unter
+ * `/api`) als [ReceiptLayout]. Nimmt auch die Form 1.0 an und laesst sie
+ * unveraendert; so liest eine Funktion alte und neue Eintraege. Die
+ * Reihenfolge der Schluessel bleibt.
+ *
+ * `null`, wenn es kein ganzes Zeilenmodell ist: fehlt, kein Objekt, keine
+ * oder leere `lines`, eine Zeile, die kein Objekt ist, oder kein `paperSize`.
+ * Dann baut der Aufrufer neu (`receiptLayoutFromResult` aus Beleg, Firma und
+ * `testCashregister`/`testSignature`), und TESTKASSE und die Warnzeilen
+ * stehen wieder da. Ein halb lesbares Zeilenmodell gewaenne sonst immer.
+ */
+function fromStoredLayout(stored) {
+    if (!istObjekt(stored) || !Array.isArray(stored.lines) || stored.lines.length === 0)
+        return null;
+    if (!stored.lines.every(istObjekt))
+        return null;
+    if (typeof stored.paperSize !== 'string' || stored.paperSize === '')
+        return null;
+    return umbenannt(stored, { regelwerk: 'ruleset' }, {
+        lines: (zeilen) => zeilen.map((z) => umbenannt(z, { ton: 'tone' }, { ton: tonNach(TON_NACH_1_0) })),
+    });
+}
+/**
+ * Ein [ReceiptLayout] in der inneren Form, fuer einen Aufruf unter `/api`
+ * (`createPrintJob`, `renderBelegPdfAdmin`) oder einen Leser der 0.x-Form,
+ * in der Reihenfolge der Schluessel wie 0.31 (`lines`, `paperSize`,
+ * `regelwerk`, sofern die Eingabe sie so hat). Ohne diese Uebersetzung liest
+ * das Backend den Ton nicht, und der Rahmen der Warnzeilen (TESTKASSE,
+ * Sicherheitseinrichtung ausgefallen) und des Belegart-Aufdrucks fiele am
+ * Bon und im PDF weg.
+ */
+function toStoredLayout(layout) {
+    if (!istObjekt(layout) || !Array.isArray(layout.lines)) {
+        throw new errors_js_1.KasseneckValidationError('toStoredLayout', 'layout ohne lines', 'request');
+    }
+    return umbenannt(layout, { ruleset: 'regelwerk' }, {
+        lines: (zeilen) => zeilen.map((z) => (istObjekt(z) ? umbenannt(z, { tone: 'ton' }, { tone: tonNach(TON_NACH_INNEN) }) : z)),
+    });
+}
+/**
+ * Ein [PrintLogo] in der inneren Form des Druckjobs (`createPrintJob` unter
+ * `/api`): dieselben Punkte, die das Paket unter `/v3` als `logo` schickt.
+ */
+function toStoredPrintLogo(logo) {
+    return {
+        stufe: logo.size, pxBreite: logo.pixelWidth, pxHoehe: logo.pixelHeight,
+        breite: logo.raster.width, hoehe: logo.raster.height, zeilen: (0, escpos_js_1.rasterRowsBase64)(logo.raster),
+    };
+}
+const STUFEN = new Set(['S', 'M', 'L', 'XL']);
+const ganz = (w) => typeof w === 'number' && Number.isInteger(w) && w > 0;
+/**
+ * Ein Drucklogo in der inneren Form als [PrintLogo]. Die Zeilen sind die
+ * Rasterzeilen als Base64 (MSB zuerst, jede Zeile auf volle Bytes
+ * aufgefuellt). Wirft `KasseneckValidationError`, wenn Stufe, Masse oder
+ * Zeilen nicht zusammenpassen.
+ */
+function fromStoredPrintLogo(stored) {
+    const name = 'fromStoredPrintLogo';
+    if (!istObjekt(stored))
+        throw new errors_js_1.KasseneckValidationError(name, 'kein Logo-Objekt', 'request');
+    const { stufe, pxBreite, pxHoehe, breite, hoehe, zeilen } = stored;
+    if (typeof stufe !== 'string' || !STUFEN.has(stufe))
+        throw new errors_js_1.KasseneckValidationError(name, 'stufe ist nicht S, M, L oder XL', 'request');
+    if (!ganz(pxBreite) || !ganz(pxHoehe) || !ganz(breite) || !ganz(hoehe)) {
+        throw new errors_js_1.KasseneckValidationError(name, 'pxBreite, pxHoehe, breite und hoehe muessen ganze Zahlen > 0 sein', 'request');
+    }
+    if (typeof zeilen !== 'string')
+        throw new errors_js_1.KasseneckValidationError(name, 'zeilen fehlt', 'request');
+    let binaer;
+    try {
+        binaer = atob(zeilen);
+    }
+    catch {
+        throw new errors_js_1.KasseneckValidationError(name, 'zeilen ist kein Base64', 'request');
+    }
+    const byteJeZeile = Math.ceil(breite / 8);
+    if (binaer.length !== byteJeZeile * hoehe)
+        throw new errors_js_1.KasseneckValidationError(name, 'zeilen passen nicht zu breite und hoehe', 'request');
+    const dots = new Uint8Array(breite * hoehe);
+    for (let y = 0; y < hoehe; y++) {
+        for (let x = 0; x < breite; x++) {
+            if (binaer.charCodeAt(y * byteJeZeile + (x >> 3)) & (0x80 >> (x & 7)))
+                dots[y * breite + x] = 1;
+        }
+    }
+    const raster = { width: breite, height: hoehe, dots };
+    return { size: stufe, pixelWidth: pxBreite, pixelHeight: pxHoehe, raster };
+}

package/dist/cjs/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0-rc.4";
+export declare const PACKAGE_VERSION = "1.0.0";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.0.0-rc.4';
+exports.PACKAGE_VERSION = '1.0.0';

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 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 RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, 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, isZeroKind, 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, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
-export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, receiptDueCents, receiptDueBreakdown, } from './receipt/due.js';
+export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type PosBusinessSettings, type PosDeviceSettings, type PosSettings, type ArticleGroup, type PosArticle, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, } from './pos/index.js';

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 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_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, fromReceiptPaymentPayload, toReceiptPaymentPayload, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, isZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, ALL_CALLS, PUBLIC_CALLS, POS_CALLS, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
-export { receiptDueCents, receiptDueBreakdown, } from './receipt/due.js';
+export { receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, } from './pos/index.js';

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

@@ -12,4 +12,4 @@ export { distributeDiscount } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
-export { MESSAGES, ERROR_RULES, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/esm/pos/index.js

@@ -17,4 +17,4 @@ export { cancelScopeOf, receiptsScopeOf } from '../register/pairing.js';
 export { PRINT_JOB_STATUSES, PRINT_JOB_SOURCES, isPrintJobFinished, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
 // Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
-export { MESSAGES, ERROR_RULES, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, } from './texte.js';

package/dist/esm/pos/texte.d.ts

@@ -20,6 +20,7 @@
  * `only`), die Platzhalter und die Arten der Fehlerregeln (Abschnitte
  * `placeholders` und `structure`).
  */
+import { type ErrorOutcome } from '../client/errors.js';
 export type Surface = 'web' | 'app';
 export interface TextEntry {
     readonly text: string;
@@ -35,10 +36,19 @@ declare const MELDUNGEN_ROH: {
     readonly 'network.timeout': {
         readonly text: "Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.";
     };
+    readonly 'network.outcome_unknown': {
+        readonly text: "Der Server hat nicht geantwortet, der Vorgang kann trotzdem gebucht sein. Bitte vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.";
+    };
     readonly 'server.unexpected': {
         readonly text: "Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.";
         readonly placeholders: readonly ["status"];
     };
+    readonly 'server.connection_disturbed': {
+        readonly text: "Die Verbindung zum Kassenserver ist gestört. Bitte kurz warten und erneut versuchen.";
+    };
+    readonly 'server.response_unreadable': {
+        readonly text: "Die Antwort des Kassenservers war nicht lesbar. Bitte die Kasse neu öffnen und vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.";
+    };
     readonly 'pairing.code_missing': {
         readonly text: "Bitte den Kopplungs-Code eingeben.";
     };
@@ -543,8 +553,8 @@ export type MessageKey = keyof typeof MELDUNGEN_ROH;
 export declare const MESSAGES: Record<MessageKey, TextEntry>;
 /**
  * In welcher Reihenfolge ein Fehler eingeordnet wird, auf beiden Seiten
- * dieselbe. Jede Regel nennt ihre Art (`kind`) und entweder ein Verhalten
- * (`behavior`) oder den Schluessel des Satzes (`key`). Die Arten:
+ * dieselbe. Genau eine Regel je Art (`kind`), mit einem Verhalten
+ * (`behavior`) oder dem Schluessel des Satzes (`key`). Die Arten:
  *   api        - HTTP 200, `status:'error'`: der Satz des Backends, woertlich
  *                (`server_text`)
  *   plain_text - schon fuer den Bildschirm geschrieben: sein eigener Text
@@ -557,6 +567,11 @@ export declare const MESSAGES: Record<MessageKey, TextEntry>;
  *                (`fallback`)
  * Unter 0.x hiessen sie `klartext`, `zeitablauf`, `netz`, `unerwartet`,
  * `sonst` (Tabelle in `fixtures/renames-1.0.json`).
+ *
+ * Seit 1.0.0-rc.5 verfeinern [ERROR_CODE_RULES] und [ERROR_OUTCOME_RULES]
+ * diese Liste; sie stehen bewusst getrennt, damit ein Leser, der nur nach
+ * `kind` sucht, weiter genau den Satz von rc.4 zeigt. [findErrorRule] wendet
+ * alle drei in der richtigen Reihenfolge an.
  */
 export declare const ERROR_RULES: readonly [{
     readonly kind: "api";
@@ -578,6 +593,73 @@ export declare const ERROR_RULES: readonly [{
     readonly behavior: "fallback";
 }];
 export type ErrorKind = (typeof ERROR_RULES)[number]['kind'];
+/**
+ * Regeln je Code (`error.code`), vor der Regel der Art: sie ersetzen den
+ * technischen Satz des Pakets bzw. des Rands durch einen Menschentext. Der
+ * technische Satz bleibt in `error.message` fuers Protokoll.
+ *   - `dialect_mismatch`, `response_translation_failed`, `response_unreadable`:
+ *     Ausgang unklar, der Vorgang kann gebucht sein; der Satz raet nie zum
+ *     Wiederholen, sondern zum Nachsehen.
+ *   - `route_missing`, `not_found`, `internal_translation_error`: am Server
+ *     geschah nichts, ein neuer Versuch ist sicher (auch auf den Geldwegen:
+ *     alle drei stehen in `PAYMENT_CALL_REJECTED_CODES`).
+ */
+export declare const ERROR_CODE_RULES: readonly [{
+    readonly kind: "api";
+    readonly codes: readonly ["dialect_mismatch", "response_translation_failed", "response_unreadable"];
+    readonly key: "server.response_unreadable";
+}, {
+    readonly kind: "api";
+    readonly codes: readonly ["route_missing", "not_found", "internal_translation_error"];
+    readonly key: "server.connection_disturbed";
+}];
+/**
+ * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
+ * Frist oder ein Netzfehler auf einem Aufruf mit Wirkung (Ausgang unklar,
+ * siehe [messageOutcome]) raet nie zum Wiederholen. Ein Netzfehler auf einem
+ * Aufruf ohne Wirkung behaelt den Satz von rc.4 („erneut versuchen“).
+ */
+export declare const ERROR_OUTCOME_RULES: readonly [{
+    readonly kind: "timeout";
+    readonly outcome: "unknown";
+    readonly key: "network.outcome_unknown";
+}, {
+    readonly kind: "network";
+    readonly outcome: "unknown";
+    readonly key: "network.outcome_unknown";
+}];
+export type ErrorRule = (typeof ERROR_RULES)[number] | (typeof ERROR_CODE_RULES)[number] | (typeof ERROR_OUTCOME_RULES)[number];
+/** Was ueber einen Fehler bekannt ist, ausser seiner Art. */
+export interface ErrorRuleDetail {
+    /** `error.code` eines `KasseneckApiError`. */
+    code?: string | null;
+    /** Ausgang fuer den Satz, siehe [messageOutcome]. */
+    outcome?: ErrorOutcome | null;
+}
+/**
+ * Die Regel fuer einen Fehler: zuerst eine Code-Regel mit passender Art und
+ * passendem `code`, dann eine Ausgangs-Regel mit passender Art und
+ * passendem `outcome`, sonst die Regel der Art aus [ERROR_RULES]. Beide
+ * Kassen ordnen so ein.
+ */
+export declare function findErrorRule(kind: ErrorKind, detail?: ErrorRuleDetail): ErrorRule;
+/**
+ * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
+ * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
+ * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
+ * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
+ * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
+ * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
+ * hier immer der vorsichtige Satz.
+ */
+export declare const CALLS_WITH_EFFECT: readonly ["createReceipt", "cancelReceipt", "financeWebService", "hobexPayApi", "hobexRefundApi", "stripeCaptureIntent", "createPrintJob", "sendReceiptEmail"];
+/**
+ * Der Ausgang, nach dem der Satz gewaehlt wird: `'unknown'`, wenn das Paket
+ * ihn als unklar fuehrt ([isOutcomeUnknown]) oder wenn eine Frist bzw. ein
+ * Netzfehler einen Aufruf aus [CALLS_WITH_EFFECT] traf; sonst der Ausgang
+ * des Fehlers (`'rejected'`) bzw. `undefined` fuer fremde Fehler.
+ */
+export declare function messageOutcome(error: unknown): ErrorOutcome | undefined;
 /**
  * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
  *
@@ -662,6 +744,13 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'pairing.pair_again': {
         readonly text: "Neu koppeln";
     };
+    readonly 'register.device_unnamed': {
+        readonly text: "Kasse";
+    };
+    readonly 'login.locked_seconds': {
+        readonly text: "Noch {seconds} s gesperrt";
+        readonly placeholders: readonly ["seconds"];
+    };
     readonly 'logout.question': {
         readonly text: "Wirklich abmelden?";
     };
@@ -731,6 +820,10 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'split.remaining': {
         readonly text: "Rest";
     };
+    readonly 'split.remaining_with_rounding': {
+        readonly text: "Rest inkl. Rundung {amount} ({cents} ct)";
+        readonly placeholders: readonly ["amount", "cents"];
+    };
     readonly 'split.divide': {
         readonly text: "÷ {n}";
         readonly placeholders: readonly ["n"];