@kreiseck/kasseneck-api 0.13.2 → 0.15.0

package/dist/cjs/receipt/epos.d.ts

@@ -1,11 +1,12 @@
 import type { ReceiptLayout } from './layout.js';
 import type { PosPaperSize } from '../printing/escpos.js';
-import { type QrModulGroesse } from '../printing/index.js';
+import { type QrModulGroesse, type RasterBild } from '../printing/index.js';
+import { type DruckLogo } from './layout-escpos.js';
 /**
  * ePOS-Print XML (Epson TM-Drucker: Server Direct Print, ePOS-Print ueber
  * HTTP) -- **aus dem Zeichenraster**: jede Rasterzeile wird eine <text>-Zeile
- * mit exakt N Zeichen und Zeilenumbruch, Aufdrucke doppelt hoch (Warnungen
- * invers), QR als <symbol>, Leerraum als <feed>, am Ende Schnitt. Kein
+ * mit exakt N Zeichen und Zeilenumbruch, Aufdrucke als Rahmen aus
+ * Rasterzeilen, QR als <symbol>, Leerraum als <feed>, am Ende Schnitt. Kein
  * eigenes Setzen -- was Bildschirm, ESC/POS und PDF zeigen, druckt der Epson
  * Zeile fuer Zeile genauso.
  *
@@ -22,16 +23,20 @@ export interface EposPrintXmlOptions {
      */
     qrBreite?: number;
     /**
-     * Deckel fuer die gerechnete QR-Modulgroesse; Vorgabe `mittel`.
+     * Deckel fuer die gerechnete QR-Modulgroesse; Vorgabe `auto` (hoechstens 6
+     * Punkte je Modul) -- wie ESC/POS, Blatt und der Flutter-Zwilling.
      *
-     * Warum `mittel` und nicht `auto`: `auto` deckelt beim Bestandswert des
-     * **ESC/POS**-Befehls dieses Pakets (4), dieser Weg druckt aber seit jeher
-     * mit 6. Die Vorgabe nennt den Bestandswert dieses Wegs also ausdruecklich,
-     * damit ohne Wahl kein Byte anders herauskommt.
+     * Bis 0.13 stand hier `mittel`, weil `auto` damals beim ESC/POS-Wert 4
+     * deckelte und dieser Weg seit jeher mit 6 druckt. Seit `auto` ueberall 6
+     * heisst, ist das derselbe Wert: ohne Wahl kommt kein Byte anders heraus.
      */
     qrGroesse?: QrModulGroesse;
     /** Papierschnitt am Ende, Vorgabe true. */
     cut?: boolean;
+    /** Firmenlogo; ohne Angabe kein Logo. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende. */
+    marke?: boolean;
 }
 /**
  * Das XML **samt** dem, was dem QR unterwegs zugestossen ist -- dieselbe
@@ -45,6 +50,8 @@ export interface EposPrintErgebnis {
     qrAusweich: string | null;
 }
 export declare function eposXmlEscape(text: string): string;
+/** Ein Rasterbild als ePOS-`<image>` (einfarbig, Punktmass, Rasterzeilen Base64). */
+export declare function eposBildXml(bild: RasterBild): string;
 /** Nur das XML; wer die QR-Meldungen braucht, nimmt [eposPrintXmlErgebnis]. */
 export declare function eposPrintXml(layout: ReceiptLayout, options?: EposPrintXmlOptions): string;
 /**
@@ -77,6 +84,10 @@ export interface EposDirectOptions {
     qrBreite?: number;
     /** Deckel fuer die gerechnete QR-Modulgroesse; siehe [EposPrintXmlOptions.qrGroesse]. */
     qrGroesse?: QrModulGroesse;
