@kreiseck/kasseneck-api 0.7.1 → 0.8.0

package/dist/cjs/payments/hobex-hps/payments.js

@@ -70,7 +70,7 @@ function createHpsPayments(client, target, options = {}) {
             return `Antwort mit technischem Fehler (${transaction_response_js_1.TECHNICAL_ERROR_CODE}) -- keine Aussage ueber den Vorgang, Ausgang wird geklaert`;
         }
         if ((0, transaction_response_js_1.isUnknownCode)(res)) {
-            return `Terminal nennt einen unbekannten Code (${res.responseCode}) -- Ausgang wird geklaert`;
+            return `Terminal nennt einen unbekannten Code (${res.responseCode})${klartext(res)} -- Ausgang wird geklaert`;
         }
         return `Antwort ohne Aussage (${res.responseCode}) -- Ausgang wird geklaert`;
     }
@@ -83,10 +83,21 @@ function createHpsPayments(client, target, options = {}) {
             return `Status: technischer Fehler (${transaction_response_js_1.TECHNICAL_ERROR_CODE}) -- keine Aussage ueber den Vorgang`;
         }
         if ((0, transaction_response_js_1.isUnknownCode)(status)) {
-            return `Status: unbekannter Code (${status.responseCode}) -- keine Aussage`;
+            return `Status: unbekannter Code (${status.responseCode})${klartext(status)} -- keine Aussage`;
         }
         return null;
     }
+    /**
+     * Der Klartext des Terminals zu einem UNBEKANNTEN Code, als Zusatz fuer den
+     * Nachweis -- oder leer, wenn keiner mitkam. Nur hier, nicht bei den
+     * gemessenen Codes: deren Bedeutung ist benannt. Bei einem unbekannten Code
+     * ist er dagegen das Einzige, was ein Mensch lesen kann -- "PIN falsch"
+     * neben `55` haette am 02.09.2026 gereicht, um nicht "bezahlt" zu buchen.
+     */
+    function klartext(res) {
+        const text = res.responseText?.trim();
+        return text ? ` "${text}"` : '';
+    }
     /** Ordnet eine Terminal-Antwort ein. `null`, wenn sie nichts entscheidet. */
     function fromResponse(res, id, steps) {
         if (!(0, transaction_response_js_1.isConclusive)(res))
@@ -188,9 +199,19 @@ function createHpsPayments(client, target, options = {}) {
         }
         return null;
     }
