@kreiseck/kasseneck-api 0.13.1 → 0.14.0

package/dist/cjs/receipt/layout-escpos.js

@@ -1,9 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.pruefeLogoRaster = pruefeLogoRaster;
+exports.blattFuerDruck = blattFuerDruck;
 exports.escPosLayoutBytes = escPosLayoutBytes;
 exports.escPosLayoutErgebnis = escPosLayoutErgebnis;
 const index_js_1 = require("../printing/index.js");
+const blatt_js_1 = require("./blatt.js");
 const grid_js_1 = require("./grid.js");
+/** Das Rasterbild muss genau so gross sein, wie das Blatt das Logo setzt -- sonst stuende am Bon ein anderes Logo als am Schirm. */
+function pruefeLogoRaster(logo, mass, zeichen) {
+    const soll = (0, blatt_js_1.logoRasterMass)(mass, zeichen);
+    if (logo.raster.breite !== soll.breite || logo.raster.hoehe !== soll.hoehe) {
+        throw new Error(`Logo-Raster ${logo.raster.breite}x${logo.raster.hoehe} passt nicht zum Blatt (${soll.breite}x${soll.hoehe})`);
+    }
+}
+/**
+ * Baut das Blatt fuer einen Druckweg (ESC/POS, ePOS) an EINER Stelle: die
+ * Zuordnung `DruckLogo` -> `BlattLogo` und die Groessenpruefung des mitgebrachten
+ * Rasterbilds teilen sich beide Wege -- ohne das muesste eine Aenderung daran an
+ * zwei Stellen nachgezogen werden. Wirft VOR jeder Ausgabe (also bevor der
+ * Aufrufer auch nur ein Byte/Zeichen geschrieben hat), wenn das Rasterbild nicht
+ * zur Logo-Stufe passt.
+ */
+function blattFuerDruck(layout, optionen) {
+    const blattOptionen = {
+        zeichen: optionen.zeichen,
+        marke: optionen.marke === true,
+        qrGroesse: optionen.qrGroesse,
+    };
+    if (optionen.logo)
+        blattOptionen.logo = { stufe: optionen.logo.stufe, pxBreite: optionen.logo.pxBreite, pxHoehe: optionen.logo.pxHoehe };
+    const blatt = (0, blatt_js_1.belegBlatt)(layout, blattOptionen);
+    const logoBlock = blatt.bloecke.find((b) => b.art === 'logo');
+    if (optionen.logo && logoBlock && logoBlock.art === 'logo')
+        pruefeLogoRaster(optionen.logo, logoBlock, blatt.zeichen);
+    return blatt;
+}
 /**
  * Druckbar gemachtes Layout: Texte durch [escPosPrintableText] (Codepage,
  * "EUR" statt "€", Striche), damit das Raster mit den Zeichen rechnet, die
@@ -72,6 +104,13 @@ function escPosLayoutErgebnis(layout, options = {}) {
      * `qrFehler` aus `escPosQrCode`, und der Beleg geht ohne QR hinaus.
      */
     const qrZeile = (nutzlast) => {
+        // Ein Inhalt, der in keine QR-Version passt, laesst sich weder als Befehl
+        // noch als Bild drucken -- beide Wege wuerfen. Der Beleg geht ohne QR
+        // hinaus und sagt es ueber `qrFehler`, wie das Blatt (Anteil 0).
+        if (nutzlast !== '' && !(0, index_js_1.qrPasstInVersion)(nutzlast)) {
+            doc.qrFehler = 'QR-Inhalt passt in keine QR-Version -- Beleg ohne QR';
+            return;
+        }
         const raster = options.qrMatrix;
         if (nutzlast !== '' && raster !== undefined) {
             if (modus === 'imageRaster') {
@@ -98,27 +137,28 @@ function escPosLayoutErgebnis(layout, options = {}) {
         }
         (0, index_js_1.escPosQrCode)(doc, nutzlast, qrOptionen);
     };
-    const grid = (0, grid_js_1.renderReceiptGrid)(druckbaresLayout(layout), { zeichen: grid_js_1.ZEICHEN_JE_PAPIER[paperSize] });
-    for (const zeile of grid.lines) {
-        switch (zeile.kind) {
-            case 'space':
-                (0, index_js_1.escPosFeed)(doc, 1);
-                break;
+    // `blattFuerDruck` prueft das Logo-Raster bereits VOR der Rueckgabe -- die
+    // Schleife unten schreibt darum nie ein Byte auf ein falsch grosses Logo.
+    const blatt = blattFuerDruck(druckbaresLayout(layout), {
+        zeichen: grid_js_1.ZEICHEN_JE_PAPIER[paperSize],
+        logo: options.logo,
+        marke: options.marke,
+        qrGroesse: options.qrGroesse ?? 'auto',
+    });
+    for (const block of blatt.bloecke) {
+        switch (block.art) {
             case 'qr':
-                qrZeile(zeile.qr ?? '');
+                qrZeile(block.nutzlast);
                 break;
-            case 'banner': {
-                // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
-                // Stil wie im Beleg-Viewer und im PDF (frueher druckte der Bon invers
-                // weiss-auf-schwarz und sah damit anders aus als jede Anzeige).
-                const rahmen = '='.repeat(grid_js_1.ZEICHEN_JE_PAPIER[paperSize]);
-                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2 } });
-                (0, index_js_1.escPosText)(doc, rahmen, { styles: { align: 'left', bold: true } });
+            case 'logo':
+                if (options.logo)
+                    (0, index_js_1.escPosRasterBild)(doc, options.logo.raster, { align: 'center' });
                 break;
-            }
-            default:
-                (0, index_js_1.escPosText)(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: zeile.bold } });
+            case 'zeile':
+                if (block.leer)
+                    (0, index_js_1.escPosFeed)(doc, 1);
+                else
+                    (0, index_js_1.escPosText)(doc, block.text.trimEnd(), { styles: { align: 'left', bold: block.fett } });
                 break;
         }
     }

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

