@kreiseck/kasseneck-api 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -4,6 +4,62 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.9.2
+
+### Sechzehn Saetze: einen Beleg weitergeben, und der Drucker-Wizard
+
+**Anlass:** Ein alter Beleg soll sich weitergeben lassen — Link kopieren,
+teilen, per E-Mail senden — und der Drucker richtet sich kuenftig ueber einen
+Wizard ein, der erst testet und bestaetigen laesst und dann speichert. Beides
+entsteht **gleichzeitig** in der Browser-Kasse und in der Kassen-App. Ohne
+diese Schluessel haetten beide Seiten dieselben sieben Lagen unabhaengig
+formuliert, und der Kassier haette zwei verschiedene Woerter fuer dieselbe
+Sache gelesen — genau das, wogegen es diesen Katalog gibt.
+
+- **Beleg weitergeben:** `beleg.link_kopiert`, `beleg.teilen_text`
+  (`betrieb`, `nummer`, `betrag`, `link`), `beleg.nicht_teilbar`,
+  `beleg.test_hinweis_teilen`.
+- **Per E-Mail senden:** `beleg.mail_gesendet` (`an`) und die vier Ausgaenge
+  `beleg.mail_adresse_ungueltig`, `beleg.mail_zu_oft`,
+  `beleg.mail_fehlgeschlagen`, `beleg.mail_nicht_gefunden`.
+- **Drucker-Wizard** (beide Kassen, deshalb ohne `nur`):
+  `druck.wizard_verbinden` (`name`), `druck.wizard_testdruck_frage`,
+  `druck.wizard_qr_frage`, `druck.wizard_qr_keiner_hinweis`,
+  `druck.wizard_nichts_gekommen`, `druck.wizard_gespeichert` (`name`),
+  `druck.wizard_abgebrochen`.
+
+**Neu: `BELEG_MAIL_FEHLER` und `belegMailFehler(code)`** — die Zuordnung vom
+`code` des Backends (`adresse_ungueltig`, `zu_oft`, `versand_fehlgeschlagen`,
+`beleg_nicht_gefunden`) auf den Satz. Grund: die vier Ausgaenge verlangen vom
+Kassier vier verschiedene Handlungen, und beide Kassen sollen am **Code**
+entscheiden statt an einer Formulierung, die sich im Backend jederzeit aendern
+darf. Ein unbekannter Code faellt auf `beleg.mail_fehlgeschlagen` zurueck — ein
+leerer Schirm waere schlimmer als ein zu allgemeiner Satz. Die Zuordnung steht
+als `belegMailFehler` mit in `fixtures/kasse-texte.json`, weil die App den
+Katalog aus dem Tarball liest und das Web die Quelle direkt importiert.
+
+Bewusst ein Objekt und **keine** Liste in Grossschrift: der
+Oberflaechen-Vertrag liest jede exportierte Liste als Enum der
+Kasseneinstellungen ein, und der Dart-Zwilling schickt deren Werte durch
+`KasseSettings.aus`. Fehlercodes haetten dort nichts verloren.
+
+**Abweichung von der Vorlage, bewusst:** `beleg.mail_nicht_gefunden` sagt
+„Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden." und
+nicht denselben Satz wie das schon vorhandene `beleg.nicht_gefunden`. Dort
+scheitert das Oeffnen, hier das Senden; der Kassier steht vor einem Adressfeld
+und muss lesen, dass nichts hinausgegangen ist. Ein Satz zweimal im Katalog
+faellt ohnehin schon seit 0.9.1 im Test auf.
+
+**Neue abgeleitete Pruefungen:** kein Satz zum Weitergeben eines Belegs ist an
+eine Seite gebunden; der Teilen-Text traegt den Link, und zwar am Schluss;
+jeder platzhalterlose `beleg.mail_`-Satz haengt an genau einem Backend-Code (und
+kein Code an zweien); der einzige `beleg.mail_`-Satz mit Platzhalter ist der
+ueber das Gelingen; jeder Satz des Wizards gilt auf beiden Seiten.
+
+`FEHLERREGELN` bleibt unveraendert: die Codes sind die Verfeinerung **eines**
+Aufrufs (`sendReceiptEmail`), keine neue Art, einen Transportfehler
+einzuordnen.
+
 ## 0.9.1
 
 ### Elf Saetze fuer die vier Ausgaenge einer Kartenzahlung und das Terminal-Protokoll

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

