@kreiseck/kasseneck-api 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -4,6 +4,97 @@ 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.14.0
+
+### Das Beleg-Blatt: ein Beleg, der überall gleich aussieht
+
+**Anlass:** Derselbe Beleg sah in der App, am Bon, in der Web-Kasse, im Panel
+und im PDF verschieden aus. Das Raster war als einzige Wahrheit gedacht, aber
+jeder Zeichner setzte Rahmen, Logo und QR selbst: das Panel stellte das Logo
+über den Testkassen-Rahmen, das PDF legte es darauf, die App zeigte keins, der
+Bon druckte Warnungen invers und doppelt hoch.
+
+- `renderReceiptGrid` gibt Aufdrucke als drei Rasterzeilen aus (`====`, Text,
+  `====`). ESC/POS und ePOS drucken sie als normale fette Zeilen — keine doppelte
+  Höhe, kein Invertieren mehr. `grid32`/`grid48` der Belege mit Aufdruck ändern
+  sich, das Zeilenmodell nicht.
+- Bekannter Unterschied, bleibt so: ESC/POS druckt `EUR` statt `€` (die
+  Ein-Byte-Codepage des Bondruckers kennt das Zeichen nicht). Bildschirm, PDF
+  und ePOS zeigen `€`; die Zeilen sind dadurch am Bon an diesen Stellen anders
+  gefüllt, das Raster bleibt gleich breit.
+- Neu `belegBlatt(layout, { zeichen, logo, marke, qrGroesse })`: Reihenfolge
+  (Aufdrucke oben, Leerzeile, Logo, Leerzeile, Beleg, Marke), Logo-Maß je Stufe
+  S/M/L/XL (nie hochgerechnet), QR-Anteil wie am Drucker.
+- Ein QR-Inhalt, der in keine QR-Version passt (Korrektur M, mehr als 2331
+  Byte), bekommt im Blatt den Anteil 0, statt dass `belegBlatt` wirft. ESC/POS
+  und ePOS lassen den QR dann weg und melden es über `qrFehler`; der Beleg steht
+  ohne QR. Die Bildschirm-Ansicht ruft `renderQr` weiter mit der Nutzlast, damit
+  die Oberfläche den fehlenden QR anzeigen kann (Papierbeleg-Hinweis). **Grund:** Ein Wurf riss jeden Zeichner mit — die Bon-Ansicht der
+  Web-Kasse fiel ganz aus, Bon und PDF ebenso. Neu `qrPasstInVersion(nutzlast)`
+  (`./printing`); `qrModulAnzahl` wirft weiter.
+- Neu `logoRaster` (RGBA → einfarbiges Rasterbild), `escPosRasterBild`,
+  `eposBildXml`; `escPosLayoutBytes` und `eposPrintXml` nehmen `logo` und `marke`.
+- Neu `BelegBlattView` / `BelegBlattZeilen` (`./react`); `ReceiptLayoutView` ist
+  `@deprecated`. `BelegBlattView` zeigt ein Logo ueber 4096x4096px (oder 0)
+  ebenso wenig wie ein nicht geladenes -- neu `LOGO_PIXEL_MAX`,
+  `logoPixelZulaessig` (`./receipt`). **Grund:** Bildschirm und Bon zeigen
+  dasselbe Logo; das Druck-Kit lehnt ein zu grosses Logo beim Rastern fuer
+  den Bon schon ab (dieselbe Grenze), der Bildschirm bisher nicht -- ein
+  5000x1200px-Logo erschien am Bildschirm und im PDF, aber nie auf dem
+  gedruckten Beleg.
+- Neu `ReceiptWithCompany.logoStufe` (aus `logo_skala` der Beleg-Antwort,
+  Vorgabe `M`): Panel und App kannten die Logo-Stufe des Betriebs bisher nicht.
+- `createPrintJob` nimmt `logo` und `marke`: der Netzwerk-Drucker (Connect)
+  druckt dasselbe Blatt wie USB, Bluetooth und ePOS direkt. Neu
+  `rasterZeilenBase64` (gemeinsam für ePOS-`<image>` und den Druckjob).
+- Goldens `erwartet/<name>.blatt32.json`/`.blatt48.json`,
+  `erwartet/logo-probe.raster32.txt` (mit Teiltransparenz) und
+  `erwartet/logo-probe-hoch.raster32.txt` (höhenbegrenzt) für den Dart-Zwilling.
+- `escPosRasterBild` wirft bei einer Bildhöhe über 65535 Punkten (`GS v 0` trägt
+  die Höhe in zwei Bytes).
+
+### Achtung: Brüche
+
+- **Aufdrucke im Raster.** `renderReceiptGrid` gibt jeden Aufdruck als drei
+  Zeilen `kind:'banner'` aus (`====`, Text, `====`). *Umstellen:* eigene
+  Rahmen oder Sonderstile für Aufdrucke entfernen (sie stünden sonst doppelt)
+  und nicht annehmen, dass die erste `banner`-Zeile die einzige ist — der Text
+  steht in der mittleren.
+- **`ReceiptWithCompany.logoStufe` ist Pflicht.** `getReceiptWithCompany` füllt
+  es selbst. *Umstellen:* von Hand gebaute Objekte (Tests, Vorschauen) brauchen
+  `logoStufe: 'M'`.
+- **QR-Vorgabe `auto` deckelt bei 6 Punkten je Modul (vorher 4)** — in npm und
+  Dart dasselbe. Am ESC/POS-Bon wird der QR ohne ausdrückliche Wahl größer
+  (80 mm: rund 55 % statt 37 % der Breite). *Umstellen:* wer die alte Größe
+  will, stellt `qrGroesse: 'klein'`.
+- **Nativer ESC/POS-QR mit Fehlerkorrektur M (vorher L)**, wie ePOS, Bildweg
+  und Blatt — der Kasten am Bildschirm ist damit genau der gedruckte QR.
+  Manche Nutzlasten brauchen eine Version mehr. *Umstellen:* den alten
+  Bytestrom liefert `qrCorrection: 'L'` (zusammen mit `qrGroesse: 'klein'`).
+- **ePOS-Vorgabe `qrGroesse` ist `auto`** (vorher `mittel`). Derselbe Wert,
+  kein Byte anders; nur wer die Vorgabe ausliest oder dokumentiert, merkt es.
+
+## 0.13.2
+
+### Die Paketseite erklaert, wofuer das Paket da ist
+
+**Anlass:** Wer auf npm landet, sah eine Wand aus Technik und nirgends, worum
+es geht. Die Seite traegt jetzt das Kasseneck-Logo, einen englischen Einzeiler
+fuer Besucher von aussen, und eine Tabelle, welche Pflichten einer
+oesterreichischen Registrierkasse wo erledigt werden — mit Verweisen auf die
+Wissensseiten und einem ausdruecklichen Hinweis, dass hier kein Rechtsrat steht
+und die Verantwortung beim Unternehmer bleibt. Kopf und Fuss nennen Kreiseck
+als Absender und verlinken dorthin. Am Code aendert sich nichts.
+
+### Der Vertrag nennt keinen Anmeldedienst mehr beim Namen
+
+**Anlass:** Die Doku sprach an 16 Stellen von einem bestimmten Anbieter,
+obwohl das Paket ihn gar nicht kennt: `registerUserAuth` bekommt eine Funktion,
+die ein Token liefert — woher es stammt, geht das Paket nichts an. Ein
+Implementierungsdetail im Vertrag bindet beide Seiten grundlos aneinander;
+jetzt steht dort "ID-Token des Anmeldediensts". Damit verschwindet der Name
+auch aus den ausgelieferten Typdeklarationen.
+
 ## 0.13.1
 
 ### Der 404 beim Abbruch wird benannt, nicht als Abriss gefuehrt