@@ -43,7 +43,7 @@
  * });
  * ```
  *
- * 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 zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */

package/dist/cjs/register/index.js

@@ -44,7 +44,7 @@
  * });
  * ```
  *
- * 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 zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */

package/dist/cjs/register/pairing.d.ts

@@ -188,9 +188,9 @@ export interface RegisterUser {
 /** Ergebnis der PIN-Anmeldung. */
 export interface RegisterUserSession {
     /**
-     * Firebase-Custom-Token. Damit meldet der Verbraucher sich bei Firebase an
+     * Custom-Token des Anmeldediensts. Damit meldet der Verbraucher sich dort an
      * und bekommt das ID-Token, das `registerUserAuth` braucht; dieses Paket
-     * kennt Firebase nicht.
+     * kennt den Anmeldedienst nicht.
      */
     customToken: string;
     /** Laufende Sitzung — Kopfzeile `register-session` jedes weiteren Aufrufs. */

package/dist/esm/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/esm/client/auth.js

@@ -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.
  */

package/dist/esm/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/esm/client/cashregisters.js

@@ -5,7 +5,7 @@ import { KasseneckValidationError } from './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/esm/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/esm/client/errors.js

@@ -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,
@@ -56,7 +56,7 @@
  */
 // 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/esm/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/esm/client/receipts.js

@@ -202,7 +202,7 @@ export 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.
@@ -567,5 +567,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/esm/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/esm/client/transport.js

@@ -7,7 +7,7 @@ import { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNet
  * 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-
@@ -76,7 +76,7 @@ function createCore(options) {
                     throw new 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 KasseneckAuthError ? ursache.reason : 'Anmeldung fehlgeschlagen';
                 throw new KasseneckAuthError(grund, { functionName: fehlerName });

package/dist/esm/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/esm/kasse/drucker.js

@@ -1,3 +1,4 @@
+import { rasterZeilenBase64 } from '../printing/index.js';
 const text = (v) => (typeof v === 'string' && v ? v : null);
 const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
 export async function listMyPrinters(rufen) {
@@ -22,6 +23,14 @@ export 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: 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/esm/kasse/settings.js

@@ -112,8 +112,11 @@ export const KASSE_TASTEN_STANDARD = Object.freeze({
     korbLeeren: ['Mod+C'],
 });
 export const 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/esm/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/esm/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/esm/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 {};

package/dist/esm/printing/escpos.js

@@ -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 { QR_DRUCK_PUNKTE, QR_MINDEST_PUNKTE, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, qrGroesseFuer, } from './qr-groesse.js';
 // -------------------------------------------------------------- Befehlsbytes
@@ -581,13 +582,19 @@ export function escPosRow(doc, columns) {
  * 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 function qrCodeBytes(text, options = {}) {
     const size = options.size ?? 4;
     if (!istGanzzahl(size) || size < 1 || size > 8) {
         throw new Error('QR-Modulgroesse muss eine Ganzzahl im Bereich 1..8 sein');
     }
-    const correction = options.correction ?? 'L';
+    const correction = options.correction ?? 'M';
     const stufe = QR_KORREKTUR[correction];
     if (stufe === undefined) {
         throw new Error(`Unbekannte QR-Fehlerkorrektur: ${String(correction)}`);
@@ -628,8 +635,8 @@ export function qrCodeBytes(text, 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
@@ -714,9 +721,10 @@ export function escPosQrRaster(doc, matrix, options = {}) {
     if (!istGanzzahl(punkte) || punkte < 1) {
         throw new Error('punkteJeModul muss eine Ganzzahl >= 1 sein');
     }
+    // Modulraster (samt Ruhezone) auf Druckpunkte skaliert -- dieselbe Bitquelle
+    // wie das Logo, nur aus einem QR-Modul-Bool statt aus Graustufen gewonnen.
     const breite = gesamtModule * punkte;
-    const byteJeZeile = Math.ceil(breite / 8);
-    const daten = new Uint8Array(byteJeZeile * breite);
+    const bildpunkte = new Uint8Array(breite * breite);
     for (let y = 0; y < breite; y++) {
         const modulY = Math.floor(y / punkte) - ruhezone;
         if (modulY < 0 || modulY >= module)
@@ -728,18 +736,14 @@ export function escPosQrRaster(doc, matrix, options = {}) {
                 continue;
             if (zeile[modulX] !== true)
                 continue;
-            const i = y * byteJeZeile + (x >> 3);
-            daten[i] = daten[i] | (0x80 >> (x & 7));
+            bildpunkte[y * breite + x] = 1;
         }
     }
+    const daten = rasterZeilenBytes({ breite, hoehe: breite, punkte: bildpunkte });
     escPosSetStyles(doc, { align: options.align ?? 'center' });
     // GS v 0 m xL xH yL yH d1...dk — m = 0: normale Dichte, 1:1.
-    anhaengen(doc, [
-        GS, 0x76, 0x30, 0x00,
-        byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff,
-        breite & 0xff, (breite >> 8) & 0xff,
-        ...daten,
-    ]);
+    anhaengen(doc, rasterBildKopf(breite, breite));
+    anhaengen(doc, daten);
     anhaengen(doc, [ZEILENUMBRUCH]);
     if ((options.align ?? 'center') !== 'left') {
         escPosSetStyles(doc, { align: 'left' });
@@ -755,3 +759,68 @@ export function qrRasterPunkte(paperSize, moduleAnzahl, options = {}) {
     const deckel = QR_MODUL_DECKEL[options.groesse ?? 'auto'];
     return Math.max(1, Math.min(deckel, Math.floor(QR_DRUCK_PUNKTE[paperSize] / (moduleAnzahl + 2 * ruhezone))));
 }
+/** Die Rasterzeilen als Bytes: MSB zuerst, jede Zeile auf volle Bytes aufgefuellt. */
+export function rasterZeilenBytes(bild) {
+    if (!istGanzzahl(bild.breite) || bild.breite < 1 || !istGanzzahl(bild.hoehe) || bild.hoehe < 1) {
+        throw new Error('Rasterbild ohne gueltiges Mass');
+    }
+    if (bild.punkte.length !== bild.breite * bild.hoehe)
+        throw new Error('Rasterbild: Punkte passen nicht zum Mass');
+    const byteJeZeile = Math.ceil(bild.breite / 8);
+    const daten = new Uint8Array(byteJeZeile * bild.hoehe);
+    for (let y = 0; y < bild.hoehe; y++) {
+        for (let x = 0; x < bild.breite; x++) {
+            if (bild.punkte[y * bild.breite + x] !== 1)
+                continue;
+            const i = y * byteJeZeile + (x >> 3);
+            daten[i] = daten[i] | (0x80 >> (x & 7));
+        }
+    }
+    return daten;
+}
+/**
+ * Die Rasterzeilen als Base64 -- ohne Buffer, laeuft im Browser und in Node.
+ * Eine Stelle fuer ePOS-`<image>` und den Druckjob an den Server.
+ */
+export function rasterZeilenBase64(bild) {
+    const bytes = rasterZeilenBytes(bild);
+    let binaer = '';
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        binaer += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return btoa(binaer);
+}
+/**
+ * Der `GS v 0`-Kopf (Byte-Breite, Zeilenhoehe) -- die Rasterzeilen selbst
+ * haengt der Aufrufer an. Gemeinsame Rahmung fuer das Logo (`escPosRasterBild`)
+ * und den QR-Bildweg (`escPosQrRaster`): beide drucken dasselbe Bildkommando,
+ * nur mit unterschiedlichem Nachlauf (Zeilenvorschub ja/nein).
+ */
+function rasterBildKopf(breite, hoehe) {
+    const byteJeZeile = Math.ceil(breite / 8);
+    return [GS, 0x76, 0x30, 0x00, byteJeZeile & 0xff, (byteJeZeile >> 8) & 0xff, hoehe & 0xff, (hoehe >> 8) & 0xff];
+}
+/**
+ * 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 function escPosRasterBild(doc, bild, options = {}) {
+    // Masse pruefen, BEVOR gepackt wird: ein zu breites Bild soll nicht erst
+    // Speicher fuer seine Rasterzeilen belegen. `GS v 0` traegt die Hoehe in zwei
+    // Bytes (yL yH) -- ueber 65535 Punkte liefe sie still ueber und der Drucker
+    // laese den Rest des Bilds als Befehle.
+    if (bild.breite > QR_DRUCK_PUNKTE[doc.paperSize])
+        throw new Error('Rasterbild breiter als der Druckkopf');
+    if (bild.hoehe > 0xffff)
+        throw new Error('Rasterbild hoeher als 65535 Punkte');
+    const daten = rasterZeilenBytes(bild);
+    escPosSetStyles(doc, { align: options.align ?? 'center' });
+    anhaengen(doc, rasterBildKopf(bild.breite, bild.hoehe));
+    anhaengen(doc, daten);
+    if ((options.align ?? 'center') !== 'left') {
+        escPosSetStyles(doc, { align: 'left' });
+    }
+}

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

@@ -1,4 +1,4 @@
-export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type PosCodeTable, type PosTextSize, type QrSize, type QrCorrection, type QrMatrix, type PosStyles, type PosColumn, type EscPosOptions, type EscPosTextOptions, type EscPosHrOptions, type EscPosQrOptions, type EscPosQrRasterOptions, type EscPosDocument, createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, type RasterBild, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { type QrModulGroesse, type QrGroesse, QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';

package/dist/esm/printing/index.js

@@ -1,4 +1,4 @@
-export { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
-export { QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
+export { createEscPosDocument, escPosBytes, escPosReset, escPosSetGlobalCodeTable, escPosSetGlobalFont, escPosSetStyles, escPosText, escPosEmptyLines, escPosFeed, escPosCut, escPosHr, escPosRow, escPosQrCode, escPosQrRaster, qrRasterPunkte, rasterZeilenBytes, rasterZeilenBase64, escPosRasterBild, encodeEscPosText, qrCodeBytes, escPosMaxCharsPerLine, escPosWortzeilen, wortzeilenText, } from './escpos.js';
+export { QR_MODUL_DECKEL, QR_RUHEZONE_MODULE, QR_MINDEST_PUNKTE, QR_AUSNAHME_PUNKTE, QR_HOECHST_PUNKTE, QR_DRUCK_PUNKTE, qrModulAnzahl, qrPasstInVersion, qrGroesseBerechnen, qrGroesseFuer, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
 export { USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';