@kreiseck/kasseneck-api 0.9.4 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,124 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.11.0
+
+### Die QR-Modulgröße wird gerechnet, nicht gesetzt — samt Notausgang und Modell 1
+
+**Anlass:** Am echten Beleg fehlte der QR-Code, die Probe im Drucker-Wizard
+druckte ihn. Der native QR-Befehl bekommt eine Modulgröße in Druckpunkten mit
+und rechnet nicht nach, ob das Symbol samt Ruhezone auf die Rolle geht. Ein
+Beleg-QR mit realer RKSV-Nutzlast hat 57 Module, mit Ruhezone also 65; bei
+sechs Punkten je Modul sind das 390 Druckpunkte, und ein 58-mm-Kopf hat 384.
+Zu breit heißt bei den meisten Geräten nicht „abgeschnitten", sondern **gar
+kein QR**. Der Befund stammt aus dem Flutter-Zwilling `kasseneck_api` (dort
+6.9.0), der fest mit sechs Punkten druckte; dieses Paket druckt seit jeher mit
+vier und war davon nicht betroffen. Die Regel ist trotzdem dieselbe — sie
+deckelt auch eine bewusst gewählte größere Modulgröße gegen den Papierrand ab.
+
+- **Neu `…/printing`: die Rechenregel, rein und ohne Drucker.**
+  `qrModulAnzahl(nutzlast)` gibt die Modulanzahl bei Fehlerkorrektur **M**
+  (konservativ: der native Befehl druckt mit L, das braucht nie mehr Module);
+  `qrGroesseBerechnen({ papierbreitePunkte, moduleAnzahl, groesse })` und
+  `qrGroesseFuer({ nutzlast, papierbreitePunkte, groesse })` geben ein
+  `QrGroesse` mit `punkte` (`null` = passt nicht), `module`, `breitePunkte`,
+  `unterMindestmass` und `passt`. Dazu `QrModulGroesse`, `QR_MODUL_DECKEL`,
+  `QR_RUHEZONE_MODULE` (4), `QR_MINDEST_PUNKTE` (4), `QR_AUSNAHME_PUNKTE` (3),
+  `QR_HOECHST_PUNKTE` (8) und `QR_DRUCK_PUNKTE` (58 mm = 384, 80 mm = 576 —
+  die echte Kopfbreite, nicht die Spaltenbreite 372/558).
+- **`escPosQrCode` rechnet, wenn keine feste `size` mitkommt.** `groesse` ist
+  ein **Deckel**, keine Vorgabe: gedruckt wird die größte Größe, die noch
+  passt, höchstens aber der Deckel. `auto` deckelt beim Bestandswert dieses
+  Pakets (4), `klein` 4, `mittel` 6, `gross` 8. **Ohne ausdrückliche Wahl
+  ändert sich kein Byte** — nur dort, wo heute gar nichts herauskommt, rechnet
+  die Regel herunter. (Im Flutter-Zwilling deckelt `auto` bei 6, weil dort 6
+  der Bestandswert ist; die Regel ist dieselbe, der Bestand nicht.)
+- **`EscPosDocument.qrFehler` / `.qrAusweich`.** `qrFehler` heißt „Beleg ohne
+  QR" — das Symbol passt auch mit der Ausnahmegröße nicht, und ein Befehl, von
+  dem man weiß, dass er nichts druckt, täuscht nur einen Ausdruck vor.
+  `qrAusweich` heißt „gedruckt, aber nicht auf dem eingestellten Weg" — unter
+  der Mindestgröße oder als Bild. Das eine gehört dem Kunden gesagt, das
+  andere dem Chef. `escPosReset` räumt beide weg.
+- **Neu `…/receipt`: `escPosLayoutErgebnis`** gibt `{ bytes, qrFehler,
+  qrAusweich }`; `escPosLayoutBytes` bleibt unverändert und gibt weiter nur
+  die Bytes. Neue Optionen `qrGroesse`, `qrModus` (`QrPrintMode`) und
+  `qrMatrix`.
+- **Der Notausgang.** Passt das Symbol nativ nicht aufs Papier und ist ein
+  `qrMatrix` mitgegeben, geht der QR als Rasterbild hinaus (`GS v 0`) statt
+  gar nicht — ein Pflichtbeleg ohne QR ist der schlechteste aller Ausgänge.
+  Das Raster kommt vom Aufrufer: dieses Paket rechnet keine QR-Codes und
+  verarbeitet keine Bilder. Dafür neu `escPosQrRaster`, `qrRasterPunkte` und
+  der Typ `QrMatrix`.
+- **Modell 1.** `qrCodeBytes(..., { modell1: true })` bzw. `qrModus:
+  'nativeModel1'` stellt den Wahlbefehl `GS ( k 04 00 31 41 31 00` voran. Für
+  günstige Drucker, die nur diesen älteren Symboltyp beherrschen; belegt ist
+  eines, das bei Modell 2 unter dem Code eine „0" ausgibt — das Parameterbyte
+  `0x30` des Druckbefehls, das es nicht als Befehl erkennt. Ohne ausdrückliche
+  Wahl geht **gar kein** Modellbefehl hinaus, wie bisher.
+- **Derselbe Fehler im ePOS-Weg — und dort ist er der akute.** `eposPrintXml`
+  setzte `<symbol … width="6">` fest, unabhängig von der Papierbreite: 57
+  Module plus Ruhezone sind bei sechs Punkten 390 Druckpunkte, ein 58-mm-Kopf
+  hat 384, und der Epson lässt ein zu breites Symbol weg. **Genau daran fehlte
+  am echten Beleg der QR.** Jetzt gilt dieselbe Regel — Untergrenze 4,
+  Ausnahme 3 mit Meldung, darunter kein `<symbol>`. Der Bestandswert dieses
+  Wegs ist 6, deshalb ist die Vorgabe hier der Deckel `mittel`; ohne
+  ausdrückliche Wahl ändert sich nur dort etwas, wo heute gar nichts
+  herauskommt. Neu `eposPrintXmlErgebnis` (`{ xml, qrFehler, qrAusweich }`) und
+  die Optionen `qrGroesse` an `eposPrintXml` und `eposDirectPrint`; `qrBreite`
+  bleibt, ist jetzt aber ausdrücklich die **feste** Größe und schaltet die
+  Rechnung ab.
+- **Bestandsschutz als Golden-Test.** Zwei feste SHA-256 über den gesamten
+  Bytestrom eines Belegs (58 und 80 mm) und zwei weitere über das vollständige
+  ePOS-XML halten fest, dass sich ohne Wahl kein Byte ändert. Dazu prüft `test/paket-inhalt.test.ts`, dass die Dateiliste des
+  Pakets eine Positivliste bleibt und im mitgelieferten `fixtures/` nichts
+  Örtliches liegt.
+
+## 0.10.0
+
+### Die Antwortcodeliste von hobex — jeder Code eingeordnet, jeder Ausgang mit Grund
+
+**Anlass:** hobex hat am 11.09.2026 die Antwortcodeliste der HPS-Anwendung
+geschickt. Drei der Codes kamen seit dem 28.08.2026 im Betrieb vor (`100004`,
+`100005`, `100015`) und waren bis jetzt ungedeutet. Jede Zahlung damit lief in
+die Klaerung und endete erst ueber die Zwei-9027-Regel. Zwilling:
+`kasseneck_api` 6.10.0 (6.9.0 war inzwischen vergeben), Begruendungen dort in
+`doc/kartenzahlung.md`.
+
+- **`HPS_CODES`** fuehrt alle 31 Codes der Liste zusammen mit den gemessenen:
+  Code, hobex-Titel, Bedeutung, Wirkung (`effect`), Grund (`reason`) und
+  Quelle (`source`). `isConclusive` liest seine Positivliste daraus.
+  `HPS_MEASURED_CODES` bleibt als abgekuendigter Name fuer dieselbe Tabelle.
+- **Was vor dem Host scheitert, ist eine Ablehnung** (Kartenlesen, EMV-Kernel,
+  Eingaben am Geraet, Geraetezustand, fehlerhafte Anfrage) -- `declined`, ohne
+  Abbruch und ohne Statusabfrage. Dazu `100029`: das Terminal storniert laut
+  hobex selbst.
+- **Neu: `effect: 'hostUncertain'`** (`isHostUncertain`) fuer `100006`,
+  `100007`, `100023`, `100024`, `100026`, `100027`, `100999`. Der Host war
+  beteiligt, das Terminal storniert nicht selbst. Die Zwei-9027-Regel greift
+  hier **nicht**; die Klaerung endet nach zwei Abfragen ohne Neues als
+  `unresolved`, nur ein `'0'` entscheidet danach noch, und ein Abbruchversuch
+  entfaellt. Bei einer Aufhebung entscheidet ein unveraendertes `'0'` auf die
+  Originalzahlung dann ebenfalls nichts.
+- **`rejectsRequest` / `isConclusiveAsStatus`:** zehn Codes weisen die Anfrage
+  selbst ab (`9002`, `100001`, `100008`, `100108`, `100009`, `100010`,
+  `100013`, `100018`, `100022`, `100998`). Auf eine Zahlung sind sie deren
+  Ablehnung, auf eine Statusabfrage sagen sie nichts ueber den gesuchten
+  Vorgang (gemessen fuer `100108`). Die Klaerung liest den Status deshalb
+  ueber `isConclusiveAsStatus` -- sonst haette ein gesperrtes Terminal eine
+  verlorene Zahlung als "nicht belastet" ausgewiesen.
+- **`HpsPaymentResult.reason`** traegt fuer jeden Ausgang den Grund, den Satz
+  fuer den Bediener gibt `HPS_REASON_HINTS`. Gesetzt, wo entschieden wurde:
+  bestaetigter Abbruch `aborted`, HTTP 409 `terminalBusy`, eine ueber die
+  Zwei-9027-Regel geklaerte Zahlung mit dem Grund ihres eigenen Codes.
+  `isHostUncertainResult` sagt einer spaeteren Nachfrage, dass ein `9027` dort
+  nicht "nicht belastet" heisst.
+- `hpsCodeInfo`, `hpsCodeReason` und die Namen aller neuen Codes
+  (`CARD_READ_FAILED_CODE` usw.) sind exportiert.
+- Der Nachweis nennt bei einer Ablehnung den hobex-Titel mit
+  (`Terminal: abgelehnt (100015 "Card declined")`).
+- `fixtures/hobex-hps-codes.json` fuehrt je Code zusaetzlich `title`,
+  `effect`, `reason`, `source` und die Saetze je Grund (`gruende`).
+
 ## 0.9.4
 
 ### `qrModus` faengt bei `auto` an — sonst stellte die Vorgabe den Altbestand um

