@kreiseck/kasseneck-api 0.9.3 → 0.10.0

package/CHANGELOG.md

@@ -4,6 +4,68 @@ 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.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.9.0, 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
+
+**Anlass:** 0.9.3 gab `qrModus` die harte Vorgabe `raster`. Die Browser-Kasse
+druckt den Signatur-QR aber seit jeher ueber den nativen ESC/POS-Befehl; jedes
+Geraet, das nie durch den Drucker-Wizard laeuft, haette damit ploetzlich ein
+Rasterbild gedruckt — ueber BLE mehrere Sekunden je Bon, und niemand haette
+etwas umgestellt.
+
+- **`QR_MODUS` fuehrt jetzt `auto` als ersten Wert**, und
+  `KASSE_GERAET_STANDARD.qrModus` steht darauf. `auto` heisst *unbestimmt*: an
+  diesem Geraet hat noch niemand am Papier entschieden, jede Kasse bleibt bei
+  ihrer bisherigen Praxis (Browser-Kasse ESC/POS, App Rasterbild). Nur ein
+  ausdruecklich gesetzter Wert aendert etwas.
+- Wer `KasseQrModus` erschoepfend auswertet, bekommt einen dritten Fall.
+
 ## 0.9.3
 
 ### `qrModus` am Geraet: mit welchem Befehl der Signatur-QR auf den Bon kommt

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

@@ -58,12 +58,20 @@ export type KasseLadeAuto = typeof LADE_AUTO[number];
  * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
  * Zeichensalat.
  *
+ * `auto` ist die Vorgabe und heisst **unbestimmt**: an diesem Geraet hat noch
+ * niemand am Papier entschieden. Jede Kasse bleibt dann bei ihrer bisherigen
+ * Praxis — die Browser-Kasse beim ESC/POS-Befehl, die App beim Rasterbild.
+ * Eine harte Vorgabe waere hier eine stille Umstellung des Altbestands
+ * gewesen: jedes Geraet, das nie durch den Drucker-Wizard lief, druckte
+ * ploetzlich anders, und ueber BLE kostet ein Rasterbild mehrere Sekunden je
+ * Bon. Nur ein ausdruecklich gesetzter Wert aendert etwas.
+ *
  * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
  * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
  * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
  * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
  */
-export declare const QR_MODUS: readonly ["raster", "escpos"];
+export declare const QR_MODUS: readonly ["auto", "raster", "escpos"];
 export type KasseQrModus = typeof QR_MODUS[number];
 /** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
 export declare const LOGO_GROESSE: readonly ["S", "M", "L"];
@@ -191,7 +199,7 @@ export interface KasseSettingsGeraet {
     papier: KassePapier;
     zeichensatz: KasseZeichensatz;
     schnitt: KasseSchnitt;
-    /** Befehl fuer den Signatur-QR auf dem Bon; der Drucker-Wizard probiert beide aus. */
+    /** Befehl fuer den Signatur-QR auf dem Bon; 'auto' = unbestimmt, der Drucker-Wizard probiert beide aus. */
     qrModus: KasseQrModus;
     ladeAn: boolean;
     ladeAuto: KasseLadeAuto;

package/dist/cjs/kasse/settings.js

@@ -50,12 +50,20 @@ exports.LADE_AUTO = ['bar', 'immer', 'nie'];
  * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
  * Zeichensalat.
  *
+ * `auto` ist die Vorgabe und heisst **unbestimmt**: an diesem Geraet hat noch
+ * niemand am Papier entschieden. Jede Kasse bleibt dann bei ihrer bisherigen
+ * Praxis — die Browser-Kasse beim ESC/POS-Befehl, die App beim Rasterbild.
+ * Eine harte Vorgabe waere hier eine stille Umstellung des Altbestands
+ * gewesen: jedes Geraet, das nie durch den Drucker-Wizard lief, druckte
+ * ploetzlich anders, und ueber BLE kostet ein Rasterbild mehrere Sekunden je
+ * Bon. Nur ein ausdruecklich gesetzter Wert aendert etwas.
+ *
  * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
  * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
  * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
  * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
  */
-exports.QR_MODUS = ['raster', 'escpos'];
+exports.QR_MODUS = ['auto', 'raster', 'escpos'];
 /*
  * Auch die uebrigen Wertemengen der Einstellungen stehen jetzt als Liste da —
  * vorher waren sie nur als Union am Feld ausgeschrieben. Ein Zwilling konnte
@@ -129,7 +137,7 @@ exports.KASSE_GERAET_STANDARD = Object.freeze({
     tasten: { ...exports.KASSE_TASTEN_STANDARD },
     druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerName: '', druckerId: '', druckerDevid: 'local_printer',
     connectDruckerId: '',
-    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial', qrModus: 'raster',
+    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial', qrModus: 'auto',
     ladeAn: false, ladeAuto: 'bar',
     terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
     terminalArt: 'keins', terminalTid: '', tastenMarken: true,

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