@kreiseck/kasseneck-api 0.9.4 → 0.11.0

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

@@ -1,5 +1,6 @@
 import type { ReceiptLayout } from './layout.js';
 import type { PosPaperSize } from '../printing/escpos.js';
+import { type QrModulGroesse } from '../printing/index.js';
 /**
  * ePOS-Print XML (Epson TM-Drucker: Server Direct Print, ePOS-Print ueber
  * HTTP) -- **aus dem Zeichenraster**: jede Rasterzeile wird eine <text>-Zeile
@@ -14,13 +15,49 @@ import type { PosPaperSize } from '../printing/escpos.js';
 export interface EposPrintXmlOptions {
     /** Zeichen je Zeile; Vorgabe nach `layout.paperSize` (32/48). */
     zeichen?: number;
-    /** QR-Modulgroesse (Epson `width` 3..16), Vorgabe 6. */
+    /**
+     * **Feste** QR-Modulgroesse (Epson `width` 3..16). Gesetzt schaltet sie die
+     * Rechnung ab -- dann passt der Aufrufer selbst auf, dass das Symbol samt
+     * Ruhezone auf die Rolle geht.
+     */
     qrBreite?: number;
+    /**
+     * Deckel fuer die gerechnete QR-Modulgroesse; Vorgabe `mittel`.
+     *
+     * 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.
+     */
+    qrGroesse?: QrModulGroesse;
     /** Papierschnitt am Ende, Vorgabe true. */
     cut?: boolean;
 }
+/**
+ * Das XML **samt** dem, was dem QR unterwegs zugestossen ist -- dieselbe
+ * Buchfuehrung wie `EscPosLayoutErgebnis` am ESC/POS-Weg.
+ */
+export interface EposPrintErgebnis {
+    xml: string;
+    /** Der Beleg ging ohne QR hinaus; das Symbol passt auch mit 3 Punkten nicht. */
+    qrFehler: string | null;
+    /** Der QR steht da, aber unter der Mindest-Modulgroesse. */
+    qrAusweich: string | null;
+}
 export declare function eposXmlEscape(text: string): string;
+/** Nur das XML; wer die QR-Meldungen braucht, nimmt [eposPrintXmlErgebnis]. */
 export declare function eposPrintXml(layout: ReceiptLayout, options?: EposPrintXmlOptions): string;
+/**
+ * Wie [eposPrintXml], gibt aber zusaetzlich zurueck, was dem QR zugestossen
+ * ist.
+ *
+ * **Die QR-Modulgroesse wird gerechnet.** Vorher stand hier fest 6, unabhaengig
+ * von der Papierbreite: ein Beleg-QR mit realer RKSV-Nutzlast hat 57 Module,
+ * mit Ruhezone 65, bei sechs Punkten also 390 Druckpunkte -- und ein
+ * 58-mm-Kopf hat 384. Der Epson schneidet ein zu breites Symbol nicht ab, er
+ * laesst es weg; genau daran fehlte am echten Beleg der QR.
+ */
+export declare function eposPrintXmlErgebnis(layout: ReceiptLayout, options?: EposPrintXmlOptions): EposPrintErgebnis;
 /**
  * Epson-Drucker mit ePOS-Print direkt aus dem Browser ansprechen (ohne
  * Server-Umweg): POST an `https://<ip>/cgi-bin/epos/service.cgi`. Der Drucker
@@ -36,6 +73,10 @@ export interface EposDirectOptions {
     devid?: string;
     /** Papier des Druckers -- bestimmt das Raster; Vorgabe: das des Layouts. */
     papier?: PosPaperSize;