package/README.md

@@ -1,15 +1,87 @@
-# @kreiseck/kasseneck-api
-
-JavaScript-/TypeScript-Client für das Kasseneck-Backend — der Zwilling des
-Flutter-Pakets `kasseneck_api`. Er spricht dieselben Endpunkte, führt dieselben
-Modelle und dieselben Enum-Werte; ein eingecheckter Abzug der Dart-Enums wird
-im Test gegengeprüft, damit die beiden Pakete nicht auseinanderdriften.
-
-Das Paket deckt ab: Belege ausstellen und stornieren, Belege und Kassen
-auflisten, Berichte herunterladen, Status bei FinanzOnline abfragen,
-Stripe-Zahllinks und Hobex-Cloud-Zahlungen, das Beleg-Layout und die
-ESC/POS-Erzeugung für den Bondrucker — und unter `./partner` die
-**Partner-API**: Betriebe anlegen und bis zur laufenden Kasse begleiten.
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kreiseck-at/kasseneck-api/main/doc/kasseneck.gif" alt="Kasseneck — RKSV-Registrierkasse aus Österreich" width="420">
+</p>
+
+<h1 align="center">@kreiseck/kasseneck-api</h1>
+
+<p align="center">
+  <b>Austrian fiscal cash register (RKSV) for JavaScript and TypeScript — signed receipts, card payments, receipt printing.</b>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@kreiseck/kasseneck-api"><img src="https://img.shields.io/npm/v/%40kreiseck%2Fkasseneck-api?color=136B6B&label=npm" alt="npm"></a>
+  <img src="https://img.shields.io/badge/RKSV-%C2%A7%20131b%20BAO-136B6B" alt="RKSV">
+  <img src="https://img.shields.io/badge/Lizenz-Apache--2.0-136B6B" alt="Apache-2.0">
+  <a href="https://kasseneck.at"><img src="https://img.shields.io/badge/Kasseneck-kasseneck.at-132A2A" alt="kasseneck.at"></a>
+  <a href="https://kreiseck.com"><img src="https://img.shields.io/badge/von-Kreiseck-132A2A" alt="Kreiseck Software Solutions"></a>
+</p>
+
+**Kasseneck** ist eine österreichische Registrierkasse nach RKSV. Dieses Paket ist
+der JavaScript-/TypeScript-Client dafür: Ihr Code stellt Belege aus, storniert sie,
+nimmt Kartenzahlungen entgegen und druckt Bons. Es ist der Zwilling des
+Flutter-Pakets [`kasseneck_api`](https://pub.dev/packages/kasseneck_api):
+dieselben Endpunkte, dieselben Modelle, dieselben Enum-Werte, im Test
+gegeneinander geprüft.
+
+## Was eine Registrierkasse in Österreich können muss
+
+Die Registrierkassen- und Belegerteilungspflicht steht in § 131b der
+Bundesabgabenordnung, die technischen Anforderungen an die Sicherheitseinrichtung
+in der Registrierkassensicherheitsverordnung (RKSV). Daraus ergibt sich eine
+ganze Kette von Aufgaben — die Tabelle zeigt, welche davon **diese Software**
+übernimmt und welche beim Betrieb selbst bleiben:
+
+| Aufgabe | Wo sie erledigt wird |
+| --- | --- |
+| [Signaturerstellungseinheit](https://kasseneck.at/wissen/signaturerstellungseinheit) — jede Barzahlung wird signiert | Kasseneck, nichts zu installieren |
+| [Verkettung und DEP](https://kasseneck.at/wissen/dep) — jeder Beleg trägt den vorigen, das Protokoll ist exportierbar | Kasseneck-Backend |
+| [Startbeleg, Monatsbeleg, Jahresbeleg](https://kasseneck.at/wissen/startbeleg-monatsbeleg-jahresbeleg) | Kasseneck, automatisch |
+| [Meldungen an FinanzOnline](https://kasseneck.at/wissen/finanzonline) — Anmeldung, Ausfall, Außerbetriebnahme | Kasseneck-Backend |
+| [Belegerteilungspflicht](https://kasseneck.at/wissen/belegerteilungspflicht) — jeder Kunde bekommt einen Beleg | **dieses Paket** — Bon, PDF, Bildschirm oder Link |
+| [Ausfall der Signatureinheit](https://kasseneck.at/wissen/ausfall) — Sammelbeleg, Meldung, Nachsignatur | Kasseneck, automatisch |
+| [Kassennachschau](https://kasseneck.at/wissen/kassennachschau) — der Prüfer verlangt das DEP | Kasseneck, Export auf Knopfdruck |
+| Anmeldung der Kasse, Aufbewahrung, steuerliche Würdigung | **beim Unternehmer** |
+
+Kurz: Sie bauen die Kassenoberfläche, nicht die Sicherheitseinrichtung. Ein Aufruf
+von `createReceipt(...)` erzeugt einen signierten, verketteten und im DEP
+abgelegten Beleg. Die Signaturkette wird gegen das offizielle Prüfwerkzeug des
+BMF getestet.
+
+> **Kein Rechts- oder Steuerrat.** Dieser Abschnitt beschreibt, was die Software
+> tut. Er ersetzt keine Beratung und begründet keine Zusicherung, dass ein
+> bestimmter Betrieb damit alle Pflichten erfüllt. Verbindlich sind die
+> Bundesabgabenordnung, die RKSV und die Erlässe des BMF; die Verantwortung für
+> Anmeldung, Betrieb und Aufbewahrung bleibt beim Unternehmer. Ausführlicher und
+> mit Quellen: [kasseneck.at/wissen](https://kasseneck.at/wissen).
+> Stand: September 2026.
+
+## Erst ausprobieren
+
+Es gibt eine Test-Umgebung mit eigenem Schlüssel und Test-Signaturen, getrennt
+vom Echtbetrieb — die aktuellen Konditionen stehen auf
+[kasseneck.at/preise](https://kasseneck.at/preise), die Schnittstelle ist unter
+[kasseneck.at/api-doku](https://kasseneck.at/api-doku) beschrieben.
+
+## Lieber eine fertige Kasse?
+
+Dieses Paket ist für alle, die eine eigene Anwendung bauen. Wer einfach kassieren
+will, muss nichts davon programmieren:
+
+- **[Kasseneck — die fertige Registrierkasse](https://kasseneck.at)** für Telefon,
+  Tablet und Browser, inklusive Signaturerstellungseinheit und
+  FinanzOnline-Anmeldung.
+- **[Lösungen nach Branche](https://kasseneck.at/branchen)** — vom Lokal bis zum Taxi.
+- **[Preise](https://kasseneck.at/preise)**
+- **[Kontakt](https://kasseneck.at/kontakt)** — auch für Kassenwechsel,
+  Partnerschaften und eigene Integrationen.
+
+## Was drin ist
+
+Belege ausstellen und stornieren, Belege und Kassen auflisten, Berichte
+herunterladen, Status bei FinanzOnline abfragen, Stripe-Zahllinks und
+Hobex-Cloud-Zahlungen, das Beleg-Layout und die ESC/POS-Erzeugung für den
+Bondrucker — und unter `./partner` die **Partner-API**: Betriebe anlegen und bis
+zur laufenden Kasse begleiten.
 
 **Es läuft im Browser und in Node.** ESM ist das Hauptformat, CommonJS liegt
 daneben; beides mit eigenen Typdeklarationen. Node ab 20.18 (`fetch` muss
@@ -33,7 +105,7 @@ bevorzugte:
 | Weg | Wer | Wie |
 |-----|-----|-----|
 | `apiKeyAuth` | Geräte, POS-Apps, Dritte | `api_key` als Bearer + `cashregister-token`-Kopfzeile |
-| `registerUserAuth` | Browser-Kasse | Firebase-ID-Token als Bearer + `register-session`-Kopfzeile, Kasse als Parameter |
+| `registerUserAuth` | Browser-Kasse | ID-Token des Anmeldediensts als Bearer + `register-session`-Kopfzeile, Kasse als Parameter |
 
 ```ts
 import { apiKeyAuth, registerUserAuth } from '@kreiseck/kasseneck-api';
@@ -41,7 +113,7 @@ import { apiKeyAuth, registerUserAuth } from '@kreiseck/kasseneck-api';
 // Gerät/POS: der api_key gehört auf ein Gerät, nie in einen Browser.
 const geraet = apiKeyAuth({ apiKey: 'kr_live_…', cashregisterToken: 'cb_live_…' });
 
-// Browser-Kasse: das Paket kennt Firebase nicht — es bekommt Funktionen, die
+// Browser-Kasse: das Paket kennt den Anmeldedienst nicht — es bekommt Funktionen, die
 // ein gültiges Token bzw. die laufende Sitzung liefern. Beide werden bei JEDEM
 // Aufruf befragt (ID-Tokens laufen nach einer Stunde ab, die Kassen-Sitzung
 // nach 90 Sekunden).
@@ -66,7 +138,7 @@ const geraet = await pairRegisterDevice({ code: 'K7NPQR34', label: 'Schank' });
 const sitzung = await registerUserLogin({ ...geraet, userId: 'ru-1', pin: '1234' });
 ```
 
-Mit `sitzung.customToken` meldet sich der Verbraucher bei Firebase an; das
+Mit `sitzung.customToken` meldet sich der Verbraucher beim Anmeldedienst an; das
 daraus entstehende ID-Token und `sitzung.sessionId` ergeben `registerUserAuth`.
 
 Eine anmeldungsfreie Anmeldung gibt es dafür **nicht** — sie wäre ein
@@ -388,8 +460,9 @@ const mass = qrGroesseFuer({ nutzlast: beleg.qr, papierbreitePunkte: QR_DRUCK_PU
 
 Am Belegweg passiert das von selbst. `qrGroesse` ist ein **Deckel**, keine
 Vorgabe: gedruckt wird die größte Größe, die noch passt, höchstens aber der
-Deckel. `auto` (Vorgabe) deckelt beim Bestandswert 4 — ohne ausdrückliche Wahl
-ändert sich also kein Byte.
+Deckel. `auto` (Vorgabe) deckelt bei 6 Punkten je Modul — wie im Dart-Zwilling
+und am Epson-Weg; `klein` deckelt bei 4. Alle Druckwege setzen den QR mit
+Fehlerkorrektur M.
 
 ```ts
 import { escPosLayoutErgebnis } from '@kreiseck/kasseneck-api/receipt';
@@ -402,8 +475,8 @@ const { bytes, qrFehler, qrAusweich } = escPosLayoutErgebnis(layout, {
 ```
 
 Der Epson-Weg (`eposPrintXml` / `eposDirectPrint`) rechnet genauso;
-`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Sein
-Bestandswert ist 6, deshalb ist die Vorgabe dort der Deckel `mittel`.
+`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Die Vorgabe
+ist auch dort `auto`.
 
 `qrFehler` heißt „Beleg ohne QR" — das gehört dem Kunden gesagt. `qrAusweich`
 heißt „gedruckt, aber der eingestellte Weg taugt für dieses Gerät nicht" — das
@@ -411,6 +484,30 @@ gehört dem Chef gesagt. Den Bildweg fährt das Paket nur mit einem `qrMatrix`,
 das die Nutzlast in ein fertiges Raster übersetzt: hier wird bewusst weder ein
 QR gerechnet noch ein Bild verarbeitet.
 
+## Das Beleg-Blatt: überall derselbe Beleg
+
+Bildschirm, Bon, ePOS und PDF setzen dasselbe **Blatt**: Rasterzeilen, Firmenlogo,
+QR und die Marke „erstellt mit Kasseneck", mit Größen als Anteil der Blattbreite
+und in Zeilen (eine Zeile = zwei Zeichenbreiten).
+
+```tsx
+import { BelegBlattView } from '@kreiseck/kasseneck-api/react';
+
+<BelegBlattView layout={layout} logo={{ url: company.logoUrl, stufe: 'M' }} marke={company.showKreiseckLogo} renderQr={(d) => <QrSvg data={d} />} />
+```
+
+```ts
+import { escPosLayoutBytes, logoMass, logoRaster } from '@kreiseck/kasseneck-api/receipt';
+
+const mass = logoMass({ stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height }, 48);
+const raster = logoRaster(imageData.data, bild.width, bild.height, mass, 48);
+escPosLayoutBytes(layout, { paperSize: 'mm80', logo: { stufe: 'M', pxBreite: bild.width, pxHoehe: bild.height, raster }, marke: true });
+```
+
+Logo-Stufen: S 42 % × 5 Zeilen, M 62 % × 8, L 80 % × 12, XL 94 % × 16 — eingepasst,
+nie hochgerechnet. Der Aufdruck (TESTKASSE, STORNOBELEG …) ist ein Rahmen aus
+`=`-Zeilen, auf jedem Weg gleich.
+
 ## Hobex HPS über Kasseneck Connect
 
 Ein Browser hat weiterhin keine rohen TCP-Sockets — ein **direkter**
@@ -444,7 +541,8 @@ Android-SDKs ohne Entsprechung hier.
 ## Was hier grundsätzlich nicht dazugehört
 
 Die Druckeransteuerung selbst (dieses Paket erzeugt die Bytes, es verschickt
-sie nicht), Firmenlogos und Rasterbilder, und die PDF-Erzeugung.
+sie nicht) und die PDF-Erzeugung. Bilder dekodieren (PNG/JPEG): das Paket
+rastert fertige RGBA-Pixel, das Laden des Bilds bleibt bei der Anwendung.
 
 ## Entwicklung
 
@@ -476,7 +574,7 @@ steht. Deshalb prüft das Skript auf ein `status`-Feld und nicht auf Erfolg.
 Bewusst außerhalb von `npm test`: Sie braucht Netz. Ist keines da, sagt sie es
 und endet mit 0. Aufrufe, die unter `/v1` absichtlich keine Weiterleitung
 haben — der Kassen-Weg über `kasse.kasseneck.at/api`, die Aufrufe mit
-Firebase-ID-Token — stehen mit Grund in `scripts/erreichbarkeit-ausnahmen.json`.
+ID-Token — stehen mit Grund in `scripts/erreichbarkeit-ausnahmen.json`.
 Wird eine Ausnahme erreichbar, schlägt die Prüfung an: Sonst sänke die Zahl nie.
 
 ## Vertragsdateien für die Zwillinge
@@ -520,3 +618,11 @@ ankommt.
 ## Lizenz
 
 Apache-2.0 — siehe `LICENSE` und `NOTICE`.
+
+---
+
+**Kasseneck** ist ein Produkt von
+[Kreiseck Software Solutions](https://kreiseck.com) aus Salzburg — Apps,
+Kassensysteme und Automatisierungen. Fragen zur Schnittstelle, zu eigenen
+Integrationen oder zu einer Partnerschaft:
+[kasseneck.at/kontakt](https://kasseneck.at/kontakt).

package/dist/cjs/client/auth.d.ts

@@ -6,7 +6,7 @@
  *   Bearer plus die Kopfzeile `cashregister-token` (wie im Flutter-Zwilling
  *   `kasseneck_api`).
  * - `registerUserAuth` — der Weg der Browser-Kasse: ein Kassen-Benutzer, per
- *   PIN an einem gekoppelten Geraet angemeldet. Firebase-ID-Token als Bearer,
+ *   PIN an einem gekoppelten Geraet angemeldet. ID-Token als Bearer,
  *   die laufende Sitzung als Kopfzeile `register-session`, die Kasse als
  *   Parameter `cashregisterId` in der Nutzlast.
  *
@@ -14,9 +14,9 @@
  * fuehrt keine eigenen HTTP-Aufrufe, kennt den Transport nicht und haelt keinen
  * Zustand — genau deshalb ist sie austauschbar und einzeln testbar.
  *
- * Das Paket weiss **nichts** von Firebase: `registerUserAuth` bekommt eine
+ * Das Paket weiss **nichts** vom Anmeldedienst: `registerUserAuth` bekommt eine
  * Funktion, die ein gueltiges ID-Token liefert (darf `async` sein). Sie wird
- * bei **jedem** Aufruf befragt — Firebase-ID-Tokens laufen nach einer Stunde
+ * bei **jedem** Aufruf befragt — ID-Tokens laufen nach einer Stunde
  * ab, die Sitzung der Browser-Kasse lebt sogar nur 90 Sekunden und wird alle
  * 30 Sekunden erneuert; ein einmal gemerkter Wert waere also bald tot.
  */
@@ -39,7 +39,7 @@ export interface ApiKeyAuthOptions {
     cashregisterToken: string;
 }
 export interface RegisterUserAuthOptions {
-    /** Liefert ein gueltiges Firebase-ID-Token; wird pro Anfrage befragt. */
+    /** Liefert ein gueltiges ID-Token des Anmeldediensts; wird pro Anfrage befragt. */
     getIdToken: () => string | Promise<string>;
     /** Liefert die laufende Kassen-Sitzung; wird pro Anfrage befragt. */
     getSessionId: () => string | Promise<string>;

package/dist/cjs/client/auth.js

@@ -7,7 +7,7 @@
  *   Bearer plus die Kopfzeile `cashregister-token` (wie im Flutter-Zwilling
  *   `kasseneck_api`).
  * - `registerUserAuth` — der Weg der Browser-Kasse: ein Kassen-Benutzer, per
- *   PIN an einem gekoppelten Geraet angemeldet. Firebase-ID-Token als Bearer,
+ *   PIN an einem gekoppelten Geraet angemeldet. ID-Token als Bearer,
  *   die laufende Sitzung als Kopfzeile `register-session`, die Kasse als
  *   Parameter `cashregisterId` in der Nutzlast.
  *
@@ -15,9 +15,9 @@
  * fuehrt keine eigenen HTTP-Aufrufe, kennt den Transport nicht und haelt keinen
  * Zustand — genau deshalb ist sie austauschbar und einzeln testbar.
  *
- * Das Paket weiss **nichts** von Firebase: `registerUserAuth` bekommt eine
+ * Das Paket weiss **nichts** vom Anmeldedienst: `registerUserAuth` bekommt eine
  * Funktion, die ein gueltiges ID-Token liefert (darf `async` sein). Sie wird
- * bei **jedem** Aufruf befragt — Firebase-ID-Tokens laufen nach einer Stunde
+ * bei **jedem** Aufruf befragt — ID-Tokens laufen nach einer Stunde
  * ab, die Sitzung der Browser-Kasse lebt sogar nur 90 Sekunden und wird alle
  * 30 Sekunden erneuert; ein einmal gemerkter Wert waere also bald tot.
  */

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

@@ -5,7 +5,7 @@ import type { InternerTransport } from './aufrufe.js';
  *
  * **Anmeldeweg:** `listMyCashregisters` laeuft im Backend unter
  * `checkRequest(req, 'customer', …, {allowRegisterUser: true})` — der Bearer
- * muss also ein Firebase-ID-Token sein. Mit `apiKeyAuth` (api_key als Bearer)
+ * muss also ein ID-Token des Anmeldediensts sein. Mit `apiKeyAuth` (api_key als Bearer)
  * ist dieser Endpunkt **nicht** erreichbar; fuer die Browser-Kasse ist
  * `registerUserAuth` der Weg. Dieses Paket bildet das nicht nach — wer darf,
  * entscheidet allein das Backend. Der Hinweis steht hier, damit ein Leser

package/dist/cjs/client/cashregisters.js

@@ -8,7 +8,7 @@ const errors_js_1 = require("./errors.js");
  *
  * **Anmeldeweg:** `listMyCashregisters` laeuft im Backend unter
  * `checkRequest(req, 'customer', …, {allowRegisterUser: true})` — der Bearer
- * muss also ein Firebase-ID-Token sein. Mit `apiKeyAuth` (api_key als Bearer)
+ * muss also ein ID-Token des Anmeldediensts sein. Mit `apiKeyAuth` (api_key als Bearer)
  * ist dieser Endpunkt **nicht** erreichbar; fuer die Browser-Kasse ist
  * `registerUserAuth` der Weg. Dieses Paket bildet das nicht nach — wer darf,
  * entscheidet allein das Backend. Der Hinweis steht hier, damit ein Leser

package/dist/cjs/client/errors.d.ts

@@ -30,7 +30,7 @@
  *   Sonderfall.
  *
  * **Geheimnisse gehoeren in keinen dieser Fehler.** Fehlermeldungen landen in
- * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, Firebase-
+ * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, ID-
  * ID-Token noch Sitzungsbezeichner duerfen dorthin. Deshalb tragen die Fehler
  * ausschliesslich Funktionsname, HTTP-Status/Inhaltstyp, den vom Paket
  * formulierten Grund und die vom Backend formulierte Meldung — nie Kopfzeilen,

package/dist/cjs/client/errors.js

@@ -31,7 +31,7 @@
  *   Sonderfall.
  *
  * **Geheimnisse gehoeren in keinen dieser Fehler.** Fehlermeldungen landen in
- * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, Firebase-
+ * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, ID-
  * ID-Token noch Sitzungsbezeichner duerfen dorthin. Deshalb tragen die Fehler
  * ausschliesslich Funktionsname, HTTP-Status/Inhaltstyp, den vom Paket
  * formulierten Grund und die vom Backend formulierte Meldung — nie Kopfzeilen,
@@ -66,7 +66,7 @@ exports.isKasseneckAuthError = isKasseneckAuthError;
 exports.isKasseneckValidationError = isKasseneckValidationError;
 // Bezeichner-artig: Buchstabe vorn, danach nur Bezeichnerzeichen, hoechstens
 // 64 Zeichen. Das laesst `TypeError`, `ECONNREFUSED` und `auth/internal-error`
-// durch, aber keinen Freitext und kein Firebase-ID-Token (~900 Zeichen).
+// durch, aber keinen Freitext und kein ID-Token (~900 Zeichen).
 const BEZEICHNER = /^[A-Za-z][A-Za-z0-9_./-]{0,63}$/;
 /**
  * Reduziert eine fremde Ursache auf Name und Code — und verwirft beides, wenn

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

@@ -2,6 +2,7 @@ import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMe
 import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
 import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
+import type { LogoStufe } from '../receipt/blatt.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
  * kasseneck_api/lib/kasseneck_api.dart.
@@ -168,6 +169,12 @@ export interface ReceiptWithCompany {
      * fuer Clients, die das Layout selbst bauen; null bei altem Backend.
      */
     pruefangaben: Pruefangaben | null;
+    /**
+     * Groesse des Firmenlogos am Beleg (Kasse-Einstellung `logoSkala` des
+     * Betriebs). Bildschirm, Bon und PDF setzen das Logo in genau dieser Stufe;
+     * liefert das Backend sie nicht (alt), gilt `M` -- der Bestandswert.
+     */
+    logoStufe: LogoStufe;
 }
 /**
  * Gemeinsame Umsetzung aller Belegarten (Zwilling von `_createReceipt`).
@@ -256,7 +263,7 @@ export interface ListMyReceiptsOptions {
  *
  * **Anmeldeweg:** Der Endpunkt laeuft im Backend unter
  * `checkRequest(req, 'customer', …, {allowRegisterUser: true})`, der Bearer
- * muss also ein Firebase-ID-Token sein — mit `apiKeyAuth` ist er nicht
+ * muss also ein ID-Token des Anmeldediensts sein — mit `apiKeyAuth` ist er nicht
  * erreichbar. Ausserdem prueft das Backend die Kassenzuweisung hier im Rumpf
  * (der Endpunkt laeuft mit `checkCashRegister: false`), ein Kassen-Benutzer
  * bekommt also nur die ihm zugewiesenen Kassen.

package/dist/cjs/client/receipts.js

@@ -217,7 +217,7 @@ function zeroReceipt(rufen) {
  *
  * **Anmeldeweg:** Der Endpunkt laeuft im Backend unter
  * `checkRequest(req, 'customer', …, {allowRegisterUser: true})`, der Bearer
- * muss also ein Firebase-ID-Token sein — mit `apiKeyAuth` ist er nicht
+ * muss also ein ID-Token des Anmeldediensts sein — mit `apiKeyAuth` ist er nicht
  * erreichbar. Ausserdem prueft das Backend die Kassenzuweisung hier im Rumpf
  * (der Endpunkt laeuft mit `checkCashRegister: false`), ein Kassen-Benutzer
  * bekommt also nur die ihm zugewiesenen Kassen.
@@ -582,5 +582,6 @@ function belegMitFirmaAusHuelle(daten, functionName) {
         kopfId: typeof d.kopfId === 'string' ? d.kopfId : null,
         layout,
         pruefangaben: pa ? { karteRegistriertAm: text(pa.karteRegistriertAm), kasseRegistriertAm: text(pa.kasseRegistriertAm) } : null,
+        logoStufe: d.logo_skala === 'S' || d.logo_skala === 'M' || d.logo_skala === 'L' || d.logo_skala === 'XL' ? d.logo_skala : 'M',
     };
 }

package/dist/cjs/client/transport.d.ts

@@ -7,7 +7,7 @@ import type { KasseneckAuth } from './auth.js';
  * Der Transport macht drei Dinge und sonst nichts: Anfrage bauen (Kopfzeilen
  * von der Anmeldung, Nutzlast aus Auth-Parametern und Aufruferparametern),
  * Zeitlimit ueberwachen, und die Antworthuelle aufloesen. Er kennt keine
- * einzelne Backend-Funktion und keine Firebase-Details.
+ * einzelne Backend-Funktion und keine Details der Infrastruktur.
  *
  * Es gibt **zwei Einstiegspunkte** auf demselben Kern: [createTransport] fuer
  * die JSON-Aufrufe und [createBinaryTransport] fuer die beiden Bericht-

package/dist/cjs/client/transport.js

@@ -12,7 +12,7 @@ const errors_js_1 = require("./errors.js");
  * Der Transport macht drei Dinge und sonst nichts: Anfrage bauen (Kopfzeilen
  * von der Anmeldung, Nutzlast aus Auth-Parametern und Aufruferparametern),
  * Zeitlimit ueberwachen, und die Antworthuelle aufloesen. Er kennt keine
- * einzelne Backend-Funktion und keine Firebase-Details.
+ * einzelne Backend-Funktion und keine Details der Infrastruktur.
  *
  * Es gibt **zwei Einstiegspunkte** auf demselben Kern: [createTransport] fuer
  * die JSON-Aufrufe und [createBinaryTransport] fuer die beiden Bericht-
@@ -81,7 +81,7 @@ function createCore(options) {
                     throw new errors_js_1.KasseneckNetworkError(fehlerName, true, zeitlimitMs);
                 }
                 // Eigene Pruefungen tragen ihren geheimnisfreien Grund weiter; von einer
-                // fremden Ursache (Firebase & Co.) bleibt nichts uebrig — weder Meldung
+                // fremden Ursache bleibt nichts uebrig — weder Meldung
                 // noch Verdichtung, siehe Klassenkommentar zu KasseneckAuthError.
                 const grund = ursache instanceof errors_js_1.KasseneckAuthError ? ursache.reason : 'Anmeldung fehlgeschlagen';
                 throw new errors_js_1.KasseneckAuthError(grund, { functionName: fehlerName });

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

@@ -1,5 +1,6 @@
 import type { InternerTransport } from '../client/aufrufe.js';
 import type { ReceiptLayout } from '../receipt/layout.js';
+import type { DruckLogo } from '../receipt/layout-escpos.js';
 /**
  * Netzwerk-Bondrucker ueber Epson "Server Direct Print": das Backend fuehrt
  * je Konto Drucker mit einer geheimen Abhol-URL; die Kasse legt Druckjobs
@@ -46,6 +47,10 @@ export interface CreatePrintJobOptions {
     receiptId?: string;
     titel?: string;
     quelle?: string;
+    /** Firmenlogo als fertiges Rasterbild (`logoRaster`); der Server dekodiert keine Bilder. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 export declare function createPrintJob(rufen: InternerTransport, o: CreatePrintJobOptions): Promise<DruckJob>;
 export declare function getPrintJob(rufen: InternerTransport, o: {

package/dist/cjs/kasse/drucker.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.listMyPrinters = listMyPrinters;
 exports.createPrintJob = createPrintJob;
 exports.getPrintJob = getPrintJob;
+const index_js_1 = require("../printing/index.js");
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 async function listMyPrinters(rufen) {
@@ -27,6 +28,14 @@ async function createPrintJob(rufen, o) {
         params.titel = o.titel;
     if (o.quelle)
         params.quelle = o.quelle;
+    if (o.logo) {
+        params.logo = {
+            stufe: o.logo.stufe, pxBreite: o.logo.pxBreite, pxHoehe: o.logo.pxHoehe,
+            breite: o.logo.raster.breite, hoehe: o.logo.raster.hoehe, zeilen: (0, index_js_1.rasterZeilenBase64)(o.logo.raster),
+        };
+    }
+    if (o.marke === true)
+        params.marke = true;
     const daten = await rufen('createPrintJob', params);
     return { jobId: String(daten?.jobId ?? ''), status: text(daten?.status) ?? 'offen', ergebnis: null };
 }

package/dist/cjs/kasse/settings.js

@@ -116,8 +116,11 @@ exports.KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 exports.KASSE_BETRIEB_STANDARD = Object.freeze({
-    // Petrol aus der Markenpalette ("Ecke, Aktion") — nicht das alte Blau.
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#116B6B',
+    // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
+    // Stand bis September 2026 auf dem Wert des alten Markenhandbuchs,
+    // der um 0,07 in OKLab danebenlag. Unsichtbar, aber es war die letzte Stelle
+    // im Haus, an der eine zweite Zahl fuer dieselbe Farbe stand.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#136B6B',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,

package/dist/cjs/models/cashregister.d.ts

@@ -2,7 +2,7 @@
  * Kasse — die Antwortform von `listMyCashregisters` (functions/index.js).
  *
  * Das Dart-Vorbild (`Cashregister` in kasseneck_api/lib/models/cashregister.dart)
- * liest das **Firestore-Dokument** direkt ueber das `cloud_firestore`-SDK und
+ * liest das **Datenbankdokument** direkt ueber das SDK der Echtzeit-Datenbank und
  * kommt deshalb an `token` und `aes_key`. Dieses Paket spricht das Backend
  * ausschliesslich ueber die HTTPS-Endpunkte, und die geben beides nicht her:
  *
@@ -20,7 +20,7 @@
  * fehlendes.
  *
  * Aus demselben Grund fehlt `userId`: das Dart-Vorbild traegt es, weil es den
- * Firestore-**Pfad** kennt (`users/{uid}/cashregisters/{id}`). In dieser
+ * **Pfad** in der Datenbank kennt (`users/{uid}/cashregisters/{id}`). In dieser
  * Antwort steht es nicht, und ein Kassen-Benutzer erfaehrt die Kennung seines
  * Betriebs bewusst nie — sie steckt allein im Token.
  */

package/dist/cjs/models/receipt-company.d.ts

@@ -36,7 +36,7 @@ export interface ReceiptCompany {
     logoUrl?: string;
     /** Dankestext am Belegende, je Zeile ein Eintrag. */
     thanksMessage: string[];
-    /** Kreiseck-Branding am Belegende (Firestore-Flag `branding.kreiseck_logo`). */
+    /** Kreiseck-Branding am Belegende (Konto-Flag `branding.kreiseck_logo`). */
     showKreiseckLogo: boolean;
 }
 /**

package/dist/cjs/printing/escpos.d.ts

@@ -24,8 +24,9 @@
  * CP437-Plaetze umkodiert (ä = 0x84, ü = 0x81, ß = 0xE1, ...). Zeichen ohne
  * CP437-Platz werden zu `?` — weiterhin ein Byte je Zeichen.
  *
- * Nicht enthalten (bewusst): Rasterbilder/Logos, Capability-Profile einzelner
- * Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Nicht enthalten (bewusst): Bilddekodierung (PNG/JPEG liest die Huelle),
+ * Capability-Profile einzelner Druckermodelle, Kassenlade, 1D-Barcodes.
+ * Fertige einfarbige Rasterbilder (Logo) gehen ueber [escPosRasterBild].
  */
 import { type QrModulGroesse } from './qr-groesse.js';
 /** Papierbreite der Bonrolle. */
@@ -103,6 +104,7 @@ export interface EscPosQrOptions {
      * die Regel in `qr-groesse.ts`.
      */
     size?: QrSize;
+    /** Fehlerkorrektur; Vorgabe `M` wie auf allen Druckwegen (siehe `qrCodeBytes`). */
     correction?: QrCorrection;
     /** Deckel fuer die gerechnete Modulgroesse; wirkungslos neben `size`. */
     groesse?: QrModulGroesse;
@@ -255,6 +257,12 @@ export declare function escPosRow(doc: EscPosDocument, columns: readonly PosColu
  * es wird kein Bild uebertragen.
  *
  * Bei Kasseneck-Belegen steht hier der maschinenlesbare RKSV-Code.
+ *
+ * Fehlerkorrektur ohne Angabe: **M** (bis 0.13: L). Die Groessenrechnung
+ * (`qrModulAnzahl`), das Blatt (Anteil am Bildschirm und im PDF), der
+ * ePOS-Weg (`level_m`) und der Bildweg rechnen alle mit M — druckte der
+ * native Befehl mit L, kaeme fuer manche Nutzlasten ein kleineres Symbol
+ * heraus als der Bildschirm zeigt.
  */
 export declare function qrCodeBytes(text: string, options?: {
     size?: QrSize;
@@ -266,8 +274,8 @@ export declare function qrCodeBytes(text: string, options?: {
  * **gerechneter** Modulgroesse, sofern `options.size` sie nicht festlegt.
  *
  * Ohne `size` entscheidet die Regel aus `qr-groesse.ts`: so gross wie
- * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = der
- * Bestandswert 4 dieses Pakets). Passt das Symbol auch mit der
+ * moeglich, gedeckelt durch `options.groesse` (Vorgabe `auto` = hoechstens 6
+ * Punkte je Modul, wie im Flutter-Zwilling). Passt das Symbol auch mit der
  * Ausnahmegroesse nicht aufs Papier, geht **kein** QR-Befehl hinaus und
  * `doc.qrFehler` sagt warum: der Drucker schneidet ein zu breites Symbol
  * nicht ab, er laesst es weg — ein Befehl, von dem man weiss, dass er nichts
@@ -300,4 +308,30 @@ export declare function qrRasterPunkte(paperSize: PosPaperSize, moduleAnzahl: nu
     groesse?: QrModulGroesse;
     ruhezoneModule?: number;
 }): number;
+/**
+ * Einfarbiges Rasterbild in Druckpunkten, zeilenweise: `punkte[y * breite + x]`,
+ * 1 = schwarz. Entsteht fuer das Firmenlogo in `logoRaster` (receipt/bild.ts).
+ */
+export interface RasterBild {
+    readonly breite: number;
+    readonly hoehe: number;
+    readonly punkte: Uint8Array;
+}
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export declare function rasterZeilenBytes(bild: RasterBild): Uint8Array;
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export declare function rasterZeilenBase64(bild: RasterBild): string;
+/**
+ * Ein Rasterbild (`GS v 0`) -- das Firmenlogo am Bon.
+ *
+ * Anders als `escPosQrRaster` folgt KEIN Zeilenvorschub: `GS v 0` schiebt das
+ * Papier um die Bildhoehe, ein LF danach waere eine zusaetzliche Leerzeile,
+ * die Bildschirm und PDF nicht haben. Die Luft um das Logo kommt aus dem Blatt.
+ */
+export declare function escPosRasterBild(doc: EscPosDocument, bild: RasterBild, options?: {
+    align?: PosAlign;
+}): void;
 export {};