@@ -10,4 +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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, } 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.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = void 0;
+exports.belegMailFehler = exports.BELEG_MAIL_FEHLER = 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
@@ -74,3 +74,5 @@ Object.defineProperty(exports, "MELDUNGEN", { enumerable: true, get: function ()
 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; } });
+Object.defineProperty(exports, "BELEG_MAIL_FEHLER", { enumerable: true, get: function () { return texte_js_1.BELEG_MAIL_FEHLER; } });
+Object.defineProperty(exports, "belegMailFehler", { enumerable: true, get: function () { return texte_js_1.belegMailFehler; } });

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

@@ -221,6 +221,35 @@ declare const MELDUNGEN_ROH: {
     readonly 'storno.position_fehlt': {
         readonly text: "Bitte mindestens eine Position wählen.";
     };
+    readonly 'beleg.link_kopiert': {
+        readonly text: "Der Link zum Beleg liegt in der Zwischenablage.";
+    };
+    readonly 'beleg.teilen_text': {
+        readonly text: "Beleg {nummer} von {betrieb} über {betrag}: {link}";
+        readonly platzhalter: readonly ["betrieb", "nummer", "betrag", "link"];
+    };
+    readonly 'beleg.nicht_teilbar': {
+        readonly text: "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.";
+    };
+    readonly 'beleg.test_hinweis_teilen': {
+        readonly text: "Test-Umgebung — der Beleg ist steuerlich nicht gültig.";
+    };
+    readonly 'beleg.mail_gesendet': {
+        readonly text: "Der Beleg wurde an {an} gesendet.";
+        readonly platzhalter: readonly ["an"];
+    };
+    readonly 'beleg.mail_adresse_ungueltig': {
+        readonly text: "Diese E-Mail-Adresse ist nicht gültig.";
+    };
+    readonly 'beleg.mail_zu_oft': {
+        readonly text: "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.";
+    };
+    readonly 'beleg.mail_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.";
+    };
+    readonly 'beleg.mail_nicht_gefunden': {
+        readonly text: "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.";
+    };
     readonly 'druck.fehlgeschlagen': {
         readonly text: "Der Ausdruck ist fehlgeschlagen.";
     };
@@ -259,6 +288,29 @@ declare const MELDUNGEN_ROH: {
         readonly platzhalter: readonly ["weg"];
         readonly nur: readonly ["web"];
     };
+    readonly 'druck.wizard_verbinden': {
+        readonly text: "Verbinde mit {name} …";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_testdruck_frage': {
+        readonly text: "Ist der Testdruck gekommen?";
+    };
+    readonly 'druck.wizard_qr_frage': {
+        readonly text: "Welcher QR-Code ist sauber gedruckt?";
+    };
+    readonly 'druck.wizard_qr_keiner_hinweis': {
+        readonly text: "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.";
+    };
+    readonly 'druck.wizard_nichts_gekommen': {
+        readonly text: "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?";
+    };
+    readonly 'druck.wizard_gespeichert': {
+        readonly text: "{name} ist eingerichtet.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_abgebrochen': {
+        readonly text: "Nichts gespeichert.";
+    };
     readonly 'bluetooth.aus': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
         readonly nur: readonly ["app"];
@@ -368,6 +420,37 @@ export declare const FEHLERREGELN: readonly [{
     readonly verhalten: "ersatz";
 }];
 export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export declare const BELEG_MAIL_FEHLER: {
+    readonly adresse_ungueltig: "beleg.mail_adresse_ungueltig";
+    readonly zu_oft: "beleg.mail_zu_oft";
+    readonly versand_fehlgeschlagen: "beleg.mail_fehlgeschlagen";
+    readonly beleg_nicht_gefunden: "beleg.mail_nicht_gefunden";
+};
+export type BelegMailFehlercode = keyof typeof BELEG_MAIL_FEHLER;
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export declare function belegMailFehler(code: string | undefined | null): MeldungsSchluessel;
 /** 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? */

package/dist/cjs/kasse/texte.js

@@ -16,7 +16,8 @@
  * auf einer Plattform vorkommen kann.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FEHLERREGELN = exports.MELDUNGEN = void 0;