+    /** Feste QR-Modulgroesse; siehe [EposPrintXmlOptions.qrBreite]. */
+    qrBreite?: number;
+    /** Deckel fuer die gerechnete QR-Modulgroesse; siehe [EposPrintXmlOptions.qrGroesse]. */
+    qrGroesse?: QrModulGroesse;
     timeoutMs?: number;
 }
 export interface EposResponse {

package/dist/cjs/receipt/epos.js

@@ -3,19 +3,71 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EposConnectionError = void 0;
 exports.eposXmlEscape = eposXmlEscape;
 exports.eposPrintXml = eposPrintXml;
+exports.eposPrintXmlErgebnis = eposPrintXmlErgebnis;
 exports.eposServiceUrl = eposServiceUrl;
 exports.eposSoapEnvelope = eposSoapEnvelope;
 exports.eposParseResponse = eposParseResponse;
 exports.eposDirectPrint = eposDirectPrint;
 exports.eposDirectStatus = eposDirectStatus;
+const index_js_1 = require("../printing/index.js");
 const grid_js_1 = require("./grid.js");
 function eposXmlEscape(text) {
     return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
 }
 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 = {}) {
+    return eposPrintXmlErgebnis(layout, options).xml;
+}
+/**
+ * Wie [eposPrintXml], gibt aber zusaetzlich zurueck, was dem QR zugestossen
+ * ist.
+ *
+ * **Die QR-Modulgroesse wird gerechnet.** Vorher stand hier fest 6, unabhaengig
+ * von der Papierbreite: ein Beleg-QR mit realer RKSV-Nutzlast hat 57 Module,
+ * mit Ruhezone 65, bei sechs Punkten also 390 Druckpunkte -- und ein
+ * 58-mm-Kopf hat 384. Der Epson schneidet ein zu breites Symbol nicht ab, er
+ * 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 qrBreite = Math.min(16, Math.max(3, Math.floor(options.qrBreite ?? 6)));
+    const deckel = options.qrGroesse ?? 'mittel';
+    const fest = options.qrBreite === undefined
+        ? null
+        : Math.min(16, Math.max(3, Math.floor(options.qrBreite)));
+    let qrFehler = null;
+    let qrAusweich = null;
+    /**
+     * Die Breite fuer eine QR-Zeile, oder `null` -- dann geht **kein** Symbol
+     * hinaus: ein Element, von dem man weiss, dass der Drucker es weglaesst,
+     * taeuscht nur einen Ausdruck vor.
+     *
+     * Eine leere Nutzlast geht unveraendert den Bestandsweg (Deckel), wie am
+     * ESC/POS-Befehl: sie ist ein Datenfehler, kein Papierfehler.
+     */
+    const qrBreiteFuer = (nutzlast) => {
+        if (fest !== null)
+            return fest;
+        if (nutzlast === '')
+            return index_js_1.QR_MODUL_DECKEL[deckel];
+        const mass = (0, index_js_1.qrGroesseFuer)({
+            nutzlast,
+            papierbreitePunkte: index_js_1.QR_DRUCK_PUNKTE[layout.paperSize],
+            groesse: deckel,
+        });
+        if (!mass.passt) {
+            qrFehler =
+                `QR mit ${mass.module} Modulen ist fuer ${layout.paperSize === 'mm58' ? 58 : 80} mm ` +
+                    `(${index_js_1.QR_DRUCK_PUNKTE[layout.paperSize]} Punkte) zu breit`;
+            return null;
+        }
+        if (mass.unterMindestmass) {
+            qrAusweich =
+                `QR mit ${mass.module} Modulen passt nur mit ${String(mass.punkte)} Punkten ` +
+                    `je Modul -- unter dem Mindestmass von ${index_js_1.QR_MINDEST_PUNKTE}`;
+        }
+        return mass.punkte;
+    };
     const out = [];
     out.push(`<epos-print xmlns="${NS}">`);
     out.push('<text lang="de"/>');