-    function open(id, steps) {
+    /**
+     * [letzteAntwort] ist die letzte Antwort, die das Terminal in dieser
+     * Klaerung gab -- als `lastResponse` fuer Anzeige und Katalog,
+     * ausdruecklich NICHT als `response`.
+     */
+    function open(id, steps, letzteAntwort) {
         emit('resolved', steps[steps.length - 1], id);
-        return { outcome: 'unresolved', transactionId: id, steps: [...steps] };
+        return {
+            outcome: 'unresolved',
+            transactionId: id,
+            ...(letzteAntwort ? { lastResponse: letzteAntwort } : {}),
+            steps: [...steps],
+        };
     }
     /**
      * Fuehrt [call] aus, aber hoechstens so lange, wie vom [resolveBudgetMs]
@@ -263,7 +284,7 @@ function createHpsPayments(client, target, options = {}) {
      * [NO_STATEMENT_CODE] (`9027`) beim Pollen einen Aussagewert, den es sonst
      * nicht hat. Siehe [ausGeschlossenerAntwort].
      */
-    async function resolve(id, steps, antwortMitCode = false) {
+    async function resolve(id, steps, antwortMitCode = false, letzteAntwort) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -284,6 +305,7 @@ function createHpsPayments(client, target, options = {}) {
             try {
                 status = await withinBudget(elapsedMs, () => client.status({ ...target, transactionId: id }));
                 transportFailures = 0;
+                letzteAntwort = status;
             }
             catch (e) {
                 transportFailures += 1;
@@ -312,7 +334,7 @@ function createHpsPayments(client, target, options = {}) {
             wait = nextWait(wait);
         }
         steps.push('Ausgang bleibt offen');
-        return open(id, steps);
+        return open(id, steps, letzteAntwort);
     }
     /**
      * Liest `9027` beim Pollen als "nicht genehmigt" -- aber NUR, wenn das
@@ -372,7 +394,7 @@ function createHpsPayments(client, target, options = {}) {
      * Budget, Backoff und Transportfehler-Deckelung sind unveraendert aus
      * [resolve] uebernommen.
      */
-    async function resolveCancel(id, steps) {
+    async function resolveCancel(id, steps, letzteAntwort) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -393,6 +415,7 @@ function createHpsPayments(client, target, options = {}) {
                 status = await withinBudget(elapsedMs, () => client.status({ ...target, transactionId: id }));
                 transportFailures = 0;
                 answeredQueries += 1;
+                letzteAntwort = status;
             }
             catch (e) {
                 transportFailures += 1;
@@ -416,7 +439,7 @@ function createHpsPayments(client, target, options = {}) {
             wait = nextWait(wait);
         }
         steps.push('Ausgang bleibt offen');
-        return open(id, steps);
+        return open(id, steps, letzteAntwort);
     }
     async function pay(paymentOptions) {
         const id = paymentOptions.transactionId ?? (0, transaction_id_js_1.newHpsTransactionId)();
@@ -455,7 +478,7 @@ function createHpsPayments(client, target, options = {}) {
                 return settled;
             steps.push(offeneAntwort(res));
         }
-        return resolve(id, steps, res?.responseCode !== undefined);
+        return resolve(id, steps, res?.responseCode !== undefined, res);
     }
     /**
      * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
@@ -499,7 +522,7 @@ function createHpsPayments(client, target, options = {}) {
         // Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
         // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang,
         // und der Abbruch ist derselbe Diskriminator wie bei einer Zahlung.
-        return resolve(id, steps, res?.responseCode !== undefined);
+        return resolve(id, steps, res?.responseCode !== undefined, res);
     }
     /**
      * Aufhebung (Storno/Void) einer bestehenden Zahlung mit geklaertem Ausgang.
@@ -544,7 +567,7 @@ function createHpsPayments(client, target, options = {}) {
             if (!(0, transaction_response_js_1.isCanceled)(res))
                 steps.push(offeneAntwort(res));
         }
-        return resolveCancel(id, steps);
+        return resolveCancel(id, steps, res);
     }
     return { pay, refund, cancel };
 }

package/dist/cjs/payments/hobex-hps/transaction-response.d.ts

@@ -72,6 +72,18 @@ export declare const INVALID_AMOUNT_CODE = "9003";
 export declare const AMOUNT_OUT_OF_RANGE_CODE = "100019";
 /** Siehe [HPS_MEASURED_CODES]: Terminal-Kennung unbekannt. */
 export declare const INVALID_TID_CODE = "100108";
+/**
+ * Siehe [HPS_MEASURED_CODES]: Host-Ablehnung, falsche PIN -- nichts belastet.
+ *
+ * Zweistellig, weil ein Antwortcode des HOSTS (ISO 8583, 55 = "Incorrect
+ * PIN"), kein `9xxx`-Terminalcode und kein `100xxx`-Code der HPS-Anwendung.
+ * Daraus folgt KEINE Regel fuer andere zweistellige Codes: in derselben
+ * Familie stehen Genehmigungen (`08`, `10`, `11`, `85`). Jeder andere
+ * Host-Code bleibt eine Wissensluecke, bis er gemessen ist -- und die
+ * Zwei-9027-Regel in `payments.ts` faengt ihn nicht, weil die Statusabfrage
+ * dann nicht 9027 antwortet, sondern mit dem Code selbst.
+ */
+export declare const WRONG_PIN_CODE = "55";
 /**
  * HTTP `409` ("Terminal is busy"): das Terminal serialisiert und weist eine
  * zweite Anfrage ab, waehrend eine erste noch laeuft. Am 27.08.2026 gemessen:

package/dist/cjs/payments/hobex-hps/transaction-response.js

@@ -28,7 +28,7 @@
  * sein kann, als `declined` gemeldet.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TERMINAL_BUSY_HTTP_STATUS = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.CARD_NOT_PRESENT_CODE = exports.ABORTED_CODE = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.TRANSACTION_CANCELED_CODE = exports.INVALID_TRANSACTION_CODE = exports.APPROVED_CODE = exports.HPS_MEASURED_CODES = void 0;
+exports.TERMINAL_BUSY_HTTP_STATUS = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.CARD_NOT_PRESENT_CODE = exports.ABORTED_CODE = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.TRANSACTION_CANCELED_CODE = exports.INVALID_TRANSACTION_CODE = exports.APPROVED_CODE = exports.HPS_MEASURED_CODES = void 0;
 exports.parseHpsTransactionResponse = parseHpsTransactionResponse;
 exports.isApproved = isApproved;
 exports.isInProgress = isInProgress;
@@ -96,6 +96,15 @@ exports.HPS_MEASURED_CODES = [
             + 'nicht; der Vorgang wird abgewiesen, bevor etwas geschieht',
         conclusive: true,
     },
+    {
+        code: '55',
+        meaning: '"PIN falsch" -- Host-Ablehnung wegen falscher PIN, die erste '
+            + 'gemessene Host-Ablehnung ueberhaupt (02.09.2026 im Betrieb, TID '
+            + '3556988, HPS 1.11.4, Firmware 2.3.9): die Zahlung antwortete direkt '
+            + 'damit, die Statusabfrage danach elfmal in Folge ebenso -- eine '
+            + 'Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet',
+        conclusive: true,
+    },
 ];
 /** `responseCode` einer genehmigten Zahlung. */
 exports.APPROVED_CODE = '0';
@@ -119,6 +128,18 @@ exports.INVALID_AMOUNT_CODE = '9003';
 exports.AMOUNT_OUT_OF_RANGE_CODE = '100019';
 /** Siehe [HPS_MEASURED_CODES]: Terminal-Kennung unbekannt. */
 exports.INVALID_TID_CODE = '100108';
+/**
+ * Siehe [HPS_MEASURED_CODES]: Host-Ablehnung, falsche PIN -- nichts belastet.
+ *
+ * Zweistellig, weil ein Antwortcode des HOSTS (ISO 8583, 55 = "Incorrect
+ * PIN"), kein `9xxx`-Terminalcode und kein `100xxx`-Code der HPS-Anwendung.
+ * Daraus folgt KEINE Regel fuer andere zweistellige Codes: in derselben
+ * Familie stehen Genehmigungen (`08`, `10`, `11`, `85`). Jeder andere
+ * Host-Code bleibt eine Wissensluecke, bis er gemessen ist -- und die
+ * Zwei-9027-Regel in `payments.ts` faengt ihn nicht, weil die Statusabfrage
+ * dann nicht 9027 antwortet, sondern mit dem Code selbst.
+ */
+exports.WRONG_PIN_CODE = '55';
 /**
  * HTTP `409` ("Terminal is busy"): das Terminal serialisiert und weist eine
  * zweite Anfrage ab, waehrend eine erste noch laeuft. Am 27.08.2026 gemessen:

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

@@ -10,3 +10,4 @@ export { verteileRabatt } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetzDrucker, type DruckJob, type DruckJobStatus, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, } from './texte.js';

package/dist/esm/kasse/index.js

@@ -14,3 +14,5 @@ export { verteileRabatt } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf } from '../register/pairing.js';
 export { listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
+// Was die Kasse selbst sagt — ein Katalog fuer Browser-Kasse und App.
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, } from './texte.js';

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

@@ -0,0 +1,336 @@
+/**
+ * Was die Kasse selbst sagt — auf dem Bildschirm, in beiden Huellen.
+ *
+ * Die Browser-Kasse und die Kassen-App sind eine Kasse. Was der Kassier bei
+ * einem Fehler liest, steht hier genau einmal; beide Apps beziehen den Satz
+ * von hier, und wer ihn aendert, aendert ihn auf beiden Seiten oder gar nicht.
+ *
+ * Nicht hier: die fachlichen Saetze des Backends („Kopplungs-Code ist
+ * abgelaufen.", „PIN falsch, noch 2 Versuche"). Die gehen unveraendert durch.
+ *
+ * Ein Satz sagt, was los ist, und was zu tun ist. Nie Innereien.
+ *
+ * Schluessel: `bereich.name`. Ein Schluessel wird nie umgedeutet — wer den
+ * Sinn aendert, legt einen neuen an. `nur` nennt die Seite, wenn ein Satz nur
+ * auf einer Plattform vorkommen kann.
+ */
+export type Seite = 'web' | 'app';
+export interface Meldung {
+    readonly text: string;
+    /** Erlaubte Platzhalter `{name}`; muessen exakt die im Text sein. */
+    readonly platzhalter?: readonly string[];
+    /** Fehlt es, gilt der Satz fuer beide Seiten. */
+    readonly nur?: readonly Seite[];
+}
+declare const MELDUNGEN_ROH: {
+    readonly 'netz.keine_verbindung': {
+        readonly text: "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.";
+    };
+    readonly 'netz.zeitablauf': {
+        readonly text: "Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.";
+    };
+    readonly 'server.unerwartet': {
+        readonly text: "Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.";
+        readonly platzhalter: readonly ["status"];
+    };
+    readonly 'kopplung.code_fehlt': {
+        readonly text: "Bitte den Kopplungs-Code eingeben.";
+    };
+    readonly 'kopplung.fehlgeschlagen': {
+        readonly text: "Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.";
+    };
+    readonly 'kopplung.unvollstaendig': {
+        readonly text: "Die Kopplung ist unvollständig zurückgekommen. Bitte im Panel einen neuen Code erzeugen und noch einmal versuchen.";
+    };
+    readonly 'geraet.browser_speicher': {
+        readonly text: "Dieses Gerät konnte nicht gespeichert werden — der Browser-Speicher steht nicht zur Verfügung. Bitte den privaten Modus verlassen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'anmeldung.pin_fehlt': {
+        readonly text: "Bitte die PIN eingeben.";
+    };
+    readonly 'anmeldung.fehlgeschlagen': {
+        readonly text: "Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.";
+    };
+    readonly 'anmeldung.nicht_abgeschlossen': {
+        readonly text: "Die Anmeldung konnte nicht abgeschlossen werden. Bitte erneut versuchen.";
+    };
+    readonly 'anmeldung.wird_abgeschlossen': {
+        readonly text: "Anmeldung wird gerade abgeschlossen — bitte gleich noch einmal drücken.";
+    };
+    readonly 'sitzung.abgelaufen': {
+        readonly text: "Die Sitzung ist abgelaufen. Bitte erneut anmelden.";
+    };
+    readonly 'sitzung.abgelaufen_ohne_netz': {
+        readonly text: "Keine Verbindung zum Server — die Sitzung ist abgelaufen. Bitte erneut anmelden.";
+    };
+    readonly 'sitzung.keine': {
+        readonly text: "Keine Sitzung.";
+    };
+    readonly 'rechte.nicht_aenderbar': {
+        readonly text: "Das darfst du nicht ändern — das Recht dafür vergibt der Inhaber im Panel.";
+    };
+    readonly 'kasse.laden_fehlgeschlagen': {
+        readonly text: "Die Kasse konnte nicht geladen werden.";
+    };
+    readonly 'artikel.laden_fehlgeschlagen': {
+        readonly text: "Die Artikel konnten nicht geladen werden.";
+    };
+    readonly 'artikel.keine_freigegeben': {
+        readonly text: "Keine Artikel an dieser Kasse. Im Panel unter „Kacheln & Gruppen“ freischalten.";
+    };
+    readonly 'artikel.keine_gefunden': {
+        readonly text: "Keine Artikel gefunden.";
+    };
+    readonly 'artikel.steuersatz_unbekannt': {
+        readonly text: "„{name}“ hat einen Steuersatz, den die Kasse nicht kennt.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'position.betrag_fehlt': {
+        readonly text: "Bitte einen Betrag eingeben.";
+    };
+    readonly 'position.bezeichnung_fehlt': {
+        readonly text: "Bitte eine Bezeichnung eingeben — sie steht am Beleg.";
+    };
+    readonly 'rabatt.prozent_ungueltig': {
+        readonly text: "Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.";
+    };
+    readonly 'abschluss.fehlgeschlagen': {
+        readonly text: "Der Abschluss ist fehlgeschlagen.";
+    };
+    readonly 'abschluss.unklar': {
+        readonly text: "Unklar, ob der Beleg entstanden ist — die Antwort kam nicht an. Bitte nicht noch einmal abschließen: der Beleg kann bereits erstellt und signiert sein. Im Panel unter „Belege“ nachsehen; nur wenn er dort fehlt, den Verkauf erneut abschließen.";
+    };
+    readonly 'abschluss.nullbeleg_fehlgeschlagen': {
+        readonly text: "Der Nullbeleg konnte nicht erstellt werden.";
+    };
+    readonly 'abschluss.signatur_ausgefallen': {
+        readonly text: "Die Signatureinheit hat nicht geantwortet. Der Beleg ist gültig und trägt den Vermerk „Sicherheitseinrichtung ausgefallen“.";
+    };
+    readonly 'kartenzahlung.nicht_moeglich': {
+        readonly text: "Kartenzahlung nicht möglich.";
+    };
+    readonly 'kartenzahlung.nicht_zustande': {
+        readonly text: "Die Kartenzahlung ist nicht zustande gekommen.";
+    };
+    readonly 'kartenzahlung.nicht_gestartet': {
+        readonly text: "Kartenzahlung nicht gestartet: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'kartenzahlung.unklar': {
+        readonly text: "Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein.";
+    };
+    readonly 'kartenzahlung.unklar_mit_kennung': {
+        readonly text: "Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein. Kennung der Zahlung: {kennung}.";
+        readonly platzhalter: readonly ["kennung"];
+    };
+    readonly 'kartenzahlung.connect_nicht_verbunden': {
+        readonly text: "Kartenzahlung nicht möglich: Kasseneck Connect ist nicht verbunden — Einstellungen → Kasseneck Connect.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'terminal.keines_gefunden': {
+        readonly text: "Kein Hobex-Terminal gefunden — ist es eingeschaltet und im selben Netz wie dieser Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'terminal.nicht_bereit': {
+        readonly text: "Terminal antwortet, ist aber nicht betriebsbereit: {antwort} — TID prüfen.";
+        readonly platzhalter: readonly ["antwort"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'gptom.app_fehlt': {
+        readonly text: "Die GP-Tom-App ist auf diesem Gerät nicht da.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.suche_fehlgeschlagen': {
+        readonly text: "GP Tom: Suche nach der App fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.zahlung_fehlgeschlagen': {
+        readonly text: "GP Tom: Zahlung fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.terminal_antwortet_nicht': {
+        readonly text: "Das Terminal hat nicht geantwortet: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.zahlung_nicht_abgeschlossen': {
+        readonly text: "Die Zahlung wurde nicht abgeschlossen ({code}).";
+        readonly platzhalter: readonly ["code"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'belege.laden_fehlgeschlagen': {
+        readonly text: "Die Belege konnten nicht geladen werden.";
+    };
+    readonly 'belege.keine_im_zeitraum': {
+        readonly text: "Keine Belege in diesem Zeitraum.";
+    };
+    readonly 'beleg.laden_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht geladen werden.";
+    };
+    readonly 'beleg.nicht_gefunden': {
+        readonly text: "Der Beleg wurde nicht gefunden.";
+    };
+    readonly 'storno.fehlgeschlagen': {
+        readonly text: "Das Storno ist fehlgeschlagen.";
+    };
+    readonly 'storno.grund_fehlt': {
+        readonly text: "Bitte einen Grund wählen.";
+    };
+    readonly 'storno.position_fehlt': {
+        readonly text: "Bitte mindestens eine Position wählen.";
+    };
+    readonly 'druck.fehlgeschlagen': {
+        readonly text: "Der Ausdruck ist fehlgeschlagen.";
+    };
+    readonly 'druck.nicht_moeglich': {
+        readonly text: "Druck nicht möglich: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'druck.testdruck_fehlgeschlagen': {
+        readonly text: "Der Testdruck ist fehlgeschlagen.";
+    };
+    readonly 'druck.testdruck_nicht_moeglich': {
+        readonly text: "Der Testdruck ist fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'druck.kein_drucker': {
+        readonly text: "Kein Bondrucker eingerichtet — in den Einstellungen unter Drucker & Lade.";
+    };
+    readonly 'druck.drucker_nicht_erreichbar': {
+        readonly text: "Drucker nicht erreichbar.";
+    };
+    readonly 'druck.job_abgelaufen': {
+        readonly text: "Drucker hat den Beleg nicht abgeholt (abgelaufen).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.kein_drucker_gefunden': {
+        readonly text: "Kein Drucker gefunden — ist er eingeschaltet und im selben Netz wie dieser Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.nur_chrome': {
+        readonly text: "{weg}-Druck geht nur in Chrome oder Edge (Windows, Mac, Android) — nicht in Safari und nicht am iPad.";
+        readonly platzhalter: readonly ["weg"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.kein_weg_drucker': {
+        readonly text: "Kein {weg}-Drucker verbunden — „{weg}-Drucker verbinden“ und den Drucker im Dialog wählen.";
+        readonly platzhalter: readonly ["weg"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'bluetooth.aus': {
+        readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'bluetooth.freigabe_fehlt': {
+        readonly text: "Bitte die Freigabe in den Geräte-Einstellungen erteilen.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'bluetooth.suche_fehlgeschlagen': {
+        readonly text: "Die Suche ist fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'connect.antwortet_nicht': {
+        readonly text: "Kasseneck Connect antwortet nicht — läuft das Programm auf diesem Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.code_abgelaufen': {
+        readonly text: "Der Kopplungs-Code ist abgelaufen — im Agent einen neuen erzeugen („kasseneck-connect pair“).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.zu_viele_versuche': {
+        readonly text: "Zu viele Fehlversuche — eine Minute warten und noch einmal versuchen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.drucker_antwortet_nicht': {
+        readonly text: "Der Drucker antwortet nicht — Strom, Netzwerk und IP prüfen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.nicht_gekoppelt': {
+        readonly text: "Diese Kasse ist mit Kasseneck Connect nicht gekoppelt — in den Einstellungen „Koppeln“ drücken.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.drucker_unbekannt': {
+        readonly text: "Diesen Drucker kennt Kasseneck Connect nicht (mehr) — bitte neu suchen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.ursprung_nicht_freigegeben': {
+        readonly text: "Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.nicht_installiert': {
+        readonly text: "Kasseneck Connect nicht gefunden — bitte installieren.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'einstellungen.laden_fehlgeschlagen': {
+        readonly text: "Die Einstellungen konnten nicht geladen werden.";
+    };
+    readonly 'einstellungen.speichern_fehlgeschlagen': {
+        readonly text: "Die Einstellung konnte nicht gespeichert werden.";
+    };
+    readonly 'einstellungen.noch_nicht_geladen': {
+        readonly text: "Noch nicht geladen — bitte kurz warten oder neu anmelden.";
+    };
+    readonly 'einstellungen.ip_ungueltig': {
+        readonly text: "Keine gültige IP-Adresse (z. B. 192.168.1.50).";
+    };
+    readonly 'entkopplung.fehlgeschlagen': {
+        readonly text: "Entkoppeln fehlgeschlagen.";
+    };
+    readonly 'logo.hochladen_fehlgeschlagen': {
+        readonly text: "Hochladen fehlgeschlagen.";
+    };
+    readonly 'logo.entfernen_fehlgeschlagen': {
+        readonly text: "Entfernen fehlgeschlagen.";
+    };
+    readonly 'app.nicht_im_browser': {
+        readonly text: "Die Kassen-App läuft nicht im Browser — dafür gibt es kasse.kasseneck.at.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'app.im_browser_oeffnen': {
+        readonly text: "Bitte im Browser öffnen: {ziel}";
+        readonly platzhalter: readonly ["ziel"];
+        readonly nur: readonly ["app"];
+    };
+};
+export type MeldungsSchluessel = keyof typeof MELDUNGEN_ROH;
+export declare const MELDUNGEN: Record<MeldungsSchluessel, Meldung>;
+/**
+ * In welcher Reihenfolge ein Fehler eingeordnet wird — auf beiden Seiten
+ * dieselbe. Die Arten:
+ *   api        — HTTP 200, `status:'error'`: der Satz des Backends, woertlich
+ *   klartext   — schon fuer den Bildschirm geschrieben: sein eigener Text
+ *   zeitablauf — die Frist lief ab, die Anfrage war draussen
+ *   netz       — keine Verbindung zustande gekommen oder abgerissen
+ *   unerwartet — der Server hat geantwortet, aber nicht wie zugesagt
+ *                (HTML statt JSON, 500, fehlende Huelle); `status` = HTTP-Code
+ *   sonst      — alles Uebrige ist technisch: der Ersatzsatz des Vorgangs
+ */
+export declare const FEHLERREGELN: readonly [{
+    readonly art: "api";
+    readonly verhalten: "server_text";
+}, {
+    readonly art: "klartext";
+    readonly verhalten: "eigener_text";
+}, {
+    readonly art: "zeitablauf";
+    readonly schluessel: "netz.zeitablauf";
+}, {
+    readonly art: "netz";
+    readonly schluessel: "netz.keine_verbindung";
+}, {
+    readonly art: "unerwartet";
+    readonly schluessel: "server.unerwartet";
+}, {
+    readonly art: "sonst";
+    readonly verhalten: "ersatz";
+}];
+export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
+export declare function meldung(schluessel: MeldungsSchluessel, werte?: Record<string, string | number>): string;
+/** Gilt der Satz auf dieser Seite? */
+export declare function meldungGiltFuer(schluessel: MeldungsSchluessel, seite: Seite): boolean;
+export {};