+exports.BELEG_MAIL_FEHLER = exports.FEHLERREGELN = exports.MELDUNGEN = void 0;
+exports.belegMailFehler = belegMailFehler;
 exports.meldung = meldung;
 exports.meldungGiltFuer = meldungGiltFuer;
 const MELDUNGEN_ROH = {
@@ -95,6 +96,30 @@ const MELDUNGEN_ROH = {
     '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.' },
+    // --- Beleg weitergeben: Link, Teilen, E-Mail -----------------------------
+    // Kopieren, Teilen und Senden fuehren zu demselben Ziel: der oeffentlichen
+    // Belegseite (beleg.kasseneck.at/<fullReceiptId>). Kein Satz davon ist
+    // plattformgebunden — nur die Huelle unterscheidet sich, nicht das Wort.
+    'beleg.link_kopiert': { text: 'Der Link zum Beleg liegt in der Zwischenablage.' },
+    // Der Text, der beim Teilen mitgeht. Der Link steht am Schluss, damit ihn
+    // jede Huelle (SMS, Messenger, Mail) bis zum Ende als Link erkennt und nicht
+    // mitten im Satz abbricht.
+    'beleg.teilen_text': { text: 'Beleg {nummer} von {betrieb} über {betrag}: {link}', platzhalter: ['betrieb', 'nummer', 'betrag', 'link'] },
+    // Belege aus dem Altbestand tragen keine `fullReceiptId`; ohne sie gibt es
+    // keine Belegseite. Der Satz nennt den Grund, sonst sucht der Kassier den
+    // Fehler bei sich und versucht es ein zweites Mal.
+    'beleg.nicht_teilbar': { text: 'Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.' },
+    // Ein Testbeleg hat eine Belegseite, ist aber steuerlich nichts wert. Wer
+    // den Link weitergibt, muss das vorher lesen, nicht hinterher.
+    'beleg.test_hinweis_teilen': { text: 'Test-Umgebung — der Beleg ist steuerlich nicht gültig.' },
+    'beleg.mail_gesendet': { text: 'Der Beleg wurde an {an} gesendet.', platzhalter: ['an'] },
+    'beleg.mail_adresse_ungueltig': { text: 'Diese E-Mail-Adresse ist nicht gültig.' },
+    'beleg.mail_zu_oft': { text: 'Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.' },
+    'beleg.mail_fehlgeschlagen': { text: 'Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.' },
+    // Bewusst nicht derselbe Satz wie `beleg.nicht_gefunden`: dort scheitert das
+    // Oeffnen, hier das Senden. Der Kassier steht vor einem Adressfeld und muss
+    // lesen, dass nichts hinausgegangen ist.
+    'beleg.mail_nicht_gefunden': { text: 'Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.' },
     // --- Druck ---------------------------------------------------------------
     'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
     'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
@@ -106,6 +131,22 @@ const MELDUNGEN_ROH = {
     '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'] },
+    // Der Drucker-Wizard: suchen, verbinden, Testdruck, QR-Probe, erst dann
+    // speichern. Derselbe Ablauf in beiden Kassen — deshalb hat kein Satz ein
+    // `nur`, obwohl der Weg zum Drucker verschieden ist (Bluetooth in der App,
+    // Web Bluetooth im Browser). Was der Chef liest, ist beidesmal dasselbe.
+    'druck.wizard_verbinden': { text: 'Verbinde mit {name} …', platzhalter: ['name'] },
+    'druck.wizard_testdruck_frage': { text: 'Ist der Testdruck gekommen?' },
+    'druck.wizard_qr_frage': { text: 'Welcher QR-Code ist sauber gedruckt?' },
+    // Kein Modus druckt einen lesbaren QR-Code: gespeichert wird trotzdem (mit
+    // Raster als Vorgabe), aber der Chef muss wissen, dass der QR-Code dann vom
+    // Bildschirm gelesen werden muss — nach RKSV gehoert er an den Beleg.
+    'druck.wizard_qr_keiner_hinweis': { text: 'Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.' },
+    'druck.wizard_nichts_gekommen': { text: 'Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?' },
+    'druck.wizard_gespeichert': { text: '{name} ist eingerichtet.', platzhalter: ['name'] },
+    // Abbrechen an jeder Stelle: nichts gespeichert. Der Satz sagt genau das,
+    // damit niemand einen halb eingerichteten Drucker vermutet.
+    'druck.wizard_abgebrochen': { text: 'Nichts gespeichert.' },
     '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'] },