@@ -27,11 +79,15 @@ function eposPrintXml(layout, options = {}) {
             case 'space':
                 out.push('<feed line="1"/>');
                 break;
-            case 'qr':
+            case 'qr': {
+                const breite = qrBreiteFuer(z.qr ?? '');
+                if (breite === null)
+                    break;
                 out.push('<text align="center"/>');
-                out.push(`<symbol type="qrcode_model_2" level="level_m" width="${qrBreite}" 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(z.qr ?? '')}</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"/>');
@@ -51,7 +107,7 @@ function eposPrintXml(layout, options = {}) {
         out.push('<cut type="feed"/>');
     }
     out.push('</epos-print>');
-    return out.join('\n');
+    return { xml: out.join('\n'), qrFehler, qrAusweich };
 }
 const EPOS_DEVID_VORGABE = 'local_printer';
 function eposServiceUrl(ip, devid = EPOS_DEVID_VORGABE, timeoutMs = 10000) {
@@ -159,7 +215,12 @@ async function eposDirectSend(innerXml, o, fetchFn) {
 /** Beleg direkt drucken; wirft bei Netz-/Zertifikatsproblemen, sonst die Drucker-Antwort. */
 function eposDirectPrint(layout, o, fetchFn = fetch) {
     const papier = o.papier ?? layout.paperSize;
-    return eposDirectSend(eposPrintXml({ ...layout, paperSize: papier }, { zeichen: grid_js_1.ZEICHEN_JE_PAPIER[papier] }), o, fetchFn);
+    const xmlOptionen = { zeichen: grid_js_1.ZEICHEN_JE_PAPIER[papier] };
+    if (o.qrBreite !== undefined)
+        xmlOptionen.qrBreite = o.qrBreite;
+    if (o.qrGroesse !== undefined)
+        xmlOptionen.qrGroesse = o.qrGroesse;
+    return eposDirectSend(eposPrintXml({ ...layout, paperSize: papier }, xmlOptionen), o, fetchFn);
 }
 /** Verbindungstest: leeres Dokument, druckt nichts, liefert den Druckerstatus. */
 function eposDirectStatus(o, fetchFn = fetch) {

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

@@ -1,4 +1,4 @@
 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, escPosLayoutBytes } from './layout-escpos.js';
+export { type EscPosLayoutOptions, type EscPosLayoutErgebnis, type QrPrintMode, 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 EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposXmlEscape, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';
+export { type EposPrintXmlOptions, type EposPrintErgebnis, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlErgebnis, eposXmlEscape, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.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.eposPrintXml = exports.EposConnectionError = exports.ZEICHEN_JE_PAPIER = exports.gridAlsText = exports.gridSpaltenBreiten = exports.renderReceiptGrid = 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.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;
 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; } });
@@ -14,6 +14,7 @@ Object.defineProperty(exports, "SMALL_BUSINESS_NOTICE", { enumerable: true, get:
 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, "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");
 Object.defineProperty(exports, "renderReceiptGrid", { enumerable: true, get: function () { return grid_js_1.renderReceiptGrid; } });
 Object.defineProperty(exports, "gridSpaltenBreiten", { enumerable: true, get: function () { return grid_js_1.gridSpaltenBreiten; } });
@@ -22,6 +23,7 @@ Object.defineProperty(exports, "ZEICHEN_JE_PAPIER", { enumerable: true, get: fun
 var epos_js_1 = require("./epos.js");
 Object.defineProperty(exports, "EposConnectionError", { enumerable: true, get: function () { return epos_js_1.EposConnectionError; } });
 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, "eposServiceUrl", { enumerable: true, get: function () { return epos_js_1.eposServiceUrl; } });
 Object.defineProperty(exports, "eposSoapEnvelope", { enumerable: true, get: function () { return epos_js_1.eposSoapEnvelope; } });

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

@@ -1,4 +1,4 @@
-import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrSize } from '../printing/index.js';
+import { type PosCodeTable, type PosCutMode, type PosPaperSize, type QrCorrection, type QrMatrix, type QrModulGroesse, type QrSize } from '../printing/index.js';
 import type { ReceiptLayout } from './layout.js';
 /**
  * Bruecke vom Layout-Modell zu ESC/POS-Bytes — der Bondrucker-Ausgabeweg.
@@ -14,6 +14,20 @@ import type { ReceiptLayout } from './layout.js';
  * ein unerwartetes Zeichen darin soll darum auffallen und nicht still
  * verfaelscht werden.
  */
+/**
+ * Wie der Beleg-QR auf das Papier kommt — Zwilling von `QrPrintMode`
+ * (kasseneck_api/lib/enums/qr_print_mode.dart).
+ *
+ * - `native`      — der Druckbefehl `GS ( k`; der Drucker zeichnet selbst.
+ *                   Ohne Modellbefehl, also byteidentisch zum Bestand.
+ * - `nativeModel1` — derselbe Befehl mit ausdruecklicher Wahl von **Modell 1**
+ *                   (`GS ( k 04 00 31 41 31 00`). Fuer guenstige Geraete, die
+ *                   nur diesen aelteren Symboltyp beherrschen; belegt ist
+ *                   eines, das bei Modell 2 unter dem Code eine "0" ausgibt.
+ * - `imageRaster` — der QR als Rasterbild. Braucht ein Raster vom Aufrufer
+ *                   (`qrMatrix`), weil dieses Paket keine QR-Codes rechnet.
+ */
+export type QrPrintMode = 'native' | 'nativeModel1' | 'imageRaster';
 export interface EscPosLayoutOptions {
     /** Papierbreite; Vorgabe ist die des Layouts (dessen Spaltenbreiten daran haengen). */
     paperSize?: PosPaperSize;
@@ -21,10 +35,38 @@ export interface EscPosLayoutOptions {
     codeTable?: PosCodeTable | null;
     /** Papierschnitt am Ende: `true` (voll), `'partial'` oder `false`. Vorgabe `true`. */
     cut?: boolean | PosCutMode;
-    /** Modulgroesse des QR-Codes. */
+    /**
+     * Feste Modulgroesse des QR-Codes. Gesetzt schaltet sie die Rechnung ab —
+     * dann passt der Aufrufer selbst auf, dass das Symbol aufs Papier geht.
+     */
     qrSize?: QrSize;
     /** Fehlerkorrekturstufe des QR-Codes. */
     qrCorrection?: QrCorrection;
+    /** Deckel fuer die gerechnete Modulgroesse; Vorgabe `auto`. */
+    qrGroesse?: QrModulGroesse;
+    /** Druckweg des QR; Vorgabe `native` (der Bestandsweg). */
+    qrModus?: QrPrintMode;
+    /**
+     * Raster fuer den Bildweg — ohne das gibt es keinen Notausgang.
+     *
+     * Dieses Paket rechnet keine QR-Codes und verarbeitet keine Bilder (siehe
+     * Kopf von `layout.ts`); der Aufrufer bringt das fertige Raster mit, etwa
+     * aus der QR-Bibliothek, die er ohnehin fuer den Bildschirm benutzt.
+     */
+    qrMatrix?: (nutzlast: string) => QrMatrix;
+}
+/**
+ * Der Bytestrom **samt** dem, was dem QR unterwegs zugestossen ist.
+ *
+ * Zwilling von `KeckPrintResult`: `qrFehler` heisst "Beleg ohne QR,
+ * nachdrucken oder elektronisch ausgeben", `qrAusweich` heisst "gedruckt,
+ * aber der eingestellte Weg taugt fuer dieses Geraet nicht" — das eine gehoert
+ * dem Kunden gesagt, das andere dem Chef.
+ */
+export interface EscPosLayoutErgebnis {
+    bytes: Uint8Array;
+    qrFehler: string | null;
+    qrAusweich: string | null;
 }
 /**
  * Bytes fuer den Bondrucker -- **aus dem Zeichenraster** ([renderReceiptGrid]):
@@ -33,3 +75,9 @@ export interface EscPosLayoutOptions {
  * zeigt, druckt der Drucker (Monospace, Font A: 32/48 Zeichen).
  */
 export declare function escPosLayoutBytes(layout: ReceiptLayout, options?: EscPosLayoutOptions): Uint8Array;
+/**
+ * Wie [escPosLayoutBytes], gibt aber zusaetzlich zurueck, was dem QR
+ * zugestossen ist. Die Bytes sind dieselben; wer die Meldungen braucht, nimmt
+ * diesen Weg.
+ */
+export declare function escPosLayoutErgebnis(layout: ReceiptLayout, options?: EscPosLayoutOptions): EscPosLayoutErgebnis;

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.escPosLayoutBytes = escPosLayoutBytes;
+exports.escPosLayoutErgebnis = escPosLayoutErgebnis;
 const index_js_1 = require("../printing/index.js");
 const grid_js_1 = require("./grid.js");
 /**
@@ -29,6 +30,14 @@ function druckbaresLayout(layout) {
  * zeigt, druckt der Drucker (Monospace, Font A: 32/48 Zeichen).
  */
 function escPosLayoutBytes(layout, options = {}) {
+    return escPosLayoutErgebnis(layout, options).bytes;
+}
+/**
+ * Wie [escPosLayoutBytes], gibt aber zusaetzlich zurueck, was dem QR
+ * zugestossen ist. Die Bytes sind dieselben; wer die Meldungen braucht, nimmt
+ * diesen Weg.
+ */
+function escPosLayoutErgebnis(layout, options = {}) {
     const paperSize = options.paperSize ?? layout.paperSize;
     const dokumentOptionen = { paperSize };
     if (options.codeTable !== undefined) {
@@ -36,11 +45,59 @@ function escPosLayoutBytes(layout, options = {}) {
     }
     const doc = (0, index_js_1.createEscPosDocument)(dokumentOptionen);
     (0, index_js_1.escPosReset)(doc);
+    const modus = options.qrModus ?? 'native';
     const qrOptionen = { align: 'center' };
     if (options.qrSize !== undefined)
         qrOptionen.size = options.qrSize;
     if (options.qrCorrection !== undefined)
         qrOptionen.correction = options.qrCorrection;
+    if (options.qrGroesse !== undefined)
+        qrOptionen.groesse = options.qrGroesse;
+    if (modus === 'nativeModel1')
+        qrOptionen.modell1 = true;
+    if (modus === 'imageRaster' && options.qrMatrix === undefined) {
+        throw new Error("qrModus 'imageRaster' braucht ein qrMatrix -- dieses Paket rastert nicht selbst");
+    }
+    const rasterOptionen = { align: 'center' };
+    if (options.qrGroesse !== undefined)
+        rasterOptionen.groesse = options.qrGroesse;
+    /**
+     * Eine QR-Zeile des Rasters. Hier sitzt der **Notausgang**: passt das Symbol
+     * nativ auch mit der Ausnahmegroesse nicht aufs Papier, druckt der Drucker
+     * es GAR NICHT -- er schneidet nicht ab, er laesst weg. Ein Pflichtbeleg
+     * ohne QR ist der schlechteste aller Ausgaenge, also geht der QR dann als
+     * Bild hinaus, und der Aufrufer erfaehrt es ueber `qrAusweich`.
+     *
+     * Ohne `qrMatrix` gibt es diesen Weg nicht -- dann bleibt nur die Meldung
+     * `qrFehler` aus `escPosQrCode`, und der Beleg geht ohne QR hinaus.
+     */
+    const qrZeile = (nutzlast) => {
+        const raster = options.qrMatrix;
+        if (nutzlast !== '' && raster !== undefined) {
+            if (modus === 'imageRaster') {
+                (0, index_js_1.escPosQrRaster)(doc, raster(nutzlast), rasterOptionen);
+                return;
+            }
+            // Feste `qrSize` heisst: der Aufrufer weiss, was er tut -- dann wird
+            // weder gerechnet noch ausgewichen.
+            if (options.qrSize === undefined) {
+                const mass = (0, index_js_1.qrGroesseFuer)({
+                    nutzlast,
+                    papierbreitePunkte: index_js_1.QR_DRUCK_PUNKTE[paperSize],
+                    groesse: options.qrGroesse ?? 'auto',
+                });
+                if (!mass.passt) {
+                    doc.qrAusweich =
+                        `QR mit ${mass.module} Modulen passt nativ nicht auf ` +
+                            `${paperSize === 'mm58' ? 58 : 80} mm (${index_js_1.QR_DRUCK_PUNKTE[paperSize]} Punkte) ` +
+                            `-- als Bild gedruckt`;
+                    (0, index_js_1.escPosQrRaster)(doc, raster(nutzlast), rasterOptionen);
+                    return;
+                }
+            }
+        }
+        (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) {
@@ -48,7 +105,7 @@ function escPosLayoutBytes(layout, options = {}) {
                 (0, index_js_1.escPosFeed)(doc, 1);
                 break;
             case 'qr':
-                (0, index_js_1.escPosQrCode)(doc, zeile.qr ?? '', qrOptionen);
+                qrZeile(zeile.qr ?? '');
                 break;
             case 'banner': {
                 // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
@@ -68,5 +125,5 @@ function escPosLayoutBytes(layout, options = {}) {
     if (options.cut !== false) {
         (0, index_js_1.escPosCut)(doc, options.cut === 'partial' ? 'partial' : 'full');
     }
-    return (0, index_js_1.escPosBytes)(doc);
+    return { bytes: (0, index_js_1.escPosBytes)(doc), qrFehler: doc.qrFehler, qrAusweich: doc.qrAusweich };
 }

package/dist/esm/payments/hobex-hps/index.d.ts

@@ -20,8 +20,8 @@
 export { type HpsConnectCancelOptions, type HpsConnectClient, type HpsConnectClientOptions, type HpsConnectFetch, type HpsConnectFetchResponse, type HpsConnectPaymentOptions, type HpsConnectRefundOptions, type HpsConnectTarget, type HpsConnectTransactionOptions, createHpsConnectClient, } from './connect-client.js';
 export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, } from './errors.js';
 export { type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver, } from './events.js';
-export { type CardPaymentOutcome, type HpsPaymentResult, mayRetrySafely, } from './outcome.js';
+export { type CardPaymentOutcome, type HpsPaymentResult, isHostUncertainResult, mayRetrySafely, } from './outcome.js';
 export { type HpsCancelOptions, type HpsPaymentOptions, type HpsPayments, type HpsPaymentsOptions, type HpsRefundOptions, createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, type HpsTransactionIdGeneratorOptions, } from './transaction-id.js';
-export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/index.js

@@ -19,8 +19,8 @@
  */
 export { createHpsConnectClient, } from './connect-client.js';
 export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, } from './errors.js';
-export { mayRetrySafely, } from './outcome.js';
+export { isHostUncertainResult, mayRetrySafely, } from './outcome.js';
 export { createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, } from './transaction-id.js';
-export { ABORTED_CODE, APPROVED_CODE, CARD_NOT_PRESENT_CODE, HPS_MEASURED_CODES, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/outcome.d.ts

@@ -1,4 +1,4 @@
-import type { HpsTransactionResponse } from './transaction-response.js';
+import { type HpsCodeReason, type HpsTransactionResponse } from './transaction-response.js';
 /**
  * Ausgang eines Kartenzahlvorgangs — die einzige Frage, die ein Aufrufer
  * wirklich hat: darf ich es nochmal versuchen?
@@ -35,6 +35,18 @@ export interface HpsPaymentResult {
      * Entscheidung getragen. Bei schluessigem Ausgang nicht gesetzt.
      */
     readonly lastResponse?: HpsTransactionResponse;
+    /**
+     * Worauf die Kasse reagiert -- der Grund hinter dem Ausgang, mit dem Satz
+     * fuer den Bediener in `HPS_REASON_HINTS`.
+     *
+     * Gesetzt an der Stelle, die den Ausgang entschieden hat, nicht aus
+     * [response] abgeleitet: ein bestaetigter Abbruch antwortet `'0'` und ist
+     * trotzdem `'aborted'`, und wenn die Zwei-9027-Regel eine Zahlung als
+     * abgelehnt klaert, zaehlt der Code der ZAHLUNG, nicht das `9027` danach.
+     * Fehlt, wenn kein Code etwas erklaert (die Leitung riss ab, bevor das
+     * Terminal etwas sagte) und bei einer Aufhebung, die nicht gegriffen hat.
+     */
+    readonly reason?: HpsCodeReason;
     /**
      * Verlauf der Klaerung, in Reihenfolge — der Nachweis, der im
      * Belastungsstreit gelesen wird. Behauptet nie eine Ursache, die nicht
@@ -44,3 +56,10 @@ export interface HpsPaymentResult {
 }
 /** Nur bei `'declined'` steht fest, dass nichts belastet wurde. */
 export declare function mayRetrySafely(result: Pick<HpsPaymentResult, 'outcome'>): boolean;
+/**
+ * `true`, wenn der Ausgang offen ist, weil das Terminal eine Stoerung beim
+ * oder nach dem hobex-Host meldete (`effect: 'hostUncertain'`). Wichtig fuer
+ * jede SPAETERE Nachfrage: antwortet die Statusabfrage dann `9027`, heisst das
+ * hier NICHT "nichts belastet".
+ */
+export declare function isHostUncertainResult(result: Pick<HpsPaymentResult, 'outcome' | 'reason'>): boolean;

package/dist/esm/payments/hobex-hps/outcome.js

@@ -1,4 +1,14 @@
+import { isHostUncertainReason } from './transaction-response.js';
 /** Nur bei `'declined'` steht fest, dass nichts belastet wurde. */
 export function mayRetrySafely(result) {
     return result.outcome === 'declined';
 }
+/**
+ * `true`, wenn der Ausgang offen ist, weil das Terminal eine Stoerung beim
+ * oder nach dem hobex-Host meldete (`effect: 'hostUncertain'`). Wichtig fuer
+ * jede SPAETERE Nachfrage: antwortet die Statusabfrage dann `9027`, heisst das
+ * hier NICHT "nichts belastet".
+ */
+export function isHostUncertainResult(result) {
+    return result.outcome === 'unresolved' && isHostUncertainReason(result.reason);
+}

package/dist/esm/payments/hobex-hps/payments.d.ts

@@ -89,6 +89,25 @@ import type { HpsPaymentResult } from './outcome.js';
  * Kein [tryAbort]-Versuch bei [cancel]: die Originalzahlung ist laengst
  * abgeschlossen und antwortet gemessen mit `100010` -- ein Abbruch darauf
  * waere sinnlos.
+ *
+ * ## Stoerung beim Host: die Klaerung darf nichts schliessen (11.09.2026)
+ *
+ * Die Antwortcodeliste von hobex benennt Codes, bei denen der Host beteiligt
+ * war und das Terminal NICHT selbst storniert (`effect: 'hostUncertain'`,
+ * etwa `100007`). Fuer sie gilt zweierlei:
+ *
+ * 1. Die Zwei-9027-Regel ([ausGeschlossenerAntwort]) greift nicht. Sie
+ *    schliesst aus "das Terminal hat geantwortet und nichts gespeichert" auf
+ *    "nichts belastet" -- das stimmt fuer einen Vorgang, der am Terminal
+ *    endete, aber nicht fuer einen, dessen Ausgang beim Host liegt. Dasselbe
+ *    gilt sinngemaess fuer [cancel]: ein unveraendertes `'0'` auf die
+ *    Originalzahlung beweist dann nicht, dass die Aufhebung beim Host nicht
+ *    ankam.
+ * 2. Die Klaerung wartet trotzdem nicht das ganze Budget ab. Sagt die
+ *    Statusabfrage zweimal in Folge nichts Neues (`9027` oder erneut ein
+ *    solcher Code), endet sie sofort als `unresolved` -- das Terminal wird es
+ *    auch in 90 Sekunden nicht wissen. Meldet sie dagegen `'0'`, ist die
+ *    Zahlung genehmigt, ganz normal.
  */
 export interface HpsPaymentsOptions {
     /** Wie lange insgesamt geklaert wird, bevor der Ausgang offen bleibt. Vorgabe 90 s. */