+    /** Firmenlogo; ohne Angabe kein Logo. */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende. */
+    marke?: boolean;
     timeoutMs?: number;
 }
 export interface EposResponse {

package/dist/cjs/receipt/epos.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EposConnectionError = void 0;
 exports.eposXmlEscape = eposXmlEscape;
+exports.eposBildXml = eposBildXml;
 exports.eposPrintXml = eposPrintXml;
 exports.eposPrintXmlErgebnis = eposPrintXmlErgebnis;
 exports.eposServiceUrl = eposServiceUrl;
@@ -11,9 +12,14 @@ exports.eposDirectPrint = eposDirectPrint;
 exports.eposDirectStatus = eposDirectStatus;
 const index_js_1 = require("../printing/index.js");
 const grid_js_1 = require("./grid.js");
+const layout_escpos_js_1 = require("./layout-escpos.js");
 function eposXmlEscape(text) {
     return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
 }
+/** Ein Rasterbild als ePOS-`<image>` (einfarbig, Punktmass, Rasterzeilen Base64). */
+function eposBildXml(bild) {
+    return `<image width="${bild.breite}" height="${bild.hoehe}" color="color_1" mode="mono">${(0, index_js_1.rasterZeilenBase64)(bild)}</image>`;
+}
 const NS = 'http://www.epson-pos.com/schemas/2011/03/epos-print';
 /** Nur das XML; wer die QR-Meldungen braucht, nimmt [eposPrintXmlErgebnis]. */
 function eposPrintXml(layout, options = {}) {
@@ -30,8 +36,9 @@ function eposPrintXml(layout, options = {}) {
  * laesst es weg; genau daran fehlte am echten Beleg der QR.
  */
 function eposPrintXmlErgebnis(layout, options = {}) {
-    const grid = (0, grid_js_1.renderReceiptGrid)(layout, { zeichen: options.zeichen ?? grid_js_1.ZEICHEN_JE_PAPIER[layout.paperSize] });
-    const deckel = options.qrGroesse ?? 'mittel';
+    const zeichen = options.zeichen ?? grid_js_1.ZEICHEN_JE_PAPIER[layout.paperSize];
+    const deckel = options.qrGroesse ?? 'auto';
+    const blatt = (0, layout_escpos_js_1.blattFuerDruck)(layout, { zeichen, logo: options.logo, marke: options.marke, qrGroesse: deckel });
     const fest = options.qrBreite === undefined
         ? null
         : Math.min(16, Math.max(3, Math.floor(options.qrBreite)));
@@ -50,6 +57,12 @@ function eposPrintXmlErgebnis(layout, options = {}) {
             return fest;
         if (nutzlast === '')
             return index_js_1.QR_MODUL_DECKEL[deckel];
+        // Passt der Inhalt in keine QR-Version, gibt es kein Symbol, das der
+        // Drucker setzen koennte -- wie beim Blatt (Anteil 0) geht der Beleg ohne QR.
+        if (!(0, index_js_1.qrPasstInVersion)(nutzlast)) {
+            qrFehler = 'QR-Inhalt passt in keine QR-Version -- Beleg ohne QR';
+            return null;
+        }
         const mass = (0, index_js_1.qrGroesseFuer)({
             nutzlast,
             papierbreitePunkte: index_js_1.QR_DRUCK_PUNKTE[layout.paperSize],
@@ -74,32 +87,34 @@ function eposPrintXmlErgebnis(layout, options = {}) {
     out.push('<text font="font_a"/>');
     out.push('<text align="left"/>');
     out.push('<text width="1" height="1" reverse="false" em="false"/>');
-    for (const z of grid.lines) {
-        switch (z.kind) {
-            case 'space':
-                out.push('<feed line="1"/>');
+    for (const block of blatt.bloecke) {
+        switch (block.art) {
+            case 'zeile':
+                if (block.leer)
+                    out.push('<feed line="1"/>');
+                else if (block.fett) {
+                    out.push(`<text em="true">${eposXmlEscape(block.text)}&#10;</text>`);
+                    out.push('<text em="false"/>');
+                }
+                else
+                    out.push(`<text>${eposXmlEscape(block.text)}&#10;</text>`);
+                break;
+            case 'logo':
+                if (options.logo) {
+                    out.push('<text align="center"/>');
+                    out.push(eposBildXml(options.logo.raster));
+                    out.push('<text align="left"/>');
+                }
                 break;
             case 'qr': {
-                const breite = qrBreiteFuer(z.qr ?? '');
+                const breite = qrBreiteFuer(block.nutzlast);
                 if (breite === null)
                     break;
                 out.push('<text align="center"/>');
-                out.push(`<symbol type="qrcode_model_2" level="level_m" width="${breite}" height="0" size="0">${eposXmlEscape(z.qr ?? '')}</symbol>`);
+                out.push(`<symbol type="qrcode_model_2" level="level_m" width="${breite}" height="0" size="0">${eposXmlEscape(block.nutzlast)}</symbol>`);
                 out.push('<text align="left"/>');
                 break;
             }
-            case 'banner':
-                out.push(`<text width="1" height="2" reverse="${z.ton === 'warnung' ? 'true' : 'false'}" em="true">${eposXmlEscape(z.text)}&#10;</text>`);
-                out.push('<text width="1" height="1" reverse="false" em="false"/>');
-                break;
-            default:
-                if (z.bold)
-                    out.push(`<text em="true">${eposXmlEscape(z.text)}&#10;</text>`);
-                else
-                    out.push(`<text>${eposXmlEscape(z.text)}&#10;</text>`);
-                if (z.bold)
-                    out.push('<text em="false"/>');
-                break;
         }
     }
     if (options.cut !== false) {
@@ -220,6 +235,10 @@ function eposDirectPrint(layout, o, fetchFn = fetch) {
         xmlOptionen.qrBreite = o.qrBreite;
     if (o.qrGroesse !== undefined)
         xmlOptionen.qrGroesse = o.qrGroesse;
+    if (o.logo)
+        xmlOptionen.logo = o.logo;
+    if (o.marke !== undefined)
+        xmlOptionen.marke = o.marke;
     return eposDirectSend(eposPrintXml({ ...layout, paperSize: papier }, xmlOptionen), o, fetchFn);
 }
 /** Verbindungstest: leeres Dokument, druckt nichts, liefert den Druckerstatus. */

package/dist/cjs/receipt/grid.d.ts

@@ -27,7 +27,7 @@ export interface GridLine {
     text: string;
     kind: GridLineKind;
     bold: boolean;
-    /** Bei `banner`: `warnung` = invers/auffaellig, `belegart` = Rahmen. */
+    /** Bei `banner` (Rahmen- und Textzeilen): `warnung` = Test/Ausfall, `belegart` = Storno, Nullbeleg … */
     ton?: 'belegart' | 'warnung';
     /** Bei `qr`: die Nutzlast. */
     qr?: string;

package/dist/cjs/receipt/grid.js

@@ -67,10 +67,18 @@ function renderReceiptGrid(layout, options = {}) {
                 for (const t of (0, escpos_js_1.wortzeilenText)(z.text, zeichen))
                     lines.push({ text: ausrichten(t, zeichen, z.align), kind: 'text', bold: z.bold });
                 break;
-            case 'banner':
+            case 'banner': {
+                // Der Rahmen ist Teil des Rasters: eine Zeile '=' ueber die volle Breite
+                // davor und danach. So setzt ihn jeder Weg -- Bildschirm, Bon, ePOS, PDF,
+                // myPOS -- Zeichen fuer Zeichen gleich. Vorher zeichnete jeder Weg seinen
+                // eigenen Rahmen (Rechteck, doppelt hoch, invers, gefuellt).
+                const rahmen = '='.repeat(zeichen);
+                lines.push({ text: rahmen, kind: 'banner', bold: true, ton: z.ton });
                 for (const t of (0, escpos_js_1.wortzeilenText)(z.text, zeichen))
                     lines.push({ text: ausrichten(t, zeichen, 'center'), kind: 'banner', bold: true, ton: z.ton });
+                lines.push({ text: rahmen, kind: 'banner', bold: true, ton: z.ton });
                 break;
+            }
             case 'rule':
                 lines.push({ text: (z.char || '-').charAt(0).repeat(zeichen), kind: 'rule', bold: false });
                 break;

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

@@ -1,4 +1,6 @@
 export { type LayoutAlign, type LayoutColumn, type LayoutTextLine, type LayoutColumnsLine, type LayoutRuleLine, type LayoutSpaceLine, type LayoutQrLine, type LayoutLine, type ReceiptLayout, type BuildReceiptLayoutOptions, buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, type Pruefangaben, AKTUELLES_REGELWERK, type LayoutBannerLine, type LayoutRegelwerk, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
-export { type EscPosLayoutOptions, type EscPosLayoutErgebnis, type QrPrintMode, escPosLayoutBytes, escPosLayoutErgebnis, } from './layout-escpos.js';
+export { type EscPosLayoutOptions, type EscPosLayoutErgebnis, type QrPrintMode, type DruckLogo, pruefeLogoRaster, escPosLayoutBytes, escPosLayoutErgebnis, } from './layout-escpos.js';
 export { type GridLine, type GridLineKind, type ReceiptGrid, type RenderReceiptGridOptions, renderReceiptGrid, gridSpaltenBreiten, gridAlsText, ZEICHEN_JE_PAPIER, } from './grid.js';
-export { type EposPrintXmlOptions, type EposPrintErgebnis, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlErgebnis, eposXmlEscape, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type EposPrintXmlOptions, type EposPrintErgebnis, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlErgebnis, eposXmlEscape, eposBildXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type LogoStufe, type BlattLogo, type LogoMass, type BlattBlock, type BelegBlatt, type BelegBlattOptionen, LOGO_STUFEN, LOGO_PIXEL_MAX, PUNKTE_JE_ZEICHEN, PUNKTE_JE_ZEILE, MARKE_TEXT, papierFuerZeichen, logoMass, logoPixelZulaessig, logoRasterMass, qrBlattAnteil, belegBlatt, } from './blatt.js';
+export { logoRaster } from './bild.js';

package/dist/cjs/receipt/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposXmlEscape = exports.eposPrintXmlErgebnis = exports.eposPrintXml = exports.EposConnectionError = exports.ZEICHEN_JE_PAPIER = exports.gridAlsText = exports.gridSpaltenBreiten = exports.renderReceiptGrid = exports.escPosLayoutErgebnis = exports.escPosLayoutBytes = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.AKTUELLES_REGELWERK = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.logoRaster = exports.belegBlatt = exports.qrBlattAnteil = exports.logoRasterMass = exports.logoPixelZulaessig = exports.logoMass = exports.papierFuerZeichen = exports.MARKE_TEXT = exports.PUNKTE_JE_ZEILE = exports.PUNKTE_JE_ZEICHEN = exports.LOGO_PIXEL_MAX = exports.LOGO_STUFEN = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposBildXml = exports.eposXmlEscape = exports.eposPrintXmlErgebnis = exports.eposPrintXml = exports.EposConnectionError = exports.ZEICHEN_JE_PAPIER = exports.gridAlsText = exports.gridSpaltenBreiten = exports.renderReceiptGrid = exports.escPosLayoutErgebnis = exports.escPosLayoutBytes = exports.pruefeLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.AKTUELLES_REGELWERK = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -13,6 +13,7 @@ Object.defineProperty(exports, "AKTUELLES_REGELWERK", { enumerable: true, get: f
 Object.defineProperty(exports, "SMALL_BUSINESS_NOTICE", { enumerable: true, get: function () { return layout_js_1.SMALL_BUSINESS_NOTICE; } });
 Object.defineProperty(exports, "formatCents", { enumerable: true, get: function () { return layout_js_1.formatCents; } });
 var layout_escpos_js_1 = require("./layout-escpos.js");
+Object.defineProperty(exports, "pruefeLogoRaster", { enumerable: true, get: function () { return layout_escpos_js_1.pruefeLogoRaster; } });
 Object.defineProperty(exports, "escPosLayoutBytes", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutBytes; } });
 Object.defineProperty(exports, "escPosLayoutErgebnis", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutErgebnis; } });
 var grid_js_1 = require("./grid.js");
@@ -25,8 +26,23 @@ Object.defineProperty(exports, "EposConnectionError", { enumerable: true, get: f
 Object.defineProperty(exports, "eposPrintXml", { enumerable: true, get: function () { return epos_js_1.eposPrintXml; } });
 Object.defineProperty(exports, "eposPrintXmlErgebnis", { enumerable: true, get: function () { return epos_js_1.eposPrintXmlErgebnis; } });
 Object.defineProperty(exports, "eposXmlEscape", { enumerable: true, get: function () { return epos_js_1.eposXmlEscape; } });
+Object.defineProperty(exports, "eposBildXml", { enumerable: true, get: function () { return epos_js_1.eposBildXml; } });
 Object.defineProperty(exports, "eposServiceUrl", { enumerable: true, get: function () { return epos_js_1.eposServiceUrl; } });
 Object.defineProperty(exports, "eposSoapEnvelope", { enumerable: true, get: function () { return epos_js_1.eposSoapEnvelope; } });
 Object.defineProperty(exports, "eposParseResponse", { enumerable: true, get: function () { return epos_js_1.eposParseResponse; } });
 Object.defineProperty(exports, "eposDirectPrint", { enumerable: true, get: function () { return epos_js_1.eposDirectPrint; } });
 Object.defineProperty(exports, "eposDirectStatus", { enumerable: true, get: function () { return epos_js_1.eposDirectStatus; } });
+var blatt_js_1 = require("./blatt.js");
+Object.defineProperty(exports, "LOGO_STUFEN", { enumerable: true, get: function () { return blatt_js_1.LOGO_STUFEN; } });
+Object.defineProperty(exports, "LOGO_PIXEL_MAX", { enumerable: true, get: function () { return blatt_js_1.LOGO_PIXEL_MAX; } });
+Object.defineProperty(exports, "PUNKTE_JE_ZEICHEN", { enumerable: true, get: function () { return blatt_js_1.PUNKTE_JE_ZEICHEN; } });
+Object.defineProperty(exports, "PUNKTE_JE_ZEILE", { enumerable: true, get: function () { return blatt_js_1.PUNKTE_JE_ZEILE; } });
+Object.defineProperty(exports, "MARKE_TEXT", { enumerable: true, get: function () { return blatt_js_1.MARKE_TEXT; } });
+Object.defineProperty(exports, "papierFuerZeichen", { enumerable: true, get: function () { return blatt_js_1.papierFuerZeichen; } });
+Object.defineProperty(exports, "logoMass", { enumerable: true, get: function () { return blatt_js_1.logoMass; } });
+Object.defineProperty(exports, "logoPixelZulaessig", { enumerable: true, get: function () { return blatt_js_1.logoPixelZulaessig; } });
+Object.defineProperty(exports, "logoRasterMass", { enumerable: true, get: function () { return blatt_js_1.logoRasterMass; } });
+Object.defineProperty(exports, "qrBlattAnteil", { enumerable: true, get: function () { return blatt_js_1.qrBlattAnteil; } });
+Object.defineProperty(exports, "belegBlatt", { enumerable: true, get: function () { return blatt_js_1.belegBlatt; } });
+var bild_js_1 = require("./bild.js");
+Object.defineProperty(exports, "logoRaster", { enumerable: true, get: function () { return bild_js_1.logoRaster; } });

package/dist/cjs/receipt/layout-escpos.d.ts

@@ -1,5 +1,6 @@
-import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize } from '../printing/index.js';
+import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize, type RasterBild } from '../printing/index.js';
 import type { ReceiptLayout } from './layout.js';
+import { type BelegBlatt, type LogoStufe, type LogoMass } from './blatt.js';
 /**
  * Bruecke vom Layout-Modell zu ESC/POS-Bytes — der Bondrucker-Ausgabeweg.
  *
@@ -28,6 +29,29 @@ import type { ReceiptLayout } from './layout.js';
  *                   (`qrMatrix`), weil dieses Paket keine QR-Codes rechnet.
  */
 export type QrPrintMode = 'native' | 'nativeModel1' | 'imageRaster';
+/** Firmenlogo fuer den Druck: Stufe, Pixelmass des Originals und das fertige Rasterbild (`logoRaster`). */
+export interface DruckLogo {
+    stufe: LogoStufe;
+    pxBreite: number;
+    pxHoehe: number;
+    raster: RasterBild;
+}
+/** Das Rasterbild muss genau so gross sein, wie das Blatt das Logo setzt -- sonst stuende am Bon ein anderes Logo als am Schirm. */
+export declare function pruefeLogoRaster(logo: DruckLogo, mass: LogoMass, zeichen: number): void;
+/**
+ * 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.
+ */
+export declare function blattFuerDruck(layout: ReceiptLayout, optionen: {
+    zeichen: number;
+    logo?: DruckLogo | null;
+    marke?: boolean;
+    qrGroesse: QrModulGroesse;
+}): BelegBlatt;
 export interface EscPosLayoutOptions {
     /** Papierbreite; Vorgabe ist die des Layouts (dessen Spaltenbreiten daran haengen). */
     paperSize?: PosPaperSize;
@@ -40,9 +64,9 @@ export interface EscPosLayoutOptions {
      * dann passt der Aufrufer selbst auf, dass das Symbol aufs Papier geht.
      */
     qrSize?: QrSize;
-    /** Fehlerkorrekturstufe des QR-Codes. */
+    /** Fehlerkorrekturstufe des QR-Codes; Vorgabe `M` (wie ePOS, Bildweg und Blatt). */
     qrCorrection?: QrCorrection;
-    /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto`. */
+    /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto` (hoechstens 6 Punkte je Modul). */
     qrGroesse?: QrModulGroesse;
     /** Druckweg des QR; Vorgabe `native` (der Bestandsweg). */
     qrModus?: QrPrintMode;
@@ -54,6 +78,10 @@ export interface EscPosLayoutOptions {
      * aus der QR-Bibliothek, die er ohnehin fuer den Bildschirm benutzt.
      */
     qrMatrix?: (nutzlast: string) => QrMatrix;
+    /** Firmenlogo; ohne Angabe kein Logo (Bestand). */
+    logo?: DruckLogo | null;
+    /** "erstellt mit Kasseneck" am Ende (Konto-Flag `kreiseck_logo`). */
+    marke?: boolean;
 }
 /**
  * Der Bytestrom **samt** dem, was dem QR unterwegs zugestossen ist.

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/rechnung/api.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Fassade ueber den Aufrufen der Rechnungs-API: Schluessel einmal binden, dann rufen.
+ *
+ * Wie [createPartnerApi] bewusst **keine** Klasse — die Aufrufe sind freie
+ * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
+ */
+import { type FetchLike } from '../client/transport.js';
+import type { EInvoiceFormat } from './vertrag.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+export interface RechnungApiOptions {
+    /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
+    apiKey: string;
+    /** Abweichende Basis-URL; Vorgabe `https://api.kasseneck.at/v1`. */
+    baseUrl?: string;
+    /** Zeitlimit je Aufruf in Millisekunden. */
+    timeoutMs?: number;
+    /** Eigene `fetch`-Umsetzung (Tests, Proxys). */
+    fetch?: FetchLike;
+}
+export interface RechnungApi {
+    createCustomer(customer: CustomerInput, optionen?: {
+        idempotencyKey?: string;
+    }): Promise<Customer>;
+    getCustomer(kennung: {
+        customerId: string;
+    } | {
+        externalId: string;
+    }): Promise<Customer>;
+    updateCustomer(customerId: string, patch: Partial<CustomerInput>): Promise<Customer>;
+    searchCustomers(suche: CustomerSearch): Promise<CustomerPage>;
+    issueInvoice(anfrage: IssueInvoiceRequest): Promise<IssueResult>;
+    cancelInvoice(anfrage: CancelInvoiceRequest): Promise<CancelResult>;
+    createCreditNote(anfrage: CreditNoteRequest): Promise<CreditNoteResult>;
+    getInvoice(kennung: {
+        invoiceId: string;
+    } | {
+        number: string;
+    }): Promise<InvoiceDetail>;
+    listInvoices(abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+    getInvoicePdf(invoiceId: string): Promise<Uint8Array>;
+    getInvoiceXml(invoiceId: string, format?: EInvoiceFormat): Promise<string>;
+}
+export declare function createRechnungApi(optionen: RechnungApiOptions): RechnungApi;

package/dist/cjs/rechnung/api.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Fassade ueber den Aufrufen der Rechnungs-API: Schluessel einmal binden, dann rufen.
+ *
+ * Wie [createPartnerApi] bewusst **keine** Klasse — die Aufrufe sind freie
+ * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRechnungApi = createRechnungApi;
+const transport_js_1 = require("../client/transport.js");
+const auth_js_1 = require("./auth.js");
+const endpunkte_js_1 = require("./endpunkte.js");
+function createRechnungApi(optionen) {
+    const transportOptionen = {
+        auth: (0, auth_js_1.rechnungKeyAuth)({ apiKey: optionen.apiKey }),
+        baseUrl: optionen.baseUrl,
+        timeoutMs: optionen.timeoutMs,
+        fetch: optionen.fetch,
+    };
+    const rufen = (0, transport_js_1.createTransport)(transportOptionen);
+    const rufenBinaer = (0, transport_js_1.createBinaryTransport)(transportOptionen);
+    return {
+        createCustomer: (customer, o) => (0, endpunkte_js_1.createCustomer)(rufen, customer, o),
+        getCustomer: (kennung) => (0, endpunkte_js_1.getCustomer)(rufen, kennung),
+        updateCustomer: (id, patch) => (0, endpunkte_js_1.updateCustomer)(rufen, id, patch),
+        searchCustomers: (suche) => (0, endpunkte_js_1.searchCustomers)(rufen, suche),
+        issueInvoice: (anfrage) => (0, endpunkte_js_1.issueInvoice)(rufen, anfrage),
+        cancelInvoice: (anfrage) => (0, endpunkte_js_1.cancelInvoice)(rufen, anfrage),
+        createCreditNote: (anfrage) => (0, endpunkte_js_1.createCreditNote)(rufen, anfrage),
+        getInvoice: (kennung) => (0, endpunkte_js_1.getInvoice)(rufen, kennung),
+        listInvoices: (abfrage) => (0, endpunkte_js_1.listInvoices)(rufen, abfrage),
+        getInvoicePdf: (id) => (0, endpunkte_js_1.getInvoicePdf)(rufenBinaer, id),
+        getInvoiceXml: (id, format) => (0, endpunkte_js_1.getInvoiceXml)(rufen, id, format),
+    };
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Anmeldung fuer die Rechnungs-API: der `api_key` des Kontos als Bearer.
+ *
+ * Anders als `apiKeyAuth` **ohne** `cashregister-token` — eine Rechnung
+ * entsteht nicht an einer Kasse, sondern am Konto.
+ *
+ * **Der Schluessel gehoert auf einen Server.** Mit ihm entstehen festgeschriebene
+ * Rechnungen mit fortlaufender Nummer, die sich nur noch per Gutschrift
+ * korrigieren lassen.
+ *
+ * Geprueft wird nur, was ohne Netz sicher falsch ist: ein leerer Wert, ein
+ * Partner-Schluessel (`pk_…`) oder ein Kassen-Token (`cb_…`). Die Form des
+ * Kontoschluessels selbst bleibt offen, weil das Backend neben `kr_<env>_…`
+ * weiterhin aeltere Formen annimmt. Die Meldung nennt nie den Wert, nur seine Art.
+ */
+import type { KasseneckAuth } from '../client/auth.js';
+export interface RechnungKeyAuthOptions {
+    /** `api_key` des Kontos, z. B. `kr_live_…` oder `kr_test_…`. */
+    apiKey: string;
+}
+export declare function rechnungKeyAuth(options: RechnungKeyAuthOptions): KasseneckAuth;

package/dist/cjs/rechnung/auth.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Anmeldung fuer die Rechnungs-API: der `api_key` des Kontos als Bearer.
+ *
+ * Anders als `apiKeyAuth` **ohne** `cashregister-token` — eine Rechnung
+ * entsteht nicht an einer Kasse, sondern am Konto.
+ *
+ * **Der Schluessel gehoert auf einen Server.** Mit ihm entstehen festgeschriebene
+ * Rechnungen mit fortlaufender Nummer, die sich nur noch per Gutschrift
+ * korrigieren lassen.
+ *
+ * Geprueft wird nur, was ohne Netz sicher falsch ist: ein leerer Wert, ein
+ * Partner-Schluessel (`pk_…`) oder ein Kassen-Token (`cb_…`). Die Form des
+ * Kontoschluessels selbst bleibt offen, weil das Backend neben `kr_<env>_…`
+ * weiterhin aeltere Formen annimmt. Die Meldung nennt nie den Wert, nur seine Art.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rechnungKeyAuth = rechnungKeyAuth;
+const errors_js_1 = require("../client/errors.js");
+function rechnungKeyAuth(options) {
+    const schluessel = typeof options?.apiKey === 'string' ? options.apiKey.trim() : '';
+    if (!schluessel) {
+        throw new errors_js_1.KasseneckAuthError('rechnungKeyAuth: apiKey fehlt');
+    }
+    if (/^pk_(live|test)_/i.test(schluessel)) {
+        throw new errors_js_1.KasseneckAuthError('rechnungKeyAuth: das ist ein Partner-Schluessel (pk_…) — die Rechnungs-API nimmt den api_key des Kontos (kr_…)');
+    }
+    if (/^cb_(live|test)_/i.test(schluessel)) {
+        throw new errors_js_1.KasseneckAuthError('rechnungKeyAuth: das ist ein Kassen-Token (cb_…) — die Rechnungs-API nimmt den api_key des Kontos (kr_…)');
+    }
+    // Pro Aufruf ein frisches Objekt, wie bei den anderen Anmeldungen.
+    return () => ({
+        headers: { Authorization: `Bearer ${schluessel}` },
+        params: {},
+    });
+}

package/dist/cjs/rechnung/endpunkte.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Die Aufrufe der Rechnungs-API — Kunden, Rechnungen, Gutschriften, Dateien.
+ *
+ * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
+ * importierbar; die Fassade [createRechnungApi] bindet ihn nur einmal.
+ *
+ * **Geprueft wird hier nichts Fachliches.** Die Anfrage geht unveraendert an
+ * das Backend, das sie gegen denselben Vertrag prueft (`vertrag.ts`) und einen
+ * Formfehler als `validation` mit `errors[]` zurueckgibt — zwei Pruefungen
+ * hiessen zwei Wahrheiten, von denen eine veraltet.
+ *
+ * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
+ * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
+ * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ *
+ * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
+ * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
+ */
+import type { InternerBinaerTransport, InternerTransport } from '../client/aufrufe.js';
+import type { EInvoiceFormat } from './vertrag.js';
+import type { CancelInvoiceRequest, CancelResult, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, InvoiceDetail, InvoiceListQuery, InvoicePage, IssueInvoiceRequest, IssueResult } from './typen.js';
+export declare function createCustomer(rufen: InternerTransport, customer: CustomerInput, optionen?: {
+    idempotencyKey?: string;
+}): Promise<Customer>;
+export declare function getCustomer(rufen: InternerTransport, kennung: {
+    customerId: string;
+} | {
+    externalId: string;
+}): Promise<Customer>;
+export declare function updateCustomer(rufen: InternerTransport, customerId: string, patch: Partial<CustomerInput>): Promise<Customer>;
+export declare function searchCustomers(rufen: InternerTransport, suche: CustomerSearch): Promise<CustomerPage>;
+export declare function issueInvoice(rufen: InternerTransport, anfrage: IssueInvoiceRequest): Promise<IssueResult>;
+export declare function cancelInvoice(rufen: InternerTransport, anfrage: CancelInvoiceRequest): Promise<CancelResult>;
+export declare function createCreditNote(rufen: InternerTransport, anfrage: CreditNoteRequest): Promise<CreditNoteResult>;
+export declare function getInvoice(rufen: InternerTransport, kennung: {
+    invoiceId: string;
+} | {
+    number: string;
+}): Promise<InvoiceDetail>;
+export declare function listInvoices(rufen: InternerTransport, abfrage?: InvoiceListQuery): Promise<InvoicePage>;
+/** Das PDF der Rechnung (bei Gutschriften: der Gutschrift), mit eingebetteter Factur-X-Datei. */
+export declare function getInvoicePdf(rufenBinaer: InternerBinaerTransport, invoiceId: string): Promise<Uint8Array>;
+/**
+ * Die E-Rechnung als XML-Text. Sie kommt im gewohnten Umschlag (`data.xml`)
+ * und nicht als rohe Datei: so bleibt ein fachlicher Fehler
+ * (`einvoice_incomplete` mit `missing[]`) ein gewoehnlicher Fehler.
+ */
+export declare function getInvoiceXml(rufen: InternerTransport, invoiceId: string, format?: EInvoiceFormat): Promise<string>;