@@ -153,6 +194,39 @@ exports.FEHLERREGELN = [
     { art: 'unerwartet', schluessel: 'server.unerwartet' },
     { art: 'sonst', verhalten: 'ersatz' },
 ];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+exports.BELEG_MAIL_FEHLER = {
+    adresse_ungueltig: 'beleg.mail_adresse_ungueltig',
+    zu_oft: 'beleg.mail_zu_oft',
+    versand_fehlgeschlagen: 'beleg.mail_fehlgeschlagen',
+    beleg_nicht_gefunden: 'beleg.mail_nicht_gefunden',
+};
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+function belegMailFehler(code) {
+    const fehler = exports.BELEG_MAIL_FEHLER;
+    return (code !== undefined && code !== null && fehler[code]) || 'beleg.mail_fehlgeschlagen';
+}
 /** 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];

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

@@ -10,4 +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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, } from './texte.js';

package/dist/esm/kasse/index.js

@@ -15,4 +15,4 @@ 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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, } from './texte.js';

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

@@ -221,6 +221,35 @@ declare const MELDUNGEN_ROH: {
     readonly 'storno.position_fehlt': {
         readonly text: "Bitte mindestens eine Position wählen.";
     };
+    readonly 'beleg.link_kopiert': {
+        readonly text: "Der Link zum Beleg liegt in der Zwischenablage.";
+    };
+    readonly 'beleg.teilen_text': {
+        readonly text: "Beleg {nummer} von {betrieb} über {betrag}: {link}";
+        readonly platzhalter: readonly ["betrieb", "nummer", "betrag", "link"];
+    };
+    readonly 'beleg.nicht_teilbar': {
+        readonly text: "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.";
+    };
+    readonly 'beleg.test_hinweis_teilen': {
+        readonly text: "Test-Umgebung — der Beleg ist steuerlich nicht gültig.";
+    };
+    readonly 'beleg.mail_gesendet': {
+        readonly text: "Der Beleg wurde an {an} gesendet.";
+        readonly platzhalter: readonly ["an"];
+    };
+    readonly 'beleg.mail_adresse_ungueltig': {
+        readonly text: "Diese E-Mail-Adresse ist nicht gültig.";
+    };
+    readonly 'beleg.mail_zu_oft': {
+        readonly text: "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.";
+    };
+    readonly 'beleg.mail_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.";
+    };
+    readonly 'beleg.mail_nicht_gefunden': {
+        readonly text: "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.";
+    };
     readonly 'druck.fehlgeschlagen': {
         readonly text: "Der Ausdruck ist fehlgeschlagen.";
     };
@@ -259,6 +288,29 @@ declare const MELDUNGEN_ROH: {
         readonly platzhalter: readonly ["weg"];
         readonly nur: readonly ["web"];
     };
+    readonly 'druck.wizard_verbinden': {
+        readonly text: "Verbinde mit {name} …";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_testdruck_frage': {
+        readonly text: "Ist der Testdruck gekommen?";
+    };
+    readonly 'druck.wizard_qr_frage': {
+        readonly text: "Welcher QR-Code ist sauber gedruckt?";
+    };
+    readonly 'druck.wizard_qr_keiner_hinweis': {
+        readonly text: "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.";
+    };
+    readonly 'druck.wizard_nichts_gekommen': {
+        readonly text: "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?";
+    };
+    readonly 'druck.wizard_gespeichert': {
+        readonly text: "{name} ist eingerichtet.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_abgebrochen': {
+        readonly text: "Nichts gespeichert.";
+    };
     readonly 'bluetooth.aus': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
         readonly nur: readonly ["app"];
@@ -368,6 +420,37 @@ export declare const FEHLERREGELN: readonly [{
     readonly verhalten: "ersatz";
 }];
 export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export declare const BELEG_MAIL_FEHLER: {
+    readonly adresse_ungueltig: "beleg.mail_adresse_ungueltig";
+    readonly zu_oft: "beleg.mail_zu_oft";
+    readonly versand_fehlgeschlagen: "beleg.mail_fehlgeschlagen";
+    readonly beleg_nicht_gefunden: "beleg.mail_nicht_gefunden";
+};
+export type BelegMailFehlercode = keyof typeof BELEG_MAIL_FEHLER;
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export declare function belegMailFehler(code: string | undefined | null): MeldungsSchluessel;
 /** 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? */

