@kreiseck/kasseneck-api 0.7.2 → 0.8.0

package/dist/cjs/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/cjs/kasse/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.mengeErlaubt = exports.mengenVorgabe = exports.mengenregelFuerEinheit = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.TASTEN_AKTIONEN = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.KASSE_TASTEN_AKTIONEN = exports.KARTENANBIETER = void 0;
-exports.listMyTipRecipients = void 0;
+exports.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
@@ -68,3 +68,9 @@ Object.defineProperty(exports, "createPrintJob", { enumerable: true, get: functi
 Object.defineProperty(exports, "getPrintJob", { enumerable: true, get: function () { return drucker_js_1.getPrintJob; } });
 var trinkgeld_js_1 = require("./trinkgeld.js");
 Object.defineProperty(exports, "listMyTipRecipients", { enumerable: true, get: function () { return trinkgeld_js_1.listMyTipRecipients; } });
+// Was die Kasse selbst sagt — ein Katalog fuer Browser-Kasse und App.
+var texte_js_1 = require("./texte.js");
+Object.defineProperty(exports, "MELDUNGEN", { enumerable: true, get: function () { return texte_js_1.MELDUNGEN; } });
+Object.defineProperty(exports, "FEHLERREGELN", { enumerable: true, get: function () { return texte_js_1.FEHLERREGELN; } });
+Object.defineProperty(exports, "meldung", { enumerable: true, get: function () { return texte_js_1.meldung; } });
+Object.defineProperty(exports, "meldungGiltFuer", { enumerable: true, get: function () { return texte_js_1.meldungGiltFuer; } });

package/dist/cjs/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 {};

package/dist/cjs/kasse/texte.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEHLERREGELN = exports.MELDUNGEN = void 0;
+exports.meldung = meldung;
+exports.meldungGiltFuer = meldungGiltFuer;
+const MELDUNGEN_ROH = {
+    // --- Transport -----------------------------------------------------------
+    'netz.keine_verbindung': { text: 'Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'netz.zeitablauf': { text: 'Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'server.unerwartet': { text: 'Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.', platzhalter: ['status'] },
+    // --- Kopplung ------------------------------------------------------------
+    'kopplung.code_fehlt': { text: 'Bitte den Kopplungs-Code eingeben.' },
+    'kopplung.fehlgeschlagen': { text: 'Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'kopplung.unvollstaendig': { text: 'Die Kopplung ist unvollständig zurückgekommen. Bitte im Panel einen neuen Code erzeugen und noch einmal versuchen.' },
+    'geraet.browser_speicher': { text: 'Dieses Gerät konnte nicht gespeichert werden — der Browser-Speicher steht nicht zur Verfügung. Bitte den privaten Modus verlassen.', nur: ['web'] },
+    // --- Anmeldung und Sitzung -----------------------------------------------
+    'anmeldung.pin_fehlt': { text: 'Bitte die PIN eingeben.' },
+    'anmeldung.fehlgeschlagen': { text: 'Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'anmeldung.nicht_abgeschlossen': { text: 'Die Anmeldung konnte nicht abgeschlossen werden. Bitte erneut versuchen.' },
+    'anmeldung.wird_abgeschlossen': { text: 'Anmeldung wird gerade abgeschlossen — bitte gleich noch einmal drücken.' },
+    'sitzung.abgelaufen': { text: 'Die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.abgelaufen_ohne_netz': { text: 'Keine Verbindung zum Server — die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.keine': { text: 'Keine Sitzung.' },
+    'rechte.nicht_aenderbar': { text: 'Das darfst du nicht ändern — das Recht dafür vergibt der Inhaber im Panel.' },
+    // --- Verkauf und Positionen ----------------------------------------------
+    'kasse.laden_fehlgeschlagen': { text: 'Die Kasse konnte nicht geladen werden.' },
+    'artikel.laden_fehlgeschlagen': { text: 'Die Artikel konnten nicht geladen werden.' },
+    'artikel.keine_freigegeben': { text: 'Keine Artikel an dieser Kasse. Im Panel unter „Kacheln & Gruppen“ freischalten.' },
+    'artikel.keine_gefunden': { text: 'Keine Artikel gefunden.' },
+    'artikel.steuersatz_unbekannt': { text: '„{name}“ hat einen Steuersatz, den die Kasse nicht kennt.', platzhalter: ['name'] },
+    'position.betrag_fehlt': { text: 'Bitte einen Betrag eingeben.' },
+    'position.bezeichnung_fehlt': { text: 'Bitte eine Bezeichnung eingeben — sie steht am Beleg.' },
+    'rabatt.prozent_ungueltig': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
+    // --- Abschluss -----------------------------------------------------------
+    'abschluss.fehlgeschlagen': { text: 'Der Abschluss ist fehlgeschlagen.' },
+    'abschluss.unklar': { 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.' },
+    'abschluss.nullbeleg_fehlgeschlagen': { text: 'Der Nullbeleg konnte nicht erstellt werden.' },
+    'abschluss.signatur_ausgefallen': { text: 'Die Signatureinheit hat nicht geantwortet. Der Beleg ist gültig und trägt den Vermerk „Sicherheitseinrichtung ausgefallen“.' },
+    // --- Kartenzahlung -------------------------------------------------------
+    'kartenzahlung.nicht_moeglich': { text: 'Kartenzahlung nicht möglich.' },
+    'kartenzahlung.nicht_zustande': { text: 'Die Kartenzahlung ist nicht zustande gekommen.' },
+    'kartenzahlung.nicht_gestartet': { text: 'Kartenzahlung nicht gestartet: {grund}', platzhalter: ['grund'] },
+    'kartenzahlung.unklar': { 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.' },
+    // Die Kennung ist der einzige Anker, um die Zahlung am Terminal-Beleg wiederzufinden — liegt sie vor, gilt dieser Satz statt kartenzahlung.unklar.
+    'kartenzahlung.unklar_mit_kennung': { 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}.', platzhalter: ['kennung'] },
+    'kartenzahlung.connect_nicht_verbunden': { text: 'Kartenzahlung nicht möglich: Kasseneck Connect ist nicht verbunden — Einstellungen → Kasseneck Connect.', nur: ['web'] },
+    'terminal.keines_gefunden': { text: 'Kein Hobex-Terminal gefunden — ist es eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'terminal.nicht_bereit': { text: 'Terminal antwortet, ist aber nicht betriebsbereit: {antwort} — TID prüfen.', platzhalter: ['antwort'], nur: ['web'] },
+    'gptom.app_fehlt': { text: 'Die GP-Tom-App ist auf diesem Gerät nicht da.', nur: ['app'] },
+    'gptom.suche_fehlgeschlagen': { text: 'GP Tom: Suche nach der App fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_fehlgeschlagen': { text: 'GP Tom: Zahlung fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.terminal_antwortet_nicht': { text: 'Das Terminal hat nicht geantwortet: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_nicht_abgeschlossen': { text: 'Die Zahlung wurde nicht abgeschlossen ({code}).', platzhalter: ['code'], nur: ['app'] },
+    // --- Belege und Storno ---------------------------------------------------
+    'belege.laden_fehlgeschlagen': { text: 'Die Belege konnten nicht geladen werden.' },
+    'belege.keine_im_zeitraum': { text: 'Keine Belege in diesem Zeitraum.' },
+    'beleg.laden_fehlgeschlagen': { text: 'Der Beleg konnte nicht geladen werden.' },
+    'beleg.nicht_gefunden': { text: 'Der Beleg wurde nicht gefunden.' },
+    'storno.fehlgeschlagen': { text: 'Das Storno ist fehlgeschlagen.' },
+    'storno.grund_fehlt': { text: 'Bitte einen Grund wählen.' },
+    'storno.position_fehlt': { text: 'Bitte mindestens eine Position wählen.' },
+    // --- Druck ---------------------------------------------------------------
+    'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
+    'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
+    'druck.testdruck_fehlgeschlagen': { text: 'Der Testdruck ist fehlgeschlagen.' },
+    'druck.testdruck_nicht_moeglich': { text: 'Der Testdruck ist fehlgeschlagen: {grund}', platzhalter: ['grund'] },
+    'druck.kein_drucker': { text: 'Kein Bondrucker eingerichtet — in den Einstellungen unter Drucker & Lade.' },
+    'druck.drucker_nicht_erreichbar': { text: 'Drucker nicht erreichbar.' },
+    'druck.job_abgelaufen': { text: 'Drucker hat den Beleg nicht abgeholt (abgelaufen).', nur: ['web'] },
+    'druck.kein_drucker_gefunden': { text: 'Kein Drucker gefunden — ist er eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'druck.nur_chrome': { text: '{weg}-Druck geht nur in Chrome oder Edge (Windows, Mac, Android) — nicht in Safari und nicht am iPad.', platzhalter: ['weg'], nur: ['web'] },
+    'druck.kein_weg_drucker': { text: 'Kein {weg}-Drucker verbunden — „{weg}-Drucker verbinden“ und den Drucker im Dialog wählen.', platzhalter: ['weg'], nur: ['web'] },
+    'bluetooth.aus': { text: 'Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.', nur: ['app'] },
+    'bluetooth.freigabe_fehlt': { text: 'Bitte die Freigabe in den Geräte-Einstellungen erteilen.', nur: ['app'] },
+    'bluetooth.suche_fehlgeschlagen': { text: 'Die Suche ist fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    // --- Kasseneck Connect (nur Browser) -------------------------------------
+    'connect.antwortet_nicht': { text: 'Kasseneck Connect antwortet nicht — läuft das Programm auf diesem Rechner?', nur: ['web'] },
+    'connect.code_abgelaufen': { text: 'Der Kopplungs-Code ist abgelaufen — im Agent einen neuen erzeugen („kasseneck-connect pair“).', nur: ['web'] },
+    'connect.zu_viele_versuche': { text: 'Zu viele Fehlversuche — eine Minute warten und noch einmal versuchen.', nur: ['web'] },
+    'connect.drucker_antwortet_nicht': { text: 'Der Drucker antwortet nicht — Strom, Netzwerk und IP prüfen.', nur: ['web'] },
+    'connect.nicht_gekoppelt': { text: 'Diese Kasse ist mit Kasseneck Connect nicht gekoppelt — in den Einstellungen „Koppeln“ drücken.', nur: ['web'] },
+    'connect.drucker_unbekannt': { text: 'Diesen Drucker kennt Kasseneck Connect nicht (mehr) — bitte neu suchen.', nur: ['web'] },
+    'connect.ursprung_nicht_freigegeben': { text: 'Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).', nur: ['web'] },
+    'connect.nicht_installiert': { text: 'Kasseneck Connect nicht gefunden — bitte installieren.', nur: ['web'] },
+    // --- Einstellungen -------------------------------------------------------
+    'einstellungen.laden_fehlgeschlagen': { text: 'Die Einstellungen konnten nicht geladen werden.' },
+    'einstellungen.speichern_fehlgeschlagen': { text: 'Die Einstellung konnte nicht gespeichert werden.' },
+    'einstellungen.noch_nicht_geladen': { text: 'Noch nicht geladen — bitte kurz warten oder neu anmelden.' },
+    'einstellungen.ip_ungueltig': { text: 'Keine gültige IP-Adresse (z. B. 192.168.1.50).' },
+    'entkopplung.fehlgeschlagen': { text: 'Entkoppeln fehlgeschlagen.' },
+    'logo.hochladen_fehlgeschlagen': { text: 'Hochladen fehlgeschlagen.' },
+    'logo.entfernen_fehlgeschlagen': { text: 'Entfernen fehlgeschlagen.' },
+    // --- Nur App -------------------------------------------------------------
+    'app.nicht_im_browser': { text: 'Die Kassen-App läuft nicht im Browser — dafür gibt es kasse.kasseneck.at.', nur: ['app'] },
+    'app.im_browser_oeffnen': { text: 'Bitte im Browser öffnen: {ziel}', platzhalter: ['ziel'], nur: ['app'] },
+};
+// Auf den gemeinsamen Typ gebracht: `Object.entries(MELDUNGEN)` liefert sonst
+// pro Schluessel den engsten Literaltyp, und `platzhalter`/`nur` waeren nur
+// auf manchen Zweigen der Vereinigung vorhanden.
+exports.MELDUNGEN = MELDUNGEN_ROH;
+/**
+ * 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
+ */
+exports.FEHLERREGELN = [
+    { art: 'api', verhalten: 'server_text' },
+    { art: 'klartext', verhalten: 'eigener_text' },
+    { art: 'zeitablauf', schluessel: 'netz.zeitablauf' },
+    { art: 'netz', schluessel: 'netz.keine_verbindung' },
+    { art: 'unerwartet', schluessel: 'server.unerwartet' },
+    { art: 'sonst', verhalten: 'ersatz' },
+];
+/** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
+function meldung(schluessel, werte = {}) {
+    const eintrag = exports.MELDUNGEN[schluessel];
+    return eintrag.text.replace(/\{([a-z]+)\}/g, (_, name) => {
+        const wert = werte[name];
+        if (wert === undefined)
+            throw new Error(`meldung(${schluessel}): Platzhalter {${name}} ohne Wert`);
+        return String(wert);
+    });
+}
+/** Gilt der Satz auf dieser Seite? */
+function meldungGiltFuer(schluessel, seite) {
+    const eintrag = exports.MELDUNGEN[schluessel];
+    return eintrag.nur === undefined || eintrag.nur.includes(seite);
+}

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';