package/README.md

@@ -344,6 +344,47 @@ app.post('/kasseneck-webhook', express.raw({ type: '*/*' }), async (req, res) =>
 
 So zieht sich niemand den React-Adapter in ein Node-Programm.
 
+## Der QR-Code passt aufs Papier
+
+Der native QR-Befehl bekommt eine Modulgröße in Druckpunkten mit und rechnet
+selbst nicht nach, ob das Symbol samt Ruhezone auf die Rolle geht. Zu breit
+heißt bei den meisten Bondruckern nicht „abgeschnitten", sondern **gar kein
+QR** — auf einem Pflichtbeleg der schlechteste aller Ausgänge. Deshalb rechnet
+dieses Paket die Größe, statt sie zu setzen:
+
+```ts
+import { qrGroesseFuer, QR_DRUCK_PUNKTE } from '@kreiseck/kasseneck-api/printing';
+
+const mass = qrGroesseFuer({ nutzlast: beleg.qr, papierbreitePunkte: QR_DRUCK_PUNKTE.mm58 });
+// mass.punkte: Punkte je Modul, null = passt auch mit der Ausnahmegröße nicht
+// mass.unterMindestmass: gedruckt, aber unter 4 Punkten je Modul
+```
+
+Am Belegweg passiert das von selbst. `qrGroesse` ist ein **Deckel**, keine
+Vorgabe: gedruckt wird die größte Größe, die noch passt, höchstens aber der
+Deckel. `auto` (Vorgabe) deckelt beim Bestandswert 4 — ohne ausdrückliche Wahl
+ändert sich also kein Byte.
+
+```ts
+import { escPosLayoutErgebnis } from '@kreiseck/kasseneck-api/receipt';
+
+const { bytes, qrFehler, qrAusweich } = escPosLayoutErgebnis(layout, {
+  qrGroesse: 'gross',        // 'auto' | 'klein' | 'mittel' | 'gross'
+  qrModus: 'nativeModel1',   // ältere Drucker, die nur Modell 1 können
+  qrMatrix: rasterFuer,      // Notausgang: der QR als Bild statt gar nicht
+});
+```
+
+Der Epson-Weg (`eposPrintXml` / `eposDirectPrint`) rechnet genauso;
+`eposPrintXmlErgebnis` gibt dort `{ xml, qrFehler, qrAusweich }`. Sein
+Bestandswert ist 6, deshalb ist die Vorgabe dort der Deckel `mittel`.
+
+`qrFehler` heißt „Beleg ohne QR" — das gehört dem Kunden gesagt. `qrAusweich`
+heißt „gedruckt, aber der eingestellte Weg taugt für dieses Gerät nicht" — das
+gehört dem Chef gesagt. Den Bildweg fährt das Paket nur mit einem `qrMatrix`,
+das die Nutzlast in ein fertiges Raster übersetzt: hier wird bewusst weder ein
+QR gerechnet noch ein Bild verarbeitet.
+
 ## Hobex HPS über Kasseneck Connect
 
 Ein Browser hat weiterhin keine rohen TCP-Sockets — ein **direkter**

package/dist/cjs/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/cjs/payments/hobex-hps/index.js

@@ -19,7 +19,8 @@
  * des Aufrufers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hobexReceiptFromHps = exports.parseHpsTransactionResponse = exports.isUnknownCode = exports.isTechnicalError = exports.isNotAbortable = exports.isNoStatement = exports.isInProgress = exports.isConclusive = exports.isCanceled = exports.isApproved = exports.TRANSACTION_CANCELED_CODE = exports.TERMINAL_BUSY_HTTP_STATUS = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.INVALID_TRANSACTION_CODE = exports.HPS_MEASURED_CODES = exports.CARD_NOT_PRESENT_CODE = exports.APPROVED_CODE = exports.ABORTED_CODE = exports.newHpsTransactionId = exports.isValidHpsTransactionId = exports.createHpsTransactionIdGenerator = exports.MAX_TRANSACTION_ID_LENGTH = exports.createHpsPayments = exports.mayRetrySafely = exports.PREFLIGHT_CONNECT_CODES = exports.HpsTransactionIdError = exports.HpsPreflightError = exports.HpsConnectTransportError = exports.HpsConnectTerminalError = exports.HpsConnectException = exports.HpsClarifyTimeoutError = exports.createHpsConnectClient = void 0;
+exports.isHostUncertain = exports.hpsCodeReason = exports.hpsCodeInfo = exports.UNSUPPORTED_USER_DATA_CODE = exports.TIP_SELECTION_FAILED_CODE = exports.TERMINAL_BUSY_CODE = exports.TERMINAL_BLOCKED_CODE = exports.SCEP_ENROLLMENT_FAILED_CODE = exports.REFUND_PASSWORD_INVALID_CODE = exports.REFUND_DISABLED_CODE = exports.PASSWORD_NOT_ENTERED_CODE = exports.NOT_FOUND_CODE = exports.MAX_RETRIES_EXCEEDED_CODE = exports.INVALID_TX_TYPE_CODE = exports.INVALID_TID_DOCUMENTED_CODE = exports.INVALID_MESSAGE_TYPE_CODE = exports.INTERNAL_ERROR_CODE = exports.HPS_REASON_HINTS = exports.HPS_MEASURED_CODES = exports.HPS_CODES = exports.HOST_TIMEOUT_REVERSED_CODE = exports.HOST_STEP_FAILED_CODE = exports.HOST_COMMUNICATION_FAILED_CODE = exports.DIAGNOSIS_FAILED_CODE = exports.COMPLETION_FAILED_CODE = exports.CHIP_DATA_MISMATCH_CODE = exports.CARD_READ_FAILED_CODE = exports.CARD_NOT_SUPPORTED_CODE = exports.CARD_NOT_PRESENT_CODE = exports.CARD_INFO_NOT_ENTERED_CODE = exports.CARD_DECLINED_CODE = exports.BAD_REQUEST_CODE = exports.APPROVED_CODE = exports.APP_SELECT_FAILED_CODE = exports.ABORTED_CODE = exports.newHpsTransactionId = exports.isValidHpsTransactionId = exports.createHpsTransactionIdGenerator = exports.MAX_TRANSACTION_ID_LENGTH = exports.createHpsPayments = exports.mayRetrySafely = exports.isHostUncertainResult = exports.PREFLIGHT_CONNECT_CODES = exports.HpsTransactionIdError = exports.HpsPreflightError = exports.HpsConnectTransportError = exports.HpsConnectTerminalError = exports.HpsConnectException = exports.HpsClarifyTimeoutError = exports.createHpsConnectClient = void 0;
+exports.hobexReceiptFromHps = exports.parseHpsTransactionResponse = exports.isUnknownCode = exports.isTechnicalError = exports.isNotAbortable = exports.isNoStatement = exports.isInProgress = exports.isConclusiveAsStatus = exports.isConclusive = exports.isCanceled = exports.isApproved = exports.TRANSACTION_CANCELED_CODE = exports.TERMINAL_BUSY_HTTP_STATUS = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.INVALID_TRANSACTION_CODE = exports.isHostUncertainReason = void 0;
 var connect_client_js_1 = require("./connect-client.js");
 Object.defineProperty(exports, "createHpsConnectClient", { enumerable: true, get: function () { return connect_client_js_1.createHpsConnectClient; } });
 var errors_js_1 = require("./errors.js");
@@ -31,6 +32,7 @@ Object.defineProperty(exports, "HpsPreflightError", { enumerable: true, get: fun
 Object.defineProperty(exports, "HpsTransactionIdError", { enumerable: true, get: function () { return errors_js_1.HpsTransactionIdError; } });
 Object.defineProperty(exports, "PREFLIGHT_CONNECT_CODES", { enumerable: true, get: function () { return errors_js_1.PREFLIGHT_CONNECT_CODES; } });
 var outcome_js_1 = require("./outcome.js");
+Object.defineProperty(exports, "isHostUncertainResult", { enumerable: true, get: function () { return outcome_js_1.isHostUncertainResult; } });
 Object.defineProperty(exports, "mayRetrySafely", { enumerable: true, get: function () { return outcome_js_1.mayRetrySafely; } });
 var payments_js_1 = require("./payments.js");
 Object.defineProperty(exports, "createHpsPayments", { enumerable: true, get: function () { return payments_js_1.createHpsPayments; } });
@@ -41,9 +43,41 @@ Object.defineProperty(exports, "isValidHpsTransactionId", { enumerable: true, ge
 Object.defineProperty(exports, "newHpsTransactionId", { enumerable: true, get: function () { return transaction_id_js_1.newHpsTransactionId; } });
 var transaction_response_js_1 = require("./transaction-response.js");
 Object.defineProperty(exports, "ABORTED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.ABORTED_CODE; } });
+Object.defineProperty(exports, "APP_SELECT_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.APP_SELECT_FAILED_CODE; } });
 Object.defineProperty(exports, "APPROVED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.APPROVED_CODE; } });
+Object.defineProperty(exports, "BAD_REQUEST_CODE", { enumerable: true, get: function () { return transaction_response_js_1.BAD_REQUEST_CODE; } });
+Object.defineProperty(exports, "CARD_DECLINED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CARD_DECLINED_CODE; } });
+Object.defineProperty(exports, "CARD_INFO_NOT_ENTERED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CARD_INFO_NOT_ENTERED_CODE; } });
 Object.defineProperty(exports, "CARD_NOT_PRESENT_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CARD_NOT_PRESENT_CODE; } });
+Object.defineProperty(exports, "CARD_NOT_SUPPORTED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CARD_NOT_SUPPORTED_CODE; } });
+Object.defineProperty(exports, "CARD_READ_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CARD_READ_FAILED_CODE; } });
+Object.defineProperty(exports, "CHIP_DATA_MISMATCH_CODE", { enumerable: true, get: function () { return transaction_response_js_1.CHIP_DATA_MISMATCH_CODE; } });
+Object.defineProperty(exports, "COMPLETION_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.COMPLETION_FAILED_CODE; } });
+Object.defineProperty(exports, "DIAGNOSIS_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.DIAGNOSIS_FAILED_CODE; } });
+Object.defineProperty(exports, "HOST_COMMUNICATION_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.HOST_COMMUNICATION_FAILED_CODE; } });
+Object.defineProperty(exports, "HOST_STEP_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.HOST_STEP_FAILED_CODE; } });
+Object.defineProperty(exports, "HOST_TIMEOUT_REVERSED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.HOST_TIMEOUT_REVERSED_CODE; } });
+Object.defineProperty(exports, "HPS_CODES", { enumerable: true, get: function () { return transaction_response_js_1.HPS_CODES; } });
 Object.defineProperty(exports, "HPS_MEASURED_CODES", { enumerable: true, get: function () { return transaction_response_js_1.HPS_MEASURED_CODES; } });
+Object.defineProperty(exports, "HPS_REASON_HINTS", { enumerable: true, get: function () { return transaction_response_js_1.HPS_REASON_HINTS; } });
+Object.defineProperty(exports, "INTERNAL_ERROR_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INTERNAL_ERROR_CODE; } });
+Object.defineProperty(exports, "INVALID_MESSAGE_TYPE_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INVALID_MESSAGE_TYPE_CODE; } });
+Object.defineProperty(exports, "INVALID_TID_DOCUMENTED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INVALID_TID_DOCUMENTED_CODE; } });
+Object.defineProperty(exports, "INVALID_TX_TYPE_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INVALID_TX_TYPE_CODE; } });
+Object.defineProperty(exports, "MAX_RETRIES_EXCEEDED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.MAX_RETRIES_EXCEEDED_CODE; } });
+Object.defineProperty(exports, "NOT_FOUND_CODE", { enumerable: true, get: function () { return transaction_response_js_1.NOT_FOUND_CODE; } });
+Object.defineProperty(exports, "PASSWORD_NOT_ENTERED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.PASSWORD_NOT_ENTERED_CODE; } });
+Object.defineProperty(exports, "REFUND_DISABLED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.REFUND_DISABLED_CODE; } });
+Object.defineProperty(exports, "REFUND_PASSWORD_INVALID_CODE", { enumerable: true, get: function () { return transaction_response_js_1.REFUND_PASSWORD_INVALID_CODE; } });
+Object.defineProperty(exports, "SCEP_ENROLLMENT_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.SCEP_ENROLLMENT_FAILED_CODE; } });
+Object.defineProperty(exports, "TERMINAL_BLOCKED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.TERMINAL_BLOCKED_CODE; } });
+Object.defineProperty(exports, "TERMINAL_BUSY_CODE", { enumerable: true, get: function () { return transaction_response_js_1.TERMINAL_BUSY_CODE; } });
+Object.defineProperty(exports, "TIP_SELECTION_FAILED_CODE", { enumerable: true, get: function () { return transaction_response_js_1.TIP_SELECTION_FAILED_CODE; } });
+Object.defineProperty(exports, "UNSUPPORTED_USER_DATA_CODE", { enumerable: true, get: function () { return transaction_response_js_1.UNSUPPORTED_USER_DATA_CODE; } });
+Object.defineProperty(exports, "hpsCodeInfo", { enumerable: true, get: function () { return transaction_response_js_1.hpsCodeInfo; } });
+Object.defineProperty(exports, "hpsCodeReason", { enumerable: true, get: function () { return transaction_response_js_1.hpsCodeReason; } });
+Object.defineProperty(exports, "isHostUncertain", { enumerable: true, get: function () { return transaction_response_js_1.isHostUncertain; } });
+Object.defineProperty(exports, "isHostUncertainReason", { enumerable: true, get: function () { return transaction_response_js_1.isHostUncertainReason; } });
 Object.defineProperty(exports, "INVALID_TRANSACTION_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INVALID_TRANSACTION_CODE; } });
 Object.defineProperty(exports, "NOT_ABORTABLE_CODE", { enumerable: true, get: function () { return transaction_response_js_1.NOT_ABORTABLE_CODE; } });
 Object.defineProperty(exports, "INVALID_AMOUNT_CODE", { enumerable: true, get: function () { return transaction_response_js_1.INVALID_AMOUNT_CODE; } });
@@ -57,6 +91,7 @@ Object.defineProperty(exports, "TRANSACTION_CANCELED_CODE", { enumerable: true,
 Object.defineProperty(exports, "isApproved", { enumerable: true, get: function () { return transaction_response_js_1.isApproved; } });
 Object.defineProperty(exports, "isCanceled", { enumerable: true, get: function () { return transaction_response_js_1.isCanceled; } });
 Object.defineProperty(exports, "isConclusive", { enumerable: true, get: function () { return transaction_response_js_1.isConclusive; } });
+Object.defineProperty(exports, "isConclusiveAsStatus", { enumerable: true, get: function () { return transaction_response_js_1.isConclusiveAsStatus; } });
 Object.defineProperty(exports, "isInProgress", { enumerable: true, get: function () { return transaction_response_js_1.isInProgress; } });
 Object.defineProperty(exports, "isNoStatement", { enumerable: true, get: function () { return transaction_response_js_1.isNoStatement; } });
 Object.defineProperty(exports, "isNotAbortable", { enumerable: true, get: function () { return transaction_response_js_1.isNotAbortable; } });

package/dist/cjs/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/cjs/payments/hobex-hps/outcome.js

@@ -1,7 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mayRetrySafely = mayRetrySafely;
+exports.isHostUncertainResult = isHostUncertainResult;
+const transaction_response_js_1 = require("./transaction-response.js");
 /** Nur bei `'declined'` steht fest, dass nichts belastet wurde. */
 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".
+ */
+function isHostUncertainResult(result) {
+    return result.outcome === 'unresolved' && (0, transaction_response_js_1.isHostUncertainReason)(result.reason);
+}

package/dist/cjs/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. */