package/dist/esm/kasse/texte.js

@@ -90,6 +90,30 @@ const MELDUNGEN_ROH = {
     '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.' },
+    // --- Beleg weitergeben: Link, Teilen, E-Mail -----------------------------
+    // Kopieren, Teilen und Senden fuehren zu demselben Ziel: der oeffentlichen
+    // Belegseite (beleg.kasseneck.at/<fullReceiptId>). Kein Satz davon ist
+    // plattformgebunden — nur die Huelle unterscheidet sich, nicht das Wort.
+    'beleg.link_kopiert': { text: 'Der Link zum Beleg liegt in der Zwischenablage.' },
+    // Der Text, der beim Teilen mitgeht. Der Link steht am Schluss, damit ihn
+    // jede Huelle (SMS, Messenger, Mail) bis zum Ende als Link erkennt und nicht
+    // mitten im Satz abbricht.
+    'beleg.teilen_text': { text: 'Beleg {nummer} von {betrieb} über {betrag}: {link}', platzhalter: ['betrieb', 'nummer', 'betrag', 'link'] },
+    // Belege aus dem Altbestand tragen keine `fullReceiptId`; ohne sie gibt es
+    // keine Belegseite. Der Satz nennt den Grund, sonst sucht der Kassier den
+    // Fehler bei sich und versucht es ein zweites Mal.
+    'beleg.nicht_teilbar': { text: 'Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.' },
+    // Ein Testbeleg hat eine Belegseite, ist aber steuerlich nichts wert. Wer
+    // den Link weitergibt, muss das vorher lesen, nicht hinterher.
+    'beleg.test_hinweis_teilen': { text: 'Test-Umgebung — der Beleg ist steuerlich nicht gültig.' },
+    'beleg.mail_gesendet': { text: 'Der Beleg wurde an {an} gesendet.', platzhalter: ['an'] },
+    'beleg.mail_adresse_ungueltig': { text: 'Diese E-Mail-Adresse ist nicht gültig.' },
+    'beleg.mail_zu_oft': { text: 'Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.' },
+    'beleg.mail_fehlgeschlagen': { text: 'Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.' },
+    // Bewusst nicht derselbe Satz wie `beleg.nicht_gefunden`: dort scheitert das
+    // Oeffnen, hier das Senden. Der Kassier steht vor einem Adressfeld und muss
+    // lesen, dass nichts hinausgegangen ist.
+    'beleg.mail_nicht_gefunden': { text: 'Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.' },
     // --- Druck ---------------------------------------------------------------
     'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
     'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
@@ -101,6 +125,22 @@ const MELDUNGEN_ROH = {
     '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'] },
+    // Der Drucker-Wizard: suchen, verbinden, Testdruck, QR-Probe, erst dann
+    // speichern. Derselbe Ablauf in beiden Kassen — deshalb hat kein Satz ein
+    // `nur`, obwohl der Weg zum Drucker verschieden ist (Bluetooth in der App,
+    // Web Bluetooth im Browser). Was der Chef liest, ist beidesmal dasselbe.
+    'druck.wizard_verbinden': { text: 'Verbinde mit {name} …', platzhalter: ['name'] },
+    'druck.wizard_testdruck_frage': { text: 'Ist der Testdruck gekommen?' },
+    'druck.wizard_qr_frage': { text: 'Welcher QR-Code ist sauber gedruckt?' },
+    // Kein Modus druckt einen lesbaren QR-Code: gespeichert wird trotzdem (mit
+    // Raster als Vorgabe), aber der Chef muss wissen, dass der QR-Code dann vom
+    // Bildschirm gelesen werden muss — nach RKSV gehoert er an den Beleg.
+    'druck.wizard_qr_keiner_hinweis': { text: 'Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.' },
+    'druck.wizard_nichts_gekommen': { text: 'Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?' },
+    'druck.wizard_gespeichert': { text: '{name} ist eingerichtet.', platzhalter: ['name'] },
+    // Abbrechen an jeder Stelle: nichts gespeichert. Der Satz sagt genau das,
+    // damit niemand einen halb eingerichteten Drucker vermutet.
+    'druck.wizard_abgebrochen': { text: 'Nichts gespeichert.' },
     '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'] },
@@ -148,6 +188,39 @@ export const FEHLERREGELN = [
     { art: 'unerwartet', schluessel: 'server.unerwartet' },
     { art: 'sonst', verhalten: 'ersatz' },
 ];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export const BELEG_MAIL_FEHLER = {
+    adresse_ungueltig: 'beleg.mail_adresse_ungueltig',
+    zu_oft: 'beleg.mail_zu_oft',
+    versand_fehlgeschlagen: 'beleg.mail_fehlgeschlagen',
+    beleg_nicht_gefunden: 'beleg.mail_nicht_gefunden',
+};
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export function belegMailFehler(code) {
+    const fehler = BELEG_MAIL_FEHLER;
+    return (code !== undefined && code !== null && fehler[code]) || 'beleg.mail_fehlgeschlagen';
+}
 /** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
 export function meldung(schluessel, werte = {}) {
     const eintrag = MELDUNGEN[schluessel];

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.2",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.2",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."
@@ -255,6 +255,42 @@
     "storno.position_fehlt": {
       "text": "Bitte mindestens eine Position wählen."
     },
+    "beleg.link_kopiert": {
+      "text": "Der Link zum Beleg liegt in der Zwischenablage."
+    },
+    "beleg.teilen_text": {
+      "text": "Beleg {nummer} von {betrieb} über {betrag}: {link}",
+      "platzhalter": [
+        "betrieb",
+        "nummer",
+        "betrag",
+        "link"
+      ]
+    },
+    "beleg.nicht_teilbar": {
+      "text": "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse."
+    },
+    "beleg.test_hinweis_teilen": {
+      "text": "Test-Umgebung — der Beleg ist steuerlich nicht gültig."
+    },
+    "beleg.mail_gesendet": {
+      "text": "Der Beleg wurde an {an} gesendet.",
+      "platzhalter": [
+        "an"
+      ]
+    },
+    "beleg.mail_adresse_ungueltig": {
+      "text": "Diese E-Mail-Adresse ist nicht gültig."
+    },
+    "beleg.mail_zu_oft": {
+      "text": "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal."
+    },
+    "beleg.mail_fehlgeschlagen": {
+      "text": "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen."
+    },
+    "beleg.mail_nicht_gefunden": {
+      "text": "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden."
+    },
     "druck.fehlgeschlagen": {
       "text": "Der Ausdruck ist fehlgeschlagen."
     },
@@ -309,6 +345,33 @@
         "web"
       ]
     },
+    "druck.wizard_verbinden": {
+      "text": "Verbinde mit {name} …",
+      "platzhalter": [
+        "name"
+      ]
+    },
+    "druck.wizard_testdruck_frage": {
+      "text": "Ist der Testdruck gekommen?"
+    },
+    "druck.wizard_qr_frage": {
+      "text": "Welcher QR-Code ist sauber gedruckt?"
+    },
+    "druck.wizard_qr_keiner_hinweis": {
+      "text": "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm."
+    },
+    "druck.wizard_nichts_gekommen": {
+      "text": "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?"
+    },
+    "druck.wizard_gespeichert": {
+      "text": "{name} ist eingerichtet.",
+      "platzhalter": [
+        "name"
+      ]
+    },
+    "druck.wizard_abgebrochen": {
+      "text": "Nichts gespeichert."
+    },
     "bluetooth.aus": {
       "text": "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.",
       "nur": [
@@ -440,5 +503,11 @@
       "art": "sonst",
       "verhalten": "ersatz"
     }
-  ]
+  ],
+  "belegMailFehler": {
+    "adresse_ungueltig": "beleg.mail_adresse_ungueltig",
+    "zu_oft": "beleg.mail_zu_oft",
+    "versand_fehlgeschlagen": "beleg.mail_fehlgeschlagen",
+    "beleg_nicht_gefunden": "beleg.mail_nicht_gefunden"
+  }
 }

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.2",
   "aufrufe": [
     "activateCashregister",
     "cancelReceipt",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "JavaScript-Zwilling von kasseneck_api (Flutter) fuer das Kasseneck-Backend",
   "license": "Apache-2.0",
   "author": "Kreiseck",